forge-dev-framework 1.0.1 → 1.2.0

package/dist/git/pre-commit-hooks.js

@@ -1,270 +0,0 @@
-/**
- * Pre-commit Hooks for FORGE
- *
- * Creates hooks to enforce:
- * - Out-of-scope file detection (agent tried to write outside allowedPaths)
- * - Commit message format validation
- * - Test execution requirement (if tests defined for task)
- * - Contract file validation (if contract referenced)
- *
- * These hooks are installed to .git/hooks/ and run before each commit.
- */
-import { writeFile, mkdir } from "node:fs/promises";
-import { join } from "node:path";
-import { execa } from "execa";
-import { validateForPreCommit } from "./commit.js";
-/**
- * Generate the pre-commit hook script.
- *
- * This shell script is installed to .git/hooks/pre-commit.
- */
-export function generatePreCommitScript() {
-    return `#!/bin/bash
-# FORGE Pre-commit Hook
-# Auto-generated by FORGE - DO NOT EDIT MANUALLY
-
-set -e
-
-# Get the root of the git repository
-REPO_ROOT=$(git rev-parse --show-toplevel)
-
-# Run the TypeScript pre-commit validator
-node "$REPO_ROOT/dist/git/hooks/pre-commit.js" "$@"
-`;
-}
-/**
- * Generate the commit-msg hook script.
- *
- * This shell script is installed to .git/hooks/commit-msg.
- */
-export function generateCommitMsgScript() {
-    return `#!/bin/bash
-# FORGE Commit Message Hook
-# Auto-generated by FORGE - DO NOT EDIT MANUALLY
-
-set -e
-
-# Get the root of the git repository
-REPO_ROOT=$(git rev-parse --show-toplevel)
-
-# Run the TypeScript commit-msg validator
-node "$REPO_ROOT/dist/git/hooks/commit-msg.js" "$1"
-`;
-}
-/**
- * Install pre-commit hooks to the .git/hooks directory.
- *
- * @param basePath - Root of the FORGE project
- */
-export async function installHooks(basePath = "/home/parz/projects/forge") {
-    const hooksDir = join(basePath, ".git", "hooks");
-    // Ensure hooks directory exists
-    await mkdir(hooksDir, { recursive: true });
-    // Write pre-commit hook
-    const preCommitPath = join(hooksDir, "pre-commit");
-    await writeFile(preCommitPath, generatePreCommitScript(), { mode: 0o755 });
-    // Write commit-msg hook
-    const commitMsgPath = join(hooksDir, "commit-msg");
-    await writeFile(commitMsgPath, generateCommitMsgScript(), { mode: 0o755 });
-    console.log("FORGE pre-commit hooks installed.");
-}
-/**
- * Check if files are within allowed paths.
- *
- * @param files - Files to check
- * @param allowedPaths - Allowed path patterns
- * @returns Validation result
- */
-export function checkFileScope(files, allowedPaths) {
-    const outOfScopeFiles = [];
-    for (const file of files) {
-        const isAllowed = allowedPaths.some((pattern) => {
-            // Simple glob matching - converts gitignore-style patterns to regex
-            const regexPattern = pattern
-                .replace(/\*\*/g, ".*")
-                .replace(/\*/g, "[^/]*")
-                .replace(/\?/g, "[^/]");
-            const regex = new RegExp(`^${regexPattern}`);
-            return regex.test(file);
-        });
-        if (!isAllowed) {
-            outOfScopeFiles.push(file);
-        }
-    }
-    return {
-        isValid: outOfScopeFiles.length === 0,
-        outOfScopeFiles,
-    };
-}
-/**
- * Get staged files for a commit.
- *
- * @returns Array of staged file paths
- */
-export async function getStagedFiles() {
-    const { stdout } = await execa("git", ["diff", "--cached", "--name-only", "--diff-filter=ACM"]);
-    return stdout.split("\n").filter((f) => f.length > 0);
-}
-/**
- * Validate that required contracts exist and are valid.
- *
- * @param contracts - Contract file paths to validate
- * @param basePath - Root of the FORGE project
- * @returns Validation result
- */
-export async function validateContracts(contracts, basePath = "/home/parz/projects/forge") {
-    const errors = [];
-    const { readFile } = await import("node:fs/promises");
-    for (const contract of contracts) {
-        const contractPath = join(basePath, contract);
-        try {
-            // Check if file exists
-            await readFile(contractPath, "utf-8");
-            // TODO: Add validation based on contract type
-            // - OpenAPI validation for .yaml files
-            // - TypeScript type checking for .d.ts files
-            // - Zod schema validation
-        }
-        catch (error) {
-            errors.push(`Contract file not found or invalid: ${contract}`);
-        }
-    }
-    return {
-        isValid: errors.length === 0,
-        errors,
-    };
-}
-/**
- * Run tests and check if they pass.
- *
- * @param testCommands - Test commands to run (e.g., ["npm test -- --grep 'session auth'"])
- * @returns Test result
- */
-export async function runRequiredTests(testCommands) {
-    const results = [];
-    for (const command of testCommands) {
-        try {
-            const { stdout, stderr } = await execa(command, { shell: true });
-            results.push({ passed: true, output: stdout + stderr });
-        }
-        catch (error) {
-            if (error instanceof Error) {
-                results.push({ passed: false, output: error.message });
-            }
-            else {
-                results.push({ passed: false, output: "Unknown error" });
-            }
-        }
-    }
-    const allPassed = results.every((r) => r.passed);
-    const combinedOutput = results.map((r, i) => `Test ${i + 1}:\n${r.output}`).join("\n\n");
-    return {
-        passed: allPassed,
-        output: combinedOutput,
-    };
-}
-/**
- * Run all pre-commit validations.
- *
- * This is the main entry point for the pre-commit hook.
- *
- * @param context - Pre-commit validation context
- * @returns Validation result with errors
- */
-export async function runPreCommitValidations(context) {
-    const errors = [];
-    // 1. Get staged files
-    const stagedFiles = await getStagedFiles();
-    // 2. Check file scope (if allowedPaths provided)
-    if (context.allowedPaths && context.allowedPaths.length > 0) {
-        const scopeCheck = checkFileScope(stagedFiles, context.allowedPaths);
-        if (!scopeCheck.isValid) {
-            errors.push(`Out-of-scope files detected: ${scopeCheck.outOfScopeFiles.join(", ")}\n` +
-                `Allowed paths: ${context.allowedPaths.join(", ")}`);
-        }
-    }
-    // 3. Validate contracts (if required)
-    if (context.requiredContracts && context.requiredContracts.length > 0) {
-        const contractValidation = await validateContracts(context.requiredContracts);
-        if (!contractValidation.isValid) {
-            errors.push(...contractValidation.errors);
-        }
-    }
-    // 4. Run required tests (if specified)
-    if (context.requiredTests && context.requiredTests.length > 0) {
-        const testResult = await runRequiredTests(context.requiredTests);
-        if (!testResult.passed) {
-            errors.push(`Required tests failed:\n${testResult.output}`);
-        }
-    }
-    return {
-        isValid: errors.length === 0,
-        errors,
-    };
-}
-/**
- * Run commit message validation.
- *
- * This is the main entry point for the commit-msg hook.
- *
- * @param message - Commit message to validate
- * @param expectedTaskId - Expected task ID (optional)
- * @returns Validation result
- */
-export function runCommitMsgValidation(message, expectedTaskId) {
-    const result = validateForPreCommit(message, expectedTaskId);
-    return {
-        isValid: result.isValid,
-        errors: result.errors,
-    };
-}
-/**
- * Read pre-commit context from task state.
- *
- * This loads the validation rules from the FORGE state.
- *
- * @param taskId - Task ID to load context for
- * @param basePath - Root of the FORGE project
- * @returns Pre-commit context
- */
-export async function loadPreCommitContext(taskId, basePath = "/home/parz/projects/forge") {
-    const { readFile } = await import("node:fs/promises");
-    const statePath = join(basePath, "state", "STATE.json");
-    try {
-        const stateRaw = await readFile(statePath, "utf-8");
-        const state = JSON.parse(stateRaw);
-        const task = state.tasks.find((t) => t.id === taskId);
-        if (!task) {
-            throw new Error(`Task ${taskId} not found in STATE.json`);
-        }
-        return {
-            taskId: task.id,
-            allowedPaths: task.allowedPaths,
-            requiredTests: task.verify,
-            requiredContracts: task.contracts,
-        };
-    }
-    catch (error) {
-        // If state doesn't exist, return empty context
-        return {};
-    }
-}
-/**
- * Parse task ID from the current branch name.
- *
- * FORGE branches use format: forge/{taskId}
- *
- * @returns Task ID or null
- */
-export async function parseTaskIdFromBranch() {
-    try {
-        const { stdout } = await execa("git", ["branch", "--show-current"]);
-        const branch = stdout.trim();
-        const match = branch.match(/^forge\/(.+)$/);
-        return match ? match[1] : null;
-    }
-    catch {
-        return null;
-    }
-}
-//# sourceMappingURL=pre-commit-hooks.js.map

