@decantr/cli 2.1.1 → 2.3.0

package/dist/{chunk-GOX5EJ56.js → chunk-FSZ6OIAC.js}

@@ -18,15 +18,18 @@ import {
 import {
   buildGuardRegistryContext,
   createDoctrineMap,
+  getCliTelemetryIdentityStatus,
+  isOptedIn,
   optIn,
   scanAmbientContext,
   scanProjectInteractions,
   scanRoutes,
   scanStyling,
+  sendAnalyzeCompletedTelemetry,
   sendCliCommandTelemetry,
   sendNewProjectCompletedTelemetry,
   writeDoctrineMap
-} from "./chunk-JYEEXSUX.js";
+} from "./chunk-IEW2QFYI.js";
 
 // src/index.ts
 import { existsSync as existsSync26, mkdirSync as mkdirSync12, readdirSync as readdirSync6, readFileSync as readFileSync19, writeFileSync as writeFileSync15 } from "fs";
@@ -2125,7 +2128,8 @@ var RESET2 = "\x1B[0m";
 var GREEN2 = "\x1B[32m";
 var CYAN = "\x1B[36m";
 var YELLOW = "\x1B[33m";
-function cmdAnalyze(projectRoot = process.cwd(), workspace) {
+async function cmdAnalyze(projectRoot = process.cwd(), workspace) {
+  const startedAt = Date.now();
   console.log(`
 ${BOLD}Analyzing project...${RESET2}
 `);
@@ -2275,6 +2279,22 @@ ${DIM2}Written to:${RESET2} ${outputPath}`);
 ${YELLOW}Next step:${RESET2} Review ${BOLD}.decantr/brownfield-report.md${RESET2}, then run ${BOLD}decantr init --existing --accept-proposal${RESET2} to attach Decantr using the observed proposal.
 `
   );
+  await sendAnalyzeCompletedTelemetry({
+    componentCount: components.componentCount,
+    dependencyCategoryCount: [
+      dependencies.auth,
+      dependencies.db,
+      dependencies.state,
+      dependencies.styling,
+      dependencies.ui
+    ].filter((items) => items.length > 0).length,
+    durationMs: Date.now() - startedAt,
+    pageCount: components.pageCount,
+    projectRoot,
+    routeCount: routes.routes.length,
+    success: true,
+    targetFramework: project.framework
+  });
 }
 
 // src/commands/create.ts
@@ -2948,7 +2968,7 @@ async function cmdMagic(prompt, projectRoot, options) {
     console.log(
       dim(" Running brownfield analysis instead so you can attach Decantr deliberately.\n")
     );
-    cmdAnalyze(projectRoot);
+    await cmdAnalyze(projectRoot);
     console.log(
       `${BOLD2}Recommended next step:${RESET4} ${cyan("decantr init --existing --accept-proposal")}`
     );
@@ -4163,28 +4183,162 @@ function resolveDriftEntries(projectRoot, options) {
   }
 }
 
+// src/commands/telemetry.ts
+var BOLD5 = "\x1B[1m";
+var CYAN6 = "\x1B[36m";
+var DIM11 = "\x1B[2m";
+var GREEN11 = "\x1B[32m";
+var RESET11 = "\x1B[0m";
+var DEFAULT_API_URL = "https://api.decantr.ai/v1";
+async function cmdTelemetry(args, projectRoot = process.cwd()) {
+  const subcommand = args[0] ?? "status";
+  const options = parseTelemetryOptions(args.slice(1));
+  if (subcommand === "--help" || subcommand === "-h" || subcommand === "help") {
+    printTelemetryHelp();
+    return;
+  }
+  if (subcommand === "status") {
+    printTelemetryStatus(projectRoot, options);
+    return;
+  }
+  if (subcommand === "link") {
+    await linkTelemetryIdentity(projectRoot, options);
+    return;
+  }
+  throw new Error(`Unknown telemetry command: ${subcommand}`);
+}
+function printTelemetryHelp() {
+  console.log(`
+${BOLD5}decantr telemetry${RESET11} \u2014 Inspect and link privacy-filtered CLI telemetry identity
+
+${BOLD5}Usage:${RESET11}
+  decantr telemetry status [--json]
+  decantr telemetry link [--enable] [--org <slug>] [--label <label>] [--api-key <key>] [--api-url <url>]
+
+${BOLD5}Examples:${RESET11}
+  decantr init --telemetry
+  decantr telemetry status
+  decantr login --api-key=<your-key>
+  decantr telemetry link --org my-team --label "CI runner"
+`);
+}
+function printTelemetryStatus(projectRoot, options) {
+  const status = getCliTelemetryIdentityStatus(projectRoot, { create: false });
+  if (options.json) {
+    console.log(JSON.stringify(status, null, 2));
+    return;
+  }
+  console.log(`
+${BOLD5}Decantr telemetry${RESET11}`);
+  console.log(`  Enabled:    ${status.enabled ? `${GREEN11}yes${RESET11}` : "no"}`);
+  console.log(`  Project:    ${status.hasProjectConfig ? status.projectRoot : "not initialized"}`);
+  console.log(`  Install ID: ${status.installId ?? `${DIM11}not created yet${RESET11}`}`);
+  console.log(`  Project ID: ${status.projectId ?? `${DIM11}not created yet${RESET11}`}`);
+  if (status.enabled) {
+    console.log(
+      DIM11 + "Run `decantr telemetry link` after login to attach these opaque IDs to your Decantr account/org." + RESET11
+    );
+  } else {
+    console.log(DIM11 + "Run `decantr init --telemetry` or `decantr telemetry link --enable` to opt in." + RESET11);
+  }
+}
+async function linkTelemetryIdentity(projectRoot, options) {
+  if (options.enable && !isOptedIn(projectRoot)) {
+    optIn(projectRoot);
+  }
+  if (!isOptedIn(projectRoot)) {
+    throw new Error("This project has not opted into telemetry. Re-run with --enable or use `decantr init --telemetry`.");
+  }
+  const identity = getCliTelemetryIdentityStatus(projectRoot, { create: true });
+  if (!identity.installId && !identity.projectId) {
+    throw new Error("No telemetry identity could be created for this project.");
+  }
+  const apiKey = options.apiKey ?? getApiKeyOrToken();
+  if (!apiKey) {
+    throw new Error("Run `decantr login --api-key=<key>` or pass `--api-key <key>` before linking telemetry.");
+  }
+  const apiUrl = trimTrailingSlashes(options.apiUrl ?? process.env.DECANTR_API_URL ?? DEFAULT_API_URL);
+  const response = await fetch(`${apiUrl}/me/telemetry-link`, {
+    method: "POST",
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json"
+    },
+    body: JSON.stringify({
+      install_id: identity.installId,
+      project_id: identity.projectId,
+      org_slug: options.org,
+      label: options.label
+    })
+  });
+  if (!response.ok) {
+    const body2 = await response.json().catch(() => null);
+    throw new Error(body2?.error ?? `Telemetry link failed with HTTP ${response.status}.`);
+  }
+  const body = await response.json().catch(() => ({ linked: 0 }));
+  console.log(`${GREEN11}Telemetry identity linked.${RESET11}`);
+  console.log(`  Linked:     ${body.linked ?? 0}`);
+  console.log(`  Install ID: ${identity.installId ?? `${DIM11}none${RESET11}`}`);
+  console.log(`  Project ID: ${identity.projectId ?? `${DIM11}none${RESET11}`}`);
+  if (options.org) console.log(`  Org:        ${CYAN6}${options.org}${RESET11}`);
+  console.log(DIM11 + "These opaque IDs now attribute opted-in CLI usage to your Decantr account/org." + RESET11);
+}
+function parseTelemetryOptions(args) {
+  const options = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--enable") {
+      options.enable = true;
+    } else if (arg === "--json") {
+      options.json = true;
+    } else if (arg === "--org" && args[i + 1]) {
+      options.org = args[++i];
+    } else if (arg.startsWith("--org=")) {
+      options.org = arg.slice("--org=".length);
+    } else if (arg === "--label" && args[i + 1]) {
+      options.label = args[++i];
+    } else if (arg.startsWith("--label=")) {
+      options.label = arg.slice("--label=".length);
+    } else if (arg === "--api-key" && args[i + 1]) {
+      options.apiKey = args[++i];
+    } else if (arg.startsWith("--api-key=")) {
+      options.apiKey = arg.slice("--api-key=".length);
+    } else if (arg === "--api-url" && args[i + 1]) {
+      options.apiUrl = args[++i];
+    } else if (arg.startsWith("--api-url=")) {
+      options.apiUrl = arg.slice("--api-url=".length);
+    }
+  }
+  return options;
+}
+function trimTrailingSlashes(value) {
+  let end = value.length;
+  while (end > 0 && value.charCodeAt(end - 1) === 47) end -= 1;
+  return value.slice(0, end);
+}
+
 // src/commands/theme-switch.ts
 import { existsSync as existsSync23, readFileSync as readFileSync16, writeFileSync as writeFileSync13 } from "fs";
 import { join as join24 } from "path";
 import { isV4 as isV46 } from "@decantr/essence-spec";
