argustack 0.1.34 → 0.3.1

package/dist/mcp/helpers.d.ts

@@ -1,41 +1,153 @@
-import { getEnabledSources } from '../workspace/config.js';
-import type { WorkspaceConfig, SourceType } from '../core/types/index.js';
 import type { ISourceProvider } from '../core/ports/source-provider.js';
 import type { IStorage } from '../core/ports/storage.js';
+import type { ICodeGraph } from '../core/ports/code-graph.js';
+import type { ICodeVectorStore } from '../core/ports/code-vector-store.js';
+import type { ICodeParser } from '../core/ports/code-parser.js';
+import type { ICodeEmbedding } from '../core/ports/code-embedding.js';
+import type { ICodeMetaStore } from '../core/ports/code-meta.js';
+import type { IChatLlm } from '../core/ports/chat-llm.js';
+import type { IWorkspaceStore } from '../core/ports/workspace-store.js';
+import type { Workspace, WorkspaceConfig } from '../core/types/index.js';
 import type { ToolResponse } from './types.js';
+export interface WorkspaceContext {
+    readonly workspaceId: string;
+    readonly workspace: Workspace;
+    readonly config: WorkspaceConfig;
+}
 export type WorkspaceResult = {
     ok: true;
-    root: string;
+    workspaceId: string;
+    workspace: Workspace;
     config: WorkspaceConfig;
 } | {
     ok: false;
     reason: string;
 };
-export interface WorkspaceListItem {
-    name: string;
-    path: string;
-    sources: SourceType[];
-    active: boolean;
+interface CachedCodeAdapters {
+    graph: ICodeGraph;
+    vec: ICodeVectorStore;
+    parser: ICodeParser;
+    embedding: ICodeEmbedding;
+    meta: ICodeMetaStore;
+    storage: IStorage & ICodeMetaStore;
+    chatLlm: IChatLlm | null;
+    projectRoot: string;
 }
-export declare function loadWorkspace(): WorkspaceResult;
+export type CodeAdapters = Omit<CachedCodeAdapters, 'projectRoot'>;
+export declare function setActiveStorage(storage: IStorage): void;
+export declare function getActiveStorage(): IStorage | null;
+export declare function setActiveWorkspaceStore(store: IWorkspaceStore): void;
+export declare function getWorkspaceStore(): Promise<IWorkspaceStore>;
 /**
- * Switch to a different workspace by name.
- * Closes current storage connection, updates env, reloads .env.
+ * Resolve the workspace for a tool invocation.
+ *
+ * Resolution order (mirrors {@link import('../workspace/resolver').requireWorkspaceId}):
+ *   1. `explicit` (the tool's `workspace_id` schema field).
+ *   2. `ARGUSTACK_WORKSPACE_ID` env var.
+ *   3. `~/.argustack/active-workspace.json#activeWorkspaceId`.
+ *   4. Auto-pick when exactly one workspace exists in the hub.
+ *
+ * Returns a structured result so MCP tools can render a tool-friendly
+ * error response instead of throwing.
  */
-export declare function switchWorkspace(name: string): Promise<WorkspaceResult>;
+export declare function loadWorkspace(explicit?: string): Promise<WorkspaceResult>;
 /**
- * Scan parent directory for sibling workspaces.
+ * Switch the active workspace. Writes the hub `active-workspace.json`,
+ * touches `last_active_at`, and resets cached connections so subsequent
+ * tool calls reconnect with whatever per-workspace settings apply.
  */
-export declare function listSiblingWorkspaces(): WorkspaceListItem[];
-export declare function setActiveStorage(storage: IStorage): void;
-export declare function getActiveStorage(): IStorage | null;
-export declare function createAdapters(workspaceRoot: string): Promise<{
+export declare function switchWorkspace(name: string): Promise<WorkspaceResult>;
+export interface ResolvedAdapters {
     source: ISourceProvider | null;
     storage: IStorage;
-}>;
+    workspaceId: string;
+}
+/**
+ * Build the per-tool adapter set. The hub Postgres pool is reused
+ * across invocations via {@link activeStorage}; the source provider
+ * (Jira/proxy) is recreated each call since per-workspace project
+ * filters can change.
+ */
+export declare function createAdapters(workspaceId: string): Promise<ResolvedAdapters>;
+export declare function setActiveCodeAdapters(adapters: CodeAdapters | null): void;
+export declare function getActiveCodeAdapters(): CodeAdapters | null;
+/**
+ * Build adapters used by code-intelligence MCP tools for a specific
+ * workspace. Returns `null` if the hub config is missing the bits
+ * required by the chosen embedding provider.
+ */
+export declare function createCodeAdapters(workspaceId: string): Promise<CodeAdapters | null>;
+/**
+ * Annotation presets reused across MCP tool registrations.
+ * Mirrors the `ToolAnnotations` shape from @modelcontextprotocol/sdk.
+ *
+ * - READ_ONLY    — pure query, no side effects, safe to retry.
+ * - LOCAL_WRITE  — mutates hub-local state (board.md / Postgres rows),
+ *                  no remote calls (e.g. create_issue with source='local').
+ * - REMOTE_WRITE — pushes to or pulls from external systems (Jira, GitHub).
+ *                  destructiveHint flips on so clients can warn the user
+ *                  before invocation.
+ */
+export declare const ANNOTATIONS: {
+    readonly READ_ONLY: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+        readonly openWorldHint: false;
+    };
+    readonly REMOTE_READ: {
+        readonly readOnlyHint: true;
+        readonly idempotentHint: true;
+        readonly openWorldHint: true;
+    };
+    readonly LOCAL_WRITE: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: false;
+        readonly idempotentHint: false;
+        readonly openWorldHint: false;
+    };
+    readonly REMOTE_WRITE: {
+        readonly readOnlyHint: false;
+        readonly destructiveHint: true;
+        readonly idempotentHint: false;
+        readonly openWorldHint: true;
+    };
+};
 export declare function textResponse(text: string): ToolResponse;
 export declare function errorResponse(text: string): ToolResponse;
