release: add readiness report skeleton

[VelariumAI]

Summary

Adds RR-001, a report-only release-readiness wrapper and documentation.

What changed

• Added release-readiness wrapper:
  • scripts/release_readiness/readiness.sh
• Added shared shell helpers:
  • scripts/release_readiness/lib/common.sh
  • scripts/release_readiness/lib/report.sh
• Added smoke test:
  • scripts/release_readiness/test_smoke.sh
• Added release-readiness documentation:
  • docs/release/README.md
• Updated .gitignore so generated local reports under .local/ remain untracked.
• Updated promotion manifest / allowlist for the new public readiness files.

Operational posture

• Report-only.
• Does not create, move, or delete tags.
• Does not run release workflows.
• Does not publish releases.
• Does not push.
• Does not modify runtime behavior.
• Does not modify vector/semantic-memory behavior.
• Does not modify private scanner artifacts.
• Does not modify private contracts.
• Does not start RR-002+ tooling.

Readiness behavior

The wrapper writes markdown reports to:

.local/release-readiness/reports/

Reports include:

• timestamp
• branch
• commit
• working tree status
• promotion manifest status
• test/vet/diff summaries
• private control-file check
• private scanner presence
• vector/semantic memory preservation
• release tag status
• release workflow safety
• public artifact neutrality
• skipped RR checks
• final recommendation

RR-001 intentionally returns:

NEEDS_RR_SUITE

unless concrete blockers are found.

It does not claim RC_READY or STABLE_READY.

Review status

Independent review verdict: APPROVE.

Focused re-review verdict: APPROVE.

The follow-up fix resolved:

• protected vector/semantic path check now uses branch range instead of last commit only
• neutrality scan now checks branch-range additions and commit messages
• go test ./pkg/governance is now explicit in the readiness command list
• pattern handling remains self-match-safe

Validation

• bash scripts/release_readiness/test_smoke.sh passed.
• bash scripts/release_readiness/readiness.sh passed with recommendation NEEDS_RR_SUITE.
• bash scripts/check_promotion_manifest.sh passed with 905 / 905 managed files.
• Targeted package tests passed.
• go test ./... passed.
• go vet ./... passed.
• git diff --check passed.
• Private scanner finding zero_proofs_3 | reasoning/ classified as existing unrelated.

Deferred follow-ups

• RR-002 CLI smoke + config matrix.
• RR-003 VAR spine fixture smoke.
• RR-004 policy absence + statelock/paradox smoke.
• RR-005 vector/RAG/engram preservation smoke.
• RR-006 TUI/operator/session scripted smoke.
• RR-007 final release report generator.