@wrongstack/tools 0.284.0 → 0.285.0

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

@@ -0,0 +1,28 @@
+import type { Context } from '@wrongstack/core';
+import type { IndexResult } from './schema.js';
+interface IndexerOptions {
+    projectRoot: string;
+    files?: string[] | undefined;
+    force?: boolean | undefined;
+    langs?: string[] | undefined;
+    ignore?: string[] | undefined;
+    /** Override the index directory (default: the global per-project dir). */
+    indexDir?: string | undefined;
+    /**
+     * Signal that cancels indexing cooperatively. Polled at yield points
+     * (file walk, per-file loop) so a hung filesystem won't lock up the
+     * process. When the tool executor's timeout fires, this signal aborts
+     * and `runIndexer` throws, releasing the mutex and resetting flags.
+     */
+    signal?: AbortSignal | undefined;
+    /**
+     * Per-file progress callback. Injected by the caller instead of imported
+     * from the host's module state so the indexer can run inside a worker
+     * thread (worker posts progress messages; inline host updates its state).
+     */
+    onProgress?: ((current: number, total: number) => void) | undefined;
+}
+/** Run a full or incremental index and return statistics. */
+export declare function runIndexer(_ctx: Context, opts: IndexerOptions): Promise<IndexResult>;
+export {};
+//# sourceMappingURL=indexer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"indexer.d.ts","sourceRoot":"","sources":["../../src/codebase-index/indexer.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,OAAO,KAAK,EAAY,WAAW,EAA0C,MAAM,aAAa,CAAC;AA6CjG,UAAU,cAAc;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B;;;;;OAKG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACjC;;;;OAIG;IACH,UAAU,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACrE;AAmGD,6DAA6D;AAC7D,wBAAsB,UAAU,CAC9B,IAAI,EAAE,OAAO,EACb,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,WAAW,CAAC,CAatB"}

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

@@ -0,0 +1,8 @@
+import type { FileSymbols, SymbolLang } from './schema.js';
+export declare function parseSymbols(opts: {
+    file: string;
+    content: string;
+    lang: SymbolLang;
+}): FileSymbols;
+export { detectLang } from './ts-parser.js';
+//# sourceMappingURL=json-parser.d.ts.map

package/dist/codebase-index/json-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-parser.d.ts","sourceRoot":"","sources":["../../src/codebase-index/json-parser.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,WAAW,EAAyB,UAAU,EAAE,MAAM,aAAa,CAAC;AAGlF,wBAAgB,YAAY,CAAC,IAAI,EAAE;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;CAClB,GAAG,WAAW,CASd;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,53 @@
+/**
+ * LSP SymbolKind mapping utilities.
+ *
+ * LSP SymbolKind numbers are defined by vscode-languageserver-protocol.
+ * This module maps between LSP kind numbers and the internal SymbolKind taxonomy.
+ */
+import type { SymbolKind } from './schema.js';
+/**
+ * LSP SymbolKind values (1–26) as defined by vscode-languageserver-protocol.
+ */
+export declare enum LSPSymbolKind {
+    File = 1,
+    Module = 2,
+    Namespace = 3,
+    Package = 4,
+    Class = 5,
+    Method = 6,
+    Property = 7,
+    Field = 8,
+    Constructor = 9,
+    Enum = 10,
+    Interface = 11,
+    Function = 12,
+    Variable = 13,
+    Constant = 14,
+    String = 15,
+    Number = 16,
+    Boolean = 17,
+    Array = 18,
+    Object = 19,
+    Key = 20,
+    Null = 21,
+    EnumMember = 22,
+    Struct = 23,
+    Event = 24,
+    Operator = 25,
+    TypeParameter = 26
+}
+/**
+ * Maps an LSP kind number to the corresponding internal SymbolKind.
+ * Returns null if the LSP kind has no equivalent in the internal taxonomy.
+ */
+export declare function lspKindToInternalKind(k: number): SymbolKind | null;
+/**
+ * Maps an internal SymbolKind to the corresponding LSP kind number.
+ * Returns null if the internal kind has no equivalent LSP kind.
+ */
+export declare function internalKindToLspKind(k: SymbolKind): number | null;
+/**
+ * Returns true if `k` is a valid LSP SymbolKind number (1–26).
+ */
+export declare function isLspKind(k: number): boolean;
+//# sourceMappingURL=lsp-kind.d.ts.map

