fluncle 0.225.0 → 0.227.0

package/bin/fluncle.mjs

@@ -612,7 +612,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.225.0".trim() ? "0.225.0".trim() : "0.1.0";
+  currentVersion = "0.227.0".trim() ? "0.227.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2454,7 +2454,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.225.0".trim() ? "0.225.0".trim() : "0.1.0";
+  currentVersion2 = "0.227.0".trim() ? "0.227.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3978,6 +3978,23 @@ var init_src = __esm(() => {
       title: "Count check",
       weights: { status: "hidden" }
     },
+    {
+      command: "fluncle admin projections advance --target <public_aggregates|artist_qualification> --action repair --limit 500 --max-steps 4",
+      exposedContent: [
+        "keep the two public projection families converged after cutover with status-gated, bounded repair (--no-agent)"
+      ],
+      kind: "cron",
+      name: "cron.projection-maintenance",
+      operatorNotes: "every 5m with per-firing jitter, run by a rave-02 host systemd timer (docs/agents/hermes/projection-maintenance-timer/). Reads bounded projection status first. A dark shared cutover issues zero repair calls; an open idle cutover also writes nothing. Each affected public family gets at most four sequential repair pages of 500 subjects, with independent failure handling. Public aggregate repair also advances the bounded anchor cursor after marker debt drains. Rebuild, audit, track/crawl repair, and every cutover mutation remain operator-only. Zero LLM tokens; no new secret.",
+      probeConfig: {
+        cadenceMs: 5 * MINUTE_MS,
+        cronName: "fluncle-projection-maintenance",
+        kind: "cron"
+      },
+      statusDescription: "keeps the public catalogue projections caught up",
+      title: "Projection upkeep",
+      weights: { status: "hidden" }
+    },
     {
       command: "fluncle admin reach collect",
       exposedContent: [
@@ -12493,6 +12510,7 @@ var init_admin_projections = __esm(() => {
     tags: ["Admin"]
   }).input(object({
     action: ProjectionStepActionSchema,
+    includeStatus: boolean2().default(true),
     limit: number2().int().min(1).max(PROJECTION_STEP_LIMIT_MAX),
     target: ProjectionTargetSchema
   })).output(object({
@@ -12501,7 +12519,7 @@ var init_admin_projections = __esm(() => {
     ok: literal(true),
     processed: CountSchema,
     scheduled: CountSchema,
-    status: ProjectionStatusSchema,
+    status: ProjectionStatusSchema.optional(),
     target: ProjectionTargetSchema
   }));
   setProjectionCutover = oc.route({
@@ -16560,6 +16578,7 @@ var init_admin_operation_receipts2 = __esm(() => {
 // src/commands/admin-projections.ts
 var exports_admin_projections = {};
 __export(exports_admin_projections, {
+  PROJECTION_MAX_STEPS: () => PROJECTION_MAX_STEPS,
   PROJECTION_STEP_LIMIT_MAX: () => PROJECTION_STEP_LIMIT_MAX,
   advanceProjectionCommand: () => advanceProjectionCommand,
   getProjectionStatusCommand: () => getProjectionStatusCommand,
@@ -16567,6 +16586,7 @@ __export(exports_admin_projections, {
   parseProjectionCutover: () => parseProjectionCutover,
   parseProjectionEnabled: () => parseProjectionEnabled,
   parseProjectionLimit: () => parseProjectionLimit,
+  parseProjectionMaxSteps: () => parseProjectionMaxSteps,
   parseProjectionTarget: () => parseProjectionTarget,
   projectionStatusLines: () => projectionStatusLines,
   setProjectionCutoverCommand: () => setProjectionCutoverCommand
@@ -16575,8 +16595,20 @@ async function getProjectionStatusCommand() {
   return adminApiGet("/api/v1/admin/projections/status");
 }
 async function advanceProjectionCommand(input) {
-  const { target, ...body } = input;
-  return adminApiPost(`/api/v1/admin/projections/${target}/advance`, body);
+  const { maxSteps = 1, target, ...body } = input;
+  const stepBody = maxSteps > 1 ? { ...body, includeStatus: false } : body;
+  let response = await adminApiPost(`/api/v1/admin/projections/${target}/advance`, stepBody);
+  let steps = 1;
+  let processed = response.processed;
+  let scheduled = response.scheduled;
+  while (!response.complete && steps < maxSteps) {
+    response = await adminApiPost(`/api/v1/admin/projections/${target}/advance`, stepBody);
+    steps += 1;
+    processed += response.processed;
+    scheduled += response.scheduled;
+  }
+  const status = response.status ?? (await getProjectionStatusCommand()).status;
+  return { ...response, processed, scheduled, status, steps };
 }
 async function setProjectionCutoverCommand(input) {
   const { enabled, target } = input;
@@ -16595,6 +16627,13 @@ function parseProjectionLimit(value) {
   }
   return limit;
 }
+function parseProjectionMaxSteps(value) {
+  const maxSteps = Number(value);
+  if (!Number.isSafeInteger(maxSteps) || maxSteps < 1 || maxSteps > PROJECTION_MAX_STEPS) {
+    throw new Error(`--max-steps must be a whole number from 1 through ${PROJECTION_MAX_STEPS}`);
+  }
+  return maxSteps;
+}
 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");
@@ -16622,6 +16661,7 @@ function projectionStatusLines(status) {
     row("Artist qualification", status.projections.artistQualification, status.cutovers.publicProjections)
   ];
 }
+var PROJECTION_MAX_STEPS = 100;
 var init_admin_projections2 = __esm(() => {
   init_orpc();
   init_api();
@@ -22156,18 +22196,19 @@ JSON field reference:
     console.log(projections.projectionStatusLines(result.status).join(`
 `));
   });
-  adminProjections.command("advance").description("Run one bounded, resumable rebuild, repair, or audit step").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("--json", "Print the step result and current 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("--json", "Print the aggregate result and current readiness as JSON", false).action(async (options) => {
     const projections = await Promise.resolve().then(() => (init_admin_projections2(), exports_admin_projections));
     const result = await projections.advanceProjectionCommand({
       action: projections.parseProjectionAction(options.action),
       limit: projections.parseProjectionLimit(options.limit),
+      maxSteps: options.maxSteps === undefined ? undefined : projections.parseProjectionMaxSteps(options.maxSteps),
       target: projections.parseProjectionTarget(options.target)
     });
     if (options.json) {
       printJson(result);
       return;
     }
-    console.log(`${result.target} ${result.action}: 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" : "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(), exports_admin_projections));
@@ -26061,6 +26102,7 @@ var stringOptions = new Set([
   "--lens",
   "--limit",
   "--max-hop",
+  "--max-steps",
   "--max-overlap",
   "--metrics",
   "--missing-field",

package/package.json

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