@ginkoai/cli 1.6.2 → 1.7.1

package/dist/lib/rollback.js

@@ -0,0 +1,405 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [rollback, resilience, checkpoint, git, epic-004-sprint5, task-3]
+ * @related: [checkpoint.ts, event-logger.ts, orchestrator-state.ts]
+ * @priority: high
+ * @complexity: high
+ * @dependencies: [fs-extra, simple-git, checkpoint.ts]
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import simpleGit from 'simple-git';
+import { getGinkoDir, getProjectRoot } from '../utils/helpers.js';
+import { getCheckpoint } from './checkpoint.js';
+import { logEvent } from './event-logger.js';
+/**
+ * Get path to rollback history directory
+ */
+async function getRollbackHistoryDir() {
+    const ginkoDir = await getGinkoDir();
+    const rollbackDir = path.join(ginkoDir, 'rollbacks');
+    await fs.ensureDir(rollbackDir);
+    return rollbackDir;
+}
+/**
+ * Get path to rollback history file
+ */
+async function getRollbackHistoryPath() {
+    const rollbackDir = await getRollbackHistoryDir();
+    return path.join(rollbackDir, 'history.json');
+}
+/**
+ * Load rollback history from disk
+ */
+async function loadRollbackHistory() {
+    try {
+        const historyPath = await getRollbackHistoryPath();
+        if (!await fs.pathExists(historyPath)) {
+            return {
+                version: '1.0',
+                rollbacks: {},
+                last_updated: new Date().toISOString()
+            };
+        }
+        const history = await fs.readJSON(historyPath);
+        // Convert date strings back to Date objects
+        Object.values(history.rollbacks).forEach((entry) => {
+            entry.timestamp = new Date(entry.timestamp);
+            if (entry.undoneAt) {
+                entry.undoneAt = new Date(entry.undoneAt);
+            }
+        });
+        return history;
+    }
+    catch (error) {
+        console.warn('[ROLLBACK] Failed to load history:', error);
+        return {
+            version: '1.0',
+            rollbacks: {},
+            last_updated: new Date().toISOString()
+        };
+    }
+}
+/**
+ * Save rollback history to disk
+ */
+async function saveRollbackHistory(history) {
+    try {
+        const historyPath = await getRollbackHistoryPath();
+        history.last_updated = new Date().toISOString();
+        await fs.writeJSON(historyPath, history, { spaces: 2 });
+    }
+    catch (error) {
+        console.error('[ROLLBACK] Failed to save history:', error);
+        throw error;
+    }
+}
+/**
+ * Add rollback entry to history
+ */
+async function addToHistory(entry) {
+    const history = await loadRollbackHistory();
+    history.rollbacks[entry.id] = entry;
+    await saveRollbackHistory(history);
+}
+/**
+ * Generate rollback ID
+ * Format: rb_<timestamp>_<checkpointId>
+ */
+function generateRollbackId(checkpointId) {
+    const timestamp = Date.now();
+    return `rb_${timestamp}_${checkpointId}`;
+}
+/**
+ * Get current git commit hash
+ */
+async function getCurrentCommit() {
+    const projectRoot = await getProjectRoot();
+    const git = simpleGit(projectRoot);
+    const log = await git.log({ maxCount: 1 });
+    return log.latest?.hash || 'unknown';
+}
+/**
+ * Check if working directory is clean
+ */
+async function isWorkingDirectoryClean() {
+    const projectRoot = await getProjectRoot();
+    const git = simpleGit(projectRoot);
+    const status = await git.status();
+    return status.isClean();
+}
+/**
+ * Count changed files between two commits
+ */
+async function countChangedFiles(fromCommit, toCommit) {
+    const projectRoot = await getProjectRoot();
+    const git = simpleGit(projectRoot);
+    const diff = await git.diff(['--name-only', `${fromCommit}...${toCommit}`]);
+    return diff.split('\n').filter(line => line.trim().length > 0).length;
+}
+/**
+ * Release task for re-claiming
+ * Updates task status to 'available' by calling graph API
+ */
+async function releaseTask(taskId, agentId) {
+    try {
+        // Import agent client for task release
+        const { AgentClient } = await import('../commands/agent/agent-client.js');
+        // Call release endpoint
+        await AgentClient.releaseTask(taskId, agentId);
+        console.log(`[ROLLBACK] Released task ${taskId} for re-claiming`);
+    }
+    catch (error) {
+        // Log warning but don't fail rollback if task release fails
+        console.warn(`[ROLLBACK] Failed to release task ${taskId}:`, error instanceof Error ? error.message : String(error));
+    }
+}
+/**
+ * Rollback to a specific checkpoint
+ *
+ * Process:
+ * 1. Verify checkpoint exists
+ * 2. Stash current work (if dirty) with reference
+ * 3. Reset to checkpoint commit
+ * 4. Create rollback event
+ * 5. Release task for re-claiming
+ *
+ * @param checkpointId - Checkpoint ID to roll back to
+ * @param options - Rollback options
+ * @returns RollbackResult with success status and details
+ */
+export async function rollbackToCheckpoint(checkpointId, options) {
+    console.log(`[ROLLBACK] Starting rollback to checkpoint ${checkpointId}`);
+    try {
+        // 1. Verify checkpoint exists
+        const checkpoint = await getCheckpoint(checkpointId);
+        if (!checkpoint) {
+            return {
+                success: false,
+                checkpointId,
+                previousCommit: 'unknown',
+                rolledBackTo: 'unknown',
+                filesRestored: 0,
+                error: `Checkpoint ${checkpointId} not found`
+            };
+        }
+        console.log(`[ROLLBACK] Found checkpoint for task ${checkpoint.taskId}`);
+        console.log(`[ROLLBACK]   Target commit: ${checkpoint.gitCommit.substring(0, 7)}`);
+        // Get current commit before rollback
+        const previousCommit = await getCurrentCommit();
+        console.log(`[ROLLBACK]   Current commit: ${previousCommit.substring(0, 7)}`);
+        // Check if we're already at the target commit
+        if (previousCommit === checkpoint.gitCommit) {
+            console.log('[ROLLBACK] Already at target commit, no rollback needed');
+            return {
+                success: true,
+                checkpointId,
+                previousCommit,
+                rolledBackTo: checkpoint.gitCommit,
+                filesRestored: 0
+            };
+        }
+        const projectRoot = await getProjectRoot();
+        const git = simpleGit(projectRoot);
+        // 2. Check for dirty working directory
+        const isClean = await isWorkingDirectoryClean();
+        let stashRef;
+        if (!isClean) {
+            if (!options?.force) {
+                return {
+                    success: false,
+                    checkpointId,
+                    previousCommit,
+                    rolledBackTo: checkpoint.gitCommit,
+                    filesRestored: 0,
+                    error: 'Working directory has uncommitted changes. Use --force to stash and rollback.'
+                };
+            }
+            // Stash current work
+            console.log('[ROLLBACK] Stashing current work...');
+            const stashMessage = `pre-rollback-${checkpointId}`;
+            await git.stash(['push', '-m', stashMessage]);
+            // Get stash reference
+            const stashList = await git.stashList();
+            if (stashList.latest) {
+                stashRef = stashList.latest.hash; // Use the stash hash as reference
+                console.log(`[ROLLBACK] Stashed as: ${stashRef}`);
+            }
+        }
+        // 3. Verify target commit exists
+        try {
+            await git.revparse([checkpoint.gitCommit]);
+        }
+        catch (error) {
+            return {
+                success: false,
+                checkpointId,
+                previousCommit,
+                rolledBackTo: checkpoint.gitCommit,
+                filesRestored: 0,
+                error: `Target commit ${checkpoint.gitCommit} not found in repository`
+            };
+        }
+        // Count files that will change
+        const filesRestored = await countChangedFiles(previousCommit, checkpoint.gitCommit);
+        // 4. Reset to checkpoint commit
+        console.log(`[ROLLBACK] Resetting to commit ${checkpoint.gitCommit.substring(0, 7)}...`);
+        await git.checkout(checkpoint.gitCommit);
+        console.log(`[ROLLBACK] Successfully rolled back ${filesRestored} files`);
+        // 5. Create rollback event
+        try {
+            await logEvent({
+                category: 'git',
+                description: `Rolled back to checkpoint ${checkpointId} (commit ${checkpoint.gitCommit.substring(0, 7)}) from commit ${previousCommit.substring(0, 7)}. ${filesRestored} files restored.${options?.reason ? ` Reason: ${options.reason}` : ''}`,
+                impact: 'high',
+                files: checkpoint.filesModified,
+                commit_hash: checkpoint.gitCommit,
+                tags: ['rollback', 'checkpoint', checkpoint.taskId]
+            });
+        }
+        catch (error) {
+            console.warn('[ROLLBACK] Failed to create rollback event:', error);
+        }
+        // 6. Release task for re-claiming
+        try {
+            await releaseTask(checkpoint.taskId, checkpoint.agentId);
+        }
+        catch (error) {
+            console.warn('[ROLLBACK] Failed to release task:', error);
+        }
+        // 7. Record in rollback history
+        const rollbackId = generateRollbackId(checkpointId);
+        const rollbackEntry = {
+            id: rollbackId,
+            checkpointId,
+            taskId: checkpoint.taskId,
+            agentId: checkpoint.agentId,
+            timestamp: new Date(),
+            previousCommit,
+            rolledBackTo: checkpoint.gitCommit,
+            stashRef,
+            filesRestored,
+            reason: options?.reason,
+            undone: false
+        };
+        await addToHistory(rollbackEntry);
+        return {
+            success: true,
+            checkpointId,
+            stashRef,
+            previousCommit,
+            rolledBackTo: checkpoint.gitCommit,
+            filesRestored
+        };
+    }
+    catch (error) {
+        console.error('[ROLLBACK] Rollback failed:', error);
+        return {
+            success: false,
+            checkpointId,
+            previousCommit: 'unknown',
+            rolledBackTo: 'unknown',
+            filesRestored: 0,
+            error: error instanceof Error ? error.message : 'Unknown error during rollback'
+        };
+    }
+}
+/**
+ * Undo a rollback by applying the stashed changes
+ *
+ * @param stashRef - Git stash reference to apply
+ * @returns Success status and error message if failed
+ */
+export async function undoRollback(stashRef) {
+    console.log(`[ROLLBACK] Undoing rollback by applying stash ${stashRef}`);
+    try {
+        const projectRoot = await getProjectRoot();
+        const git = simpleGit(projectRoot);
+        // Verify stash exists
+        const stashList = await git.stashList();
+        const stashExists = stashList.all.some(stash => stash.hash === stashRef);
+        if (!stashExists) {
+            return {
+                success: false,
+                error: `Stash ${stashRef} not found`
+            };
+        }
+        // Check for clean working directory
+        const isClean = await isWorkingDirectoryClean();
+        if (!isClean) {
+            return {
+                success: false,
+                error: 'Working directory has uncommitted changes. Commit or stash changes before undoing rollback.'
+            };
+        }
+        // Apply stash
+        await git.stash(['apply', stashRef]);
+        console.log(`[ROLLBACK] Successfully applied stash ${stashRef}`);
+        // Log event
+        try {
+            await logEvent({
+                category: 'git',
+                description: `Undid rollback by applying stash ${stashRef}`,
+                impact: 'medium',
+                tags: ['rollback', 'undo']
+            });
+        }
+        catch (error) {
+            console.warn('[ROLLBACK] Failed to create undo event:', error);
+        }
+        // Update rollback history
+        const history = await loadRollbackHistory();
+        const rollbackEntry = Object.values(history.rollbacks).find(rb => rb.stashRef === stashRef && !rb.undone);
+        if (rollbackEntry) {
+            rollbackEntry.undone = true;
+            rollbackEntry.undoneAt = new Date();
+            await saveRollbackHistory(history);
+        }
+        return { success: true };
+    }
+    catch (error) {
+        console.error('[ROLLBACK] Undo failed:', error);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error during undo'
+        };
+    }
+}
+/**
+ * Get rollback history, optionally filtered by task ID
+ *
+ * @param taskId - Optional task ID to filter by
+ * @returns Array of rollback entries, sorted by timestamp (newest first)
+ */
+export async function getRollbackHistory(taskId) {
+    try {
+        const history = await loadRollbackHistory();
+        let rollbacks = Object.values(history.rollbacks);
+        // Filter by task ID if provided
+        if (taskId) {
+            rollbacks = rollbacks.filter(rb => rb.taskId === taskId);
+        }
+        // Sort by timestamp (newest first)
+        rollbacks.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+        return rollbacks;
+    }
+    catch (error) {
+        console.warn('[ROLLBACK] Failed to get rollback history:', error);
+        return [];
+    }
+}
+/**
+ * Get rollback entry by ID
+ */
+export async function getRollbackById(rollbackId) {
+    try {
+        const history = await loadRollbackHistory();
+        const rollback = history.rollbacks[rollbackId];
+        return rollback || null;
+    }
+    catch (error) {
+        console.warn(`[ROLLBACK] Failed to get rollback ${rollbackId}:`, error);
+        return null;
+    }
+}
+/**
+ * Clear rollback history (for testing)
+ */
+export async function clearRollbackHistory() {
+    try {
+        const historyPath = await getRollbackHistoryPath();
+        const emptyHistory = {
+            version: '1.0',
+            rollbacks: {},
+            last_updated: new Date().toISOString()
+        };
+        await fs.writeJSON(historyPath, emptyHistory, { spaces: 2 });
+    }
+    catch (error) {
+        console.error('[ROLLBACK] Failed to clear history:', error);
+        throw error;
+    }
+}
+//# sourceMappingURL=rollback.js.map

