@decantr/cli 1.7.26 → 1.7.28

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Decantr AI
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin.js

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import "./chunk-RAAUNHXD.js";
-import "./chunk-3K6HWLD5.js";
-import "./chunk-QRQCPD3C.js";
+import "./chunk-56VBV4MT.js";
+import "./chunk-GCDFX7UE.js";
+import "./chunk-RRRHQ45P.js";

package/dist/{chunk-RAAUNHXD.js → chunk-56VBV4MT.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-RRRHQ45P.js";
 
 // src/index.ts
 import { existsSync as existsSync27, mkdirSync as mkdirSync11, readdirSync as readdirSync7, readFileSync as readFileSync20, writeFileSync as writeFileSync14 } from "fs";
@@ -6674,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;
@@ -6686,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-SWUFIYU5.js");
       const telemetryFlag = args.includes("--telemetry");
       await cmdHeal(process.cwd(), { telemetry: telemetryFlag });
       break;
@@ -7172,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-RRRHQ45P.js

@@ -0,0 +1,397 @@
+// 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,
+  isTelemetryActorType
+} 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",
+      actorType: getTelemetryActorType(),
+      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 getTelemetryActorType() {
+  const configured = process.env.DECANTR_TELEMETRY_ACTOR_TYPE;
+  return isTelemetryActorType(configured) ? configured : "customer";
+}
+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-SWUFIYU5.js

@@ -0,0 +1,99 @@
+import {
+  buildGuardRegistryContext,
+  collectMetrics,
+  isOptedIn,
+  optIn,
+  scanProjectInteractions,
+  sendGuardMetrics
+} from "./chunk-RRRHQ45P.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-RAAUNHXD.js";
-import "./chunk-3K6HWLD5.js";
-import "./chunk-QRQCPD3C.js";
+import "./chunk-56VBV4MT.js";
+import "./chunk-GCDFX7UE.js";
+import "./chunk-RRRHQ45P.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.26",
+  "version": "1.7.28",
   "description": "Decantr CLI — scaffold, audit, and maintain Decantr projects from the terminal",
   "author": "Decantr AI",
   "license": "MIT",
@@ -29,19 +29,19 @@
   "publishConfig": {
     "access": "public"
   },
+  "dependencies": {
+    "@decantr/core": "1.0.6",
+    "@decantr/registry": "1.0.4",
+    "@decantr/verifier": "1.0.6",
+    "@decantr/telemetry": "0.1.2",
+    "@decantr/essence-spec": "1.0.6"
+  },
   "scripts": {
     "build": "tsup",
     "certify:blueprints": "pnpm build && node scripts/certify-blueprints.mjs",
     "certify:workflows": "pnpm build && node scripts/certify-workflows.mjs",
     "test": "vitest run",
     "test:watch": "vitest",
-    "prepublishOnly": "pnpm build",
     "preversion": "pnpm build && pnpm test"
-  },
-  "dependencies": {
-    "@decantr/core": "workspace:*",
-    "@decantr/essence-spec": "workspace:*",
-    "@decantr/registry": "workspace:*",
-    "@decantr/verifier": "workspace:*"
   }
-}
+}

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
-};