roadmap.md

codexfy Roadmap (PRD Progress Checklist)

Last updated: 2026-02-12

Legend:

• [x] Implemented
• [ ] Not implemented (or only partially implemented)

1) Product Goals (from PRD)

Must-have (Production v1)

• Multi-workspace Codex usage
• One codex app-server per workspace
• Thread discovery, resume, and management
• Streaming conversation timeline
• Safe diff review + apply/reject
• Approval & permission system
• Git awareness and rollback safety
• Strong diagnostics and fault tolerance (partial: now includes runtime error boundary + uncaught error logging, but long-run soak validation is still pending)

Explicit Non-goals (v1)

• Full code editor / LSP (not implemented by design)
• Integrated terminal emulator (not implemented by design)
• Team sync or cloud features (not implemented by design)
• WSL dependency (not required)

2) Core Design Principles

• Protocol-first (JSON-RPC app-server driven)
• User-owned safety (approvals + apply/reject + rollback)
• Native Windows first (Flutter desktop, no WSL requirement)
• Recoverability over automation (backup + git restore paths)
• Future-proofing complete (partial: raw JSONL logging + protocol method manifest/unknown-method warnings exist; automatic schema generation is still not present)

3) High-Level Architecture Components

• Flutter UI
• Codex Process Supervisor
• JSONL / JSON-RPC client flow
• Workspace Manager
• Thread & Timeline Controller
• Diff & Apply Engine
• Git Integration Layer
• Policy / Permissions Engine
• Persistence Layer

4) Dependency Stack (Required by PRD)

Core

• riverpod
• Persistence via hive (PRD allowed isar or hive)
• file_picker
• path, path_provider
• flutter_secure_storage
• flutter_markdown
• flutter_highlight
• diff_match_patch

Platform UX

• window_manager
• tray_manager optional (not required for completion)

5) EPIC Checklist

EPIC A — Setup & Diagnostics

A1. Dependency Detection (“Doctor”)

• Detect codex
• Detect codex app-server
• Detect git
• User-configurable codex path
• Friendly error states

A2. Diagnostics Export

• Central logging
• JSONL protocol recorder
• ZIP export

EPIC B — Workspace Management

B1. Workspace Registry

• Workspace model
• Persistent storage
• Workspace list UI

B2. Codex Process Supervisor

• Process lifecycle manager
• Crash detection
• Restart logic (with exponential backoff)
• Error UI

EPIC C — Threads & Conversations

C1. Thread Discovery

• Thread list request
• Thread metadata model
• UI rendering

C2. Thread Resume

• Resume logic
• Timeline hydration
• Error tolerance

C3. New Thread Creation

• New thread command
• UI update

EPIC D — Conversation Timeline

D1. Timeline Rendering

• Unified event model
• Streaming UI updates
• Filters
• Search

D2. Raw Protocol Viewer (Dev Tool)

• JSONL viewer panel

EPIC E — Diff Review & Change Management

E1. Proposed Changes

• Change model
• Diff renderer
• Change list UI

E2. Apply & Rollback

• Apply logic
• Git restore fallback
• Conflict detection

EPIC F — Approvals & Policy Engine

F1. Approval Prompts

• Approval UI
• Policy persistence

F2. Policy Configuration

• Policy editor
• Enforcement logic (partial: read-only + allowed paths are enforced for local writes; command allowlist is enforced for server command approvals; server file approvals auto-allow when file paths are discoverable from item events, but can still be limited by protocol payload detail)

EPIC G — Git Integration (Baseline)

G1. Git Status

• Git root detection
• Status parsing

G2. Git Diff & Restore

• Diff view
• Restore action

EPIC H — Performance & Stability

H1. Responsiveness

• Isolates (partial: isolate usage is limited; broader heavy-work isolation is not complete)
• Virtualized lists

H2. Fault Tolerance

• Error boundaries
• Recovery UI

EPIC I — Security & Audit

I1. Secrets Handling

• Secure storage integration

I2. Audit Trail

• Audit log model
• Viewer UI

6) Phased Execution Plan Status

Phase 1 — Foundation

• Workspace registry
• Codex process supervisor
• Thread list & resume
• Raw protocol logging
• Activity timeline

Phase 2 — Safety & Review

• Diff model
• Apply/reject workflow
• Approval engine
• Git status & undo

Phase 3 — Production Polish

• Performance tuning (partial)
• Diagnostics export
• Error recovery UX (partial)
• Settings & policy UI

6.1) Codex v2 Parity Additions (Implemented)

• JSON-RPC server request response path (sendResponse) wired
• Command/file approval requests from app-server now resolve back to server
• item/tool/requestUserInput capture + UI + response workflow
• turn/interrupt action from UI
• thread/fork action from UI
• thread/archive action from UI
• thread/unarchive action from UI
• Archived thread list UI section per workspace
• Protocol method manifest + unknown app-server method warning log

7) Deferred / Future Features (Explicit PRD)

• Embedded editor / LSP (deferred)
• Multi-agent dashboard (deferred)
• Remote Codex daemon (deferred)
• GitHub PR & Issues integration (deferred)
• Plugin system (deferred)
• WSL compatibility mode (deferred)
• Team collaboration (deferred)

8) Production Ready Criteria (PRD)

• App runs for hours without leaks (not yet validated in this checklist)
• No data loss on crash (partially mitigated with backups, not fully proven)
• All Codex actions are reviewable and reversible (with known partials above)
• Clear upgrade path for protocol changes (partial: raw logs + protocol manifest warnings exist, full schema generation pipeline still missing)
• Windows users do not need WSL