@entelligentsia/forgecli 0.15.0 → 0.20.0

package/dist/extensions/forgecli/lib/catalog-loader.js

@@ -0,0 +1,176 @@
+// lib/catalog-loader.ts — FORGE-S25-T27
+//
+// Runtime loader for the enum catalog and FSM transition tables bundled in the
+// forge-cli payload (dist/forge-payload/.schemas/enum-catalog.json and
+// dist/forge-payload/.schemas/transitions/{task,sprint,bug}.json).
+//
+// Generated by forge/tools/build-enum-catalog.cjs (FORGE-S25-T26) and bundled
+// by scripts/build-payload.cjs step 2e1b (FORGE-S25-T27).
+//
+// Design constraints (IL1, forge-cli-engineer Iron Laws):
+//   - No import from forge-init.ts or any top-level handler file (lib → handler
+//     is a prohibited dep direction; forge-init.ts imports lib/exec-helpers.ts).
+//   - Payload root resolved via import.meta.url (same pattern as forge-init.ts
+//     _PKG_ROOT). Tests may supply an explicit bundleRoot to the parametric API.
+//   - Fail-loud at module init if the catalog is missing in production (a
+//     forge-cli distribution without the catalog is broken by definition).
+//
+// Iron Laws: IL1 (code only in forge-cli/), IL2 (TypeScript), IL6 (no shell).
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+// forge-cli package root — matches forge-init.ts::_PKG_ROOT calculation.
+// Compiled file lives at dist/extensions/forgecli/lib/catalog-loader.js.
+// _DIR  = dist/extensions/forgecli/lib/
+// ..    = dist/extensions/forgecli/
+// ../.. = dist/extensions/
+// ../../.. = dist/
+// ../../../.. = <pkg-root>/
+const _DIR = path.dirname(fileURLToPath(import.meta.url));
+const _DIST_DIR = path.resolve(_DIR, "..", "..", "..");
+const _PKG_ROOT = path.resolve(_DIST_DIR, "..");
+/**
+ * Resolve the bundled payload root from the package root.
+ * Exported for test access (tests may override with a fixture path instead).
+ */
+export function resolveBundledPayloadRoot() {
+    return path.join(_PKG_ROOT, "dist", "forge-payload");
+}
+// ── Parametric loaders (testable — caller supplies bundleRoot) ────────────────
+/**
+ * Load enum-catalog.json from the supplied bundleRoot.
+ * Throws with a descriptive message if the file is missing or malformed.
+ *
+ * @param bundleRoot - absolute path to dist/forge-payload/
+ */
+export function loadEnumCatalog(bundleRoot) {
+    const catalogPath = path.join(bundleRoot, ".schemas", "enum-catalog.json");
+    if (!fs.existsSync(catalogPath)) {
+        throw new Error(`[catalog-loader] enum-catalog.json not found at ${catalogPath}. ` +
+            "Run 'npm run build' to regenerate the payload bundle.");
+    }
+    try {
+        return JSON.parse(fs.readFileSync(catalogPath, "utf8"));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`[catalog-loader] failed to parse enum-catalog.json: ${msg}`);
+    }
+}
+/**
+ * Convert a transition-record array to a Set-based lookup map.
+ * @internal
+ */
+function recordsToSetMap(records) {
+    const map = {};
+    for (const rec of records) {
+        map[rec.from] = new Set(rec.to);
+    }
+    return map;
+}
+/**
+ * Load a single entity's transition table from the bundled payload.
+ * @internal
+ */
+function loadEntityTransitions(bundleRoot, entity) {
+    const filePath = path.join(bundleRoot, ".schemas", "transitions", `${entity}.json`);
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`[catalog-loader] transitions/${entity}.json not found at ${filePath}. ` +
+            "Run 'npm run build' to regenerate the payload bundle.");
+    }
+    try {
+        const records = JSON.parse(fs.readFileSync(filePath, "utf8"));
+        return recordsToSetMap(records);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        throw new Error(`[catalog-loader] failed to parse transitions/${entity}.json: ${msg}`);
+    }
+}
+/**
+ * Load all three entity transition tables from the bundled payload.
+ * Throws if any file is missing or malformed.
+ *
+ * @param bundleRoot - absolute path to dist/forge-payload/
+ */
+export function loadTransitions(bundleRoot) {
+    return {
+        task: loadEntityTransitions(bundleRoot, "task"),
+        sprint: loadEntityTransitions(bundleRoot, "sprint"),
+        bug: loadEntityTransitions(bundleRoot, "bug"),
+    };
+}
+// ── Module-level constants (lazy-loaded on first access) ─────────────────────
+//
+// Initialized on first read (not at module import time). This defers the IO to
+// the first actual use of the transition tables, which avoids failures during
+// vitest module loading in test environments where the build artifact path may
+// not be present or may resolve differently before tests run.
+//
+// In production, these are read on the first hook-dispatcher invocation or
+// first transition-guard check — acceptable latency for a one-time cold-read.
+//
+// Fail-loud: a missing catalog throws a descriptive error at first use (not silently
+// wrong). A forge-cli distribution without the catalog is broken by definition.
+let _cachedTransitions = null;
+function getCachedTransitions() {
+    if (_cachedTransitions === null) {
+        _cachedTransitions = loadTransitions(resolveBundledPayloadRoot());
+    }
+    return _cachedTransitions;
+}
+/** Task status FSM as Set-based lookup (T25 ADR-canonical). Source: enum-catalog. Lazy-loaded. */
+export const TASK_TRANSITIONS = new Proxy({}, {
+    get(_target, prop) {
+        return getCachedTransitions().task[prop];
+    },
+    has(_target, prop) {
+        return prop in getCachedTransitions().task;
+    },
+    ownKeys(_target) {
+        return Object.keys(getCachedTransitions().task);
+    },
+    getOwnPropertyDescriptor(_target, prop) {
+        const val = getCachedTransitions().task[prop];
+        if (val === undefined)
+            return undefined;
+        return { value: val, writable: false, enumerable: true, configurable: true };
+    },
+});
+/** Sprint status FSM as Set-based lookup (T25 ADR-canonical). Source: enum-catalog. Lazy-loaded. */
+export const SPRINT_TRANSITIONS = new Proxy({}, {
+    get(_target, prop) {
+        return getCachedTransitions().sprint[prop];
+    },
+    has(_target, prop) {
+        return prop in getCachedTransitions().sprint;
+    },
+    ownKeys(_target) {
+        return Object.keys(getCachedTransitions().sprint);
+    },
+    getOwnPropertyDescriptor(_target, prop) {
+        const val = getCachedTransitions().sprint[prop];
+        if (val === undefined)
+            return undefined;
+        return { value: val, writable: false, enumerable: true, configurable: true };
+    },
+});
+/** Bug status FSM as Set-based lookup (T25 ADR-canonical). Source: enum-catalog. Lazy-loaded. */
+export const BUG_TRANSITIONS = new Proxy({}, {
+    get(_target, prop) {
+        return getCachedTransitions().bug[prop];
+    },
+    has(_target, prop) {
+        return prop in getCachedTransitions().bug;
+    },
+    ownKeys(_target) {
+        return Object.keys(getCachedTransitions().bug);
+    },
+    getOwnPropertyDescriptor(_target, prop) {
+        const val = getCachedTransitions().bug[prop];
+        if (val === undefined)
+            return undefined;
+        return { value: val, writable: false, enumerable: true, configurable: true };
+    },
+});
+//# sourceMappingURL=catalog-loader.js.map

