new_feature.feature_state

new_feature.feature_state

Inspect managed feature worktrees and summarize their lifecycle state.

IntegrationState

Bases: StrEnum

Describe how a feature branch's commits relate to its target branch.

FeatureState dataclass

Describe a managed feature's branch, worktree, and configuration health.

stale: bool property

Return whether the feature record points to missing Git resources.

issues() -> tuple[str, ...]

Return the detected consistency problems for this feature.

describe() -> str

Return a compact human-readable summary of the feature state.

inspect_integration(root: Path, *, branch: str, target_branch: str) -> IntegrationState

Classify whether a feature is merged, patch-equivalent, or still unmerged.

inspect_feature(root: Path, record: FeatureRecord, current_fingerprint: str) -> FeatureState

Inspect a feature record against the current repository and configuration.

reusable_feature_worktree(root: Path, record: FeatureRecord) -> Path

Return an existing active feature's worktree or explain why it cannot be reopened.

require_setup_complete(record: FeatureRecord) -> None

Reject features whose setup never reached the ready state.