@ginkoai/cli 2.0.6 → 2.1.0

package/dist/commands/sprint/status.js

@@ -0,0 +1,278 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2026-01-19
+ * @tags: [cli, sprint, status, graph-authoritative, epic-015]
+ * @related: [../graph/api-client.ts, index.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk, commander]
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import readline from 'readline';
+import { GraphApiClient } from '../graph/api-client.js';
+import { getGraphId } from '../graph/config.js';
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Get graph ID from config
+ */
+async function requireGraphId() {
+    const graphId = process.env.GINKO_GRAPH_ID || await getGraphId();
+    if (!graphId) {
+        console.error(chalk.red('✗ Graph not initialized'));
+        console.error(chalk.dim('  Run `ginko graph init` first'));
+        process.exit(1);
+    }
+    return graphId;
+}
+/**
+ * Prompt user for confirmation
+ */
+async function confirm(message) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        rl.question(`${message} [Y/n] `, (answer) => {
+            rl.close();
+            resolve(answer.toLowerCase() !== 'n');
+        });
+    });
+}
+/**
+ * Extract epic ID from sprint ID
+ * e.g., e015_s01 -> e015
+ */
+function extractEpicId(sprintId) {
+    const match = sprintId.match(/^(e\d+)_s\d+$/);
+    return match ? match[1] : null;
+}
+/**
+ * Check if all sprints in epic are complete and offer to complete epic
+ */
+async function checkEpicCompletion(client, graphId, epicId, skipPrompt) {
+    try {
+        const sprints = await client.getEpicSprints(graphId, epicId);
+        const allComplete = sprints.every(s => s.status === 'complete');
+        if (allComplete && sprints.length > 0) {
+            console.log(chalk.cyan(`\nAll sprints in ${epicId} are complete.`));
+            const shouldComplete = skipPrompt || await confirm('Mark epic complete?');
+            if (shouldComplete) {
+                await client.updateEpicStatus(graphId, epicId, 'complete');
+                console.log(chalk.green(`✓ Epic ${epicId} marked complete`));
+            }
+        }
+    }
+    catch (error) {
+        // Silently ignore cascade errors
+        if (process.env.GINKO_DEBUG_API === 'true') {
+            console.log(chalk.dim(`  Epic cascade check failed: ${error}`));
+        }
+    }
+}
+function formatStatus(status) {
+    switch (status) {
+        case 'complete':
+            return chalk.green('✓ complete');
+        case 'active':
+            return chalk.cyan('▶ active');
+        case 'paused':
+            return chalk.yellow('⏸ paused');
+        case 'planned':
+        default:
+            return chalk.dim('○ planned');
+    }
+}
+function handleError(action, sprintId, error) {
+    if (error instanceof Error) {
+        if (error.message.includes('SPRINT_NOT_FOUND') || error.message.includes('not found')) {
+            console.error(chalk.red(`✗ Sprint not found: ${sprintId}`));
+            console.error(chalk.dim('  Make sure the sprint ID is correct and exists in the graph'));
+        }
+        else if (error.message.includes('AUTH_REQUIRED')) {
+            console.error(chalk.red('✗ Authentication required'));
+            console.error(chalk.dim('  Run `ginko login` first'));
+        }
+        else if (error.message.includes('SERVICE_UNAVAILABLE')) {
+            console.error(chalk.red('✗ Graph database unavailable'));
+            console.error(chalk.dim('  Please try again later'));
+        }
+        else {
+            console.error(chalk.red(`✗ Failed to ${action} sprint: ${error.message}`));
+        }
+    }
+    else {
+        console.error(chalk.red(`✗ Failed to ${action} sprint`));
+    }
+    process.exit(1);
+}
+/**
+ * Start sprint (planned -> active)
+ */
+async function startSprintCommand(sprintId, options = {}) {
+    const graphId = await requireGraphId();
+    const client = new GraphApiClient();
+    try {
+        const current = await client.getSprintStatus(graphId, sprintId);
+        if (current.status === 'active') {
+            console.log(chalk.yellow(`Sprint ${sprintId} is already active (no change)`));
+            return;
+        }
+        const response = await client.updateSprintStatus(graphId, sprintId, 'active');
+        console.log(chalk.cyan(`▶ Sprint ${sprintId} started`));
+        if (response.sprint.name) {
+            console.log(chalk.dim(`  "${response.sprint.name}"`));
+        }
+    }
+    catch (error) {
+        handleError('start', sprintId, error);
+    }
+}
+/**
+ * Complete sprint (active -> complete)
+ */
+async function completeSprintCommand(sprintId, options = {}) {
+    const graphId = await requireGraphId();
+    const client = new GraphApiClient();
+    try {
+        const current = await client.getSprintStatus(graphId, sprintId);
+        if (current.status === 'complete') {
+            console.log(chalk.yellow(`Sprint ${sprintId} is already complete (no change)`));
+            return;
+        }
+        const response = await client.updateSprintStatus(graphId, sprintId, 'complete');
+        console.log(chalk.green(`✓ Sprint ${sprintId} marked complete`));
+        if (response.sprint.name) {
+            console.log(chalk.dim(`  "${response.sprint.name}"`));
+        }
+        // Cascade completion check
+        if (options.cascade) {
+            const epicId = extractEpicId(sprintId);
+            if (epicId) {
+                await checkEpicCompletion(client, graphId, epicId, !!options.yes);
+            }
+        }
+    }
+    catch (error) {
+        handleError('complete', sprintId, error);
+    }
+}
+/**
+ * Pause sprint (active -> paused)
+ */
+async function pauseSprintCommand(sprintId, options = {}) {
+    const graphId = await requireGraphId();
+    const client = new GraphApiClient();
+    try {
+        const current = await client.getSprintStatus(graphId, sprintId);
+        if (current.status === 'paused') {
+            console.log(chalk.yellow(`Sprint ${sprintId} is already paused (no change)`));
+            return;
+        }
+        const response = await client.updateSprintStatus(graphId, sprintId, 'paused');
+        console.log(chalk.yellow(`⏸ Sprint ${sprintId} paused`));
+        if (response.sprint.name) {
+            console.log(chalk.dim(`  "${response.sprint.name}"`));
+        }
+    }
+    catch (error) {
+        handleError('pause', sprintId, error);
+    }
+}
+/**
+ * Show sprint status
+ */
+async function showSprintCommand(sprintId, options = {}) {
+    const graphId = await requireGraphId();
+    const client = new GraphApiClient();
+    try {
+        const status = await client.getSprintStatus(graphId, sprintId);
+        console.log(chalk.bold(`Sprint: ${status.id}`));
+        console.log(`Status: ${formatStatus(status.status)}`);
+    }
+    catch (error) {
+        handleError('show', sprintId, error);
+    }
+}
+// =============================================================================
+// Command Factory
+// =============================================================================
+/**
+ * Create sprint status subcommand group
+ */
+export function createSprintStatusCommands() {
+    const status = new Command('status')
+        .description('Sprint status management (EPIC-015)')
+        .addHelpText('after', `
+${chalk.gray('Commands:')}
+  ${chalk.green('ginko sprint status start')} <id>     ${chalk.dim('Start sprint (planned -> active)')}
+  ${chalk.green('ginko sprint status complete')} <id>  ${chalk.dim('Complete sprint (active -> complete)')}
+  ${chalk.green('ginko sprint status pause')} <id>     ${chalk.dim('Pause sprint (active -> paused)')}
+  ${chalk.green('ginko sprint status show')} <id>      ${chalk.dim('Show current sprint status')}
+
+${chalk.gray('Shortcuts (without "status"):')}
+  ${chalk.green('ginko sprint start')} <id>
+  ${chalk.green('ginko sprint complete')} <id>
+  ${chalk.green('ginko sprint pause')} <id>
+
+${chalk.gray('Valid Sprint Statuses:')}
+  ${chalk.dim('planned   - Sprint not yet started (default)')}
+  ${chalk.dim('active    - Sprint in progress')}
+  ${chalk.dim('paused    - Sprint temporarily on hold')}
+  ${chalk.dim('complete  - Sprint finished')}
+`)
+        .action(() => {
+        status.help({ error: false });
+    });
+    status
+        .command('start <sprintId>')
+        .description('Start sprint (planned -> active)')
+        .option('-v, --verbose', 'Show detailed output')
+        .action(startSprintCommand);
+    status
+        .command('complete <sprintId>')
+        .description('Complete sprint')
+        .option('--cascade', 'Auto-complete parent epic if all sprints complete')
+        .option('--yes', 'Skip confirmation prompts')
+        .option('-v, --verbose', 'Show detailed output')
+        .action(completeSprintCommand);
+    status
+        .command('pause <sprintId>')
+        .description('Pause sprint (active -> paused)')
+        .option('-v, --verbose', 'Show detailed output')
+        .action(pauseSprintCommand);
+    status
+        .command('show <sprintId>')
+        .description('Show sprint status')
+        .option('-v, --verbose', 'Show detailed output')
+        .action(showSprintCommand);
+    return status;
+}
+/**
+ * Create shortcut commands for sprint status (without "status" prefix)
+ */
+export function addSprintStatusShortcuts(sprint) {
+    sprint
+        .command('start <sprintId>')
+        .description('Start sprint (shortcut for status start)')
+        .option('-v, --verbose', 'Show detailed output')
+        .action(startSprintCommand);
+    sprint
+        .command('complete <sprintId>')
+        .description('Complete sprint (shortcut for status complete)')
+        .option('--cascade', 'Auto-complete parent epic if all sprints complete')
+        .option('--yes', 'Skip confirmation prompts')
+        .option('-v, --verbose', 'Show detailed output')
+        .action(completeSprintCommand);
+    sprint
+        .command('pause <sprintId>')
+        .description('Pause sprint (shortcut for status pause)')
+        .option('-v, --verbose', 'Show detailed output')
+        .action(pauseSprintCommand);
+}
+export { startSprintCommand, completeSprintCommand, pauseSprintCommand, showSprintCommand, };
+//# sourceMappingURL=status.js.map

