Changelog & Migration Guide
This page consolidates operational and breaking-change history from rev4 through rev4.4.
Upgrading Safely
- Re-run
policy/bootstrap.shto upgradehooks/andpolicy/idempotently; the script backs up and restores existingprivate-seed.json,sanitize-map.json,private-repos.json, and.resolve.json. - If upgrading from pre-
rev4setups, move any custom private repo names and internal regexes into$GUARD/private-seed.json(orGUARD_SEED_B64), pass any package archive URL viaGUARD_PKG_URLrather than editing source files, and re-runpolicy/install-settings.pyto addforbid-read-path.sh(Read|Grep). gpg.ssh.allowedSignersFileis no longer required; R6 validatesgpgsigdirectly viassh-keygen -Y check-novalidate.
Release History (rev4 – rev4.4)
rev4.4: Primary Platform Source Split, CLI Token Reads & Windows Path Fix
- Elevated the configured primary hosting platform API as the default private repo list source while keeping GitHub (
GH_TOKEN_1..N/ghCLI) optional; updatedbuild-secure-token.pyto accept either token prefix anddoctor.pyto recognizeseed-env. - Added
~/.git-credentialsand CLI login token paths toforbid-read-secret.shandforbid-read-path.sh. - Fixed Windows path enforcement in
forbid-read-path.shby accepting drive-letter paths (C:\...,C:/...) and normalizing backslashes to/afterrealpath.
rev4.3: End-to-End UTF-8 Standardization (Chinese Windows / GBK Fix)
- Exported
PYTHONUTF8=1in all shell wrappers, reconfigured Python standard streams to UTF-8, and passed explicitencoding='utf-8'across file I/O and subprocesses to eliminate silentUnicodeDecodeErrorfallbacks on GBK systems.
rev4.2: Re-sign Exemption, True Remote Tips & R2/R7 False-Positive Tuning
- Added
known_content(resign_exemptdefault on) using(tree, parent trees)signatures andgit patch-id --stableagainst real remote tips (git ls-remote) so re-signed or rebased commits skip duplicate line scans while still enforcing SSH signatures, authors, and messages. - Filtered
R2model regexes inside>=24-character Base64-like runs (in_b64_run) without weakeningR7secret detection, and tightened Google API key matching to isolated 39-characterAIza+ 35-character strings.
rev4 – rev4.1: Core Fail-Closed Split & Complete Tool/Git Coverage
- Stripped all private repo lists, internal domains, and package URLs out of distributable files into local seeds and build-time
GUARD_PKG_URL. - Removed
permissionDecision: allowoutputs (fixing host permission-prompt bypass), addedforbid-read-path.sh(Read|Grep),NotebookEdit(new_source),pre-merge-commit,git push -u origin claude/...matching, 8-character secret masking,core.commentCharstripping,ACMR-only diff scanning, and completeness checks inrefresh-private.py.