package/dist/extensions/forgecli/lib/catalog-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-loader.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/lib/catalog-loader.ts"],"names":[],"mappings":"AAAA,wCAAwC;AACxC,EAAE;AACF,+EAA+E;AAC/E,uEAAuE;AACvE,mEAAmE;AACnE,EAAE;AACF,8EAA8E;AAC9E,0DAA0D;AAC1D,EAAE;AACF,0DAA0D;AAC1D,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,iFAAiF;AACjF,0EAA0E;AAC1E,2EAA2E;AAC3E,EAAE;AACF,8EAA8E;AAE9E,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,yEAAyE;AACzE,yEAAyE;AACzE,wCAAwC;AACxC,oCAAoC;AACpC,2BAA2B;AAC3B,mBAAmB;AACnB,4BAA4B;AAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACvD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACxC,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,CAAC,CAAC;AACtD,CAAC;AA4BD,iFAAiF;AAEjF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IACjD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,mBAAmB,CAAC,CAAC;IAC3E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACd,mDAAmD,WAAW,IAAI;YACjE,uDAAuD,CACxD,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAgB,CAAC;IACxE,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,uDAAuD,GAAG,EAAE,CAAC,CAAC;IAC/E,CAAC;AACF,CAAC;AAED;;;GAGG;AACH,SAAS,eAAe,CAAC,OAA2B;IACnD,MAAM,GAAG,GAAgC,EAAE,CAAC;IAC5C,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC3B,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;GAGG;AACH,SAAS,qBAAqB,CAAC,UAAkB,EAAE,MAAiC;IACnF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IACpF,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CACd,gCAAgC,MAAM,sBAAsB,QAAQ,IAAI;YACvE,uDAAuD,CACxD,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAuB,CAAC;QACpF,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,gDAAgD,MAAM,UAAU,GAAG,EAAE,CAAC,CAAC;IACxF,CAAC;AACF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,UAAkB;IACjD,OAAO;QACN,IAAI,EAAE,qBAAqB,CAAC,UAAU,EAAE,MAAM,CAAC;QAC/C,MAAM,EAAE,qBAAqB,CAAC,UAAU,EAAE,QAAQ,CAAC;QACnD,GAAG,EAAE,qBAAqB,CAAC,UAAU,EAAE,KAAK,CAAC;KAC7C,CAAC;AACH,CAAC;AAED,gFAAgF;AAChF,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,+EAA+E;AAC/E,8DAA8D;AAC9D,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,EAAE;AACF,qFAAqF;AACrF,gFAAgF;AAEhF,IAAI,kBAAkB,GAA0B,IAAI,CAAC;AAErD,SAAS,oBAAoB;IAC5B,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACjC,kBAAkB,GAAG,eAAe,CAAC,yBAAyB,EAAE,CAAC,CAAC;IACnE,CAAC;IACD,OAAO,kBAAkB,CAAC;AAC3B,CAAC;AAED,kGAAkG;AAClG,MAAM,CAAC,MAAM,gBAAgB,GAAgC,IAAI,KAAK,CAAC,EAAiC,EAAE;IACzG,GAAG,CAAC,OAAO,EAAE,IAAY;QACxB,OAAO,oBAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IACD,GAAG,CAAC,OAAO,EAAE,IAAY;QACxB,OAAO,IAAI,IAAI,oBAAoB,EAAE,CAAC,IAAI,CAAC;IAC5C,CAAC;IACD,OAAO,CAAC,OAAO;QACd,OAAO,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,IAAI,CAAC,CAAC;IACjD,CAAC;IACD,wBAAwB,CAAC,OAAO,EAAE,IAAY;QAC7C,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC9E,CAAC;CACD,CAAC,CAAC;AAEH,oGAAoG;AACpG,MAAM,CAAC,MAAM,kBAAkB,GAAgC,IAAI,KAAK,CAAC,EAAiC,EAAE;IAC3G,GAAG,CAAC,OAAO,EAAE,IAAY;QACxB,OAAO,oBAAoB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IACD,GAAG,CAAC,OAAO,EAAE,IAAY;QACxB,OAAO,IAAI,IAAI,oBAAoB,EAAE,CAAC,MAAM,CAAC;IAC9C,CAAC;IACD,OAAO,CAAC,OAAO;QACd,OAAO,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,MAAM,CAAC,CAAC;IACnD,CAAC;IACD,wBAAwB,CAAC,OAAO,EAAE,IAAY;QAC7C,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC9E,CAAC;CACD,CAAC,CAAC;AAEH,iGAAiG;AACjG,MAAM,CAAC,MAAM,eAAe,GAAgC,IAAI,KAAK,CAAC,EAAiC,EAAE;IACxG,GAAG,CAAC,OAAO,EAAE,IAAY;QACxB,OAAO,oBAAoB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzC,CAAC;IACD,GAAG,CAAC,OAAO,EAAE,IAAY;QACxB,OAAO,IAAI,IAAI,oBAAoB,EAAE,CAAC,GAAG,CAAC;IAC3C,CAAC;IACD,OAAO,CAAC,OAAO;QACd,OAAO,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE,CAAC,GAAG,CAAC,CAAC;IAChD,CAAC;IACD,wBAAwB,CAAC,OAAO,EAAE,IAAY;QAC7C,MAAM,GAAG,GAAG,oBAAoB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACxC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC9E,CAAC;CACD,CAAC,CAAC"}

