From 69a0b9b10ce70e2d1fd1d01b11d1accbb09560eb Mon Sep 17 00:00:00 2001 From: bchanot Date: Mon, 2 Nov 2026 20:43:03 +0100 Subject: [PATCH] chore(contract): USAGE.md in FILE SCOPE [gated]; TODO punctuation --- .claude/tasks/TODO.md | 2 +- .claude/tasks/contracts/2026-11-02-phase2-guards-1545.md | 1 + 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/.claude/tasks/TODO.md b/.claude/tasks/TODO.md index b6ba0f2..ff0bf6e 100644 --- a/.claude/tasks/TODO.md +++ b/.claude/tasks/TODO.md @@ -123,7 +123,7 @@ Shared rules for every phase: - [ ] post-run-D residuals (gates, 2026-10-07): settings.json soft_deny names only `gitflow.autopush false` → add "or an unparseable value" (restriction only, settings run); capitalize STEP 6: manual mode with `ahead` = 0 (user pushed by hand between merge and read) matches no closing line, and the 5C `ahead` = 0 bullet still says "(auto-push mode did it)"; release-executor:86 line > 80 cols; push-guard header line 4 > 80 cols (pre-existing); unpushed-guard Stop silence now also covers a missing lib (SessionStart names it) — accepted - [ ] gitflow LOW leftovers (run B, rest done in run D 472cccb): `--end-of-options`/`--` on refname args and `printf %q` in copy-paste hints; `gitflow_delete`: check `_gitflow_checkout_containing_base` rc (lib/gitflow.sh:270) before `--unset-upstream` -- [ ] docker host-root mount spellings uncovered by deny (security gate 2026-10-23, pre-existing): `--volume /:/x`, `-v=/:/x`, `--mount type=bind,source=/,...`; prove each with a harmless analogue (`--settings` one-rule file) before adding Not folded by phase 2 (2026-11-02): needs its own bench rows. +- [ ] docker host-root mount spellings uncovered by deny (security gate 2026-10-23, pre-existing): `--volume /:/x`, `-v=/:/x`, `--mount type=bind,source=/,...`; prove each with a harmless analogue (`--settings` one-rule file) before adding. Not folded by phase 2 (2026-11-02): needs its own bench rows. - [ ] 6 dead deny entries (`Bash(docker run * -v /:*)`, `Bash(git push * :*)`, 4 `Write(...)`) kept by the push-guard T41/T42 non-weakening lock; drop them with a justified-removal list in T42 at the next release (working forms added 2026-10-23) ### Release 3.0.0 diff --git a/.claude/tasks/contracts/2026-11-02-phase2-guards-1545.md b/.claude/tasks/contracts/2026-11-02-phase2-guards-1545.md index 90acea1..b5048d3 100644 --- a/.claude/tasks/contracts/2026-11-02-phase2-guards-1545.md +++ b/.claude/tasks/contracts/2026-11-02-phase2-guards-1545.md @@ -96,5 +96,6 @@ ABANDON: 11 the M3q clause is impossible: the permission matcher does not match - hooks/rtk-rewrite.sh, hooks/.rtk-hook.sha256, lib/tests/rtk-rewrite.test.sh - hooks/code-limits.sh (new), lib/tests/code-limits.test.sh (new) - mods/model-router/hooks/register.ts, register.test.ts +- USAGE.md (write guard documented, final-review Important 3) `[gated 2026-11-02]` - CLAUDE.global.md, README.md, templates/settings/SETTINGS.md, lib/tests/push-guard.test.sh (T62, T63), skills/release-candidate/SKILL.md, agents/release-executor.md, skills/capitalize/SKILL.md (5C declined prompt) - .claude/tasks/plans/2026-11-02-phase2-bench/ (bench, approved.txt, phase2.jq, long-brief.txt), .claude/tasks/TODO.md, docs/superpowers/{specs,plans} (transient), CHANGELOG.md