@renseiai/agentfactory-cli 0.8.0

package/dist/src/worker-fleet.js

@@ -0,0 +1,140 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Worker Fleet Manager
+ *
+ * Spawns and manages multiple worker processes for parallel agent execution.
+ * Thin wrapper around the programmatic runner in ./lib/worker-fleet-runner.js.
+ *
+ * Usage:
+ *   af-worker-fleet [options]
+ *
+ * Options:
+ *   -w, --workers <n>   Number of worker processes (default: CPU cores / 2)
+ *   -c, --capacity <n>  Agents per worker (default: 3)
+ *   -p, --projects <l>  Comma-separated project names to accept (default: all)
+ *   --dry-run            Show configuration without starting workers
+ *
+ * Environment (loaded from .env.local in CWD):
+ *   WORKER_FLEET_SIZE     Number of workers (override)
+ *   WORKER_CAPACITY       Agents per worker (override)
+ *   WORKER_PROJECTS       Comma-separated project names to accept
+ *   WORKER_API_URL        Coordinator API URL (required)
+ *   WORKER_API_KEY        API key for authentication (required)
+ */
+import path from 'path';
+import os from 'os';
+import { config as loadEnv } from 'dotenv';
+// Load environment variables from .env.local in CWD
+loadEnv({ path: path.resolve(process.cwd(), '.env.local') });
+import { runWorkerFleet } from './lib/worker-fleet-runner.js';
+// ANSI colors (kept for help output)
+const colors = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    cyan: '\x1b[36m',
+};
+function parseArgs() {
+    const args = process.argv.slice(2);
+    let workers = parseInt(process.env.WORKER_FLEET_SIZE ?? '0', 10) ||
+        Math.max(1, Math.floor(os.cpus().length / 2));
+    let capacity = parseInt(process.env.WORKER_CAPACITY ?? '3', 10);
+    let dryRun = false;
+    let projects;
+    let autoUpdate;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '--workers' || args[i] === '-w') {
+            workers = parseInt(args[++i], 10);
+        }
+        else if (args[i] === '--capacity' || args[i] === '-c') {
+            capacity = parseInt(args[++i], 10);
+        }
+        else if (args[i] === '--projects' || args[i] === '-p') {
+            projects = args[++i].split(',').map(s => s.trim()).filter(Boolean);
+        }
+        else if (args[i] === '--dry-run') {
+            dryRun = true;
+        }
+        else if (args[i] === '--auto-update') {
+            autoUpdate = true;
+        }
+        else if (args[i] === '--no-auto-update') {
+            autoUpdate = false;
+        }
+        else if (args[i] === '--help' || args[i] === '-h') {
+            printHelp();
+            process.exit(0);
+        }
+    }
+    return { workers, capacity, dryRun, projects, autoUpdate };
+}
+function printHelp() {
+    console.log(`
+${colors.cyan}AgentFactory Worker Fleet Manager${colors.reset}
+Spawns and manages multiple worker processes for parallel agent execution.
+
+${colors.yellow}Usage:${colors.reset}
+  af-worker-fleet [options]
+
+${colors.yellow}Options:${colors.reset}
+  -w, --workers <n>   Number of worker processes (default: CPU cores / 2)
+  -c, --capacity <n>  Agents per worker (default: 3)
+  -p, --projects <l>  Comma-separated project names to accept (default: all)
+  --dry-run           Show configuration without starting workers
+  --auto-update       Enable automatic updates (waits for idle workers)
+  --no-auto-update    Disable automatic updates
+  -h, --help          Show this help message
+
+${colors.yellow}Examples:${colors.reset}
+  af-worker-fleet                     # Auto-detect optimal settings
+  af-worker-fleet -w 8 -c 5           # 8 workers x 5 agents = 40 concurrent
+  af-worker-fleet -p Social,Agent     # Only accept Social and Agent projects
+
+${colors.yellow}Environment (loaded from .env.local in CWD):${colors.reset}
+  WORKER_FLEET_SIZE   Override number of workers
+  WORKER_CAPACITY     Override agents per worker
+  WORKER_PROJECTS     Comma-separated project names to accept
+  WORKER_API_URL      API endpoint (required)
+  WORKER_API_KEY      API key for authentication (required)
+
+${colors.yellow}System Info:${colors.reset}
+  CPU Cores: ${os.cpus().length}
+  Total RAM: ${Math.round(os.totalmem() / 1024 / 1024 / 1024)} GB
+  Free RAM:  ${Math.round(os.freemem() / 1024 / 1024 / 1024)} GB
+`);
+}
+// --- Main ---
+const fleetArgs = parseArgs();
+if (!process.env.WORKER_API_URL) {
+    console.error(`${colors.red}Error: WORKER_API_URL environment variable is required${colors.reset}`);
+    process.exit(1);
+}
+if (!process.env.WORKER_API_KEY) {
+    console.error(`${colors.red}Error: WORKER_API_KEY environment variable is required${colors.reset}`);
+    process.exit(1);
+}
+// Create AbortController for graceful shutdown
+const controller = new AbortController();
+process.on('SIGINT', () => controller.abort());
+process.on('SIGTERM', () => controller.abort());
+const projects = fleetArgs.projects ??
+    (process.env.WORKER_PROJECTS
+        ? process.env.WORKER_PROJECTS.split(',').map(s => s.trim()).filter(Boolean)
+        : undefined);
+runWorkerFleet({
+    workers: fleetArgs.workers,
+    capacity: fleetArgs.capacity,
+    dryRun: fleetArgs.dryRun,
+    apiUrl: process.env.WORKER_API_URL,
+    apiKey: process.env.WORKER_API_KEY,
+    projects,
+    autoUpdate: fleetArgs.autoUpdate,
+}, controller.signal)
+    .then(() => {
+    process.exit(0);
+})
+    .catch((err) => {
+    console.error(`${colors.red}Fleet error: ${err instanceof Error ? err.message : String(err)}${colors.reset}`);
+    process.exit(1);
+});