package/dist/lib/rollback.js.map

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

package/dist/lib/sprint-loader.d.ts

@@ -10,8 +10,32 @@
  */
 /**
  * Task state enumeration
+ * - todo: [ ] Not started
+ * - in_progress: [@] Currently being worked on
+ * - paused: [Z] Temporarily on hold (sleeping)
+ * - complete: [x] Finished
  */
-export type TaskState = 'todo' | 'in_progress' | 'complete';
+export type TaskState = 'todo' | 'in_progress' | 'paused' | 'complete';
+/**
+ * Acceptance criterion type - auto-detected from description (EPIC-004 Sprint 3)
+ * - test: Unit tests, specs, test suites
+ * - build: Compilation, build process
+ * - lint: Linting, code style checks
+ * - performance: Response time, latency metrics
+ * - manual: Human review, approval
+ * - custom: Other criteria with custom commands
+ */
+export type CriterionType = 'test' | 'build' | 'lint' | 'performance' | 'manual' | 'custom';
+/**
+ * Acceptance criterion for task verification (EPIC-004 Sprint 3)
+ */
+export interface AcceptanceCriterion {
+    id: string;
+    description: string;
+    type: CriterionType;
+    threshold?: number;
+    command?: string;
+}
 /**
  * Individual task from sprint checklist
  */
