@ogygie/cli 0.11.2 → 0.13.0

package/dist/cli.js

@@ -14555,12 +14555,90 @@ function throwOgygieError(input, httpStatus = 500) {
   throw new OgygieFailure(ogygieError(input), httpStatus);
 }
 
-// src/commands/check.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import { join as join2 } from "node:path";
+// src/commands/adopt.ts
+import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "node:fs";
+import { dirname, join as join3 } from "node:path";
 
-// src/checksum.ts
-import { createHash } from "node:crypto";
+// src/diff.ts
+function diffLines(oldText, newText) {
+  if (oldText === newText) return "";
+  const oldLines = oldText.split("\n");
+  const newLines = newText.split("\n");
+  const lcs = Array.from(
+    { length: oldLines.length + 1 },
+    () => new Array(newLines.length + 1).fill(0)
+  );
+  for (let i2 = oldLines.length - 1; i2 >= 0; i2 -= 1) {
+    for (let j2 = newLines.length - 1; j2 >= 0; j2 -= 1) {
+      lcs[i2][j2] = oldLines[i2] === newLines[j2] ? (lcs[i2 + 1][j2 + 1] ?? 0) + 1 : Math.max(lcs[i2 + 1][j2] ?? 0, lcs[i2][j2 + 1] ?? 0);
+    }
+  }
+  const output = [];
+  let previousWasChange = false;
+  let i = 0;
+  let j = 0;
+  while (i < oldLines.length || j < newLines.length) {
+    if (i < oldLines.length && j < newLines.length && oldLines[i] === newLines[j]) {
+      previousWasChange = false;
+      i += 1;
+      j += 1;
+    } else {
+      if (!previousWasChange) output.push(`@@ line ${j + 1}`);
+      previousWasChange = true;
+      if (j >= newLines.length || i < oldLines.length && (lcs[i + 1]?.[j] ?? 0) >= (lcs[i]?.[j + 1] ?? 0)) {
+        output.push(`- ${oldLines[i]}`);
+        i += 1;
+      } else {
+        output.push(`+ ${newLines[j]}`);
+        j += 1;
+      }
+    }
+  }
+  return output.join("\n");
+}
+
+// src/gates-report.ts
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+
+// src/framework-gates.ts
+var frameworkGates = [
+  {
+    scriptName: "ogygie:verify-vocabulary",
+    command: "ogygie verify-vocabulary",
+    intent: "Le vocabulaire d\xE9clar\xE9 au manifeste : alias interdits dans les identifiants, puret\xE9 des fichiers gouvern\xE9s."
+  }
+];
+function missingFrameworkGates(scripts) {
+  const commands = Object.values(scripts ?? {}).join(" ; ");
+  return frameworkGates.filter((gate) => !commands.includes(gate.command));
+}
+
+// src/gates-report.ts
+function reportMissingGates(projectRoot, log) {
+  const packageJsonPath = join(projectRoot, "package.json");
+  if (!existsSync(packageJsonPath)) return;
+  let scripts;
+  try {
+    const parsed = JSON.parse(readFileSync(packageJsonPath, "utf8"));
+    const scriptsValue = typeof parsed === "object" && parsed !== null ? parsed.scripts : void 0;
+    if (typeof scriptsValue === "object" && scriptsValue !== null) {
+      scripts = scriptsValue;
+    }
+  } catch {
+    return;
+  }
+  const missing = missingFrameworkGates(scripts);
+  if (missing.length === 0) return;
+  log("");
+  log(
+    `\u26A0 ${missing.length} gate(s) du framework ne tournent pas dans ta boucle locale (package.json n'est pas gouvern\xE9 \u2014 \xE0 toi de l'ajouter, la CI gouvern\xE9e les appelle d\xE9j\xE0) :`
+  );
+  for (const gate of missing) {
+    log(`    "${gate.scriptName}": "${gate.command}"   # ${gate.intent}`);
+  }
+  log("  puis appelle ces scripts depuis ton script `verify`.");
+}
 
 // src/governed-files.ts
 var GovernedFileSchema = external_exports.object({
@@ -14627,14 +14705,9 @@ var governedFiles = [
   }
 ];
 
-// src/checksum.ts
-function sha256Hex(content) {
-  return createHash("sha256").update(content, "utf8").digest("hex");
-}
-
 // src/project-manifest.ts
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
+import { existsSync as existsSync2, readFileSync as readFileSync2, writeFileSync } from "node:fs";
+import { join as join2 } from "node:path";
 
 // ../ogygie-core/src/manifest.schema.ts
 var FeatureNameSchema = external_exports.string().regex(/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/, "kebab-case required");
@@ -14918,9 +14991,9 @@ var OgygieManifestSchema = external_exports.object({
 // src/project-manifest.ts
 var MANIFEST_FILE_NAME = "ogygie.manifest.json";
 var PinnedVersionSchema = external_exports.object({ ogygieVersion: OgygieVersionSchema.optional() });
-function readPinnedOgygieVersion(projectRoot) {
-  const manifestPath = join(projectRoot, MANIFEST_FILE_NAME);
-  if (!existsSync(manifestPath)) {
+function requireManifestPath(projectRoot) {
+  const manifestPath = join2(projectRoot, MANIFEST_FILE_NAME);
+  if (!existsSync2(manifestPath)) {
     throwOgygieError({
       code: "OGYGIE_CLI_USAGE",
       message: `No ${MANIFEST_FILE_NAME} here \u2014 this is not an Ogygie project root.`,
@@ -14929,8 +15002,19 @@ function readPinnedOgygieVersion(projectRoot) {
       suggestedFix: "Run the command from the project root, or scaffold a project first with `pnpm dlx @ogygie/cli init <product-name>`."
     });
   }
+  return manifestPath;
+}
+function readOptionalPinnedOgygieVersion(projectRoot) {
+  const manifestPath = requireManifestPath(projectRoot);
   const parsed = PinnedVersionSchema.safeParse(
-    JSON.parse(readFileSync(manifestPath, "utf8"))
+    JSON.parse(readFileSync2(manifestPath, "utf8"))
+  );
+  return parsed.success ? parsed.data.ogygieVersion ?? null : null;
+}
+function readPinnedOgygieVersion(projectRoot) {
+  const manifestPath = requireManifestPath(projectRoot);
+  const parsed = PinnedVersionSchema.safeParse(
+    JSON.parse(readFileSync2(manifestPath, "utf8"))
   );
   const pinned = parsed.success ? parsed.data.ogygieVersion : void 0;
   if (pinned === void 0) {
@@ -14945,28 +15029,126 @@ function readPinnedOgygieVersion(projectRoot) {
   return pinned;
 }
 function writePinnedOgygieVersion(projectRoot, version2) {
-  const manifestPath = join(projectRoot, MANIFEST_FILE_NAME);
-  const content = readFileSync(manifestPath, "utf8");
+  const manifestPath = join2(projectRoot, MANIFEST_FILE_NAME);
+  const content = readFileSync2(manifestPath, "utf8");
   const bumped = content.replace(
     /"ogygieVersion"\s*:\s*"[^"]*"/,
     `"ogygieVersion": "${version2}"`
   );
   writeFileSync(manifestPath, bumped);
 }
+function addPinnedOgygieVersion(projectRoot, version2) {
+  const manifestPath = requireManifestPath(projectRoot);
+  const content = readFileSync2(manifestPath, "utf8");
+  const openingBrace = content.indexOf("{");
+  if (openingBrace === -1) {
+    throwOgygieError({
+      code: "OGYGIE_CLI_USAGE",
+      message: `${MANIFEST_FILE_NAME} is not a JSON object \u2014 the pin cannot be added.`,
+      file: MANIFEST_FILE_NAME,
+      cause: "no opening brace found in the manifest",
+      suggestedFix: "Fix the manifest so it is a valid JSON object, then retry."
+    });
+  }
+  const indentation = /\n(\s+)"/.exec(content.slice(openingBrace))?.[1] ?? "  ";
+  const pinned = `${content.slice(0, openingBrace + 1)}
+${indentation}"ogygieVersion": "${version2}",${content.slice(openingBrace + 1)}`;
+  writeFileSync(manifestPath, pinned);
+}
+
+// src/commands/adopt.ts
+async function adoptProject(deps) {
+  const alreadyPinned = readOptionalPinnedOgygieVersion(deps.projectRoot);
+  if (alreadyPinned !== null) {
+    throwOgygieError({
+      code: "OGYGIE_ALREADY_ADOPTED",
+      message: `This project is already pinned to Ogygie ${alreadyPinned} \u2014 adoption is a one-way passage, it does not replay.`,
+      file: MANIFEST_FILE_NAME,
+      cause: `ogygieVersion ${alreadyPinned} already present in the manifest`,
+      suggestedFix: "Use `ogygie upgrade` to move a governed project to a newer version; `adopt` only serves a repo that has never been governed."
+    });
+  }
+  const planned = [];
+  for (const governed of governedFiles) {
+    const content = readFileSync3(
+      join3(deps.templatesDir, governed.templatePath),
+      "utf8"
+    );
+    const absolutePath = join3(deps.projectRoot, governed.targetPath);
+    const occupied = existsSync3(absolutePath);
+    const current = occupied ? readFileSync3(absolutePath, "utf8") : "";
+    const diff = diffLines(current, content);
+    if (diff === "") continue;
+    planned.push({ targetPath: governed.targetPath, content, occupied, diff });
+  }
+  const occupiedWrites = planned.filter((write) => write.occupied);
+  const freshWrites = planned.filter((write) => !write.occupied);
+  if (occupiedWrites.length > 0) {
+    deps.log(
+      `\u26A0 ${occupiedWrites.length} chemin(s) gouvern\xE9(s) portent d\xE9j\xE0 un fichier de ce projet. L'adoption les \xC9CRASE \u2014 leur contenu actuel n'existera plus que dans l'historique git :`
+    );
+    for (const write of occupiedWrites) deps.log(`    ${write.targetPath}`);
+    deps.log(
+      "  Le partage produit/g\xE9n\xE9rique de ces fichiers est un travail humain : il se fait AVANT cette commande, pas par elle (B7)."
+    );
+    deps.log("");
+  }
+  const fullDiff = [...occupiedWrites, ...freshWrites].map(
+    (write) => `=== ${write.targetPath}${write.occupied ? " (\xE9crase un fichier du projet)" : " (nouveau)"}
+${write.diff}`
+  ).join("\n\n");
+  const confirmed = await deps.confirm(fullDiff);
+  if (!confirmed) {
+    deps.log("ogygie adopt \u2014 abandonn\xE9, aucun fichier modifi\xE9, projet non \xE9pingl\xE9.");
+    return {
+      adoptedVersion: deps.cliVersion,
+      writtenFiles: [],
+      overwrittenProductFiles: []
+    };
+  }
+  for (const write of planned) {
+    const absolutePath = join3(deps.projectRoot, write.targetPath);
+    mkdirSync(dirname(absolutePath), { recursive: true });
+    writeFileSync2(absolutePath, write.content);
+  }
+  addPinnedOgygieVersion(deps.projectRoot, deps.cliVersion);
+  deps.log(
+    `ogygie adopt \u2014 projet adopt\xE9 en ${deps.cliVersion}, ${planned.length} fichier(s) gouvern\xE9(s) pos\xE9(s) dont ${occupiedWrites.length} \xE9cras\xE9(s).`
+  );
+  deps.log(
+    `Rappel lockstep (D2) : installer @ogygie/core ET @ogygie/cli en ${deps.cliVersion} \xE0 l'EXACT (\`pnpm add -D @ogygie/cli@${deps.cliVersion}\`, \`pnpm add @ogygie/core@${deps.cliVersion}\`), puis committer l'adoption SEULE \u2014 jamais m\xEAl\xE9e \xE0 une feature.`
+  );
+  reportMissingGates(deps.projectRoot, deps.log);
+  return {
+    adoptedVersion: deps.cliVersion,
+    writtenFiles: planned.map((write) => write.targetPath),
+    overwrittenProductFiles: occupiedWrites.map((write) => write.targetPath)
+  };
+}
+
+// src/commands/check.ts
+import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
+import { join as join4 } from "node:path";
+
+// src/checksum.ts
+import { createHash } from "node:crypto";
+function sha256Hex(content) {
+  return createHash("sha256").update(content, "utf8").digest("hex");
+}
 
 // src/commands/check.ts
 var PackageVersionSchema = external_exports.object({ version: external_exports.string() });
 function installedCoreVersion(projectRoot) {
-  const packagePath = join2(
+  const packagePath = join4(
     projectRoot,
     "node_modules",
     "@ogygie",
     "core",
     "package.json"
   );
-  if (!existsSync2(packagePath)) return null;
+  if (!existsSync4(packagePath)) return null;
   const parsed = PackageVersionSchema.safeParse(
-    JSON.parse(readFileSync2(packagePath, "utf8"))
+    JSON.parse(readFileSync4(packagePath, "utf8"))
   );
   return parsed.success ? parsed.data.version : null;
 }
@@ -15001,8 +15183,8 @@ function checkProject(deps) {
   for (const governed of governedFiles) {
     const expected = expectedChecksums[governed.targetPath];
     if (expected === void 0) continue;
-    const absolutePath = join2(deps.projectRoot, governed.targetPath);
-    const actual = existsSync2(absolutePath) ? sha256Hex(readFileSync2(absolutePath, "utf8")) : "<absent>";
+    const absolutePath = join4(deps.projectRoot, governed.targetPath);
+    const actual = existsSync4(absolutePath) ? sha256Hex(readFileSync4(absolutePath, "utf8")) : "<absent>";
     if (actual !== expected) {
       problems.push(
         ogygieError({
@@ -15020,23 +15202,23 @@ function checkProject(deps) {
 
 // src/commands/init.ts
 import {
-  existsSync as existsSync3,
-  mkdirSync,
+  existsSync as existsSync5,
+  mkdirSync as mkdirSync2,
   readdirSync,
-  readFileSync as readFileSync3,
+  readFileSync as readFileSync5,
   statSync,
-  writeFileSync as writeFileSync2
+  writeFileSync as writeFileSync3
 } from "node:fs";
-import { dirname, join as join3 } from "node:path";
+import { dirname as dirname2, join as join5 } from "node:path";
 var PRODUCT_NAME_PATTERN = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
 var RENAMED_TEMPLATE_FILES = {
   gitignore: ".gitignore"
 };
 function listTemplateFiles(root, folder = "") {
   const files = [];
-  for (const entry of readdirSync(join3(root, folder)).sort()) {
+  for (const entry of readdirSync(join5(root, folder)).sort()) {
     const relativePath = folder === "" ? entry : `${folder}/${entry}`;
-    if (statSync(join3(root, relativePath)).isDirectory()) {
+    if (statSync(join5(root, relativePath)).isDirectory()) {
       files.push(...listTemplateFiles(root, relativePath));
     } else {
       files.push(relativePath);
@@ -15061,16 +15243,16 @@ function initProject(deps, productName2) {
       suggestedFix: "Pick a kebab-case name, e.g. `ogygie init order-desk`."
     });
   }
-  if (existsSync3(join3(deps.targetDir, MANIFEST_FILE_NAME))) {
+  if (existsSync5(join5(deps.targetDir, MANIFEST_FILE_NAME))) {
     throwOgygieError({
       code: "OGYGIE_INIT_TARGET_NOT_EMPTY",
       message: `The target directory already hosts an Ogygie project (${MANIFEST_FILE_NAME} found).`,
       file: MANIFEST_FILE_NAME,
-      cause: `${join3(deps.targetDir, MANIFEST_FILE_NAME)} exists`,
+      cause: `${join5(deps.targetDir, MANIFEST_FILE_NAME)} exists`,
       suggestedFix: "Run `pnpm ogygie upgrade` in that project instead of init."
     });
   }
-  const existingEntries = existsSync3(deps.targetDir) ? readdirSync(deps.targetDir).filter((entry) => entry !== ".git") : [];
+  const existingEntries = existsSync5(deps.targetDir) ? readdirSync(deps.targetDir).filter((entry) => entry !== ".git") : [];
   if (existingEntries.length > 0) {
     throwOgygieError({
       code: "OGYGIE_INIT_TARGET_NOT_EMPTY",
@@ -15080,14 +15262,14 @@ function initProject(deps, productName2) {
       suggestedFix: "Start from an empty directory (only a .git folder is tolerated)."
     });
   }
-  const projectTemplates = join3(deps.templatesDir, "project");
+  const projectTemplates = join5(deps.templatesDir, "project");
   const writtenFiles = [];
   for (const templateRelativePath of listTemplateFiles(projectTemplates)) {
-    const content = readFileSync3(join3(projectTemplates, templateRelativePath), "utf8").replaceAll("__PRODUCT_NAME__", productName2).replaceAll("__OGYGIE_VERSION__", deps.cliVersion);
+    const content = readFileSync5(join5(projectTemplates, templateRelativePath), "utf8").replaceAll("__PRODUCT_NAME__", productName2).replaceAll("__OGYGIE_VERSION__", deps.cliVersion);
     const targetRelativePath = targetPathOf(templateRelativePath);
-    const absoluteTarget = join3(deps.targetDir, targetRelativePath);
-    mkdirSync(dirname(absoluteTarget), { recursive: true });
-    writeFileSync2(absoluteTarget, content);
+    const absoluteTarget = join5(deps.targetDir, targetRelativePath);
+    mkdirSync2(dirname2(absoluteTarget), { recursive: true });
+    writeFileSync3(absoluteTarget, content);
     writtenFiles.push(targetRelativePath);
   }
   deps.log(`ogygie init \u2014 ${writtenFiles.length} fichiers \xE9crits (ogygieVersion ${deps.cliVersion}).`);
@@ -15103,11 +15285,11 @@ function initProject(deps, productName2) {
 
 // src/commands/studio.ts
 import { createRequire } from "node:module";
-import { join as join4 } from "node:path";
+import { join as join6 } from "node:path";
 import { pathToFileURL } from "node:url";
 var PUBLISHED_STUDIO_SERVER = "@ogygie/studio/server";
 async function loadStudioFrom(projectRoot) {
-  const resolveFromProject = createRequire(join4(projectRoot, "package.json"));
+  const resolveFromProject = createRequire(join6(projectRoot, "package.json"));
   const entryPoint = resolveFromProject.resolve(PUBLISHED_STUDIO_SERVER);
   return await import(pathToFileURL(entryPoint).href);
 }
@@ -15146,13 +15328,13 @@ async function runStudio(deps) {
 }
 
 // src/commands/mcp.ts
-import { readFileSync as readFileSync4 } from "node:fs";
+import { readFileSync as readFileSync6 } from "node:fs";
 import { createRequire as createRequire2 } from "node:module";
-import { join as join5 } from "node:path";
+import { join as join7 } from "node:path";
 import { pathToFileURL as pathToFileURL2 } from "node:url";
 var PUBLISHED_MCP_SERVER = "@ogygie/mcp/server";
 async function loadMcpFrom(projectRoot) {
-  const resolveFromProject = createRequire2(join5(projectRoot, "package.json"));
+  const resolveFromProject = createRequire2(join7(projectRoot, "package.json"));
   const entryPoint = resolveFromProject.resolve(PUBLISHED_MCP_SERVER);
   return await import(pathToFileURL2(entryPoint).href);
 }
@@ -15189,64 +15371,13 @@ async function runMcp(deps) {
     cwd: deps.projectRoot,
     version: deps.cliVersion,
     token: process.env["OGYGIE_MCP_TOKEN"],
-    readConfigFile: (absolutePath) => readFileSync4(absolutePath, "utf8")
+    readConfigFile: (absolutePath) => readFileSync6(absolutePath, "utf8")
   });
 }
 
 // src/commands/upgrade.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync2, readFileSync as readFileSync5, writeFileSync as writeFileSync3 } from "node:fs";
-import { dirname as dirname2, join as join6 } from "node:path";
-
-// src/diff.ts
-function diffLines(oldText, newText) {
-  if (oldText === newText) return "";
-  const oldLines = oldText.split("\n");
-  const newLines = newText.split("\n");
-  const lcs = Array.from(
-    { length: oldLines.length + 1 },
-    () => new Array(newLines.length + 1).fill(0)
-  );
-  for (let i2 = oldLines.length - 1; i2 >= 0; i2 -= 1) {
-    for (let j2 = newLines.length - 1; j2 >= 0; j2 -= 1) {
-      lcs[i2][j2] = oldLines[i2] === newLines[j2] ? (lcs[i2 + 1][j2 + 1] ?? 0) + 1 : Math.max(lcs[i2 + 1][j2] ?? 0, lcs[i2][j2 + 1] ?? 0);
-    }
-  }
-  const output = [];
-  let previousWasChange = false;
-  let i = 0;
-  let j = 0;
-  while (i < oldLines.length || j < newLines.length) {
-    if (i < oldLines.length && j < newLines.length && oldLines[i] === newLines[j]) {
-      previousWasChange = false;
-      i += 1;
-      j += 1;
-    } else {
-      if (!previousWasChange) output.push(`@@ line ${j + 1}`);
-      previousWasChange = true;
-      if (j >= newLines.length || i < oldLines.length && (lcs[i + 1]?.[j] ?? 0) >= (lcs[i]?.[j + 1] ?? 0)) {
-        output.push(`- ${oldLines[i]}`);
-        i += 1;
-      } else {
-        output.push(`+ ${newLines[j]}`);
-        j += 1;
-      }
-    }
-  }
-  return output.join("\n");
-}
-
-// src/framework-gates.ts
-var frameworkGates = [
-  {
-    scriptName: "ogygie:verify-vocabulary",
-    command: "ogygie verify-vocabulary",
-    intent: "Le vocabulaire d\xE9clar\xE9 au manifeste : alias interdits dans les identifiants, puret\xE9 des fichiers gouvern\xE9s."
-  }
-];
-function missingFrameworkGates(scripts) {
-  const commands = Object.values(scripts ?? {}).join(" ; ");
-  return frameworkGates.filter((gate) => !commands.includes(gate.command));
-}
+import { existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync7, writeFileSync as writeFileSync4 } from "node:fs";
+import { dirname as dirname3, join as join8 } from "node:path";
 
 // src/version.ts
 function compareVersions(a, b) {
@@ -15262,30 +15393,6 @@ function compareVersions(a, b) {
 }
 
 // src/commands/upgrade.ts
-function reportMissingGates(deps) {
-  const packageJsonPath = join6(deps.projectRoot, "package.json");
-  if (!existsSync4(packageJsonPath)) return;
-  let scripts;
-  try {
-    const parsed = JSON.parse(readFileSync5(packageJsonPath, "utf8"));
-    const scriptsValue = typeof parsed === "object" && parsed !== null ? parsed.scripts : void 0;
-    if (typeof scriptsValue === "object" && scriptsValue !== null) {
-      scripts = scriptsValue;
-    }
-  } catch {
-    return;
-  }
-  const missing = missingFrameworkGates(scripts);
-  if (missing.length === 0) return;
-  deps.log("");
-  deps.log(
-    `\u26A0 ${missing.length} gate(s) du framework ne tournent pas dans ta boucle locale (package.json n'est pas gouvern\xE9 \u2014 \xE0 toi de l'ajouter, la CI gouvern\xE9e les appelle d\xE9j\xE0) :`
-  );
-  for (const gate of missing) {
-    deps.log(`    "${gate.scriptName}": "${gate.command}"   # ${gate.intent}`);
-  }
-  deps.log("  puis appelle ces scripts depuis ton script `verify`.");
-}
 async function upgradeProject(deps) {
   const installedVersion = readPinnedOgygieVersion(deps.projectRoot);
   if (compareVersions(deps.cliVersion, installedVersion) < 0) {
@@ -15318,8 +15425,8 @@ async function upgradeProject(deps) {
   for (const governed of governedFiles) {
     const expected = installedChecksums[governed.targetPath];
     if (expected === void 0) continue;
-    const absolutePath = join6(deps.projectRoot, governed.targetPath);
-    const actual = existsSync4(absolutePath) ? sha256Hex(readFileSync5(absolutePath, "utf8")) : "<absent>";
+    const absolutePath = join8(deps.projectRoot, governed.targetPath);
+    const actual = existsSync6(absolutePath) ? sha256Hex(readFileSync7(absolutePath, "utf8")) : "<absent>";
     if (actual !== expected) {
       throwOgygieError({
         code: "OGYGIE_GOVERNED_FILE_MODIFIED",
@@ -15333,12 +15440,12 @@ async function upgradeProject(deps) {
   const plannedWrites = [];
   const diffBlocks = [];
   for (const governed of governedFiles) {
-    const content = readFileSync5(
-      join6(deps.templatesDir, governed.templatePath),
+    const content = readFileSync7(
+      join8(deps.templatesDir, governed.templatePath),
       "utf8"
     );
-    const absolutePath = join6(deps.projectRoot, governed.targetPath);
-    const current = existsSync4(absolutePath) ? readFileSync5(absolutePath, "utf8") : "";
+    const absolutePath = join8(deps.projectRoot, governed.targetPath);
+    const current = existsSync6(absolutePath) ? readFileSync7(absolutePath, "utf8") : "";
     const diff = diffLines(current, content);
     if (diff !== "") {
       plannedWrites.push({ targetPath: governed.targetPath, content });
@@ -15358,9 +15465,9 @@ ${diff}`);
       };
     }
     for (const write of plannedWrites) {
-      const absolutePath = join6(deps.projectRoot, write.targetPath);
-      mkdirSync2(dirname2(absolutePath), { recursive: true });
-      writeFileSync3(absolutePath, write.content);
+      const absolutePath = join8(deps.projectRoot, write.targetPath);
+      mkdirSync3(dirname3(absolutePath), { recursive: true });
+      writeFileSync4(absolutePath, write.content);
     }
   }
   writePinnedOgygieVersion(deps.projectRoot, deps.cliVersion);
@@ -15370,7 +15477,7 @@ ${diff}`);
   deps.log(
     `Rappel lockstep (D2) : mettre @ogygie/core ET @ogygie/cli \xE0 ${deps.cliVersion} (\`pnpm update @ogygie/core@${deps.cliVersion} @ogygie/cli@${deps.cliVersion}\`), puis committer l'upgrade SEUL \u2014 jamais m\xEAl\xE9 \xE0 une feature.`
   );
-  reportMissingGates(deps);
+  reportMissingGates(deps.projectRoot, deps.log);
   return {
     fromVersion: installedVersion,
     toVersion: deps.cliVersion,
@@ -15379,8 +15486,8 @@ ${diff}`);
 }
 
 // src/commands/verify-vocabulary.ts
-import { existsSync as existsSync5, readFileSync as readFileSync6, readdirSync as readdirSync2, statSync as statSync2 } from "node:fs";
-import { join as join7, relative, sep } from "node:path";
+import { existsSync as existsSync7, readFileSync as readFileSync8, readdirSync as readdirSync2, statSync as statSync2 } from "node:fs";
+import { join as join9, relative, sep } from "node:path";
 
 // ../ogygie-core/src/vocabulary.ts
 var TOKEN_PATTERN = new RegExp("\\p{L}[\\p{L}\\p{N}]*(?:[-_$][\\p{L}\\p{N}]+)*", "gu");
@@ -15406,6 +15513,22 @@ function tokenCarriesRoot(tokenSegments, rootSegments) {
   }
   return false;
 }
+function tokenCarriesExactName(token, name) {
+  const tokenSegments = segmentsOfIdentifier(token);
+  const nameSegments = segmentsOfIdentifier(name);
+  if (nameSegments.length === 0) return false;
+  for (let start = 0; start + nameSegments.length <= tokenSegments.length; start += 1) {
+    let allMatch = true;
+    for (let offset = 0; offset < nameSegments.length; offset += 1) {
+      if (tokenSegments[start + offset] !== nameSegments[offset]) {
+        allMatch = false;
+        break;
+      }
+    }
+    if (allMatch) return true;
+  }
+  return false;
+}
 function findProductVocabulary(sourceText, vocabularyRoots) {
   const roots = vocabularyRoots.map((root) => ({
     root,
@@ -15452,6 +15575,13 @@ function canonicalByAlias(vocabulary) {
   }
   return byAlias;
 }
+function derogatedFeatureIdsOf(vocabulary, featureIds) {
+  if (vocabulary === void 0 || vocabulary.entries.length === 0) return [];
+  const forbiddenAliases = [...canonicalByAlias(vocabulary).keys()];
+  return featureIds.filter(
+    (featureId) => findProductVocabulary(featureId, forbiddenAliases).length > 0
+  );
+}
 function auditProductVocabulary(input) {
   const { vocabulary } = input;
   if (vocabulary === void 0 || vocabulary.entries.length === 0) return [];
@@ -15459,9 +15589,12 @@ function auditProductVocabulary(input) {
   const forbiddenAliases = [...canonicalOfAlias.keys()];
   const canonicalTerms = vocabulary.entries.map((entry) => entry.canonical);
   const violations = [];
+  const featureIds = input.featureIds ?? [];
+  const derivesFromAFeatureId = (identifier) => featureIds.some((featureId) => tokenCarriesExactName(identifier, featureId));
   for (const file2 of input.sourceFiles) {
     const judged = stripProseStrings(stripComments(file2.content));
     for (const match of findProductVocabulary(judged, forbiddenAliases)) {
+      if (derivesFromAFeatureId(match.identifier)) continue;
       violations.push({
         kind: "FORBIDDEN_ALIAS",
         filePath: file2.path,
@@ -15487,8 +15620,8 @@ function auditProductVocabulary(input) {
 var CODE_EXTENSIONS = [".ts", ".tsx", ".mts", ".mjs", ".js", ".jsx"];
 var IGNORED_DIRS = /* @__PURE__ */ new Set(["node_modules", "dist", "build", ".git", "coverage"]);
 function readManifest(projectRoot) {
-  const manifestPath = join7(projectRoot, MANIFEST_FILE_NAME);
-  if (!existsSync5(manifestPath)) {
+  const manifestPath = join9(projectRoot, MANIFEST_FILE_NAME);
+  if (!existsSync7(manifestPath)) {
     throwOgygieError({
       code: "OGYGIE_CLI_USAGE",
       message: `No ${MANIFEST_FILE_NAME} here \u2014 this is not an Ogygie project root.`,
@@ -15498,7 +15631,7 @@ function readManifest(projectRoot) {
     });
   }
   const parsed = OgygieManifestSchema.safeParse(
-    JSON.parse(readFileSync6(manifestPath, "utf8"))
+    JSON.parse(readFileSync8(manifestPath, "utf8"))
   );
   if (!parsed.success) {
     throwOgygieError({
@@ -15512,13 +15645,13 @@ function readManifest(projectRoot) {
   return parsed.data;
 }
 function collectCodeFiles(projectRoot, folder) {
-  const absoluteFolder = join7(projectRoot, folder);
-  if (!existsSync5(absoluteFolder)) return [];
+  const absoluteFolder = join9(projectRoot, folder);
+  if (!existsSync7(absoluteFolder)) return [];
   const files = [];
   const walk = (directory) => {
     for (const entry of readdirSync2(directory)) {
       if (IGNORED_DIRS.has(entry)) continue;
-      const entryPath = join7(directory, entry);
+      const entryPath = join9(directory, entry);
       if (statSync2(entryPath).isDirectory()) {
         walk(entryPath);
         continue;
@@ -15526,7 +15659,7 @@ function collectCodeFiles(projectRoot, folder) {
       if (!CODE_EXTENSIONS.some((extension) => entry.endsWith(extension))) continue;
       files.push({
         path: relative(projectRoot, entryPath).split(sep).join("/"),
-        content: readFileSync6(entryPath, "utf8")
+        content: readFileSync8(entryPath, "utf8")
       });
     }
   };
@@ -15551,17 +15684,25 @@ function verifyVocabulary(deps) {
       `${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 featureIds = manifest.features.map((feature) => feature.name);
+  const derogated = derogatedFeatureIdsOf(manifest.vocabulary, featureIds);
+  if (derogated.length > 0 && deps.log !== void 0) {
+    deps.log(
+      `${derogated.length} id(s) de feature hors du scan des alias, et les identifiants qui en D\xC9RIVENT (le manifeste les nomme, le code les suit) : ${derogated.join(", ")}`
+    );
+  }
   const sourceFiles = productCodeFoldersOf(manifest).flatMap(
     (folder) => collectCodeFiles(deps.projectRoot, folder)
   );
-  const governed = governedFiles.filter((file2) => existsSync5(join7(deps.projectRoot, file2.targetPath))).map((file2) => ({
+  const governed = governedFiles.filter((file2) => existsSync7(join9(deps.projectRoot, file2.targetPath))).map((file2) => ({
     path: file2.targetPath,
-    content: readFileSync6(join7(deps.projectRoot, file2.targetPath), "utf8")
+    content: readFileSync8(join9(deps.projectRoot, file2.targetPath), "utf8")
   }));
   return auditProductVocabulary({
     vocabulary: manifest.vocabulary,
     sourceFiles,
-    governedFiles: governed
+    governedFiles: governed,
+    featureIds
   }).map(
     (violation) => violation.kind === "FORBIDDEN_ALIAS" ? ogygieError({
       code: "OGYGIE_VOCABULARY_FORBIDDEN_ALIAS",
@@ -15671,6 +15812,30 @@ var governedChecksumsByVersion = {
     "scripts/verify-specs.ts": "04289dbeeb029703779757a2d8b58852c6b16414ab7503bf3223cfe4e9a4d45e",
     "tsconfig.base.json": "0f8919e9ed8bbc88e0308fa2fa91471dabb18d1df721bd78c04076597eba89a2"
   },
+  "0.12.0": {
+    ".github/workflows/ogygie-gates.yml": "48c40efe9fe66dd0f9c3b94287026d80eae9afd6782b5833fdf8846d8662babf",
+    "AGENTS.md": "74725a71e531502d4d4898518bad68e610a370bd410058b58e11220532dc327f",
+    "CLAUDE.md": "785ee8d90e368806d8cf0b4d84a15f29d1dc961168bda86cf1a6c60a923c8c9b",
+    "scripts/lint-interdits.ts": "20c32a6f3af4aa68b24fe37b25a2989f58e77fd96808c3853dc6fd98f4c9af84",
+    "scripts/ogygie-design-brief.ts": "aba1585717b30808dd0bc8930a37a1ad2d83ee6869f969dbd06ca595e37a4a89",
+    "scripts/ogygie-impact.ts": "f06cc8b4a46ddfbcfb32ba747c2454548ca49918123d04ab13d210b4a89c1fb9",
+    "scripts/verify-contracts.ts": "9cd64c88dcc3b54b65bf1e1b7a68eb00353ee16f2a9ce8bca3c49ba063c2a08b",
+    "scripts/verify-manifest.ts": "1adca9edee11e54ccaf0511012411516c52c68a32f686ca320c7e437afb22c7c",
+    "scripts/verify-specs.ts": "04289dbeeb029703779757a2d8b58852c6b16414ab7503bf3223cfe4e9a4d45e",
+    "tsconfig.base.json": "0f8919e9ed8bbc88e0308fa2fa91471dabb18d1df721bd78c04076597eba89a2"
+  },
+  "0.13.0": {
+    ".github/workflows/ogygie-gates.yml": "48c40efe9fe66dd0f9c3b94287026d80eae9afd6782b5833fdf8846d8662babf",
+    "AGENTS.md": "74725a71e531502d4d4898518bad68e610a370bd410058b58e11220532dc327f",
+    "CLAUDE.md": "785ee8d90e368806d8cf0b4d84a15f29d1dc961168bda86cf1a6c60a923c8c9b",
+    "scripts/lint-interdits.ts": "20c32a6f3af4aa68b24fe37b25a2989f58e77fd96808c3853dc6fd98f4c9af84",
+    "scripts/ogygie-design-brief.ts": "aba1585717b30808dd0bc8930a37a1ad2d83ee6869f969dbd06ca595e37a4a89",
+    "scripts/ogygie-impact.ts": "f06cc8b4a46ddfbcfb32ba747c2454548ca49918123d04ab13d210b4a89c1fb9",
+    "scripts/verify-contracts.ts": "9cd64c88dcc3b54b65bf1e1b7a68eb00353ee16f2a9ce8bca3c49ba063c2a08b",
+    "scripts/verify-manifest.ts": "1adca9edee11e54ccaf0511012411516c52c68a32f686ca320c7e437afb22c7c",
+    "scripts/verify-specs.ts": "04289dbeeb029703779757a2d8b58852c6b16414ab7503bf3223cfe4e9a4d45e",
+    "tsconfig.base.json": "0f8919e9ed8bbc88e0308fa2fa91471dabb18d1df721bd78c04076597eba89a2"
+  },
   "0.2.0": {
     ".github/workflows/ogygie-gates.yml": "48c40efe9fe66dd0f9c3b94287026d80eae9afd6782b5833fdf8846d8662babf",
     "AGENTS.md": "ca73ab619d8c55fac11858d815bf5fbab6537ecebe7ae4123cbdeb3e3e36bf1a",
@@ -15764,23 +15929,23 @@ var governedChecksumsByVersion = {
 };
 
 // src/paths.ts
-import { existsSync as existsSync6, readFileSync as readFileSync7 } from "node:fs";
-import { dirname as dirname3, join as join8 } from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync9 } from "node:fs";
+import { dirname as dirname4, join as join10 } from "node:path";
 import { fileURLToPath } from "node:url";
-var PACKAGE_ROOT = join8(dirname3(fileURLToPath(import.meta.url)), "..");
+var PACKAGE_ROOT = join10(dirname4(fileURLToPath(import.meta.url)), "..");
 var PackageVersionSchema2 = external_exports.object({ version: external_exports.string() });
 function cliVersion() {
   return PackageVersionSchema2.parse(
-    JSON.parse(readFileSync7(join8(PACKAGE_ROOT, "package.json"), "utf8"))
+    JSON.parse(readFileSync9(join10(PACKAGE_ROOT, "package.json"), "utf8"))
   ).version;
 }
 function templatesDir() {
-  const embedded = join8(PACKAGE_ROOT, "templates");
-  if (existsSync6(embedded)) return embedded;
+  const embedded = join10(PACKAGE_ROOT, "templates");
+  if (existsSync8(embedded)) return embedded;
   return repoTemplatesDir();
 }
 function repoTemplatesDir() {
-  return join8(PACKAGE_ROOT, "..", "..", "templates");
+  return join10(PACKAGE_ROOT, "..", "..", "templates");
 }
 
 // src/cli.ts
@@ -15800,7 +15965,7 @@ function printError(error51) {
   console.error(`  fix     : ${error51.suggestedFix}`);
 }
 async function confirmOverwrite(fullDiff) {
-  console.log("Diff des fichiers gouvern\xE9s (version install\xE9e \u2192 version cible) :\n");
+  console.log("Diff des fichiers gouvern\xE9s (\xE9tat actuel \u2192 version cible) :\n");
   console.log(fullDiff === "" ? "(aucune diff\xE9rence de contenu)" : fullDiff);
   if (skipConfirmation) return true;
   const readline = createInterface({ input: process.stdin, output: process.stdout });
@@ -15821,6 +15986,14 @@ try {
       },
       productName ?? ""
     );
+  } else if (command === "adopt") {
+    await adoptProject({
+      projectRoot: process.cwd(),
+      templatesDir: templatesDir(),
+      cliVersion: cliVersion(),
+      confirm: confirmOverwrite,
+      log: (line) => console.log(line)
+    });
   } else if (command === "upgrade") {
     await upgradeProject({
       projectRoot: process.cwd(),
@@ -15871,8 +16044,8 @@ ogygie verify-vocabulary \u2014 ${problems.length} probl\xE8me(s).`);
         code: "OGYGIE_CLI_USAGE",
         message: `Unknown command ${JSON.stringify(command ?? "")}.`,
         file: null,
-        cause: `expected one of: init <product-name>, upgrade, check, verify-vocabulary, studio, mcp (flags: --json, --yes)`,
-        suggestedFix: "Run `ogygie init <product-name>`, `ogygie upgrade`, `ogygie check`, `ogygie verify-vocabulary`, `ogygie studio` or `ogygie mcp`."
+        cause: `expected one of: init <product-name>, adopt, upgrade, check, verify-vocabulary, studio, mcp (flags: --json, --yes)`,
+        suggestedFix: "Run `ogygie init <product-name>`, `ogygie adopt`, `ogygie upgrade`, `ogygie check`, `ogygie verify-vocabulary`, `ogygie studio` or `ogygie mcp`."
       })
     );
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ogygie/cli",
-  "version": "0.11.2",
+  "version": "0.13.0",
   "description": "Ogygie framework CLI: deterministic scaffolding (init), governed-file upgrades (upgrade) and lockstep verification (check) for Ogygie products.",
   "license": "MIT",
   "type": "module",
@@ -17,7 +17,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@ogygie/core": "0.11.2",
+    "@ogygie/core": "0.13.0",
     "@types/node": "^24.0.0",
     "esbuild": "^0.28.0",
     "tsx": "^4.20.0",

package/templates/project/AGENTS.md

@@ -267,6 +267,16 @@ il devient actif le jour où le produit déclare, jamais avant. Renommer un
 concept est donc une opération à un seul endroit — on change le canonique, le
 gate liste tous les identifiants à corriger.
 
+**Les identifiants DÉRIVÉS d'un id de feature sortent du scan des alias.** Un
+id de feature nomme un document et suit la langue du projet ; le code en dérive
+mécaniquement son dossier `features/<id>/`, ses chemins d'import et ses
+`register<Id>Routes`. Un token qui porte l'id de feature comme suite EXACTE de
+segments n'est donc pas jugé, et le gate ANNONCE les ids concernés à chaque
+exécution. Un identifiant qui ne fait que COMMENCER par la racine sans reprendre
+l'id entier reste jugé : la dérogation couvre la dérivation, jamais le choix
+d'un nom. Renommer le concept reste une opération à un seul endroit — on renomme
+la feature, l'exclusion suit.
+
 Choisir les racines est un acte de conception, pas une formalité : l'appariement
 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