Skip to content

Repo Map

Kadyapam edited this page Jun 2, 2026 · 2 revisions

Repo Map

Every submodule under repos/ mapped to its role in the NoETL ecosystem. Use this when you don't know which repo to open.

Last refreshed: 2026-06-02

Production repos (active development)

Control plane

Repo Language Role Wiki Version Last commit
noetl/noetl Python Control plane (server, projector, outbox-publisher), DSL semantics, playbook runtime wiki v4.8.0 2026-06-01
noetl/server Rust Rust port of the control plane (early skeleton; receives put_result from Rust worker today) wiki v2.0.1 2026-05-31
noetl/gateway Rust Auth + SSE + subscription gatekeeper (Auth0 PKCE, runtime contract exposure) wiki v2.14.1 2026-05-29

Workers

Repo Language Role Wiki Version Last commit
noetl/worker Rust NATS pull worker; consumes commands, executes tools, emits events wiki v5.9.0 2026-06-01
noetl-worker (Python pool) Python Lives inside noetl/noetl; still handles agent tool kind per POOL_FILTER_MAP (in main wiki) (with noetl/noetl) (with noetl/noetl)

CLI + tools

Repo Language Role Wiki Version Last commit
noetl/cli Rust The noetl CLI binary; includes noetl-executor shared crate for local-mode execution wiki v4.8.0 2026-06-02
noetl/tools Rust Shared tool-kind registry crate (14 kinds: http, postgres, duckdb, gcs, snowflake, ...) wiki v2.16.0 2026-06-02

Operations

Repo Language Role Wiki Version Last commit
noetl/ops YAML/Helm Kubernetes manifests, Helm chart, KEDA scalers, NATS supercluster, deployment automation wiki (untagged) 2026-06-01
noetl/doctor Rust Operational health checks + diagnostics wiki
noetl/e2e YAML End-to-end regression test fixtures (152 playbooks; 36 enabled) wiki 2026-05-18

Documentation

Repo Role Wiki / Site Last commit
noetl/docs Docusaurus site at https://noetl.dev/docs — engineer-facing architecture, ADRs, Appendix H https://noetl.dev/docs 2026-06-02
noetl-wiki Application reference wiki for noetl/noetl wiki (rolling)

Reference applications

Repo Role Wiki Last commit
noetl/travel Reference SPA — domain-fork example built on NoETL (travel itinerary widgets, gateway integration) wiki 2026-05-28
noetl/gui Operator GUI for catalog browse + execution monitor wiki

Distribution

Repo Role Wiki Last commit
noetl/apt Debian package repository for CLI binaries wiki

Meta / orchestration

Repo Role
noetl/ai-meta This repo. Cross-repo orchestration: shared agents/rules/, memory/, sync/, submodule pointers (repos/), handoffs/, and this wiki (the ecosystem dashboard)

Wikis as separate Git submodules

Every per-repo wiki is itself a Git repo at <repo>.wiki.git. ai-meta pins each wiki as a submodule under repos/<name>-wiki/ so wiki updates land in the same coordinated change set as code updates. See agents/rules/wiki-maintenance.md.

Wiki submodules tracked here:

  • repos/noetl-wiki/ → application docs
  • repos/noetl-server-wiki/ → Rust control plane
  • repos/noetl-worker-wiki/ → Rust pull worker
  • repos/noetl-tools-wiki/ → tool registry
  • repos/noetl-cli-wiki/ → CLI
  • repos/noetl-gateway-wiki/ → gatekeeper
  • repos/noetl-ops-wiki/ → manifests + Helm
  • repos/noetl-travel-wiki/ → SPA reference
  • repos/noetl-doctor-wiki/ → diagnostics
  • repos/noetl-e2e-wiki/ → e2e harness
  • repos/noetl-gui-wiki/ → operator GUI
  • repos/noetl-apt-wiki/ → APT repo
  • repos/ai-meta-wiki/this wiki (the dashboard)

NoETL Dashboard

Active Umbrellas

Closed Umbrellas

Conventions

Per-repo wikis

Clone this wiki locally