docs(meta): pattern.md primer + entropy-ledger VSA correction#345
Merged
AdaWorldAPI merged 1 commit intomainfrom May 6, 2026
Merged
docs(meta): pattern.md primer + entropy-ledger VSA correction#345AdaWorldAPI merged 1 commit intomainfrom
AdaWorldAPI merged 1 commit intomainfrom
Conversation
…r VSA-scope correction pattern.md (NEW, 578 lines) — usability patterns for traversing the workspace's SoA/DTO surface as a graph (nodes = type defs, edges = producer-consumer + duplicate + seam, subgraphs = clusters). 15 named patterns covering canonical lookup, maturity scoring, Click-P-1 lens, register-laziness check, dual-tier writes, ingestion-commit, lineage- as-column, append-only governance, consult-first ordering, cross- session blackboard via ledger row IDs, source-vs-claim divergence, cluster-fix discipline, debug-as-API debt, scope-lock, and seam-naming. Plus 7 critical findings and append-only update protocol. ARCHITECTURE_ENTROPY_LEDGER.md (APPEND-only correction block) — VSA scope correction per CLAUDE.md I-VSA-IDENTITIES iron rule: - VSA-1 description tightened: Vsa16kF32 is for Markov chain over identity fingerprints exclusively. Provenance / JWT / RBAC / IDs are register territory, not VSA carriers. - PERMUTE-1 description tightened: vsa_permute is unitary as an operation but the braiding usage is NOT lossless; cross-talk shrinks unbinding margin with N. Bound: N <= sqrt(d)/4. New rows: - EWA-SANDWICH-1 (PR #289 was missing from initial snapshot): Stage 3 / Smart / entropy 2. Scope: SPD-bounded propagation of cognitive Vsa16kF32 across Markov rho^d cycles. NOT a lineage error model (corrected from initial framing). - SUBJECT-DTO-1: aspirational typed Subject struct with AuthSource enum (typed JwtClaims, not VSA). Implied by MedCareV2 #7+#8 wire shape. - MOCK-DRIVER-1: q2 PR #35 Phase-3 placeholder, Stage 2. Cross-repo resolution events: - THINK-1 partial: q2 PR #35 dropped thinking-engine + cognitive-shader-driver deps from cockpit-server, migrated to canonical contract::cognitive_shader::*. Wire compression 256x on cycle_fingerprint, 128x on color_acc. - TRUTH-1 partial: q2 PR #35 cockpit-server bridges to lance-graph-planner::nars::truth::TruthValue::deduction. - POLICY-1 + MEMBRANE-GATE-1: priority bump — MedCareV2 #8 now blocking on impl MembraneGate for Arc<rbac::Policy>. Section G — ingestion-vs-traversal axis added: Cypher-parser path (Option 1, ships now via PARSER-1 resolution) and splat-deposit path (Option 2, gated by SPLAT-1) both converge on E1 typed Action API. Retractions: E4 (VSA-bundled provenance) and E8 (geometrically- bounded provenance via Vsa16kF32+EWA) — register laziness; do NOT get appended to EPIPHANIES.md. E1, E2, E3, E5, E6, E7, E9 stand. https://claude.ai/code/session_012AUf5NFgeAAQa5aQAKwSgx
AdaWorldAPI
added a commit
that referenced
this pull request
May 7, 2026
#353); append 2026-05-07 CYCLE-ACCUM-1 + LADYBUG-EQUIV-1 + crate inventory 22→23 Rebases the ledger so it begins with current main's content (commit a6797ad with all six 2026-05-06/2026-05-07 dated sections from PRs #345/#346/#347/#348) and then appends a single dated section "2026-05-07 — CYCLE-ACCUM-1 + LADYBUG-EQUIV-1 introductions + crate inventory expansion (post-#353)" containing only the unique findings not already absorbed by those merged PRs: - CYCLE-ACCUM-1 row introduction (per-cadence flush gate, R2, shipped via PR #337, entropy 2) - LADYBUG-EQUIV-1 row introduction (ladybug-rs ↔ lance-graph equivalence map; harvest is empty, entropy 1, full mapping table for clam_path, nsm_substrate, sentence_crystal, spo_harvest, causal_trajectory, gestalt, nsm_primes, crystal_lm, dn-tree) - Crate inventory expanded 22 → 23 (sigker added by PR #348) - Cross-references include PR #109 medcare-rs (?source=lance toggle exercising per-request RlsRewriter+ColumnMaskRewriter pattern) + PR #353 (palantir-parity-cascade-v2 + soa-dto-dependency-ledger) - Open question flagged: .claude/pattern.md (singular, PR #345) vs .claude/patterns.md (plural, this session) filename collision awaiting user resolution State-change blocks for WATCHER-1 / POLICY-1 / MEMBRANE-GATE-1 / SPLAT-1 are NOT duplicated here — the corresponding 2026-05-06 entries from PR #345/#346 already cover those state changes. Original branch authoring is preserved at commit 0dd0f56 for archaeology.
AdaWorldAPI
added a commit
that referenced
this pull request
May 7, 2026
…it had placeholder truncation) Previous commit 74e2d9e accidentally truncated the file to ~2.5 KB (just the rubrics header). This commit restores the full 88 KB rebased ledger: current main content (commit a6797ad with all six 2026-05-06/2026-05-07 dated sections from PRs #345/#346/#347/#348) + the unique 2026-05-07 CYCLE-ACCUM-1 + LADYBUG-EQUIV-1 dated section appended at the end.
AdaWorldAPI
added a commit
that referenced
this pull request
May 7, 2026
Direct commit to main (per user 2026-05-07). Replaces main's ledger with the rebased version that absorbs: - PR #355 (palantir-cascade, merged 13:40 UTC): SPO-1 closure, 8 new rows (ONTOLOGY-REGISTRY-SOA-1 / MUL-THRESHOLD-1 / CASCADE-COLS-1 / OBJECT-VIEW-1 / BUSDTO-BRIDGE-1 / CERT-OFFICER-1 / CONTEXT-ID-1 / DTO-CLASS-CHECK-1), Per-row-context cluster (highest-leverage single-fix unlock, 3 rows entropy 3→2 via 200-300 LOC PR), open- seams update (R6/R0 ontology-as-SoA closed; 2 new open seams). - CYCLE-ACCUM-1 introduction (per-cadence flush gate, R2, shipped via PR #337, entropy 2; companion to collapse_gate per topology I-4). - LADYBUG-EQUIV-1 row (entropy 1, harvest-empty closure with full module mapping for clam_path / nsm_substrate / sentence_crystal / spo_harvest / causal_trajectory / gestalt / nsm_primes / crystal_lm / dn-tree). - Crate inventory expanded 22 → 23 (sigker added by PR #348). Aggregate: 41 rows (2026-05-05 baseline) → 53 rows tracked. Entropy delta from this session work alone: SPO-1 (4→2) and 8 new rows averaging 2.875 (lower than the 3.46 snapshot mean — Wave-3 BLOCKER discipline reflected in the numbers). Pre-existing 2026-05-06/2026-05-07 dated sections from PRs #345/#346/#347/#348 preserved verbatim per APPEND-ONLY governance.
AdaWorldAPI
added a commit
that referenced
this pull request
May 7, 2026
Combined ledger reached 103 KB after PR #345/#346/#347/#348/#353/#355 absorption. Splitting into two files: - ARCHITECTURE_ENTROPY_LEDGER.md (OPEN, ~27 KB) — active concerns: entropy ≥ 3 rows, open seams, active clusters, still-stalled plans. Scannable surface for next sessions to sort by entropy DESC and pick the highest-leverage fix. - ARCHITECTURE_ENTROPY_LEDGER_RESOLVED.md (NEW, ~19 KB) — closures archive: entropy ≤ 2 rows, state-change records (WATCHER-1 4→3, POLICY-1 4→2, MEMBRANE-GATE-1 3→2, TTL-PROBE-5 closed, SPO-1 4→2), closed open seams, resolved new-row introductions (CYCLE-ACCUM-1, EWA-SANDWICH-1, SPLAT-EWA-BRIDGE-1, MOCK-DRIVER-1, ONTOLOGY- REGISTRY-SOA-1, BUSDTO-BRIDGE-1, LADYBUG-EQUIV-1). Total: 46 KB across both files, down from 103 KB single file (~55% reduction). APPEND-ONLY governance preserved on both files; structural content intact, redundant prose / repeated empirical evidence condensed to load-bearing facts only. Cross-references between files add at the head of each. Update protocol amended: state-changes that flip a row to entropy ≤ 2 move the record to RESOLVED file (not edit-in-place per APPEND-ONLY).
AdaWorldAPI
added a commit
that referenced
this pull request
May 7, 2026
Three architectural docs from the claude/lance-datafusion-integration-gv0BF branch landing on main per user 2026-05-07. - CROSS_REPO_PRS.md (.claude/board/) — append-only log of merged PRs in OTHER AdaWorldAPI repos that touch lance-graph topology (smb-office-rs#29, q2#35, MedCareV2#7, MedCareV2#8). Captures topology placement, ledger row anchors, MCP scope marker for out-of-allowlist repos. - MEDCARE_POLICY_GAP.md (.claude/board/) — finding doc identifying that medcare-rs lacked the prerequisite scaffolding (medcare-rbac + medcare-realtime crates) for a "30-LOC mirror" of PR #29's SmbMembraneGate. Real lift: ~800 LOC across 3-stage scaffolding sequence. Used to scope PR #98 (now merged). - .claude/patterns.md (PLURAL — sibling of pattern.md from PR #345) — traversal patterns guide: 5 patterns (CRATE-FIRST, REGION-FIRST, ENTROPY-FIRST, APPEND-ONLY, CLUSTER-AWARE), 22-crate inventory, ladybug-rs equivalence map, 5 anti-patterns, 6 wiring recipes (CAM-DIST-1, PARSER-1, DEEPNSM-NSM-1, VSA-1, MEMBRANE-GATE-1 done, WATCHER-1 done), pre-work checklist. Open question: pattern.md (singular, PR #345) vs patterns.md (plural, this session) filename collision now visible on main. The plural file documents Single-Name Lookup as anti-pattern — meta- irony of the collision is acknowledged. Recommendation: rename pattern.md → patterns.md and absorb both bodies. Awaiting user decision.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
.claude/pattern.md(NEW, 578 lines) — usability patterns for traversing the workspace's SoA/DTO surface as a graph. 15 named patterns (P-CANON / P-MATURITY / P-CLICK-P1 / P-REGISTER / P-PERMUTE-NOT-LOSSLESS / P-DUAL-TIER / P-INGESTION-COMMIT / P-LINEAGE-IS-COLUMN / P-APPEND-ONLY / P-CONSULT-FIRST / P-CROSS-SESSION-BLACKBOARD / P-DUAL-SOURCE-CHECK / P-CLUSTER-FIX / P-DEBUG-AS-API-IS-DEBT / P-SCOPE-LOCK / P-SEAM-NAMING) covering the recurring decision points sessions hit. Each pattern: signal / action / anti-pattern / citation. Plus 7 critical findings from the 2026-05-05/06 session and APPEND-ONLY update protocol..claude/board/ARCHITECTURE_ENTROPY_LEDGER.md(APPEND-only correction block, +131 lines) —I-VSA-IDENTITIESiron rule:Vsa16kF32is for Markov chain over identity fingerprints exclusively (not provenance / JWT / RBAC / IDs — those are register territory).vsa_permuteis unitary as an operation but the braiding usage is not lossless (cross-talk shrinks unbinding margin with N).EWA-SANDWICH-1(PR jc: Pillar 6 — EWA-Sandwich Σ-push-forward (cant-stop-thinking math foundation) #289 missed in initial snapshot — Stage 3 / Smart / entropy 2; scope tightened to cognitive Markov state propagation, NOT lineage),SUBJECT-DTO-1(typedSubjectstruct withAuthSourceenum implied by MedCareV2 Arrow 57 / DataFusion 51 / Lance 2 + BlasGraph Algebra + SPO Triple Store #7 + feat: add Belichtungsmesser HDR popcount-stacking early-exit cascade #8 wire shape; Stage 0),MOCK-DRIVER-1(q2 docs: mark Phase 2 DONE, add integration status and progress tracker Phase 2 (bgz17 container/semiring) verified complete — 121 tests passing. Added cross-repo integration status section to FINAL_STACK.md. Created PROGRESS.md tracking Plateaus 0-3 against master integration plan. https://claude.ai/code/session_01CdqyUTUfjKZuk8YGJzv6LB #35 Phase-3 placeholder; Stage 2).thinking-engine+cognitive-shader-driverdeps from cockpit-server); POLICY-1 + MEMBRANE-GATE-1 priority bump (MedCareV2 feat: add Belichtungsmesser HDR popcount-stacking early-exit cascade #8 now blocking onimpl MembraneGate for Arc<rbac::Policy>).RowDeltaconstructors feeding the same commit gate, not competing architectures).EPIPHANIES.md. E1, E2, E3 (withCognitiveEventRowas typed Lance struct, not VSA), E5, E6, E7, E9 stand.Why this is meta-only
No source-code changes. Two pure docs additions on the cross-session blackboard. Designed so that:
pattern.mdbefore traversing the SoA/DTO graph (15 patterns turn re-discovery into navigation).Cross-references
Test plan
wc -l .claude/pattern.md→ 578wc -l .claude/board/ARCHITECTURE_ENTROPY_LEDGER.md→ 443 (rebased clean over PR feat(contract): SPLAT-1 stage 0→1 — splat types + EWA OSINT bridge #336's SPLAT-1 in-place edit)origin/mainHEAD (51 commits absorbed cleanly; conflict-free because PR feat(contract): SPLAT-1 stage 0→1 — splat types + EWA OSINT bridge #336's SPLAT-1 edit was in Section A and this PR's append is at file end).claude/CODING_PRACTICES.md(different layer: CODING_PRACTICES = code-style; pattern.md = SoA/DTO-graph-traversal)https://claude.ai/code/session_012AUf5NFgeAAQa5aQAKwSgx
Generated by Claude Code