forge-dev-framework 1.0.1

package/README.md

@@ -0,0 +1,261 @@
+# FORGE
+
+> **Full Orchestration for Rapid Git Engineering**
+
+A multi-agent development framework for Claude Code Agent Teams that forges production-quality code through parallel specialization, adversarial verification, and bulletproof context engineering.
+
+[![npm version](https://badge.fury.io/js/forge-dev-framework.svg)](https://www.npmjs.com/package/forge-dev-framework)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- 🏗️ **Event-Sourced State Engine** — Append-only event log with single-writer merge
+- 🤖 **Multi-Agent Coordination** — Contract-first protocol for parallel execution
+- 📝 **Template-Based Artifacts** — Generate CLAUDE.md, REQUIREMENTS.md, ROADMAP.md
+- 🌳 **Git Worktree Isolation** — Parallel task execution without conflicts
+- ⚡ **Slash Commands** — Use `/forge:plan`, `/forge:execute` directly in Claude Code
+- 🎯 **5-6 Task Limit** — Enforced atomic task breakdown for optimal LLM performance
+
+## Installation
+
+### Global Installation (Recommended)
+
+```bash
+# Install globally via npm
+npm install -g forge-dev-framework
+
+# Commands are automatically installed to ~/.claude/commands/forge/
+# Available from any project in Claude Code
+```
+
+### Per-Project Installation
+
+```bash
+# Install in a specific project
+cd /path/to/your/project
+npm install forge-dev-framework
+
+# Commands installed to project .claude/commands/forge/
+# Available only in this project
+```
+
+### Development Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/Alzarak/forge.git
+cd forge
+
+# Install dependencies
+npm install
+
+# Build the project
+npm run build
+
+# Install commands (global mode)
+node dist/scripts/install.js --mode=global
+
+# Or install to current project (project mode)
+node dist/scripts/install.js --mode=project
+```
+
+## Quick Start
+
+### Using Slash Commands (Recommended)
+
+After installation, FORGE commands are available directly in Claude Code:
+
+```bash
+# Start a new FORGE project
+/forge:new-project my-app
+
+# Plan a phase
+/forge:discuss M2-planning-engine
+/forge:plan M2-planning-engine
+
+# Execute with agent teams
+/forge:execute M2-planning-engine
+
+# Check progress
+/forge:status
+```
+
+### Using CLI
+
+```bash
+# Initialize FORGE in current directory
+forge init
+
+# Show project status
+forge status
+
+# Generate artifacts
+forge generate requirements
+forge generate roadmap
+
+# View configuration
+forge config
+```
+
+## Available Commands
+
+| Command | Description | Milestone |
+|---------|-------------|-----------|
+| `/forge:new-project` | Initialize a new FORGE project | M1 ✅ |
+| `/forge:init` | Initialize FORGE in current directory | M1 ✅ |
+| `/forge:status` | Show project progress | M1 ✅ |
+| `/forge:config` | View/edit configuration | M1 ✅ |
+| `/forge:discuss` | Capture phase context | M2 🚧 |
+| `/forge:plan` | Generate task breakdown | M2 🚧 |
+| `/forge:verify` | Verify plan against requirements | M2 🚧 |
+| `/forge:execute` | Execute phase with agent teams | M3 📋 |
+| `/forge:generate` | Generate artifacts from templates | M1 ✅ |
+| `/forge:help` | Show command reference | M1 ✅ |
+
+Legend: ✅ Complete | 🚧 In Progress | 📋 Planned
+
+## Architecture
+
+### Event-Sourced State
+
+FORGE uses an append-only event log with single-writer state derivation:
+
+```
+All Agents → state/events/*.json (append-only)
+                        ↓
+              State Steward (single writer)
+                        ↓
+                  state/STATE.json (canonical)
+```
+
+### Contract-First Protocol
+
+Cross-domain work requires published contracts first:
+
+1. Agent needs interface from another domain
+2. Write `REQUEST_CONTRACT` event
+3. Provider publishes contract to `contracts/`
+4. Both agents work against agreed contract
+5. Integration happens at merge time
+
+### File Ownership Boundaries
+
+Each teammate writes only within their owned paths:
+
+| Role | Owned Paths |
+|---|---|
+| ARCHITECT | Root artifacts, `.claude/rules/`, `STATE.json` (single-writer) |
+| STATE-ENGINE | `STATE.schema.json`, event schemas, merge logic |
+| CLI-ENGINE | `src/cli/`, `src/commands/`, `bin/` |
+| TEMPLATES | `src/templates/`, `src/generators/` |
+| GIT-OPS | `src/git/`, `.github/` |
+
+### Wipe Protocol
+
+Agent context is ephemeral, git is persistent:
+
+1. **Hydrate** — Agent reads CLAUDE.md + STATE.json + task + contracts
+2. **Execute** — Agent writes code, runs tests
+3. **Commit** — Atomic git commit (one task = one commit)
+4. **Terminate** — Session ends, context wiped
+5. **Reincarnate** — Next task starts with fresh context
+
+## Configuration
+
+FORGE configuration is stored in `.planning/forge.config.json`:
+
+```json
+{
+  "mode": "interactive",
+  "depth": "standard",
+  "maxTeammates": 5,
+  "taskLimit": 6,
+  "conventionalCommits": true,
+  "worktreeIsolation": true
+}
+```
+
+### Available Settings
+
+| Key | Type | Default | Description |
+|-----|------|---------|-------------|
+| mode | enum | interactive | yolo, interactive, standard |
+| depth | enum | standard | quick, standard, comprehensive |
+| maxTeammates | int | 5 | Max agents per phase (2-10) |
+| taskLimit | int | 6 | Max tasks per phase (5-6 recommended) |
+| conventionalCommits | bool | true | Enforce commit format |
+| worktreeIsolation | bool | true | Use worktrees for tasks |
+
+## Development
+
+### Setup
+
+```bash
+# Clone repository
+git clone https://github.com/Alzarak/forge.git
+cd forge
+
+# Install dependencies
+npm install
+
+# Build project
+npm run build
+```
+
+### Scripts
+
+```bash
+npm run build          # Build TypeScript to dist/
+npm run dev            # Run CLI in development mode
+npm test              # Run tests
+npm run test:watch     # Run tests in watch mode
+npm run test:coverage  # Run tests with coverage
+```
+
+### Project Structure
+
+```
+forge/
+├── .claude/
+│   ├── commands/          # Slash command definitions
+│   └── rules/            # Scoped rules (api-patterns, etc.)
+├── src/
+│   ├── cli/              # CLI entry point
+│   ├── commands/         # Command implementations
+│   ├── generators/        # Template engine & XML generator
+│   ├── git/              # Git operations (worktrees, hooks)
+│   ├── types/            # TypeScript type definitions
+│   ├── utils/            # Utilities (logger, state-api, etc.)
+│   └── scripts/          # Installation scripts
+├── templates/            # Artifact templates
+├── bin/                 # Executable entry point
+├── state/              # State engine (events, STATE.json)
+└── contracts/          # API contracts
+```
+
+## Contributing
+
+Contributions are welcome! Please read [CLAUDE.md](./CLAUDE.md) for project patterns and conventions.
+
+### Development Workflow
+
+1. Make changes following FORGE patterns
+2. Run tests: `npm test`
+3. Build: `npm run build`
+4. Commit: `type(scope): description`
+5. Push: PR review required
+
+## License
+
+MIT © [Alzarak](https://github.com/Alzarak)
+
+## Links
+
+- **Documentation**: [CLAUDE.md](./CLAUDE.md)
+- **Requirements**: [REQUIREMENTS.md](./REQUIREMENTS.md)
+- **Roadmap**: [ROADMAP.md](./ROADMAP.md)
+- **Issues**: [GitHub Issues](https://github.com/Alzarak/forge/issues)
+
+---
+
+**Built with ❤️ by the FORGE Agent Team**

package/bin/forge.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+/**
+ * FORGE CLI Executable
+ * Entry point for the `forge` command
+ * This is the compiled version for npm distribution
+ */
+
+import { run } from './dist/cli/index.js';
+
+run().catch((error) => {
+  console.error('FORGE CLI crashed:', error);
+  process.exit(1);
+});

package/dist/bin/forge.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+
+/**
+ * FORGE CLI Executable
+ * Entry point for the `forge` command
+ * This is the compiled version for npm distribution
+ */
+
+import { run } from './dist/cli/index.js';
+
+run().catch((error) => {
+  console.error('FORGE CLI crashed:', error);
+  process.exit(1);
+});

package/dist/cli/index.d.ts

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+/**
+ * FORGE CLI Entry Point
+ * Main command dispatcher and initialization
+ */
+declare class ForgeCLI {
+    private program;
+    private logger;
+    constructor();
+    private setup;
+    private registerCommands;
+    /**
+     * Display banner (shown on first run or when explicitly requested)
+     */
+    showBanner(): void;
+    /**
+     * Parse and execute CLI arguments
+     */
+    run(argv?: string[]): Promise<void>;
+}
+export { ForgeCLI };
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;GAGG;AAoBH,cAAM,QAAQ;IACZ,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAS;;IAQvB,OAAO,CAAC,KAAK;IAqBb,OAAO,CAAC,gBAAgB;IA6BxB;;OAEG;IACH,UAAU,IAAI,IAAI;IAalB;;OAEG;IACG,GAAG,CAAC,IAAI,GAAE,MAAM,EAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;CAoBxD;AAQD,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+/**
+ * FORGE CLI Entry Point
+ * Main command dispatcher and initialization
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import figlet from 'figlet';
+import path from 'path';
+import { fileURLToPath } from 'url';
+// Import commands
+import { HelpCommand } from '../commands/help.js';
+import { StatusCommand } from '../commands/status.js';
+import { ConfigCommand } from '../commands/config.js';
+import { InitCommand } from '../commands/init.js';
+import { GenerateCommand } from '../commands/generate.js';
+import { createStubCommand } from '../commands/stubs.js';
+import { Logger } from '../utils/logger.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+class ForgeCLI {
+    program;
+    logger;
+    constructor() {
+        this.program = new Command();
+        this.logger = new Logger();
+        this.setup();
+    }
+    setup() {
+        // Program metadata
+        this.program
+            .name('forge')
+            .description('Full Orchestration for Rapid Git Engineering')
+            .version('1.0.0')
+            .option('-q, --quiet', 'Suppress non-error output')
+            .option('-v, --verbose', 'Enable verbose output')
+            .option('--debug', 'Enable debug mode');
+        // Register all commands
+        this.registerCommands();
+        // Handle unknown commands
+        this.program.on('command:*', (operands) => {
+            this.logger.error(`Unknown command: ${operands[0]}`);
+            this.logger.info('Run "forge help" to see available commands.');
+            process.exit(1);
+        });
+    }
+    registerCommands() {
+        // Core commands
+        new InitCommand(this.program).register();
+        new StatusCommand(this.program).register();
+        new ConfigCommand(this.program).register();
+        new GenerateCommand(this.program).register();
+        new HelpCommand(this.program).register();
+        // Stub commands for future milestones
+        createStubCommand('scan', 'Map existing codebase (brownfield projects)')(this.program);
+        createStubCommand('discuss <phase>', 'Shape implementation decisions before planning')(this.program);
+        createStubCommand('plan <phase>', 'Research-backed atomic task plans')(this.program);
+        createStubCommand('deploy <phase>', 'Spawn parallel specialists, execute tasks')(this.program);
+        createStubCommand('tribunal <phase>', 'Adversarial security + QA review')(this.program);
+        createStubCommand('verify <phase>', 'Human acceptance testing walkthrough')(this.program);
+        createStubCommand('ship', 'Archive milestone, tag release')(this.program);
+        createStubCommand('next', 'Start next milestone')(this.program);
+        createStubCommand('graph', 'Render Mermaid dependency graph')(this.program);
+        createStubCommand('events', 'Stream recent state events')(this.program);
+        createStubCommand('quick', 'Ad-hoc tasks with FORGE guarantees')(this.program);
+        createStubCommand('debug <desc>', 'Spawn debug agents')(this.program);
+        createStubCommand('add-phase', 'Add a phase to current milestone')(this.program);
+        createStubCommand('insert-phase <N>', 'Insert a phase at position N')(this.program);
+        createStubCommand('remove-phase <N>', 'Remove phase N')(this.program);
+        createStubCommand('replan <phase>', 'Re-research and re-plan a phase')(this.program);
+        createStubCommand('pause', 'Persist state, safe to close terminal')(this.program);
+        createStubCommand('resume', 'Hydrate from saved state')(this.program);
+    }
+    /**
+     * Display banner (shown on first run or when explicitly requested)
+     */
+    showBanner() {
+        console.log(chalk.cyan(figlet.textSync('FORGE', {
+            font: 'Standard',
+            horizontalLayout: 'default',
+            verticalLayout: 'default',
+        })));
+        console.log(chalk.gray('Full Orchestration for Rapid Git Engineering\n'));
+    }
+    /**
+     * Parse and execute CLI arguments
+     */
+    async run(argv = process.argv) {
+        try {
+            // Show banner if no args or --help
+            if (argv.length <= 2 || argv.includes('--help')) {
+                this.showBanner();
+            }
+            await this.program.parseAsync(argv);
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.logger.error(error.message);
+                if (process.env.DEBUG) {
+                    console.error(error.stack);
+                }
+            }
+            else {
+                this.logger.error('An unknown error occurred');
+            }
+            process.exit(1);
+        }
+    }
+}
+// Entry point
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const cli = new ForgeCLI();
+    cli.run();
+}
+export { ForgeCLI };
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/base.d.ts

