@dereekb/dbx-components-mcp 13.11.1 → 13.11.2

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.11.1",
+  version: "13.11.2",
   type: "module",
   bin: {
     "dbx-components-mcp": "dbx-components-mcp.js"
@@ -20,19 +20,20 @@ var package_default = {
     "@angular/core": "21.2.11",
     "@angular/forms": "21.2.11",
     "@angular/material": "^21.2.9",
-    "@dereekb/dbx-core": "13.11.1",
-    "@dereekb/dbx-firebase": "13.11.1",
-    "@dereekb/dbx-form": "13.11.1",
-    "@dereekb/dbx-web": "13.11.1",
-    "@dereekb/firebase": "13.11.1",
-    "@dereekb/firebase-server": "13.11.1",
-    "@dereekb/rxjs": "13.11.1",
-    "@dereekb/util": "13.11.1",
+    "@dereekb/dbx-cli": "13.11.2",
+    "@dereekb/dbx-core": "13.11.2",
+    "@dereekb/dbx-firebase": "13.11.2",
+    "@dereekb/dbx-form": "13.11.2",
+    "@dereekb/dbx-web": "13.11.2",
+    "@dereekb/firebase": "13.11.2",
+    "@dereekb/firebase-server": "13.11.2",
+    "@dereekb/rxjs": "13.11.2",
+    "@dereekb/util": "13.11.2",
     "@uirouter/angular": "21.0.0",
     rxjs: "^7.8.2"
   },
   devDependencies: {
-    "@dereekb/model": "13.11.1"
+    "@dereekb/model": "13.11.2"
   }
 };
 
@@ -6954,12 +6955,17 @@ var DASH_CHARACTER_PREFIX_INSTANCE = characterPrefixSuffixInstance({
   prefix: "-"
 });
 
-// packages/firebase/src/lib/model/storagefile/storagefile.upload.claims.ts
-var STORAGE_FILE_UPLOAD_USER_ROLE = "uploads";
+// packages/firebase/src/lib/common/auth/oidc/oidc.error.ts
+var CALL_MODEL_MISSING_OIDC_SCOPE_ERROR_CODE = "CALL_MODEL_MISSING_OIDC_SCOPE";
 
-// packages/dbx-components-mcp/src/registry/auth-builtin.ts
+// packages/firebase/src/lib/common/auth/oidc/oidc.ts
 var CALL_MODEL_OIDC_SCOPE_PREFIX = "model.";
