argustack 0.1.0

package/dist/workspace/config.js

@@ -0,0 +1,91 @@
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+const CONFIG_FILE = '.argustack/config.json';
+/**
+ * Create a fresh empty workspace config.
+ */
+export function createEmptyConfig() {
+    return {
+        version: 1,
+        sources: {},
+        order: [],
+        createdAt: new Date().toISOString(),
+    };
+}
+/**
+ * Read config.json from workspace root.
+ * Returns null if not found.
+ */
+export function readConfig(workspaceRoot) {
+    const path = join(workspaceRoot, CONFIG_FILE);
+    if (!existsSync(path)) {
+        return null;
+    }
+    const raw = readFileSync(path, 'utf-8');
+    return JSON.parse(raw);
+}
+/**
+ * Write config.json to workspace root.
+ */
+export function writeConfig(workspaceRoot, config) {
+    const path = join(workspaceRoot, CONFIG_FILE);
+    writeFileSync(path, JSON.stringify(config, null, 2) + '\n');
+}
+/**
+ * Add a new source to the config (first-time setup).
+ */
+export function addSource(config, source) {
+    const existing = config.sources[source];
+    config.sources[source] = {
+        enabled: true,
+        addedAt: existing?.addedAt ?? new Date().toISOString(),
+    };
+    // Add to order if not present
+    if (!config.order.includes(source)) {
+        config.order.push(source);
+    }
+    return config;
+}
+/**
+ * Re-enable a previously disabled source.
+ * Different from addSource — doesn't reset addedAt, just flips enabled.
+ */
+export function enableSource(config, source) {
+    const existing = config.sources[source];
+    if (!existing) {
+        // Never been added — delegate to addSource
+        return addSource(config, source);
+    }
+    existing.enabled = true;
+    delete existing.disabledAt;
+    // Re-add to order if not present
+    if (!config.order.includes(source)) {
+        config.order.push(source);
+    }
+    return config;
+}
+/**
+ * Disable a source (soft — keeps credentials in .env).
+ */
+export function disableSource(config, source) {
+    const existing = config.sources[source];
+    if (existing) {
+        existing.enabled = false;
+        existing.disabledAt = new Date().toISOString();
+    }
+    config.order = config.order.filter((s) => s !== source);
+    return config;
+}
+/**
+ * Get enabled sources in order.
+ */
+export function getEnabledSources(config) {
+    return config.order.filter((s) => config.sources[s]?.enabled);
+}
+/**
+ * Check if a specific source is enabled.
+ */
+export function isSourceEnabled(config, source) {
+    return config.sources[source]?.enabled === true;
+}
+//# sourceMappingURL=config.js.map

package/dist/workspace/config.js.map

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

package/dist/workspace/resolver.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Find workspace root by walking up from startDir looking for .argustack/
+ * Returns the directory that contains .argustack/ (the workspace root), or null.
+ *
+ * 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;
+/**
+ * Require workspace — throws user-friendly error if not found.
+ */
+export declare function requireWorkspace(startDir?: string): string;
+/**
+ * Check if a directory is already a workspace.
+ */
+export declare function isWorkspace(dir: string): boolean;
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/workspace/resolver.ts"],"names":[],"mappings":"AAKA;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkBlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAS1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD"}

package/dist/workspace/resolver.js

@@ -0,0 +1,47 @@
+import { existsSync } from 'node:fs';
+import { join, dirname, resolve } from 'node:path';
+const WORKSPACE_MARKER = '.argustack';
+/**
+ * Find workspace root by walking up from startDir looking for .argustack/
+ * Returns the directory that contains .argustack/ (the workspace root), or null.
+ *
+ * Resolution order:
+ *   1. Explicit startDir argument
+ *   2. ARGUSTACK_WORKSPACE env var (set by `argustack mcp install`)
+ *   3. Walk up from process.cwd()
+ */
+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)) {
+            return dir;
+        }
+        const parent = dirname(dir);
+        if (parent === dir) {
+            // Reached filesystem root
+            return null;
+        }
+        dir = parent;
+    }
+}
+/**
+ * Require workspace — throws user-friendly error if not found.
+ */
+export function requireWorkspace(startDir) {
+    const root = findWorkspaceRoot(startDir);
+    if (!root) {
+        throw new Error('Not inside an Argustack workspace.\n' +
+            'Run "argustack init" to create one.');
+    }
+    return root;
+}
+/**
+ * Check if a directory is already a workspace.
+ */
+export function isWorkspace(dir) {
+    return existsSync(join(resolve(dir), WORKSPACE_MARKER));
+}
+//# sourceMappingURL=resolver.js.map

