cokit-cli 1.2.7 → 1.4.0

package/skills/mcp-management/scripts/dist/mcp-client.js

@@ -1,183 +0,0 @@
-#!/usr/bin/env node
-/**
- * MCP Client - Core client for interacting with MCP servers
- */
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-import { readFile } from 'fs/promises';
-import { resolve } from 'path';
-export class MCPClientManager {
-    config = null;
-    clients = new Map();
-    transports = new Map();
-    async loadConfig(configPath = '$HOME/.copilot/.mcp.json') {
-        const fullPath = resolve(process.cwd(), configPath);
-        const content = await readFile(fullPath, 'utf-8');
-        const config = JSON.parse(content);
-        this.config = config;
-        return config;
-    }
-    async connectToServer(serverName) {
-        if (!this.config?.mcpServers[serverName]) {
-            throw new Error(`Server ${serverName} not found in config`);
-        }
-        const serverConfig = this.config.mcpServers[serverName];
-        const transport = new StdioClientTransport({
-            command: serverConfig.command,
-            args: serverConfig.args,
-            env: serverConfig.env
-        });
-        const client = new Client({
-            name: `mcp-manager-${serverName}`,
-            version: '1.0.0'
-        }, { capabilities: {} });
-        await client.connect(transport);
-        this.clients.set(serverName, client);
-        this.transports.set(serverName, transport); // Track transport!
-        return client;
-    }
-    async connectAll() {
-        if (!this.config) {
-            throw new Error('Config not loaded. Call loadConfig() first.');
-        }
-        const serverNames = Object.keys(this.config.mcpServers);
-        console.log(`Connecting to ${serverNames.length} servers sequentially...`);
-        for (const serverName of serverNames) {
-            try {
-                await this.connectToServer(serverName);
-                console.log(`✓ ${serverName} connected`);
-            }
-            catch (error) {
-                console.error(`✗ ${serverName} failed:`, error);
-                // Continue with other servers
-            }
-        }
-    }
-    async getAllTools() {
-        const allTools = [];
-        for (const [serverName, client] of this.clients.entries()) {
-            try {
-                const response = await client.listTools({}, { timeout: 300000 });
-                for (const tool of response.tools) {
-                    allTools.push({
-                        serverName,
-                        name: tool.name,
-                        description: tool.description || '',
-                        inputSchema: tool.inputSchema,
-                        outputSchema: tool.outputSchema
-                    });
-                }
-            }
-            catch (error) {
-                if (error?.code === -32601) {
-                    console.warn(`${serverName} does not support listTools`);
-                }
-                else {
-                    console.error(`Error from ${serverName}:`, error);
-                }
-                // Continue with other servers!
-            }
-        }
-        return allTools;
-    }
-    async getAllPrompts() {
-        const allPrompts = [];
-        for (const [serverName, client] of this.clients.entries()) {
-            try {
-                const response = await client.listPrompts({}, { timeout: 300000 });
-                for (const prompt of response.prompts) {
-                    allPrompts.push({
-                        serverName,
-                        name: prompt.name,
-                        description: prompt.description || '',
-                        arguments: prompt.arguments
-                    });
-                }
-            }
-            catch (error) {
-                if (error?.code === -32601) {
-                    console.warn(`${serverName} does not support listPrompts`);
-                }
-                else {
-                    console.error(`Error from ${serverName}:`, error);
-                }
-                // Continue with other servers!
-            }
-        }
-        return allPrompts;
-    }
-    async getAllResources() {
-        const allResources = [];
-        for (const [serverName, client] of this.clients.entries()) {
-            try {
-                const response = await client.listResources({}, { timeout: 300000 });
-                for (const resource of response.resources) {
-                    allResources.push({
-                        serverName,
-                        uri: resource.uri,
-                        name: resource.name,
-                        description: resource.description,
-                        mimeType: resource.mimeType
-                    });
-                }
-            }
-            catch (error) {
-                if (error?.code === -32601) {
-                    console.warn(`${serverName} does not support listResources`);
-                }
-                else {
-                    console.error(`Error from ${serverName}:`, error);
-                }
-                // Continue with other servers!
-            }
-        }
-        return allResources;
-    }
-    async callTool(serverName, toolName, args) {
-        const client = this.clients.get(serverName);
-        if (!client)
-            throw new Error(`Not connected to server: ${serverName}`);
-        return await client.callTool({ name: toolName, arguments: args }, undefined, { timeout: 300000 });
-    }
-    async getPrompt(serverName, promptName, args) {
-        const client = this.clients.get(serverName);
-        if (!client)
-            throw new Error(`Not connected to server: ${serverName}`);
-        return await client.getPrompt({ name: promptName, arguments: args }, { timeout: 300000 });
-    }
-    async readResource(serverName, uri) {
-        const client = this.clients.get(serverName);
-        if (!client)
-            throw new Error(`Not connected to server: ${serverName}`);
-        return await client.readResource({ uri }, { timeout: 300000 });
-    }
-    async cleanup() {
-        // Close clients with timeout
-        const cleanupPromises = [];
-        for (const [serverName, client] of this.clients.entries()) {
-            cleanupPromises.push((async () => {
-                try {
-                    await client.close();
-                }
-                catch (error) {
-                    console.warn(`Warning closing ${serverName}:`, error);
-                }
-            })());
-        }
-        await Promise.race([
-            Promise.all(cleanupPromises),
-            new Promise((resolve) => setTimeout(resolve, 5000))
-        ]);
-        // CRITICAL: Close transports to kill subprocesses
-        for (const [serverName, transport] of this.transports.entries()) {
-            try {
-                await transport.close();
-            }
-            catch (error) {
-                console.warn(`Warning closing ${serverName} transport:`, error);
-            }
-        }
-        this.clients.clear();
-        this.transports.clear();
-    }
-}

