@ginkoai/cli 1.6.1 → 1.7.0

package/README.md

@@ -33,6 +33,19 @@ ginko status
 - `ginko start [sessionId]` - Start or resume a session
 - `ginko handoff [message]` - Create a session handoff
 - `ginko status` - Show current session status
+- `ginko log [description]` - Log events to session (ADR-033 defensive logging)
+
+### Planning & Organization
+- `ginko charter` - Create and manage project charter (AI-assisted)
+  - Default: Output template for AI-mediated conversation
+  - `--view` - View existing charter
+  - `--edit` - Edit charter conversationally
+  - `--no-ai` - Interactive CLI mode
+- `ginko epic` - Create and manage epics with sprint breakdown (AI-assisted)
+  - Default: Output template for AI-mediated conversation
+  - `--list` - List existing epics
+  - `--view` - View epic details with sprint progress
+  - `--sync` - Sync epic to graph database
 
 ### Context & Configuration
 - `ginko context` - Manage session context
@@ -180,6 +193,27 @@ ginko context --show                  # View tracked files
 ginko compact                          # Clean up old context
 ```
 
+### Planning with Epics
+```bash
+ginko epic                           # AI guides epic creation conversation
+# AI asks about goals, success criteria, scope, sprints
+# Creates docs/sprints/EPIC-XXX-name.md and sprint files
+
+ginko epic --list                    # List all epics
+ginko epic --view                    # View epic with sprint progress
+ginko epic --sync                    # Sync to graph database
+```
+
+### Project Charter
+```bash
+ginko charter                        # AI guides charter conversation
+# AI asks about purpose, users, success criteria, scope
+# Creates docs/PROJECT-CHARTER.md
+
+ginko charter --view                 # View existing charter
+ginko charter --edit                 # Refine charter conversationally
+```
+
 ## Future Features
 
 ### Persistent Context Modules (Coming Soon)

package/dist/commands/agent/agent-client.d.ts

@@ -0,0 +1,150 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-12-05
+ * @tags: [agent, api, client, epic-004, multi-agent]
+ * @related: [register.ts, list.ts, status.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [auth-storage]
+ */
+interface RegisterAgentRequest {
+    name: string;
+    capabilities: string[];
+    status?: 'active' | 'idle' | 'busy' | 'offline';
+    metadata?: Record<string, any>;
+}
+interface RegisterAgentResponse {
+    agentId: string;
+    name: string;
+    capabilities: string[];
+    status: string;
+    organizationId: string;
+    createdAt: string;
+}
+interface ListAgentsRequest {
+    status?: string;
+    capability?: string;
+    limit?: number;
+    offset?: number;
+}
+interface ListAgentsResponse {
+    agents: Array<{
+        id: string;
+        name: string;
+        capabilities: string[];
+        status: string;
+        organizationId: string;
+        createdAt: string;
+        updatedAt: string;
+        metadata?: Record<string, any>;
+    }>;
+    total: number;
+    limit: number;
+    offset: number;
+}
+interface AvailableTask {
+    id: string;
+    title: string;
+    description: string;
+    effort: string;
+    priority: number;
+    requiredCapabilities: string[];
+    sprintId: string;
+}
+interface AvailableTasksResponse {
+    tasks: AvailableTask[];
+    total: number;
+}
+interface ClaimTaskResponse {
+    task: {
+        id: string;
+        status: string;
+        claimedAt: string;
+    };
+    agent: {
+        id: string;
+        name: string;
+        status: string;
+    };
+}
+interface ReleaseTaskResponse {
+    success: boolean;
+    taskId: string;
+    status: string;
+    agentId: string;
+    releasedAt: string;
+}
+interface TaskContextResponse {
+    files: string[];
+    acceptanceCriteria: Array<{
+        id: string;
+        description: string;
+        verifiable: boolean;
+    }>;
+    patterns: Array<{
+        id: string;
+        name: string;
+        confidence: string;
+    }>;
+    gotchas: Array<{
+        id: string;
+        description: string;
+        severity: string;
+    }>;
+    constraints: Array<{
+        id: string;
+        type: string;
+        description: string;
+    }>;
+}
+/**
+ * Agent API client
+ */
+export declare class AgentClient {
+    private static apiUrl;
+    /**
+     * Check if user is authenticated
+     */
+    private static requireAuth;
+    /**
+     * Make authenticated API request
+     */
+    private static request;
+    /**
+     * Register a new agent
+     */
+    static register(data: RegisterAgentRequest): Promise<RegisterAgentResponse>;
+    /**
+     * List agents with optional filtering
+     */
+    static list(params?: ListAgentsRequest): Promise<ListAgentsResponse>;
+    /**
+     * Get available tasks that match agent capabilities
+     * @param graphId - Graph namespace ID
+     * @param capabilities - Agent capabilities to match
+     * @param limit - Max tasks to return
+     */
+    static getAvailableTasks(graphId: string, capabilities?: string[], limit?: number): Promise<AvailableTasksResponse>;
+    /**
+     * Claim a task atomically
+     * @param taskId - Task ID to claim
+     * @param agentId - Agent ID claiming the task
+     * @returns ClaimTaskResponse if successful, or throws error on conflict
+     */
+    static claimTask(taskId: string, agentId: string): Promise<ClaimTaskResponse>;
+    /**
+     * Release a claimed task back to available
+     * @param taskId - Task ID to release
+     * @param agentId - Agent ID releasing the task
+     */
+    static releaseTask(taskId: string, agentId: string): Promise<ReleaseTaskResponse>;
+    /**
+     * Get task context (files, acceptance criteria, patterns, gotchas)
+     * @param taskId - Task ID to get context for
+     * @param graphId - Graph namespace ID
+     */
+    static getTaskContext(taskId: string, graphId: string): Promise<TaskContextResponse>;
+}
+export type { AvailableTask, ClaimTaskResponse, TaskContextResponse };
+//# sourceMappingURL=agent-client.d.ts.map

package/dist/commands/agent/agent-client.d.ts.map

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

package/dist/commands/agent/agent-client.js

@@ -0,0 +1,170 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-12-05
+ * @tags: [agent, api, client, epic-004, multi-agent]
+ * @related: [register.ts, list.ts, status.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [auth-storage]
+ */
+/**
+ * Agent API Client (EPIC-004 Sprint 1 TASK-6)
+ *
+ * Client for interacting with agent management API endpoints
+ */
+import { getAccessToken, isAuthenticated } from '../../utils/auth-storage.js';
+/**
+ * Agent API client
+ */
+export class AgentClient {
+    static apiUrl = process.env.GINKO_API_URL || 'https://app.ginkoai.com';
+    /**
+     * Check if user is authenticated
+     */
+    static 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
+     */
+    static async request(method, endpoint, body) {
+        const token = await this.requireAuth();
+        const url = `${this.apiUrl}${endpoint}`;
+        const debugMode = process.env.GINKO_DEBUG_API === 'true';
+        if (debugMode) {
+            console.log(`\n[Agent API Debug] ${method} ${url}`);
+            if (body) {
+                console.log('[Agent API Debug] Request body:', JSON.stringify(body, null, 2));
+            }
+        }
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Authorization': `Bearer ${token}`,
+                    'Content-Type': 'application/json',
+                    'X-Client-Version': 'ginko-cli@1.2.0',
+                },
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            if (debugMode) {
+                console.log(`[Agent API Debug] Response status: ${response.status} ${response.statusText}`);
+            }
+            if (!response.ok) {
+                const errorData = await response.json();
+                if (debugMode) {
+                    console.log('[Agent API Debug] Error response:', JSON.stringify(errorData, null, 2));
+                }
+                throw new Error(errorData.error.message || `API error: ${response.status}`);
+            }
+            const responseData = await response.json();
+            if (debugMode) {
+                console.log('[Agent API Debug] Response data:', JSON.stringify(responseData, null, 2));
+            }
+            return responseData;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`Failed to ${method} ${url}: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    /**
+     * Register a new agent
+     */
+    static async register(data) {
+        return this.request('POST', '/api/v1/agent', data);
+    }
+    /**
+     * List agents with optional filtering
+     */
+    static async list(params = {}) {
+        const queryParams = new URLSearchParams();
+        if (params.status) {
+            queryParams.append('status', params.status);
+        }
+        if (params.capability) {
+            queryParams.append('capability', params.capability);
+        }
+        if (params.limit !== undefined) {
+            queryParams.append('limit', params.limit.toString());
+        }
+        if (params.offset !== undefined) {
+            queryParams.append('offset', params.offset.toString());
+        }
+        const queryString = queryParams.toString();
+        const endpoint = queryString ? `/api/v1/agent?${queryString}` : '/api/v1/agent';
+        return this.request('GET', endpoint);
+    }
+    // ============================================================
+    // EPIC-004 Sprint 4 TASK-8: Task Management Methods
+    // ============================================================
+    /**
+     * Get available tasks that match agent capabilities
+     * @param graphId - Graph namespace ID
+     * @param capabilities - Agent capabilities to match
+     * @param limit - Max tasks to return
+     */
+    static async getAvailableTasks(graphId, capabilities, limit = 10) {
+        const queryParams = new URLSearchParams();
+        queryParams.append('graphId', graphId);
+        queryParams.append('limit', limit.toString());
+        if (capabilities && capabilities.length > 0) {
+            queryParams.append('capabilities', capabilities.join(','));
+        }
+        return this.request('GET', `/api/v1/task/available?${queryParams.toString()}`);
+    }
+    /**
+     * Claim a task atomically
+     * @param taskId - Task ID to claim
+     * @param agentId - Agent ID claiming the task
+     * @returns ClaimTaskResponse if successful, or throws error on conflict
+     */
+    static async claimTask(taskId, agentId) {
+        const request = { agentId };
+        return this.request('POST', `/api/v1/task/${taskId}/claim`, request);
+    }
+    /**
+     * Release a claimed task back to available
+     * @param taskId - Task ID to release
+     * @param agentId - Agent ID releasing the task
+     */
+    static async releaseTask(taskId, agentId) {
+        const request = { agentId };
+        return this.request('POST', `/api/v1/task/${taskId}/release`, request);
+    }
+    /**
+     * Get task context (files, acceptance criteria, patterns, gotchas)
+     * @param taskId - Task ID to get context for
+     * @param graphId - Graph namespace ID
+     */
+    static async getTaskContext(taskId, graphId) {
+        // Load context from multiple endpoints in parallel
+        const [files, patterns, gotchas, constraints] = await Promise.all([
+            this.request('GET', `/api/v1/task/${taskId}/files?graphId=${graphId}`)
+                .catch(() => ({ files: [] })),
+            this.request('GET', `/api/v1/task/${taskId}/patterns?graphId=${graphId}`).catch(() => ({ patterns: [] })),
+            this.request('GET', `/api/v1/task/${taskId}/gotchas?graphId=${graphId}`).catch(() => ({ gotchas: [] })),
+            this.request('GET', `/api/v1/task/${taskId}/constraints?graphId=${graphId}`).catch(() => ({ constraints: [] })),
+        ]);
+        // Acceptance criteria come from the task itself (loaded locally)
+        // For now return empty - will be parsed from sprint file
+        return {
+            files: files.files || [],
+            acceptanceCriteria: [],
+            patterns: patterns.patterns || [],
+            gotchas: gotchas.gotchas || [],
+            constraints: constraints.constraints || [],
+        };
+    }
+}
+//# sourceMappingURL=agent-client.js.map

