@jeger-ai/opengantry 2.0.0 → 2.2.0

package/dist/cli/lib/kpi-engine.js

@@ -0,0 +1,279 @@
+import fs from "node:fs";
+import path from "node:path";
+import Ajv2020Import from "ajv/dist/2020.js";
+import addFormatsImport from "ajv-formats";
+import YAML from "yaml";
+import { REL_KPI_REPORT_SCHEMA } from "./constants.js";
+import { toPosixRel } from "./cli-io.js";
+import { gitDiffNameOnlySinceCommit, gitRunOk } from "./git.js";
+import { readBlamePorcelainByLine, UNCOMMITTED_BLAME_COMMIT } from "./trace.js";
+import { tmvcRootsForSkill } from "./tmvc-path.js";
+import { isVirtualScratchPath } from "./virtual-scratch-store.js";
+const Ajv2020 = Ajv2020Import;
+const addFormats = addFormatsImport;
+let compiledValidator = null;
+let compiledForRoot = null;
+function loadKpiReportSchemaValidator(root) {
+    if (compiledValidator && compiledForRoot === root) {
+        return compiledValidator;
+    }
+    const schemaPath = path.join(root, REL_KPI_REPORT_SCHEMA);
+    const schemaDoc = YAML.parse(fs.readFileSync(schemaPath, "utf8"));
+    const ajv = new Ajv2020({ allErrors: true, strict: false });
+    addFormats(ajv);
+    const validate = ajv.compile(schemaDoc);
+    compiledValidator = validate;
+    compiledForRoot = root;
+    return validate;
+}
+function formatAjvErrors(errors) {
+    return errors
+        .map((e) => {
+        const at = e.instancePath || "(root)";
+        return `${at}: ${e.message ?? "invalid"}`;
+    })
+        .join("; ");
+}
+export function assertKpiReportSchemaValid(root, data, filePath) {
+    const validate = loadKpiReportSchemaValidator(root);
+    if (validate(data))
+        return;
+    const detail = formatAjvErrors(validate.errors ?? []);
+    throw new Error(`gapman kpi: ${filePath}: schema validation failed: ${detail}`);
+}
+function metricNumericValue(value) {
+    if (value === undefined)
+        return null;
+    if (typeof value === "boolean")
+        return value ? 1 : 0;
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return null;
+    return value;
+}
+function compareThreshold(actual, op, expected) {
+    if (op === "==") {
+        if (typeof actual === "boolean") {
+            const boolExpected = expected === 1 || expected === 0 ? expected === 1 : false;
+            return actual === boolExpected;
+        }
+        if (typeof actual !== "number" || !Number.isFinite(actual))
+            return false;
+        return actual === expected;
+    }
+    const numeric = metricNumericValue(actual);
+    if (numeric === null)
+        return false;
+    switch (op) {
+        case "<=":
+            return numeric <= expected;
+        case ">=":
+            return numeric >= expected;
+        case "<":
+            return numeric < expected;
+        case ">":
+            return numeric > expected;
+        default: {
+            const _exhaustive = op;
+            return _exhaustive;
+        }
+    }
+}
+/** Pure deterministic threshold evaluation over a loaded KPI report. */
+export function evaluateKpiThresholds(report, thresholds) {
+    const failures = [];
+    for (const threshold of thresholds) {
+        const actual = report.metrics[threshold.metric];
+        if (actual === undefined) {
+            failures.push({
+                metric: threshold.metric,
+                op: threshold.op,
+                expected: threshold.value,
+                actual: undefined,
+                reason: `metric "${threshold.metric}" missing from KPI report`,
+            });
+            continue;
+        }
+        if (!compareThreshold(actual, threshold.op, threshold.value)) {
+            failures.push({
+                metric: threshold.metric,
+                op: threshold.op,
+                expected: threshold.value,
+                actual,
+                reason: `KPI threshold failed: ${threshold.metric} ${threshold.op} ${String(threshold.value)} ` +
+                    `(actual: ${String(actual)})`,
+            });
+        }
+    }
+    return failures;
+}
+export function loadKpiReport(root, reportRelPath) {
+    const abs = path.isAbsolute(reportRelPath)
+        ? reportRelPath
+        : path.join(root, reportRelPath.replace(/\\/g, path.sep));
+    if (!fs.existsSync(abs)) {
+        throw new Error(`KPI report not found: ${reportRelPath}`);
+    }
+    const raw = JSON.parse(fs.readFileSync(abs, "utf8"));
+    assertKpiReportSchemaValid(root, raw, reportRelPath);
+    return raw;
+}
+function reportRelPath(reportPath, repoRoot) {
+    const abs = path.isAbsolute(reportPath) ? reportPath : path.join(repoRoot, reportPath);
+    return toPosixRel(repoRoot, abs);
+}
+function resolveKpiAttestationCommit(repoRoot, reportRel, blameByLine) {
+    if ([...blameByLine.values()].some((hash) => hash === UNCOMMITTED_BLAME_COMMIT)) {
+        return UNCOMMITTED_BLAME_COMMIT;
+    }
+    const log = gitRunOk(repoRoot, ["log", "-1", "--format=%H", "--", reportRel]);
+    if (log.ok && log.stdout.trim().length > 0) {
+        return log.stdout.trim();
+    }
+    return blameByLine.get(1);
+}
+/** Bind KPI report attestation to TMVC drift (mirrors trace-evidence committed/uncommitted split). */
+export function verifyKpiReportFreshness(repoRoot, manifest, skillKey, reportPath, options = {}) {
+    if (options.skipStaleEvidence === true) {
+        return { stale: false, advisoryOnly: false, stalePaths: [] };
+    }
+    const reportRel = reportRelPath(reportPath, repoRoot);
+    if (isVirtualScratchPath(reportRel)) {
+        return {
+            stale: false,
+            advisoryOnly: false,
+            stalePaths: [],
+            reason: "virtual scratch KPI report — stale-evidence binding skipped",
+        };
+    }
+    const tmvcRoots = tmvcRootsForSkill(manifest, skillKey);
+    if (tmvcRoots.length === 0) {
+        return { stale: false, advisoryOnly: false, stalePaths: [] };
+    }
+    const blameByLine = readBlamePorcelainByLine(repoRoot, reportRel);
+    const attestationCommit = resolveKpiAttestationCommit(repoRoot, reportRel, blameByLine);
+    if (!attestationCommit) {
+        return {
+            stale: options.strictStale === true,
+            advisoryOnly: options.strictStale !== true,
+            stalePaths: [],
+            reason: `cannot resolve git blame for KPI report ${reportRel}`,
+        };
+    }
+    if (attestationCommit === UNCOMMITTED_BLAME_COMMIT) {
+        return { stale: false, advisoryOnly: true, stalePaths: [], attestationCommit };
+    }
+    const diffResult = gitDiffNameOnlySinceCommit(repoRoot, attestationCommit, tmvcRoots);
+    if (!diffResult.ok) {
+        return {
+            stale: options.strictStale === true,
+            advisoryOnly: options.strictStale !== true,
+            stalePaths: [],
+            attestationCommit,
+            reason: "cannot evaluate TMVC drift since KPI report attestation",
+        };
+    }
+    if (diffResult.paths.length === 0) {
+        return { stale: false, advisoryOnly: false, stalePaths: [], attestationCommit };
+    }
+    const shortCommit = attestationCommit.slice(0, 7);
+    const shown = diffResult.paths.slice(0, 5);
+    const suffix = diffResult.paths.length > shown.length
+        ? ` (+${String(diffResult.paths.length - shown.length)} more)`
+        : "";
+    const reason = `KPI report STALE (attested at ${shortCommit}): TMVC drift since scan — ` +
+        `${shown.join(", ")}${suffix}. Re-run gapman scan and commit the updated report.`;
+    if (options.strictStale === true) {
+        return {
+            stale: true,
+            advisoryOnly: false,
+            stalePaths: diffResult.paths,
+            attestationCommit,
+            reason,
+        };
+    }
+    return {
+        stale: false,
+        advisoryOnly: true,
+        stalePaths: diffResult.paths,
+        attestationCommit,
+        reason,
+    };
+}
+function loadReportOrFail(root, reportRel, workerLogPath) {
+    try {
+        return { report: loadKpiReport(root, reportRel) };
+    }
+    catch (e) {
+        const message = e instanceof Error ? e.message : String(e);
+        const missing = message.includes("not found");
+        return {
+            ok: false,
+            phase: "kpi",
+            message: missing ? `KPI report missing: ${reportRel}` : `KPI report invalid: ${reportRel}`,
+            exitCode: 1,
+            workerLogPath,
+            kpiReportPath: reportRel,
+            kpiReason: message,
+        };
+    }
+}
+function staleFailure(reportRel, workerLogPath, stale) {
+    return {
+        ok: false,
+        phase: "kpi",
+        message: stale.reason ?? "KPI report stale",
+        exitCode: 1,
+        workerLogPath,
+        kpiReportPath: reportRel,
+        kpiReason: stale.reason,
+        kpiStalePaths: stale.stalePaths,
+    };
+}
+function thresholdFailure(reportRel, workerLogPath, first) {
+    return {
+        ok: false,
+        phase: "kpi",
+        message: first.reason,
+        exitCode: 1,
+        workerLogPath,
+        kpiReportPath: reportRel,
+        kpiReason: first.reason,
+        kpiMetric: first.metric,
+        kpiOp: first.op,
+        kpiExpected: first.expected,
+        kpiActual: first.actual,
+    };
+}
+export function evaluateKpiPhase(root, manifest, skillKey, kpiGate, options, workerLogPath) {
+    const reportRel = kpiGate.reportPath.replace(/\\/g, "/");
+    const loaded = loadReportOrFail(root, reportRel, workerLogPath);
+    if ("ok" in loaded)
+        return loaded;
+    const stale = verifyKpiReportFreshness(root, manifest, skillKey, reportRel, {
+        skipStaleEvidence: options.skipStaleEvidence === true,
+        strictStale: options.prePush === true || options.ci === true,
+    });
+    const warnings = [];
+    if (stale.advisoryOnly && stale.reason) {
+        warnings.push(`gapman verify: advisory — ${stale.reason}`);
+    }
+    if (stale.stale)
+        return staleFailure(reportRel, workerLogPath, stale);
+    const report = loaded.report;
+    const failures = evaluateKpiThresholds(report, kpiGate.thresholds);
+    if (failures.length > 0)
+        return thresholdFailure(reportRel, workerLogPath, failures[0]);
+    if (report.exit_code !== 0) {
+        return {
+            ok: false,
+            phase: "kpi",
+            message: `KPI report exit_code=${String(report.exit_code)} (expected 0)`,
+            exitCode: 1,
+            workerLogPath,
+            kpiReportPath: reportRel,
+            kpiReason: `report exit_code=${String(report.exit_code)}`,
+        };
+    }
+    return warnings.length > 0 ? { warnings } : null;
+}
+//# sourceMappingURL=kpi-engine.js.map

