AI-Cognitive-Leap/agnes-the-ai-analyst
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
agnes-the-ai-analyst/docs/superpowers/plans/2026-03-27-02-complete-system.md
ZdenekSrotyr 1b219cabe9 fix: remove dead PRAGMA enable_wal code 
DuckDB has used WAL by default since v0.8, so this pragma is not
valid DuckDB syntax. Removed obsolete try-except block that attempted
to enable WAL on system database initialization.
2026-04-09 06:59:57 +02:00

2.5 KiB
Raw Blame History

Complete System Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development or superpowers:executing-plans.

Goal: Make the new FastAPI system feature-complete with the old Flask system. Every route, every service function, every template — replicated with the new DuckDB-backed architecture.

Status: Infrastructure done (DuckDB, repos, FastAPI skeleton, CLI, Docker). Missing: business logic wiring, web UI, auth providers, 18 routes, 38 service functions.

Part A: Wire sync trigger to DataSyncManager

Files:

  • Modify: app/api/sync.py (replace stub with real sync)
  • Modify: app/main.py (add instance config loading)

Part B: Instance config integration

Files:

  • Create: app/instance_config.py (load instance.yaml, expose to FastAPI)
  • Modify: app/main.py (lifespan event loads config)
  • Modify: app/api/health.py (include data source info)

Part C: Web UI — Jinja2 templates in FastAPI

Files:

  • Create: app/web/router.py (ALL web routes: /, /dashboard, /catalog, /login, /corporate-memory, /admin/tables, etc.)
  • Copy: webapp/templates/ → app/web/templates/ (adapt for FastAPI)
  • Copy: webapp/static/ → app/web/static/
  • Modify: app/main.py (mount templates + static)

Part D: Auth providers (Google OAuth + Email + Password)

Files:

  • Create: app/auth/providers/google.py
  • Create: app/auth/providers/email.py
  • Create: app/auth/providers/password.py
  • Modify: app/auth/router.py (OAuth callback, magic link, password verify)

Part E: Missing API endpoints (18 routes)

Files:

  • Create: app/api/catalog.py (profile, metrics)
  • Create: app/api/telegram.py (verify, unlink, status)
  • Create: app/api/desktop.py (scripts, run)
  • Create: app/api/admin.py (tables discover, registry CRUD)
  • Modify: app/api/memory.py (add 10 admin governance endpoints)
  • Modify: app/api/sync.py (add sync-settings, table-subscriptions)

Part F: Service logic rewiring

Files:

  • Rewrite all old service calls to use DuckDB repositories
  • Bridge: old corporate_memory_service → KnowledgeRepository
  • Bridge: old sync_settings_service → SyncSettingsRepository
  • Bridge: old telegram_service → TelegramRepository

Part G: CLI missing commands + old test fixes

Files:

  • Create: cli/commands/setup.py
  • Create: cli/commands/server.py
  • Create: cli/commands/explore.py
  • Fix: old tests to work with new code

Part H: Full test coverage

  • Integration tests for all 40 routes
  • E2E Docker test