+/**
+ * Standard "workspace not found" error response for MCP tools.
+ *
+ * Wraps the technical {@link WorkspaceResult.reason} in a UX-friendly
+ * message that always contains the marker "Workspace not found" so
+ * clients and tests can detect it regardless of which underlying
+ * resolution step failed (no `.argustack/`, missing env var, unknown
+ * id, etc.).
+ */
+export declare function workspaceNotFoundResponse(reason: string): ToolResponse;
 export declare function getErrorMessage(err: unknown): string;
+/**
+ * High-level helper: resolve workspace, build adapters, run callback.
+ * Centralises the boilerplate for MCP tools that just need a scoped
+ * `storage` and `workspaceId`.
+ */
+export declare function withWorkspace<T>(explicit: string | undefined, fn: (ctx: {
+    storage: IStorage;
+    workspaceId: string;
+    workspace: Workspace;
+    config: WorkspaceConfig;
+}) => Promise<T>): Promise<T | ToolResponse>;
 export declare function str(value: unknown): string;
-export { getEnabledSources };
+/**
+ * Render `value` via {@link str}, but substitute `fallback` when the
+ * result is the empty string. Replaces the deprecated `str(x) || 'N/A'`
+ * pattern in a way that satisfies @typescript-eslint/strict-boolean-expressions.
+ */
+export declare function strOr(value: unknown, fallback: string): string;
+/**
+ * Render a possibly-null/undefined string with a fallback.
+ */
+export declare function nullableStr(value: string | null | undefined, fallback: string): string;
+/** True when `value` is a non-empty string. */
+export declare function hasText(value: string | null | undefined): value is string;
+export {};
 //# sourceMappingURL=helpers.d.ts.map