-var GREEN11 = "\x1B[32m";
+var GREEN12 = "\x1B[32m";
 var RED10 = "\x1B[31m";
 var YELLOW7 = "\x1B[33m";
-var DIM11 = "\x1B[2m";
-var RESET11 = "\x1B[0m";
+var DIM12 = "\x1B[2m";
+var RESET12 = "\x1B[0m";
 var VALID_THEME_SHAPES = ["sharp", "rounded", "pill"];
 var VALID_THEME_MODES = ["light", "dark", "auto"];
 async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
   if (!themeName) {
     console.error(
-      `${RED10}Usage: decantr theme switch <themeName> [--shape <s>] [--mode <m>]${RESET11}`
+      `${RED10}Usage: decantr theme switch <themeName> [--shape <s>] [--mode <m>]${RESET12}`
     );
     process.exitCode = 1;
     return;
   }
   const essencePath = join24(projectRoot, "decantr.essence.json");
   if (!existsSync23(essencePath)) {
-    console.error(`${RED10}No decantr.essence.json found. Run \`decantr init\` first.${RESET11}`);
+    console.error(`${RED10}No decantr.essence.json found. Run \`decantr init\` first.${RESET12}`);
     process.exitCode = 1;
     return;
   }
@@ -4192,13 +4346,13 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
   try {
     parsed = JSON.parse(readFileSync16(essencePath, "utf-8"));
   } catch (e) {
-    console.error(`${RED10}Could not read essence: ${e.message}${RESET11}`);
+    console.error(`${RED10}Could not read essence: ${e.message}${RESET12}`);
     process.exitCode = 1;
     return;
   }
   if (!isV46(parsed)) {
     console.error(
-      `${RED10}Active workflows require Essence v4.0.0. Run \`decantr migrate --to v4\` first.${RESET11}`
+      `${RED10}Active workflows require Essence v4.0.0. Run \`decantr migrate --to v4\` first.${RESET12}`
     );
     process.exitCode = 1;
     return;
@@ -4220,14 +4374,14 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
   }
   if (shape && !VALID_THEME_SHAPES.includes(shape)) {
     console.error(
-      `${RED10}Invalid shape "${shape}". Must be one of: ${VALID_THEME_SHAPES.join(", ")}.${RESET11}`
+      `${RED10}Invalid shape "${shape}". Must be one of: ${VALID_THEME_SHAPES.join(", ")}.${RESET12}`
     );
     process.exitCode = 1;
     return;
   }
   if (mode && !VALID_THEME_MODES.includes(mode)) {
     console.error(
-      `${RED10}Invalid mode "${mode}". Must be one of: ${VALID_THEME_MODES.join(", ")}.${RESET11}`
+      `${RED10}Invalid mode "${mode}". Must be one of: ${VALID_THEME_MODES.join(", ")}.${RESET12}`
     );
     process.exitCode = 1;
     return;
@@ -4257,27 +4411,27 @@ async function cmdThemeSwitch(themeName, args, projectRoot = process.cwd()) {
   } catch {
   }
   writeFileSync13(essencePath, JSON.stringify(essence, null, 2) + "\n");
-  console.log(`${GREEN11}Switched theme: ${oldThemeId} \u2192 ${themeName}${RESET11}`);
-  if (shape) console.log(`  ${DIM11}Shape: ${shape}${RESET11}`);
-  if (mode) console.log(`  ${DIM11}Mode: ${mode}${RESET11}`);
+  console.log(`${GREEN12}Switched theme: ${oldThemeId} \u2192 ${themeName}${RESET12}`);
+  if (shape) console.log(`  ${DIM12}Shape: ${shape}${RESET12}`);
+  if (mode) console.log(`  ${DIM12}Mode: ${mode}${RESET12}`);
   await refreshDerivedFiles(projectRoot, essence, registryClient);
   console.log(
-    `${GREEN11}Derived files refreshed (tokens.css, treatments.css, all contexts).${RESET11}`
+    `${GREEN12}Derived files refreshed (tokens.css, treatments.css, all contexts).${RESET12}`
   );
-  console.log(`${YELLOW7}Guard will flag code using old tokens. Run \`decantr check\`.${RESET11}`);
+  console.log(`${YELLOW7}Guard will flag code using old tokens. Run \`decantr check\`.${RESET12}`);
 }
 
 // src/prompts.ts
 import { createInterface } from "readline";
