unic / unic/unic-agents-plugins

feat(unic-archon-dlc): a `controls` node in `/build` writes `inert` or `can-fail` per check into `evidence.json`

Open
#489 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app:unic-archon-dlc feature needs-specs p2 wayfinder:grilling
Dominant language
JavaScript
Stars
1
Forks
0
Avg merge
16h 43m
Merged PRs (30d)
19

Description

What

After verification, a node that runs each mechanism check's positive control against the run's own tree in a scratch worktree, records whether the control made the check fail, and writes controls: {<check>: inert | can-fail} into evidence.json. A check with no control, or whose control does not make it fail, is inert, never a pass.

Why

Run 3 ran the four controls for 43021–43024 by hand in a session, one at a time, after the build; 43024 needed three attempts because of the documented ordering (snapshot first, then 43023, then 43024). A hand ritual rots. The register's F5 § 1 already says a mechanism can read green by construction; this is the node that proves, per run, that it did not. Pairs with the Consumer Task that puts each control's design beside its check in checks/README.md (the node reads them from there).

Evidence

Not decided

  • Whether the node reads controls from checks/README.md (prose) or from a controls/ directory of scripts.
  • Whether inert fails evidence_policy or only reports.
  • Which of declaresInteractive's four branches (tabIndex, a[href], role="button", onClick) each need their own control.

Filed 2026-09-17 by wayfinder-orchestrator-10 from run 3's measurements. needs-specs: grill before dispatch.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reviewing the /build verification flow, evidence.json, checks/README.md, and the dispatch record in issue #457. Resolve the listed open design questions before implementation, including the control source, inert policy, and declaresInteractive branches. Done means each mechanism control is run against the scratch worktree and the resulting controls entries are recorded per run.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
build-system, testing-qa
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.