equivalence-rules-cli

Cross-platform CLI tool install profiles for DevCentr (Equivalence Engine cli domain).

Report Bug · Request Feature

About The Project

Canonical CLI tool install profiles for DevCentr. Each tool defines cross-platform install commands resolved by host context (Windows winget/scoop, macOS Homebrew, Linux apt/dnf/pacman/apk, and immutable Nix profiles).

Uses the Equivalence Engine cli domain to resolve context + toolId → install command, or load the compiled catalog directly in DevCentr.

Each context has a format facet (winget, deb, nix, …). That is a column, not a new --to path. Do not write windows/pwsh/msi. List every compatible method with equivalence-engine --domain cli --list gh. PlayTime (Scriptbook) uses that list so one .cmk playbook can install a tool on every OS.

See docs/SDL-CONVENTIONS.adoc.

back to top

Layout

catalog/tools.sdl       # Source of truth (author here)
catalog/tools.json      # Compiled artifact (commit after compile)
contexts/               # Context inheritance (mirrors filesystem rules layout)
scripts/compile-sdl.mjs # SDL → JSON
docs/SDL-CONVENTIONS.adoc

Usage

Edit workflow

1. Change catalog/tools.sdl or add tools under catalog/tools/.

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

3. DevCentr desktop pulls via git (Settings → CLI tools definitions repo URL).

4. Install scripts run interactively; DevCentr records stdout/stderr under ~/.dev-center/install-audit/.

Resolve via Equivalence Engine

equivalence-engine --domain cli \
  --rules-repo https://github.com/dev-centr/equivalence-rules-cli \
  --to windows/winget turso

Prefer immutable contexts when available:

equivalence-engine --domain cli --to linux/nix/default gh

back to top

Related

• equivalence-engine

• libequivalence

• DevCentr spec: devcentr/docs/modules/specifications/pages/components/cli-tools-catalog.adoc

Contact

DevCentr.org — support@devcentr.org

• Project: https://github.com/dev-centr/equivalence-rules-cli

• Site: https://devcentr.org

back to top