docs(taxonomy): #499 Virtues AIF mirror script — [secondaire] back-fill prep, gated execution (anti-drift with PR #753)

[jsboige]

Summary

[secondaire] prep work — consolidated tools/499-virtues-aif-columns-apply.py, the MIRROR of the Fallacies contract (PR #753, #498/#707§4a). Applies the ratified deterministic back-fill (plan #750 v2) to Cards/Fallacies/Argumentum Virtues - Taxonomy.csv as the same 2 columns, so both taxonomies share an identical AIF column contract (anti-drift).

Script only — 0 write to the Virtues prod CSV in this PR. Execution is GATED (dry-run by default) until the Fallacies contract (PR #753) is merged + reviewed (ai-01 + jsboige veto). This PR just lands the ready-to-run mirror so the [secondaire] becomes 1 PR once unblocked — reduces post-unblock cycle time. No gate crossed, no blocker removed.

Per ai-01 direction (1pgunw): "Ne reste pas en stand-by, ouvre des PRs en mode autonome." This is the highest-value unblocked [secondaire] work.

What it does (dry-run validated)

$ python tools/499-virtues-aif-columns-apply.py
distribution: undercut=206, undermine=13, rebut=3, empty(root)=1
  undermine pks (13): [34, 36, 49, 55, 56, 73, 137, 139, 140, 153, 154, 155, 158]
  rebut pks     (3): [53, 54, 165]
total with scheme=222 (expect 222), +root empty=1 (expect 1)
new cols at idx 78/79; print_and_play shifted to 80; delta=3799 bytes; all 224 rows 81 cols
byte-preservation mismatches: 0 (must be 0)
>>> DRY-RUN (pass --write; GATED until Fallacies contract PR #753 merged + reviewed)

Derivation (plan #750 v2, ratified; re-confirmed programmatically on master c43bd7b5):

• default undercut/RA-node
• override undermine/I-node if the virtue opposes {889 Mensonge, 804 Acception arbitraire} (fabricated premise)
• override rebut/CA-node if the virtue opposes {340 Appel aux conséquences} (counter-conclusion)

Distribution EXACT: 206 undercut + 13 undermine + 3 rebut = 222 nodes with scheme; 1 root node (pk 0, no scheme) = empty. Matches plan #750 v2's 206/13/3 exactly. 0 overlap between the {889,804} and {340} override sets.

Technique = byte-exact surgical (same as Fallacies PR #753)

Re-writes NO existing field. Byte-exact field-segment splitter (CSV-aware: doubled-quote escapes + embedded newlines), inserts 2 new field-segments, rejoins. Memory lesson [[csv-byte-exact-column-insertion]]. Dry-run self-verifies 0 byte-preservation mismatch (existing fields idx 0-77 + 78-78 original → 81-81 after are byte-identical).

Placement note (anti-drift with Fallacies PR #753)

Inserted AFTER AIF_skosMappingType (idx 77), before print_and_play (idx 78 → shifts to 80). This mirrors the Fallacies placement (PR #753). If the Fallacies open-question-#2 (placement) decision lands as true-file-end instead, change INSERT_AFTER_IDX here — it's a single constant, stays anti-drift.

Discipline

• ✅ 0 write to prod Virtues CSV (dry-run only; --write is GATED, not exercised in this PR).
• ✅ Plan docs(taxonomy): #499 Virtues AIF back-fill plan v2 — refine overrides (804 clean mine + rebut {340}) + distribution exacte 206/13/3 #750 v2 rule re-confirmed programmatically on master (code=truth, not the summary).
• ✅ Byte-exact technique reused (validated on Fallacies PR feat(taxonomy): #498 Fallacies AIF — serialize §7 I/RA/CA into 2 new columns (AIF_attackType + AIF_attackedNode) [reassigned from po-2023] #753); 0 fabrication.
• ❌ Does NOT touch [runtime pending] feat(dnn): #649 RulesExplorer i18n — mirror loc() culture cascade #674/[HOLD post-tag] fix(cardpen): #629 convert relative /Cards paths to raw-master URLs (Option 1) #666/chore(dnn): #131 migrate 12 RazorComponent templates to Razor14 (source-level, runtime pending) #596 (HOLD). Does NOT self-merge.
• ❌ Does NOT execute the back-fill — just lands the script. Execution waits for the Fallacies contract merge.

Request

Review + (if acceptable) merge. This is low-risk prep: a script that doesn't touch any prod file until its gate lifts. Once PR #753 merges + ai-01/jsboige review it, the [secondaire] mirror is 1 PR (python tools/499-virtues-aif-columns-apply.py --write + byte-preservation verify + tests).

cc @jsboige (Option A FYI; anti-drift with Fallacies PR #753).

🤖 Worker po-2024 — [secondaire] prep, dispatch 1pgunw deep-queue.