2g 0.3.1 → 0.4.0

package/dist/chunks/cli-chunk.mjs

@@ -2,17 +2,19 @@ import { fileURLToPath as e } from "node:url";
 
 import { parseArgs as t } from "node:util";
 
-import { a as n, b as s, c as o, d as i, m as r, e as a, p as l } from "./sessionSockets-chunk.mjs";
+import { c as n, a as s, b as o, p as r, m as i, d as a, e as l } from "./sessionSockets-chunk.mjs";
 
-import { r as p, s as c, f as u } from "./pretty-chunk.mjs";
+import { r as c, s as p, f as u } from "./pretty-chunk.mjs";
 
 import d from "node:fs";
 
-import { r as f, t as m, l as h } from "./tap-chunk.mjs";
+import { d as m, r as f, t as h, l as g, c as v } from "./api-chunk.mjs";
 
-import { createInterface as g } from "node:readline";
+import { createInterface as y } from "node:readline";
 
-import v from "node:crypto";
+import w from "node:crypto";
+
+import { spawn as b } from "node:child_process";
 
 function runCleanCli(e = []) {
   const o = function parseCleanOptions(e) {
@@ -38,15 +40,15 @@ function runCleanCli(e = []) {
     };
   }(e);
   if (o.json) {
-    p();
+    c();
   }
-  const i = o.all ? n() : s();
+  const r = o.all ? n() : s();
   process.stdout.write(o.json ? `${JSON.stringify({
-    removed: i
-  })}\n` : `Removed ${i} ${o.all ? "exited" : "stale"} sessions.\n`);
+    removed: r
+  })}\n` : `Removed ${r} ${o.all ? "exited" : "stale"} sessions.\n`);
 }
 
-const y = {
+const x = {
   since: {
     type: "string"
   },
@@ -65,8 +67,15 @@ const y = {
   }
 };
 
+async function warnOnRotationLoss(e, t) {
+  if (!await m(e)) {
+    return;
+  }
+  console.warn(`⚠ Earlier events were rotated out of the retained window.\n  For a complete trace, start \`${t}\` before the workload.`);
+}
+
 async function* readJsonlStream(e) {
-  const t = g({
+  const t = y({
     input: e
   });
   for await (const e of t) {
@@ -82,6 +91,21 @@ async function* readJsonlStream(e) {
   }
 }
 
+async function* filterEvents(e, t) {
+  const n = o(t.filter);
+  const s = r(t.since);
+  for await (const o of e) {
+    if (i(o, {
+      filter: t.filter,
+      since: s,
+      spans: t.spans,
+      debug: t.debug
+    }, n)) {
+      yield o;
+    }
+  }
+}
+
 function parseSharedTapOptions(e) {
   return {
     since: e.since,
@@ -106,7 +130,15 @@ function parseHelp(e) {
   }).values.help;
 }
 
-const w = [ ":started", ":done", ":failed" ];
+const S = [ ":started", ":done", ":failed" ];
+
+async function convertToChromeTrace(e, t = {}) {
+  const n = new TraceConverter(t);
+  for await (const t of e) {
+    n.add(t);
+  }
+  return n.toTraceFile();
+}
 
 class TraceConverter {
   #e=[];
@@ -141,7 +173,7 @@ class TraceConverter {
         name: e.slice(t + 1)
       };
     }(e._e);
-    const n = this.#i(t.category, "string" == typeof e._w ? e._w : void 0);
+    const n = this.#r(t.category, "string" == typeof e._w ? e._w : void 0);
     const s = function extractArgs(e) {
       const t = {};
       for (const n of Object.keys(e)) {
@@ -192,31 +224,31 @@ class TraceConverter {
     const n = new Map;
     let s = 1;
     for (const [e, o] of this.#t) {
-      const i = [];
+      const r = [];
       for (const t of this.#e) {
         if ("span" === t.kind && t.track === e) {
-          i.push(t);
+          r.push(t);
         }
       }
-      const r = Math.max(assignLanes(i), 1);
-      for (let i = 0; i < r; i++) {
-        const r = s++;
-        n.set(`${e}\0${i}`, r);
+      const i = Math.max(assignLanes(r), 1);
+      for (let r = 0; r < i; r++) {
+        const i = s++;
+        n.set(`${e}\0${r}`, i);
         t.push({
           ph: "M",
           name: "thread_name",
           pid: this.#n,
-          tid: r,
+          tid: i,
           args: {
-            name: 0 === i ? o : `${o} #${i + 1}`
+            name: 0 === r ? o : `${o} #${r + 1}`
           }
         }, {
           ph: "M",
           name: "thread_sort_index",
           pid: this.#n,
-          tid: r,
+          tid: i,
           args: {
-            sort_index: r
+            sort_index: i
           }
         });
       }
@@ -258,7 +290,7 @@ class TraceConverter {
       }
     };
   }
-  #i(e, t) {
+  #r(e, t) {
     const n = t ? `${e}:${t}` : e;
     if (!this.#t.has(n)) {
       this.#t.set(n, t ? `${e} ${t}` : e);
@@ -274,13 +306,13 @@ function assignLanes(e) {
     const t = e.ts + e.dur;
     let s = -1;
     for (let o = 0; o < n.length; o++) {
-      const i = n[o];
-      while (i.length && i[i.length - 1].ts + i[i.length - 1].dur <= e.ts) {
-        i.pop();
+      const r = n[o];
+      while (r.length && r[r.length - 1].ts + r[r.length - 1].dur <= e.ts) {
+        r.pop();
       }
-      const r = i[i.length - 1];
-      if (!r || r.ts + r.dur >= t) {
-        i.push(e);
+      const i = r[r.length - 1];
+      if (!i || i.ts + i.dur >= t) {
+        r.push(e);
         s = o;
         break;
       }
@@ -295,7 +327,7 @@ function assignLanes(e) {
 }
 
 function stripSuffix$1(e) {
-  for (const t of w) {
+  for (const t of S) {
     if (e.endsWith(t)) {
       return e.slice(0, -t.length);
     }
@@ -303,16 +335,24 @@ function stripSuffix$1(e) {
   return e;
 }
 
-const b = [ ":started", ":done", ":failed" ];
+const T = [ ":started", ":done", ":failed" ];
+
+async function convertToOpenTelemetry(e, t = {}) {
+  const n = new OpenTelemetryConverter(t);
+  for await (const t of e) {
+    n.add(t);
+  }
+  return n.toFile();
+}
 
 class OpenTelemetryConverter {
-  #r=v.randomBytes(16).toString("hex");
+  #i=w.randomBytes(16).toString("hex");
   #a=createSpanId();
   #l=[];
-  #p=[];
+  #c=[];
   #s;
   #o="0.1.0";
-  #c;
+  #p;
   #u;
   constructor(e) {
     this.options = e;
@@ -320,7 +360,7 @@ class OpenTelemetryConverter {
   }
   add(e) {
     const t = unixNano(e._t);
-    this.#c = null == this.#c || BigInt(t) < BigInt(this.#c) ? t : this.#c;
+    this.#p = null == this.#p || BigInt(t) < BigInt(this.#p) ? t : this.#p;
     this.#u = null == this.#u || BigInt(t) > BigInt(this.#u) ? t : this.#u;
     if ("root:init" === e._e) {
       if ("string" == typeof e.version) {
@@ -334,11 +374,11 @@ class OpenTelemetryConverter {
     if ("number" == typeof e._d) {
       this.#l.push(this.#d(e));
     } else {
-      this.#p.push(this.#f(e));
+      this.#c.push(this.#m(e));
     }
   }
   toFile() {
-    const e = this.#c ?? unixNano(Date.now());
+    const e = this.#p ?? unixNano(Date.now());
     const t = this.#u ?? e;
     return {
       resourceSpans: [ {
@@ -356,7 +396,7 @@ class OpenTelemetryConverter {
             name: "2g"
           },
           spans: [ {
-            traceId: this.#r,
+            traceId: this.#i,
             spanId: this.#a,
             name: this.#s,
             startTimeUnixNano: e,
@@ -364,7 +404,7 @@ class OpenTelemetryConverter {
             attributes: attributes({
               "event_log.kind": "session"
             }),
-            events: this.#p.length ? this.#p : void 0
+            events: this.#c.length ? this.#c : void 0
           }, ...this.#l ]
         } ]
       } ]
@@ -375,7 +415,7 @@ class OpenTelemetryConverter {
     const n = unixNano(e._t - e._d);
     const s = unixNano(e._t);
     return {
-      traceId: this.#r,
+      traceId: this.#i,
       spanId: createSpanId(),
       parentSpanId: this.#a,
       name: t ? stripSuffix(t.name) : e._e,
@@ -384,7 +424,7 @@ class OpenTelemetryConverter {
       attributes: eventAttributes(e, t)
     };
   }
-  #f(e) {
+  #m(e) {
     const t = splitEventName(e._e);
     return {
       timeUnixNano: unixNano(e._t),
@@ -470,7 +510,7 @@ function anyValue(e) {
 }
 
 function createSpanId() {
-  return v.randomBytes(8).toString("hex");
+  return w.randomBytes(8).toString("hex");
 }
 
 function unixNano(e) {
@@ -489,7 +529,7 @@ function splitEventName(e) {
 }
 
 function stripSuffix(e) {
-  for (const t of b) {
+  for (const t of T) {
     if (e.endsWith(t)) {
       return e.slice(0, -t.length);
     }
@@ -500,7 +540,7 @@ function stripSuffix(e) {
 async function runExportCli(e) {
   if (parseHelp(e)) {
     !function printExportHelp() {
-      process.stdout.write([ "Usage: 2g export [selector]", "", "Exports session events to Chrome Trace or OTLP JSON.", "", "Options:", "  selector                 Substring of PID, CWD, or command; a running", "                           session wins ties", "  --input <file>           Read JSONL events from a file", "  -o, --output <file>      Write output to a file", "  --format <format>        chrome-trace or opentelemetry", "  --json                   Print JSON output", "  --since <time>           Duration ago (5m, 90s), Unix time, or ISO date", "  --filter <pattern>       Event name prefix (whole segments), e.g. category,", "                           category:kind; * wildcards; comma-separated", "  --spans                  Keep only span events (log.span() pairs with a _d", "                           duration); omit to include point events too. A", '                           plain "ms" payload field is not a span', "  --debug                  Include debug events (only recorded when the", "                           command ran with LOG_DEBUG set)", "  --tail                   Follow live events after replaying history", "  --timeout <duration>     Stop tailing after an absolute duration", "                           Tail also stops after 30s without new events", "" ].join("\n"));
+      process.stdout.write([ "Usage: 2g export [selector]", "", "Exports session events to Chrome Trace or OTLP JSON.", "(Without --tail it reads only the retained window. Rotated out logs may be lost)", "", "--tail attaches to an already-running session and follows live from that point.", "  Run it after the session is up and leave it attached while the workload runs.", "  It will automatically stop on 30s idle.", "To trace a full command instead, use `2g record`.", "", "Options:", "  selector                 Substring of PID, CWD, or command; a running", "                           session wins ties", "  --input <file>           Read JSONL events from a file", "  -o, --output <file>      Write output to a file", "  --format <format>        chrome-trace or opentelemetry", "  --json                   Print JSON output", "  --since <time>           Duration ago (5m, 90s), Unix time, or ISO date", "  --filter <pattern>       Event name prefix (whole segments), e.g. category,", "                           category:kind; * wildcards; comma-separated", "  --spans                  Keep only span events (log.span() pairs with a _d", "                           duration); omit to include point events too. A", '                           plain "ms" payload field is not a span', "  --debug                  Include debug events (only recorded when the", "                           command ran with LOG_DEBUG set)", "  --tail                   Follow live events after replaying history; stops", "                           automatically on 30s idle", "  --timeout <duration>     Also stop tailing after this absolute duration", "" ].join("\n"));
     }();
     return;
   }
@@ -509,7 +549,7 @@ async function runExportCli(e) {
       args: e,
       allowPositionals: !0,
       options: {
-        ...y,
+        ...x,
         input: {
           type: "string"
         },
@@ -543,11 +583,11 @@ async function runExportCli(e) {
       }
       return t;
     }(n.values.timeout);
-    const i = n.values.format ?? "chrome-trace";
-    if (!function isExportFormat(e) {
+    const r = n.values.format ?? "chrome-trace";
+    if (!function isExportFormat$1(e) {
       return "chrome-trace" === e || "opentelemetry" === e;
-    }(i)) {
-      throw new Error(`Unsupported format: ${i}`);
+    }(r)) {
+      throw new Error(`Unsupported format: ${r}`);
     }
     if (n.positionals[0] && n.values.input) {
       throw new Error("Use either a session selector or --input, not both");
@@ -559,7 +599,7 @@ async function runExportCli(e) {
       selector: n.positionals[0],
       inputFile: n.values.input,
       output: n.values.output,
-      format: i,
+      format: r,
       since: s.since,
       filter: s.filter,
       spans: s.spans,
@@ -571,18 +611,19 @@ async function runExportCli(e) {
     };
   }(e);
   if (n.json) {
-    p();
+    c();
   }
   let s;
-  let l;
-  let c;
+  let o;
+  let r;
   if (n.selector) {
     const e = await f(n.selector);
-    l = function formatSessionProcessName(e) {
+    o = function formatSessionProcessName(e) {
       return e.version ? `${e.command} (v${e.version}, PID ${e.pid})` : `${e.command} (PID ${e.pid})`;
     }(e);
-    c = e.pid;
-    s = m(e.sessionDir, {
+    r = e.pid;
+    await warnOnRotationLoss(e.sessionDir, "2g export --tail");
+    s = h(e.sessionDir, {
       follow: n.follow,
       debug: n.debug,
       timeout: n.timeout,
@@ -599,44 +640,19 @@ async function runExportCli(e) {
       yield* readJsonlStream(process.stdin);
     }();
   }
-  const u = async function* filterEvents(e, t) {
-    const n = o(t.filter);
-    const s = i(t.since);
-    for await (const o of e) {
-      if (r(o, {
-        filter: t.filter,
-        since: s,
-        spans: t.spans,
-        debug: t.debug
-      }, n)) {
-        yield o;
-      }
-    }
-  }(s, n);
-  const h = "opentelemetry" === n.format ? await async function convertToOpenTelemetry(e, t = {}) {
-    const n = new OpenTelemetryConverter(t);
-    for await (const t of e) {
-      n.add(t);
-    }
-    return n.toFile();
-  }(u, {
-    pid: c,
-    processName: l
-  }) : await async function convertToChromeTrace(e, t = {}) {
-    const n = new TraceConverter(t);
-    for await (const t of e) {
-      n.add(t);
-    }
-    return n.toTraceFile();
-  }(u, {
-    pid: c,
-    processName: l
+  const i = filterEvents(s, n);
+  const l = "opentelemetry" === n.format ? await convertToOpenTelemetry(i, {
+    pid: r,
+    processName: o
+  }) : await convertToChromeTrace(i, {
+    pid: r,
+    processName: o
   });
-  const g = JSON.stringify(h, null, 2);
+  const p = JSON.stringify(l, null, 2);
   if (n.output) {
-    d.writeFileSync(n.output, `${g}\n`);
+    d.writeFileSync(n.output, `${p}\n`);
   } else {
-    process.stdout.write(`${g}\n`);
+    process.stdout.write(`${p}\n`);
   }
 }
 
@@ -644,6 +660,99 @@ function escapeTsv(e) {
   return String(e).replace(/\\/g, "\\\\").replace(/\t/g, "\\t").replace(/\r/g, "\\r").replace(/\n/g, "\\n");
 }
 
+async function runRecordCli(e) {
+  if (parseHelp(e)) {
+    !function printRecordHelp() {
+      process.stdout.write([ "Usage: 2g record [options] -- <command> [args...]", "", "Runs <command>, traces the events it emits, and writes the trace on exit.", "", "This is the reliable way to capture a one-off run (a build, a script): 2g", "owns the process, so the trace is complete end-to-end with no window to", "attach within and nothing to rotate out. To trace an already-running server", "instead, use `2g export <selector> --tail`.", "", "Options:", "  -o, --output <file>      Write the trace to a file (default: stdout)", "  --format <format>        chrome-trace or opentelemetry", "  --json                   Print JSON output", "  --filter <pattern>       Event name prefix (whole segments), e.g. category,", "                           category:kind; * wildcards; comma-separated", "  --spans                  Keep only span events (log.span() pairs with a _d", "                           duration); omit to include point events too", "  --debug                  Enable and export debug events; no LOG_DEBUG needed", "", "Example:", "  2g record -o trace.json -- expo export   # run & trace a build end-to-end", "" ].join("\n"));
+    }();
+    return;
+  }
+  const n = e.indexOf("--");
+  const s = -1 === n ? e : e.slice(0, n);
+  const o = -1 === n ? [] : e.slice(n + 1);
+  const r = function parseRecordOptions(e) {
+    const n = t({
+      args: e,
+      allowPositionals: !0,
+      options: {
+        filter: {
+          type: "string",
+          multiple: !0
+        },
+        spans: {
+          type: "boolean"
+        },
+        debug: {
+          type: "boolean"
+        },
+        output: {
+          type: "string",
+          short: "o"
+        },
+        format: {
+          type: "string"
+        },
+        json: {
+          type: "boolean"
+        },
+        help: {
+          type: "boolean",
+          short: "h"
+        }
+      }
+    });
+    const s = n.values.format ?? "chrome-trace";
+    if (!function isExportFormat(e) {
+      return "chrome-trace" === e || "opentelemetry" === e;
+    }(s)) {
+      throw new Error(`Unsupported format: ${s}`);
+    }
+    return {
+      output: n.values.output,
+      format: s,
+      filter: n.values.filter?.flatMap(e => e.split(",")).map(e => e.trim()).filter(Boolean),
+      spans: !0 === n.values.spans,
+      debug: !0 === n.values.debug,
+      json: n.values.json ?? !1
+    };
+  }(s);
+  if (!o.length) {
+    throw new Error("record needs a command to run: 2g record [options] -- <command> [args...]");
+  }
+  if (r.json) {
+    c();
+  }
+  const i = v({
+    debug: r.debug,
+    filter: r.filter
+  });
+  const a = b(o[0], o.slice(1), i.spawnOptions({
+    env: process.env,
+    stdio: [ "inherit", r.output ? "inherit" : 2, "inherit" ]
+  }));
+  i.attach(a);
+  const l = new Promise((e, t) => {
+    a.on("exit", t => e(t ?? 0));
+    a.on("error", e => t(new Error(`Failed to run ${o[0]}: ${e.message}`)));
+  });
+  const p = {
+    pid: a.pid,
+    processName: o.join(" ")
+  };
+  const u = filterEvents(i, r);
+  const m = "opentelemetry" === r.format ? await convertToOpenTelemetry(u, p) : await convertToChromeTrace(u, p);
+  const f = await l;
+  const h = JSON.stringify(m, null, 2);
+  if (r.output) {
+    d.writeFileSync(r.output, `${h}\n`);
+  } else {
+    process.stdout.write(`${h}\n`);
+  }
+  if (f) {
+    process.exitCode = f;
+  }
+}
+
 async function runTapCli(e) {
   if (parseHelp(e)) {
     !function printTapHelp() {
@@ -656,7 +765,7 @@ async function runTapCli(e) {
       args: e,
       allowPositionals: !0,
       options: {
-        ...y,
+        ...x,
         format: {
           type: "string"
         },
@@ -685,11 +794,12 @@ async function runTapCli(e) {
     };
   }(e);
   if (n.json) {
-    p();
+    c();
   }
   const s = await f(n.selector);
-  const o = c(process.stdout);
-  for await (const e of m(s.sessionDir, n)) {
+  await warnOnRotationLoss(s.sessionDir, "2g tap --tail");
+  const o = p(process.stdout);
+  for await (const e of h(s.sessionDir, n)) {
     if (n.pretty) {
       process.stdout.write(`${u(e, {
         colorize: o,
@@ -703,9 +813,9 @@ async function runTapCli(e) {
 
 async function main(e = process.argv.slice(2)) {
   const [n, ...s] = e;
-  if (!n || "--help" === n || "-h" === n) {
+  if (!n || "--help" === n || "-h" === n || "help" === n) {
     !function printHelp() {
-      process.stdout.write([ "Usage: 2g <command>", "", "Reads structured JSONL event logs that instrumented CLIs record during runs", "into the system temp dir, with no setup: run a command, then tap it here.", "", "Commands:", "  ps [selector]                 List recorded sessions", "    --active, -a (running only)  --json", "", "  tap [selector]                Replay session events as JSONL, oldest first", "    --since <time>  --filter <pattern>  --spans  --debug  --format pretty", "    --tail (follow live events after replay; runs until killed)", "", "  export [selector]             Export events to Chrome Trace or OTLP JSON", "    --input <jsonl-file>  -o, --output <file>  --json", "    --format chrome-trace|opentelemetry", "    --since <time>  --filter <pattern>  --spans  --debug", "    --tail  --timeout <duration> (absolute; tail also stops after 30s idle)", "", "  typegen                       List every event name/payload a project can emit", "    -p, --project <tsconfig>  -o, --output <file>  --format dts|json  --json", "", "  clean                         Remove stale sessions", "    --all, -a (remove all exited sessions)  --json", "", "Typical use:", "  2g ps -a                                         # what is running now?", '  2g tap "expo start" --tail                       # follow live events', '  2g tap "expo start" --since 5m --format pretty   # recent history, readable', '  2g tap "expo start" --filter metro:bundling      # narrow to one area', '  2g export "expo start" -o trace.json             # flame chart of a run', "", "Selectors match sessions by substring of PID, CWD, or command. If several", "match, and exactly one of them is running, it is chosen; otherwise 2g errors", "and lists the candidates.", "", "--filter takes comma-separated event-name prefixes matched on whole", 'segments: "category" and "category:kind" both match "category:kind:test";', "* matches anything. Discover names by tapping unfiltered or via typegen.", "", "--since accepts a duration ago (5m, 90s, 1h30m), Unix time, or ISO date.", '--spans keeps only span events (log.span() pairs with a "_d" duration in', "ms); without it, point events are included alongside spans.", "", 'Events are single JSON lines: {"_e":"category:kind","_t":<epoch ms>,...}.', '"_d" is a span duration, "_w" a worker id; debug events need --debug.', "", "Set LOG_EVENTS=<file|fd> on an instrumented command to redirect its events.", "Debug events are only recorded when the command runs with LOG_DEBUG set.", "", "Pass LOG_DEBUG=<filter> when debugging; it also mirrors matching events to", "stderr. Reading them back needs --debug.", "", "Run 2g <command> --help for per-command help.", "" ].join("\n"));
+      process.stdout.write([ "Usage: 2g <command>", "", "Reads structured JSONL event logs that instrumented CLIs record during runs", "into the system temp dir, with no setup: run a command, then tap it here.", "", "Commands:", "  ps [selector]                 List recorded sessions", "    --active, -a (running only)  --json", "", "  tap [selector]                Replay session events as JSONL, oldest first", "    --since <time>  --filter <pattern>  --spans  --debug  --format pretty", "    --tail (follow live events after replay; runs until killed)", "", "  record -- <command>          Run a command, trace it end-to-end, write on exit", "    -o, --output <file>  --format chrome-trace|opentelemetry  --json", "    --filter <pattern>  --spans  --debug", "", "  export [selector]             Export a past or live (--tail) session", "    --input <jsonl-file>  -o, --output <file>  --json", "    --format chrome-trace|opentelemetry", "    --since <time>  --filter <pattern>  --spans  --debug", "    --tail  --timeout <duration> (absolute; tail also stops after 30s idle)", "", "  typegen                       List every event name/payload a project can emit", "    -p, --project <tsconfig>  -o, --output <file>  --format dts|json  --json", "", "  clean                         Remove stale sessions", "    --all, -a (remove all exited sessions)  --json", "", "Typical use:", "  2g ps -a                                         # what is running now?", '  2g tap "expo start" --tail                       # follow live events', '  2g tap "expo start" --since 5m --format pretty   # recent history, readable', '  2g tap "expo start" --filter metro:bundling      # narrow to one area', "", "Trace a run to a flame chart:", "  2g record -o trace.json -- expo export           # run & trace a build", '  2g export "expo start" --tail -o trace.json      # attach to a running server', '  2g export "expo start" -o trace.json             # after the fact (partial)', "", "Selectors match sessions by substring of PID, CWD, or command. If several", "match, and exactly one of them is running, it is chosen; otherwise 2g errors", "and lists the candidates.", "", "--filter takes comma-separated event-name prefixes matched on whole", 'segments: "category" and "category:kind" both match "category:kind:test";', "* matches anything. Discover names by tapping unfiltered or via typegen.", "", "--since accepts a duration ago (5m, 90s, 1h30m), Unix time, or ISO date.", '--spans keeps only span events (log.span() pairs with a "_d" duration in', "ms); without it, point events are included alongside spans.", "", 'Events are single JSON lines: {"_e":"category:kind","_t":<epoch ms>,...}.', '"_d" is a span duration, "_w" a worker id; debug events need --debug.', "", "Set LOG_EVENTS=<file|fd> on an instrumented command to redirect its events.", "Debug events are only recorded when the command runs with LOG_DEBUG set.", "", "Pass LOG_DEBUG=<filter> when debugging; it also mirrors matching events to", "stderr. Reading them back needs --debug.", "", "Run 2g <command> --help for per-command help.", "" ].join("\n"));
     }();
     return 0;
   }
@@ -743,9 +853,9 @@ async function main(e = process.argv.slice(2)) {
         }
       });
       if (n.values.json) {
-        p();
+        c();
       }
-      const s = (await h({
+      const s = (await g({
         selector: n.positionals[0]
       })).filter(e => !n.values.active || e.alive);
       if (n.values.json) {
@@ -773,6 +883,10 @@ async function main(e = process.argv.slice(2)) {
     runCleanCli(s);
     return 0;
 
+   case "record":
+    await runRecordCli(s);
+    return 0;
+
    case "export":
     await runExportCli(s);
     return 0;