@renseiai/agentfactory-cli 0.8.0

package/dist/src/linear.d.ts

@@ -0,0 +1,37 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Linear CLI
+ *
+ * Thin wrapper around the linear runner.
+ *
+ * Usage:
+ *   af-linear <command> [options]
+ *
+ * Commands:
+ *   get-issue <id>              Get issue details
+ *   create-issue                Create a new issue
+ *   update-issue <id>           Update an existing issue
+ *   list-comments <issueId>     List comments on an issue
+ *   create-comment <issueId>    Create a comment on an issue
+ *   list-backlog-issues         List backlog issues for a project
+ *   list-unblocked-backlog      List unblocked backlog issues
+ *   check-blocked <id>          Check if an issue is blocked
+ *   add-relation <id> <id>      Create relation between issues
+ *   list-relations <id>         List relations for an issue
+ *   remove-relation <id>        Remove a relation by ID
+ *   list-sub-issues <id>        List sub-issues of a parent issue
+ *   list-sub-issue-statuses <id> List sub-issue statuses (lightweight)
+ *   update-sub-issue <id>       Update sub-issue status with comment
+ *   check-deployment <PR>       Check Vercel deployment status for a PR
+ *   create-blocker <source-id>  Create a human-needed blocker issue
+ *
+ * Array Values:
+ *   --labels accepts comma-separated: --labels "Bug,Feature"
+ *   For values with commas, use JSON: --labels '["Bug", "UI, UX"]'
+ *   Text fields (--description, --title, --body) preserve commas.
+ *
+ * Environment:
+ *   LINEAR_API_KEY              Required API key for authentication
+ */
+export {};
+//# sourceMappingURL=linear.d.ts.map

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

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

