toolchain-advisor

Canonical definitions for the DevCentr Toolchain Advisor: decision steps, options (with timeline and alternate context), and recommendation rules.

Layout

catalog/advisor.sdl      # Source of truth (author here)
catalog/advisor.json     # Compiled artifact (web bundle; commit after compile)
lib/                     # Shared ranking/parser (@dev-centr/toolchain-advisor-core)
scripts/compile-sdl.mjs  # SDL → JSON (Node; no DMD required)
docs/SDL-CONVENTIONS.adoc

Edit workflow

1. Change catalog/advisor.sdl.

2. Run node scripts/compile-sdl.mjs and commit both .sdl and .json.

3. Open a PR; CI validates compile + parse.

4. DevCentr desktop pulls via git (Settings → definitions repo URL).

5. devcentr.org bundles advisor.json at build when CI checks out this repo.

Consumers

| Client | How it loads | DevCentr desktop | git clone / git pull → reads catalog/advisor.sdl | devcentr.org | Build: checkout repo, compile-sdl.mjs, copy to public/catalog/advisor.json

Default repo: https://github.com/dev-centr/toolchain-advisor.git

Related

• DevCentr spec: devcentr/docs/modules/specifications/pages/components/toolchain-advisor.adoc