@entelligentsia/forgecli 1.0.25 → 1.0.36

package/dist/extensions/forgecli/friction-emit.js

@@ -0,0 +1,245 @@
+// Auto-emit friction events with 5 skill subkinds — FORGE-S24-T11.
+//
+// At task close, the orchestrator hands a snapshot of {retrieved skills,
+// usage verdicts (T09), task outcome, observed tool errors, per-skill
+// historical "unused" counts, pairwise retrieval overlaps} to this module.
+// `computeFrictionSignals` is a pure classifier; `emitFrictionEvents` writes
+// one `friction` event per signal via `node <storeCli> emit <sprintId> …`.
+//
+// Gating logic (acceptance criteria FORGE-S24-T11):
+//   - skill_unused     : retrieved && !used && task.success
+//   - skill_failed     : retrieved && used  && !task.success
+//   - skill_missing    : !retrieved && task.success && tool_errors ≥ 2
+//   - skill_stale      : retrieved && !used across 3 consecutive sprints
+//   - skill_redundant  : two skills' retrieval overlap > 0.8 in this task
+//
+// Each event carries `{type: "friction", workflow, persona, issue, subkind,
+// skillId, evidence, …runtime attribution}`. The required-trio
+// `{workflow, persona, issue}` is what the event schema (plugin v0.45.x)
+// enforces for `type === "friction"`.
+//
+// Telemetry-actor split (IL10):
+//   - Orchestrator owns emission. Subagents never call this module directly.
+//   - Runtime attribution (model/provider/timestamps/durationMinutes) is
+//     SUPPLIED by the orchestrator — never fabricated here.
+//
+// Iron Laws (forge-cli-engineer):
+//   IL1  — code only under forge-cli/src/extensions/forgecli/
+//   IL2  — TypeScript + TypeBox. Runtime inputs validated via Value.Parse.
+//   IL6  — argv-array spawn. No shell-string interpolation.
+//   IL7  — failures surface in the returned counter and stderrs[]; nothing
+//          is silently swallowed.
+//   IL10 — orchestrator-side emission only; subagent never invokes.
+//
+// Scope boundary: this module classifies and emits. It does NOT crawl
+// the trajectory, decide what counts as a "tool error", or compute
+// retrieval overlaps. The caller (orchestrator handler in run-task.ts /
+// fix-bug.ts, gated by FORGE-S24-T12 flag) does that and passes the
+// shaped inputs in.
+import { Type } from "typebox";
+import { Value } from "typebox/value";
+import { spawnStoreCliEmit } from "./lib/spawn-store-cli.js";
+import { isSkillCurationEnabled } from "./skill-curation-flag.js";
+// ── Public schemas ──────────────────────────────────────────────────────────
+/**
+ * One retrieved-and-classified skill for the closed task. `retrieved`
+ * comes from T08 (skill-retriever); `used` from T09 (skill-usage-tracker).
+ * `retrievalScore` is the T08 score (informational — surfaces in evidence).
+ */
+export const RetrievedSkillSignalSchema = Type.Object({
+    skillId: Type.String({ minLength: 1 }),
+    retrieved: Type.Boolean(),
+    used: Type.Boolean(),
+    retrievalScore: Type.Number({ minimum: 0, maximum: 1 }),
+});
+/** Per-skill historical signal — supplied by caller from sprint history. */
+export const SkillHistorySchema = Type.Object({
+    consecutiveUnusedSprints: Type.Integer({ minimum: 0 }),
+});
+/** One pairwise retrieval-overlap measurement for the closed task. */
+export const PairwiseOverlapSchema = Type.Object({
+    skillA: Type.String({ minLength: 1 }),
+    skillB: Type.String({ minLength: 1 }),
+    overlap: Type.Number({ minimum: 0, maximum: 1 }),
+});
+export const FrictionInputsSchema = Type.Object({
+    retrievedSkills: Type.Array(RetrievedSkillSignalSchema),
+    taskSuccess: Type.Boolean(),
+    toolErrorCount: Type.Integer({ minimum: 0 }),
+    history: Type.Record(Type.String(), SkillHistorySchema),
+    pairwiseRetrievalOverlap: Type.Optional(Type.Array(PairwiseOverlapSchema)),
+});
+// FORGE-S25-T27: FRICTION_SUBKINDS and FrictionSubkind are now canonical in
+// lib/catalog-types.ts (single source of truth). Re-exported here for backward
+// compatibility — all existing imports of FRICTION_SUBKINDS from this module continue to work.
+// Source of truth: event.schema.json subkind pattern (skill_unused|skill_failed|…).
+import { FRICTION_SUBKINDS } from "./lib/catalog-types.js";
+export { FRICTION_SUBKINDS };
+/** Runtime attribution supplied by the orchestrator (IL10). */
+export const FrictionEmitRuntimeSchema = Type.Object({
+    storeCli: Type.String({ minLength: 1 }),
+    cwd: Type.String({ minLength: 1 }),
+    sprintId: Type.String({ minLength: 1 }),
+    taskId: Type.String({ minLength: 1 }),
+    /** Orchestrator phase role. @see RoleKind from lib/catalog-types.ts */
+    role: Type.String({ minLength: 1 }),
+    /** Orchestrator phase action. @see ActionKind from lib/catalog-types.ts */
+    action: Type.String({ minLength: 1 }),
+    workflow: Type.String({ minLength: 1 }),
+    persona: Type.String({ minLength: 1 }),
+    phase: Type.Optional(Type.String()),
+    iteration: Type.Optional(Type.Integer({ minimum: 1 })),
+    startTimestamp: Type.String({ format: "date-time" }),
+    endTimestamp: Type.String({ format: "date-time" }),
+    durationMinutes: Type.Number({ minimum: 0 }),
+    model: Type.String({ minLength: 1 }),
+    provider: Type.String({ minLength: 1 }),
+});
+// ── Classification ──────────────────────────────────────────────────────────
+const STALE_THRESHOLD_SPRINTS = 3;
+const REDUNDANCY_OVERLAP_FLOOR = 0.8;
+const MISSING_TOOL_ERROR_FLOOR = 2;
+/**
+ * Apply the five gating rules and return one signal per matching emit.
+ * Pure: no IO, no subprocess. Caller decides whether/when to emit.
+ *
+ * The `skill_unused` and `skill_failed` gates are mutually exclusive by
+ * design — on a failed task we emit `skill_failed` (when used) rather
+ * than `skill_unused`, so the two signals never double-count the same
+ * outcome.
+ */
+export function computeFrictionSignals(inputs) {
+    Value.Parse(FrictionInputsSchema, inputs);
+    const signals = [];
+    for (const s of inputs.retrievedSkills) {
+        // skill_unused — retrieved, not used, task succeeded.
+        if (s.retrieved && !s.used && inputs.taskSuccess) {
+            signals.push({
+                subkind: "skill_unused",
+                skillId: s.skillId,
+                evidence: {
+                    retrievalScore: s.retrievalScore,
+                    taskSuccess: true,
+                },
+            });
+        }
+        // skill_failed — retrieved, used, task failed.
+        if (s.retrieved && s.used && !inputs.taskSuccess) {
+            signals.push({
+                subkind: "skill_failed",
+                skillId: s.skillId,
+                evidence: {
+                    retrievalScore: s.retrievalScore,
+                    toolErrorCount: inputs.toolErrorCount,
+                },
+            });
+        }
+        // skill_stale — retrieved, not used, and the same {retrieved && !used}
+        // pattern has held across STALE_THRESHOLD_SPRINTS consecutive sprints.
+        if (s.retrieved && !s.used) {
+            const hist = inputs.history[s.skillId];
+            if (hist && hist.consecutiveUnusedSprints >= STALE_THRESHOLD_SPRINTS) {
+                signals.push({
+                    subkind: "skill_stale",
+                    skillId: s.skillId,
+                    evidence: {
+                        consecutiveUnusedSprints: hist.consecutiveUnusedSprints,
+                    },
+                });
+            }
+        }
+    }
+    // skill_missing — no skill retrieved AND task succeeded AND ≥2 tool errors.
+    // Emitted once per task (no skillId — there's nothing to attribute).
+    if (inputs.retrievedSkills.length === 0 && inputs.taskSuccess && inputs.toolErrorCount >= MISSING_TOOL_ERROR_FLOOR) {
+        signals.push({
+            subkind: "skill_missing",
+            skillId: undefined,
+            evidence: {
+                toolErrorCount: inputs.toolErrorCount,
+            },
+        });
+    }
+    // skill_redundant — pairwise retrieval overlap strictly > 0.8. Emit one
+    // signal per pair, attributed to the FIRST skill in the pair (skillA).
+    for (const p of inputs.pairwiseRetrievalOverlap ?? []) {
+        if (p.overlap > REDUNDANCY_OVERLAP_FLOOR) {
+            signals.push({
+                subkind: "skill_redundant",
+                skillId: p.skillA,
+                evidence: {
+                    pairedWith: p.skillB,
+                    overlap: p.overlap,
+                },
+            });
+        }
+    }
+    return signals;
+}
+// ── Emission ────────────────────────────────────────────────────────────────
+/** ISO-compact timestamp segment for eventId composition. */
+function isoCompact(iso) {
+    return iso.replace(/[-:.]/g, "").replace(/Z$/, "Z");
+}
+/**
+ * Emit one `friction` event per signal via
+ * `node <storeCli> emit <sprintId> <json>`. Runtime attribution
+ * (model/provider/timestamps/eventId) is supplied by the caller — never
+ * fabricated. Failures surface in the result counter; nothing is thrown
+ * for subprocess failure.
+ */
+export function emitFrictionEvents(signals, runtime) {
+    // FORGE-S24-T12 — gated rollout. Default off ⇒ no friction events
+    // for the five SKILL-CURATION subkinds (skill_unused, skill_failed,
+    // skill_missing, skill_stale, skill_redundant). Note: this gate
+    // applies to the auto-emit module landed in FORGE-S24-T11. The
+    // existing orchestrator friction channel (non-skill subkinds) goes
+    // through `forge/tools/friction-emit.cjs` and is not gated here.
+    if (!isSkillCurationEnabled(runtime.cwd)) {
+        return { emitted: 0, failed: 0, stderrs: [] };
+    }
+    Value.Parse(FrictionEmitRuntimeSchema, runtime);
+    let emitted = 0;
+    let failed = 0;
+    const stderrs = [];
+    for (let i = 0; i < signals.length; i++) {
+        const sig = signals[i];
+        const idTail = sig.skillId ?? "none";
+        const eventId = `${isoCompact(runtime.startTimestamp)}_${runtime.taskId}_friction_${sig.subkind}_${i}_${idTail}`;
+        const event = {
+            eventId,
+            sprintId: runtime.sprintId,
+            taskId: runtime.taskId,
+            role: runtime.role,
+            action: runtime.action,
+            startTimestamp: runtime.startTimestamp,
+            endTimestamp: runtime.endTimestamp,
+            durationMinutes: runtime.durationMinutes,
+            model: runtime.model,
+            provider: runtime.provider,
+            type: "friction",
+            workflow: runtime.workflow,
+            persona: runtime.persona,
+            issue: sig.subkind,
+            subkind: sig.subkind,
+            evidence: sig.evidence,
+        };
+        if (sig.skillId !== undefined)
+            event.skillId = sig.skillId;
+        if (runtime.phase !== undefined)
+            event.phase = runtime.phase;
+        if (runtime.iteration !== undefined)
+            event.iteration = runtime.iteration;
+        // FORGE-S25-T17: adopt spawnStoreCliEmit; adds missing 10 s timeout (N-C-A).
+        const emitResult = spawnStoreCliEmit(runtime.storeCli, runtime.sprintId, event, runtime.cwd);
+        if (emitResult.ok) {
+            emitted++;
+        }
+        else {
+            failed++;
+            stderrs.push(emitResult.stderr);
+        }
+    }
+    return { emitted, failed, stderrs };
+}
+//# sourceMappingURL=friction-emit.js.map

