@wrongstack/tools 0.298.3 → 0.300.0

package/dist/codebase-index/background-indexer.d.ts

@@ -26,9 +26,10 @@
  *    for the TUI status chip and the search/stats tools' gating.
  */
 import { type CircuitSnapshot } from './circuit-breaker.js';
+import { type IncomingCallsResult, type OutgoingCallsResult } from './index-service.js';
 import { type ProjectIndexServerClientHealth, type ProjectIndexServerConnectionState, type ProjectIndexServerShutdownResult } from './project-server-client.js';
 import type { CodeMapGraph, IndexResult, IndexStats } from './schema.js';
-import type { FileGraphOpArgs, SearchOpArgs, SearchOpResult, StatsOpArgs, SymbolGraphOpArgs } from './worker-protocol.js';
+import type { CallRefsOpArgs, FileGraphOpArgs, SearchOpArgs, SearchOpResult, StatsOpArgs, SymbolGraphOpArgs } from './worker-protocol.js';
 /** True once the first full-project index has completed (success or failure). */
 export declare function isIndexReady(): boolean;
 /**
@@ -112,6 +113,10 @@ export declare function packageGraphService(args: StatsOpArgs): Promise<CodeMapG
 export declare function fileGraphService(args: FileGraphOpArgs): Promise<CodeMapGraph>;
 /** Symbol dependency graph, served by the same per-project index process. */
 export declare function symbolGraphService(args: SymbolGraphOpArgs): Promise<CodeMapGraph>;
+/** Incoming call sites for a named symbol (who calls/uses this symbol?). */
+export declare function incomingCallsService(args: CallRefsOpArgs): Promise<IncomingCallsResult>;
+/** Outgoing call sites for a named symbol (what does this symbol call/use?). */
+export declare function outgoingCallsService(args: CallRefsOpArgs): Promise<OutgoingCallsResult>;
 /**
  * Stop this project's detached index server. Unlike
  * shutdownCodebaseIndexHost(), this intentionally affects every connected

package/dist/codebase-index/codebase-incoming-calls-tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `codebase-incoming-calls` tool — find all callers/users of a symbol.
+ *
+ * Usage: codebase-incoming-calls({
+ *   symbol: string,        // function/method/type name to look up
+ *   file?: string,         // scope to one file when multiple symbols share a name
+ *   limit?: number,        // max results (default 50, max 200)
+ * })
+ *
+ * Returns: [{ symbol: { name, kind, file, line, signature }, callType, line }, ...]
+ *
+ * The query executes against the SQLite index's refs graph — it resolves the
+ * symbol name to IDs, then finds every ref edge pointing TO those IDs. The
+ * result carries the caller's full metadata so no second lookup is needed.
+ */
+import type { Tool } from '@wrongstack/core/types';
+import type { CallSite } from './schema.js';
+export declare const codebaseIncomingCallsTool: Tool<IncomingCallsInput, IncomingCallsOutput>;
+interface IncomingCallsInput {
+    symbol: string;
+    file?: string | undefined;
+    limit?: number | undefined;
+}
+interface IncomingCallsOutput {
+    symbol: string;
+    calls: CallSite[];
+    total: number;
+    /** Non-empty when the index blocked the query (not ready, indexing, failed). */
+    indexStatus?: string | undefined;
+    /** Advisory note when the symbol was not found in the index. */
+    note?: string | undefined;
+}
+export {};
+//# sourceMappingURL=codebase-incoming-calls-tool.d.ts.map

