@sdsrs/codeagent 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 sdsrs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,116 @@
+# CodeAgent
+
+Context-aware coding assistant that integrates code search, memory, and orchestration into a unified Context Broker.
+
+## Install
+
+```bash
+# Global install
+npm install -g codeagent
+
+# Or run directly
+npx codeagent chat
+```
+
+## Usage
+
+### Interactive Chat
+
+```bash
+# Start a new coding session
+codeagent chat
+
+# Resume an existing session
+codeagent chat --resume <sessionId>
+
+# Use a specific provider
+codeagent chat --provider api     # Direct Anthropic API
+codeagent chat --provider cli     # claude -p backend
+codeagent chat --provider sdk     # Agent SDK (default)
+```
+
+### Code Search
+
+```bash
+codeagent search "payment processing"
+codeagent search "RefundService" --type impact
+codeagent search "processPayment" --type callgraph
+codeagent search "src/payment/" --type overview
+```
+
+### Memory
+
+```bash
+codeagent memory "authentication"          # Search memories
+codeagent memory --save "Use cents" --type decision --body "Avoid float issues"
+```
+
+### Sessions
+
+```bash
+codeagent session list
+codeagent session show <id>
+codeagent session delete <id>
+```
+
+### Configuration
+
+```bash
+codeagent config set orchestration superpowers  # or gsd
+codeagent config set model claude-opus-4-6
+codeagent config set maxBudgetUsd 5.0
+```
+
+## Claude Code Integration
+
+CodeAgent enhances Claude Code through hooks:
+
+```bash
+# Install hooks to current project
+codeagent install-hooks
+
+# Install hooks globally
+codeagent install-hooks:global
+```
+
+Hooks automatically inject context on every prompt:
+- **UserPromptSubmit** — Code search + memory + orchestration context
+- **SessionStart** — Project overview on session start
+- **Stop** — Extract discoveries to memory
+
+## Architecture
+
+```
+┌──────────────┐    ┌──────────────┐
+│  devx chat   │    │ Claude Code  │
+│   (CLI/TUI)  │    │   (hooks)    │
+└──────┬───────┘    └──────┬───────┘
+       │                   │
+       └─────────┬─────────┘
+                 ▼
+       ┌─────────────────┐
+       │ Context Broker   │  ← 5-step pipeline
+       │  parse → search  │
+       │  → memory → orch │
+       │  → compress      │
+       └──┬────┬────┬─────┘
+          │    │    │
+    ┌─────┘    │    └─────┐
+    ▼          ▼          ▼
+┌────────┐ ┌───────┐ ┌───────┐
+│ Code   │ │Memory │ │ Orch  │
+│ Graph  │ │Engine │ │Adapter│
+│ (Rust) │ │(Node) │ │(swap) │
+└────────┘ └───────┘ └───────┘
+```
+
+## Requirements
+
+- Node.js >= 20
+- [code-graph-mcp](https://github.com/sdsrs/code-graph-mcp) (optional, for code search)
+- [claude-mem-lite](https://github.com/sdsrs/claude-mem-lite) (optional, for memory)
+- `ANTHROPIC_API_KEY` environment variable (for API provider)
+
+## License
+
+MIT

package/dist/adapters/code-graph.d.ts

@@ -0,0 +1,18 @@
+import type { ParsedQuery } from '../broker/query-parser.js';
+import type { RelevantFile, SymbolInfo } from '../broker/context-pack.js';
+export interface CodeGraphResult {
+    repoSummary?: string;
+    relevantFiles: RelevantFile[];
+    relatedSymbols: SymbolInfo[];
+    raw: string;
+}
+/**
+ * Query Code Graph MCP via CLI.
+ * Selects the right command based on intent.
+ */
+export declare function queryCodeGraph(parsed: ParsedQuery, tokenBudget: number, repoRoot: string): Promise<CodeGraphResult>;
+/**
+ * Get repo map summary via code-graph-mcp map.
+ */
+export declare function getRepoMap(repoRoot: string, timeout?: number): string;
+//# sourceMappingURL=code-graph.d.ts.map

package/dist/adapters/code-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-graph.d.ts","sourceRoot":"","sources":["../../src/adapters/code-graph.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAI1E,MAAM,WAAW,eAAe;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,cAAc,EAAE,UAAU,EAAE,CAAC;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,CAAC,CAuH1B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,SAAO,GAAG,MAAM,CAKnE"}

package/dist/adapters/code-graph.js

@@ -0,0 +1,151 @@
+import { execSafe } from '../utils/exec.js';
+import { truncateToTokenBudget } from '../utils/tokens.js';
+import fs from 'node:fs';
+import path from 'node:path';
+/**
+ * Query Code Graph MCP via CLI.
+ * Selects the right command based on intent.
+ */
+export async function queryCodeGraph(parsed, tokenBudget, repoRoot) {
+    // Check if index exists
+    const dbPath = path.join(repoRoot, '.code-graph', 'index.db');
+    if (!fs.existsSync(dbPath)) {
+        return { relevantFiles: [], relatedSymbols: [], raw: '' };
+    }
+    const result = {
+        relevantFiles: [],
+        relatedSymbols: [],
+        raw: '',
+    };
+    const { intent, symbols, filePaths, keywords } = parsed;
+    const searchQuery = [...symbols, ...keywords.slice(0, 3)].join(' ');
+    if (!searchQuery && filePaths.length === 0) {
+        return result;
+    }
+    try {
+        switch (intent) {
+            case 'impact': {
+                if (symbols.length > 0) {
+                    const { stdout, ok } = execSafe(`code-graph-mcp impact "${symbols[0]}"`, { cwd: repoRoot, timeout: 2000 });
+                    if (ok)
+                        result.raw = stdout;
+                }
+                break;
+            }
+            case 'understand': {
+                if (filePaths.length > 0) {
+                    const dir = filePaths[0].replace(/\/[^/]+$/, '/');
+                    const { stdout, ok } = execSafe(`code-graph-mcp overview "${dir}"`, { cwd: repoRoot, timeout: 2000 });
+                    if (ok)
+                        result.raw = stdout;
+                }
+                else if (searchQuery) {
+                    const { stdout, ok } = execSafe(`code-graph-mcp search "${searchQuery}" --limit 8`, { cwd: repoRoot, timeout: 2000 });
+                    if (ok)
+                        result.raw = stdout;
+                }
+                break;
+            }
+            case 'callgraph': {
+                if (symbols.length > 0) {
+                    const { stdout, ok } = execSafe(`code-graph-mcp callgraph "${symbols[0]}" --depth 2`, { cwd: repoRoot, timeout: 2000 });
+                    if (ok)
+                        result.raw = stdout;
+                }
+                break;
+            }
+            case 'implement': {
+                // Search + overview for implementation context
+                const results = [];
+                if (searchQuery) {
+                    const { stdout, ok } = execSafe(`code-graph-mcp search "${searchQuery}" --limit 5`, { cwd: repoRoot, timeout: 2000 });
+                    if (ok)
+                        results.push(stdout);
+                }
+                if (filePaths.length > 0) {
+                    const dir = filePaths[0].replace(/\/[^/]+$/, '/');
+                    const { stdout, ok } = execSafe(`code-graph-mcp overview "${dir}"`, { cwd: repoRoot, timeout: 2000 });
+                    if (ok)
+                        results.push(stdout);
+                }
+                result.raw = results.join('\n\n');
+                break;
+            }
+            case 'debug':
+            case 'search':
+            case 'general':
+            default: {
+                if (searchQuery) {
+                    const { stdout, ok } = execSafe(`code-graph-mcp search "${searchQuery}" --limit 8`, { cwd: repoRoot, timeout: 2000 });
+                    if (ok)
+                        result.raw = stdout;
+                }
+                else if (filePaths.length > 0) {
+                    const dir = filePaths[0].replace(/\/[^/]+$/, '/');
+                    const { stdout, ok } = execSafe(`code-graph-mcp overview "${dir}"`, { cwd: repoRoot, timeout: 2000 });
+                    if (ok)
+                        result.raw = stdout;
+                }
+                break;
+            }
+        }
+    }
+    catch {
+        // Graceful degradation — return empty
+    }
+    // Truncate to budget
+    if (result.raw) {
+        result.raw = truncateToTokenBudget(result.raw, tokenBudget);
+    }
+    // Parse raw into structured data (best-effort)
+    result.relevantFiles = parseRelevantFiles(result.raw);
+    result.relatedSymbols = parseSymbols(result.raw);
+    return result;
+}
+/**
+ * Get repo map summary via code-graph-mcp map.
+ */
+export function getRepoMap(repoRoot, timeout = 3000) {
+    const dbPath = path.join(repoRoot, '.code-graph', 'index.db');
+    if (!fs.existsSync(dbPath))
+        return '';
+    const { stdout } = execSafe('code-graph-mcp map', { cwd: repoRoot, timeout });
+    return stdout;
+}
+// --- Parsers for code-graph CLI output ---
+function parseRelevantFiles(raw) {
+    if (!raw)
+        return [];
+    const files = [];
+    // Match file paths in output (e.g. "src/foo/bar.ts" or "./src/foo/bar.ts")
+    const fileMatches = raw.match(/(?:^|\s)(\.?\/?\w[\w/.-]*\.\w+)/gm) || [];
+    const seen = new Set();
+    for (const match of fileMatches) {
+        const p = match.trim().replace(/^\.\//, '');
+        if (seen.has(p) || !p.includes('/'))
+            continue;
+        seen.add(p);
+        files.push({ path: p, reason: 'code-graph search hit' });
+    }
+    return files.slice(0, 10);
+}
+function parseSymbols(raw) {
+    if (!raw)
+        return [];
+    const symbols = [];
+    // Match symbol definitions in overview/callgraph output
+    // Typical format: "fn symbol_name" or "struct SymbolName" or "  function symbolName"
+    const symMatches = raw.match(/(?:fn|function|struct|class|impl|trait|interface|type|const|enum)\s+(\w+)/g) || [];
+    const seen = new Set();
+    for (const match of symMatches) {
+        const parts = match.split(/\s+/);
+        const kind = parts[0];
+        const name = parts[1];
+        if (!name || seen.has(name))
+            continue;
+        seen.add(name);
+        symbols.push({ name, kind, file: '' });
+    }
+    return symbols.slice(0, 15);
+}
+//# sourceMappingURL=code-graph.js.map

package/dist/adapters/code-graph.js.map

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

package/dist/adapters/memory.d.ts

@@ -0,0 +1,13 @@
+import type { ParsedQuery } from '../broker/query-parser.js';
+import type { MemoryEntry, Stage } from '../broker/context-pack.js';
+export interface MemoryResult {
+    memories: MemoryEntry[];
+    bugWarnings: MemoryEntry[];
+    raw: string;
+}
+/**
+ * Query memory engine via claude-mem-lite CLI.
+ * Searches for relevant memories based on query and stage.
+ */
+export declare function queryMemory(parsed: ParsedQuery, tokenBudget: number, stage?: Stage): Promise<MemoryResult>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/adapters/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/adapters/memory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,GAAG,EAAE,MAAM,CAAC;CACb;AAsBD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,WAAW,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,CAAC,EAAE,KAAK,GACZ,OAAO,CAAC,YAAY,CAAC,CAyDvB"}

package/dist/adapters/memory.js

@@ -0,0 +1,110 @@
+import { execSafe } from '../utils/exec.js';
+import { truncateToTokenBudget } from '../utils/tokens.js';
+/**
+ * Determine which memory types to search based on the current stage.
+ */
+function getSearchTypes(stage) {
+    switch (stage) {
+        case 'brainstorm':
+            return ['decision', 'discovery'];
+        case 'plan':
+            return ['decision', 'discovery', 'task'];
+        case 'implement':
+            return ['bugfix', 'decision'];
+        case 'review':
+            return ['bugfix'];
+        case 'debug':
+            return ['bugfix', 'discovery'];
+        default:
+            return []; // empty = search all types
+    }
+}
+/**
+ * Query memory engine via claude-mem-lite CLI.
+ * Searches for relevant memories based on query and stage.
+ */
+export async function queryMemory(parsed, tokenBudget, stage) {
+    const result = {
+        memories: [],
+        bugWarnings: [],
+        raw: '',
+    };
+    const searchQuery = [...parsed.symbols, ...parsed.keywords.slice(0, 3)].join(' ');
+    if (!searchQuery)
+        return result;
+    const types = getSearchTypes(stage);
+    const allRaw = [];
+    try {
+        if (types.length === 0) {
+            // Search all types
+            const { stdout, ok } = execSafe(`claude-mem-lite search "${searchQuery}" --limit 8`, { timeout: 2000 });
+            if (ok && stdout)
+                allRaw.push(stdout);
+        }
+        else {
+            // Search each type separately (in parallel we'd Promise.all, but using CLI so sequential)
+            for (const type of types.slice(0, 2)) {
+                const { stdout, ok } = execSafe(`claude-mem-lite search "${searchQuery}" --type ${type} --limit 5`, { timeout: 2000 });
+                if (ok && stdout)
+                    allRaw.push(stdout);
+            }
+        }
+        // Also always search for bug warnings (high priority)
+        if (!types.includes('bugfix')) {
+            const { stdout, ok } = execSafe(`claude-mem-lite search "${searchQuery}" --type bugfix --limit 3`, { timeout: 2000 });
+            if (ok && stdout)
+                allRaw.push(stdout);
+        }
+    }
+    catch {
+        // Graceful degradation
+    }
+    result.raw = allRaw.join('\n---\n');
+    // Truncate to budget
+    if (result.raw) {
+        result.raw = truncateToTokenBudget(result.raw, tokenBudget);
+    }
+    // Parse raw into structured entries
+    const entries = parseMemoryEntries(result.raw);
+    result.memories = entries.filter((e) => e.type !== 'bugfix');
+    result.bugWarnings = entries.filter((e) => e.type === 'bugfix');
+    return result;
+}
+// --- Parse memory search output ---
+function parseMemoryEntries(raw) {
+    if (!raw)
+        return [];
+    const entries = [];
+    // claude-mem-lite search output format varies, but typically:
+    // [ID] [type] title
+    // body text...
+    // ---
+    const blocks = raw.split(/(?:^|\n)---\n/);
+    for (const block of blocks) {
+        const trimmed = block.trim();
+        if (!trimmed)
+            continue;
+        const lines = trimmed.split('\n');
+        const firstLine = lines[0] || '';
+        // Try to parse structured format: "#123 [bugfix] Title here"
+        const match = firstLine.match(/^#?(\d+)\s*\[(\w+)]\s*(.+)/);
+        if (match) {
+            entries.push({
+                id: parseInt(match[1], 10),
+                type: match[2],
+                title: match[3].trim(),
+                body: lines.slice(1).join('\n').trim(),
+            });
+        }
+        else {
+            // Fallback: treat as unstructured
+            entries.push({
+                type: 'semantic',
+                title: firstLine.slice(0, 100),
+                body: lines.slice(1).join('\n').trim(),
+            });
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=memory.js.map

package/dist/adapters/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../../src/adapters/memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAU3D;;GAEG;AACH,SAAS,cAAc,CAAC,KAAa;IACnC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,YAAY;YACf,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;QACnC,KAAK,MAAM;YACT,OAAO,CAAC,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAC3C,KAAK,WAAW;YACd,OAAO,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAChC,KAAK,QAAQ;YACX,OAAO,CAAC,QAAQ,CAAC,CAAC;QACpB,KAAK,OAAO;YACV,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QACjC;YACE,OAAO,EAAE,CAAC,CAAC,2BAA2B;IAC1C,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAmB,EACnB,WAAmB,EACnB,KAAa;IAEb,MAAM,MAAM,GAAiB;QAC3B,QAAQ,EAAE,EAAE;QACZ,WAAW,EAAE,EAAE;QACf,GAAG,EAAE,EAAE;KACR,CAAC;IAEF,MAAM,WAAW,GAAG,CAAC,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClF,IAAI,CAAC,WAAW;QAAE,OAAO,MAAM,CAAC;IAEhC,MAAM,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACpC,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,mBAAmB;YACnB,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,QAAQ,CAC7B,2BAA2B,WAAW,aAAa,EACnD,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;YACF,IAAI,EAAE,IAAI,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACN,0FAA0F;YAC1F,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;gBACrC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,QAAQ,CAC7B,2BAA2B,WAAW,YAAY,IAAI,YAAY,EAClE,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;gBACF,IAAI,EAAE,IAAI,MAAM;oBAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,sDAAsD;QACtD,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,QAAQ,CAC7B,2BAA2B,WAAW,2BAA2B,EACjE,EAAE,OAAO,EAAE,IAAI,EAAE,CAClB,CAAC;YACF,IAAI,EAAE,IAAI,MAAM;gBAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,uBAAuB;IACzB,CAAC;IAED,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEpC,qBAAqB;IACrB,IAAI,MAAM,CAAC,GAAG,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,GAAG,qBAAqB,CAAC,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC;IAED,oCAAoC;IACpC,MAAM,OAAO,GAAG,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,CAAC,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAC7D,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC;IAEhE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,qCAAqC;AAErC,SAAS,kBAAkB,CAAC,GAAW;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,MAAM,OAAO,GAAkB,EAAE,CAAC;IAElC,8DAA8D;IAC9D,oBAAoB;IACpB,eAAe;IACf,MAAM;IACN,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,OAAO;YAAE,SAAS;QAEvB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAEjC,6DAA6D;QAC7D,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC5D,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,IAAI,CAAC;gBACX,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBAC1B,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;gBACd,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;gBACtB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;aACvC,CAAC,CAAC;QACL,CAAC;aAAM,CAAC;YACN,kCAAkC;YAClC,OAAO,CAAC,IAAI,CAAC;gBACX,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBAC9B,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;aACvC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/adapters/orchestration/gsd.d.ts

@@ -0,0 +1,20 @@
+import type { SpecSummary, Stage, TaskSummary } from '../../broker/context-pack.js';
+import type { Evidence, OrchestrationAdapter, StageTransition } from './interface.js';
+/**
+ * GSD-Lite orchestration adapter.
+ * Reads state directly from .gsd/state.json for speed.
+ */
+export declare class GsdAdapter implements OrchestrationAdapter {
+    private repoRoot;
+    constructor(repoRoot: string);
+    private getStatePath;
+    private readState;
+    getCurrentStage(): Promise<Stage | null>;
+    getActiveSpec(): Promise<SpecSummary | null>;
+    getActiveTasks(): Promise<TaskSummary[]>;
+    advanceStage(_evidence: Evidence): Promise<StageTransition | null>;
+    recordEvidence(_evidence: Evidence): Promise<void>;
+    getEngineName(): string;
+    getAvailableStages(): Stage[];
+}
+//# sourceMappingURL=gsd.d.ts.map

package/dist/adapters/orchestration/gsd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsd.d.ts","sourceRoot":"","sources":["../../../src/adapters/orchestration/gsd.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AA6BtF;;;GAGG;AACH,qBAAa,UAAW,YAAW,oBAAoB;IACrD,OAAO,CAAC,QAAQ,CAAS;gBAEb,QAAQ,EAAE,MAAM;IAI5B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,SAAS;IAWX,eAAe,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAMxC,aAAa,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAU5C,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAYxC,YAAY,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAMlE,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,aAAa,IAAI,MAAM;IAIvB,kBAAkB,IAAI,KAAK,EAAE;CAG9B"}

package/dist/adapters/orchestration/gsd.js

@@ -0,0 +1,78 @@
+import fs from 'node:fs';
+import path from 'node:path';
+// Map GSD phases to our Stage type
+const PHASE_TO_STAGE = {
+    research: 'brainstorm',
+    planning: 'plan',
+    execution: 'implement',
+    review: 'review',
+    debugging: 'debug',
+};
+/**
+ * GSD-Lite orchestration adapter.
+ * Reads state directly from .gsd/state.json for speed.
+ */
+export class GsdAdapter {
+    repoRoot;
+    constructor(repoRoot) {
+        this.repoRoot = repoRoot;
+    }
+    getStatePath() {
+        return path.join(this.repoRoot, '.gsd', 'state.json');
+    }
+    readState() {
+        const statePath = this.getStatePath();
+        try {
+            if (!fs.existsSync(statePath))
+                return null;
+            const raw = fs.readFileSync(statePath, 'utf8');
+            return JSON.parse(raw);
+        }
+        catch {
+            return null;
+        }
+    }
+    async getCurrentStage() {
+        const state = this.readState();
+        if (!state?.phase)
+            return null;
+        return PHASE_TO_STAGE[state.phase] || 'general';
+    }
+    async getActiveSpec() {
+        const state = this.readState();
+        if (!state?.spec?.title)
+            return null;
+        return {
+            id: state.spec.id,
+            title: state.spec.title,
+            summary: state.spec.summary,
+        };
+    }
+    async getActiveTasks() {
+        const state = this.readState();
+        if (!state?.tasks)
+            return [];
+        return state.tasks
+            .filter((t) => t.status !== 'completed' && t.status !== 'deleted')
+            .map((t) => ({
+            id: t.id,
+            title: t.title,
+            status: t.status,
+        }));
+    }
+    async advanceStage(_evidence) {
+        // For now, stage advancement is done through GSD MCP tools
+        // This adapter is read-only
+        return null;
+    }
+    async recordEvidence(_evidence) {
+        // Read-only adapter — evidence recording done through GSD MCP
+    }
+    getEngineName() {
+        return 'gsd';
+    }
+    getAvailableStages() {
+        return ['brainstorm', 'plan', 'implement', 'review', 'debug'];
+    }
+}
+//# sourceMappingURL=gsd.js.map

package/dist/adapters/orchestration/gsd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gsd.js","sourceRoot":"","sources":["../../../src/adapters/orchestration/gsd.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAsB7B,mCAAmC;AACnC,MAAM,cAAc,GAA0B;IAC5C,QAAQ,EAAE,YAAY;IACtB,QAAQ,EAAE,MAAM;IAChB,SAAS,EAAE,WAAW;IACtB,MAAM,EAAE,QAAQ;IAChB,SAAS,EAAE,OAAO;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,OAAO,UAAU;IACb,QAAQ,CAAS;IAEzB,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEO,YAAY;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;IACxD,CAAC;IAEO,SAAS;QACf,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,IAAI,CAAC;YACH,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC3C,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;YAC/C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAa,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,eAAe;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,KAAK;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK;YAAE,OAAO,IAAI,CAAC;QACrC,OAAO;YACL,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE;YACjB,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK;YACvB,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,OAAO;SAC5B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,EAAE,KAAK;YAAE,OAAO,EAAE,CAAC;QAC7B,OAAO,KAAK,CAAC,KAAK;aACf,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC;aACjE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACX,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC,CAAC;IACR,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,SAAmB;QACpC,2DAA2D;QAC3D,4BAA4B;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,SAAmB;QACtC,8DAA8D;IAChE,CAAC;IAED,aAAa;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IAED,kBAAkB;QAChB,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;CACF"}

package/dist/adapters/orchestration/interface.d.ts

@@ -0,0 +1,32 @@
+import type { SpecSummary, Stage, TaskSummary } from '../../broker/context-pack.js';
+/**
+ * Evidence recorded during a stage.
+ */
+export interface Evidence {
+    type: string;
+    description: string;
+    source: string;
+    data?: unknown;
+}
+/**
+ * Result of advancing to a new stage.
+ */
+export interface StageTransition {
+    from: Stage;
+    to: Stage;
+    reason: string;
+}
+/**
+ * Abstract interface for orchestration engines.
+ * Allows swapping between GSD-Lite and Superpowers.
+ */
+export interface OrchestrationAdapter {
+    getCurrentStage(): Promise<Stage | null>;
+    getActiveSpec(): Promise<SpecSummary | null>;
+    getActiveTasks(): Promise<TaskSummary[]>;
+    advanceStage(evidence: Evidence): Promise<StageTransition | null>;
+    recordEvidence(evidence: Evidence): Promise<void>;
+    getEngineName(): string;
+    getAvailableStages(): Stage[];
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/adapters/orchestration/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../../src/adapters/orchestration/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAEpF;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,KAAK,CAAC;IACZ,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IAEnC,eAAe,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;IACzC,aAAa,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAC7C,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAGzC,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAAC;IAClE,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGlD,aAAa,IAAI,MAAM,CAAC;IACxB,kBAAkB,IAAI,KAAK,EAAE,CAAC;CAC/B"}

package/dist/adapters/orchestration/interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interface.js.map

package/dist/adapters/orchestration/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../../src/adapters/orchestration/interface.ts"],"names":[],"mappings":""}

package/dist/adapters/orchestration/superpowers.d.ts

@@ -0,0 +1,33 @@
+import type { SpecSummary, Stage, TaskSummary } from '../../broker/context-pack.js';
+import type { Evidence, OrchestrationAdapter, StageTransition } from './interface.js';
+/**
+ * Superpowers orchestration adapter.
+ *
+ * Key insight: Superpowers is stateless — it doesn't track "current skill".
+ * All skills are always available, selection happens at request time.
+ *
+ * This adapter:
+ * - Discovers available skills from the plugin directory
+ * - Maps skill names to Stage types
+ * - Maintains a lightweight local stage state (in-memory)
+ *   since Superpowers itself doesn't persist this
+ */
+export declare class SuperpowersAdapter implements OrchestrationAdapter {
+    private currentStageValue;
+    private availableSkills;
+    constructor(_repoRoot: string);
+    private getPluginDir;
+    private discoverSkills;
+    getCurrentStage(): Promise<Stage | null>;
+    getActiveSpec(): Promise<SpecSummary | null>;
+    getActiveTasks(): Promise<TaskSummary[]>;
+    advanceStage(evidence: Evidence): Promise<StageTransition | null>;
+    recordEvidence(_evidence: Evidence): Promise<void>;
+    getEngineName(): string;
+    getAvailableStages(): Stage[];
+    /** Get list of discovered skills */
+    getSkills(): string[];
+    /** Manually set the current stage */
+    setStage(stage: Stage): void;
+}
+//# sourceMappingURL=superpowers.d.ts.map

package/dist/adapters/orchestration/superpowers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"superpowers.d.ts","sourceRoot":"","sources":["../../../src/adapters/orchestration/superpowers.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AACpF,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAgBtF;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAmB,YAAW,oBAAoB;IAC7D,OAAO,CAAC,iBAAiB,CAAsB;IAC/C,OAAO,CAAC,eAAe,CAAgB;gBAE3B,SAAS,EAAE,MAAM;IAI7B,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,cAAc;IAiBhB,eAAe,IAAI,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAMxC,aAAa,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAK5C,cAAc,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAKxC,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAajE,cAAc,CAAC,SAAS,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,aAAa,IAAI,MAAM;IAIvB,kBAAkB,IAAI,KAAK,EAAE;IAI7B,oCAAoC;IACpC,SAAS,IAAI,MAAM,EAAE;IAIrB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;CAG7B"}