@entelligentsia/forgecli 1.0.21 → 1.0.36

package/dist/forge-payload/init/workflow-gen-plan.json

@@ -0,0 +1,17 @@
+[
+  {"id": "architect_sprint_intake",            "meta": "meta-new-sprint.md",              "persona": "product-manager"},
+  {"id": "architect_sprint_plan",              "meta": "meta-plan-sprint.md",             "persona": "architect"},
+  {"id": "architect_approve",                  "meta": "meta-approve.md",                 "persona": "architect"},
+  {"id": "architect_review_sprint_completion", "meta": "meta-review-sprint-completion.md","persona": "architect"},
+  {"id": "plan_task",                          "meta": "meta-plan-task.md",               "persona": "architect"},
+  {"id": "implement_plan",                     "meta": "meta-implement.md",               "persona": "engineer"},
+  {"id": "update_plan",                        "meta": "meta-update-plan.md",             "persona": "architect"},
+  {"id": "update_implementation",              "meta": "meta-update-implementation.md",   "persona": "engineer"},
+  {"id": "commit_task",                        "meta": "meta-commit.md",                  "persona": "engineer"},
+  {"id": "review_plan",                        "meta": "meta-review-plan.md",             "persona": "supervisor"},
+  {"id": "review_code",                        "meta": "meta-review-implementation.md",   "persona": "supervisor"},
+  {"id": "collator_agent",                     "meta": "meta-collate.md",                 "persona": "collator"},
+  {"id": "sprint_retrospective",               "meta": "meta-retro.md",                   "persona": "architect"},
+  {"id": "validate_task",                      "meta": "meta-validate.md",               "persona": "qa-engineer"},
+  {"id": "quiz_agent",                         "meta": "meta-check-agent.md",             "persona": "qa-engineer"}
+]

package/dist/forge-payload/integrity.json

