Enterprise Automation Use Cases
Seven enterprise automation use cases for EKOS with an orchestrator such as Dagster or LangGraph: what EKOS does today, what the orchestrator adds, and what is not built yet.
EKOS compiles code, schemas, SQL, documents and Git history into evidence-backed knowledge. It serves that knowledge read-only over MCP. Many enterprise automations need exactly this, but EKOS is one part of them, not all of them. An orchestrator runs the workflow. Dagster suits asset-centric data pipelines. LangGraph suits iterative agent loops: write a change, check it against EKOS, fix, retry. People approve what is risky.
[ code · SQL · schemas · documents · Git · binaries ]
│ observe, compile (deterministic)
▼
[ EKOS knowledge ledger ] ── every fact cites file:line
│ read-only MCP / CLI
▼
[ your orchestrator: Dagster, LangGraph, CI ] ── proposes changes as pull requests
│
▼
[ a person reviews and merges ]
Each use case below says three things: what EKOS does today, what the orchestrator or an agent adds, and what is not built. EKOS checks a proposed change against the compiled graph. That check finds broken references and missed dependents. It does not prove a change correct, and the review step stays.
1. Personal-data audit
Problem. Personal data reaches places it should not, such as plain-text logs, caches or third-party analytics. Nobody can say which code paths carry it.
- EKOS today: builds call graphs for Rust, Python, JavaScript/TypeScript, Elixir and Perl, plus which code reads and writes which table and column-level SQL lineage. A reviewer or agent can follow a column from the table to the code that uses it, with
path:lineon every step. EKOS's own store holds no secrets or personal data: redaction runs before anything is stored, and it cannot be switched off. - Orchestrator adds: an agent loop that walks those paths from the columns you mark as personal and proposes masking changes as pull requests.
- Not built: variable-level taint analysis inside a function, and automatic classification of personal-data columns.
2. Legacy modernization and database migration
Problem. Old systems hide undocumented dependencies, and these are what break during a rewrite or a database move.
- EKOS today:
- Recovers stored procedures, views and triggers from source. On LedgerSMB that was all 212 PL/pgSQL routines.
- Explains legacy ETL step by step (
ekos_transformation_explain, for Pentaho, SQL and procedures) and renders Pentaho jobs as dbt models. - Answers "what breaks if this changes" several hops out (
ekos_impact). - Scores architecture completeness.
- EKOS Migrate moves PostgreSQL to ClickHouse with an evidence-backed design, approval gated by computed risk (human-only), and validation against the source: see Migrating a Database.
- Compiled .NET and JVM binaries are recovered by a separately licensed extension.
- Orchestrator adds: an agent that rewrites a module, then re-runs the pipeline on the result and checks
ekos_impactand the dependents for anything left dangling, before a person reviews it. - Not built: COBOL and C++ recovery, automatic service-boundary proposals, and gRPC/OpenAPI generation.
3. Pipelines that notice upstream changes
Problem. An application change, such as a renamed column, silently breaks dbt models and dashboards downstream.
- EKOS today:
- Compiles dbt projects (models,
ref()/source(), schema tests) and SQL into one graph with the application code. ekos_impactlists the models and tables that read a changed column.ekos freshnessreports which source files changed since the last compile, and which objects cite them.- Where sources disagree, EKOS records a conflict instead of picking a side.
- Orchestrator adds: a CI job or Dagster sensor that re-compiles on each pull request, asks
ekos_impactabout the changed objects, and comments with the blast radius. An agent can draft the matching dbt change as a separate pull request. See Automation. - Not built: automatic fixes merged without review. EKOS never merges anything.
4. Living architecture documentation and audit evidence
Problem. Architecture documents go stale the day they are written, and gathering audit evidence (SOC 2, ISO 27001, NIS2) is manual.
- EKOS today:
ekos docs generaterenders curated architecture, API and sequence-diagram pages from the ledger, with no LLM. Itssolution-architectlayout adds a dependency risk report, an onboarding guide and a findings memo.ekos diffandAS OFqueries show what changed between two dates.ekos ledger auditshows which run wrote each fact.- Architecture drift and diff tools compare one run with the next.
- Orchestrator adds:
- regenerating the documents on every merge;
- a writer agent that turns the diff into changelogs or decision-record drafts for a person to edit;
- EKL queries that check a rule you state, such as "nothing in
paymentscallsanalytics", and fail the job when it breaks. - Not built: ready-made compliance packages, and a library of built-in architecture rules.
5. Finding unused code and tables
Problem. Unused tables, abandoned services and dead code cost money, and teams are afraid to delete them.
- EKOS today:
ekos_dependentsand EKL queries find objects that nothing compiled depends on. Each answer cites its evidence, so a person can check why EKOS thinks an object is unused. - Orchestrator adds: a periodic job that lists candidates and opens deprecation pull requests for review.
- Not built: parsing Terraform or Kubernetes manifests, and usage from live traffic. EKOS sees only the sources it compiles, so "nothing depends on it" covers only those sources. A table read by an unindexed system will look unused.
6. Replacing a library or SDK across many repositories
Problem. A license change or a deprecated SDK forces a migration across hundreds of repositories on a deadline.
- EKOS today: compiles declared dependencies from package manifests, and imports and calls from code, across every indexed repository into one ledger. One EKL query lists every repository and file that uses the library.
- Orchestrator adds: batch agent workers that write the patches, re-compile each repository to check for broken references, and open a pull request per repository.
- Not built: automatic patching. EKOS does not check that a patch type-checks; your compiler and tests do that.
7. Technical due diligence and onboarding
Problem. After an acquisition, or when a new team inherits a system, it takes months to learn what the system is and where its risks are.
- EKOS today:
- Compiles the source, SQL and documents. Compiled binaries go through the extension.
ekos identity scanproposes matches between objects in different systems, as unconfirmed claims for review.- Objects with many dependents become recorded concentration risks.
- The
solution-architectdocuments give a team its first map. ekos askand MCP give the new team a cited question-and-answer interface.- Orchestrator adds: a review workflow that walks the candidate matches and risks with the people who know the systems.
- Not built: automatic classification of modules into business domains.
Get started
Index one system first and connect an agent: Quickstart, then Connect Your AI Agent. Everything above that EKOS does today runs on a single machine from the open-source release.