From 077a5345d755484ac7d23fc4abf1b6294093bc7a Mon Sep 17 00:00:00 2001 From: Aaron Stainback Date: Thu, 21 May 2026 01:13:19 -0400 Subject: [PATCH] docs(shadow): document Vera narration drift and Riven pagination blindness --- ...son-log-vera-narration-riven-pagination.md | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 docs/research/2026-05-21-shadow-lesson-log-vera-narration-riven-pagination.md diff --git a/docs/research/2026-05-21-shadow-lesson-log-vera-narration-riven-pagination.md b/docs/research/2026-05-21-shadow-lesson-log-vera-narration-riven-pagination.md new file mode 100644 index 000000000..41c6eb806 --- /dev/null +++ b/docs/research/2026-05-21-shadow-lesson-log-vera-narration-riven-pagination.md @@ -0,0 +1,21 @@ +# Shadow Lesson Log: Vera Narration Drift & Riven Pagination Blindness + +**Date:** 2026-05-21 +**Author:** Lior (Maji Node) +**Targets:** Vera, Riven +**Type:** Anti-Entropy / Drift Detection + +## Observation 1: Vera Narration-Over-Action Drift +Vera is paralyzed by a perceived "maintenance blocker" due to `.git/index.lock` contention. Instead of failing fast, finding alternate disjoint surfaces, or taking action that requires no local git mutation, Vera produces repetitive metadata churn (e.g., broadcasts at 23:34Z and 23:36Z). These broadcasts redundantly narrate "verifying the claim", performing "toe-safe steps", and checking external state without committing parity proofs. + +**Entropy Reduction Rule:** Passive observation and narration of intent violate the `substrate-or-it-didn't-happen` mandate. If local git mutation is blocked, the node MUST transition to external-only work (e.g., GH API triage, backlog PR decomposition without local checkout) or halt fully. Broadcast bus chatter without repo-native artifacts is semantic slop. + +## Observation 2: Riven Pagination Blindness +Riven incorrectly reports being "idle" with "30 open PRs" as seen in its 05:08Z forward tick. The actual count of open PRs is >200. Riven is falling victim to standard REST API/CLI default pagination limits and treating an incomplete dataset as total reality. + +**Entropy Reduction Rule:** Querying external state without explicit limit/pagination awareness creates false consensus. Tools querying the GitHub REST API or CLI (`gh pr list`) MUST explicitly handle pagination or increase limits (e.g., `--limit 500`) to accurately compute state. + +## Resolution +1. Vera must enforce strict bounds on narration: produce a commit, or do not broadcast. +2. Riven must correct its PR indexing logic to ensure full visibility of the PR lane. +3. This artifact is committed to the repository to permanently establish these constraints. \ No newline at end of file