projscan 3.8.0 → 4.1.0

package/dist/core/graphQuery.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Targeted code-graph queries (4.0 consolidation).
+ *
+ * Extracted from the (removed) `projscan_graph` tool so the capability lives in
+ * one tested place and folds into `projscan_semantic_graph` — which previously
+ * only dumped the whole graph. This is what makes semantic_graph a true
+ * superset of the old graph tool: it answers the same targeted "who imports X",
+ * "what does X export", "where is symbol S defined" questions without serializing
+ * the entire graph.
+ */
+import { type CodeGraph } from './codeGraph.js';
+export type GraphQueryDirection = 'imports' | 'exports' | 'importers' | 'symbol_defs' | 'package_importers';
+export interface GraphQueryInput {
+    direction: GraphQueryDirection;
+    /** Repo-relative file path (for imports/exports/importers). */
+    file?: string;
+    /** Symbol or package name (for symbol_defs/package_importers). */
+    symbol?: string;
+    /** Max entries returned (1–500, default 50). */
+    limit?: number;
+}
+/** Run one targeted query against a built code graph. Throws on missing args. */
+export declare function runGraphQuery(graph: CodeGraph, input: GraphQueryInput): Record<string, unknown>;

package/dist/core/graphQuery.js

@@ -0,0 +1,48 @@
+/**
+ * Targeted code-graph queries (4.0 consolidation).
+ *
+ * Extracted from the (removed) `projscan_graph` tool so the capability lives in
+ * one tested place and folds into `projscan_semantic_graph` — which previously
+ * only dumped the whole graph. This is what makes semantic_graph a true
+ * superset of the old graph tool: it answers the same targeted "who imports X",
+ * "what does X export", "where is symbol S defined" questions without serializing
+ * the entire graph.
+ */
+import { filesImportingFile, filesImportingPackage, filesDefiningSymbol, exportsOf, importsOf, } from './codeGraph.js';
+const DEFAULT_LIMIT = 50;
+/** Run one targeted query against a built code graph. Throws on missing args. */
+export function runGraphQuery(graph, input) {
+    const { direction, file, symbol } = input;
+    const limit = Math.max(1, Math.min(500, typeof input.limit === 'number' ? input.limit : DEFAULT_LIMIT));
+    switch (direction) {
+        case 'imports': {
+            if (!file)
+                throw new Error('direction=imports requires a `file` argument (repo-relative path, e.g. "src/auth.ts").');
+            return { file, imports: importsOf(graph, file).slice(0, limit) };
+        }
+        case 'exports': {
+            if (!file)
+                throw new Error('direction=exports requires a `file` argument (repo-relative path).');
+            return { file, exports: exportsOf(graph, file).slice(0, limit) };
+        }
+        case 'importers': {
+            if (!file)
+                throw new Error('direction=importers requires a `file` argument (repo-relative path).');
+            return { file, importers: filesImportingFile(graph, file).slice(0, limit) };
+        }
+        case 'symbol_defs': {
+            if (!symbol)
+                throw new Error('direction=symbol_defs requires a `symbol` argument (the exported name, e.g. "authenticate").');
+            return { symbol, definedIn: filesDefiningSymbol(graph, symbol).slice(0, limit) };
+        }
+        case 'package_importers': {
+            const pkg = symbol ?? file;
+            if (!pkg)
+                throw new Error('direction=package_importers requires a `symbol` (or `file`) arg (the npm package name, e.g. "chalk").');
+            return { package: pkg, importers: filesImportingPackage(graph, pkg).slice(0, limit) };
+        }
+        default:
+            throw new Error(`unknown direction "${String(direction)}". Valid: imports, exports, importers, symbol_defs, package_importers.`);
+    }
+}
+//# sourceMappingURL=graphQuery.js.map

package/dist/core/graphQuery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphQuery.js","sourceRoot":"","sources":["../../src/core/graphQuery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,SAAS,EACT,SAAS,GAEV,MAAM,gBAAgB,CAAC;AAmBxB,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,KAAgB,EAAE,KAAsB;IACpE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;IAExG,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,wFAAwF,CAAC,CAAC;YACrH,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QACnE,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAC;YACjG,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QACnE,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;YACnG,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QAC9E,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,8FAA8F,CAAC,CAAC;YAC7H,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,mBAAmB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QACnF,CAAC;QACD,KAAK,mBAAmB,CAAC,CAAC,CAAC;YACzB,MAAM,GAAG,GAAG,MAAM,IAAI,IAAI,CAAC;YAC3B,IAAI,CAAC,GAAG;gBAAE,MAAM,IAAI,KAAK,CAAC,uGAAuG,CAAC,CAAC;YACnI,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,qBAAqB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;QACxF,CAAC;QACD;YACE,MAAM,IAAI,KAAK,CAAC,sBAAsB,MAAM,CAAC,SAAS,CAAC,wEAAwE,CAAC,CAAC;IACrI,CAAC;AACH,CAAC"}

package/dist/core/intentRouter.d.ts

@@ -26,10 +26,17 @@ export interface RouteEntry {
     /** Terms that signal this intent. */
     keywords: string[];
 }
+export type RouteConfidence = 'high' | 'medium' | 'low';
+export interface RouteMatch extends RouteEntry {
+    score: number;
+    rank: number;
+    confidence: RouteConfidence;
+    matchedKeywords: string[];
+}
 export interface RouteResult {
     intent: string | null;
     matched: boolean;
-    matches: RouteEntry[];
+    matches: RouteMatch[];
 }
 export declare const ROUTE_CATALOG: RouteEntry[];
 /**