Skip to content

fix: normalize Git and GitHub usage statuses - #317

Merged
codeforester merged 1 commit into
mainfrom
bug/287-20260812-status-code-contract
Aug 12, 2026
Merged

fix: normalize Git and GitHub usage statuses#317
codeforester merged 1 commit into
mainfrom
bug/287-20260812-status-code-contract

Conversation

@codeforester

Copy link
Copy Markdown
Collaborator

Summary

  • normalize public Git and GitHub usage and contract errors to status 2
  • preserve status 1 for recoverable operational failures and false predicates
  • reserve Git freshness statuses 3/4/5 for dirty, behind, and diverged states and document the contract

Issue

Fixes #287

Validation

  • bats lib/bash/git/tests/lib_git.bats lib/bash/gh/tests/lib_gh.bats (139 tests)
  • tests/bash-option-contract.sh (all 8 Bash option modes)
  • tests/lint-warnings.sh
  • ./tests/validate.sh (554 BATS cases plus all release, artifact, property, benchmark, integration, reference, concurrency, and quality contracts)

@codeforester
codeforester force-pushed the bug/287-20260812-status-code-contract branch from 6b2d127 to 501b352 Compare August 12, 2026 12:29
@codeforester
codeforester force-pushed the bug/287-20260812-status-code-contract branch from 501b352 to cfd62b3 Compare August 12, 2026 12:35
@codeforester
codeforester merged commit 5807fad into main Aug 12, 2026
10 checks passed
@codeforester
codeforester deleted the bug/287-20260812-status-code-contract branch August 12, 2026 12:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Inconsistent exit-code convention for invalid usage: git/gh modules return 1, list/str/arg/cli modules return 2

1 participant