package/dist/cli/lib/kpi-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kpi-engine.js","sourceRoot":"","sources":["../../../src/cli/lib/kpi-engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,aAAa,MAAM,kBAAkB,CAAC;AAC7C,OAAO,gBAAgB,MAAM,aAAa,CAAC;AAC3C,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,0BAA0B,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAChE,OAAO,EAAE,wBAAwB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAMlE,MAAM,OAAO,GAAG,aAAmC,CAAC;AACpD,MAAM,UAAU,GAAG,gBAAmE,CAAC;AAEvF,IAAI,iBAAiB,GAA4B,IAAI,CAAC;AACtD,IAAI,eAAe,GAAkB,IAAI,CAAC;AAE1C,SAAS,4BAA4B,CAAC,IAAY;IAChD,IAAI,iBAAiB,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAClD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,qBAAqB,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAA4B,CAAC;IAC7F,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,UAAU,CAAC,GAAG,CAAC,CAAC;IAChB,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACxC,iBAAiB,GAAG,QAAQ,CAAC;IAC7B,eAAe,GAAG,IAAI,CAAC;IACvB,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,eAAe,CAAC,MAAqB;IAC5C,OAAO,MAAM;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,IAAI,QAAQ,CAAC;QACtC,OAAO,GAAG,EAAE,KAAK,CAAC,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC;IAC5C,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAY,EAAE,IAAa,EAAE,QAAgB;IACtF,MAAM,QAAQ,GAAG,4BAA4B,CAAC,IAAI,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO;IAC3B,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC;IACtD,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,+BAA+B,MAAM,EAAE,CAAC,CAAC;AAClF,CAAC;AAUD,SAAS,kBAAkB,CAAC,KAAmC;IAC7D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAoC,EACpC,EAAkB,EAClB,QAAgB;IAEhB,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;QAChB,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,QAAQ,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAC/E,OAAO,MAAM,KAAK,YAAY,CAAC;QACjC,CAAC;QACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,KAAK,CAAC;QACzE,OAAO,MAAM,KAAK,QAAQ,CAAC;IAC7B,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC3C,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAEnC,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,IAAI;YACP,OAAO,OAAO,IAAI,QAAQ,CAAC;QAC7B,KAAK,IAAI;YACP,OAAO,OAAO,IAAI,QAAQ,CAAC;QAC7B,KAAK,GAAG;YACN,OAAO,OAAO,GAAG,QAAQ,CAAC;QAC5B,KAAK,GAAG;YACN,OAAO,OAAO,GAAG,QAAQ,CAAC;QAC5B,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,EAAE,CAAC;YAC9B,OAAO,WAAW,CAAC;QACrB,CAAC;IACH,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,qBAAqB,CACnC,MAAiB,EACjB,UAAmC;IAEnC,MAAM,QAAQ,GAA0B,EAAE,CAAC;IAE3C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAChD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,QAAQ,EAAE,SAAS,CAAC,KAAK;gBACzB,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,WAAW,SAAS,CAAC,MAAM,2BAA2B;aAC/D,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QAED,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,QAAQ,CAAC,IAAI,CAAC;gBACZ,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,EAAE,EAAE,SAAS,CAAC,EAAE;gBAChB,QAAQ,EAAE,SAAS,CAAC,KAAK;gBACzB,MAAM;gBACN,MAAM,EACJ,yBAAyB,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,EAAE,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;oBACvF,YAAY,MAAM,CAAC,MAAM,CAAC,GAAG;aAChC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,aAAqB;IAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC;QACxC,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,yBAAyB,aAAa,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,CAAY,CAAC;IAChE,0BAA0B,CAAC,IAAI,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;IACrD,OAAO,GAAgB,CAAC;AAC1B,CAAC;AAkBD,SAAS,aAAa,CAAC,UAAkB,EAAE,QAAgB;IACzD,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACvF,OAAO,UAAU,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,2BAA2B,CAClC,QAAgB,EAChB,SAAiB,EACjB,WAAgC;IAEhC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,wBAAwB,CAAC,EAAE,CAAC;QAChF,OAAO,wBAAwB,CAAC;IAClC,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAC9E,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAC5B,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,QAAkB,EAClB,QAAuB,EACvB,UAAkB,EAClB,UAAiC,EAAE;IAEnC,IAAI,OAAO,CAAC,iBAAiB,KAAK,IAAI,EAAE,CAAC;QACvC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,SAAS,GAAG,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtD,IAAI,oBAAoB,CAAC,SAAS,CAAC,EAAE,CAAC;QACpC,OAAO;YACL,KAAK,EAAE,KAAK;YACZ,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,EAAE;YACd,MAAM,EAAE,6DAA6D;SACtE,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACxD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,WAAW,GAAG,wBAAwB,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClE,MAAM,iBAAiB,GAAG,2BAA2B,CAAC,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;IACxF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,OAAO,CAAC,WAAW,KAAK,IAAI;YACnC,YAAY,EAAE,OAAO,CAAC,WAAW,KAAK,IAAI;YAC1C,UAAU,EAAE,EAAE;YACd,MAAM,EAAE,2CAA2C,SAAS,EAAE;SAC/D,CAAC;IACJ,CAAC;IAED,IAAI,iBAAiB,KAAK,wBAAwB,EAAE,CAAC;QACnD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,iBAAiB,EAAE,CAAC;IACjF,CAAC;IAED,MAAM,UAAU,GAAG,0BAA0B,CAAC,QAAQ,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC;IACtF,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,OAAO;YACL,KAAK,EAAE,OAAO,CAAC,WAAW,KAAK,IAAI;YACnC,YAAY,EAAE,OAAO,CAAC,WAAW,KAAK,IAAI;YAC1C,UAAU,EAAE,EAAE;YACd,iBAAiB;YACjB,MAAM,EAAE,yDAAyD;SAClE,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,iBAAiB,EAAE,CAAC;IAClF,CAAC;IAED,MAAM,WAAW,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAClD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,MAAM,MAAM,GACV,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM;QACpC,CAAC,CAAC,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ;QAC9D,CAAC,CAAC,EAAE,CAAC;IACT,MAAM,MAAM,GACV,iCAAiC,WAAW,6BAA6B;QACzE,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,qDAAqD,CAAC;IAEpF,IAAI,OAAO,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACjC,OAAO;YACL,KAAK,EAAE,IAAI;YACX,YAAY,EAAE,KAAK;YACnB,UAAU,EAAE,UAAU,CAAC,KAAK;YAC5B,iBAAiB;YACjB,MAAM;SACP,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,KAAK;QACZ,YAAY,EAAE,IAAI;QAClB,UAAU,EAAE,UAAU,CAAC,KAAK;QAC5B,iBAAiB;QACjB,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,IAAY,EACZ,SAAiB,EACjB,aAAqB;IAErB,IAAI,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;IACpD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QAC9C,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,uBAAuB,SAAS,EAAE,CAAC,CAAC,CAAC,uBAAuB,SAAS,EAAE;YAC1F,QAAQ,EAAE,CAAC;YACX,aAAa;YACb,aAAa,EAAE,SAAS;YACxB,SAAS,EAAE,OAAO;SACnB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CACnB,SAAiB,EACjB,aAAqB,EACrB,KAAkD;IAElD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,KAAK,CAAC,MAAM,IAAI,kBAAkB;QAC3C,QAAQ,EAAE,CAAC;QACX,aAAa;QACb,aAAa,EAAE,SAAS;QACxB,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,aAAa,EAAE,KAAK,CAAC,UAAU;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,SAAiB,EACjB,aAAqB,EACrB,KAAuD;IAEvD,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,KAAK;QACZ,OAAO,EAAE,KAAK,CAAC,MAAM;QACrB,QAAQ,EAAE,CAAC;QACX,aAAa;QACb,aAAa,EAAE,SAAS;QACxB,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,KAAK,EAAE,KAAK,CAAC,EAAE;QACf,WAAW,EAAE,KAAK,CAAC,QAAQ;QAC3B,SAAS,EAAE,KAAK,CAAC,MAAM;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,IAAY,EACZ,QAAkB,EAClB,QAAuB,EACvB,OAAoB,EACpB,OAAsB,EACtB,aAAqB;IAErB,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,gBAAgB,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC;IAChE,IAAI,IAAI,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAElC,MAAM,KAAK,GAAG,wBAAwB,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE;QAC1E,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,KAAK,IAAI;QACrD,WAAW,EAAE,OAAO,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,EAAE,KAAK,IAAI;KAC7D,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,6BAA6B,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,KAAK,CAAC,KAAK;QAAE,OAAO,YAAY,CAAC,SAAS,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC;IAEtE,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC7B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IACnE,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,gBAAgB,CAAC,SAAS,EAAE,aAAa,EAAE,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC;IAEzF,IAAI,MAAM,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,KAAK;YACZ,OAAO,EAAE,wBAAwB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,eAAe;YACxE,QAAQ,EAAE,CAAC;YACX,aAAa;YACb,aAAa,EAAE,SAAS;YACxB,SAAS,EAAE,oBAAoB,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE;SAC1D,CAAC;IACJ,CAAC;IAED,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AACnD,CAAC"}