package/dist/src/linear.js

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Linear CLI
+ *
+ * Thin wrapper around the linear runner.
+ *
+ * Usage:
+ *   af-linear <command> [options]
+ *
+ * Commands:
+ *   get-issue <id>              Get issue details
+ *   create-issue                Create a new issue
+ *   update-issue <id>           Update an existing issue
+ *   list-comments <issueId>     List comments on an issue
+ *   create-comment <issueId>    Create a comment on an issue
+ *   list-backlog-issues         List backlog issues for a project
+ *   list-unblocked-backlog      List unblocked backlog issues
+ *   check-blocked <id>          Check if an issue is blocked
+ *   add-relation <id> <id>      Create relation between issues
+ *   list-relations <id>         List relations for an issue
+ *   remove-relation <id>        Remove a relation by ID
+ *   list-sub-issues <id>        List sub-issues of a parent issue
+ *   list-sub-issue-statuses <id> List sub-issue statuses (lightweight)
+ *   update-sub-issue <id>       Update sub-issue status with comment
+ *   check-deployment <PR>       Check Vercel deployment status for a PR
+ *   create-blocker <source-id>  Create a human-needed blocker issue
+ *
+ * Array Values:
+ *   --labels accepts comma-separated: --labels "Bug,Feature"
+ *   For values with commas, use JSON: --labels '["Bug", "UI, UX"]'
+ *   Text fields (--description, --title, --body) preserve commas.
+ *
+ * Environment:
+ *   LINEAR_API_KEY              Required API key for authentication
+ */
+import path from 'path';
+import { config } from 'dotenv';
+// Load environment variables from .env.local
+config({ path: path.resolve(process.cwd(), '.env.local') });
+import { runLinear, parseLinearArgs } from './lib/linear-runner.js';
+function printHelp() {
+    console.log(`
+AgentFactory Linear CLI — Linear issue tracker operations
+
+Usage:
+  af-linear <command> [options]
+
+Commands:
+  get-issue <id>                Get issue details
+  create-issue                  Create a new issue
+  update-issue <id>             Update an existing issue
+  list-comments <issueId>       List comments on an issue
+  create-comment <issueId>      Create a comment on an issue
+  list-backlog-issues           List backlog issues for a project
+  list-unblocked-backlog        List unblocked backlog issues
+  check-blocked <id>            Check if an issue is blocked
+  add-relation <id> <id>        Create relation between issues
+  list-relations <id>           List relations for an issue
+  remove-relation <id>          Remove a relation by ID
+  list-sub-issues <id>          List sub-issues of a parent issue
+  list-sub-issue-statuses <id>  List sub-issue statuses (lightweight)
+  update-sub-issue <id>         Update sub-issue status with comment
+  check-deployment <PR>         Check Vercel deployment status for a PR
+  create-blocker <source-id>    Create a human-needed blocker issue
+  help                          Show this help message
+
+Options:
+  --help, -h                    Show this help message
+
+Array Values:
+  --labels accepts comma-separated: --labels "Bug,Feature"
+  For values with commas, use JSON: --labels '["Bug", "UI, UX"]'
+
+Environment:
+  LINEAR_API_KEY                Required API key for authentication
+  LINEAR_ACCESS_TOKEN           Alternative to LINEAR_API_KEY
+
+Examples:
+  af-linear get-issue PROJ-123
+  af-linear create-issue --title "Add auth" --team "Engineering" --project "Backend"
+  af-linear update-issue PROJ-123 --state "Finished"
+  af-linear list-backlog-issues --project "MyProject"
+  af-linear check-deployment 42
+`);
+}
+async function main() {
+    const { command, args, positionalArgs } = parseLinearArgs(process.argv.slice(2));
+    if (!command || command === 'help' || args['help'] || args['h']) {
+        printHelp();
+        return;
+    }
+    const apiKey = process.env.LINEAR_API_KEY || process.env.LINEAR_ACCESS_TOKEN;
+    const result = await runLinear({
+        command,
+        args,
+        positionalArgs,
+        apiKey,
+    });
+    // check-deployment with markdown format outputs a string, not JSON
+    if (typeof result.output === 'string') {
+        console.log(result.output);
+    }
+    else {
+        console.log(JSON.stringify(result.output, null, 2));
+    }
+    // Exit with error code if deployment check failed
+    if (command === 'check-deployment' &&
+        typeof result.output === 'object' &&
+        result.output !== null &&
+        'anyFailed' in result.output &&
+        result.output.anyFailed) {
+        process.exit(1);
+    }
+}
+main().catch((error) => {
+    console.error('Error:', error instanceof Error ? error.message : error);
+    process.exit(1);
+});

package/dist/src/orchestrator.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Orchestrator CLI
+ *
+ * Thin wrapper around the orchestrator runner.
+ *
+ * Usage:
+ *   af-orchestrator [options]
+ *
+ * Options:
+ *   --project <name>    Filter issues by project name
+ *   --max <number>      Maximum concurrent agents (default: 3)
+ *   --single <id>       Process a single issue by ID
+ *   --no-wait           Don't wait for agents to complete
+ *   --dry-run           Show what would be done without executing
+ *
+ * Environment:
+ *   LINEAR_API_KEY      Required API key for Linear authentication
+ */
+export {};
+//# sourceMappingURL=orchestrator.d.ts.map

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

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

package/dist/src/orchestrator.js

