DGR-037: Bind llama.cpp to the standalone worker #21

New Issue

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

popov commented

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

DGR-037: Bind llama.cpp to the standalone worker

Status / triage: specification only; ready-for-agent; passes: false
Execution mode: AFK
Milestone: M2
Dependencies: DGR-022, DGR-023, DGR-031, DGR-034, DGR-035
Blocks (derived): DGR-038, DGR-039, DGR-040, DGR-051
Labels: area:worker, area:llama, type:vertical-slice, priority:p0, ready-for-agent
Evidence class: real-model
Hardware: optional
Model: dense-llama
Upstream: yes

Objective / description

Fresh Ralph session: read .scratch/distributed-gguf-runtime/RALPH-CONTEXT.md, source issue .scratch/distributed-gguf-runtime/issues/037-bind-llama-cpp-to-the-standalone-worker.md, and evidence READMEs for dependencies (DGR-022, DGR-023, DGR-031, DGR-034, DGR-035) before changing code. Inspect live source/tests rather than trusting legacy pass states. Objective: Replace the fake engine with the pinned llama.cpp ShardEngine implementation without changing the public worker contract.

Acceptance criteria

Worker loads exactly one artifact/recipe/range identity and rejects mismatched stream requests.
All execution passes through ShardEngine; llama.cpp implementation types remain private.
Health and metrics expose loaded identity, authoritative ownership, memory, and execution state.
Graceful shutdown releases model/session resources; injected process death is observable and bounded.
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-037/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-037: Bind llama.cpp to the standalone worker - **Status / triage:** specification only; `ready-for-agent`; `passes: false` - **Execution mode:** `AFK` - **Milestone:** `M2` - **Dependencies:** `DGR-022`, `DGR-023`, `DGR-031`, `DGR-034`, `DGR-035` - **Blocks (derived):** `DGR-038`, `DGR-039`, `DGR-040`, `DGR-051` - **Labels:** `area:worker`, `area:llama`, `type:vertical-slice`, `priority:p0`, `ready-for-agent` - **Evidence class:** `real-model` - **Hardware:** `optional` - **Model:** `dense-llama` - **Upstream:** `yes` ## Objective / description Fresh Ralph session: read `.scratch/distributed-gguf-runtime/RALPH-CONTEXT.md`, source issue `.scratch/distributed-gguf-runtime/issues/037-bind-llama-cpp-to-the-standalone-worker.md`, and evidence READMEs for dependencies (DGR-022, DGR-023, DGR-031, DGR-034, DGR-035) before changing code. Inspect live source/tests rather than trusting legacy pass states. Objective: Replace the fake engine with the pinned llama.cpp `ShardEngine` implementation without changing the public worker contract. ## Acceptance criteria - [ ] Worker loads exactly one artifact/recipe/range identity and rejects mismatched stream requests. - [ ] All execution passes through `ShardEngine`; llama.cpp implementation types remain private. - [ ] Health and metrics expose loaded identity, authoritative ownership, memory, and execution state. - [ ] Graceful shutdown releases model/session resources; injected process death is observable and bounded. - [ ] 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-037/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:03 +00:00

popov added the area:worker type:vertical-slice area:llama 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#21