Html api docs improvement - #61

Draft

sirreal wants to merge 217 commits into

trunkfrom

html-api-docs-improvement

Commits on Jun 11, 2026

HTML API docs experiment: plan contract and markdown renderer.
sirreal
committed
6acec9d
HTML API docs experiment: task corpus and execution harness.
sirreal
committed
947ca71
HTML API docs experiment: round tooling and protocol.
sirreal
committed
df08126
HTML API docs experiment: workflow scripts and trial persistence.
sirreal
committed
cf0fcdc
HTML API docs experiment: round 0 baseline results.
sirreal
committed
aa1c305
HTML API docs round 1, hypothesis 1: closer-token depth semantics.
sirreal
committed
58140b2
HTML API docs round 1, hypothesis 2: rehabilitate HTML Processor next_token().
sirreal
committed
2d763ed
HTML API docs round 1, hypothesis 3: get_modifiable_text() returns decoded text.
sirreal
committed
0b9366f
HTML API docs experiment: round 1 results — all hypotheses confirmed.
sirreal
committed
5266d91
HTML API docs experiment: corpus revision per review.
sirreal
committed
6af8349
HTML API docs round 3, hypothesis 1: set_attribute() placement rules.
sirreal
committed
5e3f92f
HTML API docs round 3, hypothesis 2: correct the class-level support claims.
sirreal
committed
ea22ff5
HTML API docs round 3, hypothesis 3: serialize_token() rewrite idiom.
sirreal
committed
fb1f01c
HTML API docs experiment: round 2 Haiku baseline results.
sirreal
committed
74d4b5f
HTML API docs experiment: ingest tooling for the long-run loop.
sirreal
committed
6a63e54
HTML API docs round 4, hypothesis 1: serialization is not how you read edits.
sirreal
committed
514587f
HTML API docs round 4, hypothesis 2: which tokens carry modifiable text.
sirreal
committed
41fe8b9
HTML API docs round 4, hypothesis 3: bookmark name reuse is the last-X idiom.
sirreal
committed
3c1b7ab
HTML API docs experiment: round 3 results — refine serialize guidance, two new gaps.
sirreal
committed
11e5a14
HTML API docs round 5, hypothesis 1: building markup from a template.
sirreal
committed
e6f1dcb
HTML API docs round 5, hypotheses 2-3: next_tag() matching contract; decoded reads; add_class idempotency.
sirreal
committed
62d133e
HTML API docs round 5, hypothesis 4: why the subtree walk uses >=.
sirreal
committed
43a81c4
HTML API docs experiment: round 4 results — train 94.18 (+3.5), T07 cured.
sirreal
committed
d098352
HTML API docs round 6 hypotheses: processor chooser, tree-awareness boundary, get_updated_html identity, >= warning placement.
sirreal
committed
da7f4e2
HTML API docs experiment: round 5 results — train 94.77, T04 +49.2.
sirreal
committed
290227e
HTML API docs round 7 hypotheses: RCDATA text location on the HTML Processor, >= beside the operator, drain idiom, add_class return semantics.
sirreal
committed
3359336
HTML API docs experiment: round 6 checkpoint — train 97.84, held-out above baseline.
sirreal
committed
614e4ed
HTML API docs round 8 hypotheses: UTF-8 output statement; break-form boundary rule.
sirreal
committed
28742d9
HTML API docs experiment: round 7 results — train 97.51, N03 perfect.
sirreal
committed
6fe7f8b
HTML API docs round 9 hypotheses: the shared cursor, and surfacing the last-X bookmark idiom.
sirreal
committed
2b1b6d3
HTML API docs round 9, hypothesis 2: surface the last-X bookmark idiom in the bookmarks narrative.
sirreal
committed
4123688
HTML API docs experiment: round 8 results — train 97.70, first saturated task.
sirreal
committed
6bfa07a
HTML API docs round 10 hypothesis: the RCDATA exception belongs on the walk path.
sirreal
committed
6dd4bf3
HTML API docs experiment: round 9 checkpoint — train 98.66, T08 stabilized.
sirreal
committed
df814e1
HTML API docs round 11 hypotheses: the equality case is the reason for >=; empty regions flush naturally.
sirreal
committed
31f421e
HTML API docs experiment: round 10 results — train 98.70, T08 perfect.
sirreal
committed
d26ca3a
HTML API docs round 12 hypotheses: add_class never removes; quoting scope co-located.
sirreal
committed
f451089
HTML API docs experiment: round 11 results — train 98.28, T09 perfect.
sirreal
committed
1531f93
HTML API docs round 13 hypotheses: no closer-guard needed by default; implied elements appear in walks.
sirreal
committed
0ecd406
HTML API docs experiment: round 12 checkpoint — held-out 91.04, N05 +12.4.
sirreal
committed
8599a39
HTML API docs round 14 hypothesis: post-collection measurement noted in the recipe.
sirreal
committed
f584345
HTML API docs experiment: round 13 results — first 100% functional sweep, train 98.54.
sirreal
committed
43eb4e1
HTML API docs round 15 hypothesis: construction asymmetry stated on both classes.
sirreal
committed
a1782bc
HTML API docs experiment: round 14 results — construction-asymmetry gap now train-evidenced.
sirreal
committed
f4b1039

