DGR-040: Add node-side native worker supervision #24

New Issue

popov · 2026-07-16T20:36:04Z

popov commented

2026-07-16 20:36:04 +00:00

DGR-040: Add node-side native worker supervision

Status / triage: specification only; ready-for-agent; passes: false
Execution mode: AFK
Milestone: M2
Dependencies: DGR-033, DGR-037
Blocks (derived): DGR-041, DGR-042, DGR-055, DGR-058
Labels: area:node, area:supervision, type:integration, priority:p0, ready-for-agent
Evidence class: fixture
Hardware: none
Model: generic
Upstream: no

Objective / description

Fresh Ralph session: read .scratch/distributed-gguf-runtime/RALPH-CONTEXT.md, source issue .scratch/distributed-gguf-runtime/issues/040-add-node-side-native-worker-supervision.md, and evidence READMEs for dependencies (DGR-033, DGR-037) before changing code. Inspect live source/tests rather than trusting legacy pass states. Objective: Let the existing node service safely start, probe, stop, and restart the standalone worker.

Acceptance criteria

Supervision owns process startup, readiness, log capture, graceful shutdown, and bounded forced termination.
Startup verifies worker binary, artifact identity, recipe, and range before registration.
Crashes or health loss make the capability unavailable without corrupting the Transformers backend.
Tests use the fake worker and deterministic crash injection.
Applicable shared quality gates in prd.json pass, and the evidence handoff records exact commands/results, changed files, limitations, and dependency handoff.

Shared quality gates

Targeted deterministic tests pass; Python changes also pass python -m compileall packages tests.
git diff --check passes.
Default tests are model-download-free, API-credit-free, and GPU-free.
Evidence README records exact changed files, commands/results, limitations, and dependency handoff; no fabricated evidence or inherited completion credit.

Evidence handoff

Write and verify .scratch/distributed-gguf-runtime/evidence/DGR-040/README.md. Until every criterion and applicable gate has real evidence, this story remains passes: false. Legacy evidence is provenance only, not completion credit.

# DGR-040: Add node-side native worker supervision - **Status / triage:** specification only; `ready-for-agent`; `passes: false` - **Execution mode:** `AFK` - **Milestone:** `M2` - **Dependencies:** `DGR-033`, `DGR-037` - **Blocks (derived):** `DGR-041`, `DGR-042`, `DGR-055`, `DGR-058` - **Labels:** `area:node`, `area:supervision`, `type:integration`, `priority:p0`, `ready-for-agent` - **Evidence class:** `fixture` - **Hardware:** `none` - **Model:** `generic` - **Upstream:** `no` ## Objective / description Fresh Ralph session: read `.scratch/distributed-gguf-runtime/RALPH-CONTEXT.md`, source issue `.scratch/distributed-gguf-runtime/issues/040-add-node-side-native-worker-supervision.md`, and evidence READMEs for dependencies (DGR-033, DGR-037) before changing code. Inspect live source/tests rather than trusting legacy pass states. Objective: Let the existing node service safely start, probe, stop, and restart the standalone worker. ## Acceptance criteria - [ ] Supervision owns process startup, readiness, log capture, graceful shutdown, and bounded forced termination. - [ ] Startup verifies worker binary, artifact identity, recipe, and range before registration. - [ ] Crashes or health loss make the capability unavailable without corrupting the Transformers backend. - [ ] Tests use the fake worker and deterministic crash injection. - [ ] Applicable shared quality gates in `prd.json` pass, and the evidence handoff records exact commands/results, changed files, limitations, and dependency handoff. ## Shared quality gates - Targeted deterministic tests pass; Python changes also pass `python -m compileall packages tests`. - `git diff --check` passes. - Default tests are model-download-free, API-credit-free, and GPU-free. - Evidence README records exact changed files, commands/results, limitations, and dependency handoff; no fabricated evidence or inherited completion credit. ## Evidence handoff Write and verify `.scratch/distributed-gguf-runtime/evidence/DGR-040/README.md`. Until every criterion and applicable gate has real evidence, this story remains `passes: false`. Legacy evidence is provenance only, not completion credit.

popov added this to the M2 milestone 2026-07-16 20:36:04 +00:00

popov added the area:node area:supervision type:integration ready-for-agent priority:p0 status:blocked labels 2026-07-16 20:36:04 +00:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: popov/neuron-tai#24