package/dist/src/worker.d.ts

@@ -0,0 +1,26 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Worker CLI
+ *
+ * Local worker that polls the coordinator for work and executes agents.
+ * Thin wrapper around the programmatic runner in ./lib/worker-runner.js.
+ *
+ * Usage:
+ *   af-worker [options]
+ *
+ * Options:
+ *   --capacity <number>   Maximum concurrent agents (default: 3)
+ *   --hostname <name>     Worker hostname (default: os.hostname())
+ *   --api-url <url>       Coordinator API URL (default: WORKER_API_URL env)
+ *   --api-key <key>       API key (default: WORKER_API_KEY env)
+ *   --projects <list>     Comma-separated project names to accept (default: all)
+ *   --dry-run             Poll but don't execute work
+ *
+ * Environment (loaded from .env.local in CWD):
+ *   WORKER_API_URL        Coordinator API URL (e.g., https://agent.example.com)
+ *   WORKER_API_KEY        API key for authentication
+ *   WORKER_PROJECTS       Comma-separated project names to accept (e.g., Social,Agent)
+ *   LINEAR_API_KEY        Required for agent operations
+ */
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/src/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/worker.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/dist/src/worker.js

@@ -0,0 +1,135 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Worker CLI
+ *
+ * Local worker that polls the coordinator for work and executes agents.
+ * Thin wrapper around the programmatic runner in ./lib/worker-runner.js.
+ *
+ * Usage:
+ *   af-worker [options]
+ *
+ * Options:
+ *   --capacity <number>   Maximum concurrent agents (default: 3)
+ *   --hostname <name>     Worker hostname (default: os.hostname())
+ *   --api-url <url>       Coordinator API URL (default: WORKER_API_URL env)
+ *   --api-key <key>       API key (default: WORKER_API_KEY env)
+ *   --projects <list>     Comma-separated project names to accept (default: all)
+ *   --dry-run             Poll but don't execute work
+ *
+ * Environment (loaded from .env.local in CWD):
+ *   WORKER_API_URL        Coordinator API URL (e.g., https://agent.example.com)
+ *   WORKER_API_KEY        API key for authentication
+ *   WORKER_PROJECTS       Comma-separated project names to accept (e.g., Social,Agent)
+ *   LINEAR_API_KEY        Required for agent operations
+ */
+import path from 'path';
+import { config } from 'dotenv';
+// Load environment variables from .env.local in CWD
+config({ path: path.resolve(process.cwd(), '.env.local') });
+import os from 'os';
+import { runWorker } from './lib/worker-runner.js';
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const parsed = {
+        apiUrl: process.env.WORKER_API_URL || 'https://agent.example.com',
+        apiKey: process.env.WORKER_API_KEY || '',
+        hostname: os.hostname(),
+        capacity: 3,
+        dryRun: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--capacity':
+                parsed.capacity = parseInt(args[++i], 10);
+                break;
+            case '--hostname':
+                parsed.hostname = args[++i];
+                break;
+            case '--api-url':
+                parsed.apiUrl = args[++i];
+                break;
+            case '--api-key':
+                parsed.apiKey = args[++i];
+                break;
+            case '--dry-run':
+                parsed.dryRun = true;
+                break;
+            case '--projects':
+                parsed.projects = args[++i].split(',').map(s => s.trim()).filter(Boolean);
+                break;
+            case '--help':
+            case '-h':
+                printHelp();
+                process.exit(0);
+        }
+    }
+    return parsed;
+}
+function printHelp() {
+    console.log(`
+AgentFactory Worker — Remote agent worker for distributed processing
+
+Usage:
+  af-worker [options]
+
+Options:
+  --capacity <number>   Maximum concurrent agents (default: 3)
+  --hostname <name>     Worker hostname (default: ${os.hostname()})
+  --api-url <url>       Coordinator API URL
+  --api-key <key>       API key for authentication
+  --projects <list>     Comma-separated project names to accept (default: all)
+  --dry-run             Poll but don't execute work
+  --help, -h            Show this help message
+
+Environment (loaded from .env.local in CWD):
+  WORKER_API_URL        Coordinator API URL
+  WORKER_API_KEY        API key for authentication
+  WORKER_PROJECTS       Comma-separated project names to accept
+  LINEAR_API_KEY        Required for agent operations
+
+Examples:
+  # Start worker with default settings
+  af-worker
+
+  # Start with custom capacity
+  af-worker --capacity 5
+
+  # Test polling without executing
+  af-worker --dry-run
+`);
+}
+// --- Main ---
+const cliArgs = parseArgs();
+if (!cliArgs.apiKey) {
+    console.error('Error: WORKER_API_KEY environment variable is required');
+    process.exit(1);
+}
+if (!process.env.LINEAR_API_KEY) {
+    console.error('Error: LINEAR_API_KEY environment variable is required');
+    process.exit(1);
+}
+// Create AbortController for graceful shutdown
+const controller = new AbortController();
+process.on('SIGINT', () => controller.abort());
+process.on('SIGTERM', () => controller.abort());
+const projects = cliArgs.projects ??
+    (process.env.WORKER_PROJECTS
+        ? process.env.WORKER_PROJECTS.split(',').map(s => s.trim()).filter(Boolean)
+        : undefined);
+runWorker({
+    apiUrl: cliArgs.apiUrl,
+    apiKey: cliArgs.apiKey,
+    hostname: cliArgs.hostname,
+    capacity: cliArgs.capacity,
+    dryRun: cliArgs.dryRun,
+    linearApiKey: process.env.LINEAR_API_KEY,
+    projects,
+}, controller.signal)
+    .then(() => {
+    process.exit(0);
+})
+    .catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,175 @@
+{
+  "name": "@renseiai/agentfactory-cli",
+  "version": "0.8.0",
+  "type": "module",
+  "description": "CLI tools for AgentFactory — local orchestrator, remote worker, queue admin",
+  "author": "Rensei AI (https://rensei.ai)",
+  "license": "MIT",
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/renseiai/agentfactory",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/renseiai/agentfactory/tree/main/packages/cli",
+  "bugs": {
+    "url": "https://github.com/renseiai/agentfactory/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": {
+        "types": "./dist/src/index.d.ts",
+        "import": "./dist/src/index.js",
+        "default": "./dist/src/index.js"
+      },
+      "./agent": {
+        "types": "./dist/src/lib/agent-runner.d.ts",
+        "import": "./dist/src/lib/agent-runner.js",
+        "default": "./dist/src/lib/agent-runner.js"
+      },
+      "./orchestrator": {
+        "types": "./dist/src/lib/orchestrator-runner.d.ts",
+        "import": "./dist/src/lib/orchestrator-runner.js",
+        "default": "./dist/src/lib/orchestrator-runner.js"
+      },
+      "./cleanup": {
+        "types": "./dist/src/lib/cleanup-runner.d.ts",
+        "import": "./dist/src/lib/cleanup-runner.js",
+        "default": "./dist/src/lib/cleanup-runner.js"
+      },
+      "./worker": {
+        "types": "./dist/src/lib/worker-runner.d.ts",
+        "import": "./dist/src/lib/worker-runner.js",
+        "default": "./dist/src/lib/worker-runner.js"
+      },
+      "./worker-fleet": {
+        "types": "./dist/src/lib/worker-fleet-runner.d.ts",
+        "import": "./dist/src/lib/worker-fleet-runner.js",
+        "default": "./dist/src/lib/worker-fleet-runner.js"
+      },
+      "./queue-admin": {
+        "types": "./dist/src/lib/queue-admin-runner.d.ts",
+        "import": "./dist/src/lib/queue-admin-runner.js",
+        "default": "./dist/src/lib/queue-admin-runner.js"
+      },
+      "./analyze-logs": {
+        "types": "./dist/src/lib/analyze-logs-runner.d.ts",
+        "import": "./dist/src/lib/analyze-logs-runner.js",
+        "default": "./dist/src/lib/analyze-logs-runner.js"
+      },
+      "./linear": {
+        "types": "./dist/src/lib/linear-runner.d.ts",
+        "import": "./dist/src/lib/linear-runner.js",
+        "default": "./dist/src/lib/linear-runner.js"
+      },
+      "./sync-routes": {
+        "types": "./dist/src/lib/sync-routes-runner.d.ts",
+        "import": "./dist/src/lib/sync-routes-runner.js",
+        "default": "./dist/src/lib/sync-routes-runner.js"
+      }
+    },
+    "main": "./dist/src/index.js",
+    "types": "./dist/src/index.d.ts"
+  },
+  "keywords": [
+    "cli",
+    "orchestrator",
+    "worker",
+    "agent-management"
+  ],
+  "bin": {
+    "agentfactory": "./dist/src/index.js",
+    "af-agent": "./dist/src/agent.js",
+    "af-orchestrator": "./dist/src/orchestrator.js",
+    "af-worker": "./dist/src/worker.js",
+    "af-worker-fleet": "./dist/src/worker-fleet.js",
+    "af-cleanup": "./dist/src/cleanup.js",
+    "af-queue-admin": "./dist/src/queue-admin.js",
+    "af-analyze-logs": "./dist/src/analyze-logs.js",
+    "af-linear": "./dist/src/linear.js",
+    "af-governor": "./dist/src/governor.js",
+    "af-sync-routes": "./dist/src/sync-routes.js"
+  },
+  "main": "./dist/src/index.js",
+  "module": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js",
+      "default": "./dist/src/index.js"
+    },
+    "./agent": {
+      "types": "./dist/src/lib/agent-runner.d.ts",
+      "import": "./dist/src/lib/agent-runner.js",
+      "default": "./dist/src/lib/agent-runner.js"
+    },
+    "./orchestrator": {
+      "types": "./dist/src/lib/orchestrator-runner.d.ts",
+      "import": "./dist/src/lib/orchestrator-runner.js",
+      "default": "./dist/src/lib/orchestrator-runner.js"
+    },
+    "./cleanup": {
+      "types": "./dist/src/lib/cleanup-runner.d.ts",
+      "import": "./dist/src/lib/cleanup-runner.js",
+      "default": "./dist/src/lib/cleanup-runner.js"
+    },
+    "./worker": {
+      "types": "./dist/src/lib/worker-runner.d.ts",
+      "import": "./dist/src/lib/worker-runner.js",
+      "default": "./dist/src/lib/worker-runner.js"
+    },
+    "./worker-fleet": {
+      "types": "./dist/src/lib/worker-fleet-runner.d.ts",
+      "import": "./dist/src/lib/worker-fleet-runner.js",
+      "default": "./dist/src/lib/worker-fleet-runner.js"
+    },
+    "./queue-admin": {
+      "types": "./dist/src/lib/queue-admin-runner.d.ts",
+      "import": "./dist/src/lib/queue-admin-runner.js",
+      "default": "./dist/src/lib/queue-admin-runner.js"
+    },
+    "./analyze-logs": {
+      "types": "./dist/src/lib/analyze-logs-runner.d.ts",
+      "import": "./dist/src/lib/analyze-logs-runner.js",
+      "default": "./dist/src/lib/analyze-logs-runner.js"
+    },
+    "./linear": {
+      "types": "./dist/src/lib/linear-runner.d.ts",
+      "import": "./dist/src/lib/linear-runner.js",
+      "default": "./dist/src/lib/linear-runner.js"
+    },
+    "./sync-routes": {
+      "types": "./dist/src/lib/sync-routes-runner.d.ts",
+      "import": "./dist/src/lib/sync-routes-runner.js",
+      "default": "./dist/src/lib/sync-routes-runner.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@renseiai/agentfactory": "workspace:*",
+    "@renseiai/agentfactory-linear": "workspace:*",
+    "@renseiai/agentfactory-server": "workspace:*",
+    "dotenv": "^17.2.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.5.4",
+    "typescript": "^5.7.3",
+    "vitest": "^3.2.3"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "pnpm clean && pnpm build"
+  }
+}