@entelligentsia/forgecli 1.0.10 → 1.0.20

package/dist/forge-payload/tools/preflight-gate.cjs

@@ -349,9 +349,56 @@ if (require.main === module) {
   if (result.ok) process.exit(0);
   process.stderr.write(`Gate failed for phase "${args.phase}":\n`);
   for (const m of result.missing) process.stderr.write(`  - ${m}\n`);
+  // Emit structured JSON on stdout for orchestrators to parse and render.
+  // Shape: { phase, reasonCode, detail, remediation }
+  const structured = buildStructuredFailure(args.phase, result.missing);
+  process.stdout.write(JSON.stringify(structured) + '\n');
   process.exit(1);
 }
 
+// Build a structured gate-failure object for orchestrators.
+// Maps the human-readable `missing[]` strings to a typed { phase, reasonCode, detail, remediation }.
+// reasonCode is derived from the dominant failure pattern:
+//   artifact-missing            — artifact missing / too small
+//   predecessor-verdict-missing — after-clause verdict absent or wrong
+//   illegal-status              — require/forbid predicate fired
+//   tool-error                  — internal error / unrecognised pattern
+// When multiple failures exist, reasonCode reflects the first recognised pattern;
+// detail combines all messages; only a single JSON object is ever emitted.
+function buildStructuredFailure(phase, missing) {
+  let reasonCode = 'tool-error';
+  const detailParts = [];
+
+  for (const m of missing) {
+    detailParts.push(m);
+    if (reasonCode === 'tool-error') {
+      if (/^artifact (missing|too small)/i.test(m)) {
+        reasonCode = 'artifact-missing';
+      } else if (/^predecessor verdict (missing|unreadable)/i.test(m) || /verdict is "/i.test(m)) {
+        reasonCode = 'predecessor-verdict-missing';
+      } else if (/^(require failed|forbid triggered)/i.test(m)) {
+        reasonCode = 'illegal-status';
+      }
+    }
+  }
+
+  const detail = detailParts.join('; ');
+
+  const remediationMap = {
+    'artifact-missing': `Re-run the phase that produces this artifact (e.g. /forge:plan or /forge:implement), then retry.`,
+    'predecessor-verdict-missing': `Ensure the predecessor review phase completed and recorded a verdict via set-summary, then retry.`,
+    'illegal-status': `Correct the task/bug status (use store-cli update-status) so it satisfies the gate predicate, then retry.`,
+    'tool-error': `Check the gate configuration and store records for this task; run node .forge/tools/preflight-gate.cjs manually for diagnostics.`,
+  };
+
+  return {
+    phase,
+    reasonCode,
+    detail,
+    remediation: remediationMap[reasonCode],
+  };
+}
+
 function parseArgs(argv) {
   const out = {};
   for (let i = 0; i < argv.length; i++) {

package/dist/forge-payload/tools/substitute-placeholders.cjs

@@ -120,10 +120,11 @@ const RUNTIME_PASSTHROUGH_KEYS = new Set([
  * project prefix via getCommandsSubdir() — see walkBasePack.
  */
 const SUBDIR_OUTPUT_MAP = {
-  personas:  path.join('.forge', 'personas'),
-  skills:    path.join('.forge', 'skills'),
-  workflows: path.join('.forge', 'workflows'),
-  templates: path.join('.forge', 'templates'),
+  personas:       path.join('.forge', 'personas'),
+  skills:         path.join('.forge', 'skills'),
+  workflows:      path.join('.forge', 'workflows'),
+  templates:      path.join('.forge', 'templates'),
+  'workflows-js': path.join('.claude', 'workflows'),
 };
 
 /**

package/dist/forge-payload/tools/verify-phase.cjs

@@ -194,6 +194,14 @@ function verifyPhase2(cwd, kbPath) {
 
 const PHASE3_DIRS = ['workflows', 'personas', 'skills', 'templates'];
 
+// JS workflow files that substitute-placeholders.cjs emits from
+// base-pack/workflows-js/ into .claude/workflows/ (FORGE-S28-T01).
+// These are checked in addition to the .forge/ directory checks.
+const PHASE3_JS_FILES = [
+  path.join('.claude', 'workflows', 'wfl-run-task.js'),
+  path.join('.claude', 'workflows', 'wfl-run-sprint.js'),
+];
+
 function verifyPhase3(cwd) {
   const missing = [];
   const checked = [];
@@ -213,6 +221,15 @@ function verifyPhase3(cwd) {
     }
   }
 
+  // Assert generated JS workflow files are present (FORGE-S28-T01)
+  for (const relFile of PHASE3_JS_FILES) {
+    checked.push(relFile);
+    const absFile = path.join(cwd, relFile);
+    if (!fs.existsSync(absFile)) {
+      missing.push(relFile);
+    }
+  }
+
   return {
     phase: 3,
     ok: missing.length === 0,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@entelligentsia/forgecli",
-  "version": "1.0.10",
-  "description": "Forge SDLC ported onto @earendil-works/pi-coding-agent \u2014 production launcher with three bin aliases (forge/forgecli/4ge). Bundles a curated fork of pi-coding-agent vendored under earendil-works names.",
+  "version": "1.0.20",
+  "description": "Forge SDLC ported onto @earendil-works/pi-coding-agent — production launcher with three bin aliases (forge/forgecli/4ge). Bundles a curated fork of pi-coding-agent vendored under earendil-works names.",
   "license": "MIT",
   "author": "Entelligentsia",
   "homepage": "https://github.com/Entelligentsia/forge-cli#readme",

package/dist/bin/forgecli.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/bin/forgecli.js

@@ -1,6 +0,0 @@
-#!/usr/bin/env node
-// Stage 1 scaffold (FORGE-S15-T01). Real CLI entry lands in FORGE-S15-T03.
-console.log("forgecli stub — see FORGE-S15-T03");
-process.exit(0);
-export {};
-//# sourceMappingURL=forgecli.js.map

package/dist/bin/forgecli.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"forgecli.js","sourceRoot":"","sources":["../../src/bin/forgecli.ts"],"names":[],"mappings":";AACA,2EAA2E;AAE3E,OAAO,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC;AACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC"}

package/dist/extensions/forgecli/config-tui/index.d.ts

@@ -1,5 +0,0 @@
-export { createConfigTuiComponent, type ConfigTuiComponentOptions } from "./component.js";
-export type { ConfigLayer } from "../config-writer.js";
-export type { View, ConfigBuffer, AvailableModel, InitOptions, ConfigTuiState, ConfigTuiAction, PhaseOverride, ResolvedPersonaEntry, PersonaPickerEntry, PipelineOverrideSummary, TierAssignment, } from "./state/model.js";
-export { CANONICAL_PHASES, initialState, reducer, getActiveView, listResolvedPersonas, listPersonaPickerEntries, uniqueProviders, listPipelineOverrideSummaries, getPhaseOverride, getTierAssignment, getAllTierAssignments, getTierForPersona, getPersonasInTier, writePersonaEntry, deletePersonaEntry, writePhaseOverride, clearPhaseOverride, writeTierAssignment, isConfigEmpty, personaSourceLabel, } from "./state.js";
-export type { InputResult, Screen } from "./screens/types.js";

package/dist/extensions/forgecli/config-tui/index.js

@@ -1,5 +0,0 @@
-// Config-TUI public re-exports.
-// Phase 3: theming + width safety + data-driven menus + auth error surfacing.
-export { createConfigTuiComponent } from "./component.js";
-export { CANONICAL_PHASES, initialState, reducer, getActiveView, listResolvedPersonas, listPersonaPickerEntries, uniqueProviders, listPipelineOverrideSummaries, getPhaseOverride, getTierAssignment, getAllTierAssignments, getTierForPersona, getPersonasInTier, writePersonaEntry, deletePersonaEntry, writePhaseOverride, clearPhaseOverride, writeTierAssignment, isConfigEmpty, personaSourceLabel, } from "./state.js";
-//# sourceMappingURL=index.js.map

package/dist/extensions/forgecli/config-tui/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/config-tui/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,8EAA8E;AAE9E,OAAO,EAAE,wBAAwB,EAAkC,MAAM,gBAAgB,CAAC;AAkB1F,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACxB,eAAe,EACf,6BAA6B,EAC7B,gBAAgB,EAChB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/extensions/forgecli/loaders/persona-skill-loader.d.ts

@@ -1,45 +0,0 @@
-import { type Static, Type } from "typebox";
-export declare const PersonaSchema: Type.TObject<{
-    name: Type.TString;
-    filePath: Type.TString;
-    identity: Type.TString;
-    body: Type.TString;
-    capabilities: Type.TArray<Type.TString>;
-    frontmatter: Type.TRecord<"^.*$", Type.TUnknown>;
-}>;
-export type Persona = Static<typeof PersonaSchema>;
-export declare const SkillSchema: Type.TObject<{
-    name: Type.TString;
-    filePath: Type.TString;
-    body: Type.TString;
-    capabilities: Type.TArray<Type.TString>;
-    frontmatter: Type.TRecord<"^.*$", Type.TUnknown>;
-}>;
-export type Skill = Static<typeof SkillSchema>;
-export type PersonaSkillLoaderErrorCode = "missing_file" | "invalid_frontmatter" | "path_traversal" | "no_project_root" | "validation_failed";
-export declare class PersonaSkillLoaderError extends Error {
-    readonly code: PersonaSkillLoaderErrorCode;
-    constructor(code: PersonaSkillLoaderErrorCode, message: string);
-}
-export interface LoaderOptions {
-    /** Override project root (the directory containing `.forge/`). */
-    projectRoot?: string;
-    /** cwd to start `.forge/config.json` discovery from. Defaults to `process.cwd()`. */
-    cwd?: string;
-}
-/**
- * Load a Persona record from `<projectRoot>/.forge/personas/<name>.md`.
- *
- * `name` is the filename stem (e.g. `"engineer"` for `engineer.md`). It must
- * not contain path separators or traversal segments — invalid names raise
- * `PersonaSkillLoaderError` with `code: "path_traversal"`.
- */
-export declare function loadPersona(name: string, opts?: LoaderOptions): Persona;
-/**
- * Load a Skill record from `<projectRoot>/.forge/skills/<name>.md`.
- *
- * `name` is the filename stem. The Forge convention names skill files
- * `<noun>-skills.md` (e.g. `engineer-skills.md`); callers pass the full stem
- * including the `-skills` suffix. The loader does not auto-append it.
- */
-export declare function loadSkill(name: string, opts?: LoaderOptions): Skill;

package/dist/extensions/forgecli/loaders/persona-skill-loader.js

@@ -1,227 +0,0 @@
-// Central persona/skill loader — FORGE-S20-T02.
-//
-// Single canonical surface for reading persona and skill markdown files from
-// the user's `.forge/personas/` and `.forge/skills/` directories. Future
-// kickoff handlers (T04 /forge:enhance, T05 /forge:plan, T06 /forge:implement)
-// load typed Persona/Skill records through this module instead of issuing
-// ad-hoc fs.readFile calls. The smoke gate locks the invariant in place.
-//
-// Path resolution anchors at the **project root** containing `.forge/`, not
-// at `forgeRoot` (which points at the bundled plugin source — `.forge/personas/`
-// is a project-local generated directory).
-//
-// Iron Law 6 (no shell-string interpolation): all I/O is via fs synchronous
-// APIs with absolute paths constructed by `path.join`/`path.resolve`. No
-// external process invocation.
-// Iron Law 7 (no silent continuation): every failure mode raises a typed
-// `PersonaSkillLoaderError` with an explicit `code`.
-import * as fs from "node:fs";
-import * as path from "node:path";
-import { Type } from "typebox";
-import { Value } from "typebox/value";
-import { discoverForgeConfig } from "../forge-root.js";
-// ── TypeBox schemas ──────────────────────────────────────────────────────
-export const PersonaSchema = Type.Object({
-    name: Type.String(),
-    filePath: Type.String(),
-    identity: Type.String(),
-    body: Type.String(),
-    capabilities: Type.Array(Type.String()),
-    frontmatter: Type.Record(Type.String(), Type.Unknown()),
-});
-export const SkillSchema = Type.Object({
-    name: Type.String(),
-    filePath: Type.String(),
-    body: Type.String(),
-    capabilities: Type.Array(Type.String()),
-    frontmatter: Type.Record(Type.String(), Type.Unknown()),
-});
-export class PersonaSkillLoaderError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.name = "PersonaSkillLoaderError";
-        this.code = code;
-    }
-}
-// ── Project-root discovery ───────────────────────────────────────────────
-function resolveProjectRoot(opts) {
-    if (opts?.projectRoot)
-        return opts.projectRoot;
-    const cwd = opts?.cwd ?? process.cwd();
-    const cfg = discoverForgeConfig(cwd);
-    if (!cfg) {
-        throw new PersonaSkillLoaderError("no_project_root", `No .forge/config.json found walking up from ${cwd}. ` +
-            "Run /forge:init to scaffold the project, or pass `projectRoot` explicitly.");
-    }
-    // configPath = <projectDir>/.forge/config.json → projectDir = parent of .forge/
-    return path.dirname(path.dirname(cfg.configPath));
-}
-// ── Name validation (defence in depth) ───────────────────────────────────
-function validateName(name, kind) {
-    if (typeof name !== "string" || name.length === 0) {
-        throw new PersonaSkillLoaderError("path_traversal", `${kind} name must be a non-empty string`);
-    }
-    if (name.includes("/") || name.includes("\\") || name.includes("\0")) {
-        throw new PersonaSkillLoaderError("path_traversal", `${kind} name contains path separators: ${JSON.stringify(name)}`);
-    }
-    const parts = name.split(/[/\\]/);
-    for (const p of parts) {
-        if (p === ".." || p === "." || p === "") {
-            throw new PersonaSkillLoaderError("path_traversal", `${kind} name contains traversal segment: ${JSON.stringify(name)}`);
-        }
-    }
-}
-// ── Realpath confinement check ───────────────────────────────────────────
-function assertWithinDir(realFile, realDir, kind) {
-    const prefix = realDir.endsWith(path.sep) ? realDir : realDir + path.sep;
-    if (!realFile.startsWith(prefix)) {
-        throw new PersonaSkillLoaderError("path_traversal", `${kind} path escapes ${realDir}: resolved to ${realFile}`);
-    }
-}
-function parseFrontmatter(content) {
-    // Normalise CRLF for line-based parsing while preserving body intact below.
-    const lines = content.split(/\r?\n/);
-    if (lines.length === 0 || lines[0] !== "---") {
-        return { frontmatter: {}, body: content };
-    }
-    const fm = {};
-    let i = 1;
-    let closed = false;
-    for (; i < lines.length; i++) {
-        const line = lines[i];
-        if (line === "---") {
-            closed = true;
-            i++;
-            break;
-        }
-        // Allow blank lines inside frontmatter.
-        if (line.trim() === "")
-            continue;
-        const m = /^([A-Za-z0-9_.-]+):\s*(.*)$/.exec(line);
-        if (!m) {
-            throw new PersonaSkillLoaderError("invalid_frontmatter", `Malformed frontmatter line ${i + 1}: ${JSON.stringify(line)}`);
-        }
-        const value = m[2].trim();
-        // Strip matching surrounding quotes if present.
-        let parsed = value;
-        if ((value.startsWith('"') && value.endsWith('"') && value.length >= 2) ||
-            (value.startsWith("'") && value.endsWith("'") && value.length >= 2)) {
-            parsed = value.slice(1, -1);
-        }
-        fm[m[1]] = parsed;
-    }
-    if (!closed) {
-        throw new PersonaSkillLoaderError("invalid_frontmatter", "Frontmatter block opened with `---` but never closed");
-    }
-    const body = lines.slice(i).join("\n");
-    return { frontmatter: fm, body };
-}
-// ── Capability + identity extraction ─────────────────────────────────────
-function extractCapabilities(body) {
-    const lines = body.split(/\r?\n/);
-    const heading = /^##\s+Capabilities\s*$/;
-    const nextSection = /^##\s+\S/;
-    const bullet = /^[-*]\s+(.+)$/;
-    const out = [];
-    let inSection = false;
-    for (const line of lines) {
-        if (!inSection) {
-            if (heading.test(line))
-                inSection = true;
-            continue;
-        }
-        if (nextSection.test(line))
-            break;
-        const m = bullet.exec(line);
-        if (m)
-            out.push(m[1].trim());
-    }
-    return out;
-}
-function extractIdentity(body) {
-    for (const line of body.split(/\r?\n/)) {
-        if (line.trim().length > 0)
-            return line.trim();
-    }
-    return "";
-}
-// ── Internal generic load ────────────────────────────────────────────────
-function loadFile(kind, subdir, name, opts) {
-    validateName(name, kind);
-    const projectRoot = resolveProjectRoot(opts);
-    const baseDir = path.join(projectRoot, ".forge", subdir);
-    const candidate = path.join(baseDir, `${name}.md`);
-    // Realpath the *directory* first — it must exist for confinement check.
-    let realDir;
-    try {
-        realDir = fs.realpathSync(baseDir);
-    }
-    catch {
-        throw new PersonaSkillLoaderError("missing_file", `${kind} directory does not exist: ${baseDir}`);
-    }
-    let realFile;
-    try {
-        realFile = fs.realpathSync(candidate);
-    }
-    catch {
-        throw new PersonaSkillLoaderError("missing_file", `${kind} file not found: ${candidate}`);
-    }
-    assertWithinDir(realFile, realDir, kind);
-    let raw;
-    try {
-        raw = fs.readFileSync(realFile, "utf8");
-    }
-    catch (err) {
-        const e = err;
-        throw new PersonaSkillLoaderError("missing_file", `Failed to read ${kind} file ${realFile}: ${e.message ?? "unknown"}`);
-    }
-    return { filePath: realFile, doc: parseFrontmatter(raw) };
-}
-// ── Public API ───────────────────────────────────────────────────────────
-/**
- * Load a Persona record from `<projectRoot>/.forge/personas/<name>.md`.
- *
- * `name` is the filename stem (e.g. `"engineer"` for `engineer.md`). It must
- * not contain path separators or traversal segments — invalid names raise
- * `PersonaSkillLoaderError` with `code: "path_traversal"`.
- */
-export function loadPersona(name, opts) {
-    const { filePath, doc } = loadFile("persona", "personas", name, opts);
-    const persona = {
-        name,
-        filePath,
-        identity: extractIdentity(doc.body),
-        body: doc.body,
-        capabilities: extractCapabilities(doc.body),
-        frontmatter: doc.frontmatter,
-    };
-    if (!Value.Check(PersonaSchema, persona)) {
-        const errs = [...Value.Errors(PersonaSchema, persona)].map((e) => e.message);
-        throw new PersonaSkillLoaderError("validation_failed", `Persona ${name} failed schema validation: ${errs.join("; ")}`);
-    }
-    return persona;
-}
-/**
- * Load a Skill record from `<projectRoot>/.forge/skills/<name>.md`.
- *
- * `name` is the filename stem. The Forge convention names skill files
- * `<noun>-skills.md` (e.g. `engineer-skills.md`); callers pass the full stem
- * including the `-skills` suffix. The loader does not auto-append it.
- */
-export function loadSkill(name, opts) {
-    const { filePath, doc } = loadFile("skill", "skills", name, opts);
-    const skill = {
-        name,
-        filePath,
-        body: doc.body,
-        capabilities: extractCapabilities(doc.body),
-        frontmatter: doc.frontmatter,
-    };
-    if (!Value.Check(SkillSchema, skill)) {
-        const errs = [...Value.Errors(SkillSchema, skill)].map((e) => e.message);
-        throw new PersonaSkillLoaderError("validation_failed", `Skill ${name} failed schema validation: ${errs.join("; ")}`);
-    }
-    return skill;
-}
-//# sourceMappingURL=persona-skill-loader.js.map

package/dist/extensions/forgecli/loaders/persona-skill-loader.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"persona-skill-loader.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/loaders/persona-skill-loader.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,6EAA6E;AAC7E,yEAAyE;AACzE,+EAA+E;AAC/E,0EAA0E;AAC1E,yEAAyE;AACzE,EAAE;AACF,4EAA4E;AAC5E,iFAAiF;AACjF,2CAA2C;AAC3C,EAAE;AACF,4EAA4E;AAC5E,yEAAyE;AACzE,+BAA+B;AAC/B,yEAAyE;AACzE,qDAAqD;AAErD,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAe,IAAI,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAEtC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,4EAA4E;AAE5E,MAAM,CAAC,MAAM,aAAa,GAAG,IAAI,CAAC,MAAM,CAAC;IACxC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE;IACvB,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;IACnB,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACvC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;CACvD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE;IACvB,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE;IACnB,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;IACvC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;CACvD,CAAC,CAAC;AAYH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IACjC,IAAI,CAA8B;IAClD,YAAY,IAAiC,EAAE,OAAe;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CACD;AAWD,4EAA4E;AAE5E,SAAS,kBAAkB,CAAC,IAA+B;IAC1D,IAAI,IAAI,EAAE,WAAW;QAAE,OAAO,IAAI,CAAC,WAAW,CAAC;IAC/C,MAAM,GAAG,GAAG,IAAI,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvC,MAAM,GAAG,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,MAAM,IAAI,uBAAuB,CAChC,iBAAiB,EACjB,+CAA+C,GAAG,IAAI;YACrD,4EAA4E,CAC7E,CAAC;IACH,CAAC;IACD,gFAAgF;IAChF,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,4EAA4E;AAE5E,SAAS,YAAY,CAAC,IAAY,EAAE,IAAyB;IAC5D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,MAAM,IAAI,uBAAuB,CAAC,gBAAgB,EAAE,GAAG,IAAI,kCAAkC,CAAC,CAAC;IAChG,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,uBAAuB,CAChC,gBAAgB,EAChB,GAAG,IAAI,mCAAmC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAChE,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;YACzC,MAAM,IAAI,uBAAuB,CAChC,gBAAgB,EAChB,GAAG,IAAI,qCAAqC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAClE,CAAC;QACH,CAAC;IACF,CAAC;AACF,CAAC;AAED,4EAA4E;AAE5E,SAAS,eAAe,CAAC,QAAgB,EAAE,OAAe,EAAE,IAAyB;IACpF,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC;IACzE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,uBAAuB,CAAC,gBAAgB,EAAE,GAAG,IAAI,iBAAiB,OAAO,iBAAiB,QAAQ,EAAE,CAAC,CAAC;IACjH,CAAC;AACF,CAAC;AASD,SAAS,gBAAgB,CAAC,OAAe;IACxC,4EAA4E;IAC5E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC;QAC9C,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3C,CAAC;IACD,MAAM,EAAE,GAA4B,EAAE,CAAC;IACvC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,MAAM,GAAG,KAAK,CAAC;IACnB,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACpB,MAAM,GAAG,IAAI,CAAC;YACd,CAAC,EAAE,CAAC;YACJ,MAAM;QACP,CAAC;QACD,wCAAwC;QACxC,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,SAAS;QACjC,MAAM,CAAC,GAAG,6BAA6B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,CAAC,EAAE,CAAC;YACR,MAAM,IAAI,uBAAuB,CAChC,qBAAqB,EACrB,8BAA8B,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAC9D,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1B,gDAAgD;QAChD,IAAI,MAAM,GAAW,KAAK,CAAC;QAC3B,IACC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;YACnE,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,EAClE,CAAC;YACF,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QACD,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IACnB,CAAC;IACD,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,uBAAuB,CAAC,qBAAqB,EAAE,sDAAsD,CAAC,CAAC;IAClH,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,4EAA4E;AAE5E,SAAS,mBAAmB,CAAC,IAAY;IACxC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,MAAM,OAAO,GAAG,wBAAwB,CAAC;IACzC,MAAM,WAAW,GAAG,UAAU,CAAC;IAC/B,MAAM,MAAM,GAAG,eAAe,CAAC;IAC/B,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,IAAI,SAAS,GAAG,KAAK,CAAC;IACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;gBAAE,SAAS,GAAG,IAAI,CAAC;YACzC,SAAS;QACV,CAAC;QACD,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,MAAM;QAClC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACZ,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACpC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;IAChD,CAAC;IACD,OAAO,EAAE,CAAC;AACX,CAAC;AAED,4EAA4E;AAE5E,SAAS,QAAQ,CAChB,IAAyB,EACzB,MAA6B,EAC7B,IAAY,EACZ,IAA+B;IAE/B,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzB,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;IAEnD,wEAAwE;IACxE,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACJ,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,uBAAuB,CAAC,cAAc,EAAE,GAAG,IAAI,8BAA8B,OAAO,EAAE,CAAC,CAAC;IACnG,CAAC;IAED,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACJ,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,uBAAuB,CAAC,cAAc,EAAE,GAAG,IAAI,oBAAoB,SAAS,EAAE,CAAC,CAAC;IAC3F,CAAC;IAED,eAAe,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAEzC,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACJ,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,CAAC,GAAG,GAA2B,CAAC;QACtC,MAAM,IAAI,uBAAuB,CAChC,cAAc,EACd,kBAAkB,IAAI,SAAS,QAAQ,KAAK,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE,CACpE,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED,4EAA4E;AAE5E;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,IAAoB;IAC7D,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACtE,MAAM,OAAO,GAAY;QACxB,IAAI;QACJ,QAAQ;QACR,QAAQ,EAAE,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC;QACnC,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,YAAY,EAAE,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;QAC3C,WAAW,EAAE,GAAG,CAAC,WAAW;KAC5B,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAC7E,MAAM,IAAI,uBAAuB,CAChC,mBAAmB,EACnB,WAAW,IAAI,8BAA8B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC9D,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,IAAoB;IAC3D,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IAClE,MAAM,KAAK,GAAU;QACpB,IAAI;QACJ,QAAQ;QACR,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,YAAY,EAAE,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;QAC3C,WAAW,EAAE,GAAG,CAAC,WAAW;KAC5B,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QACzE,MAAM,IAAI,uBAAuB,CAChC,mBAAmB,EACnB,SAAS,IAAI,8BAA8B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5D,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACd,CAAC"}

