fluncle 0.209.0 → 0.211.0

package/bin/fluncle.mjs

@@ -610,7 +610,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.209.0".trim() ? "0.209.0".trim() : "0.1.0";
+  currentVersion = "0.211.0".trim() ? "0.211.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2452,7 +2452,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.209.0".trim() ? "0.209.0".trim() : "0.1.0";
+  currentVersion2 = "0.211.0".trim() ? "0.211.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -4469,6 +4469,101 @@ var init_admin_attention = __esm(() => {
   };
 });
 
+// src/commands/admin-telemetry.ts
+var exports_admin_telemetry = {};
+__export(exports_admin_telemetry, {
+  telemetryLines: () => telemetryLines,
+  telemetryCommand: () => telemetryCommand
+});
+async function telemetryCommand(options) {
+  const params = new URLSearchParams({ limit: String(options.limit) });
+  if (options.cursor !== undefined) {
+    params.set("cursor", options.cursor);
+  }
+  if (options.ok !== undefined) {
+    params.set("ok", String(options.ok));
+  }
+  if (options.since !== undefined) {
+    params.set("since", options.since);
+  }
+  if (options.unit !== undefined) {
+    params.set("unit", options.unit);
+  }
+  if (options.until !== undefined) {
+    params.set("until", options.until);
+  }
+  return adminApiGet(`/api/v1/admin/telemetry/runs?${params.toString()}`);
+}
+function cell(value) {
+  if (value === null) {
+    return "-";
+  }
+  if (typeof value === "boolean") {
+    return value ? "1" : "0";
+  }
+  return String(value);
+}
+function padded(columns, widths) {
+  return columns.map((column, index) => column.padEnd(widths[index] ?? 0)).join("  ").trimEnd();
+}
+function telemetryLines(page) {
+  if (!page.available) {
+    return ["Telemetry database is not configured."];
+  }
+  if (page.rows.length === 0) {
+    return ["No run events matched."];
+  }
+  const rollupHeader = ["UNIT", "RUNS", "LAST", "OK=0", "LIAR", "BLIND"];
+  const rollupRows = page.rollups.map((rollup) => [
+    rollup.unit,
+    String(rollup.runCount),
+    rollup.lastOccurredAt,
+    String(rollup.failedCount),
+    String(rollup.liarCount),
+    String(rollup.blindCount)
+  ]);
+  const rollupWidths = rollupHeader.map((header, index) => Math.max(header.length, ...rollupRows.map((row) => row[index]?.length ?? 0)));
+  const runHeader = [
+    "OCCURRED",
+    "UNIT",
+    "OK",
+    "SELF",
+    "CHECKED",
+    "PRODUCED",
+    "QUEUE",
+    "EXIT",
+    "SUMMARY"
+  ];
+  const runRows = page.rows.map((row) => [
+    row.occurredAt,
+    row.unit,
+    cell(row.ok),
+    cell(row.selfAssertedOk),
+    cell(row.checked),
+    cell(row.produced),
+    cell(row.queueDepth),
+    String(row.exitCode),
+    row.summaryStatus
+  ]);
+  const runWidths = runHeader.map((header, index) => Math.max(header.length, ...runRows.map((row) => row[index]?.length ?? 0)));
+  const lines = [
+    `Unit rollups (${page.totalCount} matching runs)`,
+    padded(rollupHeader, rollupWidths),
+    ...rollupRows.map((row) => padded(row, rollupWidths)),
+    "",
+    `Runs (${page.rows.length} on this page)`,
+    padded(runHeader, runWidths),
+    ...runRows.map((row) => padded(row, runWidths))
+  ];
+  if (page.nextCursor !== null) {
+    lines.push("", `Next cursor: ${page.nextCursor}`);
+  }
+  return lines;
+}
+var init_admin_telemetry = __esm(() => {
+  init_api();
+});
+
 // src/commands/add.ts
 var exports_add = {};
 __export(exports_add, {
@@ -9660,6 +9755,14 @@ function addAdminCommands(program2) {
     const { attentionQueueCommand: attentionQueueCommand2 } = await Promise.resolve().then(() => (init_admin_attention(), exports_admin_attention));
     await runAdminAttention(options, attentionQueueCommand2);
   });
+  const adminTelemetry = configureCommand(admin.command("telemetry").description("Run-ledger telemetry"));
+  adminTelemetry.action(() => {
+    adminTelemetry.outputHelp();
+  });
+  adminTelemetry.command("read").description("Run-ledger rows plus per-unit rollups").option("--unit <unit>", "Only this systemd unit").option("--since <iso>", "Only runs at or after this occurred-at instant").option("--until <iso>", "Only runs at or before this occurred-at instant").option("--ok <true|false>", "Filter by the Worker's derived run verdict").option("--limit <limit>", "Rows to show (1-100)", "50").option("--cursor <cursor>", "Opaque cursor from the previous page").option("--json", "Print the lossless 20-column rows as JSON", false).action(async (options) => {
+    const { telemetryCommand: telemetryCommand2 } = await Promise.resolve().then(() => (init_admin_telemetry(), exports_admin_telemetry));
+    await runAdminTelemetry(options, telemetryCommand2);
+  });
   const adminTracks = configureCommand(admin.command("tracks").description("Track admin commands"));
   adminTracks.action(() => {
     adminTracks.outputHelp();
@@ -11082,36 +11185,48 @@ async function runBackfillArtistImages(options, backfillArtistImagesCommand2) {
   const failed = [];
   const skipped = [];
   let cursor;
+  let budgetLimited = false;
+  let checkedCount = 0;
   let dryRun = options.dryRun;
-  while (filled.length + failed.length + skipped.length < limit) {
-    const remaining = limit - (filled.length + failed.length + skipped.length);
+  let queueDepth = 0;
+  let rateLimited = false;
+  while (filled.length < limit) {
+    const remaining = limit - filled.length;
     const result = await backfillArtistImagesCommand2(remaining, options.dryRun, cursor);
+    budgetLimited ||= result.budgetLimited;
+    checkedCount += result.checkedCount;
     dryRun = result.dryRun;
     filled.push(...result.filled);
     failed.push(...result.failed);
+    queueDepth = result.queueDepth;
+    rateLimited ||= result.rateLimited;
     skipped.push(...result.skipped);
     if (!options.json) {
       const verb2 = result.dryRun ? "would fill" : "filled";
       console.log(`  \u2026${verb2} ${result.filledCount}; ${result.failedCount} failed; ${result.skippedCount} without an image`);
     }
-    if (result.nextCursor === null) {
+    if (result.nextCursor === null || result.rateLimited || result.budgetLimited) {
       break;
     }
     cursor = result.nextCursor;
   }
   if (options.json) {
     printSweepJson({
+      budgetLimited,
+      checkedCount,
       dryRun,
       failed,
       filled,
       filledCount: filled.length,
+      queueDepth,
+      rateLimited,
       skipped,
       skippedCount: skipped.length
     }, failed.length);
     return;
   }
   const verb = dryRun ? "Would fill" : "Filled";
-  console.log(`${verb} ${filled.length} artist avatar(s); ${failed.length} failed; ${skipped.length} without a Spotify image.`);
+  console.log(`${verb} ${filled.length} artist avatar(s); checked ${checkedCount}; ${failed.length} failed; ${skipped.length} without a Spotify image; ${queueDepth} queued.`);
   for (const artistId of filled) {
     console.log(`  ${artistId}`);
   }
@@ -12473,6 +12588,32 @@ function parseListLimit(value) {
   }
   return limit;
 }
+function parseTelemetryLimit(value) {
+  const limit = Number.parseInt(value ?? "50", 10);
+  if (!Number.isInteger(limit) || limit < 1 || limit > 100) {
+    throw new Error("Limit must be an integer between 1 and 100");
+  }
+  return limit;
+}
+function parseTelemetryOk(value) {
+  if (value === undefined) {
+    return;
+  }
+  if (value !== "true" && value !== "false") {
+    throw new Error("--ok must be true or false");
+  }
+  return value === "true";
+}
+function parseTelemetryTimestamp(value, flag) {
+  if (value === undefined) {
+    return;
+  }
+  const timestamp = new Date(value);
+  if (Number.isNaN(timestamp.getTime())) {
+    throw new Error(`${flag} must be an ISO-8601 timestamp`);
+  }
+  return timestamp.toISOString();
+}
 function parsePage(value) {
   const page = Number.parseInt(value ?? "1", 10);
   if (!Number.isInteger(page) || page < 1) {
@@ -12540,6 +12681,28 @@ async function runAdminAttention(options, attentionQueueCommand2) {
   console.log(attentionQueueLines2(queue).join(`
 `));
 }
+async function runAdminTelemetry(options, telemetryCommand2) {
+  const since = parseTelemetryTimestamp(options.since, "--since");
+  const until = parseTelemetryTimestamp(options.until, "--until");
+  if (since !== undefined && until !== undefined && since > until) {
+    throw new Error("--since must be before or equal to --until");
+  }
+  const page = await telemetryCommand2({
+    cursor: options.cursor,
+    limit: parseTelemetryLimit(options.limit),
+    ok: parseTelemetryOk(options.ok),
+    since,
+    unit: options.unit,
+    until
+  });
+  if (options.json) {
+    printJson({ ok: true, ...page });
+    return;
+  }
+  const { telemetryLines: telemetryLines2 } = await Promise.resolve().then(() => (init_admin_telemetry(), exports_admin_telemetry));
+  console.log(telemetryLines2(page).join(`
+`));
+}
 async function runAdminQueue(options, queueCommand2) {
   const limit = parseListLimit(options.limit);
   const tracks = await queueCommand2(limit, {
@@ -13008,6 +13171,7 @@ var stringOptions = new Set([
   "--min-phrase-words",
   "--model",
   "--note",
+  "--ok",
   "--order",
   "--page",
   "--parent-id",
@@ -13029,6 +13193,7 @@ var stringOptions = new Set([
   "--script-file",
   "--seed",
   "--seed-state",
+  "--since",
   "--soundcloud-url",
   "--source",
   "--status",
@@ -13037,6 +13202,8 @@ var stringOptions = new Set([
   "--token",
   "--tracklist-file",
   "--tracks",
+  "--unit",
+  "--until",
   "--url",
   "--verdict",
   "--verdict-file",

package/package.json

@@ -31,5 +31,5 @@
     "url": "git+https://github.com/mauricekleine/fluncle.git"
   },
   "type": "module",
-  "version": "0.209.0"
+  "version": "0.211.0"
 }