Commits on Jun 12, 2026

HTML API docs round 16 hypothesis: asymmetry reminder where text readers actually are.
sirreal
committed
7575d15
HTML API docs experiment: round 15 checkpoint — T05 cured, N05 one placement away.
sirreal
committed
21e532d
HTML API docs experiment: round 16 results — three concepts at 100; round 17 is a no-edit hold round.
sirreal
committed
54f53c7
HTML API docs experiment: round 17 hold round — campaign-best 98.93 with zero edits; campaign closed.
sirreal
committed
f556693
Tighten HTML API corpus edge cases
sirreal
committed
bac6933
Improve HTML API markdown docs
sirreal
committed
f05a24a
Document next HTML API docs experiment phase
sirreal
committed
a16da73
Add GOAL
sirreal
committed
d2094c9
Short-circuit text excerpt collection
sirreal
committed
fff14cb
Require string hrefs when collecting links
sirreal
committed
0d31597
Replace quoted paragraph task with nested lists
sirreal
committed
7ff10d2
Trim table extraction prompt hints
sirreal
committed
5fbac88
Tighten last heading task
sirreal
committed
1fc5d79
Replace same-html task with tracking attributes
sirreal
committed
65301ca
Note token-name span check
sirreal
committed
908c3c4
Simplify external class task prompt
sirreal
committed
b012226
Note reference failure handling checks
sirreal
committed
7a8c97f
Clarify HTML API docs improvement goal
sirreal
committed
10d429a
Replace N03 with first list item count task
sirreal
committed
952ee4e
Replace N04 with normalize fallback task
sirreal
committed
79ef9c1
Tighten N05 document title task
sirreal
committed
dde6aed
Replace N06 with table of contents extraction
sirreal
committed
633a8fb
Replace H04 with empty paragraph holdout
sirreal
committed
be9f1a4
Fold handoff notes into experiment docs
sirreal
committed
6c38ec2
Reconcile HTML API experiment corpus refresh
sirreal
committed
6ed3b38
Record blocked current-corpus scoring attempt
sirreal
committed
7027483
Prepare current-corpus HTML API baseline tooling
sirreal
committed
549e041
Add HTML API experiment state audit
sirreal
committed
4d07135
Verify staged HTML API docs scratch isolation
sirreal
committed
af84d03
Prepare round 18 current-corpus baseline
sirreal
committed
a205cd8
Validate HTML API round artifact lifecycle
sirreal
committed
2a011ea
Generate workflow args from round metadata
sirreal
committed
bece681
Reject incomplete metadata-backed HTML API rounds
sirreal
committed
8b114d9
Record staged docs hashes for HTML API rounds
sirreal
committed
1b73fb4
Validate HTML API workflow outputs before ingestion
sirreal
committed
824b4bf
Record HTML API source digests for prepared rounds
sirreal
committed
63b03f7
Verify staged scratch hashes before HTML API scoring
sirreal
committed
e0c237c
Add HTML API corpus reference validator
sirreal
committed
99536e7
Report prepared HTML API baseline in state audit
sirreal
committed
9b94f32
Emit HTML API workflow launch manifest
sirreal
committed
6d62bc1
Reject incomplete HTML API trial workflow outputs
sirreal
committed
4bdf097
Declare HTML API trial isolation contract
sirreal
committed
006e7d0
Reject malformed HTML API judge workflow outputs
sirreal
committed
80246c5
Verify HTML API source digests during round validation
sirreal
committed
7c1be8c
Validate HTML API trial artifact contents
sirreal
committed
f23aa5a
Validate HTML API judge artifact contents
sirreal
committed
966bfe8
Reject malformed HTML API trial code payloads
sirreal
committed
e0e34ed
Reject malformed HTML API workflow envelopes
sirreal
committed
fa9629a

