Skip to content

Latest commit

 

History

History
206 lines (169 loc) · 18.4 KB

File metadata and controls

206 lines (169 loc) · 18.4 KB

Каталог архітектурних рішень

ADR-075: bounded aggregate snapshots and pure replay фіксує KL-085: latest-slot CAS, complete same-cut tail, worker-only authority, exact versions і pure SDK upcasting. Implementation/runtime qualification pending.

ADR-067: One composable database for AI agents фіксує головну ідею: всі моделі співіснують, посилаються одна на одну і поєднуються через SQL в одному bounded запиті. Перший executable stage читає чергу й будує граф або читає граф і створює queued actions в одній atomic partition; повний declarative SQL та qualification залишаються окремими обов'язковими gates.

Номери ADR стабільні. Accepted фіксує нормативний direction/contract, а не готовність source; Proposed залишає unresolved choices явними. Жоден новий запис не стає Implemented через створення документа. Всі related REQ/AC та implementation/test/rollout contracts знаходяться в owning ADR і Feature.

Decision inventory

ADR-113 centralized runtime options supersedes ADR-111's selected-context scope with general literal enforcement and typed, centrally validated operational configuration.

ADR-111 semantic magic runtime values defines KLD0035/KLD0036, preserving constant migration and actual compiler regressions.

ADR-110 native Orleans execution and scheduling primitives records the per-method audit, bounded worker/advisory/control/job candidates and required real-operation tests. Selection is Accepted; runtime/provider adoption and qualification remain pending. Its broad capability review includes native pub-sub, transactions, state, per-silo services/lifecycle and cluster operating controls, with source-present/candidate distinctions.

ADR-107 Elastic License 2.0 records the owner's hosted-database-service restriction and distribution metadata contract.

ADR-105 published NuGet refresh records the 2026-10-05 aligned dependency upgrades and required integrated compatibility gates. It remains Accepted until its recorded build and native qualification are complete.

ADR-104 native gateway and graph-based tool discovery is Accepted for implementation in ClientApi. Three initial meta tools replace the public default all-operation MCP catalog; existing signed execution and persisted authorization remain mandatory. Runtime qualification is pending.

