@entelligentsia/forgecli 1.0.25 → 1.0.40

package/dist/forge-payload/init/generation/generate-workflows.md

@@ -0,0 +1,78 @@
+# Workflow Generation — Per-Subagent Instructions
+
+You are generating **ONE** workflow file. You have been given three inputs:
+
+1. A **project brief** (`.forge/init-context.md`) — authoritative for all names,
+   paths, and placeholder values
+2. A **meta-workflow source** — your generation algorithm and Generation Instructions
+3. A **persona file** (already generated) — embed verbatim as the opening section
+
+Your job is to produce exactly one file and return a one-line status.
+
+---
+
+## Inputs
+
+Read these three sources before writing anything:
+
+- `.forge/init-context.md` — the project brief (passed inline in your prompt)
+- `$FORGE_ROOT/meta/workflows/{meta}` — the meta-workflow for your assigned workflow
+- `.forge/personas/{persona}.md` — the persona file for your assigned role
+
+---
+
+## Rules
+
+1. **Write EXACTLY ONE file:** `.forge/workflows/{id}.md`
+
+2. **Opening section** — the generated file must begin with:
+   a. The meta-workflow's YAML frontmatter block (`---` … `---`) verbatim,
+      if present. This carries `requirements:` fields used for runtime model
+      selection and must be preserved exactly.
+   b. Immediately after the closing `---`, embed the persona file content
+      verbatim as the first section. Do not paraphrase or summarise.
+
+3. **Placeholder substitution** — all `{SYNTAX_CHECK}`, `{TEST_COMMAND}`,
+   `{BUILD_COMMAND}`, `{LINT_COMMAND}` values come from the brief's
+   `## Commands` section. Do not invent values.
+
+4. **Name vocabulary** — all persona names, template names, architecture doc
+   names, and entity names MUST appear in the brief. Do not invent or rename
+   anything not listed there.
+
+5. **Required steps** — follow the meta-workflow's Generation Instructions.
+   Include the Knowledge Writeback step and the Event Emission step as defined
+   in the meta-workflow (unless the meta explicitly omits them, e.g. quiz_agent).
+
+6. **Enforcement quality** — for review workflows, include:
+   - A Rationalization Table of common agent excuses and factual rebuttals
+   - "YOU MUST" / "No exceptions" gate language at critical checks
+   - An announcement pattern: the agent declares intent at workflow start
+
+7. **No free-form additions** — do not add sections, steps, or notes beyond
+   what the meta-workflow and project brief prescribe.
+
+---
+
+## Self-check (mandatory last step)
+
+After writing the file, verify before returning:
+
+1. Read back `.forge/workflows/{id}.md`
+2. Confirm the persona symbol appears as the **first non-blank line after the
+   closing `---`** of the frontmatter block (or as the absolute first non-blank
+   line if the meta-workflow had no frontmatter). The symbol is listed in the
+   brief's `## Personas` section for this workflow's role.
+3. Confirm **no unsubstituted placeholders** remain (no literal `{TEST_COMMAND}`,
+   `{BUILD_COMMAND}`, `{SYNTAX_CHECK}`, or `{LINT_COMMAND}` in the file)
+4. Record in the manifest:
+   ```sh
+   node "$FORGE_ROOT/tools/generation-manifest.cjs" record ".forge/workflows/{id}.md"
+   ```
+   (If generation-manifest.cjs is not yet installed, skip silently.)
+
+5. Return **exactly one line**:
+   - `done: <first 80 chars of the written file>` — on success
+   - `FAILED: <reason>` — if any step above failed or the file could not be written
+
+Do not output anything else after the status line.

package/dist/forge-payload/init/phases/phase-1-collect.md

@@ -9,6 +9,10 @@ parent directory — the folder containing `meta/` and `init/`).
 
 ## Pre-flight — Knowledge Base Folder
 
