@entelligentsia/forgecli 1.0.21 → 1.0.25

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

@@ -1,27 +0,0 @@
-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 EnhancePhase = 1 | 2 | 3;
-export interface ParsedArgs {
-    phase: EnhancePhase;
-    extra: string;
-    rawPhaseFlag: string;
-}
-export declare function parseEnhanceArgs(rawArgs: string): ParsedArgs;
-export interface ComposeKickoffOpts {
-    workflowMd: string;
-    personaIdentity: string;
-    parsed: ParsedArgs;
-    cwd: string;
-    timestamp: string;
-}
-export declare function composeKickoff(opts: ComposeKickoffOpts): string;
-export declare function defaultNow(): Date;
-export declare function formatTimestamp(d: Date): string;
-export interface RegisterEnhanceOptions {
-    cwd?: string;
-    now?: () => Date;
-}
-export declare function registerEnhance(pi: ExtensionAPI, options?: RegisterEnhanceOptions): void;

package/dist/extensions/forgecli/enhance.js

@@ -1,199 +0,0 @@
-// forge:enhance — Phase-2 native kickoff handler (FORGE-S20-T04).
-//
-// Replaces the post-S17 sentinel-writing stub registered in forge-commands.ts.
-// The handler is a thin kickoff shim per Pack-04 + Pack-06:
-//   1. Reads `.forge/workflows/enhance.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 a 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, phase-specific
-//      dispatch instruction, the workflow body verbatim, and any free-form
-//      argv tail.
-//   5. Hands control to the LLM via `sendKickoff(pi, text)` —
-//      `deliverAs: "steer"`. Never raw `pi.sendUserMessage`.
-//
-// Phase 2 (default) directs the LLM to read friction events ONLY through
-// `forge_store_query` (Pack-06 Read/Write/Ask/Store discipline) and to write
-// proposals to `engineering/enhancement-proposals/phase2-<timestamp>.md`. If
-// zero friction events exist, the LLM emits a notice and writes no file.
-//
-// Phases 1 and 3 are forwarded with the workflow's own dispatch text.
-//
-// 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 path from "node:path";
-import { assertAudience } from "./audience-gate.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 { 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 };
-const VALID_PHASES = new Set([1, 2, 3]);
-export function parseEnhanceArgs(rawArgs) {
-    const trimmed = (rawArgs ?? "").trim();
-    if (trimmed === "") {
-        return { phase: 2, extra: "", rawPhaseFlag: "" };
-    }
-    const tokens = trimmed.split(/\s+/);
-    let phase = 2;
-    let rawPhaseFlag = "";
-    const tail = [];
-    for (let i = 0; i < tokens.length; i++) {
-        const tok = tokens[i];
-        if (tok === "--auto") {
-            phase = 1;
-            rawPhaseFlag = "--auto";
-            continue;
-        }
-        if (tok === "--phase") {
-            const next = tokens[i + 1];
-            if (next === undefined) {
-                throw new Error("invalid --phase value: missing argument");
-            }
-            const n = Number(next);
-            if (!Number.isInteger(n) || !VALID_PHASES.has(n)) {
-                throw new Error(`invalid --phase value: ${JSON.stringify(next)} (expected 1, 2, or 3)`);
-            }
-            phase = n;
-            rawPhaseFlag = `--phase ${next}`;
-            i += 1;
-            continue;
-        }
-        const eqMatch = /^--phase=(.+)$/.exec(tok);
-        if (eqMatch) {
-            const n = Number(eqMatch[1]);
-            if (!Number.isInteger(n) || !VALID_PHASES.has(n)) {
-                throw new Error(`invalid --phase value: ${JSON.stringify(eqMatch[1])} (expected 1, 2, or 3)`);
-            }
-            phase = n;
-            rawPhaseFlag = tok;
-            continue;
-        }
-        tail.push(tok);
-    }
-    return { phase, extra: tail.join(" "), rawPhaseFlag };
-}
-export function composeKickoff(opts) {
-    const { workflowMd, personaIdentity, parsed, timestamp } = opts;
-    const sections = [`# /forge:enhance --phase ${parsed.phase}`, ""];
-    if (personaIdentity.trim().length > 0) {
-        sections.push(personaIdentity.trim(), "");
-    }
-    if (parsed.phase === 2) {
-        const proposalRel = path.posix.join("engineering", "enhancement-proposals", `phase2-${timestamp}.md`);
-        sections.push("## Dispatch — Phase 2 (post-sprint propose-diffs)", "", "Run the workflow below. Specifically:", "", "1. Discover friction events. **Preferred**: `forge_store_query` with `{command:'nlp', args:['events where type=friction']}`. **If that returns zero or a suspiciously low count** (the underlying NLP engine uses keyword heuristics that can miss events), **fall back to the workflow body's filesystem walk** (`meta-enhance.md` Step 1's JS one-liner: read `.forge/store/events/**/*.json`, filter `e => e && e.type === 'friction'`). The fs-walk filter is the source of truth on `type`; the MCP query is a convenience layer over it. Use whichever surfaces the events.", `2. If at least one friction event is present (from either path), synthesize concrete enrichment proposals per the workflow's Phase 2 algorithm, then write them via the \`write\` tool to \`${proposalRel}\` (one section per proposed change, with a fenced diff block showing before/after).`, "3. If genuinely zero friction events are present (both the MCP query AND the fs-walk return empty), emit an explicit notice — `〇 no friction events present — Phase 2 produces no proposals` — and write NO proposal file. Empty artifacts are not acceptable.", "4. Honour the Pack-06 Read/Write/Ask/Store discipline: store writes go via the `forge_store` MCP tool with `{command:'write', args:['<entity>','<json>']}` (2-positional, id INSIDE json); never raw-write `.forge/store/`. Do NOT bash-shell `forge store ...`.", "5. **VERIFY after apply — MANDATORY (forge-cli#31)**: After applying enhancement edits via Edit/Write, BEFORE calling add-snapshot, you MUST call `forge_verify_apply` with the list of claimed file paths. The tool runs `generation-manifest check` on each and returns four buckets: `modified` (verified ✓), `unchanged` (your Edit silently no-op'd — usually an `old_string` whitespace/punctuation mismatch), `untracked` (no manifest entry — treat as potentially modified), `missing` (file gone). **If `unchanged.length > 0`**, you MUST re-apply those edits via Edit/Write and call `forge_verify_apply` again — repeat until `unchanged` is empty. **Do NOT proceed to add-snapshot until every claimed file is in `modified` or `untracked`.** This guard exists because agents historically claim 'Files Modified' in their UI reports while the actual disk content is unchanged; without it the next `/forge:regenerate` overwrites stale state and replay restores nothing.", '6. **Snapshot after verify (forge#107 / forge-cli#30)**: Once `forge_verify_apply` reports no `unchanged` files, MUST call `manage-versions add-snapshot` via bash to capture the verified edits into `.forge/archive/snap-N/`. Without this, the next `/forge:regenerate` cannot restore via replay. Format:\n   ```sh\n   node "$FORGE_ROOT/tools/manage-versions.cjs" add-snapshot --source post-sprint:<SPRINT_ID> --enhanced-elements "<comma-separated paths, e.g. .forge/personas/architect.md,.forge/skills/engineer-skills.md>"\n   ```\n   `$FORGE_ROOT` is exported into the bash environment — see the orientation block above for its resolved value. After add-snapshot, verify success by checking `.forge/structure-versions.json`\'s `currentSnapshot` advanced and `ls .forge/archive/snap-N/` is non-empty.');
-    }
-    else if (parsed.phase === 1) {
-        sections.push("## Dispatch — Phase 1 (post-init auto-apply placeholder fills)", "", "Run the workflow's Phase 1 algorithm verbatim. Apply only high-confidence placeholder fills; list low-confidence keys without substituting.");
-    }
-    else {
-        sections.push("## Dispatch — Phase 3 (drift detection)", "", "Run the workflow's Phase 3 algorithm verbatim. Compare codebase state against structural-element knowledge and write the drift report to `.forge/enhancement-proposals/phase3-<timestamp>.md`.");
-    }
-    sections.push("", "---", "", "## Workflow", "", workflowMd.trim(), "", "---");
-    if (parsed.extra.trim().length > 0) {
-        sections.push("", "## Additional context", "", parsed.extra.trim());
-    }
-    return sections.join("\n");
-}
-// Timestamp helper ---------------------------------------------------------
-export function defaultNow() {
-    return new Date();
-}
-export function formatTimestamp(d) {
-    const pad = (n, w = 2) => String(n).padStart(w, "0");
-    return (`${d.getUTCFullYear()}${pad(d.getUTCMonth() + 1)}${pad(d.getUTCDate())}` +
-        "T" +
-        `${pad(d.getUTCHours())}${pad(d.getUTCMinutes())}${pad(d.getUTCSeconds())}Z`);
-}
-// Registration -------------------------------------------------------------
-const WORKFLOW_REL_PATH = path.join(".forge", "workflows", "enhance.md");
-export function registerEnhance(pi, options = {}) {
-    pi.registerCommand("forge:enhance", {
-        description: "Progressive project-specific enrichment of structural elements. " +
-            "Usage: /forge:enhance [--phase 1|2|3 | --auto] [free-form context]. " +
-            "Default phase: 2 (post-sprint propose-diffs).",
-        async handler(args, ctx) {
-            const cwd = options.cwd ?? process.cwd();
-            const workflowPath = path.join(cwd, WORKFLOW_REL_PATH);
-            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:enhance — workflow not found at ${WORKFLOW_REL_PATH}; run /forge:init or /forge:rebuild first.`, "error");
-                    }
-                    else {
-                        ctx.ui.notify(`× forge:enhance — workflow load failed (${err.code}): ${err.message}`, "error");
-                    }
-                    return;
-                }
-                const e = err;
-                ctx.ui.notify(`× forge:enhance — failed to read workflow: ${e.message ?? "unknown"}`, "error");
-                return;
-            }
-            let parsed;
-            try {
-                parsed = parseEnhanceArgs(args);
-            }
-            catch (err) {
-                const e = err;
-                ctx.ui.notify(`× forge:enhance — ${e.message ?? "argv parse failed"}`, "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:enhance — persona '${personas[0]}' load failed (${err.code}): ${err.message}`, "error");
-                        return;
-                    }
-                    const e = err;
-                    ctx.ui.notify(`× forge:enhance — persona load error: ${e.message ?? "unknown"}`, "error");
-                    return;
-                }
-            }
-            if (!assertAudience({ workflowName: "enhance", audience: workflowAudience }, ctx)) {
-                return;
-            }
-            const now = options.now ?? defaultNow;
-            const timestamp = formatTimestamp(now());
-            const kickoff = composeKickoff({
-                workflowMd,
-                personaIdentity,
-                parsed,
-                cwd,
-                timestamp,
-            });
-            sendKickoff(pi, kickoff);
-        },
-    });
-}
-//# sourceMappingURL=enhance.js.map

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

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

