FAILURE MAP
← Case archive

FA-27761 / HTTP ranges / Open access

A delta downloader reuses matching local blocks and fetches the rest with batched ranges: a short local tail block is not a reusable full block · case 01

A delta downloader reuses matching local blocks and fetches the rest with batched ranges: a short local tail block is not a reusable full block.

Verified by executionVariant 1 · 13 checks per implementationDownload source bundle ↓JSON ↗

ROOT CAUSE

The delta-block-fetch-local-short-block decision uses T=x['total'] B=x['block'] remote=x['remote'] if B<=0 or T<0 or len(remote)!=-(-T//B): return None where={} for j,d in enumerate(x['local']): where.setdefault(d,j) copies=[] runs=[] for i,d in enumerate(remote): n=min(B,T-i*B) if d in where and n==B: copies.append([i*B,where[d]*B,n]) continue if runs and runs[-1][1]==i*B-1: runs[-1][1]=i*B+n-1 else: runs.append([i*B,i*B+n-1]) R=x['max_ranges'] headers=[] for k in range(0,len(runs),R): headers.append('bytes='+','.join('%d-%d'%(a,b) for a,b in runs[k:k+R])) return [copies,headers].

VERIFIED REPAIR

Apply the bounded decision exactly: T=x['total'] B=x['block'] remote=x['remote'] if B<=0 or T<0 or len(remote)!=-(-T//B): return None where={} for j,d in enumerate(x['local']): if (j+1)*B<=x['local_total']: where.setdefault(d,j) copies=[] runs=[] for i,d in enumerate(remote): n=min(B,T-i*B) if d in where and n==B: copies.append([i*B,where[d]*B,n]) continue if runs and runs[-1][1]==i*B-1: runs[-1][1]=i*B+n-1 else: runs.append([i*B,i*B+n-1]) R=x['max_ranges'] headers=[] for k in range(0,len(runs),R): headers.append('bytes='+','.join('%d-%d'%(a,b) for a,b in runs[k:k+R])) return [copies,headers]

Unsuccessful approach: The partial repair uses T=x['total'] B=x['block'] remote=x['remote'] if B<=0 or T<0 or len(remote)!=-(-T//B): return None where={} for j,d in enumerate(x['local']): if (j+1)*B<x['local_total']: where.setdefault(d,j) copies=[] runs=[] for i,d in enumerate(remote): n=min(B,T-i*B) if d in where and n==B: copies.append([i*B,where[d]*B,n]) continue if runs and runs[-1][1]==i*B-1: runs[-1][1]=i*B+n-1 else: runs.append([i*B,i*B+n-1]) R=x['max_ranges'] headers=[] for k in range(0,len(runs),R): headers.append('bytes='+','.join('%d-%d'%(a,b) for a,b in runs[k:k+R])) return [copies,headers], which still violates the stated contract.

Case contract

x has remote total length, block size, one remote digest per block (the last block may be short), local digests per local block with the local file length, and a per-request range limit R>=1. Reject nonpositive block size, negative total, or a manifest whose count is not ceil(total/block). Only complete local blocks may be copied; a full remote block whose digest occurs at any local position is copied from the first such complete local block as [dest-offset,source-offset,length]. The short final remote block is always fetched. Missing bytes form maximal adjacent inclusive runs, sent in consecutive batches of at most R ranges. Return [copies,Range values].

Why this case matters

Range responses combine representation identity, conditional requests, framing, and partial-object state.

1 / The failure

Exit 1
"""Failure Map reference implementation. Python standard library only."""
import json

N = 1
observations = []
def solve(x):
    T=x['total']
    B=x['block']
    remote=x['remote']
    if B<=0 or T<0 or len(remote)!=-(-T//B): return None
    where={}
    for j,d in enumerate(x['local']):
        where.setdefault(d,j)
    copies=[]
    runs=[]
    for i,d in enumerate(remote):
        n=min(B,T-i*B)
        if d in where and n==B:
            copies.append([i*B,where[d]*B,n])
            continue
        if runs and runs[-1][1]==i*B-1: runs[-1][1]=i*B+n-1
        else: runs.append([i*B,i*B+n-1])
    R=x['max_ranges']
    headers=[]
    for k in range(0,len(runs),R):
        headers.append('bytes='+','.join('%d-%d'%(a,b) for a,b in runs[k:k+R]))
    return [copies,headers]
def check(label, actual, expected):
    observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
check('local-short-block fixture 0', json.loads(json.dumps(solve({'block':4,'local':['b','x'],'local_total':8,'max_ranges':2,'remote':['a','b','c'],'total':10}))), json.loads(json.dumps([[[4,0,4]],['bytes=0-3,8-9']])))
check('local-short-block fixture 1', json.loads(json.dumps(solve({'block':4,'local':['z','z','a'],'local_total':12,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps([[[0,8,4]],['bytes=4-7']])))
check('local-short-block fixture 2', json.loads(json.dumps(solve({'block':4,'local':['t','a','b'],'local_total':12,'max_ranges':2,'remote':['a','b','t'],'total':10}))), json.loads(json.dumps([[[0,4,4],[4,8,4]],['bytes=8-9']])))
check('local-short-block fixture 3', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps([[],['bytes=0-7']])))
check('local-short-block fixture 4', json.loads(json.dumps(solve({'block':4,'local':['k'],'local_total':4,'max_ranges':2,'remote':['a','k','b','k','c','k'],'total':24}))), json.loads(json.dumps([[[4,0,4],[12,0,4],[20,0,4]],['bytes=0-3,8-11','bytes=16-19']])))
check('local-short-block fixture 5', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b'],'total':10}))), json.loads(json.dumps(None)))
check('local-short-block fixture 6', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b','c'],'total':8}))), json.loads(json.dumps(None)))
check('local-short-block fixture 7', json.loads(json.dumps(solve({'block':4,'local':['s'],'local_total':2,'max_ranges':2,'remote':['a','s'],'total':8}))), json.loads(json.dumps([[],['bytes=0-7']])))
check('local-short-block fixture 8', json.loads(json.dumps(solve({'block':4,'local':['a'],'local_total':4,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps([[[0,0,4]],['bytes=4-7']])))
check('local-short-block fixture 9', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':[],'total':0}))), json.loads(json.dumps([[],[]])))
check('local-short-block fixture 10', json.loads(json.dumps(solve({'block':0,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps(None)))
check('local-short-block fixture 11', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':1,'remote':['a','b','c'],'total':12}))), json.loads(json.dumps([[],['bytes=0-11']])))
check('local-short-block fixture 12', json.loads(json.dumps(solve({'block':4,'local':['h'],'local_total':4,'max_ranges':2,'remote':["h"]*N,'total':4*N}))), json.loads(json.dumps([[[4*i,0,4] for i in range(N)],[]])))
print(json.dumps({"observations": observations, "passed": all(x["passed"] for x in observations)}, ensure_ascii=False))
raise SystemExit(0 if all(x["passed"] for x in observations) else 1)
Boundary fixtureActualExpectedOutcome
local-short-block fixture 0[[[4, 0, 4]], ['bytes=0-3,8-9']][[[4, 0, 4]], ['bytes=0-3,8-9']]Passed
local-short-block fixture 1[[[0, 8, 4]], ['bytes=4-7']][[[0, 8, 4]], ['bytes=4-7']]Passed
local-short-block fixture 2[[[0, 4, 4], [4, 8, 4]], ['bytes=8-9']][[[0, 4, 4], [4, 8, 4]], ['bytes=8-9']]Passed
local-short-block fixture 3[[], ['bytes=0-7']][[], ['bytes=0-7']]Passed
local-short-block fixture 4[[[4, 0, 4], [12, 0, 4], [20, 0, 4]], ['bytes=0-3,8-11', 'bytes=16-19']][[[4, 0, 4], [12, 0, 4], [20, 0, 4]], ['bytes=0-3,8-11', 'bytes=16-19']]Passed
local-short-block fixture 5NoneNonePassed
local-short-block fixture 6NoneNonePassed
local-short-block fixture 7[[[4, 0, 4]], ['bytes=0-3']][[], ['bytes=0-7']]Failed
local-short-block fixture 8[[[0, 0, 4]], ['bytes=4-7']][[[0, 0, 4]], ['bytes=4-7']]Passed
local-short-block fixture 9[[], []][[], []]Passed
local-short-block fixture 10NoneNonePassed
local-short-block fixture 11[[], ['bytes=0-11']][[], ['bytes=0-11']]Passed
local-short-block fixture 12[[[0, 0, 4]], []][[[0, 0, 4]], []]Passed

SHA-256 / faecaf9f920923f0fa98a627ff74e76249e775bf2c4b3ebd9663a4491b9f07b2

2 / The unsuccessful fix

Exit 1
"""Failure Map reference implementation. Python standard library only."""
import json

N = 1
observations = []
def solve(x):
    T=x['total']
    B=x['block']
    remote=x['remote']
    if B<=0 or T<0 or len(remote)!=-(-T//B): return None
    where={}
    for j,d in enumerate(x['local']):
        if (j+1)*B<x['local_total']: where.setdefault(d,j)
    copies=[]
    runs=[]
    for i,d in enumerate(remote):
        n=min(B,T-i*B)
        if d in where and n==B:
            copies.append([i*B,where[d]*B,n])
            continue
        if runs and runs[-1][1]==i*B-1: runs[-1][1]=i*B+n-1
        else: runs.append([i*B,i*B+n-1])
    R=x['max_ranges']
    headers=[]
    for k in range(0,len(runs),R):
        headers.append('bytes='+','.join('%d-%d'%(a,b) for a,b in runs[k:k+R]))
    return [copies,headers]
def check(label, actual, expected):
    observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
check('local-short-block fixture 0', json.loads(json.dumps(solve({'block':4,'local':['b','x'],'local_total':8,'max_ranges':2,'remote':['a','b','c'],'total':10}))), json.loads(json.dumps([[[4,0,4]],['bytes=0-3,8-9']])))
check('local-short-block fixture 1', json.loads(json.dumps(solve({'block':4,'local':['z','z','a'],'local_total':12,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps([[[0,8,4]],['bytes=4-7']])))
check('local-short-block fixture 2', json.loads(json.dumps(solve({'block':4,'local':['t','a','b'],'local_total':12,'max_ranges':2,'remote':['a','b','t'],'total':10}))), json.loads(json.dumps([[[0,4,4],[4,8,4]],['bytes=8-9']])))
check('local-short-block fixture 3', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps([[],['bytes=0-7']])))
check('local-short-block fixture 4', json.loads(json.dumps(solve({'block':4,'local':['k'],'local_total':4,'max_ranges':2,'remote':['a','k','b','k','c','k'],'total':24}))), json.loads(json.dumps([[[4,0,4],[12,0,4],[20,0,4]],['bytes=0-3,8-11','bytes=16-19']])))
check('local-short-block fixture 5', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b'],'total':10}))), json.loads(json.dumps(None)))
check('local-short-block fixture 6', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b','c'],'total':8}))), json.loads(json.dumps(None)))
check('local-short-block fixture 7', json.loads(json.dumps(solve({'block':4,'local':['s'],'local_total':2,'max_ranges':2,'remote':['a','s'],'total':8}))), json.loads(json.dumps([[],['bytes=0-7']])))
check('local-short-block fixture 8', json.loads(json.dumps(solve({'block':4,'local':['a'],'local_total':4,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps([[[0,0,4]],['bytes=4-7']])))
check('local-short-block fixture 9', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':[],'total':0}))), json.loads(json.dumps([[],[]])))
check('local-short-block fixture 10', json.loads(json.dumps(solve({'block':0,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps(None)))
check('local-short-block fixture 11', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':1,'remote':['a','b','c'],'total':12}))), json.loads(json.dumps([[],['bytes=0-11']])))
check('local-short-block fixture 12', json.loads(json.dumps(solve({'block':4,'local':['h'],'local_total':4,'max_ranges':2,'remote':["h"]*N,'total':4*N}))), json.loads(json.dumps([[[4*i,0,4] for i in range(N)],[]])))
print(json.dumps({"observations": observations, "passed": all(x["passed"] for x in observations)}, ensure_ascii=False))
raise SystemExit(0 if all(x["passed"] for x in observations) else 1)
Boundary fixtureActualExpectedOutcome
local-short-block fixture 0[[[4, 0, 4]], ['bytes=0-3,8-9']][[[4, 0, 4]], ['bytes=0-3,8-9']]Passed
local-short-block fixture 1[[], ['bytes=0-7']][[[0, 8, 4]], ['bytes=4-7']]Failed
local-short-block fixture 2[[[0, 4, 4]], ['bytes=4-9']][[[0, 4, 4], [4, 8, 4]], ['bytes=8-9']]Failed
local-short-block fixture 3[[], ['bytes=0-7']][[], ['bytes=0-7']]Passed
local-short-block fixture 4[[], ['bytes=0-23']][[[4, 0, 4], [12, 0, 4], [20, 0, 4]], ['bytes=0-3,8-11', 'bytes=16-19']]Failed
local-short-block fixture 5NoneNonePassed
local-short-block fixture 6NoneNonePassed
local-short-block fixture 7[[], ['bytes=0-7']][[], ['bytes=0-7']]Passed
local-short-block fixture 8[[], ['bytes=0-7']][[[0, 0, 4]], ['bytes=4-7']]Failed
local-short-block fixture 9[[], []][[], []]Passed
local-short-block fixture 10NoneNonePassed
local-short-block fixture 11[[], ['bytes=0-11']][[], ['bytes=0-11']]Passed
local-short-block fixture 12[[], ['bytes=0-3']][[[0, 0, 4]], []]Failed

SHA-256 / d3f0b4de6f60b37cbdef009c51bcb2671cf5f3e5515a1211206a0b1bc98e4b78

3 / The verified repair

Exit 0
"""Failure Map reference implementation. Python standard library only."""
import json

N = 1
observations = []
def solve(x):
    T=x['total']
    B=x['block']
    remote=x['remote']
    if B<=0 or T<0 or len(remote)!=-(-T//B): return None
    where={}
    for j,d in enumerate(x['local']):
        if (j+1)*B<=x['local_total']: where.setdefault(d,j)
    copies=[]
    runs=[]
    for i,d in enumerate(remote):
        n=min(B,T-i*B)
        if d in where and n==B:
            copies.append([i*B,where[d]*B,n])
            continue
        if runs and runs[-1][1]==i*B-1: runs[-1][1]=i*B+n-1
        else: runs.append([i*B,i*B+n-1])
    R=x['max_ranges']
    headers=[]
    for k in range(0,len(runs),R):
        headers.append('bytes='+','.join('%d-%d'%(a,b) for a,b in runs[k:k+R]))
    return [copies,headers]
def check(label, actual, expected):
    observations.append({"check": label, "actual": actual, "expected": expected, "passed": actual == expected})
check('local-short-block fixture 0', json.loads(json.dumps(solve({'block':4,'local':['b','x'],'local_total':8,'max_ranges':2,'remote':['a','b','c'],'total':10}))), json.loads(json.dumps([[[4,0,4]],['bytes=0-3,8-9']])))
check('local-short-block fixture 1', json.loads(json.dumps(solve({'block':4,'local':['z','z','a'],'local_total':12,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps([[[0,8,4]],['bytes=4-7']])))
check('local-short-block fixture 2', json.loads(json.dumps(solve({'block':4,'local':['t','a','b'],'local_total':12,'max_ranges':2,'remote':['a','b','t'],'total':10}))), json.loads(json.dumps([[[0,4,4],[4,8,4]],['bytes=8-9']])))
check('local-short-block fixture 3', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps([[],['bytes=0-7']])))
check('local-short-block fixture 4', json.loads(json.dumps(solve({'block':4,'local':['k'],'local_total':4,'max_ranges':2,'remote':['a','k','b','k','c','k'],'total':24}))), json.loads(json.dumps([[[4,0,4],[12,0,4],[20,0,4]],['bytes=0-3,8-11','bytes=16-19']])))
check('local-short-block fixture 5', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b'],'total':10}))), json.loads(json.dumps(None)))
check('local-short-block fixture 6', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b','c'],'total':8}))), json.loads(json.dumps(None)))
check('local-short-block fixture 7', json.loads(json.dumps(solve({'block':4,'local':['s'],'local_total':2,'max_ranges':2,'remote':['a','s'],'total':8}))), json.loads(json.dumps([[],['bytes=0-7']])))
check('local-short-block fixture 8', json.loads(json.dumps(solve({'block':4,'local':['a'],'local_total':4,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps([[[0,0,4]],['bytes=4-7']])))
check('local-short-block fixture 9', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':[],'total':0}))), json.loads(json.dumps([[],[]])))
check('local-short-block fixture 10', json.loads(json.dumps(solve({'block':0,'local':[],'local_total':0,'max_ranges':2,'remote':['a','b'],'total':8}))), json.loads(json.dumps(None)))
check('local-short-block fixture 11', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':1,'remote':['a','b','c'],'total':12}))), json.loads(json.dumps([[],['bytes=0-11']])))
check('local-short-block fixture 12', json.loads(json.dumps(solve({'block':4,'local':['h'],'local_total':4,'max_ranges':2,'remote':["h"]*N,'total':4*N}))), json.loads(json.dumps([[[4*i,0,4] for i in range(N)],[]])))
print(json.dumps({"observations": observations, "passed": all(x["passed"] for x in observations)}, ensure_ascii=False))
raise SystemExit(0 if all(x["passed"] for x in observations) else 1)
Boundary fixtureActualExpectedOutcome
local-short-block fixture 0[[[4, 0, 4]], ['bytes=0-3,8-9']][[[4, 0, 4]], ['bytes=0-3,8-9']]Passed
local-short-block fixture 1[[[0, 8, 4]], ['bytes=4-7']][[[0, 8, 4]], ['bytes=4-7']]Passed
local-short-block fixture 2[[[0, 4, 4], [4, 8, 4]], ['bytes=8-9']][[[0, 4, 4], [4, 8, 4]], ['bytes=8-9']]Passed
local-short-block fixture 3[[], ['bytes=0-7']][[], ['bytes=0-7']]Passed
local-short-block fixture 4[[[4, 0, 4], [12, 0, 4], [20, 0, 4]], ['bytes=0-3,8-11', 'bytes=16-19']][[[4, 0, 4], [12, 0, 4], [20, 0, 4]], ['bytes=0-3,8-11', 'bytes=16-19']]Passed
local-short-block fixture 5NoneNonePassed
local-short-block fixture 6NoneNonePassed
local-short-block fixture 7[[], ['bytes=0-7']][[], ['bytes=0-7']]Passed
local-short-block fixture 8[[[0, 0, 4]], ['bytes=4-7']][[[0, 0, 4]], ['bytes=4-7']]Passed
local-short-block fixture 9[[], []][[], []]Passed
local-short-block fixture 10NoneNonePassed
local-short-block fixture 11[[], ['bytes=0-11']][[], ['bytes=0-11']]Passed
local-short-block fixture 12[[[0, 0, 4]], []][[[0, 0, 4]], []]Passed

SHA-256 / ae463079027afb03ae977af9ab0774fad86f80906e00039fa00b739418f789b1

Verification & scope

Deterministic simplified range service, with stipulated local policies and already parsed trusted inputs; not a complete HTTP implementation. This reproducer isolates one failure mechanism. Results cover the supplied fixtures. Variants within a family share a test contract and should remain grouped when constructing evaluation splits. Related mechanisms with a shared evaluation_group must also remain together; these controlled models are not independent production incidents.

Observations recorded using Python 3.12.14 at 2026-09-29T14:41:27.969820+00:00.

Case digest / 04d2e407e8b7430a67fc9557ee9386db0ca780488dddcff24f3b89b2eeca371c