argustack 0.1.33 → 0.2.0

package/dist/code-intel/resolver.js

@@ -0,0 +1,59 @@
+/**
+ * Resolve raw call sites (callee identifier text) into qualified-name edges
+ * by matching against the symbol index built so far.
+ *
+ * v1 implementation: name-based lookup. LSP-based exact resolution is wired
+ * via `ISymbolResolver` in code-intel/ when LSP is available.
+ */
+export class SymbolResolver {
+    index = new Map();
+    constructor(symbols) {
+        for (const sym of symbols) {
+            const list = this.index.get(sym.name);
+            if (list) {
+                list.push(sym);
+            }
+            else {
+                this.index.set(sym.name, [sym]);
+            }
+        }
+    }
+    resolveCalls(projectId, parsed) {
+        const edges = [];
+        const counts = new Map();
+        for (const call of parsed.rawCalls) {
+            const calleeName = extractIdentifier(call.calleeText);
+            if (!calleeName) {
+                continue;
+            }
+            const candidates = this.index.get(calleeName);
+            if (!candidates || candidates.length === 0) {
+                continue;
+            }
+            const sameFile = candidates.find((c) => c.filePath === parsed.filePath);
+            const target = sameFile ?? candidates[0];
+            if (!target) {
+                continue;
+            }
+            const key = `${call.fromQn}->${target.qualifiedName}`;
+            counts.set(key, (counts.get(key) ?? 0) + 1);
+        }
+        for (const [key, count] of counts) {
+            const sep = key.indexOf('->');
+            const fromQn = key.slice(0, sep);
+            const toQn = key.slice(sep + 2);
+            edges.push({ projectId, fromQn, toQn, count });
+        }
+        return edges;
+    }
+}
+function extractIdentifier(calleeText) {
+    const trimmed = calleeText.trim();
+    const lastDot = trimmed.lastIndexOf('.');
+    const name = lastDot === -1 ? trimmed : trimmed.slice(lastDot + 1);
+    if (!/^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name)) {
+        return null;
+    }
+    return name;
+}
+//# sourceMappingURL=resolver.js.map

package/dist/code-intel/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/code-intel/resolver.ts"],"names":[],"mappings":"AAMA;;;;;;GAMG;AACH,MAAM,OAAO,cAAc;IACR,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAEzD,YAAY,OAAqB;QAC/B,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACtC,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACjB,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;IACH,CAAC;IAED,YAAY,CAAC,SAAiB,EAAE,MAAkB;QAChD,MAAM,KAAK,GAAmB,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;QACzC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACtD,IAAI,CAAC,UAAU,EAAE,CAAC;gBAAA,SAAS;YAAA,CAAC;YAC5B,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC9C,IAAI,CAAC,UAAU,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAAA,SAAS;YAAA,CAAC;YACvD,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,CAAC,CAAC;YACxE,MAAM,MAAM,GAAG,QAAQ,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,EAAE,CAAC;gBAAA,SAAS;YAAA,CAAC;YACxB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,aAAa,EAAE,CAAC;YACtD,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YAClC,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;YAChC,KAAK,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACjD,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,SAAS,iBAAiB,CAAC,UAAkB;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IACnE,IAAI,CAAC,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAAA,OAAO,IAAI,CAAC;IAAA,CAAC;IAC5D,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/code-intel/tsconfig-paths.d.ts

@@ -0,0 +1,11 @@
+export interface PathAlias {
+    pattern: RegExp;
+    targets: string[];
+}
+/**
+ * Parse `tsconfig.json` paths (and `extends`) into regex aliases.
+ * Returns empty array when no tsconfig or no paths field — caller falls back
+ * to relative-path resolution.
+ */
+export declare function loadTsconfigPaths(projectRoot: string): Promise<PathAlias[]>;
+//# sourceMappingURL=tsconfig-paths.d.ts.map

package/dist/code-intel/tsconfig-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig-paths.d.ts","sourceRoot":"","sources":["../../src/code-intel/tsconfig-paths.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAYjF"}

package/dist/code-intel/tsconfig-paths.js

