MVP alpha.11: Beta readiness hardening

[ZebulonRouseFrantzich]

This pull request introduces several improvements and refinements across the CLI, TUI, documentation, and test suites, focusing on clarifying the default workflow operation for session execution triggers, enhancing audit evidence bundle test coverage, and improving the inspection and explanation of broker posture and attestation states.

Session Workflow Defaults and Documentation:

• The default workflow operation for session execution triggers is now explicitly set to change_draft instead of draft_promote_apply, with updated help text and tests to clarify this behavior. [1] [2] [3] [4] [5]
• The README and help output have been updated to reflect the current supported feature set and clarify the local-first beta-hardening slice, as well as the default workflow operation. [1] [2]

Audit Evidence Bundle Command Testing:

• Added a comprehensive smoke test for the audit evidence bundle commands, covering snapshot retrieval, bundle export, and offline verification to ensure end-to-end functionality. [1] [2]

Run Inspector and Attestation Posture Explanation:

• The TUI run inspector now includes detailed lines describing workflow identity and runtime attestation truthfulness, with a new helper for rendering attestation truthfulness cues based on the authoritative state. Related tests have been updated to check for these new explanations. [1] [2] [3]
• Outdated stage and role summary lines have been removed from the run inspector test expectations to match the current UI.

Test and Internal Improvements:

• Improved test coverage for session execution triggers to ensure correct defaulting and error handling.

These changes collectively improve usability, correctness, and clarity for both end-users and developers interacting with the system.

[Copilot]

Copilot wasn't able to review this pull request because it exceeds the maximum number of files (300). Try reducing the number of changed files and requesting a review from Copilot again.

[Copilot]

Pull request overview

Copilot reviewed 126 out of 126 changed files in this pull request and generated 4 comments.

[Copilot]

Pull request overview

Copilot reviewed 131 out of 131 changed files in this pull request and generated 2 comments.

Comments suppressed due to low confidence (1)

internal/perfcontracts/evaluate.go:76

• evaluateExactMetric now uses almostEqual(..., 1e-9) instead of strict equality. For metrics using the "exact" budget class / "exact_match" comparison method, this changes the contract semantics by allowing mismatches within the tolerance to pass (and the tolerance is also absolute rather than relative-to-magnitude). If the intent is truly exact (e.g., invariant counts), keep strict equality; if the intent is to allow measurement noise, consider using an absolute/regression budget class or a comparison method that encodes an explicit tolerance in the contract instead of hard-coding one here.

[Copilot]

Pull request overview

Copilot reviewed 134 out of 134 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 139 out of 139 changed files in this pull request and generated 4 comments.