Skip to content

v3.0.1

Choose a tag to compare

View all tags
@github-actions github-actions released this 25 May 13:02
· 496 commits to main since this release
v3.0.1
a173082
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

brew update && brew upgrade agentops · bash <(curl -fsSL https://raw.githubusercontent.com/boshu2/agentops/main/scripts/install.sh) · checksums · verify provenance

Highlights

AgentOps v3.0.1 is the recommended cut of the 3.0 major — the largest release in the project's history (~320 commits and a net rewrite, ~138K insertions / ~133K deletions since v2.41). 3.0 is the hookless, in-session-only rearchitecture: AgentOps is what runs inside a session — skills, the ao CLI, the RPI / evolve / crank / swarm loops, and the .agents/ context-compiler — and out-of-session orchestration (when work runs, who supervises it, how agents coordinate) is delegated to a substrate you choose: Gas City (a reference City ships here) or Mount Olympus.

The release removes hooks, the daemon, the scheduler, and the factory command (~117K LOC); consolidates the skill catalog 81→75 and gives every loop skill executable BDD acceptance; lands real hexagonal port adapters; ships an ao doctor repair engine and a much larger ao goals / ao evolve surface; and reconciles all doctrine to a single in-session north star (docs/3.0.md). 3.0.1 itself is the release-engineering patch that makes the plugin updatable and greens the nightly validation lane.

Upgrade Notes

  • New installs should use v3.0.1 (the clean cut). Existing v3.0.0 installs: run claude plugin update agentops@agentops-marketplace; if a plain update still reports "already latest", uninstall --keep-data then install once.
  • If you ran AgentOps in a session, nothing you rely on changed — ao rpi, ao evolve, crank, swarm, and the .agents/ corpus are unchanged.
  • If you ran the daemon, scheduler, or hooks, those are removed; see Breaking Changes below.
  • See docs/MIGRATION-3.0.md for the full breaking-change migration.

Breaking Changes

  • Hooks are removed (soc-57b7f). The default install registers no hooks; ao hooks install, --with-hooks, and the embedded hook surface are gone. What a hook enforced locally, a CI job in .github/workflows/validate.yml now enforces; author bounded gates with the hooks-authoring skill.
  • The daemon is removed (soc-2rtm0). ao daemon / agentopsd and internal/daemon no longer exist. For always-on work, run the reference Gas City (city.toml + packs/agentops) or Mount Olympus.
  • Scheduling is removed (soc-2rtm0). ao schedule, ao plans, ao watch, and ao overnight (commands + engines) are gone; Gas City Orders own out-of-session scheduling.
  • The factory command is removed (soc-2rtm0). ao factory and its contract corpus are gone; the factory is the loop (crank / swarm in-session, or a mayor-driven City).
  • runtime=gc is removed (soc-2rtm0). ao rpi keeps its auto / direct / stream / tmux backends; Gas City now dispatches whole ao rpi loops as one unit.

At a Glance

Product Area Added Changed Refactored Fixed Deprecated/Removed
Install, Upgrade, and Distribution 0 1 0 1 0
CLI and Operator Commands 6 1 0 2 4
Daemon, Scheduling, and Factory 0 0 0 0 4
Skills and Workflows 3 2 0 0 0
Codex and Runtime Integrations 0 1 0 0 0
Hooks and Lifecycle 0 0 0 0 1
Knowledge Flywheel, Search, and Memory 0 0 3 0 0
Eval, Validation, and Release Gates 5 2 0 2 0
Docs and Onboarding 4 2 0 0 0
Security, Privacy, and Supply Chain 1 1 0 0 0
Contributor/Internal Refactors 2 0 2 0 0

Product Areas

Install, Upgrade, and Distribution

  • Changed: version set across .claude-plugin/plugin.json, .claude-plugin/marketplace.json, and the City pack's pinned AO_VERSION — 3.0.0, then bumped to 3.0.1.
  • Fixed: claude plugin update stayed stale for early 3.0.0 installs because the version label never advanced past 3.0.0; the 3.0.1 bump gives the marketplace a new version to serve.

CLI and Operator Commands

  • Added: ao doctor — a shared diagnose-and-repair engine with subsystem detectors/fixers (cliconfig, daemon, bridges), a single --json Report, and offline-safe --fix / --dry-run exit codes.
  • Added: ao goals scenarios (--create / --lint / --list) for executable-spec links, plus ao goals steer --json now persists the mutation and steer add preserves non-directive content.
  • Added: ao validate --gate — an exit-code verdict (PASS/WARN/FAIL → process exit) for Gas City retry loops and CI.
  • Added: ao evolve config --show + a per-repo preferences.yaml schema/loader for the loop.
  • Added: ao loop surfaces for the HypothesisLedger and ConvergenceCheck ports.
  • Added: top-level capabilities + robot-docs agent surfaces, JSON subcommand listings, and --json on plans list / search / diff.
  • Changed: clearer error messages that name the corrective command (autodev PROGRAM.md, constraint/claim lookups).
  • Fixed: goals trace --orphans parser rejects bead prose and matches real orphans.
  • Fixed: a filesystem PacketRepository adapter behind the hexagonal packet seam.
  • Removed: ao daemon, ao schedule / plans / watch / overnight, ao factory, and the runtime=gc mode (see Breaking Changes).

Daemon, Scheduling, and Factory

  • Removed: internal/daemon + the agentopsd binary, the scheduler/overnight engines, the factory command + contract corpus, and the CLI gc-bridge glue (soc-2rtm0, ~117K LOC). AgentOps ships no out-of-session runtime; Gas City or Olympus owns that surface.

Skills and Workflows

  • Added: the AgentOps reference Gas City — city.toml + the agentops pack (mayor + refinery agents, skills overlay, Orders) + the using-gc agent guide and a complete tool-dependency declaration.
  • Added: canonical .feature acceptance across ~25 skills (research/plan/validation/crank/swarm/rpi/handoff/readme/flywheel/inject and more) plus SELF-TEST.md pilots.
  • Added: the idea-wizard generate-and-winnow flow folded into /brainstorm and the /discovery phase.
  • Changed: skill consolidation 81→75 — merged 4 skills into mode flags, cut 2, resolved 6 keep-flags.
  • Changed: /evolve hardening — --mode=burst|loop with cron self-adjust and typed blocked events, orchestrator-drive-to-completion (ADR-0008), never-sticky-dormancy while beads exist, auto-expiring KILL/STOP switches.

Codex and Runtime Integrations

  • Changed: the Codex skill twins (skills-codex/) and .codex-plugin manifest stayed in lockstep with the rip + consolidation, with hashes regenerated and parity audited across every skill change.

Hooks and Lifecycle

  • Removed: all 53 runtime hooks. The lifecycle is guided by skills and enforced by CI gates (see Breaking Changes).

Knowledge Flywheel, Search, and Memory

  • Refactored: a real corpus_fs CorpusReader/Writer adapter wired to its core consumer.
  • Refactored: a real bd-backed TrackerPort adapter wired to its core consumer.
  • Refactored: a real git-backed WorkspacePort adapter wired to the core worktree lifecycle.

Eval, Validation, and Release Gates

  • Added: a BDD acceptance layer — a scenario→test linkage runner plus a CI gate (soc-63xfx), with CLI-command and daemon-lifecycle Gherkin linked to tests.
  • Added: the SKU capability catalog (registry.json schema v2 — the generated skill×command×BC join) with a drift gate.
  • Added: a context-map drift gate and a validate-skill-body-refs gate for inline ao references in prose.
  • Added: validate-release-notes.sh as a hard release gate (curated notes must exist and conform to the standard).
  • Added: ci-local-release.sh --quick — the fast code-correctness subset for iterative pre-tag work.
  • Changed: executable-spec-link-integrity promoted warn→blocking; the scenario→test link gate is now required.
  • Changed: CI path-filters so validate-* and security-* jobs skip when irrelevant.
  • Fixed: Nightly Static Validation — removed the deleted validate-hooks-doc-parity.sh step and the hook-era PRODUCT.md skill-count patterns.
  • Fixed: pre-existing shellcheck warnings and post-merge CI failures cleared across the DDD/hex arc.

Docs and Onboarding

  • Added: docs/3.0.md — the canonical 3.0 north star, woven into the sources of truth.
  • Added: ADR-0009 (daemon deletion / in-session-only), ADR-0008 (orchestrator drive-to-completion), and the canonical-loop model.
  • Added: docs/MIGRATION-3.0.md — the breaking-change migration guide.
  • Added: the tiered AGENTS.md split, the sovereignty-proof page, and the release-notes standard (with a major-release variant).
  • Changed: README cut of AI-slop and restructure; PRODUCT and peripheral docs reconciled to the in-session core.
  • Changed: stale daemon / schedule / hook prose swept across narrative docs, with the out-of-session autonomous-dispatch gap explicitly labeled (soc-5jwah).

Security, Privacy, and Supply Chain

  • Added: executable acceptance for the repository security scans (security hexagon).
  • Changed: the pre-publish release evidence lane (CycloneDX SBOM + provenance attestation + the security-gate summary) now gates GoReleaser, blocking only on real security findings.

Contributor/Internal Refactors

  • Added: scripts/ship.sh (one-knob ship loop), the add-validate-job CI scaffolder, cron-tune-cadence, export-session-summary, and doctor-evolve preflight tooling.
  • Added: the domain ubiquitous-language register (architecture terms + behavior-shaping ABC vocabulary).
  • Refactored: the DDD / hexagonal architecture rescope across the bounded contexts.
  • Refactored: generated-artifact regeneration (registry, context-map, codex hashes) wired behind drift gates.

Known Issues

  • Gas City order-level autonomous dispatch is still maturing upstream (soc-5jwah); today the reference City dispatches via a long-lived mayor agent (bd ready → gc sling) plus cron exec orders for maintenance.
  • Follow-ups tracked as bd ag-728 (reconcile PRODUCT.md prose to hookless/daemonless reality) and bd ag-x0d (3 golangci-lint quality findings surfaced by the release security gate).

Full changelog

Full changelog

Patch release. No runtime behavior change — it advances the plugin/marketplace version so existing 3.0.0 installs can claude plugin update cleanly (the 3.0.0 version label never moved across the 15 commits that landed the skill consolidation and doc reconciliation, so a plain update reported "already latest"). Also reconciles two release-engineering surfaces the per-PR gate did not exercise:

  • claude plugin update now works for early 3.0.0 installs. Version bumped to 3.0.1 across .claude-plugin/plugin.json, .claude-plugin/marketplace.json (metadata + plugin), and the install-ao.sh pin.
  • Nightly Static Validation is green again. Removed the Nightly step that ran the deleted scripts/validate-hooks-doc-parity.sh (hooks were removed in 3.0). Repointed/retired two stale tests/docs/validate-skill-count.sh extraction patterns that grepped PRODUCT.md for hook-era phrasing ("runtime hook event sections", the "### 1. Skills (N across 4 runtimes)" heading) that the 3.0 restructure removed.

Full Changelog: v3.0.0...v3.0.1

Assets 12
Loading