argustack 0.1.34 → 0.3.1

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.1.34",
+  "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",
@@ -54,7 +56,7 @@
   ],
   "repository": {
     "type": "git",
-    "url": "https://github.com/InfoCodeStreamly/argustack"
+    "url": "https://github.com/CodeStreamly/argustack"
   },
   "license": "MIT",
   "engines": {
@@ -64,19 +66,26 @@
     "@hello-pangea/dnd": "^18.0.1",
     "@inquirer/prompts": "^8.3.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
+    "@qdrant/js-client-rest": "^1.18.0",
     "chalk": "^5.4.1",
+    "chokidar": "^5.0.0",
     "commander": "^14.0.3",
     "csv-parse": "^6.2.1",
     "dotenv": "^17.3.1",
     "es-git": "^0.6.0",
+    "ignore": "^7.0.5",
     "jira.js": "^5.3.1",
     "knex": "^3.1.0",
     "mysql2": "^3.20.0",
+    "neo4j-driver": "^6.0.1",
     "octokit": "^5.0.5",
     "ora": "^9.3.0",
     "pg": "^8.13.1",
     "react": "^19.2.4",
-    "react-dom": "^19.2.4"
+    "react-dom": "^19.2.4",
+    "tree-sitter": "^0.21.1",
+    "tree-sitter-typescript": "^0.23.2",
+    "vscode-jsonrpc": "^8.2.1"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",

package/templates/code-docker-compose.yml

@@ -0,0 +1,51 @@
+# Argustack global Code Intelligence — shared across ALL workspaces.
+#
+# Multi-tenant: one Neo4j + one Qdrant on standard ports, projects isolated
+# by `projectId` (Neo4j) and per-project collection name (Qdrant).
+#
+# Usage:
+#   cd ~/.argustack/code && docker compose up -d
+#
+# Workspaces point to it via .env:
+#   NEO4J_URI=bolt://localhost:7687
+#   QDRANT_URL=http://localhost:6333
+
+services:
+  neo4j:
+    image: neo4j:5-community
+    container_name: argustack-code-neo4j
+    ports:
+      - "7474:7474"   # HTTP / Neo4j Browser
+      - "7687:7687"   # Bolt
+    environment:
+      NEO4J_AUTH: neo4j/argustack_local
+      NEO4J_PLUGINS: '["apoc"]'
+      NEO4J_dbms_memory_pagecache_size: 1G
+      NEO4J_dbms_memory_heap_initial__size: 1G
+      NEO4J_dbms_memory_heap_max__size: 2G
+    volumes:
+      - argustack-code-neo4j-data:/data
+      - argustack-code-neo4j-logs:/logs
+      - argustack-code-neo4j-plugins:/plugins
+    healthcheck:
+      test: ["CMD-SHELL", "wget --no-verbose --tries=1 --spider http://localhost:7474 || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 15
+    restart: unless-stopped
+
+  qdrant:
+    image: qdrant/qdrant:latest
+    container_name: argustack-code-qdrant
+    ports:
+      - "6333:6333"   # REST
+      - "6334:6334"   # gRPC
+    volumes:
+      - argustack-code-qdrant-data:/qdrant/storage
+    restart: unless-stopped
+
+volumes:
+  argustack-code-neo4j-data:
+  argustack-code-neo4j-logs:
+  argustack-code-neo4j-plugins:
+  argustack-code-qdrant-data:

package/templates/env.example

@@ -15,3 +15,19 @@ DB_PORT=5434
 DB_USER=argustack
 DB_PASSWORD=argustack_local
 DB_NAME=argustack
+
+# === Code Intelligence (optional — needed only for `argustack code`) ===
+# Set these after running `argustack code init` which bootstraps the shared
+# hub at ~/.argustack/code/ (Neo4j + Qdrant on standard ports).
+# NEO4J_URI=bolt://localhost:7687
+# NEO4J_USER=neo4j
+# NEO4J_PASSWORD=argustack_local
+# QDRANT_URL=http://localhost:6333
+
+# Code embedding provider: lmstudio (default, local) or voyage (cloud)
+# CODE_EMBEDDING_PROVIDER=lmstudio
+# LMSTUDIO_URL=http://localhost:1234
+# EMBEDDING_MODEL=text-embedding-qwen3-embedding-4b
+# EMBEDDING_DIMS=1024
+# RERANK_MODEL=                              # optional, LM Studio chat model id (e.g. Qwen3-Reranker)
+# VOYAGE_API_KEY=                            # only if CODE_EMBEDDING_PROVIDER=voyage

package/templates/hub-config.env

@@ -0,0 +1,65 @@
+# Argustack hub — global configuration shared by ALL workspaces.
+#
+# Location: ~/.argustack/config.env
+# Loaded by every CLI invocation and MCP server start-up.
+# Per-workspace settings (Jira project keys, git repo paths, etc.) live in
+# the `workspaces.settings` JSONB column in the hub Postgres, not here.
+#
+# Permissions: chmod 600 recommended (this file may contain tokens).
+
+# ===== Hub Postgres (created by `argustack init`) =====
+DB_HOST=localhost
+DB_PORT=15432
+DB_NAME=argustack_hub
+DB_USER=argustack
+DB_PASSWORD=argustack_hub
+
+# ===== Neo4j (code-intel graph) =====
+NEO4J_URI=bolt://localhost:15435
+NEO4J_USER=neo4j
+NEO4J_PASSWORD=argustack_local
+
+# ===== Qdrant (code-intel vectors) =====
+QDRANT_URL=http://localhost:15436
+
+# ===== Code embedding provider =====
+# Managed by `argustack init`. Examples:
+#
+# Ollama (default after init):
+#   CODE_EMBEDDING_PROVIDER=ollama
+#   OLLAMA_URL=http://localhost:11434
+#   EMBEDDING_MODEL=nomic-embed-text
+#   EMBEDDING_DIMS=768
+#
+# LM Studio:
+#   CODE_EMBEDDING_PROVIDER=lmstudio
+#   LMSTUDIO_URL=http://localhost:1234
+#   EMBEDDING_MODEL=text-embedding-qwen3-embedding-4b
+#   EMBEDDING_DIMS=1024
+#
+# Custom OpenAI-compatible server:
+#   CODE_EMBEDDING_PROVIDER=custom
+#   CUSTOM_EMBEDDING_URL=http://your-server:8080
+#   EMBEDDING_MODEL=your-model-name
+#   EMBEDDING_DIMS=768
+#
+# Voyage AI (cloud, paid):
+#   CODE_EMBEDDING_PROVIDER=voyage
+#   VOYAGE_API_KEY=pa-...
+#   EMBEDDING_MODEL=voyage-code-3
+#   EMBEDDING_DIMS=1024
+
+# ===== Issue embeddings (OpenAI text-embedding-3-small, 1536d) =====
+# Used by `argustack embed` for semantic search of Jira issues.
+# OPENAI_API_KEY=
+
+# ===== Jira credentials (one set per machine) =====
+# Per-workspace project keys live in `workspaces.settings.jiraProjectKeys`.
+# JIRA_URL=https://your-instance.atlassian.net
+# JIRA_EMAIL=
+# JIRA_API_TOKEN=
+# JIRA_PROXY_TOKEN=
+
+# ===== GitHub credentials (one PAT per machine) =====
+# Per-workspace `owner/repo` targets live in `workspaces.settings.githubRepos`.
+# GITHUB_TOKEN=

package/templates/hub-docker-compose.yml

@@ -0,0 +1,88 @@
+# Argustack Hub — one Docker stack for ALL workspaces.
+#
+# Multi-tenant: a single Postgres + Neo4j + Qdrant set hosts data for every
+# workspace registered through `argustack workspace add`. Tenant isolation
+# happens at the schema level (workspace_id FK in pg, projectId property in
+# neo4j, per-workspace collection in qdrant).
+#
+# Ports are configured via .env file next to this compose file. argustack init
+# writes it with conflict-free ports (default 15432..15437 range).
+#
+# Usage:
+#   cd ~/.argustack && docker compose up -d
+#
+# Workspaces find this stack via ~/.argustack/config.env which uses the
+# same ports as the .env file here.
+
+name: argustack
+
+services:
+  pg:
+    image: pgvector/pgvector:pg16
+    container_name: argustack-hub-pg
+    ports:
+      - "${HUB_PG_PORT:-15432}:5432"
+    environment:
+      POSTGRES_USER: argustack
+      POSTGRES_PASSWORD: argustack_hub
+      POSTGRES_DB: argustack_hub
+    volumes:
+      - argustack-hub-pg-data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U argustack -d argustack_hub"]
+      interval: 5s
+      timeout: 3s
+      retries: 20
+    restart: unless-stopped
+
+  pgweb:
+    image: sosedoff/pgweb
+    container_name: argustack-hub-pgweb
+    ports:
+      - "${HUB_PGWEB_PORT:-15433}:8081"
+    environment:
+      DATABASE_URL: postgres://argustack:argustack_hub@pg:5432/argustack_hub?sslmode=disable
+    depends_on:
+      pg:
+        condition: service_healthy
+    restart: unless-stopped
+
+  neo4j:
+    image: neo4j:5-community
+    container_name: argustack-hub-neo4j
+    ports:
+      - "${HUB_NEO4J_HTTP_PORT:-15434}:7474"
+      - "${HUB_NEO4J_BOLT_PORT:-15435}:7687"
+    environment:
+      NEO4J_AUTH: neo4j/argustack_local
+      NEO4J_PLUGINS: '["apoc"]'
+      NEO4J_dbms_memory_pagecache_size: 1G
+      NEO4J_dbms_memory_heap_initial__size: 1G
+      NEO4J_dbms_memory_heap_max__size: 2G
+    volumes:
+      - argustack-hub-neo4j-data:/data
+      - argustack-hub-neo4j-logs:/logs
+      - argustack-hub-neo4j-plugins:/plugins
+    healthcheck:
+      test: ["CMD-SHELL", "wget --no-verbose --tries=1 --spider http://localhost:7474 || exit 1"]
+      interval: 10s
+      timeout: 5s
+      retries: 15
+    restart: unless-stopped
+
+  qdrant:
+    image: qdrant/qdrant:latest
+    container_name: argustack-hub-qdrant
+    ports:
+      - "${HUB_QDRANT_REST_PORT:-15436}:6333"
+      - "${HUB_QDRANT_GRPC_PORT:-15437}:6334"
+    volumes:
+      - argustack-hub-qdrant-data:/qdrant/storage
+    restart: unless-stopped
+
+volumes:
+  argustack-hub-pg-data:
+  argustack-hub-neo4j-data:
+  argustack-hub-neo4j-logs:
+  argustack-hub-neo4j-plugins:
+  argustack-hub-qdrant-data:

package/templates/migrate-to-hub.sql

@@ -0,0 +1,90 @@
+-- Argustack Hub schema (reference / manual verification)
+--
+-- This file mirrors what `ensureSchema()` in
+-- `src/adapters/postgres/schema.ts` creates programmatically. Keep
+-- the two in sync. Use this file for:
+--   * `psql -f migrate-to-hub.sql` on a fresh database to bootstrap
+--     the hub without running the Node CLI
+--   * Reviewing constraints during code review
+--   * Verifying a running hub against the expected DDL
+--
+-- Tenant model: every data table carries
+--   workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE
+-- Composite UNIQUE / PRIMARY KEY constraints always lead with workspace_id.
+-- ARG-264 (ARG-264.md) is the source of truth for the multi-tenant design.
+
+CREATE EXTENSION IF NOT EXISTS vector;
+
+CREATE TABLE IF NOT EXISTS workspaces (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL UNIQUE,
+  display_name TEXT,
+  settings JSONB NOT NULL DEFAULT '{}',
+  created_at TIMESTAMPTZ DEFAULT NOW(),
+  last_active_at TIMESTAMPTZ DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_workspaces_active ON workspaces (last_active_at DESC);
+
+-- ===== Issues domain =====
+
+CREATE TABLE IF NOT EXISTS issues (
+  id SERIAL PRIMARY KEY,
+  workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
+  issue_key TEXT NOT NULL,
+  -- ... (see schema.ts for full column list)
+  UNIQUE (workspace_id, issue_key)
+);
+
+-- ===== Commits domain =====
+
+CREATE TABLE IF NOT EXISTS commits (
+  workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
+  hash VARCHAR(40) NOT NULL,
+  -- ...
+  PRIMARY KEY (workspace_id, hash)
+);
+
+-- ===== Pull Requests domain =====
+
+CREATE TABLE IF NOT EXISTS pull_requests (
+  workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
+  number INTEGER NOT NULL,
+  repo_full_name VARCHAR(200) NOT NULL,
+  -- ...
+  PRIMARY KEY (workspace_id, repo_full_name, number)
+);
+
+-- ===== Graph domain =====
+
+CREATE TABLE IF NOT EXISTS graph_entities (
+  id SERIAL PRIMARY KEY,
+  workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
+  name TEXT NOT NULL,
+  type VARCHAR(50) NOT NULL,
+  UNIQUE (workspace_id, name, type)
+);
+
+-- ===== External DB schema cache =====
+
+CREATE TABLE IF NOT EXISTS db_tables (
+  id SERIAL PRIMARY KEY,
+  workspace_id TEXT NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
+  source_name TEXT NOT NULL,
+  table_schema TEXT,
+  table_name TEXT NOT NULL,
+  UNIQUE (workspace_id, source_name, table_schema, table_name)
+);
+
+-- ===== Code Intelligence =====
+
+CREATE TABLE IF NOT EXISTS code_projects (
+  id TEXT PRIMARY KEY,
+  workspace_id TEXT NOT NULL UNIQUE REFERENCES workspaces(id) ON DELETE CASCADE,
+  CHECK (id = workspace_id),
+  name TEXT NOT NULL,
+  root_path TEXT NOT NULL,
+  language TEXT NOT NULL
+);
+
+-- See src/adapters/postgres/schema.ts for the canonical, full DDL of
+-- all 24 tenant tables, indexes, and composite foreign keys.

package/dist/cli/workspaces.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from 'commander';
-export declare function registerWorkspacesCommand(program: Command): void;
-//# sourceMappingURL=workspaces.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"workspaces.d.ts","sourceRoot":"","sources":["../../src/cli/workspaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOzC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiChE"}

package/dist/cli/workspaces.js

@@ -1,34 +0,0 @@
-import chalk from 'chalk';
-import { findWorkspaceRoot } from '../workspace/resolver.js';
-import { readConfig } from '../workspace/config.js';
-import { listRegisteredWorkspaces, registerWorkspace } from '../workspace/registry.js';
-import { SOURCE_META } from '../core/types/index.js';
-export function registerWorkspacesCommand(program) {
-    program
-        .command('workspaces')
-        .description('List all known Argustack workspaces')
-        .action(() => {
-        const activeRoot = findWorkspaceRoot() ?? undefined;
-        if (activeRoot) {
-            const config = readConfig(activeRoot);
-            registerWorkspace(activeRoot, config?.name);
-        }
-        const workspaces = listRegisteredWorkspaces(activeRoot);
-        if (workspaces.length === 0) {
-            console.log(chalk.yellow('\n  No workspaces registered.'));
-            console.log(chalk.dim('  Run "argustack init" to create one.\n'));
-            return;
-        }
-        console.log(`\n  Workspaces (${String(workspaces.length)}):\n`);
-        for (const ws of workspaces) {
-            const marker = ws.active ? chalk.green('●') : chalk.dim('○');
-            const name = ws.active ? chalk.green.bold(ws.name) : ws.name;
-            const sources = ws.sources.map((s) => SOURCE_META[s].label).join(', ') || 'no sources';
-            const activeSuffix = ws.active ? chalk.dim(' (active)') : '';
-            console.log(`  ${marker} ${name}${activeSuffix}`);
-            console.log(chalk.dim(`    ${ws.path}`));
-            console.log(chalk.dim(`    ${sources}\n`));
-        }
-    });
-}
-//# sourceMappingURL=workspaces.js.map

package/dist/cli/workspaces.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"workspaces.js","sourceRoot":"","sources":["../../src/cli/workspaces.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACvF,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,YAAY,CAAC;SACrB,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,UAAU,GAAG,iBAAiB,EAAE,IAAI,SAAS,CAAC;QAEpD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;YACtC,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;QAC9C,CAAC;QAED,MAAM,UAAU,GAAG,wBAAwB,CAAC,UAAU,CAAC,CAAC;QAExD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,+BAA+B,CAAC,CAAC,CAAC;YAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yCAAyC,CAAC,CAAC,CAAC;YAClE,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAEhE,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC;YAC7D,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC;YACvF,MAAM,YAAY,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAE7D,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,IAAI,IAAI,GAAG,YAAY,EAAE,CAAC,CAAC;YAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;YACzC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,OAAO,IAAI,CAAC,CAAC,CAAC;QAC7C,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}