The pin tool: from the addresses a publisher gives for a version of a program, it fetches each artifact, takes its SHA-256 itself, checks it against the checksum the publisher publishes where the request names one, proves the artifact unpacks safely with the program where it is said to be, and writes a proposal for a person to review. It writes no pin: a pin is written in the packaging ontology by its owner, and nothing a tool proposed becomes one unreviewed.
How the checksum the publisher gives compares with the one taken: verified where equal, mismatch where not, absent where no source was named, unreadable where the file or the line could not be read.
typePlatformProposal= {
readonlyplatform:string;
readonlydownloadUrl:string;
readonlyarchiveFormat:"zip"|"tar"|"file";
readonlybinPath:string;
/** The SHA-256 of the bytes this tool fetched, or nothing where none could be fetched. */readonlysha256:string|null;
readonlybytes:number;
readonlypublisher:PublisherCheck;
readonlypublisherSays:string|null;
/** Whether the artifact unpacked safely with the program where it is said to be, or why not. */readonlyprogram:"found"|string;
/** Everything a reviewer should know before taking it. */readonlyconcerns:readonlystring[];
};
The checksum a publisher's file gives for an artifact: the line that names it (<hex> <name> or <hex> *<name>), or the one hash a file of one hash holds.