@renseiai/agentfactory-cli 0.8.7 → 0.8.9

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,QAAA,MAAM,OAAO,QAAkB,CAAA;AAE/B,iBAAS,SAAS,IAAI,IAAI,CAwBzB"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,QAAA,MAAM,OAAO,QAAkB,CAAA;AAE/B,iBAAS,SAAS,IAAI,IAAI,CAyBzB"}

package/dist/src/index.js

@@ -25,6 +25,7 @@ Commands:
   analyze-logs    Analyze agent session logs for errors
   linear          Linear issue tracker operations
   sync-routes     Generate missing route and page files from manifest
+  status          Show fleet status (inline one-line summary)
   help            Show this help message
 
 Run 'agentfactory <command> --help' for command-specific options.
@@ -63,6 +64,9 @@ switch (command) {
     case 'sync-routes':
         import('./sync-routes');
         break;
+    case 'status':
+        import('./status');
+        break;
     case 'help':
     case '--help':
     case '-h':

package/dist/src/lib/agent-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/agent-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAA;AAE5E,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,OAAO,EAAE,YAAY,CAAA;IACrB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAMD,eAAO,MAAM,CAAC;;;;;;;CAOJ,CAAA;AAuRV,wBAAsB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBvE"}
+{"version":3,"file":"agent-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/agent-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAiBH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAA;AAE5E,MAAM,WAAW,iBAAiB;IAChC,yBAAyB;IACzB,OAAO,EAAE,YAAY,CAAA;IACrB,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wEAAwE;IACxE,GAAG,CAAC,EAAE,OAAO,CAAA;CACd;AAMD,eAAO,MAAM,CAAC;;;;;;;CAOJ,CAAA;AA8RV,wBAAsB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBvE"}

package/dist/src/lib/agent-runner.js

@@ -5,7 +5,7 @@
  * agent sessions. Works by updating Redis state directly — workers poll for
  * status changes and pending prompts every 5 seconds.
  */
-import { getRedisClient, getAllSessions, updateSessionStatus, storeSessionState, storePendingPrompt, disconnectRedis, } from '@renseiai/agentfactory-server';
+import { getRedisClient, getAllSessions, updateSessionStatus, storeSessionState, publishUrgent, disconnectRedis, } from '@renseiai/agentfactory-server';
 import { createLinearAgentClient } from '@renseiai/plugin-linear';
 // ---------------------------------------------------------------------------
 // ANSI colors
@@ -114,12 +114,23 @@ async function chatWithAgent(issueId, message) {
         await disconnectRedis();
         return;
     }
-    const prompt = await storePendingPrompt(session.linearSessionId, session.issueId, message);
-    if (prompt) {
-        console.log(`${C.green}Message queued${C.reset} (id: ${prompt.id}) — worker will pick up within ~5 seconds`);
+    const agentId = session.agentId;
+    if (!agentId) {
+        console.error(`${C.red}Session has no agentId — cannot publish to inbox${C.reset}`);
+        await disconnectRedis();
+        return;
     }
-    else {
-        console.error(`${C.red}Failed to store pending prompt${C.reset}`);
+    try {
+        const streamId = await publishUrgent(agentId, {
+            type: 'directive',
+            sessionId: session.linearSessionId,
+            payload: message,
+            createdAt: Date.now(),
+        });
+        console.log(`${C.green}Message queued${C.reset} (id: ${streamId}) — worker will pick up within ~5 seconds`);
+    }
+    catch (err) {
+        console.error(`${C.red}Failed to publish to inbox: ${err instanceof Error ? err.message : String(err)}${C.reset}`);
     }
     await disconnectRedis();
 }

package/dist/src/lib/status-runner.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Status Runner -- Programmatic API for the af-status CLI.
+ *
+ * Provides fleet status via the AgentFactory public API.
+ * In TTY mode, spawns the Go `af-status` binary for rich inline output.
+ * In piped/JSON mode, fetches stats directly from Node.js.
+ */
+export interface StatusRunnerConfig {
+    /** Output raw JSON instead of human-readable format */
+    json?: boolean;
+    /** Enable auto-refresh watch mode */
+    watch?: boolean;
+    /** Watch interval (e.g., "1s", "5s") — only used with watch */
+    interval?: string;
+    /** API base URL override */
+    url?: string;
+}
+export declare const C: {
+    readonly reset: "\u001B[0m";
+    readonly red: "\u001B[31m";
+    readonly green: "\u001B[32m";
+    readonly yellow: "\u001B[33m";
+    readonly cyan: "\u001B[36m";
+    readonly gray: "\u001B[90m";
+};
+export declare function runStatus(config: StatusRunnerConfig): Promise<void>;
+//# sourceMappingURL=status-runner.d.ts.map

package/dist/src/lib/status-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/status-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAaH,MAAM,WAAW,kBAAkB;IACjC,uDAAuD;IACvD,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAA;CACb;AAMD,eAAO,MAAM,CAAC;;;;;;;CAOJ,CAAA;AAuEV,wBAAsB,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBzE"}

package/dist/src/lib/status-runner.js

@@ -0,0 +1,101 @@
+/**
+ * Status Runner -- Programmatic API for the af-status CLI.
+ *
+ * Provides fleet status via the AgentFactory public API.
+ * In TTY mode, spawns the Go `af-status` binary for rich inline output.
+ * In piped/JSON mode, fetches stats directly from Node.js.
+ */
+import { spawn } from 'child_process';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+// ---------------------------------------------------------------------------
+// ANSI colors (same as agent-runner)
+// ---------------------------------------------------------------------------
+export const C = {
+    reset: '\x1b[0m',
+    red: '\x1b[31m',
+    green: '\x1b[32m',
+    yellow: '\x1b[33m',
+    cyan: '\x1b[36m',
+    gray: '\x1b[90m',
+};
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function getBaseURL(override) {
+    return override ?? process.env.WORKER_API_URL ?? 'http://localhost:3000';
+}
+async function fetchStats(baseURL) {
+    const url = `${baseURL.replace(/\/+$/, '')}/api/public/stats`;
+    const resp = await fetch(url);
+    if (!resp.ok) {
+        throw new Error(`API request failed: ${resp.status} ${resp.statusText}`);
+    }
+    return resp.json();
+}
+function resolveGoBinary() {
+    // Go binary lives in packages/tui/bin/af-status relative to the CLI package
+    return path.resolve(__dirname, '../../tui/bin/af-status');
+}
+// ---------------------------------------------------------------------------
+// Command handlers
+// ---------------------------------------------------------------------------
+async function showJSON(baseURL) {
+    const stats = await fetchStats(baseURL);
+    console.log(JSON.stringify(stats, null, 2));
+}
+function spawnGoBinary(config, baseURL) {
+    return new Promise((resolve, reject) => {
+        const binPath = resolveGoBinary();
+        const args = ['--url', baseURL];
+        if (config.json)
+            args.push('--json');
+        if (config.watch)
+            args.push('--watch');
+        if (config.interval)
+            args.push('--interval', config.interval);
+        const child = spawn(binPath, args, {
+            stdio: 'inherit',
+        });
+        child.on('error', (err) => {
+            if (err.code === 'ENOENT') {
+                // Go binary not built yet — fall back to Node.js JSON output
+                console.error(`${C.yellow}Go binary not found at ${binPath}${C.reset}`);
+                console.error(`${C.gray}Falling back to JSON output. Build with: cd packages/tui && make build-status${C.reset}`);
+                showJSON(baseURL).then(resolve, reject);
+            }
+            else {
+                reject(err);
+            }
+        });
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`af-status exited with code ${code}`));
+            }
+        });
+    });
+}
+// ---------------------------------------------------------------------------
+// Public entry point
+// ---------------------------------------------------------------------------
+export async function runStatus(config) {
+    const baseURL = getBaseURL(config.url);
+    const isTTY = process.stdout.isTTY ?? false;
+    // If piped (non-TTY) and not explicitly requesting watch, default to JSON
+    if (!isTTY && !config.watch) {
+        await showJSON(baseURL);
+        return;
+    }
+    // If --json flag without watch, just fetch and print
+    if (config.json && !config.watch) {
+        await showJSON(baseURL);
+        return;
+    }
+    // TTY mode or watch mode — delegate to Go binary
+    await spawnGoBinary(config, baseURL);
+}

