@entelligentsia/forgecli 1.0.25 → 1.0.36

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

@@ -0,0 +1,37 @@
+export declare const CACHE_TTL_MS: number;
+export interface UpdateCheckOptions {
+    notify(message: string, level: "info" | "warning" | "error"): void;
+    currentCliVersion: string;
+    currentBundledForgeVersion: string;
+    now?: () => number;
+    fetchImpl?: typeof fetch;
+    cacheDir?: string;
+}
+export interface UpdateBannerCache {
+    lastProbeAt: number;
+    latestNpmVersion: string | null;
+    latestForgeVersion: string | null;
+    dismissedNpmVersions: string[];
+    dismissedForgeVersions: string[];
+}
+declare function cachePath(cacheDir: string): string;
+declare function readCache(cacheDir: string): Promise<UpdateBannerCache | null>;
+declare function writeCache(cacheDir: string, cache: UpdateBannerCache): Promise<void>;
+declare function semverGt(a: string, b: string): boolean;
+declare function composeBanner(npm: {
+    current: string;
+    latest: string;
+} | null, forge: {
+    current: string;
+    latest: string;
+} | null): string | null;
+export declare function triggerUpdateCheck(opts: UpdateCheckOptions): Promise<void>;
+export declare const __test__: {
+    CACHE_TTL_MS: number;
+    cachePath: typeof cachePath;
+    readCache: typeof readCache;
+    writeCache: typeof writeCache;
+    semverGt: typeof semverGt;
+    composeBanner: typeof composeBanner;
+};
+export {};

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

