LearnNewsExamplesServices
Frontmatter
id15161
titleEnable metric-gated community-steward wake leases
stateOpen
labels
enhancementno auto closeaiarchitecture
assignees[]
createdAt7:32 AM
updatedAt8:29 AM
githubUrlhttps://github.com/neomjs/neo/issues/15161
authorneo-gpt
commentsCount0
parentIssue15145
subIssues[]
subIssuesCompleted0
subIssuesTotal0
contentTrust
projected
quarantined0
signals[]
blockedBy[ ] 15160 Calibrate community policy from measured evidence, [ ] 15159 Project bounded tenant community-attention counts
blocking[]
milestonev13.2

Enable metric-gated community-steward wake leases

Open Backlog/active-chunk-6 enhancementno auto closeaiarchitecture
neo-gpt
neo-gpt commented on 7:32 AM

Context

This conditional child preserves staged option J now so no later agent invents wake behavior from the Epic body. It is deliberately not code-ready until the calibration leaf supplies acceptable thresholds; if evidence rejects activation, it closes not planned with that evidence.

This is one fully closeable PR leaf under Epic #15145. The live parent-child and blocked-by graph is authoritative; this body owns only this leaf's contract.

The Problem

All-resident wake duplicates rare signals and can leak tenant activity; a permanent steward can leave the institution deaf when vacant. A lease without measured TTL/amplification bounds becomes hidden assignment and wake-storm authority.

The Architectural Reality

Wake coordination belongs in the existing Orchestrator/wake lifecycle substrate, consuming the count-only projection and canonical claim state. The lease is tenant-scoped attention routing, never ownership. It must not use the global Neo maintainer roster in external deployments.

The Agent OS structure map was run on 2026-07-14. New service/script/test placement must use the named sibling-file-lift fast paths; no service logic moves into MCP server entrypoint directories.

The Fix

Only after calibration approval, implement a tenant/source-scoped TTL-bound steward lease, coalesced count-only wake, measured vacancy fallback, explicit expiry/reclaim, and amplification caps. Keep prose, ranking, assignment, and cross-tenant fallback out of the path.

Contract Ledger Matrix

Target Surface Source of Authority Proposed Behavior Fallback / Edge Case Docs Evidence
Steward lease OQ7 J-stage2 Tenant-scoped TTL lease routes attention without assigning work Vacancy/expiry follows measured fallback Runbook Contention/expiry tests
Coalesced wake Calibration evidence Count-only bounded wake under measured amplification cap Degraded/missing count suppresses enrichment, not policy Wake docs Amplification and failure tests
Activation gate OQ10 No implementation/enablement before calibration result Rejected evidence closes not planned Issue/ADR link Review verifies cited report

Decision Record impact

Depends on ADR 0036, count-only projection, and the calibration decision; composes ADR 0035 without adding ranking authority.

Decision Record

Required: ADR 0036. This leaf is not code-ready until the ADR-0036 child of #15145 is accepted at the human merge gate.

Discussion Criteria Mapping

Upstream graduated criterion This leaf's executable contract
OQ7 Implements only the second, leased-wake stage of J.
OQ8 Tenant/source scoped, metadata/count-only, no roster or prose leakage.
OQ10 STEP_BACK Every lease, vacancy, coalescing, and wake threshold cites measured evidence.

Source authority: Discussion #15139 body at the version-bound graduation anchor plus Grace's STEP_BACK and GRADUATION_APPROVED.

Acceptance Criteria

  • AC1 — The calibration artifact explicitly authorizes activation and supplies every numeric threshold.
  • AC2 — Lease identity, tenant/source scope, TTL, expiry, reclaim, and contention semantics are explicit.
  • AC3 — Wake payload is count-only and bounded; it contains no title/body/excerpt/ranking/assignment.
  • AC4 — The lease routes attention only; canonical Task claim remains the sole ownership transition.
  • AC5 — Vacancy fallback is measured, bounded, and cannot become all-resident broadcast.
  • AC6 — No global Neo roster or cross-tenant fallback is used.
  • AC7 — Contention, expiry, stale holder, vacancy, amplification cap, degraded counts, and tenant isolation tests pass.
  • AC8 — If activation evidence is negative or insufficient, close this issue as not planned with the calibration citation instead of shipping guessed behavior.

Out of Scope

Automatic assignment/response, prose delivery, Fleet control, global steward roster, unmeasured thresholds, or a new wake transport.

Avoided Traps

Do not interpret the existence of this ticket as activation authority, invent TTLs, broadcast to all residents, or let leases create Tasks.

Related

Origin Session ID: 837ad74b-c2d2-413d-9aab-b7165a93a82a

Handoff Retrieval Hints

  • community steward lease coalesced count wake metric gated
  • Discussion 15139 J staged wake

Creation Freshness

Creation duplicate sweep: immediately before filing at 2026-07-14T05:32:08.335Z, checked the latest 20 open issues and last 30 all-state A2A messages. The independent broader audit at 2026-07-14T05:13:00Z covered open and closed issues, pull requests, A2A, ADRs, and code; no equivalent owner or foreign claim existed.