package/dist/extensions/forgecli/lib/catalog-types.d.ts

@@ -0,0 +1,16 @@
+export declare const TASK_STATUS_VALUES: ["draft", "planned", "plan-approved", "implementing", "implemented", "review-approved", "approved", "committed", "plan-revision-required", "code-revision-required", "blocked", "escalated", "abandoned"];
+export type TaskStatus = (typeof TASK_STATUS_VALUES)[number];
+export declare const SPRINT_STATUS_VALUES: ["planning", "active", "completed", "retrospective-done", "blocked", "partially-completed", "abandoned"];
+export type SprintStatus = (typeof SPRINT_STATUS_VALUES)[number];
+export declare const BUG_STATUS_VALUES: ["reported", "triaged", "in-progress", "fixed"];
+export type BugStatus = (typeof BUG_STATUS_VALUES)[number];
+export declare const COMMAND_NAME_VALUES: ["forge:sprint-intake", "forge:plan", "forge:review-plan", "forge:implement", "forge:review-code", "forge:fix-bug", "forge:sprint-plan", "forge:run-task", "forge:run-sprint", "forge:collate", "forge:retrospective", "forge:approve", "forge:commit", "forge:enhance", "forge:quiz-agent", "forge:validate", "forge:init", "forge:health", "forge:regenerate", "forge:update", "forge:add-task", "forge:add-pipeline", "forge:calibrate", "forge:materialize", "forge:remove", "forge:report-bug", "forge:store-query", "forge:store-repair", "forge:config", "forge:ask", "forge:store-custodian", "forge:refresh-kb-links"];
+export type CommandName = (typeof COMMAND_NAME_VALUES)[number];
+export declare const SYNTHETIC_EVENT_TYPES: ["init-complete", "sprint-collate-complete", "migration-applied"];
+export type SyntheticEventType = (typeof SYNTHETIC_EVENT_TYPES)[number];
+export declare const FRICTION_SUBKINDS: ["skill_unused", "skill_failed", "skill_missing", "skill_stale", "skill_redundant"];
+export type FrictionSubkind = (typeof FRICTION_SUBKINDS)[number];
+export declare const ROLE_KINDS: ["plan", "implement", "update-plan", "update-impl", "commit", "review-plan", "review-code", "validate", "approve", "writeback", "orchestrator"];
+export type RoleKind = (typeof ROLE_KINDS)[number];
+export declare const ACTION_KINDS: ["start", "complete", "plan", "implement", "review", "approve", "commit", "escalated", "gate_failed", "friction_drain", "task_skipped", "subagent_retry", "subagent_escalated", "verdict_malformed"];
+export type ActionKind = (typeof ACTION_KINDS)[number];

