docs(6209): forty test files — design cascade and stylesheet, embeddings, family canon, forge, backup round trips, inception, placement, platforms, moments, rule move and verification, search scope, facets

Module and test docstrings state what is pinned without the record number
or step that introduced it. Incident accounts become the failure shape in
the present tense: the pipefail head, the code_shapes import, the export
order, the facet dialects, the cross-kind repeat, the write-once kind.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

tests/test_integration_pgvector_search.py

@@ -32,7 +32,7 @@ def _vec(*nonzero_first):
 
 
 def _emb(note_id, user_id, chunk_index, vec):
-    """A chunk row at the current chunker version (#280, migration 0077)."""
+    """A chunk row at the current chunker version."""
     from scribe.services.embeddings import CHUNKER_VERSION, EMBEDDING_MODEL
 
     return NoteEmbedding(
@@ -63,7 +63,7 @@ async def seeded():
         # query vector will be [1,0,0,...]; near ~ identical (sim≈1.0),
         # far is orthogonal (sim≈0.0 -> filtered by the default threshold).
         # near gets a SECOND, weaker chunk (sim≈0.6) — the collapse to
-        # best-chunk-per-note (#280) is under test: near must come back once,
+        # best-chunk-per-note is under test: near must come back once,
         # at its best chunk's score, not twice.
         s.add(_emb(near.id, user.id, 0, _vec(1.0)))
         s.add(_emb(near.id, user.id, 1, _vec(0.6, 0.8)))
@@ -94,7 +94,7 @@ async def test_semantic_search_ranks_and_thresholds_via_pgvector(seeded):
     assert near_id in ids
     assert far_id not in ids
     assert ids[0] == near_id
-    # Chunk collapse (#280): near has TWO chunk rows above the floor (sim≈1.0
+    # Chunk collapse: near has TWO chunk rows above the floor (sim≈1.0
     # and ≈0.6) and must appear exactly once, at its best chunk's score.
     assert ids.count(near_id) == 1
     top_score = results[0][0]