@workermill/agent 0.8.8 → 0.8.10

package/dist/commands/stop.js

@@ -1,61 +0,0 @@
-/**
- * Stop Command — Stop a running WorkerMill Remote Agent daemon.
- *
- * Reads PID from ~/.workermill/agent.pid, sends SIGTERM, waits for exit.
- */
-import chalk from "chalk";
-import { existsSync, readFileSync, unlinkSync } from "fs";
-import { getPidFile } from "../config.js";
-export async function stopCommand() {
-    const pidFile = getPidFile();
-    if (!existsSync(pidFile)) {
-        console.log(chalk.yellow("No running agent found (no PID file)."));
-        console.log(chalk.dim(`Expected PID file at: ${pidFile}`));
-        return;
-    }
-    const pidStr = readFileSync(pidFile, "utf-8").trim();
-    const pid = parseInt(pidStr, 10);
-    if (isNaN(pid)) {
-        console.log(chalk.red(`Invalid PID in ${pidFile}: ${pidStr}`));
-        unlinkSync(pidFile);
-        return;
-    }
-    // Check if process is running
-    try {
-        process.kill(pid, 0); // Signal 0 = check existence
-    }
-    catch {
-        console.log(chalk.yellow(`Agent (PID ${pid}) is not running. Cleaning up PID file.`));
-        unlinkSync(pidFile);
-        return;
-    }
-    // Send SIGTERM
-    console.log(chalk.dim(`Stopping agent (PID ${pid})...`));
-    try {
-        process.kill(pid, "SIGTERM");
-    }
-    catch (error) {
-        console.log(chalk.red(`Failed to stop agent: ${error instanceof Error ? error.message : String(error)}`));
-        return;
-    }
-    // Wait for process to exit (up to 15 seconds)
-    const start = Date.now();
-    while (Date.now() - start < 15000) {
-        try {
-            process.kill(pid, 0);
-            await new Promise((r) => setTimeout(r, 500));
-        }
-        catch {
-            // Process has exited
-            break;
-        }
-    }
-    // Clean up PID file
-    try {
-        unlinkSync(pidFile);
-    }
-    catch {
-        /* ignore */
-    }
-    console.log(chalk.green("Agent stopped."));
-}

package/dist/commands/update.d.ts

@@ -1 +0,0 @@
-export declare function updateCommand(): Promise<void>;

package/dist/commands/update.js

@@ -1,20 +0,0 @@
-import chalk from "chalk";
-import { AGENT_VERSION } from "../version.js";
-import { selfUpdate } from "../updater.js";
-export async function updateCommand() {
-    console.log();
-    console.log(chalk.bold.cyan("  WorkerMill Agent Update"));
-    console.log(chalk.dim("  ─────────────────────────────────────"));
-    console.log(`  ${chalk.dim("Current version:")} ${AGENT_VERSION}`);
-    console.log();
-    const success = await selfUpdate();
-    if (success) {
-        console.log();
-        console.log(chalk.green("  Update complete. If the agent is running, restart it to use the new version."));
-    }
-    else {
-        console.log();
-        console.error(chalk.red("  Update failed. Try running manually: npm install -g @workermill/agent@latest"));
-        process.exitCode = 1;
-    }
-}

package/dist/config.d.ts

