reference data models

Data models

The data model is defined in src/runtime/schema.ts and persisted through src/runtime/workspace.ts. Runtime API input schemas in src/runtime/api.ts reuse these domain schemas.

Session

Field	Meaning
`version`	Literal `2`.
`id`	Session id.
`goal`	User goal.
`status`	`planning`, `ready`, `running`, `blocked`, or `completed`.
`approval`	`pending` or `approved`.
`plan`	`Plan` or `null`.
`activeFeatureId`	Current feature id or `null`.
`history`	Completion and blocker history entries.
`closure`	Completed, deferred, or abandoned closure record.
`lastError`	Last runtime completion or transition error.
`timestamps`	Created, updated, and completed timestamps.

Plan and feature

PlanSchema stores summary, overview, requirements, decisions, finalReviewPolicy, and features. FeatureSchema stores id, title, summary, status, targets, validation, and dependsOn.

Evidence

Schema	Fields
`ValidationRunSchema`	`command`, `status`, `summary`.
`ReviewSchema`	`status`, `summary`, `blockingFindings`.
`FinalReviewSchema`	Review fields plus `reviewDepth`.
`WorkerResultSchema`	`status`, `featureId`, `summary`, artifacts, validation, review, final review, and outcome.

Runtime API payloads

Tool	Schema
`flow_plan_save`	`FlowPlanSaveSchema` in `src/runtime/api.ts`.
`flow_run_start`	`FlowRunStartSchema` in `src/runtime/api.ts`.
`flow_feature_complete`	`FlowFeatureCompleteToolSchema` in `src/runtime/api.ts`.
`flow_feature_reset`	`FlowFeatureResetSchema` in `src/runtime/api.ts`.
`flow_session_close`	`FlowSessionCloseSchema` in `src/runtime/api.ts`.