@wrongstack/tools 0.298.3 → 0.300.0

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

@@ -1,3 +1,25 @@
+/**
+ * Rust source symbol extraction.
+ *
+ * Extracts fn, struct, enum, trait, impl, type, const, static and mod with
+ * line-anchored regexes. Dependency edges do not come from here — `use` and
+ * `mod` declarations are read by `import-extractor.ts` and resolved against the
+ * crate's `Cargo.toml` by `module-resolver.ts`.
+ *
+ * ### Why there is no native `syn` parser
+ *
+ * There used to be a path that shelled out to a cargo subproject for real AST
+ * parsing. It resolved that subproject relative to `process.cwd()` — the
+ * *indexed project*, not the wstack installation — and the crate has never
+ * existed in this repository. So the branch was unreachable except in the one
+ * case where it must never fire: an indexed repository that happens to contain
+ * `tools/Cargo.toml`, where indexing would have run `cargo run` inside the
+ * user's checkout and written to `tools/syn-parser/src/input.rs`.
+ *
+ * Indexing reads a repository; it does not execute its build or write to its
+ * working tree. Reinstating native parsing means shipping the crate inside the
+ * wstack installation and resolving it from there — never from the scan target.
+ */
 import type { FileSymbols, SymbolLang } from './schema.js';
 export declare function parseSymbols(opts: {
     file: string;

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

@@ -95,6 +95,52 @@ export interface Ref {
     toId?: number | undefined;
     callType: CallType;
     line: number;
+    /**
+     * Language of the *referencing* file. Name resolution (`toName` → `toId`) is
+     * scoped to the referencing language's family, because a global name match
+     * links unrelated declarations across languages: `New`/`Get`/`String` in Go,
+     * `main`/`__init__` in Python and TS all collide otherwise.
+     */
+    lang?: SymbolLang | undefined;
+    /**
+     * Module specifier for `import` refs, verbatim as written in the source
+     * (`./foo.js`, `github.com/org/repo/pkg`, `os.path`, `crate::parser`,
+     * `com.example.Thing`). `undefined` for every other ref kind.
+     *
+     * This is deliberately separate from {@link toName}: TS/JS import refs put
+     * the imported *symbol* name in `toName` so the dead-code BFS can traverse
+     * module boundaries, which means `toName` cannot also carry the module path.
+     */
+    module?: string | undefined;
+    /**
+     * Target file an `import` ref resolves to, filled by the post-index module
+     * resolution pass. Absolute path, or `undefined` for external/unresolvable
+     * modules (stdlib, third-party dependencies).
+     */
+    toFile?: string | undefined;
+}
+/**
+ * A call site — the enriched result of an incoming/outgoing calls query.
+ *
+ * Unlike the raw `Ref` type, this carries the full caller/callee symbol
+ * metadata (name, kind, file, line, signature) so the agent gets a
+ * self-contained answer without a second lookup.
+ */
+export interface CallSite {
+    /** The symbol that makes or receives the call. */
+    symbol: {
+        id: number;
+        name: string;
+        kind: SymbolKind;
+        lang: SymbolLang;
+        file: string;
+        line: number;
+        signature: string;
+    };
+    /** Kind of reference: call, type_ref, inherit, implement, import. */
+    callType: CallType;
+    /** Source line where the reference occurs. */
+    line: number;
 }
 /** A node in the code-map dependency graph. */
 export interface GraphNode {
@@ -138,5 +184,5 @@ export interface CodeMapGraph {
     nodes: GraphNode[];
     edges: GraphEdge[];
 }
-export declare const SCHEMA_VERSION = 3;
+export declare const SCHEMA_VERSION = 4;
 //# sourceMappingURL=schema.d.ts.map

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

@@ -5,6 +5,7 @@
  * Errors cross the boundary as strings and are re-wrapped by the host.
  */
 import type { CodeMapGraph, IndexResult, IndexStats, SearchResult } from './schema.js';
+import type { IncomingCallsResult, OutgoingCallsResult } from './index-service.js';
 export interface IndexOpArgs {
     projectRoot: string;
     indexDir?: string | undefined;
@@ -33,6 +34,11 @@ export interface FileGraphOpArgs extends StatsOpArgs {
 export interface SymbolGraphOpArgs extends StatsOpArgs {
     fileFilter: string;
 }
+export interface CallRefsOpArgs extends StatsOpArgs {
+    symbol: string;
+    file?: string | undefined;
+    limit?: number | undefined;
+}
 export interface SearchOpResult {
     results: SearchResult[];
     total: number;
@@ -63,6 +69,14 @@ export interface OpShapes {
         args: SymbolGraphOpArgs;
         result: CodeMapGraph;
     };
+    incomingCalls: {
+        args: CallRefsOpArgs;
+        result: IncomingCallsResult;
+    };
+    outgoingCalls: {
+        args: CallRefsOpArgs;
+        result: OutgoingCallsResult;
+    };
 }
 export type OpName = keyof OpShapes;
 export type HostToWorker = {