package/dist/extensions/forgecli/lib/catalog-types.js

@@ -0,0 +1,156 @@
+// lib/catalog-types.ts — FORGE-S25-T27
+//
+// Authoritative compile-time TS const tuples for domain-specific union types
+// in forge-cli. Zero IO — no fs reads, no subprocess calls.
+//
+// Sources of truth for each const tuple:
+//   - TASK/SPRINT/BUG_STATUS_VALUES: forge/forge/schemas/{task,sprint,bug}.schema.json
+//     status enums (same source as build-enum-catalog.cjs in FORGE-S25-T26).
+//     Verified at runtime by catalog-loader.test.ts (every catalog key appears here).
+//   - SYNTHETIC_EVENT_TYPES: forge-cli internal (hook-dispatcher.ts event taxonomy).
+//   - FRICTION_SUBKINDS: forge/forge/schemas/event.schema.json subkind pattern values
+//     (pattern: ^(skill_unused|skill_failed|skill_missing|skill_stale|skill_redundant|x_[a-z_]+)$).
+//   - ROLE_KINDS: orchestrate_task.md ROLE_TO_NOUN mapping + orchestrator role.
+//   - ACTION_KINDS: event.schema.json action usage + orchestrate_task.md event emission.
+//
+// Design: single file for all compile-time domain constants. When a new state,
+// event type, or role is added, edit this file and the corresponding source of
+// truth (plugin schema or orchestrate_task.md). Regression tests verify alignment.
+//
+// Iron Laws: IL1 (code only in forge-cli/), IL2 (TypeScript + no new deps), IL7 (no silent failures).
+// ── Task status ───────────────────────────────────────────────────────────────
+//
+// Source: forge/forge/schemas/task.schema.json properties.status.enum
+// Last verified: FORGE-S25-T26 (enum-catalog.json generated from this enum)
+export const TASK_STATUS_VALUES = [
+    "draft",
+    "planned",
+    "plan-approved",
+    "implementing",
+    "implemented",
+    "review-approved",
+    "approved",
+    "committed",
+    "plan-revision-required",
+    "code-revision-required",
+    "blocked",
+    "escalated",
+    "abandoned",
+];
+// ── Sprint status ─────────────────────────────────────────────────────────────
+//
+// Source: forge/forge/schemas/sprint.schema.json properties.status.enum
+export const SPRINT_STATUS_VALUES = [
+    "planning",
+    "active",
+    "completed",
+    "retrospective-done",
+    "blocked",
+    "partially-completed",
+    "abandoned",
+];
+// ── Bug status ────────────────────────────────────────────────────────────────
+//
+// Source: forge/forge/schemas/bug.schema.json properties.status.enum
+export const BUG_STATUS_VALUES = ["reported", "triaged", "in-progress", "fixed"];
+// ── Command name ──────────────────────────────────────────────────────────────
+//
+// Source: forge/forge/tools/build-enum-catalog.cjs COMMAND_NAMES
+// (subset of forge:* slash commands registered in the plugin)
+export const COMMAND_NAME_VALUES = [
+    "forge:sprint-intake",
+    "forge:plan",
+    "forge:review-plan",
+    "forge:implement",
+    "forge:review-code",
+    "forge:fix-bug",
+    "forge:sprint-plan",
+    "forge:run-task",
+    "forge:run-sprint",
+    "forge:collate",
+    "forge:retrospective",
+    "forge:approve",
+    "forge:commit",
+    "forge:enhance",
+    "forge:quiz-agent",
+    "forge:validate",
+    "forge:init",
+    "forge:health",
+    "forge:regenerate",
+    "forge:update",
+    "forge:add-task",
+    "forge:add-pipeline",
+    "forge:calibrate",
+    "forge:materialize",
+    "forge:remove",
+    "forge:report-bug",
+    "forge:store-query",
+    "forge:store-repair",
+    "forge:config",
+    "forge:ask",
+    "forge:store-custodian",
+    "forge:refresh-kb-links",
+];
+// ── Synthetic event type (forge-cli domain) ───────────────────────────────────
+//
+// Source: forge-cli hook-dispatcher.ts synthetic event taxonomy.
+// Discriminants of the SyntheticEvent union (InitCompleteEvent, etc.).
+// Verified by hook-dispatcher.test.ts.
+export const SYNTHETIC_EVENT_TYPES = [
+    "init-complete",
+    "sprint-collate-complete",
+    "migration-applied",
+];
+// ── Friction subkind ──────────────────────────────────────────────────────────
+//
+// Source: forge/forge/schemas/event.schema.json subkind pattern:
+//   ^(skill_unused|skill_failed|skill_missing|skill_stale|skill_redundant|x_[a-z_]+)$
+// The x_ prefix is for experimental subkinds (not listed here as compile-time values;
+// they are validated via the pattern at runtime by store-cli).
+// Verified by catalog-types.test.ts against the event schema regex.
+export const FRICTION_SUBKINDS = [
+    "skill_unused",
+    "skill_failed",
+    "skill_missing",
+    "skill_stale",
+    "skill_redundant",
+];
+// ── Role kind ─────────────────────────────────────────────────────────────────
+//
+// Source: forge/forge/.forge/workflows/orchestrate_task.md ROLE_TO_NOUN mapping
+// + orchestrator self-identification.
+// Used in: session-registry.ts (PhaseSummary.role), friction-emit.ts (FrictionEmitRuntime.role).
+export const ROLE_KINDS = [
+    "plan",
+    "implement",
+    "update-plan",
+    "update-impl",
+    "commit",
+    "review-plan",
+    "review-code",
+    "validate",
+    "approve",
+    "writeback",
+    "orchestrator",
+];
+// ── Action kind ───────────────────────────────────────────────────────────────
+//
+// Source: event.schema.json action field usage + orchestrate_task.md event emission.
+// Used in: friction-emit.ts (FrictionEmitRuntime.action), run-task.ts event emission.
+export const ACTION_KINDS = [
+    "start",
+    "complete",
+    "plan",
+    "implement",
+    "review",
+    "approve",
+    "commit",
+    "escalated",
+    "gate_failed",
+    "friction_drain",
+    "task_skipped",
+    "subagent_retry",
+    "subagent_escalated",
+    "verdict_malformed",
+];
+//# sourceMappingURL=catalog-types.js.map

