@ogygie/cli 0.3.0 → 0.5.0

package/dist/cli.js

@@ -14667,7 +14667,20 @@ var OgygieManifestSchema = external_exports.object({
       name: external_exports.string(),
       path: external_exports.string(),
       type: external_exports.enum(["api", "front", "gateway"]),
-      entryPoint: external_exports.string()
+      entryPoint: external_exports.string(),
+      /**
+       * Code the product HOSTS without maintaining it — imported as-is from
+       * elsewhere, the framework's own dev tooling being the typical case.
+       * A vendored app is skipped by the vocabulary gate: a product's business
+       * vocabulary has no claim over code it will never rename.
+       *
+       * A literal `true`, like `shared` on a table: an app is either vendored
+       * (and says so) or the product's own (and stays silent) — no third
+       * state. The derogation is declared here, machine-readably, and the gate
+       * ANNOUNCES it on every run — one that stops being visible is one that
+       * gets forgotten.
+       */
+      vendored: external_exports.literal(true).optional()
     })
   ),
   features: external_exports.array(FeatureManifestSchema),
@@ -14949,6 +14962,29 @@ function initProject(deps, productName2) {
   return { writtenFiles: writtenFiles.sort() };
 }
 
+// src/commands/studio.ts
+async function runStudio(deps) {
+  const importStudio = deps.importStudio ?? // Kept as a bare specifier so the bundler leaves it alone: it is resolved
+  // in the CONSUMER's node_modules, at run time.
+  (async () => await import("@ogygie/studio/server"));
+  let studioServer;
+  try {
+    studioServer = await importStudio();
+  } catch (thrown) {
+    throwOgygieError({
+      code: "OGYGIE_STUDIO_NOT_INSTALLED",
+      message: "The studio is not installed in this project.",
+      file: "package.json",
+      cause: thrown instanceof Error ? `import of @ogygie/studio/server failed: ${thrown.message}` : "import of @ogygie/studio/server failed",
+      suggestedFix: `Install it as a dev dependency, at the framework's own version (lockstep D2): pnpm add -D @ogygie/studio@${deps.cliVersion}`
+    });
+  }
+  await studioServer.startStudio({
+    repoRoot: deps.projectRoot,
+    openBrowser: deps.openBrowser
+  });
+}
+
 // src/commands/upgrade.ts
 import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync4, writeFileSync as writeFileSync3 } from "node:fs";
 import { dirname as dirname2, join as join4 } from "node:path";
@@ -15279,13 +15315,22 @@ function collectCodeFiles(projectRoot, folder) {
 }
 function productCodeFoldersOf(manifest) {
   return [
-    ...manifest.apps.map((app) => app.path),
+    ...manifest.apps.filter((app) => app.vendored !== true).map((app) => app.path),
     ...(manifest.framework?.packages ?? []).map((packageEntry) => packageEntry.path)
   ];
 }
+function vendoredAppsOf(manifest) {
+  return manifest.apps.filter((app) => app.vendored === true).map((app) => ({ name: app.name, path: app.path }));
+}
 function verifyVocabulary(deps) {
   const manifest = readManifest(deps.projectRoot);
   if (manifest.vocabulary === void 0) return [];
+  const vendored = vendoredAppsOf(manifest);
+  if (vendored.length > 0 && deps.log !== void 0) {
+    deps.log(
+      `${vendored.length} app(s) hors du scan (vendored \u2014 code h\xE9berg\xE9, non maintenu par le produit) : ${vendored.map((app) => `${app.name} (${app.path})`).join(", ")}`
+    );
+  }
   const sourceFiles = productCodeFoldersOf(manifest).flatMap(
     (folder) => collectCodeFiles(deps.projectRoot, folder)
   );
@@ -15333,6 +15378,18 @@ var governedChecksumsByVersion = {
     "AGENTS.md": "ca73ab619d8c55fac11858d815bf5fbab6537ecebe7ae4123cbdeb3e3e36bf1a",
     "CLAUDE.md": "785ee8d90e368806d8cf0b4d84a15f29d1dc961168bda86cf1a6c60a923c8c9b",
     "tsconfig.base.json": "0f8919e9ed8bbc88e0308fa2fa91471dabb18d1df721bd78c04076597eba89a2"
+  },
+  "0.4.0": {
+    ".github/workflows/ogygie-gates.yml": "48c40efe9fe66dd0f9c3b94287026d80eae9afd6782b5833fdf8846d8662babf",
+    "AGENTS.md": "c7d51a0cd97b67343b486bdb7c54914da68d96409eaa985959d2a525c65549fd",
+    "CLAUDE.md": "785ee8d90e368806d8cf0b4d84a15f29d1dc961168bda86cf1a6c60a923c8c9b",
+    "tsconfig.base.json": "0f8919e9ed8bbc88e0308fa2fa91471dabb18d1df721bd78c04076597eba89a2"
+  },
+  "0.5.0": {
+    ".github/workflows/ogygie-gates.yml": "48c40efe9fe66dd0f9c3b94287026d80eae9afd6782b5833fdf8846d8662babf",
+    "AGENTS.md": "c7d51a0cd97b67343b486bdb7c54914da68d96409eaa985959d2a525c65549fd",
+    "CLAUDE.md": "785ee8d90e368806d8cf0b4d84a15f29d1dc961168bda86cf1a6c60a923c8c9b",
+    "tsconfig.base.json": "0f8919e9ed8bbc88e0308fa2fa91471dabb18d1df721bd78c04076597eba89a2"
   }
 };
 