@@ -0,0 +1,190 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Orchestrator CLI
+ *
+ * Thin wrapper around the orchestrator runner.
+ *
+ * Usage:
+ *   af-orchestrator [options]
+ *
+ * Options:
+ *   --project <name>    Filter issues by project name
+ *   --max <number>      Maximum concurrent agents (default: 3)
+ *   --single <id>       Process a single issue by ID
+ *   --no-wait           Don't wait for agents to complete
+ *   --dry-run           Show what would be done without executing
+ *
+ * Environment:
+ *   LINEAR_API_KEY      Required API key for Linear authentication
+ */
+import path from 'path';
+import { config } from 'dotenv';
+// Load environment variables from .env.local
+config({ path: path.resolve(process.cwd(), '.env.local') });
+import { runOrchestrator } from './lib/orchestrator-runner.js';
+import { getVersion, checkForUpdate, printUpdateNotification } from './lib/version.js';
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = {
+        project: undefined,
+        max: 3,
+        single: undefined,
+        wait: true,
+        dryRun: false,
+        templates: undefined,
+        repo: undefined,
+        workType: undefined,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--project':
+                result.project = args[++i];
+                break;
+            case '--max':
+                result.max = parseInt(args[++i], 10);
+                break;
+            case '--single':
+                result.single = args[++i];
+                break;
+            case '--no-wait':
+                result.wait = false;
+                break;
+            case '--dry-run':
+                result.dryRun = true;
+                break;
+            case '--templates':
+                result.templates = args[++i];
+                break;
+            case '--repo':
+                result.repo = args[++i];
+                break;
+            case '--work-type':
+                result.workType = args[++i];
+                break;
+            case '--help':
+            case '-h':
+                printHelp();
+                process.exit(0);
+        }
+    }
+    return result;
+}
+function printHelp() {
+    console.log(`
+AgentFactory Orchestrator — Multi-agent fleet management for coding agents
+
+Usage:
+  af-orchestrator [options]
+
+Options:
+  --project <name>    Filter issues by project name
+  --max <number>      Maximum concurrent agents (default: 3)
+  --single <id>       Process a single issue by ID
+  --no-wait           Don't wait for agents to complete
+  --dry-run           Show what would be done without executing
+  --templates <path>  Custom workflow template directory
+  --repo <url>        Git repository URL for worktree cloning
+  --work-type <type>  Force work type (use with --single)
+  --help, -h          Show this help message
+
+Environment:
+  LINEAR_API_KEY      Required API key for Linear authentication
+
+Examples:
+  # Process up to 3 backlog issues from a project
+  af-orchestrator --project MyProject
+
+  # Process a specific issue
+  af-orchestrator --single PROJ-123
+
+  # Preview what issues would be processed
+  af-orchestrator --project MyProject --dry-run
+`);
+}
+async function main() {
+    const args = parseArgs();
+    if (!process.env.LINEAR_API_KEY) {
+        console.error('Error: LINEAR_API_KEY environment variable is required');
+        process.exit(1);
+    }
+    const version = getVersion();
+    console.log(`AgentFactory Orchestrator \x1b[2mv${version}\x1b[0m`);
+    console.log('========================');
+    console.log(`Project: ${args.project ?? 'All'}`);
+    console.log(`Max concurrent: ${args.max}`);
+    console.log(`Repo: ${args.repo ?? 'Any'}`);
+    console.log(`Dry run: ${args.dryRun}`);
+    console.log('');
+    // Update check (non-blocking)
+    const updateCheck = await checkForUpdate();
+    printUpdateNotification(updateCheck);
+    if (args.single) {
+        console.log(`Processing single issue: ${args.single}`);
+        if (args.dryRun) {
+            console.log('[DRY RUN] Would spawn agent for:', args.single);
+            return;
+        }
+    }
+    try {
+        const result = await runOrchestrator({
+            linearApiKey: process.env.LINEAR_API_KEY,
+            project: args.project,
+            max: args.max,
+            single: args.single,
+            wait: args.wait,
+            dryRun: args.dryRun,
+            templateDir: args.templates,
+            repository: args.repo,
+            workType: args.workType,
+        });
+        if (!args.single && !args.dryRun) {
+            console.log('');
+            console.log('Orchestrator started');
+            console.log(`  Agents spawned: ${result.agentsSpawned}`);
+            console.log(`  Errors: ${result.errors.length}`);
+            if (result.errors.length > 0) {
+                console.log('');
+                console.log('Errors:');
+                for (const { issueId, error } of result.errors) {
+                    console.log(`  ${issueId}: ${error.message}`);
+                }
+            }
+        }
+        if (args.single) {
+            console.log(`Agent spawned for ${args.single}`);
+        }
+        if (args.wait && result.completed.length > 0) {
+            console.log('');
+            console.log('All agents completed');
+            console.log('Results:');
+            for (const agent of result.completed) {
+                const duration = agent.completedAt
+                    ? formatDuration(agent.completedAt.getTime() - agent.startedAt.getTime())
+                    : 'unknown';
+                const status = agent.status === 'completed' ? 'SUCCESS' : 'FAILED';
+                console.log(`  ${agent.identifier}: ${status} (${duration})`);
+            }
+        }
+    }
+    catch (error) {
+        console.error('Orchestrator failed:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+function formatDuration(ms) {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    if (hours > 0) {
+        return `${hours}h ${minutes % 60}m ${seconds % 60}s`;
+    }
+    if (minutes > 0) {
+        return `${minutes}m ${seconds % 60}s`;
+    }
+    return `${seconds}s`;
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});

