cokit-cli 1.2.7 → 1.4.0

package/templates/repo/.github/skills/docs-seeker/scripts/fetch-docs.js

@@ -1,214 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Documentation Fetcher Script
- * Fetches documentation from context7.com with topic support and fallback chain
- */
-
-const https = require('https');
-const { loadEnv } = require('./utils/env-loader');
-const { detectTopic } = require('./detect-topic');
-
-// Load environment
-const env = loadEnv();
-const DEBUG = env.DEBUG === 'true';
-const API_KEY = env.CONTEXT7_API_KEY;
-
-/**
- * Make HTTPS GET request
- * @param {string} url - URL to fetch
- * @returns {Promise<string>} Response body
- */
-function httpsGet(url) {
-  return new Promise((resolve, reject) => {
-    const options = {
-      headers: API_KEY ? { 'Authorization': `Bearer ${API_KEY}` } : {},
-    };
-
-    https.get(url, options, (res) => {
-      let data = '';
-
-      res.on('data', (chunk) => {
-        data += chunk;
-      });
-
-      res.on('end', () => {
-        if (res.statusCode === 200) {
-          resolve(data);
-        } else if (res.statusCode === 404) {
-          resolve(null);
-        } else {
-          reject(new Error(`HTTP ${res.statusCode}: ${data}`));
-        }
-      });
-    }).on('error', reject);
-  });
-}
-
-/**
- * Construct context7.com URL
- * @param {string} library - Library name (e.g., "next.js", "shadcn/ui")
- * @param {string} topic - Optional topic keyword
- * @returns {string} context7.com URL
- */
-function buildContext7Url(library, topic = null) {
-  // Determine if GitHub repo or website
-  let basePath;
-
-  if (library.includes('/')) {
-    // GitHub repo format: org/repo
-    const [org, repo] = library.split('/');
-    basePath = `${org}/${repo}`;
-  } else {
-    // Try common patterns
-    const normalized = library.toLowerCase().replace(/[^a-z0-9-]/g, '');
-    basePath = `websites/${normalized}`;
-  }
-
-  const baseUrl = `https://context7.com/${basePath}/llms.txt`;
-
-  if (topic) {
-    return `${baseUrl}?topic=${encodeURIComponent(topic)}`;
-  }
-
-  return baseUrl;
-}
-
-/**
- * Try multiple URL variations for a library
- * @param {string} library - Library name
- * @param {string} topic - Optional topic
- * @returns {Promise<Array>} Array of URLs to try
- */
-async function getUrlVariations(library, topic = null) {
-  const urls = [];
-
-  // Known repo mappings
-  const knownRepos = {
-    'next.js': 'vercel/next.js',
-    'nextjs': 'vercel/next.js',
-    'remix': 'remix-run/remix',
-    'astro': 'withastro/astro',
-    'shadcn': 'shadcn-ui/ui',
-    'shadcn/ui': 'shadcn-ui/ui',
-    'tailwind': 'tailwindlabs/tailwindcss',
-    'tailwindcss': 'tailwindlabs/tailwindcss',
-  };
-
-  const normalized = library.toLowerCase();
-  const repo = knownRepos[normalized] || library;
-
-  // Primary: Try with topic if available
-  if (topic) {
-    urls.push(buildContext7Url(repo, topic));
-  }
-
-  // Fallback: Try without topic
-  urls.push(buildContext7Url(repo));
-
-  return urls;
-}
-
-/**
- * Fetch documentation from context7.com
- * @param {string} query - User query
- * @returns {Promise<Object>} Documentation result
- */
-async function fetchDocs(query) {
-  const topicInfo = detectTopic(query);
-
-  if (DEBUG) {
-    console.error('[DEBUG] Topic detection result:', topicInfo);
-  }
-
-  let urls = [];
-
-  if (topicInfo && topicInfo.isTopicSpecific) {
-    // Topic-specific search
-    urls = await getUrlVariations(topicInfo.library, topicInfo.topic);
-
-    if (DEBUG) {
-      console.error('[DEBUG] Topic-specific URLs:', urls);
-    }
-  } else {
-    // Extract library from general query
-    const libraryMatch = query.match(/(?:documentation|docs|guide) (?:for )?(.+)/i);
-    if (libraryMatch) {
-      const library = libraryMatch[1].trim();
-      urls = await getUrlVariations(library);
-
-      if (DEBUG) {
-        console.error('[DEBUG] General library URLs:', urls);
-      }
-    }
-  }
-
-  // Try each URL
-  for (const url of urls) {
-    if (DEBUG) {
-      console.error(`[DEBUG] Trying URL: ${url}`);
-    }
-
-    try {
-      const content = await httpsGet(url);
-
-      if (content) {
-        return {
-          success: true,
-          source: 'context7.com',
-          url,
-          content,
-          topicSpecific: url.includes('?topic='),
-        };
-      }
-    } catch (error) {
-      if (DEBUG) {
-        console.error(`[DEBUG] Failed to fetch ${url}:`, error.message);
-      }
-    }
-  }
-
-  // No URL worked
-  return {
-    success: false,
-    source: 'context7.com',
-    error: 'Documentation not found on context7.com',
-    urls,
-    suggestion: 'Try repository analysis or web search',
-  };
-}
-
-/**
- * CLI entry point
- */
-async function main() {
-  const args = process.argv.slice(2);
-
-  if (args.length === 0) {
-    console.error('Usage: node fetch-docs.js "<user query>"');
-    process.exit(1);
-  }
-
-  const query = args.join(' ');
-
-  try {
-    const result = await fetchDocs(query);
-    console.log(JSON.stringify(result, null, 2));
-    process.exit(result.success ? 0 : 1);
-  } catch (error) {
-    console.error('Error:', error.message);
-    process.exit(1);
-  }
-}
-
-// Run if called directly
-if (require.main === module) {
-  main();
-}
-
-module.exports = {
-  fetchDocs,
-  buildContext7Url,
-  getUrlVariations,
-  httpsGet,
-};

