forge-dev-framework 1.1.0 → 1.2.0

package/dist/commands/convert.js

@@ -0,0 +1,132 @@
+import { ForgeCommand } from './base.js';
+import { convertGSDToForge, detectGSDProject } from '../generators/gsd-converter.js';
+import path from 'path';
+import chalk from 'chalk';
+export class ConvertCommand extends ForgeCommand {
+    register() {
+        this.program
+            .command('convert')
+            .description('Convert GSD project to FORGE format')
+            .option('-d, --dry-run', 'Preview changes without modifying files')
+            .option('-v, --verbose', 'Show detailed conversion output')
+            .option('-f, --force', 'Force conversion even if FORGE files exist')
+            .action((options) => this.execute(options));
+    }
+    async execute(options) {
+        const projectPath = process.cwd();
+        this.logger.header('FORGE — GSD to FORGE Converter');
+        // Detect GSD project
+        this.logger.info('Detecting GSD project...');
+        const gsdInfo = await detectGSDProject(projectPath);
+        if (!gsdInfo.hasProjectMd && !gsdInfo.hasPlanningDir) {
+            this.logger.error('Not a GSD project');
+            this.logger.info('Expected: PROJECT.md or .planning/ directory');
+            this.logger.info('Use "forge init" to initialize a new FORGE project.');
+            return;
+        }
+        // Show detected project info
+        this.logger.success('Found GSD project');
+        console.log();
+        console.log(chalk.cyan('  Project Information:'));
+        console.log(`    Name: ${gsdInfo.name || path.basename(projectPath)}`);
+        console.log(`    PROJECT.md: ${gsdInfo.hasProjectMd ? chalk.green('✓') : chalk.red('✗')}`);
+        console.log(`    ROADMAP.md: ${gsdInfo.hasRoadmapMd ? chalk.green('✓') : chalk.red('✗')}`);
+        console.log(`    .planning/: ${gsdInfo.hasPlanningDir ? chalk.green('✓') : chalk.red('✗')}`);
+        if (gsdInfo.phases.length > 0) {
+            console.log(`    Phases: ${gsdInfo.phases.length} found`);
+        }
+        console.log();
+        // Check for existing FORGE files
+        const hasClaudeMd = gsdInfo.hasProjectMd; // Will be overwritten
+        const hasStateDir = true; // Will create it
+        if (!options.force && hasClaudeMd) {
+            // Check if it's already a FORGE project
+            const { readFile } = await import('fs/promises');
+            try {
+                const claudeMdPath = path.join(projectPath, 'CLAUDE.md');
+                const content = await readFile(claudeMdPath, 'utf-8');
+                if (content.includes('FORGE')) {
+                    this.logger.warning('This appears to already be a FORGE project');
+                    this.logger.info('Use --force to overwrite existing FORGE files.');
+                    return;
+                }
+            }
+            catch {
+                // CLAUDE.md doesn't exist yet
+            }
+        }
+        // Dry run mode
+        if (options.dryRun) {
+            this.logger.info('Dry run mode — no files will be modified');
+            console.log();
+            const result = await convertGSDToForge(projectPath, {
+                dryRun: true,
+                verbose: options.verbose,
+            });
+            if (result.success) {
+                this.logger.success(result.message);
+                if (result.warnings.length > 0) {
+                    console.log();
+                    this.logger.warning('Warnings:');
+                    result.warnings.forEach((w) => console.log(chalk.yellow(`  ⚠ ${w}`)));
+                }
+            }
+            else {
+                this.logger.error(result.message);
+            }
+            return;
+        }
+        // Confirm conversion
+        if (process.stdout.isTTY) {
+            const inquirer = await import('inquirer');
+            const { confirm } = await inquirer.default.prompt([
+                {
+                    type: 'confirm',
+                    name: 'confirm',
+                    message: 'Convert this GSD project to FORGE?',
+                    default: true,
+                },
+            ]);
+            if (!confirm) {
+                this.logger.info('Conversion cancelled.');
+                return;
+            }
+        }
+        // Perform conversion
+        this.logger.info('Converting GSD project to FORGE...');
+        console.log();
+        const result = await convertGSDToForge(projectPath, {
+            dryRun: false,
+            verbose: options.verbose,
+        });
+        if (result.success) {
+            this.logger.success(result.message);
+            console.log();
+            if (result.filesCreated.length > 0) {
+                console.log(chalk.cyan('Files created:'));
+                result.filesCreated.forEach((file) => {
+                    const relPath = path.relative(projectPath, file);
+                    console.log(chalk.green(`  ✓ ${relPath}`));
+                });
+                console.log();
+            }
+            if (result.warnings.length > 0) {
+                this.logger.warning('Warnings:');
+                result.warnings.forEach((w) => console.log(chalk.yellow(`  ⚠ ${w}`)));
+                console.log();
+            }
+            // Next steps
+            console.log(chalk.cyan('Next steps:'));
+            console.log(`  ${chalk.dim('1.')} Review the generated CLAUDE.md`);
+            console.log(`  ${chalk.dim('2.')} Run ${chalk.cyan('/forge:status')} to verify the conversion`);
+            console.log(`  ${chalk.dim('3.')} Run ${chalk.cyan('/forge:plan <phase-number>')} to create detailed task plans`);
+            console.log(`  ${chalk.dim('Tip:')} Use ${chalk.cyan('/clear')} to start from a fresh context`);
+            console.log();
+        }
+        else {
+            this.logger.error(result.message);
+            process.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=convert.js.map

package/dist/commands/convert.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAMzC;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,IAAI,IAAI;IASV,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAyF5D;;OAEG;YACW,WAAW;IA4CzB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAajB"}
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/commands/generate.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAMzC;;GAEG;AACH,qBAAa,eAAgB,SAAQ,YAAY;IAC/C,QAAQ,IAAI,IAAI;IASV,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IA6F5D;;OAEG;YACW,WAAW;IA4CzB;;OAEG;IACH,OAAO,CAAC,QAAQ;CAajB"}

package/dist/commands/generate.js

@@ -61,8 +61,9 @@ export class GenerateCommand extends ForgeCommand {
                 logger.info('Available artifacts: claude, project, requirements, roadmap, plan, config, rules');
                 process.exit(1);
             }
-            // Check if template exists
-            const templatePath = path.join(projectRoot, 'src/templates', target.template);
+            // Check if template exists — look in package install dir first, then project
+            const packageTemplatesDir = path.resolve(path.dirname(new URL(import.meta.url).pathname), '..', 'templates');
+            const templatePath = path.join(packageTemplatesDir, target.template);
             const fs = await import('fs/promises');
             try {
                 await fs.access(templatePath);

package/dist/commands/generate.js.map

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

package/dist/commands/index.d.ts

@@ -1,8 +1,8 @@
 /**
  * FORGE Command Exports
  */
-export * from './base';
-export * from './help';
-export * from './status';
-export * from './config';
+export * from './base.js';
+export * from './help.js';
+export * from './status.js';
+export * from './config.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/commands/index.js

@@ -1,8 +1,8 @@
 /**
  * FORGE Command Exports
  */
-export * from './base';
-export * from './help';
-export * from './status';
-export * from './config';
+export * from './base.js';
+export * from './help.js';
+export * from './status.js';
+export * from './config.js';
 //# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,QAAQ,CAAC;AACvB,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC"}

package/dist/generators/gsd-converter.d.ts

@@ -0,0 +1,100 @@
+/**
+ * GSD to FORGE Project Converter
+ *
+ * Converts existing GSD projects to FORGE format by:
+ * 1. Reading GSD artifacts (PROJECT.md, ROADMAP.md, phase plans)
+ * 2. Creating FORGE equivalents (CLAUDE.md, STATE.json)
+ * 3. Preserving roadmap and phase structure
+ *
+ * @private - Not published to NPM
+ */
+interface LocalTask {
+    id: string;
+    title: string;
+    ownerRole: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'blocked';
+    deps: string[];
+    allowedPaths: string[];
+    acceptance: string[];
+    verify: string[];
+    commit: string | null;
+    requests: string[];
+    priority: number;
+    blockedBy: string[];
+    blocks: string[];
+    assignedTo: string | null;
+    createdAt: string;
+    startedAt: string | null;
+    completedAt: string | null;
+}
+interface LocalProjectState {
+    name: string;
+    status: string;
+    currentMilestone: string;
+    currentPhase: number;
+    updatedAt: string;
+}
+interface LocalForgeState {
+    project: LocalProjectState;
+    tasks: LocalTask[];
+    contracts: Array<{
+        id: string;
+        path: string;
+        version: string;
+        publishedBy: string;
+        consumers: string[];
+        publishedAt?: string;
+        status?: string;
+    }>;
+    eventsPointer: string;
+}
+export interface GSDProjectInfo {
+    name: string;
+    hasProjectMd: boolean;
+    hasRoadmapMd: boolean;
+    hasPlanningDir: boolean;
+    phases: string[];
+}
+export interface ConversionResult {
+    success: boolean;
+    message: string;
+    filesCreated: string[];
+    warnings: string[];
+}
+/**
+ * Detect if current directory is a GSD project
+ */
+export declare function detectGSDProject(projectPath: string): Promise<GSDProjectInfo>;
+/**
+ * Extract project metadata from PROJECT.md
+ */
+export declare function extractProjectMetadata(projectPath: string): Promise<{
+    name: string;
+    description?: string;
+    techStack?: string[];
+    team?: string[];
+}>;
+/**
+ * Generate CLAUDE.md from PROJECT.md content
+ */
+export declare function generateClaudeMd(projectPath: string): Promise<string>;
+/**
+ * Extract tasks from GSD phase plans and convert to FORGE tasks
+ */
+export declare function extractTasksFromPhases(projectPath: string): Promise<{
+    currentMilestone: string;
+    tasks: LocalTask[];
+}>;
+/**
+ * Create initial STATE.json for FORGE project
+ */
+export declare function createForgeState(projectName: string, tasks: LocalTask[]): Promise<LocalForgeState>;
+/**
+ * Main conversion function
+ */
+export declare function convertGSDToForge(projectPath: string, options?: {
+    dryRun?: boolean;
+    verbose?: boolean;
+}): Promise<ConversionResult>;
+export {};
+//# sourceMappingURL=gsd-converter.d.ts.map

package/dist/generators/gsd-converter.d.ts.map

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

package/dist/generators/gsd-converter.js

@@ -0,0 +1,335 @@
+/**
+ * GSD to FORGE Project Converter
+ *
+ * Converts existing GSD projects to FORGE format by:
+ * 1. Reading GSD artifacts (PROJECT.md, ROADMAP.md, phase plans)
+ * 2. Creating FORGE equivalents (CLAUDE.md, STATE.json)
+ * 3. Preserving roadmap and phase structure
+ *
+ * @private - Not published to NPM
+ */
+import { readFile, writeFile, mkdir, access, readdir } from 'fs/promises';
+import { join, dirname } from 'path';
+import { existsSync } from 'fs';
+/**
+ * Detect if current directory is a GSD project
+ */
+export async function detectGSDProject(projectPath) {
+    const projectMdPath = join(projectPath, 'PROJECT.md');
+    const roadmapMdPath = join(projectPath, 'ROADMAP.md');
+    const planningDir = join(projectPath, '.planning');
+    const info = {
+        name: '',
+        hasProjectMd: false,
+        hasRoadmapMd: false,
+        hasPlanningDir: false,
+        phases: [],
+    };
+    // Check for PROJECT.md
+    try {
+        await access(projectMdPath);
+        info.hasProjectMd = true;
+        const content = await readFile(projectMdPath, 'utf-8');
+        // Extract project name from first line or title
+        const nameMatch = content.match(/^#\s+(.+)$/m) || content.match(/^# Project: (.+)$/m);
+        if (nameMatch) {
+            info.name = nameMatch[1].trim();
+        }
+    }
+    catch {
+        // PROJECT.md doesn't exist
+    }
+    // Check for ROADMAP.md
+    try {
+        await access(roadmapMdPath);
+        info.hasRoadmapMd = true;
+    }
+    catch {
+        // ROADMAP.md doesn't exist
+    }
+    // Check for .planning directory and phases
+    try {
+        await access(planningDir);
+        info.hasPlanningDir = true;
+        // List phases
+        const phasesDir = join(planningDir, 'phases');
+        try {
+            await access(phasesDir);
+            const entries = await readdir(phasesDir, { withFileTypes: true });
+            info.phases = entries
+                .filter((e) => e.name.endsWith('.md') || e.isDirectory())
+                .map((e) => e.name)
+                .sort();
+        }
+        catch {
+            // phases directory doesn't exist
+        }
+    }
+    catch {
+        // .planning directory doesn't exist
+    }
+    return info;
+}
+/**
+ * Extract project metadata from PROJECT.md
+ */
+export async function extractProjectMetadata(projectPath) {
+    const projectMdPath = join(projectPath, 'PROJECT.md');
+    const metadata = {
+        name: '',
+        description: '',
+        techStack: [],
+        team: [],
+    };
+    try {
+        const content = await readFile(projectMdPath, 'utf-8');
+        // Extract name from title
+        const nameMatch = content.match(/^#\s+(.+)$/m);
+        if (nameMatch) {
+            metadata.name = nameMatch[1].trim();
+        }
+        // Extract description (usually after title)
+        const descMatch = content.match(/^#\s+.+\n+(.+)$/m);
+        if (descMatch) {
+            metadata.description = descMatch[1].trim();
+        }
+        // Extract tech stack (looks for "Tech Stack" or similar section)
+        const techStackMatch = content.match(/##?\s*(?:Tech Stack|Technology Stack|Stack)\n+([\s\S]+?)(?=\n##|\n*$)/i);
+        if (techStackMatch) {
+            const techLines = techStackMatch[1]
+                .split('\n')
+                .map((line) => line.replace(/^[\s\-\*]+/, '').trim())
+                .filter((line) => line.length > 0);
+            metadata.techStack = techLines;
+        }
+    }
+    catch (error) {
+        // PROJECT.md doesn't exist or couldn't be read
+    }
+    return metadata;
+}
+/**
+ * Generate CLAUDE.md from PROJECT.md content
+ */
+export async function generateClaudeMd(projectPath) {
+    const projectMdPath = join(projectPath, 'PROJECT.md');
+    let projectMdContent = '';
+    try {
+        projectMdContent = await readFile(projectMdPath, 'utf-8');
+    }
+    catch {
+        // PROJECT.md doesn't exist, use template
+    }
+    const metadata = await extractProjectMetadata(projectPath);
+    // Build CLAUDE.md content
+    let claudeMd = `# ${metadata.name || 'FORGE Project'}\n\n`;
+    claudeMd += `> **Converted from GSD.** This project was migrated from GSD to FORGE.\n`;
+    claudeMd += `> Conversion date: ${new Date().toISOString()}\n\n`;
+    // Add tech stack if available
+    if (metadata.techStack && metadata.techStack.length > 0) {
+        claudeMd += `## Tech Stack\n\n`;
+        metadata.techStack.forEach((tech) => {
+            claudeMd += `- ${tech}\n`;
+        });
+        claudeMd += `\n`;
+    }
+    // Add FORGE-specific sections
+    claudeMd += `## Core Architecture\n\n`;
+    claudeMd += `### Event-Sourced State\n\n`;
+    claudeMd += `FORGE uses an **append-only event log** with **single-writer state derivation**:\n\n`;
+    claudeMd += `1. All agents write events to \`state/events/\`\n`;
+    claudeMd += `2. State Steward (ARCHITECT) merges events → canonical \`STATE.json\`\n`;
+    claudeMd += `3. Events are **never modified**, only appended\n`;
+    claudeMd += `4. State is **deterministically replayable** from event log\n\n`;
+    claudeMd += `### Command System\n\n`;
+    claudeMd += `FORGE provides slash commands for Claude Code:\n\n`;
+    claudeMd += `\`\`\`\n`;
+    claudeMd += `/forge:new-project    # Initialize new FORGE project\n`;
+    claudeMd += `/forge:init          # Initialize FORGE in current directory\n`;
+    claudeMd += `/forge:status        # Show project progress\n`;
+    claudeMd += `/forge:config        # View/edit configuration\n`;
+    claudeMd += `/forge:discuss       # Capture phase context\n`;
+    claudeMd += `/forge:plan          # Generate task breakdown\n`;
+    claudeMd += `/forge:verify        # Verify plan against requirements\n`;
+    claudeMd += `/forge:execute       # Execute phase with agent teams\n`;
+    claudeMd += `/forge:generate      # Generate artifact from template\n`;
+    claudeMd += `/forge:help          # Show command reference\n`;
+    claudeMd += `\`\`\`\n\n`;
+    claudeMd += `### The Wipe Protocol\n\n`;
+    claudeMd += `Agent context is **ephemeral**, git is **persistent**:\n\n`;
+    claudeMd += `1. **Hydrate** — Agent reads CLAUDE.md + STATE.json + task + contracts\n`;
+    claudeMd += `2. **Execute** — Agent writes code, runs tests\n`;
+    claudeMd += `3. **Commit** — Atomic git commit (one task = one commit)\n`;
+    claudeMd += `4. **Terminate** — Session ends, context wiped\n`;
+    claudeMd += `5. **Reincarnate** — Next task starts with fresh context\n\n`;
+    claudeMd += `## Hard Rules\n\n`;
+    claudeMd += `### 5-6 Task Limit\n\n`;
+    claudeMd += `Each teammate gets **maximum 6 atomic tasks per phase**.\n\n`;
+    claudeMd += `### Atomic Commits\n\n`;
+    claudeMd += `**Every task = one git commit.** No exceptions.\n\n`;
+    claudeMd += `Commit format: \`type(scope): description\`\n\n`;
+    // Include original PROJECT.md content as appendix
+    if (projectMdContent) {
+        claudeMd += `\n---\n\n## Original GSD Content\n\n`;
+        claudeMd += `The following content was preserved from the original GSD PROJECT.md:\n\n`;
+        claudeMd += projectMdContent;
+    }
+    return claudeMd;
+}
+/**
+ * Extract tasks from GSD phase plans and convert to FORGE tasks
+ */
+export async function extractTasksFromPhases(projectPath) {
+    const phasesDir = join(projectPath, '.planning', 'phases');
+    const tasks = [];
+    let currentMilestone = 'v1.0-M1';
+    let taskId = 1;
+    try {
+        await access(phasesDir);
+        const entries = await readdir(phasesDir, { withFileTypes: true });
+        for (const entry of entries.filter((e) => e.isFile())) {
+            const phasePath = join(phasesDir, entry.name);
+            const phaseContent = await readFile(phasePath, 'utf-8');
+            // Extract tasks from phase plan
+            // GSD phase plans typically have tasks as list items or under "Tasks" section
+            const taskMatches = phaseContent.matchAll(/^[\s]*(?:[-*+]|\d+\.)\s+\[?\[?(?:task|Task)?\]?\]?\s*(.+?)(?:\s+\[([^\]]+)\])?$/gm);
+            for (const match of taskMatches) {
+                const taskTitle = match[1]?.trim() || '';
+                const taskOwner = match[2]?.trim() || 'unassigned';
+                if (taskTitle.length > 0 && !taskTitle.toLowerCase().includes('optional')) {
+                    tasks.push({
+                        id: `task-${String(taskId).padStart(3, '0')}`,
+                        title: taskTitle,
+                        ownerRole: taskOwner,
+                        status: 'pending',
+                        deps: [],
+                        allowedPaths: [],
+                        acceptance: [],
+                        verify: [],
+                        commit: null,
+                        requests: [],
+                        priority: 5,
+                        blockedBy: [],
+                        blocks: [],
+                        assignedTo: null,
+                        createdAt: new Date().toISOString(),
+                        startedAt: null,
+                        completedAt: null,
+                    });
+                    taskId++;
+                }
+            }
+        }
+    }
+    catch {
+        // No phases directory or couldn't read
+    }
+    return { currentMilestone, tasks };
+}
+/**
+ * Create initial STATE.json for FORGE project
+ */
+export async function createForgeState(projectName, tasks) {
+    const projectState = {
+        name: projectName,
+        status: 'in_progress',
+        currentMilestone: 'v1.0-M1',
+        currentPhase: 1,
+        updatedAt: new Date().toISOString(),
+    };
+    return {
+        project: projectState,
+        tasks,
+        contracts: [],
+        eventsPointer: 'state/events/',
+    };
+}
+/**
+ * Main conversion function
+ */
+export async function convertGSDToForge(projectPath, options = {}) {
+    const result = {
+        success: false,
+        message: '',
+        filesCreated: [],
+        warnings: [],
+    };
+    const log = (msg) => {
+        if (options.verbose) {
+            console.log(`[convert] ${msg}`);
+        }
+    };
+    // Detect GSD project
+    log('Detecting GSD project...');
+    const gsdInfo = await detectGSDProject(projectPath);
+    if (!gsdInfo.hasProjectMd && !gsdInfo.hasPlanningDir) {
+        result.message = 'Not a GSD project: No PROJECT.md or .planning/ directory found.';
+        return result;
+    }
+    log(`Found GSD project: ${gsdInfo.name || projectPath}`);
+    log(`  - PROJECT.md: ${gsdInfo.hasProjectMd}`);
+    log(`  - ROADMAP.md: ${gsdInfo.hasRoadmapMd}`);
+    log(`  - Phases: ${gsdInfo.phases.length}`);
+    if (options.dryRun) {
+        result.success = true;
+        result.message = 'Dry run completed. No files modified.';
+        return result;
+    }
+    // Create FORGE directory structure
+    const stateDir = join(projectPath, 'state');
+    const eventsDir = join(stateDir, 'events');
+    const contractsDir = join(projectPath, 'contracts');
+    const claudeRulesDir = join(projectPath, '.claude', 'rules');
+    for (const dir of [stateDir, eventsDir, contractsDir, claudeRulesDir]) {
+        if (!existsSync(dir)) {
+            await mkdir(dir, { recursive: true });
+            result.filesCreated.push(dir);
+            log(`Created directory: ${dir}`);
+        }
+    }
+    // Generate CLAUDE.md
+    log('Generating CLAUDE.md...');
+    const claudeMd = await generateClaudeMd(projectPath);
+    const claudeMdPath = join(projectPath, 'CLAUDE.md');
+    await writeFile(claudeMdPath, claudeMd, 'utf-8');
+    result.filesCreated.push(claudeMdPath);
+    log(`Created: ${claudeMdPath}`);
+    // Extract tasks and create STATE.json
+    log('Extracting tasks from phase plans...');
+    const { currentMilestone, tasks } = await extractTasksFromPhases(projectPath);
+    const projectName = gsdInfo.name || 'Forge Project';
+    log(`Extracted ${tasks.length} tasks from ${gsdInfo.phases.length} phase plans`);
+    const forgeState = await createForgeState(projectName, tasks);
+    const stateJsonPath = join(stateDir, 'STATE.json');
+    await writeFile(stateJsonPath, JSON.stringify(forgeState, null, 2), 'utf-8');
+    result.filesCreated.push(stateJsonPath);
+    log(`Created: ${stateJsonPath}`);
+    // Create forge.config.json
+    log('Creating forge.config.json...');
+    const config = {
+        mode: 'interactive',
+        depth: 'standard',
+        maxTeammates: 5,
+        taskLimit: 6,
+        conventionalCommits: true,
+        worktreeIsolation: true,
+        convertedFrom: 'GSD',
+        convertedAt: new Date().toISOString(),
+    };
+    const configPath = join(projectPath, '.planning', 'forge.config.json');
+    await mkdir(dirname(configPath), { recursive: true });
+    await writeFile(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    result.filesCreated.push(configPath);
+    log(`Created: ${configPath}`);
+    // Warnings
+    if (!gsdInfo.hasRoadmapMd) {
+        result.warnings.push('No ROADMAP.md found. You may need to create one manually.');
+    }
+    if (tasks.length === 0) {
+        result.warnings.push('No tasks found in phase plans. You may need to run `forge plan <phase>` to create tasks.');
+    }
+    result.success = true;
+    result.message = `Successfully converted GSD project to FORGE. Created ${result.filesCreated.length} files.`;
+    return result;
+}
+//# sourceMappingURL=gsd-converter.js.map