package/dist/extensions/forgecli/lib/catalog-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-types.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/lib/catalog-types.ts"],"names":[],"mappings":"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"}

package/dist/extensions/forgecli/lib/exec-helpers.d.ts

@@ -0,0 +1,25 @@
+import { execFile } from "node:child_process";
+import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
+/**
+ * Promisified `execFile`. Use instead of declaring `promisify(execFile)`
+ * locally in every module.
+ *
+ * Note: `forge-update-command.ts` deliberately keeps its own injectable
+ * `runner` override for test isolation — do NOT migrate that module here.
+ */
+export declare const execFileAsync: typeof execFile.__promisify__;
+/** Convenience type alias for callers that need to annotate the signature. */
+export type ExecFileAsyncType = typeof execFileAsync;
+/**
+ * Invoke a Node.js tool by path and wait for it to complete.
+ * Throws a descriptive error (including tool basename) on non-zero exit.
+ */
+export declare function runTool(toolPath: string, argv: string[], cwd: string, timeout?: number): Promise<void>;
+/**
+ * Invoke a Node.js tool in advisory mode: on failure, notify via `ctx.ui.notify`
+ * and return `false` instead of throwing.
+ *
+ * Returns `true` on success, `false` on failure. Callers that need hard failure
+ * should use `runTool` directly.
+ */
+export declare function runToolAdvisory(toolPath: string, argv: string[], cwd: string, ctx: ExtensionCommandContext, label: string, timeout?: number): Promise<boolean>;

