@topogram/cli 0.3.77 → 0.3.78

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topogram/cli",
-  "version": "0.3.77",
+  "version": "0.3.78",
   "description": "Topogram CLI for checking Topogram workspaces and generating app bundles.",
   "license": "Apache-2.0",
   "repository": {

package/src/import/core/shared/files.js

@@ -107,7 +107,7 @@ export function classifyImportSourcePath(paths, filePath) {
   if (/(^|\/)(\.tmp|tmp|temp|dist|build|coverage|out|generated|docs-generated|snapshots?)(\/|$)/i.test(relativePath)) {
     return "generated_output";
   }
-  if (/(^|\/)[^/]*templates?[^/]*(\/|$)/i.test(relativePath)) {
+  if (/^(template|templates|[^/]+-templates|[^/]+_templates)(\/|$)/i.test(relativePath)) {
     return "fixtures";
   }
   if (/(^|\/)(test|tests|__tests__|spec|specs|mocks?)(\/|$)|\.(test|spec)\.(js|jsx|ts|tsx|mjs|cjs)$/i.test(relativePath)) {
@@ -213,9 +213,10 @@ export function selectPreferredImportFiles(paths, files, kind) {
 /**
  * @param {import("./types.d.ts").ImportPaths} paths
  * @param {any} predicate
+ * @param {{ primaryOnly?: boolean }} [options]
  * @returns {any}
  */
-export function findImportFiles(paths, predicate) {
+export function findImportFiles(paths, predicate, options = {}) {
   const files = new Set();
   for (const rootDir of importSearchRoots(paths)) {
     for (const filePath of listFilesRecursive(rootDir, predicate)) {
@@ -226,8 +227,26 @@ export function findImportFiles(paths, predicate) {
       ) {
         continue;
       }
+      if (options.primaryOnly && !isPrimaryImportSource(paths, filePath)) {
+        continue;
+      }
       files.add(filePath);
     }
   }
   return [...files].sort();
 }
+
+/**
+ * Find files that are eligible to create primary import candidates.
+ *
+ * Docs, tests, fixture/template roots, generated output, and cache output may
+ * still support evidence elsewhere, but candidate-producing extractors should
+ * start from this helper so the primary-source rule is one API boundary.
+ *
+ * @param {import("./types.d.ts").ImportPaths} paths
+ * @param {any} predicate
+ * @returns {any}
+ */
+export function findPrimaryImportFiles(paths, predicate) {
+  return findImportFiles(paths, predicate, { primaryOnly: true });
+}

package/src/import/core/shared.js

@@ -24,7 +24,8 @@ export {
   isPrimaryImportSource,
   canonicalSourceRank,
   selectPreferredImportFiles,
-  findImportFiles
+  findImportFiles,
+  findPrimaryImportFiles
 } from "./shared/files.js";
 export {
   normalizeOpenApiPath,

package/src/import/enrichers/django-rest.js

@@ -1,6 +1,6 @@
 import path from "node:path";
 
-import { findImportFiles, readTextIfExists } from "../core/shared.js";
+import { findPrimaryImportFiles, readTextIfExists } from "../core/shared.js";
 
 function splitClassBlocks(text) {
   const lines = String(text || "").split(/\r?\n/);
@@ -51,7 +51,7 @@ function splitClassBlocks(text) {
 }
 
 function buildSerializerIndex(paths) {
-  const files = findImportFiles(paths, (filePath) => /\/serializers\.py$/i.test(filePath));
+  const files = findPrimaryImportFiles(paths, (filePath) => /\/serializers\.py$/i.test(filePath));
   const index = new Map();
 
   for (const filePath of files) {
@@ -89,7 +89,7 @@ function buildSerializerIndex(paths) {
 }
 
 function buildViewIndex(paths) {
-  const files = findImportFiles(paths, (filePath) => /\/views\.py$/i.test(filePath));
+  const files = findPrimaryImportFiles(paths, (filePath) => /\/views\.py$/i.test(filePath));
   const index = new Map();
 
   for (const filePath of files) {
@@ -182,7 +182,7 @@ export const djangoRestEnricher = {
   applies(context, candidates) {
     if ((candidates.capabilities || []).length === 0) return false;
     return (candidates.stacks || []).includes("django") ||
-      findImportFiles(context.paths, (filePath) => /\/serializers\.py$/i.test(filePath)).length > 0;
+      findPrimaryImportFiles(context.paths, (filePath) => /\/serializers\.py$/i.test(filePath)).length > 0;
   },
   enrich(context, candidates) {
     const serializerIndex = buildSerializerIndex(context.paths);

package/src/import/enrichers/rails-controllers.js

@@ -1,9 +1,9 @@
 import path from "node:path";
 
-import { findImportFiles, readTextIfExists } from "../core/shared.js";
+import { findPrimaryImportFiles, readTextIfExists } from "../core/shared.js";
 
 function buildControllerIndex(paths) {
-  const files = findImportFiles(paths, (filePath) => /app\/controllers\/.+_controller\.rb$/i.test(filePath));
+  const files = findPrimaryImportFiles(paths, (filePath) => /app\/controllers\/.+_controller\.rb$/i.test(filePath));
   const index = new Map();
   for (const filePath of files) {
     const text = readTextIfExists(filePath) || "";
@@ -186,7 +186,7 @@ export const railsControllerEnricher = {
   applies(context, candidates) {
     if ((candidates.capabilities || []).length === 0) return false;
     return (candidates.stacks || []).includes("rails") ||
-      findImportFiles(context.paths, (filePath) => /app\/controllers\/.+_controller\.rb$/i.test(filePath)).length > 0;
+      findPrimaryImportFiles(context.paths, (filePath) => /app\/controllers\/.+_controller\.rb$/i.test(filePath)).length > 0;
   },
   enrich(context, candidates) {
     const controllers = buildControllerIndex(context.paths);

package/src/import/enrichers/rails-models.js

@@ -1,6 +1,6 @@
 import path from "node:path";
 
-import { findImportFiles, readTextIfExists } from "../core/shared.js";
+import { findPrimaryImportFiles, readTextIfExists } from "../core/shared.js";
 
 function modelClassNameForEntity(entityId) {
   const stem = String(entityId || "")
@@ -13,7 +13,7 @@ function modelClassNameForEntity(entityId) {
 }
 
 function buildModelIndex(paths) {
-  const modelFiles = findImportFiles(paths, (filePath) => /app\/models\/.+\.rb$/i.test(filePath));
+  const modelFiles = findPrimaryImportFiles(paths, (filePath) => /app\/models\/.+\.rb$/i.test(filePath));
   const index = new Map();
   for (const filePath of modelFiles) {
     const text = readTextIfExists(filePath) || "";
@@ -93,7 +93,7 @@ export const railsModelEnricher = {
   track: "db",
   applies(context, candidates) {
     if ((candidates.entities || []).length === 0) return false;
-    return findImportFiles(context.paths, (filePath) => /app\/models\/.+\.rb$/i.test(filePath)).length > 0;
+    return findPrimaryImportFiles(context.paths, (filePath) => /app\/models\/.+\.rb$/i.test(filePath)).length > 0;
   },
   enrich(context, candidates) {
     const modelIndex = buildModelIndex(context.paths);

package/src/import/extractors/api/aspnet-core.js

@@ -1,6 +1,6 @@
 import {
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   inferApiEntityIdFromPath,
   inferRouteCapabilityId,
   makeCandidateRecord,
@@ -22,7 +22,7 @@ function parsePublicProperties(text) {
 }
 
 function buildDotnetFileIndex(paths) {
-  const files = findImportFiles(paths, (filePath) => /\.cs$/i.test(filePath));
+  const files = findPrimaryImportFiles(paths, (filePath) => /\.cs$/i.test(filePath));
   const index = new Map();
   for (const filePath of files) {
     index.set(relativeTo(paths.repoRoot, filePath), readTextIfExists(filePath) || "");
@@ -239,8 +239,8 @@ export const aspNetCoreExtractor = {
   id: "api.aspnet-core",
   track: "api",
   detect(context) {
-    const controllerFiles = findImportFiles(context.paths, (filePath) => /Controller\.cs$/i.test(filePath));
-    const programFiles = findImportFiles(context.paths, (filePath) => /Program\.cs$/i.test(filePath));
+    const controllerFiles = findPrimaryImportFiles(context.paths, (filePath) => /Controller\.cs$/i.test(filePath));
+    const programFiles = findPrimaryImportFiles(context.paths, (filePath) => /Program\.cs$/i.test(filePath));
     const score = controllerFiles.length > 0 && programFiles.some((filePath) => /WebApplication\.CreateBuilder|AddSwaggerGen|AddMvc/.test(readTextIfExists(filePath) || "")) ? 88 : 0;
     return {
       score,
@@ -248,7 +248,7 @@ export const aspNetCoreExtractor = {
     };
   },
   extract(context) {
-    const controllerFiles = findImportFiles(context.paths, (filePath) => /Controller\.cs$/i.test(filePath));
+    const controllerFiles = findPrimaryImportFiles(context.paths, (filePath) => /Controller\.cs$/i.test(filePath));
     const featureFiles = buildDotnetFileIndex(context.paths).files.map((filePath) => ({ filePath, text: readTextIfExists(filePath) || "" }));
     const findings = [];
     const candidates = { capabilities: [], routes: [], stacks: [] };

package/src/import/extractors/api/django-routes.js

@@ -2,7 +2,7 @@ import path from "node:path";
 
 import {
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   inferApiEntityIdFromPath,
   inferRouteCapabilityId,
   makeCandidateRecord,
@@ -90,7 +90,7 @@ function permissionAuthHint(permissionText, method) {
 }
 
 function buildViewIndex(paths) {
-  const viewFiles = findImportFiles(paths, (filePath) => /\/views\.py$/i.test(filePath));
+  const viewFiles = findPrimaryImportFiles(paths, (filePath) => /\/views\.py$/i.test(filePath));
   const index = new Map();
 
   for (const filePath of viewFiles) {
@@ -250,8 +250,8 @@ export const djangoRoutesExtractor = {
   id: "api.django-routes",
   track: "api",
   detect(context) {
-    const manageFiles = findImportFiles(context.paths, (filePath) => /\/manage\.py$/i.test(filePath));
-    const urlFiles = findImportFiles(context.paths, (filePath) => /\/urls\.py$/i.test(filePath));
+    const manageFiles = findPrimaryImportFiles(context.paths, (filePath) => /\/manage\.py$/i.test(filePath));
+    const urlFiles = findPrimaryImportFiles(context.paths, (filePath) => /\/urls\.py$/i.test(filePath));
     const score = manageFiles.length > 0 && urlFiles.length > 0 ? 90 : 0;
     return {
       score,
@@ -259,7 +259,7 @@ export const djangoRoutesExtractor = {
     };
   },
   extract(context) {
-    const urlFiles = findImportFiles(context.paths, (filePath) => /\/urls\.py$/i.test(filePath));
+    const urlFiles = findPrimaryImportFiles(context.paths, (filePath) => /\/urls\.py$/i.test(filePath));
     const moduleMap = new Map(urlFiles.map((filePath) => [moduleNameForFile(context.paths.repoRoot, filePath), filePath]));
     const viewIndex = buildViewIndex(context.paths);
     const rootFiles = urlFiles.filter((filePath) => !/\/apps\//.test(filePath));

package/src/import/extractors/api/express.js

@@ -2,7 +2,7 @@ import path from "node:path";
 
 import {
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   inferApiEntityIdFromPath,
   inferRouteAuthHint,
   inferRouteCapabilityId,
@@ -94,18 +94,18 @@ export const expressExtractor = {
   id: "api.express",
   track: "api",
   detect(context) {
-    const routeFiles = findImportFiles(context.paths, (filePath) => /src\/routes\/.+\.(ts|js|mjs|cjs)$/i.test(filePath));
+    const routeFiles = findPrimaryImportFiles(context.paths, (filePath) => /src\/routes\/.+\.(ts|js|mjs|cjs)$/i.test(filePath));
     return {
       score: routeFiles.length > 0 ? 85 : 0,
       reasons: routeFiles.length > 0 ? ["Found Express route modules"] : []
     };
   },
   extract(context) {
-    const permissionsFile = findImportFiles(context.paths, (filePath) => /src\/helpers\/permissions\.(ts|js|mjs|cjs)$/i.test(filePath))[0];
+    const permissionsFile = findPrimaryImportFiles(context.paths, (filePath) => /src\/helpers\/permissions\.(ts|js|mjs|cjs)$/i.test(filePath))[0];
     const permissionsText = permissionsFile ? context.helpers.readTextIfExists(permissionsFile) || "" : "";
     const apiRoutes = parseApiRoutesMap(permissionsText);
     const permissionMeta = parsePermissionsMetadata(permissionsText);
-    const routeFiles = findImportFiles(context.paths, (filePath) => /src\/routes\/.+\.(ts|js|mjs|cjs)$/i.test(filePath));
+    const routeFiles = findPrimaryImportFiles(context.paths, (filePath) => /src\/routes\/.+\.(ts|js|mjs|cjs)$/i.test(filePath));
     const routes = routeFiles.flatMap((filePath) =>
       parseExpressRouteCalls(filePath, context.helpers.readTextIfExists(filePath) || "", apiRoutes, permissionMeta)
     );

package/src/import/extractors/api/fastify.js

@@ -2,7 +2,7 @@ import path from "node:path";
 
 import {
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   inferApiCapabilityIdFromOperation,
   inferApiEntityIdFromPath,
   makeCandidateRecord,
@@ -263,8 +263,8 @@ export const fastifyExtractor = {
   id: "api.fastify",
   track: "api",
   detect(context) {
-    const routeFiles = findImportFiles(context.paths, (filePath) => /src\/routes\/api\/.+\.(ts|js|mjs|cjs)$/i.test(filePath));
-    const packageJsonFiles = findImportFiles(context.paths, (filePath) => /package\.json$/i.test(filePath));
+    const routeFiles = findPrimaryImportFiles(context.paths, (filePath) => /src\/routes\/api\/.+\.(ts|js|mjs|cjs)$/i.test(filePath));
+    const packageJsonFiles = findPrimaryImportFiles(context.paths, (filePath) => /package\.json$/i.test(filePath));
     const hasFastifyDependency = packageJsonFiles.some((filePath) => /"fastify"\s*:/.test(context.helpers.readTextIfExists(filePath) || ""));
     return {
       score: routeFiles.length > 0 && hasFastifyDependency ? 86 : 0,
@@ -272,16 +272,16 @@ export const fastifyExtractor = {
     };
   },
   extract(context) {
-    const apiRoutesRoot = findImportFiles(context.paths, (filePath) => /src\/routes\/api\/index\.(ts|js|mjs|cjs)$/i.test(filePath))[0]
-      ? path.join(path.dirname(findImportFiles(context.paths, (filePath) => /src\/routes\/api\/index\.(ts|js|mjs|cjs)$/i.test(filePath))[0]))
+    const apiRoutesRoot = findPrimaryImportFiles(context.paths, (filePath) => /src\/routes\/api\/index\.(ts|js|mjs|cjs)$/i.test(filePath))[0]
+      ? path.join(path.dirname(findPrimaryImportFiles(context.paths, (filePath) => /src\/routes\/api\/index\.(ts|js|mjs|cjs)$/i.test(filePath))[0]))
       : null;
     if (!apiRoutesRoot) {
       return { findings: [], candidates: { capabilities: [], routes: [], stacks: [] } };
     }
 
-    const routeFiles = findImportFiles(context.paths, (filePath) => /src\/routes\/api\/.+\.(ts|js|mjs|cjs)$/i.test(filePath))
+    const routeFiles = findPrimaryImportFiles(context.paths, (filePath) => /src\/routes\/api\/.+\.(ts|js|mjs|cjs)$/i.test(filePath))
       .filter((filePath) => !/\/autohooks\.(ts|js|mjs|cjs)$/i.test(filePath));
-    const schemaFiles = findImportFiles(context.paths, (filePath) => /src\/schemas\/.+\.(ts|js|mjs|cjs)$/i.test(filePath));
+    const schemaFiles = findPrimaryImportFiles(context.paths, (filePath) => /src\/schemas\/.+\.(ts|js|mjs|cjs)$/i.test(filePath));
     const namedSchemas = parseNamedTypeboxSchemas(schemaFiles, context.helpers.readTextIfExists);
 
     const routes = [];

package/src/import/extractors/api/flutter-dio.js

@@ -1,7 +1,7 @@
 import {
   canonicalCandidateTerm,
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   makeCandidateRecord,
   pluralizeCandidateTerm,
   relativeTo,
@@ -31,7 +31,7 @@ function capabilityIdFor(featureStem, methodName, httpMethod) {
 }
 
 function extractApiConfigPaths(context) {
-  const configFile = findImportFiles(context.paths, (filePath) => /\/lib\/common\/network\/api_config\.dart$/i.test(filePath))[0];
+  const configFile = findPrimaryImportFiles(context.paths, (filePath) => /\/lib\/common\/network\/api_config\.dart$/i.test(filePath))[0];
   const mapping = new Map();
   if (!configFile) return mapping;
   const text = context.helpers.readTextIfExists(configFile) || "";
@@ -87,7 +87,7 @@ export const flutterDioExtractor = {
   id: "api.flutter-dio",
   track: "api",
   detect(context) {
-    const files = findImportFiles(
+    const files = findPrimaryImportFiles(
       context.paths,
       (filePath) => /\/lib\/features\/.+\/data\/datasources\/.+_remote_data_source\.dart$/i.test(filePath)
     );
@@ -98,7 +98,7 @@ export const flutterDioExtractor = {
     };
   },
   extract(context) {
-    const files = findImportFiles(
+    const files = findPrimaryImportFiles(
       context.paths,
       (filePath) => /\/lib\/features\/.+\/data\/datasources\/.+_remote_data_source\.dart$/i.test(filePath)
     );

package/src/import/extractors/api/generic-route-fallback.js

@@ -1,4 +1,4 @@
-import { findImportFiles, inferRouteAuthHint, inferRouteCapabilityId, inferRouteQueryParams, isPrimaryImportSource, makeCandidateRecord, normalizeOpenApiPath, relativeTo } from "../../core/shared.js";
+import { findPrimaryImportFiles, inferRouteAuthHint, inferRouteCapabilityId, inferRouteQueryParams, isPrimaryImportSource, makeCandidateRecord, normalizeOpenApiPath, relativeTo } from "../../core/shared.js";
 
 function extractHandlerContext(text, handlerName) {
   if (!handlerName) return "";
@@ -15,7 +15,7 @@ function extractHandlerContext(text, handlerName) {
 
 function inferServerRoutes(context) {
   const routes = [];
-  const routeFiles = findImportFiles(
+  const routeFiles = findPrimaryImportFiles(
     context.paths,
     (filePath) =>
       /\.(ts|tsx|js|jsx|mjs|cjs)$/.test(filePath) &&

package/src/import/extractors/api/graphql-code-first.js

@@ -1,7 +1,7 @@
 import {
   canonicalCandidateTerm,
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   idHintify,
   makeCandidateRecord,
   pluralizeCandidateTerm,
@@ -464,7 +464,7 @@ export const graphQlCodeFirstExtractor = {
   id: "api.graphql-code-first",
   track: "api",
   detect(context) {
-    const files = findImportFiles(context.paths, (filePath) => /(\/src\/.+|\/pages\/api\/.+)\.(ts|tsx|js|jsx)$/i.test(filePath));
+    const files = findPrimaryImportFiles(context.paths, (filePath) => /(\/src\/.+|\/pages\/api\/.+)\.(ts|tsx|js|jsx)$/i.test(filePath));
     const hasNestResolvers = files.some((filePath) => {
       const text = readTextIfExists(filePath) || "";
       return /@nestjs\/graphql/.test(text) && /@(Query|Mutation)\s*\(/.test(text);
@@ -489,7 +489,7 @@ export const graphQlCodeFirstExtractor = {
     };
   },
   extract(context) {
-    const files = findImportFiles(context.paths, (filePath) => /(\/src\/.+|\/pages\/api\/.+)\.(ts|tsx|js|jsx)$/i.test(filePath)).filter((filePath) => !/\.test\./i.test(filePath));
+    const files = findPrimaryImportFiles(context.paths, (filePath) => /(\/src\/.+|\/pages\/api\/.+)\.(ts|tsx|js|jsx)$/i.test(filePath)).filter((filePath) => !/\.test\./i.test(filePath));
     const nestTypes = parseNestTypes(files);
     const pothosTypes = parsePothosTypes(files);
     const nexusTypes = parseNexusTypes(files);

package/src/import/extractors/api/graphql-sdl.js

@@ -1,7 +1,7 @@
 import {
   canonicalCandidateTerm,
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   idHintify,
   makeCandidateRecord,
   pluralizeCandidateTerm,
@@ -174,7 +174,7 @@ function inferEndpointPath(context, graphqlFiles) {
       return endpointMatch[1];
     }
   }
-  const packageJsonPath = findImportFiles(context.paths, (filePath) => /package\.json$/i.test(filePath))[0];
+  const packageJsonPath = findPrimaryImportFiles(context.paths, (filePath) => /package\.json$/i.test(filePath))[0];
   const packageText = packageJsonPath ? readTextIfExists(packageJsonPath) : null;
   if (packageText && /graphql-yoga|apollo-server|@apollo\/server/.test(packageText)) {
     return "/graphql";
@@ -183,7 +183,7 @@ function inferEndpointPath(context, graphqlFiles) {
 }
 
 function extractGraphqlSchemaSources(context) {
-  const files = findImportFiles(
+  const files = findPrimaryImportFiles(
     context.paths,
     (filePath) =>
       /\/src\/.+\.(ts|tsx|js|jsx)$/i.test(filePath) ||
@@ -210,7 +210,7 @@ export const graphQlSdlExtractor = {
   detect(context) {
     const schemaSources = extractGraphqlSchemaSources(context);
     const hasOperations = schemaSources.some(({ schema }) => /\btype\s+Query\b|\btype\s+Mutation\b/.test(schema));
-    const packageJsonPath = findImportFiles(context.paths, (filePath) => /package\.json$/i.test(filePath))[0];
+    const packageJsonPath = findPrimaryImportFiles(context.paths, (filePath) => /package\.json$/i.test(filePath))[0];
     const packageText = packageJsonPath ? readTextIfExists(packageJsonPath) : "";
     const hasGraphqlRuntime = /graphql-yoga|graphql|apollo-server|@apollo\/server/.test(packageText || "");
     return {
@@ -220,7 +220,7 @@ export const graphQlSdlExtractor = {
   },
   extract(context) {
     const schemaSources = extractGraphqlSchemaSources(context);
-    const endpointPath = inferEndpointPath(context, findImportFiles(context.paths, (filePath) => /\/src\/.+\.(ts|tsx|js|jsx)$/i.test(filePath)));
+    const endpointPath = inferEndpointPath(context, findPrimaryImportFiles(context.paths, (filePath) => /\/src\/.+\.(ts|tsx|js|jsx)$/i.test(filePath)));
     const mergedSchema = schemaSources.map(({ schema }) => schema).join("\n\n");
     const blocks = parseGraphqlSchemaBlocks(mergedSchema);
     const inputTypes = new Map([...blocks.entries()].filter(([, block]) => block.kind === "input"));

package/src/import/extractors/api/jaxrs.js

@@ -1,6 +1,6 @@
 import {
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   inferApiEntityIdFromPath,
   inferRouteCapabilityId,
   makeCandidateRecord,
@@ -11,7 +11,7 @@ import {
 } from "../../core/shared.js";
 
 function buildJavaFileIndex(paths) {
-  const files = findImportFiles(paths, (filePath) => /\.java$/i.test(filePath));
+  const files = findPrimaryImportFiles(paths, (filePath) => /\.java$/i.test(filePath));
   return files.map((filePath) => ({
     filePath,
     relativePath: relativeTo(paths.repoRoot, filePath),
@@ -253,7 +253,7 @@ export const jaxRsExtractor = {
   id: "api.jaxrs",
   track: "api",
   detect(context) {
-    const javaFiles = findImportFiles(context.paths, (filePath) => /\.java$/i.test(filePath));
+    const javaFiles = findPrimaryImportFiles(context.paths, (filePath) => /\.java$/i.test(filePath));
     const jaxrsCount = javaFiles.filter((filePath) => /@Path\(|@(GET|POST|PUT|PATCH|DELETE)\b/.test(readTextIfExists(filePath) || "")).length;
     return {
       score: jaxrsCount > 0 ? 92 : 0,

package/src/import/extractors/api/micronaut.js

@@ -1,6 +1,6 @@
 import {
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   inferApiEntityIdFromPath,
   inferRouteCapabilityId,
   makeCandidateRecord,
@@ -11,7 +11,7 @@ import {
 } from "../../core/shared.js";
 
 function buildJavaFileIndex(paths) {
-  const files = findImportFiles(paths, (filePath) => /\.java$/i.test(filePath));
+  const files = findPrimaryImportFiles(paths, (filePath) => /\.java$/i.test(filePath));
   return files.map((filePath) => ({
     filePath,
     relativePath: relativeTo(paths.repoRoot, filePath),
@@ -163,7 +163,7 @@ export const micronautExtractor = {
   id: "api.micronaut",
   track: "api",
   detect(context) {
-    const javaFiles = findImportFiles(context.paths, (filePath) => /\.java$/i.test(filePath));
+    const javaFiles = findPrimaryImportFiles(context.paths, (filePath) => /\.java$/i.test(filePath));
     const count = javaFiles.filter((filePath) => /io\.micronaut\.http\.annotation|@Controller\(|@Get\(|@Post\(|@Put\(|@Delete\(/.test(readTextIfExists(filePath) || "")).length;
     return {
       score: count > 0 ? 95 : 0,

package/src/import/extractors/api/openapi-code.js

@@ -2,7 +2,7 @@ import path from "node:path";
 
 import {
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   inferApiCapabilityIdFromOperation,
   inferApiEntityIdFromPath,
   makeCandidateRecord,
@@ -183,15 +183,15 @@ export const openApiCodeExtractor = {
   id: "api.openapi-code",
   track: "api",
   detect(context) {
-    const openApiFiles = findImportFiles(context.paths, (filePath) => /src\/docs\/openapi\.(ts|js|mjs|cjs)$/i.test(filePath));
+    const openApiFiles = findPrimaryImportFiles(context.paths, (filePath) => /src\/docs\/openapi\.(ts|js|mjs|cjs)$/i.test(filePath));
     return {
       score: openApiFiles.length > 0 ? 92 : 0,
       reasons: openApiFiles.length > 0 ? ["Found code-generated OpenAPI source"] : []
     };
   },
   extract(context) {
-    const openApiFiles = findImportFiles(context.paths, (filePath) => /src\/docs\/openapi\.(ts|js|mjs|cjs)$/i.test(filePath));
-    const schemaFile = findImportFiles(context.paths, (filePath) => /src\/docs\/openapi-schemas\.(ts|js|mjs|cjs)$/i.test(filePath))[0];
+    const openApiFiles = findPrimaryImportFiles(context.paths, (filePath) => /src\/docs\/openapi\.(ts|js|mjs|cjs)$/i.test(filePath));
+    const schemaFile = findPrimaryImportFiles(context.paths, (filePath) => /src\/docs\/openapi-schemas\.(ts|js|mjs|cjs)$/i.test(filePath))[0];
     const schemaFields = schemaFile ? parseZodObjectSchemaFields(context.helpers.readTextIfExists(schemaFile) || "") : new Map();
     const findings = [];
     const candidates = { capabilities: [], routes: [], stacks: [] };

package/src/import/extractors/api/openapi.js

@@ -1,4 +1,4 @@
-import { findImportFiles, isPrimaryImportSource, makeCandidateRecord, normalizeOpenApiPath, relativeTo, selectPreferredImportFiles, slugify, titleCase } from "../../core/shared.js";
+import { findPrimaryImportFiles, isPrimaryImportSource, makeCandidateRecord, normalizeOpenApiPath, relativeTo, selectPreferredImportFiles, slugify, titleCase } from "../../core/shared.js";
 
 function openApiRefName(ref) {
   return typeof ref === "string" ? ref.split("/").pop() || null : null;
@@ -196,7 +196,7 @@ export const openApiExtractor = {
   detect(context) {
     const files = selectPreferredImportFiles(
       context.paths,
-      findImportFiles(context.paths, (filePath) => /(openapi|swagger)\.(json|ya?ml)$/i.test(filePath) && isPrimaryImportSource(context.paths, filePath)),
+      findPrimaryImportFiles(context.paths, (filePath) => /(openapi|swagger)\.(json|ya?ml)$/i.test(filePath) && isPrimaryImportSource(context.paths, filePath)),
       "openapi"
     );
     return {
@@ -207,7 +207,7 @@ export const openApiExtractor = {
   extract(context) {
     const openApiFiles = selectPreferredImportFiles(
       context.paths,
-      findImportFiles(context.paths, (filePath) => /(openapi|swagger)\.(json|ya?ml)$/i.test(filePath) && isPrimaryImportSource(context.paths, filePath)),
+      findPrimaryImportFiles(context.paths, (filePath) => /(openapi|swagger)\.(json|ya?ml)$/i.test(filePath) && isPrimaryImportSource(context.paths, filePath)),
       "openapi"
     );
     const findings = [];

package/src/import/extractors/api/rails-routes.js

@@ -2,7 +2,7 @@ import path from "node:path";
 
 import {
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   inferApiEntityIdFromPath,
   inferRouteCapabilityId,
   makeCandidateRecord,
@@ -167,14 +167,14 @@ export const railsRoutesExtractor = {
   id: "api.rails-routes",
   track: "api",
   detect(context) {
-    const routeFiles = findImportFiles(context.paths, (filePath) => /config\/routes\.rb$/i.test(filePath));
+    const routeFiles = findPrimaryImportFiles(context.paths, (filePath) => /config\/routes\.rb$/i.test(filePath));
     return {
       score: routeFiles.length > 0 ? 90 : 0,
       reasons: routeFiles.length > 0 ? ["Found Rails routes.rb"] : []
     };
   },
   extract(context) {
-    const routeFiles = findImportFiles(context.paths, (filePath) => /config\/routes\.rb$/i.test(filePath));
+    const routeFiles = findPrimaryImportFiles(context.paths, (filePath) => /config\/routes\.rb$/i.test(filePath));
     const findings = [];
     const candidates = { capabilities: [], routes: [], stacks: [] };
 

package/src/import/extractors/api/react-native-repository.js

@@ -1,7 +1,7 @@
 import {
   canonicalCandidateTerm,
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   makeCandidateRecord,
   pluralizeCandidateTerm,
   relativeTo,
@@ -82,7 +82,7 @@ export const reactNativeRepositoryExtractor = {
   id: "api.react-native-repository",
   track: "api",
   detect(context) {
-    const files = findImportFiles(
+    const files = findPrimaryImportFiles(
       context.paths,
       (filePath) => /\/src\/.+\/infrastructure\/implementations\/.+Repository\.ts$/i.test(filePath)
     );
@@ -93,7 +93,7 @@ export const reactNativeRepositoryExtractor = {
     };
   },
   extract(context) {
-    const files = findImportFiles(
+    const files = findPrimaryImportFiles(
       context.paths,
       (filePath) => /\/src\/.+\/infrastructure\/implementations\/.+Repository\.ts$/i.test(filePath)
     );

package/src/import/extractors/api/retrofit.js

@@ -1,7 +1,7 @@
 import {
   canonicalCandidateTerm,
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   makeCandidateRecord,
   relativeTo,
   titleCase
@@ -66,7 +66,7 @@ export const retrofitExtractor = {
   id: "api.retrofit",
   track: "api",
   detect(context) {
-    const serviceFiles = findImportFiles(context.paths, (filePath) => /Service\.kt$/i.test(filePath) || /retrofit\/.+\.kt$/i.test(filePath));
+    const serviceFiles = findPrimaryImportFiles(context.paths, (filePath) => /Service\.kt$/i.test(filePath) || /retrofit\/.+\.kt$/i.test(filePath));
     const score = serviceFiles.some((filePath) => /@GET|@POST|@PUT|@PATCH|@DELETE/.test(context.helpers.readTextIfExists(filePath) || "")) ? 87 : 0;
     return {
       score,
@@ -74,7 +74,7 @@ export const retrofitExtractor = {
     };
   },
   extract(context) {
-    const serviceFiles = findImportFiles(context.paths, (filePath) => /Service\.kt$/i.test(filePath) || /retrofit\/.+\.kt$/i.test(filePath));
+    const serviceFiles = findPrimaryImportFiles(context.paths, (filePath) => /Service\.kt$/i.test(filePath) || /retrofit\/.+\.kt$/i.test(filePath));
     const capabilities = [];
     for (const filePath of serviceFiles) {
       const provenance = relativeTo(context.paths.repoRoot, filePath);

package/src/import/extractors/api/spring-web.js

@@ -1,6 +1,6 @@
 import {
   dedupeCandidateRecords,
-  findImportFiles,
+  findPrimaryImportFiles,
   inferApiEntityIdFromPath,
   inferRouteCapabilityId,
   makeCandidateRecord,
@@ -13,7 +13,7 @@ import {
 const JAVA_ANNOTATION_PATTERN = String.raw`@[\w.]+(?:\((?:[^()]|\([^)]*\))*\))?`;
 
 function buildJavaFileIndex(paths) {
-  const files = findImportFiles(paths, (filePath) => /\.java$/i.test(filePath));
+  const files = findPrimaryImportFiles(paths, (filePath) => /\.java$/i.test(filePath));
   return files.map((filePath) => ({
     filePath,
     relativePath: relativeTo(paths.repoRoot, filePath),
@@ -318,7 +318,7 @@ export const springWebExtractor = {
   id: "api.spring-web",
   track: "api",
   detect(context) {
-    const javaFiles = findImportFiles(context.paths, (filePath) => /\.java$/i.test(filePath));
+    const javaFiles = findPrimaryImportFiles(context.paths, (filePath) => /\.java$/i.test(filePath));
     const springCount = javaFiles.filter((filePath) => /@(RestController|Controller)|@(?:Get|Post|Put|Patch|Delete)Exchange|@(GetMapping|PostMapping|PutMapping|PatchMapping|DeleteMapping)|@RequestMapping/.test(readTextIfExists(filePath) || "")).length;
     return {
       score: springCount > 0 ? 90 : 0,