argustack 0.2.0 → 0.3.1

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"}