@decantr/cli 2.1.2 → 2.3.0

package/README.md

@@ -81,6 +81,8 @@ decantr audit
 decantr check
 decantr health --ci --fail-on error
 decantr studio --port 4319 --host 127.0.0.1
+decantr telemetry status
+decantr telemetry link --enable --org <org-slug>
 decantr content-health --ci --fail-on error
 decantr registry summary --namespace @official --json
 decantr showcase verification --json
@@ -124,7 +126,20 @@ decantr health --json --output decantr-health.json
 decantr studio --report decantr-health.json
 ```
 
-If the project has explicitly enabled Decantr CLI telemetry, `new --telemetry`, `init --telemetry`, `check --telemetry`, `health`, and `studio` emit only aggregate product-activation metadata such as lifecycle command outcome, status, score, finding counts, CI failure outcome, Studio usage, and remediation prompt requests. They never upload the health report, finding evidence, local paths, route names, source code, or prompt text.
+If the project has explicitly enabled Decantr CLI telemetry, `new --telemetry`, `init --telemetry`, `analyze`, `check --telemetry`, `health`, and `studio` emit only aggregate product-activation metadata such as lifecycle command outcome, analyze counts, status, score, finding counts, CI failure outcome, Studio usage, and remediation prompt requests. They never upload the health report, finding evidence, local paths, route names, source code, package names, or prompt text.
+
+## Opted-In Telemetry Identity
+
+`decantr telemetry` lets users inspect and link the opaque install/project ids used by opted-in CLI telemetry. This is how customer org attribution becomes durable without collecting repository names, local paths, source code, prompts, private package slugs, emails, or secrets.
+
+```bash
+decantr telemetry status
+decantr telemetry status --json
+decantr login --api-key=<key>
+decantr telemetry link --enable --org <org-slug>
+```
+
+`telemetry link` calls the hosted `/v1/me/telemetry-link` endpoint with only opaque ids, optional org slug, and optional label. The API verifies org membership, writes `telemetry_identity_aliases`, clears the actor-resolution cache, audit logs the change, and emits `telemetry.identity_linked`.
 
 ## Content Health
 

package/dist/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-3SULF2JT.js";
+import "./chunk-FSZ6OIAC.js";
 import "./chunk-WDA4SHIQ.js";
-import "./chunk-JYEEXSUX.js";
+import "./chunk-IEW2QFYI.js";

package/dist/{chunk-DPFORHLL.js → chunk-3H3HWDJA.js}

@@ -1,11 +1,11 @@
 import {
   collectCheckIssues
-} from "./chunk-LLQCXOHK.js";
+} from "./chunk-NBJCO4G5.js";
 import {
   sendProjectHealthCiFailedTelemetry,
   sendProjectHealthPromptTelemetry,
   sendProjectHealthReportTelemetry
-} from "./chunk-JYEEXSUX.js";
+} from "./chunk-IEW2QFYI.js";
 
 // src/commands/health.ts
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";

package/dist/{chunk-3SULF2JT.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]
@@ -7078,6 +7232,8 @@ ${BOLD6}Usage:${RESET13}
   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] [--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
@@ -7162,6 +7319,8 @@ ${BOLD6}Examples:${RESET13}
   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
@@ -7182,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
@@ -7216,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
@@ -7226,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
@@ -7235,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
@@ -7246,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
@@ -7264,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
@@ -7273,22 +7432,22 @@ ${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}
+${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
@@ -7418,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 });
@@ -7433,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));
@@ -7461,7 +7620,7 @@ async function main() {
           cmdStudioHelp();
           break;
         }
-        const { cmdStudio, parseStudioArgs } = await import("./studio-7XAXWRVN.js");
+        const { cmdStudio, parseStudioArgs } = await import("./studio-TBJPZZHA.js");
         await cmdStudio(process.cwd(), parseStudioArgs(args));
       } catch (e) {
         console.error(error3(e.message));
@@ -7634,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];
@@ -7692,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;
@@ -7720,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;
@@ -7745,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;
       }
@@ -7861,7 +8024,7 @@ async function main() {
         process.exitCode = 1;
         break;
       }
-      cmdAnalyze(workspaceInfo.appRoot, workspaceInfo);
+      await cmdAnalyze(workspaceInfo.appRoot, workspaceInfo);
       break;
     }
     case "rules": {
@@ -7925,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;

package/dist/{chunk-JYEEXSUX.js → chunk-IEW2QFYI.js}

@@ -134,6 +134,30 @@ async function sendProjectHealthReportTelemetry(input) {
     });
   }
 }
+async function sendAnalyzeCompletedTelemetry(input) {
+  const projectRoot = input.projectRoot ?? process.cwd();
+  const metadata = readProjectTelemetryMetadata(projectRoot);
+  const properties = {
+    command: "analyze",
+    success: input.success,
+    durationMs: input.durationMs,
+    adoptionMode: metadata.adoptionMode ?? "contract-only",
+    componentCount: input.componentCount,
+    dependencyCategoryCount: input.dependencyCategoryCount,
+    errorCode: input.success ? void 0 : "analyze_failed",
+    pageCount: input.pageCount,
+    projectScope: metadata.projectScope ?? inferProjectScope(projectRoot),
+    routeCount: input.routeCount,
+    targetFramework: input.targetFramework,
+    workflowMode: metadata.workflowMode ?? "brownfield-attach"
+  };
+  await captureCliTelemetryEvent({
+    args: ["analyze"],
+    name: "decantr.analyze.completed",
+    projectRoot,
+    properties
+  });
+}
 async function sendNewProjectCompletedTelemetry(input) {
   const projectRoot = input.projectRoot ?? process.cwd();
   const args = input.args ?? ["new"];
@@ -303,6 +327,19 @@ function collectMetrics(essence, issues) {
     theme: theme.id ?? "unknown"
   };
 }
+function getCliTelemetryIdentityStatus(projectRoot, options = {}) {
+  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
+  const hasProjectConfig = existsSync(projectJsonPath);
+  const identities = options.create ? ensureTelemetryIdentities(projectRoot) : null;
+  const projectData = readProjectJson(projectRoot);
+  return {
+    enabled: projectData?.telemetry === true,
+    hasProjectConfig,
+    installId: identities?.installId ?? readExistingInstallId(),
+    projectId: identities?.projectId ?? readStringProperty(projectData, "telemetryProjectId"),
+    projectRoot
+  };
+}
 function ensureTelemetryIdentities(projectRoot) {
   const installId = getOrCreateInstallId();
   const projectJsonPath = join(projectRoot, ".decantr", "project.json");
@@ -348,6 +385,16 @@ function getOrCreateInstallId() {
     return `install_${randomUUID()}`;
   }
 }
+function readExistingInstallId() {
+  const configPath = join(getConfigDir(), "config.json");
+  if (!existsSync(configPath)) return void 0;
+  try {
+    const data = JSON.parse(readFileSync(configPath, "utf-8"));
+    return readStringProperty(data, "telemetryInstallId");
+  } catch {
+    return void 0;
+  }
+}
 function getConfigDir() {
   return process.env.DECANTR_CONFIG_DIR || join(homedir(), ".config", "decantr");
 }
@@ -386,6 +433,10 @@ function readProjectJson(projectRoot) {
     return null;
   }
 }
+function readStringProperty(value, key) {
+  const property = value?.[key];
+  return typeof property === "string" && property.trim() ? property : void 0;
+}
 function isRecord(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
@@ -1650,12 +1701,14 @@ export {
   optIn,
   sendCliCommandTelemetry,
   sendProjectHealthReportTelemetry,
+  sendAnalyzeCompletedTelemetry,
   sendNewProjectCompletedTelemetry,
   sendProjectHealthPromptTelemetry,
   sendProjectHealthCiFailedTelemetry,
   sendStudioStartedTelemetry,
   sendStudioHealthRefreshedTelemetry,
   collectMetrics,
+  getCliTelemetryIdentityStatus,
   buildGuardRegistryContext,
   scanProjectInteractions
 };

package/dist/{chunk-LLQCXOHK.js → chunk-NBJCO4G5.js}

@@ -10,7 +10,7 @@ import {
   scanRoutes,
   scanStyling,
   sendGuardMetrics
-} from "./chunk-JYEEXSUX.js";
+} from "./chunk-IEW2QFYI.js";
 
 // src/commands/heal.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";

package/dist/{heal-NWQNJ6PU.js → heal-M6PRCIIF.js}

@@ -1,8 +1,8 @@
 import {
   cmdHeal,
   collectCheckIssues
-} from "./chunk-LLQCXOHK.js";
-import "./chunk-JYEEXSUX.js";
+} from "./chunk-NBJCO4G5.js";
+import "./chunk-IEW2QFYI.js";
 export {
   cmdHeal,
   collectCheckIssues

package/dist/{health-WJJ55W3H.js → health-EENY3BFS.js}

@@ -8,9 +8,9 @@ import {
   renderProjectHealthCiWorkflow,
   shouldFailHealth,
   writeProjectHealthCiWorkflow
-} from "./chunk-DPFORHLL.js";
-import "./chunk-LLQCXOHK.js";
-import "./chunk-JYEEXSUX.js";
+} from "./chunk-3H3HWDJA.js";
+import "./chunk-NBJCO4G5.js";
+import "./chunk-IEW2QFYI.js";
 export {
   cmdHealth,
   createProjectHealthReport,

package/dist/index.js

@@ -1,3 +1,3 @@
-import "./chunk-3SULF2JT.js";
+import "./chunk-FSZ6OIAC.js";
 import "./chunk-WDA4SHIQ.js";
-import "./chunk-JYEEXSUX.js";
+import "./chunk-IEW2QFYI.js";

package/dist/{studio-7XAXWRVN.js → studio-TBJPZZHA.js}

@@ -1,11 +1,11 @@
 import {
   createProjectHealthReport
-} from "./chunk-DPFORHLL.js";
-import "./chunk-LLQCXOHK.js";
+} from "./chunk-3H3HWDJA.js";
+import "./chunk-NBJCO4G5.js";
 import {
   sendStudioHealthRefreshedTelemetry,
   sendStudioStartedTelemetry
-} from "./chunk-JYEEXSUX.js";
+} from "./chunk-IEW2QFYI.js";
 
 // src/commands/studio.ts
 import { readFileSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "2.1.2",
+  "version": "2.3.0",
   "description": "Decantr CLI - scaffold, audit, inspect Project Health, and maintain Decantr projects from the terminal",
   "author": "Decantr AI",
   "license": "MIT",
@@ -32,10 +32,10 @@
   "dependencies": {
     "ajv": "^8.20.0",
     "@decantr/core": "2.0.0",
-    "@decantr/essence-spec": "2.0.1",
+    "@decantr/telemetry": "2.2.0",
     "@decantr/registry": "2.0.0",
     "@decantr/verifier": "2.0.0",
-    "@decantr/telemetry": "2.1.0"
+    "@decantr/essence-spec": "2.0.1"
   },
   "scripts": {
     "build": "tsup",