toc-file is declared in action.yml, documented with a default in docs/user/action-reference.md:60, parsed into ActionInputs.tocFile, and asserted by a unit test — and read by nothing. grep -rn "\.tocFile" src/ | grep -v __tests__ returns nothing. The published Action interface has 11 documented inputs and one of them is a lie.
Delete it; do not wire it. Found independently by four separate audit passes.
Also: two user docs promise that any language code works, while the action throws on anything but zh-cn/fa/fr.
Findings covered
6 audit findings land here. F<n> are stable references into the audit; rank is the report ordering (1 = act first of 139).
Plan
Estimate 9h · Rebuilds dist-action/ yes · Wave 1, PR J
Dead inputs. F12 + F67 + F71 + F102 + F128 — delete toc-file from action.yml, ActionInputs, inputs.ts, the default-pinning test and the docs row; F126 correct the three docs that promise any language code works
From the technical-debt audit of 2026-07-23 (141 candidates adversarially verified, re-validated against v0.23.0, 139 live). Effort is stopgap / full — t≈0.5h, s≈3.5h, m≈11h, L≈28h. Items marked ½ were partially addressed by v0.22.0/v0.23.0.
toc-fileis declared inaction.yml, documented with a default indocs/user/action-reference.md:60, parsed intoActionInputs.tocFile, and asserted by a unit test — and read by nothing.grep -rn "\.tocFile" src/ | grep -v __tests__returns nothing. The published Action interface has 11 documented inputs and one of them is a lie.Delete it; do not wire it. Found independently by four separate audit passes.
Also: two user docs promise that any language code works, while the action throws on anything but
zh-cn/fa/fr.Findings covered
6 audit findings land here.
F<n>are stable references into the audit; rank is the report ordering (1 = act first of 139).F12· rank 58 · low · t/t —toc-fileis a fully dead input: declared, documented, parsed, typed, unit-tested, zero consumersF67· rank 59 · low · t/t — The published input reference advertisestoc-fileas a working knobF71· rank 60 · low · t/t — The same input, delete-don't-wire framingF102· rank 61 · low · t/t — The same input, silently overridden by a hardcoded_toc.ymlF128· rank 62 · med · s/s — The same input, advertised with a default, wired to nothingF126· rank 131 · med · s/s — Three user docs promise any language code works;getInputs()throws on anything but en/zh-cn/fa/frPlan
Estimate 9h · Rebuilds
dist-action/yes · Wave 1, PR JDead inputs.
F12+F67+F71+F102+F128— deletetoc-filefromaction.yml,ActionInputs,inputs.ts, the default-pinning test and the docs row;F126correct the three docs that promise any language code worksFrom the technical-debt audit of 2026-07-23 (141 candidates adversarially verified, re-validated against v0.23.0, 139 live). Effort is stopgap / full — t≈0.5h, s≈3.5h, m≈11h, L≈28h. Items marked ½ were partially addressed by v0.22.0/v0.23.0.