@@ -1,77 +0,0 @@
-/**
- * Remote Agent Configuration
- *
- * Supports two modes:
- *   1. File-based config (~/.workermill/config.json) — for npm-installed CLI
- *   2. Environment variable config (.env.remote) — for bin/remote-agent backward compat
- */
-export interface AgentConfig {
-    apiUrl: string;
-    apiKey: string;
-    agentId: string;
-    maxWorkers: number;
-    pollIntervalMs: number;
-    heartbeatIntervalMs: number;
-    githubToken: string;
-    bitbucketToken: string;
-    gitlabToken: string;
-    workerImage: string;
-}
-export interface FileConfig {
-    apiUrl: string;
-    apiKey: string;
-    agentId: string;
-    maxWorkers: number;
-    pollIntervalMs: number;
-    heartbeatIntervalMs: number;
-    tokens: {
-        github: string;
-        bitbucket: string;
-        gitlab: string;
-    };
-    workerImage: string;
-    setupCompletedAt: string;
-}
-export declare function getConfigDir(): string;
-export declare function getConfigFile(): string;
-export declare function getPidFile(): string;
-export declare function getLogFile(): string;
-/**
- * Load config from ~/.workermill/config.json (CLI mode).
- */
-export declare function loadConfigFromFile(): AgentConfig;
-/**
- * Save config to ~/.workermill/config.json with restricted permissions.
- */
-export declare function saveConfigToFile(fc: FileConfig): void;
-/**
- * Load config from environment variables (backward compat with bin/remote-agent).
- */
-export declare function loadConfig(): AgentConfig;
-/**
- * Find claude binary. Checks PATH, then known install locations.
- */
-export declare function findClaudePath(): string | null;
-export interface PrerequisiteResult {
-    name: string;
-    ok: boolean;
-    detail?: string;
-}
-/**
- * Check all prerequisites and return results (non-exiting version for setup wizard).
- */
-export declare function checkPrerequisites(workerImage?: string): PrerequisiteResult[];
-/**
- * Validate prerequisites (exits on failure — backward compat).
- */
-export declare function validatePrerequisites(): void;
-/**
- * Get system info for agent registration.
- */
-export declare function getSystemInfo(): {
-    hostname: string;
-    platform: string;
-    nodeVersion: string;
-    dockerVersion: string;
-    claudeVersion: string;
-};

package/dist/config.js

