docs: scope Anaphora64 (v1.5) and OGAR adapter (v2) as follow-up PRs

Per design review: keep PR #479 a clean reading-substrate review unit.
Both extensions are documented as deferred, not built here.

window.rs:
  v1.5 Tekamolo/Anaphora64 provenance sidecar — full bit layout sketched
  in module docs. NOT folded into Cam64 (locality key) or P64 (address space).
  Hooks already present: HorizonPolarity (signed_crystal) + ExpectedReason (window).
  Boundary law: SentenceWindow resolves, EpisodicSpoFrame witnesses,
  Cam64 indexes, Anaphora64 (later) explains.

design doc:
  - test count corrected to 215 (added crystal_neighborhood: 16)
  - new "Deliberately out of scope" section:
    * v1.5 Anaphora64 coreference provenance → coreference-ranking PR
    * v2 OGAR/SurrealDB AST adapter → separate crate, three-layer split
      (semantics/syntax/pragmatics), adapter law: semantics can exist without
      syntax; syntax must resolve to semantics before execution; pragmatics
      decides whether resolved syntax may run. SurrealDB is a runtime view,
      OGAR owns class truth.

No code change; 215 deepnsm tests pass.

https://claude.ai/code/session_0147hSzjmWZDuy2MSQNrhEK5

Author: claude

crates/deepnsm/src/window.rs

@@ -17,6 +17,30 @@
 //! sentence backward and returns the first matching entity. In v1 "matching"
 //! means "any non-pronoun NP head from a prior sentence" — a pure recency
 //! heuristic. Richer disambiguation (gender, number, semantic type) is v2.
+//!
+//! ## Future (v1.5) — Tekamolo/Anaphora64 provenance sidecar
+//!
+//! v1 records *what* resolved (exact NP-head ranks + expected slots) but not
+//! *why* it resolved that way. A future `Anaphora64` sidecar (its own module,
+//! NOT folded into `Cam64` or `P64`) should encode coreference provenance:
+//!
+//! ```text
+//! bits  0..11  antecedent_rank_bucket / local entity id
+//! bits 12..15  sentence_offset_signed4
+//! bits 16..19  source_polarity      (HorizonPolarity: confirmed/expected/inferred_right/basin)
+//! bits 20..23  expected_reason      (ExpectedReason: relative/anaphora/ellipsis/causal/temporal)
+//! bits 24..31  agreement flags      (number/gender/person/semantic-type/role)
+//! bits 32..39  grammatical role score
+//! bits 40..47  salience score
+//! bits 48..55  confidence q8
+//! bits 56..63  reserved / version
+//! ```
+//!
+//! It belongs to the **next** PR (coreference ranking/provenance), not the
+//! reader-substrate PR. Add it only once agreement/ranking is implemented, and
+//! store it as a provenance field on `EpisodicSpoFrame` (`anaphora_tag: Anaphora64`).
+//! The boundary stays clean: SentenceWindow resolves, EpisodicSpoFrame witnesses,
+//! Cam64 indexes, Anaphora64 (later) *explains* the resolution.
 
 use crate::spo::NO_ROLE;
 

docs/architecture/deepnsm-reader-design.md

@@ -262,8 +262,9 @@ FORBIDDEN INTERNAL PATH (absent by omission):
 | `reader_state` | 12 (2 new: trigger wiring) |
 | `signed_crystal` | 18 |
 | `sentence_transformer64` | 26 |
+| `crystal_neighborhood` | 16 |
 | **Existing deepnsm tests** | 104 (unchanged) |
-| **Total** | **200** |
+| **Total** | **215** |
 
 ---
 
@@ -291,5 +292,46 @@ Flow:
 
 The holograph `sentence_crystal.rs` (integer-first, char n-gram hashing,
 bit rotation, majority bundling) is the correct large-field ancestor.
+
+---
+
+## Deliberately out of scope (follow-up PRs)
+
+This PR is the **reading substrate**. Two natural extensions are intentionally
+deferred so #479 stays a clean review unit:
+
+### v1.5 — Tekamolo/Anaphora64 coreference provenance
+
+v1 records *what* resolved (exact NP-head ranks + expected slots). It does not
+record *why* — was the resolution confirmed-backward, expected-forward, or
+inferred-right? Was gender/number/type agreement used? The `HorizonPolarity`
+enum (in `signed_crystal.rs`) and `ExpectedReason` (in `window.rs`) are the
+v1 hooks. A future `anaphora64.rs` sidecar should pack provenance (antecedent
+bucket, sentence offset, source polarity, expected reason, agreement flags,
+role/salience scores, confidence q8) into a `u64`, stored as a provenance field
+on `EpisodicSpoFrame`. **Not in Cam64** (locality key, stays lean) and **not in
+P64** (native address space). Boundary law: *SentenceWindow resolves,
+EpisodicSpoFrame witnesses, Cam64 indexes, Anaphora64 explains.* Belongs to the
+coreference-ranking PR, after agreement/ranking is implemented.
+
+### v2 — OGAR/SurrealDB AST adapter (separate crate)
+
+The same three-layer split (semantics / syntax / pragmatics) carries into the
+OGAR → SurrealQL/DLL/AST adapter, with a domain role rather than a linguistic
+one:
+
+```
+OGAR semantics    = what business/domain thing is this?   (ClassId/PredicateId/ActionId)
+SurrealQL/DLL/AST = how is it represented/executed?        (AstNodeId/DllSymbolId/TemplateId)
+planner pragmatics= what may this actor do with it now?    (ActorId/V_ref/HorizonPolarity/PolicyId)
+```
+
+Adapter law (mirrors the DeepNSM truth/index/context split):
+*Semantics can exist without syntax. Syntax must resolve to semantics before
+execution. Pragmatics decides whether resolved syntax may run.* SemanticFrame is
+truth; AST node, SurrealQL text, and DLL symbol are execution vehicles, not
+truth. SurrealDB is a syntax/runtime view, never the ontology master — class
+truth stays in OGAR. This is its own PR (`crates/ogar-surreal-adapter/` or split
+across `ogar` / `surreal-adapter` / `lance-graph-planner`), not part of #479.
 The ladybug-rs `sentence_crystal.rs` (f32 random projection → 5D coords)
 is a float-projection prototype and is NOT the reference here.