Write Log Summary

1#!/usr/bin/env node
2'use strict';
3
4// The only supported way for an agent to look at the write ledger or the import
5// audit log. Bounded output; reads the file as a stream; writes nothing.
6
7const path = require('node:path');
8const { summarizeWriteLog, formatText } = require('../lib/write-log-summary.js');
9
10function usage() {
11  return `Usage:
12  node skills/wix-replatform/scripts/write-log-summary.js --project <dir>
13      [--log attempts|audit] [--run <runId>|latest] [--since-run <runId>]
14      [--entity <targetEntityType>] [--status <status>] [--limit <n>] [--fields a,b,c] [--json]
15
16Default: current status of every attempt (folded by attemptId), counts per entity x status,
17top error classes per entity. --entity/--status add up to --limit matching rows (default 20).
18Never open, cat, grep, tail or jq the raw ledger; use this instead.
19`;
20}
21
22function parseArgs(argv) {
23  const args = {};
24  for (let i = 0; i < argv.length; i += 1) {
25    const token = argv[i];
26    if (token === '--json') { args.json = true; continue; }
27    if (token === '--help' || token === '-h') { args.help = true; continue; }
28    if (!token.startsWith('--')) throw new Error(`unexpected argument: ${token}`);
29    const key = token.slice(2).replace(/-([a-z])/g, (_, c) => c.toUpperCase());
30    const value = argv[i + 1];
31    if (value === undefined || value.startsWith('--')) throw new Error(`missing value for ${token}`);
32    args[key] = value;
33    i += 1;
34  }
35  if (args.fields) args.fields = args.fields.split(',').map((f) => f.trim()).filter(Boolean);
36  return args;
37}
38
39async function main() {
40  const args = parseArgs(process.argv.slice(2));
41  if (args.help) { process.stdout.write(usage()); return; }
42  if (!args.project) throw new Error(`--project is required\n${usage()}`);
43  const summary = await summarizeWriteLog(path.resolve(args.project), args);
44  if (args.json) {
45    const { file, ...rest } = summary;
46    process.stdout.write(`${JSON.stringify({ ...rest, file: path.relative(path.resolve(args.project), file) })}\n`);
47  } else {
48    process.stdout.write(formatText(summary));
49  }
50}
51
52main().catch((error) => {
53  process.stderr.write(`${error && error.message ? error.message : error}\n`);
54  process.exit(1);
55});