forge-dev-framework 1.0.1

package/dist/git/worktree.js

@@ -0,0 +1,202 @@
+/**
+ * Git Worktree Management for FORGE
+ *
+ * Implements isolated worktree strategy for parallel agent execution.
+ * Each task gets its own worktree to prevent merge conflicts during development.
+ *
+ * Commands (from FORGE spec):
+ * - git worktree add .worktrees/{taskId} -b forge/{taskId}
+ * - git worktree remove .worktrees/{taskId}
+ */
+import { execa } from "execa";
+export class WorktreeError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "WorktreeError";
+    }
+}
+/**
+ * Create a new git worktree for a task.
+ *
+ * Creates a branch `forge/{taskId}` and checks it out into `.worktrees/{taskId}`.
+ * This gives each agent an isolated filesystem to work in.
+ *
+ * @param options - Task identification and branch configuration
+ * @returns Path to the new worktree
+ * @throws WorktreeError if worktree creation fails
+ */
+export async function createWorktree(options) {
+    const { taskId, branchName = `forge/${taskId}`, baseBranch = "main" } = options;
+    const worktreePath = `.worktrees/${taskId}`;
+    try {
+        // Create the .worktrees directory if it doesn't exist
+        await execa("mkdir", ["-p", ".worktrees"]);
+        // Create the worktree with a new branch
+        await execa("git", ["worktree", "add", "-b", branchName, worktreePath, baseBranch]);
+        return worktreePath;
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new WorktreeError(`Failed to create worktree for task ${taskId}: ${error.message}`, error.code);
+        }
+        throw new WorktreeError(`Failed to create worktree for task ${taskId}`);
+    }
+}
+/**
+ * Get information about a worktree.
+ *
+ * @param taskId - Task ID to look up
+ * @returns Worktree information or null if not found
+ */
+export async function getWorktree(taskId) {
+    try {
+        const { stdout } = await execa("git", ["worktree", "list", "--porcelain"]);
+        const lines = stdout.split("\n");
+        let currentPath = null;
+        let currentBranch = null;
+        let currentCommit = null;
+        for (const line of lines) {
+            if (line.startsWith("worktree ")) {
+                // Check if this is our target worktree
+                const path = line.slice("worktree ".length);
+                if (path.endsWith(`.worktrees/${taskId}`) || path.endsWith(`.worktrees/${taskId}/`)) {
+                    currentPath = path;
+                }
+            }
+            else if (currentPath && line.startsWith("branch ")) {
+                currentBranch = line.slice("branch ".length).replace("refs/heads/", "");
+            }
+            else if (currentPath && line.startsWith("commit ")) {
+                currentCommit = line.slice("commit ".length);
+            }
+            else if (line === "") {
+                // End of a worktree block
+                if (currentPath && currentBranch && currentCommit) {
+                    return {
+                        taskId,
+                        branchName: currentBranch,
+                        path: currentPath,
+                        commit: currentCommit,
+                    };
+                }
+                // Reset
+                currentPath = null;
+                currentBranch = null;
+                currentCommit = null;
+            }
+        }
+        return null;
+    }
+    catch (error) {
+        throw new WorktreeError(`Failed to get worktree info for task ${taskId}`);
+    }
+}
+/**
+ * Merge a worktree's branch back into the base branch.
+ *
+ * Should only be called after CI passes. The worktree is removed after merge.
+ *
+ * @param taskId - Task ID whose branch to merge
+ * @param targetBranch - Branch to merge into (default: main)
+ * @throws WorktreeError if merge fails or has conflicts
+ */
+export async function mergeWorktree(taskId, targetBranch = "main") {
+    const worktree = await getWorktree(taskId);
+    if (!worktree) {
+        throw new WorktreeError(`Worktree for task ${taskId} not found`);
+    }
+    try {
+        // Checkout the target branch in the main repository
+        await execa("git", ["checkout", targetBranch]);
+        // Merge the worktree branch
+        const branchName = worktree.branchName;
+        await execa("git", ["merge", "--no-ff", branchName, "-m", `Merge ${branchName} into ${targetBranch}`]);
+        // Clean up the worktree after successful merge
+        await cleanupWorktree(taskId);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new WorktreeError(`Failed to merge worktree for task ${taskId}: ${error.message}`, error.code);
+        }
+        throw new WorktreeError(`Failed to merge worktree for task ${taskId}`);
+    }
+}
+/**
+ * Remove a worktree.
+ *
+ * Safely removes the worktree after cleaning up any uncommitted changes.
+ *
+ * @param taskId - Task ID whose worktree to remove
+ * @throws WorktreeError if removal fails
+ */
+export async function cleanupWorktree(taskId) {
+    const worktree = await getWorktree(taskId);
+    if (!worktree) {
+        // Already cleaned up, nothing to do
+        return;
+    }
+    try {
+        // Remove the worktree
+        await execa("git", ["worktree", "remove", worktree.path]);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            throw new WorktreeError(`Failed to cleanup worktree for task ${taskId}: ${error.message}`, error.code);
+        }
+        throw new WorktreeError(`Failed to cleanup worktree for task ${taskId}`);
+    }
+}
+/**
+ * List all FORGE worktrees.
+ *
+ * @returns Array of worktree information for all active tasks
+ */
+export async function listWorktrees() {
+    try {
+        const { stdout } = await execa("git", ["worktree", "list", "--porcelain"]);
+        const lines = stdout.split("\n");
+        const worktrees = [];
+        let currentPath = null;
+        let currentBranch = null;
+        let currentCommit = null;
+        for (const line of lines) {
+            if (line.startsWith("worktree ")) {
+                const path = line.slice("worktree ".length);
+                // Only include FORGE worktrees
+                if (path.includes(".worktrees/")) {
+                    currentPath = path;
+                }
+            }
+            else if (currentPath && line.startsWith("branch ")) {
+                currentBranch = line.slice("branch ".length).replace("refs/heads/", "");
+            }
+            else if (currentPath && line.startsWith("commit ")) {
+                currentCommit = line.slice("commit ".length);
+            }
+            else if (line === "") {
+                // End of a worktree block
+                if (currentPath && currentBranch && currentCommit) {
+                    // Extract taskId from path
+                    const taskId = currentPath.match(/\.worktrees\/([^/]+)/)?.[1] || "unknown";
+                    worktrees.push({
+                        taskId,
+                        branchName: currentBranch,
+                        path: currentPath,
+                        commit: currentCommit,
+                    });
+                }
+                // Reset
+                currentPath = null;
+                currentBranch = null;
+                currentCommit = null;
+            }
+        }
+        return worktrees;
+    }
+    catch (error) {
+        throw new WorktreeError("Failed to list worktrees");
+    }
+}
+//# sourceMappingURL=worktree.js.map

