@entelligentsia/forgecli 0.11.3 → 0.15.0

package/dist/extensions/forgecli/regenerate.js

@@ -12,10 +12,63 @@
 // Idempotent — re-running with no changes overwrites with identical bytes.
 //
 // See forge-cli companion to forge#83 / #85.
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
 import * as fs from "node:fs";
 import * as path from "node:path";
 import { getBundledPayloadRoot, getBundledToolsRoot } from "./forge-init.js";
+// ── Pre-write modification guard (forge-cli#26 / forge#106 / FORGE-BUG-037) ──
+//
+// `substitute-placeholders.cjs` blanket-overwrites every file in the four
+// structural-element categories. Before invoking it, enumerate each .forge/<cat>/
+// file and run `generation-manifest.cjs check`. Any file whose recorded hash
+// no longer matches its on-disk content is a manual modification — typically
+// applied by /forge:enhance Phase 2 — and would be silently destroyed.
+// Surface the list to the user and require explicit confirmation.
+const STRUCTURAL_CATEGORIES = ["personas", "skills", "workflows", "templates"];
+/**
+ * Enumerate files in .forge/{personas,skills,workflows,templates}/ and return
+ * those whose state diverges from the manifest baseline. Two divergence states
+ * are surfaced (both warrant a prompt before overwrite):
+ *
+ * - "modified": file content differs from the recorded manifest hash. Typically
+ *   caused by /forge:enhance Phase 2 applying edits in-place.
+ * - "untracked": file exists on disk but has NO manifest entry. Caused by a
+ *   prior regenerate that ran `clear-namespace` without re-recording. A fresh
+ *   /forge:init records hashes for every generated file, so "untracked" should
+ *   never appear in a clean install — its presence signals user content that's
+ *   been disconnected from the tracking system. See forge-cli#30.
+ *
+ * Pure function (no I/O beyond fs reads + manifest tool spawns).
+ */
+export function findModifiedStructuralFiles(cwd, toolsRoot) {
+    const manifestTool = path.join(toolsRoot, "generation-manifest.cjs");
+    if (!fs.existsSync(manifestTool))
+        return [];
+    const modified = [];
+    for (const category of STRUCTURAL_CATEGORIES) {
+        const dir = path.join(cwd, ".forge", category);
+        if (!fs.existsSync(dir))
+            continue;
+        const files = fs.readdirSync(dir).filter((f) => f.endsWith(".md"));
+        for (const f of files) {
+            const relPath = path.posix.join(".forge", category, f);
+            const result = spawnSync("node", [manifestTool, "check", relPath], {
+                cwd,
+                encoding: "utf8",
+                timeout: 5_000,
+            });
+            // generation-manifest check exit codes:
+            //   0 = pristine, 1 = modified, 2 = untracked, 3 = file missing
+            if (result.status === 1) {
+                modified.push({ category, relativePath: relPath, state: "modified" });
+            }
+            else if (result.status === 2) {
+                modified.push({ category, relativePath: relPath, state: "untracked" });
+            }
+        }
+    }
+    return modified;
+}
 async function runTool(toolPath, argv, cwd, ctx, label, timeoutMs = 60_000) {
     return await new Promise((resolve) => {
         const child = spawn("node", [toolPath, ...argv], { cwd, stdio: ["ignore", "pipe", "pipe"] });
@@ -55,7 +108,7 @@ export function registerRegenerate(pi) {
     pi.registerCommand("forge:regenerate", {
         description: "Re-materialize .forge/ and .claude/commands/ from the bundled forge-payload " +
             "(deterministic subset of the plugin's /forge:regenerate — runs substitute-placeholders.cjs).",
-        async handler(_args, ctx) {
+        async handler(args, ctx) {
             const cwd = process.cwd();
             const configPath = path.join(cwd, ".forge", "config.json");
             if (!fs.existsSync(configPath)) {
@@ -75,6 +128,42 @@ export function registerRegenerate(pi) {
                 ctx.ui.notify(`× forge:regenerate — base-pack missing at ${basePackDir}`, "error");
                 return;
             }
+            // Pre-write modification guard (forge-cli#26 / forge#106 / FORGE-BUG-037).
+            // Skip with --force (e.g. CI / dogfood reset). Otherwise, surface any
+            // manual modifications (typically applied by /forge:enhance Phase 2)
+            // and require explicit confirmation before overwriting them.
+            const force = (args ?? []).includes("--force");
+            if (!force) {
+                const divergent = findModifiedStructuralFiles(cwd, toolsRoot);
+                if (divergent.length > 0) {
+                    const modCount = divergent.filter((m) => m.state === "modified").length;
+                    const untCount = divergent.filter((m) => m.state === "untracked").length;
+                    const summary = [
+                        `${divergent.length} file(s) in .forge/ diverge from the manifest baseline:`,
+                        `  ${modCount} modified (hash mismatch — typical /forge:enhance Phase 2 edit)`,
+                        `  ${untCount} untracked (no manifest entry — usually means a prior regenerate cleared the namespace)`,
+                        "",
+                        "Divergent files:",
+                        ...divergent.map((m) => `  △ [${m.state}] ${m.relativePath}`),
+                        "",
+                        "Edits CAPTURED by /forge:enhance Phase 2 snapshots (.forge/archive/snap-N/)",
+                        "will be RESTORED automatically post-regenerate via `manage-versions replay`",
+                        "(forge#107 / Approach A — overlay semantics, later snapshots win).",
+                        "",
+                        "Edits NOT captured in any snapshot will be lost. To capture before regen, run",
+                        "/forge:enhance Phase 2 → approve edits → ensure `add-snapshot` was called.",
+                        "",
+                        "Answer 'yes' to proceed (snapshot-captured edits survive automatically).",
+                        "Answer 'no' to abort.",
+                        "Use --force to skip this prompt AND skip replay (pristine base-pack).",
+                    ].join("\n");
+                    const proceed = await ctx.ui.confirm(`Proceed with regenerate? (${divergent.length} divergent file(s): ${modCount} modified, ${untCount} untracked)`, summary);
+                    if (!proceed) {
+                        ctx.ui.notify(`〇 forge:regenerate cancelled — ${divergent.length} divergent file(s) preserved.`, "info");
+                        return;
+                    }
+                }
+            }
             ctx.ui.setStatus?.("forge:regenerate", "rebuilding init-context…");
             // 1. Rebuild init-context.json so substitute has fresh placeholders.
             if (fs.existsSync(buildInitContextTool)) {
@@ -111,7 +200,48 @@ export function registerRegenerate(pi) {
                 "--out",
                 cwd,
             ], cwd, ctx, "substitute-placeholders", 60_000);
-            // 3. Refresh schemas from bundled .schemas/. substitute-placeholders does
+            // 3a. Replay user enhancements (forge#107 / forge-cli#27 — Approach A layer 3).
+            //     After substitute-placeholders wrote fresh base-pack content over
+            //     .forge/{personas,skills,workflows,templates}/, restore any user-enhanced
+            //     files captured by /forge:enhance Phase 2 snapshots from .forge/archive/snap-N/.
+            //     Mirrors regenerate.md's per-category replay step. Pure additive — replay
+            //     is a no-op when no snapshots match. Skipped when --force is used (force
+            //     is "I want pristine base-pack content, no overlay").
+            const manageVersionsTool = path.join(toolsRoot, "manage-versions.cjs");
+            let replayTotal = 0;
+            if (ok && !force && fs.existsSync(manageVersionsTool)) {
+                ctx.ui.setStatus?.("forge:regenerate", "replaying user enhancements…");
+                const replayCategories = ["personas", "skills", "workflows", "templates"];
+                for (const category of replayCategories) {
+                    await new Promise((resolve) => {
+                        const child = spawn("node", [manageVersionsTool, "replay", "--target", category], {
+                            cwd,
+                            stdio: ["ignore", "pipe", "pipe"],
+                        });
+                        let stdoutBuf = "";
+                        child.stdout?.on("data", (d) => {
+                            stdoutBuf += d.toString();
+                        });
+                        child.on("close", (code) => {
+                            if (code === 0) {
+                                // Parse "restored — N file(s)" out of stdout to track total
+                                const m = stdoutBuf.match(/(\d+)\s+file\(s\)\s+restored/);
+                                if (m) {
+                                    replayTotal += parseInt(m[1], 10);
+                                }
+                            }
+                            // Non-zero exit (e.g. structure-versions.json missing on a
+                            // project that never ran /forge:enhance): treat as no-op.
+                            resolve();
+                        });
+                        child.on("error", () => resolve());
+                    });
+                }
+                if (replayTotal > 0) {
+                    ctx.ui.notify(`〇 replay: ${replayTotal} user enhancement(s) restored from snapshots`, "info");
+                }
+            }
+            // 3b. Refresh schemas from bundled .schemas/. substitute-placeholders does
             //    not touch .forge/schemas/, but a forge plugin version bump can ship
             //    schema changes (e.g. 0.43.13 added `provider` required + dropped
             //    `estimatedCostUSD`). Without this step, regenerated workflows assume

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

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

package/dist/extensions/forgecli/skill-curation-flag.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Parse an env flag value to a tri-state: true / false / null (absent or
+ * unrecognised). Unrecognised values fall through to the disk layers — we
+ * do NOT throw or coerce to false silently.
+ */
+declare function parseEnvFlag(raw: string | undefined): boolean | null;
+/**
+ * Resolve the SKILL-CURATION feature flag for the given working directory.
+ *
+ * Default OFF — the helper returns true only when an explicit `true` value
+ * is found in the env override or one of the config layers.
+ *
+ * `cwd` defaults to `process.cwd()` for production call sites; tests pass
+ * a temp dir to isolate filesystem state.
+ */
+export declare function isSkillCurationEnabled(cwd?: string): boolean;
+export declare const _internal: {
+    parseEnvFlag: typeof parseEnvFlag;
+    ENV_FLAG: string;
+};
+export {};

package/dist/extensions/forgecli/skill-curation-flag.js

@@ -0,0 +1,71 @@
+// Skill-curation feature flag — FORGE-S24-T12.
+//
+// Single source of truth for resolving `forgeCli.skillCuration.enabled`
+// from the layered config. The four SKILL-CURATION emission modules
+// (T08 skill-retriever, T09 skill-usage-tracker, T10 skill-curator-subagent,
+// T11 friction-emit) call `isSkillCurationEnabled()` at the top of their
+// public emission / dispatch entry points and no-op when it returns false.
+//
+// Resolution order (first match wins):
+//   1. Env override `FORGE_CLI_SKILL_CURATION_ENABLED` — accepts "1"/"true"
+//      (case-insensitive) for on, "0"/"false" for off. Provided primarily
+//      for unit tests and one-shot operator overrides; takes precedence
+//      over disk config so a poisoned config never blocks an operator
+//      from turning the flag on or off for a single session.
+//   2. Project config (`<cwd>/.pi/forge-cli/config.json`): `forgeCli.skillCuration.enabled`.
+//   3. Global config (`~/.pi/forge-cli/config.json`): `forgeCli.skillCuration.enabled`.
+//   4. Default: false (Iron Law — gated rollout per FORGE-S24-T12 AC2).
+//
+// Iron Laws (forge-cli-engineer):
+//   IL1  — code only under forge-cli/src/extensions/forgecli/
+//   IL2  — TypeScript; no runtime cast. The layered loader has already
+//          Ajv-validated the JSON against forge-cli-schema.json before
+//          we read it.
+//   IL7  — no silent continuation past failures: a malformed config is
+//          surfaced by `loadLayeredConfig().errors` upstream; this helper
+//          treats a missing/null layer as "no opinion" and falls through
+//          to the next layer (NOT as a silent off-default — the off-default
+//          is the explicit final step).
+import { loadLayeredConfig } from "./config-layer.js";
+const ENV_FLAG = "FORGE_CLI_SKILL_CURATION_ENABLED";
+/**
+ * Parse an env flag value to a tri-state: true / false / null (absent or
+ * unrecognised). Unrecognised values fall through to the disk layers — we
+ * do NOT throw or coerce to false silently.
+ */
+function parseEnvFlag(raw) {
+    if (raw === undefined)
+        return null;
+    const normalised = raw.trim().toLowerCase();
+    if (normalised === "1" || normalised === "true")
+        return true;
+    if (normalised === "0" || normalised === "false")
+        return false;
+    return null;
+}
+/**
+ * Resolve the SKILL-CURATION feature flag for the given working directory.
+ *
+ * Default OFF — the helper returns true only when an explicit `true` value
+ * is found in the env override or one of the config layers.
+ *
+ * `cwd` defaults to `process.cwd()` for production call sites; tests pass
+ * a temp dir to isolate filesystem state.
+ */
+export function isSkillCurationEnabled(cwd = process.cwd()) {
+    const envValue = parseEnvFlag(process.env[ENV_FLAG]);
+    if (envValue !== null)
+        return envValue;
+    const layered = loadLayeredConfig(cwd);
+    const projectFlag = layered.project?.forgeCli?.skillCuration?.enabled;
+    if (typeof projectFlag === "boolean")
+        return projectFlag;
+    const globalFlag = layered.global?.forgeCli?.skillCuration?.enabled;
+    if (typeof globalFlag === "boolean")
+        return globalFlag;
+    return false;
+}
+// Exposed for unit tests that want to assert env-parsing behaviour
+// without touching the disk layers.
+export const _internal = { parseEnvFlag, ENV_FLAG };
+//# sourceMappingURL=skill-curation-flag.js.map

package/dist/extensions/forgecli/skill-curation-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-curation-flag.js","sourceRoot":"","sources":["../../../src/extensions/forgecli/skill-curation-flag.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,EAAE;AACF,wEAAwE;AACxE,oEAAoE;AACpE,6EAA6E;AAC7E,yEAAyE;AACzE,2EAA2E;AAC3E,EAAE;AACF,uCAAuC;AACvC,4EAA4E;AAC5E,0EAA0E;AAC1E,wEAAwE;AACxE,sEAAsE;AACtE,6DAA6D;AAC7D,6FAA6F;AAC7F,wFAAwF;AACxF,wEAAwE;AACxE,EAAE;AACF,kCAAkC;AAClC,8DAA8D;AAC9D,uEAAuE;AACvE,uEAAuE;AACvE,uBAAuB;AACvB,uEAAuE;AACvE,0EAA0E;AAC1E,yEAAyE;AACzE,4EAA4E;AAC5E,wCAAwC;AAExC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,QAAQ,GAAG,kCAAkC,CAAC;AAEpD;;;;GAIG;AACH,SAAS,YAAY,CAAC,GAAuB;IAC5C,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACnC,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC;IAC/D,OAAO,IAAI,CAAC;AACb,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACjE,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IAEvC,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IAEvC,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC;IACtE,IAAI,OAAO,WAAW,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC;IAEzD,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,CAAC;IACpE,IAAI,OAAO,UAAU,KAAK,SAAS;QAAE,OAAO,UAAU,CAAC;IAEvD,OAAO,KAAK,CAAC;AACd,CAAC;AAED,mEAAmE;AACnE,oCAAoC;AACpC,MAAM,CAAC,MAAM,SAAS,GAAG,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC"}

package/dist/extensions/forgecli/skill-curator-subagent.d.ts

@@ -0,0 +1,101 @@
+import { type Static, Type } from "typebox";
+import { type ForgePersona } from "./forge-subagent.js";
+/**
+ * One retrieved skill (T08 output) supplied to the curator as context.
+ * `body` is the actual SKILL.md text the agent was shown during the task —
+ * the curator reads it to decide whether the skill needs updating.
+ */
+export declare const RetrievedSkillBodySchema: Type.TObject<{
+    skillId: Type.TString;
+    name: Type.TString;
+    body: Type.TString;
+}>;
+export type RetrievedSkillBody = Static<typeof RetrievedSkillBodySchema>;
+export declare const TaskOutcomeSchema: Type.TObject<{
+    verdict: Type.TUnion<[Type.TLiteral<"approved">, Type.TLiteral<"revision">, Type.TLiteral<"failed">, Type.TLiteral<"aborted">]>;
+    notes: Type.TOptional<Type.TString>;
+}>;
+export type TaskOutcome = Static<typeof TaskOutcomeSchema>;
+export declare const CuratorInputSchema: Type.TObject<{
+    sprintId: Type.TString;
+    taskId: Type.TString;
+    cwd: Type.TString;
+    ts: Type.TString;
+    trajectorySummary: Type.TString;
+    retrievedSkills: Type.TArray<Type.TObject<{
+        skillId: Type.TString;
+        name: Type.TString;
+        body: Type.TString;
+    }>>;
+    outcome: Type.TObject<{
+        verdict: Type.TUnion<[Type.TLiteral<"approved">, Type.TLiteral<"revision">, Type.TLiteral<"failed">, Type.TLiteral<"aborted">]>;
+        notes: Type.TOptional<Type.TString>;
+    }>;
+}>;
+export type CuratorInput = Static<typeof CuratorInputSchema>;
+/**
+ * The enhancement proposal schema accepted by this module — mirrors
+ * `forge/forge/schemas/proposal.schema.json` (the queue-drain contract).
+ * `op` is restricted to the canonical three-op enum; other fields are
+ * passed through verbatim if present.
+ *
+ * Strict on required keys (so malformed items are dropped), permissive on
+ * optional keys (so the curator can supply rationale, sourceFrictionIds,
+ * generated_at, etc., without us re-enumerating the entire schema here).
+ */
+declare const ProposalSchema: Type.TObject<{
+    op: Type.TUnion<[Type.TLiteral<"insert_skill">, Type.TLiteral<"update_skill">, Type.TLiteral<"delete_skill">]>;
+    target_path: Type.TString;
+    diff_body: Type.TString;
+    rationale: Type.TOptional<Type.TString>;
+    sourceFrictionIds: Type.TOptional<Type.TArray<Type.TString>>;
+    generated_at: Type.TOptional<Type.TString>;
+    sprintId: Type.TOptional<Type.TString>;
+    proposalId: Type.TOptional<Type.TString>;
+}>;
+export type Proposal = Static<typeof ProposalSchema>;
+export interface CuratorResult {
+    exitCode: 0 | 1;
+    written: number;
+    queueFile?: string;
+    errorMessage?: string;
+}
+/**
+ * Compose the first user message for the curator subagent. The body embeds
+ * the trajectory summary, retrieved-skill bodies, and task outcome, and
+ * instructs the curator to return zero or more proposals in a fenced JSON
+ * block. The schema is described inline so the curator does not need to
+ * read an external file.
+ */
+export declare function composeCuratorTask(input: CuratorInput): string;
+/**
+ * Pull zero or more proposals from the curator's final assistant text.
+ * Strategy: try fenced ```json blocks first (the requested format), then
+ * fall back to a bare JSON array scan. Items that fail TypeBox validation
+ * are dropped — the failure mode for ill-formed proposals is silent
+ * exclusion, not exception, because the curator's output is best-effort.
+ */
+export declare function parseProposalsFromOutput(text: string): Proposal[];
+/**
+ * Inline curator persona. We do NOT add a file under
+ * `forge/forge/meta/personas/` (Iron Law 1 — forge-cli only). The persona
+ * system prompt is small and self-contained; it tells the LLM to act as a
+ * skill curator and reiterates the output format and the no-write rule.
+ *
+ * The persona is exported so tests can introspect it; in production the
+ * defaultCuratorPersona() factory is consumed by runSkillCurator.
+ */
+export declare function defaultCuratorPersona(): ForgePersona;
+/**
+ * Run the per-task curator subagent and write its proposals to the
+ * enhancement-proposals queue. Always returns a typed result; never throws
+ * on subagent failure (IL7).
+ *
+ * Caller (orchestrator) is responsible for:
+ *   - assembling `retrievedSkills` from the T08 retriever's output;
+ *   - assembling `trajectorySummary` from the task transcript;
+ *   - emitting the canonical phase event AFTER this call returns,
+ *     using its own captured runtime telemetry (Slice 2 contract).
+ */
+export declare function runSkillCurator(input: CuratorInput): Promise<CuratorResult>;
+export {};