Skip to content
Beskid Platform specification

Beskid

Jump to a Beskid service

Beskid

Jump to a Beskid service

tool reserved (superseded)

Platform spec ADR

tool reserved (superseded)

Spec standingStandard

Owner
Piotr Mikstacki
Submitter
Piotr Mikstacki

Superseded by D-TOOL-PCKG-0004 — tool kind Standard on 2026-05-23.

This decision documented the original intent to reserve packageKind: tool in the registry taxonomy without committing to a validator profile, dashboard surface, or CLI routing. That reservation has now been replaced with a fully normative profile. Implementations must follow D-TOOL-PCKG-0004; this ADR is preserved for history.

When the packageKind field was introduced on beskid.package.v1, two kinds (library, template) had concrete validator profiles and dashboard routing; tool was anticipated but not yet specified. The team did not want the absence of tool rules to be interpreted as silent acceptance.

Reserve tool as a known-but-not-Standard packageKind value. The pckg server accepted the literal string but did not commit to validator behavior, dashboard routing, or CLI flags. Publishers were warned that the contract would land in a follow-up decision.

  • Validators recognised the kind without expanding the supported set: any deviation from the library profile would be a future, opt-in change.
  • The dashboard fell back to the library rendering for tool artifacts, which made the kind effectively invisible to users.
  • CLI tooling (beskid pckg pack) had no --package-kind flag, so publishers could not deliberately mark an artifact as tool.

Verification responsibility transferred to D-TOOL-PCKG-0004; see 0004-tool-kind-standard.mdx for the current test surface.