docs(consume,build): both parent defaults stay off, and the reason is now a measurement

K3-21 B. `cli.DEFAULT_SHELL_PARENT`'s comment said it was off because `okf
consume` reads no `parent` key; after A that sentence was false and the
default was unmeasured in both directions. Re-measured on the one standard
with heading-only sections: hit@1, hit@8 and hit@50 stay 6/6 at both k with
the known-positive at rank 1, but the link's bundle-absolute path repeats
the document's directory in 675 bodies, and the delivered set moved on 2 of
8 questions at the default k and 3 of 8 at k 50, newly delivered shells
matching the question only through that path on 1 of 3, 4 of 7 and 6 of 23
-- the saturation K3-20 took out of the id signal, back through the body.
Off.

`consume.DEFAULT_FOLLOW_PARENT`: the same delivered set as the pointer (16
of 16 payloads), 6 of 6 correct either way on questions whose answers are
never shells, at +2 488 / +2 746 B on the 2 of 8 default-k payloads holding a
linked shell and up to +20 817 B at k 50. Off.

A test holds both defaults and that the false sentence is gone.

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

src/llm_ingestion_okf/cli.py

@@ -173,11 +173,20 @@ DEFAULT_FIRST_SPAN_FROM_ZERO = True
 #: concept count is unchanged and the cost to a consumer is a re-run.
 DEFAULT_CLOSE_SPAN_GAPS = True
 #: Round 20 (K3-20). A section whose body is its heading alone gets `parent:`
-#: naming the nearest ancestor that holds text (`propose._link_shells`). NOT a
+#: naming the nearest ancestor that holds text (`propose._link_shells`) and,
+#: since K3-21, one `Enclosing section:` link line in its body. NOT a
 #: segmentation rule: it adds no boundary and copies no text, and the concept
-#: count is unchanged. OFF, and the default is a measurement of what it buys:
+#: count is unchanged. OFF, re-measured in K3-21 once `okf consume` read the
-#: `okf consume` reads no `parent` key, so no payload ranks differently with
+#: key -- the reason it was off before. On the one standard with shells hit@1,
-#: it, while it moves the bytes of every bundle holding a heading-only section.
+#: hit@8 and hit@50 stay 6/6 at both k with the known-positive at rank 1, but
+#: the link's bundle-absolute path repeats the document's directory in 675
+#: bodies, and the delivered set moved on 2 of 8 questions at the default k
+#: and 3 of 8 at k 50, newly delivered shells matching the question ONLY
+#: through that path on 1 of 3, 4 of 7 and 6 of 23. That is the saturation
+#: K3-20 took out of the id signal, re-entering through the body. It moves the
+#: bytes of a bundle holding a heading-only section and of nothing else: 0 of
+#: 453 K2 bodies are heading-only, and the five-document folder builds
+#: byte-identical with it.
 DEFAULT_SHELL_PARENT = False
 #: Round 9. Clause 1 asked whether a title ENDED in a number, which is a
 #: question about the number rather than about the title: a drawing's dimension

src/llm_ingestion_okf/consume.py

@@ -1696,7 +1696,15 @@ def excerpt_weight(excerpt: Mapping[str, object]) -> int:
 
 
 #: `--follow-parent` (K3-21 B): carry the enclosing concept's TEXT inside an
-#: excerpt's `parent`, rather than the pointer alone.
+#: excerpt's `parent`, rather than the pointer alone. OFF by measurement. On
+#: the one standard with shells it delivers the same set as the pointer, by
+#: construction and measured (16 of 16 payloads, both k), and on six questions
+#: whose answers are never heading-only sections it bought nothing a reader
+#: scored -- 6 of 6 correct either way -- at +2 488 and +2 746 B on the 2 of 8
+#: payloads holding a linked shell at the default k and up to +20 817 B at
+#: k 50. What it does buy shows on a question AT a shell: 3 847 characters of
+#: the enclosing section in the payload, where the pointer alone needs one
+#: `Read`.
 DEFAULT_FOLLOW_PARENT = False
 
 

tests/test_parent_text.py

@@ -157,3 +157,12 @@ def test_the_cli_takes_the_flag_and_its_opt_out(tmp_path: Path) -> None:
     assert consume.parse_args([str(bundle), "--question", SHELL]).follow_parent is (
         consume.DEFAULT_FOLLOW_PARENT
     )
+
+
+def test_both_defaults_are_off_and_the_reason_is_a_measurement() -> None:
+    """K3-21 B re-measured both once `okf consume` read `parent`. A default is
+    a published promise, so it gets a test that goes red when it moves; the
+    numbers behind each are in the comment above the constant."""
+    assert consume.DEFAULT_FOLLOW_PARENT is False
+    assert cli.DEFAULT_SHELL_PARENT is False
+    assert "reads no `parent` key" not in Path(cli.__file__).read_text(encoding="utf-8")