package/dist/workspace/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","sourceRoot":"","sources":["../../src/workspace/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEnD,MAAM,gBAAgB,GAAG,YAAY,CAAC;AAEtC;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAiB;IACjD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;IACxD,MAAM,IAAI,GAAG,QAAQ,IAAI,YAAY,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACvD,IAAI,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QAC3C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACnB,0BAA0B;YAC1B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAiB;IAChD,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CACb,sCAAsC;YACtC,qCAAqC,CACtC,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "argustack",
+  "version": "0.1.0",
+  "description": "Project analysis platform — Jira + Git + DB",
+  "type": "module",
+  "bin": {
+    "argustack": "dist/cli/index.js"
+  },
+  "files": [
+    "dist/",
+    "templates/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/cli/index.ts",
+    "start": "node dist/cli/index.js",
+    "lint": "eslint src/ tests/",
+    "lint:fix": "eslint src/ tests/ --fix",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:unit": "vitest run --project unit",
+    "test:integration": "vitest run --project integration",
+    "test:mcp": "vitest run --project mcp",
+    "test:arch": "vitest run --project architecture",
+    "check": "npm run typecheck && npm run lint",
+    "ci": "npm run check && npm test",
+    "prepublishOnly": "npm run ci && npm run build",
+    "build:mcpb": "npm run build && bash scripts/build-mcpb.sh",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "jira",
+    "git",
+    "analysis",
+    "cli",
+    "devtools"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@inquirer/prompts": "^8.3.0",
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "chalk": "^5.4.1",
+    "commander": "^14.0.3",
+    "csv-parse": "^6.2.1",
+    "dotenv": "^17.3.1",
+    "es-git": "^0.6.0",
+    "jira.js": "^5.3.1",
+    "octokit": "^5.0.5",
+    "ora": "^9.3.0",
+    "pg": "^8.13.1"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/eslint__js": "^8.42.3",
+    "@types/node": "^24.12.0",
+    "@types/pg": "^8.11.10",
+    "@vitest/coverage-v8": "^4.0.18",
+    "eslint": "^10.0.3",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.3.3",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.2",
+    "typescript-eslint": "^8.57.0",
+    "vitest": "^4.0.18"
+  }
+}

package/templates/docker-compose.yml

@@ -0,0 +1,26 @@
+services:
+  db:
+    image: pgvector/pgvector:pg16
+    container_name: argustack-db
+    ports:
+      - "5434:5432"
+    environment:
+      POSTGRES_USER: argustack
+      POSTGRES_PASSWORD: argustack_local
+      POSTGRES_DB: argustack
+    volumes:
+      - argustack-data:/var/lib/postgresql/data
+      - ./db/init.sql:/docker-entrypoint-initdb.d/init.sql
+
+  pgweb:
+    image: sosedoff/pgweb
+    container_name: argustack-pgweb
+    ports:
+      - "8086:8081"
+    environment:
+      DATABASE_URL: postgres://argustack:argustack_local@db:5432/argustack?sslmode=disable
+    depends_on:
+      - db
+
+volumes:
+  argustack-data:

package/templates/env.example

@@ -0,0 +1,14 @@
+# === Jira (required) ===
+JIRA_URL=https://your-instance.atlassian.net
+JIRA_EMAIL=your@email.com
+JIRA_API_TOKEN=your_jira_api_token
+
+# Projects to pull (comma-separated)
+JIRA_PROJECTS=PROJ,ANOTHER
+
+# === PostgreSQL (defaults — no need to change) ===
+DB_HOST=localhost
+DB_PORT=5434
+DB_USER=argustack
+DB_PASSWORD=argustack_local
+DB_NAME=argustack

package/templates/gitignore

@@ -0,0 +1,6 @@
+# Argustack workspace
+.env
+.mcp.json
+data/
+node_modules/
+.DS_Store

package/templates/init.sql