package/skills/mcp-management/scripts/mcp-client.ts

@@ -1,230 +0,0 @@
-#!/usr/bin/env node
-/**
- * MCP Client - Core client for interacting with MCP servers
- */
-
-import { Client } from '@modelcontextprotocol/sdk/client/index.js';
-import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
-import { readFile } from 'fs/promises';
-import { resolve } from 'path';
-
-interface MCPConfig {
-  mcpServers: {
-    [key: string]: {
-      command: string;
-      args: string[];
-      env?: Record<string, string>;
-    };
-  };
-}
-
-interface ToolInfo {
-  serverName: string;
-  name: string;
-  description: string;
-  inputSchema: any;
-  outputSchema?: any;
-}
-
-interface PromptInfo {
-  serverName: string;
-  name: string;
-  description: string;
-  arguments?: any[];
-}
-
-interface ResourceInfo {
-  serverName: string;
-  uri: string;
-  name: string;
-  description?: string;
-  mimeType?: string;
-}
-
-export class MCPClientManager {
-  private config: MCPConfig | null = null;
-  private clients: Map<string, Client> = new Map();
-  private transports: Map<string, StdioClientTransport> = new Map();
-
-  async loadConfig(configPath: string = '$HOME/.copilot/.mcp.json'): Promise<MCPConfig> {
-    const fullPath = resolve(process.cwd(), configPath);
-    const content = await readFile(fullPath, 'utf-8');
-    const config = JSON.parse(content) as MCPConfig;
-    this.config = config;
-    return config;
-  }
-
-  async connectToServer(serverName: string): Promise<Client> {
-    if (!this.config?.mcpServers[serverName]) {
-      throw new Error(`Server ${serverName} not found in config`);
-    }
-
-    const serverConfig = this.config.mcpServers[serverName];
-    const transport = new StdioClientTransport({
-      command: serverConfig.command,
-      args: serverConfig.args,
-      env: serverConfig.env
-    });
-
-    const client = new Client({
-      name: `mcp-manager-${serverName}`,
-      version: '1.0.0'
-    }, { capabilities: {} });
-
-    await client.connect(transport);
-    this.clients.set(serverName, client);
-    this.transports.set(serverName, transport); // Track transport!
-    return client;
-  }
-
-  async connectAll(): Promise<void> {
-    if (!this.config) {
-      throw new Error('Config not loaded. Call loadConfig() first.');
-    }
-
-    const serverNames = Object.keys(this.config.mcpServers);
-    console.log(`Connecting to ${serverNames.length} servers sequentially...`);
-
-    for (const serverName of serverNames) {
-      try {
-        await this.connectToServer(serverName);
-        console.log(`✓ ${serverName} connected`);
-      } catch (error) {
-        console.error(`✗ ${serverName} failed:`, error);
-        // Continue with other servers
-      }
-    }
-  }
-
-  async getAllTools(): Promise<ToolInfo[]> {
-    const allTools: ToolInfo[] = [];
-    for (const [serverName, client] of this.clients.entries()) {
-      try {
-        const response = await client.listTools({}, { timeout: 300000 });
-        for (const tool of response.tools) {
-          allTools.push({
-            serverName,
-            name: tool.name,
-            description: tool.description || '',
-            inputSchema: tool.inputSchema,
-            outputSchema: (tool as any).outputSchema
-          });
-        }
-      } catch (error: any) {
-        if (error?.code === -32601) {
-          console.warn(`${serverName} does not support listTools`);
-        } else {
-          console.error(`Error from ${serverName}:`, error);
-        }
-        // Continue with other servers!
-      }
-    }
-    return allTools;
-  }
-
-  async getAllPrompts(): Promise<PromptInfo[]> {
-    const allPrompts: PromptInfo[] = [];
-    for (const [serverName, client] of this.clients.entries()) {
-      try {
-        const response = await client.listPrompts({}, { timeout: 300000 });
-        for (const prompt of response.prompts) {
-          allPrompts.push({
-            serverName,
-            name: prompt.name,
-            description: prompt.description || '',
-            arguments: prompt.arguments
-          });
-        }
-      } catch (error: any) {
-        if (error?.code === -32601) {
-          console.warn(`${serverName} does not support listPrompts`);
-        } else {
-          console.error(`Error from ${serverName}:`, error);
-        }
-        // Continue with other servers!
-      }
-    }
-    return allPrompts;
-  }
-
-  async getAllResources(): Promise<ResourceInfo[]> {
-    const allResources: ResourceInfo[] = [];
-    for (const [serverName, client] of this.clients.entries()) {
-      try {
-        const response = await client.listResources({}, { timeout: 300000 });
-        for (const resource of response.resources) {
-          allResources.push({
-            serverName,
-            uri: resource.uri,
-            name: resource.name,
-            description: resource.description,
-            mimeType: resource.mimeType
-          });
-        }
-      } catch (error: any) {
-        if (error?.code === -32601) {
-          console.warn(`${serverName} does not support listResources`);
-        } else {
-          console.error(`Error from ${serverName}:`, error);
-        }
-        // Continue with other servers!
-      }
-    }
-    return allResources;
-  }
-
-  async callTool(serverName: string, toolName: string, args: any): Promise<any> {
-    const client = this.clients.get(serverName);
-    if (!client) throw new Error(`Not connected to server: ${serverName}`);
-    return await client.callTool(
-      { name: toolName, arguments: args },
-      undefined,
-      { timeout: 300000 }
-    );
-  }
-
-  async getPrompt(serverName: string, promptName: string, args?: any): Promise<any> {
-    const client = this.clients.get(serverName);
-    if (!client) throw new Error(`Not connected to server: ${serverName}`);
-    return await client.getPrompt({ name: promptName, arguments: args }, { timeout: 300000 });
-  }
-
-  async readResource(serverName: string, uri: string): Promise<any> {
-    const client = this.clients.get(serverName);
-    if (!client) throw new Error(`Not connected to server: ${serverName}`);
-    return await client.readResource({ uri }, { timeout: 300000 });
-  }
-
-  async cleanup(): Promise<void> {
-    // Close clients with timeout
-    const cleanupPromises: Promise<void>[] = [];
-    for (const [serverName, client] of this.clients.entries()) {
-      cleanupPromises.push(
-        (async () => {
-          try {
-            await client.close();
-          } catch (error) {
-            console.warn(`Warning closing ${serverName}:`, error);
-          }
-        })()
-      );
-    }
-
-    await Promise.race([
-      Promise.all(cleanupPromises),
-      new Promise<void>((resolve) => setTimeout(resolve, 5000))
-    ]);
-
-    // CRITICAL: Close transports to kill subprocesses
-    for (const [serverName, transport] of this.transports.entries()) {
-      try {
-        await transport.close();
-      } catch (error) {
-        console.warn(`Warning closing ${serverName} transport:`, error);
-      }
-    }
-
-    this.clients.clear();
-    this.transports.clear();
-  }
-}

