@warpgogol/forge 4.2.4 → 5.1.1

package/os/exploration/exploration.module.ts

@@ -1,94 +1,95 @@
 /*
 <MODULE_CONTRACT>
-<purpose>Register exploration note commands with the forge kernel registry.</purpose>
+<purpose>Register the exploration note command family with the forge kernel registry and module loader.</purpose>
 <non-goals>
   <item>Do not implement handler logic here — delegate to handlers/.</item>
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0710: initial forgeExplorationModule registering exploration.list, exploration.show, exploration.archive commands.</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>
 </CHANGE_SUMMARY>
 */
 
 import type { ForgeModule } from "../../src/forge-module.ts";
 
 export async function createForgeExplorationModule(): Promise<ForgeModule> {
-const { runExplorationList } = await import("./handlers/list.ts");
-    const { runExplorationShow } = await import("./handlers/show.ts");
-    const { runExplorationArchive } = await import("./handlers/archive.ts");
+  const { runExplorationList } = await import("./handlers/list.ts");
+  const { runExplorationShow } = await import("./handlers/show.ts");
+  const { runExplorationArchive } = await import("./handlers/archive.ts");
   return {
-  name: "forge-exploration",
-  version: "0.1.0",
-  runtime: "autonomous",
+    name: "forge-exploration",
+    version: "0.1.0",
+    runtime: "autonomous",
     declarations: [],
-  commands: [
-    {
-      name: "exploration.list",
-      description:
-        "List all exploration notes in docs/explorations/. Returns id, title, status, and createdAt for each note. " +
-        "Use --status <status> to filter by status (open, explored, archived). " +
-        "Returns an empty list with exit code 0 if the directory is empty or missing.",
-      scope: "workspace",
-      mutatesState: false,
-      writes: [],
-      reads: ["docs/explorations/*.md"],
-      cacheable: false,
-      flags: {
-        status: {
-          kind: "string",
-          description: "Filter by status (open, explored, archived).",
+    commands: [
+      {
+        name: "exploration.list",
+        description:
+          "List all exploration notes in docs/explorations/. Returns id, title, status, and createdAt for each note. " +
+          "Use --status <status> to filter by status (open, explored, archived). " +
+          "Returns an empty list with exit code 0 if the directory is empty or missing.",
+        scope: "workspace",
+        mutatesState: false,
+        writes: [],
+        reads: ["docs/explorations/*.md"],
+        cacheable: false,
+        flags: {
+          status: {
+            kind: "string",
+            description: "Filter by status (open, explored, archived).",
+          },
         },
+        execute: runExplorationList,
       },
-      execute: runExplorationList,
-    },
-    {
-      name: "exploration.show",
-      description:
-        "Show the full content of a single exploration note. Use --id <slug> to specify the note slug " +
-        "(kebab-case, lowercase, latin-only). Returns the note's frontmatter and body. " +
-        "Returns exit code 1 if the note is not found.",
-      scope: "workspace",
-      mutatesState: false,
-      writes: [],
-      reads: ["docs/explorations/*.md"],
-      cacheable: false,
-      flags: {
-        id: {
-          kind: "string",
-          required: true,
-          description: "The slug of the exploration note to show (e.g. 'my-idea').",
+      {
+        name: "exploration.show",
+        description:
+          "Show the full content of a single exploration note. Use --id <slug> to specify the note slug " +
+          "(kebab-case, lowercase, latin-only). Returns the note's frontmatter and body. " +
+          "Returns exit code 1 if the note is not found.",
+        scope: "workspace",
+        mutatesState: false,
+        writes: [],
+        reads: ["docs/explorations/*.md"],
+        cacheable: false,
+        flags: {
+          id: {
+            kind: "string",
+            required: true,
+            description: "The slug of the exploration note to show (e.g. 'my-idea').",
+          },
         },
+        execute: runExplorationShow,
       },
-      execute: runExplorationShow,
-    },
-    {
-      name: "exploration.archive",
-      description:
-        "Archive an exploration note by setting its status to 'archived'. Use --id <slug> to specify the note. " +
-        "Use --rfc <RFC-XXXX> to add an RFC id to the note's 'related' field. " +
-        "Idempotent — if the note is already archived, returns exit code 0 with no changes. " +
-        "Returns exit code 1 if the note is not found or the slug is invalid (non-kebab-case).",
-      scope: "workspace",
-      mutatesState: true,
-      writes: ["docs/explorations/*.md"],
-      reads: ["docs/explorations/*.md"],
-      cacheable: false,
-      flags: {
-        id: {
-          kind: "string",
-          required: true,
-          description: "The slug of the exploration note to archive (e.g. 'my-idea').",
-        },
-        rfc: {
-          kind: "string",
-          description: "RFC id to add to the note's 'related' field (e.g. 'RFC-0710').",
+      {
+        name: "exploration.archive",
+        description:
+          "Archive an exploration note by setting its status to 'archived'. Use --id <slug> to specify the note. " +
+          "Use --rfc <RFC-XXXX> to add an RFC id to the note's 'related' field. " +
+          "Idempotent — if the note is already archived, returns exit code 0 with no changes. " +
+          "Returns exit code 1 if the note is not found or the slug is invalid (non-kebab-case).",
+        scope: "workspace",
+        mutatesState: true,
+        writes: ["docs/explorations/*.md"],
+        reads: ["docs/explorations/*.md"],
+        cacheable: false,
+        flags: {
+          id: {
+            kind: "string",
+            required: true,
+            description: "The slug of the exploration note to archive (e.g. 'my-idea').",
+          },
+          rfc: {
+            kind: "string",
+            description: "RFC id to add to the note's 'related' field (e.g. 'RFC-0710').",
+          },
         },
+        execute: runExplorationArchive,
       },
-      execute: runExplorationArchive,
-    }
-  ],
-  pipelines: [
-
-  ]};
+    ],
+    pipelines: [],
+  };
 }
-;

package/os/exploration/handlers/list.ts

@@ -1,12 +1,15 @@
 /*
 <MODULE_CONTRACT>
-<purpose>exploration.list handler — list all exploration notes with metadata.</purpose>
+<purpose>exploration.list handler — list all exploration notes in the workspace with their metadata and status.</purpose>
 <non-goals>
   <item>Do not validate frontmatter shape — listing is metadata-only.</item>
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0710: initial exploration.list handler.</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>
 </CHANGE_SUMMARY>
 */
 

package/os/mission/handlers/archive.ts

@@ -13,12 +13,16 @@ archive subdirectories back to missions/.
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>RFC-0573: implement mission.archive command.</item>
-  <item>RFC-0573: extract moveMissionDir helper to eliminate Phase 1/2 duplication.</item>
-  <item>RFC-0801: add service-folder cleanup (node_modules, dist, .astro, .wrangler, .cache, .turbo) before archive move.</item>
   <item>RFC-0733: add pinned-files pre-check — skip pinned mission directories with warning instead of moving them.</item>
   <item>RFC-0804: auto-refresh pnpm-lock.yaml after directory moves.</item>
   <item>RFC-0982: fallback state detection for orphaned workpiece dirs (no mission.yaml) via .closed marker and cache-only heuristic; --clean-orphans flag; improved skip reasons.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — 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>
+  <history>RFC-0573, RFC-0801</history>
 </CHANGE_SUMMARY>
 */
 

package/os/mission/index.ts

@@ -1 +1,15 @@
+/*
+<MODULE_CONTRACT>
+<purpose>Mission module index — re-export createForgeMissionModule for the forge kernel registry.</purpose>
+<non-goals>
+  <item>Do not implement mission logic here — the module registration lives in mission.module.ts.</item>
+</non-goals>
+</MODULE_CONTRACT>
+<CHANGE_SUMMARY>
+  <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>
+</CHANGE_SUMMARY>
+*/
+
 export { createForgeMissionModule } from "./mission.module.ts";

package/os/notes/index.ts

@@ -1,9 +1,15 @@
 /*
 <MODULE_CONTRACT>
-<purpose>Re-export createForgeNotesModule and note validator handlers.</purpose>
+<purpose>Notes module index — re-export createForgeNotesModule and the note validator handlers for the forge kernel.</purpose>
+<non-goals>
+  <item>Do not implement note logic here — handlers and the module registration live in sibling files.</item>
+</non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0808: initial notes module index.</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>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/frontmatter-io.ts

@@ -11,9 +11,14 @@ circular import between the two.
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0268: extracted from handlers.ts to break a circular import with acceptance.ts.</item>
-  <item>Post-refactor hardening: added basename-based RFC id matching for archived RFC paths.</item>
   <item>RFC-0521: added getRfcStatusById and loadRfcStatusMap helpers for plan/audit archive commands.</item>
   <item>RFC-0755: readAndParseRfc now returns { fileName, error } on YAML parse failure instead of undefined.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/handlers/archive.ts

@@ -13,7 +13,12 @@ in subdirectories back to the root.
 <CHANGE_SUMMARY>
   <item>RFC-0367: implement rfc.archive command for terminal-status file archiving.</item>
   <item>RFC-0733: add pinned-files pre-check — skip pinned files with warning instead of moving them.</item>
-  <item>Gap fix: automatically rebuild docs/rfcs/index.yaml after moves to prevent stale index.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/handlers/implement-stamp.ts

@@ -12,12 +12,16 @@ verification evidence, and atomically mutates RFC frontmatter.
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>RFC-0476: initial rfc.implement.stamp handler with acceptance criteria evaluation, evidence checks, and atomic status transition.</item>
-  <item>RFC-0268: acceptance probe evidence check before stamping.</item>
-  <item>RFC-0756: auto-detect implementation commit when --implementation-commit is omitted.</item>
   <item>RFC-0795: add RFC-IMP-07 dependsOn dependency gate — blocks stamping when any dependsOn entry is not implemented.</item>
   <item>RFC-0997: add RFC-IMP-08 minimum-one-probe gate — blocks stamping for post-cutoff architecture/contract/command RFCs with no acceptance probes.</item>
   <item>RFC-1053: integrate generateRfcMetrics after successful stamp (non-fatal, guarded by !isDryRun).</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — 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>
+  <history>RFC-0268, RFC-0476, RFC-0756</history>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/handlers/index-graph.ts

@@ -7,7 +7,12 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0303: extracted index and graph handlers from handlers.ts into handlers/index-graph.ts.</item>
-  <item>Post-refactor hardening: rfc.graph resolves archived RFC files by basename id.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/handlers/lifecycle.ts

@@ -7,9 +7,14 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0303: extracted lifecycle logic from handlers.ts into handlers/lifecycle.ts.</item>
-  <item>Post-refactor hardening: targeted lifecycle validation resolves RFC ids inside archive subdirectories.</item>
   <item>RFC-0465: added RFC_METADATA_CUTOFF check to RFC-CMD-02 and RFC-CMD-03 rules — pre-cutoff RFCs are exempt from command registration checks.</item>
   <item>RFC-0465 fix: added manifest-based fallback in getLiveCommands — reads docs/command-manifest.generated.yaml when commandRegistry returns empty (site-kernel mode).</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/handlers/list-create.ts

@@ -7,7 +7,12 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0303: extracted list and create handlers from handlers.ts into handlers/list-create.ts.</item>
-  <item>Post-refactor hardening: require explicit satisfies DNA traces for new architecture/contract RFC drafts.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/handlers/pipeline-status.ts

@@ -8,7 +8,12 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Add rfc.pipeline.status command for agents and humans to inspect where an RFC stands in the create → audit → enhance → plan → implement pipeline.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/handlers/supersede-propose.ts

@@ -11,7 +11,12 @@ Scaffolds a new draft RFC with supersedes pre-linked, conflict context, and TODO
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0334: initial implementation.</item>
-  <item>Post-refactor hardening: supersede proposals resolve archived RFC files by basename id.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/handlers/validate-rules.ts

@@ -6,12 +6,16 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>RFC-0303 Phase 3: extracted from validate.ts as part of the handler split.</item>
-  <item>RFC-0722: add RFC-DIR-01 directory structure warning rule for unsanctioned subdirectories.</item>
-  <item>RFC-0755: add V-RFC-33 frontmatter YAML parseability check (checkFrontmatterYamlParse helper).</item>
   <item>RFC-0795: add V-33 dependsOn referential integrity/self-dependency/rejected-dependency and V-34 batch slug format rules.</item>
   <item>RFC-0997: add V-35 probe→criterion referential integrity, V-36 criterion identifier discipline, V-37 evidence mechanism validity, and computeProbeCoverage for non-blocking coverage reports.</item>
   <item>RFC-1006: add V-38 document readiness completeness, V-39 non-atomic criterion, V-40 unbounded quantity, V-41 weasel verb, V-42 criterion versioning annotation format. Add evaluateDocumentReadiness and extend evaluateAcceptanceCriteria with supersession tracking and reject-checklist scans.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — 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>
+  <history>RFC-0303, RFC-0722, RFC-0755</history>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/handlers/validate.ts

@@ -7,7 +7,12 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0303: extracted validate handler from handlers.ts into handlers/validate.ts.</item>
-  <item>Post-refactor hardening: targeted validation resolves RFC ids inside archive subdirectories.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/index.ts

@@ -6,7 +6,12 @@
 </non-goals>
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
-  <item>Backfilled complete Compass header (MODULE_MAP, CHANGE_SUMMARY) for compliance.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/rfc.module.ts

@@ -8,8 +8,13 @@
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0260: declare typed `flags` schemas for the whole rfc.* command family; unknown/malformed flags now fail with KERNEL-FLAG-01/02/03 instead of being silently ignored.</item>
-  <item>Post-refactor hardening: expose `rfc.create --satisfies` for explicit DNA trace scaffolding.</item>
   <item>RFC-0795: add `--batch` flag to `rfc.list` for filtering by batch slug.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/rfc/types.ts

@@ -12,13 +12,16 @@
  * </non-goals>
  * </MODULE_CONTRACT>
  *  * <CHANGE_SUMMARY>
-  <item>Tidied by compass.changesummary.tidy; see git history for prior entries.</item>
-  <item>RFC-0465: added specRef field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for PBP spec traceability.</item>
-  <item>RFC-0478: added versionBump field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for platform versioning enforcement.</item>
-  <item>RFC-0480: added breaksC field to RfcFrontmatter interface and RFC_KNOWN_KEYS array for Layer C protection.</item>
   <item>RFC-0795: added dependsOn, batch fields to RfcFrontmatter and RFC_KNOWN_KEYS; added RFC-IMP-07 to RfcImplementStampRule; added batch/dependsOn to RfcListEntry.</item>
   <item>RFC-0998: added TestProbe and JsonSchemaProbe to AcceptanceProbe union for test and json-schema acceptance probe kinds.</item>
   <item>RFC-0999: added lastRefreshedAt to VerificationEvidence; added RfcVerificationRefreshResult interface.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — 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>
+  <history>RFC-0465, RFC-0478, RFC-0480</history>
 </CHANGE_SUMMARY>
  ***************************************************************/
 

package/os/session/handlers/save.ts

@@ -12,8 +12,13 @@ Deterministic only — no LLM/intelligent annotation (that is fo-session-save sk
 </MODULE_CONTRACT>
 <CHANGE_SUMMARY>
   <item>RFC-0537: implement session.save command handler.</item>
-  <item>Replace fs.unlink with trashPath for raw file deletion (trash bin for LLM-initiated deletions).</item>
   <item>RFC-1053: integrate generateSessionMetrics after markdown write (non-fatal, guarded by !dryRun).</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/werkstatt/handlers/werkstatt-lock-recover.ts

@@ -10,7 +10,12 @@ Classifies and cleans stale locks and staging artifacts (RFC-0362 §8).</purpose
 <CHANGE_SUMMARY>
   <item>RFC-0362: initial lock.recover command handler.</item>
   <item>RFC-0556: moved from @warpgogol/site-kernel-handoff to @warpgogol/forge for autonomous mode.</item>
-  <item>Replace fs.unlink/fs.rm with trashPath for artifact cleanup (trash bin for LLM-initiated deletions).</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY>
 */
 

package/os/werkstatt/handlers/workspace-deps.ts

@@ -1,6 +1,6 @@
 /*
 <MODULE_CONTRACT>
-<purpose>Lazy dynamic-import bridge for @warpgogol/werkstatt-engine/fingerprint and @warpgogol/werkstatt-shared/share/fs. These workspace packages are not published to npm — when forge is installed standalone from npm, they are unavailable and handlers that depend on them must degrade gracefully.</purpose>
+<purpose>Lazy dynamic-import bridge for @warpgogol/werkstatt-engine/fingerprint and @warpgogol/werkstatt-shared/node/fs. These workspace packages are not published to npm — when forge is installed standalone from npm, they are unavailable and handlers that depend on them must degrade gracefully.</purpose>
 <non-goals>
   <item>Do not re-export types from @warpgogol/* — only runtime functions.</item>
   <item>Do not use static imports — that would break npm installs without workspace deps.</item>
@@ -37,7 +37,7 @@ export async function loadWorkspaceDeps(): Promise<WorkspaceDeps> {
   try {
     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
     // @ts-ignore — workspace dep, may not be installed when forge is used standalone from npm
-    const shareMod = await import("@warpgogol/werkstatt-shared/share/fs");
+    const shareMod = await import("@warpgogol/werkstatt-shared/node/fs");
     // eslint-disable-next-line @typescript-eslint/ban-ts-comment
     // @ts-ignore — workspace dep, may not be installed when forge is used standalone from npm
     const fpMod = await import("@warpgogol/werkstatt-engine/fingerprint");
@@ -48,7 +48,7 @@ export async function loadWorkspaceDeps(): Promise<WorkspaceDeps> {
     return cached;
   } catch (err) {
     loadError =
-      `@warpgogol/werkstatt-engine/fingerprint and @warpgogol/werkstatt-shared/share are required for this command but not installed. ` +
+      `@warpgogol/werkstatt-engine/fingerprint and @warpgogol/werkstatt-shared are required for this command but not installed. ` +
       `When using forge standalone from npm, install them separately or use forge within the warpgogol workspace. ` +
       `Error: ${(err as Error).message}`;
     throw new Error(loadError);

package/os/workflow/index.ts

@@ -10,7 +10,12 @@
 </MODULE_CONTRACT> 
  
 <CHANGE_SUMMARY>
-  <item>Tidied by compass.changesummary.tidy; see git history for prior entries.</item>
+  <item>RFC-1097: step 6 — compass.migrate codemod run
+
+Mechanical v1 to v2 header migration across the workspace: 942 files rewritten — CHANGE_SUMMARY windows collapsed into history, forbidden v1 blocks stripped, KEY_DECISIONS seeded from @ai-invariant comments (5 files) or TODO placeholders (103 files), blocks reordered to canonical order.</item>
+  <item>RFC-1097: sweep — werkstatt-engine 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. werkstatt-engine now 0 diagnostics.</item>
 </CHANGE_SUMMARY> 
 */
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/forge",
-  "version": "4.2.4",
+  "version": "5.1.1",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",

package/profiles/{godot-csharp.yaml → godot-game.yaml}

@@ -1,5 +1,5 @@
 schema: forge/stack-profile@1
-id: godot-csharp
+id: godot-game
 displayName: Godot 4.x + C#
 detect:
   anyOf:
@@ -1123,7 +1123,7 @@ workspace:
 
         - Engine: @warpgogol/werkstatt-engine
         - Plugin: @warpgogol/werkstatt-godot-game
-        - Stack profile: godot-csharp
+        - Stack profile: godot-game
 install:
   - pnpm install
 firstWorkspace:

package/profiles/{knowledge-typescript-turborepo.yaml → knowledge.yaml}

@@ -1,5 +1,5 @@
 schema: forge/stack-profile@1
-id: knowledge-typescript-turborepo
+id: knowledge
 displayName: Knowledge Base + Turborepo
 detect:
   anyOf:

package/profiles/{phaser-turborepo.yaml → phaser-game.yaml}

@@ -1,5 +1,5 @@
 schema: forge/stack-profile@1
-id: phaser-turborepo
+id: phaser-game
 displayName: Phaser + Turborepo
 detect:
   anyOf:
@@ -692,7 +692,7 @@ workspace:
 
         - Engine: @warpgogol/werkstatt-engine
         - Plugin: @warpgogol/werkstatt-phaser-game
-        - Stack profile: phaser-turborepo
+        - Stack profile: phaser-game
 install:
   - pnpm add -wD typescript turbo @warpgogol/forge @warpgogol/werkstatt-engine @warpgogol/werkstatt-shared @warpgogol/werkstatt-phaser-game prettier
 firstWorkspace:

package/profiles/{typescript-turborepo.yaml → typescript.yaml}

@@ -1,5 +1,5 @@
 schema: forge/stack-profile@1
-id: typescript-turborepo
+id: typescript
 displayName: TypeScript TurboRepo
 detect:
   anyOf:
@@ -554,6 +554,6 @@ workspace:
 
         - Engine: @warpgogol/forge
         - Plugin: @warpgogol/werkstatt-typescript
-        - Stack profile: typescript-turborepo
+        - Stack profile: typescript
 install:
   - pnpm add -wD @warpgogol/forge @warpgogol/werkstatt-typescript @warpgogol/werkstatt-engine @warpgogol/werkstatt-shared prettier vitest typescript