@entelligentsia/forgecli 0.1.0 → 0.2.0

package/dist/extensions/forgecli/init-progress.js

@@ -0,0 +1,117 @@
+// init-progress.ts — read/write/delete .forge/init-progress.json
+//
+// Tracks the last completed phase of /forge:init so the command can resume
+// after an interrupted run. Implements stale-checkpoint detection to handle
+// legacy 12-phase checkpoint files from old forge plugin versions.
+//
+// Per INIT_PARITY_SPEC.md §4 and PLAN.md Phase B.
+import * as fs from "node:fs";
+import * as path from "node:path";
+const PROGRESS_FILENAME = ".forge/init-progress.json";
+function progressPath(cwd) {
+    return path.join(cwd, PROGRESS_FILENAME);
+}
+/**
+ * Read the init-progress checkpoint file.
+ *
+ * Returns:
+ *   - `{ kind: "none" }` — file does not exist
+ *   - `{ kind: "malformed" }` — file exists but JSON parse failed
+ *   - `{ kind: "stale", reason }` — file is a legacy 12-phase checkpoint
+ *   - `{ kind: "valid", progress }` — clean 4-phase checkpoint
+ */
+export function readInitProgress(cwd) {
+    const filePath = progressPath(cwd);
+    let raw;
+    try {
+        raw = fs.readFileSync(filePath, "utf8");
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT")
+            return { kind: "none" };
+        // Unreadable — treat as missing
+        return { kind: "none" };
+    }
+    let obj;
+    try {
+        obj = JSON.parse(raw);
+    }
+    catch {
+        return { kind: "malformed" };
+    }
+    if (!obj || typeof obj !== "object") {
+        return { kind: "malformed" };
+    }
+    const record = obj;
+    // Stale detection per spec §4:
+    // - lastPhase > 4 → old 12-phase run
+    // - contains "mode" key → old format
+    // - contains "phase-7-substep-map" key → old format
+    // - missing "timestamp" → corrupt / incomplete write
+    if ("mode" in record) {
+        return { kind: "stale", reason: 'contains "mode" field (legacy 12-phase format)' };
+    }
+    if ("phase-7-substep-map" in record) {
+        return { kind: "stale", reason: 'contains "phase-7-substep-map" field (legacy 12-phase format)' };
+    }
+    if (!("timestamp" in record)) {
+        return { kind: "stale", reason: 'missing "timestamp" field' };
+    }
+    const lastPhase = record.lastPhase;
+    if (typeof lastPhase !== "number" || !Number.isInteger(lastPhase)) {
+        return { kind: "malformed" };
+    }
+    if (lastPhase > 4) {
+        return { kind: "stale", reason: `lastPhase=${lastPhase} > 4 (legacy 12-phase run)` };
+    }
+    if (lastPhase < 1) {
+        return { kind: "malformed" };
+    }
+    const timestamp = record.timestamp;
+    if (typeof timestamp !== "string") {
+        return { kind: "malformed" };
+    }
+    return {
+        kind: "valid",
+        progress: {
+            lastPhase: lastPhase,
+            timestamp,
+        },
+    };
+}
+/**
+ * Write a progress checkpoint. Called at the end of each completed phase.
+ *
+ * @param cwd - project working directory
+ * @param lastPhase - completed phase number (1, 2, or 3; 4 is written then deleted)
+ * @param timestamp - ISO 8601 timestamp; defaults to now
+ */
+export function writeInitProgress(cwd, lastPhase, timestamp) {
+    const record = {
+        lastPhase,
+        timestamp: timestamp ?? new Date().toISOString(),
+    };
+    const filePath = progressPath(cwd);
+    // Ensure .forge/ dir exists before writing
+    fs.mkdirSync(path.dirname(filePath), { recursive: true });
+    fs.writeFileSync(filePath, JSON.stringify(record, null, 2) + "\n", "utf8");
+}
+/**
+ * Delete the init-progress checkpoint. Called at the end of Phase 4
+ * to signal successful completion.
+ */
+export function deleteInitProgress(cwd) {
+    const filePath = progressPath(cwd);
+    try {
+        fs.unlinkSync(filePath);
+    }
+    catch (err) {
+        const e = err;
+        // ENOENT is fine — file may not exist if phase was aborted before first write
+        if (e.code !== "ENOENT") {
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=init-progress.js.map

package/dist/extensions/forgecli/init-progress.js.map

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

package/dist/extensions/forgecli/refresh-kb-links.d.ts

@@ -0,0 +1,18 @@
+export interface RefreshKbLinksResult {
+    filesUpdated: number;
+    filesSkipped: number;
+    messages: string[];
+}
+/**
+ * Run the refresh-kb-links operation on the project at `cwd`.
+ *
+ * Returns a result record with counts and human-readable messages.
+ * Never throws — errors are captured as messages.
+ */
+export declare function runRefreshKbLinks(cwd: string): Promise<RefreshKbLinksResult>;
+/**
+ * Get a standalone refresh-kb-links handler suitable for direct invocation
+ * from Phase 4 step 4-9. Returns a function that takes cwd and calls
+ * runRefreshKbLinks.
+ */
+export declare function getRefreshKbLinksHandler(): (cwd: string) => Promise<RefreshKbLinksResult>;

package/dist/extensions/forgecli/refresh-kb-links.js

@@ -0,0 +1,228 @@
+// refresh-kb-links.ts — TypeScript port of forge/forge/skills/refresh-kb-links/SKILL.md
+//
+// Scans coding-agent instruction files (CLAUDE.md, AGENTS.md, etc.) and
+// ensures each has up-to-date managed sections linking to the Forge KB and
+// workflows. Called directly by Phase 4 step 4-9 (Tomoshibi) during
+// /forge:init and registered as the /forge:refresh-kb-links command handler.
+//
+// Per PLAN.md sub-decision #5 (F7 fix): TS port is the only valid implementation;
+// forge/forge/skills/refresh-kb-links/SKILL.md is a markdown body with no
+// runnable .cjs entry point.
+//
+// Iron Law 6: no shell-string interpolation.
+// Iron Law 1: reads .forge/config.json — no writes to forge/ source.
+import * as fs from "node:fs";
+import * as path from "node:path";
+// ── Known agent instruction files ─────────────────────────────────────────
+const AGENT_INSTRUCTION_FILES = [
+    "CLAUDE.md",
+    "AGENTS.md",
+    "AGENT.md",
+    "GEMINI.md",
+    ".cursorrules",
+    ".github/copilot-instructions.md",
+];
+// ── Known workflow files ───────────────────────────────────────────────────
+const WORKFLOW_ENTRIES = [
+    { file: "plan_task.md", label: "Plan", purpose: "Research codebase → implementation plan" },
+    { file: "implement_plan.md", label: "Implement", purpose: "Execute approved plan → code changes" },
+    { file: "fix_bug.md", label: "Fix bug", purpose: "Triage → fix → verify" },
+    {
+        file: "orchestrate_task.md",
+        label: "Run task",
+        purpose: "Full task pipeline (plan → implement → review → commit)",
+    },
+    { file: "run_sprint.md", label: "Run sprint", purpose: "Full sprint orchestration" },
+    { file: "architect_sprint_plan.md", label: "Sprint plan", purpose: "Sprint planning and task decomposition" },
+    {
+        file: "architect_sprint_intake.md",
+        label: "Sprint intake",
+        purpose: "Sprint intake and requirements elicitation",
+    },
+];
+// ── Managed section markers ────────────────────────────────────────────────
+const KB_OPEN_PREFIX = "<!-- forge-kb-links";
+const KB_CLOSE = "<!-- /forge-kb-links -->";
+const WF_OPEN_PREFIX = "<!-- forge-workflow-links";
+const WF_CLOSE = "<!-- /forge-workflow-links -->";
+// ── Content generators ─────────────────────────────────────────────────────
+function buildKbSection(cwd, kbPath) {
+    const rows = [
+        { label: "MASTER_INDEX", file: `${kbPath}/MASTER_INDEX.md`, desc: "All sprints, tasks, bugs, and features" },
+        {
+            label: "Architecture",
+            file: `${kbPath}/architecture/INDEX.md`,
+            desc: "Stack, processes, database, routing, deployment",
+        },
+        {
+            label: "Business Domain",
+            file: `${kbPath}/business-domain/INDEX.md`,
+            desc: "Entity model and domain concepts",
+        },
+    ].filter((r) => fs.existsSync(path.join(cwd, r.file)));
+    if (rows.length === 0)
+        return "";
+    const tableRows = rows.map((r) => `| [${r.label}](${r.file}) | ${r.desc} |`).join("\n");
+    return [
+        `<!-- forge-kb-links: managed by Forge — do not edit manually -->`,
+        `## Forge Knowledge Base`,
+        ``,
+        `| Index | Contents |`,
+        `|-------|----------|`,
+        tableRows,
+        ``,
+        `Personas live in \`.forge/personas/\`.`,
+        KB_CLOSE,
+    ].join("\n");
+}
+function buildWorkflowSection(cwd) {
+    const rows = WORKFLOW_ENTRIES.filter((e) => fs.existsSync(path.join(cwd, ".forge", "workflows", e.file)));
+    if (rows.length === 0)
+        return "";
+    const tableRows = rows.map((e) => `| [${e.label}](.forge/workflows/${e.file}) | ${e.purpose} |`).join("\n");
+    return [
+        `<!-- forge-workflow-links: managed by Forge — do not edit manually -->`,
+        `## Forge Workflows`,
+        ``,
+        `| Workflow | Purpose |`,
+        `|----------|---------|`,
+        tableRows,
+        WF_CLOSE,
+    ].join("\n");
+}
+// ── Section replacement ────────────────────────────────────────────────────
+/**
+ * Replace or append a managed section in a file's content.
+ * If the section already exists (detected by open-prefix), replaces it.
+ * Otherwise, appends it to the end.
+ */
+function upsertSection(content, openPrefix, closeMarker, newSection) {
+    if (!newSection)
+        return content; // nothing to inject
+    // Find existing section
+    const openIdx = content.indexOf(openPrefix);
+    if (openIdx !== -1) {
+        const closeIdx = content.indexOf(closeMarker, openIdx);
+        if (closeIdx !== -1) {
+            const endIdx = closeIdx + closeMarker.length;
+            // Replace existing section
+            return content.slice(0, openIdx) + newSection + content.slice(endIdx);
+        }
+    }
+    // Append at end, ensuring a blank line separator
+    const trimmed = content.trimEnd();
+    return trimmed + "\n\n" + newSection + "\n";
+}
+// ── Main exported function ─────────────────────────────────────────────────
+/**
+ * Run the refresh-kb-links operation on the project at `cwd`.
+ *
+ * Returns a result record with counts and human-readable messages.
+ * Never throws — errors are captured as messages.
+ */
+export async function runRefreshKbLinks(cwd) {
+    const result = {
+        filesUpdated: 0,
+        filesSkipped: 0,
+        messages: [],
+    };
+    // Read kbPath from .forge/config.json
+    let kbPath = "engineering";
+    try {
+        const configRaw = fs.readFileSync(path.join(cwd, ".forge", "config.json"), "utf8");
+        const config = JSON.parse(configRaw);
+        const paths = config.paths;
+        if (paths && typeof paths.engineering === "string" && paths.engineering) {
+            kbPath = paths.engineering;
+        }
+    }
+    catch {
+        // Config not present — use default kbPath
+    }
+    const kbSection = buildKbSection(cwd, kbPath);
+    const wfSection = buildWorkflowSection(cwd);
+    if (!kbSection && !wfSection) {
+        result.messages.push("△ refresh-kb-links: no KB or workflow files found to link.");
+        return result;
+    }
+    for (const filename of AGENT_INSTRUCTION_FILES) {
+        const filePath = path.join(cwd, filename);
+        let content;
+        try {
+            content = fs.readFileSync(filePath, "utf8");
+        }
+        catch {
+            // File does not exist — skip
+            result.filesSkipped++;
+            continue;
+        }
+        let updated = content;
+        if (kbSection) {
+            updated = upsertSection(updated, KB_OPEN_PREFIX, KB_CLOSE, kbSection);
+        }
+        if (wfSection) {
+            updated = upsertSection(updated, WF_OPEN_PREFIX, WF_CLOSE, wfSection);
+        }
+        if (updated !== content) {
+            try {
+                fs.writeFileSync(filePath, updated, "utf8");
+                result.filesUpdated++;
+                result.messages.push(`〇 refresh-kb-links: updated ${filename}`);
+            }
+            catch (err) {
+                const e = err;
+                result.messages.push(`△ refresh-kb-links: failed to write ${filename}: ${e.message ?? "unknown"}`);
+            }
+        }
+        else {
+            result.filesSkipped++;
+        }
+    }
+    // Handle .cursor/rules/*.mdc files
+    const cursorRulesDir = path.join(cwd, ".cursor", "rules");
+    if (fs.existsSync(cursorRulesDir)) {
+        try {
+            const mdcFiles = fs.readdirSync(cursorRulesDir).filter((f) => f.endsWith(".mdc"));
+            for (const mdcFile of mdcFiles) {
+                const filePath = path.join(cursorRulesDir, mdcFile);
+                let content;
+                try {
+                    content = fs.readFileSync(filePath, "utf8");
+                }
+                catch {
+                    result.filesSkipped++;
+                    continue;
+                }
+                let updated = content;
+                if (kbSection) {
+                    updated = upsertSection(updated, KB_OPEN_PREFIX, KB_CLOSE, kbSection);
+                }
+                if (wfSection) {
+                    updated = upsertSection(updated, WF_OPEN_PREFIX, WF_CLOSE, wfSection);
+                }
+                if (updated !== content) {
+                    fs.writeFileSync(filePath, updated, "utf8");
+                    result.filesUpdated++;
+                    result.messages.push(`〇 refresh-kb-links: updated .cursor/rules/${mdcFile}`);
+                }
+                else {
+                    result.filesSkipped++;
+                }
+            }
+        }
+        catch {
+            // Skip if unreadable
+        }
+    }
+    return result;
+}
+// ── Handler factory ────────────────────────────────────────────────────────
+/**
+ * Get a standalone refresh-kb-links handler suitable for direct invocation
+ * from Phase 4 step 4-9. Returns a function that takes cwd and calls
+ * runRefreshKbLinks.
+ */
+export function getRefreshKbLinksHandler() {
+    return runRefreshKbLinks;
+}
+//# sourceMappingURL=refresh-kb-links.js.map

package/dist/extensions/forgecli/refresh-kb-links.js.map

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

package/dist/forge-payload/.base-pack/commands/approve.md

@@ -0,0 +1,22 @@
+---
+name: approve
+description: Final architect approval gate for a completed task
+---
+
+# /{{PREFIX}}:approve
+
+Read the approve workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/architect_approve.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/collate.md

@@ -0,0 +1,22 @@
+---
+name: collate
+description: Regenerate KB documents from the JSON store
+---
+
+# /{{PREFIX}}:collate
+
+Read the collate workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/collator_agent.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/commit.md

@@ -0,0 +1,22 @@
+---
+name: commit
+description: Stage and commit completed task artifacts
+---
+
+# /{{PREFIX}}:commit
+
+Read the commit workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/commit_task.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

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

@@ -0,0 +1,37 @@
+---
+name: enhance
+description: Progressive project-specific enrichment of structural elements
+---
+
+# /{{PREFIX}}:enhance
+
+Run the enhancement agent to enrich structural elements with project-specific knowledge.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Purpose
+
+The enhancement agent observes the project and enriches structural elements
+over time. It makes absolutely essential minimal modifications, preferring
+runtime mix-in (KB references, `{{placeholder}}` substitution, `project-context.json`)
+over modifying base artifacts.
+
+## Behavior
+
+1. Read `structure-versions.json` to determine current overlay level
+2. Read `project-context.json` for current project specifics
+3. Read KB changes since last enhancement
+4. Scan codebase for patterns discovered since last enhancement
+5. Compare current `.forge/` artifacts against base-pack baseline
+6. For each artifact, determine what project-specific enrichment is warranted
+7. Apply the minimal modification principle
+8. Propose diffs (Phase 2+) or auto-apply (Phase 1)
+9. Create new overlay version in `structure-versions.json` if needed
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/fix-bug.md

@@ -0,0 +1,22 @@
+---
+name: fix-bug
+description: Triage, diagnose, and fix a bug
+---
+
+# /{{PREFIX}}:fix-bug
+
+Read the fix-bug workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/fix_bug.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/implement.md

@@ -0,0 +1,22 @@
+---
+name: implement
+description: Execute the approved implementation plan for a task
+---
+
+# /{{PREFIX}}:implement
+
+Read the implement workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/implement_plan.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/plan.md

@@ -0,0 +1,22 @@
+---
+name: plan
+description: Design and document the implementation plan for a task
+---
+
+# /{{PREFIX}}:plan
+
+Read the plan workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/plan_task.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/quiz-agent.md

@@ -0,0 +1,22 @@
+---
+name: quiz-agent
+description: Verify an agent has loaded and understood the project knowledge base
+---
+
+# /{{PREFIX}}:quiz-agent
+
+Read the quiz-agent workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/quiz_agent.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/retrospective.md

@@ -0,0 +1,22 @@
+---
+name: retrospective
+description: Produce sprint retrospective and lessons-learned document
+---
+
+# /{{PREFIX}}:retrospective
+
+Read the retrospective workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/sprint_retrospective.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/review-code.md

@@ -0,0 +1,22 @@
+---
+name: review-code
+description: Code quality review of a completed task implementation
+---
+
+# /{{PREFIX}}:review-code
+
+Read the review-code workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/review_code.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/review-plan.md

@@ -0,0 +1,22 @@
+---
+name: review-plan
+description: Architectural review of a task implementation plan
+---
+
+# /{{PREFIX}}:review-plan
+
+Read the review-plan workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/review_plan.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS

package/dist/forge-payload/.base-pack/commands/run-sprint.md

@@ -0,0 +1,22 @@
+---
+name: run-sprint
+description: Execute all tasks in a sprint (sequential or parallel)
+---
+
+# /{{PREFIX}}:run-sprint
+
+Read the run-sprint workflow and follow it.
+
+## Locate the Forge plugin
+
+```
+FORGE_ROOT: !`echo "${CLAUDE_PLUGIN_ROOT}"`
+```
+
+## Execute
+
+Read `.forge/workflows/run_sprint.md` and follow it.
+
+## Arguments
+
+$ARGUMENTS