LearnNewsExamplesServices
Frontmatter
id15234
titleAdd explore_lane_landscape — the current-state lane landscape Bird View
stateClosed
labels
enhancementaiarchitecturemodel-experience
assigneesneo-opus-ada
createdAtJul 16, 2026, 11:01 AM
updatedAtJul 16, 2026, 8:34 PM
githubUrlhttps://github.com/neomjs/neo/issues/15234
authorneo-opus-ada
commentsCount1
parentIssue15100
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[]
blocking[]
closedAtJul 16, 2026, 8:34 PM

Add explore_lane_landscape — the current-state lane landscape Bird View

Closed Backlog/active-chunk-6 enhancementaiarchitecturemodel-experience
neo-opus-ada
neo-opus-ada commented on Jul 16, 2026, 11:01 AM

Context

Live Lane Awareness (Epic #15100, graduated from Discussion #15090) composes four truth surfaces. Three now exist or are in flight: the historical Memory/session Bird View (#14435, merged), the resolved-PR conversation Bird View (#15088, merged), and the typed ComputedRouteResult route (#15087, PR #15231). The current-state surface promised by the parent ontology #11375 — "what does the lane landscape look like RIGHT NOW" — remains unbuilt. ADR 0035 §2.5 names it as the third self-awareness context slot, provisionally explore_lane_landscape.

The Problem

There is no runtime tool that answers, on demand: "what is the current lane landscape — the goal trajectory, the dependency/critical path, and where authority is covered vs. gapped?" The Golden Path computes a route (which lane next); the historical Bird Views synthesize what happened; but neither exposes the current-state structural picture a peer needs to orient. Today that picture is reconstructed manually every session by surveying open issues/PRs/epics — exactly the manual survey the awareness system exists to replace. A static digest/dashboard is explicitly rejected (#11375); this must be a queryable, cite-backed runtime tool where unknown stays unknown.

The Architectural Reality

This is a sibling-lift of the two shipped historical Bird Views (structural pre-flight: matched pattern, no novel directory):

  • Synthesis engine reuse: the on-demand synthesizeTemporalBirdView composition + honest-absence envelope shipped by #14435 (ai/services/memory-core/helpers/*) is the shared dynamic-synthesis path. explore_lane_landscape injects a current-state source projection into that same engine, exactly as #15088 injected its PR-source retrieve — no second synthesizer.
  • Source adapter (new): a current-state landscape source that reads open issues/PRs + their states + the parent/blocked-by/graph edges (goal trajectory, dependency/critical path, authority/assignee coverage). Owner is the GitHub-Workflow + Native-Edge-Graph read surface (source-owned admission), never a durable write. Sibling of PullRequestHistoryService.mjs.
  • Registration: a distinct read-only explore_lane_landscape MCP operation registered by Memory Core, separate from explore_memory_history / explore_pull_request_history; its source records and response never mix with the historical views.
  • ADR 0028 §2.2 forbids durable L3–L5 output; every answer is generated on demand from source artifacts + L1/L2 facts. notAuthority: true.

The Fix

  1. Add a current-state landscape source adapter (open-work census + dependency/authority projection) with a coverage/exhaustion manifest — an incomplete/unproven census returns a degraded envelope, never partial-as-complete.
  2. Feed a current-state evidence projection into the landed temporal runner by dependency injection (no title-only sources; the structural facts — states, edges, coverage — reach synthesis).
  3. Register the distinct read-only explore_lane_landscape operation in the Memory Core OpenAPI/dispatch.
  4. Return a structured Bird View: goal-trajectory, dependency/critical-path, and authority-coverage dimensions; cite-backed notable structure; coverage (incl. unknown/degraded); generatedAt/source provenance; notAuthority: true. Bound density without hiding coverage.

Contract Ledger Matrix

Target Surface Source of Authority Proposed Behavior Fallback Docs Evidence
New explore_lane_landscape MCP operation ADR 0035 §2.5 + Epic #15100 Query-time current-state landscape Bird View (goal/dependency/authority) Incomplete census → explicit degraded envelope; invalid request rejects Memory Core OpenAPI + source-service JSDoc OpenAPI contract test + exact tool invocation
New current-state landscape source adapter GitHub-Workflow + Native-Edge-Graph read surface Project open-work states + parent/blocked-by/assignee edges into a coverage-manifested census Unproven coverage fails closed/degraded Class/method JSDoc census + edge-projection + degraded-coverage fixtures
Shared dynamic-synthesis path #14435 + ADR 0028 §2.2/§2.5 Synthesize on demand; cite named sources; write nothing above L2 Inference unavailable → source manifest + deterministic coverage, unsynthesized Service JSDoc + OpenAPI no-write assertion + degraded-inference test

Decision Record impact

aligned-with ADR 0035 §2.5 (the current-lane-landscape slot) and aligned-with ADR 0028 §2.2/§2.5 (query-time synthesis, no durable cascade). Builds on merged #14435. No ADR amendment.

Decision Record

Required authority: ADR 0035 (graduated from Discussion #15090, Cycle-7) + ADR 0028. This leaf instantiates the explore_lane_landscape slot the graduated Discussion classified.

Acceptance Criteria

  • A read-only runtime tool answers a current-state lane-landscape query across goal-trajectory, dependency/critical-path, and authority-coverage dimensions, separate from the historical Bird Views.
  • unknown coverage stays unknown (cite-backed) — no fabricated certainty, no ranking, no assignment/oracle behavior.
  • Census coverage/exhaustion is proven; an unknown/incomplete source returns a degraded envelope, never partial-as-complete.
  • Every mutable/derived claim is cite-backed and stamped notAuthority: true.
  • No L3–L5 result is written to Chroma, SQLite, Markdown, handoff, or another cache (no-durable-write assertion).
  • Inference failure preserves deterministic source/coverage evidence and marks synthesis unavailable.
  • Focused tests: goal/dependency/authority dimensions, cite-backed unknown coverage, degraded-census path, no-write behavior, citation drill-down.
  • Cross-family review challenges the tool contract + the current-state census-completeness proof before merge.

Out of Scope

  • Ranking, route selection, or automatic lane assignment — that is the Computed Golden Path's authority (#14472 / #15087), never this view.
  • Durable current-state narrative / dashboard snapshot (rejected by #11375).
  • The historical Memory/session (#14435) and resolved-PR (#15088) Bird Views — separate source families.
  • The lifecycle-frontier producer (ADR §2.3) and the projection writer (ADR §2.6) — sibling #15100 leaves.

Avoided Traps

  • Static digest/dashboard as the current-state surface: rejected — #11375 mandates a queryable runtime tool, not presentation over unsynthesized data.
  • Fabricated certainty: an incomplete census must degrade honestly, never present partial coverage as the whole picture.
  • Becoming a second scorer/oracle: the landscape describes structure; it never ranks or assigns.
  • Mixing source families: current-state census must not blend with the historical Bird Views' records or envelopes.

Related

Parent: #15100 (dependency edge; ADR 0035 §2.5 slot) Builds on: #14435 / #15088 (the shared dynamic-synthesis Bird-View engine) Route sibling: #15087 (the typed ComputedRouteResult — routing authority, distinct from this current-state view) Ontology parent: Discussion #11375 Authority: ADR 0035 §2.5 · ADR 0028 §2.2/§2.5

Live latest-open sweep: checked latest 20 open issues + a lane-landscape/current-state-Bird-View title search + last 18 all-state A2A messages at 2026-07-16T08:59Z; no equivalent ticket or in-flight claim found.

Origin Session ID: f78647f0-583a-4054-95fb-1fae5d0f2551

Retrieval Hint: "explore_lane_landscape current-state lane landscape Bird View goal trajectory dependency critical path authority coverage ADR 0035 §2.5" Retrieval Hint: "current-state Bird View sibling of explore_memory_history explore_pull_request_history #15100 leaf"

tobiu referenced in commit 1e166d7 - "feat(memory-core): explore_lane_landscape — the current-state lane landscape Bird View (#15234) (#15264) on Jul 16, 2026, 8:34 PM
tobiu closed this issue on Jul 16, 2026, 8:34 PM