cokit-cli 1.2.7 → 1.4.0

package/skills/devops/SKILL.md

@@ -1,102 +0,0 @@
----
-name: devops
-description: Deploy to Cloudflare (Workers, R2, D1), Docker, GCP (Cloud Run, GKE), Azure (App Service, AKS), Kubernetes (kubectl, Helm). Use for serverless, containers, CI/CD, GitOps, security audit.
----
-
-# DevOps Skill
-
-Deploy and manage cloud infrastructure across Cloudflare, Docker, Google Cloud, and Kubernetes.
-
-## When to Use
-
-- Deploy serverless apps to Cloudflare Workers/Pages
-- Containerize apps with Docker, Docker Compose
-- Manage GCP with gcloud CLI (Cloud Run, GKE, Cloud SQL)
-- Kubernetes cluster management (kubectl, Helm)
-- GitOps workflows (Argo CD, Flux)
-- CI/CD pipelines, multi-region deployments
-- Security audits, RBAC, network policies
-
-## Platform Selection
-
-| Need | Choose |
-|------|--------|
-| Sub-50ms latency globally | Cloudflare Workers |
-| Large file storage (zero egress) | Cloudflare R2 |
-| SQL database (global reads) | Cloudflare D1 |
-| Containerized workloads | Docker + Cloud Run/GKE/Azure Container Apps |
-| Enterprise Kubernetes | GKE / AKS |
-| Managed relational DB | Cloud SQL / Azure SQL |
-| .NET workloads | Azure App Service / Container Apps |
-| Static site + API | Cloudflare Pages |
-| Container orchestration | Kubernetes |
-| Package management for K8s | Helm |
-
-## Quick Start
-
-```bash
-# Cloudflare Worker
-wrangler init my-worker && cd my-worker && wrangler deploy
-
-# Docker
-docker build -t myapp . && docker run -p 3000:3000 myapp
-
-# GCP Cloud Run
-gcloud run deploy my-service --image gcr.io/project/image --region us-central1
-
-# Azure App Service (.NET)
-az webapp up --name myapp --resource-group mygroup --runtime "DOTNET:8.0"
-
-# Azure Container Apps
-az containerapp up --name myapp --resource-group mygroup --image myregistry.azurecr.io/myapp:latest
-
-# Kubernetes
-kubectl apply -f manifests/ && kubectl get pods
-```
-
-## Reference Navigation
-
-### Cloudflare Platform
-- `cloudflare-platform.md` - Edge computing overview
-- `cloudflare-workers-basics.md` - Handler types, patterns
-- `cloudflare-workers-advanced.md` - Performance, optimization
-- `cloudflare-workers-apis.md` - Runtime APIs, bindings
-- `cloudflare-r2-storage.md` - Object storage, S3 compatibility
-- `cloudflare-d1-kv.md` - D1 SQLite, KV store
-- `browser-rendering.md` - Puppeteer automation
-
-### Docker
-- `docker-basics.md` - Dockerfile, images, containers
-- `docker-compose.md` - Multi-container apps
-
-### Google Cloud
-- `gcloud-platform.md` - gcloud CLI, authentication
-- `gcloud-services.md` - Compute Engine, GKE, Cloud Run
-
-### Kubernetes
-- `kubernetes-basics.md` - Core concepts, architecture, workloads
-- `kubernetes-kubectl.md` - Essential commands, debugging workflow
-- `kubernetes-helm.md` / `kubernetes-helm-advanced.md` - Helm charts, templates
-- `kubernetes-security.md` / `kubernetes-security-advanced.md` - RBAC, secrets
-- `kubernetes-workflows.md` / `kubernetes-workflows-advanced.md` - GitOps, CI/CD
-- `kubernetes-troubleshooting.md` / `kubernetes-troubleshooting-advanced.md` - Debug
-
-### Scripts
-- `scripts/cloudflare-deploy.py` - Automate Worker deployments
-- `scripts/docker-optimize.py` - Analyze Dockerfiles
-
-## Best Practices
-
-**Security:** Non-root containers, RBAC, secrets in env vars, image scanning
-**Performance:** Multi-stage builds, edge caching, resource limits
-**Cost:** R2 for large egress, caching, right-size resources
-**Development:** Docker Compose local dev, wrangler dev, version control IaC
-
-## Resources
-
-- Cloudflare: https://developers.cloudflare.com
-- Docker: https://docs.docker.com
-- GCP: https://cloud.google.com/docs
-- Azure: https://learn.microsoft.com/azure/
-- Kubernetes: https://kubernetes.io/docs
-- Helm: https://helm.sh/docs

package/skills/docs-seeker/SKILL.md

