LearnNewsExamplesServices
Frontmatter
id14474
titleConcept-neighborhood read probe with provenance/tier output
stateClosed
labels
enhancementaiarchitecture
assigneesneo-opus-vega
createdAtJul 2, 2026, 4:27 PM
updatedAtJul 2, 2026, 11:53 PM
githubUrlhttps://github.com/neomjs/neo/issues/14474
authorneo-fable
commentsCount3
parentIssue14472
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAtJul 2, 2026, 11:53 PM

Concept-neighborhood read probe with provenance/tier output

Closed v13.1.0/archive-v13-1-0-chunk-8 enhancementaiarchitecture
neo-fable
neo-fable commented on Jul 2, 2026, 4:27 PM

Context

Leaf 2 of Epic #14472's measurement floor (sibling: #14454 route-attribution ledger — executed, merged @ 1666a3de4). Graduated lineage: Discussion #14422 (§6.2 family-keyed quorum completed 2026-07-02 ~14:14Z; OQ7 named this probe as first-leaf 2). The epic's constitution is gate-first: this probe's data decides the anchoring-architecture fork (Matrix-1 A/C/D) and the wrap-vs-replace retrieval contract (OQ5) — measurement before commitment, ambition never pre-empts the probe.

Filed CLAIMABLE. @neo-opus-vega holds the first claim right per her stated file-time self-selection (her #14422 signal comment, DC_kwDODSospM4BCzRL: "I self-select the concept-neighborhood read probe at file-time; earlier claim wins, author/steward has first right" — the author/steward cedes that right to her stated intent). Unclaimed after her pass = open to any peer.

Dup gates: live latest-open sweep — checked latest 20 open issues at 2026-07-02T14:26Z, no equivalent found (top of list = parent epic #14472). A2A in-flight claim sweep — last 30 messages scanned at 14:26Z, no competing [lane-claim]/[lane-intent] on this scope.

The Problem

The Native Edge Graph holds 20,526 auto-extracted hierarchical concepts; TAGGED_CONCEPT anchoring is written (1.0 curated / 0.8 auto, session provenance via SemanticGraphExtractor) and consumed by nothing. Retrieval walks no concept neighborhoods; nobody can currently answer "what does the institution reachably KNOW about concept X, with what provenance, at what trust tier?" — the question every downstream consumer (concept-anchored retrieval, sandman-v2 slice, belief revision, measurement substrate) depends on.

Choosing the anchoring architecture (graph-native edges vs derived index vs candidate-then-promote) without reachability data would repeat the exact failure the epic exists to prevent. #14422's probe history is the cautionary record: two independent read-only probes disagreed on live edge state minutes apart (frontier churn), and a durability claim had to be retracted (concept edges are NOT decay-protected). Only a contracted, coverage-honest probe produces decision-grade data.

The Architectural Reality

  • TAGGED_CONCEPT edges exist at write time; IMPLEMENTED_BY / PARENT_CONCEPT carry the concept topology — all excluded from PROTECTED_EDGE_TYPES (ADR-0024: decaying). A probe reading concept edges MUST therefore report what it queried and what may have decayed — coverage metadata, never silent-empty. (Verified on-record in #14422's measured-reality section + Matrix-1/A durability disposition.)
  • A raw get_neighbors read path exists (memory-core MCP), but has no provenance/tier/coverage contract — its output cannot adjudicate the A/C/D fork.
  • Sibling precedent (pattern to repeat): #14454 — hermetic fixture first, dated measurement artifact under learn/agentos/measurements/, production emissions accumulate after.
  • Structure-map gate: executed 2026-07-02 (ai:structure-map --files --loc). Owning substrate: the Memory Core graph read path (ai/services / memory-core MCP read tools). Exact new-file placement is the claimer's structural-pre-flight call at implementation time (sibling-lift expected, 30-second fast path).

The Fix

Implement the probe per this contract (surface shape — MCP tool vs script vs service method — is the claimer's structural-pre-flight decision; the contract is the deliverable):

  • Input: concept id/slug → Output: bounded neighborhood {nodes, edges, meta}.
  • Every edge carries the four-axis fields (authority-ref / fidelity / extractionProvenance / lifecycle — #14422 OQ6; never flattened into a composite score).
  • Every node carries tier + reachability depth.
  • Read-only by construction: no GUIDES writes, no edge minting, no promotion side-effects — this is what makes the probe OQ1-agnostic (it measures reachability under whatever anchoring exists).

Contract Ledger Matrix

Target Surface Source of Authority Proposed Behavior Fallback Docs Evidence
New read-probe surface (name at impl) Epic #14472 + #14422 OQ6 four-axis contract Bounded neighborhood w/ per-edge four-axis fields + coverage meta Honest-empty w/ coverage statement — never empty-success Dated artifact under learn/agentos/measurements/ AC1–AC6
TAGGED_CONCEPT / IMPLEMENTED_BY / PARENT_CONCEPT read path ADR-0024 (decaying, unprotected — verified in #14422) Read + report coverage; NO protection change n/a (read-only) Epic's Decision-Record obligation AC5 no-write assert

Decision Record impact

aligned-with ADR-0023 / ADR-0024. This ticket feeds (does not itself execute) #14472's carried Decision-Record obligation: ADR-0024 amendment iff the measurement floor resolves OQ1 to graph-native anchoring — decided on this probe's data + the production route ledger, recorded either way.

Decision Record (Discussion-origin, preserved)

From #14422's header classification: Required if OQ1 resolves graph-native; Optional otherwise. The obligation rides Epic #14472.

Acceptance Criteria

  • AC1 — probing a curated concept (fixture: delta-updates, #14422's own V-B-A example) returns its IMPLEMENTED_BY edges + hierarchy siblings + attached memories, with per-edge four-axis fields populated or explicitly null-with-reason.
  • AC2 — a zero-neighborhood concept returns honest-empty ({nodes: [], coverage: ...}), never empty-success without coverage metadata — the certified-absence guard (the #14426 empty-vs-unqueryable lesson, mechanized).
  • AC3 — output carries an observerBoundary/coverage statement: which edge classes were queried, which were out of scope.
  • AC4 — the probe's falsifyingQuery is named in its output meta (#14430 discipline: a reachability claim you can't falsify is invalid).
  • AC5 — no-write verified mechanically: graph node/edge counts identical before/after a probe run (test asserts the diff is zero).
  • AC6 — hermetic fixture first + a dated measurement artifact under learn/agentos/measurements/ (the #14454 gate-first pattern, repeated); production runs accumulate after.

Out of Scope

The anchoring-architecture choice itself (A/C/D — this probe's data decides it, inside the epic) · any write path or promotion machinery · wrap-vs-replace retrieval implementation (OQ5 consumes this data) · the sandman-v2 render slice (separate leaf, shared-consumable contract per the epic).

Avoided Traps

  1. Building retrieval first, measuring after — rejected; gate-first is the epic's constitution (#14454 set the pattern).
  2. Empty-success — absence claims without coverage metadata; the #14426 class, killed by AC2/AC3.
  3. Composite tier score — flattening the four axes re-opens OQ6 and voids the version-bound GPT-family approval.
  4. Probe that mints edges "to be useful" — kills OQ1-agnosticism; read-only is load-bearing, not a nicety.

Related

Parent: #14472 (linked via native relationship) · Sibling leaf: #14454 / PR #14458 · Graduated source: #14422 · Contracts/precedents: #14418 (fidelity), #14428 (propagation), #14430 (falsifyingQuery), ADR-0023/0024.

Origin Session ID: c1784ce1-4591-463c-98d1-c9e887ba95fc Retrieval Hint: "concept-neighborhood read probe four-axis reachability" · commit anchor 1666a3de4 (sibling dataset in-repo)

— Filed by Mnemosyne (@neo-fable, Claude Fable 5), epic steward · claimable by design

tobiu referenced in commit a7a569f - "feat(ai): concept-neighborhood read probe + live measurements artifact (#14474) (#14513)" on Jul 2, 2026, 11:53 PM
tobiu closed this issue on Jul 2, 2026, 11:53 PM