story: DGR-043 Expose GGUF compatibility and measured cost inputs to existing routing
This commit is contained in:
69
.scratch/distributed-gguf-runtime/evidence/DGR-043/README.md
Normal file
69
.scratch/distributed-gguf-runtime/evidence/DGR-043/README.md
Normal file
@@ -0,0 +1,69 @@
|
||||
# DGR-043 evidence — GGUF inputs through existing tracker routing
|
||||
|
||||
**Date:** 2026-08-01
|
||||
**Authority:** `.scratch/distributed-gguf-runtime/prd.json` (`passes` remains
|
||||
`false`; this is model-free integration evidence, not a hardware certification).
|
||||
|
||||
## Implemented
|
||||
|
||||
- Added optional backend-neutral `RoutingMeasurements` to the existing capability report. It carries measured tokens/second, queue depth, seam latency, health, and reliability; reports that omit it retain their exact previous serialized shape.
|
||||
- Extended the tracker’s existing sanitized `CapabilityState` and network-map capability view to retain the routing measurements with exact recipe, artifact/runtime fingerprint, half-open-range-derived coverage, capacity, backend, and certification facts.
|
||||
- `NativeShardRegistration` now accepts this generic measurement block and adapts throughput and queue depth to the existing registration/heartbeat scoring inputs. The tracker continues to apply its established queue-adjusted throughput selection; no GGUF routing, balancing, billing, relay, provider, quantization, topology, or architecture branch was added.
|
||||
- Added deterministic coverage tests showing that existing route formation excludes a dark candidate, forms a complete route only from matching exact fingerprints, and rejects a range otherwise covered only by a mismatched recipe.
|
||||
|
||||
## Changed files
|
||||
|
||||
- `packages/node/meshnet_node/capability.py`
|
||||
- `packages/node/meshnet_node/native_registration.py`
|
||||
- `packages/tracker/meshnet_tracker/capability.py`
|
||||
- `packages/tracker/meshnet_tracker/server.py`
|
||||
- `tests/test_native_registration.py`
|
||||
- `.scratch/distributed-gguf-runtime/evidence/DGR-043/README.md`
|
||||
- `.ralph-tui/progress.md`
|
||||
|
||||
## Commands and results
|
||||
|
||||
```bash
|
||||
PYTHONPATH=packages/node:packages/tracker /home/popov/.hermes/hermes-agent/venv/bin/python -m pytest -q \
|
||||
tests/test_native_registration.py tests/test_node_capability.py \
|
||||
tests/test_runtime_recipe_identity.py
|
||||
```
|
||||
```text
|
||||
96 passed in 0.23s
|
||||
```
|
||||
|
||||
```bash
|
||||
PYTHONPATH=packages/node:packages/tracker /home/popov/.hermes/hermes-agent/venv/bin/python -m pytest -q \
|
||||
tests/test_dgr_performance_contract.py tests/test_native_activation_seam.py \
|
||||
tests/test_native_worker_supervisor.py tests/test_native_registration.py \
|
||||
tests/test_ralph_prd_schema.py
|
||||
```
|
||||
```text
|
||||
151 passed in 1.78s
|
||||
```
|
||||
|
||||
```bash
|
||||
/home/popov/.hermes/hermes-agent/venv/bin/python -m ruff check \
|
||||
packages/node/meshnet_node/capability.py \
|
||||
packages/node/meshnet_node/native_registration.py \
|
||||
packages/tracker/meshnet_tracker/capability.py \
|
||||
packages/tracker/meshnet_tracker/server.py tests/test_native_registration.py
|
||||
python3 -m compileall -q packages tests
|
||||
git diff --check
|
||||
```
|
||||
```text
|
||||
All checks passed; both remaining commands exited 0.
|
||||
```
|
||||
|
||||
Default tests were model-download-free, API-credit-free, and GPU-free. No native source, protobuf, patch, model artifact, or mounted-drive content was changed; therefore native CMake/CTest, patch-stack, and real-hardware gates do not apply to this Python-only adapter.
|
||||
|
||||
## Limitations
|
||||
|
||||
- The full HTTP tracker/admission and tracker-routing suites cannot bind an AF_INET listener in this sandbox. The attempted focused suite had 132 passes and 14 failures, all `PermissionError: [Errno 1] Operation not permitted` during socket creation. Model-free direct tracker parsing and route-formation tests cover this change; HTTP/billing/relay regression suites must be rerun in an environment that permits localhost sockets.
|
||||
- Measurements are inputs, not self-certification. An exact native recipe remains `dark` until the existing tracker-owned certification ledger admits it, and worker health loss continues to withdraw the native capability.
|
||||
- Seam latency is retained as a measured tracker capability input. Existing route latency learning remains the tracker-owned mechanism for end-to-end seam cost; this story intentionally does not alter its scoring algorithm.
|
||||
|
||||
## Dependency handoff
|
||||
|
||||
- **DGR-041:** `NativeShardRegistration`, `ExecutionCapacity`, exact `ShardIdentity`, and the tracker certification ledger remain the only registration/admission path. Supply `RoutingMeasurements` from verified worker/telemetry observations; do not infer values from backend names, quantization labels, architecture, or stage topology.
|
||||
- **DGR-053/DGR-061:** use the exposed opaque measurements and existing tracker routing mechanisms for real certified routes. Any real-run evidence must add artifact/split hashes, worker/upstream pins, backend/driver, hardware/network details, commands, and raw metrics.
|
||||
Reference in New Issue
Block a user