@@ -1,23 +1,23 @@
 {
-  "version": "1.2.14",
-  "generated": "2026-06-03",
+  "version": "1.4.4",
+  "generated": "2026-06-07",
   "note": "Tamper-evident only. Authoritative source: /forge:update from remote.",
   "files": {
-    "commands/add-pipeline.md": "529a2fc01be49815efa2cf1147528827ff1bfc12ce2ac8663b5a3a9781f8682e",
-    "commands/add-task.md": "ce3d66fc38e7e0a7592705c559425c6e122f25280b838b631ad44e514bd64e04",
-    "commands/ask.md": "df15f0aa68c93d65bfef05adb514c377bfc65617cafcd79534eb9b4149302657",
-    "commands/check-agent.md": "f92121cb150d4cf601654e25c28d0c13389039518d05433f1040d727054b127e",
-    "commands/config.md": "e67185f98cf0b045890398083991b9d48f32bf0d53bafda1eaca3ce0337ce49c",
+    "commands/add-pipeline.md": "ed4e666b38542d959287116ff6f25e8f51b10c2f18d1fc54974a996fdaf9d8f7",
+    "commands/add-task.md": "1782818b31d602194a2bbab12dda00e3b5a947dd5410ca9078777e79df1ad3ee",
+    "commands/ask.md": "9b53c7636533811d689cfc27e5eeb847c92f8f740434657c61db090a53a4e21f",
+    "commands/check-agent.md": "89d2ebac4910447af22380df5d1b99511d6dae3581374ddb6780e686d8163ce6",
+    "commands/config.md": "e9af723a2cf782d167d75aa29cbbec71e937507b9d7576ad254a5a35acae9df0",
     "commands/enhance.md": "d28f6414119e84973809d32900bb7245b51f565aed86112bc7a994bc6941b547",
-    "commands/health.md": "8f8160d67c09eed9be12445674fc2ab76cf31d548c6268c71f9777dca30c4e47",
-    "commands/init.md": "cf7a70d55f718304820c310465071d3eea9d14a43131623f46b686499f630d4d",
-    "commands/rebuild.md": "9de3a3c1e41169e18758c8598e297c2f395f9daefdd9772783b9b676982cf1c2",
-    "commands/remove.md": "0ca5ec94d52959afaadd74910bd2c81c9872b71c9cc1ce8b89e5af69c06b304f",
-    "commands/repair.md": "22e21614eee31ee630ead3f587b0b948b8c537e54ecef3b65e7d819c55c0ebd4",
-    "commands/report-bug.md": "af8a54bf8887b35e5c880898dd45783f6c2e80d3dc031d6479a6be613ac43053",
+    "commands/health.md": "d92d81ab8614608c383a01f4788fa9aa17a9b07c0d62caebad264a6459b45d58",
+    "commands/init.md": "846e719a85aea6cd706287d6b3bd764d023dae463c0d646c5bf02481c179f4d9",
+    "commands/rebuild.md": "be7cc69c79883d3caae52b1ce8904404ac6d622b84fc17a278f3fd697230842f",
+    "commands/remove.md": "3044c58c699047e94bea4bb26bbe0e8d81425cba1ef2afc7243968e2ee8ab483",
+    "commands/repair.md": "90dd34c87768aef50a46224a21280047ed2376ca59785ecf6403cae3177dfc2f",
+    "commands/report-bug.md": "ae4eb28b54d171de20e89250daadc2a0859887f1d59845a895bd9543b0c1db6f",
     "commands/search.md": "befc4ba9f3146e7599308b35b95ec315e16895c0c18c9c2bab7549619d79bf1c",
-    "commands/status.md": "2fa82a0b11d493918781aec6d95c39411f84fa923662ff3152b6de0cc830d755",
-    "commands/update.md": "c8b69b43567fa5fc328bb3dde31f386d0f577bbcc65dafd525400ae2fb16b132",
+    "commands/status.md": "d1f5e9295b472553fafcd270e34be00560beadfb18b98d4b696845fb794102eb",
+    "commands/update.md": "00cf09b7fa6e84b7bd137a543a11e52c3dbfe3dfe463982dbd6224435ba52345",
     "agents/store-query-validator.md": "f4c3573edcf6e28809515705362df611806a805c5269404fb17e31433cf3a81c",
     "agents/tomoshibi.md": "0c1032df80dfc25a4f482b1276965b5318754d95ccde9f24820846d564e49a27",
     "hooks/check-update.cjs": "9607cc0c51bedcbc123f5ea1d7a492916f29ee1f838846eec64776d5df70bbea",
@@ -30,7 +30,7 @@
     "schemas/transitions/bug.json": "27b17da42d1cebffbd4f61ab3dcd432a0017aa71997d548ed80d22c2fc3fad6a",
     "schemas/transitions/sprint.json": "2e0a629396e687b0ca88e1814ac3e35d84533a5d55b25237ab67feddce3c9deb",
     "schemas/transitions/task.json": "4c71849747baa0d585756e57c56325ff6219c078178374e60815dff91e25e3e7",
-    "schemas/enum-catalog.json": "14fa6c470292fb433a4e33503669f567bd53e3851b25000c05ddca0fdfdd6e58",
+    "schemas/enum-catalog.json": "031b5888c3092dccb23e7fafe6cad3462cd4c8a4af3b055fcd503595818efaa0",
     "tools/verify-integrity.cjs": "3ec3c970dd3d7c3001f8f373bcc40556803eadd2fc2afafb14f1c232cba4cc3f"
   }
 }

package/dist/forge-payload/meta/store-schema/event.schema.md

@@ -10,6 +10,13 @@
 
 Example: `20260415T141523000Z_ACME-S02-T03_engineer_implement`
 
+## Type Vocabulary
+
+The optional `type` field, when present, must come from the canonical
+phase→type tables in `meta/workflows/_fragments/event-vocabulary.md`
+(task / bug / sprint / friction / skill_usage families). The schema enum in
+`schemas/event.schema.json` mirrors that fragment.
+
 ## Fields
 
 | Field | Type | Required | Description |

package/dist/forge-payload/meta/workflows/_fragments/event-emission-schema.md

@@ -4,6 +4,10 @@
      orchestrator stitches runtime telemetry + judgement into the canonical
      event and emits it. Referenced by meta-orchestrate.md and meta-fix-bug.md.
 
