argustack 0.1.34 → 0.3.1

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"}

package/dist/use-cases/init/ensure-embedding-model.d.ts

@@ -0,0 +1,20 @@
+import type { IOllamaControl, PullError } from '../../core/ports/ollama-control.js';
+export type EnsureEmbeddingModelResult = {
+    ok: true;
+    alreadyPresent: boolean;
+} | {
+    ok: false;
+    kind: PullError;
+    details: string;
+};
+/**
+ * Make sure the requested embedding model is available in Ollama.
+ * If it's already in `ollama list` — return immediately. Otherwise
+ * trigger `ollama pull` and stream progress through `onProgress`.
+ */
+export declare class EnsureEmbeddingModelUseCase {
+    private readonly ollama;
+    constructor(ollama: IOllamaControl);
+    execute(modelName: string, onProgress?: (pct: number, status: string) => void): Promise<EnsureEmbeddingModelResult>;
+}
+//# sourceMappingURL=ensure-embedding-model.d.ts.map

package/dist/use-cases/init/ensure-embedding-model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-embedding-model.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/ensure-embedding-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEpF,MAAM,MAAM,0BAA0B,GAClC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpD;;;;GAIG;AACH,qBAAa,2BAA2B;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE7C,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,GACjD,OAAO,CAAC,0BAA0B,CAAC;CAYvC"}

package/dist/use-cases/init/ensure-embedding-model.js

@@ -0,0 +1,24 @@
+/**
+ * Make sure the requested embedding model is available in Ollama.
+ * If it's already in `ollama list` — return immediately. Otherwise
+ * trigger `ollama pull` and stream progress through `onProgress`.
+ */
+export class EnsureEmbeddingModelUseCase {
+    ollama;
+    constructor(ollama) {
+        this.ollama = ollama;
+    }
+    async execute(modelName, onProgress) {
+        const models = await this.ollama.listModels();
+        const present = models.some((m) => m.name === modelName || m.name.startsWith(`${modelName}:`));
+        if (present) {
+            return { ok: true, alreadyPresent: true };
+        }
+        const result = await this.ollama.pullModel(modelName, onProgress);
+        if (result.ok) {
+            return { ok: true, alreadyPresent: false };
+        }
+        return { ok: false, kind: result.kind, details: result.details };
+    }
+}
+//# sourceMappingURL=ensure-embedding-model.js.map

package/dist/use-cases/init/ensure-embedding-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-embedding-model.js","sourceRoot":"","sources":["../../../src/use-cases/init/ensure-embedding-model.ts"],"names":[],"mappings":"AAMA;;;;GAIG;AACH,MAAM,OAAO,2BAA2B;IACT;IAA7B,YAA6B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAEvD,KAAK,CAAC,OAAO,CACX,SAAiB,EACjB,UAAkD;QAElD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;QAC/F,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;QAC5C,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;QAC7C,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACnE,CAAC;CACF"}

package/dist/use-cases/init/ensure-ollama-running.d.ts

@@ -0,0 +1,19 @@
+import type { IOllamaControl } from '../../core/ports/ollama-control.js';
+export type EnsureOllamaRunningResult = {
+    ok: true;
+    alreadyRunning: boolean;
+} | {
+    ok: false;
+    reason: 'timeout';
+};
+/**
+ * Make sure `ollama serve` is reachable on http://localhost:11434.
+ * Starts the daemon in the background if it's not running, then
+ * waits up to `timeoutMs` for the HTTP API to answer.
+ */
+export declare class EnsureOllamaRunningUseCase {
+    private readonly ollama;
+    constructor(ollama: IOllamaControl);
+    execute(timeoutMs?: number): Promise<EnsureOllamaRunningResult>;
+}
+//# sourceMappingURL=ensure-ollama-running.d.ts.map

package/dist/use-cases/init/ensure-ollama-running.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-ollama-running.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/ensure-ollama-running.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,MAAM,yBAAyB,GACjC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,cAAc,EAAE,OAAO,CAAA;CAAE,GACrC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,SAAS,CAAA;CAAE,CAAC;AAIrC;;;;GAIG;AACH,qBAAa,0BAA0B;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE7C,OAAO,CAAC,SAAS,GAAE,MAA2B,GAAG,OAAO,CAAC,yBAAyB,CAAC;CAW1F"}

package/dist/use-cases/init/ensure-ollama-running.js

