LearnNewsExamplesServices
Frontmatter
id11803
titleTier-2 revalidation-trigger mechanism (OQ5 from #11793)
stateClosed
labels
enhancementaiarchitecturemodel-experience
assigneesneo-opus-ada
createdAtMay 23, 2026, 1:32 AM
updatedAtMay 23, 2026, 10:14 AM
githubUrlhttps://github.com/neomjs/neo/issues/11803
authorneo-opus-ada
commentsCount1
parentIssue11796
subIssues[]
subIssuesCompleted0
subIssuesTotal0
blockedBy[]
blocking[]
closedAtMay 23, 2026, 10:14 AM

Tier-2 revalidation-trigger mechanism (OQ5 from #11793)

Closed v13.0.0/archive-v13-0-0-chunk-13 enhancementaiarchitecturemodel-experience
neo-opus-ada
neo-opus-ada commented on May 23, 2026, 1:32 AM

Context

Sub of Epic #11796 (active-peer quorum rule). Covers AC6 — the Tier-2 revalidation mechanism deferred from Discussion #11793 OQ5. The rule (Tier-2 substrate gets a revalidationTrigger when graduating under benched-family liveness gap) is locked in by Epic #11796 AC1; this sub picks + implements the mechanism.

Scope

Design + implement the mechanism that re-opens Tier-2 substrate changes for retroactive signal review when a benched family reactivates.

Option Space (from Discussion #11793 OQ5)

Pick one (or hybrid) and implement:

  • (a) Retroactive-signal posting. When a benched family reactivates (participationStatus flips operator_benchedactive), that family scans Tier-2 graduations that proceeded during their bench and posts retroactive signals (APPROVED / DEFERRED / ABSTAIN) against each. Substrate impact: convention-only — no automated re-opening; depends on reactivated family's discipline.
  • (b) Automated substrate re-open. A sweep-script identifies Tier-2 substrate changes that landed during a bench window + auto-re-opens them for a fresh signal cycle. Substrate impact: high — needs a workflow / scheduler / re-validation issue-state.
  • (c) Sweep-script-notifies-only. A sweep-script identifies Tier-2 graduations during the bench + posts a notification (A2A or issue-comment) to the reactivated family; family then picks up via normal review discipline. Substrate impact: medium — needs the sweep script but no auto-re-open.

Recommended starting hypothesis

Option (c). Reasons:

  • (a) is convention-only — too weak; the substrate doesn't enforce anything; relies on memory.
  • (b) is too strong — auto-re-opening landed substrate can cause churn even when the reactivated family would have approved anyway; high-blast.
  • (c) hits the middle: substrate provides a discoverable notification, but the actual re-validation work is human/peer-judgment-driven.

To be challenged in the implementation discussion.

Prescription (option-c-conditional)

  1. Sweep query: SQL/Memory-Core query that finds graduated Tier-2 issues (label / body marker + Unresolved Liveness entry naming the now-reactivated family) within the bench sincereactivation_date window.
  2. Notification primitive: A2A broadcast OR comment-on-issue OR manage_database write — pick the loudest-but-non-destructive surface. Recommendation: comment on each graduated issue with @<reactivated-family-identity> mention + cross-reference back to the graduation Discussion.
  3. Trigger: Hook into participationStatus transition. Where? Options: (i) a participationStatus-watcher daemon lane (new), (ii) manual npm run script invoked by the operator when the field is updated, (iii) seedAgentIdentities post-transition hook.
  4. AC revalidationTrigger reconciliation: When the reactivated family responds to the notification (APPROVED / DEFERRED / ABSTAIN posted), the graduated artifact's ## Unresolved Liveness entry transitions to "resolved" + the original revalidationTrigger AC is marked complete.

Acceptance Criteria

  • AC1 — Mechanism option chosen (a / b / c / hybrid) with rationale documented in PR + Epic #11796.
  • AC2 — Sweep query (or equivalent) identifies Tier-2 graduations during a bench window deterministically (test against #11796 itself once Gemini reactivates).
  • AC3 — Notification primitive implemented and tested in a dry-run mode.
  • AC4 — Trigger path: participationStatus transition operator_benched/temporarily_unreachableactive invokes the sweep (manually-invoked CLI script acceptable as MVP).
  • AC5 — Documentation: a runbook under learn/agentos/ documenting how to invoke the revalidation sweep when a family reactivates.
  • AC6 — At least one test exercises the sweep against a seeded scenario (Gemini reactivation → #11796 surfaces as needing-revalidation).
  • AC7 — ideation-sandbox-workflow.md §6.5 updated with the chosen mechanism's name + invocation path so future Tier-2 graduations know what to expect.

Out of Scope

  • The §6 rule itself (sibling sub #11799).
  • identityRoots.mjs structured field (sibling sub).
  • Automated participationStatus-watcher daemon (deferred unless explicitly chosen in option-b / hybrid).
  • Multi-family revalidation (only one family-reactivation at a time in MVP).

Sequencing

  • Depends on sibling sub for identityRoots.mjs structured field (need participationStatus to query).
  • Independent of #11799 prose changes; can land in parallel after the structured-field sub.

Related

tobiu referenced in commit c1c5f45 - "feat(agentos): add participationStatus structured field to identityRoots (#11802) (#11810) on May 23, 2026, 2:39 AM
tobiu referenced in commit d462e2e - "feat(skills): family-keyed quorum rule + AUTHOR_SIGNAL signal type (#11799) (#11805) on May 23, 2026, 2:40 AM
tobiu referenced in commit 00f8588 - "feat(skills): family-keyed quorum mirror in pull-request-workflow.md §6.1.1 (#11800) (#11808) on May 23, 2026, 2:50 AM
tobiu referenced in commit 3e86a0a - "feat(agents): mirror family-keyed quorum into §swarm_topology_anchor (#11801) (#11809) on May 23, 2026, 2:50 AM
tobiu referenced in commit f8d54a8 - "feat(agentos): tier-2 revalidation-trigger sweep mechanism (#11803) (#11815) on May 23, 2026, 10:14 AM
tobiu closed this issue on May 23, 2026, 10:14 AM