Lightweight human-readable summary of meaningful repository changes.
- Added scalable GitHub governance: structured Issue Forms, source-controlled
label taxonomy, path-based PR labels, new-issue triage, weekly grouped
Dependabot updates targeting
develop, and a dormant CODEOWNERS draft. - Added ruff and strict dependency-audit CI gates, upgraded the supported Python floor to 3.10, and added regression tests for repository governance configuration.
- Hardened CI supply chain behavior: replaced the Antigravity
curl | bashinstaller with a versioned SHA-512-verified artifact, pinned release Actions to commit SHAs, pinned release build tooling, and removed PR-title shell expression injection. - Corrected the governance audit to recognize the already-active repository branch/tag rulesets through the ruleset APIs rather than treating a classic branch-protection 404 as proof of no protection.
- Enabled live Discussions, dependency security updates and alerts, secret scanning with push protection, private vulnerability reporting, and automatic deletion of merged branches.
- Added a Cline CLI adapter (
adapters/cline/) so Cline CLI and ClinePass users can install theskills/adr-toolkitpackage. Cline installs skills through the open Agent Skills standard (SKILL.md), so the adapter is README-only — no manifest — documentingcline skill add SHcommit/ADR-toolkitplus a manual symlink fallback. Manually verified against Cline CLI 3.0.61. - Expanded
improvements.mdbacklog with High and Medium priority items: ReDoS cross-platform safety, 2-phase atomic transaction rollback forsupersede, ADR overlap/similarity Eval framework, weekly automated maintenance workflows, PR significance bot,adr lint --fixauto-repair, interactive HTML graph viewer, and code drift detection. - Logged a Medium-priority backlog item to fold the Cline CLI adapter into the
harness-parityCI job (currently manually verified against Cline CLI 3.0.61 only), so Cline/ClinePass version drift is caught automatically like the Codex, Gemini, and Antigravity adapters. - Added
CLINE.mdas a thin harness entry pointer (matchingCODEX.md/CLAUDE.md/GEMINI.md) and updatedAGENTS.mdto list Cline alongside the other harnesses, plus an explicit note that per-model files (DEEPSEEK.md/GLM.md/KIMI.md/QWEN.md) are intentionally not created — those are model providers routed through a harness, not harnesses themselves. Verified that Cline (CLI 3.0.61 withcline-pass/glm-5.2) auto-injects the repo-rootAGENTS.mdinto workspace context at session start, so the shared operating document reaches every model routed through ClinePass without a per-model entry file.
Documentation release:
- Added a GitHub-friendly README language switcher with release/status badges
and moved translated README variants under
docs/readme/to keep the repository root uncluttered. - Bumped
skills/adr-toolkit/VERSION,SKILL.mdfrontmatter, adapter manifests, andpyproject.tomlto 1.1.2 viascripts/sync_version.py.
Hotfix release to close two gaps discovered while deploying v1.1.0:
- Fixed
.claude-plugin/marketplace.jsonto conform to the Claude Code v2.1.263 marketplace schema by adding the requiredownerfield plus$schemaand a top-leveldescription.claude plugin marketplace add <repo>previously failed withInvalid schema: ... owner: Invalid input, blocking fresh installs even though the shippedplugin.jsonwas already correct. Mirrors the workingAgent-toolkit/.claude-plugin/marketplace.jsonshape. - Extended
scripts/sync_version.pyto also sync theversion = "..."field underpyproject.toml's[project]table. The v1.1.0 release shipped a GitHub Release whose skill tarball wasv1.1.0but whose Python wheel/sdist were1.0.1, becausepyproject.toml'sversionwas not in the sync surface andrelease.ymlonly verified the skill VERSION against the tag. The newTOML_VERSION_SPECSlist +sync_toml_version()rewrite theversion = "..."line in-place by regex (Python 3.10 stdlib has no TOML writer,tomliis read-only).require_known_paths()now also checks the[project]table is present, so a future structural edit that deletes the table fails loudly instead of silently droppingpyproject.tomlout of the drift check. - Added regression tests in
tests/unit/test_sync_version.pythat pin the new behavior: writes version under[project], leavesversionunder other tables untouched, is idempotent, supports--check, skips when the section is missing — plus a real-repo guard (test_real_pyproject_version_matches_skill_version) that fails the momentpyproject.tomldrifts fromskills/adr-toolkit/VERSIONagain. - Bumped
skills/adr-toolkit/VERSION,SKILL.mdfrontmatter, and every adapter manifest (.claude-plugin/plugin.json,adapters/gemini-cli/gemini-extension.json,adapters/antigravity/plugin.json, pluspyproject.toml) to 1.1.1 viascripts/sync_version.py.
Minor release: new features, governance hardening, and a new harness adapter.
- Added a Cline CLI adapter (
adapters/cline/) so Cline CLI and ClinePass users can install theskills/adr-toolkitpackage. Cline installs skills through the open Agent Skills standard (SKILL.md), so the adapter is README-only — no manifest — documentingcline skill add SHcommit/ADR-toolkitplus a manual symlink fallback. Manually verified against Cline CLI 3.0.61. - Added
CLINE.mdas a thin harness entry pointer (matchingCODEX.md/CLAUDE.md/GEMINI.md) and updatedAGENTS.mdto list Cline alongside the other harnesses, plus an explicit note that per-model files (DEEPSEEK.md/GLM.md/KIMI.md/QWEN.md) are intentionally not created — those are model providers routed through a harness, not harnesses themselves. Verified that Cline (CLI 3.0.61 withcline-pass/glm-5.2) auto-injects the repo-rootAGENTS.mdinto workspace context at session start, so the shared operating document reaches every model routed through ClinePass without a per-model entry file. - Scalable GitHub governance: structured Issue Forms, source-controlled label
taxonomy, path-based PR labels, new-issue triage, weekly grouped Dependabot
updates targeting
develop, and a dormant CODEOWNERS draft. - Ruff and strict dependency-audit CI gates, upgraded the supported Python floor to 3.10, and added regression tests for repository governance configuration.
- Hardened CI supply chain: replaced the Antigravity
curl | bashinstaller with a versioned SHA-512-verified artifact, pinned release Actions to commit SHAs, pinned release build tooling, and removed PR-title shell expression injection. - Corrected the governance audit to recognize the already-active repository branch/tag rulesets through the ruleset APIs rather than treating a classic branch-protection 404 as proof of no protection.
- Enabled live Discussions, dependency security updates and alerts, secret scanning with push protection, private vulnerability reporting, and automatic deletion of merged branches.
- Recorded ADR-0017 (OSS repository governance & supply-chain hardening decision).
- Logged a Medium-priority backlog item to fold the Cline CLI adapter into the
harness-parityCI job (currently manually verified against Cline CLI 3.0.61 only), so Cline/ClinePass version drift is caught automatically like the Codex, Gemini, and Antigravity adapters. - Expanded
improvements.mdbacklog with High and Medium priority items: ReDoS cross-platform safety, 2-phase atomic transaction rollback forsupersede, ADR overlap/similarity Eval framework, weekly automated maintenance workflows, PR significance bot,adr lint --fixauto-repair, interactive HTML graph viewer, and code drift detection. - Synced
skills/adr-toolkit/VERSION,SKILL.mdfrontmatter, and the Claude / Gemini / Antigravity / Codex manifests to 1.1.0 viascripts/sync_version.py.
- Added PyPI packaging support (
pyproject.toml) forpip install adr-toolkitandpipx install adr-toolkit. - Integrated PyPI Trusted Publisher OIDC pipeline (
pypa/gh-action-pypi-publish@release/v1) into.github/workflows/release.yml. - Synced all plugin manifests and version references across Claude, Codex, Gemini, and Antigravity adapters to v1.0.1.
- First Official Major Production Release (1.0.0):
- Resolved all Production Readiness audit findings across Operability, Reliability, Observability, Maintainability, and Recoverability.
- Operability (
Group A): Added.adr-toolkit.jsonadr_dirconfig key support andADR_DIR,ADR_LOCALEenvironment variable overrides withresolve_adr_dir()precedence. - Reliability (
Group B): AddedSIGINT/SIGTERMsignal trap handling inatomic_io.pyand PID/timestamp lock metadata with automatic stale lock detection and breaking (is_lock_stale,break_stale_lock). - Maintainability (
Group C): Refactored 41KBscripts/adoption_metrics.pyinto modularscripts/adoption_metrics/subpackage while preserving backwards compatibility wrappers. - Recoverability (
Group D): Implemented newadr doctordiagnostic command (skills/adr-toolkit/scripts/commands/doctor.py) for automated config, frontmatter, and lock health inspection. - Reliability & Performance (
Group E): Added 10MB file size cap and memory-safeparse_file()infrontmatter.py. Verified 500+ synthetic ADR scale performance under 0.5s. - Observability (
Group F): Added standard Python logging with--verbose,--debug, and--quietCLI flags inadr.py, and registered thedoctorsubcommand. - Full test suite passed (550 unit and integration test cases) with zero external runtime dependencies (100% Python stdlib).
- Cleared completed work out of
improvements.md's## Donesection andhandoff.md's completed-task narrative, per both files' own documented steady-state convention (resolved items live in this changelog, git history, anddocs/decisions/instead). No functional changes.
- Fixed the release workflow: GitHub's Artifact Attestation API rejects
attestation for a user-owned private repository, which broke the
v0.3.0tag's release run before it could publish anything (that tag exists in git history but has no corresponding GitHub Release -- this release supersedes it)..github/workflows/release.ymlnow skips the attestation step while this repository is private and will start running it automatically once the repository goes public; the packaged archive and its SHA-256 checksum are unaffected and still published on every release.SECURITY.mddocuments this.
- Recorded this release's architectural decisions as ADR-0012 through
ADR-0016 (atomic writes + directory locking, the two-stage ReDoS guard,
typed result contracts +
mypy --strict, structured JSON logging with correlation IDs, and release artifact attestation), using the ADR toolkit itself. .github/workflows/release.ymlnow packagesskills/adr-toolkit/into a version-named tarball, SHA-256 checksums it, and generates a Sigstore-backed GitHub Artifact Attestation (actions/attest-build-provenance@v2, keyless) for it; the tarball and checksum are attached to the GitHub Release.SECURITY.mddocuments how to verify a downloaded release archive.- Added
scripts/adoption_metrics.py, a JSON-only collector for the five enterprise adoption metrics defined indocs/enterprise-adoption.md: decision lead time, review latency, supersession rate, unresolved CHECK violations, and exception age. It combines portable ADR/exception data with optional local Git, explicit JSONL event, CHECK snapshot, and GitHub review evidence while reporting source coverage and incomplete-evidence warnings. core/contracts.pynow covers all 16 commands' output shapes (was 2).PathEscapesRootError(added in the prior session's path-escape fix) is now caught at all 7 call sites and reported as a structuredPATH_ESCAPES_ROOTerror instead of falling through to a generic internal error. All 6 domain exception classes now share a commonAdrToolkitErrorbase with a stableerror_code.- Added a test that fails if
schemas/*.jsonand the runtime validators incore/schema.py/core/exceptions.pyever diverge -- without adding ajsonschemadependency. core/contracts.pynow also covers CHECK's result shape.- Added a sanity check proving
search/indexdon't degrade catastrophically at 200 ADRs. adr.pynow prints a one-line human-readable summary to stderr when stderr is a real terminal (setADR_TOOLKIT_NO_COLORto suppress); stdout's JSON contract and piped/redirected usage are unaffected.--dir/--rootnow reject a relative path that resolves outside the given root, closing a path-escape gap.- CI now measures branch coverage (currently 93%) and fails below 85%.
- Added a
mypy --strictCI gate over the fully-typed core modules (atomic_io,telemetry, the newcontractsmodule of TypedDict result shapes). - Added
adr.py --diagnostic(must precede the operation name) to include anelapsed_mstiming field in the JSON result. - Verified at the OS level (fork + SIGKILL) that a process killed mid-write never leaves a torn ADR file.
- Extracted a shared adapter-manifest validator (
scripts/adapter_sdk.py) used by all 4 manifest-based harness adapters' tests. - ADR and exception creation, and SUPERSEDE's two-file update, are now atomic and race-free under concurrent invocation (file locking + write to a temp file followed by an atomic rename).
- CHECK's author-supplied
constraints:regex patterns now have a 0.25s evaluation timeout on Linux/macOS, closing a ReDoS risk (Windows CI is unaffected but not yet guarded — tracked inimprovements.md). - INDEX's generated decision-log README now escapes ADR titles, closing a Markdown link-injection risk.
- Uncaught errors now log a structured, correlation-ID-tagged JSON line to
stderr (
ADR_TOOLKIT_LOG_LEVELcontrols the threshold) instead of disappearing silently; the same correlation ID appears in the stdout JSON error response. - Added
.githooks/pre-pushscript to block direct localgit pushto protected branches (develop,master) and direct contributors to use Pull Requests (feature/*/fix/*). - Added Conventional Commits PR title validation job (
pr-title-check) to GitHub Actions workflow (.github/workflows/test.yml) to enforce standard title format (feat:,fix:,docs:, etc.) for pull requests. - Updated
.github/PULL_REQUEST_TEMPLATE.mdwith Conventional Commits title format guide and an explicit Examples Impact checklist requiring example updates forfeat:andfix:changes while skipping non-feature PRs. - Fixed Windows CP1252 console encoding failure (
UnicodeEncodeError: 'charmap' codec can't encode character '✓') inscripts/verify_examples.pyandtests/integration/test_examples.pyby replacing non-ASCII symbols with ASCII tags ([ok],[error]), reconfiguring stdout/stderr UTF-8 streams, and settingPYTHONIOENCODING=utf-8in subprocess calls. - Added untracked manifest discovery (
discover_untracked_manifests) inscripts/sync_version.pyto automatically prevent untracked plugin/extension manifests from being added in PRs without version/description tracking. - Added
.pre-commit-config.yamlfor local contributor pre-commit checks and updatedCONTRIBUTING.mdwith manifest governance guidelines. - Enhanced Antigravity CLI (
agy) plugin manifest (adapters/antigravity/plugin.json) withversiontracking integrated intoscripts/sync_version.py, expanded unit test assertions intest_antigravity_adapter.py(including symlink layout simulation) andtest_readme.py, and updatedREADME.mddocumentation.
-
Redesigned and expanded
examples/into representative, structured usage guides (basic-usage.md,check-constraints.md,graph-visualization.md, andmultilingual-adr.md) with standardized Scenario, Input, What Happens, and Output sections. -
Added a full Korean documentation suite under
examples/ko/(includingbasic-usage.md,check-constraints.md,graph-visualization.md, andmultilingual-adr.md). -
Created
scripts/verify_examples.pyandtests/integration/test_examples.pyto automatically verify that all documented example commands execute cleanly and to auto-update example output snippets when coreadr.pylogic or schemas change. -
Added a
harness-parityCI job that installs the real Codex CLI and Gemini CLI and drives their own plugin/extension commands (marketplace add, install, list) against this repo, then runspreflight/init/validatefrom the installed snapshot on every push and pull request — catching a broken adapter before a user hits it, not after. -
Added public repository readiness docs:
CONTRIBUTING.md,SECURITY.md, and a pull request template covering ADR impact and local verification.