Intellectual Frontiers Commons
Everything that any company or harness of Intellectual Frontiers may use, as independent libraries. Each library is built in layers (Kanon): governance says what a thing is and may do, the logical layer is the model a program reasons with, and the physical layer is what runs (tables, commands, tools, routes). Each has its own specifications, tests and package, and is proved by one command, bun run verify, in its folder. Start with ergonex, the front-door command: it sets up a workspace of the repositories, tools and shell a person needs, shows a plan before it changes anything, and checks the result. Read the libraries below for what each is for, the API reference to call them, the specifications for what each promises and how it is checked, and the models and programs for what the libraries say about themselves. The code is source-available: free to read and to use noncommercially under the PolyForm Noncommercial License 1.0.0, and commercial use needs a paid license from the owner (see Licensing in Start here). This repository holds no company fact and no secret: it is public.
Libraries
Capabilities
Each capability is a specification of commons' spec kit, under the one it is part of.
Folders
| Folder | What it is | May import |
|---|---|---|
ontology/src/supply-chain/packaging/ | The packaging vocabulary (packaging.ts) and its data (managers.ts, families.ts, programs.ts, pins.ts, rules.ts, record.ts), seeded from the tables of upt (MIT or Apache-2.0) and from what archon runs. It is TypeScript, typed by the RDF library; its Turtle is generated, never a source. | rdf/src/mod.ts; ontology/ |
tools/ | The tools, in TypeScript that Bun runs (Node 26 too): the generator of generated/, the spec-kit checker and the shell portability checker. | tools/; ontology/ (the generator, which reads its typed values) |
generated/ | The tables made from the ontology, for programs, scripts and a harness's setup, with the pinned downloads, and the ontology's Turtle; never edited by hand. | nothing: generated |
docs/ | The generator of this documentation, IFC Docs, which any repository uses by depending on commons; it reads TypeScript and the spec kits as docs.config.ts names them. | see its own about.ts |
spec-kit/ | The specifications that belong to commons as a whole, the register of their numbers and of what enforces each requirement. Each library keeps its own in its own spec-kit/. | nothing: Markdown and TSV |
Commands
| Command | What it does |
|---|---|
bun tools/generate-packaging.ts | Writes generated/ again from the ontology; with --check it fails where a file is stale. |
bun tools/mizan-check.ts [--root DIR] [--register DIR] | Checks spec-kit/ against the format of 0003-mizan; a harness whose registers are in another folder names it with --register, and its numbers may have three digits or four. |
bun libraries/src/generate-ontology.ts | Writes generated/mizan.auto.ttl from Mizan's ontology; with --check it fails where the file is stale. |
bun libraries/src/oscal-register.ts | Writes the proof register of spec-kit/ as OSCAL 1.2.3 (generated/mizan-register.auto.oscal.json, generated/mizan-register-results.auto.oscal.json); with --check it fails where a file is stale. |
bun libraries/src/libraries.ts [--check] | Writes the requirements of the libraries (0027-commons-libraries) and their rows of the register from each library's manifest, commons/<name>/library.ts; with --check it fails where they are stale or a manifest and its folder disagree. |
bun libraries/src/check.ts [--level L0|L1|L2|L3] [--all] | Checks a folder against the rules Mizan adds, held by a baseline that only shrinks, at the conformance level it declares (0028-conformance-levels); with --all it also runs every library's verify. |
bun libraries/src/newer.ts | Fetches the latest source of each import manifest and finds a standard whose newest bytes differ from its pin; needs the network, so it is opt-in and check.ts never runs it. |
bun tools/shell-portability-check.ts FILE... | Finds what only GNU tools have in shell scripts. |