claude-cli-advanced-starter-pack 1.0.0

package/bin/gtask.js

@@ -0,0 +1,282 @@
+#!/usr/bin/env node
+
+/**
+ * Claude CLI Advanced Starter Pack - CLI Entry Point
+ *
+ * Advanced Claude Code CLI toolkit - agents, hooks, skills, MCP servers,
+ * phased development, and GitHub integration
+ */
+
+import { program } from 'commander';
+import { showMainMenu } from '../src/cli/menu.js';
+import { runSetup } from '../src/commands/setup.js';
+import { runCreate } from '../src/commands/create.js';
+import { runList } from '../src/commands/list.js';
+import { runInstall } from '../src/commands/install.js';
+import { runDecompose } from '../src/commands/decompose.js';
+import { runSync } from '../src/commands/sync.js';
+import { runTestSetup } from '../src/commands/test-setup.js';
+import { runTest } from '../src/commands/test-run.js';
+import { runCreateAgent } from '../src/commands/create-agent.js';
+import { runCreateHook } from '../src/commands/create-hook.js';
+import { runCreateCommand } from '../src/commands/create-command.js';
+import { runCreateSkill } from '../src/commands/create-skill.js';
+import { runClaudeSettings } from '../src/commands/claude-settings.js';
+import { runCreatePhaseDev } from '../src/commands/create-phase-dev.js';
+import { runGtaskInit } from '../src/commands/gtask-init.js';
+import { runDetection } from '../src/commands/detect-tech-stack.js';
+import { runExploreMcp } from '../src/commands/explore-mcp.js';
+import { runClaudeAudit } from '../src/commands/claude-audit.js';
+import { runRoadmap } from '../src/commands/roadmap.js';
+import { runInit } from '../src/commands/init.js';
+import { showHelp } from '../src/commands/help.js';
+import { runSetupWizard } from '../src/commands/setup-wizard.js';
+import { getVersion, checkPrerequisites } from '../src/utils.js';
+
+program
+  .name('ccasp')
+  .description('Claude CLI Advanced Starter Pack - Complete toolkit for Claude Code CLI')
+  .version(getVersion());
+
+// Init command - deploy to project
+program
+  .command('init')
+  .description('Deploy Claude CLI Advanced Starter Pack to current project')
+  .option('--force', 'Overwrite existing commands')
+  .action(async (options) => {
+    await runInit(options);
+  });
+
+// Interactive menu (default when no command)
+program
+  .command('menu', { isDefault: true })
+  .description('Show interactive menu')
+  .action(async () => {
+    await checkPrerequisites();
+    await showMainMenu();
+  });
+
+// Setup command
+program
+  .command('setup')
+  .description('Configure GitHub project connection')
+  .option('-o, --owner <owner>', 'GitHub username or organization')
+  .option('-r, --repo <repo>', 'Repository name')
+  .option('-p, --project <number>', 'Project board number')
+  .option('--global', 'Save config globally (~/.gtaskrc)')
+  .action(async (options) => {
+    await checkPrerequisites();
+    await runSetup(options);
+  });
+
+// Create command
+program
+  .command('create')
+  .description('Create a new GitHub issue with codebase analysis')
+  .option('-t, --title <title>', 'Issue title')
+  .option('-d, --description <desc>', 'Issue description')
+  .option('-p, --priority <priority>', 'Priority (P0, P1, P2, P3)')
+  .option('-l, --labels <labels>', 'Comma-separated labels')
+  .option('--qa', 'Requires QA validation')
+  .option('--no-qa', 'Skip QA validation')
+  .option('--batch', 'Batch mode (no interactive prompts)')
+  .option('--from-file <file>', 'Read task details from YAML file')
+  .option('--skip-analysis', 'Skip codebase analysis')
+  .action(async (options) => {
+    await checkPrerequisites();
+    await runCreate(options);
+  });
+
+// List command
+program
+  .command('list')
+  .description('List recent tasks/issues')
+  .option('-n, --limit <number>', 'Number of issues to show', '10')
+  .option('--mine', 'Only show issues assigned to me')
+  .option('--status <status>', 'Filter by status (open, closed, all)')
+  .action(async (options) => {
+    await checkPrerequisites();
+    await runList(options);
+  });
+
+// Install Claude Code integration
+program
+  .command('install')
+  .description('Install Claude Code command integration')
+  .option('--path <path>', 'Path to .claude/commands/ directory')
+  .option('--force', 'Overwrite existing command')
+  .action(async (options) => {
+    await runInstall(options);
+  });
+
+// Decompose command - break down issue into tasks
+program
+  .command('decompose [issue]')
+  .description('Decompose a GitHub issue into granular tasks')
+  .option('-i, --issue <number>', 'Issue number')
+  .action(async (issue, options) => {
+    await checkPrerequisites();
+    await runDecompose({ issue: issue || options.issue, ...options });
+  });
+
+// Sync command - synchronize with GitHub
+program
+  .command('sync [subcommand] [issue]')
+  .description('Sync task progress with GitHub (pull/push/watch/status)')
+  .option('-i, --issue <number>', 'Issue number')
+  .action(async (subcommand, issue, options) => {
+    await checkPrerequisites();
+    await runSync({
+      subcommand: subcommand || 'status',
+      issue: issue || options.issue,
+      ...options,
+    });
+  });
+
+// Test setup command
+program
+  .command('test-setup')
+  .description('Configure testing environment (Ralph Loop, credentials, Playwright)')
+  .option('--force', 'Overwrite existing testing configuration')
+  .action(async (options) => {
+    await runTestSetup(options);
+  });
+
+// Test run command
+program
+  .command('test')
+  .description('Run tests with configured mode (ralph/manual/watch)')
+  .option('-m, --mode <mode>', 'Testing mode: ralph, manual, or watch')
+  .option('-f, --file <file>', 'Specific test file to run')
+  .option('--headed', 'Run in headed mode (show browser)')
+  .option('--ui', 'Open Playwright UI mode')
+  .option('--max <iterations>', 'Max iterations for Ralph loop')
+  .option('-c, --command <command>', 'Custom test command')
+  .action(async (options) => {
+    await runTest(options);
+  });
+
+// Agent creation - master command
+program
+  .command('create-agent')
+  .description('Create Claude Code agents (interactive menu)')
+  .option('-n, --name <name>', 'Agent name')
+  .action(async (options) => {
+    await runCreateAgent(options);
+  });
+
+// Create hook
+program
+  .command('create-hook')
+  .description('Create enforcement hook (PreToolUse, UserPromptSubmit, etc.)')
+  .option('-n, --name <name>', 'Hook name')
+  .option('-e, --event <type>', 'Event type (PreToolUse, PostToolUse, UserPromptSubmit)')
+  .option('-t, --tools <tools>', 'Target tools (comma-separated)')
+  .action(async (options) => {
+    await runCreateHook(options);
+  });
+
+// Create command
+program
+  .command('create-command')
+  .description('Create slash command for Claude Code')
+  .option('-n, --name <name>', 'Command name')
+  .option('-d, --delegates-to <target>', 'Skill or agent to delegate to')
+  .action(async (options) => {
+    await runCreateCommand(options);
+  });
+
+// Create skill
+program
+  .command('create-skill')
+  .description('Create RAG-enhanced skill package')
+  .option('-n, --name <name>', 'Skill name')
+  .action(async (options) => {
+    await runCreateSkill(options);
+  });
+
+// Claude settings
+program
+  .command('claude-settings')
+  .description('Configure Claude CLI settings (permissions, agent-only mode, tech stack)')
+  .action(async () => {
+    await runClaudeSettings({});
+  });
+
+// Tech stack detection
+program
+  .command('detect-stack')
+  .description('Auto-detect project tech stack (frontend, backend, testing, etc.)')
+  .option('--silent', 'Minimal output')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    await runDetection(options);
+  });
+
+// Full project initialization
+program
+  .command('project-init')
+  .description('Complete project setup wizard (detect stack, configure integrations, generate templates)')
+  .option('--force', 'Overwrite existing configuration')
+  .action(async (options) => {
+    await runGtaskInit(options);
+  });
+
+// Phased development plan generator
+program
+  .command('create-phase-dev')
+  .description('Create phased development plan (95%+ success probability)')
+  .option('-n, --name <name>', 'Project name')
+  .option('-s, --scale <scale>', 'Force scale: S, M, or L')
+  .option('--autonomous', 'Autonomous mode (use defaults)')
+  .action(async (options) => {
+    await runCreatePhaseDev(options);
+  });
+
+// MCP Explorer
+program
+  .command('explore-mcp')
+  .description('Discover and install MCP servers based on your tech stack')
+  .option('--recommend', 'Auto-recommend based on codebase analysis')
+  .option('--testing', 'Quick install testing MCPs (Playwright/Puppeteer)')
+  .action(async (options) => {
+    await runExploreMcp(options);
+  });
+
+// Claude Audit
+program
+  .command('claude-audit')
+  .description('Audit CLAUDE.md and .claude/ folder against Anthropic best practices')
+  .option('--mode <mode>', 'Audit mode: full, claudemd, or folder')
+  .action(async (options) => {
+    await runClaudeAudit(options);
+  });
+
+// Roadmap Integration
+program
+  .command('roadmap [subcommand]')
+  .description('Sync roadmaps with GitHub Project Board (import/sync/create/status)')
+  .option('-f, --file <file>', 'Path to ROADMAP.json file')
+  .action(async (subcommand, options) => {
+    await runRoadmap({ subcommand, ...options });
+  });
+
+// Help with examples
+program
+  .command('help-examples')
+  .description('Show detailed help with examples')
+  .action(() => {
+    showHelp();
+  });
+
+// Setup Wizard - vibe-code friendly
+program
+  .command('wizard')
+  .alias('w')
+  .description('Interactive setup wizard (vibe-code friendly, mobile-ready)')
+  .action(async () => {
+    await runSetupWizard();
+  });
+
+// Parse and run
+program.parse();

