argustack 0.1.19 → 0.1.21

package/dist/workspace/registry.d.ts

@@ -0,0 +1,11 @@
+import type { SourceType } from '../core/types/index.js';
+export interface WorkspaceInfo {
+    name: string;
+    path: string;
+    sources: SourceType[];
+    active: boolean;
+}
+export declare function registerWorkspace(workspacePath: string, name?: string): void;
+export declare function listRegisteredWorkspaces(activeRoot?: string): WorkspaceInfo[];
+export declare function pruneDeadWorkspaces(): void;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +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"}

package/dist/workspace/registry.js

@@ -0,0 +1,80 @@
+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');
+}
+function registryFile() {
+    return join(registryDir(), 'workspaces.json');
+}
+export function registerWorkspace(workspacePath, name) {
+    try {
+        const entries = readRegistry();
+        const existing = entries.find((e) => e.path === workspacePath);
+        if (existing) {
+            if (name && existing.name !== name) {
+                existing.name = name;
+                writeRegistry(entries);
+            }
+            return;
+        }
+        const wsName = name ?? workspacePath.split('/').pop() ?? 'unknown';
+        entries.push({ name: wsName, path: workspacePath, createdAt: new Date().toISOString() });
+        writeRegistry(entries);
+    }
+    catch {
+        /* registry is best-effort — don't fail init/sync */
+    }
+}
+export function listRegisteredWorkspaces(activeRoot) {
+    const entries = readRegistry();
+    const live = [];
+    const workspaces = [];
+    for (const entry of entries) {
+        if (!existsSync(join(entry.path, '.argustack'))) {
+            continue;
+        }
+        live.push(entry);
+        const config = readConfig(entry.path);
+        const sources = config ? getEnabledSources(config) : [];
+        const displayName = config?.name ?? entry.name;
+        workspaces.push({
+            name: displayName,
+            path: entry.path,
+            sources,
+            active: entry.path === activeRoot,
+        });
+    }
+    if (live.length !== entries.length) {
+        writeRegistry(live);
+    }
+    return workspaces;
+}
+export function pruneDeadWorkspaces() {
+    const entries = readRegistry();
+    const live = entries.filter((e) => existsSync(join(e.path, '.argustack')));
+    if (live.length !== entries.length) {
+        writeRegistry(live);
+    }
+}
+function readRegistry() {
+    if (!existsSync(registryFile())) {
+        return [];
+    }
+    try {
+        const raw = readFileSync(registryFile(), 'utf-8');
+        const parsed = JSON.parse(raw);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+function writeRegistry(entries) {
+    if (!existsSync(registryDir())) {
+        mkdirSync(registryDir(), { recursive: true });
+    }
+    writeFileSync(registryFile(), JSON.stringify(entries, null, 2) + '\n');
+}
+//# sourceMappingURL=registry.js.map

package/dist/workspace/registry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "argustack",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "Project analysis platform — Jira + Git + DB",
   "type": "module",
   "bin": {

package/templates/env.example

@@ -6,6 +6,9 @@ JIRA_API_TOKEN=your_jira_api_token
 # Projects to pull (comma-separated)
 JIRA_PROJECTS=PROJ,ANOTHER
 
+# === Jira Proxy (alternative to direct Jira API) ===
+# JIRA_PROXY_TOKEN=your-service-token
+
 # === PostgreSQL (defaults — no need to change) ===
 DB_HOST=localhost
 DB_PORT=5434

package/templates/proxy-config-example.json

@@ -0,0 +1,61 @@
+{
+  "name": "Example Jira Proxy",
+  "description": "Example config for a Jira proxy server that sanitizes responses and enforces read-only access. Customize for your proxy.",
+  "base_url": "https://your-proxy.example.com/service/jira",
+  "auth": {
+    "type": "bearer_exchange",
+    "token_endpoint": "/service/auth/exchange",
+    "service_token_env": "JIRA_PROXY_TOKEN",
+    "ttl_minutes": 15
+  },
+  "endpoints": {
+    "search": {
+      "path": "/search",
+      "method": "GET",
+      "params": ["jql", "fields", "maxResults", "startAt"]
+    },
+    "issue": {
+      "path": "/issue/{key}",
+      "method": "GET"
+    },
+    "projects": {
+      "path": "/project/search",
+      "method": "GET",
+      "params": ["maxResults", "startAt", "query"]
+    },
+    "fields": {
+      "path": "/field",
+      "method": "GET"
+    }
+  },
+  "response_mapping": {
+    "issue_key": "key",
+    "summary": "fields.summary",
+    "description": "fields.description",
+    "status": "fields.status.name",
+    "status_category": "fields.status.statusCategory.name",
+    "issue_type": "fields.issuetype.name",
+    "priority": "fields.priority.name",
+    "resolution": "fields.resolution.name",
+    "assignee": "fields.assignee.displayName",
+    "assignee_id": "fields.assignee.accountId",
+    "reporter": "fields.reporter.displayName",
+    "reporter_id": "fields.reporter.accountId",
+    "created": "fields.created",
+    "updated": "fields.updated",
+    "resolved": "fields.resolutiondate",
+    "due_date": "fields.duedate",
+    "labels": "fields.labels",
+    "components": "fields.components[].name",
+    "fix_versions": "fields.fixVersions[].name",
+    "parent_key": "fields.parent.key",
+    "sprint": "fields.sprint.name",
+    "story_points": "fields.story_points"
+  },
+  "notes": {
+    "how_to_use": "1. Copy this file to .argustack/proxy.json in your workspace. 2. Set JIRA_PROXY_TOKEN in .env. 3. Update base_url to your proxy. 4. Adjust response_mapping if your proxy returns different field paths.",
+    "how_to_generate": "Give your proxy's OpenAPI spec (or API docs) and this template to any LLM. Ask it to generate a proxy.json config that maps your proxy's response format to these fields.",
+    "search_note": "Some proxies strip description from search results for performance. Use the issue endpoint to get full descriptions.",
+    "auth_types": "bearer = static token from env var. bearer_exchange = exchange long-lived service token for short-lived access token (recommended)."
+  }
+}