Release AgentOps 3.7.0

.claude-plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "The operations layer for agentic engineering: portable skills and evidence contracts connecting intent, coding agents, software factories, and independent judgment.",
-    "version": "4.0.0"
+    "version": "3.7.0"
   },
   "plugins": [
     {
       "name": "agentops",
       "description": "The operations layer for agentic engineering: portable skills and evidence contracts connecting intent, coding agents, software factories, and independent judgment.",
-      "version": "4.0.0",
+      "version": "3.7.0",
       "source": "./",
       "author": {
         "name": "Boden Fuller",

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentops",
-  "version": "4.0.0",
+  "version": "3.7.0",
   "description": "The operations layer for agentic engineering: portable skills and evidence contracts connecting intent, coding agents, software factories, and independent judgment.",
   "author": {
     "name": "Boden Fuller",

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agentops",
-  "version": "4.0.0",
+  "version": "3.7.0",
   "description": "The operations layer for agentic engineering: portable skills and evidence contracts connecting intent, coding agents, software factories, and independent judgment.",
   "skills": "./skills-codex",
   "interface": {

CHANGELOG.md

@@ -7,16 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [4.0.0] - 2026-09-13
+## [3.7.0] - 2026-09-13
 
-AgentOps 4.0 makes native coding the default: accepted intent, implementation
+AgentOps 3.7 makes native coding the default: accepted intent, implementation
 and checks, fresh independent judgment, then finish. No AgentOps skill,
 bootstrap, hook or orchestration service is required. The optional skill menu
 is consolidated from the 52 roots shipped in 3.6.0 to 34, and the CLI gains
-recovery and exact-content evidence helpers. This is a major release because
-published command, skill and scripted workflow entry points were removed.
+recovery and exact-content evidence helpers. Upgrade guidance covers the
+published command, skill and scripted workflow entry points that were removed.
 
-See the [curated release notes](https://github.com/boshu2/agentops/blob/main/docs/releases/2026-09-13-v4.0.0-notes.md)
+See the [curated release notes](https://github.com/boshu2/agentops/blob/main/docs/releases/2026-09-13-v3.7.0-notes.md)
 for upgrade instructions, the complete product-area summary and known limits.
 
 ### Added
@@ -62,7 +62,7 @@ for upgrade instructions, the complete product-area summary and known limits.
   review. Later work must demonstrate benefit; a generated lesson is not proof.
 - The CLI and CI build with the Go 1.27.1 toolchain; CI Python moves to 3.14.
   Dependency and pinned GitHub Actions updates are included across the full
-  3.6.0-to-4.0.0 interval.
+  3.6.0-to-3.7.0 interval.
 
 ### Fixed
 

cli/cmd/ao/main.go

@@ -5,7 +5,7 @@ package main
 // version is set at build time via ldflags (goreleaser: -X main.version={{ .Version }}).
 // The fallback identifies untagged source builds for the next release;
 // published binaries override it from the release tag via GoReleaser.
-var version = "4.0.0"
+var version = "3.7.0"
 
 func main() {
 	Execute()

cli/cmd/ao/version_test.go

@@ -2,6 +2,7 @@
 package main
 
 import (
+	"encoding/json"
 	"strings"
 	"testing"
 )
@@ -67,3 +68,19 @@ func TestVersion_RootVersionFlagWired(t *testing.T) {
 		t.Errorf("ao --version output should contain %q, got: %s", version, out)
 	}
 }
+
+func TestVersion_SubcommandJSONUsesBuildVersion(t *testing.T) {
+	out, err := executeCommand("version", "--json")
+	if err != nil {
+		t.Fatalf("ao version --json returned error: %v", err)
+	}
+	var result struct {
+		Version string `json:"version"`
+	}
+	if err := json.Unmarshal([]byte(out), &result); err != nil {
+		t.Fatalf("ao version --json returned invalid JSON: %v", err)
+	}
+	if result.Version != version {
+		t.Errorf("ao version --json reports %q, want build version %q", result.Version, version)
+	}
+}

docs/CHANGELOG.md

@@ -7,16 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [4.0.0] - 2026-09-13
+## [3.7.0] - 2026-09-13
 
-AgentOps 4.0 makes native coding the default: accepted intent, implementation
+AgentOps 3.7 makes native coding the default: accepted intent, implementation
 and checks, fresh independent judgment, then finish. No AgentOps skill,
 bootstrap, hook or orchestration service is required. The optional skill menu
 is consolidated from the 52 roots shipped in 3.6.0 to 34, and the CLI gains
-recovery and exact-content evidence helpers. This is a major release because
-published command, skill and scripted workflow entry points were removed.
+recovery and exact-content evidence helpers. Upgrade guidance covers the
+published command, skill and scripted workflow entry points that were removed.
 
-See the [curated release notes](https://github.com/boshu2/agentops/blob/main/docs/releases/2026-09-13-v4.0.0-notes.md)
+See the [curated release notes](https://github.com/boshu2/agentops/blob/main/docs/releases/2026-09-13-v3.7.0-notes.md)
 for upgrade instructions, the complete product-area summary and known limits.
 
 ### Added
@@ -62,7 +62,7 @@ for upgrade instructions, the complete product-area summary and known limits.
   review. Later work must demonstrate benefit; a generated lesson is not proof.
 - The CLI and CI build with the Go 1.27.1 toolchain; CI Python moves to 3.14.
   Dependency and pinned GitHub Actions updates are included across the full
-  3.6.0-to-4.0.0 interval.
+  3.6.0-to-3.7.0 interval.
 
 ### Fixed
 

docs/MIGRATION.md

@@ -77,9 +77,9 @@ warning:
 mkdir -p ~/.agents/ao && mv ~/.agentops/config.yaml ~/.agents/ao/config.yaml
 ```
 
-## Upgrade from 3.6 to 4.0
+## Upgrade from 3.6 to 3.7
 
-Version 4.0 removes published commands and skill entry points. Update explicit
+Version 3.7 removes published commands and skill entry points. Update explicit
 invocations before upgrading automation; the new names are not compatibility
 aliases. Ordinary native coding requires no replacement invocation.
 

docs/design/codex-context-budget.md

@@ -1,7 +1,7 @@
 # Codex context-budget design and evidence
 
 Status: implemented; observed runtime behavior and remaining limits below.
-Original evidence cutoff: 2026-09-12. The 4.0.0 writer follow-up below records the 2026-09-13 repair and live results.
+Original evidence cutoff: 2026-09-12. The 3.7.0 writer follow-up below records the 2026-09-13 repair and live results.
 Acceptance is the two-job caller request recorded in private BD `age-z25n`.
 The exact e32e88c verdict was written before this job began and posted at
 https://github.com/boshu2/agentops/pull/1137#issuecomment-5648513520.
@@ -314,7 +314,7 @@ post-write line-count command. A fenced JSON receipt observed in a direct
 agent reply illustrates that direct-role formatting remains an instruction.
 No byte-filtering or strict direct-agent output parser is claimed.
 
-### 4.0.0 writer follow-up — 2026-09-13
+### 3.7.0 writer follow-up — 2026-09-13
 
 The duplicate invocation recovered a check's status by running the check again.
 Both writer prompts now capture that status immediately in the original Bash

docs/releases/2026-09-13-v4.0.0-notes.md → docs/releases/2026-09-13-v3.7.0-notes.md

@@ -1,6 +1,6 @@
 ## Highlights
 
-AgentOps 4.0 makes native coding the default. Give your coding agent accepted
+AgentOps 3.7 makes native coding the default. Give your coding agent accepted
 behavior and repository checks, implement the change, and have a fresh context
 judge the exact result. No AgentOps skill, session bootstrap, hook or orchestration
 service is required. The optional menu has 34 skills, down from the 52 shipped in
@@ -9,7 +9,7 @@ service is required. The optional menu has 34 skills, down from the 52 shipped i
 The CLI adds recovery repairs and exact-content evidence helpers. Optional
 context-budget delegation lets Claude Haiku or Codex Luna read large files and
 write individual targets while the parent receives compact findings or receipts.
-Separate opt-in read guards block oversized unbounded reads. This major release
+Separate opt-in read guards block oversized unbounded reads. This release
 also removes published command, skill and scripted workflow entry points; the
 migration guidance below is part of the upgrade.
 
@@ -48,7 +48,7 @@ migration guidance below is part of the upgrade.
 
 - Fixed: Full release security checks scan repository-wide and block on Python collection or runtime failures. Nightly installs the declared evaluator dependencies, and importlib collection handles duplicate source/projection test names.
 - Added: Optional context-role and read-guard installers preserve unrelated configuration, use unique backups and refuse malformed or unsupported destinations before publishing changes.
-- Changed: Native onboarding leads with the agent and shell; managed full plugins and selected source links remain optional distribution paths. Release version defaults are aligned at 4.0.0.
+- Changed: Native onboarding leads with the agent and shell; managed full plugins and selected source links remain optional distribution paths. Release version defaults are aligned at 3.7.0.
 - Changed: Release and installation CI use Go 1.27.1 and Python 3.14. Snapshot release builds remain a no-publish check of the distribution path.
 
 ### CLI and Operator Commands
@@ -96,7 +96,7 @@ migration guidance below is part of the upgrade.
 
 - Changed: README, runtime installation pages, migration guidance, the workflow reference and the generated skill router describe native execution and the current menu consistently.
 - Added: Context-budget design and runtime evidence document invocation, installation, refused reads, role discovery and observed limitations. Memory references document authorized sources, protected drafts and supported topic curation.
-- Changed: The release summary covers the full v3.6.0-to-v4.0.0 interval, including CLI removals, recovery, evidence helpers, skill consolidation and runtime changes.
+- Changed: The release summary covers the full v3.6.0-to-v3.7.0 interval, including CLI removals, recovery, evidence helpers, skill consolidation and runtime changes.
 
 ### Security, Privacy, and Supply Chain
 
@@ -119,4 +119,4 @@ migration guidance below is part of the upgrade.
 - Structural validation of all 34 packages and live tests of selected paths do not establish behavioral efficacy for every skill or task. No generalized token-cost reduction percentage is claimed.
 - Restricted-source enforcement remains unavailable for the context/source helpers. Native freshness facts are attestations with documented trust boundaries, not cryptographic proof of process isolation.
 
-[Full changelog](https://github.com/boshu2/agentops/compare/v3.6.0...v4.0.0)
+[Full changelog](https://github.com/boshu2/agentops/compare/v3.6.0...v3.7.0)

images/claude/verify.sh

@@ -58,7 +58,7 @@ fi
 # Version guard: the Claude marketplace plugin manifest is the install entrypoint
 # for this image. Assert .claude-plugin/plugin.json declares the expected version
 # so a stale-version drift (plugin.json behind the release) fails the gate.
-EXPECTED_VERSION="${AGENTOPS_EXPECTED_VERSION:-4.0.0}"
+EXPECTED_VERSION="${AGENTOPS_EXPECTED_VERSION:-3.7.0}"
 plugin_manifest="$repo_root/.claude-plugin/plugin.json"
 if [ ! -f "$plugin_manifest" ]; then
   echo "FAIL: Claude plugin manifest not found: $plugin_manifest" >&2

images/gemini/plugin.json

@@ -13,5 +13,5 @@
   "name": "agentops-core-gemini",
   "rules": "./rules",
   "skills": "./skills",
-  "version": "4.0.0"
+  "version": "3.7.0"
 }