@skrr-ai/cli 0.1.103 → 0.1.105

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

@@ -19,6 +19,7 @@ export interface DaemonLogsFlags {
     stderr?: boolean;
     path?: boolean;
     profile?: string;
+    rotated?: boolean;
 }
 /**
  * Older daemons already kept logs in this profile-scoped location, even
@@ -61,13 +62,25 @@ export declare function resolveDaemonLogsProfile(flags: Pick<DaemonLogsFlags, 'p
     home?: string;
     env?: NodeJS.ProcessEnv;
 }): string;
+/** Output destinations the installed launchd definition for a profile declares. */
+export interface InstalledServiceLogDestinations {
+    /** The `--log-file` in ProgramArguments, when present. */
+    logFile: string | null;
+    stdoutPath: string | null;
+    stderrPath: string | null;
+}
 /**
- * Log files the installed launchd definition for this profile sends output to
- * (OSK-15993). The desktop supervisor starts the daemon with
+ * Read the installed launchd definition's log destinations (OSK-15993). The
+ * desktop supervisor starts the daemon with
  * `--log-file ~/Library/Logs/Skrr/daemon.app.log` and redirects stderr to
  * `daemon.stderr.log`, so the profile's `logs/` directory can hold a file
  * nobody has written for a week. Read-only: the plist is parsed, never loaded.
  */