package/dist/extensions/forgecli/loaders/template-render.d.ts

@@ -1,20 +0,0 @@
-export type TemplateRenderErrorCode = "missing_template_file" | "missing_var" | "invalid_args";
-export declare class TemplateRenderError extends Error {
-    readonly code: TemplateRenderErrorCode;
-    constructor(code: TemplateRenderErrorCode, message: string);
-}
-/**
- * Render a template file by substituting `{NAME}` tokens with values from `vars`.
- *
- * @param templatePath Absolute or cwd-relative path to a UTF-8 template file.
- * @param vars Map from identifier name to substitution value (string).
- * @returns The rendered template as a string.
- *
- * @throws TemplateRenderError({ code: "missing_template_file" }) if the file
- *         does not exist or cannot be read.
- * @throws TemplateRenderError({ code: "missing_var" }) if the template
- *         references a token whose name is not a key in `vars`.
- * @throws TemplateRenderError({ code: "invalid_args" }) if `templatePath` is
- *         not a non-empty string or any value in `vars` is not a string.
- */
-export declare function renderTemplate(templatePath: string, vars: Record<string, string>): string;

package/dist/extensions/forgecli/loaders/template-render.js

@@ -1,85 +0,0 @@
-// Shared template-render helper — FORGE-S20-T03.
-//
-// Tiny, dependency-free `{NAME}` substitution helper used by kickoff-message
-// composition in forge-cli command handlers (T05 /forge:plan, T06
-// /forge:implement, and any future kickoff shim that needs argv-driven seed
-// substitution).
-//
-// API:
-//   renderTemplate(templatePath: string, vars: Record<string, string>): string
-//
-// Substitution rule (frozen):
-//   - Token syntax: `{NAME}` where NAME matches /[A-Za-z_][A-Za-z0-9_]*/.
-//     Anything else — `{}`, `{ NAME }`, `{1NAME}`, `{lowercase-dashed}` — is
-//     a literal and passes through unchanged.
-//   - Missing var (token in template, key absent from `vars`): throws
-//     TemplateRenderError("missing_var", ...). Never silently renders "".
-//     (Iron Law 7: no silent continuation.)
-//   - Extra vars (key in `vars` not referenced in template): ignored.
-//   - Values are inserted literally — no HTML/regex escaping. Callers handle
-//     downstream sanitisation.
-//   - Missing template file: throws TemplateRenderError("missing_template_file", ...).
-//
-// Iron Law 6 (no shell-string interpolation): pure fs.readFileSync, no
-// child_process. Iron Law 7 (no silent continuation): every failure mode
-// raises a typed TemplateRenderError with an explicit code.
-import * as fs from "node:fs";
-export class TemplateRenderError extends Error {
-    code;
-    constructor(code, message) {
-        super(message);
-        this.name = "TemplateRenderError";
-        this.code = code;
-    }
-}
-// ── Token grammar ────────────────────────────────────────────────────────
-//
-// Single regex, global, captures the bare identifier. Anchored on `{` and `}`
-// with no whitespace tolerance — `{ NAME }` is a literal, by design.
-const TOKEN_RE = /\{([A-Za-z_][A-Za-z0-9_]*)\}/g;
-// ── Internal: substitute over an in-memory string ────────────────────────
-function substitute(template, vars) {
-    return template.replace(TOKEN_RE, (_match, name) => {
-        if (!Object.hasOwn(vars, name)) {
-            throw new TemplateRenderError("missing_var", `template references {${name}} but no value was supplied in vars`);
-        }
-        const value = vars[name];
-        if (typeof value !== "string") {
-            throw new TemplateRenderError("invalid_args", `vars[${JSON.stringify(name)}] must be a string, got ${typeof value}`);
-        }
-        return value;
-    });
-}
-// ── Public API ───────────────────────────────────────────────────────────
-/**
- * Render a template file by substituting `{NAME}` tokens with values from `vars`.
- *
- * @param templatePath Absolute or cwd-relative path to a UTF-8 template file.
- * @param vars Map from identifier name to substitution value (string).
- * @returns The rendered template as a string.
- *
- * @throws TemplateRenderError({ code: "missing_template_file" }) if the file
- *         does not exist or cannot be read.
- * @throws TemplateRenderError({ code: "missing_var" }) if the template
- *         references a token whose name is not a key in `vars`.
- * @throws TemplateRenderError({ code: "invalid_args" }) if `templatePath` is
- *         not a non-empty string or any value in `vars` is not a string.
- */
-export function renderTemplate(templatePath, vars) {
-    if (typeof templatePath !== "string" || templatePath.length === 0) {
-        throw new TemplateRenderError("invalid_args", "templatePath must be a non-empty string");
-    }
-    if (vars === null || typeof vars !== "object") {
-        throw new TemplateRenderError("invalid_args", "vars must be an object");
-    }
-    let raw;
-    try {
-        raw = fs.readFileSync(templatePath, "utf8");
-    }
-    catch (err) {
-        const e = err;
-        throw new TemplateRenderError("missing_template_file", `failed to read template at ${templatePath}: ${e.code ?? ""} ${e.message ?? "unknown error"}`.trim());
-    }
-    return substitute(raw, vars);
-}
-//# sourceMappingURL=template-render.js.map

