Toolchain Management (TCM)

Toolchain Management (TCM) is the DevCentr product component that owns how the app teaches and enforces lifecycle integrity for software ecosystems: install, pin, health, repair, and upgrade in the official entrypoint.

It is the in-product home for the Toolchain Management Pattern. Per-ecosystem UI surfaces live under Ecosystem Management; TCM is the umbrella component that ties pattern, protocol, control plane, and framework together.

Purpose

  • Encode the Toolchain Management vocabulary in DevCentr (Pattern → Protocol → Control Plane → Framework).

  • Drive unifiedControlPlane metadata and top-of-module advisories when an ecosystem lacks an official plane.

  • Point maintainers at the Toolchain Framework (TCF) repository for generating compliant planes.

  • Stay distinct from Toolchain Advisor (host/target decision flow) and CLI Tools Catalog (install profiles).

Vocabulary (locked)

Term Role in TCM

Toolchain Management

Umbrella / problem space (this component’s name).

Pattern

How maintainers should think — GK explanation.

Protocol

Repeatable behaviors — see Protocol behaviors and Ecosystem Management.

Control Plane (TCP / TCoP)

Product metaphor for what ecosystems ship; DevCentr records status via SDL.

Toolchain Framework (TCF)

External kit (dev-centr/toolchain-framework) that builds/validates planes. Not “TMF.”

Protocol behaviors

Canonical list: Ecosystem Management — Protocol.

Bootstrap, pin/resolve, health, repair, upgrade/rollback, surface parity.

UI and data

Piece Location

Language / ecosystem defs

app/src/modules/languages/<ecosystem>.sdl — unifiedControlPlane block

Advisory banner

app/src/modules/ui/advisory_banner.d

Ecosystem panel

app/src/modules/ecosystems/

First instance

Flutter page (pageFlutter) — see Ecosystem Management

Docs Learn more

https://docs.devcentr.org/general-knowledge/latest/explanation/infrastructure/toolchain-management.html

External repositories

Repo Role

dev-centr/toolchain-framework

TCF schemas, validators, CI; generates/conforms control planes

dev-centr/general-knowledge

Pattern / Protocol / Control Plane / TCF explanations (Diátaxis)

dev-centr/toolchain-advisor

Unrelated: host/target advisor catalog (do not conflate)

Related