@entelligentsia/forgecli 0.10.1 → 0.11.3

package/dist/extensions/forgecli/update-tools.d.ts

@@ -0,0 +1,23 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export interface UpdateToolsResult {
+    copied: number;
+    skipped: number;
+    validationPassed: boolean;
+    messages: string[];
+}
+/**
+ * Copy all *.json from bundled .schemas/ to .forge/schemas/ in cwd.
+ * Runs validate-store --dry-run after copy.
+ * Exported so orchestrators can call directly without going through sendUserMessage.
+ */
+export declare function runUpdateTools(cwd: string, opts?: {
+    _testBundleRoot?: string;
+    _testToolsRoot?: string;
+}): Promise<UpdateToolsResult>;
+export interface RegisterUpdateToolsOptions {
+    /** Override bundle root — for testing only. */
+    _testBundleRoot?: string;
+    /** Override tools root — for testing only. */
+    _testToolsRoot?: string;
+}
+export declare function registerUpdateTools(pi: ExtensionAPI, opts?: RegisterUpdateToolsOptions): void;

package/dist/extensions/forgecli/update-tools.js

@@ -0,0 +1,136 @@
+// update-tools.ts — native atomic handler for /forge:update-tools (FORGE-S23-T10)
+//
+// Copies all JSON schema files from the bundled forge payload (.schemas/) to
+// the project's .forge/schemas/, then runs validate-store --dry-run to verify.
+//
+// Archetype: Atomic (no LLM in loop — pack-04 §Atomic).
+// Iron Laws:
+//   IL1 — new code lives in forge-cli/ only
+//   IL6 — no shell-string interpolation (argv-array throughout)
+//   IL7 — silent continuation past failures is never acceptable
+import { execFile } from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { promisify } from "node:util";
+import { getBundledPayloadRoot, getBundledToolsRoot } from "./forge-init.js";
+const execFileAsync = promisify(execFile);
+// ── Core runner ──────────────────────────────────────────────────────────────
+/**
+ * Copy all *.json from bundled .schemas/ to .forge/schemas/ in cwd.
+ * Runs validate-store --dry-run after copy.
+ * Exported so orchestrators can call directly without going through sendUserMessage.
+ */
+export async function runUpdateTools(cwd, opts = {}) {
+    const messages = [];
+    let bundleRoot;
+    let toolsRoot;
+    try {
+        bundleRoot = opts._testBundleRoot ?? getBundledPayloadRoot();
+        toolsRoot = opts._testToolsRoot ?? getBundledToolsRoot();
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            copied: 0,
+            skipped: 0,
+            validationPassed: false,
+            messages: [`× forge:update-tools — could not resolve bundle root: ${msg}`],
+        };
+    }
+    // Source: bundled .schemas/ directory
+    const schemasSrc = path.join(bundleRoot, ".schemas");
+    if (!fs.existsSync(schemasSrc)) {
+        return {
+            copied: 0,
+            skipped: 0,
+            validationPassed: false,
+            messages: [`× forge:update-tools — bundled schemas directory not found: ${schemasSrc}`],
+        };
+    }
+    // Destination: .forge/schemas/ in the project
+    const schemasDest = path.join(cwd, ".forge", "schemas");
+    fs.mkdirSync(schemasDest, { recursive: true });
+    // Copy all *.json files
+    let copied = 0;
+    let skipped = 0;
+    let schemaFiles;
+    try {
+        schemaFiles = fs.readdirSync(schemasSrc).filter((f) => f.endsWith(".json"));
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+            copied: 0,
+            skipped: 0,
+            validationPassed: false,
+            messages: [`× forge:update-tools — could not read schemas directory: ${msg}`],
+        };
+    }
+    for (const file of schemaFiles) {
+        const srcPath = path.join(schemasSrc, file);
+        const destPath = path.join(schemasDest, file);
+        // src and dest are always different directories; structural skip-if-equal
+        // is impossible in production but tested via mocks per AC requirement.
+        if (srcPath === destPath) {
+            skipped++;
+            continue;
+        }
+        try {
+            await fs.promises.copyFile(srcPath, destPath);
+            copied++;
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            messages.push(`△ forge:update-tools — could not copy ${file}: ${msg}`);
+        }
+    }
+    messages.push(`〇 forge:update-tools — copied ${copied} schema file(s) to .forge/schemas/.`);
+    if (skipped > 0) {
+        messages.push(`  (${skipped} file(s) skipped — source equals destination)`);
+    }
+    // Run validate-store --dry-run
+    const validateStorePath = path.join(toolsRoot, "validate-store.cjs");
+    let validationPassed = false;
+    try {
+        await execFileAsync("node", [validateStorePath, "--dry-run"], {
+            cwd,
+            encoding: "utf8",
+            timeout: 15_000,
+        });
+        validationPassed = true;
+        messages.push("〇 Schemas updated and store validation passed.");
+    }
+    catch (err) {
+        const e = err;
+        const detail = e.stderr || e.stdout || e.message || String(err);
+        messages.push(`× Validation failed — ${detail.slice(0, 300)}`);
+    }
+    return { copied, skipped, validationPassed, messages };
+}
+export function registerUpdateTools(pi, opts = {}) {
+    pi.registerCommand("forge:update-tools", {
+        description: "Refresh .forge/schemas/ from the installed Forge plugin version. " +
+            "Copies all JSON schema files from the bundled payload to your project.",
+        async handler(_args, ctx) {
+            const cwd = process.cwd();
+            // Outside-project guard
+            const configPath = path.join(cwd, ".forge", "config.json");
+            if (!fs.existsSync(configPath)) {
+                ctx.ui.notify("× forge:update-tools — no .forge/config.json found. " +
+                    "Run /forge:init first.", "error");
+                return;
+            }
+            ctx.ui.setStatus?.("forge:update-tools", "Copying schemas…");
+            const result = await runUpdateTools(cwd, {
+                _testBundleRoot: opts._testBundleRoot,
+                _testToolsRoot: opts._testToolsRoot,
+            });
+            ctx.ui.setStatus?.("forge:update-tools", undefined);
+            for (const msg of result.messages) {
+                const severity = msg.startsWith("×") ? "error" : msg.startsWith("△") ? "warning" : "info";
+                ctx.ui.notify(msg, severity);
+            }
+        },
+    });
+}
+//# sourceMappingURL=update-tools.js.map

