@warpgogol/forge 5.2.3 → 5.3.0

package/dist/src/utils/editable-region.d.ts

@@ -0,0 +1,46 @@
+export interface EditableRegionSplit {
+    /** Content up to and including the boundary line (marker or footer). */
+    generatedHead: string;
+    /** Content after the boundary line, verbatim. null when empty. */
+    customTail: string | null;
+    boundary: "marker" | "footer" | "none";
+}
+/**
+ * Canonical footer of a render — its last non-empty line. Callers that need
+ * the boundary value separately (doctor staleness, preserved-tail detection)
+ * derive it from the same render they pass to the merge.
+ */
+export declare function canonicalFooterOf(rendered: string): string | null;
+/**
+ * Split an existing editable generated file at its preservation boundary.
+ *
+ * Priority:
+ * 1. First line containing the `forge:custom` token (comment-style agnostic —
+ *    a token in prose is a documented, deliberate-looking boundary hazard).
+ *    The marker line and an immediately following canonical hint line belong
+ *    to the generated head.
+ * 2. `footerLine` (canonical template footer, derived by callers from the
+ *    render as its last non-empty line) — first occurrence is the boundary.
+ * 3. `"none"` — no resolvable boundary.
+ */
+export declare function splitEditableGenerated(content: string, filePath: string, footerLine?: string): EditableRegionSplit;
+/**
+ * Merge a fresh render with an existing editable generated file.
+ *
+ * The canonical footer is derived internally as the last non-empty line of
+ * `rendered` — no per-file-kind footer registry exists; when a template tail
+ * changes, the boundary follows the new render automatically.
+ *
+ * Merge contract:
+ * - `existing === null` (new file): rendered + boundary marker + hint.
+ * - marker boundary: head = fresh render + marker + hint; tail verbatim.
+ * - footer boundary (legacy marker-less file): head = fresh render + marker +
+ *   hint (marker introduced now); tail = content after the legacy footer line.
+ * - none + identical content: clean regeneration, marker + hint appended.
+ * - none + divergent content: returns null — caller must skip and warn
+ *   (`unmapped-customization`), never overwrite.
+ *
+ * The result is LF-normalized; callers write through `writeFileIfChanged`.
+ */
+export declare function mergeEditableGenerated(rendered: string, existing: string | null, filePath: string): string | null;
+//# sourceMappingURL=editable-region.d.ts.map

package/dist/src/utils/editable-region.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editable-region.d.ts","sourceRoot":"","sources":["../../../src/utils/editable-region.ts"],"names":[],"mappings":"AA4BA,MAAM,WAAW,mBAAmB;IAClC,wEAAwE;IACxE,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;CACxC;AAOD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,UAAU,CAAC,EAAE,MAAM,GAClB,mBAAmB,CAoCrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,QAAQ,EAAE,MAAM,GACf,MAAM,GAAG,IAAI,CAwBf"}

package/dist/src/utils/editable-region.js

