Skip to content

v3.4.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 30 Jul 15:44
v3.4.0
354bd41

brew update && brew upgrade agentops · cd ~/.local/share/agentops && git pull --ff-only && ao skills link · checksums · verify provenance

Highlights

AgentOps 3.4 is the honest-contract release. Every one of the 50 shipped skills went through an eight-wave overhaul that makes each contract state only what it really does: declared effects, real output contracts, closed artifact directories, and authority claims stripped where no authority exists. On the factory side, AgentOps stops carrying its own orchestration pack as the product path: the supported software factories are the upstream Gas City build pack and the Agentic Coding Flywheel — AgentOps supplies the skills and the evidence discipline they execute, and the using-gc skill now teaches stock gascity workflows and roles. Release gates gained a shrink-only ratchet requiring every blocking gate to prove it can fail, and the eval subprocess runner is now bounded, cancellable, and reaps its whole process group.

Upgrade Notes

  • The goals skill is renamed fitness; the goals trigger remains as a compatibility alias, so no manual action is required.
  • If you ran the 3.3 Gas City pack preview from deploy/gc/, that prototype is retired in place: keep using it if it works for you, but new setups should follow the upstream Gas City build pack or the Agentic Coding Flywheel.

At a Glance

Product Area Added Changed Refactored Fixed Deprecated/Removed
Skills and Workflows 1 4 0 0 1
Eval, Validation, and Release Gates 1 4 0 3 0
CLI and Operator Commands 1 2 0 1 0
Docs and Onboarding 0 2 0 0 0

Product Areas

Skills and Workflows

  • Added: using-flywheel, the operating manual for the Agentic Coding Flywheel as a caller-selected factory, parallel to using-gc
  • Changed: all 50 skill contracts overhauled across eight waves — declared real effects, honest output contracts, scratch-tier artifact directories, authority grants stripped, fail-closed deadlines, and corpus-level trigger separation (W2–W8)
  • Changed: using-gc now teaches the stock upstream gascity workflows and roles instead of an in-repo experiment pack
  • Changed: goals renamed to fitness with a compatibility alias; shared retired to a declared contract owner
  • Changed: fresh validation persistence is optional — verdict.v2 is written only for a caller request or a declared downstream consumer
  • Deprecated: the in-repo Gas City factory prototype (deploy/gc/) is retired in place; upstream factories are the supported path

Eval, Validation, and Release Gates

  • Added: a negative-witness ratchet requiring every blocking gate to prove it can fail on what it detects, with a shrink-only grandfather list
  • Changed: the eval subprocess runner is bounded and cancellable with process-group reaping
  • Changed: ADR-0016 shipped-Python rule is enforced by a blocking gate
  • Changed: Gas City factory qualification pins and fail-closes on the official v1.4.0 release and the registry-pinned gascity 0.1.6 workflow
  • Changed: retired Gas City prototype wiring decayed to frozen bytes, with the adapter.gc-maintainer gate replacing adapter.gc-executor
  • Fixed: RPI and Validate no longer disagree on the intent-source digest
  • Fixed: the orchestration-skill-boundaries gate no longer references adapter files deleted by the 3.3 single-pass refactor
  • Fixed: the negative-witness scan reads only git-tracked files under tests/, so ignored local logs cannot flip its verdict between checkouts

CLI and Operator Commands

  • Added: scripts/gc-maintainer-ops.sh, a narrow operational adapter for stock Gas City rigs (prepare, read-only check, dry-run-by-default recover-affinity); not a pack, formula, role, daemon, or GC fork
  • Changed: ao gate check --dry-run is a real plan-only mode that mutates nothing
  • Changed: eval id containment hardened and temp directories owned by the invoking run
  • Fixed: handoff schema now matches what the command actually writes; dcg guidance corrected to match observed behavior

Docs and Onboarding

  • Changed: the README presents the upstream Gas City build pack and the Agentic Coding Flywheel as the supported factory choices, with AgentOps as the skills-and-evidence layer either factory executes
  • Changed: the Gas City reliability boundary doc assigns orchestration to the selected factory and skills/evidence to AgentOps

Known Issues

  • No release-blocking known issues.

Full changelog

Full changelog

AgentOps 3.4 is the honest-contract release. All 50 shipped skills went through an eight-wave contract overhaul — declared real effects, honest output contracts, closed artifact directories, authority claims stripped — and the factory boundary is now explicit: AgentOps no longer carries its own orchestration pack as the product path. The supported software factories are the upstream Gas City build pack and the Agentic Coding Flywheel; AgentOps supplies the skills and evidence discipline either factory executes.

Added

  • Negative-witness ratchet: every blocking gate must carry a test proving it fails on what it detects, with a shrink-only grandfather list.
  • ao gate check --dry-run: a real plan-only mode that mutates nothing.
  • using-flywheel skill: operating manual for the Agentic Coding Flywheel as a caller-selected external software factory, covering provisioning via the upstream wizard, AgentOps skill visibility across its worker runtimes, and the evidence boundary (factory convergence is never an AgentOps verdict). Gives the second supported factory an operating surface parallel to using-gc.
  • scripts/gc-maintainer-ops.sh: a narrow operational adapter for stock Gas City rigs, with prepare (pin verification, contained runtime snapshot, skill linking), read-only check, and dry-run-by-default recover-affinity. It is not a pack, formula, role, daemon, or GC fork.

Changed

  • All 50 skill contracts overhauled across waves W2–W8: real effects, honest output contracts, scratch-tier artifact directories, authority grants stripped, fail-closed deadlines, corpus-level trigger separation.
  • goals renamed to fitness with a compatibility alias; shared retired to a declared contract owner.
  • Fresh validation persistence is optional: verdict.v2 is written only for a caller request or a declared downstream consumer.
  • The README and using-gc skill present the upstream Gas City build pack and the Agentic Coding Flywheel as the supported factory choices; using-gc teaches stock gascity workflows and roles.
  • Gas City factory qualification pins and fail-closes on the checksummed v1.4.0 release and the registry-pinned gascity 0.1.6 workflows and roles used by Maintainer City, removes the v1.3 Mayor heartbeat workaround, and requires scope-local core.control-dispatcher propulsion.
  • The eval subprocess runner is bounded and cancellable with process-group reaping; eval id containment hardened and temp directories owned by the run.
  • ADR-0016 shipped-Python rule is enforced by a blocking gate.

Fixed

  • RPI and Validate no longer disagree on the intent-source digest.
  • handoff schema matches what the command writes; dcg guidance corrected.
  • The orchestration-skill-boundaries gate no longer references adapter files deleted by the 3.3 single-pass refactor.
  • The negative-witness scan reads only git-tracked files under tests/, so ignored local logs can no longer flip its verdict between checkouts.
  • Retired Gas City prototype wiring decayed to frozen bytes: the skill projection into the retired pack copy stopped, and the adapter.gc-maintainer gate replaces adapter.gc-executor.

Deprecated

  • The in-repo Gas City factory prototype (deploy/gc/) is retired in place; upstream factories are the supported path.

Full Changelog: v3.3.0...v3.4.0

Assets 12
Loading