@decantr/cli 1.7.25 → 1.7.27

package/dist/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-7FXMRAC3.js";
-import "./chunk-3K6HWLD5.js";
-import "./chunk-QRQCPD3C.js";
+import "./chunk-DSVBYVG5.js";
+import "./chunk-GCDFX7UE.js";
+import "./chunk-RSIOCKZF.js";

package/dist/{chunk-7FXMRAC3.js → chunk-DSVBYVG5.js}

@@ -14,11 +14,12 @@ import {
   scaffoldProject,
   syncRegistry,
   writeExecutionPackBundleArtifacts
-} from "./chunk-3K6HWLD5.js";
+} from "./chunk-GCDFX7UE.js";
 import {
   buildGuardRegistryContext,
-  scanProjectInteractions
-} from "./chunk-QRQCPD3C.js";
+  scanProjectInteractions,
+  sendCliCommandTelemetry
+} from "./chunk-RSIOCKZF.js";
 
 // src/index.ts
 import { existsSync as existsSync27, mkdirSync as mkdirSync11, readdirSync as readdirSync7, readFileSync as readFileSync20, writeFileSync as writeFileSync14 } from "fs";
@@ -40,29 +41,63 @@ import {
 } from "@decantr/verifier";
 
 // src/auth.ts
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import {
+  chmodSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  rmSync,
+  statSync,
+  writeFileSync
+} from "fs";
 import { homedir } from "os";
 import { join } from "path";