package/dist/cli/lib/kpi-scan.d.ts

@@ -8,6 +8,8 @@ export interface KpiScanResult {
     reportPath: string;
     report: KpiReport;
 }
+/** Verifier stdout contract: exit 0 and at least one metrics key. */
+export declare function verifierOutputSucceeded(exitCode: number, fragment: KpiScanFragment): boolean;
 export interface RunKpiScanOptions {
     cwd?: string;
 }

package/dist/cli/lib/kpi-scan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kpi-scan.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/kpi-scan.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,UAAU,EACV,SAAS,EAET,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;CACnB;AA8DD,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,iBAAsB,GAC9B,aAAa,CA4Df"}
+{"version":3,"file":"kpi-scan.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/kpi-scan.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,UAAU,EACV,SAAS,EAET,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;CACnB;AA2BD,qEAAqE;AACrE,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,eAAe,GAAG,OAAO,CAE5F;AAqCD,MAAM,WAAW,iBAAiB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,0EAA0E;AAC1E,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,aAAa,EACtB,OAAO,GAAE,iBAAsB,GAC9B,aAAa,CA4Df"}

package/dist/cli/lib/kpi-scan.js

@@ -2,8 +2,8 @@ import fs from "node:fs";
 import path from "node:path";
 import { DEFAULT_KPI_REPORT_DIR } from "./constants.js";
 import { runGate } from "./gate.js";
