Files
boshu2__agentops/docs/reference
Bo 621dbb575f 3.6.0 release prep: version bumps, changelog, curated notes (#1071)
Everything-but-tag for **v3.6.0**. Minor, not major: the post-3.5.0
delta retires the knowledge-flywheel product surface and aligns the
estate on the operations-layer identity, matching the 3.4.0 precedent
where the orchestration pack was removed in a minor.

## What this carries

- **Version 3.5.0 -> 3.6.0 across all seven surfaces**: Claude plugin
manifest, marketplace metadata + plugin entry, Codex manifest, Gemini
image manifest, Claude image verify pin, and the `ao` source fallback.
- **CHANGELOG `[3.6.0]`** (root + docs mirror): operations-layer
alignment, anti-ceremony enforcement, the behavioral eval program, the
flywheel retirement, and the honest 0/12 measured probe coverage.
- **Curated `docs/releases/2026-08-17-v3.6.0-notes.md`**: validator
PASS, tier minor, full changed-path area coverage. The Breaking Changes
section lists all six removals and the handoff write-path move rather
than burying them in a minor.
- **New regression test `cli/cmd/ao/version_manifest_parity_test.go`**
binding the `version` fallback to every version-bearing release surface.
- **PRODUCT.md** reviewed against the 3.6 surface and re-stamped;
**`docs/reference/skill-system-evolution.md`** gains its 3.6.0 row and
drops the "current unreleased tree" framing that the tag would falsify.

## Why the new test exists

This cut missed `images/claude/verify.sh`. Its version guard — whose
entire stated purpose is catching plugin.json drift *behind* the release
— then rejected the **correct** version, so a user following the shipped
`images/claude/README.md` on the v3.6.0 tag would have hit a hard FAIL.
`check_manifest_version_consistency` in `ci-local-release.sh` compares
only the two Claude manifests to each other, so it structurally could
not see this.

The test fails on the drift and passes when correct; both directions
were exercised before committing.

## Honesty notes carried into the release

- Measured behavioral probe coverage is stated as **0/12** under the v3
evidence contract. The earlier wave-1 classifications are retained as
`LEGACY-UNVERIFIED` rather than counted, because the probe harness did
not isolate the skill corpus between control and treatment arms.
Skill-efficacy claims in these notes are directional, not proven.
- The estate-ablation aggregate counts are labeled legacy-unverified and
non-promotable.

## Verification

Full `scripts/ci-local-release.sh --release-version 3.6.0
--readiness-mode official --security-mode full`: **PASSED — 72 checks, 0
failures**.

| Dimension | Status |
|---|---|
| SIL (race suite, 75.8% coverage) | pass |
| VIL (gates, regen, digital twin) | pass |
| HIL (real Darwin/arm64 target) | pass |
| Artifacts (CycloneDX + SPDX SBOM) | pass |
| Security (full mode) | pass |

Readiness **9.0** against threshold 8. HIL used a real target with **no
waiver**: `ao` built from this tree reported `ao version 3.6.0`
(`version_verified=true`) and ran a full `ao init` scaffold plus `ao
status` in a scratch repo. Security full mode: 0 critical, 0 high, 3
medium (non-blocking). Notes validator PASS, doc-release gate PASS.

## Post-merge

Readiness lap at the merged SHA, audit record in `docs/audits/`, then
the tag — per the binding process rule that the record exists **before**
the tag.
2026-08-17 21:24:34 -04:00
..