1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
//! The `.forge/` state API: [`state`] (project state and file locks), [`task`], [`event`] (the
//! append-only log), [`knowledge`] and [`plan`]. Modules hidden from these docs are internals.
/// Context-budget thresholds (PREP/COMPACT/STOP) behind the W2-C fleet HUD.
/// Doctor aggregation — one verdict from quality, release-debt, and drift dimensions.
/// Append-only event log (`.forge/events.jsonl`) for audit trails.
/// UAT finding capture and severity classification.
/// Five-dimension governance health score and drift detection.
/// Knowledge base — research, decisions, learnings, and patterns.
/// Master plan parsing and generation (`.forge/plan.md` / `plan.yaml`).
/// Quality gate checks for release readiness.
/// Release-debt evaluation — version-surface agreement, lockfile sync, tag drift.
/// Ship phase — changelog, archive, and clean state for the next cycle.
/// Project state management (`.forge/state.json`).
/// Task lifecycle — creation, assignment, status transitions, and file locking.