@jeger-ai/opengantry 1.0.0

package/dist/cli/lib/trace.js

@@ -0,0 +1,121 @@
+import path from "node:path";
+import { WORKER_LOG_FILENAME } from "./constants.js";
+import { buildWorkerLogLineMapForQuotes, isLineDriftFailure, quoteLineNumbers, } from "./worker-log-line-map.js";
+function isPassStatus(status) {
+    return status.toUpperCase().includes("PASS");
+}
+function verifyNumericAnchorExact(map, row, lineNumber) {
+    const line = map.lines[lineNumber - 1];
+    if (line === undefined) {
+        return {
+            row,
+            reason: `Anchor line ${lineNumber} out of range (file has ${map.lines.length} lines)`,
+        };
+    }
+    if (!line.includes(row.traceQuote)) {
+        return { row, reason: `Trace quote not on anchored line ${lineNumber}` };
+    }
+    return null;
+}
+function resolveDriftFromMap(map, row, lineNumber) {
+    const matches = quoteLineNumbers(map, row.traceQuote);
+    if (matches.length === 0) {
+        return {
+            failure: { row, reason: "Trace quote not found verbatim in WORKER_LOG.md" },
+            warning: null,
+        };
+    }
+    if (matches.length === 1) {
+        const foundLine = matches[0];
+        return {
+            failure: null,
+            warning: { row, declaredLine: lineNumber, foundLine, autoResolved: true },
+        };
+    }
+    return {
+        failure: {
+            row,
+            reason: `Ambiguous trace quote: found on lines ${matches.join(", ")}; re-run a clean flight`,
+        },
+        warning: null,
+    };
+}
+function verifyNumericAnchorFuzzy(map, row, lineNumber) {
+    const exact = verifyNumericAnchorExact(map, row, lineNumber);
+    if (exact === null)
+        return { failure: null, warning: null };
+    return resolveDriftFromMap(map, row, lineNumber);
+}
+function verifyFreeformAnchor(map, row, anchor) {
+    const found = map.lines.some((line) => line.includes(anchor) && line.includes(row.traceQuote));
+    if (!found) {
+        return {
+            row,
+            reason: `No line contains both anchor "${anchor}" and trace quote`,
+        };
+    }
+    return null;
+}
+/** Line numbers are 1-based in mission table; other anchors match a substring on a line */
+export function verifyTraceRows(workerLogPath, rows, options = {}) {
+    const forceFuzzy = options.fuzzyNumericAnchor === true;
+    const autoFuzzy = options.strictTrace !== true;
+    const passRows = rows.filter((r) => isPassStatus(r.status));
+    const quotes = passRows.map((r) => r.traceQuote);
+    const map = buildWorkerLogLineMapForQuotes(workerLogPath, quotes);
+    if (!map) {
+        return {
+            failures: passRows.map((row) => ({
+                row,
+                reason: `WORKER_LOG missing: ${workerLogPath}`,
+            })),
+            warnings: [],
+        };
+    }
+    const failures = [];
+    const warnings = [];
+    for (const row of passRows) {
+        if (!row.traceQuote.trim()) {
+            failures.push({ row, reason: "PASS row has empty trace quote" });
+            continue;
+        }
+        if (!map.content.includes(row.traceQuote)) {
+            failures.push({ row, reason: "Trace quote not found verbatim in WORKER_LOG.md" });
+            continue;
+        }
+        const anchor = row.anchor.trim();
+        if (/^\d+$/.test(anchor)) {
+            const lineNumber = parseInt(anchor, 10);
+            if (forceFuzzy) {
+                const { failure, warning } = verifyNumericAnchorFuzzy(map, row, lineNumber);
+                if (failure)
+                    failures.push(failure);
+                else if (warning)
+                    warnings.push(warning);
+                continue;
+            }
+            const exactFailure = verifyNumericAnchorExact(map, row, lineNumber);
+            if (exactFailure === null)
+                continue;
+            if (autoFuzzy && isLineDriftFailure(exactFailure.reason)) {
+                const { failure, warning } = resolveDriftFromMap(map, row, lineNumber);
+                if (failure)
+                    failures.push(failure);
+                else if (warning)
+                    warnings.push(warning);
+            }
+            else {
+                failures.push(exactFailure);
+            }
+            continue;
+        }
+        const failure = verifyFreeformAnchor(map, row, anchor);
+        if (failure)
+            failures.push(failure);
+    }
+    return { failures, warnings };
+}
+export function defaultWorkerLogPath(repoRoot) {
+    return path.join(repoRoot, WORKER_LOG_FILENAME);
+}
+//# sourceMappingURL=trace.js.map

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

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

