@decantr/cli 2.5.0 → 2.6.0

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

@@ -1,9 +1,58 @@
+// src/bundled-content.ts
+import { existsSync, readdirSync, readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+function bundledDirCandidates(contentType) {
+  const currentDir = dirname(fileURLToPath(import.meta.url));
+  return [
+    join(currentDir, "bundled", contentType),
+    join(currentDir, "..", "src", "bundled", contentType),
+    join(currentDir, "..", "bundled", contentType)
+  ];
+}
+function getBundledContentPath(contentType, id) {
+  for (const dir of bundledDirCandidates(contentType)) {
+    const candidate = join(dir, `${id}.json`);
+    if (existsSync(candidate)) return candidate;
+  }
+  return null;
+}
+function loadBundledContentItem(contentType, id) {
+  const path = getBundledContentPath(contentType, id);
+  if (!path) return null;
+  try {
+    const data = JSON.parse(readFileSync(path, "utf-8"));
+    return { id, data, path };
+  } catch {
+    return null;
+  }
+}
+function loadBundledContentList(contentType) {
+  const entries = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const dir of bundledDirCandidates(contentType)) {
+    if (!existsSync(dir)) continue;
+    try {
+      for (const file of readdirSync(dir).filter((name) => name.endsWith(".json"))) {
+        const id = file.replace(/\.json$/, "");
+        if (seen.has(id)) continue;
+        const path = join(dir, file);
+        const data = JSON.parse(readFileSync(path, "utf-8"));
+        entries.push({ id, data, path });
+        seen.add(id);
+      }
+    } catch {
+    }
+  }
+  return entries;
+}
+
 // src/telemetry.ts
 import { randomUUID } from "crypto";
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { existsSync as existsSync2, mkdirSync, readFileSync as readFileSync2, writeFileSync } from "fs";
 import { homedir } from "os";