@@ -0,0 +1,236 @@
+-- Argustack — PostgreSQL schema
+-- All Jira data stored as-is, no field renaming or mapping
+
+CREATE EXTENSION IF NOT EXISTS vector;
+
+-- Main issues table
+CREATE TABLE issues (
+    id SERIAL PRIMARY KEY,
+    issue_key TEXT UNIQUE NOT NULL,
+    issue_id TEXT,
+    project_key TEXT,
+    summary TEXT NOT NULL,
+    description TEXT,
+    issue_type VARCHAR(50),
+    status VARCHAR(50),
+    status_category VARCHAR(50),
+    priority TEXT,
+    resolution VARCHAR(50),
+    assignee VARCHAR(100),
+    reporter VARCHAR(100),
+    created TIMESTAMP,
+    updated TIMESTAMP,
+    resolved TIMESTAMP,
+    due_date DATE,
+    labels TEXT[],
+    components TEXT[],
+    fix_versions TEXT[],
+    parent_key TEXT,
+    sprint VARCHAR(200),
+    story_points NUMERIC,
+    custom_fields JSONB,          -- all custom fields as JSON
+    raw_json JSONB,               -- full raw API response, as-is
+    embedding vector(1536),       -- pgvector for semantic search
+    search_vector tsvector,       -- full-text search
+    pulled_at TIMESTAMP DEFAULT NOW()
+);
+
+-- Comments
+CREATE TABLE issue_comments (
+    id SERIAL PRIMARY KEY,
+    issue_key TEXT NOT NULL REFERENCES issues(issue_key),
+    comment_id TEXT,
+    author VARCHAR(100),
+    body TEXT,
+    created TIMESTAMP,
+    updated TIMESTAMP
+);
+
+-- Changelog (change history)
+CREATE TABLE issue_changelogs (
+    id SERIAL PRIMARY KEY,
+    issue_key TEXT NOT NULL REFERENCES issues(issue_key),
+    author VARCHAR(100),
+    field VARCHAR(100),
+    from_value TEXT,
+    to_value TEXT,
+    changed_at TIMESTAMP
+);
+
+-- Worklogs
+CREATE TABLE issue_worklogs (
+    id SERIAL PRIMARY KEY,
+    issue_key TEXT NOT NULL REFERENCES issues(issue_key),
+    author VARCHAR(100),
+    time_spent TEXT,
+    time_spent_seconds INTEGER,
+    comment TEXT,
+    started TIMESTAMP
+);
+
+-- Links
+CREATE TABLE issue_links (
+    id SERIAL PRIMARY KEY,
+    source_key TEXT NOT NULL,
+    target_key TEXT NOT NULL,
+    link_type VARCHAR(50),
+    direction VARCHAR(10)
+);
+
+-- ─── Git tables ──────────────────────────────────────────────────────
+
+CREATE TABLE commits (
+    hash VARCHAR(40) PRIMARY KEY,
+    message TEXT,
+    author VARCHAR(200),
+    email VARCHAR(200),
+    committed_at TIMESTAMPTZ,
+    parents TEXT[],
+    repo_path TEXT,
+    search_vector tsvector,
+    pulled_at TIMESTAMP DEFAULT NOW()
+);
+
+CREATE TABLE commit_files (
+    id SERIAL PRIMARY KEY,
+    commit_hash VARCHAR(40) NOT NULL REFERENCES commits(hash),
+    file_path TEXT NOT NULL,
+    status TEXT,
+    additions INTEGER DEFAULT 0,
+    deletions INTEGER DEFAULT 0
+);
+
+CREATE TABLE commit_issue_refs (
+    commit_hash VARCHAR(40) NOT NULL REFERENCES commits(hash),
+    issue_key TEXT NOT NULL,
+    PRIMARY KEY (commit_hash, issue_key)
+);
+
+-- ─── GitHub tables ──────────────────────────────────────────────────
+
+CREATE TABLE pull_requests (
+    number INTEGER NOT NULL,
+    repo_full_name VARCHAR(200) NOT NULL,
+    title TEXT,
+    body TEXT,
+    state VARCHAR(10),
+    author VARCHAR(200),
+    created_at TIMESTAMPTZ,
+    updated_at TIMESTAMPTZ,
+    merged_at TIMESTAMPTZ,
+    closed_at TIMESTAMPTZ,
+    merge_commit_sha VARCHAR(40),
+    head_ref VARCHAR(200),
+    base_ref VARCHAR(200),
+    labels TEXT[],
+    reviewers TEXT[],
+    additions INTEGER DEFAULT 0,
+    deletions INTEGER DEFAULT 0,
+    changed_files INTEGER DEFAULT 0,
+    raw_json JSONB,
+    search_vector tsvector,
+    pulled_at TIMESTAMP DEFAULT NOW(),
+    PRIMARY KEY (repo_full_name, number)
+);
+
+CREATE TABLE pr_reviews (
+    id SERIAL PRIMARY KEY,
+    pr_number INTEGER NOT NULL,
+    repo_full_name VARCHAR(200) NOT NULL,
+    review_id INTEGER NOT NULL,
+    reviewer VARCHAR(200),
+    state VARCHAR(30),
+    body TEXT,
+    submitted_at TIMESTAMPTZ
+);
+
+CREATE TABLE pr_comments (
+    id SERIAL PRIMARY KEY,
+    pr_number INTEGER NOT NULL,
+    repo_full_name VARCHAR(200) NOT NULL,
+    comment_id BIGINT NOT NULL,
+    author VARCHAR(200),
+    body TEXT,
+    path TEXT,
+    line INTEGER,
+    created_at TIMESTAMPTZ,
+    updated_at TIMESTAMPTZ
+);
+
+CREATE TABLE pr_files (
+    id SERIAL PRIMARY KEY,
+    pr_number INTEGER NOT NULL,
+    repo_full_name VARCHAR(200) NOT NULL,
+    file_path TEXT NOT NULL,
+    status TEXT,
+    additions INTEGER DEFAULT 0,
+    deletions INTEGER DEFAULT 0
+);
+
+CREATE TABLE pr_issue_refs (
+    pr_number INTEGER NOT NULL,
+    repo_full_name VARCHAR(200) NOT NULL,
+    issue_key TEXT NOT NULL,
+    PRIMARY KEY (repo_full_name, pr_number, issue_key)
+);
+
+CREATE TABLE releases (
+    id INTEGER NOT NULL,
+    repo_full_name VARCHAR(200) NOT NULL,
+    tag_name VARCHAR(200),
+    name TEXT,
+    body TEXT,
+    author VARCHAR(200),
+    draft BOOLEAN DEFAULT FALSE,
+    prerelease BOOLEAN DEFAULT FALSE,
+    created_at TIMESTAMPTZ,
+    published_at TIMESTAMPTZ,
+    raw_json JSONB,
+    search_vector tsvector,
+    pulled_at TIMESTAMP DEFAULT NOW(),
+    PRIMARY KEY (repo_full_name, id)
+);
+
+-- ─── Indexes ────────────────────────────────────────────────────────
+
+-- Jira indexes
+CREATE INDEX idx_issues_project ON issues(project_key);
+CREATE INDEX idx_issues_status ON issues(status);
+CREATE INDEX idx_issues_type ON issues(issue_type);
+CREATE INDEX idx_issues_assignee ON issues(assignee);
+CREATE INDEX idx_issues_created ON issues(created);
+CREATE INDEX idx_issues_updated ON issues(updated);
+CREATE INDEX idx_issues_search ON issues USING GIN(search_vector);
+CREATE INDEX idx_issues_custom ON issues USING GIN(custom_fields);
+CREATE INDEX idx_issues_raw ON issues USING GIN(raw_json);
+CREATE INDEX idx_comments_key ON issue_comments(issue_key);
+CREATE INDEX idx_changelogs_key ON issue_changelogs(issue_key);
+CREATE INDEX idx_worklogs_key ON issue_worklogs(issue_key);
+CREATE INDEX idx_links_source ON issue_links(source_key);
+CREATE INDEX idx_links_target ON issue_links(target_key);
+
+-- Git indexes
+CREATE INDEX idx_commits_author ON commits(author);
+CREATE INDEX idx_commits_date ON commits(committed_at);
+CREATE INDEX idx_commits_repo ON commits(repo_path);
+CREATE INDEX idx_commits_search ON commits USING GIN(search_vector);
+CREATE INDEX idx_commit_files_hash ON commit_files(commit_hash);
+CREATE INDEX idx_commit_files_path ON commit_files(file_path);
+CREATE INDEX idx_commit_refs_issue ON commit_issue_refs(issue_key);
+
+-- GitHub indexes
+CREATE INDEX idx_prs_repo ON pull_requests(repo_full_name);
+CREATE INDEX idx_prs_state ON pull_requests(state);
+CREATE INDEX idx_prs_author ON pull_requests(author);
+CREATE INDEX idx_prs_merged ON pull_requests(merged_at);
+CREATE INDEX idx_prs_updated ON pull_requests(updated_at);
+CREATE INDEX idx_prs_merge_sha ON pull_requests(merge_commit_sha);
+CREATE INDEX idx_prs_search ON pull_requests USING GIN(search_vector);
+CREATE INDEX idx_pr_reviews_pr ON pr_reviews(repo_full_name, pr_number);
+CREATE INDEX idx_pr_comments_pr ON pr_comments(repo_full_name, pr_number);
+CREATE INDEX idx_pr_files_pr ON pr_files(repo_full_name, pr_number);
+CREATE INDEX idx_pr_files_path ON pr_files(file_path);
+CREATE INDEX idx_pr_refs_issue ON pr_issue_refs(issue_key);
+CREATE INDEX idx_releases_repo ON releases(repo_full_name);
+CREATE INDEX idx_releases_tag ON releases(tag_name);
+CREATE INDEX idx_releases_search ON releases USING GIN(search_vector);