@nclamvn/vibecode-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Lâm
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,91 @@
+# Vibecode CLI
+
+> Build software with discipline - AI coding with guardrails
+
+[![npm version](https://badge.fury.io/js/vibecode-cli.svg)](https://badge.fury.io/js/vibecode-cli)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## What is Vibecode?
+
+Vibecode CLI transforms AI coding tools into disciplined builders. It provides:
+
+- 🎯 **Guided workflow** - Step-by-step from idea to production
+- 🔒 **Quality gates** - No shipping without checks
+- 📋 **Contract-first** - Clear scope before building
+- 📊 **State tracking** - Always know where you are
+- 📝 **Audit trail** - Every decision documented
+
+## Installation
+
+```bash
+npm install -g vibecode-cli
+```
+
+Requires Node.js 18 or higher.
+
+## Quick Start
+
+```bash
+# 1. Initialize workspace
+cd your-project
+vibecode init
+
+# 2. Start guided session
+vibecode start
+
+# 3. Check status anytime
+vibecode status
+
+# 4. Lock contract when ready
+vibecode lock
+
+# 5. Health check
+vibecode doctor
+```
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `vibecode init` | Initialize .vibecode/ workspace |
+| `vibecode start` | Start guided session |
+| `vibecode status` | Show current state and progress |
+| `vibecode lock` | Validate and lock contract |
+| `vibecode doctor` | Check installation health |
+
+## Workflow
+
+```
+INIT → INTAKE → BLUEPRINT → CONTRACT → LOCK → BUILD → REVIEW → SHIP
+```
+
+## Files Created
+
+```
+.vibecode/
+├── vibecode.yaml      # Configuration
+├── state.json         # Current state
+├── sessions/          # Session files
+│   └── [timestamp]/
+│       ├── intake.md
+│       ├── blueprint.md
+│       └── contract.md
+└── logs/              # Audit trail
+```
+
+## Philosophy
+
+Vibecode is built on the "AI as Pipeline" philosophy:
+
+- **AI proposes** based on patterns and best practices
+- **Human decides** based on context and goals
+- **Contract locks** scope before building
+- **Evidence proves** work was done correctly
+
+## License
+
+MIT © Lâm
+
+---
+
+Built with ❤️ using Vibecode Kit v4.0

package/bin/vibecode.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Entry Point
+// Spec Hash: 0fe43335f5a325e3279a079ce616c052
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import { Command } from 'commander';
+import {
+  initCommand,
+  startCommand,
+  statusCommand,
+  lockCommand,
+  doctorCommand,
+  VERSION
+} from '../src/index.js';
+
+const program = new Command();
+
+program
+  .name('vibecode')
+  .description('Build software with discipline - AI coding with guardrails')
+  .version(VERSION);
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Commands
+// ─────────────────────────────────────────────────────────────────────────────
+
+program
+  .command('init')
+  .description('Initialize Vibecode workspace in current directory')
+  .option('-f, --force', 'Overwrite existing workspace')
+  .option('-q, --quiet', 'Minimal output')
+  .action(initCommand);
+
+program
+  .command('start')
+  .description('Start guided Vibecode session')
+  .option('-r, --resume', 'Resume existing session')
+  .action(startCommand);
+
+program
+  .command('status')
+  .description('Display current state and progress')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Show detailed info')
+  .action(statusCommand);
+
+program
+  .command('lock')
+  .description('Lock contract and generate spec hash')
+  .option('-d, --dry-run', 'Validate without locking')
+  .option('-f, --force', 'Lock even with warnings')
+  .action(lockCommand);
+
+program
+  .command('doctor')
+  .description('Check configuration and diagnose issues')
+  .action(doctorCommand);
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Parse
+// ─────────────────────────────────────────────────────────────────────────────
+
+program.parse();

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@nclamvn/vibecode-cli",
+  "version": "1.0.0",
+  "description": "Build software with discipline - AI coding with guardrails",
+  "main": "src/index.js",
+  "type": "module",
+  "bin": {
+    "vibecode": "./bin/vibecode.js"
+  },
+  "scripts": {
+    "start": "node bin/vibecode.js",
+    "lint": "eslint src/",
+    "test": "echo \"Tests coming in Phase B\" && exit 0"
+  },
+  "keywords": [
+    "cli",
+    "ai",
+    "coding",
+    "claude",
+    "vibecode",
+    "development",
+    "workflow"
+  ],
+  "author": "Lâm",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "boxen": "^7.1.1",
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "fs-extra": "^11.2.0",
+    "inquirer": "^9.2.12",
+    "ora": "^8.0.1",
+    "yaml": "^2.3.4"
+  },
+  "devDependencies": {
+    "eslint": "^8.56.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/user/vibecode-cli"
+  }
+}

