agentrix 0.0.1

package/dist/core/automation/task-runner.js

@@ -0,0 +1,215 @@
+/**
+ * Coordinates the asynchronous automation launch task, updating task progress and metadata.
+ */
+export const TASK_TYPE_AUTOMATION = 'automation:launch';
+export const STEP_IDS = Object.freeze({
+    ENSURE_REPO: 'ensure-repository',
+    GENERATE_PLAN: 'generate-plan',
+    ENSURE_WORKTREE: 'ensure-worktree',
+    LAUNCH_AGENT: 'launch-agent',
+    REFRESH_REPOS: 'refresh-repositories',
+});
+export const STEP_LABELS = Object.freeze({
+    [STEP_IDS.ENSURE_REPO]: 'Ensure repository',
+    [STEP_IDS.GENERATE_PLAN]: 'Generate plan',
+    [STEP_IDS.ENSURE_WORKTREE]: 'Ensure worktree',
+    [STEP_IDS.LAUNCH_AGENT]: 'Launch agent',
+    [STEP_IDS.REFRESH_REPOS]: 'Refresh repositories',
+});
+export async function runAutomationTask({ runTaskImpl, resolveBranchName, generatePlanText, gitOrchestrator, launchAgent, workdir, planEnabled, routeLabel, prompt, org, repo, agent, requestId, worktreeInput, branchNameGenerator, defaultBranches, planService, finishSuccess, finishFailure, onBranchResolved, }) {
+    if (typeof runTaskImpl !== 'function') {
+        throw new Error('runTask implementation is required');
+    }
+    if (!gitOrchestrator) {
+        throw new Error('git orchestrator is required');
+    }
+    const orchestrator = gitOrchestrator;
+    const { ensureRepositoryReady, ensureWorktreeReady, refreshRepositoryViews } = orchestrator;
+    const branchResult = await resolveBranchName({
+        worktreeInput,
+        branchNameGenerator,
+        prompt,
+        org,
+        repo,
+        defaultBranches,
+    });
+    const { branch, defaultBranchOverride } = branchResult;
+    if (typeof onBranchResolved === 'function') {
+        onBranchResolved(branch);
+    }
+    const agentData = agent;
+    const taskMetadata = {
+        automationRequestId: requestId,
+        planEnabled,
+        promptProvided: Boolean(prompt.trim()),
+        org,
+        repo,
+        branch,
+        command: agentData.key,
+        status: 'pending',
+    };
+    const taskResult = runTaskImpl({
+        type: TASK_TYPE_AUTOMATION,
+        title: `Automation launch for ${org}/${repo}`,
+        metadata: taskMetadata,
+    }, async (context) => {
+        const ctx = context;
+        const { progress, setResult, updateMetadata } = ctx;
+        const finalData = {
+            org,
+            repo,
+            branch,
+            plan: planEnabled,
+            promptRoute: routeLabel,
+            automationRequestId: requestId,
+            agent: agentData.key,
+            agentCommand: agentData.command,
+            repositoryPath: null,
+            worktreePath: null,
+            clonedRepository: false,
+            createdWorktree: false,
+            pid: null,
+            terminalSessionId: null,
+            terminalSessionCreated: false,
+            tmuxSessionName: null,
+            terminalUsingTmux: false,
+        };
+        let currentStep = null;
+        const startStep = (id, message) => {
+            currentStep = id;
+            progress.startStep(id, { label: STEP_LABELS[id], message });
+        };
+        const completeStep = (id, message) => {
+            progress.completeStep(id, { label: STEP_LABELS[id], message });
+            if (currentStep === id) {
+                currentStep = null;
+            }
+        };
+        const failCurrentStep = (message) => {
+            if (!currentStep) {
+                return;
+            }
+            progress.failStep(currentStep, { label: STEP_LABELS[currentStep], message });
+            currentStep = null;
+        };
+        progress.ensureStep(STEP_IDS.ENSURE_REPO, STEP_LABELS[STEP_IDS.ENSURE_REPO]);
+        progress.ensureStep(STEP_IDS.GENERATE_PLAN, STEP_LABELS[STEP_IDS.GENERATE_PLAN]);
+        progress.ensureStep(STEP_IDS.ENSURE_WORKTREE, STEP_LABELS[STEP_IDS.ENSURE_WORKTREE]);
+        progress.ensureStep(STEP_IDS.LAUNCH_AGENT, STEP_LABELS[STEP_IDS.LAUNCH_AGENT]);
+        progress.ensureStep(STEP_IDS.REFRESH_REPOS, STEP_LABELS[STEP_IDS.REFRESH_REPOS]);
+        updateMetadata({ status: 'running' });
+        try {
+            startStep(STEP_IDS.ENSURE_REPO, 'Ensuring repository exists.');
+            const repoResult = await ensureRepositoryReady(workdir, org, repo);
+            const { repositoryPath, cloned: clonedRepository } = repoResult;
+            finalData.repositoryPath = repositoryPath;
+            finalData.clonedRepository = clonedRepository;
+            updateMetadata({ repositoryPath, clonedRepository });
+            completeStep(STEP_IDS.ENSURE_REPO, clonedRepository ? 'Repository cloned successfully.' : 'Repository is ready.');
+            let effectivePrompt = prompt;
+            if (planEnabled) {
+                startStep(STEP_IDS.GENERATE_PLAN, 'Generating plan text.');
+                try {
+                    const planResult = (await generatePlanText({
+                        planEnabled,
+                        prompt,
+                        planService,
+                        repositoryPath,
+                    }));
+                    effectivePrompt = planResult.promptToExecute;
+                    completeStep(STEP_IDS.GENERATE_PLAN, 'Plan generated successfully.');
+                }
+                catch (error) {
+                    const message = error instanceof Error ? error.message : String(error);
+                    failCurrentStep(message);
+                    updateMetadata({ status: 'failed', error: message });
+                    throw error instanceof Error ? error : new Error(message);
+                }
+            }
+            else {
+                progress.skipStep(STEP_IDS.GENERATE_PLAN, {
+                    label: STEP_LABELS[STEP_IDS.GENERATE_PLAN],
+                    message: 'Plan generation disabled for this request.',
+                });
+            }
+            startStep(STEP_IDS.ENSURE_WORKTREE, 'Ensuring worktree is available.');
+            const worktreeResult = await ensureWorktreeReady(workdir, org, repo, branch, { defaultBranchOverride });
+            const { worktreePath, created: createdWorktree } = worktreeResult;
+            finalData.worktreePath = worktreePath;
+            finalData.createdWorktree = createdWorktree;
+            updateMetadata({ worktreePath, createdWorktree });
+            completeStep(STEP_IDS.ENSURE_WORKTREE, createdWorktree ? 'Worktree created successfully.' : 'Worktree already existed.');
+            startStep(STEP_IDS.REFRESH_REPOS, 'Refreshing repository view.');
+            try {
+                await refreshRepositoryViews(workdir);
+                completeStep(STEP_IDS.REFRESH_REPOS, 'Repository view updated.');
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                failCurrentStep(message);
+                updateMetadata({ status: 'failed', error: message });
+                finishFailure(error);
+                throw error instanceof Error ? error : new Error(message);
+            }
+            startStep(STEP_IDS.LAUNCH_AGENT, 'Launching agent command.');
+            const launchResult = await launchAgent({
+                command: agentData.command,
+                workdir,
+                org,
+                repo,
+                branch,
+                prompt: effectivePrompt,
+            });
+            const { pid, sessionId, tmuxSessionName, usingTmux, createdSession, } = launchResult;
+            finalData.pid = pid;
+            finalData.terminalSessionId = sessionId;
+            finalData.terminalSessionCreated = createdSession;
+            finalData.tmuxSessionName = tmuxSessionName;
+            finalData.terminalUsingTmux = usingTmux;
+            updateMetadata({
+                pid,
+                terminalSessionId: sessionId,
+                terminalSessionCreated: createdSession,
+                tmuxSessionName,
+                terminalUsingTmux: usingTmux,
+            });
+            completeStep(STEP_IDS.LAUNCH_AGENT, 'Agent launched successfully.');
+            finishSuccess(`${org}/${repo}#${branch}`);
+            updateMetadata({ status: 'succeeded' });
+            setResult(finalData);
+            return finalData;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            failCurrentStep(message);
+            updateMetadata({ status: 'failed', error: message });
+            finishFailure(error);
+            if (!(error instanceof Error)) {
+                throw new Error(message);
+            }
+            throw error;
+        }
+    });
+    const queuedData = {
+        org,
+        repo,
+        branch,
+        repositoryPath: null,
+        worktreePath: null,
+        clonedRepository: null,
+        createdWorktree: null,
+        agent: agentData.key,
+        agentCommand: agentData.command,
+        pid: null,
+        terminalSessionId: null,
+        terminalSessionCreated: false,
+        tmuxSessionName: null,
+        terminalUsingTmux: false,
+        plan: planEnabled,
+        promptRoute: routeLabel,
+        automationRequestId: requestId,
+    };
+    const task = (await taskResult);
+    return { taskId: task.id, queuedData, branch };
+}
+//# sourceMappingURL=task-runner.js.map

