codecruise 0.1.0

package/config/templates/steering/structure.md

@@ -0,0 +1,146 @@
+# Project Structure
+
+> Architecture, patterns, and conventions.
+
+## System Context (C4 Level 1)
+
+<!-- How does this system fit in the larger ecosystem? -->
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     [Users/Actors]                          │
+│                          │                                  │
+│                          ▼                                  │
+│                   ┌─────────────┐                          │
+│                   │  {System}   │                          │
+│                   └─────────────┘                          │
+│                          │                                  │
+│              ┌───────────┼───────────┐                     │
+│              ▼           ▼           ▼                     │
+│         [External]  [External]  [External]                 │
+│         [System 1]  [System 2]  [System 3]                 │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Container Diagram (C4 Level 2)
+
+<!-- Major deployable units -->
+
+| Container | Technology | Purpose |
+|-----------|------------|---------|
+| | | |
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      {System Name}                          │
+├─────────────────────────────────────────────────────────────┤
+│  ┌──────────┐    ┌──────────┐    ┌──────────┐             │
+│  │ Web App  │───▶│   API    │───▶│ Database │             │
+│  │ (React)  │    │ (Node)   │    │ (Postgres)│             │
+│  └──────────┘    └──────────┘    └──────────┘             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Directory Structure
+
+```
+{project}/
+├── src/
+│   ├── {layer}/           # {description}
+│   ├── {layer}/           # {description}
+│   └── {layer}/           # {description}
+├── tests/
+│   ├── unit/
+│   └── integration/
+├── docs/
+│   ├── canon/             # Canonical spec (spec.md, issues.md)
+│   ├── context/           # Per-feature context
+│   └── steering/          # This file, product.md, tech.md
+├── roadmap/               # Phase/feature/TODO definitions
+└── {config files}
+```
+
+## Architectural Patterns
+
+<!-- List patterns used and where -->
+
+| Pattern | Where Used | Example |
+|---------|------------|---------|
+| | | |
+
+## Naming Conventions
+
+| Element | Convention | Example |
+|---------|------------|---------|
+| Files | | |
+| Components | | |
+| Functions | | |
+| Variables | | |
+| Constants | | |
+| Types/Interfaces | | |
+| CSS Classes | | |
+| Database Tables | | |
+| API Endpoints | | |
+
+## Import Order
+
+<!-- Specify import ordering for consistency -->
+
+```typescript
+// 1. External packages
+import React from 'react';
+
+// 2. Internal packages (monorepo)
+import { Button } from '@myorg/ui';
+
+// 3. Relative imports (parent)
+import { utils } from '../utils';
+
+// 4. Relative imports (sibling/child)
+import { Component } from './Component';
+
+// 5. Types (if separate)
+import type { Props } from './types';
+
+// 6. Styles
+import './styles.css';
+```
+
+## Module Boundaries
+
+<!-- What can import what? -->
+
+| Module | Can Import | Cannot Import |
+|--------|------------|---------------|
+| | | |
+
+## Error Handling
+
+<!-- Standard error handling patterns -->
+
+```typescript
+// Example pattern
+```
+
+## Logging
+
+<!-- Logging conventions -->
+
+| Level | When to Use | Example |
+|-------|-------------|---------|
+| error | | |
+| warn | | |
+| info | | |
+| debug | | |
+
+## Testing Strategy
+
+| Type | Location | Naming | Coverage Target |
+|------|----------|--------|-----------------|
+| Unit | | | |
+| Integration | | | |
+| E2E | | | |
+
+---
+
+*Last updated: {date}*

package/config/templates/steering/tech.md

@@ -0,0 +1,85 @@
+# Tech Stack
+
+> Languages, frameworks, tools, and constraints.
+
+## Core Stack
+
+| Layer | Technology | Version | Rationale |
+|-------|------------|---------|-----------|
+| Language | | | |
+| Runtime | | | |
+| Framework | | | |
+| Database | | | |
+| Cache | | | |
+| Queue | | | |
+
+## Package Manager
+
+<!-- Critical for AI agents to know -->
+```
+{npm|pnpm|yarn|bun} {version}
+```
+
+## Key Dependencies
+
+<!-- Only list non-obvious or opinionated choices -->
+
+| Package | Purpose | Why This One |
+|---------|---------|--------------|
+| | | |
+
+## Dev Tools
+
+| Tool | Purpose | Command |
+|------|---------|---------|
+| Linter | | `{command}` |
+| Formatter | | `{command}` |
+| Type Checker | | `{command}` |
+| Test Runner | | `{command}` |
+| Build | | `{command}` |
+
+## Quality Command
+
+<!-- Single command that validates code quality. Must be <10s. -->
+```bash
+{quality_command}
+```
+
+## Environment
+
+| Variable | Purpose | Example |
+|----------|---------|---------|
+| | | |
+
+## External Services
+
+| Service | Purpose | Auth Method |
+|---------|---------|-------------|
+| | | |
+
+## Constraints
+
+<!-- Technical limitations or requirements -->
+
+- **Browser Support**: {e.g., "Last 2 versions, no IE"}
+- **Node Version**: {e.g., ">=20"}
+- **Performance**: {e.g., "First contentful paint <2s"}
+- **Bundle Size**: {e.g., "Main bundle <200KB gzipped"}
+
+## Security Requirements
+
+- [ ] No secrets in code/logs/commits
+- [ ] {project-specific requirement}
+- [ ] {project-specific requirement}
+
+## Deployment
+
+| Environment | Platform | URL |
+|-------------|----------|-----|
+| Development | | |
+| Staging | | |
+| Production | | |
+
+---
+
+*Last updated: {date}*

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "codecruise",
+  "version": "0.1.0",
+  "description": "Autonomous code execution on cruise control - A workflow system for Claude Code",
+  "author": "Mateeq Azam",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "codecruise": "./bin/codecruise.js"
+  },
+  "exports": {
+    ".": "./bin/codecruise.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "config/"
+  ],
+  "scripts": {
+    "prepublishOnly": "node --check bin/codecruise.js && node --check src/install.js"
+  },
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "coding-assistant",
+    "autonomous",
+    "tdd",
+    "workflow"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mateeqazam/codecruise.git"
+  },
+  "homepage": "https://github.com/mateeqazam/codecruise#readme",
+  "bugs": "https://github.com/mateeqazam/codecruise/issues",
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/install.js

