✨ Add file failure counter reset helpers

bitlogger/BitLogger_test.mbt

@@ -380,6 +380,11 @@ test "configured logger can reopen built file sink" {
     inspect(logger.file_append_mode(), content="false")
     inspect(logger.file_reopen_append(), content="true")
     inspect(logger.file_append_mode(), content="true")
+    inspect(logger.file_reset_failure_counters(), content="true")
+    inspect(logger.file_open_failures(), content="0")
+    inspect(logger.file_write_failures(), content="0")
+    inspect(logger.file_flush_failures(), content="0")
+    inspect(logger.file_rotation_failures(), content="0")
     inspect(logger.close(), content="true")
   } else {
     inspect(logger.file_append_mode(), content="true")
@@ -395,9 +400,19 @@ test "configured logger can reopen built file sink" {
     inspect(logger.file_reopen_append(), content="false")
     inspect(logger.file_append_mode(), content="true")
     inspect(logger.file_open_failures(), content="4")
+    inspect(logger.file_reset_failure_counters(), content="true")
+    inspect(logger.file_open_failures(), content="0")
+    inspect(logger.file_write_failures(), content="0")
+    inspect(logger.file_flush_failures(), content="0")
+    inspect(logger.file_rotation_failures(), content="0")
   }
 }
 
+test "configured non-file logger cannot reset file failure counters" {
+  let logger = build_logger(LoggerConfig::new(sink=SinkConfig::new(kind=SinkKind::Console)))
+  inspect(logger.file_reset_failure_counters(), content="false")
+}
+
 test "configured logger exposes file flush and close helpers" {
   let logger = build_logger(
     LoggerConfig::new(

bitlogger/BitLogger_wbtest.mbt

@@ -191,6 +191,11 @@ test "file sink reopen and failure counters reflect backend state" {
     inspect(sink.append_mode(), content="false")
     inspect(sink.reopen_append(), content="true")
     inspect(sink.append_mode(), content="true")
+    sink.reset_failure_counters()
+    inspect(sink.open_failures(), content="0")
+    inspect(sink.write_failures(), content="0")
+    inspect(sink.flush_failures(), content="0")
+    inspect(sink.rotation_failures(), content="0")
     inspect(sink.close(), content="true")
     ignore(remove_file_internal("bitlogger-reopen.log"))
   } else {
@@ -208,6 +213,11 @@ test "file sink reopen and failure counters reflect backend state" {
     inspect(sink.reopen_append(), content="false")
     inspect(sink.append_mode(), content="true")
     inspect(sink.open_failures(), content="4")
+    sink.reset_failure_counters()
+    inspect(sink.open_failures(), content="0")
+    inspect(sink.write_failures(), content="0")
+    inspect(sink.flush_failures(), content="0")
+    inspect(sink.rotation_failures(), content="0")
   }
 }
 

bitlogger/README.mbt.md

@@ -242,9 +242,11 @@ test {
 - `path()` and `auto_flush_enabled()` expose core file sink policy state / `path()` 与 `auto_flush_enabled()` 可读取 file sink 的基础策略状态
 - `rotation_enabled()` and `rotation_config()` expose whether rotation is active and which settings are currently applied / `rotation_enabled()` 与 `rotation_config()` 可读取 rotation 是否启用及当前配置参数
 - `state()` exposes a single file-sink snapshot including path, availability, append policy, auto-flush, rotation config, and failure counters / `state()` 可一次性读取包含 path、availability、append、auto-flush、rotation 配置与失败计数的 file sink 快照
+- `reset_failure_counters()` clears the open/write/flush/rotation counters after diagnostics or recovery / `reset_failure_counters()` 可在排障或恢复后清空 open/write/flush/rotation 失败计数
 - `file_sink_state_to_json(...)` / `stringify_file_sink_state(...)` and `runtime_file_state_to_json(...)` / `stringify_runtime_file_state(...)` export snapshots as JSON / `file_sink_state_to_json(...)` / `stringify_file_sink_state(...)` 与 `runtime_file_state_to_json(...)` / `stringify_runtime_file_state(...)` 可将快照直接导出为 JSON
 - `set_auto_flush(...)`, `set_rotation(...)`, and `clear_rotation()` allow runtime tuning of core file sink policies / `set_auto_flush(...)`、`set_rotation(...)`、`clear_rotation()` 可在运行期调整 file sink 的基础策略
 - `open_failures()`、`write_failures()`、`flush_failures()`、`rotation_failures()` expose basic sink health counters / `open_failures()`、`write_failures()`、`flush_failures()`、`rotation_failures()` 可用于观察基础 sink 健康状态
 - `ConfiguredLogger` also forwards file reopen, flush, close, append-mode, path, auto-flush, rotation-config, state snapshot, append setter, policy setter, and failure-counter helpers for config-built file sinks / `ConfiguredLogger` 也会为配置生成的 file sink 转发 reopen、flush、close、append-mode、path、auto-flush、rotation 配置、state 快照、append setter、策略 setter 与失败计数访问器
 - `ConfiguredLogger::file_runtime_state()` also reports whether a file sink is queue-wrapped and exposes the outer queue pending/drop counters together with the inner file snapshot / `ConfiguredLogger::file_runtime_state()` 还可报告 file sink 是否被 queue 包装，并将外层 queue 的 pending/drop 计数与内层 file 快照一起返回
+- `ConfiguredLogger::file_reset_failure_counters()` also clears file failure counters through the config-built control surface / `ConfiguredLogger::file_reset_failure_counters()` 也可通过配置式控制面清空 file 失败计数
 - current scope is observability-first, not a full self-healing sink runtime / 当前定位仍以可观测性优先，不是完整自愈型 sink runtime

bitlogger/config.mbt

@@ -470,6 +470,20 @@ pub fn RuntimeSink::file_rotation_failures(self : RuntimeSink) -> Int {
   }
 }
 
+pub fn RuntimeSink::file_reset_failure_counters(self : RuntimeSink) -> Bool {
+  match self {
+    File(sink) => {
+      sink.reset_failure_counters()
+      true
+    }
+    QueuedFile(sink) => {
+      sink.sink.reset_failure_counters()
+      true
+    }
+    _ => false
+  }
+}
+
 pub fn RuntimeSink::file_state(self : RuntimeSink) -> FileSinkState {
   match self {
     File(sink) => sink.state()
@@ -608,6 +622,10 @@ pub fn ConfiguredLogger::file_rotation_failures(self : ConfiguredLogger) -> Int
   self.sink.file_rotation_failures()
 }
 
+pub fn ConfiguredLogger::file_reset_failure_counters(self : ConfiguredLogger) -> Bool {
+  self.sink.file_reset_failure_counters()
+}
+
 pub fn ConfiguredLogger::file_state(self : ConfiguredLogger) -> FileSinkState {
   self.sink.file_state()
 }

bitlogger/sinks.mbt

@@ -213,6 +213,13 @@ pub fn FileSink::flush_failures(self : FileSink) -> Int {
   self.flush_failures.val
 }
 
+pub fn FileSink::reset_failure_counters(self : FileSink) -> Unit {
+  self.open_failures.val = 0
+  self.write_failures.val = 0
+  self.flush_failures.val = 0
+  self.rotation_failures.val = 0
+}
+
 pub fn FileSink::state(self : FileSink) -> FileSinkState {
   {
     path: self.path,