package/dist/commands/sprint/status.js.map

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

package/dist/commands/start/start-reflection.d.ts

@@ -31,6 +31,45 @@ export declare class StartReflectionCommand extends ReflectionCommand {
      * Handles both clean API responses and raw Neo4j node format
      */
     private convertGraphSprintToChecklist;
+    /**
+     * Load sprint state from graph API with cache fallback (EPIC-015 Sprint 2 Task 3)
+     *
+     * Data flow:
+     * 1. Try to fetch from graph API first
+     * 2. On success: save to cache for offline use
+     * 3. On failure: load from cache
+     *
+     * @param graphId - The graph namespace ID
+     * @returns Sprint data and source indicator ('graph' | 'cache' | null)
+     */
+    private loadSprintStateFromGraph;
+    /**
+     * Load sprint data from cache only (for offline fallback)
+     */
+    private loadFromCacheOnly;
+    /**
+     * Convert cached ActiveSprintData to SprintChecklist format
+     */
+    private convertCachedDataToChecklist;
+    /**
+     * Map graph API status string to TaskStatus enum
+     */
+    private mapGraphStatusToTaskStatus;
+    /**
+     * Map graph status to TaskState enum for SprintChecklist
+     */
+    private mapStatusToTaskState;
+    /**
+     * Merge graph status with local file content (EPIC-015 Sprint 2 Task 3)
+     *
+     * Graph API is authoritative for STATUS (progress, task states).
+     * Local file provides CONTENT (descriptions, acceptance criteria, ADRs).
+     *
+     * @param graphData - Status data from graph API (or cache)
+     * @param fileContent - Content from local sprint file
+     * @returns Merged SprintChecklist with graph status + file content
+     */
+    private mergeGraphStatusWithContent;
     /**
      * Override execute to process handoff and display session info
      */

package/dist/commands/start/start-reflection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"start-reflection.d.ts","sourceRoot":"","sources":["../../../src/commands/start/start-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAqDrE;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB;IAC3D,OAAO,CAAC,cAAc,CAAuB;;IAQ7C;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;;OAGG;YACW,kBAAkB;IAmChC;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IA8ErC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IA2V/D;;;;;OAKG;YACW,kBAAkB;IA6VhC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC;IA+BlC;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDlF;;OAEG;YACW,WAAW;IAuBzB;;OAEG;YACW,0BAA0B;IA2DxC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;YACW,aAAa;IAM3B;;OAEG;YACW,iBAAiB;IAU/B;;OAEG;YACW,WAAW;IAKzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA6BpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAmCpD;;OAEG;IACH,OAAO,CAAC,mBAAmB,CAAC,CAI1B;IAEF;;;;;OAKG;YACW,iBAAiB;IAwI/B;;;;;OAKG;YACW,cAAc;IAiJ5B;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;;;OAIG;YACW,cAAc;IAa5B;;OAEG;YACW,oBAAoB;IAuBlC;;;;;OAKG;YACW,kBAAkB;IA0BhC;;;;OAIG;YACW,oBAAoB;CAsDnC;AAGD,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"start-reflection.d.ts","sourceRoot":"","sources":["../../../src/commands/start/start-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAmErE;;;GAGG;AACH,qBAAa,sBAAuB,SAAQ,iBAAiB;IAC3D,OAAO,CAAC,cAAc,CAAuB;;IAQ7C;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;;OAGG;YACW,kBAAkB;IAmChC;;;;OAIG;IACH,OAAO,CAAC,6BAA6B;IA8ErC;;;;;;;;;;OAUG;YACW,wBAAwB;IA4DtC;;OAEG;YACW,iBAAiB;IAiB/B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IAoCpC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAalC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkB5B;;;;;;;;;OASG;IACH,OAAO,CAAC,2BAA2B;IAuDnC;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,GAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAwX/D;;;;;OAKG;YACW,kBAAkB;IA6VhC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,GAAG,CAAC;IA+BlC;;OAEG;IACG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAsDlF;;OAEG;YACW,WAAW;IAuBzB;;OAEG;YACW,0BAA0B;IA2DxC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAqB1B;;OAEG;YACW,aAAa;IAM3B;;OAEG;YACW,iBAAiB;IAU/B;;OAEG;YACW,WAAW;IAKzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAW5B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA6BpC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;OAEG;IACG,aAAa,CAAC,YAAY,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAmCpD;;OAEG;IACH,OAAO,CAAC,mBAAmB,CAAC,CAI1B;IAEF;;;;;OAKG;YACW,iBAAiB;IAwI/B;;;;;OAKG;YACW,cAAc;IA0J5B;;;;;;;OAOG;IACH,OAAO,CAAC,oBAAoB;IAmB5B;;;;OAIG;YACW,cAAc;IAa5B;;OAEG;YACW,oBAAoB;IAuBlC;;;;;OAKG;YACW,kBAAkB;IA0BhC;;;;OAIG;YACW,oBAAoB;CAsDnC;AAGD,eAAe,sBAAsB,CAAC"}