@@ -26,6 +50,8 @@ export interface Task {
     relatedADRs?: string[];
     relatedPatterns?: string[];
     relatedGotchas?: string[];
+    acceptanceCriteria?: AcceptanceCriterion[];
+    dependsOn?: string[];
 }
 /**
  * Sprint checklist with task states and progress
@@ -36,12 +62,14 @@ export interface SprintChecklist {
     progress: {
         complete: number;
         inProgress: number;
+        paused: number;
         todo: number;
         total: number;
     };
     tasks: Task[];
     currentTask?: Task;
     recentCompletions: Task[];
+    dependencyWarnings?: string[];
 }
 /**
  * Find active sprint file
@@ -50,6 +78,15 @@ export interface SprintChecklist {
  * 1. Check CURRENT-SPRINT.md for "Between Sprints" status → return null
  * 2. Check CURRENT-SPRINT.md for sprint reference → return that file
  * 3. Fall back to scanning SPRINT-*.md files for first incomplete one
+ *    - Respects frontmatter `status` field: active > not_started > (skip paused/complete)
+ *
+ * Valid status values:
+ * - active: Currently being worked on
+ * - not_started: Planned but not yet started
+ * - paused: Temporarily on hold (skipped by auto-detection)
+ * - complete: Finished (skipped by auto-detection)
+ * - proposed: Not yet approved (skipped by auto-detection)
+ * - abandoned: Cancelled (skipped by auto-detection)
  *
  * @param projectRoot - Project root directory
  * @returns Path to active sprint file or null (if between sprints)
@@ -61,7 +98,7 @@ export declare function findActiveSprint(projectRoot?: string): Promise<string |
  * Looks for:
  * - Sprint name from title (# SPRINT: ...)
  * - Tasks from ## Sprint Tasks or ### TASK-N sections
- * - Checkbox states: [ ], [@], [x]
+ * - Checkbox states: [ ], [@], [Z], [x]
  * - Task metadata (files, priority, effort)
  *
  * @param markdown - Sprint markdown content

package/dist/lib/sprint-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sprint-loader.d.ts","sourceRoot":"","sources":["../../src/lib/sprint-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,aAAa,GAAG,UAAU,CAAC;AAE5D;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,iBAAiB,EAAE,IAAI,EAAE,CAAC;CAC3B;AAiBD;;;;;;;;;;GAUG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqGnF;AAeD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAiKxF;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAe/F;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,eAAe,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAqD9F;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAmC3D"}
+{"version":3,"file":"sprint-loader.d.ts","sourceRoot":"","sources":["../../src/lib/sprint-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEvE;;;;;;;;GAQG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE5F;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,WAAW,CAAC,EAAE,IAAI,CAAC;IACnB,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B;AA0CD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,gBAAgB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAyInF;AA4JD;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,eAAe,CAmPxF;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAe/F;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,eAAe,EAAE,QAAQ,GAAE,MAAU,GAAG,MAAM,CAyD9F;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAmC3D"}