@0xmaxma/claude-gateway 1.8.3 → 1.8.5

package/dist/cli/commands/gateway.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/gateway.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAmB,MAAM,gBAAgB,CAAC;AAMhE;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EACvC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,CA8BjB"}
+{"version":3,"file":"gateway.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/gateway.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAmB,MAAM,gBAAgB,CAAC;AAOhE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EAAE,EACrB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EACvC,MAAM,EAAE,aAAa,GACpB,OAAO,CAAC,MAAM,CAAC,CAmCjB"}

package/dist/cli/commands/gateway.js

@@ -41,20 +41,29 @@ const health_1 = require("../health");
 const manager_1 = require("../manager");
 const output_1 = require("../output");
 const output_2 = require("../output");
+const logs_1 = require("./logs");
 /**
- * `gateway start|status|restart|stop` — whole-process lifecycle.
+ * `gateway start|status|restart|stop|logs` — whole-process lifecycle.
  *
  * `start` is handled by the boot entry point (src/index.ts), which recognises
  * it before the CLI is ever imported; it is listed here only so the usage text
  * and an unknown-verb error stay honest. Restart/stop must be performed by
  * whatever manager owns the process (it has to stop the very process serving
  * HTTP), so detection resolves the manager and the action is delegated to it.
+ *
+ * `logs` is the odd one out: it touches no process at all, reading the log
+ * files directly so it still answers when the gateway is wedged or dead. It
+ * lives here because the logs are the gateway's, and an operator looking for
+ * them looks under the noun they already know.
  */
 async function runGatewayLifecycle(positionals, flags, config) {
     const verb = positionals[0];
     if (!verb) {
         // `gateway --help` is a help request (0); a bare `gateway` is a usage error (1).
-        (0, output_2.writeCommandHelp)(flags.help === true, 'gateway', 'manage the gateway process on this host', 'claude-gateway gateway <start|status|restart|stop>', ['  start is the only command that boots a server; the rest are manager-aware.']);
+        (0, output_2.writeCommandHelp)(flags.help === true, 'gateway', 'manage the gateway process on this host', 'claude-gateway gateway <start|status|restart|stop|logs>', [
+            '  start is the only command that boots a server; status/restart/stop are manager-aware.',
+            '  logs reads the log files directly and works even when the gateway is dead.',
+        ]);
         return flags.help === true ? 0 : 1;
     }
     switch (verb) {
@@ -69,8 +78,10 @@ async function runGatewayLifecycle(positionals, flags, config) {
             return gatewayAction('restart');
         case 'stop':
             return gatewayAction('stop');
+        case 'logs':
+            return (0, logs_1.runGatewayLogs)(flags);
         default:
-            process.stderr.write(`Unknown: gateway ${verb} (expected start|status|restart|stop)\n`);
+            process.stderr.write(`Unknown: gateway ${verb} (expected start|status|restart|stop|logs)\n`);
             return 1;
     }
 }

package/dist/cli/commands/gateway.js.map

@@ -1 +1 @@
-{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../../src/cli/commands/gateway.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gateway.js","sourceRoot":"","sources":["../../../src/cli/commands/gateway.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/logs.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Render one stored line as `<ts> <level> <message>` with `data` appended
+ * compactly.
+ *
+ * A line that is not a gateway log record is passed through verbatim rather
+ * than dropped or replaced with a placeholder: anything already in the file is
+ * something the operator may need to see, and a reader that silently discards
+ * what it does not recognise is how a corrupt tail looks like an idle gateway.
+ */
+export declare function formatLogLine(line: string): string;
+/**
+ * The last `count` lines of `file`, oldest first, with the offset they were
+ * read to.
+ *
+ * Reads backwards in chunks so the cost is bounded by what is asked for rather
+ * than by the size of the file.
+ *
+ * `endPos` is what `--follow` must resume from. Following from a *later*
+ * `statSync` would skip whatever the gateway appended in between: those bytes
+ * are past the tail's read and before the follower's start, so nothing would
+ * ever print them. Nothing can interleave here within this process — the read
+ * is synchronous — but the writer is a different process, which is the whole
+ * reason the command exists.
+ */
+export declare function tailFrom(file: string, count: number): {
+    lines: string[];
+    endPos: number;
+};
+/** The last `count` lines of `file`, oldest first. */
+export declare function tailLines(file: string, count: number): string[];
+export interface LogsRunOptions {
+    /** Stops `--follow`. Tests pass one; the CLI wires it to SIGINT. */
+    signal?: AbortSignal;
+    pollMs?: number;
+}
+export declare function runGatewayLogs(flags: Record<string, string | boolean>, opts?: LogsRunOptions): Promise<number>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/cli/commands/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/logs.ts"],"names":[],"mappings":"AAsCA;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAmBlD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CA8BzF;AAED,sDAAsD;AACtD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/D;AAQD,MAAM,WAAW,cAAc;IAC7B,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AA+BD,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,EACvC,IAAI,GAAE,cAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,CAoHjB"}

package/dist/cli/commands/logs.js

@@ -0,0 +1,429 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatLogLine = formatLogLine;
+exports.tailFrom = tailFrom;
+exports.tailLines = tailLines;
+exports.runGatewayLogs = runGatewayLogs;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logs_dir_1 = require("../logs-dir");
+const output_1 = require("../output");
+/**
+ * `gateway logs` — read the gateway's own logs without knowing where they live.
+ *
+ * The data was always well structured (one JSON object per line, written by
+ * src/logger.ts); what was missing was any way to reach it from the CLI, so
+ * operators had to know the on-disk layout and reach for `tail` by hand. A
+ * `logs` command was in scope for #374 and dropped in #375 rather than shipped
+ * as an always-failing stub; this is the version that works (#435).
+ *
+ * Every failure here is explicit — a missing directory, an unknown agent, a bad
+ * `--lines` — because the one thing a log reader must never do is answer "no
+ * logs" when the real answer is "I looked in the wrong place".
+ */
+/** Default tail length, matching what `tail` gives you for free minus the guesswork. */
+const DEFAULT_LINES = 50;
+/** Chunk size for the reverse read. */
+const TAIL_CHUNK = 64 * 1024;
+/** Ceiling on how much of a file the tail will scan backwards. A session log can
+ *  be hundreds of MB; reading it whole to show 50 lines would be the same
+ *  mistake `debug-bundle` exists to avoid. A tail that hits this stops early and
+ *  returns what it has, which is still the newest content. */
+const TAIL_MAX_SCAN = 8 * 1024 * 1024;
+/** How often `--follow` re-stats the file. */
+const DEFAULT_POLL_MS = 300;
+/**
+ * Render one stored line as `<ts> <level> <message>` with `data` appended
+ * compactly.
+ *
+ * A line that is not a gateway log record is passed through verbatim rather
+ * than dropped or replaced with a placeholder: anything already in the file is
+ * something the operator may need to see, and a reader that silently discards
+ * what it does not recognise is how a corrupt tail looks like an idle gateway.
+ */
+function formatLogLine(line) {
+    let rec;
+    try {
+        rec = JSON.parse(line);
+    }
+    catch {
+        return line;
+    }
+    if (rec === null || typeof rec !== 'object' || typeof rec.message !== 'string')
+        return line;
+    const ts = typeof rec.ts === 'string' ? rec.ts : '-';
+    const level = typeof rec.level === 'string' ? rec.level.toUpperCase().padEnd(5) : '-    ';
+    const head = `${ts} ${level} ${rec.message}`;
+    if (rec.data === undefined)
+        return head;
+    let data;
+    try {
+        data = JSON.stringify(rec.data);
+    }
+    catch {
+        return head; // circular/unserialisable — the message alone is still useful
+    }
+    return `${head} ${data}`;
+}
+/**
+ * The last `count` lines of `file`, oldest first, with the offset they were
+ * read to.
+ *
+ * Reads backwards in chunks so the cost is bounded by what is asked for rather
+ * than by the size of the file.
+ *
+ * `endPos` is what `--follow` must resume from. Following from a *later*
+ * `statSync` would skip whatever the gateway appended in between: those bytes
+ * are past the tail's read and before the follower's start, so nothing would
+ * ever print them. Nothing can interleave here within this process — the read
+ * is synchronous — but the writer is a different process, which is the whole
+ * reason the command exists.
+ */
+function tailFrom(file, count) {
+    const fd = fs.openSync(file, 'r');
+    try {
+        const size = fs.fstatSync(fd).size;
+        let pos = size;
+        let scanned = 0;
+        let text = '';
+        while (pos > 0 && scanned < TAIL_MAX_SCAN) {
+            const len = Math.min(TAIL_CHUNK, pos);
+            pos -= len;
+            scanned += len;
+            const buf = Buffer.alloc(len);
+            fs.readSync(fd, buf, 0, len, pos);
+            text = buf.toString('utf-8') + text;
+            // +1 because the newline that ends the (count)th-from-last line belongs to
+            // the line before it — stopping at `count` can return one line short.
+            if (countNewlines(text) > count)
+                break;
+        }
+        const lines = text.split('\n');
+        // A leading fragment from a chunk boundary is not a whole line. It only
+        // exists when the scan stopped short of the start of the file. Dropping it
+        // is safe even when the boundary happens to land exactly on a newline: the
+        // loop only stops with more than `count` lines in hand, so the one dropped
+        // is always older than the newest `count`.
+        if (pos > 0 && lines.length > 0)
+            lines.shift();
+        while (lines.length > 0 && lines[lines.length - 1] === '')
+            lines.pop();
+        return { lines: lines.length > count ? lines.slice(lines.length - count) : lines, endPos: size };
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+/** The last `count` lines of `file`, oldest first. */
+function tailLines(file, count) {
+    return tailFrom(file, count).lines;
+}
+function countNewlines(s) {
+    let n = 0;
+    for (let i = 0; i < s.length; i++)
+        if (s.charCodeAt(i) === 10)
+            n++;
+    return n;
+}
+/** Positive integer, or the reason it is not one. */
+function parseLines(raw) {
+    if (raw === undefined)
+        return { lines: DEFAULT_LINES };
+    if (typeof raw !== 'string')
+        return { error: '--lines requires a value (a positive integer)' };
+    if (!/^\d+$/.test(raw))
+        return { error: `--lines must be a positive integer, got "${raw}"` };
+    const n = Number(raw);
+    if (!Number.isSafeInteger(n) || n < 1)
+        return { error: `--lines must be a positive integer, got "${raw}"` };
+    return { lines: n };
+}
+function printHelp(requested) {
+    (0, output_1.writeCommandHelp)(requested, 'gateway logs', 'read the gateway log files on this host', 'claude-gateway gateway logs [--follow] [--lines <n>] [--agent <id>] [--json] [--logDir <path>] [--config <path>]', [
+        '  --follow         Stream new lines until interrupted (Ctrl-C)',
+        `  --lines <n>      How many lines to show (default ${DEFAULT_LINES})`,
+        '  --agent <id>     Read <id>.log instead of the process-wide gateway.log',
+        '  --json           Print the stored lines verbatim, one JSON object per line',
+        '  --logDir <path>  Read logs from here instead of the configured directory',
+        '  --config <path>  Read logDir from this config file',
+        '',
+        '  Reads files directly, so it works even when the gateway is wedged or dead.',
+    ]);
+}
+async function runGatewayLogs(flags, opts = {}) {
+    if (flags.help === true) {
+        printHelp(true);
+        return 0;
+    }
+    const parsed = parseLines(flags.lines);
+    if ('error' in parsed) {
+        process.stderr.write(`${parsed.error}\n`);
+        return 1;
+    }
+    if (flags.agent !== undefined && typeof flags.agent !== 'string') {
+        process.stderr.write('--agent requires a value (a log stream id)\n');
+        return 1;
+    }
+    const logDir = (0, logs_dir_1.resolveLogDir)(flags);
+    // Before anything else reads a path: if `--config` named a file we could not
+    // use, say so now. Otherwise the "no log file at …" below names the default
+    // directory and reads like an answer rather than a misdirection.
+    const configWarning = (0, logs_dir_1.explicitConfigWarning)(flags);
+    if (configWarning)
+        process.stderr.write(`${configWarning}\n`);
+    const streamId = typeof flags.agent === 'string' ? flags.agent : 'gateway';
+    // A stream id reaches the filesystem, so it must not be able to leave the log
+    // directory. Session streams legitimately contain ':' (`<agent>:session:<id>`),
+    // so this rejects traversal rather than restricting the charset.
+    if (streamId.includes('/') || streamId.includes('\\') || streamId.split(path.sep).includes('..')) {
+        process.stderr.write(`Invalid --agent "${streamId}": a log stream id cannot contain a path separator\n`);
+        return 1;
+    }
+    const file = path.join(logDir, `${streamId}.log`);
+    if (!fs.existsSync(file)) {
+        // Never "no logs found": say which path was tried, and — since an unknown
+        // id is usually a typo — what could have been meant instead.
+        const { ids, error } = (0, logs_dir_1.listLogStreamIds)(logDir);
+        process.stderr.write(`No log file at ${file}\n`);
+        if (error) {
+            process.stderr.write(`${error}\n`);
+        }
+        else if (ids.length > 0) {
+            process.stderr.write(`Available streams (--agent <id>): ${ids.join(', ')}\n`);
+        }
+        else {
+            process.stderr.write(`${logDir} holds no log files yet\n`);
+        }
+        return 1;
+    }
+    const asJson = flags.json === true;
+    // Whether anyone is still reading our output, and why they stopped.
+    //
+    // A downstream reader that closes early — `gateway logs --follow | head -5`,
+    // a pager quit with `q` — ends the command normally. A write into a pipe
+    // nobody reads never throws; it arrives as an asynchronous 'error' on stdout,
+    // which with no listener is an uncaught exception that kills the CLI with a
+    // stack trace after the output the operator asked for.
+    //
+    // The listener covers the whole command rather than just the follow loop: the
+    // tail is written before following starts, and `gateway logs --lines 20000 |
+    // head -1` is the same broken pipe with no follow involved.
+    const sink = {};
+    const onSinkError = (err) => {
+        // Stop either way — but a stdout error that is *not* the reader leaving (a
+        // full disk, a read-only redirect) is a real failure and has to be
+        // reported. Attaching any listener marks the 'error' handled, so one that
+        // ignored those codes would turn a loud crash into a follow that streams
+        // into nothing and still exits 0.
+        if (!isPipeClosed(err))
+            sink.failure = err;
+        sink.onBroken?.();
+    };
+    const emit = (line) => {
+        if (line === '')
+            return;
+        process.stdout.write(`${asJson ? line : formatLogLine(line)}\n`);
+    };
+    process.stdout.on('error', onSinkError);
+    try {
+        let tail;
+        try {
+            // Resume from where the tail stopped, not from a fresh stat: the gateway is
+            // a different process and may have appended in between.
+            tail = tailFrom(file, parsed.lines);
+        }
+        catch (err) {
+            const e = err;
+            process.stderr.write(`Cannot read ${file} (${e.code ?? e.message})\n`);
+        }
+        let exitCode = 1;
+        if (tail) {
+            for (const line of tail.lines)
+                emit(line);
+            if (flags.follow === true)
+                await followFile(file, tail.endPos, emit, opts, sink);
+            exitCode = 0;
+        }
+        // Wait for the writes before judging them. A stdout failure is reported
+        // asynchronously, so returning as soon as the last `emit` call returns
+        // decides the exit code before the failure that decides it has arrived —
+        // `gateway logs > <full disk>` exited 0 with an empty stderr, and only the
+        // follow path escaped it, because following happens to keep the process
+        // there long enough for the error to land.
+        //
+        // The same wait is what makes the command self-contained: the `finally`
+        // below detaches the only 'error' listener stdout has, and detaching it
+        // while a write is still in flight leaves that error to the process. That
+        // it did not crash was luck — src/entry.ts calls `exitAfterFlush` on the
+        // next tick, and its own drain re-attached one just in time.
+        await (0, output_1.flushStream)(process.stdout);
+        if (sink.failure) {
+            process.stderr.write(`Cannot write output (${sink.failure.code ?? sink.failure.message})\n`);
+            return 1;
+        }
+        return exitCode;
+    }
+    finally {
+        process.stdout.off('error', onSinkError);
+    }
+}
+/**
+ * Whether an error means "nobody is reading this any more".
+ *
+ * Only EPIPE: measured on this platform, a closed pipe reports EPIPE on every
+ * failed write and never leaves `process.stdout` destroyed, so the
+ * ERR_STREAM_DESTROYED that a torn-down stream would report is not reachable
+ * here. Anything else is treated as a genuine write failure and surfaced.
+ */
+function isPipeClosed(err) {
+    return err?.code === 'EPIPE';
+}
+/**
+ * Stream lines appended to `file` until aborted.
+ *
+ * Polls rather than using `fs.watch` because the file it is following can be
+ * rotated out from under it (src/logger.ts renames `<name>.log` to
+ * `<name>.log.1`): a watcher holds the old inode and would go quiet forever
+ * while the gateway writes happily into the new file. Comparing the inode on
+ * every poll turns that into a reopen.
+ */
+async function followFile(file, fromPos, emit, opts, sink) {
+    const pollMs = opts.pollMs ?? DEFAULT_POLL_MS;
+    let pos = fromPos;
+    let inode;
+    let carry = '';
+    try {
+        inode = fs.statSync(file).ino;
+    }
+    catch {
+        /* the file was there a moment ago; treat it as rotated on the next poll */
+    }
+    const drain = () => {
+        let stat;
+        try {
+            stat = fs.statSync(file);
+        }
+        catch {
+            return; // mid-rotation: the rename has happened, the new file has not appeared
+        }
+        if (inode !== undefined && stat.ino !== inode) {
+            // Rotated: a different file now answers to this name. Start at its
+            // beginning — the bytes between the old position and the rotation are in
+            // `<name>.log.1`, which the operator can read directly.
+            inode = stat.ino;
+            pos = 0;
+            carry = '';
+        }
+        else if (stat.size < pos) {
+            // Truncated in place (maxFiles = 0 unlinks rather than renames).
+            pos = 0;
+            carry = '';
+        }
+        if (inode === undefined)
+            inode = stat.ino;
+        if (stat.size <= pos)
+            return;
+        const len = stat.size - pos;
+        const buf = Buffer.alloc(len);
+        let read = 0;
+        const fd = fs.openSync(file, 'r');
+        try {
+            read = fs.readSync(fd, buf, 0, len, pos);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        pos += read;
+        // A tail can land mid-line; hold the fragment until its newline arrives so
+        // a line is never emitted in two halves.
+        const chunk = carry + buf.subarray(0, read).toString('utf-8');
+        const parts = chunk.split('\n');
+        carry = parts.pop() ?? '';
+        for (const line of parts)
+            emit(line);
+    };
+    await new Promise((resolve) => {
+        const timer = setInterval(() => {
+            try {
+                drain();
+            }
+            catch {
+                /* transient (rotation race, permissions) — the next poll retries */
+            }
+        }, pollMs);
+        // Deliberately NOT unref'ed. An unref'ed interval is right wherever the
+        // process is kept alive by something else — `src/logger.ts:324`'s retention
+        // sweep runs inside the gateway server, which its HTTP listener holds open,
+        // and `src/cli/output.ts:54`'s flush deadline is a bound on a wait, not the
+        // reason to keep waiting. Here the interval is the only ref'ed handle there
+        // is: `process.once('SIGINT')` does not hold the loop open, so unref'ing
+        // drained the loop and exited 0 the moment the tail had been written —
+        // `--follow` printed the tail and returned instead of following (#439).
+        // Nothing leaks: `stop()` clears the interval on every path out.
+        const stop = () => {
+            clearInterval(timer);
+            sink.onBroken = undefined;
+            if (opts.signal)
+                opts.signal.removeEventListener('abort', stop);
+            else
+                process.off('SIGINT', stop);
+            resolve();
+        };
+        // The reader going away is how a follow normally ends. The 'error' itself
+        // is caught by the command-wide stdout listener; this is what turns it into
+        // "stop polling" rather than a loop that keeps draining into nothing.
+        sink.onBroken = stop;
+        if (opts.signal) {
+            if (opts.signal.aborted)
+                return stop();
+            opts.signal.addEventListener('abort', stop, { once: true });
+        }
+        else {
+            process.once('SIGINT', stop);
+        }
+    });
+    // One last pass so lines written between the final poll and the interrupt are
+    // not lost, then flush any line the file never terminated.
+    try {
+        drain();
+    }
+    catch {
+        /* best-effort */
+    }
+    if (carry !== '')
+        emit(carry);
+}
+//# sourceMappingURL=logs.js.map

package/dist/cli/commands/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../src/cli/commands/logs.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAc,KAAK,EAAE,MAAM,UAAU,CAAC;AA2B7C;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwD5D;AA8KD;;;;uEAIuE;AACvE,eAAO,MAAM,MAAM,KAAK,CAAC;AAEzB;2EAC2E;AAC3E,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,eAAO,MAAM,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAW9D,CAAC;AAEF;;;;+DAI+D;AAC/D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,SAAS,GAAG,MAAM,EAAE,CAG1F"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAc,KAAK,EAAE,MAAM,UAAU,CAAC;AAsC7C;;;;;;;GAOG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAwD5D;AA8KD;;;;uEAIuE;AACvE,eAAO,MAAM,MAAM,KAAK,CAAC;AAEzB;2EAC2E;AAC3E,eAAO,MAAM,WAAW,KAAK,CAAC;AAE9B,eAAO,MAAM,SAAS,EAAE,aAAa,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAiB9D,CAAC;AAEF;;;;+DAI+D;AAC/D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,SAAS,GAAG,MAAM,EAAE,CAG1F"}

package/dist/cli/index.js

@@ -50,15 +50,26 @@ const debug_bundle_1 = require("./commands/debug-bundle");
 const agents_1 = require("./commands/agents");
 const channels_1 = require("./commands/channels");
 /** Flags that are always boolean regardless of command — never consume the next
- *  token as a value (see parseCliArgs). */
-const GLOBAL_BOOLEAN_FLAGS = new Set(['help', 'json', 'yes', 'print']);
+ *  token as a value (see parseCliArgs). `follow` is here rather than in the
+ *  gateway command because the verb is a positional: `gateway --follow logs`
+ *  would otherwise parse `logs` as the flag's value and leave no command at all.
+ *  No generated resource command declares a `--follow` value flag. */
+const GLOBAL_BOOLEAN_FLAGS = new Set(['help', 'json', 'yes', 'print', 'follow']);
 /** Flags every command accepts, on top of whatever the generated manifest
  *  declares for that command. Anything outside this set and the command's own
  *  flags is a typo, and is reported rather than dropped: a resource command
  *  builds its query/body from `cmd.flags` alone, so an unrecognised flag would
- *  otherwise be parsed, ignored, and reported as success. */
+ *  otherwise be parsed, ignored, and reported as success.
+ *
+ *  Not simply `GLOBAL_BOOLEAN_FLAGS` spread in: the two sets answer different
+ *  questions. `follow` has to parse as a boolean everywhere so the gateway verb
+ *  survives, but it means nothing to a resource command, and accepting it there
+ *  would quietly re-open the hole this check exists to close. */
 const GLOBAL_FLAG_NAMES = new Set([
-    ...GLOBAL_BOOLEAN_FLAGS,
+    'help',
+    'json',
+    'yes',
+    'print',
     'url',
     'key',
     'config',
@@ -292,6 +303,12 @@ exports.NAME_W = 36;
 exports.NOUN_NAME_W = 48;
 exports.CORE_HELP = [
     ['gateway status|restart|stop', 'Manage the gateway process (manager-aware)'],
+    // Its own row, not folded into the line above: `logs` is the one entry there
+    // that does *not* go through the owning manager — it reads the files directly
+    // and works when the gateway is wedged or dead, which is when it matters.
+    // Described as lifecycle management, it read as a variant of stop/restart and
+    // was reported as missing from help by someone looking straight at it.
+    ['gateway logs', 'Read the gateway log files (works when it is down)'],
     ['service install|status|uninstall', 'Run the gateway as a systemd-user or PM2 service'],
     ['update [check]', 'Check for / install a newer claude-gateway'],
     ['claude version|update [check]', 'Inspect / update the Claude Code binary'],