@decantr/cli 1.11.0 → 2.1.0

package/dist/{chunk-DI2PLOJ6.js → chunk-ZUUJ24YU.js}

@@ -1,139 +1,8 @@
-// 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 walk2(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()) {
-        walk2(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 {
-        }
-      }
-    }
-  }
-  walk2(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 { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
-import { dirname, join as join3 } from "path";
+import { dirname, join, resolve } from "path";
 import { fileURLToPath } from "url";
 import {
   createFetchTelemetrySink,
@@ -159,21 +28,21 @@ async function sendGuardMetrics(metrics) {
   }
 }
 function isOptedIn(projectRoot) {
-  const projectJsonPath = join3(projectRoot, ".decantr", "project.json");
-  if (!existsSync3(projectJsonPath)) return false;
+  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
+  if (!existsSync(projectJsonPath)) return false;
   try {
-    const data = JSON.parse(readFileSync3(projectJsonPath, "utf-8"));
+    const data = JSON.parse(readFileSync(projectJsonPath, "utf-8"));
     return data.telemetry === true;
   } catch {
     return false;
   }
 }
 function optIn(projectRoot) {
-  const projectJsonPath = join3(projectRoot, ".decantr", "project.json");
+  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
   let data = {};
-  if (existsSync3(projectJsonPath)) {
+  if (existsSync(projectJsonPath)) {
     try {
-      data = JSON.parse(readFileSync3(projectJsonPath, "utf-8"));
+      data = JSON.parse(readFileSync(projectJsonPath, "utf-8"));
     } catch {
     }
   }
@@ -181,16 +50,19 @@ function optIn(projectRoot) {
   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") {
+async function captureCliTelemetryEvent(input) {
+  const projectRoot = resolveCliTelemetryProjectRoot(
+    input.projectRoot ?? process.cwd(),
+    input.args ?? []
+  );
+  if (!isOptedIn(projectRoot)) {
     return;
   }
   const identities = ensureTelemetryIdentities(projectRoot);
   if (!identities) {
     return;
   }
+  const registrySource = input.registrySource ?? getRegistrySourceProperty(input.properties) ?? inferRegistrySource(input.args ?? []);
   const client = createTelemetryClient({
     sink: createFetchTelemetrySink({
       endpoint: getTelemetryEventsEndpoint(),
@@ -198,7 +70,7 @@ async function sendCliCommandTelemetry(input) {
     })
   });
   const event = {
-    name: "cli.command.completed",
+    name: input.name,
     context: {
       source: "cli",
       actorType: getTelemetryActorType(),
@@ -206,26 +78,196 @@ async function sendCliCommandTelemetry(input) {
       decantrVersion: getCliVersion(),
       installId: identities.installId,
       projectId: identities.projectId,
-      registrySource: inferRegistrySource(input.args)
+      registrySource
     },
-    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)
-    }
+    properties: input.properties
   };
   try {
     await client.capture(event);
   } catch {
   }
 }
+async function sendCliCommandTelemetry(input) {
+  const projectRoot = resolveCliTelemetryProjectRoot(input.projectRoot ?? process.cwd(), input.args);
+  const command = normalizeCommand(input.args[0]);
+  if (!isOptedIn(projectRoot) || !command || command === "help" || command === "version") {
+    return;
+  }
+  const properties = buildCliLifecycleProperties({
+    args: input.args,
+    command,
+    durationMs: input.durationMs,
+    projectRoot,
+    success: input.success
+  });
+  await captureCliTelemetryEvent({
+    args: input.args,
+    name: "cli.command.completed",
+    projectRoot,
+    properties,
+    registrySource: properties.registrySource
+  });
+  const lifecycleEventName = lifecycleTelemetryEventName(command);
+  if (lifecycleEventName) {
+    await captureCliTelemetryEvent({
+      args: input.args,
+      name: lifecycleEventName,
+      projectRoot,
+      properties,
+      registrySource: properties.registrySource
+    });
+  }
+}
+async function sendProjectHealthReportTelemetry(input) {
+  const projectRoot = input.projectRoot ?? process.cwd();
+  const properties = buildProjectHealthTelemetryProperties(input, projectRoot);
+  await captureCliTelemetryEvent({
+    name: "health.report.generated",
+    projectRoot,
+    properties
+  });
+  if (input.report.status === "healthy") {
+    await captureCliTelemetryEvent({
+      name: "decantr.health.healthy",
+      projectRoot,
+      properties
+    });
+  }
+}
+async function sendNewProjectCompletedTelemetry(input) {
+  const projectRoot = input.projectRoot ?? process.cwd();
+  const args = input.args ?? ["new"];
+  const base = buildCliLifecycleProperties({
+    args,
+    command: "new",
+    durationMs: input.durationMs,
+    projectRoot,
+    success: input.success
+  });
+  const properties = {
+    ...base,
+    command: "new"
+  };
+  await captureCliTelemetryEvent({
+    args,
+    name: "decantr.new.completed",
+    projectRoot,
+    properties,
+    registrySource: properties.registrySource
+  });
+}
+async function sendProjectHealthPromptTelemetry(input) {
+  const projectRoot = input.projectRoot ?? process.cwd();
+  const finding = input.finding;
+  const properties = {
+    success: Boolean(finding),
+    findingFound: Boolean(finding),
+    adoptionMode: normalizeAdoptionMode(input.report.summary.adoptionMode),
+    ci: input.ci ?? false,
+    findingSeverity: normalizeFindingSeverity(finding?.severity),
+    findingSource: normalizeFindingSource(finding?.source),
+    projectScope: inferProjectScope(projectRoot),
+    workflowMode: normalizeWorkflowMode(input.report.summary.workflowMode)
+  };
+  await captureCliTelemetryEvent({
+    name: "health.finding.prompt_requested",
+    projectRoot,
+    properties
+  });
+}
+async function sendProjectHealthCiFailedTelemetry(input) {
+  const projectRoot = input.projectRoot ?? process.cwd();
+  const properties = {
+    ...buildProjectHealthTelemetryProperties(input, projectRoot),
+    errorCode: "project_health_ci_failed",
+    failOn: input.failOn,
+    success: false
+  };
+  await captureCliTelemetryEvent({
+    name: "health.ci.failed",
+    projectRoot,
+    properties
+  });
+}
+async function sendStudioStartedTelemetry(input) {
+  const projectRoot = input.projectRoot ?? process.cwd();
+  const metadata = readProjectTelemetryMetadata(projectRoot);
+  const properties = {
+    success: true,
+    hostMode: isLoopbackHost(input.host) ? "loopback" : "custom",
+    port: input.port,
+    adoptionMode: metadata.adoptionMode,
+    projectScope: inferProjectScope(projectRoot),
+    workflowMode: metadata.workflowMode
+  };
+  await captureCliTelemetryEvent({
+    name: "studio.started",
+    projectRoot,
+    properties
+  });
+}
+async function sendStudioHealthRefreshedTelemetry(input) {
+  const projectRoot = input.projectRoot ?? process.cwd();
+  const properties = {
+    ...buildProjectHealthTelemetryProperties(input, projectRoot),
+    trigger: input.trigger ?? "api-refresh"
+  };
+  await captureCliTelemetryEvent({
+    name: "studio.health_refreshed",
+    projectRoot,
+    properties
+  });
+}
+function buildCliLifecycleProperties(input) {
+  const metadata = readProjectTelemetryMetadata(input.projectRoot);
+  const registrySource = inferRegistrySource(input.args);
+  return {
+    command: input.command,
+    success: input.success,
+    durationMs: input.durationMs,
+    adoptionMode: inferAdoptionMode(input.args) ?? metadata.adoptionMode,
+    errorCode: input.success ? void 0 : "cli_command_failed",
+    offline: input.args.includes("--offline"),
+    projectScope: metadata.projectScope ?? inferProjectScope(input.projectRoot),
+    registrySource,
+    targetFramework: inferFlagValue(input.args, "--target"),
+    workflowMode: inferWorkflowMode(input.args) ?? metadata.workflowMode
+  };
+}
+function lifecycleTelemetryEventName(command) {
+  if (command === "check") return "decantr.check.completed";
+  if (command === "init") return "decantr.init.completed";
+  if (command === "refresh") return "decantr.refresh.completed";
+  return null;
+}
+function buildProjectHealthTelemetryProperties(input, projectRoot) {
+  const { report } = input;
+  return {
+    success: true,
+    status: report.status,
+    score: report.score,
+    durationMs: input.durationMs,
+    adoptionMode: normalizeAdoptionMode(report.summary.adoptionMode),
+    ci: input.ci ?? false,
+    errorCount: report.summary.errorCount,
+    failOn: input.failOn,
+    findingCount: report.summary.findingCount,
+    format: input.format,
+    infoCount: report.summary.infoCount,
+    outputWritten: input.outputWritten ?? false,
+    packManifestPresent: report.summary.packManifestPresent,
+    pageCount: report.summary.pageCount,
+    projectScope: inferProjectScope(projectRoot),
+    reviewPackPresent: report.summary.reviewPackPresent,
+    routeCount: report.routes.declared.length,
+    runtimeAuditChecked: report.summary.runtimeAuditChecked,
+    runtimeMatchedCount: report.routes.runtimeMatched,
+    runtimePassed: report.summary.runtimePassed,
+    runtimeRouteCheckedCount: report.routes.runtimeChecked.length,
+    warnCount: report.summary.warnCount,
+    workflowMode: normalizeWorkflowMode(report.summary.workflowMode)
+  };
+}
 function collectMetrics(essence, issues) {
   const dna = essence.dna ?? {};
   const blueprint = essence.blueprint ?? {};
@@ -263,12 +305,12 @@ function collectMetrics(essence, issues) {
 }
 function ensureTelemetryIdentities(projectRoot) {
   const installId = getOrCreateInstallId();
-  const projectJsonPath = join3(projectRoot, ".decantr", "project.json");
-  if (!existsSync3(projectJsonPath)) {
+  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
+  if (!existsSync(projectJsonPath)) {
     return null;
   }
   try {
-    const data = JSON.parse(readFileSync3(projectJsonPath, "utf-8"));
+    const data = JSON.parse(readFileSync(projectJsonPath, "utf-8"));
     let projectId = typeof data.telemetryProjectId === "string" ? data.telemetryProjectId : void 0;
     if (!projectId) {
       projectId = `project_${randomUUID()}`;
@@ -282,10 +324,10 @@ function ensureTelemetryIdentities(projectRoot) {
 }
 function getOrCreateInstallId() {
   const configDir = getConfigDir();
-  const configPath = join3(configDir, "config.json");
+  const configPath = join(configDir, "config.json");
   try {
-    if (existsSync3(configPath)) {
-      const data = JSON.parse(readFileSync3(configPath, "utf-8"));
+    if (existsSync(configPath)) {
+      const data = JSON.parse(readFileSync(configPath, "utf-8"));
       if (typeof data.telemetryInstallId === "string") {
         return data.telemetryInstallId;
       }
@@ -307,7 +349,7 @@ function getOrCreateInstallId() {
   }
 }
 function getConfigDir() {
-  return process.env.DECANTR_CONFIG_DIR || join3(homedir(), ".config", "decantr");
+  return process.env.DECANTR_CONFIG_DIR || join(homedir(), ".config", "decantr");
 }
 function getTelemetryEventsEndpoint() {
   return process.env.DECANTR_TELEMETRY_ENDPOINT || DEFAULT_TELEMETRY_EVENTS_ENDPOINT;
@@ -316,6 +358,37 @@ function getTelemetryActorType() {
   const configured = process.env.DECANTR_TELEMETRY_ACTOR_TYPE;
   return isTelemetryActorType(configured) ? configured : "customer";
 }
+function getRegistrySourceProperty(properties) {
+  const value = properties.registrySource;
+  return isRegistrySource(value) ? value : void 0;
+}
+function readProjectTelemetryMetadata(projectRoot) {
+  const data = readProjectJson(projectRoot);
+  const initialized = isRecord(data?.initialized) ? data.initialized : void 0;
+  return {
+    adoptionMode: normalizeAdoptionMode(initialized?.adoptionMode),
+    projectScope: normalizeProjectScope(initialized?.projectScope),
+    workflowMode: normalizeWorkflowMode(initialized?.workflowMode)
+  };
+}
+function resolveCliTelemetryProjectRoot(projectRoot, args) {
+  const projectFlag = inferFlagValue(args, "--project");
+  if (!projectFlag) return projectRoot;
+  const candidate = resolve(projectRoot, projectFlag);
+  return existsSync(join(candidate, ".decantr", "project.json")) ? candidate : projectRoot;
+}
+function readProjectJson(projectRoot) {
+  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
+  if (!existsSync(projectJsonPath)) return null;
+  try {
+    return JSON.parse(readFileSync(projectJsonPath, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
 function normalizeCommand(command) {
   if (!command) return null;
   if (command === "--help" || command === "-h") return "help";
@@ -336,13 +409,19 @@ function inferFlagValue(args, flag) {
 }
 function inferAdoptionMode(args) {
   const value = inferFlagValue(args, "--adoption");
+  return normalizeAdoptionMode(value);
+}
+function inferWorkflowMode(args) {
+  const value = inferFlagValue(args, "--workflow");
+  return normalizeWorkflowMode(value);
+}
+function normalizeAdoptionMode(value) {
   if (value === "contract-only" || value === "decantr-css" || value === "style-bridge") {
     return value;
   }
   return void 0;
 }
-function inferWorkflowMode(args) {
-  const value = inferFlagValue(args, "--workflow");
+function normalizeWorkflowMode(value) {
   if (value === "greenfield" || value === "greenfield-scaffold") {
     return "greenfield-scaffold";
   }
@@ -357,6 +436,20 @@ function inferWorkflowMode(args) {
   }
   return void 0;
 }
+function normalizeProjectScope(value) {
+  if (value === "single-app" || value === "workspace-app") return value;
+  return void 0;
+}
+function normalizeFindingSeverity(value) {
+  if (value === "error" || value === "info" || value === "warn") return value;
+  return void 0;
+}
+function normalizeFindingSource(value) {
+  if (value === "audit" || value === "brownfield" || value === "check" || value === "interaction" || value === "pack" || value === "runtime") {
+    return value;
+  }
+  return void 0;
+}
 function inferRegistrySource(args) {
   if (args.includes("--offline")) {
     return "cache";
@@ -366,16 +459,19 @@ function inferRegistrySource(args) {
   }
   return "official";
 }
+function isRegistrySource(value) {
+  return value === "cache" || value === "custom" || value === "none" || value === "official" || value === "private";
+}
 function inferProjectScope(projectRoot) {
-  return existsSync3(join3(projectRoot, "pnpm-workspace.yaml")) || existsSync3(join3(projectRoot, "turbo.json")) || existsSync3(join3(projectRoot, "lerna.json")) ? "workspace-app" : "single-app";
+  return existsSync(join(projectRoot, "pnpm-workspace.yaml")) || existsSync(join(projectRoot, "turbo.json")) || existsSync(join(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")];
+    const candidates = [join(here, "..", "package.json"), join(here, "..", "..", "package.json")];
     for (const candidate of candidates) {
-      if (existsSync3(candidate)) {
-        const pkg = JSON.parse(readFileSync3(candidate, "utf-8"));
+      if (existsSync(candidate)) {
+        const pkg = JSON.parse(readFileSync(candidate, "utf-8"));
         if (pkg.version) {
           return pkg.version;
         }
@@ -385,6 +481,140 @@ function getCliVersion() {
   }
   return "unknown";
 }
+function isLoopbackHost(host) {
+  return host === "127.0.0.1" || host === "localhost" || host === "::1";
+}
+
+// src/guard-context.ts
+import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2 } from "fs";
+import { join as join2 } from "path";
+function loadJsonEntries(dir) {
+  if (!existsSync2(dir)) return [];
+  try {
+    return readdirSync(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/lib/scan-interactions.ts
+import { existsSync as existsSync3, readdirSync as readdirSync2, readFileSync as readFileSync3, statSync } from "fs";
+import { extname, join as join3 } 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 walk2(dir) {
+    let entries;
+    try {
+      entries = readdirSync2(dir);
+    } catch {
+      return;
+    }
+    for (const entry of entries) {
+      if (SKIP_DIRECTORIES.has(entry)) continue;
+      const fullPath = join3(dir, entry);
+      let s;
+      try {
+        s = statSync(fullPath);
+      } catch {
+        continue;
+      }
+      if (s.isDirectory()) {
+        walk2(fullPath);
+      } else if (s.isFile() && SCAN_EXTENSIONS.has(extname(entry))) {
+        if (s.size > MAX_FILE_SIZE) continue;
+        try {
+          sources.set(fullPath, readFileSync3(fullPath, "utf8"));
+        } catch {
+        }
+      }
+    }
+  }
+  walk2(rootDir);
+  return sources;
+}
+function collectDeclaredInteractions(projectRoot) {
+  const manifestPath = join3(projectRoot, ".decantr", "context", "pack-manifest.json");
+  if (!existsSync3(manifestPath)) return [];
+  let manifest;
+  try {
+    manifest = JSON.parse(readFileSync3(manifestPath, "utf8"));
+  } catch {
+    return [];
+  }
+  const all = [];
+  const pages = manifest.pages ?? [];
+  const contextDir = join3(projectRoot, ".decantr", "context");
+  for (const page of pages) {
+    const packPath = join3(contextDir, page.json);
+    if (!existsSync3(packPath)) continue;
+    let pack;
+    try {
+      pack = JSON.parse(readFileSync3(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/analyzers/routes.ts
 import { existsSync as existsSync4, readdirSync as readdirSync3, readFileSync as readFileSync4, statSync as statSync2 } from "fs";
@@ -1158,7 +1388,9 @@ function readSmallText(projectRoot, relPath) {
   }
 }
 function detectConflicts(projectRoot, items) {
-  const text = items.filter((item) => item.type === "file" && item.safeToCite && item.path.match(/\.(md|mdx|json|ts|js|yml|yaml)$/)).slice(0, 80).map((item) => readSmallText(projectRoot, item.path)).join("\n").toLowerCase();
+  const text = items.filter(
+    (item) => item.type === "file" && item.safeToCite && item.path.match(/\.(md|mdx|json|ts|js|yml|yaml)$/)
+  ).slice(0, 80).map((item) => readSmallText(projectRoot, item.path)).join("\n").toLowerCase();
   const conflicts = [];
   const frameworkSignals = [
     ["next", /\bnext\.?js\b|\bapp router\b|\bpages router\b/],
@@ -1172,9 +1404,7 @@ function detectConflicts(projectRoot, items) {
     );
   }
   const forbidsTailwind = /\b(do not|don't|avoid|forbid|forbidden)\s+use\s+tailwind\b|\bno\s+tailwind\b/.test(text);
-  const endorsesTailwind = /\btailwind\.config\b|\btailwindcss\b|\b@tailwind\b|\btailwind\s+classes\b/.test(
-    text
-  );
+  const endorsesTailwind = /\btailwind\.config\b|\btailwindcss\b|\b@tailwind\b|\btailwind\s+classes\b/.test(text);
   if (forbidsTailwind && endorsesTailwind) {
     conflicts.push("Ambient docs contain both Tailwind usage and anti-Tailwind language.");
   }
@@ -1190,9 +1420,9 @@ function detectDecantrEssenceStaleRisk(projectRoot, items) {
   try {
     const essence = JSON.parse(content);
     const risks = [];
-    if (essence.version !== "3.1.0") {
+    if (essence.version !== "4.0.0") {
       risks.push(
-        `decantr.essence.json uses Decantr essence version ${essence.version ?? "unknown"}; migrate or review before treating it as current brownfield doctrine.`
+        `decantr.essence.json uses Decantr essence version ${essence.version ?? "unknown"}; run decantr migrate --to v4 or review before treating it as current brownfield doctrine.`
       );
     }
     if (essence.dna?.theme?.id === "luminarum" && essence.structure) {
@@ -1210,7 +1440,9 @@ function detectDecantrEssenceStaleRisk(projectRoot, items) {
 function detectStaleRisks(projectRoot, items) {
   const pathRisks = items.filter(
     (item) => item.role === "stale-or-historical" || /complete|summary|legacy|deprecated/i.test(item.path)
-  ).slice(0, 12).map((item) => `${item.path} may be historical; verify before treating it as current doctrine.`);
+  ).slice(0, 12).map(
+    (item) => `${item.path} may be historical; verify before treating it as current doctrine.`
+  );
   return [...pathRisks, ...detectDecantrEssenceStaleRisk(projectRoot, items)];
 }
 function scanAmbientContext(projectRoot) {
@@ -1402,17 +1634,23 @@ function readDoctrineMap(projectRoot) {
 }
 
 export {
-  scanProjectInteractions,
   scanRoutes,
   scanStyling,
   scanAmbientContext,
   createDoctrineMap,
   writeDoctrineMap,
   readDoctrineMap,
-  buildGuardRegistryContext,
   sendGuardMetrics,
   isOptedIn,
   optIn,
   sendCliCommandTelemetry,
-  collectMetrics
+  sendProjectHealthReportTelemetry,
+  sendNewProjectCompletedTelemetry,
+  sendProjectHealthPromptTelemetry,
+  sendProjectHealthCiFailedTelemetry,
+  sendStudioStartedTelemetry,
+  sendStudioHealthRefreshedTelemetry,
+  collectMetrics,
+  buildGuardRegistryContext,
+  scanProjectInteractions
 };