codebase-snapshot 0.9.1 → 0.9.4

package/dist/{chunk-HT7J3NWT.js → chunk-FCWD4LY7.js}

@@ -1,9 +1,9 @@
 import * as crypto from 'crypto';
 import { createHash } from 'crypto';
 import { AsyncLocalStorage } from 'async_hooks';
-import * as fs10 from 'fs';
+import * as fs11 from 'fs';
 import * as os from 'os';
-import * as path11 from 'path';
+import * as path12 from 'path';
 import ts from 'typescript';
 import { createRequire } from 'module';
 import { pathToFileURL } from 'url';
@@ -234,9 +234,9 @@ var JAVA_METHOD = /^\s+(?:public|private|protected)\s+(?:static\s+)?(?:final\s+)
 var jvmProfile = {
   id: "jvm",
   extensions: [".java", ".kt", ".kts", ".scala"],
-  summarize(path12, content) {
+  summarize(path13, content) {
     const summary = emptySummary();
-    const lower = path12.toLowerCase();
+    const lower = path13.toLowerCase();
     const isJava = lower.endsWith(".java");
     const isKotlin = lower.endsWith(".kt") || lower.endsWith(".kts");
     eachLine(content, (line) => {
@@ -689,16 +689,16 @@ function summarizeTypeScriptSource(relativePath, content) {
 // src/ast/profiles/sfc.ts
 var SCRIPT_BLOCK = /<script[^>]*>([\s\S]*?)<\/script>/gi;
 var ASTRO_FRONTMATTER = /^\uFEFF?---[ \t]*\r?\n([\s\S]*?)\r?\n---[ \t]*(?=\r?\n|$)/;
-function componentName(path12) {
-  const base = path12.split("/").pop() ?? path12;
+function componentName(path13) {
+  const base = path13.split("/").pop() ?? path13;
   return base.replace(/\.[^.]+$/, "");
 }
 var sfcProfile = {
   id: "sfc",
   extensions: [".vue", ".svelte", ".astro"],
-  summarize(path12, content) {
+  summarize(path13, content) {
     let script = "";
-    if (path12.toLowerCase().endsWith(".astro")) {
+    if (path13.toLowerCase().endsWith(".astro")) {
       const frontmatter = ASTRO_FRONTMATTER.exec(content);
       if (frontmatter) script += `${frontmatter[1]}
 `;
@@ -707,7 +707,7 @@ var sfcProfile = {
       script += `${match[1]}
 `;
     }
-    const name = componentName(path12);
+    const name = componentName(path13);
     if (!script.trim()) {
       const summary2 = emptySummary();
       if (name) {
@@ -741,15 +741,15 @@ for (const profile of LANGUAGE_PROFILES) {
     BY_EXTENSION.set(extension.toLowerCase(), profile);
   }
 }
-function profileForPath(path12) {
-  const lower = path12.toLowerCase();
+function profileForPath(path13) {
+  const lower = path13.toLowerCase();
   const dot = lower.lastIndexOf(".");
   if (dot === -1) return null;
   return BY_EXTENSION.get(lower.slice(dot)) ?? null;
 }
-function summarizeWithProfile(path12, content) {
-  const profile = profileForPath(path12);
-  return profile ? profile.summarize(path12, content) : null;
+function summarizeWithProfile(path13, content) {
+  const profile = profileForPath(path13);
+  return profile ? profile.summarize(path13, content) : null;
 }
 
 // src/ast/structured.ts
@@ -920,15 +920,15 @@ var SKIPPED_WALK_DIRS = /* @__PURE__ */ new Set([
 ]);
 function readSmallFile(fullPath) {
   try {
-    const stats = fs10.statSync(fullPath);
+    const stats = fs11.statSync(fullPath);
     if (!stats.isFile() || stats.size > MANIFEST_MAX_BYTES) return null;
-    return fs10.readFileSync(fullPath, "utf8");
+    return fs11.readFileSync(fullPath, "utf8");
   } catch {
     return null;
   }
 }
 function readManifest(cwd, name) {
-  return readSmallFile(path11.join(cwd, name));
+  return readSmallFile(path12.join(cwd, name));
 }
 function dependenciesFromPackageJson(raw) {
   const names = /* @__PURE__ */ new Set();
@@ -988,7 +988,7 @@ function pnpmWorkspacePatterns(raw) {
 function childDirectories(cwd, parent) {
   let entries;
   try {
-    entries = fs10.readdirSync(path11.join(cwd, parent), { withFileTypes: true });
+    entries = fs11.readdirSync(path12.join(cwd, parent), { withFileTypes: true });
   } catch {
     return [];
   }
@@ -1023,13 +1023,13 @@ function workspacePackageDirs(cwd, patterns) {
 function scanWorkspacePackages(cwd, patterns) {
   const files = /* @__PURE__ */ new Set();
   const dependencies = /* @__PURE__ */ new Set();
-  for (const relative6 of workspacePackageDirs(cwd, patterns)) {
-    const full = path11.join(cwd, relative6);
+  for (const relative7 of workspacePackageDirs(cwd, patterns)) {
+    const full = path12.join(cwd, relative7);
     try {
-      for (const entry of fs10.readdirSync(full, { withFileTypes: true })) files.add(entry.name);
+      for (const entry of fs11.readdirSync(full, { withFileTypes: true })) files.add(entry.name);
     } catch {
     }
-    const raw = readSmallFile(path11.join(full, "package.json"));
+    const raw = readSmallFile(path12.join(full, "package.json"));
     if (raw !== null) {
       for (const name of dependenciesFromPackageJson(raw)) dependencies.add(name);
     }
@@ -1046,7 +1046,7 @@ function countMarkdownFiles(cwd) {
     directoriesSeen += 1;
     let entries;
     try {
-      entries = fs10.readdirSync(current.dir, { withFileTypes: true });
+      entries = fs11.readdirSync(current.dir, { withFileTypes: true });
     } catch {
       continue;
     }
@@ -1057,7 +1057,7 @@ function countMarkdownFiles(cwd) {
       }
       if (!entry.isDirectory() || current.depth >= 2) continue;
       if (entry.name.startsWith(".") || SKIPPED_WALK_DIRS.has(entry.name)) continue;
-      queue.push({ dir: path11.join(current.dir, entry.name), depth: current.depth + 1 });
+      queue.push({ dir: path12.join(current.dir, entry.name), depth: current.depth + 1 });
     }
   }
   return count;
@@ -1066,7 +1066,7 @@ function buildPresetContext(cwd) {
   const files = /* @__PURE__ */ new Set();
   const dirs = /* @__PURE__ */ new Set();
   try {
-    for (const entry of fs10.readdirSync(cwd, { withFileTypes: true })) {
+    for (const entry of fs11.readdirSync(cwd, { withFileTypes: true })) {
       if (entry.isDirectory()) dirs.add(entry.name);
       else if (entry.isFile()) files.add(entry.name);
     }
@@ -1083,7 +1083,7 @@ function buildPresetContext(cwd) {
   const isWorkspace = files.has("pnpm-workspace.yaml") || files.has("nx.json") || files.has("turbo.json") || files.has("lerna.json") || packageJson !== void 0 && packageJson.includes('"workspaces"') || declaredWorkspaces.length > 0;
   let workspace = { files: /* @__PURE__ */ new Set(), dependencies: /* @__PURE__ */ new Set() };
   if (isWorkspace) {
-    const pnpmRaw = files.has("pnpm-workspace.yaml") ? readSmallFile(path11.join(cwd, "pnpm-workspace.yaml")) : null;
+    const pnpmRaw = files.has("pnpm-workspace.yaml") ? readSmallFile(path12.join(cwd, "pnpm-workspace.yaml")) : null;
     const declared = pnpmRaw === null ? [] : pnpmWorkspacePatterns(pnpmRaw);
     const patterns = declared.length > 0 ? declared : declaredWorkspaces.length > 0 ? declaredWorkspaces : DEFAULT_WORKSPACE_PATTERNS;
     workspace = scanWorkspacePackages(cwd, patterns);
@@ -1101,25 +1101,41 @@ function buildPresetContext(cwd) {
     markdownCount: files.has("package.json") ? 0 : countMarkdownFiles(cwd)
   };
 }
-function hasFile(context, name) {
-  return context.files.has(name);
+
+// src/presets/evidence.ts
+function fileEvidence(context, name) {
+  return context.files.has(name) ? name : null;
 }
-function hasFileStartingWith(context, prefix) {
+function fileStartingWithEvidence(context, prefix) {
   for (const file of context.files) {
-    if (file.startsWith(prefix)) return true;
+    if (file.startsWith(prefix)) return file;
   }
   for (const file of context.workspaceFiles) {
-    if (file.startsWith(prefix)) return true;
+    if (file.startsWith(prefix)) return file;
   }
-  return false;
+  return null;
 }
-function manifestContains(context, manifest, needle) {
+function dependencyEvidence(context, ...names) {
+  for (const name of names) {
+    if (context.dependencies.has(name)) return `depends on ${name}`;
+  }
+  return null;
+}
+function manifestEvidence(context, manifest, needle) {
   const content = context.manifests[manifest];
-  if (!content) return false;
-  return content.toLowerCase().includes(needle.toLowerCase());
+  if (!content) return null;
+  if (!content.toLowerCase().includes(needle.toLowerCase())) return null;
+  return `${needle} in ${manifest}`;
 }
-function hasDependency(context, ...names) {
-  return names.some((name) => context.dependencies.has(name));
+function suffixEvidence(context, suffix) {
+  for (const file of context.files) {
+    if (file.endsWith(suffix)) return file;
+  }
+  return null;
+}
+function markdownEvidence(context) {
+  if (context.markdownCount < 3 || context.files.has("package.json")) return null;
+  return `${context.markdownCount} markdown files, no package.json`;
 }
 
 // src/presets/helpers.ts
@@ -1327,7 +1343,7 @@ var JS_PRESETS = [
   {
     name: "nextjs",
     priority: 100,
-    detect: (context) => hasFileStartingWith(context, "next.config") || hasDependency(context, "next"),
+    detect: (context) => fileStartingWithEvidence(context, "next.config") ?? dependencyEvidence(context, "next"),
     layers: NEXTJS_LAYERS,
     kinds: NEXTJS_KINDS,
     exclude: NEXT_LIKE_EXCLUDES,
@@ -1336,7 +1352,7 @@ var JS_PRESETS = [
   {
     name: "nuxt",
     priority: 98,
-    detect: (context) => hasFileStartingWith(context, "nuxt.config") || hasDependency(context, "nuxt", "nuxt3"),
+    detect: (context) => fileStartingWithEvidence(context, "nuxt.config") ?? dependencyEvidence(context, "nuxt", "nuxt3"),
     layers: [
       layer("pages", "pages/", "src/pages/"),
       layer("components", "components/", "src/components/"),
@@ -1360,7 +1376,7 @@ var JS_PRESETS = [
   {
     name: "sveltekit",
     priority: 96,
-    detect: (context) => hasFileStartingWith(context, "svelte.config") || hasDependency(context, "@sveltejs/kit", "svelte"),
+    detect: (context) => fileStartingWithEvidence(context, "svelte.config") ?? dependencyEvidence(context, "@sveltejs/kit", "svelte"),
     layers: [
       layer("routes", "src/routes/", "routes/"),
       layer("lib", "src/lib/", "lib/"),
@@ -1381,7 +1397,7 @@ var JS_PRESETS = [
   {
     name: "remix",
     priority: 94,
-    detect: (context) => hasDependency(context, "@remix-run/react", "@remix-run/node", "@remix-run/dev"),
+    detect: (context) => dependencyEvidence(context, "@remix-run/react", "@remix-run/node", "@remix-run/dev"),
     layers: [
       layer("routes", "app/routes/", "routes/"),
       layer("components", "app/components/"),
@@ -1395,7 +1411,7 @@ var JS_PRESETS = [
   {
     name: "astro",
     priority: 92,
-    detect: (context) => hasFileStartingWith(context, "astro.config") || hasDependency(context, "astro"),
+    detect: (context) => fileStartingWithEvidence(context, "astro.config") ?? dependencyEvidence(context, "astro"),
     layers: [
       layer("pages", "src/pages/"),
       layer("layouts", "src/layouts/"),
@@ -1410,7 +1426,7 @@ var JS_PRESETS = [
   {
     name: "angular",
     priority: 90,
-    detect: (context) => hasFile(context, "angular.json") || hasDependency(context, "@angular/core"),
+    detect: (context) => fileEvidence(context, "angular.json") ?? dependencyEvidence(context, "@angular/core"),
     layers: [
       layer("app", "src/app/"),
       layer("features", "src/app/features/"),
@@ -1434,7 +1450,7 @@ var JS_PRESETS = [
   {
     name: "solid",
     priority: 88,
-    detect: (context) => hasDependency(context, "solid-js", "solid-start"),
+    detect: (context) => dependencyEvidence(context, "solid-js", "solid-start"),
     layers: [
       layer("pages", "src/routes/", "src/pages/"),
       layer("components", "src/components/"),
@@ -1447,7 +1463,15 @@ var JS_PRESETS = [
   {
     name: "vue-vite",
     priority: 86,
-    detect: (context) => hasDependency(context, "vue") && (hasDependency(context, "vite") || hasFileStartingWith(context, "vite.config")),
+    // `vue` is the decisive signal; `vite` (or its config file) only says the app is
+    // built with Vite rather than shipped pre-compiled, so it is required but not what
+    // gets reported.
+    detect: (context) => {
+      const framework = dependencyEvidence(context, "vue");
+      if (framework === null) return null;
+      const build = dependencyEvidence(context, "vite") ?? fileStartingWithEvidence(context, "vite.config");
+      return build === null ? null : framework;
+    },
     layers: [
       layer("pages", "src/pages/", "src/views/"),
       layer("components", "src/components/"),
@@ -1472,7 +1496,12 @@ var JS_PRESETS = [
   {
     name: "react-vite",
     priority: 84,
-    detect: (context) => hasDependency(context, "react") && (hasDependency(context, "vite") || hasFileStartingWith(context, "vite.config")),
+    detect: (context) => {
+      const framework = dependencyEvidence(context, "react");
+      if (framework === null) return null;
+      const build = dependencyEvidence(context, "vite") ?? fileStartingWithEvidence(context, "vite.config");
+      return build === null ? null : framework;
+    },
     layers: VITE_LAYERS,
     kinds: VITE_KINDS,
     exclude: [".vite", "dist"],
@@ -1481,7 +1510,7 @@ var JS_PRESETS = [
   {
     name: "nest",
     priority: 80,
-    detect: (context) => hasDependency(context, "@nestjs/core"),
+    detect: (context) => dependencyEvidence(context, "@nestjs/core"),
     layers: [
       layer("modules", "src/modules/", "modules/"),
       layer("controllers", "src/controllers/", "controllers/"),
@@ -1507,7 +1536,7 @@ var JS_PRESETS = [
   {
     name: "node-express",
     priority: 78,
-    detect: (context) => hasDependency(context, "express", "fastify", "koa", "@hapi/hapi"),
+    detect: (context) => dependencyEvidence(context, "express", "fastify", "koa", "@hapi/hapi"),
     layers: NODE_LAYERS,
     kinds: NODE_KINDS,
     exclude: ["dist"],
@@ -1518,7 +1547,7 @@ var JS_PRESETS = [
     // A bare package.json is often just tooling around a non-JS project, so it
     // ranks below every definitive language manifest.
     priority: 45,
-    detect: (context) => hasFile(context, "package.json"),
+    detect: (context) => fileEvidence(context, "package.json"),
     layers: [
       layer("src", "src/"),
       layer("lib", "lib/"),
@@ -1532,13 +1561,12 @@ var JS_PRESETS = [
 ];
 
 // src/presets/lang-presets.ts
-var anyFileEndingWith = (context, suffix) => Array.from(context.files).some((file) => file.endsWith(suffix));
 var DIR = (name) => `${name}/`;
 var LANGUAGE_PRESETS = [
   {
     name: "python-django",
     priority: 56,
-    detect: (context) => hasFile(context, "manage.py") || manifestContains(context, "pyproject.toml", "django") || manifestContains(context, "requirements.txt", "django"),
+    detect: (context) => fileEvidence(context, "manage.py") ?? manifestEvidence(context, "pyproject.toml", "django") ?? manifestEvidence(context, "requirements.txt", "django"),
     layers: [
       layer("views", DIR("views"), DIR("app/views"), DIR("apps/views")),
       layer("models", DIR("models"), DIR("app/models"), DIR("apps/models")),
@@ -1564,7 +1592,7 @@ var LANGUAGE_PRESETS = [
   {
     name: "python-fastapi",
     priority: 54,
-    detect: (context) => manifestContains(context, "requirements.txt", "fastapi") || manifestContains(context, "requirements.txt", "flask") || manifestContains(context, "pyproject.toml", "fastapi") || manifestContains(context, "pyproject.toml", "flask"),
+    detect: (context) => manifestEvidence(context, "requirements.txt", "fastapi") ?? manifestEvidence(context, "requirements.txt", "flask") ?? manifestEvidence(context, "pyproject.toml", "fastapi") ?? manifestEvidence(context, "pyproject.toml", "flask"),
     layers: [
       layer("routers", DIR("routers"), DIR("routes"), DIR("api")),
       layer("models", DIR("models"), DIR("db")),
@@ -1588,7 +1616,7 @@ var LANGUAGE_PRESETS = [
     name: "python-lib",
     // Below node-lib: a Node repo with a stray .py file is still a Node repo.
     priority: 30,
-    detect: (context) => hasFile(context, "pyproject.toml") || hasFile(context, "setup.py") || hasFile(context, "requirements.txt") || anyFileEndingWith(context, ".py"),
+    detect: (context) => fileEvidence(context, "pyproject.toml") ?? fileEvidence(context, "setup.py") ?? fileEvidence(context, "requirements.txt") ?? suffixEvidence(context, ".py"),
     layers: [
       layer("package", DIR("src"), DIR("lib")),
       layer("tests", DIR("tests"), DIR("test")),
@@ -1601,7 +1629,7 @@ var LANGUAGE_PRESETS = [
   {
     name: "go",
     priority: 50,
-    detect: (context) => hasFile(context, "go.mod"),
+    detect: (context) => fileEvidence(context, "go.mod"),
     layers: [
       layer("cmd", "cmd/"),
       layer("internal", "internal/"),
@@ -1625,7 +1653,7 @@ var LANGUAGE_PRESETS = [
   {
     name: "rust",
     priority: 48,
-    detect: (context) => hasFile(context, "Cargo.toml"),
+    detect: (context) => fileEvidence(context, "Cargo.toml"),
     layers: [
       layer("src", "src/"),
       layer("crates", "crates/"),
@@ -1641,7 +1669,7 @@ var LANGUAGE_PRESETS = [
   {
     name: "java-spring",
     priority: 46,
-    detect: (context) => hasFile(context, "pom.xml") || hasFile(context, "build.gradle") || hasFile(context, "build.gradle.kts"),
+    detect: (context) => fileEvidence(context, "pom.xml") ?? fileEvidence(context, "build.gradle") ?? fileEvidence(context, "build.gradle.kts"),
     layers: [
       layer("api", "src/main/java/"),
       layer("test", "src/test/java/"),
@@ -1664,7 +1692,7 @@ var LANGUAGE_PRESETS = [
   {
     name: "dotnet",
     priority: 44,
-    detect: (context) => anyFileEndingWith(context, ".csproj") || anyFileEndingWith(context, ".sln") || hasFile(context, "global.json"),
+    detect: (context) => suffixEvidence(context, ".csproj") ?? suffixEvidence(context, ".sln") ?? fileEvidence(context, "global.json"),
     layers: [
       layer("web", "src/", "Web/"),
       layer("domain", "Domain/", "Core/"),
@@ -1687,7 +1715,7 @@ var LANGUAGE_PRESETS = [
   {
     name: "php-laravel",
     priority: 42,
-    detect: (context) => hasFile(context, "artisan") || manifestContains(context, "composer.json", "laravel") || hasFile(context, "composer.json"),
+    detect: (context) => fileEvidence(context, "artisan") ?? manifestEvidence(context, "composer.json", "laravel") ?? fileEvidence(context, "composer.json"),
     layers: [
       layer("app", "app/"),
       layer("routes", "routes/"),
@@ -1713,7 +1741,7 @@ var LANGUAGE_PRESETS = [
   {
     name: "ruby-rails",
     priority: 40,
-    detect: (context) => hasFile(context, "Gemfile") || hasFile(context, "config.ru") || hasFile(context, "Rakefile"),
+    detect: (context) => fileEvidence(context, "Gemfile") ?? fileEvidence(context, "config.ru") ?? fileEvidence(context, "Rakefile"),
     layers: [
       layer("app", "app/"),
       layer("controllers", "app/controllers/"),
@@ -1786,7 +1814,7 @@ var SHAPE_PRESETS = [
   {
     name: "monorepo",
     priority: 70,
-    detect: (context) => hasFile(context, "pnpm-workspace.yaml") || hasFile(context, "nx.json") || hasFile(context, "turbo.json") || hasFile(context, "lerna.json") || manifestContains(context, "package.json", '"workspaces"'),
+    detect: (context) => fileEvidence(context, "pnpm-workspace.yaml") ?? fileEvidence(context, "nx.json") ?? fileEvidence(context, "turbo.json") ?? fileEvidence(context, "lerna.json") ?? manifestEvidence(context, "package.json", '"workspaces"'),
     layers: [
       layer("apps", "apps/"),
       layer("packages", "packages/"),
@@ -1800,7 +1828,7 @@ var SHAPE_PRESETS = [
   {
     name: "infra",
     priority: 24,
-    detect: (context) => Array.from(context.files).some((file) => file.endsWith(".tf")) || hasFile(context, "Chart.yaml") || hasFile(context, "kustomization.yaml") || hasFile(context, "docker-compose.yml") || hasFile(context, "docker-compose.yaml"),
+    detect: (context) => suffixEvidence(context, ".tf") ?? fileEvidence(context, "Chart.yaml") ?? fileEvidence(context, "kustomization.yaml") ?? fileEvidence(context, "docker-compose.yml") ?? fileEvidence(context, "docker-compose.yaml"),
     layers: [
       layer("modules", "modules/"),
       layer("environments", "env/", "environments/"),
@@ -1822,7 +1850,7 @@ var SHAPE_PRESETS = [
     // up to two directories down (bounded in the context builder). Counting
     // only the root turned every real documentation repository — README.md plus
     // the pages under `docs/` — into `generic`.
-    detect: (context) => context.markdownCount >= 3 && !hasFile(context, "package.json"),
+    detect: (context) => markdownEvidence(context),
     layers: [
       layer("content", "content/", "docs/"),
       layer("assets", "assets/", "static/", "public/"),
@@ -1835,7 +1863,10 @@ var SHAPE_PRESETS = [
   {
     name: "generic",
     priority: 0,
-    detect: () => true,
+    // No detector: this is the fallback, and `detectPresetFromContext` reaches it only
+    // when every other preset reported no evidence. `fallback: true` is what lets the
+    // wizard tell "I recognised this" apart from "I gave up".
+    fallback: true,
     layers: DEFAULT_LAYERS,
     kinds: DEFAULT_KINDS,
     exclude: [],
@@ -1867,20 +1898,27 @@ function detectPresetFromContext(context, forced) {
   if (forced !== void 0) {
     const preset = BY_NAME.get(forced);
     if (!preset) throw new Error(unknownPresetMessage(forced));
-    return toDetected(preset);
+    return toDetected(preset, null);
   }
   for (const preset of PRESETS) {
-    if (preset.detect(context)) return toDetected(preset);
+    const reason = preset.detect?.(context) ?? null;
+    if (reason !== null) return toDetected(preset, reason);
   }
-  return toDetected(PRESETS[PRESETS.length - 1]);
+  const fallback = PRESETS.find((preset) => preset.fallback === true);
+  if (fallback === void 0) {
+    throw new Error("No fallback preset is defined. Exactly one preset must set `fallback: true`.");
+  }
+  return toDetected(fallback, null, true);
 }
-function toDetected(preset) {
+function toDetected(preset, reason, fallback = false) {
   return {
     presetName: preset.name,
     layers: preset.layers,
     kinds: preset.kinds,
     exclude: preset.exclude ? [...preset.exclude] : [],
-    recommendedBudget: preset.recommendedBudget ?? null
+    recommendedBudget: preset.recommendedBudget ?? null,
+    reason,
+    fallback
   };
 }
 function detectPreset(cwd, forced) {
@@ -2320,14 +2358,14 @@ var PRESET_IGNORES = new Set(
 );
 function readLinkTarget(linkPath, fallback) {
   try {
-    return fs10.readlinkSync(linkPath);
+    return fs11.readlinkSync(linkPath);
   } catch {
     return fallback;
   }
 }
 function isInside(root, candidate) {
-  const relative6 = path11.relative(root, candidate);
-  return relative6 === "" || !relative6.startsWith(`..${path11.sep}`) && relative6 !== ".." && !path11.isAbsolute(relative6);
+  const relative7 = path12.relative(root, candidate);
+  return relative7 === "" || !relative7.startsWith(`..${path12.sep}`) && relative7 !== ".." && !path12.isAbsolute(relative7);
 }
 function getGitInfo(cwd, fallbackBranch = "main") {
   try {
@@ -2532,10 +2570,10 @@ function trimUnescapedTrailingSpaces(line) {
   return line.slice(0, end);
 }
 function readGitignoreRules(dir) {
-  const gitignorePath2 = path11.join(dir, ".gitignore");
+  const gitignorePath2 = path12.join(dir, ".gitignore");
   let raw;
   try {
-    raw = fs10.readFileSync(gitignorePath2, "utf8");
+    raw = fs11.readFileSync(gitignorePath2, "utf8");
   } catch {
     return [];
   }
@@ -2662,7 +2700,7 @@ function isToolOwnedDirName(name) {
 }
 function hasSnapshotMarker(target) {
   try {
-    return fs10.statSync(target).isDirectory() && fs10.existsSync(path11.join(target, ".codebase-snapshot"));
+    return fs11.statSync(target).isDirectory() && fs11.existsSync(path12.join(target, ".codebase-snapshot"));
   } catch {
     return false;
   }
@@ -2676,7 +2714,7 @@ function makeToolOwnedDecider(cwd, toolOwnedPaths) {
       const prefix = parts.slice(0, depth).join("/");
       let hasMarker = markers.get(prefix);
       if (hasMarker === void 0) {
-        hasMarker = fs10.existsSync(path11.join(cwd, prefix, ".codebase-snapshot"));
+        hasMarker = fs11.existsSync(path12.join(cwd, prefix, ".codebase-snapshot"));
         markers.set(prefix, hasMarker);
       }
       if (hasMarker) return true;
@@ -2691,7 +2729,7 @@ function makeLinkProbe() {
     let known = cache.get(absolutePath);
     if (known === void 0) {
       try {
-        known = fs10.lstatSync(absolutePath).isSymbolicLink();
+        known = fs11.lstatSync(absolutePath).isSymbolicLink();
       } catch {
         known = false;
       }
@@ -2704,7 +2742,7 @@ function dropLinkedDirectories(cwd, candidates, skipped) {
   const isLink = makeLinkProbe();
   let rootReal = cwd;
   try {
-    rootReal = fs10.realpathSync(cwd);
+    rootReal = fs11.realpathSync(cwd);
   } catch {
   }
   const reported = /* @__PURE__ */ new Set();
@@ -2714,7 +2752,7 @@ function dropLinkedDirectories(cwd, candidates, skipped) {
     let linkedDir = null;
     for (let depth = 1; depth <= parts.length; depth += 1) {
       const prefix = parts.slice(0, depth).join("/");
-      if (isLink(path11.join(cwd, prefix))) {
+      if (isLink(path12.join(cwd, prefix))) {
         linkedDir = prefix;
         break;
       }
@@ -2725,10 +2763,10 @@ function dropLinkedDirectories(cwd, candidates, skipped) {
     }
     if (reported.has(linkedDir)) continue;
     reported.add(linkedDir);
-    const absolute = path11.join(cwd, linkedDir);
+    const absolute = path12.join(cwd, linkedDir);
     let targetReal = absolute;
     try {
-      targetReal = fs10.realpathSync(absolute);
+      targetReal = fs11.realpathSync(absolute);
     } catch {
     }
     const target = readLinkTarget(absolute, targetReal);
@@ -2805,7 +2843,7 @@ function collectFiles(cwd, options = {}) {
           "Discovery mode is `git`, but git could not list this directory's files. Run inside a working repository, or pass --discovery walk (or auto) to scan the tree directly."
         );
       }
-      if (fs10.existsSync(path11.join(cwd, ".git"))) {
+      if (fs11.existsSync(path12.join(cwd, ".git"))) {
         throw new Error(
           "This directory is a git repository, but git could not list its files. A plain walk honours .gitignore files, but git also applies .git/info/exclude and your global excludes file, includes files that are tracked although a .gitignore now matches them, and treats a submodule as a single entry. Fix the repository (git status should work), run outside git, or pass --discovery walk to accept those differences."
         );
@@ -2864,7 +2902,7 @@ function collectFiles(cwd, options = {}) {
 }
 function rootRealFor(root) {
   try {
-    return fs10.realpathSync(root);
+    return fs11.realpathSync(root);
   } catch {
     return root;
   }
@@ -2872,18 +2910,18 @@ function rootRealFor(root) {
 function walkDirectory(dir, baseDir, rootReal, visited, reservedPaths = /* @__PURE__ */ new Set(), parentGitignoreLayers = []) {
   const results = { files: [], skipped: [] };
   const stack = [];
-  const relativeToBase = (target) => path11.relative(baseDir, target).replace(/\\/g, "/") || ".";
+  const relativeToBase = (target) => path12.relative(baseDir, target).replace(/\\/g, "/") || ".";
   const enter = (current, layers) => {
     if (visited.has(current)) return false;
     visited.add(current);
     const localRules = readGitignoreRules(current);
     const gitignoreLayers = localRules.length === 0 ? layers : [
       ...layers,
-      { prefix: path11.relative(baseDir, current).replace(/\\/g, "/"), rules: localRules }
+      { prefix: path12.relative(baseDir, current).replace(/\\/g, "/"), rules: localRules }
     ];
     let entries;
     try {
-      entries = fs10.readdirSync(current, { withFileTypes: true });
+      entries = fs11.readdirSync(current, { withFileTypes: true });
     } catch {
       results.skipped.push({
         path: relativeToBase(current),
@@ -2905,8 +2943,8 @@ function walkDirectory(dir, baseDir, rootReal, visited, reservedPaths = /* @__PU
     }
     const entry = frame.entries[frame.index];
     frame.index += 1;
-    const fullPath = path11.join(frame.dir, entry.name);
-    const relPath = path11.relative(baseDir, fullPath).replace(/\\/g, "/");
+    const fullPath = path12.join(frame.dir, entry.name);
+    const relPath = path12.relative(baseDir, fullPath).replace(/\\/g, "/");
     if (isToolOwnedDirName(entry.name) && reservedPaths.has(relPath)) continue;
     if (DEFAULT_IGNORED_DIRS.includes(entry.name)) {
       results.skipped.push({
@@ -2939,14 +2977,14 @@ function walkDirectory(dir, baseDir, rootReal, visited, reservedPaths = /* @__PU
     if (entry.isSymbolicLink()) {
       let targetReal;
       try {
-        targetReal = fs10.realpathSync(fullPath);
+        targetReal = fs11.realpathSync(fullPath);
       } catch {
         results.skipped.push({ path: relPath, reason: "read-error", detail: "broken symlink" });
         continue;
       }
       let stats;
       try {
-        stats = fs10.statSync(fullPath);
+        stats = fs11.statSync(fullPath);
       } catch {
         results.skipped.push({ path: relPath, reason: "read-error", detail: "unreadable symlink" });
         continue;
@@ -2999,6 +3037,20 @@ var CONFIG_FILENAMES = [
   ".snapshotrc.json",
   ".snapshotrc"
 ];
+function findConfigFile(cwd) {
+  for (const filename of CONFIG_FILENAMES) {
+    const fullPath = path12.join(cwd, filename);
+    if (fs11.existsSync(fullPath)) return fullPath;
+  }
+  const pkgJsonPath = path12.join(cwd, "package.json");
+  if (!fs11.existsSync(pkgJsonPath)) return null;
+  try {
+    const parsed = JSON.parse(fs11.readFileSync(pkgJsonPath, "utf8"));
+    return parsed.snapshot === void 0 ? null : pkgJsonPath;
+  } catch {
+    return null;
+  }
+}
 var RESOLVED_CONFIG_BRAND = /* @__PURE__ */ Symbol.for(
   "codebase-snapshot/resolved-config"
 );
@@ -3244,11 +3296,11 @@ async function loadConfigFileDetailed(cwd) {
   const warnings = [];
   const errors = [];
   for (const filename of CONFIG_FILENAMES) {
-    const fullPath = path11.join(cwd, filename);
-    if (!fs10.existsSync(fullPath)) continue;
+    const fullPath = path12.join(cwd, filename);
+    if (!fs11.existsSync(fullPath)) continue;
     if (filename.endsWith(".json") || filename === ".snapshotrc") {
       try {
-        const config = parseJsonish(fs10.readFileSync(fullPath, "utf8"), fullPath);
+        const config = parseJsonish(fs11.readFileSync(fullPath, "utf8"), fullPath);
         if (config === null || typeof config !== "object" || Array.isArray(config)) {
           throw new Error(
             `${fullPath} does not hold a configuration object (received ${describeValue2(config)}).`
@@ -3282,10 +3334,10 @@ async function loadConfigFileDetailed(cwd) {
       continue;
     }
   }
-  const pkgJsonPath = path11.join(cwd, "package.json");
-  if (fs10.existsSync(pkgJsonPath)) {
+  const pkgJsonPath = path12.join(cwd, "package.json");
+  if (fs11.existsSync(pkgJsonPath)) {
     try {
-      const parsed = parseJsonish(fs10.readFileSync(pkgJsonPath, "utf8"), pkgJsonPath);
+      const parsed = parseJsonish(fs11.readFileSync(pkgJsonPath, "utf8"), pkgJsonPath);
       const snapshotKey = parsed.snapshot;
       if (snapshotKey && typeof snapshotKey === "object" && !Array.isArray(snapshotKey)) {
         return { config: snapshotKey, file: pkgJsonPath, warnings, errors };
@@ -3308,7 +3360,7 @@ async function loadConfigFile(cwd) {
   const loaded = await loadConfigFileDetailed(cwd);
   if (loaded.config && loaded.file && typeof loaded.config === "object") {
     Object.defineProperty(loaded.config, CONFIG_DIR_SYMBOL, {
-      value: path11.dirname(loaded.file),
+      value: path12.dirname(loaded.file),
       enumerable: false,
       configurable: true
     });
@@ -3467,12 +3519,12 @@ function resolveKindRules(value) {
 function outputExcludePatterns(cwd, outDir, tmpDir) {
   const patterns = [];
   for (const dir of [outDir, tmpDir]) {
-    const absolute = path11.resolve(cwd, dir);
-    const relative6 = path11.relative(cwd, absolute);
-    if (!relative6 || relative6 === ".." || relative6.startsWith(`..${path11.sep}`) || path11.isAbsolute(relative6)) {
+    const absolute = path12.resolve(cwd, dir);
+    const relative7 = path12.relative(cwd, absolute);
+    if (!relative7 || relative7 === ".." || relative7.startsWith(`..${path12.sep}`) || path12.isAbsolute(relative7)) {
       continue;
     }
-    patterns.push(`${relative6.replace(/\\/g, "/")}/**`);
+    patterns.push(`${relative7.replace(/\\/g, "/")}/**`);
   }
   return patterns;
 }
@@ -3588,11 +3640,11 @@ function resolveCandidateCwd(userConfig, cliOptions, baseDir) {
     );
   }
   const candidate = cliOptions?.cwd || userConfig?.cwd || baseDir || process.cwd();
-  const resolved = path11.resolve(candidate);
-  if (!fs10.existsSync(resolved)) {
+  const resolved = path12.resolve(candidate);
+  if (!fs11.existsSync(resolved)) {
     throw new Error(`Working directory does not exist: ${resolved}`);
   }
-  if (!fs10.statSync(resolved).isDirectory()) {
+  if (!fs11.statSync(resolved).isDirectory()) {
     throw new Error(`Working directory is not a directory: ${resolved}`);
   }
   return resolved;
@@ -4616,7 +4668,7 @@ var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".so"
 ]);
 function isBinaryExtension(filePath) {
-  const ext = path11.extname(filePath).toLowerCase();
+  const ext = path12.extname(filePath).toLowerCase();
   return BINARY_EXTENSIONS.has(ext);
 }
 function isBinaryBuffer(buffer) {
@@ -4786,13 +4838,13 @@ function isBinaryFile(absolutePath) {
   if (isBinaryExtension(absolutePath)) return true;
   let fd;
   try {
-    fd = fs10.openSync(absolutePath, "r");
+    fd = fs11.openSync(absolutePath, "r");
     const buffer = Buffer.alloc(CHUNK);
     let sample;
     let position = 0;
     while (position < BINARY_SCAN_BYTES) {
       const wanted = Math.min(CHUNK, BINARY_SCAN_BYTES - position);
-      const bytesRead = fs10.readSync(fd, buffer, 0, wanted, position);
+      const bytesRead = fs11.readSync(fd, buffer, 0, wanted, position);
       if (bytesRead === 0) return false;
       const chunk = buffer.subarray(0, bytesRead);
       if (sample === void 0) {
@@ -4810,7 +4862,7 @@ function isBinaryFile(absolutePath) {
   } finally {
     if (fd !== void 0) {
       try {
-        fs10.closeSync(fd);
+        fs11.closeSync(fd);
       } catch {
       }
     }
@@ -4870,10 +4922,10 @@ var LANGUAGE_BY_BASENAME = {
 };
 function detectLanguage(filePath) {
   const normalized = filePath.replace(/\\/g, "/");
-  const base = path11.posix.basename(normalized);
+  const base = path12.posix.basename(normalized);
   if (LANGUAGE_BY_BASENAME[base]) return LANGUAGE_BY_BASENAME[base];
   if (base === ".env" || base.startsWith(".env.")) return "dotenv";
-  const ext = path11.posix.extname(base).toLowerCase();
+  const ext = path12.posix.extname(base).toLowerCase();
   return LANGUAGE_BY_EXTENSION[ext] ?? "text";
 }
 function maskedPath(value, secretRules) {
@@ -4881,33 +4933,33 @@ function maskedPath(value, secretRules) {
 }
 function confineToDirectory(directory, filename) {
   if (filename.includes("\0")) return null;
-  if (path11.isAbsolute(filename)) return null;
-  const base = path11.resolve(directory);
-  const resolved = path11.resolve(base, filename);
+  if (path12.isAbsolute(filename)) return null;
+  const base = path12.resolve(directory);
+  const resolved = path12.resolve(base, filename);
   const caseInsensitive = process.platform === "win32" || process.platform === "darwin";
-  const prefix = caseInsensitive ? `${base}${path11.sep}`.toLowerCase() : `${base}${path11.sep}`;
+  const prefix = caseInsensitive ? `${base}${path12.sep}`.toLowerCase() : `${base}${path12.sep}`;
   const candidate = caseInsensitive ? resolved.toLowerCase() : resolved;
   return candidate.startsWith(prefix) ? resolved : null;
 }
 function findStagingDirectory(config) {
-  const tmpDir = path11.resolve(config.cwd, config.tmpDir);
+  const tmpDir = path12.resolve(config.cwd, config.tmpDir);
   let entries;
   try {
-    entries = fs10.readdirSync(tmpDir);
+    entries = fs11.readdirSync(tmpDir);
   } catch {
     return null;
   }
   const runs = entries.filter((name) => name.startsWith("run-")).sort();
   const newest = runs[runs.length - 1];
-  return newest ? path11.join(tmpDir, newest) : null;
+  return newest ? path12.join(tmpDir, newest) : null;
 }
 function describeMissingManifest(config, manifestPath) {
-  const outDir = path11.resolve(config.cwd, config.outDir);
-  const markerPath = path11.join(outDir, ".codebase-snapshot");
+  const outDir = path12.resolve(config.cwd, config.outDir);
+  const markerPath = path12.join(outDir, ".codebase-snapshot");
   let marker2 = null;
   try {
-    if (fs10.existsSync(markerPath)) {
-      const parsed = JSON.parse(fs10.readFileSync(markerPath, "utf8"));
+    if (fs11.existsSync(markerPath)) {
+      const parsed = JSON.parse(fs11.readFileSync(markerPath, "utf8"));
       if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
         marker2 = parsed;
       }
@@ -4943,14 +4995,14 @@ function sha256Hex(buffer) {
 }
 var VERIFY_SNIFF_MAX_BYTES = 8 * 1024 * 1024;
 function wouldNowBeIncluded(cwd, relativePath, reason) {
-  const absolutePath = path11.join(cwd, relativePath);
+  const absolutePath = path12.join(cwd, relativePath);
   try {
-    const stats = fs10.statSync(absolutePath);
+    const stats = fs11.statSync(absolutePath);
     if (!stats.isFile()) return false;
     if (isBinaryFile(absolutePath)) return false;
     if (reason !== "binary") return true;
     if (stats.size > VERIFY_SNIFF_MAX_BYTES) return false;
-    return !decodeText(fs10.readFileSync(absolutePath)).binary;
+    return !decodeText(fs11.readFileSync(absolutePath)).binary;
   } catch {
     return false;
   }
@@ -5008,8 +5060,8 @@ function describeManifestShapeProblem(value) {
 function validateSnapshot(configInput) {
   assertUsableConfigInput(configInput);
   const config = isResolvedConfig(configInput) ? normalizeResolvedConfig(configInput) : resolveConfig(configInput);
-  const manifestPath = path11.resolve(config.cwd, config.outDir, "manifest.json");
-  if (!fs10.existsSync(manifestPath)) {
+  const manifestPath = path12.resolve(config.cwd, config.outDir, "manifest.json");
+  if (!fs11.existsSync(manifestPath)) {
     return {
       valid: false,
       manifestPresent: false,
@@ -5020,7 +5072,7 @@ function validateSnapshot(configInput) {
   }
   let manifest;
   try {
-    manifest = JSON.parse(fs10.readFileSync(manifestPath, "utf8"));
+    manifest = JSON.parse(fs11.readFileSync(manifestPath, "utf8"));
   } catch (err) {
     return {
       valid: false,
@@ -5042,7 +5094,7 @@ function validateSnapshot(configInput) {
   }
   const drift = emptyDrift();
   const warnings = [];
-  const snapshotDir = path11.resolve(config.cwd, config.outDir);
+  const snapshotDir = path12.resolve(config.cwd, config.outDir);
   const manifestFileMap = /* @__PURE__ */ new Map();
   for (const file of manifest.files) {
     if (file && typeof file.relativePath === "string") {
@@ -5076,7 +5128,7 @@ function validateSnapshot(configInput) {
     }
     let diskHash;
     try {
-      diskHash = sha256Hex(fs10.readFileSync(path11.join(config.cwd, diskFile)));
+      diskHash = sha256Hex(fs11.readFileSync(path12.join(config.cwd, diskFile)));
     } catch (err) {
       if (err.code === "ENOENT") {
         drift.missingOnDisk.push(diskFile);
@@ -5100,7 +5152,7 @@ function validateSnapshot(configInput) {
     }
     let statFailure = null;
     try {
-      fs10.statSync(confined);
+      fs11.statSync(confined);
     } catch (err) {
       statFailure = err;
     }
@@ -5120,7 +5172,7 @@ function validateSnapshot(configInput) {
     ...Object.values(config.budgets.byLayer)
   );
   const partNames = /* @__PURE__ */ new Set();
-  const partsDir = path11.join(snapshotDir, "parts");
+  const partsDir = path12.join(snapshotDir, "parts");
   for (const part of manifest.parts) {
     if (!part || typeof part.filename !== "string") continue;
     partNames.add(part.filename);
@@ -5135,7 +5187,7 @@ function validateSnapshot(configInput) {
     }
     let buffer;
     try {
-      buffer = fs10.readFileSync(partPath);
+      buffer = fs11.readFileSync(partPath);
     } catch {
       drift.partIssues.push({ part: part.filename, issue: "missing from snapshot/parts" });
       continue;
@@ -5349,9 +5401,9 @@ function validateSnapshot(configInput) {
     ["full-codebase.md", manifest.artifacts?.fullMarkdown]
   ]) {
     if (!artifact) continue;
-    const artifactPath = path11.join(snapshotDir, key);
+    const artifactPath = path12.join(snapshotDir, key);
     try {
-      const buffer = fs10.readFileSync(artifactPath);
+      const buffer = fs11.readFileSync(artifactPath);
       if (sha256Hex(buffer) !== artifact.sha256 || buffer.length !== artifact.byteSize) {
         drift.partIssues.push({ part: key, issue: "artifact does not match its recorded digest" });
       }
@@ -5421,7 +5473,7 @@ function validateSnapshot(configInput) {
 
 // src/version.ts
 var GENERATOR_NAME = "codebase-snapshot";
-var GENERATOR_VERSION = "0.9.1";
+var GENERATOR_VERSION = "0.9.4";
 var LEGACY_GENERATOR_NAMES = ["@ankurhalder/codebase-snapshot"];
 function isOurGeneratorName(name) {
   if (typeof name !== "string") return false;
@@ -5436,42 +5488,42 @@ function describeMatcher(matcher) {
   return String(matcher);
 }
 function normalizeTarget(cwd, target) {
-  const absolute = path11.resolve(cwd, target);
-  const relative6 = path11.relative(cwd, absolute);
-  if (relative6.startsWith("..") || path11.isAbsolute(relative6)) return target;
-  return relative6.split(path11.sep).join("/");
+  const absolute = path12.resolve(cwd, target);
+  const relative7 = path12.relative(cwd, absolute);
+  if (relative7.startsWith("..") || path12.isAbsolute(relative7)) return target;
+  return relative7.split(path12.sep).join("/");
 }
 function findRuleMatch(rules, relativePath) {
   return rules.find(
     (rule) => matchRule(relativePath, rule.match)
   );
 }
-function findRecordedAncestor(skipped, relative6, maskedPath2) {
+function findRecordedAncestor(skipped, relative7, maskedPath2) {
   let nearest;
   for (const record of skipped) {
     const ancestorPath = record.path;
     if (ancestorPath.length === 0) continue;
-    const isAncestor = relative6.startsWith(`${ancestorPath}/`) || maskedPath2.startsWith(`${ancestorPath}/`);
+    const isAncestor = relative7.startsWith(`${ancestorPath}/`) || maskedPath2.startsWith(`${ancestorPath}/`);
     if (!isAncestor) continue;
     if (!nearest || ancestorPath.length > nearest.path.length) nearest = record;
   }
   return nearest;
 }
 function readManifest2(config) {
-  const manifestPath = path11.resolve(config.cwd, config.outDir, "manifest.json");
+  const manifestPath = path12.resolve(config.cwd, config.outDir, "manifest.json");
   try {
-    return JSON.parse(fs10.readFileSync(manifestPath, "utf8"));
+    return JSON.parse(fs11.readFileSync(manifestPath, "utf8"));
   } catch {
     return null;
   }
 }
 function explainPath(config, target) {
-  const relative6 = normalizeTarget(config.cwd, target);
-  const absolute = path11.join(config.cwd, relative6);
-  const maskedPath2 = findSecretInPath(relative6, config.secretRules)?.masked ?? relative6;
+  const relative7 = normalizeTarget(config.cwd, target);
+  const absolute = path12.join(config.cwd, relative7);
+  const maskedPath2 = findSecretInPath(relative7, config.secretRules)?.masked ?? relative7;
   const result = {
     path: maskedPath2,
-    exists: fs10.existsSync(absolute),
+    exists: fs11.existsSync(absolute),
     included: false
   };
   const collection = collectFiles(config.cwd, {
@@ -5482,12 +5534,12 @@ function explainPath(config, target) {
     // Same exclusion `generate` applies, so `explain` never says "not-discovered" about a file
     // that is only missing because the walker dropped the tool's own output directory.
     toolOwnedPaths: [config.outDir, config.tmpDir].map(
-      (directory) => path11.relative(config.cwd, path11.resolve(config.cwd, directory)).replace(/\\/g, "/")
-    ).filter((relative7) => relative7.length > 0 && !relative7.startsWith(".."))
+      (directory) => path12.relative(config.cwd, path12.resolve(config.cwd, directory)).replace(/\\/g, "/")
+    ).filter((relative8) => relative8.length > 0 && !relative8.startsWith(".."))
   });
-  if (!collection.files.includes(relative6)) {
+  if (!collection.files.includes(relative7)) {
     const record = collection.skipped.find(
-      (entry2) => entry2.path === relative6 || entry2.path === maskedPath2
+      (entry2) => entry2.path === relative7 || entry2.path === maskedPath2
     );
     if (record) {
       result.reason = record.reason;
@@ -5496,7 +5548,7 @@ function explainPath(config, target) {
       result.reason = "missing";
       result.detail = "no such file or directory, relative to the configured cwd";
     } else {
-      const ancestor = findRecordedAncestor(collection.skipped, relative6, maskedPath2);
+      const ancestor = findRecordedAncestor(collection.skipped, relative7, maskedPath2);
       if (ancestor) {
         result.reason = ancestor.reason;
         result.detail = ancestor.detail ? `${ancestor.detail} \u2014 inherited from the skipped directory \`${ancestor.path}\`` : `inside the skipped directory \`${ancestor.path}\``;
@@ -5514,15 +5566,15 @@ function explainPath(config, target) {
     result.detail = "binary content; generate skips it and records `binary` in manifest.skipped[]";
     return result;
   }
-  result.layer = classifyLayer(relative6, config.layers);
-  result.kind = classifyKind(relative6, config.kinds);
-  result.language = detectLanguage(relative6);
-  const layerRule = findRuleMatch(config.layers, relative6);
+  result.layer = classifyLayer(relative7, config.layers);
+  result.kind = classifyKind(relative7, config.kinds);
+  result.language = detectLanguage(relative7);
+  const layerRule = findRuleMatch(config.layers, relative7);
   if (layerRule) result.layerMatch = describeMatcher(layerRule.match);
-  const kindRule = findRuleMatch(config.kinds, relative6);
+  const kindRule = findRuleMatch(config.kinds, relative7);
   if (kindRule) result.kindMatch = describeMatcher(kindRule.match);
-  if (fs10.existsSync(absolute) && fs10.statSync(absolute).isFile()) {
-    const buffer = fs10.readFileSync(absolute);
+  if (fs11.existsSync(absolute) && fs11.statSync(absolute).isFile()) {
+    const buffer = fs11.readFileSync(absolute);
     const decoded = decodeText(buffer);
     if (decoded.binary) {
       result.included = false;
@@ -5534,12 +5586,12 @@ function explainPath(config, target) {
     result.bytes = buffer.length;
     result.lines = countLines(text2);
     if (decoded.encoding !== "utf-8") result.encoding = decoded.encoding;
-    const { findings } = scanAndRedactSecrets(text2, config.secretRules, relative6);
+    const { findings } = scanAndRedactSecrets(text2, config.secretRules, relative7);
     result.secretCount = findings.length;
     result.secrets = findings.slice(0, 20).map((finding) => ({ rules: finding.rules, line: finding.line }));
   }
   const manifest = readManifest2(config);
-  const entry = Array.isArray(manifest?.files) ? manifest.files.find((file) => file.relativePath === relative6) : void 0;
+  const entry = Array.isArray(manifest?.files) ? manifest.files.find((file) => file.relativePath === relative7) : void 0;
   result.part = entry?.part ?? null;
   result.inclusionMode = entry?.inclusionMode;
   return result;
@@ -5770,14 +5822,14 @@ function compareManifests(before, after) {
 function loadManifest(target) {
   let isDirectory;
   try {
-    isDirectory = fs10.statSync(target).isDirectory();
+    isDirectory = fs11.statSync(target).isDirectory();
   } catch {
     throw new Error(`No snapshot found at ${target}: the path does not exist.`);
   }
-  const manifestPath = isDirectory ? path11.join(target, "manifest.json") : target;
+  const manifestPath = isDirectory ? path12.join(target, "manifest.json") : target;
   let raw;
   try {
-    raw = fs10.readFileSync(manifestPath, "utf8");
+    raw = fs11.readFileSync(manifestPath, "utf8");
   } catch {
     throw new Error(`Could not read a manifest at ${manifestPath}.`);
   }
@@ -5834,15 +5886,15 @@ function renderDiffText(diff) {
 function appendGitignoreEntries(cwd, entries) {
   const wanted = [...new Set(entries)].filter((entry) => entry.trim().length > 0);
   if (wanted.length === 0) return { added: [], note: null };
-  const ignorePath = path11.join(cwd, ".gitignore");
+  const ignorePath = path12.join(cwd, ".gitignore");
   const manual = `Add ${wanted.map((entry) => `"${entry}"`).join(" and ")} to your .gitignore yourself.`;
   let existing = "";
   try {
-    if (fs10.existsSync(ignorePath)) {
-      if (fs10.statSync(ignorePath).isDirectory()) {
+    if (fs11.existsSync(ignorePath)) {
+      if (fs11.statSync(ignorePath).isDirectory()) {
         return { added: [], note: `${ignorePath} is a directory, so it was not updated. ${manual}` };
       }
-      existing = fs10.readFileSync(ignorePath, "utf8");
+      existing = fs11.readFileSync(ignorePath, "utf8");
     }
   } catch (err) {
     return {
@@ -5855,7 +5907,7 @@ function appendGitignoreEntries(cwd, entries) {
   if (added.length === 0) return { added: [], note: null };
   const prefix = existing.length === 0 || existing.endsWith("\n") ? "" : "\n";
   try {
-    fs10.writeFileSync(ignorePath, `${existing}${prefix}${added.join("\n")}
+    fs11.writeFileSync(ignorePath, `${existing}${prefix}${added.join("\n")}
 `, "utf8");
   } catch (err) {
     return { added: [], note: `${err.message}. ${manual}` };
@@ -5863,7 +5915,7 @@ function appendGitignoreEntries(cwd, entries) {
   return { added, note: null };
 }
 function gitignorePath(cwd, filePath) {
-  return path11.relative(cwd, filePath).split(path11.sep).join("/");
+  return path12.relative(cwd, filePath).split(path12.sep).join("/");
 }
 
 // src/wizard/config-template.ts
@@ -6251,10 +6303,10 @@ var CONFIG_CANDIDATES = [
 ];
 function chooseConfigFileName(cwd) {
   if (!supportsTypeScriptImports()) return "snapshot.config.mjs";
-  const pkgPath = path11.join(cwd, "package.json");
-  if (!fs10.existsSync(pkgPath)) return "snapshot.config.mjs";
+  const pkgPath = path12.join(cwd, "package.json");
+  if (!fs11.existsSync(pkgPath)) return "snapshot.config.mjs";
   try {
-    const parsed = JSON.parse(fs10.readFileSync(pkgPath, "utf8"));
+    const parsed = JSON.parse(fs11.readFileSync(pkgPath, "utf8"));
     return parsed.type === "module" ? "snapshot.config.ts" : "snapshot.config.mjs";
   } catch {
     return "snapshot.config.mjs";
@@ -6268,7 +6320,7 @@ var SIZE_CHOICES = [
 ];
 function packageJsonHasConfig(cwd) {
   try {
-    const parsed = JSON.parse(fs10.readFileSync(path11.join(cwd, "package.json"), "utf8"));
+    const parsed = JSON.parse(fs11.readFileSync(path12.join(cwd, "package.json"), "utf8"));
     return typeof parsed.snapshot === "object" && parsed.snapshot !== null && !Array.isArray(parsed.snapshot);
   } catch {
     return false;
@@ -6289,7 +6341,7 @@ function artifactAnswers(options) {
 }
 function topLevelDirs(cwd) {
   try {
-    return fs10.readdirSync(cwd, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules").map((entry) => entry.name).sort();
+    return fs11.readdirSync(cwd, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules").map((entry) => entry.name).sort();
   } catch {
     return [];
   }
@@ -6302,7 +6354,7 @@ function describeJsonValue(value) {
 }
 function writeFileOrExplain(target, content) {
   try {
-    fs10.writeFileSync(target, content, "utf8");
+    fs11.writeFileSync(target, content, "utf8");
   } catch (err) {
     const code = err.code;
     const reason = code === "EACCES" || code === "EPERM" || code === "EROFS" ? `permission denied (${code})` : code === "EISDIR" ? "it is a directory" : `${err.message}`;
@@ -6313,7 +6365,7 @@ function canWriteModuleConfig(name, cwd) {
   if (name.endsWith(".mjs") || name.endsWith(".ts")) return true;
   if (!name.endsWith(".js")) return false;
   try {
-    const parsed = JSON.parse(fs10.readFileSync(path11.join(cwd, "package.json"), "utf8"));
+    const parsed = JSON.parse(fs11.readFileSync(path12.join(cwd, "package.json"), "utf8"));
     return parsed.type === "module";
   } catch {
     return false;
@@ -6348,19 +6400,19 @@ function serializePackageJson(raw, value) {
   return `${text2}${raw.endsWith("\n") ? crlf ? "\r\n" : "\n" : ""}`;
 }
 function updatePackageJson(cwd, notes) {
-  const packagePath = path11.join(cwd, "package.json");
+  const packagePath = path12.join(cwd, "package.json");
   const unchanged = {
     scripts: [],
     dependency: { name: GENERATOR_NAME, range: null, added: false }
   };
-  if (!fs10.existsSync(packagePath)) {
+  if (!fs11.existsSync(packagePath)) {
     notes.push("No package.json found, so npm scripts and the devDependency were not added.");
     return unchanged;
   }
   let raw;
   let parsed;
   try {
-    raw = fs10.readFileSync(packagePath, "utf8");
+    raw = fs11.readFileSync(packagePath, "utf8");
     parsed = JSON.parse(raw);
   } catch {
     notes.push("Could not parse package.json; npm scripts and the devDependency were not added.");
@@ -6423,16 +6475,18 @@ function updatePackageJson(cwd, notes) {
   return { scripts: added, dependency };
 }
 var GITIGNORE_ENTRIES = ["snapshot/", "snapshot.tmp/"];
-function resolvePresetChoice(answers, presetName) {
+function resolvePresetChoice(detectedName, presetName) {
   return {
     value: presetName,
     label: presetName,
-    hint: presetName === answers.preset ? "detected" : void 0
+    hint: presetName === detectedName ? "detected" : void 0
   };
 }
 async function runInit(options) {
   const io = options.io ?? defaultIO();
   const detected = detectPreset(options.cwd, options.preset);
+  let reason = detected.reason;
+  let fallback = detected.fallback;
   const notes = [];
   const answers = {
     preset: detected.presetName,
@@ -6454,117 +6508,148 @@ async function runInit(options) {
   if (interactive) {
     io.output.write("\n  codebase-snapshot\n");
     io.output.write("  Turn this repository into an LLM-ready, redacted, byte-bounded snapshot.\n\n");
-    io.output.write(`  Detected   ${detected.presetName}
+    if (fallback) {
+      io.output.write("  \u26A0 Could not tell what kind of project this is.\n");
+      io.output.write("    No package.json, go.mod, Cargo.toml, pyproject.toml, Gemfile,\n");
+      io.output.write("    composer.json, pom.xml, *.csproj, next.config.*, vite.config.*, *.tf\n");
+      io.output.write("    or workspace marker was found here.\n\n");
+    } else {
+      io.output.write(`  Detected   ${detected.presetName}
+`);
+      io.output.write(`  Because    ${reason}
+
 `);
+    }
     io.output.write(`  Directory  ${options.cwd}
 
 `);
-    const useDetected = await confirm(io, `Set up for ${detected.presetName}?`, {
-      defaultValue: true
+    const paceChoices = fallback ? [
+      { value: "choose", label: "Pick the closest preset", hint: "then generate with the defaults" },
+      { value: "recommended", label: "Use the defaults", hint: "generic \xB7 everything the scanner finds" },
+      { value: "walk", label: "Go through each setting", hint: "every question starts on its default" }
+    ] : [
+      {
+        value: "recommended",
+        label: "Use the recommended setup",
+        hint: `${detected.presetName} \xB7 config \xB7 npm scripts \xB7 install \xB7 generate`
+      },
+      { value: "walk", label: "Go through each setting", hint: "every question starts on its default" },
+      { value: "choose", label: "Pick a different preset", hint: "everything else stays at the defaults" }
+    ];
+    const pace = await select(io, "How should I set this up?", paceChoices, {
+      defaultValue: fallback ? "choose" : "recommended"
     });
-    if (!useDetected) {
+    if (pace === "choose") {
       answers.preset = await select(
         io,
         "What kind of project is this?",
-        listPresetNames().map((name) => resolvePresetChoice(answers, name))
+        listPresetNames().map(
+          (name) => resolvePresetChoice(fallback ? null : detected.presetName, name)
+        ),
+        { defaultValue: answers.preset }
       );
       const chosen = detectPreset(options.cwd, answers.preset);
       answers.preset = chosen.presetName;
+      reason = null;
+      fallback = false;
     }
-    const scope = await select(
-      io,
-      "What should go into the snapshot?",
-      [
-        { value: "all", label: "Everything the scanner finds", hint: "recommended \xB7 respects .gitignore" },
-        { value: "folders", label: "Only specific folders\u2026" },
-        { value: "no-tests", label: "Everything, but skip tests" },
-        { value: "custom", label: "Let me write glob patterns" }
-      ],
-      { defaultValue: "all" }
-    );
-    if (scope === "folders") {
-      const dirs = topLevelDirs(options.cwd).slice(0, 40);
-      if (dirs.length === 0) {
-        notes.push("No top-level directories found; the snapshot will include everything.");
+    if (pace === "walk") {
+      const scope = await select(
+        io,
+        "What should go into the snapshot?",
+        [
+          { value: "all", label: "Everything the scanner finds", hint: "recommended \xB7 respects .gitignore" },
+          { value: "folders", label: "Only specific folders\u2026" },
+          { value: "no-tests", label: "Everything, but skip tests" },
+          { value: "custom", label: "Let me write glob patterns" }
+        ],
+        { defaultValue: "all" }
+      );
+      if (scope === "folders") {
+        const dirs = topLevelDirs(options.cwd).slice(0, 40);
+        if (dirs.length === 0) {
+          notes.push("No top-level directories found; the snapshot will include everything.");
+        } else {
+          const chosen = await multiSelect(
+            io,
+            "Select folders",
+            dirs.map((name) => ({ value: name, label: `${name}/` })),
+            { defaults: dirs }
+          );
+          answers.include = chosen.map((name) => `${name}/**`);
+        }
+      } else if (scope === "no-tests") {
+        answers.excludePatterns = [
+          ...answers.excludePatterns,
+          "**/*.test.*",
+          "**/*.spec.*",
+          "tests",
+          "test"
+        ];
+      } else if (scope === "custom") {
+        const raw = await text(io, "Glob patterns to include (comma separated)", {
+          defaultValue: ""
+        });
+        answers.include = raw.split(",").map((value) => value.trim()).filter(Boolean);
+      }
+      const currentBudget = String(answers.maxPartBytes);
+      const sizeChoice = await select(io, "How large should each part be?", SIZE_CHOICES, {
+        defaultValue: SIZE_CHOICES.some((choice) => choice.value === currentBudget) ? currentBudget : "120k"
+      });
+      if (sizeChoice === "custom") {
+        const raw = await text(io, "Part size (e.g. 150k, 1.5mb, 900000)", {
+          defaultValue: String(answers.maxPartBytes),
+          validate: (value) => parseByteSize(value) === void 0 ? "Not a valid size." : null
+        });
+        answers.maxPartBytes = parseByteSize(raw) ?? answers.maxPartBytes;
       } else {
-        const chosen = await multiSelect(
-          io,
-          "Select folders",
-          dirs.map((name) => ({ value: name, label: `${name}/` })),
-          { defaults: dirs }
-        );
-        answers.include = chosen.map((name) => `${name}/**`);
+        answers.maxPartBytes = sizeChoice;
       }
-    } else if (scope === "no-tests") {
-      answers.excludePatterns = [
-        ...answers.excludePatterns,
-        "**/*.test.*",
-        "**/*.spec.*",
-        "tests",
-        "test"
+      const artifactChoices = [
+        { value: "readme", label: "README.md", hint: "orientation page" },
+        { value: "manifest", label: "manifest.json", hint: "required by validate and report" },
+        { value: "parts", label: "parts/", hint: "the code payload" },
+        { value: "navigation", label: "reports/navigation.md", hint: "file \u2192 part index" },
+        { value: "projectTree", label: "reports/project-tree.md", hint: "ASCII tree" },
+        { value: "audit", label: "reports/audit.md", hint: "security and health findings" },
+        { value: "monolith", label: "full-codebase.json + .md", hint: "roughly doubles output" }
       ];
-    } else if (scope === "custom") {
-      const raw = await text(io, "Glob patterns to include (comma separated)", {
-        defaultValue: ""
-      });
-      answers.include = raw.split(",").map((value) => value.trim()).filter(Boolean);
-    }
-    const sizeChoice = await select(io, "How large should each part be?", SIZE_CHOICES, {
-      defaultValue: "120k"
-    });
-    if (sizeChoice === "custom") {
-      const raw = await text(io, "Part size (e.g. 150k, 1.5mb, 900000)", {
-        defaultValue: String(answers.maxPartBytes),
-        validate: (value) => parseByteSize(value) === void 0 ? "Not a valid size." : null
-      });
-      answers.maxPartBytes = parseByteSize(raw) ?? answers.maxPartBytes;
-    } else {
-      answers.maxPartBytes = sizeChoice;
-    }
-    const artifactChoices = [
-      { value: "readme", label: "README.md", hint: "orientation page" },
-      { value: "manifest", label: "manifest.json", hint: "required by validate and report" },
-      { value: "parts", label: "parts/", hint: "the code payload" },
-      { value: "navigation", label: "reports/navigation.md", hint: "file \u2192 part index" },
-      { value: "projectTree", label: "reports/project-tree.md", hint: "ASCII tree" },
-      { value: "audit", label: "reports/audit.md", hint: "security and health findings" },
-      { value: "monolith", label: "full-codebase.json + .md", hint: "roughly doubles output" }
-    ];
-    const presetEnabled = ARTIFACT_NAMES.filter((name) => answers.artifacts[name]);
-    const selectedArtifacts = await multiSelect(
-      io,
-      "Which artifacts should be generated?",
-      artifactChoices,
-      { defaults: presetEnabled }
-    );
-    for (const name of ARTIFACT_NAMES) answers.artifacts[name] = selectedArtifacts.includes(name);
-    const enabledCount = ARTIFACT_NAMES.filter((name) => answers.artifacts[name]).length;
-    answers.includeSensitiveFiles = await confirm(
-      io,
-      "Include credential files (.env, *.pem, .npmrc, .ssh/)?",
-      { defaultValue: false }
-    );
-    io.output.write("\n  Review\n\n");
-    io.output.write(`  project          ${answers.preset}
+      const presetEnabled = ARTIFACT_NAMES.filter((name) => answers.artifacts[name]);
+      const selectedArtifacts = await multiSelect(
+        io,
+        "Which artifacts should be generated?",
+        artifactChoices,
+        { defaults: presetEnabled }
+      );
+      for (const name of ARTIFACT_NAMES) answers.artifacts[name] = selectedArtifacts.includes(name);
+      const enabledCount = ARTIFACT_NAMES.filter((name) => answers.artifacts[name]).length;
+      answers.includeSensitiveFiles = await confirm(
+        io,
+        "Include credential files (.env, *.pem, .npmrc, .ssh/)?",
+        { defaultValue: false }
+      );
+      io.output.write("\n  Review\n\n");
+      io.output.write(`  project          ${answers.preset}
 `);
-    io.output.write(`  include          ${answers.include.length ? answers.include.join(", ") : "everything"}
+      io.output.write(`  include          ${answers.include.length ? answers.include.join(", ") : "everything"}
 `);
-    io.output.write(`  part size        ${String(answers.maxPartBytes)}
+      io.output.write(`  part size        ${String(answers.maxPartBytes)}
 `);
-    io.output.write(`  artifacts        ${enabledCount} of ${ARTIFACT_NAMES.length}
+      io.output.write(`  artifacts        ${enabledCount} of ${ARTIFACT_NAMES.length}
 `);
-    io.output.write(`  credentials      ${answers.includeSensitiveFiles ? "included" : "skipped"}
+      io.output.write(`  credentials      ${answers.includeSensitiveFiles ? "included" : "skipped"}
 
 `);
-    io.output.write("  Will write snapshot.config with your answers, plus every other setting\n");
-    io.output.write("  at its default \u2014 so nothing is hidden behind the docs.\n\n");
-    const proceed = await confirm(io, "Write this and continue?", { defaultValue: true });
-    if (!proceed) throw new PromptCancelled();
+      io.output.write("  Will write snapshot.config with your answers, plus every other setting\n");
+      io.output.write("  at its default \u2014 so nothing is hidden behind the docs.\n\n");
+      const proceed = await confirm(io, "Write this and continue?", { defaultValue: true });
+      if (!proceed) throw new PromptCancelled();
+    }
   }
   const configText = renderConfig(answers);
   const preferredName = chooseConfigFileName(options.cwd);
   const presentConfigs = CONFIG_CANDIDATES.filter(
-    (name) => fs10.existsSync(path11.join(options.cwd, name))
+    (name) => fs11.existsSync(path12.join(options.cwd, name))
   );
   const present = presentConfigs[0] ?? null;
   if (presentConfigs.length > 1) {
@@ -6573,7 +6658,7 @@ async function runInit(options) {
     );
   }
   const configName = present !== null && options.force ? present : preferredName;
-  const configPath = path11.join(options.cwd, configName);
+  const configPath = path12.join(options.cwd, configName);
   const reused = present !== null && options.force !== true && options.reuseConfig === true;
   if (reused) notes.push(`Kept the existing ${present} instead of writing a new one.`);
   if (options.dryRun) {
@@ -6583,6 +6668,8 @@ async function runInit(options) {
       written: false,
       reused,
       preset: answers.preset,
+      reason,
+      fallback,
       scripts: [],
       gitignoreEntries: [],
       dependency: { name: GENERATOR_NAME, range: `^${GENERATOR_VERSION}`, added: false },
@@ -6604,7 +6691,7 @@ async function runInit(options) {
       'package.json already defines a "snapshot" config. Remove that key, or re-run with --force to write a config file that takes precedence over it.'
     );
   }
-  if (fs10.existsSync(configPath) && !options.force && !reused) {
+  if (fs11.existsSync(configPath) && !options.force && !reused) {
     throw new Error(`${configName} already exists. Re-run with --force to replace it.`);
   }
   if (!reused) writeFileOrExplain(configPath, configText);
@@ -6617,12 +6704,56 @@ async function runInit(options) {
     written: true,
     reused,
     preset: answers.preset,
+    reason,
+    fallback,
     scripts,
     gitignoreEntries: ignore.added,
     dependency,
     notes
   };
 }
+function describeTarget(cwd) {
+  const relative7 = path12.relative(process.cwd(), cwd);
+  if (relative7 === "") return "this directory";
+  if (relative7.startsWith("..") || path12.isAbsolute(relative7)) return cwd;
+  return relative7;
+}
+function firstRunMessage(reason, cwd) {
+  const where = describeTarget(cwd);
+  if (reason === "empty") {
+    return `Nothing to snapshot: ${where} has no files. Run this inside the repository you want to snapshot, or pass --cwd.`;
+  }
+  return `No configuration found in ${where} and this session is not interactive, so nothing was generated.
+Choose one:
+  ${GENERATOR_NAME} --autopilot     detect the project, set it up and generate, no questions
+  ${GENERATOR_NAME} init --yes      write a config from the detected defaults, then generate
+  ${GENERATOR_NAME} init            write a config interactively`;
+}
+function planFirstRun(facts) {
+  if (facts.emptyTarget) return { action: "refuse", exitCode: 1, reason: "empty" };
+  if (facts.autopilot) return { action: "setup", interactive: false };
+  if (facts.hasConfig || facts.hasPriorSnapshot) return { action: "generate" };
+  if (facts.interactive) return { action: "setup", interactive: true };
+  return { action: "refuse", exitCode: 2, reason: "undecided" };
+}
+var NOT_CONTENT = /* @__PURE__ */ new Set([".git", ".hg", ".svn", ".bzr", ".DS_Store", "Thumbs.db"]);
+function isEffectivelyEmpty(cwd) {
+  try {
+    return fs11.readdirSync(cwd).every((entry) => NOT_CONTENT.has(entry));
+  } catch {
+    return false;
+  }
+}
+function hasPriorSnapshot(cwd, outDir) {
+  let parsed;
+  try {
+    parsed = JSON.parse(fs11.readFileSync(path12.join(cwd, outDir, ".codebase-snapshot"), "utf8"));
+  } catch {
+    return false;
+  }
+  if (parsed === null || typeof parsed !== "object") return false;
+  return isOurGeneratorName(parsed.generator);
+}
 
 // src/index.ts
 var SCHEMA_VERSION = "3.0.0";
@@ -6704,13 +6835,13 @@ function buildImportResolver(files) {
     const relativePath = file.relativePath;
     remember(byPath, relativePath, relativePath);
     remember(byPathFolded, relativePath.toLowerCase(), relativePath);
-    const extension = path11.posix.extname(relativePath);
+    const extension = path12.posix.extname(relativePath);
     if (!SOURCE_EXTENSIONS.has(extension)) continue;
     const stem = relativePath.slice(0, -extension.length);
     remember(byStem, stem, relativePath);
     remember(byStemFolded, stem.toLowerCase(), relativePath);
-    if (path11.posix.basename(stem) === "index") {
-      const directory = path11.posix.dirname(stem);
+    if (path12.posix.basename(stem) === "index") {
+      const directory = path12.posix.dirname(stem);
       remember(byStem, directory, relativePath);
       remember(byStemFolded, directory.toLowerCase(), relativePath);
     }
@@ -6719,8 +6850,8 @@ function buildImportResolver(files) {
 }
 function resolveSpecifier(fromFile, specifier, resolver) {
   if (!RELATIVE_SPECIFIER.test(specifier)) return null;
-  const joined = path11.posix.normalize(
-    path11.posix.join(path11.posix.dirname(fromFile), specifier)
+  const joined = path12.posix.normalize(
+    path12.posix.join(path12.posix.dirname(fromFile), specifier)
   );
   const exact = (key) => resolver.byPath.get(key) ?? resolver.byPathFolded.get(key.toLowerCase()) ?? null;
   const direct = exact(joined);
@@ -6813,11 +6944,11 @@ function verifyInMemory(files, parts, maxPartBytes) {
   return errors;
 }
 function resolveSafeOutputDirs(config) {
-  const cwd = path11.resolve(config.cwd);
-  const outDir = path11.resolve(cwd, config.outDir);
-  const tmpDir = path11.resolve(cwd, config.tmpDir);
-  const root = path11.parse(cwd).root;
-  const contains = (parent, child) => child === parent || child.startsWith(`${parent}${path11.sep}`);
+  const cwd = path12.resolve(config.cwd);
+  const outDir = path12.resolve(cwd, config.outDir);
+  const tmpDir = path12.resolve(cwd, config.tmpDir);
+  const root = path12.parse(cwd).root;
+  const contains = (parent, child) => child === parent || child.startsWith(`${parent}${path12.sep}`);
   const reject = (reason) => {
     throw new Error(
       `Refusing to generate: ${reason}. outDir=${outDir} tmpDir=${tmpDir} cwd=${cwd}`
@@ -6873,14 +7004,14 @@ function listEntries(dir) {
   const walk = (absolute, prefix) => {
     let children;
     try {
-      children = fs10.readdirSync(absolute, { withFileTypes: true });
+      children = fs11.readdirSync(absolute, { withFileTypes: true });
     } catch {
       return;
     }
     for (const child of children) {
-      const relative6 = prefix === "" ? child.name : `${prefix}/${child.name}`;
-      entries.push(relative6);
-      if (child.isDirectory()) walk(path11.join(absolute, child.name), relative6);
+      const relative7 = prefix === "" ? child.name : `${prefix}/${child.name}`;
+      entries.push(relative7);
+      if (child.isDirectory()) walk(path12.join(absolute, child.name), relative7);
     }
   };
   walk(dir, "");
@@ -6897,28 +7028,28 @@ function markerPayload(dir, state, id, createdAt) {
     pid: process.pid,
     entries: listEntries(dir)
   };
-  const manifestPath = path11.join(dir, "manifest.json");
-  if (fs10.existsSync(manifestPath)) {
-    marker2.manifestSha256 = sha256Hex2(fs10.readFileSync(manifestPath));
+  const manifestPath = path12.join(dir, "manifest.json");
+  if (fs11.existsSync(manifestPath)) {
+    marker2.manifestSha256 = sha256Hex2(fs11.readFileSync(manifestPath));
   }
   return marker2;
 }
 function writeOwnershipMarker(dir, marker2) {
-  fs10.writeFileSync(
-    path11.join(dir, OWNERSHIP_MARKER),
+  fs11.writeFileSync(
+    path12.join(dir, OWNERSHIP_MARKER),
     `${JSON.stringify(marker2, null, 2)}
 `,
     "utf8"
   );
 }
 function readOwnershipMarker(dir) {
-  const markerPath = path11.join(dir, OWNERSHIP_MARKER);
-  if (!fs10.existsSync(markerPath)) {
+  const markerPath = path12.join(dir, OWNERSHIP_MARKER);
+  if (!fs11.existsSync(markerPath)) {
     return { marker: null, problem: "it holds no .codebase-snapshot marker" };
   }
   let raw;
   try {
-    raw = fs10.readFileSync(markerPath, "utf8");
+    raw = fs11.readFileSync(markerPath, "utf8");
   } catch {
     return { marker: null, problem: "its .codebase-snapshot marker could not be read" };
   }
@@ -6986,11 +7117,11 @@ function assessSnapshotDirectory(dir) {
       marker: marker2
     };
   }
-  const manifestPath = path11.join(dir, "manifest.json");
-  if (fs10.existsSync(manifestPath)) {
+  const manifestPath = path12.join(dir, "manifest.json");
+  if (fs11.existsSync(manifestPath)) {
     let raw;
     try {
-      raw = fs10.readFileSync(manifestPath, "utf8");
+      raw = fs11.readFileSync(manifestPath, "utf8");
     } catch {
       return {
         owned: false,
@@ -7072,13 +7203,13 @@ function containsNoFiles(dir) {
     const current = pending.pop();
     let entries;
     try {
-      entries = fs10.readdirSync(current, { withFileTypes: true });
+      entries = fs11.readdirSync(current, { withFileTypes: true });
     } catch {
       return false;
     }
     for (const entry of entries) {
       if (entry.isDirectory()) {
-        pending.push(path11.join(current, entry.name));
+        pending.push(path12.join(current, entry.name));
       } else if (!IGNORABLE_ENTRIES.has(entry.name)) {
         return false;
       }
@@ -7087,13 +7218,13 @@ function containsNoFiles(dir) {
   return true;
 }
 function assertReplaceable(target, label, secretRules) {
-  if (!fs10.existsSync(target)) return;
-  if (!fs10.statSync(target).isDirectory()) {
+  if (!fs11.existsSync(target)) return;
+  if (!fs11.statSync(target).isDirectory()) {
     throw new Error(
       `Refusing to write into ${label} ${target}: it exists but is not a directory.`
     );
   }
-  const entries = fs10.readdirSync(target);
+  const entries = fs11.readdirSync(target);
   if (entries.length === 0) return;
   if (entries.every((name) => IGNORABLE_ENTRIES.has(name))) return;
   if (containsNoFiles(target)) return;
@@ -7113,18 +7244,18 @@ function assertReplaceable(target, label, secretRules) {
   );
 }
 function assertStagingRootUsable(tmpDir, secretRules) {
-  if (!fs10.existsSync(tmpDir)) return;
-  if (!fs10.statSync(tmpDir).isDirectory()) {
+  if (!fs11.existsSync(tmpDir)) return;
+  if (!fs11.statSync(tmpDir).isDirectory()) {
     throw new Error(`Refusing to write into tmpDir ${tmpDir}: it exists but is not a directory.`);
   }
-  const entries = fs10.readdirSync(tmpDir);
+  const entries = fs11.readdirSync(tmpDir);
   if (entries.length === 0) return;
   const foreign = entries.filter((name) => {
-    const full = path11.join(tmpDir, name);
+    const full = path12.join(tmpDir, name);
     if (!name.startsWith(RUN_DIR_PREFIX)) return true;
     let stats;
     try {
-      stats = fs10.statSync(full);
+      stats = fs11.statSync(full);
     } catch {
       return true;
     }
@@ -7132,7 +7263,7 @@ function assertStagingRootUsable(tmpDir, secretRules) {
     const { marker: marker2 } = readOwnershipMarker(full);
     if (marker2) return false;
     try {
-      return fs10.readdirSync(full).length > 0;
+      return fs11.readdirSync(full).length > 0;
     } catch {
       return true;
     }
@@ -7147,13 +7278,13 @@ function assertStagingRootUsable(tmpDir, secretRules) {
 function cleanStaleRunDirs(tmpDir) {
   let entries;
   try {
-    entries = fs10.readdirSync(tmpDir);
+    entries = fs11.readdirSync(tmpDir);
   } catch {
     return;
   }
   for (const name of entries) {
     if (!name.startsWith(RUN_DIR_PREFIX)) continue;
-    const full = path11.join(tmpDir, name);
+    const full = path12.join(tmpDir, name);
     const { marker: marker2 } = readOwnershipMarker(full);
     if (marker2) {
       const created = Date.parse(marker2.createdAt);
@@ -7161,33 +7292,33 @@ function cleanStaleRunDirs(tmpDir) {
       const abandoned = typeof marker2.pid === "number" && !isProcessAlive(marker2.pid);
       if (aged || abandoned) {
         try {
-          fs10.rmSync(full, { recursive: true, force: true });
+          fs11.rmSync(full, { recursive: true, force: true });
         } catch {
         }
       }
       continue;
     }
     try {
-      if (fs10.readdirSync(full).length === 0) fs10.rmSync(full, { recursive: true, force: true });
+      if (fs11.readdirSync(full).length === 0) fs11.rmSync(full, { recursive: true, force: true });
     } catch {
     }
   }
 }
 function removeIfEmpty(dir) {
   try {
-    if (fs10.readdirSync(dir).length === 0) fs10.rmSync(dir, { recursive: true, force: true });
+    if (fs11.readdirSync(dir).length === 0) fs11.rmSync(dir, { recursive: true, force: true });
   } catch {
   }
 }
 function ensureParentDirectory(target, label) {
-  const parent = path11.dirname(target);
-  if (fs10.existsSync(parent) && !fs10.statSync(parent).isDirectory()) {
+  const parent = path12.dirname(target);
+  if (fs11.existsSync(parent) && !fs11.statSync(parent).isDirectory()) {
     throw new Error(
       `Refusing to create ${label} ${target}: ${parent} exists but is not a directory.`
     );
   }
   try {
-    fs10.mkdirSync(parent, { recursive: true });
+    fs11.mkdirSync(parent, { recursive: true });
   } catch (err) {
     throw new Error(
       `Refusing to create ${label} ${target}: its parent ${parent} could not be created (${err.message}).`
@@ -7196,7 +7327,7 @@ function ensureParentDirectory(target, label) {
 }
 function acquireRunLock(stagingRoot) {
   const key = lockKeyFor(stagingRoot);
-  const lockPath = path11.join(os.tmpdir(), `codebase-snapshot-${key}.lock`);
+  const lockPath = path12.join(os.tmpdir(), `codebase-snapshot-${key}.lock`);
   const payload = `${JSON.stringify({
     pid: process.pid,
     stagingRoot,
@@ -7205,22 +7336,22 @@ function acquireRunLock(stagingRoot) {
 `;
   for (let attempt = 0; attempt < 2; attempt += 1) {
     try {
-      const handle = fs10.openSync(lockPath, "wx");
+      const handle = fs11.openSync(lockPath, "wx");
       try {
-        fs10.writeSync(handle, payload);
+        fs11.writeSync(handle, payload);
       } finally {
-        fs10.closeSync(handle);
+        fs11.closeSync(handle);
       }
       return () => {
         try {
-          fs10.rmSync(lockPath, { force: true });
+          fs11.rmSync(lockPath, { force: true });
         } catch {
         }
       };
     } catch (err) {
       if (err.code !== "EEXIST") throw err;
       if (attempt === 0 && lockOwnerIsGone(lockPath)) {
-        fs10.rmSync(lockPath, { force: true });
+        fs11.rmSync(lockPath, { force: true });
         continue;
       }
       throw new Error(
@@ -7233,7 +7364,7 @@ function acquireRunLock(stagingRoot) {
 function lockKeyFor(stagingRoot) {
   let key = stagingRoot;
   try {
-    key = fs10.realpathSync(stagingRoot);
+    key = fs11.realpathSync(stagingRoot);
   } catch {
   }
   if (process.platform === "win32" || process.platform === "darwin") key = key.toLowerCase();
@@ -7242,7 +7373,7 @@ function lockKeyFor(stagingRoot) {
 function lockOwnerIsGone(lockPath) {
   let raw;
   try {
-    raw = fs10.readFileSync(lockPath, "utf8");
+    raw = fs11.readFileSync(lockPath, "utf8");
   } catch {
     return false;
   }
@@ -7262,12 +7393,12 @@ function lockOwnerIsGone(lockPath) {
 }
 function writeManifestAtomically(manifestPath, manifest) {
   const tempPath = `${manifestPath}.${process.pid}.tmp`;
-  fs10.writeFileSync(tempPath, JSON.stringify(manifest, null, 2), "utf8");
+  fs11.writeFileSync(tempPath, JSON.stringify(manifest, null, 2), "utf8");
   try {
-    fs10.renameSync(tempPath, manifestPath);
+    fs11.renameSync(tempPath, manifestPath);
   } catch (err) {
     try {
-      fs10.rmSync(tempPath, { force: true });
+      fs11.rmSync(tempPath, { force: true });
     } catch {
     }
     throw err;
@@ -7290,31 +7421,31 @@ function swapIntoPlace(stagingDir, outDir) {
 }
 function swapOnce(stagingDir, outDir) {
   const backupDir = `${outDir}.backup-${process.pid}-${Date.now()}`;
-  const hadPrevious = fs10.existsSync(outDir);
-  if (hadPrevious) fs10.renameSync(outDir, backupDir);
+  const hadPrevious = fs11.existsSync(outDir);
+  if (hadPrevious) fs11.renameSync(outDir, backupDir);
   try {
     try {
-      fs10.renameSync(stagingDir, outDir);
+      fs11.renameSync(stagingDir, outDir);
     } catch (err) {
       if (err.code !== "EXDEV") throw err;
       const partialDir = `${outDir}.partial-${process.pid}-${Date.now()}`;
       try {
-        fs10.cpSync(stagingDir, partialDir, { recursive: true });
-        fs10.renameSync(partialDir, outDir);
-        fs10.rmSync(stagingDir, { recursive: true, force: true });
+        fs11.cpSync(stagingDir, partialDir, { recursive: true });
+        fs11.renameSync(partialDir, outDir);
+        fs11.rmSync(stagingDir, { recursive: true, force: true });
       } catch (copyErr) {
         try {
-          fs10.rmSync(partialDir, { recursive: true, force: true });
+          fs11.rmSync(partialDir, { recursive: true, force: true });
         } catch {
         }
         throw copyErr;
       }
     }
-    if (hadPrevious) fs10.rmSync(backupDir, { recursive: true, force: true });
+    if (hadPrevious) fs11.rmSync(backupDir, { recursive: true, force: true });
   } catch (err) {
-    if (hadPrevious && fs10.existsSync(backupDir)) {
-      if (fs10.existsSync(outDir)) fs10.rmSync(outDir, { recursive: true, force: true });
-      fs10.renameSync(backupDir, outDir);
+    if (hadPrevious && fs11.existsSync(backupDir)) {
+      if (fs11.existsSync(outDir)) fs11.rmSync(outDir, { recursive: true, force: true });
+      fs11.renameSync(backupDir, outDir);
     }
     throw err;
   }
@@ -7409,8 +7540,8 @@ function generateSnapshot(configInput, options) {
     // first run cannot have marked them yet, so the name alone keeps a run from recording its own
     // output — but only at these exact paths, not at every directory that shares the name.
     toolOwnedPaths: [config.outDir, config.tmpDir].map(
-      (directory) => path11.relative(config.cwd, path11.resolve(config.cwd, directory)).replace(/\\/g, "/")
-    ).filter((relative6) => relative6.length > 0 && !relative6.startsWith(".."))
+      (directory) => path12.relative(config.cwd, path12.resolve(config.cwd, directory)).replace(/\\/g, "/")
+    ).filter((relative7) => relative7.length > 0 && !relative7.startsWith(".."))
   });
   const files = [];
   const monolithBodies = /* @__PURE__ */ new Map();
@@ -7430,12 +7561,12 @@ function generateSnapshot(configInput, options) {
   let totalSizeBytes = 0;
   let largeFileCount = 0;
   for (const relativePath of collection.files) {
-    const absolutePath = path11.join(config.cwd, relativePath);
+    const absolutePath = path12.join(config.cwd, relativePath);
     let stats;
     try {
-      stats = fs10.statSync(absolutePath);
+      stats = fs11.statSync(absolutePath);
       if (!stats.isFile()) {
-        const nestedRepository = stats.isDirectory() && fs10.existsSync(path11.join(absolutePath, ".git"));
+        const nestedRepository = stats.isDirectory() && fs11.existsSync(path12.join(absolutePath, ".git"));
         skipped.push(
           nestedRepository ? {
             path: relativePath,
@@ -7455,7 +7586,7 @@ function generateSnapshot(configInput, options) {
     }
     let buffer;
     try {
-      buffer = fs10.readFileSync(absolutePath);
+      buffer = fs11.readFileSync(absolutePath);
     } catch {
       skipped.push({ path: relativePath, reason: "read-error" });
       continue;
@@ -7785,12 +7916,12 @@ function generateSnapshot(configInput, options) {
   let stagingDir = null;
   try {
     ensureParentDirectory(outDir, "outDir");
-    fs10.mkdirSync(tmpDir, { recursive: true });
+    fs11.mkdirSync(tmpDir, { recursive: true });
     cleanStaleRunDirs(tmpDir);
     const snapshotId = crypto.randomUUID();
     const createdAt = (/* @__PURE__ */ new Date()).toISOString();
-    stagingDir = path11.join(tmpDir, `${RUN_DIR_PREFIX}${process.pid}-${snapshotId.slice(0, 8)}`);
-    fs10.mkdirSync(stagingDir);
+    stagingDir = path12.join(tmpDir, `${RUN_DIR_PREFIX}${process.pid}-${snapshotId.slice(0, 8)}`);
+    fs11.mkdirSync(stagingDir);
     writeOwnershipMarker(stagingDir, {
       generator: GENERATOR_NAME,
       version: GENERATOR_VERSION,
@@ -7800,41 +7931,41 @@ function generateSnapshot(configInput, options) {
       id: snapshotId,
       pid: process.pid
     });
-    const partsDir = path11.join(stagingDir, "parts");
-    const reportsDir = path11.join(stagingDir, "reports");
-    if (artifacts.parts) fs10.mkdirSync(partsDir, { recursive: true });
+    const partsDir = path12.join(stagingDir, "parts");
+    const reportsDir = path12.join(stagingDir, "reports");
+    if (artifacts.parts) fs11.mkdirSync(partsDir, { recursive: true });
     if (artifacts.navigation || artifacts.projectTree || artifacts.audit) {
-      fs10.mkdirSync(reportsDir, { recursive: true });
+      fs11.mkdirSync(reportsDir, { recursive: true });
     }
     if (artifacts.parts) {
       for (const part of parts) {
-        fs10.writeFileSync(path11.join(partsDir, part.filename), part.markdown, "utf8");
+        fs11.writeFileSync(path12.join(partsDir, part.filename), part.markdown, "utf8");
       }
     }
     if (projectTree !== null) {
-      fs10.writeFileSync(path11.join(reportsDir, "project-tree.md"), projectTree, "utf8");
+      fs11.writeFileSync(path12.join(reportsDir, "project-tree.md"), projectTree, "utf8");
     }
     if (artifacts.navigation) {
-      fs10.writeFileSync(path11.join(reportsDir, "navigation.md"), generateNavigation(manifest), "utf8");
+      fs11.writeFileSync(path12.join(reportsDir, "navigation.md"), generateNavigation(manifest), "utf8");
     }
     if (artifacts.audit) {
-      fs10.writeFileSync(
-        path11.join(reportsDir, "audit.md"),
+      fs11.writeFileSync(
+        path12.join(reportsDir, "audit.md"),
         generateAuditReport(manifest, secretFindings, config.secretRules),
         "utf8"
       );
     }
     if (artifacts.readme) {
-      fs10.writeFileSync(path11.join(stagingDir, "README.md"), generateReadme(manifest, artifacts), "utf8");
+      fs11.writeFileSync(path12.join(stagingDir, "README.md"), generateReadme(manifest, artifacts), "utf8");
     }
     if (artifacts.manifest) {
-      fs10.writeFileSync(path11.join(stagingDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
+      fs11.writeFileSync(path12.join(stagingDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
     }
     if (monolithJson !== null) {
-      fs10.writeFileSync(path11.join(stagingDir, "full-codebase.json"), monolithJson, "utf8");
+      fs11.writeFileSync(path12.join(stagingDir, "full-codebase.json"), monolithJson, "utf8");
     }
     if (monolithMarkdown !== null) {
-      fs10.writeFileSync(path11.join(stagingDir, "full-codebase.md"), monolithMarkdown, "utf8");
+      fs11.writeFileSync(path12.join(stagingDir, "full-codebase.md"), monolithMarkdown, "utf8");
     }
     writeOwnershipMarker(stagingDir, markerPayload(stagingDir, "complete", snapshotId, createdAt));
     swapIntoPlace(stagingDir, outDir);
@@ -7843,7 +7974,7 @@ function generateSnapshot(configInput, options) {
     const pendingHook = runAfterGenerate(config, manifest);
     const shipHookState = () => {
       if (artifacts.manifest && manifest.warnings.length !== warningsBeforeHook) {
-        writeManifestAtomically(path11.join(outDir, "manifest.json"), manifest);
+        writeManifestAtomically(path12.join(outDir, "manifest.json"), manifest);
       }
       writeOwnershipMarker(outDir, markerPayload(outDir, "complete", snapshotId, createdAt));
     };
@@ -7866,7 +7997,7 @@ function generateSnapshot(configInput, options) {
   } catch (err) {
     if (stagingDir !== null) {
       try {
-        fs10.rmSync(stagingDir, { recursive: true, force: true });
+        fs11.rmSync(stagingDir, { recursive: true, force: true });
       } catch {
       }
     }
@@ -7880,6 +8011,6 @@ async function generateSnapshotAsync(configInput, options) {
   return generateSnapshot(configInput, options);
 }
 
-export { ARTIFACT_NAMES, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, GENERATOR_NAME, GENERATOR_VERSION, LANGUAGE_PROFILES, MIN_MAX_PART_BYTES, PRESETS, PromptCancelled, SCHEMA_VERSION, anchorForPath, appendGitignoreEntries, assertReplaceable, assertUsableConfigInput, collectFiles, compareManifests, countInvalidUtf8Bytes, countLines, decodeText, defineConfig, describeManifestShapeProblem, detectLanguage, detectPreset, escapeControls, explainPath, fenceForContent, fenceForText, formatNumber, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, gitignorePath, globToRegExp, isBinaryBuffer, isBinaryExtension, isBinaryFile, isDiscoveryMode, isInteractive, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, profileForPath, renderConfig, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, unknownPresetMessage, validateSnapshot };
-//# sourceMappingURL=chunk-HT7J3NWT.js.map
-//# sourceMappingURL=chunk-HT7J3NWT.js.map
+export { ARTIFACT_NAMES, DEFAULT_ANSWERS, DEFAULT_SECRET_PATTERNS, GENERATOR_NAME, GENERATOR_VERSION, LANGUAGE_PROFILES, MIN_MAX_PART_BYTES, PRESETS, PromptCancelled, SCHEMA_VERSION, anchorForPath, appendGitignoreEntries, assertReplaceable, assertUsableConfigInput, collectFiles, compareManifests, countInvalidUtf8Bytes, countLines, decodeText, defaultIO, defineConfig, describeManifestShapeProblem, detectLanguage, detectPreset, escapeControls, explainPath, fenceForContent, fenceForText, findConfigFile, firstRunMessage, formatNumber, generateProjectTree, generateSnapshot, generateSnapshotAsync, getPreset, gitignorePath, globToRegExp, hasPriorSnapshot, isBinaryBuffer, isBinaryExtension, isBinaryFile, isDiscoveryMode, isEffectivelyEmpty, isInteractive, isResolvedConfig, isSensitivePath, listPresetNames, loadConfigFile, loadConfigFileDetailed, loadManifest, markResolvedConfig, matchRule, matchesExclude, normalizeResolvedConfig, parseByteSize, partitionFiles, planFirstRun, profileForPath, renderConfig, renderDiffText, renderExplainText, renumberParts, resolveConfig, resolveSafeOutputDirs, runInit, scanAndRedactSecrets, stripJsonComments, summarizeJson, summarizeMarkdown, summarizeTypeScriptSource, summarizeWithProfile, supportsTypeScriptImports, truncatePreview, truncateToBytes, unknownPresetMessage, validateSnapshot };
+//# sourceMappingURL=chunk-FCWD4LY7.js.map
+//# sourceMappingURL=chunk-FCWD4LY7.js.map