@@ -1,286 +0,0 @@
-/**
- * Remote Agent Configuration
- *
- * Supports two modes:
- *   1. File-based config (~/.workermill/config.json) — for npm-installed CLI
- *   2. Environment variable config (.env.remote) — for bin/remote-agent backward compat
- */
-import { existsSync, readFileSync, mkdirSync, writeFileSync, chmodSync } from "fs";
-import { execSync } from "child_process";
-import { hostname, homedir } from "os";
-import { join } from "path";
-const CONFIG_DIR = join(homedir(), ".workermill");
-const CONFIG_FILE = join(CONFIG_DIR, "config.json");
-const PID_FILE = join(CONFIG_DIR, "agent.pid");
-const LOG_FILE = join(CONFIG_DIR, "agent.log");
-export function getConfigDir() {
-    return CONFIG_DIR;
-}
-export function getConfigFile() {
-    return CONFIG_FILE;
-}
-export function getPidFile() {
-    return PID_FILE;
-}
-export function getLogFile() {
-    return LOG_FILE;
-}
-/**
- * Load config from ~/.workermill/config.json (CLI mode).
- */
-export function loadConfigFromFile() {
-    if (!existsSync(CONFIG_FILE)) {
-        console.error("No config found. Run 'workermill-agent setup' first.");
-        process.exit(1);
-    }
-    let raw;
-    try {
-        raw = readFileSync(CONFIG_FILE, "utf-8");
-    }
-    catch {
-        console.error("Failed to read config file:", CONFIG_FILE);
-        process.exit(1);
-    }
-    let fc;
-    try {
-        fc = JSON.parse(raw);
-    }
-    catch {
-        console.error("Config file is corrupted. Re-run 'workermill-agent setup'.");
-        process.exit(1);
-    }
-    if (!fc.apiUrl || !fc.apiKey) {
-        console.error("Config file is missing required fields (apiUrl, apiKey). Re-run 'workermill-agent setup'.");
-        process.exit(1);
-    }
-    // Migrate any stale image URLs to current default (private ECR)
-    const defaultImage = "593971626975.dkr.ecr.us-east-1.amazonaws.com/workermill-dev/worker:latest";
-    let workerImage = fc.workerImage || defaultImage;
-    if (workerImage.includes("jarod1/") ||
-        workerImage.includes("public.ecr.aws/") ||
-        !workerImage.includes("workermill-worker") && !workerImage.includes("workermill-dev/worker")) {
-        workerImage = defaultImage;
-        fc.workerImage = workerImage;
-        try {
-            writeFileSync(CONFIG_FILE, JSON.stringify(fc, null, 2), "utf-8");
-        }
-        catch { /* best effort */ }
-    }
-    return {
-        apiUrl: fc.apiUrl,
-        apiKey: fc.apiKey,
-        agentId: fc.agentId,
-        maxWorkers: fc.maxWorkers || 4,
-        pollIntervalMs: fc.pollIntervalMs || 5000,
-        heartbeatIntervalMs: fc.heartbeatIntervalMs || 30000,
-        githubToken: fc.tokens?.github || "",
-        bitbucketToken: fc.tokens?.bitbucket || "",
-        gitlabToken: fc.tokens?.gitlab || "",
-        workerImage,
-    };
-}
-/**
- * Save config to ~/.workermill/config.json with restricted permissions.
- */
-export function saveConfigToFile(fc) {
-    if (!existsSync(CONFIG_DIR)) {
-        mkdirSync(CONFIG_DIR, { recursive: true });
-    }
-    writeFileSync(CONFIG_FILE, JSON.stringify(fc, null, 2), "utf-8");
-    // Restrict permissions (owner-only read/write)
-    try {
-        chmodSync(CONFIG_FILE, 0o600);
-    }
-    catch {
-        // chmod may not work on Windows, that's OK
-    }
-}
-/**
- * Load config from environment variables (backward compat with bin/remote-agent).
- */
-export function loadConfig() {
-    const apiUrl = process.env.WORKERMILL_API_URL;
-    const apiKey = process.env.WORKERMILL_API_KEY;
-    if (!apiUrl) {
-        console.error("WORKERMILL_API_URL is required in .env.remote");
-        process.exit(1);
-    }
-    if (!apiKey) {
-        console.error("WORKERMILL_API_KEY is required in .env.remote");
-        console.error("Get your API key from Settings > Integrations on the WorkerMill dashboard.");
-        process.exit(1);
-    }
-    return {
-        apiUrl: apiUrl.replace(/\/$/, ""), // Strip trailing slash
-        apiKey,
-        agentId: process.env.AGENT_ID || `agent-${hostname()}`,
-        maxWorkers: parseInt(process.env.MAX_WORKERS || "4", 10),
-        pollIntervalMs: parseInt(process.env.POLL_INTERVAL_MS || "5000", 10),
-        heartbeatIntervalMs: parseInt(process.env.HEARTBEAT_INTERVAL_MS || "30000", 10),
-        githubToken: process.env.GITHUB_TOKEN || "",
-        bitbucketToken: process.env.BITBUCKET_TOKEN || "",
-        gitlabToken: process.env.GITLAB_TOKEN || "",
-        workerImage: process.env.WORKER_IMAGE || "workermill-worker:local",
-    };
-}
-/**
- * Find claude binary. Checks PATH, then known install locations.
- */
-export function findClaudePath() {
-    const isWin = process.platform === "win32";
-    const which = isWin ? "where" : "which";
-    // Check PATH first
-    try {
-        execSync(`${which} claude`, { stdio: "ignore", timeout: 10000 });
-        return "claude";
-    }
-    catch { /* not in PATH */ }
-    const candidates = [];
-    if (isWin) {
-        candidates.push(join(process.env.ProgramFiles || "C:\\Program Files", "ClaudeCode", "claude.exe"), join(process.env.LOCALAPPDATA || "", "Programs", "ClaudeCode", "claude.exe"), join(homedir(), "AppData", "Local", "Programs", "ClaudeCode", "claude.exe"), join(homedir(), ".local", "bin", "claude.exe"));
-    }
-    else {
-        candidates.push(join(homedir(), ".local", "bin", "claude"), "/opt/homebrew/bin/claude", "/usr/local/bin/claude");
-    }
-    for (const candidate of candidates) {
-        if (candidate && existsSync(candidate))
-            return candidate;
-    }
-    return null;
-}
-/**
- * Check all prerequisites and return results (non-exiting version for setup wizard).
- */
-export function checkPrerequisites(workerImage) {
-    const results = [];
-    const image = workerImage || "593971626975.dkr.ecr.us-east-1.amazonaws.com/workermill-dev/worker:latest";
-    // Docker
-    try {
-        const version = execSync("docker version --format {{.Server.Version}}", {
-            encoding: "utf-8",
-            timeout: 10000,
-        }).trim();
-        results.push({ name: "Docker", ok: true, detail: version });
-    }
-    catch {
-        results.push({ name: "Docker", ok: false, detail: "Not running or not installed" });
-    }
-    // Claude CLI (search known install locations, not just PATH)
-    const claudePath = findClaudePath();
-    if (claudePath) {
-        try {
-            const version = execSync(`"${claudePath}" --version`, { encoding: "utf-8", timeout: 10000 }).trim();
-            results.push({ name: "Claude CLI", ok: true, detail: version });
-        }
-        catch {
-            results.push({ name: "Claude CLI", ok: true, detail: claudePath });
-        }
-    }
-    else {
-        results.push({ name: "Claude CLI", ok: false, detail: "Not installed" });
-    }
-    // Claude credentials
-    const home = homedir();
-    const credsPath = join(home, ".claude", ".credentials.json");
-    if (existsSync(credsPath)) {
-        results.push({ name: "Claude auth", ok: true, detail: "Credentials found" });
-    }
-    else {
-        results.push({ name: "Claude auth", ok: false, detail: "Run 'claude' and complete sign-in" });
-    }
-    // Node.js version
-    const nodeVersion = process.version;
-    const major = parseInt(nodeVersion.slice(1).split(".")[0], 10);
-    if (major >= 20) {
-        results.push({ name: "Node.js", ok: true, detail: nodeVersion });
-    }
-    else {
-        results.push({ name: "Node.js", ok: false, detail: `${nodeVersion} (need >= 20)` });
-    }
-    // Worker image
-    try {
-        execSync(`docker image inspect ${image}`, { stdio: "ignore", timeout: 10000 });
-        results.push({ name: "Worker image", ok: true, detail: image });
-    }
-    catch {
-        results.push({ name: "Worker image", ok: false, detail: `'${image}' not found` });
-    }
-    return results;
-}
-/**
- * Validate prerequisites (exits on failure — backward compat).
- */
-export function validatePrerequisites() {
-    // Check Docker
-    try {
-        execSync("docker version", { stdio: "ignore" });
-    }
-    catch {
-        console.error("Docker is not available. Please install Docker and ensure it's running.");
-        process.exit(1);
-    }
-    // Check worker image (use env-configured image or default)
-    const image = process.env.WORKER_IMAGE || "workermill-worker:local";
-    try {
-        execSync(`docker image inspect ${image}`, { stdio: "ignore" });
-    }
-    catch {
-        console.error(`Worker image '${image}' not found.`);
-        if (image === "workermill-worker:local") {
-            console.error("Build it with: ./bin/local-workermill build-worker");
-        }
-        else {
-            console.error(`Pull it with: docker pull ${image}`);
-        }
-        process.exit(1);
-    }
-    // Check Claude CLI
-    if (!findClaudePath()) {
-        console.error("Claude CLI is not installed.");
-        console.error("Install it: curl -fsSL https://claude.ai/install.sh | bash");
-        process.exit(1);
-    }
-    // Check Claude credentials
-    const home = homedir();
-    const credsPath = join(home, ".claude", ".credentials.json");
-    if (!existsSync(credsPath)) {
-        console.error("Claude credentials not found.");
-        console.error("Run 'claude' and complete the sign-in flow to authenticate.");
-        process.exit(1);
-    }
-}
-/**
- * Get system info for agent registration.
- */
-export function getSystemInfo() {
-    let dockerVersion = "unknown";
-    try {
-        dockerVersion = execSync("docker version --format {{.Server.Version}}", {
-            encoding: "utf-8",
-            timeout: 10000,
-        }).trim();
-    }
-    catch {
-        /* ignore */
-    }
-    let claudeVersion = "unknown";
-    const claudeBin = findClaudePath();
-    if (claudeBin) {
-        try {
-            claudeVersion = execSync(`"${claudeBin}" --version`, {
-                encoding: "utf-8",
-                timeout: 10000,
-            }).trim();
-        }
-        catch {
-            /* ignore */
-        }
-    }
-    return {
-        hostname: hostname(),
-        platform: process.platform,
-        nodeVersion: process.version,
-        dockerVersion,
-        claudeVersion,
-    };
-}

