@jeger-ai/opengantry 3.0.0 → 3.1.0

package/dist/cli/lib/trace.js

@@ -1,305 +1,4 @@
-import path from "node:path";
-import { LEGISLATE_TRACE_PLACEHOLDER, EXECUTOR_LOG_FILENAME } from "./constants.js";
-import { toPosixRel } from "./cli-io.js";
-import { gitDiffNameOnlySinceCommit, gitRun } from "./git.js";
-import { quoteLineNumbers, buildExecutorLogLineMapForQuotes } from "./executor-log-line-map.js";
-import { tmvcRootsForSkill } from "./tmvc-path.js";
-export function normalizeTraceStatus(status) {
-    const upper = status.trim().toUpperCase();
-    if (upper === "PASS")
-        return "PASS";
-    if (upper === "FAIL")
-        return "FAIL";
-    if (upper === "PENDING")
-        return "PENDING";
-    return "PENDING";
-}
-export function isPassStatus(status) {
-    return status === "PASS";
-}
-export function isPendingStatus(status) {
-    return status === "PENDING";
-}
-function missingQuoteKind(traceQuote) {
-    return traceQuote.trim() === LEGISLATE_TRACE_PLACEHOLDER ? "placeholder_quote" : "quote_missing";
-}
-export const UNCOMMITTED_BLAME_COMMIT = "0000000000000000000000000000000000000000";
-function executorLogRelPath(executorLogPath, repoRoot) {
-    const abs = path.resolve(executorLogPath);
-    const rel = toPosixRel(repoRoot, abs);
-    return rel.length > 0 && !rel.startsWith("..") ? rel : EXECUTOR_LOG_FILENAME;
-}
-/** Parse `git blame --porcelain` into 1-based line number → commit hash. */
-export function parseBlamePorcelainByLine(blameOutput) {
-    const byLine = new Map();
-    const lines = blameOutput.split(/\r?\n/);
-    let i = 0;
-    while (i < lines.length) {
-        const header = lines[i];
-        const full = /^([0-9a-f]{40})\s+\d+\s+(\d+)\s+(\d+)/.exec(header);
-        const short = /^([0-9a-f]{40})\s+\d+\s+(\d+)\s*$/.exec(header);
-        if (!full && !short) {
-            i += 1;
-            continue;
-        }
-        const commit = (full ?? short)[1];
-        const finalLine = parseInt((full ?? short)[2], 10);
-        i += 1;
-        if (full) {
-            while (i < lines.length && !lines[i].startsWith("\t")) {
-                i += 1;
-            }
-        }
-        if (i < lines.length && lines[i].startsWith("\t")) {
-            byLine.set(finalLine, commit);
-            i += 1;
-            continue;
-        }
-        if (short) {
-            byLine.set(finalLine, commit);
-        }
-    }
-    return byLine;
-}
-export function readBlamePorcelainByLine(repoRoot, executorLogRelPath) {
-    const r = gitRun(repoRoot, ["blame", "--porcelain", "--", executorLogRelPath]);
-    if (!r.ok)
-        return new Map();
-    return parseBlamePorcelainByLine(r.stdout);
-}
-function formatStaleReason(row, quoteLine, attestationCommit, stalePaths) {
-    const shortCommit = attestationCommit.slice(0, 7);
-    const shown = stalePaths.slice(0, 5);
-    const suffix = stalePaths.length > shown.length ? ` (+${String(stalePaths.length - shown.length)} more)` : "";
-    return (`Trace STALE for DoD ${row.dodId} (EXECUTOR_LOG.md line ${String(quoteLine)}, attested at ${shortCommit}): ` +
-        `TMVC drift since attestation — ${shown.join(", ")}${suffix}. Re-run gate and append a fresh trace line.`);
-}
-export function verifyTraceEvidenceFreshness(repoRoot, manifest, skillKey, executorLogPath, resolvedLines, options = {}) {
-    if (options.skipStaleEvidence === true) {
-        return { failures: [], skippedUncommitted: 0 };
-    }
-    const tmvcRoots = tmvcRootsForSkill(manifest, skillKey);
-    if (tmvcRoots.length === 0) {
-        return { failures: [], skippedUncommitted: 0 };
-    }
-    const executorLogRel = executorLogRelPath(executorLogPath, repoRoot);
-    const blameByLine = readBlamePorcelainByLine(repoRoot, executorLogRel);
-    const diffCache = new Map();
-    const failures = [];
-    let skippedUncommitted = 0;
-    for (const { row, lineNumber } of resolvedLines) {
-        const attestationCommit = blameByLine.get(lineNumber);
-        if (!attestationCommit) {
-            failures.push({
-                row,
-                attestationCommit: "unknown",
-                quoteLine: lineNumber,
-                stalePaths: [],
-                reason: `Trace STALE for DoD ${row.dodId}: cannot resolve git blame for EXECUTOR_LOG.md line ${String(lineNumber)}`,
-            });
-            continue;
-        }
-        if (attestationCommit === UNCOMMITTED_BLAME_COMMIT) {
-            skippedUncommitted += 1;
-            continue;
-        }
-        let diffResult = diffCache.get(attestationCommit);
-        if (diffResult === undefined) {
-            diffResult = gitDiffNameOnlySinceCommit(repoRoot, attestationCommit, tmvcRoots);
-            diffCache.set(attestationCommit, diffResult);
-        }
-        if (!diffResult.ok) {
-            failures.push({
-                row,
-                attestationCommit,
-                quoteLine: lineNumber,
-                stalePaths: [],
-                reason: `Trace STALE for DoD ${row.dodId}: cannot evaluate TMVC drift since attestation (git diff failed)`,
-            });
-            continue;
-        }
-        if (diffResult.paths.length > 0) {
-            failures.push({
-                row,
-                attestationCommit,
-                quoteLine: lineNumber,
-                stalePaths: diffResult.paths,
-                reason: formatStaleReason(row, lineNumber, attestationCommit, diffResult.paths),
-            });
-        }
-    }
-    return { failures, skippedUncommitted };
-}
-export function isPassTraceRow(status) {
-    return isPassStatus(normalizeTraceStatus(status));
-}
-export function resolveQuoteLineNumber(map, row, resolvedLineByDodId) {
-    const override = resolvedLineByDodId.get(row.dodId);
-    if (override !== undefined)
-        return override;
-    const anchor = row.anchor.trim();
-    if (/^\d+$/.test(anchor)) {
-        const declared = parseInt(anchor, 10);
-        const line = map.lines[declared - 1];
-        if (line !== undefined && line.includes(row.traceQuote))
-            return declared;
-        const matches = quoteLineNumbers(map, row.traceQuote);
-        if (matches.length === 1)
-            return matches[0];
-        return null;
-    }
-    for (let i = 0; i < map.lines.length; i++) {
-        const line = map.lines[i];
-        if (line.includes(anchor) && line.includes(row.traceQuote))
-            return i + 1;
-    }
-    return null;
-}
-function buildResolvedQuoteLines(passRows, map, warnings) {
-    const resolvedLineByDodId = new Map();
-    for (const warning of warnings) {
-        resolvedLineByDodId.set(warning.row.dodId, warning.foundLine);
-    }
-    const resolved = [];
-    for (const row of passRows) {
-        const lineNumber = resolveQuoteLineNumber(map, row, resolvedLineByDodId);
-        if (lineNumber !== null)
-            resolved.push({ row, lineNumber });
-    }
-    return resolved;
-}
-function verifyNumericAnchorExact(map, row, lineNumber) {
-    const line = map.lines[lineNumber - 1];
-    if (line === undefined) {
-        return {
-            row,
-            kind: "strict_line_drift",
-            reason: `Anchor line ${lineNumber} out of range (file has ${map.lines.length} lines)`,
-        };
-    }
-    if (!line.includes(row.traceQuote)) {
-        return { row, kind: "strict_line_drift", 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,
-                kind: missingQuoteKind(row.traceQuote),
-                reason: "Trace quote not found verbatim in EXECUTOR_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,
-            kind: "ambiguous",
-            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,
-            kind: "anchor_mismatch",
-            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(executorLogPath, rows, options = {}) {
-    const forceFuzzy = options.fuzzyNumericAnchor === true;
-    const autoFuzzy = options.strictTrace !== true;
-    const passRows = rows.filter((r) => isPassTraceRow(r.status));
-    const quotes = passRows.map((r) => r.traceQuote);
-    const map = buildExecutorLogLineMapForQuotes(executorLogPath, quotes);
-    if (!map) {
-        return {
-            failures: passRows.map((row) => ({
-                row,
-                kind: "executor_log_missing",
-                reason: `EXECUTOR_LOG missing: ${executorLogPath}`,
-            })),
-            warnings: [],
-            resolvedLines: [],
-            map: null,
-        };
-    }
-    const failures = [];
-    const warnings = [];
-    for (const row of passRows) {
-        if (!row.traceQuote.trim()) {
-            failures.push({ row, kind: "empty_quote", reason: "PASS row has empty trace quote" });
-            continue;
-        }
-        if (!map.content.includes(row.traceQuote)) {
-            failures.push({
-                row,
-                kind: missingQuoteKind(row.traceQuote),
-                reason: "Trace quote not found verbatim in EXECUTOR_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;
-            // Exact numeric-anchor failures are always line drift; auto-fuzzy retries them.
-            if (autoFuzzy) {
-                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,
-        resolvedLines: buildResolvedQuoteLines(passRows, map, warnings),
-        map,
-    };
-}
-export function defaultExecutorLogPath(repoRoot) {
-    return path.join(repoRoot, EXECUTOR_LOG_FILENAME);
-}
+export { normalizeTraceStatus, isPassStatus, isPendingStatus, isPassTraceRow, } from "./trace-status.js";
+export { resolveQuoteLineNumber, verifyTraceRows, defaultExecutorLogPath, } from "./trace-quote.js";
+export { UNCOMMITTED_BLAME_COMMIT, parseBlamePorcelainByLine, readBlamePorcelainByLine, verifyTraceEvidenceFreshness, } from "./trace-evidence.js";
 //# sourceMappingURL=trace.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/cli/lib/trace.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/cli/lib/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,cAAc,GACf,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAOL,sBAAsB,EACtB,eAAe,EACf,sBAAsB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,wBAAwB,EAGxB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,qBAAqB,CAAC"}

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

@@ -63,6 +63,7 @@ export interface LlmVerifierSpec {
 }
 export interface KpiFinding {
     id?: string;
+    doc_anchor?: string;
     severity: "info" | "warn" | "error";
     path: string;
     line?: number;

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

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

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

@@ -0,0 +1,13 @@
+import { type InitAssetSpec } from "./init-asset-catalog.js";
+import { type InitProfile } from "./init-profile.js";
+import type { PlannedWrite } from "./init-plan.js";
+import type { UpgradeFileChange } from "./upgrade-plan-types.js";
+/** managed_strict substrate assets eligible for gantry upgrade (excludes user law / missions). */
+export declare function upgradeEligibleAssets(assets: InitAssetSpec[]): InitAssetSpec[];
+export declare function allUpgradeEligibleFromCatalog(templatesRoot: string): InitAssetSpec[];
+/** Infer init profile from on-disk substrate assets for upgrade planning. */
+export declare function inferInitProfileFromRepo(repoRoot: string, templatesRoot?: string): InitProfile;
+/** Summarize planned upgrade writes for dry-run / changelog preview. */
+export declare function buildUpgradeFileChanges(repoRoot: string, writes: PlannedWrite[]): UpgradeFileChange[];
+export declare function groupUpgradeChangesByCategory(changes: UpgradeFileChange[]): Record<string, UpgradeFileChange[]>;
+//# sourceMappingURL=upgrade-plan-catalog.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-plan-catalog.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/upgrade-plan-catalog.ts"],"names":[],"mappings":"AAQA,OAAO,EAAwB,KAAK,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAsB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE,kGAAkG;AAClG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAE9E;AAED,wBAAgB,6BAA6B,CAAC,aAAa,EAAE,MAAM,GAAG,aAAa,EAAE,CAEpF;AAiBD,6EAA6E;AAC7E,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,WAAW,CAc9F;AAYD,wEAAwE;AACxE,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,YAAY,EAAE,GACrB,iBAAiB,EAAE,CAcrB;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,iBAAiB,EAAE,GAC3B,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAgBrC"}

package/dist/cli/lib/upgrade-plan-catalog.js

@@ -0,0 +1,85 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { INTEGRATION_IDE_KEYS, loadIntegrationCompat, } from "./integration-compat.js";
+import { loadInitAssetCatalog } from "./init-asset-catalog.js";
+import { defaultInitProfile } from "./init-profile.js";
+import { toPosixRel } from "./cli-io.js";
+/** managed_strict substrate assets eligible for gantry upgrade (excludes user law / missions). */
+export function upgradeEligibleAssets(assets) {
+    return assets.filter((a) => a.mode === "managed_strict");
+}
+export function allUpgradeEligibleFromCatalog(templatesRoot) {
+    return upgradeEligibleAssets([...loadInitAssetCatalog(templatesRoot)]);
+}
+function pathExists(repoRoot, rel) {
+    return fs.existsSync(path.join(repoRoot, rel.split("/").join(path.sep)));
+}
+function detectIntegrationPresent(repoRoot, key, entry) {
+    if (key === "codex-cli") {
+        return pathExists(repoRoot, ".codex/config.toml");
+    }
+    return entry.canonical_paths.some((p) => pathExists(repoRoot, p));
+}
+/** Infer init profile from on-disk substrate assets for upgrade planning. */
+export function inferInitProfileFromRepo(repoRoot, templatesRoot) {
+    const profile = defaultInitProfile();
+    const compat = loadIntegrationCompat(templatesRoot);
+    const detected = INTEGRATION_IDE_KEYS.filter((key) => detectIntegrationPresent(repoRoot, key, compat.integrations[key]));
+    if (detected.length > 0) {
+        profile.ides = detected;
+    }
+    profile.gitHooks =
+        pathExists(repoRoot, ".githooks/pre-push") || pathExists(repoRoot, ".githooks/pre-commit");
+    profile.ciWorkflow = pathExists(repoRoot, ".github/workflows/gxt-validate.yml");
+    profile.skillsPreset = pathExists(repoRoot, "skills/gantry.md") ? "specimen" : "minimal";
+    return profile;
+}
+function sha256Buffer(buf) {
+    return crypto.createHash("sha256").update(buf).digest("hex");
+}
+function fileState(absPath) {
+    if (!fs.existsSync(absPath))
+        return null;
+    const buf = fs.readFileSync(absPath);
+    return { bytes: buf.length, sha256: sha256Buffer(buf) };
+}
+/** Summarize planned upgrade writes for dry-run / changelog preview. */
+export function buildUpgradeFileChanges(repoRoot, writes) {
+    return writes.map((w) => {
+        const rel = toPosixRel(repoRoot, w.absoluteTarget);
+        const before = fileState(w.absoluteTarget);
+        const afterBuf = Buffer.from(w.body, "utf8");
+        return {
+            path: rel,
+            action: before === null ? "add" : "update",
+            bytes_before: before?.bytes ?? null,
+            bytes_after: afterBuf.length,
+            sha256_before: before?.sha256 ?? null,
+            sha256_after: sha256Buffer(afterBuf),
+        };
+    });
+}
+export function groupUpgradeChangesByCategory(changes) {
+    const groups = {
+        workflows: [],
+        scripts: [],
+        hooks: [],
+        substrate: [],
+        other: [],
+    };
+    for (const c of changes) {
+        if (c.path.startsWith(".github/workflows/"))
+            groups.workflows.push(c);
+        else if (c.path.startsWith("scripts/"))
+            groups.scripts.push(c);
+        else if (c.path.startsWith(".githooks/") || c.path.startsWith(".cursor/hooks"))
+            groups.hooks.push(c);
+        else if (c.path.startsWith(".gitagent/"))
+            groups.substrate.push(c);
+        else
+            groups.other.push(c);
+    }
+    return groups;
+}
+//# sourceMappingURL=upgrade-plan-catalog.js.map

package/dist/cli/lib/upgrade-plan-catalog.js.map

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

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

@@ -1,4 +1,4 @@
-import type { UpgradePlanResult } from "./upgrade-plan.js";
+import type { UpgradePlanResult } from "./upgrade-plan-types.js";
 /** Wire contract version for automation consumers (MCP, CI). Bump only with migration. */
 export declare const STABLE_UPGRADE_PLAN_PAYLOAD_VERSION: 1;
 export interface StableUpgradeFileChangeV1 {

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

@@ -1 +1 @@
-{"version":3,"file":"upgrade-plan-payload.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/upgrade-plan-payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAE9E,0FAA0F;AAC1F,eAAO,MAAM,mCAAmC,EAAG,CAAU,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,OAAO,mCAAmC,CAAC;IAC3D,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,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;IAC/B,YAAY,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,EAAE,CAAC,CAAC;CACnE;AAoCD,kFAAkF;AAClF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,GAAG,0BAA0B,CA8BlG;AAED,oFAAoF;AACpF,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,0BAA0B,CAgC5G"}
+{"version":3,"file":"upgrade-plan-payload.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/upgrade-plan-payload.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEpF,0FAA0F;AAC1F,eAAO,MAAM,mCAAmC,EAAG,CAAU,CAAC;AAE9D,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,0BAA0B;IACzC,cAAc,EAAE,OAAO,mCAAmC,CAAC;IAC3D,MAAM,EAAE,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,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;IAC/B,YAAY,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAC3C,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,EAAE,CAAC,CAAC;CACnE;AAoCD,kFAAkF;AAClF,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,iBAAiB,GAAG,0BAA0B,CA8BlG;AAED,oFAAoF;AACpF,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,0BAA0B,CAgC5G"}

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

@@ -0,0 +1,15 @@
+import type { PlannedWrite } from "./init-plan.js";
+import { type UpgradePayload } from "./upgrade-plan-types.js";
+declare function semverSlug(version: string): string;
+export declare function pickNextUpgradeMsn(repoRoot: string): string;
+export declare function resolveUpgradeMsn(repoRoot: string, explicit?: string): string;
+export declare function writeStagedFiles(repoRoot: string, writes: PlannedWrite[]): Record<string, string>;
+export declare function buildUpgradeMissionYaml(opts: {
+    msnId: string;
+    fromVersion: string;
+    toVersion: string;
+    payload: UpgradePayload;
+}): string;
+export declare function parseUpgradePayloadFromMissionBody(body: string): UpgradePayload;
+export { semverSlug };
+//# sourceMappingURL=upgrade-plan-scaffold.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-plan-scaffold.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/upgrade-plan-scaffold.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAmB,KAAK,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAM/E,iBAAS,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAS7E;AAUD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAejG;AAED,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,CAeT;AAED,wBAAgB,kCAAkC,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAwC/E;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/cli/lib/upgrade-plan-scaffold.js

@@ -0,0 +1,109 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import YAML from "yaml";
+import { CLI_NAME } from "./constants.js";
+import { fromPosix, toPosixRel } from "./cli-io.js";
+import { allocateMsn } from "./msn-allocate.js";
+import { buildLegislativeTraceRows, buildMissionYamlScaffold, isValidMsnId, } from "./missions/parser.js";
+import { REL_UPGRADE_TMP } from "./upgrade-plan-types.js";
+function sha256Buffer(buf) {
+    return crypto.createHash("sha256").update(buf).digest("hex");
+}
+function semverSlug(version) {
+    return version.replace(/[^a-zA-Z0-9._-]+/g, "-");
+}
+export function pickNextUpgradeMsn(repoRoot) {
+    return allocateMsn(repoRoot, { band: "upgrade" });
+}
+export function resolveUpgradeMsn(repoRoot, explicit) {
+    const msn = explicit?.trim();
+    if (msn) {
+        if (!isValidMsnId(msn)) {
+            throw new Error(`${CLI_NAME} upgrade: invalid --msn (expected MSN-NNNN)`);
+        }
+        return msn;
+    }
+    return pickNextUpgradeMsn(repoRoot);
+}
+function upgradeTmpAbs(repoRoot) {
+    return path.join(repoRoot, fromPosix(REL_UPGRADE_TMP));
+}
+function stagePathForTarget(repoRoot, targetRel) {
+    return path.join(upgradeTmpAbs(repoRoot), fromPosix(targetRel));
+}
+export function writeStagedFiles(repoRoot, writes) {
+    const stagedHashes = {};
+    const tmpRoot = upgradeTmpAbs(repoRoot);
+    if (fs.existsSync(tmpRoot)) {
+        fs.rmSync(tmpRoot, { recursive: true, force: true });
+    }
+    for (const w of writes) {
+        const rel = toPosixRel(repoRoot, w.absoluteTarget);
+        const stageAbs = stagePathForTarget(repoRoot, rel);
+        fs.mkdirSync(path.dirname(stageAbs), { recursive: true });
+        fs.writeFileSync(stageAbs, w.body, "utf8");
+        if (w.executable)
+            fs.chmodSync(stageAbs, 0o755);
+        stagedHashes[rel] = sha256Buffer(Buffer.from(w.body, "utf8"));
+    }
+    return stagedHashes;
+}
+export function buildUpgradeMissionYaml(opts) {
+    const doc = {
+        msn_id: opts.msnId,
+        skill_key: "substrate",
+        gate_command: "gantry doctor",
+        gate_success_substring: null,
+        upgrade_payload: opts.payload,
+        trace_rows: buildLegislativeTraceRows(),
+    };
+    return buildMissionYamlScaffold({
+        header: `# OpenGantry substrate upgrade mission (Planner: review staged diff under ${REL_UPGRADE_TMP}/).\n` +
+            `# Upgrade ${opts.fromVersion} → ${opts.toVersion}. Commit this file only; staging dir is gitignored.\n`,
+        doc,
+    });
+}
+export function parseUpgradePayloadFromMissionBody(body) {
+    const data = YAML.parse(body);
+    const payload = data.upgrade_payload;
+    if (typeof payload !== "object" || payload === null) {
+        throw new Error(`${CLI_NAME} upgrade: mission missing upgrade_payload`);
+    }
+    const p = payload;
+    const required = ["from_version", "to_version", "staged_hashes", "planned_writes"];
+    for (const key of required) {
+        if (p[key] === undefined) {
+            throw new Error(`${CLI_NAME} upgrade: upgrade_payload missing ${key}`);
+        }
+    }
+    if (typeof p.from_version !== "string" || typeof p.to_version !== "string") {
+        throw new Error(`${CLI_NAME} upgrade: upgrade_payload version fields must be strings`);
+    }
+    if (typeof p.staged_hashes !== "object" || p.staged_hashes === null || Array.isArray(p.staged_hashes)) {
+        throw new Error(`${CLI_NAME} upgrade: upgrade_payload.staged_hashes must be an object`);
+    }
+    if (!Array.isArray(p.planned_writes)) {
+        throw new Error(`${CLI_NAME} upgrade: upgrade_payload.planned_writes must be an array`);
+    }
+    const stagedHashes = {};
+    for (const [k, v] of Object.entries(p.staged_hashes)) {
+        if (typeof v !== "string") {
+            throw new Error(`${CLI_NAME} upgrade: staged_hashes.${k} must be a string`);
+        }
+        stagedHashes[k] = v;
+    }
+    return {
+        from_version: p.from_version,
+        to_version: p.to_version,
+        staged_root: REL_UPGRADE_TMP,
+        planned_writes: p.planned_writes.map(String),
+        skipped_scaffold_only: Array.isArray(p.skipped_scaffold_only)
+            ? p.skipped_scaffold_only.map(String)
+            : [],
+        staged_hashes: stagedHashes,
+        created_at: typeof p.created_at === "string" ? p.created_at : new Date().toISOString(),
+    };
+}
+export { semverSlug };
+//# sourceMappingURL=upgrade-plan-scaffold.js.map

package/dist/cli/lib/upgrade-plan-scaffold.js.map

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