vibe-coder-kit 6.0.0

package/bin/vibe.js

@@ -0,0 +1,351 @@
+#!/usr/bin/env node
+
+/**
+ * Vibe Coder Kit - CLI Installer
+ * 
+ * Usage:
+ *   npx vibe-coder-kit init      # Install VCK to current project
+ *   npx vibe-coder-kit status    # Show VCK status
+ *   npx vibe-coder-kit doctor    # Health check
+ *   npx vibe-coder-kit version   # Show version
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const VERSION = '6.0.0';
+const VCK_SOURCE = path.join(__dirname, '..', '.vibe');
+
+// Colors for terminal output
+const colors = {
+  reset: '\x1b[0m',
+  bright: '\x1b[1m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+};
+
+function log(message, color = 'reset') {
+  console.log(`${colors[color]}${message}${colors.reset}`);
+}
+
+function logSuccess(message) {
+  log(`✓ ${message}`, 'green');
+}
+
+function logError(message) {
+  log(`✗ ${message}`, 'red');
+}
+
+function logInfo(message) {
+  log(`ℹ ${message}`, 'cyan');
+}
+
+function logWarning(message) {
+  log(`⚠ ${message}`, 'yellow');
+}
+
+function showHelp() {
+  log('\n🚀 Vibe Coder Kit v' + VERSION, 'bright');
+  log('\nUsage:', 'bright');
+  log('  vibe init        Install VCK to current project');
+  log('  vibe status      Show VCK status');
+  log('  vibe doctor      Health check');
+  log('  vibe version     Show version');
+  log('  vibe help        Show this help\n', 'bright');
+}
+
+function showVersion() {
+  log(`Vibe Coder Kit v${VERSION}`, 'bright');
+}
+
+function ensureDirectoryExists(dir) {
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+}
+
+function copyDirSync(src, dest) {
+  ensureDirectoryExists(dest);
+  
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    
+    if (entry.isDirectory()) {
+      copyDirSync(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+function initProject() {
+  log('\n🚀 Vibe Coder Kit - Initial Setup\n', 'bright');
+  
+  const targetDir = process.cwd();
+  const vibeDir = path.join(targetDir, '.vibe');
+  
+  // Check if .vibe already exists
+  if (fs.existsSync(vibeDir)) {
+    logWarning('.vibe directory already exists');
+    
+    const overwrite = process.argv.includes('--force');
+    if (!overwrite) {
+      logInfo('Use --force to overwrite existing installation');
+      return;
+    }
+    logInfo('Overwriting existing installation...');
+  }
+  
+  // Copy .vibe directory
+  logInfo('Copying .vibe directory...');
+  try {
+    if (fs.existsSync(vibeDir)) {
+      fs.rmSync(vibeDir, { recursive: true, force: true });
+    }
+    copyDirSync(VCK_SOURCE, vibeDir);
+    logSuccess('.vibe directory created');
+  } catch (error) {
+    logError(`Failed to copy .vibe directory: ${error.message}`);
+    return;
+  }
+  
+  // Copy AGENTS.md
+  logInfo('Copying AGENTS.md...');
+  try {
+    const agentsMdSource = path.join(VCK_SOURCE, '..', 'AGENTS.md');
+    const agentsMdTarget = path.join(targetDir, 'AGENTS.md');
+    
+    if (fs.existsSync(agentsMdSource)) {
+      fs.copyFileSync(agentsMdSource, agentsMdTarget);
+      logSuccess('AGENTS.md created');
+    } else {
+      // Create a basic AGENTS.md
+      const basicAgentsMd = `# Vibe Coder Kit
+
+## Kurallar
+- Her adımda event kaydet
+- Test yazmadan kod yazma
+- Secret kullanma
+- Budget aşıldığında dur
+
+## Kullanım
+- \`vibe status\` - Durumu göster
+- \`vibe doctor\` - Sağlık kontrolü
+`;
+      fs.writeFileSync(agentsMdTarget, basicAgentsMd);
+      logSuccess('AGENTS.md created (basic)');
+    }
+  } catch (error) {
+    logWarning(`Failed to copy AGENTS.md: ${error.message}`);
+  }
+  
+  // Initialize state directory
+  logInfo('Initializing state...');
+  const stateDir = path.join(vibeDir, 'state');
+  ensureDirectoryExists(stateDir);
+  
+  const eventsFile = path.join(stateDir, 'events.jsonl');
+  if (!fs.existsSync(eventsFile)) {
+    fs.writeFileSync(eventsFile, '');
+  }
+  
+  const derivedStateFile = path.join(stateDir, 'derived-state.json');
+  if (!fs.existsSync(derivedStateFile)) {
+    fs.writeFileSync(derivedStateFile, JSON.stringify({
+      currentPhase: 'init',
+      phaseHistory: [],
+      task: { title: '', description: '', priority: 'medium' },
+      decisions: [],
+      openQuestions: [],
+      scope: { inScope: [], outScope: [], decidedLater: [] },
+      blockerLog: [],
+      health: {
+        lastUpdated: new Date().toISOString(),
+        phaseDurationMinutes: 0,
+        openBlockers: 0,
+      },
+    }, null, 2));
+  }
+  logSuccess('State initialized');
+  
+  // Initialize knowledge directory
+  logInfo('Initializing knowledge base...');
+  const knowledgeDir = path.join(vibeDir, 'memory', 'knowledge');
+  ensureDirectoryExists(knowledgeDir);
+  
+  const indexPath = path.join(knowledgeDir, 'INDEX.md');
+  if (!fs.existsSync(indexPath)) {
+    fs.writeFileSync(indexPath, '# Knowledge Index\n\n| # | Date | Title | Tags | File |\n|---|------|-------|------|------|\n');
+  }
+  logSuccess('Knowledge base initialized');
+  
+  // Initialize workspace directories
+  logInfo('Initializing workspace...');
+  const workspaceDirs = ['plans', 'reports', 'archive'];
+  for (const dir of workspaceDirs) {
+    ensureDirectoryExists(path.join(vibeDir, 'workspace', dir));
+  }
+  logSuccess('Workspace initialized');
+  
+  log('\n✅ Vibe Coder Kit installed successfully!\n', 'green');
+  log('Next steps:', 'bright');
+  log('  1. Run "vibe doctor" to check health');
+  log('  2. Run "vibe status" to see current state');
+  log('  3. Start coding with AI assistance\n', 'bright');
+}
+
+function showStatus() {
+  log('\n📊 Vibe Coder Kit - Status\n', 'bright');
+  
+  const targetDir = process.cwd();
+  const vibeDir = path.join(targetDir, '.vibe');
+  
+  if (!fs.existsSync(vibeDir)) {
+    logError('Vibe Coder Kit not installed in this project');
+    logInfo('Run "vibe init" to install');
+    return;
+  }
+  
+  // Read derived state
+  const derivedStateFile = path.join(vibeDir, 'state', 'derived-state.json');
+  if (fs.existsSync(derivedStateFile)) {
+    try {
+      const state = JSON.parse(fs.readFileSync(derivedStateFile, 'utf-8'));
+      log(`Current Phase: ${state.currentPhase}`, 'cyan');
+      log(`Last Updated: ${state.health.lastUpdated}`, 'cyan');
+      log(`Open Blockers: ${state.health.openBlockers}`, 'cyan');
+    } catch (error) {
+      logWarning('Failed to read state');
+    }
+  } else {
+    logWarning('No state found');
+  }
+  
+  // Count events
+  const eventsFile = path.join(vibeDir, 'state', 'events.jsonl');
+  if (fs.existsSync(eventsFile)) {
+    const content = fs.readFileSync(eventsFile, 'utf-8');
+    const eventCount = content.split('\n').filter(l => l.trim()).length;
+    log(`Total Events: ${eventCount}`, 'cyan');
+  }
+  
+  console.log('');
+}
+
+function runDoctor() {
+  log('\n🏥 Vibe Coder Kit - Health Check\n', 'bright');
+  
+  const targetDir = process.cwd();
+  const vibeDir = path.join(targetDir, '.vibe');
+  
+  const checks = [];
+  
+  // Check .vibe directory
+  if (fs.existsSync(vibeDir)) {
+    logSuccess('.vibe directory exists');
+    checks.push({ name: 'Installation', status: 'ok' });
+  } else {
+    logError('.vibe directory not found');
+    checks.push({ name: 'Installation', status: 'error' });
+  }
+  
+  // Check config.json
+  const configFile = path.join(vibeDir, 'config.json');
+  if (fs.existsSync(configFile)) {
+    try {
+      JSON.parse(fs.readFileSync(configFile, 'utf-8'));
+      logSuccess('config.json is valid');
+      checks.push({ name: 'Config', status: 'ok' });
+    } catch (error) {
+      logError('config.json is invalid');
+      checks.push({ name: 'Config', status: 'error' });
+    }
+  } else {
+    logWarning('config.json not found');
+    checks.push({ name: 'Config', status: 'warning' });
+  }
+  
+  // Check phase-graph.json
+  const graphFile = path.join(vibeDir, 'phase-graph.json');
+  if (fs.existsSync(graphFile)) {
+    try {
+      JSON.parse(fs.readFileSync(graphFile, 'utf-8'));
+      logSuccess('phase-graph.json is valid');
+      checks.push({ name: 'Graph', status: 'ok' });
+    } catch (error) {
+      logError('phase-graph.json is invalid');
+      checks.push({ name: 'Graph', status: 'error' });
+    }
+  } else {
+    logWarning('phase-graph.json not found');
+    checks.push({ name: 'Graph', status: 'warning' });
+  }
+  
+  // Check state directory
+  const stateDir = path.join(vibeDir, 'state');
+  if (fs.existsSync(stateDir)) {
+    logSuccess('State directory exists');
+    checks.push({ name: 'State', status: 'ok' });
+  } else {
+    logWarning('State directory not found');
+    checks.push({ name: 'State', status: 'warning' });
+  }
+  
+  // Check knowledge directory
+  const knowledgeDir = path.join(vibeDir, 'memory', 'knowledge');
+  if (fs.existsSync(knowledgeDir)) {
+    logSuccess('Knowledge directory exists');
+    checks.push({ name: 'Knowledge', status: 'ok' });
+  } else {
+    logWarning('Knowledge directory not found');
+    checks.push({ name: 'Knowledge', status: 'warning' });
+  }
+  
+  // Summary
+  const errors = checks.filter(c => c.status === 'error').length;
+  const warnings = checks.filter(c => c.status === 'warning').length;
+  
+  console.log('');
+  if (errors === 0 && warnings === 0) {
+    logSuccess('All checks passed!');
+  } else if (errors === 0) {
+    logWarning(`${warnings} warning(s) found`);
+  } else {
+    logError(`${errors} error(s), ${warnings} warning(s) found`);
+  }
+  console.log('');
+}
+
+// Main CLI
+const command = process.argv[2];
+
+switch (command) {
+  case 'init':
+    initProject();
+    break;
+  case 'status':
+    showStatus();
+    break;
+  case 'doctor':
+    runDoctor();
+    break;
+  case 'version':
+    showVersion();
+    break;
+  case 'help':
+  case undefined:
+    showHelp();
+    break;
+  default:
+    logError(`Unknown command: ${command}`);
+    showHelp();
+    process.exit(1);
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "vibe-coder-kit",
+  "version": "6.0.0",
+  "description": "Production-ready AI agent workflow template with TypeScript enforcement",
+  "main": "dist/.vibe/core/index.js",
+  "types": "dist/.vibe/core/index.d.ts",
+  "bin": {
+    "vibe": "bin/vibe.js",
+    "vibe-coder-kit": "bin/vibe.js"
+  },
+  "files": [
+    "bin/",
+    ".vibe/",
+    "AGENTS.md",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node .vibe/core/cli.ts",
+    "start": "node dist/.vibe/core/cli.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint .vibe/core/**/*.ts",
+    "typecheck": "tsc --noEmit",
+    "postinstall": "node bin/vibe.js postinstall"
+  },
+  "dependencies": {
+    "yaml": "^2.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.3.0",
+    "ts-node": "^10.9.0",
+    "vitest": "^1.2.0",
+    "eslint": "^8.56.0",
+    "@typescript-eslint/eslint-plugin": "^6.19.0",
+    "@typescript-eslint/parser": "^6.19.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "ai",
+    "agent",
+    "workflow",
+    "vibe-coder-kit",
+    "vibe",
+    "typescript",
+    "mcp",
+    "subagent"
+  ],
+  "author": "VCK Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/vibe-coder-kit.git"
+  },
+  "homepage": "https://github.com/yourusername/vibe-coder-kit#readme",
+  "bugs": {
+    "url": "https://github.com/yourusername/vibe-coder-kit/issues"
+  }
+}