Module workflow 

Ready / land workflow domain: pure preflight, policy, and step accounting.

Owns decision logic shared by heddle ready, heddle land, and heddle sync:

• verification fail-closed preflight for readiness
• land push option planning
• auto-land confidence / verification policy blockers
• non-staleness / heavy-impact classification
• land performed / skipped step accounting
• integrated-land next-action selection
• ready classification and report next-action filtering

Network, mutation, capture, and render remain CLI-owned.

Structs

AutoLandPolicyInput

Facts needed for auto-land policy without opening the object store.

ReadyDecision

Pure classification of readiness after preview / policy blockers are known.

ReadyDecisionInput

Inputs for classifying a ready-command outcome without performing I/O.

Constants

AUTO_LAND_CONFIDENCE_RECOVERY_ACTION

Recovery breadcrumb when auto-land policy blocks on confidence / tests.

AUTO_LAND_CONFIDENCE_THRESHOLD

Minimum agent confidence allowed for automatic land without re-capture.

Functions

auto_land_confidence_recovery_action

Scope the confidence recovery capture to the thread’s checkout when needed.

auto_land_policy_blockers

Policy blockers that prevent automatic land (confidence / verification).

classify_ready_decision

Classify ready outcome from preview facts (no I/O).

has_integration_target

Whether a thread preview has an integration target configured.

integrated_land_next_action

Next action after a successful local land (push if trust says so, else cleanup).

integration_blocker_recommended_action

Recovery breadcrumb for confidence / verification policy blockers.

integration_blockers

Combine preview blockers with auto-land policy, honoring manual resolution.

is_heavy_impact_advisory

Heavy-impact lines are advisories for land, not hard blockers for sync.

is_integration_clear

Conflict-free and policy-clear: safe to mark ready / land.

is_manual_review_blocker

Whether a land/preview blocker is the heavy-impact manual-review advisory.

land_blockers_for_preview

Expand preview conflicts into land blockers, then sort/dedup.

land_checkpoint_message

Checkpoint / squash message for land write-through.

land_performed_steps

Steps that actually ran during land.

land_skipped_steps

Steps skipped (with reason tokens) during land.

land_text_step

Human text for a land performed/skipped step token.

land_warnings_for_preview

Heavy-impact advisories for land (warnings, not hard blockers).

non_staleness_blockers

Drop staleness and heavy-impact advisories from a blocker list.

op_targets_merge_state

Whether an oplog record advances HEAD/thread to a land merge target.

quote_recommended_action_arg

Quote a recommended-action path/arg when it is not shell-safe bare.

ready_freshness_summary

Freshness column for ready summary.

ready_integration_summary

Integration column for ready summary.

ready_merge_type_label

Ready summary labels from preview merge relation strings.

ready_merge_type_summary

Merge-type column for ready summary.

ready_report_recommended_action

Drop self-merge / land recommendations when the thread has no target.

ready_scoped_next_action

Ready-scoped next-action selection (operation → thread fallback → publish).

ready_status_summary

Ready status line for operator text (clean vs thread health).

ready_verification_preflight_blocks

Statuses that must fail closed before readiness / land preflight can run.

ready_verification_status_blocks

Pure status-string check used by ready_verification_preflight_blocks.

recovery_scope_checkout

Returns the thread checkout when it is a real, distinct path from the current checkout (so recovery breadcrumbs must re-scope via --repo).

scope_action_to_repo

Scope a heddle … recommended action to an explicit --repo path.

should_squash_land

Whether land should squash the thread into one Git commit on write-through.

state_id_matches_display

Whether a change id matches a short or full display form from operator text.

state_id_matches_op_display

Convenience: match a StateId against operator display text.

sync_completed_next_action

Next action after a successful sync (already current or refreshed).

sync_is_already_current

Whether sync has nothing left to refresh.