+     Companion: _fragments/event-vocabulary.md owns the `type` token
+     vocabulary (phase→type tables for task/bug/sprint events). This fragment
+     owns WHO emits; that one owns WHAT token.
+
      PLAN-11 / SLICE-2 (2026-05-14): the LLM no longer hand-builds event JSON.
      Runtime facts (model, provider, eventId, timestamps, iteration, tokens)
      are owned by the orchestrator, never the subagent. The subagent only

package/dist/forge-payload/meta/workflows/_fragments/event-vocabulary.md

@@ -0,0 +1,88 @@
+# Fragment: Event Type Vocabulary
+
+<!-- Canonical phase→type vocabulary for store events (forge-engineering#39).
+     This fragment OWNS the `type` token vocabulary; `schemas/event.schema.json`
+     mirrors it. Any vocabulary change lands here first, then in the schema enum
+     (test-first via tools/__tests__/event-schema-variants.test.cjs), then in
+     emitters (forge-cli orchestrators, wfl JS drivers, meta workflows).
+
+     Companion: _fragments/event-emission-schema.md owns WHO emits (orchestrator
+     vs subagent field ownership). This fragment owns WHAT token each phase emits.
+
+     Invariant: every token emitted by any surface MUST appear in the schema
+     enum, and every enum token MUST have a named emitter below. Dead tokens are
+     removed (bug-fixed was retired by forge-engineering#39 — defined, never
+     emitted by anything). -->
+
+## Rules
+
+1. **Emitted tokens ⊆ schema enum.** An emitter never invents a token. If a new
+   phase outcome needs a token, add it here + the schema enum first.
+2. **`type` is optional** on events. An untyped event is valid (task-pipeline
+   events from forge-cli run-task are currently untyped). When a `type` IS set,
+   it must come from the tables below.
+3. **Kebab-case for lifecycle tokens.** Underscore names are reserved for the
+   `friction` and `skill_usage` event families.
+4. **Conditional fields.** Typed events trigger schema conditionals — see the
+   "Requires" column. Driver-emitted skip events have no model/provider; emit
+   the literal `"n/a"` for both (never guess a model string — see
+   `_fragments/event-emission-schema.md` §Why no example record here).
+5. **Skip reasons ride in `notes`.** `reason` is not a declared event property
+   (`additionalProperties: false` rejects it).
+
+## Task pipeline (orchestrate_task / run-task / wfl:run-task)
+
+| Phase | Pass token | Fail token | Requires |
+|---|---|---|---|
+| plan | `task-planned` | `task-planned` | taskId, phase, iteration |
+| review-plan | `plan-approved` | `review-failed` | taskId, phase, iteration |
+| implement | `task-implemented` | `task-implemented` | taskId, phase, iteration |
+| review-code | `review-passed` | `review-failed` | taskId, phase, iteration |
+| validate | `task-validated` | `review-failed` | taskId, phase, iteration |
+| approve | `task-approved` | `review-failed` | taskId, phase, iteration |
+| commit | `task-committed` | `task-committed` | taskId, phase, iteration |
+
+`plan-complete` is a legacy alias accepted by the enum for plan-phase events;
+new emitters use `task-planned`.
+
+## Bug pipeline (fix_bug / fix-bug / wfl:fix-bug)
+
+| Phase | Pass token | Fail token | Requires |
+|---|---|---|---|
+| pre-loop skip | `bug-skipped` | — | bugId (no phase/iteration; model/provider `"n/a"`) |
+| triage | `bug-triaged` | `bug-triaged` | bugId, phase, iteration |
+| plan-fix | `fix-planned` | `fix-planned` | bugId, phase, iteration |
+| review-plan | `fix-review-passed` | `fix-review-failed` | bugId, phase, iteration |
+| implement | `fix-implemented` | `fix-implemented` | bugId, phase, iteration |
+| review-code | `fix-code-review-passed` | `fix-code-review-failed` | bugId, phase, iteration |
+| approve | `fix-approved` | `fix-revision-requested` | bugId, phase, iteration |
+| commit | `bug-committed` | `bug-commit-failed` | bugId, phase, iteration |
+
+Non-review phases emit their single token regardless of outcome (the verdict
+field carries the judgement); review phases (review-plan, review-code, approve)
+select pass/fail on `verdict == "revision"`.
+
+## Sprint grain (run_sprint / run-sprint / wfl:run-sprint)
+
+| Moment | Token | Requires |
+|---|---|---|
+| before wave loop | `sprint-start` | sprintId (taskCount optional) |
+| before each task dispatch | `task-dispatch` | taskId (convention; phase/iteration carried but not schema-enforced) |
+| sprint finished | `sprint-complete` | taskCount, completedTaskIds, verdict |
+| sprint aborted | `sprint-halted` | haltedAtTaskIndex, haltedAtTaskId, lastError |
+
+## Other families
+
+| Token | Emitter | Spec |
+|---|---|---|
+| `friction` | any persona, drained by orchestrator | `_fragments/friction-emit.md` |
+| `skill_usage` | forge-cli skill-curation telemetry | `event.schema.json` skill_usage conditional |
+
+## Out of scope (known follow-ups)
+
+- **Feature events** have no lifecycle tokens; feature-related events are
+  emitted untyped. Defining a feature vocabulary is a future change to this
+  fragment + the enum.
+- **Task-pipeline typed emission in forge-cli** — run-task currently emits
+  untyped events (valid under Rule 2); adopting the task table above is
+  forward work tracked in forge-engineering#39 step 3.

package/dist/forge-payload/meta/workflows/meta-collate.md

@@ -80,12 +80,11 @@ Never set `FORGE_SKIP_WRITE_VALIDATION=1` — operator-only emergency switch.
      }
      ```
      The orchestrator reads this file directly to compose the collation event narrative. Do NOT call `set-summary` to register it — that would mutate the store in violation of Iron Law 1.
-   - Invoke Tomoshibi via Skill tool to refresh KB and workflow links in agent
-     instruction files:
-     ```
-     Use the Skill tool:
-       skill: "forge:refresh-kb-links"
-     ```
+   - KB link refresh (best-effort; skip if unavailable):
+     When running standalone in the Claude Code TUI, invoke via the Skill tool
+     (`skill: "forge:refresh-kb-links"`).
+     When running as a subagent within forge-cli (Pi runtime), the TS orchestrator
+     calls `runRefreshKbLinks` directly after this phase — skip this step.
 ```
 
 <!-- See _fragments/generation-instructions.md for Generation Instructions template -->

