argustack 0.1.34 → 0.2.0

package/dist/use-cases/code-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-search.d.ts","sourceRoot":"","sources":["../../src/use-cases/code-search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EACV,cAAc,EACd,SAAS,EACT,sBAAsB,EAGvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAgB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,IAAI,CAAC,EAAE,cAAc,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,iBAAiB;IAI1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsB;gBAG1B,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,cAAc;IAGtC,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAYhE,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC;QACxD,OAAO,EAAE,MAAM,CAAC,SAAS,GAAG,cAAc,EAAE,SAAS,EAAE,CAAC,CAAC;QACzD,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IAsBI,gBAAgB,CACpB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,sBAAsB,CAAC;CAqBnC"}

package/dist/use-cases/code-search.js

@@ -0,0 +1,74 @@
+import { HybridRanker } from '../code-intel/ranker.js';
+export class CodeSearchUseCase {
+    graph;
+    vec;
+    embedding;
+    ranker = new HybridRanker();
+    constructor(graph, vec, embedding) {
+        this.graph = graph;
+        this.vec = vec;
+        this.embedding = embedding;
+    }
+    async searchSemantic(input) {
+        const topK = input.topK ?? 10;
+        const vector = await this.embedding.embedQuery(input.query);
+        const searchOpts = {
+            topK: Math.max(topK * 5, 30),
+        };
+        if (input.layer) {
+            searchOpts.layer = input.layer;
+        }
+        if (input.kind) {
+            searchOpts.kind = input.kind;
+        }
+        const candidates = await this.vec.searchSemantic(input.projectId, vector, searchOpts);
+        return this.ranker.rankSemantic(input.query, candidates, this.embedding, topK);
+    }
+    async explainFeature(input) {
+        const topK = input.topK ?? 10;
+        const vector = await this.embedding.embedQuery(input.query);
+        const candidates = await this.vec.searchSemantic(input.projectId, vector, { topK: 50 });
+        const reranked = await this.ranker.rankSemantic(input.query, candidates, this.embedding, topK);
+        const neighborhood = await this.ranker.expandGraph(this.graph, input.projectId, reranked.map((h) => h.symbolId), 1);
+        return {
+            byLayer: this.ranker.clusterByLayer(reranked),
+            expandedFiles: Array.from(neighborhood.files),
+        };
+    }
+    async planFeatureFiles(input) {
+        const topKPerLayer = input.topKPerLayer ?? 5;
+        const vector = await this.embedding.embedQuery(input.description);
+        const candidates = await this.vec.searchSemantic(input.projectId, vector, {
+            topK: 50,
+        });
+        const reranked = await this.ranker.rankSemantic(input.description, candidates, this.embedding, 30);
+        const grouped = this.ranker.clusterByLayer(reranked);
+        return {
+            domain: pickFiles(grouped.domain, topKPerLayer),
+            application: pickFiles(grouped.application, topKPerLayer),
+            infrastructure: pickFiles(grouped.infrastructure, topKPerLayer),
+            presentation: pickFiles(grouped.presentation, topKPerLayer),
+        };
+    }
+}
+function pickFiles(hits, limit) {
+    const seen = new Set();
+    const out = [];
+    for (const hit of hits) {
+        if (seen.has(hit.payload.filePath)) {
+            continue;
+        }
+        seen.add(hit.payload.filePath);
+        out.push({
+            filePath: hit.payload.filePath,
+            reason: `Matches '${hit.payload.name}' (${hit.payload.kind})`,
+            similarTo: hit.payload.name,
+            score: hit.score,
+        });
+        if (out.length >= limit) {
+            break;
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=code-search.js.map

package/dist/use-cases/code-search.js.map

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

package/dist/use-cases/index-code.d.ts

@@ -0,0 +1,24 @@
+import type { ICodeGraph } from '../core/ports/code-graph.js';
+import type { ICodeVectorStore } from '../core/ports/code-vector-store.js';
+import type { ICodeParser } from '../core/ports/code-parser.js';
+import type { ICodeEmbedding } from '../core/ports/code-embedding.js';
+import type { ICodeMetaStore } from '../core/ports/code-meta.js';
+import type { ILspClient } from '../core/ports/lsp-client.js';
+import type { CodeProject, IndexStats } from '../core/types/code.js';
+import { type IndexProgress } from '../code-intel/index.js';
+export interface IndexCodeInput {
+    project: CodeProject;
+    full?: boolean;
+    onProgress?: (event: IndexProgress) => void;
+}
+export declare class IndexCodeUseCase {
+    private readonly parser;
+    private readonly graph;
+    private readonly vec;
+    private readonly embedding;
+    private readonly meta;
+    private readonly lsp;
+    constructor(parser: ICodeParser, graph: ICodeGraph, vec: ICodeVectorStore, embedding: ICodeEmbedding, meta: ICodeMetaStore, lsp?: ILspClient | null);
+    execute(input: IndexCodeInput): Promise<IndexStats>;
+}
+//# sourceMappingURL=index-code.d.ts.map

package/dist/use-cases/index-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-code.d.ts","sourceRoot":"","sources":["../../src/use-cases/index-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAe,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAGzE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,CAAC;CAC7C;AAED,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBALH,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,cAAc,EACzB,IAAI,EAAE,cAAc,EACpB,GAAG,GAAE,UAAU,GAAG,IAAW;IAG1C,OAAO,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC;CAoB1D"}

package/dist/use-cases/index-code.js

@@ -0,0 +1,43 @@
+import { CodeIndexer } from '../code-intel/index.js';
+import { withJobLock } from '../code-intel/job-lock.js';
+export class IndexCodeUseCase {
+    parser;
+    graph;
+    vec;
+    embedding;
+    meta;
+    lsp;
+    constructor(parser, graph, vec, embedding, meta, lsp = null) {
+        this.parser = parser;
+        this.graph = graph;
+        this.vec = vec;
+        this.embedding = embedding;
+        this.meta = meta;
+        this.lsp = lsp;
+    }
+    async execute(input) {
+        return withJobLock(input.project.id, this.meta, async () => {
+            const indexerOpts = {
+                project: input.project,
+                parser: this.parser,
+                graph: this.graph,
+                vec: this.vec,
+                embedding: this.embedding,
+                meta: this.meta,
+            };
+            if (this.lsp) {
+                indexerOpts.lsp = this.lsp;
+            }
+            const indexer = new CodeIndexer(indexerOpts);
+            const opts = {};
+            if (input.full !== undefined) {
+                opts.full = input.full;
+            }
+            if (input.onProgress) {
+                opts.onProgress = input.onProgress;
+            }
+            return indexer.indexProject(opts);
+        });
+    }
+}
+//# sourceMappingURL=index-code.js.map

package/dist/use-cases/index-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-code.js","sourceRoot":"","sources":["../../src/use-cases/index-code.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,WAAW,EAAsB,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAQxD,MAAM,OAAO,gBAAgB;IAER;IACA;IACA;IACA;IACA;IACA;IANnB,YACmB,MAAmB,EACnB,KAAiB,EACjB,GAAqB,EACrB,SAAyB,EACzB,IAAoB,EACpB,MAAyB,IAAI;QAL7B,WAAM,GAAN,MAAM,CAAa;QACnB,UAAK,GAAL,KAAK,CAAY;QACjB,QAAG,GAAH,GAAG,CAAkB;QACrB,cAAS,GAAT,SAAS,CAAgB;QACzB,SAAI,GAAJ,IAAI,CAAgB;QACpB,QAAG,GAAH,GAAG,CAA0B;IAC7C,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,KAAqB;QACjC,OAAO,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE;YACzD,MAAM,WAAW,GAAiD;gBAChE,OAAO,EAAE,KAAK,CAAC,OAAO;gBACtB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC;YACF,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACb,WAAW,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;YAC7B,CAAC;YACD,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,WAAW,CAAC,CAAC;YAC7C,MAAM,IAAI,GAA+C,EAAE,CAAC;YAC5D,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAAA,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;YAAA,CAAC;YACvD,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;gBAAA,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;YAAA,CAAC;YAC3D,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/use-cases/register-code-project.d.ts

@@ -0,0 +1,21 @@
+import type { ICodeGraph } from '../core/ports/code-graph.js';
+import type { ICodeVectorStore } from '../core/ports/code-vector-store.js';
+import type { ICodeMetaStore } from '../core/ports/code-meta.js';
+import type { ICodeEmbedding } from '../core/ports/code-embedding.js';
+import type { CodeProject } from '../core/types/code.js';
+export interface RegisterCodeProjectInput {
+    id: string;
+    name: string;
+    root: string;
+    language: CodeProject['language'];
+    layerConfig?: Record<string, CodeProject['language'] extends infer _ ? string : never>;
+}
+export declare class RegisterCodeProjectUseCase {
+    private readonly meta;
+    private readonly graph;
+    private readonly vec;
+    private readonly embedding;
+    constructor(meta: ICodeMetaStore, graph: ICodeGraph, vec: ICodeVectorStore, embedding: ICodeEmbedding);
+    execute(input: CodeProject): Promise<CodeProject>;
+}
+//# sourceMappingURL=register-code-project.d.ts.map

package/dist/use-cases/register-code-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-code-project.d.ts","sourceRoot":"","sources":["../../src/use-cases/register-code-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,UAAU,CAAC,SAAS,MAAM,CAAC,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;CACxF;AAED,qBAAa,0BAA0B;IAEnC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAHT,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,cAAc;IAGtC,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;CAMxD"}

package/dist/use-cases/register-code-project.js

@@ -0,0 +1,19 @@
+export class RegisterCodeProjectUseCase {
+    meta;
+    graph;
+    vec;
+    embedding;
+    constructor(meta, graph, vec, embedding) {
+        this.meta = meta;
+        this.graph = graph;
+        this.vec = vec;
+        this.embedding = embedding;
+    }
+    async execute(input) {
+        await this.meta.registerProject(input);
+        await this.graph.ensureProject(input);
+        await this.vec.ensureCollection(input.id, this.embedding.dimensions);
+        return input;
+    }
+}
+//# sourceMappingURL=register-code-project.js.map

package/dist/use-cases/register-code-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-code-project.js","sourceRoot":"","sources":["../../src/use-cases/register-code-project.ts"],"names":[],"mappings":"AAcA,MAAM,OAAO,0BAA0B;IAElB;IACA;IACA;IACA;IAJnB,YACmB,IAAoB,EACpB,KAAiB,EACjB,GAAqB,EACrB,SAAyB;QAHzB,SAAI,GAAJ,IAAI,CAAgB;QACpB,UAAK,GAAL,KAAK,CAAY;QACjB,QAAG,GAAH,GAAG,CAAkB;QACrB,cAAS,GAAT,SAAS,CAAgB;IACzC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,KAAkB;QAC9B,MAAM,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QACvC,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;QACtC,MAAM,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACrE,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/use-cases/unregister-code-project.d.ts

@@ -0,0 +1,11 @@
+import type { ICodeGraph } from '../core/ports/code-graph.js';
+import type { ICodeVectorStore } from '../core/ports/code-vector-store.js';
+import type { ICodeMetaStore } from '../core/ports/code-meta.js';
+export declare class UnregisterCodeProjectUseCase {
+    private readonly meta;
+    private readonly graph;
+    private readonly vec;
+    constructor(meta: ICodeMetaStore, graph: ICodeGraph, vec: ICodeVectorStore);
+    execute(projectId: string): Promise<void>;
+}
+//# sourceMappingURL=unregister-code-project.d.ts.map

package/dist/use-cases/unregister-code-project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unregister-code-project.d.ts","sourceRoot":"","sources":["../../src/use-cases/unregister-code-project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE,qBAAa,4BAA4B;IAErC,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAFH,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,gBAAgB;IAGlC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOhD"}

package/dist/use-cases/unregister-code-project.js

@@ -0,0 +1,19 @@
+export class UnregisterCodeProjectUseCase {
+    meta;
+    graph;
+    vec;
+    constructor(meta, graph, vec) {
+        this.meta = meta;
+        this.graph = graph;
+        this.vec = vec;
+    }
+    async execute(projectId) {
+        await this.graph.deleteProject(projectId);
+        try {
+            await this.vec.deleteCollection(projectId);
+        }
+        catch { /* collection may already be gone */ }
+        await this.meta.unregisterProject(projectId);
+    }
+}
+//# sourceMappingURL=unregister-code-project.js.map

package/dist/use-cases/unregister-code-project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unregister-code-project.js","sourceRoot":"","sources":["../../src/use-cases/unregister-code-project.ts"],"names":[],"mappings":"AAIA,MAAM,OAAO,4BAA4B;IAEpB;IACA;IACA;IAHnB,YACmB,IAAoB,EACpB,KAAiB,EACjB,GAAqB;QAFrB,SAAI,GAAJ,IAAI,CAAgB;QACpB,UAAK,GAAL,KAAK,CAAY;QACjB,QAAG,GAAH,GAAG,CAAkB;IACrC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QAC7C,CAAC;QAAC,MAAM,CAAC,CAAC,oCAAoC,CAAC,CAAC;QAChD,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;CACF"}

package/dist/use-cases/watch-code.d.ts

@@ -0,0 +1,33 @@
+import type { ICodeGraph } from '../core/ports/code-graph.js';
+import type { ICodeVectorStore } from '../core/ports/code-vector-store.js';
+import type { ICodeParser } from '../core/ports/code-parser.js';
+import type { ICodeEmbedding } from '../core/ports/code-embedding.js';
+import type { ICodeMetaStore } from '../core/ports/code-meta.js';
+import type { CodeProject } from '../core/types/code.js';
+export interface WatchCodeInput {
+    project: CodeProject;
+    signal?: AbortSignal;
+    onEvent?: (event: WatchEvent) => void;
+}
+export type WatchEvent = {
+    type: 'ready';
+} | {
+    type: 'fileIndexed';
+    path: string;
+} | {
+    type: 'fileRemoved';
+    path: string;
+} | {
+    type: 'error';
+    error: Error;
+};
+export declare class WatchCodeUseCase {
+    private readonly parser;
+    private readonly graph;
+    private readonly vec;
+    private readonly embedding;
+    private readonly meta;
+    constructor(parser: ICodeParser, graph: ICodeGraph, vec: ICodeVectorStore, embedding: ICodeEmbedding, meta: ICodeMetaStore);
+    start(input: WatchCodeInput): Promise<void>;
+}
+//# sourceMappingURL=watch-code.d.ts.map

package/dist/use-cases/watch-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-code.d.ts","sourceRoot":"","sources":["../../src/use-cases/watch-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oCAAoC,CAAC;AAC3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;CACvC;AAED,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpC,qBAAa,gBAAgB;IAEzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAJJ,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,gBAAgB,EACrB,SAAS,EAAE,cAAc,EACzB,IAAI,EAAE,cAAc;IAGjC,KAAK,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAyClD"}

package/dist/use-cases/watch-code.js

@@ -0,0 +1,52 @@
+import { CodeIndexer, CodeWatcher } from '../code-intel/index.js';
+export class WatchCodeUseCase {
+    parser;
+    graph;
+    vec;
+    embedding;
+    meta;
+    constructor(parser, graph, vec, embedding, meta) {
+        this.parser = parser;
+        this.graph = graph;
+        this.vec = vec;
+        this.embedding = embedding;
+        this.meta = meta;
+    }
+    async start(input) {
+        const acquired = await this.meta.tryAcquireLock(input.project.id);
+        if (!acquired) {
+            throw new Error(`Another job is running for project '${input.project.id}'`);
+        }
+        const indexer = new CodeIndexer({
+            project: input.project,
+            parser: this.parser,
+            graph: this.graph,
+            vec: this.vec,
+            embedding: this.embedding,
+            meta: this.meta,
+        });
+        const watcher = new CodeWatcher({ root: input.project.root, indexer });
+        watcher.on('ready', () => input.onEvent?.({ type: 'ready' }));
+        watcher.on('fileIndexed', (path) => input.onEvent?.({ type: 'fileIndexed', path }));
+        watcher.on('fileRemoved', (path) => input.onEvent?.({ type: 'fileRemoved', path }));
+        watcher.on('error', (error) => input.onEvent?.({ type: 'error', error }));
+        watcher.start();
+        return new Promise((resolve) => {
+            const cleanup = () => {
+                void (async () => {
+                    await watcher.stop();
+                    await this.meta.releaseLock(input.project.id);
+                    resolve();
+                })();
+            };
+            if (input.signal) {
+                if (input.signal.aborted) {
+                    cleanup();
+                    return;
+                }
+                input.signal.addEventListener('abort', cleanup, { once: true });
+            }
+        });
+    }
+}
+//# sourceMappingURL=watch-code.js.map

package/dist/use-cases/watch-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-code.js","sourceRoot":"","sources":["../../src/use-cases/watch-code.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAclE,MAAM,OAAO,gBAAgB;IAER;IACA;IACA;IACA;IACA;IALnB,YACmB,MAAmB,EACnB,KAAiB,EACjB,GAAqB,EACrB,SAAyB,EACzB,IAAoB;QAJpB,WAAM,GAAN,MAAM,CAAa;QACnB,UAAK,GAAL,KAAK,CAAY;QACjB,QAAG,GAAH,GAAG,CAAkB;QACrB,cAAS,GAAT,SAAS,CAAgB;QACzB,SAAI,GAAJ,IAAI,CAAgB;IACpC,CAAC;IAEJ,KAAK,CAAC,KAAK,CAAC,KAAqB;QAC/B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAClE,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,uCAAuC,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;QAC9E,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC;YAC9B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;SAChB,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QACvE,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,IAAY,EAAE,EAAE,CACzC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAC/C,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,IAAY,EAAE,EAAE,CACzC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAC/C,CAAC;QACF,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAY,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,KAAK,EAAE,CAAC;QAEhB,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YACnC,MAAM,OAAO,GAAG,GAAS,EAAE;gBACzB,KAAK,CAAC,KAAK,IAAI,EAAE;oBACf,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;oBACrB,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;oBAC9C,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,CAAC;YACF,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;gBACjB,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBACzB,OAAO,EAAE,CAAC;oBACV,OAAO;gBACT,CAAC;gBACD,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAClE,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argustack",
-  "version": "0.1.34",
+  "version": "0.2.0",
   "description": "Project analysis platform — Jira + Git + DB",
   "type": "module",
   "bin": {
@@ -54,7 +54,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/InfoCodeStreamly/argustack"
+    "url": "https://github.com/CodeStreamly/argustack"
   },
   "license": "MIT",
   "engines": {
@@ -64,19 +64,26 @@
     "@hello-pangea/dnd": "^18.0.1",
     "@inquirer/prompts": "^8.3.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "@qdrant/js-client-rest": "^1.18.0",
     "chalk": "^5.4.1",
+    "chokidar": "^5.0.0",
     "commander": "^14.0.3",
     "csv-parse": "^6.2.1",
     "dotenv": "^17.3.1",
     "es-git": "^0.6.0",
+    "ignore": "^7.0.5",
     "jira.js": "^5.3.1",
     "knex": "^3.1.0",
     "mysql2": "^3.20.0",
+    "neo4j-driver": "^6.0.1",
     "octokit": "^5.0.5",
     "ora": "^9.3.0",
     "pg": "^8.13.1",
     "react": "^19.2.4",
-    "react-dom": "^19.2.4"
+    "react-dom": "^19.2.4",
+    "tree-sitter": "^0.21.1",
+    "tree-sitter-typescript": "^0.23.2",
+    "vscode-jsonrpc": "^8.2.1"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/templates/code-docker-compose.yml

@@ -0,0 +1,51 @@
+# Argustack global Code Intelligence — shared across ALL workspaces.
+#
+# Multi-tenant: one Neo4j + one Qdrant on standard ports, projects isolated
+# by `projectId` (Neo4j) and per-project collection name (Qdrant).
+#
+# Usage:
+#   cd ~/.argustack/code && docker compose up -d
+#
+# Workspaces point to it via .env:
+#   NEO4J_URI=bolt://localhost:7687
+#   QDRANT_URL=http://localhost:6333
+
+services:
+  neo4j:
+    image: neo4j:5-community
+    container_name: argustack-code-neo4j
+    ports:
+      - "7474:7474"   # HTTP / Neo4j Browser
+      - "7687:7687"   # Bolt
+    environment:
+      NEO4J_AUTH: neo4j/argustack_local
+      NEO4J_PLUGINS: '["apoc"]'
+      NEO4J_dbms_memory_pagecache_size: 1G
+      NEO4J_dbms_memory_heap_initial__size: 1G
+      NEO4J_dbms_memory_heap_max__size: 2G
+    volumes:
+      - argustack-code-neo4j-data:/data
+      - argustack-code-neo4j-logs:/logs
+      - argustack-code-neo4j-plugins:/plugins
+    healthcheck:
+      test: ["CMD-SHELL", "wget --no-verbose --tries=1 --spider http://localhost:7474 || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 15
+    restart: unless-stopped
+
+  qdrant:
+    image: qdrant/qdrant:latest
+    container_name: argustack-code-qdrant
+    ports:
+      - "6333:6333"   # REST
+      - "6334:6334"   # gRPC
+    volumes:
+      - argustack-code-qdrant-data:/qdrant/storage
+    restart: unless-stopped
+
+volumes:
+  argustack-code-neo4j-data:
+  argustack-code-neo4j-logs:
+  argustack-code-neo4j-plugins:
+  argustack-code-qdrant-data:

package/templates/env.example

@@ -15,3 +15,19 @@ DB_PORT=5434
 DB_USER=argustack
 DB_PASSWORD=argustack_local
 DB_NAME=argustack
+
+# === Code Intelligence (optional — needed only for `argustack code`) ===
+# Set these after running `argustack code init` which bootstraps the shared
+# hub at ~/.argustack/code/ (Neo4j + Qdrant on standard ports).
+# NEO4J_URI=bolt://localhost:7687
+# NEO4J_USER=neo4j
+# NEO4J_PASSWORD=argustack_local
+# QDRANT_URL=http://localhost:6333
+
+# Code embedding provider: lmstudio (default, local) or voyage (cloud)
+# CODE_EMBEDDING_PROVIDER=lmstudio
+# LMSTUDIO_URL=http://localhost:1234
+# EMBEDDING_MODEL=text-embedding-qwen3-embedding-4b
+# EMBEDDING_DIMS=1024
+# RERANK_MODEL=                              # optional, LM Studio chat model id (e.g. Qwen3-Reranker)
+# VOYAGE_API_KEY=                            # only if CODE_EMBEDDING_PROVIDER=voyage