package/dist/src/queue-admin.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Queue Admin CLI
+ *
+ * Thin wrapper around the queue-admin runner. Handles dotenv, arg parsing,
+ * and process.exit so the runner stays process-agnostic.
+ *
+ * Usage:
+ *   af-queue-admin <command>
+ *
+ * Commands:
+ *   list             List all queued work items
+ *   sessions         List all sessions
+ *   workers          List all registered workers
+ *   clear-claims     Clear stale work claims
+ *   clear-queue      Clear the work queue
+ *   clear-all        Clear queue, sessions, claims, and workers
+ *   reset            Full state reset (claims + queue + stuck sessions)
+ *   remove <id>      Remove a specific session by ID (partial match)
+ *
+ * Environment (loaded from .env.local in CWD):
+ *   REDIS_URL        Required for Redis connection
+ */
+export {};
+//# sourceMappingURL=queue-admin.d.ts.map

package/dist/src/queue-admin.d.ts.map

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

package/dist/src/queue-admin.js

@@ -0,0 +1,96 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Queue Admin CLI
+ *
+ * Thin wrapper around the queue-admin runner. Handles dotenv, arg parsing,
+ * and process.exit so the runner stays process-agnostic.
+ *
+ * Usage:
+ *   af-queue-admin <command>
+ *
+ * Commands:
+ *   list             List all queued work items
+ *   sessions         List all sessions
+ *   workers          List all registered workers
+ *   clear-claims     Clear stale work claims
+ *   clear-queue      Clear the work queue
+ *   clear-all        Clear queue, sessions, claims, and workers
+ *   reset            Full state reset (claims + queue + stuck sessions)
+ *   remove <id>      Remove a specific session by ID (partial match)
+ *
+ * Environment (loaded from .env.local in CWD):
+ *   REDIS_URL        Required for Redis connection
+ */
+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 { runQueueAdmin, C } from './lib/queue-admin-runner.js';
+// ---------------------------------------------------------------------------
+// Usage
+// ---------------------------------------------------------------------------
+function printUsage() {
+    console.log(`
+${C.cyan}AgentFactory Queue Admin${C.reset} - Manage Redis work queue and sessions
+
+${C.yellow}Usage:${C.reset}
+  af-queue-admin <command>
+
+${C.yellow}Commands:${C.reset}
+  list             List all queued work items
+  sessions         List all sessions
+  workers          List all registered workers
+  clear-claims     Clear stale work claims
+  clear-queue      Clear the work queue
+  clear-all        Clear queue, sessions, claims, and workers
+  reset            Full state reset (claims + queue + stuck sessions)
+  remove <id>      Remove a specific session by ID (partial match)
+
+${C.yellow}Examples:${C.reset}
+  af-queue-admin list
+  af-queue-admin sessions
+  af-queue-admin clear-queue
+  af-queue-admin reset
+  af-queue-admin remove abc123
+`);
+}
+// ---------------------------------------------------------------------------
+// Valid commands
+// ---------------------------------------------------------------------------
+const VALID_COMMANDS = new Set([
+    'list',
+    'sessions',
+    'workers',
+    'clear-claims',
+    'clear-queue',
+    'clear-all',
+    'reset',
+    'remove',
+]);
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    const command = process.argv[2];
+    const arg = process.argv[3];
+    if (!command || command === 'help' || command === '--help' || command === '-h') {
+        printUsage();
+        return;
+    }
+    if (!VALID_COMMANDS.has(command)) {
+        printUsage();
+        return;
+    }
+    if (command === 'remove' && !arg) {
+        console.error('Usage: af-queue-admin remove <session-id>');
+        process.exit(1);
+    }
+    await runQueueAdmin({
+        command: command,
+        sessionId: arg,
+    });
+}
+main().catch((error) => {
+    console.error('Error:', error instanceof Error ? error.message : error);
+    process.exit(1);
+});

