Conversation
…ap matrix (#83) Phase 9 D10.a (read-only) — current-state record of ApeRAG MCP / RAG / HTTP / internal-service surface, intended to feed D10 design pack (task #82 / #84). Body §B: 6-interface inventory (Vector / Graph / Full-text / Web Search / Summary / Vision) — for each: MCP exposure, HTTP endpoint, request/response schema, service entry, implementation file, multi-tenant boundary. §C: HTTP-only / internal-only capabilities not yet exposed via MCP, recorded as gaps (per PM expansion). Tagged per architect 4-tier access taxonomy (MCP-exposed / HTTP-only / internal-only / none). Appendix A: D9 base reuse matrix — SafeToolName, 3-tier registry, 7-point contract, multi-tenant auth boundary — distinguishing on-disk reusable vs. design-only. Appendix B: 1-page impact table for the three earayu2 open questions (Summary/Vision deprecate, write tools scope, cross-collection ops) with cost asymmetry per choice. Includes "Delta from 5113730 -> e290488" pass for #74 D8.2 merge: data-tool-consent + data-elicitation parts moved on-disk; 7-point compliance lower-bound conclusions unchanged. Ground truth: origin/main HEAD e290488 at time of writing. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This was referenced Apr 25, 2026
earayu
added a commit
that referenced
this pull request
Apr 25, 2026
…al Agent substrate (#1708) * docs(modularization): add D10.b design pack — MCP/API redesign for external Agent substrate Design pack covering: - §A 8 read primitives (list_collections / list_documents / get_document_metadata / get_collection_metadata / read_document / read_document_outline / read_document_section / read_document_chunk) - §B Search primitives split + omnibus deprecation (vector_search / graph_search / fulltext_search / web_search) - §C Pagination + cursor contract (R2: opaque base64 + invariant_hash + 6 explicit error codes; explicit-error-not-silent-reset) - §D Capability negotiation (R3 Option A canonical) - §E Read primitive persistence strategy (Lock #7 LRU + parse_version L1+L2) - §F D9 base reuse boundary (Lock #6 + Lock #8; cites #1698/#1699 inventory and Weston policy/backend-owned tenancy refinements) - §G Implementation guidelines — 5 hard gates accumulated through D8.x review: (1) contract shape change → comprehensive grep sweep across hurl/unit_test/scripts with 5-category classification (2) CI red canonical decision needs actual root cause not "infra flake" attribution (3) bridge/adapter deletion → ALL caller path validation (4) Caller migration → preserve original assertion semantics (5) cross-stack design boundary requires owner inventory cross-validation - §H Migration & backward compatibility plan (hard-cut philosophy per earayu2 msg=f20d5034) Cumulative architect locks: R1/R2/R3 + Lock #5/#6/#7/#8 + cheapest combo. runtime_kind discriminator settled as 3-value (agent_runtime / direct_chat / rag_chat) per Bryce/Weston BE inventory finding. Closes design phase of task #84. Implementation tasks (D10.c-h) to be decomposed post-merge per §G 5-gate methodology. * docs(modularization): D10.b — drop stale placeholder + add §G D10.c-h lane decomposition Per Weston msg=71d8d605 + PM msg=db923645 in-PR doc-only blockers: 1. Remove the stale tail placeholder "(§B-§F + §H still to be drafted in subsequent sessions)". The 9/9 sections were already drafted; the placeholder was a leftover from an earlier draft session and contradicted §H presence above. 2. Add concrete D10.c-h implementation lane decomposition as a §G subsection. Each lane (D10.c through D10.h) now has: - Deliverable scope (one-to-one with §A-§H spec text for locatability) - Owner candidate (suggestion only — final claim via slock task claim) - Write-set boundary (which directories/files the lane is allowed to touch, plus explicit "Forbidden" list to prevent scope inflation) - Dependency graph (depends-on / blocks) Lanes: - D10.c — Read primitives BE implementation (§A) - D10.d — Search primitives split + omnibus deprecation (§B) - D10.e — Pagination + cursor contract (§C) - D10.f — Capability negotiation Option A (§D) - D10.g — Read primitive persistence LRU + parse_version (§E) - D10.h — Migration & hard-cut cutover (§H, architect-led) Plus a dependency-graph summary with 3 parallel-friendly windows so PM can batch task creation: window 1 (D10.d/e/g concurrent post-D10.c), window 2 (D10.f joins post-D10.c+d), window 3 (D10.h cutover single-lane post-soak). §G end-marker now states explicitly that §G is an open ledger — new lessons should be appended as additional "Hard gate" subsections, not split into a separate doc. Doc-only change. No implementation impact. --------- Co-authored-by: 符炫炜 <fuxuanwei@apecloud.io>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
docs/modularization/d10-current-mcp-surface-inventory.md. Pure additive — no code touched.Deliverable shape (locked by PM @架构师 / 总架构师 @符炫炜)
MCP-exposed/HTTP-only/internal-only/none, msg=112d3aad).SafeToolName, 3-tier registry, 7-point contract, multi-tenant auth boundary — distinguishing on-disk reusable vs. design-only.51137301 → e290488bpass for [Features] support preview and download documents #74 D8.2 merge —data-tool-consent+data-elicitationparts moved on-disk; 7-point compliance lower-bound conclusions unchanged. Second delta block reserved for [Features] integrate YuQue as a data source #75 once it lands.Highlight findings (consumed by @符炫炜 D10 design pack as architect Locks #5–#8)
vector_search/graph_search/fulltext_search/summary_search/vision_searchare bundled inside one omnibussearch_collectionwith boolean flags. (→ Lock fix: create collection bug #5: split + omnibus deprecation alias.)section_path/chunk_id/heading_anchorare NOT first-class persisted entities; only inside docparser memory + chunk metadata. D10 needs persistence strategy decision. (→ Lock feat: chat animate #7.)Authority
in_review.Test plan
docs/modularization/.e290488b.51137301 → e290488b([Features] support preview and download documents #74 merge); conclusions unchanged.🤖 Generated with Claude Code