package/dist/extensions/forgecli/fix-bug.d.ts

@@ -1,85 +0,0 @@
-import type { ExtensionAPI, ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
-import { type ForgeToolDefs } from "./forge-tools.js";
-import { type PhaseDescriptor } from "./run-task.js";
-import { getSessionRegistry } from "./session-registry.js";
-export declare const BUG_PHASES: PhaseDescriptor[];
-export { BUG_SUMMARY_KEY_BY_ROLE } from "./subagent/phase-summary-map.js";
-export declare const BUG_TYPE_TOKENS: Record<string, {
-    pass: string;
-    fail: string;
-}>;
-export interface RunBugState {
-    bugId: string;
-    phaseIndex: number;
-    iterationCounts: Record<string, number>;
-    halted: boolean;
-    /** Set on cancellation so the resume prompt says "cancelled" vs "halted". */
-    status?: "cancelled" | "halted" | "running";
-    lastError?: string;
-    savedAt: string;
-}
-export declare function readBugState(cwd: string, bugId: string, sessionId?: string): RunBugState | null;
-export declare function writeBugState(cwd: string, state: RunBugState): void;
-export declare function deleteBugState(cwd: string, bugId: string): void;
-export declare function isBugStateStale(state: RunBugState): boolean;
-export interface BugRecord {
-    bugId?: string;
-    status?: string;
-    summaries?: Record<string, unknown>;
-    [key: string]: unknown;
-}
-export declare function readBugRecord(bugId: string, storeCli: string, cwd: string): BugRecord | null;
-export declare function assignNextBugId(storeCli: string, cwd: string): string;
-export declare function preCreateBug(bugId: string, title: string, storeCli: string, cwd: string): boolean;
-type BugVerdict = "approved" | "revision" | "n/a" | "missing";
-export declare function readBugVerdict(bugRecord: BugRecord | null, phaseRole: string, summaryKeyByRole: Record<string, string | null>): BugVerdict;
-export declare function composeBugBody(subWorkflowMd: string, bugId: string, phaseRole: string, bugStatusBeforePhase?: string, summariesBlock?: string): string;
-/**
- * Scan tool_execution_end events to extract the bugId written by a triage
- * subagent. Returns the LAST matching tool call's bugId, or null if none found.
- *
- * In pi runtime, the forge_store tool is registered as "forge_store" (not
- * "store-cli"). In Claude Code runtime, subagents may shell out via Bash.
- * This function covers all three paths.
- */
-export declare function extractBugIdFromEvents(events: Array<{
-    toolName?: string;
-    result?: unknown;
-}>): string | null;
-export type RunBugPipelineStatus = "completed" | "halted" | "escalated" | "failed" | "cancelled";
-export interface RunBugPipelineResult {
-    status: RunBugPipelineStatus;
-    lastPhaseIndex: number;
-    iterationCounts: Record<string, number>;
-    lastError?: string;
-    model?: string;
-    provider?: string;
-}
-export interface RunBugPipelineOptions {
-    bugId: string;
-    /** Original free-form text argument when creating a new bug (not a FORGE-BUG-NNN ID).
-     *  Passed to triage-phase subagent so it can create the bug with a meaningful description. */
-    originalArg?: string;
-    /** Whether this is a new bug (free-form text) vs. an existing FORGE-BUG-NNN ID. */
-    isNewBug?: boolean;
-    cwd: string;
-    ctx: ExtensionCommandContext;
-    forgeRoot: string;
-    storeCli: string;
-    preflightGate: string;
-    registry: ReturnType<typeof getSessionRegistry>;
-    resumeFromState?: RunBugState;
-    /**
-     * Optional AbortSignal from SessionRegistry. When provided, the pipeline
-     * checks signal.aborted between phases and passes the signal to
-     * runForgeSubagent so in-flight subagents can be aborted.
-     */
-    signal?: AbortSignal;
-    forgeToolDefs?: ForgeToolDefs;
-}
-export declare function runBugPipeline(opts: RunBugPipelineOptions): Promise<RunBugPipelineResult>;
-export interface RegisterFixBugOptions {
-    cwd?: string;
-    forgeToolDefs?: ForgeToolDefs;
-}
-export declare function registerFixBug(pi: ExtensionAPI, options?: RegisterFixBugOptions): void;