-import { dirname, join, resolve } from "path";
-import { fileURLToPath } from "url";
+import { dirname as dirname2, join as join2, resolve } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 import {
   createFetchTelemetrySink,
   createTelemetryClient,
@@ -28,26 +77,26 @@ async function sendGuardMetrics(metrics) {
   }
 }
 function isOptedIn(projectRoot) {
-  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
-  if (!existsSync(projectJsonPath)) return false;
+  const projectJsonPath = join2(projectRoot, ".decantr", "project.json");
+  if (!existsSync2(projectJsonPath)) return false;
   try {
-    const data = JSON.parse(readFileSync(projectJsonPath, "utf-8"));
+    const data = JSON.parse(readFileSync2(projectJsonPath, "utf-8"));
     return data.telemetry === true;
   } catch {
     return false;
   }
 }
 function optIn(projectRoot) {
-  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
+  const projectJsonPath = join2(projectRoot, ".decantr", "project.json");
   let data = {};
-  if (existsSync(projectJsonPath)) {
+  if (existsSync2(projectJsonPath)) {
     try {
-      data = JSON.parse(readFileSync(projectJsonPath, "utf-8"));
+      data = JSON.parse(readFileSync2(projectJsonPath, "utf-8"));
     } catch {
     }
   }
   data.telemetry = true;
-  mkdirSync(dirname(projectJsonPath), { recursive: true });
+  mkdirSync(dirname2(projectJsonPath), { recursive: true });
   writeFileSync(projectJsonPath, JSON.stringify(data, null, 2) + "\n", "utf-8");
 }
 async function captureCliTelemetryEvent(input) {
@@ -328,8 +377,8 @@ function collectMetrics(essence, issues) {
   };
 }
 function getCliTelemetryIdentityStatus(projectRoot, options = {}) {
-  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
-  const hasProjectConfig = existsSync(projectJsonPath);
+  const projectJsonPath = join2(projectRoot, ".decantr", "project.json");
+  const hasProjectConfig = existsSync2(projectJsonPath);
   const identities = options.create ? ensureTelemetryIdentities(projectRoot) : null;
   const projectData = readProjectJson(projectRoot);
   return {
@@ -342,12 +391,12 @@ function getCliTelemetryIdentityStatus(projectRoot, options = {}) {
 }
 function ensureTelemetryIdentities(projectRoot) {
   const installId = getOrCreateInstallId();
-  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
-  if (!existsSync(projectJsonPath)) {
+  const projectJsonPath = join2(projectRoot, ".decantr", "project.json");
+  if (!existsSync2(projectJsonPath)) {
     return null;
   }
   try {
-    const data = JSON.parse(readFileSync(projectJsonPath, "utf-8"));
+    const data = JSON.parse(readFileSync2(projectJsonPath, "utf-8"));
     let projectId = typeof data.telemetryProjectId === "string" ? data.telemetryProjectId : void 0;
     if (!projectId) {
       projectId = `project_${randomUUID()}`;
@@ -361,10 +410,10 @@ function ensureTelemetryIdentities(projectRoot) {
 }
 function getOrCreateInstallId() {
   const configDir = getConfigDir();
-  const configPath = join(configDir, "config.json");
+  const configPath = join2(configDir, "config.json");
   try {
-    if (existsSync(configPath)) {
-      const data = JSON.parse(readFileSync(configPath, "utf-8"));
+    if (existsSync2(configPath)) {
+      const data = JSON.parse(readFileSync2(configPath, "utf-8"));
       if (typeof data.telemetryInstallId === "string") {
         return data.telemetryInstallId;
       }
@@ -386,17 +435,17 @@ function getOrCreateInstallId() {
   }
 }
 function readExistingInstallId() {
-  const configPath = join(getConfigDir(), "config.json");
-  if (!existsSync(configPath)) return void 0;
+  const configPath = join2(getConfigDir(), "config.json");
+  if (!existsSync2(configPath)) return void 0;
   try {
-    const data = JSON.parse(readFileSync(configPath, "utf-8"));
+    const data = JSON.parse(readFileSync2(configPath, "utf-8"));
     return readStringProperty(data, "telemetryInstallId");
   } catch {
     return void 0;
   }
 }
 function getConfigDir() {
-  return process.env.DECANTR_CONFIG_DIR || join(homedir(), ".config", "decantr");
+  return process.env.DECANTR_CONFIG_DIR || join2(homedir(), ".config", "decantr");
 }
 function getTelemetryEventsEndpoint() {
   return process.env.DECANTR_TELEMETRY_ENDPOINT || DEFAULT_TELEMETRY_EVENTS_ENDPOINT;
@@ -422,13 +471,13 @@ 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;
+  return existsSync2(join2(candidate, ".decantr", "project.json")) ? candidate : projectRoot;
 }
 function readProjectJson(projectRoot) {
-  const projectJsonPath = join(projectRoot, ".decantr", "project.json");
-  if (!existsSync(projectJsonPath)) return null;
+  const projectJsonPath = join2(projectRoot, ".decantr", "project.json");
+  if (!existsSync2(projectJsonPath)) return null;
   try {
-    return JSON.parse(readFileSync(projectJsonPath, "utf-8"));
+    return JSON.parse(readFileSync2(projectJsonPath, "utf-8"));
   } catch {
     return null;
   }
@@ -519,15 +568,15 @@ function isRegistrySource(value) {
   return value === "cache" || value === "custom" || value === "none" || value === "official" || value === "private";
 }
 function inferProjectScope(projectRoot) {
-  return existsSync(join(projectRoot, "pnpm-workspace.yaml")) || existsSync(join(projectRoot, "turbo.json")) || existsSync(join(projectRoot, "lerna.json")) ? "workspace-app" : "single-app";
+  return existsSync2(join2(projectRoot, "pnpm-workspace.yaml")) || existsSync2(join2(projectRoot, "turbo.json")) || existsSync2(join2(projectRoot, "lerna.json")) ? "workspace-app" : "single-app";
 }
 function getCliVersion() {
   try {
-    const here = dirname(fileURLToPath(import.meta.url));
-    const candidates = [join(here, "..", "package.json"), join(here, "..", "..", "package.json")];
+    const here = dirname2(fileURLToPath2(import.meta.url));
+    const candidates = [join2(here, "..", "package.json"), join2(here, "..", "..", "package.json")];
     for (const candidate of candidates) {
-      if (existsSync(candidate)) {
-        const pkg = JSON.parse(readFileSync(candidate, "utf-8"));
+      if (existsSync2(candidate)) {
+        const pkg = JSON.parse(readFileSync2(candidate, "utf-8"));
         if (pkg.version) {
           return pkg.version;
         }
@@ -542,12 +591,12 @@ function isLoopbackHost(host) {
 }
 
 // src/guard-context.ts
-import { existsSync as existsSync2, readdirSync, readFileSync as readFileSync2 } from "fs";
-import { join as join2 } from "path";
+import { existsSync as existsSync3, readdirSync as readdirSync2, readFileSync as readFileSync3 } from "fs";
+import { join as join3 } from "path";
 function loadJsonEntries(dir) {
-  if (!existsSync2(dir)) return [];
+  if (!existsSync3(dir)) return [];
   try {
-    return readdirSync(dir).filter((file) => file.endsWith(".json") && file !== "index.json").map((file) => JSON.parse(readFileSync2(join2(dir, file), "utf-8")));
+    return readdirSync2(dir).filter((file) => file.endsWith(".json") && file !== "index.json").map((file) => JSON.parse(readFileSync3(join3(dir, file), "utf-8")));
   } catch {
     return [];
   }
@@ -555,28 +604,35 @@ function loadJsonEntries(dir) {
 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"))) {
+  const cacheDir = join3(projectRoot, ".decantr", "cache");
+  const customDir = join3(projectRoot, ".decantr", "custom");
+  for (const data of loadJsonEntries(join3(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"))) {
+  for (const data of loadJsonEntries(join3(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"))) {
+  for (const data of loadJsonEntries(join3(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"))) {
+  for (const entry of loadBundledContentList("patterns")) {
+    const data = entry.data;
+    const id = typeof data.id === "string" ? data.id : entry.id;
+    if (!patternRegistry.has(id)) {
+      patternRegistry.set(id, data);
+    }
+  }
+  for (const data of loadJsonEntries(join3(customDir, "patterns"))) {
     if (typeof data.id === "string") {
       patternRegistry.set(data.id, data);
     }
@@ -585,8 +641,8 @@ function buildGuardRegistryContext(projectRoot = process.cwd()) {
 }
 
 // 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 { existsSync as existsSync4, readdirSync as readdirSync3, readFileSync as readFileSync4, statSync } from "fs";
+import { extname, join as join4, relative } 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([
@@ -606,13 +662,13 @@ function walkSourceTree(rootDir) {
   function walk2(dir) {
     let entries;
     try {
-      entries = readdirSync2(dir);
+      entries = readdirSync3(dir);
     } catch {
       return;
     }
     for (const entry of entries) {
       if (SKIP_DIRECTORIES.has(entry)) continue;
-      const fullPath = join3(dir, entry);
+      const fullPath = join4(dir, entry);
       let s;
       try {
         s = statSync(fullPath);
@@ -624,7 +680,7 @@ function walkSourceTree(rootDir) {
       } else if (s.isFile() && SCAN_EXTENSIONS.has(extname(entry))) {
         if (s.size > MAX_FILE_SIZE) continue;
         try {
-          sources.set(fullPath, readFileSync3(fullPath, "utf8"));
+          sources.set(relative(rootDir, fullPath) || entry, readFileSync4(fullPath, "utf8"));
         } catch {
         }
       }
@@ -634,23 +690,23 @@ function walkSourceTree(rootDir) {
   return sources;
 }
 function collectDeclaredInteractions(projectRoot) {
-  const manifestPath = join3(projectRoot, ".decantr", "context", "pack-manifest.json");
-  if (!existsSync3(manifestPath)) return [];
+  const manifestPath = join4(projectRoot, ".decantr", "context", "pack-manifest.json");
+  if (!existsSync4(manifestPath)) return [];
   let manifest;
   try {
-    manifest = JSON.parse(readFileSync3(manifestPath, "utf8"));
+    manifest = JSON.parse(readFileSync4(manifestPath, "utf8"));
   } catch {
     return [];
   }
   const all = [];
   const pages = manifest.pages ?? [];
-  const contextDir = join3(projectRoot, ".decantr", "context");
+  const contextDir = join4(projectRoot, ".decantr", "context");
   for (const page of pages) {
-    const packPath = join3(contextDir, page.json);
-    if (!existsSync3(packPath)) continue;
+    const packPath = join4(contextDir, page.json);
+    if (!existsSync4(packPath)) continue;
     let pack;
     try {
-      pack = JSON.parse(readFileSync3(packPath, "utf8"));
+      pack = JSON.parse(readFileSync4(packPath, "utf8"));
     } catch {
       continue;
     }
@@ -669,82 +725,410 @@ function scanProjectInteractions(projectRoot) {
   const sources = walkSourceTree(projectRoot);
   if (sources.size === 0) return [];
   const missing = verifyInteractionsInSource(declared, sources);
-  return missing.map(({ interaction, suggestion }) => `${interaction} \u2192 ${suggestion}`);
+  return missing.map(
+    ({ interaction, suggestion, scannedFiles, scannedLocations, expectedSignals }) => {
+      const evidence = [
+        scannedFiles ? `scanned ${scannedFiles} source file(s)` : null,
+        scannedLocations?.length ? `checked: ${scannedLocations.slice(0, 4).map((location) => `${location.file}:${location.startLine}-${location.endLine}`).join(", ")}` : null,
+        expectedSignals?.length ? `expected signals: ${expectedSignals.slice(0, 4).join(", ")}` : null
+      ].filter((entry) => Boolean(entry)).join("; ");
+      return `${interaction} \u2192 ${suggestion}${evidence ? ` (${evidence})` : ""}`;
+    }
+  );
 }
 
-// src/analyzers/routes.ts
-import { existsSync as existsSync4, readdirSync as readdirSync3, readFileSync as readFileSync4, statSync as statSync2 } from "fs";
-import { join as join4, relative } from "path";
-var SKIP_DIRS = /* @__PURE__ */ new Set(["node_modules", ".next", ".git", "api", "_app", "_document"]);
+// src/ambient-context.ts
+import { existsSync as existsSync5, readdirSync as readdirSync4, readFileSync as readFileSync5, statSync as statSync2 } from "fs";
+import { basename, extname as extname2, join as join5, relative as relative2, sep } from "path";
+var SKIP_DIRS = /* @__PURE__ */ new Set([
+  ".decantr",
+  ".git",
+  ".next",
+  ".nuxt",
+  ".svelte-kit",
+  ".turbo",
+  ".vercel",
+  "build",
+  "coverage",
+  "dist",
+  "node_modules",
+  "playwright-report"
+]);
+var ROOT_CONTEXT_FILES = /* @__PURE__ */ new Set([
+  "AGENTS.md",
+  "CLAUDE.md",
+  "GEMINI.md",
+  "README.md",
+  "copilot-instructions.md",
+  ".cursorrules",
+  ".windsurfrules",
+  ".cursorignore",
+  ".claudeignore",
+  "components.json",
+  "tailwind.config.js",
+  "tailwind.config.ts",
+  "tailwind.config.mjs",
+  "tailwind.config.cjs",
+  "next.config.js",
+  "next.config.ts",
+  "next.config.mjs",
+  "nuxt.config.js",
+  "nuxt.config.ts",
+  "astro.config.mjs",
+  "astro.config.ts",
+  "svelte.config.js",
+  "svelte.config.ts",
+  "angular.json",
+  "vite.config.js",
+  "vite.config.ts",
+  "vitest.config.ts",
+  "vitest.config.js",
+  "playwright.config.ts",
+  "playwright.config.js",
+  "tsconfig.json",
+  "package.json",
+  "decantr.essence.json"
+]);
+var CONTEXT_DIRECTORIES = /* @__PURE__ */ new Set([
+  ".agents",
+  ".claude",
+  ".claude/initiatives",
+  ".claude/rules",
+  ".codex",
+  ".cursor",
+  ".cursor/rules",
+  ".github/workflows",
+  "docs",
+  "docs/initiatives",
+  "initiatives",
+  "memory",
+  "memories",
+  "project-memory",
+  "supabase"
+]);
 function shouldSkipDir(name) {
-  return name.startsWith("_") || name.startsWith(".") || SKIP_DIRS.has(name);
+  return SKIP_DIRS.has(name);
 }
-function segmentToRoute(segment) {
-  if (segment.startsWith("(") && segment.endsWith(")")) {
-    return null;
+function normalizedPath(relPath) {
+  return relPath.split(sep).join("/");
+}
+function isPotentialContextFile(relPath, name) {
+  const normalized2 = normalizedPath(relPath);
+  if (ROOT_CONTEXT_FILES.has(name)) return true;
+  if (name.startsWith(".env")) return true;
+  if (normalized2.startsWith(".claude/")) return true;
+  if (normalized2.startsWith(".agents/")) return true;
+  if (normalized2.startsWith(".codex/")) return true;
+  if (normalized2.startsWith(".cursor/")) return true;
+  if (normalized2.startsWith(".github/workflows/")) return true;
+  if (normalized2.startsWith("docs/")) return true;
+  if (normalized2.startsWith("initiatives/")) return true;
+  if (normalized2.startsWith("memory/")) return true;
+  if (normalized2.startsWith("memories/")) return true;
+  if (normalized2.startsWith("project-memory/")) return true;
+  if (normalized2.startsWith("supabase/")) return true;
+  if (normalized2.startsWith("migrations/")) return true;
+  if (normalized2.startsWith("db/")) return true;
+  if (normalized2.startsWith("ROLEMIGRATIONS/")) return true;
+  if (normalized2 === "src/middleware.ts" || normalized2 === "middleware.ts") return true;
+  if (normalized2.includes("/middleware.")) return true;
+  const ext = extname2(name).toLowerCase();
+  return ext === ".md" || ext === ".mdx" || ext === ".sql" || ext === ".yml" || ext === ".yaml";
+}
+function classifyContext(relPath) {
+  const normalized2 = normalizedPath(relPath);
+  const lower = normalized2.toLowerCase();
+  const name = basename(normalized2);
+  if (lower === "decantr.essence.json") {
+    return {
+      role: "architecture",
+      confidence: 0.82,
+      reason: "existing Decantr contract evidence"
+    };
   }
-  if (segment.startsWith("[") && segment.endsWith("]")) {
-    const param = segment.slice(1, -1);
-    if (param.startsWith("...")) {
-      return `:${param.slice(3)}*`;
-    }
-    if (param.startsWith("[...") && param.endsWith("]")) {
-      return `:${param.slice(4, -1)}*`;
-    }
-    return `:${param}`;
+  if (lower === ".claude/initiatives" || lower === "docs/initiatives" || lower === "initiatives" || lower === "memory" || lower === "memories" || lower === "project-memory" || lower.startsWith(".claude/initiatives/") || lower.startsWith("docs/initiatives/") || lower.startsWith("initiatives/") || lower.startsWith("memory/") || lower.startsWith("memories/") || lower.startsWith("project-memory/") || lower.includes("/feature/") || lower.includes("feature") || lower.includes("rbac") || lower.includes("billing") || lower.includes("admin") || lower.includes("dashboard")) {
+    return {
+      role: "feature-business",
+      confidence: 0.78,
+      reason: "feature, initiative, memory, or business-domain evidence"
+    };
   }
-  return segment;
+  if (lower === ".agents" || lower === ".claude" || lower === ".codex" || lower === ".cursor" || lower === "claude.md" || lower === "agents.md" || lower === "gemini.md" || lower === "copilot-instructions.md" || lower === ".cursorrules" || lower === ".windsurfrules" || lower.startsWith(".claude/") || lower.startsWith(".agents/") || lower.startsWith(".codex/") || lower.startsWith(".cursor/rules/")) {
+    return {
+      role: "assistant-specific",
+      confidence: 0.98,
+      reason: "assistant or AI-agent instruction surface"
+    };
+  }
+  if (lower.includes("security") || lower.includes("auth") || lower.includes("rls") || lower.includes("schema") || lower.includes("migration") || lower.startsWith("supabase/") || lower.startsWith("migrations/") || lower.startsWith("db/") || lower.startsWith("rolemigrations/") || lower.includes("middleware.")) {
+    return {
+      role: "security-data",
+      confidence: 0.9,
+      reason: "security, auth, schema, middleware, or data-governance evidence"
+    };
+  }
+  if (lower.includes("design-system") || lower === "components.json" || lower.startsWith("tailwind.config") || lower.includes("ui-components") || lower.includes("colors") || lower.includes("typography") || lower.includes("spacing")) {
+    return {
+      role: "design-system",
+      confidence: 0.88,
+      reason: "design system or styling convention evidence"
+    };
+  }
+  if (lower.startsWith(".github/workflows/") || lower.includes("workflow") || lower.includes("testing") || lower.includes("deployment") || lower.includes("vitest.config") || lower.includes("playwright.config") || lower === "package.json") {
+    return {
+      role: "workflow-ci",
+      confidence: 0.84,
+      reason: "workflow, CI, deployment, or validation command evidence"
+    };
+  }
+  if (lower === "docs" || lower.includes("architecture") || lower === "readme.md" || lower.includes("setup") || lower.includes("contributing") || name === "tsconfig.json" || lower.endsWith("config.ts") || lower.endsWith("config.js") || lower.endsWith("config.mjs")) {
+    return {
+      role: "architecture",
+      confidence: 0.72,
+      reason: "architecture, setup, or framework configuration evidence"
+    };
+  }
+  if (lower.includes("complete") || lower.includes("summary") || lower.includes("deprecated") || lower.includes("legacy") || lower.includes("migration")) {
+    return {
+      role: "stale-or-historical",
+      confidence: 0.64,
+      reason: "historical or possibly stale project documentation"
+    };
+  }
+  return { role: "unknown", confidence: 0.35, reason: "unclassified context candidate" };
 }
-function walkAppDir(dir, baseDir, segments) {
-  const routes = [];
+function isSafeToCite(relPath) {
+  const lower = normalizedPath(relPath).toLowerCase();
+  if (lower.startsWith(".env") && lower !== ".env.example" && lower !== ".env.sample") return false;
+  if (lower.includes("secret") || lower.includes("private-key") || lower.includes("credentials")) {
+    return false;
+  }
+  return true;
+}
+function addDirectoryContext(items, projectRoot, relPath) {
+  const fullPath = join5(projectRoot, relPath);
+  if (!existsSync5(fullPath)) return;
+  const stats = statSync2(fullPath);
+  const classified = classifyContext(relPath);
+  items.push({
+    path: normalizedPath(relPath),
+    type: "directory",
+    role: classified.role,
+    confidence: classified.confidence,
+    sizeBytes: stats.size,
+    safeToCite: isSafeToCite(relPath),
+    reason: classified.reason
+  });
+}
+function walk(projectRoot, dir, items, depth) {
+  if (depth > 6) return;
   let entries;
   try {
-    entries = readdirSync3(dir);
+    entries = readdirSync4(dir);
   } catch {
-    return routes;
-  }
-  const hasPage = entries.some(
-    (e) => e === "page.tsx" || e === "page.ts" || e === "page.jsx" || e === "page.js"
-  );
-  const hasLayout = entries.some(
-    (e) => e === "layout.tsx" || e === "layout.ts" || e === "layout.jsx" || e === "layout.js"
-  );
-  if (hasPage) {
-    const routePath = "/" + segments.filter((s) => s !== "").join("/");
-    const pageFile = entries.find((e) => e.startsWith("page."));
-    routes.push({
-      path: routePath || "/",
-      file: relative(baseDir, join4(dir, pageFile)),
-      hasLayout
-    });
+    return;
   }
   for (const entry of entries) {
     if (shouldSkipDir(entry)) continue;
-    const fullPath = join4(dir, entry);
+    const fullPath = join5(dir, entry);
+    const relPath = normalizedPath(relative2(projectRoot, fullPath));
+    let stats;
     try {
-      if (!statSync2(fullPath).isDirectory()) continue;
+      stats = statSync2(fullPath);
     } catch {
       continue;
     }
-    const routeSegment = segmentToRoute(entry);
-    const nextSegments = routeSegment === null ? [...segments] : [...segments, routeSegment];
-    routes.push(...walkAppDir(fullPath, baseDir, nextSegments));
+    if (stats.isDirectory()) {
+      if (CONTEXT_DIRECTORIES.has(relPath)) {
+        addDirectoryContext(items, projectRoot, relPath);
+      }
+      walk(projectRoot, fullPath, items, depth + 1);
+      continue;
+    }
+    if (!stats.isFile() || !isPotentialContextFile(relPath, entry)) continue;
+    const classified = classifyContext(relPath);
+    items.push({
+      path: relPath,
+      type: "file",
+      role: classified.role,
+      confidence: classified.confidence,
+      sizeBytes: stats.size,
+      safeToCite: isSafeToCite(relPath),
+      reason: classified.reason
+    });
   }
-  return routes;
 }
-function walkPagesDir(dir, baseDir, segments, extensions = /* @__PURE__ */ new Set(["ts", "tsx", "js", "jsx", "md", "mdx"])) {
-  const routes = [];
-  let entries;
-  try {
-    entries = readdirSync3(dir);
+function summarize(items) {
+  const summary = {
+    "assistant-specific": 0,
+    "security-data": 0,
+    architecture: 0,
+    "design-system": 0,
+    "workflow-ci": 0,
+    "feature-business": 0,
+    "stale-or-historical": 0,
+    unknown: 0
+  };
+  for (const item of items) summary[item.role] += 1;
+  return summary;
+}
+function readSmallText(projectRoot, relPath) {
+  const fullPath = join5(projectRoot, relPath);
+  try {
+    const stat = statSync2(fullPath);
+    if (stat.size > 64e3) return "";
+    return readFileSync5(fullPath, "utf-8");
+  } catch {
+    return "";
+  }
+}
+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 conflicts = [];
+  const frameworkSignals = [
+    ["next", /\bnext\.?js\b|\bapp router\b|\bpages router\b/],
+    ["angular", /\bangular\b/],
+    ["svelte", /\bsvelte\b|\bsveltekit\b/],
+    ["vue", /\bvue\b|\bnuxt\b/]
+  ].filter(([, pattern]) => pattern.test(text));
+  if (frameworkSignals.length > 1) {
+    conflicts.push(
+      `Multiple framework doctrines appear in ambient docs: ${frameworkSignals.map(([name]) => name).join(", ")}.`
+    );
+  }
+  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);
+  if (forbidsTailwind && endorsesTailwind) {
+    conflicts.push("Ambient docs contain both Tailwind usage and anti-Tailwind language.");
+  }
+  if (/\bclient component\b/.test(text) && /\bserver components? only\b/.test(text)) {
+    conflicts.push("Ambient docs may conflict on client vs server component boundaries.");
+  }
+  return conflicts;
+}
+function detectDecantrEssenceStaleRisk(projectRoot, items) {
+  if (!items.some((item) => item.path === "decantr.essence.json")) return [];
+  const content = readSmallText(projectRoot, "decantr.essence.json");
+  if (!content) return [];
+  try {
+    const essence = JSON.parse(content);
+    const risks = [];
+    if (essence.version !== "4.0.0") {
+      risks.push(
+        `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) {
+      risks.push(
+        "decantr.essence.json looks like an older Decantr default scaffold; verify before importing its theme or page layout as brownfield truth."
+      );
+    }
+    return risks;
+  } catch {
+    return [
+      "decantr.essence.json could not be parsed during ambient inventory; review before treating it as current doctrine."
+    ];
+  }
+}
+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.`
+  );
+  return [...pathRisks, ...detectDecantrEssenceStaleRisk(projectRoot, items)];
+}
+function scanAmbientContext(projectRoot) {
+  const items = [];
+  walk(projectRoot, projectRoot, items, 0);
+  const deduped = [...new Map(items.map((item) => [item.path, item])).values()].sort(
+    (a, b) => a.path.localeCompare(b.path)
+  );
+  return {
+    version: 1,
+    scannedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    items: deduped,
+    summary: summarize(deduped),
+    conflicts: detectConflicts(projectRoot, deduped),
+    staleRisks: detectStaleRisks(projectRoot, deduped)
+  };
+}
+
+// src/analyzers/routes.ts
+import { existsSync as existsSync6, readdirSync as readdirSync5, readFileSync as readFileSync6, statSync as statSync3 } from "fs";
+import { join as join6, relative as relative3 } from "path";
+var SKIP_DIRS2 = /* @__PURE__ */ new Set(["node_modules", ".next", ".git", "api", "_app", "_document"]);
+function shouldSkipDir2(name) {
+  return name.startsWith("_") || name.startsWith(".") || SKIP_DIRS2.has(name);
+}
+function segmentToRoute(segment) {
+  if (segment.startsWith("(") && segment.endsWith(")")) {
+    return null;
+  }
+  if (segment.startsWith("[") && segment.endsWith("]")) {
+    const param = segment.slice(1, -1);
+    if (param.startsWith("...")) {
+      return `:${param.slice(3)}*`;
+    }
+    if (param.startsWith("[...") && param.endsWith("]")) {
+      return `:${param.slice(4, -1)}*`;
+    }
+    return `:${param}`;
+  }
+  return segment;
+}
+function walkAppDir(dir, baseDir, segments) {
+  const routes = [];
+  let entries;
+  try {
+    entries = readdirSync5(dir);
   } catch {
     return routes;
   }
+  const hasPage = entries.some(
+    (e) => e === "page.tsx" || e === "page.ts" || e === "page.jsx" || e === "page.js"
+  );
+  const hasLayout = entries.some(
+    (e) => e === "layout.tsx" || e === "layout.ts" || e === "layout.jsx" || e === "layout.js"
+  );
+  if (hasPage) {
+    const routePath = "/" + segments.filter((s) => s !== "").join("/");
+    const pageFile = entries.find((e) => e.startsWith("page."));
+    routes.push({
+      path: routePath || "/",
+      file: relative3(baseDir, join6(dir, pageFile)),
+      hasLayout
+    });
+  }
   for (const entry of entries) {
-    if (shouldSkipDir(entry)) continue;
-    const fullPath = join4(dir, entry);
+    if (shouldSkipDir2(entry)) continue;
+    const fullPath = join6(dir, entry);
     try {
-      const stat = statSync2(fullPath);
+      if (!statSync3(fullPath).isDirectory()) continue;
+    } catch {
+      continue;
+    }
+    const routeSegment = segmentToRoute(entry);
+    const nextSegments = routeSegment === null ? [...segments] : [...segments, routeSegment];
+    routes.push(...walkAppDir(fullPath, baseDir, nextSegments));
+  }
+  return routes;
+}
+function walkPagesDir(dir, baseDir, segments, extensions = /* @__PURE__ */ new Set(["ts", "tsx", "js", "jsx", "md", "mdx"])) {
+  const routes = [];
+  let entries;
+  try {
+    entries = readdirSync5(dir);
+  } catch {
+    return routes;
+  }
+  for (const entry of entries) {
+    if (shouldSkipDir2(entry)) continue;
+    const fullPath = join6(dir, entry);
+    try {
+      const stat = statSync3(fullPath);
       if (stat.isDirectory()) {
         const routeSegment = segmentToRoute(entry);
         const nextSegments = routeSegment === null ? [...segments] : [...segments, routeSegment];
@@ -760,7 +1144,7 @@ function walkPagesDir(dir, baseDir, segments, extensions = /* @__PURE__ */ new S
         const routePath = "/" + [...segments, routeSegment].filter((s) => s !== "").join("/");
         routes.push({
           path: routePath || "/",
-          file: relative(baseDir, fullPath),
+          file: relative3(baseDir, fullPath),
           hasLayout: false
         });
       }
@@ -773,7 +1157,7 @@ function walkSvelteKitRoutes(dir, baseDir, segments) {
   const routes = [];
   let entries;
   try {
-    entries = readdirSync3(dir);
+    entries = readdirSync5(dir);
   } catch {
     return routes;
   }
@@ -783,15 +1167,15 @@ function walkSvelteKitRoutes(dir, baseDir, segments) {
     const routePath = "/" + segments.filter((segment) => segment !== "").join("/");
     routes.push({
       path: routePath || "/",
-      file: relative(baseDir, join4(dir, pageFile)),
+      file: relative3(baseDir, join6(dir, pageFile)),
       hasLayout
     });
   }
   for (const entry of entries) {
-    if (shouldSkipDir(entry)) continue;
-    const fullPath = join4(dir, entry);
+    if (shouldSkipDir2(entry)) continue;
+    const fullPath = join6(dir, entry);
     try {
-      if (!statSync2(fullPath).isDirectory()) continue;
+      if (!statSync3(fullPath).isDirectory()) continue;
     } catch {
       continue;
     }
@@ -806,15 +1190,15 @@ function collectRouteCandidateFiles(dir, files, depth = 0) {
   if (depth > 5) return;
   let entries;
   try {
-    entries = readdirSync3(dir);
+    entries = readdirSync5(dir);
   } catch {
     return;
   }
   for (const entry of entries) {
     if (entry.startsWith(".") || entry === "node_modules") continue;
-    const fullPath = join4(dir, entry);
+    const fullPath = join6(dir, entry);
     try {
-      const stat = statSync2(fullPath);
+      const stat = statSync3(fullPath);
       if (stat.isDirectory()) {
         collectRouteCandidateFiles(fullPath, files, depth + 1);
       } else if (stat.isFile()) {
@@ -828,22 +1212,22 @@ function collectRouteCandidateFiles(dir, files, depth = 0) {
   }
 }
 function scanReactRouter(projectRoot) {
-  const candidateDirs = [join4(projectRoot, "src"), projectRoot];
+  const candidateDirs = [join6(projectRoot, "src"), projectRoot];
   const candidateFiles = [];
   for (const dir of candidateDirs) {
-    if (existsSync4(dir)) collectRouteCandidateFiles(dir, candidateFiles);
+    if (existsSync6(dir)) collectRouteCandidateFiles(dir, candidateFiles);
   }
   const routeMap = /* @__PURE__ */ new Map();
   for (const absolutePath of candidateFiles) {
     let content;
     try {
-      content = readFileSync4(absolutePath, "utf-8");
+      content = readFileSync6(absolutePath, "utf-8");
     } catch {
       continue;
     }
     const isReactRouterFile = content.includes("react-router-dom") || content.includes("react-router") || content.includes("<Routes") || content.includes("createBrowserRouter") || content.includes("createHashRouter") || content.includes("RouterProvider") || content.includes("HashRouter") || content.includes("BrowserRouter");
     if (!isReactRouterFile) continue;
-    const relativePath = relative(projectRoot, absolutePath);
+    const relativePath = relative3(projectRoot, absolutePath);
     const pathMatches = /* @__PURE__ */ new Set();
     for (const match of content.matchAll(/<Route\b[^>]*\bpath=["'`]([^"'`]+)["'`]/g)) {
       pathMatches.add(match[1]);
@@ -870,10 +1254,10 @@ function hasReactRouterDependency(projectRoot) {
   return hasDependency(projectRoot, ["react-router", "react-router-dom"]);
 }
 function hasDependency(projectRoot, names) {
-  const packageJsonPath = join4(projectRoot, "package.json");
-  if (!existsSync4(packageJsonPath)) return false;
+  const packageJsonPath = join6(projectRoot, "package.json");
+  if (!existsSync6(packageJsonPath)) return false;
   try {
-    const pkg = JSON.parse(readFileSync4(packageJsonPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync6(packageJsonPath, "utf-8"));
     const deps = { ...pkg.dependencies, ...pkg.devDependencies };
     return names.some((name) => Boolean(deps[name]));
   } catch {
@@ -881,7 +1265,7 @@ function hasDependency(projectRoot, names) {
   }
 }
 function hasAnyFile(projectRoot, relPaths) {
-  return relPaths.some((relPath) => existsSync4(join4(projectRoot, relPath)));
+  return relPaths.some((relPath) => existsSync6(join6(projectRoot, relPath)));
 }
 function normalizeRoutePath(path) {
   const cleaned = path.trim();
@@ -890,22 +1274,22 @@ function normalizeRoutePath(path) {
   return cleaned.startsWith("/") ? cleaned : `/${cleaned}`;
 }
 function scanAngularRouter(projectRoot) {
-  const candidateDirs = [join4(projectRoot, "src", "app"), join4(projectRoot, "src")];
+  const candidateDirs = [join6(projectRoot, "src", "app"), join6(projectRoot, "src")];
   const candidateFiles = [];
   for (const dir of candidateDirs) {
-    if (existsSync4(dir)) collectRouteCandidateFiles(dir, candidateFiles);
+    if (existsSync6(dir)) collectRouteCandidateFiles(dir, candidateFiles);
   }
   const routeMap = /* @__PURE__ */ new Map();
   for (const absolutePath of candidateFiles) {
     let content;
     try {
-      content = readFileSync4(absolutePath, "utf-8");
+      content = readFileSync6(absolutePath, "utf-8");
     } catch {
       continue;
     }
     const isRouterFile = content.includes("@angular/router") || content.includes("RouterModule.forRoot") || content.includes("provideRouter") || content.includes("Routes =");
     if (!isRouterFile) continue;
-    const relativePath = relative(projectRoot, absolutePath);
+    const relativePath = relative3(projectRoot, absolutePath);
     for (const match of content.matchAll(/\bpath\s*:\s*["'`]([^"'`]*)["'`]/g)) {
       const routePath = normalizeRoutePath(match[1]);
       if (!routePath || routeMap.has(routePath)) continue;
@@ -919,22 +1303,22 @@ function scanAngularRouter(projectRoot) {
   return [...routeMap.values()];
 }
 function scanVueRouter(projectRoot) {
-  const candidateDirs = [join4(projectRoot, "src"), projectRoot];
+  const candidateDirs = [join6(projectRoot, "src"), projectRoot];
   const candidateFiles = [];
   for (const dir of candidateDirs) {
-    if (existsSync4(dir)) collectRouteCandidateFiles(dir, candidateFiles);
+    if (existsSync6(dir)) collectRouteCandidateFiles(dir, candidateFiles);
   }
   const routeMap = /* @__PURE__ */ new Map();
   for (const absolutePath of candidateFiles) {
     let content;
     try {
-      content = readFileSync4(absolutePath, "utf-8");
+      content = readFileSync6(absolutePath, "utf-8");
     } catch {
       continue;
     }
     const isRouterFile = content.includes("vue-router") || content.includes("createRouter") || content.includes("createWebHistory") || content.includes("createWebHashHistory");
     if (!isRouterFile) continue;
-    const relativePath = relative(projectRoot, absolutePath);
+    const relativePath = relative3(projectRoot, absolutePath);
     for (const match of content.matchAll(/\bpath\s*:\s*["'`]([^"'`]+)["'`]/g)) {
       const routePath = normalizeRoutePath(match[1]);
       if (!routePath || routeMap.has(routePath)) continue;
@@ -953,13 +1337,13 @@ function scanRoutes(projectRoot) {
   const hasNuxt = hasDependency(projectRoot, ["nuxt"]) || hasAnyFile(projectRoot, ["nuxt.config.js", "nuxt.config.ts"]);
   const hasAngular = hasDependency(projectRoot, ["@angular/core", "@angular/router"]) || hasAnyFile(projectRoot, ["angular.json"]);
   const hasVue = hasDependency(projectRoot, ["vue", "vue-router"]) || hasAnyFile(projectRoot, ["vite.config.js", "vite.config.ts"]);
-  const appDirs = [join4(projectRoot, "src", "app"), join4(projectRoot, "app")];
+  const appDirs = [join6(projectRoot, "src", "app"), join6(projectRoot, "app")];
   const appRoutes = appDirs.flatMap(
-    (appDir) => existsSync4(appDir) ? walkAppDir(appDir, projectRoot, []) : []
+    (appDir) => existsSync6(appDir) ? walkAppDir(appDir, projectRoot, []) : []
   );
-  const pagesDirs = [join4(projectRoot, "src", "pages"), join4(projectRoot, "pages")];
+  const pagesDirs = [join6(projectRoot, "src", "pages"), join6(projectRoot, "pages")];
   const pagesRoutes = pagesDirs.flatMap(
-    (pagesDir) => existsSync4(pagesDir) ? walkPagesDir(pagesDir, projectRoot, []) : []
+    (pagesDir) => existsSync6(pagesDir) ? walkPagesDir(pagesDir, projectRoot, []) : []
   );
   if (hasNext) {
     if (appRoutes.length > 0 && pagesRoutes.length > 0) {
@@ -971,16 +1355,16 @@ function scanRoutes(projectRoot) {
     return { strategy: "app-router", routes: appRoutes };
   }
   if (hasSvelteKit) {
-    const svelteRoutesDir = join4(projectRoot, "src", "routes");
-    if (existsSync4(svelteRoutesDir)) {
+    const svelteRoutesDir = join6(projectRoot, "src", "routes");
+    if (existsSync6(svelteRoutesDir)) {
       const routes = walkSvelteKitRoutes(svelteRoutesDir, projectRoot, []);
       if (routes.length > 0) return { strategy: "sveltekit-router", routes };
     }
   }
   if (hasNuxt) {
-    const nuxtPagesDirs = [join4(projectRoot, "pages"), join4(projectRoot, "app", "pages")];
+    const nuxtPagesDirs = [join6(projectRoot, "pages"), join6(projectRoot, "app", "pages")];
     const routes = nuxtPagesDirs.flatMap(
-      (pagesDir) => existsSync4(pagesDir) ? walkPagesDir(pagesDir, projectRoot, [], /* @__PURE__ */ new Set(["vue"])) : []
+      (pagesDir) => existsSync6(pagesDir) ? walkPagesDir(pagesDir, projectRoot, [], /* @__PURE__ */ new Set(["vue"])) : []
     );
     if (routes.length > 0) return { strategy: "nuxt-router", routes };
   }
@@ -1006,8 +1390,8 @@ function scanRoutes(projectRoot) {
 }
 
 // src/analyzers/styling.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5 } from "fs";
-import { join as join5 } from "path";
+import { existsSync as existsSync7, readFileSync as readFileSync7 } from "fs";
+import { join as join7 } from "path";
 var TAILWIND_CONFIGS = [
   "tailwind.config.js",
   "tailwind.config.ts",
@@ -1074,10 +1458,10 @@ function detectDarkMode(projectRoot, cssContents) {
     "app/layout.jsx"
   ];
   for (const rel of layoutPaths) {
-    const fullPath = join5(projectRoot, rel);
-    if (existsSync5(fullPath)) {
+    const fullPath = join7(projectRoot, rel);
+    if (existsSync7(fullPath)) {
       try {
-        const layoutContent = readFileSync5(fullPath, "utf-8");
+        const layoutContent = readFileSync7(fullPath, "utf-8");
         if (layoutContent.includes('className="dark"') || layoutContent.includes("className='dark'") || layoutContent.includes('class="dark"')) {
           return true;
         }
@@ -1085,10 +1469,10 @@ function detectDarkMode(projectRoot, cssContents) {
       }
     }
   }
-  const pkgPath = join5(projectRoot, "package.json");
-  if (existsSync5(pkgPath)) {
+  const pkgPath = join7(projectRoot, "package.json");
+  if (existsSync7(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync5(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSync7(pkgPath, "utf-8"));
       const allDeps = { ...pkg.dependencies, ...pkg.devDependencies };
       if (allDeps["next-themes"] || allDeps["theme-toggle"] || allDeps["use-dark-mode"]) {
         return true;
@@ -1096,10 +1480,10 @@ function detectDarkMode(projectRoot, cssContents) {
     } catch {
     }
   }
-  const essencePath = join5(projectRoot, "decantr.essence.json");
-  if (existsSync5(essencePath)) {
+  const essencePath = join7(projectRoot, "decantr.essence.json");
+  if (existsSync7(essencePath)) {
     try {
-      const essence = JSON.parse(readFileSync5(essencePath, "utf-8"));
+      const essence = JSON.parse(readFileSync7(essencePath, "utf-8"));
       const mode = essence.dna?.theme?.mode;
       if (mode === "dark" || mode === "auto") {
         return true;
@@ -1113,17 +1497,17 @@ function scanStyling(projectRoot) {
   let approach = "unknown";
   let configFile;
   let packageDeps = {};
-  const pkgPath = join5(projectRoot, "package.json");
-  if (existsSync5(pkgPath)) {
+  const pkgPath = join7(projectRoot, "package.json");
+  if (existsSync7(pkgPath)) {
     try {
-      const pkg = JSON.parse(readFileSync5(pkgPath, "utf-8"));
+      const pkg = JSON.parse(readFileSync7(pkgPath, "utf-8"));
       packageDeps = { ...pkg.dependencies, ...pkg.devDependencies };
     } catch {
       packageDeps = {};
     }
   }
   for (const cfg of TAILWIND_CONFIGS) {
-    if (existsSync5(join5(projectRoot, cfg))) {
+    if (existsSync7(join7(projectRoot, cfg))) {
       approach = "tailwind";
       configFile = cfg;
       break;
@@ -1151,27 +1535,27 @@ function scanStyling(projectRoot) {
       configFile = "package.json";
     }
   }
-  const decantrStyleFiles = DECANTR_STYLE_PATHS.filter((rel) => existsSync5(join5(projectRoot, rel)));
+  const decantrStyleFiles = DECANTR_STYLE_PATHS.filter((rel) => existsSync7(join7(projectRoot, rel)));
   if (decantrStyleFiles.length >= 2) {
     approach = "decantr-css";
     configFile = decantrStyleFiles.join(" + ");
   }
   const cssContents = [];
   for (const rel of GLOBALS_CSS_PATHS) {
-    const fullPath = join5(projectRoot, rel);
-    if (existsSync5(fullPath)) {
+    const fullPath = join7(projectRoot, rel);
+    if (existsSync7(fullPath)) {
       try {
-        cssContents.push(readFileSync5(fullPath, "utf-8"));
+        cssContents.push(readFileSync7(fullPath, "utf-8"));
       } catch {
       }
     }
   }
   for (const rel of DECANTR_STYLE_PATHS) {
     if (GLOBALS_CSS_PATHS.includes(rel)) continue;
-    const fullPath = join5(projectRoot, rel);
-    if (existsSync5(fullPath)) {
+    const fullPath = join7(projectRoot, rel);
+    if (existsSync7(fullPath)) {
       try {
-        cssContents.push(readFileSync5(fullPath, "utf-8"));
+        cssContents.push(readFileSync7(fullPath, "utf-8"));
       } catch {
       }
     }
@@ -1187,7 +1571,7 @@ function scanStyling(projectRoot) {
   const darkMode = detectDarkMode(projectRoot, cssContents);
   if (approach === "unknown" && cssContents.length > 0) {
     approach = "css";
-    configFile = GLOBALS_CSS_PATHS.find((rel) => existsSync5(join5(projectRoot, rel)));
+    configFile = GLOBALS_CSS_PATHS.find((rel) => existsSync7(join7(projectRoot, rel)));
   }
   return {
     approach,
@@ -1198,328 +1582,9 @@ function scanStyling(projectRoot) {
   };
 }
 
-// src/ambient-context.ts
-import { existsSync as existsSync6, readdirSync as readdirSync4, readFileSync as readFileSync6, statSync as statSync3 } from "fs";
-import { basename, extname as extname2, join as join6, relative as relative2, sep as sep2 } from "path";
-var SKIP_DIRS2 = /* @__PURE__ */ new Set([
-  ".decantr",
-  ".git",
-  ".next",
-  ".nuxt",
-  ".svelte-kit",
-  ".turbo",
-  ".vercel",
-  "build",
-  "coverage",
-  "dist",
-  "node_modules",
-  "playwright-report"
-]);
-var ROOT_CONTEXT_FILES = /* @__PURE__ */ new Set([
-  "AGENTS.md",
-  "CLAUDE.md",
-  "GEMINI.md",
-  "README.md",
-  "copilot-instructions.md",
-  ".cursorrules",
-  ".windsurfrules",
-  ".cursorignore",
-  ".claudeignore",
-  "components.json",
-  "tailwind.config.js",
-  "tailwind.config.ts",
-  "tailwind.config.mjs",
-  "tailwind.config.cjs",
-  "next.config.js",
-  "next.config.ts",
-  "next.config.mjs",
-  "nuxt.config.js",
-  "nuxt.config.ts",
-  "astro.config.mjs",
-  "astro.config.ts",
-  "svelte.config.js",
-  "svelte.config.ts",
-  "angular.json",
-  "vite.config.js",
-  "vite.config.ts",
-  "vitest.config.ts",
-  "vitest.config.js",
-  "playwright.config.ts",
-  "playwright.config.js",
-  "tsconfig.json",
-  "package.json",
-  "decantr.essence.json"
-]);
-var CONTEXT_DIRECTORIES = /* @__PURE__ */ new Set([
-  ".agents",
-  ".claude",
-  ".claude/initiatives",
-  ".claude/rules",
-  ".codex",
-  ".cursor",
-  ".cursor/rules",
-  ".github/workflows",
-  "docs",
-  "docs/initiatives",
-  "initiatives",
-  "memory",
-  "memories",
-  "project-memory",
-  "supabase"
-]);
-function shouldSkipDir2(name) {
-  return SKIP_DIRS2.has(name);
-}
-function normalizedPath(relPath) {
-  return relPath.split(sep2).join("/");
-}
-function isPotentialContextFile(relPath, name) {
-  const normalized2 = normalizedPath(relPath);
-  if (ROOT_CONTEXT_FILES.has(name)) return true;
-  if (name.startsWith(".env")) return true;
-  if (normalized2.startsWith(".claude/")) return true;
-  if (normalized2.startsWith(".agents/")) return true;
-  if (normalized2.startsWith(".codex/")) return true;
-  if (normalized2.startsWith(".cursor/")) return true;
-  if (normalized2.startsWith(".github/workflows/")) return true;
-  if (normalized2.startsWith("docs/")) return true;
-  if (normalized2.startsWith("initiatives/")) return true;
-  if (normalized2.startsWith("memory/")) return true;
-  if (normalized2.startsWith("memories/")) return true;
-  if (normalized2.startsWith("project-memory/")) return true;
-  if (normalized2.startsWith("supabase/")) return true;
-  if (normalized2.startsWith("migrations/")) return true;
-  if (normalized2.startsWith("db/")) return true;
-  if (normalized2.startsWith("ROLEMIGRATIONS/")) return true;
-  if (normalized2 === "src/middleware.ts" || normalized2 === "middleware.ts") return true;
-  if (normalized2.includes("/middleware.")) return true;
-  const ext = extname2(name).toLowerCase();
-  return ext === ".md" || ext === ".mdx" || ext === ".sql" || ext === ".yml" || ext === ".yaml";
-}
-function classifyContext(relPath) {
-  const normalized2 = normalizedPath(relPath);
-  const lower = normalized2.toLowerCase();
-  const name = basename(normalized2);
-  if (lower === "decantr.essence.json") {
-    return {
-      role: "architecture",
-      confidence: 0.82,
-      reason: "existing Decantr contract evidence"
-    };
-  }
-  if (lower === ".claude/initiatives" || lower === "docs/initiatives" || lower === "initiatives" || lower === "memory" || lower === "memories" || lower === "project-memory" || lower.startsWith(".claude/initiatives/") || lower.startsWith("docs/initiatives/") || lower.startsWith("initiatives/") || lower.startsWith("memory/") || lower.startsWith("memories/") || lower.startsWith("project-memory/") || lower.includes("/feature/") || lower.includes("feature") || lower.includes("rbac") || lower.includes("billing") || lower.includes("admin") || lower.includes("dashboard")) {
-    return {
-      role: "feature-business",
-      confidence: 0.78,
-      reason: "feature, initiative, memory, or business-domain evidence"
-    };
-  }
-  if (lower === ".agents" || lower === ".claude" || lower === ".codex" || lower === ".cursor" || lower === "claude.md" || lower === "agents.md" || lower === "gemini.md" || lower === "copilot-instructions.md" || lower === ".cursorrules" || lower === ".windsurfrules" || lower.startsWith(".claude/") || lower.startsWith(".agents/") || lower.startsWith(".codex/") || lower.startsWith(".cursor/rules/")) {
-    return {
-      role: "assistant-specific",
-      confidence: 0.98,
-      reason: "assistant or AI-agent instruction surface"
-    };
-  }
-  if (lower.includes("security") || lower.includes("auth") || lower.includes("rls") || lower.includes("schema") || lower.includes("migration") || lower.startsWith("supabase/") || lower.startsWith("migrations/") || lower.startsWith("db/") || lower.startsWith("rolemigrations/") || lower.includes("middleware.")) {
-    return {
-      role: "security-data",
-      confidence: 0.9,
-      reason: "security, auth, schema, middleware, or data-governance evidence"
-    };
-  }
-  if (lower.includes("design-system") || lower === "components.json" || lower.startsWith("tailwind.config") || lower.includes("ui-components") || lower.includes("colors") || lower.includes("typography") || lower.includes("spacing")) {
-    return {
-      role: "design-system",
-      confidence: 0.88,
-      reason: "design system or styling convention evidence"
-    };
-  }
-  if (lower.startsWith(".github/workflows/") || lower.includes("workflow") || lower.includes("testing") || lower.includes("deployment") || lower.includes("vitest.config") || lower.includes("playwright.config") || lower === "package.json") {
-    return {
-      role: "workflow-ci",
-      confidence: 0.84,
-      reason: "workflow, CI, deployment, or validation command evidence"
-    };
-  }
-  if (lower === "docs" || lower.includes("architecture") || lower === "readme.md" || lower.includes("setup") || lower.includes("contributing") || name === "tsconfig.json" || lower.endsWith("config.ts") || lower.endsWith("config.js") || lower.endsWith("config.mjs")) {
-    return {
-      role: "architecture",
-      confidence: 0.72,
-      reason: "architecture, setup, or framework configuration evidence"
-    };
-  }
-  if (lower.includes("complete") || lower.includes("summary") || lower.includes("deprecated") || lower.includes("legacy") || lower.includes("migration")) {
-    return {
-      role: "stale-or-historical",
-      confidence: 0.64,
-      reason: "historical or possibly stale project documentation"
-    };
-  }
-  return { role: "unknown", confidence: 0.35, reason: "unclassified context candidate" };
-}
-function isSafeToCite(relPath) {
-  const lower = normalizedPath(relPath).toLowerCase();
-  if (lower.startsWith(".env") && lower !== ".env.example" && lower !== ".env.sample") return false;
-  if (lower.includes("secret") || lower.includes("private-key") || lower.includes("credentials")) {
-    return false;
-  }
-  return true;
-}
-function addDirectoryContext(items, projectRoot, relPath) {
-  const fullPath = join6(projectRoot, relPath);
-  if (!existsSync6(fullPath)) return;
-  const stats = statSync3(fullPath);
-  const classified = classifyContext(relPath);
-  items.push({
-    path: normalizedPath(relPath),
-    type: "directory",
-    role: classified.role,
-    confidence: classified.confidence,
-    sizeBytes: stats.size,
-    safeToCite: isSafeToCite(relPath),
-    reason: classified.reason
-  });
-}
-function walk(projectRoot, dir, items, depth) {
-  if (depth > 6) return;
-  let entries;
-  try {
-    entries = readdirSync4(dir);
-  } catch {
-    return;
-  }
-  for (const entry of entries) {
-    if (shouldSkipDir2(entry)) continue;
-    const fullPath = join6(dir, entry);
-    const relPath = normalizedPath(relative2(projectRoot, fullPath));
-    let stats;
-    try {
-      stats = statSync3(fullPath);
-    } catch {
-      continue;
-    }
-    if (stats.isDirectory()) {
-      if (CONTEXT_DIRECTORIES.has(relPath)) {
-        addDirectoryContext(items, projectRoot, relPath);
-      }
-      walk(projectRoot, fullPath, items, depth + 1);
-      continue;
-    }
-    if (!stats.isFile() || !isPotentialContextFile(relPath, entry)) continue;
-    const classified = classifyContext(relPath);
-    items.push({
-      path: relPath,
-      type: "file",
-      role: classified.role,
-      confidence: classified.confidence,
-      sizeBytes: stats.size,
-      safeToCite: isSafeToCite(relPath),
-      reason: classified.reason
-    });
-  }
-}
-function summarize(items) {
-  const summary = {
-    "assistant-specific": 0,
-    "security-data": 0,
-    architecture: 0,
-    "design-system": 0,
-    "workflow-ci": 0,
-    "feature-business": 0,
-    "stale-or-historical": 0,
-    unknown: 0
-  };
-  for (const item of items) summary[item.role] += 1;
-  return summary;
-}
-function readSmallText(projectRoot, relPath) {
-  const fullPath = join6(projectRoot, relPath);
-  try {
-    const stat = statSync3(fullPath);
-    if (stat.size > 64e3) return "";
-    return readFileSync6(fullPath, "utf-8");
-  } catch {
-    return "";
-  }
-}
-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 conflicts = [];
-  const frameworkSignals = [
-    ["next", /\bnext\.?js\b|\bapp router\b|\bpages router\b/],
-    ["angular", /\bangular\b/],
-    ["svelte", /\bsvelte\b|\bsveltekit\b/],
-    ["vue", /\bvue\b|\bnuxt\b/]
-  ].filter(([, pattern]) => pattern.test(text));
-  if (frameworkSignals.length > 1) {
-    conflicts.push(
-      `Multiple framework doctrines appear in ambient docs: ${frameworkSignals.map(([name]) => name).join(", ")}.`
-    );
-  }
-  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);
-  if (forbidsTailwind && endorsesTailwind) {
-    conflicts.push("Ambient docs contain both Tailwind usage and anti-Tailwind language.");
-  }
-  if (/\bclient component\b/.test(text) && /\bserver components? only\b/.test(text)) {
-    conflicts.push("Ambient docs may conflict on client vs server component boundaries.");
-  }
-  return conflicts;
-}
-function detectDecantrEssenceStaleRisk(projectRoot, items) {
-  if (!items.some((item) => item.path === "decantr.essence.json")) return [];
-  const content = readSmallText(projectRoot, "decantr.essence.json");
-  if (!content) return [];
-  try {
-    const essence = JSON.parse(content);
-    const risks = [];
-    if (essence.version !== "4.0.0") {
-      risks.push(
-        `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) {
-      risks.push(
-        "decantr.essence.json looks like an older Decantr default scaffold; verify before importing its theme or page layout as brownfield truth."
-      );
-    }
-    return risks;
-  } catch {
-    return [
-      "decantr.essence.json could not be parsed during ambient inventory; review before treating it as current doctrine."
-    ];
-  }
-}
-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.`
-  );
-  return [...pathRisks, ...detectDecantrEssenceStaleRisk(projectRoot, items)];
-}
-function scanAmbientContext(projectRoot) {
-  const items = [];
-  walk(projectRoot, projectRoot, items, 0);
-  const deduped = [...new Map(items.map((item) => [item.path, item])).values()].sort(
-    (a, b) => a.path.localeCompare(b.path)
-  );
-  return {
-    version: 1,
-    scannedAt: (/* @__PURE__ */ new Date()).toISOString(),
-    items: deduped,
-    summary: summarize(deduped),
-    conflicts: detectConflicts(projectRoot, deduped),
-    staleRisks: detectStaleRisks(projectRoot, deduped)
-  };
-}
-
 // src/doctrine-map.ts
-import { existsSync as existsSync7, readFileSync as readFileSync7, writeFileSync as writeFileSync2 } from "fs";
-import { join as join7 } from "path";
+import { existsSync as existsSync8, readFileSync as readFileSync8, writeFileSync as writeFileSync2 } from "fs";
+import { join as join8 } from "path";
 var PRECEDENCE_ORDER = [
   "security-data",
   "architecture",
@@ -1672,16 +1737,16 @@ function createDoctrineMap(ambient) {
   };
 }
 function doctrineMapPath(projectRoot) {
-  return join7(projectRoot, ".decantr", "doctrine-map.json");
+  return join8(projectRoot, ".decantr", "doctrine-map.json");
 }
 function writeDoctrineMap(projectRoot, doctrine) {
   writeFileSync2(doctrineMapPath(projectRoot), JSON.stringify(doctrine, null, 2) + "\n", "utf-8");
 }
 function readDoctrineMap(projectRoot) {
   const path = doctrineMapPath(projectRoot);
-  if (!existsSync7(path)) return null;
+  if (!existsSync8(path)) return null;
   try {
-    const parsed = JSON.parse(readFileSync7(path, "utf-8"));
+    const parsed = JSON.parse(readFileSync8(path, "utf-8"));
     if (parsed.version !== 1 || !Array.isArray(parsed.sources)) return null;
     return parsed;
   } catch {
@@ -1690,9 +1755,11 @@ function readDoctrineMap(projectRoot) {
 }
 
 export {
+  loadBundledContentItem,
+  loadBundledContentList,
+  scanAmbientContext,
   scanRoutes,
   scanStyling,
-  scanAmbientContext,
   createDoctrineMap,
   writeDoctrineMap,
   readDoctrineMap,