Files
neuron-tai/.scratch/distributed-gguf-runtime/issues/10-pass-local-real-model-two-process-acceptance.md
2026-07-13 15:09:27 +03:00

3.3 KiB

10 — Pass local real-model two-process acceptance

Status: ready-for-agent

Mandatory fresh-session context

  • Read RALPH-CONTEXT.md completely before changing code.
  • This issue is DGR-010 in prd.json.
  • Read the evidence README for every dependency listed below.
  • Inspect current code and git status; historical text and previous agent claims are not evidence.

Description

As a release engineer, I need real local distributed parity before involving network variability.

Expected durable outputs

  • Real local two-process commands and configuration
  • Raw parity, memory and performance results
  • evidence/DGR-010/README.md

Acceptance criteria

  • Two local worker processes open disjoint dense-Llama ranges from the certified Artifact.
  • Prefill and at least 32 greedy decode tokens match whole-model llama.cpp within the certified tolerance.
  • Each worker retains only its own tensors and Hot KV State.
  • Four concurrent Route Sessions pass isolation and cleanup checks.
  • Report TTFT, prefill/decode throughput, seam bytes/latency, worker RSS/VRAM, KV memory, batch size, and queue time.
  • Killing one worker produces a bounded structured failure rather than a deadlock.
  • Targeted pytest tests pass
  • python -m compileall packages tests passes for Python changes
  • git diff --check passes
  • Default tests remain deterministic, model-download-free, API-credit-free, and GPU-free
  • Full deterministic pytest -q passes, or the exact pre-existing unrelated failure is recorded with a clean-tree reproduction
  • Pinned native C++ target builds and focused CTest/protocol tests pass where native code is touched
  • llama.cpp patch stack applies cleanly to the exact pinned commit where patch code is touched
  • Real-model execution is opt-in through MESHNET_ENABLE_REAL_INFERENCE_TESTS=1 and records exact artifact/runtime/hardware evidence
  • Model artifacts remain on the configured mounted-drive storage and never under /home
  • Read .scratch/distributed-gguf-runtime/RALPH-CONTEXT.md and this story issue completely before changing code
  • Read and verify every dependency evidence README before relying on dependency behavior
  • Preserve all pre-existing working-tree changes and stage only files belonging to this story
  • Write .scratch/distributed-gguf-runtime/evidence/DGR-010/README.md with files changed, exact commands and real results, limitations, compatibility notes, and dependent-story handoff
  • Update only this story issue to Status: done after every acceptance criterion and quality gate passes

Dependency handoff

  • DGR-009 must have passes: true; read ../evidence/DGR-009/README.md and verify its referenced files/commands.

Finish contract

  • Create the task evidence directory and durable handoff required above.
  • Preserve real failures and blockers; never fabricate benchmark, model, test or hardware output.
  • Change this issue to Status: done only after all criteria pass.
  • Emit <promise>COMPLETE</promise> only after the evidence handoff exists.

References