package/dist/extensions/forgecli/lib/exec-helpers.js

@@ -0,0 +1,52 @@
+// lib/exec-helpers.ts — shared tool invocation helpers (N-C-E, FORGE-S25-T23 B-4).
+//
+// Centralises the `promisify(execFile)` declaration that was independently
+// copy-pasted in forge-tools.ts:24 and store-resolver.ts:14, and the
+// `runTool`/`runToolAdvisory` pair extracted from forge-init.ts.
+import { execFile } from "node:child_process";
+import * as path from "node:path";
+import { promisify } from "node:util";
+/**
+ * Promisified `execFile`. Use instead of declaring `promisify(execFile)`
+ * locally in every module.
+ *
+ * Note: `forge-update-command.ts` deliberately keeps its own injectable
+ * `runner` override for test isolation — do NOT migrate that module here.
+ */
+export const execFileAsync = promisify(execFile);
+/**
+ * Invoke a Node.js tool by path and wait for it to complete.
+ * Throws a descriptive error (including tool basename) on non-zero exit.
+ */
+export async function runTool(toolPath, argv, cwd, timeout = 30000) {
+    try {
+        await execFileAsync("node", [toolPath, ...argv], {
+            cwd,
+            timeout,
+            encoding: "utf8",
+        });
+    }
+    catch (err) {
+        const e = err;
+        throw new Error(`Tool ${path.basename(toolPath)} failed: ${e.stderr?.trim() || e.message || "unknown error"}`);
+    }
+}
+/**
+ * Invoke a Node.js tool in advisory mode: on failure, notify via `ctx.ui.notify`
+ * and return `false` instead of throwing.
+ *
+ * Returns `true` on success, `false` on failure. Callers that need hard failure
+ * should use `runTool` directly.
+ */
+export async function runToolAdvisory(toolPath, argv, cwd, ctx, label, timeout = 30000) {
+    try {
+        await runTool(toolPath, argv, cwd, timeout);
+        return true;
+    }
+    catch (err) {
+        const e = err;
+        ctx.ui.notify(`△ ${label}: ${e.message ?? "failed"} — proceeding.`, "warning");
+        return false;
+    }
+}
+//# sourceMappingURL=exec-helpers.js.map

package/dist/extensions/forgecli/lib/exec-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-helpers.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/lib/exec-helpers.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,EAAE;AACF,2EAA2E;AAC3E,qEAAqE;AACrE,iEAAiE;AAEjE,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAKjD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,QAAgB,EAAE,IAAc,EAAE,GAAW,EAAE,OAAO,GAAG,KAAK;IAC3F,IAAI,CAAC;QACJ,MAAM,aAAa,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE;YAChD,GAAG;YACH,OAAO;YACP,QAAQ,EAAE,MAAM;SAChB,CAAC,CAAC;IACJ,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAA4C,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC,CAAC;IAChH,CAAC;AACF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,QAAgB,EAChB,IAAc,EACd,GAAW,EACX,GAA4B,EAC5B,KAAa,EACb,OAAO,GAAG,KAAK;IAEf,IAAI,CAAC;QACJ,MAAM,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAC5C,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACvB,MAAM,CAAC,GAAG,GAA2B,CAAC;QACtC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,OAAO,IAAI,QAAQ,gBAAgB,EAAE,SAAS,CAAC,CAAC;QAC/E,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC"}