package/templates/repo/.github/skills/docs-seeker/scripts/utils/env-loader.js

@@ -1,94 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * Environment variable loader for docs-seeker skill
- * Respects order: process.env > skill/.env > skills/.env > $HOME/.copilot/.env
- */
-
-const fs = require('fs');
-const path = require('path');
-
-/**
- * Parse .env file content into key-value pairs
- * @param {string} content - .env file content
- * @returns {Object} Parsed environment variables
- */
-function parseEnvFile(content) {
-  const env = {};
-  const lines = content.split('\n');
-
-  for (const line of lines) {
-    // Skip comments and empty lines
-    if (!line || line.trim().startsWith('#')) continue;
-
-    const match = line.match(/^\s*([A-Za-z_][A-Za-z0-9_]*)\s*=\s*(.*)$/);
-    if (match) {
-      const key = match[1];
-      let value = match[2].trim();
-
-      // Remove quotes if present
-      if ((value.startsWith('"') && value.endsWith('"')) ||
-          (value.startsWith("'") && value.endsWith("'"))) {
-        value = value.slice(1, -1);
-      }
-
-      env[key] = value;
-    }
-  }
-
-  return env;
-}
-
-/**
- * Load environment variables from .env files in priority order
- * Priority: process.env > skill/.env > skills/.env > $HOME/.copilot/.env
- * @returns {Object} Merged environment variables
- */
-function loadEnv() {
-  const skillDir = path.resolve(__dirname, '../..');
-  const skillsDir = path.resolve(skillDir, '..');
-  const configDir = path.resolve(skillsDir, '..');
-
-  const envPaths = [
-    path.join(configDir, '.env'),      // Lowest priority
-    path.join(skillsDir, '.env'),
-    path.join(skillDir, '.env'),       // Highest priority (file)
-  ];
-
-  let mergedEnv = {};
-
-  // Load .env files in order (lowest to highest priority)
-  for (const envPath of envPaths) {
-    if (fs.existsSync(envPath)) {
-      try {
-        const content = fs.readFileSync(envPath, 'utf8');
-        const parsed = parseEnvFile(content);
-        mergedEnv = { ...mergedEnv, ...parsed };
-      } catch (error) {
-        // Silently skip unreadable files
-      }
-    }
-  }
-
-  // process.env has highest priority
-  mergedEnv = { ...mergedEnv, ...process.env };
-
-  return mergedEnv;
-}
-
-/**
- * Get environment variable with fallback
- * @param {string} key - Environment variable key
- * @param {string} defaultValue - Default value if not found
- * @returns {string} Environment variable value
- */
-function getEnv(key, defaultValue = '') {
-  const env = loadEnv();
-  return env[key] || defaultValue;
-}
-
-module.exports = {
-  loadEnv,
-  getEnv,
-  parseEnvFile,
-};

package/templates/repo/.github/skills/docs-seeker/workflows/library-search.md