package/dist/commands/agent/agent-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-client.js","sourceRoot":"","sources":["../../../src/commands/agent/agent-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;GAIG;AAEH,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAuH9E;;GAEG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAC,MAAM,GAAW,OAAO,CAAC,GAAG,CAAC,aAAa,IAAI,yBAAyB,CAAC;IAEvF;;OAEG;IACK,MAAM,CAAC,KAAK,CAAC,WAAW;QAC9B,IAAI,CAAC,MAAM,eAAe,EAAE,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,cAAc,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,KAAK,CAAC,OAAO,CAC1B,MAAc,EACd,QAAgB,EAChB,IAAc;QAEd,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACvC,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,QAAQ,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,KAAK,MAAM,CAAC;QAEzD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,IAAI,GAAG,EAAE,CAAC,CAAC;YACpD,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,GAAG,CAAC,iCAAiC,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YAChF,CAAC;QACH,CAAC;QAED,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM;gBACN,OAAO,EAAE;oBACP,eAAe,EAAE,UAAU,KAAK,EAAE;oBAClC,cAAc,EAAE,kBAAkB;oBAClC,kBAAkB,EAAE,iBAAiB;iBACtC;gBACD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;aAC9C,CAAC,CAAC;YAEH,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,sCAAsC,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;YAC9F,CAAC;YAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAc,CAAC;gBACpD,IAAI,SAAS,EAAE,CAAC;oBACd,OAAO,CAAC,GAAG,CAAC,mCAAmC,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBACvF,CAAC;gBAED,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,OAAO,IAAI,cAAc,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;YAC9E,CAAC;YAED,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAO,CAAC;YAChD,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,CAAC,GAAG,CAAC,kCAAkC,EAAE,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACzF,CAAC;YAED,OAAO,YAAY,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,aAAa,MAAM,IAAI,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,IAA0B;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAwB,MAAM,EAAE,eAAe,EAAE,IAAI,CAAC,CAAC;IAC5E,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAA4B,EAAE;QAC9C,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAE1C,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClB,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9C,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,WAAW,CAAC,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;QACtD,CAAC;QAED,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;YAC/B,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QACvD,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC3C,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC;QAEhF,OAAO,IAAI,CAAC,OAAO,CAAqB,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;IAED,+DAA+D;IAC/D,oDAAoD;IACpD,+DAA+D;IAE/D;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,iBAAiB,CAC5B,OAAe,EACf,YAAuB,EACvB,QAAgB,EAAE;QAElB,MAAM,WAAW,GAAG,IAAI,eAAe,EAAE,CAAC;QAC1C,WAAW,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACvC,WAAW,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAE9C,IAAI,YAAY,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,WAAW,CAAC,MAAM,CAAC,cAAc,EAAE,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,IAAI,CAAC,OAAO,CACjB,KAAK,EACL,0BAA0B,WAAW,CAAC,QAAQ,EAAE,EAAE,CACnD,CAAC;IACJ,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAc,EAAE,OAAe;QACpD,MAAM,OAAO,GAAqB,EAAE,OAAO,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAoB,MAAM,EAAE,gBAAgB,MAAM,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1F,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,OAAe;QACtD,MAAM,OAAO,GAAuB,EAAE,OAAO,EAAE,CAAC;QAChD,OAAO,IAAI,CAAC,OAAO,CAAsB,MAAM,EAAE,gBAAgB,MAAM,UAAU,EAAE,OAAO,CAAC,CAAC;IAC9F,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,MAAc,EAAE,OAAe;QACzD,mDAAmD;QACnD,MAAM,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAChE,IAAI,CAAC,OAAO,CAAsB,KAAK,EAAE,gBAAgB,MAAM,kBAAkB,OAAO,EAAE,CAAC;iBACxF,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YAC/B,IAAI,CAAC,OAAO,CACV,KAAK,EAAE,gBAAgB,MAAM,qBAAqB,OAAO,EAAE,CAC5D,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,OAAO,CACV,KAAK,EAAE,gBAAgB,MAAM,oBAAoB,OAAO,EAAE,CAC3D,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;YAChC,IAAI,CAAC,OAAO,CACV,KAAK,EAAE,gBAAgB,MAAM,wBAAwB,OAAO,EAAE,CAC/D,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC,CAAC;SACrC,CAAC,CAAC;QAEH,iEAAiE;QACjE,yDAAyD;QACzD,OAAO;YACL,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;YACxB,kBAAkB,EAAE,EAAE;YACtB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,EAAE;YACjC,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,WAAW,EAAE,WAAW,CAAC,WAAW,IAAI,EAAE;SAC3C,CAAC;IACJ,CAAC"}

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