package/dist/codebase-index/lsp-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-kind.d.ts","sourceRoot":"","sources":["../../src/codebase-index/lsp-kind.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C;;GAEG;AACH,oBAAY,aAAa;IACvB,IAAI,IAAI;IACR,MAAM,IAAI;IACV,SAAS,IAAI;IACb,OAAO,IAAI;IACX,KAAK,IAAI;IACT,MAAM,IAAI;IACV,QAAQ,IAAI;IACZ,KAAK,IAAI;IACT,WAAW,IAAI;IACf,IAAI,KAAK;IACT,SAAS,KAAK;IACd,QAAQ,KAAK;IACb,QAAQ,KAAK;IACb,QAAQ,KAAK;IACb,MAAM,KAAK;IACX,MAAM,KAAK;IACX,OAAO,KAAK;IACZ,KAAK,KAAK;IACV,MAAM,KAAK;IACX,GAAG,KAAK;IACR,IAAI,KAAK;IACT,UAAU,KAAK;IACf,MAAM,KAAK;IACX,KAAK,KAAK;IACV,QAAQ,KAAK;IACb,aAAa,KAAK;CACnB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAiBlE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAgBlE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE5C"}

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

@@ -0,0 +1,16 @@
+/**
+ * Python source symbol extraction using the `ast` module.
+ *
+ * Spawns a `python -c` child process that parses the file with Python's `ast`
+ * module and emits JSON. Falls back to empty results on any error.
+ *
+ * Extracts: class, function, async function, const, var, import, import_from
+ */
+import type { FileSymbols, SymbolLang } from './schema.js';
+export declare function parseSymbols(opts: {
+    file: string;
+    content: string;
+    lang: SymbolLang;
+}): Promise<FileSymbols>;
+export { detectLang } from './ts-parser.js';
+//# sourceMappingURL=py-parser.d.ts.map

