argustack 0.2.0 → 0.3.1

package/dist/workspace/hub-config.js

@@ -0,0 +1,164 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const HUB_DIR_NAME = '.argustack';
+const CONFIG_ENV_FILE = 'config.env';
+let cached = null;
+/**
+ * Resolve the hub root directory (`~/.argustack`). Honours `ARGUSTACK_HUB_DIR`
+ * env var so tests can isolate state without touching `$HOME`.
+ */
+export function hubDir() {
+    return process.env['ARGUSTACK_HUB_DIR'] ?? join(homedir(), HUB_DIR_NAME);
+}
+export function hubConfigPath() {
+    return join(hubDir(), CONFIG_ENV_FILE);
+}
+/**
+ * Load `~/.argustack/config.env` and merge with `process.env`.
+ * Cached after first call — tests that need a fresh load must call
+ * {@link resetHubConfigCache}.
+ *
+ * @throws Error when `config.env` does not exist (hub not initialised).
+ */
+export function loadHubConfig() {
+    if (cached != null) {
+        return cached;
+    }
+    const path = hubConfigPath();
+    if (!existsSync(path)) {
+        throw new Error(`Hub config not found at ${path}. Run "argustack init" to bootstrap the hub.`);
+    }
+    const env = parseEnvFile(readFileSync(path, 'utf-8'));
+    const merged = { ...env, ...process.env };
+    const rawProvider = merged['CODE_EMBEDDING_PROVIDER']?.toLowerCase();
+    const userConfigured = typeof rawProvider === 'string' && rawProvider.length > 0;
+    const provider = pickEmbeddingProvider(rawProvider);
+    const credentials = {};
+    if (merged['JIRA_URL'] !== undefined && merged['JIRA_URL'] !== '') {
+        credentials.jiraUrl = merged['JIRA_URL'];
+    }
+    if (merged['JIRA_EMAIL'] !== undefined && merged['JIRA_EMAIL'] !== '') {
+        credentials.jiraEmail = merged['JIRA_EMAIL'];
+    }
+    if (merged['JIRA_API_TOKEN'] !== undefined && merged['JIRA_API_TOKEN'] !== '') {
+        credentials.jiraApiToken = merged['JIRA_API_TOKEN'];
+    }
+    if (merged['JIRA_PROXY_TOKEN'] !== undefined && merged['JIRA_PROXY_TOKEN'] !== '') {
+        credentials.jiraProxyToken = merged['JIRA_PROXY_TOKEN'];
+    }
+    if (merged['GITHUB_TOKEN'] !== undefined && merged['GITHUB_TOKEN'] !== '') {
+        credentials.githubToken = merged['GITHUB_TOKEN'];
+    }
+    const config = {
+        hubDir: hubDir(),
+        db: {
+            host: merged['DB_HOST'] ?? 'localhost',
+            port: Number(merged['DB_PORT'] ?? '15432'),
+            user: merged['DB_USER'] ?? 'argustack',
+            password: merged['DB_PASSWORD'] ?? 'argustack_hub',
+            database: merged['DB_NAME'] ?? 'argustack_hub',
+        },
+        neo4j: {
+            uri: merged['NEO4J_URI'] ?? 'bolt://localhost:15435',
+            user: merged['NEO4J_USER'] ?? 'neo4j',
+            password: merged['NEO4J_PASSWORD'] ?? 'argustack_local',
+        },
+        qdrant: {
+            url: merged['QDRANT_URL'] ?? 'http://localhost:15436',
+        },
+        embedding: buildEmbedding(provider, userConfigured, merged),
+        chatLlm: buildChatLlm(merged),
+        credentials,
+    };
+    cached = config;
+    return config;
+}
+function pickEmbeddingProvider(rawProvider) {
+    if (rawProvider === 'voyage') {
+        return 'voyage';
+    }
+    if (rawProvider === 'lmstudio') {
+        return 'lmstudio';
+    }
+    if (rawProvider === 'custom') {
+        return 'custom';
+    }
+    return 'ollama';
+}
+function buildChatLlm(env) {
+    const model = env['CHAT_LLM_MODEL'];
+    if (model === undefined || model.length === 0) {
+        return null;
+    }
+    const rawProvider = env['CHAT_LLM_PROVIDER']?.toLowerCase();
+    const provider = rawProvider === 'lmstudio' || rawProvider === 'custom' ? rawProvider : 'ollama';
+    const url = env['CHAT_LLM_URL'];
+    return {
+        provider,
+        model,
+        ...(url !== undefined && url.length > 0 ? { url } : {}),
+    };
+}
+function buildEmbedding(provider, userConfigured, env) {
+    const defaults = {
+        ollama: { model: 'nomic-embed-text', dims: 768 },
+        lmstudio: { model: 'text-embedding-qwen3-embedding-4b', dims: 1024 },
+        voyage: { model: 'voyage-code-3', dims: 1024 },
+        custom: { model: 'unknown', dims: 768 },
+    };
+    const d = defaults[provider];
+    const config = {
+        provider,
+        userConfigured,
+        model: env['EMBEDDING_MODEL'] ?? d.model,
+        dimensions: Number(env['EMBEDDING_DIMS'] ?? String(d.dims)),
+    };
+    if (env['LMSTUDIO_URL'] !== undefined && env['LMSTUDIO_URL'] !== '') {
+        config.lmstudioUrl = env['LMSTUDIO_URL'];
+    }
+    if (env['OLLAMA_URL'] !== undefined && env['OLLAMA_URL'] !== '') {
+        config.ollamaUrl = env['OLLAMA_URL'];
+    }
+    if (env['CUSTOM_EMBEDDING_URL'] !== undefined && env['CUSTOM_EMBEDDING_URL'] !== '') {
+        config.customUrl = env['CUSTOM_EMBEDDING_URL'];
+    }
+    if (env['RERANK_MODEL'] !== undefined && env['RERANK_MODEL'] !== '') {
+        config.rerankModel = env['RERANK_MODEL'];
+    }
+    if (env['VOYAGE_API_KEY'] !== undefined && env['VOYAGE_API_KEY'] !== '') {
+        config.voyageApiKey = env['VOYAGE_API_KEY'];
+    }
+    if (env['OPENAI_API_KEY'] !== undefined && env['OPENAI_API_KEY'] !== '') {
+        config.openaiApiKey = env['OPENAI_API_KEY'];
+    }
+    return config;
+}
+/**
+ * Reset the cached hub config — for tests that mutate `~/.argustack/config.env`
+ * or `ARGUSTACK_HUB_DIR` between cases.
+ */
+export function resetHubConfigCache() {
+    cached = null;
+}
+function parseEnvFile(content) {
+    const out = {};
+    for (const rawLine of content.split('\n')) {
+        const line = rawLine.trim();
+        if (line === '' || line.startsWith('#')) {
+            continue;
+        }
+        const eq = line.indexOf('=');
+        if (eq === -1) {
+            continue;
+        }
+        const key = line.slice(0, eq).trim();
+        let value = line.slice(eq + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        out[key] = value;
+    }
+    return out;
+}
+//# sourceMappingURL=hub-config.js.map

package/dist/workspace/hub-config.js.map

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

package/dist/workspace/registry.d.ts

@@ -1,11 +1,31 @@
-import type { SourceType } from '../core/types/index.js';
+import type { SourceType, Workspace } from '../core/types/index.js';
+import type { IWorkspaceStore } from '../core/ports/workspace-store.js';
 export interface WorkspaceInfo {
     name: string;
     path: string;
     sources: SourceType[];
     active: boolean;
 }
+/**
+ * Append to the legacy `~/.argustack/workspaces.json` registry.
+ *
+ * Pre-hub Argustack maintained this file as the directory of per-folder
+ * workspaces; the hub model derives the canonical list from the
+ * `workspaces` table. We keep writing the legacy file during the
+ * transition so `argustack migrate-to-hub` can discover legacy roots,
+ * but it is best-effort — failures never block init/sync.
+ */
 export declare function registerWorkspace(workspacePath: string, name?: string): void;
-export declare function listRegisteredWorkspaces(activeRoot?: string): WorkspaceInfo[];
-export declare function pruneDeadWorkspaces(): void;
+/**
+ * List legacy per-folder workspaces from `~/.argustack/workspaces.json`.
+ * Used ONLY by `argustack migrate-to-hub`. Normal command flow uses
+ * {@link listWorkspacesFromHub} instead.
+ */
+export declare function listLegacyWorkspaces(): WorkspaceInfo[];
+/**
+ * Canonical workspace list — reads from the hub `workspaces` table.
+ * Use this for `argustack workspace list` and all user-facing commands.
+ */
+export declare function listWorkspacesFromHub(hubStore: IWorkspaceStore): Promise<Workspace[]>;
+export declare function pruneDeadLegacyWorkspaces(): void;
 //# sourceMappingURL=registry.d.ts.map

package/dist/workspace/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/workspace/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAgBzD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAkB5E;AAED,wBAAgB,wBAAwB,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa,EAAE,CA4B7E;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/workspace/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACpE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAaxE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,aAAa,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAkB5E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,aAAa,EAAE,CA4BtD;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAE3F;AAED,wBAAgB,yBAAyB,IAAI,IAAI,CAMhD"}

package/dist/workspace/registry.js

@@ -1,19 +1,25 @@
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
 import { join } from 'node:path';
-import { homedir } from 'node:os';
 import { readConfig, getEnabledSources } from './config.js';
-function registryDir() {
-    return join(homedir(), '.argustack');
-}
+import { hubDir } from './hub-config.js';
 function registryFile() {
-    return join(registryDir(), 'workspaces.json');
+    return join(hubDir(), 'workspaces.json');
 }
+/**
+ * Append to the legacy `~/.argustack/workspaces.json` registry.
+ *
+ * Pre-hub Argustack maintained this file as the directory of per-folder
+ * workspaces; the hub model derives the canonical list from the
+ * `workspaces` table. We keep writing the legacy file during the
+ * transition so `argustack migrate-to-hub` can discover legacy roots,
+ * but it is best-effort — failures never block init/sync.
+ */
 export function registerWorkspace(workspacePath, name) {
     try {
         const entries = readRegistry();
         const existing = entries.find((e) => e.path === workspacePath);
-        if (existing) {
-            if (name && existing.name !== name) {
+        if (existing != null) {
+            if (name !== undefined && name !== '' && existing.name !== name) {
                 existing.name = name;
                 writeRegistry(entries);
             }
@@ -27,7 +33,12 @@ export function registerWorkspace(workspacePath, name) {
         /* registry is best-effort — don't fail init/sync */
     }
 }
-export function listRegisteredWorkspaces(activeRoot) {
+/**
+ * List legacy per-folder workspaces from `~/.argustack/workspaces.json`.
+ * Used ONLY by `argustack migrate-to-hub`. Normal command flow uses
+ * {@link listWorkspacesFromHub} instead.
+ */
+export function listLegacyWorkspaces() {
     const entries = readRegistry();
     const live = [];
     const workspaces = [];
@@ -37,13 +48,13 @@ export function listRegisteredWorkspaces(activeRoot) {
         }
         live.push(entry);
         const config = readConfig(entry.path);
-        const sources = config ? getEnabledSources(config) : [];
+        const sources = config != null ? getEnabledSources(config) : [];
         const displayName = config?.name ?? entry.name;
         workspaces.push({
             name: displayName,
             path: entry.path,
             sources,
-            active: entry.path === activeRoot,
+            active: false,
         });
     }
     if (live.length !== entries.length) {
@@ -51,7 +62,14 @@ export function listRegisteredWorkspaces(activeRoot) {
     }
     return workspaces;
 }
-export function pruneDeadWorkspaces() {
+/**
+ * Canonical workspace list — reads from the hub `workspaces` table.
+ * Use this for `argustack workspace list` and all user-facing commands.
+ */
+export async function listWorkspacesFromHub(hubStore) {
+    return hubStore.list();
+}
+export function pruneDeadLegacyWorkspaces() {
     const entries = readRegistry();
     const live = entries.filter((e) => existsSync(join(e.path, '.argustack')));
     if (live.length !== entries.length) {
@@ -72,9 +90,9 @@ function readRegistry() {
     }
 }
 function writeRegistry(entries) {
-    if (!existsSync(registryDir())) {
-        mkdirSync(registryDir(), { recursive: true });
+    if (!existsSync(hubDir())) {
+        mkdirSync(hubDir(), { recursive: true });
     }
-    writeFileSync(registryFile(), JSON.stringify(entries, null, 2) + '\n');
+    writeFileSync(registryFile(), `${JSON.stringify(entries, null, 2)}\n`);
 }
 //# sourceMappingURL=registry.js.map

package/dist/workspace/registry.js.map

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

package/dist/workspace/resolver.d.ts

@@ -1,27 +1,29 @@
+import type { IWorkspaceStore } from '../core/ports/workspace-store.js';
 /**
- * Find workspace root by walking up from startDir looking for .argustack/
- * Returns the directory that contains .argustack/ (the workspace root), or null.
+ * Resolve which workspace a command should operate on.
  *
  * Resolution order:
- *   1. Explicit startDir argument
- *   2. ARGUSTACK_WORKSPACE env var (set by `argustack mcp install`)
- *   3. Walk up from process.cwd()
- */
-export declare function findWorkspaceRoot(startDir?: string): string | null;
-/**
- * Try to find a workspace from the global registry (~/.argustack/workspaces.json).
- * - If exactly one workspace registered → return it
- * - If multiple → match cwd (exact or child directory)
- * - If no match → return null
+ *   1. `explicit` argument (e.g. `--workspace <name>` flag value).
+ *   2. `ARGUSTACK_WORKSPACE_ID` env var.
+ *   3. `~/.argustack/active-workspace.json#activeWorkspaceId`.
+ *   4. Legacy `<cwd>/../.../.argustack/config.json#workspaceId` walking up.
+ *   5. If exactly one workspace exists in the hub — auto-pick it.
+ *   6. Otherwise: throw with the available list.
+ *
+ * The returned id is guaranteed to be a non-empty string and to exist in
+ * the hub `workspaces` table at the moment of resolution.
  */
-export declare function findWorkspaceFromRegistry(cwd: string): string | null;
+export declare function requireWorkspaceId(explicit: string | undefined, hubStore: IWorkspaceStore): Promise<string>;
 /**
- * Require workspace — throws user-friendly error if not found.
- * Includes available workspace names from registry in the error message.
+ * Walk up from `startDir` looking for `.argustack/config.json#workspaceId`.
+ * Pre-hub workspaces stored the id there; we keep reading it during the
+ * transition so old per-folder workflows resolve to the hub-side row.
  */
-export declare function requireWorkspace(startDir?: string): string;
+export declare function findLegacyWorkspaceId(startDir: string): string | null;
 /**
- * Check if a directory is already a workspace.
+ * Walk up from `startDir` looking for a legacy `.argustack/` directory.
+ * Used by `argustack migrate-to-hub` to find source workspaces, NOT by
+ * normal command resolution.
  */
-export declare function isWorkspace(dir: string): boolean;
+export declare function findLegacyWorkspaceRoot(startDir?: string): string | null;
 //# sourceMappingURL=resolver.d.ts.map

package/dist/workspace/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/workspace/resolver.ts"],"names":[],"mappings":"AAMA;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAmBlE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAwBpE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/workspace/resolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAWxE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,MAAM,CAAC,CAoDjB;AAuBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAuBrE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAYxE"}

package/dist/workspace/resolver.js

@@ -1,83 +1,124 @@
-import { existsSync } from 'node:fs';
+import { existsSync, readFileSync } from 'node:fs';
 import { join, dirname, resolve } from 'node:path';
-import { listRegisteredWorkspaces } from './registry.js';
+import { getActiveWorkspaceId } from './active-workspace.js';
 const WORKSPACE_MARKER = '.argustack';
+const LEGACY_CONFIG = 'config.json';
 /**
- * Find workspace root by walking up from startDir looking for .argustack/
- * Returns the directory that contains .argustack/ (the workspace root), or null.
+ * Resolve which workspace a command should operate on.
  *
  * Resolution order:
- *   1. Explicit startDir argument
- *   2. ARGUSTACK_WORKSPACE env var (set by `argustack mcp install`)
- *   3. Walk up from process.cwd()
+ *   1. `explicit` argument (e.g. `--workspace <name>` flag value).
+ *   2. `ARGUSTACK_WORKSPACE_ID` env var.
+ *   3. `~/.argustack/active-workspace.json#activeWorkspaceId`.
+ *   4. Legacy `<cwd>/../.../.argustack/config.json#workspaceId` walking up.
+ *   5. If exactly one workspace exists in the hub — auto-pick it.
+ *   6. Otherwise: throw with the available list.
+ *
+ * The returned id is guaranteed to be a non-empty string and to exist in
+ * the hub `workspaces` table at the moment of resolution.
  */
-export function findWorkspaceRoot(startDir) {
-    const envWorkspace = process.env['ARGUSTACK_WORKSPACE'];
-    const from = startDir ?? envWorkspace ?? process.cwd();
-    let dir = resolve(from);
-    while (true) {
-        const marker = join(dir, WORKSPACE_MARKER);
-        if (existsSync(marker) && existsSync(join(dir, WORKSPACE_MARKER, 'config.json'))) {
-            return dir;
+export async function requireWorkspaceId(explicit, hubStore) {
+    const fromExplicit = await resolveExplicit(explicit, hubStore);
+    if (fromExplicit !== null && fromExplicit !== '') {
+        return fromExplicit;
+    }
+    const envId = process.env['ARGUSTACK_WORKSPACE_ID'];
+    if (envId !== undefined && envId.trim().length > 0) {
+        const found = await hubStore.getById(envId.trim());
+        if (found != null) {
+            return found.id;
         }
-        const parent = dirname(dir);
-        if (parent === dir) {
-            break;
+        throw new Error(`ARGUSTACK_WORKSPACE_ID="${envId}" not found in hub. Run "argustack workspace list" to see registered workspaces.`);
+    }
+    const activeId = getActiveWorkspaceId();
+    if (activeId !== null && activeId !== '') {
+        const found = await hubStore.getById(activeId);
+        if (found != null) {
+            return found.id;
         }
-        dir = parent;
     }
-    return findWorkspaceFromRegistry(resolve(from));
+    const legacyId = findLegacyWorkspaceId(process.cwd());
+    if (legacyId !== null && legacyId !== '') {
+        const found = await hubStore.getById(legacyId);
+        if (found != null) {
+            return found.id;
+        }
+    }
+    const all = await hubStore.list();
+    if (all.length === 1) {
+        const onlyEntry = all[0];
+        if (onlyEntry != null) {
+            return onlyEntry.id;
+        }
+    }
+    if (all.length === 0) {
+        throw new Error('No workspaces registered. Run "argustack workspace add <name>" to create one.');
+    }
+    const names = all.map((w) => w.name).join(', ');
+    throw new Error(`No active workspace. Pass --workspace <name>, or run "argustack workspace use <name>". ` +
+        `Available: ${names}.`);
 }
-/**
- * Try to find a workspace from the global registry (~/.argustack/workspaces.json).
- * - If exactly one workspace registered → return it
- * - If multiple → match cwd (exact or child directory)
- * - If no match → return null
- */
-export function findWorkspaceFromRegistry(cwd) {
-    const workspaces = listRegisteredWorkspaces();
-    if (workspaces.length === 0) {
+async function resolveExplicit(explicit, hubStore) {
+    if (explicit === undefined || explicit.trim().length === 0) {
         return null;
     }
-    if (workspaces.length === 1) {
-        const first = workspaces[0];
-        return first ? first.path : null;
+    const trimmed = explicit.trim();
+    const byId = await hubStore.getById(trimmed);
+    if (byId != null) {
+        return byId.id;
     }
-    const resolvedCwd = resolve(cwd);
-    const matches = workspaces.filter((w) => {
-        const resolvedPath = resolve(w.path);
-        return resolvedCwd === resolvedPath || resolvedCwd.startsWith(resolvedPath + '/');
-    });
-    if (matches.length === 0) {
-        return null;
+    const byName = await hubStore.getByName(trimmed);
+    if (byName != null) {
+        return byName.id;
     }
-    matches.sort((a, b) => b.path.length - a.path.length);
-    const deepest = matches[0];
-    return deepest ? deepest.path : null;
+    throw new Error(`Workspace "${trimmed}" not found. Run "argustack workspace list" to see registered workspaces.`);
 }
 /**
- * Require workspace — throws user-friendly error if not found.
- * Includes available workspace names from registry in the error message.
+ * Walk up from `startDir` looking for `.argustack/config.json#workspaceId`.
+ * Pre-hub workspaces stored the id there; we keep reading it during the
+ * transition so old per-folder workflows resolve to the hub-side row.
  */
-export function requireWorkspace(startDir) {
-    const root = findWorkspaceRoot(startDir);
-    if (!root) {
-        const workspaces = listRegisteredWorkspaces();
-        if (workspaces.length > 0) {
-            const names = workspaces.map((w) => w.name).join(', ');
-            throw new Error('Not inside an Argustack workspace.\n' +
-                `Available workspaces: ${names}\n` +
-                'Use "argustack sync" from inside a workspace directory.');
+export function findLegacyWorkspaceId(startDir) {
+    let dir = resolve(startDir);
+    while (true) {
+        const cfg = join(dir, WORKSPACE_MARKER, LEGACY_CONFIG);
+        if (existsSync(cfg)) {
+            try {
+                const parsed = JSON.parse(readFileSync(cfg, 'utf-8'));
+                if (typeof parsed.workspaceId === 'string' && parsed.workspaceId.length > 0) {
+                    return parsed.workspaceId;
+                }
+                if (typeof parsed.name === 'string' && parsed.name.length > 0) {
+                    return parsed.name;
+                }
+            }
+            catch {
+                /* malformed legacy config — skip */
+            }
         }
-        throw new Error('Not inside an Argustack workspace.\n' +
-            'Run "argustack init" to create one.');
+        const parent = dirname(dir);
+        if (parent === dir) {
+            return null;
+        }
+        dir = parent;
     }
-    return root;
 }
 /**
- * Check if a directory is already a workspace.
+ * Walk up from `startDir` looking for a legacy `.argustack/` directory.
+ * Used by `argustack migrate-to-hub` to find source workspaces, NOT by
+ * normal command resolution.
  */
-export function isWorkspace(dir) {
-    return existsSync(join(resolve(dir), WORKSPACE_MARKER));
+export function findLegacyWorkspaceRoot(startDir) {
+    let dir = resolve(startDir ?? process.cwd());
+    while (true) {
+        if (existsSync(join(dir, WORKSPACE_MARKER, LEGACY_CONFIG))) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            return null;
+        }
+        dir = parent;
+    }
 }
 //# sourceMappingURL=resolver.js.map

package/dist/workspace/resolver.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argustack",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Project analysis platform — Jira + Git + DB",
   "type": "module",
   "bin": {
@@ -17,7 +17,9 @@
     "start": "node dist/cli/index.js",
     "lint": "eslint src/ tests/",
     "lint:fix": "eslint src/ tests/ --fix",
-    "typecheck": "tsc --noEmit",
+    "typecheck": "tsc -p tsconfig.test.json --noEmit",
+    "typecheck:src": "tsc --noEmit",
+    "type-check": "npm run typecheck",
     "test": "vitest run",
     "test:watch": "vitest",
     "test:coverage": "vitest run --coverage",