desktop/src-tauri/crates/core/src/adapters/pi/mod.rs

Comment 1, line 1

//! pi (pi-coding-agent) adapter; layout: architecture.md#adapter-layout.

//! V30 moved the former root adapters/pi.rs into an independent directory.

//! - Stable product entry point implementing/re-exporting the common interface.

//! - [`detect`]: product/format detection and version selection.

//! - [`versions`]: verified registry; unregistered numeric versions try the latest reader.

//!   Only fixed-source-confirmed incompatible v1/v2/missing versions reject before parsing.

//! - Keep historical format implementations in this directory, without root-level single files.

//!

//! [`versions::session_v3`] headers retain fixed pi-mono b4559750 and local test references.

//! pi/omp shared usage parsing/event construction lives with scanning in

//! [`versions::session_v3`] and is re-exported here; cross-product map_pi_family stays in

//! root usage_map.rs.

// Re-export former root pi.rs pub(crate) helpers to preserve internal pi/omp paths.

// map_cost is local to this directory and is not re-exported.

/// Stateless pi adapter.

// Use sessions directories as instance roots; the framework deduplicates identical instances.

// Manual roots containing sessions resolve to that child; otherwise use the root itself.

// Enumerate JSONL at depth two, including encoded-cwd children and files directly in sessions.

// Current attempted versions share session_v3; the reader checks session-header versions

// and diagnoses known incompatibilities. Future distinct implementations require dispatch here.