@ginkoai/cli 2.1.4 → 2.1.6-beta.0

package/dist/commands/pull/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/pull/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,iBAAiB,IAAI,OAAO,CAyE3C;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/commands/pull/index.js

@@ -0,0 +1,90 @@
+/**
+ * @fileType: command-entry
+ * @status: current
+ * @updated: 2026-01-30
+ * @tags: [pull, command, graph-to-local, ADR-077]
+ * @related: [pull-command.ts, ../sync/sync-command.ts]
+ * @priority: critical
+ * @complexity: low
+ * @dependencies: [commander]
+ */
+/**
+ * Pull Command Entry Point (ADR-077)
+ *
+ * Registers the `ginko pull` command with subcommands for entity-specific pull.
+ * Replaces `ginko sync` with a git-inspired interface.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { pullCommand } from './pull-command.js';
+export function createPullCommand() {
+    const pull = new Command('pull')
+        .description('Pull dashboard changes to local git (ADR-077: git-integrated sync)')
+        .option('--dry-run', 'Preview what would be pulled without making changes')
+        .option('--force', 'Overwrite local files with graph versions')
+        .addHelpText('after', `
+${chalk.gray('Subcommands:')}
+  ${chalk.green('ginko pull')}                     ${chalk.dim('Pull all changes from graph')}
+  ${chalk.green('ginko pull sprint')}              ${chalk.dim('Pull only sprint changes')}
+  ${chalk.green('ginko pull adr')}                 ${chalk.dim('Pull only ADR changes')}
+
+${chalk.gray('Options:')}
+  ${chalk.dim('--dry-run    Preview what would be pulled')}
+  ${chalk.dim('--force      Overwrite local files with graph versions')}
+
+${chalk.gray('Examples:')}
+  ${chalk.green('ginko pull')} ${chalk.dim('# Pull all changes from dashboard')}
+  ${chalk.green('ginko pull --dry-run')} ${chalk.dim('# Preview changes')}
+  ${chalk.green('ginko pull sprint')} ${chalk.dim('# Pull only sprint changes')}
+  ${chalk.green('ginko pull --force')} ${chalk.dim('# Overwrite local with graph')}
+`);
+    // Default action: pull all changes
+    pull.action(async (options) => {
+        await pullCommand({
+            dryRun: options.dryRun === true,
+            force: options.force === true,
+        });
+    });
+    // Subcommand: pull sprint
+    pull
+        .command('sprint')
+        .description('Pull sprint changes from graph')
+        .option('--dry-run', 'Preview what would be pulled')
+        .option('--force', 'Overwrite local files')
+        .action(async (subOptions) => {
+        await pullCommand({
+            entityType: 'sprint',
+            dryRun: subOptions.dryRun === true || pull.opts().dryRun === true,
+            force: subOptions.force === true || pull.opts().force === true,
+        });
+    });
+    // Subcommand: pull adr
+    pull
+        .command('adr')
+        .description('Pull ADR changes from graph')
+        .option('--dry-run', 'Preview what would be pulled')
+        .option('--force', 'Overwrite local files')
+        .action(async (subOptions) => {
+        await pullCommand({
+            entityType: 'adr',
+            dryRun: subOptions.dryRun === true || pull.opts().dryRun === true,
+            force: subOptions.force === true || pull.opts().force === true,
+        });
+    });
+    // Subcommand: pull epic
+    pull
+        .command('epic')
+        .description('Pull epic changes from graph')
+        .option('--dry-run', 'Preview what would be pulled')
+        .option('--force', 'Overwrite local files')
+        .action(async (subOptions) => {
+        await pullCommand({
+            entityType: 'epic',
+            dryRun: subOptions.dryRun === true || pull.opts().dryRun === true,
+            force: subOptions.force === true || pull.opts().force === true,
+        });
+    });
+    return pull;
+}
+export { pullCommand } from './pull-command.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/pull/index.js.map

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

package/dist/commands/pull/pull-command.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2026-01-30
+ * @tags: [pull, sync, graph-to-local, ADR-077]
+ * @related: [index.ts, ../sync/sync-command.ts, ../../lib/sync-state.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [chalk]
+ */
+export interface PullOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    /** Entity type filter (from subcommand: epic, sprint, adr, etc.) */
+    entityType?: string;
+    /** Quiet mode for auto-pull */
+    quiet?: boolean;
+}
+/**
+ * Main pull command implementation
+ */
+export declare function pullCommand(options: PullOptions): Promise<void>;
+//# sourceMappingURL=pull-command.d.ts.map