package/dist/codebase-index/codebase-outgoing-calls-tool.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `codebase-outgoing-calls` tool — find all callees/dependencies of a symbol.
+ *
+ * Usage: codebase-outgoing-calls({
+ *   symbol: string,        // function/method/type name to look up
+ *   file?: string,         // scope to one file when multiple symbols share a name
+ *   limit?: number,        // max results (default 50, max 200)
+ * })
+ *
+ * Returns: [{ symbol: { name, kind, file, line, signature }, callType, line }, ...]
+ *
+ * The query executes against the SQLite index's refs graph — it resolves the
+ * symbol name to IDs, then finds every ref edge going FROM those IDs. The
+ * result carries the callee's full metadata so no second lookup is needed.
+ */
+import type { Tool } from '@wrongstack/core/types';
+import type { CallSite } from './schema.js';
+export declare const codebaseOutgoingCallsTool: Tool<OutgoingCallsInput, OutgoingCallsOutput>;
+interface OutgoingCallsInput {
+    symbol: string;
+    file?: string | undefined;
+    limit?: number | undefined;
+}
+interface OutgoingCallsOutput {
+    symbol: string;
+    calls: CallSite[];
+    total: number;
+    /** Non-empty when the index blocked the query (not ready, indexing, failed). */
+    indexStatus?: string | undefined;
+    /** Advisory note when the symbol was not found, or unresolved refs exist. */
+    note?: string | undefined;
+}
+export {};
+//# sourceMappingURL=codebase-outgoing-calls-tool.d.ts.map

package/dist/codebase-index/import-extractor.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Import extraction for languages without an AST parser.
+ *
+ * Deliberately imports only — no call or type references. An import statement
+ * has a rigid, line-anchored syntax that a regex reads correctly; a call site
+ * does not, and a regex "call graph" produces edges that look authoritative
+ * while being mostly wrong. Dependency edges are what the Code Atlas is built
+ * around, so extracting those well beats extracting everything badly.
+ *
+ * Languages with a real parser (TS/JS via the compiler API, Go and Python via
+ * their own `ast` modules) never reach this module.
+ */
+import type { Ref, SymbolLang } from './schema.js';
+/** Only the leading window is scanned, mirroring the generic symbol extractor. */
+export declare const IMPORT_MAX_FILE_CHARS: number;
+/** Upper bound on imports recorded per file. */
+export declare const IMPORT_MAX_PER_FILE = 400;
+/**
+ * The name a specifier refers to.
+ *
+ * Path-like and namespace-like specifiers need opposite treatment of the dot:
+ * in `engine/core.h` it introduces a file extension to strip, in
+ * `com.example.Helper` it is the segment separator. The presence of a path
+ * separator is what tells them apart.
+ */
+export declare function lastSegment(specifier: string): string;
+/** True when this language's imports are extracted here rather than by a parser. */
+export declare function hasImportPatterns(lang: SymbolLang): boolean;
+/**
+ * Extract `import` refs from source text. Never throws.
+ *
+ * Returned refs carry `fromId: 0`; the indexer rewrites it to the owning symbol.
+ */
+export declare function extractImports(opts: {
+    content: string;
+    lang: SymbolLang;
+    maxImports?: number;
+}): Ref[];
+//# sourceMappingURL=import-extractor.d.ts.map

package/dist/codebase-index/index-service.d.ts

@@ -11,8 +11,8 @@
  * run on one event loop, so a pooled connection is both safe and substantially
  * cheaper than re-running schema/FTS drift checks for every edited file.
  */