package/dist/src/sync-routes.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Route Sync CLI
+ *
+ * Generates missing route.ts and page.tsx files from the route manifest.
+ *
+ * Usage:
+ *   af-sync-routes [options]
+ *
+ * Options:
+ *   --dry-run       Preview what would be created
+ *   --pages         Also sync dashboard page.tsx files
+ *   --app-dir <p>   Custom app directory (default: src/app)
+ *   --help, -h      Show this help message
+ */
+export {};
+//# sourceMappingURL=sync-routes.d.ts.map

package/dist/src/sync-routes.d.ts.map

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

package/dist/src/sync-routes.js

@@ -0,0 +1,100 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Route Sync CLI
+ *
+ * Generates missing route.ts and page.tsx files from the route manifest.
+ *
+ * Usage:
+ *   af-sync-routes [options]
+ *
+ * Options:
+ *   --dry-run       Preview what would be created
+ *   --pages         Also sync dashboard page.tsx files
+ *   --app-dir <p>   Custom app directory (default: src/app)
+ *   --help, -h      Show this help message
+ */
+import { runSyncRoutes } from './lib/sync-routes-runner.js';
+function parseArgs() {
+    const args = process.argv.slice(2);
+    const result = {
+        dryRun: false,
+        pages: false,
+        help: false,
+    };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        switch (arg) {
+            case '--dry-run':
+                result.dryRun = true;
+                break;
+            case '--pages':
+                result.pages = true;
+                break;
+            case '--app-dir':
+                result.appDir = args[++i];
+                break;
+            case '--help':
+            case '-h':
+                result.help = true;
+                break;
+        }
+    }
+    return result;
+}
+function printHelp() {
+    console.log(`
+AgentFactory Route Sync — Generate missing route and page files
+
+Usage:
+  af-sync-routes [options]
+
+Options:
+  --dry-run       Preview what would be created without writing files
+  --pages         Also sync dashboard page.tsx files (requires @renseiai/agentfactory-dashboard)
+  --app-dir <p>   Custom app directory (default: src/app)
+  --help, -h      Show this help message
+
+Examples:
+  # Preview missing routes
+  af-sync-routes --dry-run
+
+  # Create missing route files
+  af-sync-routes
+
+  # Also sync dashboard pages
+  af-sync-routes --pages
+
+  # After upgrading @renseiai packages
+  pnpm bump:af && af-sync-routes --pages
+`);
+}
+function main() {
+    const args = parseArgs();
+    if (args.help) {
+        printHelp();
+        return;
+    }
+    console.log('\n=== AgentFactory Route Sync ===\n');
+    if (args.dryRun) {
+        console.log('[DRY RUN MODE - No files will be written]\n');
+    }
+    const result = runSyncRoutes({
+        dryRun: args.dryRun,
+        pages: args.pages,
+        appDir: args.appDir,
+    });
+    // Print warnings
+    for (const warning of result.warnings) {
+        console.log(`\n  warning: ${warning}`);
+    }
+    // Print summary
+    console.log(`\nSummary: checked=${result.checked} created=${result.created} skipped=${result.skipped} errors=${result.errors.length}`);
+    if (result.errors.length > 0) {
+        console.error('\nErrors:');
+        for (const err of result.errors) {
+            console.error(`  ${err.path}: ${err.error}`);
+        }
+        process.exit(1);
+    }
+}
+main();

package/dist/src/worker-fleet.d.ts

@@ -0,0 +1,25 @@
+#!/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)
+ */
+export {};
+//# sourceMappingURL=worker-fleet.d.ts.map

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

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