This repository has been archived on 2026-11-17. You can view files and clone it, but cannot push or open issues or pull requests.
gitgram-ai/V1_90_DAY_BACKLOG.md
2026-06-22 17:45:56 +03:00

113 lines
5.7 KiB
Markdown

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