package/dist/cli/lib/triage-logic.d.ts

@@ -0,0 +1,10 @@
+import type { Manifest, TriageResult } from "./types.js";
+/**
+ * Foreman-style triage (manifest-only routing), aligned with .gitagent/foreman/SOUL.md.
+ * May attach non-binding `adr_hints` from `.gitagent/out-of-scope/` when ADR `match_terms`
+ * overlap intent; routing remains binary.
+ */
+export declare function triageIntent(repoRoot: string, intent: string, manifest: Manifest): TriageResult;
+export declare function formatTriageJson(result: TriageResult): string;
+export declare function formatTriageHuman(result: TriageResult): string;
+//# sourceMappingURL=triage-logic.d.ts.map

package/dist/cli/lib/triage-logic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triage-logic.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/triage-logic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAsEzD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAwB/F;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE7D;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAiB9D"}

package/dist/cli/lib/triage-logic.js

@@ -0,0 +1,105 @@
+import { collectOutOfScopeAdrHints } from "./out-of-scope-hint.js";
+function normalizeIntent(text) {
+    return text.toLowerCase();
+}
+function intentReferencesPathRisk(intentNorm, riskPath) {
+    const trimmed = riskPath.endsWith("/") ? riskPath.slice(0, -1) : riskPath;
+    const needle = normalizeIntent(trimmed);
+    return intentNorm.includes(needle) || intentNorm.includes(`${needle}/`);
+}
+function shouldEscalateForRisk(intent, manifest) {
+    const intentNorm = normalizeIntent(intent);
+    for (const riskPath of Object.keys(manifest.path_risks)) {
+        if (intentReferencesPathRisk(intentNorm, riskPath)) {
+            return { escalate: true, reason: `Intent references path under path_risks: ${riskPath}` };
+        }
+    }
+    for (const kw of manifest.risk_keywords) {
+        if (intentNorm.includes(normalizeIntent(kw))) {
+            return { escalate: true, reason: `Intent contains risk_keyword: ${kw}` };
+        }
+    }
+    return { escalate: false, reason: "" };
+}
+function skillMentionedInIntent(intentNorm, skillKey) {
+    const fullKey = normalizeIntent(skillKey);
+    if (intentNorm.includes(fullKey))
+        return true;
+    const firstSegment = skillKey.split("-")[0];
+    if (firstSegment && intentNorm.includes(normalizeIntent(firstSegment)))
+        return true;
+    return false;
+}
+function withAdrHints(root, intent, result) {
+    const hints = collectOutOfScopeAdrHints(root, normalizeIntent(intent));
+    if (hints.length === 0)
+        return result;
+    return { ...result, adr_hints: hints };
+}
+function legislativeEscalation(reason) {
+    return {
+        action: "LEGISLATIVE_ESCALATION",
+        skill_key: "NONE",
+        risk_tier: "Tier-3",
+        tmvc_roots: [],
+        forbidden_zones: [],
+        reason,
+    };
+}
+function directExecution(skillKey, manifest) {
+    const skill = manifest.skills[skillKey];
+    return {
+        action: "DIRECT_EXECUTION",
+        skill_key: skillKey,
+        risk_tier: String(skill.trust_threshold),
+        tmvc_roots: [...skill.tmvc_roots],
+        forbidden_zones: [...skill.forbidden_zones],
+        reason: `Single confident skill match: ${skillKey}`,
+    };
+}
+function matchingSkillKeys(intentNorm, manifest) {
+    const keys = Object.keys(manifest.skills);
+    return keys.filter((key) => skillMentionedInIntent(intentNorm, key));
+}
+/**
+ * Foreman-style triage (manifest-only routing), aligned with .gitagent/foreman/SOUL.md.
+ * May attach non-binding `adr_hints` from `.gitagent/out-of-scope/` when ADR `match_terms`
+ * overlap intent; routing remains binary.
+ */
+export function triageIntent(repoRoot, intent, manifest) {
+    const risk = shouldEscalateForRisk(intent, manifest);
+    if (risk.escalate) {
+        return withAdrHints(repoRoot, intent, legislativeEscalation(risk.reason));
+    }
+    const intentNorm = normalizeIntent(intent);
+    const matches = matchingSkillKeys(intentNorm, manifest);
+    if (matches.length === 1) {
+        return withAdrHints(repoRoot, intent, directExecution(matches[0], manifest));
+    }
+    if (matches.length === 0) {
+        return withAdrHints(repoRoot, intent, legislativeEscalation("No confident skill_key match in intent (ambiguous or missing)"));
+    }
+    return withAdrHints(repoRoot, intent, legislativeEscalation(`Multiple skill matches: ${matches.join(", ")} — escalate to Teacher`));
+}
+export function formatTriageJson(result) {
+    return JSON.stringify(result, null, 2);
+}
+export function formatTriageHuman(result) {
+    const lines = [
+        `Action: ${result.action}`,
+        `Skill_key: ${result.skill_key}`,
+        `Risk_tier: ${result.risk_tier}`,
+        `tmvc_roots: ${JSON.stringify(result.tmvc_roots)}`,
+        `forbidden_zones: ${JSON.stringify(result.forbidden_zones)}`,
+        `Reason: ${result.reason}`,
+    ];
+    if (result.adr_hints?.length) {
+        lines.push("ADR_hints (non-binding; Teacher confirms):");
+        for (const h of result.adr_hints) {
+            const title = h.title ? ` — ${h.title}` : "";
+            lines.push(`  - ${h.id}${title}: ${h.note}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=triage-logic.js.map

package/dist/cli/lib/triage-logic.js.map

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

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

@@ -0,0 +1,62 @@
+export type TrustThreshold = "Tier-1" | "Tier-2" | "Tier-3" | string;
+export interface SkillEntry {
+    desc?: string;
+    trust_threshold: TrustThreshold;
+    tmvc_roots: string[];
+    forbidden_zones: string[];
+}
+export interface Manifest {
+    schema_version: string;
+    skills: Record<string, SkillEntry>;
+    path_risks: Record<string, string>;
+    risk_keywords: string[];
+}
+export type TriageAction = "DIRECT_EXECUTION" | "LEGISLATIVE_ESCALATION";
+/** Non-binding ADR hint from `.gitagent/out-of-scope/` (Foreman does not route on this). */
+export interface AdrHint {
+    id: string;
+    title?: string;
+    note: string;
+}
+export interface TriageResult {
+    action: TriageAction;
+    skill_key: string | "NONE";
+    risk_tier: string;
+    tmvc_roots: string[];
+    forbidden_zones: string[];
+    reason: string;
+    /** Optional; never changes `action` — Teacher resolves ADRs during legislation. */
+    adr_hints?: AdrHint[];
+}
+export interface GateSpec {
+    command: string;
+    successSubstring: string | null;
+}
+export interface TraceRow {
+    dodId: string;
+    traceQuote: string;
+    anchor: string;
+    status: string;
+}
+export interface ParsedMission {
+    msnId: string | null;
+    skillKey: string | null;
+    gate: GateSpec | null;
+    traceRows: TraceRow[];
+    rawPath: string;
+}
+/** Structured mission on disk (YAML), validated by gapman */
+export interface YamlMission {
+    msn_id?: string;
+    msnId?: string;
+    skill_key: string;
+    gate_command: string;
+    gate_success_substring?: string | null;
+    trace_rows?: Array<{
+        dod_id: string;
+        trace_quote: string;
+        anchor: string;
+        status: string;
+    }>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErE,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,cAAc,CAAC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,QAAQ;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,wBAAwB,CAAC;AAEzE,4FAA4F;AAC5F,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,QAAQ,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6DAA6D;AAC7D,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvC,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ"}

package/dist/cli/lib/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/cli/lib/types.ts"],"names":[],"mappings":""}

package/dist/cli/lib/upgrade-apply.d.ts

@@ -0,0 +1,15 @@
+export declare const REL_UPGRADE_APPLY_TMP: ".gitagent/.upgrade-apply-tmp";
+export interface UpgradeApplyResult {
+    status: "applied" | "blocked";
+    message: string;
+    to_version?: string;
+    applied_paths?: string[];
+}
+export interface RunUpgradeApplyOptions {
+    repoRoot: string;
+    mission?: string;
+    templatesRoot?: string;
+    json?: boolean;
+}
+export declare function runUpgradeApply(options: RunUpgradeApplyOptions): Promise<UpgradeApplyResult>;
+//# sourceMappingURL=upgrade-apply.d.ts.map

package/dist/cli/lib/upgrade-apply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-apply.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/upgrade-apply.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,qBAAqB,EAAG,8BAAuC,CAAC;AAE7E,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAgFD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA+DlG"}

package/dist/cli/lib/upgrade-apply.js

@@ -0,0 +1,122 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { CLI_NAME } from "./constants.js";
+import { logInfo } from "./cli-io.js";
+import { promoteFileAtomic } from "./atomic-fs.js";
+import { assertTeacherMissionProof } from "./git-proof.js";
+import { mergeGitignoreFromTemplate } from "./gitignore-gxt.js";
+import { resolveTemplateRootFromModule } from "./integration-compat.js";
+import { resolveMissionPathRequired } from "./mission-resolution.js";
+import { writeSubstrateVersionFile } from "./substrate-version.js";
+import { parseUpgradePayloadFromMissionBody, REL_UPGRADE_TMP, } from "./upgrade-plan.js";
+import { GapmanUserError } from "./user-error.js";
+export const REL_UPGRADE_APPLY_TMP = ".gitagent/.upgrade-apply-tmp";
+function sha256File(absPath) {
+    return crypto.createHash("sha256").update(fs.readFileSync(absPath)).digest("hex");
+}
+function verifyStagedHashes(repoRoot, payload) {
+    const tmpRoot = path.join(repoRoot, REL_UPGRADE_TMP.split("/").join(path.sep));
+    if (!fs.existsSync(tmpRoot)) {
+        throw new GapmanUserError("UPGRADE_STAGING_MISSING", `${CLI_NAME} upgrade --apply: staging directory missing at ${REL_UPGRADE_TMP}/ — re-run gapman upgrade`, `Run \`gapman upgrade\` to regenerate staged files before apply.`);
+    }
+    const entries = Object.entries(payload.staged_hashes);
+    if (entries.length === 0) {
+        throw new GapmanUserError("UPGRADE_EMPTY_MANIFEST", `${CLI_NAME} upgrade --apply: upgrade_payload.staged_hashes is empty`);
+    }
+    for (const [relPath, expectedHash] of entries) {
+        const stageAbs = path.join(tmpRoot, relPath.split("/").join(path.sep));
+        if (!fs.existsSync(stageAbs)) {
+            throw new GapmanUserError("UPGRADE_STAGING_DRIFT", `${CLI_NAME} upgrade --apply: missing staged file ${relPath} under ${REL_UPGRADE_TMP}/`, "Re-run gapman upgrade to regenerate staging after mission was signed.");
+        }
+        const actual = sha256File(stageAbs);
+        if (actual !== expectedHash) {
+            throw new GapmanUserError("UPGRADE_HASH_MISMATCH", `${CLI_NAME} upgrade --apply: staged file hash mismatch for ${relPath}`, "Staging directory was modified after plan. Re-run gapman upgrade and re-sign the mission.");
+        }
+    }
+}
+function cleanupApplyTmp(applyTmpRoot) {
+    if (fs.existsSync(applyTmpRoot)) {
+        fs.rmSync(applyTmpRoot, { recursive: true, force: true });
+    }
+}
+async function stageWritesForApply(repoRoot, payload) {
+    const tmpRoot = path.join(repoRoot, REL_UPGRADE_TMP.split("/").join(path.sep));
+    const applyTmpRoot = path.join(repoRoot, REL_UPGRADE_APPLY_TMP.split("/").join(path.sep));
+    cleanupApplyTmp(applyTmpRoot);
+    fs.mkdirSync(applyTmpRoot, { recursive: true });
+    const promotions = [];
+    for (const relPath of payload.planned_writes) {
+        const sourceAbs = path.join(tmpRoot, relPath.split("/").join(path.sep));
+        const stagedAbs = path.join(applyTmpRoot, relPath.split("/").join(path.sep));
+        const prodAbs = path.join(repoRoot, relPath.split("/").join(path.sep));
+        fs.mkdirSync(path.dirname(stagedAbs), { recursive: true });
+        fs.copyFileSync(sourceAbs, stagedAbs);
+        promotions.push({ staged: stagedAbs, target: prodAbs });
+    }
+    return { applyTmpRoot, promotions };
+}
+async function promoteStagedWrites(promotions) {
+    for (const { staged, target } of promotions) {
+        fs.mkdirSync(path.dirname(target), { recursive: true });
+        await promoteFileAtomic(staged, target);
+    }
+}
+export async function runUpgradeApply(options) {
+    const repoRoot = path.resolve(options.repoRoot);
+    const templatesRoot = options.templatesRoot ?? resolveTemplateRootFromModule();
+    const missionAbs = resolveMissionPathRequired(repoRoot, { explicit: options.mission });
+    const missionBody = fs.readFileSync(missionAbs, "utf8");
+    let payload;
+    try {
+        payload = parseUpgradePayloadFromMissionBody(missionBody);
+    }
+    catch (e) {
+        throw new GapmanUserError("UPGRADE_INVALID_MISSION", e instanceof Error ? e.message : String(e));
+    }
+    try {
+        assertTeacherMissionProof(repoRoot, missionAbs);
+    }
+    catch (e) {
+        return {
+            status: "blocked",
+            message: e instanceof Error ? e.message : String(e),
+        };
+    }
+    verifyStagedHashes(repoRoot, payload);
+    const tmpRoot = path.join(repoRoot, REL_UPGRADE_TMP.split("/").join(path.sep));
+    let applyTmpRoot = "";
+    try {
+        const staged = await stageWritesForApply(repoRoot, payload);
+        applyTmpRoot = staged.applyTmpRoot;
+        await promoteStagedWrites(staged.promotions);
+        mergeGitignoreFromTemplate(repoRoot, templatesRoot);
+        writeSubstrateVersionFile(repoRoot, payload.to_version, "gapman upgrade --apply");
+    }
+    catch (e) {
+        cleanupApplyTmp(applyTmpRoot);
+        throw e;
+    }
+    finally {
+        cleanupApplyTmp(applyTmpRoot);
+        if (fs.existsSync(tmpRoot)) {
+            fs.rmSync(tmpRoot, { recursive: true, force: true });
+        }
+    }
+    const appliedPaths = payload.planned_writes;
+    const message = [
+        `${CLI_NAME} upgrade: applied substrate ${payload.from_version} → ${payload.to_version}`,
+        `Updated ${appliedPaths.length} managed asset(s).`,
+        "Next: restart Cursor, confirm MCP enabled, run gapman doctor.",
+    ].join("\n");
+    if (!options.json) {
+        logInfo(message);
+    }
+    return {
+        status: "applied",
+        message,
+        to_version: payload.to_version,
+        applied_paths: appliedPaths,
+    };
+}
+//# sourceMappingURL=upgrade-apply.js.map

package/dist/cli/lib/upgrade-apply.js.map

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

package/dist/cli/lib/upgrade-eligible-assets.d.ts

@@ -0,0 +1,5 @@
+import type { InitAssetSpec } from "./init-asset-catalog.js";
+/** managed_strict substrate assets eligible for gapman upgrade (excludes user law / missions). */
+export declare function upgradeEligibleAssets(assets: InitAssetSpec[]): InitAssetSpec[];
+export declare function allUpgradeEligibleFromCatalog(): InitAssetSpec[];
+//# sourceMappingURL=upgrade-eligible-assets.d.ts.map

package/dist/cli/lib/upgrade-eligible-assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-eligible-assets.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/upgrade-eligible-assets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,kGAAkG;AAClG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAE9E;AAED,wBAAgB,6BAA6B,IAAI,aAAa,EAAE,CAE/D"}

package/dist/cli/lib/upgrade-eligible-assets.js

@@ -0,0 +1,9 @@
+import { INIT_ASSET_CATALOG } from "./init-asset-catalog.js";
+/** managed_strict substrate assets eligible for gapman upgrade (excludes user law / missions). */
+export function upgradeEligibleAssets(assets) {
+    return assets.filter((a) => a.mode === "managed_strict");
+}
+export function allUpgradeEligibleFromCatalog() {
+    return upgradeEligibleAssets([...INIT_ASSET_CATALOG]);
+}
+//# sourceMappingURL=upgrade-eligible-assets.js.map

package/dist/cli/lib/upgrade-eligible-assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-eligible-assets.js","sourceRoot":"","sources":["../../../src/cli/lib/upgrade-eligible-assets.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,kGAAkG;AAClG,MAAM,UAAU,qBAAqB,CAAC,MAAuB;IAC3D,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,qBAAqB,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC;AACxD,CAAC"}

package/dist/cli/lib/upgrade-plan.d.ts

@@ -0,0 +1,43 @@
+export declare const REL_UPGRADE_TMP: ".gitagent/.upgrade-tmp";
+export { UPGRADE_MSN_BAND_MIN, UPGRADE_MSN_BAND_MAX } from "./msn-allocate.js";
+export interface UpgradePayload {
+    from_version: string;
+    to_version: string;
+    staged_root: typeof REL_UPGRADE_TMP;
+    planned_writes: string[];
+    skipped_scaffold_only: string[];
+    staged_hashes: Record<string, string>;
+    created_at: string;
+}
+export interface UpgradePlanResult {
+    status: "planned" | "already_current" | "downgrade_blocked" | "no_changes";
+    from_version: string;
+    to_version: string;
+    installed_source?: string;
+    message?: string;
+    mission_path?: string;
+    mission_rel?: string;
+    suggested_human_action?: string;
+    planned_writes?: string[];
+    skipped_scaffold_only?: string[];
+    unchanged?: string[];
+    legacy_warning?: string | null;
+}
+export declare function pickNextUpgradeMsn(repoRoot: string): string;
+export declare function resolveUpgradeMsn(repoRoot: string, explicit?: string): string;
+export declare function buildUpgradeMissionYaml(opts: {
+    msnId: string;
+    fromVersion: string;
+    toVersion: string;
+    payload: UpgradePayload;
+}): string;
+export declare function parseUpgradePayloadFromMissionBody(body: string): UpgradePayload;
+export interface RunUpgradePlanOptions {
+    repoRoot: string;
+    templatesRoot?: string;
+    msn?: string;
+    dryRun?: boolean;
+    json?: boolean;
+}
+export declare function runUpgradePlan(options: RunUpgradePlanOptions): UpgradePlanResult;
+//# sourceMappingURL=upgrade-plan.d.ts.map

package/dist/cli/lib/upgrade-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-plan.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/upgrade-plan.ts"],"names":[],"mappings":"AAsBA,eAAO,MAAM,eAAe,EAAG,wBAAiC,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE/E,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,OAAO,eAAe,CAAC;IACpC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,SAAS,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,YAAY,CAAC;IAC3E,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAUD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAS7E;AA2BD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,cAAc,CAAC;CACzB,GAAG,MAAM,CAaT;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAwC/E;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAkDD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,iBAAiB,CAkFhF"}