Skip to content

Chameleon

v2.22.2 Breaking

This release includes breaking changes for platform teams planning a safe upgrade.

✓ No known CVEs patched
Read the diff → Tool health → What is this tool? →

✓ No known CVEs patched in this version

Topics

ai-coding-assistant archetype ast-analysis claude-code claude-plugin code-conventions
+12 more
code-review code-style developer-tools javascript linter mcp mcp-server prompt-engineering python ruby rails typescript

Affected surfaces

auth

Summary

AI summary

/chameleon-doctor now verifies the stop-backstop hook.

Full changelog

The first release since 2.22.0. It rewrites the user-facing documentation to
match the as-built code, bumps the build and runtime toolchain (including
TypeScript 6.0), and fixes a doctor completeness gap. No runtime behavior
change beyond the new doctor check.

Documentation

  • Rewrote README.md and docs/architecture.md to the as-built system,
    verified against the code across three passes. Corrected accumulated drift:
    the MCP server exposes 41 tools (not 38), six hook scripts across six events
    (the Stop/SubagentStop backstop was undocumented), a six-dimension cluster
    signature (not a "7-tuple"), full TypeScript and Ruby support (not "TypeScript
    only"), a 15-artifact trust hash, and 19 journey acts. Removed stale claims:
    the dropped drift.db files table, OS-level subprocess rlimits the
    extractors do not set, and runtime verification of typescript-checksums.json
    (it is a build-time reference only).
  • Fixed drift in supporting docs: CONTRIBUTING.md (six hooks; the per-edit
    timeout budget), install.md (daemon uninstall path), the chameleon-refresh
    (15 hashed artifacts), chameleon-journey (19 acts), and chameleon-trust
    skill bodies, and the migrations README cross-reference anchor. Documented the
    CHAMELEON_ALLOW_TESTS environment variable.
  • Corrected two source docstrings: hash_profile in profile/trust.py (the
    trust hash iterates _HASHED_ARTIFACTS in declaration order, not alphabetical;
    the tuple is unchanged, so existing trust grants are unaffected) and
    daemon_client (socket path carries the -<version_tag> suffix).

Dependencies

  • TypeScript 5.9.3 -> 6.0.3. Extraction verified byte-identical to 5.9.3 over the
    full unit-test corpus and a 2245-file real codebase; engines.node is
    unchanged, so the pinned Node 20 is unaffected.
  • GitHub Actions: actions/checkout v4 -> v7, actions/setup-python v5 -> v6,
    actions/setup-node v4 -> v6, astral-sh/setup-uv v3 -> v7,
    actions/upload-artifact v4 -> v7. These also clear the Node 20 runner
    deprecation warnings.

Fixed

  • /chameleon-doctor now verifies the stop-backstop hook. doctor checked
    only five of the six wired hook scripts, so a missing or non-executable Stop /
    SubagentStop backstop (which hosts turn-end enforcement and the correctness
    judge) read as a healthy install. It now checks all six, with a regression
    test.
  • Dropped a broken cache: 'pip' from setup-python in the calibration and
    acceptance workflows. The repo installs with uv, so the pip cache dir never
    existed and the post-job cache-save failed those (rarely-run) workflows.

Weekly OSS security release digest.

The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.

No spam, unsubscribe anytime.

Share this release

Track Chameleon

Get notified when new releases ship.

Sign up free

About Chameleon

All releases →

Related context

Earlier breaking changes

  • v3.0.0 MCP surface folded from 48 tools to 19; remaining 32 operator tools become actions on three dispatchers.

Beta — feedback welcome: [email protected]