@@ -15419,7 +15476,10 @@ ogygie check \u2014 ${problems.length} probl\xE8me(s).`);
       `ogygie check \u2014 OK, lockstep ${cliVersion()} et fichiers gouvern\xE9s intacts.`
     );
   } else if (command === "verify-vocabulary") {
-    const problems = verifyVocabulary({ projectRoot: process.cwd() });
+    const problems = verifyVocabulary({
+      projectRoot: process.cwd(),
+      log: (line) => console.log(line)
+    });
     if (problems.length > 0) {
       for (const problem of problems) printError(problem);
       console.error(`
@@ -15427,14 +15487,16 @@ ogygie verify-vocabulary \u2014 ${problems.length} probl\xE8me(s).`);
       process.exit(1);
     }
     console.log("ogygie verify-vocabulary \u2014 OK, le vocabulaire d\xE9clar\xE9 est respect\xE9.");
+  } else if (command === "studio") {
+    await runStudio({ projectRoot: process.cwd(), cliVersion: cliVersion() });
   } else {
     printError(
       ogygieError({
         code: "OGYGIE_CLI_USAGE",
         message: `Unknown command ${JSON.stringify(command ?? "")}.`,
         file: null,
-        cause: `expected one of: init <product-name>, upgrade, check, verify-vocabulary (flags: --json, --yes)`,
-        suggestedFix: "Run `ogygie init <product-name>`, `ogygie upgrade`, `ogygie check` or `ogygie verify-vocabulary`."
+        cause: `expected one of: init <product-name>, upgrade, check, verify-vocabulary, studio (flags: --json, --yes)`,
+        suggestedFix: "Run `ogygie init <product-name>`, `ogygie upgrade`, `ogygie check`, `ogygie verify-vocabulary` or `ogygie studio`."
       })
     );
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogygie/cli",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Ogygie framework CLI: deterministic scaffolding (init), governed-file upgrades (upgrade) and lockstep verification (check) for Ogygie products.",
   "license": "MIT",
   "type": "module",
@@ -22,7 +22,7 @@
     "tsx": "^4.20.0",
     "typescript": "^5.8.0",
     "zod": "^4.0.0",
-    "@ogygie/core": "0.3.0"
+    "@ogygie/core": "0.5.0"
   },
   "scripts": {
     "typecheck": "tsc -p tsconfig.json",

package/templates/project/AGENTS.md

@@ -272,6 +272,14 @@ se fait PAR RACINE, donc une racine trop courte attrape des mots génériques
 (déclarer `memo` interdit fait tomber `memory`, `createInMemoryDb`…). Une racine
 se déclare assez longue pour ne nommer que le concept.
 
+**Le code que le produit héberge sans le maintenir** — l'outil de dev du
+framework propagé dans le dépôt en est le cas type — se déclare
+`"vendored": true` sur son entrée d'`apps[]`, et sort du scan : un vocabulaire
+métier n'a pas de prise sur du code que le produit ne renommera jamais. La
+dérogation se déclare au manifeste, comme celle d'une table partagée, et le
+gate l'ANNONCE à chaque exécution — une dérogation qu'on ne voit plus est une
+dérogation qui s'oublie. Elle ne couvre JAMAIS le code du produit lui-même.
+
 ## Front (apps/web) — règles et templates canoniques
 
 ### Stack imposée (toute autre lib = amendement DECISIONS.md d'abord)