-var CONFIG_DIR = join(homedir(), ".config", "decantr");
-var AUTH_FILE = join(CONFIG_DIR, "auth.json");
+var CONFIG_DIR_MODE = 448;
+var AUTH_FILE_MODE = 384;
+function getConfigDir() {
+  return process.env.DECANTR_CONFIG_DIR || join(homedir(), ".config", "decantr");
+}
+function getAuthFile() {
+  return join(getConfigDir(), "auth.json");
+}
+function chmodIfNeeded(path, mode) {
+  try {
+    if ((statSync(path).mode & 511) !== mode) {
+      chmodSync(path, mode);
+    }
+  } catch {
+  }
+}
+function ensureConfigDir() {
+  const configDir = getConfigDir();
+  mkdirSync(configDir, { recursive: true, mode: CONFIG_DIR_MODE });
+  chmodIfNeeded(configDir, CONFIG_DIR_MODE);
+}
 function getCredentials() {
-  if (!existsSync(AUTH_FILE)) return null;
+  const authFile = getAuthFile();
+  if (!existsSync(authFile)) return null;
   try {
-    return JSON.parse(readFileSync(AUTH_FILE, "utf-8"));
+    chmodIfNeeded(authFile, AUTH_FILE_MODE);
+    return JSON.parse(readFileSync(authFile, "utf-8"));
   } catch {
     return null;
   }
 }
 function saveCredentials(creds) {
-  mkdirSync(CONFIG_DIR, { recursive: true });
-  writeFileSync(AUTH_FILE, JSON.stringify(creds, null, 2));
+  ensureConfigDir();
+  const authFile = getAuthFile();
+  writeFileSync(authFile, JSON.stringify(creds, null, 2), { mode: AUTH_FILE_MODE });
+  chmodIfNeeded(authFile, AUTH_FILE_MODE);
 }
 function clearCredentials() {
-  if (existsSync(AUTH_FILE)) {
-    rmSync(AUTH_FILE);
+  const authFile = getAuthFile();
+  if (existsSync(authFile)) {
+    rmSync(authFile);
   }
 }
 function getApiKeyOrToken() {
+  const envKey = process.env.DECANTR_API_KEY?.trim();
+  if (envKey) return envKey;
   const creds = getCredentials();
   if (!creds) return null;
   return creds.api_key || creds.access_token || null;
@@ -341,7 +376,7 @@ import { existsSync as existsSync12, mkdirSync as mkdirSync3, writeFileSync as w
 import { join as join12 } from "path";
 
 // src/analyzers/components.ts
-import { existsSync as existsSync4, readdirSync, statSync } from "fs";
+import { existsSync as existsSync4, readdirSync, statSync as statSync2 } from "fs";
 import { join as join4 } from "path";
 var PAGE_EXTENSIONS = /* @__PURE__ */ new Set([".tsx", ".ts", ".jsx", ".js"]);
 var ROOT_COMPONENT_CANDIDATES = [
@@ -366,7 +401,7 @@ function countFilesRecursive(dir, extensions) {
     if (entry.startsWith(".") || entry === "node_modules") continue;
     const fullPath = join4(dir, entry);
     try {
-      const stat = statSync(fullPath);
+      const stat = statSync2(fullPath);
       if (stat.isDirectory()) {
         count += countFilesRecursive(fullPath, extensions);
       } else if (stat.isFile()) {
@@ -392,7 +427,7 @@ function countPageFiles(dir) {
     if (entry.startsWith(".") || entry === "node_modules") continue;
     const fullPath = join4(dir, entry);
     try {
-      const stat = statSync(fullPath);
+      const stat = statSync2(fullPath);
       if (stat.isDirectory()) {
         count += countPageFiles(fullPath);
       } else if (stat.isFile()) {
@@ -632,7 +667,7 @@ function scanDependencies(projectRoot) {
 }
 
 // src/analyzers/features.ts
-import { existsSync as existsSync6, readdirSync as readdirSync2, statSync as statSync2 } from "fs";
+import { existsSync as existsSync6, readdirSync as readdirSync2, statSync as statSync3 } from "fs";
 import { join as join6 } from "path";
 var FEATURE_PATTERNS = {
   auth: [
@@ -690,7 +725,7 @@ function collectPaths(dir, baseDir, depth = 0) {
     const relPath = fullPath.slice(baseDir.length + 1);
     paths.push(relPath);
     try {
-      if (statSync2(fullPath).isDirectory()) {
+      if (statSync3(fullPath).isDirectory()) {
         paths.push(...collectPaths(fullPath, baseDir, depth + 1));
       }
     } catch {
@@ -861,7 +896,7 @@ function scanLayout(projectRoot) {
 }
 
 // src/analyzers/routes.ts
-import { existsSync as existsSync8, readdirSync as readdirSync4, readFileSync as readFileSync6, statSync as statSync3 } from "fs";
+import { existsSync as existsSync8, readdirSync as readdirSync4, readFileSync as readFileSync6, statSync as statSync4 } from "fs";
 import { join as join8, relative } from "path";
 var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".next", ".git", "api", "_app", "_document"]);
 function shouldSkipDir(name) {
@@ -910,7 +945,7 @@ function walkAppDir(dir, baseDir, segments) {
     if (shouldSkipDir(entry)) continue;
     const fullPath = join8(dir, entry);
     try {
-      if (!statSync3(fullPath).isDirectory()) continue;
+      if (!statSync4(fullPath).isDirectory()) continue;
     } catch {
       continue;
     }
@@ -932,7 +967,7 @@ function walkPagesDir(dir, baseDir, segments) {
     if (shouldSkipDir(entry)) continue;
     const fullPath = join8(dir, entry);
     try {
-      const stat = statSync3(fullPath);
+      const stat = statSync4(fullPath);
       if (stat.isDirectory()) {
         const routeSegment = segmentToRoute(entry);
         const nextSegments = routeSegment === null ? [...segments] : [...segments, routeSegment];
@@ -968,7 +1003,7 @@ function collectRouteCandidateFiles(dir, files, depth = 0) {
     if (entry.startsWith(".") || entry === "node_modules") continue;
     const fullPath = join8(dir, entry);
     try {
-      const stat = statSync3(fullPath);
+      const stat = statSync4(fullPath);
       if (stat.isDirectory()) {
         collectRouteCandidateFiles(fullPath, files, depth + 1);
       } else if (stat.isFile()) {
@@ -2668,7 +2703,7 @@ async function cmdMigrate(projectRoot = process.cwd()) {
 }
 
 // src/commands/new-project.ts
-import { execSync } from "child_process";
+import { spawnSync } from "child_process";
 import { existsSync as existsSync18, mkdirSync as mkdirSync8 } from "fs";
 import { join as join19, resolve as resolve2 } from "path";
 import { fileURLToPath } from "url";
@@ -3118,6 +3153,72 @@ function dim2(text) {
 function cyan2(text) {
   return `${CYAN3}${text}${RESET6}`;
 }
+function validatePassThroughFlagValue(flag, value) {
+  if (value.length === 0) {
+    throw new Error(`--${flag} cannot be empty.`);
+  }
+  if (value.length > 512) {
+    throw new Error(`--${flag} is too long.`);
+  }
+  if (/[\u0000-\u001f\u007f]/.test(value)) {
+    throw new Error(`--${flag} contains unsupported control characters.`);
+  }
+  return value;
+}
+function pushPassThroughFlag(flags, flag, value) {
+  if (value == null) return;
+  flags.push(`--${flag}=${validatePassThroughFlagValue(flag, value)}`);
+}
+function buildNewProjectInitArgs(options, inferredAdoption) {
+  const initFlags = [
+    "--yes",
+    "--workflow=greenfield",
+    `--adoption=${validatePassThroughFlagValue("mode", inferredAdoption)}`
+  ];
+  pushPassThroughFlag(initFlags, "blueprint", options.blueprint);
+  pushPassThroughFlag(initFlags, "archetype", options.archetype);
+  pushPassThroughFlag(initFlags, "theme", options.theme);
+  pushPassThroughFlag(initFlags, "mode", options.mode);
+  pushPassThroughFlag(initFlags, "shape", options.shape);
+  pushPassThroughFlag(initFlags, "target", options.target);
+  if (options.offline) initFlags.push("--offline");
+  pushPassThroughFlag(initFlags, "registry", options.registry);
+  pushPassThroughFlag(initFlags, "assistant-bridge", options.assistantBridge);
+  return initFlags;
+}
+function commandForPlatform(command) {
+  if (process.platform !== "win32") {
+    return command;
+  }
+  return /^(?:npm|pnpm|yarn|bun|npx)$/.test(command) ? `${command}.cmd` : command;
+}
+function runArgvCommand(command, args, cwd) {
+  const result = spawnSync(commandForPlatform(command), args, {
+    cwd,
+    stdio: "inherit",
+    shell: false
+  });
+  if (result.error) {
+    throw result.error;
+  }
+  if (result.status !== 0) {
+    throw new Error(`Command failed: ${command} ${args.join(" ")}`);
+  }
+}
+function resolveInitCommand(initFlags) {
+  const bundledCliEntrypoint = fileURLToPath(new URL("./bin.js", import.meta.url));
+  const cliEntrypoint = existsSync18(bundledCliEntrypoint) ? bundledCliEntrypoint : process.argv[1] && existsSync18(process.argv[1]) ? process.argv[1] : null;
+  if (cliEntrypoint) {
+    return {
+      command: process.execPath,
+      args: [cliEntrypoint, "init", ...initFlags]
+    };
+  }
+  return {
+    command: "npx",
+    args: ["decantr", "init", ...initFlags]
+  };
+}
 async function cmdNewProject(projectName, options) {
   const workspaceRoot = process.cwd();
   const projectDir = resolve2(workspaceRoot, projectName);
@@ -3138,6 +3239,14 @@ async function cmdNewProject(projectName, options) {
     process.exitCode = 1;
     return;
   }
+  let initFlags;
+  try {
+    initFlags = buildNewProjectInitArgs(options, inferredAdoption);
+  } catch (err) {
+    console.error(error2(err.message));
+    process.exitCode = 1;
+    return;
+  }
   console.log(heading(`Creating ${projectName}...`));
   mkdirSync8(projectDir, { recursive: true });
   console.log(dim2(`  Created ${projectName}/`));
@@ -3165,7 +3274,7 @@ async function cmdNewProject(projectName, options) {
   if (shouldBootstrapRuntime) {
     console.log(heading("Installing dependencies..."));
     try {
-      execSync(`${packageManager} install`, { cwd: projectDir, stdio: "inherit" });
+      runArgvCommand(packageManager, ["install"], projectDir);
     } catch {
       console.log(
         `
@@ -3202,21 +3311,9 @@ ${YELLOW4}Dependency install failed. Run \`${packageManager} install\` manually.
     return;
   }
   console.log(heading("Initializing Decantr..."));
-  const initFlags = ["--yes", "--workflow=greenfield", `--adoption=${inferredAdoption}`];
-  if (options.blueprint) initFlags.push(`--blueprint=${options.blueprint}`);
-  if (options.archetype) initFlags.push(`--archetype=${options.archetype}`);
-  if (options.theme) initFlags.push(`--theme=${options.theme}`);
-  if (options.mode) initFlags.push(`--mode=${options.mode}`);
-  if (options.shape) initFlags.push(`--shape=${options.shape}`);
-  if (options.target) initFlags.push(`--target=${options.target}`);
-  if (options.offline) initFlags.push("--offline");
-  if (options.registry) initFlags.push(`--registry=${options.registry}`);
-  if (options.assistantBridge) initFlags.push(`--assistant-bridge=${options.assistantBridge}`);
   try {
-    const bundledCliEntrypoint = fileURLToPath(new URL("./bin.js", import.meta.url));
-    const cliEntrypoint = existsSync18(bundledCliEntrypoint) ? bundledCliEntrypoint : process.argv[1] && existsSync18(process.argv[1]) ? process.argv[1] : null;
-    const cliPath = cliEntrypoint ? `"${process.execPath}" "${cliEntrypoint}"` : "npx decantr";
-    execSync(`${cliPath} init ${initFlags.join(" ")}`, { cwd: projectDir, stdio: "inherit" });
+    const initCommand = resolveInitCommand(initFlags);
+    runArgvCommand(initCommand.command, initCommand.args, projectDir);
     if (shouldBootstrapRuntime && bootstrapAdapter) {
       bootstrapAdapter.writeProjectFiles(projectDir, title, detectRoutingMode(projectDir));
     }
@@ -6578,7 +6675,7 @@ async function main() {
       break;
     }
     case "upgrade": {
-      const { cmdUpgrade } = await import("./upgrade-KG42WK5C.js");
+      const { cmdUpgrade } = await import("./upgrade-XMY6LIPS.js");
       const applyFlag = args.includes("--apply");
       await cmdUpgrade(process.cwd(), { apply: applyFlag });
       break;
@@ -6590,7 +6687,7 @@ async function main() {
           `${YELLOW9}Note: \`decantr heal\` is deprecated. Use \`decantr check\` instead.${RESET13}`
         );
       }
-      const { cmdHeal } = await import("./heal-EMT5LYVZ.js");
+      const { cmdHeal } = await import("./heal-JPW3BXS3.js");
       const telemetryFlag = args.includes("--telemetry");
       await cmdHeal(process.cwd(), { telemetry: telemetryFlag });
       break;
@@ -7076,8 +7173,23 @@ async function main() {
       process.exitCode = 1;
   }
 }
-main().catch((e) => {
+var cliStartedAt = Date.now();
+var cliArgs = process.argv.slice(2);
+main().then(async () => {
+  await sendCliCommandTelemetry({
+    args: cliArgs,
+    durationMs: Date.now() - cliStartedAt,
+    projectRoot: process.cwd(),
+    success: !process.exitCode || process.exitCode === 0
+  });
+}).catch(async (e) => {
   console.error(error3(e.message));
   if (e.stack) console.error(e.stack);
   process.exitCode = 1;
+  await sendCliCommandTelemetry({
+    args: cliArgs,
+    durationMs: Date.now() - cliStartedAt,
+    projectRoot: process.cwd(),
+    success: false
+  });
 });

package/dist/{chunk-3K6HWLD5.js → chunk-GCDFX7UE.js}

@@ -2422,6 +2422,18 @@ function generateTokensCSS(themeData, mode, spatialTokens, options) {
   }
   const seed = themeData.seed || {};
   const palette = themeData.palette || {};
+  const CORE_PALETTE_KEYS = /* @__PURE__ */ new Set([
+    "background",
+    "surface",
+    "surface-raised",
+    "border",
+    "text",
+    "text-muted",
+    "primary",
+    "primary-hover",
+    "secondary",
+    "accent"
+  ]);
   const resolvedMode = mode === "auto" ? "dark" : mode;
   const FALLBACKS = {
     bg: { light: "#ffffff", dark: "#18181b" },
@@ -2439,11 +2451,19 @@ function generateTokensCSS(themeData, mode, spatialTokens, options) {
       if (!fallbacks) return tokenModeKey === "light" ? "#ffffff" : "#18181b";
       return fallbacks[tokenModeKey];
     };
+    const pickPalette = (key) => {
+      const entry = palette[key];
+      return entry?.[tokenMode] || entry?.[tokenModeKey] || entry?.dark || entry?.light;
+    };
+    const extendedPaletteTokens = Object.fromEntries(
+      Object.keys(palette).filter((key) => !CORE_PALETTE_KEYS.has(key)).map((key) => [`--d-${key.replace(/[^a-zA-Z0-9-]/g, "-")}`, pickPalette(key)]).filter((entry) => typeof entry[1] === "string" && entry[1].length > 0)
+    );
     return {
       // Seed colors
-      "--d-primary": seed.primary || "#6366f1",
-      "--d-secondary": palette.secondary?.[tokenMode] || pickFb("secondary"),
-      "--d-accent": seed.accent || "#f59e0b",
+      "--d-primary": pickPalette("primary") || seed.primary || "#6366f1",
+      "--d-secondary": pickPalette("secondary") || seed.secondary || pickFb("secondary"),
+      "--d-accent": pickPalette("accent") || seed.accent || "#f59e0b",
+      ...extendedPaletteTokens,
       // Palette colors (mode-aware with mode-aware fallbacks)
       "--d-bg": palette.background?.[tokenMode] || pickFb("bg"),
       "--d-surface": palette.surface?.[tokenMode] || pickFb("surface"),
@@ -2513,12 +2533,17 @@ function generateTokensCSS(themeData, mode, spatialTokens, options) {
       "--d-motion-ease-out": "cubic-bezier(0, 0, 0.2, 1)",
       "--d-motion-ease-in": "cubic-bezier(0.4, 0, 1, 1)",
       "--d-motion-ease-spring": "cubic-bezier(0.34, 1.56, 0.64, 1)",
+      "--d-duration-hover": "var(--d-motion-fast)",
+      "--d-duration-entrance": "var(--d-motion-base)",
+      "--d-easing": "var(--d-motion-ease-out)",
+      "--d-accent-glow": "color-mix(in srgb, var(--d-accent) 24%, transparent)",
       // Typography scale (v2.1 Tier B2). Canonical sizes + weights +
       // tracking + leading. d-display, d-headline, d-title, d-prose,
       // d-caption, d-eyebrow read these. Themes override via
       // theme.typography.* below.
       "--d-font-body": "ui-sans-serif, system-ui, -apple-system, sans-serif",
       "--d-font-display": "ui-sans-serif, system-ui, -apple-system, sans-serif",
+      "--d-font-mono": "ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace",
       "--d-weight-regular": "400",
       "--d-weight-medium": "500",
       "--d-weight-semibold": "600",
@@ -2631,7 +2656,8 @@ ${lines}${spatialLines}
     "--d-elevation-2",
     "--d-elevation-3",
     "--d-elevation-4",
-    "--d-elevation-5"
+    "--d-elevation-5",
+    ...Object.keys(palette).filter((key) => !CORE_PALETTE_KEYS.has(key)).map((key) => `--d-${key.replace(/[^a-zA-Z0-9-]/g, "-")}`)
   ];
   if (mode === "auto") {
     const lightTokens = buildTokens("light");

package/dist/chunk-RSIOCKZF.js

@@ -0,0 +1,391 @@
+// src/lib/scan-interactions.ts
+import { existsSync, readdirSync, readFileSync, statSync } from "fs";
+import { extname, join } from "path";
+import { verifyInteractionsInSource } from "@decantr/verifier";
+var SCAN_EXTENSIONS = /* @__PURE__ */ new Set([".tsx", ".jsx", ".ts", ".js", ".html", ".mdx"]);
+var SKIP_DIRECTORIES = /* @__PURE__ */ new Set([
+  "node_modules",
+  ".decantr",
+  ".git",
+  "dist",
+  "build",
+  ".next",
+  ".turbo",
+  "coverage",
+  ".cache"
+]);
+var MAX_FILE_SIZE = 1024 * 1024;
+function walkSourceTree(rootDir) {
+  const sources = /* @__PURE__ */ new Map();
+  function walk(dir) {
+    let entries;
+    try {
+      entries = readdirSync(dir);
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (SKIP_DIRECTORIES.has(entry)) continue;
+      const fullPath = join(dir, entry);
+      let s;
+      try {
+        s = statSync(fullPath);
+      } catch {
+        continue;
+      }
+      if (s.isDirectory()) {
+        walk(fullPath);
+      } else if (s.isFile() && SCAN_EXTENSIONS.has(extname(entry))) {
+        if (s.size > MAX_FILE_SIZE) continue;
+        try {
+          sources.set(fullPath, readFileSync(fullPath, "utf8"));
+        } catch {
+        }
+      }
+    }
+  }
+  walk(rootDir);
+  return sources;
+}
+function collectDeclaredInteractions(projectRoot) {
+  const manifestPath = join(projectRoot, ".decantr", "context", "pack-manifest.json");
+  if (!existsSync(manifestPath)) return [];
+  let manifest;
+  try {
+    manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
+  } catch {
+    return [];
+  }
+  const all = [];
+  const pages = manifest.pages ?? [];
+  const contextDir = join(projectRoot, ".decantr", "context");
+  for (const page of pages) {
+    const packPath = join(contextDir, page.json);
+    if (!existsSync(packPath)) continue;
+    let pack;
+    try {
+      pack = JSON.parse(readFileSync(packPath, "utf8"));
+    } catch {
+      continue;
+    }
+    const patterns = pack.data?.patterns ?? [];
+    for (const pat of patterns) {
+      if (Array.isArray(pat.interactions)) {
+        all.push(...pat.interactions);
+      }
+    }
+  }
+  return all;
+}
+function scanProjectInteractions(projectRoot) {
+  const declared = collectDeclaredInteractions(projectRoot);
+  if (declared.length === 0) return [];
+  const sources = walkSourceTree(projectRoot);
+  if (sources.size === 0) return [];
+  const missing = verifyInteractionsInSource(declared, sources);
+  return missing.map(({ interaction, suggestion }) => `${interaction} \u2192 ${suggestion}`);
+}
+
+// src/guard-context.ts
+import { existsSync as existsSync2, readdirSync as readdirSync2, readFileSync as readFileSync2 } from "fs";
+import { join as join2 } from "path";
+function loadJsonEntries(dir) {
+  if (!existsSync2(dir)) return [];
+  try {
+    return readdirSync2(dir).filter((file) => file.endsWith(".json") && file !== "index.json").map((file) => JSON.parse(readFileSync2(join2(dir, file), "utf-8")));
+  } catch {
+    return [];
+  }
+}
+function buildGuardRegistryContext(projectRoot = process.cwd()) {
+  const themeRegistry = /* @__PURE__ */ new Map();
+  const patternRegistry = /* @__PURE__ */ new Map();
+  const cacheDir = join2(projectRoot, ".decantr", "cache");
+  const customDir = join2(projectRoot, ".decantr", "custom");
+  for (const data of loadJsonEntries(join2(cacheDir, "@official", "themes"))) {
+    if (typeof data.id === "string" && !themeRegistry.has(data.id)) {
+      themeRegistry.set(data.id, {
+        modes: Array.isArray(data.modes) ? data.modes.filter((mode) => typeof mode === "string") : ["light", "dark"]
+      });
+    }
+  }
+  for (const data of loadJsonEntries(join2(customDir, "themes"))) {
+    if (typeof data.id === "string") {
+      themeRegistry.set(`custom:${data.id}`, {
+        modes: Array.isArray(data.modes) ? data.modes.filter((mode) => typeof mode === "string") : ["light", "dark"]
+      });
+    }
+  }
+  for (const data of loadJsonEntries(join2(cacheDir, "@official", "patterns"))) {
+    if (typeof data.id === "string" && !patternRegistry.has(data.id)) {
+      patternRegistry.set(data.id, data);
+    }
+  }
+  for (const data of loadJsonEntries(join2(customDir, "patterns"))) {
+    if (typeof data.id === "string") {
+      patternRegistry.set(data.id, data);
+    }
+  }
+  return { themeRegistry, patternRegistry };
+}
+
+// src/telemetry.ts
+import { randomUUID } from "crypto";
+import { existsSync as existsSync3, mkdirSync, readFileSync as readFileSync3, writeFileSync } from "fs";
+import { homedir } from "os";
+import { dirname, join as join3 } from "path";
+import { fileURLToPath } from "url";
+import {
+  createFetchTelemetrySink,
+  createTelemetryClient
+} from "@decantr/telemetry";
+var TELEMETRY_ENDPOINT = "https://api.decantr.ai/v1/telemetry/guard";
+var DEFAULT_TELEMETRY_EVENTS_ENDPOINT = "https://api.decantr.ai/v1/telemetry/events";
+var TELEMETRY_TIMEOUT_MS = 3e3;
+var DNA_RULES = /* @__PURE__ */ new Set(["theme", "style", "density", "accessibility", "theme-mode"]);
+async function sendGuardMetrics(metrics) {
+  try {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), TELEMETRY_TIMEOUT_MS);
+    await fetch(TELEMETRY_ENDPOINT, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(metrics),
+      signal: controller.signal
+    });
+    clearTimeout(timer);
+  } catch {
+  }
+}
+function isOptedIn(projectRoot) {
+  const projectJsonPath = join3(projectRoot, ".decantr", "project.json");
+  if (!existsSync3(projectJsonPath)) return false;
+  try {
+    const data = JSON.parse(readFileSync3(projectJsonPath, "utf-8"));
+    return data.telemetry === true;
+  } catch {
+    return false;
+  }
+}
+function optIn(projectRoot) {
+  const projectJsonPath = join3(projectRoot, ".decantr", "project.json");
+  let data = {};
+  if (existsSync3(projectJsonPath)) {
+    try {
+      data = JSON.parse(readFileSync3(projectJsonPath, "utf-8"));
+    } catch {
+    }
+  }
+  data.telemetry = true;
+  mkdirSync(dirname(projectJsonPath), { recursive: true });
+  writeFileSync(projectJsonPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+}
+async function sendCliCommandTelemetry(input) {
+  const projectRoot = input.projectRoot ?? process.cwd();
+  const command = normalizeCommand(input.args[0]);
+  if (!isOptedIn(projectRoot) || !command || command === "help" || command === "version") {
+    return;
+  }
+  const identities = ensureTelemetryIdentities(projectRoot);
+  if (!identities) {
+    return;
+  }
+  const client = createTelemetryClient({
+    sink: createFetchTelemetrySink({
+      endpoint: getTelemetryEventsEndpoint(),
+      timeoutMs: TELEMETRY_TIMEOUT_MS
+    })
+  });
+  const event = {
+    name: "cli.command.completed",
+    context: {
+      source: "cli",
+      environment: "production",
+      decantrVersion: getCliVersion(),
+      installId: identities.installId,
+      projectId: identities.projectId,
+      registrySource: inferRegistrySource(input.args)
+    },
+    properties: {
+      command,
+      success: input.success,
+      durationMs: input.durationMs,
+      adoptionMode: inferAdoptionMode(input.args),
+      errorCode: input.success ? void 0 : "cli_command_failed",
+      offline: input.args.includes("--offline"),
+      projectScope: inferProjectScope(projectRoot),
+      registrySource: inferRegistrySource(input.args),
+      targetFramework: inferFlagValue(input.args, "--target"),
+      workflowMode: inferWorkflowMode(input.args)
+    }
+  };
+  try {
+    await client.capture(event);
+  } catch {
+  }
+}
+function collectMetrics(essence, issues) {
+  const dna = essence.dna ?? {};
+  const blueprint = essence.blueprint ?? {};
+  const meta = essence.meta ?? {};
+  const guard = meta.guard ?? {};
+  const theme = dna.theme ?? {};
+  const sections = blueprint.sections ?? [];
+  const routes = blueprint.routes ?? {};
+  const byRule = {};
+  let dnaCount = 0;
+  let blueprintCount = 0;
+  for (const issue of issues) {
+    byRule[issue.rule] = (byRule[issue.rule] ?? 0) + 1;
+    if (DNA_RULES.has(issue.rule)) {
+      dnaCount++;
+    } else {
+      blueprintCount++;
+    }
+  }
+  return {
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    cli_version: getCliVersion(),
+    essence_version: essence.version ?? "unknown",
+    guard_mode: guard.mode ?? "unknown",
+    violations: {
+      dna: dnaCount,
+      blueprint: blueprintCount,
+      by_rule: byRule
+    },
+    resolution_rate: 0,
+    sections_count: sections.length,
+    routes_count: Object.keys(routes).length,
+    theme: theme.id ?? "unknown"
+  };
+}
+function ensureTelemetryIdentities(projectRoot) {
+  const installId = getOrCreateInstallId();
+  const projectJsonPath = join3(projectRoot, ".decantr", "project.json");
+  if (!existsSync3(projectJsonPath)) {
+    return null;
+  }
+  try {
+    const data = JSON.parse(readFileSync3(projectJsonPath, "utf-8"));
+    let projectId = typeof data.telemetryProjectId === "string" ? data.telemetryProjectId : void 0;
+    if (!projectId) {
+      projectId = `project_${randomUUID()}`;
+      data.telemetryProjectId = projectId;
+      writeFileSync(projectJsonPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+    }
+    return { installId, projectId };
+  } catch {
+    return null;
+  }
+}
+function getOrCreateInstallId() {
+  const configDir = getConfigDir();
+  const configPath = join3(configDir, "config.json");
+  try {
+    if (existsSync3(configPath)) {
+      const data = JSON.parse(readFileSync3(configPath, "utf-8"));
+      if (typeof data.telemetryInstallId === "string") {
+        return data.telemetryInstallId;
+      }
+      const installId2 = `install_${randomUUID()}`;
+      data.telemetryInstallId = installId2;
+      writeFileSync(configPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
+      return installId2;
+    }
+    mkdirSync(configDir, { recursive: true });
+    const installId = `install_${randomUUID()}`;
+    writeFileSync(
+      configPath,
+      JSON.stringify({ telemetryInstallId: installId }, null, 2) + "\n",
+      "utf-8"
+    );
+    return installId;
+  } catch {
+    return `install_${randomUUID()}`;
+  }
+}
+function getConfigDir() {
+  return process.env.DECANTR_CONFIG_DIR || join3(homedir(), ".config", "decantr");
+}
+function getTelemetryEventsEndpoint() {
+  return process.env.DECANTR_TELEMETRY_ENDPOINT || DEFAULT_TELEMETRY_EVENTS_ENDPOINT;
+}
+function normalizeCommand(command) {
+  if (!command) return null;
+  if (command === "--help" || command === "-h") return "help";
+  if (command === "--version" || command === "-v") return "version";
+  return command;
+}
+function inferFlagValue(args, flag) {
+  const equalsPrefix = `${flag}=`;
+  const inline = args.find((arg) => arg.startsWith(equalsPrefix));
+  if (inline) {
+    return inline.slice(equalsPrefix.length) || void 0;
+  }
+  const index = args.indexOf(flag);
+  if (index !== -1 && args[index + 1] && !args[index + 1].startsWith("-")) {
+    return args[index + 1];
+  }
+  return void 0;
+}
+function inferAdoptionMode(args) {
+  const value = inferFlagValue(args, "--adoption");
+  if (value === "contract-only" || value === "decantr-css" || value === "style-bridge") {
+    return value;
+  }
+  return void 0;
+}
+function inferWorkflowMode(args) {
+  const value = inferFlagValue(args, "--workflow");
+  if (value === "greenfield" || value === "greenfield-scaffold") {
+    return "greenfield-scaffold";
+  }
+  if (value === "contract" || value === "greenfield-contract-only") {
+    return "greenfield-contract-only";
+  }
+  if (value === "brownfield" || value === "brownfield-attach") {
+    return "brownfield-attach";
+  }
+  if (value === "hybrid" || value === "hybrid-compose") {
+    return "hybrid-compose";
+  }
+  return void 0;
+}
+function inferRegistrySource(args) {
+  if (args.includes("--offline")) {
+    return "cache";
+  }
+  if (args.some((arg) => arg === "--registry" || arg.startsWith("--registry="))) {
+    return "custom";
+  }
+  return "official";
+}
+function inferProjectScope(projectRoot) {
+  return existsSync3(join3(projectRoot, "pnpm-workspace.yaml")) || existsSync3(join3(projectRoot, "turbo.json")) || existsSync3(join3(projectRoot, "lerna.json")) ? "workspace-app" : "single-app";
+}
+function getCliVersion() {
+  try {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const candidates = [join3(here, "..", "package.json"), join3(here, "..", "..", "package.json")];
+    for (const candidate of candidates) {
+      if (existsSync3(candidate)) {
+        const pkg = JSON.parse(readFileSync3(candidate, "utf-8"));
+        if (pkg.version) {
+          return pkg.version;
+        }
+      }
+    }
+  } catch {
+  }
+  return "unknown";
+}
+
+export {
+  scanProjectInteractions,
+  buildGuardRegistryContext,
+  sendGuardMetrics,
+  isOptedIn,
+  optIn,
+  sendCliCommandTelemetry,
+  collectMetrics
+};

package/dist/heal-JPW3BXS3.js

@@ -0,0 +1,99 @@
+import {
+  buildGuardRegistryContext,
+  collectMetrics,
+  isOptedIn,
+  optIn,
+  scanProjectInteractions,
+  sendGuardMetrics
+} from "./chunk-RSIOCKZF.js";
+
+// src/commands/heal.ts
+import { existsSync, readFileSync } from "fs";
+import { join } from "path";
+import { evaluateGuard, validateEssence } from "@decantr/essence-spec";
+var GREEN = "\x1B[32m";
+var RED = "\x1B[31m";
+var YELLOW = "\x1B[33m";
+var CYAN = "\x1B[36m";
+var RESET = "\x1B[0m";
+var DIM = "\x1B[2m";
+async function cmdHeal(projectRoot = process.cwd(), options = {}) {
+  const essencePath = join(projectRoot, "decantr.essence.json");
+  if (!existsSync(essencePath)) {
+    console.error("No decantr.essence.json found. Run `decantr init` first.");
+    process.exitCode = 1;
+    return;
+  }
+  const essence = JSON.parse(readFileSync(essencePath, "utf-8"));
+  console.log("Scanning for issues...\n");
+  const issues = [];
+  const validation = validateEssence(essence);
+  if (!validation.valid) {
+    for (const err of validation.errors) {
+      issues.push({
+        type: "error",
+        rule: "schema",
+        message: err
+      });
+    }
+  }
+  let interactionIssues = [];
+  try {
+    interactionIssues = scanProjectInteractions(projectRoot);
+  } catch {
+  }
+  try {
+    const guardContext = buildGuardRegistryContext(projectRoot);
+    const violations = evaluateGuard(essence, {
+      ...guardContext,
+      interaction_issues: interactionIssues
+    });
+    for (const v of violations) {
+      issues.push({
+        type: v.severity === "error" ? "error" : "warning",
+        rule: v.rule,
+        message: v.message,
+        suggestion: v.suggestion
+      });
+    }
+  } catch {
+  }
+  if (issues.length === 0) {
+    console.log(`${GREEN}No issues found. Project is healthy.${RESET}`);
+    await maybeSendTelemetry(projectRoot, essence, issues, options);
+    return;
+  }
+  console.log(`Found ${issues.length} issue(s):
+`);
+  for (const issue of issues) {
+    const icon = issue.type === "error" ? `${RED}x${RESET}` : `${YELLOW}!${RESET}`;
+    console.log(`${icon} [${issue.rule}] ${issue.message}`);
+    if (issue.suggestion) {
+      console.log(`  ${DIM}Suggestion: ${issue.suggestion}${RESET}`);
+    }
+  }
+  console.log(`
+${YELLOW}Manual fixes required. Review the issues above.${RESET}`);
+  const hasError = issues.some((i) => i.type === "error");
+  if (hasError) {
+    process.exitCode = 1;
+  }
+  await maybeSendTelemetry(projectRoot, essence, issues, options);
+}
+async function maybeSendTelemetry(projectRoot, essence, issues, options) {
+  if (options.telemetry && !isOptedIn(projectRoot)) {
+    optIn(projectRoot);
+    console.log(
+      `
+${CYAN}Telemetry enabled.${RESET} Anonymous guard metrics will be sent on future checks.`
+    );
+    console.log(`${DIM}Set "telemetry": false in .decantr/project.json to opt out.${RESET}`);
+  }
+  if (isOptedIn(projectRoot)) {
+    const metrics = collectMetrics(essence, issues);
+    sendGuardMetrics(metrics);
+  }
+}
+export {
+  cmdHeal
+};

package/dist/index.js

@@ -1,3 +1,3 @@
-import "./chunk-7FXMRAC3.js";
-import "./chunk-3K6HWLD5.js";
-import "./chunk-QRQCPD3C.js";
+import "./chunk-DSVBYVG5.js";
+import "./chunk-GCDFX7UE.js";
+import "./chunk-RSIOCKZF.js";

package/dist/{upgrade-KG42WK5C.js → upgrade-XMY6LIPS.js}

@@ -1,7 +1,7 @@
 import {
   RegistryClient,
   refreshDerivedFiles
-} from "./chunk-3K6HWLD5.js";
+} from "./chunk-GCDFX7UE.js";
 
 // src/commands/upgrade.ts
 import { existsSync, readFileSync, writeFileSync } from "fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decantr/cli",
-  "version": "1.7.25",
+  "version": "1.7.27",
   "description": "Decantr CLI — scaffold, audit, and maintain Decantr projects from the terminal",
   "author": "Decantr AI",
   "license": "MIT",
@@ -23,14 +23,18 @@
     "src/templates",
     "src/bundled"
   ],
+  "engines": {
+    "node": ">=20"
+  },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
-    "@decantr/core": "1.0.5",
-    "@decantr/essence-spec": "1.0.5",
-    "@decantr/registry": "1.0.3",
-    "@decantr/verifier": "1.0.4"
+    "@decantr/core": "1.0.6",
+    "@decantr/essence-spec": "1.0.6",
+    "@decantr/telemetry": "0.1.0",
+    "@decantr/verifier": "1.0.5",
+    "@decantr/registry": "1.0.4"
   },
   "scripts": {
     "build": "tsup",

package/dist/chunk-QRQCPD3C.js

@@ -1,135 +0,0 @@
-// src/lib/scan-interactions.ts
-import { existsSync, readdirSync, readFileSync, statSync } from "fs";
-import { extname, join } from "path";
-import { verifyInteractionsInSource } from "@decantr/verifier";
-var SCAN_EXTENSIONS = /* @__PURE__ */ new Set([".tsx", ".jsx", ".ts", ".js", ".html", ".mdx"]);
-var SKIP_DIRECTORIES = /* @__PURE__ */ new Set([
-  "node_modules",
-  ".decantr",
-  ".git",
-  "dist",
-  "build",
-  ".next",
-  ".turbo",
-  "coverage",
-  ".cache"
-]);
-var MAX_FILE_SIZE = 1024 * 1024;
-function walkSourceTree(rootDir) {
-  const sources = /* @__PURE__ */ new Map();
-  function walk(dir) {
-    let entries;
-    try {
-      entries = readdirSync(dir);
-    } catch {
-      return;
-    }
-    for (const entry of entries) {
-      if (SKIP_DIRECTORIES.has(entry)) continue;
-      const fullPath = join(dir, entry);
-      let s;
-      try {
-        s = statSync(fullPath);
-      } catch {
-        continue;
-      }
-      if (s.isDirectory()) {
-        walk(fullPath);
-      } else if (s.isFile() && SCAN_EXTENSIONS.has(extname(entry))) {
-        if (s.size > MAX_FILE_SIZE) continue;
-        try {
-          sources.set(fullPath, readFileSync(fullPath, "utf8"));
-        } catch {
-        }
-      }
-    }
-  }
-  walk(rootDir);
-  return sources;
-}
-function collectDeclaredInteractions(projectRoot) {
-  const manifestPath = join(projectRoot, ".decantr", "context", "pack-manifest.json");
-  if (!existsSync(manifestPath)) return [];
-  let manifest;
-  try {
-    manifest = JSON.parse(readFileSync(manifestPath, "utf8"));
-  } catch {
-    return [];
-  }
-  const all = [];
-  const pages = manifest.pages ?? [];
-  const contextDir = join(projectRoot, ".decantr", "context");
-  for (const page of pages) {
-    const packPath = join(contextDir, page.json);
-    if (!existsSync(packPath)) continue;
-    let pack;
-    try {
-      pack = JSON.parse(readFileSync(packPath, "utf8"));
-    } catch {
-      continue;
-    }
-    const patterns = pack.data?.patterns ?? [];
-    for (const pat of patterns) {
-      if (Array.isArray(pat.interactions)) {
-        all.push(...pat.interactions);
-      }
-    }
-  }
-  return all;
-}
-function scanProjectInteractions(projectRoot) {
-  const declared = collectDeclaredInteractions(projectRoot);
-  if (declared.length === 0) return [];
-  const sources = walkSourceTree(projectRoot);
-  if (sources.size === 0) return [];
-  const missing = verifyInteractionsInSource(declared, sources);
-  return missing.map(({ interaction, suggestion }) => `${interaction} \u2192 ${suggestion}`);
-}
-
-// src/guard-context.ts
-import { existsSync as existsSync2, readdirSync as readdirSync2, readFileSync as readFileSync2 } from "fs";
-import { join as join2 } from "path";
-function loadJsonEntries(dir) {
-  if (!existsSync2(dir)) return [];
-  try {
-    return readdirSync2(dir).filter((file) => file.endsWith(".json") && file !== "index.json").map((file) => JSON.parse(readFileSync2(join2(dir, file), "utf-8")));
-  } catch {
-    return [];
-  }
-}
-function buildGuardRegistryContext(projectRoot = process.cwd()) {
-  const themeRegistry = /* @__PURE__ */ new Map();
-  const patternRegistry = /* @__PURE__ */ new Map();
-  const cacheDir = join2(projectRoot, ".decantr", "cache");
-  const customDir = join2(projectRoot, ".decantr", "custom");
-  for (const data of loadJsonEntries(join2(cacheDir, "@official", "themes"))) {
-    if (typeof data.id === "string" && !themeRegistry.has(data.id)) {
-      themeRegistry.set(data.id, {
-        modes: Array.isArray(data.modes) ? data.modes.filter((mode) => typeof mode === "string") : ["light", "dark"]
-      });
-    }
-  }
-  for (const data of loadJsonEntries(join2(customDir, "themes"))) {
-    if (typeof data.id === "string") {
-      themeRegistry.set(`custom:${data.id}`, {
-        modes: Array.isArray(data.modes) ? data.modes.filter((mode) => typeof mode === "string") : ["light", "dark"]
-      });
-    }
-  }
-  for (const data of loadJsonEntries(join2(cacheDir, "@official", "patterns"))) {
-    if (typeof data.id === "string" && !patternRegistry.has(data.id)) {
-      patternRegistry.set(data.id, data);
-    }
-  }
-  for (const data of loadJsonEntries(join2(customDir, "patterns"))) {
-    if (typeof data.id === "string") {
-      patternRegistry.set(data.id, data);
-    }
-  }
-  return { themeRegistry, patternRegistry };
-}
-
-export {
-  scanProjectInteractions,
-  buildGuardRegistryContext
-};

package/dist/heal-EMT5LYVZ.js

@@ -1,175 +0,0 @@
-import {
-  buildGuardRegistryContext,
-  scanProjectInteractions
-} from "./chunk-QRQCPD3C.js";
-
-// src/commands/heal.ts
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
-import { join as join2 } from "path";
-import { evaluateGuard, validateEssence } from "@decantr/essence-spec";
-
-// src/telemetry.ts
-import { existsSync, readFileSync, writeFileSync } from "fs";
-import { join } from "path";
-var TELEMETRY_ENDPOINT = "https://api.decantr.ai/v1/telemetry/guard";
-var TELEMETRY_TIMEOUT_MS = 3e3;
-var DNA_RULES = /* @__PURE__ */ new Set(["theme", "style", "density", "accessibility", "theme-mode"]);
-async function sendGuardMetrics(metrics) {
-  try {
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), TELEMETRY_TIMEOUT_MS);
-    await fetch(TELEMETRY_ENDPOINT, {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(metrics),
-      signal: controller.signal
-    });
-    clearTimeout(timer);
-  } catch {
-  }
-}
-function isOptedIn(projectRoot) {
-  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
-  if (!existsSync(projectJsonPath)) return false;
-  try {
-    const data = JSON.parse(readFileSync(projectJsonPath, "utf-8"));
-    return data.telemetry === true;
-  } catch {
-    return false;
-  }
-}
-function optIn(projectRoot) {
-  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
-  let data = {};
-  if (existsSync(projectJsonPath)) {
-    try {
-      data = JSON.parse(readFileSync(projectJsonPath, "utf-8"));
-    } catch {
-    }
-  }
-  data.telemetry = true;
-  writeFileSync(projectJsonPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
-}
-function collectMetrics(essence, issues) {
-  const dna = essence.dna ?? {};
-  const blueprint = essence.blueprint ?? {};
-  const meta = essence.meta ?? {};
-  const guard = meta.guard ?? {};
-  const theme = dna.theme ?? {};
-  const sections = blueprint.sections ?? [];
-  const routes = blueprint.routes ?? {};
-  const byRule = {};
-  let dnaCount = 0;
-  let blueprintCount = 0;
-  for (const issue of issues) {
-    byRule[issue.rule] = (byRule[issue.rule] ?? 0) + 1;
-    if (DNA_RULES.has(issue.rule)) {
-      dnaCount++;
-    } else {
-      blueprintCount++;
-    }
-  }
-  return {
-    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-    cli_version: "1.5.1",
-    essence_version: essence.version ?? "unknown",
-    guard_mode: guard.mode ?? "unknown",
-    violations: {
-      dna: dnaCount,
-      blueprint: blueprintCount,
-      by_rule: byRule
-    },
-    resolution_rate: 0,
-    sections_count: sections.length,
-    routes_count: Object.keys(routes).length,
-    theme: theme.id ?? "unknown"
-  };
-}
-
-// src/commands/heal.ts
-var GREEN = "\x1B[32m";
-var RED = "\x1B[31m";
-var YELLOW = "\x1B[33m";
-var CYAN = "\x1B[36m";
-var RESET = "\x1B[0m";
-var DIM = "\x1B[2m";
-async function cmdHeal(projectRoot = process.cwd(), options = {}) {
-  const essencePath = join2(projectRoot, "decantr.essence.json");
-  if (!existsSync2(essencePath)) {
-    console.error("No decantr.essence.json found. Run `decantr init` first.");
-    process.exitCode = 1;
-    return;
-  }
-  const essence = JSON.parse(readFileSync2(essencePath, "utf-8"));
-  console.log("Scanning for issues...\n");
-  const issues = [];
-  const validation = validateEssence(essence);
-  if (!validation.valid) {
-    for (const err of validation.errors) {
-      issues.push({
-        type: "error",
-        rule: "schema",
-        message: err
-      });
-    }
-  }
-  let interactionIssues = [];
-  try {
-    interactionIssues = scanProjectInteractions(projectRoot);
-  } catch {
-  }
-  try {
-    const guardContext = buildGuardRegistryContext(projectRoot);
-    const violations = evaluateGuard(essence, {
-      ...guardContext,
-      interaction_issues: interactionIssues
-    });
-    for (const v of violations) {
-      issues.push({
-        type: v.severity === "error" ? "error" : "warning",
-        rule: v.rule,
-        message: v.message,
-        suggestion: v.suggestion
-      });
-    }
-  } catch {
-  }
-  if (issues.length === 0) {
-    console.log(`${GREEN}No issues found. Project is healthy.${RESET}`);
-    await maybeSendTelemetry(projectRoot, essence, issues, options);
-    return;
-  }
-  console.log(`Found ${issues.length} issue(s):
-`);
-  for (const issue of issues) {
-    const icon = issue.type === "error" ? `${RED}x${RESET}` : `${YELLOW}!${RESET}`;
-    console.log(`${icon} [${issue.rule}] ${issue.message}`);
-    if (issue.suggestion) {
-      console.log(`  ${DIM}Suggestion: ${issue.suggestion}${RESET}`);
-    }
-  }
-  console.log(`
-${YELLOW}Manual fixes required. Review the issues above.${RESET}`);
-  const hasError = issues.some((i) => i.type === "error");
-  if (hasError) {
-    process.exitCode = 1;
-  }
-  await maybeSendTelemetry(projectRoot, essence, issues, options);
-}
-async function maybeSendTelemetry(projectRoot, essence, issues, options) {
-  if (options.telemetry && !isOptedIn(projectRoot)) {
-    optIn(projectRoot);
-    console.log(
-      `
-${CYAN}Telemetry enabled.${RESET} Anonymous guard metrics will be sent on future checks.`
-    );
-    console.log(`${DIM}Set "telemetry": false in .decantr/project.json to opt out.${RESET}`);
-  }
-  if (isOptedIn(projectRoot)) {
-    const metrics = collectMetrics(essence, issues);
-    sendGuardMetrics(metrics);
-  }
-}
-export {
-  cmdHeal
-};