argustack 0.2.0 → 0.3.1

package/dist/cli/board.js

@@ -1,26 +1,25 @@
-import { join } from 'node:path';
+import { join, resolve } from 'node:path';
 import { existsSync } from 'node:fs';
 import chalk from 'chalk';
+import { findLegacyWorkspaceRoot } from '../workspace/resolver.js';
 export function registerBoardCommand(program) {
     program
         .command('board')
-        .description('Start local Kanban board UI')
+        .description('Start local Kanban board UI for a project directory')
         .option('-p, --port <port>', 'Port number', '5002')
+        .option('--root <path>', 'Project root containing Docs/Tasks/ (default: legacy .argustack/ walk-up, then cwd)')
         .action(async (opts) => {
-        const { findWorkspaceRoot } = await import('../workspace/resolver.js');
-        const wsRoot = findWorkspaceRoot();
-        if (!wsRoot) {
-            console.log(chalk.red('No workspace found. Run: argustack init'));
-            process.exit(1);
-        }
-        const tasksDir = join(wsRoot, 'Docs', 'Tasks');
+        const projectRoot = opts.root !== undefined && opts.root.length > 0
+            ? resolve(opts.root)
+            : (findLegacyWorkspaceRoot() ?? process.cwd());
+        const tasksDir = join(projectRoot, 'Docs', 'Tasks');
         if (!existsSync(tasksDir)) {
-            console.log(chalk.yellow(`No Docs/Tasks/ directory found in ${wsRoot}`));
-            console.log(chalk.dim('Board will start empty. Create task files to populate it.'));
+            console.log(chalk.yellow(`  No Docs/Tasks/ in ${projectRoot}`));
+            console.log(chalk.dim('  Pass --root /path/to/project to point at the right folder.'));
         }
         const port = parseInt(opts.port, 10);
         const { startBoardServer } = await import('./board-server.js');
-        await startBoardServer(wsRoot, port);
+        await startBoardServer(projectRoot, port);
     });
 }
 //# sourceMappingURL=board.js.map

package/dist/cli/board.js.map