-var BOLD5 = "\x1B[1m";
-var DIM12 = "\x1B[2m";
-var RESET12 = "\x1B[0m";
-var GREEN12 = "\x1B[32m";
+var BOLD6 = "\x1B[1m";
+var DIM13 = "\x1B[2m";
+var RESET13 = "\x1B[0m";
+var GREEN13 = "\x1B[32m";
 var YELLOW8 = "\x1B[33m";
-var CYAN6 = "\x1B[36m";
+var CYAN7 = "\x1B[36m";
 function ask(question, defaultValue) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
-  const prompt = defaultValue ? `${question} ${DIM12}(${defaultValue})${RESET12}: ` : `${question}: `;
+  const prompt = defaultValue ? `${question} ${DIM13}(${defaultValue})${RESET13}: ` : `${question}: `;
   return new Promise((resolve5) => {
     rl.question(prompt, (answer) => {
       rl.close();
@@ -4287,14 +4441,14 @@ function ask(question, defaultValue) {
 }
 async function select(question, options, defaultIdx = 0, allowOther = false) {
   console.log(`
-${BOLD5}${question}${RESET12}`);
+${BOLD6}${question}${RESET13}`);
   for (let i = 0; i < options.length; i++) {
-    const marker = i === defaultIdx ? `${GREEN12}>${RESET12}` : " ";
-    const desc = options[i].description ? ` ${DIM12}\u2014 ${options[i].description}${RESET12}` : "";
+    const marker = i === defaultIdx ? `${GREEN13}>${RESET13}` : " ";
+    const desc = options[i].description ? ` ${DIM13}\u2014 ${options[i].description}${RESET13}` : "";
     console.log(`  ${marker} ${i + 1}. ${options[i].label}${desc}`);
   }
   if (allowOther) {
-    console.log(`    ${options.length + 1}. ${DIM12}other (enter custom value)${RESET12}`);
+    console.log(`    ${options.length + 1}. ${DIM13}other (enter custom value)${RESET13}`);
   }
   const maxIdx = allowOther ? options.length + 1 : options.length;
   const answer = await ask(`Choose (1-${maxIdx})`, String(defaultIdx + 1));
@@ -4313,11 +4467,11 @@ async function confirm(question, defaultYes = true) {
 }
 function warn(message) {
   console.log(`
-${YELLOW8}  Warning: ${message}${RESET12}`);
+${YELLOW8}  Warning: ${message}${RESET13}`);
 }
 function showDetection(detected) {
   console.log(`
-${CYAN6}Detected project configuration:${RESET12}`);
+${CYAN7}Detected project configuration:${RESET13}`);
   if (detected.framework !== "unknown") {
     const version = detected.version ? ` ${detected.version}` : "";
     console.log(`  Framework: ${detected.framework}${version}`);
@@ -4326,13 +4480,13 @@ ${CYAN6}Detected project configuration:${RESET12}`);
     console.log(`  Package manager: ${detected.packageManager}`);
   }
   if (detected.hasTypeScript) {
-    console.log(`  TypeScript: ${GREEN12}yes${RESET12}`);
+    console.log(`  TypeScript: ${GREEN13}yes${RESET13}`);
   }
   if (detected.hasTailwind) {
-    console.log(`  Tailwind CSS: ${GREEN12}yes${RESET12}`);
+    console.log(`  Tailwind CSS: ${GREEN13}yes${RESET13}`);
   }
   if (detected.existingEssence) {
-    console.log(`  Existing essence: ${YELLOW8}yes${RESET12}`);
+    console.log(`  Existing essence: ${YELLOW8}yes${RESET13}`);
   }
 }
 async function runInteractivePrompts(detected, archetypes, blueprints, themes, workflowSeed) {
@@ -4406,7 +4560,7 @@ async function runInteractivePrompts(detected, archetypes, blueprints, themes, w
     warn(`This project appears to be ${detected.framework} but you selected ${target}.`);
     const proceed = await confirm("Continue anyway?", false);
     if (!proceed) {
-      console.log(`${DIM12}Using detected framework: ${detected.framework}${RESET12}`);
+      console.log(`${DIM13}Using detected framework: ${detected.framework}${RESET13}`);
     }
   }
   const guardMode = await select(
@@ -4797,29 +4951,29 @@ function resolveWorkspaceInfo(cwd, projectArg) {
 }
 
 // src/index.ts
-var BOLD6 = "\x1B[1m";
-var DIM13 = "\x1B[2m";
-var RESET13 = "\x1B[0m";
+var BOLD7 = "\x1B[1m";
+var DIM14 = "\x1B[2m";
+var RESET14 = "\x1B[0m";
 var RED11 = "\x1B[31m";
-var GREEN13 = "\x1B[32m";
-var CYAN7 = "\x1B[36m";
+var GREEN14 = "\x1B[32m";
+var CYAN8 = "\x1B[36m";
 var YELLOW9 = "\x1B[33m";
 function heading2(text) {
   return `
-${BOLD6}${text}${RESET13}
+${BOLD7}${text}${RESET14}
 `;
 }
 function success3(text) {
-  return `${GREEN13}${text}${RESET13}`;
+  return `${GREEN14}${text}${RESET14}`;
 }
 function error3(text) {
-  return `${RED11}${text}${RESET13}`;
+  return `${RED11}${text}${RESET14}`;
 }
 function dim3(text) {
-  return `${DIM13}${text}${RESET13}`;
+  return `${DIM14}${text}${RESET14}`;
 }
 function cyan3(text) {
-  return `${CYAN7}${text}${RESET13}`;
+  return `${CYAN8}${text}${RESET14}`;
 }
 function formatIntelligenceSummary(intelligence) {
   if (!intelligence) {
@@ -5542,7 +5696,7 @@ async function printHostedExecutionPackBundle(essencePath, namespace, jsonOutput
     console.log(`  Files written: ${writtenContextPaths.length}`);
   }
   console.log("");
-  console.log(`${BOLD6}Route Plan:${RESET13}`);
+  console.log(`${BOLD7}Route Plan:${RESET14}`);
   for (const route of typedBundle.scaffold.data.routes) {
     const patterns = route.patternIds.length > 0 ? route.patternIds.join(", ") : "none";
     const pageLabel = route.sectionId ? `${route.sectionId}/${route.pageId}` : route.pageId;
@@ -5781,7 +5935,7 @@ async function cmdSearch(query, type, sort, recommended, intelligenceSource) {
     }
     console.log(heading2(`${results.length} result(s) for "${query}"`));
     for (const r of results) {
-      console.log(`  ${cyan3(r.type.padEnd(12))} ${BOLD6}${r.slug}${RESET13}`);
+      console.log(`  ${cyan3(r.type.padEnd(12))} ${BOLD7}${r.slug}${RESET14}`);
       console.log(`  ${dim3(r.description || "")}`);
       const intelligenceSummary = formatIntelligenceSummary(r.intelligence);
       if (intelligenceSummary) {
@@ -5812,14 +5966,14 @@ async function cmdSuggest(query, type) {
     const exact = results.filter((r) => r.slug.toLowerCase().includes(queryLower));
     const related = results.filter((r) => !r.slug.toLowerCase().includes(queryLower));
     if (exact.length > 0) {
-      console.log(`${BOLD6}Direct matches:${RESET13}`);
+      console.log(`${BOLD7}Direct matches:${RESET14}`);
       for (const r of exact.slice(0, 3)) {
         console.log(`  ${cyan3(r.slug)} - ${r.description || ""}`);
       }
       console.log("");
     }
     if (related.length > 0) {
-      console.log(`${BOLD6}Related:${RESET13}`);
+      console.log(`${BOLD7}Related:${RESET14}`);
       for (const r of related.slice(0, 5)) {
         console.log(`  ${cyan3(r.slug)} - ${r.description || ""}`);
       }
@@ -5883,14 +6037,14 @@ async function cmdValidate(path) {
     return;
   }
   const detectedVersion = isV47(essence) ? "v4" : "legacy";
-  console.log(`${DIM13}Detected essence version: ${detectedVersion}${RESET13}`);
+  console.log(`${DIM14}Detected essence version: ${detectedVersion}${RESET14}`);
   const result = validateEssence2(essence);
   if (result.valid) {
     console.log(success3(`Essence is valid (${detectedVersion}).`));
   } else {
     console.error(error3("Validation failed:"));
     for (const err of result.errors) {
-      console.error(`  ${RED11}${err}${RESET13}`);
+      console.error(`  ${RED11}${err}${RESET14}`);
     }
     process.exitCode = 1;
     return;
@@ -5911,9 +6065,9 @@ async function cmdValidate(path) {
       console.log(heading2("Guard violations:"));
       for (const v of violations) {
         const vr = v;
-        console.log(`  ${YELLOW9}[${vr.rule}]${RESET13} ${vr.message}`);
+        console.log(`  ${YELLOW9}[${vr.rule}]${RESET14} ${vr.message}`);
         if (vr.suggestion) {
-          console.log(`    ${DIM13}Suggestion: ${vr.suggestion}${RESET13}`);
+          console.log(`    ${DIM14}Suggestion: ${vr.suggestion}${RESET14}`);
         }
       }
       const hasError = violations.some((v) => v.severity === "error");
@@ -5985,9 +6139,9 @@ function enableCliTelemetry(projectRoot) {
   optIn(projectRoot);
   console.log(
     `
-${CYAN7}Telemetry enabled.${RESET13} Decantr will send privacy-filtered CLI product telemetry for this project.`
+${CYAN8}Telemetry enabled.${RESET14} Decantr will send privacy-filtered CLI product telemetry for this project.`
   );
-  console.log(`${DIM13}Set "telemetry": false in .decantr/project.json to opt out.${RESET13}`);
+  console.log(`${DIM14}Set "telemetry": false in .decantr/project.json to opt out.${RESET14}`);
 }
 function readCliPackageVersion() {
   const here = dirname4(fileURLToPath2(import.meta.url));
@@ -6109,7 +6263,7 @@ async function applyAcceptedBrownfieldProposal(input) {
       error3("Brownfield proposal produced an invalid Decantr essence. No files were changed.")
     );
     for (const validationError of validation.errors) {
-      console.log(`  ${RED11}${validationError}${RESET13}`);
+      console.log(`  ${RED11}${validationError}${RESET14}`);
     }
     process.exitCode = 1;
     return;
@@ -6200,7 +6354,7 @@ async function cmdInit(args) {
     console.log(dim3("  Found .decantr/init-seed.json brownfield guidance."));
   }
   if (detected.existingEssence && !args.existing) {
-    console.log(`${YELLOW9}Warning: decantr.essence.json already exists.${RESET13}`);
+    console.log(`${YELLOW9}Warning: decantr.essence.json already exists.${RESET14}`);
     const overwrite = await confirm("Overwrite existing configuration?", false);
     if (!overwrite) {
       console.log(dim3("Cancelled."));
@@ -6302,7 +6456,7 @@ async function cmdInit(args) {
   } else if (shouldUseRegistry && !apiAvailable) {
     if (!args.blueprint) {
       console.log(`
-${YELLOW9}You're offline. Scaffolding minimal Decantr project.${RESET13}`);
+${YELLOW9}You're offline. Scaffolding minimal Decantr project.${RESET14}`);
       console.log(
         dim3("Run `decantr sync` or `decantr upgrade` when online to pull full registry content.\n")
       );
@@ -6350,7 +6504,7 @@ ${YELLOW9}You're offline. Scaffolding minimal Decantr project.${RESET13}`);
       return;
     }
     console.log(`
-${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
+${YELLOW9}You're offline. Scaffolding Decantr default.${RESET14}`);
     console.log(dim3("Run `decantr upgrade` when online, or visit decantr.ai/registry\n"));
     selectedBlueprint = "default";
   } else if (shouldUseRegistry) {
@@ -6531,7 +6685,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
         return;
       }
       console.log(
-        `${YELLOW9}  Warning: Could not fetch blueprint "${options.blueprint}". Using defaults.${RESET13}`
+        `${YELLOW9}  Warning: Could not fetch blueprint "${options.blueprint}". Using defaults.${RESET14}`
       );
     }
   } else if (shouldUseRegistry && options.archetype) {
@@ -6546,7 +6700,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
         return;
       }
       console.log(
-        `${YELLOW9}  Warning: Could not fetch archetype "${options.archetype}". Using defaults.${RESET13}`
+        `${YELLOW9}  Warning: Could not fetch archetype "${options.archetype}". Using defaults.${RESET14}`
       );
     }
   }
@@ -6563,7 +6717,7 @@ ${YELLOW9}You're offline. Scaffolding Decantr default.${RESET13}`);
         return;
       }
       console.log(
-        `${YELLOW9}  Warning: Could not fetch theme "${options.theme}". Using defaults.${RESET13}`
+        `${YELLOW9}  Warning: Could not fetch theme "${options.theme}". Using defaults.${RESET14}`
       );
     }
   }
@@ -6689,7 +6843,7 @@ Validation warnings: ${validation.errors.join(", ")}`));
   };
   const curatedPrompt = generateCuratedPrompt(promptCtx);
   console.log("");
-  console.log(`${BOLD6}Prompt for your AI assistant:${RESET13}`);
+  console.log(`${BOLD7}Prompt for your AI assistant:${RESET14}`);
   console.log(dim3("\u2500".repeat(50)));
   console.log("");
   console.log(curatedPrompt);
@@ -6706,7 +6860,7 @@ async function cmdStatus() {
   const projectJsonPath = join27(projectRoot, ".decantr", "project.json");
   console.log(heading2("Decantr Project Status"));
   if (!existsSync26(essencePath)) {
-    console.log(`${RED11}No decantr.essence.json found.${RESET13}`);
+    console.log(`${RED11}No decantr.essence.json found.${RESET14}`);
     console.log(dim3('Run "decantr init" to create one.'));
     return;
   }
@@ -6714,11 +6868,11 @@ async function cmdStatus() {
     const essence = JSON.parse(readFileSync19(essencePath, "utf-8"));
     const validation = validateEssence2(essence);
     const essenceVersion = isV47(essence) ? "v4" : "legacy";
-    console.log(`${BOLD6}Essence:${RESET13}`);
+    console.log(`${BOLD7}Essence:${RESET14}`);
     if (validation.valid) {
-      console.log(`  ${GREEN13}Valid${RESET13} (${essenceVersion})`);
+      console.log(`  ${GREEN14}Valid${RESET14} (${essenceVersion})`);
     } else {
-      console.log(`  ${RED11}Invalid: ${validation.errors.join(", ")}${RESET13}`);
+      console.log(`  ${RED11}Invalid: ${validation.errors.join(", ")}${RESET14}`);
     }
     if (isV47(essence)) {
       const v4 = essence;
@@ -6726,7 +6880,7 @@ async function cmdStatus() {
       const flatPages = sections.flatMap((section) => section.pages ?? []);
       const resolvedShell = sections.find((section) => section.role === "primary")?.shell || sections[0]?.shell || v4.blueprint.shell || "unknown";
       const resolvedFeatures = v4.blueprint.features ?? [];
-      console.log(`  ${BOLD6}DNA:${RESET13}`);
+      console.log(`  ${BOLD7}DNA:${RESET14}`);
       console.log(`    Theme: ${v4.dna.theme.id} (${v4.dna.theme.mode})`);
       console.log(
         `    Spacing: ${v4.dna.spacing.density} density, ${v4.dna.spacing.content_gap} gap`
@@ -6738,42 +6892,42 @@ async function cmdStatus() {
       );
       console.log(`    Accessibility: WCAG ${v4.dna.accessibility.wcag_level}`);
       console.log(`    Personality: ${v4.dna.personality.join(", ")}`);
-      console.log(`  ${BOLD6}Blueprint:${RESET13}`);
+      console.log(`  ${BOLD7}Blueprint:${RESET14}`);
       console.log(`    Shell: ${resolvedShell}`);
       console.log(`    Pages: ${flatPages.length}`);
       console.log(`    Sections: ${sections.length}`);
       console.log(
         `    Features: ${resolvedFeatures.length > 0 ? resolvedFeatures.join(", ") : "none"}`
       );
-      console.log(`  ${BOLD6}Meta:${RESET13}`);
+      console.log(`  ${BOLD7}Meta:${RESET14}`);
       console.log(`    Archetype: ${v4.meta.archetype}`);
       console.log(`    Target: ${v4.meta.target}`);
       console.log(
         `    Guard: ${v4.meta.guard.mode} (DNA: ${v4.meta.guard.dna_enforcement}, Blueprint: ${v4.meta.guard.blueprint_enforcement})`
       );
     } else {
-      console.log(`  ${YELLOW9}Run \`decantr migrate --to v4\` to upgrade this project.${RESET13}`);
+      console.log(`  ${YELLOW9}Run \`decantr migrate --to v4\` to upgrade this project.${RESET14}`);
     }
   } catch (e) {
-    console.log(`  ${RED11}Error reading essence: ${e.message}${RESET13}`);
+    console.log(`  ${RED11}Error reading essence: ${e.message}${RESET14}`);
   }
   console.log("");
-  console.log(`${BOLD6}Sync Status:${RESET13}`);
+  console.log(`${BOLD7}Sync Status:${RESET14}`);
   if (existsSync26(projectJsonPath)) {
     try {
       const projectJson = JSON.parse(readFileSync19(projectJsonPath, "utf-8"));
       const syncStatus = projectJson.sync?.status || "unknown";
       const lastSync = projectJson.sync?.lastSync || "never";
       const source = projectJson.sync?.registrySource || "unknown";
-      const statusColor = syncStatus === "synced" ? GREEN13 : YELLOW9;
-      console.log(`  Status: ${statusColor}${syncStatus}${RESET13}`);
+      const statusColor = syncStatus === "synced" ? GREEN14 : YELLOW9;
+      console.log(`  Status: ${statusColor}${syncStatus}${RESET14}`);
       console.log(`  Last sync: ${dim3(lastSync)}`);
       console.log(`  Source: ${dim3(source)}`);
     } catch {
-      console.log(`  ${YELLOW9}Could not read project.json${RESET13}`);
+      console.log(`  ${YELLOW9}Could not read project.json${RESET14}`);
     }
   } else {
-    console.log(`  ${YELLOW9}No .decantr/project.json found${RESET13}`);
+    console.log(`  ${YELLOW9}No .decantr/project.json found${RESET14}`);
     console.log(dim3('  Run "decantr init" to create project files.'));
   }
 }
@@ -6786,12 +6940,12 @@ async function cmdSync() {
     console.log(success3("Sync completed successfully."));
     console.log(`  Synced: ${result.synced.join(", ")}`);
     if (result.failed.length > 0) {
-      console.log(`  ${YELLOW9}Failed: ${result.failed.join(", ")}${RESET13}`);
+      console.log(`  ${YELLOW9}Failed: ${result.failed.join(", ")}${RESET14}`);
     }
   } else {
-    console.log(`${YELLOW9}Could not sync: API unavailable${RESET13}`);
+    console.log(`${YELLOW9}Could not sync: API unavailable${RESET14}`);
     if (result.failed.length > 0) {
-      console.log(`  ${YELLOW9}Failed: ${result.failed.join(", ")}${RESET13}`);
+      console.log(`  ${YELLOW9}Failed: ${result.failed.join(", ")}${RESET14}`);
     }
   }
 }