-import { assertKpiReportSchemaValid } from "./kpi-report.js";
-import { resolveGateWorkDir } from "./verify-engine.js";
+import { assertKpiReportSchemaValid } from "./kpi-engine.js";
+import { resolveGateWorkDir } from "./gate-work-dir.js";
 function namespaceMetrics(verifierId, metrics) {
     const namespaced = {};
     for (const [key, value] of Object.entries(metrics)) {
@@ -27,6 +27,10 @@ function parseVerifierStdout(stdout) {
         return {};
     }
 }
+/** Verifier stdout contract: exit 0 and at least one metrics key. */
+export function verifierOutputSucceeded(exitCode, fragment) {
+    return exitCode === 0 && Object.keys(fragment.metrics ?? {}).length > 0;
+}
 function applyAggregators(metrics, aggregators) {
     const out = { ...metrics };
     for (const agg of aggregators) {
@@ -72,7 +76,7 @@ export function runKpiScan(root, mission, options = {}) {
     }
     const reportPath = mission.kpiGate?.reportPath.replace(/\\/g, "/") ??
         `${DEFAULT_KPI_REPORT_DIR}/${msnId}.json`;
-    const workDir = options.cwd ? path.resolve(root, options.cwd) : resolveGateWorkDir(root, {});
+    const workDir = resolveGateWorkDir(root, options);
     const mergedMetrics = {};
     const mergedFindings = [];
     let scanExitCode = 0;
@@ -116,7 +120,7 @@ function runSingleVerifier(workDir, verifier) {
     const result = runGate(workDir, { command: verifier.command, successSubstring: null });
     const exitCode = result.exitCode ?? 1;
     const fragment = parseVerifierStdout(result.stdout);
-    const failed = exitCode !== 0 || Object.keys(fragment.metrics ?? {}).length === 0;
+    const failed = !verifierOutputSucceeded(exitCode, fragment);
     return { failed, exitCode, fragment };
 }
 //# sourceMappingURL=kpi-scan.js.map

package/dist/cli/lib/kpi-scan.js.map

@@ -1 +1 @@
-{"version":3,"file":"kpi-scan.js","sourceRoot":"","sources":["../../../src/cli/lib/kpi-scan.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"kpi-scan.js","sourceRoot":"","sources":["../../../src/cli/lib/kpi-scan.ts"],"names":[],"mappings":"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"}

package/dist/cli/lib/legislate.d.ts

@@ -0,0 +1,39 @@
+import type { Manifest, TriageResult } from "./types.js";
+export declare function isTriageEscalated(triage: TriageResult): boolean;
+export type ResolveSkillKeyResult = {
+    ok: true;
+    skillKey: string;
+    triage: TriageResult;
+} | {
+    ok: false;
+    triage: TriageResult;
+    reason: string;
+    kind: "unknown_skill" | "escalated";
+};
+export declare function resolveSkillKeyForLegislation(opts: {
+    root: string;
+    manifest: Manifest;
+    intent: string;
+    skillKey?: string;
+}): ResolveSkillKeyResult;
+export interface LegislateOptions {
+    intent: string;
+    msn?: string;
+    skillKey?: string;
+    out?: string;
+    allowDuplicate?: boolean;
+    gateCommand?: string;
+    gateSuccessSubstring?: string;
+    /** When true, skip stdout info messages (MCP / structured JSON callers). */
+    silent?: boolean;
+}
+export type LegislateResult = {
+    ok: true;
+    missionAbs: string;
+    missionRel: string;
+} | {
+    ok: false;
+    exitCode: 2;
+};
+export declare function runLegislate(options: LegislateOptions): LegislateResult;
+//# sourceMappingURL=legislate.d.ts.map

package/dist/cli/lib/legislate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legislate.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/legislate.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGzD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE/D;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAA;CAAE,CAAC;AAE7F,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,qBAAqB,CAyBxB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,CAAC,CAAA;CAAE,CAAC;AAuI/B,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAsCvE"}

package/dist/cli/lib/{legislate-core.js → legislate.js}

@@ -1,13 +1,38 @@
 import fs from "node:fs";
 import path from "node:path";
 import { CLI_NAME } from "./constants.js";
-import { buildLegislativeTraceRows, buildMissionYamlScaffold } from "./mission-yaml.js";
+import { buildLegislativeTraceRows, buildMissionYamlScaffold, extractMsnIdFromMissionPath, isValidMsnId, } from "./missions/parser.js";
 import { formatRepoRelative, logError, logInfo, logWarn, toPosixRel, } from "./cli-io.js";
-import { isValidMsnId } from "./mission-msn.js";
-import { extractMsnIdFromMissionPath } from "./mission-msn.js";
-import { resolveSkillKeyForLegislation } from "./legislate-skill.js";
+import { triageIntent } from "./triage-logic.js";
 import { loadWorkspace } from "./workspace.js";
-/** Slug for filename: alphanumeric + hyphen, capped length */
+export function isTriageEscalated(triage) {
+    return triage.action !== "DIRECT_EXECUTION" || triage.skill_key === "NONE";
+}
+export function resolveSkillKeyForLegislation(opts) {
+    const explicit = opts.skillKey?.trim();
+    if (explicit) {
+        if (!opts.manifest.skills[explicit]) {
+            return {
+                ok: false,
+                triage: triageIntent(opts.root, opts.intent, opts.manifest),
+                reason: `unknown skill_key "${explicit}" (manifest skills: ${Object.keys(opts.manifest.skills).join(", ")})`,
+                kind: "unknown_skill",
+            };
+        }
+        const triage = triageIntent(opts.root, opts.intent, opts.manifest);
+        return { ok: true, skillKey: explicit, triage };
+    }
+    const triage = triageIntent(opts.root, opts.intent, opts.manifest);
+    if (isTriageEscalated(triage)) {
+        return {
+            ok: false,
+            triage,
+            reason: `triage escalation — ${triage.reason}. Pass --skill-key <manifest skill> after Teacher assigns scope.`,
+            kind: "escalated",
+        };
+    }
+    return { ok: true, skillKey: triage.skill_key, triage };
+}
 function intentSlug(intent, maxLen) {
     const s = intent
         .trim()
@@ -141,4 +166,4 @@ export function runLegislate(options) {
     }
     return { ok: true, missionAbs: absolute, missionRel };
 }
-//# sourceMappingURL=legislate-core.js.map
+//# sourceMappingURL=legislate.js.map

package/dist/cli/lib/legislate.js.map

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

package/dist/cli/lib/mcp-governance.d.ts

@@ -0,0 +1,124 @@
+import type { AgentErrorPayload } from "./errors.js";
+import { type RuntimeEnvMcpResult } from "./mcp-runtime.js";
+import type { TriageResult } from "./types.js";
+export type McpToolStatus = "awaiting_human_approval" | "pending_signature" | "signature_valid" | "signature_missing" | "error";
+export interface McpErrorBody {
+    code: string;
+    message: string;
+    retryable: boolean;
+}
+export interface DraftLegislationInput {
+    title: string;
+    msn_id: string;
+    skill_key: string;
+    gate_command: string;
+    gate_success_substring?: string;
+}
+export interface DraftLegislationResult {
+    status: "awaiting_human_approval";
+    draft_token: string;
+    chat_message_to_user: string;
+    expires_at: string;
+    requires_teacher_commit: true;
+}
+export interface ExecuteLegislationResult {
+    status: "pending_signature";
+    msn_id: string;
+    mission_file_path: string;
+    suggested_human_action: string;
+    commit_message: string;
+    commit_target: string;
+    requires_teacher_commit: true;
+    next_tool: "gxt_check_signature";
+}
+export interface CheckSignatureResult {
+    status: "signature_valid" | "signature_missing";
+    msn_id: string;
+    mission_file_path: string;
+    message: string;
+    next_tools?: string[];
+}
+export type PinMissionResult = {
+    status: "pinned";
+    mission_file_path: string;
+    message: string;
+} | {
+    status: "error";
+    error: McpErrorBody;
+};
+export type ResolveMissionResult = {
+    status: "resolved";
+    mission_file_path: string;
+} | {
+    status: "unpinned";
+    mission_file_path: null;
+    message: string;
+};
+export type LastErrorResult = {
+    status: "empty";
+    message: string;
+} | {
+    status: "found";
+    payload: AgentErrorPayload;
+} | {
+    status: "error";
+    message: string;
+};
+export type StartOrchestrationMcpResult = {
+    status: "ok";
+    triage: TriageResult;
+    triage_action: string;
+    msn_id: string | null;
+    mission_file_path: string | null;
+    skill_key: string;
+    next_steps: string[];
+    next_actions: string[];
+    exit_code: number;
+    pinned_mission?: string;
+    runtime_env?: RuntimeEnvMcpResult;
+    resolve: ResolveMissionResult;
+} | {
+    status: "failed";
+    triage: TriageResult;
+    triage_action: string;
+    skill_key: string;
+    msn_id: string | null;
+    mission_file_path: string | null;
+    next_steps: string[];
+    next_actions: string[];
+    exit_code: number;
+};
+export interface StartOrchestrationInput {
+    intent: string;
+    msn_id?: string;
+    skill_key?: string;
+    gate_command?: string;
+    gate_success_substring?: string;
+    pin_if_needed?: boolean;
+    emit_runtime_env?: boolean;
+    write_mission?: boolean;
+}
+export declare function mcpError(code: string, message: string, retryable: boolean): {
+    status: "error";
+    error: McpErrorBody;
+};
+export declare function handleDraftLegislation(input: DraftLegislationInput): DraftLegislationResult | {
+    status: "error";
+    error: McpErrorBody;
+};
+export declare function handleExecuteLegislation(draftToken: string): ExecuteLegislationResult | {
+    status: "error";
+    error: McpErrorBody;
+};
+export declare function handleCheckSignature(missionFilePath: string): CheckSignatureResult | {
+    status: "error";
+    error: McpErrorBody;
+};
+export declare function handlePinMission(missionFilePath: string): PinMissionResult | {
+    status: "error";
+    error: McpErrorBody;
+};
+export declare function handleResolveMission(explicit?: string): ResolveMissionResult;
+export declare function handleLastError(): LastErrorResult;
+export declare function handleStartOrchestration(input: StartOrchestrationInput): StartOrchestrationMcpResult;
+//# sourceMappingURL=mcp-governance.d.ts.map

package/dist/cli/lib/mcp-governance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-governance.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/mcp-governance.ts"],"names":[],"mappings":"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"}