@@ -1,86 +0,0 @@
-# General Library Documentation Search
-
-**Use when:** User asks about entire library/framework
-
-**Speed:** ⚡⚡ Moderate (30-60s)
-**Token usage:** 🟡 Medium
-**Accuracy:** 📚 Comprehensive
-
-## Trigger Patterns
-
-- "Documentation for [LIBRARY]"
-- "[LIBRARY] getting started"
-- "How to use [LIBRARY]"
-- "[LIBRARY] API reference"
-
-## Workflow (Script-First)
-
-```bash
-# STEP 1: Execute detect-topic.js script
-node scripts/detect-topic.js "<user query>"
-# Returns: {"isTopicSpecific": false} for general queries
-
-# STEP 2: Execute fetch-docs.js script (handles URL construction)
-node scripts/fetch-docs.js "<user query>"
-# Script constructs context7.com URL automatically
-# Script handles GitHub/website URL patterns
-# Returns: llms.txt content with 5-20+ URLs
-
-# STEP 3: Execute analyze-llms-txt.js script
-cat llms.txt | node scripts/analyze-llms-txt.js -
-# Groups URLs: critical, important, supplementary
-# Recommends: agent distribution strategy
-# Returns: {totalUrls, grouped, distribution}
-
-# STEP 4: Deploy agents based on script recommendation
-# - 1-3 URLs: Single agent or direct WebFetch
-# - 4-10 URLs: Deploy 3-5 Explorer agents
-# - 11+ URLs: Deploy 7 agents or phased approach
-
-# STEP 5: Aggregate and present
-# Synthesize findings: installation, concepts, API, examples
-```
-
-## Examples
-
-**Astro framework:**
-```bash
-# Execute scripts (no manual URL construction)
-node scripts/detect-topic.js "Documentation for Astro"
-# {"isTopicSpecific": false}
-
-node scripts/fetch-docs.js "Documentation for Astro"
-# Script fetches: context7.com/withastro/astro/llms.txt
-# Returns: llms.txt with 8 URLs
-
-node scripts/analyze-llms-txt.js < llms.txt
-# {totalUrls: 8, distribution: "3-agents", grouped: {...}}
-
-# Deploy 3 Explorer agents as recommended:
-# Agent 1: Getting started, installation, setup
-# Agent 2: Core concepts, components, layouts
-# Agent 3: Configuration, API reference
-
-# Aggregate and present comprehensive report
-```
-
-## Agent Distribution
-
-**1-3 URLs:** Single agent
-**4-10 URLs:** 3-5 agents (2-3 URLs each)
-**11-20 URLs:** 7 agents (balanced)
-**21+ URLs:** Two-phase (critical first, then important)
-
-## Known Libraries
-
-- Next.js: `vercel/next.js`
-- Astro: `withastro/astro`
-- Remix: `remix-run/remix`
-- shadcn/ui: `shadcn-ui/ui`
-
-## Fallback
-
-Scripts handle fallback automatically:
-1. `fetch-docs.js` tries context7.com
-2. If 404, script suggests WebSearch for llms.txt
-3. If still unavailable: [Repository Analysis](./repo-analysis.md)

package/templates/repo/.github/skills/fix/SKILL.md