@@ -6801,15 +6955,15 @@ function printVerificationFindings(findings) {
     return;
   }
   for (const finding of findings) {
-    const color = finding.severity === "error" ? RED11 : finding.severity === "warn" ? YELLOW9 : CYAN7;
+    const color = finding.severity === "error" ? RED11 : finding.severity === "warn" ? YELLOW9 : CYAN8;
     console.log(
-      `  ${color}[${finding.severity.toUpperCase()}]${RESET13} ${finding.category}: ${finding.message}`
+      `  ${color}[${finding.severity.toUpperCase()}]${RESET14} ${finding.category}: ${finding.message}`
     );
     for (const evidence of finding.evidence) {
-      console.log(`    ${DIM13}${evidence}${RESET13}`);
+      console.log(`    ${DIM14}${evidence}${RESET14}`);
     }
     if (finding.suggestedFix) {
-      console.log(`    ${DIM13}Fix: ${finding.suggestedFix}${RESET13}`);
+      console.log(`    ${DIM14}Fix: ${finding.suggestedFix}${RESET14}`);
     }
   }
 }
@@ -6817,10 +6971,10 @@ function printProjectAuditReport(report) {
   if (report.valid) {
     console.log(success3("Project contract is valid."));
   } else {
-    console.log(`${RED11}Project audit found blocking issues.${RESET13}`);
+    console.log(`${RED11}Project audit found blocking issues.${RESET14}`);
   }
   console.log("");
-  console.log(`${BOLD6}Summary:${RESET13}`);
+  console.log(`${BOLD7}Summary:${RESET14}`);
   console.log(`  Essence version: ${report.summary.essenceVersion ?? "missing"}`);
   console.log(`  Pages defined: ${report.summary.pageCount}`);
   console.log(`  Pack manifest: ${report.summary.packManifestPresent ? "present" : "missing"}`);
@@ -6849,23 +7003,23 @@ function printProjectAuditReport(report) {
     `  Findings: ${report.summary.errorCount} error(s), ${report.summary.warnCount} warn(s), ${report.summary.infoCount} info`
   );
   console.log("");
-  console.log(`${BOLD6}Findings:${RESET13}`);
+  console.log(`${BOLD7}Findings:${RESET14}`);
   printVerificationFindings(report.findings);
 }
 function printFileCritiqueReport(report) {
   console.log(success3(`Critiqued ${report.file}`));
   console.log("");
-  console.log(`${BOLD6}Summary:${RESET13}`);
+  console.log(`${BOLD7}Summary:${RESET14}`);
   console.log(`  Overall score: ${report.overall}/5`);
   console.log(`  Focus areas: ${report.focusAreas.join(", ")}`);
   console.log(`  Review pack: ${report.reviewPack ? "present" : "missing"}`);
   console.log("");
-  console.log(`${BOLD6}Scores:${RESET13}`);
+  console.log(`${BOLD7}Scores:${RESET14}`);
   for (const score of report.scores) {
     console.log(`  ${cyan3(score.category.padEnd(20))} ${score.score}/5  ${dim3(score.details)}`);
   }
   console.log("");
-  console.log(`${BOLD6}Findings:${RESET13}`);
+  console.log(`${BOLD7}Findings:${RESET14}`);
   printVerificationFindings(report.findings);
 }
 async function cmdAudit(filePath) {
@@ -6906,7 +7060,7 @@ async function cmdAudit(filePath) {
       console.log(dim3("Project audit completed with advisory findings."));
     }
   } catch (e) {
-    console.log(`${RED11}Error: ${e.message}${RESET13}`);
+    console.log(`${RED11}Error: ${e.message}${RESET14}`);
     process.exitCode = 1;
   }
 }
