docs: update tui task snapshot comments

This commit is contained in:
Keisuke Hirata 2026-06-05 12:23:12 +09:00
parent 5469335de9
commit c2ed71a388
No known key found for this signature in database

View File

@ -1,8 +1,8 @@
//! In-TUI mirror of the session-lifetime task store. //! In-TUI mirror of the session-lifetime task store.
//! //!
//! This deliberately does NOT depend on the Pod TaskStore. The TUI is a //! This deliberately does NOT depend on the Pod TaskStore. The TUI is a
//! presentation layer; pulling in `tools` would drag along `llm-worker` //! presentation layer; pulling in `pod` would drag along the runtime
//! and the whole tool surface. Instead we mirror the small subset we //! feature surface. Instead we mirror the small subset we
//! need: //! need:
//! //!
//! - `TaskEntry` / `TaskStatus`: shaped to round-trip with Pod Task JSON //! - `TaskEntry` / `TaskStatus`: shaped to round-trip with Pod Task JSON
@ -12,9 +12,9 @@
//! tool-call arguments and the `[Session TaskStore snapshot]` system //! tool-call arguments and the `[Session TaskStore snapshot]` system
//! message that compaction emits. //! message that compaction emits.
//! //!
//! The snapshot text format is owned by `tools::render_snapshot`. Since //! The snapshot text format is owned by the Pod Task feature. The TUI keeps
//! `tools` itself parses it back on resume, the shape is a stable //! local compatibility fixtures for the `[Session TaskStore snapshot]` system
//! contract. //! message shape emitted during compaction and restored on resume.
use serde::Deserialize; use serde::Deserialize;
@ -236,8 +236,8 @@ mod tests {
assert_eq!(c.active(), 2); assert_eq!(c.active(), 2);
} }
/// Snapshot text matches the wrapping `Pod::try_pre_run_compact` / /// Snapshot text matches the wrapping `Pod::try_pre_run_compact` and the
/// `tools::render_snapshot` produce: header line, blank, overview /// Pod Task feature snapshot fixture shape: header line, blank, overview
/// line, blank, fenced JSON, trailing prose. /// line, blank, fenced JSON, trailing prose.
fn wrap_snapshot(json_body: &str, overview: &str) -> String { fn wrap_snapshot(json_body: &str, overview: &str) -> String {
format!( format!(