@ginkoai/cli 1.6.0 → 1.6.2

package/README.md

@@ -33,6 +33,19 @@ ginko status
 - `ginko start [sessionId]` - Start or resume a session
 - `ginko handoff [message]` - Create a session handoff
 - `ginko status` - Show current session status
+- `ginko log [description]` - Log events to session (ADR-033 defensive logging)
+
+### Planning & Organization
+- `ginko charter` - Create and manage project charter (AI-assisted)
+  - Default: Output template for AI-mediated conversation
+  - `--view` - View existing charter
+  - `--edit` - Edit charter conversationally
+  - `--no-ai` - Interactive CLI mode
+- `ginko epic` - Create and manage epics with sprint breakdown (AI-assisted)
+  - Default: Output template for AI-mediated conversation
+  - `--list` - List existing epics
+  - `--view` - View epic details with sprint progress
+  - `--sync` - Sync epic to graph database
 
 ### Context & Configuration
 - `ginko context` - Manage session context
@@ -180,6 +193,27 @@ ginko context --show                  # View tracked files
 ginko compact                          # Clean up old context
 ```
 
+### Planning with Epics
+```bash
+ginko epic                           # AI guides epic creation conversation
+# AI asks about goals, success criteria, scope, sprints
+# Creates docs/sprints/EPIC-XXX-name.md and sprint files
+
+ginko epic --list                    # List all epics
+ginko epic --view                    # View epic with sprint progress
+ginko epic --sync                    # Sync to graph database
+```
+
+### Project Charter
+```bash
+ginko charter                        # AI guides charter conversation
+# AI asks about purpose, users, success criteria, scope
+# Creates docs/PROJECT-CHARTER.md
+
+ginko charter --view                 # View existing charter
+ginko charter --edit                 # Refine charter conversationally
+```
+
 ## Future Features
 
 ### Persistent Context Modules (Coming Soon)

package/dist/commands/epic.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-11-25
+ * @tags: [epic, planning, sprint-creation, graph-sync]
+ * @related: [charter.ts, ../templates/epic-template.md]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk, fs, path]
+ */
+interface EpicOptions {
+    view?: boolean;
+    list?: boolean;
+    noAi?: boolean;
+    sync?: boolean;
+}
+/**
+ * Epic command - Create and manage epics with sprint breakdown
+ * Usage:
+ *   ginko epic             - Output template for AI-mediated creation (default)
+ *   ginko epic --no-ai     - Interactive mode (future)
+ *   ginko epic --list      - List existing epics
+ *   ginko epic --view      - View epic details
+ *   ginko epic --sync      - Sync epic to graph
+ */
+export declare function epicCommand(options?: EpicOptions): Promise<void>;
+export declare const epicExamples: string[];
+export {};
+//# sourceMappingURL=epic.d.ts.map

package/dist/commands/epic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic.d.ts","sourceRoot":"","sources":["../../src/commands/epic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAWH,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC1E;AA4UD,eAAO,MAAM,YAAY,UAKxB,CAAC"}

package/dist/commands/epic.js

@@ -0,0 +1,322 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-11-25
+ * @tags: [epic, planning, sprint-creation, graph-sync]
+ * @related: [charter.ts, ../templates/epic-template.md]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk, fs, path]
+ */
+import chalk from 'chalk';
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { existsSync } from 'fs';
+// ============================================================================
+// Main Command
+// ============================================================================
+/**
+ * Epic command - Create and manage epics with sprint breakdown
+ * Usage:
+ *   ginko epic             - Output template for AI-mediated creation (default)
+ *   ginko epic --no-ai     - Interactive mode (future)
+ *   ginko epic --list      - List existing epics
+ *   ginko epic --view      - View epic details
+ *   ginko epic --sync      - Sync epic to graph
+ */
+export async function epicCommand(options = {}) {
+    try {
+        const projectRoot = process.cwd();
+        // Handle --list flag
+        if (options.list) {
+            await listEpics(projectRoot);
+            return;
+        }
+        // Handle --view flag
+        if (options.view) {
+            await viewEpics(projectRoot);
+            return;
+        }
+        // Handle --sync flag
+        if (options.sync) {
+            await syncEpicToGraph(projectRoot);
+            return;
+        }
+        // Default: AI-mediated mode (output template) unless --no-ai specified
+        if (!options.noAi) {
+            await outputEpicTemplate();
+            return;
+        }
+        // --no-ai: Interactive mode (not yet implemented)
+        console.log(chalk.yellow('\n⚠️  Interactive epic creation not yet implemented'));
+        console.log(chalk.dim('   Use AI-mediated mode (default) for now\n'));
+    }
+    catch (error) {
+        console.error(chalk.red(`\n❌ Error: ${error.message}`));
+        process.exit(1);
+    }
+}
+// ============================================================================
+// Output Epic Template (AI-Mediated Mode)
+// ============================================================================
+/**
+ * Output epic template for AI-mediated creation
+ * The AI partner will read this, conduct a natural conversation, and create the epic
+ */
+async function outputEpicTemplate() {
+    const templatePath = new URL('../templates/epic-template.md', import.meta.url);
+    try {
+        const template = await fs.readFile(templatePath, 'utf-8');
+        // Output template to stdout (AI partner will read this)
+        console.log(template);
+    }
+    catch (error) {
+        console.error(chalk.red(`\n❌ Error reading epic template: ${error.message}`));
+        console.error(chalk.yellow('Template path:', templatePath.pathname));
+        process.exit(1);
+    }
+}
+// ============================================================================
+// List Epics
+// ============================================================================
+/**
+ * List all existing epics
+ */
+async function listEpics(projectRoot) {
+    const sprintsDir = path.join(projectRoot, 'docs', 'sprints');
+    if (!existsSync(sprintsDir)) {
+        console.log(chalk.yellow('\n📋 No epics found'));
+        console.log(chalk.dim('   Run `ginko epic` to create one\n'));
+        return;
+    }
+    try {
+        const files = await fs.readdir(sprintsDir);
+        const epicFiles = files.filter(f => f.startsWith('EPIC-') && f.endsWith('.md'));
+        if (epicFiles.length === 0) {
+            console.log(chalk.yellow('\n📋 No epics found'));
+            console.log(chalk.dim('   Run `ginko epic` to create one\n'));
+            return;
+        }
+        console.log(chalk.green('\n📋 Epics:\n'));
+        for (const file of epicFiles) {
+            const content = await fs.readFile(path.join(sprintsDir, file), 'utf-8');
+            const titleMatch = content.match(/^# (EPIC-\d+): (.+)$/m);
+            const statusMatch = content.match(/status: (\w+)/);
+            const progressMatch = content.match(/Progress.*?(\d+)%/i);
+            const epicId = titleMatch?.[1] || file.replace('.md', '');
+            const title = titleMatch?.[2] || 'Untitled';
+            const status = statusMatch?.[1] || 'unknown';
+            const progress = progressMatch?.[1] || '0';
+            const statusIcon = status === 'active' ? chalk.green('●') :
+                status === 'complete' ? chalk.blue('✓') :
+                    chalk.dim('○');
+            console.log(`  ${statusIcon} ${chalk.bold(epicId)}: ${title}`);
+            console.log(chalk.dim(`     Progress: ${progress}% | Status: ${status}`));
+            console.log('');
+        }
+        // List associated sprints
+        const sprintFiles = files.filter(f => f.startsWith('SPRINT-') && f.endsWith('.md'));
+        if (sprintFiles.length > 0) {
+            console.log(chalk.dim(`  📁 ${sprintFiles.length} sprint files in docs/sprints/\n`));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red(`\n❌ Error listing epics: ${error.message}`));
+    }
+}
+// ============================================================================
+// View Epic Details
+// ============================================================================
+/**
+ * View epic details with sprint breakdown
+ */
+async function viewEpics(projectRoot) {
+    const sprintsDir = path.join(projectRoot, 'docs', 'sprints');
+    if (!existsSync(sprintsDir)) {
+        console.log(chalk.yellow('\n📋 No epics found'));
+        console.log(chalk.dim('   Run `ginko epic` to create one\n'));
+        return;
+    }
+    try {
+        const files = await fs.readdir(sprintsDir);
+        const epicFiles = files.filter(f => f.startsWith('EPIC-') && f.endsWith('.md'));
+        if (epicFiles.length === 0) {
+            console.log(chalk.yellow('\n📋 No epics found'));
+            console.log(chalk.dim('   Run `ginko epic` to create one\n'));
+            return;
+        }
+        for (const file of epicFiles) {
+            const content = await fs.readFile(path.join(sprintsDir, file), 'utf-8');
+            // Parse epic header
+            const titleMatch = content.match(/^# (EPIC-\d+): (.+)$/m);
+            const goalMatch = content.match(/## Goal\n\n(.+?)(?=\n\n##|\n##|$)/s);
+            const successMatch = content.match(/## Success Criteria\n\n([\s\S]+?)(?=\n\n##|\n##|$)/);
+            const epicId = titleMatch?.[1] || file.replace('.md', '');
+            const title = titleMatch?.[2] || 'Untitled';
+            const goal = goalMatch?.[1]?.trim() || 'No goal defined';
+            console.log(chalk.green('\n╔════════════════════════════════════════════════════╗'));
+            console.log(chalk.green(`║  ${epicId}: ${title.substring(0, 40).padEnd(40)}  ║`));
+            console.log(chalk.green('╚════════════════════════════════════════════════════╝\n'));
+            console.log(chalk.bold('Goal:'));
+            console.log(chalk.dim(`  ${goal}\n`));
+            if (successMatch) {
+                console.log(chalk.bold('Success Criteria:'));
+                const criteria = successMatch[1].split('\n').filter(l => l.trim().startsWith('-'));
+                criteria.forEach(c => {
+                    const done = c.includes('[x]');
+                    const text = c.replace(/^-\s*\[.\]\s*/, '').trim();
+                    console.log(done ? chalk.green(`  ✓ ${text}`) : chalk.dim(`  ○ ${text}`));
+                });
+                console.log('');
+            }
+            // Find associated sprints
+            const epicPrefix = epicId.toLowerCase().replace('epic-', 'epic');
+            const associatedSprints = files.filter(f => f.startsWith('SPRINT-') &&
+                f.toLowerCase().includes(epicPrefix));
+            if (associatedSprints.length > 0) {
+                console.log(chalk.bold('Sprints:'));
+                for (const sprintFile of associatedSprints) {
+                    const sprintContent = await fs.readFile(path.join(sprintsDir, sprintFile), 'utf-8');
+                    const sprintTitleMatch = sprintContent.match(/^# SPRINT: (.+)$/m);
+                    const progressMatch = sprintContent.match(/\*\*Progress:\*\*\s*(\d+)%/);
+                    const sprintTitle = sprintTitleMatch?.[1] || sprintFile;
+                    const progress = progressMatch?.[1] || '0';
+                    const progressBar = createProgressBar(parseInt(progress));
+                    console.log(`  ${progressBar} ${sprintTitle}`);
+                }
+                console.log('');
+            }
+            console.log(chalk.dim(`📄 File: docs/sprints/${file}\n`));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red(`\n❌ Error viewing epics: ${error.message}`));
+    }
+}
+// ============================================================================
+// Sync Epic to Graph
+// ============================================================================
+/**
+ * Sync epic and sprints to graph database
+ */
+async function syncEpicToGraph(projectRoot) {
+    console.log(chalk.blue('\n📡 Syncing epic to graph...\n'));
+    // Check for graph configuration (in .ginko/graph/config.json)
+    const graphConfigPath = path.join(projectRoot, '.ginko', 'graph', 'config.json');
+    if (!existsSync(graphConfigPath)) {
+        console.log(chalk.yellow('⚠️  Graph not configured'));
+        console.log(chalk.dim('   Run `ginko graph init` first\n'));
+        return;
+    }
+    try {
+        // Read graph config
+        const graphConfig = JSON.parse(await fs.readFile(graphConfigPath, 'utf-8'));
+        const graphId = graphConfig.graphId;
+        if (!graphId) {
+            console.log(chalk.yellow('⚠️  No graph ID configured'));
+            console.log(chalk.dim('   Run `ginko graph init` to configure\n'));
+            return;
+        }
+        // Find epic files
+        const sprintsDir = path.join(projectRoot, 'docs', 'sprints');
+        const files = await fs.readdir(sprintsDir);
+        const epicFiles = files.filter(f => f.startsWith('EPIC-') && f.endsWith('.md'));
+        if (epicFiles.length === 0) {
+            console.log(chalk.yellow('📋 No epics to sync'));
+            return;
+        }
+        // Import API client dynamically to avoid circular deps
+        const { GraphApiClient } = await import('./graph/api-client.js');
+        const client = new GraphApiClient();
+        for (const file of epicFiles) {
+            const content = await fs.readFile(path.join(sprintsDir, file), 'utf-8');
+            const epicData = parseEpicContent(content);
+            console.log(chalk.dim(`  Syncing ${epicData.id}...`));
+            // Sync epic node
+            await client.syncEpic(epicData);
+            console.log(chalk.green(`  ✓ ${epicData.id}: ${epicData.title}`));
+            // Find and sync associated sprints
+            const epicPrefix = epicData.id.toLowerCase().replace('epic-', 'epic');
+            const sprintFiles = files.filter(f => f.startsWith('SPRINT-') &&
+                f.toLowerCase().includes(epicPrefix));
+            for (const sprintFile of sprintFiles) {
+                const sprintContent = await fs.readFile(path.join(sprintsDir, sprintFile), 'utf-8');
+                // Use existing sprint sync
+                await client.syncSprint(graphId, sprintContent);
+                const sprintName = sprintFile.replace('.md', '');
+                console.log(chalk.dim(`    ✓ ${sprintName}`));
+            }
+        }
+        console.log(chalk.green('\n✅ Epic sync complete!\n'));
+    }
+    catch (error) {
+        console.error(chalk.red(`\n❌ Sync failed: ${error.message}`));
+        console.log(chalk.dim('   Check graph connection and authentication\n'));
+    }
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Parse epic content from markdown
+ */
+function parseEpicContent(content) {
+    const titleMatch = content.match(/^# (EPIC-\d+): (.+)$/m);
+    const goalMatch = content.match(/## Goal\n\n(.+?)(?=\n\n##|\n##|$)/s);
+    const visionMatch = content.match(/## Vision\n\n(.+?)(?=\n\n##|\n##|$)/s);
+    const statusMatch = content.match(/status: (\w+)/);
+    // Parse success criteria
+    const successSection = content.match(/## Success Criteria\n\n([\s\S]+?)(?=\n\n##|\n##|$)/);
+    const successCriteria = successSection?.[1]
+        ?.split('\n')
+        .filter(l => l.trim().startsWith('-'))
+        .map(l => l.replace(/^-\s*\[.\]\s*/, '').trim()) || [];
+    // Calculate progress from checked items
+    const totalCriteria = successCriteria.length;
+    const completedCriteria = (successSection?.[1]?.match(/\[x\]/gi) || []).length;
+    const progress = totalCriteria > 0 ? Math.round((completedCriteria / totalCriteria) * 100) : 0;
+    // Parse scope
+    const inScopeMatch = content.match(/### In Scope\n([\s\S]+?)(?=\n###|\n##|$)/);
+    const outScopeMatch = content.match(/### Out of Scope\n([\s\S]+?)(?=\n###|\n##|$)/);
+    const inScope = inScopeMatch?.[1]
+        ?.split('\n')
+        .filter(l => l.trim().startsWith('-'))
+        .map(l => l.replace(/^-\s*/, '').trim()) || [];
+    const outOfScope = outScopeMatch?.[1]
+        ?.split('\n')
+        .filter(l => l.trim().startsWith('-'))
+        .map(l => l.replace(/^-\s*/, '').trim()) || [];
+    return {
+        id: titleMatch?.[1] || 'EPIC-000',
+        title: titleMatch?.[2] || 'Untitled Epic',
+        goal: goalMatch?.[1]?.trim() || '',
+        vision: visionMatch?.[1]?.trim() || '',
+        status: statusMatch?.[1] || 'active',
+        progress,
+        successCriteria,
+        inScope,
+        outOfScope,
+    };
+}
+/**
+ * Create a simple progress bar
+ */
+function createProgressBar(percent) {
+    const filled = Math.round(percent / 10);
+    const empty = 10 - filled;
+    const bar = '█'.repeat(filled) + '░'.repeat(empty);
+    const color = percent === 100 ? chalk.green :
+        percent >= 50 ? chalk.yellow :
+            chalk.dim;
+    return color(`[${bar}] ${percent}%`);
+}
+// ============================================================================
+// Export Examples
+// ============================================================================
+export const epicExamples = [
+    'ginko epic             # Create new epic via AI conversation',
+    'ginko epic --list      # List existing epics',
+    'ginko epic --view      # View epic details with sprints',
+    'ginko epic --sync      # Sync epic to graph database',
+];
+//# sourceMappingURL=epic.js.map

package/dist/commands/epic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"epic.js","sourceRoot":"","sources":["../../src/commands/epic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAahC,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,UAAuB,EAAE;IACzD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAElC,qBAAqB;QACrB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,qBAAqB;QACrB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,SAAS,CAAC,WAAW,CAAC,CAAC;YAC7B,OAAO;QACT,CAAC;QAED,qBAAqB;QACrB,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,eAAe,CAAC,WAAW,CAAC,CAAC;YACnC,OAAO;QACT,CAAC;QAED,uEAAuE;QACvE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClB,MAAM,kBAAkB,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,kDAAkD;QAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,qDAAqD,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6CAA6C,CAAC,CAAC,CAAC;IAExE,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,0CAA0C;AAC1C,+EAA+E;AAE/E;;;GAGG;AACH,KAAK,UAAU,kBAAkB;IAC/B,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,+BAA+B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAE/E,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAE1D,wDAAwD;QACxD,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAExB,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,oCAAoC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9E,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,gBAAgB,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;GAEG;AACH,KAAK,UAAU,SAAS,CAAC,WAAmB;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAE7D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAEhF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;QAE1C,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACxE,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC1D,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;YACnD,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,CAAC;YAE1D,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1D,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC;YAC5C,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;YAC7C,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;YAE3C,MAAM,UAAU,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;gBACxC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;oBACzC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAElC,OAAO,CAAC,GAAG,CAAC,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,QAAQ,eAAe,MAAM,EAAE,CAAC,CAAC,CAAC;YAC1E,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAClB,CAAC;QAED,0BAA0B;QAC1B,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACpF,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,WAAW,CAAC,MAAM,kCAAkC,CAAC,CAAC,CAAC;QACvF,CAAC;IAEH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,KAAK,UAAU,SAAS,CAAC,WAAmB;IAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;IAE7D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;QACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAEhF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC,CAAC;YAC9D,OAAO;QACT,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YAExE,oBAAoB;YACpB,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;YAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;YACtE,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;YAEzF,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1D,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC;YAC5C,MAAM,IAAI,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,iBAAiB,CAAC;YAEzD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC,CAAC;YACrF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,MAAM,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC;YAClF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC,CAAC;YAErF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC;YAEtC,IAAI,YAAY,EAAE,CAAC;gBACjB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,CAAC;gBAC7C,MAAM,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;gBACnF,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;oBACnB,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;oBAC/B,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;oBACnD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;gBAC5E,CAAC,CAAC,CAAC;gBACH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;YAED,0BAA0B;YAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACjE,MAAM,iBAAiB,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACzC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;gBACvB,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CACrC,CAAC;YAEF,IAAI,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;gBACpC,KAAK,MAAM,UAAU,IAAI,iBAAiB,EAAE,CAAC;oBAC3C,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;oBACpF,MAAM,gBAAgB,GAAG,aAAa,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;oBAClE,MAAM,aAAa,GAAG,aAAa,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;oBACxE,MAAM,WAAW,GAAG,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC;oBACxD,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC;oBAE3C,MAAM,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;oBAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,WAAW,IAAI,WAAW,EAAE,CAAC,CAAC;gBACjD,CAAC;gBACD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;YAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,IAAI,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;IAEH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;GAEG;AACH,KAAK,UAAU,eAAe,CAAC,WAAmB;IAChD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC,CAAC;IAE3D,8DAA8D;IAC9D,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;IACjF,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,0BAA0B,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,mCAAmC,CAAC,CAAC,CAAC;QAC5D,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,oBAAoB;QACpB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5E,MAAM,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC;QAEpC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,4BAA4B,CAAC,CAAC,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0CAA0C,CAAC,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,kBAAkB;QAClB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAEhF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC,CAAC;YACjD,OAAO;QACT,CAAC;QAED,uDAAuD;QACvD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QACjE,MAAM,MAAM,GAAG,IAAI,cAAc,EAAE,CAAC;QAEpC,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;YAC7B,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;YACxE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;YAE3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,QAAQ,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;YAEtD,iBAAiB;YACjB,MAAM,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAEhC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAElE,mCAAmC;YACnC,MAAM,UAAU,GAAG,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACtE,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACnC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;gBACvB,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CACrC,CAAC;YAEF,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;gBACrC,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,CAAC;gBAEpF,2BAA2B;gBAC3B,MAAM,MAAM,CAAC,UAAU,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;gBAEhD,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;gBACjD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,UAAU,EAAE,CAAC,CAAC,CAAC;YAChD,CAAC;QACH,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC,CAAC;IAExD,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gDAAgD,CAAC,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAAe;IAWvC,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC1D,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,oCAAoC,CAAC,CAAC;IACtE,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1E,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IAEnD,yBAAyB;IACzB,MAAM,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC,oDAAoD,CAAC,CAAC;IAC3F,MAAM,eAAe,GAAG,cAAc,EAAE,CAAC,CAAC,CAAC;QACzC,EAAE,KAAK,CAAC,IAAI,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAEzD,wCAAwC;IACxC,MAAM,aAAa,GAAG,eAAe,CAAC,MAAM,CAAC;IAC7C,MAAM,iBAAiB,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;IAC/E,MAAM,QAAQ,GAAG,aAAa,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,iBAAiB,GAAG,aAAa,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE/F,cAAc;IACd,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC/E,MAAM,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAEpF,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC,CAAC,CAAC;QAC/B,EAAE,KAAK,CAAC,IAAI,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAEjD,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC,CAAC,CAAC;QACnC,EAAE,KAAK,CAAC,IAAI,CAAC;SACZ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SACrC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;IAEjD,OAAO;QACL,EAAE,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,UAAU;QACjC,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,eAAe;QACzC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;QAClC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE;QACtC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,QAAQ;QACpC,QAAQ;QACR,eAAe;QACf,OAAO;QACP,UAAU;KACX,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,OAAe;IACxC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;IACxC,MAAM,KAAK,GAAG,EAAE,GAAG,MAAM,CAAC;IAC1B,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAG,OAAO,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC9B,KAAK,CAAC,GAAG,CAAC;IAExB,OAAO,KAAK,CAAC,IAAI,GAAG,KAAK,OAAO,GAAG,CAAC,CAAC;AACvC,CAAC;AAED,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,8DAA8D;IAC9D,8CAA8C;IAC9C,yDAAyD;IACzD,sDAAsD;CACvD,CAAC"}

package/dist/commands/graph/api-client.d.ts

@@ -218,6 +218,236 @@ export declare class GraphApiClient {
     createEvents(graphId: string, events: any[]): Promise<{
         created: number;
     }>;
+    /**
+     * Get ADR constraints for a task (EPIC-002 Phase 1)
+     * Returns MUST_FOLLOW relationships between task and ADRs
+     */
+    getTaskConstraints(taskId: string): Promise<TaskConstraintsResponse>;
+    /**
+     * Get patterns for a task (EPIC-002 Sprint 3)
+     * Returns APPLIES_PATTERN relationships with confidence scores
+     */
+    getTaskPatterns(taskId: string): Promise<TaskPatternsResponse>;
+    /**
+     * Get gotchas for a task (EPIC-002 Sprint 3)
+     * Returns AVOID_GOTCHA relationships with severity and resolution stats
+     */
+    getTaskGotchas(taskId: string): Promise<TaskGotchasResponse>;
+    /**
+     * Record a gotcha encounter (EPIC-002 Sprint 3 TASK-4)
+     * Called when `ginko log --category=gotcha` references a gotcha
+     *
+     * @param gotchaId - The gotcha ID to increment encounter count
+     * @param context - Optional context about the encounter
+     * @returns Updated gotcha stats including effectiveness score
+     */
+    recordGotchaEncounter(gotchaId: string, context?: {
+        description?: string;
+        sessionId?: string;
+        commitHash?: string;
+    }): Promise<GotchaEncounterResponse>;
+    /**
+     * Resolve a gotcha (EPIC-002 Sprint 3 TASK-4)
+     * Links the gotcha to a fix commit
+     *
+     * @param gotchaId - The gotcha ID to mark as resolved
+     * @param data - Resolution details including commit hash
+     * @returns Updated gotcha stats
+     */
+    resolveGotcha(gotchaId: string, data: {
+        commitHash: string;
+        description?: string;
+        sessionId?: string;
+        files?: string[];
+    }): Promise<GotchaResolveResponse>;
+    /**
+     * Get gotcha resolution history (EPIC-002 Sprint 3 TASK-4)
+     *
+     * @param gotchaId - The gotcha ID to get history for
+     * @returns Gotcha stats and resolution history
+     */
+    getGotchaResolutions(gotchaId: string): Promise<GotchaResolutionsResponse>;
+    /**
+     * Sync an epic to the graph database
+     * Creates Epic node with relationships to sprints
+     */
+    syncEpic(epicData: EpicSyncData): Promise<EpicSyncResponse>;
+    /**
+     * Sync a sprint to the graph database
+     * Creates Sprint and Task nodes with relationships
+     */
+    syncSprint(graphId: string, sprintContent: string): Promise<SprintSyncResponse>;
+}
+/**
+ * Gotcha encounter response (EPIC-002 Sprint 3 TASK-4)
+ */
+export interface GotchaEncounterResponse {
+    gotcha: {
+        id: string;
+        encounters: number;
+        resolutions: number;
+        effectivenessScore: number;
+    };
+    encounter: {
+        timestamp: string;
+        description?: string;
+    };
+}
+/**
+ * Gotcha resolve response (EPIC-002 Sprint 3 TASK-4)
+ */
+export interface GotchaResolveResponse {
+    gotcha: {
+        id: string;
+        encounters: number;
+        resolutions: number;
+        effectivenessScore: number;
+    };
+    resolution: {
+        timestamp: string;
+        commitHash: string;
+        description?: string;
+    };
+}
+/**
+ * Gotcha resolutions response (EPIC-002 Sprint 3 TASK-4)
+ */
+export interface GotchaResolutionsResponse {
+    gotcha: {
+        id: string;
+        title: string;
+        encounters: number;
+        resolutions: number;
+        effectivenessScore: number;
+    };
+    resolutionHistory: Array<{
+        commitHash: string;
+        timestamp: string;
+        description?: string;
+        sessionId?: string;
+        files?: string[];
+    }>;
+}
+/**
+ * Task constraints response from API (EPIC-002 Phase 1)
+ */
+export interface TaskConstraintsResponse {
+    task: {
+        id: string;
+        title: string;
+        status: string;
+    };
+    constraints: Array<{
+        adr: {
+            id: string;
+            title: string;
+            status: string;
+            summary: string;
+            filePath?: string;
+        };
+        relationship: {
+            source: string;
+            extracted_at: string;
+        };
+    }>;
+    count: number;
+}
+/**
+ * Task patterns response from API (EPIC-002 Sprint 3)
+ */
+export interface TaskPatternsResponse {
+    task: {
+        id: string;
+        title: string;
+        status: string;
+    };
+    patterns: Array<{
+        pattern: {
+            id: string;
+            title: string;
+            category: string;
+            confidence: 'high' | 'medium' | 'low';
+            confidenceScore: number;
+            usageCount: number;
+            content?: string;
+        };
+        relationship: {
+            source: string;
+            extracted_at: string;
+        };
+        usages: Array<{
+            fileId: string;
+            context?: string;
+        }>;
+    }>;
+    count: number;
+}
+/**
+ * Task gotchas response from API (EPIC-002 Sprint 3)
+ */
+export interface TaskGotchasResponse {
+    task: {
+        id: string;
+        title: string;
+        status: string;
+    };
+    gotchas: Array<{
+        gotcha: {
+            id: string;
+            title: string;
+            severity: 'critical' | 'high' | 'medium' | 'low';
+            confidence: 'high' | 'medium' | 'low';
+            confidenceScore: number;
+            symptom?: string;
+            cause?: string;
+            solution?: string;
+        };
+        relationship: {
+            source: string;
+            extracted_at: string;
+        };
+        stats: {
+            encounters: number;
+            resolutions: number;
+            resolutionRate: number;
+        };
+    }>;
+    count: number;
+}
+/**
+ * Sync an epic to the graph database
+ */
+export interface EpicSyncData {
+    id: string;
+    title: string;
+    goal: string;
+    vision: string;
+    status: string;
+    progress: number;
+    successCriteria: string[];
+    inScope: string[];
+    outOfScope: string[];
+}
+export interface EpicSyncResponse {
+    success: boolean;
+    epic: {
+        id: string;
+        title: string;
+        status: string;
+    };
+    nodesCreated: number;
+    relationshipsCreated: number;
+}
+export interface SprintSyncResponse {
+    success: boolean;
+    sprint: {
+        id: string;
+        name: string;
+        progress: number;
+    };
+    nodes: number;
+    relationships: number;
+    nextTask?: string;
 }
 /**
  * Helper function to create graph events with default client