package/dist/git/pre-commit-hooks.js.map

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

package/dist/git/wipe-protocol.d.ts

@@ -1,281 +0,0 @@
-/**
- * The Wipe Protocol - Context Hygiene for FORGE
- *
- * Treats agent context as ephemeral, git as persistent.
- *
- * Lifecycle:
- * 1. Hydrate — Agent starts, reads CLAUDE.md + STATE.json + assigned task + contracts
- * 2. Execute — Agent writes code, runs tests within its domain
- * 3. Commit — Atomic git commit linked to task ID
- * 4. Terminate — Session ends, context wiped
- * 5. Reincarnate — Next task starts with fresh context, reads NEW git state
- */
-import { z } from "zod";
-export declare const TaskSchema: z.ZodObject<{
-    id: z.ZodString;
-    title: z.ZodString;
-    ownerRole: z.ZodString;
-    status: z.ZodEnum<["pending", "in_progress", "completed", "blocked"]>;
-    deps: z.ZodArray<z.ZodString, "many">;
-    allowedPaths: z.ZodArray<z.ZodString, "many">;
-    acceptance: z.ZodArray<z.ZodString, "many">;
-    verify: z.ZodArray<z.ZodString, "many">;
-    commit: z.ZodNullable<z.ZodString>;
-    requests: z.ZodArray<z.ZodString, "many">;
-    priority: z.ZodNumber;
-}, "strip", z.ZodTypeAny, {
-    status: "pending" | "in_progress" | "completed" | "blocked";
-    allowedPaths: string[];
-    commit: string | null;
-    id: string;
-    title: string;
-    ownerRole: string;
-    deps: string[];
-    acceptance: string[];
-    verify: string[];
-    requests: string[];
-    priority: number;
-}, {
-    status: "pending" | "in_progress" | "completed" | "blocked";
-    allowedPaths: string[];
-    commit: string | null;
-    id: string;
-    title: string;
-    ownerRole: string;
-    deps: string[];
-    acceptance: string[];
-    verify: string[];
-    requests: string[];
-    priority: number;
-}>;
-export type Task = z.infer<typeof TaskSchema>;
-export declare const StateSchema: z.ZodObject<{
-    project: z.ZodObject<{
-        name: z.ZodString;
-        status: z.ZodString;
-        currentMilestone: z.ZodString;
-        currentPhase: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        status: string;
-        name: string;
-        currentMilestone: string;
-        currentPhase: number;
-    }, {
-        status: string;
-        name: string;
-        currentMilestone: string;
-        currentPhase: number;
-    }>;
-    tasks: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        title: z.ZodString;
-        ownerRole: z.ZodString;
-        status: z.ZodEnum<["pending", "in_progress", "completed", "blocked"]>;
-        deps: z.ZodArray<z.ZodString, "many">;
-        allowedPaths: z.ZodArray<z.ZodString, "many">;
-        acceptance: z.ZodArray<z.ZodString, "many">;
-        verify: z.ZodArray<z.ZodString, "many">;
-        commit: z.ZodNullable<z.ZodString>;
-        requests: z.ZodArray<z.ZodString, "many">;
-        priority: z.ZodNumber;
-    }, "strip", z.ZodTypeAny, {
-        status: "pending" | "in_progress" | "completed" | "blocked";
-        allowedPaths: string[];
-        commit: string | null;
-        id: string;
-        title: string;
-        ownerRole: string;
-        deps: string[];
-        acceptance: string[];
-        verify: string[];
-        requests: string[];
-        priority: number;
-    }, {
-        status: "pending" | "in_progress" | "completed" | "blocked";
-        allowedPaths: string[];
-        commit: string | null;
-        id: string;
-        title: string;
-        ownerRole: string;
-        deps: string[];
-        acceptance: string[];
-        verify: string[];
-        requests: string[];
-        priority: number;
-    }>, "many">;
-    contracts: z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        path: z.ZodString;
-        version: z.ZodString;
-        publishedBy: z.ZodString;
-        consumers: z.ZodArray<z.ZodString, "many">;
-    }, "strip", z.ZodTypeAny, {
-        path: string;
-        id: string;
-        version: string;
-        publishedBy: string;
-        consumers: string[];
-    }, {
-        path: string;
-        id: string;
-        version: string;
-        publishedBy: string;
-        consumers: string[];
-    }>, "many">;
-    eventsPointer: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    project: {
-        status: string;
-        name: string;
-        currentMilestone: string;
-        currentPhase: number;
-    };
-    tasks: {
-        status: "pending" | "in_progress" | "completed" | "blocked";
-        allowedPaths: string[];
-        commit: string | null;
-        id: string;
-        title: string;
-        ownerRole: string;
-        deps: string[];
-        acceptance: string[];
-        verify: string[];
-        requests: string[];
-        priority: number;
-    }[];
-    contracts: {
-        path: string;
-        id: string;
-        version: string;
-        publishedBy: string;
-        consumers: string[];
-    }[];
-    eventsPointer: string;
-}, {
-    project: {
-        status: string;
-        name: string;
-        currentMilestone: string;
-        currentPhase: number;
-    };
-    tasks: {
-        status: "pending" | "in_progress" | "completed" | "blocked";
-        allowedPaths: string[];
-        commit: string | null;
-        id: string;
-        title: string;
-        ownerRole: string;
-        deps: string[];
-        acceptance: string[];
-        verify: string[];
-        requests: string[];
-        priority: number;
-    }[];
-    contracts: {
-        path: string;
-        id: string;
-        version: string;
-        publishedBy: string;
-        consumers: string[];
-    }[];
-    eventsPointer: string;
-}>;
-export type State = z.infer<typeof StateSchema>;
-export interface HydrateContext {
-    claudeRules: string;
-    state: State;
-    task: Task;
-    contracts: Map<string, string>;
-}
-/**
- * Phase 1: Hydrate
- *
- * Agent starts. Reads all necessary context from the repository.
- * This is the ONLY state the agent receives - no conversation history.
- *
- * @param taskId - The task ID to hydrate for
- * @param basePath - Root of the FORGE project
- * @returns Hydration context with all necessary artifacts
- */
-export declare function hydrate(taskId: string, basePath?: string): Promise<HydrateContext>;
-/**
- * Phase 2: Execute
- *
- * Agent writes code, runs tests within its domain.
- * This is where the actual work happens.
- *
- * Note: This function is a placeholder - the actual execution
- * is done by the agent teammate. We just provide the isolation
- * context (worktree) and validation (allowedPaths).
- *
- * @param taskId - The task ID being executed
- * @param basePath - Root of the FORGE project
- * @returns Path to the worktree for execution
- */
-export declare function execute(taskId: string, basePath?: string): Promise<string>;
-/**
- * Validate that files are within allowed paths for a task.
- *
- * Enforces the CODEOWNERS boundary - agents can only write
- * within their assigned domain.
- *
- * @param files - Files to validate
- * @param allowedPaths - Allowed path patterns
- * @throws Error if any file is out of scope
- */
-export declare function validateScope(files: string[], allowedPaths: string[]): void;
-/**
- * Phase 3: Commit
- *
- * Atomic git commit linked to task ID.
- * Every task MUST result in exactly one commit.
- *
- * Format: type(scope): description
- * Example: feat(api-003): implement session authentication
- *
- * @param taskId - The task ID
- * @param message - Commit message (will be formatted)
- * @param basePath - Root of the FORGE project
- * @returns The commit hash
- */
-export declare function commitTask(taskId: string, message: string, basePath?: string): Promise<string>;
-/**
- * Phase 4: Terminate
- *
- * Session ends. Context is wiped clean.
- * The agent's conversation history is discarded.
- *
- * Note: In Agent Teams, this happens naturally when the agent
- * exits. We just need to ensure the worktree is cleaned up.
- *
- * @param taskId - The task ID
- * @param keepWorktree - Whether to keep the worktree (for debugging)
- */
-export declare function terminate(taskId: string, keepWorktree?: boolean): Promise<void>;
-/**
- * Phase 5: Reincarnate
- *
- * Next task starts with fresh context, reading the NEW git state.
- *
- * This happens naturally when a new agent spawns - they start
- * with a fresh context window and hydrate() to read current state.
- *
- * @param nextTaskId - The next task ID to work on
- * @param basePath - Root of the FORGE project
- * @returns Hydration context for the next task
- */
-export declare function reincarnate(nextTaskId: string, basePath?: string): Promise<HydrateContext>;
-/**
- * Execute the full Wipe Protocol lifecycle for a task.
- *
- * This is the main entry point that orchestrates all phases.
- * Note that phases 2 (execute) and 4 (terminate) happen
- * externally - this just sets up and tears down.
- *
- * @param taskId - The task ID to execute
- * @param workCallback - Async function that does the actual work
- * @param basePath - Root of the FORGE project
- * @returns Commit hash from the completed task
- */
-export declare function runWipeProtocol(taskId: string, workCallback: (worktreePath: string) => Promise<string>, basePath?: string): Promise<string>;
-//# sourceMappingURL=wipe-protocol.d.ts.map

package/dist/git/wipe-protocol.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"wipe-protocol.d.ts","sourceRoot":"","sources":["../../src/git/wipe-protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAYrB,CAAC;AAEH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkBtB,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEhD,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,IAAI,CAAC;IACX,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAoC,GAAG,OAAO,CAAC,cAAc,CAAC,CAoCrH;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAoC,GAAG,OAAO,CAAC,MAAM,CAAC,CAY7G;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,IAAI,CAgB3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,MAAoC,GAC7C,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,GAAE,OAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAI5F;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,MAAoC,GAC7C,OAAO,CAAC,cAAc,CAAC,CAGzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,EACvD,QAAQ,GAAE,MAAoC,GAC7C,OAAO,CAAC,MAAM,CAAC,CAuBjB"}