Skip to content

AgentMachinist 0.15.0

Choose a tag to compare

@vscarpenter vscarpenter released this 08 Sep 02:14
2b701f9

AgentMachinist 0.15.0 adds optional local readiness diagnostics, exact remote-base validation for new legacy Task Workshops, and bounded, credential-redacting diagnostics. The guided local workflow and optional GitHub/GitLab publication from 0.14.0 are unchanged.

Install or upgrade

uv tool install agentmachinist
# Existing uv installation:
uv tool upgrade agentmachinist
machinist --version   # 0.15.0

Optional local readiness

machinist doctor --local
machinist doctor --local --json
# Explicitly run the configured Verification Gates in this checkout:
machinist doctor --local --run-gates

doctor --local reuses the configuration resolution that start uses, checks Git, Harness probes, and verification command availability, creates no Task or runtime state, and contacts no forge. Plain machinist doctor keeps its GitHub setup checks.

Changes

  • Add optional machinist doctor --local [--json] [--run-gates] readiness for
    new and existing local projects. Reuse start's configuration resolution,
    inspect Git/Harness/verification readiness without creating local state or
    contacting a forge, and execute project gates only when requested. Existing
    GitHub doctor behavior remains available without --local.
  • Fetch and validate the exact remote base before provisioning a new legacy
    Task Workshop. Deleted or renamed remote branches fail despite stale local
    tracking refs; construction uses the captured commit. Existing remote Task
    branches remain authoritative for recovery, and local Tasks remain offline
    with respect to Git.
  • Sanitize bounded Git, GitHub, GitLab, and doctor diagnostics before rendering:
    redact recognized credential syntax and remove unsafe terminal controls while
    preserving useful multiline failures. Successful Git and forge data remains
    unchanged; arbitrary raw logs are outside this defense-in-depth boundary.

See ADR 0004 · Local workflow guide · Visual first-run guide

Release verification

The tag points to merged commit 2b701f9438d68b4ff1fd49e7957e0799d95c6a05 (PR #44).
The pull request CI passed on Linux and macOS with Python 3.12, 3.13, and 3.14, including coverage, minimum dependencies, packaging, static checks, and both CodeQL analyses. The local bash scripts/verify.sh gate passed on the merged head: 1,508 tests at 88% coverage, lockfile, managed-workflow, format, lint, and type checks, and installed wheel and sdist smoke tests reporting 0.15.0.

The release PR also corrected two CI-environment assumptions in the new local doctor tests (a Git author name derived from the OS account, and a snapshot race with Git's background auto-maintenance); no controller behavior changed.

Full changelog: v0.14.0...v0.15.0