package/src/commands/doctor.js

@@ -0,0 +1,130 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Doctor Command
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import chalk from 'chalk';
+import ora from 'ora';
+import { VERSION, SPEC_HASH } from '../config/constants.js';
+import {
+  workspaceExists,
+  loadConfig,
+  loadState
+} from '../core/workspace.js';
+import { getCurrentSessionId, getSessionFilesStatus } from '../core/session.js';
+import { getSpecHash } from '../core/contract.js';
+import { printBox } from '../ui/output.js';
+
+export async function doctorCommand() {
+  console.log();
+  console.log(chalk.cyan('🔍 Vibecode Doctor'));
+  console.log(chalk.gray('   Checking installation and workspace health...\n'));
+
+  const checks = [];
+
+  // Check Node version
+  const nodeVersion = process.version;
+  const nodeMajor = parseInt(nodeVersion.slice(1).split('.')[0]);
+  checks.push({
+    name: 'Node.js version',
+    status: nodeMajor >= 18 ? 'ok' : 'error',
+    message: `${nodeVersion} ${nodeMajor >= 18 ? '(OK)' : '(Need 18+)'}`
+  });
+
+  // Check CLI version
+  checks.push({
+    name: 'Vibecode CLI',
+    status: 'ok',
+    message: `v${VERSION}`
+  });
+
+  // Check workspace
+  const hasWorkspace = await workspaceExists();
+  checks.push({
+    name: 'Workspace',
+    status: hasWorkspace ? 'ok' : 'warning',
+    message: hasWorkspace ? '.vibecode/ found' : 'Not initialized (run vibecode init)'
+  });
+
+  if (hasWorkspace) {
+    try {
+      // Check config
+      const config = await loadConfig();
+      checks.push({
+        name: 'Config',
+        status: 'ok',
+        message: 'vibecode.yaml valid'
+      });
+
+      // Check state
+      const state = await loadState();
+      checks.push({
+        name: 'State',
+        status: 'ok',
+        message: `state.json valid (${state.current_state})`
+      });
+
+      // Check session
+      const sessionId = await getCurrentSessionId();
+      checks.push({
+        name: 'Session',
+        status: sessionId ? 'ok' : 'info',
+        message: sessionId ? '1 active session' : 'No active session'
+      });
+
+      // Check contract
+      const specHash = await getSpecHash();
+      checks.push({
+        name: 'Contract',
+        status: specHash ? 'ok' : 'warning',
+        message: specHash ? `Locked (${specHash.substring(0, 8)}...)` : 'Not locked'
+      });
+
+    } catch (error) {
+      checks.push({
+        name: 'Workspace files',
+        status: 'error',
+        message: error.message
+      });
+    }
+  }
+
+  // Print results
+  let hasErrors = false;
+  let hasWarnings = false;
+
+  checks.forEach(check => {
+    let icon, color;
+    switch (check.status) {
+      case 'ok':
+        icon = '✅';
+        color = chalk.green;
+        break;
+      case 'warning':
+        icon = '⚠️ ';
+        color = chalk.yellow;
+        hasWarnings = true;
+        break;
+      case 'error':
+        icon = '❌';
+        color = chalk.red;
+        hasErrors = true;
+        break;
+      default:
+        icon = 'ℹ️ ';
+        color = chalk.blue;
+    }
+
+    console.log(`  ${icon} ${check.name}: ${color(check.message)}`);
+  });
+
+  // Summary
+  console.log();
+  if (hasErrors) {
+    console.log(chalk.red('  Some checks failed. Please fix the errors above.'));
+  } else if (hasWarnings) {
+    console.log(chalk.yellow('  All checks passed! (with warnings)'));
+  } else {
+    console.log(chalk.green('  All checks passed!'));
+  }
+  console.log();
+}

package/src/commands/init.js

