@warpgogol/forge 2.9.0 → 2.9.2

package/os/compass/handlers/compass-inventory.ts

@@ -14,15 +14,51 @@ for Compass source-file inventory.</purpose>
   <item>Post-refactor hardening: exclude src/templates generation inputs from authored Compass requirements.</item>
   <item>Post-refactor hardening: detect nested packages/os workspaces before deriving Compass layer and workspace name.</item>
   <item>RFC-0556: moved canonical implementation from @warpgogol/site-kernel to @warpgogol/forge for autonomous mode.</item>
+  <item>Game extensions: added .cs, .tscn, .tres, .gd to SOURCE_EXTENSIONS; createCompassInventoryEntries now reads forge.yaml compass.fileExtensions at runtime and merges with hardcoded set.</item>
 </CHANGE_SUMMARY>
 */
 
 import { readdir, readFile } from "node:fs/promises";
+import { readFileSync, existsSync } from "node:fs";
 import { join, relative, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
 import type { ForgeCommandInput } from "../../../src/types.ts";
 import { hasGeneratedMarker } from "../../../src/utils/generated-marker.ts";
 
-const SOURCE_EXTENSIONS = new Set([".ts", ".tsx", ".astro", ".js", ".jsx", ".mjs", ".mts", ".css"]);
+function loadCompassExtensionsFromForgeYaml(workspaceRoot: string): Set<string> {
+  const forgeYamlPath = join(workspaceRoot, "forge.yaml");
+  if (!existsSync(forgeYamlPath)) {
+    return new Set();
+  }
+  try {
+    const raw = readFileSync(forgeYamlPath, "utf8");
+    const parsed = parseYaml(raw) as Record<string, unknown> | null;
+    const bindings = parsed?.bindings as Record<string, unknown> | undefined;
+    const compass = bindings?.compass as Record<string, unknown> | undefined;
+    const extensions = compass?.fileExtensions;
+    if (Array.isArray(extensions)) {
+      return new Set(extensions.filter((e: unknown) => typeof e === "string"));
+    }
+  } catch {
+    // forge.yaml not parseable or missing compass section — fall back to hardcoded set
+  }
+  return new Set();
+}
+
+const SOURCE_EXTENSIONS = new Set([
+  ".ts",
+  ".tsx",
+  ".astro",
+  ".js",
+  ".jsx",
+  ".mjs",
+  ".mts",
+  ".css",
+  ".cs",
+  ".tscn",
+  ".tres",
+  ".gd",
+]);
 const IGNORED_DIRECTORY_NAMES = new Set([
   ".git",
   ".turbo",
@@ -113,16 +149,26 @@ function shouldIgnoreDirectory(name: string): boolean {
   return false;
 }
 
-function hasRelevantExtension(filePath: string): boolean {
+function hasRelevantExtension(filePath: string, extraExtensions?: Set<string>): boolean {
   for (const extension of SOURCE_EXTENSIONS) {
     if (filePath.endsWith(extension)) {
       return true;
     }
   }
+  if (extraExtensions) {
+    for (const extension of extraExtensions) {
+      if (filePath.endsWith(extension)) {
+        return true;
+      }
+    }
+  }
   return false;
 }
 
-async function collectSourceFiles(targetPath: string): Promise<string[]> {
+async function collectSourceFiles(
+  targetPath: string,
+  extraExtensions?: Set<string>,
+): Promise<string[]> {
   let stat;
   try {
     const { stat: fsStat } = await import("node:fs/promises");
@@ -132,7 +178,7 @@ async function collectSourceFiles(targetPath: string): Promise<string[]> {
   }
 
   if (stat.isFile()) {
-    return hasRelevantExtension(targetPath) ? [targetPath] : [];
+    return hasRelevantExtension(targetPath, extraExtensions) ? [targetPath] : [];
   }
 
   let entries;
@@ -161,11 +207,11 @@ async function collectSourceFiles(targetPath: string): Promise<string[]> {
         continue;
       }
 
-      files.push(...(await collectSourceFiles(absolutePath)));
+      files.push(...(await collectSourceFiles(absolutePath, extraExtensions)));
       continue;
     }
 
-    if (entry.isFile() && hasRelevantExtension(absolutePath)) {
+    if (entry.isFile() && hasRelevantExtension(absolutePath, extraExtensions)) {
       files.push(absolutePath);
     }
   }
@@ -469,7 +515,10 @@ export async function createCompassInventoryEntries(
   scanRoot?: string,
 ): Promise<CompassInventoryEntry[]> {
   const roots = scanRoot ? [scanRoot] : resolveScanRoots(workspaceRoot, input);
-  const files = (await Promise.all(roots.map((root) => collectSourceFiles(root)))).flat();
+  const extraExtensions = loadCompassExtensionsFromForgeYaml(workspaceRoot);
+  const files = (
+    await Promise.all(roots.map((root) => collectSourceFiles(root, extraExtensions)))
+  ).flat();
   const entries: CompassInventoryEntry[] = [];
 
   for (const filePath of files.sort()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@warpgogol/forge",
-  "version": "2.9.0",
+  "version": "2.9.2",
   "private": false,
   "type": "module",
   "license": "Apache-2.0",
@@ -170,12 +170,10 @@
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },
-  "optionalDependencies": {
-    "@warpgogol/werkstatt-shared": "*",
-    "@warpgogol/werkstatt": "*"
-  },
   "devDependencies": {
     "@types/node": "^24.0.0",
+    "@warpgogol/werkstatt-shared": "*",
+    "@warpgogol/werkstatt": "1.4.0",
     "eslint": "^10.8.0",
     "fast-check": "^4.9.0",
     "typescript": "^6.0.3",

package/profiles/godot-csharp.yaml

@@ -6,6 +6,16 @@ detect:
     - project.godot
 domain: game
 register: creative
+compass:
+  fileExtensions:
+    - .cs
+    - .tscn
+    - .tres
+    - .gd
+    - .ts
+    - .tsx
+    - .js
+    - .mjs
 terminology:
   artifact: game
   artifactPlural: games
@@ -294,6 +304,9 @@ workspace:
               - name: Test
                 run: pnpm test
 
+              - name: Compass header validation
+                run: pnpm exec werkstatt run compass.validate
+
         # Windows CI (optional — uncomment if Windows checks are needed):
         #
         #   windows-ci:
@@ -677,9 +690,13 @@ workspace:
         #!/bin/sh
         # Platform-scope pre-commit guard
         # Runs werkstatt autonomy and plugin validation before commits
+        # Note: compass.validate reads all source files and may add a few seconds
+        # to commit time for large projects. Remove the line below if this is
+        # too slow during iterative development.
         echo "Pre-commit: running platform checks..."
         pnpm exec werkstatt run werkstatt.autonomy.validate || exit 1
         pnpm exec werkstatt run werkstatt.plugin.validate || exit 1
+        pnpm exec werkstatt run compass.validate || exit 1
     - path: systems-cache/.gitkeep
       content: |
         # Sternsystem cache directory (RFC-0790)

package/profiles/phaser-turborepo.yaml

@@ -5,6 +5,13 @@ detect:
   anyOf:
     - phaser.config.*
     - package.json
+compass:
+  fileExtensions:
+    - .ts
+    - .tsx
+    - .js
+    - .mjs
+    - .css
 workspace:
   dirs:
     - apps
@@ -123,6 +130,9 @@ workspace:
               - name: Test
                 run: pnpm test
 
+              - name: Compass header validation
+                run: pnpm exec werkstatt run compass.validate
+
         # Windows CI (optional — uncomment if Windows checks are needed):
         #
         #   windows-ci:
@@ -283,9 +293,13 @@ workspace:
         #!/bin/sh
         # Platform-scope pre-commit guard
         # Runs werkstatt autonomy and plugin validation before commits
+        # Note: compass.validate reads all source files and may add a few seconds
+        # to commit time for large projects. Remove the line below if this is
+        # too slow during iterative development.
         echo "Pre-commit: running platform checks..."
         pnpm exec werkstatt run werkstatt.autonomy.validate || exit 1
         pnpm exec werkstatt run werkstatt.plugin.validate || exit 1
+        pnpm exec werkstatt run compass.validate || exit 1
     - path: systems-cache/.gitkeep
       content: |
         # Sternsystem cache directory (RFC-0790)

package/skills/fo/fo-compass-annotate/reference/comment-styles.md

@@ -12,6 +12,10 @@ Compass headers are embedded in source file comments. The comment syntax varies
 | `.js`     | `/* ... */` block comment   | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */`       |
 | `.mjs`    | `/* ... */` block comment   | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */`       |
 | `.css`    | `/* ... */` block comment   | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */`       |
+| `.cs`     | `/* ... */` block comment   | `/* <MODULE_CONTRACT> ... </MODULE_CONTRACT> */`       |
+| `.tscn`   | `; ` line comment           | `; <MODULE_CONTRACT>` (each line prefixed with `; `)   |
+| `.tres`   | `; ` line comment           | `; <MODULE_CONTRACT>` (each line prefixed with `; `)   |
+| `.gd`     | `# ` line comment           | `# <MODULE_CONTRACT>` (each line prefixed with `# `)   |
 | `.yaml`   | `# ` line comment           | `# <MODULE_CONTRACT>` (each line prefixed with `# `)   |
 | `.yml`    | `# ` line comment           | `# <MODULE_CONTRACT>` (each line prefixed with `# `)   |
 | `.json`   | Not supported               | JSON files cannot carry comments; skip Compass headers |
@@ -20,6 +24,8 @@ Compass headers are embedded in source file comments. The comment syntax varies
 ## Rules
 
 - The XML-like tags (`<MODULE_CONTRACT>`, `<CHANGE_SUMMARY>`, `<item>`, etc.) are always preserved as-is inside the comment wrapper.
-- For `.yaml`/`.yml`, each line of the block is prefixed with `# `.
+- For `.yaml`/`.yml` and `.gd`, each line of the block is prefixed with `# `.
+- For `.tscn`/`.tres`, each line of the block is prefixed with `; ` (Godot INI-style comment).
+- For `.cs`, use `/* ... */` block comments (same as TypeScript).
 - For `.json`, Compass headers are not applicable — skip these files.
 - The block is placed at the top of the file, after any license header but before code/imports.

package/src/onboarding/create.ts

@@ -87,6 +87,9 @@ function loadProfileDomainFields(profileId: string, forgeRoot: string): InitDoma
         fields.semanticBindings = semanticBindings;
       }
     }
+    if (profile.compass) {
+      fields.compass = profile.compass;
+    }
     return fields;
   } catch {
     return {};

package/src/onboarding/init.ts

@@ -52,6 +52,10 @@ export interface InitDomainFields {
   terminology?: Record<string, string>;
   semanticBindings?: Record<string, string | null>;
   profileId?: string;
+  compass?: {
+    fileExtensions?: string[];
+    testPatterns?: string[];
+  };
 }
 
 export function runInit(
@@ -150,6 +154,12 @@ export function runInit(
         }
       }
     }
+    if (domainFields?.compass && config.bindings) {
+      config.bindings.compass = {
+        ...(config.bindings.compass ?? {}),
+        ...domainFields.compass,
+      };
+    }
     const yamlContent = stringifyYaml(config);
     fs.writeFileSync(forgeYamlPath, yamlContent, "utf8");
     created.push("forge.yaml");

package/src/profiles/profile-schema.ts

@@ -331,6 +331,12 @@ export const stackProfileDomainFieldsSchema = z.object({
   templates: z.array(profileTemplateSchema).optional(),
   scriptDir: z.string().min(1).optional(),
   rootAgentsMdTemplate: z.string().optional(),
+  compass: z
+    .object({
+      fileExtensions: z.array(z.string()).optional(),
+      testPatterns: z.array(z.string()).optional(),
+    })
+    .optional(),
 });
 
 export interface StackProfileDomainFields {
@@ -347,4 +353,8 @@ export interface StackProfileDomainFields {
   templates?: ProfileTemplate[];
   scriptDir?: string;
   rootAgentsMdTemplate?: string;
+  compass?: {
+    fileExtensions?: string[];
+    testPatterns?: string[];
+  };
 }

package/src/profiles/stack-profile.ts

@@ -76,6 +76,8 @@ export const stackProfileSchema = z.object({
   scriptDir: stackProfileDomainFieldsSchema.shape.scriptDir,
   // Profile-driven root AGENTS.md template
   rootAgentsMdTemplate: stackProfileDomainFieldsSchema.shape.rootAgentsMdTemplate,
+  // Profile-driven Compass file extensions
+  compass: stackProfileDomainFieldsSchema.shape.compass,
 });
 
 export interface ProfileFile {

package/src/tests/create.test.ts

@@ -287,3 +287,33 @@ test("forge create --in-place derives name from folder name when --name omitted"
   const pkgJson = JSON.parse(await readFileAsync(join(namedDir, "package.json"), "utf8"));
   expect(pkgJson.name).toBe("my-derived-project");
 }, 30000);
+
+test("forge create --profile godot-csharp writes compass.fileExtensions into forge.yaml", async () => {
+  const result = await runCreate(
+    { argv: [], flags: { "in-place": true, profile: "godot-csharp", name: "my-game" } },
+    makeContext(tempDir),
+  );
+  expect(result.exitCode).toBe(0);
+
+  const { readFile: readFileAsync } = await import("node:fs/promises");
+  const forgeYaml = await readFileAsync(join(tempDir, "forge.yaml"), "utf8");
+  expect(forgeYaml).toContain("compass:");
+  expect(forgeYaml).toContain("fileExtensions:");
+  expect(forgeYaml).toContain(".cs");
+  expect(forgeYaml).toContain(".tscn");
+  expect(forgeYaml).toContain(".tres");
+  expect(forgeYaml).toContain(".gd");
+}, 30000);
+
+test("forge create --profile phaser-turborepo writes compass.fileExtensions into forge.yaml", async () => {
+  const result = await runCreate(
+    { argv: [], flags: { "in-place": true, profile: "phaser-turborepo", name: "my-phaser-game" } },
+    makeContext(tempDir),
+  );
+  expect(result.exitCode).toBe(0);
+
+  const { readFile: readFileAsync } = await import("node:fs/promises");
+  const forgeYaml = await readFileAsync(join(tempDir, "forge.yaml"), "utf8");
+  expect(forgeYaml).toContain("compass:");
+  expect(forgeYaml).toContain("fileExtensions:");
+}, 30000);