runspec-node 0.24.0 → 0.25.0

package/dist/logs.js

@@ -0,0 +1,504 @@
+"use strict";
+/**
+ * runspec logs — view / status / prune / compact per-invocation audit logs.
+ *
+ * The Node port of the Python `runspec/logs.py` engine. The per-run store
+ * (`[config.logging] store = "per-run"`) writes one
+ * `{runnable}.{utc-ts}.{run_id}.log` per invocation with no in-process rotation;
+ * this is the read + maintenance side. Pure functions (collectRecords,
+ * inventory, planPrune, planCompact) are kept separate from I/O so they can be
+ * unit-tested without a filesystem fixture.
+ */
+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.parseDuration = parseDuration;
+exports.parseSize = parseSize;
+exports.logDirs = logDirs;
+exports.discover = discover;
+exports.isManaged = isManaged;
+exports.collectRecords = collectRecords;
+exports.view = view;
+exports.inventory = inventory;
+exports.status = status;
+exports.planPrune = planPrune;
+exports.prune = prune;
+exports.planCompact = planCompact;
+exports.compact = compact;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const zlib = __importStar(require("zlib"));
+const finder_1 = require("./finder");
+const logging_setup_1 = require("./logging_setup");
+// Filename grammar (under {logs}/), matching the Node + Python write side:
+//   {runnable}.log                              single-mode active file
+//   {runnable}.{YYYYMMDDThhmmssZ}.{run_id}.log  per-run invocation file
+//   {runnable}.archive.{YYYYMMDD}.log[.gz]      compacted archive
+const PER_RUN_RE = /\.\d{8}T\d{6}Z\.[0-9a-fA-F-]{8,}\.log$/;
+const ARCHIVE_RE = /\.archive\.\d{8}\.log(?:\.gz)?$/;
+const DUR_MS = { s: 1000, m: 60_000, h: 3_600_000, d: 86_400_000, w: 604_800_000 };
+const SIZE_MULT = { B: 1, KB: 1024, MB: 1024 ** 2, GB: 1024 ** 3 };
+// ── parsing helpers ────────────────────────────────────────────────────────────
+/** '30m' / '24h' / '7d' / '2w' → milliseconds. Throws on a bad value. */
+function parseDuration(s) {
+    const m = /^\s*(\d+)\s*([smhdw])\s*$/i.exec(s);
+    if (!m)
+        throw new Error(`invalid duration ${JSON.stringify(s)} — use e.g. 30m, 24h, 7d, 2w`);
+    return parseInt(m[1], 10) * DUR_MS[m[2].toLowerCase()];
+}
+/** '500KB' / '10MB' / '5GB' → bytes. Throws on a bad value. */
+function parseSize(s) {
+    const m = /^\s*(\d+(?:\.\d+)?)\s*(B|KB|MB|GB)?\s*$/i.exec(s);
+    if (!m)
+        throw new Error(`invalid size ${JSON.stringify(s)} — use e.g. 500KB, 10MB, 5GB`);
+    return Math.round(parseFloat(m[1]) * SIZE_MULT[(m[2] ?? 'B').toUpperCase()]);
+}
+function iso(mtimeMs) {
+    if (mtimeMs === null)
+        return null;
+    return new Date(mtimeMs).toISOString().replace(/\.\d{3}Z$/, 'Z');
+}
+function humanSize(n) {
+    let size = n;
+    for (const unit of ['B', 'KB', 'MB', 'GB', 'TB']) {
+        if (size < 1024 || unit === 'TB')
+            return unit === 'B' ? `${Math.round(size)} B` : `${size.toFixed(1)} ${unit}`;
+        size /= 1024;
+    }
+    return `${size.toFixed(1)} TB`;
+}
+// ── discovery ──────────────────────────────────────────────────────────────────
+/** Existing logs directories, in priority order: the project's logs/, then ~/logs. */
+function logDirs() {
+    const candidates = [];
+    try {
+        const { configPath } = (0, finder_1.findConfig)();
+        const root = (0, logging_setup_1.findProjectRoot)(path.dirname(configPath)) ?? path.dirname(configPath);
+        candidates.push(path.join(root, 'logs'));
+    }
+    catch {
+        // no project context (no runspec.toml) — fall back to ~/logs only
+    }
+    candidates.push(path.join(os.homedir(), 'logs'));
+    const seen = new Set();
+    const out = [];
+    for (const d of candidates) {
+        const r = path.resolve(d);
+        if (seen.has(r))
+            continue;
+        seen.add(r);
+        try {
+            if (fs.statSync(d).isDirectory())
+                out.push(d);
+        }
+        catch {
+            // not present — skip
+        }
+    }
+    return out;
+}
+function matchesRunnable(name, runnable) {
+    if (!(name.endsWith('.log') || name.endsWith('.log.gz')))
+        return false;
+    if (!runnable)
+        return true;
+    return name === `${runnable}.log` || name.startsWith(`${runnable}.`);
+}
+function discover(dirs, runnable) {
+    const seen = new Set();
+    const files = [];
+    for (const d of dirs) {
+        let entries;
+        try {
+            entries = fs.readdirSync(d);
+        }
+        catch {
+            continue;
+        }
+        for (const name of entries) {
+            if (!matchesRunnable(name, runnable))
+                continue;
+            const full = path.join(d, name);
+            if (seen.has(full))
+                continue;
+            try {
+                if (!fs.statSync(full).isFile())
+                    continue;
+            }
+            catch {
+                continue;
+            }
+            seen.add(full);
+            files.push(full);
+        }
+    }
+    return files;
+}
+/** True only for per-run files and archives — never a single {runnable}.log. */
+function isManaged(p) {
+    const n = path.basename(p);
+    return PER_RUN_RE.test(n) || ARCHIVE_RE.test(n);
+}
+function isArchive(p) {
+    return ARCHIVE_RE.test(path.basename(p));
+}
+function runnableOf(p) {
+    const n = path.basename(p);
+    for (const rx of [PER_RUN_RE, ARCHIVE_RE]) {
+        const m = rx.exec(n);
+        if (m)
+            return n.slice(0, m.index);
+    }
+    return n.endsWith('.log.gz') ? n.slice(0, -7) : n.slice(0, -4);
+}
+function readLines(p) {
+    let text;
+    try {
+        text = p.endsWith('.gz') ? zlib.gunzipSync(fs.readFileSync(p)).toString('utf-8') : fs.readFileSync(p, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    return text.split('\n').filter((l) => l.trim() !== '');
+}
+/** Merge a runnable's files into one timestamp-sorted list of {rec, raw}. Pure. */
+function collectRecords(dirs, runnable, opts = {}) {
+    const raws = [];
+    for (const f of discover(dirs, runnable))
+        raws.push(...readLines(f));
+    const parsed = [];
+    const userOfRun = {};
+    for (const raw of raws) {
+        let rec;
+        try {
+            rec = JSON.parse(raw);
+        }
+        catch {
+            continue;
+        }
+        const extra = rec && typeof rec.extra === 'object' && rec.extra ? rec.extra : {};
+        if (extra.event === 'run_summary' && extra.run_id)
+            userOfRun[extra.run_id] = extra.user ?? '';
+        parsed.push({ rec, raw });
+    }
+    const cutoff = opts.since != null ? Date.now() - opts.since : null;
+    const keep = (rec) => {
+        const extra = rec.extra && typeof rec.extra === 'object' ? rec.extra : {};
+        const rid = extra.run_id ?? '';
+        if (opts.run && rid !== opts.run)
+            return false;
+        if (opts.user && (userOfRun[rid] ?? extra.user ?? '') !== opts.user)
+            return false;
+        if (cutoff != null) {
+            const t = Date.parse(rec.ts ?? '');
+            if (Number.isNaN(t) || t < cutoff)
+                return false;
+        }
+        return true;
+    };
+    return parsed.filter((p) => keep(p.rec)).sort((a, b) => String(a.rec.ts ?? '').localeCompare(String(b.rec.ts ?? '')));
+}
+function formatLine(rec, userOfRun) {
+    const extra = rec.extra && typeof rec.extra === 'object' ? rec.extra : {};
+    const rid = extra.run_id ?? '';
+    const user = extra.user || userOfRun[rid] || '';
+    const ts = rec.ts ?? '';
+    const level = String(rec.level ?? '').padEnd(8);
+    const msg = rec.message ?? '';
+    return `${ts} ${level} run=${(rid || '-').slice(0, 8)} user=${user || '-'} ${msg}`;
+}
+function emit(records, asJson, out) {
+    const userOfRun = {};
+    for (const { rec } of records) {
+        const extra = rec.extra && typeof rec.extra === 'object' ? rec.extra : {};
+        if (extra.event === 'run_summary' && extra.run_id)
+            userOfRun[extra.run_id] = extra.user ?? '';
+    }
+    for (const { rec, raw } of records) {
+        out(asJson ? raw + '\n' : formatLine(rec, userOfRun) + '\n');
+    }
+}
+/** Write the merged stream to `out` (default stdout). Supports `--follow` (poll). */
+function view(runnable, opts = {}) {
+    const dirs = opts.dirs ?? logDirs();
+    const out = opts.out ?? ((s) => process.stdout.write(s));
+    const co = { since: opts.since, run: opts.run, user: opts.user };
+    const records = collectRecords(dirs, runnable, co);
+    emit(records, !!opts.asJson, out);
+    if (!opts.follow)
+        return;
+    const key = (r) => `${r.ts ?? ''}|${(r.extra && r.extra.run_id) ?? ''}|${r.message ?? ''}`;
+    const seen = new Set(records.map((p) => key(p.rec)));
+    const interval = setInterval(() => {
+        const fresh = collectRecords(dirs, runnable, co).filter((p) => !seen.has(key(p.rec)));
+        if (fresh.length) {
+            emit(fresh, !!opts.asJson, out);
+            for (const p of fresh)
+                seen.add(key(p.rec));
+        }
+    }, opts.pollMs ?? 1000);
+    // Don't keep the event loop alive solely for the poll if the process is done.
+    if (typeof interval.unref === 'function')
+        interval.unref();
+}
+/** Per-runnable inventory of managed files. Pure (stat only). */
+function inventory(dirs, runnable = null) {
+    const per = {};
+    for (const f of discover(dirs, runnable)) {
+        if (!isManaged(f))
+            continue;
+        let st;
+        try {
+            st = fs.statSync(f);
+        }
+        catch {
+            continue;
+        }
+        const name = runnableOf(f);
+        const row = (per[name] ??= { runnable: name, per_run_files: 0, archives: 0, total_bytes: 0, oldest: null, newest: null });
+        if (isArchive(f))
+            row.archives++;
+        else
+            row.per_run_files++;
+        row.total_bytes += st.size;
+        if (row.oldest === null || st.mtimeMs < row.oldest)
+            row.oldest = st.mtimeMs;
+        if (row.newest === null || st.mtimeMs > row.newest)
+            row.newest = st.mtimeMs;
+    }
+    return per;
+}
+function status(runnable = null, opts = {}) {
+    const dirs = opts.dirs ?? logDirs();
+    const out = opts.out ?? ((s) => process.stdout.write(s));
+    const rows = Object.values(inventory(dirs, runnable)).sort((a, b) => a.runnable.localeCompare(b.runnable));
+    const totalBytes = rows.reduce((s, r) => s + r.total_bytes, 0);
+    const totalFiles = rows.reduce((s, r) => s + r.per_run_files + r.archives, 0);
+    if (opts.asJson) {
+        out(JSON.stringify({
+            dirs,
+            runnables: rows.map((r) => ({
+                runnable: r.runnable,
+                per_run_files: r.per_run_files,
+                archives: r.archives,
+                total_bytes: r.total_bytes,
+                oldest: iso(r.oldest),
+                newest: iso(r.newest),
+            })),
+            total_bytes: totalBytes,
+            total_files: totalFiles,
+        }) + '\n');
+        return;
+    }
+    if (rows.length === 0) {
+        out('No per-invocation logs found.\n');
+        return;
+    }
+    const nameW = Math.max('RUNNABLE'.length, ...rows.map((r) => r.runnable.length));
+    out(`${'RUNNABLE'.padEnd(nameW)}  ${'RUNS'.padStart(6)}  ${'ARCHIVES'.padStart(8)}  ${'SIZE'.padStart(10)}  NEWEST\n`);
+    for (const r of rows) {
+        out(`${r.runnable.padEnd(nameW)}  ${String(r.per_run_files).padStart(6)}  ${String(r.archives).padStart(8)}  ${humanSize(r.total_bytes).padStart(10)}  ${iso(r.newest) ?? '-'}\n`);
+    }
+    out(`\n${totalFiles} file(s), ${humanSize(totalBytes)} total across ${rows.length} runnable(s).\n`);
+}
+/** Return the managed files to delete. Pure — touches nothing. Throws if no policy. */
+function planPrune(dirs, runnable, policy, now = Date.now()) {
+    const { olderThan = null, maxFiles = null, maxTotalSize = null } = policy;
+    if (olderThan == null && maxFiles == null && maxTotalSize == null) {
+        throw new Error('prune needs at least one of --older-than / --max-files / --max-total-size');
+    }
+    const files = discover(dirs, runnable).filter(isManaged);
+    const stat = new Map();
+    for (const f of files) {
+        try {
+            stat.set(f, fs.statSync(f));
+        }
+        catch {
+            // skip vanished file
+        }
+    }
+    const live = files.filter((f) => stat.has(f));
+    const doomed = new Set();
+    if (olderThan != null) {
+        const cut = now - olderThan;
+        for (const f of live)
+            if (stat.get(f).mtimeMs < cut)
+                doomed.add(f);
+    }
+    if (maxFiles != null) {
+        const per = {};
+        for (const f of live)
+            (per[runnableOf(f)] ??= []).push(f);
+        for (const group of Object.values(per)) {
+            group.sort((a, b) => stat.get(b).mtimeMs - stat.get(a).mtimeMs); // newest first
+            for (const f of group.slice(maxFiles))
+                doomed.add(f);
+        }
+    }
+    if (maxTotalSize != null) {
+        const ordered = [...live].sort((a, b) => stat.get(b).mtimeMs - stat.get(a).mtimeMs);
+        let total = 0;
+        for (const f of ordered) {
+            total += stat.get(f).size;
+            if (total > maxTotalSize)
+                doomed.add(f);
+        }
+    }
+    return [...doomed].sort((a, b) => stat.get(a).mtimeMs - stat.get(b).mtimeMs);
+}
+function prune(runnable, opts = {}) {
+    const dirs = opts.dirs ?? logDirs();
+    const out = opts.out ?? ((s) => process.stdout.write(s));
+    const targets = planPrune(dirs, runnable, opts);
+    let freed = 0;
+    const deleted = [];
+    for (const f of targets) {
+        let size = 0;
+        try {
+            size = fs.statSync(f).size;
+        }
+        catch {
+            // already gone
+        }
+        if (!opts.dryRun) {
+            try {
+                fs.unlinkSync(f);
+            }
+            catch {
+                // ignore
+            }
+        }
+        freed += size;
+        deleted.push({ path: f, bytes: size });
+        if (!opts.asJson)
+            out(`${opts.dryRun ? 'would delete' : 'deleted'}  ${f}  (${size} bytes)\n`);
+    }
+    if (opts.asJson) {
+        out(JSON.stringify({ dry_run: !!opts.dryRun, count: targets.length, freed_bytes: freed, deleted }) + '\n');
+    }
+    else {
+        out(`${opts.dryRun ? 'Would free' : 'Freed'} ${freed} bytes across ${targets.length} file(s).\n`);
+    }
+    return { count: targets.length, freed };
+}
+// ── compact ──────────────────────────────────────────────────────────────────────
+function lineTs(line) {
+    try {
+        return String(JSON.parse(line).ts ?? '');
+    }
+    catch {
+        return '';
+    }
+}
+/** Map each per-runnable archive target → the per-run files to fold in. Pure. */
+function planCompact(dirs, runnable, olderThan, now = Date.now()) {
+    const cut = now - olderThan;
+    const today = new Date().toISOString().slice(0, 10).replace(/-/g, '');
+    const plan = new Map();
+    for (const f of discover(dirs, runnable)) {
+        if (!isManaged(f) || isArchive(f))
+            continue;
+        let st;
+        try {
+            st = fs.statSync(f);
+        }
+        catch {
+            continue;
+        }
+        if (st.mtimeMs >= cut)
+            continue;
+        const archive = path.join(path.dirname(f), `${runnableOf(f)}.archive.${today}.log`);
+        (plan.get(archive) ?? plan.set(archive, []).get(archive)).push(f);
+    }
+    return plan;
+}
+function compact(runnable, olderThan, opts = {}) {
+    const dirs = opts.dirs ?? logDirs();
+    const out = opts.out ?? ((s) => process.stdout.write(s));
+    const plan = planCompact(dirs, runnable, olderThan);
+    let compacted = 0;
+    const archives = [];
+    for (const [archive, sources] of plan) {
+        const target = opts.gzip ? archive + '.gz' : archive;
+        if (opts.dryRun) {
+            archives.push({ archive: target, count: sources.length, sources });
+            compacted += sources.length;
+            if (!opts.asJson)
+                out(`would compact ${sources.length} file(s) → ${target}\n`);
+            continue;
+        }
+        const lines = [];
+        for (const existing of [archive, archive + '.gz']) {
+            if (fs.existsSync(existing))
+                lines.push(...readLines(existing));
+        }
+        for (const s of sources)
+            lines.push(...readLines(s));
+        lines.sort((a, b) => lineTs(a).localeCompare(lineTs(b)));
+        const body = lines.join('\n') + '\n';
+        if (opts.gzip) {
+            fs.writeFileSync(target, zlib.gzipSync(Buffer.from(body, 'utf-8')));
+            if (fs.existsSync(archive) && archive !== target) {
+                try {
+                    fs.unlinkSync(archive);
+                }
+                catch {
+                    // ignore
+                }
+            }
+        }
+        else {
+            fs.writeFileSync(target, body, 'utf-8');
+        }
+        for (const s of sources) {
+            try {
+                fs.unlinkSync(s);
+            }
+            catch {
+                // ignore
+            }
+        }
+        archives.push({ archive: target, count: sources.length, sources });
+        compacted += sources.length;
+        if (!opts.asJson)
+            out(`compacted ${sources.length} file(s) → ${target}\n`);
+    }
+    if (opts.asJson)
+        out(JSON.stringify({ dry_run: !!opts.dryRun, compacted, archives }) + '\n');
+    else if (plan.size === 0)
+        out('nothing to compact.\n');
+    return compacted;
+}
+//# sourceMappingURL=logs.js.map

package/dist/logs.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runspec-node",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Node/TypeScript language pack for runspec",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/cli.ts

@@ -2,6 +2,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import * as readline from 'readline';
 import { findConfig } from './finder';
+import * as logs from './logs';
 import { loadRaw } from './loader';
 import { inferScript } from './inference';
 import { parse } from './parser';
@@ -33,6 +34,7 @@ export function main(): void {
     init: cmdInit,
     local: cmdLocal,
     bin: cmdBin,
+    logs: cmdLogs,
     jump: cmdJump,
     serve: cmdServe,
   };
@@ -230,6 +232,69 @@ function toPosix(p: string): string {
   return p.split(path.sep).join('/');
 }
 
+function cmdLogs(args: string[]): void {
+  const has = (name: string): boolean => args.includes(name);
+  const valueFlags = new Set(['--since', '--user', '--run', '--older-than', '--max-files', '--max-total-size']);
+  const val = (name: string): string | undefined => {
+    const i = args.indexOf(name);
+    return i >= 0 && i + 1 < args.length ? args[i + 1] : undefined;
+  };
+  // Positionals are tokens that aren't flags or flag-values.
+  const positionals: string[] = [];
+  for (let i = 0; i < args.length; i++) {
+    const a = args[i];
+    if (a.startsWith('-')) {
+      if (valueFlags.has(a)) i++; // skip its value
+      continue;
+    }
+    positionals.push(a);
+  }
+
+  // `runspec logs status|prune|compact [runnable]` vs `runspec logs <runnable>`.
+  const target = positionals[0];
+  const verb = target === 'status' || target === 'prune' || target === 'compact' ? target : 'view';
+  const runnable = verb === 'view' ? target : positionals[1] ?? null;
+
+  try {
+    if (verb === 'view') {
+      if (!runnable) {
+        console.log('✗  A runnable is required: runspec logs <runnable>');
+        process.exit(1);
+      }
+      logs.view(runnable, {
+        since: val('--since') ? logs.parseDuration(val('--since')!) : null,
+        run: val('--run') ?? null,
+        user: val('--user') ?? null,
+        asJson: has('--json'),
+        follow: has('--follow'),
+      });
+    } else if (verb === 'status') {
+      logs.status(runnable, { asJson: has('--json') });
+    } else if (verb === 'prune') {
+      logs.prune(runnable, {
+        olderThan: val('--older-than') ? logs.parseDuration(val('--older-than')!) : null,
+        maxFiles: val('--max-files') ? parseInt(val('--max-files')!, 10) : null,
+        maxTotalSize: val('--max-total-size') ? logs.parseSize(val('--max-total-size')!) : null,
+        dryRun: has('--dry-run'),
+        asJson: has('--json'),
+      });
+    } else if (verb === 'compact') {
+      if (!val('--older-than')) {
+        console.log('✗  compact requires --older-than (e.g. --older-than 7d)');
+        process.exit(1);
+      }
+      logs.compact(runnable, logs.parseDuration(val('--older-than')!), {
+        gzip: has('--gzip'),
+        dryRun: has('--dry-run'),
+        asJson: has('--json'),
+      });
+    }
+  } catch (err) {
+    console.log(`✗  ${(err as Error).message}`);
+    process.exit(1);
+  }
+}
+
 async function cmdJump(args: string[]): Promise<void> {
   const parsed = parse({ scriptName: 'runspec', argv: ['jump', ...args], configPath: _CLI_CONFIG });
   const fmt = String(parsed['format'] ?? 'text');
@@ -751,6 +816,7 @@ Commands:
   init        Create runspec.toml and a code stub
   local       List runnables and emit tool schemas
   bin         Generate a venv-shaped bin/ so a controller can run this folder
+  logs        View, status, prune, or compact per-invocation audit logs
   jump        Execute a runnable on a remote host via SSH
   serve       Start the MCP stdio server for local runnables
 
@@ -762,6 +828,7 @@ Examples:
   runspec local
   runspec local --format mcp
   runspec bin
+  runspec logs deploy
   runspec serve`);
 }
 
@@ -806,6 +873,25 @@ Examples:
     npm install runspec-node
     runspec bin`,
 
+    logs: `runspec logs — View, status, prune, or compact per-invocation audit logs
+
+  For runnables using [config.logging] store = "per-run" (one file per
+  invocation, no in-process rotation). Reads/maintains the project's logs/.
+
+  View (default):
+    runspec logs <runnable>                 merged, timestamp-sorted stream
+    runspec logs <runnable> --follow         live tail across invocations
+    runspec logs <runnable> --since 1h --user alice --run <id>
+    runspec logs <runnable> --json           raw JSON lines
+
+  Status / retention (default to all runnables):
+    runspec logs status [runnable] [--json]  per-runnable file + disk inventory
+    runspec logs compact [runnable] --older-than 7d [--gzip] [--dry-run]
+    runspec logs prune [runnable] --older-than 90d | --max-files N | --max-total-size 5GB [--dry-run]
+
+  prune/compact never touch a single-mode {runnable}.log — only per-run files
+  and archives. Add --json to any verb for machine-readable output.`,
+
     jump: `runspec jump — Execute a runnable on a remote host via SSH
 
   Not yet implemented in the Node package.