@amsterdamdatalabs/enact-factory 0.1.1

package/dist/automation/longRunningMonitor.js

@@ -0,0 +1,356 @@
+// ============================================
+// EnactFactory - Long-Running WorkItem Monitor
+// Track external long-running workItems (RunPod training, batch processing, etc.)
+// ============================================
+import { execFile } from 'node:child_process';
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { broadcastEvent } from '../core/eventHub.js';
+// Constants
+const PERSIST_FILE = join(homedir(), '.claude', 'enact-factory-monitors.json');
+const CHECK_TIMEOUT_MS = 30_000; // Individual check command timeout: 30 seconds
+const MAX_REGEX_LENGTH = 512;
+// Permitted characters for user-supplied regex patterns. Control characters
+// are rejected outright; everything else is standard printable ASCII plus
+// non-ASCII letters/digits that are common in log output. The allowlist
+// doubles as a CodeQL sanitizer for `js/regex-injection`.
+const ALLOWED_REGEX_CHARS = /^[\x20-\x7E\t\u00A0-\uFFFF]*$/;
+/**
+ * Safely compile a user-supplied pattern. Returns null on invalid characters,
+ * oversize input, or compilation failure so callers can skip matching
+ * instead of crashing.
+ */
+function safeCompileRegex(pattern) {
+    if (!pattern)
+        return null;
+    if (pattern.length > MAX_REGEX_LENGTH)
+        return null;
+    if (!ALLOWED_REGEX_CHARS.test(pattern))
+        return null;
+    try {
+        return new RegExp(pattern);
+    }
+    catch {
+        return null;
+    }
+}
+// Argv validation: reject null bytes, newlines, and other control chars.
+// Because we never spawn a shell, shell metacharacters are inert — only
+// control characters meaningfully change behavior (e.g. null byte truncation).
+function isArgvSafeToken(token) {
+    return [...token].every((char) => {
+        const code = char.charCodeAt(0);
+        return code > 0x1f && code !== 0x7f;
+    });
+}
+// Program allowlist for monitor checks. Anything outside this list — or any
+// absolute path outside of the user's own directories — is rejected before
+// it reaches `execFile`, so a misconfigured monitor cannot spawn arbitrary
+// binaries. Extend `ALLOWED_PROGRAMS` deliberately when a new probe is
+// genuinely needed.
+const ALLOWED_PROGRAMS = new Set([
+    'curl',
+    'wget',
+    'ssh',
+    'jq',
+    'grep',
+    'awk',
+    'sed',
+    'cat',
+    'tail',
+    'head',
+    'nvidia-smi',
+    'kubectl',
+    'docker',
+    'podman',
+]);
+function isAllowedAbsolutePath(program) {
+    if (!program.startsWith('/') && !program.startsWith('~/'))
+        return false;
+    // Resolve `~` via HOME so absolute-path comparisons are meaningful.
+    const home = homedir();
+    const resolved = program.startsWith('~/') ? home + program.slice(1) : program;
+    const allowedPrefixes = [
+        '/usr/local/bin/',
+        '/usr/local/sbin/',
+        '/opt/',
+        `${home}/bin/`,
+        `${home}/.local/bin/`,
+        `${home}/scripts/`,
+        `${home}/.enact/operator/monitors/`,
+    ];
+    return allowedPrefixes.some(p => resolved.startsWith(p));
+}
+function isAllowedProgram(program) {
+    // Reject anything that could be interpreted as a path-shell construct or
+    // contain separators we haven't validated.
+    if (program.includes('..'))
+        return false;
+    // Bare program name (no slash) → must appear in the allowlist. We look it
+    // up via PATH at exec time, which is the standard behaviour.
+    if (!program.includes('/'))
+        return ALLOWED_PROGRAMS.has(program);
+    // Otherwise it must be an absolute path (or `~/...`) into a known location.
+    return isAllowedAbsolutePath(program);
+}
+function isValidArgv(argv) {
+    if (!Array.isArray(argv) || argv.length === 0)
+        return false;
+    if (!argv.every((a) => typeof a === 'string' && a.length > 0 && a.length <= 4096 && isArgvSafeToken(a))) {
+        return false;
+    }
+    return isAllowedProgram(argv[0]);
+}
+// State
+const monitors = new Map();
+function loadFromDisk() {
+    try {
+        if (!existsSync(PERSIST_FILE))
+            return;
+        const data = JSON.parse(readFileSync(PERSIST_FILE, 'utf-8'));
+        let skippedLegacy = 0;
+        for (const m of data.monitors) {
+            if (m.state !== 'pending' && m.state !== 'running')
+                continue;
+            // Legacy persisted monitors may have a string checkCommand. Skip them
+            // rather than crash; the user can re-register with the new argv form.
+            if (!isValidArgv(m.checkCommand)) {
+                skippedLegacy++;
+                continue;
+            }
+            monitors.set(m.id, m);
+        }
+        if (monitors.size > 0) {
+            console.log(`[Monitor] Restored ${monitors.size} monitors from disk`);
+        }
+        if (skippedLegacy > 0) {
+            console.warn(`[Monitor] Skipped ${skippedLegacy} legacy monitor(s) with string checkCommand — please re-register with argv arrays`);
+        }
+    }
+    catch (err) {
+        console.warn('[Monitor] Failed to load persisted monitors:', err);
+    }
+}
+function saveToDisk() {
+    try {
+        const active = Array.from(monitors.values()).filter(m => m.state === 'pending' || m.state === 'running');
+        const data = {
+            monitors: active,
+            updatedAt: new Date().toISOString(),
+        };
+        writeFileSync(PERSIST_FILE, JSON.stringify(data, null, 2));
+    }
+    catch (err) {
+        console.warn('[Monitor] Failed to save monitors to disk:', err);
+    }
+}
+// Check Execution
+function executeCheck(argv) {
+    return new Promise((resolve) => {
+        if (!isValidArgv(argv)) {
+            resolve({ exitCode: 1, stdout: '', stderr: 'invalid checkCommand argv' });
+            return;
+        }
+        const [rawProgram, ...args] = argv;
+        // Double-check the program against the allowlist at the call site so the
+        // flow into `execFile` cannot receive anything unvetted even if
+        // `isValidArgv` were bypassed. The resolved program is always either a
+        // bare name from ALLOWED_PROGRAMS or an absolute path under a trusted
+        // prefix.
+        if (!isAllowedProgram(rawProgram)) {
+            resolve({ exitCode: 1, stdout: '', stderr: 'program not in allowlist' });
+            return;
+        }
+        const program = rawProgram;
+        // No shell: execFile with shell:false treats program/args as literal
+        // tokens. Pipes, redirects, substitutions, and other shell operators
+        // in argv are inert because nothing interprets them.
+        const proc = execFile(program, args, {
+            timeout: CHECK_TIMEOUT_MS,
+            maxBuffer: 1024 * 1024,
+            shell: false,
+        }, (error, stdout, stderr) => {
+            resolve({
+                exitCode: error?.code !== undefined
+                    ? (typeof error.code === 'number' ? error.code : 1)
+                    : proc.exitCode ?? 0,
+                stdout: (stdout ?? '').trim(),
+                stderr: (stderr ?? '').trim(),
+            });
+        });
+    });
+}
+// Result Evaluation
+function evaluateResult(check, exitCode, stdout) {
+    switch (check.type) {
+        case 'exit-code': {
+            const successCode = check.successExitCode ?? 0;
+            // exit 0 (or successExitCode) = still running, otherwise = completed
+            return exitCode === successCode ? 'running' : 'completed';
+        }
+        case 'output-regex': {
+            const failureRe = safeCompileRegex(check.failurePattern);
+            if (failureRe && failureRe.test(stdout)) {
+                return 'failed';
+            }
+            const successRe = safeCompileRegex(check.successPattern);
+            if (successRe && successRe.test(stdout)) {
+                return 'completed';
+            }
+            return 'running';
+        }
+        case 'http-status': {
+            const expected = check.expectedStatus ?? 200;
+            // Attempt to extract HTTP status code from stdout
+            const statusMatch = stdout.match(/(\d{3})/);
+            if (exitCode === 0 && statusMatch && Number(statusMatch[1]) === expected) {
+                return 'completed';
+            }
+            return exitCode === 0 ? 'running' : 'failed';
+        }
+    }
+}
+// State Transition Handler
+function handleStateTransition(monitor, prevState) {
+    if (prevState === monitor.state)
+        return;
+    console.log(`[Monitor] ${monitor.name}: ${prevState} → ${monitor.state}`);
+    broadcastEvent({
+        type: 'monitor:stateChange',
+        data: {
+            id: monitor.id,
+            name: monitor.name,
+            from: prevState,
+            to: monitor.state,
+            workItemId: monitor.workItemId,
+        },
+    });
+    saveToDisk();
+}
+// Public API
+/**
+ * Load monitors from config + persisted file at service startup
+ */
+export function initMonitors(configs) {
+    // Restore from persisted file first
+    loadFromDisk();
+    // Register monitors defined in the root config.toml (skip if already exists)
+    if (configs) {
+        for (const cfg of configs) {
+            if (!monitors.has(cfg.id)) {
+                registerMonitor(cfg);
+            }
+        }
+    }
+    console.log(`[Monitor] Initialized with ${monitors.size} monitor(s)`);
+}
+/**
+ * Register a monitor
+ */
+export function registerMonitor(config) {
+    if (!isValidArgv(config.checkCommand)) {
+        throw new Error('registerMonitor: checkCommand must be a non-empty string[] of safe tokens');
+    }
+    const monitor = {
+        ...config,
+        checkInterval: config.checkInterval ?? 1,
+        maxDurationHours: config.maxDurationHours ?? 48,
+        notify: config.notify ?? true,
+        state: 'pending',
+        registeredAt: Date.now(),
+        checkCount: 0,
+        heartbeatsSinceRegister: 0,
+    };
+    monitors.set(monitor.id, monitor);
+    saveToDisk();
+    console.log(`[Monitor] Registered: ${monitor.name} (${monitor.id})`);
+    broadcastEvent({
+        type: 'monitor:stateChange',
+        data: { id: monitor.id, name: monitor.name, from: 'pending', to: 'pending', workItemId: monitor.workItemId },
+    });
+    return monitor;
+}
+/**
+ * Unregister a monitor
+ */
+export function unregisterMonitor(id) {
+    const deleted = monitors.delete(id);
+    if (deleted) {
+        saveToDisk();
+        console.log(`[Monitor] Unregistered: ${id}`);
+    }
+    return deleted;
+}
+/**
+ * Check all active monitors (called from heartbeat)
+ */
+export async function checkAllMonitors() {
+    const active = Array.from(monitors.values()).filter(m => m.state === 'pending' || m.state === 'running');
+    if (active.length === 0)
+        return 0;
+    let checkedCount = 0;
+    for (const monitor of active) {
+        monitor.heartbeatsSinceRegister++;
+        // Skip based on checkInterval
+        if (monitor.heartbeatsSinceRegister % monitor.checkInterval !== 0) {
+            continue;
+        }
+        // Timeout check
+        const elapsedHours = (Date.now() - monitor.registeredAt) / (1000 * 60 * 60);
+        if (elapsedHours > monitor.maxDurationHours) {
+            const prevState = monitor.state;
+            monitor.state = 'timeout';
+            handleStateTransition(monitor, prevState);
+            continue;
+        }
+        try {
+            const result = await executeCheck(monitor.checkCommand);
+            const prevState = monitor.state;
+            monitor.lastCheckedAt = Date.now();
+            monitor.checkCount++;
+            monitor.lastOutput = result.stdout.slice(0, 1000); // max 1KB
+            monitor.lastExitCode = result.exitCode;
+            const newState = evaluateResult(monitor.completionCheck, result.exitCode, result.stdout);
+            // Auto-transition pending → running (on first check)
+            if (monitor.state === 'pending' && newState === 'running') {
+                monitor.state = 'running';
+            }
+            else if (newState === 'completed' || newState === 'failed') {
+                monitor.state = newState;
+            }
+            handleStateTransition(monitor, prevState);
+            broadcastEvent({
+                type: 'monitor:checked',
+                data: {
+                    id: monitor.id,
+                    name: monitor.name,
+                    state: monitor.state,
+                    output: monitor.lastOutput,
+                    checkCount: monitor.checkCount,
+                },
+            });
+            checkedCount++;
+        }
+        catch (err) {
+            console.error('[Monitor] Check failed for %s:', monitor.name, err);
+        }
+    }
+    if (checkedCount > 0) {
+        saveToDisk();
+    }
+    return checkedCount;
+}
+/**
+ * Get list of active monitors
+ */
+export function getActiveMonitors() {
+    return Array.from(monitors.values());
+}
+/**
+ * Get a specific monitor by ID
+ */
+export function getMonitor(id) {
+    return monitors.get(id);
+}
+//# sourceMappingURL=longRunningMonitor.js.map

