comm-scope 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 comm-scope AndyFree96
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,24 @@
+# comm-scope
+
+Serial / TCP / UDP traffic monitor for developers — watch, filter, record, replay and search byte-level communication.
+
+## Install
+
+```bash
+npm install -g comm-scope
+```
+
+## Quick start
+
+```bash
+comm-scope monitor udp-listen:9999      # live monitor
+comm-scope record serial:COM3:115200 --out session.jsonl
+comm-scope view session.jsonl           # offline replay
+comm-scope search session.jsonl --string "error" -C 2
+comm-scope replay session.jsonl --to serial:COM3
+comm-scope list-serial
+```
+
+## Full documentation
+
+See the [project README](https://github.com/AndyFree96/comm-scope) for the complete option reference, transport spec syntax, examples, recording format and architecture.

package/dist/index.js

@@ -0,0 +1,603 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/monitor.ts
+import chalk3 from "chalk";
+import { parseSpec, createTransport, Session, Analyzer, toDesc as toDesc2 } from "@anthonyfree96/core";
+
+// src/render/stream.ts
+import chalk2 from "chalk";
+
+// src/render/line.ts
+import chalk from "chalk";
+import { toHex } from "@anthonyfree96/core";
+function fmtTime(ts) {
+  const d = new Date(ts);
+  const p = (n, w = 2) => String(n).padStart(w, "0");
+  return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}.${p(d.getMilliseconds(), 3)}`;
+}
+function fmtAscii(buf) {
+  let out = "";
+  for (let i = 0; i < buf.length; i++) {
+    const b = buf[i];
+    if (b === 10) out += "\\n";
+    else if (b === 13) out += "\\r";
+    else if (b === 9) out += "\\t";
+    else if (b >= 32 && b <= 126) out += String.fromCharCode(b);
+    else out += ".";
+  }
+  return out;
+}
+function dir(dir2) {
+  return dir2 === "rx" ? chalk.green("rx") : chalk.yellow("tx");
+}
+function peer(e) {
+  if (e.transport.kind === "tcp-server" || e.transport.kind === "udp-listen") {
+    return chalk.dim(`[${e.transport.id}] `);
+  }
+  return "";
+}
+function formatEventLine(e, opts) {
+  const ts = opts.timestamp ? chalk.gray(fmtTime(e.ts)) + " " : "";
+  const body = opts.mode === "hex" ? chalk.white(toHex(e.data)) + chalk.gray(" | ") + chalk.dim(fmtAscii(e.data)) + chalk.gray(" |") : chalk.white(fmtAscii(e.data));
+  return `${ts}${dir(e.dir)} ${peer(e)}${body}`;
+}
+
+// src/render/stream.ts
+var StreamRenderer = class {
+  constructor(opts, out = process.stdout) {
+    this.out = out;
+    this.opts = opts;
+    if (!opts.color) chalk2.level = 0;
+  }
+  out;
+  opts;
+  onEvent(e) {
+    if (this.opts.mode === "raw") {
+      this.out.write(e.data);
+      return;
+    }
+    this.out.write(formatEventLine(e, this.opts) + "\n");
+  }
+  onClose() {
+  }
+};
+
+// src/render/tui.ts
+import blessed from "neo-blessed";
+import { toHex as toHex2 } from "@anthonyfree96/core";
+var TuiRenderer = class {
+  constructor(opts) {
+    this.opts = opts;
+    this.screen = blessed.screen({ smartCSR: true, title: "comm-scope", fullUnicode: true });
+    blessed.box({
+      parent: this.screen,
+      top: 0,
+      left: 0,
+      width: "100%",
+      height: 1,
+      content: ` comm-scope \u2014 ${opts.desc} (q to quit)`,
+      style: { bg: "blue", fg: "white" }
+    });
+    this.stats = blessed.box({
+      parent: this.screen,
+      top: 1,
+      left: 0,
+      width: "100%",
+      height: 3,
+      content: this.statsText(),
+      border: { type: "line" },
+      style: { fg: "cyan" }
+    });
+    this.log = blessed.log({
+      parent: this.screen,
+      top: 4,
+      left: 0,
+      width: "100%",
+      height: "100%-4",
+      border: { type: "line" },
+      scrollback: 1e4,
+      mouse: true,
+      keys: true,
+      vi: true
+    });
+    this.screen.key(["q", "C-c"], () => {
+      this.screen.destroy();
+      this.opts.onExit();
+    });
+    this.screen.render();
+  }
+  opts;
+  screen;
+  log;
+  stats;
+  rxBytes = 0;
+  txBytes = 0;
+  rxPackets = 0;
+  txPackets = 0;
+  startTs = 0;
+  onEvent(e) {
+    if (this.startTs === 0) this.startTs = e.ts;
+    if (e.dir === "rx") {
+      this.rxBytes += e.data.length;
+      this.rxPackets++;
+    } else {
+      this.txBytes += e.data.length;
+      this.txPackets++;
+    }
+    const peer2 = e.transport.kind === "tcp-server" || e.transport.kind === "udp-listen" ? `[${e.transport.id}] ` : "";
+    this.log.log(
+      `${fmtTime(e.ts)} ${e.dir} ${peer2}${toHex2(e.data)} | ${fmtAscii(e.data)}`
+    );
+    this.stats.setContent(this.statsText());
+    this.screen.render();
+  }
+  /** Append a status/error line to the log. */
+  logLine(msg) {
+    this.log.log(msg);
+    this.screen.render();
+  }
+  onClose() {
+  }
+  statsText() {
+    const durationMs = this.startTs === 0 ? 0 : Date.now() - this.startTs;
+    const secs = durationMs / 1e3 || 1;
+    const rxRate = this.rxBytes / secs;
+    const txRate = this.txBytes / secs;
+    return ` rx ${this.rxPackets} pkts / ${this.rxBytes} B (${rxRate.toFixed(0)} B/s)   tx ${this.txPackets} pkts / ${this.txBytes} B (${txRate.toFixed(0)} B/s)`;
+  }
+};
+
+// src/args.ts
+import { Matcher, hexToBuffer } from "@anthonyfree96/core";
+function buildMatcher(f) {
+  if (f.dir && f.dir !== "rx" && f.dir !== "tx") {
+    throw new Error(`--dir must be "rx" or "tx", got "${f.dir}"`);
+  }
+  if (!f.string && !f.hex && !f.regex && !f.dir) return void 0;
+  return new Matcher({
+    dir: f.dir,
+    hex: f.hex ? hexToBuffer(f.hex) : void 0,
+    string: f.string ? Buffer.from(f.string, "utf8") : void 0,
+    regex: f.regex ? new RegExp(f.regex) : void 0
+  });
+}
+
+// src/recording.ts
+import fs from "fs";
+import { JsonlRecorder, toDesc, SCHEMA_VERSION } from "@anthonyfree96/core";
+function makeRecorder(spec, outFile) {
+  const desc = toDesc(spec);
+  return new JsonlRecorder(fs.createWriteStream(outFile), {
+    version: SCHEMA_VERSION,
+    kind: spec.kind,
+    id: desc,
+    desc,
+    started: Date.now()
+  });
+}
+
+// src/render/stats.ts
+function formatSummary(s) {
+  const totalPackets = s.rxPackets + s.txPackets;
+  const totalBytes = s.rxBytes + s.txBytes;
+  return [
+    `duration: ${s.durationMs} ms`,
+    `rx: ${s.rxPackets} packets, ${s.rxBytes} bytes (${s.rxRate.toFixed(1)} B/s)`,
+    `tx: ${s.txPackets} packets, ${s.txBytes} bytes (${s.txRate.toFixed(1)} B/s)`,
+    `total: ${totalPackets} packets, ${totalBytes} bytes`
+  ].join("\n");
+}
+
+// src/stdio.ts
+function flushStdio() {
+  return new Promise((resolve) => {
+    let pending = 2;
+    const done = () => {
+      if (--pending <= 0) resolve();
+    };
+    process.stdout.write("", done);
+    process.stderr.write("", done);
+  });
+}
+
+// src/commands/monitor.ts
+function registerMonitor(program2) {
+  program2.command("monitor").argument(
+    "<spec>",
+    "transport spec: serial:PORT[:BAUD] | tcp:HOST:PORT | tcp-listen:PORT | udp:HOST:PORT | udp-listen:PORT"
+  ).option("--format <mode>", "hex | ascii | raw", "hex").option("--no-timestamp", "omit timestamps").option("--no-color", "disable ANSI colors").option("--string <s>", "only show events containing this UTF-8 substring").option("--hex <h>", "only show events containing this hex byte sequence").option("--regex <re>", "only show events whose UTF-8 text matches this regex").option("--dir <dir>", "only show rx or tx").option("--record <file>", "also record traffic to file").option("--stats", "print traffic statistics on exit").option("--timeout <s>", "stop after N seconds").option("--tui", "interactive dashboard").action(async (spec, opts) => {
+    let specParsed;
+    try {
+      specParsed = parseSpec(spec);
+    } catch (err) {
+      process.stderr.write(chalk3.red(`error: ${err.message}
+`));
+      process.exit(1);
+    }
+    let filter;
+    try {
+      filter = buildMatcher({
+        string: opts.string,
+        hex: opts.hex,
+        regex: opts.regex,
+        dir: opts.dir
+      });
+    } catch (err) {
+      process.stderr.write(chalk3.red(`error: ${err.message}
+`));
+      process.exit(1);
+    }
+    const transport = createTransport(specParsed);
+    const analyzer = opts.stats ? new Analyzer() : void 0;
+    let tui;
+    let renderer;
+    if (opts.tui) {
+      tui = new TuiRenderer({ desc: toDesc2(specParsed), onExit: () => void shutdown() });
+      renderer = tui;
+    } else {
+      renderer = new StreamRenderer({
+        mode: opts.format,
+        timestamp: Boolean(opts.timestamp),
+        color: Boolean(opts.color)
+      });
+    }
+    const sinks = [renderer];
+    if (opts.record) sinks.push(makeRecorder(specParsed, opts.record));
+    if (analyzer) sinks.push(analyzer);
+    const session = new Session(transport, { filter, sinks });
+    transport.on("open", ({ meta }) => {
+      if (tui) tui.logLine(`monitoring ${meta.desc}`);
+      else process.stderr.write(chalk3.dim(`# monitoring ${meta.desc}
+`));
+    });
+    transport.on("error", ({ error }) => {
+      if (tui) tui.logLine(`error: ${error.message}`);
+      else process.stderr.write(chalk3.red(`error: ${error.message}
+`));
+    });
+    let shuttingDown = false;
+    transport.on("close", () => {
+      if (shuttingDown) return;
+      if (tui) tui.logLine("closed");
+      else process.stderr.write(chalk3.dim("# closed\n"));
+      process.exit(0);
+    });
+    async function shutdown() {
+      if (shuttingDown) return;
+      shuttingDown = true;
+      await session.stop();
+      if (analyzer) {
+        const summary = formatSummary(analyzer.summarize());
+        if (tui) tui.logLine(summary);
+        else process.stderr.write(chalk3.dim(summary + "\n"));
+      }
+      await flushStdio();
+      process.exit(0);
+    }
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    if (opts.timeout) {
+      const secs = Number(opts.timeout);
+      if (!Number.isFinite(secs) || secs <= 0) {
+        process.stderr.write(chalk3.red(`error: invalid --timeout "${opts.timeout}"
+`));
+        process.exit(1);
+      }
+      setTimeout(shutdown, secs * 1e3);
+    }
+    try {
+      await session.run();
+    } catch (err) {
+      process.stderr.write(chalk3.red(`error: ${err.message}
+`));
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/list-serial.ts
+import chalk4 from "chalk";
+import { listSerialPorts } from "@anthonyfree96/core";
+function registerListSerial(program2) {
+  program2.command("list-serial").description("list attached serial ports").action(async () => {
+    try {
+      const ports = await listSerialPorts();
+      if (ports.length === 0) {
+        process.stdout.write("no serial ports found\n");
+        return;
+      }
+      for (const p of ports) {
+        process.stdout.write(`${p.path}${p.manufacturer ? `	${p.manufacturer}` : ""}
+`);
+      }
+    } catch (err) {
+      process.stderr.write(chalk4.red(`error: ${err.message}
+`));
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/record.ts
+import chalk5 from "chalk";
+import { parseSpec as parseSpec2, createTransport as createTransport2, Session as Session2, Analyzer as Analyzer2 } from "@anthonyfree96/core";
+function registerRecord(program2) {
+  program2.command("record").argument("<spec>", "transport spec: serial:PORT[:BAUD] | tcp:HOST:PORT | tcp-listen:PORT | udp:HOST:PORT | udp-listen:PORT").requiredOption("--out <file>", "recording output file").option("--string <s>", "only record events containing this UTF-8 substring").option("--hex <h>", "only record events containing this hex byte sequence").option("--regex <re>", "only record events whose UTF-8 text matches this regex").option("--dir <dir>", "only record rx or tx").option("--stats", "print traffic statistics on exit").action(async (spec, opts) => {
+    let specParsed;
+    try {
+      specParsed = parseSpec2(spec);
+    } catch (err) {
+      process.stderr.write(chalk5.red(`error: ${err.message}
+`));
+      process.exit(1);
+    }
+    let filter;
+    try {
+      filter = buildMatcher({
+        string: opts.string,
+        hex: opts.hex,
+        regex: opts.regex,
+        dir: opts.dir
+      });
+    } catch (err) {
+      process.stderr.write(chalk5.red(`error: ${err.message}
+`));
+      process.exit(1);
+    }
+    const transport = createTransport2(specParsed);
+    const recorder = makeRecorder(specParsed, opts.out);
+    let count = 0;
+    const counter = {
+      onEvent: () => {
+        count++;
+      },
+      onClose: () => {
+      }
+    };
+    const analyzer = opts.stats ? new Analyzer2() : void 0;
+    const sinks = [recorder, counter];
+    if (analyzer) sinks.push(analyzer);
+    const session = new Session2(transport, { filter, sinks });
+    transport.on(
+      "open",
+      ({ meta }) => process.stderr.write(chalk5.dim(`# recording ${meta.desc} -> ${opts.out}
+`))
+    );
+    transport.on(
+      "error",
+      ({ error }) => process.stderr.write(chalk5.red(`error: ${error.message}
+`))
+    );
+    let shuttingDown = false;
+    const shutdown = async () => {
+      if (shuttingDown) return;
+      shuttingDown = true;
+      await session.stop();
+      process.stderr.write(chalk5.dim(`# recorded ${count} events to ${opts.out}
+`));
+      if (analyzer) process.stderr.write(chalk5.dim(formatSummary(analyzer.summarize()) + "\n"));
+      await flushStdio();
+      process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    try {
+      await session.run();
+    } catch (err) {
+      process.stderr.write(chalk5.red(`error: ${err.message}
+`));
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/view.ts
+import chalk6 from "chalk";
+import { FileSource, Session as Session3 } from "@anthonyfree96/core";
+function registerView(program2) {
+  program2.command("view").argument("<file>", "recording file (JSON Lines)").option("--speed <n>", "replay speed multiplier (0 = as fast as possible)", "1").option("--format <mode>", "hex | ascii | raw", "hex").option("--no-timestamp", "omit timestamps").option("--no-color", "disable ANSI colors").option("--dir <dir>", "only show rx or tx").option("--tui", "interactive dashboard").action(async (file, opts) => {
+    const dir2 = opts.dir;
+    if (dir2 && dir2 !== "rx" && dir2 !== "tx") {
+      process.stderr.write(chalk6.red(`error: --dir must be "rx" or "tx", got "${dir2}"
+`));
+      process.exit(1);
+    }
+    const speed = Number(opts.speed);
+    if (Number.isNaN(speed) || speed < 0) {
+      process.stderr.write(chalk6.red(`error: invalid --speed "${opts.speed}"
+`));
+      process.exit(1);
+    }
+    const source = new FileSource(file, { speed, dir: dir2 });
+    let tui;
+    let renderer;
+    if (opts.tui) {
+      tui = new TuiRenderer({ desc: `file: ${file}`, onExit: () => void shutdown() });
+      renderer = tui;
+    } else {
+      renderer = new StreamRenderer({
+        mode: opts.format,
+        timestamp: Boolean(opts.timestamp),
+        color: Boolean(opts.color)
+      });
+    }
+    const session = new Session3(source, { sinks: [renderer] });
+    source.on("open", ({ meta }) => {
+      if (tui) tui.logLine(`replaying ${meta.desc}`);
+      else process.stderr.write(chalk6.dim(`# replaying ${meta.desc}
+`));
+    });
+    source.on("error", ({ error }) => {
+      if (tui) tui.logLine(`error: ${error.message}`);
+      else process.stderr.write(chalk6.red(`error: ${error.message}
+`));
+    });
+    async function shutdown() {
+      await session.stop();
+      await flushStdio();
+      process.exit(0);
+    }
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    try {
+      await session.run();
+    } catch (err) {
+      process.stderr.write(chalk6.red(`error: ${err.message}
+`));
+      process.exit(1);
+    }
+  });
+}
+
+// src/commands/search.ts
+import fs2 from "fs";
+import readline from "readline";
+import chalk7 from "chalk";
+import { decodeHeader, decodeEvent } from "@anthonyfree96/core";
+function registerSearch(program2) {
+  program2.command("search").argument("<file>", "recording file (JSON Lines)").option("--string <s>", "match events containing this UTF-8 substring").option("--hex <h>", "match events containing this hex byte sequence").option("--regex <re>", "match events whose UTF-8 text matches this regex").option("--dir <dir>", "only match rx or tx").option("-C, --context <n>", "context events to show around each match", "2").option("--no-color", "disable ANSI colors").option("--no-timestamp", "omit timestamps").action(async (file, opts) => {
+    const matcher = buildMatcher({
+      string: opts.string,
+      hex: opts.hex,
+      regex: opts.regex,
+      dir: opts.dir
+    });
+    if (!matcher) {
+      process.stderr.write(
+        chalk7.red("error: provide a filter: --string, --hex, --regex or --dir\n")
+      );
+      process.exit(1);
+    }
+    const events = [];
+    const rl = readline.createInterface({
+      input: fs2.createReadStream(file),
+      crlfDelay: Infinity
+    });
+    let headerSeen = false;
+    let lineNo = 0;
+    for await (const line of rl) {
+      lineNo++;
+      if (!headerSeen) {
+        decodeHeader(line);
+        headerSeen = true;
+        continue;
+      }
+      events.push({ line: lineNo, e: decodeEvent(line) });
+    }
+    const matchIdx = /* @__PURE__ */ new Set();
+    events.forEach((item, i) => {
+      if (matcher.matches(item.e)) matchIdx.add(i);
+    });
+    if (matchIdx.size === 0) {
+      process.stdout.write("no matches\n");
+      return;
+    }
+    const ctx = Math.max(0, Number(opts.context) || 0);
+    const color = Boolean(opts.color);
+    chalk7.level = color ? 1 : 0;
+    const lineOpts = {
+      mode: "hex",
+      timestamp: Boolean(opts.timestamp),
+      color
+    };
+    const inWindow = new Array(events.length).fill(false);
+    for (const m of matchIdx) {
+      const from = Math.max(0, m - ctx);
+      const to = Math.min(events.length - 1, m + ctx);
+      for (let i = from; i <= to; i++) inWindow[i] = true;
+    }
+    process.stderr.write(chalk7.dim(`# ${matchIdx.size} matches
+`));
+    let prev = -1;
+    for (let i = 0; i < events.length; i++) {
+      if (!inWindow[i]) continue;
+      if (prev !== -1 && i > prev + 1) process.stdout.write(chalk7.dim("--\n"));
+      const item = events[i];
+      const isMatch = matchIdx.has(i);
+      const marker = isMatch ? chalk7.cyan("* ") : "  ";
+      const lineNum = chalk7.gray(String(item.line).padStart(5)) + " ";
+      process.stdout.write(marker + lineNum + formatEventLine(item.e, lineOpts) + "\n");
+      prev = i;
+    }
+  });
+}
+
+// src/commands/replay.ts
+import chalk8 from "chalk";
+import { parseSpec as parseSpec3, createTransport as createTransport3, replayFileToTransport } from "@anthonyfree96/core";
+function registerReplay(program2) {
+  program2.command("replay").argument("<file>", "recording file (JSON Lines)").requiredOption("--to <spec>", "target transport spec to send to").option("--speed <n>", "replay speed multiplier (0 = as fast as possible)", "1").option("--loop", "re-send continuously until interrupted").option("--dir <dir>", "only replay rx or tx (default: all, chronological)").action(async (file, opts) => {
+    const dir2 = opts.dir;
+    if (dir2 && dir2 !== "rx" && dir2 !== "tx") {
+      process.stderr.write(chalk8.red(`error: --dir must be "rx" or "tx", got "${dir2}"
+`));
+      process.exit(1);
+    }
+    const speed = Number(opts.speed);
+    if (Number.isNaN(speed) || speed < 0) {
+      process.stderr.write(chalk8.red(`error: invalid --speed "${opts.speed}"
+`));
+      process.exit(1);
+    }
+    let specParsed;
+    try {
+      specParsed = parseSpec3(opts.to);
+    } catch (err) {
+      process.stderr.write(chalk8.red(`error: ${err.message}
+`));
+      process.exit(1);
+    }
+    const target = createTransport3(specParsed);
+    target.on(
+      "open",
+      ({ meta }) => process.stderr.write(chalk8.dim(`# replaying ${file} -> ${meta.desc}
+`))
+    );
+    target.on(
+      "error",
+      ({ error }) => process.stderr.write(chalk8.red(`error: ${error.message}
+`))
+    );
+    let stopping = false;
+    const stop = async () => {
+      if (stopping) return;
+      stopping = true;
+      await target.stop();
+      await flushStdio();
+      process.exit(0);
+    };
+    process.on("SIGINT", stop);
+    process.on("SIGTERM", stop);
+    try {
+      await target.start();
+      const sent = await replayFileToTransport(file, target, {
+        speed,
+        loop: Boolean(opts.loop),
+        dir: dir2
+      });
+      process.stderr.write(chalk8.dim(`# replayed ${sent} events
+`));
+      await stop();
+    } catch (err) {
+      process.stderr.write(chalk8.red(`error: ${err.message}
+`));
+      await flushStdio();
+      process.exit(1);
+    }
+  });
+}
+
+// src/index.ts
+var program = new Command();
+program.name("comm-scope").description("Serial / TCP / UDP traffic monitor for developers").version("0.1.0");
+registerMonitor(program);
+registerRecord(program);
+registerView(program);
+registerSearch(program);
+registerReplay(program);
+registerListSerial(program);
+await program.parseAsync(process.argv);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/commands/monitor.ts","../src/render/stream.ts","../src/render/line.ts","../src/render/tui.ts","../src/args.ts","../src/recording.ts","../src/render/stats.ts","../src/stdio.ts","../src/commands/list-serial.ts","../src/commands/record.ts","../src/commands/view.ts","../src/commands/search.ts","../src/commands/replay.ts"],"sourcesContent":["import { Command } from 'commander';\nimport { registerMonitor } from './commands/monitor.js';\nimport { registerListSerial } from './commands/list-serial.js';\nimport { registerRecord } from './commands/record.js';\nimport { registerView } from './commands/view.js';\nimport { registerSearch } from './commands/search.js';\nimport { registerReplay } from './commands/replay.js';\n\nconst program = new Command();\n\nprogram\n  .name('comm-scope')\n  .description('Serial / TCP / UDP traffic monitor for developers')\n  .version('0.1.0');\n\nregisterMonitor(program);\nregisterRecord(program);\nregisterView(program);\nregisterSearch(program);\nregisterReplay(program);\nregisterListSerial(program);\n\nawait program.parseAsync(process.argv);\n","import chalk from 'chalk';\nimport type { Command } from 'commander';\nimport { parseSpec, createTransport, Session, Analyzer, toDesc } from '@anthonyfree96/core';\nimport type { Direction, Sink } from '@anthonyfree96/core';\nimport { StreamRenderer } from '../render/stream.js';\nimport { TuiRenderer } from '../render/tui.js';\nimport { buildMatcher } from '../args.js';\nimport { makeRecorder } from '../recording.js';\nimport { formatSummary } from '../render/stats.js';\nimport { flushStdio } from '../stdio.js';\n\nexport function registerMonitor(program: Command): void {\n  program\n    .command('monitor')\n    .argument(\n      '<spec>',\n      'transport spec: serial:PORT[:BAUD] | tcp:HOST:PORT | tcp-listen:PORT | udp:HOST:PORT | udp-listen:PORT',\n    )\n    .option('--format <mode>', 'hex | ascii | raw', 'hex')\n    .option('--no-timestamp', 'omit timestamps')\n    .option('--no-color', 'disable ANSI colors')\n    .option('--string <s>', 'only show events containing this UTF-8 substring')\n    .option('--hex <h>', 'only show events containing this hex byte sequence')\n    .option('--regex <re>', 'only show events whose UTF-8 text matches this regex')\n    .option('--dir <dir>', 'only show rx or tx')\n    .option('--record <file>', 'also record traffic to file')\n    .option('--stats', 'print traffic statistics on exit')\n    .option('--timeout <s>', 'stop after N seconds')\n    .option('--tui', 'interactive dashboard')\n    .action(async (spec: string, opts: Record<string, unknown>) => {\n      let specParsed;\n      try {\n        specParsed = parseSpec(spec);\n      } catch (err) {\n        process.stderr.write(chalk.red(`error: ${(err as Error).message}\\n`));\n        process.exit(1);\n      }\n\n      let filter;\n      try {\n        filter = buildMatcher({\n          string: opts.string as string | undefined,\n          hex: opts.hex as string | undefined,\n          regex: opts.regex as string | undefined,\n          dir: opts.dir as Direction | undefined,\n        });\n      } catch (err) {\n        process.stderr.write(chalk.red(`error: ${(err as Error).message}\\n`));\n        process.exit(1);\n      }\n\n      const transport = createTransport(specParsed);\n      const analyzer = opts.stats ? new Analyzer() : undefined;\n\n      let tui: TuiRenderer | undefined;\n      let renderer: Sink;\n      if (opts.tui) {\n        tui = new TuiRenderer({ desc: toDesc(specParsed), onExit: () => void shutdown() });\n        renderer = tui;\n      } else {\n        renderer = new StreamRenderer({\n          mode: opts.format as 'hex' | 'ascii' | 'raw',\n          timestamp: Boolean(opts.timestamp),\n          color: Boolean(opts.color),\n        });\n      }\n\n      const sinks: Sink[] = [renderer];\n      if (opts.record) sinks.push(makeRecorder(specParsed, opts.record as string));\n      if (analyzer) sinks.push(analyzer);\n      const session = new Session(transport, { filter, sinks });\n\n      transport.on('open', ({ meta }) => {\n        if (tui) tui.logLine(`monitoring ${meta.desc}`);\n        else process.stderr.write(chalk.dim(`# monitoring ${meta.desc}\\n`));\n      });\n      transport.on('error', ({ error }) => {\n        if (tui) tui.logLine(`error: ${error.message}`);\n        else process.stderr.write(chalk.red(`error: ${error.message}\\n`));\n      });\n\n      let shuttingDown = false;\n      transport.on('close', () => {\n        if (shuttingDown) return;\n        if (tui) tui.logLine('closed');\n        else process.stderr.write(chalk.dim('# closed\\n'));\n        process.exit(0);\n      });\n\n      async function shutdown(): Promise<void> {\n        if (shuttingDown) return;\n        shuttingDown = true;\n        await session.stop();\n        if (analyzer) {\n          const summary = formatSummary(analyzer.summarize());\n          if (tui) tui.logLine(summary);\n          else process.stderr.write(chalk.dim(summary + '\\n'));\n        }\n        await flushStdio();\n        process.exit(0);\n      }\n      process.on('SIGINT', shutdown);\n      process.on('SIGTERM', shutdown);\n\n      if (opts.timeout) {\n        const secs = Number(opts.timeout);\n        if (!Number.isFinite(secs) || secs <= 0) {\n          process.stderr.write(chalk.red(`error: invalid --timeout \"${opts.timeout}\"\\n`));\n          process.exit(1);\n        }\n        setTimeout(shutdown, secs * 1000);\n      }\n\n      try {\n        await session.run();\n      } catch (err) {\n        process.stderr.write(chalk.red(`error: ${(err as Error).message}\\n`));\n        process.exit(1);\n      }\n    });\n}\n","import chalk from 'chalk';\nimport type { Sink, TrafficEvent } from '@anthonyfree96/core';\nimport { formatEventLine } from './line.js';\nimport type { LineOptions, StreamMode } from './line.js';\n\nexport type { StreamMode } from './line.js';\n\nexport interface StreamOptions {\n  mode: StreamMode;\n  timestamp: boolean;\n  color: boolean;\n}\n\n/**\n * Streaming, line-oriented renderer. Writes one line per event to `out`\n * (stdout), leaving stderr free for banners/status so output stays pipeable.\n */\nexport class StreamRenderer implements Sink {\n  private readonly opts: LineOptions;\n\n  constructor(\n    opts: StreamOptions,\n    private readonly out: NodeJS.WriteStream = process.stdout,\n  ) {\n    this.opts = opts;\n    if (!opts.color) chalk.level = 0;\n  }\n\n  onEvent(e: TrafficEvent): void {\n    if (this.opts.mode === 'raw') {\n      this.out.write(e.data);\n      return;\n    }\n    this.out.write(formatEventLine(e, this.opts) + '\\n');\n  }\n\n  onClose(): void {}\n}\n","import chalk from 'chalk';\nimport { toHex } from '@anthonyfree96/core';\nimport type { TrafficEvent } from '@anthonyfree96/core';\n\nexport type StreamMode = 'hex' | 'ascii' | 'raw';\n\nexport interface LineOptions {\n  mode: StreamMode;\n  timestamp: boolean;\n  color: boolean;\n}\n\nexport function fmtTime(ts: number): string {\n  const d = new Date(ts);\n  const p = (n: number, w = 2) => String(n).padStart(w, '0');\n  return `${p(d.getHours())}:${p(d.getMinutes())}:${p(d.getSeconds())}.${p(d.getMilliseconds(), 3)}`;\n}\n\nexport function fmtAscii(buf: Buffer): string {\n  let out = '';\n  for (let i = 0; i < buf.length; i++) {\n    const b = buf[i]!;\n    if (b === 0x0a) out += '\\\\n';\n    else if (b === 0x0d) out += '\\\\r';\n    else if (b === 0x09) out += '\\\\t';\n    else if (b >= 0x20 && b <= 0x7e) out += String.fromCharCode(b);\n    else out += '.';\n  }\n  return out;\n}\n\nfunction dir(dir: 'rx' | 'tx'): string {\n  return dir === 'rx' ? chalk.green('rx') : chalk.yellow('tx');\n}\n\nfunction peer(e: TrafficEvent): string {\n  if (e.transport.kind === 'tcp-server' || e.transport.kind === 'udp-listen') {\n    return chalk.dim(`[${e.transport.id}] `);\n  }\n  return '';\n}\n\n/** Render a single event as one line (hex or ascii). */\nexport function formatEventLine(e: TrafficEvent, opts: LineOptions): string {\n  const ts = opts.timestamp ? chalk.gray(fmtTime(e.ts)) + ' ' : '';\n  const body =\n    opts.mode === 'hex'\n      ? chalk.white(toHex(e.data)) + chalk.gray(' | ') + chalk.dim(fmtAscii(e.data)) + chalk.gray(' |')\n      : chalk.white(fmtAscii(e.data));\n  return `${ts}${dir(e.dir)} ${peer(e)}${body}`;\n}\n","import blessed from 'neo-blessed';\nimport type { BlessedScreen, BlessedWidget } from 'neo-blessed';\nimport { toHex } from '@anthonyfree96/core';\nimport type { Sink, TrafficEvent } from '@anthonyfree96/core';\nimport { fmtTime, fmtAscii } from './line.js';\n\nexport interface TuiOptions {\n  desc: string;\n  onExit: () => void;\n}\n\n/**\n * Interactive full-screen dashboard built on neo-blessed: a scrolling traffic\n * log plus a live stats strip. Press `q` or `Ctrl-C` to quit (handled here,\n * since blessed takes over the terminal).\n */\nexport class TuiRenderer implements Sink {\n  private readonly screen: BlessedScreen;\n  private readonly log: BlessedWidget;\n  private readonly stats: BlessedWidget;\n\n  private rxBytes = 0;\n  private txBytes = 0;\n  private rxPackets = 0;\n  private txPackets = 0;\n  private startTs = 0;\n\n  constructor(private readonly opts: TuiOptions) {\n    this.screen = blessed.screen({ smartCSR: true, title: 'comm-scope', fullUnicode: true });\n\n    blessed.box({\n      parent: this.screen,\n      top: 0,\n      left: 0,\n      width: '100%',\n      height: 1,\n      content: ` comm-scope — ${opts.desc} (q to quit)`,\n      style: { bg: 'blue', fg: 'white' },\n    });\n\n    this.stats = blessed.box({\n      parent: this.screen,\n      top: 1,\n      left: 0,\n      width: '100%',\n      height: 3,\n      content: this.statsText(),\n      border: { type: 'line' },\n      style: { fg: 'cyan' },\n    });\n\n    this.log = blessed.log({\n      parent: this.screen,\n      top: 4,\n      left: 0,\n      width: '100%',\n      height: '100%-4',\n      border: { type: 'line' },\n      scrollback: 10000,\n      mouse: true,\n      keys: true,\n      vi: true,\n    });\n\n    this.screen.key(['q', 'C-c'], () => {\n      this.screen.destroy();\n      this.opts.onExit();\n    });\n\n    this.screen.render();\n  }\n\n  onEvent(e: TrafficEvent): void {\n    if (this.startTs === 0) this.startTs = e.ts;\n    if (e.dir === 'rx') {\n      this.rxBytes += e.data.length;\n      this.rxPackets++;\n    } else {\n      this.txBytes += e.data.length;\n      this.txPackets++;\n    }\n    const peer =\n      e.transport.kind === 'tcp-server' || e.transport.kind === 'udp-listen'\n        ? `[${e.transport.id}] `\n        : '';\n    this.log.log(\n      `${fmtTime(e.ts)} ${e.dir} ${peer}${toHex(e.data)} | ${fmtAscii(e.data)}`,\n    );\n    this.stats.setContent(this.statsText());\n    this.screen.render();\n  }\n\n  /** Append a status/error line to the log. */\n  logLine(msg: string): void {\n    this.log.log(msg);\n    this.screen.render();\n  }\n\n  onClose(): void {}\n\n  private statsText(): string {\n    const durationMs = this.startTs === 0 ? 0 : Date.now() - this.startTs;\n    const secs = durationMs / 1000 || 1;\n    const rxRate = this.rxBytes / secs;\n    const txRate = this.txBytes / secs;\n    return (\n      ` rx ${this.rxPackets} pkts / ${this.rxBytes} B (${rxRate.toFixed(0)} B/s)   ` +\n      `tx ${this.txPackets} pkts / ${this.txBytes} B (${txRate.toFixed(0)} B/s)`\n    );\n  }\n}\n","import { Matcher, hexToBuffer } from '@anthonyfree96/core';\nimport type { Direction } from '@anthonyfree96/core';\n\n/** Filter flags shared by `monitor` and `search`. */\nexport interface FilterFlags {\n  string?: string;\n  hex?: string;\n  regex?: string;\n  dir?: Direction;\n}\n\n/** Build a {@link Matcher} from parsed flags, or undefined if no filter given. */\nexport function buildMatcher(f: FilterFlags): Matcher | undefined {\n  if (f.dir && f.dir !== 'rx' && f.dir !== 'tx') {\n    throw new Error(`--dir must be \"rx\" or \"tx\", got \"${f.dir}\"`);\n  }\n  if (!f.string && !f.hex && !f.regex && !f.dir) return undefined;\n  return new Matcher({\n    dir: f.dir,\n    hex: f.hex ? hexToBuffer(f.hex) : undefined,\n    string: f.string ? Buffer.from(f.string, 'utf8') : undefined,\n    regex: f.regex ? new RegExp(f.regex) : undefined,\n  });\n}\n","import fs from 'node:fs';\nimport { JsonlRecorder, toDesc, SCHEMA_VERSION } from '@anthonyfree96/core';\nimport type { TransportSpec } from '@anthonyfree96/core';\n\n/** Build a recorder wired to `outFile`, with a header derived from the spec. */\nexport function makeRecorder(spec: TransportSpec, outFile: string): JsonlRecorder {\n  const desc = toDesc(spec);\n  return new JsonlRecorder(fs.createWriteStream(outFile), {\n    version: SCHEMA_VERSION,\n    kind: spec.kind,\n    id: desc,\n    desc,\n    started: Date.now(),\n  });\n}\n","import type { TrafficSummary } from '@anthonyfree96/core';\n\n/** Plain-text summary of a captured session. */\nexport function formatSummary(s: TrafficSummary): string {\n  const totalPackets = s.rxPackets + s.txPackets;\n  const totalBytes = s.rxBytes + s.txBytes;\n  return [\n    `duration: ${s.durationMs} ms`,\n    `rx: ${s.rxPackets} packets, ${s.rxBytes} bytes (${s.rxRate.toFixed(1)} B/s)`,\n    `tx: ${s.txPackets} packets, ${s.txBytes} bytes (${s.txRate.toFixed(1)} B/s)`,\n    `total: ${totalPackets} packets, ${totalBytes} bytes`,\n  ].join('\\n');\n}\n","/**\n * Flush pending stdout/stderr writes. Needed before `process.exit()` because\n * exit does not flush piped streams, so a summary written just before exit\n * would otherwise be lost.\n */\nexport function flushStdio(): Promise<void> {\n  return new Promise((resolve) => {\n    let pending = 2;\n    const done = () => {\n      if (--pending <= 0) resolve();\n    };\n    process.stdout.write('', done);\n    process.stderr.write('', done);\n  });\n}\n","import chalk from 'chalk';\nimport type { Command } from 'commander';\nimport { listSerialPorts } from '@anthonyfree96/core';\n\nexport function registerListSerial(program: Command): void {\n  program\n    .command('list-serial')\n    .description('list attached serial ports')\n    .action(async () => {\n      try {\n        const ports = await listSerialPorts();\n        if (ports.length === 0) {\n          process.stdout.write('no serial ports found\\n');\n          return;\n        }\n        for (const p of ports) {\n          process.stdout.write(`${p.path}${p.manufacturer ? `\\t${p.manufacturer}` : ''}\\n`);\n        }\n      } catch (err) {\n        process.stderr.write(chalk.red(`error: ${(err as Error).message}\\n`));\n        process.exit(1);\n      }\n    });\n}\n","import chalk from 'chalk';\nimport type { Command } from 'commander';\nimport { parseSpec, createTransport, Session, Analyzer } from '@anthonyfree96/core';\nimport type { Direction, Sink } from '@anthonyfree96/core';\nimport { buildMatcher } from '../args.js';\nimport { makeRecorder } from '../recording.js';\nimport { formatSummary } from '../render/stats.js';\nimport { flushStdio } from '../stdio.js';\n\nexport function registerRecord(program: Command): void {\n  program\n    .command('record')\n    .argument('<spec>', 'transport spec: serial:PORT[:BAUD] | tcp:HOST:PORT | tcp-listen:PORT | udp:HOST:PORT | udp-listen:PORT')\n    .requiredOption('--out <file>', 'recording output file')\n    .option('--string <s>', 'only record events containing this UTF-8 substring')\n    .option('--hex <h>', 'only record events containing this hex byte sequence')\n    .option('--regex <re>', 'only record events whose UTF-8 text matches this regex')\n    .option('--dir <dir>', 'only record rx or tx')\n    .option('--stats', 'print traffic statistics on exit')\n    .action(async (spec: string, opts: Record<string, unknown>) => {\n      let specParsed;\n      try {\n        specParsed = parseSpec(spec);\n      } catch (err) {\n        process.stderr.write(chalk.red(`error: ${(err as Error).message}\\n`));\n        process.exit(1);\n      }\n\n      let filter;\n      try {\n        filter = buildMatcher({\n          string: opts.string as string | undefined,\n          hex: opts.hex as string | undefined,\n          regex: opts.regex as string | undefined,\n          dir: opts.dir as Direction | undefined,\n        });\n      } catch (err) {\n        process.stderr.write(chalk.red(`error: ${(err as Error).message}\\n`));\n        process.exit(1);\n      }\n\n      const transport = createTransport(specParsed);\n      const recorder = makeRecorder(specParsed, opts.out as string);\n\n      let count = 0;\n      const counter: Sink = {\n        onEvent: () => {\n          count++;\n        },\n        onClose: () => {},\n      };\n\n      const analyzer = opts.stats ? new Analyzer() : undefined;\n      const sinks: Sink[] = [recorder, counter];\n      if (analyzer) sinks.push(analyzer);\n      const session = new Session(transport, { filter, sinks });\n\n      transport.on('open', ({ meta }) =>\n        process.stderr.write(chalk.dim(`# recording ${meta.desc} -> ${opts.out}\\n`)),\n      );\n      transport.on('error', ({ error }) =>\n        process.stderr.write(chalk.red(`error: ${error.message}\\n`)),\n      );\n\n      let shuttingDown = false;\n      const shutdown = async () => {\n        if (shuttingDown) return;\n        shuttingDown = true;\n        await session.stop();\n        process.stderr.write(chalk.dim(`# recorded ${count} events to ${opts.out}\\n`));\n        if (analyzer) process.stderr.write(chalk.dim(formatSummary(analyzer.summarize()) + '\\n'));\n        await flushStdio();\n        process.exit(0);\n      };\n      process.on('SIGINT', shutdown);\n      process.on('SIGTERM', shutdown);\n\n      try {\n        await session.run();\n      } catch (err) {\n        process.stderr.write(chalk.red(`error: ${(err as Error).message}\\n`));\n        process.exit(1);\n      }\n    });\n}\n","import chalk from 'chalk';\nimport type { Command } from 'commander';\nimport { FileSource, Session } from '@anthonyfree96/core';\nimport type { Direction, Sink } from '@anthonyfree96/core';\nimport { StreamRenderer } from '../render/stream.js';\nimport { TuiRenderer } from '../render/tui.js';\nimport { flushStdio } from '../stdio.js';\n\nexport function registerView(program: Command): void {\n  program\n    .command('view')\n    .argument('<file>', 'recording file (JSON Lines)')\n    .option('--speed <n>', 'replay speed multiplier (0 = as fast as possible)', '1')\n    .option('--format <mode>', 'hex | ascii | raw', 'hex')\n    .option('--no-timestamp', 'omit timestamps')\n    .option('--no-color', 'disable ANSI colors')\n    .option('--dir <dir>', 'only show rx or tx')\n    .option('--tui', 'interactive dashboard')\n    .action(async (file: string, opts: Record<string, unknown>) => {\n      const dir = opts.dir as Direction | undefined;\n      if (dir && dir !== 'rx' && dir !== 'tx') {\n        process.stderr.write(chalk.red(`error: --dir must be \"rx\" or \"tx\", got \"${dir}\"\\n`));\n        process.exit(1);\n      }\n      const speed = Number(opts.speed);\n      if (Number.isNaN(speed) || speed < 0) {\n        process.stderr.write(chalk.red(`error: invalid --speed \"${opts.speed}\"\\n`));\n        process.exit(1);\n      }\n\n      const source = new FileSource(file, { speed, dir });\n\n      let tui: TuiRenderer | undefined;\n      let renderer: Sink;\n      if (opts.tui) {\n        tui = new TuiRenderer({ desc: `file: ${file}`, onExit: () => void shutdown() });\n        renderer = tui;\n      } else {\n        renderer = new StreamRenderer({\n          mode: opts.format as 'hex' | 'ascii' | 'raw',\n          timestamp: Boolean(opts.timestamp),\n          color: Boolean(opts.color),\n        });\n      }\n\n      const session = new Session(source, { sinks: [renderer] });\n\n      source.on('open', ({ meta }) => {\n        if (tui) tui.logLine(`replaying ${meta.desc}`);\n        else process.stderr.write(chalk.dim(`# replaying ${meta.desc}\\n`));\n      });\n      source.on('error', ({ error }) => {\n        if (tui) tui.logLine(`error: ${error.message}`);\n        else process.stderr.write(chalk.red(`error: ${error.message}\\n`));\n      });\n\n      async function shutdown(): Promise<void> {\n        await session.stop();\n        await flushStdio();\n        process.exit(0);\n      }\n      process.on('SIGINT', shutdown);\n      process.on('SIGTERM', shutdown);\n\n      try {\n        await session.run();\n      } catch (err) {\n        process.stderr.write(chalk.red(`error: ${(err as Error).message}\\n`));\n        process.exit(1);\n      }\n    });\n}\n","import fs from 'node:fs';\nimport readline from 'node:readline';\nimport chalk from 'chalk';\nimport type { Command } from 'commander';\nimport { decodeHeader, decodeEvent } from '@anthonyfree96/core';\nimport type { Direction, TrafficEvent } from '@anthonyfree96/core';\nimport { buildMatcher } from '../args.js';\nimport { formatEventLine } from '../render/line.js';\nimport type { LineOptions } from '../render/line.js';\n\ninterface IndexedEvent {\n  line: number;\n  e: TrafficEvent;\n}\n\nexport function registerSearch(program: Command): void {\n  program\n    .command('search')\n    .argument('<file>', 'recording file (JSON Lines)')\n    .option('--string <s>', 'match events containing this UTF-8 substring')\n    .option('--hex <h>', 'match events containing this hex byte sequence')\n    .option('--regex <re>', 'match events whose UTF-8 text matches this regex')\n    .option('--dir <dir>', 'only match rx or tx')\n    .option('-C, --context <n>', 'context events to show around each match', '2')\n    .option('--no-color', 'disable ANSI colors')\n    .option('--no-timestamp', 'omit timestamps')\n    .action(async (file: string, opts: Record<string, unknown>) => {\n      const matcher = buildMatcher({\n        string: opts.string as string | undefined,\n        hex: opts.hex as string | undefined,\n        regex: opts.regex as string | undefined,\n        dir: opts.dir as Direction | undefined,\n      });\n      if (!matcher) {\n        process.stderr.write(\n          chalk.red('error: provide a filter: --string, --hex, --regex or --dir\\n'),\n        );\n        process.exit(1);\n      }\n\n      const events: IndexedEvent[] = [];\n      const rl = readline.createInterface({\n        input: fs.createReadStream(file),\n        crlfDelay: Infinity,\n      });\n      let headerSeen = false;\n      let lineNo = 0;\n      for await (const line of rl) {\n        lineNo++;\n        if (!headerSeen) {\n          decodeHeader(line);\n          headerSeen = true;\n          continue;\n        }\n        events.push({ line: lineNo, e: decodeEvent(line) });\n      }\n\n      const matchIdx = new Set<number>();\n      events.forEach((item, i) => {\n        if (matcher.matches(item.e)) matchIdx.add(i);\n      });\n      if (matchIdx.size === 0) {\n        process.stdout.write('no matches\\n');\n        return;\n      }\n\n      const ctx = Math.max(0, Number(opts.context) || 0);\n      const color = Boolean(opts.color);\n      chalk.level = color ? 1 : 0;\n      const lineOpts: LineOptions = {\n        mode: 'hex',\n        timestamp: Boolean(opts.timestamp),\n        color,\n      };\n\n      const inWindow = new Array<boolean>(events.length).fill(false);\n      for (const m of matchIdx) {\n        const from = Math.max(0, m - ctx);\n        const to = Math.min(events.length - 1, m + ctx);\n        for (let i = from; i <= to; i++) inWindow[i] = true;\n      }\n\n      process.stderr.write(chalk.dim(`# ${matchIdx.size} matches\\n`));\n\n      let prev = -1;\n      for (let i = 0; i < events.length; i++) {\n        if (!inWindow[i]) continue;\n        if (prev !== -1 && i > prev + 1) process.stdout.write(chalk.dim('--\\n'));\n        const item = events[i]!;\n        const isMatch = matchIdx.has(i);\n        const marker = isMatch ? chalk.cyan('* ') : '  ';\n        const lineNum = chalk.gray(String(item.line).padStart(5)) + ' ';\n        process.stdout.write(marker + lineNum + formatEventLine(item.e, lineOpts) + '\\n');\n        prev = i;\n      }\n    });\n}\n","import chalk from 'chalk';\nimport type { Command } from 'commander';\nimport { parseSpec, createTransport, replayFileToTransport } from '@anthonyfree96/core';\nimport type { Direction } from '@anthonyfree96/core';\nimport { flushStdio } from '../stdio.js';\n\nexport function registerReplay(program: Command): void {\n  program\n    .command('replay')\n    .argument('<file>', 'recording file (JSON Lines)')\n    .requiredOption('--to <spec>', 'target transport spec to send to')\n    .option('--speed <n>', 'replay speed multiplier (0 = as fast as possible)', '1')\n    .option('--loop', 're-send continuously until interrupted')\n    .option('--dir <dir>', 'only replay rx or tx (default: all, chronological)')\n    .action(async (file: string, opts: Record<string, unknown>) => {\n      const dir = opts.dir as Direction | undefined;\n      if (dir && dir !== 'rx' && dir !== 'tx') {\n        process.stderr.write(chalk.red(`error: --dir must be \"rx\" or \"tx\", got \"${dir}\"\\n`));\n        process.exit(1);\n      }\n      const speed = Number(opts.speed);\n      if (Number.isNaN(speed) || speed < 0) {\n        process.stderr.write(chalk.red(`error: invalid --speed \"${opts.speed}\"\\n`));\n        process.exit(1);\n      }\n\n      let specParsed;\n      try {\n        specParsed = parseSpec(opts.to as string);\n      } catch (err) {\n        process.stderr.write(chalk.red(`error: ${(err as Error).message}\\n`));\n        process.exit(1);\n      }\n\n      const target = createTransport(specParsed);\n      target.on('open', ({ meta }) =>\n        process.stderr.write(chalk.dim(`# replaying ${file} -> ${meta.desc}\\n`)),\n      );\n      target.on('error', ({ error }) =>\n        process.stderr.write(chalk.red(`error: ${error.message}\\n`)),\n      );\n\n      let stopping = false;\n      const stop = async () => {\n        if (stopping) return;\n        stopping = true;\n        await target.stop();\n        await flushStdio();\n        process.exit(0);\n      };\n      process.on('SIGINT', stop);\n      process.on('SIGTERM', stop);\n\n      try {\n        await target.start();\n        const sent = await replayFileToTransport(file, target, {\n          speed,\n          loop: Boolean(opts.loop),\n          dir,\n        });\n        process.stderr.write(chalk.dim(`# replayed ${sent} events\\n`));\n        await stop();\n      } catch (err) {\n        process.stderr.write(chalk.red(`error: ${(err as Error).message}\\n`));\n        await flushStdio();\n        process.exit(1);\n      }\n    });\n}\n"],"mappings":";;;AAAA,SAAS,eAAe;;;ACAxB,OAAOA,YAAW;AAElB,SAAS,WAAW,iBAAiB,SAAS,UAAU,UAAAC,eAAc;;;ACFtE,OAAOC,YAAW;;;ACAlB,OAAO,WAAW;AAClB,SAAS,aAAa;AAWf,SAAS,QAAQ,IAAoB;AAC1C,QAAM,IAAI,IAAI,KAAK,EAAE;AACrB,QAAM,IAAI,CAAC,GAAW,IAAI,MAAM,OAAO,CAAC,EAAE,SAAS,GAAG,GAAG;AACzD,SAAO,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,gBAAgB,GAAG,CAAC,CAAC;AAClG;AAEO,SAAS,SAAS,KAAqB;AAC5C,MAAI,MAAM;AACV,WAAS,IAAI,GAAG,IAAI,IAAI,QAAQ,KAAK;AACnC,UAAM,IAAI,IAAI,CAAC;AACf,QAAI,MAAM,GAAM,QAAO;AAAA,aACd,MAAM,GAAM,QAAO;AAAA,aACnB,MAAM,EAAM,QAAO;AAAA,aACnB,KAAK,MAAQ,KAAK,IAAM,QAAO,OAAO,aAAa,CAAC;AAAA,QACxD,QAAO;AAAA,EACd;AACA,SAAO;AACT;AAEA,SAAS,IAAIC,MAA0B;AACrC,SAAOA,SAAQ,OAAO,MAAM,MAAM,IAAI,IAAI,MAAM,OAAO,IAAI;AAC7D;AAEA,SAAS,KAAK,GAAyB;AACrC,MAAI,EAAE,UAAU,SAAS,gBAAgB,EAAE,UAAU,SAAS,cAAc;AAC1E,WAAO,MAAM,IAAI,IAAI,EAAE,UAAU,EAAE,IAAI;AAAA,EACzC;AACA,SAAO;AACT;AAGO,SAAS,gBAAgB,GAAiB,MAA2B;AAC1E,QAAM,KAAK,KAAK,YAAY,MAAM,KAAK,QAAQ,EAAE,EAAE,CAAC,IAAI,MAAM;AAC9D,QAAM,OACJ,KAAK,SAAS,QACV,MAAM,MAAM,MAAM,EAAE,IAAI,CAAC,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,IAAI,SAAS,EAAE,IAAI,CAAC,IAAI,MAAM,KAAK,IAAI,IAC9F,MAAM,MAAM,SAAS,EAAE,IAAI,CAAC;AAClC,SAAO,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,IAAI;AAC7C;;;ADjCO,IAAM,iBAAN,MAAqC;AAAA,EAG1C,YACE,MACiB,MAA0B,QAAQ,QACnD;AADiB;AAEjB,SAAK,OAAO;AACZ,QAAI,CAAC,KAAK,MAAO,CAAAC,OAAM,QAAQ;AAAA,EACjC;AAAA,EAJmB;AAAA,EAJF;AAAA,EAUjB,QAAQ,GAAuB;AAC7B,QAAI,KAAK,KAAK,SAAS,OAAO;AAC5B,WAAK,IAAI,MAAM,EAAE,IAAI;AACrB;AAAA,IACF;AACA,SAAK,IAAI,MAAM,gBAAgB,GAAG,KAAK,IAAI,IAAI,IAAI;AAAA,EACrD;AAAA,EAEA,UAAgB;AAAA,EAAC;AACnB;;;AErCA,OAAO,aAAa;AAEpB,SAAS,SAAAC,cAAa;AAcf,IAAM,cAAN,MAAkC;AAAA,EAWvC,YAA6B,MAAkB;AAAlB;AAC3B,SAAK,SAAS,QAAQ,OAAO,EAAE,UAAU,MAAM,OAAO,cAAc,aAAa,KAAK,CAAC;AAEvF,YAAQ,IAAI;AAAA,MACV,QAAQ,KAAK;AAAA,MACb,KAAK;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,SAAS,sBAAiB,KAAK,IAAI;AAAA,MACnC,OAAO,EAAE,IAAI,QAAQ,IAAI,QAAQ;AAAA,IACnC,CAAC;AAED,SAAK,QAAQ,QAAQ,IAAI;AAAA,MACvB,QAAQ,KAAK;AAAA,MACb,KAAK;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,SAAS,KAAK,UAAU;AAAA,MACxB,QAAQ,EAAE,MAAM,OAAO;AAAA,MACvB,OAAO,EAAE,IAAI,OAAO;AAAA,IACtB,CAAC;AAED,SAAK,MAAM,QAAQ,IAAI;AAAA,MACrB,QAAQ,KAAK;AAAA,MACb,KAAK;AAAA,MACL,MAAM;AAAA,MACN,OAAO;AAAA,MACP,QAAQ;AAAA,MACR,QAAQ,EAAE,MAAM,OAAO;AAAA,MACvB,YAAY;AAAA,MACZ,OAAO;AAAA,MACP,MAAM;AAAA,MACN,IAAI;AAAA,IACN,CAAC;AAED,SAAK,OAAO,IAAI,CAAC,KAAK,KAAK,GAAG,MAAM;AAClC,WAAK,OAAO,QAAQ;AACpB,WAAK,KAAK,OAAO;AAAA,IACnB,CAAC;AAED,SAAK,OAAO,OAAO;AAAA,EACrB;AAAA,EA3C6B;AAAA,EAVZ;AAAA,EACA;AAAA,EACA;AAAA,EAET,UAAU;AAAA,EACV,UAAU;AAAA,EACV,YAAY;AAAA,EACZ,YAAY;AAAA,EACZ,UAAU;AAAA,EA+ClB,QAAQ,GAAuB;AAC7B,QAAI,KAAK,YAAY,EAAG,MAAK,UAAU,EAAE;AACzC,QAAI,EAAE,QAAQ,MAAM;AAClB,WAAK,WAAW,EAAE,KAAK;AACvB,WAAK;AAAA,IACP,OAAO;AACL,WAAK,WAAW,EAAE,KAAK;AACvB,WAAK;AAAA,IACP;AACA,UAAMC,QACJ,EAAE,UAAU,SAAS,gBAAgB,EAAE,UAAU,SAAS,eACtD,IAAI,EAAE,UAAU,EAAE,OAClB;AACN,SAAK,IAAI;AAAA,MACP,GAAG,QAAQ,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,IAAIA,KAAI,GAAGC,OAAM,EAAE,IAAI,CAAC,MAAM,SAAS,EAAE,IAAI,CAAC;AAAA,IACzE;AACA,SAAK,MAAM,WAAW,KAAK,UAAU,CAAC;AACtC,SAAK,OAAO,OAAO;AAAA,EACrB;AAAA;AAAA,EAGA,QAAQ,KAAmB;AACzB,SAAK,IAAI,IAAI,GAAG;AAChB,SAAK,OAAO,OAAO;AAAA,EACrB;AAAA,EAEA,UAAgB;AAAA,EAAC;AAAA,EAET,YAAoB;AAC1B,UAAM,aAAa,KAAK,YAAY,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK;AAC9D,UAAM,OAAO,aAAa,OAAQ;AAClC,UAAM,SAAS,KAAK,UAAU;AAC9B,UAAM,SAAS,KAAK,UAAU;AAC9B,WACE,OAAO,KAAK,SAAS,WAAW,KAAK,OAAO,OAAO,OAAO,QAAQ,CAAC,CAAC,cAC9D,KAAK,SAAS,WAAW,KAAK,OAAO,OAAO,OAAO,QAAQ,CAAC,CAAC;AAAA,EAEvE;AACF;;;AC9GA,SAAS,SAAS,mBAAmB;AAY9B,SAAS,aAAa,GAAqC;AAChE,MAAI,EAAE,OAAO,EAAE,QAAQ,QAAQ,EAAE,QAAQ,MAAM;AAC7C,UAAM,IAAI,MAAM,oCAAoC,EAAE,GAAG,GAAG;AAAA,EAC9D;AACA,MAAI,CAAC,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,SAAS,CAAC,EAAE,IAAK,QAAO;AACtD,SAAO,IAAI,QAAQ;AAAA,IACjB,KAAK,EAAE;AAAA,IACP,KAAK,EAAE,MAAM,YAAY,EAAE,GAAG,IAAI;AAAA,IAClC,QAAQ,EAAE,SAAS,OAAO,KAAK,EAAE,QAAQ,MAAM,IAAI;AAAA,IACnD,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,KAAK,IAAI;AAAA,EACzC,CAAC;AACH;;;ACvBA,OAAO,QAAQ;AACf,SAAS,eAAe,QAAQ,sBAAsB;AAI/C,SAAS,aAAa,MAAqB,SAAgC;AAChF,QAAM,OAAO,OAAO,IAAI;AACxB,SAAO,IAAI,cAAc,GAAG,kBAAkB,OAAO,GAAG;AAAA,IACtD,SAAS;AAAA,IACT,MAAM,KAAK;AAAA,IACX,IAAI;AAAA,IACJ;AAAA,IACA,SAAS,KAAK,IAAI;AAAA,EACpB,CAAC;AACH;;;ACXO,SAAS,cAAc,GAA2B;AACvD,QAAM,eAAe,EAAE,YAAY,EAAE;AACrC,QAAM,aAAa,EAAE,UAAU,EAAE;AACjC,SAAO;AAAA,IACL,aAAa,EAAE,UAAU;AAAA,IACzB,OAAO,EAAE,SAAS,aAAa,EAAE,OAAO,WAAW,EAAE,OAAO,QAAQ,CAAC,CAAC;AAAA,IACtE,OAAO,EAAE,SAAS,aAAa,EAAE,OAAO,WAAW,EAAE,OAAO,QAAQ,CAAC,CAAC;AAAA,IACtE,UAAU,YAAY,aAAa,UAAU;AAAA,EAC/C,EAAE,KAAK,IAAI;AACb;;;ACPO,SAAS,aAA4B;AAC1C,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,QAAI,UAAU;AACd,UAAM,OAAO,MAAM;AACjB,UAAI,EAAE,WAAW,EAAG,SAAQ;AAAA,IAC9B;AACA,YAAQ,OAAO,MAAM,IAAI,IAAI;AAC7B,YAAQ,OAAO,MAAM,IAAI,IAAI;AAAA,EAC/B,CAAC;AACH;;;APHO,SAAS,gBAAgBC,UAAwB;AACtD,EAAAA,SACG,QAAQ,SAAS,EACjB;AAAA,IACC;AAAA,IACA;AAAA,EACF,EACC,OAAO,mBAAmB,qBAAqB,KAAK,EACpD,OAAO,kBAAkB,iBAAiB,EAC1C,OAAO,cAAc,qBAAqB,EAC1C,OAAO,gBAAgB,kDAAkD,EACzE,OAAO,aAAa,oDAAoD,EACxE,OAAO,gBAAgB,sDAAsD,EAC7E,OAAO,eAAe,oBAAoB,EAC1C,OAAO,mBAAmB,6BAA6B,EACvD,OAAO,WAAW,kCAAkC,EACpD,OAAO,iBAAiB,sBAAsB,EAC9C,OAAO,SAAS,uBAAuB,EACvC,OAAO,OAAO,MAAc,SAAkC;AAC7D,QAAI;AACJ,QAAI;AACF,mBAAa,UAAU,IAAI;AAAA,IAC7B,SAAS,KAAK;AACZ,cAAQ,OAAO,MAAMC,OAAM,IAAI,UAAW,IAAc,OAAO;AAAA,CAAI,CAAC;AACpE,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,QAAI;AACJ,QAAI;AACF,eAAS,aAAa;AAAA,QACpB,QAAQ,KAAK;AAAA,QACb,KAAK,KAAK;AAAA,QACV,OAAO,KAAK;AAAA,QACZ,KAAK,KAAK;AAAA,MACZ,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,cAAQ,OAAO,MAAMA,OAAM,IAAI,UAAW,IAAc,OAAO;AAAA,CAAI,CAAC;AACpE,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,YAAY,gBAAgB,UAAU;AAC5C,UAAM,WAAW,KAAK,QAAQ,IAAI,SAAS,IAAI;AAE/C,QAAI;AACJ,QAAI;AACJ,QAAI,KAAK,KAAK;AACZ,YAAM,IAAI,YAAY,EAAE,MAAMC,QAAO,UAAU,GAAG,QAAQ,MAAM,KAAK,SAAS,EAAE,CAAC;AACjF,iBAAW;AAAA,IACb,OAAO;AACL,iBAAW,IAAI,eAAe;AAAA,QAC5B,MAAM,KAAK;AAAA,QACX,WAAW,QAAQ,KAAK,SAAS;AAAA,QACjC,OAAO,QAAQ,KAAK,KAAK;AAAA,MAC3B,CAAC;AAAA,IACH;AAEA,UAAM,QAAgB,CAAC,QAAQ;AAC/B,QAAI,KAAK,OAAQ,OAAM,KAAK,aAAa,YAAY,KAAK,MAAgB,CAAC;AAC3E,QAAI,SAAU,OAAM,KAAK,QAAQ;AACjC,UAAM,UAAU,IAAI,QAAQ,WAAW,EAAE,QAAQ,MAAM,CAAC;AAExD,cAAU,GAAG,QAAQ,CAAC,EAAE,KAAK,MAAM;AACjC,UAAI,IAAK,KAAI,QAAQ,cAAc,KAAK,IAAI,EAAE;AAAA,UACzC,SAAQ,OAAO,MAAMD,OAAM,IAAI,gBAAgB,KAAK,IAAI;AAAA,CAAI,CAAC;AAAA,IACpE,CAAC;AACD,cAAU,GAAG,SAAS,CAAC,EAAE,MAAM,MAAM;AACnC,UAAI,IAAK,KAAI,QAAQ,UAAU,MAAM,OAAO,EAAE;AAAA,UACzC,SAAQ,OAAO,MAAMA,OAAM,IAAI,UAAU,MAAM,OAAO;AAAA,CAAI,CAAC;AAAA,IAClE,CAAC;AAED,QAAI,eAAe;AACnB,cAAU,GAAG,SAAS,MAAM;AAC1B,UAAI,aAAc;AAClB,UAAI,IAAK,KAAI,QAAQ,QAAQ;AAAA,UACxB,SAAQ,OAAO,MAAMA,OAAM,IAAI,YAAY,CAAC;AACjD,cAAQ,KAAK,CAAC;AAAA,IAChB,CAAC;AAED,mBAAe,WAA0B;AACvC,UAAI,aAAc;AAClB,qBAAe;AACf,YAAM,QAAQ,KAAK;AACnB,UAAI,UAAU;AACZ,cAAM,UAAU,cAAc,SAAS,UAAU,CAAC;AAClD,YAAI,IAAK,KAAI,QAAQ,OAAO;AAAA,YACvB,SAAQ,OAAO,MAAMA,OAAM,IAAI,UAAU,IAAI,CAAC;AAAA,MACrD;AACA,YAAM,WAAW;AACjB,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,YAAQ,GAAG,UAAU,QAAQ;AAC7B,YAAQ,GAAG,WAAW,QAAQ;AAE9B,QAAI,KAAK,SAAS;AAChB,YAAM,OAAO,OAAO,KAAK,OAAO;AAChC,UAAI,CAAC,OAAO,SAAS,IAAI,KAAK,QAAQ,GAAG;AACvC,gBAAQ,OAAO,MAAMA,OAAM,IAAI,6BAA6B,KAAK,OAAO;AAAA,CAAK,CAAC;AAC9E,gBAAQ,KAAK,CAAC;AAAA,MAChB;AACA,iBAAW,UAAU,OAAO,GAAI;AAAA,IAClC;AAEA,QAAI;AACF,YAAM,QAAQ,IAAI;AAAA,IACpB,SAAS,KAAK;AACZ,cAAQ,OAAO,MAAMA,OAAM,IAAI,UAAW,IAAc,OAAO;AAAA,CAAI,CAAC;AACpE,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AACL;;;AQxHA,OAAOE,YAAW;AAElB,SAAS,uBAAuB;AAEzB,SAAS,mBAAmBC,UAAwB;AACzD,EAAAA,SACG,QAAQ,aAAa,EACrB,YAAY,4BAA4B,EACxC,OAAO,YAAY;AAClB,QAAI;AACF,YAAM,QAAQ,MAAM,gBAAgB;AACpC,UAAI,MAAM,WAAW,GAAG;AACtB,gBAAQ,OAAO,MAAM,yBAAyB;AAC9C;AAAA,MACF;AACA,iBAAW,KAAK,OAAO;AACrB,gBAAQ,OAAO,MAAM,GAAG,EAAE,IAAI,GAAG,EAAE,eAAe,IAAK,EAAE,YAAY,KAAK,EAAE;AAAA,CAAI;AAAA,MAClF;AAAA,IACF,SAAS,KAAK;AACZ,cAAQ,OAAO,MAAMD,OAAM,IAAI,UAAW,IAAc,OAAO;AAAA,CAAI,CAAC;AACpE,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AACL;;;ACvBA,OAAOE,YAAW;AAElB,SAAS,aAAAC,YAAW,mBAAAC,kBAAiB,WAAAC,UAAS,YAAAC,iBAAgB;AAOvD,SAAS,eAAeC,UAAwB;AACrD,EAAAA,SACG,QAAQ,QAAQ,EAChB,SAAS,UAAU,wGAAwG,EAC3H,eAAe,gBAAgB,uBAAuB,EACtD,OAAO,gBAAgB,oDAAoD,EAC3E,OAAO,aAAa,sDAAsD,EAC1E,OAAO,gBAAgB,wDAAwD,EAC/E,OAAO,eAAe,sBAAsB,EAC5C,OAAO,WAAW,kCAAkC,EACpD,OAAO,OAAO,MAAc,SAAkC;AAC7D,QAAI;AACJ,QAAI;AACF,mBAAaC,WAAU,IAAI;AAAA,IAC7B,SAAS,KAAK;AACZ,cAAQ,OAAO,MAAMC,OAAM,IAAI,UAAW,IAAc,OAAO;AAAA,CAAI,CAAC;AACpE,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,QAAI;AACJ,QAAI;AACF,eAAS,aAAa;AAAA,QACpB,QAAQ,KAAK;AAAA,QACb,KAAK,KAAK;AAAA,QACV,OAAO,KAAK;AAAA,QACZ,KAAK,KAAK;AAAA,MACZ,CAAC;AAAA,IACH,SAAS,KAAK;AACZ,cAAQ,OAAO,MAAMA,OAAM,IAAI,UAAW,IAAc,OAAO;AAAA,CAAI,CAAC;AACpE,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,YAAYC,iBAAgB,UAAU;AAC5C,UAAM,WAAW,aAAa,YAAY,KAAK,GAAa;AAE5D,QAAI,QAAQ;AACZ,UAAM,UAAgB;AAAA,MACpB,SAAS,MAAM;AACb;AAAA,MACF;AAAA,MACA,SAAS,MAAM;AAAA,MAAC;AAAA,IAClB;AAEA,UAAM,WAAW,KAAK,QAAQ,IAAIC,UAAS,IAAI;AAC/C,UAAM,QAAgB,CAAC,UAAU,OAAO;AACxC,QAAI,SAAU,OAAM,KAAK,QAAQ;AACjC,UAAM,UAAU,IAAIC,SAAQ,WAAW,EAAE,QAAQ,MAAM,CAAC;AAExD,cAAU;AAAA,MAAG;AAAA,MAAQ,CAAC,EAAE,KAAK,MAC3B,QAAQ,OAAO,MAAMH,OAAM,IAAI,eAAe,KAAK,IAAI,OAAO,KAAK,GAAG;AAAA,CAAI,CAAC;AAAA,IAC7E;AACA,cAAU;AAAA,MAAG;AAAA,MAAS,CAAC,EAAE,MAAM,MAC7B,QAAQ,OAAO,MAAMA,OAAM,IAAI,UAAU,MAAM,OAAO;AAAA,CAAI,CAAC;AAAA,IAC7D;AAEA,QAAI,eAAe;AACnB,UAAM,WAAW,YAAY;AAC3B,UAAI,aAAc;AAClB,qBAAe;AACf,YAAM,QAAQ,KAAK;AACnB,cAAQ,OAAO,MAAMA,OAAM,IAAI,cAAc,KAAK,cAAc,KAAK,GAAG;AAAA,CAAI,CAAC;AAC7E,UAAI,SAAU,SAAQ,OAAO,MAAMA,OAAM,IAAI,cAAc,SAAS,UAAU,CAAC,IAAI,IAAI,CAAC;AACxF,YAAM,WAAW;AACjB,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,YAAQ,GAAG,UAAU,QAAQ;AAC7B,YAAQ,GAAG,WAAW,QAAQ;AAE9B,QAAI;AACF,YAAM,QAAQ,IAAI;AAAA,IACpB,SAAS,KAAK;AACZ,cAAQ,OAAO,MAAMA,OAAM,IAAI,UAAW,IAAc,OAAO;AAAA,CAAI,CAAC;AACpE,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AACL;;;ACpFA,OAAOI,YAAW;AAElB,SAAS,YAAY,WAAAC,gBAAe;AAM7B,SAAS,aAAaC,UAAwB;AACnD,EAAAA,SACG,QAAQ,MAAM,EACd,SAAS,UAAU,6BAA6B,EAChD,OAAO,eAAe,qDAAqD,GAAG,EAC9E,OAAO,mBAAmB,qBAAqB,KAAK,EACpD,OAAO,kBAAkB,iBAAiB,EAC1C,OAAO,cAAc,qBAAqB,EAC1C,OAAO,eAAe,oBAAoB,EAC1C,OAAO,SAAS,uBAAuB,EACvC,OAAO,OAAO,MAAc,SAAkC;AAC7D,UAAMC,OAAM,KAAK;AACjB,QAAIA,QAAOA,SAAQ,QAAQA,SAAQ,MAAM;AACvC,cAAQ,OAAO,MAAMC,OAAM,IAAI,2CAA2CD,IAAG;AAAA,CAAK,CAAC;AACnF,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,UAAM,QAAQ,OAAO,KAAK,KAAK;AAC/B,QAAI,OAAO,MAAM,KAAK,KAAK,QAAQ,GAAG;AACpC,cAAQ,OAAO,MAAMC,OAAM,IAAI,2BAA2B,KAAK,KAAK;AAAA,CAAK,CAAC;AAC1E,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,SAAS,IAAI,WAAW,MAAM,EAAE,OAAO,KAAAD,KAAI,CAAC;AAElD,QAAI;AACJ,QAAI;AACJ,QAAI,KAAK,KAAK;AACZ,YAAM,IAAI,YAAY,EAAE,MAAM,SAAS,IAAI,IAAI,QAAQ,MAAM,KAAK,SAAS,EAAE,CAAC;AAC9E,iBAAW;AAAA,IACb,OAAO;AACL,iBAAW,IAAI,eAAe;AAAA,QAC5B,MAAM,KAAK;AAAA,QACX,WAAW,QAAQ,KAAK,SAAS;AAAA,QACjC,OAAO,QAAQ,KAAK,KAAK;AAAA,MAC3B,CAAC;AAAA,IACH;AAEA,UAAM,UAAU,IAAIE,SAAQ,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;AAEzD,WAAO,GAAG,QAAQ,CAAC,EAAE,KAAK,MAAM;AAC9B,UAAI,IAAK,KAAI,QAAQ,aAAa,KAAK,IAAI,EAAE;AAAA,UACxC,SAAQ,OAAO,MAAMD,OAAM,IAAI,eAAe,KAAK,IAAI;AAAA,CAAI,CAAC;AAAA,IACnE,CAAC;AACD,WAAO,GAAG,SAAS,CAAC,EAAE,MAAM,MAAM;AAChC,UAAI,IAAK,KAAI,QAAQ,UAAU,MAAM,OAAO,EAAE;AAAA,UACzC,SAAQ,OAAO,MAAMA,OAAM,IAAI,UAAU,MAAM,OAAO;AAAA,CAAI,CAAC;AAAA,IAClE,CAAC;AAED,mBAAe,WAA0B;AACvC,YAAM,QAAQ,KAAK;AACnB,YAAM,WAAW;AACjB,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,YAAQ,GAAG,UAAU,QAAQ;AAC7B,YAAQ,GAAG,WAAW,QAAQ;AAE9B,QAAI;AACF,YAAM,QAAQ,IAAI;AAAA,IACpB,SAAS,KAAK;AACZ,cAAQ,OAAO,MAAMA,OAAM,IAAI,UAAW,IAAc,OAAO;AAAA,CAAI,CAAC;AACpE,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AACL;;;ACvEA,OAAOE,SAAQ;AACf,OAAO,cAAc;AACrB,OAAOC,YAAW;AAElB,SAAS,cAAc,mBAAmB;AAWnC,SAAS,eAAeC,UAAwB;AACrD,EAAAA,SACG,QAAQ,QAAQ,EAChB,SAAS,UAAU,6BAA6B,EAChD,OAAO,gBAAgB,8CAA8C,EACrE,OAAO,aAAa,gDAAgD,EACpE,OAAO,gBAAgB,kDAAkD,EACzE,OAAO,eAAe,qBAAqB,EAC3C,OAAO,qBAAqB,4CAA4C,GAAG,EAC3E,OAAO,cAAc,qBAAqB,EAC1C,OAAO,kBAAkB,iBAAiB,EAC1C,OAAO,OAAO,MAAc,SAAkC;AAC7D,UAAM,UAAU,aAAa;AAAA,MAC3B,QAAQ,KAAK;AAAA,MACb,KAAK,KAAK;AAAA,MACV,OAAO,KAAK;AAAA,MACZ,KAAK,KAAK;AAAA,IACZ,CAAC;AACD,QAAI,CAAC,SAAS;AACZ,cAAQ,OAAO;AAAA,QACbC,OAAM,IAAI,8DAA8D;AAAA,MAC1E;AACA,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,SAAyB,CAAC;AAChC,UAAM,KAAK,SAAS,gBAAgB;AAAA,MAClC,OAAOC,IAAG,iBAAiB,IAAI;AAAA,MAC/B,WAAW;AAAA,IACb,CAAC;AACD,QAAI,aAAa;AACjB,QAAI,SAAS;AACb,qBAAiB,QAAQ,IAAI;AAC3B;AACA,UAAI,CAAC,YAAY;AACf,qBAAa,IAAI;AACjB,qBAAa;AACb;AAAA,MACF;AACA,aAAO,KAAK,EAAE,MAAM,QAAQ,GAAG,YAAY,IAAI,EAAE,CAAC;AAAA,IACpD;AAEA,UAAM,WAAW,oBAAI,IAAY;AACjC,WAAO,QAAQ,CAAC,MAAM,MAAM;AAC1B,UAAI,QAAQ,QAAQ,KAAK,CAAC,EAAG,UAAS,IAAI,CAAC;AAAA,IAC7C,CAAC;AACD,QAAI,SAAS,SAAS,GAAG;AACvB,cAAQ,OAAO,MAAM,cAAc;AACnC;AAAA,IACF;AAEA,UAAM,MAAM,KAAK,IAAI,GAAG,OAAO,KAAK,OAAO,KAAK,CAAC;AACjD,UAAM,QAAQ,QAAQ,KAAK,KAAK;AAChC,IAAAD,OAAM,QAAQ,QAAQ,IAAI;AAC1B,UAAM,WAAwB;AAAA,MAC5B,MAAM;AAAA,MACN,WAAW,QAAQ,KAAK,SAAS;AAAA,MACjC;AAAA,IACF;AAEA,UAAM,WAAW,IAAI,MAAe,OAAO,MAAM,EAAE,KAAK,KAAK;AAC7D,eAAW,KAAK,UAAU;AACxB,YAAM,OAAO,KAAK,IAAI,GAAG,IAAI,GAAG;AAChC,YAAM,KAAK,KAAK,IAAI,OAAO,SAAS,GAAG,IAAI,GAAG;AAC9C,eAAS,IAAI,MAAM,KAAK,IAAI,IAAK,UAAS,CAAC,IAAI;AAAA,IACjD;AAEA,YAAQ,OAAO,MAAMA,OAAM,IAAI,KAAK,SAAS,IAAI;AAAA,CAAY,CAAC;AAE9D,QAAI,OAAO;AACX,aAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK;AACtC,UAAI,CAAC,SAAS,CAAC,EAAG;AAClB,UAAI,SAAS,MAAM,IAAI,OAAO,EAAG,SAAQ,OAAO,MAAMA,OAAM,IAAI,MAAM,CAAC;AACvE,YAAM,OAAO,OAAO,CAAC;AACrB,YAAM,UAAU,SAAS,IAAI,CAAC;AAC9B,YAAM,SAAS,UAAUA,OAAM,KAAK,IAAI,IAAI;AAC5C,YAAM,UAAUA,OAAM,KAAK,OAAO,KAAK,IAAI,EAAE,SAAS,CAAC,CAAC,IAAI;AAC5D,cAAQ,OAAO,MAAM,SAAS,UAAU,gBAAgB,KAAK,GAAG,QAAQ,IAAI,IAAI;AAChF,aAAO;AAAA,IACT;AAAA,EACF,CAAC;AACL;;;AChGA,OAAOE,YAAW;AAElB,SAAS,aAAAC,YAAW,mBAAAC,kBAAiB,6BAA6B;AAI3D,SAAS,eAAeC,UAAwB;AACrD,EAAAA,SACG,QAAQ,QAAQ,EAChB,SAAS,UAAU,6BAA6B,EAChD,eAAe,eAAe,kCAAkC,EAChE,OAAO,eAAe,qDAAqD,GAAG,EAC9E,OAAO,UAAU,wCAAwC,EACzD,OAAO,eAAe,oDAAoD,EAC1E,OAAO,OAAO,MAAc,SAAkC;AAC7D,UAAMC,OAAM,KAAK;AACjB,QAAIA,QAAOA,SAAQ,QAAQA,SAAQ,MAAM;AACvC,cAAQ,OAAO,MAAMC,OAAM,IAAI,2CAA2CD,IAAG;AAAA,CAAK,CAAC;AACnF,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,UAAM,QAAQ,OAAO,KAAK,KAAK;AAC/B,QAAI,OAAO,MAAM,KAAK,KAAK,QAAQ,GAAG;AACpC,cAAQ,OAAO,MAAMC,OAAM,IAAI,2BAA2B,KAAK,KAAK;AAAA,CAAK,CAAC;AAC1E,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,QAAI;AACJ,QAAI;AACF,mBAAaC,WAAU,KAAK,EAAY;AAAA,IAC1C,SAAS,KAAK;AACZ,cAAQ,OAAO,MAAMD,OAAM,IAAI,UAAW,IAAc,OAAO;AAAA,CAAI,CAAC;AACpE,cAAQ,KAAK,CAAC;AAAA,IAChB;AAEA,UAAM,SAASE,iBAAgB,UAAU;AACzC,WAAO;AAAA,MAAG;AAAA,MAAQ,CAAC,EAAE,KAAK,MACxB,QAAQ,OAAO,MAAMF,OAAM,IAAI,eAAe,IAAI,OAAO,KAAK,IAAI;AAAA,CAAI,CAAC;AAAA,IACzE;AACA,WAAO;AAAA,MAAG;AAAA,MAAS,CAAC,EAAE,MAAM,MAC1B,QAAQ,OAAO,MAAMA,OAAM,IAAI,UAAU,MAAM,OAAO;AAAA,CAAI,CAAC;AAAA,IAC7D;AAEA,QAAI,WAAW;AACf,UAAM,OAAO,YAAY;AACvB,UAAI,SAAU;AACd,iBAAW;AACX,YAAM,OAAO,KAAK;AAClB,YAAM,WAAW;AACjB,cAAQ,KAAK,CAAC;AAAA,IAChB;AACA,YAAQ,GAAG,UAAU,IAAI;AACzB,YAAQ,GAAG,WAAW,IAAI;AAE1B,QAAI;AACF,YAAM,OAAO,MAAM;AACnB,YAAM,OAAO,MAAM,sBAAsB,MAAM,QAAQ;AAAA,QACrD;AAAA,QACA,MAAM,QAAQ,KAAK,IAAI;AAAA,QACvB,KAAAD;AAAA,MACF,CAAC;AACD,cAAQ,OAAO,MAAMC,OAAM,IAAI,cAAc,IAAI;AAAA,CAAW,CAAC;AAC7D,YAAM,KAAK;AAAA,IACb,SAAS,KAAK;AACZ,cAAQ,OAAO,MAAMA,OAAM,IAAI,UAAW,IAAc,OAAO;AAAA,CAAI,CAAC;AACpE,YAAM,WAAW;AACjB,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF,CAAC;AACL;;;Ab5DA,IAAM,UAAU,IAAI,QAAQ;AAE5B,QACG,KAAK,YAAY,EACjB,YAAY,mDAAmD,EAC/D,QAAQ,OAAO;AAElB,gBAAgB,OAAO;AACvB,eAAe,OAAO;AACtB,aAAa,OAAO;AACpB,eAAe,OAAO;AACtB,eAAe,OAAO;AACtB,mBAAmB,OAAO;AAE1B,MAAM,QAAQ,WAAW,QAAQ,IAAI;","names":["chalk","toDesc","chalk","dir","chalk","toHex","peer","toHex","program","chalk","toDesc","chalk","program","chalk","parseSpec","createTransport","Session","Analyzer","program","parseSpec","chalk","createTransport","Analyzer","Session","chalk","Session","program","dir","chalk","Session","fs","chalk","program","chalk","fs","chalk","parseSpec","createTransport","program","dir","chalk","parseSpec","createTransport"]}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "comm-scope",
+  "version": "0.1.0",
+  "description": "Serial / TCP / UDP traffic monitor for developers — CLI",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "comm-scope": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "serial",
+    "tcp",
+    "udp",
+    "monitor",
+    "traffic",
+    "replay",
+    "sniffer",
+    "debug"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AndyFree96/comm-scope.git"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "dependencies": {
+    "@anthonyfree96/core": "^0.1.0",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "neo-blessed": "^0.2.0"
+  }
+}