argustack 0.2.0 → 0.3.1

package/dist/use-cases/embed.js

@@ -12,14 +12,14 @@ export class EmbedUseCase {
         this.embedding = embedding;
         this.storage = storage;
     }
-    async execute(options = {}) {
+    async execute(workspaceId, options = {}) {
         const log = options.onProgress ?? noop;
         const batchSize = options.batchSize ?? 100;
         let embeddedCount = 0;
         let skippedCount = 0;
         await this.storage.initialize();
         while (true) {
-            const keys = await this.storage.getUnembeddedIssueKeys(batchSize);
+            const keys = await this.storage.getUnembeddedIssueKeys(workspaceId, batchSize);
             if (keys.length === 0) {
                 break;
             }
@@ -27,7 +27,7 @@ export class EmbedUseCase {
             const texts = [];
             const validKeys = [];
             for (const key of keys) {
-                const result = await this.storage.query(`SELECT summary, description FROM issues WHERE issue_key = $1`, [key]);
+                const result = await this.storage.queryForWorkspace(workspaceId, `SELECT summary, description FROM issues WHERE workspace_id = $1 AND issue_key = $2`, [key]);
                 if (result.rows.length > 0) {
                     const row = result.rows[0];
                     const text = [row.summary ?? '', row.description ?? ''].join('\n').trim();
@@ -47,8 +47,8 @@ export class EmbedUseCase {
             for (let i = 0; i < validKeys.length; i++) {
                 const key = validKeys[i];
                 const vec = vectors[i];
-                if (key && vec) {
-                    await this.storage.saveEmbedding(key, vec);
+                if (key !== undefined && key !== '' && vec !== undefined) {
+                    await this.storage.saveEmbedding(workspaceId, key, vec);
                 }
             }
             embeddedCount += validKeys.length;

package/dist/use-cases/embed.js.map

@@ -1 +1 @@
-{"version":3,"file":"embed.js","sourceRoot":"","sources":["../../src/use-cases/embed.ts"],"names":[],"mappings":"AAGA,SAAS,IAAI,CAAC,QAAgB,IAA4B,CAAC;AAY3D;;;;;GAKG;AACH,MAAM,OAAO,YAAY;IAEJ;IACA;IAFnB,YACmB,SAA6B,EAC7B,OAAiB;QADjB,cAAS,GAAT,SAAS,CAAoB;QAC7B,YAAO,GAAP,OAAO,CAAU;IACjC,CAAC;IAEJ,KAAK,CAAC,OAAO,CAAC,UAAwB,EAAE;QACtC,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;QACvC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC;QAC3C,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,IAAI,YAAY,GAAG,CAAC,CAAC;QAErB,MAAM,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QAEhC,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,SAAS,CAAC,CAAC;YAClE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAAC,MAAM;YAAC,CAAC;YAEjC,GAAG,CAAC,sBAAsB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YAE3D,MAAM,KAAK,GAAa,EAAE,CAAC;YAC3B,MAAM,SAAS,GAAa,EAAE,CAAC;YAE/B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,CACrC,8DAA8D,EAC9D,CAAC,GAAG,CAAC,CACN,CAAC;gBACF,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAA+C,CAAC;oBACzE,MAAM,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;oBAC1E,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBACpB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;wBACjB,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;oBACtB,CAAC;yBAAM,CAAC;wBACN,YAAY,EAAE,CAAC;oBACjB,CAAC;gBACH,CAAC;YACH,CAAC;YAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAAC,MAAM;YAAC,CAAC;YAElC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAElD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1C,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;gBACzB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;oBACf,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBAC7C,CAAC;YACH,CAAC;YAED,aAAa,IAAI,SAAS,CAAC,MAAM,CAAC;YAClC,GAAG,CAAC,YAAY,MAAM,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;QAC5D,CAAC;QAED,GAAG,CAAC,SAAS,MAAM,CAAC,aAAa,CAAC,cAAc,MAAM,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAC;QAC7F,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,CAAC;IACzC,CAAC;CACF"}
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../../src/use-cases/embed.ts"],"names":[],"mappings":"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"}

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

@@ -25,7 +25,7 @@ export class IndexCodeUseCase {
                 embedding: this.embedding,
                 meta: this.meta,
             };
-            if (this.lsp) {
+            if (this.lsp !== null) {
                 indexerOpts.lsp = this.lsp;
             }
             const indexer = new CodeIndexer(indexerOpts);
@@ -33,7 +33,7 @@ export class IndexCodeUseCase {
             if (input.full !== undefined) {
                 opts.full = input.full;
             }
-            if (input.onProgress) {
+            if (input.onProgress !== undefined) {
                 opts.onProgress = input.onProgress;
             }
             return indexer.indexProject(opts);

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

@@ -1 +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"}
+{"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,KAAK,IAAI,EAAE,CAAC;gBACtB,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,KAAK,SAAS,EAAE,CAAC;gBAAA,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,UAAU,CAAC;YAAA,CAAC;YACzE,OAAO,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/use-cases/init/bootstrap-hub.d.ts

@@ -0,0 +1,55 @@
+import type { IDockerControl, ComposeUpResult } from '../../core/ports/docker-control.js';
+import type { IHubReadinessProbe } from '../../core/ports/hub-readiness-probe.js';
+import type { IWorkspaceStore } from '../../core/ports/workspace-store.js';
+import type { HubPorts } from './resolve-hub-ports.js';
+export interface BootstrapHubOptions {
+    readonly hubDir: string;
+    readonly templateComposePath: string;
+    readonly templateConfigEnvPath: string;
+    readonly ports: HubPorts;
+    readonly skipDocker?: boolean;
+    readonly onStep?: (step: string) => void;
+}
+export type BootstrapHubResult = {
+    ok: true;
+    wroteCompose: boolean;
+    wroteConfig: boolean;
+} | {
+    ok: false;
+    stage: 'fs' | 'docker' | 'wait-db' | 'schema';
+    details: string;
+    composeError?: ComposeUpResult;
+};
+/**
+ * Factory producing an {@link IWorkspaceStore} bound to the freshly
+ * bootstrapped hub Postgres. The use case knows nothing about how the
+ * store is constructed — composition root (CLI) wires the concrete
+ * adapter and pool. Synchronous: creating a pool is non-blocking; the
+ * store performs the first await on `initialize()`.
+ */
+export type HubWorkspaceStoreFactory = (port: number) => {
+    store: IWorkspaceStore;
+    close: () => Promise<void>;
+};
+/**
+ * Idempotent bootstrap of the hub stack:
+ *   1. Ensure `<hubDir>/code/docker-compose.yml` is the hub variant
+ *      (overwrites stale code-only legacy compose).
+ *   2. Write `<hubDir>/code/.env` with HUB_*_PORT vars consumed by
+ *      the compose file via ${VAR} substitution.
+ *   3. Ensure `<hubDir>/config.env` exists from template.
+ *   4. `docker compose up -d`.
+ *   5. Poll the hub Postgres until it accepts authenticated SELECT 1.
+ *      This handles the gap between container start and Postgres
+ *      finishing initdb on first boot — without this the next step
+ *      races and fails with "password authentication failed".
+ *   6. Apply hub schema via `workspaceStore.initialize()`.
+ */
+export declare class BootstrapHubUseCase {
+    private readonly docker;
+    private readonly readinessProbe;
+    private readonly workspaceStoreFactory;
+    constructor(docker: IDockerControl, readinessProbe: IHubReadinessProbe, workspaceStoreFactory: HubWorkspaceStoreFactory);
+    execute(options: BootstrapHubOptions): Promise<BootstrapHubResult>;
+}
+//# sourceMappingURL=bootstrap-hub.d.ts.map

package/dist/use-cases/init/bootstrap-hub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap-hub.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/bootstrap-hub.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAC1F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAClF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC1C;AAED,MAAM,MAAM,kBAAkB,GAC1B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,OAAO,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,GACzD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,IAAI,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,eAAe,CAAA;CAAE,CAAC;AAElH;;;;;;GAMG;AACH,MAAM,MAAM,wBAAwB,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK;IACvD,KAAK,EAAE,eAAe,CAAC;IACvB,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAmB;IAE5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,qBAAqB;gBAFrB,MAAM,EAAE,cAAc,EACtB,cAAc,EAAE,kBAAkB,EAClC,qBAAqB,EAAE,wBAAwB;IAG5D,OAAO,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CA2DzE"}

package/dist/use-cases/init/bootstrap-hub.js

@@ -0,0 +1,116 @@
+import { copyFileSync, existsSync, mkdirSync, readFileSync, writeFileSync, chmodSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Idempotent bootstrap of the hub stack:
+ *   1. Ensure `<hubDir>/code/docker-compose.yml` is the hub variant
+ *      (overwrites stale code-only legacy compose).
+ *   2. Write `<hubDir>/code/.env` with HUB_*_PORT vars consumed by
+ *      the compose file via ${VAR} substitution.
+ *   3. Ensure `<hubDir>/config.env` exists from template.
+ *   4. `docker compose up -d`.
+ *   5. Poll the hub Postgres until it accepts authenticated SELECT 1.
+ *      This handles the gap between container start and Postgres
+ *      finishing initdb on first boot — without this the next step
+ *      races and fails with "password authentication failed".
+ *   6. Apply hub schema via `workspaceStore.initialize()`.
+ */
+export class BootstrapHubUseCase {
+    docker;
+    readinessProbe;
+    workspaceStoreFactory;
+    constructor(docker, readinessProbe, workspaceStoreFactory) {
+        this.docker = docker;
+        this.readinessProbe = readinessProbe;
+        this.workspaceStoreFactory = workspaceStoreFactory;
+    }
+    async execute(options) {
+        const log = options.onStep ?? noop;
+        let wroteCompose = false;
+        let wroteConfig = false;
+        try {
+            if (!existsSync(options.hubDir)) {
+                mkdirSync(options.hubDir, { recursive: true });
+            }
+            const migrationsDir = join(options.hubDir, 'migrations');
+            if (!existsSync(migrationsDir)) {
+                mkdirSync(migrationsDir, { recursive: true });
+            }
+            const composeTarget = join(options.hubDir, 'docker-compose.yml');
+            const needsCompose = !existsSync(composeTarget) || !isHubCompose(composeTarget);
+            if (needsCompose) {
+                copyFileSync(options.templateComposePath, composeTarget);
+                wroteCompose = true;
+                log(`wrote ${composeTarget}`);
+            }
+            writeFileSync(join(options.hubDir, '.env'), renderPortsEnv(options.ports));
+            log(`wrote ${join(options.hubDir, '.env')} (ports)`);
+            const configTarget = join(options.hubDir, 'config.env');
+            if (!existsSync(configTarget)) {
+                writeFileSync(configTarget, readFileSync(options.templateConfigEnvPath, 'utf-8'));
+                try {
+                    chmodSync(configTarget, 0o600);
+                }
+                catch { /* best-effort */ }
+                wroteConfig = true;
+                log(`wrote ${configTarget}`);
+            }
+        }
+        catch (err) {
+            return { ok: false, stage: 'fs', details: err instanceof Error ? err.message : String(err) };
+        }
+        if (options.skipDocker !== true) {
+            log('docker compose up -d');
+            const composePath = join(options.hubDir, 'docker-compose.yml');
+            const composeResult = await this.docker.composeUp(composePath, options.hubDir);
+            if (!composeResult.ok) {
+                return { ok: false, stage: 'docker', details: composeResult.details, composeError: composeResult };
+            }
+            log('waiting for Postgres to accept connections');
+            const ready = await this.readinessProbe.waitForReady(options.ports.pg);
+            if (!ready.ok) {
+                return { ok: false, stage: 'wait-db', details: ready.details };
+            }
+        }
+        log('apply hub schema');
+        const { store, close } = this.workspaceStoreFactory(options.ports.pg);
+        try {
+            await store.initialize();
+        }
+        catch (err) {
+            return { ok: false, stage: 'schema', details: err instanceof Error ? err.message : String(err) };
+        }
+        finally {
+            await close();
+        }
+        return { ok: true, wroteCompose, wroteConfig };
+    }
+}
+/**
+ * Detect whether an existing docker-compose.yml is the hub variant
+ * (which defines `pg:` and `pgweb:` services) versus a stale legacy
+ * code-only compose (only `neo4j:` + `qdrant:`). If it's the legacy
+ * version, caller should overwrite from template so the hub services
+ * come up.
+ */
+function isHubCompose(path) {
+    try {
+        const content = readFileSync(path, 'utf-8');
+        return /^\s+pg:\s*$/m.test(content) && /^\s+pgweb:\s*$/m.test(content);
+    }
+    catch {
+        return false;
+    }
+}
+function renderPortsEnv(ports) {
+    return [
+        `HUB_PG_PORT=${String(ports.pg)}`,
+        `HUB_PGWEB_PORT=${String(ports.pgweb)}`,
+        `HUB_NEO4J_HTTP_PORT=${String(ports.neo4jHttp)}`,
+        `HUB_NEO4J_BOLT_PORT=${String(ports.neo4jBolt)}`,
+        `HUB_QDRANT_REST_PORT=${String(ports.qdrantRest)}`,
+        `HUB_QDRANT_GRPC_PORT=${String(ports.qdrantGrpc)}`,
+        '',
+    ].join('\n');
+}
+function noop(_step) { }
+//# sourceMappingURL=bootstrap-hub.js.map

package/dist/use-cases/init/bootstrap-hub.js.map

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

package/dist/use-cases/init/check-dims-conflict.d.ts

@@ -0,0 +1,33 @@
+import type { ICodeVectorStore } from '../../core/ports/code-vector-store.js';
+export type CheckDimsConflictResult = {
+    conflict: false;
+    reason: 'no-collection' | 'matches';
+    existingDims?: number;
+} | {
+    conflict: true;
+    projectId: string;
+    existingDims: number;
+    newDims: number;
+    vectorCollection: string;
+};
+/**
+ * Compare embedding dimensionality currently stored in the Qdrant
+ * collection for this workspace against the dims the user just set up.
+ *
+ * Qdrant is the source of truth for `vectorDim` — it is enforced by
+ * the collection schema, not derivable from any other store. If a user
+ * switches between embedding providers with different dimensionality
+ * (e.g. nomic-embed-text 768 → voyage-code-3 1024), the existing
+ * collection must be deleted before re-indexing. We surface that at
+ * init time instead of crashing later in `argustack code index`.
+ *
+ * Returns `{ conflict: false, reason: 'no-collection' }` when this
+ * workspace has never been indexed (no collection in Qdrant yet) —
+ * first-time setup, nothing to compare against.
+ */
+export declare class CheckDimsConflictUseCase {
+    private readonly vec;
+    constructor(vec: ICodeVectorStore);
+    execute(workspaceId: string, newDims: number): Promise<CheckDimsConflictResult>;
+}
+//# sourceMappingURL=check-dims-conflict.d.ts.map

package/dist/use-cases/init/check-dims-conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-dims-conflict.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/check-dims-conflict.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC;AAE9E,MAAM,MAAM,uBAAuB,GAC/B;IAAE,QAAQ,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/E;IACE,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEN;;;;;;;;;;;;;;GAcG;AACH,qBAAa,wBAAwB;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAAH,GAAG,EAAE,gBAAgB;IAE5C,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAiBtF"}

package/dist/use-cases/init/check-dims-conflict.js

@@ -0,0 +1,39 @@
+/**
+ * Compare embedding dimensionality currently stored in the Qdrant
+ * collection for this workspace against the dims the user just set up.
+ *
+ * Qdrant is the source of truth for `vectorDim` — it is enforced by
+ * the collection schema, not derivable from any other store. If a user
+ * switches between embedding providers with different dimensionality
+ * (e.g. nomic-embed-text 768 → voyage-code-3 1024), the existing
+ * collection must be deleted before re-indexing. We surface that at
+ * init time instead of crashing later in `argustack code index`.
+ *
+ * Returns `{ conflict: false, reason: 'no-collection' }` when this
+ * workspace has never been indexed (no collection in Qdrant yet) —
+ * first-time setup, nothing to compare against.
+ */
+export class CheckDimsConflictUseCase {
+    vec;
+    constructor(vec) {
+        this.vec = vec;
+    }
+    async execute(workspaceId, newDims) {
+        const exists = await this.vec.collectionExists(workspaceId);
+        if (!exists) {
+            return { conflict: false, reason: 'no-collection' };
+        }
+        const stats = await this.vec.getCollectionStats(workspaceId);
+        if (stats.vectorDim === newDims) {
+            return { conflict: false, reason: 'matches', existingDims: stats.vectorDim };
+        }
+        return {
+            conflict: true,
+            projectId: workspaceId,
+            existingDims: stats.vectorDim,
+            newDims,
+            vectorCollection: `code_${workspaceId}`,
+        };
+    }
+}
+//# sourceMappingURL=check-dims-conflict.js.map

package/dist/use-cases/init/check-dims-conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-dims-conflict.js","sourceRoot":"","sources":["../../../src/use-cases/init/check-dims-conflict.ts"],"names":[],"mappings":"AAYA;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,wBAAwB;IACN;IAA7B,YAA6B,GAAqB;QAArB,QAAG,GAAH,GAAG,CAAkB;IAAG,CAAC;IAEtD,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,OAAe;QAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC5D,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QACtD,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;QAC7D,IAAI,KAAK,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;YAChC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC;QAC/E,CAAC;QACD,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,WAAW;YACtB,YAAY,EAAE,KAAK,CAAC,SAAS;YAC7B,OAAO;YACP,gBAAgB,EAAE,QAAQ,WAAW,EAAE;SACxC,CAAC;IACJ,CAAC;CACF"}

package/dist/use-cases/init/check-hub-exists.d.ts

@@ -0,0 +1,23 @@
+import type { IWorkspaceStore } from '../../core/ports/workspace-store.js';
+export type HubCheckReason = 'no-compose' | 'no-config-env' | 'db-unreachable';
+export type CheckHubExistsResult = {
+    exists: true;
+} | {
+    exists: false;
+    reason: HubCheckReason;
+};
+/**
+ * Decide whether `argustack init` should run the bootstrap path or
+ * the re-init path. Bootstrap is skipped only when ALL preconditions
+ * are present:
+ *   - `<hubDir>/docker-compose.yml` exists
+ *   - `<hubDir>/config.env` exists
+ *   - hub Postgres responds to a trivial query
+ */
+export declare class CheckHubExistsUseCase {
+    private readonly hubDir;
+    private readonly hubStore;
+    constructor(hubDir: string, hubStore: IWorkspaceStore | null);
+    execute(): Promise<CheckHubExistsResult>;
+}
+//# sourceMappingURL=check-hub-exists.d.ts.map

package/dist/use-cases/init/check-hub-exists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-hub-exists.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/check-hub-exists.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E,MAAM,MAAM,cAAc,GACtB,YAAY,GACZ,eAAe,GACf,gBAAgB,CAAC;AAErB,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GAChB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAE9C;;;;;;;GAOG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,eAAe,GAAG,IAAI;IAG7C,OAAO,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAmB/C"}

package/dist/use-cases/init/check-hub-exists.js

@@ -0,0 +1,39 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Decide whether `argustack init` should run the bootstrap path or
+ * the re-init path. Bootstrap is skipped only when ALL preconditions
+ * are present:
+ *   - `<hubDir>/docker-compose.yml` exists
+ *   - `<hubDir>/config.env` exists
+ *   - hub Postgres responds to a trivial query
+ */
+export class CheckHubExistsUseCase {
+    hubDir;
+    hubStore;
+    constructor(hubDir, hubStore) {
+        this.hubDir = hubDir;
+        this.hubStore = hubStore;
+    }
+    async execute() {
+        const composePath = join(this.hubDir, 'docker-compose.yml');
+        if (!existsSync(composePath)) {
+            return { exists: false, reason: 'no-compose' };
+        }
+        const configPath = join(this.hubDir, 'config.env');
+        if (!existsSync(configPath)) {
+            return { exists: false, reason: 'no-config-env' };
+        }
+        if (this.hubStore === null) {
+            return { exists: false, reason: 'db-unreachable' };
+        }
+        try {
+            await this.hubStore.list();
+            return { exists: true };
+        }
+        catch {
+            return { exists: false, reason: 'db-unreachable' };
+        }
+    }
+}
+//# sourceMappingURL=check-hub-exists.js.map

package/dist/use-cases/init/check-hub-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-hub-exists.js","sourceRoot":"","sources":["../../../src/use-cases/init/check-hub-exists.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAYjC;;;;;;;GAOG;AACH,MAAM,OAAO,qBAAqB;IAEb;IACA;IAFnB,YACmB,MAAc,EACd,QAAgC;QADhC,WAAM,GAAN,MAAM,CAAQ;QACd,aAAQ,GAAR,QAAQ,CAAwB;IAChD,CAAC;IAEJ,KAAK,CAAC,OAAO;QACX,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;QAC5D,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC7B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;QACjD,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;QACpD,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC3B,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QACrD,CAAC;QACD,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC3B,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;QACrD,CAAC;IACH,CAAC;CACF"}

package/dist/use-cases/init/check-ports.d.ts

@@ -0,0 +1,18 @@
+import type { IPlatformProbe, PortInUse } from '../../core/ports/platform-probe.js';
+export type CheckPortsResult = {
+    free: true;
+} | {
+    free: false;
+    conflicts: readonly PortInUse[];
+};
+/**
+ * Check that the hub-stack ports are not occupied by other processes.
+ * Returns the full list of conflicts so the caller can show all of
+ * them at once (instead of one-by-one).
+ */
+export declare class CheckPortsUseCase {
+    private readonly platform;
+    constructor(platform: IPlatformProbe);
+    execute(ports: readonly number[]): Promise<CheckPortsResult>;
+}
+//# sourceMappingURL=check-ports.d.ts.map

package/dist/use-cases/init/check-ports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-ports.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/check-ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAc,MAAM,oCAAoC,CAAC;AAEhG,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GACd;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,SAAS,SAAS,EAAE,CAAA;CAAE,CAAC;AAErD;;;;GAIG;AACH,qBAAa,iBAAiB;IAChB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,cAAc;IAE/C,OAAO,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAanE"}

package/dist/use-cases/init/check-ports.js

@@ -0,0 +1,25 @@
+/**
+ * Check that the hub-stack ports are not occupied by other processes.
+ * Returns the full list of conflicts so the caller can show all of
+ * them at once (instead of one-by-one).
+ */
+export class CheckPortsUseCase {
+    platform;
+    constructor(platform) {
+        this.platform = platform;
+    }
+    async execute(ports) {
+        const conflicts = [];
+        for (const port of ports) {
+            const status = await this.platform.checkPort(port);
+            if (!status.free) {
+                conflicts.push(status);
+            }
+        }
+        if (conflicts.length === 0) {
+            return { free: true };
+        }
+        return { free: false, conflicts };
+    }
+}
+//# sourceMappingURL=check-ports.js.map

package/dist/use-cases/init/check-ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-ports.js","sourceRoot":"","sources":["../../../src/use-cases/init/check-ports.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IACC;IAA7B,YAA6B,QAAwB;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;IAAG,CAAC;IAEzD,KAAK,CAAC,OAAO,CAAC,KAAwB;QACpC,MAAM,SAAS,GAAgB,EAAE,CAAC;QAClC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,MAAM,GAAe,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAC/D,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QACxB,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACpC,CAAC;CACF"}

package/dist/use-cases/init/check-versions.d.ts

@@ -0,0 +1,37 @@
+import type { IPlatformProbe } from '../../core/ports/platform-probe.js';
+import type { IDockerControl, DockerVersion } from '../../core/ports/docker-control.js';
+export type CheckVersionsFailure = {
+    kind: 'node-too-old';
+    current: string;
+    required: string;
+} | {
+    kind: 'docker-missing';
+} | {
+    kind: 'docker-too-old';
+    current: string;
+    required: string;
+} | {
+    kind: 'compose-v1';
+    current: string;
+};
+export type CheckVersionsResult = {
+    ok: true;
+    node: string;
+    docker: DockerVersion | null;
+} | {
+    ok: false;
+    failure: CheckVersionsFailure;
+    node: string;
+};
+/**
+ * Check minimum versions of node + docker + compose required by argustack.
+ * Returns a typed failure when something is out of date so callers can
+ * surface a precise error.
+ */
+export declare class CheckVersionsUseCase {
+    private readonly platform;
+    private readonly docker;
+    constructor(platform: IPlatformProbe, docker: IDockerControl);
+    execute(): Promise<CheckVersionsResult>;
+}
+//# sourceMappingURL=check-versions.d.ts.map

package/dist/use-cases/init/check-versions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-versions.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/check-versions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAExF,MAAM,MAAM,oBAAoB,GAC5B;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,gBAAgB,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC7D;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAA;CAAE,GACxD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAM/D;;;;GAIG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,cAAc;IAGnC,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAsC9C"}

package/dist/use-cases/init/check-versions.js

@@ -0,0 +1,50 @@
+const MIN_NODE_MAJOR = 18;
+const MIN_DOCKER_MAJOR = 20;
+const MIN_COMPOSE_MAJOR = 2;
+/**
+ * Check minimum versions of node + docker + compose required by argustack.
+ * Returns a typed failure when something is out of date so callers can
+ * surface a precise error.
+ */
+export class CheckVersionsUseCase {
+    platform;
+    docker;
+    constructor(platform, docker) {
+        this.platform = platform;
+        this.docker = docker;
+    }
+    async execute() {
+        void this.platform;
+        const node = process.versions.node;
+        const nodeMajor = Number(node.split('.')[0] ?? '0');
+        if (nodeMajor < MIN_NODE_MAJOR) {
+            return {
+                ok: false,
+                node,
+                failure: { kind: 'node-too-old', current: node, required: `${String(MIN_NODE_MAJOR)}.0` },
+            };
+        }
+        const dockerInstalled = await this.docker.isInstalled();
+        if (!dockerInstalled) {
+            return { ok: false, node, failure: { kind: 'docker-missing' } };
+        }
+        const version = await this.docker.version();
+        if (version === null) {
+            return { ok: true, node, docker: null };
+        }
+        const engineMajor = Number(version.engine.split('.')[0] ?? '0');
+        if (engineMajor < MIN_DOCKER_MAJOR) {
+            return {
+                ok: false,
+                node,
+                failure: { kind: 'docker-too-old', current: version.engine, required: `${String(MIN_DOCKER_MAJOR)}.0` },
+            };
+        }
+        const composeMajor = Number(version.compose.split('.')[0] ?? '0');
+        if (composeMajor < MIN_COMPOSE_MAJOR) {
+            return { ok: false, node, failure: { kind: 'compose-v1', current: version.compose } };
+        }
+        return { ok: true, node, docker: version };
+    }
+}
+//# sourceMappingURL=check-versions.js.map

package/dist/use-cases/init/check-versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-versions.js","sourceRoot":"","sources":["../../../src/use-cases/init/check-versions.ts"],"names":[],"mappings":"AAaA,MAAM,cAAc,GAAG,EAAE,CAAC;AAC1B,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAC5B,MAAM,iBAAiB,GAAG,CAAC,CAAC;AAE5B;;;;GAIG;AACH,MAAM,OAAO,oBAAoB;IAEZ;IACA;IAFnB,YACmB,QAAwB,EACxB,MAAsB;QADtB,aAAQ,GAAR,QAAQ,CAAgB;QACxB,WAAM,GAAN,MAAM,CAAgB;IACtC,CAAC;IAEJ,KAAK,CAAC,OAAO;QACX,KAAK,IAAI,CAAC,QAAQ,CAAC;QACnB,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;QACnC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QACpD,IAAI,SAAS,GAAG,cAAc,EAAE,CAAC;YAC/B,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,IAAI;gBACJ,OAAO,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE;aAC1F,CAAC;QACJ,CAAC;QAED,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;QACxD,IAAI,CAAC,eAAe,EAAE,CAAC;YACrB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,EAAE,CAAC;QAClE,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QAC5C,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACrB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAC1C,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAChE,IAAI,WAAW,GAAG,gBAAgB,EAAE,CAAC;YACnC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,IAAI;gBACJ,OAAO,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,OAAO,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE;aACxG,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;QAClE,IAAI,YAAY,GAAG,iBAAiB,EAAE,CAAC;YACrC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QACxF,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7C,CAAC;CACF"}

package/dist/use-cases/init/clear-stale-active.d.ts

@@ -0,0 +1,20 @@
+import type { IWorkspaceStore } from '../../core/ports/workspace-store.js';
+export type ClearStaleActiveResult = {
+    cleared: false;
+    reason: 'no-active' | 'still-valid';
+} | {
+    cleared: true;
+    staleId: string;
+};
+/**
+ * Re-init recovery: if `~/.argustack/active-workspace.json` points at
+ * a workspace that no longer exists in the `workspaces` table (because
+ * the user ran `argustack workspace remove` and didn't clean up the
+ * pointer), wipe the stale file so resolution falls back to the list.
+ */
+export declare class ClearStaleActiveUseCase {
+    private readonly hubStore;
+    constructor(hubStore: IWorkspaceStore);
+    execute(): Promise<ClearStaleActiveResult>;
+}
+//# sourceMappingURL=clear-stale-active.d.ts.map

package/dist/use-cases/init/clear-stale-active.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-stale-active.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/clear-stale-active.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAG3E,MAAM,MAAM,sBAAsB,GAC9B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,GAAG,aAAa,CAAA;CAAE,GACvD;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC;;;;;GAKG;AACH,qBAAa,uBAAuB;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,eAAe;IAEhD,OAAO,IAAI,OAAO,CAAC,sBAAsB,CAAC;CAYjD"}

package/dist/use-cases/init/clear-stale-active.js

@@ -0,0 +1,26 @@
+import { getActiveWorkspace, clearActiveWorkspace } from '../../workspace/active-workspace.js';
+/**
+ * Re-init recovery: if `~/.argustack/active-workspace.json` points at
+ * a workspace that no longer exists in the `workspaces` table (because
+ * the user ran `argustack workspace remove` and didn't clean up the
+ * pointer), wipe the stale file so resolution falls back to the list.
+ */
+export class ClearStaleActiveUseCase {
+    hubStore;
+    constructor(hubStore) {
+        this.hubStore = hubStore;
+    }
+    async execute() {
+        const active = getActiveWorkspace();
+        if (active === null) {
+            return { cleared: false, reason: 'no-active' };
+        }
+        const existing = await this.hubStore.getById(active.activeWorkspaceId);
+        if (existing !== null) {
+            return { cleared: false, reason: 'still-valid' };
+        }
+        clearActiveWorkspace();
+        return { cleared: true, staleId: active.activeWorkspaceId };
+    }
+}
+//# sourceMappingURL=clear-stale-active.js.map

package/dist/use-cases/init/clear-stale-active.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clear-stale-active.js","sourceRoot":"","sources":["../../../src/use-cases/init/clear-stale-active.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAM/F;;;;;GAKG;AACH,MAAM,OAAO,uBAAuB;IACL;IAA7B,YAA6B,QAAyB;QAAzB,aAAQ,GAAR,QAAQ,CAAiB;IAAG,CAAC;IAE1D,KAAK,CAAC,OAAO;QACX,MAAM,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACpC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;QACjD,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;QACvE,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QACnD,CAAC;QACD,oBAAoB,EAAE,CAAC;QACvB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,iBAAiB,EAAE,CAAC;IAC9D,CAAC;CACF"}