+> **Orchestrator note:** If your orchestrator (e.g. the `wfl:init` driver or the CLI-first
+> wrapper) has already supplied a `kbFolder` value, use it directly — skip this prompt.
+> This interactive block applies only to unmediated orchestrator-free execution.
+
 Before Phase 1 begins, ask the user where to create the knowledge base folder:
 
 ```
@@ -74,13 +78,13 @@ Using your discovery findings, write `.forge/config.json` with this structure:
     "engineering": "engineering",
     "store": ".forge/store",
     "workflows": ".forge/workflows",
-    "commands": ".claude/commands/<prefix-lowercased>",
+    "commands": ".claude/commands/forge",
     "templates": ".forge/templates"
   }
 }
 ```
 
-`<prefix-lowercased>` = the `project.prefix` value you chose, lowercased. For example, if prefix is `HELLO`, write `".claude/commands/hello"`.
+`paths.commands` is ALWAYS `".claude/commands/forge"` — the command namespace is fixed (CLI-first redesign); it does NOT derive from the project prefix.
 
 Write using:
 ```sh
@@ -103,6 +107,10 @@ If any key is missing or empty, fix it now before proceeding.
 
 ### Step 5 — Marketplace Skills
 
+> **Orchestrator note:** If your orchestrator handles the skills install offer post-workflow
+> (e.g. the `init.md` wrapper does this after `wfl:init` returns), skip this step. Return
+> `{ matches, alreadyInstalled }` from the config-writer agent instead.
+
 Read `$FORGE_ROOT/meta/skill-recommendations.md` for the full mapping.
 
 Using the stack discovered above, look up matching skills from the recommendation

package/dist/forge-payload/init/phases/phase-3-materialize.md

@@ -63,13 +63,17 @@ node "$FORGE_ROOT/tools/substitute-placeholders.cjs" \
 ```
 
 Output directories (managed by the tool's `SUBDIR_OUTPUT_MAP`):
-- `base-pack/commands/`     → `.claude/commands/<prefix-lowercased>/`
 - `base-pack/personas/`     → `.forge/personas/`
 - `base-pack/skills/`       → `.forge/skills/`
 - `base-pack/workflows/`    → `.forge/workflows/`
 - `base-pack/templates/`    → `.forge/templates/`
 - `base-pack/workflows-js/` → `.claude/workflows/` (JS orchestration workflows — FORGE-S28-T01)
 
+> Commands are no longer materialised here. Since FORGE-S32-T06 the unified
+> slash-command tree (`forge/forge/commands/`) is installed verbatim to
+> `.claude/commands/forge/` by the bootstrap manifest's single `commands` entry —
+> base-pack no longer carries a `commands/` subdir.
+
 ### Step 3a — Record generated JS workflows in the generation manifest
 
 After `substitute-placeholders.cjs` writes the JS workflows, record them in the generation

package/dist/forge-payload/init/phases/phase-4-register.md

@@ -102,6 +102,10 @@ console.log('ノ update-check-cache.json written');
 
 ### Step 11 — Tomoshibi (refresh-kb-links)
 
+> **Orchestrator note:** This step is orchestrator-owned. When running under `wfl:init`, the
+> register agent returns `pendingActions: ["refresh-kb-links"]` and the command wrapper
+> invokes the Skill. Do NOT execute this step if your orchestrator owns it.
+
 Use the Skill tool:
 ```
 skill: "forge:refresh-kb-links"
@@ -134,6 +138,10 @@ Fallback if unavailable:
 
 ### Step 13 — Agent instruction file linking
 
+> **Orchestrator note:** If your orchestrator pre-answered the CLAUDE.md creation prompt
+> (via `args.createClaudeMd`), use that value directly — skip the interactive prompt.
+> Execute the file creation only if `createClaudeMd === true`.
+
 Check whether any agent instruction file exists at the project root:
 ```sh
 ls CLAUDE.md AGENTS.md CLAUDE.local.md .cursorrules 2>/dev/null

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,27 +1,42 @@
 {
-  "version": "1.2.21",
-  "generated": "2026-06-06",
+  "version": "1.5.0",
+  "generated": "2026-06-11",
   "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/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/add-pipeline.md": "ed4e666b38542d959287116ff6f25e8f51b10c2f18d1fc54974a996fdaf9d8f7",
+    "commands/add-task.md": "1782818b31d602194a2bbab12dda00e3b5a947dd5410ca9078777e79df1ad3ee",
+    "commands/approve.md": "063ae5a1c59f111986b63bad40efd6ff51a4ab547be6fe70662300ae214bc49c",
+    "commands/ask.md": "9b53c7636533811d689cfc27e5eeb847c92f8f740434657c61db090a53a4e21f",
+    "commands/check-agent.md": "1f52d57f9a6769c3e9df43bd84df9fb6ca71a0c6be1b14667b3648c81e05998f",
+    "commands/collate.md": "ad65229bcc969040b884d86f44c8ee86e9a7b2026e9367fd036d68935416c425",
+    "commands/commit.md": "2400be358e5701c68b248f314eb7b4ffac6434968e98b51e36acdad86c0e1f27",
+    "commands/config.md": "e9af723a2cf782d167d75aa29cbbec71e937507b9d7576ad254a5a35acae9df0",
+    "commands/enhance.md": "59f442096651b3c3118d162a9c1c3abbd9a4f094e9983afb0ee8467689a574e3",
+    "commands/fix-bug.md": "d38e6de69a7dd840271155de861fd79feb83bc1ac59409d3df5b93ebc97cab3d",
+    "commands/health.md": "d92d81ab8614608c383a01f4788fa9aa17a9b07c0d62caebad264a6459b45d58",
+    "commands/implement.md": "cdec3d802b86634fbfde48a8d08b18d84db4df41cdc7142ee85dacd3df19ace0",
+    "commands/init.md": "37fa5ada63b9428bd8356d34c6ece7781338dc74840007be3ddf053e3eb7205c",
+    "commands/new-sprint.md": "be6a9c059937e2d13dc68f07f9183c51cbd06fd6ab092e41b538692ee9de37ce",
+    "commands/plan-sprint.md": "bfde817baf6f51cd27626abef2553d3d0de9968bc67905c9a939386bd27221e8",
+    "commands/plan.md": "8f882d644345bed7d115e46a11e2a83fd1d5d7a39df23fdca2851b04f2e5cce5",
+    "commands/rebuild.md": "be7cc69c79883d3caae52b1ce8904404ac6d622b84fc17a278f3fd697230842f",
+    "commands/remove.md": "3044c58c699047e94bea4bb26bbe0e8d81425cba1ef2afc7243968e2ee8ab483",
+    "commands/repair.md": "90dd34c87768aef50a46224a21280047ed2376ca59785ecf6403cae3177dfc2f",
+    "commands/report-bug.md": "ae4eb28b54d171de20e89250daadc2a0859887f1d59845a895bd9543b0c1db6f",
+    "commands/reset.md": "b8a97d31c7f8bde5b92d34d1ac42e8795c789e40b58552dbe72db707d60aeb44",
+    "commands/retro.md": "9490a1f71bb0bfaa3d01c3be21935f33aacc3994ee1ee81be316a5dcd570695a",
+    "commands/review-code.md": "f2e95a764728b39d63d6b7fc9b3b23ca1eae597898204ab94b5b5f8224ff40bc",
+    "commands/review-plan.md": "47d3d99a25e7801bfb53816b3e31fd37e87793cabd6b4ac3451fd54914f32d23",
+    "commands/run-sprint.md": "0c7b94bae8d4f6e9ed0eb512cefaa73ba740f19f17077847f3b103a723eab0d6",
+    "commands/run-task.md": "c0c7fad6aac6b59345c256f4a19cdf28a3a1a9fe23fae329ae8fd44b72c5405a",
     "commands/search.md": "befc4ba9f3146e7599308b35b95ec315e16895c0c18c9c2bab7549619d79bf1c",
-    "commands/status.md": "2fa82a0b11d493918781aec6d95c39411f84fa923662ff3152b6de0cc830d755",
-    "commands/update.md": "c8b69b43567fa5fc328bb3dde31f386d0f577bbcc65dafd525400ae2fb16b132",
+    "commands/status.md": "d1f5e9295b472553fafcd270e34be00560beadfb18b98d4b696845fb794102eb",
+    "commands/update.md": "00cf09b7fa6e84b7bd137a543a11e52c3dbfe3dfe463982dbd6224435ba52345",
+    "commands/validate.md": "8d585adf0694b252f35650282d1a83068d5edb82269176e245ad9299711b1448",
     "agents/store-query-validator.md": "f4c3573edcf6e28809515705362df611806a805c5269404fb17e31433cf3a81c",
     "agents/tomoshibi.md": "0c1032df80dfc25a4f482b1276965b5318754d95ccde9f24820846d564e49a27",
     "hooks/check-update.cjs": "9607cc0c51bedcbc123f5ea1d7a492916f29ee1f838846eec64776d5df70bbea",
-    "hooks/forge-permissions.cjs": "8de18fe7e6c9ee1751926275a37f4bb68a5a53090d366d2aa44157c106e7857e",
+    "hooks/forge-permissions.cjs": "f61969192c2859e73317453cbed6a5cb2613e78525a4a411db1f29b96fbb0e5e",
     "hooks/post-init.cjs": "b05d65e7192d126733995989998a0b480604e0cc152887e6d7d0807fba3cf70d",
     "hooks/post-sprint.cjs": "28ddbd2c49d8b746c35d23a90b02362bc684d188159536a971b2d650bb85f3a9",
     "hooks/preflight-session.cjs": "7b1ad8f12f2a1bb94650e2b632da0ed21862071bf63f4e6452c88007be630fae",
@@ -30,7 +45,7 @@
     "schemas/transitions/bug.json": "27b17da42d1cebffbd4f61ab3dcd432a0017aa71997d548ed80d22c2fc3fad6a",
     "schemas/transitions/sprint.json": "2e0a629396e687b0ca88e1814ac3e35d84533a5d55b25237ab67feddce3c9deb",
     "schemas/transitions/task.json": "4c71849747baa0d585756e57c56325ff6219c078178374e60815dff91e25e3e7",
-    "schemas/enum-catalog.json": "68260bed8e6fe347bc4a1c870fa1ea51ca1ebc45873aae929624837afe8f0bdb",
+    "schemas/enum-catalog.json": "98da96c6495497f2a91edac3a4d66e178ab8cfd6835a5fc9255badca6517c440",
     "tools/verify-integrity.cjs": "3ec3c970dd3d7c3001f8f373bcc40556803eadd2fc2afafb14f1c232cba4cc3f"
   }
 }

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-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/payload-manifest.json

