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

Comment 1, line 1

//! Detect pi and select its version: read the first line within limits, verify the

//! type=session header, then select an implementation through [super::versions].

//!

//! Rules: architecture.md#unknown-version, V30.

//! - A non-JSON/non-session first line is UnknownFormat; reject it rather than

//!   guessing how to parse arbitrary files.

//! - Registered version 3 uses KnownVersion; unregistered integers such as 4

//!   use LatestFallback with compatibility metadata.

//! - Source-verified incompatible versions 1/2 and missing versions from the

//!   legacy v1/v2 format use UnsupportedVersion without fallback.

/// Detect a pi session file and select through the registry.

// Agent/input type is verified. Noninteger and absent versions both become None;

// registry dispatch rejects the verified incompatible legacy format that lacks version.