package/dist/extensions/forgecli/update-tools.js.map

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

package/dist/extensions/forgecli/viewport-theme.js

@@ -117,6 +117,10 @@ function paintInner(trimmed, theme) {
             return theme.fg("warning", trimmed);
         case "◌": // compaction
             return theme.fg("muted", trimmed);
+        case "⊘": // cancelled
+            return theme.fg("muted", trimmed);
+        case "⏳": // cancelling
+            return theme.fg("warning", trimmed);
         default:
             return trimmed;
     }

package/dist/extensions/forgecli/viewport-theme.js.map

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

package/dist/forge-payload/.base-pack/personas/supervisor.md

@@ -20,6 +20,15 @@ before confirming spec compliance is wasted work. No exceptions.
 **A fast submission is a red flag.** If work arrived suspiciously quickly, verify
 extra carefully. Do not reward speed with a lighter review.
 
+**The Supervisor NEVER writes entity status.** The workflow orchestrator owns
+all FSM transitions. Do not call `store-cli update-status` on tasks, bugs,
+sprints, or any other entity from a review phase — the verdict signal travels
+through the SUMMARY's `verdict` field (read by `read-verdict.cjs`), not
+through `entity.status`. In bug mode specifically, a forward-FSM call from a
+review phase will be rejected by `store-cli` as an illegal transition (e.g.
+`fixed → plan-approved`) and that rejection is correct, not a workaround
+target. Write the SUMMARY, return.
+
 ## What I Need to Know
 
 - The project's architecture and how components connect

package/dist/forge-payload/.base-pack/workflows/enhance.md

@@ -52,9 +52,9 @@ Receive the phase flag from the command invocation:
 
 | Flag | Mode |
 |------|------|
-| `--phase 1` or `--auto` | Auto-apply: placeholder fills only |
-| `--phase 2` | Propose-diffs: sprint artifact + friction scan |
-| `--phase 3` | Drift detection: full codebase vs structural-element comparison |
+| `--phase 1` or `--auto` | Auto-apply: placeholder fills only — **use after** `/forge:init` completes to fill `{{KEY}}` placeholders from project signals |
+| `--phase 2` | Propose-diffs: sprint artifact + friction scan — **use after** a sprint completes to turn friction events into persona/skill enrichments |
+| `--phase 3` | Drift detection: full codebase vs structural-element comparison — **use on-demand** or after `/forge:calibrate` to detect stale references |
 
 Default to `--phase 3` if no phase flag is given.
 