@@ -0,0 +1,67 @@
+import { readFile } from 'node:fs/promises';
+import { join, resolve, dirname } from 'node:path';
+/**
+ * Parse `tsconfig.json` paths (and `extends`) into regex aliases.
+ * Returns empty array when no tsconfig or no paths field — caller falls back
+ * to relative-path resolution.
+ */
+export async function loadTsconfigPaths(projectRoot) {
+    const merged = await readMerged(join(projectRoot, 'tsconfig.json'), new Set());
+    const baseUrl = merged?.compilerOptions?.baseUrl ?? '.';
+    const paths = merged?.compilerOptions?.paths ?? {};
+    const absBase = resolve(projectRoot, baseUrl);
+    const aliases = [];
+    for (const [key, targets] of Object.entries(paths)) {
+        const pattern = aliasToRegex(key);
+        const absTargets = targets.map((t) => resolve(absBase, t));
+        aliases.push({ pattern, targets: absTargets });
+    }
+    return aliases;
+}
+async function readMerged(path, visited) {
+    if (visited.has(path)) {
+        return null;
+    }
+    visited.add(path);
+    let raw;
+    try {
+        raw = await readFile(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    let json;
+    try {
+        json = JSON.parse(stripJsonComments(raw));
+    }
+    catch {
+        return null;
+    }
+    if (json.extends) {
+        const parentPath = resolve(dirname(path), json.extends);
+        const parent = await readMerged(parentPath, visited);
+        if (parent) {
+            return {
+                compilerOptions: {
+                    ...parent.compilerOptions,
+                    ...json.compilerOptions,
+                    paths: {
+                        ...(parent.compilerOptions?.paths ?? {}),
+                        ...(json.compilerOptions?.paths ?? {}),
+                    },
+                },
+            };
+        }
+    }
+    return json;
+}
+function aliasToRegex(key) {
+    const escaped = key.replace(/[.+?^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '(.*)');
+    return new RegExp(`^${escaped}$`);
+}
+function stripJsonComments(input) {
+    return input
+        .replace(/\/\*[\s\S]*?\*\//g, '')
+        .replace(/(^|[^:])\/\/.*$/gm, '$1');
+}
+//# sourceMappingURL=tsconfig-paths.js.map

package/dist/code-intel/tsconfig-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tsconfig-paths.js","sourceRoot":"","sources":["../../src/code-intel/tsconfig-paths.ts"],"names":[],"mappings":"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"}

package/dist/code-intel/watcher.d.ts

@@ -0,0 +1,27 @@
+import { EventEmitter } from 'node:events';
+import type { CodeIndexer } from './indexer.js';
+export interface CodeWatcherEvents {
+    started: () => void;
+    ready: () => void;
+    'fileIndexed': (relPath: string) => void;
+    'fileRemoved': (relPath: string) => void;
+    error: (err: Error) => void;
+}
+export interface CodeWatcherOptions {
+    root: string;
+    indexer: CodeIndexer;
+    debounceMs?: number;
+}
+export declare class CodeWatcher extends EventEmitter {
+    private readonly opts;
+    private watcher;
+    private readonly pending;
+    private readonly debounce;
+    constructor(opts: CodeWatcherOptions);
+    start(): void;
+    stop(): Promise<void>;
+    private queueIndex;
+    private queueRemove;
+    private schedule;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/code-intel/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../../src/code-intel/watcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAehD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,KAAK,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,WAAY,SAAQ,YAAY;IAK/B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAJjC,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqC;IAC7D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEL,IAAI,EAAE,kBAAkB;IAKrD,KAAK,IAAI,IAAI;IAmBP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAW3B,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,QAAQ;CASjB"}

package/dist/code-intel/watcher.js

@@ -0,0 +1,93 @@
+import { EventEmitter } from 'node:events';
+import chokidar from 'chokidar';
+const DEBOUNCE_MS = 500;
+const SUPPORTED_EXT = /\.(?:m|c)?(?:t|j)sx?$/;
+const IGNORED_PATTERNS = [
+    /(^|[/\\])node_modules([/\\]|$)/,
+    /(^|[/\\])\.git([/\\]|$)/,
+    /(^|[/\\])\.next([/\\]|$)/,
+    /(^|[/\\])dist([/\\]|$)/,
+    /(^|[/\\])\.argustack([/\\]|$)/,
+    /\.swp$/,
+    /\.tmp$/,
+    /~$/,
+];
+export class CodeWatcher extends EventEmitter {
+    opts;
+    watcher = null;
+    pending = new Map();
+    debounce;
+    constructor(opts) {
+        super();
+        this.opts = opts;
+        this.debounce = opts.debounceMs ?? DEBOUNCE_MS;
+    }
+    start() {
+        if (this.watcher) {
+            return;
+        }
+        const watcher = chokidar.watch(this.opts.root, {
+            ignored: (path) => IGNORED_PATTERNS.some((p) => p.test(path)),
+            ignoreInitial: true,
+            persistent: true,
+            awaitWriteFinish: { stabilityThreshold: 100, pollInterval: 50 },
+        });
+        watcher.on('add', (path) => { this.queueIndex(path); });
+        watcher.on('change', (path) => { this.queueIndex(path); });
+        watcher.on('unlink', (path) => { this.queueRemove(path); });
+        watcher.on('error', (err) => this.emit('error', err));
+        watcher.on('ready', () => this.emit('ready'));
+        this.watcher = watcher;
+        this.emit('started');
+    }
+    async stop() {
+        for (const timer of this.pending.values()) {
+            clearTimeout(timer);
+        }
+        this.pending.clear();
+        if (this.watcher) {
+            await this.watcher.close();
+            this.watcher = null;
+        }
+    }
+    queueIndex(path) {
+        if (!SUPPORTED_EXT.test(path)) {
+            return;
+        }
+        this.schedule(path, async () => {
+            try {
+                await this.opts.indexer.indexFile(path);
+                this.emit('fileIndexed', path);
+            }
+            catch (error) {
+                this.emit('error', error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+    }
+    queueRemove(path) {
+        if (!SUPPORTED_EXT.test(path)) {
+            return;
+        }
+        this.schedule(path, async () => {
+            try {
+                await this.opts.indexer.removeFile(path);
+                this.emit('fileRemoved', path);
+            }
+            catch (error) {
+                this.emit('error', error instanceof Error ? error : new Error(String(error)));
+            }
+        });
+    }
+    schedule(path, fn) {
+        const existing = this.pending.get(path);
+        if (existing) {
+            clearTimeout(existing);
+        }
+        const timer = setTimeout(() => {
+            this.pending.delete(path);
+            void fn();
+        }, this.debounce);
+        this.pending.set(path, timer);
+    }
+}
+//# sourceMappingURL=watcher.js.map

package/dist/code-intel/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../../src/code-intel/watcher.ts"],"names":[],"mappings":"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"}

package/dist/core/ports/code-embedding.d.ts

@@ -0,0 +1,42 @@
+import type { CodeSymbolKind } from '../types/code.js';
+export interface EmbedChunkInput {
+    content: string;
+    kind: CodeSymbolKind;
+}
+export interface RerankDoc {
+    id: string;
+    content: string;
+}
+export interface RerankResult {
+    id: string;
+    score: number;
+}
+/**
+ * Port: Code Embedding — vectors + reranking for code chunks.
+ *
+ * Intentionally NOT extends `IEmbeddingProvider`: the existing OpenAI port
+ * uses 1536 dimensions for issue text, while voyage-code-3 uses 1024 for code.
+ * A shared `readonly dimensions: number` would conflict.
+ *
+ * Backed by Voyage AI (voyage-code-3 + rerank-2.5-lite) in production.
+ *
+ * @throws Error when the API is unreachable or rate-limited beyond retry budget.
+ */
+export interface ICodeEmbedding {
+    readonly name: string;
+    readonly dimensions: number;
+    /**
+     * Embed code chunks for indexing. Uses `input_type='document'` upstream.
+     * Order of returned vectors matches order of input chunks.
+     */
+    embedCode(chunks: EmbedChunkInput[]): Promise<number[][]>;
+    /**
+     * Embed a single natural-language query. Uses `input_type='query'` upstream.
+     */
+    embedQuery(query: string): Promise<number[]>;
+    /**
+     * Rerank candidate documents against a query. Returns topK by relevance.
+     */
+    rerank(query: string, docs: RerankDoc[], topK: number): Promise<RerankResult[]>;
+}
+//# sourceMappingURL=code-embedding.d.ts.map

package/dist/core/ports/code-embedding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-embedding.d.ts","sourceRoot":"","sources":["../../../src/core/ports/code-embedding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAE1D;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE7C;;OAEG;IACH,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,EAAE,EACjB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CAC5B"}

package/dist/core/ports/code-embedding.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-embedding.js.map

package/dist/core/ports/code-embedding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-embedding.js","sourceRoot":"","sources":["../../../src/core/ports/code-embedding.ts"],"names":[],"mappings":""}

package/dist/core/ports/code-graph.d.ts

@@ -0,0 +1,56 @@
+import type { CodeProject, CodeFile, CodeSymbol, CodeSymbolKind, CodeLayer, CodeImport, CodeCallEdge, CodeImplementsEdge, CodeExtendsEdge, CodeInjectsEdge } from '../types/code.js';
+export interface FindSymbolOptions {
+    projectId: string;
+    query: string;
+    kind?: CodeSymbolKind;
+    layer?: CodeLayer;
+    limit?: number;
+}
+/**
+ * Port: Code Graph — structural store for files, symbols and relationships.
+ *
+ * Backed by Neo4j in production, by FakeCodeGraph in tests.
+ * Adapters must respect the (projectId, qualifiedName) uniqueness for symbols
+ * and (projectId, path) for files.
+ *
+ * @throws Error when the underlying store is unreachable.
+ */
+export interface ICodeGraph {
+    readonly name: string;
+    initialize(): Promise<void>;
+    ensureProject(project: CodeProject): Promise<void>;
+    deleteProject(projectId: string): Promise<void>;
+    upsertFiles(projectId: string, files: CodeFile[]): Promise<void>;
+    deleteFile(projectId: string, path: string): Promise<void>;
+    /**
+     * Replace ALL symbols defined in a file atomically.
+     * Deletes existing symbols + their edges, then inserts new ones.
+     */
+    replaceFileSymbols(projectId: string, filePath: string, symbols: CodeSymbol[]): Promise<void>;
+    upsertImports(edges: CodeImport[]): Promise<void>;
+    upsertCalls(edges: CodeCallEdge[]): Promise<void>;
+    upsertImplements(edges: CodeImplementsEdge[]): Promise<void>;
+    upsertExtends(edges: CodeExtendsEdge[]): Promise<void>;
+    upsertInjects(edges: CodeInjectsEdge[]): Promise<void>;
+    findSymbol(opts: FindSymbolOptions): Promise<CodeSymbol[]>;
+    getDependencies(projectId: string, file: string, depth: number): Promise<CodeFile[]>;
+    getDependents(projectId: string, file: string, depth: number): Promise<CodeFile[]>;
+    getCallers(projectId: string, qualifiedName: string, depth: number): Promise<CodeSymbol[]>;
+    getCallees(projectId: string, qualifiedName: string, depth: number): Promise<CodeSymbol[]>;
+    /**
+     * Shortest path of CALLS edges from one symbol to another.
+     * Returns null when no path exists.
+     */
+    getCallPath(projectId: string, fromQn: string, toQn: string): Promise<CodeSymbol[] | null>;
+    /**
+     * Cross-layer dependency violations.
+     * Default layerOrder forbids: domain → infrastructure/presentation,
+     * application → presentation.
+     */
+    findArchViolations(projectId: string, layerOrder?: CodeLayer[]): Promise<CodeCallEdge[]>;
+    findUnusedExports(projectId: string): Promise<CodeSymbol[]>;
+    getImplementers(projectId: string, interfaceQn: string): Promise<CodeSymbol[]>;
+    getLayerSymbols(projectId: string, layer: CodeLayer): Promise<CodeSymbol[]>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=code-graph.d.ts.map

package/dist/core/ports/code-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-graph.d.ts","sourceRoot":"","sources":["../../../src/core/ports/code-graph.ts"],"names":[],"mappings":"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"}

package/dist/core/ports/code-graph.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-graph.js.map

package/dist/core/ports/code-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-graph.js","sourceRoot":"","sources":["../../../src/core/ports/code-graph.ts"],"names":[],"mappings":""}

package/dist/core/ports/code-meta.d.ts

@@ -0,0 +1,33 @@
+import type { CodeProject, CodeFileHash, IndexJob, IndexJobType, IndexStats } from '../types/code.js';
+/**
+ * Port: Code Metadata Store — projects registry, file hashes, index jobs.
+ *
+ * Backed by the existing Argustack Postgres instance (new `code_*` tables).
+ * Deliberately split from `IStorage` (issue-side) to avoid bloating that port.
+ *
+ * Used by indexer for idempotency (hash compare), job logging, and
+ * advisory locks to prevent concurrent watch + manual index.
+ *
+ * @throws Error when the database is unreachable.
+ */
+export interface ICodeMetaStore {
+    registerProject(project: CodeProject): Promise<void>;
+    unregisterProject(projectId: string): Promise<void>;
+    listProjects(): Promise<CodeProject[]>;
+    getProjectByRoot(root: string): Promise<CodeProject | null>;
+    getProjectById(projectId: string): Promise<CodeProject | null>;
+    upsertFileHashes(projectId: string, hashes: CodeFileHash[]): Promise<void>;
+    getFileHashes(projectId: string): Promise<Map<string, string>>;
+    startIndexJob(projectId: string, type: IndexJobType): Promise<number>;
+    completeIndexJob(jobId: number, stats: IndexStats): Promise<void>;
+    failIndexJob(jobId: number, error: string): Promise<void>;
+    getLatestJob(projectId: string): Promise<IndexJob | null>;
+    /**
+     * Acquire a session-scoped Postgres advisory lock for the project.
+     * Returns true on success, false when another process holds it.
+     * Caller MUST call `releaseLock` in a finally block.
+     */
+    tryAcquireLock(projectId: string): Promise<boolean>;
+    releaseLock(projectId: string): Promise<void>;
+}
+//# sourceMappingURL=code-meta.d.ts.map

package/dist/core/ports/code-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-meta.d.ts","sourceRoot":"","sources":["../../../src/core/ports/code-meta.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,UAAU,EACX,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;;;GAUG;AACH,MAAM,WAAW,cAAc;IAC7B,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,YAAY,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAEvC,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAE5D,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAE/D,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3E,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAE/D,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAEtE,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElE,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1D,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAE1D;;;;OAIG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpD,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C"}

package/dist/core/ports/code-meta.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-meta.js.map

package/dist/core/ports/code-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-meta.js","sourceRoot":"","sources":["../../../src/core/ports/code-meta.ts"],"names":[],"mappings":""}

package/dist/core/ports/code-parser.d.ts

@@ -0,0 +1,13 @@
+import type { CodeLanguage, ParsedFile } from '../types/code.js';
+/**
+ * Port: Code Parser — extracts symbols, imports and raw call sites from source.
+ *
+ * Backed by tree-sitter in production. Pure CPU; no I/O beyond input string.
+ * Cross-file resolution (qualifying call site identifiers) is done by
+ * `ISymbolResolver` in the indexer, not here.
+ */
+export interface ICodeParser {
+    readonly languages: readonly CodeLanguage[];
+    parseFile(absPath: string, content: string, language: CodeLanguage): Promise<ParsedFile>;
+}
+//# sourceMappingURL=code-parser.d.ts.map

package/dist/core/ports/code-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-parser.d.ts","sourceRoot":"","sources":["../../../src/core/ports/code-parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,SAAS,YAAY,EAAE,CAAC;IAE5C,SAAS,CACP,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,CAAC;CACxB"}

package/dist/core/ports/code-parser.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-parser.js.map

package/dist/core/ports/code-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-parser.js","sourceRoot":"","sources":["../../../src/core/ports/code-parser.ts"],"names":[],"mappings":""}

package/dist/core/ports/code-vector-store.d.ts

@@ -0,0 +1,37 @@
+import type { CodeChunk, CodeSymbolKind, CodeLayer, SemanticHit } from '../types/code.js';
+export interface SearchSemanticOptions {
+    layer?: CodeLayer;
+    kind?: CodeSymbolKind;
+    filePath?: string;
+    topK: number;
+}
+export interface CollectionStats {
+    pointCount: number;
+    vectorDim: number;
+}
+/**
+ * Port: Code Vector Store — semantic search over code chunks.
+ *
+ * Backed by Qdrant in production. One collection per project: `code_{projectId}`.
+ * Payload contains symbolId, filePath, layer, kind, name, startLine/endLine.
+ *
+ * @throws Error when the store is unreachable or the collection is missing.
+ */
+export interface ICodeVectorStore {
+    readonly name: string;
+    initialize(): Promise<void>;
+    ensureCollection(projectId: string, dim: number): Promise<void>;
+    upsertChunks(projectId: string, chunks: CodeChunk[], vectors: number[][]): Promise<void>;
+    deleteByFile(projectId: string, filePath: string): Promise<void>;
+    deleteBySymbol(projectId: string, symbolId: string): Promise<void>;
+    searchSemantic(projectId: string, vector: number[], opts: SearchSemanticOptions): Promise<SemanticHit[]>;
+    /**
+     * Find symbols whose vectors are similar to the seed symbol.
+     * Returns results excluding the seed itself.
+     */
+    findSimilar(projectId: string, symbolId: string, topK: number): Promise<SemanticHit[]>;
+    getCollectionStats(projectId: string): Promise<CollectionStats>;
+    deleteCollection(projectId: string): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=code-vector-store.d.ts.map

package/dist/core/ports/code-vector-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-vector-store.d.ts","sourceRoot":"","sources":["../../../src/core/ports/code-vector-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,SAAS,EACT,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhE,YAAY,CACV,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,EAAE,EACnB,OAAO,EAAE,MAAM,EAAE,EAAE,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnE,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EAAE,EAChB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1B;;;OAGG;IACH,WAAW,CACT,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1B,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEhE,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/core/ports/code-vector-store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=code-vector-store.js.map

package/dist/core/ports/code-vector-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-vector-store.js","sourceRoot":"","sources":["../../../src/core/ports/code-vector-store.ts"],"names":[],"mappings":""}

package/dist/core/ports/index.d.ts

@@ -4,4 +4,10 @@ export type { IGitHubProvider } from './github-provider.js';
 export type { IStorage, QueryResult } from './storage.js';
 export type { IEmbeddingProvider } from './embedding-provider.js';
 export type { IDbProvider } from './db-provider.js';
+export type { ICodeGraph, FindSymbolOptions } from './code-graph.js';
+export type { ICodeVectorStore, SearchSemanticOptions, CollectionStats, } from './code-vector-store.js';
+export type { ICodeParser } from './code-parser.js';
+export type { ILspClient } from './lsp-client.js';
+export type { ICodeEmbedding, EmbedChunkInput, RerankDoc, RerankResult, } from './code-embedding.js';
+export type { ICodeMetaStore } from './code-meta.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/ports/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/ports/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/ports/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAClE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACrE,YAAY,EACV,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EACV,cAAc,EACd,eAAe,EACf,SAAS,EACT,YAAY,GACb,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/core/ports/lsp-client.d.ts

@@ -0,0 +1,22 @@
+import type { LspSymbol, LspLocation } from '../types/code.js';
+/**
+ * Port: Language Server Protocol client — cross-file symbol resolution.
+ *
+ * Backed by `typescript-language-server` spawned as a subprocess.
+ * Used by `SymbolResolver` in code-intel/ to upgrade tree-sitter raw call sites
+ * (callee identifier text) into qualified-name edges.
+ *
+ * @throws Error when the LSP subprocess crashes irrecoverably.
+ */
+export interface ILspClient {
+    start(projectRoot: string): Promise<void>;
+    didOpen(uri: string, text: string): Promise<void>;
+    didChange(uri: string, text: string): Promise<void>;
+    documentSymbols(uri: string): Promise<LspSymbol[]>;
+    references(uri: string, line: number, character: number): Promise<LspLocation[]>;
+    definition(uri: string, line: number, character: number): Promise<LspLocation[]>;
+    implementations(uri: string, line: number, character: number): Promise<LspLocation[]>;
+    typeDefinition(uri: string, line: number, character: number): Promise<LspLocation[]>;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=lsp-client.d.ts.map

package/dist/core/ports/lsp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-client.d.ts","sourceRoot":"","sources":["../../../src/core/ports/lsp-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpD,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAEnD,UAAU,CACR,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1B,UAAU,CACR,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1B,eAAe,CACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1B,cAAc,CACZ,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAE1B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB"}

package/dist/core/ports/lsp-client.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=lsp-client.js.map

package/dist/core/ports/lsp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-client.js","sourceRoot":"","sources":["../../../src/core/ports/lsp-client.ts"],"names":[],"mappings":""}