DGR-033: Build a standalone fake C++ gRPC Shard worker #17

New Issue

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

popov commented

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

DGR-033: Build a standalone fake C++ gRPC Shard worker

Status / triage: specification only; ready-for-agent; passes: false
Execution mode: AFK
Milestone: M1
Dependencies: DGR-022, DGR-024, DGR-032
Blocks (derived): DGR-036, DGR-040
Labels: area:worker, area:grpc, type:vertical-slice, priority:p0, ready-for-agent
Evidence class: fixture
Hardware: none
Model: fake
Upstream: no

Objective / description

Fresh Ralph session: read .scratch/distributed-gguf-runtime/RALPH-CONTEXT.md, source issue .scratch/distributed-gguf-runtime/issues/033-build-a-standalone-fake-c-grpc-shard-worker.md, and evidence READMEs for dependencies (DGR-022, DGR-024, DGR-032) before changing code. Inspect live source/tests rather than trusting legacy pass states. Objective: Prove the standalone worker process, stream, lifecycle, and supervision shape before llama.cpp integration.

Acceptance criteria

A standalone C++ executable serves the complete lifecycle and stream RPC contract using the fake engine.
Python integration tests cover startup, health, capability, fragmented prefill, decode, release, cancellation, and graceful shutdown.
Bounded messages, deadlines, flow control, and independent session cancellation are enforced.
The worker exposes neither llama.cpp RPC nor arbitrary graph execution.
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-033/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-033: Build a standalone fake C++ gRPC Shard worker - **Status / triage:** specification only; `ready-for-agent`; `passes: false` - **Execution mode:** `AFK` - **Milestone:** `M1` - **Dependencies:** `DGR-022`, `DGR-024`, `DGR-032` - **Blocks (derived):** `DGR-036`, `DGR-040` - **Labels:** `area:worker`, `area:grpc`, `type:vertical-slice`, `priority:p0`, `ready-for-agent` - **Evidence class:** `fixture` - **Hardware:** `none` - **Model:** `fake` - **Upstream:** `no` ## Objective / description Fresh Ralph session: read `.scratch/distributed-gguf-runtime/RALPH-CONTEXT.md`, source issue `.scratch/distributed-gguf-runtime/issues/033-build-a-standalone-fake-c-grpc-shard-worker.md`, and evidence READMEs for dependencies (DGR-022, DGR-024, DGR-032) before changing code. Inspect live source/tests rather than trusting legacy pass states. Objective: Prove the standalone worker process, stream, lifecycle, and supervision shape before llama.cpp integration. ## Acceptance criteria - [ ] A standalone C++ executable serves the complete lifecycle and stream RPC contract using the fake engine. - [ ] Python integration tests cover startup, health, capability, fragmented prefill, decode, release, cancellation, and graceful shutdown. - [ ] Bounded messages, deadlines, flow control, and independent session cancellation are enforced. - [ ] The worker exposes neither llama.cpp RPC nor arbitrary graph execution. - [ ] 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-033/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 M1 milestone 2026-07-16 20:36:03 +00:00

popov added the area:worker area:grpc type:vertical-slice ready-for-agent priority:p0 status:blocked labels 2026-07-16 20:36:03 +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#17