package/dist/mcp/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/mcp/helpers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAc,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEvE,OAAO,KAAK,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,eAAe,GACvB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,eAAe,CAAA;CAAE,GACnD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAID,wBAAgB,aAAa,IAAI,eAAe,CA+B/C;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAmD5E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,iBAAiB,EAAE,CA0D3D;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,QAAQ,GAAG,IAAI,CAExD;AAED,wBAAgB,gBAAgB,IAAI,QAAQ,GAAG,IAAI,CAElD;AAED,wBAAsB,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IACnE,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC,CAkCD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAEvD;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAExD;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAKpD;AAED,wBAAgB,GAAG,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAc1C;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/mcp/helpers.ts"],"names":[],"mappings":"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"}

package/dist/mcp/helpers.js

@@ -1,187 +1,299 @@
-import dotenv from 'dotenv';
-import { readdirSync, existsSync, statSync } from 'node:fs';
-import { join, dirname, basename } from 'node:path';
-import { findWorkspaceRoot } from '../workspace/resolver.js';
-import { readConfig, getEnabledSources } from '../workspace/config.js';
-import { listRegisteredWorkspaces } from '../workspace/registry.js';
+import { loadHubConfig } from '../workspace/hub-config.js';
+import { getActiveWorkspace, setActiveWorkspace, clearActiveWorkspace, } from '../workspace/active-workspace.js';
+import { readWorkspaceConfigFromHub } from '../workspace/config.js';
 let activeStorage = null;