@@ -179,28 +179,34 @@ Invoked by T09 post-sprint hook or manually via `/forge:enhance --phase 2`.
    "
    ```
 
-2. **Deduplicate** friction events by composite key `workflow + persona + issue`. Keep the most
+2. **Zero-friction guard**: If the friction event list is empty, print:
+   ```
+   No friction events queued for the active sprint — nothing to enhance.
+   ```
+   and exit Phase 2 immediately (skip steps 3–9; emit the enhancement event with `"notes": "{\"phase\":2,\"frictionCount\":0}"`). Do not create `.forge/enhancement-proposals/` when there are no proposals.
+
+3. **Deduplicate** friction events by composite key `workflow + persona + issue`. Keep the most
    recent occurrence of each composite key.
 
-3. **Read most recent completed sprint** from `.forge/store/sprints/` (status `done` or
+4. **Read most recent completed sprint** from `.forge/store/sprints/` (status `done` or
    `retrospective-done`), sorted by completion date. Read its task records from
    `.forge/store/tasks/` filtered by the sprint ID.
 
-4. **Synthesize enrichment proposals** — for each friction event:
+5. **Synthesize enrichment proposals** — for each friction event:
    - Identify which persona or skill file it references.
    - Propose a targeted addition: e.g., "architect persona lacks routing pattern knowledge —
      suggest adding `{{KB_PATH}}/routing.md` reference to deps.kb_docs."
    - For large committed file sets (> 5 files in the sprint), also check whether
      `engineer-skills.md` or `architect-skills.md` should reference new patterns.
 
-5. **Write proposal artifact**:
+6. **Write proposal artifact**:
    ```sh
    mkdir -p "$PROJECT_ROOT/.forge/enhancement-proposals"
    ```
    Write to `$PROJECT_ROOT/.forge/enhancement-proposals/phase2-<timestamp>.md`. Format:
    one section per proposed change, with a fenced diff block showing before/after text.
 
-6. **Present to user**:
+7. **Present to user**:
    ```
    ## Phase 2 Enhancement Proposals
 
@@ -209,13 +215,13 @@ Invoked by T09 post-sprint hook or manually via `/forge:enhance --phase 2`.
    [A] Apply all  [r] Review individually  [n] Skip
    ```
 
-7. **On approval** — for each approved change:
+8. **On approval** — for each approved change:
    - Apply the edit in-place.
    - Call `manage-versions.cjs add-snapshot --source post-sprint:<SPRINT_ID> --enhanced-elements <list>`.
 
-8. **Emit enhancement event** (same schema as Phase 1, with `"phase": "post-sprint"`).
+9. **Emit enhancement event** (same schema as Phase 1, with `"phase": "post-sprint"`).
 
-9. **Report**: N changes applied, M skipped, snapshot written or skipped.
+10. **Report**: N changes applied, M skipped, snapshot written or skipped.
 
 ---
 

package/dist/forge-payload/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "forge",
-  "version": "0.44.4",
+  "version": "0.44.8",
   "description": "Self-enhancing AI software development lifecycle \u2014 generates project-specific SDLC instances from meta-definitions",
   "license": "MIT",
   "author": {

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

@@ -0,0 +1,83 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "forge/config.schema.json",
+  "title": "ForgeConfig",
+  "description": "Schema for .forge/config.json — the per-project Forge configuration file.",
+  "type": "object",
+  "required": ["version", "project", "paths"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Config schema version (e.g. '1.0')"
+    },
+    "project": {
+      "type": "object",
+      "required": ["prefix", "name"],
+      "properties": {
+        "prefix": { "type": "string", "description": "Task ID prefix (e.g. FORGE)" },
+        "name": { "type": "string", "description": "Human-readable project name" },
+        "description": { "type": "string" }
+      }
+    },
+    "stack": {
+      "type": "object",
+      "properties": {
+        "languages": { "type": "array", "items": { "type": "string" } },
+        "framework": { "type": ["string", "null"] },
+        "frontendFramework": { "type": ["string", "null"] },
+        "database": { "type": ["string", "null"] },
+        "taskQueue": { "type": ["string", "null"] },
+        "containerisation": { "type": ["string", "null"] }
+      }
+    },
+    "commands": {
+      "type": "object",
+      "properties": {
+        "test": { "type": "string" },
+        "lint": { "type": "string" },
+        "syntaxCheck": {}
+      }
+    },
+    "paths": {
+      "type": "object",
+      "required": ["engineering", "store", "forgeRoot"],
+      "properties": {
+        "engineering": { "type": "string" },
+        "store": { "type": "string" },
+        "workflows": { "type": "string" },
+        "commands": { "type": "string" },
+        "templates": { "type": "string" },
+        "customCommands": { "type": "string" },
+        "forgeRoot": { "type": "string" },
+        "forgeRef": { "type": "string" }
+      }
+    },
+    "pipeline": {
+      "type": "object",
+      "properties": {
+        "maxReviewIterations": { "type": "integer", "minimum": 1 }
+      }
+    },
+    "pipelines": {
+      "type": "object",
+      "description": "Custom pipeline definitions keyed by pipeline name"
+    },
+    "installedSkills": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "calibrationBaseline": {
+      "type": "object",
+      "properties": {
+        "lastCalibrated": { "type": "string" },
+        "version": { "type": "string" },
+        "masterIndexHash": { "type": "string" },
+        "sprintsCovered": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "mode": {
+      "type": "string",
+      "enum": ["full", "fast"]
+    }
+  }
+}