package/dist/forge-payload/meta/workflows/meta-commit.md

@@ -32,6 +32,8 @@ Seal a completed and approved task by committing its artifacts to the VCS and up
 - Commit only the artifacts produced for this task; do not sweep unrelated working-tree changes into the commit. The commit boundary mirrors the task boundary.
 - Read `.forge/personas/engineer.md` first; print the persona identity line (emoji, name, tagline) to stdout before any other tool use.
 - All store I/O via `forge_store` (or `node .forge/tools/store-cli.cjs`). Never edit `.forge/store/*.json` directly.
+- **Never run `git add`/`git commit`/`git reset` yourself** — `commit-task.cjs` owns staging, boundary checks, committing, and the terminal transition (#40). Your judgement input is the message.
+- **Commit writes NO summary** (`commit` ∉ `VALID_SUMMARY_PHASES` — any `set-summary` is rejected); the tool's terminal `update-status` is this phase's only store write.
 
 ## Store-Write Verification
 
@@ -41,55 +43,56 @@ Seal a completed and approved task by committing its artifacts to the VCS and up
 
 ```
 
-0a. Pre-flight Gate Check:
-   - **Entity-mode resolution:** read the kickoff arguments. `--task {id}` → `entity_kind = "task"`, `record_id = {id}`. `--bug {id}` → `entity_kind = "bug"`, `record_id = {id}`. All store-cli calls below substitute `{entity_kind}` and `{record_id}` for the literal "task"/{taskId} placeholders.
-   - Run: `node .forge/tools/preflight-gate.cjs --phase commit --{entity_kind} {record_id}`
-   - Exit 1 (gate failed) → print stderr and HALT. Do not proceed; do not attempt to produce the artifact.
-   - Exit 2 (misconfiguration) → print stderr and HALT.
-   - Exit 0 → continue.
-
-0b. Pipeline Step Guard (user-invoked state check):
-   - If `--force` is present in the invocation arguments, skip this step entirely.
-   - If `entity_kind == "bug"`, skip this step entirely (bug state is managed by meta-fix-bug.md).
-   - Read current task state:
-     `node .forge/tools/store-cli.cjs read task {record_id} --json`
-   - Extract the `status` field from the JSON output.
-   - Allowed states for this phase: `approved`.
-   - If the current status is NOT in the allowed set:
-     Print the following and HALT (do not proceed):
-     `× Task {record_id} is in state '{status}' — /forge:approve must complete first. To run the full pipeline: /forge:run-task {record_id}`
-
-1. Load Context:
-   - Read the record manifest (task or bug, per entity_kind).
-   - Read ARCHITECT_APPROVAL.md by kind — never construct the path:
-     `forge_artifact({ command:"read", entity:"{entity_kind}", entityId:"{record_id}", artifact:"architect-approval" })`
-
-2. Staging:
-   - Stage all record-related artifacts and the code changes:
-     - Task mode: PLAN.md, PROGRESS.md, REVIEW files, ARCHITECT_APPROVAL.md, and the implementation diff under the task directory plus modified source files.
-     - Bug mode: BUG_FIX_PLAN.md (Path B only — absent on Path A), TRIAGE.md, PROGRESS.md, REVIEW files, ARCHITECT_APPROVAL.md, the regression test, and the implementation diff.
-   - Verify no unrelated files are staged.
-
-3. Commit:
-   - Create a commit with a message following project conventions.
-   - Include the record ID in the commit message: task ID for task mode, bug ID for bug mode.
-   - Append a `Co-authored-by:` trailer crediting the AI assistant that actually ran the session. Resolve the identity from the host runtime: on Claude Code use `Co-authored-by: Claude <noreply@anthropic.com>`; on pi / Ollama / any other runtime use `Co-authored-by: {modelId} <noreply@{provider}.ai>` derived from the session's `provider` and `modelId` (e.g. `Co-authored-by: glm-5.1:cloud <noreply@ollama.ai>`); if neither is resolvable, omit the trailer rather than guess. Do NOT hardcode `Claude Opus 4.6 <noreply@anthropic.com>` — that literal is rejected as a regression of forge#82 (commits authored under the wrong model).
-   - Let git's configured `user.name` / `user.email` own the commit author; never pass `--author` to override it.
-
-4. Store Finalization:
-   - Transitions:
-     - **Task mode** — `approved → committed` (terminal): `node .forge/tools/store-cli.cjs update-status task {taskId} status committed`
-     - **Bug mode** — `in-progress → fixed` (terminal): `node .forge/tools/store-cli.cjs update-status bug {bugId} status fixed`. This is the ONLY phase in the bug pipeline that writes `bug.status` post-triage (see `meta-fix-bug.md § Iron Laws #2`). Do NOT write `approved` or `verified` — those values are vestigial enum members slated for removal.
-
-5. Finalize:
-   - **Do NOT emit a phase event yourself.** The orchestrator owns event emission — it composes the canonical event from runtime telemetry (model, provider, tokens, wall times) plus the SUMMARY you write in the next step. Subagents that call `store-cli emit` for phase events hallucinate runtime facts (see Plan 11 / Slice 2). Write the SUMMARY and return.
+0. Entity-mode resolution:
+   - Read the kickoff arguments. `--task {id}` → `entity_kind = "task"`, `record_id = {id}`. `--bug {id}` → `entity_kind = "bug"`, `record_id = {id}`.
+
+1. Inspect ONCE (message material only — #40 batched-inspection rule):
+   - One `git diff --stat`; at most ONE combined `git diff` if the message needs detail.
+     Never per-file diffs, never repeated `git status` — each extra turn re-pays full context.
+   - Staging is NOT your decision — the tool derives it from the store record.
+
+2. Craft the commit message:
+   - Follow project conventions; include the record ID ({taskId} / {bugId}) in the subject.
+   - `Co-authored-by:` trailer from the host runtime: Claude Code →
+     `Co-authored-by: Claude <noreply@anthropic.com>`; pi / Ollama / other →
+     `Co-authored-by: {modelId} <noreply@{provider}.ai>` from the session's `provider` and
+     `modelId`; if unresolvable, omit rather than guess. Never hardcode
+     `Claude Opus 4.6 <noreply@anthropic.com>` (forge#82 regression).
+   - Git's configured `user.name`/`user.email` own authorship; never `--author`.
+
+3. Commit via the tool — ONE call:
+   - If the `forge_commit` named tool is available (forgecli): call it —
+     `forge_commit({ entity:"{entity_kind}", id:"{record_id}", message:"<message>", trailer:"<line>" })`.
+     Never pass the message through a bash string when the typed tool exists.
+   - Otherwise (Claude Code): `node .forge/tools/commit-task.cjs --{entity_kind} {record_id} --message "<message>" [--trailer "<Co-authored-by line>"]`
+   - The tool owns the choreography: preflight gate (`preflight-gate.cjs --phase commit`
+     internally), status precondition (task `approved` / bug `in-progress` — wrong-state runs
+     halt with `× {record_id} is in state '{status}' …; /forge:approve must complete first`),
+     staging (artifact dir + `summaries.implementation.files_changed` provenance),
+     commit-boundary guard (aborts on a pre-staged index), `git commit`, terminal transition
+     (task → `committed`; bug → `fixed`, the ONLY post-triage `bug.status` write).
+   - On `no files_changed provenance` warning: ONE `git status --porcelain`, then re-run the
+     tool with `--also <path>` per source file. Never manual `git add`.
+   - Success → JSON with `ok:true`. `committed:true` carries `sha` + `staged`;
+     `committed:false, reason:"nothing-to-commit"` is ALSO success (fix already at HEAD /
+     staging set clean — the tool still sealed the record's terminal status). Do not
+     "fix" a no-op by staging things yourself.
+   - Failure (exit 1 / ok:false) → print stderr and HALT — no manual staging, no
+     `git reset`, no `--force` retry (operator-gated). Tool file missing → HALT;
+     instruct `/forge:update` + `/forge:rebuild tools`.
+   - NEVER commit before the tool reports `ok: true` — the premature-commit/reset/redo loop
+     is forbidden.
+
+4. Finalize:
+   - No summary, no `set-summary` (see Iron Laws). **Do NOT emit a phase event yourself** —
+     the orchestrator owns event emission. Return the tool's JSON result as your phase output.
 ```
 
 <!-- See _fragments/generation-instructions.md for Generation Instructions template -->
 ## Generation Instructions
 
 - **Workflow Structure:** The generated `commit_task.md` must follow the strict "Algorithm" block format.
-- **Context Isolation:** Forbid inline execution of commit operations; use the `Agent` tool for sub-tasks.
+- **Tool Ownership:** All git operations route through `commit-task.cjs` (forge-engineering#40) — the generated workflow must never instruct manual `git add`/`git commit`/`git reset`.
 - **Project Specifics:**
   - Embed project's commit message conventions.
 - **Token Reporting:** See `_fragments/finalize.md` — wire via `file_ref:`.

package/dist/forge-payload/meta/workflows/meta-fix-bug.md

@@ -148,7 +148,9 @@ Differences are confined to the **triage** step and the **path branch**.
    - Detect execution cluster from ANTHROPIC_DEFAULT_*_MODEL env vars.
    - Clear progress log: store-cli progress-clear bugs
    - Read bug record. If status ∈ {blocked, escalated, fixed, abandoned}:
-     skip the run, emit a single `bug_skipped` event, return.
+     skip the run, emit a single `bug-skipped` event (token + payload shape per
+     `_fragments/event-vocabulary.md` § Bug pipeline: requires `bugId`, no
+     phase/iteration; model/provider `"n/a"`; skip reason in `notes`), return.
 
 2. Triage:
    - Locate or create the bug record (MANDATORY — do this before anything else):
@@ -503,7 +505,10 @@ After each subagent returns: `✓` for completed/approved, `↻` for revision re
 <!-- See _fragments/event-emission-schema.md for canonical contract -->
 > See `_fragments/event-emission-schema.md` for the actor split (subagent
 > writes judgement-only SUMMARY; orchestrator composes the canonical event
-> from runtime telemetry + SUMMARY and emits it).
+> from runtime telemetry + SUMMARY and emits it), and
+> `_fragments/event-vocabulary.md` § Bug pipeline for the canonical
+> phase→`type` token table (pass/fail tokens per phase, `bug-skipped`
+> pre-loop skip shape). Emitted tokens MUST come from that table.
 
 The orchestrator is the only actor that calls `store-cli emit` for phase
 events. All bug-phase events use `sprintId="bugs"` (the reserved virtual

package/dist/forge-payload/meta/workflows/meta-implement.md

@@ -87,13 +87,13 @@ The Engineer implements the approved plan: write code, run tests, verify, and do
          `node .forge/tools/store-cli.cjs update-status task {taskId} status implementing`
          `node .forge/tools/store-cli.cjs update-status task {taskId} status implemented`
      - **Bug mode** — NO status write. The bug remains `in-progress` until the commit phase transitions it to `fixed`. Writing `bug.status` here violates `meta-fix-bug.md § Iron Laws #2`.
-   - **Do NOT emit a phase event yourself.** The orchestrator owns event emission — it composes the canonical event from runtime telemetry (model, provider, tokens, wall times) plus the SUMMARY you write in the next step. Subagents that call `store-cli emit` for phase events hallucinate runtime facts (see Plan 11 / Slice 2). Write the SUMMARY and return.
+   - **Do NOT emit a phase event yourself.** The orchestrator owns event emission — it composes the canonical event from runtime telemetry plus the SUMMARY you write next. Subagents that call `store-cli emit` for phase events hallucinate runtime facts (Plan 11 / Slice 2). Write the SUMMARY and return.
 
 7. Emit Summary Sidecar:
    - Write `IMPLEMENTATION-SUMMARY.json` via `forge_artifact`:
      `forge_artifact({ command:"write", entity:"{entity_kind}", entityId:"{record_id}", artifact:"implementation-summary", content:"<JSON>" })`
-     JSON shape: `{"objective":"<one sentence>", "key_changes":["<up to 12 bullets>"], "verdict":"n/a", "written_at":"<ISO 8601>", "artifact_ref":"PROGRESS.md"}`
-     The tool validates required fields automatically — fix and retry if it rejects.
+     JSON shape: `{"objective":"<one sentence>", "key_changes":["<up to 12 bullets>"], "files_changed":["<path>"], "verdict":"n/a", "written_at":"<ISO 8601>", "artifact_ref":"PROGRESS.md"}`
+   - `files_changed`: every repo path this phase changed (one `git status --porcelain`); `commit-task.cjs` stages from it.
    - Then link sidecar to store (task mode):
      `forge_store({ command:"set-summary", args:["{taskId}", "implementation"] })`
      Or (bug mode):

package/dist/forge-payload/meta/workflows/meta-migrate.md

@@ -295,7 +295,7 @@ node .forge/tools/substitute-placeholders.cjs \
 ```
 
 This overwrites `.forge/personas/`, `.forge/skills/`, `.forge/workflows/`,
-`.forge/templates/`, and `.claude/commands/<prefix>/` with the freshly substituted
+`.forge/templates/`, and `.claude/commands/forge/` with the freshly substituted
 base-pack.
 
 If `substitute-placeholders.cjs` exits non-zero: halt, report the error to the

package/dist/forge-payload/meta/workflows/meta-orchestrate.md

@@ -950,7 +950,10 @@ is a violation of the Iron Laws.
 <!-- See _fragments/event-emission-schema.md for canonical contract -->
 > See `_fragments/event-emission-schema.md` for the actor split (subagent
 > writes judgement-only SUMMARY; orchestrator composes the canonical event
-> from runtime telemetry + SUMMARY and emits it).
+> from runtime telemetry + SUMMARY and emits it), and
+> `_fragments/event-vocabulary.md` § Task pipeline / § Sprint grain for the
+> canonical phase→`type` token tables. When setting `type` on a phase or
+> sprint event, the token MUST come from those tables.
 
 The **orchestrator** is the only actor that calls `store-cli emit` for phase
 events. Phase subagents write `{PHASE}-SUMMARY.json` and return. After each

package/dist/forge-payload/schemas/enum-catalog.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.2.13",
-  "generated": "2026-06-03",
+  "version": "1.4.3",
+  "generated": "2026-06-07",
   "note": "Authoritative enum catalog. Source: build-enum-catalog.cjs. Regenerate via node forge/tools/build-manifest.cjs.",
   "enums": {
     "task.status": [

package/dist/forge-payload/schemas/event.schema.json

@@ -59,11 +59,11 @@
         "sprint-complete",
         "sprint-halted",
         "task-dispatch",
-        "bug-fixed",
 
         "bug-triaged", "fix-planned", "fix-review-passed", "fix-review-failed",
         "fix-implemented", "fix-code-review-passed", "fix-code-review-failed",
-        "fix-approved", "bug-committed",
+        "fix-approved", "fix-revision-requested", "bug-committed",
+        "bug-commit-failed", "bug-skipped",
 
         "skill_usage"
       ]
@@ -129,7 +129,8 @@
             "enum": [
               "bug-triaged", "fix-planned", "fix-review-passed", "fix-review-failed",
               "fix-implemented", "fix-code-review-passed", "fix-code-review-failed",
-              "fix-approved", "bug-committed", "bug-fixed"
+              "fix-approved", "fix-revision-requested", "bug-committed",
+              "bug-commit-failed"
             ]
           }
         },
@@ -137,6 +138,10 @@
       },
       "then": { "required": ["bugId", "phase", "iteration"] }
     },
+    {
+      "if": { "properties": { "type": { "const": "bug-skipped" } }, "required": ["type"] },
+      "then": { "required": ["bugId"] }
+    },
     {
       "if": { "properties": { "type": { "const": "sprint-start" } }, "required": ["type"] },
       "then": {

package/dist/forge-payload/schemas/structure-manifest.json

@@ -1,6 +1,6 @@
 {
-  "version": "1.2.13",
-  "generatedAt": "2026-06-03T05:20:45.625Z",
+  "version": "1.4.3",
+  "generatedAt": "2026-06-07T14:06:39.707Z",
   "generatedByTool": "build-manifest.cjs",
   "namespaces": {
     "personas": {
@@ -94,6 +94,7 @@
       "files": [
         "context-injection.md",
         "event-emission-schema.md",
+        "event-vocabulary.md",
         "finalize.md",
         "friction-emit.md",
         "generation-instructions.md",
@@ -108,6 +109,7 @@
       "dir": ".claude/workflows",
       "files": [
         "wfl-fix-bug.js",
+        "wfl-init.js",
         "wfl-run-sprint.js",
         "wfl-run-task.js"
       ]
@@ -141,42 +143,33 @@
         "artifact.cjs",
         "backfill-provider.cjs",
         "banners.cjs",
-        "build-base-pack.cjs",
         "build-context-pack.cjs",
-        "build-enum-catalog.cjs",
         "build-init-context.cjs",
-        "build-manifest.cjs",
         "build-overlay.cjs",
         "build-persona-pack.cjs",
-        "check-no-skipped-tests.cjs",
         "check-structure.cjs",
         "collate.cjs",
+        "commit-task.cjs",
         "compression-gate.cjs",
         "delete-candidate-detector.cjs",
-        "estimate-usage.cjs",
         "forge-preflight.cjs",
         "friction-emit.cjs",
-        "gen-integrity.cjs",
         "generation-manifest.cjs",
         "judge-proposal.cjs",
         "manage-config.cjs",
         "manage-versions.cjs",
-        "migrate-slug-maxlen.cjs",
         "parse-gates.cjs",
         "postflight-gate.cjs",
         "preflight-gate.cjs",
-        "proposal-normalize.cjs",
         "query-logger.cjs",
         "queue-drain.cjs",
         "read-verdict.cjs",
         "replay-scoring.cjs",
-        "rewrite-plugin-urls.cjs",
         "seed-store.cjs",
         "store-cli.cjs",
         "store-query.cjs",
         "store.cjs",
         "substitute-placeholders.cjs",
-        "token-forensics.cjs",
         "validate-store.cjs",
         "verify-apply.cjs",
         "verify-integrity.cjs",