Skip to content

docs: versioning & compatibility policy (REPLY-51264) - #11

Merged
vigubikReply merged 1 commit into
mainfrom
dev/REPLY-51264-versioning-policy
Jul 23, 2026
Merged

docs: versioning & compatibility policy (REPLY-51264)#11
vigubikReply merged 1 commit into
mainfrom
dev/REPLY-51264-versioning-policy

Conversation

@vigubikReply

Copy link
Copy Markdown
Contributor

Adds a Versioning & compatibility section to CONTRIBUTING.md and refreshes the (now-live) public-release section.

Policy captured:

  • Semver, derived from Conventional Commits (fix→patch, feat→minor, major only when declared).
  • Pre-1.0 stance: while 0.x, a minor may break; 1.0.0 when the command surface + --json output are declared stable. Don't use !/BREAKING CHANGE: on 0.x (avoids an accidental 1.0.0).
  • Compatibility surface: commands/flags/args, exit codes, --json/--pretty shape, config format, REPLY_* env vars, Node floor.
  • Deprecation: warn on stderr for ≥1 minor before removing in a major.

Also fixes the stale "public release deferred / not implemented" text — it shipped via OIDC trusted publishing (reply-cli@0.3.0).

Ref: REPLY-51264

… (REPLY-51264)

Semver rules, pre-1.0 stance, compatibility surface, and deprecation window.

Also update the public-npm section — it shipped via OIDC trusted publishing.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vigubikReply
vigubikReply merged commit aadc15d into main Jul 23, 2026
5 checks passed
@vigubikReply
vigubikReply deleted the dev/REPLY-51264-versioning-policy branch July 23, 2026 21:41
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.

1 participant