cctally 1.92.0 → 1.92.2

package/bin/_cctally_parser.py

@@ -3382,6 +3382,25 @@ def _build_stats_epoch_rebuild_parser(subparsers, name, *, help_text, xref=None)
     )
     worker.set_defaults(func=c.cmd_stats_epoch_rebuild_internal)
 
+def _build_stats_corruption_heal_parser(subparsers, name, *, help_text, xref=None):
+    """Build the #496 S3 detached stats corruption-heal worker parser."""
+    c = _cctally()
+    worker = subparsers.add_parser(
+        name,
+        help=help_text,
+        formatter_class=CLIHelpFormatter,
+        description=textwrap.dedent(
+                    """\
+                    Internal subcommand: rebuild a corrupt stats index from the
+                    journal under its own maintenance-exclusive hold. Spawned by
+                    the classifier-gated corruption heal so no statusline render
+                    and no dashboard start blocks on the rebuild. Always returns
+                    0; failures are logged and remain retryable.
+                    """
+                ),
+    )
+    worker.set_defaults(func=c.cmd_stats_corruption_heal_internal)
+
 def _build_codex_replay_drain_parser(subparsers, name, *, help_text, xref=None):
     """Build the `_codex-replay-drain` parser (public #5 §4)."""
     c = _cctally()
@@ -3484,6 +3503,7 @@ _REGISTRATION = (
     _Reg('_telemetry-beat', _build_telemetry_beat_parser, argparse.SUPPRESS, None, None),
     _Reg('_codex-quota-verify', _build_codex_quota_verify_parser, argparse.SUPPRESS, None, None),
     _Reg('_stats-epoch-rebuild', _build_stats_epoch_rebuild_parser, argparse.SUPPRESS, None, None),
+    _Reg('_stats-corruption-heal', _build_stats_corruption_heal_parser, argparse.SUPPRESS, None, None),
     _Reg('_codex-replay-drain', _build_codex_replay_drain_parser, argparse.SUPPRESS, None, None),
     _Reg('repair-symlinks', _build_repair_symlinks_parser, argparse.SUPPRESS, None, None),
 )

package/bin/_cctally_quota.py

@@ -717,7 +717,7 @@ def _blocks_missing_reverse_map(stats_conn: sqlite3.Connection) -> bool:
 
     A scoped sweep matches on ``physical_group_key``, so a NULL there would
     silently escape it and the stale block would survive indefinitely. The
-    epoch rebuild (1005 introduced the column; current epoch 1007) stamps every row, and
+    epoch rebuild (1005 introduced the column; current epoch 1008) stamps every row, and
     this is the guard that turns the
     one shape it cannot reach — a block written by an older binary against an
     already-current index — into a full pass rather than a missed one.
@@ -2129,7 +2129,7 @@ def _apply_quota_projection_rows(
     schedule_boundary = min(stored_schedule.values(), default=None)
     # A scalar-only boundary is a legacy/fail-safe state with unknown ownership.
     # Keep the prior behavior until a qualifying whole-history pass can retire
-    # it; epoch-1007 indexes normally never enter this branch.
+    # it; current-epoch indexes normally never enter this branch.
     legacy_boundary = stored_boundary if not stored_next_evaluation_by_root else None
     boundary = (
         None if schedule_boundary is None

package/bin/_cctally_statusline.py

@@ -771,7 +771,7 @@ def _read_db_projection_stable(*, attempts: int = 3) -> "_candidates.DbProjectio
         before = _db_file_fingerprint()
         try:
             projection = _read_db_projection_once()
-        except _cctally().StatsEpochRebuildDeferred:
+        except _cctally().StatsRebuildDeferred:
             return _candidates.DbProjection(None, None, db_files=before)
         after = _db_file_fingerprint()
         if before == after and after["main"] is not None:
@@ -1012,7 +1012,7 @@ def _authoritative_record_usage(
 
     try:
         rc = _cctally().cmd_record_usage(args)
-    except _cctally().StatsEpochRebuildDeferred as exc:
+    except _cctally().StatsRebuildDeferred as exc:
         return _AuthoritativeRecordResult("record_failed", str(exc))
     except Exception as exc:
         return _AuthoritativeRecordResult("record_failed", str(exc))
@@ -1172,7 +1172,7 @@ def _statusline_reduce_and_publish() -> "_candidates.ReductionDecision | None":
         record_rc = _cctally().cmd_record_usage(
             args, ingest_mode="opportunistic"
         )
-    except _cctally().StatsEpochRebuildDeferred:
+    except _cctally().StatsRebuildDeferred:
         return decision
     if record_rc != 0:
         return decision
@@ -1597,7 +1597,7 @@ def _build_statusline_injections(warn_once):
                     range_start - c.BLOCK_DURATION, now + c.BLOCK_DURATION,
                 )
             )
-        except c.StatsEpochRebuildDeferred:
+        except c.StatsRebuildDeferred:
             recorded_windows, block_start_overrides, canonical_intervals = (
                 [], {}, {},
             )
@@ -1637,7 +1637,7 @@ def _build_statusline_injections(warn_once):
         _acct_params = () if _sl_account is None else (_sl_account,)
         try:
             conn = open_db()
-        except c.StatsEpochRebuildDeferred:
+        except c.StatsRebuildDeferred:
             return (None, None)
         except Exception:
             return (None, None)
@@ -1724,7 +1724,7 @@ def _build_statusline_injections(warn_once):
     def _db_latest_rate_limits():
         try:
             conn = open_db()
-        except _cctally().StatsEpochRebuildDeferred:
+        except _cctally().StatsRebuildDeferred:
             return None
         except Exception:
             return None