@@ -0,0 +1,24 @@
+const DEFAULT_TIMEOUT_MS = 30_000;
+/**
+ * Make sure `ollama serve` is reachable on http://localhost:11434.
+ * Starts the daemon in the background if it's not running, then
+ * waits up to `timeoutMs` for the HTTP API to answer.
+ */
+export class EnsureOllamaRunningUseCase {
+    ollama;
+    constructor(ollama) {
+        this.ollama = ollama;
+    }
+    async execute(timeoutMs = DEFAULT_TIMEOUT_MS) {
+        if (await this.ollama.isRunning()) {
+            return { ok: true, alreadyRunning: true };
+        }
+        await this.ollama.startInBackground();
+        const healthy = await this.ollama.waitHealthy(timeoutMs);
+        if (!healthy) {
+            return { ok: false, reason: 'timeout' };
+        }
+        return { ok: true, alreadyRunning: false };
+    }
+}
+//# sourceMappingURL=ensure-ollama-running.js.map

package/dist/use-cases/init/ensure-ollama-running.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-ollama-running.js","sourceRoot":"","sources":["../../../src/use-cases/init/ensure-ollama-running.ts"],"names":[],"mappings":"AAMA,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAElC;;;;GAIG;AACH,MAAM,OAAO,0BAA0B;IACR;IAA7B,YAA6B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAEvD,KAAK,CAAC,OAAO,CAAC,YAAoB,kBAAkB;QAClD,IAAI,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,EAAE,CAAC;YAClC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC;QAC5C,CAAC;QACD,MAAM,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC;CACF"}

package/dist/use-cases/init/health-check-existing-llm.d.ts

@@ -0,0 +1,25 @@
+import type { HubConfig } from '../../workspace/hub-config.js';
+import type { ProbeLlmUseCase } from './probe-llm.js';
+export type HealthCheckExistingLlmResult = {
+    configured: false;
+} | {
+    configured: true;
+    healthy: true;
+    dims: number;
+} | {
+    configured: true;
+    healthy: false;
+    details: string;
+};
+/**
+ * Re-init flow: if the hub already has an LLM provider configured,
+ * do a single quick probe to make sure it still works. Used to warn
+ * the user that their LM Studio is down / model was deleted, with
+ * an offer to reconfigure.
+ */
+export declare class HealthCheckExistingLlmUseCase {
+    private readonly probe;
+    constructor(probe: ProbeLlmUseCase);
+    execute(config: HubConfig): Promise<HealthCheckExistingLlmResult>;
+}
+//# sourceMappingURL=health-check-existing-llm.d.ts.map

package/dist/use-cases/init/health-check-existing-llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check-existing-llm.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/health-check-existing-llm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,MAAM,4BAA4B,GACpC;IAAE,UAAU,EAAE,KAAK,CAAA;CAAE,GACrB;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,UAAU,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D;;;;;GAKG;AACH,qBAAa,6BAA6B;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK;gBAAL,KAAK,EAAE,eAAe;IAE7C,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,4BAA4B,CAAC;CAexE"}

package/dist/use-cases/init/health-check-existing-llm.js