package/dist/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * WorkerMill Remote Agent
- *
- * Importable module for starting the agent programmatically.
- * Can also be run directly via `bin/remote-agent` (backward compat with dotenv).
- */
-import type { AgentConfig } from "./config.js";
-export { loadConfig, loadConfigFromFile, validatePrerequisites, getSystemInfo, findClaudePath } from "./config.js";
-export type { AgentConfig } from "./config.js";
-/**
- * Start the remote agent with the given config.
- * Returns a cleanup function to stop the agent.
- */
-export declare function startAgent(config: AgentConfig): Promise<() => Promise<void>>;

package/dist/plan-validator.d.ts

@@ -1,104 +0,0 @@
-/**
- * Plan Validator for Remote Agent
- *
- * Validates execution plans locally before posting to the cloud API.
- * Implements the same guardrails as the server-side planning pipeline:
- *   1. File cap: max 5 targetFiles per story (prevents scope explosion)
- *   2. Critic validation: LLM scores the plan, rejects below threshold
- *
- * This ensures remote agent plans get the same quality gates as cloud plans,
- * even though the planning prompt runs locally via Claude CLI.
- */
-import { type AIProvider } from "./providers.js";
-export interface PlannedStory {
-    id: string;
-    title: string;
-    description: string;
-    persona: string;
-    priority: number;
-    estimatedEffort: "small" | "medium" | "large";
-    dependencies: string[];
-    acceptanceCriteria?: string[];
-    targetFiles?: string[];
-    scope?: string;
-}
-export interface ExecutionPlan {
-    summary: string;
-    stories: PlannedStory[];
-    risks: string[];
-    assumptions: string[];
-}
-export interface CriticResult {
-    approved: boolean;
-    score: number;
-    risks: string[];
-    suggestions?: string[];
-    storyFeedback?: Array<{
-        storyId: string;
-        feedback: string;
-        suggestedChanges?: string[];
-    }>;
-}
-declare const AUTO_APPROVAL_THRESHOLD = 85;
-/**
- * Parse execution plan JSON from raw Claude CLI output.
- * Mirrors server-side parseExecutionPlan() in planning-agent-local.ts.
- */
-export declare function parseExecutionPlan(output: string): ExecutionPlan;
-/**
- * Apply file cap to all stories. Truncates targetFiles > MAX_TARGET_FILES.
- * Returns details about truncated stories for logging.
- */
-export declare function applyFileCap(plan: ExecutionPlan): {
-    truncatedCount: number;
-    details: string[];
-};
-/**
- * Apply story cap to the plan. Truncates stories beyond maxStories.
- * Returns details about dropped stories for logging.
- */
-export declare function applyStoryCap(plan: ExecutionPlan, maxStories: number): {
-    droppedCount: number;
-    details: string[];
-};
-/**
- * Resolve file overlaps by assigning each shared file to exactly one story.
- * When multiple stories list the same targetFile, the first story keeps it
- * and it's removed from subsequent stories. This prevents parallel merge
- * conflicts during consolidation — same auto-fix pattern as applyFileCap.
- *
- * Returns details about resolved overlaps for logging.
- */
-export declare function resolveFileOverlaps(plan: ExecutionPlan): {
-    resolvedCount: number;
-    details: string[];
-};
-/**
- * Re-serialize plan as a JSON code block for posting to the API.
- * The server-side parseExecutionPlan() expects ```json ... ``` blocks.
- */
-export declare function serializePlan(plan: ExecutionPlan): string;
-/**
- * Build the critic prompt with PRD and plan substituted.
- */
-export declare function buildCriticPrompt(prd: string, plan: ExecutionPlan): string;
-/**
- * Parse critic JSON response from raw Claude CLI output.
- */
-export declare function parseCriticResponse(text: string): CriticResult;
-/**
- * Run the critic via Claude CLI (lightweight — no tools, just reasoning).
- * Returns the raw text output.
- */
-export declare function runCriticCli(claudePath: string, model: string, prompt: string, env: Record<string, string | undefined>, taskId?: string): Promise<string>;
-/**
- * Format critic feedback for appending to the planner prompt on re-run.
- */
-export declare function formatCriticFeedback(critic: CriticResult): string;
-/**
- * Run critic validation on a parsed plan.
- * Routes to Claude CLI (Anthropic) or HTTP API (other providers).
- * Returns the critic result, or null if critic fails (non-blocking).
- */
-export declare function runCriticValidation(claudePath: string, model: string, prd: string, plan: ExecutionPlan, env: Record<string, string | undefined>, taskLabel: string, provider?: AIProvider, providerApiKey?: string, taskId?: string): Promise<CriticResult | null>;
-export { AUTO_APPROVAL_THRESHOLD };