package/dist/extensions/forgecli/friction-emit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-emit.js","sourceRoot":"","sources":["../../../src/extensions/forgecli/friction-emit.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,2EAA2E;AAC3E,6EAA6E;AAC7E,2EAA2E;AAC3E,EAAE;AACF,oDAAoD;AACpD,4DAA4D;AAC5D,6DAA6D;AAC7D,uEAAuE;AACvE,yEAAyE;AACzE,0EAA0E;AAC1E,EAAE;AACF,4EAA4E;AAC5E,+DAA+D;AAC/D,yEAAyE;AACzE,sCAAsC;AACtC,EAAE;AACF,gCAAgC;AAChC,6EAA6E;AAC7E,yEAAyE;AACzE,4DAA4D;AAC5D,EAAE;AACF,kCAAkC;AAClC,8DAA8D;AAC9D,2EAA2E;AAC3E,4DAA4D;AAC5D,2EAA2E;AAC3E,kCAAkC;AAClC,oEAAoE;AACpE,EAAE;AACF,sEAAsE;AACtE,mEAAmE;AACnE,wEAAwE;AACxE,oEAAoE;AACpE,oBAAoB;AAEpB,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC,MAAM,CAAC;IACrD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACtC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE;IACzB,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE;IACpB,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;CACvD,CAAC,CAAC;AAGH,4EAA4E;AAC5E,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC7C,wBAAwB,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;CACtD,CAAC,CAAC;AAGH,sEAAsE;AACtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC,MAAM,CAAC;IAChD,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;CAChD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,oBAAoB,GAAG,IAAI,CAAC,MAAM,CAAC;IAC/C,eAAe,EAAE,IAAI,CAAC,KAAK,CAAC,0BAA0B,CAAC;IACvD,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE;IAC3B,cAAc,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC5C,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC;IACvD,wBAAwB,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;CAC1E,CAAC,CAAC;AAGH,4EAA4E;AAC5E,+EAA+E;AAC/E,+FAA+F;AAC/F,oFAAoF;AACpF,OAAO,EAAE,iBAAiB,EAAwB,MAAM,wBAAwB,CAAC;AAEjF,OAAO,EAAE,iBAAiB,EAAwB,CAAC;AAYnD,+DAA+D;AAC/D,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC,MAAM,CAAC;IACpD,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACvC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IAClC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACvC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrC,uEAAuE;IACvE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACnC,2EAA2E;IAC3E,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACrC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACvC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACtC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACnC,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;IACtD,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IACpD,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAClD,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAC5C,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;IACpC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;CACvC,CAAC,CAAC;AASH,+EAA+E;AAE/E,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAClC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AACrC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAEnC;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAsB;IAC5D,KAAK,CAAC,KAAK,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAqB,EAAE,CAAC;IAErC,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QACxC,sDAAsD;QACtD,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,cAAc;gBACvB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE;oBACT,cAAc,EAAE,CAAC,CAAC,cAAc;oBAChC,WAAW,EAAE,IAAI;iBACjB;aACD,CAAC,CAAC;QACJ,CAAC;QAED,+CAA+C;QAC/C,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,cAAc;gBACvB,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,QAAQ,EAAE;oBACT,cAAc,EAAE,CAAC,CAAC,cAAc;oBAChC,cAAc,EAAE,MAAM,CAAC,cAAc;iBACrC;aACD,CAAC,CAAC;QACJ,CAAC;QAED,uEAAuE;QACvE,uEAAuE;QACvE,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACvC,IAAI,IAAI,IAAI,IAAI,CAAC,wBAAwB,IAAI,uBAAuB,EAAE,CAAC;gBACtE,OAAO,CAAC,IAAI,CAAC;oBACZ,OAAO,EAAE,aAAa;oBACtB,OAAO,EAAE,CAAC,CAAC,OAAO;oBAClB,QAAQ,EAAE;wBACT,wBAAwB,EAAE,IAAI,CAAC,wBAAwB;qBACvD;iBACD,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IAED,4EAA4E;IAC5E,qEAAqE;IACrE,IAAI,MAAM,CAAC,eAAe,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,cAAc,IAAI,wBAAwB,EAAE,CAAC;QACpH,OAAO,CAAC,IAAI,CAAC;YACZ,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE,SAAS;YAClB,QAAQ,EAAE;gBACT,cAAc,EAAE,MAAM,CAAC,cAAc;aACrC;SACD,CAAC,CAAC;IACJ,CAAC;IAED,wEAAwE;IACxE,uEAAuE;IACvE,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,wBAAwB,IAAI,EAAE,EAAE,CAAC;QACvD,IAAI,CAAC,CAAC,OAAO,GAAG,wBAAwB,EAAE,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC;gBACZ,OAAO,EAAE,iBAAiB;gBAC1B,OAAO,EAAE,CAAC,CAAC,MAAM;gBACjB,QAAQ,EAAE;oBACT,UAAU,EAAE,CAAC,CAAC,MAAM;oBACpB,OAAO,EAAE,CAAC,CAAC,OAAO;iBAClB;aACD,CAAC,CAAC;QACJ,CAAC;IACF,CAAC;IAED,OAAO,OAAO,CAAC;AAChB,CAAC;AAED,+EAA+E;AAE/E,6DAA6D;AAC7D,SAAS,UAAU,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CACjC,OAAkC,EAClC,OAA4B;IAE5B,kEAAkE;IAClE,oEAAoE;IACpE,gEAAgE;IAChE,+DAA+D;IAC/D,mEAAmE;IACnE,iEAAiE;IACjE,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,yBAAyB,EAAE,OAAO,CAAC,CAAC;IAEhD,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzC,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QAEvB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,MAAM,CAAC;QACrC,MAAM,OAAO,GAAG,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,MAAM,aAAa,GAAG,CAAC,OAAO,IAAI,CAAC,IAAI,MAAM,EAAE,CAAC;QAEjH,MAAM,KAAK,GAA4B;YACtC,OAAO;YACP,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,cAAc,EAAE,OAAO,CAAC,cAAc;YACtC,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,eAAe,EAAE,OAAO,CAAC,eAAe;YACxC,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,IAAI,EAAE,UAAU;YAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ;YAC1B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,GAAG,CAAC,OAAO;YAClB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,QAAQ,EAAE,GAAG,CAAC,QAAQ;SACtB,CAAC;QACF,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS;YAAE,KAAK,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC3D,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC7D,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;YAAE,KAAK,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QAEzE,6EAA6E;QAC7E,MAAM,UAAU,GAAG,iBAAiB,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC;QAC7F,IAAI,UAAU,CAAC,EAAE,EAAE,CAAC;YACnB,OAAO,EAAE,CAAC;QACX,CAAC;aAAM,CAAC;YACP,MAAM,EAAE,CAAC;YACT,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;IACF,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AACrC,CAAC"}

