IF Commons GitHub

mise dialect

0002Active

0002-mise-dialect · owner if · domain commons

Requirements

FR-001checkpassing

The dialect MUST declare as data that it is the manager manager-mise, that it pins exact, checks by none, installs in the scope user, reaches linux-x64, linux-arm64, macos-x64, macos-arm64, windows-x64, takes the packages of a binding, and can build from source.

Enforced (check): .github: cd commons/archon-dialect-mise && bun run verify — suite/dialect.test.ts

Proved by: archon-dialect-mise/suite/dialect.test.ts

Written in: archon-dialect-mise/src/dialect.ts

Tests: passed: suite/dialect.test.ts against the real ontology: the way it writes a version and the status of its check agree w; passed: suite/dialect.test.ts the data says what mise guarantees

FR-002checkpassing

mise(commands, options) MUST give the dialect of the kit made from this data and the commands it is given, with the id mise, of the kind tool, so that Archon renders, steps and observes through the kit and this package holds no command line.

Enforced (check): .github: cd commons/archon-dialect-mise && bun run verify — suite/dialect.test.ts

Proved by: archon-dialect-mise/suite/dialect.test.ts

Written in: archon-dialect-mise/src/dialect.ts

Tests: passed: suite/dialect.test.ts the dialect of the kit is made from the data, and an exact version is written as the manag

FR-003checkpassing

An exact version MUST be written joined to the name with @ (git@2.43.0).

Enforced (check): .github: cd commons/archon-dialect-mise && bun run verify — suite/dialect.test.ts

Proved by: archon-dialect-mise/suite/dialect.test.ts

Written in: archon-dialect-mise/src/dialect.ts

Tests: passed: suite/dialect.test.ts against the real ontology: the way it writes a version and the status of its check agree w; passed: suite/dialect.test.ts the dialect of the kit is made from the data, and an exact version is written as the manag

FR-004checkpassing

Toolchain MUST resolve a tool to this dialect only where its guarantees meet the control: for rolling it is chosen only where the fleet approved source builds, for release-line it is chosen only where the fleet approved source builds, and for exact-hashed it is not chosen: it does not check by a hash.

Enforced (check): .github: cd commons/archon-dialect-mise && bun run verify — suite/dialect.test.ts

Proved by: archon-dialect-mise/suite/dialect.test.ts

Tests: passed: suite/dialect.test.ts Toolchain chooses the dialect only for the controls whose demands its guarantees meet

Acceptance scenarios

  1. Given the dialect, When its data is read, Then it is as FR-001 says.
  2. Given commands, When a tool is rendered, Then the commands are those of the manager with the version as FR-003 says, per FR-002.
  3. Given each control, When a tool is resolved, Then the dialect is chosen as FR-004 says.

Out of scope

  • Reading the commands from the ontology: the reader of the ontology gives them as a function.
  • Proving idempotence on a real mise: a conformance run on a machine that has it.

Edge cases

  • A version asked of a manager that cannot write one is refused at render with the manager's reason, per FR-003.

Assumptions

  • What mise guarantees (what it checks, what it pins) is stated from its documentation and not proved by a run of this suite; the dialect states it and claims no more.

Open questions

  • None.

Key entities

  • Manager spec - the data of mise for the kit.

Success criteria

SC-001success criterion

A fleet whose control a manager cannot meet never gets it chosen.

Review & acceptance checklist

  • [x] Every requirement is testable (MUST / MUST NOT), not aspirational
  • [x] No company fact is asserted here
  • [x] Every open item is marked, not silently decided

Titles, headings, exports, tables, columns and requirements. Esc closes.