a48524509a
CLAUDE.md rewritten (708 -> ~320 lines): four overlapping release sections collapsed to one, stale v1->v35 schema history dropped (it lives in CHANGELOG), marketplace endpoint internals and verbose process sections moved out or tightened. New focused docs: - docs/RELEASING.md - release process, deploy workflows, CI quirks (RELEASE_TEMPLATE.md folded in as an appendix) - docs/marketplace.md - marketplace ingestion + re-serving internals - docs/README.md - documentation index by audience, linked from README.md and CLAUDE.md Archived under docs/archive/: docs/superpowers/ (52 historical planning artifacts), HACKATHON.md, pd-ps-comments.md, security-audit-2026-04.md, future/NOTIFICATIONS.md. Removed the docs/auto-install.md stub. Fixed dangling links in connectors/jira/README.md and dev_docs/README.md, repointed code/doc references to archived paths.
69 lines
2.5 KiB
Markdown
69 lines
2.5 KiB
Markdown
# 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
|