@wrongstack/tools 0.299.0 → 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,29 @@ 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.
@@ -161,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