One run of the collector, with no person: it takes the lock (a second run does not wait), looks at the assets that are due with at most a few at once and a time limit each, keeps the state of an asset on the branch only where it differs from the one kept, journals each look as the policy says in a hash-chained entry, makes a commit when a state changed or the journal's batch interval has run (the entries not yet committed wait in a file of the run's own), and pushes the branch as the policy says, never forcing; a push that fails is an entry of the journal and is tried again by the next run.
typeCollectInput= {
readonlystore:GitRefStore;
readonlypolicy:CapturePolicy;
readonlyassets:readonlyObserved[];
readonlyobserve:Observer;
/** The instant of the run (ISO 8601). */readonlynow:string;
/** The folder of the run's own memory (outside the tracked files: the repository's `.git/opsfolio-evidence`). */readonlyruntime:string;
/** How many assets are looked at at once and how long each may take (8 and 15 seconds by default). */readonlylimits?:FanOutLimits;
/** Look at these assets only, whether or not they are due. */readonlyonly?:readonlystring[];
};
typeCollected= {
readonlyassets:readonly { readonlyid:string; readonlyoutcome:AssetOutcome; readonlyjournaled:boolean }[];
/** The commit made, where one was. */readonlycommit:string|undefined;
/** The entries of the journal waiting for the next commit. */readonlypending:number;
readonlypushed:"not-asked"|"pushed"|"failed"|"not-due";
};
typeCollectInput= {
readonlystore:GitRefStore;
readonlypolicy:CapturePolicy;
readonlyassets:readonlyObserved[];
readonlyobserve:Observer;
/** The instant of the run (ISO 8601). */readonlynow:string;
/** The folder of the run's own memory (outside the tracked files: the repository's `.git/opsfolio-evidence`). */readonlyruntime:string;
/** How many assets are looked at at once and how long each may take (8 and 15 seconds by default). */readonlylimits?:FanOutLimits;
/** Look at these assets only, whether or not they are due. */readonlyonly?:readonlystring[];
};
typeCollected= {
readonlyassets:readonly { readonlyid:string; readonlyoutcome:AssetOutcome; readonlyjournaled:boolean }[];
/** The commit made, where one was. */readonlycommit:string|undefined;
/** The entries of the journal waiting for the next commit. */readonlypending:number;
readonlypushed:"not-asked"|"pushed"|"failed"|"not-due";
};
What a run did.
Imported by 7 tests of the run (6 passed, 1 failed): a state is kept only where it changed, every look is journaled, commits come whe. the library's results
The whole journal of the branch at a revision, read in order and verified: its entries, or the first entry that does not follow.
Imported by 11 tests of the run (10 passed, 1 failed): a state is kept only where it changed, every look is journaled, commits come whe. the library's results
One run of the collector; an error where another run holds the lock or the branch moved while it committed.
Imported by 19 tests of the run (18 passed, 1 failed): a state is kept only where it changed, every look is journaled, commits come whe. the library's results