@@ -0,0 +1,62 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Init Command
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import ora from 'ora';
+import { workspaceExists, createWorkspace, getWorkspacePath } from '../core/workspace.js';
+import { printBox, printSuccess, printError, printNextStep } from '../ui/output.js';
+import { confirmAction } from '../ui/prompts.js';
+
+export async function initCommand(options = {}) {
+  const spinner = ora('Checking workspace...').start();
+
+  try {
+    // Check if already exists
+    if (await workspaceExists()) {
+      spinner.stop();
+
+      if (!options.force) {
+        printError('Workspace already exists!');
+        console.log();
+        console.log('  Use --force to reinitialize (will backup existing)');
+        console.log('  Or run `vibecode start` to continue');
+        process.exit(1);
+      }
+
+      const confirm = await confirmAction('This will overwrite existing workspace. Continue?');
+      if (!confirm) {
+        console.log('Cancelled.');
+        process.exit(0);
+      }
+
+      spinner.start('Reinitializing workspace...');
+    }
+
+    // Create workspace
+    spinner.text = 'Creating workspace...';
+    await createWorkspace();
+
+    spinner.succeed('Workspace initialized!');
+
+    // Print success box
+    const content = `✅ Vibecode workspace initialized!
+
+Created:
+  .vibecode/
+  ├── vibecode.yaml
+  ├── state.json
+  ├── sessions/
+  ├── library/
+  └── logs/
+
+Spec Hash Reference: 0fe43335f5a325e3279a079ce616c052`;
+
+    printBox(content, { borderColor: 'green' });
+    printNextStep('Run `vibecode start` to begin your project');
+
+  } catch (error) {
+    spinner.fail('Failed to initialize workspace');
+    printError(error.message);
+    process.exit(1);
+  }
+}

package/src/commands/lock.js

@@ -0,0 +1,105 @@
+// ═══════════════════════════════════════════════════════════════════════════════
+// VIBECODE CLI - Lock Command
+// ═══════════════════════════════════════════════════════════════════════════════
+
+import chalk from 'chalk';
+import ora from 'ora';
+import { workspaceExists, loadState } from '../core/workspace.js';
+import { getCurrentSessionId, sessionFileExists } from '../core/session.js';
+import { lockContract, validateContract } from '../core/contract.js';
+import { readSessionFile } from '../core/session.js';
+import { transitionTo, getCurrentState } from '../core/state-machine.js';
+import { STATES } from '../config/constants.js';
+import { printBox, printError, printSuccess, printWarning, printNextStep } from '../ui/output.js';
+
+export async function lockCommand(options = {}) {
+  const spinner = ora('Validating contract...').start();
+
+  try {
+    // Check workspace
+    if (!await workspaceExists()) {
+      spinner.fail();
+      printError('No Vibecode workspace found. Run `vibecode init` first.');
+      process.exit(1);
+    }
+
+    // Check state
+    const currentState = await getCurrentState();
+    if (currentState !== STATES.CONTRACT_DRAFTED) {
+      spinner.fail();
+      printError(`Cannot lock contract in state: ${currentState}`);
+      console.log('Contract must be in CONTRACT_DRAFTED state.');
+      console.log(`Current state: ${currentState}`);
+      process.exit(1);
+    }
+
+    // Check contract file exists
+    if (!await sessionFileExists('contract.md')) {
+      spinner.fail();
+      printError('Contract file not found.');
+      console.log('Create a contract first using `vibecode start`.');
+      process.exit(1);
+    }
+
+    // Dry run mode
+    if (options.dryRun) {
+      const content = await readSessionFile('contract.md');
+      const validation = validateContract(content);
+
+      spinner.stop();
+
+      if (validation.valid) {
+        printSuccess('Contract validation passed!');
+        if (validation.warnings.length > 0) {
+          validation.warnings.forEach(w => printWarning(w));
+        }
+        console.log('\nRun without --dry-run to lock.');
+      } else {
+        printError('Contract validation failed:');
+        validation.errors.forEach(e => console.log(chalk.red(`  • ${e}`)));
+      }
+      return;
+    }
+
+    // Lock contract
+    spinner.text = 'Locking contract...';
+    const result = await lockContract();
+
+    if (!result.success) {
+      spinner.fail('Contract validation failed');
+      console.log();
+      result.errors.forEach(e => console.log(chalk.red(`  ❌ ${e}`)));
+      console.log();
+      console.log('Please edit contract.md and try again.');
+      process.exit(1);
+    }
+
+    // Transition state
+    await transitionTo(STATES.CONTRACT_LOCKED, 'contract_locked');
+
+    spinner.succeed('Contract locked!');
+
+    // Success output
+    const content = `🔒 CONTRACT LOCKED
+
+Spec Hash: ${result.specHash}
+Locked at: ${result.timestamp}
+
+Contract is now immutable.
+All builds must reference this spec_hash.`;
+
+    printBox(content, { borderColor: 'green' });
+
+    if (result.warnings.length > 0) {
+      console.log();
+      result.warnings.forEach(w => printWarning(w));
+    }
+
+    printNextStep('Ready for build! Transfer to Claude Code with contract.');
+
+  } catch (error) {
+    spinner.fail('Failed to lock contract');
+    printError(error.message);
+    process.exit(1);
+  }
+}