The verbs of Repoctl as facts (commons repoctl 0002-repoctl-governanceFR-002, FR-003; commons headless 0002-headless-governance, 0005-reach-and-targets): each verb is declared once, with what it is (a report or an action), what it may do (read, mutate, destructive), whether repeating it is safe, whether it previews and checks, the tier that may see it and the reach policy that says through which channels it comes and how a destruction is confirmed. The command line, the tool server and the documentation read this one table; a test holds that its facts do not contradict each other.
typeVerbFacts= {
readonlyid:VerbId;
readonlysummary:string;
readonlykind:Kind;
readonlyeffect:Effect;
/** Whether running it again with the same input changes nothing more. */readonlyidempotent:boolean;
/** Whether `--dry-run` previews what it would change. */readonlydryRun:boolean;
/** Whether `--check` ends with findings where it would change something. */readonlycheck:boolean;
/** The lowest tier that sees it. */readonlytier:TierId;
/** The channels it comes through. */readonlychannels:readonlyChannel[];
/** How it is confirmed: a destruction by a person (and, from a tool server, only as a preview). */readonlyconfirmation:ConfirmationClass;
/** The options only a person may give. */readonlyhumanOnly:readonlystring[];
};
typeVerbFacts= {
readonlyid:VerbId;
readonlysummary:string;
readonlykind:Kind;
readonlyeffect:Effect;
/** Whether running it again with the same input changes nothing more. */readonlyidempotent:boolean;
/** Whether `--dry-run` previews what it would change. */readonlydryRun:boolean;
/** Whether `--check` ends with findings where it would change something. */readonlycheck:boolean;
/** The lowest tier that sees it. */readonlytier:TierId;
/** The channels it comes through. */readonlychannels:readonlyChannel[];
/** How it is confirmed: a destruction by a person (and, from a tool server, only as a preview). */readonlyconfirmation:ConfirmationClass;
/** The options only a person may give. */readonlyhumanOnly:readonlystring[];
};