fluncle 0.244.0 → 0.245.0

package/bin/fluncle.mjs

@@ -622,7 +622,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.244.0".trim() ? "0.244.0".trim() : "0.1.0";
+  currentVersion = "0.245.0".trim() ? "0.245.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2335,7 +2335,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.244.0".trim() ? "0.244.0".trim() : "0.1.0";
+  currentVersion2 = "0.245.0".trim() ? "0.245.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -12400,7 +12400,9 @@ var init_admin_projections = __esm(() => {
       artistQualification: ProjectionFamilyStatusSchema,
       crawlDueWork: ProjectionFamilyStatusSchema,
       publicAggregates: ProjectionFamilyStatusSchema.extend({ anchorsReady: boolean2() }),
-      trackDueWork: ProjectionFamilyStatusSchema
+      trackDueWork: ProjectionFamilyStatusSchema.extend({
+        catalogueRankMarkerAgeMs: CountSchema.nullable().optional()
+      })
     }),
     readyToOpen: object({
       crawlDueWork: boolean2(),
@@ -16842,16 +16844,29 @@ async function getProjectionStatusCommand() {
   return adminApiGet("/api/v1/admin/projections/status");
 }
 async function advanceProjectionCommand(input) {
-  const { includeTerminalStatus = true, maxSteps = 1, target, ...body } = input;
+  const {
+    includeTerminalStatus = true,
+    maxSteps = 1,
+    now = () => Date.now(),
+    target,
+    wallMs,
+    ...body
+  } = input;
   if (!includeTerminalStatus && input.action !== "repair") {
     throw new Error("terminal status may be omitted only for repair automation");
   }
   const stepBody = maxSteps > 1 || !includeTerminalStatus ? { ...body, includeStatus: false } : body;
+  const startedAt = now();
   let response = await adminApiPost(`/api/v1/admin/projections/${target}/advance`, stepBody);
   let steps = 1;
   let processed = response.processed;
   let scheduled = response.scheduled;
+  let wallStopped = false;
   while (!response.complete && steps < maxSteps) {
+    if (wallMs !== undefined && now() - startedAt >= wallMs) {
+      wallStopped = true;
+      break;
+    }
     response = await adminApiPost(`/api/v1/admin/projections/${target}/advance`, stepBody);
     steps += 1;
     processed += response.processed;
@@ -16859,10 +16874,10 @@ async function advanceProjectionCommand(input) {
   }
   if (!includeTerminalStatus) {
     const { status: _status, ...withoutStatus } = response;
-    return { ...withoutStatus, processed, scheduled, steps };
+    return { ...withoutStatus, processed, scheduled, steps, wallStopped };
   }
   const status = response.status ?? (await getProjectionStatusCommand()).status;
-  return { ...response, processed, scheduled, status, steps };
+  return { ...response, processed, scheduled, status, steps, wallStopped };
 }
 async function setProjectionCutoverCommand(input) {
   const { enabled, target } = input;
@@ -16888,6 +16903,13 @@ function parseProjectionMaxSteps(value) {
   }
   return maxSteps;
 }
+function parseProjectionWallMs(value) {
+  const wallMs = Number(value);
+  if (!Number.isSafeInteger(wallMs) || wallMs < PROJECTION_WALL_MS_MIN || wallMs > PROJECTION_WALL_MS_MAX) {
+    throw new Error(`--wall-ms must be a whole number of milliseconds from ${PROJECTION_WALL_MS_MIN} through ${PROJECTION_WALL_MS_MAX}`);
+  }
+  return wallMs;
+}
 function parseProjectionTarget(value) {
   if (value !== "artist_qualification" && value !== "crawl_due_work" && value !== "public_aggregates" && value !== "track_due_work") {
     throw new Error("--target must be artist_qualification, crawl_due_work, public_aggregates, or track_due_work");
@@ -16915,7 +16937,7 @@ function projectionStatusLines(status) {
     row("Artist qualification", status.projections.artistQualification, status.cutovers.publicProjections)
   ];
 }
-var PROJECTION_MAX_STEPS = 100;
+var PROJECTION_MAX_STEPS = 100, PROJECTION_WALL_MS_MIN = 1000, PROJECTION_WALL_MS_MAX = 600000;
 var init_admin_projections2 = __esm(() => {
   init_orpc();
   init_api();
@@ -21744,7 +21766,7 @@ JSON field reference:
     console.log(projectionStatusLines(result.status).join(`
 `));
   });
-  adminProjections.command("advance").description("Run bounded, resumable rebuild, repair, or audit steps").requiredOption("--target <target>", "track_due_work, crawl_due_work, public_aggregates, or artist_qualification").requiredOption("--action <action>", "rebuild, repair, or audit").option("--limit <limit>", "Maximum rows or repairs in this request (1-500)", "100").option("--max-steps <steps>", "Maximum sequential advance calls (1-100)").option("--no-terminal-status", "Omit the terminal readiness snapshot (JSON repair automation only)").option("--json", "Print the aggregate result and default readiness as JSON", false).action(async (options) => {
+  adminProjections.command("advance").description("Run bounded, resumable rebuild, repair, or audit steps").requiredOption("--target <target>", "track_due_work, crawl_due_work, public_aggregates, or artist_qualification").requiredOption("--action <action>", "rebuild, repair, or audit").option("--limit <limit>", "Maximum rows or repairs in this request (1-500)", "100").option("--max-steps <steps>", "Maximum sequential advance calls (1-100)").option("--wall-ms <ms>", "Stop issuing further steps once this many milliseconds have elapsed (1000-600000)").option("--no-terminal-status", "Omit the terminal readiness snapshot (JSON repair automation only)").option("--json", "Print the aggregate result and default readiness as JSON", false).action(async (options) => {
     const projections = await Promise.resolve().then(() => (init_admin_projections2(), {}));
     const action = parseProjectionAction(options.action);
     if (!options.terminalStatus && (!options.json || action !== "repair")) {
@@ -21755,13 +21777,14 @@ JSON field reference:
       includeTerminalStatus: options.terminalStatus,
       limit: parseProjectionLimit(options.limit),
       maxSteps: options.maxSteps === undefined ? undefined : parseProjectionMaxSteps(options.maxSteps),
-      target: parseProjectionTarget(options.target)
+      target: parseProjectionTarget(options.target),
+      wallMs: options.wallMs === undefined ? undefined : parseProjectionWallMs(options.wallMs)
     });
     if (options.json) {
       printJson(result);
       return;
     }
-    console.log(`${result.target} ${result.action}: steps ${result.steps}, processed ${result.processed}, scheduled ${result.scheduled}, ${result.complete ? "complete" : "more work remains"}.`);
+    console.log(`${result.target} ${result.action}: steps ${result.steps}, processed ${result.processed}, scheduled ${result.scheduled}, ${result.complete ? "complete" : result.wallStopped ? "wall budget spent, more work remains" : "more work remains"}.`);
   });
   adminProjections.command("set").description("Open or close one readiness-gated projection cutover").requiredOption("--target <target>", "track_due_work, crawl_due_work, or public_projections").requiredOption("--enabled <boolean>", "true opens; false closes unconditionally").option("--json", "Print the stored flag and current readiness as JSON", false).action(async (options) => {
     const projections = await Promise.resolve().then(() => (init_admin_projections2(), {}));
@@ -25820,6 +25843,7 @@ var stringOptions = new Set([
   "--video-url",
   "--view",
   "--voice-id",
+  "--wall-ms",
   "--window-since",
   "--window-until"
 ]);

package/package.json

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