ID / рішення Статус рішення Основний Feature
ADR-001 partition identity/affinity Accepted DocumentStorage, ClusterRouting
ADR-002 command/idempotency Accepted DocumentStorage, ClientApi
ADR-003 durability/ACK barrier Accepted StorageRecovery, ClusterReplication
ADR-004 committed read views Accepted StorageRecovery, QueryExecution
ADR-005 canonical keyspace/codec Accepted StorageRecovery, persisted models
ADR-006 strict/derived indexes Accepted DocumentStorage, Search, ChangeFeeds
ADR-007 replica/bootstrap Accepted ClusterReplication, ClusterRouting
ADR-008 backup/log retention Accepted BackupRestore, StorageRecovery
ADR-009 search providers Proposed Search
ADR-010 budgets/security Accepted QueryExecution, Authorization, ResourceExecution
ADR-011 format upgrades Proposed StorageRecovery, BackupRestore
ADR-012 SQL dialect Accepted QueryExecution
ADR-013 authorized AST Accepted QueryExecution, ClientApi
ADR-014 principals/RBAC/rows Accepted Authorization
ADR-015 sensitive lineage Accepted Authorization, Search, ChangeFeeds
ADR-016 atomic/physical placement Accepted ClusterRouting, DocumentStorage
ADR-017 migration tokens Proposed ClusterRouting, ClusterReplication
ADR-018 global rank fusion Proposed Search
ADR-019 managed ANN Accepted R1 candidate; runtime and public qualification pending Search
ADR-020 independent contexts Accepted ClientApi, QueryExecution, ClusterRouting
ADR-021 comparable PostgreSQL baseline Accepted BenchmarkComparisons
ADR-022 policy epoch/revocation Accepted Authorization, QueryExecution, ChangeFeeds
ADR-023 journal authority Accepted EventStreams, Messaging, ChangeFeeds, StorageRecovery
ADR-024 transaction domains Accepted DocumentStorage, EventStreams, Messaging
ADR-025 event/feed positions Accepted EventStreams, ChangeFeeds
ADR-026 fenced delivery/inbox Accepted Messaging
ADR-027 contiguous group checkpoints Accepted Messaging
ADR-028 persisted scheduling time Accepted Messaging, ResourceExecution
ADR-029 event/message classification Accepted Authorization, EventStreams, Messaging
ADR-030 retention/paused restore Accepted BackupRestore, EventStreams, Messaging, ChangeFeeds
ADR-031 modular control resources Accepted ResourceExecution, ClientApi, TestInfrastructure
ADR-032 MCAF/layout migration Accepted RepositoryGovernance
ADR-033 CodeQuality Accepted CodeQuality
ADR-034 Docker comparisons/GitHub graphs Accepted BenchmarkComparisons
ADR-035 resource/lifetime repair Accepted ResourceExecution and affected features
ADR-036 Orleans foundation Accepted ClusterReplication, ClusterRouting, TestInfrastructure
ADR-037 documentation coverage Accepted RepositoryGovernance
ADR-038 chunked blobs/partial reads Proposed BlobStorage
ADR-039 official MCP/agent mapping Proposed ClientApi
ADR-041 read-only public collections Accepted ResourceExecution and affected contracts
ADR-042 admission resource ownership Accepted ResourceExecution
ADR-043 comparative library and host Accepted, implementation pending BenchmarkComparisons
ADR-044 immutable harness contracts Accepted, implementation pending BenchmarkComparisons
ADR-045 PostgreSQL schema ownership Accepted, implementation pending BenchmarkComparisons
ADR-046 private storage owners Accepted, implementation pending StorageRecovery, BackupRestore
ADR-047 embedded benchmark library and host Accepted, source integration and qualification pending BenchmarkComparisons
ADR-048 bounded owned storage metadata Accepted, implementation and qualification pending StorageRecovery, BackupRestore
ADR-049 genuine Neo4j harness and cleanup Accepted, implementation and qualification pending BenchmarkComparisons
ADR-040 static website/Three.js evidence Accepted, implementation in progress BenchmarkComparisons
ADR-050 TimeSeries and Timescale comparison Accepted, implementation and qualification pending TimeSeries, BenchmarkComparisons
ADR-051 read-only administration console Accepted, source implemented; GitHub qualification pending AdminDashboard
ADR-052 bounded TimeSeries latest and aggregates Accepted, implementation and qualification pending TimeSeries, StorageRecovery, ResourceExecution
ADR-054 central SQL Accepted, source implemented; complete qualification pending QueryExecution
ADR-055 typed relational rows Accepted, source implemented; complete qualification pending RelationalStorage
ADR-056 isolated Linux comparison cells Accepted, implementation and qualification pending BenchmarkComparisons, ClusterReplication
ADR-059 intensive native TimeSeries family Accepted staged contract; implementation and native qualification pending BenchmarkComparisons
ADR-060 native internal serialization Accepted; format installation/rollout approval and native qualification pending InternalSerialization

| ADR-062 workflow separation | Placement superseded by ADR-064; authentic historical proof retained | RepositoryGovernance, BenchmarkComparisons | | ADR-064 three-pipeline release delivery | Accepted; exact-SHA CI/site/release qualification pending | RepositoryGovernance, BenchmarkComparisons, ReleaseDelivery | | ADR-065 full SQL and client protocol | Accepted staged lexical contract; full execution/native qualification pending | QueryExecution, ClientApi, RelationalStorage, Search | | ADR-067 composable agent database | Accepted; bounded atomic composition source, full SQL and exact-SHA qualification pending | DatabaseComposition, QueryExecution, ClientApi |

| ADR-068 native benchmark gate repair | Accepted bounded current-job capture; native and complete cohort qualification pending | BenchmarkComparisons | | ADR-082 native CQRS streams | Accepted C0 real runtime proof; product contracts and qualification pending | ClusterRouting, ClientApi, Search | | ADR-083 native CQRS HTTP bounds | Accepted owning repair contract; release/feed and consumer qualification pending | ClientApi, ResourceExecution |

Ідентичність і пріоритет

Owner-directed unified AI database continuation:

  • ADR-054 central SQL: Accepted versioned SELECT/CALL over the existing authorized operation catalog; exact qualification pending.
  • ADR-055 typed relational rows: Accepted schema-constrained canonical entities/native indexes; JOIN/FK and qualification remain separate pending stages.

ADR-001–031 materialize перелік продуктової специфікації; unresolved provider/algorithm/upgrade/token choices лишаються Proposed. Старий optional request-facade/DotNext direction не переважає current mandatory root policy: Orleans only, окремий grain для кожного request, distributed directory/migration, node-local storage owner, Docker/Aspire RF3 і TUnit/SDK/MCP gates.

