docs(FN-4491): complete Step 1 — schema migration plan

Fusion-Task-Id: FN-4491
Fusion-Task-Lineage: 83356e98-5ab8-4f3e-8b46-2960c350a79e
This commit is contained in:
Fusion
2026-05-14 11:33:00 -07:00
committed by gsxdsm
parent 0ea37d8da3
commit e3ec08aadd

View File

@@ -6,6 +6,8 @@ See also: [DagCoordinator design](./milestone-b-dag-coordinator-design.md) · [I
## Goals and non-goals
ADR traceability: this plan derives from ADR-0001 **Decision** (first-class SQLite DAG model), **Consequences #1** (additive storage), and **Consequences #3** (project-local scope).
### Goals
- Additive-only SQLite schema plan for per-project `.fusion/fusion.db` DAG persistence.
- Preserve WAL mode and current migration runner contract in `packages/core/src/db.ts`.
@@ -105,6 +107,8 @@ Rationale:
## Restart recovery contract
ADR traceability: aligns with ADR-0001 **Decision** (SQLite-backed DAG state) and **Consequences #2** (single-event-loop/non-blocking runtime constraints).
For engine boot recovery:
- Source of truth is SQLite rows in `dag_run` + `dag_node` + `dag_edge`.
- Recovery should identify non-terminal runs (`pending|running`) and resume readiness evaluation from persisted statuses.