forge-dev-framework 1.0.1 → 1.2.0

package/dist/git/commit.js

@@ -1,223 +0,0 @@
-/**
- * Atomic Commit Enforcement for FORGE
- *
- * Enforces conventional commit format with task ID in scope:
- * type(scope): description
- *
- * Examples:
- * - feat(api-003): implement session authentication
- * - fix(ui-002): resolve login form validation bug
- * - test(core-001): add database integration tests
- * - docs(readme): update installation instructions
- *
- * Rules:
- * - Every task = one commit
- * - Commit message MUST include task ID in scope
- * - Pre-commit hooks validate format
- * - Reject commits that don't match pattern
- */
-import { z } from "zod";
-// Conventional commit types
-export const CommitType = z.enum([
-    "feat",
-    "fix",
-    "docs",
-    "style",
-    "refactor",
-    "perf",
-    "test",
-    "chore",
-    "revert",
-]);
-// Commit message format: type(scope): description
-// Scope MUST be a task ID (e.g., api-003, ui-002)
-const COMMIT_PATTERN = /^([a-z]+)\(([a-z]+-[0-9]+)\):\s+(.+)$/;
-export class CommitFormatError extends Error {
-    commitMessage;
-    constructor(message, commitMessage) {
-        super(message);
-        this.commitMessage = commitMessage;
-        this.name = "CommitFormatError";
-    }
-}
-/**
- * Parse a commit message into its components.
- *
- * @param message - The commit message to parse
- * @returns Parsed commit components
- * @throws CommitFormatError if format is invalid
- */
-export function parseCommitMessage(message) {
-    const match = message.match(COMMIT_PATTERN);
-    if (!match) {
-        throw new CommitFormatError(`Commit message must follow format "type(scope): description". Got: "${message}"`, message);
-    }
-    const [, typeRaw, scope, description] = match;
-    // Validate commit type
-    const typeResult = CommitType.safeParse(typeRaw);
-    if (!typeResult.success) {
-        throw new CommitFormatError(`Invalid commit type "${typeRaw}". Must be one of: ${CommitType.options.join(", ")}`, message);
-    }
-    // Validate scope format (task ID: domain-number)
-    if (!/^[a-z]+-[0-9]+$/.test(scope)) {
-        throw new CommitFormatError(`Invalid scope "${scope}". Scope must be a task ID in format "domain-number" (e.g., api-003)`, message);
-    }
-    // Validate description is not empty
-    if (!description || description.trim().length === 0) {
-        throw new CommitFormatError(`Commit description cannot be empty`, message);
-    }
-    return {
-        type: typeResult.data,
-        scope,
-        description,
-    };
-}
-/**
- * Format a commit message from components.
- *
- * @param type - Commit type
- * @param scope - Task ID (e.g., api-003)
- * @param description - Commit description
- * @returns Formatted commit message
- */
-export function formatCommitMessage(type, scope, description) {
-    return `${type}(${scope}): ${description}`;
-}
-/**
- * Validate a commit message against FORGE standards.
- *
- * @param message - The commit message to validate
- * @returns True if valid
- * @throws CommitFormatError if invalid
- */
-export function validateCommitMessage(message) {
-    parseCommitMessage(message);
-    return true;
-}
-/**
- * Check if a commit message is for a specific task.
- *
- * @param message - The commit message
- * @param taskId - The task ID to check
- * @returns True if the commit is for the specified task
- */
-export function isCommitForTask(message, taskId) {
-    try {
-        const parsed = parseCommitMessage(message);
-        return parsed.scope === taskId;
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Extract task ID from a commit message.
- *
- * @param message - The commit message
- * @returns Task ID or null if format is invalid
- */
-export function extractTaskId(message) {
-    try {
-        const parsed = parseCommitMessage(message);
-        return parsed.scope;
-    }
-    catch {
-        return null;
-    }
-}
-/**
- * Create a full commit message with optional body and footer.
- *
- * @param options - Commit message components
- * @returns Formatted commit message
- */
-export function createCommitMessage(options) {
-    const { type, taskId, description, body, footer } = options;
-    let message = formatCommitMessage(type, taskId, description);
-    if (body) {
-        message += `\n\n${body}`;
-    }
-    if (footer) {
-        message += `\n\n${footer}`;
-    }
-    return message;
-}
-/**
- * Batch validate multiple commit messages.
- *
- * Useful for pre-commit hooks that check all staged commits.
- *
- * @param messages - Array of commit messages
- * @returns Object with validation results
- */
-export function validateCommitMessages(messages) {
-    const errors = [];
-    for (const message of messages) {
-        try {
-            validateCommitMessage(message);
-        }
-        catch (error) {
-            if (error instanceof CommitFormatError) {
-                errors.push({
-                    message,
-                    error: error.message,
-                });
-            }
-        }
-    }
-    return {
-        valid: errors.length === 0,
-        errors,
-    };
-}
-/**
- * Generate a commit message from task information.
- *
- * This is a helper for agents to generate properly formatted commits.
- *
- * @param taskId - The task ID
- * @param taskTitle - The task title (will be converted to description)
- * @param type - Commit type (defaults to "feat")
- * @returns Formatted commit message
- */
-export function generateCommitFromTask(taskId, taskTitle, type = "feat") {
-    // Convert task title to commit description
-    // Lowercase first letter if it's capitalized
-    const description = taskTitle.charAt(0).toLowerCase() + taskTitle.slice(1);
-    return formatCommitMessage(type, taskId, description);
-}
-/**
- * Validate a commit for pre-commit hook usage.
- *
- * This is the main entry point for pre-commit hooks.
- *
- * @param message - The commit message to validate
- * @param expectedTaskId - Optional expected task ID
- * @returns Validation result
- */
-export function validateForPreCommit(message, expectedTaskId) {
-    const errors = [];
-    let taskId = null;
-    try {
-        const parsed = parseCommitMessage(message);
-        taskId = parsed.scope;
-        // If expected task ID is provided, check for match
-        if (expectedTaskId && parsed.scope !== expectedTaskId) {
-            errors.push(`Commit scope "${parsed.scope}" does not match expected task ID "${expectedTaskId}"`);
-        }
-    }
-    catch (error) {
-        if (error instanceof CommitFormatError) {
-            errors.push(error.message);
-        }
-        else {
-            errors.push("Unknown validation error");
-        }
-    }
-    return {
-        isValid: errors.length === 0,
-        taskId,
-        errors,
-    };
-}
-//# sourceMappingURL=commit.js.map

package/dist/git/commit.js.map

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

package/dist/git/hooks/commit-msg.d.ts

@@ -1,8 +0,0 @@
-/**
- * Commit Message Hook Implementation
- *
- * This is the TypeScript file that the shell hook calls.
- * It validates the commit message format.
- */
-export {};
-//# sourceMappingURL=commit-msg.d.ts.map

package/dist/git/hooks/commit-msg.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"commit-msg.d.ts","sourceRoot":"","sources":["../../../src/git/hooks/commit-msg.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

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

@@ -1,34 +0,0 @@
-/**
- * Commit Message Hook Implementation
- *
- * This is the TypeScript file that the shell hook calls.
- * It validates the commit message format.
- */
-import { readFileSync } from "node:fs";
-import { runCommitMsgValidation } from "../pre-commit-hooks.js";
-async function main() {
-    // Get commit message from the temp file (git passes it as first arg)
-    const commitMsgFile = process.argv[2];
-    if (!commitMsgFile) {
-        console.error("Usage: commit-msg <commit-message-file>");
-        process.exit(1);
-    }
-    const commitMessage = readFileSync(commitMsgFile, "utf-8").trim();
-    // Validate commit message
-    const result = runCommitMsgValidation(commitMessage);
-    if (!result.isValid) {
-        console.error("❌ FORGE Commit Message Validation Failed:\n");
-        for (const error of result.errors) {
-            console.error(`  - ${error}\n`);
-        }
-        console.error("Commit message must follow format: type(scope): description\n" +
-            "Example: feat(api-003): implement session authentication");
-        process.exit(1);
-    }
-    process.exit(0);
-}
-main().catch((error) => {
-    console.error("Commit-msg hook error:", error);
-    process.exit(1);
-});
-//# sourceMappingURL=commit-msg.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"commit-msg.js","sourceRoot":"","sources":["../../../src/git/hooks/commit-msg.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,KAAK,UAAU,IAAI;IACjB,qEAAqE;IACrE,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEtC,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,aAAa,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IAElE,0BAA0B;IAC1B,MAAM,MAAM,GAAG,sBAAsB,CAAC,aAAa,CAAC,CAAC;IAErD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QAC7D,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,KAAK,CACX,+DAA+D;YAC7D,0DAA0D,CAC7D,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/git/hooks/pre-commit.d.ts

@@ -1,8 +0,0 @@
-/**
- * Pre-commit Hook Implementation
- *
- * This is the TypeScript file that the shell hook calls.
- * It runs all pre-commit validations and blocks commits that fail.
- */
-export {};
-//# sourceMappingURL=pre-commit.d.ts.map

package/dist/git/hooks/pre-commit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pre-commit.d.ts","sourceRoot":"","sources":["../../../src/git/hooks/pre-commit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

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

@@ -1,34 +0,0 @@
-/**
- * Pre-commit Hook Implementation
- *
- * This is the TypeScript file that the shell hook calls.
- * It runs all pre-commit validations and blocks commits that fail.
- */
-import { runPreCommitValidations, loadPreCommitContext, parseTaskIdFromBranch } from "../pre-commit-hooks.js";
-async function main() {
-    // Get the task ID from the branch name
-    const taskId = await parseTaskIdFromBranch();
-    if (!taskId) {
-        // Not a FORGE branch, allow commit
-        process.exit(0);
-    }
-    // Load validation context from state
-    const context = await loadPreCommitContext(taskId);
-    // Run validations
-    const result = await runPreCommitValidations(context);
-    if (!result.isValid) {
-        console.error("❌ FORGE Pre-commit Validations Failed:\n");
-        for (const error of result.errors) {
-            console.error(`  - ${error}\n`);
-        }
-        console.error("Commit blocked. Fix the issues and try again.");
-        process.exit(1);
-    }
-    console.log("✅ FORGE Pre-commit Validations Passed.");
-    process.exit(0);
-}
-main().catch((error) => {
-    console.error("Pre-commit hook error:", error);
-    process.exit(1);
-});
-//# sourceMappingURL=pre-commit.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"pre-commit.js","sourceRoot":"","sources":["../../../src/git/hooks/pre-commit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAE9G,KAAK,UAAU,IAAI;IACjB,uCAAuC;IACvC,MAAM,MAAM,GAAG,MAAM,qBAAqB,EAAE,CAAC;IAE7C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,mCAAmC;QACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,qCAAqC;IACrC,MAAM,OAAO,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAEnD,kBAAkB;IAClB,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAEtD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,+CAA+C,CAAC,CAAC;QAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,wCAAwC,CAAC,CAAC;IACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC/C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/git/pre-commit-hooks.d.ts

@@ -1,117 +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.
- */
-export interface PreCommitContext {
-    taskId?: string;
-    allowedPaths?: string[];
-    requiredTests?: string[];
-    requiredContracts?: string[];
-}
-/**
- * Generate the pre-commit hook script.
- *
- * This shell script is installed to .git/hooks/pre-commit.
- */
-export declare function generatePreCommitScript(): string;
-/**
- * Generate the commit-msg hook script.
- *
- * This shell script is installed to .git/hooks/commit-msg.
- */
-export declare function generateCommitMsgScript(): string;
-/**
- * Install pre-commit hooks to the .git/hooks directory.
- *
- * @param basePath - Root of the FORGE project
- */
-export declare function installHooks(basePath?: string): Promise<void>;
-/**
- * Check if files are within allowed paths.
- *
- * @param files - Files to check
- * @param allowedPaths - Allowed path patterns
- * @returns Validation result
- */
-export declare function checkFileScope(files: string[], allowedPaths: string[]): {
-    isValid: boolean;
-    outOfScopeFiles: string[];
-};
-/**
- * Get staged files for a commit.
- *
- * @returns Array of staged file paths
- */
-export declare function getStagedFiles(): Promise<string[]>;
-/**
- * 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 declare function validateContracts(contracts: string[], basePath?: string): Promise<{
-    isValid: boolean;
-    errors: string[];
-}>;
-/**
- * Run tests and check if they pass.
- *
- * @param testCommands - Test commands to run (e.g., ["npm test -- --grep 'session auth'"])
- * @returns Test result
- */
-export declare function runRequiredTests(testCommands: string[]): Promise<{
-    passed: boolean;
-    output: string;
-}>;
-/**
- * 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 declare function runPreCommitValidations(context: PreCommitContext): Promise<{
-    isValid: boolean;
-    errors: string[];
-}>;
-/**
- * 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 declare function runCommitMsgValidation(message: string, expectedTaskId?: string): {
-    isValid: boolean;
-    errors: string[];
-};
-/**
- * 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 declare function loadPreCommitContext(taskId: string, basePath?: string): Promise<PreCommitContext>;
-/**
- * Parse task ID from the current branch name.
- *
- * FORGE branches use format: forge/{taskId}
- *
- * @returns Task ID or null
- */
-export declare function parseTaskIdFromBranch(): Promise<string | null>;
-//# sourceMappingURL=pre-commit-hooks.d.ts.map

package/dist/git/pre-commit-hooks.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"pre-commit-hooks.d.ts","sourceRoot":"","sources":["../../src/git/pre-commit-hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAahD;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAahD;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,QAAQ,GAAE,MAAoC,GAAG,OAAO,CAAC,IAAI,CAAC,CAehG;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG;IACvE,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B,CAuBA;AAED;;;;GAIG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAGxD;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EAAE,EACnB,QAAQ,GAAE,MAAoC,GAC7C,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwBjD;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACtE,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,CAuBD;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAqCjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EACf,cAAc,CAAC,EAAE,MAAM,GACtB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAOxC;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAoC,GAC7C,OAAO,CAAC,gBAAgB,CAAC,CAuB3B;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUpE"}