@@ -1,96 +0,0 @@
----
-name: docs-seeker
-description: Search library/framework documentation via llms.txt (context7.com). Use for API docs, GitHub repository analysis, technical documentation lookup, latest library features.
----
-
-# Documentation Discovery via Scripts
-
-## Overview
-
-**Script-first** documentation discovery using llms.txt standard.
-
-Execute scripts to handle entire workflow - no manual URL construction needed.
-
-## Primary Workflow
-
-**ALWAYS execute scripts in this order:**
-
-```bash
-# 1. DETECT query type (topic-specific vs general)
-node scripts/detect-topic.js "<user query>"
-
-# 2. FETCH documentation using script output
-node scripts/fetch-docs.js "<user query>"
-
-# 3. ANALYZE results (if multiple URLs returned)
-cat llms.txt | node scripts/analyze-llms-txt.js -
-```
-
-Scripts handle URL construction, fallback chains, and error handling automatically.
-
-## Scripts
-
-**`detect-topic.js`** - Classify query type
-- Identifies topic-specific vs general queries
-- Extracts library name + topic keyword
-- Returns JSON: `{topic, library, isTopicSpecific}`
-- Zero-token execution
-
-**`fetch-docs.js`** - Retrieve documentation
-- Constructs context7.com URLs automatically
-- Handles fallback: topic → general → error
-- Outputs llms.txt content or error message
-- Zero-token execution
-
-**`analyze-llms-txt.js`** - Process llms.txt
-- Categorizes URLs (critical/important/supplementary)
-- Recommends agent distribution (1 agent, 3 agents, 7 agents, phased)
-- Returns JSON with strategy
-- Zero-token execution
-
-## Workflow References
-
-**[Topic-Specific Search](./workflows/topic-search.md)** - Fastest path (10-15s)
-
-**[General Library Search](./workflows/library-search.md)** - Comprehensive coverage (30-60s)
-
-**[Repository Analysis](./workflows/repo-analysis.md)** - Fallback strategy
-
-## References
-
-**[context7-patterns.md](./references/context7-patterns.md)** - URL patterns, known repositories
-
-**[errors.md](./references/errors.md)** - Error handling, fallback strategies
-
-**[advanced.md](./references/advanced.md)** - Edge cases, versioning, multi-language
-
-## Execution Principles
-
-1. **Scripts first** - Execute scripts instead of manual URL construction
-2. **Zero-token overhead** - Scripts run without context loading
-3. **Automatic fallback** - Scripts handle topic → general → error chains
-4. **Progressive disclosure** - Load workflows/references only when needed
-5. **Agent distribution** - Scripts recommend parallel agent strategy
-
-## Quick Start
-
-**Topic query:** "How do I use date picker in shadcn?"
-```bash
-node scripts/detect-topic.js "<query>"  # → {topic, library, isTopicSpecific}
-node scripts/fetch-docs.js "<query>"    # → 2-3 URLs
-# Read URLs with WebFetch
-```
-
-**General query:** "Documentation for Next.js"
-```bash
-node scripts/detect-topic.js "<query>"         # → {isTopicSpecific: false}
-node scripts/fetch-docs.js "<query>"           # → 8+ URLs
-cat llms.txt | node scripts/analyze-llms-txt.js -  # → {totalUrls, distribution}
-# Deploy agents per recommendation
-```
-
-## Environment
-
-Scripts load `.env`: `process.env` > `$HOME/.copilot/skills/docs-seeker/.env` > `$HOME/.copilot/skills/.env` > `$HOME/.copilot/.env`
-
-See `.env.example` for configuration options.

package/skills/docs-seeker/references/context7-patterns.md

@@ -1,64 +0,0 @@
-# context7.com URL Patterns
-
-## Topic-Specific URLs (Priority #1)
-
-**Pattern:** `https://context7.com/{path}/llms.txt?topic={keyword}`
-
-**When to use:** User asks about specific feature/component
-
-**Examples:**
-```
-shadcn/ui date picker
-→ https://context7.com/shadcn-ui/ui/llms.txt?topic=date
-
-Next.js caching
-→ https://context7.com/vercel/next.js/llms.txt?topic=cache
-
-FFmpeg compression
-→ https://context7.com/websites/ffmpeg_doxygen_8_0/llms.txt?topic=compress
-```
-
-**Benefits:** Returns ONLY relevant docs, 10x faster, minimal tokens
-
-## General Library URLs (Priority #2)
-
-**GitHub repos:** `https://context7.com/{org}/{repo}/llms.txt`
-
-**Websites:** `https://context7.com/websites/{normalized-path}/llms.txt`
-
-## Known Repository Mappings
-
-```
-next.js → vercel/next.js
-nextjs → vercel/next.js
-astro → withastro/astro
-remix → remix-run/remix
-shadcn → shadcn-ui/ui
-shadcn/ui → shadcn-ui/ui
-```
-
-## Official Site Fallbacks
-
-Use ONLY if context7.com unavailable:
-```
-Astro: https://docs.astro.build/llms.txt
-Next.js: https://nextjs.org/llms.txt
-Remix: https://remix.run/llms.txt
-SvelteKit: https://kit.svelte.dev/llms.txt
-```
-
-## Topic Keyword Normalization
-
-**Rules:**
-- Lowercase
-- Remove special chars
-- Use first word for multi-word topics
-- Max 20 chars
-
-**Examples:**
-```
-"date picker" → "date"
-"OAuth" → "oauth"
-"Server-Side" → "server"
-"caching strategies" → "caching"
-```

package/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/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/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)