IF Commons GitHub

Native-pinned layers

0001Active

0001-native-pinned-layers · owner if · domain commons

Requirements

FR-001checkpassing

The package MUST be a member of the family of archon as a dialect: its manifest library.ts MUST declare family: { host: "archon", role: "dialect" } and the field kanon with extends naming @intellectual-frontiers/archon, its sources MUST be one unit of the Physical layer (src/), and the host MUST declare it as an instance of the dialect port; the shared checker of @intellectual-frontiers/kanon MUST find no finding.

Enforced (check): .github: cd commons/archon-dialect-native-pinned && bun run verify — suite/layers.test.ts: a dialect of the Archon family and the shared checker finds nothing

Proved by: archon-dialect-native-pinned/suite/layers.test.ts

Written in: archon-dialect-native-pinned/about.ts, archon-dialect-native-pinned/library.ts

Tests: passed: suite/layers.test.ts the package is a dialect of the Archon family and the shared checker finds nothing in its

FR-002checkpassing

The package MUST reach @intellectual-frontiers/archon only through its exports (governance, logical, dialect) and @intellectual-frontiers/toolchain only through its exports (governance, logical, ontology), and MUST NOT import another dialect or a plugin of the command.

Enforced (check): .github: cd commons/archon-dialect-native-pinned && bun run verify — suite/layers.test.ts: no other dialect or plugin is imported and archon and toolchain only through their exports

Proved by: archon-dialect-native-pinned/suite/layers.test.ts

Tests: passed: suite/layers.test.ts no source imports another dialect or a plugin, and archon and toolchain are reached only t

FR-003checkpassing

The package MUST export . (the dialect), ./install (the pure logic of an install, so that another program that installs pinned tools uses it and keeps no copy) and ./pin (the pin tool).

Enforced (check): .github: cd commons/archon-dialect-native-pinned && bun run verify — suite/layers.test.ts: the package exports the dialect and the pure install logic

Proved by: archon-dialect-native-pinned/suite/layers.test.ts

Written in: archon-dialect-native-pinned/src/mod.ts

Tests: passed: suite/layers.test.ts the package exports the dialect, the pure install logic and the pin tool

FR-004checkpassing

bun run verify in the folder of the package MUST run the TypeScript 7 compiler, the checks of the specification kit, the check of the level L1, the layers check of Kanon, the trace check, the tests under Bun and the check of the package, and MUST fail on any finding that is not held by a baseline that only shrinks.

Enforced (check): .github: cd commons/archon-dialect-native-pinned && bun run verify — suite/layers.test.ts: verify runs every check

Proved by: archon-dialect-native-pinned/suite/layers.test.ts

Tests: passed: suite/layers.test.ts verify runs the compiler, the specification checks, the layers check, the trace check, the

FR-005checkpassing

The package MUST be released as archon-dialect-native-pinned-v<version> (commons 0026-works-versioning).

Enforced (check): .github: cd commons/archon-dialect-native-pinned && bun run verify — suite/layers.test.ts: the release record agrees with the manifest

Proved by: archon-dialect-native-pinned/suite/layers.test.ts

Written in: archon-dialect-native-pinned/tools/check.ts, archon-dialect-native-pinned/tools/pack.ts

Tests: passed: suite/layers.test.ts the release record agrees with the manifest

FR-006checkpassing

No source of the package MUST run a package manager, ask for administrator rights, or run a compiler or a build: it installs what its publisher released and nothing else.

Enforced (check): .github: cd commons/archon-dialect-native-pinned && bun run verify — suite/layers.test.ts: no package manager, administrator rights or compiler

Proved by: archon-dialect-native-pinned/suite/layers.test.ts

Tests: passed: suite/layers.test.ts no source runs a package manager, asks for administrator rights or runs a compiler

Acceptance scenarios

  1. Given the real tree of the package, When the layers check runs, Then it finds nothing, per FR-001 and FR-002.
  2. Given a source that imports another dialect, When the check runs, Then it is a finding, per FR-002.
  3. Given the sources, When they are read, Then none names sudo, apt, brew, winget, cargo build or make, per FR-006.

Out of scope

  • The other dialects of tools (package managers): packages of their own.
  • The command a person types (archon tool ...): a plugin.

Edge cases

  • A source that runs git: allowed only where it is not a package manager; none is needed, per FR-006.

Assumptions

  • The shared checker of Kanon and the family rules are on the branch that holds this package.

Open questions

  • None.

Key entities

  • Native-pinned - the dialect.
  • Install - what the dialect does for one tool.

Success criteria

SC-001success criterion

The layers check of Kanon finds nothing in the real tree.

SC-002success criterion

No source can install anything but a pinned artifact.

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.