@@ -0,0 +1,163 @@
+/**
+ * codecruise install - Copy config to ~/.claude/
+ */
+
+import { createInterface } from 'readline';
+import { existsSync, mkdirSync, cpSync, readdirSync, renameSync, statSync, chmodSync, rmSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+const CLAUDE_DIR = join(homedir(), '.claude');
+const CONFIG_SOURCE = join(__dirname, '..', 'config');
+
+function confirm(question) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(`${question} [y/N] `, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase() === 'y');
+    });
+  });
+}
+
+function checkClaudeCli() {
+  try {
+    execSync('claude --version', { stdio: 'pipe' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function hasContent(dir) {
+  if (!existsSync(dir)) return false;
+  try {
+    return readdirSync(dir).length > 0;
+  } catch {
+    return false;
+  }
+}
+
+function getBackupDirName() {
+  const timestamp = new Date().toISOString()
+    .replace(/[:.]/g, '-')
+    .replace('T', '_')
+    .slice(0, 19);
+  return `${CLAUDE_DIR}-backup-${timestamp}`;
+}
+
+function countFiles(dir) {
+  let count = 0;
+  for (const item of readdirSync(dir)) {
+    const fullPath = join(dir, item);
+    if (statSync(fullPath).isDirectory()) {
+      count += countFiles(fullPath);
+    } else {
+      count++;
+    }
+  }
+  return count;
+}
+
+function makeExecutable(dir) {
+  if (!existsSync(dir)) return;
+  for (const item of readdirSync(dir)) {
+    const fullPath = join(dir, item);
+    if (statSync(fullPath).isDirectory()) {
+      makeExecutable(fullPath);
+    } else if (item.endsWith('.sh')) {
+      chmodSync(fullPath, 0o755);
+    }
+  }
+}
+
+export async function runInstall() {
+  console.log(`
+╔═══════════════════════════════════════════════════════════╗
+║                  codecruise install                        ║
+╚═══════════════════════════════════════════════════════════╝
+`);
+
+  // Check Claude CLI
+  if (!checkClaudeCli()) {
+    console.log('✗ Claude CLI not found\n');
+    console.log('Install Claude CLI first:');
+    console.log('  npm install -g @anthropic-ai/claude-code\n');
+    process.exit(1);
+  }
+  console.log('✓ Claude CLI found\n');
+
+  // Backup if exists
+  let backupDir = null;
+  if (hasContent(CLAUDE_DIR)) {
+    console.log('~/.claude/ exists. This will replace it.');
+    console.log('Your existing config will be backed up.\n');
+
+    if (!await confirm('Continue?')) {
+      console.log('\nCancelled.');
+      process.exit(0);
+    }
+
+    backupDir = getBackupDirName();
+    renameSync(CLAUDE_DIR, backupDir);
+    console.log(`\n✓ Backed up to ${backupDir}\n`);
+  }
+
+  // Copy
+  if (!existsSync(CONFIG_SOURCE)) {
+    console.log(`✗ Config not found: ${CONFIG_SOURCE}`);
+    process.exit(1);
+  }
+
+  mkdirSync(CLAUDE_DIR, { recursive: true });
+
+  try {
+    cpSync(CONFIG_SOURCE, CLAUDE_DIR, { recursive: true });
+    makeExecutable(join(CLAUDE_DIR, 'hooks'));
+  } catch (err) {
+    console.error(`\n✗ Failed to copy config: ${err.message}`);
+
+    // Restore backup if we had one
+    if (backupDir && existsSync(backupDir)) {
+      console.log('Restoring backup...');
+      rmSync(CLAUDE_DIR, { recursive: true, force: true });
+      renameSync(backupDir, CLAUDE_DIR);
+      console.log('✓ Backup restored\n');
+    }
+
+    process.exit(1);
+  }
+
+  // Summary
+  console.log('Installed:\n');
+  for (const dir of ['commands', 'hooks', 'agents', 'rules', 'skills']) {
+    const dirPath = join(CLAUDE_DIR, dir);
+    if (existsSync(dirPath)) {
+      console.log(`  ✓ ${dir}/ (${countFiles(dirPath)} files)`);
+    }
+  }
+
+  console.log(`
+╔═══════════════════════════════════════════════════════════╗
+║                  ✓ Installed!                              ║
+╠═══════════════════════════════════════════════════════════╣
+║  Next:                                                     ║
+║    cd your-project                                         ║
+║    claude                                                  ║
+║    /init                                                   ║
+╚═══════════════════════════════════════════════════════════╝
+`);
+
+  if (backupDir) {
+    console.log(`Backup: ${backupDir}\n`);
+  }
+}