Move issues (01–29) and PRD from .scratch/distributed-inference-network/ into docs/issues/ and docs/. Update ralph_progress.py DEFAULT_PRD path and rewrite docs/agents/issue-tracker.md to reflect the new layout. The distributed_inference_network.egg-info/docs/ mirror is a build artifact already covered by *.egg-info/ in .gitignore — not committed. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
27 lines
1.1 KiB
Markdown
27 lines
1.1 KiB
Markdown
# US-028 — Routing correctness tests: three-node, overlap, and throughput scenarios
|
||
|
||
Status: done
|
||
Priority: Medium
|
||
Stage: Implemented
|
||
|
||
## Context
|
||
|
||
Route selection logic (`_select_route`) is the core of the inference network. Without
|
||
locked-down tests, routing regressions are silent. This story adds a comprehensive
|
||
scenario suite that locks in the routing contract.
|
||
|
||
## Test scenarios
|
||
|
||
1. **No-overlap three nodes**: greedy picks in layer-start order (A→C→B for ranges 0–7, 8–15, 16–23)
|
||
Note: the algorithm picks by earliest uncovered layer, not by node label — so if C.shard_start < B.shard_start, C comes first.
|
||
2. **Overlapping shards**: correct resolution without double-computing layers
|
||
3. **Throughput tiebreak**: faster node wins when shard_end is equal
|
||
4. **Gap detection**: partial coverage returns a 503 error with description
|
||
|
||
## Acceptance criteria
|
||
|
||
- [ ] 7 routing tests covering the above scenarios
|
||
- [ ] Tests use in-process tracker (no mocking)
|
||
- [ ] `_make_node` helper for concise test setup
|
||
- [ ] All tests pass; `python -m pytest` passes
|