EKOSdocs
Docs / RFC Learn

Accepted RFCs

Accepted RFCs, split into fully implemented and partially implemented.

Implemented (222)

RFC Title Status
0001 Compiler Core Architecture Accepted
0002 Artifact System and Content-Addressing Accepted
0003 Knowledge Intermediate Representation (KIR) Accepted
0004 Semantic Knowledge Ledger Accepted (retroactively documented)
0005 Knowledge Runtime Accepted
0006 Observation SDK and Connector Contract Accepted
0007 Identity Resolution Accepted
0008 LLM Policy: Determinism, Caching, Model Pinning Accepted
0009 AI Runtime Accepted
0010 Enterprise Knowledge Language (EKL) Accepted
0011 Optimizer (Phase 13) Accepted
0012 Phase 14 Connector Scaffolding (SAP, Salesforce, Oracle, Fabric, Snowflake) Accepted
0013 MCP Server (ekos mcp serve) Accepted
0014 Content Indexing & Ranked Search Accepted
0015 Compact Storage Accepted
0016 EKOS Fact-Segment Engine Accepted (2026-07-17; reviewed against RFC 0001–0015 invariants
0017 Crypto Connector (DeFi Sentinel Ingestion) Accepted
0018 Multi-hop Dependency & Impact Reasoning Accepted
0019 Dependency-Fact Extraction + Symbol Harvesting Accepted
0020 GitHub Issues/PRs Connector (Proof-of-Concept) Accepted
0021 Local LLM Provider (Ollama) Accepted
0022 Confluence Connector (Proof-of-Concept) Accepted
0023 Local Document Connector (PDF / DOCX, text + tables + image OCR) Accepted
0024 Document Section Indexing Accepted
0025 Additional Document Formats (Text/Markdown, HTML, Email) Accepted
0026 LLM Document-Semantics Extraction Pass Accepted
0027 Unified Transformation Semantics Accepted
0028 Transformation IR MCP Tools Accepted
0029 Cross-System Identity Resolution Accepted
0030 Marketing Agent v1 (Automatic X Release Announcements) Accepted
0031 Pluggable SQL Dialect Parsers Accepted
0032 DAO Treasury Compliance: Payment↔Approval Matching Accepted
0035 Generated Documentation from the Compiled Ledger Accepted
0039 Phase 1: Close SQL/Pentaho Gaps (RFC 0038 Phase 1) Accepted
0042 Production-Grade Curated Documentation (Program Entities, Crate Topology, CI/CD) Accepted
0043 Global Secrets/PII Redaction Accepted
0045 Hosted Demo Server (read-only, two-repo MVP) Accepted
0046 OpenAI LLM Provider Accepted
0047 Confidence-Scored Claims & Temporal Validity (Graph Layer) Accepted
0048 World Model (a read-only projection, not new storage) Accepted
0049 Agent Model (definitions, beliefs, knowledge, observation) Accepted
0050 Decision Engine, Action System, Simulation Engine Accepted
0051 Scenario Definition Accepted
0052 Conflict Resolution Accepted
0053 Virtual Social Environment Accepted
0054 Event Store (closing Phase 12) and Simulation Replay (Phase 13) Accepted
0055 world.sources Document Ingestion Accepted
0056 ClickHouse Connector: Compiled Metadata + Live NL-to-SQL Query Engine Accepted
0057 ClickHouse Dialect: Preprocess CODEC(...) Before Parsing Accepted
0058 ClickHouse Dialect: Preprocess INDEX/PARTITION BY/SAMPLE BY/SETTINGS/CREATE DICTIONARY Accepted
0059 Postgres Dialect: Preprocess CREATE/ALTER SEQUENCE, UNLOGGED, NOT VALID Accepted
0060 Identity Resolution: Raise the Default Merge Threshold, Strip Table Schema Qualifiers Accepted
0061 AI Runtime: Extract Search Keywords From Natural-Language Questions Accepted
0062 GitHub Connector: Live Verification + Real Cross-System Chain Accepted
0063 Extend Identity Review to Same-Source Merges Accepted
0067 Architecture Reasoning, Evaluation, and the MVP Investigation Loop Accepted
0069 System Context View + Real Documentation Drift Accepted
0070 Component View + Technology Inventory Accepted
0071 Architecture Summary + Runtime View Accepted
0072 Deterministic DependsOn Relationship Ids Accepted
0073 System Context SVG Artifact Accepted
0074 Data Architecture View Accepted
0075 Data Architecture Cross-Referencing: Table↔TransformNode Links, Data Domains Accepted
0076 Real-Project Testing: Six Findings, Four Fixes Accepted
0077 ekos build's Fingerprint Cache vs. a Cleared Ledger Accepted
0078 Version-Pinned Internal Dependencies No Longer Fabricate Duplicate Technologies Accepted
0079 Multi-Project Analyzer Id Collisions Accepted
0081 Real Elixir Decomposition (elixir_analyzer.rs) Accepted
0082 package.json Dependency Extraction (package_json_analyzer.rs) Accepted
0083 Real System Decomposition View (Backend/Frontend/Database) Accepted
0084 Diagram-Quality Fixes (Row-Wrapping, Crate Topology SVG, Honest Component View) Accepted
0085 Real JavaScript/TypeScript Decomposition (javascript_analyzer.rs) Accepted
0086 Real Backend → Database Cross-Tier Edges (Ecto Repo Adapters) Accepted
0087 Real Doc-Comment Extraction (Rust/Python/Elixir/JS-TS) Accepted
0088 LLM-Backed Compile-Time Descriptions (Modules, Subsystems, and Symbols) Accepted
0089 Real "Defined in" File Location on Symbol/Module Entity Pages Accepted
0090 Solution Architect Report (--layout solution-architect) Accepted
0091 SQLAlchemy ORM Model Recognition (Python) Accepted
0092 Class Inheritance (RelationshipKind::Extends), Python v1 Accepted
0093 Technology/JsModule cross-kind conflict false positive Accepted
0094 Custom("Risk") KIR kind: Observed Concentration Risk, v1 Accepted
0095 Architecture confidence in docs generate's Executive Summary Accepted
0096 EKL: AS OF <timestamp> and COUNT/GROUP BY aggregation Accepted
0097 Read-only FactLedger open, and a safe ekos mcp serve store cache Accepted
0098 ekos ask streaming (CLI path) Accepted
0099 Multi-turn conversation history in ekos ask Accepted
0100 Search indexes ai_overview/ai_usage (RFC F, redesigned) Accepted
0101 Structural search boost for memory/-path content (RFC E) Accepted
0102 render_graph_svg wiring follow-ons (RFC 0068 §61) Accepted
0103 Self-healing SearchIndex schema migration Accepted
0104 Storage Architecture Phase 1: Concurrency Accepted
0105 Storage Architecture Phase 2: WAL Recognition + Repair Tool Accepted
0106 Storage Architecture Phase 3: Version-Chain Checkpoints Accepted
0107 MCP Exposure of Architecture Query Tools (RFC 0068 §62 Phase 2) Accepted
0108 Architecture Diff (RFC 0068 §55) Accepted
0109 Architecture Claim Human Review (RFC 0068 §62 Phase 2) Accepted
0112 Lock-Free Snapshot Reads for FactLedger (WAL-Style Read/Write Isolation) Accepted
0113 Storage Phase B: Distributed Mode Implementation Accepted
0114 Query Usage Log + Heuristic Result Caching (Storage Plan Phase 5 groundwork) Accepted (per user direction
0115 MCP over TCP Accepted (per user direction
0116 Top-level ekos status CLI alias Accepted (per user direction
0118 Compiled-Knowledge Query Engine: SEARCH → QUERY → REASON Accepted
0119 The retrieval seam: KnowledgeStore::retrieve Accepted
0120 Rank fusion + the exact-name signal Accepted
0121 Query understanding: entity resolution + intent Accepted
0122 The QUERY surface: fact lookup + named graph operations Accepted
0123 REASON: the Query Plan IR, rules planner, and typed Evidence Set Accepted
0124 Phase 5 of RFC 0118: the surface — ekos ask on REASON, MCP ekos_query / ekos_retrieve, EKL SEMANTIC Accepted
0125 Phase 6 of RFC 0118: the SEARCH vector arm Accepted
0126 Phase 7 of RFC 0118: retrieval eval harness + per-arm telemetry Accepted
0127 Web Console: a browser surface over a compiled workspace Accepted (2026-09-02)
0128 Web Console Phase 0 (rest of): TCP auth, Python MCP client, web/ skeleton Accepted
0129 Web Console Phase 1: shell + statistics Accepted
0130 Web Console Phase 2: ekos.toml configuration UX Accepted
0131 Web Console Phase 3: command runner, job runner, OIDC auth Accepted
0132 Web Console Phase 4: scheduled runs Accepted
0133 Web Console Phase 5: graph view (LOD 0/1) Accepted
0134 Web Console Phase 6: graph time-travel (timelapse slider) Accepted
0135 Core provenance & determinism foundations Accepted
0136 Web Console Phase 6: Graph v2 (neighbourhood isolation, impact mode, server-side layout, export) Accepted
0138 ekos eval: end-to-end agent/answer evaluation harness Accepted
0139 Answer quality: attribution, a fair ruler, and the three defect layers Accepted
0140 Source-grounded retrieval: precise spans, and reading the source on demand Accepted
0141 What entities and edges should carry Accepted
0142 Telling the user what ekos commit is doing Accepted
0143 MCP over Streamable HTTP Accepted (per user direction
0144 Document structure, section attributes, and deterministic doc links Accepted (per user direction, 2026-09-15
0145 OpenAI-compatible endpoints and an explicit Ollama context window Accepted (per user direction, 2026-09-15
0146 PostgreSQL dialect coverage for hand-written schemas Accepted
0147 Perl Connector and Structural Analyzer Accepted
0148 .NET & Java binary recovery, and LLM business-logic reconstruction Accepted
0149 Extension seam: out-of-tree connectors and the private binary decompiler Accepted
0150 Statement-level .NET recovery, and assisted migration to Python Accepted
0151 Agent Session Memory Accepted, all phases implemented 2026-09-21 (devlog_197)
0152 First-Run Self-Verification: Workspace Detection and Coverage Reporting Accepted
0153 Release Engineering and Binary Distribution Accepted
0154 EKOS Migrate: architecture, state machine and fact model Implemented (Phase 0, 2026-09-24, devlog_205)
0155 Canonical value serialization and cross-engine checksums Implemented (2026-09, devlog_206 on); open items under "Migrate Phase
0156 Validation tiers, bisect, divergence classification and planted controls Implemented for tiers V1–V3, verified live; V0 and persisted tier resu
0157 Live PostgreSQL connector, profiling tiers, and redaction at the live entry point Implemented, verified live ("Migrate Phase 2" in TODO.md)
0158 Data-quality rules, target compatibility, and the source-coverage completeness check Implemented; the completeness check reports but does not gate ("Migrat
0159 Type mapping registry and ClickHouse target design Implemented; design and mapping facts are not persisted yet ("Migrate
0160 Guarded execution: statement classifier, environments and data movement Implemented; resume and throttling of a load are open ("Migrate Phase
0161 Risk classes, approval workflow and evidence snapshots Implemented; ekos migrate signoff is open ("Migrate Phase 5" in TODO.m
0162 Evidence-backed migration report and the groundedness gate Implemented (Markdown report); HTML/PDF renderers are open ("Migrate P
0163 PL/pgSQL → a procedural IR, deterministically Accepted
0164 Logic lowering, constrained reconstruction and differential execution Implemented for views, in two phases (2026-10-11, devlog_252 and devlo
0168 Fact-index point lookups: skip runs that cannot match, and stop decoding what is thrown away Accepted (2026-09-28, maintainer)
0169 Views as first-class ledger objects Accepted and implemented (2026-10-03, devlog_231–232)
0171 Source freshness: does the ledger still match the source? Implemented (2026-10-09)
0173 Disputed claims in answers: disputed: true on ekos_query / ekos_retrieve Implemented (2026-10-11), with the ekos ask and table-link amendments
0174 Console conflicts view Implemented (2026-10-11)
0175 Four places that returned a wrong answer without saying so Implemented (2026-10-11)
0176 Structural DDL parsing degrades per statement Implemented (2026-10-11)
0177 Eval follow-up: retrieval gaps, premise rejections, uncited answers Accepted
0178 EKOS home, projects and sources Accepted
0179 Installer into the EKOS home, and one production image Accepted
0180 Tenants, users, groups and roles in the console Accepted
0181 Read scope: access control inside a project Accepted
0182 MCP gateway on the console Accepted
0183 Operations: backup, restore, model credentials per tenant Accepted
0184 Console settings in a file, local mode, secrets in the OS keychain Accepted
0185 Installer: a setup wizard in the browser, the console launcher, full packages Accepted
0186 Every setting and every command from the web Accepted
0187 Chat with a configured model using the EKOS tools Accepted
0188 Uninstall from the browser Accepted
0189 One button to initialise and compile a project Accepted
0190 EKOS Lakehouse: PostgreSQL → Iceberg medallion pipelines Accepted (design); implementation in milestones M0–M5
0191 Extension seam v2: commands, their classes, scoped MCP tools Accepted
0192 EKOS Lakehouse M1: bronze Accepted
0193 EKOS Lakehouse M2: silver Accepted
0194 EKOS Lakehouse M3: source schema changes Accepted
0195 EKOS Lakehouse M4: gold marts from written descriptions Accepted
0196 EKOS Lakehouse M5: monitoring and self-serve Accepted
0197 LLM task routing, cost accounting and a model bake-off Accepted
0198 Console pages from extensions Accepted
0199 EKOS Lakehouse: console tab, one-command install, user documentation Accepted
0200 Pentaho packages to lakehouse dbt (silver and gold) Accepted
0201 The deep Kettle model: packages, steps, variables, links Accepted
0202 Kettle expressions and the relational IR Accepted
0203 Pentaho code steps: JavaScript, Java classes, compiled plugins Accepted
0204 Pentaho to silver and gold dbt models Accepted
0205 Model-drafted SQL for Pentaho code steps the translator cannot follow Accepted
0206 JVM statement recovery behind JavaDecompiler Accepted
0207 Console pages v3 (selections, code, graph, markdown) and the Pentaho tab Accepted
0209 Java Source Analyzer, Application Model Recognizer, Embedded SQL, Ticket Anchors Accepted
0210 Oracle SQL Dialect, PL/SQL Procedural IR, Schema History from Migration Scripts Accepted
0211 Live Oracle Connector, Profiling, Code ↔ Database Conflicts Accepted
0212 Write Behaviour: How Each Table Is Updated and Deleted Accepted
0213 Operator Workflow: Step Bar, Review, Digest-Bound Sign-Off Accepted
0214 Source-estate documentation, published to a wiki Accepted (Phase 1)
0215 EKOS Lakehouse: requirements to mart metadata (step 4) Accepted
0216 EKOS Lakehouse: a source-engine seam, and Oracle as a source Accepted
0218 The generated demo book: the operator workflow on iDempiere, from the console Accepted
0219 Ticket Anchors: Commits, Change Sets and Code Joined by Ticket Key Accepted
0220 Structured Run Logs Accepted
0221 Documentation Repository and Wiki Snapshot Accepted
0222 iDempiere Part I Exit Eval Accepted
0223 Sources in the console: databases, their passwords, a connection test Accepted
0224 Identity candidates must agree word for word Accepted
0225 EKOS Lakehouse: the extraction plan from write behaviour, and deletes without a marker Accepted
0226 EKOS Lakehouse: the extraction plan as a reviewed decision (step 5) Accepted
0227 EKOS Lakehouse: silver from the source model, and the pipeline run (step 6) Accepted
0228 EKOS Lakehouse: marts — propose, merge, build, reconcile (step 7) Accepted
0229 zstd advisories: tantivy 0.22 → 0.27, parquet 53 → 60 Accepted
0230 Step 2 in the console: generate and publish the source-estate documentation Accepted
0231 EKOS Lakehouse: each project's own silver and gold schemas Accepted
0232 EKOS on Azure, Google Cloud and AWS Accepted
0233 Cross-reference integrity check Accepted
0235 PostgreSQL and ClickHouse as project databases Accepted
0240 Benchmark adapters for ekos eval, and the BIRD adapter Accepted
0241 Text-to-SQL quality on BIRD: profiles, value lookup v2, result checks, failure categories Accepted
0242 Text-to-SQL agent with gold-free checks: BIRD first, then real SQL and dbt Accepted
0243 Per-dialect SQL checking and generation in every SQL plugin Accepted
0244 Submitting EKOS to the BIRD-Test leaderboard Accepted
0245 Apache Ossie interchange: export, ingest, review round trip Accepted
0246 Putting ingested Apache Ossie models to work Accepted
0247 Annotations: comments, instructions and synonyms on any ledger entity Accepted (2026-11-07)
0248 Questions to dashboards: triage, term resolution and gold changes Accepted (2026-11-07, on the maintainer's instruction to implement all
0249 Public demo: safety, bans and limits Accepted (2026-11-07, on the maintainer's instruction to implement all
0250 ekos_sql_generate: EKOS's SQL agent over MCP Accepted and implemented (2026-11-08, on the maintainer's instruction;
0251 Public sign-in: Azure Container Apps authentication for the console and Superset Accepted (2026-11-08, on the maintainer's choice of GitHub/Google sign

Accepted, with open scope (13)

Only the RFCs that were re-checked on 2026-09-19 carry a "verified against the code" note; the rest of the Accepted list is as previously labelled. These are accepted designs whose own status line names work that has not been built, is blocked, or was deferred. The status text is shown in full.

RFC Title Status
0036 Pentaho → dbt Model Export Accepted — implemented (verified against the code 2026-09-19); dbt adapter targeting, tests: emission and materialization choices remain open questions
0037 Curated Documentation Set (Architecture/API/README/Sequence Diagrams) Accepted — implemented (verified against the code 2026-09-19); HTML output for the curated layout is deferred
0038 Code Knowledge Expansion Roadmap Accepted — roadmap; Phases 1–2 implemented (RFC 0039, RFC 0040), Phases 3–6 (Jupyter notebooks, Databricks connector, ADF connector, generalized parameterization) not started (verified against the code 2026-09-19)
0040 Phase 2: Python/PySpark Analyzer (RFC 0038 Phase 2) Accepted — implemented (verified against the code 2026-09-19); .ipynb support and interprocedural tracing are deferred
0041 Rust Source Analyzer (real symbols + import graph + real Calls edges) Accepted — implemented (verified against the code 2026-09-19); cross-file/crate call resolution is deferred
0044 Hierarchical Knowledge Rollups (+ a prerequisite object-identity fix) Accepted — implemented (verified against the code 2026-09-19); per-sub-project curated docs, LLM prose per rollup and an ekos_summarize tool are deferred
0065 EKOS Architecture Knowledge Model & Iterative Intelligence Loop Accepted — partially implemented: Phases 1–3 (crate topology, LLM role classification, evaluation) shipped; the wider build-out is open (verified against the code 2026-09-19)
0066 EKOS Architecture Agent State Machine & Investigation Orchestrator Accepted — partially implemented: the MVP investigation loop shipped; the rest is open (verified against the code 2026-09-19)
0068 EKOS Architecture Documentation Standard & Deliverable Model Accepted — partially implemented: the first slice of the documentation standard shipped (crate topology, one container view, role classification); Terraform/Kubernetes/OpenAPI extractors, deployment/security/quality views, continuous drift and ADR generation a
0080 Storage Architecture Plan: Six Gaps, Grounded and Prioritized Accepted — Phases 1–3 of 6 implemented; Phase 4 (retention) is blocked on an unresolved append-only-invariant decision; Phase 5 (materialized views) is not started; Phase 6 (distribution) was superseded by RFC 0111/0113 (planning RFC — no implementation in thi
0111 Partitioned, Tiered, and Distributed Fact-Segment Storage Accepted (Phase A implemented, Phase B v1 feature-complete via RFC 0113; several Open Questions remain — verified against the code 2026-09-19) — merges and supersedes RFC 0034 and RFC 0110 (below). 5 Open Questions
0170 Business semantics from technical traces, exported as LinkML Accepted — Phases 1–4 implemented (devlog_234–239, 2026-10-03). Open: an expert-written gold set
0172 ConflictingEvidence: when sources disagree, keep both and say so Implemented — Phases 1–3 (2026-10-09)