A harness's declaration for the changes check (commons 0020-ifccmFR-010 to FR-013, FR-019, FR-020): the regulated domains it claims (ifccm:RegulatedDomain) and the day it declares production, the phase that follows (warn before the day, gate from it), the Decisions that authorize departures, and the judgement that a declaration was relaxed in Git history.
Pure: the day it is judged on, the earlier versions of the declaration and the Decisions are arguments. The record a harness writes is a TypeScript file of object literals (export const declaration = { ... }, export const decisions = [ ... ], export const roles = { ... }) read as data and never run, so that an earlier version from Git reads the same way as the present one (kernel/ts-literal.ts). The names of the regulated domains are the keys of ifccm:RegulatedDomain; a test holds the two lists equal.
Whether a Decision covers a thing (a requirement, gate-relaxed <revision> or no-issue <revision>): a covered revision may be named by a prefix of at least 7 characters.
The record of a harness read from the text of its file (export const declaration = ..., and optionally decisions and roles). A file with no declaration is a harness that declares nothing (not regulated, not in production), which is not an error (0020-ifccmFR-010).
The entries of a Decision that exempt a commit (no-issue ...): each with its revision where it is well formed (no-issue and 7 to 64 lowercase hexadecimal characters), none where it is not.
What is wrong with a Decision that exempts a commit (0020-ifccmFR-046), as sentences; none for a Decision that covers no no-issue entry or one whose entries, person, day and reason are all sound. The person is approvedBy: it MUST name someone, and MUST NOT be a role of roles, because a role is not a person.
The relaxations in a history of a declaration, oldest version first (0020-ifccmFR-012): a production day that had passed on the day of the change and was moved later or removed, and a regulated domain dropped.
The rungs of the ladder that a declaration requires on today beyond the rungs every harness has (0020-ifccmFR-013, 0016-ladderFR-011): rungs 9 and 10 from the day a harness that claims a regulated domain declares production, and none before it or for a harness that claims none.
type DecisionRecord = {
readonly id: string;
/** The role that approved it (0020-ifccm FR-019). */
readonly approv…(747 characters)
typeDecisionRecord= {
readonlyid:string;
/** The role that approved it (0020-ifccm FR-019). */readonlyapprovedBy:string;
/** What it authorizes: requirements as `NNNN-slug FR-nnn` for a departure, `gate-relaxed <revision>` for a relaxed declaration, or `no-issue <revision>` for the one commit the owner exempts from naming a change request. */readonlycovers:readonlystring[];
/** Why it was made; a Decision that covers `no-issue <revision>` MUST state it. */readonlyreason?:string;
/** The day it was made, `YYYY-MM-DD`; a Decision that covers `no-issue <revision>` MUST state it. */readonlydecidedOn?:string;
/** The change request that records it (`mz:record`), by number. */readonlyrecord?:number;
};
A Decision (mz:Decision) as the check reads it: who approved it, what it authorizes, and the issue that records it where there is one.
type Declaration = {
readonly regulatedDomains: readonly RegulatedDomainName[];
/** The day it declares production; …(568 characters)
typeDeclaration= {
readonlyregulatedDomains:readonlyRegulatedDomainName[];
/** The day it declares production; absent where it declares none. */readonlyproductionDeclaredOn?:Day;
/** How long the harness keeps its evidence on the `quality` branch, in days (0021-ifqs FR-047); absent where it states none. */readonlyretentionDays?:RetentionDays;
/** The evidence tier the harness releases on, the least tier a regulated harness may release at (0026-works-versioning FR-026); absent where it names none. */readonlyreleaseTier?:ReleaseTier;
};
A harness's declaration (ifccm:HarnessDeclaration).
One version of a declaration file in Git: the revision that wrote it, the day of that commit, and the declaration then (undefined where the file was absent or declared nothing).
Whether a Decision covers a thing (a requirement, gate-relaxed <revision> or no-issue <revision>): a covered revision may be named by a prefix of at least 7 characters.
The record of a harness read from the text of its file (export const declaration = ..., and optionally decisions and roles). A file with no declaration is a harness that declares nothing (not regulated, not in production), which is not an error (0020-ifccmFR-010).
The entries of a Decision that exempt a commit (no-issue ...): each with its revision where it is well formed (no-issue and 7 to 64 lowercase hexadecimal characters), none where it is not.
What is wrong with a Decision that exempts a commit (0020-ifccmFR-046), as sentences; none for a Decision that covers no no-issue entry or one whose entries, person, day and reason are all sound. The person is approvedBy: it MUST name someone, and MUST NOT be a role of roles, because a role is not a person.
The relaxations in a history of a declaration, oldest version first (0020-ifccmFR-012): a production day that had passed on the day of the change and was moved later or removed, and a regulated domain dropped.
The rungs of the ladder that a declaration requires on today beyond the rungs every harness has (0020-ifccmFR-013, 0016-ladderFR-011): rungs 9 and 10 from the day a harness that claims a regulated domain declares production, and none before it or for a harness that claims none.
type DecisionRecord = {
readonly id: string;
/** The role that approved it (0020-ifccm FR-019). */
readonly approv…(747 characters)
typeDecisionRecord= {
readonlyid:string;
/** The role that approved it (0020-ifccm FR-019). */readonlyapprovedBy:string;
/** What it authorizes: requirements as `NNNN-slug FR-nnn` for a departure, `gate-relaxed <revision>` for a relaxed declaration, or `no-issue <revision>` for the one commit the owner exempts from naming a change request. */readonlycovers:readonlystring[];
/** Why it was made; a Decision that covers `no-issue <revision>` MUST state it. */readonlyreason?:string;
/** The day it was made, `YYYY-MM-DD`; a Decision that covers `no-issue <revision>` MUST state it. */readonlydecidedOn?:string;
/** The change request that records it (`mz:record`), by number. */readonlyrecord?:number;
};
A Decision (mz:Decision) as the check reads it: who approved it, what it authorizes, and the issue that records it where there is one.
type Declaration = {
readonly regulatedDomains: readonly RegulatedDomainName[];
/** The day it declares production; …(568 characters)
typeDeclaration= {
readonlyregulatedDomains:readonlyRegulatedDomainName[];
/** The day it declares production; absent where it declares none. */readonlyproductionDeclaredOn?:Day;
/** How long the harness keeps its evidence on the `quality` branch, in days (0021-ifqs FR-047); absent where it states none. */readonlyretentionDays?:RetentionDays;
/** The evidence tier the harness releases on, the least tier a regulated harness may release at (0026-works-versioning FR-026); absent where it names none. */readonlyreleaseTier?:ReleaseTier;
};
A harness's declaration (ifccm:HarnessDeclaration).
One version of a declaration file in Git: the revision that wrote it, the day of that commit, and the declaration then (undefined where the file was absent or declared nothing).
The word a Decision's covers entry starts with when it waives the signed-commit rule for a bot account that signs through the host: signing-waiver <account> <key> (ergonex 0002-workspace-modelFR-049, which reads the entries this module decodes).
type SigningWaiver = {
/** The Decision that names the account and the key. */
readonly decision: string;
/** The …(460 characters)
typeSigningWaiver= {
/** The Decision that names the account and the key. */readonlydecision:string;
/** The role that approved it (0020-ifccm FR-019). */readonlyapprovedBy:string;
/** The account that signs, as its commits' committer address is written: `noreply@github.com` for GitHub's own. */readonlyaccount:string;
/** The key, by its fingerprint or its key id, as Git reports it for a signed commit. */readonlykey:string;
};
A waiver of the signed-commit rule for one account and one key, with the Decision that authorizes it.
The waivers of the signed-commit rule that the Decisions of a harness record make (ergonex 0002-workspace-modelFR-049, which reads the entries this module decodes): each entry of a Decision's covers written signing-waiver <account> <key>. An entry that names no account or no key waives nothing, and a Decision that says only signing-waiver or names the account alone waives no one.