@amsterdamdatalabs/enact-factory 0.1.1

package/dist/adapters/tools.js

@@ -0,0 +1,219 @@
+// ============================================
+// EnactFactory - Agentic Tool Definitions & Executor
+// Created: 2026-04-11
+// Purpose: HTTP adapters get a Claude-like tool surface
+//          공통 도구 정의 + 실행기 제공
+// ============================================
+import fs from 'node:fs/promises';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import path from 'node:path';
+const execFileAsync = promisify(execFile);
+export const TOOL_DEFINITIONS = [
+    {
+        type: 'function',
+        function: {
+            name: 'read_file',
+            description: 'Read a file and return its content. Use offset/limit for large files.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'Absolute file path to read' },
+                    offset: { type: 'number', description: 'Start line (0-based). Default: 0' },
+                    limit: { type: 'number', description: 'Max lines to read. Default: 500' },
+                },
+                required: ['path'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'write_file',
+            description: 'Write content to a file (creates or overwrites).',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'Absolute file path' },
+                    content: { type: 'string', description: 'File content to write' },
+                },
+                required: ['path', 'content'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'edit_file',
+            description: 'Replace a specific string in a file. old_string must be unique in the file.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    path: { type: 'string', description: 'Absolute file path' },
+                    old_string: { type: 'string', description: 'Exact string to find and replace' },
+                    new_string: { type: 'string', description: 'Replacement string' },
+                },
+                required: ['path', 'old_string', 'new_string'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'search_files',
+            description: 'Search file contents using ripgrep (regex). Returns matching lines with file paths and line numbers.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    pattern: { type: 'string', description: 'Regex pattern to search for' },
+                    path: { type: 'string', description: 'Directory or file to search in' },
+                    glob: { type: 'string', description: 'File glob filter (e.g., "*.ts")' },
+                },
+                required: ['pattern', 'path'],
+            },
+        },
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'bash',
+            description: 'Execute a shell command and return stdout/stderr. Timeout: 30s. Destructive commands (rm -rf, git reset --hard) are blocked.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    command: { type: 'string', description: 'Shell command to execute' },
+                },
+                required: ['command'],
+            },
+        },
+    },
+];
+// ============ 안전 가드 ============
+const BLOCKED_COMMANDS = [
+    /\brm\s+(-[rR]f?|--recursive)\b/,
+    /\bgit\s+reset\s+--hard\b/,
+    /\bgit\s+clean\s+-fd\b/,
+    /\bdrop\s+database\b/i,
+    /\btruncate\s+table\b/i,
+    /\bchmod\s+777\b/,
+    /\bchown\s+-R\b/,
+    />\s*\/dev\/sd/,
+    /\bdd\s+if=/,
+    /\bpkill\s+-9\b/,
+    /\bkill\s+-9\b/,
+];
+function isCommandBlocked(command) {
+    return BLOCKED_COMMANDS.some(pattern => pattern.test(command));
+}
+/** 프로젝트 경로 내로 접근을 제한하는 경로 검증 */
+function validatePath(filePath, cwd) {
+    const resolved = path.resolve(cwd, filePath);
+    // cwd 하위이거나, /tmp 하위만 허용
+    if (!resolved.startsWith(cwd) && !resolved.startsWith('/tmp')) {
+        throw new Error(`Path outside project: ${resolved} (cwd: ${cwd})`);
+    }
+    return resolved;
+}
+/**
+ * 단일 도구 호출 실행
+ */
+export async function executeTool(toolCall, cwd) {
+    const { name, arguments: argsJson } = toolCall.function;
+    const callId = toolCall.id;
+    try {
+        const args = JSON.parse(argsJson);
+        switch (name) {
+            case 'read_file': {
+                const filePath = validatePath(args.path, cwd);
+                const content = await fs.readFile(filePath, 'utf-8');
+                const lines = content.split('\n');
+                const offset = args.offset ?? 0;
+                const limit = args.limit ?? 500;
+                const slice = lines.slice(offset, offset + limit);
+                const numbered = slice.map((line, i) => `${offset + i + 1}\t${line}`).join('\n');
+                const truncated = lines.length > offset + limit
+                    ? `\n... (${lines.length - offset - limit} more lines)`
+                    : '';
+                return { tool_call_id: callId, content: numbered + truncated, is_error: false };
+            }
+            case 'write_file': {
+                const filePath = validatePath(args.path, cwd);
+                // 디렉토리 자동 생성
+                await fs.mkdir(path.dirname(filePath), { recursive: true });
+                await fs.writeFile(filePath, args.content, 'utf-8');
+                return { tool_call_id: callId, content: `Written: ${filePath}`, is_error: false };
+            }
+            case 'edit_file': {
+                const filePath = validatePath(args.path, cwd);
+                const original = await fs.readFile(filePath, 'utf-8');
+                const occurrences = original.split(args.old_string).length - 1;
+                if (occurrences === 0) {
+                    return { tool_call_id: callId, content: `old_string not found in ${filePath}`, is_error: true };
+                }
+                if (occurrences > 1) {
+                    return { tool_call_id: callId, content: `old_string found ${occurrences} times — must be unique. Provide more context.`, is_error: true };
+                }
+                const updated = original.replace(args.old_string, args.new_string);
+                await fs.writeFile(filePath, updated, 'utf-8');
+                return { tool_call_id: callId, content: `Edited: ${filePath}`, is_error: false };
+            }
+            case 'search_files': {
+                const searchPath = validatePath(args.path, cwd);
+                const rgArgs = ['--no-heading', '--line-number', '--max-count', '50'];
+                if (args.glob) {
+                    rgArgs.push('--glob', args.glob);
+                }
+                rgArgs.push(args.pattern, searchPath);
+                try {
+                    const { stdout } = await execFileAsync('rg', rgArgs, { timeout: 10000, maxBuffer: 1024 * 256 });
+                    return { tool_call_id: callId, content: stdout || '(no matches)', is_error: false };
+                }
+                catch (err) {
+                    // rg exit code 1 = no matches
+                    if (err && typeof err === 'object' && 'code' in err && err.code === 1) {
+                        return { tool_call_id: callId, content: '(no matches)', is_error: false };
+                    }
+                    throw err;
+                }
+            }
+            case 'bash': {
+                const command = args.command;
+                if (isCommandBlocked(command)) {
+                    return { tool_call_id: callId, content: `BLOCKED: destructive command not allowed: ${command}`, is_error: true };
+                }
+                try {
+                    const { stdout, stderr } = await execFileAsync('bash', ['-c', command], {
+                        cwd,
+                        timeout: 30000,
+                        maxBuffer: 1024 * 512,
+                        env: process.env,
+                    });
+                    const output = stdout + (stderr ? `\n[stderr] ${stderr}` : '');
+                    // 출력이 너무 길면 잘라냄
+                    return {
+                        tool_call_id: callId,
+                        content: output.length > 8000 ? output.slice(0, 8000) + '\n... (truncated)' : output,
+                        is_error: false,
+                    };
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    return { tool_call_id: callId, content: `Command failed: ${msg.slice(0, 2000)}`, is_error: true };
+                }
+            }
+            default:
+                return { tool_call_id: callId, content: `Unknown tool: ${name}`, is_error: true };
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { tool_call_id: callId, content: `Tool error: ${msg}`, is_error: true };
+    }
+}
+/**
+ * 여러 도구 호출을 병렬 실행
+ */
+export async function executeToolCalls(toolCalls, cwd) {
+    return Promise.all(toolCalls.map(tc => executeTool(tc, cwd)));
+}
+//# sourceMappingURL=tools.js.map

package/dist/adapters/tools.js.map

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

package/dist/adapters/types.d.ts

@@ -0,0 +1,82 @@
+import type { ExecutorResult, ReviewResult } from '../agents/agentPair.js';
+export type { ExecutorResult, ReviewResult };
+export type AdapterName = 'claude' | 'codex' | 'responses' | 'cursor' | 'hermes' | 'opencode';
+/**
+ * Raw result from a CLI process execution
+ */
+export interface CliRunResult {
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    durationMs: number;
+    /** Session identity supplied by HTTP adapters (e.g. ResponsesApiAdapter) in lieu of a PID. */
+    sessionId?: string;
+}
+/**
+ * Context for process registry tracking
+ */
+export interface ProcessContext {
+    workItemId: string;
+    stage: string;
+}
+/**
+ * Options for running a CLI adapter
+ */
+export interface CliRunOptions {
+    prompt: string;
+    cwd: string;
+    timeoutMs?: number;
+    model?: string;
+    maxTurns?: number;
+    onLog?: (line: string) => void;
+    processContext?: ProcessContext;
+    /**
+     * Explicit opt-out from process-identity tracking. Set to `true` only for
+     * support agents (auditor, tester, documenter, draftAnalyzer, skillDocumenter)
+     * that run outside a tracked assignment context. Prevents the fail-closed
+     * guard in spawnCli from throwing. Must not be used to bypass tracking for
+     * primary executor/reviewer spawns.
+     */
+    untracked?: true;
+    /** 시스템 프롬프트 (Responses adapter may use this directly) */
+    systemPrompt?: string;
+}
+/**
+ * Describes what a CLI adapter can do
+ */
+export interface AdapterCapabilities {
+    supportsStreaming: boolean;
+    supportsJsonOutput: boolean;
+    supportsModelSelection: boolean;
+    managedGit: boolean;
+    supportedSkills: string[];
+}
+/**
+ * CLI adapter interface — all adapters must implement this
+ */
+export interface CliAdapter {
+    readonly name: string;
+    readonly capabilities: AdapterCapabilities;
+    /** Check if the CLI tool is installed and available */
+    isAvailable(): Promise<boolean>;
+    /** Build the shell command and args for execution */
+    buildCommand(options: CliRunOptions): {
+        command: string;
+        args: string[];
+    };
+    /**
+     * Parse incremental stdout chunks for live log streaming.
+     * Returns the trailing incomplete buffer to carry into the next chunk.
+     */
+    parseStreamingChunk?(chunk: string, onLog: (line: string) => void, buffer?: string): string;
+    /**
+     * Optional direct execution (bypasses spawnCli shell spawn).
+     * Used by adapters that call APIs directly instead of spawning a CLI process.
+     */
+    run?(options: CliRunOptions): Promise<CliRunResult>;
+    /** Parse raw CLI output into a ExecutorResult */
+    parseExecutorOutput(raw: CliRunResult): ExecutorResult;
+    /** Parse raw CLI output into a ReviewResult */
+    parseReviewerOutput(raw: CliRunResult): ReviewResult;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAG1E,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC;AAE7C,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,8FAA8F;IAC9F,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,yDAAyD;IACzD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sBAAsB,EAAE,OAAO,CAAC;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAE3C,uDAAuD;IACvD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhC,qDAAqD;IACrD,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAE1E;;;OAGG;IACH,mBAAmB,CAAC,CAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,MAAM,CAAC;IAEV;;;OAGG;IACH,GAAG,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEpD,iDAAiD;IACjD,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,cAAc,CAAC;IAEvD,+CAA+C;IAC/C,mBAAmB,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY,CAAC;CACtD"}

package/dist/adapters/types.js

@@ -0,0 +1,6 @@
+// ============================================
+// EnactFactory - CLI Adapter Types
+// Interface definitions for CLI tool adapters
+// ============================================
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapters/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapters/types.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,mCAAmC;AACnC,8CAA8C;AAC9C,+CAA+C"}

package/dist/agents/agentBus.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Message type
+ */
+export type MessageType = 'step_started' | 'step_completed' | 'step_failed' | 'context_update' | 'file_changed' | 'error' | 'log' | 'request' | 'response';
+/**
+ * Agent message
+ */
+export interface AgentMessage {
+    id: string;
+    timestamp: number;
+    type: MessageType;
+    sender: string;
+    recipient?: string;
+    executionId: string;
+    payload: unknown;
+}
+/**
+ * Step completed message payload
+ */
+export interface StepCompletedPayload {
+    stepId: string;
+    success: boolean;
+    output: string;
+    changedFiles: string[];
+    duration: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Context update payload
+ */
+export interface ContextUpdatePayload {
+    key: string;
+    value: unknown;
+    operation: 'set' | 'append' | 'delete';
+}
+/**
+ * File changed payload
+ */
+export interface FileChangedPayload {
+    path: string;
+    action: 'created' | 'modified' | 'deleted';
+    diff?: string;
+}
+/**
+ * Shared context
+ */
+export interface SharedContext {
+    executionId: string;
+    workflowId: string;
+    startedAt: number;
+    stepOutputs: Record<string, string>;
+    changedFiles: string[];
+    errors: Array<{
+        stepId: string;
+        message: string;
+        timestamp: number;
+    }>;
+    data: Record<string, unknown>;
+}
+/**
+ * Message bus class
+ */
+export declare class AgentBus {
+    private executionId;
+    private contextPath;
+    private messagesPath;
+    private listeners;
+    private pollInterval;
+    private lastMessageId;
+    constructor(executionId: string);
+    /**
+     * Initialize bus
+     */
+    init(workflowId: string): Promise<void>;
+    /**
+     * Publish message
+     */
+    publish(type: MessageType, sender: string, payload: unknown, recipient?: string): Promise<string>;
+    /**
+     * Handle step completion
+     */
+    private handleStepCompleted;
+    /**
+     * Handle context update
+     */
+    private handleContextUpdate;
+    /**
+     * Handle file change
+     */
+    private handleFileChanged;
+    /**
+     * Handle error
+     */
+    private handleError;
+    /**
+     * Get context
+     */
+    getContext(): Promise<SharedContext | null>;
+    /**
+     * Save context
+     */
+    private saveContext;
+    /**
+     * Get output from specific step
+     */
+    getStepOutput(stepId: string): Promise<string | null>;
+    /**
+     * Get all changed files
+     */
+    getChangedFiles(): Promise<string[]>;
+    /**
+     * Get custom data
+     */
+    getData<T>(key: string): Promise<T | null>;
+    /**
+     * Set custom data
+     */
+    setData(key: string, value: unknown): Promise<void>;
+    /**
+     * Register message listener
+     */
+    on(type: MessageType, callback: (msg: AgentMessage) => void): void;
+    /**
+     * Start polling (detect new messages)
+     */
+    startPolling(intervalMs?: number): void;
+    /**
+     * Stop polling
+     */
+    stopPolling(): void;
+    /**
+     * Check for new messages
+     */
+    private checkNewMessages;
+    /**
+     * Get all messages
+     */
+    getAllMessages(): Promise<AgentMessage[]>;
+    /**
+     * Create step context (including previous step results)
+     */
+    createStepContext(stepId: string, dependsOn?: string[]): Promise<string>;
+    /**
+     * Clean up bus
+     */
+    cleanup(): Promise<void>;
+}
+/**
+ * Create new bus instance
+ */
+export declare function createBus(executionId?: string): AgentBus;
+/**
+ * Connect to existing bus
+ */
+export declare function connectToBus(executionId: string): Promise<AgentBus | null>;
+/**
+ * List active buses
+ */
+export declare function listActiveBuses(): Promise<string[]>;
+//# sourceMappingURL=agentBus.d.ts.map

package/dist/agents/agentBus.d.ts.map

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