@ginkoai/cli 2.0.5 → 2.1.0

package/dist/lib/pending-updates.js

@@ -0,0 +1,301 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-19
+ * @tags: [offline, queue, sync, EPIC-015]
+ * @related: [state-cache.ts, api-client.ts]
+ * @priority: medium
+ * @complexity: medium
+ * @dependencies: [fs-extra, path]
+ */
+/**
+ * Pending Updates Queue (EPIC-015 Sprint 2 Task 6)
+ *
+ * Provides offline queueing for status updates when API is unavailable:
+ * - Queue status updates when offline
+ * - Process queued updates when back online
+ * - "Local wins" conflict resolution (queued update takes precedence)
+ * - Max 3 retry attempts before permanent failure
+ *
+ * Queue location: .ginko/pending-updates.json
+ * Uses atomic writes (temp file + rename) to prevent partial writes.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { randomUUID } from 'crypto';
+import { getGinkoDir } from '../utils/helpers.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const QUEUE_FILE = 'pending-updates.json';
+const QUEUE_VERSION = 1;
+const MAX_ATTEMPTS = 3;
+// =============================================================================
+// Queue Management
+// =============================================================================
+/**
+ * Load pending updates from disk
+ *
+ * @returns Array of pending updates, empty array if no queue file exists
+ *
+ * @example
+ * ```typescript
+ * const updates = await loadPendingUpdates();
+ * console.log(`${updates.length} updates pending`);
+ * ```
+ */
+export async function loadPendingUpdates() {
+    try {
+        const queuePath = await getQueuePath();
+        if (!await fs.pathExists(queuePath)) {
+            return [];
+        }
+        const data = await fs.readJSON(queuePath);
+        // Validate queue structure
+        if (!isValidQueue(data)) {
+            return [];
+        }
+        return data.updates || [];
+    }
+    catch (error) {
+        // File doesn't exist, is invalid JSON, or other read error
+        return [];
+    }
+}
+/**
+ * Queue a status update for later sync
+ * Used when API call fails due to network error
+ *
+ * @param update - Update to queue (id, queued_at, attempts added automatically)
+ *
+ * @example
+ * ```typescript
+ * await queueUpdate({
+ *   type: 'task_status',
+ *   entity_id: 'e015_s02_t01',
+ *   new_status: 'complete'
+ * });
+ * ```
+ */
+export async function queueUpdate(update) {
+    const updates = await loadPendingUpdates();
+    // Check if there's already a pending update for this entity
+    // If so, replace it (latest update wins)
+    const existingIndex = updates.findIndex(u => u.entity_id === update.entity_id && u.type === update.type);
+    const newUpdate = {
+        id: randomUUID(),
+        ...update,
+        queued_at: new Date().toISOString(),
+        attempts: 0,
+    };
+    if (existingIndex >= 0) {
+        // Replace existing update for same entity
+        updates[existingIndex] = newUpdate;
+    }
+    else {
+        // Add new update
+        updates.push(newUpdate);
+    }
+    await saveQueue(updates);
+}
+/**
+ * Remove a specific update from the queue
+ *
+ * @param updateId - UUID of the update to remove
+ *
+ * @example
+ * ```typescript
+ * await removeUpdate('abc-123-def');
+ * ```
+ */
+export async function removeUpdate(updateId) {
+    const updates = await loadPendingUpdates();
+    const filtered = updates.filter(u => u.id !== updateId);
+    if (filtered.length !== updates.length) {
+        await saveQueue(filtered);
+    }
+}
+/**
+ * Clear all pending updates from the queue
+ *
+ * @example
+ * ```typescript
+ * await clearPendingUpdates();
+ * ```
+ */
+export async function clearPendingUpdates() {
+    try {
+        const queuePath = await getQueuePath();
+        if (await fs.pathExists(queuePath)) {
+            await fs.remove(queuePath);
+        }
+    }
+    catch (error) {
+        // Ignore errors when clearing queue
+    }
+}
+/**
+ * Check if there are pending updates
+ *
+ * @returns true if queue has at least one update
+ *
+ * @example
+ * ```typescript
+ * if (await hasPendingUpdates()) {
+ *   console.log('Pending updates need to sync');
+ * }
+ * ```
+ */
+export async function hasPendingUpdates() {
+    const updates = await loadPendingUpdates();
+    return updates.length > 0;
+}
+// =============================================================================
+// Sync Processing
+// =============================================================================
+/**
+ * Process all pending updates, syncing them to the API
+ *
+ * Processing logic:
+ * - Iterates oldest-first (FIFO order)
+ * - On success: removes update from queue
+ * - On failure: increments attempts, keeps in queue (max 3 attempts)
+ * - Conflict resolution: "local wins" (queued update takes precedence)
+ *
+ * @param client - Authenticated GraphApiClient instance
+ * @returns Counts of succeeded and failed updates
+ *
+ * @example
+ * ```typescript
+ * const client = new GraphApiClient();
+ * const result = await processPendingUpdates(client);
+ * console.log(`Synced ${result.succeeded}, failed ${result.failed}`);
+ * ```
+ */
+export async function processPendingUpdates(client) {
+    const updates = await loadPendingUpdates();
+    if (updates.length === 0) {
+        return { succeeded: 0, failed: 0 };
+    }
+    let succeeded = 0;
+    let failed = 0;
+    const remaining = [];
+    // Get graph ID from environment
+    const graphId = process.env.GINKO_GRAPH_ID || '';
+    if (!graphId) {
+        // Can't process without graph ID, keep all updates
+        return { succeeded: 0, failed: updates.length };
+    }
+    // Sort by queued_at to process oldest first
+    const sortedUpdates = [...updates].sort((a, b) => new Date(a.queued_at).getTime() - new Date(b.queued_at).getTime());
+    for (const update of sortedUpdates) {
+        try {
+            await processUpdate(client, graphId, update);
+            succeeded++;
+            // Don't add to remaining - it was successful
+        }
+        catch (error) {
+            // Increment attempts
+            update.attempts++;
+            if (update.attempts >= MAX_ATTEMPTS) {
+                // Max attempts reached, count as failed and don't keep
+                failed++;
+            }
+            else {
+                // Keep in queue for retry
+                remaining.push(update);
+                failed++;
+            }
+        }
+    }
+    // Save remaining updates (excluding succeeded and permanently failed)
+    await saveQueue(remaining);
+    return { succeeded, failed };
+}
+/**
+ * Process a single update by calling the appropriate API method
+ */
+async function processUpdate(client, graphId, update) {
+    switch (update.type) {
+        case 'task_status':
+            await client.updateTaskStatus(graphId, update.entity_id, update.new_status, update.reason);
+            break;
+        case 'sprint_status':
+            await client.updateSprintStatus(graphId, update.entity_id, update.new_status);
+            break;
+        case 'epic_status':
+            await client.updateEpicStatus(graphId, update.entity_id, update.new_status);
+            break;
+        default:
+            throw new Error(`Unknown update type: ${update.type}`);
+    }
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Get the full path to the queue file
+ */
+async function getQueuePath() {
+    const ginkoDir = await getGinkoDir();
+    return path.join(ginkoDir, QUEUE_FILE);
+}
+/**
+ * Save updates to queue file using atomic write
+ */
+async function saveQueue(updates) {
+    const queuePath = await getQueuePath();
+    const queueDir = path.dirname(queuePath);
+    const tempPath = `${queuePath}.tmp.${Date.now()}`;
+    // Ensure .ginko directory exists
+    await fs.ensureDir(queueDir);
+    const queue = {
+        version: QUEUE_VERSION,
+        updates,
+    };
+    // Atomic write: write to temp file, then rename
+    try {
+        await fs.writeJSON(tempPath, queue, { spaces: 2 });
+        await fs.rename(tempPath, queuePath);
+    }
+    catch (error) {
+        // Clean up temp file if rename failed
+        try {
+            await fs.remove(tempPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+}
+/**
+ * Validate that queue data has correct structure and version
+ */
+function isValidQueue(data) {
+    if (!data || typeof data !== 'object') {
+        return false;
+    }
+    const queue = data;
+    // Check version
+    if (queue.version !== QUEUE_VERSION) {
+        return false;
+    }
+    // Check updates array exists
+    if (!Array.isArray(queue.updates)) {
+        return false;
+    }
+    return true;
+}
+// =============================================================================
+// Exports for Testing
+// =============================================================================
+export const _internal = {
+    getQueuePath,
+    saveQueue,
+    isValidQueue,
+    processUpdate,
+    QUEUE_VERSION,
+    MAX_ATTEMPTS,
+};
+//# sourceMappingURL=pending-updates.js.map

package/dist/lib/pending-updates.js.map

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

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

@@ -1,21 +1,49 @@
 /**
  * @fileType: utility
  * @status: current
- * @updated: 2025-11-21
- * @tags: [sprint, task-checklist, epic-001, session-context]
- * @related: [charter-loader.ts, start-reflection.ts, context-loader-events.ts]
+ * @updated: 2026-01-19
+ * @tags: [sprint, task-content, epic-015, session-context]
+ * @related: [charter-loader.ts, start-reflection.ts, context-loader-events.ts, task-extractor.ts]
  * @priority: high
  * @complexity: medium
  * @dependencies: [fs-extra, path]
  */
 /**
- * Task state enumeration
+ * Task state enumeration (kept for backward compatibility)
+ * NOTE: As of EPIC-015 Sprint 2, status comes from the graph API.
+ * File parsing defaults all tasks to 'todo'. Merge with graph status at runtime.
  * - todo: [ ] Not started
  * - in_progress: [@] Currently being worked on
  * - paused: [Z] Temporarily on hold (sleeping)
  * - complete: [x] Finished
  */
 export type TaskState = 'todo' | 'in_progress' | 'paused' | 'complete';
+/**
+ * Task content extracted from sprint markdown (no status)
+ * Status comes from graph API and is merged at runtime.
+ */
+export interface TaskContent {
+    id: string;
+    title: string;
+    files?: string[];
+    effort?: string;
+    priority?: string;
+    relatedADRs?: string[];
+    relatedPatterns?: string[];
+    relatedGotchas?: string[];
+    acceptanceCriteria?: AcceptanceCriterion[];
+    dependsOn?: string[];
+}
+/**
+ * Sprint content extracted from markdown (no status-based progress)
+ * Status/progress comes from graph API and is merged at runtime.
+ */
+export interface SprintContent {
+    name: string;
+    file: string;
+    tasks: TaskContent[];
+    dependencyWarnings?: string[];
+}
 /**
  * Acceptance criterion type - auto-detected from description (EPIC-004 Sprint 3)
  * - test: Unit tests, specs, test suites
@@ -37,7 +65,9 @@ export interface AcceptanceCriterion {
     command?: string;
 }
 /**
- * Individual task from sprint checklist
+ * Individual task from sprint checklist (backward compatible interface)
+ * NOTE: As of EPIC-015 Sprint 2, state defaults to 'todo' from file parsing.
+ * Actual status should be merged from graph API at runtime.
  */
 export interface Task {
     id: string;
@@ -54,7 +84,9 @@ export interface Task {
     dependsOn?: string[];
 }
 /**
- * Sprint checklist with task states and progress
+ * Sprint checklist with task states and progress (backward compatible interface)
+ * NOTE: As of EPIC-015 Sprint 2, progress values will be zeroed from file parsing.
+ * Actual progress should be calculated from graph API status at runtime.
  */
 export interface SprintChecklist {
     name: string;
@@ -75,11 +107,12 @@ export interface SprintChecklist {
  * Find active sprint file
  *
  * Priority:
- * 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
+ * 1. Scan SPRINT-*.md files for first incomplete one
  *    - Respects frontmatter `status` field: active > not_started > (skip paused/complete)
  *
+ * EPIC-015 Sprint 3: CURRENT-SPRINT.md is deprecated. Sprint state now comes from
+ * the graph API, not from a local file. This function only scans actual sprint files.
+ *
  * Valid status values:
  * - active: Currently being worked on
  * - not_started: Planned but not yet started
@@ -93,25 +126,57 @@ export interface SprintChecklist {
  */
 export declare function findActiveSprint(projectRoot?: string): Promise<string | null>;
 /**
- * Parse sprint markdown into task checklist
+ * Parse sprint markdown into task checklist (backward compatible)
+ *
+ * EPIC-015 Sprint 2: Status parsing removed. All tasks default to 'todo'.
+ * Status should be merged from graph API at runtime.
  *
  * Looks for:
  * - Sprint name from title (# SPRINT: ...)
  * - Tasks from ## Sprint Tasks or ### TASK-N sections
- * - Checkbox states: [ ], [@], [Z], [x]
- * - Task metadata (files, priority, effort)
+ * - Task metadata (files, priority, effort, dependencies)
+ * - Related knowledge (ADRs, patterns, gotchas)
+ * - Acceptance criteria
  *
  * @param markdown - Sprint markdown content
  * @param filePath - Path to sprint file
- * @returns Parsed sprint checklist
+ * @returns Parsed sprint checklist (all tasks with state: 'todo')
  */
 export declare function parseSprintChecklist(markdown: string, filePath: string): SprintChecklist;
 /**
- * Load active sprint checklist
+ * Parse sprint markdown into content-only structure (no status)
+ *
+ * EPIC-015 Sprint 2: New content-focused parsing function.
+ * Extracts task content (ID, title, metadata, relationships) without status.
+ * Status should be fetched from graph API and merged separately.
+ *
+ * @param markdown - Sprint markdown content
+ * @param filePath - Path to sprint file
+ * @returns Parsed sprint content (no status information)
+ */
+export declare function parseSprintContent(markdown: string, filePath: string): SprintContent;
+/**
+ * Load active sprint content (no status)
+ *
+ * EPIC-015 Sprint 2: New content-focused loading function.
+ * Finds active sprint file and parses content without status.
+ * Status should be fetched from graph API and merged separately.
+ *
+ * @param projectRoot - Project root directory (defaults to git root)
+ * @param sprintFilePath - Optional specific sprint file path
+ * @returns Parsed sprint content or null if no sprint found
+ */
+export declare function loadSprintContent(projectRoot?: string, sprintFilePath?: string): Promise<SprintContent | null>;
+/**
+ * Load active sprint checklist (backward compatible)
+ *
+ * EPIC-015 Sprint 2: This function maintained for backward compatibility.
+ * All tasks will have state: 'todo'. Merge with graph API status at runtime.
  *
  * Finds active sprint file and parses into structured checklist
  *
  * @param projectRoot - Project root directory (defaults to git root)
+ * @param sprintFilePath - Optional specific sprint file path
  * @returns Parsed sprint checklist or null if no sprint found
  */
 export declare function loadSprintChecklist(projectRoot?: string, sprintFilePath?: string): Promise<SprintChecklist | null>;
@@ -146,6 +211,13 @@ export interface SprintProgressionInfo {
     totalSprints: number;
     completedSprints: number;
 }
+/**
+ * Find sprint file by ID
+ * @param sprintId - Sprint ID (e.g., 'e011_s01' or 'e016_s03')
+ * @param projectRoot - Project root directory
+ * @returns Path to sprint file or null if not found
+ */
+export declare function findSprintFileById(sprintId: string, projectRoot: string): Promise<string | null>;
 /**
  * Detect sprint progression and epic completion status
  *

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":"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"}
+{"version":3,"file":"sprint-loader.d.ts","sourceRoot":"","sources":["../../src/lib/sprint-loader.ts"],"names":[],"mappings":"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"}