@ginkoai/cli 1.0.0 → 1.4.2

package/dist/commands/knowledge/sync.js

@@ -0,0 +1,251 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [knowledge, sync, migration, cloud, task-026]
+ * @related: [index.ts, create.ts, scanner.ts, parser.ts]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [chalk, commander]
+ */
+/**
+ * Sync Command (TASK-026)
+ *
+ * Migrate local knowledge files (ADRs, PRDs, modules) to cloud knowledge graph
+ *
+ * Features:
+ * - Dry-run mode to preview changes
+ * - Conflict detection and resolution
+ * - Progress reporting with real-time status
+ * - Rollback support via sync logs
+ * - Batch uploads with relationship mapping
+ */
+import chalk from 'chalk';
+import { getConfig, getApiToken } from '../graph/config.js';
+import { scanLocalKnowledge } from '../../lib/sync/scanner.js';
+import { detectConflicts } from '../../lib/sync/conflict-detector.js';
+import { uploadNodes } from '../../lib/sync/uploader.js';
+import { SyncLogger } from '../../lib/sync/logger.js';
+import prompts from 'prompts';
+/**
+ * Main sync command
+ */
+export async function syncCommand(options) {
+    const startTime = Date.now();
+    try {
+        console.log(chalk.bold.cyan('🔄 Knowledge Sync: Local → Cloud\n'));
+        // Get config and auth
+        const config = await getConfig();
+        const graphId = options.project || config.graphId;
+        if (!graphId) {
+            console.error(chalk.red('❌ No graph ID specified.'));
+            console.error(chalk.dim('   Use --project=<id> or run `ginko graph init` first.'));
+            process.exit(1);
+        }
+        const token = await getApiToken();
+        if (!token) {
+            console.error(chalk.red('❌ Not authenticated.'));
+            console.error(chalk.dim('   Run `ginko login` to authenticate.'));
+            process.exit(1);
+        }
+        // Initialize sync logger
+        const syncLogger = new SyncLogger(graphId);
+        await syncLogger.init();
+        // Step 1: Scan local filesystem
+        console.log(chalk.dim('📂 Scanning local knowledge...'));
+        const basePath = options.path || process.cwd();
+        const localNodes = await scanLocalKnowledge(basePath);
+        if (localNodes.length === 0) {
+            console.log(chalk.yellow('⚠️  No knowledge files found'));
+            console.log(chalk.dim(`   Searched in: ${basePath}`));
+            console.log(chalk.dim('   Looking for: docs/adr/ADR-*.md, docs/PRD/PRD-*.md'));
+            return;
+        }
+        // Group by type for display
+        const nodesByType = localNodes.reduce((acc, node) => {
+            acc[node.type] = (acc[node.type] || 0) + 1;
+            return acc;
+        }, {});
+        console.log(chalk.green(`✓ Found: ${localNodes.length} files`));
+        Object.entries(nodesByType).forEach(([type, count]) => {
+            console.log(chalk.dim(`   ${type}: ${count}`));
+        });
+        console.log('');
+        // Step 2: Conflict detection
+        let conflicts = [];
+        let existingCount = 0;
+        let newCount = localNodes.length;
+        if (!options.localOnly) {
+            console.log(chalk.dim('🔍 Checking cloud for duplicates...'));
+            conflicts = await detectConflicts(localNodes, graphId, token, config.apiUrl);
+            existingCount = conflicts.length;
+            newCount = localNodes.length - existingCount;
+        }
+        else {
+            console.log(chalk.dim('🔍 Skipping cloud check (local-only mode)...'));
+        }
+        console.log(chalk.dim(`   Existing: ${existingCount}`));
+        console.log(chalk.dim(`   New: ${newCount}`));
+        console.log('');
+        // Determine resolution strategy
+        let resolution = 'skip';
+        if (options.force) {
+            resolution = 'overwrite';
+            console.log(chalk.yellow('⚡ Force mode: Will overwrite existing nodes'));
+        }
+        else if (options.skip) {
+            resolution = 'skip';
+            console.log(chalk.dim('📌 Skip mode: Will skip existing nodes'));
+        }
+        else if (options.interactive && conflicts.length > 0) {
+            // Interactive conflict resolution
+            console.log(chalk.yellow(`⚠️  Found ${conflicts.length} conflicts:\n`));
+            // Show first 5 conflicts
+            conflicts.slice(0, 5).forEach((conflict) => {
+                console.log(chalk.dim(`   - ${conflict.local.title}`));
+                console.log(chalk.dim(`     Local:  ${conflict.local.filePath}`));
+                console.log(chalk.dim(`     Cloud:  ${conflict.cloud.id} (updated: ${conflict.cloud.updatedAt})`));
+                console.log('');
+            });
+            if (conflicts.length > 5) {
+                console.log(chalk.dim(`   ... and ${conflicts.length - 5} more\n`));
+            }
+            const response = await prompts({
+                type: 'select',
+                name: 'resolution',
+                message: 'How should conflicts be resolved?',
+                choices: [
+                    { title: 'Skip existing (safe, default)', value: 'skip' },
+                    { title: 'Overwrite all (destructive)', value: 'overwrite' },
+                    { title: 'Cancel sync', value: 'cancel' },
+                ],
+                initial: 0,
+            });
+            if (response.resolution === 'cancel' || !response.resolution) {
+                console.log(chalk.yellow('⚠️  Sync cancelled'));
+                return;
+            }
+            resolution = response.resolution;
+        }
+        // Apply resolution to conflicts
+        conflicts.forEach((conflict) => {
+            conflict.resolution = resolution;
+        });
+        // Filter nodes based on resolution
+        const nodesToUpload = localNodes.filter(node => {
+            const conflict = conflicts.find(c => c.local.title === node.title && c.local.type === node.type);
+            return !conflict || conflict.resolution === 'overwrite';
+        });
+        if (nodesToUpload.length === 0) {
+            console.log(chalk.yellow('⚠️  No nodes to upload (all skipped)'));
+            return;
+        }
+        // Dry-run mode: show what would be done
+        if (options.dryRun || options.localOnly) {
+            console.log(chalk.bold.yellow('🔍 DRY RUN - No changes will be made\n'));
+            console.log(chalk.bold('Would upload:'));
+            nodesToUpload.slice(0, 10).forEach(node => {
+                console.log(chalk.green(`  ✓ ${node.type}: ${node.title}`));
+                console.log(chalk.dim(`    ${node.filePath}`));
+                if (node.relationships.length > 0) {
+                    console.log(chalk.dim(`    Relationships: ${node.relationships.length}`));
+                }
+            });
+            if (nodesToUpload.length > 10) {
+                console.log(chalk.dim(`  ... and ${nodesToUpload.length - 10} more\n`));
+            }
+            console.log(chalk.bold('\nSummary:'));
+            console.log(chalk.dim(`  Total nodes: ${nodesToUpload.length}`));
+            console.log(chalk.dim(`  Existing skipped: ${existingCount}`));
+            console.log(chalk.dim(`  Relationships: ${nodesToUpload.reduce((sum, n) => sum + n.relationships.length, 0)}`));
+            console.log('');
+            if (!options.localOnly) {
+                console.log(chalk.yellow('💡 Run without --dry-run to execute sync'));
+            }
+            return;
+        }
+        // Step 3: Upload nodes
+        console.log(chalk.bold(`\n📤 Uploading ${nodesToUpload.length} nodes...\n`));
+        const uploadProgress = {
+            total: nodesToUpload.length,
+            uploaded: 0,
+            failed: 0,
+            skipped: existingCount,
+            relationshipsCreated: 0,
+        };
+        // Progress callback
+        const onProgress = (progress) => {
+            const percent = Math.round((progress.uploaded / progress.total) * 100);
+            const bar = '='.repeat(Math.floor(percent / 5)) + '>'.padEnd(20 - Math.floor(percent / 5), ' ');
+            process.stdout.write(`\r[${bar}] ${progress.uploaded}/${progress.total} (${percent}%)`);
+            if (progress.uploaded === progress.total) {
+                console.log(''); // New line after completion
+            }
+        };
+        // Execute upload
+        const result = await uploadNodes(nodesToUpload, graphId, token, config.apiUrl, onProgress);
+        // Log sync results
+        await syncLogger.logSync({
+            timestamp: new Date().toISOString(),
+            graphId,
+            nodesScanned: localNodes.length,
+            nodesUploaded: result.uploaded,
+            nodesFailed: result.failed,
+            nodesSkipped: result.skipped,
+            relationshipsCreated: result.relationshipsCreated,
+            conflicts: conflicts.length,
+            resolution,
+            duration: Date.now() - startTime,
+        });
+        // Display results
+        console.log('');
+        console.log(chalk.bold.green('✅ Sync Complete!\n'));
+        console.log(chalk.bold('Results:'));
+        console.log(chalk.green(`  ✓ Uploaded: ${result.uploaded} nodes`));
+        console.log(chalk.cyan(`  ✓ Relationships: ${result.relationshipsCreated}`));
+        console.log(chalk.dim(`  ⊘ Skipped: ${result.skipped} existing`));
+        if (result.failed > 0) {
+            console.log(chalk.red(`  ✗ Failed: ${result.failed}`));
+        }
+        const durationSec = ((Date.now() - startTime) / 1000).toFixed(1);
+        console.log(chalk.dim(`  ⏱  Duration: ${durationSec}s`));
+        console.log('');
+        console.log(chalk.dim(`💾 Sync log: ${syncLogger.getLogPath()}`));
+        console.log(chalk.dim(`💡 Rollback: ginko knowledge sync:rollback ${syncLogger.getSyncId()}`));
+    }
+    catch (error) {
+        console.error(chalk.red('\n❌ Sync failed:'));
+        console.error(chalk.red(`   ${error.message}`));
+        if (error.stack && process.env.GINKO_DEBUG) {
+            console.error(chalk.dim(error.stack));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Rollback command - restore state before sync
+ */
+export async function rollbackCommand(syncId) {
+    try {
+        console.log(chalk.bold.yellow(`🔙 Rolling back sync: ${syncId}\n`));
+        const config = await getConfig();
+        const syncLogger = new SyncLogger(config.graphId || '');
+        const syncLog = await syncLogger.getSyncLog(syncId);
+        if (!syncLog) {
+            console.error(chalk.red(`❌ Sync log not found: ${syncId}`));
+            process.exit(1);
+        }
+        console.log(chalk.dim(`Found sync from: ${syncLog.timestamp}`));
+        console.log(chalk.dim(`Nodes uploaded: ${syncLog.nodesUploaded}`));
+        console.log('');
+        console.log(chalk.yellow('⚠️  Rollback not yet implemented'));
+        console.log(chalk.dim('   This feature will delete uploaded nodes created during sync'));
+        console.log(chalk.dim('   Implementation coming in next iteration'));
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Rollback failed:'));
+        console.error(chalk.red(`   ${error.message}`));
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=sync.js.map

package/dist/commands/knowledge/sync.js.map

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

package/dist/commands/log.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-10-22
+ * @tags: [session-logging, defensive-logging, adr-033, references, task-010]
+ * @related: [../core/session-log-manager.ts, start/start-reflection.ts, ../utils/reference-parser.ts]
+ * @priority: critical
+ * @complexity: low
+ * @dependencies: [chalk, commander, session-log-manager, reference-parser]
+ */
+interface LogOptions {
+    files?: string;
+    impact?: string;
+    category?: string;
+    show?: boolean;
+    validate?: boolean;
+    why?: boolean;
+    quick?: boolean;
+    refs?: boolean;
+    shared?: boolean;
+}
+/**
+ * Log an event to the current session
+ * Part of ADR-033 defensive logging strategy
+ */
+export declare function logCommand(description: string, options: LogOptions): Promise<void>;
+/**
+ * Show examples of logging events
+ */
+export declare function logExamples(): void;
+export {};
+//# sourceMappingURL=log.d.ts.map

package/dist/commands/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/commands/log.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA4BH,UAAU,UAAU;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA6NxF;AAwaD;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAmElC"}