@@ -1,112 +0,0 @@
----
-name: fix
-description: ALWAYS activate this skill before fixing ANY bug, error, test failure, CI/CD issue, type error, lint, log error, UI issue, code problem.
----
-
-# Fixing
-
-Unified skill for fixing issues of any complexity with intelligent routing.
-
-## Arguments
-
-- `--auto` - Activate autonomous mode (**default**)
-- `--review` - Activate human-in-the-loop review mode
-- `--quick` - Activate quick mode
-- `--parallel` - Fix 2+ independent issues concurrently using parallel agents
-
-## Workflow
-
-### Step 1: Mode Selection
-
-**First action:** If there is no "auto" keyword in the request, ask the user directly to choose a workflow mode (then wait for response):
-
-| Option | Recommend When | Behavior |
-|--------|----------------|----------|
-| **Autonomous** (default) | Simple/moderate issues | Auto-approve if score >= 9.5 & 0 critical |
-| **Human-in-the-loop Review** | Critical/production code | Pause for approval at each step |
-| **Quick** | Type errors, lint, trivial bugs | Fast debug → fix → review cycle |
-
-See `references/mode-selection.md` for question format.
-
-### Step 2: Debug
-
-- Activate `debug` skill.
-- Guess all possible root causes.
-- Spawn multiple parallel search agents to verify each hypothesis.
-- Create report with all findings for the next step.
-
-### Step 3: Complexity Assessment & Task Orchestration
-
-Classify before routing. See `references/complexity-assessment.md`.
-
-| Level | Indicators | Workflow |
-|-------|------------|----------|
-| **Simple** | Single file, clear error, type/lint | `references/workflow-quick.md` |
-| **Moderate** | Multi-file, root cause unclear | `references/workflow-standard.md` |
-| **Complex** | System-wide, architecture impact | `references/workflow-deep.md` |
-| **Parallel** | 2+ independent issues | Parallel `fullstack-developer` agents |
-
-**Task orchestration notes:**
-- **Quick workflow:** Skip task creation — proceed directly to fix.
-- **Moderate+ workflows:** After classifying, create a todo checklist for all phases upfront with dependencies before starting any implementation. Track each phase with checkboxes and note blockers inline.
-
-See `references/task-orchestration.md` for checklist structure and dependency tracking patterns.
-
-### Step 4: Fix Implementation & Verification
-
-- Read and analyze all the implemented changes.
-- Spawn multiple parallel search agents to verify no regressions in related code.
-- Make sure these fixes don't break other parts of the codebase.
-- Prevent future issues by adding comprehensive validation.
-
-### Step 5: Finalize
-
-**MANDATORY — always execute all steps:**
-
-1. Report summary to user with confidence score (0–10), all changes, and related files.
-2. Update `./docs` via ``docs-manager`` agent (NON-OPTIONAL — always run even for small fixes).
-3. Mark all checklist tasks complete.
-4. Ask user to commit via ``git-manager`` agent.
-
----
-
-## IMPORTANT: Skill/Agent Activation Matrix
-
-See `references/skill-activation-matrix.md` for complete matrix.
-
-**Always activate:** `debug` (all workflows)
-**Conditional:** `problem-solving`, `sequential-thinking`, `brainstorming`, `context-engineering`
-**Agents:** ``debugger``, ``researcher``, ``planner``, ``code-reviewer``, ``tester``
-**Parallel patterns:** Multiple parallel search agents for scouting; parallel terminal commands for verification; parallel ``fullstack-developer`` agents for independent issues (`--parallel` flag)
-
-## Output Format
-
-Unified step markers:
-```
-✓ Step 0: [Mode] selected - [Complexity] detected
-✓ Step 1: Root cause identified - [summary]
-✓ Step 2: Fix implemented - [N] files changed
-✓ Step 3: Tests [X/X passed]
-✓ Step 4: Review [score]/10 - [status]
-✓ Step 5: Complete - [action taken]
-```
-
-## References
-
-Load as needed:
-- `references/mode-selection.md` - Mode selection question format
-- `references/complexity-assessment.md` - Classification criteria
-- `references/task-orchestration.md` - Todo checklist structure and dependency tracking
-- `references/workflow-quick.md` - Quick: debug → fix → review
-- `references/workflow-standard.md` - Standard: full pipeline
-- `references/workflow-deep.md` - Deep: research + brainstorm + plan
-- `references/review-cycle.md` - Review logic (autonomous vs HITL)
-- `references/skill-activation-matrix.md` - When to activate each skill
-- `references/parallel-exploration.md` - Parallel search and execution patterns
-
-**Specialized Workflows:**
-- `references/workflow-ci.md` - GitHub Actions/CI failures
-- `references/workflow-logs.md` - Application log analysis
-- `references/workflow-test.md` - Test suite failures
-- `references/workflow-types.md` - TypeScript type errors
-- `references/workflow-ui.md` - Visual/UI issues (requires design skills)

package/templates/repo/.github/skills/fix/references/complexity-assessment.md

@@ -1,61 +0,0 @@
-# Complexity Assessment
-
-Classify issue complexity before routing to workflow.
-
-## Classification Criteria
-
-### Simple (→ workflow-quick.md)
-
-**Indicators:**
-- Single file affected
-- Clear error message (type error, syntax, lint)
-- Keywords: `type`, `typescript`, `tsc`, `lint`, `eslint`, `syntax`
-- Obvious fix location
-- No investigation needed
-
-**Examples:**
-- "Fix type error in auth.ts"
-- "ESLint errors after upgrade"
-- "Syntax error in config file"
-
-### Moderate (→ workflow-standard.md)
-
-**Indicators:**
-- 2-5 files affected
-- Root cause unclear but localized
-- Needs debugging investigation
-- Keywords: `bug`, `broken`, `not working`, `fails sometimes`
-- Test failures with unclear cause
-
-**Examples:**
-- "Login sometimes fails"
-- "API returns wrong data"
-- "Component not rendering correctly"
-
-### Complex (→ workflow-deep.md)
-
-**Indicators:**
-- System-wide impact (5+ files)
-- Architecture decision needed
-- Research required for solution
-- Keywords: `architecture`, `refactor`, `system-wide`, `design issue`
-- Performance/security vulnerabilities
-- Multiple interacting components
-
-**Examples:**
-- "Memory leak in production"
-- "Database deadlocks under load"
-- "Security vulnerability in auth flow"
-
-### Parallel (→ multiple fullstack-developer agents)
-
-**Indicators:**
-- 2+ independent issues mentioned
-- Issues in different areas (frontend + backend, auth + payments)
-- No dependencies between issues
-- Keywords: list of issues, "and", "also", multiple error types
-
-**Examples:**
-- "Fix type errors AND update UI styling"
-- "Auth bug + payment integration issue"
-- "3 different test failures in unrelated modules"