Identity correction 2026-10-02: два незафіксовані ADR мали номер 034. Comparisons зберігає ADR-034 та шлях, бо на нього вже посилаються mandatory local policies. Foundation отримує ADR-036; його decision/body/requirements збережені, dependent doc links оновлені. Це виправлення дубля, не зміна product architecture і не repeated/reused decision identity.

Preserved policy conflict: root AGENTS.md досі містить історичне “ADR-034 evidence” для двох experimental Orleans API calls. ADR-036 і ADR-034 явно зв'язують це посилання з foundation evidence. Правило, compiler scope і заборона global suppression збережені; policy text не переписано приховано.

flowchart LR
    Requirement[Owner policy and product REQ] --> Decision[Unique ADR and rationale]
    Decision --> Contract[Ownership tests migration and join contract]
    Contract --> Implementation[Actual source and real tests]
    Implementation --> Evidence[Exact delivered GitHub qualification]
    Open[Unresolved choice] --> Proposed[Proposed blocks dependent implementation]
    Proposed --> Decision
Loading

Full coverage/verification: catalog, RepositoryGovernance, documentation plan. Product tracker залишається canonical status authority. Passed doc links/render чи наявні test methods не виконують product AC; current qualification, power-loss/endurance та advanced capability gaps мають explicit pending evidence.

ADR-047 accepts the public embedded scenario library and existing typed executable boundary required by BenchmarkDotNet's real generated external consumer. REQ-BC-022/AC-EM-001..004 include complete source/lifetime and GitHub TUnit/Dry qualification; implementation and exact-SHA proof are pending.

ADR-053 accepts one light KeyLoad identity shared by the /admin console and the public site:

  • a canonical brand.css and logo.svg with byte-identical site mirrors and a SiteTests drift gate;
  • a bounded server failed-request log;
  • configured voter membership for the console's node view.

REQ/AC-AD-008..010 and REQ/AC-BC-029 apply. Exact-SHA qualification is pending.

ADR-057 accepts private Orleans binary atomic WAL payloads with format3 fencing and offline checkpoint-only upgrades; source and exact-SHA qualification pending.

ADR-058 accepts staged disposable cache memory and authenticated Orleans coordination. The shared retained pool and explicitly configured embedded point cache are implemented in source; RF3 server admission remains cold pending authenticated cluster control. Native cache correctness, coverage and matched performance qualification remain open.

ADR-063 accepts optional BCL-only fixed phase diagnostics, preserving actual quorum/gate/tail/WAL ownership. Shared schema is registered; bank, producer joins, private native capture and measured overhead remain open. Tests owns runtime qualification; Benchmarks owns matched performance comparisons under the separate ADR-062 workflow map.

ADR-071 records selected ZoneTree providers and discarded candidate cleanup. ADR-072/073/074 define bounded SQL model views, logged series retention and the unified Aspire test entry.

ADR-076 accepts retiring the obsolete live collector and profile publisher while preserving complete authenticated current-cohort, source, coverage, browser and freshness gates. Qualification pending.

ADR-077 accepts an explicit preserving native5-to-separate-native6 offline upgrade, checkpoint4 and incompatible signed peer fences. Homogeneous rollout, real prior-binary proof and qualification pending.

ADR-078 freezes bounded actual native ZoneTree.FullTextSearch candidate generations under a node-local physical owner, exact canonical ranking, persisted-policy cuts and fail-closed publication. Source integration and qualification pending; acceleration is not claimed.

ADR-080 accepts owner-directed independent benchmark failure handling: bounded transient GitHub GET retries, authenticated null-report failed cells and successful competitor publication. Full planned-cell accounting and complete site qualification remain required; delivered-source proof is pending.

ADR-079 freezes a private lossless series-codec qualification stage; canonical layout, rewrite/migration and fault qualification remain separate. ADR-081 freezes awaited admitted native search execution and independent RF3 oracle repairs. Both retain source/runtime and exact-source Linux qualification gates.

ADR-086 defines prompt termination on actual owned Aspire resource failures, preserving original outcomes, dependency completion, planned fault injection and independent comparison jobs. Native notification regressions and delivered-source qualification remain pending.

ADR-108 accepts typed .NET Lock gates for necessary shared-service synchronization, native Orleans scheduling for activation state and source-owned KLD0034 enforcement. Full verification remains pending.