@ogygie/core 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogygie/core",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Ogygie framework core: manifest/spec/error schemas, generic tenancy and gate tooling. Ships TypeScript sources — Ogygie products run tsx/vitest by construction (D1).",
   "license": "MIT",
   "type": "module",

package/src/vocabulary-audit.test.ts

@@ -121,9 +121,25 @@ describe("auditProductVocabulary — B4 : la pureté des fichiers gouvernés", (
     const violations = auditProductVocabulary({
       vocabulary: VOCABULARY,
       sourceFiles: [],
-      governedFiles: [{ path: "tsconfig.base.json", content: "// tuned for the gizmo pipeline" }],
+      governedFiles: [{ path: "tsconfig.base.json", content: "// tuned for the gadget pipeline" }],
     });
-    expect(violations.map((violation) => violation.match.root)).toEqual(["gizmo"]);
+    expect(violations.map((violation) => violation.match.root)).toEqual(["gadget"]);
+  });
+
+  it("un ALIAS interdit dans un fichier gouverné ne déclenche RIEN (v2)", () => {
+    // An alias is by definition a word the product does NOT use, so finding it
+    // in a generic file proves no contamination — while the framework's own
+    // neutral domain and plain computing English produce such collisions in
+    // bulk (eight false positives out of eighteen on the first real migration).
+    expect(
+      auditProductVocabulary({
+        vocabulary: VOCABULARY,
+        sourceFiles: [],
+        governedFiles: [
+          { path: "AGENTS.md", content: "const widgetId = 1; // gizmo everywhere" },
+        ],
+      }),
+    ).toEqual([]);
   });
 
   it("un fichier gouverné strictement générique passe", () => {

package/src/vocabulary-audit.ts

@@ -8,10 +8,17 @@
  * - PRODUCT SOURCE (B3): only forbidden ALIASES are hunted, and only in the
  *   machine identifiers — comments are blanked out first. The business prose
  *   of the project keeps its own words; the code has one term per concept.
- * - GOVERNED FILES (B4): EVERY declared root is hunted — canonical terms
- *   included — in the RAW text, comments and all. A governed file is identical
- *   in every Ogygie project, so it may know no product's domain at all, not
- *   even in a comment. That is the framework/product boundary made mechanical.
+ * - GOVERNED FILES (B4): the CANONICAL terms are hunted in the RAW text,
+ *   comments and all. A governed file is identical in every Ogygie project, so
+ *   it may know no product's domain at all, not even in a comment. That is the
+ *   framework/product boundary made mechanical.
+ *   Forbidden aliases are deliberately NOT hunted there (spec v2): an alias is
+ *   by definition a word the product does NOT use, so finding one in a generic
+ *   file proves no contamination — while the framework's own neutral domain
+ *   (`orders`, `customerId`) and plain computing English (`level`, `register`)
+ *   collide with it in bulk. Eight false positives out of eighteen on the first
+ *   real migration, and a gate whose verdicts one learns to ignore protects
+ *   nothing.
  *
  * The filesystem is injected (files come in as text), so the whole judgement
  * is a pure function proven in memory with its mutations.
@@ -49,7 +56,11 @@ export interface VocabularyAuditInput {
   readonly governedFiles: readonly ScannedFile[];
 }
 
-/** Every root the vocabulary declares: canonical terms AND forbidden aliases. */
+/**
+ * Every root the vocabulary declares: canonical terms AND forbidden aliases.
+ * Kept for callers that need the full list; the governed-file rule uses the
+ * canonical terms alone (see above).
+ */
 export function vocabularyRootsOf(vocabulary: ProductVocabulary): readonly string[] {
   return vocabulary.entries.flatMap((entry) => [entry.canonical, ...entry.forbiddenAliases]);
 }
@@ -71,7 +82,7 @@ export function auditProductVocabulary(
 
   const canonicalOfAlias = canonicalByAlias(vocabulary);
   const forbiddenAliases = [...canonicalOfAlias.keys()];
-  const everyRoot = vocabularyRootsOf(vocabulary);
+  const canonicalTerms = vocabulary.entries.map((entry) => entry.canonical);
   const violations: VocabularyViolation[] = [];
 
   for (const file of input.sourceFiles) {
@@ -86,7 +97,7 @@ export function auditProductVocabulary(
   }
 
   for (const file of input.governedFiles) {
-    for (const match of findProductVocabulary(file.content, everyRoot)) {
+    for (const match of findProductVocabulary(file.content, canonicalTerms)) {
       violations.push({
         kind: "GOVERNED_FILE",
         filePath: file.path,