@ginkoai/cli 2.0.5 → 2.1.0

package/dist/lib/state-cache.d.ts

@@ -0,0 +1,142 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-19
+ * @tags: [cache, offline, state, EPIC-015]
+ * @related: [staleness-detector.ts, user-sprint.ts, start-reflection.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path]
+ */
+/**
+ * Data about the active sprint for display
+ */
+export interface ActiveSprintData {
+    sprintId: string;
+    sprintName: string;
+    epicId: string;
+    epicName?: string;
+    progress: {
+        completed: number;
+        total: number;
+        percentage: number;
+    };
+    currentTask?: {
+        taskId: string;
+        taskName: string;
+        status: 'pending' | 'in_progress' | 'completed';
+    };
+    nextTask?: {
+        taskId: string;
+        taskName: string;
+    };
+}
+/**
+ * Cached state structure
+ */
+export interface StateCache {
+    version: 1;
+    fetched_at: string;
+    graph_id: string;
+    active_sprint: ActiveSprintData;
+}
+/**
+ * Result of checking cache staleness
+ */
+export interface CacheStalenessResult {
+    level: 'fresh' | 'stale' | 'expired';
+    age: number;
+    ageHuman: string;
+    isFresh: boolean;
+    showWarning: boolean;
+}
+/**
+ * Load cached state from disk
+ *
+ * @returns StateCache if valid cache exists, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const cache = await loadStateCache();
+ * if (cache) {
+ *   console.log(`Sprint: ${cache.active_sprint.sprintName}`);
+ * }
+ * ```
+ */
+export declare function loadStateCache(): Promise<StateCache | null>;
+/**
+ * Save state data to cache
+ * Uses atomic write (temp file + rename) to prevent partial writes
+ *
+ * @param data - Active sprint data to cache
+ * @param graphId - The graph ID this data belongs to
+ *
+ * @example
+ * ```typescript
+ * await saveStateCache(sprintData, 'graph-123');
+ * ```
+ */
+export declare function saveStateCache(data: ActiveSprintData, graphId: string): Promise<void>;
+/**
+ * Clear the state cache
+ * Called when cache should be invalidated (e.g., logout, graph switch)
+ *
+ * @example
+ * ```typescript
+ * await clearStateCache();
+ * ```
+ */
+export declare function clearStateCache(): Promise<void>;
+/**
+ * Check staleness of cached state
+ *
+ * Staleness levels:
+ * - fresh: < 5 minutes old
+ * - stale: 5 minutes to 24 hours old
+ * - expired: > 24 hours old
+ *
+ * @param cache - The cached state to check
+ * @returns Staleness result with level, age, and display info
+ *
+ * @example
+ * ```typescript
+ * const cache = await loadStateCache();
+ * if (cache) {
+ *   const staleness = checkCacheStaleness(cache);
+ *   if (staleness.showWarning) {
+ *     console.log(`Cache is ${staleness.level}: ${staleness.ageHuman}`);
+ *   }
+ * }
+ * ```
+ */
+export declare function checkCacheStaleness(cache: StateCache): CacheStalenessResult;
+/**
+ * Format cache age for human-readable display
+ *
+ * @param fetchedAt - ISO timestamp string
+ * @returns Human-readable age string (e.g., "15 min ago", "2 hours ago")
+ *
+ * @example
+ * ```typescript
+ * const age = formatCacheAge('2026-01-19T10:00:00.000Z');
+ * // Returns something like "15 min ago"
+ * ```
+ */
+export declare function formatCacheAge(fetchedAt: string): string;
+/**
+ * Get the full path to the cache file
+ */
+declare function getCachePath(): Promise<string>;
+/**
+ * Validate that cache data has correct structure and version
+ */
+declare function isValidCache(data: unknown): data is StateCache;
+export declare const _internal: {
+    getCachePath: typeof getCachePath;
+    isValidCache: typeof isValidCache;
+    FRESH_THRESHOLD_MS: number;
+    EXPIRED_THRESHOLD_MS: number;
+    CACHE_VERSION: number;
+};
+export {};
+//# sourceMappingURL=state-cache.d.ts.map

