argustack 0.2.0 → 0.3.1

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -11,6 +11,15 @@ export interface QueryResult {
  *
  * Implementations: PostgresStorage, (future) SQLiteStorage, etc.
  * Core doesn't know about PostgreSQL or any specific database.
+ *
+ * Tenant model: every data-bearing method takes `workspaceId` as its
+ * first parameter. The adapter must scope all reads and writes to
+ * that tenant — there is no implicit "current workspace" inside the
+ * storage. Callers (use cases) own workspace resolution.
+ *
+ * Admin-only methods (`rawQuery`) bypass workspace scoping and exist
+ * for `argustack workspace info` / migration tooling — never call
+ * them from a tenant-scoped use case.
  */
 export interface IStorage {
     /** Human-readable name (e.g. "PostgreSQL", "SQLite") */
@@ -18,68 +27,92 @@ export interface IStorage {
     /** Initialize storage (create tables, run migrations if needed) */
     initialize(): Promise<void>;
     /** Save a batch of issues + related data (upsert logic) */
-    saveBatch(batch: IssueBatch): Promise<void>;
+    saveBatch(workspaceId: string, batch: IssueBatch): Promise<void>;
     /** Save a batch of commits + files + issue refs (upsert logic) */
-    saveCommitBatch(batch: CommitBatch): Promise<void>;
+    saveCommitBatch(workspaceId: string, batch: CommitBatch): Promise<void>;
     /** Get the latest `updated` timestamp for a project (for incremental pull) */
-    getLastUpdated(projectKey: string): Promise<string | null>;
+    getLastUpdated(workspaceId: string, projectKey: string): Promise<string | null>;
     /** Get the latest commit date for a repository (for incremental pull) */
-    getLastCommitDate(repoPath: string): Promise<Date | null>;
+    getLastCommitDate(workspaceId: string, repoPath: string): Promise<Date | null>;
     /** Save a batch of GitHub PRs + reviews + comments + files (upsert logic) */
-    saveGitHubBatch(batch: GitHubBatch): Promise<void>;
+    saveGitHubBatch(workspaceId: string, batch: GitHubBatch): Promise<void>;
     /** Save releases (upsert logic) */
-    saveReleases(releases: Release[]): Promise<void>;
+    saveReleases(workspaceId: string, releases: Release[]): Promise<void>;
     /** Get the latest PR updated_at timestamp for a repo (for incremental pull) */
-    getLastPrUpdated(repoFullName: string): Promise<Date | null>;
+    getLastPrUpdated(workspaceId: string, repoFullName: string): Promise<Date | null>;
     /** Get issue keys that have no embedding yet (for batch embedding) */
-    getUnembeddedIssueKeys(limit: number): Promise<string[]>;
+    getUnembeddedIssueKeys(workspaceId: string, limit: number): Promise<string[]>;
     /** Save a computed embedding vector for an issue */
-    saveEmbedding(issueKey: string, vector: number[]): Promise<void>;
+    saveEmbedding(workspaceId: string, issueKey: string, vector: number[]): Promise<void>;
     /** Semantic vector similarity search — returns issue keys ordered by similarity */
-    semanticSearch(vector: number[], limit: number, threshold?: number): Promise<{
+    semanticSearch(workspaceId: string, vector: number[], limit: number, threshold?: number): Promise<{
         issueKey: string;
         similarity: number;
     }[]>;
     /**
      * Hybrid search — combines full-text (tsvector) and vector similarity (pgvector) using Reciprocal Rank Fusion.
+     * @param workspaceId - tenant scope
      * @param query - text query for full-text search
      * @param vector - embedding vector for similarity search (null = text-only mode)
      * @param limit - max results
      * @param threshold - minimum similarity score for vector results (default 0.5)
      */
-    hybridSearch(query: string, vector: number[] | null, limit: number, threshold?: number): Promise<HybridSearchResult[]>;
-    /** Execute a raw SQL query with parameterized values */
-    query(sql: string, params: unknown[]): Promise<QueryResult>;
+    hybridSearch(workspaceId: string, query: string, vector: number[] | null, limit: number, threshold?: number): Promise<HybridSearchResult[]>;
+    /**
+     * Execute a tenant-scoped SQL query.
+     *
+     * Contract:
+     *   - `workspaceId` is bound as `params[0]` by the adapter — the caller
+     *     MUST reference it in the SQL as `$1` (and shift other placeholders).
+     *   - The SQL MUST include a `workspace_id = $1` predicate against every
+     *     tenant-scoped table it touches. The adapter rejects queries that
+     *     reference a known tenant table without a `workspace_id` predicate
+     *     (defense in depth against cross-workspace data leaks from MCP
+     *     `db_query`-style tools).
+     *   - Returns the same shape as {@link rawQuery} but guarantees tenant
+     *     isolation by construction.
+     *
+     * @throws StorageError when the SQL is rejected by the workspace guard.
+     */
+    queryForWorkspace(workspaceId: string, sql: string, params: unknown[]): Promise<QueryResult>;
+    /**
+     * Admin-only: execute SQL without workspace scoping.
+     *
+     * Reserved for migration code (`argustack migrate-to-hub`),
+     * `argustack workspace info`, and the `db_stats` MCP tool.
+     * NEVER call from a tenant-scoped use case — there is no isolation.
+     */
+    rawQuery(sql: string, params: unknown[]): Promise<QueryResult>;
     /** Save external database schema metadata (upsert logic) */
-    saveDbSchemaBatch(batch: DbSchemaBatch, sourceName: string): Promise<void>;
+    saveDbSchemaBatch(workspaceId: string, batch: DbSchemaBatch, sourceName: string): Promise<void>;
     /** Delete all schema metadata for a given external database source */
-    deleteDbSchema(sourceName: string): Promise<void>;
+    deleteDbSchema(workspaceId: string, sourceName: string): Promise<void>;
     /** Get all issues with source = 'local' (created on board, not yet pushed to Jira) */
-    getLocalIssues(): Promise<Issue[]>;
+    getLocalIssues(workspaceId: string): Promise<Issue[]>;
     /** Update the source field for an issue (e.g., 'local' → 'jira' after push) */
-    updateIssueSource(issueKey: string, source: string): Promise<void>;
+    updateIssueSource(workspaceId: string, issueKey: string, source: string): Promise<void>;
     /** Update specific fields of an issue in local DB. Marks as locally_modified. */
-    updateIssueFields(issueKey: string, fields: Partial<Issue>): Promise<void>;
+    updateIssueFields(workspaceId: string, issueKey: string, fields: Partial<Issue>): Promise<void>;
     /** Get all issues that were modified locally (locally_modified = true). Returns issues with modifiedFields indicating which fields changed. */
-    getModifiedIssues(): Promise<(Issue & {
+    getModifiedIssues(workspaceId: string): Promise<(Issue & {
         modifiedFields: string[];
     })[]>;
     /** Clear the locally_modified flag after successful push to Jira */
-    clearModifiedFlag(issueKey: string): Promise<void>;
-    /** Save graph entities (UPSERT by name+type) */
-    saveGraphEntities(entities: GraphEntity[]): Promise<void>;
-    /** Save graph relationships (UPSERT by source_id+target_id+type) */
-    saveGraphRelationships(rels: GraphRelationship[]): Promise<void>;
+    clearModifiedFlag(workspaceId: string, issueKey: string): Promise<void>;
+    /** Save graph entities (UPSERT by workspace_id+name+type) */
+    saveGraphEntities(workspaceId: string, entities: GraphEntity[]): Promise<void>;
+    /** Save graph relationships (UPSERT by workspace_id+source_id+target_id+type) */
+    saveGraphRelationships(workspaceId: string, rels: GraphRelationship[]): Promise<void>;
     /** Add an observation to an entity (append-only) */
-    saveGraphObservation(entityId: number, content: string, author: string): Promise<void>;
+    saveGraphObservation(workspaceId: string, entityId: number, content: string, author: string): Promise<void>;
     /** Get all observations for an entity */
-    getObservations(entityId: number): Promise<GraphObservation[]>;
+    getObservations(workspaceId: string, entityId: number): Promise<GraphObservation[]>;
     /** Traverse graph from entity name, N levels deep */
-    queryGraph(entityName: string, depth: number): Promise<GraphQueryResult>;
+    queryGraph(workspaceId: string, entityName: string, depth: number): Promise<GraphQueryResult>;
     /** Get graph statistics */
-    getGraphStats(): Promise<GraphStats>;
+    getGraphStats(workspaceId: string): Promise<GraphStats>;
     /** Clear structural graph data (preserves claude-sourced) */
-    clearGraph(): Promise<void>;
+    clearGraph(workspaceId: string): Promise<void>;
     /** Close connection / cleanup */
     close(): Promise<void>;
 }

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

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

package/dist/core/ports/workspace-store.d.ts

@@ -0,0 +1,52 @@
+import type { Workspace, WorkspaceSettings } from '../types/workspace.js';
+/**
+ * Port: WorkspaceStore — SSOT for tenant identity in the hub model.
+ *
+ * Implementations live alongside other adapters of the same backing store
+ * (e.g. {@link PostgresWorkspaceStore}). The store owns the `workspaces`
+ * table and is the only writer of `last_active_at`.
+ *
+ * Lifecycle:
+ *   1. `initialize()` is called once at process startup (creates the
+ *      `workspaces` table if missing — idempotent).
+ *   2. All other methods operate on existing connections.
+ *   3. `close()` releases the connection pool.
+ *
+ * Errors:
+ *   - `create()` throws if `id` is empty, contains characters outside
+ *     `[a-z0-9-]`, or collides with an existing row by name when
+ *     `id` differs.
+ *   - `remove()` triggers ON DELETE CASCADE across 24 tenant tables.
+ *     Callers must clean external stores (Neo4j project node, Qdrant
+ *     collection) separately — the store does not cross adapter
+ *     boundaries.
+ */
+export interface IWorkspaceStore {
+    readonly name: string;
+    initialize(): Promise<void>;
+    /**
+     * Create a workspace row. Idempotent: re-creating an existing `id`
+     * updates the mutable fields (name, displayName, settings) and
+     * preserves `createdAt` and `lastActiveAt`.
+     */
+    create(workspace: Workspace): Promise<Workspace>;
+    getById(id: string): Promise<Workspace | null>;
+    getByName(name: string): Promise<Workspace | null>;
+    /** Returned ordered by `last_active_at DESC, created_at DESC`. */
+    list(): Promise<Workspace[]>;
+    /**
+     * Merge the patch into `settings` JSONB. Top-level keys are
+     * replaced; arrays inside `settings` are replaced, not concatenated.
+     */
+    updateSettings(id: string, patch: Partial<WorkspaceSettings>): Promise<void>;
+    /**
+     * Remove a workspace. CASCADE deletes data from all 24 tenant
+     * tables in a single transaction. Does not touch Neo4j/Qdrant —
+     * callers must clean those stores separately.
+     */
+    remove(id: string): Promise<void>;
+    /** Update `last_active_at = NOW()` for `id`. No-op if `id` is unknown. */
+    touchActive(id: string): Promise<void>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=workspace-store.d.ts.map

package/dist/core/ports/workspace-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-store.d.ts","sourceRoot":"","sources":["../../../src/core/ports/workspace-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;;;OAIG;IACH,MAAM,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAEjD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAE/C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAEnD,kEAAkE;IAClE,IAAI,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE7B;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7E;;;;OAIG;IACH,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB"}

package/dist/core/ports/workspace-store.js

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

package/dist/core/ports/workspace-store.js.map

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

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

@@ -4,6 +4,8 @@ export type { Commit, CommitFile, CommitIssueRef, CommitBatch, GitRef, } from '.
 export type { PullRequest, PullRequestReview, PullRequestComment, PullRequestFile, PullRequestIssueRef, Release, GitHubBatch, } from './github.js';
 export type { SourceType, SourceConfig, WorkspaceConfig, } from './config.js';
 export { SOURCE_META, ALL_SOURCES } from './config.js';
+export type { Workspace, WorkspaceSettings, DbSourceConfig, GitHubRepoConfig, CsvFileConfig, } from './workspace.js';
+export type { PreflightResult, LlmProvider, LlmSetupPlan, } from './init.js';
 export type { DbEngine, DbTable, DbColumn, DbForeignKey, DbIndex, DbSchemaBatch, } from './database.js';
 export type { ProxyConfig, ProxyAuth, ProxyEndpoint, ProxyEndpoints, ProxyFieldMapping, } from './proxy-config.js';
 export type { GraphEntity, GraphRelationship, GraphObservation, GraphQueryResult, GraphStats, } from './graph.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,KAAK,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,SAAS,EACT,UAAU,EACV,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,YAAY,EACV,MAAM,EACN,UAAU,EACV,cAAc,EACd,WAAW,EACX,MAAM,GACP,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,OAAO,EACP,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvD,YAAY,EACV,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,GACZ,MAAM,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,KAAK,EACL,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,SAAS,EACT,UAAU,EACV,kBAAkB,GACnB,MAAM,YAAY,CAAC;AAEpB,YAAY,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAE5C,YAAY,EACV,MAAM,EACN,UAAU,EACV,cAAc,EACd,WAAW,EACX,MAAM,GACP,MAAM,UAAU,CAAC;AAElB,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,OAAO,EACP,WAAW,GACZ,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,UAAU,EACV,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvD,YAAY,EACV,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,YAAY,EACV,eAAe,EACf,WAAW,EACX,YAAY,GACb,MAAM,WAAW,CAAC;AAEnB,YAAY,EACV,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,YAAY,EACZ,OAAO,EACP,aAAa,GACd,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,WAAW,EACX,SAAS,EACT,aAAa,EACb,cAAc,EACd,iBAAiB,GAClB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,GACX,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,UAAU,EACV,UAAU,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,SAAS,EACT,QAAQ,EACR,YAAY,EACZ,cAAc,EACd,UAAU,EACV,YAAY,EACZ,SAAS,EACT,WAAW,EACX,UAAU,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,sBAAsB,EACtB,WAAW,GACZ,MAAM,WAAW,CAAC"}

package/dist/core/types/init.d.ts

@@ -0,0 +1,29 @@
+import type { DockerVersion } from '../ports/docker-control.js';
+import type { PortStatus } from '../ports/platform-probe.js';
+/**
+ * Aggregate result of pre-bootstrap checks (versions + docker + ports + hub state).
+ *
+ * `hubExists` is true when both the compose file is present and the hub
+ * Postgres schema is reachable. `null` means the check couldn't run
+ * (e.g. docker still down).
+ */
+export interface PreflightResult {
+    readonly nodeVersion: string;
+    readonly docker: DockerVersion | null;
+    readonly dockerRunning: boolean;
+    readonly ports: readonly PortStatus[];
+    readonly hubExists: boolean | null;
+}
+/**
+ * Which LLM provider the init flow has selected and what to write to
+ * `~/.argustack/config.env`. `custom` means the user supplied their own
+ * URL + model (could be LM Studio, llama.cpp, anything OpenAI-compatible).
+ */
+export type LlmProvider = 'ollama' | 'custom';
+export interface LlmSetupPlan {
+    readonly provider: LlmProvider;
+    readonly url: string;
+    readonly model: string;
+    readonly dimensions: number;
+}
+//# sourceMappingURL=init.d.ts.map

package/dist/core/types/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/core/types/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,UAAU,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;CACpC;AAED;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B"}

package/dist/core/types/init.js

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

package/dist/core/types/init.js.map

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

package/dist/core/types/workspace.d.ts

@@ -0,0 +1,78 @@
+import type { DbEngine } from './database.js';
+/**
+ * DB source configuration stored per workspace.
+ *
+ * Stored as part of {@link WorkspaceSettings.dbConfigs} in the
+ * `workspaces.settings` JSONB column. Credentials never leave the
+ * workspace settings record — they are not written to the global
+ * `~/.argustack/config.env`.
+ */
+export interface DbSourceConfig {
+    readonly name: string;
+    readonly engine: DbEngine;
+    readonly host: string;
+    readonly port: number;
+    readonly user: string;
+    readonly password: string;
+    readonly database: string;
+    readonly schema?: string;
+    readonly ssl?: boolean;
+}
+/**
+ * GitHub repository binding stored per workspace.
+ * The personal access token lives in `~/.argustack/config.env`
+ * (single token per machine); the per-workspace setting tracks only
+ * which `owner/repo` pairs to sync.
+ */
+export interface GitHubRepoConfig {
+    readonly owner: string;
+    readonly repo: string;
+}
+/**
+ * CSV file binding stored per workspace.
+ * Path must be absolute; relative paths break when sync is invoked from
+ * an arbitrary working directory.
+ */
+export interface CsvFileConfig {
+    readonly path: string;
+}
+/**
+ * Workspace-scoped, per-source bindings.
+ *
+ * Stored in the `workspaces.settings` JSONB column. Credentials
+ * (Jira token, GitHub PAT, OpenAI/Voyage keys) are not stored here —
+ * they live in `~/.argustack/config.env` because there is exactly one
+ * value per machine.
+ *
+ * Per-workspace data lives here because it differs per workspace:
+ *  - Jira project keys (PROJ vs OTHER)
+ *  - Local git repository paths
+ *  - GitHub `owner/repo` targets
+ *  - CSV file paths
+ *  - External DB connection info
+ */
+export interface WorkspaceSettings {
+    readonly jiraProjectKeys?: readonly string[];
+    readonly gitRepoPaths?: readonly string[];
+    readonly githubRepos?: readonly GitHubRepoConfig[];
+    readonly csvFilePaths?: readonly CsvFileConfig[];
+    readonly dbConfigs?: readonly DbSourceConfig[];
+}
+/**
+ * Tenant identity in the hub-Postgres model.
+ *
+ * `id` is the slug used as the foreign key on every other table
+ * (`workspace_id TEXT REFERENCES workspaces(id) ON DELETE CASCADE`).
+ *
+ * Invariant: `workspaces.id === code_projects.id` for code-indexed
+ * workspaces — enforced by FK on `code_projects.workspace_id`.
+ */
+export interface Workspace {
+    readonly id: string;
+    readonly name: string;
+    readonly displayName?: string;
+    readonly createdAt?: string;
+    readonly lastActiveAt?: string;
+    readonly settings?: WorkspaceSettings;
+}
+//# sourceMappingURL=workspace.d.ts.map

package/dist/core/types/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/core/types/workspace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,cAAc,EAAE,CAAC;CAChD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CACvC"}

package/dist/core/types/workspace.js

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

package/dist/core/types/workspace.js.map

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