@@ -0,0 +1,185 @@
+// Update-check probe + banner — FORGE-S16-T14 (issue #18, part 1).
+//
+// Dual-probe (npm registry + Entelligentsia/forge GitHub releases) with a
+// 24h TTL, per-version dismissal cache, and `FORGE_NO_UPDATE_CHECK=1`
+// opt-out. This is the only outbound HTTP traffic forgecli performs (Q21).
+// All failures are fail-silent on the user surface; debug output requires
+// FORGE_DEBUG_UPDATE_CHECK=1.
+import { promises as fs } from "node:fs";
+import * as path from "node:path";
+import { getUserCacheDir } from "./paths/paths.js";
+export const CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+const PROBE_TIMEOUT_MS = 5000;
+const NPM_URL = "https://registry.npmjs.org/@entelligentsia/forgecli";
+const GH_RELEASES_URL = "https://api.github.com/repos/Entelligentsia/forge/releases/latest";
+function defaultCacheDir() {
+    return getUserCacheDir();
+}
+function cachePath(cacheDir) {
+    return path.join(cacheDir, "update-banner.json");
+}
+async function readCache(cacheDir) {
+    try {
+        const raw = await fs.readFile(cachePath(cacheDir), "utf8");
+        const parsed = JSON.parse(raw);
+        return {
+            lastProbeAt: typeof parsed.lastProbeAt === "number" ? parsed.lastProbeAt : 0,
+            latestNpmVersion: typeof parsed.latestNpmVersion === "string" ? parsed.latestNpmVersion : null,
+            latestForgeVersion: typeof parsed.latestForgeVersion === "string" ? parsed.latestForgeVersion : null,
+            dismissedNpmVersions: Array.isArray(parsed.dismissedNpmVersions)
+                ? parsed.dismissedNpmVersions.filter((v) => typeof v === "string")
+                : [],
+            dismissedForgeVersions: Array.isArray(parsed.dismissedForgeVersions)
+                ? parsed.dismissedForgeVersions.filter((v) => typeof v === "string")
+                : [],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function writeCache(cacheDir, cache) {
+    await fs.mkdir(cacheDir, { recursive: true });
+    const final = cachePath(cacheDir);
+    const tmp = `${final}.${process.pid}.${Date.now()}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(cache, null, 2), "utf8");
+    await fs.rename(tmp, final);
+}
+function parseTriple(v) {
+    const cleaned = v.startsWith("v") ? v.slice(1) : v;
+    const parts = cleaned.split(".");
+    if (parts.length !== 3)
+        return null;
+    const nums = [];
+    for (const p of parts) {
+        if (!/^\d+$/.test(p))
+            return null;
+        nums.push(Number.parseInt(p, 10));
+    }
+    return [nums[0], nums[1], nums[2]];
+}
+function semverGt(a, b) {
+    const pa = parseTriple(a);
+    const pb = parseTriple(b);
+    if (!pa || !pb)
+        return false;
+    for (let i = 0; i < 3; i++) {
+        if (pa[i] > pb[i])
+            return true;
+        if (pa[i] < pb[i])
+            return false;
+    }
+    return false;
+}
+function debug(...args) {
+    if (process.env.FORGE_DEBUG_UPDATE_CHECK === "1") {
+        console.error("[forge-cli update-check]", ...args);
+    }
+}
+async function probeNpm(fetchImpl) {
+    const ctl = new AbortController();
+    const t = setTimeout(() => ctl.abort(), PROBE_TIMEOUT_MS);
+    try {
+        const res = await fetchImpl(NPM_URL, { signal: ctl.signal, headers: { Accept: "application/json" } });
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        const tag = body["dist-tags"]?.latest;
+        return typeof tag === "string" ? tag : null;
+    }
+    catch (err) {
+        debug("npm probe failed:", err);
+        return null;
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+async function probeForge(fetchImpl) {
+    const ctl = new AbortController();
+    const t = setTimeout(() => ctl.abort(), PROBE_TIMEOUT_MS);
+    try {
+        const res = await fetchImpl(GH_RELEASES_URL, {
+            signal: ctl.signal,
+            headers: { Accept: "application/vnd.github+json" },
+        });
+        if (!res.ok)
+            return null;
+        const body = (await res.json());
+        if (typeof body.tag_name !== "string")
+            return null;
+        return body.tag_name.startsWith("v") ? body.tag_name.slice(1) : body.tag_name;
+    }
+    catch (err) {
+        debug("github releases probe failed:", err);
+        return null;
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+function composeBanner(npm, forge) {
+    const lines = [];
+    if (npm) {
+        lines.push(`forge-cli: update available — ${npm.current} → ${npm.latest} (run \`forge update\` or \`npm i -g @entelligentsia/forgecli@${npm.latest}\`)`);
+    }
+    if (forge) {
+        lines.push(`forge plugin: update available — ${forge.current} → ${forge.latest} (run /forge:update for migration guide)`);
+    }
+    return lines.length > 0 ? lines.join("\n") : null;
+}
+export async function triggerUpdateCheck(opts) {
+    if (process.env.FORGE_NO_UPDATE_CHECK === "1")
+        return;
+    const now = opts.now ?? (() => Date.now());
+    const fetchImpl = opts.fetchImpl ?? fetch;
+    const cacheDir = opts.cacheDir ?? defaultCacheDir();
+    let cache = (await readCache(cacheDir)) ?? {
+        lastProbeAt: 0,
+        latestNpmVersion: null,
+        latestForgeVersion: null,
+        dismissedNpmVersions: [],
+        dismissedForgeVersions: [],
+    };
+    const ts = now();
+    const ttlFresh = ts - cache.lastProbeAt < CACHE_TTL_MS;
+    if (!ttlFresh) {
+        const [npmRes, forgeRes] = await Promise.allSettled([probeNpm(fetchImpl), probeForge(fetchImpl)]);
+        const nextNpm = npmRes.status === "fulfilled" && npmRes.value !== null ? npmRes.value : cache.latestNpmVersion;
+        const nextForge = forgeRes.status === "fulfilled" && forgeRes.value !== null ? forgeRes.value : cache.latestForgeVersion;
+        cache = {
+            ...cache,
+            lastProbeAt: ts,
+            latestNpmVersion: nextNpm,
+            latestForgeVersion: nextForge,
+        };
+        try {
+            await writeCache(cacheDir, cache);
+        }
+        catch (err) {
+            debug("cache write failed:", err);
+        }
+    }
+    const npmAvail = cache.latestNpmVersion &&
+        semverGt(cache.latestNpmVersion, opts.currentCliVersion) &&
+        !cache.dismissedNpmVersions.includes(cache.latestNpmVersion)
+        ? { current: opts.currentCliVersion, latest: cache.latestNpmVersion }
+        : null;
+    const forgeAvail = cache.latestForgeVersion &&
+        semverGt(cache.latestForgeVersion, opts.currentBundledForgeVersion) &&
+        !cache.dismissedForgeVersions.includes(cache.latestForgeVersion)
+        ? { current: opts.currentBundledForgeVersion, latest: cache.latestForgeVersion }
+        : null;
+    const banner = composeBanner(npmAvail, forgeAvail);
+    if (banner)
+        opts.notify(banner, "info");
+}
+export const __test__ = {
+    CACHE_TTL_MS,
+    cachePath,
+    readCache,
+    writeCache,
+    semverGt,
+    composeBanner,
+};
+//# sourceMappingURL=update-check.js.map

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

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

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,135 @@
+// 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/validate.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 parseValidateArgs(rawArgs: string, cwd: string): ParsedArgs;
+export interface ComposeKickoffOpts {
+    workflowMd: string;
+    personaIdentity: string;
+    parsed: ParsedArgs;
+}
+export declare function composeKickoff(opts: ComposeKickoffOpts): string;
+export interface RegisterValidateOptions {
+    cwd?: string;
+}
+export declare function registerValidate(pi: ExtensionAPI, options?: RegisterValidateOptions): void;

package/dist/extensions/forgecli/validate.js

@@ -0,0 +1,152 @@
+// forge:validate — native kickoff handler (FORGE-S21-T10).
+//
+// Replaces the auto-generated stub previously installed by
+// registerAllForgeCommands (forge-commands.ts). Kickoff Shim archetype
+// (Pack-04 + Pack-06): single LLM handoff in current context, no fork.
+//
+// Note: The materialized workflow (validate_task.md) declares
+// `audience: subagent` — advisory only. Users may invoke this command
+// manually from the CLI; assertAudience never refuses subagent-audience
+// workflows. Orchestrator chains still dispatch via runForgeSubagent
+// directly and do NOT route through this handler.
+//
+// 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 parseValidateArgs(rawArgs, cwd) {
+    const trimmed = (rawArgs ?? "").trim();
+    if (trimmed === "") {
+        return { mode: "empty", taskRef: "", sourceLabel: "(no input — qa-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:validate", ""];
+    if (personaIdentity.trim().length > 0) {
+        sections.push(personaIdentity.trim(), "");
+    }
+    sections.push("## Dispatch", "", "Run the workflow below. Specifically:", "", "1. Read the implementation artifacts for `engineering/sprints/<SPRINT_ID>/<TASK_ID>/` (PROGRESS.md, CODE_REVIEW.md).", "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: validate the implementation against acceptance criteria, run test commands, verify completeness.", "4. Write `VALIDATION_REPORT.md` and `VALIDATION-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; 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", "validate_task.md");
+export function registerValidate(pi, options = {}) {
+    pi.registerCommand("forge:validate", {
+        description: "Run the validate-task workflow for a Forge task. " +
+            "Usage: /forge:validate [@<file> | <free-form text>]. " +
+            "Note: this workflow is subagent-only; standalone invocations are refused. " +
+            "Orchestrator chains dispatch directly via runForgeSubagent.",
+        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("validate", 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:validate — workflow not found at ${WORKFLOW_REL_PATH}; run /forge:init or /forge:rebuild first.`, "error");
+                    }
+                    else {
+                        ctx.ui.notify(`× forge:validate — workflow load failed (${err.code}): ${err.message}`, "error");
+                    }
+                    return;
+                }
+                const e = err;
+                ctx.ui.notify(`× forge:validate — failed to read workflow: ${e.message ?? "unknown"}`, "error");
+                return;
+            }
+            let parsed;
+            try {
+                parsed = parseValidateArgs(effectiveArgs, cwd);
+            }
+            catch (err) {
+                const e = err;
+                ctx.ui.notify(`× forge:validate — 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:validate — persona '${personas[0]}' load failed (${err.code}): ${err.message}`, "error");
+                        return;
+                    }
+                    const e = err;
+                    ctx.ui.notify(`× forge:validate — persona load error: ${e.message ?? "unknown"}`, "error");
+                    return;
+                }
+            }
+            if (!assertAudience({ workflowName: "validate_task", audience: workflowAudience }, ctx)) {
+                return;
+            }
+            const kickoff = composeKickoff({
+                workflowMd,
+                personaIdentity,
+                parsed,
+            });
+            sendKickoff(pi, kickoff);
+        },
+    });
+}
+//# sourceMappingURL=validate.js.map

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

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