package/bin/postinstall.js

@@ -0,0 +1,53 @@
+#!/usr/bin/env node
+
+/**
+ * CCASP Postinstall Script
+ *
+ * Automatically runs after npm install to guide users through setup.
+ * Designed for "vibe coding" - minimal typing, mobile-friendly.
+ */
+
+import chalk from 'chalk';
+import boxen from 'boxen';
+
+const SETUP_MESSAGE = `
+${chalk.bold.cyan('🚀 Claude CLI Advanced Starter Pack')}
+
+${chalk.green('✓')} Installation complete!
+
+${chalk.bold('Step 1: Run Setup')} ${chalk.dim('(one-time, in terminal)')}
+
+   ${chalk.dim('$')} ${chalk.white('ccasp wizard')}   ${chalk.dim('← recommended')}
+   ${chalk.dim('$')} ${chalk.white('ccasp init')}     ${chalk.dim('← quick mode')}
+
+${chalk.dim('This deploys slash commands to your .claude/ folder.')}
+
+${chalk.dim('─────────────────────────────────────')}
+
+${chalk.bold('Step 2: Restart Claude Code CLI')}
+
+${chalk.dim('─────────────────────────────────────')}
+
+${chalk.bold('Step 3: Use Slash Commands')} ${chalk.dim('(inside Claude)')}
+
+  ${chalk.cyan('/menu')}           - All commands menu
+  ${chalk.cyan('/create-agent')}   - Create L1/L2/L3 agents
+  ${chalk.cyan('/create-hook')}    - Build enforcement hooks
+  ${chalk.cyan('/explore-mcp')}    - Discover MCP servers
+  ${chalk.cyan('/phase-dev-plan')} - Create dev plans
+  ${chalk.cyan('/github-update')}  - GitHub Project Board
+`;
+
+console.log(
+  boxen(SETUP_MESSAGE, {
+    padding: 1,
+    margin: 1,
+    borderStyle: 'round',
+    borderColor: 'cyan',
+  })
+);
+
+// Check if running interactively and offer to start setup
+if (process.stdout.isTTY && !process.env.CI && !process.env.CCASP_SKIP_POSTINSTALL) {
+  console.log(chalk.dim('\nTip: Set CCASP_SKIP_POSTINSTALL=1 to skip this message\n'));
+}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "claude-cli-advanced-starter-pack",
+  "version": "1.0.0",
+  "description": "Advanced Claude Code CLI toolkit - agents, hooks, skills, MCP servers, phased development, and GitHub integration",
+  "main": "src/index.js",
+  "bin": {
+    "ccasp": "./bin/gtask.js",
+    "claude-advanced": "./bin/gtask.js",
+    "claude-cli-advanced-starter-pack": "./bin/gtask.js"
+  },
+  "type": "module",
+  "scripts": {
+    "start": "node bin/gtask.js",
+    "setup": "node bin/gtask.js setup",
+    "postinstall": "node bin/postinstall.js",
+    "test": "node --check bin/gtask.js && node --check bin/postinstall.js && echo 'Syntax OK'",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run test"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "anthropic",
+    "cli",
+    "ai-tools",
+    "mcp",
+    "agents",
+    "hooks",
+    "skills",
+    "github",
+    "developer-tools",
+    "automation",
+    "codebase-analysis"
+  ],
+  "author": "evan043",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/evan043/claude-cli-advanced-starter-pack.git"
+  },
+  "bugs": {
+    "url": "https://github.com/evan043/claude-cli-advanced-starter-pack/issues"
+  },
+  "homepage": "https://github.com/evan043/claude-cli-advanced-starter-pack#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "inquirer": "^9.2.23",
+    "ora": "^8.0.1",
+    "boxen": "^7.1.1",
+    "yaml": "^2.4.1",
+    "glob": "^10.3.10",
+    "figures": "^6.0.1"
+  },
+  "devDependencies": {
+    "eslint": "^9.0.0"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "templates/",
+    "README.md",
+    "OVERVIEW.md",
+    "LICENSE"
+  ]
+}