Module session_review 

Durable session-scoped review findings for sticky reply / multi-scenario review.

First principles

Review exists to independently verify claim↔record, persist findings beside the session transcript, and drive real correction — not to paint a local “resolved” badge.

Lifecycle (host-enforced): pending → addressed (main agent) → accepted (reviewer) | pending ← reopen from addressed | waived from pending.

Only pending findings whose registered ReviewScenario opts into injects_into_main are prefixed into the next main-agent prompt.

Core vs extension

• Core: lifecycle, SessionReviewStoreV1 snapshot field, inject fence, ReviewSubjectV1, scenario registry APIs.
• Extensions: ReviewScenario implementations (hosts / Use packages) own rubrics and evidence collection. Core never matches on scenario business rules beyond registry lookup.

Distinct from [crate::research] review contracts: those bind research artifacts and digests.

Structs

ReplyTranscriptScenario

Host scenario for Desktop / CLI sticky reply review (rubrics stay in the host).

ReviewFindingDraft

Draft finding produced by a scenario before Core assigns session identity.

ReviewScenarioRegistry

Process-local registry of review scenarios for one session runtime.

SessionReviewAnchorV1

Durable pointer into the session transcript (no message body copy).

SessionReviewFindingV1

One durable session review observation (multi-scenario envelope).

SessionReviewStoreV1

One session’s durable review findings (sticky reply / science review).

Enums

ReviewSubjectV1

Bound review target. Scenarios choose a subject; Core does not invent rubrics.

ReviewTriggerPolicy

When a scenario may be armed by the host runtime.

SessionReviewError

Validation failures for session-scoped reply / science review findings.

SessionReviewSeverityV1

Product-neutral severity for host routing / annotation chrome.

SessionReviewStatusV1

Durable finding lifecycle for sticky reply / multi-scenario review.

Constants

SCENARIO_REPLY_TRANSCRIPT

Well-known built-in scenario id for transcript sticky / science reply review.

SESSION_REVIEW_FINDING_SCHEMA_V1

SESSION_REVIEW_MAX_FINDINGS

SESSION_REVIEW_MAX_ID_BYTES

SESSION_REVIEW_MAX_MESSAGE_BYTES

Maximum JSON payload for one finding or store document.

SESSION_REVIEW_MAX_TEXT_BYTES

SESSION_REVIEW_STORE_SCHEMA_V1

Traits

ReviewScenario

Host-supplied review scenario. Rubrics live here — not in Core.

Functions

admit_finding_drafts

Admit scenario drafts into the durable session review store.

register_default_scenarios

Register the built-in reply.transcript scenario (idempotent replace).