@@ -0,0 +1,31 @@
+import { Command } from 'commander';
+import { ForgeConfig } from '../types/config.js';
+import { Logger } from '../utils/logger.js';
+/**
+ * Base class for all FORGE commands
+ * Provides common utilities and configuration access
+ */
+export declare abstract class ForgeCommand {
+    protected program: Command;
+    protected logger: Logger;
+    protected config: ForgeConfig | null;
+    constructor(program: Command);
+    /**
+     * Initialize the command - load config, validate environment
+     */
+    protected init(options?: any): void;
+    /**
+     * Execute the command logic
+     * Must be implemented by subclasses
+     */
+    abstract execute(...args: any[]): Promise<void> | void;
+    /**
+     * Register this command with the CLI program
+     */
+    abstract register(): void;
+    /**
+     * Check if we're in a FORGE project
+     */
+    protected checkForgeProject(projectRoot?: string): boolean;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/commands/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/commands/base.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAI5C;;;GAGG;AACH,8BAAsB,YAAY;IAIpB,SAAS,CAAC,OAAO,EAAE,OAAO;IAHtC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAAQ;gBAEtB,OAAO,EAAE,OAAO;IAItC;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,GAAG,GAAG,IAAI;IAKnC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAEtD;;OAEG;IACH,QAAQ,CAAC,QAAQ,IAAI,IAAI;IAEzB;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO;CAI1E"}

package/dist/commands/base.js

@@ -0,0 +1,31 @@
+import { Logger } from '../utils/logger.js';
+import fs from 'fs';
+import path from 'path';
+/**
+ * Base class for all FORGE commands
+ * Provides common utilities and configuration access
+ */
+export class ForgeCommand {
+    program;
+    logger;
+    config = null;
+    constructor(program) {
+        this.program = program;
+        this.logger = new Logger();
+    }
+    /**
+     * Initialize the command - load config, validate environment
+     */
+    init(options) {
+        // Load configuration if needed
+        // Base implementation - subclasses can override
+    }
+    /**
+     * Check if we're in a FORGE project
+     */
+    checkForgeProject(projectRoot = process.cwd()) {
+        const configPath = path.join(projectRoot, '.planning/forge.config.json');
+        return fs.existsSync(configPath);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/commands/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/commands/base.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;GAGG;AACH,MAAM,OAAgB,YAAY;IAIV;IAHZ,MAAM,CAAS;IACf,MAAM,GAAuB,IAAI,CAAC;IAE5C,YAAsB,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACO,IAAI,CAAC,OAAa;QAC1B,+BAA+B;QAC/B,gDAAgD;IAClD,CAAC;IAaD;;OAEG;IACO,iBAAiB,CAAC,cAAsB,OAAO,CAAC,GAAG,EAAE;QAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,6BAA6B,CAAC,CAAC;QACzE,OAAO,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/commands/config.d.ts

@@ -0,0 +1,14 @@
+import { ForgeCommand } from './base.js';
+/**
+ * Config Command - View and edit FORGE configuration
+ */
+export declare class ConfigCommand extends ForgeCommand {
+    register(): void;
+    execute(options: any): Promise<void>;
+    private setConfigValue;
+    private getConfigValue;
+    private displayConfig;
+    private displaySection;
+    private runInteractiveEditor;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/commands/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAQzC;;GAEG;AACH,qBAAa,aAAc,SAAQ,YAAY;IAC7C,QAAQ,IAAI,IAAI;IAUV,OAAO,CAAC,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;YAoB5B,cAAc;IA2C5B,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,cAAc;YAOR,oBAAoB;CA0DnC"}