IF Commons GitHub

physical/program

Written to: 1 requirement: 1 proved, 0 partly, 0 failing, 0 with no test recorded. 0006-repoctl-surfaces FR-001

The program repoctl as Headless' tree (commons repoctl 0006-repoctl-surfaces FR-001 to FR-005; commons headless 0003-headless-output, 0009-composition, 0010-audience-tiers, 0013-mcp-surface): its verbs and branches, each declared with the facts of its action, its options, operands and examples, and the data Headless configures itself with (the name and version, the prefix of the variables, the codes it explains, the secrets it redacts, the tiers). repoctlProgram(host) is the one place the tree is made; the command line runs it (repoctl.ts), the tool server serves it by tier (repoctl mcp), and anything that describes a program (a documentation lens) reads it.

import { INERT_HOST, repoctlProgram } from "@intellectual-frontiers/repoctl/physical";
repoctlProgram(INERT_HOST).name; // "repoctl"

Source: commons/repoctl/src/physical/program.ts

3 of 6 exports are imported by a test of the run. A test that imports an export may not call it or check what it returns.

physical.INERT_HOSTconstno test imports it
const INERT_HOST: Host

A host that does nothing: the tree of a program is made from it without reading anything, and describe never runs a verb. Its configuration is the bare one, so the verbs of every repository are in the tree; a repository's capabilities add theirs.

physical.heldTierfunctionno test imports it
function heldTier(env: (name: string) => string | undefined, config: Pick<Config, "tierVariable">): { readonly tier: TierName; } | { readonly unknown: string; }

The held tier of a host: the one the configuration's variable names, the ladder's default where it says nothing, or the word that is no tier.

physical.repoctlProgramfunctionno test imports it
function repoctlProgram(host: Host): Program

repoctl as a Headless program, for the host it runs on.

INERT_HOSTconst
const INERT_HOST: Host

A host that does nothing: the tree of a program is made from it without reading anything, and describe never runs a verb. Its configuration is the bare one, so the verbs of every repository are in the tree; a repository's capabilities add theirs.

Imported by 8 tests of the run (8 passed, 0 failed): the library's results

repoctlProgramfunction
function repoctlProgram(host: Host): Program

repoctl as a Headless program, for the host it runs on.

Imported by 8 tests of the run (8 passed, 0 failed): the library's results

heldTierfunction
function heldTier(env: (name: string) => string | undefined, config: Pick<Config, "tierVariable">): { readonly tier: TierName; } | { readonly unknown: string; }

The held tier of a host: the one the configuration's variable names, the ladder's default where it says nothing, or the word that is no tier.

Imported by 3 tests of the run (3 passed, 0 failed): the library's results

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