@@ -0,0 +1,125 @@
+/*
+<MODULE_CONTRACT>
+<purpose>RFC-1153: preservation-boundary split/merge for editable generated
+files. Pure, no I/O — callers read the existing file and write the merged
+result through WorkspaceIO. The `forge:custom` marker line bounds the
+generator-owned head; everything below it is carried over verbatim.</purpose>
+<non-goals>
+  <item>Do not perform file I/O — operates on in-memory content strings only.</item>
+  <item>Do not apply to non-editable generated files — GENERATED_MARKER files
+  keep the RFC-0081 binary semantics (marker present = overwrite, absent = skip).</item>
+</non-goals>
+</MODULE_CONTRACT>
+<KEY_DECISIONS>
+  <item>forge:custom marker bounds the generated head; canonical footer is the fallback boundary when absent.</item>
+</KEY_DECISIONS>
+<CHANGE_SUMMARY>
+  <item>RFC-1153: initial — splitEditableGenerated + mergeEditableGenerated with
+  forge:custom marker boundary and canonical-footer (last non-empty render line) fallback.</item>
+</CHANGE_SUMMARY>
+*/
+import { CUSTOM_BOUNDARY_HINTS, CUSTOM_BOUNDARY_MARKERS, CUSTOM_BOUNDARY_TOKEN, commentStyleForPath, } from "./generated-marker.js";
+/** DNA-58 rule: boundary and footer matching normalize CRLF to LF. */
+function normalizeNewlines(text) {
+    return text.replace(/\r\n/g, "\n");
+}
+/**
+ * Canonical footer of a render — its last non-empty line. Callers that need
+ * the boundary value separately (doctor staleness, preserved-tail detection)
+ * derive it from the same render they pass to the merge.
+ */
+export function canonicalFooterOf(rendered) {
+    const lines = normalizeNewlines(rendered).split("\n");
+    for (let i = lines.length - 1; i >= 0; i--) {
+        const line = lines[i];
+        if (line !== undefined && line.trim() !== "")
+            return line;
+    }
+    return null;
+}
+/**
+ * Split an existing editable generated file at its preservation boundary.
+ *
+ * Priority:
+ * 1. First line containing the `forge:custom` token (comment-style agnostic —
+ *    a token in prose is a documented, deliberate-looking boundary hazard).
+ *    The marker line and an immediately following canonical hint line belong
+ *    to the generated head.
+ * 2. `footerLine` (canonical template footer, derived by callers from the
+ *    render as its last non-empty line) — first occurrence is the boundary.
+ * 3. `"none"` — no resolvable boundary.
+ */
+export function splitEditableGenerated(content, filePath, footerLine) {
+    const text = normalizeNewlines(content);
+    const style = commentStyleForPath(filePath);
+    const hint = CUSTOM_BOUNDARY_HINTS[style];
+    const lines = text.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line !== undefined && line.includes(CUSTOM_BOUNDARY_TOKEN)) {
+            let headEnd = i + 1;
+            if (lines[headEnd] === hint)
+                headEnd += 1;
+            const tail = lines.slice(headEnd).join("\n");
+            return {
+                generatedHead: lines.slice(0, headEnd).join("\n"),
+                customTail: tail.trim() === "" ? null : tail,
+                boundary: "marker",
+            };
+        }
+    }
+    if (footerLine !== undefined) {
+        // lastIndexOf: the canonical footer is the template's last line — the
+        // trailingmost occurrence is the correct boundary even when an operator
+        // copied the line into a mid-file section.
+        const idx = lines.lastIndexOf(footerLine);
+        if (idx >= 0) {
+            const tail = lines.slice(idx + 1).join("\n");
+            return {
+                generatedHead: lines.slice(0, idx + 1).join("\n"),
+                customTail: tail.trim() === "" ? null : tail,
+                boundary: "footer",
+            };
+        }
+    }
+    return { generatedHead: text, customTail: null, boundary: "none" };
+}
+/**
+ * Merge a fresh render with an existing editable generated file.
+ *
+ * The canonical footer is derived internally as the last non-empty line of
+ * `rendered` — no per-file-kind footer registry exists; when a template tail
+ * changes, the boundary follows the new render automatically.
+ *
+ * Merge contract:
+ * - `existing === null` (new file): rendered + boundary marker + hint.
+ * - marker boundary: head = fresh render + marker + hint; tail verbatim.
+ * - footer boundary (legacy marker-less file): head = fresh render + marker +
+ *   hint (marker introduced now); tail = content after the legacy footer line.
+ * - none + identical content: clean regeneration, marker + hint appended.
+ * - none + divergent content: returns null — caller must skip and warn
+ *   (`unmapped-customization`), never overwrite.
+ *
+ * The result is LF-normalized; callers write through `writeFileIfChanged`.
+ */
+export function mergeEditableGenerated(rendered, existing, filePath) {
+    const render = normalizeNewlines(rendered);
+    const style = commentStyleForPath(filePath);
+    const marker = CUSTOM_BOUNDARY_MARKERS[style];
+    const hint = CUSTOM_BOUNDARY_HINTS[style];
+    const boundaryBlock = `${marker}\n${hint}\n`;
+    if (existing === null) {
+        return `${render}${boundaryBlock}`;
+    }
+    const text = normalizeNewlines(existing);
+    const footer = canonicalFooterOf(render);
+    const split = splitEditableGenerated(text, filePath, footer ?? undefined);
+    if (split.boundary === "marker" || split.boundary === "footer") {
+        return `${render}${boundaryBlock}${split.customTail ?? ""}`;
+    }
+    if (text === render || text === `${render}${boundaryBlock}`) {
+        return `${render}${boundaryBlock}`;
+    }
+    return null;
+}
+//# sourceMappingURL=editable-region.js.map

