@ogygie/core 0.13.1 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogygie/core",
-  "version": "0.13.1",
+  "version": "0.14.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",
@@ -13,28 +13,29 @@
     "access": "public"
   },
   "exports": {
-    "./manifest": "./src/manifest.schema.ts",
-    "./manifest-owners": "./src/manifest-owners.ts",
-    "./vocabulary": "./src/vocabulary.ts",
-    "./vocabulary-audit": "./src/vocabulary-audit.ts",
-    "./web-lint": "./src/web-lint.ts",
     "./bundle-budget": "./src/bundle-budget.ts",
-    "./spec": "./src/spec.schema.ts",
-    "./impact": "./src/impact.ts",
-    "./repo-adapter": "./src/repo-adapter.ts",
+    "./client": "./src/manifest-client.ts",
+    "./client-react": "./src/manifest-client-react.ts",
+    "./clock": "./src/clock.ts",
+    "./contract-purity": "./src/contract-purity.ts",
+    "./db": "./src/db.ts",
     "./decision-refs": "./src/decision-refs.ts",
     "./design-brief": "./src/design-brief.ts",
-    "./module-purity": "./src/module-purity.ts",
-    "./contract-purity": "./src/contract-purity.ts",
     "./errors": "./src/error.schema.ts",
-    "./db": "./src/db.ts",
-    "./clock": "./src/clock.ts",
-    "./tenant": "./src/tenant.ts",
+    "./gateway": "./src/manifest-gateway.ts",
+    "./impact": "./src/impact.ts",
+    "./manifest": "./src/manifest.schema.ts",
+    "./manifest-owners": "./src/manifest-owners.ts",
+    "./module-purity": "./src/module-purity.ts",
+    "./repo-adapter": "./src/repo-adapter.ts",
+    "./scan": "./src/scan.ts",
     "./shared-tables": "./src/shared-tables.ts",
+    "./spec": "./src/spec.schema.ts",
+    "./tenant": "./src/tenant.ts",
     "./test-kit": "./src/test-kit.ts",
-    "./gateway": "./src/manifest-gateway.ts",
-    "./client": "./src/manifest-client.ts",
-    "./client-react": "./src/manifest-client-react.ts"
+    "./vocabulary": "./src/vocabulary.ts",
+    "./vocabulary-audit": "./src/vocabulary-audit.ts",
+    "./web-lint": "./src/web-lint.ts"
   },
   "peerDependencies": {
     "@electric-sql/pglite": "^0.3.0",

package/src/scan.test.ts

@@ -0,0 +1,31 @@
+/**
+ * @intent Prouve la règle de parcours des gates, avec le cas qui l'a imposée :
+ * un projet Nuxt dont `typecheck` génère `.nuxt/` que `lint` refusait ensuite.
+ */
+import { describe, expect, it } from "vitest";
+import { isScannableDirectory, NEVER_SCANNED_DIRECTORIES } from "./scan.js";
+
+describe("isScannableDirectory", () => {
+  it("parcourt le code du projet", () => {
+    for (const name of ["apps", "packages", "src", "scripts", "features", "specs"]) {
+      expect(isScannableDirectory(name)).toBe(true);
+    }
+  });
+
+  it("ne parcourt AUCUN dossier en point — c'est la règle qui ne vieillit pas", () => {
+    for (const name of [".git", ".nuxt", ".output", ".next", ".svelte-kit", ".turbo", ".venv"]) {
+      expect(isScannableDirectory(name)).toBe(false);
+    }
+  });
+
+  it("ne parcourt pas les artefacts au nom ordinaire", () => {
+    for (const name of NEVER_SCANNED_DIRECTORIES) expect(isScannableDirectory(name)).toBe(false);
+  });
+
+  it("MUTATION : un dossier dont le nom COMMENCE par celui d'un artefact reste parcouru", () => {
+    // `distribution/` n'est pas `dist/`, et `buildings/` n'est pas `build/`.
+    expect(isScannableDirectory("distribution")).toBe(true);
+    expect(isScannableDirectory("buildings")).toBe(true);
+    expect(isScannableDirectory("node_modules_backup")).toBe(true);
+  });
+});

package/src/scan.ts

@@ -0,0 +1,35 @@
+/**
+ * @intent Which directories a gate WALKS — the one rule, for every gate.
+ *
+ * It existed five times, slightly differently, in as many scripts. That is how
+ * it fell behind: the lists were written when a build produced `dist/`, and a
+ * modern framework generates `.nuxt/`, `.output/`, `.next/`, `.svelte-kit/`,
+ * while a Python package carries `.venv/`. A gate that walks into them reports
+ * bans and forbidden words found in code NOBODY WROTE — and worse, it does so
+ * only after a build, so the loop passes in CI and fails on the machine of
+ * whoever just ran it. A consumer project hit exactly that: `typecheck`
+ * generated `.nuxt/`, and `lint` then refused a type-suppression directive the
+ * framework had written into its own generated types.
+ *
+ * The rule is deliberately blunt, because a subtle one would fall behind again:
+ * a DOT-directory is never source. Everything a project actually writes lives
+ * in a plainly-named folder; tooling, caches, virtual environments and build
+ * output all hide behind a dot, by a convention older than any of these tools.
+ */
+
+/** Plainly-named directories that are still artefacts, not source. */
+export const NEVER_SCANNED_DIRECTORIES = [
+  "node_modules",
+  "dist",
+  "dist-ui",
+  "build",
+  "coverage",
+] as const;
+
+/** Does a gate walk into this directory? Its NAME is the whole question. */
+export function isScannableDirectory(name: string): boolean {
+  // `.git`, `.nuxt`, `.output`, `.next`, `.svelte-kit`, `.turbo`, `.venv`,
+  // `.pytest_cache`… — one rule instead of a list that ages.
+  if (name.startsWith(".")) return false;
+  return !(NEVER_SCANNED_DIRECTORIES as readonly string[]).includes(name);
+}