@@ -6915,9 +7069,9 @@ async function cmdTheme(args) {
   const projectRoot = process.cwd();
   if (!subcommand || subcommand === "help") {
     console.log(`
-${BOLD6}decantr theme${RESET13} \u2014 Manage custom themes
+${BOLD7}decantr theme${RESET14} \u2014 Manage custom themes
 
-${BOLD6}Commands:${RESET13}
+${BOLD7}Commands:${RESET14}
   ${cyan3("create")} <name>        Create a new custom theme
   ${cyan3("create")} <name> --guided   Interactive theme creation
   ${cyan3("list")}                 List custom themes
@@ -6925,7 +7079,7 @@ ${BOLD6}Commands:${RESET13}
   ${cyan3("delete")} <name>        Delete a custom theme
   ${cyan3("import")} <path>        Import theme from JSON file
 
-${BOLD6}Examples:${RESET13}
+${BOLD7}Examples:${RESET14}
   decantr theme create mytheme
   decantr theme list
   decantr theme validate mytheme
@@ -6988,7 +7142,7 @@ ${BOLD6}Examples:${RESET13}
         } else {
           console.error(error3("Validation failed:"));
           for (const err of result.errors) {
-            console.error(`  ${RED11}${err}${RESET13}`);
+            console.error(`  ${RED11}${err}${RESET14}`);
           }
           process.exitCode = 1;
         }
@@ -7028,7 +7182,7 @@ ${BOLD6}Examples:${RESET13}
       } else {
         console.error(error3("Import failed:"));
         for (const err of result.errors || []) {
-          console.error(`  ${RED11}${err}${RESET13}`);
+          console.error(`  ${RED11}${err}${RESET14}`);
         }
         process.exitCode = 1;
       }
@@ -7051,9 +7205,9 @@ ${BOLD6}Examples:${RESET13}
 }
 function cmdHelp() {
   console.log(`
-${BOLD6}decantr${RESET13} \u2014 Design intelligence for AI-generated UI
+${BOLD7}decantr${RESET14} \u2014 Design intelligence for AI-generated UI
 
-${BOLD6}Usage:${RESET13}
+${BOLD7}Usage:${RESET14}
   decantr new <name> [--blueprint=X] [--archetype=X] [--theme=X] [--workflow=greenfield] [--adoption=decantr-css] [--telemetry]
   decantr magic <prompt> [--dry-run]
   decantr init [options]
@@ -7077,7 +7231,9 @@ ${BOLD6}Usage:${RESET13}
   decantr health [--format text|json|markdown] [--ci] [--fail-on error|warn|none]
   decantr health init-ci [--force] [--project <path>] [--fail-on <error|warn|none>] [--cli-version <version|latest>]
   decantr content-health [--json] [--markdown] [--ci]
-  decantr studio [--port 4319] [--host 127.0.0.1]
+  decantr studio [--port 4319] [--host 127.0.0.1] [--report decantr-health.json]
+  decantr telemetry status [--json]
+  decantr telemetry link [--enable] [--org <slug>]
   decantr rules preview [--project=<path>]
   decantr rules apply [--project=<path>]
   decantr validate [path]
@@ -7089,7 +7245,7 @@ ${BOLD6}Usage:${RESET13}
   decantr logout
   decantr help
 
-${BOLD6}Init Options:${RESET13}
+${BOLD7}Init Options:${RESET14}
   --blueprint, -b    Blueprint ID
   --theme            Theme ID
   --mode             Color mode: dark | light | auto
@@ -7111,7 +7267,7 @@ ${BOLD6}Init Options:${RESET13}
   --registry         Custom registry URL
   --telemetry        Opt this project into privacy-filtered CLI product telemetry
 
-${BOLD6}Commands:${RESET13}
+${BOLD7}Commands:${RESET14}
   ${cyan3("new")}         Create a new greenfield workspace and bootstrap the available starter adapter
   ${cyan3("magic")}       Greenfield-first intent flow; steers existing apps into analyze + init
   ${cyan3("init")}        Attach Decantr contract/context files to an existing project or empty workspace
@@ -7136,13 +7292,14 @@ ${BOLD6}Commands:${RESET13}
   ${cyan3("login")}       Authenticate with the Decantr registry
   ${cyan3("logout")}      Remove stored credentials
   ${cyan3("analyze")}     Brownfield entrypoint: scan an existing project and emit attach guidance
+  ${cyan3("telemetry")}   Inspect or link this project's opted-in CLI telemetry identity
   ${cyan3("export")}      Export design tokens to framework format (shadcn, tailwind, css-vars)
   ${cyan3("registry")}    Registry management and intelligence summary
   ${cyan3("rules")}       Preview/apply Decantr assistant bridge blocks to repo rule files
   ${cyan3("upgrade")}     Check for content updates from registry
   ${cyan3("help")}        Show this help
 
-${BOLD6}Examples:${RESET13}
+${BOLD7}Examples:${RESET14}
   decantr new my-app --blueprint=carbon-ai-portal
   decantr magic "AI chatbot with dark cyber theme \u2014 bold and futuristic"
   decantr init
@@ -7161,6 +7318,9 @@ ${BOLD6}Examples:${RESET13}
   decantr health --ci --fail-on error
   decantr content-health --ci --fail-on error
   decantr studio
+  decantr studio --report decantr-health.json
+  decantr telemetry status
+  decantr telemetry link --enable --org my-team
   decantr audit
   decantr audit src/pages/HomePage.tsx
   decantr migrate --to v4
@@ -7181,30 +7341,30 @@ ${BOLD6}Examples:${RESET13}
   decantr registry audit-project --namespace @official --dist dist --sources src
   decantr create pattern my-card
 
-${BOLD6}Workflow Model:${RESET13}
+${BOLD7}Workflow Model:${RESET14}
   ${cyan3("Greenfield blueprint")}   decantr new my-app --blueprint=X --workflow=greenfield --adoption=decantr-css
   ${cyan3("Greenfield contract")}    decantr init --workflow=greenfield --adoption=contract-only
   ${cyan3("Brownfield adoption")}    decantr analyze -> decantr init --existing --accept-proposal -> decantr check --brownfield
   ${cyan3("Hybrid composition")}     decantr add/remove, decantr theme switch, decantr registry, decantr upgrade
 
-${BOLD6}Bootstrap adapters:${RESET13}
+${BOLD7}Bootstrap adapters:${RESET14}
   Runnable starter adapters: ${cyan3("react-vite")}, ${cyan3("next-app")}
   Unsupported targets resolve through ${cyan3("generic-web")} contract-only mode until their starter adapters land.
 `);
 }
 function cmdRulesHelp() {
   console.log(`
-${BOLD6}decantr rules${RESET13} \u2014 Preview or apply assistant bridge snippets
+${BOLD7}decantr rules${RESET14} \u2014 Preview or apply assistant bridge snippets
 
-${BOLD6}Usage:${RESET13}
+${BOLD7}Usage:${RESET14}
   decantr rules preview [--project=<path>]
   decantr rules apply [--project=<path>]
 
-${BOLD6}Subcommands:${RESET13}
+${BOLD7}Subcommands:${RESET14}
   ${cyan3("preview")}  Print target-specific Decantr bridge guidance without mutating rule files
   ${cyan3("apply")}    Idempotently write Decantr bridge blocks to supported assistant rule files
 
-${BOLD6}Examples:${RESET13}
+${BOLD7}Examples:${RESET14}
   decantr rules preview
   decantr rules preview --project=apps/web
   decantr rules apply --project=apps/web
@@ -7215,9 +7375,9 @@ function isCommandHelpRequest(args) {
 }
 function cmdHealthHelp() {
   console.log(`
-${BOLD6}decantr health${RESET13} \u2014 Generate a local Project Health report
+${BOLD7}decantr health${RESET14} \u2014 Generate a local Project Health report
 
-${BOLD6}Usage:${RESET13}
+${BOLD7}Usage:${RESET14}
   decantr health [--format text|json|markdown] [--output <file>]
   decantr health --json
   decantr health --markdown
@@ -7225,7 +7385,7 @@ ${BOLD6}Usage:${RESET13}
   decantr health --prompt <finding-id>
   decantr health init-ci [--force] [--project <path>] [--fail-on error|warn|none] [--cli-version <version|latest>]
 
-${BOLD6}Options:${RESET13}
+${BOLD7}Options:${RESET14}
   --format      Output format: text, json, or markdown
   --json        Emit JSON report
   --markdown    Emit markdown report
@@ -7234,7 +7394,7 @@ ${BOLD6}Options:${RESET13}
   --fail-on     CI threshold: error, warn, or none
   --prompt      Print an AI-ready remediation prompt for a finding
 
-${BOLD6}Examples:${RESET13}
+${BOLD7}Examples:${RESET14}
   decantr health
   decantr health --json
   decantr health --markdown --output decantr-health.md
@@ -7245,16 +7405,16 @@ ${BOLD6}Examples:${RESET13}
 }
 function cmdContentHealthHelp() {
   console.log(`
-${BOLD6}decantr content-health${RESET13} \u2014 Generate a local registry content health report
+${BOLD7}decantr content-health${RESET14} \u2014 Generate a local registry content health report
 
-${BOLD6}Usage:${RESET13}
+${BOLD7}Usage:${RESET14}
   decantr content-health [--format text|json|markdown] [--output <file>]
   decantr content-health --json
   decantr content-health --markdown
   decantr content-health --ci [--fail-on error|warn|none]
   decantr content-health --prompt <finding-id>
 
-${BOLD6}Options:${RESET13}
+${BOLD7}Options:${RESET14}
   --format      Output format: text, json, or markdown
   --json        Emit JSON report
   --markdown    Emit markdown report
@@ -7263,7 +7423,7 @@ ${BOLD6}Options:${RESET13}
   --fail-on     CI threshold: error, warn, or none
   --prompt      Print an AI-ready remediation prompt for a finding
 
-${BOLD6}Examples:${RESET13}
+${BOLD7}Examples:${RESET14}
   decantr content-health
   decantr content-health --json
   decantr content-health --markdown --output content-health.md
@@ -7272,24 +7432,27 @@ ${BOLD6}Examples:${RESET13}
 }
 function cmdStudioHelp() {
   console.log(`
-${BOLD6}decantr studio${RESET13} \u2014 Run a local Project Health dashboard
+${BOLD7}decantr studio${RESET14} \u2014 Run a local Project Health dashboard
 
-${BOLD6}Usage:${RESET13}
-  decantr studio [--port 4319] [--host 127.0.0.1]
+${BOLD7}Usage:${RESET14}
+  decantr studio [--port 4319] [--host 127.0.0.1] [--report decantr-health.json]
 
-${BOLD6}Options:${RESET13}
+${BOLD7}Options:${RESET14}
   --port        Local port to bind; defaults to 4319
   --host        Local host to bind; defaults to 127.0.0.1
+  --report      Serve a read-only Project Health JSON artifact instead of scanning the current project
 
-${BOLD6}Endpoints:${RESET13}
+${BOLD7}Endpoints:${RESET14}
   GET  /
   GET  /api/health
   POST /api/refresh
 
-${BOLD6}Examples:${RESET13}
+${BOLD7}Examples:${RESET14}
   decantr studio
   decantr studio --port 4320
   decantr studio --host 127.0.0.1 --port 4319
+  decantr health --json --output decantr-health.json
+  decantr studio --report decantr-health.json
 `);
 }
 async function main() {
@@ -7414,10 +7577,10 @@ async function main() {
     case "heal": {
       if (command === "heal") {
         console.log(
-          `${YELLOW9}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET13}`
+          `${YELLOW9}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET14}`
         );
       }
-      const { cmdHeal } = await import("./heal-NWQNJ6PU.js");
+      const { cmdHeal } = await import("./heal-M6PRCIIF.js");
       const telemetryFlag = args.includes("--telemetry");
       const brownfieldFlag = args.includes("--brownfield");
       await cmdHeal(process.cwd(), { telemetry: telemetryFlag, brownfield: brownfieldFlag });
@@ -7429,7 +7592,7 @@ async function main() {
           cmdHealthHelp();
           break;
         }
-        const { cmdHealth, parseHealthArgs } = await import("./health-WJJ55W3H.js");
+        const { cmdHealth, parseHealthArgs } = await import("./health-EENY3BFS.js");
         await cmdHealth(process.cwd(), parseHealthArgs(args));
       } catch (e) {
         console.error(error3(e.message));
@@ -7457,7 +7620,7 @@ async function main() {
           cmdStudioHelp();
           break;
         }
-        const { cmdStudio, parseStudioArgs } = await import("./studio-FJNGWWRM.js");
+        const { cmdStudio, parseStudioArgs } = await import("./studio-TBJPZZHA.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error3(e.message));
@@ -7630,6 +7793,10 @@ async function main() {
       console.log(success3("Logged out. Credentials removed."));
       break;
     }
+    case "telemetry": {
+      await cmdTelemetry(args.slice(1), process.cwd());
+      break;
+    }
     case "create": {
       const type = args[1];
       const name = args[2];
@@ -7688,7 +7855,7 @@ async function main() {
         const id = args[3] && !args[3].startsWith("--") ? args[3] : void 0;
         if (!packType || !["manifest", "scaffold", "review", "section", "page", "mutation"].includes(packType)) {
           console.error(
-            `${RED11}Usage: decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context]${RESET13}`
+            `${RED11}Usage: decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context]${RESET14}`
           );
           process.exitCode = 1;
           break;
@@ -7716,7 +7883,7 @@ async function main() {
         const sourcePath = args[2] && !args[2].startsWith("--") ? args[2] : void 0;
         if (!sourcePath) {
           console.error(
-            `${RED11}Usage: decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>]${RESET13}`
+            `${RED11}Usage: decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>]${RESET14}`
           );
           process.exitCode = 1;
           break;
@@ -7741,7 +7908,7 @@ async function main() {
         await printHostedProjectAudit(namespace, jsonOutput, essencePath, distPath, sourcesPath);
       } else {
         console.error(
-          `${RED11}Usage: decantr registry mirror [--type <type>] | decantr registry summary [--namespace <namespace>] [--json] | decantr registry compile-packs [path] [--namespace <namespace>] [--json] [--write-context] | decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context] | decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>] | decantr registry audit-project [--namespace <namespace>] [--json] [--essence <path>] [--dist <path>] [--sources <dir>]${RESET13}`
+          `${RED11}Usage: decantr registry mirror [--type <type>] | decantr registry summary [--namespace <namespace>] [--json] | decantr registry compile-packs [path] [--namespace <namespace>] [--json] [--write-context] | decantr registry get-pack <manifest|scaffold|review|section|page|mutation> [id] [--namespace <namespace>] [--json] [--essence <path>] [--write-context] | decantr registry critique-file <file> [--namespace <namespace>] [--json] [--essence <path>] [--treatments <path>] | decantr registry audit-project [--namespace <namespace>] [--json] [--essence <path>] [--dist <path>] [--sources <dir>]${RESET14}`
         );
         process.exitCode = 1;
       }
@@ -7857,7 +8024,7 @@ async function main() {
         process.exitCode = 1;
         break;
       }
-      cmdAnalyze(workspaceInfo.appRoot, workspaceInfo);
+      await cmdAnalyze(workspaceInfo.appRoot, workspaceInfo);
       break;
     }
     case "rules": {
@@ -7921,7 +8088,7 @@ async function main() {
         console.error("");
         console.error("  Example:");
         console.error(
-          `    ${CYAN7}decantr magic "AI agent dashboard \u2014 dark, neon, confident"${RESET13}`
+          `    ${CYAN8}decantr magic "AI agent dashboard \u2014 dark, neon, confident"${RESET14}`
         );
         process.exitCode = 1;
         break;