The changes check of Intellectual Frontiers Capabilities Configuration Management (commons 0020-ifccm): every commit of a range names the change request it serves, a closing word is Closes and only on the commit that finishes a capability, a departure from a specification has a Decision, a relaxed declaration is found, and each requirement can be followed from its issue to the run that proved it. A Decision of the record that covers no-issue <revision> exempts that one commit from naming a change request (FR-046 to FR-048); the check says it is covered.
bun commons/libraries/src/changes.ts --range origin/main..HEAD judge the commits of the range (offline: no network) bun commons/libraries/src/changes.ts --range A..B --strict also ask the Git host for each change request the commits name bun commons/libraries/src/changes.ts --declaration FILE read the harness's record (declaration, decisions, roles) from FILE (ifccm.declaration.ts by default) bun commons/libraries/src/changes.ts --capabilities FILE --document FILE [--check] write the view of capabilities by rung into the document, or with --check fail where it differs bun commons/libraries/src/changes.ts --trace ISSUE_BODY_FILE [--runs RECORD] [--specs DIR] follow each requirement of a Done when from its term to the run, and say where the chain ends bun commons/libraries/src/changes.ts --capability-trace --range A..B [--issues FILE] [--terms FILE|commons] [--rungs FILE] [--runs RECORD] [--specs DIR] [--format text|json] [--output FILE] offline: from the commits' Refs/Closes #N lines, the specifications' requirements, the ontology's mz:definedBy, the Spec:/Proves: lines and a quality record, the chain of each requirement of each capability (terms, code, tests) on each rung, as a table or as JSON; with --document FILE [--check] the view of capabilities by rung is made from the commits and written between its markers other flags: --repo DIR (the repository, the working folder by default), --today YYYY-MM-DD, --baseline FILE (changes.baseline.txt of the repository by default), --write-baseline
Exit status: 0 clean, 1 findings (or a stale baseline line, or a chain that breaks, or a view that differs), 2 usage, 3 environment (no git, not a repository, a file that cannot be read). A strict rule that could not ask the host is not_run with its reason on standard error and is never reported as passed (0020-ifccm FR-030). The host's client is given to run, never made here: whoever wires the adapters passes it.
Spec: 0001-libraries FR-008
Source: commons/libraries/src/changes.ts
1 of 5 exports are imported by a test of the run. A test that imports an export may not call it or check what it returns.
RuleResulttypeno test imports ittype RuleResult = {
readonly id: string;
readonly findings: readonly { readonly file: string; readonly line?: number; readonly message: string }[];
readonly notRun?: string;
};
One rule's result in a run of the check (0020-ifccm FR-031): its findings, or the reason it did not run. Its shape is the quality system's CheckRule, so a caller keeps it as a record without this file knowing the quality system.
Depstypeno test imports ittype Deps = {
/** Called once with each rule's result where the check judged commits or a declaration (0020-ifccm FR-0… (476 characters)
type Deps = {
/** Called once with each rule's result where the check judged commits or a declaration (0020-ifccm FR-031), so that the caller can keep it as a record. */
readonly onRules?: (rules: readonly RuleResult[]) => void;
readonly client?: GitHostClient;
/** The repository on the host that the commits belong to; a reference `#N` is asked of it. */
readonly home?: RepoRef;
readonly out?: (text: string) => void;
readonly err?: (text: string) => void;
};
What the command is given besides its arguments: the host's client and the repository it serves, which the command never makes, and where it writes.
RECORD_FILEconstno test imports itconst RECORD_FILE: "ifccm.declaration.ts"
The default name of a harness's record, in the repository's top folder.
BASELINE_FILEconstno test imports itconst BASELINE_FILE: "changes.baseline.txt"
The default name of the baseline of the check's findings, in the repository's top folder.
function run(argv: readonly string[], deps?: Deps, now?: () => string): Promise<number>
Run the command; the exit status (0 clean, 1 findings, 2 usage, 3 environment).
Imported by 26 tests of the run (26 passed, 0 failed): the library's results