package/skills/mermaidjs-v11/SKILL.md

@@ -1,115 +0,0 @@
----
-name: mermaidjs-v11
-description: Create diagrams with Mermaid.js v11 syntax. Use for flowcharts, sequence diagrams, class diagrams, ER diagrams, Gantt charts, state diagrams, architecture diagrams, timelines, user journeys.
----
-
-# Mermaid.js v11
-
-## Overview
-
-Create text-based diagrams using Mermaid.js v11 declarative syntax. Convert code to SVG/PNG/PDF via CLI or render in browsers/markdown files.
-
-## Quick Start
-
-**Basic Diagram Structure:**
-```
-{diagram-type}
-  {diagram-content}
-```
-
-**Common Diagram Types:**
-- `flowchart` - Process flows, decision trees
-- `sequenceDiagram` - Actor interactions, API flows
-- `classDiagram` - OOP structures, data models
-- `stateDiagram` - State machines, workflows
-- `erDiagram` - Database relationships
-- `gantt` - Project timelines
-- `journey` - User experience flows
-
-See `references/diagram-types.md` for all 24+ types with syntax.
-
-## Creating Diagrams
-
-**Inline Markdown Code Blocks:**
-````markdown
-```mermaid
-flowchart TD
-    A[Start] --> B{Decision}
-    B -->|Yes| C[Action]
-    B -->|No| D[End]
-```
-````
-
-**Configuration via Frontmatter:**
-````markdown
-```mermaid
----
-theme: dark
----
-flowchart LR
-    A --> B
-```
-````
-
-**Comments:** Use `%% ` prefix for single-line comments.
-
-## CLI Usage
-
-Convert `.mmd` files to images:
-```bash
-# Installation
-npm install -g @mermaid-js/mermaid-cli
-
-# Basic conversion
-mmdc -i diagram.mmd -o diagram.svg
-
-# With theme and background
-mmdc -i input.mmd -o output.png -t dark -b transparent
-
-# Custom styling
-mmdc -i diagram.mmd --cssFile style.css -o output.svg
-```
-
-See `references/cli-usage.md` for Docker, batch processing, and advanced workflows.
-
-## JavaScript Integration
-
-**HTML Embedding:**
-```html
-<pre class="mermaid">
-  flowchart TD
-    A[Client] --> B[Server]
-</pre>
-<script src="https://cdn.jsdelivr.net/npm/mermaid@latest/dist/mermaid.min.js"></script>
-<script>mermaid.initialize({ startOnLoad: true });</script>
-```
-
-See `references/integration.md` for Node.js API and advanced integration patterns.
-
-## Configuration & Theming
-
-**Common Options:**
-- `theme`: "default", "dark", "forest", "neutral", "base"
-- `look`: "classic", "handDrawn"
-- `fontFamily`: Custom font specification
-- `securityLevel`: "strict", "loose", "antiscript"
-
-See `references/configuration.md` for complete config options, theming, and customization.
-
-## Practical Patterns
-
-Load `references/examples.md` for:
-- Architecture diagrams
-- API documentation flows
-- Database schemas
-- Project timelines
-- State machines
-- User journey maps
-
-## Resources
-
-- `references/diagram-types.md` - Syntax for all 24+ diagram types
-- `references/configuration.md` - Config, theming, accessibility
-- `references/cli-usage.md` - CLI commands and workflows
-- `references/integration.md` - JavaScript API and embedding
-- `references/examples.md` - Practical patterns and use cases

