@warpgogol/forge 4.2.4 → 5.1.0

package/dist/os/compass/handlers/compass-migrate-handler.js

@@ -0,0 +1,100 @@
+/*
+<MODULE_CONTRACT>
+<purpose>compass.migrate kernel handler (RFC-1097). Resolves scan root and
+policy, enforces the dirty-tree refusal before any write, then delegates to
+the migrateWorkspace codemod and returns the per-file action manifest.</purpose>
+<non-goals>
+  <item>Do not implement transform logic — that lives in compass-migrate.ts.</item>
+  <item>Do not scaffold headers — no-header files are reported, not written.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <item>RFC-1097: initial handler — dirty-tree refusal with --force, --files bypass, dry-run manifest.</item>
+  <item>RFC-1097: steps 1-4 — compass.migrate codemod
+
+Add the v1 to v2 Compass header codemod: migrateFile pure transform (collapse, strip, seed, reorder, purpose-flag actions), migrateWorkspace walker, runCompassMigrate handler with dirty-tree refusal and --force/--files/--dry-run flags, module registration, and 15 unit tests.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — engine package clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. engine package now 0 diagnostics.</item>
+  <item>RFC-1097: AC-4 banned literal in os/compass handlers
+
+compass-migrate-handler hint used a consumer-specific run command — switched to generic 'pnpm exec forge run' convention. Reworded recorded CHANGE_SUMMARY items in 3 handlers to drop the consumer-specific literal. compass-policy AC-4 test green (65/65).</item>
+</CHANGE_SUMMARY>
+*/
+import { execFileSync } from "node:child_process";
+import { migrateWorkspace } from "./compass-migrate.js";
+import { resolveCompassScanRoot } from "./resolve-scan-root.js";
+import { resolveCompassPolicy } from "../policy.js";
+const DIRTY_LIST_CAP = 20;
+function listDirtyPaths(repoRoot) {
+    try {
+        const out = execFileSync("git", ["-C", repoRoot, "status", "--porcelain"], {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 15000,
+        });
+        return out
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean)
+            .map((line) => line.slice(3));
+    }
+    catch {
+        // Not a git repository — nothing to protect, skip the check.
+        return null;
+    }
+}
+export async function runCompassMigrate(input, context) {
+    const scanRoot = resolveCompassScanRoot(input, context);
+    const baseRoot = scanRoot ?? context.workspaceRoot;
+    const policy = resolveCompassPolicy(baseRoot, context.forgeRoot);
+    const dryRun = context.dryRun || input.flags["dry-run"] === true;
+    const force = input.flags["force"] === true;
+    const rawFiles = input.flags["files"];
+    const files = (Array.isArray(rawFiles)
+        ? rawFiles.filter((entry) => typeof entry === "string")
+        : typeof rawFiles === "string"
+            ? [rawFiles]
+            : [])
+        .flatMap((entry) => entry.split(","))
+        .map((entry) => entry.trim())
+        .filter(Boolean);
+    const explicitFiles = files.length > 0 ? files : undefined;
+    // Dirty-tree refusal guards the write only — a dry-run writes nothing and
+    // stays useful as a pre-commit preview on a dirty tree.
+    if (!dryRun && !force) {
+        const dirty = listDirtyPaths(baseRoot);
+        if (dirty && dirty.length > 0) {
+            const shown = dirty.slice(0, DIRTY_LIST_CAP);
+            const suffix = dirty.length > shown.length ? ` … and ${dirty.length - shown.length} more` : "";
+            context.logger.error(`[compass.migrate] refusing to run on a dirty git tree (${dirty.length} uncommitted path(s)):\n${shown.map((p) => `  ${p}`).join("\n")}${suffix}\nCommit or stash first, or pass --force to override.`);
+            return { exitCode: 1, summary: "dirty git tree — refused" };
+        }
+    }
+    const result = await migrateWorkspace(context.workspaceRoot, input, scanRoot, policy, {
+        files: explicitFiles,
+        dryRun,
+    });
+    const counts = new Map();
+    for (const file of result.files) {
+        for (const action of file.actions) {
+            counts.set(action, (counts.get(action) ?? 0) + 1);
+        }
+    }
+    const tally = [...counts.entries()].map(([k, v]) => `${k}=${v}`).join(", ");
+    return {
+        data: result,
+        exitCode: 0,
+        summary: `[compass.migrate] scanned=${result.scanned} ${tally}${dryRun ? " (dry-run)" : ""}`,
+        nextSteps: [
+            {
+                action: "Run `pnpm exec forge run compass.inventory --json` to list todo/purpose-flagged files for the agent sweep.",
+                kind: "optional",
+            },
+        ],
+    };
+}
+//# sourceMappingURL=compass-migrate-handler.js.map

