@ginkoai/cli 2.1.0 → 2.1.1

package/dist/lib/user-sprint.js.map

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

package/dist/lib/work-reconciliation.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-26
+ * @tags: [reconciliation, handoff, untracked-work, coaching, epic-016-s04]
+ * @related: [handoff.ts, planning-menu.ts, user-sprint.ts, event-logger.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [prompts, chalk, simple-git, event-logger]
+ */
+export interface WorkReconciliationResult {
+    hasUntrackedWork: boolean;
+    untrackedCommits: number;
+    untrackedFiles: number;
+    userAction: 'tracked' | 'skipped' | 'no-work' | 'cancelled';
+    taskCreated?: string;
+}
+interface SessionWorkSummary {
+    commits: Array<{
+        hash: string;
+        message: string;
+        date: string;
+    }>;
+    modifiedFiles: string[];
+    hasActiveTask: boolean;
+    currentSprintId: string | null;
+}
+/**
+ * Get summary of work done in current session
+ */
+declare function getSessionWorkSummary(): Promise<SessionWorkSummary>;
+/**
+ * Determine if there's significant untracked work
+ */
+declare function hasSignificantUntrackedWork(summary: SessionWorkSummary): boolean;
+/**
+ * Check for untracked work and prompt user if significant
+ *
+ * Called during handoff to catch work that should be tracked.
+ * Non-blocking - if user declines, handoff continues normally.
+ *
+ * @returns Reconciliation result with user's action
+ */
+export declare function reconcileWork(): Promise<WorkReconciliationResult>;
+/**
+ * Quick check if reconciliation might be needed (for verbose output)
+ */
+export declare function hasUntrackedWork(): Promise<boolean>;
+export declare const __testing: {
+    UNTRACKED_THRESHOLD: {
+        commits: number;
+        files: number;
+    };
+    IGNORED_PATTERNS: RegExp[];
+    getSessionWorkSummary: typeof getSessionWorkSummary;
+    hasSignificantUntrackedWork: typeof hasSignificantUntrackedWork;
+};
+export {};
+//# sourceMappingURL=work-reconciliation.d.ts.map

package/dist/lib/work-reconciliation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"work-reconciliation.d.ts","sourceRoot":"","sources":["../../src/lib/work-reconciliation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAyBH,MAAM,WAAW,wBAAwB;IACvC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,UAAU,kBAAkB;IAC1B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,EAAE,OAAO,CAAC;IACvB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAyBD;;GAEG;AACH,iBAAe,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CA4ClE;AAED;;GAEG;AACH,iBAAS,2BAA2B,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAWzE;AAkID;;;;;;;GAOG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAyBvE;AAED;;GAEG;AACH,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC,CAOzD;AAMD,eAAO,MAAM,SAAS;;;;;;;;CAKrB,CAAC"}

package/dist/lib/work-reconciliation.js

@@ -0,0 +1,267 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-26
+ * @tags: [reconciliation, handoff, untracked-work, coaching, epic-016-s04]
+ * @related: [handoff.ts, planning-menu.ts, user-sprint.ts, event-logger.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [prompts, chalk, simple-git, event-logger]
+ */
+/**
+ * Handoff Reconciliation (EPIC-016 Sprint 4 t06)
+ *
+ * Catches untracked work at session end by:
+ * 1. Detecting meaningful changes (commits, modified files)
+ * 2. Comparing against tracked sprint/task work
+ * 3. Prompting user to create ad-hoc tasks for untracked work
+ *
+ * Goal: Ensure all significant work is captured for knowledge graph
+ * without being annoying or slowing down the workflow.
+ */
+import prompts from 'prompts';
+import chalk from 'chalk';
+import simpleGit from 'simple-git';
+import { logEvent } from './event-logger.js';
+import { getUserCurrentSprint } from './user-sprint.js';
+import { createQuickFixTask } from '../commands/sprint/quick-fix.js';
+// =============================================================================
+// Constants
+// =============================================================================
+// Minimum thresholds for prompting about untracked work
+const UNTRACKED_THRESHOLD = {
+    commits: 1, // Prompt if 1+ commits without task
+    files: 5, // Or 5+ modified files
+};
+// File patterns to ignore when counting modified files
+const IGNORED_PATTERNS = [
+    /^\.ginko\//,
+    /^node_modules\//,
+    /\.log$/,
+    /\.tmp$/,
+    /\.lock$/,
+];
+// =============================================================================
+// Work Detection
+// =============================================================================
+/**
+ * Get summary of work done in current session
+ */
+async function getSessionWorkSummary() {
+    const git = simpleGit();
+    // Get current sprint info
+    const userSprint = await getUserCurrentSprint();
+    const hasActiveTask = userSprint !== null;
+    const currentSprintId = userSprint?.sprintId || null;
+    // Get recent commits (last 24 hours or since last handoff marker)
+    let commits = [];
+    try {
+        const log = await git.log({
+            '--since': '24 hours ago',
+            maxCount: 20,
+        });
+        commits = log.all.map(c => ({
+            hash: c.hash.slice(0, 7),
+            message: c.message.split('\n')[0],
+            date: c.date,
+        }));
+    }
+    catch {
+        // Git log failed - might not be a git repo
+    }
+    // Get modified files (staged + unstaged)
+    let modifiedFiles = [];
+    try {
+        const status = await git.status();
+        modifiedFiles = [
+            ...status.modified,
+            ...status.staged,
+            ...status.not_added,
+        ].filter(f => !IGNORED_PATTERNS.some(p => p.test(f)));
+    }
+    catch {
+        // Git status failed
+    }
+    return {
+        commits,
+        modifiedFiles,
+        hasActiveTask,
+        currentSprintId,
+    };
+}
+/**
+ * Determine if there's significant untracked work
+ */
+function hasSignificantUntrackedWork(summary) {
+    // If user has an active task, assume work is tracked
+    if (summary.hasActiveTask) {
+        return false;
+    }
+    // Check thresholds
+    return (summary.commits.length >= UNTRACKED_THRESHOLD.commits ||
+        summary.modifiedFiles.length >= UNTRACKED_THRESHOLD.files);
+}
+// =============================================================================
+// User Prompts
+// =============================================================================
+/**
+ * Prompt user about untracked work
+ */
+async function promptForUntrackedWork(summary) {
+    console.log('');
+    console.log(chalk.yellow('📋 You have work that may not be tracked:'));
+    if (summary.commits.length > 0) {
+        console.log(chalk.dim(`   ${summary.commits.length} commit(s) in the last 24h`));
+        // Show first commit message as context
+        if (summary.commits[0]) {
+            console.log(chalk.dim(`   Latest: "${summary.commits[0].message.slice(0, 50)}..."`));
+        }
+    }
+    if (summary.modifiedFiles.length > 0) {
+        console.log(chalk.dim(`   ${summary.modifiedFiles.length} modified file(s)`));
+    }
+    console.log('');
+    const { action } = await prompts({
+        type: 'select',
+        name: 'action',
+        message: 'Would you like to track this work?',
+        choices: [
+            {
+                title: 'Yes, create a quick task',
+                description: 'Track this work with a simple description',
+                value: 'track',
+            },
+            {
+                title: 'No, skip this time',
+                description: 'Continue without tracking',
+                value: 'skip',
+            },
+        ],
+    });
+    if (action === undefined) {
+        return {
+            hasUntrackedWork: true,
+            untrackedCommits: summary.commits.length,
+            untrackedFiles: summary.modifiedFiles.length,
+            userAction: 'cancelled',
+        };
+    }
+    if (action === 'skip') {
+        // Log that user skipped tracking
+        await logEvent({
+            category: 'decision',
+            description: 'Skipped tracking untracked work at handoff',
+            tags: ['handoff', 'untracked-work', 'skipped'],
+            impact: 'low',
+        }).catch(() => { });
+        return {
+            hasUntrackedWork: true,
+            untrackedCommits: summary.commits.length,
+            untrackedFiles: summary.modifiedFiles.length,
+            userAction: 'skipped',
+        };
+    }
+    // User wants to track - get description
+    const { description } = await prompts({
+        type: 'text',
+        name: 'description',
+        message: 'Brief description of the work:',
+        initial: summary.commits[0]?.message.slice(0, 50) || '',
+        validate: (v) => v.trim().length >= 5 ? true : 'Please provide a brief description',
+    });
+    if (!description) {
+        return {
+            hasUntrackedWork: true,
+            untrackedCommits: summary.commits.length,
+            untrackedFiles: summary.modifiedFiles.length,
+            userAction: 'cancelled',
+        };
+    }
+    // Create quick-fix task
+    try {
+        const result = await createQuickFixTask(description.trim());
+        if (result.success && result.taskId) {
+            console.log(chalk.green(`✓ Created: ${result.taskId}`));
+            return {
+                hasUntrackedWork: true,
+                untrackedCommits: summary.commits.length,
+                untrackedFiles: summary.modifiedFiles.length,
+                userAction: 'tracked',
+                taskCreated: result.taskId,
+            };
+        }
+    }
+    catch {
+        console.log(chalk.dim('Task creation skipped (graph may not be initialized)'));
+    }
+    // Log the work even if task creation failed
+    await logEvent({
+        category: 'feature',
+        description: `Handoff work: ${description}`,
+        tags: ['handoff', 'untracked-work', 'logged'],
+        impact: 'medium',
+    }).catch(() => { });
+    return {
+        hasUntrackedWork: true,
+        untrackedCommits: summary.commits.length,
+        untrackedFiles: summary.modifiedFiles.length,
+        userAction: 'tracked',
+    };
+}
+// =============================================================================
+// Main Function
+// =============================================================================
+/**
+ * Check for untracked work and prompt user if significant
+ *
+ * Called during handoff to catch work that should be tracked.
+ * Non-blocking - if user declines, handoff continues normally.
+ *
+ * @returns Reconciliation result with user's action
+ */
+export async function reconcileWork() {
+    try {
+        const summary = await getSessionWorkSummary();
+        if (!hasSignificantUntrackedWork(summary)) {
+            return {
+                hasUntrackedWork: false,
+                untrackedCommits: 0,
+                untrackedFiles: 0,
+                userAction: 'no-work',
+            };
+        }
+        return await promptForUntrackedWork(summary);
+    }
+    catch (error) {
+        // Non-critical - don't block handoff on reconciliation errors
+        console.warn(chalk.dim('Work reconciliation skipped:'), error instanceof Error ? error.message : String(error));
+        return {
+            hasUntrackedWork: false,
+            untrackedCommits: 0,
+            untrackedFiles: 0,
+            userAction: 'no-work',
+        };
+    }
+}
+/**
+ * Quick check if reconciliation might be needed (for verbose output)
+ */
+export async function hasUntrackedWork() {
+    try {
+        const summary = await getSessionWorkSummary();
+        return hasSignificantUntrackedWork(summary);
+    }
+    catch {
+        return false;
+    }
+}
+// =============================================================================
+// Exports for Testing
+// =============================================================================
+export const __testing = {
+    UNTRACKED_THRESHOLD,
+    IGNORED_PATTERNS,
+    getSessionWorkSummary,
+    hasSignificantUntrackedWork,
+};
+//# sourceMappingURL=work-reconciliation.js.map

package/dist/lib/work-reconciliation.js.map

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

package/dist/utils/version-check.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-21
+ * @tags: [version, update, npm, notification]
+ * @related: [start-reflection.ts]
+ * @priority: low
+ * @complexity: low
+ * @dependencies: [fs-extra, semver]
+ */
+/**
+ * Get the current installed version
+ * Reads from package.json relative to this module's location
+ */
+export declare function getCurrentVersion(): string;
+/**
+ * Check for updates and return notification message if available
+ * Non-blocking, uses cache to avoid frequent npm requests
+ */
+export declare function checkForUpdates(): Promise<string | null>;
+/**
+ * Run version check in background (fire and forget)
+ * Returns a promise that resolves to the message (or null)
+ */
+export declare function checkForUpdatesAsync(): Promise<string | null>;
+//# sourceMappingURL=version-check.d.ts.map

package/dist/utils/version-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-check.d.ts","sourceRoot":"","sources":["../../src/utils/version-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA8BH;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAuB1C;AAmFD;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiC9D;AAUD;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE7D"}

package/dist/utils/version-check.js

@@ -0,0 +1,186 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-01-21
+ * @tags: [version, update, npm, notification]
+ * @related: [start-reflection.ts]
+ * @priority: low
+ * @complexity: low
+ * @dependencies: [fs-extra, semver]
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import os from 'os';
+import chalk from 'chalk';
+import { fileURLToPath } from 'url';
+// ES module compatibility: get __dirname equivalent
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// Package name for npm registry lookup
+const PACKAGE_NAME = '@ginkoai/cli';
+// Cache duration: 24 hours
+const CACHE_DURATION_MS = 24 * 60 * 60 * 1000;
+/**
+ * Get the path to the version cache file
+ */
+function getCacheFilePath() {
+    return path.join(os.homedir(), '.ginko', 'version-cache.json');
+}
+/**
+ * Get the current installed version
+ * Reads from package.json relative to this module's location
+ */
+export function getCurrentVersion() {
+    try {
+        // When compiled, this file is at dist/utils/version-check.js
+        // package.json is at the package root (../../ from here)
+        const packageJsonPath = path.resolve(__dirname, '..', '..', 'package.json');
+        const packageJson = fs.readJsonSync(packageJsonPath);
+        return packageJson.version || '0.0.0';
+    }
+    catch {
+        // Fallback: try to call ginko --version
+        try {
+            const { execSync } = require('child_process');
+            const output = execSync('ginko --version', {
+                encoding: 'utf-8',
+                timeout: 2000,
+                stdio: ['pipe', 'pipe', 'pipe'],
+            }).trim();
+            const match = output.match(/(\d+\.\d+\.\d+)/);
+            if (match)
+                return match[1];
+        }
+        catch {
+            // Version check failed - non-critical
+        }
+    }
+    return '0.0.0';
+}
+/**
+ * Load cached version info
+ */
+async function loadCache() {
+    try {
+        const cachePath = getCacheFilePath();
+        if (await fs.pathExists(cachePath)) {
+            const cache = await fs.readJson(cachePath);
+            return cache;
+        }
+    }
+    catch {
+        // Cache read failed - will fetch fresh
+    }
+    return null;
+}
+/**
+ * Save version info to cache
+ */
+async function saveCache(latestVersion) {
+    try {
+        const cachePath = getCacheFilePath();
+        await fs.ensureDir(path.dirname(cachePath));
+        await fs.writeJson(cachePath, {
+            latestVersion,
+            checkedAt: new Date().toISOString(),
+        });
+    }
+    catch {
+        // Cache write failed - non-critical
+    }
+}
+/**
+ * Check if cache is still valid (less than 24 hours old)
+ */
+function isCacheValid(cache) {
+    const checkedAt = new Date(cache.checkedAt).getTime();
+    const now = Date.now();
+    return (now - checkedAt) < CACHE_DURATION_MS;
+}
+/**
+ * Fetch latest version from npm registry
+ */
+async function fetchLatestVersion() {
+    try {
+        // Use dynamic import for fetch (available in Node 18+)
+        const response = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, {
+            headers: { 'Accept': 'application/json' },
+            signal: AbortSignal.timeout(3000), // 3 second timeout
+        });
+        if (!response.ok) {
+            return null;
+        }
+        const data = await response.json();
+        return data.version;
+    }
+    catch {
+        // Network error or timeout - non-critical
+        return null;
+    }
+}
+/**
+ * Compare semver versions
+ * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+ */
+function compareVersions(a, b) {
+    const partsA = a.split('.').map(Number);
+    const partsB = b.split('.').map(Number);
+    for (let i = 0; i < 3; i++) {
+        const numA = partsA[i] || 0;
+        const numB = partsB[i] || 0;
+        if (numA < numB)
+            return -1;
+        if (numA > numB)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Check for updates and return notification message if available
+ * Non-blocking, uses cache to avoid frequent npm requests
+ */
+export async function checkForUpdates() {
+    try {
+        const currentVersion = getCurrentVersion();
+        // Check cache first
+        const cache = await loadCache();
+        if (cache && isCacheValid(cache)) {
+            // Use cached version
+            if (compareVersions(currentVersion, cache.latestVersion) < 0) {
+                return formatUpdateMessage(currentVersion, cache.latestVersion);
+            }
+            return null;
+        }
+        // Fetch latest version from npm
+        const latestVersion = await fetchLatestVersion();
+        if (!latestVersion) {
+            return null; // Couldn't fetch - fail silently
+        }
+        // Save to cache
+        await saveCache(latestVersion);
+        // Compare versions
+        if (compareVersions(currentVersion, latestVersion) < 0) {
+            return formatUpdateMessage(currentVersion, latestVersion);
+        }
+        return null;
+    }
+    catch {
+        // Version check failed - non-critical
+        return null;
+    }
+}
+/**
+ * Format the update notification message
+ */
+function formatUpdateMessage(currentVersion, latestVersion) {
+    return chalk.yellow(`\n  Update available: ${chalk.dim(currentVersion)} → ${chalk.green(latestVersion)}\n`) +
+        chalk.dim(`  Run ${chalk.cyan('npm update -g @ginkoai/cli')} to update\n`);
+}
+/**
+ * Run version check in background (fire and forget)
+ * Returns a promise that resolves to the message (or null)
+ */
+export function checkForUpdatesAsync() {
+    return checkForUpdates().catch(() => null);
+}
+//# sourceMappingURL=version-check.js.map

package/dist/utils/version-check.js.map

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

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@ginkoai/cli",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Git-native session management and cloud context for AI-mediated development. AI Collaboration for Vibe Tribes.",
   "main": "dist/index.js",
   "bin": {
     "ginko": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsc && npm run copy:templates",
+    "build": "tsc && chmod +x dist/index.js && npm run copy:templates",
     "copy:templates": "mkdir -p dist/templates && cp src/templates/*.md dist/templates/ 2>/dev/null || true",
     "dev": "tsc --watch",
     "test": "jest",