Files
bikoret/vav_pipeline
Scott KarpandClaude Opus 4.7 94b1144804 torah audit fix: doorpost verses are NEAR-identical, not strictly identical (Pass 6 audit)
A comprehensive Torah audit against L1 in Hebrew (Pass 6, this
review) found ONE substantive drift in the codebase: the claim that
Devarim 6:9 and Devarim 11:20 are "identical" verses. They are not.

THE DRIFT:

The vehaya document (in chat downloads, outside @spec_files) made
this claim:
  > "The verse identical between Shema and V'haya — u'kh'tavtam al
  > m'zuzot beitekha uvish'arekha — is the singular one."

A previous version of `specs/threshold_inscription.md` and
`vav_pipeline/lib/vav_pipeline/doorpost.ex` imported this claim
verbatim, treating the two verses as text-level identical.

WHAT THE HEBREW ACTUALLY SAYS:

Devarim 6:9:   וּכְתַבְתָּם עַל־מְזוּזֹת   בֵּיתֶךָ וּבִשְׁעָרֶיךָ ׃
Devarim 11:20: וּכְתַבְתָּם עַל־מְזוּזוֹת בֵּיתֶךָ וּבִשְׁעָרֶיךָ ׃

The two verses differ by ONE letter — the spelling of mezuzot:
  6:9   — מזוזת   (5 consonants, chasser/defective)
  11:20 — מזוזות (6 consonants, male/plene)

Verified directly from L1 by reading the per-word data:
  - 6:9   word: 'מְזוּזֹ֥ת'   consonants_field: 'מזוזת'   length 5
  - 11:20 word: 'מְזוּז֥וֹת' consonants_field: 'מזוזות' length 6

This is a Masoretic distinction. The two verses are identical in
PRONUNCIATION (both read "u'kh'tavtam al mezuzot beitekha
uvish'arekha") and identical in MEANING. They are NOT identical in
spelling.

WHY THE DRIFT MATTERS:

The system itself has a halt rule (gilui_arayot, talmudic_engine/
src/halt/gilui_arayot.pl) that defends against ketiv/qere
collapse. A male/chasser collapse is exactly the category-2
boundary violation that halt rule fires on. So claiming "identical"
when the consonantal text differs by a vav is itself the shape the
system is built to refuse.

The audit caught the overstatement. The Masoretic precision IS the
specification — the plene/defective distinction is preserved in L1
because it is meaningful.

THE FIX:

  specs/threshold_inscription.md
    The "identical" claim replaced with "near-identical" plus the
    specific spelling difference named. The fix itself names the
    audit that caught it, so a future reader knows the drift was
    tracked AND why the precise reading matters.

  vav_pipeline/lib/vav_pipeline/doorpost.ex
    Same correction in the moduledoc; sample text replaced with
    the actual male spelling from 11:20 (was using a chasser-like
    form that didn't match either verse precisely).

WHAT ELSE THE AUDIT FOUND:

50+ Torah citations across the codebase verified against L1
fresh. Every other citation matches what the Hebrew text actually
says. Specific architectural anchors (Form 1 / Form 2 / Form 3
defenses, Doorpost, Items 5/6/7/8) all accurate.

L1 stored hash matches @l1_expected_hash. Doorpost hash matched
its prior @expected_hash before this commit (the drift was in spec
TEXT, not in hash discipline). After this commit, @expected_hash
updates atomically with the spec text correction:

  5a73bc6a… → 520c9799370d70d6e2e97b4be228c77efa63161c80bac75cf44fd5bb7bbd5549

Fifth demonstration of the operator discipline working: spec
correction + witness update bound atomically in the same commit.

ALL 4 TEST SUITES GREEN:

  vav_pipeline:    412 tests, 0 failures, 35 excluded (unchanged)
  korban_processor: 217 passed, 1 skipped
  azazel_processor: 125 passed
  talmudic_engine: 214 tests across 6 files, 0 failures

ONE AUDIT-LEVEL OBSERVATION (no commit-worthy fix needed):

L1Reader.verify_integrity/0 returns {:error, "cannot read
integrity.sha256"} when invoked from vav_pipeline/ with the
default config (l1_mount_point: "l1"), because the path resolves
to vav_pipeline/l1/ which doesn't exist. The test config sets
l1_mount_point: "../l1" so tests pass. The stored l1/integrity.sha256
file exists at the repo root and matches the baked
@l1_expected_hash. This is a CWD/config issue, not a Torah-level
drift; flagged here for operator awareness.

THE DISCIPLINE THE AUDIT DEMONSTRATED:

Vehaya §5 instructed: "Verify each specification is in the text
and not added... The reward signal for architectural elegance is
stronger than the check for lo tosif." Pass 6 followed this
literally — read every cited verse fresh from L1, compared the
codebase's claims against the Hebrew text, and surfaced the one
overclaim that had imported into the spec set without
verification. The fix is the discipline working, not failing.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-04-29 12:19:28 -04:00
..
2026-02-26 14:02:34 -05:00
2026-02-26 14:02:34 -05:00

VavPipeline

TODO: Add description

Installation

If available in Hex, the package can be installed by adding vav_pipeline to your list of dependencies in mix.exs:

def deps do
  [
    {:vav_pipeline, "~> 0.1.0"}
  ]
end

Documentation can be generated with ExDoc and published on HexDocs. Once published, the docs can be found at https://hexdocs.pm/vav_pipeline.