package/dist/extensions/forgecli/lib/forge-config.d.ts

@@ -0,0 +1,20 @@
+import { type ForgeConfig } from "../forge-root.js";
+/**
+ * Memoized variant of `discoverForgeConfig`.
+ *
+ * On the first call for a given `cwd` the function walks the directory tree
+ * upward to locate `.forge/config.json`; subsequent calls for the same `cwd`
+ * return the cached result immediately.
+ *
+ * @param cwd - Working directory to start the search from.
+ *              Defaults to `process.cwd()` (same default as the underlying
+ *              `discoverForgeConfig`).
+ */
+export declare function discoverForgeConfigCached(cwd?: string): ForgeConfig | null;
+/**
+ * Clears all cached entries.
+ *
+ * Primarily for test isolation — call in `beforeEach`/`afterEach` to
+ * prevent cache bleed between test cases that change the filesystem.
+ */
+export declare function clearForgeConfigCache(): void;

package/dist/extensions/forgecli/lib/forge-config.js

@@ -0,0 +1,43 @@
+// lib/forge-config.ts — memoized Forge config accessor (C-3, S-13).
+//
+// Wraps discoverForgeConfig() with a per-cwd Map cache so repeated calls
+// during a single session don't re-walk the filesystem.
+//
+// CRITICAL INVARIANT: only `ForgeConfig | null` is cached. The `LayeredConfig`
+// produced by `loadLayeredConfig()` is NOT cached here — T20 must retain full
+// access to `LayeredConfig.errors` to surface the N-B-E issue. Callers that
+// need `LayeredConfig` must call `loadLayeredConfig()` directly; this module
+// optimises only the walk-up discovery phase.
+import { discoverForgeConfig } from "../forge-root.js";
+/** Module-level cache keyed by the `cwd` argument (or `""` for the default). */
+const cache = new Map();
+/**
+ * Memoized variant of `discoverForgeConfig`.
+ *
+ * On the first call for a given `cwd` the function walks the directory tree
+ * upward to locate `.forge/config.json`; subsequent calls for the same `cwd`
+ * return the cached result immediately.
+ *
+ * @param cwd - Working directory to start the search from.
+ *              Defaults to `process.cwd()` (same default as the underlying
+ *              `discoverForgeConfig`).
+ */
+export function discoverForgeConfigCached(cwd = process.cwd()) {
+    const key = cwd;
+    if (cache.has(key)) {
+        return cache.get(key);
+    }
+    const result = discoverForgeConfig(cwd);
+    cache.set(key, result);
+    return result;
+}
+/**
+ * Clears all cached entries.
+ *
+ * Primarily for test isolation — call in `beforeEach`/`afterEach` to
+ * prevent cache bleed between test cases that change the filesystem.
+ */
+export function clearForgeConfigCache() {
+    cache.clear();
+}
+//# sourceMappingURL=forge-config.js.map

package/dist/extensions/forgecli/lib/forge-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-config.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/lib/forge-config.ts"],"names":[],"mappings":"AAAA,oEAAoE;AACpE,EAAE;AACF,yEAAyE;AACzE,wDAAwD;AACxD,EAAE;AACF,+EAA+E;AAC/E,8EAA8E;AAC9E,4EAA4E;AAC5E,6EAA6E;AAC7E,8CAA8C;AAE9C,OAAO,EAAE,mBAAmB,EAAoB,MAAM,kBAAkB,CAAC;AAEzE,gFAAgF;AAChF,MAAM,KAAK,GAAG,IAAI,GAAG,EAA8B,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACpE,MAAM,GAAG,GAAG,GAAG,CAAC;IAChB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACpB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;IACxB,CAAC;IACD,MAAM,MAAM,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACxC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACvB,OAAO,MAAM,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB;IACpC,KAAK,CAAC,KAAK,EAAE,CAAC;AACf,CAAC"}

package/dist/extensions/forgecli/lib/frontmatter-parser.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Extract persona names from a workflow's YAML frontmatter `deps.personas` list.
+ *
+ * Expects the frontmatter block to begin and end with `---` delimiters.
+ * Looks for:
+ *   ```yaml
+ *   deps:
+ *     personas: [architect, engineer]
+ *   ```
+ *
+ * @returns Array of persona name strings, or empty array if not found.
+ */
+export declare function extractPersonaNames(workflowMd: string): string[];

