argustack 0.1.34 → 0.3.1

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/code.d.ts

@@ -0,0 +1,153 @@
+export type CodeLayer = 'domain' | 'application' | 'infrastructure' | 'presentation';
+export type CodeSymbolKind = 'function' | 'class' | 'method' | 'interface' | 'type' | 'enum' | 'const' | 'component';
+export type CodeLanguage = 'typescript' | 'tsx' | 'javascript' | 'jsx';
+export interface CodeProject {
+    id: string;
+    name: string;
+    root: string;
+    language: CodeLanguage;
+    layerConfig?: Record<string, CodeLayer>;
+    excludes?: string[];
+    createdAt?: string;
+    lastIndexedAt?: string;
+}
+export interface CodeFile {
+    projectId: string;
+    path: string;
+    language: CodeLanguage;
+    layer: CodeLayer | null;
+    hash: string;
+    gitSha?: string;
+    indexedAt?: string;
+}
+export interface CodeSymbol {
+    projectId: string;
+    qualifiedName: string;
+    name: string;
+    kind: CodeSymbolKind;
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    signature?: string;
+    visibility?: 'public' | 'private' | 'protected';
+    layer?: CodeLayer | null;
+}
+export interface CodeImport {
+    projectId: string;
+    fromFile: string;
+    toFile: string;
+    names: string[];
+}
+export interface CodeCallEdge {
+    projectId: string;
+    fromQn: string;
+    toQn: string;
+    count: number;
+}
+export interface CodeImplementsEdge {
+    projectId: string;
+    classQn: string;
+    interfaceQn: string;
+}
+export interface CodeExtendsEdge {
+    projectId: string;
+    childQn: string;
+    parentQn: string;
+}
+export interface CodeInjectsEdge {
+    projectId: string;
+    consumerQn: string;
+    providerQn: string;
+}
+export interface CodeChunk {
+    symbolId: string;
+    projectId: string;
+    filePath: string;
+    name: string;
+    kind: CodeSymbolKind;
+    layer: CodeLayer | null;
+    startLine: number;
+    endLine: number;
+    content: string;
+}
+export type IndexJobType = 'full' | 'incremental' | 'file';
+export type IndexJobStatus = 'running' | 'completed' | 'failed';
+export interface IndexJob {
+    id: number;
+    projectId: string;
+    type: IndexJobType;
+    status: IndexJobStatus;
+    startedAt: string;
+    completedAt?: string;
+    stats?: IndexStats;
+    error?: string;
+}
+export interface IndexStats {
+    filesIndexed: number;
+    symbolsCreated: number;
+    edgesCreated: number;
+    chunksCreated: number;
+    embeddingTokens: number;
+    durationMs: number;
+}
+export interface CodeFileHash {
+    path: string;
+    hash: string;
+    gitSha?: string;
+}
+export interface LspSymbol {
+    name: string;
+    kind: number;
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    containerName?: string;
+}
+export interface LspLocation {
+    uri: string;
+    startLine: number;
+    startChar: number;
+    endLine: number;
+    endChar: number;
+}
+export interface ParsedFile {
+    filePath: string;
+    language: CodeLanguage;
+    symbols: CodeSymbol[];
+    imports: CodeImport[];
+    rawCalls: RawCallSite[];
+}
+export interface RawCallSite {
+    fromQn: string;
+    calleeText: string;
+    line: number;
+    column: number;
+}
+export interface SemanticHit {
+    symbolId: string;
+    score: number;
+    payload: SemanticHitPayload;
+}
+export interface SemanticHitPayload {
+    projectId: string;
+    filePath: string;
+    layer: CodeLayer | null;
+    kind: CodeSymbolKind;
+    name: string;
+    startLine: number;
+    endLine: number;
+    content?: string;
+}
+export interface PlanFeatureFilesResult {
+    domain: PlannedFile[];
+    application: PlannedFile[];
+    infrastructure: PlannedFile[];
+    presentation: PlannedFile[];
+}
+export interface PlannedFile {
+    filePath: string;
+    reason: string;
+    similarTo?: string;
+    score: number;
+}
+//# sourceMappingURL=code.d.ts.map

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

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

package/dist/core/types/code.js

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

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

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

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

@@ -2,7 +2,7 @@
  * Workspace configuration — which sources are connected.
  * Stored in .argustack/config.json
  */
