agentic-forge 0.0.0 → 0.7.0

package/dist/commands/version.d.ts

@@ -0,0 +1,3 @@
+/** Version command handler. */
+export declare function cmdVersion(): void;
+export declare function getVersion(): string;

package/dist/commands/version.js

@@ -0,0 +1,26 @@
+/** Version command handler. */
+import { readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+export function cmdVersion() {
+    try {
+        const packageJsonPath = path.join(__dirname, "..", "..", "package.json");
+        const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+        process.stdout.write(`agentic-forge ${pkg.version}\n`);
+    }
+    catch {
+        process.stdout.write("agentic-forge version unknown (package not installed)\n");
+    }
+}
+export function getVersion() {
+    try {
+        const packageJsonPath = path.join(__dirname, "..", "..", "package.json");
+        const pkg = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+        return pkg.version;
+    }
+    catch {
+        return "unknown";
+    }
+}
+//# sourceMappingURL=version.js.map

package/dist/commands/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/commands/version.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAE/B,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,UAAU,UAAU;IACzB,IAAI,CAAC;QACJ,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAwB,CAAC;QACtF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;IACxD,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;IACjF,CAAC;AACF,CAAC;AAED,MAAM,UAAU,UAAU;IACzB,IAAI,CAAC;QACJ,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QACzE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,eAAe,EAAE,OAAO,CAAC,CAAwB,CAAC;QACtF,OAAO,GAAG,CAAC,OAAO,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,SAAS,CAAC;IAClB,CAAC;AACF,CAAC"}

package/dist/commands/workflows.d.ts

@@ -0,0 +1,4 @@
+/** Workflows command handler. */
+export declare function cmdWorkflows(options: {
+    verbose?: boolean;
+}): void;

package/dist/commands/workflows.js

@@ -0,0 +1,109 @@
+/** Workflows command handler. */
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import path from "node:path";
+import yaml from "js-yaml";
+import { getBundledWorkflowsDir, getProjectWorkflowsDir, getUserWorkflowsDir } from "./run.js";
+function getWorkflowMetadata(filePath) {
+    try {
+        const content = yaml.load(readFileSync(filePath, "utf-8"));
+        if (!content || typeof content !== "object") {
+            return { name: path.basename(filePath, ".yaml"), description: "", variables: [] };
+        }
+        return {
+            name: content.name ?? path.basename(filePath, ".yaml"),
+            description: content.description ?? "",
+            variables: content.variables ?? [],
+        };
+    }
+    catch {
+        return { name: path.basename(filePath, ".yaml"), description: "", variables: [] };
+    }
+}
+function listAllWorkflows() {
+    const workflows = [];
+    const searchLocations = [
+        [getProjectWorkflowsDir(), "project"],
+        [getUserWorkflowsDir(), "user"],
+        [getBundledWorkflowsDir(), "bundled"],
+    ];
+    for (const [directory, locationType] of searchLocations) {
+        if (existsSync(directory)) {
+            const files = readdirSync(directory)
+                .filter((f) => f.endsWith(".yaml"))
+                .sort();
+            for (const file of files) {
+                const fullPath = path.join(directory, file);
+                const metadata = getWorkflowMetadata(fullPath);
+                workflows.push([path.basename(file, ".yaml"), fullPath, locationType, metadata]);
+            }
+        }
+    }
+    return workflows;
+}
+export function cmdWorkflows(options) {
+    const workflows = listAllWorkflows();
+    if (workflows.length === 0) {
+        process.stdout.write("No workflows found.\n");
+        process.stdout.write("\nSearched locations:\n");
+        process.stdout.write(`  - Project: ${getProjectWorkflowsDir()}\n`);
+        process.stdout.write(`  - User:    ${getUserWorkflowsDir()}\n`);
+        process.stdout.write(`  - Bundled: ${getBundledWorkflowsDir()}\n`);
+        process.stdout.write("\nUse 'agentic-forge init' to copy bundled workflows locally.\n");
+        return;
+    }
+    const verbose = options.verbose ?? false;
+    // Group by location
+    const byLocation = {};
+    for (const [name, wfPath, location, metadata] of workflows) {
+        if (!byLocation[location]) {
+            byLocation[location] = [];
+        }
+        byLocation[location].push([name, wfPath, metadata]);
+    }
+    process.stdout.write("Available Workflows\n");
+    process.stdout.write(`${"=".repeat(50)}\n\n`);
+    const locationOrder = ["project", "user", "bundled"];
+    const locationLabels = {
+        project: "Project",
+        user: "User",
+        bundled: "Bundled",
+    };
+    for (const location of locationOrder) {
+        if (!byLocation[location]) {
+            continue;
+        }
+        process.stdout.write(`${locationLabels[location]}:\n`);
+        for (const [name, , metadata] of byLocation[location]) {
+            let desc = metadata.description;
+            if (desc) {
+                if (desc.length > 60 && !verbose) {
+                    desc = `${desc.slice(0, 57)}...`;
+                }
+                process.stdout.write(`  ${name.padEnd(25)} ${desc}\n`);
+            }
+            else {
+                process.stdout.write(`  ${name}\n`);
+            }
+            if (verbose && metadata.variables.length > 0) {
+                const required = metadata.variables.filter((v) => v.required).map((v) => v.name);
+                const optional = metadata.variables.filter((v) => !v.required).map((v) => v.name);
+                if (required.length > 0) {
+                    process.stdout.write(`    Required: ${required.join(", ")}\n`);
+                }
+                if (optional.length > 0) {
+                    process.stdout.write(`    Optional: ${optional.join(", ")}\n`);
+                }
+            }
+        }
+        process.stdout.write("\n");
+    }
+    process.stdout.write(`Total: ${workflows.length} workflow(s)\n\n`);
+    process.stdout.write("Usage:\n");
+    process.stdout.write("  agentic-forge run <workflow-name>\n");
+    process.stdout.write("  agentic-forge run <workflow-name> --var key=value\n\n");
+    process.stdout.write("Examples:\n");
+    process.stdout.write('  agentic-forge run one-shot --var task="Add login button"\n');
+    process.stdout.write("  agentic-forge run analyze-single --var analysis_type=bug\n");
+    process.stdout.write('  agentic-forge run plan-build-review --var task="Refactor auth"\n');
+}
+//# sourceMappingURL=workflows.js.map

package/dist/commands/workflows.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,8 @@
+/** Configuration management for agentic-forge. */
+export declare function getConfigPath(repoRoot?: string): string;
+export declare function getDefaultConfig(): Record<string, unknown>;
+export declare function loadConfig(repoRoot?: string): Record<string, unknown>;
+export declare function saveConfig(config: Record<string, unknown>, repoRoot?: string): void;
+export declare function getConfigValue(key: string, repoRoot?: string): unknown;
+export declare function setConfigValue(key: string, value: string, repoRoot?: string): void;
+export declare function deepMerge(base: Record<string, unknown>, override: Record<string, unknown>): Record<string, unknown>;

package/dist/config.js

@@ -0,0 +1,110 @@
+/** Configuration management for agentic-forge. */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+const DEFAULT_CONFIG = {
+    outputDirectory: "agentic",
+    logging: {
+        enabled: true,
+        level: "Error",
+    },
+    git: {
+        mainBranch: "main",
+        autoCommit: true,
+        autoPr: true,
+    },
+    defaults: {
+        model: "sonnet",
+        maxRetry: 3,
+        timeoutMinutes: 60,
+        trackProgress: true,
+        terminalOutput: "base",
+    },
+    execution: {
+        maxWorkers: 4,
+        pollingIntervalSeconds: 5,
+    },
+};
+export function getConfigPath(repoRoot) {
+    const root = repoRoot ?? process.cwd();
+    return path.join(root, "agentic", "config.json");
+}
+export function getDefaultConfig() {
+    return deepCopy(DEFAULT_CONFIG);
+}
+export function loadConfig(repoRoot) {
+    const configPath = getConfigPath(repoRoot);
+    if (existsSync(configPath)) {
+        const content = readFileSync(configPath, "utf-8");
+        const userConfig = JSON.parse(content);
+        return deepMerge(getDefaultConfig(), userConfig);
+    }
+    return getDefaultConfig();
+}
+export function saveConfig(config, repoRoot) {
+    const configPath = getConfigPath(repoRoot);
+    const dir = path.dirname(configPath);
+    mkdirSync(dir, { recursive: true });
+    writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+}
+export function getConfigValue(key, repoRoot) {
+    const config = loadConfig(repoRoot);
+    const parts = key.split(".");
+    let value = config;
+    for (const part of parts) {
+        if (value !== null &&
+            typeof value === "object" &&
+            !Array.isArray(value) &&
+            part in value) {
+            value = value[part];
+        }
+        else {
+            return null;
+        }
+    }
+    return value;
+}
+export function setConfigValue(key, value, repoRoot) {
+    const config = loadConfig(repoRoot);
+    const parts = key.split(".");
+    let target = config;
+    for (const part of parts.slice(0, -1)) {
+        if (!(part in target)) {
+            target[part] = {};
+        }
+        target = target[part];
+    }
+    let parsedValue = value;
+    if (value.toLowerCase() === "true") {
+        parsedValue = true;
+    }
+    else if (value.toLowerCase() === "false") {
+        parsedValue = false;
+    }
+    else if (/^\d+$/.test(value)) {
+        parsedValue = Number.parseInt(value, 10);
+    }
+    target[parts[parts.length - 1]] = parsedValue;
+    saveConfig(config, repoRoot);
+}
+export function deepMerge(base, override) {
+    const result = { ...base };
+    for (const key of Object.keys(override)) {
+        if (key in result &&
+            typeof result[key] === "object" &&
+            result[key] !== null &&
+            !Array.isArray(result[key]) &&
+            typeof override[key] === "object" &&
+            override[key] !== null &&
+            !Array.isArray(override[key])) {
+            result[key] = deepMerge(result[key], override[key]);
+        }
+        else {
+            result[key] = override[key];
+        }
+    }
+    return result;
+}
+function deepCopy(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/console.d.ts

@@ -0,0 +1,103 @@
+/** Console output utilities for workflow execution. */
+import type { Writable } from "node:stream";
+export declare const OutputLevel: {
+    readonly BASE: "base";
+    readonly ALL: "all";
+};
+export type OutputLevel = (typeof OutputLevel)[keyof typeof OutputLevel];
+export declare const Color: {
+    readonly RESET: "\u001B[0m";
+    readonly BOLD: "\u001B[1m";
+    readonly DIM: "\u001B[2m";
+    readonly RED: "\u001B[31m";
+    readonly GREEN: "\u001B[32m";
+    readonly YELLOW: "\u001B[33m";
+    readonly BLUE: "\u001B[34m";
+    readonly MAGENTA: "\u001B[35m";
+    readonly CYAN: "\u001B[36m";
+    readonly WHITE: "\u001B[37m";
+    readonly BRIGHT_RED: "\u001B[91m";
+    readonly BRIGHT_GREEN: "\u001B[92m";
+    readonly BRIGHT_YELLOW: "\u001B[93m";
+    readonly BRIGHT_BLUE: "\u001B[94m";
+    readonly BRIGHT_CYAN: "\u001B[96m";
+};
+export type Color = (typeof Color)[keyof typeof Color];
+export declare function supportsColor(): boolean;
+export declare function colorize(text: string, ...colors: Color[]): string;
+/** Callback to format a model name for display, avoiding circular imports with runner.ts. */
+type ModelFormatter = (model: string) => string | null;
+export declare class ParallelOutputHandler {
+    stream: Writable;
+    level: OutputLevel;
+    private printFn;
+    private branches;
+    private branchIndex;
+    private branchDone;
+    private deferredMessages;
+    private linesPerBranch;
+    private active;
+    private currentBranch;
+    private accumulatedText;
+    private accumulatedRole;
+    private accumulatedModel;
+    private baseAccumulatedText;
+    private messageQueue;
+    constructor(stream?: Writable, level?: OutputLevel, printFn?: (message: string) => void);
+    private print;
+    get isActive(): boolean;
+    get hasBranches(): boolean;
+    registerBranches(branches: string[]): void;
+    updateBranchLine(branch: string, text: string, maxWidth?: number): void;
+    markBranchDone(branch: string, success?: boolean): void;
+    private clearDisplay;
+    enter(): void;
+    exit(): void;
+    deferMessage(message: string): void;
+    setBranch(branchName: string): void;
+    getCurrentBranch(): string | null;
+    enqueueCurrentMessage(): void;
+    private printBranchMessage;
+    accumulateText(text: string, role: string, model?: string | null): void;
+    accumulateBaseText(text: string): string;
+}
+export declare class ConsoleOutput {
+    level: OutputLevel;
+    stream: Writable;
+    _baseAccumulatedText: string;
+    private baseLastDisplayLines;
+    _parallelHandler: ParallelOutputHandler;
+    private formatModelName;
+    constructor(level?: OutputLevel, stream?: Writable);
+    /** Set model name formatter to avoid circular imports with runner. */
+    setModelFormatter(fn: ModelFormatter): void;
+    private printLine;
+    private printInplace;
+    private clearInplace;
+    registerParallelBranches(branches: string[]): void;
+    enterParallelMode(): void;
+    exitParallelMode(): void;
+    setParallelBranch(branchName: string): void;
+    markParallelBranchDone(branch: string, success?: boolean): void;
+    private isParallelMode;
+    private shouldDeferMessage;
+    private deferMessage;
+    workflowStart(workflowName: string, workflowId: string): void;
+    workflowComplete(workflowName: string, status: string): void;
+    stepStart(stepName: string, stepType?: string | null, model?: string | null): void;
+    stepComplete(stepName: string, summary?: string | null): void;
+    stepFailed(stepName: string, error?: string | null): void;
+    stepRetry(stepName: string, attempt: number, maxAttempts: number, error?: string | null): void;
+    ralphIterationStart(stepName: string, iteration: number, maxIterations: number): void;
+    ralphIteration(_stepName: string, _iteration: number, _maxIterations: number, summary?: string | null): void;
+    ralphComplete(stepName: string, iteration: number, maxIterations: number): void;
+    ralphMaxIterations(stepName: string, maxIterations: number): void;
+    info(message: string): void;
+    warning(message: string): void;
+    error(message: string): void;
+    streamText(text: string, role?: string, model?: string | null): void;
+    streamComplete(): void;
+}
+export declare function extractJson(output: string): Record<string, unknown> | null;
+export declare function extractSummary(output: string, maxLines?: number, maxChars?: number): string;
+export {};