package/dist/extensions/forgecli/lib/frontmatter-parser.js

@@ -0,0 +1,56 @@
+// lib/frontmatter-parser.ts — FORGE-S25-T16
+//
+// Extracted from 10 byte-identical copies of extractPersonaNames() across
+// kickoff shim files (approve.ts, collate.ts, commit.ts, enhance.ts,
+// implement.ts, plan.ts, retrospective.ts, review-code.ts, review-plan.ts,
+// validate.ts). Finding H-1 (Round-2-validation.md).
+//
+// Parses the YAML frontmatter `deps.personas` array from a workflow markdown
+// file. Used by kickoff shims to determine which persona files to load, and by
+// lib/manifest-checker.ts to validate that personas are referenced in the body.
+/**
+ * Extract persona names from a workflow's YAML frontmatter `deps.personas` list.
+ *
+ * Expects the frontmatter block to begin and end with `---` delimiters.
+ * Looks for:
+ *   ```yaml
+ *   deps:
+ *     personas: [architect, engineer]
+ *   ```
+ *
+ * @returns Array of persona name strings, or empty array if not found.
+ */
+export function extractPersonaNames(workflowMd) {
+    const lines = workflowMd.split(/\r?\n/);
+    if (lines.length === 0 || lines[0] !== "---")
+        return [];
+    let inside = false;
+    let depsBlock = false;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (i === 0 && line === "---") {
+            inside = true;
+            continue;
+        }
+        if (!inside)
+            break;
+        if (line === "---")
+            break;
+        if (/^deps\s*:\s*$/.test(line)) {
+            depsBlock = true;
+            continue;
+        }
+        const m = /^\s*personas\s*:\s*\[([^\]]*)\]\s*$/.exec(line);
+        if (m && (depsBlock || /^\s/.test(line))) {
+            return m[1]
+                .split(",")
+                .map((s) => s.trim().replace(/^["']|["']$/g, ""))
+                .filter((s) => s.length > 0);
+        }
+        if (depsBlock && /^[A-Za-z0-9_-]+\s*:/.test(line) && !/^\s/.test(line)) {
+            depsBlock = false;
+        }
+    }
+    return [];
+}
+//# sourceMappingURL=frontmatter-parser.js.map

package/dist/extensions/forgecli/lib/frontmatter-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter-parser.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/lib/frontmatter-parser.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,0EAA0E;AAC1E,qEAAqE;AACrE,2EAA2E;AAC3E,qDAAqD;AACrD,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAEhF;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACrD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK;QAAE,OAAO,EAAE,CAAC;IACxD,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YAC/B,MAAM,GAAG,IAAI,CAAC;YACd,SAAS;QACV,CAAC;QACD,IAAI,CAAC,MAAM;YAAE,MAAM;QACnB,IAAI,IAAI,KAAK,KAAK;YAAE,MAAM;QAC1B,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAChC,SAAS,GAAG,IAAI,CAAC;YACjB,SAAS;QACV,CAAC;QACD,MAAM,CAAC,GAAG,qCAAqC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC;YAC1C,OAAO,CAAC,CAAC,CAAC,CAAC;iBACT,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;iBAChD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,SAAS,IAAI,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxE,SAAS,GAAG,KAAK,CAAC;QACnB,CAAC;IACF,CAAC;IACD,OAAO,EAAE,CAAC;AACX,CAAC"}

package/dist/extensions/forgecli/lib/manifest-checker.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Result of a workflow materialization check.
+ * `ok` is true iff all required Pack-06 markers are present.
+ * `missing` lists the human-readable names of any absent markers.
+ */
+export interface MaterializationCheck {
+    ok: boolean;
+    missing: string[];
+}
+/**
+ * Verify that a workflow markdown file contains the four Pack-06 materialization
+ * markers required by the forge-cli kickoff shims:
+ *   1. "Store-Write Verification" — confirms write discipline section.
+ *   2. "Iron Laws" — confirms iron laws section.
+ *   3. "forge_store" — confirms tool reference.
+ *   4. deps.personas declared in frontmatter AND at least one persona referenced in body.
+ *
+ * Note: fix-bug.ts intentionally skips this check for fix_bug.md (N-H-E) because
+ * fix_bug.md is orchestrator-owned prose, not a tool-use sub-workflow. That skip
+ * lives in the call site (fix-bug.ts:725), not here.
+ */
+export declare function checkMaterialization(workflowPath: string, workflowMd: string): MaterializationCheck;