@@ -0,0 +1,22 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-05
+ * @tags: [agent, cli, epic-004, multi-agent, collaboration]
+ * @related: [register.ts, list.ts, status.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [commander, chalk]
+ */
+/**
+ * Agent Commands (EPIC-004 Sprint 1 TASK-6)
+ *
+ * CLI commands for AI-to-AI collaboration agent management
+ */
+import { Command } from 'commander';
+/**
+ * Main agent command with subcommands
+ */
+export declare function agentCommand(): Command;
+export default agentCommand;
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/commands/agent/index.js

@@ -0,0 +1,121 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-05
+ * @tags: [agent, cli, epic-004, multi-agent, collaboration]
+ * @related: [register.ts, list.ts, status.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [commander, chalk]
+ */
+/**
+ * Agent Commands (EPIC-004 Sprint 1 TASK-6)
+ *
+ * CLI commands for AI-to-AI collaboration agent management
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { registerAgentCommand } from './register.js';
+import { listAgentsCommand } from './list.js';
+import { statusAgentCommand } from './status.js';
+import { workAgentCommand } from './work.js';
+/**
+ * Main agent command with subcommands
+ */
+export function agentCommand() {
+    const agent = new Command('agent')
+        .description('Manage AI agents for multi-agent collaboration (EPIC-004)')
+        .showHelpAfterError('(use --help for additional information)')
+        .addHelpText('after', `
+${chalk.gray('Quick Start:')}
+  ${chalk.green('ginko login')}                                     ${chalk.gray('# Authenticate first')}
+  ${chalk.green('ginko agent register')} --name "Worker-1" \\
+                            --capabilities typescript,testing  ${chalk.gray('# Register agent')}
+  ${chalk.green('ginko agent list')}                                ${chalk.gray('# List all agents')}
+  ${chalk.green('ginko agent status')}                              ${chalk.gray('# Show current agent')}
+
+${chalk.gray('Usage Examples:')}
+  ${chalk.green('ginko agent register')} --name "Backend-Agent" --capabilities typescript,nodejs,api
+  ${chalk.green('ginko agent list')} --status active
+  ${chalk.green('ginko agent list')} --capability typescript
+  ${chalk.green('ginko agent status')}
+
+${chalk.gray('Features:')}
+  ${chalk.cyan('🤖 Agent Registration')}   - Register agents with capabilities
+  ${chalk.cyan('📋 Agent Discovery')}      - List and filter available agents
+  ${chalk.cyan('📊 Agent Status')}         - View current agent details
+  ${chalk.cyan('🔄 Multi-Agent Collab')}   - Enable AI-to-AI collaboration
+
+${chalk.gray('Learn More:')}
+  ${chalk.dim('https://docs.ginko.ai/multi-agent')}
+`)
+        .action(() => {
+        // When called without subcommand, show help
+        agent.help({ error: false });
+    });
+    // Register command
+    agent
+        .command('register')
+        .description('Register a new agent with capabilities')
+        .requiredOption('--name <name>', 'Agent name (e.g., "Worker-1", "Backend-Agent")')
+        .requiredOption('--capabilities <capabilities>', 'Comma-separated capabilities (e.g., "typescript,testing,api")')
+        .option('--status <status>', 'Initial status (active|idle|busy|offline)', 'active')
+        .action(async (options) => {
+        await registerAgentCommand(options);
+    });
+    // List command
+    agent
+        .command('list')
+        .description('List agents with optional filtering')
+        .option('--status <status>', 'Filter by status (active|idle|busy|offline)')
+        .option('--capability <capability>', 'Filter by capability')
+        .option('--limit <limit>', 'Max results (default 20, max 100)', '20')
+        .option('--offset <offset>', 'Pagination offset (default 0)', '0')
+        .action(async (options) => {
+        await listAgentsCommand(options);
+    });
+    // Status command
+    agent
+        .command('status')
+        .description('Show current agent status and details')
+        .action(async () => {
+        await statusAgentCommand();
+    });
+    // Work command (EPIC-004 Sprint 4 TASK-8)
+    agent
+        .command('work')
+        .description('Start worker agent that loads context and polls for task assignments')
+        .option('--name <name>', 'Agent name (required if not already registered)')
+        .option('--capabilities <capabilities>', 'Comma-separated capabilities (required if not already registered)')
+        .option('--poll-interval <seconds>', 'Task polling interval in seconds (default: 5)', '5')
+        .option('--max-tasks <count>', 'Max tasks to process before exiting (0 = unlimited)', '0')
+        .addHelpText('after', `
+${chalk.gray('Worker Agent Flow:')}
+  ${chalk.dim('1. Register as worker agent (or use existing from .ginko/agent.json)')}
+  ${chalk.dim('2. Call ginko start to load project context (events, patterns, ADRs)')}
+  ${chalk.dim('3. Start heartbeat to maintain online status')}
+  ${chalk.dim('4. Enter polling loop for task assignments')}
+  ${chalk.dim('5. On assignment: claim task atomically, load task-specific context')}
+  ${chalk.dim('6. Execute task (AI does the work), log events, verify')}
+  ${chalk.dim('7. Report completion/blocker via events')}
+  ${chalk.dim('8. Return to polling')}
+
+${chalk.gray('Examples:')}
+  ${chalk.green('ginko agent work --name "Worker-1" --capabilities typescript,testing')}
+  ${chalk.green('ginko agent work')} ${chalk.dim('# Uses existing agent from .ginko/agent.json')}
+  ${chalk.green('ginko agent work --poll-interval 10')} ${chalk.dim('# Poll every 10 seconds')}
+  ${chalk.green('ginko agent work --max-tasks 5')} ${chalk.dim('# Process 5 tasks then exit')}
+`)
+        .action(async (options) => {
+        await workAgentCommand({
+            name: options.name,
+            capabilities: options.capabilities,
+            pollInterval: parseInt(options.pollInterval, 10),
+            maxTasks: parseInt(options.maxTasks, 10),
+        });
+    });
+    return agent;
+}
+// Export for use in main CLI
+export default agentCommand;
+//# sourceMappingURL=index.js.map

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

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

package/dist/commands/agent/list.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-05
+ * @tags: [agent, list, cli, epic-004, multi-agent]
+ * @related: [index.ts, agent-client.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [commander, chalk, ora]
+ */
+interface ListOptions {
+    status?: string;
+    capability?: string;
+    limit?: string;
+    offset?: string;
+}
+/**
+ * List agents with optional filtering
+ */
+export declare function listAgentsCommand(options: ListOptions): Promise<void>;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/agent/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/agent/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,UAAU,WAAW;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA0E3E"}