Skip to content

Stable Roots

Stable roots are the long-lived public packages at the repository root. They define the default learning path and the v1 compatibility promise Plumego intends to preserve.

Synced from `specs/repo.yaml` and `specs/task-routing.yaml`

Stable root inventory

9 stable roots

  • contract
  • core
  • router
  • middleware
  • security
  • store
  • health
  • log
  • metrics

Synced from `specs/repo.yaml` and `specs/task-routing.yaml`

Default routing intent

Change kernel, lifecycle, route structure, transport contracts, transport middleware, auth primitives, or storage primitives.

Discouraged new top-level roots

  • ai
  • tenant
  • net
  • pubsub
  • rest
  • validator
  • utils
  • frontend

These fact blocks come from the machine-readable repository specs instead of a copied docs-only list.

  • application kernel and lifecycle
  • route structure and matching primitives
  • transport contracts and response helpers
  • transport-only middleware
  • security primitives and base storage abstractions
  • product-specific feature logic
  • tenant-aware policy branching
  • protocol family catalogs
  • optional frontend, AI, data-topology, or gateway behavior

If the change would force a stable root to learn an extension concern, move the behavior to the owning x/* family instead.