✨ Add file path and auto-flush introspection

README.md

@@ -223,7 +223,8 @@ if native_files_supported() {
 - `sink.rotation` 当前支持 `max_bytes` 与 `max_backups`，提供基础 size-based rotation 和 backup retention
 - `file_sink(...)` 还提供 `reopen()`、`open_failures()`、`write_failures()`、`flush_failures()`、`rotation_failures()`，用于基础可观测性
 - `file_sink(...)` 当前还提供 `append_mode()`；`reopen(append=...)` 在显式传值时会更新后续 reopen 使用的 append 策略
-- `build_logger(...)` 产出的 `ConfiguredLogger` 同样提供 `file_reopen()`、`file_flush()`、`file_close()`、`file_append_mode()` 与对应 file failure 计数访问器，便于配置式接入后继续运维控制
+- `file_sink(...)` 也可直接读取 `path()` 与 `auto_flush_enabled()` 等基础 file 策略状态
+- `build_logger(...)` 产出的 `ConfiguredLogger` 同样提供 `file_reopen()`、`file_flush()`、`file_close()`、`file_append_mode()`、`file_path()`、`file_auto_flush()` 与对应 file failure 计数访问器，便于配置式接入后继续运维控制
 - `sink.text_formatter.template` 当前支持固定 token：`{timestamp}`、`{timestamp_ms}`、`{level}`、`{target}`、`{message}`、`{fields}`
 - 当前可由配置直接组装的 sink 类型：`console`、`json_console`、`text_console`、`file`
 - `queue` 会作为显式包装层附着在最终 sink 外侧；这仍然是同步 drain 模型，不是 async runtime

bitlogger/BitLogger_test.mbt

@@ -198,11 +198,17 @@ test "configured logger reports dropped_count for bounded queue" {
 test "configured logger exposes file sink observability helpers" {
   let logger = build_logger(
     LoggerConfig::new(
-      sink=SinkConfig::new(kind=SinkKind::File, path="config-file.log"),
+      sink=SinkConfig::new(
+        kind=SinkKind::File,
+        path="config-file.log",
+        auto_flush=false,
+      ),
     ),
   )
   inspect(logger.file_available() == native_files_supported(), content="true")
+  inspect(logger.file_path(), content="config-file.log")
   inspect(logger.file_append_mode(), content="true")
+  inspect(logger.file_auto_flush(), content="false")
   inspect(logger.file_open_failures(), content=if logger.file_available() { "0" } else { "1" })
   inspect(logger.file_write_failures(), content="0")
   inspect(logger.file_flush_failures(), content="0")

bitlogger/BitLogger_wbtest.mbt

@@ -89,8 +89,10 @@ test "native file support flag is queryable" {
 
 test "file sink availability reflects backend support" {
   let sink = file_sink("bitlogger-test.log")
+  inspect(sink.path(), content="bitlogger-test.log")
   inspect(sink.is_available() == native_files_supported(), content="true")
   inspect(sink.append_mode(), content="true")
+  inspect(sink.auto_flush_enabled(), content="true")
   inspect(sink.open_failures(), content=if sink.is_available() { "0" } else { "1" })
   inspect(sink.write_failures(), content="0")
   inspect(sink.flush_failures(), content="0")

bitlogger/README.mbt.md

@@ -222,6 +222,7 @@ test {
 - JSON config uses `sink.rotation.max_bytes` and `sink.rotation.max_backups` / JSON 配置使用 `sink.rotation.max_bytes` 与 `sink.rotation.max_backups`
 - `FileSink::reopen()` can explicitly reopen the current file handle / `FileSink::reopen()` 可显式重开当前文件句柄
 - `append_mode()` exposes the current append policy, and `reopen(append=...)` updates that policy for later reopen calls / `append_mode()` 可读取当前 append 策略，`reopen(append=...)` 会更新后续 reopen 复用的 append 策略
+- `path()` and `auto_flush_enabled()` expose core file sink policy state / `path()` 与 `auto_flush_enabled()` 可读取 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, and failure-counter helpers for config-built file sinks / `ConfiguredLogger` 也会为配置生成的 file sink 转发 reopen、flush、close、append-mode 与失败计数访问器
+- `ConfiguredLogger` also forwards file reopen, flush, close, append-mode, path, auto-flush, and failure-counter helpers for config-built file sinks / `ConfiguredLogger` 也会为配置生成的 file sink 转发 reopen、flush、close、append-mode、path、auto-flush 与失败计数访问器
 - current scope is observability-first, not a full self-healing sink runtime / 当前定位仍以可观测性优先，不是完整自愈型 sink runtime

bitlogger/config.mbt

@@ -239,6 +239,22 @@ pub fn RuntimeSink::file_append_mode(self : RuntimeSink) -> Bool {
   }
 }
 
+pub fn RuntimeSink::file_path(self : RuntimeSink) -> String {
+  match self {
+    File(sink) => sink.path()
+    QueuedFile(sink) => sink.sink.path()
+    _ => ""
+  }
+}
+
+pub fn RuntimeSink::file_auto_flush(self : RuntimeSink) -> Bool {
+  match self {
+    File(sink) => sink.auto_flush_enabled()
+    QueuedFile(sink) => sink.sink.auto_flush_enabled()
+    _ => false
+  }
+}
+
 pub fn RuntimeSink::file_flush(self : RuntimeSink) -> Bool {
   match self {
     File(sink) => sink.flush()
@@ -327,6 +343,14 @@ pub fn ConfiguredLogger::file_append_mode(self : ConfiguredLogger) -> Bool {
   self.sink.file_append_mode()
 }
 
+pub fn ConfiguredLogger::file_path(self : ConfiguredLogger) -> String {
+  self.sink.file_path()
+}
+
+pub fn ConfiguredLogger::file_auto_flush(self : ConfiguredLogger) -> Bool {
+  self.sink.file_auto_flush()
+}
+
 pub fn ConfiguredLogger::file_flush(self : ConfiguredLogger) -> Bool {
   self.sink.file_flush()
 }

bitlogger/sinks.mbt

@@ -118,6 +118,14 @@ pub fn FileSink::append_mode(self : FileSink) -> Bool {
   self.append.val
 }
 
+pub fn FileSink::path(self : FileSink) -> String {
+  self.path
+}
+
+pub fn FileSink::auto_flush_enabled(self : FileSink) -> Bool {
+  self.auto_flush
+}
+
 pub fn FileSink::close(self : FileSink) -> Bool {
   match self.handle.val {
     None => false

docs/README-en.md

@@ -208,7 +208,8 @@ if native_files_supported() {
 - `sink.rotation` currently supports `max_bytes` and `max_backups` for basic size-based rotation and backup retention.
 - `file_sink(...)` also exposes `reopen()`, `open_failures()`, `write_failures()`, `flush_failures()`, and `rotation_failures()` for basic observability.
 - `file_sink(...)` also exposes `append_mode()`. Passing `append=...` to `reopen(...)` updates the current append policy used by later reopen calls.
-- `ConfiguredLogger` built through `build_logger(...)` also exposes `file_reopen()`, `file_flush()`, `file_close()`, `file_append_mode()`, and the corresponding file failure counters, so config-driven file logging keeps a usable control surface.
+- `file_sink(...)` also exposes `path()` and `auto_flush_enabled()` for reading basic file-sink policy state.
+- `ConfiguredLogger` built through `build_logger(...)` also exposes `file_reopen()`, `file_flush()`, `file_close()`, `file_append_mode()`, `file_path()`, `file_auto_flush()`, and the corresponding file failure counters, so config-driven file logging keeps a usable control surface.
 - `sink.text_formatter.template` currently supports fixed tokens: `{timestamp}`, `{timestamp_ms}`, `{level}`, `{target}`, `{message}`, and `{fields}`.
 - Config-driven sink assembly currently supports `console`, `json_console`, `text_console`, and `file`.
 - `queue` remains a synchronous bounded wrapper around the final sink, not an async runtime.

docs/changes/0.3.0.md

@@ -33,6 +33,7 @@ version 0.3.0
 - feat: forward file sink reopen and failure-counter helpers through `RuntimeSink` and `ConfiguredLogger`
 - feat: add explicit `file_flush()` and `file_close()` helpers for config-built file sinks, including queued file sink drain-before-close behavior
 - feat: make file append mode queryable via `append_mode()` / `file_append_mode()` and persist explicit `reopen(append=...)` mode updates for later reopen calls
+- feat: add `path()` / `auto_flush_enabled()` on `FileSink` and `file_path()` / `file_auto_flush()` on `ConfiguredLogger` for basic file-policy introspection
 - feat: add `SplitSink`, `split_sink(...)`, and `split_by_level(...)` for routing records into different sinks by predicate or level
 - feat: add `Logger::bind(...)` as an ergonomic context-binding alias and `fields(...)` helper for tuple-based field construction
 
@@ -50,6 +51,7 @@ version 0.3.0
 - test: cover config-built file logger reopen and failure-counter helper access
 - test: cover config-built file logger flush/close helpers and queued-file drain semantics
 - test: cover append-mode observability and reopen-mode persistence for direct and config-built file sinks
+- test: cover path and auto-flush introspection for direct and config-built file sinks
 - test: cover split sink predicate routing and level-based routing behavior
 - test: cover `bind(...)` context composition and `fields(...)` helper behavior
 - test: add async logger lifecycle, config roundtrip, and batching/flush policy test seeds
@@ -68,6 +70,7 @@ version 0.3.0
 - docs: clarify that config-built file loggers keep file control and observability helpers
 - docs: document explicit file flush/close helpers for config-built file loggers
 - docs: clarify append-mode observability and reopen append-policy semantics
+- docs: document file path and auto-flush introspection helpers
 - docs: add split sink examples for level-based routing
 - docs: add `bind(...)` examples for reusable context binding
 - docs: update root README and English README with async adapter notes and current scope