@@ -1 +1 @@
-{"version":3,"file":"board.js","sourceRoot":"","sources":["../../src/cli/board.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,6BAA6B,CAAC;SAC1C,MAAM,CAAC,mBAAmB,EAAE,aAAa,EAAE,MAAM,CAAC;SAClD,MAAM,CAAC,KAAK,EAAE,IAAsB,EAAE,EAAE;QACvC,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;QAEnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;YAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,qCAAqC,MAAM,EAAE,CAAC,CAAC,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2DAA2D,CAAC,CAAC,CAAC;QACtF,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC/D,MAAM,gBAAgB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"board.js","sourceRoot":"","sources":["../../src/cli/board.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAOnE,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,qDAAqD,CAAC;SAClE,MAAM,CAAC,mBAAmB,EAAE,aAAa,EAAE,MAAM,CAAC;SAClD,MAAM,CAAC,eAAe,EAAE,qFAAqF,CAAC;SAC9G,MAAM,CAAC,KAAK,EAAE,IAAa,EAAE,EAAE;QAC9B,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;YACjE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;YACpB,CAAC,CAAC,CAAC,uBAAuB,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QAEjD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,uBAAuB,WAAW,EAAE,CAAC,CAAC,CAAC;YAChE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC,CAAC;QACzF,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrC,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,CAAC;QAC/D,MAAM,gBAAgB,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/code.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/cli/code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuKzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4a3D"}
+{"version":3,"file":"code.d.ts","sourceRoot":"","sources":["../../src/cli/code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoGzC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgY3D"}

package/dist/cli/code.js

@@ -1,12 +1,10 @@
-import { resolve, join, dirname } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { homedir } from 'node:os';
-import { mkdirSync, writeFileSync, existsSync, readFileSync, unlinkSync, openSync, copyFileSync } from 'node:fs';
-import { spawn, spawnSync } from 'node:child_process';
+import { resolve, join } from 'node:path';
+import { mkdirSync, writeFileSync, existsSync, readFileSync, unlinkSync, openSync } from 'node:fs';
+import { spawn } from 'node:child_process';
 import chalk from 'chalk';
 import ora from 'ora';
-import dotenv from 'dotenv';
-import { requireWorkspace } from '../workspace/resolver.js';
+import { hubDir, loadHubConfig } from '../workspace/hub-config.js';
+import { openHubStore, resolveWorkspaceFlag } from './add/shared.js';
 import { PostgresStorage } from '../adapters/postgres/index.js';
 import { Neo4jCodeGraphStore } from '../adapters/neo4j/index.js';
 import { QdrantCodeVectorStore } from '../adapters/qdrant/index.js';
@@ -14,53 +12,16 @@ import { TreeSitterParser } from '../adapters/tree-sitter/index.js';
 import { TypeScriptLspClient } from '../adapters/lsp/index.js';
 import { VoyageCodeEmbeddingProvider } from '../adapters/voyage/index.js';
 import { LmStudioCodeEmbeddingProvider } from '../adapters/lmstudio/index.js';
+import { OllamaCodeEmbeddingProvider } from '../adapters/ollama/index.js';
 import { RegisterCodeProjectUseCase } from '../use-cases/register-code-project.js';
 import { UnregisterCodeProjectUseCase } from '../use-cases/unregister-code-project.js';
 import { IndexCodeUseCase } from '../use-cases/index-code.js';
 import { WatchCodeUseCase } from '../use-cases/watch-code.js';
-const HUB_DIR = join(homedir(), '.argustack', 'code');
-const HUB_COMPOSE_FILE = join(HUB_DIR, 'docker-compose.yml');
-const WATCHERS_DIR = join(HUB_DIR, 'watchers');
-function findTemplateFile() {
-    const here = dirname(fileURLToPath(import.meta.url));
-    const candidates = [
-        join(here, '..', '..', 'templates', 'code-docker-compose.yml'),
-        join(here, '..', '..', '..', 'templates', 'code-docker-compose.yml'),
-        join(here, '..', 'templates', 'code-docker-compose.yml'),
-    ];
-    for (const path of candidates) {
-        if (existsSync(path)) {
-            return path;
-        }
-    }
-    return null;
-}
-function ensureHubCompose() {
-    if (!existsSync(HUB_DIR)) {
-        mkdirSync(HUB_DIR, { recursive: true });
-    }
-    if (existsSync(HUB_COMPOSE_FILE)) {
-        return { created: false, path: HUB_COMPOSE_FILE };
-    }
-    const template = findTemplateFile();
-    if (!template) {
-        throw new Error(`code-docker-compose.yml template not found. Expected near package root.`);
-    }
-    copyFileSync(template, HUB_COMPOSE_FILE);
-    return { created: true, path: HUB_COMPOSE_FILE };
-}
-function dockerComposeUp() {
-    const result = spawnSync('docker', ['compose', '-f', HUB_COMPOSE_FILE, 'up', '-d'], {
-        stdio: 'inherit',
-    });
-    if (result.status !== 0) {
-        throw new Error(`docker compose up exited with code ${String(result.status)}`);
-    }
-}
+const WATCHERS_DIR = () => join(hubDir(), 'watchers');
 function watcherPaths(projectId) {
     return {
-        pidFile: join(WATCHERS_DIR, `${projectId}.pid`),
-        logFile: join(WATCHERS_DIR, `${projectId}.log`),
+        pidFile: join(WATCHERS_DIR(), `${projectId}.pid`),
+        logFile: join(WATCHERS_DIR(), `${projectId}.log`),
     };
 }
 function readWatcherPid(projectId) {
@@ -69,7 +30,7 @@ function readWatcherPid(projectId) {
         return null;
     }
     const pid = parseInt(readFileSync(pidFile, 'utf8').trim(), 10);
-    if (!pid) {
+    if (Number.isNaN(pid) || pid === 0) {
         return null;
     }
     try {
@@ -84,61 +45,47 @@ function readWatcherPid(projectId) {
         return null;
     }
 }
-function loadEnv() {
-    const workspaceRoot = requireWorkspace();
-    dotenv.config({ path: `${workspaceRoot}/.env`, quiet: true });
-}
-function readDbConfig() {
-    return {
-        host: process.env['DB_HOST'] ?? 'localhost',
-        port: parseInt(process.env['DB_PORT'] ?? '5434', 10),
-        database: process.env['DB_NAME'] ?? 'argustack',
-        user: process.env['DB_USER'] ?? 'argustack',
-        password: process.env['DB_PASSWORD'] ?? 'argustack_local',
-    };
-}
-function buildAdapters() {
-    const uri = process.env['NEO4J_URI'];
-    const qdrantUrl = process.env['QDRANT_URL'];
-    if (!uri || !qdrantUrl) {
-        throw new Error('Code intelligence requires NEO4J_URI and QDRANT_URL in workspace .env');
+function getStatusColor(status) {
+    if (status === 'completed') {
+        return chalk.green;
     }
-    const provider = (process.env['CODE_EMBEDDING_PROVIDER'] ?? 'lmstudio').toLowerCase();
-    if (provider === 'voyage' && !process.env['VOYAGE_API_KEY']) {
-        throw new Error('CODE_EMBEDDING_PROVIDER=voyage requires VOYAGE_API_KEY in workspace .env');
+    if (status === 'failed') {
+        return chalk.red;
     }
-    const storage = new PostgresStorage(readDbConfig());
-    const graph = new Neo4jCodeGraphStore({
-        uri,
-        user: process.env['NEO4J_USER'] ?? 'neo4j',
-        password: process.env['NEO4J_PASSWORD'] ?? 'argustack_local',
-    });
-    const qdrantOpts = {
-        url: qdrantUrl,
-    };
-    if (process.env['QDRANT_API_KEY']) {
-        qdrantOpts.apiKey = process.env['QDRANT_API_KEY'];
+    return chalk.yellow;
+}
+function buildAdapters() {
+    const hub = loadHubConfig();
+    if (hub.embedding.provider === 'voyage' && (hub.embedding.voyageApiKey === undefined || hub.embedding.voyageApiKey === '')) {
+        throw new Error('CODE_EMBEDDING_PROVIDER=voyage requires VOYAGE_API_KEY in ~/.argustack/config.env');
     }
-    const vec = new QdrantCodeVectorStore(qdrantOpts);
+    const storage = new PostgresStorage(hub.db);
+    const graph = new Neo4jCodeGraphStore(hub.neo4j);
+    const vec = new QdrantCodeVectorStore({ url: hub.qdrant.url });
     let embedding;
-    if (provider === 'voyage') {
-        embedding = new VoyageCodeEmbeddingProvider({
-            apiKey: process.env['VOYAGE_API_KEY'] ?? '',
+    if (hub.embedding.provider === 'voyage' && hub.embedding.voyageApiKey !== undefined && hub.embedding.voyageApiKey !== '') {
+        embedding = new VoyageCodeEmbeddingProvider({ apiKey: hub.embedding.voyageApiKey });
+    }
+    else if (hub.embedding.provider === 'ollama' || hub.embedding.provider === 'custom') {
+        const url = hub.embedding.provider === 'custom'
+            ? hub.embedding.customUrl
+            : hub.embedding.ollamaUrl;
+        embedding = new OllamaCodeEmbeddingProvider({
+            model: hub.embedding.model,
+            dimensions: hub.embedding.dimensions,
+            ...(url !== undefined && url !== '' ? { url } : {}),
         });
     }
     else {
-        const lmsOpts = {};
-        if (process.env['LMSTUDIO_URL']) {
-            lmsOpts.url = process.env['LMSTUDIO_URL'];
-        }
-        if (process.env['EMBEDDING_MODEL']) {
-            lmsOpts.model = process.env['EMBEDDING_MODEL'];
-        }
-        if (process.env['EMBEDDING_DIMS']) {
-            lmsOpts.dimensions = parseInt(process.env['EMBEDDING_DIMS'], 10);
+        const lmsOpts = {
+            model: hub.embedding.model,
+            dimensions: hub.embedding.dimensions,
+        };
+        if (hub.embedding.lmstudioUrl !== undefined && hub.embedding.lmstudioUrl !== '') {
+            lmsOpts.url = hub.embedding.lmstudioUrl;
         }
-        if (process.env['RERANK_MODEL']) {
-            lmsOpts.rerankModel = process.env['RERANK_MODEL'];
+        if (hub.embedding.rerankModel !== undefined && hub.embedding.rerankModel !== '') {
+            lmsOpts.rerankModel = hub.embedding.rerankModel;
         }
         embedding = new LmStudioCodeEmbeddingProvider(lmsOpts);
     }
@@ -149,76 +96,35 @@ async function closeAdapters(adapters) {
     await adapters.vec.close();
     await adapters.storage.close();
 }
-function projectIdFromName(name) {
-    return name.toLowerCase().replace(/[^a-z0-9-]/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '');
-}
 export function registerCodeCommands(program) {
     const code = program
         .command('code')
         .description('Local code intelligence — graph + semantic search of your codebase');
     code
         .command('init')
-        .description('Generate ~/.argustack/code/docker-compose.yml, start containers, apply schemas')
-        .option('--skip-docker', 'Skip docker compose up (assumes containers already running)')
-        .action(async (options) => {
-        loadEnv();
-        const composeSpinner = ora('Preparing hub docker-compose.yml...').start();
-        try {
-            const { created, path } = ensureHubCompose();
-            composeSpinner.succeed(created
-                ? `Created ${path}`
-                : `Using existing ${path}`);
-        }
-        catch (err) {
-            composeSpinner.fail('Failed to prepare docker-compose.yml');
-            console.error(chalk.red(`  ${err instanceof Error ? err.message : String(err)}`));
-            process.exitCode = 1;
-            return;
-        }
-        if (!options.skipDocker) {
-            const dockerSpinner = ora('Starting Neo4j + Qdrant containers...').start();
-            try {
-                dockerSpinner.stop();
-                dockerComposeUp();
-                console.log(chalk.green('  Containers up'));
-            }
-            catch (err) {
-                dockerSpinner.fail('docker compose up failed');
-                console.error(chalk.red(`  ${err instanceof Error ? err.message : String(err)}`));
-                console.error(chalk.dim('  Tip: re-run with --skip-docker if containers are managed elsewhere.'));
-                process.exitCode = 1;
-                return;
-            }
-        }
-        const spinner = ora('Initializing code intelligence stores...').start();
-        const adapters = buildAdapters();
-        try {
-            await adapters.storage.initialize();
-            await adapters.graph.initialize();
-            await adapters.vec.initialize();
-            spinner.succeed('Code intelligence ready');
-        }
-        catch (err) {
-            spinner.fail('Init failed');
-            console.error(chalk.red(`  ${err instanceof Error ? err.message : String(err)}`));
-            process.exitCode = 1;
-        }
-        finally {
-            await closeAdapters(adapters);
-        }
+        .description('[deprecated] Use `argustack init` — it now bootstraps the full hub including code-intel')
+        .action(() => {
+        console.log(chalk.yellow('  `argustack code init` is deprecated.'));
+        console.log(chalk.dim('  Use `argustack init` — it bootstraps the full hub (pg + neo4j + qdrant) and offers code-intel setup.'));
     });
     code
         .command('register')
-        .description('Register a code project for indexing')
-        .requiredOption('--name <name>', 'Project name')
+        .description('Register a code project for indexing (workspaces.id === code_projects.id)')
+        .option('--workspace <name>', 'Target workspace (defaults to active)')
         .option('--root <path>', 'Project root (default: CWD)')
         .option('--language <lang>', 'Primary language (typescript|tsx|javascript|jsx)', 'typescript')
         .action(async (options) => {
-        loadEnv();
+        const { store, close: closeStore } = await openHubStore();
+        const workspaceId = await resolveWorkspaceFlag(store, options.workspace);
+        const workspace = await store.getById(workspaceId);
+        await closeStore();
+        if (workspace == null) {
+            throw new Error(`Workspace "${workspaceId}" not found.`);
+        }
         const root = resolve(options.root ?? process.cwd());
         const project = {
-            id: projectIdFromName(options.name),
-            name: options.name,
+            id: workspaceId,
+            name: workspace.name,
             root,
             language: options.language,
         };
@@ -239,15 +145,16 @@ export function registerCodeCommands(program) {
     code
         .command('unregister')
         .description('Remove a code project and its indexed data')
-        .argument('<name>', 'Project name or id')
-        .action(async (name) => {
-        loadEnv();
-        const projectId = projectIdFromName(name);
+        .option('--workspace <name>', 'Target workspace (defaults to active)')
+        .action(async (options) => {
+        const { store, close: closeStore } = await openHubStore();
+        const projectId = await resolveWorkspaceFlag(store, options.workspace);
+        await closeStore();
         const adapters = buildAdapters();
         try {
             const useCase = new UnregisterCodeProjectUseCase(adapters.storage, adapters.graph, adapters.vec);
             await useCase.execute(projectId);
-            console.log(chalk.yellow(`  Unregistered '${name}' (id: ${projectId})`));
+            console.log(chalk.yellow(`  Unregistered project (id: ${projectId})`));
         }
         finally {
             await closeAdapters(adapters);
@@ -261,42 +168,39 @@ export function registerCodeCommands(program) {
         .option('--status', 'Print latest index job + stats and exit (no indexing)')
         .option('--lsp', 'Use typescript-language-server for cross-file call resolution (slower, more accurate)')
         .action(async (options) => {
-        loadEnv();
         const adapters = buildAdapters();
         const spinner = ora('Resolving project...').start();
         let lspClient = null;
         try {
-            const project = options.project
+            const project = options.project !== undefined && options.project !== ''
                 ? await adapters.storage.getProjectById(options.project)
                 : await adapters.storage.getProjectByRoot(process.cwd());
-            if (!project) {
+            if (project == null) {
                 spinner.fail('Project not registered. Run `argustack code register --name <name>`.');
                 process.exitCode = 1;
                 return;
             }
-            if (options.status) {
+            if (options.status === true) {
                 spinner.stop();
                 const job = await adapters.storage.getLatestJob(project.id);
                 console.log('');
                 console.log(`  ${chalk.bold(project.name)} ${chalk.dim(`(${project.id})`)}`);
                 console.log(chalk.dim(`    root: ${project.root}`));
-                if (!job) {
+                if (job == null) {
                     console.log(chalk.yellow('    No index jobs recorded yet. Run `argustack code index`.'));
                     console.log('');
                     return;
                 }
-                const statusColor = job.status === 'completed'
-                    ? chalk.green
-                    : job.status === 'failed' ? chalk.red : chalk.yellow;
+                const statusColor = getStatusColor(job.status);
                 console.log(`    last job:   ${statusColor(job.status)} (${job.type}) #${String(job.id)}`);
                 console.log(chalk.dim(`    started:    ${job.startedAt}`));
-                if (job.completedAt) {
+                if (job.completedAt !== undefined && job.completedAt !== '') {
                     console.log(chalk.dim(`    completed:  ${job.completedAt}`));
                 }
-                if (job.stats) {
+                if (job.stats != null) {
                     console.log(chalk.dim(`    stats:      files=${String(job.stats.filesIndexed)} symbols=${String(job.stats.symbolsCreated)} chunks=${String(job.stats.chunksCreated)} edges=${String(job.stats.edgesCreated)} duration=${String(job.stats.durationMs)}ms`));
                 }
-                if (job.error) {
+                if (job.error !== undefined && job.error !== '') {
                     console.log(chalk.red(`    error:      ${job.error}`));
                 }
                 console.log('');
@@ -304,7 +208,7 @@ export function registerCodeCommands(program) {
             }
             spinner.text = `Indexing '${project.name}'...`;
             const parser = new TreeSitterParser({ projectRoot: project.root });
-            if (options.lsp) {
+            if (options.lsp === true) {
                 const client = new TypeScriptLspClient();
                 try {
                     await client.start(project.root);
@@ -343,13 +247,13 @@ export function registerCodeCommands(program) {
         catch (err) {
             spinner.fail('Index failed');
             console.error(chalk.red(`  ${err instanceof Error ? err.message : String(err)}`));
-            if (err instanceof Error && err.stack) {
+            if (err instanceof Error && err.stack !== undefined && err.stack !== '') {
                 console.error(chalk.dim(err.stack));
             }
             process.exitCode = 1;
         }
         finally {
-            if (lspClient) {
+            if (lspClient != null) {
                 try {
                     await lspClient.stop();
                 }
@@ -362,7 +266,6 @@ export function registerCodeCommands(program) {
         .command('list')
         .description('List registered code projects')
         .action(async () => {
-        loadEnv();
         const adapters = buildAdapters();
         try {
             const projects = await adapters.storage.listProjects();
@@ -372,7 +275,7 @@ export function registerCodeCommands(program) {
             }
             console.log('');
             for (const p of projects) {
-                const lastIndexed = p.lastIndexedAt
+                const lastIndexed = p.lastIndexedAt !== undefined && p.lastIndexedAt !== ''
                     ? new Date(p.lastIndexedAt).toLocaleString()
                     : chalk.dim('never');
                 console.log(`  ${chalk.green('●')} ${chalk.bold(p.name)} ${chalk.dim(`(${p.id})`)}`);
@@ -389,7 +292,6 @@ export function registerCodeCommands(program) {
         .command('status')
         .description('Show status of code intelligence stores and projects')
         .action(async () => {
-        loadEnv();
         const adapters = buildAdapters();
         try {
             const projects = await adapters.storage.listProjects();
@@ -402,11 +304,11 @@ export function registerCodeCommands(program) {
             console.log(chalk.bold(`  Projects (${String(projects.length)}):`));
             for (const p of projects) {
                 const job = await adapters.storage.getLatestJob(p.id);
-                const jobInfo = job
+                const jobInfo = job != null
                     ? `${job.status} (${job.type})`
                     : chalk.dim('no jobs');
                 const watcherPid = readWatcherPid(p.id);
-                const watcherInfo = watcherPid
+                const watcherInfo = watcherPid != null && watcherPid !== 0
                     ? chalk.cyan(`  ⟳ watching (pid ${String(watcherPid)})`)
                     : '';
                 console.log(`    ${chalk.green('●')} ${p.name} — ${jobInfo}${watcherInfo}`);
@@ -419,15 +321,16 @@ export function registerCodeCommands(program) {
     });
     code
         .command('stats')
-        .description('Show stats for a project')
-        .argument('<projectId>', 'Project id')
-        .action(async (projectId) => {
-        loadEnv();
+        .description('Show stats for a code project')
+        .option('--workspace <name>', 'Target workspace (defaults to active)')
+        .action(async (options) => {
+        const { store, close: closeStore } = await openHubStore();
+        const id = await resolveWorkspaceFlag(store, options.workspace);
+        await closeStore();
         const adapters = buildAdapters();
         try {
-            const id = projectIdFromName(projectId);
             const project = await adapters.storage.getProjectById(id);
-            if (!project) {
+            if (project == null) {
                 console.log(chalk.red(`\n  Project '${id}' not found.\n`));
                 process.exitCode = 1;
                 return;
@@ -438,9 +341,9 @@ export function registerCodeCommands(program) {
             console.log(`  ${chalk.bold(project.name)} ${chalk.dim(`(${project.id})`)}`);
             console.log(`    root:           ${project.root}`);
             console.log(`    vectors:        ${String(vecStats.pointCount)} (dim ${String(vecStats.vectorDim)})`);
-            if (lastJob) {
+            if (lastJob != null) {
                 console.log(`    last job:       ${lastJob.status} ${lastJob.type} @ ${lastJob.startedAt}`);
-                if (lastJob.stats) {
+                if (lastJob.stats != null) {
                     console.log(chalk.dim(`      files=${String(lastJob.stats.filesIndexed)} symbols=${String(lastJob.stats.symbolsCreated)} chunks=${String(lastJob.stats.chunksCreated)} tokens=${String(lastJob.stats.embeddingTokens)}`));
                 }
             }
@@ -457,21 +360,20 @@ export function registerCodeCommands(program) {
         .option('--daemon', 'Run in background, write PID file')
         .option('--stop', 'Stop running daemon for this project')
         .action(async (options) => {
-        loadEnv();
-        mkdirSync(WATCHERS_DIR, { recursive: true });
+        mkdirSync(WATCHERS_DIR(), { recursive: true });
         const adapters = buildAdapters();
         try {
-            const project = options.project
+            const project = options.project !== undefined && options.project !== ''
                 ? await adapters.storage.getProjectById(options.project)
                 : await adapters.storage.getProjectByRoot(process.cwd());
-            if (!project) {
+            if (project == null) {
                 console.log(chalk.red('\n  Project not registered. Run `argustack code register --name <name>`.\n'));
                 process.exitCode = 1;
                 return;
             }
-            if (options.stop) {
+            if (options.stop === true) {
                 const pid = readWatcherPid(project.id);
-                if (!pid) {
+                if (pid == null || pid === 0) {
                     console.log(chalk.yellow(`  No running watcher for '${project.id}'.`));
                     return;
                 }
@@ -490,12 +392,12 @@ export function registerCodeCommands(program) {
                 return;
             }
             const existingPid = readWatcherPid(project.id);
-            if (existingPid) {
+            if (existingPid != null && existingPid !== 0) {
                 console.log(chalk.yellow(`  Watcher already running (pid ${String(existingPid)}) for '${project.id}'.`));
                 console.log(chalk.dim(`  Use --stop to stop it, or check ${watcherPaths(project.id).logFile}`));
                 return;
             }
-            if (options.daemon) {
+            if (options.daemon === true) {
                 const { pidFile, logFile } = watcherPaths(project.id);
                 const logFd = openSync(logFile, 'a');
                 const child = spawn(process.execPath, [process.argv[1] ?? '', 'code', 'watch', '--project', project.id], {
@@ -504,7 +406,7 @@ export function registerCodeCommands(program) {
                     env: process.env,
                 });
                 child.unref();
-                if (child.pid) {
+                if (child.pid != null && child.pid !== 0) {
                     writeFileSync(pidFile, String(child.pid));
                     console.log(chalk.green(`  Watcher started in background for '${project.id}'`));
                     console.log(chalk.dim(`    pid:  ${String(child.pid)}`));