-import type { CodeMapGraph, IndexResult, IndexStats } from './schema.js';
-import type { IndexOpArgs, SearchOpArgs, SearchOpResult, StatsOpArgs } from './worker-protocol.js';
+import type { CallSite, CodeMapGraph, IndexResult, IndexStats } from './schema.js';
+import type { CallRefsOpArgs, IndexOpArgs, SearchOpArgs, SearchOpResult, StatsOpArgs } from './worker-protocol.js';
 export interface ServiceHooks {
     signal?: AbortSignal | undefined;
     onProgress?: ((current: number, total: number) => void) | undefined;
@@ -33,4 +33,26 @@ export declare function fileGraphService(args: StatsOpArgs & {
 export declare function symbolGraphService(args: StatsOpArgs & {
     fileFilter: string;
 }): CodeMapGraph;
+/** Result of an incoming calls query. */
+export interface IncomingCallsResult {
+    calls: CallSite[];
+    symbolFound: boolean;
+    /** True when `file` was scoped but the name is ambiguous (other files define it too). */
+    ambiguous: boolean;
+    /** Total matching call sites before the limit was applied. */
+    totalMatches: number;
+}
+/** Result of an outgoing calls query. */
+export interface OutgoingCallsResult {
+    calls: CallSite[];
+    symbolFound: boolean;
+    /** Number of refs whose target could not be resolved (to_id IS NULL). */
+    unresolvedCount: number;
+    /** Total matching call sites before the limit was applied. */
+    totalMatches: number;
+}
+/** Incoming call sites for a named symbol (who calls/uses this symbol?). */
+export declare function incomingCallsService(args: CallRefsOpArgs): IncomingCallsResult;
+/** Outgoing call sites for a named symbol (what does this symbol call/use?). */
+export declare function outgoingCallsService(args: CallRefsOpArgs): OutgoingCallsResult;
 //# sourceMappingURL=index-service.d.ts.map

package/dist/codebase-index/index.d.ts

@@ -14,11 +14,13 @@
  * Ranking: Okapi BM25 / FTS5 (k1=1.5, b=0.75)
  */
 export { resolveProjectIndexDaemonAvailability, type ProjectIndexDaemonAvailability, } from './project-server-client.js';
-export { cancelPendingReindexes, checkCodebaseIndexServerHealth, codebaseIndexStats, enqueueReindex, ensureCodebaseIndexServer, fileGraphService, getIndexState, isIndexableFile, isIndexing, isIndexReady, onIndexStateChange, packageGraphService, runStartupIndex, searchCodebaseIndex, shutdownCodebaseIndexHost, shutdownCodebaseIndexServer, symbolGraphService, } from './background-indexer.js';
+export { cancelPendingReindexes, checkCodebaseIndexServerHealth, codebaseIndexStats, enqueueReindex, ensureCodebaseIndexServer, fileGraphService, getIndexState, incomingCallsService, isIndexableFile, isIndexing, isIndexReady, onIndexStateChange, outgoingCallsService, packageGraphService, runStartupIndex, searchCodebaseIndex, shutdownCodebaseIndexHost, shutdownCodebaseIndexServer, symbolGraphService, } from './background-indexer.js';
 export { buildBm25Index, buildIndexableText, tokenise, } from './bm25.js';
 export type { CircuitSnapshot, CircuitState } from './circuit-breaker.js';
 export { CircuitOpenError, IndexCircuitBreaker, IndexTimeoutError, indexCircuitBreaker, resetIndexCircuitBreaker, } from './circuit-breaker.js';
 export { codebaseIndexTool } from './codebase-index-tool.js';
+export { codebaseIncomingCallsTool } from './codebase-incoming-calls-tool.js';
+export { codebaseOutgoingCallsTool } from './codebase-outgoing-calls-tool.js';
 export { codebaseSearchTool } from './codebase-search-tool.js';
 export { codebaseStatsTool } from './codebase-stats-tool.js';
 export { deadCodeScanTool, runDeadCodeScan } from './dead-code-scan.js';
@@ -28,7 +30,7 @@ export { detectLang, INDEXABLE_EXTENSIONS, isIndexablePath } from './languages.j
 export { internalKindToLspKind, lspKindToInternalKind, } from './lsp-kind.js';
 export type { ProjectIndexServerClientHealth, ProjectIndexServerConnectionState, ProjectIndexServerConnectionStatus, } from './project-server-client.js';
 export type { ProjectIndexServerActivity, ProjectIndexServerHealth, } from './project-server-protocol.js';
-export type { CodeMapGraph, FileMeta, FileSymbols, GraphEdge, GraphNode, IndexResult, IndexStats, SearchResult, Symbol, SymbolKind, SymbolLang, } from './schema.js';
+export type { CallSite, CodeMapGraph, FileMeta, FileSymbols, GraphEdge, GraphNode, IndexResult, IndexStats, SearchResult, Symbol, SymbolKind, SymbolLang, } from './schema.js';
 export { SCHEMA_VERSION } from './schema.js';
 export { codebaseIndexDirOverride, IndexStore, resolveIndexDir } from './writer.js';
 //# sourceMappingURL=index.d.ts.map