package/dist/extensions/forgecli/loaders/template-render.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"template-render.js","sourceRoot":"","sources":["../../../../src/extensions/forgecli/loaders/template-render.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,6EAA6E;AAC7E,kEAAkE;AAClE,4EAA4E;AAC5E,iBAAiB;AACjB,EAAE;AACF,OAAO;AACP,+EAA+E;AAC/E,EAAE;AACF,8BAA8B;AAC9B,0EAA0E;AAC1E,6EAA6E;AAC7E,8CAA8C;AAC9C,sEAAsE;AACtE,0EAA0E;AAC1E,4CAA4C;AAC5C,sEAAsE;AACtE,6EAA6E;AAC7E,+BAA+B;AAC/B,uFAAuF;AACvF,EAAE;AACF,uEAAuE;AACvE,yEAAyE;AACzE,4DAA4D;AAE5D,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAM9B,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC7B,IAAI,CAA0B;IAC9C,YAAY,IAA6B,EAAE,OAAe;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IAClB,CAAC;CACD;AAED,4EAA4E;AAC5E,EAAE;AACF,8EAA8E;AAC9E,qEAAqE;AACrE,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AAEjD,4EAA4E;AAE5E,SAAS,UAAU,CAAC,QAAgB,EAAE,IAA4B;IACjE,OAAO,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,IAAY,EAAE,EAAE;QAC1D,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,mBAAmB,CAC5B,aAAa,EACb,wBAAwB,IAAI,qCAAqC,CACjE,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,mBAAmB,CAC5B,cAAc,EACd,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,2BAA2B,OAAO,KAAK,EAAE,CACrE,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;AACJ,CAAC;AAED,4EAA4E;AAE5E;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,cAAc,CAAC,YAAoB,EAAE,IAA4B;IAChF,IAAI,OAAO,YAAY,KAAK,QAAQ,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,mBAAmB,CAAC,cAAc,EAAE,yCAAyC,CAAC,CAAC;IAC1F,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC/C,MAAM,IAAI,mBAAmB,CAAC,cAAc,EAAE,wBAAwB,CAAC,CAAC;IACzE,CAAC;IAED,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACJ,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAC7C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACd,MAAM,CAAC,GAAG,GAA0C,CAAC;QACrD,MAAM,IAAI,mBAAmB,CAC5B,uBAAuB,EACvB,8BAA8B,YAAY,KAAK,CAAC,CAAC,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC,IAAI,EAAE,CACpG,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/extensions/forgecli/loaders/workflow-loader.d.ts

@@ -1,41 +0,0 @@
-import { type Static, Type } from "typebox";
-export declare const AUDIENCE_VALUES: readonly ["orchestrator-only", "subagent", "any"];
-export type AudienceValue = (typeof AUDIENCE_VALUES)[number];
-export declare const WorkflowFrontmatterSchema: Type.TObject<{
-    audience: Type.TOptional<Type.TUnion<[Type.TLiteral<"orchestrator-only">, Type.TLiteral<"subagent">, Type.TLiteral<"any">]>>;
-    deps: Type.TOptional<Type.TObject<{
-        personas: Type.TOptional<Type.TArray<Type.TString>>;
-    }>>;
-}>;
-export type WorkflowFrontmatter = Static<typeof WorkflowFrontmatterSchema>;
-export interface LoadedWorkflow {
-    filePath: string;
-    rawMarkdown: string;
-    frontmatter: WorkflowFrontmatter;
-    /** Resolved audience; defaults to "any" when the key is absent. */
-    audience: AudienceValue;
-}
-export type WorkflowLoaderErrorCode = "missing_file" | "invalid_frontmatter" | "validation_failed";
-export declare class WorkflowLoaderError extends Error {
-    readonly code: WorkflowLoaderErrorCode;
-    constructor(code: WorkflowLoaderErrorCode, message: string);
-}
-/**
- * Parse the YAML-like frontmatter of a workflow markdown file.
- *
- * Returns `{}` if the file does not start with `---`.
- * Throws `WorkflowLoaderError("invalid_frontmatter", ...)` on malformed YAML.
- */
-export declare function parseWorkflowFrontmatter(rawMarkdown: string): WorkflowFrontmatter;
-/**
- * Extract the audience value from a parsed WorkflowFrontmatter.
- * Returns "any" when the key is absent or has an unrecognised value.
- */
-export declare function extractAudience(frontmatter: WorkflowFrontmatter): AudienceValue;
-/**
- * Load and parse a materialized workflow markdown file.
- *
- * Throws `WorkflowLoaderError("missing_file", ...)` if the file is absent or unreadable.
- * Throws `WorkflowLoaderError("invalid_frontmatter", ...)` if frontmatter is malformed.
- */
-export declare function loadWorkflow(workflowPath: string): LoadedWorkflow;