-export type SourceType = 'jira' | 'git' | 'github' | 'csv' | 'db' | 'board';
+export type SourceType = 'jira' | 'git' | 'github' | 'csv' | 'db' | 'board' | 'code';
 export interface SourceConfig {
     enabled: boolean;
     addedAt: string;

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,IAAI,GAAG,OAAO,CAAC;AAE5E,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IACnD,+CAA+C;IAC/C,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAgDlF,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAAU,EAAoD,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/core/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,KAAK,GAAG,IAAI,GAAG,OAAO,GAAG,MAAM,CAAC;AAErF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;IACnD,+CAA+C;IAC/C,KAAK,EAAE,UAAU,EAAE,CAAC;IACpB,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gDAAgD;AAChD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,UAAU,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAwDlF,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,UAAU,EAA4D,CAAC"}

package/dist/core/types/config.js

@@ -45,6 +45,13 @@ export const SOURCE_META = {
             'Claude can browse schema structure offline and run read-only SQL queries against the live database. ' +
             'All queries are validated — only SELECT/EXPLAIN/SHOW allowed, 30s timeout, 1000-row limit',
     },
+    code: {
+        label: 'Code Intelligence (Cursor-killer) — graph + semantic search of your TS codebase',
+        description: 'Indexes your TypeScript source into a graph (Neo4j) + vector store (Qdrant) using ' +
+            'tree-sitter + voyage-code-3 embeddings. Claude gets MCP tools to find symbols, trace call graphs, ' +
+            'detect Clean Architecture violations, and plan files for new features. ' +
+            'Requires VOYAGE_API_KEY and Docker containers (Neo4j, Qdrant) brought up by `argustack code init`.',
+    },
 };
-export const ALL_SOURCES = ['jira', 'csv', 'git', 'github', 'db', 'board'];
+export const ALL_SOURCES = ['jira', 'csv', 'git', 'github', 'db', 'board', 'code'];
 //# sourceMappingURL=config.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,gDAAgD;AAChD,MAAM,CAAC,MAAM,WAAW,GAA+D;IACrF,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM;QACb,WAAW,EACT,4GAA4G;YAC5G,0GAA0G;YAC1G,4HAA4H;KAC/H;IACD,GAAG,EAAE;QACH,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,6FAA6F;YAC7F,uGAAuG;YACvG,4DAA4D;YAC5D,iGAAiG;YACjG,wEAAwE;KAC3E;IACD,MAAM,EAAE;QACN,KAAK,EAAE,kCAAkC;QACzC,WAAW,EACT,8GAA8G;YAC9G,0EAA0E;YAC1E,8FAA8F;YAC9F,wEAAwE;KAC3E;IACD,GAAG,EAAE;QACH,KAAK,EAAE,iCAAiC;QACxC,WAAW,EACT,+DAA+D;YAC/D,wEAAwE;YACxE,qEAAqE;YACrE,uDAAuD;KAC1D;IACD,KAAK,EAAE;QACL,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,gEAAgE;YAChE,kFAAkF;YAClF,8DAA8D;KACjE;IACD,EAAE,EAAE;QACF,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,gFAAgF;YAChF,iGAAiG;YACjG,sGAAsG;YACtG,2FAA2F;KAC9F;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/core/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwBH,gDAAgD;AAChD,MAAM,CAAC,MAAM,WAAW,GAA+D;IACrF,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM;QACb,WAAW,EACT,4GAA4G;YAC5G,0GAA0G;YAC1G,4HAA4H;KAC/H;IACD,GAAG,EAAE;QACH,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,6FAA6F;YAC7F,uGAAuG;YACvG,4DAA4D;YAC5D,iGAAiG;YACjG,wEAAwE;KAC3E;IACD,MAAM,EAAE;QACN,KAAK,EAAE,kCAAkC;QACzC,WAAW,EACT,8GAA8G;YAC9G,0EAA0E;YAC1E,8FAA8F;YAC9F,wEAAwE;KAC3E;IACD,GAAG,EAAE;QACH,KAAK,EAAE,iCAAiC;QACxC,WAAW,EACT,+DAA+D;YAC/D,wEAAwE;YACxE,qEAAqE;YACrE,uDAAuD;KAC1D;IACD,KAAK,EAAE;QACL,KAAK,EAAE,0BAA0B;QACjC,WAAW,EACT,gEAAgE;YAChE,kFAAkF;YAClF,8DAA8D;KACjE;IACD,EAAE,EAAE;QACF,KAAK,EAAE,8BAA8B;QACrC,WAAW,EACT,gFAAgF;YAChF,iGAAiG;YACjG,sGAAsG;YACtG,2FAA2F;KAC9F;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,iFAAiF;QACxF,WAAW,EACT,oFAAoF;YACpF,oGAAoG;YACpG,yEAAyE;YACzE,oGAAoG;KACvG;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC"}

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

@@ -4,7 +4,10 @@ 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';
+export type { CodeLayer, CodeSymbolKind, CodeLanguage, CodeProject, CodeFile, CodeSymbol, CodeImport, CodeCallEdge, CodeImplementsEdge, CodeExtendsEdge, CodeInjectsEdge, CodeChunk, IndexJob, IndexJobType, IndexJobStatus, IndexStats, CodeFileHash, LspSymbol, LspLocation, ParsedFile, RawCallSite, SemanticHit, SemanticHitPayload, PlanFeatureFilesResult, PlannedFile, } from './code.js';
 //# sourceMappingURL=index.d.ts.map

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"}
+{"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":""}