Skip to content

changeset: consolidate the 0.7.0 release notes - #168

Merged
SutuSebastian merged 2 commits into
mainfrom
agent/sta-436-release-notes
Nov 16, 2026
Merged

SutuSebastian merged 2 commits into
mainfrom
agent/sta-436-release-notes

Conversation

@SutuSebastian

Copy link
Copy Markdown
Contributor

Part of STA-436 (release 0.7.0).

What

This consolidates the 130 pending changesets into 14 themed, user-facing ones, the same way 0.4.0 did it (b21eaff, "changeset: consolidate the 0.4.0 release notes"):

  • Order: the files are numbered 00–13, because changeset version orders entries by filename.
  • Sections: a "what's new" headline, then themed items, 13 breaking changes each with a _Migrate:_ step, and a known-limits list (macOS sandbox network-only; the string gate is a tripwire and sh "$V" passes; backslash before CRLF fails safe).
  • Audit trail: every item carries a hidden <!-- changesets: … --> mapping to its source changesets.
  • Bump level: minor and patch only, so the Version PR (chore: version packages #58) cuts 0.7.0.

Evidence

  • Mapping: 130 sources, 0 unmapped, 0 unknown. A few changesets are cross-listed on purpose, under both a feature or safety section and Breaking or Known limits.
  • Links: 0 broken against docs/manual.md, benchmark.md, troubleshooting.md and CONTRIBUTING.md.
  • Cross-family review (Gemini 4 Hydrogen): verified 20+ user-visible claims against bin/verdict --help and the source changesets. Its only blocker, four British spellings, is fixed in 2cb5e0ad4.
  • bun fmt --check .changeset/*.md, the archtest and the doc-coverage eval pass.

Before the release

Any changeset merged after this PR (for example STA-425's) needs folding into these notes before #58 is merged, or it appears as a raw line.

The 130 pending changesets describe internals as often as they describe what a
0.6.1 user notices, so shipping them verbatim makes the 0.7.0 release body a
changelog instead of notes. Fold them into 14 themed entries — the mechanism
0.4.0 used (b21eaff "changeset: consolidate the 0.4.0 release notes") — so
`changeset version` writes one curated "what's new" section plus its themed
items, and CHANGELOG.md, the GitHub Release body, and the docs site's
/changelog stay one text.

Every item traces to the changeset that produced it: each item line ends in a
hidden `<!-- changesets: ... -->` comment naming its sources, and this message
carries the same theme -> sources mapping. Four items cover sibling changesets
that describe one behaviour (the author fingerprint, the revert memory, the
published review.json key names, and corpus grading), and a change that both
adds a feature and breaks a shape appears twice — once in its theme, once under
breaking — so no source is lost and no breaking step goes unnamed.

Start point: .scratch/factory/roadmap-next/RELEASE-NOTES-draft.md, written
against 104 of these changesets. Refreshed against every pending changeset on
main 7d488f9: 24 arrived after the draft, and 2 more (backtest-reverts,
run-print-stage) predate it but were missing from it.

Headline (00-what-s-new.md, 5 sentences):

  Verdict 0.7.0 is a breadth release. It adds a local code index, a read-only
  `serve` surface with a browser UI, and a backtest harness that mines past bug
  fixes from your own history, replays them against your agent, and scores the
  result. Review output gains an auditable provenance receipt, diff-coverage
  attestation, advisory risk scoring, and an optional validation pass that
  floors each finding on the evidence behind it, while the CI gate now checks
  coverage by default. Posting grows a secret guard, honest per-host capability
  reporting, and a summary-comment option, GitLab and Forgejo join GitHub as
  full publish targets, and lens packs, declared recipes, and reported
  verification make the review pipeline itself data. Thirteen pre-1.0 changes
  alter behaviour — each names the migration step below — and the known limits
  close the notes.

Theme -> sources (minor unless noted, all under .changeset/):

  00-what-s-new.md                   <- the headline, no items
  01-new-commands-and-flags.md       <- backtest-mine backtest-replay backtest-reverts backtest-score bounded-foreground-waits fix-all-batch handoff-verb incident-memory ingest-sarif panel-verification post-summary-comment reaction-scoped-fix recipes-format report-html risk-queue run-agent run-print-stage skill-management thread-resolve
  02-local-code-index.md             <- blast-radius-index-hint fetch-index-impact index-blast-radius index-callers index-corpus-bugs index-graph index-impact-budget index-scanners index-transitive-tests
  03-review-quality-and-provenance.md <- author-routing author-routing-hint author-routing-record author-routing-skill author-routing-trend context-sources coverage-scoring-basis diff-coverage-attestation fetch-reverts ignore-overrides ignore-suppression learnings-propose null-ranges-malformed post-content-digest post-content-recovery post-live-authority post-verdict-reconciliation prompt-key-shapes prompt-rigor-key reactions-trend resolution-rate rigor-validation risk-score rule-exposure rule-pack-import withheld-capabilities
  04-safety-and-trust.md             <- curl-token-argv learnings-evidence line-break-guards mention-neutralization post-secret-guard punctuated-mentions run-argument-credential setup-verdict-hardening skill-install-preflight store-lock-and-listing strikethrough-mentions verify-indirection verify-out-owner-only verify-sandbox verify-sandbox-macos
  05-agents-and-mcp.md               <- agent-definition-display mcp-config-hosts mcp-mutation-class run-repair-loop self-review-loop
  06-hosts-and-ci.md                 <- doctor-provider-adopt-gitlab forgejo-post github-action gitlab-incremental gitlab-publish ready-calibrate-gitlab
  07-serve-and-ui.md                 <- cache-content-budget cache-small-content inventory-budget-exact serve-live-updates serve-s1 serve-s2-discovery serve-s3-cost-precision serve-ui vanished-threads
  08-lens-packs.md                   <- lens-dispatch-deltas lens-packs-s1 pack-add-backup-warning pack-layers pack-staging-stale pack-test packs-lock
  09-measurement.md                  <- bench-adjudication bench-corpus-followups bench-keyword-guard bench-real-pilot benchmark-clean-controls benchmark-controls-metrics
  10-breaking-changes.md             <- bench-real-pilot bundle-name-guard gate-coverage-default gate-live-all-hosts gate-tier-validation honest-capabilities index-import-shadow managed-parent-symlinks pack-source-allowlist provenance-receipt provider-from-remote typed-truncation verify-env-allowlist verify-indirection verify-out-owner-only verify-static-gate-bypasses write-bundle-symlinks
  11-fixes.md                        <- backtest-partial-clone fetch-refusal-next-steps next-usage-basis-plain pr-wait-inconsistent-reads read-verb-re-enter record-cost-name-warnings release-asset-sigpipe review-residuals upgrade-hints-quoting windows-watchdog-no-hang windows-watchdog-resume-retry
  12-docs.md                         <- defaults-at-a-glance docs-site-restructure troubleshooting
  13-known-limits.md                 <- verify-indirection verify-sandbox-macos verify-static-gate-bypasses

  04-safety-and-trust.md, 11-fixes.md, 12-docs.md, and 13-known-limits.md ship
  as patch; the rest as minor. One minor changeset is enough to cut 0.7.0.

Breaking (13 items in 10-breaking-changes.md), each with its _Migrate:_ step:
the `index blast-radius` truncation receipt, `gate` checking coverage by
default, `gate --live` reading every host, unknown gate tiers, the default-deny
verify child environment, the verify command shapes that used to run
(`verify-networked` and the new `verify-indirection` arm), the owner-only
`.verify.out`, guarded bundle paths, provider inference from origin, the
`capabilities` split, the `pack add` source allowlist, the benchmark
`provenance.base_sha`/`head_sha` requirement, and the rebuilt-code-index
requirement.

Known limits (13-known-limits.md) are the three from STA-436's 2026-11-16
status comment: the macOS sandbox covers the network half only, the string gate
is a tripwire rather than a boundary (`sh "$V"` still passes it), and a
backslash before a CRLF line ending is not joined as a continuation.

Counts: 130 changesets read, 14 consolidated entries, 126 item lines (123
content items plus the 3 known-limit lines), 13 breaking, 5-sentence headline.

Verification:
  bun fmt --check .changeset/*.md            -> All 14 files are formatted.
  go test ./internal/archtest/ -count=1      -> ok (changeset frontmatter guard)
  bash evals/one.sh doc-coverage             -> PASS (135 cases)
The notes are user-facing copy, so a British spelling has no place in them:

  behaviour    -> behavior      (00-what-s-new.md, 10-breaking-changes.md)
  unrecognised -> unrecognized  (10-breaking-changes.md)
  labelled     -> labeled       (09-measurement.md)

Swept all 14 files for the rest of the class — colour, honour, favour,
cancelled/-lled, licence, defence, grey, centre, programme, catalogue,
modelling, judgement, artefact, towards, whilst, and every -ise/-isation verb —
and found no other hit. Copy only: no item, mapping, or bump level moves.
@changeset-bot

changeset-bot Bot commented Nov 16, 2026

Copy link
Copy Markdown

🦋 Changeset detected

Latest commit: 2cb5e0a

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
@stainless-code/verdict Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

@coderabbitai

coderabbitai Bot commented Nov 16, 2026

Copy link
Copy Markdown

Important

Review skipped

Too many files!

This PR contains 144 files, which is 44 over the limit of 100.

To get a review, reduce the PR to 100 files or fewer by splitting it into smaller PRs or changing its base branch.

Upgrade to a paid plan to raise the limit.

This review couldn't start because sufficient usage credits or metered capacity aren't available. Add credits or update usage-based reviews in the billing tab, then retry.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 60236059-becb-4d1f-ba92-832edc89dcf5
Commits

Reviewing files that changed from the base of the PR and between 7d488f9 and 2cb5e0a.

Files selected for processing: 144

  • .changeset/00-what-s-new.md
  • .changeset/01-new-commands-and-flags.md
  • .changeset/02-local-code-index.md
  • .changeset/03-review-quality-and-provenance.md
  • .changeset/04-safety-and-trust.md
  • .changeset/05-agents-and-mcp.md
  • .changeset/06-hosts-and-ci.md
  • .changeset/07-serve-and-ui.md
  • .changeset/08-lens-packs.md
  • .changeset/09-measurement.md
  • .changeset/10-breaking-changes.md
  • .changeset/11-fixes.md
  • .changeset/12-docs.md
  • .changeset/13-known-limits.md
  • .changeset/agent-definition-display.md
  • .changeset/author-routing-hint.md
  • .changeset/author-routing-record.md
  • .changeset/author-routing-skill.md
  • .changeset/author-routing-trend.md
  • .changeset/author-routing.md
  • .changeset/backtest-mine.md
  • .changeset/backtest-partial-clone.md
  • .changeset/backtest-replay.md
  • .changeset/backtest-reverts.md
  • .changeset/backtest-score.md
  • .changeset/bench-adjudication.md
  • .changeset/bench-corpus-followups.md
  • .changeset/bench-keyword-guard.md
  • .changeset/bench-real-pilot.md
  • .changeset/benchmark-clean-controls.md
  • .changeset/benchmark-controls-metrics.md
  • .changeset/blast-radius-index-hint.md
  • .changeset/bounded-foreground-waits.md
  • .changeset/bundle-name-guard.md
  • .changeset/cache-content-budget.md
  • .changeset/cache-small-content.md
  • .changeset/context-sources.md
  • .changeset/coverage-scoring-basis.md
  • .changeset/curl-token-argv.md
  • .changeset/defaults-at-a-glance.md
  • .changeset/diff-coverage-attestation.md
  • .changeset/docs-site-restructure.md
  • .changeset/doctor-provider-adopt-gitlab.md
  • .changeset/fetch-index-impact.md
  • .changeset/fetch-refusal-next-steps.md
  • .changeset/fetch-reverts.md
  • .changeset/fix-all-batch.md
  • .changeset/forgejo-post.md
  • .changeset/gate-coverage-default.md
  • .changeset/gate-live-all-hosts.md
  • .changeset/gate-tier-validation.md
  • .changeset/github-action.md
  • .changeset/gitlab-incremental.md
  • .changeset/gitlab-publish.md
  • .changeset/handoff-verb.md
  • .changeset/honest-capabilities.md
  • .changeset/ignore-overrides.md
  • .changeset/ignore-suppression.md
  • .changeset/incident-memory.md
  • .changeset/index-blast-radius.md
  • .changeset/index-callers.md
  • .changeset/index-corpus-bugs.md
  • .changeset/index-graph.md
  • .changeset/index-impact-budget.md
  • .changeset/index-import-shadow.md
  • .changeset/index-scanners.md
  • .changeset/index-transitive-tests.md
  • .changeset/ingest-sarif.md
  • .changeset/inventory-budget-exact.md
  • .changeset/learnings-evidence.md
  • .changeset/learnings-propose.md
  • .changeset/lens-dispatch-deltas.md
  • .changeset/lens-packs-s1.md
  • .changeset/line-break-guards.md
  • .changeset/managed-parent-symlinks.md
  • .changeset/mcp-config-hosts.md
  • .changeset/mcp-mutation-class.md
  • .changeset/mention-neutralization.md
  • .changeset/next-usage-basis-plain.md
  • .changeset/null-ranges-malformed.md
  • .changeset/pack-add-backup-warning.md
  • .changeset/pack-layers.md
  • .changeset/pack-source-allowlist.md
  • .changeset/pack-staging-stale.md
  • .changeset/pack-test.md
  • .changeset/packs-lock.md
  • .changeset/panel-verification.md
  • .changeset/post-content-digest.md
  • .changeset/post-content-recovery.md
  • .changeset/post-live-authority.md
  • .changeset/post-secret-guard.md
  • .changeset/post-summary-comment.md
  • .changeset/post-verdict-reconciliation.md
  • .changeset/pr-wait-inconsistent-reads.md
  • .changeset/prompt-key-shapes.md
  • .changeset/prompt-rigor-key.md
  • .changeset/provenance-receipt.md
  • .changeset/provider-from-remote.md
  • .changeset/punctuated-mentions.md
  • .changeset/reaction-scoped-fix.md
  • .changeset/reactions-trend.md
  • .changeset/read-verb-re-enter.md
  • .changeset/ready-calibrate-gitlab.md
  • .changeset/recipes-format.md
  • .changeset/record-cost-name-warnings.md
  • .changeset/release-asset-sigpipe.md
  • .changeset/report-html.md
  • .changeset/resolution-rate.md
  • .changeset/review-residuals.md
  • .changeset/rigor-validation.md
  • .changeset/risk-queue.md
  • .changeset/risk-score.md
  • .changeset/rule-exposure.md
  • .changeset/rule-pack-import.md
  • .changeset/run-agent.md
  • .changeset/run-argument-credential.md
  • .changeset/run-print-stage.md
  • .changeset/run-repair-loop.md
  • .changeset/self-review-loop.md
  • .changeset/serve-live-updates.md
  • .changeset/serve-s1.md
  • .changeset/serve-s2-discovery.md
  • .changeset/serve-s3-cost-precision.md
  • .changeset/serve-ui.md
  • .changeset/setup-verdict-hardening.md
  • .changeset/skill-install-preflight.md
  • .changeset/skill-management.md
  • .changeset/store-lock-and-listing.md
  • .changeset/strikethrough-mentions.md
  • .changeset/thread-resolve.md
  • .changeset/troubleshooting.md
  • .changeset/typed-truncation.md
  • .changeset/upgrade-hints-quoting.md
  • .changeset/vanished-threads.md
  • .changeset/verify-env-allowlist.md
  • .changeset/verify-indirection.md
  • .changeset/verify-out-owner-only.md
  • .changeset/verify-sandbox-macos.md
  • .changeset/verify-sandbox.md
  • .changeset/verify-static-gate-bypasses.md
  • .changeset/windows-watchdog-no-hang.md
  • .changeset/windows-watchdog-resume-retry.md
  • .changeset/withheld-capabilities.md
  • .changeset/write-bundle-symlinks.md

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@SutuSebastian
SutuSebastian merged commit a2ff2ce into main Nov 16, 2026
21 checks passed
@SutuSebastian
SutuSebastian deleted the agent/sta-436-release-notes branch November 16, 2026 12:48
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