fluncle 0.229.0 → 0.231.0

package/bin/fluncle.mjs

@@ -612,7 +612,7 @@ function parseVersion(version) {
 var currentVersion;
 var init_version = __esm(() => {
   init_output();
-  currentVersion = "0.229.0".trim() ? "0.229.0".trim() : "0.1.0";
+  currentVersion = "0.231.0".trim() ? "0.231.0".trim() : "0.1.0";
 });
 
 // src/update-notifier.ts
@@ -2457,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.229.0".trim() ? "0.229.0".trim() : "0.1.0";
+  currentVersion2 = "0.231.0".trim() ? "0.231.0".trim() : "0.1.0";
 });
 
 // ../../packages/registry/src/index.ts
@@ -3616,7 +3616,7 @@ var init_src = __esm(() => {
       ],
       kind: "cron",
       name: "cron.device-mirror",
-      operatorNotes: "hourly, run by a host systemd timer (docs/agents/hermes/device-mirror-timer/). Explicitly synchronizes one restart-safe local embedded replica, materializes the anchored track IDs once, derives and validates one allowlisted generation locally, then stages bounded changes and atomically cuts the complete verified generation into the shared device database. Sync, derivation, upload, validation, or cutover failure leaves the previous generation visible; rebuilding the target database remains forbidden because it would reset the libSQL replication log and force every device to bootstrap again. A schema-version mismatch stops for an operator migration. Zero LLM tokens. Source: docs/agents/hermes/scripts/device-mirror.*. See docs/planning/offline-first-mobile-research.md.",
+      operatorNotes: "hourly, run by a host systemd timer (docs/agents/hermes/device-mirror-timer/). Explicitly synchronizes one restart-safe local embedded replica, materializes the anchored track IDs once, derives and validates one allowlisted generation locally, then stages bounded changes and atomically cuts the complete verified generation into the shared device database. Sync, derivation, upload, validation, or cutover failure leaves the previous generation visible; rebuilding the target database remains forbidden because it would reset the libSQL replication log and force every device to bootstrap again. A schema-version mismatch stops for an operator migration. Zero LLM tokens. Source: docs/agents/hermes/scripts/device-mirror.*.",
       probeConfig: {
         cadenceMs: 60 * MINUTE_MS,
         cronName: "fluncle-device-mirror",
@@ -4009,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" }
     },
@@ -15079,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(),
@@ -16630,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;
@@ -16642,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 };
 }
@@ -22231,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.229.0"
+  "version": "0.231.0"
 }