DGR-022: Define Shard lifecycle and structured status RPCs #6

New Issue

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

popov commented

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

DGR-022: Define Shard lifecycle and structured status RPCs

Status / triage: completed; passes: true
Execution mode: AFK
Milestone: M1
Dependencies: DGR-021
Blocks (derived): DGR-024, DGR-033, DGR-037
Labels: area:protocol, area:lifecycle, type:infrastructure, priority:p0, ready-for-agent
Evidence class: model-free
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/022-define-shard-lifecycle-and-structured-status-rpcs.md, and evidence READMEs for dependencies (DGR-021) before changing code. Inspect live source/tests rather than trusting legacy pass states. Objective: Complete the gRPC contract for worker capability, health, sessions, cancellation, release, and metrics.

Acceptance criteria

Define capability, health, bidirectional session stream, cancellation, release, and metrics RPCs.
Specify deadlines, cancellation propagation, bounded flow control, cache expectations/results, and structured error taxonomy.
Specify TLS/auth hooks without moving Meshnet authentication or billing into the worker.
Add compatibility tests for supported versions and fail-closed tests for unsupported versions and malformed lifecycle transitions.
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

Verified evidence: .scratch/distributed-gguf-runtime/evidence/DGR-022/README.md. Legacy evidence remains provenance only and grants no implementation completion credit.

# DGR-022: Define Shard lifecycle and structured status RPCs - **Status / triage:** completed; `passes: true` - **Execution mode:** `AFK` - **Milestone:** `M1` - **Dependencies:** `DGR-021` - **Blocks (derived):** `DGR-024`, `DGR-033`, `DGR-037` - **Labels:** `area:protocol`, `area:lifecycle`, `type:infrastructure`, `priority:p0`, `ready-for-agent` - **Evidence class:** `model-free` - **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/022-define-shard-lifecycle-and-structured-status-rpcs.md`, and evidence READMEs for dependencies (DGR-021) before changing code. Inspect live source/tests rather than trusting legacy pass states. Objective: Complete the gRPC contract for worker capability, health, sessions, cancellation, release, and metrics. ## Acceptance criteria - [x] Define capability, health, bidirectional session stream, cancellation, release, and metrics RPCs. - [x] Specify deadlines, cancellation propagation, bounded flow control, cache expectations/results, and structured error taxonomy. - [x] Specify TLS/auth hooks without moving Meshnet authentication or billing into the worker. - [x] Add compatibility tests for supported versions and fail-closed tests for unsupported versions and malformed lifecycle transitions. - [x] 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 Verified evidence: `.scratch/distributed-gguf-runtime/evidence/DGR-022/README.md`. Legacy evidence remains provenance only and grants no implementation completion credit.

popov added this to the M1 milestone 2026-07-16 20:36:01 +00:00

popov added the area:lifecycle area:protocol type:infrastructure status:blocked ready-for-agent priority:p0 labels 2026-07-16 20:36:01 +00:00

popov added status:ready and removed status:blocked labels 2026-07-16 23:35:49 +00:00

deploy added status:in-progress and removed status:ready labels 2026-07-17 12:42:29 +00:00

deploy commented

2026-07-17 12:47:54 +00:00

Controller verification complete. Implementation commit 9b257d9 is reachable from consolidated master and the active GGUF branch. Verified PYTHONPATH=packages/node python3 -m pytest -q tests/test_shard_lifecycle.py tests/test_activation_envelope.py → 17 passed; python3 -m compileall -q packages tests and git diff --check passed. Canonical evidence: .scratch/distributed-gguf-runtime/evidence/DGR-022/README.md. Closing as completed.

Controller verification complete. Implementation commit `9b257d9` is reachable from consolidated `master` and the active GGUF branch. Verified `PYTHONPATH=packages/node python3 -m pytest -q tests/test_shard_lifecycle.py tests/test_activation_envelope.py` → **17 passed**; `python3 -m compileall -q packages tests` and `git diff --check` passed. Canonical evidence: `.scratch/distributed-gguf-runtime/evidence/DGR-022/README.md`. Closing as completed.

deploy added status:completed and removed status:in-progress ready-for-agent labels 2026-07-17 12:47:54 +00:00

deploy closed this issue

2026-07-17 12:47:55 +00:00

popov added the ready-for-agent label 2026-07-21 18:54:11 +00:00

Sign in to join this conversation.

2 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: popov/neuron-tai#6