Skip to content

Compass 6.1.0

Choose a tag to compare

@jed72 jed72 released this 18 Oct 23:08
· 112 commits to main since this release
Immutable release. Only release title and notes can be modified.
359be29

Compass 6.1.0 is an interim release on the way to 7.0.0. It makes the Stop hook fast on projects with many issues, and it carries the 7.0.0 changes that have landed so far. Some of those change behaviour, so read docs/upgrade-7-0-0.md before you upgrade a project.

Fixed

  • The Stop hook skips closed issues and checks the rest in one Python process. On this repository's 515 issues one run took 513 seconds before and takes under a second now, with 40 warnings instead of 264. One issue folder it cannot read no longer hides the warnings for the others.
  • Two Compass commands that save the same issue at once no longer lose either change, and a reader never sees a half-written manifest.
  • Two sessions approving at once can no longer hang on each other's review locks.
  • A generation commit no longer deletes files it did not write.
  • compass migrate no longer stops with a NameError when it checks which files it can restore.
  • Records copied to the delivery record now match their source: redaction removes secret values only.
  • The compass next latency check no longer fails on runner noise, and still fails a real slowdown.

Changed behaviour

  • Stage commands write the status of each registered document, and compass ship-commit refuses a document that is not accepted (the blocking check artifacts-approved). compass issue migrate settles the status of done issues. See docs/upgrade-7-0-0.md.
  • Guardrail 5 asks for a human sign-off only on work labelled auth, payments, personal-data or migrations, not on every risk: critical issue.
  • Role is no longer part of the assessment.
  • Compass picks each stage's model and effort from the issue's assessment.
  • Regular issues owe a short intent with four sections, and every issue that ships records a release line, given with --release-note.
  • A document kind can carry a word limit per depth, and the full approach keeps one low-level design per work unit.
  • An owner-approved waiver can lower a stage that a label floor raised, without touching its gates or guardrails.
  • The pre-tool hook refuses more Bash writes to production code that substitutions, line continuations, quotes or .. paths used to hide, and no longer refuses a write to a scratch file named through a variable the same command sets.
  • The approval guard refuses more ways an agent could forge or replay a guardrail 5 approval.
  • Lint accepts LEGACY waivers, with a warning, until 8.0.0.
  • The CLI and the docs use only the current vocabulary.

How to upgrade

  1. Copy .compass/work and docs/compass to a folder outside the project.
  2. Run compass issue migrate for a dry run, then compass issue migrate --apply --i-have-a-copy.
  3. Do not run a 6.0.x CLI on the migrated tree.

Verify the download

compass-6.1.0.tar.gz, SHA-256 cf6869269091e5278d68968fe19fd91b9755b888b822dacfbfca3e6f21e17a1d.