@warpgogol/forge 5.3.4 → 6.2.0

package/dist/os/compass/handlers/compass-docs-validate.d.ts

@@ -0,0 +1,13 @@
+import type { Diagnostic } from "../../../src/types.ts";
+import type { ForgeCommandInput, ForgeCommandResult, ForgeRuntimeContext } from "../../../src/types.ts";
+export declare function runCompassDocsValidate(input: ForgeCommandInput, context: ForgeRuntimeContext): Promise<ForgeCommandResult<{
+    command: "compass.docs.validate";
+    status: "pass" | "fail";
+    scanned: {
+        xmlFiles: number;
+        pathsChecked: number;
+        idsChecked: number;
+    };
+    diagnostics: Diagnostic[];
+}>>;
+//# sourceMappingURL=compass-docs-validate.d.ts.map

package/dist/os/compass/handlers/compass-docs-validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compass-docs-validate.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/compass-docs-validate.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,uBAAuB,CAAC;AACrE,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AA6M/B,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CACR,kBAAkB,CAAC;IACjB,OAAO,EAAE,uBAAuB,CAAC;IACjC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;IACxB,OAAO,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC;IACxE,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B,CAAC,CACH,CAsHA"}

package/dist/os/compass/handlers/compass-docs-validate.js

@@ -0,0 +1,328 @@
+/*
+<MODULE_CONTRACT>
+<purpose>RFC-1242: validate that the live root docs/*.xml corpus describes the repository as it exists — every path token, workspace id, and knowledge-graph link target must resolve to a real file, directory, or declared node.</purpose>
+<non-goals>
+  <item>Do not scan archived trees, vendored specs, sessions/metrics, or authored RFC/ADR/plan bodies — frozen history and forward-looking prose legitimately name paths that do not exist.</item>
+  <item>Do not validate markdown link targets — only the XML semantic layer is gated (markdown sweep is manual).</item>
+  <item>Do not mutate anything — this handler is read-only; pruning lives on compass.audit.validate --prune.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<KEY_DECISIONS>
+  <item>Tag-stack tokenizer over an XML dependency — small authored corpus; a balance check catches literal-tag breakage (COMPASS-DOC-00).</item>
+  <item>Link targets resolve to declared node ids OR file/dir conventions (DOC-03) — dangling-by-convention stays a warning, never an error.</item>
+</KEY_DECISIONS>
+<CHANGE_SUMMARY>
+  <item>RFC-1242: review fixes — self-close detection strips quoted attr values first (a="foo/" no longer fakes a self-close), non-backticked path tokens get the same ellipsis strip, docs.* link slugs keep their basename prefix (docs.plans.plan-rfc-* resolves).</item>
+  <item>RFC-1242: created — scan docs/*.xml for unresolvable paths, workspace ids, and link targets (COMPASS-DOC-00..03).</item>
+  <item>RFC-1249: wire werkstatt.commands.validate into packages.check + retire CMD-OUTPUT debt</item>
+</CHANGE_SUMMARY>
+*/
+import { resolve } from "node:path";
+import { resolveIo } from "../../../src/utils/io.js";
+const DOCS_GLOB = "*.xml";
+// Well-formedness: minimal tag-stack check. Skips comments, CDATA, PIs and
+// declarations; a literal `<name` inside prose opens a tag that never balances
+// → COMPASS-DOC-00. The corpus is authored XML without < in attribute values.
+function checkWellFormed(file, source) {
+    const stack = [];
+    let i = 0;
+    let line = 1;
+    const advanceLine = (chunk) => {
+        for (const c of chunk)
+            if (c === "\n")
+                line++;
+    };
+    while (i < source.length) {
+        const open = source.indexOf("<", i);
+        if (open === -1)
+            break;
+        advanceLine(source.slice(i, open));
+        const rest = source.slice(open);
+        // comments / CDATA / PI / declarations
+        if (rest.startsWith("<!--")) {
+            const end = source.indexOf("-->", open + 4);
+            if (end === -1)
+                return { line, message: "unterminated comment" };
+            advanceLine(source.slice(open, end + 3));
+            i = end + 3;
+            continue;
+        }
+        if (rest.startsWith("<![CDATA[")) {
+            const end = source.indexOf("]]>", open + 9);
+            if (end === -1)
+                return { line, message: "unterminated CDATA" };
+            advanceLine(source.slice(open, end + 3));
+            i = end + 3;
+            continue;
+        }
+        if (rest.startsWith("<?")) {
+            const end = source.indexOf("?>", open + 2);
+            if (end === -1)
+                return { line, message: "unterminated processing instruction" };
+            advanceLine(source.slice(open, end + 2));
+            i = end + 2;
+            continue;
+        }
+        if (rest.startsWith("<!")) {
+            const end = source.indexOf(">", open + 2);
+            if (end === -1)
+                return { line, message: "unterminated declaration" };
+            advanceLine(source.slice(open, end + 1));
+            i = end + 1;
+            continue;
+        }
+        const tagMatch = /^<(\/?)([A-Za-z_][\w:.-]*)((?:"[^"]*"|'[^']*'|[^>"'])*)?(\/?)>/.exec(rest);
+        if (!tagMatch) {
+            // `<` not starting a tag — literal text, tolerated.
+            advanceLine(source.slice(open, open + 1));
+            i = open + 1;
+            continue;
+        }
+        const [, closing, name, attrs = "", selfClose] = tagMatch;
+        advanceLine(tagMatch[0]);
+        i = open + tagMatch[0].length;
+        if (closing === "/") {
+            const top = stack.pop();
+            if (!top || top.name !== name) {
+                return {
+                    line,
+                    message: `mismatched closing tag </${name}>${top ? ` — expected </${top.name}> opened at line ${top.line}` : " — no open tag"}`,
+                };
+            }
+            continue;
+        }
+        const attrsUnquoted = attrs.replace(/"[^"]*"|'[^']*'/g, "");
+        if (selfClose !== "/" && !attrsUnquoted.trimEnd().endsWith("/")) {
+            stack.push({ name, line });
+        }
+    }
+    if (stack.length > 0) {
+        const top = stack[stack.length - 1];
+        return { line: top.line, message: `unclosed tag <${top.name}>` };
+    }
+    return null;
+}
+function extractRefs(source) {
+    const refs = { paths: [], workspaceIds: [], linkTargets: [] };
+    const lineOf = (index) => source.slice(0, index).split("\n").length;
+    for (const m of source.matchAll(/<path>([\s\S]*?)<\/path>/g)) {
+        refs.paths.push({ value: m[1] ?? "", line: lineOf(m.index) });
+    }
+    for (const m of source.matchAll(/<workspace\s[^>]*?id="([^"]+)"/g)) {
+        refs.workspaceIds.push({ id: m[1], line: lineOf(m.index) });
+    }
+    for (const m of source.matchAll(/<node\s[^>]*>/g)) {
+        // DOC-02 only applies to ids that claim a workspace: <workspace> entries
+        // and workspace-typed nodes. Layer/symbolic ids (apps.rules,
+        // packages.rules, changelog.*) name semantic handles, not directories.
+        const id = /\bid="([^"]+)"/.exec(m[0])?.[1];
+        const type = /\btype="([^"]+)"/.exec(m[0])?.[1];
+        if (id && type === "workspace") {
+            refs.workspaceIds.push({ id, line: lineOf(m.index) });
+        }
+    }
+    for (const m of source.matchAll(/<link\s[^>]*?target="([^"]+)"/g)) {
+        refs.linkTargets.push({ target: m[1], line: lineOf(m.index) });
+    }
+    return refs;
+}
+// Normalize a <path> payload into checkable path tokens. Each backticked
+// fragment is one candidate — splitting on commas inside would shred brace
+// expansions (`{a,b}`) and ellipsis ranges (`docs/x/…` … `leaf`). A bare tail
+// fragment after an `…` outside the backticks resolves under the previous
+// fragment's directory (range shorthand for two versions of the same dir).
+function pathTokens(raw) {
+    const tokens = [];
+    const fragments = [...raw.matchAll(/`([^`]*)`/g)].map((m) => m[1].trim());
+    if (fragments.length === 0) {
+        return raw
+            .split(/[\s,]+/)
+            .map((t) => t
+            .trim()
+            .replace(/(?:…|\.\.\.).*$/, "")
+            .replace(/\/+$/, ""))
+            .filter((t) => t.length > 0 && !t.startsWith("<") && t !== "…" && t !== "+");
+    }
+    const joinsWithEllipsis = raw.replace(/`[^`]*`/g, "").includes("…");
+    let parentDir = null;
+    for (const frag of fragments) {
+        const cleaned = frag.replace(/(?:…|\.\.\.).*$/, "").replace(/\/+$/, "");
+        if (!cleaned || cleaned === "+")
+            continue;
+        if (joinsWithEllipsis && !cleaned.includes("/") && parentDir) {
+            tokens.push(`${parentDir}/${cleaned}`);
+            continue;
+        }
+        tokens.push(cleaned);
+        parentDir = cleaned.split("/").slice(0, -1).join("/") || parentDir;
+    }
+    return tokens;
+}
+/** Directory prefix that must exist for a path token (glob tails trimmed). */
+function pathCheckTarget(token) {
+    const globIdx = token.search(/[*{[]/);
+    if (globIdx === -1)
+        return token;
+    const prefix = token.slice(0, globIdx);
+    return prefix.replace(/\/[^/]*$/, "") || ".";
+}
+/** Resolve a workspace-style id to the package/service directory it names. */
+function workspaceIdTarget(id) {
+    const pkg = /^pkg-([a-z0-9-]+)$/.exec(id);
+    if (pkg)
+        return `packages/${pkg[1]}`;
+    const svc = /^svc-([a-z0-9-]+)$/.exec(id);
+    if (svc)
+        return `services/${svc[1]}`;
+    const app = /^app-([a-z0-9-]+)$/.exec(id);
+    if (app)
+        return `apps/${app[1]}`;
+    const dotted = /^(packages|apps|services)\.([a-z0-9-]+)/.exec(id);
+    if (dotted)
+        return `${dotted[1]}/${dotted[2]}`;
+    return null;
+}
+/**
+ * DOC-03 resolution for dotted link targets: declared node id (checked by the
+ * caller) or a file/dir convention — docs.<dir>.<slug> → docs/<dir>/<slug>*,
+ * packages./apps./services. → workspace dir, spec.<x> → docs/specs/<x>*,
+ * dna-N → docs/architecture-dna.md, dotted command names → command manifest.
+ */
+async function linkTargetResolves(target, declaredIds, io, docsDir, commandNames) {
+    if (declaredIds.has(target))
+        return "node";
+    if (commandNames.has(target))
+        return "file";
+    if (/^dna-\d+$/.test(target)) {
+        return (await io.exists(resolve(docsDir, "architecture-dna.md"))) ? "file" : "none";
+    }
+    const docsId = /^docs\.([a-z-]+)\.(.+)$/.exec(target);
+    if (docsId) {
+        const [, dir, slug] = docsId;
+        const hits = await io.glob(`${dir}/**/*${slug}*.md`, { cwd: docsDir }).catch(() => []);
+        if (hits.length > 0)
+            return "file";
+        // generic fallback: any file whose basename contains the slug under docs/
+        const broad = await io.glob(`**/*${slug}*`, { cwd: docsDir }).catch(() => []);
+        if (broad.length > 0)
+            return "file";
+        return "none";
+    }
+    const ws = workspaceIdTarget(target);
+    if (ws)
+        return (await io.exists(ws)) ? "file" : "none";
+    const spec = /^spec\.([a-z0-9-]+)$/.exec(target);
+    if (spec) {
+        const hits = await io.glob(`specs/${spec[1]}*/**`, { cwd: docsDir }).catch(() => []);
+        const dirs = await io.glob(`specs/${spec[1]}*`, { cwd: docsDir }).catch(() => []);
+        return hits.length + dirs.length > 0 ? "file" : "none";
+    }
+    return "none";
+}
+export async function runCompassDocsValidate(input, context) {
+    const io = resolveIo(context.io);
+    const docsDir = resolve(context.workspaceRoot, "docs");
+    const diagnostics = [];
+    let pathsChecked = 0;
+    let idsChecked = 0;
+    // Command-name convention for DOC-03: dotted targets like ratgeber.hub.validate
+    // resolve when the command registry lists them.
+    const commandNames = new Set();
+    const manifestPath = resolve(docsDir, "command-manifest.generated.yaml");
+    if (await io.exists(manifestPath)) {
+        const manifest = await io.readFile(manifestPath);
+        for (const m of manifest.matchAll(/^\s*- name: ([\w.-]+)\s*$/gm)) {
+            commandNames.add(m[1]);
+        }
+    }
+    const xmlFiles = (await io.glob(DOCS_GLOB, { cwd: docsDir })).sort();
+    const declaredNodeIds = new Set();
+    // Pass 1: collect declared node ids so link targets can resolve across files.
+    const sources = new Map();
+    for (const rel of xmlFiles) {
+        const abs = resolve(docsDir, rel);
+        const source = await io.readFile(abs);
+        sources.set(rel, source);
+        for (const m of source.matchAll(/<node\s[^>]*?id="([^"]+)"/g)) {
+            declaredNodeIds.add(m[1]);
+        }
+    }
+    for (const rel of xmlFiles) {
+        const file = `docs/${rel}`;
+        const source = sources.get(rel);
+        const malformed = checkWellFormed(file, source);
+        if (malformed) {
+            diagnostics.push({
+                ruleId: "COMPASS-DOC-00",
+                severity: "error",
+                file,
+                line: malformed.line,
+                message: `file is not well-formed XML: ${malformed.message}`,
+            });
+            continue; // refs from a broken file are noise
+        }
+        const refs = extractRefs(source);
+        for (const { value, line } of refs.paths) {
+            for (const token of pathTokens(value)) {
+                pathsChecked++;
+                const target = pathCheckTarget(token);
+                if (!(await io.exists(resolve(context.workspaceRoot, target)))) {
+                    diagnostics.push({
+                        ruleId: "COMPASS-DOC-01",
+                        severity: "error",
+                        file,
+                        line,
+                        message: `<path> references '${token}' — does not exist under the workspace root`,
+                        fixHint: "Repoint to the live path or remove the stale reference",
+                    });
+                }
+            }
+        }
+        for (const { id, line } of refs.workspaceIds) {
+            const target = workspaceIdTarget(id);
+            if (!target)
+                continue;
+            idsChecked++;
+            if (!(await io.exists(resolve(context.workspaceRoot, target)))) {
+                diagnostics.push({
+                    ruleId: "COMPASS-DOC-02",
+                    severity: "error",
+                    file,
+                    line,
+                    message: `id '${id}' names workspace path '${target}' — does not exist`,
+                    fixHint: "Repoint to the live package or remove the stale entry",
+                });
+            }
+        }
+        for (const { target, line } of refs.linkTargets) {
+            idsChecked++;
+            const resolved = await linkTargetResolves(target, declaredNodeIds, io, docsDir, commandNames);
+            if (resolved === "none") {
+                diagnostics.push({
+                    ruleId: "COMPASS-DOC-03",
+                    severity: "warning",
+                    file,
+                    line,
+                    message: `link target '${target}' resolves to no declared node and no file`,
+                });
+            }
+        }
+    }
+    const errors = diagnostics.filter((d) => d.severity === "error");
+    for (const d of diagnostics) {
+        context.logger[d.severity === "error" ? "error" : "warn"](`[compass.docs.validate] ${d.ruleId}: ${d.file}${d.line ? `:${d.line}` : ""}: ${d.message}`);
+    }
+    return {
+        data: {
+            command: "compass.docs.validate",
+            status: errors.length === 0 ? "pass" : "fail",
+            scanned: { xmlFiles: xmlFiles.length, pathsChecked, idsChecked },
+            diagnostics,
+        },
+        exitCode: errors.length > 0 ? 1 : 0,
+        summary: errors.length === 0
+            ? `[compass.docs.validate] OK (${xmlFiles.length} files, ${pathsChecked} paths, ${idsChecked} ids)`
+            : `[compass.docs.validate] ${errors.length} error(s)`,
+    };
+}
+//# sourceMappingURL=compass-docs-validate.js.map

package/dist/os/compass/handlers/compass-docs-validate.js.map

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

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

@@ -7,7 +7,7 @@ export interface SummaryRecordInput {
     text?: string;
     workpiece?: string;
 }
-export type SummaryRecordSkipReason = "no-block" | "duplicate" | "unparseable";
+export type SummaryRecordSkipReason = "no-block" | "duplicate" | "unparseable" | "id-in-diff";
 export interface SummaryRecordResult {
     command: "compass.summary.record";
     status: "pass";
@@ -34,6 +34,13 @@ export declare function mergeHistoryIds(existing: string[], incoming: 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;
+/**
+ * Remove a trailing git-trailer block: the contiguous tail of strict
+ * trailer lines and admitted markdown-link lines. A blank line ends the
+ * tail paragraph. Returns the message without the block; when the tail
+ * holds no strict trailer line the message is returned unchanged.
+ */
+export declare function stripGitTrailers(message: string): string;
 export declare function sanitizeItemText(text: string): string;
 export declare function isValidGovernanceId(id: string, policy: CompassPolicy): boolean;
 interface RecordOutcome {
@@ -44,8 +51,10 @@ interface RecordOutcome {
 /**
  * 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.
+ * `headSource` is the file's content at HEAD (when resolvable) — it enables
+ * the id-in-diff dedup; pass undefined outside git workspaces.
  */
-export declare function recordSummaryItem(absPath: string, relPath: string, id: string, text: string, dryRun: boolean, policy: CompassPolicy): Promise<RecordOutcome>;
+export declare function recordSummaryItem(absPath: string, relPath: string, id: string, text: string, dryRun: boolean, policy: CompassPolicy, headSource?: string): 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

@@ -1 +1 @@
-{"version":3,"file":"summary-record.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/summary-record.ts"],"names":[],"mappings":"AAuCA,OAAO,EAAgD,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAOhG,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;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,aAAa,GACpB,MAAM,EAAE,CAcV;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,CAqElD"}
+{"version":3,"file":"summary-record.d.ts","sourceRoot":"","sources":["../../../../os/compass/handlers/summary-record.ts"],"names":[],"mappings":"AAiCA,OAAO,EAAgD,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAOhG,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,GAAG,YAAY,CAAC;AAE9F,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;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,EAAE,aAAa,GACpB,MAAM,EAAE,CAcV;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;AAWD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkBxD;AAQD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASrD;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;;;;;GAKG;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,EACrB,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,CAAC,CA8DxB;AA8BD,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,kBAAkB,CAAC,mBAAmB,CAAC,CAAC,CAoFlD"}

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

@@ -15,23 +15,17 @@ items to CHANGE_SUMMARY blocks per RFC-1095. Collapses the 5-item window into
   <item>Item text is sanitized on record — literal Compass tags would corrupt history parsing.</item>
 </KEY_DECISIONS>
 <CHANGE_SUMMARY>
-  <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>
   <item>RFC-1220: step 2 — fail-closed guards in history paths</item>
-  <history>RFC-1095</history>
+  <item>RFC-1233: stripGitTrailers at the record point + sanitizeItemText star-slash guard — commit-message trailers (Token: value / Token #value, plus markdown-link attribution lines like "Generated with [X](url)") no longer pollute injected items.</item>
+  <item>Session-retro 2026-10-08: id-in-diff dedup — auto-inject skips when the worktree diff already carries a same-ID item (HEAD-vs-worktree via git show HEAD:path), closing the descriptive+generic duplicate class seen on RFC-1237.</item>
+  <item>RFC-1249: wire werkstatt.commands.validate into packages.check + retire CMD-OUTPUT debt</item>
+  <history>CONTRACT-02, PURPOSE-02, RFC-1095, RFC-1097</history>
 </CHANGE_SUMMARY>
 */
-import { existsSync } from "../../../src/utils/sync-fs.js";
+import { execFile, existsSync } from "../../../src/utils/sync-fs.js";
 import { ambientIo, resolveIo } from "../../../src/utils/io.js";
 import { resolve, relative } from "node:path";
 import { detectRiskClass, getWorkspaceRelativeSegments } from "./compass-inventory.js";
@@ -117,12 +111,54 @@ export function buildChangeSummaryBlock(items, historyIds, filePath) {
 export function stripConventionalPrefix(subject) {
     return subject.replace(CONVENTIONAL_PREFIX_RE, "").trim();
 }
+// RFC-1233: git-trailer tail block — strict `Token: value` / `Token #value`
+// lines (interpret-trailers shape, empty value allowed), plus lines ending
+// in a markdown link (the observed "Generated with [X](url)" attribution
+// boilerplate has no separator). A link-shaped line is admitted only when
+// the block also contains at least one strict trailer line — a lone link
+// tail is prose.
+const TRAILER_LINE_RE = /^[A-Za-z0-9-]+(:| #)\s*.*$/;
+const MARKDOWN_LINK_TAIL_RE = /^.*\[[^\]]*\]\([^)]+\)\s*$/;
+/**
+ * Remove a trailing git-trailer block: the contiguous tail of strict
+ * trailer lines and admitted markdown-link lines. A blank line ends the
+ * tail paragraph. Returns the message without the block; when the tail
+ * holds no strict trailer line the message is returned unchanged.
+ */
+export function stripGitTrailers(message) {
+    const lines = message.trimEnd().split("\n");
+    let start = lines.length;
+    let sawStrict = false;
+    while (start > 0) {
+        const line = lines[start - 1].trim();
+        if (line === "")
+            break;
+        if (TRAILER_LINE_RE.test(line)) {
+            sawStrict = true;
+            start--;
+        }
+        else if (MARKDOWN_LINK_TAIL_RE.test(line)) {
+            start--;
+        }
+        else {
+            break;
+        }
+    }
+    if (!sawStrict || start === lines.length)
+        return message;
+    return lines.slice(0, start).join("\n").trimEnd();
+}
 // 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, ""));
+    return (text
+        .replace(COMPASS_TAG_LITERAL_RE, (tag) => tag.replace(/[<>]/g, ""))
+        // RFC-1233: a literal star-slash sequence would terminate the
+        // surrounding block comment when the item lands in /* ... */ headers.
+        // ∕ (U+2215) is visually near-identical, idempotent, and never re-forms.
+        .replace(/\*\//g, "*\u2215"));
 }
 export function isValidGovernanceId(id, policy) {
     return policy.idPatternFull.test(id);
@@ -130,8 +166,10 @@ export function isValidGovernanceId(id, policy) {
 /**
  * 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.
+ * `headSource` is the file's content at HEAD (when resolvable) — it enables
+ * the id-in-diff dedup; pass undefined outside git workspaces.
  */
-export async function recordSummaryItem(absPath, relPath, id, text, dryRun, policy) {
+export async function recordSummaryItem(absPath, relPath, id, text, dryRun, policy, headSource) {
     const source = await io.readFile(absPath);
     const blockMatch = source.match(CHANGE_SUMMARY_BLOCK_RE);
     // Header-region guard: a CHANGE_SUMMARY is a header only when it sits at the
@@ -158,6 +196,21 @@ export async function recordSummaryItem(absPath, relPath, id, text, dryRun, poli
     if (items.some((item) => normalizeItemText(item) === normalizedNew)) {
         return { recorded: false, collapsed: false, skipReason: "duplicate" };
     }
+    // A same-ID item already in the worktree but absent from HEAD means the
+    // pending change already carries a hand-authored record for this governance
+    // ID — the auto-injected subject-derived item would duplicate it at lower
+    // specificity (observed 2026-10-08: 27 files carried descriptive + generic
+    // RFC-1237 items). HEAD-resident same-ID items do NOT suppress: consecutive
+    // commits under one RFC legitimately stack step items.
+    if (headSource !== undefined) {
+        const headBlock = headSource.match(CHANGE_SUMMARY_BLOCK_RE);
+        const headItems = headBlock ? parseChangeSummary(headBlock[0]).items : [];
+        const idInWorktree = items.some((item) => leadingGovernanceId(item, policy) === id);
+        const idInHead = headItems.some((item) => leadingGovernanceId(item, policy) === id);
+        if (idInWorktree && !idInHead) {
+            return { recorded: false, collapsed: false, skipReason: "id-in-diff" };
+        }
+    }
     const nextItems = [...items, newItem];
     const collapsedIds = [];
     while (nextItems.length > CHANGE_SUMMARY_WINDOW) {
@@ -175,6 +228,27 @@ export async function recordSummaryItem(absPath, relPath, id, text, dryRun, poli
     }
     return { recorded: true, collapsed };
 }
+function execGit(cwd, args) {
+    return new Promise((resolve) => {
+        execFile("git", args, { cwd, timeout: 5000 }, (err, stdout) => {
+            resolve(err ? null : stdout);
+        });
+    });
+}
+/**
+ * Read `path`'s content at HEAD — the baseline for the id-in-diff dedup.
+ * Returns undefined when the file is untracked or the workspace is not a git
+ * repo (the dedup then falls back to exact-text matching only).
+ */
+async function readHeadSource(gitTop, absPath) {
+    if (!gitTop)
+        return undefined;
+    const rel = relative(gitTop, absPath).replace(/\\/g, "/");
+    if (rel === "" || rel.startsWith(".."))
+        return undefined;
+    const source = await execGit(gitTop, ["show", `HEAD:${rel}`]);
+    return source ?? undefined;
+}
 function riskReminderNeeded(relPath, source, policy) {
     const segments = relPath.split("/").filter(Boolean);
     const workspaceRel = getWorkspaceRelativeSegments(segments, policy).join("/");
@@ -198,7 +272,10 @@ export async function runCompassSummaryRecord(input, context) {
             ? rawFiles.split(/\s+/).filter(Boolean)
             : [];
     const rawText = input.flags["text"];
-    const text = typeof rawText === "string" && rawText.trim().length > 0 ? rawText.trim() : id;
+    // RFC-1233: strip the git-trailer block at the single injection point —
+    // ecosystem.commit and mission.git.commit both pipe the raw message here.
+    const stripped = typeof rawText === "string" ? stripGitTrailers(rawText).trim() : "";
+    const text = stripped.length > 0 ? stripped : id;
     const result = {
         command: "compass.summary.record",
         status: "pass",
@@ -207,6 +284,8 @@ export async function runCompassSummaryRecord(input, context) {
         skipped: [],
         keyDecisionsReminders: [],
     };
+    const gitTopRaw = await execGit(baseRoot, ["rev-parse", "--show-toplevel"]);
+    const gitTop = gitTopRaw?.trim() || null;
     for (const file of files) {
         const absPath = resolve(baseRoot, file);
         const relPath = relative(baseRoot, absPath).replace(/\\/g, "/");
@@ -216,7 +295,8 @@ export async function runCompassSummaryRecord(input, context) {
             continue;
         }
         try {
-            const outcome = await recordSummaryItem(absPath, relPath, id, text, context.dryRun, policy);
+            const headSource = await readHeadSource(gitTop, absPath);
+            const outcome = await recordSummaryItem(absPath, relPath, id, text, context.dryRun, policy, headSource);
             if (outcome.skipReason) {
                 result.skipped.push({ file, reason: outcome.skipReason });
                 continue;