One user-space repair task per eligible HWE debug-diag / compile-deploy base ID: 320 admitted (C 218, C++ 97, build scripts 5), 1 skipped by the content filter. Each ships a public spec with a check-to-basis table, at least two defects with single-fix fixtures, a symptom-masking fixture and an alternative correct implementation. Claude re-checked all 320: structure, the HWE quality items and trace6 Docker calibration receipts against current digests (320/320 USABLE). Difficulty is unmeasured. Known follow-up: 212 tasks use 120 ad-hoc family names; the next batch maps them to the canonical list. The batch's 1,256-line progress log stays in its factory report and the 36-local branch batch15-hwe. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
4.1 KiB
Owned buffer view contract
The program is a software model of an owned allocation and an aligned child view.
Its observer reports pointer residue and view metadata; it never dereferences a
view whose range is invalid, nor passes an interior pointer to free.
OPEN id capacity accepts ids 0..7 and capacities 1..4096. A live id is replaced
only after its old original allocation has been released. A successful OPEN prints
O id capacity generation; generation starts at 1 and increments on each OPEN.
An invalid command prints E and leaves all owners unchanged.
PLAN id alignment requested accepts alignment 1..256 and requested 0..4096.
The owner must be live. The view offset is the smallest nonnegative integer
such that (uintptr_t)original + offset is divisible by alignment.
In particular, an already aligned original has offset zero. Alignment need not
be a power of two. Compute without overflowing the original capacity.
PLAN succeeds exactly when offset is at most capacity and requested is at most capacity minus offset. On success, the view's effective span is all remaining bytes from offset to the end of that original allocation, including bytes after the requested subrange. A zero length request follows the same rule.
The successful view carries the original owner's identity, original pointer,
original capacity, and current generation. It must not substitute its interior
address for the owner pointer. Failed PLAN leaves no usable view and reports -1.
DROP id releases the original allocation at most once and reports D id 1
when a live owner was released, or D id 0 otherwise. A view becomes stale after
DROP or replacement OPEN; CHECK id reports it unusable. Only the original
pointer is passed to the actual allocator release operation.
FILL id seed accepts seed 0..255 and writes byte (seed + 17 * index) % 256
at each index of a live original allocation. It prints F id 1, or F id 0
when the id is not live. PROBE id count accepts count 0..4096 and prints
T id status checksum. It succeeds only when a current usable view exists and
count is at most its effective span. Its checksum starts at zero and, for each
byte in the view prefix, applies (checksum * 33 + byte) % 65521; on failure
it prints T id -1 0. No invalid view is dereferenced.
COPY source_id destination_id count accepts ids 0..7 and count 0..4096.
It copies exactly count bytes from a current usable view to the beginning of
a live destination original allocation, using overlap safe copying. The count
must fit both source effective span and destination original capacity. It prints
X source_id destination_id 1 on success or the same fields with 0 on
failure. A failed copy changes neither allocation.
RESET releases every live original allocation, prints Z released_count,
and leaves every prior view stale. It preserves generation counters so the next
OPEN can be distinguished from the old owner lifetime.
The observer prints one response per input line. PLAN response is:
P id residue status offset span owner_ok aligned in_bounds usable
residue is the original pointer modulo the requested alignment. On failure,
status is -1 and the six metadata fields after it are zero. On success status is
0, offset/span are decimal integers, and each final flag is 0 or 1. owner_ok
checks original owner/pointer/capacity/generation; aligned and in_bounds
inspect the returned view without dereferencing it; usable checks all invariants.
CHECK id prints C id usable, with 0 when no current live view exists.
Input fields use ASCII decimal digits with optional leading plus, separated by
space or TAB; each command occupies one LF terminated line. Output fields use
ASCII decimal tokens separated by space or TAB and terminated by LF. Diagnostics
may be written to stderr. The program reads until EOF. At exit it releases all
remaining original allocations. A maximum of 512 commands is supported.
After the last command, the observer prints I bytes digest, where bytes is
the number of stdin bytes actually read and digest is FNV-1a over those bytes
with 32-bit offset basis 2166136261 and multiplier 16777619. This line is part
of the public output protocol.