Guard extension contract and the weakest-link decision #1986
Notifications
Due Date
No due date set.
Blocks
Reference: sam/archie#1986
Reference in new issue
Block a user
Guards are extensions. Each judges one concrete action and returns a verdict: a ceiling on the five-level scale, findings with evidence, the strength of the evidence, and blind spots. The action runs at the lowest ceiling; a sequence takes the lowest level of its actions. A guard with no concern returns act quietly. A guard that fails, times out, answers partially or lacks its evidence sets propose and wait, unless it is advisory: an advisory guard's verdict is recorded and sets no ceiling. Every verdict is recorded with the decision.
Done when: two guards judge the same action and the lower ceiling wins; a failing guard holds the action; an advisory guard's verdict is recorded without affecting the level.
Spec: section 5, decision tree 8.3, R22.
From the 2026-11-16 module review. Before the first guard lands:
modules/runs/investigate.go(offered); that filter becomes a class default, not the gate.modules/connectors. Connectors keep the contract's effect declaration; a guard must not import connectors to learn what an action is.Done (archie-core
55077620b, archipelago 40121f6): proto/guard/v1 contract; guards are accepted packages (PUT/DELETE /api/guards/{name}) judged in parallel with the built-in guards under a host-enforced deadline; the lowest ceiling wins, a failing, timed-out or ceiling-less guard holds at propose and wait unless advisory, and every verdict records the package name, version and digest. Table test covers each rule through the extension path. Example guard: archipelago guards/business-hours.