-export function loadWorkspace() {
-    const envVar = process.env['ARGUSTACK_WORKSPACE'];
-    const root = findWorkspaceRoot();
-    if (!root) {
-        if (envVar) {
-            return {
-                ok: false,
-                reason: `ARGUSTACK_WORKSPACE is set to "${envVar}" but no .argustack/ marker found there or in parent directories.`,
-            };
-        }
-        const registered = listRegisteredWorkspaces();
-        if (registered.length > 0) {
-            const names = registered.map((w) => w.name).join(', ');
-            return {
-                ok: false,
-                reason: `Workspace not found from current directory. Available workspaces: ${names}. Use switch_workspace("name") to connect.`,
-            };
-        }
-        return { ok: false, reason: 'No workspaces found. Run "argustack init" to create one.' };
-    }
-    const config = readConfig(root);
-    if (!config) {
-        return {
-            ok: false,
-            reason: `Workspace found at ${root} but .argustack/config.json is missing or invalid. Run "argustack init".`,
-        };
+let activeWorkspaceStore = null;
+let activeCodeAdapters = null;
+export function setActiveStorage(storage) {
+    activeStorage = storage;
+}
+export function getActiveStorage() {
+    return activeStorage;
+}
+export function setActiveWorkspaceStore(store) {
+    activeWorkspaceStore = store;
+}
+export async function getWorkspaceStore() {
+    if (activeWorkspaceStore !== null) {
+        return activeWorkspaceStore;
     }
-    return { ok: true, root, config };
+    const { db } = loadHubConfig();
+    const { PostgresWorkspaceStore, createPool } = await import('../adapters/postgres/index.js');
+    const store = new PostgresWorkspaceStore(createPool(db));
+    activeWorkspaceStore = store;
+    return store;
 }
 /**
- * Switch to a different workspace by name.
- * Closes current storage connection, updates env, reloads .env.
+ * Resolve the workspace for a tool invocation.
+ *
+ * Resolution order (mirrors {@link import('../workspace/resolver').requireWorkspaceId}):
+ *   1. `explicit` (the tool's `workspace_id` schema field).
+ *   2. `ARGUSTACK_WORKSPACE_ID` env var.
+ *   3. `~/.argustack/active-workspace.json#activeWorkspaceId`.
+ *   4. Auto-pick when exactly one workspace exists in the hub.
+ *
+ * Returns a structured result so MCP tools can render a tool-friendly
+ * error response instead of throwing.
  */
-export async function switchWorkspace(name) {
-    const currentRoot = process.env['ARGUSTACK_WORKSPACE'];
-    let targetDir = null;
-    if (currentRoot) {
-        const parentDir = dirname(currentRoot);
-        const siblingDir = join(parentDir, name);
-        if (existsSync(join(siblingDir, '.argustack'))) {
-            targetDir = siblingDir;
+export async function loadWorkspace(explicit) {
+    let store;
+    try {
+        store = await getWorkspaceStore();
+    }
+    catch (err) {
+        return { ok: false, reason: getErrorMessage(err) };
+    }
+    const explicitId = explicit?.trim();
+    if (explicitId !== undefined && explicitId.length > 0) {
+        const workspace = (await store.getById(explicitId)) ?? (await store.getByName(explicitId));
+        if (workspace === null) {
+            return { ok: false, reason: `Workspace "${explicitId}" not found in hub.` };
         }
+        return buildResult(workspace, store);
     }
-    if (!targetDir) {
-        const registered = listRegisteredWorkspaces(currentRoot ?? undefined);
-        const match = registered.find((w) => w.name === name || basename(w.path) === name);
-        if (match) {
-            targetDir = match.path;
+    const envId = process.env['ARGUSTACK_WORKSPACE_ID']?.trim();
+    if (envId !== undefined && envId.length > 0) {
+        const workspace = await store.getById(envId);
+        if (workspace === null) {
+            return { ok: false, reason: `ARGUSTACK_WORKSPACE_ID="${envId}" not found in hub.` };
         }
+        return buildResult(workspace, store);
     }
-    if (!targetDir) {
-        const available = listSiblingWorkspaces();
-        const names = available.map((w) => w.name).join(', ');
+    const active = getActiveWorkspace();
+    if (active !== null) {
+        const workspace = await store.getById(active.activeWorkspaceId);
+        if (workspace !== null) {
+            return buildResult(workspace, store);
+        }
+        clearActiveWorkspace();
+    }
+    const all = await store.list();
+    if (all.length === 1) {
+        const only = all[0];
+        if (only !== undefined) {
+            return buildResult(only, store);
+        }
+    }
+    if (all.length === 0) {
         return {
             ok: false,
-            reason: `Workspace '${name}' not found. Available: ${names || 'none'}`,
+            reason: 'No workspaces registered. Run "argustack workspace add <name>" to create one.',
         };
     }
-    if (activeStorage) {
+    const names = all.map((w) => w.name).join(', ');
+    return {
+        ok: false,
+        reason: `No active workspace. Pass workspace_id, or call switch_workspace. Available: ${names}.`,
+    };
+}
+async function buildResult(workspace, store) {
+    const config = await readWorkspaceConfigFromHub(workspace.id, store);
+    if (config === null) {
+        return { ok: false, reason: `Workspace "${workspace.id}" was not found after lookup.` };
+    }
+    return { ok: true, workspaceId: workspace.id, workspace, config };
+}
+/**
+ * Switch the active workspace. Writes the hub `active-workspace.json`,
+ * touches `last_active_at`, and resets cached connections so subsequent
+ * tool calls reconnect with whatever per-workspace settings apply.
+ */
+export async function switchWorkspace(name) {
+    const store = await getWorkspaceStore();
+    const workspace = (await store.getById(name)) ?? (await store.getByName(name));
+    if (workspace === null) {
+        const all = await store.list();
+        const joined = all.map((w) => w.name).join(', ');
+        const known = joined.length > 0 ? joined : 'none';
+        return { ok: false, reason: `Workspace "${name}" not found. Available: ${known}` };
+    }
+    setActiveWorkspace(workspace.id, workspace.name);
+    await store.touchActive(workspace.id);
+    if (activeStorage !== null) {
         try {
             await activeStorage.close();
         }
-        catch { /* ignore close errors */ }
+        catch { /* ignore */ }
         activeStorage = null;
     }
-    process.env['ARGUSTACK_WORKSPACE'] = targetDir;
-    const keysToRemove = Object.keys(process.env).filter((key) => key.startsWith('JIRA_') || key.startsWith('GIT_') || key.startsWith('GITHUB_') ||
-        key.startsWith('DB_') || key.startsWith('TARGET_DB_') || key.startsWith('CSV_') ||
-        key === 'OPENAI_API_KEY');
-    for (const key of keysToRemove) {
-        Reflect.deleteProperty(process.env, key);
+    if (activeCodeAdapters !== null) {
+        try {
+            await activeCodeAdapters.storage.close();
+        }
+        catch { /* ignore */ }
+        activeCodeAdapters = null;
     }
-    dotenv.config({ path: join(targetDir, '.env'), override: true });
-    return loadWorkspace();
+    return buildResult(workspace, store);
 }
 /**
- * Scan parent directory for sibling workspaces.
+ * Build the per-tool adapter set. The hub Postgres pool is reused
+ * across invocations via {@link activeStorage}; the source provider
+ * (Jira/proxy) is recreated each call since per-workspace project
+ * filters can change.
  */
-export function listSiblingWorkspaces() {
-    const currentRoot = process.env['ARGUSTACK_WORKSPACE'];
-    if (!currentRoot) {
-        return [];
-    }
-    const parentDir = dirname(currentRoot);
-    const currentName = basename(currentRoot);
-    let entries;
-    try {
-        entries = readdirSync(parentDir);
+export async function createAdapters(workspaceId) {
+    const hub = loadHubConfig();
+    const store = await getWorkspaceStore();
+    const workspace = await store.getById(workspaceId);
+    if (workspace === null) {
+        throw new Error(`Workspace "${workspaceId}" not found in hub.`);
     }
-    catch {
-        return [];
+    if (activeStorage === null) {
+        const { PostgresStorage } = await import('../adapters/postgres/index.js');
+        activeStorage = new PostgresStorage(hub.db);
     }
-    const workspaces = [];
-    for (const name of entries) {
-        if (name.startsWith('.')) {
-            continue;
-        }
-        const subdir = join(parentDir, name);
-        try {
-            if (!statSync(subdir).isDirectory()) {
-                continue;
-            }
-        }
-        catch {
-            continue;
-        }
-        if (!existsSync(join(subdir, '.argustack'))) {
-            continue;
-        }
-        const config = readConfig(subdir);
-        if (!config) {
-            continue;
-        }
-        workspaces.push({
-            name: config.name ?? name,
-            path: subdir,
-            sources: getEnabledSources(config),
-            active: name === currentName,
-        });
+    const issueTypeIds = undefined;
+    let source = null;
+    const { proxyConfigExistsForWorkspace, loadProxyConfigForWorkspace, ProxyJiraProvider } = await import('../adapters/jira-proxy/index.js');
+    if (proxyConfigExistsForWorkspace(workspace.id)) {
+        const proxyConfig = loadProxyConfigForWorkspace(workspace.id);
+        source = new ProxyJiraProvider(proxyConfig, issueTypeIds);
     }
-    const registered = listRegisteredWorkspaces(currentRoot);
-    for (const rw of registered) {
-        const alreadyListed = workspaces.some((w) => w.path === rw.path);
-        if (!alreadyListed) {
-            workspaces.push(rw);
-        }
+    else if (hasText(hub.credentials.jiraUrl)
+        && hasText(hub.credentials.jiraEmail)
+        && hasText(hub.credentials.jiraApiToken)) {
+        const { JiraProvider } = await import('../adapters/jira/index.js');
+        source = new JiraProvider({
+            host: hub.credentials.jiraUrl,
+            email: hub.credentials.jiraEmail,
+            apiToken: hub.credentials.jiraApiToken,
+        }, issueTypeIds);
     }
-    return workspaces;
+    return { source, storage: activeStorage, workspaceId };
 }
-export function setActiveStorage(storage) {
-    activeStorage = storage;
+export function setActiveCodeAdapters(adapters) {
+    activeCodeAdapters = adapters !== null
+        ? { ...adapters, projectRoot: '' }
+        : null;
 }
-export function getActiveStorage() {
-    return activeStorage;
+export function getActiveCodeAdapters() {
+    return activeCodeAdapters;
 }
-export async function createAdapters(workspaceRoot) {
-    dotenv.config({ path: `${workspaceRoot}/.env`, override: true });
-    const { JIRA_URL, JIRA_EMAIL, JIRA_API_TOKEN } = process.env;
-    const { DB_HOST, DB_PORT, DB_USER, DB_PASSWORD, DB_NAME } = process.env;
-    let source = null;
-    const wsConfig = readConfig(workspaceRoot);
-    const issueTypes = wsConfig?.sources.jira?.issueTypeIds;
-    const { proxyConfigExists, loadProxyConfig, ProxyJiraProvider } = await import('../adapters/jira-proxy/index.js');
-    if (proxyConfigExists(workspaceRoot)) {
-        const proxyConfig = loadProxyConfig(workspaceRoot);
-        source = new ProxyJiraProvider(proxyConfig, issueTypes);
-    }
-    else if (JIRA_URL && JIRA_EMAIL && JIRA_API_TOKEN) {
-        const { JiraProvider } = await import('../adapters/jira/index.js');
-        source = new JiraProvider({
-            host: JIRA_URL,
-            email: JIRA_EMAIL,
-            apiToken: JIRA_API_TOKEN,
-        }, issueTypes);
+/**
+ * Build adapters used by code-intelligence MCP tools for a specific
+ * workspace. Returns `null` if the hub config is missing the bits
+ * required by the chosen embedding provider.
+ */
+export async function createCodeAdapters(workspaceId) {
+    if (activeCodeAdapters !== null) {
+        return activeCodeAdapters;
+    }
+    const hub = loadHubConfig();
+    const store = await getWorkspaceStore();
+    const workspace = await store.getById(workspaceId);
+    if (workspace === null) {
+        return null;
+    }
+    if (hub.embedding.provider === 'voyage' && !hasText(hub.embedding.voyageApiKey)) {
+        return null;
     }
     const { PostgresStorage } = await import('../adapters/postgres/index.js');
-    const storage = new PostgresStorage({
-        host: DB_HOST ?? 'localhost',
-        port: parseInt(DB_PORT ?? '5434', 10),
-        user: DB_USER ?? 'argustack',
-        password: DB_PASSWORD ?? 'argustack_local',
-        database: DB_NAME ?? 'argustack',
-    });
-    return { source, storage };
+    const { Neo4jCodeGraphStore } = await import('../adapters/neo4j/index.js');
+    const { QdrantCodeVectorStore } = await import('../adapters/qdrant/index.js');
+    const { TreeSitterParser } = await import('../adapters/tree-sitter/index.js');
+    const storage = new PostgresStorage(hub.db);
+    const graph = new Neo4jCodeGraphStore(hub.neo4j);
+    const vec = new QdrantCodeVectorStore({ url: hub.qdrant.url });
+    const projectRoot = workspace.settings?.gitRepoPaths?.[0] ?? hub.hubDir;
+    const parser = new TreeSitterParser({ projectRoot });
+    let embedding;
+    if (hub.embedding.provider === 'voyage' && hasText(hub.embedding.voyageApiKey)) {
+        const { VoyageCodeEmbeddingProvider } = await import('../adapters/voyage/index.js');
+        embedding = new VoyageCodeEmbeddingProvider({ apiKey: hub.embedding.voyageApiKey });
+    }
+    else if (hub.embedding.provider === 'ollama' || hub.embedding.provider === 'custom') {
+        const { OllamaCodeEmbeddingProvider } = await import('../adapters/ollama/index.js');
+        const url = hub.embedding.provider === 'custom'
+            ? hub.embedding.customUrl
+            : hub.embedding.ollamaUrl;
+        embedding = new OllamaCodeEmbeddingProvider({
+            model: hub.embedding.model,
+            dimensions: hub.embedding.dimensions,
+            ...(hasText(url) ? { url } : {}),
+        });
+    }
+    else {
+        const { LmStudioCodeEmbeddingProvider } = await import('../adapters/lmstudio/index.js');
+        const lmsOpts = {
+            model: hub.embedding.model,
+            dimensions: hub.embedding.dimensions,
+        };
+        if (hasText(hub.embedding.lmstudioUrl)) {
+            lmsOpts.url = hub.embedding.lmstudioUrl;
+        }
+        if (hasText(hub.embedding.rerankModel)) {
+            lmsOpts.rerankModel = hub.embedding.rerankModel;
+        }
+        embedding = new LmStudioCodeEmbeddingProvider(lmsOpts);
+    }
+    let chatLlm = null;
+    if (hub.chatLlm !== null) {
+        if (hub.chatLlm.provider === 'ollama') {
+            const { OllamaChatLlm } = await import('../adapters/ollama/index.js');
+            chatLlm = new OllamaChatLlm({
+                model: hub.chatLlm.model,
+                ...(hasText(hub.chatLlm.url) ? { url: hub.chatLlm.url } : {}),
+            });
+        }
+    }
+    activeCodeAdapters = { graph, vec, parser, embedding, meta: storage, storage, chatLlm, projectRoot };
+    return activeCodeAdapters;
 }
+/**
+ * Annotation presets reused across MCP tool registrations.
+ * Mirrors the `ToolAnnotations` shape from @modelcontextprotocol/sdk.
+ *
+ * - READ_ONLY    — pure query, no side effects, safe to retry.
+ * - LOCAL_WRITE  — mutates hub-local state (board.md / Postgres rows),
+ *                  no remote calls (e.g. create_issue with source='local').
+ * - REMOTE_WRITE — pushes to or pulls from external systems (Jira, GitHub).
+ *                  destructiveHint flips on so clients can warn the user
+ *                  before invocation.
+ */
+export const ANNOTATIONS = {
+    READ_ONLY: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    REMOTE_READ: { readOnlyHint: true, idempotentHint: true, openWorldHint: true },
+    LOCAL_WRITE: { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: false },
+    REMOTE_WRITE: { readOnlyHint: false, destructiveHint: true, idempotentHint: false, openWorldHint: true },
+};
 export function textResponse(text) {
     return { content: [{ type: 'text', text }] };
 }
 export function errorResponse(text) {
     return { content: [{ type: 'text', text }], isError: true };
 }
+/**
+ * Standard "workspace not found" error response for MCP tools.
+ *
+ * Wraps the technical {@link WorkspaceResult.reason} in a UX-friendly
+ * message that always contains the marker "Workspace not found" so
+ * clients and tests can detect it regardless of which underlying
+ * resolution step failed (no `.argustack/`, missing env var, unknown
+ * id, etc.).
+ */
+export function workspaceNotFoundResponse(reason) {
+    return errorResponse(`No Argustack workspace found (Workspace not found): ${reason}.\n` +
+        'Run `argustack init` to create one, or pass workspace_id.');
+}
 export function getErrorMessage(err) {
     if (err instanceof Error) {
         return err.message;
     }
     return String(err);
 }
+/**
+ * High-level helper: resolve workspace, build adapters, run callback.
+ * Centralises the boilerplate for MCP tools that just need a scoped
+ * `storage` and `workspaceId`.
+ */
+export async function withWorkspace(explicit, fn) {
+    const ws = await loadWorkspace(explicit);
+    if (!ws.ok) {
+        return workspaceNotFoundResponse(ws.reason);
+    }
+    const { storage } = await createAdapters(ws.workspaceId);
+    return fn({ storage, workspaceId: ws.workspaceId, workspace: ws.workspace, config: ws.config });
+}
 export function str(value) {
     if (value === null || value === undefined) {
         return '';
@@ -197,5 +309,23 @@ export function str(value) {
     }
     return JSON.stringify(value);
 }
-export { getEnabledSources };
+/**
+ * Render `value` via {@link str}, but substitute `fallback` when the
+ * result is the empty string. Replaces the deprecated `str(x) || 'N/A'`
+ * pattern in a way that satisfies @typescript-eslint/strict-boolean-expressions.
+ */
+export function strOr(value, fallback) {
+    const result = str(value);
+    return result.length > 0 ? result : fallback;
+}
+/**
+ * Render a possibly-null/undefined string with a fallback.
+ */
+export function nullableStr(value, fallback) {
+    return value !== null && value !== undefined && value.length > 0 ? value : fallback;
+}
+/** True when `value` is a non-empty string. */
+export function hasText(value) {
+    return value !== null && value !== undefined && value.length > 0;
+}
 //# sourceMappingURL=helpers.js.map