fluncle 0.228.0 → 0.230.0

package/bin/fluncle.mjs

@@ -612,7 +612,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.228.0".trim() ? "0.228.0".trim() : "0.1.0";
+  currentVersion = "0.230.0".trim() ? "0.230.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2362,7 +2362,10 @@ var init_about = __esm(() => {
       heading: "The mothership",
       links: [
         { label: "Web: the archive", url: "https://www.fluncle.com" },
-        { label: "Newsletter", url: "Fresh bangers, every Friday. Sign up at www.fluncle.com" },
+        {
+          label: "Newsletter",
+          url: "Fresh bangers, every Friday, from Fluncle. Board it at www.fluncle.com"
+        },
         { label: "RSS: the feed", url: "https://www.fluncle.com/rss.xml" }
       ]
     },
@@ -2454,7 +2457,7 @@ function parseVersion2(version) {
 var currentVersion2, latestReleaseUrl = "https://api.github.com/repos/mauricekleine/fluncle/releases/latest";
 var init_version2 = __esm(() => {
   init_output();
-  currentVersion2 = "0.228.0".trim() ? "0.228.0".trim() : "0.1.0";
+  currentVersion2 = "0.230.0".trim() ? "0.230.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -4006,19 +4009,19 @@ var init_src = __esm(() => {
       weights: { status: "hidden" }
     },
     {
-      command: "fluncle admin projections advance --target <public_aggregates|artist_qualification> --action repair --limit 500 --max-steps 4",
+      command: "fluncle admin projections get --json; fluncle admin projections advance --target <track_due_work|crawl_due_work> --action repair --limit 500 --max-steps 20 --no-terminal-status --json; fluncle admin projections advance --target <public_aggregates|artist_qualification> --action repair --limit 500 --max-steps 4 --no-terminal-status --json",
       exposedContent: [
-        "keep the two public projection families converged after cutover with status-gated, bounded repair (--no-agent)"
+        "keep all four runtime projection families converged after their cutovers with one-read, serial, 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.",
+      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 exactly once; the track, crawl, and public cutovers gate their own families independently. Open indebted families run strictly serially: track and crawl get at most twenty pages of 500, then public aggregates and artist qualification get at most four pages of 500. Repair responses omit terminal status so those four commands cannot repeat the global status suite. Public aggregate repair also advances the bounded anchor cursor after marker debt drains. The agent may repair only these four fixed targets; rebuild, audit, 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",
+      statusDescription: "keeps runtime projections caught up",
       title: "Projection upkeep",
       weights: { status: "hidden" }
     },
@@ -15076,7 +15079,7 @@ var init_admin_telemetry2 = __esm(() => {
     errors: number2().int().nullable(),
     exitCode: number2().int(),
     expectedIntervalMs: number2().int().nullable(),
-    gateState: _enum(["active", "disabled", "dry-run", "forced", "locked", "paused"]).nullable(),
+    gateState: _enum(["active", "admission-skipped", "disabled", "dry-run", "forced", "locked", "paused"]).nullable(),
     id: string2(),
     missingFields: array(string2()),
     occurredAt: string2(),
@@ -16627,8 +16630,11 @@ async function getProjectionStatusCommand() {
   return adminApiGet("/api/v1/admin/projections/status");
 }
 async function advanceProjectionCommand(input) {
-  const { maxSteps = 1, target, ...body } = input;
-  const stepBody = maxSteps > 1 ? { ...body, includeStatus: false } : body;
+  const { includeTerminalStatus = true, maxSteps = 1, target, ...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;
   let response = await adminApiPost(`/api/v1/admin/projections/${target}/advance`, stepBody);
   let steps = 1;
   let processed = response.processed;
@@ -16639,6 +16645,10 @@ async function advanceProjectionCommand(input) {
     processed += response.processed;
     scheduled += response.scheduled;
   }
+  if (!includeTerminalStatus) {
+    const { status: _status, ...withoutStatus } = response;
+    return { ...withoutStatus, processed, scheduled, steps };
+  }
   const status = response.status ?? (await getProjectionStatusCommand()).status;
   return { ...response, processed, scheduled, status, steps };
 }
@@ -22228,10 +22238,15 @@ JSON field reference:
     console.log(projections.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("--json", "Print the aggregate 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("--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(), exports_admin_projections));
+    const action = projections.parseProjectionAction(options.action);
+    if (!options.terminalStatus && (!options.json || action !== "repair")) {
+      throw new Error("--no-terminal-status requires --action repair and --json");
+    }
     const result = await projections.advanceProjectionCommand({
-      action: projections.parseProjectionAction(options.action),
+      action,
+      includeTerminalStatus: options.terminalStatus,
       limit: projections.parseProjectionLimit(options.limit),
       maxSteps: options.maxSteps === undefined ? undefined : projections.parseProjectionMaxSteps(options.maxSteps),
       target: projections.parseProjectionTarget(options.target)

package/package.json

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