package/dist/src/lib/worker-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/worker-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AAwED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAy7Bf"}
+{"version":3,"file":"worker-runner.d.ts","sourceRoot":"","sources":["../../../src/lib/worker-runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAyBH,MAAM,WAAW,kBAAkB;IACjC,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mDAAmD;IACnD,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CACpB;AA4ED;;;;;GAKG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,kBAAkB,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAi/Bf"}

package/dist/src/lib/worker-runner.js

@@ -245,7 +245,7 @@ export async function runWorker(config, signal) {
         if (result.data) {
             consecutiveHeartbeatFailures = 0;
             if (claimFailureCount > 0) {
-                log.info('Claim race summary since last heartbeat', { claimFailures: claimFailureCount });
+                log.debug('Claim race summary since last heartbeat', { claimFailures: claimFailureCount });
                 claimFailureCount = 0;
             }
             log.debug('Heartbeat acknowledged', {
@@ -277,25 +277,26 @@ export async function runWorker(config, signal) {
     // -----------------------------------------------------------------------
     async function pollForWork() {
         if (!workerId)
-            return { work: [], pendingPrompts: {}, hasPendingPrompts: false };
+            return { work: [], inboxMessages: {}, hasInboxMessages: false };
         const result = await apiRequestWithError(`/api/workers/${workerId}/poll`);
         if (result.error?.type === 'worker_not_found') {
             await attemptReregistration();
-            return { work: [], pendingPrompts: {}, hasPendingPrompts: false };
+            return { work: [], inboxMessages: {}, hasInboxMessages: false };
         }
         if (!result.data) {
-            return { work: [], pendingPrompts: {}, hasPendingPrompts: false };
+            return { work: [], inboxMessages: {}, hasInboxMessages: false };
         }
         const pollData = result.data;
-        if (pollData.hasPendingPrompts) {
-            const totalPrompts = Object.values(pollData.pendingPrompts).reduce((sum, prompts) => sum + prompts.length, 0);
-            log.info('Received pending prompts', {
-                sessionCount: Object.keys(pollData.pendingPrompts).length,
-                totalPrompts,
-                sessions: Object.entries(pollData.pendingPrompts).map(([sessionId, prompts]) => ({
+        if (pollData.hasInboxMessages) {
+            const totalMessages = Object.values(pollData.inboxMessages).reduce((sum, messages) => sum + messages.length, 0);
+            log.info('Received inbox messages', {
+                sessionCount: Object.keys(pollData.inboxMessages).length,
+                totalMessages,
+                sessions: Object.entries(pollData.inboxMessages).map(([sessionId, messages]) => ({
                     sessionId: sessionId.substring(0, 8),
-                    promptCount: prompts.length,
-                    promptIds: prompts.map((p) => p.id),
+                    messageCount: messages.length,
+                    messageIds: messages.map((m) => m.id),
+                    types: messages.map((m) => m.type),
                 })),
             });
         }
@@ -309,6 +310,15 @@ export async function runWorker(config, signal) {
             body: JSON.stringify({ workerId }),
         });
     }
+    async function ackInboxMessage(sessionId, message) {
+        await apiRequest(`/api/sessions/${sessionId}/inbox/ack`, {
+            method: 'POST',
+            body: JSON.stringify({
+                messageId: message.id,
+                lane: message.lane,
+            }),
+        });
+    }
     async function reportStatus(sessionId, status, extra) {
         if (!workerId)
             return;
@@ -672,10 +682,27 @@ export async function runWorker(config, signal) {
                     log.info(`Found ${pollResult.work.length} work item(s)`, {
                         activeCount,
                         availableCapacity,
+                        preClaimed: pollResult.preClaimed ?? false,
                     });
                     for (const item of pollResult.work.slice(0, availableCapacity)) {
                         if (!running)
                             break;
+                        // Server-side claiming: items are already claimed during poll
+                        if (pollResult.preClaimed) {
+                            log.status('claimed', item.issueIdentifier);
+                            if (workerConfig.dryRun) {
+                                log.info(`[DRY RUN] Would execute: ${item.issueIdentifier}`);
+                            }
+                            else {
+                                executeWork(item).catch((error) => {
+                                    log.error('Background work execution failed', {
+                                        error: error instanceof Error ? error.message : String(error),
+                                    });
+                                });
+                            }
+                            continue;
+                        }
+                        // Legacy client-side claiming (fallback for older servers)
                         const claimResult = await claimWork(item.sessionId);
                         if (claimResult?.claimed) {
                             log.status('claimed', item.issueIdentifier);
@@ -696,68 +723,94 @@ export async function runWorker(config, signal) {
                         }
                     }
                 }
-                // Handle pending prompts for active sessions
-                if (pollResult.hasPendingPrompts) {
-                    for (const [sessionId, prompts] of Object.entries(pollResult.pendingPrompts)) {
-                        for (const prompt of prompts) {
-                            log.info('Processing pending prompt', {
+                // Handle inbox messages for active sessions (urgent-first)
+                if (pollResult.hasInboxMessages) {
+                    for (const [sessionId, messages] of Object.entries(pollResult.inboxMessages)) {
+                        for (const message of messages) {
+                            // Handle nudge: no-op wake signal, just discard
+                            if (message.type === 'nudge') {
+                                log.debug('Nudge received (no-op)', {
+                                    sessionId: sessionId.substring(0, 8),
+                                    messageId: message.id,
+                                });
+                                await ackInboxMessage(sessionId, message);
+                                continue;
+                            }
+                            const orchestrator = activeOrchestrators.get(sessionId);
+                            // Handle stop signal: trigger graceful agent shutdown
+                            if (message.type === 'stop') {
+                                log.info('Stop signal received', {
+                                    sessionId: sessionId.substring(0, 8),
+                                    messageId: message.id,
+                                });
+                                if (orchestrator) {
+                                    const agent = orchestrator.getAgentBySession(sessionId);
+                                    if (agent) {
+                                        try {
+                                            await orchestrator.stopAgent(agent.issueId, false);
+                                            log.success('Agent stopped via inbox signal', {
+                                                sessionId: sessionId.substring(0, 8),
+                                            });
+                                        }
+                                        catch (error) {
+                                            log.error('Failed to stop agent', {
+                                                sessionId: sessionId.substring(0, 8),
+                                                error: error instanceof Error ? error.message : String(error),
+                                            });
+                                        }
+                                    }
+                                }
+                                await ackInboxMessage(sessionId, message);
+                                continue;
+                            }
+                            // Handle directive and hook-result: inject as follow-up prompt
+                            log.info('Processing inbox message', {
                                 sessionId: sessionId.substring(0, 8),
-                                promptId: prompt.id,
-                                promptLength: prompt.prompt.length,
-                                userName: prompt.userName,
+                                messageId: message.id,
+                                type: message.type,
+                                lane: message.lane,
+                                payloadLength: message.payload.length,
+                                userName: message.userName,
                             });
-                            const orchestrator = activeOrchestrators.get(sessionId);
                             if (!orchestrator) {
                                 log.warn('No active orchestrator found for session', {
                                     sessionId: sessionId.substring(0, 8),
-                                    promptId: prompt.id,
+                                    messageId: message.id,
                                 });
                                 continue;
                             }
                             const agent = orchestrator.getAgentBySession(sessionId);
                             const providerSessionId = agent?.providerSessionId;
-                            log.info('Forwarding prompt to provider session', {
-                                sessionId: sessionId.substring(0, 8),
-                                promptId: prompt.id,
-                                hasProviderSession: !!providerSessionId,
-                                agentStatus: agent?.status,
-                            });
                             try {
-                                const result = await orchestrator.forwardPrompt(prompt.issueId, sessionId, prompt.prompt, providerSessionId, agent?.workType);
+                                const result = await orchestrator.forwardPrompt(agent?.issueId ?? '', sessionId, message.payload, providerSessionId, agent?.workType);
                                 if (result.forwarded) {
                                     log.success(result.injected
                                         ? 'Message injected into running session'
-                                        : 'Prompt forwarded successfully', {
+                                        : 'Inbox message forwarded successfully', {
                                         sessionId: sessionId.substring(0, 8),
-                                        promptId: prompt.id,
+                                        messageId: message.id,
+                                        type: message.type,
                                         injected: result.injected ?? false,
                                         resumed: result.resumed,
                                         newAgentPid: result.agent?.pid,
                                     });
-                                    const claimResult = await apiRequest(`/api/sessions/${sessionId}/prompts`, {
-                                        method: 'POST',
-                                        body: JSON.stringify({ promptId: prompt.id }),
-                                    });
-                                    if (claimResult?.claimed) {
-                                        log.debug('Prompt claimed', { promptId: prompt.id });
-                                    }
-                                    else {
-                                        log.warn('Failed to claim prompt', { promptId: prompt.id });
-                                    }
+                                    // ACK after successful delivery
+                                    await ackInboxMessage(sessionId, message);
                                 }
                                 else {
-                                    log.error('Failed to forward prompt', {
+                                    log.error('Failed to forward inbox message', {
                                         sessionId: sessionId.substring(0, 8),
-                                        promptId: prompt.id,
+                                        messageId: message.id,
+                                        type: message.type,
                                         reason: result.reason,
                                         error: result.error?.message,
                                     });
                                 }
                             }
                             catch (error) {
-                                log.error('Error forwarding prompt', {
+                                log.error('Error forwarding inbox message', {
                                     sessionId: sessionId.substring(0, 8),
-                                    promptId: prompt.id,
+                                    messageId: message.id,
                                     error: error instanceof Error ? error.message : String(error),
                                 });
                             }
@@ -770,8 +823,9 @@ export async function runWorker(config, signal) {
                     error: error instanceof Error ? error.message : String(error),
                 });
             }
-            // Wait before next poll
-            await new Promise((resolve) => setTimeout(resolve, registration.pollInterval));
+            // Wait before next poll (with jitter to desynchronize workers)
+            const jitter = Math.floor(Math.random() * registration.pollInterval * 0.4);
+            await new Promise((resolve) => setTimeout(resolve, registration.pollInterval + jitter));
         }
     }
     finally {

package/dist/src/status.d.ts

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Status CLI
+ *
+ * Quick fleet status checks for terminal and scripting use.
+ *
+ * Usage:
+ *   af-status                      One-line fleet summary (via Go binary in TTY)
+ *   af-status --json               JSON stats to stdout
+ *   af-status --watch              Auto-refresh every 3 seconds
+ *   af-status --watch --interval 5s  Custom refresh interval
+ *   af-status | jq                 Pipe-friendly (auto-detects non-TTY)
+ *
+ * Environment (loaded from .env.local in CWD):
+ *   WORKER_API_URL     API base URL (default: http://localhost:3000)
+ */
+export {};
+//# sourceMappingURL=status.d.ts.map

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

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

package/dist/src/status.js

@@ -0,0 +1,78 @@
+#!/usr/bin/env node
+/**
+ * AgentFactory Status CLI
+ *
+ * Quick fleet status checks for terminal and scripting use.
+ *
+ * Usage:
+ *   af-status                      One-line fleet summary (via Go binary in TTY)
+ *   af-status --json               JSON stats to stdout
+ *   af-status --watch              Auto-refresh every 3 seconds
+ *   af-status --watch --interval 5s  Custom refresh interval
+ *   af-status | jq                 Pipe-friendly (auto-detects non-TTY)
+ *
+ * Environment (loaded from .env.local in CWD):
+ *   WORKER_API_URL     API base URL (default: http://localhost:3000)
+ */
+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 { runStatus, C } from './lib/status-runner.js';
+// ---------------------------------------------------------------------------
+// Usage
+// ---------------------------------------------------------------------------
+function printUsage() {
+    console.log(`
+${C.cyan}AgentFactory Status${C.reset} - Quick fleet status checks
+
+${C.yellow}Usage:${C.reset}
+  af-status [options]
+
+${C.yellow}Options:${C.reset}
+  --json                Output raw JSON stats to stdout
+  --watch               Auto-refresh status every 3 seconds
+  --interval <duration> Custom refresh interval (e.g., 1s, 5s) [default: 3s]
+  --url <url>           API base URL [default: WORKER_API_URL or http://localhost:3000]
+  --help, -h            Show this help message
+
+${C.yellow}Examples:${C.reset}
+  af-status                         One-line fleet summary
+  af-status --json                  JSON output
+  af-status --json | jq .agentsWorking  Extract a field
+  af-status --watch                 Auto-refresh mode
+  af-status --watch --interval 1s   Refresh every second
+
+${C.yellow}Environment:${C.reset}
+  WORKER_API_URL     API base URL (default: http://localhost:3000)
+`);
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes('--help') || args.includes('-h') || args.includes('help')) {
+        printUsage();
+        return;
+    }
+    const jsonMode = args.includes('--json');
+    const watchMode = args.includes('--watch');
+    // Parse --interval value
+    let interval;
+    const intervalIdx = args.indexOf('--interval');
+    if (intervalIdx !== -1 && intervalIdx + 1 < args.length) {
+        interval = args[intervalIdx + 1];
+    }
+    // Parse --url value
+    let url;
+    const urlIdx = args.indexOf('--url');
+    if (urlIdx !== -1 && urlIdx + 1 < args.length) {
+        url = args[urlIdx + 1];
+    }
+    await runStatus({ json: jsonMode, watch: watchMode, interval, url });
+}
+main().catch((error) => {
+    console.error('Error:', error instanceof Error ? error.message : error);
+    process.exit(1);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@renseiai/agentfactory-cli",
-  "version": "0.8.7",
+  "version": "0.8.9",
   "type": "module",
   "description": "CLI tools for AgentFactory — local orchestrator, remote worker, queue admin",
   "author": "Rensei AI (https://rensei.ai)",
@@ -37,7 +37,8 @@
     "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"
+    "af-sync-routes": "dist/src/sync-routes.js",
+    "af-status": "dist/src/status.js"
   },
   "main": "./dist/src/index.js",
   "module": "./dist/src/index.js",
@@ -92,6 +93,11 @@
       "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"
+    },
+    "./status": {
+      "types": "./dist/src/lib/status-runner.d.ts",
+      "import": "./dist/src/lib/status-runner.js",
+      "default": "./dist/src/lib/status-runner.js"
     }
   },
   "files": [
@@ -101,10 +107,10 @@
   ],
   "dependencies": {
     "dotenv": "^17.2.3",
-    "@renseiai/agentfactory": "0.8.7",
-    "@renseiai/plugin-linear": "0.8.7",
-    "@renseiai/agentfactory-code-intelligence": "0.8.7",
-    "@renseiai/agentfactory-server": "0.8.7"
+    "@renseiai/agentfactory": "0.8.9",
+    "@renseiai/plugin-linear": "0.8.9",
+    "@renseiai/agentfactory-server": "0.8.9",
+    "@renseiai/agentfactory-code-intelligence": "0.8.9"
   },
   "devDependencies": {
     "@types/node": "^22.5.4",