argustack 0.1.34 → 0.3.1

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,37 @@
+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.
+ *
+ * Tenant invariant: `projectId === workspaceId`. The code-intel data
+ * model is 1:1 with workspaces; there is no separate "project" identity.
+ * Enforced by FK `code_projects.workspace_id REFERENCES workspaces(id)`.
+ *
+ * @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;;;;;;;;;;;;;;GAcG;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,42 @@
+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>;
+    /**
+     * Cheap existence check that does not throw when the collection is
+     * missing. Used by init flow before calling getCollectionStats.
+     */
+    collectionExists(projectId: string): Promise<boolean>;
+    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;;;OAGG;IACH,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEtD,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/docker-control.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Port: DockerControl — abstraction over docker / docker compose CLI.
+ *
+ * Implementations: CliDockerControl (shells out to `docker` and `docker compose`).
+ * Core does not import child_process or any node API.
+ */
+export interface DockerVersion {
+    readonly engine: string;
+    readonly compose: string;
+}
+export type ComposeUpErrorKind = 'permission' | 'compose-v1' | 'no-space' | 'port-in-use' | 'unknown';
+export type ComposeUpResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly kind: ComposeUpErrorKind;
+    readonly details: string;
+};
+/**
+ * Port: Docker control surface used by init / bootstrap.
+ *
+ * @throws Error only on unrecoverable spawn failures.
+ */
+export interface IDockerControl {
+    readonly name: string;
+    /** True when the `docker` binary exists on PATH. */
+    isInstalled(): Promise<boolean>;
+    /** True when `docker info` succeeds (daemon reachable). */
+    isRunning(): Promise<boolean>;
+    /** Parsed engine + compose version, or null if `docker version` fails. */
+    version(): Promise<DockerVersion | null>;
+    /**
+     * Poll `isRunning()` every `intervalMs` until true, up to `timeoutMs`.
+     * Calls `onTick(secondsElapsed)` once per poll so callers can render progress.
+     * Returns true when running, false on timeout.
+     */
+    pollUntilRunning(timeoutMs: number, intervalMs: number, onTick?: (secondsElapsed: number) => void): Promise<boolean>;
+    /**
+     * Run `docker compose up -d` in `cwd` against `composePath`.
+     * Inspects stderr to classify common failure modes.
+     */
+    composeUp(composePath: string, cwd: string): Promise<ComposeUpResult>;
+}
+//# sourceMappingURL=docker-control.d.ts.map

package/dist/core/ports/docker-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-control.d.ts","sourceRoot":"","sources":["../../../src/core/ports/docker-control.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,YAAY,GACZ,UAAU,GACV,aAAa,GACb,SAAS,CAAC;AAEd,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,oDAAoD;IACpD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC,2DAA2D;IAC3D,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9B,0EAA0E;IAC1E,OAAO,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEzC;;;;OAIG;IACH,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,GACxC,OAAO,CAAC,OAAO,CAAC,CAAC;IAEpB;;;OAGG;IACH,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACvE"}

package/dist/core/ports/docker-control.js

@@ -0,0 +1,8 @@
+/**
+ * Port: DockerControl — abstraction over docker / docker compose CLI.
+ *
+ * Implementations: CliDockerControl (shells out to `docker` and `docker compose`).
+ * Core does not import child_process or any node API.
+ */
+export {};
+//# sourceMappingURL=docker-control.js.map

package/dist/core/ports/docker-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docker-control.js","sourceRoot":"","sources":["../../../src/core/ports/docker-control.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/ports/hub-readiness-probe.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Port: probe that polls a freshly-bootstrapped hub service until it
+ * accepts authenticated traffic. Used by `BootstrapHubUseCase` between
+ * `docker compose up -d` and the first schema-apply call.
+ *
+ * Implementations: {@link PgReadinessProbe} (real Postgres health
+ * check), and in-memory test doubles. The probe owns its own timeout
+ * and polling cadence — callers just await the result.
+ */
+export interface IHubReadinessProbe {
+    /**
+     * Resolve once the hub service is ready, or with `{ ok: false }` if
+     * the probe gave up. Never throws.
+     */
+    waitForReady(port: number): Promise<{
+        ok: true;
+    } | {
+        ok: false;
+        details: string;
+    }>;
+}
+//# sourceMappingURL=hub-readiness-probe.d.ts.map