package/dist/lib/state-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-cache.d.ts","sourceRoot":"","sources":["../../src/lib/state-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAsBH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QACR,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,WAAW,CAAC,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,WAAW,CAAC;KACjD,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,CAAC,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,gBAAgB,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;CACtB;AAiBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAoBjE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,gBAAgB,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CA4Bf;AAED;;;;;;;;GAQG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAUrD;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,oBAAoB,CAsB3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAwBxD;AAMD;;GAEG;AACH,iBAAe,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAG7C;AAED;;GAEG;AACH,iBAAS,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,UAAU,CAsCvD;AAMD,eAAO,MAAM,SAAS;;;;;;CAMrB,CAAC"}

package/dist/lib/state-cache.js

@@ -0,0 +1,259 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-19
+ * @tags: [cache, offline, state, EPIC-015]
+ * @related: [staleness-detector.ts, user-sprint.ts, start-reflection.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path]
+ */
+/**
+ * Local State Cache (EPIC-015 Sprint 2)
+ *
+ * Provides local caching for API state data to enable:
+ * - Offline operation when API is unavailable
+ * - Faster startup by avoiding API calls for fresh data
+ * - Graceful degradation with staleness indicators
+ *
+ * Cache location: .ginko/state-cache.json
+ * Uses atomic writes (temp file + rename) to prevent partial writes.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { getGinkoDir } from '../utils/helpers.js';
+// =============================================================================
+// Constants
+// =============================================================================
+const CACHE_FILE = 'state-cache.json';
+const CACHE_VERSION = 1;
+// Staleness thresholds in milliseconds
+const FRESH_THRESHOLD_MS = 5 * 60 * 1000; // 5 minutes
+const EXPIRED_THRESHOLD_MS = 24 * 60 * 60 * 1000; // 24 hours
+// =============================================================================
+// Main API
+// =============================================================================
+/**
+ * Load cached state from disk
+ *
+ * @returns StateCache if valid cache exists, null otherwise
+ *
+ * @example
+ * ```typescript
+ * const cache = await loadStateCache();
+ * if (cache) {
+ *   console.log(`Sprint: ${cache.active_sprint.sprintName}`);
+ * }
+ * ```
+ */
+export async function loadStateCache() {
+    try {
+        const cachePath = await getCachePath();
+        if (!await fs.pathExists(cachePath)) {
+            return null;
+        }
+        const data = await fs.readJSON(cachePath);
+        // Validate cache version and required fields
+        if (!isValidCache(data)) {
+            return null;
+        }
+        return data;
+    }
+    catch (error) {
+        // File doesn't exist, is invalid JSON, or other read error
+        return null;
+    }
+}
+/**
+ * Save state data to cache
+ * Uses atomic write (temp file + rename) to prevent partial writes
+ *
+ * @param data - Active sprint data to cache
+ * @param graphId - The graph ID this data belongs to
+ *
+ * @example
+ * ```typescript
+ * await saveStateCache(sprintData, 'graph-123');
+ * ```
+ */
+export async function saveStateCache(data, graphId) {
+    const cachePath = await getCachePath();
+    const cacheDir = path.dirname(cachePath);
+    const tempPath = `${cachePath}.tmp.${Date.now()}`;
+    // Ensure .ginko directory exists
+    await fs.ensureDir(cacheDir);
+    const cache = {
+        version: CACHE_VERSION,
+        fetched_at: new Date().toISOString(),
+        graph_id: graphId,
+        active_sprint: data,
+    };
+    // Atomic write: write to temp file, then rename
+    try {
+        await fs.writeJSON(tempPath, cache, { spaces: 2 });
+        await fs.rename(tempPath, cachePath);
+    }
+    catch (error) {
+        // Clean up temp file if rename failed
+        try {
+            await fs.remove(tempPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+}
+/**
+ * Clear the state cache
+ * Called when cache should be invalidated (e.g., logout, graph switch)
+ *
+ * @example
+ * ```typescript
+ * await clearStateCache();
+ * ```
+ */
+export async function clearStateCache() {
+    try {
+        const cachePath = await getCachePath();
+        if (await fs.pathExists(cachePath)) {
+            await fs.remove(cachePath);
+        }
+    }
+    catch (error) {
+        // Ignore errors when clearing cache
+    }
+}
+/**
+ * Check staleness of cached state
+ *
+ * Staleness levels:
+ * - fresh: < 5 minutes old
+ * - stale: 5 minutes to 24 hours old
+ * - expired: > 24 hours old
+ *
+ * @param cache - The cached state to check
+ * @returns Staleness result with level, age, and display info
+ *
+ * @example
+ * ```typescript
+ * const cache = await loadStateCache();
+ * if (cache) {
+ *   const staleness = checkCacheStaleness(cache);
+ *   if (staleness.showWarning) {
+ *     console.log(`Cache is ${staleness.level}: ${staleness.ageHuman}`);
+ *   }
+ * }
+ * ```
+ */
+export function checkCacheStaleness(cache) {
+    const fetchedAt = new Date(cache.fetched_at);
+    const now = new Date();
+    const ageMs = now.getTime() - fetchedAt.getTime();
+    let level;
+    if (ageMs < FRESH_THRESHOLD_MS) {
+        level = 'fresh';
+    }
+    else if (ageMs < EXPIRED_THRESHOLD_MS) {
+        level = 'stale';
+    }
+    else {
+        level = 'expired';
+    }
+    return {
+        level,
+        age: ageMs,
+        ageHuman: formatCacheAge(cache.fetched_at),
+        isFresh: level === 'fresh',
+        showWarning: level !== 'fresh',
+    };
+}
+/**
+ * Format cache age for human-readable display
+ *
+ * @param fetchedAt - ISO timestamp string
+ * @returns Human-readable age string (e.g., "15 min ago", "2 hours ago")
+ *
+ * @example
+ * ```typescript
+ * const age = formatCacheAge('2026-01-19T10:00:00.000Z');
+ * // Returns something like "15 min ago"
+ * ```
+ */
+export function formatCacheAge(fetchedAt) {
+    const date = new Date(fetchedAt);
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    const diffSecs = Math.floor(diffMs / 1000);
+    const diffMins = Math.floor(diffMs / (1000 * 60));
+    const diffHours = Math.floor(diffMs / (1000 * 60 * 60));
+    const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+    if (diffSecs < 60) {
+        return 'just now';
+    }
+    if (diffMins < 60) {
+        return `${diffMins} min ago`;
+    }
+    if (diffHours < 24) {
+        return `${diffHours} hour${diffHours === 1 ? '' : 's'} ago`;
+    }
+    if (diffDays < 7) {
+        return `${diffDays} day${diffDays === 1 ? '' : 's'} ago`;
+    }
+    return date.toLocaleDateString();
+}
+// =============================================================================
+// Helper Functions
+// =============================================================================
+/**
+ * Get the full path to the cache file
+ */
+async function getCachePath() {
+    const ginkoDir = await getGinkoDir();
+    return path.join(ginkoDir, CACHE_FILE);
+}
+/**
+ * Validate that cache data has correct structure and version
+ */
+function isValidCache(data) {
+    if (!data || typeof data !== 'object') {
+        return false;
+    }
+    const cache = data;
+    // Check version
+    if (cache.version !== CACHE_VERSION) {
+        return false;
+    }
+    // Check required fields
+    if (!cache.fetched_at || typeof cache.fetched_at !== 'string') {
+        return false;
+    }
+    if (!cache.graph_id || typeof cache.graph_id !== 'string') {
+        return false;
+    }
+    if (!cache.active_sprint || typeof cache.active_sprint !== 'object') {
+        return false;
+    }
+    // Validate active_sprint structure
+    const sprint = cache.active_sprint;
+    if (!sprint.sprintId || !sprint.sprintName || !sprint.epicId) {
+        return false;
+    }
+    if (!sprint.progress || typeof sprint.progress.completed !== 'number' ||
+        typeof sprint.progress.total !== 'number' ||
+        typeof sprint.progress.percentage !== 'number') {
+        return false;
+    }
+    return true;
+}
+// =============================================================================
+// Exports for Testing
+// =============================================================================
+export const _internal = {
+    getCachePath,
+    isValidCache,
+    FRESH_THRESHOLD_MS,
+    EXPIRED_THRESHOLD_MS,
+    CACHE_VERSION,
+};
+//# sourceMappingURL=state-cache.js.map

package/dist/lib/state-cache.js.map

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

package/dist/lib/task-graph-sync.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-19
+ * @tags: [task-sync, graph, neo4j, epic-015, sprint-0a]
+ * @related: [task-parser.ts, ../commands/graph/api-client.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [api-client]
+ */
+/**
+ * Task Graph Sync (EPIC-015 Sprint 0a Tasks 2-3)
+ *
+ * Syncs parsed tasks to Neo4j graph via the dashboard API.
+ * Creates Task nodes and BELONGS_TO relationships.
+ *
+ * Key principle (ADR-060): Content from Git, State from Graph.
+ * - On CREATE: Uses initial_status from markdown
+ * - On UPDATE: Preserves existing status (graph-authoritative)
+ */
+import { GraphApiClient } from '../commands/graph/api-client.js';
+import { ParsedTask, SprintParseResult } from './task-parser.js';
+/**
+ * Response from task sync API
+ */
+export interface TaskSyncResponse {
+    success: boolean;
+    created: number;
+    updated: number;
+    relationships: number;
+    tasks: string[];
+}
+/**
+ * Options for task sync
+ */
+export interface TaskSyncOptions {
+    /** Create BELONGS_TO relationships (default: true) */
+    createRelationships?: boolean;
+    /** Batch size for API calls (default: 50) */
+    batchSize?: number;
+    /** Progress callback */
+    onProgress?: (synced: number, total: number) => void;
+}
+/**
+ * Result of syncing multiple sprints
+ */
+export interface BatchSyncResult {
+    success: boolean;
+    totalTasks: number;
+    created: number;
+    updated: number;
+    relationships: number;
+    errors: string[];
+}
+/**
+ * Sync tasks to graph via API
+ *
+ * @param tasks - Array of parsed tasks
+ * @param graphId - Graph namespace ID
+ * @param client - GraphApiClient instance
+ * @param options - Sync options
+ * @returns TaskSyncResponse
+ */
+export declare function syncTasksToGraph(tasks: ParsedTask[], graphId: string, client: GraphApiClient, options?: TaskSyncOptions): Promise<TaskSyncResponse>;
+/**
+ * Sync a single sprint's tasks to graph
+ *
+ * @param sprintResult - Parsed sprint with tasks
+ * @param client - GraphApiClient instance (optional, will create if not provided)
+ * @param options - Sync options
+ * @returns TaskSyncResponse
+ */
+export declare function syncSprintTasksToGraph(sprintResult: SprintParseResult, client?: GraphApiClient, options?: TaskSyncOptions): Promise<TaskSyncResponse>;
+/**
+ * Sync multiple sprints' tasks to graph
+ *
+ * @param sprintResults - Array of parsed sprints with tasks
+ * @param options - Sync options
+ * @returns BatchSyncResult
+ */
+export declare function syncAllSprintTasksToGraph(sprintResults: SprintParseResult[], options?: TaskSyncOptions): Promise<BatchSyncResult>;
+/**
+ * Get task sync status from graph
+ *
+ * @param graphId - Graph namespace ID
+ * @param sprintId - Optional sprint ID filter
+ * @param epicId - Optional epic ID filter
+ * @param client - GraphApiClient instance
+ * @returns Array of task status objects
+ */
+export declare function getTasksFromGraph(graphId: string, client: GraphApiClient, filters?: {
+    sprintId?: string;
+    epicId?: string;
+}): Promise<Array<{
+    id: string;
+    title: string;
+    status: string;
+    priority: string;
+    sprint_id: string;
+    epic_id: string;
+    estimate: string | null;
+    assignee: string | null;
+    synced_at: string | null;
+}>>;
+//# sourceMappingURL=task-graph-sync.d.ts.map

package/dist/lib/task-graph-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-graph-sync.d.ts","sourceRoot":"","sources":["../../src/lib/task-graph-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sDAAsD;IACtD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,6CAA6C;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CACpC,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CA+C3B;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,YAAY,EAAE,iBAAiB,EAC/B,MAAM,CAAC,EAAE,cAAc,EACvB,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,gBAAgB,CAAC,CAgB3B;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,iBAAiB,EAAE,EAClC,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,eAAe,CAAC,CAqE1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC,KAAK,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC,CAAC,CAEF"}