@@ -0,0 +1,42 @@
+/**
+ * Re-init flow: if the hub already has an LLM provider configured,
+ * do a single quick probe to make sure it still works. Used to warn
+ * the user that their LM Studio is down / model was deleted, with
+ * an offer to reconfigure.
+ */
+export class HealthCheckExistingLlmUseCase {
+    probe;
+    constructor(probe) {
+        this.probe = probe;
+    }
+    async execute(config) {
+        if (!config.embedding.userConfigured) {
+            return { configured: false };
+        }
+        const url = resolveUrl(config);
+        const model = config.embedding.model;
+        if (url === null || url === '' || model === '') {
+            return { configured: false };
+        }
+        const result = await this.probe.execute({ url, model, retries: 1 });
+        if (result.ok) {
+            return { configured: true, healthy: true, dims: result.dims };
+        }
+        return { configured: true, healthy: false, details: `${result.kind}: ${result.details}` };
+    }
+}
+function resolveUrl(config) {
+    switch (config.embedding.provider) {
+        case 'ollama':
+            return config.embedding.ollamaUrl ?? 'http://localhost:11434';
+        case 'lmstudio':
+            return config.embedding.lmstudioUrl ?? 'http://localhost:1234';
+        case 'custom':
+            return config.embedding.customUrl ?? null;
+        case 'voyage':
+            return null;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=health-check-existing-llm.js.map

package/dist/use-cases/init/health-check-existing-llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check-existing-llm.js","sourceRoot":"","sources":["../../../src/use-cases/init/health-check-existing-llm.ts"],"names":[],"mappings":"AAQA;;;;;GAKG;AACH,MAAM,OAAO,6BAA6B;IACX;IAA7B,YAA6B,KAAsB;QAAtB,UAAK,GAAL,KAAK,CAAiB;IAAG,CAAC;IAEvD,KAAK,CAAC,OAAO,CAAC,MAAiB;QAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,CAAC;YACrC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC/B,CAAC;QACD,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QACrC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;YAC/C,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;QAC/B,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC;QACpE,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;QAChE,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;IAC5F,CAAC;CACF;AAED,SAAS,UAAU,CAAC,MAAiB;IACnC,QAAQ,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,CAAC;QAClC,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,SAAS,CAAC,SAAS,IAAI,wBAAwB,CAAC;QAChE,KAAK,UAAU;YACb,OAAO,MAAM,CAAC,SAAS,CAAC,WAAW,IAAI,uBAAuB,CAAC;QACjE,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,SAAS,CAAC,SAAS,IAAI,IAAI,CAAC;QAC5C,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC;QACd;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC"}

package/dist/use-cases/init/install-ollama.d.ts

@@ -0,0 +1,27 @@
+import type { IOllamaControl } from '../../core/ports/ollama-control.js';
+import type { IPlatformProbe } from '../../core/ports/platform-probe.js';
+export type InstallOllamaFailureKind = 'unsupported-os' | 'no-brew-no-curl' | 'brew-failed' | 'curl-failed';
+export type InstallOllamaResult = {
+    ok: true;
+    via: 'brew' | 'curl';
+} | {
+    ok: false;
+    kind: InstallOllamaFailureKind;
+    details: string;
+};
+/**
+ * Install Ollama using whatever package manager is appropriate for
+ * the current OS. macOS tries `brew install ollama` first, falls back
+ * to `curl install.sh` if brew is missing or fails. Linux uses
+ * `curl install.sh` directly. Windows is rejected (caller should show
+ * the manual link).
+ */
+export declare class InstallOllamaUseCase {
+    private readonly ollama;
+    private readonly platform;
+    constructor(ollama: IOllamaControl, platform: IPlatformProbe);
+    execute(): Promise<InstallOllamaResult>;
+    private tryBrew;
+    private tryCurl;
+}
+//# sourceMappingURL=install-ollama.d.ts.map

package/dist/use-cases/init/install-ollama.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-ollama.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/install-ollama.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,oCAAoC,CAAC;AACxF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,MAAM,MAAM,wBAAwB,GAChC,gBAAgB,GAChB,iBAAiB,GACjB,aAAa,GACb,aAAa,CAAC;AAElB,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAClC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,wBAAwB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEnE;;;;;;GAMG;AACH,qBAAa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBADR,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,cAAc;IAGrC,OAAO,IAAI,OAAO,CAAC,mBAAmB,CAAC;YAe/B,OAAO;YAYP,OAAO;CAWtB"}

package/dist/use-cases/init/install-ollama.js

@@ -0,0 +1,51 @@
+/**
+ * Install Ollama using whatever package manager is appropriate for
+ * the current OS. macOS tries `brew install ollama` first, falls back
+ * to `curl install.sh` if brew is missing or fails. Linux uses
+ * `curl install.sh` directly. Windows is rejected (caller should show
+ * the manual link).
+ */
+export class InstallOllamaUseCase {
+    ollama;
+    platform;
+    constructor(ollama, platform) {
+        this.ollama = ollama;
+        this.platform = platform;
+    }
+    async execute() {
+        const os = this.platform.detectOS();
+        if (os === 'windows' || os === 'unknown') {
+            return { ok: false, kind: 'unsupported-os', details: `OS=${os}` };
+        }
+        if (os === 'macos') {
+            const brewResult = await this.tryBrew();
+            if (brewResult !== null) {
+                return brewResult;
+            }
+        }
+        return this.tryCurl();
+    }
+    async tryBrew() {
+        const has = await this.platform.hasCommand('brew');
+        if (!has) {
+            return null;
+        }
+        const result = await this.ollama.installViaBrew();
+        if (result.ok) {
+            return { ok: true, via: 'brew' };
+        }
+        return { ok: false, kind: 'brew-failed', details: result.details };
+    }
+    async tryCurl() {
+        const has = await this.platform.hasCommand('curl');
+        if (!has) {
+            return { ok: false, kind: 'no-brew-no-curl', details: 'curl not installed' };
+        }
+        const result = await this.ollama.installViaCurl();
+        if (result.ok) {
+            return { ok: true, via: 'curl' };
+        }
+        return { ok: false, kind: 'curl-failed', details: result.details };
+    }
+}
+//# sourceMappingURL=install-ollama.js.map

package/dist/use-cases/init/install-ollama.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-ollama.js","sourceRoot":"","sources":["../../../src/use-cases/init/install-ollama.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,MAAM,OAAO,oBAAoB;IAEZ;IACA;IAFnB,YACmB,MAAsB,EACtB,QAAwB;QADxB,WAAM,GAAN,MAAM,CAAgB;QACtB,aAAQ,GAAR,QAAQ,CAAgB;IACxC,CAAC;IAEJ,KAAK,CAAC,OAAO;QACX,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACpC,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,SAAS,EAAE,CAAC;YACzC,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACpE,CAAC;QAED,IAAI,EAAE,KAAK,OAAO,EAAE,CAAC;YACnB,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,MAAM,GAAkB,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QACjE,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACrE,CAAC;IAEO,KAAK,CAAC,OAAO;QACnB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,oBAAoB,EAAE,CAAC;QAC/E,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;QAClD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;QACnC,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IACrE,CAAC;CACF"}

package/dist/use-cases/init/probe-llm.d.ts

@@ -0,0 +1,32 @@
+import type { IOllamaControl, ProbeError } from '../../core/ports/ollama-control.js';
+export interface ProbeLlmInput {
+    readonly url: string;
+    readonly model: string;
+    readonly retries?: number;
+    readonly delayMs?: number;
+}
+export type ProbeLlmResult = {
+    ok: true;
+    dims: number;
+    attempts: number;
+} | {
+    ok: false;
+    kind: ProbeError;
+    details: string;
+    attempts: number;
+};
+/**
+ * Try to fetch an embedding from the given URL+model. Retries up to
+ * `retries` times with a fixed delay so transient timeouts don't fail
+ * the whole init.
+ *
+ * Works for any OpenAI-compatible /api/embeddings endpoint (Ollama,
+ * LM Studio, llama-server). Internally calls `IOllamaControl.probeEmbedding`
+ * which sends a POST to `${url}/api/embeddings`.
+ */
+export declare class ProbeLlmUseCase {
+    private readonly ollama;
+    constructor(ollama: IOllamaControl);
+    execute(input: ProbeLlmInput): Promise<ProbeLlmResult>;
+}
+//# sourceMappingURL=probe-llm.d.ts.map

package/dist/use-cases/init/probe-llm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-llm.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/probe-llm.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAErF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAMvE;;;;;;;;GAQG;AACH,qBAAa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,cAAc;IAE7C,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;CAwB7D"}

package/dist/use-cases/init/probe-llm.js

@@ -0,0 +1,42 @@
+const DEFAULT_RETRIES = 3;
+const DEFAULT_DELAY_MS = 5000;
+const PROBE_TEXT = 'argustack-init-probe';
+/**
+ * Try to fetch an embedding from the given URL+model. Retries up to
+ * `retries` times with a fixed delay so transient timeouts don't fail
+ * the whole init.
+ *
+ * Works for any OpenAI-compatible /api/embeddings endpoint (Ollama,
+ * LM Studio, llama-server). Internally calls `IOllamaControl.probeEmbedding`
+ * which sends a POST to `${url}/api/embeddings`.
+ */
+export class ProbeLlmUseCase {
+    ollama;
+    constructor(ollama) {
+        this.ollama = ollama;
+    }
+    async execute(input) {
+        const retries = input.retries ?? DEFAULT_RETRIES;
+        const delay = input.delayMs ?? DEFAULT_DELAY_MS;
+        let attempts = 0;
+        let lastKind = 'no-response';
+        let lastDetails = '';
+        while (attempts < retries) {
+            attempts += 1;
+            const result = await this.ollama.probeEmbedding(input.model, PROBE_TEXT, input.url);
+            if (result.ok) {
+                return { ok: true, dims: result.dims, attempts };
+            }
+            lastKind = result.kind;
+            lastDetails = result.details;
+            if (result.kind === 'model-not-found' || result.kind === 'wrong-format') {
+                return { ok: false, kind: result.kind, details: result.details, attempts };
+            }
+            if (attempts < retries) {
+                await new Promise((r) => setTimeout(r, delay));
+            }
+        }
+        return { ok: false, kind: lastKind, details: lastDetails, attempts };
+    }
+}
+//# sourceMappingURL=probe-llm.js.map

package/dist/use-cases/init/probe-llm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe-llm.js","sourceRoot":"","sources":["../../../src/use-cases/init/probe-llm.ts"],"names":[],"mappings":"AAaA,MAAM,eAAe,GAAG,CAAC,CAAC;AAC1B,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAC9B,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAE1C;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IACG;IAA7B,YAA6B,MAAsB;QAAtB,WAAM,GAAN,MAAM,CAAgB;IAAG,CAAC;IAEvD,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,eAAe,CAAC;QACjD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;QAChD,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,IAAI,QAAQ,GAAe,aAAa,CAAC;QACzC,IAAI,WAAW,GAAG,EAAE,CAAC;QAErB,OAAO,QAAQ,GAAG,OAAO,EAAE,CAAC;YAC1B,QAAQ,IAAI,CAAC,CAAC;YACd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YACpF,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;gBACd,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;YACnD,CAAC;YACD,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;YACvB,WAAW,GAAG,MAAM,CAAC,OAAO,CAAC;YAC7B,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;gBACxE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC;YAC7E,CAAC;YACD,IAAI,QAAQ,GAAG,OAAO,EAAE,CAAC;gBACvB,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IACvE,CAAC;CACF"}

package/dist/use-cases/init/resolve-hub-ports.d.ts

@@ -0,0 +1,46 @@
+import type { IPlatformProbe, PortInUse } from '../../core/ports/platform-probe.js';
+export interface HubPorts {
+    pg: number;
+    pgweb: number;
+    neo4jHttp: number;
+    neo4jBolt: number;
+    qdrantRest: number;
+    qdrantGrpc: number;
+}
+export type HubPortKey = keyof HubPorts;
+export interface PortPlanEntry {
+    readonly key: HubPortKey;
+    readonly default: number;
+    readonly current: number;
+    readonly conflict: PortInUse | null;
+    readonly suggested: number | null;
+}
+export interface ResolveHubPortsResult {
+    readonly plan: readonly PortPlanEntry[];
+    /**
+     * `true` when at least one port differs from its default — caller
+     * should ask the user to confirm / customize. `false` means the
+     * default set is fully usable and init can continue silently.
+     */
+    readonly needsConfirmation: boolean;
+}
+/**
+ * Pre-bootstrap port planner. For each hub service:
+ *   1. Try its default port.
+ *   2. If occupied — record the conflict and scan forward up to
+ *      `MAX_FALLBACK_SCAN` ports for a free one. The suggested
+ *      number is the first free port found.
+ *   3. Skip ports that are already chosen earlier in the plan so two
+ *      services never collide on the same suggestion.
+ *
+ * Caller (init flow) then prompts the user per conflict: accept
+ * suggestion, enter custom, or abort.
+ */
+export declare class ResolveHubPortsUseCase {
+    private readonly platform;
+    constructor(platform: IPlatformProbe);
+    execute(defaults: HubPorts): Promise<ResolveHubPortsResult>;
+    private findFreePort;
+}
+export declare function labelForPortKey(key: HubPortKey): string;
+//# sourceMappingURL=resolve-hub-ports.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-hub-ports.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/resolve-hub-ports.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,oCAAoC,CAAC;AAEpF,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC;AAExC,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,SAAS,aAAa,EAAE,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;CACrC;AAaD;;;;;;;;;;;GAWG;AACH,qBAAa,sBAAsB;IACrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,cAAc;IAE/C,OAAO,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,qBAAqB,CAAC;YAkCnD,YAAY;CAY3B;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAEvD"}

package/dist/use-cases/init/resolve-hub-ports.js

@@ -0,0 +1,77 @@
+const MAX_FALLBACK_SCAN = 20;
+const SERVICE_LABEL = {
+    pg: 'Postgres',
+    pgweb: 'pgweb',
+    neo4jHttp: 'Neo4j HTTP',
+    neo4jBolt: 'Neo4j Bolt',
+    qdrantRest: 'Qdrant REST',
+    qdrantGrpc: 'Qdrant gRPC',
+};
+/**
+ * Pre-bootstrap port planner. For each hub service:
+ *   1. Try its default port.
+ *   2. If occupied — record the conflict and scan forward up to
+ *      `MAX_FALLBACK_SCAN` ports for a free one. The suggested
+ *      number is the first free port found.
+ *   3. Skip ports that are already chosen earlier in the plan so two
+ *      services never collide on the same suggestion.
+ *
+ * Caller (init flow) then prompts the user per conflict: accept
+ * suggestion, enter custom, or abort.
+ */
+export class ResolveHubPortsUseCase {
+    platform;
+    constructor(platform) {
+        this.platform = platform;
+    }
+    async execute(defaults) {
+        const plan = [];
+        const used = new Set();
+        let needsConfirmation = false;
+        for (const key of Object.keys(defaults)) {
+            const defaultPort = defaults[key];
+            const status = await this.platform.checkPort(defaultPort);
+            if (status.free && !used.has(defaultPort)) {
+                plan.push({ key, default: defaultPort, current: defaultPort, conflict: null, suggested: null });
+                used.add(defaultPort);
+                continue;
+            }
+            const conflict = status.free
+                ? null
+                : status;
+            const suggested = await this.findFreePort(defaultPort + 1, used);
+            plan.push({
+                key,
+                default: defaultPort,
+                current: suggested ?? defaultPort,
+                conflict,
+                suggested,
+            });
+            if (suggested !== null) {
+                used.add(suggested);
+            }
+            needsConfirmation = true;
+        }
+        return { plan, needsConfirmation };
+    }
+    async findFreePort(start, alreadyChosen) {
+        for (let i = 0; i < MAX_FALLBACK_SCAN; i++) {
+            const candidate = start + i;
+            if (candidate > 65535) {
+                return null;
+            }
+            if (alreadyChosen.has(candidate)) {
+                continue;
+            }
+            const status = await this.platform.checkPort(candidate);
+            if (status.free) {
+                return candidate;
+            }
+        }
+        return null;
+    }
+}
+export function labelForPortKey(key) {
+    return SERVICE_LABEL[key];
+}
+//# sourceMappingURL=resolve-hub-ports.js.map

package/dist/use-cases/init/resolve-hub-ports.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-hub-ports.js","sourceRoot":"","sources":["../../../src/use-cases/init/resolve-hub-ports.ts"],"names":[],"mappings":"AA+BA,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,MAAM,aAAa,GAA+B;IAChD,EAAE,EAAE,UAAU;IACd,KAAK,EAAE,OAAO;IACd,SAAS,EAAE,YAAY;IACvB,SAAS,EAAE,YAAY;IACvB,UAAU,EAAE,aAAa;IACzB,UAAU,EAAE,aAAa;CAC1B,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,sBAAsB;IACJ;IAA7B,YAA6B,QAAwB;QAAxB,aAAQ,GAAR,QAAQ,CAAgB;IAAG,CAAC;IAEzD,KAAK,CAAC,OAAO,CAAC,QAAkB;QAC9B,MAAM,IAAI,GAAoB,EAAE,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;QAC/B,IAAI,iBAAiB,GAAG,KAAK,CAAC;QAE9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAiB,EAAE,CAAC;YACxD,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAC1D,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1C,IAAI,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBAChG,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBACtB,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAqB,MAAM,CAAC,IAAI;gBAC5C,CAAC,CAAC,IAAI;gBACN,CAAC,CAAC,MAAM,CAAC;YACX,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;YACjE,IAAI,CAAC,IAAI,CAAC;gBACR,GAAG;gBACH,OAAO,EAAE,WAAW;gBACpB,OAAO,EAAE,SAAS,IAAI,WAAW;gBACjC,QAAQ;gBACR,SAAS;aACV,CAAC,CAAC;YACH,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;gBACvB,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACtB,CAAC;YACD,iBAAiB,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,YAAY,CAAC,KAAa,EAAE,aAA0B;QAClE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,iBAAiB,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,MAAM,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;YAC5B,IAAI,SAAS,GAAG,KAAK,EAAE,CAAC;gBAAC,OAAO,IAAI,CAAC;YAAC,CAAC;YACvC,IAAI,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBAAC,SAAS;YAAC,CAAC;YAC/C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACxD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;gBAChB,OAAO,SAAS,CAAC;YACnB,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAED,MAAM,UAAU,eAAe,CAAC,GAAe;IAC7C,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC"}

package/dist/use-cases/init/validate-workspace-name.d.ts

@@ -0,0 +1,26 @@
+import type { IWorkspaceStore } from '../../core/ports/workspace-store.js';
+export type WorkspaceNameAction = 'create' | 'switch';
+export type ValidateWorkspaceNameResult = {
+    ok: true;
+    action: WorkspaceNameAction;
+    id: string;
+    name: string;
+} | {
+    ok: false;
+    reason: 'empty' | 'invalid-slug';
+};
+/**
+ * Validate user-supplied workspace name and decide whether it should be
+ * created fresh or used to switch to an existing entry.
+ *
+ * - Empty / invalid slug → `{ ok: false, reason }` — caller re-prompts.
+ * - Valid slug + new → `{ action: 'create' }` — caller calls store.create.
+ * - Valid slug + already in DB → `{ action: 'switch' }` — caller just
+ *   marks it active without writing the row.
+ */
+export declare class ValidateWorkspaceNameUseCase {
+    private readonly hubStore;
+    constructor(hubStore: IWorkspaceStore);
+    execute(rawName: string): Promise<ValidateWorkspaceNameResult>;
+}
+//# sourceMappingURL=validate-workspace-name.d.ts.map

package/dist/use-cases/init/validate-workspace-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-workspace-name.d.ts","sourceRoot":"","sources":["../../../src/use-cases/init/validate-workspace-name.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEtD,MAAM,MAAM,2BAA2B,GACnC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACnE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,OAAO,GAAG,cAAc,CAAA;CAAE,CAAC;AAIpD;;;;;;;;GAQG;AACH,qBAAa,4BAA4B;IAC3B,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAAR,QAAQ,EAAE,eAAe;IAEhD,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,CAAC;CAerE"}

package/dist/use-cases/init/validate-workspace-name.js

@@ -0,0 +1,39 @@
+const SLUG_RE = /^[a-z0-9][a-z0-9-]{0,63}$/;
+/**
+ * Validate user-supplied workspace name and decide whether it should be
+ * created fresh or used to switch to an existing entry.
+ *
+ * - Empty / invalid slug → `{ ok: false, reason }` — caller re-prompts.
+ * - Valid slug + new → `{ action: 'create' }` — caller calls store.create.
+ * - Valid slug + already in DB → `{ action: 'switch' }` — caller just
+ *   marks it active without writing the row.
+ */
+export class ValidateWorkspaceNameUseCase {
+    hubStore;
+    constructor(hubStore) {
+        this.hubStore = hubStore;
+    }
+    async execute(rawName) {
+        const trimmed = rawName.trim();
+        if (trimmed.length === 0) {
+            return { ok: false, reason: 'empty' };
+        }
+        const slug = slugify(trimmed);
+        if (!SLUG_RE.test(slug)) {
+            return { ok: false, reason: 'invalid-slug' };
+        }
+        const existing = (await this.hubStore.getById(slug)) ?? (await this.hubStore.getByName(slug));
+        if (existing !== null) {
+            return { ok: true, action: 'switch', id: existing.id, name: existing.name };
+        }
+        return { ok: true, action: 'create', id: slug, name: slug };
+    }
+}
+function slugify(raw) {
+    return raw
+        .toLowerCase()
+        .replace(/[^a-z0-9-]/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+}
+//# sourceMappingURL=validate-workspace-name.js.map

package/dist/use-cases/init/validate-workspace-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-workspace-name.js","sourceRoot":"","sources":["../../../src/use-cases/init/validate-workspace-name.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,GAAG,2BAA2B,CAAC;AAE5C;;;;;;;;GAQG;AACH,MAAM,OAAO,4BAA4B;IACV;IAA7B,YAA6B,QAAyB;QAAzB,aAAQ,GAAR,QAAQ,CAAiB;IAAG,CAAC;IAE1D,KAAK,CAAC,OAAO,CAAC,OAAe;QAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QAC9B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;QAC/C,CAAC;QACD,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;QAC9F,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC9E,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9D,CAAC;CACF;AAED,SAAS,OAAO,CAAC,GAAW;IAC1B,OAAO,GAAG;SACP,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;AAC3B,CAAC"}