5.7 KiB
5.7 KiB
V1 90-Day Backlog (Actionable)
Canonical product reference: NORTH_STAR_PRD_ARCHITECTURE_V1.md
Canonical schema reference: CANONICAL_SQL_SCHEMA_V1.sql
Milestone A (Days 1-30) - Core Reliability
Epic A1 - Canonical Data Layer
A1-1Define migration baseline fromCANONICAL_SQL_SCHEMA_V1.sql.- Acceptance: migrations apply cleanly in dev/staging; rollback tested.
A1-2Implement repository/service layer forcheckpoints,checkpoint_files,messages,tool_calls,contexts.- Acceptance: CRUD + listing APIs pass integration tests.
A1-3Add idempotency for action capture (before_action,after_action).- Acceptance: duplicate requests do not create duplicate checkpoints.
Epic A2 - Deterministic Restore
A2-1ImplementPOST /api/time/restorefor project/file/folder scope.- Acceptance: restore supports exact checkpoint IDs and time-based selection.
A2-2ImplementPOST /api/time/undousing linked before/after checkpoints.- Acceptance: undo returns previous good state in one operation.
A2-3Add restore preview endpoint with diff summary.- Acceptance: clients can fetch preview before applying restore.
Epic A3 - Capture Pipeline
A3-1ImplementPOST /api/actions/beforeandPOST /api/actions/after.- Acceptance: every successful action writes linked checkpoints.
A3-2Compute/store unified diffs and file-level stats.- Acceptance:
GET /api/time/diffreturns precomputed diff + stats.
- Acceptance:
A3-3Add sync worker for local cache to backend reconciliation.- Acceptance: sync lag metric reported; retries with backoff enabled.
Epic A4 - Governance Baseline
A4-1Implement consent model (operational_capture,training_export) with org/project scope.- Acceptance: capture/export endpoints enforce consent checks.
A4-2Implement retention policy execution job.- Acceptance: expired records are soft-deleted then hard-deleted per policy.
A4-3Implement audit logging for restore/export/delete actions.- Acceptance: every governed action emits immutable audit event.
Epic A5 - Gitgram Baseline Social
A5-1ImplementPOST /api/repos/importfor public GitHub repos.- Acceptance: imported repo has profile and feed shell.
A5-2Implement posts/comments/reactions/follows APIs.- Acceptance: end-to-end create/read flows work for authenticated users.
A5-3Implement trending scorer v1 (GitHub + internal engagement).- Acceptance:
GET /api/trendingreturns ranked repositories with reasons.
- Acceptance:
Milestone B (Days 31-60) - Social + Time Integration
Epic B1 - Checkpoint-Linked Content
B1-1Add post typechange_storyreferencing checkpoint IDs.- Acceptance: posts can render before/after diff summary.
B1-2Add media upload pipeline for screenshots/videos.- Acceptance: signed upload + moderation scan before publish.
B1-3Add repository timeline widget consuming AITM checkpoints.- Acceptance: repo profile shows ordered technical change events.
Epic B2 - Timeline UX and Reliability
B2-1Ship timeline endpoint pagination/filtering.- Acceptance: filters by actor, tool, file, and date range.
B2-2Add optimistic restore flow with server-side conflict checks.- Acceptance: conflict paths return actionable error payloads.
B2-3Add latency budgets and SLO dashboards for restore/diff/sync.- Acceptance: SLO alerts trigger on threshold breaches.
Epic B3 - Org and Access Controls
B3-1Implement organizations + memberships + role checks.- Acceptance: owner/admin/member role matrix enforced in APIs.
B3-2Implement scoped API keys and key rotation.- Acceptance: read/write/admin scopes fully enforced and auditable.
B3-3Add project-level policy binding (capture/export/retention).- Acceptance: policy inheritance and overrides are deterministic.
Milestone C (Days 61-90) - Intelligence + Growth
Epic C1 - Semantic Search
C1-1Add embedding worker for code/message chunks.- Acceptance: embeddings persisted for eligible checkpoints/messages.
C1-2ImplementPOST /api/search/codeandPOST /api/search/chats.- Acceptance: relevance and latency meet benchmark targets.
C1-3Add hybrid search (keyword + vector rerank).- Acceptance: quality improves over keyword baseline in eval set.
Epic C2 - Training Export Pipeline
C2-1Implement export jobs with consent gate and policy checks.- Acceptance: exports fail closed when consent/policy is missing.
C2-2Implement redaction pass for secrets/PII/license-sensitive text.- Acceptance: sampled audits meet precision/recall targets.
C2-3Implement signed export artifacts + audit traceability.- Acceptance: each artifact maps to consent ID, job ID, and actor ID.
Epic C3 - Creator Growth Features
C3-1Add reels/stories authoring flows for repo owners.- Acceptance: owners can publish media content tied to repo/project.
C3-2Add follow recommendations (repo + developer graph).- Acceptance: recommendation CTR beats random baseline.
C3-3Add anti-abuse moderation queue and enforcement actions.- Acceptance: flagged content lifecycle is fully auditable.
Cross-Cutting Tickets
X-1Test strategy: unit + integration + e2e suites for capture/restore/social/governance APIs.X-2Observability: metrics, tracing, logs with request and checkpoint correlation IDs.X-3Security: threat model review and tenant-isolation verification tests.X-4Documentation: API reference + runbooks + incident handling guides.
KPI Gates (Must Hit)
KPI-1Restore success rate >= 99%.KPI-2P95 restore latency <= 2s (single file), <= 10s (medium project).KPI-3>= 25% of active repos receive at least one social interaction.KPI-4100% training export jobs traceable to consent and audit records.