package/dist/codebase-index/py-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"py-parser.d.ts","sourceRoot":"","sources":["../../src/codebase-index/py-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAyB,UAAU,EAAE,MAAM,aAAa,CAAC;AAIlF,wBAAsB,YAAY,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CASlH;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * Unified cross-reference extraction across all supported languages.
+ *
+ * `extractRefs(file, content, lang)` → returns `Ref[]`
+ *
+ * Each language has its own approach:
+ * - TS/JS: uses the TypeScript Compiler API (imported from ts-parser.ts)
+ * - Go: inline `go run <script>` script using go/ast to walk CallExpr, SelectorExpr, Ident, ImportSpec
+ * - Python: inline `python -c` script using ast to walk Call, Name, Attribute, Subscript, Import, ImportFrom
+ */
+import type { Ref, SymbolLang } from './schema.js';
+export interface ExtractRefsOptions {
+    file: string;
+    content: string;
+    lang: SymbolLang;
+}
+/**
+ * Extract cross-references (calls, type refs, imports) from a source file.
+ * Returns an array of `Ref` objects with `fromId: 0` (caller fills this in).
+ *
+ * Falls back to an empty array if the language is not supported or the
+ * child process fails.
+ */
+export declare function extractRefs(opts: ExtractRefsOptions): Promise<Ref[]>;
+//# sourceMappingURL=refs-extractor.d.ts.map

package/dist/codebase-index/refs-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs-extractor.d.ts","sourceRoot":"","sources":["../../src/codebase-index/refs-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAkKnD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAmB1E"}

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

@@ -0,0 +1,8 @@
+import type { FileSymbols, SymbolLang } from './schema.js';
+export declare function parseSymbols(opts: {
+    file: string;
+    content: string;
+    lang: SymbolLang;
+}): Promise<FileSymbols>;
+export { detectLang } from './ts-parser.js';
+//# sourceMappingURL=rs-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rs-parser.d.ts","sourceRoot":"","sources":["../../src/codebase-index/rs-parser.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,WAAW,EAAyB,UAAU,EAAE,MAAM,aAAa,CAAC;AAGlF,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;CAClB,GAAG,OAAO,CAAC,WAAW,CAAC,CAWvB;AAED,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

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

@@ -0,0 +1,82 @@
+/** Language a symbol belongs to. */
+export type SymbolLang = 'ts' | 'js' | 'tsx' | 'jsx' | 'go' | 'py' | 'rs' | 'json' | 'yaml';
+/** What kind of symbol this is. */
+export type SymbolKind = 'class' | 'interface' | 'enum' | 'type' | 'function' | 'method' | 'var' | 'const' | 'let' | 'property' | 'parameter' | 'namespace' | 'object' | 'literal' | 'schema' | 'struct' | 'trait' | 'impl' | 'static' | 'mod';
+/** A single indexed code symbol. */
+export interface Symbol {
+    id: number;
+    lang: SymbolLang;
+    kind: SymbolKind;
+    name: string;
+    file: string;
+    line: number;
+    col: number;
+    signature: string;
+    docComment: string;
+    scope: string;
+    text: string;
+}
+/** Extracted symbols and cross-references for one file. */
+export interface FileSymbols {
+    file: string;
+    lang: SymbolLang;
+    symbols: Symbol[];
+    refs?: Ref[] | undefined;
+    mtimeMs: number;
+}
+/** Source file metadata tracked for incremental indexing. */
+export interface FileMeta {
+    file: string;
+    lang: SymbolLang;
+    mtimeMs: number;
+    symbolCount: number;
+    lastIndexed: number;
+}
+/** Statistics about the index. */
+export interface IndexStats {
+    totalSymbols: number;
+    totalFiles: number;
+    byLang: Record<SymbolLang, number>;
+    byKind: Record<SymbolKind, number>;
+    indexPath: string;
+    lastIndexed: number | null;
+    sizeBytes: number;
+    version: number;
+}
+/** Result of a search query. */
+export interface SearchResult {
+    id: number;
+    name: string;
+    kind: SymbolKind;
+    lang: SymbolLang;
+    file: string;
+    line: number;
+    col: number;
+    signature: string;
+    docComment: string;
+    score: number;
+    snippet: string;
+    /** Original LSP SymbolKind number if the result was filtered by an LSP kind. */
+    lspKind?: number | undefined;
+}
+/** Result of a full reindex. */
+export interface IndexResult {
+    filesIndexed: number;
+    symbolsIndexed: number;
+    langStats: Record<SymbolLang, number>;
+    durationMs: number;
+    errors: string[];
+}
+/** What kind of reference this is. */
+export type CallType = 'call' | 'type_ref' | 'inherit' | 'implement' | 'import';
+/** A cross-reference between two symbols (who references whom). */
+export interface Ref {
+    id?: number | undefined;
+    fromId: number;
+    toName: string;
+    toId?: number | undefined;
+    callType: CallType;
+    line: number;
+}
+export declare const SCHEMA_VERSION = 2;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/codebase-index/schema.ts"],"names":[],"mappings":"AAEA,oCAAoC;AACpC,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5F,mCAAmC;AACnC,MAAM,MAAM,UAAU,GAClB,OAAO,GACP,WAAW,GACX,MAAM,GACN,MAAM,GACN,UAAU,GACV,QAAQ,GACR,KAAK,GACL,OAAO,GACP,KAAK,GACL,UAAU,GACV,WAAW,GACX,WAAW,GACX,QAAQ,GACR,SAAS,GACT,QAAQ,GAER,QAAQ,GACR,OAAO,GACP,MAAM,GACN,QAAQ,GACR,KAAK,CAAC;AAEV,oCAAoC;AACpC,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,2DAA2D;AAC3D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,CAAC,EAAE,GAAG,EAAE,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,6DAA6D;AAC7D,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,kCAAkC;AAClC,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnC,MAAM,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gCAAgC;AAChC,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,gCAAgC;AAChC,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAID,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEhF,mEAAmE;AACnE,MAAM,WAAW,GAAG;IAClB,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,eAAO,MAAM,cAAc,IAAI,CAAC"}

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

@@ -0,0 +1,30 @@
+/**
+ * TypeScript/JavaScript symbol extraction using the TypeScript Compiler API.
+ *
+ * We traverse the AST and collect:
+ * - classes, interfaces, enums, type aliases  → class|interface|enum|type
+ * - functions and methods                       → function|method
+ * - const/let/var declarations                 → const|let|var
+ * - property/accessor declarations            → property
+ *
+ * The `id` field on each Symbol is always 0 — the caller is responsible for
+ * assigning unique ids during insertion.
+ */
+import type { FileSymbols, SymbolLang } from './schema.js';
+export interface ParseOptions {
+    file: string;
+    content: string;
+    lang: SymbolLang;
+}
+/**
+ * Parse a TypeScript/JavaScript source file and extract all code symbols.
+ *
+ * The returned `Symbol.id` field is always `0` — the caller is responsible
+ * for assigning unique numeric ids during bulk insertion.
+ *
+ * Returns an empty array for files that can't be parsed or contain no symbols.
+ */
+export declare function parseSymbols(opts: ParseOptions): FileSymbols;
+/** Detect SymbolLang from a file path extension. */
+export declare function detectLang(file: string): SymbolLang | null;
+//# sourceMappingURL=ts-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ts-parser.d.ts","sourceRoot":"","sources":["../../src/codebase-index/ts-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,WAAW,EAA0C,UAAU,EAAE,MAAM,aAAa,CAAC;AAoHnG,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,WAAW,CAmD5D;AAqED,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAI1D"}

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

@@ -0,0 +1,77 @@
+/**
+ * Message protocol between the index host (main thread) and the index worker.
+ *
+ * Plain structured-cloneable shapes only — no class instances, no functions.
+ * Errors cross the boundary as strings and are re-wrapped by the host.
+ */
+import type { IndexResult, IndexStats, SearchResult } from './schema.js';
+export interface IndexOpArgs {
+    projectRoot: string;
+    indexDir?: string | undefined;
+    files?: string[] | undefined;
+    force?: boolean | undefined;
+    langs?: string[] | undefined;
+    ignore?: string[] | undefined;
+}
+export interface SearchOpArgs {
+    projectRoot: string;
+    indexDir?: string | undefined;
+    query: string;
+    kind?: string | undefined;
+    lang?: string | undefined;
+    file?: string | undefined;
+    lspKind?: number | undefined;
+    limit: number;
+}
+export interface StatsOpArgs {
+    projectRoot: string;
+    indexDir?: string | undefined;
+}
+export interface SearchOpResult {
+    results: SearchResult[];
+    total: number;
+}
+/** Map of op name → { args, result } so host and worker stay in lockstep. */
+export interface OpShapes {
+    index: {
+        args: IndexOpArgs;
+        result: IndexResult;
+    };
+    search: {
+        args: SearchOpArgs;
+        result: SearchOpResult;
+    };
+    stats: {
+        args: StatsOpArgs;
+        result: IndexStats;
+    };
+}
+export type OpName = keyof OpShapes;
+export type HostToWorker = {
+    type: 'request';
+    id: number;
+    op: OpName;
+    args: OpShapes[OpName]['args'];
+}
+/** Cooperative cancel — aborts the op's signal; the watchdog terminate is the backstop. */
+ | {
+    type: 'cancel';
+    id: number;
+};
+export type WorkerToHost = {
+    type: 'response';
+    id: number;
+    ok: true;
+    result: unknown;
+} | {
+    type: 'response';
+    id: number;
+    ok: false;
+    error: string;
+} | {
+    type: 'progress';
+    id: number;
+    current: number;
+    total: number;
+};
+//# sourceMappingURL=worker-protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker-protocol.d.ts","sourceRoot":"","sources":["../../src/codebase-index/worker-protocol.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAIzE,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,6EAA6E;AAC7E,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,CAAC;IAClD,MAAM,EAAE;QAAE,IAAI,EAAE,YAAY,CAAC;QAAC,MAAM,EAAE,cAAc,CAAA;KAAE,CAAC;IACvD,KAAK,EAAE;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,MAAM,EAAE,UAAU,CAAA;KAAE,CAAC;CAClD;AAED,MAAM,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;AAIpC,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAA;CAAE;AAC7E,2FAA2F;GACzF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnC,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC"}

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

@@ -1,2 +1,16 @@
-
-export {  }
+/**
+ * Index worker entry point.
+ *
+ * Hosts ALL SQLite access and source parsing off the main thread. The
+ * synchronous `node:sqlite` calls and the TypeScript compiler can block this
+ * thread freely — the terminal UI never notices. If this thread truly wedges
+ * (pathological parse, cross-process lock storm), the host's watchdog calls
+ * `worker.terminate()` and respawns lazily; the index is derived data, so the
+ * worst case is a re-run, never a frozen terminal.
+ *
+ * Protocol: see worker-protocol.ts. Requests are processed concurrently
+ * (operations open their own store; host-side mutex already serializes
+ * writes), each carrying an AbortController for cooperative cancellation.
+ */
+export {};
+//# sourceMappingURL=worker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/codebase-index/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}