Skip to content

I4009 — /watchdog reads liveness and runs wake, handover, reap

/watchdog: the session-side verb that reads the liveness signals of I3990-I3994 (suspended claims, phase beats, overdue) and runs wake, then handover, then reap; reap only by the owner or a seat and only after assess-before-deleting.

BLOCKED wave 4 · p1 · implementation profile · runs alone

Part of a-session-proceeds-through-the-mesh — A session proceeds through the mesh: it finds the work, claims it once, runs it watched and stops when the intent is met.

Blocked. This issue cannot start until I4005 is done. The status is derived from that, not declared.

Objective

/watchdog: the session-side verb that reads the liveness signals of I3990-I3994 (suspended claims, phase beats, overdue) and runs wake, then handover, then reap; reap only by the owner or a seat and only after assess-before-deleting.

Why

A stuck, silent or dead loop is found by a person; nothing wakes it, hands its work over or reaps what it left.

Current state

Not built: this issue is planned by the milestone a-session-proceeds-through-the-mesh and nothing of it exists.

Desired state

The acceptance criteria below hold and case 4009 proves them.

Scope

  • apps/majordomus-cli/src/capability/builtin
  • share/skills
  • docs/PROCEED.md
  • test/cases/4009_watchdog_wakes_hands_over_and_reaps.sh
  • .ai/repo/project/issues/I4009.yaml

Dependencies

Acceptance criteria

  • A suspended claim, a missed phase beat or an overdue deadline is signalled with its claim, holder and phase
  • Wake precedes handover precedes reap, and each is recorded
  • Reap by anyone but the owner or a seat is refused (ADR 0200), and only after assess-before-deleting
  • It depends on the liveness substrate I3990-I3994 (branch feature/a-claim-lives-by-its-holders-progress); this issue adds none of it

Validation

  • env -u MAJORDOMUS_SHARE -u MAJORDOMUS_HTTP_HOST -u MJ_ROOT bash test/run.sh 4009_watchdog_wakes_hands_over_and_reaps

Evidence required

  • case_4009_watchdog_wakes_hands_over_and_reaps

Evidence

None recorded. Every token above needs a command or an artifact behind it before this issue can be completed; narrative is refused.

Timeline

started
—
verified
—
completed
—

Those three fields, the evidence above and the state of the dependencies are all the status is made of. There is no status field to disagree with them.

Canonical record: .ai/repo/project/issues/I4009.yaml. Read it back with majordomus plan show I4009.

Searches the titles and descriptions of every page this site publishes.