package/dist/src/utils/editable-region.js.map

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

package/dist/src/utils/fs-idempotent.d.ts

@@ -1,2 +1,3 @@
-export declare function writeFileIfChanged(filePath: string, content: string | Uint8Array): Promise<"written" | "unchanged">;
+import type { WorkspaceIO } from "../types.ts";
+export declare function writeFileIfChanged(filePath: string, content: string | Uint8Array, io?: WorkspaceIO): Promise<"written" | "unchanged">;
 //# sourceMappingURL=fs-idempotent.d.ts.map

package/dist/src/utils/fs-idempotent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fs-idempotent.d.ts","sourceRoot":"","sources":["../../../src/utils/fs-idempotent.ts"],"names":[],"mappings":"AAgCA,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,UAAU,GAC3B,OAAO,CAAC,SAAS,GAAG,WAAW,CAAC,CAkBlC"}
+{"version":3,"file":"fs-idempotent.d.ts","sourceRoot":"","sources":["../../../src/utils/fs-idempotent.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAO/C,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GAAG,UAAU,EAC5B,EAAE,CAAC,EAAE,WAAW,GACf,OAAO,CAAC,SAAS,GAAG,WAAW,CAAC,CAmBlC"}

package/dist/src/utils/fs-idempotent.js

@@ -26,19 +26,23 @@ Sweep batch 2: real KEY_DECISIONS on 10 files, expanded purposes (CONTRACT-02/PU
 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
-import { readFile } from "node:fs/promises";
-import { writeFileAtomic } from "./fs-atomic.js";
-export async function writeFileIfChanged(filePath, content) {
+import { resolveIo } from "./io.js";
+// Forge-autonomy boundary (ADR-0019 / FORGE-AUTONOMY-01): `io` is optional and
+// TYPE-ONLY — forge's standalone CLI has no kernel context, so `resolveIo`
+// falls back to the ambient adapter. Kernel callers pass context.io so the
+// read-compare-write goes through the recording adapter.
+export async function writeFileIfChanged(filePath, content, io) {
+    const fio = resolveIo(io);
     try {
         if (typeof content === "string") {
-            const existing = await readFile(filePath, "utf8");
+            const existing = await fio.readFile(filePath);
             if (existing === content) {
                 return "unchanged";
             }
         }
         else {
-            const existing = await readFile(filePath);
-            if (Buffer.compare(existing, Buffer.from(content)) === 0) {
+            const existing = await fio.readFileBytes(filePath);
+            if (Buffer.compare(Buffer.from(existing), Buffer.from(content)) === 0) {
                 return "unchanged";
             }
         }
@@ -46,7 +50,7 @@ export async function writeFileIfChanged(filePath, content) {
     catch {
         // File does not exist — proceed to write.
     }
-    await writeFileAtomic(filePath, content);
+    await fio.writeFile(filePath, content);
     return "written";
 }
 //# sourceMappingURL=fs-idempotent.js.map

package/dist/src/utils/fs-idempotent.js.map

@@ -1 +1 @@
-{"version":3,"file":"fs-idempotent.js","sourceRoot":"","sources":["../../../src/utils/fs-idempotent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BE;AAEF,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,OAA4B;IAE5B,IAAI,CAAC;QACH,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAClD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC1C,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACzD,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,MAAM,eAAe,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"fs-idempotent.js","sourceRoot":"","sources":["../../../src/utils/fs-idempotent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2BE;AAGF,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,+EAA+E;AAC/E,2EAA2E;AAC3E,2EAA2E;AAC3E,yDAAyD;AACzD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB,EAChB,OAA4B,EAC5B,EAAgB;IAEhB,MAAM,GAAG,GAAG,SAAS,CAAC,EAAE,CAAC,CAAC;IAC1B,IAAI,CAAC;QACH,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAC9C,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;gBACzB,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;aAAM,CAAC;YACN,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;YACnD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtE,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,0CAA0C;IAC5C,CAAC;IACD,MAAM,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/src/utils/generated-marker.d.ts

@@ -1,6 +1,21 @@
 export declare const GENERATED_MARKER = "GENERATED. Do not change this line unless the file contains project specific changes.";
 export declare const EDITABLE_GENERATED_MARKER = "GENERATED. Safe to edit \u2014 project-specific changes are expected and encouraged.";
+/**
+ * RFC-1153: preservation boundary marker for editable generated files.
+ * Everything below the marker line is carried over verbatim on regeneration;
+ * everything above (including the marker line itself) is generator-owned.
+ * Emitted in the file's comment style — see CUSTOM_BOUNDARY_MARKERS.
+ */
+export declare const CUSTOM_BOUNDARY_TOKEN = "forge:custom";
+export declare const CUSTOM_BOUNDARY_MARKERS: Record<GeneratedHeaderCommentStyle, string>;
+export declare const CUSTOM_BOUNDARY_HINTS: Record<GeneratedHeaderCommentStyle, string>;
 export declare function hasGeneratedMarker(content: string): boolean;
+/**
+ * RFC-1153: true only for files carrying the editable marker. A file bearing
+ * just GENERATED_MARKER is fully generator-owned (RFC-0081) — the merge
+ * upgrades it to the editable boundary contract instead of skipping it.
+ */
+export declare function hasEditableGeneratedMarker(content: string): boolean;
 export interface StripGeneratedMarkerResult {
     changed: boolean;
     content: string;
@@ -23,6 +38,8 @@ export interface GeneratedHeaderInput {
      */
     editable?: boolean;
 }
+export type GeneratedHeaderCommentStyle = "line-slash" | "line-hash" | "block-html" | "block-css";
+export declare function commentStyleForPath(filePath: string): GeneratedHeaderCommentStyle;
 export declare function buildGeneratedHeader(input: GeneratedHeaderInput): string;
 export declare function isGeneratedMarkerTextCandidate(filePath: string): boolean;
 //# sourceMappingURL=generated-marker.d.ts.map

package/dist/src/utils/generated-marker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generated-marker.d.ts","sourceRoot":"","sources":["../../../src/utils/generated-marker.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,gBAAgB,0FAC4D,CAAC;AAE1F,eAAO,MAAM,yBAAyB,yFAC6C,CAAC;AAMpF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,CAuDhF;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAsBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CA+BxE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiBxE"}
+{"version":3,"file":"generated-marker.d.ts","sourceRoot":"","sources":["../../../src/utils/generated-marker.ts"],"names":[],"mappings":"AAgBA,eAAO,MAAM,gBAAgB,0FAC4D,CAAC;AAE1F,eAAO,MAAM,yBAAyB,yFAC6C,CAAC;AAEpF;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,iBAAiB,CAAC;AAEpD,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,2BAA2B,EAAE,MAAM,CAK/E,CAAC;AAKF,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,2BAA2B,EAAE,MAAM,CAK7E,CAAC;AAMF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnE;AAED,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,0BAA0B,CAuDhF;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,2BAA2B,GAAG,YAAY,GAAG,WAAW,GAAG,YAAY,GAAG,WAAW,CAAC;AAElG,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,2BAA2B,CAgBjF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,MAAM,CA+BxE;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAiBxE"}

package/dist/src/utils/generated-marker.js

@@ -15,11 +15,39 @@ source (dependency inversion).</purpose>
 */
 export const GENERATED_MARKER = "GENERATED. Do not change this line unless the file contains project specific changes.";
 export const EDITABLE_GENERATED_MARKER = "GENERATED. Safe to edit — project-specific changes are expected and encouraged.";
+/**
+ * RFC-1153: preservation boundary marker for editable generated files.
+ * Everything below the marker line is carried over verbatim on regeneration;
+ * everything above (including the marker line itself) is generator-owned.
+ * Emitted in the file's comment style — see CUSTOM_BOUNDARY_MARKERS.
+ */
+export const CUSTOM_BOUNDARY_TOKEN = "forge:custom";
+export const CUSTOM_BOUNDARY_MARKERS = {
+    "line-slash": "// forge:custom",
+    "line-hash": "# forge:custom",
+    "block-html": "<!-- forge:custom -->",
+    "block-css": "/* forge:custom */",
+};
+const CUSTOM_BOUNDARY_HINT_TEXT = "Add workspace-specific guidance below this line. Everything below is preserved on regeneration.";
+export const CUSTOM_BOUNDARY_HINTS = {
+    "line-slash": `// ${CUSTOM_BOUNDARY_HINT_TEXT}`,
+    "line-hash": `# ${CUSTOM_BOUNDARY_HINT_TEXT}`,
+    "block-html": `<!-- ${CUSTOM_BOUNDARY_HINT_TEXT} -->`,
+    "block-css": `/* ${CUSTOM_BOUNDARY_HINT_TEXT} */`,
+};
 const DO_NOT_EDIT_LINE = "DO NOT EDIT THIS FILE. Changes are overwritten on the next build.";
 const SAFE_TO_EDIT_LINE = "This file is generated but editable — your changes are preserved on regeneration.";
 export function hasGeneratedMarker(content) {
     return content.includes(GENERATED_MARKER) || content.includes(EDITABLE_GENERATED_MARKER);
 }
+/**
+ * RFC-1153: true only for files carrying the editable marker. A file bearing
+ * just GENERATED_MARKER is fully generator-owned (RFC-0081) — the merge
+ * upgrades it to the editable boundary contract instead of skipping it.
+ */
+export function hasEditableGeneratedMarker(content) {
+    return content.includes(EDITABLE_GENERATED_MARKER);
+}
 function escapeRegex(str) {
     return str.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
@@ -70,7 +98,7 @@ export function stripGeneratedMarker(content) {
     }
     return { changed, content: result };
 }
-function commentStyleForPath(filePath) {
+export function commentStyleForPath(filePath) {
     const lower = filePath.toLowerCase().replace(/\\/g, "/");
     const base = lower.slice(lower.lastIndexOf("/") + 1);
     if (base === ".gitattributes" ||

package/dist/src/utils/generated-marker.js.map

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

package/dist/src/utils/index.d.ts

@@ -1,7 +1,9 @@
 export { writeFileAtomic, type WriteFileAtomicOptions } from "./fs-atomic.ts";
 export { writeFileIfChanged } from "./fs-idempotent.ts";
-export { GENERATED_MARKER, EDITABLE_GENERATED_MARKER, hasGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, isGeneratedMarkerTextCandidate, type GeneratedHeaderInput, type StripGeneratedMarkerResult, } from "./generated-marker.ts";
+export { GENERATED_MARKER, EDITABLE_GENERATED_MARKER, CUSTOM_BOUNDARY_TOKEN, CUSTOM_BOUNDARY_MARKERS, CUSTOM_BOUNDARY_HINTS, hasGeneratedMarker, hasEditableGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, commentStyleForPath, isGeneratedMarkerTextCandidate, type GeneratedHeaderCommentStyle, type GeneratedHeaderInput, type StripGeneratedMarkerResult, } from "./generated-marker.ts";
+export { splitEditableGenerated, mergeEditableGenerated, canonicalFooterOf, type EditableRegionSplit, } from "./editable-region.ts";
 export { toKebabCase } from "./string-utils.ts";
+export { alignMarkdownTable, parseMarkdownTable, type ParsedMarkdownTable, } from "./markdown-table.ts";
 export { collectFiles, fileExists, type CollectFilesOptions } from "./fs.ts";
 export { byteHash } from "./hash.ts";
 export { trashPath } from "./fs-trash.ts";

package/dist/src/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,EAC9B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAwBA,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,8BAA8B,EAC9B,KAAK,2BAA2B,EAChC,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,GAChC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,mBAAmB,GACzB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/utils/index.js

@@ -23,8 +23,10 @@ Sweep batch 4: 73 Compass headers on headerless engine files (certification, com
 */
 export { writeFileAtomic } from "./fs-atomic.js";
 export { writeFileIfChanged } from "./fs-idempotent.js";
-export { GENERATED_MARKER, EDITABLE_GENERATED_MARKER, hasGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, isGeneratedMarkerTextCandidate, } from "./generated-marker.js";
+export { GENERATED_MARKER, EDITABLE_GENERATED_MARKER, CUSTOM_BOUNDARY_TOKEN, CUSTOM_BOUNDARY_MARKERS, CUSTOM_BOUNDARY_HINTS, hasGeneratedMarker, hasEditableGeneratedMarker, stripGeneratedMarker, buildGeneratedHeader, commentStyleForPath, isGeneratedMarkerTextCandidate, } from "./generated-marker.js";
+export { splitEditableGenerated, mergeEditableGenerated, canonicalFooterOf, } from "./editable-region.js";
 export { toKebabCase } from "./string-utils.js";
+export { alignMarkdownTable, parseMarkdownTable, } from "./markdown-table.js";
 export { collectFiles, fileExists } from "./fs.js";
 export { byteHash } from "./hash.js";
 export { trashPath } from "./fs-trash.js";

package/dist/src/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;EAsBE;AAEF,OAAO,EAAE,eAAe,EAA+B,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,oBAAoB,EACpB,8BAA8B,GAG/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,UAAU,EAA4B,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;EAsBE;AAEF,OAAO,EAAE,eAAe,EAA+B,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,8BAA8B,GAI/B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,GAElB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,UAAU,EAA4B,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/src/utils/io.d.ts

@@ -0,0 +1,9 @@
+import type { WorkspaceIO } from "../types.ts";
+/**
+ * The ambient adapter — real fs, no intent recording. Used by forge helpers
+ * when no `io` is injected (standalone `forge` CLI path).
+ */
+export declare const ambientIo: WorkspaceIO;
+/** Resolve the effective io for a helper: injected port or ambient default. */
+export declare function resolveIo(io?: WorkspaceIO): WorkspaceIO;
+//# sourceMappingURL=io.d.ts.map

package/dist/src/utils/io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"io.d.ts","sourceRoot":"","sources":["../../../src/utils/io.ts"],"names":[],"mappings":"AAoCA,OAAO,KAAK,EAA2B,WAAW,EAAE,MAAM,aAAa,CAAC;AAkCxE;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,WA+DvB,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,EAAE,CAAC,EAAE,WAAW,GAAG,WAAW,CAEvD"}

package/dist/src/utils/io.js

@@ -0,0 +1,130 @@
+/*
+<MODULE_CONTRACT>
+<purpose>
+RFC-1152 (Wave 2a): the standalone-CLI ambient WorkspaceIO adapter. Forge
+helpers take an optional `io?: WorkspaceIO` — when absent, `resolveIo` returns
+this ambient adapter so the standalone `forge` CLI keeps working without a
+kernel context. Kernel callers (`forge/os` handlers) pass `context.io` through.
+</purpose>
+<non-goals>
+  <item>Do not record WriteIntents — forge CLI has no execution-report surface.</item>
+  <item>Do not enforce sync parity — WorkspaceIO is async-only; sync helpers stay ambient.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<KEY_DECISIONS>
+  <item>createDefaultIO is deliberately unused — forge keeps a minimal ambient adapter for the standalone CLI.</item>
+</KEY_DECISIONS>
+<CHANGE_SUMMARY>
+  <item>RFC-1152 Wave 2a: initial ambient adapter for forge standalone CLI.</item>
+</CHANGE_SUMMARY>
+*/
+import { readFile as fsReadFile, mkdir as fsMkdir, rm as fsRm, readdir as fsReaddir, stat as fsStat, rename as fsRename, appendFile as fsAppendFile, copyFile as fsCopyFile, mkdtemp as fsMkdtemp, realpath as fsRealpath, glob as fsGlob, } from "node:fs/promises";
+import { spawn } from "node:child_process";
+import { dirname } from "node:path";
+import { writeFileAtomic } from "./fs-atomic.js";
+async function execImpl(command, args, opts) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd: opts?.cwd,
+            env: opts?.env ? { ...process.env, ...opts.env } : undefined,
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout?.on("data", (chunk) => {
+            stdout += chunk;
+        });
+        child.stderr?.on("data", (chunk) => {
+            stderr += chunk;
+        });
+        const timer = opts?.timeoutMs
+            ? setTimeout(() => {
+                child.kill();
+            }, opts.timeoutMs)
+            : undefined;
+        timer?.unref?.();
+        child.on("close", (exitCode) => {
+            if (timer)
+                clearTimeout(timer);
+            resolve({ exitCode, stdout, stderr });
+        });
+        child.on("error", (error) => {
+            if (timer)
+                clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+/**
+ * The ambient adapter — real fs, no intent recording. Used by forge helpers
+ * when no `io` is injected (standalone `forge` CLI path).
+ */
+export const ambientIo = {
+    async readFile(path) {
+        return fsReadFile(path, "utf8");
+    },
+    async readFileBytes(path) {
+        return fsReadFile(path);
+    },
+    async exists(path) {
+        try {
+            await fsStat(path);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+    async glob(pattern, opts) {
+        const results = [];
+        for await (const entry of fsGlob(pattern, { cwd: opts?.cwd })) {
+            results.push(entry);
+        }
+        return results;
+    },
+    async readdir(path) {
+        const entries = await fsReaddir(path, { withFileTypes: true });
+        return entries.map((entry) => ({
+            name: entry.name,
+            isFile: entry.isFile(),
+            isDirectory: entry.isDirectory(),
+        }));
+    },
+    async stat(path) {
+        const s = await fsStat(path);
+        return { isFile: s.isFile(), isDirectory: s.isDirectory(), mtimeMs: s.mtimeMs, size: s.size };
+    },
+    async realpath(path) {
+        return fsRealpath(path);
+    },
+    async writeFile(path, content) {
+        await fsMkdir(dirname(path), { recursive: true });
+        await writeFileAtomic(path, content);
+    },
+    async appendFile(path, content) {
+        await fsMkdir(dirname(path), { recursive: true });
+        await fsAppendFile(path, content);
+    },
+    async mkdir(path) {
+        await fsMkdir(path, { recursive: true });
+    },
+    async rm(path, opts) {
+        await fsRm(path, { recursive: opts?.recursive ?? true, force: true });
+    },
+    async rename(src, dst) {
+        await fsMkdir(dirname(dst), { recursive: true });
+        await fsRename(src, dst);
+    },
+    async copyFile(src, dst) {
+        await fsMkdir(dirname(dst), { recursive: true });
+        await fsCopyFile(src, dst);
+    },
+    async mkdtemp(prefix) {
+        return fsMkdtemp(prefix);
+    },
+    exec: execImpl,
+};
+/** Resolve the effective io for a helper: injected port or ambient default. */
+export function resolveIo(io) {
+    return io ?? ambientIo;
+}
+//# sourceMappingURL=io.js.map

package/dist/src/utils/io.js.map

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

package/dist/src/utils/markdown-table.d.ts

@@ -0,0 +1,21 @@
+export interface ParsedMarkdownTable {
+    headers: string[];
+    rows: string[][];
+}
+/**
+ * Emit a prettier-normal markdown table: every cell is space-padded so all
+ * `|` delimiters align per column, and the separator row is dashes repeated
+ * to each column's width. Column width is max(3, widest cell content).
+ *
+ * Rows may be shorter or longer than headers — missing cells become empty,
+ * extra cells extend the column set.
+ */
+export declare function alignMarkdownTable(headers: string[], rows: string[][]): string;
+/**
+ * Parse a markdown table into headers + rows. Returns null when the input is
+ * not a table (missing separator row). The separator row is detected by
+ * cells matching `:?-+:?` and is dropped — alignment colons are normalized
+ * away on re-emission (forge emitters never produce them).
+ */
+export declare function parseMarkdownTable(text: string): ParsedMarkdownTable | null;
+//# sourceMappingURL=markdown-table.d.ts.map

package/dist/src/utils/markdown-table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown-table.d.ts","sourceRoot":"","sources":["../../../src/utils/markdown-table.ts"],"names":[],"mappings":"AA2BA,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,MAAM,CA2B9E;AA6BD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAkB3E"}