package/dist/core/ports/hub-readiness-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hub-readiness-probe.d.ts","sourceRoot":"","sources":["../../../src/core/ports/hub-readiness-probe.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpF"}

package/dist/core/ports/hub-readiness-probe.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=hub-readiness-probe.js.map

package/dist/core/ports/hub-readiness-probe.js.map

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

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

@@ -2,6 +2,16 @@ export type { ISourceProvider } from './source-provider.js';
 export type { IGitProvider } from './git-provider.js';
 export type { IGitHubProvider } from './github-provider.js';
 export type { IStorage, QueryResult } from './storage.js';
+export type { IWorkspaceStore } from './workspace-store.js';
+export type { IPlatformProbe, OsKind, PortStatus, PortFree, PortInUse, CommandResult, } from './platform-probe.js';
+export type { IDockerControl, DockerVersion, ComposeUpResult, ComposeUpErrorKind, } from './docker-control.js';
+export type { IOllamaControl, OllamaModel, InstallResult, InstallError, PullResult, PullError, ProbeResult, ProbeError, } from './ollama-control.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,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,YAAY,EACV,cAAc,EACd,MAAM,EACN,UAAU,EACV,QAAQ,EACR,SAAS,EACT,aAAa,GACd,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,cAAc,EACd,aAAa,EACb,eAAe,EACf,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,cAAc,EACd,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,GACX,MAAM,qBAAqB,CAAC;AAC7B,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":""}

package/dist/core/ports/ollama-control.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Port: OllamaControl — abstraction over Ollama install / serve / pull / probe.
+ *
+ * Implementations: HttpOllamaControl (talks to http://localhost:11434 + shells `ollama`).
+ */
+export type InstallError = 'no-brew' | 'no-curl' | 'permission' | 'no-internet' | 'unknown';
+export type InstallResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly kind: InstallError;
+    readonly details: string;
+};
+export type PullError = 'no-internet' | 'no-space' | 'hub-down' | 'unknown';
+export type PullResult = {
+    readonly ok: true;
+} | {
+    readonly ok: false;
+    readonly kind: PullError;
+    readonly details: string;
+};
+export type ProbeError = 'no-response' | 'wrong-format' | 'model-not-found' | 'timeout';
+export type ProbeResult = {
+    readonly ok: true;
+    readonly dims: number;
+} | {
+    readonly ok: false;
+    readonly kind: ProbeError;
+    readonly details: string;
+};
+export interface OllamaModel {
+    readonly name: string;
+    readonly sizeBytes: number;
+}
+/**
+ * Port: Ollama lifecycle used by init/setup-llm.
+ *
+ * @throws Error only on unrecoverable I/O.
+ */
+export interface IOllamaControl {
+    readonly name: string;
+    isInstalled(): Promise<boolean>;
+    isRunning(): Promise<boolean>;
+    version(): Promise<string | null>;
+    installViaBrew(): Promise<InstallResult>;
+    installViaCurl(): Promise<InstallResult>;
+    /**
+     * Spawn `ollama serve` detached and return immediately.
+     * Use {@link waitHealthy} to block until the HTTP API responds.
+     */
+    startInBackground(): Promise<void>;
+    waitHealthy(timeoutMs: number): Promise<boolean>;
+    listModels(): Promise<OllamaModel[]>;
+    pullModel(name: string, onProgress?: (pct: number, status: string) => void): Promise<PullResult>;
+    /**
+     * Send a one-shot embedding request to verify the model works.
+     * Returns the response vector dimensions or a classified failure.
+     */
+    probeEmbedding(model: string, text: string, url?: string): Promise<ProbeResult>;
+}
+//# sourceMappingURL=ollama-control.d.ts.map

