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) |