@launchsecure/launch-kit 0.0.40 → 0.0.42

package/dist/server/cli.js

@@ -23468,8 +23468,8 @@ function getQuery(name) {
   ensureInit();
   const cached = queryCache.get(name);
   if (cached) return cached;
-  const scmPath = (0, import_node_path20.join)(queriesDir, `${name}.scm`);
-  const scm = (0, import_node_fs16.readFileSync)(scmPath, "utf-8");
+  const scmPath = (0, import_node_path22.join)(queriesDir, `${name}.scm`);
+  const scm = (0, import_node_fs17.readFileSync)(scmPath, "utf-8");
   const query = tsxLanguage.query(scm);
   queryCache.set(name, query);
   return query;
@@ -23489,13 +23489,13 @@ function parseSource(absPath) {
   ensureInit();
   let content;
   try {
-    const stat = (0, import_node_fs16.statSync)(absPath);
+    const stat = (0, import_node_fs17.statSync)(absPath);
     if (stat.size > MAX_PARSEABLE_BYTES) {
       process.stderr.write(`[lc-extractor] skipping ${absPath}: ${stat.size} bytes exceeds max ${MAX_PARSEABLE_BYTES}
 `);
       return null;
     }
-    content = (0, import_node_fs16.readFileSync)(absPath, "utf-8");
+    content = (0, import_node_fs17.readFileSync)(absPath, "utf-8");
   } catch (e) {
     process.stderr.write(`[lc-extractor] read failed for ${absPath}: ${e instanceof Error ? e.message : String(e)}
 `);
@@ -24529,18 +24529,18 @@ function collectUiLabels(root) {
   visit(root);
   return out;
 }
-var import_node_fs16, import_node_path20, tsxLanguage, parserInstance, TreeSitterCtor, initPromise, initialized, queriesDir, queryCache, MAX_PARSEABLE_BYTES, MAX_CONSECUTIVE_PARSE_FAILURES, consecutiveParseFailures, ParseCascadeError, PRISMA_MUTATION_METHODS_BUILTIN, SUPABASE_MUTATION_METHODS_BUILTIN, DB_IDENTIFIERS_FALLBACK, extraDbIdentifiers, extraMutationMethods, INLINE_AUTH_IMPORTS, EXEMPT_NAME_PATTERNS, PROTECT_NAME_PATTERNS, TRUST_AS_PROTECT_KEYS, TIMER_FNS, DOM_METHOD_NAMES, CLASSLIST_METHODS, STORAGE_OBJECTS, HISTORY_METHODS, LOCATION_METHODS, ASSIGN_DOM_PROPS, UI_LABEL_KEYS, UI_LABELS_MAX, NOTE_REGEX, NOTES_MAX;
+var import_node_fs17, import_node_path22, tsxLanguage, parserInstance, TreeSitterCtor, initPromise, initialized, queriesDir, queryCache, MAX_PARSEABLE_BYTES, MAX_CONSECUTIVE_PARSE_FAILURES, consecutiveParseFailures, ParseCascadeError, PRISMA_MUTATION_METHODS_BUILTIN, SUPABASE_MUTATION_METHODS_BUILTIN, DB_IDENTIFIERS_FALLBACK, extraDbIdentifiers, extraMutationMethods, INLINE_AUTH_IMPORTS, EXEMPT_NAME_PATTERNS, PROTECT_NAME_PATTERNS, TRUST_AS_PROTECT_KEYS, TIMER_FNS, DOM_METHOD_NAMES, CLASSLIST_METHODS, STORAGE_OBJECTS, HISTORY_METHODS, LOCATION_METHODS, ASSIGN_DOM_PROPS, UI_LABEL_KEYS, UI_LABELS_MAX, NOTE_REGEX, NOTES_MAX;
 var init_ts_extractor = __esm({
   "src/server/graph/core/ts-extractor.ts"() {
     "use strict";
-    import_node_fs16 = require("node:fs");
-    import_node_path20 = require("node:path");
+    import_node_fs17 = require("node:fs");
+    import_node_path22 = require("node:path");
     init_parse_failure_cache();
     initialized = false;
     queriesDir = (() => {
-      const srcPath = (0, import_node_path20.join)((0, import_node_path20.dirname)(__filename), "..", "queries");
+      const srcPath = (0, import_node_path22.join)((0, import_node_path22.dirname)(__filename), "..", "queries");
       if (require("fs").existsSync(srcPath)) return srcPath;
-      return (0, import_node_path20.join)((0, import_node_path20.dirname)(__filename), "graph", "queries");
+      return (0, import_node_path22.join)((0, import_node_path22.dirname)(__filename), "graph", "queries");
     })();
     queryCache = /* @__PURE__ */ new Map();
     MAX_PARSEABLE_BYTES = 2 * 1024 * 1024;
@@ -24680,7 +24680,7 @@ __export(watcher_exports, {
 function isIgnoredPath(rel) {
   if (rel.startsWith(GRAPHS_RELATIVE)) return true;
   if (rel.endsWith(".lock") || rel.endsWith(".log")) return true;
-  for (const part of rel.split(import_node_path35.sep)) {
+  for (const part of rel.split(import_node_path37.sep)) {
     if (IGNORE_SEGMENTS.has(part)) return true;
   }
   return false;
@@ -24722,7 +24722,7 @@ function startGraphWatcher(rootDir, opts = {}) {
       regenerating = false;
     }
   }
-  const watcher = (0, import_node_fs28.watch)(rootDir, { recursive: true }, (event, filename) => {
+  const watcher = (0, import_node_fs29.watch)(rootDir, { recursive: true }, (event, filename) => {
     if (!filename) return;
     const rel = filename.toString();
     if (process.env.LAUNCH_CHART_WATCH_TRACE === "1") {
@@ -24755,12 +24755,12 @@ function startGraphWatcher(rootDir, opts = {}) {
     freshness: () => getFreshnessTracker(rootDir).get()
   };
 }
-var import_node_fs28, import_node_path35, IGNORE_SEGMENTS, TRIGGER_EXTENSIONS, GRAPHS_RELATIVE;
+var import_node_fs29, import_node_path37, IGNORE_SEGMENTS, TRIGGER_EXTENSIONS, GRAPHS_RELATIVE;
 var init_watcher = __esm({
   "src/server/graph/core/watcher.ts"() {
     "use strict";
-    import_node_fs28 = require("node:fs");
-    import_node_path35 = require("node:path");
+    import_node_fs29 = require("node:fs");
+    import_node_path37 = require("node:path");
     init_launch_kit_paths();
     init_graph();
     init_freshness();
@@ -24789,7 +24789,7 @@ var init_watcher = __esm({
       ".prisma",
       ".sql"
     ]);
-    GRAPHS_RELATIVE = (0, import_node_path35.join)(LAUNCHSECURE_DIR, "graphs");
+    GRAPHS_RELATIVE = (0, import_node_path37.join)(LAUNCHSECURE_DIR, "graphs");
   }
 });
 
@@ -29771,8 +29771,8 @@ function streamTranscript(opts) {
 }
 
 // src/server/graph-mcp.ts
-var import_node_fs29 = require("node:fs");
-var import_node_path36 = require("node:path");
+var import_node_fs30 = require("node:fs");
+var import_node_path38 = require("node:path");
 var import_node_child_process3 = require("node:child_process");
 var import_node_os6 = require("node:os");
 init_launch_kit_paths();
@@ -29811,31 +29811,209 @@ export const ${exportName} = {
   return { exportName, code };
 }
 
+// src/server/graph/core/context/snippet-registry.ts
+var import_node_fs13 = require("node:fs");
+var import_node_path17 = require("node:path");
+var DEFAULT_SNIPPETS_DIR = "tests/snippets";
+function parseStringArray(src, key) {
+  const m = src.match(new RegExp(`${key}\\s*:\\s*\\[([^\\]]*)\\]`));
+  if (!m) return [];
+  return [...m[1].matchAll(/['"]([^'"]+)['"]/g)].map((x) => x[1]);
+}
+function parseSnippetFile(content, file) {
+  const idM = content.match(/\bid\s*:\s*['"]([^'"]+)['"]/);
+  if (!idM) return null;
+  const exportM = content.match(/export\s+const\s+(\w+)/);
+  return {
+    id: idM[1],
+    exportName: exportM ? exportM[1] : "default",
+    file,
+    requires: parseStringArray(content, "requires"),
+    produces: parseStringArray(content, "produces"),
+    params: parseStringArray(content, "params")
+  };
+}
+function loadSnippetIndex(rootDir, snippetsDir = DEFAULT_SNIPPETS_DIR) {
+  const dir = (0, import_node_path17.join)(rootDir, snippetsDir);
+  const index = /* @__PURE__ */ new Map();
+  if (!(0, import_node_fs13.existsSync)(dir)) return index;
+  for (const f of (0, import_node_fs13.readdirSync)(dir)) {
+    if (!f.endsWith(".ts") && !f.endsWith(".tsx")) continue;
+    const full = (0, import_node_path17.join)(dir, f);
+    try {
+      if (!(0, import_node_fs13.statSync)(full).isFile()) continue;
+      const entry = parseSnippetFile((0, import_node_fs13.readFileSync)(full, "utf-8"), (0, import_node_path17.join)(snippetsDir, f));
+      if (entry) index.set(entry.id, entry);
+    } catch {
+    }
+  }
+  return index;
+}
+
+// src/server/graph/core/context/test-plan.ts
+var stripState = (s) => s.replace(/^state:/, "");
+function buildTestPlan(graph, targetId, snippets) {
+  const nodesById = /* @__PURE__ */ new Map();
+  for (const n of graph.nodes) nodesById.set(n.id, n);
+  const requiresOf = /* @__PURE__ */ new Map();
+  const producesOf = /* @__PURE__ */ new Map();
+  const producersOf = /* @__PURE__ */ new Map();
+  for (const e of graph.edges) {
+    if (e.type === "requires") {
+      (requiresOf.get(e.source) ?? requiresOf.set(e.source, /* @__PURE__ */ new Set()).get(e.source)).add(e.target);
+    } else if (e.type === "produces") {
+      (producesOf.get(e.source) ?? producesOf.set(e.source, /* @__PURE__ */ new Set()).get(e.source)).add(e.target);
+      (producersOf.get(e.target) ?? producersOf.set(e.target, /* @__PURE__ */ new Set()).get(e.target)).add(e.source);
+    }
+  }
+  const pickProducer = (producers) => {
+    const withSnippet = producers.filter((p) => snippets.has(p)).sort();
+    return withSnippet.length ? withSnippet[0] : [...producers].sort()[0];
+  };
+  const order = [];
+  const done = /* @__PURE__ */ new Set();
+  const visiting = /* @__PURE__ */ new Set();
+  const gaps = [];
+  const allRequired = /* @__PURE__ */ new Set();
+  const visit = (actionId2) => {
+    if (done.has(actionId2)) return;
+    if (visiting.has(actionId2)) {
+      gaps.push({ type: "cycle", action: actionId2, detail: `dependency cycle through ${actionId2}` });
+      return;
+    }
+    visiting.add(actionId2);
+    for (const state of requiresOf.get(actionId2) ?? []) {
+      allRequired.add(state);
+      const producers = [...producersOf.get(state) ?? []];
+      if (producers.length === 0) {
+        gaps.push({
+          type: "no_producer",
+          state: stripState(state),
+          action: actionId2,
+          detail: `${actionId2} requires "${stripState(state)}" but no action produces it`
+        });
+        continue;
+      }
+      visit(pickProducer(producers));
+    }
+    visiting.delete(actionId2);
+    done.add(actionId2);
+    order.push(actionId2);
+  };
+  visit(targetId);
+  const steps = order.map((actionId2) => {
+    const node = nodesById.get(actionId2);
+    const entry = snippets.get(actionId2) ?? null;
+    if (!entry) {
+      gaps.push({
+        type: "no_snippet",
+        action: actionId2,
+        detail: `no snippet bound to ${actionId2} \u2014 scaffold one with scaffold_snippet`
+      });
+    }
+    const satisfies = [...producesOf.get(actionId2) ?? []].filter((s) => allRequired.has(s)).map(stripState).sort();
+    return {
+      action: actionId2,
+      name: String(node?.name ?? actionId2),
+      satisfies,
+      snippet: entry ? { id: entry.id, exportName: entry.exportName, file: entry.file, params: entry.params } : null
+    };
+  });
+  return { target: targetId, steps, gaps, runnable: gaps.length === 0 };
+}
+
+// src/server/graph/core/context/spec-gen.ts
+var import_node_path18 = require("node:path");
+function toEnvRef(name) {
+  return `process.env.${name.replace(/([a-z0-9])([A-Z])/g, "$1_$2").toUpperCase()}`;
+}
+function classify(name) {
+  const n = name.toLowerCase();
+  if (/pass|secret|token|credential|apikey|api_key|_key$|^key$/.test(n)) return { kind: "secret" };
+  if (/email|slug|(^|_)id$|uuid|userid|orgid|projectid/.test(n)) return { kind: "real" };
+  if (/desc|summary|body|message|content|note/.test(n)) return { kind: "faker", faker: "faker.lorem.sentence()" };
+  if (/colou?r/.test(n)) return { kind: "faker", faker: "faker.color.rgb({ format: 'hex' })" };
+  if (/icon/.test(n)) return { kind: "faker", faker: "faker.helpers.arrayElement(['rocket','bug','star','flag','zap','heart'])" };
+  if (/name|title|label/.test(n)) return { kind: "faker", faker: "faker.word.noun()" };
+  if (/url|link|href/.test(n)) return { kind: "faker", faker: "faker.internet.url()" };
+  if (/count|qty|quantity|amount|number|price/.test(n)) return { kind: "faker", faker: "String(faker.number.int({ min: 1, max: 100 }))" };
+  return { kind: "faker", faker: "faker.lorem.word()" };
+}
+function relImport(specDir, file) {
+  let r = (0, import_node_path18.relative)(specDir, file).replace(/\.tsx?$/, "");
+  if (!r.startsWith(".")) r = `./${r}`;
+  return r;
+}
+function generateSpec(plan, opts = {}) {
+  const specDir = opts.specDir ?? "tests/generated";
+  const fixtures = opts.fixtures ?? {};
+  const missing = /* @__PURE__ */ new Set();
+  let usesFaker = false;
+  const bound = plan.steps.filter((s) => s.snippet);
+  const unbound = plan.steps.filter((s) => !s.snippet);
+  const importLines = /* @__PURE__ */ new Set();
+  for (const s of bound) {
+    importLines.add(`import { ${s.snippet.exportName} } from '${relImport(specDir, s.snippet.file)}';`);
+  }
+  const callLines = bound.map((s) => {
+    const params = s.snippet.params.map((p) => {
+      if (Object.prototype.hasOwnProperty.call(fixtures, p)) {
+        return `    ${p}: ${JSON.stringify(fixtures[p])},`;
+      }
+      const c = classify(p);
+      if (c.kind === "secret") return `    ${p}: ${toEnvRef(p)},`;
+      if (c.kind === "faker") {
+        usesFaker = true;
+        return `    ${p}: ${c.faker},`;
+      }
+      missing.add(p);
+      return `    ${p}: undefined, // TODO: real value (seeded ${p})`;
+    });
+    const block = params.length ? `{
+${params.join("\n")}
+  }` : "{}";
+    return `  await ${s.snippet.exportName}.run(page, ${block});`;
+  });
+  const warnings = unbound.map(
+    (s) => `  // \u26A0 GAP: no snippet for ${s.action} \u2014 scaffold_snippet then re-plan.`
+  );
+  const header = [`import { test } from '@playwright/test';`];
+  if (usesFaker) header.push(`import { faker } from '@faker-js/faker';`);
+  const code = `${header.join("\n")}
+${[...importLines].join("\n")}
+
+test(${JSON.stringify(opts.title ?? `plan: ${plan.target}`)}, async ({ page }) => {
+${[...warnings, ...callLines].join("\n")}
+});
+`;
+  return { code, missingFixtures: [...missing], complete: plan.runnable && missing.size === 0 };
+}
+
 // src/server/lockfile.ts
 var import_node_child_process2 = require("node:child_process");
-var import_node_fs13 = require("node:fs");
+var import_node_fs14 = require("node:fs");
 var import_node_os4 = require("node:os");
-var import_node_path17 = require("node:path");
+var import_node_path19 = require("node:path");
 init_launch_kit_paths();
 function lockDir(projectRoot) {
   if (projectRoot) {
-    return (0, import_node_path17.join)(projectRoot, LAUNCHSECURE_DIR);
+    return (0, import_node_path19.join)(projectRoot, LAUNCHSECURE_DIR);
   }
-  return (0, import_node_path17.join)((0, import_node_os4.homedir)(), LAUNCHSECURE_DIR);
+  return (0, import_node_path19.join)((0, import_node_os4.homedir)(), LAUNCHSECURE_DIR);
 }
 function lockPath(projectRoot) {
-  return (0, import_node_path17.join)(lockDir(projectRoot), "launch-chart.lock");
+  return (0, import_node_path19.join)(lockDir(projectRoot), "launch-chart.lock");
 }
 var _activeProjectRoot;
 function readLock(projectRoot) {
   const root = projectRoot ?? _activeProjectRoot;
   const p = lockPath(root);
-  if (!(0, import_node_fs13.existsSync)(p)) {
+  if (!(0, import_node_fs14.existsSync)(p)) {
     if (root) {
       const globalP = lockPath();
-      if ((0, import_node_fs13.existsSync)(globalP)) {
+      if ((0, import_node_fs14.existsSync)(globalP)) {
         try {
-          const data = JSON.parse((0, import_node_fs13.readFileSync)(globalP, "utf-8"));
+          const data = JSON.parse((0, import_node_fs14.readFileSync)(globalP, "utf-8"));
           if (typeof data.pid === "number" && typeof data.port === "number" && data.cwd === root) {
             return data;
           }
@@ -29846,7 +30024,7 @@ function readLock(projectRoot) {
     return null;
   }
   try {
-    const data = JSON.parse((0, import_node_fs13.readFileSync)(p, "utf-8"));
+    const data = JSON.parse((0, import_node_fs14.readFileSync)(p, "utf-8"));
     if (typeof data.pid !== "number" || typeof data.port !== "number") return null;
     return data;
   } catch {
@@ -29883,7 +30061,7 @@ function getLiveLock(projectRoot) {
   const live = listenerPid !== null ? listenerPid === lock.pid : isPidAlive(lock.pid);
   if (!live) {
     try {
-      (0, import_node_fs13.unlinkSync)(lockPath(root));
+      (0, import_node_fs14.unlinkSync)(lockPath(root));
     } catch {
     }
     return null;
@@ -29893,7 +30071,7 @@ function getLiveLock(projectRoot) {
 function clearLock(projectRoot) {
   const root = projectRoot ?? _activeProjectRoot;
   try {
-    (0, import_node_fs13.unlinkSync)(lockPath(root));
+    (0, import_node_fs14.unlinkSync)(lockPath(root));
   } catch {
   }
 }
@@ -29902,20 +30080,20 @@ function clearLock(projectRoot) {
 init_config();
 
 // src/server/graph/core/parser-registry.ts
-var import_node_path28 = require("node:path");
+var import_node_path30 = require("node:path");
 
 // src/server/graph/parsers/ts/typescript-project.ts
-var import_node_fs17 = require("node:fs");
-var import_node_path21 = require("node:path");
+var import_node_fs18 = require("node:fs");
+var import_node_path23 = require("node:path");
 init_config();
 
 // src/server/graph/core/resolve-paths.ts
-var import_node_fs15 = require("node:fs");
-var import_node_path19 = require("node:path");
+var import_node_fs16 = require("node:fs");
+var import_node_path21 = require("node:path");
 
 // src/server/graph/core/walk.ts
-var import_node_fs14 = require("node:fs");
-var import_node_path18 = require("node:path");
+var import_node_fs15 = require("node:fs");
+var import_node_path20 = require("node:path");
 var DEFAULT_IGNORE_DIRS = /* @__PURE__ */ new Set([
   "node_modules",
   "dist",
@@ -29925,12 +30103,12 @@ var DEFAULT_IGNORE_DIRS = /* @__PURE__ */ new Set([
 ]);
 function walk(dir, exts) {
   const results = [];
-  if (!(0, import_node_fs14.existsSync)(dir)) return results;
-  for (const entry of (0, import_node_fs14.readdirSync)(dir, { withFileTypes: true })) {
-    const full = (0, import_node_path18.join)(dir, entry.name);
+  if (!(0, import_node_fs15.existsSync)(dir)) return results;
+  for (const entry of (0, import_node_fs15.readdirSync)(dir, { withFileTypes: true })) {
+    const full = (0, import_node_path20.join)(dir, entry.name);
     if (entry.isDirectory()) {
       results.push(...walk(full, exts));
-    } else if (exts.includes((0, import_node_path18.extname)(entry.name))) {
+    } else if (exts.includes((0, import_node_path20.extname)(entry.name))) {
       results.push(full);
     }
   }
@@ -29938,15 +30116,15 @@ function walk(dir, exts) {
 }
 function walkWithIgnore(dir, exts, opts = {}) {
   const results = [];
-  if (!(0, import_node_fs14.existsSync)(dir)) return results;
+  if (!(0, import_node_fs15.existsSync)(dir)) return results;
   const skip = opts.extraIgnore ? /* @__PURE__ */ new Set([...DEFAULT_IGNORE_DIRS, ...opts.extraIgnore]) : DEFAULT_IGNORE_DIRS;
-  for (const entry of (0, import_node_fs14.readdirSync)(dir, { withFileTypes: true })) {
+  for (const entry of (0, import_node_fs15.readdirSync)(dir, { withFileTypes: true })) {
     if (entry.isDirectory()) {
       if (entry.name.startsWith(".")) continue;
       if (skip.has(entry.name)) continue;
-      results.push(...walkWithIgnore((0, import_node_path18.join)(dir, entry.name), exts, opts));
-    } else if (exts.includes((0, import_node_path18.extname)(entry.name))) {
-      results.push((0, import_node_path18.join)(dir, entry.name));
+      results.push(...walkWithIgnore((0, import_node_path20.join)(dir, entry.name), exts, opts));
+    } else if (exts.includes((0, import_node_path20.extname)(entry.name))) {
+      results.push((0, import_node_path20.join)(dir, entry.name));
     }
   }
   return results;
@@ -29954,9 +30132,9 @@ function walkWithIgnore(dir, exts, opts = {}) {
 
 // src/server/graph/core/resolve-paths.ts
 function hasSqlFiles(dir) {
-  if (!(0, import_node_fs15.existsSync)(dir)) return false;
+  if (!(0, import_node_fs16.existsSync)(dir)) return false;
   try {
-    return (0, import_node_fs15.readdirSync)(dir, { withFileTypes: true }).some(
+    return (0, import_node_fs16.readdirSync)(dir, { withFileTypes: true }).some(
       (e) => e.isFile() && e.name.endsWith(".sql")
     );
   } catch {
@@ -29964,27 +30142,27 @@ function hasSqlFiles(dir) {
   }
 }
 function hasNestedMigrationSql(dir) {
-  if (!(0, import_node_fs15.existsSync)(dir)) return false;
+  if (!(0, import_node_fs16.existsSync)(dir)) return false;
   try {
-    return (0, import_node_fs15.readdirSync)(dir, { withFileTypes: true }).some(
-      (e) => e.isDirectory() && (0, import_node_fs15.existsSync)((0, import_node_path19.join)(dir, e.name, "migration.sql"))
+    return (0, import_node_fs16.readdirSync)(dir, { withFileTypes: true }).some(
+      (e) => e.isDirectory() && (0, import_node_fs16.existsSync)((0, import_node_path21.join)(dir, e.name, "migration.sql"))
     );
   } catch {
     return false;
   }
 }
 function resolveDbFromDir(dir) {
-  if (!(0, import_node_fs15.existsSync)(dir)) return { kind: "none", schemaPath: null, migrationsDir: null };
-  const schemaPath = (0, import_node_path19.join)(dir, "schema.prisma");
-  if ((0, import_node_fs15.existsSync)(schemaPath)) {
-    const migrationsDir2 = (0, import_node_path19.join)(dir, "migrations");
+  if (!(0, import_node_fs16.existsSync)(dir)) return { kind: "none", schemaPath: null, migrationsDir: null };
+  const schemaPath = (0, import_node_path21.join)(dir, "schema.prisma");
+  if ((0, import_node_fs16.existsSync)(schemaPath)) {
+    const migrationsDir2 = (0, import_node_path21.join)(dir, "migrations");
     return {
       kind: "prisma",
       schemaPath,
-      migrationsDir: (0, import_node_fs15.existsSync)(migrationsDir2) ? migrationsDir2 : null
+      migrationsDir: (0, import_node_fs16.existsSync)(migrationsDir2) ? migrationsDir2 : null
     };
   }
-  const migrationsDir = (0, import_node_path19.join)(dir, "migrations");
+  const migrationsDir = (0, import_node_path21.join)(dir, "migrations");
   if (hasSqlFiles(migrationsDir) || hasNestedMigrationSql(migrationsDir)) {
     return { kind: "sql-migrations", migrationsDir, schemaPath: null };
   }
@@ -29995,19 +30173,19 @@ function resolveDbFromDir(dir) {
 }
 function detectDbConfig(rootDir, config) {
   if (config.paths?.dbDir) {
-    return resolveDbFromDir((0, import_node_path19.join)(rootDir, config.paths.dbDir));
+    return resolveDbFromDir((0, import_node_path21.join)(rootDir, config.paths.dbDir));
   }
-  const candidates = ["prisma", "supabase", "drizzle", (0, import_node_path19.join)("db", "migrations"), "migrations"];
+  const candidates = ["prisma", "supabase", "drizzle", (0, import_node_path21.join)("db", "migrations"), "migrations"];
   for (const c of candidates) {
-    const dir = (0, import_node_path19.join)(rootDir, c);
+    const dir = (0, import_node_path21.join)(rootDir, c);
     const resolved = resolveDbFromDir(dir);
     if (resolved.kind !== "none") return resolved;
   }
   return { kind: "none", schemaPath: null, migrationsDir: null };
 }
 function detectDbDir(rootDir, config, dbConfig) {
-  if (config.paths?.dbDir) return (0, import_node_path19.join)(rootDir, config.paths.dbDir);
-  if (dbConfig.kind === "prisma") return (0, import_node_path19.dirname)(dbConfig.schemaPath);
+  if (config.paths?.dbDir) return (0, import_node_path21.join)(rootDir, config.paths.dbDir);
+  if (dbConfig.kind === "prisma") return (0, import_node_path21.dirname)(dbConfig.schemaPath);
   if (dbConfig.kind === "sql-migrations") return dbConfig.migrationsDir;
   return null;
 }
@@ -30038,16 +30216,16 @@ var NON_SOURCE_DIRS = /* @__PURE__ */ new Set([
   "libs"
 ]);
 function dirHasTSFiles(dir) {
-  if (!(0, import_node_fs15.existsSync)(dir)) return false;
+  if (!(0, import_node_fs16.existsSync)(dir)) return false;
   try {
     const stack = [dir];
     while (stack.length > 0) {
       const cur = stack.pop();
-      const entries = (0, import_node_fs15.readdirSync)(cur, { withFileTypes: true });
+      const entries = (0, import_node_fs16.readdirSync)(cur, { withFileTypes: true });
       for (const e of entries) {
         if (e.isFile() && (e.name.endsWith(".ts") || e.name.endsWith(".tsx"))) return true;
         if (e.isDirectory() && !e.name.startsWith(".") && !DEFAULT_IGNORE_DIRS.has(e.name)) {
-          stack.push((0, import_node_path19.join)(cur, e.name));
+          stack.push((0, import_node_path21.join)(cur, e.name));
         }
       }
     }
@@ -30056,15 +30234,15 @@ function dirHasTSFiles(dir) {
   return false;
 }
 function collectCodeBearingChildren(dir, extraSkip) {
-  if (!(0, import_node_fs15.existsSync)(dir)) return [];
+  if (!(0, import_node_fs16.existsSync)(dir)) return [];
   const out = [];
   try {
-    for (const entry of (0, import_node_fs15.readdirSync)(dir, { withFileTypes: true })) {
+    for (const entry of (0, import_node_fs16.readdirSync)(dir, { withFileTypes: true })) {
       if (!entry.isDirectory()) continue;
       if (entry.name.startsWith(".")) continue;
       if (NON_SOURCE_DIRS.has(entry.name)) continue;
       if (extraSkip?.has(entry.name)) continue;
-      const full = (0, import_node_path19.join)(dir, entry.name);
+      const full = (0, import_node_path21.join)(dir, entry.name);
       if (dirHasTSFiles(full)) out.push(full);
     }
   } catch {
@@ -30076,7 +30254,7 @@ function detectSrcRoots(rootDir, srcDir, appDir, config) {
     const roots2 = /* @__PURE__ */ new Set();
     roots2.add(appDir);
     for (const r of config.paths.srcRoots) {
-      const abs = (0, import_node_path19.isAbsolute)(r) ? r : (0, import_node_path19.resolve)(rootDir, r);
+      const abs = (0, import_node_path21.isAbsolute)(r) ? r : (0, import_node_path21.resolve)(rootDir, r);
       roots2.add(abs);
     }
     return [...roots2];
@@ -30085,7 +30263,7 @@ function detectSrcRoots(rootDir, srcDir, appDir, config) {
   roots.add(appDir);
   for (const c of collectCodeBearingChildren(srcDir)) roots.add(c);
   if (srcDir !== rootDir) {
-    const skipSrcWrapper = /* @__PURE__ */ new Set([(0, import_node_path19.basename)(srcDir)]);
+    const skipSrcWrapper = /* @__PURE__ */ new Set([(0, import_node_path21.basename)(srcDir)]);
     for (const c of collectCodeBearingChildren(rootDir, skipSrcWrapper)) roots.add(c);
   }
   return [...roots];
@@ -30097,10 +30275,10 @@ function detectConventionFiles(rootDir, srcDir) {
   const dirs = srcDir === rootDir ? [rootDir] : [srcDir, rootDir];
   for (const dir of dirs) {
     for (const name of CONVENTION_NAMES) {
-      const full = (0, import_node_path19.join)(dir, name);
-      if (!seen.has(full) && (0, import_node_fs15.existsSync)(full)) {
+      const full = (0, import_node_path21.join)(dir, name);
+      if (!seen.has(full) && (0, import_node_fs16.existsSync)(full)) {
         try {
-          if ((0, import_node_fs15.statSync)(full).isFile()) {
+          if ((0, import_node_fs16.statSync)(full).isFile()) {
             seen.add(full);
             out.push(full);
           }
@@ -30115,22 +30293,22 @@ function resolveProjectPaths(rootDir, config) {
   let srcDir;
   let appDir;
   if (config.paths?.appDir) {
-    appDir = (0, import_node_path19.join)(rootDir, config.paths.appDir);
-    srcDir = config.paths.srcDir ? (0, import_node_path19.join)(rootDir, config.paths.srcDir) : (0, import_node_path19.dirname)(appDir);
+    appDir = (0, import_node_path21.join)(rootDir, config.paths.appDir);
+    srcDir = config.paths.srcDir ? (0, import_node_path21.join)(rootDir, config.paths.srcDir) : (0, import_node_path21.dirname)(appDir);
   } else {
-    const srcApp = (0, import_node_path19.join)(rootDir, "src", "app");
-    const rootApp = (0, import_node_path19.join)(rootDir, "app");
-    if ((0, import_node_fs15.existsSync)(srcApp)) {
-      srcDir = (0, import_node_path19.join)(rootDir, "src");
+    const srcApp = (0, import_node_path21.join)(rootDir, "src", "app");
+    const rootApp = (0, import_node_path21.join)(rootDir, "app");
+    if ((0, import_node_fs16.existsSync)(srcApp)) {
+      srcDir = (0, import_node_path21.join)(rootDir, "src");
       appDir = srcApp;
-    } else if ((0, import_node_fs15.existsSync)(rootApp)) {
+    } else if ((0, import_node_fs16.existsSync)(rootApp)) {
       srcDir = rootDir;
       appDir = rootApp;
     } else {
       return null;
     }
   }
-  const apiDir = (0, import_node_path19.join)(appDir, "api");
+  const apiDir = (0, import_node_path21.join)(appDir, "api");
   const dbConfig = detectDbConfig(rootDir, config);
   const dbDir = detectDbDir(rootDir, config, dbConfig);
   const srcRoots = detectSrcRoots(rootDir, srcDir, appDir, config);
@@ -30157,25 +30335,25 @@ var CLASSIFICATION_TO_LAYER = {
   external: "ui"
 };
 function toNodeId(srcDir, rootDir, absPath) {
-  const relFromSrc = (0, import_node_path21.relative)(srcDir, absPath).replace(/\\/g, "/");
+  const relFromSrc = (0, import_node_path23.relative)(srcDir, absPath).replace(/\\/g, "/");
   if (relFromSrc.startsWith("..")) {
-    return (0, import_node_path21.relative)(rootDir, absPath).replace(/\\/g, "/");
+    return (0, import_node_path23.relative)(rootDir, absPath).replace(/\\/g, "/");
   }
   return relFromSrc;
 }
 function resolveImport(srcDir, specifier) {
   if (!specifier.startsWith("@/")) return null;
   const rel = specifier.slice(2);
-  const base = (0, import_node_path21.join)(srcDir, rel);
-  for (const c of [base, base + ".ts", base + ".tsx", (0, import_node_path21.join)(base, "index.ts"), (0, import_node_path21.join)(base, "index.tsx")]) {
-    if ((0, import_node_fs17.existsSync)(c) && (0, import_node_fs17.statSync)(c).isFile()) return c;
+  const base = (0, import_node_path23.join)(srcDir, rel);
+  for (const c of [base, base + ".ts", base + ".tsx", (0, import_node_path23.join)(base, "index.ts"), (0, import_node_path23.join)(base, "index.tsx")]) {
+    if ((0, import_node_fs18.existsSync)(c) && (0, import_node_fs18.statSync)(c).isFile()) return c;
   }
   return null;
 }
 function resolveRelativeImport(fromFile, specifier) {
-  const base = (0, import_node_path21.join)((0, import_node_path21.dirname)(fromFile), specifier);
-  for (const c of [base, base + ".ts", base + ".tsx", (0, import_node_path21.join)(base, "index.ts"), (0, import_node_path21.join)(base, "index.tsx")]) {
-    if ((0, import_node_fs17.existsSync)(c) && (0, import_node_fs17.statSync)(c).isFile()) return c;
+  const base = (0, import_node_path23.join)((0, import_node_path23.dirname)(fromFile), specifier);
+  for (const c of [base, base + ".ts", base + ".tsx", (0, import_node_path23.join)(base, "index.ts"), (0, import_node_path23.join)(base, "index.tsx")]) {
+    if ((0, import_node_fs18.existsSync)(c) && (0, import_node_fs18.statSync)(c).isFile()) return c;
   }
   return null;
 }
@@ -30196,7 +30374,7 @@ function resolveBarrelMap(barrelAbsPath, parsedByPath, memo, visiting) {
     const resolved = resolveRelativeImport(barrelAbsPath, re.from);
     if (!resolved) continue;
     if (re.isWildcard) {
-      const targetBn = (0, import_node_path21.basename)(resolved);
+      const targetBn = (0, import_node_path23.basename)(resolved);
       const targetIsBarrel = targetBn === "index.ts" || targetBn === "index.tsx";
       if (targetIsBarrel) {
         const nested = resolveBarrelMap(resolved, parsedByPath, memo, visiting);
@@ -30223,12 +30401,12 @@ function buildAllBarrelMaps(srcDir, parsedByPath) {
   const barrels = /* @__PURE__ */ new Map();
   const memo = /* @__PURE__ */ new Map();
   for (const [absPath, parsed] of parsedByPath) {
-    const bn = (0, import_node_path21.basename)(absPath);
+    const bn = (0, import_node_path23.basename)(absPath);
     if (bn !== "index.ts" && bn !== "index.tsx") continue;
     if (parsed.reExports.length === 0) continue;
     const map = resolveBarrelMap(absPath, parsedByPath, memo, /* @__PURE__ */ new Set());
     if (map.size > 0) {
-      const barrelId = (0, import_node_path21.relative)(srcDir, (0, import_node_path21.dirname)(absPath)).replace(/\\/g, "/");
+      const barrelId = (0, import_node_path23.relative)(srcDir, (0, import_node_path23.dirname)(absPath)).replace(/\\/g, "/");
       barrels.set(barrelId, map);
     }
   }
@@ -30253,10 +30431,10 @@ function extractRoute(id) {
   return route || "/";
 }
 function nameFromFilename(absPath) {
-  return (0, import_node_path21.basename)(absPath, (0, import_node_path21.extname)(absPath)).replace(/[-_](\w)/g, (_, c) => c.toUpperCase()).replace(/^(\w)/, (_, c) => c.toUpperCase());
+  return (0, import_node_path23.basename)(absPath, (0, import_node_path23.extname)(absPath)).replace(/[-_](\w)/g, (_, c) => c.toUpperCase()).replace(/^(\w)/, (_, c) => c.toUpperCase());
 }
 function filePathToAppRoute(appDir, absPath) {
-  let route = ("/" + (0, import_node_path21.relative)(appDir, absPath).replace(/\\/g, "/")).replace(/\/route\.tsx?$/, "");
+  let route = ("/" + (0, import_node_path23.relative)(appDir, absPath).replace(/\\/g, "/")).replace(/\/route\.tsx?$/, "");
   route = route.replace(/\/\([^)]+\)/g, "");
   route = route.replace(/\[\[\.\.\.([^\]]+)\]\]/g, "*$1?");
   route = route.replace(/\[\.\.\.([^\]]+)\]/g, "*$1");
@@ -30504,7 +30682,7 @@ function generate(rootDir) {
   const apiNodes = [];
   const nodeIdSet = /* @__PURE__ */ new Set();
   const routeToNodeId = /* @__PURE__ */ new Map();
-  const fileSet = allDiscovered.filter((f) => !(0, import_node_path21.basename)(f).startsWith("index."));
+  const fileSet = allDiscovered.filter((f) => !(0, import_node_path23.basename)(f).startsWith("index."));
   for (const absPath of fileSet) {
     const id = toNodeId(srcDir, rootDir, absPath);
     const type = classifyType(absPath, id);
@@ -30664,7 +30842,7 @@ function generate(rootDir) {
     } catch {
       continue;
     }
-    const externalId = (0, import_node_path21.relative)(rootDir, absPath).replace(/\\/g, "/");
+    const externalId = (0, import_node_path23.relative)(rootDir, absPath).replace(/\\/g, "/");
     const edgesFromThis = [];
     const seen = /* @__PURE__ */ new Set();
     for (const imp of parsed.imports) {
@@ -31014,7 +31192,7 @@ var typescriptProjectParser = {
 };
 
 // src/server/graph/parsers/db/prisma-schema.ts
-var import_node_fs18 = require("node:fs");
+var import_node_fs19 = require("node:fs");
 init_config();
 function parseModels(content) {
   const nodes = [];
@@ -31107,7 +31285,7 @@ function parseEnums(content) {
 }
 function detect2(rootDir) {
   const paths = resolveProjectPaths(rootDir, loadConfig(rootDir));
-  return paths?.dbConfig.kind === "prisma" && (0, import_node_fs18.existsSync)(paths.dbConfig.schemaPath);
+  return paths?.dbConfig.kind === "prisma" && (0, import_node_fs19.existsSync)(paths.dbConfig.schemaPath);
 }
 function generate2(rootDir) {
   const paths = resolveProjectPaths(rootDir, loadConfig(rootDir));
@@ -31124,7 +31302,7 @@ function generate2(rootDir) {
     };
   }
   const schemaPath = paths.dbConfig.schemaPath;
-  const content = (0, import_node_fs18.readFileSync)(schemaPath, "utf-8");
+  const content = (0, import_node_fs19.readFileSync)(schemaPath, "utf-8");
   const { nodes: modelNodes, relations } = parseModels(content);
   const enumNodes = parseEnums(content);
   const allNodes = [...modelNodes, ...enumNodes];
@@ -31181,8 +31359,8 @@ var prismaSchemaParser = {
 };
 
 // src/server/graph/parsers/db/sql-migrations.ts
-var import_node_fs19 = require("node:fs");
-var import_node_path22 = require("node:path");
+var import_node_fs20 = require("node:fs");
+var import_node_path24 = require("node:path");
 var import_pgsql_parser = require("pgsql-parser");
 init_config();
 var PG_TO_PRISMA = {
@@ -31216,15 +31394,15 @@ function pgTypeToPrisma(pgType) {
   return PG_TO_PRISMA[upper] ?? upper;
 }
 function discoverMigrationFiles(migrationsDir) {
-  if (!(0, import_node_fs19.existsSync)(migrationsDir)) return [];
+  if (!(0, import_node_fs20.existsSync)(migrationsDir)) return [];
   const out = [];
-  const entries = (0, import_node_fs19.readdirSync)(migrationsDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
+  const entries = (0, import_node_fs20.readdirSync)(migrationsDir, { withFileTypes: true }).sort((a, b) => a.name.localeCompare(b.name));
   for (const entry of entries) {
     if (entry.isDirectory()) {
-      const sqlPath = (0, import_node_path22.join)(migrationsDir, entry.name, "migration.sql");
-      if ((0, import_node_fs19.existsSync)(sqlPath)) out.push(sqlPath);
+      const sqlPath = (0, import_node_path24.join)(migrationsDir, entry.name, "migration.sql");
+      if ((0, import_node_fs20.existsSync)(sqlPath)) out.push(sqlPath);
     } else if (entry.isFile() && entry.name.endsWith(".sql")) {
-      out.push((0, import_node_path22.join)(migrationsDir, entry.name));
+      out.push((0, import_node_path24.join)(migrationsDir, entry.name));
     }
   }
   return out;
@@ -31269,7 +31447,7 @@ function parseMigrations(migrationsDir, dialect = postgresDialect) {
   };
   if (!migrationsDir) return state;
   for (const sqlPath of discoverMigrationFiles(migrationsDir)) {
-    const sql = (0, import_node_fs19.readFileSync)(sqlPath, "utf-8");
+    const sql = (0, import_node_fs20.readFileSync)(sqlPath, "utf-8");
     let ast;
     try {
       ast = dialect.parse(sql);
@@ -31838,8 +32016,8 @@ function indexIsPrismaUncoverable(idx) {
   return idx.hasPredicate || idx.hasExpressions || idx.method !== "btree";
 }
 function loadPrismaState(schemaPath) {
-  if (!schemaPath || !(0, import_node_fs19.existsSync)(schemaPath)) return null;
-  const content = (0, import_node_fs19.readFileSync)(schemaPath, "utf-8");
+  if (!schemaPath || !(0, import_node_fs20.existsSync)(schemaPath)) return null;
+  const content = (0, import_node_fs20.readFileSync)(schemaPath, "utf-8");
   const tables = /* @__PURE__ */ new Map();
   const enums = /* @__PURE__ */ new Map();
   const relations = [];
@@ -32246,7 +32424,7 @@ function generate3(rootDir) {
   const migrationFiles = migrationsDir ? discoverMigrationFiles(migrationsDir) : [];
   let migrationNodeCount = 0;
   for (const sqlPath of migrationFiles) {
-    const sql = (0, import_node_fs19.readFileSync)(sqlPath, "utf-8");
+    const sql = (0, import_node_fs20.readFileSync)(sqlPath, "utf-8");
     const name = deriveMigrationName(sqlPath);
     let ast;
     try {
@@ -32564,14 +32742,14 @@ var fetchResolverParser = {
 };
 
 // src/server/graph/parsers/crosslayer/api-annotations.ts
-var import_node_fs20 = require("node:fs");
-var import_node_path23 = require("node:path");
+var import_node_fs21 = require("node:fs");
+var import_node_path25 = require("node:path");
 init_config();
 var API_ANNOTATION_RE = /@api\s+(GET|POST|PUT|DELETE|PATCH|HEAD|OPTIONS)\s+(\/\S+)/g;
 function toNodeId2(srcDir, rootDir, absPath) {
-  const relFromSrc = (0, import_node_path23.relative)(srcDir, absPath).replace(/\\/g, "/");
+  const relFromSrc = (0, import_node_path25.relative)(srcDir, absPath).replace(/\\/g, "/");
   if (relFromSrc.startsWith("..")) {
-    return (0, import_node_path23.relative)(rootDir, absPath).replace(/\\/g, "/");
+    return (0, import_node_path25.relative)(rootDir, absPath).replace(/\\/g, "/");
   }
   return relFromSrc;
 }
@@ -32616,7 +32794,7 @@ var apiAnnotationsParser = {
     const flaggedEdges = [];
     const seenEdge = /* @__PURE__ */ new Set();
     for (const absPath of files) {
-      const content = (0, import_node_fs20.readFileSync)(absPath, "utf-8");
+      const content = (0, import_node_fs21.readFileSync)(absPath, "utf-8");
       const sourceId = toNodeId2(srcDir, rootDir, absPath);
       if (!uiNodeIds.has(sourceId)) continue;
       let match;
@@ -32660,14 +32838,14 @@ var apiAnnotationsParser = {
 };
 
 // src/server/graph/parsers/crosslayer/url-literal-scanner.ts
-var import_node_fs21 = require("node:fs");
-var import_node_path24 = require("node:path");
+var import_node_fs22 = require("node:fs");
+var import_node_path26 = require("node:path");
 init_config();
 var URL_LITERAL_RE = /['"`](\/[a-zA-Z][^'"`\s]*?)['"`]/g;
 function toNodeId3(srcDir, rootDir, absPath) {
-  const relFromSrc = (0, import_node_path24.relative)(srcDir, absPath).replace(/\\/g, "/");
+  const relFromSrc = (0, import_node_path26.relative)(srcDir, absPath).replace(/\\/g, "/");
   if (relFromSrc.startsWith("..")) {
-    return (0, import_node_path24.relative)(rootDir, absPath).replace(/\\/g, "/");
+    return (0, import_node_path26.relative)(rootDir, absPath).replace(/\\/g, "/");
   }
   return relFromSrc;
 }
@@ -32711,7 +32889,7 @@ var urlLiteralScannerParser = {
     for (const absPath of files) {
       const sourceId = toNodeId3(srcDir, rootDir, absPath);
       if (!uiNodeIds.has(sourceId)) continue;
-      const content = (0, import_node_fs21.readFileSync)(absPath, "utf-8");
+      const content = (0, import_node_fs22.readFileSync)(absPath, "utf-8");
       let match;
       URL_LITERAL_RE.lastIndex = 0;
       while ((match = URL_LITERAL_RE.exec(content)) !== null) {
@@ -32742,8 +32920,8 @@ var urlLiteralScannerParser = {
 };
 
 // src/server/graph/parsers/static/static-values.ts
-var import_node_fs22 = require("node:fs");
-var import_node_path25 = require("node:path");
+var import_node_fs23 = require("node:fs");
+var import_node_path27 = require("node:path");
 init_config();
 var parseCode = null;
 function tryLoadTreeSitter() {
@@ -32780,21 +32958,21 @@ function extractEnumValues(rootDir) {
   const schemaPaths = [];
   if (paths?.dbConfig.kind === "prisma" && paths.dbConfig.schemaPath) {
     schemaPaths.push(paths.dbConfig.schemaPath);
-    schemaPaths.push((0, import_node_path25.join)((0, import_node_path25.dirname)(paths.dbConfig.schemaPath), "schema"));
+    schemaPaths.push((0, import_node_path27.join)((0, import_node_path27.dirname)(paths.dbConfig.schemaPath), "schema"));
   } else {
-    schemaPaths.push((0, import_node_path25.join)(rootDir, "prisma", "schema.prisma"));
-    schemaPaths.push((0, import_node_path25.join)(rootDir, "prisma", "schema"));
+    schemaPaths.push((0, import_node_path27.join)(rootDir, "prisma", "schema.prisma"));
+    schemaPaths.push((0, import_node_path27.join)(rootDir, "prisma", "schema"));
   }
   let content = "";
   for (const p of schemaPaths) {
-    if ((0, import_node_fs22.existsSync)(p)) {
+    if ((0, import_node_fs23.existsSync)(p)) {
       try {
-        const stat = (0, import_node_fs22.statSync)(p);
+        const stat = (0, import_node_fs23.statSync)(p);
         if (stat.isFile()) {
-          content = (0, import_node_fs22.readFileSync)(p, "utf-8");
+          content = (0, import_node_fs23.readFileSync)(p, "utf-8");
         } else if (stat.isDirectory()) {
-          const files = (0, import_node_fs22.readdirSync)(p).filter((f) => f.endsWith(".prisma"));
-          content = files.map((f) => (0, import_node_fs22.readFileSync)((0, import_node_path25.join)(p, f), "utf-8")).join("\n");
+          const files = (0, import_node_fs23.readdirSync)(p).filter((f) => f.endsWith(".prisma"));
+          content = files.map((f) => (0, import_node_fs23.readFileSync)((0, import_node_path27.join)(p, f), "utf-8")).join("\n");
         }
       } catch {
         continue;
@@ -32952,27 +33130,27 @@ function extractSeedData(rootDir) {
   const paths = resolveProjectPaths(rootDir, loadConfig(rootDir));
   const candidates = [];
   if (paths?.dbDir) {
-    candidates.push((0, import_node_path25.join)(paths.dbDir, "seed.ts"));
-    candidates.push((0, import_node_path25.join)(paths.dbDir, "seed.js"));
+    candidates.push((0, import_node_path27.join)(paths.dbDir, "seed.ts"));
+    candidates.push((0, import_node_path27.join)(paths.dbDir, "seed.js"));
   } else {
-    candidates.push((0, import_node_path25.join)(rootDir, "prisma", "seed.ts"));
-    candidates.push((0, import_node_path25.join)(rootDir, "prisma", "seed.js"));
+    candidates.push((0, import_node_path27.join)(rootDir, "prisma", "seed.ts"));
+    candidates.push((0, import_node_path27.join)(rootDir, "prisma", "seed.js"));
   }
-  const baseRoots = paths?.srcRoots ?? [(0, import_node_path25.join)(rootDir, "src")];
+  const baseRoots = paths?.srcRoots ?? [(0, import_node_path27.join)(rootDir, "src")];
   for (const root of baseRoots) {
-    candidates.push((0, import_node_path25.join)(root, "server", "lib", "system-tags.ts"));
+    candidates.push((0, import_node_path27.join)(root, "server", "lib", "system-tags.ts"));
   }
   const seedFiles = candidates.filter((p) => {
     try {
-      return (0, import_node_fs22.existsSync)(p) && (0, import_node_fs22.statSync)(p).isFile();
+      return (0, import_node_fs23.existsSync)(p) && (0, import_node_fs23.statSync)(p).isFile();
     } catch {
       return false;
     }
   });
   const useTreeSitter = tryLoadTreeSitter();
   for (const filePath of seedFiles) {
-    const content = (0, import_node_fs22.readFileSync)(filePath, "utf-8");
-    const relPath = (0, import_node_path25.relative)(rootDir, filePath);
+    const content = (0, import_node_fs23.readFileSync)(filePath, "utf-8");
+    const relPath = (0, import_node_path27.relative)(rootDir, filePath);
     const seeded = detectSeededArrays(content, relPath);
     let astRoot = null;
     if (useTreeSitter && parseCode) {
@@ -33066,11 +33244,11 @@ function extractSeedData(rootDir) {
   return { nodes, edges };
 }
 function walkDir(dir, exts) {
-  if (!(0, import_node_fs22.existsSync)(dir)) return [];
+  if (!(0, import_node_fs23.existsSync)(dir)) return [];
   const results = [];
-  for (const entry of (0, import_node_fs22.readdirSync)(dir, { withFileTypes: true })) {
+  for (const entry of (0, import_node_fs23.readdirSync)(dir, { withFileTypes: true })) {
     if (entry.name === "node_modules" || entry.name === ".next" || entry.name === "dist") continue;
-    const full = (0, import_node_path25.join)(dir, entry.name);
+    const full = (0, import_node_path27.join)(dir, entry.name);
     if (entry.isDirectory()) results.push(...walkDir(full, exts));
     else if (exts.some((ext) => entry.name.endsWith(ext))) results.push(full);
   }
@@ -33079,7 +33257,7 @@ function walkDir(dir, exts) {
 function extractConstants(rootDir) {
   const nodes = [];
   const paths = resolveProjectPaths(rootDir, loadConfig(rootDir));
-  const roots = paths?.srcRoots ?? [(0, import_node_path25.join)(rootDir, "src")];
+  const roots = paths?.srcRoots ?? [(0, import_node_path27.join)(rootDir, "src")];
   const seenFile = /* @__PURE__ */ new Set();
   const allFiles = [];
   for (const root of roots) {
@@ -33092,8 +33270,8 @@ function extractConstants(rootDir) {
   }
   if (allFiles.length === 0) return { nodes };
   for (const filePath of allFiles) {
-    const content = (0, import_node_fs22.readFileSync)(filePath, "utf-8");
-    const relPath = (0, import_node_path25.relative)(rootDir, filePath);
+    const content = (0, import_node_fs23.readFileSync)(filePath, "utf-8");
+    const relPath = (0, import_node_path27.relative)(rootDir, filePath);
     const constArrayRe = /export\s+const\s+([A-Z][A-Z_0-9]+)\s*(?::[^=]+)?\s*=\s*\[/g;
     let cm;
     while ((cm = constArrayRe.exec(content)) !== null) {
@@ -33127,13 +33305,13 @@ function extractConstants(rootDir) {
 }
 function detect4(rootDir) {
   const paths = resolveProjectPaths(rootDir, loadConfig(rootDir));
-  if (paths?.dbConfig.kind === "prisma" && paths.dbConfig.schemaPath && (0, import_node_fs22.existsSync)(paths.dbConfig.schemaPath)) {
+  if (paths?.dbConfig.kind === "prisma" && paths.dbConfig.schemaPath && (0, import_node_fs23.existsSync)(paths.dbConfig.schemaPath)) {
     return true;
   }
   if (paths?.dbDir) {
-    if ((0, import_node_fs22.existsSync)((0, import_node_path25.join)(paths.dbDir, "seed.ts")) || (0, import_node_fs22.existsSync)((0, import_node_path25.join)(paths.dbDir, "seed.js"))) return true;
+    if ((0, import_node_fs23.existsSync)((0, import_node_path27.join)(paths.dbDir, "seed.ts")) || (0, import_node_fs23.existsSync)((0, import_node_path27.join)(paths.dbDir, "seed.js"))) return true;
   }
-  return (0, import_node_fs22.existsSync)((0, import_node_path25.join)(rootDir, "prisma", "schema.prisma")) || (0, import_node_fs22.existsSync)((0, import_node_path25.join)(rootDir, "prisma", "seed.ts"));
+  return (0, import_node_fs23.existsSync)((0, import_node_path27.join)(rootDir, "prisma", "schema.prisma")) || (0, import_node_fs23.existsSync)((0, import_node_path27.join)(rootDir, "prisma", "seed.ts"));
 }
 function generate4(rootDir) {
   const enumResult = extractEnumValues(rootDir);
@@ -33208,8 +33386,8 @@ var staticValuesParser = {
 };
 
 // src/server/graph/parsers/crosslayer/static-ref-scanner.ts
-var import_node_fs23 = require("node:fs");
-var import_node_path26 = require("node:path");
+var import_node_fs24 = require("node:fs");
+var import_node_path28 = require("node:path");
 init_config();
 var MIN_VALUE_LENGTH = 4;
 var SKIP_VALUES = /* @__PURE__ */ new Set([
@@ -33384,11 +33562,11 @@ var staticRefScannerParser = {
     const seen = /* @__PURE__ */ new Set();
     let filesScanned = 0;
     for (const absPath of files) {
-      const relFromSrc = (0, import_node_path26.relative)(srcDir, absPath).replace(/\\/g, "/");
-      const sourceId = relFromSrc.startsWith("..") ? (0, import_node_path26.relative)(rootDir, absPath).replace(/\\/g, "/") : relFromSrc;
+      const relFromSrc = (0, import_node_path28.relative)(srcDir, absPath).replace(/\\/g, "/");
+      const sourceId = relFromSrc.startsWith("..") ? (0, import_node_path28.relative)(rootDir, absPath).replace(/\\/g, "/") : relFromSrc;
       const sourceLayer = uiNodeIds.has(sourceId) ? "ui" : apiNodeIds.has(sourceId) ? "api" : null;
       if (!sourceLayer) continue;
-      const content = (0, import_node_fs23.readFileSync)(absPath, "utf-8");
+      const content = (0, import_node_fs24.readFileSync)(absPath, "utf-8");
       filesScanned++;
       let fileRefs;
       if (parseCode2) {
@@ -33430,13 +33608,13 @@ var staticRefScannerParser = {
 };
 
 // src/server/graph/parsers/crosslayer/middleware-gates.ts
-var import_node_path27 = require("node:path");
+var import_node_path29 = require("node:path");
 init_ts_extractor();
 init_config();
 function toNodeId4(srcDir, rootDir, absPath) {
-  const relFromSrc = (0, import_node_path27.relative)(srcDir, absPath).replace(/\\/g, "/");
+  const relFromSrc = (0, import_node_path29.relative)(srcDir, absPath).replace(/\\/g, "/");
   if (relFromSrc.startsWith("..")) {
-    return (0, import_node_path27.relative)(rootDir, absPath).replace(/\\/g, "/");
+    return (0, import_node_path29.relative)(rootDir, absPath).replace(/\\/g, "/");
   }
   return relFromSrc;
 }
@@ -33738,7 +33916,7 @@ function registerBuiltins3(registry, disabled) {
 function loadCustomParsers(registry, config, rootDir, disabled) {
   for (const entry of config.parsers?.custom ?? []) {
     try {
-      const absPath = (0, import_node_path28.resolve)(rootDir, entry.path);
+      const absPath = (0, import_node_path30.resolve)(rootDir, entry.path);
       const mod = require(absPath);
       const parser = "default" in mod ? mod.default : mod;
       if (disabled.has(parser.id)) continue;
@@ -33767,8 +33945,8 @@ function createRegistry(config, rootDir) {
 }
 
 // src/server/graph/core/language-detection.ts
-var import_node_fs24 = require("node:fs");
-var import_node_path29 = require("node:path");
+var import_node_fs25 = require("node:fs");
+var import_node_path31 = require("node:path");
 init_launch_kit_paths();
 var EXTENSION_TO_LANGUAGE = {
   // Web / Frontend
@@ -33881,10 +34059,10 @@ var AUXILIARY_LANGUAGES = /* @__PURE__ */ new Set([
 ]);
 function walkForExtensions(dir, extCounts, depth = 0) {
   if (depth > 10) return;
-  if (!(0, import_node_fs24.existsSync)(dir)) return;
+  if (!(0, import_node_fs25.existsSync)(dir)) return;
   let entries;
   try {
-    entries = (0, import_node_fs24.readdirSync)(dir, { withFileTypes: true });
+    entries = (0, import_node_fs25.readdirSync)(dir, { withFileTypes: true });
   } catch {
     return;
   }
@@ -33892,9 +34070,9 @@ function walkForExtensions(dir, extCounts, depth = 0) {
     if (entry.name.startsWith(".") && entry.isDirectory()) continue;
     if (entry.isDirectory()) {
       if (IGNORE_DIRS.has(entry.name)) continue;
-      walkForExtensions((0, import_node_path29.join)(dir, entry.name), extCounts, depth + 1);
+      walkForExtensions((0, import_node_path31.join)(dir, entry.name), extCounts, depth + 1);
     } else {
-      const ext = (0, import_node_path29.extname)(entry.name).toLowerCase();
+      const ext = (0, import_node_path31.extname)(entry.name).toLowerCase();
       if (ext && EXTENSION_TO_LANGUAGE[ext]) {
         extCounts.set(ext, (extCounts.get(ext) ?? 0) + 1);
       }
@@ -33935,13 +34113,13 @@ function detectLanguages(rootDir, supportedLanguages) {
 }
 
 // src/server/graph/core/audit-core.ts
-var import_node_fs26 = require("node:fs");
-var import_node_path31 = require("node:path");
+var import_node_fs27 = require("node:fs");
+var import_node_path33 = require("node:path");
 init_launch_kit_paths();
 
 // src/server/graph/core/audit-security.ts
-var import_node_fs25 = require("node:fs");
-var import_node_path30 = require("node:path");
+var import_node_fs26 = require("node:fs");
+var import_node_path32 = require("node:path");
 init_ts_extractor();
 init_config();
 function collectSourceFiles(rootDir) {
@@ -33966,9 +34144,9 @@ function collectSourceFiles(rootDir) {
   return out;
 }
 function toNodeId5(rootDir, srcDir, absPath) {
-  const relFromSrc = (0, import_node_path30.relative)(srcDir, absPath).replace(/\\/g, "/");
+  const relFromSrc = (0, import_node_path32.relative)(srcDir, absPath).replace(/\\/g, "/");
   if (relFromSrc.startsWith("..")) {
-    return (0, import_node_path30.relative)(rootDir, absPath).replace(/\\/g, "/");
+    return (0, import_node_path32.relative)(rootDir, absPath).replace(/\\/g, "/");
   }
   return relFromSrc;
 }
@@ -34078,18 +34256,18 @@ function collectDeclaredEnvKeys(rootDir) {
   const files = [];
   let entries = [];
   try {
-    entries = (0, import_node_fs25.readdirSync)(rootDir);
+    entries = (0, import_node_fs26.readdirSync)(rootDir);
   } catch {
     return { keys, files };
   }
   for (const name of entries) {
     if (!name.startsWith(".env")) continue;
-    const abs = (0, import_node_path30.join)(rootDir, name);
-    if (!(0, import_node_fs25.existsSync)(abs)) continue;
+    const abs = (0, import_node_path32.join)(rootDir, name);
+    if (!(0, import_node_fs26.existsSync)(abs)) continue;
     files.push(name);
     let content = "";
     try {
-      content = (0, import_node_fs25.readFileSync)(abs, "utf-8");
+      content = (0, import_node_fs26.readFileSync)(abs, "utf-8");
     } catch {
       continue;
     }
@@ -34276,10 +34454,10 @@ function checkHardcodedUrlFallback(rootDir, core) {
 
 // src/server/graph/core/audit-core.ts
 function readGraphFile(rootDir, layer) {
-  const filePath = (0, import_node_path31.join)(rootDir, LAUNCHSECURE_DIR, "graphs", `${layer}.json`);
-  if (!(0, import_node_fs26.existsSync)(filePath)) return null;
+  const filePath = (0, import_node_path33.join)(rootDir, LAUNCHSECURE_DIR, "graphs", `${layer}.json`);
+  if (!(0, import_node_fs27.existsSync)(filePath)) return null;
   try {
-    return JSON.parse((0, import_node_fs26.readFileSync)(filePath, "utf-8"));
+    return JSON.parse((0, import_node_fs27.readFileSync)(filePath, "utf-8"));
   } catch {
     return null;
   }
@@ -34321,15 +34499,15 @@ function checkUnprotectedRoutes(rootDir) {
   const findings = [];
   const api = readGraphFile(rootDir, "api");
   if (!api) return buildSkipped("api", "unprotected_routes", "no api graph");
-  const routePermsPath = (0, import_node_path31.join)(rootDir, "src", "config", "route-permissions.ts");
-  if (!(0, import_node_fs26.existsSync)(routePermsPath)) {
+  const routePermsPath = (0, import_node_path33.join)(rootDir, "src", "config", "route-permissions.ts");
+  if (!(0, import_node_fs27.existsSync)(routePermsPath)) {
     return buildSkipped(
       "api",
       "unprotected_routes",
       `no src/config/route-permissions.ts \u2014 this check needs a centralized ROUTE_PERMISSIONS inventory to compare endpoints against`
     );
   }
-  const routePermsContent = (0, import_node_fs26.readFileSync)(routePermsPath, "utf-8");
+  const routePermsContent = (0, import_node_fs27.readFileSync)(routePermsPath, "utf-8");
   const registeredRoutes = /* @__PURE__ */ new Set();
   const routeEntryRe = /path:\s*'([^']+)'/g;
   let rm;
@@ -34414,15 +34592,15 @@ function checkUnenforcedPermissions(rootDir) {
       `no seed_permission nodes \u2014 this project either has no seed permissions or hasn't tagged them in seed.ts`
     );
   }
-  const routePermsPath = (0, import_node_path31.join)(rootDir, "src", "config", "route-permissions.ts");
-  if (!(0, import_node_fs26.existsSync)(routePermsPath)) {
+  const routePermsPath = (0, import_node_path33.join)(rootDir, "src", "config", "route-permissions.ts");
+  if (!(0, import_node_fs27.existsSync)(routePermsPath)) {
     return buildSkipped(
       "static",
       "unenforced_permissions",
       `no src/config/route-permissions.ts to compare seed permissions against`
     );
   }
-  const routePermsContent = (0, import_node_fs26.readFileSync)(routePermsPath, "utf-8");
+  const routePermsContent = (0, import_node_fs27.readFileSync)(routePermsPath, "utf-8");
   for (const perm of permissions) {
     const regex = new RegExp(`permission:\\s*['"]${perm.key}['"]`);
     if (!regex.test(routePermsContent)) {
@@ -34458,9 +34636,9 @@ function checkHardcodedValues(rootDir) {
   const seen = /* @__PURE__ */ new Set();
   for (const node of api.nodes) {
     if (node.type !== "endpoint") continue;
-    const filePath = (0, import_node_path31.join)(rootDir, "src", node.id);
-    if (!(0, import_node_fs26.existsSync)(filePath)) continue;
-    const content = (0, import_node_fs26.readFileSync)(filePath, "utf-8");
+    const filePath = (0, import_node_path33.join)(rootDir, "src", node.id);
+    if (!(0, import_node_fs27.existsSync)(filePath)) continue;
+    const content = (0, import_node_fs27.readFileSync)(filePath, "utf-8");
     let m;
     allCapsRe.lastIndex = 0;
     while ((m = allCapsRe.exec(content)) !== null) {
@@ -34565,26 +34743,26 @@ function runAudit(rootDir, layer, check) {
 }
 
 // src/server/graph/core/projects.ts
-var import_node_path34 = require("node:path");
+var import_node_path36 = require("node:path");
 
 // src/server/lib/worktree.ts
-var import_node_path33 = require("node:path");
+var import_node_path35 = require("node:path");
 
 // src/server/orbit/registry.ts
-var import_node_fs27 = require("node:fs");
+var import_node_fs28 = require("node:fs");
 var import_node_os5 = require("node:os");
-var import_node_path32 = require("node:path");
+var import_node_path34 = require("node:path");
 init_launch_kit_paths();
-var REGISTRY_DIR = (0, import_node_path32.join)((0, import_node_os5.homedir)(), LAUNCHSECURE_DIR, "orbit");
-var REGISTRY_PATH = (0, import_node_path32.join)(REGISTRY_DIR, "state.json");
-var LOCK_PATH = (0, import_node_path32.join)(REGISTRY_DIR, "state.json.lock");
+var REGISTRY_DIR = (0, import_node_path34.join)((0, import_node_os5.homedir)(), LAUNCHSECURE_DIR, "orbit");
+var REGISTRY_PATH = (0, import_node_path34.join)(REGISTRY_DIR, "state.json");
+var LOCK_PATH = (0, import_node_path34.join)(REGISTRY_DIR, "state.json.lock");
 function emptyRegistry() {
   return { version: 1, worktrees: {} };
 }
 function readRegistry() {
-  if (!(0, import_node_fs27.existsSync)(REGISTRY_PATH)) return emptyRegistry();
+  if (!(0, import_node_fs28.existsSync)(REGISTRY_PATH)) return emptyRegistry();
   try {
-    const parsed = JSON.parse((0, import_node_fs27.readFileSync)(REGISTRY_PATH, "utf-8"));
+    const parsed = JSON.parse((0, import_node_fs28.readFileSync)(REGISTRY_PATH, "utf-8"));
     if (parsed?.version === 1 && parsed.worktrees && typeof parsed.worktrees === "object") {
       return parsed;
     }
@@ -34614,7 +34792,7 @@ function resolveWorktreeRoot(slug, monorepoRoot) {
 function resolveWorktreeOrProjectRoot(args, monorepoRoot) {
   const projectRoot = typeof args.project_root === "string" ? args.project_root.trim() : "";
   if (projectRoot) {
-    return (0, import_node_path33.isAbsolute)(projectRoot) ? projectRoot : (0, import_node_path33.resolve)(monorepoRoot, projectRoot);
+    return (0, import_node_path35.isAbsolute)(projectRoot) ? projectRoot : (0, import_node_path35.resolve)(monorepoRoot, projectRoot);
   }
   const worktree = typeof args.worktree === "string" ? args.worktree.trim() : "";
   if (worktree) {
@@ -34633,7 +34811,7 @@ function listProjects(monorepoRoot) {
   return entries.map((p) => ({
     name: p.name,
     root: p.root,
-    absoluteRoot: (0, import_node_path34.resolve)(monorepoRoot, p.root)
+    absoluteRoot: (0, import_node_path36.resolve)(monorepoRoot, p.root)
   }));
 }
 function resolveProject(name, projects) {
@@ -35056,6 +35234,39 @@ USE THIS FOR: "are there unsafe migrations on this branch", "audit the migration
       required: ["target"]
     }
   },
+  {
+    name: "test_plan",
+    description: 'Assemble the ordered snippet chain needed to exercise a target action. Walks the context graph\'s requires/produces backward from the target (prerequisites first, target last), binds each step to its snippet (from tests/snippets/), and flags gaps \u2014 a required state nothing produces, an action with no snippet, or a cycle.\n\nUSE THIS FOR: "what\'s the test plan for creating a tag", "what setup does action X need". Returns { target, steps[], gaps[], runnable }. Requires the `context` layer (run generate_graph first). When runnable is false, the gaps tell you which snippets to scaffold next.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        target: { type: "string", description: 'Context action node id (e.g. "action:app/api/orgs/[orgSlug]/tags/route.ts") or the bare key.' },
+        snippets_dir: { type: "string", description: `Snippets directory relative to project root. Default "${DEFAULT_SNIPPETS_DIR}".` },
+        project: { type: "string", description: PROJECT_PARAM_DESCRIPTION },
+        worktree: { type: "string", description: WORKTREE_PARAM_DESCRIPTION2 },
+        project_root: { type: "string", description: PROJECT_ROOT_PARAM_DESCRIPTION2 }
+      },
+      required: ["target"]
+    }
+  },
+  {
+    name: "generate_spec",
+    description: 'Generate a runnable Playwright .spec.ts from a target action: builds the test_plan, then emits imports + ordered `await snippet.run(page, {...})` calls. Params are auto-classified \u2014 secrets \u2192 process.env, free-form (name/color/icon/description) \u2192 faker.*, and state-bound (email/slug/id) \u2192 TODO + returned in missingFixtures. Supply those via `fixtures`.\n\nUSE THIS FOR: "generate the test for creating a tag". Returns { code, missingFixtures, complete }. complete:true means every state-bound param had a fixture (secrets via env + faker auto). Requires the `context` layer + snippets.',
+    inputSchema: {
+      type: "object",
+      properties: {
+        target: { type: "string", description: "Context action node id (or bare key)." },
+        fixtures: { type: "object", description: 'param name -> value for state-bound params (e.g. {"email":"...","orgSlug":"..."}). Overrides classification.', additionalProperties: true },
+        title: { type: "string", description: "Test title. Defaults to the target." },
+        spec_dir: { type: "string", description: 'Where the spec will live (for import paths). Default "tests/generated".' },
+        snippets_dir: { type: "string", description: `Snippets directory. Default "${DEFAULT_SNIPPETS_DIR}".` },
+        project: { type: "string", description: PROJECT_PARAM_DESCRIPTION },
+        worktree: { type: "string", description: WORKTREE_PARAM_DESCRIPTION2 },
+        project_root: { type: "string", description: PROJECT_ROOT_PARAM_DESCRIPTION2 }
+      },
+      required: ["target"]
+    }
+  },
   {
     name: "auth_coverage_report",
     description: 'Aggregate every API endpoint by its auth[] wrapper(s) \u2014 surfaces endpoints with empty auth, groups by module, shows which auth strategies dominate. Computed from api.json endpoint auth field (100% populated).\n\nUSE THIS FOR: "are there unauthenticated endpoints", "which auth wrappers are in use", "audit auth strategy consistency across modules". Paginated. Returns { total, by_strategy: {strategy: count}, unauthenticated: [endpoint_ids], by_module: {module: {total, by_strategy}} } plus the paginated endpoint list.',
@@ -36039,12 +36250,12 @@ function handleReadGraph(args) {
   return okJson(result);
 }
 function nodeToFilePath(rootDir, layer, nodeId) {
-  if (layer === "ui" || layer === "api") return (0, import_node_path36.join)(rootDir, "src", nodeId);
-  if (layer === "db") return (0, import_node_path36.join)(rootDir, "prisma", "schema.prisma");
-  const withSrc = (0, import_node_path36.join)(rootDir, "src", nodeId);
-  if ((0, import_node_fs29.existsSync)(withSrc)) return withSrc;
-  const direct = (0, import_node_path36.join)(rootDir, nodeId);
-  if ((0, import_node_fs29.existsSync)(direct)) return direct;
+  if (layer === "ui" || layer === "api") return (0, import_node_path38.join)(rootDir, "src", nodeId);
+  if (layer === "db") return (0, import_node_path38.join)(rootDir, "prisma", "schema.prisma");
+  const withSrc = (0, import_node_path38.join)(rootDir, "src", nodeId);
+  if ((0, import_node_fs30.existsSync)(withSrc)) return withSrc;
+  const direct = (0, import_node_path38.join)(rootDir, nodeId);
+  if ((0, import_node_fs30.existsSync)(direct)) return direct;
   return null;
 }
 function handleInspectNode(args) {
@@ -36312,11 +36523,11 @@ function handleGrepNodes(args) {
   let filesSearched = 0;
   let truncated = false;
   for (const [filePath, nodeId] of filePaths) {
-    if (!(0, import_node_fs29.existsSync)(filePath)) continue;
+    if (!(0, import_node_fs30.existsSync)(filePath)) continue;
     filesSearched++;
     let content;
     try {
-      content = (0, import_node_fs29.readFileSync)(filePath, "utf-8");
+      content = (0, import_node_fs30.readFileSync)(filePath, "utf-8");
     } catch {
       continue;
     }
@@ -36535,11 +36746,11 @@ function handleStartChartServer(args) {
     });
   }
   const entryPath = process.argv[1];
-  const logDir = (0, import_node_path36.join)((0, import_node_os6.homedir)(), LAUNCHSECURE_DIR);
-  (0, import_node_fs29.mkdirSync)(logDir, { recursive: true });
-  const logPath = (0, import_node_path36.join)(logDir, "launch-chart.log");
-  const out = (0, import_node_fs29.openSync)(logPath, "a");
-  const err2 = (0, import_node_fs29.openSync)(logPath, "a");
+  const logDir = (0, import_node_path38.join)((0, import_node_os6.homedir)(), LAUNCHSECURE_DIR);
+  (0, import_node_fs30.mkdirSync)(logDir, { recursive: true });
+  const logPath = (0, import_node_path38.join)(logDir, "launch-chart.log");
+  const out = (0, import_node_fs30.openSync)(logPath, "a");
+  const err2 = (0, import_node_fs30.openSync)(logPath, "a");
   const portArgs = args.port ? ["--port", String(args.port)] : [];
   const child = (0, import_node_child_process3.spawn)(process.execPath, [entryPath, "serve", ...portArgs], {
     detached: true,
@@ -36717,6 +36928,60 @@ function handleDriftReport(args) {
     items: page
   });
 }
+function handleGenerateSpec(args) {
+  const __resolved = resolveOrErr(args);
+  if ("content" in __resolved) return __resolved;
+  const { rootDir } = __resolved;
+  const target = typeof args.target === "string" ? args.target.trim() : "";
+  if (!target) return err("target is required (a context action node id).");
+  const snippetsDir = typeof args.snippets_dir === "string" && args.snippets_dir.trim() ? args.snippets_dir.trim() : DEFAULT_SNIPPETS_DIR;
+  const specDir = typeof args.spec_dir === "string" && args.spec_dir.trim() ? args.spec_dir.trim() : "tests/generated";
+  const fixtures = args.fixtures && typeof args.fixtures === "object" ? args.fixtures : {};
+  const title = typeof args.title === "string" ? args.title : void 0;
+  const g = readGraph(rootDir, "context");
+  if (!g) return err("No `context` layer found. Run generate_graph first to build context.json.");
+  let node = g.nodes.find((n) => n.id === target);
+  if (!node && !target.startsWith("action:") && !target.startsWith("state:")) {
+    node = g.nodes.find((n) => n.id === `action:${target}`) ?? g.nodes.find((n) => n.id === `state:${target}`);
+  }
+  if (!node) return err(`No context node matching "${target}". Use read_graph layer:context to list nodes.`);
+  const snippets = loadSnippetIndex(rootDir, snippetsDir);
+  const plan = buildTestPlan(g, node.id, snippets);
+  const spec = generateSpec(plan, { title: title ?? String(node.name), specDir, fixtures });
+  return okJson({
+    target: node.id,
+    spec_dir: specDir,
+    suggested_path: `${specDir}/${String(node.name).replace(/[^A-Za-z0-9]+/g, "-").replace(/^-|-$/g, "") || "spec"}.spec.ts`,
+    complete: spec.complete,
+    missing_fixtures: spec.missingFixtures,
+    plan_gaps: plan.gaps,
+    code: spec.code,
+    next: spec.complete ? "Write `code` to suggested_path and run `playwright test` (needs @faker-js/faker installed + the secret env vars set)." : "Supply `fixtures` for missing_fixtures (real seeded values), then regenerate."
+  });
+}
+function handleTestPlan(args) {
+  const __resolved = resolveOrErr(args);
+  if ("content" in __resolved) return __resolved;
+  const { rootDir } = __resolved;
+  const target = typeof args.target === "string" ? args.target.trim() : "";
+  if (!target) return err("target is required (a context action node id).");
+  const snippetsDir = typeof args.snippets_dir === "string" && args.snippets_dir.trim() ? args.snippets_dir.trim() : DEFAULT_SNIPPETS_DIR;
+  const g = readGraph(rootDir, "context");
+  if (!g) return err("No `context` layer found. Run generate_graph first to build context.json.");
+  let node = g.nodes.find((n) => n.id === target);
+  if (!node && !target.startsWith("action:") && !target.startsWith("state:")) {
+    node = g.nodes.find((n) => n.id === `action:${target}`) ?? g.nodes.find((n) => n.id === `state:${target}`);
+  }
+  if (!node) return err(`No context node matching "${target}". Use read_graph layer:context to list nodes.`);
+  const snippets = loadSnippetIndex(rootDir, snippetsDir);
+  const plan = buildTestPlan(g, node.id, snippets);
+  return okJson({
+    ...plan,
+    snippets_dir: snippetsDir,
+    snippets_found: snippets.size,
+    next: plan.runnable ? "Runnable: execute the snippets in `steps` order, threading produced state forward." : "Not yet runnable \u2014 resolve `gaps` (scaffold_snippet for missing bindings; add a producer for unmet states)."
+  });
+}
 function handleScaffoldSnippet(args) {
   const __resolved = resolveOrErr(args);
   if ("content" in __resolved) return __resolved;
@@ -36998,20 +37263,20 @@ function handleDetectProjectStack() {
       if (ref.type === "references_api") stats.references_api++;
     }
   }
-  const srcDir = (0, import_node_path36.join)(rootDir, "src");
-  if ((0, import_node_fs29.existsSync)(srcDir)) {
+  const srcDir = (0, import_node_path38.join)(rootDir, "src");
+  if ((0, import_node_fs30.existsSync)(srcDir)) {
     const scanDir = (dir) => {
-      if (!(0, import_node_fs29.existsSync)(dir)) return;
-      for (const entry of (0, import_node_fs29.readdirSync)(dir, { withFileTypes: true })) {
+      if (!(0, import_node_fs30.existsSync)(dir)) return;
+      for (const entry of (0, import_node_fs30.readdirSync)(dir, { withFileTypes: true })) {
         if (entry.name.startsWith(".") || entry.name === "node_modules") continue;
-        const full = (0, import_node_path36.join)(dir, entry.name);
+        const full = (0, import_node_path38.join)(dir, entry.name);
         if (entry.isDirectory()) {
           scanDir(full);
           continue;
         }
-        if (![".ts", ".tsx"].includes((0, import_node_path36.extname)(entry.name))) continue;
+        if (![".ts", ".tsx"].includes((0, import_node_path38.extname)(entry.name))) continue;
         try {
-          const content = (0, import_node_fs29.readFileSync)(full, "utf-8");
+          const content = (0, import_node_fs30.readFileSync)(full, "utf-8");
           const matches = content.match(/@api\s+(GET|POST|PUT|DELETE|PATCH)\s+\/\S+/g);
           if (matches) stats.annotations += matches.length;
         } catch {
@@ -37030,7 +37295,7 @@ function handleDetectProjectStack() {
     name: p.name,
     root: p.root,
     absolute_root: p.absoluteRoot,
-    has_graph: (0, import_node_fs29.existsSync)((0, import_node_path36.join)(p.absoluteRoot, LAUNCHSECURE_DIR, "graphs"))
+    has_graph: (0, import_node_fs30.existsSync)((0, import_node_path38.join)(p.absoluteRoot, LAUNCHSECURE_DIR, "graphs"))
   }));
   return okJson({
     languages,
@@ -37164,6 +37429,14 @@ async function handleMessage(msg) {
       respond(id ?? null, withFreshnessMeta(handleScaffoldSnippet(args), args));
       return;
     }
+    if (toolName === "test_plan") {
+      respond(id ?? null, withFreshnessMeta(handleTestPlan(args), args));
+      return;
+    }
+    if (toolName === "generate_spec") {
+      respond(id ?? null, withFreshnessMeta(handleGenerateSpec(args), args));
+      return;
+    }
     if (toolName === "trace_path") {
       respond(id ?? null, withFreshnessMeta(handleTracePath(args), args));
       return;