From the 101 lk/man/pth code-gen sources: 63 tasks (C11 36, C++17 27, 11 canonical families), 38 skipped for scope or duplication. Each task has at least one independent contract-edge defect, boundary types rotate, and public docs state trap clauses as plain contract prose. Claude reviewed 63/63 USABLE against current digests. Difficulty is unmeasured. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
22 lines
3.1 KiB
Markdown
22 lines
3.1 KiB
Markdown
# Observation console
|
|
|
|
Build with `make` and pipe command lines to `./group-console`. Each command produces the JSON arrays listed below, with decimal integers. JSON formatting and whitespace may vary. The process exits 0 at normal end of input; malformed console commands exit 2. Empty lines and lines whose first word starts with # produce no output. Fields are separated by ASCII spaces or tabs. Command integers use ASCII digits without sign, fit Word, and allow any number of leading zeros. A hex string is an even-length sequence of hexadecimal byte pairs (either case); `-` represents an empty string.
|
|
|
|
The console has two independent Engines and two independent standalone Journals. `U index` selects both objects at index 0 or 1 and prints `[index]`; it does not reset either. Initially index 0 is selected. Engine operations do not touch either standalone Journal.
|
|
|
|
`C width capacity`, `A id value`, `X`, `F count`, `Z` call Engine configure, enqueue, close, fail_next and reset respectively, printing `[rc]` (reset prints `[0]`).
|
|
|
|
`P nonce` calls Engine pump with all Receipt fields initially nonce, printing `[rc,ticket,count,total,digest]`. `R index nonce` reads an Engine Receipt with those initial values and the same output fields. `Q index nonce` peeks with Item fields initially nonce, printing `[rc,id,value]`.
|
|
|
|
`S` prints `[active,width,capacity,closing,queued,accepted,generation,ready,next_ticket,batches,items,total,attempts,failures]` from Engine status. `JF count`, `JZ`, `JS`, `JR index nonce` operate on the selected standalone Journal: setting failures and reset print `[rc]`, info prints `[batches,items,total,attempts,failures]`, and read prints the Receipt array.
|
|
|
|
`N hex maximum nonce` calls parse_decimal with out initially nonce, printing `[rc,out]`. `T hex nonce` calls decode_config with both fields initially nonce, printing `[rc,width,capacity]`. Each then prints `[before,after]`, where before and after are the digest of the input string's bytes using the byte update in contract R13.
|
|
|
|
`V width capacity` prints `[validate_config]`. `K queued width closing` (closing is 0 or 1) prints `[take_count]`.
|
|
|
|
`JC ticket nonce count id value ...` supplies count Items to standalone Journal commit with Receipt fields initially nonce, printing its Receipt array. `B ticket nonce count id value ...` prints `[validate_items]`. `D ticket nonce count id value ...` prints `[0,ticket,count,total,digest]` from summarize. `H ticket nonce count id value ...` prints `[digest_items]`. B, D and H ignore nonce; H also ignores ticket. The observer accepts counts 0..64. Each of these commands then prints `[before,after]` using an independent digest of the input Item fields as specified by contract R13.
|
|
|
|
`E left_count right_count left_id left_value ... right_id right_value ...` prints `[same_items]`, using 0 or 1. Both counts are in 0..64. It then prints the `[before,after]` digests for the left and right input sequences.
|
|
|
|
The observation console does not assert expected results or contain reference answers. Values are read from the public APIs. All input digests in before/after observations are computed by the console from the original input buffers.
|