FAILURE MAP
← Case archive

FA-27756 / HTTP ranges / Open access

A delta downloader reuses matching local blocks and fetches the rest with batched ranges: the digest manifest must describe exactly the remote block count · case 01

A delta downloader reuses matching local blocks and fetches the rest with batched ranges: the digest manifest must describe exactly the remote block count.

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

ROOT CAUSE

The delta-block-fetch-manifest-block-count 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']): 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].

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']):
        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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count fixture 9', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':[],'total':0}))), json.loads(json.dumps([[],[]])))
check('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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
manifest-block-count fixture 0[[[4, 0, 4]], ['bytes=0-3,8-9']][[[4, 0, 4]], ['bytes=0-3,8-9']]Passed
manifest-block-count fixture 1[[[0, 8, 4]], ['bytes=4-7']][[[0, 8, 4]], ['bytes=4-7']]Passed
manifest-block-count fixture 2[[[0, 4, 4], [4, 8, 4]], ['bytes=8-9']][[[0, 4, 4], [4, 8, 4]], ['bytes=8-9']]Passed
manifest-block-count fixture 3[[], ['bytes=0-7']][[], ['bytes=0-7']]Passed
manifest-block-count 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
manifest-block-count fixture 5[[], ['bytes=0-7']]NoneFailed
manifest-block-count fixture 6[[], ['bytes=0-7']]NoneFailed
manifest-block-count fixture 7[[], ['bytes=0-7']][[], ['bytes=0-7']]Passed
manifest-block-count fixture 8[[[0, 0, 4]], ['bytes=4-7']][[[0, 0, 4]], ['bytes=4-7']]Passed
manifest-block-count fixture 9[[], []][[], []]Passed
manifest-block-count fixture 10NoneNonePassed
manifest-block-count fixture 11[[], ['bytes=0-11']][[], ['bytes=0-11']]Passed
manifest-block-count fixture 12[[[0, 0, 4]], []][[[0, 0, 4]], []]Passed

SHA-256 / 636079bfca8afae3da453710ba602a1a9cbcd615475bc216329ce3cdaf8fe8a5

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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count fixture 9', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':[],'total':0}))), json.loads(json.dumps([[],[]])))
check('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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
manifest-block-count fixture 0[[[4, 0, 4]], ['bytes=0-3,8-9']][[[4, 0, 4]], ['bytes=0-3,8-9']]Passed
manifest-block-count fixture 1[[[0, 8, 4]], ['bytes=4-7']][[[0, 8, 4]], ['bytes=4-7']]Passed
manifest-block-count fixture 2[[[0, 4, 4], [4, 8, 4]], ['bytes=8-9']][[[0, 4, 4], [4, 8, 4]], ['bytes=8-9']]Passed
manifest-block-count fixture 3[[], ['bytes=0-7']][[], ['bytes=0-7']]Passed
manifest-block-count 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
manifest-block-count fixture 5NoneNonePassed
manifest-block-count fixture 6[[], ['bytes=0-7']]NoneFailed
manifest-block-count fixture 7[[], ['bytes=0-7']][[], ['bytes=0-7']]Passed
manifest-block-count fixture 8[[[0, 0, 4]], ['bytes=4-7']][[[0, 0, 4]], ['bytes=4-7']]Passed
manifest-block-count fixture 9[[], []][[], []]Passed
manifest-block-count fixture 10NoneNonePassed
manifest-block-count fixture 11[[], ['bytes=0-11']][[], ['bytes=0-11']]Passed
manifest-block-count fixture 12[[[0, 0, 4]], []][[[0, 0, 4]], []]Passed

SHA-256 / b498997fc124e0584d42488becfb11f858e793957b558619a5bd8d6af1be2c6a

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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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('manifest-block-count fixture 9', json.loads(json.dumps(solve({'block':4,'local':[],'local_total':0,'max_ranges':2,'remote':[],'total':0}))), json.loads(json.dumps([[],[]])))
check('manifest-block-count 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('manifest-block-count 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('manifest-block-count 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
manifest-block-count fixture 0[[[4, 0, 4]], ['bytes=0-3,8-9']][[[4, 0, 4]], ['bytes=0-3,8-9']]Passed
manifest-block-count fixture 1[[[0, 8, 4]], ['bytes=4-7']][[[0, 8, 4]], ['bytes=4-7']]Passed
manifest-block-count fixture 2[[[0, 4, 4], [4, 8, 4]], ['bytes=8-9']][[[0, 4, 4], [4, 8, 4]], ['bytes=8-9']]Passed
manifest-block-count fixture 3[[], ['bytes=0-7']][[], ['bytes=0-7']]Passed
manifest-block-count 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
manifest-block-count fixture 5NoneNonePassed
manifest-block-count fixture 6NoneNonePassed
manifest-block-count fixture 7[[], ['bytes=0-7']][[], ['bytes=0-7']]Passed
manifest-block-count fixture 8[[[0, 0, 4]], ['bytes=4-7']][[[0, 0, 4]], ['bytes=4-7']]Passed
manifest-block-count fixture 9[[], []][[], []]Passed
manifest-block-count fixture 10NoneNonePassed
manifest-block-count fixture 11[[], ['bytes=0-11']][[], ['bytes=0-11']]Passed
manifest-block-count fixture 12[[[0, 0, 4]], []][[[0, 0, 4]], []]Passed

SHA-256 / 428fcf92643ea23458786c852e3c82049396058961b0ee14e1a0a432ab753b35

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.843212+00:00.

Case digest / dd46217961476a525ddf51ce2a038f80ffc8f2a220d84b595351a305651c34f2