Commits on Jun 13, 2026

Verify HTML API scored summary reproducibility
sirreal
committed
4bf4c49
Pin HTML API round corpus inputs
sirreal
committed
8397f20
Validate current HTML API baseline candidates
sirreal
committed
1f15092
Reject HTML API source drift before scoring
sirreal
committed
f0a4af2
Clarify HTML API workflow preflight bypass
sirreal
committed
3820213
Clarify current HTML API baseline policy
sirreal
committed
9e22792
Require HTML API trial isolation attestation
sirreal
committed
177f8ef
Return HTML API trial isolation envelope
sirreal
committed
0dbc1e2
Require explicit HTML API trial agent type
sirreal
committed
5d02b91
Refresh HTML API round 18 launch metadata
sirreal
committed
4676f0e
Record HTML API workflow launch provenance
sirreal
committed
8be1ddc
Prevent HTML API result artifact overwrites
sirreal
committed
b79ef64
Validate HTML API corpus before workflow launch
sirreal
committed
90db44d
Match HTML API launch preflight to selected tasks
sirreal
committed
15792fa
Validate HTML API round lifecycle artifacts
sirreal
committed
92ab8b7
Validate HTML API trial harness output before persist
sirreal
committed
c10f4d0
Clean up HTML API trial batch failures
sirreal
committed
9582628
Clean up HTML API judge ingest failures
sirreal
committed
bd4b2d3
Allow HTML API workflow args handoff files
sirreal
committed
f0b29ff
Clean up HTML API trial isolation failures
sirreal
committed
c71e79b
Try to not get stuck on goal
sirreal
committed
47b2154
Record round 18 workflow handoff
sirreal
committed
86a265d
Add local Codex trial runner
sirreal
committed
a3495aa
Update round 18 local runner handoff
sirreal
committed
b57bbba
Surface local trial runner in audit
sirreal
committed
edf372a
Fix Codex trial runner approval config
sirreal
committed
da48a49
Embed local runner trial inputs
sirreal
committed
dbda405
Ingest round 18 trial artifacts
sirreal
committed
a58f43e
Add local Codex judge runner
sirreal
committed
369593a
Surface local judge runner in audit
sirreal
committed
6815e3b
Update round 18 judge handoff
sirreal
committed
aeef196
Record local judge runner approval
sirreal
committed
e656643
Fix Codex judge runner schema
sirreal
committed
69a99ba
Score round 18 current-corpus baseline
sirreal
committed
b4e2158
Add local Codex discoverability probe runner
sirreal
committed
7436145
Fix Codex probe runner isolated workdir
sirreal
committed
6651d33
Record incomplete-token discoverability probe
sirreal
committed
382a04c
Keep probe artifacts outside scored rounds
sirreal
committed
012dabb
Add HTML Processor region-scan recipe
sirreal
committed
1726193
Score round 19 region-scan recipe
sirreal
committed
881fba4
Record text-content discoverability probe
sirreal
committed
528361b
Score round 20 low-effort calibration
sirreal
committed
cccb11d
Record generic recipe discoverability probe
sirreal
committed
29d2511
Add HTML Processor text and rewrite recipes
sirreal
committed
27077e0
Score round 21 HTML Processor recipes
sirreal
committed
0a0b406
Score round 22 current-docs calibration
sirreal
committed
bd624d8
Record Tag Processor text-boundary probe
sirreal
committed
dfb84bb
Clarify Tag Processor text-token recipe boundary
sirreal
committed
f7c83bf
Score round 23 Tag Processor text boundary
sirreal
committed
050b1b4
Score round 24 checkpoint
sirreal
committed
0dd50bc
Record read-only text policy probe
sirreal
committed
25f2f4f
Score text policy scratch A/B
sirreal
committed
3d6e1da
Score ordinary text scratch A/B
sirreal
committed
3af3535
Clarify ordinary subtree text policy
sirreal
committed
95173a4
Score ordinary subtree text policy
sirreal
committed
f3e8132
Record next_tag cursor probe
sirreal
committed
ac5dbf2
Score next_tag cursor scratch A/B
sirreal
committed
c3660cd
Clarify HTML Processor next_tag cursor searches
sirreal
committed
19a49c1
Score HTML Processor next_tag cursor source edit
sirreal
committed
bbe6768
Reconcile next diagnostic action
sirreal
committed
22f26cf
Score depth-bounded traversal scratch A/B
sirreal
committed
5151e1f
Teach audit about diagnostic subset rounds
sirreal
committed
b87cf80
Run checkpoint before traversal card promotion
sirreal
committed
bb760eb
Teach audit about checkpoint rounds
sirreal
committed
ba25ad6
Record traversal card promotion action
sirreal
committed
77ec812
Document depth-bounded traversal recipe
sirreal
committed
6548356
Teach audit to score source hypotheses
sirreal
committed
4a39f78
Score depth traversal recipe source edit
sirreal
committed
8ca976b
Test method-local text policy scratch variant
sirreal
committed
aa2b580
Probe serialize token fallback policy
sirreal
committed
95739cd
Test serialization fallback scratch variant
sirreal
committed
babc0b1
Run fallback policy checkpoint
sirreal
committed
c5dacae
Document serialization rewrite fallback policy
sirreal
committed
27c764f
Score serialization fallback source edit
sirreal
committed
ac41d64
Test text policy decision table scratch variant
sirreal
committed
8441f6b
Run text policy checkpoint
sirreal
committed
44facea
Document HTML Processor text extraction policy
sirreal
committed
29a148a
Score text extraction policy source edit
sirreal
committed
09aed17
Test read-only extraction completion policy
sirreal
committed
9aaa0ce
Run read-only policy checkpoint
sirreal
committed
feca7c2
Calibrate lower reasoning weak tier
sirreal
committed
5edc48f
Teach audit weak-tier ladder
sirreal
committed
65e60e6
Calibrate mini high weak tier
sirreal
committed
2e163c0
Calibrate mini low weak tier
sirreal
committed
b6dd751
Run serialization fallback A/B control
sirreal
committed
33764b4
Test serialization rewrite fallback card
sirreal
committed
feda3a6
Document HTML Processor rewrite fallback policy
sirreal
committed
1c0fabd
Record source score subject tier
sirreal
committed
1107adb
Score rewrite fallback source edit
sirreal
committed
b8ca8b2
Teach audit checkpoint next action
sirreal
committed
75137f5
Allow prepared round artifacts in audit
sirreal
committed
d019629
Checkpoint rewrite fallback source edit
sirreal
committed
14ce436
Teach audit diagnostic subset lifecycle
sirreal
committed
f5f875a
Run traversal boundary A/B control
sirreal
committed
29eb033
Run traversal boundary A/B variant
sirreal
committed
f791b3e
Run bounded traversal A/B variant
sirreal
committed
625debc
Probe traversal contract discoverability
sirreal
committed
a1286c1
Clarify weak-tier probe followup
sirreal
committed
abe45c5
Probe attribute value contract
sirreal
committed
0d80a17
Pause exhausted traversal diagnostics
sirreal
committed
e8c85ad
Clarify signal exhaustion pause
sirreal
committed
727e824
Run public API ablation
sirreal
committed
28c659c
Run text policy ablation
sirreal
committed
3ac780c
Run roadmap prose ablation
sirreal
committed
7496ea3
Run bookmark contract ablation
sirreal
committed
85a728f
Run processor choice ablation
sirreal
committed
57591ea
Run processor choice control ablation
sirreal
committed
f3915d3
Reconcile reduction pause policy
sirreal
committed
869af94

Commits on Jun 14, 2026

Record additional reduction queue
sirreal
committed
8ffc170
Run property section ablation
sirreal
committed
989f98e
Run HTML Processor internal detail ablation
sirreal
committed
7a58578
Run Tag Processor helper detail ablation
sirreal
committed
0de0504
Run private method index pruning
sirreal
committed
e6c5bb3
Run design limitations compression
sirreal
committed
aa66a06
Run unsupported features compression
sirreal
committed
4f2a063
Run CSS class example compression
sirreal
committed
4373391
Run attribute template example compression
sirreal
committed
ddf36bf
Run bookmark overview example deduplication
sirreal
committed
e90d594
Run inherited helper stubs
sirreal
committed
716f767
Run private helper pruning confirmation
sirreal
committed
ee11195
Run private helper pruning salvage
sirreal
committed
be1c45e
Clarify bounded subtree scans
sirreal
committed
7953a2b
Score bounded subtree scan clarification
sirreal
committed
d6a9335
Run method-local boundary warning scratch test
sirreal
committed
3ba3b87

Commits on Jul 22, 2026

Merge branch 'trunk' into html-api-docs-improvement
sirreal
authored
aad14e0