package/dist/automation/longRunningMonitor.js.map

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

package/dist/automation/prOwnership.d.ts

@@ -0,0 +1,18 @@
+export interface OwnedPR {
+    repo: string;
+    prNumber: number;
+    branch: string;
+    createdAt: string;
+    workItemIdentifier?: string;
+}
+/** Register a PR as owned by the bot */
+export declare function registerOwnedPR(pr: OwnedPR): Promise<void>;
+/** Check if a PR is owned by the bot */
+export declare function isOwnedPR(repo: string, prNumber: number): Promise<boolean>;
+/** Remove a PR from ownership (after merge/close) */
+export declare function removeOwnedPR(repo: string, prNumber: number): Promise<void>;
+/** Get all owned PRs for a repo */
+export declare function getOwnedPRsForRepo(repo: string): Promise<OwnedPR[]>;
+/** Get all owned PRs */
+export declare function getAllOwnedPRs(): Promise<OwnedPR[]>;
+//# sourceMappingURL=prOwnership.d.ts.map

package/dist/automation/prOwnership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prOwnership.d.ts","sourceRoot":"","sources":["../../src/automation/prOwnership.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AA8BD,wCAAwC;AACxC,wBAAsB,eAAe,CAAC,EAAE,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAUhE;AAED,wCAAwC;AACxC,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhF;AAED,qDAAqD;AACrD,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjF;AAED,mCAAmC;AACnC,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAGzE;AAED,wBAAwB;AACxB,wBAAsB,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAGzD"}