+export declare function installedServiceLogDestinations(profile: string, options?: {
+    home?: string;
+    platform?: NodeJS.Platform;
+}): InstalledServiceLogDestinations | null;
+/** The installed service's log files for the main log, or for `--stderr`. */
 export declare function installedServiceLogCandidates(profile: string, stderr: boolean, options?: {
     home?: string;
     platform?: NodeJS.Platform;
@@ -82,6 +95,8 @@ export declare function chooseLegacyFallbackLog(args: {
     profilePath: string;
     serviceCandidates: readonly string[];
     mtimeOf: (filePath: string) => number | null;
+    /** Why the runtime's own answer is not used; ends the note. */
+    reason?: string;
 }): {
     path: string;
     note: string | null;
@@ -93,6 +108,93 @@ export declare function chooseLegacyFallbackLog(args: {
  * rather than printed about a file that may not be the one shown.
  */
 export declare function resolveForwardedLogPath(flags: Pick<DaemonLogsFlags, 'stderr' | 'profile'>, capture?: typeof execRuntimeBinaryCapture): Promise<string | null>;
+/**
+ * The first runtime whose own `logs` reads the LIVE daemon's `--log-file`
+ * (OSK-15993, `daemon/src/daemon-log-target.ts`). 0.8.112 through 0.8.118 have
+ * a `logs` subcommand, so the subcommand probe says "supported", but it reads
+ * the profile's `logs/daemon.log` unconditionally — with a desktop-managed
+ * daemon, a file nobody has written for a week. Forwarding to one of those is
+ * forwarding to the bug, so the CLI forwards only at or above this version.
+ */
+export declare const LIVE_LOG_RESOLUTION_RUNTIME_VERSION = "0.8.119";
+/**
+ * The first runtime whose `logs` knows `--rotated` (OSK-16214). An older one
+ * rejects it as an unknown option, so the CLI never forwards the flag below
+ * this version: it asks the runtime which file it reads (`--path`) and reads
+ * that file and its rotated siblings itself.
+ */
+export declare const ROTATED_LOGS_RUNTIME_VERSION = "0.8.120";
+/**
+ * Rotated siblings of a log, OLDEST FIRST (OSK-16214). The daemon's logger
+ * renames `daemon.app.log` to `daemon.app.1.log`, `.1` to `.2` and so on at
+ * 10 MB (`daemon/src/logger.ts` `maybeRotate`), and `logs` never reached them —
+ * `--lines 5000 | grep <run id>` found nothing while `daemon.app.1.log` held the
+ * run. A copy of `daemon/src/rotated-log-files.ts`, for runtimes that predate
+ * `--rotated`. Never throws.
+ */
+export declare function rotatedLogSiblings(filePath: string, readdir?: (dir: string) => string[]): string[];
+/** The sentence shown when rotated siblings hold older lines the view leaves out. */
+export declare function describeRotatedSiblings(filePath: string, siblings: readonly string[]): string | null;
+/**
+ * The last `maxLines` lines of one file, read backwards in chunks so the cost
+ * follows the lines asked for, not the file's size. Bytes are decoded once, so
+ * a multi-byte character split across a chunk boundary survives.
+ */
+export declare function readLastLines(filePath: string, maxLines: number): string[];
+/**
+ * The last `maxLines` lines across `files` (OLDEST FIRST) as if they were one
+ * file. A file renamed away between the listing and the read is skipped.
+ */
+export declare function readLastLinesAcross(files: readonly string[], maxLines: number): string[];
+/** Every byte of `files`, in order, to `out` — streamed, honouring back-pressure. */
+export declare function streamLogFiles(files: readonly string[], out: NodeJS.WritableStream): Promise<void>;
+/** `x.y.z` from a version string, or null. A prerelease suffix is ignored. */
+export declare function parseRuntimeVersion(text: string): [number, number, number] | null;
+/** Whether `version` is at least `floor`; null when either is not a version. */
+export declare function runtimeVersionAtLeast(version: string, floor: string): boolean | null;
+/** The installed runtime's `--version`, or null when it cannot say in time. */
+export declare function probeRuntimeVersion(capture?: typeof execRuntimeBinaryCapture): Promise<string | null>;
+/**
+ * The live daemon's log as the runtime's `status --json` reports it
+ * (`service.logs`). Status has named the live `--log-file` since before `logs`
+ * did, so on 0.8.117 status is right while logs is wrong. Null when status
+ * cannot answer, or answers with anything but an absolute path.
+ */
+export declare function probeStatusLogPath(flags: Pick<DaemonLogsFlags, 'profile'>, capture?: typeof execRuntimeBinaryCapture): Promise<string | null>;
+/** What `skrr daemon logs` does: forward to the runtime, or read a file itself. */
+export type DaemonLogsPlan = 
+/** `runtimeVersion` decides whether a flag newer than 0.8.119 may be forwarded. */
+{
+    kind: 'forward';
+    runtimeVersion: string | null;
+}
+/** `note` goes to stderr before any log content; never printed for `--path`. */
+ | {
+    kind: 'read';
+    path: string;
+    note: string | null;
+    missingHint: string;
+};
+export interface DaemonLogsPlanDeps {
+    supportsLogs(): Promise<boolean | null>;
+    runtimeVersion(): Promise<string | null>;
+    statusLogPath(): Promise<string | null>;
+    /** The profile log for this invocation (`daemon.err.log` under `--stderr`). */
+    profilePath: string;
+    service: InstalledServiceLogDestinations | null;
+    mtimeOf(filePath: string): number | null;
+}
+/**
+ * Decide which runtime, if any, `skrr daemon logs` may trust (OSK-15993).
+ *
+ * - No `logs` subcommand: the legacy fallback, as before.
+ * - A runtime at or above {@link LIVE_LOG_RESOLUTION_RUNTIME_VERSION}: forward.
+ * - An older runtime, or one whose version cannot be read: ask its `status`
+ *   which file the live daemon writes and read that file here. When status
+ *   cannot answer, an older runtime gets the legacy fallback (the newest of the
+ *   profile log and the installed service's logs); an unknown one is forwarded.
+ */
+export declare function planDaemonLogs(flags: Pick<DaemonLogsFlags, 'stderr'>, deps: DaemonLogsPlanDeps): Promise<DaemonLogsPlan>;
 /** Read a bounded trailing window, so an unrotated legacy err log is safe. */
 export declare function readDaemonLogTail(filePath: string, maxLines: number): string[];
 /**
@@ -104,13 +206,15 @@ export declare function readDaemonLogTail(filePath: string, maxLines: number): s
  * or it parses successfully and is then silently dropped.
  */
 export declare function buildDaemonLogsArgs(flags: DaemonLogsFlags): string[];
+/** `--stderr` help, word for word the runtime's own (`daemon/src/index.ts`). */
+export declare const STDERR_FLAG_DESCRIPTION = "Read the daemon's raw stderr instead of its log: the file its installed service redirects stderr to, or the profile's daemon.err.log. A daemon started with --log-file by anything else has no known stderr file, so its live log (which carries every WARN and ERROR) is shown instead, with a note";
 export default class DaemonLogs extends Command {
     static aliases: string[];
     static description: string;
     /**
-     * Mirrors the four options `oversky logs` actually implements
+     * Mirrors the options `oversky logs` actually implements
      * (`daemon/src/index.ts` — `-n/--lines`, `-f/--follow`, `--stderr`,
-     * `--path`). Typed flags are deliberate — they give `skrr daemon logs --help`
+     * `--path`, and since 0.8.120 `--rotated`). Typed flags are deliberate — they give `skrr daemon logs --help`
      * something real to print, which raw `strict = false` passthrough never did.
      * The trade is that anything NOT declared here becomes unreachable, so this
      * list has to stay in step with the daemon command.
@@ -120,6 +224,7 @@ export default class DaemonLogs extends Command {
         lines: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
         stderr: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         path: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        rotated: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         profile: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     static examples: string[];