package/skills/planning/SKILL.md

@@ -1,163 +0,0 @@
----
-name: planning
-description: Plan implementations, design architectures, create technical roadmaps with detailed phases. Use for feature planning, system design, solution architecture, implementation strategy, phase documentation.
----
-
-# Planning
-
-Create detailed technical implementation plans through research, codebase analysis, solution design, and comprehensive documentation.
-
-## Workflow Modes
-
-Default: `--auto` — analyze the task and auto-pick the most appropriate mode.
-
-| Flag | Research | Red Team | Validation | Cook Flag |
-|------|----------|----------|------------|-----------|
-| `--auto` | Auto | Auto | Auto | auto |
-| `--fast` | Skip | Skip | Skip | fast |
-| `--hard` | Full | Yes | Yes | hard |
-| `--parallel` | Parallel | Yes | Yes | parallel |
-| `--two` | Full | Yes | Yes | two |
-
-Add `--no-tasks` to any mode to skip todo checklist hydration after the plan is written.
-
-See `references/workflow-modes.md` for detailed mode behavior.
-
-## When to Use
-
-Use this skill when:
-- Planning new feature implementations
-- Architecting system designs
-- Evaluating technical approaches
-- Creating implementation roadmaps
-- Breaking down complex requirements
-- Assessing technical trade-offs
-
-## Core Responsibilities & Rules
-
-Always honoring **YAGNI**, **KISS**, and **DRY** principles.
-**Be honest, be brutal, straight to the point, and be concise.**
-
-### 1. Research & Analysis
-Load: `references/research-phase.md`
-**Skip if:** Provided with researcher reports
-
-### 2. Codebase Understanding
-Load: `references/codebase-understanding.md`
-**Skip if:** Provided with scout reports
-
-### 3. Solution Design
-Load: `references/solution-design.md`
-
-### 4. Plan Creation & Organization
-Load: `references/plan-organization.md`
-
-### 5. Task Breakdown & Output Standards
-Load: `references/output-standards.md`
-
-## Workflow Process
-
-1. **Pre-Creation Check** → Check `## Plan Context` from hook injection; follow Active Plan State rules below.
-2. **Mode Detection** → Use explicit flag if provided; otherwise auto-detect based on task complexity.
-3. **Research Phase** → Spawn parallel researcher agents to investigate approaches (skip in `--fast` mode).
-4. **Codebase Analysis** → Read docs in `./docs`; activate `/ck-scout` if file relationships are unclear.
-5. **Plan Documentation** → Write comprehensive plan via `planner` agent using the directory structure below.
-6. **Red Team Review** → Spawn adversarial reviewers to challenge assumptions (`--hard`, `--parallel`, `--two` modes only). See `references/workflow-modes.md`.
-7. **Post-Plan Validation** → Use `/ck-plan-validate` to verify completeness and coherence (`--hard`, `--parallel`, `--two` modes only).
-8. **Hydrate Tasks** → Create a todo checklist from plan phases with dependency annotations (default on; skip with `--no-tasks` or fewer than 3 phases).
-9. **Context Reminder** → Output the cook command with the absolute plan path (MANDATORY): `Use plan at: {absolute-plan-dir-path}`
-
-## Output Requirements
-
-- DO NOT implement code - only create plans
-- Respond with plan file path and summary
-- Ensure self-contained plans with necessary context
-- Include code snippets/pseudocode when clarifying
-- Provide multiple options with trade-offs when appropriate
-- Fully respect the `./docs/development-rules.md` file.
-
-## Task Management
-
-Plan files are persistent on disk. Todo checklists are session-scoped. Hydration bridges the gap by converting plan phases into trackable checklist items at plan-creation time.
-
-- **Default:** Auto-hydrate after plan is written (create checklist with one item per phase).
-- **Skip with:** `--no-tasks` flag or when plan has fewer than 3 phases (3-Task Rule).
-- **Checklist format:** Include phase name, dependencies, and owning agent hint per item.
-
-See `references/task-management.md` for checklist schema and dependency notation.
-
-### Important
-DO NOT create plans or reports in USER directory.
-ALWAYS create plans or reports in CURRENT WORKING PROJECT DIRECTORY.
-
-**Plan Directory Structure**
-IN CURRENT WORKING PROJECT DIRECTORY:
-```
-plans/
-└── {date}-plan-name/
-    ├── research/
-    │   ├── researcher-XX-report.md
-    │   └── ...
-    ├── reports/
-    │   ├── XX-report.md
-    │   └── ...
-    ├── scout/
-    │   ├── scout-XX-report.md
-    │   └── ...
-    ├── plan.md
-    ├── phase-XX-phase-name-here.md
-    └── ...
-```
-
-## Active Plan State
-
-Prevents version proliferation by tracking current working plan via session state.
-
-### Active vs Suggested Plans
-
-Check the `## Plan Context` section injected by hooks:
-- **"Plan: {path}"** = Active plan, explicitly set via `set-active-plan.cjs` — use this path for all reports
-- **"Suggested: {path}"** = Branch-matched hint only — do NOT auto-use
-- **"Plan: none"** = No active plan
-
-### Rules
-
-1. **If "Plan:" shows a path**: Ask "Continue with existing plan? [Y/n]"
-2. **If "Suggested:" shows a path**: Inform user, ask if they want to activate or create new
-3. **If "Plan: none"**: Create new plan using naming from `## Naming` section
-4. **Update on create**: Run `node $HOME/.copilot/scripts/set-active-plan.cjs {plan-dir}`
-
-### Report Output Location
-
-All agents writing reports MUST:
-1. Check `## Naming` section injected by hooks for the computed naming pattern
-2. Active plans use plan-specific reports path
-3. Suggested plans use default reports path (not plan folder)
-
-### Important
-DO NOT create plans or reports in USER directory.
-ALWAYS create plans or reports in CURRENT WORKING PROJECT DIRECTORY.
-
-**Important:** Suggested plans do NOT get plan-specific reports — this prevents pollution of old plan folders.
-
-## Quality Standards
-
-- Be thorough and specific
-- Consider long-term maintainability
-- Research thoroughly when uncertain
-- Address security and performance concerns
-- Make plans detailed enough for junior developers
-- Validate against existing codebase patterns
-
-**Remember:** Plan quality determines implementation success. Be comprehensive and consider all solution aspects.
-
-## References
-
-Load as needed:
-- `references/workflow-modes.md` - Mode behavior details and flag descriptions
-- `references/task-management.md` - Checklist schema, dependency notation, hydration rules
-- `references/research-phase.md` - Research phase execution
-- `references/codebase-understanding.md` - Codebase analysis steps
-- `references/solution-design.md` - Solution design process
-- `references/plan-organization.md` - Plan file structure and organization
-- `references/output-standards.md` - Task breakdown and output format standards