package/dist/core/ports/ollama-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-control.d.ts","sourceRoot":"","sources":["../../../src/core/ports/ollama-control.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,SAAS,CAAC;AAE5F,MAAM,MAAM,aAAa,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAElF,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAE5E,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;CAAE,GACrB;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,cAAc,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAExF,MAAM,MAAM,WAAW,GACnB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhF,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9B,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAElC,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IACzC,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAEzC;;;OAGG;IACH,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjD,UAAU,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAErC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAEjG;;;OAGG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACjF"}

package/dist/core/ports/ollama-control.js

@@ -0,0 +1,7 @@
+/**
+ * Port: OllamaControl — abstraction over Ollama install / serve / pull / probe.
+ *
+ * Implementations: HttpOllamaControl (talks to http://localhost:11434 + shells `ollama`).
+ */
+export {};
+//# sourceMappingURL=ollama-control.js.map

package/dist/core/ports/ollama-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-control.js","sourceRoot":"","sources":["../../../src/core/ports/ollama-control.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/core/ports/platform-probe.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Port: PlatformProbe — abstraction over OS detection and process spawning.
+ *
+ * Implementations: NodePlatformProbe (uses child_process + node:os).
+ * Core knows nothing about Node APIs or shell commands.
+ */
+export type OsKind = 'macos' | 'linux' | 'windows' | 'unknown';
+export interface PortFree {
+    readonly free: true;
+    readonly port: number;
+}
+export interface PortInUse {
+    readonly free: false;
+    readonly port: number;
+    readonly pid: number;
+    readonly processName: string;
+}
+export type PortStatus = PortFree | PortInUse;
+export interface CommandResult {
+    readonly stdout: string;
+    readonly stderr: string;
+    readonly code: number;
+}
+/**
+ * Port: low-level OS probe + process control used by init/preflight.
+ * Implementations should never throw for non-zero exit — return CommandResult instead.
+ *
+ * @throws Error only on unrecoverable I/O failures (spawn failed).
+ */
+export interface IPlatformProbe {
+    readonly name: string;
+    detectOS(): OsKind;
+    /** True when `which <cmd>` (or equivalent) succeeds. */
+    hasCommand(command: string): Promise<boolean>;
+    /**
+     * Check if a TCP port is currently bound by a listening socket.
+     * Implementations on POSIX use `lsof -iTCP:N -sTCP:LISTEN`.
+     * On unknown OS may return `{ free: true }` optimistically.
+     */
+    checkPort(port: number): Promise<PortStatus>;
+    /**
+     * Run a command and return its stdout/stderr/code.
+     * Does not throw on non-zero exit — caller inspects `code`.
+     */
+    runCommand(command: string, args: readonly string[]): Promise<CommandResult>;
+}
+//# sourceMappingURL=platform-probe.d.ts.map

package/dist/core/ports/platform-probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-probe.d.ts","sourceRoot":"","sources":["../../../src/core/ports/platform-probe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;AAE/D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE9C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,IAAI,MAAM,CAAC;IAEnB,wDAAwD;IACxD,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE9C;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAE7C;;;OAGG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CAC9E"}

package/dist/core/ports/platform-probe.js

@@ -0,0 +1,8 @@
+/**
+ * Port: PlatformProbe — abstraction over OS detection and process spawning.
+ *
+ * Implementations: NodePlatformProbe (uses child_process + node:os).
+ * Core knows nothing about Node APIs or shell commands.
+ */
+export {};
+//# sourceMappingURL=platform-probe.js.map

package/dist/core/ports/platform-probe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform-probe.js","sourceRoot":"","sources":["../../../src/core/ports/platform-probe.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}