@ankurhalder/codebase-snapshot 2.0.0 → 2.1.1

package/dist/bin.js

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 
 // src/cli.ts
-import * as fs9 from "fs";
-import * as path10 from "path";
+import * as fs10 from "fs";
+import * as path11 from "path";
 import { parseArgs } from "util";
 
 // src/diff.ts
@@ -52,7 +52,13 @@ function compareManifests(before, after) {
   };
 }
 function loadManifest(target) {
-  const manifestPath = fs.statSync(target).isDirectory() ? path.join(target, "manifest.json") : target;
+  let isDirectory;
+  try {
+    isDirectory = fs.statSync(target).isDirectory();
+  } catch {
+    throw new Error(`No snapshot found at ${target}: the path does not exist.`);
+  }
+  const manifestPath = isDirectory ? path.join(target, "manifest.json") : target;
   let raw;
   try {
     raw = fs.readFileSync(manifestPath, "utf8");
@@ -68,6 +74,9 @@ function loadManifest(target) {
   if (!parsed || !Array.isArray(parsed.files)) {
     throw new Error(`${manifestPath} is not a snapshot manifest (no "files" array).`);
   }
+  if (!parsed.counts || typeof parsed.counts !== "object") {
+    throw new Error(`${manifestPath} is not a snapshot manifest (no "counts" object).`);
+  }
   return parsed;
 }
 function renderDiffText(diff) {
@@ -100,9 +109,141 @@ import * as fs4 from "fs";
 import * as path4 from "path";
 import { pathToFileURL } from "url";
 
-// src/presets/index.ts
+// src/presets/context.ts
 import * as fs2 from "fs";
 import * as path2 from "path";
+var MANIFEST_FILES = [
+  "package.json",
+  "pyproject.toml",
+  "requirements.txt",
+  "setup.py",
+  "go.mod",
+  "Cargo.toml",
+  "pom.xml",
+  "build.gradle",
+  "build.gradle.kts",
+  "composer.json",
+  "Gemfile"
+];
+var MANIFEST_MAX_BYTES = 1e5;
+function readManifest(cwd, name) {
+  const full = path2.join(cwd, name);
+  try {
+    const stats = fs2.statSync(full);
+    if (!stats.isFile() || stats.size > MANIFEST_MAX_BYTES) return null;
+    return fs2.readFileSync(full, "utf8");
+  } catch {
+    return null;
+  }
+}
+function collectDependencies(manifests) {
+  const names = /* @__PURE__ */ new Set();
+  const raw = manifests["package.json"];
+  if (!raw) return names;
+  try {
+    const parsed = JSON.parse(raw);
+    for (const section of ["dependencies", "devDependencies", "peerDependencies", "optionalDependencies"]) {
+      const block = parsed[section];
+      if (block && typeof block === "object") {
+        for (const name of Object.keys(block)) names.add(name);
+      }
+    }
+  } catch {
+  }
+  return names;
+}
+function buildPresetContext(cwd) {
+  const files = /* @__PURE__ */ new Set();
+  const dirs = /* @__PURE__ */ new Set();
+  try {
+    for (const entry of fs2.readdirSync(cwd, { withFileTypes: true })) {
+      if (entry.isDirectory()) dirs.add(entry.name);
+      else if (entry.isFile()) files.add(entry.name);
+    }
+  } catch {
+  }
+  const manifests = {};
+  for (const name of MANIFEST_FILES) {
+    const content = readManifest(cwd, name);
+    if (content !== null) manifests[name] = content;
+  }
+  return {
+    cwd,
+    files,
+    dirs,
+    dependencies: collectDependencies(manifests),
+    manifests
+  };
+}
+function hasFile(context, name) {
+  return context.files.has(name);
+}
+function hasFileStartingWith(context, prefix) {
+  for (const file of context.files) {
+    if (file.startsWith(prefix)) return true;
+  }
+  return false;
+}
+function manifestContains(context, manifest, needle) {
+  const content = context.manifests[manifest];
+  if (!content) return false;
+  return content.toLowerCase().includes(needle.toLowerCase());
+}
+function hasDependency(context, ...names) {
+  return names.some((name) => context.dependencies.has(name));
+}
+
+// src/presets/helpers.ts
+function layer(name, ...prefixes) {
+  return {
+    name,
+    match: (filePath) => prefixes.some((prefix) => filePath.startsWith(prefix))
+  };
+}
+function kindOf(name, ...needles) {
+  return {
+    kind: name,
+    match: (filePath) => needles.some((needle) => filePath.includes(needle))
+  };
+}
+function suffixKind(name, ...suffixes) {
+  return {
+    kind: name,
+    match: (filePath) => suffixes.some((suffix) => filePath.endsWith(suffix))
+  };
+}
+function commonLayers() {
+  return [
+    layer("scripts", "scripts/", "tools/"),
+    layer("docs", "docs/", "documentation/"),
+    {
+      name: "config",
+      match: (filePath) => filePath.startsWith(".github/") || filePath.startsWith(".husky/") || filePath.startsWith(".vscode/") || filePath.startsWith(".") || filePath.includes("config")
+    },
+    { name: "root", match: (filePath) => !filePath.includes("/") }
+  ];
+}
+function commonKinds() {
+  return [
+    {
+      kind: "test",
+      match: (filePath) => {
+        const lower = filePath.toLowerCase();
+        return lower.includes(".test.") || lower.includes(".spec.") || lower.startsWith("test/") || lower.startsWith("tests/") || lower.includes("_test.") || lower.endsWith("_test.go") || lower.includes("__tests__");
+      }
+    },
+    suffixKind("doc", ".md", ".mdx", ".rst", ".txt"),
+    suffixKind("data", ".json", ".yaml", ".yml", ".csv", ".toml"),
+    {
+      kind: "script",
+      match: (filePath) => filePath.startsWith("scripts/") || /\.(sh|ps1|bat)$/i.test(filePath)
+    },
+    {
+      kind: "config",
+      match: (filePath) => filePath.startsWith(".") || filePath.includes("config") || filePath === "package.json" || filePath === "tsconfig.json"
+    }
+  ];
+}
 
 // src/presets/nextjs.ts
 var NEXTJS_LAYERS = [
@@ -159,6 +300,47 @@ var NEXTJS_KINDS = [
   }
 ];
 
+// src/presets/node.ts
+var NODE_LAYERS = [
+  { name: "core", match: (p) => p.startsWith("src/core/") || p.startsWith("core/") },
+  { name: "protocols", match: (p) => p.startsWith("src/protocols/") || p.startsWith("protocols/") },
+  { name: "providers", match: (p) => p.startsWith("src/providers/") || p.startsWith("providers/") },
+  { name: "security", match: (p) => p.startsWith("src/security/") || p.startsWith("security/") },
+  { name: "db", match: (p) => p.startsWith("src/db/") || p.startsWith("db/") || p.startsWith("prisma/") },
+  { name: "api", match: (p) => p.startsWith("src/api/") || p.startsWith("api/") || p.startsWith("routes/") },
+  { name: "services", match: (p) => p.startsWith("src/services/") || p.startsWith("services/") },
+  { name: "controllers", match: (p) => p.startsWith("src/controllers/") || p.startsWith("controllers/") },
+  { name: "scripts", match: (p) => p.startsWith("scripts/") },
+  { name: "docs", match: (p) => p.startsWith("docs/") },
+  {
+    name: "config",
+    match: (p) => p.startsWith(".github/") || p.startsWith(".husky/") || p.startsWith(".") || p.includes("config")
+  },
+  { name: "root", match: (p) => !p.includes("/") }
+];
+var NODE_KINDS = [
+  { kind: "test", match: (p) => /\.(test|spec)\.[jt]sx?$/.test(p.toLowerCase()) },
+  { kind: "route", match: (p) => p.includes("/routes/") || p.includes("route.") || p.includes("/api/") },
+  { kind: "controller", match: (p) => p.includes("controller") },
+  { kind: "service", match: (p) => p.includes("service") },
+  { kind: "provider", match: (p) => p.includes("provider") },
+  { kind: "model", match: (p) => p.includes("model") || p.includes("entity") },
+  { kind: "schema", match: (p) => p.includes("schema") || p.includes("zod") || p.includes("dto") },
+  { kind: "type", match: (p) => p.endsWith(".d.ts") || p.includes("types.") || p.includes("type.") },
+  { kind: "security", match: (p) => p.includes("auth") || p.includes("security") || p.includes("guard") },
+  { kind: "db", match: (p) => p.includes("db") || p.includes("database") || p.includes("migration") },
+  { kind: "data", match: (p) => p.endsWith(".json") || p.endsWith(".csv") },
+  { kind: "doc", match: (p) => p.endsWith(".md") || p.endsWith(".mdx") },
+  { kind: "script", match: (p) => p.startsWith("scripts/") || p.endsWith(".sh") || p.endsWith(".ps1") },
+  {
+    kind: "config",
+    match: (p) => {
+      const base = p.split("/").pop() || "";
+      return ["package.json", "tsconfig.json", "Dockerfile"].includes(base) || base.startsWith(".");
+    }
+  }
+];
+
 // src/presets/vite.ts
 var VITE_LAYERS = [
   { name: "pages", match: (p) => p.startsWith("src/pages/") || p.startsWith("src/views/") },
@@ -206,44 +388,419 @@ var VITE_KINDS = [
   }
 ];
 
-// src/presets/node.ts
-var NODE_LAYERS = [
-  { name: "core", match: (p) => p.startsWith("src/core/") || p.startsWith("core/") },
-  { name: "protocols", match: (p) => p.startsWith("src/protocols/") || p.startsWith("protocols/") },
-  { name: "providers", match: (p) => p.startsWith("src/providers/") || p.startsWith("providers/") },
-  { name: "security", match: (p) => p.startsWith("src/security/") || p.startsWith("security/") },
-  { name: "db", match: (p) => p.startsWith("src/db/") || p.startsWith("db/") || p.startsWith("prisma/") },
-  { name: "api", match: (p) => p.startsWith("src/api/") || p.startsWith("api/") || p.startsWith("routes/") },
-  { name: "services", match: (p) => p.startsWith("src/services/") || p.startsWith("services/") },
-  { name: "controllers", match: (p) => p.startsWith("src/controllers/") || p.startsWith("controllers/") },
-  { name: "scripts", match: (p) => p.startsWith("scripts/") },
-  { name: "docs", match: (p) => p.startsWith("docs/") },
+// src/presets/js-presets.ts
+var NEXT_LIKE_EXCLUDES = [".svelte-kit", ".astro", ".vite", ".output"];
+var JS_PRESETS = [
   {
-    name: "config",
-    match: (p) => p.startsWith(".github/") || p.startsWith(".husky/") || p.startsWith(".") || p.includes("config")
+    name: "nextjs",
+    priority: 100,
+    detect: (context) => hasFileStartingWith(context, "next.config") || hasDependency(context, "next"),
+    layers: NEXTJS_LAYERS,
+    kinds: NEXTJS_KINDS,
+    exclude: NEXT_LIKE_EXCLUDES,
+    recommendedBudget: "300k"
   },
-  { name: "root", match: (p) => !p.includes("/") }
+  {
+    name: "nuxt",
+    priority: 98,
+    detect: (context) => hasFileStartingWith(context, "nuxt.config") || hasDependency(context, "nuxt", "nuxt3"),
+    layers: [
+      layer("pages", "pages/", "src/pages/"),
+      layer("components", "components/", "src/components/"),
+      layer("composables", "composables/", "src/composables/"),
+      layer("server", "server/", "src/server/", "api/"),
+      layer("stores", "stores/", "src/stores/"),
+      layer("layouts", "layouts/", "src/layouts/"),
+      ...commonLayers()
+    ],
+    kinds: [
+      kindOf("api-route", "server/api/", "server/routes/"),
+      suffixKind("component", ".vue"),
+      kindOf("composable", "composables/"),
+      kindOf("store", "stores/", "store/"),
+      kindOf("layout", "layouts/"),
+      ...commonKinds()
+    ],
+    exclude: [".nuxt", ".output"],
+    recommendedBudget: "200k"
+  },
+  {
+    name: "sveltekit",
+    priority: 96,
+    detect: (context) => hasFileStartingWith(context, "svelte.config") || hasDependency(context, "@sveltejs/kit", "svelte"),
+    layers: [
+      layer("routes", "src/routes/", "routes/"),
+      layer("lib", "src/lib/", "lib/"),
+      layer("components", "src/lib/components/", "src/components/"),
+      layer("stores", "src/lib/stores/", "src/stores/"),
+      ...commonLayers()
+    ],
+    kinds: [
+      kindOf("route", "+page.", "+server.", "+layout."),
+      suffixKind("component", ".svelte"),
+      kindOf("store", "stores/"),
+      kindOf("params", "params/"),
+      ...commonKinds()
+    ],
+    exclude: [".svelte-kit", ".vercel"],
+    recommendedBudget: "200k"
+  },
+  {
+    name: "remix",
+    priority: 94,
+    detect: (context) => hasDependency(context, "@remix-run/react", "@remix-run/node", "@remix-run/dev"),
+    layers: [
+      layer("routes", "app/routes/", "routes/"),
+      layer("components", "app/components/"),
+      layer("lib", "app/lib/", "app/utils/"),
+      ...commonLayers()
+    ],
+    kinds: [kindOf("route", "routes/"), ...commonKinds()],
+    exclude: [".cache", "public/build"],
+    recommendedBudget: "200k"
+  },
+  {
+    name: "astro",
+    priority: 92,
+    detect: (context) => hasFileStartingWith(context, "astro.config") || hasDependency(context, "astro"),
+    layers: [
+      layer("pages", "src/pages/"),
+      layer("layouts", "src/layouts/"),
+      layer("components", "src/components/"),
+      layer("content", "src/content/"),
+      ...commonLayers()
+    ],
+    kinds: [suffixKind("page", ".astro"), kindOf("layout", "layouts/"), ...commonKinds()],
+    exclude: [".astro", "dist"],
+    recommendedBudget: "150k"
+  },
+  {
+    name: "angular",
+    priority: 90,
+    detect: (context) => hasFile(context, "angular.json") || hasDependency(context, "@angular/core"),
+    layers: [
+      layer("app", "src/app/"),
+      layer("features", "src/app/features/"),
+      layer("shared", "src/app/shared/"),
+      layer("core", "src/app/core/"),
+      layer("assets", "src/assets/"),
+      ...commonLayers()
+    ],
+    kinds: [
+      suffixKind("component", ".component.ts"),
+      suffixKind("service", ".service.ts"),
+      suffixKind("module", ".module.ts"),
+      suffixKind("guard", ".guard.ts"),
+      suffixKind("pipe", ".pipe.ts"),
+      suffixKind("directive", ".directive.ts"),
+      ...commonKinds()
+    ],
+    exclude: [".angular", "dist"],
+    recommendedBudget: "200k"
+  },
+  {
+    name: "solid",
+    priority: 88,
+    detect: (context) => hasDependency(context, "solid-js", "solid-start"),
+    layers: [
+      layer("pages", "src/routes/", "src/pages/"),
+      layer("components", "src/components/"),
+      ...commonLayers()
+    ],
+    kinds: [kindOf("route", "routes/"), ...commonKinds()],
+    exclude: [".solid", "dist"],
+    recommendedBudget: "120k"
+  },
+  {
+    name: "vue-vite",
+    priority: 86,
+    detect: (context) => hasDependency(context, "vue") && (hasDependency(context, "vite") || hasFileStartingWith(context, "vite.config")),
+    layers: [
+      layer("pages", "src/pages/", "src/views/"),
+      layer("components", "src/components/"),
+      layer("composables", "src/composables/", "src/hooks/"),
+      layer("stores", "src/stores/", "src/store/"),
+      layer("services", "src/services/", "src/api/"),
+      layer("shared", "src/shared/", "src/common/"),
+      layer("styles", "src/styles/", "src/assets/"),
+      ...commonLayers()
+    ],
+    kinds: [
+      suffixKind("component", ".vue"),
+      kindOf("composable", "composables/", "use"),
+      kindOf("store", "stores/", "store/"),
+      kindOf("service", "services/", "api/"),
+      suffixKind("style", ".css", ".scss", ".sass", ".less"),
+      ...commonKinds()
+    ],
+    exclude: [".vite", "dist"],
+    recommendedBudget: "120k"
+  },
+  {
+    name: "react-vite",
+    priority: 84,
+    detect: (context) => hasDependency(context, "react") && (hasDependency(context, "vite") || hasFileStartingWith(context, "vite.config")),
+    layers: VITE_LAYERS,
+    kinds: VITE_KINDS,
+    exclude: [".vite", "dist"],
+    recommendedBudget: "120k"
+  },
+  {
+    name: "nest",
+    priority: 80,
+    detect: (context) => hasDependency(context, "@nestjs/core"),
+    layers: [
+      layer("modules", "src/modules/", "modules/"),
+      layer("controllers", "src/controllers/", "controllers/"),
+      layer("providers", "src/providers/", "providers/"),
+      layer("core", "src/core/"),
+      layer("security", "src/security/", "src/auth/"),
+      layer("db", "src/db/", "src/database/", "prisma/"),
+      ...commonLayers()
+    ],
+    kinds: [
+      suffixKind("controller", ".controller.ts"),
+      suffixKind("service", ".service.ts"),
+      suffixKind("module", ".module.ts"),
+      suffixKind("guard", ".guard.ts"),
+      suffixKind("dto", ".dto.ts"),
+      suffixKind("entity", ".entity.ts"),
+      kindOf("migration", "migrations/"),
+      ...commonKinds()
+    ],
+    exclude: ["dist", "node_modules"],
+    recommendedBudget: "200k"
+  },
+  {
+    name: "node-express",
+    priority: 78,
+    detect: (context) => hasDependency(context, "express", "fastify", "koa", "@hapi/hapi"),
+    layers: NODE_LAYERS,
+    kinds: NODE_KINDS,
+    exclude: ["dist"],
+    recommendedBudget: "200k"
+  },
+  {
+    name: "node-lib",
+    // 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"),
+    layers: [
+      layer("src", "src/"),
+      layer("lib", "lib/"),
+      layer("test", "test/", "tests/", "__tests__/"),
+      ...commonLayers()
+    ],
+    kinds: [suffixKind("type", ".d.ts"), ...commonKinds()],
+    exclude: ["dist"],
+    recommendedBudget: "120k"
+  }
 ];
-var NODE_KINDS = [
-  { kind: "test", match: (p) => /\.(test|spec)\.[jt]sx?$/.test(p.toLowerCase()) },
-  { kind: "route", match: (p) => p.includes("/routes/") || p.includes("route.") || p.includes("/api/") },
-  { kind: "controller", match: (p) => p.includes("controller") },
-  { kind: "service", match: (p) => p.includes("service") },
-  { kind: "provider", match: (p) => p.includes("provider") },
-  { kind: "model", match: (p) => p.includes("model") || p.includes("entity") },
-  { kind: "schema", match: (p) => p.includes("schema") || p.includes("zod") || p.includes("dto") },
-  { kind: "type", match: (p) => p.endsWith(".d.ts") || p.includes("types.") || p.includes("type.") },
-  { kind: "security", match: (p) => p.includes("auth") || p.includes("security") || p.includes("guard") },
-  { kind: "db", match: (p) => p.includes("db") || p.includes("database") || p.includes("migration") },
-  { kind: "data", match: (p) => p.endsWith(".json") || p.endsWith(".csv") },
-  { kind: "doc", match: (p) => p.endsWith(".md") || p.endsWith(".mdx") },
-  { kind: "script", match: (p) => p.startsWith("scripts/") || p.endsWith(".sh") || p.endsWith(".ps1") },
+
+// 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 = [
   {
-    kind: "config",
-    match: (p) => {
-      const base = p.split("/").pop() || "";
-      return ["package.json", "tsconfig.json", "Dockerfile"].includes(base) || base.startsWith(".");
-    }
+    name: "python-django",
+    priority: 56,
+    detect: (context) => hasFile(context, "manage.py") || manifestContains(context, "pyproject.toml", "django") || manifestContains(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")),
+      layer("serializers", DIR("serializers")),
+      layer("urls", "urls.py"),
+      layer("migrations", DIR("migrations")),
+      layer("settings", "settings.py", "settings/"),
+      layer("templates", DIR("templates")),
+      ...commonLayers()
+    ],
+    kinds: [
+      suffixKind("model", "models.py"),
+      suffixKind("view", "views.py"),
+      suffixKind("serializer", "serializers.py"),
+      suffixKind("urlconf", "urls.py"),
+      kindOf("migration", "migrations/"),
+      suffixKind("settings", "settings.py"),
+      ...commonKinds()
+    ],
+    exclude: ["__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache", ".tox", ".eggs", "staticfiles", "media"],
+    recommendedBudget: "150k"
+  },
+  {
+    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"),
+    layers: [
+      layer("routers", DIR("routers"), DIR("routes"), DIR("api")),
+      layer("models", DIR("models"), DIR("db")),
+      layer("schemas", DIR("schemas")),
+      layer("services", DIR("services")),
+      layer("core", DIR("core")),
+      layer("tests", DIR("tests")),
+      ...commonLayers()
+    ],
+    kinds: [
+      kindOf("router", "routers/", "routes/", "api/"),
+      kindOf("model", "models/"),
+      kindOf("schema", "schemas/"),
+      kindOf("service", "services/"),
+      ...commonKinds()
+    ],
+    exclude: ["__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache", ".tox", ".eggs"],
+    recommendedBudget: "150k"
+  },
+  {
+    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"),
+    layers: [
+      layer("package", DIR("src"), DIR("lib")),
+      layer("tests", DIR("tests"), DIR("test")),
+      ...commonLayers()
+    ],
+    kinds: [suffixKind("module", ".py"), ...commonKinds()],
+    exclude: ["__pycache__", ".venv", "venv", ".mypy_cache", ".pytest_cache", ".tox", ".eggs"],
+    recommendedBudget: "120k"
+  },
+  {
+    name: "go",
+    priority: 50,
+    detect: (context) => hasFile(context, "go.mod"),
+    layers: [
+      layer("cmd", "cmd/"),
+      layer("internal", "internal/"),
+      layer("pkg", "pkg/"),
+      layer("api", "api/", "proto/"),
+      layer("migrations", "migrations/"),
+      ...commonLayers()
+    ],
+    kinds: [
+      kindOf("main", "cmd/"),
+      kindOf("handler", "handler", "server", "http"),
+      kindOf("service", "service"),
+      kindOf("repository", "repository", "store", "repo"),
+      kindOf("model", "model", "entity"),
+      suffixKind("test", "_test.go"),
+      ...commonKinds()
+    ],
+    exclude: ["vendor", "testdata"],
+    recommendedBudget: "200k"
+  },
+  {
+    name: "rust",
+    priority: 48,
+    detect: (context) => hasFile(context, "Cargo.toml"),
+    layers: [
+      layer("src", "src/"),
+      layer("crates", "crates/"),
+      layer("bins", "src/bin/"),
+      layer("tests", "tests/"),
+      layer("benches", "benches/"),
+      ...commonLayers()
+    ],
+    kinds: [suffixKind("module", ".rs"), suffixKind("test", "_test.rs"), ...commonKinds()],
+    exclude: ["target"],
+    recommendedBudget: "200k"
+  },
+  {
+    name: "java-spring",
+    priority: 46,
+    detect: (context) => hasFile(context, "pom.xml") || hasFile(context, "build.gradle") || hasFile(context, "build.gradle.kts"),
+    layers: [
+      layer("api", "src/main/java/"),
+      layer("test", "src/test/java/"),
+      layer("resources", "src/main/resources/"),
+      layer("migrations", "src/main/resources/db/"),
+      ...commonLayers()
+    ],
+    kinds: [
+      kindOf("controller", "controller"),
+      kindOf("service", "service"),
+      kindOf("repository", "repository", "dao"),
+      kindOf("entity", "entity", "model"),
+      kindOf("dto", "dto", "request", "response"),
+      kindOf("migration", "migration", "db/migration"),
+      ...commonKinds()
+    ],
+    exclude: [".gradle", "out", "target"],
+    recommendedBudget: "200k"
+  },
+  {
+    name: "dotnet",
+    priority: 44,
+    detect: (context) => anyFileEndingWith(context, ".csproj") || anyFileEndingWith(context, ".sln") || hasFile(context, "global.json"),
+    layers: [
+      layer("web", "src/", "Web/"),
+      layer("domain", "Domain/", "Core/"),
+      layer("infrastructure", "Infrastructure/", "Data/"),
+      layer("tests", "Tests/", "test/"),
+      ...commonLayers()
+    ],
+    kinds: [
+      kindOf("controller", "Controller"),
+      kindOf("service", "Service"),
+      kindOf("repository", "Repository"),
+      kindOf("model", "Model", "Entity"),
+      kindOf("dto", "Dto", "Request", "Response"),
+      suffixKind("test", "Tests.cs"),
+      ...commonKinds()
+    ],
+    exclude: ["bin", "obj", ".vs"],
+    recommendedBudget: "200k"
+  },
+  {
+    name: "php-laravel",
+    priority: 42,
+    detect: (context) => hasFile(context, "artisan") || manifestContains(context, "composer.json", "laravel") || hasFile(context, "composer.json"),
+    layers: [
+      layer("app", "app/"),
+      layer("routes", "routes/"),
+      layer("http", "app/Http/"),
+      layer("models", "app/Models/"),
+      layer("providers", "app/Providers/"),
+      layer("database", "database/"),
+      layer("tests", "tests/"),
+      ...commonLayers()
+    ],
+    kinds: [
+      kindOf("controller", "Http/Controllers/"),
+      kindOf("model", "Models/"),
+      kindOf("migration", "migrations/"),
+      kindOf("middleware", "Middleware/"),
+      kindOf("request", "Requests/"),
+      kindOf("provider", "Providers/"),
+      ...commonKinds()
+    ],
+    exclude: ["vendor", "storage", "bootstrap/cache", "public/build"],
+    recommendedBudget: "150k"
+  },
+  {
+    name: "ruby-rails",
+    priority: 40,
+    detect: (context) => hasFile(context, "Gemfile") || hasFile(context, "config.ru") || hasFile(context, "Rakefile"),
+    layers: [
+      layer("app", "app/"),
+      layer("controllers", "app/controllers/"),
+      layer("models", "app/models/"),
+      layer("config", "config/"),
+      layer("db", "db/"),
+      layer("spec", "spec/", "test/"),
+      ...commonLayers()
+    ],
+    kinds: [
+      kindOf("controller", "controllers/"),
+      kindOf("model", "models/"),
+      kindOf("migration", "migrate/"),
+      kindOf("job", "jobs/"),
+      kindOf("mailer", "mailers/"),
+      suffixKind("test", "_spec.rb", "_test.rb"),
+      ...commonKinds()
+    ],
+    exclude: [".bundle", "log", "tmp", "vendor/bundle", "public/assets"],
+    recommendedBudget: "150k"
   }
 ];
 
@@ -289,50 +846,110 @@ var DEFAULT_KINDS = [
   }
 ];
 
-// src/presets/index.ts
-function detectPreset(cwd) {
-  const hasNextConfig = fs2.existsSync(path2.join(cwd, "next.config.ts")) || fs2.existsSync(path2.join(cwd, "next.config.js")) || fs2.existsSync(path2.join(cwd, "next.config.mjs"));
-  const hasViteConfig = fs2.existsSync(path2.join(cwd, "vite.config.ts")) || fs2.existsSync(path2.join(cwd, "vite.config.js")) || fs2.existsSync(path2.join(cwd, "vite.config.mjs"));
-  const pkgJsonPath = path2.join(cwd, "package.json");
-  let pkgDependencies = {};
-  if (fs2.existsSync(pkgJsonPath)) {
-    try {
-      const parsed = JSON.parse(fs2.readFileSync(pkgJsonPath, "utf8"));
-      pkgDependencies = {
-        ...parsed.dependencies || {},
-        ...parsed.devDependencies || {}
-      };
-    } catch {
-      pkgDependencies = {};
-    }
-  }
-  if (hasNextConfig || pkgDependencies["next"]) {
-    return {
-      presetName: "nextjs",
-      layers: NEXTJS_LAYERS,
-      kinds: NEXTJS_KINDS
-    };
+// src/presets/shape-presets.ts
+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"'),
+    layers: [
+      layer("apps", "apps/"),
+      layer("packages", "packages/"),
+      layer("tooling", "tooling/", "tools/", "scripts/"),
+      ...commonLayers()
+    ],
+    kinds: commonKinds(),
+    exclude: [".turbo", ".nx"],
+    recommendedBudget: "200k"
+  },
+  {
+    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"),
+    layers: [
+      layer("modules", "modules/"),
+      layer("environments", "env/", "environments/"),
+      layer("manifests", "k8s/", "helm/", "charts/", "deploy/"),
+      ...commonLayers()
+    ],
+    kinds: [
+      { kind: "terraform", match: (filePath) => filePath.endsWith(".tf") },
+      { kind: "kubernetes", match: (filePath) => /\.(ya?ml)$/i.test(filePath) && /k8s|helm|charts|deploy/.test(filePath) },
+      ...commonKinds()
+    ],
+    exclude: [".terraform", ".terragrunt-cache"],
+    recommendedBudget: "100k"
+  },
+  {
+    name: "docs",
+    priority: 22,
+    detect: (context) => {
+      const markdown = Array.from(context.files).filter((file) => /\.mdx?$/i.test(file)).length;
+      return markdown >= 3 && !hasFile(context, "package.json");
+    },
+    layers: [
+      layer("content", "content/", "docs/"),
+      layer("assets", "assets/", "static/", "public/"),
+      ...commonLayers()
+    ],
+    kinds: commonKinds(),
+    exclude: [".docusaurus", ".vitepress/dist", "site"],
+    recommendedBudget: "100k"
+  },
+  {
+    name: "generic",
+    priority: 0,
+    detect: () => true,
+    layers: DEFAULT_LAYERS,
+    kinds: DEFAULT_KINDS,
+    exclude: [],
+    recommendedBudget: "120k"
   }
-  if (hasViteConfig || pkgDependencies["vite"]) {
-    return {
-      presetName: "vite",
-      layers: VITE_LAYERS,
-      kinds: VITE_KINDS
-    };
+];
+
+// src/presets/registry.ts
+function compare(a, b) {
+  if (b.priority !== a.priority) return b.priority - a.priority;
+  return a.name < b.name ? -1 : a.name > b.name ? 1 : 0;
+}
+var PRESETS = [
+  ...JS_PRESETS,
+  ...LANGUAGE_PRESETS,
+  ...SHAPE_PRESETS
+].sort(compare);
+var BY_NAME = new Map(PRESETS.map((preset) => [preset.name, preset]));
+function listPresetNames() {
+  return PRESETS.map((preset) => preset.name);
+}
+function getPreset(name) {
+  return BY_NAME.get(name);
+}
+function unknownPresetMessage(name) {
+  return `Unknown preset "${name}". Expected one of: ${listPresetNames().join(", ")}.`;
+}
+function detectPresetFromContext(context, forced) {
+  if (forced !== void 0) {
+    const preset = BY_NAME.get(forced);
+    if (!preset) throw new Error(unknownPresetMessage(forced));
+    return toDetected(preset);
   }
-  if (pkgDependencies["express"] || pkgDependencies["fastify"] || pkgDependencies["@nestjs/core"] || fs2.existsSync(path2.join(cwd, "src/core")) || fs2.existsSync(path2.join(cwd, "src/protocols"))) {
-    return {
-      presetName: "node",
-      layers: NODE_LAYERS,
-      kinds: NODE_KINDS
-    };
+  for (const preset of PRESETS) {
+    if (preset.detect(context)) return toDetected(preset);
   }
+  return toDetected(PRESETS[PRESETS.length - 1]);
+}
+function toDetected(preset) {
   return {
-    presetName: "default",
-    layers: DEFAULT_LAYERS,
-    kinds: DEFAULT_KINDS
+    presetName: preset.name,
+    layers: preset.layers,
+    kinds: preset.kinds,
+    exclude: preset.exclude ? [...preset.exclude] : [],
+    recommendedBudget: preset.recommendedBudget ?? null
   };
 }
+function detectPreset(cwd, forced) {
+  return detectPresetFromContext(buildPresetContext(cwd), forced);
+}
 
 // src/scanner/files.ts
 import * as childProcess from "child_process";
@@ -340,11 +957,12 @@ import * as fs3 from "fs";
 import * as path3 from "path";
 function getGitInfo(cwd, fallbackBranch = "main") {
   try {
-    const branch = childProcess.execSync("git rev-parse --abbrev-ref HEAD", {
+    const reported = childProcess.execSync("git rev-parse --abbrev-ref HEAD", {
       cwd,
       stdio: ["ignore", "pipe", "ignore"],
       encoding: "utf8"
-    }).trim() || fallbackBranch;
+    }).trim();
+    const branch = !reported || reported === "HEAD" ? fallbackBranch : reported;
     const commit = childProcess.execSync("git rev-parse HEAD", {
       cwd,
       stdio: ["ignore", "pipe", "ignore"],
@@ -866,6 +1484,8 @@ function normalizeResolvedConfig(config) {
       config.includeMonolith === true
     ),
     include: resolveInclude(config.include),
+    preset: typeof config.preset === "string" ? config.preset : "generic",
+    presetExclude: Array.isArray(config.presetExclude) ? config.presetExclude : [],
     layersMode: config.layersMode === "replace" ? "replace" : "merge",
     budgets: config.budgets && typeof config.budgets === "object" ? config.budgets : { default: config.maxPartBytes, byLayer: {} },
     hooks: resolveHooks(config.hooks),
@@ -913,6 +1533,7 @@ function parseJsonish(raw, file) {
 }
 async function loadConfigFileDetailed(cwd) {
   const warnings = [];
+  const errors = [];
   for (const filename of CONFIG_FILENAMES) {
     const fullPath = path4.join(cwd, filename);
     if (!fs4.existsSync(fullPath)) continue;
@@ -921,10 +1542,13 @@ async function loadConfigFileDetailed(cwd) {
         return {
           config: parseJsonish(fs4.readFileSync(fullPath, "utf8"), fullPath),
           file: fullPath,
-          warnings
+          warnings,
+          errors
         };
       } catch (err) {
-        warnings.push(err.message);
+        const message = err.message;
+        warnings.push(message);
+        errors.push(message);
         continue;
       }
     }
@@ -938,12 +1562,16 @@ async function loadConfigFileDetailed(cwd) {
       const imported = await import(pathToFileURL(fullPath).href);
       const config = imported.default ?? imported;
       if (!config || typeof config !== "object") {
-        warnings.push(`${fullPath} does not export a configuration object.`);
+        const message = `${fullPath} does not export a configuration object.`;
+        warnings.push(message);
+        errors.push(message);
         continue;
       }
-      return { config, file: fullPath, warnings };
+      return { config, file: fullPath, warnings, errors };
     } catch (err) {
-      warnings.push(`Could not load ${fullPath}: ${err.message}`);
+      const message = `Could not load ${fullPath}: ${err.message}`;
+      warnings.push(message);
+      errors.push(message);
       continue;
     }
   }
@@ -953,13 +1581,18 @@ async function loadConfigFileDetailed(cwd) {
       const parsed = parseJsonish(fs4.readFileSync(pkgJsonPath, "utf8"), pkgJsonPath);
       const snapshotKey = parsed.snapshot;
       if (snapshotKey && typeof snapshotKey === "object") {
-        return { config: snapshotKey, file: pkgJsonPath, warnings };
+        return { config: snapshotKey, file: pkgJsonPath, warnings, errors };
+      }
+      if (snapshotKey !== void 0) {
+        warnings.push(`${pkgJsonPath}: the "snapshot" key must be an object; it was ignored.`);
       }
     } catch (err) {
-      warnings.push(err.message);
+      const message = err.message;
+      warnings.push(message);
+      errors.push(message);
     }
   }
-  return { config: null, file: null, warnings };
+  return { config: null, file: null, warnings, errors };
 }
 var MIN_MAX_PART_BYTES = 4096;
 var ARTIFACT_NAMES = [
@@ -1054,7 +1687,9 @@ function boundedBytes(value, fallback, minimum, label) {
       `${label} must be a byte count such as 120000, "120k" or "1.5mb" (received ${describeBytes(value)}).`
     );
   }
-  if (parsed <= 0) return fallback;
+  if (parsed <= 0) {
+    throw new Error(`${label} must be a positive byte count (received ${describeBytes(value)}).`);
+  }
   if (parsed < minimum) {
     throw new Error(`${label} must be at least ${minimum} bytes (received ${describeBytes(value)}).`);
   }
@@ -1094,12 +1729,12 @@ function resolveBudgets(budgets, fallback) {
     if (typeof budgets.byLayer !== "object" || budgets.byLayer === null) {
       throw new Error("`budgets.byLayer` must be an object of layer name to byte size.");
     }
-    for (const [layer, value] of Object.entries(budgets.byLayer)) {
-      byLayer[layer] = boundedBytes(
+    for (const [layer2, value] of Object.entries(budgets.byLayer)) {
+      byLayer[layer2] = boundedBytes(
         value,
         fallback,
         MIN_MAX_PART_BYTES,
-        `budgets.byLayer["${layer}"]`
+        `budgets.byLayer["${layer2}"]`
       );
     }
   }
@@ -1131,7 +1766,11 @@ function resolveCandidateCwd(userConfig, cliOptions, baseDir) {
 }
 function resolveConfig(userConfig, cliOptions, baseDir) {
   const cwd = resolveCandidateCwd(userConfig ?? null, cliOptions, baseDir);
-  const preset = detectPreset(cwd);
+  const forcedPreset = userConfig?.preset;
+  if (forcedPreset !== void 0 && !getPreset(forcedPreset)) {
+    throw new Error(unknownPresetMessage(forcedPreset));
+  }
+  const preset = detectPreset(cwd, forcedPreset);
   const layersMode = resolveLayersMode(userConfig?.layersMode);
   const layers = userConfig?.layers && userConfig.layers.length > 0 ? layersMode === "replace" ? userConfig.layers : [...userConfig.layers, ...preset.layers] : preset.layers;
   const kinds = userConfig?.kinds && userConfig.kinds.length > 0 ? layersMode === "replace" ? userConfig.kinds : [...userConfig.kinds, ...preset.kinds] : preset.kinds;
@@ -1167,6 +1806,8 @@ function resolveConfig(userConfig, cliOptions, baseDir) {
     ),
     includeSensitiveFiles: cliOptions?.includeSensitiveFiles ?? userConfig?.includeSensitiveFiles ?? false,
     include: resolveInclude(userConfig?.include),
+    preset: preset.presetName,
+    presetExclude: [...preset.exclude],
     artifacts,
     layersMode,
     budgets,
@@ -1201,8 +1842,8 @@ function matchRule(filePath, matcher) {
   return false;
 }
 function classifyLayer(filePath, layers) {
-  for (const layer of layers) {
-    if (matchRule(filePath, layer.match)) return layer.name;
+  for (const layer2 of layers) {
+    if (matchRule(filePath, layer2.match)) return layer2.name;
   }
   return "other";
 }
@@ -1337,8 +1978,8 @@ function findRuleMatch(rules, relativePath) {
     (rule) => matchRule(relativePath, rule.match)
   );
 }
-function readManifest(config) {
-  const manifestPath = path6.join(config.cwd, config.outDir, "manifest.json");
+function readManifest2(config) {
+  const manifestPath = path6.resolve(config.cwd, config.outDir, "manifest.json");
   try {
     return JSON.parse(fs5.readFileSync(manifestPath, "utf8"));
   } catch {
@@ -1355,7 +1996,7 @@ function explainPath(config, target) {
   };
   const collection = collectFiles(config.cwd, {
     includePatterns: config.include,
-    excludePatterns: config.excludePatterns,
+    excludePatterns: [...config.excludePatterns, ...config.presetExclude],
     includeSensitiveFiles: config.includeSensitiveFiles
   });
   if (!collection.files.includes(relative4)) {
@@ -1382,14 +2023,14 @@ function explainPath(config, target) {
   if (kindRule) result.kindMatch = describeMatcher(kindRule.match);
   if (fs5.existsSync(absolute) && fs5.statSync(absolute).isFile()) {
     const buffer = fs5.readFileSync(absolute);
-    const text = buffer.toString("utf8");
+    const text2 = buffer.toString("utf8");
     result.bytes = buffer.length;
-    result.lines = countLines(text);
-    const { findings } = scanAndRedactSecrets(text, config.secretRules, relative4);
+    result.lines = countLines(text2);
+    const { findings } = scanAndRedactSecrets(text2, config.secretRules, relative4);
     result.secretCount = findings.length;
     result.secrets = findings.slice(0, 20).map((finding) => ({ rule: finding.rule, line: finding.line }));
   }
-  const manifest = readManifest(config);
+  const manifest = readManifest2(config);
   const entry = manifest?.files.find((file) => file.relativePath === relative4);
   result.part = entry?.part ?? null;
   result.inclusionMode = entry?.inclusionMode;
@@ -1429,133 +2070,1147 @@ function renderExplainText(result) {
   return lines.join("\n");
 }
 
-// src/index.ts
-import * as crypto3 from "crypto";
-import * as fs8 from "fs";
-import * as path9 from "path";
+// src/wizard/init.ts
+import * as fs6 from "fs";
+import * as path7 from "path";
 
-// src/ast/structured.ts
-function stripJsonComments2(content) {
-  const text = content.replace(/^\uFEFF/, "");
-  let out = "";
-  let inString = false;
-  let inLineComment = false;
-  let inBlockComment = false;
-  for (let i = 0; i < text.length; i++) {
-    const char = text[i];
-    const next = text[i + 1];
-    if (inLineComment) {
-      if (char === "\n") {
-        inLineComment = false;
-        out += char;
-      }
-      continue;
-    }
-    if (inBlockComment) {
-      if (char === "*" && next === "/") {
-        inBlockComment = false;
-        i += 1;
-      }
-      continue;
-    }
-    if (inString) {
-      out += char;
-      if (char === "\\") {
-        if (next !== void 0) {
-          out += next;
-          i += 1;
-        }
-      } else if (char === '"') {
-        inString = false;
-      }
-      continue;
-    }
-    if (char === '"') {
-      inString = true;
-      out += char;
-      continue;
-    }
-    if (char === "/" && next === "/") {
-      inLineComment = true;
-      i += 1;
-      continue;
-    }
-    if (char === "/" && next === "*") {
-      inBlockComment = true;
-      i += 1;
-      continue;
+// src/wizard/config-template.ts
+var DEFAULT_ANSWERS = {
+  preset: "generic",
+  maxPartBytes: "300k",
+  largeFileBytes: "200k",
+  include: [],
+  excludePatterns: [],
+  artifacts: {
+    readme: true,
+    manifest: true,
+    parts: true,
+    navigation: true,
+    projectTree: true,
+    audit: true,
+    monolith: false
+  },
+  includeSensitiveFiles: false,
+  outDir: "snapshot"
+};
+function list(values) {
+  if (values.length === 0) return "[]";
+  return `[${values.map((value) => JSON.stringify(value)).join(", ")}]`;
+}
+function size(value) {
+  return typeof value === "string" ? JSON.stringify(value) : String(value);
+}
+var PRESET_NAMES = [
+  "nextjs \xB7 react-vite \xB7 vue-vite \xB7 nuxt \xB7 sveltekit \xB7 angular \xB7 astro",
+  "remix \xB7 solid \xB7 nest \xB7 node-express \xB7 node-lib",
+  "python-django \xB7 python-fastapi \xB7 python-lib \xB7 go \xB7 rust",
+  "java-spring \xB7 dotnet \xB7 php-laravel \xB7 ruby-rails",
+  "monorepo \xB7 docs \xB7 infra \xB7 generic"
+];
+function renderConfig(answers) {
+  const { artifacts } = answers;
+  return `import { defineConfig } from "@ankurhalder/codebase-snapshot";
+
+export default defineConfig({
+  // \u2500\u2500 Project \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // Which project shape to use. Detected from the repo when omitted.
+  // ${PRESET_NAMES.join("\n  // ")}
+  preset: ${JSON.stringify(answers.preset)},
+
+  // Recorded in the manifest when git cannot report a branch.
+  branch: "main",
+
+  // \u2500\u2500 Output \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // Where the snapshot is written.
+  outDir: ${JSON.stringify(answers.outDir)},
+  // Scratch directory; the new snapshot is renamed into place atomically.
+  tmpDir: "snapshot.tmp",
+
+  // \u2500\u2500 Size \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // Hard ceiling per part. "300k", 307200 and "1.5mb" are all accepted.
+  maxPartBytes: ${size(answers.maxPartBytes)},
+  // Files above this size get a head/tail preview instead of the full body.
+  largeFileBytes: ${size(answers.largeFileBytes)},
+  previewHeadLines: 80,
+  previewTailLines: 40,
+  // Different ceilings per layer. Unlisted layers use \`default\`.
+  budgets: {
+    default: ${size(answers.maxPartBytes)},
+    byLayer: {},
+  },
+
+  // \u2500\u2500 What goes in \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // Allow-list. Empty means "everything that is not ignored".
+  // Example: ["src/**", "packages/*/src/**"]
+  include: ${list(answers.include)},
+  // Globs or path segments to drop. Example: ["**/*.test.ts", "docs"]
+  excludePatterns: ${list(answers.excludePatterns)},
+
+  // \u2500\u2500 Classification \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // "merge" = the preset's rules plus yours (yours win). "replace" = yours only.
+  layersMode: "merge",
+  // [{ name: "billing", match: "src/features/billing/**" }]
+  layers: [],
+  // [{ kind: "route", match: "src/app/api/**" }]
+  kinds: [],
+
+  // \u2500\u2500 Safety \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // .env, *.pem, .npmrc, .ssh/ and friends are skipped unless this is true.
+  includeSensitiveFiles: ${answers.includeSensitiveFiles},
+  secrets: {
+    // [{ rule: "internal-token", pattern: /CORP-[A-Z0-9]{32}/ }]
+    customPatterns: [],
+    // Set true to drop the 21 built-in rules.
+    disableDefaultPatterns: false,
+  },
+
+  // \u2500\u2500 Artifacts \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  artifacts: {
+    readme: ${artifacts.readme},        // README.md
+    manifest: ${artifacts.manifest},      // manifest.json \u2014 required by validate and report
+    parts: ${artifacts.parts},         // parts/part-XXX.md
+    navigation: ${artifacts.navigation},    // reports/navigation.md
+    projectTree: ${artifacts.projectTree},   // reports/project-tree.md
+    audit: ${artifacts.audit},         // reports/audit.md
+    monolith: ${artifacts.monolith},     // full-codebase.json + .md (roughly doubles output)
+  },
+  // Skip the monolith above this size. null = no limit.
+  maxMonolithBytes: null,
+
+  // \u2500\u2500 Advanced \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500
+  // afterGenerate: (manifest) => { /* write your own artifact */ }
+  hooks: {},
+});
+`;
+}
+function renderMinimalConfig(answers) {
+  const lines = [];
+  if (answers.preset !== DEFAULT_ANSWERS.preset) lines.push(`  preset: ${JSON.stringify(answers.preset)},`);
+  if (answers.maxPartBytes !== DEFAULT_ANSWERS.maxPartBytes) {
+    lines.push(`  maxPartBytes: ${size(answers.maxPartBytes)},`);
+  }
+  if (answers.largeFileBytes !== DEFAULT_ANSWERS.largeFileBytes) {
+    lines.push(`  largeFileBytes: ${size(answers.largeFileBytes)},`);
+  }
+  if (answers.include.length > 0) lines.push(`  include: ${list(answers.include)},`);
+  if (answers.excludePatterns.length > 0) {
+    lines.push(`  excludePatterns: ${list(answers.excludePatterns)},`);
+  }
+  if (answers.includeSensitiveFiles) lines.push("  includeSensitiveFiles: true,");
+  if (answers.outDir !== DEFAULT_ANSWERS.outDir) lines.push(`  outDir: ${JSON.stringify(answers.outDir)},`);
+  const changed = Object.keys(answers.artifacts).filter(
+    (name) => answers.artifacts[name] !== DEFAULT_ANSWERS.artifacts[name]
+  );
+  if (changed.length > 0) {
+    const entries = changed.map((name) => `    ${name}: ${answers.artifacts[name]}`).join(",\n");
+    lines.push(`  artifacts: {
+${entries},
+  },`);
+  }
+  if (lines.length === 0) {
+    return `import { defineConfig } from "@ankurhalder/codebase-snapshot";
+
+export default defineConfig({});
+`;
+  }
+  return `import { defineConfig } from "@ankurhalder/codebase-snapshot";
+
+export default defineConfig({
+${lines.join("\n")}
+});
+`;
+}
+
+// src/wizard/prompts.ts
+import * as readline from "readline";
+var PromptCancelled = class extends Error {
+  constructor() {
+    super("Prompt cancelled");
+    this.name = "PromptCancelled";
+  }
+};
+function defaultIO() {
+  return { input: process.stdin, output: process.stdout };
+}
+function isInteractive(io) {
+  return Boolean(io.input.isTTY && io.output.isTTY);
+}
+function moveSelection(current, delta, count) {
+  if (count <= 0) return 0;
+  return ((current + delta) % count + count) % count;
+}
+function toggleIndex(selected, index) {
+  const next = new Set(selected);
+  if (next.has(index)) next.delete(index);
+  else next.add(index);
+  return next;
+}
+function marker(active) {
+  return active ? "\u276F" : " ";
+}
+function choiceLine(choice, active) {
+  const hint = choice.hint ? `  ${choice.hint}` : "";
+  return `  ${marker(active)} ${choice.label}${hint}`;
+}
+function renderSelect(message, choices, index) {
+  const lines = [`\u25C6 ${message}`, ""];
+  choices.forEach((choice, position) => lines.push(choiceLine(choice, position === index)));
+  lines.push("", "  \u2191\u2193 move \xB7 enter select");
+  return lines.join("\n");
+}
+function renderMultiSelect(message, choices, index, selected) {
+  const lines = [`\u25C6 ${message}`, ""];
+  choices.forEach((choice, position) => {
+    const box = selected.has(position) ? "\u25FC" : "\u25FB";
+    const hint = choice.hint ? `  ${choice.hint}` : "";
+    lines.push(`  ${marker(position === index)} ${box} ${choice.label}${hint}`);
+  });
+  lines.push("", "  \u2191\u2193 move \xB7 space toggle \xB7 enter confirm");
+  return lines.join("\n");
+}
+function renderConfirm(message, value) {
+  return [
+    `\u25C6 ${message}`,
+    "",
+    `  ${marker(value)} Yes`,
+    `  ${marker(!value)} No`,
+    "",
+    "  \u2190\u2192 or y/n \xB7 enter confirm"
+  ].join("\n");
+}
+function renderText(message, value, error) {
+  const lines = [`\u25C6 ${message}`, "", `  ${value || "\u258F"}`];
+  if (error) lines.push("", `  \u2716 ${error}`);
+  return lines.join("\n");
+}
+function keyReader(input) {
+  const queue = [];
+  const waiters = [];
+  const wasRaw = input.isRaw;
+  const onKey = (_text, key) => {
+    const waiter = waiters.shift();
+    if (waiter) waiter(key);
+    else queue.push(key);
+  };
+  readline.emitKeypressEvents(input);
+  if (input.isTTY) input.setRawMode(true);
+  input.resume();
+  input.on("keypress", onKey);
+  return {
+    next() {
+      const queued = queue.shift();
+      if (queued) return Promise.resolve(queued);
+      return new Promise((resolve6) => waiters.push(resolve6));
+    },
+    close() {
+      input.off("keypress", onKey);
+      if (input.isTTY) input.setRawMode(wasRaw ?? false);
+      input.pause();
     }
-    out += char;
+  };
+}
+var Frame = class {
+  constructor(output) {
+    this.output = output;
+  }
+  output;
+  drawn = 0;
+  draw(text2) {
+    this.erase();
+    this.output.write(`${text2}
+`);
+    this.drawn = text2.split("\n").length;
   }
-  return out;
+  erase() {
+    if (this.drawn > 0) this.output.write(`\x1B[${this.drawn}A\x1B[0J`);
+    this.drawn = 0;
+  }
+};
+function isCancel(key) {
+  return key.ctrl === true && key.name === "c" || key.ctrl === true && key.name === "d";
 }
-function summarizeJson(content) {
+async function select(io, message, choices, options = {}) {
+  if (choices.length === 0) throw new Error("select() requires at least one choice.");
+  const fallbackIndex = Math.max(
+    0,
+    choices.findIndex((choice) => choice.value === options.defaultValue)
+  );
+  if (!isInteractive(io)) {
+    io.output.write(`${renderSelect(message, choices, fallbackIndex)}
+`);
+    return choices[fallbackIndex].value;
+  }
+  const frame = new Frame(io.output);
+  const reader = keyReader(io.input);
+  let index = fallbackIndex;
   try {
-    const parsed = JSON.parse(stripJsonComments2(content));
-    if (Array.isArray(parsed)) {
-      const sample = parsed[0];
-      const sampleKeys = sample && typeof sample === "object" && !Array.isArray(sample) ? Object.keys(sample).slice(0, 10).sort() : [];
-      return {
-        shape: "array",
-        itemCount: parsed.length,
-        keys: [],
-        sampleKeys
-      };
+    for (; ; ) {
+      frame.draw(renderSelect(message, choices, index));
+      const key = await reader.next();
+      if (isCancel(key)) throw new PromptCancelled();
+      if (key.name === "up") index = moveSelection(index, -1, choices.length);
+      else if (key.name === "down") index = moveSelection(index, 1, choices.length);
+      else if (key.name === "return" || key.name === "enter") {
+        frame.erase();
+        return choices[index].value;
+      } else if (key.name === "j") index = moveSelection(index, 1, choices.length);
+      else if (key.name === "k") index = moveSelection(index, -1, choices.length);
     }
-    if (parsed && typeof parsed === "object") {
-      const keys = Object.keys(parsed).sort();
-      return {
-        shape: "object",
-        itemCount: keys.length,
-        keys: keys.slice(0, 30),
-        sampleKeys: []
-      };
+  } finally {
+    reader.close();
+  }
+}
+async function multiSelect(io, message, choices, options = {}) {
+  const selected = /* @__PURE__ */ new Set();
+  choices.forEach((choice, position) => {
+    if (options.defaults?.includes(choice.value)) selected.add(position);
+  });
+  const result = () => choices.filter((_, position) => selected.has(position)).map((choice) => choice.value);
+  if (!isInteractive(io)) {
+    io.output.write(`${renderMultiSelect(message, choices, 0, selected)}
+`);
+    return result();
+  }
+  const frame = new Frame(io.output);
+  const reader = keyReader(io.input);
+  let index = 0;
+  try {
+    for (; ; ) {
+      frame.draw(renderMultiSelect(message, choices, index, selected));
+      const key = await reader.next();
+      if (isCancel(key)) throw new PromptCancelled();
+      if (key.name === "up") index = moveSelection(index, -1, choices.length);
+      else if (key.name === "down") index = moveSelection(index, 1, choices.length);
+      else if (key.name === "space") {
+        const next = toggleIndex(selected, index);
+        selected.clear();
+        for (const position of next) selected.add(position);
+      } else if (key.name === "a") {
+        if (selected.size === choices.length) selected.clear();
+        else choices.forEach((_, position) => selected.add(position));
+      } else if (key.name === "return" || key.name === "enter") {
+        frame.erase();
+        return result();
+      }
     }
-    return {
-      shape: typeof parsed,
-      itemCount: null,
-      keys: [],
-      sampleKeys: []
-    };
+  } finally {
+    reader.close();
+  }
+}
+async function confirm(io, message, options = {}) {
+  let value = options.defaultValue ?? true;
+  if (!isInteractive(io)) {
+    io.output.write(`${renderConfirm(message, value)}
+`);
+    return value;
+  }
+  const frame = new Frame(io.output);
+  const reader = keyReader(io.input);
+  try {
+    for (; ; ) {
+      frame.draw(renderConfirm(message, value));
+      const key = await reader.next();
+      if (isCancel(key)) throw new PromptCancelled();
+      if (key.name === "up" || key.name === "left") value = true;
+      else if (key.name === "down" || key.name === "right") value = false;
+      else if (key.name === "y") value = true;
+      else if (key.name === "n") value = false;
+      else if (key.name === "return" || key.name === "enter") {
+        frame.erase();
+        return value;
+      }
+    }
+  } finally {
+    reader.close();
+  }
+}
+async function text(io, message, options = {}) {
+  const fallback = options.defaultValue ?? "";
+  if (!isInteractive(io)) {
+    io.output.write(`${renderText(message, fallback)}
+`);
+    return fallback;
+  }
+  const frame = new Frame(io.output);
+  const reader = keyReader(io.input);
+  let value = fallback;
+  let error;
+  try {
+    for (; ; ) {
+      frame.draw(renderText(message, value, error));
+      const key = await reader.next();
+      if (isCancel(key)) throw new PromptCancelled();
+      error = void 0;
+      if (key.name === "return" || key.name === "enter") {
+        const problem = options.validate ? options.validate(value) : null;
+        if (problem) {
+          error = problem;
+          continue;
+        }
+        frame.erase();
+        return value;
+      }
+      if (key.name === "backspace") {
+        value = value.slice(0, -1);
+        continue;
+      }
+      if (key.name === "escape") {
+        value = "";
+        continue;
+      }
+      if (_isPrintable(key)) value += _keyText(key);
+    }
+  } finally {
+    reader.close();
+  }
+}
+function _isPrintable(key) {
+  return typeof key.sequence === "string" && key.sequence.length === 1 && key.sequence >= " ";
+}
+function _keyText(key) {
+  return key.sequence ?? "";
+}
+
+// src/wizard/init.ts
+var CONFIG_CANDIDATES = [
+  "snapshot.config.ts",
+  "snapshot.config.js",
+  "snapshot.config.mjs",
+  "snapshot.config.cjs",
+  "snapshot.config.json",
+  ".snapshotrc.json",
+  ".snapshotrc"
+];
+var SIZE_CHOICES = [
+  { value: "60k", label: "Small", hint: "60 KB \xB7 ~15k tokens \xB7 tight context windows" },
+  { value: "120k", label: "Medium", hint: "120 KB \xB7 ~30k tokens \xB7 recommended" },
+  { value: "300k", label: "Large", hint: "300 KB \xB7 ~75k tokens \xB7 the default" },
+  { value: "custom", label: "Custom\u2026", hint: "type a size like 150k or 1.5mb" }
+];
+function existingConfig(cwd) {
+  for (const name of CONFIG_CANDIDATES) {
+    if (fs6.existsSync(path7.join(cwd, name))) return name;
+  }
+  return null;
+}
+function artifactAnswers(options) {
+  const artifacts = { ...DEFAULT_ANSWERS.artifacts };
+  for (const name of options.skipArtifacts ?? []) {
+    if (ARTIFACT_NAMES.includes(name)) {
+      artifacts[name] = false;
+    }
+  }
+  if (options.onlyArtifacts && options.onlyArtifacts.length > 0) {
+    const keep = new Set(options.onlyArtifacts);
+    for (const name of ARTIFACT_NAMES) artifacts[name] = keep.has(name);
+  }
+  return artifacts;
+}
+function topLevelDirs(cwd) {
+  try {
+    return fs6.readdirSync(cwd, { withFileTypes: true }).filter((entry) => entry.isDirectory() && !entry.name.startsWith(".") && entry.name !== "node_modules").map((entry) => entry.name).sort();
+  } catch {
+    return [];
+  }
+}
+function addScripts(cwd, notes) {
+  const packagePath = path7.join(cwd, "package.json");
+  if (!fs6.existsSync(packagePath)) {
+    notes.push("No package.json found, so npm scripts were not added.");
+    return [];
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(fs6.readFileSync(packagePath, "utf8"));
   } catch {
+    notes.push("Could not parse package.json; npm scripts were not added.");
+    return [];
+  }
+  const scripts = parsed.scripts && typeof parsed.scripts === "object" ? parsed.scripts : {};
+  const added = [];
+  if (!scripts.snapshot) {
+    scripts.snapshot = "codebase-snapshot generate";
+    added.push("snapshot");
+  }
+  if (!scripts["snapshot:validate"]) {
+    scripts["snapshot:validate"] = "codebase-snapshot validate";
+    added.push("snapshot:validate");
+  }
+  if (added.length === 0) return [];
+  parsed.scripts = scripts;
+  fs6.writeFileSync(packagePath, `${JSON.stringify(parsed, null, 2)}
+`, "utf8");
+  return added;
+}
+function addGitignore(cwd) {
+  const ignorePath = path7.join(cwd, ".gitignore");
+  const existing = fs6.existsSync(ignorePath) ? fs6.readFileSync(ignorePath, "utf8") : "";
+  const wanted = ["snapshot/", "snapshot.tmp/"];
+  const added = wanted.filter((entry) => !existing.split(/\r?\n/).includes(entry));
+  if (added.length === 0) return [];
+  const prefix = existing.length === 0 || existing.endsWith("\n") ? "" : "\n";
+  fs6.writeFileSync(ignorePath, `${existing}${prefix}${added.join("\n")}
+`, "utf8");
+  return added;
+}
+function resolvePresetChoice(answers, presetName) {
+  return {
+    value: presetName,
+    label: presetName,
+    hint: presetName === answers.preset ? "detected" : void 0
+  };
+}
+async function runInit(options) {
+  const io = options.io ?? defaultIO();
+  const detected = detectPreset(options.cwd, options.preset);
+  const notes = [];
+  const answers = {
+    preset: detected.presetName,
+    maxPartBytes: options.maxPartBytes ?? detected.recommendedBudget ?? DEFAULT_ANSWERS.maxPartBytes,
+    largeFileBytes: DEFAULT_ANSWERS.largeFileBytes,
+    include: options.include ?? [],
+    excludePatterns: options.exclude ?? [],
+    artifacts: artifactAnswers(options),
+    includeSensitiveFiles: options.includeSensitiveFiles ?? DEFAULT_ANSWERS.includeSensitiveFiles,
+    outDir: options.outDir ?? DEFAULT_ANSWERS.outDir
+  };
+  const interactive = isInteractive(io) && options.yes !== true;
+  if (interactive) {
+    io.output.write("\n  @ankurhalder/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}
+`);
+    io.output.write(`  Directory  ${options.cwd}
+
+`);
+    const useDetected = await confirm(io, `Set up for ${detected.presetName}?`, {
+      defaultValue: true
+    });
+    if (!useDetected) {
+      answers.preset = await select(
+        io,
+        "What kind of project is this?",
+        listPresetNames().map((name) => resolvePresetChoice(answers, name))
+      );
+      const chosen = detectPreset(options.cwd, answers.preset);
+      answers.preset = chosen.presetName;
+    }
+    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 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}
+`);
+    io.output.write(`  include          ${answers.include.length ? answers.include.join(", ") : "everything"}
+`);
+    io.output.write(`  part size        ${String(answers.maxPartBytes)}
+`);
+    io.output.write(`  artifacts        ${enabledCount} of ${ARTIFACT_NAMES.length}
+`);
+    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();
+  }
+  const configText = options.minimal ? renderMinimalConfig(answers) : renderConfig(answers);
+  const configName = supportsTypeScriptImports() ? "snapshot.config.ts" : "snapshot.config.mjs";
+  const configPath = path7.join(options.cwd, configName);
+  if (options.dryRun) {
     return {
-      shape: "invalid-json",
-      itemCount: null,
-      keys: [],
-      sampleKeys: []
+      configPath,
+      configText,
+      written: false,
+      preset: answers.preset,
+      scripts: [],
+      gitignoreEntries: [],
+      notes
     };
   }
+  const present = existingConfig(options.cwd);
+  if (present && present !== configName && !options.force) {
+    throw new Error(
+      `A configuration already exists (${present}). Re-run with --force to replace it.`
+    );
+  }
+  if (fs6.existsSync(configPath) && !options.force) {
+    throw new Error(`${configName} already exists. Re-run with --force to replace it.`);
+  }
+  fs6.writeFileSync(configPath, configText, "utf8");
+  const scripts = addScripts(options.cwd, notes);
+  const gitignoreEntries = addGitignore(options.cwd);
+  return {
+    configPath,
+    configText,
+    written: true,
+    preset: answers.preset,
+    scripts,
+    gitignoreEntries,
+    notes
+  };
 }
-function summarizeMarkdown(content) {
-  const headings = [];
-  const frontmatterKeys = [];
-  const lines = content.replace(/^\uFEFF/, "").split("\n");
-  let inFrontmatter = false;
-  for (let index = 0; index < lines.length; index++) {
-    const line = lines[index];
-    if (index === 0 && line.trim() === "---") {
-      inFrontmatter = true;
-      continue;
-    }
-    if (inFrontmatter) {
-      if (line.trim() === "---") {
-        inFrontmatter = false;
-        continue;
+
+// src/index.ts
+import * as crypto3 from "crypto";
+import * as fs9 from "fs";
+import * as path10 from "path";
+
+// src/ast/profiles/shared.ts
+var MAX_SUMMARY_CHARS = 1e6;
+function emptySummary() {
+  return {
+    directives: [],
+    imports: [],
+    exports: [],
+    reExports: [],
+    functions: [],
+    classes: [],
+    interfaces: [],
+    types: [],
+    enums: [],
+    variables: [],
+    reactComponents: [],
+    hooks: [],
+    routeHandlers: []
+  };
+}
+function dedupeSorted(values) {
+  return Array.from(new Set(values.filter(Boolean))).sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+}
+function finalizeSummary(summary) {
+  return {
+    directives: dedupeSorted(summary.directives),
+    imports: dedupeSorted(summary.imports),
+    exports: dedupeSorted(summary.exports),
+    reExports: dedupeSorted(summary.reExports),
+    functions: dedupeSorted(summary.functions),
+    classes: dedupeSorted(summary.classes),
+    interfaces: dedupeSorted(summary.interfaces),
+    types: dedupeSorted(summary.types),
+    enums: dedupeSorted(summary.enums),
+    variables: dedupeSorted(summary.variables),
+    reactComponents: dedupeSorted(summary.reactComponents),
+    hooks: dedupeSorted(summary.hooks),
+    routeHandlers: dedupeSorted(summary.routeHandlers)
+  };
+}
+function eachLine(content, visit) {
+  const text2 = content.length > MAX_SUMMARY_CHARS ? content.slice(0, MAX_SUMMARY_CHARS) : content;
+  for (const line of text2.split(/\r?\n/)) visit(line);
+}
+function isTopLevel(line) {
+  return !/^[\s]/.test(line);
+}
+function isPublicName(name) {
+  return name.length > 0 && !name.startsWith("_") && /^[A-Za-z]/.test(name);
+}
+function isCapitalizedName(name) {
+  return /^[A-Z]/.test(name);
+}
+
+// src/ast/profiles/cfamily.ts
+var INCLUDE = /^#\s*include\s*[<"]([^>"]+)[>"]/;
+var DEFINE = /^#\s*define\s+([A-Za-z_]\w*)/;
+var USING = /^using\s+(?:namespace\s+)?([\w:]+)\s*;/;
+var TYPE_DECL = /^(?:typedef\s+)?(?:struct|union|class|enum)\s+([A-Za-z_]\w*)/;
+var TYPEDEF = /^typedef\b[^;{}]*?\b([A-Za-z_]\w*)\s*;/;
+var FUNCTION = /^[A-Za-z_][\w \t*&:<>,]*?\b([A-Za-z_]\w*)\s*\([^;]*\)\s*\{?\s*$/;
+var NOT_A_FUNCTION = /^(?:if|for|while|switch|return|else|do|case|sizeof|catch|throw)\b/;
+var cfamilyProfile = {
+  id: "cfamily",
+  extensions: [".c", ".h", ".cc", ".cpp", ".cxx", ".hpp", ".hxx", ".m", ".mm"],
+  summarize(_path, content) {
+    const summary = emptySummary();
+    eachLine(content, (line) => {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*")) {
+        return;
+      }
+      const included = INCLUDE.exec(trimmed);
+      if (included) {
+        summary.imports.push(included[1]);
+        return;
+      }
+      const used = USING.exec(trimmed);
+      if (used) {
+        summary.imports.push(used[1]);
+        return;
+      }
+      const macro = DEFINE.exec(trimmed);
+      if (macro) {
+        summary.variables.push(macro[1]);
+        return;
+      }
+      if (!isTopLevel(line)) return;
+      const declared = TYPE_DECL.exec(line);
+      if (declared) {
+        const kind = /^typedef\s+enum/.test(line) || /^enum\b/.test(trimmed) ? "enum" : "type";
+        if (kind === "enum") summary.enums.push(declared[1]);
+        else summary.classes.push(declared[1]);
+        summary.exports.push(declared[1]);
+        return;
+      }
+      const aliased = TYPEDEF.exec(line);
+      if (aliased) {
+        summary.types.push(aliased[1]);
+        summary.exports.push(aliased[1]);
+        return;
+      }
+      if (NOT_A_FUNCTION.test(trimmed)) return;
+      const fn = FUNCTION.exec(line);
+      if (fn) {
+        summary.functions.push(fn[1]);
+        summary.exports.push(fn[1]);
+      }
+    });
+    return { summary: finalizeSummary(summary), quality: "heuristic" };
+  }
+};
+
+// src/ast/profiles/dotnet.ts
+var USING2 = /^using\s+([\w.]+)\s*;/;
+var TYPE_DECL2 = /^\s*(?:public\s+|internal\s+|private\s+|protected\s+|sealed\s+|abstract\s+|static\s+|partial\s+|readonly\s+)*(class|interface|struct|record|enum)\s+([A-Za-z_]\w*)/;
+var METHOD = /^\s*(?:public|private|protected|internal)\s+(?:static\s+)?(?:async\s+)?(?:virtual\s+|override\s+|sealed\s+)?[\w<>[\],?]+\s+([A-Za-z_]\w*)\s*[<(]/;
+var dotnetProfile = {
+  id: "dotnet",
+  extensions: [".cs"],
+  summarize(_path, content) {
+    const summary = emptySummary();
+    eachLine(content, (line) => {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("//") || trimmed.startsWith("/*") || trimmed.startsWith("*")) {
+        return;
+      }
+      const used = USING2.exec(trimmed);
+      if (used) {
+        summary.imports.push(used[1]);
+        return;
+      }
+      const declaration = TYPE_DECL2.exec(line);
+      if (declaration) {
+        const kind = declaration[1];
+        const name = declaration[2];
+        if (kind === "interface") summary.interfaces.push(name);
+        else if (kind === "enum") summary.enums.push(name);
+        else summary.classes.push(name);
+        if (/^\s*public\b/.test(line)) summary.exports.push(name);
+        return;
+      }
+      const method = METHOD.exec(line);
+      if (method) {
+        summary.functions.push(method[1]);
+        if (/^\s*public\b/.test(line)) summary.exports.push(method[1]);
+      }
+    });
+    return { summary: finalizeSummary(summary), quality: "heuristic" };
+  }
+};
+
+// src/ast/profiles/go.ts
+var FUNC = /^func\s+(?:\([^)]*\)\s*)?([A-Za-z_]\w*)/;
+var TYPE = /^type\s+([A-Za-z_]\w*)\s+(.*)$/;
+var VAR_CONST = /^(?:var|const)\s+([A-Za-z_]\w*)/;
+var IMPORT_SINGLE = /^import\s+(?:[\w.]+\s+)?"([^"]+)"/;
+var IMPORT_OPEN = /^import\s*\(/;
+var IMPORT_ENTRY = /^\s*(?:[\w.]+\s+)?"([^"]+)"/;
+var goProfile = {
+  id: "go",
+  extensions: [".go"],
+  summarize(_path, content) {
+    const summary = emptySummary();
+    let inImportBlock = false;
+    eachLine(content, (line) => {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("//")) return;
+      if (inImportBlock) {
+        if (trimmed.startsWith(")")) {
+          inImportBlock = false;
+          return;
+        }
+        const entry = IMPORT_ENTRY.exec(line);
+        if (entry) summary.imports.push(entry[1]);
+        return;
+      }
+      if (IMPORT_OPEN.test(trimmed)) {
+        inImportBlock = true;
+        return;
+      }
+      const single = IMPORT_SINGLE.exec(trimmed);
+      if (single) {
+        summary.imports.push(single[1]);
+        return;
+      }
+      if (!isTopLevel(line)) return;
+      const method = FUNC.exec(line);
+      if (method) {
+        const name = method[1];
+        summary.functions.push(name);
+        if (isCapitalizedName(name)) summary.exports.push(name);
+        return;
+      }
+      const declared = TYPE.exec(line);
+      if (declared) {
+        const name = declared[1];
+        const body = declared[2].trim();
+        if (body.startsWith("struct")) summary.classes.push(name);
+        else if (body.startsWith("interface")) summary.interfaces.push(name);
+        else summary.types.push(name);
+        if (isCapitalizedName(name)) summary.exports.push(name);
+        return;
+      }
+      const value = VAR_CONST.exec(line);
+      if (value) {
+        summary.variables.push(value[1]);
+        if (isCapitalizedName(value[1])) summary.exports.push(value[1]);
+      }
+    });
+    return { summary: finalizeSummary(summary), quality: "heuristic" };
+  }
+};
+
+// src/ast/profiles/jvm.ts
+var IMPORT = /^import\s+(?:static\s+)?([\w.]+?)(?:\.\*)?;?\s*$/;
+var TYPE_DECL3 = /^\s*(?:public\s+|private\s+|protected\s+|internal\s+)?(?:final\s+|abstract\s+|open\s+|sealed\s+|data\s+|static\s+|partial\s+)*(class|interface|enum|record|object|trait)\s+(?:class\s+)?([A-Za-z_]\w*)/;
+var KOTLIN_FUN = /^\s*(?:public\s+|private\s+|protected\s+|internal\s+|override\s+|suspend\s+|inline\s+|open\s+|operator\s+)*fun\s+(?:<[^>]*>\s*)?(?:[\w.]+\.)?([A-Za-z_]\w*)/;
+var SCALA_DEF = /^\s*def\s+([A-Za-z_]\w*)/;
+var JAVA_METHOD = /^\s+(?:public|private|protected)\s+(?:static\s+)?(?:final\s+)?(?:synchronized\s+)?(?:abstract\s+)?[\w<>[\],.?]+\s+([A-Za-z_]\w*)\s*\(/;
+var jvmProfile = {
+  id: "jvm",
+  extensions: [".java", ".kt", ".kts", ".scala"],
+  summarize(path12, content) {
+    const summary = emptySummary();
+    const lower = path12.toLowerCase();
+    const isJava = lower.endsWith(".java");
+    const isKotlin = lower.endsWith(".kt") || lower.endsWith(".kts");
+    eachLine(content, (line) => {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("//") || trimmed.startsWith("*") || trimmed.startsWith("/*")) {
+        return;
+      }
+      const imported = IMPORT.exec(trimmed);
+      if (imported) {
+        summary.imports.push(imported[1]);
+        return;
+      }
+      const declaration = TYPE_DECL3.exec(line);
+      if (declaration) {
+        const kind = declaration[1];
+        const name = declaration[2];
+        if (kind === "interface" || kind === "trait") summary.interfaces.push(name);
+        else if (kind === "enum") summary.enums.push(name);
+        else summary.classes.push(name);
+        const hidden = /^\s*(?:private|protected|internal)\b/.test(line);
+        if (isJava ? /^\s*public\b/.test(line) : !hidden) summary.exports.push(name);
+        return;
+      }
+      const kotlinFunction = KOTLIN_FUN.exec(line);
+      if (kotlinFunction && isKotlin) {
+        summary.functions.push(kotlinFunction[1]);
+        const hidden = /^\s*(?:private|protected|internal)\b/.test(line);
+        if (!hidden) summary.exports.push(kotlinFunction[1]);
+        return;
+      }
+      const scalaFunction = SCALA_DEF.exec(line);
+      if (scalaFunction && !isJava && !isKotlin) {
+        summary.functions.push(scalaFunction[1]);
+        const hidden = /^\s*(?:private|protected)\b/.test(line);
+        if (!hidden) summary.exports.push(scalaFunction[1]);
+        return;
+      }
+      if (isJava) {
+        const method = JAVA_METHOD.exec(line);
+        if (method) {
+          summary.functions.push(method[1]);
+          if (/^\s*public\b/.test(line)) summary.exports.push(method[1]);
+        }
+      }
+    });
+    return { summary: finalizeSummary(summary), quality: "heuristic" };
+  }
+};
+
+// src/ast/profiles/php.ts
+var USE = /^use\s+([\w\\]+)\s*(?:as\s+\w+)?;/;
+var DECLARE = /^(?:abstract\s+|final\s+|readonly\s+)*(class|interface|trait|enum)\s+([A-Za-z_]\w*)/;
+var FUNCTION2 = /^(?:public\s+|protected\s+|private\s+|static\s+|final\s+|abstract\s+)*function\s+([A-Za-z_]\w*)/;
+var phpProfile = {
+  id: "php",
+  extensions: [".php"],
+  summarize(_path, content) {
+    const summary = emptySummary();
+    eachLine(content, (line) => {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("//") || trimmed.startsWith("#") || trimmed.startsWith("/*")) {
+        return;
+      }
+      const used = USE.exec(trimmed);
+      if (used) {
+        summary.imports.push(used[1].replace(/\\\\/g, "\\"));
+        return;
+      }
+      const declaration = DECLARE.exec(trimmed);
+      if (declaration) {
+        const kind = declaration[1];
+        const name = declaration[2];
+        if (kind === "interface" || kind === "trait") summary.interfaces.push(name);
+        else if (kind === "enum") summary.enums.push(name);
+        else summary.classes.push(name);
+        summary.exports.push(name);
+        return;
+      }
+      const fn = FUNCTION2.exec(trimmed);
+      if (fn) {
+        summary.functions.push(fn[1]);
+        if (!/^private\b/.test(trimmed)) summary.exports.push(fn[1]);
+      }
+    });
+    return { summary: finalizeSummary(summary), quality: "heuristic" };
+  }
+};
+
+// src/ast/profiles/python.ts
+var IMPORT2 = /^import\s+(.+)$/;
+var FROM_IMPORT = /^from\s+([\w.]+)\s+import\s+(.+)$/;
+var CLASS = /^class\s+([A-Za-z_]\w*)/;
+var DEF = /^(?:async\s+)?def\s+([A-Za-z_]\w*)/;
+var CONSTANT = /^([A-Z_][A-Z0-9_]*)\s*(?::[^=]+)?=/;
+var ALL_DUNDER = /^__all__\s*=\s*\[([^\]]*)\]/;
+var ROUTE_DECORATOR = /^\s*@[\w.]*\b(?:get|post|put|patch|delete|head|options|route)\s*\(/i;
+var pythonProfile = {
+  id: "python",
+  extensions: [".py", ".pyi"],
+  summarize(_path, content) {
+    const summary = emptySummary();
+    let routePending = false;
+    eachLine(content, (line) => {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) return;
+      if (ROUTE_DECORATOR.test(line)) {
+        routePending = true;
+        return;
+      }
+      const from = FROM_IMPORT.exec(trimmed);
+      if (from) {
+        summary.imports.push(from[1]);
+        routePending = false;
+        return;
+      }
+      const imported = IMPORT2.exec(trimmed);
+      if (imported) {
+        for (const part of imported[1].split(",")) {
+          const name = part.trim().split(/\s+as\s+/)[0].trim();
+          if (name) summary.imports.push(name);
+        }
+        routePending = false;
+        return;
+      }
+      if (isTopLevel(line)) {
+        const klass = CLASS.exec(line);
+        if (klass) {
+          summary.classes.push(klass[1]);
+          if (isPublicName(klass[1])) summary.exports.push(klass[1]);
+          routePending = false;
+          return;
+        }
+        const definition = DEF.exec(line);
+        if (definition) {
+          const name = definition[1];
+          summary.functions.push(name);
+          if (routePending) {
+            summary.routeHandlers.push(name);
+            routePending = false;
+          }
+          if (isPublicName(name)) summary.exports.push(name);
+          return;
+        }
+        const all = ALL_DUNDER.exec(trimmed);
+        if (all) {
+          for (const entry of all[1].split(",")) {
+            const name = entry.trim().replace(/['"]/g, "").trim();
+            if (name) summary.exports.push(name);
+          }
+          return;
+        }
+        const constant = CONSTANT.exec(line);
+        if (constant) summary.variables.push(constant[1]);
       }
-      const match = /^([a-zA-Z0-9_-]+):/.exec(line);
-      if (match) frontmatterKeys.push(match[1]);
-      continue;
-    }
-    const headingMatch = /^(#{1,6})\s+(.+)$/.exec(line.trim());
-    if (headingMatch) {
-      headings.push(`${headingMatch[1]} ${headingMatch[2].trim()}`);
-    }
+    });
+    return { summary: finalizeSummary(summary), quality: "heuristic" };
   }
-  return {
-    headings: headings.slice(0, 40),
-    frontmatterKeys: Array.from(new Set(frontmatterKeys)).sort()
-  };
-}
+};
+
+// src/ast/profiles/ruby.ts
+var REQUIRE = /^require(?:_relative)?\s+["']([^"']+)["']/;
+var CLASS_OR_MODULE = /^(?:class|module)\s+([A-Z][\w:]*)/;
+var METHOD2 = /^def\s+(?:self\.)?([A-Za-z_]\w*[?!=]?)/;
+var rubyProfile = {
+  id: "ruby",
+  extensions: [".rb", ".rake", ".gemspec"],
+  summarize(_path, content) {
+    const summary = emptySummary();
+    eachLine(content, (line) => {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("#")) return;
+      const required = REQUIRE.exec(trimmed);
+      if (required) {
+        summary.imports.push(required[1]);
+        return;
+      }
+      if (!isTopLevel(line)) return;
+      const declaration = CLASS_OR_MODULE.exec(line);
+      if (declaration) {
+        summary.classes.push(declaration[1]);
+        summary.exports.push(declaration[1]);
+        return;
+      }
+      const method = METHOD2.exec(line);
+      if (method) {
+        summary.functions.push(method[1]);
+        summary.exports.push(method[1]);
+      }
+    });
+    return { summary: finalizeSummary(summary), quality: "heuristic" };
+  }
+};
+
+// src/ast/profiles/rust.ts
+var USE2 = /^use\s+([^;]+);/;
+var FN = /^(pub(?:\([^)]*\))?\s+)?(?:const\s+)?(?:async\s+)?(?:unsafe\s+)?fn\s+([A-Za-z_]\w*)/;
+var STRUCT = /^(pub(?:\([^)]*\))?\s+)?struct\s+([A-Za-z_]\w*)/;
+var TRAIT = /^(pub(?:\([^)]*\))?\s+)?(?:unsafe\s+)?trait\s+([A-Za-z_]\w*)/;
+var ENUM = /^(pub(?:\([^)]*\))?\s+)?enum\s+([A-Za-z_]\w*)/;
+var TYPE2 = /^(pub(?:\([^)]*\))?\s+)?type\s+([A-Za-z_]\w*)/;
+var MOD = /^(pub(?:\([^)]*\))?\s+)?mod\s+([A-Za-z_]\w*)/;
+var IMPL = /^impl(?:<[^>]*>)?\s+(?:[\w:<>]+\s+for\s+)?([A-Za-z_]\w*)/;
+var rustProfile = {
+  id: "rust",
+  extensions: [".rs"],
+  summarize(_path, content) {
+    const summary = emptySummary();
+    eachLine(content, (line) => {
+      const trimmed = line.trim();
+      if (!trimmed || trimmed.startsWith("//")) return;
+      const used = USE2.exec(trimmed);
+      if (used) {
+        summary.imports.push(used[1].trim());
+        return;
+      }
+      if (!isTopLevel(line)) return;
+      const isPublic = /^pub\b/.test(trimmed);
+      const fn = FN.exec(line);
+      if (fn) {
+        summary.functions.push(fn[2]);
+        if (isPublic) summary.exports.push(fn[2]);
+        return;
+      }
+      const struct = STRUCT.exec(line);
+      if (struct) {
+        summary.classes.push(struct[2]);
+        if (isPublic) summary.exports.push(struct[2]);
+        return;
+      }
+      const trait = TRAIT.exec(line);
+      if (trait) {
+        summary.interfaces.push(trait[2]);
+        if (isPublic) summary.exports.push(trait[2]);
+        return;
+      }
+      const enumeration = ENUM.exec(line);
+      if (enumeration) {
+        summary.enums.push(enumeration[2]);
+        if (isPublic) summary.exports.push(enumeration[2]);
+        return;
+      }
+      const alias = TYPE2.exec(line);
+      if (alias) {
+        summary.types.push(alias[2]);
+        if (isPublic) summary.exports.push(alias[2]);
+        return;
+      }
+      const module = MOD.exec(line);
+      if (module) {
+        summary.variables.push(module[2]);
+        if (isPublic) summary.exports.push(module[2]);
+        return;
+      }
+      const implementation = IMPL.exec(line);
+      if (implementation) summary.classes.push(implementation[1]);
+    });
+    return { summary: finalizeSummary(summary), quality: "heuristic" };
+  }
+};
 
 // src/ast/ts-parser.ts
 import ts from "typescript";
@@ -1598,9 +3253,9 @@ function summarizeTypeScriptSource(relativePath, content) {
   if (parseErrors > 0) summary.parseErrors = parseErrors;
   for (const statement of sourceFile.statements) {
     if (ts.isExpressionStatement(statement) && ts.isStringLiteral(statement.expression)) {
-      const text = statement.expression.text;
-      if (text === "use client" || text === "use server") {
-        summary.directives.push(text);
+      const text2 = statement.expression.text;
+      if (text2 === "use client" || text2 === "use server") {
+        summary.directives.push(text2);
       }
       continue;
     }
@@ -1700,23 +3355,212 @@ function summarizeTypeScriptSource(relativePath, content) {
       stack.push(children[index]);
     }
   }
-  const dedupeSorted = (values) => Array.from(new Set(values)).sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
-  summary.directives = dedupeSorted(summary.directives);
-  summary.imports = dedupeSorted(summary.imports);
-  summary.exports = dedupeSorted(summary.exports);
-  summary.reExports = dedupeSorted(summary.reExports);
-  summary.functions = dedupeSorted(summary.functions);
-  summary.classes = dedupeSorted(summary.classes);
-  summary.interfaces = dedupeSorted(summary.interfaces);
-  summary.types = dedupeSorted(summary.types);
-  summary.enums = dedupeSorted(summary.enums);
-  summary.variables = dedupeSorted(summary.variables);
-  summary.reactComponents = dedupeSorted(summary.reactComponents);
-  summary.hooks = dedupeSorted(summary.hooks);
-  summary.routeHandlers = dedupeSorted(summary.routeHandlers);
+  const dedupeSorted2 = (values) => Array.from(new Set(values)).sort((a, b) => a < b ? -1 : a > b ? 1 : 0);
+  summary.directives = dedupeSorted2(summary.directives);
+  summary.imports = dedupeSorted2(summary.imports);
+  summary.exports = dedupeSorted2(summary.exports);
+  summary.reExports = dedupeSorted2(summary.reExports);
+  summary.functions = dedupeSorted2(summary.functions);
+  summary.classes = dedupeSorted2(summary.classes);
+  summary.interfaces = dedupeSorted2(summary.interfaces);
+  summary.types = dedupeSorted2(summary.types);
+  summary.enums = dedupeSorted2(summary.enums);
+  summary.variables = dedupeSorted2(summary.variables);
+  summary.reactComponents = dedupeSorted2(summary.reactComponents);
+  summary.hooks = dedupeSorted2(summary.hooks);
+  summary.routeHandlers = dedupeSorted2(summary.routeHandlers);
   return summary;
 }
 
+// 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;
+  return base.replace(/\.[^.]+$/, "");
+}
+var sfcProfile = {
+  id: "sfc",
+  extensions: [".vue", ".svelte", ".astro"],
+  summarize(path12, content) {
+    let script = "";
+    if (path12.toLowerCase().endsWith(".astro")) {
+      const frontmatter = ASTRO_FRONTMATTER.exec(content);
+      if (frontmatter) script += `${frontmatter[1]}
+`;
+    }
+    for (const match of content.matchAll(SCRIPT_BLOCK)) {
+      script += `${match[1]}
+`;
+    }
+    const name = componentName(path12);
+    if (!script.trim()) {
+      const summary2 = emptySummary();
+      if (name) {
+        summary2.exports.push(name);
+        summary2.reactComponents.push(name);
+      }
+      return { summary: finalizeSummary(summary2), quality: "heuristic" };
+    }
+    const summary = summarizeTypeScriptSource(`${name}.ts`, script);
+    summary.reactComponents.push(name);
+    summary.exports.push(name);
+    return { summary, quality: "ast" };
+  }
+};
+
+// src/ast/profiles/index.ts
+var LANGUAGE_PROFILES = [
+  pythonProfile,
+  goProfile,
+  rustProfile,
+  jvmProfile,
+  dotnetProfile,
+  phpProfile,
+  rubyProfile,
+  cfamilyProfile,
+  sfcProfile
+];
+var BY_EXTENSION = /* @__PURE__ */ new Map();
+for (const profile of LANGUAGE_PROFILES) {
+  for (const extension of profile.extensions) {
+    BY_EXTENSION.set(extension.toLowerCase(), profile);
+  }
+}
+function profileForPath(path12) {
+  const lower = path12.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;
+}
+
+// src/ast/structured.ts
+function stripJsonComments2(content) {
+  const text2 = content.replace(/^\uFEFF/, "");
+  let out = "";
+  let inString = false;
+  let inLineComment = false;
+  let inBlockComment = false;
+  for (let i = 0; i < text2.length; i++) {
+    const char = text2[i];
+    const next = text2[i + 1];
+    if (inLineComment) {
+      if (char === "\n") {
+        inLineComment = false;
+        out += char;
+      }
+      continue;
+    }
+    if (inBlockComment) {
+      if (char === "*" && next === "/") {
+        inBlockComment = false;
+        i += 1;
+      }
+      continue;
+    }
+    if (inString) {
+      out += char;
+      if (char === "\\") {
+        if (next !== void 0) {
+          out += next;
+          i += 1;
+        }
+      } else if (char === '"') {
+        inString = false;
+      }
+      continue;
+    }
+    if (char === '"') {
+      inString = true;
+      out += char;
+      continue;
+    }
+    if (char === "/" && next === "/") {
+      inLineComment = true;
+      i += 1;
+      continue;
+    }
+    if (char === "/" && next === "*") {
+      inBlockComment = true;
+      i += 1;
+      continue;
+    }
+    out += char;
+  }
+  return out;
+}
+function summarizeJson(content) {
+  try {
+    const parsed = JSON.parse(stripJsonComments2(content));
+    if (Array.isArray(parsed)) {
+      const sample = parsed[0];
+      const sampleKeys = sample && typeof sample === "object" && !Array.isArray(sample) ? Object.keys(sample).slice(0, 10).sort() : [];
+      return {
+        shape: "array",
+        itemCount: parsed.length,
+        keys: [],
+        sampleKeys
+      };
+    }
+    if (parsed && typeof parsed === "object") {
+      const keys = Object.keys(parsed).sort();
+      return {
+        shape: "object",
+        itemCount: keys.length,
+        keys: keys.slice(0, 30),
+        sampleKeys: []
+      };
+    }
+    return {
+      shape: typeof parsed,
+      itemCount: null,
+      keys: [],
+      sampleKeys: []
+    };
+  } catch {
+    return {
+      shape: "invalid-json",
+      itemCount: null,
+      keys: [],
+      sampleKeys: []
+    };
+  }
+}
+function summarizeMarkdown(content) {
+  const headings = [];
+  const frontmatterKeys = [];
+  const lines = content.replace(/^\uFEFF/, "").split("\n");
+  let inFrontmatter = false;
+  for (let index = 0; index < lines.length; index++) {
+    const line = lines[index];
+    if (index === 0 && line.trim() === "---") {
+      inFrontmatter = true;
+      continue;
+    }
+    if (inFrontmatter) {
+      if (line.trim() === "---") {
+        inFrontmatter = false;
+        continue;
+      }
+      const match = /^([a-zA-Z0-9_-]+):/.exec(line);
+      if (match) frontmatterKeys.push(match[1]);
+      continue;
+    }
+    const headingMatch = /^(#{1,6})\s+(.+)$/.exec(line.trim());
+    if (headingMatch) {
+      headings.push(`${headingMatch[1]} ${headingMatch[2].trim()}`);
+    }
+  }
+  return {
+    headings: headings.slice(0, 40),
+    frontmatterKeys: Array.from(new Set(frontmatterKeys)).sort()
+  };
+}
+
 // src/generator/audit.ts
 function generateAuditReport(manifest, secretFindings) {
   const lines = [
@@ -1782,11 +3626,11 @@ function generateAuditReport(manifest, secretFindings) {
     "| :--- | :--- | :--- |"
   );
   const totalFiles = manifest.counts.totalFiles || 1;
-  for (const [layer, count] of Object.entries(manifest.layers).sort(
+  for (const [layer2, count] of Object.entries(manifest.layers).sort(
     (a, b) => b[1] - a[1] || (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0)
   )) {
     const pct = (count / totalFiles * 100).toFixed(1);
-    lines.push(`| \`${layer}\` | ${count} | ${pct}% |`);
+    lines.push(`| \`${layer2}\` | ${count} | ${pct}% |`);
   }
   lines.push("");
   lines.push(
@@ -1855,21 +3699,21 @@ function partitionFiles(files, maxPartBytes, contentFingerprint) {
       section.byteSize = Buffer.byteLength(section.text, "utf8");
       continue;
     }
-    const marker = "\n... [part truncated: cannot fit budget] ...\n";
-    const target = Math.max(0, budget - Buffer.byteLength(marker, "utf8"));
+    const marker2 = "\n... [part truncated: cannot fit budget] ...\n";
+    const target = Math.max(0, budget - Buffer.byteLength(marker2, "utf8"));
     const clipped = truncateToBytes(rendered[oversized].markdown, target);
-    rendered[oversized] = rehashPart(rendered[oversized], clipped.content + marker);
+    rendered[oversized] = rehashPart(rendered[oversized], clipped.content + marker2);
     return rendered;
   }
   return enforceBudget(renderGroups(groups, contentFingerprint), budget);
 }
 function enforceBudget(parts, budget) {
-  const marker = "\n... [part truncated: cannot fit budget] ...\n";
-  const target = Math.max(0, budget - Buffer.byteLength(marker, "utf8"));
+  const marker2 = "\n... [part truncated: cannot fit budget] ...\n";
+  const target = Math.max(0, budget - Buffer.byteLength(marker2, "utf8"));
   return parts.map((part) => {
     if (part.metadata.byteSize <= budget) return part;
     const clipped = truncateToBytes(part.markdown, target);
-    return rehashPart(part, clipped.content + marker);
+    return rehashPart(part, clipped.content + marker2);
   });
 }
 function renumberParts(parts, contentFingerprint) {
@@ -1877,10 +3721,10 @@ function renumberParts(parts, contentFingerprint) {
   if (total === 0) return [];
   const zeroPad = (index) => String(index).padStart(Math.max(3, String(total).length), "0");
   const nameFor = (position) => `part-${zeroPad(position)}.md`;
-  const marker = "## Contents\n";
+  const marker2 = "## Contents\n";
   return parts.map((part, index) => {
-    const markerIndex = part.markdown.indexOf(marker);
-    const body = markerIndex === -1 ? "" : part.markdown.slice(markerIndex + marker.length);
+    const markerIndex = part.markdown.indexOf(marker2);
+    const body = markerIndex === -1 ? "" : part.markdown.slice(markerIndex + marker2.length);
     const included = part.metadata.includedFiles;
     if (markerIndex === -1) {
       throw new Error(`${part.filename} has no "## Contents" section to re-number.`);
@@ -1938,9 +3782,9 @@ function topEntries(counts, limit) {
   return Object.entries(counts).sort((a, b) => b[1] - a[1] || (a[0] < b[0] ? -1 : a[0] > b[0] ? 1 : 0)).slice(0, limit).map(([key, value]) => `${capMetadata(key)} (${value})`).join(", ");
 }
 function prepareSection(file, sectionBudget) {
-  let text = renderFileSection(file);
-  let byteSize = Buffer.byteLength(text, "utf8");
-  if (byteSize <= sectionBudget) return { file, text, byteSize };
+  let text2 = renderFileSection(file);
+  let byteSize = Buffer.byteLength(text2, "utf8");
+  if (byteSize <= sectionBudget) return { file, text: text2, byteSize };
   const shrinkBody = () => {
     const content = file.content ?? "";
     const overhead = byteSize - Buffer.byteLength(content, "utf8");
@@ -1949,24 +3793,24 @@ function prepareSection(file, sectionBudget) {
     const truncated = truncateToBytes(content, allowed);
     if (!truncated.isTruncated) return;
     applyTruncatedContent(file, truncated.content);
-    text = renderFileSection(file);
-    byteSize = Buffer.byteLength(text, "utf8");
+    text2 = renderFileSection(file);
+    byteSize = Buffer.byteLength(text2, "utf8");
   };
   shrinkBody();
   if (byteSize > sectionBudget && file.summary) {
     file.summary = void 0;
     file.summaryOmitted = true;
-    text = renderFileSection(file);
-    byteSize = Buffer.byteLength(text, "utf8");
+    text2 = renderFileSection(file);
+    byteSize = Buffer.byteLength(text2, "utf8");
     shrinkBody();
   }
   if (byteSize > sectionBudget) {
     const target = sectionBudget - Buffer.byteLength(SECTION_TRUNCATION_NOTICE, "utf8");
-    const truncated = truncateToBytes(text, Math.max(0, target));
-    text = truncated.content + SECTION_TRUNCATION_NOTICE;
-    byteSize = Buffer.byteLength(text, "utf8");
+    const truncated = truncateToBytes(text2, Math.max(0, target));
+    text2 = truncated.content + SECTION_TRUNCATION_NOTICE;
+    byteSize = Buffer.byteLength(text2, "utf8");
   }
-  return { file, text, byteSize };
+  return { file, text: text2, byteSize };
 }
 function applyTruncatedContent(file, content) {
   file.content = content;
@@ -2088,6 +3932,7 @@ function renderFileSection(file) {
     `- Source Lines: ${file.originalLines}`,
     `- Included Lines: ${file.includedLines}`,
     `- SHA-256: ${file.hashSha256}`,
+    ...file.summaryQuality ? [`- Summary Quality: ${file.summaryQuality}`] : [],
     ...renderSummary(file.summary),
     ...file.summaryOmitted ? ["- Summary: (omitted: exceeds the part budget)"] : [],
     "",
@@ -2298,8 +4143,8 @@ function generateProjectTree(filePaths) {
 }
 
 // src/scanner/binary.ts
-import * as fs6 from "fs";
-import * as path7 from "path";
+import * as fs7 from "fs";
+import * as path8 from "path";
 var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".png",
   ".jpg",
@@ -2339,7 +4184,7 @@ var BINARY_EXTENSIONS = /* @__PURE__ */ new Set([
   ".so"
 ]);
 function isBinaryExtension(filePath) {
-  const ext = path7.extname(filePath).toLowerCase();
+  const ext = path8.extname(filePath).toLowerCase();
   return BINARY_EXTENSIONS.has(ext);
 }
 function isBinaryBuffer(buffer) {
@@ -2353,9 +4198,9 @@ function isBinaryFile(absolutePath) {
   if (isBinaryExtension(absolutePath)) return true;
   let fd;
   try {
-    fd = fs6.openSync(absolutePath, "r");
+    fd = fs7.openSync(absolutePath, "r");
     const buffer = Buffer.alloc(8192);
-    const bytesRead = fs6.readSync(fd, buffer, 0, 8192, 0);
+    const bytesRead = fs7.readSync(fd, buffer, 0, 8192, 0);
     if (bytesRead === 0) return false;
     return isBinaryBuffer(buffer.subarray(0, bytesRead));
   } catch {
@@ -2363,7 +4208,7 @@ function isBinaryFile(absolutePath) {
   } finally {
     if (fd !== void 0) {
       try {
-        fs6.closeSync(fd);
+        fs7.closeSync(fd);
       } catch {
       }
     }
@@ -2372,8 +4217,8 @@ function isBinaryFile(absolutePath) {
 
 // src/validator/validate.ts
 import * as crypto2 from "crypto";
-import * as fs7 from "fs";
-import * as path8 from "path";
+import * as fs8 from "fs";
+import * as path9 from "path";
 function emptyDrift() {
   return {
     missingInSnapshot: [],
@@ -2390,8 +4235,8 @@ function sha256Hex(buffer) {
 function validateSnapshot(configInput) {
   assertUsableConfigInput(configInput);
   const config = isResolvedConfig(configInput) ? normalizeResolvedConfig(configInput) : resolveConfig(configInput);
-  const manifestPath = path8.join(config.cwd, config.outDir, "manifest.json");
-  if (!fs7.existsSync(manifestPath)) {
+  const manifestPath = path9.resolve(config.cwd, config.outDir, "manifest.json");
+  if (!fs8.existsSync(manifestPath)) {
     return {
       valid: false,
       manifestPresent: false,
@@ -2402,7 +4247,7 @@ function validateSnapshot(configInput) {
   }
   let manifest;
   try {
-    manifest = JSON.parse(fs7.readFileSync(manifestPath, "utf8"));
+    manifest = JSON.parse(fs8.readFileSync(manifestPath, "utf8"));
   } catch (err) {
     return {
       valid: false,
@@ -2425,7 +4270,7 @@ function validateSnapshot(configInput) {
   }
   const drift = emptyDrift();
   const warnings = [];
-  const snapshotDir = path8.join(config.cwd, config.outDir);
+  const snapshotDir = path9.resolve(config.cwd, config.outDir);
   const manifestFileMap = /* @__PURE__ */ new Map();
   for (const file of manifest.files) {
     if (file && typeof file.relativePath === "string") {
@@ -2437,7 +4282,7 @@ function validateSnapshot(configInput) {
   );
   const collection = collectFiles(config.cwd, {
     includePatterns: config.include,
-    excludePatterns: config.excludePatterns,
+    excludePatterns: [...config.excludePatterns, ...config.presetExclude],
     includeSensitiveFiles: config.includeSensitiveFiles
   });
   for (const diskFile of collection.files) {
@@ -2449,7 +4294,7 @@ function validateSnapshot(configInput) {
     }
     let diskHash;
     try {
-      diskHash = sha256Hex(fs7.readFileSync(path8.join(config.cwd, diskFile)));
+      diskHash = sha256Hex(fs8.readFileSync(path9.join(config.cwd, diskFile)));
     } catch {
       drift.missingOnDisk.push(diskFile);
       continue;
@@ -2459,10 +4304,11 @@ function validateSnapshot(configInput) {
     }
   }
   for (const snapshotFile of manifestFileMap.keys()) {
-    if (!fs7.existsSync(path8.join(config.cwd, snapshotFile))) {
+    if (!fs8.existsSync(path9.join(config.cwd, snapshotFile))) {
       drift.missingOnDisk.push(snapshotFile);
     }
   }
+  drift.missingOnDisk = [...new Set(drift.missingOnDisk)];
   const maxEffectiveBudget = Math.max(
     config.maxPartBytes,
     config.budgets.default,
@@ -2473,10 +4319,10 @@ function validateSnapshot(configInput) {
     if (!part || typeof part.filename !== "string") continue;
     partNames.add(part.filename);
     if (!config.artifacts.parts) continue;
-    const partPath = path8.join(snapshotDir, "parts", part.filename);
+    const partPath = path9.join(snapshotDir, "parts", part.filename);
     let buffer;
     try {
-      buffer = fs7.readFileSync(partPath);
+      buffer = fs8.readFileSync(partPath);
     } catch {
       drift.partIssues.push({ part: part.filename, issue: "missing from snapshot/parts" });
       continue;
@@ -2563,6 +4409,11 @@ function validateSnapshot(configInput) {
         }
       }
     }
+    if (recorded?.preset !== void 0 && recorded.preset !== config.preset) {
+      drift.configMismatches.push(
+        `preset: manifest ${recorded.preset} vs current ${config.preset}`
+      );
+    }
     if (recorded?.layersMode !== void 0 && recorded.layersMode !== config.layersMode) {
       drift.configMismatches.push(
         `layersMode: manifest ${recorded.layersMode} vs current ${config.layersMode}`
@@ -2580,10 +4431,10 @@ function validateSnapshot(configInput) {
         ...Object.keys(recordedByLayer),
         ...Object.keys(config.budgets.byLayer)
       ]);
-      for (const layer of Array.from(layerNames).sort()) {
-        if (recordedByLayer[layer] !== config.budgets.byLayer[layer]) {
+      for (const layer2 of Array.from(layerNames).sort()) {
+        if (recordedByLayer[layer2] !== config.budgets.byLayer[layer2]) {
           drift.configMismatches.push(
-            `budgets.byLayer.${layer}: manifest ${recordedByLayer[layer]} vs current ${config.budgets.byLayer[layer]}`
+            `budgets.byLayer.${layer2}: manifest ${recordedByLayer[layer2]} vs current ${config.budgets.byLayer[layer2]}`
           );
         }
       }
@@ -2666,9 +4517,9 @@ function validateSnapshot(configInput) {
     ["full-codebase.md", manifest.artifacts?.fullMarkdown]
   ]) {
     if (!artifact) continue;
-    const artifactPath = path8.join(snapshotDir, key);
+    const artifactPath = path9.join(snapshotDir, key);
     try {
-      const buffer = fs7.readFileSync(artifactPath);
+      const buffer = fs8.readFileSync(artifactPath);
       if (sha256Hex(buffer) !== artifact.sha256 || buffer.length !== artifact.byteSize) {
         drift.partIssues.push({ part: key, issue: "artifact does not match its recorded digest" });
       }
@@ -2717,12 +4568,12 @@ function validateSnapshot(configInput) {
 
 // src/index.ts
 var GENERATOR_NAME = "@ankurhalder/codebase-snapshot";
-var GENERATOR_VERSION = "2.0.0";
+var GENERATOR_VERSION = "2.1.1";
 var SCHEMA_VERSION = "3.0.0";
 function sha256Hex2(input) {
   return crypto3.createHash("sha256").update(input).digest("hex");
 }
-var SUMMARY_EXTENSIONS = [
+var TS_EXTENSIONS = [
   ".ts",
   ".mts",
   ".cts",
@@ -2730,24 +4581,21 @@ var SUMMARY_EXTENSIONS = [
   ".js",
   ".mjs",
   ".cjs",
-  ".jsx",
-  ".json",
-  ".jsonc",
-  ".md",
-  ".mdx"
+  ".jsx"
 ];
 function summarizeFile(relativePath, redactedContent) {
   const lower = relativePath.toLowerCase();
-  if (!SUMMARY_EXTENSIONS.some((extension) => lower.endsWith(extension))) {
-    return void 0;
-  }
   if (lower.endsWith(".json") || lower.endsWith(".jsonc")) {
-    return summarizeJson(redactedContent);
+    return { summary: summarizeJson(redactedContent), quality: "structural" };
   }
   if (lower.endsWith(".md") || lower.endsWith(".mdx")) {
-    return summarizeMarkdown(redactedContent);
+    return { summary: summarizeMarkdown(redactedContent), quality: "structural" };
   }
-  return summarizeTypeScriptSource(relativePath, redactedContent);
+  if (TS_EXTENSIONS.some((extension) => lower.endsWith(extension))) {
+    return { summary: summarizeTypeScriptSource(relativePath, redactedContent), quality: "ast" };
+  }
+  const profiled = summarizeWithProfile(relativePath, redactedContent);
+  return profiled ? { summary: profiled.summary, quality: profiled.quality } : void 0;
 }
 function isSourceSummary(summary) {
   return Boolean(summary && typeof summary === "object" && "imports" in summary);
@@ -2773,8 +4621,8 @@ var IMPORT_CANDIDATE_SUFFIXES = [
 ];
 function resolveSpecifier(fromFile, specifier, knownFiles) {
   if (!RELATIVE_SPECIFIER.test(specifier)) return null;
-  const baseDir = path9.posix.dirname(fromFile);
-  const joined = path9.posix.normalize(path9.posix.join(baseDir, specifier));
+  const baseDir = path10.posix.dirname(fromFile);
+  const joined = path10.posix.normalize(path10.posix.join(baseDir, specifier));
   const candidate = joined.replace(/\.(?:js|mjs|cjs|jsx)$/, "");
   for (const suffix of IMPORT_CANDIDATE_SUFFIXES) {
     const withSuffix = `${joined}${suffix}`;
@@ -2866,11 +4714,11 @@ function verifyInMemory(files, parts, maxPartBytes) {
   return errors;
 }
 function resolveSafeOutputDirs(config) {
-  const cwd = path9.resolve(config.cwd);
-  const outDir = path9.resolve(cwd, config.outDir);
-  const tmpDir = path9.resolve(cwd, config.tmpDir);
-  const root = path9.parse(cwd).root;
-  const contains = (parent, child) => child === parent || child.startsWith(`${parent}${path9.sep}`);
+  const cwd = path10.resolve(config.cwd);
+  const outDir = path10.resolve(cwd, config.outDir);
+  const tmpDir = path10.resolve(cwd, config.tmpDir);
+  const root = path10.parse(cwd).root;
+  const contains = (parent, child) => child === parent || child.startsWith(`${parent}${path10.sep}`);
   const reject = (reason) => {
     throw new Error(
       `Refusing to generate: ${reason}. outDir=${outDir} tmpDir=${tmpDir} cwd=${cwd}`
@@ -2889,26 +4737,66 @@ function resolveSafeOutputDirs(config) {
   if (contains(tmpDir, outDir)) reject("outDir is inside tmpDir");
   return { outDir, tmpDir };
 }
+var PLACEHOLDER_ENTRIES = /* @__PURE__ */ new Set([".gitkeep", ".gitignore", ".DS_Store"]);
+var OWNERSHIP_MARKER = ".codebase-snapshot";
+function writeOwnershipMarker(dir) {
+  const marker2 = {
+    generator: GENERATOR_NAME,
+    version: GENERATOR_VERSION,
+    schemaVersion: SCHEMA_VERSION
+  };
+  fs9.writeFileSync(path10.join(dir, OWNERSHIP_MARKER), `${JSON.stringify(marker2, null, 2)}
+`, "utf8");
+}
+function isOwnOutput(dir) {
+  if (fs9.existsSync(path10.join(dir, OWNERSHIP_MARKER))) return true;
+  const manifestPath = path10.join(dir, "manifest.json");
+  if (!fs9.existsSync(manifestPath)) return false;
+  try {
+    const parsed = JSON.parse(fs9.readFileSync(manifestPath, "utf8"));
+    const generator = parsed.generator;
+    return typeof parsed.schemaVersion === "string" && Array.isArray(parsed.files) && typeof generator === "object" && generator !== null && generator.name === GENERATOR_NAME;
+  } catch {
+    return false;
+  }
+}
+function assertReplaceable(target, label) {
+  if (!fs9.existsSync(target)) return;
+  if (!fs9.statSync(target).isDirectory()) {
+    throw new Error(
+      `Refusing to write into ${label} ${target}: it exists but is not a directory.`
+    );
+  }
+  const entries = fs9.readdirSync(target);
+  const meaningful = entries.filter((name) => !PLACEHOLDER_ENTRIES.has(name));
+  if (meaningful.length === 0) return;
+  if (isOwnOutput(target)) return;
+  const preview = meaningful.slice(0, 5).join(", ");
+  const more = meaningful.length > 5 ? `, and ${meaningful.length - 5} more` : "";
+  throw new Error(
+    `Refusing to replace ${label} ${target}: it exists, is not empty, and does not look like a snapshot this generator wrote (found ${preview}${more}). Point ${label} at a new or empty directory, or delete it yourself first.`
+  );
+}
 function swapIntoPlace(tmpDir, outDir) {
   const backupDir = `${outDir}.backup-${process.pid}-${Date.now()}`;
-  const hadPrevious = fs8.existsSync(outDir);
-  if (hadPrevious) fs8.renameSync(outDir, backupDir);
+  const hadPrevious = fs9.existsSync(outDir);
+  if (hadPrevious) fs9.renameSync(outDir, backupDir);
   try {
     try {
-      fs8.renameSync(tmpDir, outDir);
+      fs9.renameSync(tmpDir, outDir);
     } catch (err) {
       if (err.code === "EXDEV") {
-        fs8.cpSync(tmpDir, outDir, { recursive: true });
-        fs8.rmSync(tmpDir, { recursive: true, force: true });
+        fs9.cpSync(tmpDir, outDir, { recursive: true });
+        fs9.rmSync(tmpDir, { recursive: true, force: true });
       } else {
         throw err;
       }
     }
-    if (hadPrevious) fs8.rmSync(backupDir, { recursive: true, force: true });
+    if (hadPrevious) fs9.rmSync(backupDir, { recursive: true, force: true });
   } catch (err) {
-    if (hadPrevious && fs8.existsSync(backupDir)) {
-      if (fs8.existsSync(outDir)) fs8.rmSync(outDir, { recursive: true, force: true });
-      fs8.renameSync(backupDir, outDir);
+    if (hadPrevious && fs9.existsSync(backupDir)) {
+      if (fs9.existsSync(outDir)) fs9.rmSync(outDir, { recursive: true, force: true });
+      fs9.renameSync(backupDir, outDir);
     }
     throw err;
   }
@@ -2924,7 +4812,9 @@ function artifactWarnings(artifacts) {
     );
   }
   if (ARTIFACT_NAMES.every((name) => artifacts[name] === false)) {
-    messages.push("every artifact is disabled: the snapshot directory will be empty.");
+    messages.push(
+      "every artifact is disabled: only the .codebase-snapshot ownership marker will be written."
+    );
   }
   return messages;
 }
@@ -2972,7 +4862,7 @@ function generateSnapshot(configInput, options) {
   const gitInfo = getGitInfo(config.cwd, config.branch);
   const collection = collectFiles(config.cwd, {
     includePatterns: config.include,
-    excludePatterns: config.excludePatterns,
+    excludePatterns: [...config.excludePatterns, ...config.presetExclude],
     includeSensitiveFiles: config.includeSensitiveFiles
   });
   const files = [];
@@ -2985,10 +4875,10 @@ function generateSnapshot(configInput, options) {
   let totalSizeBytes = 0;
   let largeFileCount = 0;
   for (const relativePath of collection.files) {
-    const absolutePath = path9.join(config.cwd, relativePath);
+    const absolutePath = path10.join(config.cwd, relativePath);
     let stats;
     try {
-      stats = fs8.statSync(absolutePath);
+      stats = fs9.statSync(absolutePath);
       if (!stats.isFile()) {
         skipped.push({ path: relativePath, reason: "not-file" });
         continue;
@@ -3003,7 +4893,7 @@ function generateSnapshot(configInput, options) {
     }
     let buffer;
     try {
-      buffer = fs8.readFileSync(absolutePath);
+      buffer = fs9.readFileSync(absolutePath);
     } catch {
       skipped.push({ path: relativePath, reason: "read-error" });
       continue;
@@ -3013,10 +4903,10 @@ function generateSnapshot(configInput, options) {
     const lineCount = countLines(rawContent);
     totalLines += lineCount;
     totalSizeBytes += stats.size;
-    const layer = classifyLayer(relativePath, config.layers);
+    const layer2 = classifyLayer(relativePath, config.layers);
     const kind = classifyKind(relativePath, config.kinds);
     const language = detectLanguage(relativePath);
-    bump(layerCounts, layer);
+    bump(layerCounts, layer2);
     bump(kindCounts, kind);
     const { redacted, findings } = scanAndRedactSecrets(
       rawContent,
@@ -3040,8 +4930,11 @@ function generateSnapshot(configInput, options) {
       includedLines = preview.includedLines;
     }
     let summary;
+    let summaryQuality;
     try {
-      summary = summarizeFile(relativePath, redacted);
+      const outcome = summarizeFile(relativePath, redacted);
+      summary = outcome?.summary;
+      summaryQuality = outcome?.quality;
       if (isSourceSummary(summary) && summary.parseErrors) {
         warnings.push(
           `Parse errors in ${relativePath} (${summary.parseErrors}); its summary is incomplete.`
@@ -3058,7 +4951,7 @@ function generateSnapshot(configInput, options) {
       lines: lineCount,
       hashSha256,
       part: "",
-      layer,
+      layer: layer2,
       kind,
       language,
       inclusionMode: isPreviewTruncated ? "preview" : "full",
@@ -3068,6 +4961,7 @@ function generateSnapshot(configInput, options) {
       includedLines,
       includedBytes: Buffer.byteLength(finalContent, "utf8"),
       summary,
+      summaryQuality,
       content: finalContent
     });
   }
@@ -3108,10 +5002,11 @@ function generateSnapshot(configInput, options) {
       includeSensitiveFiles: config.includeSensitiveFiles,
       artifacts: { ...config.artifacts },
       include: [...config.include],
+      preset: config.preset,
       layersMode: config.layersMode,
       budgets: { default: config.budgets.default, byLayer: { ...config.budgets.byLayer } },
       excludePatterns: [...config.excludePatterns],
-      layers: config.layers.map((layer) => layer.name),
+      layers: config.layers.map((layer2) => layer2.name),
       kinds: config.kinds.map((kind) => kind.kind)
     },
     counts: {
@@ -3198,45 +5093,48 @@ function generateSnapshot(configInput, options) {
     return manifest;
   }
   const { outDir, tmpDir } = resolveSafeOutputDirs(config);
+  assertReplaceable(tmpDir, "tmpDir");
+  assertReplaceable(outDir, "outDir");
   const { artifacts } = config;
-  fs8.rmSync(tmpDir, { recursive: true, force: true });
-  fs8.mkdirSync(tmpDir, { recursive: true });
-  const partsDir = path9.join(tmpDir, "parts");
-  const reportsDir = path9.join(tmpDir, "reports");
-  if (artifacts.parts) fs8.mkdirSync(partsDir, { recursive: true });
+  fs9.rmSync(tmpDir, { recursive: true, force: true });
+  fs9.mkdirSync(tmpDir, { recursive: true });
+  writeOwnershipMarker(tmpDir);
+  const partsDir = path10.join(tmpDir, "parts");
+  const reportsDir = path10.join(tmpDir, "reports");
+  if (artifacts.parts) fs9.mkdirSync(partsDir, { recursive: true });
   if (artifacts.navigation || artifacts.projectTree || artifacts.audit) {
-    fs8.mkdirSync(reportsDir, { recursive: true });
+    fs9.mkdirSync(reportsDir, { recursive: true });
   }
   if (artifacts.parts) {
     for (const part of parts) {
-      fs8.writeFileSync(path9.join(partsDir, part.filename), part.markdown, "utf8");
+      fs9.writeFileSync(path10.join(partsDir, part.filename), part.markdown, "utf8");
     }
   }
   if (artifacts.projectTree) {
     const projectTree = generateProjectTree(files.map((file) => file.relativePath));
-    fs8.writeFileSync(path9.join(reportsDir, "project-tree.md"), projectTree, "utf8");
+    fs9.writeFileSync(path10.join(reportsDir, "project-tree.md"), projectTree, "utf8");
   }
   if (artifacts.navigation) {
-    fs8.writeFileSync(path9.join(reportsDir, "navigation.md"), generateNavigation(manifest), "utf8");
+    fs9.writeFileSync(path10.join(reportsDir, "navigation.md"), generateNavigation(manifest), "utf8");
   }
   if (artifacts.audit) {
-    fs8.writeFileSync(
-      path9.join(reportsDir, "audit.md"),
+    fs9.writeFileSync(
+      path10.join(reportsDir, "audit.md"),
       generateAuditReport(manifest, secretFindings),
       "utf8"
     );
   }
   if (artifacts.readme) {
-    fs8.writeFileSync(path9.join(tmpDir, "README.md"), generateReadme(manifest), "utf8");
+    fs9.writeFileSync(path10.join(tmpDir, "README.md"), generateReadme(manifest), "utf8");
   }
   if (artifacts.manifest) {
-    fs8.writeFileSync(path9.join(tmpDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
+    fs9.writeFileSync(path10.join(tmpDir, "manifest.json"), JSON.stringify(manifest, null, 2), "utf8");
   }
   if (monolithJson !== null) {
-    fs8.writeFileSync(path9.join(tmpDir, "full-codebase.json"), monolithJson, "utf8");
+    fs9.writeFileSync(path10.join(tmpDir, "full-codebase.json"), monolithJson, "utf8");
   }
   if (monolithMarkdown !== null) {
-    fs8.writeFileSync(path9.join(tmpDir, "full-codebase.md"), monolithMarkdown, "utf8");
+    fs9.writeFileSync(path10.join(tmpDir, "full-codebase.md"), monolithMarkdown, "utf8");
   }
   swapIntoPlace(tmpDir, outDir);
   runAfterGenerate(config, manifest);
@@ -3276,6 +5174,12 @@ var CLI_OPTIONS = {
   mode: { type: "string" },
   "dry-run": { type: "boolean" },
   watch: { type: "boolean" },
+  preset: { type: "string" },
+  include: { type: "string" },
+  exclude: { type: "string" },
+  yes: { type: "boolean" },
+  minimal: { type: "boolean" },
+  force: { type: "boolean" },
   help: { type: "boolean", short: "h" },
   version: { type: "boolean", short: "v" }
 };
@@ -3313,6 +5217,14 @@ Options:
   --format <text|json>          CLI output format (default: text)
   --dry-run                     Compute the snapshot without writing anything
   --watch                       Re-generate whenever the repository changes
+
+  init only:
+  --preset <name>               Force a project preset instead of detecting one
+  --include <globs>             Comma-separated allow-list
+  --exclude <globs>             Comma-separated exclude patterns
+  --minimal                     Write only the settings that differ from defaults
+  --yes                         Accept every default without prompting
+  --force                       Overwrite an existing config
   -h, --help                    Display this help message
   -v, --version                 Display version
 
@@ -3357,9 +5269,32 @@ function parseCliArgs(argv) {
       strict: true
     });
   } catch (err) {
-    throw new UsageError(err.message);
+    const message = err.message;
+    const ambiguous = /^Option '(--[^']+)' argument is ambiguous/i.exec(message);
+    if (ambiguous) {
+      throw new UsageError(
+        `${ambiguous[1]} received a value that looks like another flag (for example a negative number). Use the "--option=value" form, and note that sizes must be positive.`
+      );
+    }
+    throw new UsageError(message);
   }
   const values = parsed.values;
+  for (const [name, spec] of Object.entries(CLI_OPTIONS)) {
+    if (spec.type !== "string") continue;
+    const raw = values[name];
+    if (raw !== void 0 && String(raw).trim() === "") {
+      throw new UsageError(`--${name} requires a value (received an empty string).`);
+    }
+  }
+  if (values.cwd !== void 0) {
+    const target = String(values.cwd);
+    if (!fs10.existsSync(target)) {
+      throw new UsageError(`--cwd directory does not exist: ${target}`);
+    }
+    if (!fs10.statSync(target).isDirectory()) {
+      throw new UsageError(`--cwd is not a directory: ${target}`);
+    }
+  }
   if (values.help) {
     process.stdout.write(`${USAGE}
 `);
@@ -3425,13 +5360,38 @@ function parseCliArgs(argv) {
   } else if (rawSkip !== void 0) {
     skipArtifacts = parseArtifactList(String(rawSkip), "--skip-artifacts");
   }
+  if (command !== "init") {
+    const initOnly = [];
+    if (values.preset !== void 0) initOnly.push("--preset");
+    if (values.include !== void 0) initOnly.push("--include");
+    if (values.exclude !== void 0) initOnly.push("--exclude");
+    if (values.yes === true) initOnly.push("--yes");
+    if (values.minimal === true) initOnly.push("--minimal");
+    if (values.force === true) initOnly.push("--force");
+    if (initOnly.length > 0) {
+      throw new UsageError(
+        `${initOnly.join(", ")} ${initOnly.length === 1 ? "is" : "are"} only valid with \`init\`. To scope \`${command}\`, set include/excludePatterns/preset in snapshot.config.ts (or run \`snap init\` to generate one).`
+      );
+    }
+  }
+  if (command === "init" && values.preset !== void 0) {
+    const requested = String(values.preset);
+    if (!getPreset(requested)) throw new UsageError(unknownPresetMessage(requested));
+  }
   return {
     command,
     args,
     format: rawFormat,
     dryRun: values["dry-run"] === true,
     watch: values.watch === true,
-    cwd: values.cwd === void 0 ? process.cwd() : path10.resolve(String(values.cwd)),
+    preset: values.preset === void 0 ? void 0 : String(values.preset),
+    maxPartBytesRaw: values["max-part-bytes"] === void 0 ? void 0 : String(values["max-part-bytes"]),
+    include: values.include === void 0 ? void 0 : String(values.include),
+    exclude: values.exclude === void 0 ? void 0 : String(values.exclude),
+    yes: values.yes === true,
+    minimal: values.minimal === true,
+    force: values.force === true,
+    cwd: values.cwd === void 0 ? process.cwd() : path11.resolve(String(values.cwd)),
     outDir: values["out-dir"] === void 0 ? void 0 : String(values["out-dir"]),
     includeMonolith: values["include-monolith"] === true ? true : void 0,
     includeSensitiveFiles: values["include-sensitive-files"] === true ? true : void 0,
@@ -3471,32 +5431,65 @@ function emit(format, payload, textRenderer) {
   }
   textRenderer();
 }
-function runInit(cwd) {
-  const targetName = supportsTypeScriptImports() ? "snapshot.config.ts" : "snapshot.config.mjs";
-  const targetPath = path10.join(cwd, targetName);
-  if (fs9.existsSync(targetPath)) {
-    warn(`\u274C ${targetName} already exists in ${cwd}.`);
+function splitList(value) {
+  if (value === void 0) return void 0;
+  return value.split(",").map((entry) => entry.trim()).filter(Boolean);
+}
+function describeManifestShapeProblem(manifest) {
+  if (!manifest || typeof manifest !== "object" || Array.isArray(manifest)) {
+    return "not a JSON object";
+  }
+  const candidate = manifest;
+  const counts = candidate.counts;
+  if (!counts || typeof counts !== "object") return "missing `counts`";
+  for (const key of ["totalFiles", "totalLines", "totalSizeBytes", "partsCount"]) {
+    if (typeof counts[key] !== "number") return `missing numeric \`counts.${key}\``;
+  }
+  if (!candidate.layers || typeof candidate.layers !== "object") return "missing `layers`";
+  if (!Array.isArray(candidate.files)) return "missing `files` array";
+  return null;
+}
+async function runInitCommand(invocation) {
+  try {
+    const result = await runInit({
+      cwd: invocation.cwd,
+      preset: invocation.preset,
+      maxPartBytes: invocation.maxPartBytesRaw ?? invocation.maxPartBytes,
+      include: splitList(invocation.include),
+      exclude: splitList(invocation.exclude),
+      skipArtifacts: invocation.skipArtifacts,
+      includeSensitiveFiles: invocation.includeSensitiveFiles,
+      yes: invocation.yes,
+      minimal: invocation.minimal,
+      force: invocation.force,
+      dryRun: invocation.dryRun
+    });
+    if (invocation.format === "json") {
+      process.stdout.write(`${JSON.stringify(result, null, 2)}
+`);
+      return 0;
+    }
+    if (!result.written) {
+      info(result.configText);
+      return 0;
+    }
+    info(`\u2705 Created ${path11.basename(result.configPath)} (preset: ${result.preset})`);
+    if (result.scripts.length > 0) info(`   Added npm scripts: ${result.scripts.join(", ")}`);
+    if (result.gitignoreEntries.length > 0) {
+      info(`   Added to .gitignore: ${result.gitignoreEntries.join(", ")}`);
+    }
+    for (const note of result.notes) info(`   \u26A0 ${note}`);
+    info("");
+    info("   Next:  npm run snapshot");
+    return 0;
+  } catch (err) {
+    if (err instanceof PromptCancelled) {
+      warn("\u274C Cancelled.");
+      return 1;
+    }
+    warn(`\u274C ${err.message}`);
     return 1;
   }
-  const importPath = JSON.stringify(GENERATOR_NAME);
-  const starter = `import { defineConfig } from ${importPath};
-
-export default defineConfig({
-  branch: "main",
-  outDir: "snapshot",
-  maxPartBytes: 300 * 1024,
-  largeFileBytes: 200 * 1024,
-  excludePatterns: [],
-});
-`;
-  fs9.writeFileSync(targetPath, starter, "utf8");
-  info(`\u2705 Created ${targetName} in ${cwd}`);
-  if (targetName.endsWith(".mjs")) {
-    info(
-      "   (a .ts config needs Node >= 22.6 to import natively; this Node writes a .mjs instead)"
-    );
-  }
-  return 0;
 }
 function renderValidateText(result) {
   if (result.valid) {
@@ -3519,6 +5512,9 @@ function renderValidateText(result) {
     for (const missing of result.drift.missingOnDisk.slice(0, 20)) {
       warn(`  - deleted: ${missing}`);
     }
+    for (const mismatch of result.drift.totalsMismatches.slice(0, 20)) {
+      warn(`  - counts: ${mismatch}`);
+    }
   }
   for (const warning of result.warnings) warn(`  \u26A0 ${warning}`);
 }
@@ -3538,11 +5534,15 @@ ${USAGE}
     throw err;
   }
   if (invocation.command === "init") {
-    return runInit(invocation.cwd);
+    return await runInitCommand(invocation);
   }
   const loaded = await loadConfigFileDetailed(invocation.cwd);
   for (const warning of loaded.warnings) warn(`\u26A0 Config: ${warning}`);
-  if (loaded.file) info(`\u2699  Using config ${path10.relative(process.cwd(), loaded.file) || loaded.file}`);
+  if (loaded.errors.length > 0) {
+    warn("\u274C The config file could not be read. Fix it, or delete it to use the defaults.");
+    return 1;
+  }
+  if (loaded.file) info(`\u2699  Using config ${path11.relative(process.cwd(), loaded.file) || loaded.file}`);
   const resolved = resolveConfig(
     loaded.config,
     {
@@ -3566,18 +5566,23 @@ ${USAGE}
     return result.valid ? 0 : 1;
   }
   if (invocation.command === "report") {
-    const manifestPath = path10.join(resolved.cwd, resolved.outDir, "manifest.json");
-    if (!fs9.existsSync(manifestPath)) {
+    const manifestPath = path11.resolve(resolved.cwd, resolved.outDir, "manifest.json");
+    if (!fs10.existsSync(manifestPath)) {
       warn(`\u274C Manifest not found at ${manifestPath}. Run generate first.`);
       return 1;
     }
     let manifest;
     try {
-      manifest = JSON.parse(fs9.readFileSync(manifestPath, "utf8"));
+      manifest = JSON.parse(fs10.readFileSync(manifestPath, "utf8"));
     } catch (err) {
       warn(`\u274C Could not read ${manifestPath}: ${err.message}`);
       return 1;
     }
+    const shapeError = describeManifestShapeProblem(manifest);
+    if (shapeError) {
+      warn(`\u274C ${manifestPath} is not a snapshot manifest: ${shapeError}`);
+      return 1;
+    }
     const validation = validateSnapshot(resolved);
     emit(invocation.format, { manifest, validation }, () => {
       info(`
@@ -3594,8 +5599,8 @@ ${USAGE}
       info(`   - Integrity:      ${validation.valid ? "\u2705 Clean (no drift)" : "\u274C Drift detected"}`);
       info(`   - Warnings:       ${manifest.warnings?.length ?? 0}`);
       info("\n   Layers:");
-      for (const [layer, count] of Object.entries(manifest.layers)) {
-        info(`     - ${layer.padEnd(16)}: ${count} files`);
+      for (const [layer2, count] of Object.entries(manifest.layers)) {
+        info(`     - ${layer2.padEnd(16)}: ${count} files`);
       }
     });
     return validation.valid ? 0 : 1;
@@ -3640,9 +5645,23 @@ ${USAGE}
       info(
         `   - Total size:    ${(manifest.counts.totalSizeBytes / (1024 * 1024)).toFixed(2)} MB`
       );
-      info(`   - Parts written: ${manifest.counts.partsCount} under ${resolved.outDir}/parts/`);
-      info(`   - Reports:       ${resolved.outDir}/reports/ (project-tree, navigation, audit)`);
-      info(`   - Manifest:      ${resolved.outDir}/manifest.json`);
+      const { artifacts } = resolved;
+      if (artifacts.parts) {
+        info(`   - Parts written: ${manifest.counts.partsCount} under ${resolved.outDir}/parts/`);
+      }
+      const reports = [
+        artifacts.projectTree && "project-tree",
+        artifacts.navigation && "navigation",
+        artifacts.audit && "audit"
+      ].filter(Boolean);
+      if (reports.length > 0) {
+        info(`   - Reports:       ${resolved.outDir}/reports/ (${reports.join(", ")})`);
+      }
+      if (artifacts.manifest) info(`   - Manifest:      ${resolved.outDir}/manifest.json`);
+      if (artifacts.monolith) info(`   - Monolith:      ${resolved.outDir}/full-codebase.{json,md}`);
+      if (reports.length === 0 && !artifacts.parts && !artifacts.manifest && !artifacts.monolith) {
+        info(`   - Artifacts:     all disabled (only the ownership marker was written)`);
+      }
       info(`   - Fingerprint:   ${manifest.fingerprint}`);
       info(`   - Integrity:     ${manifest.validation.status}`);
       if (manifest.warnings.length > 0) {
@@ -3659,15 +5678,23 @@ ${USAGE}
     }
     return manifest.validation.status === "passed" ? 0 : 1;
   } catch (err) {
+    const code = err.code;
+    if (code === "EPERM" || code === "EACCES") {
+      warn(
+        `\u274C Cannot write the snapshot: permission denied under ${resolved.outDir}. Check the directory's permissions or choose another --out-dir.`
+      );
+      warn(`   (${err.message})`);
+      return 1;
+    }
     warn(`\u274C Failed to generate snapshot: ${err.message}`);
     return 1;
   }
 }
 async function runWatchLoop(invocation, resolved) {
-  const outDir = path10.resolve(resolved.cwd, resolved.outDir);
-  const tmpDir = path10.resolve(resolved.cwd, resolved.tmpDir);
-  const outName = path10.basename(outDir).toLowerCase();
-  const tmpName = path10.basename(tmpDir).toLowerCase();
+  const outDir = path11.resolve(resolved.cwd, resolved.outDir);
+  const tmpDir = path11.resolve(resolved.cwd, resolved.tmpDir);
+  const outName = path11.basename(outDir).toLowerCase();
+  const tmpName = path11.basename(tmpDir).toLowerCase();
   const isGenerated = (candidate) => candidate.toLowerCase().split(/[\\/]/).some(
     (segment) => segment === outName || segment === tmpName || segment.startsWith(`${outName}.backup-`)
   );
@@ -3691,19 +5718,19 @@ async function runWatchLoop(invocation, resolved) {
   info("\u{1F440} Watching for changes. Press Ctrl+C to stop.");
   regenerate();
   let timer = null;
-  const watcher = fs9.watch(resolved.cwd, { recursive: true }, (_event, filename) => {
+  const watcher = fs10.watch(resolved.cwd, { recursive: true }, (_event, filename) => {
     if (filename) {
-      const changed = path10.resolve(resolved.cwd, filename.toString());
+      const changed = path11.resolve(resolved.cwd, filename.toString());
       if (isGenerated(changed)) return;
     }
     if (timer) clearTimeout(timer);
     timer = setTimeout(regenerate, 250);
   });
-  await new Promise((resolve5) => {
+  await new Promise((resolve6) => {
     const stop = () => {
       if (timer) clearTimeout(timer);
       watcher.close();
-      resolve5();
+      resolve6();
     };
     process.once("SIGINT", stop);
     process.once("SIGTERM", stop);