package/dist/os/compass/handlers/compass-migrate-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass-migrate-handler.js","sourceRoot":"","sources":["../../../../os/compass/handlers/compass-migrate-handler.ts"],"names":[],"mappings":"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"}

package/dist/os/compass/handlers/compass-migrate.d.ts

@@ -0,0 +1,34 @@
+import type { CompassPolicy } from "../policy.ts";
+import type { ForgeCommandInput } from "../../../src/types.ts";
+export type MigrateAction = "collapsed" | "stripped" | "seeded" | "todo" | "purpose-flagged" | "reordered" | "unparseable" | "no-header" | "unchanged";
+export interface MigrateFileResult {
+    source: string;
+    actions: MigrateAction[];
+}
+export interface MigrateResult {
+    scanned: number;
+    files: Array<{
+        path: string;
+        actions: MigrateAction[];
+    }>;
+}
+export interface MigrateOptions {
+    /** Explicit root-relative file list — bypasses scan-root filtering entirely. */
+    files?: string[];
+    /** Compute actions without writing. */
+    dryRun?: boolean;
+}
+/** Collect ai-invariant comment texts, deduped, capped, ID-prefix stripped. */
+export declare function collectAiInvariants(source: string, policy: CompassPolicy): string[];
+/**
+ * Pure v1 to v2 transform of one file's source. Returns the rewritten source
+ * and the closed action union. `unchanged` is exclusive; every other action
+ * may combine. Never throws on malformed input — reports `unparseable`.
+ */
+export declare function migrateFile(source: string, policy: CompassPolicy, pathFromRoot: string, workspaceRelativePath: string): MigrateFileResult;
+/**
+ * Walk the workspace (or an explicit file list) and apply migrateFile to every
+ * authored file. Writes via writeFileIfChanged unless dryRun.
+ */
+export declare function migrateWorkspace(workspaceRoot: string, input: ForgeCommandInput, scanRoot: string | undefined, policy: CompassPolicy, options: MigrateOptions): Promise<MigrateResult>;
+//# sourceMappingURL=compass-migrate.d.ts.map

package/dist/os/compass/handlers/compass-migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass-migrate.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/compass-migrate.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE/D,MAAM,MAAM,aAAa,GACrB,WAAW,GACX,UAAU,GACV,QAAQ,GACR,MAAM,GACN,iBAAiB,GACjB,WAAW,GACX,aAAa,GACb,WAAW,GACX,WAAW,CAAC;AAEhB,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,aAAa,EAAE,CAAA;KAAE,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA6BD,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,MAAM,EAAE,CAqBnF;AAyBD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,YAAY,EAAE,MAAM,EACpB,qBAAqB,EAAE,MAAM,GAC5B,iBAAiB,CAkInB;AAeD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,aAAa,EAAE,MAAM,EACrB,KAAK,EAAE,iBAAiB,EACxB,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,aAAa,CAAC,CA6CxB"}

package/dist/os/compass/handlers/compass-migrate.js