@@ -0,0 +1,314 @@
+{
+  "$schema": "./schemas/payload-manifest.schema.json",
+  "_doc": "Declarative inventory of the default (non --include-full) Forge payload. Each entry maps a source path under forge/forge/ to its bundle path (dist/forge-payload/), install destination (bootstrapped project root), and removal owner (uninstall grouping). Authored in FORGE-S32-T02 from build-payload.cjs Pass-2, bootstrap.ts Steps 2-5, and uninstall.ts. FORGE-S32-T03 wires the three consumers to read this file. The owner enum and select shape are provisional pending T03. --include-full superset entries are intentionally out of scope.",
+  "entries": [
+    {
+      "source": "tools",
+      "kind": "dir",
+      "bundle": "tools/",
+      "install": ".forge/tools/",
+      "owner": "forge-scaffold",
+      "select": {
+        "recursive": false,
+        "ext": [".cjs", ".js"],
+        "include": [
+          "substitute-placeholders.cjs",
+          "build-init-context.cjs",
+          "build-overlay.cjs",
+          "manage-versions.cjs",
+          "generation-manifest.cjs",
+          "build-persona-pack.cjs",
+          "build-context-pack.cjs",
+          "seed-store.cjs",
+          "manage-config.cjs",
+          "banners.cjs",
+          "validate-store.cjs",
+          "collate.cjs",
+          "store-cli.cjs",
+          "store.cjs",
+          "store-query.cjs",
+          "preflight-gate.cjs",
+          "postflight-gate.cjs",
+          "read-verdict.cjs",
+          "parse-gates.cjs",
+          "friction-emit.cjs",
+          "backfill-provider.cjs",
+          "check-structure.cjs",
+          "list-skills.js",
+          "verify-integrity.cjs",
+          "queue-drain.cjs",
+          "compression-gate.cjs",
+          "judge-proposal.cjs",
+          "delete-candidate-detector.cjs",
+          "replay-scoring.cjs",
+          "artifact.cjs",
+          "artifact-store.cjs",
+          "verify-apply.cjs",
+          "verify-phase.cjs",
+          "commit-task.cjs",
+          "query-logger.cjs",
+          "forge-preflight.cjs",
+          "reset-plan.cjs"
+        ]
+      },
+      "note": "Curated TOOLS_TO_COPY allowlist (build-payload Pass-2 2a). Forward-checked only — an unlisted tool is a deliberate minimal-payload exclusion, not drift. New runtime-required tools MUST be added here (FORGE-BUG-030/036 MODULE_NOT_FOUND class)."
+    },
+    {
+      "source": "tools/package.json",
+      "kind": "file",
+      "bundle": "tools/package.json",
+      "install": ".forge/tools/",
+      "owner": "forge-scaffold",
+      "synthesized": true,
+      "note": "FORGE-BUG-030: build-payload.cjs WRITES this {\"type\":\"commonjs\"} scope marker (no source file on disk) so bundled lib/*.js resolve as CommonJS inside \"type\":\"module\" host projects."
+    },
+    {
+      "source": "tools/lib",
+      "kind": "dir",
+      "bundle": "tools/lib/",
+      "install": ".forge/tools/lib/",
+      "owner": "forge-scaffold",
+      "select": {
+        "recursive": false,
+        "ext": [".cjs", ".js"],
+        "include": [
+          "artifact-kinds.cjs",
+          "forge-root.cjs",
+          "frontmatter.cjs",
+          "fsutil.cjs",
+          "json-io.cjs",
+          "paths.cjs",
+          "pricing.cjs",
+          "project-root.cjs",
+          "result.js",
+          "schema-loader.cjs",
+          "slug.cjs",
+          "suggest.cjs",
+          "validate.js",
+          "store-facade.cjs",
+          "store-nlp.cjs",
+          "store-query-exec.cjs"
+        ]
+      },
+      "note": "Curated LIB_ALLOWLIST (build-payload Pass-2 2a). Excludes *.test.cjs. Forward-checked only."
+    },
+    {
+      "source": "hooks",
+      "kind": "dir",
+      "bundle": "hooks/",
+      "install": ".forge/tools/hooks/",
+      "owner": "forge-scaffold",
+      "select": {
+        "recursive": false,
+        "ext": [".cjs"],
+        "exclude": ["hooks.json", "README.md"]
+      },
+      "note": "Top-level *.cjs hooks (build-payload Pass-2 2e4). hooks.json and README.md are intentionally not bundled. Installed under .forge/tools/hooks/ and wired into .claude/settings.json."
+    },
+    {
+      "source": "hooks/lib",
+      "kind": "dir",
+      "bundle": "hooks/lib/",
+      "install": ".forge/tools/hooks/lib/",
+      "owner": "forge-scaffold",
+      "select": {
+        "recursive": false,
+        "ext": [".cjs", ".js"]
+      },
+      "note": "Hook runtime deps (common.cjs, write-registry.js, ...) — required or every PostToolUse hook fails with MODULE_NOT_FOUND."
+    },
+    {
+      "source": "schemas",
+      "kind": "dir",
+      "bundle": ".schemas/",
+      "install": ".forge/schemas/",
+      "owner": "forge-scaffold",
+      "select": {
+        "recursive": true,
+        "ext": [".schema.json"],
+        "exclude": ["__tests__"]
+      },
+      "note": "Recursive *.schema.json incl. _defs/ (build-payload Pass-2 2e). Bundled to BOTH .schemas/ (forge-cli tool resolution) and the non-dot schemas/ mirror (command prose $FORGE_ROOT/schemas/). The dual bundle is INTENTIONAL and load-bearing (FORGE-S32-T05 reconciliation): health.md:58 + update.md:674 read $FORGE_ROOT/schemas/ with NO .schemas/ fallback, and $FORGE_ROOT resolves to the bundle in plugin mode but the installed non-dot .forge/schemas/ in fallback mode — so neither dir can be dropped without breaking /forge:health or /forge:update. Installed (incl. _defs/) to non-dot .forge/schemas/."
+    },
+    {
+      "source": "schemas/enum-catalog.json",
+      "kind": "file",
+      "bundle": ".schemas/enum-catalog.json",
+      "install": ".forge/schemas/",
+      "owner": "forge-scaffold",
+      "note": "Non-schema JSON consumed by catalog-loader.ts / transition-guard.ts (build-payload Pass-2 2e1b)."
+    },
+    {
+      "source": "schemas/structure-manifest.json",
+      "kind": "file",
+      "bundle": "schemas/structure-manifest.json",
+      "install": ".forge/schemas/",
+      "owner": "forge-scaffold",
+      "note": "Read by check-structure.cjs (__dirname/../schemas/structure-manifest.json) — resolved via /forge:health step 8 with NO --forge-root, against installed projects. Bundled via the non-dot schemas/ all-JSON mirror; load-bearing and retained deliberately (FORGE-S32-T05 reconciliation, audit verdict refuted)."
+    },
+    {
+      "source": "schemas/transitions",
+      "kind": "dir",
+      "bundle": ".schemas/transitions/",
+      "bundleOnly": true,
+      "owner": "forge-scaffold",
+      "select": {
+        "recursive": false,
+        "ext": [".json"]
+      },
+      "note": "FSM transition tables (build-payload Pass-2 2e1b). Bundle-only: shipped to dist/forge-payload/.schemas/transitions/ for transition-guard.ts resolution, NOT installed into .forge/schemas/ (the historical install tree never vendored transitions/). FORGE-BUG-044."
+    },
+    {
+      "source": "migrations.json",
+      "kind": "file",
+      "bundle": ".schemas/migrations.json",
+      "bundleOnly": true,
+      "owner": "forge-scaffold",
+      "note": "Payload-root migrations.json copied into .schemas/ for migration-engine.ts (build-payload Pass-2 2e1). Bundle-only: shipped to dist/forge-payload/.schemas/ for migration-engine resolution, NOT installed into .forge/schemas/. FORGE-BUG-044."
+    },
+    {
+      "source": "commands",
+      "kind": "dir",
+      "bundle": "commands/",
+      "install": ".claude/commands/forge/",
+      "owner": "claude-commands",
+      "select": {
+        "recursive": false,
+        "ext": [".md"]
+      },
+      "note": "Unified Forge slash-command tree (build-payload Pass-2 2e2). Single source of truth for ALL /forge:* commands — the 13 plugin-utility commands plus the materialized base-pack sprint-workflow shims and the three former-collision winners (init, check-agent, enhance). Installed verbatim to .claude/commands/forge/; delegateMarkdownCommand reads <forgeRoot>/commands/<name>.md. The former second tree (init/base-pack/commands/) was collapsed into this one in FORGE-S32-T06 — no more union/collision ordering."
+    },
+    {
+      "source": "init/base-pack",
+      "kind": "dir",
+      "bundle": ".base-pack/",
+      "install": ".forge/.base-pack/",
+      "owner": "forge-scaffold",
+      "select": {
+        "recursive": true
+      },
+      "note": "Recursive base-pack tree (build-payload Pass-2 2d). Vendored wholesale to .forge/.base-pack/; the workflows-js subset is re-installed by the entry below. The commands/ subtree was collapsed into the unified commands/ entry above in FORGE-S32-T06 — base-pack no longer carries a commands/ subdir."
+    },
+    {
+      "source": "init/base-pack/workflows-js",
+      "kind": "dir",
+      "bundle": ".base-pack/workflows-js/",
+      "install": ".claude/workflows/",
+      "owner": "workflows",
+      "select": {
+        "recursive": false,
+        "ext": [".js"],
+        "prefix": ["wfl-"]
+      },
+      "note": "wfl-*.js workflow drivers installed to .claude/workflows/ (bootstrap Step 5)."
+    },
+    {
+      "source": "init/phases",
+      "kind": "dir",
+      "bundle": "init/phases/",
+      "install": ".forge/init/phases/",
+      "owner": "forge-scaffold",
+      "select": {
+        "recursive": false,
+        "ext": [".md"]
+      },
+      "note": "Init rulebook phase prompts read by run-phases.ts / wfl-init.js (build-payload Pass-2 2e-pre)."
+    },
+    {
+      "source": "init/discovery",
+      "kind": "dir",
+      "bundle": "init/discovery/",
+      "install": ".forge/init/discovery/",
+      "owner": "forge-scaffold",
+      "select": {
+        "recursive": false,
+        "ext": [".md"]
+      },
+      "note": "Per-domain discovery prompts (build-payload Pass-2 2e-pre). The curated .init/discovery/discover-*.md bundle subset is a separate build-payload target; install uses the full set."
+    },
+    {
+      "source": "init/generation",
+      "kind": "dir",
+      "bundle": "init/generation/",
+      "install": ".forge/init/generation/",
+      "owner": "forge-scaffold",
+      "select": {
+        "recursive": false,
+        "ext": [".md"],
+        "include": [
+          "generate-commands.md",
+          "generate-kb-doc.md",
+          "generate-persona.md",
+          "generate-skill.md",
+          "generate-template.md",
+          "generate-tools.md",
+          "generate-workflows.md"
+        ]
+      },
+      "note": "Generation prompts (build-payload Pass-2 2e-pre). Curated to the per-subagent rulebooks actually cited at runtime (rebuild.md, phase-2-discover.md, phase-4-register.md, build-manifest.cjs, vendored-tools-closure/command-wfl-conformance tests). FORGE-S32-T05 removed the four superseded orchestrator placeholders (generate-knowledge-base/personas/skills/templates.md) — each had zero live runtime citation (only historical vision/ docs + migration notes). The curated .init/generation/generate-kb-doc.md bundle subset is a separate target."
+    },
+    {
+      "source": "init/workflow-gen-plan.json",
+      "kind": "file",
+      "bundle": "init/workflow-gen-plan.json",
+      "install": ".forge/init/",
+      "owner": "forge-scaffold",
+      "note": "Referenced by vendored commands (rebuild.md reads .forge/init/workflow-gen-plan.json). INIT_ROOT_FILES (build-payload Pass-2 2e-pre)."
+    },
+    {
+      "source": "meta",
+      "kind": "dir",
+      "bundle": "meta/",
+      "install": ".forge/meta/",
+      "owner": "forge-scaffold",
+      "select": {
+        "recursive": true
+      },
+      "note": "Personas + skills source-of-truth, recursive (build-payload Pass-2 2a2). build-persona-pack.cjs hashes meta/ for the pack cache key (forge-cli#25 defect A)."
+    },
+    {
+      "source": ".claude-plugin/plugin.json",
+      "kind": "file",
+      "bundle": ".claude-plugin/plugin.json",
+      "install": ".forge/.claude-plugin/",
+      "owner": "forge-scaffold",
+      "note": "Plugin manifest / version source (build-payload Pass-2 2f)."
+    },
+    {
+      "source": "agents",
+      "kind": "dir",
+      "bundle": "agents/",
+      "install": ".claude/agents/",
+      "owner": "claude-assets",
+      "select": {
+        "recursive": false,
+        "ext": [".md"]
+      },
+      "note": "Plugin Claude Code subagents (tomoshibi, store-query-validator). Tracked by integrity.json (build-payload Pass-2 2e3)."
+    },
+    {
+      "source": "skills",
+      "kind": "dir",
+      "bundle": "skills/",
+      "install": ".claude/skills/",
+      "owner": "claude-assets",
+      "select": {
+        "include": [
+          "store-custodian",
+          "store-query-grammar",
+          "store-query-nlp",
+          "refresh-kb-links"
+        ]
+      },
+      "note": "Curated SKILLS_TO_COPY (build-payload Pass-2 2i). Each entry is a skill directory (SKILL.md). Forward-checked only."
+    },
+    {
+      "source": "integrity.json",
+      "kind": "file",
+      "bundle": "integrity.json",
+      "bundleOnly": true,
+      "owner": "forge-scaffold",
+      "note": "Plugin-tampering manifest resolved at forge-root by verify-integrity.cjs (build-payload Pass-2 2e0b). Bundle-only: shipped to dist/forge-payload/integrity.json for verify-integrity.cjs resolution, NOT installed into a bootstrapped project's .forge/ (the historical install tree never vendored integrity.json — bootstrap only hashes it). FORGE-BUG-045."
+    }
+  ]
+}

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

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