-var CALL_MODEL_OIDC_SCOPES = ["model.create", "model.read", "model.update", "model.delete", "model.query"];
+var CREATE_MODEL_OIDC_SCOPE = `${CALL_MODEL_OIDC_SCOPE_PREFIX}create`;
+var READ_MODEL_OIDC_SCOPE = `${CALL_MODEL_OIDC_SCOPE_PREFIX}read`;
+var UPDATE_MODEL_OIDC_SCOPE = `${CALL_MODEL_OIDC_SCOPE_PREFIX}update`;
+var DELETE_MODEL_OIDC_SCOPE = `${CALL_MODEL_OIDC_SCOPE_PREFIX}delete`;
+var QUERY_MODEL_OIDC_SCOPE = `${CALL_MODEL_OIDC_SCOPE_PREFIX}query`;
+var CALL_MODEL_OIDC_SCOPES = [CREATE_MODEL_OIDC_SCOPE, READ_MODEL_OIDC_SCOPE, UPDATE_MODEL_OIDC_SCOPE, DELETE_MODEL_OIDC_SCOPE, QUERY_MODEL_OIDC_SCOPE];
 var CALL_MODEL_OIDC_SCOPE_FOR_CALL_TYPE = {
   create: "model.create",
   read: "model.read",
@@ -6967,10 +6973,15 @@ var CALL_MODEL_OIDC_SCOPE_FOR_CALL_TYPE = {
   delete: "model.delete",
   query: "model.query"
 };
-var CALL_MODEL_MISSING_OIDC_SCOPE_ERROR_CODE = "CALL_MODEL_MISSING_OIDC_SCOPE";
+
+// packages/firebase/src/lib/model/storagefile/storagefile.upload.claims.ts
+var STORAGE_FILE_UPLOAD_USER_ROLE = "uploads";
+
+// packages/dbx-components-mcp/src/registry/auth-builtin.ts
 var UTIL_ROLE_PATH = "packages/util/src/lib/auth/auth.role.ts";
 var STORAGE_CLAIM_PATH = "packages/firebase/src/lib/model/storagefile/storagefile.upload.claims.ts";
-var OIDC_SCOPE_PATH = "packages/firebase-server/oidc/src/lib/scope.ts";
+var OIDC_SCOPE_PATH = "packages/firebase/src/lib/common/auth/oidc/oidc.ts";
+var OIDC_SCOPE_PRE_ASSERT_PATH = "packages/firebase-server/oidc/src/lib/scope.ts";
 var DEMO_CLAIMS_PATH = "components/demo-firebase/src/lib/auth/claims.ts";
 var BUILTIN_AUTH_ROLES = [
   {
@@ -7046,15 +7057,15 @@ var BUILTIN_AUTH_SCOPES = CALL_MODEL_OIDC_SCOPES.map((scope) => {
     description: `Required OIDC scope for the \`callModel\` ${callType ?? "CRUD"} verb.`,
     enforcedAt: [
       {
-        path: OIDC_SCOPE_PATH,
-        line: 76,
+        path: OIDC_SCOPE_PRE_ASSERT_PATH,
+        line: 21,
         description: "`oidcCallModelScopePreAssert` rejects requests that lack this scope."
       }
     ],
     errorCode: CALL_MODEL_MISSING_OIDC_SCOPE_ERROR_CODE,
     source: "system",
     sourcePath: OIDC_SCOPE_PATH,
-    sourceLine: 20,
+    sourceLine: 30,
     apps: []
   };
   return result;
@@ -7589,7 +7600,7 @@ function composeRegistry(input) {
   for (const app of extractResult.apps) {
     apps.push(toAuthAppInfo({ extracted: app, cwd, inheritedClaimsByInterface, allBuiltinScopes: builtinScopes }));
   }
-  const loadedSources = ["builtin:@dereekb/util", "builtin:@dereekb/firebase", "builtin:@dereekb/firebase-server/oidc", ...scannedRelFiles.map((rel) => `workspace:${rel}`)];
+  const loadedSources = ["builtin:@dereekb/util", "builtin:@dereekb/firebase", ...scannedRelFiles.map((rel) => `workspace:${rel}`)];
   return createAuthRegistryFromEntries({
     roles: builtinRoles,
     claims,
@@ -18482,7 +18493,7 @@ import { type as type37 } from "arktype";
 import { readdir as readdir2, readFile as readFile4, stat as stat4 } from "node:fs/promises";
 import { join as join4, relative as relative4, sep as sep5 } from "node:path";
 
-// packages/dbx-components-mcp/src/tools/model-api-shared/extract-crud.ts
+// packages/dbx-cli/manifest-extract/src/lib/extract-crud.ts
 import { Node as Node12, Project as Project6 } from "ts-morph";
 var SUPPORTED_VERBS = /* @__PURE__ */ new Set(["create", "read", "update", "delete", "query"]);
 function extractCrudEntries(source) {
@@ -18490,11 +18501,26 @@ function extractCrudEntries(source) {
   const sourceFile = project.createSourceFile(source.name, source.text, { overwrite: true });
   const entries = [];
   const modelKeys = [];
-  const crudConfigType = findCrudConfigType2(sourceFile);
+  const crudConfigType = findTypeAliasByEnding(sourceFile, "ModelCrudFunctionsConfig");
   const groupName = inferGroupName2(sourceFile);
+  const functionsClassName = findFunctionsClassName(sourceFile);
+  const typeDocsCache = /* @__PURE__ */ new Map();
+  const resolveTypeDocs = (typeName) => {
+    if (!typeName) {
+      return void 0;
+    }
+    if (typeDocsCache.has(typeName)) {
+      return typeDocsCache.get(typeName);
+    }
+    const docs = readTypeDocs(sourceFile, typeName);
+    if (docs) {
+      typeDocsCache.set(typeName, docs);
+    }
+    return docs;
+  };
   if (crudConfigType) {
-    const literal = crudConfigType.typeNode;
-    if (Node12.isTypeLiteral(literal)) {
+    const literal = crudConfigType.getTypeNode();
+    if (literal && Node12.isTypeLiteral(literal)) {
       for (const member of literal.getMembers()) {
         if (!Node12.isPropertySignature(member)) {
           continue;
@@ -18522,16 +18548,16 @@ function extractCrudEntries(source) {
             if (!verbValueNode) {
               continue;
             }
-            collectVerbEntries({ modelName, verb, valueNode: verbValueNode, entries });
+            collectVerbEntries({ modelName, verb, valueNode: verbValueNode, entries, fallbackDescription: readJsDocSummary(verbMember), resolveTypeDocs });
           }
         }
       }
     }
   }
-  const functionTypeMap = findFunctionTypeMap2(sourceFile);
+  const functionTypeMap = findTypeAliasByEnding(sourceFile, "FunctionTypeMap");
   if (functionTypeMap) {
-    const literal = functionTypeMap.typeNode;
-    if (Node12.isTypeLiteral(literal)) {
+    const literal = functionTypeMap.getTypeNode();
+    if (literal && Node12.isTypeLiteral(literal)) {
       for (const member of literal.getMembers()) {
         if (!Node12.isPropertySignature(member)) {
           continue;
@@ -18539,37 +18565,42 @@ function extractCrudEntries(source) {
         const key = member.getName();
         const valueNode = member.getTypeNode();
         const tuple = valueNode ? readTupleParamsResult(valueNode) : void 0;
+        const paramsDocs = resolveTypeDocs(tuple?.params);
+        const resultDocs = resolveTypeDocs(tuple?.result);
         entries.push({
           model: key,
           verb: "standalone",
           specifier: void 0,
           paramsTypeName: tuple?.params,
           resultTypeName: tuple?.result,
-          line: member.getStartLineNumber()
+          line: member.getStartLineNumber(),
+          description: readJsDocSummary(member),
+          paramsTypeDescription: paramsDocs?.typeDescription,
+          paramsFields: paramsDocs?.fields,
+          resultTypeDescription: resultDocs?.typeDescription,
+          resultFields: resultDocs?.fields
         });
       }
     }
   }
-  return { groupName, modelKeys, entries };
+  return { groupName, modelKeys, entries, functionsClassName };
 }
-function findCrudConfigType2(sourceFile) {
+function findTypeAliasByEnding(sourceFile, ending) {
   for (const alias of sourceFile.getTypeAliases()) {
-    if (alias.getName().endsWith("ModelCrudFunctionsConfig")) {
-      const typeNode = alias.getTypeNode();
-      if (typeNode) {
-        return { typeNode };
-      }
+    if (alias.getName().endsWith(ending) && alias.getTypeNode()) {
+      return alias;
     }
   }
   return void 0;
 }
-function findFunctionTypeMap2(sourceFile) {
-  for (const alias of sourceFile.getTypeAliases()) {
-    if (alias.getName().endsWith("FunctionTypeMap")) {
-      const typeNode = alias.getTypeNode();
-      if (typeNode) {
-        return { typeNode };
-      }
+function findFunctionsClassName(sourceFile) {
+  for (const cls of sourceFile.getClasses()) {
+    if (!cls.isAbstract()) {
+      continue;
+    }
+    const name = cls.getName();
+    if (name?.endsWith("Functions")) {
+      return name;
     }
   }
   return void 0;
@@ -18605,7 +18636,7 @@ function isNullLiteralType2(node) {
   return false;
 }
 function collectVerbEntries(input) {
-  const { modelName, verb, valueNode, entries } = input;
+  const { modelName, verb, valueNode, entries, fallbackDescription, resolveTypeDocs } = input;
   if (Node12.isTypeLiteral(valueNode)) {
     for (const specMember of valueNode.getMembers()) {
       if (!Node12.isPropertySignature(specMember)) {
@@ -18614,25 +18645,39 @@ function collectVerbEntries(input) {
       const specifier = specMember.getName();
       const leafNode = specMember.getTypeNode();
       const leaf2 = leafNode ? readTupleParamsResult(leafNode) ?? readBareParams(leafNode) : void 0;
+      const paramsDocs2 = resolveTypeDocs(leaf2?.params);
+      const resultDocs2 = resolveTypeDocs(leaf2?.result);
       entries.push({
         model: modelName,
         verb,
         specifier,
         paramsTypeName: leaf2?.params,
         resultTypeName: leaf2?.result,
-        line: specMember.getStartLineNumber()
+        line: specMember.getStartLineNumber(),
+        description: readJsDocSummary(specMember),
+        paramsTypeDescription: paramsDocs2?.typeDescription,
+        paramsFields: paramsDocs2?.fields,
+        resultTypeDescription: resultDocs2?.typeDescription,
+        resultFields: resultDocs2?.fields
       });
     }
     return;
   }
   const leaf = readTupleParamsResult(valueNode) ?? readBareParams(valueNode);
+  const paramsDocs = resolveTypeDocs(leaf?.params);
+  const resultDocs = resolveTypeDocs(leaf?.result);
   entries.push({
     model: modelName,
     verb,
     specifier: void 0,
     paramsTypeName: leaf?.params,
     resultTypeName: leaf?.result,
-    line: valueNode.getStartLineNumber()
+    line: valueNode.getStartLineNumber(),
+    description: fallbackDescription,
+    paramsTypeDescription: paramsDocs?.typeDescription,
+    paramsFields: paramsDocs?.fields,
+    resultTypeDescription: resultDocs?.typeDescription,
+    resultFields: resultDocs?.fields
   });
 }
 function readTupleParamsResult(node) {
@@ -18661,6 +18706,40 @@ function typeNodeName(node) {
   const text = node.getText().trim();
   return text.length > 0 ? text : void 0;
 }
+function readTypeDocs(sourceFile, typeName) {
+  const interfaceDecl = sourceFile.getInterface(typeName);
+  if (interfaceDecl) {
+    const typeDescription = readJsDocSummary(interfaceDecl);
+    const fields = [];
+    for (const property of interfaceDecl.getProperties()) {
+      const fieldName = property.getName();
+      const description = readJsDocSummary(property);
+      const typeNode = property.getTypeNode();
+      const typeText = typeNode?.getText().trim() ?? "";
+      const field = description ? { name: fieldName, typeText, description } : { name: fieldName, typeText };
+      fields.push(field);
+    }
+    if (!typeDescription && fields.length === 0) {
+      return void 0;
+    }
+    return { typeDescription, fields: fields.length > 0 ? fields : void 0 };
+  }
+  const typeAlias = sourceFile.getTypeAlias(typeName);
+  if (typeAlias) {
+    const typeDescription = readJsDocSummary(typeAlias);
+    return typeDescription ? { typeDescription } : void 0;
+  }
+  return void 0;
+}
+function readJsDocSummary(node) {
+  const docs = node.getJsDocs();
+  if (docs.length === 0) {
+    return void 0;
+  }
+  const last = docs[docs.length - 1];
+  const description = last.getDescription().trim();
+  return description.length > 0 ? description : void 0;
+}
 
 // packages/dbx-components-mcp/src/tools/model-api-list-app/extract.ts
 var API_SUFFIX = ".api.ts";
@@ -18781,6 +18860,12 @@ function formatReportAsMarkdown(report) {
       lines.push(formatEntryRow(entry));
     }
     lines.push("");
+    const described = fileEntries.filter((entry) => entry.description !== void 0 && entry.description.length > 0);
+    if (described.length > 0) {
+      for (const entry of described) {
+        lines.push(formatEntryDescription(entry), "");
+      }
+    }
   }
   return lines.join("\n");
 }
@@ -18804,6 +18889,14 @@ function formatEntryRow(entry) {
   const result = entry.resultTypeName ? `\`${entry.resultTypeName}\`` : "`void`";
   return `| \`${entry.model}\` | \`${entry.verb}\` | ${specifier} | ${params} | ${result} | ${entry.line} |`;
 }
+function formatEntryDescription(entry) {
+  const heading = entry.specifier !== void 0 ? `${entry.model}.${entry.verb}.${entry.specifier}` : `${entry.model}.${entry.verb}`;
+  const description = entry.description ?? "";
+  const quoted = description.split("\n").map((line) => `> ${line}`).join("\n");
+  return `**${heading}**
+
+${quoted}`;
+}
 
 // packages/dbx-components-mcp/src/tools/model-api-list-app/index.ts
 async function listAppModelApi(componentAbs, options) {
@@ -18838,6 +18931,8 @@ var TOOL = {
     "- `result` \u2014 the result type name when the leaf is a `[Params, Result]` tuple, else `void`.",
     "- `line` \u2014 source line of the leaf in the `.api.ts` file.",
     "",
+    "When the maintainer added a JSDoc summary to a CRUD property (e.g. on `update.username:` inside `<Group>ModelCrudFunctionsConfig` or on a `<Group>FunctionTypeMap` key), the markdown view renders that description as a block-quote under the table. JSON output exposes the same string on `entry.description`.",
+    "",
     "Inputs:",
     "- `componentDir`: relative path to the firebase-component package (e.g. `components/demo-firebase`).",
     "- `model` (optional): bare model name, e.g. `Profile` \u2014 case-insensitive match against group / model keys.",
@@ -18892,7 +18987,6 @@ import { type as type38 } from "arktype";
 // packages/dbx-components-mcp/src/tools/model-api-lookup/extract.ts
 import { readdir as readdir4, readFile as readFile6, stat as stat6 } from "node:fs/promises";
 import { join as join6, relative as relative6, sep as sep7 } from "node:path";
-import { Project as Project8 } from "ts-morph";
 
 // packages/dbx-components-mcp/src/tools/model-api-lookup/extract-actions.ts
 import { readdir as readdir3, readFile as readFile5, stat as stat5 } from "node:fs/promises";
@@ -19055,9 +19149,6 @@ async function extractApiLookup(input) {
   }
   const crudExtraction = extractCrudEntries({ name: matched.fileRel, text: matched.text });
   const filteredEntries = crudExtraction.entries.filter((entry) => entryMatchesFilter(entry.model, crudExtraction.groupName, input.modelFilter));
-  const project = new Project8({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
-  const sourceFile = project.createSourceFile(matched.fileRel, matched.text, { overwrite: true });
-  const interfaces = collectInterfacesByName(sourceFile);
   let actionLookup;
   let actionLookupStatus;
   if (input.apiAbs) {
@@ -19070,22 +19161,7 @@ async function extractApiLookup(input) {
   } else {
     actionLookupStatus = { kind: "skipped", reason: "apiDir not provided \u2014 action JSDoc skipped." };
   }
-  const enriched = filteredEntries.map((entry) => {
-    const paramsInterface = entry.paramsTypeName ? interfaces.get(entry.paramsTypeName) : void 0;
-    const resultInterface = entry.resultTypeName ? interfaces.get(entry.resultTypeName) : void 0;
-    const action = actionLookup && entry.paramsTypeName ? actionLookup.methodsByParams.get(entry.paramsTypeName) : void 0;
-    const factory = actionLookup && entry.paramsTypeName ? actionLookup.factoriesByParams.get(entry.paramsTypeName) : void 0;
-    return {
-      ...entry,
-      sourceFile: matched.fileRel,
-      paramsJsDoc: paramsInterface ? readInterfaceJsDoc(paramsInterface) : void 0,
-      paramsFields: paramsInterface ? extractInterfaceFields3(paramsInterface) : [],
-      resultJsDoc: resultInterface ? readInterfaceJsDoc(resultInterface) : void 0,
-      resultFields: resultInterface ? extractInterfaceFields3(resultInterface) : [],
-      action,
-      factory
-    };
-  });
+  const enriched = filteredEntries.map((entry) => mapEntry(entry, matched.fileRel, actionLookup));
   return {
     componentDir: input.componentDir,
     apiDir: input.apiDir,
@@ -19097,6 +19173,30 @@ async function extractApiLookup(input) {
     actionLookupStatus
   };
 }
+function mapEntry(entry, sourceFile, actionLookup) {
+  const action = actionLookup && entry.paramsTypeName ? actionLookup.methodsByParams.get(entry.paramsTypeName) : void 0;
+  const factory = actionLookup && entry.paramsTypeName ? actionLookup.factoriesByParams.get(entry.paramsTypeName) : void 0;
+  return {
+    ...entry,
+    sourceFile,
+    paramsJsDoc: entry.paramsTypeDescription,
+    paramsFields: mapDocFields(entry.paramsFields),
+    resultJsDoc: entry.resultTypeDescription,
+    resultFields: mapDocFields(entry.resultFields),
+    action,
+    factory
+  };
+}
+function mapDocFields(fields) {
+  if (!fields) {
+    return [];
+  }
+  return fields.map((field) => ({
+    name: field.name,
+    typeText: field.typeText,
+    jsDoc: field.description
+  }));
+}
 async function collectApiSources(componentAbs) {
   const root = join6(componentAbs, COMPONENT_LIB_SUBPATH);
   const files = [];
@@ -19164,39 +19264,6 @@ function entryMatchesFilter(model, groupName, filter) {
 function normalize2(value) {
   return value.replace(/Identity$/i, "").toLowerCase();
 }
-function collectInterfacesByName(sourceFile) {
-  const out = /* @__PURE__ */ new Map();
-  for (const iface of sourceFile.getInterfaces()) {
-    out.set(iface.getName(), iface);
-  }
-  return out;
-}
-function readInterfaceJsDoc(iface) {
-  const docs = iface.getJsDocs();
-  if (docs.length === 0) return void 0;
-  const last = docs[docs.length - 1];
-  const description = last.getDescription().trim();
-  return description.length > 0 ? description : void 0;
-}
-function extractInterfaceFields3(iface) {
-  const fields = [];
-  for (const prop of iface.getProperties()) {
-    const typeNode = prop.getTypeNode();
-    const docs = prop.getJsDocs();
-    let jsDoc;
-    if (docs.length > 0) {
-      const last = docs[docs.length - 1];
-      const description = last.getDescription().trim();
-      jsDoc = description.length > 0 ? description : void 0;
-    }
-    fields.push({
-      name: prop.getName(),
-      typeText: typeNode ? typeNode.getText() : "",
-      jsDoc
-    });
-  }
-  return fields;
-}
 
 // packages/dbx-components-mcp/src/tools/model-api-lookup/format.ts
 function formatLookupAsMarkdown(report) {
@@ -19240,7 +19307,11 @@ function formatEntry2(entry) {
   const heading = entry.specifier !== void 0 ? `${entry.model}.${entry.verb}.${entry.specifier}` : `${entry.model}.${entry.verb}`;
   const paramsLabel = entry.paramsTypeName ? `\`${entry.paramsTypeName}\`` : "_unresolved_";
   const resultLabel = entry.resultTypeName ? `\`${entry.resultTypeName}\`` : "`void`";
-  const lines = [`## ${heading}`, "", `- Wire key: \`${wireKey}\``, `- Params: ${paramsLabel}`, `- Result: ${resultLabel}`, `- Source: \`${entry.sourceFile}:${entry.line}\``, ""];
+  const lines = [`## ${heading}`, ""];
+  if (entry.description) {
+    lines.push(entry.description, "");
+  }
+  lines.push(`- Wire key: \`${wireKey}\``, `- Params: ${paramsLabel}`, `- Result: ${resultLabel}`, `- Source: \`${entry.sourceFile}:${entry.line}\``, "");
   if (entry.paramsJsDoc || entry.paramsFields.length > 0) {
     lines.push("### Params");
     if (entry.paramsJsDoc) {
@@ -19325,6 +19396,7 @@ var TOOL2 = {
     "Deep lookup for one model declared in a firebase-component package. Returns every CRUD / standalone entry under that model with rich metadata.",
     "",
     "For each entry the tool surfaces:",
+    "- Per-call summary read from the JSDoc on the property in `<Group>ModelCrudFunctionsConfig` / `<Group>FunctionTypeMap`.",
     "- Params + result type names, params/result interface JSDoc, per-field type and doc.",
     "- Action method on the matching `*ServerActions` abstract class (when `apiDir` is provided).",
     "- Action factory function (`<X>Factory`) with its richer JSDoc \u2014 usually the most semantic source.",
@@ -19460,7 +19532,7 @@ async function extractDeclaredEntries(componentAbs) {
 // packages/dbx-components-mcp/src/tools/model-api-validate-app/extract-handlers.ts
 import { readFile as readFile8 } from "node:fs/promises";
 import { join as join8 } from "node:path";
-import { Node as Node13, Project as Project9 } from "ts-morph";
+import { Node as Node13, Project as Project8 } from "ts-morph";
 var HANDLER_MAP_REL = "src/app/function/model/crud.functions.ts";
 var VERB_TOKENS = [
   { token: "Create", verb: "create" },
@@ -19478,7 +19550,7 @@ async function extractHandlerEntries(apiAbs, apiDir) {
   } catch {
     return { path: fullPath, status: { kind: "missing", path: HANDLER_MAP_REL }, entries: [] };
   }
-  const project = new Project9({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project8({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   const sourceFile = project.createSourceFile(sourceFileRel, text, { overwrite: true });
   const entries = [];
   const verbsFound = [];
@@ -20534,7 +20606,7 @@ function paramsHasFixtureDependencies(params) {
 }
 
 // packages/dbx-components-mcp/src/tools/model-fixture-shared/extract.ts
-import { Node as Node14, Project as Project10, SyntaxKind as SyntaxKind7 } from "ts-morph";
+import { Node as Node14, Project as Project9, SyntaxKind as SyntaxKind7 } from "ts-morph";
 
 // packages/dbx-components-mcp/src/tools/model-fixture-shared/framework-fixtures.ts
 var KNOWN_NON_MODEL_FIXTURE_FAMILIES = [
@@ -20564,7 +20636,7 @@ var BASE_CONTEXT_FIXTURE_BASE = "FirebaseAdminNestTestContextFixture";
 var MODEL_FACTORY_NAME = "modelTestContextFactory";
 function extractAppFixturesFromText(input) {
   const { text, fixturePath } = input;
-  const project = new Project10({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project9({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   const sourceFile = project.createSourceFile(FIXTURE_FILE_VIRTUAL_PATH, text, { overwrite: true });
   const prefix = detectPrefix(sourceFile);
   const fixtureClasses = /* @__PURE__ */ new Map();
@@ -22062,7 +22134,7 @@ var modelFixtureScaffoldTool = { definition: TOOL7, run: run6 };
 // packages/dbx-components-mcp/src/tools/model-fixture-forward.tool.ts
 import { join as join12, resolve as resolve29 } from "node:path";
 import { type as type45 } from "arktype";
-import { Project as Project11 } from "ts-morph";
+import { Project as Project10 } from "ts-morph";
 var ForwardArgsType = type45({
   apiDir: "string",
   model: "string",
@@ -22123,7 +22195,7 @@ function toErrorMessage(err) {
   return err instanceof Error ? err.message : String(err);
 }
 async function applyForwardersToFile(absolutePath, fixtureClassName, rendered) {
-  const project = new Project11({ skipAddingFilesFromTsConfig: true });
+  const project = new Project10({ skipAddingFilesFromTsConfig: true });
   let sourceFile;
   try {
     sourceFile = project.addSourceFileAtPath(absolutePath);
@@ -22174,7 +22246,7 @@ import { resolve as resolve30 } from "node:path";
 import { type as type46 } from "arktype";
 
 // packages/dbx-components-mcp/src/tools/model-test-shared/extract.ts
-import { Node as Node15, Project as Project12, SyntaxKind as SyntaxKind8 } from "ts-morph";
+import { Node as Node15, Project as Project11, SyntaxKind as SyntaxKind8 } from "ts-morph";
 var SPEC_FILE_VIRTUAL_PATH = "__spec__/spec.ts";
 var FIXTURE_CONTEXT_SUFFIX = "Context";
 var FIXTURE_FACTORY_SUFFIX = "ContextFactory";
@@ -22187,7 +22259,7 @@ function isItName(name) {
 }
 function extractSpecTreeFromText(input) {
   const { text, specPath } = input;
-  const project = new Project12({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project11({ 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);
@@ -23280,11 +23352,11 @@ var modelHierarchyTool = {
 import { Node as Node17, SyntaxKind as SyntaxKind10 } from "ts-morph";
 
 // packages/dbx-components-mcp/src/tools/_validate/ast.ts
-import { Node as Node16, Project as Project13, SyntaxKind as SyntaxKind9 } from "ts-morph";
+import { Node as Node16, Project as Project12, SyntaxKind as SyntaxKind9 } from "ts-morph";
 var COMPONENT_VIRTUAL_PREFIX = "__component__/";
 var API_VIRTUAL_PREFIX = "__api__/";
 function buildInMemoryProject(input) {
-  const project = new Project13({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project12({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   const componentSources = [];
   const apiSources = [];
   for (const file of input.component.files) {
@@ -26409,14 +26481,14 @@ async function inspectFolder2(path) {
 }
 
 // packages/dbx-components-mcp/src/tools/system-m-validate-folder/extract.ts
-import { Node as Node19, Project as Project14 } from "ts-morph";
+import { Node as Node19, Project as Project13 } 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 Project14({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project13({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   const sourceFile = project.createSourceFile(name, text, { overwrite: true });
   const typeConstants = findTypeConstants(sourceFile);
   const dataInterfaces = findDataInterfaces2(sourceFile);
@@ -26920,7 +26992,7 @@ var systemMValidateFolderTool = createFolderValidateTool({
 });
 
 // packages/dbx-components-mcp/src/tools/dbx-asset-validate-app/extract.ts
-import { Node as Node20, Project as Project15 } from "ts-morph";
+import { Node as Node20, Project as Project14 } from "ts-morph";
 var ASSETS_RELPATH = "src/lib/assets.ts";
 var BARREL_RELPATH = "src/lib/index.ts";
 var LOCAL_ASSET_BUILDER = "localAsset";
@@ -26932,7 +27004,7 @@ var KNOWN_FLUENT_BUILDERS = /* @__PURE__ */ new Set([ASSET_FOLDER_BUILDER, REMOT
 var ASSET_PATH_REF_ARRAY_TYPE = "AssetPathRef[]";
 var BARREL_RE_EXPORT_RE = /export\s*\*\s*from\s*['"]\.\/assets['"]/;
 function extractAppAssets(inspection) {
-  const project = new Project15({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project14({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   const sources = [];
   let assetsFileExists = false;
   let barrelText;
@@ -28966,9 +29038,9 @@ import { glob as fsGlob5, readFile as readFile17, stat as stat13 } from "node:fs
 import { dirname as dirname11, isAbsolute as isAbsolute11, resolve as resolve32, sep as sep11 } from "node:path";
 
 // packages/dbx-components-mcp/src/tools/route/extract.ts
-import { Node as Node21, Project as Project16, SyntaxKind as SyntaxKind12 } from "ts-morph";
+import { Node as Node21, Project as Project15, SyntaxKind as SyntaxKind12 } from "ts-morph";
 function extractFile3(source) {
-  const project = new Project16({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
+  const project = new Project15({ useInMemoryFileSystem: true, skipAddingFilesFromTsConfig: true });
   const sourceFile = project.createSourceFile(source.name, source.text, { overwrite: true });
   const issues = [];
   const objectLiteralsByName = collectStateConsts(sourceFile);
@@ -32343,7 +32415,7 @@ import { type as type62 } from "arktype";
 // packages/dbx-components-mcp/src/tools/model-list-component/extract.ts
 import { readdir as readdir12, readFile as readFile18, stat as stat15 } from "node:fs/promises";
 import { basename as basename6, join as join18, relative as relative10, sep as sep13 } from "node:path";
-import { Node as Node22, Project as Project17 } from "ts-morph";
+import { Node as Node22, Project as Project16 } from "ts-morph";
 var MODEL_SUBPATH3 = "src/lib/model";
 var MODEL_SUBPATH_PREFIX = `${MODEL_SUBPATH3}/`;
 var RESERVED_NAMES = RESERVED_MODEL_FOLDERS.map((r) => r.name);
@@ -32372,7 +32444,7 @@ async function extractComponentModels(componentAbs) {
     skipReservedFolders: RESERVED_NAMES
   });
   const richByFolder = groupRichByFolder(richResult.models);
-  const fallbackProject = new Project17({ useInMemoryFileSystem: true });
+  const fallbackProject = new Project16({ useInMemoryFileSystem: true });
   const models = [];
   const unidentified = [];
   for (const folder of targetFolders) {
@@ -32672,7 +32744,7 @@ import { type as type63 } from "arktype";
 // packages/dbx-components-mcp/src/tools/server-actions-list-app/extract.ts
 import { readdir as readdir13, readFile as readFile19, stat as stat16 } from "node:fs/promises";
 import { dirname as dirname12, join as join19, relative as relative11, sep as sep14 } from "node:path";
-import { Node as Node23, Project as Project18 } from "ts-morph";
+import { Node as Node23, Project as Project17 } from "ts-morph";
 var ACTION_SERVER_SUFFIX2 = ".action.server.ts";
 var COMMON_MODEL_SUBPATH2 = "src/app/common/model";
 var COMMON_BARREL_REL = "src/app/common/index.ts";
@@ -32682,7 +32754,7 @@ async function extractServerActions(apiAbs, apiRel) {
   if (actionFiles.length === 0) {
     return { modelRoot, entries: [], fixtureStatus: "ok" };
   }
-  const project = new Project18({ useInMemoryFileSystem: true });
+  const project = new Project17({ useInMemoryFileSystem: true });
   const commonBarrelExports = await readCommonBarrelExports(apiAbs);
   const fixtureCoverageMap = /* @__PURE__ */ new Map();
   let fixtureStatus = "ok";
@@ -32801,7 +32873,7 @@ async function safeRead(path) {
   }
 }
 function inspectModuleText(input) {
-  const project = new Project18({ useInMemoryFileSystem: true });
+  const project = new Project17({ useInMemoryFileSystem: true });
   const sourceFile = project.createSourceFile("module.ts", input.text, { overwrite: true });
   let providedByModule = false;
   let exportedByModule = false;
@@ -32838,7 +32910,7 @@ async function readCommonBarrelExports(apiAbs) {
   const path = join19(apiAbs, COMMON_BARREL_REL);
   const text = await safeRead(path);
   if (text === void 0) return /* @__PURE__ */ new Set();
-  const project = new Project18({ useInMemoryFileSystem: true });
+  const project = new Project17({ useInMemoryFileSystem: true });
   const sourceFile = project.createSourceFile(path, text, { overwrite: true });
   const exported = /* @__PURE__ */ new Set();
   for (const decl of sourceFile.getExportDeclarations()) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dereekb/dbx-components-mcp",
-  "version": "13.11.1",
+  "version": "13.11.2",
   "type": "module",
   "bin": {
     "dbx-components-mcp": "dbx-components-mcp.js"
@@ -15,18 +15,19 @@
     "@angular/core": "21.2.11",
     "@angular/forms": "21.2.11",
     "@angular/material": "^21.2.9",
-    "@dereekb/dbx-core": "13.11.1",
-    "@dereekb/dbx-firebase": "13.11.1",
-    "@dereekb/dbx-form": "13.11.1",
-    "@dereekb/dbx-web": "13.11.1",
-    "@dereekb/firebase": "13.11.1",
-    "@dereekb/firebase-server": "13.11.1",
-    "@dereekb/rxjs": "13.11.1",
-    "@dereekb/util": "13.11.1",
+    "@dereekb/dbx-cli": "13.11.2",
+    "@dereekb/dbx-core": "13.11.2",
+    "@dereekb/dbx-firebase": "13.11.2",
+    "@dereekb/dbx-form": "13.11.2",
+    "@dereekb/dbx-web": "13.11.2",
+    "@dereekb/firebase": "13.11.2",
+    "@dereekb/firebase-server": "13.11.2",
+    "@dereekb/rxjs": "13.11.2",
+    "@dereekb/util": "13.11.2",
     "@uirouter/angular": "21.0.0",
     "rxjs": "^7.8.2"
   },
   "devDependencies": {
-    "@dereekb/model": "13.11.1"
+    "@dereekb/model": "13.11.2"
   }
 }