All notable changes to this regulation shelf are documented here.
The detailed shelf changelog lives in regulation/shelf/SHELF_CHANGELOG.md.
- GitHub Actions workflows now track the current official
actions/checkoutrelease (v7), closing the remaining stale Dependabot update on the public repo.
- GitHub-hosted hardening is now aligned with the shelf's own public-release expectations, including secret scanning, push protection, Dependabot security updates, and protected
masterstatus checks. - The PowerShell collector no longer carries an unreachable Git Bash branch-selection path, and the Git Bash collector now projects hosted JSON via stdin-backed temporary input instead of environment-variable payload transfer.
- Verdict, distribution, workflow, and verification docs now reflect the current release state without stale examples or ambiguous decision-table wording.
- Branch version metadata now reflects the current
masterstate instead of advertising the previousv1.2.9release after additional commits landed. - The Git Bash collector now projects hosted metadata and latest CI evidence down to the same compact schema used by the PowerShell collector, removing duplicate raw repo payload churn from dogfood transcripts.
- Windows PowerShell regression assertions for hosted issue-template evidence are now order-insensitive across
ABSENT,PASS, andAPI_BLOCKEDcases. - Fixed-message assertions in the Windows collector regression suite now escape literal gate text correctly, so CI matches local verification.
- Windows regression coverage no longer depends on JSON property order when hosted issue-template evidence is emitted.
- The hosted issue-template self-check now stays green on GitHub Actions Windows runners after release-tag timing and PowerShell serializer differences.
ghpublic-API retries no longer misclassify auth-required failures asABSENT; the collectors keep them asAPI_BLOCKEDunless a real 404 payload is present.- PowerShell and Git Bash regression suites now cover the auth-required retry path and fixture initialization needed to keep shelf self-check deterministic after reruns.
- Audit orchestrator and collector docs now align with the current hosted-evidence and exit-semantics behavior.
- Bash and PowerShell collector regressions now verify that access-denied Gitleaks execution-environment artifacts are reported as
SKIPPED, not scoringBLOCKED.
- Quickstart fixture environment names no longer use token-like wording, reducing secret-risk false positives during all-file audits.
- PowerShell collector now resolves
gitleaksfromPATH, including CI-installedgo installbinaries, before declaring the tool unavailable.
- CI Gitleaks installation now uses the current Go module path
github.com/zricethezav/gitleaks/v8.
- CI now installs
gitleaksbefore running regulation tests so the stricter collector exit-code contract is tested on the authoritative baseline route.
collect-audit-evidence.*now exits non-zero when it emits a realresult: BLOCKEDrow while still preserving the full transcript.- README, runbook, and scripts documentation now state that
run-full-audit.*andrun-delta-audit.*are scaffold/evidence orchestrators, not final verdict engines.
- Bash collector now treats Windows Git Bash / WinGet
gitleaks.exeaccess-denied artifacts asSKIPPED, matching the PowerShell route and evidence rules. - Regression tests now fail if blocked collector evidence exits successfully.
- GO role criteria and coverage references for the public value model
- quickstart fixture coverage for manifest env, legacy run, and path assertions
.gitattributesLF normalization for shell scripts
- README now frames the shelf around eight publication-readiness concerns
- evidence rules distinguish raw machine evidence from final gate scoring transcripts
- Windows collector guidance now treats normal Windows PowerShell host-terminal evidence as authoritative for managed-sandbox path artifacts
- audit evidence wording no longer treats a managed sandbox WinGet path artifact as a repository defect after host-terminal proof exists
- tracked documentation text is ASCII-normalized to avoid terminal mojibake
CODE_OF_CONDUCT.md,SUPPORT.md.github/ISSUE_TEMPLATE/*,.github/PULL_REQUEST_TEMPLATE.md.github/workflows/ci.yml(canonical shelf CI; replacesregulation-tests.yml).github/workflows/codeql.yml(G-18 code scanning)
collect-audit-evidence.*checksci.ymlandcodeql.ymlSECURITY.mdsupported versions include1.1.x
README.mdrewritten to matchOUTPUT_PATHS.md,REGULATION_INDEX.md, and full script pipeline (v1.1.6 to 1.1.12 scope)
- tracked-ignored-repo fixture stored as normal files (not gitlink); secret file generated at test runtime
- tracked-ignored regression fixture committed (
local-only.secret; avoids rootAGENTS.mdgitignore)
check-gitignore-consistency.shstores finding fields asseverity|category|path|reason(blocked findings now exit 1 on bash)collect-audit-evidence.shcollects full transcript underset -e(screening/gitignore/gitleaks/pytest/gh no longer abort early)run-delta-audit.shusesawkinstead ofpython; empty changed-path list no longer prints spuriousMlinerun-audit-quickstart.ps1isolated workdir copies dotfiles (.gitignore,.github/, etc.)
- regulation tests for tracked-but-ignored fixture and evidence transcript continuity
run-audit-quickstart.shreads multiline YAML command blocks via NUL-delimited records (Ubuntu CI no longer reportscommands run: 0)
- removed tracked
docs/governance/*filled records; canonical path isaudits/<slug>/only (docs/governance/README.mdpointer) audit.manifest.ymlusesrun_windows/run_unixfor cross-OS quickstart (Ubuntu CI R-08/R-09)collect-audit-evidence.*runs quickstart only when manifest exists; any non-zero exit fails evidencecheck-tracked-files.*blocks filleddocs/governance/paths on shelf and product repos.gitignoreadds recommendedAGENTS.md/CLAUDE.md/.claudeignorepatterns- bash script em-dash output normalized to ASCII
-
templates/audit.manifest.yml.templateandAUDIT_MANIFEST_POLICY.mddocument OS-specific command fieldschecklists/README.mdTier 1 local checklist includesG-21
- publication-decision-record path unified to
audits/<slug>/inEVIDENCE_COMMANDS.md,PUBLICATION_RESPONSIBILITY_MODEL.md,SCOPE_AND_TIERS.md run-audit-quickstart.shparses- id:/ indentedrun:blocks correctly (bash quickstart no longer exits 2 with valid manifest)collect-audit-evidence.shpropagates quickstart failure (aligned with PowerShell)AUDIT_RULES.mdTier 1 range corrected toG-01..G-22
- regulation test fixture for bash quickstart manifest parsing
scripts/check-gitignore-consistency.*- tracked vs.gitignoreindex checks (G-04)scripts/run-delta-audit.*- delta re-audit orchestrator perRE_AUDIT_POLICY.mdregulation/reference/GITIGNORE_CONSISTENCY.mdtemplates/delta-audit-record.md.template
collect-audit-evidence.*includes gitignore consistency outputOUTPUT_PATHS.mddocumentsdelta-audit-record.md
run-delta-audit.*sensitive-path detection uses--name-only(WindowsMpathformat)run-delta-audit.*Open Blockers: 0no longer false-positive invalidates delta
scripts/check-tracked-files.*to screen unnecessary tracked files (G-03,G-04,G-21)regulation/reference/TRACKED_FILE_SCREENING.md
collect-audit-evidence.*includes tracked-file screening outputaudit.manifest.ymlruns screening on shelf quickstart
audit.manifest.ymlfor shelf quickstart automation
- dogfood audit findings: CHANGELOG drift, quickstart recursion, audit-report clobber
run-full-audit.*refuses to overwriteStatus: Finalaudit reportsrun-regulation-tests.*shelf dry-run usesshelf-orchestrator-dry-runslug only- removed hardcoded user workspace paths from README and regulation entry files
docs/governance/self-audit summary updated to release dogfood verdict
- moved all regulation markdown from repository root into
regulation/subdirectories - root now shows README + standard repo files only
- shelf build history:
design/,roadmap/,tasks/ - deprecated meta files:
APPLICATION_GUIDE.md,GITHUB_OPTIMIZATION_*_SUMMARY.md - product audit results from remote tracking (
audits/<slug>/now gitignored)
- shelf moved to project root (
github-optimization/) - GitHub remote scope: regulation files only
audits/layout andaudits/README.mdfor per-repository audit results
- output contract: audit reports belong in
audits/<repository-slug>/, not public product repos run-full-audit.*scaffolds shelfaudits/<slug>/with optional-AuditSlug- regulation tests, templates, policies, and checklists updated to new paths
- root policy files, CI workflow, Dependabot, and shelf self-audit artifacts
- PowerShell gitleaks stderr normalization
- complete generic regulation shelf for agent self-check
- 46 gate model, runbook, templates, and evidence scripts
- shelf self-validation, dry-run tests, distribution docs, and git tag
v1.0.0