@@ -0,0 +1,273 @@
+/*
+<MODULE_CONTRACT>
+<purpose>compass.migrate domain logic — the v1 to v2 Compass header codemod
+(RFC-1097). Rewrites authored file headers in place: collapses CHANGE_SUMMARY
+windows into history, strips forbidden v1 blocks, seeds KEY_DECISIONS from
+ai-invariant comments, reorders blocks to canonical order, and reports a
+closed action union per file. Pure per-file transform plus a workspace
+walker; the kernel handler lives in compass-migrate-handler.ts.</purpose>
+<non-goals>
+  <item>Do not author headers from scratch — files with no Compass header are reported no-header and skipped; the agent sweep writes them.</item>
+  <item>Do not rewrite purpose text — boilerplate purposes are flagged for the sweep, not auto-fixed.</item>
+  <item>Do not import @warpgogol/* packages — this module is autonomous (FORGE-AUTONOMY-01).</item>
+</non-goals>
+</MODULE_CONTRACT>
+<KEY_DECISIONS>
+  <item>migrateFile is a pure source-to-source function so every action is unit-testable without I/O.</item>
+  <item>Collapse reuses the summary.trim repair semantics — ID-less items dropped, overflow IDs merged into history.</item>
+  <item>Seeded KEY_DECISIONS strip the leading governance-ID prefix so items satisfy COMPASS-KD-05 immediately.</item>
+  <item>Reorder only fires when the inter-block region is whitespace — interleaved content is left for the sweep.</item>
+</KEY_DECISIONS>
+<CHANGE_SUMMARY>
+  <item>RFC-1097: initial codemod — migrateFile pure transform, migrateWorkspace walker, closed action union.</item>
+  <item>RFC-1097: steps 1-4 — compass.migrate codemod
+
+Add the v1 to v2 Compass header codemod: migrateFile pure transform (collapse, strip, seed, reorder, purpose-flag actions), migrateWorkspace walker, runCompassMigrate handler with dirty-tree refusal and --force/--files/--dry-run flags, module registration, and 15 unit tests.</item>
+</CHANGE_SUMMARY>
+*/
+import { readFile } from "node:fs/promises";
+import { relative, resolve } from "node:path";
+import { createCompassInventoryEntries, detectRiskClass, getEntrySource, getRelativeSegments, getWorkspaceRelativeSegments, } from "./compass-inventory.js";
+import { buildChangeSummaryBlock, CHANGE_SUMMARY_WINDOW, getLineCommentPrefix, mergeHistoryIds, parseChangeSummary, } from "./summary-record.js";
+import { writeFileIfChanged } from "../../../src/utils/fs-idempotent.js";
+const HEADER_SCAN_LINES = 120;
+const KEY_DECISIONS_MAX_ITEMS = 7;
+const TODO_ITEM = "TODO: record current design decisions";
+const COMPASS_TAGS = ["MODULE_CONTRACT", "KEY_DECISIONS", "CHANGE_SUMMARY"];
+const FORBIDDEN_BLOCK_TAGS = ["MODULE_MAP", "keywords", "responsibilities"];
+const COMPASS_BLOCK_ANCHOR_RE = /[ \t]*<\/?COMPASS_BLOCK\b[^>]*>[ \t]*/g;
+function blockSpan(source, tag) {
+    const open = source.indexOf(`<${tag}>`);
+    if (open < 0)
+        return null;
+    const closeTag = `</${tag}>`;
+    const close = source.indexOf(closeTag, open);
+    if (close < 0)
+        return null;
+    return { start: open, end: close + closeTag.length };
+}
+function hasUnclosedTag(source, tag) {
+    return source.includes(`<${tag}>`) && !source.includes(`</${tag}>`);
+}
+function inHeaderRegion(source, index) {
+    return source.slice(0, index).split("\n").length <= HEADER_SCAN_LINES;
+}
+/** Collect ai-invariant comment texts, deduped, capped, ID-prefix stripped. */
+export function collectAiInvariants(source, policy) {
+    const items = [];
+    const seen = new Set();
+    const re = /@ai-invariant:?\s+([^\n*]+)/g;
+    let m;
+    while ((m = re.exec(source)) !== null) {
+        let text = m[1].replace(/(-->|\*\/)\s*$/, "").trim();
+        // KD-05: seeded items must not lead with a governance-ID prefix.
+        const idMatch = text.match(policy.idPatternPrefix);
+        if (idMatch) {
+            text = text
+                .slice(idMatch[0].length)
+                .replace(/^\s*[:—-]\s*/, "")
+                .trim();
+        }
+        if (text.length === 0 || seen.has(text))
+            continue;
+        seen.add(text);
+        items.push(text);
+        if (items.length >= KEY_DECISIONS_MAX_ITEMS)
+            break;
+    }
+    return items;
+}
+function buildKeyDecisionsBlock(items, filePath) {
+    const lines = ["<KEY_DECISIONS>"];
+    for (const item of items) {
+        lines.push(`  <item>${item}</item>`);
+    }
+    lines.push("</KEY_DECISIONS>");
+    const prefix = getLineCommentPrefix(filePath);
+    if (prefix) {
+        // New block: every line needs the line-comment prefix (unlike block
+        // replacement where the first line already carries one).
+        return lines.map((line) => prefix + line).join("\n");
+    }
+    return lines.join("\n");
+}
+function extractPurposeText(source) {
+    const contract = blockSpan(source, "MODULE_CONTRACT");
+    if (!contract)
+        return "";
+    const contractText = source.slice(contract.start, contract.end);
+    const purposeMatch = contractText.match(/<purpose>([\s\S]*?)<\/purpose>/);
+    return purposeMatch ? purposeMatch[1].replace(/<[^>]+>/g, " ").trim() : "";
+}
+/**
+ * Pure v1 to v2 transform of one file's source. Returns the rewritten source
+ * and the closed action union. `unchanged` is exclusive; every other action
+ * may combine. Never throws on malformed input — reports `unparseable`.
+ */
+export function migrateFile(source, policy, pathFromRoot, workspaceRelativePath) {
+    const actions = [];
+    // 1. Header detection — a Compass header lives in the header region only.
+    const mcIndex = source.indexOf("<MODULE_CONTRACT>");
+    const csIndex = source.indexOf("<CHANGE_SUMMARY>");
+    const hasHeader = (mcIndex >= 0 && inHeaderRegion(source, mcIndex)) ||
+        (csIndex >= 0 && inHeaderRegion(source, csIndex));
+    if (!hasHeader) {
+        return { source, actions: ["no-header"] };
+    }
+    // 2. Parseability — an open tag without its close is a broken header.
+    for (const tag of COMPASS_TAGS) {
+        if (hasUnclosedTag(source, tag)) {
+            return { source, actions: ["unparseable"] };
+        }
+    }
+    let next = source;
+    // 3. Collapse CHANGE_SUMMARY — same repair semantics as compass.summary.trim.
+    const csSpan = blockSpan(next, "CHANGE_SUMMARY");
+    if (csSpan) {
+        const block = next.slice(csSpan.start, csSpan.end);
+        const { items, historyIds } = parseChangeSummary(block);
+        const idItems = items.filter((item) => policy.idPatternPrefix.test(item));
+        const collapsedIds = [];
+        while (idItems.length > CHANGE_SUMMARY_WINDOW) {
+            const oldest = idItems.shift();
+            const idMatch = oldest.match(policy.idPatternPrefix);
+            if (idMatch)
+                collapsedIds.push(idMatch[0]);
+        }
+        const nextHistory = mergeHistoryIds(historyIds, collapsedIds, policy);
+        const changed = idItems.length !== items.length ||
+            collapsedIds.length > 0 ||
+            nextHistory.length !== historyIds.length ||
+            nextHistory.some((id, i) => id !== historyIds[i]);
+        if (changed) {
+            const newBlock = buildChangeSummaryBlock(idItems, nextHistory, pathFromRoot);
+            next = next.slice(0, csSpan.start) + newBlock + next.slice(csSpan.end);
+            actions.push("collapsed");
+        }
+    }
+    // 4. Strip forbidden v1 blocks and COMPASS_BLOCK anchors.
+    let stripped = next;
+    for (const tag of FORBIDDEN_BLOCK_TAGS) {
+        const tagRe = new RegExp(`[ \\t]*<${tag}>[\\s\\S]*?</${tag}>[ \\t]*`, "g");
+        stripped = stripped.replace(tagRe, "");
+    }
+    stripped = stripped.replace(COMPASS_BLOCK_ANCHOR_RE, "");
+    if (stripped !== next) {
+        next = stripped;
+        actions.push("stripped");
+    }
+    // 5. Seed KEY_DECISIONS on medium/high-risk files that lack the block.
+    const riskClass = detectRiskClass(pathFromRoot, workspaceRelativePath, policy);
+    const kdRequired = riskClass === "medium" || riskClass === "high";
+    if (kdRequired && !next.includes("<KEY_DECISIONS>")) {
+        const invariants = collectAiInvariants(next, policy);
+        const items = invariants.length > 0 ? invariants : [TODO_ITEM];
+        const kdBlock = buildKeyDecisionsBlock(items, pathFromRoot);
+        const mcSpan = blockSpan(next, "MODULE_CONTRACT");
+        if (mcSpan) {
+            next = next.slice(0, mcSpan.end) + "\n" + kdBlock + next.slice(mcSpan.end);
+        }
+        else {
+            const csSpan2 = blockSpan(next, "CHANGE_SUMMARY");
+            if (csSpan2) {
+                next = next.slice(0, csSpan2.start) + kdBlock + "\n" + next.slice(csSpan2.start);
+            }
+        }
+        actions.push(invariants.length > 0 ? "seeded" : "todo");
+    }
+    // 6. Reorder blocks to canonical order — only when the region between the
+    // outermost blocks is whitespace and the blocks themselves.
+    const spans = COMPASS_TAGS.map((tag) => ({ tag, span: blockSpan(next, tag) }))
+        .filter((entry) => entry.span !== null)
+        .sort((a, b) => a.span.start - b.span.start);
+    if (spans.length >= 2) {
+        const canonicalOrder = spans
+            .slice()
+            .sort((a, b) => COMPASS_TAGS.indexOf(a.tag) - COMPASS_TAGS.indexOf(b.tag))
+            .map((entry) => entry.tag);
+        const currentOrder = spans.map((entry) => entry.tag);
+        const outOfOrder = currentOrder.some((tag, i) => tag !== canonicalOrder[i]);
+        if (outOfOrder) {
+            const minStart = Math.min(...spans.map((entry) => entry.span.start));
+            const maxEnd = Math.max(...spans.map((entry) => entry.span.end));
+            const region = next.slice(minStart, maxEnd);
+            const residue = region
+                .replace(/<MODULE_CONTRACT>[\s\S]*?<\/MODULE_CONTRACT>/, "")
+                .replace(/<KEY_DECISIONS>[\s\S]*?<\/KEY_DECISIONS>/, "")
+                .replace(/<CHANGE_SUMMARY>[\s\S]*?<\/CHANGE_SUMMARY>/, "");
+            if (residue.trim().length === 0) {
+                const ordered = canonicalOrder.map((tag) => {
+                    const span = spans.find((entry) => entry.tag === tag).span;
+                    return next.slice(span.start, span.end);
+                });
+                next = next.slice(0, minStart) + ordered.join("\n") + next.slice(maxEnd);
+                actions.push("reordered");
+            }
+        }
+    }
+    // 7. Flag boilerplate purpose — report only, the sweep rewrites the text.
+    const purposeText = extractPurposeText(next);
+    if (purposeText.length > 0 &&
+        policy.purposeBoilerplatePatterns.some((pattern) => pattern.test(purposeText))) {
+        actions.push("purpose-flagged");
+    }
+    if (actions.length === 0 || next === source) {
+        const reportOnly = actions.filter((a) => a === "purpose-flagged");
+        return {
+            source,
+            actions: reportOnly.length > 0 ? reportOnly : ["unchanged"],
+        };
+    }
+    return { source: next, actions };
+}
+function toTarget(workspaceRoot, absPath, policy) {
+    const pathFromRoot = relative(workspaceRoot, absPath).replace(/\\/g, "/");
+    const segments = getRelativeSegments(absPath, workspaceRoot);
+    const workspaceRelativePath = getWorkspaceRelativeSegments(segments, policy).join("/");
+    return { absPath, pathFromRoot, workspaceRelativePath };
+}
+/**
+ * Walk the workspace (or an explicit file list) and apply migrateFile to every
+ * authored file. Writes via writeFileIfChanged unless dryRun.
+ */
+export async function migrateWorkspace(workspaceRoot, input, scanRoot, policy, options) {
+    const result = { scanned: 0, files: [] };
+    if (options.files && options.files.length > 0) {
+        for (const file of options.files) {
+            const absPath = resolve(scanRoot ?? workspaceRoot, file);
+            const target = toTarget(workspaceRoot, absPath, policy);
+            let source;
+            try {
+                source = await readFile(absPath, "utf8");
+            }
+            catch {
+                result.files.push({ path: file, actions: ["unparseable"] });
+                continue;
+            }
+            result.scanned += 1;
+            const migrated = migrateFile(source, policy, target.pathFromRoot, target.workspaceRelativePath);
+            result.files.push({ path: target.pathFromRoot, actions: migrated.actions });
+            if (!options.dryRun && migrated.source !== source) {
+                await writeFileIfChanged(absPath, migrated.source);
+            }
+        }
+        return result;
+    }
+    const entries = await createCompassInventoryEntries(workspaceRoot, input, scanRoot, policy);
+    for (const entry of entries) {
+        if (entry.authoringStatus !== "authored")
+            continue;
+        result.scanned += 1;
+        const absPath = resolve(workspaceRoot, entry.path);
+        const source = getEntrySource(entry) ?? (await readFile(absPath, "utf8"));
+        const segments = getRelativeSegments(absPath, workspaceRoot);
+        const workspaceRelativePath = getWorkspaceRelativeSegments(segments, policy).join("/");
+        const migrated = migrateFile(source, policy, entry.path, workspaceRelativePath);
+        result.files.push({ path: entry.path, actions: migrated.actions });
+        if (!options.dryRun && migrated.source !== source) {
+            await writeFileIfChanged(absPath, migrated.source);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=compass-migrate.js.map

package/dist/os/compass/handlers/compass-migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass-migrate.js","sourceRoot":"","sources":["../../../../os/compass/handlers/compass-migrate.ts"],"names":[],"mappings":"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"}

package/dist/os/compass/handlers/resolve-scan-root.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-scan-root.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/resolve-scan-root.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,MAAM,GAAG,SAAS,CAuDpB"}
+{"version":3,"file":"resolve-scan-root.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/resolve-scan-root.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAEpF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,MAAM,GAAG,SAAS,CAqDpB"}

package/dist/os/compass/handlers/resolve-scan-root.js

@@ -8,15 +8,26 @@ Moved from @warpgogol/site-kernel to @warpgogol/forge for full autonomous mode (
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Introduced as part of RFC-0015 to extend Compass commands to packages/.</item>
   <item>RFC-0556: moved canonical implementation from @warpgogol/site-kernel to @warpgogol/forge for autonomous mode.</item>
   <item>RFC-0617: added --workpiece flag for mission workpiece directory scanning.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — engine package clean
+
+Sweep batch 4: 73 Compass headers on headerless engine files (certification, component-runtime, isolation, evolution, testing), real KEY_DECISIONS on 75 files (kernel, cache, dht, swim, gitmesh, runtime), ~80 purpose expansions (CONTRACT-02/PURPOSE-02), non-goals on 13 CONTRACT-03 files, CS-07 history literal fix repo-wide (253 files). Policy: .template.ts/.template.astro excludedPaths. engine package now 0 diagnostics.</item>
+  <item>RFC-1097: AC-4 banned literal in os/compass handlers
+
+compass-migrate-handler hint used a consumer-specific run command — switched to generic 'pnpm exec forge run' convention. Reworded recorded CHANGE_SUMMARY items in 3 handlers to drop the consumer-specific literal. compass-policy AC-4 test green (65/65).</item>
+  <item>RFC-0617: fix — --package alone now implies --packages scope (was a silent no-op falling through to full-repo scan).</item>
 </CHANGE_SUMMARY>
 */
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
 export function resolveCompassScanRoot(input, context) {
-    const hasPackages = input.flags["packages"] === true;
+    const packageName = input.flags["package"];
+    const hasPackage = typeof packageName === "string" && packageName.length > 0;
+    const hasPackages = input.flags["packages"] === true || hasPackage;
     const workpiecePath = input.flags["workpiece"];
     const hasWorkpiece = typeof workpiecePath === "string" && workpiecePath.length > 0;
     if (hasWorkpiece && hasPackages) {
@@ -38,14 +49,10 @@ export function resolveCompassScanRoot(input, context) {
     if (!hasPackages) {
         return context.site ? context.site.directory : undefined;
     }
-    const packageName = input.flags["package"];
-    if (!packageName || typeof packageName !== "string") {
+    if (!hasPackage) {
         return resolve(context.workspaceRoot, "packages");
     }
-    const candidates = [
-        resolve(context.workspaceRoot, "packages", "os", packageName),
-        resolve(context.workspaceRoot, "packages", packageName),
-    ];
+    const candidates = [resolve(context.workspaceRoot, "packages", packageName)];
     for (const candidate of candidates) {
         if (existsSync(candidate)) {
             const srcPath = resolve(candidate, "src");

package/dist/os/compass/handlers/resolve-scan-root.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve-scan-root.js","sourceRoot":"","sources":["../../../../os/compass/handlers/resolve-scan-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;EAcE;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,UAAU,sBAAsB,CACpC,KAAwB,EACxB,OAA4B;IAE5B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC;IACrD,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IAEnF,IAAI,YAAY,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,aAAuB,CAAC,CAAC;QACzE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,aAAa,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;IAED,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;QACpD,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,UAAU,GAAG;QACjB,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,EAAE,IAAI,EAAE,WAAW,CAAC;QAC7D,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC;KACxD,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACnD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,sBAAsB,WAAW,wBAAwB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtG,CAAC;AACJ,CAAC"}
+{"version":3,"file":"resolve-scan-root.js","sourceRoot":"","sources":["../../../../os/compass/handlers/resolve-scan-root.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;EAuBE;AAEF,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,MAAM,UAAU,sBAAsB,CACpC,KAAwB,EACxB,OAA4B;IAE5B,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7E,MAAM,WAAW,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI,UAAU,CAAC;IACnE,MAAM,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,OAAO,aAAa,KAAK,QAAQ,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,CAAC;IAEnF,IAAI,YAAY,IAAI,WAAW,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,gFAAgF,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,aAAuB,CAAC,CAAC;QACzE,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CAAC,uCAAuC,aAAa,EAAE,CAAC,CAAC;QAC1E,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,YAAY,IAAI,WAAW,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CACb,+EAA+E,CAChF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3D,CAAC;IAED,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,UAAU,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;IAE7E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;QACnD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,sBAAsB,WAAW,wBAAwB,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CACtG,CAAC;AACJ,CAAC"}

package/dist/os/compass/handlers/summary-record.d.ts

@@ -0,0 +1,46 @@
+import { type CompassPolicy } from "../policy.ts";
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+export declare const CHANGE_SUMMARY_WINDOW = 5;
+export interface SummaryRecordInput {
+    id: string;
+    files: string[];
+    text?: string;
+    workpiece?: string;
+}
+export type SummaryRecordSkipReason = "no-block" | "duplicate" | "unparseable";
+export interface SummaryRecordResult {
+    command: "compass.summary.record";
+    status: "pass";
+    recorded: string[];
+    collapsed: string[];
+    skipped: Array<{
+        file: string;
+        reason: SummaryRecordSkipReason;
+    }>;
+    keyDecisionsReminders: string[];
+}
+interface ParsedChangeSummary {
+    items: string[];
+    historyIds: string[];
+}
+export declare function parseChangeSummary(block: string): ParsedChangeSummary;
+/** Merge existing + new history IDs: dedupe, per-namespace ascending numeric order. */
+export declare function mergeHistoryIds(existing: string[], incoming: string[], policy: CompassPolicy): string[];
+export declare function getLineCommentPrefix(filePath: string): string | null;
+export declare function buildChangeSummaryBlock(items: string[], historyIds: string[], filePath: string): string;
+export declare function stripConventionalPrefix(subject: string): string;
+export declare function sanitizeItemText(text: string): string;
+export declare function isValidGovernanceId(id: string, policy: CompassPolicy): boolean;
+interface RecordOutcome {
+    recorded: boolean;
+    collapsed: boolean;
+    skipReason?: SummaryRecordSkipReason;
+}
+/**
+ * Append `ID: text` to one file's CHANGE_SUMMARY and collapse the window.
+ * Returns the outcome; writes the file only when mutated and not dry-run.
+ */
+export declare function recordSummaryItem(absPath: string, relPath: string, id: string, text: string, dryRun: boolean, policy: CompassPolicy): Promise<RecordOutcome>;
+export declare function runCompassSummaryRecord(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<SummaryRecordResult>>;
+export {};
+//# sourceMappingURL=summary-record.d.ts.map

package/dist/os/compass/handlers/summary-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summary-record.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/summary-record.ts"],"names":[],"mappings":"AAsCA,OAAO,EAAgD,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAGhG,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAO/B,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAOvC,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,WAAW,GAAG,aAAa,CAAC;AAE/E,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,wBAAwB,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,uBAAuB,CAAA;KAAE,CAAC,CAAC;IAClE,qBAAqB,EAAE,MAAM,EAAE,CAAC;CACjC;AAED,UAAU,mBAAmB;IAC3B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,mBAAmB,CAerE;AAWD,uFAAuF;AACvF,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,aAAa,GACpB,MAAM,EAAE,CAUV;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIpE;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAAE,EACpB,QAAQ,EAAE,MAAM,GACf,MAAM,CAcR;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAE/D;AAQD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAE9E;AAED,UAAU,aAAa;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,CAAC,EAAE,uBAAuB,CAAC;CACtC;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,EAAE,EAAE,MAAM,EACV,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,aAAa,CAAC,CA8CxB;AASD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CAoElD"}