package/dist/automation/prOwnership.js

@@ -0,0 +1,61 @@
+// ============================================
+// EnactFactory - PR Ownership Tracker
+// Tracks which PRs were created by the bot
+// Persists to .enact/operator/state/pr-ownership.json
+import { resolve } from 'node:path';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { statePath } from '../factory/paths.js';
+// Constants
+const OWNERSHIP_PATH = statePath('pr-ownership.json');
+// State Management
+async function loadState() {
+    try {
+        const data = await readFile(OWNERSHIP_PATH, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch {
+        return { prs: [], updatedAt: new Date().toISOString() };
+    }
+}
+async function saveState(state) {
+    await mkdir(resolve(OWNERSHIP_PATH, '..'), { recursive: true });
+    state.updatedAt = new Date().toISOString();
+    await writeFile(OWNERSHIP_PATH, JSON.stringify(state, null, 2));
+}
+// Public API
+/** Register a PR as owned by the bot */
+export async function registerOwnedPR(pr) {
+    const state = await loadState();
+    const exists = state.prs.some((p) => p.repo === pr.repo && p.prNumber === pr.prNumber);
+    if (!exists) {
+        state.prs.push(pr);
+        await saveState(state);
+        console.log(`[PROwnership] Registered: ${pr.repo}#${pr.prNumber} (${pr.branch})`);
+    }
+}
+/** Check if a PR is owned by the bot */
+export async function isOwnedPR(repo, prNumber) {
+    const state = await loadState();
+    return state.prs.some((p) => p.repo === repo && p.prNumber === prNumber);
+}
+/** Remove a PR from ownership (after merge/close) */
+export async function removeOwnedPR(repo, prNumber) {
+    const state = await loadState();
+    const before = state.prs.length;
+    state.prs = state.prs.filter((p) => !(p.repo === repo && p.prNumber === prNumber));
+    if (state.prs.length < before) {
+        await saveState(state);
+        console.log(`[PROwnership] Removed: ${repo}#${prNumber}`);
+    }
+}
+/** Get all owned PRs for a repo */
+export async function getOwnedPRsForRepo(repo) {
+    const state = await loadState();
+    return state.prs.filter((p) => p.repo === repo);
+}
+/** Get all owned PRs */
+export async function getAllOwnedPRs() {
+    const state = await loadState();
+    return state.prs;
+}
+//# sourceMappingURL=prOwnership.js.map

package/dist/automation/prOwnership.js.map

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

package/dist/automation/runnerExecution.d.ts

@@ -0,0 +1,57 @@
+import type { WorkItemItem, DecisionResult } from '../orchestration/decisionEngine.js';
+import type { ExecutorResult } from '../orchestration/workflow.js';
+import type { PipelineResult } from '../agents/pairPipeline.js';
+import type { DefaultStagesConfig, JobProfile } from '../core/types.js';
+import { type DraftAnalysis } from '../agents/draftAnalyzer.js';
+type NotificationSendFn = (content: string) => Promise<void>;
+/** @deprecated Discord removed — registers an optional notification sink */
+export declare function setDiscordReporter(sendFn: NotificationSendFn): void;
+export declare function reportToDiscord(message: string): Promise<void>;
+type WorkItemFetchFn = () => Promise<WorkItemItem[]>;
+export declare function setAzdoFetcher(fetchFn: WorkItemFetchFn): void;
+export declare function setLocalFetcher(fetchFn: WorkItemFetchFn): void;
+export declare function fetchAzdoWorkItems(): Promise<{
+    workItems: WorkItemItem[];
+    error?: string;
+}>;
+/**
+ * Get current workItem source type
+ */
+export declare function getWorkItemSource(): 'azdo' | 'local' | null;
+export interface ExecutionContext {
+    allowedProjects: string[];
+    /** Draft analyzer 모델 (기본: claude-haiku-4-5-20251001) */
+    draftModel?: string;
+    /** Draft analyzer 활성화 (기본: true) */
+    enableDraftAnalysis?: boolean;
+    plannerModel?: string;
+    plannerTimeoutMs?: number;
+    pairMaxAttempts?: number;
+    enableDecomposition?: boolean;
+    decompositionThresholdMinutes?: number;
+    decompositionMaxDepth?: number;
+    decompositionMaxChildren?: number;
+    decompositionDailyLimit?: number;
+    decompositionAutoBacklog?: boolean;
+    getRolesForProject: (projectPath: string) => DefaultStagesConfig | undefined;
+    reportToDiscord: (message: string) => Promise<void>;
+    /** Git worktree mode: work in an isolated worktree per workItem, auto-create PR */
+    worktreeMode?: boolean;
+    /** Job profiles for on-the-fly model selection */
+    jobProfiles?: JobProfile[];
+    /** Trigger immediate heartbeat (called after decomposition to pick up new sub-workItems) */
+    scheduleNextHeartbeat?: () => void;
+    /** Pipeline guards configuration */
+    guards?: Partial<import('../core/types.js').PipelineGuardsConfig>;
+}
+export declare function resolveProjectPath(ctx: ExecutionContext, workItem: WorkItemItem): Promise<string | null>;
+export declare function isValidProjectPath(path: string): Promise<boolean>;
+export declare function decomposeWorkItem(ctx: ExecutionContext, workItem: WorkItemItem, projectPath: string, targetMinutes: number, draftAnalysis?: DraftAnalysis): Promise<boolean | 'no-decomp'>;
+export declare function executePipeline(ctx: ExecutionContext, workItem: WorkItemItem, projectPath: string): Promise<PipelineResult>;
+export declare function requestApproval(decision: DecisionResult, reportFn: (message: string) => Promise<void>): Promise<void>;
+export declare function reportExecutionResult(workItem: WorkItemItem, result: ExecutorResult, reportFn: (message: string) => Promise<void>): Promise<void>;
+export declare function reconcileCompletionState(workItem: WorkItemItem): Promise<void>;
+export declare function syncFailureState(workItem: WorkItemItem, reason: string): Promise<void>;
+export declare function syncSuccessState(workItem: WorkItemItem, confidence?: number): Promise<void>;
+export {};
+//# sourceMappingURL=runnerExecution.d.ts.map

package/dist/automation/runnerExecution.d.ts.map

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