LearnNewsExamplesServices
Frontmatter
id10950
titleReconcile topology matrix coverage for Memory Core deployment
stateClosed
labels
enhancementaitestingagent-task:blockedarchitectureneeds-re-triage
assignees[]
createdAtMay 8, 2026, 12:47 PM
updatedAtMay 22, 2026, 9:06 PM
githubUrlhttps://github.com/neomjs/neo/issues/10950
authorneo-gpt
commentsCount3
parentIssue10945
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtMay 22, 2026, 9:06 PM

Reconcile topology matrix coverage for Memory Core deployment

Closedenhancementaitestingagent-task:blockedarchitectureneeds-re-triage
neo-gpt
neo-gpt commented on May 8, 2026, 12:47 PM

Context

Parent epic #10945 needs actionable deployment-pipeline coverage for multi-user Memory Core. Topology is already tracked at the architecture level by #10015 and related #10008/#10009 work, but the deployment-product test lane still needs a concrete matrix: what is product-path default, what is diagnostic-only, and what gets tested in CI.

Duplicate sweep before filing:

  • gh issue list --search "unified federated topology Memory Core Playwright" found #10015 plus adjacent parents, but no focused #10945 integration child.
  • KB ticket search for the full multi-user deployment integration framing returned no conceptual duplicate.
  • This ticket links to #10015 instead of replacing it.

The Problem

The current Docker integration stack exercises a narrow unified deployment shape. That may be correct for the product path, but the repo still carries unified/federated topology vocabulary and older topology-coverage tickets. If the matrix is not explicit, agents can either over-test non-product diagnostic paths or under-test product claims.

The Architectural Reality

Relevant surfaces:

  • #10015 — Dynamic Topology: Unified vs Federated Routing.
  • #10008/#10009 — existing topology coverage tracks.
  • ai/deploy/docker-compose.test.yml — current deployed test topology.
  • test/playwright/integration/** — current integration suite.
  • learn/agentos/SharedDeployment.md and deployment cookbook topology language.

The Fix

Define and implement the minimal topology matrix for Memory Core deployment integration:

  • unified mode as product-path default, with hard assertions for expected routing and data visibility;
  • federated mode either as diagnostic-only with explicit integration coverage or as a consciously deferred/retired product claim;
  • CI behavior that makes the selected matrix visible.

This can be a docs + test-fixture PR if the architectural decision is mostly clarification, but it must leave executable evidence for the chosen default.

Contract Ledger Matrix

Target Surface Source of Authority Proposed Behavior Fallback Docs Evidence
Unified deployment mode #10015, #10945 Product-path default in integration fixture If renamed/reshaped, update deployment docs and fixture together SharedDeployment + DeploymentCookbook Integration test asserts unified routing/data path
Federated deployment mode #10015, #10008/#10009 Either diagnostic-only with explicit test or explicitly deferred from product claims Do not silently imply product support without evidence Topology docs CI matrix or documented non-default diagnostic command
CI topology matrix #10945 Selected topology coverage is visible in integration row If too slow for default CI, provide named diagnostic job/script CI docs if touched Workflow/test output names topology under test

Acceptance Criteria

  • Current topology claims are audited against #10015/#10008/#10009.
  • Unified product-path deployment coverage is explicit and executable.
  • Federated behavior is either covered as diagnostic-only or explicitly deferred with rationale.
  • CI or local command names the topology shape under test.
  • Documentation and tests agree; no stale topology claim remains without evidence.
  • Native links and Related section preserve #10015/#10008/#10009 context.

Out of Scope

  • Rewriting the topology architecture in this ticket.
  • Retiring federated topology without maintainer approval.
  • Adding every possible multi-region cloud layout to CI.

Related

Parent: #10945 Adjacent: #10015, #10008, #10009, #9999

Origin Session ID: c02fbf4e-870c-44c0-ba7e-e9ffacce094b

Retrieval Hint: query_raw_memories(query="unified federated topology Memory Core deployment integration matrix")

tobiu referenced in commit a77adf0 - "docs(agentos): v13 architectural path strategy document (#10957) (#10958) on May 8, 2026, 2:18 PM
tobiu referenced in commit 99fd128 - "chore(integration): explicitly name unified topology matrix in CI (#10950) (#10989) on May 8, 2026, 10:57 PM
tobiu unassigned from @neo-gemini-3-1-pro on May 19, 2026, 5:57 PM