package/dist/extensions/forgecli/implement.d.ts

@@ -0,0 +1,22 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { extractPersonaNames } from "./lib/frontmatter-parser.js";
+export { extractPersonaNames };
+import { checkMaterialization, type MaterializationCheck } from "./lib/manifest-checker.js";
+export { checkMaterialization, type MaterializationCheck };
+export type ArgMode = "empty" | "file" | "text";
+export interface ParsedArgs {
+    mode: ArgMode;
+    taskRef: string;
+    sourceLabel: string;
+}
+export declare function parseImplementArgs(rawArgs: string, cwd: string): ParsedArgs;
+export interface ComposeKickoffOpts {
+    workflowMd: string;
+    personaIdentity: string;
+    parsed: ParsedArgs;
+}
+export declare function composeKickoff(opts: ComposeKickoffOpts): string;
+export interface RegisterImplementOptions {
+    cwd?: string;
+}
+export declare function registerImplement(pi: ExtensionAPI, options?: RegisterImplementOptions): void;

package/dist/extensions/forgecli/implement.js

@@ -0,0 +1,170 @@
+// forge:implement — native kickoff handler (FORGE-S20-T06).
+//
+// Replaces the auto-generated stub previously installed by
+// registerAllForgeCommands (forge-commands.ts). Like S19 sprint-intake and
+// FORGE-S20-T04 enhance / FORGE-S20-T05 plan, this is a Kickoff Shim
+// (Pack-04 + Pack-06):
+//   1. Reads `.forge/workflows/implement_plan.md` (the materialized workflow).
+//   2. Verifies four Pack-06 materialization markers — refuses to dispatch on
+//      regression and emits a per-marker `ctx.ui.notify` so the user sees the
+//      cause.
+//   3. Loads the persona declared in the workflow's `deps.personas:`
+//      frontmatter via the FORGE-S20-T02 loader (no ad-hoc fs.readFile of
+//      `.forge/personas/`).
+//   4. Composes ONE kickoff message: persona identity, dispatch instructions
+//      (read approved PLAN.md, follow workflow, write PROGRESS.md /
+//      IMPLEMENTATION-SUMMARY.json, forge_store-driven status updates), the
+//      workflow body verbatim, and argv as @<path> file ref or free-form text.
+//   5. Hands control to the LLM via `sendKickoff(pi, text)` —
+//      `deliverAs: "steer"`. Never raw `pi.sendUserMessage`.
+//
+// Per FORGE-S20 SPRINT_REQUIREMENTS Constraints and T06 AC#4: the
+// prompt-injection fallback is DELETED — no FORGE_LEGACY_KICKOFF flag, no
+// markdown-stub for this command.
+//
+// Per task notes: kept as a deliberate clone of plan.ts. Abstraction across
+// plan/implement is deferred until both ports are committed and a follow-up
+// task evaluates the shared shape.
+//
+// FORGE-S26-T11: pipeline step guard added. Checks task status via store-cli
+// before dispatching. --force flag bypasses the guard.
+//
+// Iron Laws:
+//   IL1 — code only under forge-cli/src/extensions/forgecli/.
+//   IL4 — no JSON.stringify-into-subagent dispatch.
+//   IL6 — no shell-string interpolation; no spawn calls here.
+//   IL7 — every failure path emits ctx.ui.notify and returns; no silent
+//         continuation.
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { assertAudience } from "./audience-gate.js";
+import { discoverForgeConfig } from "./forge-root.js";
+import { sendKickoff } from "./kickoff.js";
+// FORGE-S25-T16: extracted to lib modules (H-1, H-2). Re-exported here for
+// backward compatibility with existing test and consumer imports.
+import { extractPersonaNames } from "./lib/frontmatter-parser.js";
+import { parseGuardArgs, runPipelineGuard } from "./lib/pipeline-guard.js";
+import { loadPersona, PersonaSkillLoaderError } from "./parsers/persona-skill-loader.js";
+import { loadWorkflow, WorkflowLoaderError } from "./parsers/workflow-loader.js";
+export { extractPersonaNames };
+import { checkMaterialization } from "./lib/manifest-checker.js";
+export { checkMaterialization };
+export function parseImplementArgs(rawArgs, cwd) {
+    const trimmed = (rawArgs ?? "").trim();
+    if (trimmed === "") {
+        return { mode: "empty", taskRef: "", sourceLabel: "(no input — engineer infers task from store/context)" };
+    }
+    if (trimmed.startsWith("@")) {
+        const ref = trimmed.slice(1).trim();
+        const filePath = path.isAbsolute(ref) ? ref : path.resolve(cwd, ref);
+        const seed = fs.readFileSync(filePath, "utf8");
+        return { mode: "file", taskRef: seed, sourceLabel: `(seed from file: ${ref})` };
+    }
+    return { mode: "text", taskRef: trimmed, sourceLabel: "(seed from inline text)" };
+}
+export function composeKickoff(opts) {
+    const { workflowMd, personaIdentity, parsed } = opts;
+    const sections = ["# /forge:implement", ""];
+    if (personaIdentity.trim().length > 0) {
+        sections.push(personaIdentity.trim(), "");
+    }
+    sections.push("## Dispatch", "", "Run the workflow below. Specifically:", "", "1. Read the approved plan at `engineering/sprints/<SPRINT_ID>/<TASK_ID>/PLAN.md` (the source of truth).", "2. Query the store for the task and its sprint/feature context via `forge_store_query` — do NOT raw-read `.forge/store/`.", "3. Follow the workflow Algorithm verbatim: load context, execute plan steps incrementally, run syntax/test/build verification, write PROGRESS.md, knowledge writeback, finalize.", "4. Write `PROGRESS.md` and `IMPLEMENTATION-SUMMARY.json` to the task directory using the `write` tool.", "5. Update task status by calling the `forge_store` MCP tool: `{command:'update-status', args:['task','<TASK_ID>','status','<new-status>']}`. Never raw-write `.forge/store/`. Do NOT bash-shell `forge store ...`.", "6. Honour Pack-06 Read/Write/Ask/Store discipline: writes go via the `forge_store` MCP tool (canonical 2-positional write: `args:['<entity>','<json>']`, id INSIDE json); in-conversation clarifications use `forge_ask_user`.");
+    sections.push("", "---", "", "## Workflow", "", workflowMd.trim(), "", "---");
+    if (parsed.mode === "empty") {
+        sections.push("", "## Input", "", "(no seed — infer task from sprint context and store)");
+    }
+    else {
+        sections.push("", `## Input — ${parsed.sourceLabel}`, "", parsed.taskRef.trim());
+    }
+    return sections.join("\n");
+}
+// Registration -------------------------------------------------------------
+const WORKFLOW_REL_PATH = path.join(".forge", "workflows", "implement_plan.md");
+export function registerImplement(pi, options = {}) {
+    pi.registerCommand("forge:implement", {
+        description: "Run the implement-plan workflow for a Forge task. " +
+            "Usage: /forge:implement [@<file> | <free-form text>]. " +
+            "Empty args → engineer infers the task from sprint/store context.",
+        async handler(args, ctx) {
+            const cwd = options.cwd ?? process.cwd();
+            const workflowPath = path.join(cwd, WORKFLOW_REL_PATH);
+            // Pipeline step guard (FORGE-S26-T11): check task state before dispatching.
+            const guardParsed = parseGuardArgs(args);
+            if (!guardParsed.force) {
+                const forgeConfig = discoverForgeConfig(cwd);
+                if (forgeConfig) {
+                    const guard = runPipelineGuard("implement", guardParsed.taskIdHint, forgeConfig.forgeRoot, cwd);
+                    if (guard.blocked) {
+                        ctx.ui.notify(guard.message, "error");
+                        return;
+                    }
+                }
+            }
+            const effectiveArgs = guardParsed.cleanArgs;
+            let workflowMd;
+            let workflowAudience;
+            try {
+                const loaded = loadWorkflow(workflowPath);
+                workflowMd = loaded.rawMarkdown;
+                workflowAudience = loaded.audience;
+            }
+            catch (err) {
+                if (err instanceof WorkflowLoaderError) {
+                    if (err.code === "missing_file") {
+                        ctx.ui.notify(`× forge:implement — workflow not found at ${WORKFLOW_REL_PATH}; run /forge:init or /forge:rebuild first.`, "error");
+                    }
+                    else {
+                        ctx.ui.notify(`× forge:implement — workflow load failed (${err.code}): ${err.message}`, "error");
+                    }
+                    return;
+                }
+                const e = err;
+                ctx.ui.notify(`× forge:implement — failed to read workflow: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            let parsed;
+            try {
+                parsed = parseImplementArgs(effectiveArgs, cwd);
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× forge:implement — failed to read seed: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            const check = checkMaterialization(workflowPath, workflowMd);
+            if (!check.ok) {
+                for (const marker of check.missing) {
+                    ctx.ui.notify(`× workflow regression: ${marker} not found in ${workflowPath}`, "error");
+                }
+                return;
+            }
+            const personas = extractPersonaNames(workflowMd);
+            let personaIdentity = "";
+            if (personas.length > 0) {
+                try {
+                    const persona = loadPersona(personas[0], { cwd });
+                    personaIdentity = persona.identity;
+                }
+                catch (err) {
+                    if (err instanceof PersonaSkillLoaderError) {
+                        ctx.ui.notify(`× forge:implement — persona '${personas[0]}' load failed (${err.code}): ${err.message}`, "error");
+                        return;
+                    }
+                    const e = err;
+                    ctx.ui.notify(`× forge:implement — persona load error: ${e.message ?? "unknown"}`, "error");
+                    return;
+                }
+            }
+            if (!assertAudience({ workflowName: "implement_plan", audience: workflowAudience }, ctx)) {
+                return;
+            }
+            const kickoff = composeKickoff({
+                workflowMd,
+                personaIdentity,
+                parsed,
+            });
+            sendKickoff(pi, kickoff);
+        },
+    });
+}
+//# sourceMappingURL=implement.js.map

package/dist/extensions/forgecli/implement.js.map

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

package/dist/extensions/forgecli/init-context.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Discover project name from package.json:name, falling back to cwd basename.
+ *
+ * Tries to read <cwd>/package.json and parse the `name` field. If the file is
+ * absent, malformed, or missing the name field, returns `path.basename(cwd)`.
+ */
+export declare function discoverProjectName(cwd: string): string;
+export interface ProjectContextProject {
+    name: string;
+    prefix: string;
+    description?: string;
+    stack?: string[];
+    commands?: {
+        test?: string;
+        build?: string;
+        deploy?: string;
+    };
+}
+export interface ProjectContextArchitecture {
+    frameworks?: {
+        backend?: string;
+        frontend?: string;
+        database?: string;
+    };
+    dataAccess?: string;
+    deployment?: string;
+    entrypoints?: string[];
+}
+export interface ProjectContextWorkflow {
+    testCommand?: string;
+    lintCommand?: string;
+    buildCommand?: string;
+}
+export interface ProjectContextKnowledgeBase {
+    path?: string;
+    indexFile?: string;
+}
+export interface ProjectContext {
+    project: ProjectContextProject;
+    architecture?: ProjectContextArchitecture;
+    workflow?: ProjectContextWorkflow;
+    knowledgeBase?: ProjectContextKnowledgeBase;
+}
+/** Minimal discovery results passed from Phase 2 */
+export interface DiscoveryResults {
+    projectName?: string;
+    prefix?: string;
+    description?: string;
+    stack?: string[];
+    testCommand?: string;
+    lintCommand?: string;
+    buildCommand?: string;
+    backendFramework?: string;
+    frontendFramework?: string;
+    database?: string;
+    deployment?: string;
+    dataAccess?: string;
+    kbPath?: string;
+}
+export interface ForgeConfig {
+    project?: {
+        name?: string;
+        prefix?: string;
+    };
+    paths?: {
+        engineering?: string;
+        forgeRoot?: string;
+    };
+}
+/**
+ * Build a ProjectContext from discovery results and forge config.
+ *
+ * Merges discoveryResults with config data. Config project.name/prefix take
+ * precedence over discovery if both are present (config was set interactively).
+ */
+export declare function buildProjectContext(discoveryResults: DiscoveryResults, config: ForgeConfig): ProjectContext;
+/**
+ * Validate a ProjectContext object structurally. Throws with a descriptive
+ * error if required fields are missing.
+ */
+export declare function validateProjectContext(ctx: unknown): asserts ctx is ProjectContext;
+/**
+ * Write project-context.json to <cwd>/.forge/project-context.json
+ */
+export declare function writeProjectContext(cwd: string, ctx: ProjectContext): void;
+export interface CalibrationBaseline {
+    lastCalibrated: string;
+    version: string;
+    masterIndexHash: string | null;
+    sprintsCovered: string[];
+}
+/**
+ * Compute a calibration baseline snapshot for /forge:init Phase 2.
+ *
+ * @param cwd - project working directory
+ * @param kbPath - relative path to the knowledge base directory (e.g. "engineering")
+ * @param bundledPluginVersion - version string from package.json forge.bundledVersion
+ */
+export declare function computeCalibrationBaseline(cwd: string, kbPath: string, bundledPluginVersion: string): CalibrationBaseline;