@warpgogol/forge 4.2.4 → 5.1.1

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"}

package/dist/os/compass/handlers/summary-record.js

@@ -0,0 +1,233 @@
+/*
+<MODULE_CONTRACT>
+<purpose>compass.summary.record — commit-time append of governance-referencing
+items to CHANGE_SUMMARY blocks per RFC-1095. Collapses the 5-item window into
+<history>, dedupes by ID+text, and reminds about KEY_DECISIONS on risk files.</purpose>
+<non-goals>
+  <item>Do not create CHANGE_SUMMARY blocks — headers are authored by fo-compass-annotate.</item>
+  <item>Do not validate semantic quality of item text — record writes what the commit declares.</item>
+  <item>Do not import @warpgogol/* packages — this handler is autonomous (FORGE-AUTONOMY-01).</item>
+</non-goals>
+</MODULE_CONTRACT>
+<KEY_DECISIONS>
+  <item>The 5-item window collapses oldest-first into history — history holds IDs only, never prose.</item>
+  <item>Recording is header-region guarded — a CHANGE_SUMMARY deeper than 120 lines is a doc example, not a header.</item>
+  <item>Item text is sanitized on record — literal Compass tags would corrupt history parsing.</item>
+</KEY_DECISIONS>
+<CHANGE_SUMMARY>
+  <item>RFC-1095: header-region guard in summary.record, restore test fixture with dynamic tags</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: sweep — packages/forge + services clean
+
+Sweep batch 2: real KEY_DECISIONS on 10 files, expanded purposes (CONTRACT-02/PURPOSE-02), headers on mission/index + gen-upstreams, sanitizeItemText in summary.record (literal Compass tags corrupted history), excludedPaths for wrangler types, test-fixtures testPattern. forge+services now 0 diagnostics under --mode error.</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>
+  <history>RFC-1095</history>
+</CHANGE_SUMMARY>
+*/
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { resolve, relative } from "node:path";
+import { detectRiskClass, getWorkspaceRelativeSegments } from "./compass-inventory.js";
+import { parseGovernanceIdParts, resolveCompassPolicy } from "../policy.js";
+import { resolveCompassScanRoot } from "./resolve-scan-root.js";
+import { writeFileIfChanged } from "../../../src/utils/fs-idempotent.js";
+const CHANGE_SUMMARY_BLOCK_RE = /<CHANGE_SUMMARY>[\s\S]*?<\/CHANGE_SUMMARY>/;
+const ITEM_RE = /<item>([\s\S]*?)<\/item>/g;
+const HISTORY_RE = /<history>([\s\S]*?)<\/history>/;
+const CONVENTIONAL_PREFIX_RE = /^[a-z]+(\([^)]*\))?!?:\s*/i;
+export const CHANGE_SUMMARY_WINDOW = 5;
+// A CHANGE_SUMMARY block is a file header only when it starts within this many
+// lines from the top. Deeper matches are examples inside template literals or
+// fenced doc sections, not headers.
+const HEADER_SCAN_LINES = 120;
+export function parseChangeSummary(block) {
+    const items = [];
+    let m;
+    const re = new RegExp(ITEM_RE.source, "g");
+    while ((m = re.exec(block)) !== null) {
+        items.push(m[1].trim());
+    }
+    const historyMatch = block.match(HISTORY_RE);
+    const historyIds = historyMatch
+        ? historyMatch[1]
+            .split(",")
+            .map((t) => t.trim())
+            .filter(Boolean)
+        : [];
+    return { items, historyIds };
+}
+function normalizeItemText(text) {
+    return text.trim().replace(/\s+/g, " ");
+}
+function leadingGovernanceId(item, policy) {
+    const match = item.match(policy.idPattern);
+    return match && match.index === 0 ? match[0] : null;
+}
+/** Merge existing + new history IDs: dedupe, per-namespace ascending numeric order. */
+export function mergeHistoryIds(existing, incoming, policy) {
+    const all = [...new Set([...existing, ...incoming])].filter((id) => policy.idPatternFull.test(id));
+    return all.sort((a, b) => {
+        const pa = parseGovernanceIdParts(a);
+        const pb = parseGovernanceIdParts(b);
+        const ns = pa.namespace.localeCompare(pb.namespace);
+        return ns !== 0 ? ns : pa.numeric - pb.numeric;
+    });
+}
+export function getLineCommentPrefix(filePath) {
+    if (filePath.endsWith(".gd"))
+        return "# ";
+    if (filePath.endsWith(".tscn") || filePath.endsWith(".tres"))
+        return "; ";
+    return null;
+}
+export function buildChangeSummaryBlock(items, historyIds, filePath) {
+    const prefix = getLineCommentPrefix(filePath);
+    const lines = ["<CHANGE_SUMMARY>"];
+    for (const item of items) {
+        lines.push(`  <item>${item}</item>`);
+    }
+    if (historyIds.length > 0) {
+        lines.push(`  <history>${historyIds.join(", ")}</history>`);
+    }
+    lines.push("</CHANGE_SUMMARY>");
+    if (prefix) {
+        return lines.map((line, i) => (i === 0 ? line : prefix + line)).join("\n");
+    }
+    return lines.join("\n");
+}
+export function stripConventionalPrefix(subject) {
+    return subject.replace(CONVENTIONAL_PREFIX_RE, "").trim();
+}
+// Literal Compass block tags inside an item corrupt block parsing — a commit
+// message saying "collapsed into history" would be matched by HISTORY_RE and
+// produce phantom non-ID tokens (CS-07). Strip the angle brackets on record.
+const COMPASS_TAG_LITERAL_RE = /<\/?(?:CHANGE_SUMMARY|MODULE_CONTRACT|KEY_DECISIONS|history|item|purpose|non-goals)>/g;
+export function sanitizeItemText(text) {
+    return text.replace(COMPASS_TAG_LITERAL_RE, (tag) => tag.replace(/[<>]/g, ""));
+}
+export function isValidGovernanceId(id, policy) {
+    return policy.idPatternFull.test(id);
+}
+/**
+ * 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 async function recordSummaryItem(absPath, relPath, id, text, dryRun, policy) {
+    const source = await readFile(absPath, "utf8");
+    const blockMatch = source.match(CHANGE_SUMMARY_BLOCK_RE);
+    // Header-region guard: a CHANGE_SUMMARY is a header only when it sits at the
+    // top of the file. Blocks deeper in the source are examples inside template
+    // literals or fenced doc sections — recording into them corrupts the file.
+    const inHeaderRegion = blockMatch !== null &&
+        blockMatch.index !== undefined &&
+        source.slice(0, blockMatch.index).split("\n").length <= HEADER_SCAN_LINES;
+    if (!blockMatch || !inHeaderRegion) {
+        return {
+            recorded: false,
+            collapsed: false,
+            skipReason: source.includes("<CHANGE_SUMMARY>") ? "unparseable" : "no-block",
+        };
+    }
+    const { items, historyIds } = parseChangeSummary(blockMatch[0]);
+    // Avoid "RFC-1095: RFC-1095 ..." when the text already leads with the same ID;
+    // a text equal to the bare ID collapses to the bare-ID item form.
+    const strippedText = text.startsWith(id)
+        ? text.slice(id.length).replace(/^\s*[:—-]?\s*/, "")
+        : text;
+    const newItem = strippedText.length > 0 ? `${id}: ${sanitizeItemText(strippedText)}` : id;
+    const normalizedNew = normalizeItemText(newItem);
+    if (items.some((item) => normalizeItemText(item) === normalizedNew)) {
+        return { recorded: false, collapsed: false, skipReason: "duplicate" };
+    }
+    const nextItems = [...items, newItem];
+    const collapsedIds = [];
+    while (nextItems.length > CHANGE_SUMMARY_WINDOW) {
+        const oldest = nextItems.shift();
+        const oldId = leadingGovernanceId(oldest, policy);
+        if (oldId)
+            collapsedIds.push(oldId);
+    }
+    const collapsed = collapsedIds.length > 0;
+    const nextHistory = mergeHistoryIds(historyIds, collapsedIds, policy);
+    const newBlock = buildChangeSummaryBlock(nextItems, nextHistory, relPath);
+    const transformed = source.replace(CHANGE_SUMMARY_BLOCK_RE, newBlock);
+    if (!dryRun && transformed !== source) {
+        await writeFileIfChanged(absPath, transformed);
+    }
+    return { recorded: true, collapsed };
+}
+function riskReminderNeeded(relPath, source, policy) {
+    const segments = relPath.split("/").filter(Boolean);
+    const workspaceRel = getWorkspaceRelativeSegments(segments, policy).join("/");
+    const risk = detectRiskClass(relPath, workspaceRel, policy);
+    return risk === "medium" || risk === "high" || source.includes("<KEY_DECISIONS>");
+}
+export async function runCompassSummaryRecord(input, context) {
+    const scanRoot = resolveCompassScanRoot(input, context);
+    const baseRoot = scanRoot ?? context.workspaceRoot;
+    const policy = resolveCompassPolicy(baseRoot, context.forgeRoot);
+    const id = input.flags["id"];
+    if (typeof id !== "string" || !isValidGovernanceId(id, policy)) {
+        context.logger.error(`[compass.summary.record] --id is required and must be a governance ID (e.g. RFC-1095), got: ${String(id)}`);
+        return { exitCode: 1, summary: "invalid or missing --id" };
+    }
+    const rawFiles = input.flags["files"];
+    const files = Array.isArray(rawFiles)
+        ? rawFiles
+        : typeof rawFiles === "string"
+            ? rawFiles.split(/\s+/).filter(Boolean)
+            : [];
+    const rawText = input.flags["text"];
+    const text = typeof rawText === "string" && rawText.trim().length > 0 ? rawText.trim() : id;
+    const result = {
+        command: "compass.summary.record",
+        status: "pass",
+        recorded: [],
+        collapsed: [],
+        skipped: [],
+        keyDecisionsReminders: [],
+    };
+    for (const file of files) {
+        const absPath = resolve(baseRoot, file);
+        const relPath = relative(baseRoot, absPath).replace(/\\/g, "/");
+        if (!existsSync(absPath)) {
+            result.skipped.push({ file, reason: "unparseable" });
+            context.logger.warn(`[compass.summary.record] skipped ${file}: file not found`);
+            continue;
+        }
+        try {
+            const outcome = await recordSummaryItem(absPath, relPath, id, text, context.dryRun, policy);
+            if (outcome.skipReason) {
+                result.skipped.push({ file, reason: outcome.skipReason });
+                continue;
+            }
+            if (outcome.recorded) {
+                result.recorded.push(relPath);
+                if (outcome.collapsed)
+                    result.collapsed.push(relPath);
+                const source = await readFile(absPath, "utf8");
+                if (riskReminderNeeded(relPath, source, policy)) {
+                    result.keyDecisionsReminders.push(relPath);
+                    context.logger.warn(`[compass.summary.record] review KEY_DECISIONS in ${relPath}`);
+                }
+            }
+        }
+        catch (err) {
+            result.skipped.push({ file, reason: "unparseable" });
+            context.logger.warn(`[compass.summary.record] skipped ${file}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    return {
+        data: result,
+        exitCode: 0,
+        summary: `[compass.summary.record] recorded=${result.recorded.length}, collapsed=${result.collapsed.length}, skipped=${result.skipped.length}`,
+    };
+}
+//# sourceMappingURL=summary-record.js.map

package/dist/os/compass/handlers/summary-record.js.map

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

package/dist/os/compass/index.d.ts

@@ -4,5 +4,8 @@ export { resolveCompassScanRoot } from "./handlers/resolve-scan-root.ts";
 export { getRevisionByPath, type RevisionByPathResult } from "./handlers/git-revision.ts";
 export { runCompassInventory, runCompassValidation } from "./handlers/compass-inventory-handler.ts";
 export { runCompassAuditPlan, runCompassAuditRecord, runCompassAuditBaseline, runCompassAuditValidate, isAuditDue, } from "./handlers/compass-audit-handler.ts";
-export { runCompassChangeSummaryValidate, runCompassSummaryTrim, classifyChangeSummaryItem, type ChangeSummaryItemClass, } from "./handlers/compass-change-summary-handler.ts";
+export { runCompassSummaryTrim } from "./handlers/compass-change-summary-handler.ts";
+export { runCompassMigrate } from "./handlers/compass-migrate-handler.ts";
+export { migrateFile, migrateWorkspace, type MigrateAction, type MigrateResult, } from "./handlers/compass-migrate.ts";
+export { runCompassSummaryRecord, parseChangeSummary, mergeHistoryIds, buildChangeSummaryBlock, stripConventionalPrefix, isValidGovernanceId, CHANGE_SUMMARY_WINDOW, type SummaryRecordResult, type SummaryRecordSkipReason, } from "./handlers/summary-record.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/os/compass/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/compass/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,6BAA6B,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpG,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,GACX,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,EACrB,yBAAyB,EACzB,KAAK,sBAAsB,GAC5B,MAAM,8CAA8C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../os/compass/index.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,6BAA6B,EAC7B,KAAK,qBAAqB,GAC3B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpG,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,GACX,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,aAAa,GACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,8BAA8B,CAAC"}

package/dist/os/compass/index.js

@@ -7,6 +7,11 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0374: initial compass module barrel.</item>
+  <item>RFC-1095: compass.summary.record, trim repair rewrite, commit integration</item>
+  <item>RFC-1095: review findings: execFileSync git add, drop speculative barrel exports</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>
 */
 export { forgeCompassModule } from "./compass.module.js";
@@ -15,5 +20,8 @@ export { resolveCompassScanRoot } from "./handlers/resolve-scan-root.js";
 export { getRevisionByPath } from "./handlers/git-revision.js";
 export { runCompassInventory, runCompassValidation } from "./handlers/compass-inventory-handler.js";
 export { runCompassAuditPlan, runCompassAuditRecord, runCompassAuditBaseline, runCompassAuditValidate, isAuditDue, } from "./handlers/compass-audit-handler.js";
-export { runCompassChangeSummaryValidate, runCompassSummaryTrim, classifyChangeSummaryItem, } from "./handlers/compass-change-summary-handler.js";
+export { runCompassSummaryTrim } from "./handlers/compass-change-summary-handler.js";
+export { runCompassMigrate } from "./handlers/compass-migrate-handler.js";
+export { migrateFile, migrateWorkspace, } from "./handlers/compass-migrate.js";
+export { runCompassSummaryRecord, parseChangeSummary, mergeHistoryIds, buildChangeSummaryBlock, stripConventionalPrefix, isValidGovernanceId, CHANGE_SUMMARY_WINDOW, } from "./handlers/summary-record.js";
 //# sourceMappingURL=index.js.map

package/dist/os/compass/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/compass/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;EAUE;AAEF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,6BAA6B,GAE9B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAA6B,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpG,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,GACX,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,+BAA+B,EAC/B,qBAAqB,EACrB,yBAAyB,GAE1B,MAAM,8CAA8C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../os/compass/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;EAeE;AAEF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EACL,6BAA6B,GAE9B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,sBAAsB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,iBAAiB,EAA6B,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AACpG,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,UAAU,GACX,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EACL,WAAW,EACX,gBAAgB,GAGjB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,uBAAuB,EACvB,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,GAGtB,MAAM,8BAA8B,CAAC"}

package/dist/os/compass/policy.d.ts

@@ -0,0 +1,65 @@
+export type CompassRiskClass = "high" | "medium" | "low";
+export type CompassWorkspaceKind = "app" | "package" | "service";
+export interface CompassLayerRule {
+    pattern: string;
+    layer: string;
+    risk: CompassRiskClass;
+}
+export interface CompassExcludedPath {
+    pattern: string;
+    reason: string;
+}
+export interface CompassPolicySource {
+    /** Stack profile id that contributed a `compass:` section, or null. */
+    profile: string | null;
+    /** Keys the consumer's bindings.compass overrode. */
+    overriddenKeys: string[];
+}
+export interface CompassPolicy {
+    fileExtensions: ReadonlySet<string>;
+    testPatterns: readonly string[];
+    scanRoots: readonly string[];
+    ignoredDirs: ReadonlySet<string>;
+    ignoredDirPrefixes: readonly string[];
+    /** picomatch globs on the root-relative path that force riskClass=high. */
+    highRiskPaths: readonly string[];
+    /** Governance-ID detection pattern (unanchored, as configured). */
+    idPattern: RegExp;
+    /** `^(?:idPattern)$` — full-string governance-ID match. */
+    idPatternFull: RegExp;
+    /** `^(?:idPattern)` — leading governance-ID match. */
+    idPatternPrefix: RegExp;
+    purposeBoilerplatePatterns: readonly RegExp[];
+    /** Ordered first-match layer rules on the workspace-relative path. */
+    layerRules: readonly CompassLayerRule[];
+    workspaceKinds: Readonly<Record<string, CompassWorkspaceKind>>;
+    /** Workspace-relative globs that mark a file excluded with a reason. */
+    excludedPaths: readonly CompassExcludedPath[];
+    source: CompassPolicySource;
+    /** First-match layer rule for a workspace-relative path. */
+    matchLayer(workspaceRelativePath: string): CompassLayerRule | undefined;
+    /** Whether a root-relative path is forced high-risk. */
+    isHighRisk(pathFromRoot: string): boolean;
+    /** Whether a workspace-relative path is a test file. */
+    isTestPath(workspaceRelativePath: string): boolean;
+    /** Exclusion reason for a workspace-relative path, if any. */
+    excludedReason(workspaceRelativePath: string): string | undefined;
+}
+export declare class CompassPolicyConfigError extends Error {
+    readonly key: string;
+    constructor(key: string, detail: string);
+}
+/** Split a `NAMESPACE-NUMBER` governance ID on its last dash. */
+export declare function parseGovernanceIdParts(id: string): {
+    namespace: string;
+    numeric: number;
+} | null;
+/**
+ * Resolve the effective Compass policy for a workspace: generic defaults,
+ * overlaid by the stack profile `compass:` section (when forge.yaml declares
+ * `profile`), then by `bindings.compass`. Missing or unreadable forge.yaml
+ * yields the generic policy. Invalid regexes throw CompassPolicyConfigError
+ * naming the offending key.
+ */
+export declare function resolveCompassPolicy(workspaceRoot: string, forgeRoot?: string): CompassPolicy;
+//# sourceMappingURL=policy.d.ts.map

package/dist/os/compass/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../../os/compass/policy.ts"],"names":[],"mappings":"AAqBA,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AACzD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,SAAS,GAAG,SAAS,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,uEAAuE;IACvE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,qDAAqD;IACrD,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjC,kBAAkB,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,2EAA2E;IAC3E,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,eAAe,EAAE,MAAM,CAAC;IACxB,0BAA0B,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,sEAAsE;IACtE,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACxC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC/D,wEAAwE;IACxE,aAAa,EAAE,SAAS,mBAAmB,EAAE,CAAC;IAC9C,MAAM,EAAE,mBAAmB,CAAC;IAC5B,4DAA4D;IAC5D,UAAU,CAAC,qBAAqB,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IACxE,wDAAwD;IACxD,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;IAC1C,wDAAwD;IACxD,UAAU,CAAC,qBAAqB,EAAE,MAAM,GAAG,OAAO,CAAC;IACnD,8DAA8D;IAC9D,cAAc,CAAC,qBAAqB,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnE;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBACT,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAKxC;AAsID,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIhG;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,aAAa,CAyH7F"}