@shepai/cli 1.34.0 → 1.35.1

package/dist/src/presentation/cli/commands/agent/logs.command.js

@@ -11,41 +11,9 @@
 import { Command } from 'commander';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
-import { closeSync, createReadStream, existsSync, openSync, readFileSync, readSync, statSync, watch, } from 'node:fs';
-import { open } from 'node:fs/promises';
-import { colors, messages } from '../../ui/index.js';
+import { messages } from '../../ui/index.js';
 import { resolveAgentRun } from './resolve-run.js';
-/** Read the last N lines from a file without loading it all into memory */
-function readTailLines(filePath, n) {
-    const stat = statSync(filePath);
-    // For small files (< 64KB), just read the whole thing
-    if (stat.size < 65536) {
-        const content = readFileSync(filePath, 'utf-8');
-        const lines = content.split('\n');
-        return lines.slice(Math.max(0, lines.length - n)).join('\n');
-    }
-    // For large files, read from the end in chunks
-    const fd = openSync(filePath, 'r');
-    const chunkSize = Math.min(stat.size, 8192);
-    let found = 0;
-    let pos = stat.size;
-    let tail = '';
-    const buf = Buffer.alloc(chunkSize);
-    while (pos > 0 && found <= n) {
-        const readSize = Math.min(chunkSize, pos);
-        pos -= readSize;
-        readSync(fd, buf, 0, readSize, pos);
-        const chunk = buf.toString('utf-8', 0, readSize);
-        tail = chunk + tail;
-        for (const ch of chunk) {
-            if (ch === '\n')
-                found++;
-        }
-    }
-    closeSync(fd);
-    const lines = tail.split('\n');
-    return lines.slice(Math.max(0, lines.length - n)).join('\n');
-}
+import { viewLog } from '../log-viewer.js';
 export function createLogsCommand() {
     return new Command('logs')
         .description('View agent run logs')
@@ -61,97 +29,14 @@ export function createLogsCommand() {
                 return;
             }
             const logPath = join(homedir(), '.shep', 'logs', `worker-${resolved.run.id}.log`);
-            if (!existsSync(logPath)) {
-                messages.error(`No log file found for run ${resolved.run.id.substring(0, 8)}`);
-                messages.info(`Expected: ${logPath}`);
+            const ok = await viewLog({
+                logPath,
+                follow: opts.follow,
+                lines: parseInt(opts.lines, 10),
+                label: `run ${resolved.run.id.substring(0, 8)}`,
+            });
+            if (!ok) {
                 process.exitCode = 1;
-                return;
-            }
-            const stat = statSync(logPath);
-            if (stat.size === 0) {
-                messages.info(`Log file is empty for run ${colors.accent(resolved.run.id.substring(0, 8))}`);
-                if (!opts.follow)
-                    return;
-                // In follow mode, continue — the file will grow
-            }
-            const requestedLines = parseInt(opts.lines, 10);
-            if (opts.follow) {
-                // Print existing content first
-                if (stat.size > 0) {
-                    if (requestedLines > 0) {
-                        process.stdout.write(readTailLines(logPath, requestedLines));
-                        if (!process.stdout.destroyed)
-                            process.stdout.write('\n');
-                    }
-                    else {
-                        // Stream existing content without loading entire file into memory
-                        await new Promise((resolve, reject) => {
-                            const stream = createReadStream(logPath, { encoding: 'utf-8' });
-                            stream.pipe(process.stdout, { end: false });
-                            stream.on('end', resolve);
-                            stream.on('error', reject);
-                        });
-                    }
-                }
-                // Follow new content using fs.watch (event-driven, no polling)
-                let position = stat.size;
-                const handle = await open(logPath, 'r');
-                // Reusable 4KB buffer for incremental reads
-                const readBuf = Buffer.alloc(4096);
-                const readNewContent = async () => {
-                    try {
-                        const currentStat = statSync(logPath);
-                        while (position < currentStat.size) {
-                            const bytesToRead = Math.min(readBuf.length, currentStat.size - position);
-                            const { bytesRead } = await handle.read(readBuf, 0, bytesToRead, position);
-                            if (bytesRead === 0)
-                                break;
-                            process.stdout.write(readBuf.toString('utf-8', 0, bytesRead));
-                            position += bytesRead;
-                        }
-                    }
-                    catch {
-                        // File may have been deleted/rotated
-                    }
-                };
-                // Use fs.watch for efficient OS-level file change notifications
-                const watcher = watch(logPath, { persistent: true }, () => {
-                    readNewContent();
-                });
-                // Fallback poll every 2s in case fs.watch misses events (NFS, etc.)
-                const fallbackInterval = setInterval(readNewContent, 2000);
-                const cleanup = async () => {
-                    watcher.close();
-                    clearInterval(fallbackInterval);
-                    await handle.close();
-                };
-                process.on('SIGINT', async () => {
-                    await cleanup();
-                    process.exit(0);
-                });
-                process.on('SIGTERM', async () => {
-                    await cleanup();
-                    process.exit(0);
-                });
-            }
-            else {
-                // Print mode
-                if (requestedLines > 0) {
-                    process.stdout.write(readTailLines(logPath, requestedLines));
-                    process.stdout.write('\n');
-                }
-                else {
-                    // Stream the file — don't load it all into memory
-                    await new Promise((resolve, reject) => {
-                        const stream = createReadStream(logPath, { encoding: 'utf-8' });
-                        stream.pipe(process.stdout, { end: false });
-                        stream.on('end', () => {
-                            process.stdout.write('\n');
-                            resolve();
-                        });
-                        stream.on('error', reject);
-                    });
-                }
             }
         }
         catch (error) {

package/dist/src/presentation/cli/commands/feat/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAW3C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAWpC;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAY3C"}

package/dist/src/presentation/cli/commands/feat/index.js

@@ -18,6 +18,7 @@ import { createResumeCommand } from './resume.command.js';
 import { createReviewCommand } from './review.command.js';
 import { createApproveCommand } from './approve.command.js';
 import { createRejectCommand } from './reject.command.js';
+import { createLogsCommand } from './logs.command.js';
 /**
  * Create the feat command group
  */
@@ -31,5 +32,6 @@ export function createFeatCommand() {
         .addCommand(createResumeCommand())
         .addCommand(createReviewCommand())
         .addCommand(createApproveCommand())
-        .addCommand(createRejectCommand());
+        .addCommand(createRejectCommand())
+        .addCommand(createLogsCommand());
 }

package/dist/src/presentation/cli/commands/feat/logs.command.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Feature Logs Command
+ *
+ * View log output for a feature's agent run with efficient streaming.
+ * Resolves the feature by ID, finds its associated agent run, then
+ * displays the worker log file.
+ *
+ * Usage:
+ *   shep feat logs <id>         # Print full log
+ *   shep feat logs -f <id>      # Follow (tail -f) using fs.watch
+ *   shep feat logs -n 50 <id>   # Last 50 lines
+ */
+import { Command } from 'commander';
+export declare function createLogsCommand(): Command;
+//# sourceMappingURL=logs.command.d.ts.map

package/dist/src/presentation/cli/commands/feat/logs.command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.command.d.ts","sourceRoot":"","sources":["../../../../../../src/presentation/cli/commands/feat/logs.command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,iBAAiB,IAAI,OAAO,CAkC3C"}

package/dist/src/presentation/cli/commands/feat/logs.command.js

@@ -0,0 +1,52 @@
+/**
+ * Feature Logs Command
+ *
+ * View log output for a feature's agent run with efficient streaming.
+ * Resolves the feature by ID, finds its associated agent run, then
+ * displays the worker log file.
+ *
+ * Usage:
+ *   shep feat logs <id>         # Print full log
+ *   shep feat logs -f <id>      # Follow (tail -f) using fs.watch
+ *   shep feat logs -n 50 <id>   # Last 50 lines
+ */
+import { Command } from 'commander';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { container } from '../../../../../packages/core/src/infrastructure/di/container.js';
+import { ShowFeatureUseCase } from '../../../../../packages/core/src/application/use-cases/features/show-feature.use-case.js';
+import { messages } from '../../ui/index.js';
+import { viewLog } from '../log-viewer.js';
+export function createLogsCommand() {
+    return new Command('logs')
+        .description('View feature agent logs')
+        .argument('<id>', 'Feature ID (or prefix)')
+        .option('-f, --follow', 'Follow log output (like tail -f)')
+        .option('-n, --lines <count>', 'Number of lines to show from the end', '0')
+        .action(async (id, opts) => {
+        try {
+            const useCase = container.resolve(ShowFeatureUseCase);
+            const feature = await useCase.execute(id);
+            if (!feature.agentRunId) {
+                messages.error(`Feature "${feature.name}" has no agent run`);
+                process.exitCode = 1;
+                return;
+            }
+            const logPath = join(homedir(), '.shep', 'logs', `worker-${feature.agentRunId}.log`);
+            const ok = await viewLog({
+                logPath,
+                follow: opts.follow,
+                lines: parseInt(opts.lines, 10),
+                label: `feature "${feature.name}"`,
+            });
+            if (!ok) {
+                process.exitCode = 1;
+            }
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            messages.error('Failed to read feature logs', err);
+            process.exitCode = 1;
+        }
+    });
+}

package/dist/src/presentation/cli/commands/log-viewer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Shared Log Viewer
+ *
+ * Displays a log file with support for follow mode and tail lines.
+ * Used by both `shep agent logs` and `shep feat logs`.
+ */
+export interface LogViewerOptions {
+    /** Absolute path to the log file */
+    logPath: string;
+    /** Follow log output (like tail -f) */
+    follow?: boolean;
+    /** Number of lines to show from the end (0 = all) */
+    lines: number;
+    /** Label for error messages (e.g. "run abc123", "feature my-feat") */
+    label: string;
+}
+/**
+ * Display a log file to stdout with optional follow mode and tail lines.
+ *
+ * @returns false if the log file doesn't exist or is empty (in non-follow mode)
+ */
+export declare function viewLog(opts: LogViewerOptions): Promise<boolean>;
+//# sourceMappingURL=log-viewer.d.ts.map

package/dist/src/presentation/cli/commands/log-viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-viewer.d.ts","sourceRoot":"","sources":["../../../../../src/presentation/cli/commands/log-viewer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAeH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,KAAK,EAAE,MAAM,CAAC;CACf;AAiCD;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC,CA6FtE"}

package/dist/src/presentation/cli/commands/log-viewer.js

@@ -0,0 +1,135 @@
+/**
+ * Shared Log Viewer
+ *
+ * Displays a log file with support for follow mode and tail lines.
+ * Used by both `shep agent logs` and `shep feat logs`.
+ */
+import { closeSync, createReadStream, existsSync, openSync, readFileSync, readSync, statSync, watch, } from 'node:fs';
+import { open } from 'node:fs/promises';
+import { messages } from '../ui/index.js';
+/** Read the last N lines from a file without loading it all into memory */
+function readTailLines(filePath, n) {
+    const stat = statSync(filePath);
+    // For small files (< 64KB), just read the whole thing
+    if (stat.size < 65536) {
+        const content = readFileSync(filePath, 'utf-8');
+        const lines = content.split('\n');
+        return lines.slice(Math.max(0, lines.length - n)).join('\n');
+    }
+    // For large files, read from the end in chunks
+    const fd = openSync(filePath, 'r');
+    const chunkSize = Math.min(stat.size, 8192);
+    let found = 0;
+    let pos = stat.size;
+    let tail = '';
+    const buf = Buffer.alloc(chunkSize);
+    while (pos > 0 && found <= n) {
+        const readSize = Math.min(chunkSize, pos);
+        pos -= readSize;
+        readSync(fd, buf, 0, readSize, pos);
+        const chunk = buf.toString('utf-8', 0, readSize);
+        tail = chunk + tail;
+        for (const ch of chunk) {
+            if (ch === '\n')
+                found++;
+        }
+    }
+    closeSync(fd);
+    const lines = tail.split('\n');
+    return lines.slice(Math.max(0, lines.length - n)).join('\n');
+}
+/**
+ * Display a log file to stdout with optional follow mode and tail lines.
+ *
+ * @returns false if the log file doesn't exist or is empty (in non-follow mode)
+ */
+export async function viewLog(opts) {
+    const { logPath, follow, lines: requestedLines, label } = opts;
+    if (!existsSync(logPath)) {
+        messages.error(`No log file found for ${label}`);
+        messages.info(`Expected: ${logPath}`);
+        return false;
+    }
+    const stat = statSync(logPath);
+    if (stat.size === 0) {
+        messages.info(`Log file is empty for ${label}`);
+        if (!follow)
+            return false;
+        // In follow mode, continue — the file will grow
+    }
+    if (follow) {
+        // Print existing content first
+        if (stat.size > 0) {
+            if (requestedLines > 0) {
+                process.stdout.write(readTailLines(logPath, requestedLines));
+                if (!process.stdout.destroyed)
+                    process.stdout.write('\n');
+            }
+            else {
+                await new Promise((resolve, reject) => {
+                    const stream = createReadStream(logPath, { encoding: 'utf-8' });
+                    stream.pipe(process.stdout, { end: false });
+                    stream.on('end', resolve);
+                    stream.on('error', reject);
+                });
+            }
+        }
+        // Follow new content using fs.watch (event-driven, no polling)
+        let position = stat.size;
+        const handle = await open(logPath, 'r');
+        const readBuf = Buffer.alloc(4096);
+        const readNewContent = async () => {
+            try {
+                const currentStat = statSync(logPath);
+                while (position < currentStat.size) {
+                    const bytesToRead = Math.min(readBuf.length, currentStat.size - position);
+                    const { bytesRead } = await handle.read(readBuf, 0, bytesToRead, position);
+                    if (bytesRead === 0)
+                        break;
+                    process.stdout.write(readBuf.toString('utf-8', 0, bytesRead));
+                    position += bytesRead;
+                }
+            }
+            catch {
+                // File may have been deleted/rotated
+            }
+        };
+        const watcher = watch(logPath, { persistent: true }, () => {
+            readNewContent();
+        });
+        // Fallback poll every 2s in case fs.watch misses events (NFS, etc.)
+        const fallbackInterval = setInterval(readNewContent, 2000);
+        const cleanup = async () => {
+            watcher.close();
+            clearInterval(fallbackInterval);
+            await handle.close();
+        };
+        process.on('SIGINT', async () => {
+            await cleanup();
+            process.exit(0);
+        });
+        process.on('SIGTERM', async () => {
+            await cleanup();
+            process.exit(0);
+        });
+    }
+    else {
+        // Print mode
+        if (requestedLines > 0) {
+            process.stdout.write(readTailLines(logPath, requestedLines));
+            process.stdout.write('\n');
+        }
+        else {
+            await new Promise((resolve, reject) => {
+                const stream = createReadStream(logPath, { encoding: 'utf-8' });
+                stream.pipe(process.stdout, { end: false });
+                stream.on('end', () => {
+                    process.stdout.write('\n');
+                    resolve();
+                });
+                stream.on('error', reject);
+            });
+        }
+    }
+    return true;
+}