package/dist/core/automation/task-runner.js.map

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

package/dist/core/branch-name.d.ts

@@ -0,0 +1,13 @@
+export declare function createBranchNameGenerator({ defaultLlm }?: {
+    defaultLlm?: string;
+}): {
+    isConfigured: boolean;
+    generateBranchName: (context?: {
+        prompt?: string;
+        org?: string;
+        repo?: string;
+        llm?: string;
+    }) => Promise<string>;
+    dispose(): Promise<void>;
+};
+//# sourceMappingURL=branch-name.d.ts.map

package/dist/core/branch-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch-name.d.ts","sourceRoot":"","sources":["../../src/core/branch-name.ts"],"names":[],"mappings":"AA0VA,wBAAgB,yBAAyB,CAAC,EAAE,UAAU,EAAE,GAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAA;CAAO;;mCAMzC;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE;;EA8H1G"}

package/dist/core/branch-name.js

@@ -0,0 +1,429 @@
+import { spawn } from 'node:child_process';
+import { loadDeveloperMessage } from '../config/developer-messages.js';
+import { normaliseBranchName } from './git.js';
+const SUPPORTED_LLMS = new Set(['codex', 'claude', 'cursor']);
+const DEFAULT_LLM = 'codex';
+const COMMAND_TIMEOUT_MS = 30_000;
+const COMMAND_MAX_BUFFER = 512 * 1024;
+const DEFAULT_DEVELOPER_MESSAGE = 'Generate a branch name in the format <type>/<description> with no preamble or postamble, and no code blocks. The <type> must be one of: feature, enhancement, fix, chore, or another appropriate status. The <description> should be concise (max 7 words), using dashes to separate words. Example: feature/create-calendar-page.';
+const COMMAND_NAMES = {
+    codex: 'codex',
+    claude: 'claude',
+    cursor: 'cursor-agent',
+};
+function slugifySegment(value) {
+    if (typeof value !== 'string') {
+        return '';
+    }
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-+|-+$/g, '');
+}
+function sanitiseCandidate(rawValue) {
+    if (typeof rawValue !== 'string') {
+        return '';
+    }
+    const line = rawValue
+        .split('\n')
+        .map((segment) => segment.trim())
+        .find(Boolean);
+    if (!line) {
+        return '';
+    }
+    const cleaned = line.replace(/^`+|`+$/g, '').replace(/^"+|"+$/g, '').trim();
+    if (!cleaned) {
+        return '';
+    }
+    const segments = cleaned.split('/').map((segment) => slugifySegment(segment));
+    let type = segments[0];
+    const remainder = segments.slice(1).filter(Boolean);
+    if (!type) {
+        type = 'feature';
+    }
+    if (remainder.length === 0) {
+        const fallback = slugifySegment(cleaned.replace(/\//g, '-'));
+        if (!fallback) {
+            return '';
+        }
+        remainder.push(fallback);
+    }
+    const branch = [type, ...remainder].join('/');
+    return normaliseBranchName(branch);
+}
+function buildUserPrompt({ prompt, org, repo } = {}) {
+    const sections = [];
+    if (org && repo) {
+        sections.push(`Repository: ${org}/${repo}`);
+    }
+    if (prompt) {
+        sections.push(`Summary:\n${prompt}`);
+    }
+    if (sections.length === 0) {
+        sections.push('Generate a succinct branch name for an upcoming change.');
+    }
+    return sections.join('\n\n');
+}
+function shellQuote(value) {
+    const str = String(value ?? '');
+    if (str === '') {
+        return "''";
+    }
+    return `'${str.replace(/'/g, `'\\''`)}'`;
+}
+function buildCommandString(baseCommand, args = []) {
+    const trimmedBase = typeof baseCommand === 'string' && baseCommand.trim() ? baseCommand.trim() : '';
+    if (!trimmedBase) {
+        throw new Error('Command is not configured for branch naming.');
+    }
+    const serializedArgs = args.map((arg) => shellQuote(arg));
+    return [trimmedBase, ...serializedArgs].join(' ');
+}
+function normaliseLlm(input) {
+    if (typeof input !== 'string') {
+        return DEFAULT_LLM;
+    }
+    const trimmed = input.trim().toLowerCase();
+    if (!trimmed) {
+        return DEFAULT_LLM;
+    }
+    if (!SUPPORTED_LLMS.has(trimmed)) {
+        return DEFAULT_LLM;
+    }
+    return trimmed;
+}
+function buildPromptText({ developerMessage, userPrompt }) {
+    const sections = [developerMessage.trim()];
+    if (userPrompt.trim()) {
+        sections.push(userPrompt.trim());
+    }
+    sections.push('Respond with the branch name only.');
+    return sections.join('\n\n');
+}
+async function executeLlmCommand(command, { signal, onProcessStart } = {}) {
+    const { shellPath, shellArgs } = resolveShellInvocation();
+    const isPosix = process.platform !== 'win32';
+    return new Promise((resolve, reject) => {
+        let stdout = '';
+        let stderr = '';
+        let totalOutput = 0;
+        let timedOut = false;
+        let aborted = false;
+        let killTimer = null;
+        let overflowed = false;
+        const child = spawn(shellPath, [...shellArgs, command], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: process.env,
+            detached: isPosix,
+        });
+        if (typeof onProcessStart === 'function') {
+            try {
+                onProcessStart(child);
+            }
+            catch {
+                // ignore observer errors
+            }
+        }
+        const cleanup = () => {
+            if (timeoutId) {
+                clearTimeout(timeoutId);
+            }
+            if (killTimer) {
+                clearTimeout(killTimer);
+            }
+            if (abortListener && signal) {
+                signal.removeEventListener('abort', abortListener);
+            }
+            if (child.stdout) {
+                child.stdout.off('data', handleStdout);
+            }
+            if (child.stderr) {
+                child.stderr.off('data', handleStderr);
+            }
+            child.off('error', handleError);
+            child.off('close', handleClose);
+        };
+        const abortError = new Error('Command aborted');
+        abortError.name = 'AbortError';
+        const terminateChild = (code = 'SIGTERM') => {
+            if (isPosix && typeof child.pid === 'number' && child.pid > 0) {
+                try {
+                    process.kill(-child.pid, code);
+                }
+                catch {
+                    // ignore group kill errors
+                }
+            }
+            if (!child.killed) {
+                try {
+                    child.kill(code);
+                }
+                catch {
+                    // ignore kill errors
+                }
+            }
+            killTimer = setTimeout(() => {
+                if (isPosix && typeof child.pid === 'number' && child.pid > 0) {
+                    try {
+                        process.kill(-child.pid, 'SIGKILL');
+                    }
+                    catch {
+                        // ignore group kill errors
+                    }
+                }
+                if (!child.killed) {
+                    try {
+                        child.kill('SIGKILL');
+                    }
+                    catch {
+                        // ignore kill errors
+                    }
+                }
+            }, 1000);
+            killTimer.unref?.();
+        };
+        const handleAbort = () => {
+            if (aborted) {
+                return;
+            }
+            aborted = true;
+            terminateChild();
+        };
+        let abortListener = null;
+        if (signal) {
+            if (signal.aborted) {
+                handleAbort();
+            }
+            else {
+                abortListener = handleAbort;
+                signal.addEventListener('abort', abortListener);
+            }
+        }
+        const timeoutId = COMMAND_TIMEOUT_MS
+            ? setTimeout(() => {
+                timedOut = true;
+                terminateChild();
+            }, COMMAND_TIMEOUT_MS)
+            : null;
+        timeoutId?.unref?.();
+        child.stdout?.setEncoding('utf8');
+        child.stderr?.setEncoding('utf8');
+        const handleStdout = (chunk) => {
+            stdout += chunk;
+            totalOutput += Buffer.byteLength(chunk, 'utf8');
+            if (totalOutput > COMMAND_MAX_BUFFER) {
+                overflowed = true;
+                terminateChild();
+            }
+        };
+        const handleStderr = (chunk) => {
+            stderr += chunk;
+            totalOutput += Buffer.byteLength(chunk, 'utf8');
+            if (totalOutput > COMMAND_MAX_BUFFER) {
+                overflowed = true;
+                terminateChild();
+            }
+        };
+        if (child.stdout) {
+            child.stdout.on('data', handleStdout);
+        }
+        if (child.stderr) {
+            child.stderr.on('data', handleStderr);
+        }
+        const handleError = (error) => {
+            cleanup();
+            reject(error);
+        };
+        child.on('error', handleError);
+        const handleClose = (code, signalCode) => {
+            cleanup();
+            if (overflowed) {
+                reject(new Error('Command output exceeded maximum buffer size.'));
+                return;
+            }
+            if (aborted) {
+                reject(abortError);
+                return;
+            }
+            if (timedOut) {
+                reject(new Error('Command timed out.'));
+                return;
+            }
+            if (signalCode) {
+                reject(new Error(`Command terminated due to signal ${signalCode}`));
+                return;
+            }
+            if (code !== 0) {
+                const message = stderr.trim() || stdout.trim() || `Command exited with code ${code}`;
+                reject(new Error(message));
+                return;
+            }
+            resolve(stdout);
+        };
+        child.once('close', handleClose);
+    });
+}
+function resolveShellInvocation() {
+    const shellPath = typeof process.env["SHELL"] === 'string' && process.env["SHELL"].trim()
+        ? process.env["SHELL"].trim()
+        : '/bin/sh';
+    const name = shellPath.split('/').pop();
+    const shellArgs = [];
+    if (name === 'bash' || name === 'zsh' || name === 'fish') {
+        shellArgs.push('-il');
+    }
+    shellArgs.push('-c');
+    return { shellPath, shellArgs };
+}
+function resolveBaseCommand(llm) {
+    if (llm === 'codex') {
+        return COMMAND_NAMES.codex;
+    }
+    if (llm === 'claude') {
+        return COMMAND_NAMES.claude;
+    }
+    if (llm === 'cursor') {
+        return COMMAND_NAMES.cursor;
+    }
+    return null;
+}
+function buildCommandForLlm(llm, promptText) {
+    const baseCommand = resolveBaseCommand(llm);
+    if (!baseCommand) {
+        throw new Error(`No command configured for LLM "${llm}".`);
+    }
+    const commandPrefix = `command ${baseCommand}`;
+    switch (llm) {
+        case 'claude':
+            return buildCommandString(commandPrefix, ['-p', promptText]);
+        case 'cursor':
+            return buildCommandString(commandPrefix, ['-p', promptText]);
+        case 'codex':
+        default:
+            return buildCommandString(commandPrefix, ['exec', promptText, '--skip-git-repo-check']);
+    }
+}
+export function createBranchNameGenerator({ defaultLlm } = {}) {
+    const chosenLlm = normaliseLlm(defaultLlm);
+    const activeControllers = new Set();
+    const runningCommands = new Set();
+    const activeProcesses = new Set();
+    async function generateBranchName(context = {}) {
+        const userPrompt = buildUserPrompt(context);
+        const developerMessage = await loadDeveloperMessage('branch-name', DEFAULT_DEVELOPER_MESSAGE);
+        const promptText = buildPromptText({ developerMessage, userPrompt });
+        const requestedLlm = normaliseLlm(context.llm || chosenLlm);
+        const controller = new AbortController();
+        activeControllers.add(controller);
+        let commandPromise;
+        try {
+            const command = buildCommandForLlm(requestedLlm, promptText);
+            try {
+                commandPromise = Promise.resolve(executeLlmCommand(command, {
+                    signal: controller.signal,
+                    onProcessStart: (childProcess) => {
+                        if (!childProcess) {
+                            return;
+                        }
+                        activeProcesses.add(childProcess);
+                        const proc = childProcess;
+                        proc.once('close', () => {
+                            activeProcesses.delete(childProcess);
+                        });
+                    },
+                }));
+            }
+            catch (error) {
+                const err = error;
+                if (controller.signal.aborted || err?.name === 'AbortError' || err?.code === 'ABORT_ERR') {
+                    throw new Error('Branch name generation was cancelled.');
+                }
+                throw error;
+            }
+            runningCommands.add(commandPromise);
+            let output;
+            try {
+                output = await commandPromise;
+            }
+            finally {
+                runningCommands.delete(commandPromise);
+            }
+            const candidate = sanitiseCandidate(output);
+            if (!candidate) {
+                throw new Error('Generated branch name was empty.');
+            }
+            if (candidate.toLowerCase() === 'main') {
+                throw new Error('Generated branch name is invalid (branch "main" is not allowed).');
+            }
+            return candidate;
+        }
+        catch (error) {
+            const err = error;
+            if (controller.signal.aborted || err?.name === 'AbortError' || err?.code === 'ABORT_ERR') {
+                throw new Error('Branch name generation was cancelled.');
+            }
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Failed to generate branch name using ${requestedLlm}: ${message}`);
+        }
+        finally {
+            activeControllers.delete(controller);
+        }
+    }
+    async function disposeAll() {
+        if (activeControllers.size === 0 && runningCommands.size === 0 && activeProcesses.size === 0) {
+            return;
+        }
+        const controllers = Array.from(activeControllers);
+        controllers.forEach((controller) => {
+            try {
+                controller.abort();
+            }
+            catch {
+                // ignore abort errors during disposal
+            }
+        });
+        activeControllers.clear();
+        const processes = Array.from(activeProcesses);
+        activeProcesses.clear();
+        processes.forEach((child) => {
+            try {
+                if (!child.killed && child.kill) {
+                    child.kill('SIGTERM');
+                }
+            }
+            catch {
+                // ignore kill errors during disposal
+            }
+        });
+        if (processes.length > 0) {
+            await Promise.allSettled(processes.map((child) => new Promise((resolve) => {
+                if (child.exitCode !== null || child.signalCode) {
+                    resolve();
+                    return;
+                }
+                const handleResolve = () => resolve();
+                if (child.once) {
+                    child.once('close', handleResolve);
+                    child.once('exit', handleResolve);
+                }
+                else {
+                    resolve();
+                }
+            })));
+        }
+        const pending = Array.from(runningCommands);
+        runningCommands.clear();
+        if (pending.length > 0) {
+            await Promise.allSettled(pending);
+        }
+    }
+    return {
+        isConfigured: true,
+        generateBranchName,
+        async dispose() {
+            await disposeAll();
+        },
+    };
+}
+//# sourceMappingURL=branch-name.js.map