Skip to content

docs(substrate): the spine is the COMPILED ClassView, not SurrealQL (§1.5)#137

Merged
AdaWorldAPI merged 1 commit into
mainfrom
claude/odoo-rs-transcode-lf8ya5
Jun 29, 2026
Merged

docs(substrate): the spine is the COMPILED ClassView, not SurrealQL (§1.5)#137
AdaWorldAPI merged 1 commit into
mainfrom
claude/odoo-rs-transcode-lf8ya5

Conversation

@claude

@claude claude Bot commented Jun 29, 2026

Copy link
Copy Markdown
Contributor

Captures the operator's 2026-06-29 architectural correction into the canonical
substrate doc, so future sessions invest in the spine, not the membrane.

The correction: the facet "versions" are useless because one compiled
ClassView
recombines all the carvings while sinking into OGAR and getting
compiled into the binarynot parsed from SurrealQL (slow even with JIT).

New §1.5 — the spine is the compiled ClassView:

  • a. recombines the facet layout (6×(1:2) / 4×(1:2:3) / 3×(1:2:3:4))
    — no hardcoded V1/V2/V3 facet "versions"; one compiled reader subsumes them.
  • b. sub-range hierarchy mapping (e.g. 1..3 of 12) + nested ClassViews
    stacked into compiled constructors (composition of compiled readers, not
    a runtime interpreter).
  • c. lazy + lazy-lock-reused materialization of the 32×GUID SoA (build
    once on first touch; the key prerenders nodes with zero value-decode).
  • why compiled beats parsed, and where SurrealQL sits (storage membrane, never
    the hot path — ADR-022/023).

Also: §1 pull-back reframed (modes are not co-equal — compiled ClassView =
spine; SurrealQL emit = membrane), and §6 re-prioritised (the compiled
ClassView spine is THE priority; #136 Stage A array<record> and the
od-ontology fork-deletion are membrane work, secondary).

Doc-only. The exact tier-byte arithmetic of each carving is flagged as the
implementation detail to pin against FacetCascade before coding — not guessed.

🤖 Generated with Claude Code


Generated by Claude Code

…§1.5)

Operator correction (2026-06-29): the facet "versions" are useless because one
compiled ClassView recombines all the carvings while sinking into OGAR and
getting COMPILED into the binary — NOT parsed from SurrealQL (slow even with
JIT). Captures the load-bearing architecture so future sessions invest in the
spine, not the membrane:

- New §1.5 — the compiled ClassView spine:
  a. recombines the facet layout (6×(1:2) / 4×(1:2:3) / 3×(1:2:3:4)) — no
     hardcoded V1/V2/V3 facet "versions"; one compiled reader subsumes them.
  b. sub-range hierarchy mapping (e.g. 1..3 of 12) + NESTED ClassViews stacked
     into compiled CONSTRUCTORS (composition of compiled readers, not a runtime
     interpreter).
  c. lazy + lazy-lock-reused materialization of the 32×GUID SoA (build once on
     first touch; the key prerenders nodes with zero value-decode).
  + why compiled beats parsed, and where SurrealQL sits (storage membrane,
    never the hot path — ADR-022/023).
- §1 pull-back reframed: modes are NOT co-equal — (a) compiled ClassView =
  spine/hot-path; (b) SurrealQL emit = storage-membrane adapter.
- §6 re-prioritised: the compiled ClassView spine is THE priority; #136 Stage A
  (array<record>) and the od-ontology fork-deletion are membrane work,
  secondary. Tier-byte arithmetic of each carving to be pinned against
  FacetCascade before coding — not guessed.

Co-Authored-By: Claude <noreply@anthropic.com>
@AdaWorldAPI AdaWorldAPI merged commit 4e1c385 into main Jun 29, 2026
1 check passed
AdaWorldAPI pushed a commit that referenced this pull request Jul 1, 2026
Six verbs (define/query/relate/act/subscribe/authorize) as step_type names on
the existing OrchestrationBridge/UnifiedStep — not a new layer, not "on the
emitter". SurrealDB's matching verbs are a borrowed silhouette; the engine is
the compiled ClassView (#137).

5+3 council ran (8/8 → REVISE, land the safe subset). Folded findings:
- only `define` truly converges (schema-in/schema-out); the other five borrow
  the name over OGAR's own EdgeBlock/ActionDef/scheduler/RBAC — egress only
  (OGAR → SurrealQL), never DDL → behavior.
- `authorize` split into filter (query-plane) + admit (command-plane); must not
  fuse (AR-OGAR §11 item 11).
- fixed two phantom cells the runtime-archaeologist caught: `CommitGate`
  (→ CommitHook) and `Authorization{enforcement_phase}` (→ ClassRbac/OgarRbac).
- `authorize.*` + lifecycle-`act` reserved-dormant, gated on Phase-B items 11/9.
- dropped "two spines"; one live spine (compiled ClassView), SurrealQL egress
  rides lite-unified (#540, default-OFF). CONJECTURE until F1/F3 pass.

Renamed from the pre-council UNIFIED-EMITTER-API-v1.md ("Emitter" invited
reading the facade as the spine). Registers ADR-026; cross-link pending.

Co-Authored-By: Claude <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants