@ginkoai/cli 1.0.0 → 1.4.1

package/dist/commands/graph/api-client.js

@@ -0,0 +1,143 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-10-31
+ * @tags: [graph, api, cloud, http-client]
+ * @related: [init.ts, load.ts, query.ts, status.ts, explore.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [auth-storage]
+ */
+import { getAccessToken, isAuthenticated } from '../../utils/auth-storage.js';
+/**
+ * API client for Ginko Cloud graph operations
+ */
+export class GraphApiClient {
+    apiUrl;
+    constructor(apiUrl) {
+        // Use GINKO_GRAPH_API_URL for graph operations (separate from auth API)
+        this.apiUrl = apiUrl || process.env.GINKO_GRAPH_API_URL || process.env.GINKO_API_URL || 'https://app.ginkoai.com';
+    }
+    /**
+     * Check if user is authenticated
+     */
+    async requireAuth() {
+        if (!await isAuthenticated()) {
+            throw new Error('Not authenticated. Run "ginko login" first.');
+        }
+        const token = await getAccessToken();
+        if (!token) {
+            throw new Error('Failed to get access token. Run "ginko login" again.');
+        }
+        return token;
+    }
+    /**
+     * Make authenticated API request
+     */
+    async request(method, endpoint, body) {
+        const token = await this.requireAuth();
+        const response = await fetch(`${this.apiUrl}${endpoint}`, {
+            method,
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Content-Type': 'application/json',
+                'X-Client-Version': 'ginko-cli@1.2.0',
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const errorData = await response.json();
+            throw new Error(errorData.error.message || `API error: ${response.status}`);
+        }
+        return response.json();
+    }
+    /**
+     * Initialize a new graph namespace
+     */
+    async initGraph(data) {
+        return this.request('POST', '/api/v1/graph/init', data);
+    }
+    /**
+     * Upload documents for processing
+     */
+    async uploadDocuments(graphId, documents) {
+        return this.request('POST', '/api/v1/graph/documents', {
+            graphId,
+            documents,
+        });
+    }
+    /**
+     * Check job status
+     */
+    async getJobStatus(jobId) {
+        return this.request('GET', `/api/v1/graph/jobs/${jobId}`);
+    }
+    /**
+     * Get graph status and statistics
+     */
+    async getGraphStatus(graphId) {
+        return this.request('GET', `/api/v1/graph/status?graphId=${graphId}`);
+    }
+    /**
+     * Perform semantic query
+     */
+    async query(data) {
+        return this.request('POST', '/api/v1/graph/query', data);
+    }
+    /**
+     * Explore document connections
+     */
+    async explore(graphId, documentId, depth) {
+        const params = new URLSearchParams({ graphId });
+        if (depth)
+            params.append('depth', depth.toString());
+        return this.request('GET', `/api/v1/graph/explore/${documentId}?${params}`);
+    }
+    /**
+     * Poll job until completion
+     */
+    async pollJob(jobId, onProgress) {
+        let attempts = 0;
+        const maxAttempts = 120; // 2 minutes max
+        while (attempts < maxAttempts) {
+            const status = await this.getJobStatus(jobId);
+            if (onProgress) {
+                onProgress(status.job.progress);
+            }
+            if (status.job.status === 'completed') {
+                return status;
+            }
+            if (status.job.status === 'failed') {
+                throw new Error('Job failed to complete');
+            }
+            // Wait 1 second before next poll
+            await new Promise(resolve => setTimeout(resolve, 1000));
+            attempts++;
+        }
+        throw new Error('Job polling timeout');
+    }
+    /**
+     * Create events in the graph (for event stream)
+     */
+    async createEvents(graphId, events) {
+        return this.request('POST', '/api/v1/graph/events', {
+            graphId,
+            events
+        });
+    }
+}
+/**
+ * Helper function to create graph events with default client
+ * Used by event-queue for async syncing
+ */
+export async function createGraphEvents(events) {
+    if (!isAuthenticated()) {
+        throw new Error('Not authenticated. Run `ginko graph init` first.');
+    }
+    const client = new GraphApiClient();
+    // TODO: Get graphId from config or session context
+    // For now, use a placeholder that will be replaced in integration
+    const graphId = process.env.GINKO_GRAPH_ID || 'default';
+    await client.createEvents(graphId, events);
+}
+//# sourceMappingURL=api-client.js.map

package/dist/commands/graph/api-client.js.map

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

package/dist/commands/graph/config.d.ts

@@ -0,0 +1,82 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-10-31
+ * @tags: [graph, config, storage]
+ * @related: [init.ts, load.ts, status.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [fs-extra]
+ */
+export interface GraphConfig {
+    version: string;
+    graphId: string;
+    namespace: string;
+    projectName: string;
+    visibility: 'private' | 'organization' | 'public';
+    apiEndpoint: string;
+    documents: {
+        adr: {
+            enabled: boolean;
+            path: string;
+        };
+        prd: {
+            enabled: boolean;
+            path: string;
+        };
+        patterns: {
+            enabled: boolean;
+            path: string;
+        };
+        sessions: {
+            enabled: boolean;
+            path: string;
+        };
+    };
+    hashes: Record<string, string>;
+    lastSync: string;
+}
+/**
+ * Get path to graph config file
+ */
+export declare function getGraphConfigPath(): Promise<string>;
+/**
+ * Load graph configuration
+ */
+export declare function loadGraphConfig(): Promise<GraphConfig | null>;
+/**
+ * Save graph configuration
+ */
+export declare function saveGraphConfig(config: GraphConfig): Promise<void>;
+/**
+ * Check if graph is initialized
+ */
+export declare function isGraphInitialized(): Promise<boolean>;
+/**
+ * Get graph ID from config
+ */
+export declare function getGraphId(): Promise<string | null>;
+/**
+ * Helper: Get config (alias for loadGraphConfig)
+ */
+export declare function getConfig(): Promise<Partial<GraphConfig> & {
+    graphId?: string;
+    apiUrl?: string;
+}>;
+/**
+ * Helper: Get API token from auth storage
+ */
+export declare function getApiToken(): Promise<string | null>;
+/**
+ * Update document hash
+ */
+export declare function updateDocumentHash(filePath: string, hash: string): Promise<void>;
+/**
+ * Get document hash
+ */
+export declare function getDocumentHash(filePath: string): Promise<string | null>;
+/**
+ * Create default graph config
+ */
+export declare function createDefaultConfig(graphId: string, namespace: string, projectName: string, visibility?: 'private' | 'organization' | 'public'): GraphConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/graph/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/commands/graph/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,SAAS,GAAG,cAAc,GAAG,QAAQ,CAAC;IAClD,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE;QACT,GAAG,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACxC,GAAG,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACxC,QAAQ,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,QAAQ,EAAE;YAAE,OAAO,EAAE,OAAO,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KAC9C,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,CAG1D;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAanE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAIxE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAG3D;AAED;;GAEG;AACH,wBAAsB,UAAU,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGzD;AAED;;GAEG;AACH,wBAAsB,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAGvG;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG1D;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWtF;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,SAAS,GAAG,cAAc,GAAG,QAAoB,GAC5D,WAAW,CAiBb"}

package/dist/commands/graph/config.js

@@ -0,0 +1,113 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-10-31
+ * @tags: [graph, config, storage]
+ * @related: [init.ts, load.ts, status.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [fs-extra]
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { getGinkoDir } from '../../utils/helpers.js';
+/**
+ * Get path to graph config file
+ */
+export async function getGraphConfigPath() {
+    const ginkoDir = await getGinkoDir();
+    return path.join(ginkoDir, 'graph', 'config.json');
+}
+/**
+ * Load graph configuration
+ */
+export async function loadGraphConfig() {
+    const configPath = await getGraphConfigPath();
+    if (!await fs.pathExists(configPath)) {
+        return null;
+    }
+    try {
+        return await fs.readJson(configPath);
+    }
+    catch (error) {
+        console.error('Error reading graph config:', error);
+        return null;
+    }
+}
+/**
+ * Save graph configuration
+ */
+export async function saveGraphConfig(config) {
+    const configPath = await getGraphConfigPath();
+    await fs.ensureDir(path.dirname(configPath));
+    await fs.writeJson(configPath, config, { spaces: 2 });
+}
+/**
+ * Check if graph is initialized
+ */
+export async function isGraphInitialized() {
+    const config = await loadGraphConfig();
+    return config !== null && !!config.graphId;
+}
+/**
+ * Get graph ID from config
+ */
+export async function getGraphId() {
+    const config = await loadGraphConfig();
+    return config?.graphId || null;
+}
+/**
+ * Helper: Get config (alias for loadGraphConfig)
+ */
+export async function getConfig() {
+    const config = await loadGraphConfig();
+    return config ? { ...config, apiUrl: config.apiEndpoint } : { apiUrl: process.env.GINKO_API_URL };
+}
+/**
+ * Helper: Get API token from auth storage
+ */
+export async function getApiToken() {
+    const { getAccessToken } = await import('../../utils/auth-storage.js');
+    return getAccessToken();
+}
+/**
+ * Update document hash
+ */
+export async function updateDocumentHash(filePath, hash) {
+    const config = await loadGraphConfig();
+    if (!config) {
+        throw new Error('Graph not initialized. Run "ginko graph init" first.');
+    }
+    config.hashes[filePath] = hash;
+    config.lastSync = new Date().toISOString();
+    await saveGraphConfig(config);
+}
+/**
+ * Get document hash
+ */
+export async function getDocumentHash(filePath) {
+    const config = await loadGraphConfig();
+    return config?.hashes[filePath] || null;
+}
+/**
+ * Create default graph config
+ */
+export function createDefaultConfig(graphId, namespace, projectName, visibility = 'private') {
+    return {
+        version: '1.0',
+        graphId,
+        namespace,
+        projectName,
+        visibility,
+        apiEndpoint: process.env.GINKO_API_URL || 'https://api.ginko.ai',
+        documents: {
+            adr: { enabled: true, path: 'docs/adr' },
+            prd: { enabled: true, path: 'docs/PRD' },
+            patterns: { enabled: true, path: '.ginko/context/modules' },
+            sessions: { enabled: true, path: '.ginko/sessions' },
+        },
+        hashes: {},
+        lastSync: new Date().toISOString(),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/commands/graph/config.js.map

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

package/dist/commands/graph/explore.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-10-31
+ * @tags: [graph, explore, connections, cli]
+ * @related: [api-client.ts, config.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk, api-client, config]
+ */
+interface ExploreOptions {
+    depth?: number;
+}
+/**
+ * Explore document and its connections
+ */
+export declare function exploreCommand(documentId: string, options: ExploreOptions): Promise<void>;
+export {};
+//# sourceMappingURL=explore.d.ts.map

package/dist/commands/graph/explore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explore.d.ts","sourceRoot":"","sources":["../../../src/commands/graph/explore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoH/F"}

package/dist/commands/graph/explore.js

@@ -0,0 +1,117 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-10-31
+ * @tags: [graph, explore, connections, cli]
+ * @related: [api-client.ts, config.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk, api-client, config]
+ */
+import chalk from 'chalk';
+import { GraphApiClient } from './api-client.js';
+import { loadGraphConfig, isGraphInitialized } from './config.js';
+/**
+ * Explore document and its connections
+ */
+export async function exploreCommand(documentId, options) {
+    try {
+        // Check if graph is initialized
+        if (!await isGraphInitialized()) {
+            console.log(chalk.yellow('⚠️  Graph not initialized'));
+            console.log(chalk.dim('Run "ginko graph init" to create your knowledge graph'));
+            return;
+        }
+        const config = await loadGraphConfig();
+        if (!config) {
+            console.log(chalk.red('✗ Failed to load graph configuration'));
+            return;
+        }
+        // Explore document
+        const client = new GraphApiClient(config.apiEndpoint);
+        const result = await client.explore(config.graphId, documentId, options.depth);
+        const emoji = result.document.type === 'ADR' ? '📄' :
+            result.document.type === 'PRD' ? '📋' :
+                result.document.type === 'Pattern' ? '🎨' :
+                    result.document.type === 'Gotcha' ? '⚠️' :
+                        result.document.type === 'Session' ? '📝' : '📁';
+        console.log(chalk.green(`\n${emoji} ${result.document.type}: ${result.document.title}`));
+        console.log(chalk.gray('─'.repeat(50)));
+        // Summary
+        console.log(`\n${chalk.bold('Summary')}:`);
+        console.log(`  ${result.document.summary}`);
+        // Tags
+        if (result.document.tags.length > 0) {
+            console.log(`\n${chalk.bold('Tags')}: ${result.document.tags.map(t => chalk.cyan(t)).join(', ')}`);
+        }
+        // File path
+        console.log(`\n${chalk.bold('Path')}: ${chalk.dim(result.document.filePath)}`);
+        // Metadata
+        if (result.document.metadata && Object.keys(result.document.metadata).length > 0) {
+            console.log(`\n${chalk.bold('Metadata')}:`);
+            for (const [key, value] of Object.entries(result.document.metadata)) {
+                console.log(`  ${key}: ${chalk.cyan(String(value))}`);
+            }
+        }
+        // Relationships
+        console.log(`\n${chalk.bold('Relationships')}:`);
+        // Implements
+        if (result.relationships.implements && result.relationships.implements.length > 0) {
+            console.log(`\n  ${chalk.bold('Implements')}:`);
+            result.relationships.implements.forEach(rel => {
+                console.log(`    → ${chalk.cyan(`[${rel.type}] ${rel.title}`)} (${rel.id})`);
+            });
+        }
+        // Referenced by
+        if (result.relationships.referencedBy && result.relationships.referencedBy.length > 0) {
+            console.log(`\n  ${chalk.bold('Referenced by')}:`);
+            result.relationships.referencedBy.forEach(rel => {
+                console.log(`    ← ${chalk.cyan(`[${rel.type}] ${rel.title}`)} (${rel.id})`);
+            });
+        }
+        // Similar to
+        if (result.relationships.similarTo && result.relationships.similarTo.length > 0) {
+            console.log(`\n  ${chalk.bold('Similar to')}:`);
+            result.relationships.similarTo.forEach(rel => {
+                const similarity = rel.similarity ? chalk.dim(`${(rel.similarity * 100).toFixed(0)}%`) : '';
+                console.log(`    ↔ ${chalk.cyan(`[${rel.type}] ${rel.title}`)} (${rel.id}) ${similarity}`);
+            });
+        }
+        // Applied patterns
+        if (result.relationships.appliedPatterns && result.relationships.appliedPatterns.length > 0) {
+            console.log(`\n  ${chalk.bold('Applied patterns')}:`);
+            result.relationships.appliedPatterns.forEach(rel => {
+                console.log(`    ← ${chalk.cyan(`[${rel.type}] ${rel.title}`)} (${rel.id})`);
+            });
+        }
+        // Connection summary
+        console.log(`\n${chalk.bold('Connections')}: ${chalk.green(result.totalConnections)} total`);
+        if (Object.keys(result.connectionsByType).length > 0) {
+            console.log(chalk.dim('  Breakdown:'));
+            for (const [type, count] of Object.entries(result.connectionsByType)) {
+                console.log(chalk.dim(`    ${type}: ${count}`));
+            }
+        }
+        // Timestamps
+        console.log(`\n${chalk.dim('Created')}: ${new Date(result.document.createdAt).toLocaleString()}`);
+        console.log(chalk.dim(`Updated: ${new Date(result.document.updatedAt).toLocaleString()}`));
+        console.log(chalk.gray('\n' + '─'.repeat(50)));
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(chalk.red(`\n✗ Error: ${error.message}`));
+            if (error.message.includes('Not authenticated')) {
+                console.log(chalk.dim('\nRun "ginko login" to authenticate with Ginko Cloud'));
+            }
+            else if (error.message.includes('not found')) {
+                console.log(chalk.dim(`\nDocument "${documentId}" not found in graph`));
+                console.log(chalk.dim('Use "ginko graph query" to search for documents'));
+            }
+        }
+        else {
+            console.error(chalk.red('\n✗ An unexpected error occurred'));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=explore.js.map

package/dist/commands/graph/explore.js.map

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

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

@@ -0,0 +1,17 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-10-31
+ * @tags: [graph, cli, knowledge-graph, cloud]
+ * @related: [init.ts, load.ts, status.ts, query.ts, explore.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [commander, chalk]
+ */
+import { Command } from 'commander';
+/**
+ * Main graph command with subcommands for knowledge graph operations
+ */
+export declare function graphCommand(): Command;
+export default graphCommand;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/graph/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC;;GAEG;AACH,wBAAgB,YAAY,YAsF3B;AAGD,eAAe,YAAY,CAAC"}

package/dist/commands/graph/index.js

@@ -0,0 +1,104 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-10-31
+ * @tags: [graph, cli, knowledge-graph, cloud]
+ * @related: [init.ts, load.ts, status.ts, query.ts, explore.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [commander, chalk]
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { initCommand } from './init.js';
+import { loadCommand } from './load.js';
+import { statusCommand } from './status.js';
+import { queryCommand } from './query.js';
+import { exploreCommand } from './explore.js';
+/**
+ * Main graph command with subcommands for knowledge graph operations
+ */
+export function graphCommand() {
+    const graph = new Command('graph')
+        .description('Manage cloud-based knowledge graph for project documentation')
+        .showHelpAfterError('(use --help for additional information)')
+        .addHelpText('after', `
+${chalk.gray('Quick Start:')}
+  ${chalk.green('ginko login')}                                   ${chalk.gray('# Authenticate with Ginko Cloud')}
+  ${chalk.green('ginko graph init')}                              ${chalk.gray('# Initialize graph for your project')}
+  ${chalk.green('ginko graph status')}                            ${chalk.gray('# View graph statistics')}
+
+${chalk.gray('Usage Examples:')}
+  ${chalk.green('ginko graph query')} "authentication patterns"    ${chalk.gray('# Semantic search')}
+  ${chalk.green('ginko graph explore')} ADR-039                    ${chalk.gray('# Explore document connections')}
+  ${chalk.green('ginko graph load')} --docs-only                   ${chalk.gray('# Reload ADRs and PRDs only')}
+
+${chalk.gray('Features:')}
+  ${chalk.cyan('☁️  Cloud-First')}      - No Neo4j setup required
+  ${chalk.cyan('🚀 Instant Processing')} - Cloud GPUs handle embeddings
+  ${chalk.cyan('👥 Team Sharing')}      - Share graphs across organization
+  ${chalk.cyan('🔒 Private by Default')} - Your data stays in your namespace
+  ${chalk.cyan('💾 Auto-Synced')}       - Changes sync automatically
+
+${chalk.gray('Learn More:')}
+  ${chalk.dim('https://docs.ginko.ai/graph')}
+`)
+        .action(() => {
+        // When called without subcommand, show help
+        graph.help({ error: false });
+    });
+    // Initialize graph
+    graph
+        .command('init')
+        .description('Initialize knowledge graph for your project')
+        .option('--quick', 'Quick initialization without prompts')
+        .option('--skip-load', 'Initialize config only, don\'t load documents yet')
+        .option('--visibility <level>', 'Graph visibility: private, organization, public', 'private')
+        .action(async (options) => {
+        await initCommand(options);
+    });
+    // Load documents
+    graph
+        .command('load')
+        .description('Upload documents to knowledge graph')
+        .option('--docs-only', 'Load ADRs and PRDs only (skip patterns, sessions)')
+        .option('--extended-only', 'Load patterns, gotchas, sessions only (skip docs)')
+        .option('--force', 'Reload all documents even if unchanged')
+        .action(async (options) => {
+        await loadCommand(options);
+    });
+    // Show status
+    graph
+        .command('status')
+        .description('Show graph statistics and health')
+        .action(async () => {
+        await statusCommand();
+    });
+    // Semantic query
+    graph
+        .command('query <text>')
+        .description('Search documents using semantic similarity')
+        .option('-l, --limit <number>', 'Maximum results to return', '10')
+        .option('-t, --threshold <number>', 'Minimum similarity score (0-1)', '0.70')
+        .option('--types <types>', 'Filter by document types (comma-separated)', '')
+        .option('--table', 'Display results in table format')
+        .option('--semantic', 'Use semantic search (enabled by default)')
+        .action(async (text, options) => {
+        const limit = parseInt(options.limit, 10);
+        const threshold = parseFloat(options.threshold);
+        await queryCommand(text, { ...options, limit, threshold });
+    });
+    // Explore document
+    graph
+        .command('explore <documentId>')
+        .description('Explore document and its connections')
+        .option('-d, --depth <number>', 'Relationship depth to traverse (1-3)', '1')
+        .action(async (documentId, options) => {
+        const depth = parseInt(options.depth, 10);
+        await exploreCommand(documentId, { depth });
+    });
+    return graph;
+}
+// Export for use in main CLI
+export default graphCommand;
+//# sourceMappingURL=index.js.map

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

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