package/dist/git/worktree.js.map

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

package/dist/scripts/install.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * FORGE Installation Script
+ * Copies command definitions to global or project .claude folder
+ * Run automatically via npm postinstall or manually with: node dist/scripts/install.js
+ */
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/scripts/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/scripts/install.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}

package/dist/scripts/install.js

@@ -0,0 +1,161 @@
+#!/usr/bin/env node
+/**
+ * FORGE Installation Script
+ * Copies command definitions to global or project .claude folder
+ * Run automatically via npm postinstall or manually with: node dist/scripts/install.js
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+import { existsSync } from 'fs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * Detect if current directory is a FORGE project
+ */
+async function isForgeProject(cwd) {
+    const claudeMdPath = path.join(cwd, 'CLAUDE.md');
+    const stateDirPath = path.join(cwd, 'state');
+    try {
+        const [claudeExists, stateExists] = await Promise.all([
+            fs.access(claudeMdPath).then(() => true).catch(() => false),
+            fs.access(stateDirPath).then(() => true).catch(() => false),
+        ]);
+        return claudeExists && stateExists;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Copy command files from source to target
+ */
+async function copyCommands(sourceDir, targetDir, verbose = false) {
+    const log = (msg) => {
+        if (verbose)
+            console.log(`  ${msg}`);
+    };
+    // Remove existing directory if it exists
+    try {
+        await fs.rm(targetDir, { recursive: true, force: true });
+        log('Removed existing directory');
+    }
+    catch {
+        // Directory doesn't exist, that's fine
+    }
+    // Create target directory
+    await fs.mkdir(targetDir, { recursive: true });
+    log(`Created directory: ${targetDir}`);
+    // Copy all files
+    const files = await fs.readdir(sourceDir);
+    let copiedCount = 0;
+    for (const file of files) {
+        if (file.endsWith('.md')) {
+            const sourcePath = path.join(sourceDir, file);
+            const targetPath = path.join(targetDir, file);
+            await fs.copyFile(sourcePath, targetPath);
+            copiedCount++;
+            log(`Copied: ${file}`);
+        }
+    }
+    return copiedCount;
+}
+/**
+ * Main installation function
+ */
+async function install(options = {}) {
+    const { verbose = false, mode = 'auto' } = options;
+    // Determine paths
+    const homeDir = process.env.HOME || process.env.USERPROFILE || '.';
+    const cwd = process.cwd();
+    const globalCommandsDir = path.join(homeDir, '.claude', 'commands', 'forge');
+    const projectCommandsDir = path.join(cwd, '.claude', 'commands', 'forge');
+    // Determine installation mode
+    let installMode = mode;
+    let targetDir;
+    if (mode === 'auto') {
+        // Auto-detect: check if we're in a FORGE project
+        const inForgeProject = await isForgeProject(cwd);
+        if (inForgeProject) {
+            installMode = 'project';
+            targetDir = projectCommandsDir;
+            console.log('ℹ FORGE project detected - installing to project .claude folder');
+        }
+        else {
+            installMode = 'global';
+            targetDir = globalCommandsDir;
+            console.log('ℹ No FORGE project detected - installing to global .claude folder');
+        }
+    }
+    else if (mode === 'global') {
+        targetDir = globalCommandsDir;
+    }
+    else {
+        targetDir = projectCommandsDir;
+    }
+    // Get package directory (where npm installed the package)
+    const packageDir = path.join(__dirname, '..');
+    // Try different source paths (for both installed and dev modes)
+    const possibleSources = [
+        path.join(packageDir, '..', '.claude', 'commands', 'forge'), // Installed
+        path.join(cwd, '.claude', 'commands', 'forge'), // Dev
+        path.join(process.cwd(), '.claude', 'commands', 'forge'), // Alternative
+    ];
+    let sourceCommandsDir = null;
+    for (const sourcePath of possibleSources) {
+        if (existsSync(sourcePath)) {
+            sourceCommandsDir = sourcePath;
+            break;
+        }
+    }
+    if (!sourceCommandsDir) {
+        console.error('✗ Commands directory not found');
+        console.log('ℹ If developing, run: npm run build');
+        process.exit(1);
+    }
+    const log = (msg) => {
+        if (verbose)
+            console.log(`  ${msg}`);
+    };
+    const success = (msg) => console.log(`✓ ${msg}`);
+    const error = (msg) => console.error(`✗ ${msg}`);
+    try {
+        log(`Mode: ${installMode}`);
+        log(`Source: ${sourceCommandsDir}`);
+        log(`Target: ${targetDir}`);
+        const copiedCount = await copyCommands(sourceCommandsDir, targetDir, verbose);
+        success(`FORGE commands installed (${installMode} mode)`);
+        console.log(`  ${copiedCount} command files copied`);
+        if (installMode === 'global') {
+            console.log('');
+            console.log('Available commands:');
+            console.log('  /forge:new-project  Initialize a new FORGE project');
+            console.log('  /forge:init        Initialize FORGE in current directory');
+            console.log('  /forge:status      Show project progress');
+            console.log('  /forge:discuss     Capture phase context');
+            console.log('  /forge:plan        Generate task breakdown');
+            console.log('  /forge:execute     Execute phase with agent teams');
+            console.log('  /forge:help        Show all commands');
+        }
+        else {
+            console.log('');
+            console.log('ℹ Project-level installation complete');
+            console.log('ℹ Commands available in this project only');
+        }
+        console.log('');
+        console.log('Documentation: https://github.com/Alzarak/forge');
+    }
+    catch (err) {
+        error(`Installation failed: ${err}`);
+        process.exit(1);
+    }
+}
+// Parse CLI arguments
+const args = process.argv.slice(2);
+const verbose = args.includes('--verbose') || args.includes('-v');
+const modeArg = args.find(arg => arg.startsWith('--mode='));
+const mode = modeArg ? modeArg.split('=')[1] : 'auto';
+// Run installation
+await install({ verbose, mode });
+//# sourceMappingURL=install.js.map

package/dist/scripts/install.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,30 @@
+/**
+ * FORGE Configuration Types
+ * Based on .planning/forge.config.json schema
+ */
+export type ForgeMode = 'yolo' | 'interactive';
+export type ForgeDepth = 'quick' | 'standard' | 'comprehensive';
+export type GitStrategy = 'none' | 'worktree' | 'branch';
+export type AgentProfile = 'quality' | 'balanced' | 'budget';
+export interface WorkflowConfig {
+    research: boolean;
+    planCheck: boolean;
+    tribunal: boolean;
+    contractFirst: boolean;
+}
+export interface GitConfig {
+    strategy: GitStrategy;
+    branchTemplate: string;
+    squashOnShip: boolean;
+}
+export interface ForgeConfig {
+    mode: ForgeMode;
+    depth: ForgeDepth;
+    maxTeammates: number;
+    taskLimit: number;
+    agentProfile: AgentProfile;
+    workflow: WorkflowConfig;
+    git: GitConfig;
+}
+export declare const DEFAULT_CONFIG: ForgeConfig;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,aAAa,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,eAAe,CAAC;AAChE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,CAAC;AACzD,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,WAAW,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAE1B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAGlB,YAAY,EAAE,YAAY,CAAC;IAG3B,QAAQ,EAAE,cAAc,CAAC;IAGzB,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,eAAO,MAAM,cAAc,EAAE,WAiB5B,CAAC"}

package/dist/types/config.js

@@ -0,0 +1,23 @@
+/**
+ * FORGE Configuration Types
+ * Based on .planning/forge.config.json schema
+ */
+export const DEFAULT_CONFIG = {
+    mode: 'interactive',
+    depth: 'standard',
+    maxTeammates: 4,
+    taskLimit: 6,
+    agentProfile: 'balanced',
+    workflow: {
+        research: true,
+        planCheck: true,
+        tribunal: true,
+        contractFirst: true,
+    },
+    git: {
+        strategy: 'worktree',
+        branchTemplate: 'forge/{taskId}-{slug}',
+        squashOnShip: true,
+    },
+};
+//# sourceMappingURL=config.js.map

package/dist/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAqCH,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,IAAI,EAAE,aAAa;IACnB,KAAK,EAAE,UAAU;IACjB,YAAY,EAAE,CAAC;IACf,SAAS,EAAE,CAAC;IACZ,YAAY,EAAE,UAAU;IACxB,QAAQ,EAAE;QACR,QAAQ,EAAE,IAAI;QACd,SAAS,EAAE,IAAI;QACf,QAAQ,EAAE,IAAI;QACd,aAAa,EAAE,IAAI;KACpB;IACD,GAAG,EAAE;QACH,QAAQ,EAAE,UAAU;QACpB,cAAc,EAAE,uBAAuB;QACvC,YAAY,EAAE,IAAI;KACnB;CACF,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * FORGE Type Exports
+ */
+export * from './config';
+export * from './state';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,6 @@
+/**
+ * FORGE Type Exports
+ */
+export * from './config';
+export * from './state';
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/types/state.d.ts

@@ -0,0 +1,56 @@
+/**
+ * FORGE State Types
+ * Based on state/STATE.json schema
+ */
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'blocked';
+export type EventType = 'TASK_STARTED' | 'TASK_COMPLETED' | 'TASK_BLOCKED' | 'REQUEST_CONTRACT' | 'CONTRACT_PUBLISHED' | 'REVIEW_FINDING' | 'REVIEW_RESOLVED';
+export interface Task {
+    id: string;
+    title: string;
+    ownerRole: string;
+    status: TaskStatus;
+    deps: string[];
+    allowedPaths: string[];
+    acceptance: string[];
+    verify: string[];
+    commit: string | null;
+    requests: string[];
+    priority: number;
+}
+export interface Contract {
+    id: string;
+    path: string;
+    version: string;
+    publishedBy: string;
+    consumers: string[];
+}
+export interface ProjectState {
+    name: string;
+    status: string;
+    currentMilestone: string;
+    currentPhase: number;
+}
+export interface EventPayload {
+    [key: string]: any;
+    commitHash?: string;
+    filesChanged?: string[];
+    testsRun?: number;
+    testsPassed?: number;
+    reason?: string;
+    findings?: any[];
+}
+export interface StateEvent {
+    eventId: string;
+    timestamp: string;
+    taskId: string;
+    actor: string;
+    type: EventType;
+    payload: EventPayload;
+}
+export interface ForgeState {
+    project: ProjectState;
+    tasks: Task[];
+    contracts: Contract[];
+    eventsPointer: string;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/types/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAC7E,MAAM,MAAM,SAAS,GACjB,cAAc,GACd,gBAAgB,GAChB,cAAc,GACd,kBAAkB,GAClB,oBAAoB,GACpB,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,UAAU,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/types/state.js

@@ -0,0 +1,6 @@
+/**
+ * FORGE State Types
+ * Based on state/STATE.json schema
+ */
+export {};
+//# sourceMappingURL=state.js.map

package/dist/types/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/types/state.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/utils/config.d.ts

@@ -0,0 +1,15 @@
+import { ForgeConfig } from '../types/index.js';
+/**
+ * Load FORGE configuration from .planning/forge.config.json
+ * Falls back to defaults if config doesn't exist
+ */
+export declare function loadConfig(projectRoot?: string): ForgeConfig;
+/**
+ * Save FORGE configuration to .planning/forge.config.json
+ */
+export declare function saveConfig(config: ForgeConfig, projectRoot?: string): void;
+/**
+ * Validate configuration values
+ */
+export declare function validateConfig(config: Partial<ForgeConfig>): string[];
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAkB,MAAM,mBAAmB,CAAC;AAIhE;;;GAGG;AACH,wBAAgB,UAAU,CAAC,WAAW,GAAE,MAAsB,GAAG,WAAW,CA8B3E;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,GAAE,MAAsB,GAAG,IAAI,CAczF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,MAAM,EAAE,CA4BrE"}

package/dist/utils/config.js

@@ -0,0 +1,80 @@
+import fs from 'fs';
+import path from 'path';
+import { DEFAULT_CONFIG } from '../types/index.js';
+const CONFIG_PATH = '.planning/forge.config.json';
+/**
+ * Load FORGE configuration from .planning/forge.config.json
+ * Falls back to defaults if config doesn't exist
+ */
+export function loadConfig(projectRoot = process.cwd()) {
+    const configPath = path.join(projectRoot, CONFIG_PATH);
+    if (!fs.existsSync(configPath)) {
+        return DEFAULT_CONFIG;
+    }
+    try {
+        const configContent = fs.readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(configContent);
+        // Merge with defaults to ensure all fields exist
+        return {
+            mode: config.mode ?? DEFAULT_CONFIG.mode,
+            depth: config.depth ?? DEFAULT_CONFIG.depth,
+            maxTeammates: config.maxTeammates ?? DEFAULT_CONFIG.maxTeammates,
+            taskLimit: config.taskLimit ?? DEFAULT_CONFIG.taskLimit,
+            agentProfile: config.agentProfile ?? DEFAULT_CONFIG.agentProfile,
+            workflow: {
+                ...DEFAULT_CONFIG.workflow,
+                ...config.workflow,
+            },
+            git: {
+                ...DEFAULT_CONFIG.git,
+                ...config.git,
+            },
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to load config from ${configPath}: ${error}`);
+    }
+}
+/**
+ * Save FORGE configuration to .planning/forge.config.json
+ */
+export function saveConfig(config, projectRoot = process.cwd()) {
+    const configDir = path.join(projectRoot, '.planning');
+    const configPath = path.join(configDir, 'forge.config.json');
+    // Ensure .planning directory exists
+    if (!fs.existsSync(configDir)) {
+        fs.mkdirSync(configDir, { recursive: true });
+    }
+    try {
+        fs.writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    catch (error) {
+        throw new Error(`Failed to save config to ${configPath}: ${error}`);
+    }
+}
+/**
+ * Validate configuration values
+ */
+export function validateConfig(config) {
+    const errors = [];
+    if (config.mode && !['yolo', 'interactive'].includes(config.mode)) {
+        errors.push(`Invalid mode: ${config.mode}. Must be 'yolo' or 'interactive'.`);
+    }
+    if (config.depth && !['quick', 'standard', 'comprehensive'].includes(config.depth)) {
+        errors.push(`Invalid depth: ${config.depth}. Must be 'quick', 'standard', or 'comprehensive'.`);
+    }
+    if (config.maxTeammates !== undefined && (config.maxTeammates < 2 || config.maxTeammates > 6)) {
+        errors.push(`maxTeammates must be between 2 and 6. Got: ${config.maxTeammates}`);
+    }
+    if (config.taskLimit !== undefined && (config.taskLimit < 3 || config.taskLimit > 8)) {
+        errors.push(`taskLimit must be between 3 and 8. Got: ${config.taskLimit}`);
+    }
+    if (config.agentProfile && !['quality', 'balanced', 'budget'].includes(config.agentProfile)) {
+        errors.push(`Invalid agentProfile: ${config.agentProfile}. Must be 'quality', 'balanced', or 'budget'.`);
+    }
+    if (config.git?.strategy && !['none', 'worktree', 'branch'].includes(config.git.strategy)) {
+        errors.push(`Invalid git.strategy: ${config.git.strategy}. Must be 'none', 'worktree', or 'branch'.`);
+    }
+    return errors;
+}
+//# sourceMappingURL=config.js.map