@dereekb/dbx-components-mcp 13.10.3 → 13.10.4

package/dbx-components-mcp.js

@@ -5,7 +5,7 @@ const require = __createRequire(import.meta.url);
 // packages/dbx-components-mcp/package.json
 var package_default = {
   name: "@dereekb/dbx-components-mcp",
-  version: "13.10.3",
+  version: "13.10.4",
   type: "module",
   bin: {
     "dbx-components-mcp": "dbx-components-mcp.js"
@@ -836,10 +836,10 @@ var defaultGlobber = async (input) => {
   }
   return matches;
 };
-async function loadPackageName(packagePath, readFile13) {
+async function loadPackageName(packagePath, readFile15) {
   let raw = null;
   try {
-    raw = await readFile13(packagePath);
+    raw = await readFile15(packagePath);
   } catch {
     raw = null;
   }
@@ -899,15 +899,15 @@ function globToRegex(pattern) {
 var DEFAULT_READ_FILE = defaultReadFile;
 var DEFAULT_GLOBBER = defaultGlobber;
 async function buildForgeFieldsManifest(input) {
-  const { projectRoot, generator, readFile: readFile13 = DEFAULT_READ_FILE, globber = DEFAULT_GLOBBER, now = () => /* @__PURE__ */ new Date() } = input;
+  const { projectRoot, generator, readFile: readFile15 = DEFAULT_READ_FILE, globber = DEFAULT_GLOBBER, now = () => /* @__PURE__ */ new Date() } = input;
   const configPath = resolve(projectRoot, FORGE_FIELDS_SCAN_CONFIG_FILENAME);
   const packagePath = resolve(projectRoot, "package.json");
-  const configOutcome = await loadScanConfig(configPath, readFile13);
+  const configOutcome = await loadScanConfig(configPath, readFile15);
   if (configOutcome.kind !== "ok") {
     return configOutcome.outcome;
   }
   const scanSection = configOutcome.section;
-  const packageOutcome = await loadPackageName(packagePath, readFile13);
+  const packageOutcome = await loadPackageName(packagePath, readFile15);
   if (packageOutcome.kind !== "ok") {
     return packageOutcome.outcome;
   }
@@ -920,7 +920,7 @@ async function buildForgeFieldsManifest(input) {
   const project = new Project({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   for (const relPath of filePaths) {
     const absolute = resolve(projectRoot, relPath);
-    const text = await readFile13(absolute);
+    const text = await readFile15(absolute);
     project.createSourceFile(absolute, text, { overwrite: true });
   }
   const extractResult = extractForgeFieldEntries({ project });
@@ -951,10 +951,10 @@ async function buildForgeFieldsManifest(input) {
   }
   return outcome;
 }
-async function loadScanConfig(configPath, readFile13) {
+async function loadScanConfig(configPath, readFile15) {
   let raw = null;
   try {
-    raw = await readFile13(configPath);
+    raw = await readFile15(configPath);
   } catch {
     raw = null;
   }
@@ -1020,7 +1020,7 @@ import { resolve as resolve2 } from "node:path";
 var DEFAULT_READ_FILE2 = (path) => nodeReadFile2(path, "utf-8");
 var DEFAULT_WRITE_FILE = (path, data) => nodeWriteFile(path, data, "utf-8");
 async function runScanCliBase(input, config) {
-  const { argv, cwd, generator, readFile: readFile13 = DEFAULT_READ_FILE2, writeFile: writeFile2 = DEFAULT_WRITE_FILE, globber, now, log = console.log, errorLog = console.error } = input;
+  const { argv, cwd, generator, readFile: readFile15 = DEFAULT_READ_FILE2, writeFile: writeFile2 = DEFAULT_WRITE_FILE, globber, now, log = console.log, errorLog = console.error } = input;
   let result;
   const args = parseScanArgs(argv);
   if (args.kind === "parse-error") {
@@ -1036,8 +1036,8 @@ async function runScanCliBase(input, config) {
     result = { exitCode: 2 };
   } else {
     const projectRoot = resolve2(cwd, args.project);
-    const outcome = await config.buildManifest({ projectRoot, generator, readFile: readFile13, globber, now });
-    result = await handleOutcome({ outcome, args, projectArg: args.project, readFile: readFile13, writeFile: writeFile2, log, errorLog, config });
+    const outcome = await config.buildManifest({ projectRoot, generator, readFile: readFile15, globber, now });
+    result = await handleOutcome({ outcome, args, projectArg: args.project, readFile: readFile15, writeFile: writeFile2, log, errorLog, config });
   }
   return result;
 }
@@ -1091,7 +1091,7 @@ function parseScanArgs(argv) {
   return result;
 }
 async function handleOutcome(input) {
-  const { outcome, args, projectArg, readFile: readFile13, writeFile: writeFile2, log, errorLog, config } = input;
+  const { outcome, args, projectArg, readFile: readFile15, writeFile: writeFile2, log, errorLog, config } = input;
   let result;
   if (outcome.kind === "success") {
     const finalOutPath = args.out === void 0 ? outcome.outPath : resolve2(outcome.outPath, "..", args.out);
@@ -1099,7 +1099,7 @@ async function handleOutcome(input) {
     if (args.check) {
       let existing = null;
       try {
-        existing = await readFile13(finalOutPath);
+        existing = await readFile15(finalOutPath);
       } catch {
         existing = null;
       }
@@ -1579,15 +1579,15 @@ var SCAN_CONFIG_FILENAME = "dbx-mcp.scan.json";
 var DEFAULT_READ_FILE3 = defaultReadFile;
 var DEFAULT_GLOBBER2 = defaultGlobber;
 async function buildManifest(input) {
-  const { projectRoot, generator, readFile: readFile13 = DEFAULT_READ_FILE3, globber = DEFAULT_GLOBBER2, now = () => /* @__PURE__ */ new Date() } = input;
+  const { projectRoot, generator, readFile: readFile15 = DEFAULT_READ_FILE3, globber = DEFAULT_GLOBBER2, now = () => /* @__PURE__ */ new Date() } = input;
   const configPath = resolve3(projectRoot, SCAN_CONFIG_FILENAME);
   const packagePath = resolve3(projectRoot, "package.json");
-  const configOutcome = await loadScanConfig2(configPath, readFile13);
+  const configOutcome = await loadScanConfig2(configPath, readFile15);
   if (configOutcome.kind !== "ok") {
     return configOutcome.outcome;
   }
   const scanConfig = configOutcome.config;
-  const packageOutcome = await loadPackageName(packagePath, readFile13);
+  const packageOutcome = await loadPackageName(packagePath, readFile15);
   if (packageOutcome.kind !== "ok") {
     return packageOutcome.outcome;
   }
@@ -1600,7 +1600,7 @@ async function buildManifest(input) {
   const project = new Project2({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   for (const relPath of filePaths) {
     const absolute = resolve3(projectRoot, relPath);
-    const text = await readFile13(absolute);
+    const text = await readFile15(absolute);
     project.createSourceFile(absolute, text, { overwrite: true });
   }
   const extracted = extractEntries({ project });
@@ -1629,10 +1629,10 @@ async function buildManifest(input) {
   }
   return outcome;
 }
-async function loadScanConfig2(configPath, readFile13) {
+async function loadScanConfig2(configPath, readFile15) {
   let raw = null;
   try {
-    raw = await readFile13(configPath);
+    raw = await readFile15(configPath);
   } catch {
     raw = null;
   }
@@ -1704,7 +1704,7 @@ var USAGE2 = [
 var DEFAULT_READ_FILE4 = (path) => nodeReadFile3(path, "utf-8");
 var DEFAULT_WRITE_FILE2 = (path, data) => nodeWriteFile2(path, data, "utf-8");
 async function runScanCli(input) {
-  const { argv, cwd, generator, readFile: readFile13 = DEFAULT_READ_FILE4, writeFile: writeFile2 = DEFAULT_WRITE_FILE2, globber, now, log = console.log, errorLog = console.error } = input;
+  const { argv, cwd, generator, readFile: readFile15 = DEFAULT_READ_FILE4, writeFile: writeFile2 = DEFAULT_WRITE_FILE2, globber, now, log = console.log, errorLog = console.error } = input;
   let result;
   const args = parseArgs(argv);
   if (args.kind === "parse-error") {
@@ -1720,8 +1720,8 @@ async function runScanCli(input) {
     result = { exitCode: 2 };
   } else {
     const projectRoot = resolve4(cwd, args.project);
-    const outcome = await buildManifest({ projectRoot, generator, readFile: readFile13, globber, now });
-    result = await handleOutcome2({ outcome, args, projectArg: args.project, readFile: readFile13, writeFile: writeFile2, log, errorLog });
+    const outcome = await buildManifest({ projectRoot, generator, readFile: readFile15, globber, now });
+    result = await handleOutcome2({ outcome, args, projectArg: args.project, readFile: readFile15, writeFile: writeFile2, log, errorLog });
   }
   return result;
 }
@@ -1775,12 +1775,12 @@ function parseArgs(argv) {
   return result;
 }
 async function handleSuccessOutcome(input) {
-  const { outcome, args, projectArg, readFile: readFile13, writeFile: writeFile2, log, errorLog } = input;
+  const { outcome, args, projectArg, readFile: readFile15, writeFile: writeFile2, log, errorLog } = input;
   const finalOutPath = args.out === void 0 ? outcome.outPath : resolve4(outcome.outPath, "..", args.out);
   const serialized = serializeManifest(outcome.manifest);
   let result;
   if (args.check) {
-    result = await checkManifest({ finalOutPath, serialized, outcome, projectArg, readFile: readFile13, log, errorLog });
+    result = await checkManifest({ finalOutPath, serialized, outcome, projectArg, readFile: readFile15, log, errorLog });
   } else {
     await writeFile2(finalOutPath, serialized);
     log(`Wrote manifest: ${finalOutPath} (${outcome.manifest.entries.length} entries, ${outcome.scannedFileCount} files scanned)`);
@@ -1789,10 +1789,10 @@ async function handleSuccessOutcome(input) {
   return result;
 }
 async function checkManifest(input) {
-  const { finalOutPath, serialized, outcome, projectArg, readFile: readFile13, log, errorLog } = input;
+  const { finalOutPath, serialized, outcome, projectArg, readFile: readFile15, log, errorLog } = input;
   let existing;
   try {
-    existing = await readFile13(finalOutPath);
+    existing = await readFile15(finalOutPath);
   } catch {
     existing = null;
   }
@@ -1987,13 +1987,13 @@ function parseDecoratorInput(property) {
     }
   }
   const required = requiredFromDecorator ?? !property.hasQuestionToken();
-  const type60 = property.getTypeNode()?.getText() ?? "unknown";
+  const type62 = property.getTypeNode()?.getText() ?? "unknown";
   const initializer = property.getInitializer();
   const defaultValue = initializer === void 0 ? void 0 : initializer.getText();
   return {
     propertyName,
     alias: alias ?? propertyName,
-    type: type60,
+    type: type62,
     required,
     description: readPropertyDescription(property),
     ...defaultValue === void 0 ? {} : { defaultValue }
@@ -2059,22 +2059,22 @@ function parseDecoratorOutput(property) {
     alias = decoratorArg.getLiteralText();
   }
   const initializer = property.getInitializer();
-  let type60 = "unknown";
+  let type62 = "unknown";
   if (initializer !== void 0 && Node4.isNewExpression(initializer)) {
     const typeArgs = initializer.getTypeArguments();
     if (typeArgs.length > 0) {
-      type60 = typeArgs[0].getText();
+      type62 = typeArgs[0].getText();
     }
   } else {
     const explicit = property.getTypeNode()?.getText();
     if (explicit !== void 0) {
-      type60 = explicit;
+      type62 = explicit;
     }
   }
   return {
     propertyName,
     name: alias ?? propertyName,
-    type: type60,
+    type: type62,
     description: readPropertyDescription(property)
   };
 }
@@ -2089,7 +2089,7 @@ function parseSignalOutput(property) {
   }
   const propertyName = property.getName();
   const typeArgs = initializer.getTypeArguments();
-  const type60 = typeArgs.length > 0 ? typeArgs[0].getText() : "void";
+  const type62 = typeArgs.length > 0 ? typeArgs[0].getText() : "void";
   const args = initializer.getArguments();
   let alias;
   if (args.length > 0 && Node4.isObjectLiteralExpression(args[0])) {
@@ -2098,7 +2098,7 @@ function parseSignalOutput(property) {
   return {
     propertyName,
     name: alias ?? propertyName,
-    type: type60,
+    type: type62,
     description: readPropertyDescription(property)
   };
 }
@@ -2485,15 +2485,15 @@ var UI_COMPONENTS_SCAN_CONFIG_FILENAME = "dbx-mcp.scan.json";
 var DEFAULT_READ_FILE5 = defaultReadFile;
 var DEFAULT_GLOBBER3 = defaultGlobber;
 async function buildUiComponentsManifest(input) {
-  const { projectRoot, generator, readFile: readFile13 = DEFAULT_READ_FILE5, globber = DEFAULT_GLOBBER3, now = () => /* @__PURE__ */ new Date() } = input;
+  const { projectRoot, generator, readFile: readFile15 = DEFAULT_READ_FILE5, globber = DEFAULT_GLOBBER3, now = () => /* @__PURE__ */ new Date() } = input;
   const configPath = resolve5(projectRoot, UI_COMPONENTS_SCAN_CONFIG_FILENAME);
   const packagePath = resolve5(projectRoot, "package.json");
-  const configOutcome = await loadScanConfig3(configPath, readFile13);
+  const configOutcome = await loadScanConfig3(configPath, readFile15);
   if (configOutcome.kind !== "ok") {
     return configOutcome.outcome;
   }
   const scanSection = configOutcome.section;
-  const packageOutcome = await loadPackageName(packagePath, readFile13);
+  const packageOutcome = await loadPackageName(packagePath, readFile15);
   if (packageOutcome.kind !== "ok") {
     return packageOutcome.outcome;
   }
@@ -2506,7 +2506,7 @@ async function buildUiComponentsManifest(input) {
   const project = new Project3({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   for (const relPath of filePaths) {
     const absolute = resolve5(projectRoot, relPath);
-    const text = await readFile13(absolute);
+    const text = await readFile15(absolute);
     project.createSourceFile(absolute, text, { overwrite: true });
   }
   const extractResult = extractUiEntries({ project });
@@ -2537,10 +2537,10 @@ async function buildUiComponentsManifest(input) {
   }
   return outcome;
 }
-async function loadScanConfig3(configPath, readFile13) {
+async function loadScanConfig3(configPath, readFile15) {
   let raw = null;
   try {
-    raw = await readFile13(configPath);
+    raw = await readFile15(configPath);
   } catch {
     raw = null;
   }
@@ -2679,11 +2679,11 @@ var DbxMcpConfig = type13({
 var CONFIG_FILENAME = "dbx-mcp.config.json";
 var DEFAULT_READ_FILE6 = (path) => nodeReadFile4(path, "utf-8");
 async function findAndLoadConfig(input) {
-  const { cwd, readFile: readFile13 = DEFAULT_READ_FILE6 } = input;
+  const { cwd, readFile: readFile15 = DEFAULT_READ_FILE6 } = input;
   const configPath = resolve6(cwd, CONFIG_FILENAME);
   let raw = null;
   try {
-    raw = await readFile13(configPath);
+    raw = await readFile15(configPath);
   } catch {
     raw = null;
   }
@@ -2948,10 +2948,10 @@ import { readFile as nodeReadFile5 } from "node:fs/promises";
 import { type as type16 } from "arktype";
 var DEFAULT_READ_FILE7 = (path) => nodeReadFile5(path, "utf-8");
 var SUPPORTED_VERSION = 1;
-async function loadFromSource(source, readFile13, schema) {
+async function loadFromSource(source, readFile15, schema) {
   let raw = null;
   try {
-    raw = await readFile13(source.path);
+    raw = await readFile15(source.path);
   } catch {
     raw = null;
   }
@@ -3008,12 +3008,12 @@ function warningSortKey(warning) {
   return key;
 }
 async function loadManifestsBase(input, config) {
-  const { sources, readFile: readFile13 = DEFAULT_READ_FILE7 } = input;
+  const { sources, readFile: readFile15 = DEFAULT_READ_FILE7 } = input;
   const { name, schema, extractIndexValue, buildEntryKey } = config;
   const successes = [];
   const warnings = [];
   for (const source of sources) {
-    const outcome = await loadFromSource(source, readFile13, schema);
+    const outcome = await loadFromSource(source, readFile15, schema);
     if (outcome.kind === "success") {
       successes.push({ source, manifest: outcome.manifest });
     } else if (isStrictSource(source)) {
@@ -3117,9 +3117,9 @@ var DEFAULT_BUNDLED_PATHS = () => {
   return DEFAULT_BUNDLED_FILENAMES.map((name) => resolve7(packageRoot, "generated", name));
 };
 async function loadActionRegistry(input) {
-  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS, readFile: readFile13 } = input;
+  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS, readFile: readFile15 } = input;
   const bundledSources = bundledManifestPaths().map((path) => ({ origin: "bundled", path }));
-  const configResult = await findAndLoadConfig({ cwd, readFile: readFile13 });
+  const configResult = await findAndLoadConfig({ cwd, readFile: readFile15 });
   const externalSources = [];
   if (configResult.config !== null && configResult.configPath !== null) {
     const baseDir = dirname(configResult.configPath);
@@ -3133,7 +3133,7 @@ async function loadActionRegistry(input) {
   let loaderWarnings = [];
   const sources = [...bundledSources, ...externalSources];
   if (sources.length > 0) {
-    const loaded = await loadActionManifests({ sources, readFile: readFile13 });
+    const loaded = await loadActionManifests({ sources, readFile: readFile15 });
     registry = createActionRegistry(loaded);
     loaderWarnings = loaded.warnings;
   }
@@ -3333,9 +3333,9 @@ var DEFAULT_BUNDLED_PATHS2 = () => {
   return DEFAULT_BUNDLED_FILENAMES2.map((name) => resolve8(packageRoot, "generated", name));
 };
 async function loadFilterRegistry(input) {
-  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS2, readFile: readFile13 } = input;
+  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS2, readFile: readFile15 } = input;
   const bundledSources = bundledManifestPaths().map((path) => ({ origin: "bundled", path }));
-  const configResult = await findAndLoadConfig({ cwd, readFile: readFile13 });
+  const configResult = await findAndLoadConfig({ cwd, readFile: readFile15 });
   const externalSources = [];
   if (configResult.config !== null && configResult.configPath !== null) {
     const baseDir = dirname2(configResult.configPath);
@@ -3349,7 +3349,7 @@ async function loadFilterRegistry(input) {
   let loaderWarnings = [];
   const sources = [...bundledSources, ...externalSources];
   if (sources.length > 0) {
-    const loaded = await loadFilterManifests({ sources, readFile: readFile13 });
+    const loaded = await loadFilterManifests({ sources, readFile: readFile15 });
     registry = createFilterRegistry(loaded);
     loaderWarnings = loaded.warnings;
   }
@@ -3580,9 +3580,9 @@ var DEFAULT_BUNDLED_PATHS3 = () => {
   return DEFAULT_BUNDLED_FILENAMES3.map((name) => resolve9(packageRoot, "generated", name));
 };
 async function loadForgeFieldRegistry(input) {
-  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS3, readFile: readFile13 } = input;
+  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS3, readFile: readFile15 } = input;
   const bundledSources = bundledManifestPaths().map((path) => ({ origin: "bundled", path }));
-  const configResult = await findAndLoadConfig({ cwd, readFile: readFile13 });
+  const configResult = await findAndLoadConfig({ cwd, readFile: readFile15 });
   const externalSources = [];
   if (configResult.config !== null && configResult.configPath !== null) {
     const baseDir = dirname3(configResult.configPath);
@@ -3596,7 +3596,7 @@ async function loadForgeFieldRegistry(input) {
   let loaderWarnings = [];
   const sources = [...bundledSources, ...externalSources];
   if (sources.length > 0) {
-    const loaded = await loadForgeFieldManifests({ sources, readFile: readFile13 });
+    const loaded = await loadForgeFieldManifests({ sources, readFile: readFile15 });
     registry = createForgeFieldRegistry(loaded);
     loaderWarnings = loaded.warnings;
   }
@@ -3762,9 +3762,9 @@ var DEFAULT_BUNDLED_PATHS4 = () => {
   return DEFAULT_BUNDLED_FILENAMES4.map((name) => resolve10(packageRoot, "generated", name));
 };
 async function loadPipeRegistry(input) {
-  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS4, readFile: readFile13 } = input;
+  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS4, readFile: readFile15 } = input;
   const bundledSources = bundledManifestPaths().map((path) => ({ origin: "bundled", path }));
-  const configResult = await findAndLoadConfig({ cwd, readFile: readFile13 });
+  const configResult = await findAndLoadConfig({ cwd, readFile: readFile15 });
   const externalSources = [];
   if (configResult.config !== null && configResult.configPath !== null) {
     const baseDir = dirname4(configResult.configPath);
@@ -3778,7 +3778,7 @@ async function loadPipeRegistry(input) {
   let loaderWarnings = [];
   const sources = [...bundledSources, ...externalSources];
   if (sources.length > 0) {
-    const loaded = await loadPipeManifests({ sources, readFile: readFile13 });
+    const loaded = await loadPipeManifests({ sources, readFile: readFile15 });
     registry = createPipeRegistry(loaded);
     loaderWarnings = loaded.warnings;
   }
@@ -3882,10 +3882,10 @@ function isCoreTopic(topic) {
 // packages/dbx-components-mcp/src/manifest/loader.ts
 var DEFAULT_READ_FILE8 = (path) => nodeReadFile6(path, "utf-8");
 var SUPPORTED_VERSION2 = 1;
-async function loadFromSource2(source, readFile13) {
+async function loadFromSource2(source, readFile15) {
   let raw = null;
   try {
-    raw = await readFile13(source.path);
+    raw = await readFile15(source.path);
   } catch {
   }
   let result;
@@ -3972,11 +3972,11 @@ function warningSortKey2(warning) {
   return key;
 }
 async function loadSemanticTypeManifests(input) {
-  const { sources, readFile: readFile13 = DEFAULT_READ_FILE8 } = input;
+  const { sources, readFile: readFile15 = DEFAULT_READ_FILE8 } = input;
   const successes = [];
   const warnings = [];
   for (const source of sources) {
-    const outcome = await loadFromSource2(source, readFile13);
+    const outcome = await loadFromSource2(source, readFile15);
     if (outcome.kind === "success") {
       successes.push({ source, manifest: outcome.manifest });
     } else if (isStrictSource2(source)) {
@@ -4073,9 +4073,9 @@ var DEFAULT_BUNDLED_PATHS5 = () => {
   return DEFAULT_BUNDLED_FILENAMES5.map((name) => resolve11(packageRoot, "generated", name));
 };
 async function loadSemanticTypeRegistry(input) {
-  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS5, readFile: readFile13 } = input;
+  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS5, readFile: readFile15 } = input;
   const bundledSources = bundledManifestPaths().map((path) => ({ origin: "bundled", path }));
-  const configResult = await findAndLoadConfig({ cwd, readFile: readFile13 });
+  const configResult = await findAndLoadConfig({ cwd, readFile: readFile15 });
   const externalSources = [];
   if (configResult.config !== null && configResult.configPath !== null) {
     const baseDir = dirname5(configResult.configPath);
@@ -4089,7 +4089,7 @@ async function loadSemanticTypeRegistry(input) {
   let loaderWarnings = [];
   const sources = [...bundledSources, ...externalSources];
   if (sources.length > 0) {
-    const loaded = await loadSemanticTypeManifests({ sources, readFile: readFile13 });
+    const loaded = await loadSemanticTypeManifests({ sources, readFile: readFile15 });
     registry = createSemanticTypeRegistry(loaded);
     loaderWarnings = loaded.warnings;
   }
@@ -4234,9 +4234,9 @@ var DEFAULT_BUNDLED_PATHS6 = () => {
   return DEFAULT_BUNDLED_FILENAMES6.map((name) => resolve12(packageRoot, "generated", name));
 };
 async function loadUiComponentRegistry(input) {
-  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS6, readFile: readFile13 } = input;
+  const { cwd, bundledManifestPaths = DEFAULT_BUNDLED_PATHS6, readFile: readFile15 } = input;
   const bundledSources = bundledManifestPaths().map((path) => ({ origin: "bundled", path }));
-  const configResult = await findAndLoadConfig({ cwd, readFile: readFile13 });
+  const configResult = await findAndLoadConfig({ cwd, readFile: readFile15 });
   const externalSources = [];
   if (configResult.config !== null && configResult.configPath !== null) {
     const baseDir = dirname6(configResult.configPath);
@@ -4250,7 +4250,7 @@ async function loadUiComponentRegistry(input) {
   let loaderWarnings = [];
   const sources = [...bundledSources, ...externalSources];
   if (sources.length > 0) {
-    const loaded = await loadUiComponentManifests({ sources, readFile: readFile13 });
+    const loaded = await loadUiComponentManifests({ sources, readFile: readFile15 });
     registry = createUiComponentRegistry(loaded);
     loaderWarnings = loaded.warnings;
   }
@@ -7262,7 +7262,7 @@ function createLookupFormTool(config) {
     }
     return lines.join("\n").trimEnd();
   }
-  function run10(rawArgs) {
+  function run12(rawArgs) {
     let args;
     try {
       args = parseLookupFormArgs(rawArgs);
@@ -7291,7 +7291,7 @@ function createLookupFormTool(config) {
   }
   const tool = {
     definition: DBX_FORM_LOOKUP_TOOL,
-    run: run10
+    run: run12
   };
   return tool;
 }
@@ -7480,7 +7480,7 @@ function formatSearchResults(input) {
 }
 function createSearchFormTool(config) {
   const { registry } = config;
-  function run10(rawArgs) {
+  function run12(rawArgs) {
     return runSearchTool(
       {
         entries: registry.all,
@@ -7496,7 +7496,7 @@ function createSearchFormTool(config) {
   }
   const tool = {
     definition: DBX_FORM_SEARCH_TOOL,
-    run: run10
+    run: run12
   };
   return tool;
 }
@@ -8019,7 +8019,7 @@ function renderScaffold(specs, valueTypeName, wrapInSection) {
 }
 function createFormScaffoldTool(config) {
   const { registry } = config;
-  function run10(rawArgs) {
+  function run12(rawArgs) {
     let args;
     try {
       args = parseScaffoldArgs(rawArgs);
@@ -8053,7 +8053,7 @@ ${code11}
   }
   const tool = {
     definition: DBX_FORM_SCAFFOLD_TOOL,
-    run: run10
+    run: run12
   };
   return tool;
 }
@@ -8314,7 +8314,7 @@ function formatNotFound3(normalized, candidates) {
 }
 function createLookupUiTool(input) {
   const { registry } = input;
-  const run10 = (rawArgs) => {
+  const run12 = (rawArgs) => {
     let args;
     try {
       args = parseLookupUiArgs(rawArgs);
@@ -8341,7 +8341,7 @@ function createLookupUiTool(input) {
     const result = { content: [{ type: "text", text }] };
     return result;
   };
-  return { definition: DBX_UI_LOOKUP_TOOL, run: run10 };
+  return { definition: DBX_UI_LOOKUP_TOOL, run: run12 };
 }
 
 // packages/dbx-components-mcp/src/tools/search-ui.tool.ts
@@ -8523,7 +8523,7 @@ function formatSearchResults2(options) {
 }
 function createSearchUiTool(input) {
   const { registry } = input;
-  const run10 = (rawArgs) => {
+  const run12 = (rawArgs) => {
     let args;
     try {
       args = parseSearchUiArgs(rawArgs);
@@ -8538,7 +8538,7 @@ function createSearchUiTool(input) {
     const result = { content: [{ type: "text", text }] };
     return result;
   };
-  return { definition: DBX_UI_SEARCH_TOOL, run: run10 };
+  return { definition: DBX_UI_SEARCH_TOOL, run: run12 };
 }
 
 // packages/dbx-components-mcp/src/tools/ui-examples.tool.ts
@@ -9934,7 +9934,7 @@ var FolderValidateArgsType = type30({
 });
 function createFolderValidateTool(config) {
   const { definition, inspectFolder: inspectFolder3, validate, format } = config;
-  async function run10(rawArgs) {
+  async function run12(rawArgs) {
     const parsed = FolderValidateArgsType(rawArgs);
     if (parsed instanceof type30.errors) {
       return toolError(`Invalid arguments: ${parsed.summary}`);
@@ -9974,7 +9974,7 @@ function createFolderValidateTool(config) {
     };
     return toolResult;
   }
-  const tool = { definition, run: run10 };
+  const tool = { definition, run: run12 };
   return tool;
 }
 var SourceValidateArgsType = type30({
@@ -9984,7 +9984,7 @@ var SourceValidateArgsType = type30({
 });
 function createSourceValidateTool(config) {
   const { definition, validate, format } = config;
-  async function run10(rawArgs) {
+  async function run12(rawArgs) {
     const parsed = SourceValidateArgsType(rawArgs);
     if (parsed instanceof type30.errors) {
       return toolError(`Invalid arguments: ${parsed.summary}`);
@@ -10011,7 +10011,7 @@ function createSourceValidateTool(config) {
     };
     return toolResult;
   }
-  const tool = { definition, run: run10 };
+  const tool = { definition, run: run12 };
   return tool;
 }
 var TwoSideValidateArgsType = type30({
@@ -10038,7 +10038,7 @@ function resolveTwoSideInput(parsed) {
 }
 function createTwoSideValidateTool(config) {
   const { definition, inspectAndValidate, format } = config;
-  async function run10(rawArgs) {
+  async function run12(rawArgs) {
     const parsed = TwoSideValidateArgsType(rawArgs);
     if (parsed instanceof type30.errors) {
       return toolError(`Invalid arguments: ${parsed.summary}`);
@@ -10055,7 +10055,7 @@ function createTwoSideValidateTool(config) {
     };
     return toolResult;
   }
-  const tool = { definition, run: run10 };
+  const tool = { definition, run: run12 };
   return tool;
 }
 var ListAppArgsType = type30({
@@ -10065,7 +10065,7 @@ var ListAppArgsType = type30({
 });
 function createListAppTool(config) {
   const { definition, inspectAndList, formatMarkdown: formatMarkdown2, formatJson: formatJson2 } = config;
-  async function run10(rawArgs) {
+  async function run12(rawArgs) {
     const parsed = ListAppArgsType(rawArgs);
     if (parsed instanceof type30.errors) {
       return toolError(`Invalid arguments: ${parsed.summary}`);
@@ -10079,7 +10079,7 @@ function createListAppTool(config) {
     const toolResult = { content: [{ type: "text", text }] };
     return toolResult;
   }
-  const tool = { definition, run: run10 };
+  const tool = { definition, run: run12 };
   return tool;
 }
 
@@ -10113,15 +10113,18 @@ function findDataInterfaces(sourceFile, groupInterface) {
       continue;
     }
     const fields = extractInterfaceFields(iface);
-    out.push({ name, fields });
+    const dbxModelTag = readDbxModelTag(iface.getJsDocs());
+    out.push({ name, line: iface.getStartLineNumber(), dbxModelTag, fields });
   }
   return out;
 }
 function extractInterfaceFields(iface) {
   const fields = [];
   for (const prop of iface.getProperties()) {
-    const jsDocFirstLine = firstJsDocLine(prop.getJsDocs());
-    const field = { name: prop.getName(), line: prop.getStartLineNumber(), jsDocFirstLine };
+    const jsDocs = prop.getJsDocs();
+    const jsDocFirstLine = firstJsDocLine(jsDocs);
+    const dbxModelVariableTag = readDbxModelVariableTag(jsDocs);
+    const field = { name: prop.getName(), line: prop.getStartLineNumber(), jsDocFirstLine, dbxModelVariableTag };
     fields.push(field);
   }
   return fields;
@@ -10154,10 +10157,46 @@ function findGroupInterface(sourceFile) {
     name: iface.getName(),
     exported: iface.isExported(),
     properties,
-    line: iface.getStartLineNumber()
+    line: iface.getStartLineNumber(),
+    dbxModelGroupTag: readDbxModelGroupTag2(iface.getJsDocs())
   };
   return result;
 }
+function readDbxModelGroupTag2(jsDocs) {
+  let result;
+  for (const jsDoc of jsDocs) {
+    for (const tag of jsDoc.getTags()) {
+      if (tag.getTagName() !== "dbxModelGroup") continue;
+      const text = tag.getCommentText()?.trim() ?? "";
+      result = text.length > 0 ? text : true;
+    }
+  }
+  return result;
+}
+function readDbxModelTag(jsDocs) {
+  let result = false;
+  for (const jsDoc of jsDocs) {
+    for (const tag of jsDoc.getTags()) {
+      if (tag.getTagName() === "dbxModel") {
+        result = true;
+      }
+    }
+  }
+  return result;
+}
+function readDbxModelVariableTag(jsDocs) {
+  let result;
+  for (const jsDoc of jsDocs) {
+    for (const tag of jsDoc.getTags()) {
+      if (tag.getTagName() !== "dbxModelVariable") continue;
+      const text = tag.getCommentText()?.trim();
+      if (text !== void 0 && text.length > 0 && result === void 0) {
+        result = text;
+      }
+    }
+  }
+  return result;
+}
 function findGroupTypes(sourceFile) {
   const candidate = sourceFile.getTypeAliases().find((t) => {
     const name = t.getName();
@@ -10737,6 +10776,16 @@ var RULE_CATALOG = [
     whenItDoesNotApply: "Fields whose name is unambiguously self-describing (rare with 1-4 char abbreviations).",
     canonicalFix: "Add `/** <fullName> -- <description> *\\/` above the field declaration."
   },
+  {
+    code: "MODEL_FIELD_MISSING_VARIABLE_TAG",
+    source: "dbx_model_validate",
+    severity: "warning",
+    title: "A persisted field is missing its `@dbxModelVariable <name>` JSDoc tag",
+    whatItFlags: "A persisted field is missing its `@dbxModelVariable <name>` JSDoc tag.",
+    whenItApplies: "Every field on a `@dbxModel` interface \u2014 the tag carries the human-readable long name the catalog and decoder use when surfacing the field to operators.",
+    whenItDoesNotApply: "Fields on embedded sub-object interfaces (no `@dbxModel` parent) and fields the project deliberately leaves untagged (rare).",
+    canonicalFix: "Append `@dbxModelVariable <longName>` to the field's JSDoc block."
+  },
   {
     code: "MODEL_FIELD_NAME_TOO_LONG",
     source: "dbx_model_validate",
@@ -10747,6 +10796,22 @@ var RULE_CATALOG = [
     whenItDoesNotApply: "Fields that compose well-known multi-character abbreviations the project intentionally allows.",
     canonicalFix: "Rename the field to a 1\u20134 character abbreviation (e.g. `name` \u2192 `n`, `userId` \u2192 `uid`)."
   },
+  {
+    code: "MODEL_GROUP_INTERFACE_MISSING_TAG",
+    source: "dbx_model_validate",
+    severity: "error",
+    title: "The `<Group>FirestoreCollections` interface is missing its `@dbxModelGroup` JSDoc tag",
+    whatItFlags: "The `<Group>FirestoreCollections` interface is missing its `@dbxModelGroup` JSDoc tag.",
+    whenItApplies: "Every group container \u2014 the rich catalog extractor (`scan/extract-models`) requires the tag to register the group, and downstream traversal/referencing depends on that registration.",
+    whenItDoesNotApply: "Files in `@dereekb/firebase` itself (upstream-owned sources).",
+    canonicalFix: "Add `@dbxModelGroup <Group>` to the JSDoc above the `<Group>FirestoreCollections` declaration.",
+    seeAlso: [
+      {
+        kind: "artifact",
+        target: "firestore-model"
+      }
+    ]
+  },
   {
     code: "MODEL_IDENTITY_BAD_ARGS",
     source: "dbx_model_validate",
@@ -10767,6 +10832,38 @@ var RULE_CATALOG = [
     whenItDoesNotApply: "When intentionally module-private (rare).",
     canonicalFix: "Add `export` to the identity constant declaration."
   },
+  {
+    code: "MODEL_IDENTITY_NOT_TAGGED",
+    source: "dbx_model_validate",
+    severity: "error",
+    title: "`firestoreModelIdentity(...)` was found but its corresponding model interface lacks the `@dbxModel` JSDoc tag, leaving the model invisible to the catalog and to downstream traversal/referencing code",
+    whatItFlags: "`firestoreModelIdentity(...)` was found but its corresponding model interface lacks the `@dbxModel` JSDoc tag, leaving the model invisible to the catalog and to downstream traversal/referencing code.",
+    whenItApplies: "Every `firestoreModelIdentity(...)` call whose `<PascalName>` interface is missing `@dbxModel`. Anchored at the identity line so the fix points at both the interface and the identity.",
+    whenItDoesNotApply: "Files in `@dereekb/firebase` itself.",
+    canonicalFix: "Add `@dbxModel` to the JSDoc on the `<PascalName>` interface so the catalog and decoder recognise it as a model.",
+    seeAlso: [
+      {
+        kind: "artifact",
+        target: "firestore-model"
+      }
+    ]
+  },
+  {
+    code: "MODEL_INTERFACE_MISSING_TAG",
+    source: "dbx_model_validate",
+    severity: "error",
+    title: "The model's data interface is missing its `@dbxModel` JSDoc tag",
+    whatItFlags: "The model's data interface is missing its `@dbxModel` JSDoc tag.",
+    whenItApplies: "Every `<PascalName>` interface that anchors a `firestoreModelIdentity(...)` model \u2014 the rich catalog extractor (`scan/extract-models`) requires the tag to register the model.",
+    whenItDoesNotApply: "Embedded sub-object interfaces (no matching identity) and files in `@dereekb/firebase` itself.",
+    canonicalFix: "Add `@dbxModel` to the JSDoc above the `<PascalName>` interface declaration.",
+    seeAlso: [
+      {
+        kind: "artifact",
+        target: "firestore-model"
+      }
+    ]
+  },
   {
     code: "MODEL_INTERFACE_NOT_EXPORTED",
     source: "dbx_model_validate",
@@ -12562,9 +12659,7 @@ function checkFieldJsDocs(file, violations) {
           line: field.line,
           model: iface.name
         });
-        continue;
-      }
-      if (!FULL_NAME_FIRST_LINE.test(field.jsDocFirstLine)) {
+      } else if (!FULL_NAME_FIRST_LINE.test(field.jsDocFirstLine)) {
         pushViolation(violations, {
           code: "MODEL_FIELD_JSDOC_NO_FULL_NAME",
           severity: "warning",
@@ -12574,6 +12669,16 @@ function checkFieldJsDocs(file, violations) {
           model: iface.name
         });
       }
+      if (iface.dbxModelTag && field.dbxModelVariableTag === void 0) {
+        pushViolation(violations, {
+          code: "MODEL_FIELD_MISSING_VARIABLE_TAG",
+          severity: "warning",
+          message: `Field \`${field.name}\` in interface \`${iface.name}\` is missing its \`@dbxModelVariable <name>\` JSDoc tag. The catalog uses the tag for the field's long name.`,
+          file: file.name,
+          line: field.line,
+          model: iface.name
+        });
+      }
     }
   }
 }
@@ -12598,6 +12703,15 @@ function checkFileLevel(file, violations) {
         model: void 0
       });
     }
+    if (groupInterface.dbxModelGroupTag === void 0) {
+      pushViolation(violations, {
+        code: "MODEL_GROUP_INTERFACE_MISSING_TAG",
+        message: `Interface \`${groupInterface.name}\` is missing its \`@dbxModelGroup\` JSDoc tag. Add \`@dbxModelGroup <Group>\` so the catalog and downstream traversal can register the group.`,
+        file: name,
+        line: groupInterface.line,
+        model: void 0
+      });
+    }
     checkGroupInterfaceCoverage(file, violations);
   } else {
     pushViolation(violations, {
@@ -12747,6 +12861,23 @@ function checkInterface(file, model, violations) {
       model: model.name
     });
   }
+  const dataInterface = file.dataInterfaces.find((d) => d.name === model.name);
+  if (dataInterface && !dataInterface.dbxModelTag) {
+    pushViolation(violations, {
+      code: "MODEL_INTERFACE_MISSING_TAG",
+      message: `Interface \`${model.name}\` is missing its \`@dbxModel\` JSDoc tag. The catalog skips untagged interfaces, so downstream traversal/referencing of \`${model.name}\` is broken.`,
+      file: file.name,
+      line: dataInterface.line,
+      model: model.name
+    });
+    pushViolation(violations, {
+      code: "MODEL_IDENTITY_NOT_TAGGED",
+      message: `\`firestoreModelIdentity\` was found for \`${model.identity.constName}\` but its \`${model.name}\` interface is not tagged with \`@dbxModel\`. Tag the interface so the catalog registers the model.`,
+      file: file.name,
+      line: model.identity.line,
+      model: model.name
+    });
+  }
 }
 function checkRoles(file, model, violations) {
   if (!model.rolesType) {
@@ -13279,7 +13410,7 @@ function validateFirebaseModelSources(sources) {
 var DBX_MODEL_VALIDATE_TOOL = {
   name: "dbx_model_validate",
   description: [
-    "Validate a @dereekb/firebase model file against the workspace model-group convention. Checks that the file exports a `<Group>FirestoreCollections` interface and `<Group>Types` union, and that every `firestoreModelIdentity(...)` has the canonical declarations in order (interface, roles, document class, converter, collection reference fn, collection type, collection fn) \u2014 plus the factory-type + collection-group triple for subcollections. All reported issues are hard errors.",
+    "Validate a @dereekb/firebase model file against the workspace model-group convention. Checks that the file exports a `<Group>FirestoreCollections` interface and `<Group>Types` union, and that every `firestoreModelIdentity(...)` has the canonical declarations in order (interface, roles, document class, converter, collection reference fn, collection type, collection fn) \u2014 plus the factory-type + collection-group triple for subcollections. Also enforces JSDoc tagging required for catalog discovery and downstream traversal: `@dbxModelGroup <Group>` on the group container, `@dbxModel` on every model interface (with a per-identity `MODEL_IDENTITY_NOT_TAGGED` error anchored at the `firestoreModelIdentity(...)` line), and `@dbxModelVariable <name>` on every persisted field (warning).",
     "",
     "Provide at least one of:",
     "- `sources`: array of `{ name, text }` \u2014 file contents supplied directly.",
@@ -14496,12 +14627,14 @@ function formatResult3(result) {
 }
 
 // packages/dbx-components-mcp/src/tools/model-validate-folder/inspect.ts
-import { readdir as readdir2, stat as stat4 } from "node:fs/promises";
-import { basename as basename4 } from "node:path";
+import { readdir as readdir2, readFile as readFile4, stat as stat4 } from "node:fs/promises";
+import { basename as basename4, join as join3 } from "node:path";
+var CONTENT_VALIDATION_SKIP_SUFFIXES = [".spec.ts", ".id.ts", ".query.ts", ".action.ts", ".api.ts"];
 async function inspectFolder(path) {
   const name = basename4(path);
   let status;
   let files = [];
+  let sources = [];
   try {
     const stats = await stat4(path);
     if (stats.isDirectory()) {
@@ -14514,6 +14647,7 @@ async function inspectFolder(path) {
         collected.push(entry.name);
       }
       files = collected;
+      sources = await readModelSources(path, collected);
     } else {
       status = "not-directory";
     }
@@ -14525,9 +14659,19 @@ async function inspectFolder(path) {
       throw err;
     }
   }
-  const result = { name, path, status, files };
+  const result = { name, path, status, files, sources };
   return result;
 }
+async function readModelSources(folderPath, files) {
+  const out = [];
+  for (const filename of files) {
+    if (filename === "index.ts") continue;
+    if (CONTENT_VALIDATION_SKIP_SUFFIXES.some((suffix) => filename.endsWith(suffix))) continue;
+    const text = await readFile4(join3(folderPath, filename), "utf8");
+    out.push({ filename, text });
+  }
+  return out;
+}
 
 // packages/dbx-components-mcp/src/tools/model-validate-folder/rules.ts
 function runRules3(inspection) {
@@ -14563,8 +14707,26 @@ function runRules3(inspection) {
   }
   checkRequiredFiles(inspection, violations);
   checkStrayFiles(inspection, violations);
+  checkSourceContents(inspection, violations);
   return violations;
 }
+function checkSourceContents(inspection, violations) {
+  const sources = inspection.sources;
+  if (!sources || sources.length === 0) {
+    return;
+  }
+  const validatorSources = sources.map((s) => ({ name: s.filename, text: s.text }));
+  const result = validateFirebaseModelSources(validatorSources);
+  for (const v of result.violations) {
+    pushViolation3(violations, {
+      code: v.code,
+      severity: v.severity,
+      message: v.message,
+      folder: inspection.path,
+      file: v.file
+    });
+  }
+}
 function checkRequiredFiles(inspection, violations) {
   const presentFiles = new Set(inspection.files);
   for (const required of buildRequiredFiles(inspection.name)) {
@@ -14625,6 +14787,8 @@ var DBX_MODEL_VALIDATE_FOLDER_TOOL = {
   description: [
     "Validate that one or more model folders follow the canonical layout. Each folder named `<name>/` must contain `<name>.ts`, `<name>.id.ts`, `<name>.query.ts`, `<name>.action.ts`, `<name>.api.ts`, and `index.ts`. Missing files are hard errors.",
     "",
+    "Also runs every `dbx_model_validate` rule against the contents of each model `.ts` file, so untagged models surface here too \u2014 e.g. `MODEL_IDENTITY_NOT_TAGGED` when `firestoreModelIdentity(...)` is declared without a matching `@dbxModel` interface. Sub-files (`<name>.id.ts`, `.query.ts`, `.action.ts`, `.api.ts`, `*.spec.ts`, `index.ts`) are skipped \u2014 they never declare `firestoreModelIdentity` calls.",
+    "",
     "Warnings cover: stray `.ts` files at the folder root that do not start with `<name>.` (they should be grouped under the model prefix), and reserved folder names (`system/`, `notification/`, `storagefile/`) that have dedicated validators and are skipped here.",
     "",
     "Provide at least one of:",
@@ -15611,13 +15775,13 @@ function collectIdentityImports(sourceFile) {
 }
 
 // packages/dbx-components-mcp/src/tools/model-fixture-shared/inspect.ts
-import { readFile as readFile4 } from "node:fs/promises";
-import { join as join3 } from "node:path";
+import { readFile as readFile5 } from "node:fs/promises";
+import { join as join4 } from "node:path";
 var FIXTURE_RELATIVE_PATH = "src/test/fixture.ts";
 async function inspectAppFixtures(apiAbs, apiRel) {
-  const absolutePath = join3(apiAbs, FIXTURE_RELATIVE_PATH);
+  const absolutePath = join4(apiAbs, FIXTURE_RELATIVE_PATH);
   const relativePath = `${apiRel}/${FIXTURE_RELATIVE_PATH}`;
-  const text = await readFile4(absolutePath, "utf8");
+  const text = await readFile5(absolutePath, "utf8");
   return extractAppFixturesFromText({ text, fixturePath: relativePath });
 }
 
@@ -16464,7 +16628,7 @@ var TOOL3 = {
   }
 };
 function createModelFixtureValidateAppTool(config = {}) {
-  async function run10(rawArgs) {
+  async function run12(rawArgs) {
     const parsed = ValidateArgsType(rawArgs);
     if (parsed instanceof type34.errors) {
       return toolError(`Invalid arguments: ${parsed.summary}`);
@@ -16491,12 +16655,12 @@ function createModelFixtureValidateAppTool(config = {}) {
     };
     return toolResult;
   }
-  return { definition: TOOL3, run: run10 };
+  return { definition: TOOL3, run: run12 };
 }
 
 // packages/dbx-components-mcp/src/tools/model-fixture-scaffold.tool.ts
-import { readFile as readFile5, writeFile } from "node:fs/promises";
-import { join as join4, resolve as resolve20 } from "node:path";
+import { readFile as readFile6, writeFile } from "node:fs/promises";
+import { join as join5, resolve as resolve20 } from "node:path";
 import { type as type35 } from "arktype";
 var ScaffoldArgsType3 = type35({
   apiDir: "string",
@@ -16614,10 +16778,10 @@ async function run3(rawArgs) {
   if (conflicts.length > 0) {
     return toolError(["Refusing to scaffold \u2014 the following names already exist in `" + extraction.fixturePath + "`:", "", ...conflicts.map((c) => "- `" + c + "`"), "", "Rename, delete, or pick a different model name and retry."].join("\n"));
   }
-  const absolutePath = join4(apiAbs, FIXTURE_RELATIVE_PATH);
+  const absolutePath = join5(apiAbs, FIXTURE_RELATIVE_PATH);
   let original;
   try {
-    original = await readFile5(absolutePath, "utf8");
+    original = await readFile6(absolutePath, "utf8");
   } catch (err) {
     return toolError(`Failed to read fixture file: ${err instanceof Error ? err.message : String(err)}`);
   }
@@ -16666,7 +16830,7 @@ function collectConflicts(extraction, rendered) {
 var modelFixtureScaffoldTool = { definition: TOOL4, run: run3 };
 
 // packages/dbx-components-mcp/src/tools/model-fixture-forward.tool.ts
-import { join as join5, resolve as resolve21 } from "node:path";
+import { join as join6, resolve as resolve21 } from "node:path";
 import { type as type36 } from "arktype";
 import { Project as Project8 } from "ts-morph";
 var ForwardArgsType = type36({
@@ -16680,110 +16844,1007 @@ var TOOL5 = {
   inputSchema: {
     type: "object",
     properties: {
-      apiDir: { type: "string", description: "Relative path to the API app." },
-      model: { type: "string", description: "Bare model name (e.g. `StorageFile`)." },
-      methods: {
-        type: "array",
-        items: { type: "string" },
-        description: "Optional whitelist of instance method names to forward."
-      }
+      apiDir: { type: "string", description: "Relative path to the API app." },
+      model: { type: "string", description: "Bare model name (e.g. `StorageFile`)." },
+      methods: {
+        type: "array",
+        items: { type: "string" },
+        description: "Optional whitelist of instance method names to forward."
+      }
+    },
+    required: ["apiDir", "model"]
+  }
+};
+async function run4(rawArgs) {
+  const parsed = ForwardArgsType(rawArgs);
+  if (parsed instanceof type36.errors) {
+    return toolError(`Invalid arguments: ${parsed.summary}`);
+  }
+  const cwd = process.cwd();
+  try {
+    ensurePathInsideCwd(parsed.apiDir, cwd);
+  } catch (err) {
+    return toolError(toErrorMessage(err));
+  }
+  const apiAbs = resolve21(cwd, parsed.apiDir);
+  let extraction;
+  try {
+    extraction = await inspectAppFixtures(apiAbs, parsed.apiDir);
+  } catch (err) {
+    return toolError(`Failed to read fixture file: ${toErrorMessage(err)}`);
+  }
+  const entry = extraction.entries.find((e) => e.model === parsed.model);
+  if (!entry) {
+    const known = extraction.entries.map((e) => e.model).join(", ") || "(none)";
+    return toolError(`Model \`${parsed.model}\` not found in \`${extraction.fixturePath}\`. Known: ${known}.`);
+  }
+  const rendered = renderForwarders({ entry, methods: parsed.methods });
+  if (rendered.added.length === 0) {
+    return { content: [{ type: "text", text: renderNoOpReport(extraction.fixturePath, entry.fixtureClassName, rendered) }] };
+  }
+  const absolutePath = join6(apiAbs, FIXTURE_RELATIVE_PATH);
+  const writeError = await applyForwardersToFile(absolutePath, entry.fixtureClassName, rendered);
+  if (writeError) {
+    return toolError(writeError);
+  }
+  return { content: [{ type: "text", text: renderSuccessReport(extraction.fixturePath, entry.fixtureClassName, rendered) }] };
+}
+function toErrorMessage(err) {
+  return err instanceof Error ? err.message : String(err);
+}
+async function applyForwardersToFile(absolutePath, fixtureClassName, rendered) {
+  const project = new Project8({ skipAddingFilesFromTsConfig: true });
+  let sourceFile;
+  try {
+    sourceFile = project.addSourceFileAtPath(absolutePath);
+  } catch (err) {
+    return `Failed to load fixture file: ${toErrorMessage(err)}`;
+  }
+  const fixtureClass = sourceFile.getClass(fixtureClassName);
+  if (!fixtureClass) {
+    return `Could not locate class \`${fixtureClassName}\` for in-place edit. The fixture file may have been modified since parsing.`;
+  }
+  for (const forwarder of rendered.added) {
+    fixtureClass.insertText(fixtureClass.getEnd() - 1, "\n" + forwarder.source + "\n");
+  }
+  sourceFile.formatText({ ensureNewLineAtEndOfFile: true });
+  try {
+    await sourceFile.save();
+  } catch (err) {
+    return `Failed to write fixture file: ${toErrorMessage(err)}`;
+  }
+  return void 0;
+}
+function renderNoOpReport(fixturePath, fixtureClassName, rendered) {
+  const lines = [`# No forwarders to add for \`${fixtureClassName}\``, "", `File: \`${fixturePath}\``];
+  appendListSection(lines, "## Already forwarded", rendered.skippedAlreadyForwarded);
+  appendListSection(lines, "## Whitelisted methods missing from Instance", rendered.missingFromInstance);
+  return lines.join("\n");
+}
+function renderSuccessReport(fixturePath, fixtureClassName, rendered) {
+  const lines = [`# Forwarded ${rendered.added.length} method${rendered.added.length === 1 ? "" : "s"} to \`${fixtureClassName}\``, "", `File: \`${fixturePath}\``, "", "## Added"];
+  for (const f of rendered.added) {
+    lines.push(`- \`${f.method}\``);
+  }
+  appendListSection(lines, "## Skipped (already forwarded)", rendered.skippedAlreadyForwarded);
+  appendListSection(lines, "## Whitelisted methods missing from Instance", rendered.missingFromInstance);
+  return lines.join("\n");
+}
+function appendListSection(lines, heading, names) {
+  if (names.length === 0) return;
+  lines.push("", heading);
+  for (const name of names) {
+    lines.push(`- \`${name}\``);
+  }
+}
+var modelFixtureForwardTool = { definition: TOOL5, run: run4 };
+
+// packages/dbx-components-mcp/src/tools/model-test-tree.tool.ts
+import { resolve as resolve22 } from "node:path";
+import { type as type37 } from "arktype";
+
+// packages/dbx-components-mcp/src/tools/model-test-shared/extract.ts
+import { Node as Node12, Project as Project9, SyntaxKind as SyntaxKind7 } from "ts-morph";
+var SPEC_FILE_VIRTUAL_PATH = "__spec__/spec.ts";
+var FIXTURE_CONTEXT_SUFFIX = "Context";
+var FIXTURE_FACTORY_SUFFIX = "ContextFactory";
+var HOOK_NAMES = /* @__PURE__ */ new Set(["beforeEach", "beforeAll", "afterEach", "afterAll"]);
+var DESCRIBE_NAMES = /* @__PURE__ */ new Set(["describe", "xdescribe", "fdescribe"]);
+var IT_NAMES = /* @__PURE__ */ new Set(["it", "xit", "fit", "test"]);
+function extractSpecTreeFromText(input) {
+  const { text, specPath } = input;
+  const project = new Project9({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const sourceFile = project.createSourceFile(SPEC_FILE_VIRTUAL_PATH, text, { overwrite: true });
+  const { prefix, prefixSource, knownFixtureNames } = resolvePrefixAndFixtures(sourceFile, input);
+  const helpers = collectHelpers(sourceFile);
+  const helperNames = new Set(helpers.map((h) => h.name));
+  const counts = { describe: 0, it: 0, fixture: 0 };
+  const rootChildren = [];
+  for (const stmt of sourceFile.getStatements()) {
+    if (!Node12.isExpressionStatement(stmt)) continue;
+    const expr = stmt.getExpression();
+    if (!Node12.isCallExpression(expr)) continue;
+    const node = walkCall(expr, { prefix, knownFixtureNames, helperNames, counts });
+    if (node !== void 0) {
+      rootChildren.push(node);
+    }
+  }
+  const lastLine = sourceFile.getEndLineNumber();
+  const root = {
+    kind: "wrapper",
+    callee: specPath,
+    line: 1,
+    endLine: lastLine,
+    children: rootChildren
+  };
+  const result = {
+    specPath,
+    prefix,
+    prefixSource,
+    knownFixtureNames,
+    root,
+    helpers,
+    fixtureCallsCount: counts.fixture,
+    itCount: counts.it,
+    describeCount: counts.describe
+  };
+  return result;
+}
+function resolvePrefixAndFixtures(sourceFile, input) {
+  const supplied = input.knownFixtureNames ?? [];
+  if (input.prefix !== void 0 && input.prefix !== "" && supplied.length > 0) {
+    const result2 = {
+      prefix: input.prefix,
+      prefixSource: "apiDir",
+      knownFixtureNames: dedupedSorted(supplied)
+    };
+    return result2;
+  }
+  const imported = collectFixtureImports(sourceFile);
+  if (imported.length > 0) {
+    const detectedPrefix = detectPrefixFromImports(imported);
+    const result2 = {
+      prefix: detectedPrefix,
+      prefixSource: "imports",
+      knownFixtureNames: dedupedSorted(imported)
+    };
+    return result2;
+  }
+  const result = { prefix: void 0, prefixSource: "unknown", knownFixtureNames: [] };
+  return result;
+}
+function collectFixtureImports(sourceFile) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const decl of sourceFile.getImportDeclarations()) {
+    const spec = decl.getModuleSpecifierValue();
+    if (!matchesFixtureModulePath(spec)) continue;
+    for (const named of decl.getNamedImports()) {
+      const name = named.getName();
+      if (!name.endsWith(FIXTURE_CONTEXT_SUFFIX)) continue;
+      if (name.endsWith(FIXTURE_FACTORY_SUFFIX)) continue;
+      if (!/^[a-z]/.test(name)) continue;
+      seen.add(name);
+    }
+  }
+  return [...seen];
+}
+function matchesFixtureModulePath(spec) {
+  return /(^|\/)test\/fixture(\.[a-z]+)?$/.test(spec);
+}
+function detectPrefixFromImports(names) {
+  if (names.length === 0) return void 0;
+  const stems = names.map((n) => n.slice(0, n.length - FIXTURE_CONTEXT_SUFFIX.length));
+  let common = stems[0];
+  for (let i = 1; i < stems.length; i++) {
+    common = sharedPrefix(common, stems[i]);
+    if (common.length === 0) return void 0;
+  }
+  const camelEnd = trimToCamelBoundary(common);
+  if (camelEnd.length === 0) return void 0;
+  return camelEnd.charAt(0).toUpperCase() + camelEnd.slice(1);
+}
+function sharedPrefix(a, b) {
+  const max = Math.min(a.length, b.length);
+  let i = 0;
+  while (i < max && a.charAt(i) === b.charAt(i)) i++;
+  return a.slice(0, i);
+}
+function trimToCamelBoundary(s) {
+  for (let i = s.length - 1; i >= 0; i--) {
+    if (/[A-Z]/.test(s.charAt(i))) {
+      return s.slice(0, i);
+    }
+  }
+  return s;
+}
+function dedupedSorted(names) {
+  return [...new Set(names)].sort();
+}
+function walkCall(call, ctx) {
+  const calleeName = getCalleeName(call);
+  if (calleeName === void 0) return void 0;
+  const line = call.getStartLineNumber();
+  const endLine = call.getEndLineNumber();
+  if (DESCRIBE_NAMES.has(calleeName)) {
+    ctx.counts.describe += 1;
+    return describeOrItNode("describe", call, calleeName, line, endLine, ctx);
+  }
+  if (IT_NAMES.has(calleeName)) {
+    ctx.counts.it += 1;
+    return describeOrItNode("it", call, calleeName, line, endLine, ctx);
+  }
+  if (HOOK_NAMES.has(calleeName)) {
+    return hookNode(call, calleeName, line, endLine);
+  }
+  if (isKnownFixtureName(calleeName, ctx)) {
+    ctx.counts.fixture += 1;
+    return fixtureNode(call, calleeName, ctx, line, endLine);
+  }
+  if (ctx.helperNames.has(calleeName)) {
+    return helperCallNode(call, calleeName, ctx, line, endLine);
+  }
+  const callback = findCallback(call);
+  if (callback === void 0) return void 0;
+  const wrapperChildren = walkCallbackBody(callback, ctx);
+  const wrapper = { kind: "wrapper", callee: calleeName, line, endLine, children: wrapperChildren };
+  return wrapper;
+}
+function isKnownFixtureName(name, ctx) {
+  if (ctx.knownFixtureNames.length > 0) {
+    return ctx.knownFixtureNames.includes(name);
+  }
+  if (!name.endsWith(FIXTURE_CONTEXT_SUFFIX)) return false;
+  if (name.endsWith(FIXTURE_FACTORY_SUFFIX)) return false;
+  if (!/^[a-z]/.test(name)) return false;
+  if (ctx.prefix !== void 0) {
+    const lowerPrefix = ctx.prefix.charAt(0).toLowerCase() + ctx.prefix.slice(1);
+    if (!name.startsWith(lowerPrefix)) return false;
+  }
+  return true;
+}
+function describeOrItNode(kind, call, calleeName, line, endLine, ctx) {
+  const args = call.getArguments();
+  const titleArg = args[0];
+  const titleInfo = readTitle(titleArg);
+  const callback = findCallback(call);
+  const children = kind === "describe" && callback !== void 0 ? walkCallbackBody(callback, ctx) : [];
+  const node = {
+    kind,
+    title: titleInfo.title,
+    titleIsTemplate: titleInfo.titleIsTemplate || void 0,
+    callee: calleeName === kind ? void 0 : calleeName,
+    line,
+    endLine,
+    children
+  };
+  return node;
+}
+function hookNode(_call, calleeName, line, endLine) {
+  const node = { kind: "hook", title: calleeName, line, endLine, children: [] };
+  return node;
+}
+function fixtureNode(call, calleeName, ctx, line, endLine) {
+  const args = call.getArguments();
+  const argsObject = args[0];
+  const parentVars = Node12.isObjectLiteralExpression(argsObject) ? readParentVars(argsObject) : [];
+  const callback = findCallback(call);
+  const varName = callback !== void 0 ? readCallbackVarName(callback) : void 0;
+  const model = stripFixturePrefix(calleeName, ctx.prefix);
+  const children = callback !== void 0 ? walkCallbackBody(callback, ctx) : [];
+  const node = {
+    kind: "fixture",
+    callee: calleeName,
+    model,
+    varName,
+    parentVars: parentVars.length > 0 ? parentVars : void 0,
+    line,
+    endLine,
+    children
+  };
+  return node;
+}
+function helperCallNode(call, calleeName, ctx, line, endLine) {
+  const callback = findCallback(call);
+  const children = callback !== void 0 ? walkCallbackBody(callback, ctx) : [];
+  const node = { kind: "helperCall", callee: calleeName, line, endLine, children };
+  return node;
+}
+function stripFixturePrefix(name, prefix) {
+  if (!name.endsWith(FIXTURE_CONTEXT_SUFFIX)) return void 0;
+  const stem = name.slice(0, name.length - FIXTURE_CONTEXT_SUFFIX.length);
+  if (prefix === void 0 || prefix === "") {
+    if (stem.length === 0) return void 0;
+    return stem.charAt(0).toUpperCase() + stem.slice(1);
+  }
+  const lower = prefix.charAt(0).toLowerCase() + prefix.slice(1);
+  if (!stem.startsWith(lower)) return void 0;
+  const model = stem.slice(lower.length);
+  return model.length > 0 ? model : void 0;
+}
+function readTitle(arg) {
+  if (arg === void 0) return { title: void 0, titleIsTemplate: false };
+  if (Node12.isStringLiteral(arg) || Node12.isNoSubstitutionTemplateLiteral(arg)) {
+    const result2 = { title: arg.getLiteralText(), titleIsTemplate: false };
+    return result2;
+  }
+  if (Node12.isTemplateExpression(arg)) {
+    const result2 = { title: arg.getText(), titleIsTemplate: true };
+    return result2;
+  }
+  const result = { title: arg.getText(), titleIsTemplate: true };
+  return result;
+}
+function findCallback(call) {
+  const args = call.getArguments();
+  for (let i = args.length - 1; i >= 0; i--) {
+    const a = args[i];
+    if (Node12.isArrowFunction(a) || Node12.isFunctionExpression(a)) {
+      return a;
+    }
+  }
+  return void 0;
+}
+function readCallbackVarName(callback) {
+  const params = callback.getParameters();
+  if (params.length === 0) return void 0;
+  const first = params[0];
+  const nameNode = first.getNameNode();
+  if (Node12.isIdentifier(nameNode)) {
+    return nameNode.getText();
+  }
+  return void 0;
+}
+function readParentVars(obj) {
+  const out = [];
+  for (const prop of obj.getProperties()) {
+    if (Node12.isShorthandPropertyAssignment(prop)) {
+      out.push(prop.getName());
+      continue;
+    }
+    if (Node12.isPropertyAssignment(prop)) {
+      const init = prop.getInitializer();
+      if (init !== void 0 && Node12.isIdentifier(init)) {
+        out.push(init.getText());
+      }
+    }
+  }
+  return out;
+}
+function walkCallbackBody(callback, ctx) {
+  const body = callback.getBody();
+  if (Node12.isBlock(body)) {
+    return walkBlock(body, ctx);
+  }
+  if (Node12.isCallExpression(body)) {
+    const child = walkCall(body, ctx);
+    return child === void 0 ? [] : [child];
+  }
+  return [];
+}
+function walkBlock(block, ctx) {
+  const children = [];
+  for (const stmt of block.getStatements()) {
+    if (!Node12.isExpressionStatement(stmt)) continue;
+    const expr = stmt.getExpression();
+    if (!Node12.isCallExpression(expr)) continue;
+    const child = walkCall(expr, ctx);
+    if (child !== void 0) {
+      children.push(child);
+    }
+  }
+  return children;
+}
+function getCalleeName(call) {
+  const expr = call.getExpression();
+  if (Node12.isIdentifier(expr)) return expr.getText();
+  return void 0;
+}
+function collectHelpers(sourceFile) {
+  const out = [];
+  for (const fn of sourceFile.getFunctions()) {
+    const name = fn.getName();
+    if (name === void 0) continue;
+    const usage = scanForDescribeOrIt(fn);
+    if (!usage.emitsDescribe && !usage.emitsIt) continue;
+    out.push({ name, line: fn.getStartLineNumber(), endLine: fn.getEndLineNumber(), emitsDescribe: usage.emitsDescribe, emitsIt: usage.emitsIt });
+  }
+  for (const v of sourceFile.getVariableStatements()) {
+    for (const decl of v.getDeclarations()) {
+      const init = decl.getInitializer();
+      if (init === void 0) continue;
+      if (!Node12.isArrowFunction(init) && !Node12.isFunctionExpression(init)) continue;
+      const usage = scanForDescribeOrIt(init);
+      if (!usage.emitsDescribe && !usage.emitsIt) continue;
+      out.push({ name: decl.getName(), line: decl.getStartLineNumber(), endLine: decl.getEndLineNumber(), emitsDescribe: usage.emitsDescribe, emitsIt: usage.emitsIt });
+    }
+  }
+  return out;
+}
+function scanForDescribeOrIt(node) {
+  const usage = { emitsDescribe: false, emitsIt: false };
+  node.forEachDescendant((descendant) => {
+    if (descendant.getKind() !== SyntaxKind7.CallExpression) return;
+    const call = descendant;
+    const expr = call.getExpression();
+    if (!Node12.isIdentifier(expr)) return;
+    const name = expr.getText();
+    if (DESCRIBE_NAMES.has(name)) usage.emitsDescribe = true;
+    if (IT_NAMES.has(name)) usage.emitsIt = true;
+  });
+  return usage;
+}
+
+// packages/dbx-components-mcp/src/tools/model-test-shared/inspect.ts
+import { readFile as readFile7 } from "node:fs/promises";
+async function inspectSpecFile(config) {
+  const { specAbs, specRel, apiAbs, apiRel } = config;
+  const text = await readFile7(specAbs, "utf8");
+  let prefix;
+  let knownFixtureNames;
+  if (apiAbs !== void 0 && apiRel !== void 0) {
+    try {
+      const fixtures = await inspectAppFixtures(apiAbs, apiRel);
+      prefix = fixtures.prefix;
+      const lowerPrefix = prefix !== void 0 ? prefix.charAt(0).toLowerCase() + prefix.slice(1) : "";
+      knownFixtureNames = fixtures.entries.map((entry) => `${lowerPrefix}${entry.model}Context`);
+    } catch {
+    }
+  }
+  return extractSpecTreeFromText({ text, specPath: specRel, prefix, knownFixtureNames });
+}
+
+// packages/dbx-components-mcp/src/tools/model-test-shared/search.ts
+function searchSpecTree(tree, query) {
+  const hits = [];
+  const describeStack = [];
+  const fixtureStack = [];
+  const visit = (node) => {
+    matchNode(node, query, describeStack, fixtureStack, hits);
+    let pushedDescribe = false;
+    let pushedFixture = false;
+    if (node.kind === "describe" && node.title !== void 0) {
+      describeStack.push(node.title);
+      pushedDescribe = true;
+    }
+    if (node.kind === "fixture" && node.model !== void 0) {
+      fixtureStack.push(node.model);
+      pushedFixture = true;
+    }
+    for (const child of node.children) {
+      visit(child);
+    }
+    if (pushedDescribe) describeStack.pop();
+    if (pushedFixture) fixtureStack.pop();
+  };
+  for (const child of tree.root.children) {
+    visit(child);
+  }
+  const result = { query, hits };
+  return result;
+}
+function matchNode(node, query, describeStack, fixtureStack, hits) {
+  let matched = false;
+  switch (query.mode) {
+    case "model":
+      matched = node.kind === "fixture" && node.model?.toLowerCase() === query.value.toLowerCase();
+      break;
+    case "chain":
+      matched = node.kind === "fixture" && chainContainsSequence([...fixtureStack, node.model ?? ""], parseChainQuery(query.value));
+      break;
+    case "describe":
+      matched = node.kind === "describe" && node.title !== void 0 && node.title.toLowerCase().includes(query.value.toLowerCase());
+      break;
+    case "it":
+      matched = node.kind === "it" && node.title !== void 0 && node.title.toLowerCase().includes(query.value.toLowerCase());
+      break;
+    default: {
+      const exhaustive = query;
+      void exhaustive;
+    }
+  }
+  if (!matched) return;
+  const hit = {
+    kind: node.kind,
+    title: node.title,
+    model: node.model,
+    callee: node.callee,
+    line: node.line,
+    endLine: node.endLine,
+    describePath: [...describeStack],
+    fixtureChain: [...fixtureStack]
+  };
+  hits.push(hit);
+}
+function parseChainQuery(value) {
+  return value.split(">").map((s) => s.trim()).filter((s) => s.length > 0).map((s) => s.toLowerCase());
+}
+function chainContainsSequence(chain, sequence) {
+  if (sequence.length === 0) return true;
+  if (sequence.length > chain.length) return false;
+  const lowerChain = chain.map((s) => s.toLowerCase());
+  outer: for (let i = 0; i <= lowerChain.length - sequence.length; i++) {
+    for (const [j, element] of sequence.entries()) {
+      if (lowerChain[i + j] !== element) continue outer;
+    }
+    return true;
+  }
+  return false;
+}
+
+// packages/dbx-components-mcp/src/tools/model-test-shared/format.json.ts
+function formatTreeAsJson(tree, view = "all", filters = {}) {
+  if (view === "helpers") {
+    const result2 = { specPath: tree.specPath, prefix: tree.prefix, prefixSource: tree.prefixSource, helpers: tree.helpers };
+    return JSON.stringify(result2, null, 2);
+  }
+  if (view === "its") {
+    const its = collectIts(tree);
+    const result2 = { specPath: tree.specPath, prefix: tree.prefix, prefixSource: tree.prefixSource, its };
+    return JSON.stringify(result2, null, 2);
+  }
+  const filteredRoot = applyFilters(tree.root, view, filters);
+  const result = { specPath: tree.specPath, prefix: tree.prefix, prefixSource: tree.prefixSource, knownFixtureNames: tree.knownFixtureNames, view, filters, counts: { describes: tree.describeCount, its: tree.itCount, fixtures: tree.fixtureCallsCount, helpers: tree.helpers.length }, root: filteredRoot };
+  return JSON.stringify(result, null, 2);
+}
+function formatSearchAsJson(tree, result) {
+  const payload = { specPath: tree.specPath, prefix: tree.prefix, prefixSource: tree.prefixSource, query: result.query, hits: result.hits };
+  return JSON.stringify(payload, null, 2);
+}
+function collectIts(tree) {
+  const out = [];
+  const stack = [];
+  const visit = (node) => {
+    if (node.kind === "it") {
+      const entry = { describePath: [...stack], title: node.title, titleIsTemplate: node.titleIsTemplate, line: node.line, endLine: node.endLine };
+      out.push(entry);
+    }
+    let pushed = false;
+    if (node.kind === "describe" && node.title !== void 0) {
+      stack.push(node.title);
+      pushed = true;
+    }
+    for (const child of node.children) visit(child);
+    if (pushed) stack.pop();
+  };
+  for (const c of tree.root.children) visit(c);
+  return out;
+}
+function applyFilters(root, view, filters) {
+  let next = view === "describes" ? collapseTo(root, ["describe", "it", "hook", "helperCall"]) : view === "fixtures" ? collapseTo(root, ["fixture"]) : root;
+  if (filters.filterByModel !== void 0 && filters.filterByModel !== "") {
+    next = pruneByModel(next, filters.filterByModel.toLowerCase()) ?? { ...next, children: [] };
+  }
+  if (filters.filterByDescribePath !== void 0 && filters.filterByDescribePath !== "") {
+    next = pruneByDescribePath(next, parseDescribePath(filters.filterByDescribePath)) ?? { ...next, children: [] };
+  }
+  return next;
+}
+function collapseTo(node, keep) {
+  const collapsedChildren = [];
+  for (const child of node.children) {
+    const transformed = collapseTo(child, keep);
+    if (keep.includes(child.kind)) {
+      collapsedChildren.push(transformed);
+    } else {
+      collapsedChildren.push(...transformed.children);
+    }
+  }
+  return { ...node, children: collapsedChildren };
+}
+function pruneByModel(node, model) {
+  const matchedSelf = node.kind === "fixture" && node.model?.toLowerCase() === model;
+  const prunedChildren = [];
+  for (const child of node.children) {
+    const result = pruneByModel(child, model);
+    if (result !== void 0) prunedChildren.push(result);
+  }
+  if (matchedSelf || prunedChildren.length > 0) {
+    return { ...node, children: prunedChildren };
+  }
+  return void 0;
+}
+function pruneByDescribePath(node, path) {
+  if (path.length === 0) return node;
+  const matched = [];
+  collectDescribesMatching(node, path, [], matched);
+  if (matched.length === 0) return void 0;
+  return { ...node, children: matched };
+}
+function collectDescribesMatching(node, target, stack, out) {
+  if (node.kind === "describe" && node.title !== void 0) {
+    stack.push(node.title.toLowerCase());
+    if (pathStartsWith(stack, target)) {
+      out.push(node);
+      stack.pop();
+      return;
+    }
+  }
+  for (const child of node.children) collectDescribesMatching(child, target, stack, out);
+  if (node.kind === "describe" && node.title !== void 0) stack.pop();
+}
+function pathStartsWith(actual, expected) {
+  if (expected.length > actual.length) return false;
+  for (const [i, element] of expected.entries()) {
+    if (!actual[i].includes(element)) return false;
+  }
+  return true;
+}
+function parseDescribePath(value) {
+  return value.split(">").map((s) => s.trim().toLowerCase()).filter((s) => s.length > 0);
+}
+
+// packages/dbx-components-mcp/src/tools/model-test-shared/format.markdown.ts
+var INDENT = "  ";
+function formatTreeAsMarkdown(tree, view = "all", filters = {}) {
+  const lines = [];
+  appendHeader(lines, tree, view, filters);
+  if (view === "helpers") {
+    appendHelpersSection(lines, tree.helpers);
+    return lines.join("\n");
+  }
+  if (view === "its") {
+    appendItIndex(lines, tree);
+    return lines.join("\n");
+  }
+  const filteredRoot = applyFilters2(tree.root, view, filters);
+  if (filteredRoot.children.length === 0) {
+    lines.push("", "_No matching nodes._");
+    return lines.join("\n");
+  }
+  lines.push("", `## Tree (view: ${view})`);
+  if (filters.filterByModel) lines.push(`Filter \u2014 model: \`${filters.filterByModel}\``);
+  if (filters.filterByDescribePath) lines.push(`Filter \u2014 describePath: \`${filters.filterByDescribePath}\``);
+  lines.push("");
+  for (const child of filteredRoot.children) {
+    appendNode(lines, child, 0);
+  }
+  return lines.join("\n");
+}
+function formatSearchAsMarkdown(tree, result) {
+  const lines = [];
+  lines.push(`# Spec search \u2014 ${tree.specPath}`);
+  lines.push("");
+  lines.push(`Query: \`${result.query.mode}\` = \`${result.query.value}\``);
+  lines.push(`Matches: ${result.hits.length}`);
+  if (result.hits.length === 0) {
+    lines.push("", "_No matches._");
+    return lines.join("\n");
+  }
+  lines.push("");
+  for (const hit of result.hits) {
+    appendHit(lines, hit);
+  }
+  return lines.join("\n");
+}
+function appendHeader(lines, tree, view, filters) {
+  lines.push(`# Spec tree \u2014 ${tree.specPath}`);
+  lines.push("");
+  lines.push(`Detected workspace prefix: \`${tree.prefix ?? "(none)"}\` (source: ${tree.prefixSource})`);
+  lines.push(`Counts: ${tree.describeCount} describes, ${tree.itCount} its, ${tree.fixtureCallsCount} fixture calls, ${tree.helpers.length} helper-describes`);
+  if (view !== "helpers" && view !== "its" && (filters.filterByModel || filters.filterByDescribePath)) {
+    lines.push(`Active filters: ${[filters.filterByModel ? `model=\`${filters.filterByModel}\`` : "", filters.filterByDescribePath ? `describePath=\`${filters.filterByDescribePath}\`` : ""].filter(Boolean).join(", ")}`);
+  }
+}
+function appendHelpersSection(lines, helpers) {
+  lines.push("", `## Helpers (${helpers.length})`);
+  if (helpers.length === 0) {
+    lines.push("", "_No helper-describes detected._");
+    return;
+  }
+  lines.push("");
+  lines.push("| Name | Emits | Lines |");
+  lines.push("|---|---|---|");
+  for (const h of helpers) {
+    const emits = [];
+    if (h.emitsDescribe) emits.push("describe");
+    if (h.emitsIt) emits.push("it");
+    lines.push(`| \`${h.name}\` | ${emits.join(", ")} | ${h.line}\u2013${h.endLine} |`);
+  }
+}
+function appendItIndex(lines, tree) {
+  const its = [];
+  const stack = [];
+  const collect = (node) => {
+    if (node.kind === "it") {
+      its.push({ describePath: [...stack], node });
+    }
+    let pushed = false;
+    if (node.kind === "describe" && node.title !== void 0) {
+      stack.push(node.title);
+      pushed = true;
+    }
+    for (const child of node.children) collect(child);
+    if (pushed) stack.pop();
+  };
+  for (const c of tree.root.children) collect(c);
+  lines.push("", `## Tests (${its.length})`);
+  if (its.length === 0) {
+    lines.push("", "_No `it` calls detected._");
+    return;
+  }
+  lines.push("");
+  for (const { describePath, node } of its) {
+    const path = describePath.length > 0 ? `${describePath.join(" > ")} > ` : "";
+    const title = node.title !== void 0 ? node.titleIsTemplate ? `\`${node.title}\` _(template)_` : `\`${node.title}\`` : "_(no title)_";
+    lines.push(`- ${path}${title} [L${node.line}]`);
+  }
+}
+function appendHit(lines, hit) {
+  const label = hitLabel(hit);
+  lines.push(`- ${label} [L${hit.line}\u2013${hit.endLine}]`);
+  if (hit.describePath.length > 0) {
+    lines.push(`${INDENT}describes: ${hit.describePath.map((s) => `\`${s}\``).join(" > ")}`);
+  }
+  if (hit.fixtureChain.length > 0) {
+    lines.push(`${INDENT}fixtures: ${hit.fixtureChain.map((s) => `\`${s}\``).join(" > ")}`);
+  }
+}
+function hitLabel(hit) {
+  switch (hit.kind) {
+    case "fixture":
+      return `**fixture** \`${hit.callee ?? "?"}\` \u2192 \`${hit.model ?? "?"}\``;
+    case "describe":
+      return `**describe** \`${hit.title ?? "?"}\``;
+    case "it":
+      return `**it** \`${hit.title ?? "?"}\``;
+    case "helperCall":
+      return `**helperCall** \`${hit.callee ?? "?"}\``;
+    case "wrapper":
+      return `**wrapper** \`${hit.callee ?? "?"}\``;
+    case "hook":
+      return `**${hit.title ?? "hook"}**`;
+    default:
+      return "**?**";
+  }
+}
+function appendNode(lines, node, depth) {
+  const indent = INDENT.repeat(depth);
+  lines.push(`${indent}- ${nodeLabel(node)} [L${node.line}\u2013${node.endLine}]`);
+  for (const child of node.children) {
+    appendNode(lines, child, depth + 1);
+  }
+}
+function nodeLabel(node) {
+  switch (node.kind) {
+    case "describe":
+      return `**describe** ${node.title === void 0 ? "_(no title)_" : node.titleIsTemplate ? `\`${node.title}\` _(template)_` : `\`${node.title}\``}`;
+    case "it":
+      return `**it** ${node.title === void 0 ? "_(no title)_" : node.titleIsTemplate ? `\`${node.title}\` _(template)_` : `\`${node.title}\``}`;
+    case "hook":
+      return `**${node.title ?? "hook"}**`;
+    case "fixture": {
+      const var_ = node.varName !== void 0 ? ` _(as \`${node.varName}\`)_` : "";
+      const parents = node.parentVars && node.parentVars.length > 0 ? ` deps: \`${node.parentVars.join(", ")}\`` : "";
+      return `**fixture** \`${node.callee ?? "?"}\` \u2192 \`${node.model ?? "?"}\`${var_}${parents}`;
+    }
+    case "wrapper":
+      return `**wrapper** \`${node.callee ?? "?"}\``;
+    case "helperCall":
+      return `**helperCall** \`${node.callee ?? "?"}\``;
+    default:
+      return "**?**";
+  }
+}
+function applyFilters2(root, view, filters) {
+  let next = view === "describes" ? collapseTo2(root, ["describe", "it", "hook", "helperCall"]) : view === "fixtures" ? collapseTo2(root, ["fixture"]) : root;
+  if (filters.filterByModel !== void 0 && filters.filterByModel !== "") {
+    next = pruneByModel2(next, filters.filterByModel.toLowerCase()) ?? { ...next, children: [] };
+  }
+  if (filters.filterByDescribePath !== void 0 && filters.filterByDescribePath !== "") {
+    next = pruneByDescribePath2(next, parseDescribePath2(filters.filterByDescribePath)) ?? { ...next, children: [] };
+  }
+  return next;
+}
+function collapseTo2(node, keep) {
+  const collapsedChildren = [];
+  for (const child of node.children) {
+    const transformed = collapseTo2(child, keep);
+    if (keep.includes(child.kind)) {
+      collapsedChildren.push(transformed);
+    } else {
+      collapsedChildren.push(...transformed.children);
+    }
+  }
+  return { ...node, children: collapsedChildren };
+}
+function pruneByModel2(node, model) {
+  const matchedSelf = node.kind === "fixture" && node.model?.toLowerCase() === model;
+  const prunedChildren = [];
+  for (const child of node.children) {
+    const result = pruneByModel2(child, model);
+    if (result !== void 0) prunedChildren.push(result);
+  }
+  if (matchedSelf || prunedChildren.length > 0) {
+    return { ...node, children: prunedChildren };
+  }
+  return void 0;
+}
+function pruneByDescribePath2(node, path) {
+  if (path.length === 0) return node;
+  const matched = [];
+  collectDescribesMatching2(node, path, [], matched);
+  if (matched.length === 0) return void 0;
+  return { ...node, children: matched };
+}
+function collectDescribesMatching2(node, target, stack, out) {
+  if (node.kind === "describe" && node.title !== void 0) {
+    stack.push(node.title.toLowerCase());
+    if (pathStartsWith2(stack, target)) {
+      out.push(node);
+      stack.pop();
+      return;
+    }
+  }
+  for (const child of node.children) collectDescribesMatching2(child, target, stack, out);
+  if (node.kind === "describe" && node.title !== void 0) stack.pop();
+}
+function pathStartsWith2(actual, expected) {
+  if (expected.length > actual.length) return false;
+  for (const [i, element] of expected.entries()) {
+    if (!actual[i].includes(element)) return false;
+  }
+  return true;
+}
+function parseDescribePath2(value) {
+  return value.split(">").map((s) => s.trim().toLowerCase()).filter((s) => s.length > 0);
+}
+
+// packages/dbx-components-mcp/src/tools/model-test-tree.tool.ts
+var TreeArgsType = type37({
+  specFile: "string",
+  "apiDir?": "string",
+  "view?": "'all' | 'describes' | 'fixtures' | 'its' | 'helpers'",
+  "filterByModel?": "string",
+  "filterByDescribePath?": "string",
+  "format?": "'markdown' | 'json'"
+});
+var TOOL6 = {
+  name: "dbx_model_test_tree",
+  description: [
+    "Parse one API `.spec.ts` file and return its structural skeleton \u2014 nested `describe`/`it` calls, `<prefix><Model>Context(...)` fixture chains, locally-defined helper-describe functions, and the wrapper calls between them. Each node carries its 1-based line range so callers can navigate by line offset instead of grepping.",
+    "",
+    "Provide:",
+    "- `specFile`: relative path to the `.spec.ts` file (e.g. `apps/hellosubs-api/src/app/function/job/job.crud.instruction.spec.ts`).",
+    "- `apiDir` (optional but recommended): relative path to the API app (e.g. `apps/hellosubs-api`). When supplied the tool reuses `inspectAppFixtures()` for the authoritative workspace prefix and the full set of `<prefix><Model>Context` names. When omitted the prefix is detected from the spec's own imports off `**/test/fixture`.",
+    "- `view` (optional): `all` (default), `describes` (drop fixtures + wrappers), `fixtures` (only fixture chains, e.g. `Country > CountryState > Region > District > ...`), `its` (flat index of every `it()` with full describe path), or `helpers` (locally-defined helper-describe functions).",
+    "- `filterByModel` (optional): keep only subtrees that contain a fixture call resolving to this model (e.g. `Job`).",
+    "- `filterByDescribePath` (optional): keep only subtrees rooted at a describe whose `>`-separated path matches (e.g. `admin > job published`).",
+    "- `format` (optional): `markdown` (default) or `json`.",
+    "",
+    "Paths escaping the server cwd are rejected."
+  ].join("\n"),
+  inputSchema: {
+    type: "object",
+    properties: {
+      specFile: { type: "string", description: "Relative path to the `.spec.ts` file." },
+      apiDir: { type: "string", description: "Optional relative path to the API app. Enables authoritative prefix + fixture-name detection via `inspectAppFixtures()`." },
+      view: { type: "string", enum: ["all", "describes", "fixtures", "its", "helpers"], description: "View mode. Defaults to `all`." },
+      filterByModel: { type: "string", description: "Keep only subtrees that contain a fixture call resolving to this model (case-insensitive)." },
+      filterByDescribePath: { type: "string", description: "`>`-separated describe path; keep only subtrees rooted there (case-insensitive substring per segment)." },
+      format: { type: "string", enum: ["markdown", "json"], description: "Output format. Defaults to markdown." }
+    },
+    required: ["specFile"]
+  }
+};
+async function run5(rawArgs) {
+  const parsed = TreeArgsType(rawArgs);
+  if (parsed instanceof type37.errors) {
+    return toolError(`Invalid arguments: ${parsed.summary}`);
+  }
+  const cwd = process.cwd();
+  try {
+    ensurePathInsideCwd(parsed.specFile, cwd);
+    if (parsed.apiDir !== void 0) ensurePathInsideCwd(parsed.apiDir, cwd);
+  } catch (err) {
+    return toolError(err instanceof Error ? err.message : String(err));
+  }
+  const specAbs = resolve22(cwd, parsed.specFile);
+  const apiAbs = parsed.apiDir !== void 0 ? resolve22(cwd, parsed.apiDir) : void 0;
+  let tree;
+  try {
+    tree = await inspectSpecFile({ specAbs, specRel: parsed.specFile, apiAbs, apiRel: parsed.apiDir });
+  } catch (err) {
+    return toolError(`Failed to read spec file: ${err instanceof Error ? err.message : String(err)}`);
+  }
+  const view = parsed.view ?? "all";
+  const filters = { filterByModel: parsed.filterByModel, filterByDescribePath: parsed.filterByDescribePath };
+  const text = parsed.format === "json" ? formatTreeAsJson(tree, view, filters) : formatTreeAsMarkdown(tree, view, filters);
+  const result = { content: [{ type: "text", text }] };
+  return result;
+}
+var modelTestTreeTool = { definition: TOOL6, run: run5 };
+
+// packages/dbx-components-mcp/src/tools/model-test-search.tool.ts
+import { resolve as resolve23 } from "node:path";
+import { type as type38 } from "arktype";
+var SearchArgsType2 = type38({
+  specFile: "string",
+  "apiDir?": "string",
+  "model?": "string",
+  "chain?": "string",
+  "describe?": "string",
+  "it?": "string",
+  "format?": "'markdown' | 'json'"
+});
+var TOOL7 = {
+  name: "dbx_model_test_search",
+  description: [
+    "Search one API `.spec.ts` file for `describe`s, `it`s, or `<prefix><Model>Context(...)` fixture calls matching a single criterion. Each hit is returned with the full describe path and fixture chain leading to it, plus its line range, so callers can jump straight to the right block.",
+    "",
+    "Provide exactly one of:",
+    "- `model`: bare PascalCase model name (e.g. `Job`) \u2014 matches every `<prefix>JobContext(...)` site.",
+    "- `chain`: `>`-separated model sequence (e.g. `Country > CountryState`) \u2014 matches every fixture chain containing the consecutive subsequence.",
+    "- `describe`: case-insensitive substring against `describe(...)` titles.",
+    "- `it`: case-insensitive substring against `it(...)` / `test(...)` titles.",
+    "",
+    "Plus:",
+    "- `specFile`: relative path to the `.spec.ts` file.",
+    "- `apiDir` (optional but recommended): enables authoritative prefix + fixture-name detection via `inspectAppFixtures()`.",
+    "- `format` (optional): `markdown` (default) or `json`."
+  ].join("\n"),
+  inputSchema: {
+    type: "object",
+    properties: {
+      specFile: { type: "string", description: "Relative path to the `.spec.ts` file." },
+      apiDir: { type: "string", description: "Optional relative path to the API app." },
+      model: { type: "string", description: "Bare PascalCase model name (e.g. `Job`)." },
+      chain: { type: "string", description: "`>`-separated chain (e.g. `Country > CountryState`)." },
+      describe: { type: "string", description: "Substring match against describe titles." },
+      it: { type: "string", description: "Substring match against it/test titles." },
+      format: { type: "string", enum: ["markdown", "json"], description: "Output format. Defaults to markdown." }
     },
-    required: ["apiDir", "model"]
+    required: ["specFile"]
   }
 };
-async function run4(rawArgs) {
-  const parsed = ForwardArgsType(rawArgs);
-  if (parsed instanceof type36.errors) {
+async function run6(rawArgs) {
+  const parsed = SearchArgsType2(rawArgs);
+  if (parsed instanceof type38.errors) {
     return toolError(`Invalid arguments: ${parsed.summary}`);
   }
-  const cwd = process.cwd();
-  try {
-    ensurePathInsideCwd(parsed.apiDir, cwd);
-  } catch (err) {
-    return toolError(toErrorMessage(err));
-  }
-  const apiAbs = resolve21(cwd, parsed.apiDir);
-  let extraction;
-  try {
-    extraction = await inspectAppFixtures(apiAbs, parsed.apiDir);
-  } catch (err) {
-    return toolError(`Failed to read fixture file: ${toErrorMessage(err)}`);
-  }
-  const entry = extraction.entries.find((e) => e.model === parsed.model);
-  if (!entry) {
-    const known = extraction.entries.map((e) => e.model).join(", ") || "(none)";
-    return toolError(`Model \`${parsed.model}\` not found in \`${extraction.fixturePath}\`. Known: ${known}.`);
-  }
-  const rendered = renderForwarders({ entry, methods: parsed.methods });
-  if (rendered.added.length === 0) {
-    return { content: [{ type: "text", text: renderNoOpReport(extraction.fixturePath, entry.fixtureClassName, rendered) }] };
+  const queryFields = [
+    { mode: "model", value: parsed.model },
+    { mode: "chain", value: parsed.chain },
+    { mode: "describe", value: parsed.describe },
+    { mode: "it", value: parsed.it }
+  ].filter((q) => q.value !== void 0 && q.value !== "");
+  if (queryFields.length === 0) {
+    return toolError("Provide exactly one of `model`, `chain`, `describe`, or `it`.");
   }
-  const absolutePath = join5(apiAbs, FIXTURE_RELATIVE_PATH);
-  const writeError = await applyForwardersToFile(absolutePath, entry.fixtureClassName, rendered);
-  if (writeError) {
-    return toolError(writeError);
+  if (queryFields.length > 1) {
+    return toolError(`Provide exactly one query field. Received: ${queryFields.map((q) => q.mode).join(", ")}.`);
   }
-  return { content: [{ type: "text", text: renderSuccessReport(extraction.fixturePath, entry.fixtureClassName, rendered) }] };
-}
-function toErrorMessage(err) {
-  return err instanceof Error ? err.message : String(err);
-}
-async function applyForwardersToFile(absolutePath, fixtureClassName, rendered) {
-  const project = new Project8({ skipAddingFilesFromTsConfig: true });
-  let sourceFile;
+  const query = { mode: queryFields[0].mode, value: queryFields[0].value };
+  const cwd = process.cwd();
   try {
-    sourceFile = project.addSourceFileAtPath(absolutePath);
+    ensurePathInsideCwd(parsed.specFile, cwd);
+    if (parsed.apiDir !== void 0) ensurePathInsideCwd(parsed.apiDir, cwd);
   } catch (err) {
-    return `Failed to load fixture file: ${toErrorMessage(err)}`;
-  }
-  const fixtureClass = sourceFile.getClass(fixtureClassName);
-  if (!fixtureClass) {
-    return `Could not locate class \`${fixtureClassName}\` for in-place edit. The fixture file may have been modified since parsing.`;
-  }
-  for (const forwarder of rendered.added) {
-    fixtureClass.insertText(fixtureClass.getEnd() - 1, "\n" + forwarder.source + "\n");
+    return toolError(err instanceof Error ? err.message : String(err));
   }
-  sourceFile.formatText({ ensureNewLineAtEndOfFile: true });
+  const specAbs = resolve23(cwd, parsed.specFile);
+  const apiAbs = parsed.apiDir !== void 0 ? resolve23(cwd, parsed.apiDir) : void 0;
+  let tree;
   try {
-    await sourceFile.save();
+    tree = await inspectSpecFile({ specAbs, specRel: parsed.specFile, apiAbs, apiRel: parsed.apiDir });
   } catch (err) {
-    return `Failed to write fixture file: ${toErrorMessage(err)}`;
-  }
-  return void 0;
-}
-function renderNoOpReport(fixturePath, fixtureClassName, rendered) {
-  const lines = [`# No forwarders to add for \`${fixtureClassName}\``, "", `File: \`${fixturePath}\``];
-  appendListSection(lines, "## Already forwarded", rendered.skippedAlreadyForwarded);
-  appendListSection(lines, "## Whitelisted methods missing from Instance", rendered.missingFromInstance);
-  return lines.join("\n");
-}
-function renderSuccessReport(fixturePath, fixtureClassName, rendered) {
-  const lines = [`# Forwarded ${rendered.added.length} method${rendered.added.length === 1 ? "" : "s"} to \`${fixtureClassName}\``, "", `File: \`${fixturePath}\``, "", "## Added"];
-  for (const f of rendered.added) {
-    lines.push(`- \`${f.method}\``);
-  }
-  appendListSection(lines, "## Skipped (already forwarded)", rendered.skippedAlreadyForwarded);
-  appendListSection(lines, "## Whitelisted methods missing from Instance", rendered.missingFromInstance);
-  return lines.join("\n");
-}
-function appendListSection(lines, heading, names) {
-  if (names.length === 0) return;
-  lines.push("", heading);
-  for (const name of names) {
-    lines.push(`- \`${name}\``);
+    return toolError(`Failed to read spec file: ${err instanceof Error ? err.message : String(err)}`);
   }
+  const result = searchSpecTree(tree, query);
+  const text = parsed.format === "json" ? formatSearchAsJson(tree, result) : formatSearchAsMarkdown(tree, result);
+  const out = { content: [{ type: "text", text }] };
+  return out;
 }
-var modelFixtureForwardTool = { definition: TOOL5, run: run4 };
+var modelTestSearchTool = { definition: TOOL7, run: run6 };
 
 // packages/dbx-components-mcp/src/tools/storagefile-m-validate-app/extract.ts
-import { Node as Node13, SyntaxKind as SyntaxKind8 } from "ts-morph";
+import { Node as Node14, SyntaxKind as SyntaxKind9 } from "ts-morph";
 
 // packages/dbx-components-mcp/src/tools/_validate/ast.ts
-import { Node as Node12, Project as Project9, SyntaxKind as SyntaxKind7 } from "ts-morph";
+import { Node as Node13, Project as Project10, SyntaxKind as SyntaxKind8 } from "ts-morph";
 var COMPONENT_VIRTUAL_PREFIX = "__component__/";
 var API_VIRTUAL_PREFIX = "__api__/";
 function buildInMemoryProject(input) {
-  const project = new Project9({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project10({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   const componentSources = [];
   const apiSources = [];
   for (const file of input.component.files) {
@@ -16803,28 +17864,28 @@ function componentRelPath(sourceFile) {
 }
 function unwrapAsExpressions(node) {
   let current = node;
-  while (current && Node12.isAsExpression(current)) {
+  while (current && Node13.isAsExpression(current)) {
     current = current.getExpression();
   }
   return current;
 }
 function asObjectLiteral(node) {
   const inner = unwrapAsExpressions(node);
-  if (inner && Node12.isObjectLiteralExpression(inner)) {
+  if (inner && Node13.isObjectLiteralExpression(inner)) {
     return inner;
   }
   return void 0;
 }
 function asArrayLiteral(node) {
   const inner = unwrapAsExpressions(node);
-  if (inner && Node12.isArrayLiteralExpression(inner)) {
+  if (inner && Node13.isArrayLiteralExpression(inner)) {
     return inner;
   }
   return void 0;
 }
 function readStringLiteralInitializer(decl) {
   const initializer = unwrapAsExpressions(decl.getInitializer());
-  if (initializer && Node12.isStringLiteral(initializer)) {
+  if (initializer && Node13.isStringLiteral(initializer)) {
     return initializer.getLiteralText();
   }
   return void 0;
@@ -16836,37 +17897,37 @@ function typeAnnotationText(node) {
 function getPropertyInitializer(obj, name) {
   const prop = obj.getProperty(name);
   if (!prop) return void 0;
-  if (Node12.isPropertyAssignment(prop)) {
+  if (Node13.isPropertyAssignment(prop)) {
     return prop.getInitializer();
   }
-  if (Node12.isShorthandPropertyAssignment(prop)) {
+  if (Node13.isShorthandPropertyAssignment(prop)) {
     return prop.getNameNode();
   }
   return void 0;
 }
 function readStringProperty2(obj, name) {
   const init = unwrapAsExpressions(getPropertyInitializer(obj, name));
-  if (init && Node12.isStringLiteral(init)) {
+  if (init && Node13.isStringLiteral(init)) {
     return init.getLiteralText();
   }
   return void 0;
 }
 function readIdentifierProperty(obj, name) {
   const init = unwrapAsExpressions(getPropertyInitializer(obj, name));
-  if (init && Node12.isIdentifier(init)) {
+  if (init && Node13.isIdentifier(init)) {
     return init.getText();
   }
   return void 0;
 }
 function findReturnExpression(fn) {
-  if (!Node12.isArrowFunction(fn) && !Node12.isFunctionDeclaration(fn) && !Node12.isFunctionExpression(fn)) {
+  if (!Node13.isArrowFunction(fn) && !Node13.isFunctionDeclaration(fn) && !Node13.isFunctionExpression(fn)) {
     return void 0;
   }
   const body = fn.getBody();
   if (!body) return void 0;
-  if (Node12.isBlock(body)) {
+  if (Node13.isBlock(body)) {
     for (const stmt of body.getStatements()) {
-      if (Node12.isReturnStatement(stmt)) {
+      if (Node13.isReturnStatement(stmt)) {
         return stmt.getExpression();
       }
     }
@@ -16880,17 +17941,17 @@ function findLocalVariable(sf, name) {
       if (decl.getName() === name) return decl;
     }
   }
-  for (const decl of sf.getDescendantsOfKind(SyntaxKind7.VariableDeclaration)) {
+  for (const decl of sf.getDescendantsOfKind(SyntaxKind8.VariableDeclaration)) {
     if (decl.getName() === name) return decl;
   }
   return void 0;
 }
 function collectTypeofReferences(node, out) {
-  if (Node12.isTypeQuery(node)) {
+  if (Node13.isTypeQuery(node)) {
     out.push(node.getExprName().getText());
     return;
   }
-  for (const tq of node.getDescendantsOfKind(SyntaxKind7.TypeQuery)) {
+  for (const tq of node.getDescendantsOfKind(SyntaxKind8.TypeQuery)) {
     out.push(tq.getExprName().getText());
   }
 }
@@ -17188,8 +18249,8 @@ function getFunctionType(x) {
   return typeof x === "function" ? x.prototype ? Object.getOwnPropertyDescriptor(x, "prototype")?.writable ? "function" : "class" : x.constructor.name === "AsyncFunction" ? "function" : "arrow" : null;
 }
 function isNonClassFunction(x) {
-  const type60 = getFunctionType(x);
-  return type60 != null && type60 !== "class";
+  const type62 = getFunctionType(x);
+  return type62 != null && type62 !== "class";
 }
 
 // packages/util/src/lib/getter/getter.ts
@@ -17266,9 +18327,9 @@ function asNumber(input) {
 }
 
 // packages/util/src/lib/number/round.ts
-function roundingFunction(type60) {
+function roundingFunction(type62) {
   let fn;
-  switch (type60) {
+  switch (type62) {
     case "floor":
       fn = Math.floor;
       break;
@@ -17521,9 +18582,9 @@ function filterKeyValueTuplesInputToFilter(input) {
 }
 function filterKeyValueTupleFunction(inputFilter) {
   const filter = filterKeyValueTuplesInputToFilter(inputFilter);
-  const { valueFilter: type60 = 1 /* UNDEFINED */, invertFilter: inverseFilter = false, keysFilter } = filter;
+  const { valueFilter: type62 = 1 /* UNDEFINED */, invertFilter: inverseFilter = false, keysFilter } = filter;
   let filterFn;
-  switch (type60) {
+  switch (type62) {
     case 1 /* UNDEFINED */:
       filterFn = ([, x]) => x !== void 0;
       break;
@@ -17782,7 +18843,7 @@ var NUMBER_STRING_DENCODER_64_DIGITS = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcd
 var NUMBER_STRING_DENCODER_64_DEFAULT_NEGATIVE_PREFIX = "!";
 function numberStringDencoder(config) {
   const { negativePrefix, digits } = config;
-  const type60 = negativePrefix ? "integer" : "positive_integer";
+  const type62 = negativePrefix ? "integer" : "positive_integer";
   const log2OfDigits = Math.min(6, Math.floor(Math.log2(digits.length)));
   const bitDepth = Math.pow(2, log2OfDigits);
   const bitMask = bitDepth - 1;
@@ -17819,7 +18880,7 @@ function numberStringDencoder(config) {
     return result;
   }
   return {
-    type: type60,
+    type: type62,
     digits,
     bitDepth,
     negativePrefix,
@@ -17890,9 +18951,9 @@ function readableStreamToStringFunction(encoding) {
 var readableStreamToBase64 = readableStreamToStringFunction("base64");
 function readableStreamToBuffer(stream) {
   const chunks = [];
-  return new Promise((resolve34, reject) => {
+  return new Promise((resolve36, reject) => {
     stream.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
-    stream.on("end", () => resolve34(Buffer.concat(chunks)));
+    stream.on("end", () => resolve36(Buffer.concat(chunks)));
     stream.on("error", reject);
   });
 }
@@ -18315,7 +19376,7 @@ function extractUploadInitializerEntries(sources) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const decl of sf.getDescendantsOfKind(SyntaxKind8.VariableDeclaration)) {
+    for (const decl of sf.getDescendantsOfKind(SyntaxKind9.VariableDeclaration)) {
       const typeText = typeAnnotationText(decl);
       if (typeText !== UPLOAD_SERVICE_INITIALIZER_TYPE) continue;
       const obj = asObjectLiteral(decl.getInitializer());
@@ -18345,7 +19406,7 @@ function buildApiFunctionIndex(sources) {
       for (const decl of stmt.getDeclarations()) {
         const initializer = unwrapAsExpressions(decl.getInitializer());
         if (!initializer) continue;
-        if (Node13.isArrowFunction(initializer) || Node13.isFunctionExpression(initializer)) {
+        if (Node14.isArrowFunction(initializer) || Node14.isFunctionExpression(initializer)) {
           map.set(decl.getName(), { node: initializer, sourceFile: sf });
         }
       }
@@ -18358,34 +19419,34 @@ function collectInitializerBindingsFromValue(options) {
   const { node, sf, index, resolved, unresolved, visited } = options;
   const inner = unwrapAsExpressions(node);
   if (!inner) return false;
-  if (Node13.isArrayLiteralExpression(inner)) {
+  if (Node14.isArrayLiteralExpression(inner)) {
     for (const el of inner.getElements()) {
-      if (Node13.isSpreadElement(el)) {
+      if (Node14.isSpreadElement(el)) {
         const spreadInner = el.getExpression();
-        if (Node13.isIdentifier(spreadInner)) {
+        if (Node14.isIdentifier(spreadInner)) {
           collectInitializerBindingsFromIdentifier({ name: spreadInner.getText(), sf, index, resolved, unresolved, visited });
-        } else if (Node13.isCallExpression(spreadInner)) {
+        } else if (Node14.isCallExpression(spreadInner)) {
           const callee = spreadInner.getExpression();
-          if (Node13.isIdentifier(callee)) {
+          if (Node14.isIdentifier(callee)) {
             collectInitializerBindingsFromIdentifier({ name: callee.getText(), sf, index, resolved, unresolved, visited });
           }
         }
         continue;
       }
       const elementInner = unwrapAsExpressions(el);
-      if (elementInner && Node13.isIdentifier(elementInner)) {
+      if (elementInner && Node14.isIdentifier(elementInner)) {
         resolved.push(elementInner.getText());
       }
     }
     return true;
   }
-  if (Node13.isCallExpression(inner)) {
+  if (Node14.isCallExpression(inner)) {
     const callee = inner.getExpression();
-    if (Node13.isIdentifier(callee)) {
+    if (Node14.isIdentifier(callee)) {
       return collectInitializerBindingsFromIdentifier({ name: callee.getText(), sf, index, resolved, unresolved, visited });
     }
   }
-  if (Node13.isIdentifier(inner)) {
+  if (Node14.isIdentifier(inner)) {
     return collectInitializerBindingsFromIdentifier({ name: inner.getText(), sf, index, resolved, unresolved, visited });
   }
   return false;
@@ -18424,15 +19485,15 @@ function collectUploadInitializerArray(options) {
   const { initializerArr, sf, index, direct, spreads, resolved, unresolved } = options;
   const visited = /* @__PURE__ */ new Set();
   for (const el of initializerArr.getElements()) {
-    if (Node13.isSpreadElement(el)) {
+    if (Node14.isSpreadElement(el)) {
       const inner2 = el.getExpression();
-      if (Node13.isIdentifier(inner2)) {
+      if (Node14.isIdentifier(inner2)) {
         const name = inner2.getText();
         spreads.push(name);
         collectInitializerBindingsFromIdentifier({ name, sf, index, resolved, unresolved, visited });
-      } else if (Node13.isCallExpression(inner2)) {
+      } else if (Node14.isCallExpression(inner2)) {
         const callee = inner2.getExpression();
-        if (Node13.isIdentifier(callee)) {
+        if (Node14.isIdentifier(callee)) {
           const name = callee.getText();
           spreads.push(name);
           collectInitializerBindingsFromIdentifier({ name, sf, index, resolved, unresolved, visited });
@@ -18441,7 +19502,7 @@ function collectUploadInitializerArray(options) {
       continue;
     }
     const inner = unwrapAsExpressions(el);
-    if (inner && Node13.isIdentifier(inner)) {
+    if (inner && Node14.isIdentifier(inner)) {
       const name = inner.getText();
       direct.push(name);
       resolved.push(name);
@@ -18452,9 +19513,9 @@ function extractUploadServiceCalls(sources, index) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const call of sf.getDescendantsOfKind(SyntaxKind8.CallExpression)) {
+    for (const call of sf.getDescendantsOfKind(SyntaxKind9.CallExpression)) {
       const expr = call.getExpression();
-      if (!Node13.isIdentifier(expr) || expr.getText() !== UPLOAD_SERVICE_FACTORY) continue;
+      if (!Node14.isIdentifier(expr) || expr.getText() !== UPLOAD_SERVICE_FACTORY) continue;
       const args = call.getArguments();
       const first = args[0] ? resolveObjectArg(args[0], sf) : void 0;
       if (!first) continue;
@@ -18482,12 +19543,12 @@ function extractUploadServiceCalls(sources, index) {
 function resolveObjectArg(node, sf) {
   const inner = unwrapAsExpressions(node);
   if (!inner) return void 0;
-  if (Node13.isObjectLiteralExpression(inner)) return inner;
-  if (Node13.isIdentifier(inner)) {
+  if (Node14.isObjectLiteralExpression(inner)) return inner;
+  if (Node14.isIdentifier(inner)) {
     const declNode = findLocalVariable(sf, inner.getText());
     if (declNode) {
       const declInit = unwrapAsExpressions(declNode.getInitializer());
-      if (declInit && Node13.isObjectLiteralExpression(declInit)) {
+      if (declInit && Node14.isObjectLiteralExpression(declInit)) {
         return declInit;
       }
     }
@@ -18497,12 +19558,12 @@ function resolveObjectArg(node, sf) {
 function resolveArrayFromProperty(obj, name, sf) {
   const init = unwrapAsExpressions(getPropertyInitializer(obj, name));
   if (!init) return void 0;
-  if (Node13.isArrayLiteralExpression(init)) return init;
-  if (Node13.isIdentifier(init)) {
+  if (Node14.isArrayLiteralExpression(init)) return init;
+  if (Node14.isIdentifier(init)) {
     const declNode = findLocalVariable(sf, init.getText());
     if (declNode) {
       const declInit = unwrapAsExpressions(declNode.getInitializer());
-      if (declInit && Node13.isArrayLiteralExpression(declInit)) {
+      if (declInit && Node14.isArrayLiteralExpression(declInit)) {
         return declInit;
       }
     }
@@ -18513,11 +19574,11 @@ function enclosingFactoryName(node) {
   let current = node.getParent();
   let result;
   while (current) {
-    if (Node13.isFunctionDeclaration(current)) {
+    if (Node14.isFunctionDeclaration(current)) {
       result = current.getName() ?? void 0;
       break;
     }
-    if (Node13.isVariableDeclaration(current)) {
+    if (Node14.isVariableDeclaration(current)) {
       result = current.getName();
       break;
     }
@@ -18529,7 +19590,7 @@ function extractUploadServiceWirings(sources) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const obj of sf.getDescendantsOfKind(SyntaxKind8.ObjectLiteralExpression)) {
+    for (const obj of sf.getDescendantsOfKind(SyntaxKind9.ObjectLiteralExpression)) {
       const provideIdent = readIdentifierProperty(obj, "provide");
       if (provideIdent !== UPLOAD_SERVICE_PROVIDE_TOKEN) continue;
       const useFactory = readIdentifierProperty(obj, "useFactory");
@@ -18542,7 +19603,7 @@ function extractProcessingConfigs(sources) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const decl of sf.getDescendantsOfKind(SyntaxKind8.VariableDeclaration)) {
+    for (const decl of sf.getDescendantsOfKind(SyntaxKind9.VariableDeclaration)) {
       const config = extractProcessingConfigFromDecl(decl, rel);
       if (config) {
         out.push(config);
@@ -18571,10 +19632,10 @@ function extractProcessingConfigFromDecl(decl, rel) {
 function readFlowSubtasks(obj) {
   const flowInit = unwrapAsExpressions(getPropertyInitializer(obj, "flow"));
   const subtasks = [];
-  if (flowInit && Node13.isArrayLiteralExpression(flowInit)) {
+  if (flowInit && Node14.isArrayLiteralExpression(flowInit)) {
     for (const el of flowInit.getElements()) {
       const inner = unwrapAsExpressions(el);
-      if (inner && Node13.isObjectLiteralExpression(inner)) {
+      if (inner && Node14.isObjectLiteralExpression(inner)) {
         const subtask = readIdentifierProperty(inner, "subtask");
         if (subtask) subtasks.push(subtask);
       }
@@ -18586,9 +19647,9 @@ function extractProcessingHandlerCalls(sources) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const call of sf.getDescendantsOfKind(SyntaxKind8.CallExpression)) {
+    for (const call of sf.getDescendantsOfKind(SyntaxKind9.CallExpression)) {
       const expr = call.getExpression();
-      if (!Node13.isIdentifier(expr) || expr.getText() !== PROCESSING_HANDLER_FACTORY) continue;
+      if (!Node14.isIdentifier(expr) || expr.getText() !== PROCESSING_HANDLER_FACTORY) continue;
       const args = call.getArguments();
       const first = args[0] ? resolveObjectArg(args[0], sf) : void 0;
       if (!first) continue;
@@ -18609,7 +19670,7 @@ function extractProcessingHandlerCalls(sources) {
 }
 function collectProcessorArrayElements(processorsArr, direct, spreads) {
   for (const el of processorsArr.getElements()) {
-    if (Node13.isSpreadElement(el)) {
+    if (Node14.isSpreadElement(el)) {
       addProcessorIdentifierName(el.getExpression(), spreads);
       continue;
     }
@@ -18621,13 +19682,13 @@ function collectProcessorArrayElements(processorsArr, direct, spreads) {
 }
 function addProcessorIdentifierName(node, bucket) {
   if (!node) return;
-  if (Node13.isIdentifier(node)) {
+  if (Node14.isIdentifier(node)) {
     bucket.push(node.getText());
     return;
   }
-  if (Node13.isCallExpression(node)) {
+  if (Node14.isCallExpression(node)) {
     const callee = node.getExpression();
-    if (Node13.isIdentifier(callee)) {
+    if (Node14.isIdentifier(callee)) {
       bucket.push(callee.getText());
     }
   }
@@ -18982,8 +20043,8 @@ function formatResult4(result) {
 }
 
 // packages/dbx-components-mcp/src/tools/_validate/inspect.ts
-import { readdir as readdir3, readFile as readFile6, stat as stat5 } from "node:fs/promises";
-import { join as join6, relative as relative5, sep as sep4 } from "node:path";
+import { readdir as readdir3, readFile as readFile8, stat as stat5 } from "node:fs/promises";
+import { join as join7, relative as relative5, sep as sep4 } from "node:path";
 async function inspectSide(rootDir, subpaths) {
   const rootStatus = await readRootStatus(rootDir);
   if (rootStatus !== void 0) {
@@ -18993,7 +20054,7 @@ async function inspectSide(rootDir, subpaths) {
   const presentFolders = [];
   const collectedFiles = [];
   for (const sub of subpaths) {
-    const absFolder = join6(rootDir, sub);
+    const absFolder = join7(rootDir, sub);
     const folderPresent = await isDirectory(absFolder);
     if (!folderPresent) continue;
     presentFolders.push(sub);
@@ -19039,7 +20100,7 @@ async function collectTsFiles(absFolder, rootDir) {
       continue;
     }
     for (const entry of entries) {
-      const full = join6(current, entry.name);
+      const full = join7(current, entry.name);
       if (entry.isDirectory()) {
         stack.push(full);
         continue;
@@ -19048,7 +20109,7 @@ async function collectTsFiles(absFolder, rootDir) {
       if (!entry.name.endsWith(".ts")) continue;
       if (entry.name.endsWith(".spec.ts")) continue;
       if (entry.name.endsWith(".d.ts")) continue;
-      const text = await readFile6(full, "utf8");
+      const text = await readFile8(full, "utf8");
       const rel = relative5(rootDir, full).split(sep4).join("/");
       out.push({ relPath: rel, text });
     }
@@ -19301,8 +20362,8 @@ var storageFileMListAppTool = createListAppTool({
 });
 
 // packages/dbx-components-mcp/src/tools/validate-two-side-folder.ts
-import { readdir as readdir4, readFile as readFile7, stat as stat6 } from "node:fs/promises";
-import { join as join7 } from "node:path";
+import { readdir as readdir4, readFile as readFile9, stat as stat6 } from "node:fs/promises";
+import { join as join8 } from "node:path";
 var REEXPORT_PATTERN = /^\s*export\s+\*\s+from\s+['"]\.\/([^'"\n]+)['"]\s*;?\s*$/gm;
 function createTwoSideFolderValidator(config) {
   async function inspect(input) {
@@ -19346,7 +20407,7 @@ async function inspectSide2(input) {
   let indexSource;
   const rootStatOk = await isExistingDirectory(rootDir);
   if (rootStatOk) {
-    const absFolder = join7(rootDir, subPath);
+    const absFolder = join8(rootDir, subPath);
     const folderStatOk = await isExistingDirectory(absFolder);
     if (folderStatOk) {
       const folder = await readFolder(absFolder, indexFile);
@@ -19398,7 +20459,7 @@ async function readFolder(absFolder, indexFile) {
   let indexSource;
   if (collectedFiles.includes(indexFile)) {
     try {
-      indexSource = await readFile7(join7(absFolder, indexFile), "utf8");
+      indexSource = await readFile9(join8(absFolder, indexFile), "utf8");
     } catch {
       indexSource = void 0;
     }
@@ -19618,7 +20679,7 @@ var storageFileMValidateFolderTool = createTwoSideValidateTool({
 });
 
 // packages/dbx-components-mcp/src/tools/notification-m-validate-app/extract.ts
-import { Node as Node14, SyntaxKind as SyntaxKind9 } from "ts-morph";
+import { Node as Node15, SyntaxKind as SyntaxKind10 } from "ts-morph";
 var NOTIF_TEMPLATE_TYPE = "NotificationTemplateType";
 var NOTIF_TEMPLATE_TYPE_INFO = "NotificationTemplateTypeInfo";
 var NOTIF_TEMPLATE_TYPE_INFO_ARRAY = "NotificationTemplateTypeInfo[]";
@@ -19739,7 +20800,7 @@ function extractTemplateInfoAggregates(sources) {
         const ids = [];
         for (const el of arr.getElements()) {
           const inner = unwrapAsExpressions(el);
-          if (inner && Node14.isIdentifier(inner)) {
+          if (inner && Node15.isIdentifier(inner)) {
             ids.push(inner.getText());
           }
         }
@@ -19785,7 +20846,7 @@ function extractTaskAllTypesAggregates(sources) {
         const ids = [];
         for (const el of arr.getElements()) {
           const inner = unwrapAsExpressions(el);
-          if (inner && Node14.isIdentifier(inner)) {
+          if (inner && Node15.isIdentifier(inner)) {
             ids.push(inner.getText());
           }
         }
@@ -19813,14 +20874,14 @@ function extractTaskCheckpointAliases(sources) {
   return out;
 }
 function collectStringLiterals(node, out) {
-  if (Node14.isLiteralTypeNode(node)) {
+  if (Node15.isLiteralTypeNode(node)) {
     const lit = node.getLiteral();
-    if (Node14.isStringLiteral(lit)) {
+    if (Node15.isStringLiteral(lit)) {
       out.push(lit.getLiteralText());
     }
     return;
   }
-  if (Node14.isUnionTypeNode(node)) {
+  if (Node15.isUnionTypeNode(node)) {
     for (const child of node.getTypeNodes()) {
       collectStringLiterals(child, out);
     }
@@ -19874,7 +20935,7 @@ function extractTemplateInfoRecord(sources, index) {
 }
 function tryReadTemplateInfoRecord(decl, rel, index) {
   const initializer = unwrapAsExpressions(decl.getInitializer());
-  if (!initializer || !Node14.isCallExpression(initializer)) return void 0;
+  if (!initializer || !Node15.isCallExpression(initializer)) return void 0;
   if (initializer.getExpression().getText() !== TEMPLATE_INFO_RECORD_FACTORY) return void 0;
   const args = initializer.getArguments();
   const arr = args[0] ? asArrayLiteral(args[0]) : void 0;
@@ -19895,15 +20956,15 @@ function tryReadTemplateInfoRecord(decl, rel, index) {
 }
 function classifyInfoRecordArrayElements(arr, direct, spreads) {
   for (const el of arr.getElements()) {
-    if (Node14.isSpreadElement(el)) {
+    if (Node15.isSpreadElement(el)) {
       const inner2 = el.getExpression();
-      if (Node14.isIdentifier(inner2)) {
+      if (Node15.isIdentifier(inner2)) {
         spreads.push(inner2.getText());
       }
       continue;
     }
     const inner = unwrapAsExpressions(el);
-    if (inner && Node14.isIdentifier(inner)) {
+    if (inner && Node15.isIdentifier(inner)) {
       direct.push(inner.getText());
     }
   }
@@ -19924,13 +20985,13 @@ function resolveTemplateInfoSpreads(direct, spreads, index) {
 function extractTemplateInfoRecordWiring(sources) {
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const call of sf.getDescendantsOfKind(SyntaxKind9.CallExpression)) {
+    for (const call of sf.getDescendantsOfKind(SyntaxKind10.CallExpression)) {
       if (call.getExpression().getText() !== TEMPLATE_INFO_RECORD_SERVICE) continue;
       const args = call.getArguments();
       const first = args[0];
       if (!first) continue;
       const inner = unwrapAsExpressions(first);
-      if (!inner || !Node14.isIdentifier(inner)) continue;
+      if (!inner || !Node15.isIdentifier(inner)) continue;
       const result = {
         recordIdentifier: inner.getText(),
         sourceFile: rel
@@ -19943,7 +21004,7 @@ function extractTemplateInfoRecordWiring(sources) {
 function extractTemplateConfigsArrayWiring(sources) {
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const obj of sf.getDescendantsOfKind(SyntaxKind9.ObjectLiteralExpression)) {
+    for (const obj of sf.getDescendantsOfKind(SyntaxKind10.ObjectLiteralExpression)) {
       const provideIdent = readIdentifierProperty(obj, "provide");
       if (provideIdent !== TEMPLATE_CONFIGS_ARRAY_TOKEN) continue;
       const useFactoryIdent = readIdentifierProperty(obj, "useFactory");
@@ -19968,7 +21029,7 @@ function buildApiFunctionIndex2(sources) {
       for (const decl of stmt.getDeclarations()) {
         const initializer = unwrapAsExpressions(decl.getInitializer());
         if (!initializer) continue;
-        if (Node14.isArrowFunction(initializer) || Node14.isFunctionExpression(initializer)) {
+        if (Node15.isArrowFunction(initializer) || Node15.isFunctionExpression(initializer)) {
           map.set(decl.getName(), { node: initializer, sourceFile: sf, relPath: rel });
         }
       }
@@ -20004,11 +21065,11 @@ function extractTemplateConfigsArrayFactory(sources, index) {
     const arr = returnExpr ? asArrayLiteral(returnExpr) : void 0;
     if (arr) {
       for (const el of arr.getElements()) {
-        if (Node14.isSpreadElement(el)) {
+        if (Node15.isSpreadElement(el)) {
           const inner2 = el.getExpression();
-          if (Node14.isCallExpression(inner2)) {
+          if (Node15.isCallExpression(inner2)) {
             const callee = inner2.getExpression();
-            if (Node14.isIdentifier(callee)) {
+            if (Node15.isIdentifier(callee)) {
               const callName = callee.getText();
               spreadCalls.push(callName);
               if (!index.functionsByName.has(callName)) {
@@ -20019,9 +21080,9 @@ function extractTemplateConfigsArrayFactory(sources, index) {
           continue;
         }
         const inner = unwrapAsExpressions(el);
-        if (inner && Node14.isCallExpression(inner)) {
+        if (inner && Node15.isCallExpression(inner)) {
           const callee = inner.getExpression();
-          if (Node14.isIdentifier(callee)) {
+          if (Node15.isIdentifier(callee)) {
             directCalls.push(callee.getText());
           }
         }
@@ -20070,11 +21131,11 @@ function collectFromArrayEntryFactory(name, out, index) {
   const arr = asArrayLiteral(returnExpr);
   if (!arr) return;
   for (const el of arr.getElements()) {
-    if (Node14.isSpreadElement(el)) {
+    if (Node15.isSpreadElement(el)) {
       const inner2 = el.getExpression();
-      if (Node14.isCallExpression(inner2)) {
+      if (Node15.isCallExpression(inner2)) {
         const callee = inner2.getExpression();
-        if (Node14.isIdentifier(callee)) {
+        if (Node15.isIdentifier(callee)) {
           collectFromArrayEntryFactory(callee.getText(), out, index);
         }
       }
@@ -20082,9 +21143,9 @@ function collectFromArrayEntryFactory(name, out, index) {
     }
     const inner = unwrapAsExpressions(el);
     if (!inner) continue;
-    if (Node14.isCallExpression(inner)) {
+    if (Node15.isCallExpression(inner)) {
       const callee = inner.getExpression();
-      if (Node14.isIdentifier(callee)) {
+      if (Node15.isIdentifier(callee)) {
         collectFromSingleEntryFactory(callee.getText(), out, index);
       }
       continue;
@@ -20102,9 +21163,9 @@ function extractTaskServiceCalls(sources, index, trustedExternal) {
   const out = [];
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const call of sf.getDescendantsOfKind(SyntaxKind9.CallExpression)) {
+    for (const call of sf.getDescendantsOfKind(SyntaxKind10.CallExpression)) {
       const expr = call.getExpression();
-      if (!Node14.isIdentifier(expr) || expr.getText() !== TASK_SERVICE_FACTORY) continue;
+      if (!Node15.isIdentifier(expr) || expr.getText() !== TASK_SERVICE_FACTORY) continue;
       const args = call.getArguments();
       const first = args[0] ? asObjectLiteral(args[0]) : void 0;
       if (!first) continue;
@@ -20130,13 +21191,13 @@ function collectValidateArrayElements(validateArr) {
   const spreads = [];
   if (!validateArr) return { ids, spreads };
   for (const el of validateArr.getElements()) {
-    if (Node14.isSpreadElement(el)) {
+    if (Node15.isSpreadElement(el)) {
       const inner2 = el.getExpression();
-      if (Node14.isIdentifier(inner2)) spreads.push(inner2.getText());
+      if (Node15.isIdentifier(inner2)) spreads.push(inner2.getText());
       continue;
     }
     const inner = unwrapAsExpressions(el);
-    if (inner && Node14.isIdentifier(inner)) ids.push(inner.getText());
+    if (inner && Node15.isIdentifier(inner)) ids.push(inner.getText());
   }
   return { ids, spreads };
 }
@@ -20149,17 +21210,17 @@ function collectHandlersArrayElements(options) {
   if (!handlersArr) return { handlerTypes, unresolvedSpreads, resolvedBindings, unresolvedBindings };
   const visited = /* @__PURE__ */ new Set();
   for (const el of handlersArr.getElements()) {
-    if (Node14.isSpreadElement(el)) {
+    if (Node15.isSpreadElement(el)) {
       consumeHandlersSpreadElement({ inner: el.getExpression(), sf, index, trustedExternal, unresolvedSpreads, resolvedBindings, unresolvedBindings, visited });
       continue;
     }
     const inner = unwrapAsExpressions(el);
     if (!inner) continue;
-    if (Node14.isIdentifier(inner)) {
+    if (Node15.isIdentifier(inner)) {
       collectHandlerBindingsFromIdentifier({ name: inner.getText(), sf, index, trustedExternal, resolved: resolvedBindings, unresolved: unresolvedBindings, visited });
-    } else if (Node14.isCallExpression(inner)) {
+    } else if (Node15.isCallExpression(inner)) {
       const callee = inner.getExpression();
-      if (Node14.isIdentifier(callee)) {
+      if (Node15.isIdentifier(callee)) {
         collectHandlerBindingsFromIdentifier({ name: callee.getText(), sf, index, trustedExternal, resolved: resolvedBindings, unresolved: unresolvedBindings, visited });
       }
     }
@@ -20168,16 +21229,16 @@ function collectHandlersArrayElements(options) {
 }
 function consumeHandlersSpreadElement(options) {
   const { inner, sf, index, trustedExternal, unresolvedSpreads, resolvedBindings, unresolvedBindings, visited } = options;
-  if (Node14.isCallExpression(inner)) {
+  if (Node15.isCallExpression(inner)) {
     const callee = inner.getExpression();
-    if (Node14.isIdentifier(callee)) {
+    if (Node15.isIdentifier(callee)) {
       const name = callee.getText();
       unresolvedSpreads.push(name);
       collectHandlerBindingsFromIdentifier({ name, sf, index, trustedExternal, resolved: resolvedBindings, unresolved: unresolvedBindings, visited });
     }
     return;
   }
-  if (Node14.isIdentifier(inner)) {
+  if (Node15.isIdentifier(inner)) {
     const name = inner.getText();
     unresolvedSpreads.push(name);
     collectHandlerBindingsFromIdentifier({ name, sf, index, trustedExternal, resolved: resolvedBindings, unresolved: unresolvedBindings, visited });
@@ -20187,13 +21248,13 @@ function collectHandlerBindingsFromValue(options) {
   const { node, sf, index, trustedExternal, resolved, unresolved, visited } = options;
   const inner = unwrapAsExpressions(node);
   if (!inner) return false;
-  if (Node14.isCallExpression(inner)) {
+  if (Node15.isCallExpression(inner)) {
     const callee = inner.getExpression();
-    if (Node14.isIdentifier(callee)) {
+    if (Node15.isIdentifier(callee)) {
       return collectHandlerBindingsFromIdentifier({ name: callee.getText(), sf, index, trustedExternal, resolved, unresolved, visited });
     }
   }
-  if (Node14.isIdentifier(inner)) {
+  if (Node15.isIdentifier(inner)) {
     return collectHandlerBindingsFromIdentifier({ name: inner.getText(), sf, index, trustedExternal, resolved, unresolved, visited });
   }
   return false;
@@ -20210,7 +21271,7 @@ function collectHandlerBindingsFromIdentifier(options) {
       const typeText = typeNode ? typeNode.getText() : void 0;
       const isHandlerConfigTyped = typeText !== void 0 && (typeText === NOTIF_TASK_SERVICE_HANDLER_CONFIG || typeText.startsWith(`${NOTIF_TASK_SERVICE_HANDLER_CONFIG}<`));
       const declInit = unwrapAsExpressions(localDecl.getInitializer());
-      const isObjectLit = declInit !== void 0 && Node14.isObjectLiteralExpression(declInit);
+      const isObjectLit = declInit !== void 0 && Node15.isObjectLiteralExpression(declInit);
       if (isHandlerConfigTyped && isObjectLit) {
         resolved.push(localDecl.getName());
         resolvedAny = true;
@@ -20241,12 +21302,12 @@ function collectHandlerBindingsFromIdentifier(options) {
 function resolveArrayFromProperty2(obj, name, sf) {
   const init = unwrapAsExpressions(getPropertyInitializer(obj, name));
   if (!init) return void 0;
-  if (Node14.isArrayLiteralExpression(init)) return init;
-  if (Node14.isIdentifier(init)) {
+  if (Node15.isArrayLiteralExpression(init)) return init;
+  if (Node15.isIdentifier(init)) {
     const declNode = findLocalVariable(sf, init.getText());
     if (declNode) {
       const declInit = unwrapAsExpressions(declNode.getInitializer());
-      if (declInit && Node14.isArrayLiteralExpression(declInit)) {
+      if (declInit && Node15.isArrayLiteralExpression(declInit)) {
         return declInit;
       }
     }
@@ -20267,12 +21328,12 @@ function extractTaskHandlerEntries(sources) {
     if (!typeIdent) return;
     const flowInit = unwrapAsExpressions(getPropertyInitializer(obj, "flow"));
     let flowCount;
-    if (flowInit && Node14.isArrayLiteralExpression(flowInit)) {
+    if (flowInit && Node15.isArrayLiteralExpression(flowInit)) {
       flowCount = flowInit.getElements().length;
     }
     let dataArg;
     let checkpointArg;
-    if (Node14.isTypeReference(typeNode)) {
+    if (Node15.isTypeReference(typeNode)) {
       const tArgs = typeNode.getTypeArguments();
       if (tArgs.length >= 1) dataArg = tArgs[0].getText();
       if (tArgs.length >= 2) checkpointArg = tArgs[1].getText();
@@ -20292,7 +21353,7 @@ function extractTaskHandlerEntries(sources) {
   };
   for (const sf of sources) {
     const rel = apiRelPath(sf);
-    for (const decl of sf.getDescendantsOfKind(SyntaxKind9.VariableDeclaration)) {
+    for (const decl of sf.getDescendantsOfKind(SyntaxKind10.VariableDeclaration)) {
       collectFromVariable(decl, rel);
     }
   }
@@ -21123,8 +22184,8 @@ function formatResult8(result) {
 }
 
 // packages/dbx-components-mcp/src/tools/system-m-validate-folder/inspect.ts
-import { readdir as readdir5, readFile as readFile8, stat as stat7 } from "node:fs/promises";
-import { basename as basename5, join as join8 } from "node:path";
+import { readdir as readdir5, readFile as readFile10, stat as stat7 } from "node:fs/promises";
+import { basename as basename5, join as join9 } from "node:path";
 async function inspectFolder2(path) {
   const name = basename5(path);
   let status;
@@ -21144,7 +22205,7 @@ async function inspectFolder2(path) {
       files = collected;
       if (collected.includes("system.ts")) {
         try {
-          systemSource = await readFile8(join8(path, "system.ts"), "utf8");
+          systemSource = await readFile10(join9(path, "system.ts"), "utf8");
         } catch {
           systemSource = void 0;
         }
@@ -21165,14 +22226,14 @@ async function inspectFolder2(path) {
 }
 
 // packages/dbx-components-mcp/src/tools/system-m-validate-folder/extract.ts
-import { Node as Node15, Project as Project10 } from "ts-morph";
+import { Node as Node16, Project as Project11 } from "ts-morph";
 var TYPE_CONSTANT_SUFFIX = "_SYSTEM_STATE_TYPE";
 var DATA_INTERFACE_SUFFIX = "SystemData";
 var CONVERTER_CONFIG_TYPE = "SystemStateStoredDataFieldConverterConfig";
 var CONVERTER_MAP_TYPE = "SystemStateStoredDataConverterMap";
 var SYSTEM_STATE_STORED_DATA = "SystemStateStoredData";
 function extractSystemFile(name, text) {
-  const project = new Project10({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project11({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   const sourceFile = project.createSourceFile(name, text, { overwrite: true });
   const typeConstants = findTypeConstants(sourceFile);
   const dataInterfaces = findDataInterfaces2(sourceFile);
@@ -21229,7 +22290,7 @@ function findDataInterfaces2(sourceFile) {
   return out;
 }
 function extendsSystemStateStoredData(iface) {
-  if (!Node15.isInterfaceDeclaration(iface)) return false;
+  if (!Node16.isInterfaceDeclaration(iface)) return false;
   for (const clause of iface.getExtends()) {
     const text = clause.getText();
     if (text === SYSTEM_STATE_STORED_DATA || text.startsWith(`${SYSTEM_STATE_STORED_DATA}<`) || text === `${SYSTEM_STATE_STORED_DATA}, ${SYSTEM_STATE_STORED_DATA}`) {
@@ -21249,14 +22310,14 @@ function findConverters2(sourceFile) {
     for (const decl of stmt.getDeclarations()) {
       const typeNode = decl.getTypeNode();
       if (!typeNode) continue;
-      if (!Node15.isTypeReference(typeNode)) continue;
+      if (!Node16.isTypeReference(typeNode)) continue;
       const typeName = typeNode.getTypeName().getText();
       if (typeName !== CONVERTER_CONFIG_TYPE) continue;
       const typeArgs = typeNode.getTypeArguments();
       let dataTypeArgument;
       if (typeArgs.length >= 1) {
         const arg = typeArgs[0];
-        if (Node15.isTypeReference(arg)) {
+        if (Node16.isTypeReference(arg)) {
           dataTypeArgument = arg.getTypeName().getText();
         } else {
           dataTypeArgument = arg.getText();
@@ -21303,19 +22364,19 @@ function collectConverterMapKeys(decl) {
   if (!obj) return [];
   const out = [];
   for (const prop of obj.getProperties()) {
-    if (!Node15.isPropertyAssignment(prop)) continue;
+    if (!Node16.isPropertyAssignment(prop)) continue;
     const nameNode = prop.getNameNode();
     const line = prop.getStartLineNumber();
-    if (Node15.isComputedPropertyName(nameNode)) {
+    if (Node16.isComputedPropertyName(nameNode)) {
       const inner = nameNode.getExpression();
       out.push({ raw: inner.getText(), kind: "identifier", line });
       continue;
     }
-    if (Node15.isStringLiteral(nameNode)) {
+    if (Node16.isStringLiteral(nameNode)) {
       out.push({ raw: nameNode.getLiteralText(), kind: "string", line });
       continue;
     }
-    if (Node15.isIdentifier(nameNode)) {
+    if (Node16.isIdentifier(nameNode)) {
       out.push({ raw: nameNode.getText(), kind: "string", line });
       continue;
     }
@@ -21325,10 +22386,10 @@ function collectConverterMapKeys(decl) {
 }
 function unwrapObjectLiteral(node) {
   let current = node;
-  while (current && Node15.isAsExpression(current)) {
+  while (current && Node16.isAsExpression(current)) {
     current = current.getExpression();
   }
-  if (current && Node15.isObjectLiteralExpression(current)) {
+  if (current && Node16.isObjectLiteralExpression(current)) {
     return current;
   }
   return void 0;
@@ -21362,10 +22423,10 @@ function findLastTopLevelExportLine(sourceFile) {
   return last;
 }
 function isExportedTopLevel(stmt) {
-  if (Node15.isVariableStatement(stmt) || Node15.isFunctionDeclaration(stmt) || Node15.isClassDeclaration(stmt) || Node15.isInterfaceDeclaration(stmt) || Node15.isTypeAliasDeclaration(stmt) || Node15.isEnumDeclaration(stmt)) {
+  if (Node16.isVariableStatement(stmt) || Node16.isFunctionDeclaration(stmt) || Node16.isClassDeclaration(stmt) || Node16.isInterfaceDeclaration(stmt) || Node16.isTypeAliasDeclaration(stmt) || Node16.isEnumDeclaration(stmt)) {
     return stmt.isExported();
   }
-  if (Node15.isExportDeclaration(stmt) || Node15.isExportAssignment(stmt)) {
+  if (Node16.isExportDeclaration(stmt) || Node16.isExportAssignment(stmt)) {
     return true;
   }
   return false;
@@ -21676,7 +22737,7 @@ var systemMValidateFolderTool = createFolderValidateTool({
 });
 
 // packages/dbx-components-mcp/src/tools/lookup-action.tool.ts
-import { type as type37 } from "arktype";
+import { type as type39 } from "arktype";
 var DBX_ACTION_LOOKUP_TOOL = {
   name: "dbx_action_lookup",
   description: [
@@ -21709,13 +22770,13 @@ var DBX_ACTION_LOOKUP_TOOL = {
     required: ["topic"]
   }
 };
-var LookupActionArgsType = type37({
+var LookupActionArgsType = type39({
   topic: "string",
   "depth?": "'brief' | 'full'"
 });
 function parseLookupActionArgs(raw) {
   const parsed = LookupActionArgsType(raw);
-  if (parsed instanceof type37.errors) {
+  if (parsed instanceof type39.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const result = {
@@ -21982,7 +23043,7 @@ function code6(value) {
 }
 function createLookupActionTool(input) {
   const { registry } = input;
-  const run10 = (rawArgs) => {
+  const run12 = (rawArgs) => {
     let args;
     try {
       args = parseLookupActionArgs(rawArgs);
@@ -22009,11 +23070,11 @@ function createLookupActionTool(input) {
     const result = { content: [{ type: "text", text }] };
     return result;
   };
-  return { definition: DBX_ACTION_LOOKUP_TOOL, run: run10 };
+  return { definition: DBX_ACTION_LOOKUP_TOOL, run: run12 };
 }
 
 // packages/dbx-components-mcp/src/tools/action-examples.tool.ts
-import { type as type38 } from "arktype";
+import { type as type40 } from "arktype";
 
 // packages/dbx-components-mcp/src/tools/data/patterns/actions/action.auto-trigger-on-modify.pattern.ts
 var ACTION_PATTERN_AUTO_TRIGGER_ON_MODIFY = {
@@ -22373,13 +23434,13 @@ var DBX_ACTION_EXAMPLES_TOOL = {
     required: ["pattern"]
   }
 };
-var ActionExamplesArgsType = type38({
+var ActionExamplesArgsType = type40({
   pattern: "string",
   "depth?": "'minimal' | 'brief' | 'full'"
 });
 function parseActionExamplesArgs(raw) {
   const parsed = ActionExamplesArgsType(raw);
-  if (parsed instanceof type38.errors) {
+  if (parsed instanceof type40.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const result = {
@@ -22441,7 +23502,7 @@ var actionExamplesTool = {
 };
 
 // packages/dbx-components-mcp/src/tools/action-scaffold.tool.ts
-import { type as type39 } from "arktype";
+import { type as type41 } from "arktype";
 var TRIGGER_VALUES = ["button", "form", "auto-modify"];
 var SUCCESS_FEEDBACK_VALUES = ["snackbar", "redirect", "none"];
 var CONTEXT_PROVIDER_VALUES = ["inline", "parent", "host-component"];
@@ -22475,7 +23536,7 @@ var DBX_ACTION_SCAFFOLD_TOOL = {
     required: ["use_case", "trigger", "value_type"]
   }
 };
-var ScaffoldArgsType4 = type39({
+var ScaffoldArgsType4 = type41({
   use_case: "string",
   trigger: "'button' | 'form' | 'auto-modify'",
   "confirm?": "boolean",
@@ -22486,7 +23547,7 @@ var ScaffoldArgsType4 = type39({
 });
 function parseScaffoldArgs2(raw) {
   const parsed = ScaffoldArgsType4(raw);
-  if (parsed instanceof type39.errors) {
+  if (parsed instanceof type41.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const useCase = parsed.use_case.trim();
@@ -22692,16 +23753,16 @@ var actionScaffoldTool = {
 };
 
 // packages/dbx-components-mcp/src/tools/route-tree.tool.ts
-import { type as type40 } from "arktype";
+import { type as type42 } from "arktype";
 
 // packages/dbx-components-mcp/src/tools/route/load-sources.ts
-import { glob as fsGlob4, readFile as readFile9, stat as stat8 } from "node:fs/promises";
-import { dirname as dirname7, isAbsolute as isAbsolute7, resolve as resolve22, sep as sep5 } from "node:path";
+import { glob as fsGlob4, readFile as readFile11, stat as stat8 } from "node:fs/promises";
+import { dirname as dirname7, isAbsolute as isAbsolute7, resolve as resolve24, sep as sep5 } from "node:path";
 
 // packages/dbx-components-mcp/src/tools/route/extract.ts
-import { Node as Node16, Project as Project11, SyntaxKind as SyntaxKind10 } from "ts-morph";
+import { Node as Node17, Project as Project12, SyntaxKind as SyntaxKind11 } from "ts-morph";
 function extractFile3(source) {
-  const project = new Project11({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project12({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   const sourceFile = project.createSourceFile(source.name, source.text, { overwrite: true });
   const issues = [];
   const objectLiteralsByName = collectStateConsts(sourceFile);
@@ -22714,9 +23775,9 @@ function extractFile3(source) {
   }
   for (const arrayLit of findStateArrayLiterals(sourceFile)) {
     for (const element of arrayLit.getElements()) {
-      if (Node16.isObjectLiteralExpression(element)) {
+      if (Node17.isObjectLiteralExpression(element)) {
         addNode({ file: source.name, literal: element, fallbackConstName: void 0, into: collected, issues });
-      } else if (Node16.isIdentifier(element)) {
+      } else if (Node17.isIdentifier(element)) {
         const ref = objectLiteralsByName.get(element.getText());
         if (ref) {
           addNode({ file: source.name, literal: ref.literal, fallbackConstName: element.getText(), into: collected, issues });
@@ -22737,7 +23798,7 @@ function collectStateConsts(sourceFile) {
   for (const stmt of sourceFile.getVariableStatements()) {
     for (const decl of stmt.getDeclarations()) {
       const initializer = decl.getInitializer();
-      if (!initializer || !Node16.isObjectLiteralExpression(initializer)) {
+      if (!initializer || !Node17.isObjectLiteralExpression(initializer)) {
         continue;
       }
       const typeNode = decl.getTypeNode();
@@ -22752,12 +23813,12 @@ function findStateArrayLiterals(sourceFile) {
   for (const stmt of sourceFile.getVariableStatements()) {
     for (const decl of stmt.getDeclarations()) {
       const initializer = decl.getInitializer();
-      if (initializer && Node16.isArrayLiteralExpression(initializer) && declarationIsStateArray(stmt, decl.getName(), initializer)) {
+      if (initializer && Node17.isArrayLiteralExpression(initializer) && declarationIsStateArray(stmt, decl.getName(), initializer)) {
         arrays.push(initializer);
       }
     }
   }
-  for (const call of sourceFile.getDescendantsOfKind(SyntaxKind10.CallExpression)) {
+  for (const call of sourceFile.getDescendantsOfKind(SyntaxKind11.CallExpression)) {
     const expr = call.getExpression();
     const exprText = expr.getText();
     const isProvide = exprText === "provideStates";
@@ -22766,17 +23827,17 @@ function findStateArrayLiterals(sourceFile) {
       continue;
     }
     for (const arg of call.getArguments()) {
-      if (!Node16.isObjectLiteralExpression(arg)) {
+      if (!Node17.isObjectLiteralExpression(arg)) {
         continue;
       }
       const statesProp = arg.getProperty("states");
-      if (!statesProp || !Node16.isPropertyAssignment(statesProp)) {
+      if (!statesProp || !Node17.isPropertyAssignment(statesProp)) {
         continue;
       }
       const initializer = statesProp.getInitializer();
-      if (initializer && Node16.isArrayLiteralExpression(initializer)) {
+      if (initializer && Node17.isArrayLiteralExpression(initializer)) {
         arrays.push(initializer);
-      } else if (initializer && Node16.isIdentifier(initializer)) {
+      } else if (initializer && Node17.isIdentifier(initializer)) {
         const referenced = findArrayLiteralForIdentifier(sourceFile, initializer);
         if (referenced) {
           arrays.push(referenced);
@@ -22793,10 +23854,10 @@ function declarationIsStateArray(stmt, name, literal) {
     return true;
   }
   for (const element of literal.getElements()) {
-    if (Node16.isObjectLiteralExpression(element) && hasStringNameProperty(element)) {
+    if (Node17.isObjectLiteralExpression(element) && hasStringNameProperty(element)) {
       return true;
     }
-    if (Node16.isIdentifier(element)) {
+    if (Node17.isIdentifier(element)) {
       return true;
     }
   }
@@ -22804,11 +23865,11 @@ function declarationIsStateArray(stmt, name, literal) {
 }
 function hasStringNameProperty(literal) {
   const nameProp = literal.getProperty("name");
-  if (!nameProp || !Node16.isPropertyAssignment(nameProp)) {
+  if (!nameProp || !Node17.isPropertyAssignment(nameProp)) {
     return false;
   }
   const initializer = nameProp.getInitializer();
-  return initializer !== void 0 && (Node16.isStringLiteral(initializer) || Node16.isNoSubstitutionTemplateLiteral(initializer));
+  return initializer !== void 0 && (Node17.isStringLiteral(initializer) || Node17.isNoSubstitutionTemplateLiteral(initializer));
 }
 function findArrayLiteralForIdentifier(sourceFile, identifier) {
   const name = identifier.getText();
@@ -22818,7 +23879,7 @@ function findArrayLiteralForIdentifier(sourceFile, identifier) {
         continue;
       }
       const initializer = decl.getInitializer();
-      if (initializer && Node16.isArrayLiteralExpression(initializer)) {
+      if (initializer && Node17.isArrayLiteralExpression(initializer)) {
         return initializer;
       }
     }
@@ -22868,64 +23929,64 @@ function addNode(options) {
 }
 function stringPropertyValue(literal, key) {
   const prop = literal.getProperty(key);
-  if (!prop || !Node16.isPropertyAssignment(prop)) {
+  if (!prop || !Node17.isPropertyAssignment(prop)) {
     return void 0;
   }
   const initializer = prop.getInitializer();
   if (!initializer) {
     return void 0;
   }
-  if (Node16.isStringLiteral(initializer) || Node16.isNoSubstitutionTemplateLiteral(initializer)) {
+  if (Node17.isStringLiteral(initializer) || Node17.isNoSubstitutionTemplateLiteral(initializer)) {
     return initializer.getLiteralText();
   }
   return void 0;
 }
 function booleanPropertyValue(literal, key) {
   const prop = literal.getProperty(key);
-  if (!prop || !Node16.isPropertyAssignment(prop)) {
+  if (!prop || !Node17.isPropertyAssignment(prop)) {
     return void 0;
   }
   const initializer = prop.getInitializer();
   if (!initializer) {
     return void 0;
   }
-  if (initializer.getKind() === SyntaxKind10.TrueKeyword) {
+  if (initializer.getKind() === SyntaxKind11.TrueKeyword) {
     return true;
   }
-  if (initializer.getKind() === SyntaxKind10.FalseKeyword) {
+  if (initializer.getKind() === SyntaxKind11.FalseKeyword) {
     return false;
   }
   return void 0;
 }
 function identifierPropertyValue(literal, key) {
   const prop = literal.getProperty(key);
-  if (!prop || !Node16.isPropertyAssignment(prop)) {
+  if (!prop || !Node17.isPropertyAssignment(prop)) {
     return void 0;
   }
   const initializer = prop.getInitializer();
   if (!initializer) {
     return void 0;
   }
-  if (Node16.isIdentifier(initializer)) {
+  if (Node17.isIdentifier(initializer)) {
     return initializer.getText();
   }
-  if (Node16.isPropertyAccessExpression(initializer)) {
+  if (Node17.isPropertyAccessExpression(initializer)) {
     return initializer.getText();
   }
   return void 0;
 }
 function objectPropertyKeys(literal, key) {
   const prop = literal.getProperty(key);
-  if (!prop || !Node16.isPropertyAssignment(prop)) {
+  if (!prop || !Node17.isPropertyAssignment(prop)) {
     return [];
   }
   const initializer = prop.getInitializer();
-  if (!initializer || !Node16.isObjectLiteralExpression(initializer)) {
+  if (!initializer || !Node17.isObjectLiteralExpression(initializer)) {
     return [];
   }
   const out = [];
   for (const member of initializer.getProperties()) {
-    if (Node16.isPropertyAssignment(member) || Node16.isShorthandPropertyAssignment(member) || Node16.isMethodDeclaration(member)) {
+    if (Node17.isPropertyAssignment(member) || Node17.isShorthandPropertyAssignment(member) || Node17.isMethodDeclaration(member)) {
       const nameNode = member.getNameNode();
       if (nameNode) {
         out.push(nameNode.getText());
@@ -22936,7 +23997,7 @@ function objectPropertyKeys(literal, key) {
 }
 function collectResolveKeys(literal) {
   const prop = literal.getProperty("resolve");
-  if (!prop || !Node16.isPropertyAssignment(prop)) {
+  if (!prop || !Node17.isPropertyAssignment(prop)) {
     return [];
   }
   const initializer = prop.getInitializer();
@@ -22944,22 +24005,22 @@ function collectResolveKeys(literal) {
     return [];
   }
   const keys = [];
-  if (Node16.isObjectLiteralExpression(initializer)) {
+  if (Node17.isObjectLiteralExpression(initializer)) {
     for (const member of initializer.getProperties()) {
-      if (Node16.isPropertyAssignment(member) || Node16.isShorthandPropertyAssignment(member) || Node16.isMethodDeclaration(member)) {
+      if (Node17.isPropertyAssignment(member) || Node17.isShorthandPropertyAssignment(member) || Node17.isMethodDeclaration(member)) {
         const nameNode = member.getNameNode();
         if (nameNode) {
           keys.push(nameNode.getText());
         }
       }
     }
-  } else if (Node16.isArrayLiteralExpression(initializer)) {
+  } else if (Node17.isArrayLiteralExpression(initializer)) {
     for (const element of initializer.getElements()) {
-      if (Node16.isObjectLiteralExpression(element)) {
+      if (Node17.isObjectLiteralExpression(element)) {
         const tokenProp = element.getProperty("token");
-        if (tokenProp && Node16.isPropertyAssignment(tokenProp)) {
+        if (tokenProp && Node17.isPropertyAssignment(tokenProp)) {
           const tokenInit = tokenProp.getInitializer();
-          if (tokenInit && (Node16.isStringLiteral(tokenInit) || Node16.isIdentifier(tokenInit))) {
+          if (tokenInit && (Node17.isStringLiteral(tokenInit) || Node17.isIdentifier(tokenInit))) {
             keys.push(tokenInit.getText().replaceAll(/^['"]|['"]$/g, ""));
           }
         }
@@ -23011,7 +24072,7 @@ function computeRelativeSpecifiers(source) {
 // packages/dbx-components-mcp/src/tools/route/load-sources.ts
 var TRY_EXTENSIONS = [".ts", ".tsx", "/index.ts", "/index.tsx"];
 async function loadRouteSources(args) {
-  const cwdResolved = args.cwd ? resolve22(process.cwd(), args.cwd) : process.cwd();
+  const cwdResolved = args.cwd ? resolve24(process.cwd(), args.cwd) : process.cwd();
   guardCwdInsideServer(args.cwd, cwdResolved);
   const collected = /* @__PURE__ */ new Map();
   if (args.sources) {
@@ -23083,21 +24144,21 @@ async function loadOne(relative13, cwd, into) {
   if (into.has(relative13)) {
     return;
   }
-  const absolute = resolve22(cwd, relative13);
+  const absolute = resolve24(cwd, relative13);
   const cwdPrefix = cwd.endsWith(sep5) ? cwd : cwd + sep5;
   if (!absolute.startsWith(cwdPrefix) && absolute !== cwd) {
     throw new Error(`Path \`${relative13}\` resolves outside the server cwd and is not allowed.`);
   }
-  const text = await readFile9(absolute, "utf8");
+  const text = await readFile11(absolute, "utf8");
   into.set(relative13, { name: relative13, text });
 }
 async function resolveRelativeImport(fromFile, specifier, cwd) {
   if (!specifier.startsWith(".")) {
     return void 0;
   }
-  const fromAbsolute = isAbsolute7(fromFile) ? fromFile : resolve22(cwd, fromFile);
+  const fromAbsolute = isAbsolute7(fromFile) ? fromFile : resolve24(cwd, fromFile);
   const fromDir = dirname7(fromAbsolute);
-  const baseAbsolute = resolve22(fromDir, specifier);
+  const baseAbsolute = resolve24(fromDir, specifier);
   const cwdPrefix = cwd.endsWith(sep5) ? cwd : cwd + sep5;
   for (const ext of TRY_EXTENSIONS) {
     const candidateAbsolute = baseAbsolute + ext;
@@ -23108,7 +24169,7 @@ async function resolveRelativeImport(fromFile, specifier, cwd) {
     if (!exists) {
       continue;
     }
-    const text = await readFile9(candidateAbsolute, "utf8");
+    const text = await readFile11(candidateAbsolute, "utf8");
     const relativeName = candidateAbsolute.startsWith(cwdPrefix) ? candidateAbsolute.slice(cwdPrefix.length) : candidateAbsolute;
     const result = { name: relativeName, text };
     return result;
@@ -23476,8 +24537,8 @@ var DBX_ROUTE_TREE_TOOL = {
     }
   }
 };
-var TreeArgsType = type40({
-  "sources?": type40({ name: "string", text: "string" }).array(),
+var TreeArgsType2 = type42({
+  "sources?": type42({ name: "string", text: "string" }).array(),
   "paths?": "string[]",
   "glob?": "string",
   "format?": "'markdown' | 'json' | 'flat'",
@@ -23485,8 +24546,8 @@ var TreeArgsType = type40({
   "cwd?": "string"
 });
 function parseArgs4(raw) {
-  const parsed = TreeArgsType(raw);
-  if (parsed instanceof type40.errors) {
+  const parsed = TreeArgsType2(raw);
+  if (parsed instanceof type42.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const result = {
@@ -23536,7 +24597,7 @@ var routeTreeTool = {
 };
 
 // packages/dbx-components-mcp/src/tools/route-lookup.tool.ts
-import { type as type41 } from "arktype";
+import { type as type43 } from "arktype";
 var DBX_ROUTE_LOOKUP_TOOL = {
   name: "dbx_route_lookup",
   description: ["Look up a single UIRouter state by name, full URL, or component class name. Returns the state's URL, component, parent chain, params, resolves, siblings, and children.", "", "Provide at least one of `sources` / `paths` / `glob` to point the tool at the source set, plus a `topic`.", "", "Resolution order: exact state name \u2192 URL path \u2192 component class name \u2192 fuzzy substring (returns up to 5 candidates)."].join("\n"),
@@ -23561,9 +24622,9 @@ var DBX_ROUTE_LOOKUP_TOOL = {
     required: ["topic"]
   }
 };
-var LookupArgsType2 = type41({
+var LookupArgsType2 = type43({
   topic: "string",
-  "sources?": type41({ name: "string", text: "string" }).array(),
+  "sources?": type43({ name: "string", text: "string" }).array(),
   "paths?": "string[]",
   "glob?": "string",
   "depth?": "'brief' | 'full'",
@@ -23571,7 +24632,7 @@ var LookupArgsType2 = type41({
 });
 function parseArgs5(raw) {
   const parsed = LookupArgsType2(raw);
-  if (parsed instanceof type41.errors) {
+  if (parsed instanceof type43.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const result = {
@@ -23764,7 +24825,7 @@ var routeLookupTool = {
 };
 
 // packages/dbx-components-mcp/src/tools/route-search.tool.ts
-import { type as type42 } from "arktype";
+import { type as type44 } from "arktype";
 var DBX_ROUTE_SEARCH_TOOL = {
   name: "dbx_route_search",
   description: ["Search the UIRouter state tree of a dbx-components app. Matches against state names, full URLs, component class names, resolve keys, and source-file paths. Returns the top 10 results with state name, URL, component, and source location.", "", "Provide at least one of `sources` / `paths` / `glob` plus a `query`. `scope` narrows to a single axis (`name`, `url`, `component`, `resolve`)."].join("\n"),
@@ -23788,17 +24849,17 @@ var DBX_ROUTE_SEARCH_TOOL = {
     required: ["query"]
   }
 };
-var SearchArgsType2 = type42({
+var SearchArgsType3 = type44({
   query: "string",
-  "sources?": type42({ name: "string", text: "string" }).array(),
+  "sources?": type44({ name: "string", text: "string" }).array(),
   "paths?": "string[]",
   "glob?": "string",
   "scope?": "'name' | 'url' | 'component' | 'resolve' | 'all'",
   "cwd?": "string"
 });
 function parseArgs6(raw) {
-  const parsed = SearchArgsType2(raw);
-  if (parsed instanceof type42.errors) {
+  const parsed = SearchArgsType3(raw);
+  if (parsed instanceof type44.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const result = {
@@ -23891,14 +24952,14 @@ var routeSearchTool = {
 };
 
 // packages/dbx-components-mcp/src/tools/_lookup.factory.ts
-import { type as type43 } from "arktype";
-var LOOKUP_ARGS_TYPE = type43({
+import { type as type45 } from "arktype";
+var LOOKUP_ARGS_TYPE = type45({
   topic: "string",
   "depth?": "'brief' | 'full'"
 });
 function parseLookupArgs(raw) {
   const parsed = LOOKUP_ARGS_TYPE(raw);
-  if (parsed instanceof type43.errors) {
+  if (parsed instanceof type45.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const result = {
@@ -24100,7 +25161,7 @@ function createLookupFilterTool(input) {
 }
 
 // packages/dbx-components-mcp/src/tools/filter-scaffold.tool.ts
-import { type as type44 } from "arktype";
+import { type as type46 } from "arktype";
 var DBX_FILTER_SCAFFOLD_TOOL = {
   name: "dbx_filter_scaffold",
   description: [
@@ -24125,7 +25186,7 @@ var DBX_FILTER_SCAFFOLD_TOOL = {
     required: ["model_name", "filter_type"]
   }
 };
-var ScaffoldArgsType5 = type44({
+var ScaffoldArgsType5 = type46({
   model_name: "string",
   filter_type: "string",
   "preset_keys?": "string[]",
@@ -24133,7 +25194,7 @@ var ScaffoldArgsType5 = type44({
 });
 function parseArgs7(raw) {
   const parsed = ScaffoldArgsType5(raw);
-  if (parsed instanceof type44.errors) {
+  if (parsed instanceof type46.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const modelName = parsed.model_name.trim();
@@ -24373,8 +25434,8 @@ function createLookupPipeTool(input) {
 
 // packages/dbx-components-mcp/src/tools/artifact-scaffold.tool.ts
 import { access } from "node:fs/promises";
-import { resolve as resolve23, sep as sep6 } from "node:path";
-import { type as type45 } from "arktype";
+import { resolve as resolve25, sep as sep6 } from "node:path";
+import { type as type47 } from "arktype";
 
 // packages/dbx-components-mcp/src/tools/artifact-scaffold/templates.ts
 function splitWords(input) {
@@ -24922,7 +25983,7 @@ var DBX_ARTIFACT_SCAFFOLD_TOOL = {
     required: ["artifact", "name", "componentDir", "apiDir"]
   }
 };
-var ScaffoldArtifactArgsType = type45({
+var ScaffoldArtifactArgsType = type47({
   artifact: ARTIFACT_KIND_LITERAL_UNION,
   name: "string",
   componentDir: "string",
@@ -24935,7 +25996,7 @@ var ScaffoldArtifactArgsType = type45({
 });
 function parseArgs8(raw) {
   const parsed = ScaffoldArtifactArgsType(raw);
-  if (parsed instanceof type45.errors) {
+  if (parsed instanceof type47.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const result = {
@@ -24948,7 +26009,7 @@ function parseArgs8(raw) {
   return result;
 }
 function ensureInsideCwd(relativePath, cwd) {
-  const absolute = resolve23(cwd, relativePath);
+  const absolute = resolve25(cwd, relativePath);
   const cwdPrefix = cwd.endsWith(sep6) ? cwd : cwd + sep6;
   if (!absolute.startsWith(cwdPrefix) && absolute !== cwd) {
     throw new Error(`Path \`${relativePath}\` resolves outside the server cwd and is not allowed.`);
@@ -24988,7 +26049,7 @@ async function runArtifactScaffold(rawArgs) {
     const message = err instanceof Error ? err.message : String(err);
     return toolError(`Scaffold failed: ${message}`);
   }
-  const checked = await applyIdempotency(raw, (relativePath) => fileExists2(resolve23(cwd, relativePath)));
+  const checked = await applyIdempotency(raw, (relativePath) => fileExists2(resolve25(cwd, relativePath)));
   const text = formatResult9(checked);
   const result = {
     content: [{ type: "text", text }]
@@ -25001,7 +26062,7 @@ var artifactScaffoldTool = {
 };
 
 // packages/dbx-components-mcp/src/tools/artifact-file-convention.tool.ts
-import { type as type46 } from "arktype";
+import { type as type48 } from "arktype";
 
 // packages/dbx-components-mcp/src/tools/artifact-file-convention/spec.ts
 var FIRESTORE_MODEL = {
@@ -25437,7 +26498,7 @@ var DBX_ARTIFACT_FILE_CONVENTION_TOOL = {
     required: ["artifact"]
   }
 };
-var FileConventionArgsType = type46({
+var FileConventionArgsType = type48({
   artifact: ARTIFACT_KIND_LITERAL_UNION2,
   "componentDir?": "string",
   "apiDir?": "string",
@@ -25445,7 +26506,7 @@ var FileConventionArgsType = type46({
 });
 function parseArgs9(raw) {
   const parsed = FileConventionArgsType(raw);
-  if (parsed instanceof type46.errors) {
+  if (parsed instanceof type48.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const result = {
@@ -25478,12 +26539,12 @@ var artifactFileConventionTool = {
 };
 
 // packages/dbx-components-mcp/src/tools/explain-rule.tool.ts
-import { type as type47 } from "arktype";
-var ExplainRuleArgsType = type47({
+import { type as type49 } from "arktype";
+var ExplainRuleArgsType = type49({
   code: "string",
   "format?": "'markdown' | 'json'"
 });
-var TOOL6 = {
+var TOOL8 = {
   name: "dbx_explain_rule",
   description: [
     "Explain one validation rule by code. Returns the title, severity, source tool, what it flags, when it applies, when it does NOT apply, canonical fix, optional fix template, and any see-also references.",
@@ -25506,9 +26567,9 @@ var TOOL6 = {
     required: ["code"]
   }
 };
-async function run5(rawArgs) {
+async function run7(rawArgs) {
   const parsed = ExplainRuleArgsType(rawArgs);
-  if (parsed instanceof type47.errors) {
+  if (parsed instanceof type49.errors) {
     return toolError(`Invalid arguments: ${parsed.summary}`);
   }
   const exact = findRule(parsed.code);
@@ -25530,24 +26591,26 @@ async function run5(rawArgs) {
   const result = { content: [{ type: "text", text }], isError: true };
   return result;
 }
-var explainRuleTool = { definition: TOOL6, run: run5 };
+var explainRuleTool = { definition: TOOL8, run: run7 };
 
 // packages/dbx-components-mcp/src/tools/app-validate.tool.ts
-import { resolve as resolve24, join as join9 } from "node:path";
+import { resolve as resolve26, join as join10 } from "node:path";
 import { readdir as readdir6, stat as stat9 } from "node:fs/promises";
-import { type as type48 } from "arktype";
+import { type as type50 } from "arktype";
 var Cluster = "'storagefile_m' | 'notification_m' | 'model_folder' | 'system_m' | 'fixture'";
-var AppValidateArgsType = type48({
+var AppValidateArgsType = type50({
   componentDir: "string",
   apiDir: "string",
   "format?": "'markdown' | 'json'",
   "skip?": `(${Cluster})[]`
 });
-var TOOL7 = {
+var TOOL9 = {
   name: "dbx_app_validate",
   description: [
     "Aggregate validator for a downstream `-firebase` component + API app pair. Runs every per-domain validator (`storagefile_m`, `notification_m`, model-folder, `system_m`, fixture) and returns one severity-grouped report.",
     "",
+    "The `model_folder` cluster includes both folder-structure findings (canonical 5-file layout) and per-file content findings forwarded from `dbx_model_validate` \u2014 including the JSDoc-tag rules (`MODEL_IDENTITY_NOT_TAGGED`, `MODEL_GROUP_INTERFACE_MISSING_TAG`, `MODEL_INTERFACE_MISSING_TAG`) that flag downstream apps where `firestoreModelIdentity(...)` calls lack catalog tagging.",
+    "",
     "Replaces the six-tool dance an agent runs to validate one app end-to-end. Each finding is tagged with its source cluster, code, file/line, and canonical-fix line (when the rule catalog has an entry).",
     "",
     "Inputs:",
@@ -25573,9 +26636,9 @@ var TOOL7 = {
     required: ["componentDir", "apiDir"]
   }
 };
-async function run6(rawArgs) {
+async function run8(rawArgs) {
   const parsed = AppValidateArgsType(rawArgs);
-  if (parsed instanceof type48.errors) {
+  if (parsed instanceof type50.errors) {
     return toolError(`Invalid arguments: ${parsed.summary}`);
   }
   const cwd = process.cwd();
@@ -25585,8 +26648,8 @@ async function run6(rawArgs) {
   } catch (err) {
     return toolError(err instanceof Error ? err.message : String(err));
   }
-  const componentAbs = resolve24(cwd, parsed.componentDir);
-  const apiAbs = resolve24(cwd, parsed.apiDir);
+  const componentAbs = resolve26(cwd, parsed.componentDir);
+  const apiAbs = resolve26(cwd, parsed.apiDir);
   const skip = new Set(parsed.skip ?? []);
   const findings = [];
   const skipped = [];
@@ -25658,7 +26721,7 @@ async function runModelFolders(ctx) {
     return;
   }
   try {
-    const modelRoot = join9(ctx.componentAbs, "src/lib/model");
+    const modelRoot = join10(ctx.componentAbs, "src/lib/model");
     const reservedNames = new Set(RESERVED_MODEL_FOLDERS.map((r) => r.name));
     let entries;
     try {
@@ -25675,7 +26738,7 @@ async function runModelFolders(ctx) {
     for (const entry of entries) {
       if (!entry.isDirectory()) continue;
       if (reservedNames.has(entry.name)) continue;
-      const inspection = await inspectFolder(join9(modelRoot, entry.name));
+      const inspection = await inspectFolder(join10(modelRoot, entry.name));
       inspections.push(inspection);
     }
     if (inspections.length === 0) {
@@ -25695,7 +26758,7 @@ async function runSystemFolder(ctx) {
     ctx.skipped.push("system_m");
     return;
   }
-  const systemPath = join9(ctx.componentAbs, "src/lib/model/system");
+  const systemPath = join10(ctx.componentAbs, "src/lib/model/system");
   try {
     let exists = true;
     try {
@@ -25781,21 +26844,21 @@ function renderFinding(finding) {
 function formatJson(report) {
   return JSON.stringify(report, null, 2);
 }
-var appValidateTool = { definition: TOOL7, run: run6 };
+var appValidateTool = { definition: TOOL9, run: run8 };
 
 // packages/dbx-components-mcp/src/tools/model-list-component.tool.ts
-import { resolve as resolve25 } from "node:path";
-import { type as type49 } from "arktype";
+import { resolve as resolve27 } from "node:path";
+import { type as type51 } from "arktype";
 
 // packages/dbx-components-mcp/src/tools/model-list-component/extract.ts
-import { readdir as readdir7, readFile as readFile10, stat as stat10 } from "node:fs/promises";
-import { basename as basename6, join as join10, relative as relative6, sep as sep7 } from "node:path";
-import { Node as Node17, Project as Project12 } from "ts-morph";
+import { readdir as readdir7, readFile as readFile12, stat as stat10 } from "node:fs/promises";
+import { basename as basename6, join as join11, relative as relative6, sep as sep7 } from "node:path";
+import { Node as Node18, Project as Project13 } from "ts-morph";
 var MODEL_SUBPATH2 = "src/lib/model";
 var MODEL_SUBPATH_PREFIX = `${MODEL_SUBPATH2}/`;
 var RESERVED_NAMES = RESERVED_MODEL_FOLDERS.map((r) => r.name);
 async function extractComponentModels(componentAbs) {
-  const modelRoot = join10(componentAbs, MODEL_SUBPATH2);
+  const modelRoot = join11(componentAbs, MODEL_SUBPATH2);
   const folders = await listFolders(modelRoot);
   if (folders === void 0) {
     const result2 = { modelRoot, models: [], skipped: [], unidentifiedFolders: [] };
@@ -25819,7 +26882,7 @@ async function extractComponentModels(componentAbs) {
     skipReservedFolders: RESERVED_NAMES
   });
   const richByFolder = groupRichByFolder(richResult.models);
-  const fallbackProject = new Project12({ useInMemoryFileSystem: true });
+  const fallbackProject = new Project13({ useInMemoryFileSystem: true });
   const models = [];
   const unidentified = [];
   for (const folder of targetFolders) {
@@ -25885,7 +26948,7 @@ function projectRich(model, folder) {
 }
 async function fallbackForFolder(input) {
   const { modelRoot, componentAbs, folder, project } = input;
-  const folderAbs = join10(modelRoot, folder);
+  const folderAbs = join11(modelRoot, folder);
   const mainFile = await readMainFile(folderAbs, folder);
   if (mainFile === void 0) return void 0;
   const sourceFile = project.createSourceFile(mainFile.fileName, mainFile.text, { overwrite: true });
@@ -25919,9 +26982,9 @@ async function listFolders(modelRoot) {
   return out;
 }
 async function readMainFile(folderAbs, folder) {
-  const candidate = join10(folderAbs, `${folder}.ts`);
+  const candidate = join11(folderAbs, `${folder}.ts`);
   try {
-    const text = await readFile10(candidate, "utf8");
+    const text = await readFile12(candidate, "utf8");
     return { absPath: candidate, fileName: basename6(candidate), text };
   } catch {
     return void 0;
@@ -25931,7 +26994,7 @@ function findIdentityIn(sourceFile) {
   for (const statement of sourceFile.getVariableStatements()) {
     for (const decl of statement.getDeclarations()) {
       const initializer = decl.getInitializer();
-      if (!initializer || !Node17.isCallExpression(initializer)) continue;
+      if (!initializer || !Node18.isCallExpression(initializer)) continue;
       if (initializer.getExpression().getText() !== "firestoreModelIdentity") continue;
       const args = initializer.getArguments();
       const parsed = parseIdentityArgs2(args);
@@ -25951,13 +27014,13 @@ function parseIdentityArgs2(args) {
     return { parentIdentityRef: void 0, collectionName: stringLiteralValue3(args[0]), collectionPrefix: stringLiteralValue3(args[1]) };
   }
   if (args.length === 3) {
-    const parent = Node17.isIdentifier(args[0]) ? args[0].getText() : void 0;
+    const parent = Node18.isIdentifier(args[0]) ? args[0].getText() : void 0;
     return { parentIdentityRef: parent, collectionName: stringLiteralValue3(args[1]), collectionPrefix: stringLiteralValue3(args[2]) };
   }
   return { parentIdentityRef: void 0, collectionName: void 0, collectionPrefix: void 0 };
 }
 function stringLiteralValue3(node) {
-  if (Node17.isStringLiteral(node) || Node17.isNoSubstitutionTemplateLiteral(node)) {
+  if (Node18.isStringLiteral(node) || Node18.isNoSubstitutionTemplateLiteral(node)) {
     return node.getLiteralText();
   }
   return void 0;
@@ -26060,12 +27123,12 @@ function stripCoverage(model) {
 }
 
 // packages/dbx-components-mcp/src/tools/model-list-component.tool.ts
-var ListArgsType2 = type49({
+var ListArgsType2 = type51({
   componentDir: "string",
   "apiDir?": "string",
   "format?": "'markdown' | 'json'"
 });
-var TOOL8 = {
+var TOOL10 = {
   name: "dbx_model_list_component",
   description: [
     "List every Firestore model declared in a downstream `-firebase` component package, with optional fixture-coverage annotation when an API app is also supplied.",
@@ -26089,9 +27152,9 @@ var TOOL8 = {
     required: ["componentDir"]
   }
 };
-async function run7(rawArgs) {
+async function run9(rawArgs) {
   const parsed = ListArgsType2(rawArgs);
-  if (parsed instanceof type49.errors) {
+  if (parsed instanceof type51.errors) {
     return toolError(`Invalid arguments: ${parsed.summary}`);
   }
   const cwd = process.cwd();
@@ -26101,8 +27164,8 @@ async function run7(rawArgs) {
   } catch (err) {
     return toolError(err instanceof Error ? err.message : String(err));
   }
-  const componentAbs = resolve25(cwd, parsed.componentDir);
-  const apiAbs = parsed.apiDir ? resolve25(cwd, parsed.apiDir) : void 0;
+  const componentAbs = resolve27(cwd, parsed.componentDir);
+  const apiAbs = parsed.apiDir ? resolve27(cwd, parsed.apiDir) : void 0;
   let report;
   try {
     report = await listComponentModels(componentAbs, { componentDir: parsed.componentDir, apiDir: parsed.apiDir, apiAbs });
@@ -26113,26 +27176,26 @@ async function run7(rawArgs) {
   const result = { content: [{ type: "text", text }] };
   return result;
 }
-var modelListComponentTool = { definition: TOOL8, run: run7 };
+var modelListComponentTool = { definition: TOOL10, run: run9 };
 
 // packages/dbx-components-mcp/src/tools/server-actions-list-app.tool.ts
-import { resolve as resolve26 } from "node:path";
-import { type as type50 } from "arktype";
+import { resolve as resolve28 } from "node:path";
+import { type as type52 } from "arktype";
 
 // packages/dbx-components-mcp/src/tools/server-actions-list-app/extract.ts
-import { readdir as readdir8, readFile as readFile11, stat as stat11 } from "node:fs/promises";
-import { dirname as dirname8, join as join11, relative as relative7, sep as sep8 } from "node:path";
-import { Node as Node18, Project as Project13 } from "ts-morph";
+import { readdir as readdir8, readFile as readFile13, stat as stat11 } from "node:fs/promises";
+import { dirname as dirname8, join as join12, relative as relative7, sep as sep8 } from "node:path";
+import { Node as Node19, Project as Project14 } from "ts-morph";
 var ACTION_SERVER_SUFFIX = ".action.server.ts";
 var COMMON_MODEL_SUBPATH = "src/app/common/model";
 var COMMON_BARREL_REL = "src/app/common/index.ts";
 async function extractServerActions(apiAbs, apiRel) {
-  const modelRoot = join11(apiAbs, COMMON_MODEL_SUBPATH);
+  const modelRoot = join12(apiAbs, COMMON_MODEL_SUBPATH);
   const actionFiles = await collectActionFiles(modelRoot);
   if (actionFiles.length === 0) {
     return { modelRoot, entries: [], fixtureStatus: "ok" };
   }
-  const project = new Project13({ useInMemoryFileSystem: true });
+  const project = new Project14({ useInMemoryFileSystem: true });
   const commonBarrelExports = await readCommonBarrelExports(apiAbs);
   const fixtureCoverageMap = /* @__PURE__ */ new Map();
   let fixtureStatus = "ok";
@@ -26147,7 +27210,7 @@ async function extractServerActions(apiAbs, apiRel) {
   }
   const entries = [];
   for (const filePath of actionFiles) {
-    const text = await readFile11(filePath, "utf8");
+    const text = await readFile13(filePath, "utf8");
     const sourceFile = project.createSourceFile(filePath, text, { overwrite: true });
     const classes = findServerActionClasses(sourceFile);
     for (const className of classes) {
@@ -26187,7 +27250,7 @@ async function collectActionFiles(root) {
       continue;
     }
     for (const entry of entries) {
-      const full = join11(current, entry.name);
+      const full = join12(current, entry.name);
       if (entry.isDirectory()) {
         stack.push(full);
         continue;
@@ -26236,7 +27299,7 @@ async function findModuleCandidates(actionFilePath) {
     for (const entry of entries) {
       if (!entry.isFile()) continue;
       if (!entry.name.endsWith(".module.ts")) continue;
-      out.push(join11(dir, entry.name));
+      out.push(join12(dir, entry.name));
     }
   } catch {
   }
@@ -26245,13 +27308,13 @@ async function findModuleCandidates(actionFilePath) {
 }
 async function safeRead(path) {
   try {
-    return await readFile11(path, "utf8");
+    return await readFile13(path, "utf8");
   } catch {
     return void 0;
   }
 }
 function inspectModuleText(input) {
-  const project = new Project13({ useInMemoryFileSystem: true });
+  const project = new Project14({ useInMemoryFileSystem: true });
   const sourceFile = project.createSourceFile("module.ts", input.text, { overwrite: true });
   let providedByModule = false;
   let exportedByModule = false;
@@ -26259,7 +27322,7 @@ function inspectModuleText(input) {
     for (const decorator of cls.getDecorators()) {
       if (decorator.getName() !== "Module") continue;
       const args = decorator.getArguments();
-      if (args.length === 0 || !Node18.isObjectLiteralExpression(args[0])) continue;
+      if (args.length === 0 || !Node19.isObjectLiteralExpression(args[0])) continue;
       const obj = args[0];
       providedByModule ||= moduleArrayContains(obj, "providers", input.className);
       exportedByModule ||= moduleArrayContains(obj, "exports", input.className);
@@ -26269,26 +27332,26 @@ function inspectModuleText(input) {
 }
 function moduleArrayContains(decoratorArg, propertyName, className) {
   const property = decoratorArg.getProperty(propertyName);
-  if (!property || !Node18.isPropertyAssignment(property)) return false;
+  if (!property || !Node19.isPropertyAssignment(property)) return false;
   const initializer = property.getInitializer();
-  if (!initializer || !Node18.isArrayLiteralExpression(initializer)) return false;
+  if (!initializer || !Node19.isArrayLiteralExpression(initializer)) return false;
   for (const element of initializer.getElements()) {
-    if (Node18.isIdentifier(element) && element.getText() === className) return true;
-    if (Node18.isObjectLiteralExpression(element)) {
+    if (Node19.isIdentifier(element) && element.getText() === className) return true;
+    if (Node19.isObjectLiteralExpression(element)) {
       const provideProp = element.getProperty("provide");
-      if (provideProp && Node18.isPropertyAssignment(provideProp)) {
+      if (provideProp && Node19.isPropertyAssignment(provideProp)) {
         const provideInit = provideProp.getInitializer();
-        if (provideInit && Node18.isIdentifier(provideInit) && provideInit.getText() === className) return true;
+        if (provideInit && Node19.isIdentifier(provideInit) && provideInit.getText() === className) return true;
       }
     }
   }
   return false;
 }
 async function readCommonBarrelExports(apiAbs) {
-  const path = join11(apiAbs, COMMON_BARREL_REL);
+  const path = join12(apiAbs, COMMON_BARREL_REL);
   const text = await safeRead(path);
   if (text === void 0) return /* @__PURE__ */ new Set();
-  const project = new Project13({ useInMemoryFileSystem: true });
+  const project = new Project14({ useInMemoryFileSystem: true });
   const sourceFile = project.createSourceFile(path, text, { overwrite: true });
   const exported = /* @__PURE__ */ new Set();
   for (const decl of sourceFile.getExportDeclarations()) {
@@ -26332,11 +27395,11 @@ function collectInterfaceGetters(sourceFile) {
   const out = /* @__PURE__ */ new Map();
   for (const iface of sourceFile.getInterfaces()) {
     for (const member of iface.getMembers()) {
-      if (Node18.isGetAccessorDeclaration(member)) {
+      if (Node19.isGetAccessorDeclaration(member)) {
         out.set(member.getName(), iface.getName());
         continue;
       }
-      if (Node18.isPropertySignature(member)) {
+      if (Node19.isPropertySignature(member)) {
         out.set(member.getName(), iface.getName());
       }
     }
@@ -26348,7 +27411,7 @@ function collectClassGetters(sourceFile) {
   for (const cls of sourceFile.getClasses()) {
     const set = /* @__PURE__ */ new Set();
     for (const member of cls.getMembers()) {
-      if (Node18.isGetAccessorDeclaration(member)) set.add(member.getName());
+      if (Node19.isGetAccessorDeclaration(member)) set.add(member.getName());
     }
     if (set.size > 0) out.set(cls.getName() ?? "<anon>", set);
   }
@@ -26427,11 +27490,11 @@ async function listAppServerActions(apiAbs, options) {
 }
 
 // packages/dbx-components-mcp/src/tools/server-actions-list-app.tool.ts
-var ListArgsType3 = type50({
+var ListArgsType3 = type52({
   apiDir: "string",
   "format?": "'markdown' | 'json'"
 });
-var TOOL9 = {
+var TOOL11 = {
   name: "dbx_server_actions_list_app",
   description: [
     "List every `*ServerActions` abstract class declared in an API app, with NestJS module wiring, common-barrel export status, and test-fixture coverage.",
@@ -26454,9 +27517,9 @@ var TOOL9 = {
     required: ["apiDir"]
   }
 };
-async function run8(rawArgs) {
+async function run10(rawArgs) {
   const parsed = ListArgsType3(rawArgs);
-  if (parsed instanceof type50.errors) {
+  if (parsed instanceof type52.errors) {
     return toolError(`Invalid arguments: ${parsed.summary}`);
   }
   const cwd = process.cwd();
@@ -26465,7 +27528,7 @@ async function run8(rawArgs) {
   } catch (err) {
     return toolError(err instanceof Error ? err.message : String(err));
   }
-  const apiAbs = resolve26(cwd, parsed.apiDir);
+  const apiAbs = resolve28(cwd, parsed.apiDir);
   let report;
   try {
     report = await listAppServerActions(apiAbs, { apiDir: parsed.apiDir });
@@ -26476,19 +27539,19 @@ async function run8(rawArgs) {
   const result = { content: [{ type: "text", text }] };
   return result;
 }
-var serverActionsListAppTool = { definition: TOOL9, run: run8 };
+var serverActionsListAppTool = { definition: TOOL11, run: run10 };
 
 // packages/dbx-components-mcp/src/tools/mcp-config.tool.ts
-import { type as type57 } from "arktype";
-import { resolve as resolve33 } from "node:path";
+import { type as type59 } from "arktype";
+import { resolve as resolve35 } from "node:path";
 
 // packages/dbx-components-mcp/src/tools/mcp-config/snapshot.ts
-import { dirname as dirname9, isAbsolute as isAbsolute8, relative as relative8, resolve as resolve28 } from "node:path";
+import { dirname as dirname9, isAbsolute as isAbsolute8, relative as relative8, resolve as resolve30 } from "node:path";
 import { stat as stat13 } from "node:fs/promises";
 
 // packages/dbx-components-mcp/src/scan/discover-downstream-packages.ts
-import { glob as fsGlob5, readFile as readFile12, stat as stat12 } from "node:fs/promises";
-import { basename as basename7, join as join12, resolve as resolve27, sep as sep9 } from "node:path";
+import { glob as fsGlob5, readFile as readFile14, stat as stat12 } from "node:fs/promises";
+import { basename as basename7, join as join13, resolve as resolve29, sep as sep9 } from "node:path";
 var COMPONENT_GLOBS = ["components/*-firebase", "components/*-shared", "components/*-web", "components/*-core"];
 var APPS_GLOB = "apps/*";
 var SCAN_CONFIG_FILENAME2 = "dbx-mcp.scan.json";
@@ -26518,7 +27581,7 @@ async function discoverConventionalDirs(workspaceRoot) {
   }
   for await (const match of fsGlob5(APPS_GLOB, { cwd: workspaceRoot })) {
     const rel = match.split(sep9).join("/");
-    if (await fileExists3(join12(workspaceRoot, rel, SCAN_CONFIG_FILENAME2))) {
+    if (await fileExists3(join13(workspaceRoot, rel, SCAN_CONFIG_FILENAME2))) {
       found.add(rel);
     }
   }
@@ -26533,13 +27596,13 @@ function normaliseExplicitDirs(dirs) {
   return result;
 }
 async function inspectPackage2(workspaceRoot, relDir) {
-  const absDir = resolve27(workspaceRoot, relDir);
+  const absDir = resolve29(workspaceRoot, relDir);
   const isDir = await isDirectory2(absDir);
   if (!isDir) return void 0;
   const packageName = await readPackageName2(absDir, relDir);
   const slug = packageNameToSlug(packageName);
-  const hasScanConfig = await fileExists3(join12(absDir, SCAN_CONFIG_FILENAME2));
-  const declaredScanClusters = hasScanConfig ? await readDeclaredClusters(join12(absDir, SCAN_CONFIG_FILENAME2)) : [];
+  const hasScanConfig = await fileExists3(join13(absDir, SCAN_CONFIG_FILENAME2));
+  const declaredScanClusters = hasScanConfig ? await readDeclaredClusters(join13(absDir, SCAN_CONFIG_FILENAME2)) : [];
   const heuristicClusters = await detectCandidateClusters(absDir);
   const candidateClusters = mergeClusters(heuristicClusters, declaredScanClusters);
   return {
@@ -26572,7 +27635,7 @@ async function readPackageName2(absDir, relDir) {
   const fallback = basename7(relDir);
   let result = fallback;
   try {
-    const text = await readFile12(join12(absDir, PACKAGE_JSON2), "utf8");
+    const text = await readFile14(join13(absDir, PACKAGE_JSON2), "utf8");
     const parsed = JSON.parse(text);
     if (typeof parsed.name === "string" && parsed.name.length > 0) {
       result = parsed.name;
@@ -26587,7 +27650,7 @@ function packageNameToSlug(packageName) {
 async function readDeclaredClusters(scanConfigPath) {
   let parsed = null;
   try {
-    const text = await readFile12(scanConfigPath, "utf8");
+    const text = await readFile14(scanConfigPath, "utf8");
     parsed = JSON.parse(text);
   } catch {
     parsed = null;
@@ -26664,7 +27727,7 @@ async function collectRegisteredSources(config, configBaseDir, workspaceRoot) {
   for (const cluster of DOWNSTREAM_CLUSTERS) {
     const declared = config[cluster]?.sources ?? [];
     for (const declaredPath of declared) {
-      const absolutePath = isAbsolute8(declaredPath) ? declaredPath : resolve28(configBaseDir, declaredPath);
+      const absolutePath = isAbsolute8(declaredPath) ? declaredPath : resolve30(configBaseDir, declaredPath);
       const exists = await fileExists4(absolutePath);
       const relativePath = relativeOrAbsolute(workspaceRoot, absolutePath);
       out.push({ cluster, declaredPath, absolutePath, relativePath, exists });
@@ -26702,21 +27765,21 @@ function relativeOrAbsolute(from, target) {
 
 // packages/dbx-components-mcp/src/tools/mcp-config/init.ts
 import { writeFile as nodeWriteFile3, mkdir as nodeMkdir, readFile as nodeReadFile7 } from "node:fs/promises";
-import { dirname as dirname10, relative as relative9, resolve as resolve29 } from "node:path";
+import { dirname as dirname10, relative as relative9, resolve as resolve31 } from "node:path";
 var HEURISTIC_CLUSTERS = ["uiComponents", "forgeFields", "pipes", "actions", "filters"];
 var DEFAULT_INCLUDE = ["src/**/*.ts"];
 var DEFAULT_EXCLUDE = ["**/*.spec.ts", "**/*.test.ts", "**/*.stories.ts"];
 async function buildInitPlan(input) {
   const { snapshot } = input;
-  const readFile13 = input.readFile ?? defaultReadFile2;
+  const readFile15 = input.readFile ?? defaultReadFile2;
   const changes = [];
   const sourcesToRegister = [];
   for (const ps of snapshot.packages) {
-    const planResult = await planPackageScanConfig({ snapshot, packageSnapshot: ps, readFile: readFile13 });
+    const planResult = await planPackageScanConfig({ snapshot, packageSnapshot: ps, readFile: readFile15 });
     if (planResult.change !== void 0) changes.push(planResult.change);
     for (const reg of planResult.sourcesToRegister) sourcesToRegister.push(reg);
   }
-  const configChange = await planRootConfig({ snapshot, sourcesToRegister, readFile: readFile13 });
+  const configChange = await planRootConfig({ snapshot, sourcesToRegister, readFile: readFile15 });
   if (configChange !== void 0) changes.push(configChange);
   return { workspaceRoot: snapshot.workspaceRoot, changes };
 }
@@ -26730,10 +27793,10 @@ async function applyInitPlan(plan, opts) {
   }
 }
 async function planPackageScanConfig(input) {
-  const { snapshot, packageSnapshot, readFile: readFile13 } = input;
+  const { snapshot, packageSnapshot, readFile: readFile15 } = input;
   const { pkg } = packageSnapshot;
-  const scanConfigPath = resolve29(pkg.absDir, "dbx-mcp.scan.json");
-  const before = await tryRead(scanConfigPath, readFile13);
+  const scanConfigPath = resolve31(pkg.absDir, "dbx-mcp.scan.json");
+  const before = await tryRead(scanConfigPath, readFile15);
   const parsed = parseExisting(before);
   const targetClusters = HEURISTIC_CLUSTERS.filter((c) => pkg.candidateClusters.includes(c));
   if (targetClusters.length === 0 && parsed === null) {
@@ -26775,9 +27838,9 @@ async function planPackageScanConfig(input) {
   return { change, sourcesToRegister };
 }
 async function planRootConfig(input) {
-  const { snapshot, sourcesToRegister, readFile: readFile13 } = input;
-  const configPath = snapshot.configPath ?? resolve29(snapshot.workspaceRoot, "dbx-mcp.config.json");
-  const before = snapshot.configPath !== null ? await tryRead(configPath, readFile13) : null;
+  const { snapshot, sourcesToRegister, readFile: readFile15 } = input;
+  const configPath = snapshot.configPath ?? resolve31(snapshot.workspaceRoot, "dbx-mcp.config.json");
+  const before = snapshot.configPath !== null ? await tryRead(configPath, readFile15) : null;
   const baseConfig = snapshot.config !== null ? cloneConfig(snapshot.config) : { version: 1 };
   if (baseConfig.version !== 1) baseConfig.version = 1;
   let mutated = false;
@@ -26805,11 +27868,11 @@ async function planRootConfig(input) {
   };
 }
 function defaultOutFor(input) {
-  const targetAbs = resolve29(input.snapshot.workspaceRoot, ".tmp/dbx-mcp", `${input.slug}.${input.cluster}.json`);
+  const targetAbs = resolve31(input.snapshot.workspaceRoot, ".tmp/dbx-mcp", `${input.slug}.${input.cluster}.json`);
   return relative9(dirname10(input.scanConfigPath), targetAbs).split("\\").join("/");
 }
 function resolveScanOut(scanConfigPath, out) {
-  return resolve29(dirname10(scanConfigPath), out);
+  return resolve31(dirname10(scanConfigPath), out);
 }
 function relativeFromConfig(snapshot, absolute) {
   const configDir = snapshot.configPath !== null ? dirname10(snapshot.configPath) : snapshot.workspaceRoot;
@@ -26842,9 +27905,9 @@ function cloneConfig(config) {
   }
   return out;
 }
-async function tryRead(path, readFile13) {
+async function tryRead(path, readFile15) {
   try {
-    return await readFile13(path);
+    return await readFile15(path);
   } catch {
     return null;
   }
@@ -26856,12 +27919,12 @@ var defaultMkdir = async (dir) => {
 };
 
 // packages/dbx-components-mcp/src/scan/actions-build-manifest.ts
-import { relative as relative10, resolve as resolve30 } from "node:path";
-import { type as type52 } from "arktype";
-import { Project as Project14 } from "ts-morph";
+import { relative as relative10, resolve as resolve32 } from "node:path";
+import { type as type54 } from "arktype";
+import { Project as Project15 } from "ts-morph";
 
 // packages/dbx-components-mcp/src/scan/actions-extract.ts
-import { Node as Node19, SyntaxKind as SyntaxKind11 } from "ts-morph";
+import { Node as Node20, SyntaxKind as SyntaxKind12 } from "ts-morph";
 var ACTION_MARKER = "dbxAction";
 var ACTION_SLUG_TAG = "dbxActionSlug";
 var ACTION_ROLE_TAG = "dbxActionRole";
@@ -27069,7 +28132,7 @@ function filterStates(values) {
 }
 function readEnumMemberLiteral(member) {
   const initializer = member.getInitializer();
-  if (initializer !== void 0 && (Node19.isStringLiteral(initializer) || Node19.isNoSubstitutionTemplateLiteral(initializer))) {
+  if (initializer !== void 0 && (Node20.isStringLiteral(initializer) || Node20.isNoSubstitutionTemplateLiteral(initializer))) {
     return initializer.getLiteralText();
   }
   return member.getName();
@@ -27141,7 +28204,7 @@ function extractStoreObservables(decl) {
   return out;
 }
 function isVisibleMethod(method) {
-  if (method.hasModifier(SyntaxKind11.PrivateKeyword) || method.hasModifier(SyntaxKind11.ProtectedKeyword)) {
+  if (method.hasModifier(SyntaxKind12.PrivateKeyword) || method.hasModifier(SyntaxKind12.ProtectedKeyword)) {
     return false;
   }
   const name = method.getName();
@@ -27160,15 +28223,15 @@ function readMethodDescription(method) {
 }
 
 // packages/dbx-components-mcp/src/scan/actions-scan-config-schema.ts
-import { type as type51 } from "arktype";
-var ActionsScanSection = type51({
+import { type as type53 } from "arktype";
+var ActionsScanSection = type53({
   "source?": "string",
   "module?": "string",
   include: "string[] >= 1",
   "exclude?": "string[]",
   "out?": "string"
 });
-var ActionsScanConfig = type51({
+var ActionsScanConfig = type53({
   version: "1",
   actions: ActionsScanSection
 });
@@ -27179,20 +28242,20 @@ var ACTIONS_SCAN_CONFIG_FILENAME = "dbx-mcp.scan.json";
 var DEFAULT_READ_FILE9 = defaultReadFile;
 var DEFAULT_GLOBBER4 = defaultGlobber;
 async function buildActionsManifest(input) {
-  const { projectRoot, generator, readFile: readFile13 = DEFAULT_READ_FILE9, globber = DEFAULT_GLOBBER4, now = () => /* @__PURE__ */ new Date() } = input;
-  const configPath = resolve30(projectRoot, ACTIONS_SCAN_CONFIG_FILENAME);
-  const packagePath = resolve30(projectRoot, "package.json");
-  const configOutcome = await loadScanConfig4(configPath, readFile13);
+  const { projectRoot, generator, readFile: readFile15 = DEFAULT_READ_FILE9, globber = DEFAULT_GLOBBER4, now = () => /* @__PURE__ */ new Date() } = input;
+  const configPath = resolve32(projectRoot, ACTIONS_SCAN_CONFIG_FILENAME);
+  const packagePath = resolve32(projectRoot, "package.json");
+  const configOutcome = await loadScanConfig4(configPath, readFile15);
   if (configOutcome.kind !== "ok") return configOutcome.outcome;
   const scanSection = configOutcome.section;
-  const packageOutcome = await loadPackageName(packagePath, readFile13);
+  const packageOutcome = await loadPackageName(packagePath, readFile15);
   if (packageOutcome.kind !== "ok") return packageOutcome.outcome;
   const packageName = packageOutcome.packageName;
   const filePaths = await globber({ projectRoot, include: scanSection.include, exclude: scanSection.exclude ?? [] });
-  const project = new Project14({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project15({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   for (const relPath of filePaths) {
-    const absolute = resolve30(projectRoot, relPath);
-    const text = await readFile13(absolute);
+    const absolute = resolve32(projectRoot, relPath);
+    const text = await readFile15(absolute);
     project.createSourceFile(absolute, text, { overwrite: true });
   }
   const extractResult = extractActionEntries({ project });
@@ -27209,10 +28272,10 @@ async function buildActionsManifest(input) {
   };
   const validated = ActionManifest(manifest);
   let outcome;
-  if (validated instanceof type52.errors) {
+  if (validated instanceof type54.errors) {
     outcome = { kind: "invalid-manifest", error: validated.summary };
   } else {
-    const outPath = resolve30(projectRoot, scanSection.out ?? DEFAULT_ACTIONS_SCAN_OUT_PATH);
+    const outPath = resolve32(projectRoot, scanSection.out ?? DEFAULT_ACTIONS_SCAN_OUT_PATH);
     outcome = {
       kind: "success",
       manifest: validated,
@@ -27223,10 +28286,10 @@ async function buildActionsManifest(input) {
   }
   return outcome;
 }
-async function loadScanConfig4(configPath, readFile13) {
+async function loadScanConfig4(configPath, readFile15) {
   let raw = null;
   try {
-    raw = await readFile13(configPath);
+    raw = await readFile15(configPath);
   } catch {
     raw = null;
   }
@@ -27243,7 +28306,7 @@ async function loadScanConfig4(configPath, readFile13) {
     }
     if (parseError === null) {
       const validated = ActionsScanConfig(parsed);
-      if (validated instanceof type52.errors) {
+      if (validated instanceof type54.errors) {
         result = { kind: "fail", outcome: { kind: "invalid-scan-config", configPath, error: validated.summary } };
       } else {
         result = { kind: "ok", section: validated.actions };
@@ -27374,9 +28437,9 @@ function formatExtractWarning3(warning) {
 }
 
 // packages/dbx-components-mcp/src/scan/filters-build-manifest.ts
-import { relative as relative11, resolve as resolve31 } from "node:path";
-import { type as type54 } from "arktype";
-import { Project as Project15 } from "ts-morph";
+import { relative as relative11, resolve as resolve33 } from "node:path";
+import { type as type56 } from "arktype";
+import { Project as Project16 } from "ts-morph";
 
 // packages/dbx-components-mcp/src/scan/filters-extract.ts
 var FILTER_MARKER = "dbxFilter";
@@ -27568,15 +28631,15 @@ function extractOutputs3(decl) {
 }
 
 // packages/dbx-components-mcp/src/scan/filters-scan-config-schema.ts
-import { type as type53 } from "arktype";
-var FiltersScanSection = type53({
+import { type as type55 } from "arktype";
+var FiltersScanSection = type55({
   "source?": "string",
   "module?": "string",
   include: "string[] >= 1",
   "exclude?": "string[]",
   "out?": "string"
 });
-var FiltersScanConfig = type53({
+var FiltersScanConfig = type55({
   version: "1",
   filters: FiltersScanSection
 });
@@ -27587,15 +28650,15 @@ var FILTERS_SCAN_CONFIG_FILENAME = "dbx-mcp.scan.json";
 var DEFAULT_READ_FILE10 = defaultReadFile;
 var DEFAULT_GLOBBER5 = defaultGlobber;
 async function buildFiltersManifest(input) {
-  const { projectRoot, generator, readFile: readFile13 = DEFAULT_READ_FILE10, globber = DEFAULT_GLOBBER5, now = () => /* @__PURE__ */ new Date() } = input;
-  const configPath = resolve31(projectRoot, FILTERS_SCAN_CONFIG_FILENAME);
-  const packagePath = resolve31(projectRoot, "package.json");
-  const configOutcome = await loadScanConfig5(configPath, readFile13);
+  const { projectRoot, generator, readFile: readFile15 = DEFAULT_READ_FILE10, globber = DEFAULT_GLOBBER5, now = () => /* @__PURE__ */ new Date() } = input;
+  const configPath = resolve33(projectRoot, FILTERS_SCAN_CONFIG_FILENAME);
+  const packagePath = resolve33(projectRoot, "package.json");
+  const configOutcome = await loadScanConfig5(configPath, readFile15);
   if (configOutcome.kind !== "ok") {
     return configOutcome.outcome;
   }
   const scanSection = configOutcome.section;
-  const packageOutcome = await loadPackageName(packagePath, readFile13);
+  const packageOutcome = await loadPackageName(packagePath, readFile15);
   if (packageOutcome.kind !== "ok") {
     return packageOutcome.outcome;
   }
@@ -27605,10 +28668,10 @@ async function buildFiltersManifest(input) {
     include: scanSection.include,
     exclude: scanSection.exclude ?? []
   });
-  const project = new Project15({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project16({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   for (const relPath of filePaths) {
-    const absolute = resolve31(projectRoot, relPath);
-    const text = await readFile13(absolute);
+    const absolute = resolve33(projectRoot, relPath);
+    const text = await readFile15(absolute);
     project.createSourceFile(absolute, text, { overwrite: true });
   }
   const extractResult = extractFilterEntries({ project });
@@ -27625,10 +28688,10 @@ async function buildFiltersManifest(input) {
   };
   const validated = FilterManifest(manifest);
   let outcome;
-  if (validated instanceof type54.errors) {
+  if (validated instanceof type56.errors) {
     outcome = { kind: "invalid-manifest", error: validated.summary };
   } else {
-    const outPath = resolve31(projectRoot, scanSection.out ?? DEFAULT_FILTERS_SCAN_OUT_PATH);
+    const outPath = resolve33(projectRoot, scanSection.out ?? DEFAULT_FILTERS_SCAN_OUT_PATH);
     outcome = {
       kind: "success",
       manifest: validated,
@@ -27639,10 +28702,10 @@ async function buildFiltersManifest(input) {
   }
   return outcome;
 }
-async function loadScanConfig5(configPath, readFile13) {
+async function loadScanConfig5(configPath, readFile15) {
   let raw = null;
   try {
-    raw = await readFile13(configPath);
+    raw = await readFile15(configPath);
   } catch {
     raw = null;
   }
@@ -27659,7 +28722,7 @@ async function loadScanConfig5(configPath, readFile13) {
     }
     if (parseError === null) {
       const validated = FiltersScanConfig(parsed);
-      if (validated instanceof type54.errors) {
+      if (validated instanceof type56.errors) {
         result = { kind: "fail", outcome: { kind: "invalid-scan-config", configPath, error: validated.summary } };
       } else {
         result = { kind: "ok", section: validated.filters };
@@ -27752,12 +28815,12 @@ function formatExtractWarning4(warning) {
 }
 
 // packages/dbx-components-mcp/src/scan/pipes-build-manifest.ts
-import { relative as relative12, resolve as resolve32 } from "node:path";
-import { type as type56 } from "arktype";
-import { Project as Project16 } from "ts-morph";
+import { relative as relative12, resolve as resolve34 } from "node:path";
+import { type as type58 } from "arktype";
+import { Project as Project17 } from "ts-morph";
 
 // packages/dbx-components-mcp/src/scan/pipes-extract.ts
-import { Node as Node20 } from "ts-morph";
+import { Node as Node21 } from "ts-morph";
 var PIPE_MARKER = "dbxPipe";
 var PIPE_SLUG_TAG = "dbxPipeSlug";
 var PIPE_CATEGORY_TAG = "dbxPipeCategory";
@@ -27950,7 +29013,7 @@ function readPipeDecoratorConfig(decorator) {
     return void 0;
   }
   const firstArg = args[0];
-  if (!Node20.isObjectLiteralExpression(firstArg)) {
+  if (!Node21.isObjectLiteralExpression(firstArg)) {
     return void 0;
   }
   const name = readStringProperty(firstArg, "name");
@@ -27963,7 +29026,7 @@ function readPipeDecoratorConfig(decorator) {
 }
 function readBooleanProperty(obj, propName) {
   const prop = obj.getProperty(propName);
-  if (prop === void 0 || !Node20.isPropertyAssignment(prop)) {
+  if (prop === void 0 || !Node21.isPropertyAssignment(prop)) {
     return void 0;
   }
   const initializer = prop.getInitializer();
@@ -27989,10 +29052,10 @@ function readTransformSignature(method, fallbackParamDescriptions) {
   for (let i = 1; i < params.length; i += 1) {
     const param = params[i];
     const name = param.getName();
-    const type60 = readParamType(param);
+    const type62 = readParamType(param);
     const description = methodParamDescriptions.get(name) ?? fallbackParamDescriptions.get(name) ?? "";
     const required = !param.isOptional() && !param.hasInitializer();
-    args.push({ name, type: type60, description, required });
+    args.push({ name, type: type62, description, required });
   }
   return { inputType, outputType, args };
 }
@@ -28029,15 +29092,15 @@ function extractParamName(rawTag) {
 }
 
 // packages/dbx-components-mcp/src/scan/pipes-scan-config-schema.ts
-import { type as type55 } from "arktype";
-var PipesScanSection = type55({
+import { type as type57 } from "arktype";
+var PipesScanSection = type57({
   "source?": "string",
   "module?": "string",
   include: "string[] >= 1",
   "exclude?": "string[]",
   "out?": "string"
 });
-var PipesScanConfig = type55({
+var PipesScanConfig = type57({
   version: "1",
   pipes: PipesScanSection
 });
@@ -28048,15 +29111,15 @@ var PIPES_SCAN_CONFIG_FILENAME = "dbx-mcp.scan.json";
 var DEFAULT_READ_FILE11 = defaultReadFile;
 var DEFAULT_GLOBBER6 = defaultGlobber;
 async function buildPipesManifest(input) {
-  const { projectRoot, generator, readFile: readFile13 = DEFAULT_READ_FILE11, globber = DEFAULT_GLOBBER6, now = () => /* @__PURE__ */ new Date() } = input;
-  const configPath = resolve32(projectRoot, PIPES_SCAN_CONFIG_FILENAME);
-  const packagePath = resolve32(projectRoot, "package.json");
-  const configOutcome = await loadScanConfig6(configPath, readFile13);
+  const { projectRoot, generator, readFile: readFile15 = DEFAULT_READ_FILE11, globber = DEFAULT_GLOBBER6, now = () => /* @__PURE__ */ new Date() } = input;
+  const configPath = resolve34(projectRoot, PIPES_SCAN_CONFIG_FILENAME);
+  const packagePath = resolve34(projectRoot, "package.json");
+  const configOutcome = await loadScanConfig6(configPath, readFile15);
   if (configOutcome.kind !== "ok") {
     return configOutcome.outcome;
   }
   const scanSection = configOutcome.section;
-  const packageOutcome = await loadPackageName(packagePath, readFile13);
+  const packageOutcome = await loadPackageName(packagePath, readFile15);
   if (packageOutcome.kind !== "ok") {
     return packageOutcome.outcome;
   }
@@ -28066,10 +29129,10 @@ async function buildPipesManifest(input) {
     include: scanSection.include,
     exclude: scanSection.exclude ?? []
   });
-  const project = new Project16({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project17({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   for (const relPath of filePaths) {
-    const absolute = resolve32(projectRoot, relPath);
-    const text = await readFile13(absolute);
+    const absolute = resolve34(projectRoot, relPath);
+    const text = await readFile15(absolute);
     project.createSourceFile(absolute, text, { overwrite: true });
   }
   const extractResult = extractPipeEntries({ project });
@@ -28086,10 +29149,10 @@ async function buildPipesManifest(input) {
   };
   const validated = PipeManifest(manifest);
   let outcome;
-  if (validated instanceof type56.errors) {
+  if (validated instanceof type58.errors) {
     outcome = { kind: "invalid-manifest", error: validated.summary };
   } else {
-    const outPath = resolve32(projectRoot, scanSection.out ?? DEFAULT_PIPES_SCAN_OUT_PATH);
+    const outPath = resolve34(projectRoot, scanSection.out ?? DEFAULT_PIPES_SCAN_OUT_PATH);
     outcome = {
       kind: "success",
       manifest: validated,
@@ -28100,10 +29163,10 @@ async function buildPipesManifest(input) {
   }
   return outcome;
 }
-async function loadScanConfig6(configPath, readFile13) {
+async function loadScanConfig6(configPath, readFile15) {
   let raw = null;
   try {
-    raw = await readFile13(configPath);
+    raw = await readFile15(configPath);
   } catch {
     raw = null;
   }
@@ -28120,7 +29183,7 @@ async function loadScanConfig6(configPath, readFile13) {
     }
     if (parseError === null) {
       const validated = PipesScanConfig(parsed);
-      if (validated instanceof type56.errors) {
+      if (validated instanceof type58.errors) {
         result = { kind: "fail", outcome: { kind: "invalid-scan-config", configPath, error: validated.summary } };
       } else {
         result = { kind: "ok", section: validated.pipes };
@@ -28468,7 +29531,7 @@ function hasUnregisteredCandidates(snapshot) {
 }
 
 // packages/dbx-components-mcp/src/tools/mcp-config.tool.ts
-var TOOL10 = {
+var TOOL12 = {
   name: "dbx_mcp_config",
   description: [
     "Inspect, validate, and configure the dbx-mcp downstream-manifest pipeline for a workspace.",
@@ -28512,7 +29575,7 @@ var TOOL10 = {
     required: ["op"]
   }
 };
-var McpConfigArgsType = type57({
+var McpConfigArgsType = type59({
   op: "'status' | 'validate' | 'init' | 'refresh'",
   "cwd?": "string",
   "dryRun?": "boolean",
@@ -28520,12 +29583,12 @@ var McpConfigArgsType = type57({
 });
 function parseArgs10(rawArgs, defaultCwd) {
   const parsed = McpConfigArgsType(rawArgs);
-  if (parsed instanceof type57.errors) {
+  if (parsed instanceof type59.errors) {
     return `Invalid arguments: ${parsed.summary}`;
   }
   let workspaceRoot = defaultCwd;
   if (parsed.cwd !== void 0 && parsed.cwd.length > 0) {
-    workspaceRoot = resolve33(defaultCwd, parsed.cwd);
+    workspaceRoot = resolve35(defaultCwd, parsed.cwd);
   }
   if (parsed.explicitDirs !== void 0) {
     for (const dir of parsed.explicitDirs) {
@@ -28543,7 +29606,7 @@ function parseArgs10(rawArgs, defaultCwd) {
     explicitDirs: parsed.explicitDirs
   };
 }
-async function run9(rawArgs) {
+async function run11(rawArgs) {
   const parsed = parseArgs10(rawArgs, process.cwd());
   if (typeof parsed === "string") return toolError(parsed);
   const snapshot = await buildSnapshot({ workspaceRoot: parsed.workspaceRoot, explicitDirs: parsed.explicitDirs });
@@ -28572,12 +29635,12 @@ async function run9(rawArgs) {
   }
 }
 var mcpConfigTool = {
-  definition: TOOL10,
-  run: run9
+  definition: TOOL12,
+  run: run11
 };
 
 // packages/dbx-components-mcp/src/tools/lookup-semantic-type.tool.ts
-import { type as type58 } from "arktype";
+import { type as type60 } from "arktype";
 
 // packages/dbx-components-mcp/src/tools/semantic-type-lookup.formatter.ts
 function formatSemanticTypeEntry(entry, depth) {
@@ -28758,13 +29821,13 @@ var DBX_SEMANTIC_TYPE_LOOKUP_TOOL = {
     required: ["name"]
   }
 };
-var LookupSemanticTypeArgsType = type58({
+var LookupSemanticTypeArgsType = type60({
   name: "string",
   "depth?": "'brief' | 'full'"
 });
 function parseLookupArgs2(raw) {
   const parsed = LookupSemanticTypeArgsType(raw);
-  if (parsed instanceof type58.errors) {
+  if (parsed instanceof type60.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const result = {
@@ -28775,7 +29838,7 @@ function parseLookupArgs2(raw) {
 }
 function createSemanticTypeLookupTool(config) {
   const { registry } = config;
-  function run10(rawArgs) {
+  function run12(rawArgs) {
     let args;
     let result;
     try {
@@ -28811,7 +29874,7 @@ function createSemanticTypeLookupTool(config) {
   }
   const tool = {
     definition: DBX_SEMANTIC_TYPE_LOOKUP_TOOL,
-    run: run10
+    run: run12
   };
   return tool;
 }
@@ -28826,7 +29889,7 @@ function formatNotFound11(name, registry) {
 }
 
 // packages/dbx-components-mcp/src/tools/search-semantic-type.tool.ts
-import { type as type59 } from "arktype";
+import { type as type61 } from "arktype";
 var DEFAULT_LIMIT4 = 25;
 var MAX_LIMIT4 = 100;
 var DBX_SEMANTIC_TYPE_SEARCH_TOOL = {
@@ -28859,7 +29922,7 @@ var DBX_SEMANTIC_TYPE_SEARCH_TOOL = {
     }
   }
 };
-var SearchSemanticTypeArgsType = type59({
+var SearchSemanticTypeArgsType = type61({
   "topic?": "string",
   "baseType?": "string",
   "package?": "string",
@@ -28868,7 +29931,7 @@ var SearchSemanticTypeArgsType = type59({
 });
 function parseSearchArgs2(raw) {
   const parsed = SearchSemanticTypeArgsType(raw);
-  if (parsed instanceof type59.errors) {
+  if (parsed instanceof type61.errors) {
     throw new TypeError(`Invalid arguments: ${parsed.summary}`);
   }
   const rawLimit = parsed.limit ?? DEFAULT_LIMIT4;
@@ -28894,7 +29957,7 @@ function nonEmpty(value) {
 }
 function createSemanticTypeSearchTool(config) {
   const { registry } = config;
-  function run10(rawArgs) {
+  function run12(rawArgs) {
     let args;
     let result;
     try {
@@ -28907,7 +29970,7 @@ function createSemanticTypeSearchTool(config) {
     if (filterCount === 0) {
       result = toolError("At least one filter (topic, baseType, package, query) must be supplied.");
     } else {
-      const matches = applyFilters(registry, args);
+      const matches = applyFilters3(registry, args);
       const limited = matches.slice(0, args.limit);
       const text = formatSemanticTypeSearchResults({
         query: describeFilters(args),
@@ -28919,11 +29982,11 @@ function createSemanticTypeSearchTool(config) {
   }
   const tool = {
     definition: DBX_SEMANTIC_TYPE_SEARCH_TOOL,
-    run: run10
+    run: run12
   };
   return tool;
 }
-function applyFilters(registry, args) {
+function applyFilters3(registry, args) {
   let candidates;
   if (args.topic !== void 0) {
     candidates = registry.findByTopic(args.topic);
@@ -28997,6 +30060,8 @@ var DBX_TOOLS = [
   modelFixtureLookupTool,
   modelFixtureScaffoldTool,
   modelFixtureForwardTool,
+  modelTestTreeTool,
+  modelTestSearchTool,
   // storagefile_m (model extension)
   storageFileMValidateAppTool,
   storageFileMListAppTool,