feat(ledger): CSS derive families are names, never bodies — name floor 2 for css, dup: grouping sym-only; derive line says "repeated name" and dismisses scoped-css; plugin 0.1.41 (note #2917)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-23 00:21:17 -04:00
parent a2b377b74d
commit 85111442a6
9 changed files with 104 additions and 43 deletions
@@ -45,8 +45,9 @@ through recall/auto-inject; this skill is the active reflex around that.
  duplicate — reuse it and drop yours — or it isn't, and the record needs the new
  location adding. Both are cheaper now than after the duplicate settles in.
 - **A `Shape ledger at …` line is the ledger speaking, not the record.** It
-  names a duplicate family ("identical body in N other files, no canon") or a
-  canon elsewhere for a name you just wrote — for edits made through Bash
+  names a duplicate family ("identical body in N other files, no canon"), a
+  repeated name ("defined in N other files") or a canon elsewhere for a name
+  you just wrote — for edits made through Bash
  (sed, heredocs, scripts) as much as through Write/Edit. Derive the family or
  reuse the canon *now*; a family that is convention rather than copies is
  dismissed with `classify_shapes(..., status="exempt",
@@ -94,7 +94,8 @@ the last sweep left it. Three surfaces say so without anyone running an audit
 - **At the write** — the prior-art hint (the Write/Edit hook, and since
  0.1.39 the after-write hook on Bash, so sed/heredoc/script edits count too)
  carries a `Shape ledger at <path>` line when a name just written is a known
-  **duplicate family** ("identical body in N other files, no canon") or a
+  **duplicate family** ("identical body in N other files, no canon"), a
+  **repeated name** ("defined in N other files, no canon") or a
  **canon elsewhere** ("snippet #N at <path> — reuse, don't redefine"). Act
  on it *then*: pull the canon and build from it, or derive the family now —
  `create_snippet` the dominant form, repoint the copies, `classify_shapes`
@@ -109,6 +110,14 @@ the last sweep left it. Three surfaces say so without anyone running an audit
  reason_code="convention-plumbing", reason=…)` (or `classify_shapes_by_rule`
  for a whole family) removes it from the queue. Dismissal is a judgment and
  it is recorded; silence is not.
+- **CSS is watched by name, never by body** (note 2917). Classes serving
+  different purposes share declarations because the style system makes them
+  alike — `.text-muted` and `.pin-badge-auto` carrying the same `color:` are
+  two meanings, not two copies — so a CSS family is the *same class defined
+  in ≥2 files* (a recipe living in several places), and identical bodies
+  under different names are never a family. Derive a CSS family by moving
+  the recipe to the shared sheet and recording it; a class name reused for
+  genuinely different things is dismissed with `reason_code="scoped-css"`.

 After the one-time pay-down the derive queue reads empty; anything in it
 afterwards is drift of the moment, and the hint already said so at the write.