Skip to content

ROADMAP.md

Latest commit

 

History

History
158 lines (129 loc) · 5.13 KB

ROADMAP.md

File metadata and controls

158 lines (129 loc) · 5.13 KB

CodeDelta Roadmap

Phase 1 — Foundation ✅

  • npm workspaces and package layout
  • @codedelta/types
  • @codedelta/repo-manager
  • @codedelta/server import/branches/commits APIs + registry persistence
  • @codedelta/web import/timeline shell + settings shell
  • README repositioning to CodeDelta

Phase 2 — Delta View Foundation (commit-to-commit) ✅

Implemented in this phase:

  • CodeGraph.exportGraph() and edge export support
  • @codedelta/snapshot-manager
    • safe worktree checkout (no active worktree mutation)
    • snapshot cache key: {repoId}/{commitHash}/{analyzerVersion}
    • CodeGraph primary path + TS/JS fallback extractor
  • @codedelta/graph-diff
    • added/removed/modified nodes
    • added/removed edges
    • affected nodes via BFS (calls, imports)
  • @codedelta/impact-score
    • deterministic scoring (files, symbols, edges, affected nodes)
    • risk tags (auth, billing, database, migration, env, config, api, routing, dependency)
  • Compare API
    • GET /api/repos/:repoId/compare?base=<hash>&head=<hash>
    • error mapping for repo/commit/snapshot/timeout/size/unsupported
  • Delta View UI first functional version
    • base/head selectors
    • compare with previous commit
    • changed files panel
    • graph diff summary panel
    • impact/risk panel
    • structural node/edge lists
  • Timeline integration
    • action: Compare with previous commit

Notes

  • POST /api/repos/:id/delta is deprecated and now returns guidance to use GET /compare.
  • Rich graph rendering is intentionally deferred.

Phase 2.5 — Delta View UX Refinement ✅

Implemented in this phase:

  • Deterministic DeltaSummary generation
    • changed files/symbols/edges/affected metrics
    • main changed areas/modules
    • risk breakdown with reasons
    • suggested review order
  • Impact score explanation
    • severity labels (low/medium/high/critical)
    • explanation reasons + top contributors
  • File-level diff API
    • GET /api/repos/:repoId/diff?base=<hash>&head=<hash>&file=<path>
    • path traversal validation + clear error mapping
    • unified patch + parsed hunks
  • Delta View UX reorganization
    • summary-first information hierarchy
    • tabs for files/symbols/edges/metrics
    • changed files and symbols open file diff modal

Deferred TODOs

  • symbol-to-hunk precise mapping in diff viewer
  • richer graph rendering
  • LLM-assisted summary (optional mode)
  • Trace View foundation
  • Codex OAuth（本机 codex login）

Current supported DeltaSource

Implemented:

type DeltaSource = {
  type: 'commit';
  commitHash: string;
  label?: string;
};

Not implemented yet (planned):

  • branch
  • tag
  • pull_request
  • working_tree
  • folder

Phase 3 — Trace View + Providers ✅ (foundation)

  • @codedelta/trace-engine deterministic candidate retrieval + evidence assembly
  • @codedelta/provider-runtime no-AI fallback + minimal OpenAI/OpenAI-compatible adapter
  • POST /api/repos/:id/trace production foundation implementation
  • Trace View UI first functional version
    • question input / branch / commitLimit / includeDiffEvidence
    • candidate commits with reasons and relevance score
    • evidence panel + impact radius + evolution + uncertainty
    • candidate -> Delta verification navigation (previous -> candidate)
  • low-history fallback behavior (low confidence + uncertainty guidance)

Phase 3 deferred TODOs

  • Codex OAuth provider（本机 CLI 凭据 + ChatGPT backend）
  • richer provider adapters (Anthropic/Ollama)
  • stronger trace confidence calibration
  • richer graph-backed evidence (deeper call-path reasoning)
  • branch/PR/working-tree/folder trace sources

Phase 4 — Depth and polish

  • Deeper CodeGraph integration for snapshots (incremental indexing / reuse)
  • Rich graph visualization foundation (React Flow panorama — entry exploration, Delta overlay, Trace highlight)
  • Private GitHub repository support
  • Incremental snapshot acceleration for large repositories
  • Timeline-level persisted impact scores
  • Extended DeltaSource variants beyond commits

Phase Desktop — macOS app (MVP)

  • @codedelta/server static UI hosting + CODEDELTA_MONOREPO_ROOT
  • Web boot screen (/api/health polling, git banner)
  • scripts/desktop-stage.mjs — embedded Node 22+ (node:sqlite) + production runtime
  • apps/desktop Tauri 2 shell (spawn/kill API, single instance, 127.0.0.1:3847)
  • Import page recent repositories
  • npm run dev:desktop / stage:desktop / build:desktop
  • Apple code signing + notarization for public distribution
  • Windows desktop (x64 NSIS installer, CI + GitHub Releases)
  • Linux desktop
  • Auto-update, menu bar quick open, drag-and-drop import

Architecture snapshot

flowchart LR
  subgraph phase2 [Phase2_Delta]
    Repo[repo_manager]
    Snap[snapshot_manager]
    Diff[graph_diff]
    Impact[impact_score]
    API[compare_api]
    UI[delta_view_ui]
  end
  CG[CodeGraph_core]
  Repo --> Snap
  Snap --> CG
  Snap --> Diff
  Diff --> Impact
  Impact --> API
  API --> UI
Loading