package/dist/commands/pull/pull-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-command.d.ts","sourceRoot":"","sources":["../../../src/commands/pull/pull-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAqBH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAsBD;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CrE"}

package/dist/commands/pull/pull-command.js

@@ -0,0 +1,89 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2026-01-30
+ * @tags: [pull, sync, graph-to-local, ADR-077]
+ * @related: [index.ts, ../sync/sync-command.ts, ../../lib/sync-state.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [chalk]
+ */
+/**
+ * Pull Command (ADR-077)
+ *
+ * Wraps existing sync logic from sync-command.ts with a git-inspired interface.
+ * Pulls dashboard edits from graph to local git.
+ *
+ * Usage:
+ *   ginko pull                     # Pull all changes
+ *   ginko pull epic                # Pull only epics
+ *   ginko pull sprint              # Pull only sprints
+ *   ginko pull --force             # Overwrite local with graph version
+ *   ginko pull --dry-run           # Preview what would be pulled
+ */
+import chalk from 'chalk';
+import { syncCommand } from '../sync/sync-command.js';
+import { recordPull, readSyncState } from '../../lib/sync-state.js';
+/**
+ * Map subcommand entity types to sync NodeType
+ */
+function mapEntityType(entityType) {
+    if (!entityType)
+        return undefined;
+    const mapping = {
+        'epic': 'Charter', // Epics don't have a direct NodeType in sync, we'll handle specially
+        'sprint': 'Sprint',
+        'adr': 'ADR',
+        'prd': 'PRD',
+        'pattern': 'Pattern',
+        'gotcha': 'Gotcha',
+        'charter': 'Charter',
+        'task': 'Task',
+    };
+    return mapping[entityType.toLowerCase()];
+}
+/**
+ * Main pull command implementation
+ */
+export async function pullCommand(options) {
+    const quiet = !!options.quiet;
+    if (!quiet) {
+        console.log(chalk.bold.cyan('\n\u2b07  Pull: Graph \u2192 Git\n'));
+    }
+    // Read sync state for display
+    const syncState = await readSyncState();
+    if (!quiet && syncState.lastPullTimestamp) {
+        console.log(chalk.dim(`Last pull: ${syncState.lastPullTimestamp}`));
+    }
+    // Map entity type to sync NodeType
+    const nodeType = mapEntityType(options.entityType);
+    // Build sync options - delegate to existing sync logic
+    const syncOptions = {
+        dryRun: options.dryRun,
+        force: options.force,
+        type: nodeType,
+        interactive: !options.force,
+        skipMembershipCheck: quiet,
+    };
+    try {
+        const result = await syncCommand(syncOptions);
+        // Update sync state on successful pull
+        if (!options.dryRun && result.synced.length > 0) {
+            await recordPull();
+        }
+        // Summary with reinforcement
+        if (!quiet && !options.dryRun) {
+            if (result.synced.length > 0) {
+                console.log(chalk.dim('\n\ud83d\udca1 Local files are up to date. Use `ginko push` to sync your changes to graph.'));
+            }
+        }
+    }
+    catch (error) {
+        if (!quiet) {
+            const msg = error instanceof Error ? error.message : String(error);
+            console.error(chalk.red(`\u2717 Pull failed: ${msg}`));
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=pull-command.js.map

package/dist/commands/pull/pull-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pull-command.js","sourceRoot":"","sources":["../../../src/commands/pull/pull-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAYpE;;GAEG;AACH,SAAS,aAAa,CAAC,UAAmB;IACxC,IAAI,CAAC,UAAU;QAAE,OAAO,SAAS,CAAC;IAElC,MAAM,OAAO,GAA6B;QACxC,MAAM,EAAE,SAAS,EAAE,qEAAqE;QACxF,QAAQ,EAAE,QAAQ;QAClB,KAAK,EAAE,KAAK;QACZ,KAAK,EAAE,KAAK;QACZ,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,QAAQ;QAClB,SAAS,EAAE,SAAS;QACpB,MAAM,EAAE,MAAM;KACf,CAAC;IAEF,OAAO,OAAO,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAoB;IACpD,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;IAE9B,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,8BAA8B;IAC9B,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE,CAAC;IACxC,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC,iBAAiB,EAAE,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,SAAS,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,mCAAmC;IACnC,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAEnD,uDAAuD;IACvD,MAAM,WAAW,GAAoB;QACnC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK;QAC3B,mBAAmB,EAAE,KAAK;KAC3B,CAAC;IAEF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,WAAW,CAAC,CAAC;QAE9C,uCAAuC;QACvC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChD,MAAM,UAAU,EAAE,CAAC;QACrB,CAAC;QAED,6BAA6B;QAC7B,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YAC9B,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4FAA4F,CAAC,CAAC,CAAC;YACvH,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACnE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,GAAG,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/commands/push/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileType: command-entry
+ * @status: current
+ * @updated: 2026-01-30
+ * @tags: [push, command, git-to-graph, ADR-077]
+ * @related: [push-command.ts, ../../lib/sync-state.ts, ../../lib/git-change-detector.ts]
+ * @priority: critical
+ * @complexity: low
+ * @dependencies: [commander]
+ */
+/**
+ * Push Command Entry Point (ADR-077)
+ *
+ * Registers the `ginko push` command with subcommands for entity-specific push.
+ * Replaces `ginko graph load` and `--sync` flags.
+ */
+import { Command } from 'commander';
+export declare function createPushCommand(): Command;
+export { pushCommand } from './push-command.js';
+export type { PushOptions, PushResult } from './push-command.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/push/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/push/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,iBAAiB,IAAI,OAAO,CAwG3C;AAED,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/commands/push/index.js

@@ -0,0 +1,120 @@
+/**
+ * @fileType: command-entry
+ * @status: current
+ * @updated: 2026-01-30
+ * @tags: [push, command, git-to-graph, ADR-077]
+ * @related: [push-command.ts, ../../lib/sync-state.ts, ../../lib/git-change-detector.ts]
+ * @priority: critical
+ * @complexity: low
+ * @dependencies: [commander]
+ */
+/**
+ * Push Command Entry Point (ADR-077)
+ *
+ * Registers the `ginko push` command with subcommands for entity-specific push.
+ * Replaces `ginko graph load` and `--sync` flags.
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { pushCommand } from './push-command.js';
+export function createPushCommand() {
+    const push = new Command('push')
+        .description('Push local changes to graph (ADR-077: git-integrated sync)')
+        .option('--dry-run', 'Preview what would be pushed without making changes')
+        .option('--force', 'Overwrite graph content even if conflicts exist')
+        .option('--all', 'Push all content files (ignore change detection)')
+        .option('--no-events', 'Skip pushing event files (JSONL)')
+        .addHelpText('after', `
+${chalk.gray('Subcommands:')}
+  ${chalk.green('ginko push')}                     ${chalk.dim('Push all changes since last push')}
+  ${chalk.green('ginko push epic')}                 ${chalk.dim('Push only changed epics')}
+  ${chalk.green('ginko push epic EPIC-001')}        ${chalk.dim('Push specific epic')}
+  ${chalk.green('ginko push sprint e001_s01')}      ${chalk.dim('Push specific sprint')}
+  ${chalk.green('ginko push charter')}              ${chalk.dim('Push charter')}
+  ${chalk.green('ginko push adr')}                  ${chalk.dim('Push all changed ADRs')}
+
+${chalk.gray('Options:')}
+  ${chalk.dim('--dry-run    Preview what would be pushed')}
+  ${chalk.dim('--force      Overwrite graph even if conflicts')}
+  ${chalk.dim('--all        Push all content (not just changes)')}
+  ${chalk.dim('--no-events  Skip event files')}
+
+${chalk.gray('Examples:')}
+  ${chalk.green('ginko push')} ${chalk.dim('# Push all changes since last push')}
+  ${chalk.green('ginko push --dry-run')} ${chalk.dim('# Preview changes')}
+  ${chalk.green('ginko push epic')} ${chalk.dim('# Push only epics')}
+  ${chalk.green('ginko push sprint e015_s01')} ${chalk.dim('# Push specific sprint')}
+  ${chalk.green('ginko push --all')} ${chalk.dim('# Full push (like graph load)')}
+`);
+    // Default action (no subcommand): push all changes
+    push.action(async (options) => {
+        await pushCommand({
+            dryRun: options.dryRun === true,
+            force: options.force === true,
+            all: options.all === true,
+            events: options.events !== false,
+        });
+    });
+    // Subcommand: push epic [id]
+    push
+        .command('epic [epicId]')
+        .description('Push changed epic(s) to graph')
+        .option('--dry-run', 'Preview what would be pushed')
+        .option('--force', 'Overwrite graph content')
+        .action(async (epicId, subOptions) => {
+        await pushCommand({
+            entityType: 'epic',
+            entityId: epicId,
+            dryRun: subOptions.dryRun === true || push.opts().dryRun === true,
+            force: subOptions.force === true || push.opts().force === true,
+            events: false,
+        });
+    });
+    // Subcommand: push sprint [id]
+    push
+        .command('sprint [sprintId]')
+        .description('Push changed sprint(s) to graph')
+        .option('--dry-run', 'Preview what would be pushed')
+        .option('--force', 'Overwrite graph content')
+        .action(async (sprintId, subOptions) => {
+        await pushCommand({
+            entityType: 'sprint',
+            entityId: sprintId,
+            dryRun: subOptions.dryRun === true || push.opts().dryRun === true,
+            force: subOptions.force === true || push.opts().force === true,
+            events: false,
+        });
+    });
+    // Subcommand: push charter
+    push
+        .command('charter')
+        .description('Push project charter to graph')
+        .option('--dry-run', 'Preview what would be pushed')
+        .option('--force', 'Overwrite graph content')
+        .action(async (subOptions) => {
+        await pushCommand({
+            entityType: 'charter',
+            dryRun: subOptions.dryRun === true || push.opts().dryRun === true,
+            force: subOptions.force === true || push.opts().force === true,
+            events: false,
+        });
+    });
+    // Subcommand: push adr [id]
+    push
+        .command('adr [adrId]')
+        .description('Push changed ADR(s) to graph')
+        .option('--dry-run', 'Preview what would be pushed')
+        .option('--force', 'Overwrite graph content')
+        .action(async (adrId, subOptions) => {
+        await pushCommand({
+            entityType: 'adr',
+            entityId: adrId,
+            dryRun: subOptions.dryRun === true || push.opts().dryRun === true,
+            force: subOptions.force === true || push.opts().force === true,
+            events: false,
+        });
+    });
+    return push;
+}
+export { pushCommand } from './push-command.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/push/index.js.map

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

package/dist/commands/push/push-command.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2026-01-30
+ * @tags: [push, sync, graph, git, ADR-077]
+ * @related: [index.ts, ../../lib/sync-state.ts, ../../lib/git-change-detector.ts, ../../lib/entity-classifier.ts, ../graph/api-client.ts]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [chalk, fs-extra, crypto, simple-git]
+ */
+export interface PushOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    all?: boolean;
+    /** Entity type filter (from subcommand: epic, sprint, charter, adr, etc.) */
+    entityType?: string;
+    /** Specific entity ID (e.g., EPIC-001, e001_s01) */
+    entityId?: string;
+    /** Include events (session JSONL) in push */
+    events?: boolean;
+    /** Quiet mode for auto-push (minimal output) */
+    quiet?: boolean;
+}
+export interface PushResult {
+    pushed: string[];
+    skipped: string[];
+    errors: string[];
+    tasksSynced: {
+        created: number;
+        updated: number;
+        relationships: number;
+    };
+    eventsPushed: number;
+}
+/**
+ * Main push command implementation
+ */
+export declare function pushCommand(options: PushOptions): Promise<PushResult>;
+//# sourceMappingURL=push-command.d.ts.map

package/dist/commands/push/push-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-command.d.ts","sourceRoot":"","sources":["../../../src/commands/push/push-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+BH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;IACzE,YAAY,EAAE,MAAM,CAAC;CACtB;AA+JD;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAoT3E"}