@ginkoai/cli 1.6.1 → 1.7.0

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

package/dist/commands/escalation/create.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [escalation, create, cli, epic-004, human-intervention]
+ * @related: [index.ts, escalation-client.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [commander, chalk, ora]
+ */
+interface CreateOptions {
+    task: string;
+    reason: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    agent?: string;
+}
+/**
+ * Create a new escalation
+ */
+export declare function createEscalationCommand(options: CreateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/escalation/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/escalation/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4BD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFnF"}

package/dist/commands/escalation/create.js

@@ -0,0 +1,122 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [escalation, create, cli, epic-004, human-intervention]
+ * @related: [index.ts, escalation-client.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [commander, chalk, ora]
+ */
+/**
+ * Create Escalation Command (EPIC-004 Sprint 5 TASK-7)
+ *
+ * Create a new escalation requesting human intervention
+ */
+import chalk from 'chalk';
+import ora from 'ora';
+import fs from 'fs/promises';
+import path from 'path';
+import { EscalationClient } from './escalation-client.js';
+import { requireGinkoRoot } from '../../utils/ginko-root.js';
+/**
+ * Load agent config from .ginko/agent.json
+ */
+async function loadAgentConfig() {
+    try {
+        const projectRoot = await requireGinkoRoot();
+        const agentConfigPath = path.join(projectRoot, '.ginko', 'agent.json');
+        const content = await fs.readFile(agentConfigPath, 'utf-8');
+        const config = JSON.parse(content);
+        if (!config.agentId) {
+            return null;
+        }
+        return config;
+    }
+    catch (error) {
+        return null;
+    }
+}
+/**
+ * Create a new escalation
+ */
+export async function createEscalationCommand(options) {
+    const spinner = ora('Creating escalation...').start();
+    try {
+        // Validate severity
+        if (!['low', 'medium', 'high', 'critical'].includes(options.severity)) {
+            spinner.fail(chalk.red('Failed to create escalation'));
+            console.error(chalk.red('  Severity must be one of: low, medium, high, critical'));
+            process.exit(1);
+        }
+        // Get agent ID
+        let agentId = options.agent;
+        if (!agentId) {
+            const agentConfig = await loadAgentConfig();
+            if (!agentConfig) {
+                spinner.fail(chalk.red('Failed to create escalation'));
+                console.error(chalk.red('  No agent found. Either:'));
+                console.error(chalk.red('    - Use --agent <agentId> to specify agent'));
+                console.error(chalk.red('    - Run "ginko agent register" to register current agent'));
+                process.exit(1);
+            }
+            agentId = agentConfig.agentId;
+        }
+        // Create escalation via API
+        const response = await EscalationClient.create({
+            taskId: options.task,
+            agentId,
+            reason: options.reason,
+            severity: options.severity,
+        });
+        if (!response.escalationId) {
+            spinner.fail(chalk.red('Failed to create escalation'));
+            console.error(chalk.red('  No escalation ID returned from API'));
+            process.exit(1);
+        }
+        spinner.succeed(chalk.green('Escalation created successfully'));
+        console.log('');
+        console.log(chalk.bold(`  ${response.reason}`));
+        console.log(chalk.dim(`  ID: ${response.escalationId}`));
+        console.log(chalk.dim(`  Task: ${response.taskId}`));
+        console.log(chalk.dim(`  Severity: ${response.severity}`));
+        console.log(chalk.dim(`  Status: ${response.status}`));
+        console.log(chalk.dim(`  Created: ${new Date(response.createdAt).toLocaleString()}`));
+        console.log('');
+        // Show severity-based guidance
+        if (response.severity === 'critical') {
+            console.log(chalk.red('⚠️  CRITICAL escalation - immediate attention required'));
+        }
+        else if (response.severity === 'high') {
+            console.log(chalk.yellow('⚠️  HIGH priority - requires prompt attention'));
+        }
+        console.log('');
+        console.log(chalk.dim('💡 Next steps:'));
+        console.log(chalk.dim('  ginko escalation list --status open    # View all open escalations'));
+        console.log(chalk.dim(`  ginko escalation resolve ${response.escalationId.substring(0, 20)}... --resolution "..."  # Resolve when ready`));
+    }
+    catch (error) {
+        spinner.fail(chalk.red('Failed to create escalation'));
+        // Handle specific error codes
+        if (error.message.includes('Not authenticated')) {
+            console.error(chalk.red('  Not authenticated. Run `ginko login` first.'));
+        }
+        else if (error.message.includes('MISSING_TASK_ID')) {
+            console.error(chalk.red('  Task ID is required'));
+        }
+        else if (error.message.includes('MISSING_AGENT_ID')) {
+            console.error(chalk.red('  Agent ID is required'));
+        }
+        else if (error.message.includes('MISSING_REASON')) {
+            console.error(chalk.red('  Reason is required'));
+        }
+        else if (error.message.includes('INVALID_SEVERITY')) {
+            console.error(chalk.red('  Invalid severity. Must be: low, medium, high, critical'));
+        }
+        else {
+            console.error(chalk.red(`  ${error.message}`));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/escalation/create.js.map

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

package/dist/commands/escalation/escalation-client.d.ts

@@ -0,0 +1,101 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [escalation, api, client, epic-004, human-intervention]
+ * @related: [create.ts, list.ts, resolve.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [auth-storage]
+ */
+interface CreateEscalationRequest {
+    taskId: string;
+    agentId: string;
+    reason: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    metadata?: Record<string, any>;
+}
+interface CreateEscalationResponse {
+    escalationId: string;
+    taskId: string;
+    agentId: string;
+    reason: string;
+    severity: string;
+    status: string;
+    organizationId: string;
+    createdAt: string;
+}
+interface ListEscalationsRequest {
+    status?: string;
+    severity?: string;
+    taskId?: string;
+    agentId?: string;
+    limit?: number;
+    offset?: number;
+}
+interface ListEscalationsResponse {
+    escalations: Array<{
+        id: string;
+        taskId: string;
+        agentId: string;
+        reason: string;
+        severity: string;
+        status: string;
+        organizationId: string;
+        createdAt: string;
+        acknowledgedAt?: string;
+        acknowledgedBy?: string;
+        resolvedAt?: string;
+        resolvedBy?: string;
+        resolution?: string;
+        metadata?: Record<string, any>;
+    }>;
+    total: number;
+    limit: number;
+    offset: number;
+}
+interface AcknowledgeResponse {
+    escalationId: string;
+    status: string;
+    acknowledgedAt: string;
+    acknowledgedBy: string;
+}
+interface ResolveResponse {
+    escalationId: string;
+    status: string;
+    resolvedAt: string;
+    resolvedBy: string;
+    resolution: string;
+}
+/**
+ * Escalation API client
+ */
+export declare class EscalationClient {
+    private static apiUrl;
+    /**
+     * Check if user is authenticated
+     */
+    private static requireAuth;
+    /**
+     * Make authenticated API request
+     */
+    private static request;
+    /**
+     * Create a new escalation
+     */
+    static create(data: CreateEscalationRequest): Promise<CreateEscalationResponse>;
+    /**
+     * List escalations with optional filtering
+     */
+    static list(params?: ListEscalationsRequest): Promise<ListEscalationsResponse>;
+    /**
+     * Acknowledge an escalation
+     */
+    static acknowledge(escalationId: string, acknowledgedBy: string): Promise<AcknowledgeResponse>;
+    /**
+     * Resolve an escalation
+     */
+    static resolve(escalationId: string, resolvedBy: string, resolution: string): Promise<ResolveResponse>;
+}
+export type { CreateEscalationResponse, ListEscalationsResponse, ResolveResponse };
+//# sourceMappingURL=escalation-client.d.ts.map

package/dist/commands/escalation/escalation-client.d.ts.map

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