Struct PromptScopeKey 

pub struct PromptScopeKey { /* private fields */ }

Typed prompt scope key.

Uniquely identifies a prompt for replay from checkpoint history. Constructed via phase-specific factory methods to enforce required dimensions.

Backward Compatibility

Display output exactly matches the format!() strings previously used in handlers. The recovery_epoch field is NOT part of Display — it is a future-proofing hook and an audit dimension only.

Implementations

impl PromptScopeKey

pub const fn for_planning( iteration: u32, retry_mode: RetryMode, recovery_epoch: u32, ) -> Self

Construct a key for the Planning phase.

pub const fn for_development( iteration: u32, continuation: Option<u32>, retry_mode: RetryMode, recovery_epoch: u32, ) -> Self

Construct a key for the Development phase.

Set continuation to Some(attempt) for continuation mode, or None for normal and retry modes.

pub const fn for_commit( iteration: u32, attempt: u32, retry_mode: RetryMode, recovery_epoch: u32, ) -> Self

Construct a key for the Commit phase.

pub const fn for_review( pass: u32, retry_mode: RetryMode, recovery_epoch: u32, ) -> Self

Construct a key for the Review phase.

pub const fn for_fix( pass: u32, retry_mode: RetryMode, recovery_epoch: u32, ) -> Self

Construct a key for the Fix phase.

pub fn for_conflict_resolution(phase: &str, recovery_epoch: u32) -> Self

Construct a key for a rebase conflict resolution prompt.

The phase argument is the rebase phase name (lowercase), e.g. "planning" or "development", derived from the git rebase context. It is NOT a main pipeline phase — it identifies which rebase phase triggered the conflict.

recovery_epoch is carried for auditing but the rebase handler owns epoch semantics via PromptCaptured events. Pass 0 from effectful helpers.

The Display output ("{phase}_conflict_resolution") is byte-identical to the former format!("{}_conflict_resolution", phase.to_lowercase()) calls, preserving backward-compatibility with existing checkpoint prompt_history maps.

Trait Implementations

impl Clone for PromptScopeKey

fn clone(&self) -> PromptScopeKey

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PromptScopeKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for PromptScopeKey

Display implementation producing strings largely backward-compatible with existing checkpoint data.

Output format per phase:

• Planning: planning_{iter}[_{retry_suffix}]
• Development: development_{iter}[_continuation_{n}][_{retry_suffix}]
• Commit: commit_message_attempt_iter{iter}_{attempt}[_{retry_suffix}] (NOTE: includes iteration; this intentionally differs from pre-RFC-007 attempt-only commit keys)
• Review: review_{pass}[_{retry_suffix}]
• Fix: fix_{pass}[_{retry_suffix}]

Retry suffixes:

• SameAgent { count } → _same_agent_retry_{count}
• Xsd { count } → _xsd_retry_{count}

NOTE: recovery_epoch is intentionally excluded from Display to preserve backward-compatibility with existing checkpoint prompt_history entries.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for PromptScopeKey

fn eq(&self, other: &PromptScopeKey) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for PromptScopeKey

impl StructuralPartialEq for PromptScopeKey