What a program tells Headless about itself (commons headless 0003-headless-output): the mechanisms of the library are configured with the program's own data, never with the library's guesses. Its name and version, the prefix of its environment variables, the name of its folder of state, the catalogue of codes it explains, the patterns of the raw errors it recognizes, where its guides are, which commands its fixes call, its secrets, and its tree. Everything a program keeps for itself (its explanations, its guides, its paths, its prompts) is here as data, and stays its own.
typeProgramConfig= {
readonlyname:string;
readonlysummary:string;
readonlyversion:string;
readonlychildren:readonlyNode[];
/** The prefix of the program's environment variables (`TOOL`): default, its name in capitals. */readonlyenvPrefix?:string;
/** The name of its folder under the system's state folder: default, its name. */readonlystateApp?:string;
/** What its fixes may call. */readonlyfix?:FixCommands;
readonlycatalogue?:Catalogue;
readonlypatterns?:readonlyRawPattern[];
readonlyguide?:GuideLinks;
readonlygeneric?:GenericCodes;
/** The secret values the program holds: redacted wherever they would be written. */readonlysecrets?: () =>readonlystring[];
/** The names of the keys that are secret in this program (`APP_TOKEN`): the value of `KEY=value` is redacted. A sentence that only names a variable is not. */readonlysecretKeys?:readonlystring[];
/** The targets `--on` can name. */readonlytargets?:readonlyTarget[];
/** How a run over targets is bounded: how many at once (4) and how long each may take (30 s). */readonlyremote?: { readonlyconcurrency?:number; readonlyperHostTimeoutMs?:number };
/** The words to run where none are given (`status`); none by default, and the help is shown. */readonlydefaultCommand?:readonlystring[];
/** The tiers of the program, lowest first, and the tier of a caller who says nothing (0010-audience-tiers): the default ladder where none is given. */readonlytiers?:TierLadder;
/** Who contributed each command, by the words of its id (0009-composition): the run log says it. */readonlyorigins?:Readonly<Record<string, string>>;
};
typeProgramConfig= {
readonlyname:string;
readonlysummary:string;
readonlyversion:string;
readonlychildren:readonlyNode[];
/** The prefix of the program's environment variables (`TOOL`): default, its name in capitals. */readonlyenvPrefix?:string;
/** The name of its folder under the system's state folder: default, its name. */readonlystateApp?:string;
/** What its fixes may call. */readonlyfix?:FixCommands;
readonlycatalogue?:Catalogue;
readonlypatterns?:readonlyRawPattern[];
readonlyguide?:GuideLinks;
readonlygeneric?:GenericCodes;
/** The secret values the program holds: redacted wherever they would be written. */readonlysecrets?: () =>readonlystring[];
/** The names of the keys that are secret in this program (`APP_TOKEN`): the value of `KEY=value` is redacted. A sentence that only names a variable is not. */readonlysecretKeys?:readonlystring[];
/** The targets `--on` can name. */readonlytargets?:readonlyTarget[];
/** How a run over targets is bounded: how many at once (4) and how long each may take (30 s). */readonlyremote?: { readonlyconcurrency?:number; readonlyperHostTimeoutMs?:number };
/** The words to run where none are given (`status`); none by default, and the help is shown. */readonlydefaultCommand?:readonlystring[];
/** The tiers of the program, lowest first, and the tier of a caller who says nothing (0010-audience-tiers): the default ladder where none is given. */readonlytiers?:TierLadder;
/** Who contributed each command, by the words of its id (0009-composition): the run log says it. */readonlyorigins?:Readonly<Record<string, string>>;
};