- Schema version bumped to 36
- Add migrateCostUsdToMicroUsd() helper for safe migration
- Convert cost_usd REAL to cost_micro_usd INTEGER in gate_runs
- Migration: multiply USD values by 1,000,000 to avoid float drift
- Update insertGateRun() to support cost_micro_usd field
- Old cost_usd column retained for backward compatibility
Benefits:
- Eliminates floating-point drift on accumulated costs
- Easier reasoning about cost totals
- Integer arithmetic is faster and more predictable
- Idempotent migration (safe to re-run)
Migration runs automatically on first database open for schema < 36.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
- Updated plan-milestone, plan-slice, plan-task to record planning evidence
- Updated complete-milestone, complete-slice, complete-task to record completion evidence
- All evidence includes relevant spec fields (goals, narratives, decisions, etc.)
- Evidence recorded atomically within transactions
- Enables audit trail queries to reconstruct planning and completion decisions
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Implements data layer functions for managing and querying spec/evidence data.
New export functions:
- insertMilestoneEvidence(): Append evidence for milestone
- insertSliceEvidence(): Append evidence for slice
- insertTaskEvidence(): Append evidence for task
- getMilestoneAuditTrail(): Query full audit trail (spec + evidence + runtime)
- getSliceAuditTrail(): Query slice audit trail with joined spec/evidence
- getTaskAuditTrail(): Query task audit trail with joined spec/evidence
- getMilestoneSpec(): Get spec only (immutable intent)
- getSliceSpec(): Get slice spec only
- getTaskSpec(): Get task spec only
Key properties:
- Evidence functions use timestamp for recording time (set at insertion)
- Audit trail queries JOIN runtime, spec, and evidence tables
- All queries support data archaeology (reconstruct decision history)
- Spec-only queries useful for validation and re-planning
- All functions include JSDoc with purpose and consumer
This completes Phase 3 of Tier 1.3 implementation. Phase 4 (tool updates) and
Phase 5 (integration tests) follow in next PRs.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Implements the 3-table normalization model for milestone, slice, and task entities:
- 9 new tables: {milestone,slice,task}_{specs,evidence} + runtime tables
- milestone_specs: immutable record of intent (vision, goals, risks, proof strategy)
- slice_specs: immutable slice-level intent
- task_specs: immutable task verification criteria
- {entity}_evidence: append-only audit trail with timestamps and phase metadata
- Indices on evidence tables for efficient chronological queries
Key improvements:
- Spec immutability: Write-once specs preserve original intent
- Audit trail: Evidence chain enables data archaeology and decision history
- Query efficiency: Each table contains only relevant columns
- Re-planning clarity: Multiple spec versions can exist for same entity ID
- Forensic capability: Timestamp + phase metadata on evidence rows
Migration:
- Schema version bumped to 32
- Migration runs on first open of existing databases
- No data loss; existing milestone/slice/task rows preserved
- Creates spec and evidence tables from existing columns (future work)
This is Phase 1 of Tier 1.3 implementation (schema definition + basic setup).
Phases 2-5 (migration, data layer updates, tool updates, tests) follow in next PRs.
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