package/templates/repo/.github/skills/fix/references/mode-selection.md

@@ -1,30 +0,0 @@
-# Mode Selection
-
-Ask the user at start of fixing workflow to choose a mode. Present the question directly in your response, then stop and wait for their answer.
-
-## Question Format
-
-Ask the user:
-
-> **Fix Mode:** How should I handle the fix workflow?
->
-> 1. **Autonomous (Recommended)** — Auto-approve if quality high, only ask when stuck
-> 2. **Human-in-the-loop** — Pause for approval at each major step
-> 3. **Quick fix** — Fast debug-fix-review cycle for simple issues
-
-## Mode Recommendations
-
-| Issue Type | Recommended Mode |
-|------------|------------------|
-| Type errors, lint errors | Quick |
-| Single file bugs | Quick or Autonomous |
-| Multi-file, unclear root cause | Autonomous |
-| Production/critical code | Human-in-the-loop |
-| System-wide/architecture | Human-in-the-loop |
-| Security vulnerabilities | Human-in-the-loop |
-
-## Skip Mode Selection When
-
-- Issue is clearly trivial (type error keyword detected) → default Quick
-- User explicitly specified mode in prompt
-- Previous context already established mode

package/templates/repo/.github/skills/fix/references/parallel-exploration.md

@@ -1,77 +0,0 @@
-# Parallel Exploration
-
-Patterns for launching multiple agents in parallel to scout codebase and verify implementation.
-
-## Parallel Exploration (Scouting)
-
-Launch multiple `Explore` agents simultaneously when needing to find:
-- Related files across different areas
-- Similar implementations/patterns
-- Dependencies and usage
-
-**Pattern:**
-```
-Task(agent_type="Explore", prompt="Find [X] in [area1]", description="Scout area1")
-Task(agent_type="Explore", prompt="Find [Y] in [area2]", description="Scout area2")
-Task(agent_type="Explore", prompt="Find [Z] in [area3]", description="Scout area3")
-```
-
-**Example - Multi-area scouting:**
-```
-// Launch in SINGLE message with multiple Task calls:
-Task("Explore", "Find auth-related files in src/", "Scout auth")
-Task("Explore", "Find API routes handling users", "Scout API")
-Task("Explore", "Find test files for auth module", "Scout tests")
-```
-
-## Parallel Verification (Bash)
-
-Launch multiple `Bash` agents to verify implementation from different angles.
-
-**Pattern:**
-```
-Task(agent_type="Bash", prompt="Run [command1]", description="Verify X")
-Task(agent_type="Bash", prompt="Run [command2]", description="Verify Y")
-```
-
-**Example - Multi-verification:**
-```
-// Launch in SINGLE message:
-Task("Bash", "Run typecheck: bun run typecheck", "Verify types")
-Task("Bash", "Run lint: bun run lint", "Verify lint")
-Task("Bash", "Run build: bun run build", "Verify build")
-```
-
-## When to Use Parallel
-
-| Scenario | Parallel Strategy |
-|----------|-------------------|
-| Root cause unclear, multiple suspects | 2-3 Explore agents on different areas |
-| Multi-module fix | Explore each module in parallel |
-| After implementation | Bash agents for typecheck + lint + build |
-| Before commit | Bash agents for test + build + lint |
-
-## Combining Explore + Bash
-
-**Step 1:** Parallel Explore to scout
-**Step 2:** Sequential implementation
-**Step 3:** Parallel Bash to verify
-
-```
-// Scout phase - parallel
-Task("Explore", "Find payment handlers", "Scout payments")
-Task("Explore", "Find order processors", "Scout orders")
-
-// Wait for results, implement fix
-
-// Verify phase - parallel
-Task("Bash", "Run tests: bun test", "Run tests")
-Task("Bash", "Run typecheck", "Check types")
-Task("Bash", "Run build", "Verify build")
-```
-
-## Resource Limits
-
-- Max 3 parallel agents recommended (system resources)
-- Each agent has 200K token context limit
-- Keep prompts concise to avoid context bloat