claude-dev-env 8.46.20 → 8.46.21

package/docs/rule-guides/failure-blast-radius.md

@@ -42,7 +42,7 @@ for each_member in all_members:
 
 The re-raise comes first, sending an escalation directly through the boundary.
 
-**The boundary recognizes declared types.** A runtime crash inside member work — a `TypeError`, an `AttributeError` — ends the run because its type identifies a code defect. `except Exception` triggers the rule (`CODE_RULES.md` §31).
+**The boundary recognizes declared types.** A runtime crash inside member work — a `TypeError`, an `AttributeError` — ends the run because its type identifies a code defect. `except Exception` triggers the rule (`CODE_RULES.md` §9.7).
 
 ## Repair, park, and the deliverable
 

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-dev-env",
-    "version": "8.46.20",
+    "version": "8.46.21",
     "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
     "type": "module",
     "bin": {

package/scripts/tests/test_code_rules_index.py

@@ -27,7 +27,8 @@ _TEXT_SUFFIXES = frozenset({".md", ".py", ".js", ".mjs", ".ts", ".json", ".xml"}
 _MARKDOWN_LINK = re.compile(r"(?<!!)\[[^]]+\]\(([^)\s]+)(?:\s+[^)]*)?\)")
 _INDEX_ANCHOR = re.compile(r"CODE_RULES\.md#([^\s)\]<>\"`]+)", re.IGNORECASE)
 _NUMBERED_CITATION = re.compile(
-    r"(?:CODE_RULES\s*\u00a7\s*|\bsection\s+)(\d+(?:\.\d+)?)", re.IGNORECASE
+    r"CODE_RULES(?:\.md)?[`'\"]*\s*(?:\u00a7\s*|section\s+)(\d+(?:\.\d+)?)",
+    re.IGNORECASE,
 )
 
 
@@ -129,6 +130,27 @@ def test_should_report_dead_code_rules_anchor() -> None:
         _assert_citations_resolve(index_text, [dead_citation])
 
 
+def test_should_ignore_section_number_of_another_document() -> None:
+    index_text = _INDEX_PATH.read_text(encoding="utf-8")
+    foreign_citation = (_INDEX_PATH, "See the runbook section 12 appendix row.")
+    _assert_citations_resolve(index_text, [foreign_citation])
+
+
+@pytest.mark.parametrize(
+    "citation_text",
+    [
+        "CODE_RULES.md" + " section 12",
+        "``docs/CODE_RULES.md``" + " section 12",
+        "CODE_RULES" + " \u00a712",
+        "CODE_RULES.md" + " \u00a712",
+    ],
+)
+def test_should_report_dead_code_rules_section(citation_text: str) -> None:
+    index_text = _INDEX_PATH.read_text(encoding="utf-8")
+    with pytest.raises(AssertionError, match="dead CODE_RULES" + " section 12"):
+        _assert_citations_resolve(index_text, [(_INDEX_PATH, citation_text)])
+
+
 def _assert_destination_resolves(markdown_path: Path, destination: str) -> None:
     if "://" in destination or destination.startswith("#"):
         return