claude-cli-advanced-starter-pack 1.1.0 → 1.8.1

package/src/panel/queue.js

@@ -0,0 +1,188 @@
+/**
+ * CCASP Panel Queue System
+ *
+ * Handles IPC between the CCASP Panel (separate terminal) and Claude Code CLI
+ * via a file-based queue + clipboard fallback.
+ */
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync, unlinkSync, watchFile, unwatchFile } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { execSync } from 'child_process';
+
+// Queue file location - in user's .claude folder for cross-project access
+const QUEUE_DIR = join(homedir(), '.claude', 'ccasp-panel');
+const QUEUE_FILE = join(QUEUE_DIR, 'command-queue.json');
+const LOCK_FILE = join(QUEUE_DIR, '.lock');
+
+/**
+ * Ensure queue directory exists
+ */
+export function ensureQueueDir() {
+  if (!existsSync(QUEUE_DIR)) {
+    mkdirSync(QUEUE_DIR, { recursive: true });
+  }
+}
+
+/**
+ * Write a command to the queue
+ */
+export function queueCommand(command, args = '', metadata = {}) {
+  ensureQueueDir();
+
+  const entry = {
+    id: Date.now().toString(36) + Math.random().toString(36).substr(2, 5),
+    command,
+    args,
+    timestamp: Date.now(),
+    cwd: process.cwd(),
+    status: 'pending',
+    ...metadata
+  };
+
+  // Read existing queue
+  let queue = [];
+  if (existsSync(QUEUE_FILE)) {
+    try {
+      queue = JSON.parse(readFileSync(QUEUE_FILE, 'utf8'));
+    } catch {
+      queue = [];
+    }
+  }
+
+  // Add new entry
+  queue.push(entry);
+
+  // Keep only last 50 entries
+  if (queue.length > 50) {
+    queue = queue.slice(-50);
+  }
+
+  writeFileSync(QUEUE_FILE, JSON.stringify(queue, null, 2), 'utf8');
+
+  return entry;
+}
+
+/**
+ * Get the next pending command from queue
+ */
+export function getNextCommand() {
+  if (!existsSync(QUEUE_FILE)) {
+    return null;
+  }
+
+  try {
+    const queue = JSON.parse(readFileSync(QUEUE_FILE, 'utf8'));
+    return queue.find(entry => entry.status === 'pending') || null;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Mark a command as processed
+ */
+export function markCommandProcessed(id, status = 'completed') {
+  if (!existsSync(QUEUE_FILE)) {
+    return false;
+  }
+
+  try {
+    const queue = JSON.parse(readFileSync(QUEUE_FILE, 'utf8'));
+    const entry = queue.find(e => e.id === id);
+    if (entry) {
+      entry.status = status;
+      entry.processedAt = Date.now();
+      writeFileSync(QUEUE_FILE, JSON.stringify(queue, null, 2), 'utf8');
+      return true;
+    }
+  } catch {
+    return false;
+  }
+
+  return false;
+}
+
+/**
+ * Clear the entire queue
+ */
+export function clearQueue() {
+  if (existsSync(QUEUE_FILE)) {
+    unlinkSync(QUEUE_FILE);
+  }
+}
+
+/**
+ * Get queue status
+ */
+export function getQueueStatus() {
+  if (!existsSync(QUEUE_FILE)) {
+    return { total: 0, pending: 0, completed: 0, failed: 0 };
+  }
+
+  try {
+    const queue = JSON.parse(readFileSync(QUEUE_FILE, 'utf8'));
+    return {
+      total: queue.length,
+      pending: queue.filter(e => e.status === 'pending').length,
+      completed: queue.filter(e => e.status === 'completed').length,
+      failed: queue.filter(e => e.status === 'failed').length,
+    };
+  } catch {
+    return { total: 0, pending: 0, completed: 0, failed: 0 };
+  }
+}
+
+/**
+ * Copy text to clipboard (cross-platform)
+ */
+export function copyToClipboard(text) {
+  try {
+    if (process.platform === 'win32') {
+      // PowerShell clip
+      execSync(`echo ${text} | clip`, { stdio: 'pipe' });
+    } else if (process.platform === 'darwin') {
+      execSync(`echo "${text}" | pbcopy`, { stdio: 'pipe' });
+    } else {
+      // Linux - try xclip or xsel
+      try {
+        execSync(`echo "${text}" | xclip -selection clipboard`, { stdio: 'pipe' });
+      } catch {
+        execSync(`echo "${text}" | xsel --clipboard`, { stdio: 'pipe' });
+      }
+    }
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Watch queue for changes (for Claude Code hook)
+ */
+export function watchQueue(callback) {
+  ensureQueueDir();
+
+  // Create empty queue file if doesn't exist
+  if (!existsSync(QUEUE_FILE)) {
+    writeFileSync(QUEUE_FILE, '[]', 'utf8');
+  }
+
+  watchFile(QUEUE_FILE, { interval: 500 }, (curr, prev) => {
+    if (curr.mtime !== prev.mtime) {
+      const command = getNextCommand();
+      if (command) {
+        callback(command);
+      }
+    }
+  });
+
+  return () => unwatchFile(QUEUE_FILE);
+}
+
+/**
+ * Get the queue file path (for hook configuration)
+ */
+export function getQueueFilePath() {
+  return QUEUE_FILE;
+}

package/templates/commands/ask-claude.template.md

@@ -0,0 +1,118 @@
+---
+description: Natural language command discovery - find the right command for any task
+---
+
+# Ask Claude
+
+Find the right command, skill, or workflow using natural language. Smart command discovery for CCASP.
+
+## Usage
+
+Describe what you want to do:
+
+```
+/ask-claude how do I deploy to production?
+/ask-claude create a new API endpoint
+/ask-claude fix the failing tests
+/ask-claude analyze code quality
+```
+
+## How It Works
+
+1. **Parse Intent** - Understand what you're trying to accomplish
+2. **Match Commands** - Find relevant slash commands and skills
+3. **Suggest Workflow** - Recommend the best approach
+4. **Execute or Guide** - Run the command or explain how to use it
+
+## Command Categories
+
+### Development
+| Intent | Command |
+|--------|---------|
+| "create agent" | `/create-agent` |
+| "create hook" | `/create-hook` |
+| "create skill" | `/create-skill` |
+| "create command" | `/create-command` |
+
+### Testing
+| Intent | Command |
+|--------|---------|
+| "run tests" | `/e2e-test` |
+| "create test" | `/create-smoke-test` |
+| "fix failing tests" | `/e2e-test --ralph` |
+
+### GitHub
+| Intent | Command |
+|--------|---------|
+| "create issue" | `/github-task` |
+| "start task" | `/github-task-start` |
+| "check status" | `/github-update` |
+
+### Refactoring
+| Intent | Command |
+|--------|---------|
+| "check quality" | `/refactor-check` |
+| "cleanup code" | `/refactor-cleanup` |
+| "analyze code" | `/refactor-analyze` |
+
+### Deployment
+| Intent | Command |
+|--------|---------|
+| "deploy" | `/deploy-full` |
+| "start tunnel" | `/tunnel-start` |
+
+### Setup
+| Intent | Command |
+|--------|---------|
+| "configure project" | `/ccasp-setup` |
+| "audit setup" | `/claude-audit` |
+| "explore MCP" | `/explore-mcp` |
+
+## Response Format
+
+```
+You asked: "how do I deploy to production?"
+
+Recommended: /deploy-full
+
+This command:
+- Builds the frontend
+- Deploys backend to Railway (or configured platform)
+- Deploys frontend to Cloudflare (or configured platform)
+- Runs smoke tests to verify deployment
+
+Would you like me to run /deploy-full now?
+[Y] Yes, deploy now
+[C] Configure deployment platforms first
+[H] Show detailed help for this command
+```
+
+## Smart Matching
+
+The command uses fuzzy matching to understand:
+
+- **Synonyms**: "deploy", "publish", "release" → `/deploy-full`
+- **Actions**: "create", "make", "add" → context-dependent
+- **Targets**: "test", "agent", "hook" → specific command
+- **Modifiers**: "quick", "full", "all" → command options
+
+## Fallback Behavior
+
+If no exact match is found:
+
+1. Show top 3 most likely commands
+2. Ask clarifying questions
+3. Suggest reading `/menu` for full command list
+
+## Configuration
+
+Commands are discovered from:
+- `.claude/commands/INDEX.md`
+- Built-in CCASP commands
+- Tech-stack specific commands
+
+## Related Commands
+
+- `/menu` - Interactive command browser
+- `/help-examples` - Detailed usage examples
+- `/ccasp-setup` - Project configuration wizard

package/templates/commands/ccasp-panel.template.md

@@ -0,0 +1,72 @@
+# CCASP Control Panel
+
+Launch the CCASP Control Panel in a separate terminal window.
+
+## Instructions for Claude
+
+**IMPORTANT**: Execute the appropriate Bash command below to launch the panel in a new terminal window.
+
+### Step 1: Launch Panel in New Window
+
+Use the Bash tool to run ONE of these commands based on the platform:
+
+**Windows (default):**
+```bash
+start powershell -NoExit -Command "ccasp panel"
+```
+
+**macOS:**
+```bash
+osascript -e 'tell application "Terminal" to do script "ccasp panel"'
+```
+
+**Linux (gnome-terminal):**
+```bash
+gnome-terminal -- ccasp panel &
+```
+
+### Step 2: Confirm Launch
+
+After running the command, tell the user:
+
+```
+✅ CCASP Panel launched in a new terminal window!
+
+How to use:
+1. Switch to the new terminal window
+2. Press a key to select a command (e.g., 'A' for Create Agent)
+3. Come back here and press Enter to execute
+
+Panel Controls:
+  [A] Create Agent     [H] Create Hook      [S] Create Skill
+  [M] Explore MCP      [C] Claude Audit     [E] Explore Codebase
+  [P] Phase Dev Plan   [G] GitHub Task      [T] Run E2E Tests
+  [Q] Quit             [R] Refresh          [X] Clear Queue
+```
+
+### First-Time Setup (if hook not installed)
+
+If the user hasn't set up the panel hook yet, run:
+
+```bash
+ccasp install-panel-hook --global
+```
+
+Then tell them to restart Claude Code for the hook to take effect.
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│ CCASP Control Panel (NEW terminal window)                       │
+│                                                                 │
+│   Press key → Command queued to ~/.claude/ccasp-panel/          │
+└─────────────────────────────────────────────────────────────────┘
+          │
+          ▼
+┌─────────────────────────────────────────────────────────────────┐
+│ Claude Code CLI (THIS terminal)                                  │
+│                                                                 │
+│   Press Enter → Hook reads queue → Executes command             │
+└─────────────────────────────────────────────────────────────────┘
+```