paperlint 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (762) hide show
  1. package/.github/dependabot.yml +72 -0
  2. package/.github/workflows/ci.yml +297 -0
  3. package/.github/workflows/dependabot-automerge.yml +70 -0
  4. package/.github/workflows/pr-title.yml +59 -0
  5. package/.github/workflows/release.yml +54 -0
  6. package/CLAUDE.md +598 -0
  7. package/CONTRIBUTING.md +159 -0
  8. package/LICENSE +21 -0
  9. package/README.md +240 -0
  10. package/action.harness.mjs +287 -0
  11. package/action.mutations.mjs +162 -0
  12. package/action.yml +138 -0
  13. package/bin/rpp.mjs +43 -0
  14. package/dist/action-ref.d.ts +12 -0
  15. package/dist/action-ref.d.ts.map +1 -0
  16. package/dist/action-ref.js +16 -0
  17. package/dist/action-ref.js.map +1 -0
  18. package/dist/adapters/banal/failure.d.ts +73 -0
  19. package/dist/adapters/banal/failure.d.ts.map +1 -0
  20. package/dist/adapters/banal/failure.js +58 -0
  21. package/dist/adapters/banal/failure.js.map +1 -0
  22. package/dist/adapters/banal/index.d.ts +17 -0
  23. package/dist/adapters/banal/index.d.ts.map +1 -0
  24. package/dist/adapters/banal/index.js +56 -0
  25. package/dist/adapters/banal/index.js.map +1 -0
  26. package/dist/adapters/banal/install.d.ts +26 -0
  27. package/dist/adapters/banal/install.d.ts.map +1 -0
  28. package/dist/adapters/banal/install.js +15 -0
  29. package/dist/adapters/banal/install.js.map +1 -0
  30. package/dist/adapters/banal/invocation.d.ts +48 -0
  31. package/dist/adapters/banal/invocation.d.ts.map +1 -0
  32. package/dist/adapters/banal/invocation.js +43 -0
  33. package/dist/adapters/banal/invocation.js.map +1 -0
  34. package/dist/adapters/banal/locate.d.ts +50 -0
  35. package/dist/adapters/banal/locate.d.ts.map +1 -0
  36. package/dist/adapters/banal/locate.js +34 -0
  37. package/dist/adapters/banal/locate.js.map +1 -0
  38. package/dist/adapters/banal/output.d.ts +27 -0
  39. package/dist/adapters/banal/output.d.ts.map +1 -0
  40. package/dist/adapters/banal/output.js +112 -0
  41. package/dist/adapters/banal/output.js.map +1 -0
  42. package/dist/adapters/banal/pin.d.ts +19 -0
  43. package/dist/adapters/banal/pin.d.ts.map +1 -0
  44. package/dist/adapters/banal/pin.js +15 -0
  45. package/dist/adapters/banal/pin.js.map +1 -0
  46. package/dist/adapters/banal/probe.d.ts +12 -0
  47. package/dist/adapters/banal/probe.d.ts.map +1 -0
  48. package/dist/adapters/banal/probe.js +27 -0
  49. package/dist/adapters/banal/probe.js.map +1 -0
  50. package/dist/adapters/banal/run.d.ts +89 -0
  51. package/dist/adapters/banal/run.d.ts.map +1 -0
  52. package/dist/adapters/banal/run.js +104 -0
  53. package/dist/adapters/banal/run.js.map +1 -0
  54. package/dist/adapters/banal/settings.d.ts +18 -0
  55. package/dist/adapters/banal/settings.d.ts.map +1 -0
  56. package/dist/adapters/banal/settings.js +29 -0
  57. package/dist/adapters/banal/settings.js.map +1 -0
  58. package/dist/adapters/banal/xml.d.ts +48 -0
  59. package/dist/adapters/banal/xml.d.ts.map +1 -0
  60. package/dist/adapters/banal/xml.js +67 -0
  61. package/dist/adapters/banal/xml.js.map +1 -0
  62. package/dist/adapters/curl/download.io.d.ts +14 -0
  63. package/dist/adapters/curl/download.io.d.ts.map +1 -0
  64. package/dist/adapters/curl/download.io.js +69 -0
  65. package/dist/adapters/curl/download.io.js.map +1 -0
  66. package/dist/adapters/curl/index.d.ts +6 -0
  67. package/dist/adapters/curl/index.d.ts.map +1 -0
  68. package/dist/adapters/curl/index.js +6 -0
  69. package/dist/adapters/curl/index.js.map +1 -0
  70. package/dist/adapters/memory/index.d.ts +43 -0
  71. package/dist/adapters/memory/index.d.ts.map +1 -0
  72. package/dist/adapters/memory/index.js +79 -0
  73. package/dist/adapters/memory/index.js.map +1 -0
  74. package/dist/adapters/node/files.io.d.ts +3 -0
  75. package/dist/adapters/node/files.io.d.ts.map +1 -0
  76. package/dist/adapters/node/files.io.js +31 -0
  77. package/dist/adapters/node/files.io.js.map +1 -0
  78. package/dist/adapters/node/host.io.d.ts +3 -0
  79. package/dist/adapters/node/host.io.d.ts.map +1 -0
  80. package/dist/adapters/node/host.io.js +14 -0
  81. package/dist/adapters/node/host.io.js.map +1 -0
  82. package/dist/adapters/node/index.d.ts +25 -0
  83. package/dist/adapters/node/index.d.ts.map +1 -0
  84. package/dist/adapters/node/index.js +14 -0
  85. package/dist/adapters/node/index.js.map +1 -0
  86. package/dist/adapters/node/process.io.d.ts +14 -0
  87. package/dist/adapters/node/process.io.d.ts.map +1 -0
  88. package/dist/adapters/node/process.io.js +41 -0
  89. package/dist/adapters/node/process.io.js.map +1 -0
  90. package/dist/adapters/node/workspace.io.d.ts +4 -0
  91. package/dist/adapters/node/workspace.io.d.ts.map +1 -0
  92. package/dist/adapters/node/workspace.io.js +33 -0
  93. package/dist/adapters/node/workspace.io.js.map +1 -0
  94. package/dist/adapters/pdfjs/fill.d.ts +42 -0
  95. package/dist/adapters/pdfjs/fill.d.ts.map +1 -0
  96. package/dist/adapters/pdfjs/fill.js +91 -0
  97. package/dist/adapters/pdfjs/fill.js.map +1 -0
  98. package/dist/build-engine.d.ts +48 -0
  99. package/dist/build-engine.d.ts.map +1 -0
  100. package/dist/build-engine.js +148 -0
  101. package/dist/build-engine.js.map +1 -0
  102. package/dist/build.d.ts +163 -0
  103. package/dist/build.d.ts.map +1 -0
  104. package/dist/build.js +575 -0
  105. package/dist/build.js.map +1 -0
  106. package/dist/cli.d.ts +151 -0
  107. package/dist/cli.d.ts.map +1 -0
  108. package/dist/cli.js +951 -0
  109. package/dist/cli.js.map +1 -0
  110. package/dist/doctor.d.ts +42 -0
  111. package/dist/doctor.d.ts.map +1 -0
  112. package/dist/doctor.js +280 -0
  113. package/dist/doctor.js.map +1 -0
  114. package/dist/domain/geometry.d.ts +71 -0
  115. package/dist/domain/geometry.d.ts.map +1 -0
  116. package/dist/domain/geometry.js +35 -0
  117. package/dist/domain/geometry.js.map +1 -0
  118. package/dist/domain/host.d.ts +16 -0
  119. package/dist/domain/host.d.ts.map +1 -0
  120. package/dist/domain/host.js +8 -0
  121. package/dist/domain/host.js.map +1 -0
  122. package/dist/domain/page-layout.d.ts +34 -0
  123. package/dist/domain/page-layout.d.ts.map +1 -0
  124. package/dist/domain/page-layout.js +8 -0
  125. package/dist/domain/page-layout.js.map +1 -0
  126. package/dist/domain/paths.d.ts +5 -0
  127. package/dist/domain/paths.d.ts.map +1 -0
  128. package/dist/domain/paths.js +2 -0
  129. package/dist/domain/paths.js.map +1 -0
  130. package/dist/domain/result.d.ts +23 -0
  131. package/dist/domain/result.d.ts.map +1 -0
  132. package/dist/domain/result.js +10 -0
  133. package/dist/domain/result.js.map +1 -0
  134. package/dist/domain/sha256.d.ts +7 -0
  135. package/dist/domain/sha256.d.ts.map +1 -0
  136. package/dist/domain/sha256.js +14 -0
  137. package/dist/domain/sha256.js.map +1 -0
  138. package/dist/domain/text.d.ts +6 -0
  139. package/dist/domain/text.d.ts.map +1 -0
  140. package/dist/domain/text.js +7 -0
  141. package/dist/domain/text.js.map +1 -0
  142. package/dist/engine.d.ts +93 -0
  143. package/dist/engine.d.ts.map +1 -0
  144. package/dist/engine.js +119 -0
  145. package/dist/engine.js.map +1 -0
  146. package/dist/exit-code.d.ts +22 -0
  147. package/dist/exit-code.d.ts.map +1 -0
  148. package/dist/exit-code.js +10 -0
  149. package/dist/exit-code.js.map +1 -0
  150. package/dist/facts-file.d.ts +96 -0
  151. package/dist/facts-file.d.ts.map +1 -0
  152. package/dist/facts-file.js +134 -0
  153. package/dist/facts-file.js.map +1 -0
  154. package/dist/hooks-settings.d.ts +141 -0
  155. package/dist/hooks-settings.d.ts.map +1 -0
  156. package/dist/hooks-settings.js +306 -0
  157. package/dist/hooks-settings.js.map +1 -0
  158. package/dist/init.d.ts +201 -0
  159. package/dist/init.d.ts.map +1 -0
  160. package/dist/init.js +579 -0
  161. package/dist/init.js.map +1 -0
  162. package/dist/latex-log.d.ts +80 -0
  163. package/dist/latex-log.d.ts.map +1 -0
  164. package/dist/latex-log.js +187 -0
  165. package/dist/latex-log.js.map +1 -0
  166. package/dist/latex-loop.d.ts +129 -0
  167. package/dist/latex-loop.d.ts.map +1 -0
  168. package/dist/latex-loop.js +113 -0
  169. package/dist/latex-loop.js.map +1 -0
  170. package/dist/link-skills.d.ts +51 -0
  171. package/dist/link-skills.d.ts.map +1 -0
  172. package/dist/link-skills.js +199 -0
  173. package/dist/link-skills.js.map +1 -0
  174. package/dist/new-paper.d.ts +48 -0
  175. package/dist/new-paper.d.ts.map +1 -0
  176. package/dist/new-paper.js +110 -0
  177. package/dist/new-paper.js.map +1 -0
  178. package/dist/pdf-facts.d.ts +44 -0
  179. package/dist/pdf-facts.d.ts.map +1 -0
  180. package/dist/pdf-facts.js +239 -0
  181. package/dist/pdf-facts.js.map +1 -0
  182. package/dist/pdf-geometry.d.ts +170 -0
  183. package/dist/pdf-geometry.d.ts.map +1 -0
  184. package/dist/pdf-geometry.js +158 -0
  185. package/dist/pdf-geometry.js.map +1 -0
  186. package/dist/ports/download.d.ts +9 -0
  187. package/dist/ports/download.d.ts.map +1 -0
  188. package/dist/ports/download.js +2 -0
  189. package/dist/ports/download.js.map +1 -0
  190. package/dist/ports/files.d.ts +11 -0
  191. package/dist/ports/files.d.ts.map +1 -0
  192. package/dist/ports/files.js +2 -0
  193. package/dist/ports/files.js.map +1 -0
  194. package/dist/ports/measure-geometry.d.ts +8 -0
  195. package/dist/ports/measure-geometry.d.ts.map +1 -0
  196. package/dist/ports/measure-geometry.js +2 -0
  197. package/dist/ports/measure-geometry.js.map +1 -0
  198. package/dist/ports/process.d.ts +45 -0
  199. package/dist/ports/process.d.ts.map +1 -0
  200. package/dist/ports/process.js +2 -0
  201. package/dist/ports/process.js.map +1 -0
  202. package/dist/ports/tool-installer.d.ts +29 -0
  203. package/dist/ports/tool-installer.d.ts.map +1 -0
  204. package/dist/ports/tool-installer.js +2 -0
  205. package/dist/ports/tool-installer.js.map +1 -0
  206. package/dist/ports/workspace.d.ts +18 -0
  207. package/dist/ports/workspace.d.ts.map +1 -0
  208. package/dist/ports/workspace.js +2 -0
  209. package/dist/ports/workspace.js.map +1 -0
  210. package/dist/rules-config.d.ts +34 -0
  211. package/dist/rules-config.d.ts.map +1 -0
  212. package/dist/rules-config.js +132 -0
  213. package/dist/rules-config.js.map +1 -0
  214. package/dist/structure.d.ts +34 -0
  215. package/dist/structure.d.ts.map +1 -0
  216. package/dist/structure.js +149 -0
  217. package/dist/structure.js.map +1 -0
  218. package/dist/tex-requirements.d.ts +43 -0
  219. package/dist/tex-requirements.d.ts.map +1 -0
  220. package/dist/tex-requirements.js +127 -0
  221. package/dist/tex-requirements.js.map +1 -0
  222. package/dist/toolchain.d.ts +159 -0
  223. package/dist/toolchain.d.ts.map +1 -0
  224. package/dist/toolchain.js +542 -0
  225. package/dist/toolchain.js.map +1 -0
  226. package/dist/types.d.ts +110 -0
  227. package/dist/types.d.ts.map +1 -0
  228. package/dist/types.js +2 -0
  229. package/dist/types.js.map +1 -0
  230. package/docs/configuration.md +235 -0
  231. package/docs/e2e.md +152 -0
  232. package/docs/incidents.md +59 -0
  233. package/docs/install.md +170 -0
  234. package/docs/optional-rules.md +107 -0
  235. package/docs/package-shape-options.md +262 -0
  236. package/docs/prior-art/README.md +76 -0
  237. package/docs/prior-art/blocking-vs-advisory.md +83 -0
  238. package/docs/prior-art/content-delivery.md +124 -0
  239. package/docs/prior-art/multi-mode-tools.md +106 -0
  240. package/docs/prior-art/nondeterministic-checks.md +99 -0
  241. package/docs/prior-art/package-location.md +422 -0
  242. package/docs/prior-art/paper-folder-scaffolding.md +538 -0
  243. package/docs/prior-art/readme-structure.md +69 -0
  244. package/docs/prior-art/repro/README.md +92 -0
  245. package/docs/prior-art/repro/claim1-allowedtools.mjs +66 -0
  246. package/docs/prior-art/repro/claim1-at2.mjs +40 -0
  247. package/docs/prior-art/repro/claim1-crosschannel.mjs +54 -0
  248. package/docs/prior-art/repro/claim1-frontmatter.mjs +76 -0
  249. package/docs/prior-art/repro/claim1-hook-payload-reporter.mjs +10 -0
  250. package/docs/prior-art/repro/claim1-plugin-frontmatter.mjs +27 -0
  251. package/docs/prior-art/repro/claim1-plugin-skill.mjs +52 -0
  252. package/docs/prior-art/repro/claim1-project-skill.mjs +81 -0
  253. package/docs/prior-art/repro/claim2-marketplace-flat-asclaimed.json +1 -0
  254. package/docs/prior-art/repro/claim2-marketplace-negative-control.json +1 -0
  255. package/docs/prior-art/repro/claim2-marketplace-nested-exact.json +9 -0
  256. package/docs/prior-art/repro/claim2-marketplace-nested-noversion.json +9 -0
  257. package/docs/prior-art/repro/claim2-marketplace-nested-range.json +1 -0
  258. package/docs/prior-art/repro/claim3-imports.mjs +50 -0
  259. package/docs/prior-art/repro/claim4-find-package-json.mjs +8 -0
  260. package/docs/prior-art/repro/claim4-package-dir.mjs +39 -0
  261. package/docs/prior-art/repro/claim4-parent-arg.mjs +17 -0
  262. package/docs/prior-art/repro/claim4-resolve-apis.mjs +21 -0
  263. package/docs/prior-art/repro/claim4-setup-consumers.mjs +45 -0
  264. package/docs/prior-art/repro/claim4-yarn-pnp.mjs +70 -0
  265. package/docs/prior-art/repro/claim5-bin-launch.mjs +39 -0
  266. package/docs/prior-art/repro/claim5-exports-mutation.mjs +57 -0
  267. package/docs/prior-art/repro/claim5-resolved-location-and-bin.mjs +33 -0
  268. package/docs/prior-art/repro/claim6-candidate-ambiguity.mjs +17 -0
  269. package/docs/prior-art/repro/claim6-doc-path-candidates.mjs +27 -0
  270. package/docs/prior-art/test-tooling.md +131 -0
  271. package/docs/rules.md +58 -0
  272. package/docs/texlive-install-decision.md +230 -0
  273. package/docs/toolchain.md +152 -0
  274. package/eslint-rules/doc-fields.harness.mjs +336 -0
  275. package/eslint-rules/doc-fields.mjs +186 -0
  276. package/eslint-rules/doc-fields.mutations.mjs +96 -0
  277. package/eslint-rules/install-path-literals.harness.mjs +121 -0
  278. package/eslint-rules/install-path-literals.mjs +108 -0
  279. package/eslint-rules/install-path-literals.mutations.mjs +62 -0
  280. package/eslint-rules/latex-language.harness.mjs +599 -0
  281. package/eslint-rules/latex-language.mjs +591 -0
  282. package/eslint-rules/latex-language.mutations.mjs +196 -0
  283. package/eslint-rules/paper-research-question.harness.mjs +146 -0
  284. package/eslint-rules/paper-research-question.mjs +180 -0
  285. package/eslint-rules/paper-research-question.mutations.mjs +127 -0
  286. package/eslint-rules/paper-stages.harness.mjs +356 -0
  287. package/eslint-rules/paper-stages.mjs +455 -0
  288. package/eslint-rules/paper-stages.mutations.mjs +157 -0
  289. package/eslint-rules/paper-typography.harness.mjs +291 -0
  290. package/eslint-rules/paper-typography.mjs +313 -0
  291. package/eslint-rules/paper-typography.mutations.mjs +131 -0
  292. package/eslint-rules/papers.harness.mjs +259 -0
  293. package/eslint-rules/papers.mjs +166 -0
  294. package/eslint-rules/papers.mutations.mjs +186 -0
  295. package/eslint-rules/pdf-last-page-balance.harness.mjs +206 -0
  296. package/eslint-rules/pdf-last-page-balance.mjs +208 -0
  297. package/eslint-rules/review-findings-cause.harness.mjs +228 -0
  298. package/eslint-rules/review-findings-cause.mjs +135 -0
  299. package/eslint-rules/review-findings-cause.mutations.mjs +72 -0
  300. package/eslint-rules/temp-root-realpath.harness.mjs +176 -0
  301. package/eslint-rules/temp-root-realpath.mjs +129 -0
  302. package/eslint-rules/temp-root-realpath.mutations.mjs +99 -0
  303. package/eslint-rules/tex-build.harness.mjs +753 -0
  304. package/eslint-rules/tex-build.mjs +322 -0
  305. package/eslint-rules/tex-build.mutations.mjs +258 -0
  306. package/eslint.config.mjs +521 -0
  307. package/fixtures/build-e2e/acmart/PIPELINE-STATUS.md +3 -0
  308. package/fixtures/build-e2e/acmart/paper.tex +11 -0
  309. package/fixtures/build-e2e/acmart/venue.json +1 -0
  310. package/fixtures/build-e2e/broken/PIPELINE-STATUS.md +3 -0
  311. package/fixtures/build-e2e/broken/paper.tex +7 -0
  312. package/fixtures/build-e2e/cite/PIPELINE-STATUS.md +3 -0
  313. package/fixtures/build-e2e/cite/build.sh +5 -0
  314. package/fixtures/build-e2e/cite/paper.tex +10 -0
  315. package/fixtures/build-e2e/cite/refs.bib +9 -0
  316. package/fixtures/build-e2e/empty/PIPELINE-STATUS.md +3 -0
  317. package/fixtures/build-e2e/empty/paper.tex +6 -0
  318. package/fixtures/build-e2e/fallback/PIPELINE-STATUS.md +3 -0
  319. package/fixtures/build-e2e/fallback/paper.tex +11 -0
  320. package/fixtures/build-e2e/guards/PIPELINE-STATUS.md +3 -0
  321. package/fixtures/build-e2e/guards/paper.tex +10 -0
  322. package/fixtures/build-e2e/no-source/PIPELINE-STATUS.md +3 -0
  323. package/fixtures/build-e2e/unbalanced/PIPELINE-STATUS.md +3 -0
  324. package/fixtures/build-e2e/unbalanced/paper.tex +28 -0
  325. package/fixtures/build-e2e/unbalanced/refs.bib +269 -0
  326. package/fixtures/install-path-literals/clean.fixture.mjs +3 -0
  327. package/fixtures/install-path-literals/clean.md +15 -0
  328. package/fixtures/install-path-literals/defect.fixture.mjs +3 -0
  329. package/fixtures/install-path-literals/defect.md +14 -0
  330. package/fixtures/latex-language/clean.tex +50 -0
  331. package/fixtures/latex-language/defect.tex +52 -0
  332. package/fixtures/paper-research-question/comment-only/PIPELINE-STATUS.md +9 -0
  333. package/fixtures/paper-research-question/comment-only/paper.tex +7 -0
  334. package/fixtures/paper-research-question/declared-not-in-paper/PIPELINE-STATUS.md +10 -0
  335. package/fixtures/paper-research-question/declared-not-in-paper/paper.tex +6 -0
  336. package/fixtures/paper-research-question/draft/PIPELINE-STATUS.md +6 -0
  337. package/fixtures/paper-research-question/draft/paper.tex +2 -0
  338. package/fixtures/paper-research-question/markdown-no-rq/PIPELINE-STATUS.md +9 -0
  339. package/fixtures/paper-research-question/markdown-no-rq/paper.md +4 -0
  340. package/fixtures/paper-research-question/shipped-no-rq/PIPELINE-STATUS.md +12 -0
  341. package/fixtures/paper-research-question/shipped-no-rq/paper.tex +3 -0
  342. package/fixtures/paper-research-question/shipped-with-rq/PIPELINE-STATUS.md +10 -0
  343. package/fixtures/paper-research-question/shipped-with-rq/paper.tex +2 -0
  344. package/fixtures/paper-stages/authors-ran/PIPELINE-STATUS.md +16 -0
  345. package/fixtures/paper-stages/marker-in-prose/PIPELINE-STATUS.md +17 -0
  346. package/fixtures/paper-stages/nofile/PIPELINE-STATUS.md +8 -0
  347. package/fixtures/paper-stages/noheader/PIPELINE-STATUS.md +1 -0
  348. package/fixtures/paper-stages/noheader/versions/2026-07-22-submitted.pdf +0 -0
  349. package/fixtures/paper-stages/nothing/PIPELINE-STATUS.md +3 -0
  350. package/fixtures/paper-stages/ok/PIPELINE-STATUS.md +9 -0
  351. package/fixtures/paper-stages/ok/versions/2026-07-22-submitted.pdf +0 -0
  352. package/fixtures/paper-stages/stale/PIPELINE-STATUS.md +1 -0
  353. package/fixtures/paper-stages/stale/versions/2026-07-22-submitted.STALE-WRONG-FILE.pdf +0 -0
  354. package/fixtures/paper-stages/twice/PIPELINE-STATUS.md +14 -0
  355. package/fixtures/paper-stages/twice/versions/2026-08-06-submitted.pdf +0 -0
  356. package/fixtures/paper-stages/twice/versions/2026-10-24-submitted.pdf +0 -0
  357. package/fixtures/paper-stages/undeclared/PIPELINE-STATUS.md +8 -0
  358. package/fixtures/paper-stages/undeclared/versions/2026-07-22-submitted.pdf +0 -0
  359. package/fixtures/paper-stages/undeclared/versions/2026-08-29-camera-ready.pdf +0 -0
  360. package/fixtures/paper-stages/wrongsize/PIPELINE-STATUS.md +8 -0
  361. package/fixtures/paper-stages/wrongsize/versions/2026-07-22-submitted.pdf +0 -0
  362. package/fixtures/paper-typography/clean-paper/paper.tex +29 -0
  363. package/fixtures/paper-typography/messy-paper/paper.tex +27 -0
  364. package/fixtures/pdf-facts/README.md +22 -0
  365. package/fixtures/pdf-facts/corrupt-font.pdf +0 -0
  366. package/fixtures/pdf-facts/encrypted.pdf +0 -0
  367. package/fixtures/pdf-facts/hidden-text.pdf +0 -0
  368. package/fixtures/pdf-facts/hidden-text.tex +28 -0
  369. package/fixtures/pdf-facts/t3-all.pdf +0 -0
  370. package/fixtures/pdf-facts/t3-all.tex +8 -0
  371. package/fixtures/pdf-facts/t3-mixed.pdf +0 -0
  372. package/fixtures/pdf-facts/t3-mixed.tex +9 -0
  373. package/fixtures/pdf-facts/ttf.pdf +2240 -1
  374. package/fixtures/pdf-facts/ttf.tex +6 -0
  375. package/fixtures/real-markdown-paper/baseline.json +24 -0
  376. package/fixtures/real-markdown-paper/baseline.mjs +48 -0
  377. package/fixtures/render-paper/build-clean.sh +25 -0
  378. package/fixtures/render-paper/build-defect.sh +15 -0
  379. package/fixtures/review-findings-cause/clean.md +17 -0
  380. package/fixtures/review-findings-cause/defect.md +14 -0
  381. package/fixtures/review-findings-cause/old-debt.md +14 -0
  382. package/fixtures/review-findings-cause/quiet-in-fence.md +16 -0
  383. package/fixtures/tex-build/clean.tex +21 -0
  384. package/fixtures/tex-build/defect.tex +24 -0
  385. package/fixtures/tex-build/frontmatter-clean.tex +25 -0
  386. package/fixtures/tex-build/frontmatter-defect.tex +23 -0
  387. package/fixtures/toolchain-mirror/catalog.txt +5 -0
  388. package/fixtures/toolchain-mirror/install-tl +27 -0
  389. package/fixtures/toolchain-mirror/release-texlive.txt +3 -0
  390. package/fixtures/toolchain-mirror/release-year +1 -0
  391. package/fixtures/toolchain-mirror/stub-kpsewhich +8 -0
  392. package/fixtures/toolchain-mirror/stub-pdflatex +3 -0
  393. package/fixtures/toolchain-mirror/stub-tlmgr +44 -0
  394. package/hooks/hooks.harness.mjs +713 -0
  395. package/hooks/hooks.mutations.mjs +337 -0
  396. package/hooks/paper-edit-guard.hook.d.mts +13 -0
  397. package/hooks/paper-edit-guard.hook.mjs +457 -0
  398. package/hooks/paper-skills-nudge.hook.mjs +136 -0
  399. package/hooks/paper-status-gates.hook.mjs +156 -0
  400. package/hooks/paper-status-gates.sh +91 -0
  401. package/lib/agent-cli-version.harness.mjs +165 -0
  402. package/lib/agent-cli-version.mjs +106 -0
  403. package/lib/agent-cli-version.mutations.mjs +109 -0
  404. package/lib/markdown.mjs +386 -0
  405. package/lib/mutation-driver.harness.mjs +227 -0
  406. package/lib/mutation-driver.mjs +397 -0
  407. package/lib/mutation-driver.mutations.mjs +68 -0
  408. package/lib/paper-config.d.mts +34 -0
  409. package/lib/paper-config.harness.mjs +286 -0
  410. package/lib/paper-config.mjs +142 -0
  411. package/lib/paper-config.mutations.mjs +143 -0
  412. package/lib/skill-checks.mjs +701 -0
  413. package/lib/skill-corpus.mjs +403 -0
  414. package/lib/skill-eval-fixture.mjs +63 -0
  415. package/lib/skill-eval-kit.mjs +257 -0
  416. package/lib/skill-trigger-cases.harness.mjs +170 -0
  417. package/lib/skill-trigger-cases.mjs +446 -0
  418. package/lib/skill-trigger-cases.mutations.mjs +65 -0
  419. package/lib/trigger-ledger.mjs +215 -0
  420. package/package.json +97 -0
  421. package/plugin/.claude-plugin/plugin.json +8 -0
  422. package/plugin/hooks/hooks.json +30 -0
  423. package/scripts/check.harness.mjs +177 -0
  424. package/scripts/check.mjs +239 -0
  425. package/scripts/check.mutations.mjs +110 -0
  426. package/scripts/eslint-report-guard.mjs +82 -0
  427. package/scripts/exclusive.mjs +138 -0
  428. package/scripts/harness-api.frozen.json +76 -0
  429. package/scripts/harness-api.test.ts +175 -0
  430. package/scripts/layer-legacy-frozen.d.mts +28 -0
  431. package/scripts/layer-legacy-frozen.mjs +152 -0
  432. package/scripts/layer-legacy-frozen.test.ts +115 -0
  433. package/scripts/layer-legacy.frozen.json +50 -0
  434. package/scripts/mutation-batteries-frozen.harness.mjs +204 -0
  435. package/scripts/mutation-batteries-frozen.mjs +238 -0
  436. package/scripts/mutation-batteries.frozen.json +117 -0
  437. package/scripts/release-config.test.ts +90 -0
  438. package/scripts/rules-are-content-only.harness.mjs +113 -0
  439. package/scripts/rules-are-content-only.mjs +138 -0
  440. package/scripts/rules-are-content-only.mutations.mjs +81 -0
  441. package/scripts/rules-see-files.harness.mjs +115 -0
  442. package/scripts/rules-see-files.mjs +99 -0
  443. package/scripts/rules-see-files.mutations.mjs +131 -0
  444. package/scripts/run-mutations.mjs +100 -0
  445. package/scripts/semantic-release-plugins.d.ts +16 -0
  446. package/skills/README.md +15 -0
  447. package/skills/analyze-sibling-paper/SKILL.md +170 -0
  448. package/skills/analyze-sibling-paper/SKILL.md.spec.ts +186 -0
  449. package/skills/analyze-sibling-paper/analyze-sibling-paper.eval.mjs +19 -0
  450. package/skills/analyze-sibling-paper/analyze-sibling-paper.harness.mjs +23 -0
  451. package/skills/argument-arc/SKILL.md +177 -0
  452. package/skills/argument-arc/SKILL.md.spec.ts +192 -0
  453. package/skills/argument-arc/argument-arc.eval.mjs +19 -0
  454. package/skills/argument-arc/argument-arc.harness.mjs +23 -0
  455. package/skills/build-benchmark/SKILL.md +213 -0
  456. package/skills/build-benchmark/SKILL.md.spec.ts +220 -0
  457. package/skills/build-benchmark/build-benchmark.eval.mjs +19 -0
  458. package/skills/build-benchmark/build-benchmark.harness.mjs +23 -0
  459. package/skills/build-benchmark/references/adversarial-cold-repro.md +68 -0
  460. package/skills/camera-ready/SKILL.md +148 -0
  461. package/skills/camera-ready/SKILL.md.spec.ts +164 -0
  462. package/skills/camera-ready/camera-ready.eval.mjs +19 -0
  463. package/skills/camera-ready/camera-ready.harness.mjs +23 -0
  464. package/skills/cold-read-diff/SKILL.md +160 -0
  465. package/skills/cold-read-diff/SKILL.md.spec.ts +166 -0
  466. package/skills/cold-read-diff/cold-read-diff.eval.mjs +19 -0
  467. package/skills/cold-read-diff/cold-read-diff.harness.mjs +23 -0
  468. package/skills/draft-paper/SKILL.md +152 -0
  469. package/skills/draft-paper/SKILL.md.spec.ts +169 -0
  470. package/skills/draft-paper/draft-paper.eval.mjs +19 -0
  471. package/skills/draft-paper/draft-paper.harness.mjs +23 -0
  472. package/skills/extend-paper/SKILL.md +99 -0
  473. package/skills/extend-paper/SKILL.md.spec.ts +116 -0
  474. package/skills/extend-paper/extend-paper.eval.mjs +19 -0
  475. package/skills/extend-paper/extend-paper.harness.mjs +23 -0
  476. package/skills/find-venue/SKILL.md +128 -0
  477. package/skills/find-venue/SKILL.md.spec.ts +145 -0
  478. package/skills/find-venue/find-venue.eval.mjs +19 -0
  479. package/skills/find-venue/find-venue.harness.mjs +23 -0
  480. package/skills/grade-paper-writing/SKILL.md +436 -0
  481. package/skills/grade-paper-writing/SKILL.md.spec.ts +453 -0
  482. package/skills/grade-paper-writing/fixtures/control_gopen.txt +1 -0
  483. package/skills/grade-paper-writing/fixtures/control_human_paper.txt +1 -0
  484. package/skills/grade-paper-writing/fixtures/rewrite.txt +1 -0
  485. package/skills/grade-paper-writing/fixtures/specimen.txt +1 -0
  486. package/skills/grade-paper-writing/fixtures/structure-checks.md +22 -0
  487. package/skills/grade-paper-writing/grade-paper-writing.eval.mjs +19 -0
  488. package/skills/grade-paper-writing/grade-paper-writing.harness.mjs +23 -0
  489. package/skills/grade-paper-writing/prose-lint.mjs +713 -0
  490. package/skills/harden-paper/SKILL.md +318 -0
  491. package/skills/harden-paper/SKILL.md.spec.ts +336 -0
  492. package/skills/harden-paper/check-numbers.sh +33 -0
  493. package/skills/harden-paper/check-release-claims.sh +35 -0
  494. package/skills/harden-paper/fixtures/uncited-assertions-sample.md +43 -0
  495. package/skills/harden-paper/fixtures/uncited-assertions-sample.tex +77 -0
  496. package/skills/harden-paper/harden-paper.eval.mjs +19 -0
  497. package/skills/harden-paper/harden-paper.harness.mjs +23 -0
  498. package/skills/map-prior-work/SKILL.md +211 -0
  499. package/skills/map-prior-work/SKILL.md.spec.ts +227 -0
  500. package/skills/map-prior-work/map-prior-work.eval.mjs +19 -0
  501. package/skills/map-prior-work/map-prior-work.harness.mjs +23 -0
  502. package/skills/osf-artifact-upload/SKILL.md +52 -0
  503. package/skills/osf-artifact-upload/SKILL.md.spec.ts +59 -0
  504. package/skills/osf-artifact-upload/osf-artifact-upload.eval.mjs +22 -0
  505. package/skills/osf-artifact-upload/osf-artifact-upload.harness.mjs +103 -0
  506. package/skills/paper-adversarial-review/SKILL.md +126 -0
  507. package/skills/paper-adversarial-review/SKILL.md.spec.ts +142 -0
  508. package/skills/paper-adversarial-review/paper-adversarial-review.eval.mjs +19 -0
  509. package/skills/paper-adversarial-review/paper-adversarial-review.harness.mjs +23 -0
  510. package/skills/paper-pipeline/PIPELINE-MAP.md +371 -0
  511. package/skills/paper-pipeline/SKILL.md +499 -0
  512. package/skills/paper-pipeline/SKILL.md.spec.ts +517 -0
  513. package/skills/paper-pipeline/description-language.eval.mjs +347 -0
  514. package/skills/paper-pipeline/framing-vs-vocabulary.eval.mjs +891 -0
  515. package/skills/paper-pipeline/grade-paper-writing-ablation.eval.mjs +1254 -0
  516. package/skills/paper-pipeline/paper-pipeline.eval.mjs +22 -0
  517. package/skills/paper-pipeline/paper-pipeline.harness.mjs +143 -0
  518. package/skills/paper-pipeline/pipeline-firing.baseline.json +270 -0
  519. package/skills/paper-pipeline/pipeline-firing.eval.mjs +664 -0
  520. package/skills/paper-pipeline/pipeline-language.eval.mjs +672 -0
  521. package/skills/paper-pipeline/references/acceptance-gate.md +329 -0
  522. package/skills/paper-pipeline/references/acl-venue-rules.md +142 -0
  523. package/skills/paper-pipeline/references/anonymization.md +68 -0
  524. package/skills/paper-pipeline/references/artifact-checklist.md +93 -0
  525. package/skills/paper-pipeline/references/body-vs-appendix.md +97 -0
  526. package/skills/paper-pipeline/references/credit-criteria.md +69 -0
  527. package/skills/paper-pipeline/references/occupancy-2026-08-06-probe/README.md +35 -0
  528. package/skills/paper-pipeline/references/occupancy-2026-08-06-probe/run_retext.mjs +24 -0
  529. package/skills/paper-pipeline/references/occupancy-2026-08-06-probe/sentences.txt +11 -0
  530. package/skills/paper-pipeline/references/occupancy-2026-08-06-probe/test_sentences.py +25 -0
  531. package/skills/paper-pipeline/references/occupancy-2026-08-06-prose-checkers.md +538 -0
  532. package/skills/paper-pipeline/references/occupancy-2026-08-06-reproducible-tooling.md +431 -0
  533. package/skills/paper-pipeline/references/occupancy-2026-08-06-staleness-and-orchestration.md +592 -0
  534. package/skills/paper-pipeline/references/pipeline-status-template.md +162 -0
  535. package/skills/paper-pipeline/references/review-ratchet.md +36 -0
  536. package/skills/paper-pipeline/references/sweep-2026-08-09-ideal-pipeline.md +585 -0
  537. package/skills/paper-pipeline/references/writing-craft.md +448 -0
  538. package/skills/paper-pipeline/repro/2026-08-07-description-language-control.log +63 -0
  539. package/skills/paper-pipeline/repro/2026-08-07-fork-check.log +52 -0
  540. package/skills/paper-pipeline/repro/2026-08-07-fork-check2.log +33 -0
  541. package/skills/paper-pipeline/repro/2026-08-07-language-eval-pilot.log +33 -0
  542. package/skills/paper-pipeline/repro/2026-08-07-language-eval-raw.log +166 -0
  543. package/skills/paper-pipeline/repro/2026-08-08-framing-vs-vocabulary-oracle.json +338 -0
  544. package/skills/paper-pipeline/repro/2026-08-08-framing-vs-vocabulary-oracle.log +118 -0
  545. package/skills/paper-pipeline/repro/2026-08-08-framing-vs-vocabulary-raw.log +245 -0
  546. package/skills/paper-pipeline/repro/2026-08-08-framing-vs-vocabulary.json +776 -0
  547. package/skills/paper-pipeline/repro/2026-08-08-grade-paper-writing-ablation-A6-oracle.log +53 -0
  548. package/skills/paper-pipeline/repro/2026-08-08-grade-paper-writing-ablation-A6-raw.log +89 -0
  549. package/skills/paper-pipeline/repro/2026-08-08-grade-paper-writing-ablation-oracle.json +450 -0
  550. package/skills/paper-pipeline/repro/2026-08-08-grade-paper-writing-ablation-oracle.log +136 -0
  551. package/skills/paper-pipeline/repro/2026-08-08-grade-paper-writing-ablation-raw.log +242 -0
  552. package/skills/paper-pipeline/repro/2026-08-08-grade-paper-writing-ablation-setupdiff.log +59 -0
  553. package/skills/paper-pipeline/repro/2026-08-08-grade-paper-writing-ablation.json +1032 -0
  554. package/skills/paper-pipeline/repro/2026-08-08-parent-replication-gpw.json +139 -0
  555. package/skills/paper-pipeline/repro/2026-08-08-parent-replication-gpw.log +98 -0
  556. package/skills/paper-pipeline/repro/2026-08-08-parent-replication.mjs +92 -0
  557. package/skills/paper-pipeline/repro/README.md +129 -0
  558. package/skills/paper-pipeline/repro/analyze-language-eval.py +116 -0
  559. package/skills/paper-pipeline/scripts/README.md +344 -0
  560. package/skills/paper-pipeline/scripts/announce.mjs +67 -0
  561. package/skills/paper-pipeline/scripts/artifact-coverage.harness.mjs +496 -0
  562. package/skills/paper-pipeline/scripts/artifact-coverage.mjs +397 -0
  563. package/skills/paper-pipeline/scripts/artifact-coverage.mutations.mjs +218 -0
  564. package/skills/paper-pipeline/scripts/check-provenance.mjs +184 -0
  565. package/skills/paper-pipeline/scripts/consumer.d.mts +32 -0
  566. package/skills/paper-pipeline/scripts/consumer.harness.mjs +562 -0
  567. package/skills/paper-pipeline/scripts/consumer.mjs +535 -0
  568. package/skills/paper-pipeline/scripts/consumer.mutations.mjs +190 -0
  569. package/skills/paper-pipeline/scripts/extract-ref-facts.harness.mjs +457 -0
  570. package/skills/paper-pipeline/scripts/extract-ref-facts.mjs +656 -0
  571. package/skills/paper-pipeline/scripts/extract-ref-facts.mutations.mjs +54 -0
  572. package/skills/paper-pipeline/scripts/fixtures/clean/PIPELINE-STATUS.md +51 -0
  573. package/skills/paper-pipeline/scripts/fixtures/dirty/PIPELINE-STATUS.md +52 -0
  574. package/skills/paper-pipeline/scripts/fixtures/dirty/paper.md +6 -0
  575. package/skills/paper-pipeline/scripts/fixtures/real-bib/refs.bib +153 -0
  576. package/skills/paper-pipeline/scripts/generated-code.harness.mjs +466 -0
  577. package/skills/paper-pipeline/scripts/generated-code.mjs +338 -0
  578. package/skills/paper-pipeline/scripts/generated-code.mutations.mjs +254 -0
  579. package/skills/paper-pipeline/scripts/ledger.mjs +623 -0
  580. package/skills/paper-pipeline/scripts/ledger.selftest.mjs +286 -0
  581. package/skills/paper-pipeline/scripts/pipeline-check.harness.mjs +389 -0
  582. package/skills/paper-pipeline/scripts/pipeline-check.mjs +737 -0
  583. package/skills/paper-pipeline/scripts/pipeline-check.mutations.mjs +54 -0
  584. package/skills/paper-pipeline/scripts/pipeline-edges.mjs +169 -0
  585. package/skills/paper-pipeline/scripts/population-map.harness.mjs +178 -0
  586. package/skills/paper-pipeline/scripts/population-map.mjs +181 -0
  587. package/skills/paper-pipeline/scripts/population-map.mutations.mjs +65 -0
  588. package/skills/paper-pipeline/scripts/population-map.selftest.mjs +122 -0
  589. package/skills/paper-pipeline/scripts/provenance.harness.mjs +240 -0
  590. package/skills/paper-pipeline/scripts/provenance.mutations.mjs +59 -0
  591. package/skills/paper-pipeline/scripts/round-diff.harness.mjs +881 -0
  592. package/skills/paper-pipeline/scripts/round-diff.mjs +576 -0
  593. package/skills/paper-pipeline/scripts/round-diff.mutations.mjs +276 -0
  594. package/skills/paper-pipeline/scripts/run-mechanical.mjs +633 -0
  595. package/skills/paper-pipeline/scripts/status.mjs +295 -0
  596. package/skills/paper-status/SKILL.md +183 -0
  597. package/skills/paper-status/SKILL.md.spec.ts +190 -0
  598. package/skills/paper-status/paper-status.eval.mjs +22 -0
  599. package/skills/paper-status/paper-status.harness.mjs +25 -0
  600. package/skills/pc-panel-review/SKILL.md +263 -0
  601. package/skills/pc-panel-review/SKILL.md.spec.ts +280 -0
  602. package/skills/pc-panel-review/pc-panel-review.eval.mjs +19 -0
  603. package/skills/pc-panel-review/pc-panel-review.harness.mjs +23 -0
  604. package/skills/plan-paper-timeline/SKILL.md +182 -0
  605. package/skills/plan-paper-timeline/SKILL.md.spec.ts +200 -0
  606. package/skills/plan-paper-timeline/fixtures/fake-google-calendar.mjs +239 -0
  607. package/skills/plan-paper-timeline/plan-paper-timeline.effects.harness.mjs +431 -0
  608. package/skills/plan-paper-timeline/plan-paper-timeline.effects.mutations.mjs +65 -0
  609. package/skills/plan-paper-timeline/plan-paper-timeline.eval.mjs +19 -0
  610. package/skills/plan-paper-timeline/plan-paper-timeline.harness.mjs +23 -0
  611. package/skills/render-paper/SKILL.md +159 -0
  612. package/skills/render-paper/SKILL.md.spec.ts +166 -0
  613. package/skills/render-paper/check-render.sh +419 -0
  614. package/skills/render-paper/checkers-requirements.txt +55 -0
  615. package/skills/render-paper/ensure-checkers.sh +69 -0
  616. package/skills/render-paper/extract-pdf-facts.harness.mjs +166 -0
  617. package/skills/render-paper/extract-pdf-facts.mjs +144 -0
  618. package/skills/render-paper/render-paper.eval.mjs +19 -0
  619. package/skills/render-paper/render-paper.harness.mjs +339 -0
  620. package/skills/research-ideate/SKILL.md +136 -0
  621. package/skills/research-ideate/SKILL.md.spec.ts +152 -0
  622. package/skills/research-ideate/research-ideate.eval.mjs +19 -0
  623. package/skills/research-ideate/research-ideate.harness.mjs +23 -0
  624. package/skills/skill-contract.mutations.mjs +179 -0
  625. package/skills/study-accepted-papers/SKILL.md +206 -0
  626. package/skills/study-accepted-papers/SKILL.md.spec.ts +223 -0
  627. package/skills/study-accepted-papers/study-accepted-papers.eval.mjs +19 -0
  628. package/skills/study-accepted-papers/study-accepted-papers.harness.mjs +23 -0
  629. package/skills/submit-paper/SKILL.md +182 -0
  630. package/skills/submit-paper/SKILL.md.spec.ts +199 -0
  631. package/skills/submit-paper/check-deanon.sh +149 -0
  632. package/skills/submit-paper/references/publishers/acm.md +92 -0
  633. package/skills/submit-paper/references/venues/agenticdev.jsonc +108 -0
  634. package/skills/submit-paper/references/venues/agenticdev.md +139 -0
  635. package/skills/submit-paper/references/venues/agenticdev.tex +19 -0
  636. package/skills/submit-paper/references/venues/aisec.jsonc +101 -0
  637. package/skills/submit-paper/references/venues/aisec.md +105 -0
  638. package/skills/submit-paper/references/venues/paper-guards.tex +41 -0
  639. package/skills/submit-paper/references/venues/realm.jsonc +81 -0
  640. package/skills/submit-paper/references/venues/realm.md +155 -0
  641. package/skills/submit-paper/references/venues/tex-base.jsonc +50 -0
  642. package/skills/submit-paper/references/venues/venue-profile.schema.json +74 -0
  643. package/skills/submit-paper/submit-paper.eval.mjs +19 -0
  644. package/skills/submit-paper/submit-paper.harness.mjs +23 -0
  645. package/skills/sweep-design-space/SKILL.md +269 -0
  646. package/skills/sweep-design-space/SKILL.md.spec.ts +285 -0
  647. package/skills/sweep-design-space/sweep-design-space.eval.mjs +19 -0
  648. package/skills/sweep-design-space/sweep-design-space.harness.mjs +23 -0
  649. package/skills/tighten-paper/SKILL.md +368 -0
  650. package/skills/tighten-paper/SKILL.md.spec.ts +384 -0
  651. package/skills/tighten-paper/structure.mjs +371 -0
  652. package/skills/tighten-paper/tighten-paper.eval.mjs +19 -0
  653. package/skills/tighten-paper/tighten-paper.harness.mjs +23 -0
  654. package/skills/verify-citations/SKILL.md +328 -0
  655. package/skills/verify-citations/SKILL.md.spec.ts +345 -0
  656. package/skills/verify-citations/scripts/bib-authors.mjs +479 -0
  657. package/skills/verify-citations/scripts/bib-authors.test.mjs +175 -0
  658. package/skills/verify-citations/scripts/verify-cites.mjs +1108 -0
  659. package/skills/verify-citations/scripts/verify-cites.test.mjs +735 -0
  660. package/skills/verify-citations/verify-citations.eval.mjs +19 -0
  661. package/skills/verify-citations/verify-citations.harness.mjs +23 -0
  662. package/src/CLAUDE.md +51 -0
  663. package/src/action-ref.test.ts +26 -0
  664. package/src/action-ref.ts +15 -0
  665. package/src/adapters/banal/failure.test.ts +63 -0
  666. package/src/adapters/banal/failure.ts +118 -0
  667. package/src/adapters/banal/index.test.ts +119 -0
  668. package/src/adapters/banal/index.ts +100 -0
  669. package/src/adapters/banal/install.test.ts +20 -0
  670. package/src/adapters/banal/install.ts +41 -0
  671. package/src/adapters/banal/invocation.test.ts +74 -0
  672. package/src/adapters/banal/invocation.ts +95 -0
  673. package/src/adapters/banal/locate.test.ts +52 -0
  674. package/src/adapters/banal/locate.ts +84 -0
  675. package/src/adapters/banal/output.test.ts +140 -0
  676. package/src/adapters/banal/output.ts +141 -0
  677. package/src/adapters/banal/pin.ts +30 -0
  678. package/src/adapters/banal/probe.ts +35 -0
  679. package/src/adapters/banal/run.test.ts +191 -0
  680. package/src/adapters/banal/run.ts +244 -0
  681. package/src/adapters/banal/settings.test.ts +31 -0
  682. package/src/adapters/banal/settings.ts +55 -0
  683. package/src/adapters/banal/xml.test.ts +111 -0
  684. package/src/adapters/banal/xml.ts +112 -0
  685. package/src/adapters/curl/download.io.ts +73 -0
  686. package/src/adapters/curl/download.test.ts +55 -0
  687. package/src/adapters/curl/index.ts +5 -0
  688. package/src/adapters/memory/index.ts +131 -0
  689. package/src/adapters/node/files.io.ts +39 -0
  690. package/src/adapters/node/files.test.ts +28 -0
  691. package/src/adapters/node/host.io.ts +15 -0
  692. package/src/adapters/node/index.ts +36 -0
  693. package/src/adapters/node/process.io.ts +49 -0
  694. package/src/adapters/node/process.test.ts +46 -0
  695. package/src/adapters/node/workspace.io.ts +40 -0
  696. package/src/adapters/node/workspace.test.ts +58 -0
  697. package/src/adapters/pdfjs/fill.test.ts +111 -0
  698. package/src/adapters/pdfjs/fill.ts +141 -0
  699. package/src/build-engine.harness.mjs +314 -0
  700. package/src/build-engine.ts +219 -0
  701. package/src/build.harness.mjs +631 -0
  702. package/src/build.mutations.mjs +195 -0
  703. package/src/build.ts +793 -0
  704. package/src/cli.harness.mjs +2007 -0
  705. package/src/cli.mutations.mjs +448 -0
  706. package/src/cli.ts +1189 -0
  707. package/src/doctor.harness.mjs +396 -0
  708. package/src/doctor.mutations.mjs +175 -0
  709. package/src/doctor.ts +356 -0
  710. package/src/domain/geometry.ts +108 -0
  711. package/src/domain/host.ts +23 -0
  712. package/src/domain/page-layout.ts +32 -0
  713. package/src/domain/paths.ts +5 -0
  714. package/src/domain/result.test.ts +26 -0
  715. package/src/domain/result.ts +29 -0
  716. package/src/domain/sha256.test.ts +12 -0
  717. package/src/domain/sha256.ts +21 -0
  718. package/src/domain/text.ts +11 -0
  719. package/src/engine.harness.mjs +252 -0
  720. package/src/engine.ts +176 -0
  721. package/src/exit-code.test.ts +21 -0
  722. package/src/exit-code.ts +38 -0
  723. package/src/facts-file.test.ts +240 -0
  724. package/src/facts-file.ts +241 -0
  725. package/src/hooks-settings.harness.mjs +386 -0
  726. package/src/hooks-settings.mutations.mjs +116 -0
  727. package/src/hooks-settings.ts +434 -0
  728. package/src/init.ts +900 -0
  729. package/src/latex-log.harness.mjs +226 -0
  730. package/src/latex-log.ts +234 -0
  731. package/src/latex-loop.harness.mjs +449 -0
  732. package/src/latex-loop.ts +211 -0
  733. package/src/link-skills.harness.mjs +273 -0
  734. package/src/link-skills.mutations.mjs +136 -0
  735. package/src/link-skills.ts +258 -0
  736. package/src/new-paper.harness.mjs +216 -0
  737. package/src/new-paper.mutations.mjs +79 -0
  738. package/src/new-paper.ts +158 -0
  739. package/src/pdf-facts.harness.mjs +188 -0
  740. package/src/pdf-facts.ts +327 -0
  741. package/src/pdf-geometry.harness.mjs +254 -0
  742. package/src/pdf-geometry.ts +300 -0
  743. package/src/ports/download.ts +10 -0
  744. package/src/ports/files.ts +11 -0
  745. package/src/ports/measure-geometry.ts +8 -0
  746. package/src/ports/process.ts +46 -0
  747. package/src/ports/tool-installer.ts +33 -0
  748. package/src/ports/workspace.ts +20 -0
  749. package/src/rules-config.harness.mjs +114 -0
  750. package/src/rules-config.ts +178 -0
  751. package/src/structure.harness.mjs +179 -0
  752. package/src/structure.mutations.mjs +83 -0
  753. package/src/structure.ts +166 -0
  754. package/src/tex-requirements.harness.mjs +238 -0
  755. package/src/tex-requirements.ts +181 -0
  756. package/src/toolchain.harness.mjs +651 -0
  757. package/src/toolchain.ts +755 -0
  758. package/src/types.ts +106 -0
  759. package/templates/paper/PIPELINE-STATUS.md +72 -0
  760. package/templates/paper/paper.md +4 -0
  761. package/templates/paper/paper.tex +8 -0
  762. package/tsconfig.json +23 -0
@@ -0,0 +1,368 @@
1
+ ---
2
+ name: tighten-paper
3
+ description: "Use when a paper \"feels long / bloated / overly complex / hard to read / doesn't deliver its point / the middle drags\" — or after review rounds deposited hedge-mass. The developmental / editorial pass on a DRAFTED paper: what a real human editor thinks reading it cover to cover — the ONE point, does every section earn its place, can it be SKIMMED, is it too long for its contribution, which sections are TMI that belong in the artifact/appendix, does the conclusion pay off the intro's promise. Produces a structural verdict + a concrete cut / fold / merge / reorder plan — NOT sentence fixes. Its verdict is a required INPUT to pc-panel-review and a hard gate in harden-paper. NOT sentence craft or a writing grade (grade-paper-writing), NOT jargon stalls (the persona stall pass), NOT scientific defects (pc-panel-review / paper-adversarial-review). Run it BEFORE those on a bloated draft — no point polishing sentences in a section that should be cut."
4
+ allowed-tools: [Read, Write, Edit, Grep, Glob, Agent, Bash(node .claude/skills/paper-pipeline/scripts/announce.mjs:*), Bash(node .claude/skills/paper-pipeline/scripts/ledger.mjs:*)]
5
+ ---
6
+
7
+ <!-- vigiles:sha256:79a018d2fd2bf3e7 compiled from skills/tighten-paper/SKILL.md.spec.ts -->
8
+
9
+ # tighten-paper — the developmental edit
10
+
11
+ ## Run me
12
+
13
+ 🔴 FIRST, before any other step:
14
+
15
+ ```
16
+ node .claude/skills/paper-pipeline/scripts/announce.mjs tighten-paper <paper-dir>
17
+ ```
18
+
19
+ An advisory pass cannot be observed failing — silence is both its error state and its normal
20
+ state — so starting is an event, and events get written down.
21
+
22
+ Sentence-level passes make a wall of text into readable text. They do **not** tell you the wall shouldn't be there
23
+ at all. This pass is the editor who reads the whole paper once and asks: *is this the right paper, at the right
24
+ length, delivering the right point?* Its deliverable is a **cut/fold/merge/reorder plan and a length verdict**, not
25
+ reworded sentences.
26
+
27
+ **Run it as a persona subagent too** (see `paper-pipeline/references/writing-craft.md` — the persona mechanic): an
28
+ editor persona who reads the whole thing once, fast, the way a busy reviewer skims before deciding. A frontier model
29
+ grading section-by-section never feels the *cumulative* drag; a persona reading cover-to-cover does.
30
+
31
+ ## 🔴 Run this ONCE, at the end — never after each addition
32
+
33
+ The failure this rule exists for is not hypothetical; it is what produced the worst score
34
+ `the reference paper` ever received. The body sat exactly at its 8-page limit, so every content
35
+ addition pushed it to 9, and each time prose came out to get back — around fifty times, sixty
36
+ characters at a go, always inside whichever section had just been edited. No single cut was wrong. The
37
+ sum of them took the transitions, the pronoun antecedents and the honest half of the conclusion, and
38
+ four blind readers independently scored clarity 2/5.
39
+
40
+ **So: content work runs over the limit deliberately.** This pass happens when the content has settled,
41
+ with the whole draft in view — which is the only vantage from which you can *move* a section rather
42
+ than shave a clause. A tighten pass performed inside a single section, under pressure from a page
43
+ counter, is not this skill; it is the damage this skill exists to undo.
44
+
45
+ If you are invoked while the author is still adding material, say so and decline the pass. The right
46
+ answer is "not yet", not a smaller cut.
47
+
48
+ ## 🏗 START WITH THE MECHANICAL LEG — run `structure.mjs` (added 2026-08-05)
49
+
50
+ ```
51
+ node .claude/skills/tighten-paper/structure.mjs <paper.md> # whole paper
52
+ node .claude/skills/tighten-paper/structure.mjs <paper.md> --section=3 # one section
53
+ ```
54
+
55
+ 🔴 **THE SCRIPT NO LONGER FINDS ANYTHING — it is an INVENTORY (2026-08-26).** All sixteen of its
56
+ checks moved into ESLint rules (`eslint-rules/paper-structure.mjs`). The findings you used to read
57
+ here now come from:
58
+
59
+ ```
60
+ npx eslint --no-config-lookup --config eslint.config.mjs <paper.md>
61
+ ```
62
+
63
+ ⚠️ Do NOT pass `--flags-only`. It is kept only because two harnesses assert on its silence, and it
64
+ prints nothing and exits 0 whatever the paper looks like. Measured 26.08 on `the reference paper`:
65
+ `--flags-only` printed 0 lines while ESLint on the same bytes reported **6 structural findings**
66
+ (subsection-size ×2 · section-lead · free-section-size ×2 · block-ungraded). A mode that cannot
67
+ speak is not a check, and reading its silence as "clean" is the defect this pipeline is named for.
68
+
69
+ What the inventory prints, and why it stays a script: the outline **in order** — every heading, its
70
+ own words, its total with subsections, its share of the body, and the `carries:`/`score:`/`verdict:`
71
+ note the section wrote about itself, printed beside its weight. That comparison is the whole point
72
+ and a linter cannot make it: a finding has nowhere to put a table.
73
+
74
+ 🔴 **Why this exists, and why word counts alone mislead.** Asked whether a paper short-changed its
75
+ contribution, per-section word counts said no — the contribution had 38% more words than related
76
+ work — and that was true and useless. The shape showed the defect: three of eight top-level sections
77
+ owned **0, 28 and 38** words before their first subsection. Nothing in the toolchain asked that
78
+ question, because every metric was per-sentence or per-document and none was per-section. The author's
79
+ word for the result was a "salad" — a jumbled mix — and he was right while the numbers said fine.
80
+
81
+ **What the script does NOT decide, and you must:** the ORDER, the NAMES, and whether a section earns
82
+ its place. Those are judgement, and pretending otherwise would be the failure this whole pipeline
83
+ exists to prevent.
84
+
85
+ ## 🔤 JUDGE THE HEADINGS AS A SET, NOT ONE AT A TIME (2026-08-05)
86
+
87
+ Print every heading in order and read them as a table of contents, with nothing else. **A stranger
88
+ should be able to reconstruct the argument from the headings alone.** Two rules:
89
+
90
+ - **A heading names a thing** — a linter, a configuration, a repository, a build, a constraint —
91
+ never an abstraction (*answers · kinds · moves · demotion · what X removes*). Two headings that a
92
+ reader called "VAGUE AF" and "why not mention the linter??" survived **six** consecutive passes,
93
+ because every pass looked only at the section it happened to be editing. Nobody ever looked at the
94
+ set.
95
+ - **A heading that names two jobs means the section has two jobs.** *"Why the prose stays, and what
96
+ the construction costs"* is two different questions under one number, and that is visible from the
97
+ heading alone before you read a word of it.
98
+
99
+ ## 🔀 JUDGE THE ORDER (2026-08-05)
100
+
101
+ Ask what reading order a stranger actually needs, then check whether the paper delivers it. The
102
+ specific failure to look for: **the result the venue cares about most, arriving last and smallest.**
103
+ On `the reference paper` the workshop was about agents, all 34 of its previously accepted papers had a
104
+ model or agent under measurement, and the paper's only agent section was 4% of the body, placed after
105
+ two sections of caveats. Measure this — do not intuit it. If you propose a reorder, price it: say
106
+ which cross-references break and how many.
107
+
108
+ ## What good papers are like (the bar)
109
+ - **One point.** A strong paper says ONE thing and everything serves it. You can state its contribution in a single
110
+ sentence, and every section visibly advances that sentence.
111
+ - **Tight beats long.** Filling the page limit is not a virtue — the best measurement/security papers are often
112
+ *under* it. Length signals insecurity as often as rigor. Cut everything the reader doesn't need to be *convinced*.
113
+ - **Skimmable.** The argument comes through from title + abstract + section headings + figure captions + first
114
+ sentence of each paragraph alone. Structure carries the story; prose fills it in.
115
+ - **The paper convinces; the artifact exhausts.** The paper keeps only what a reader needs to believe the claim.
116
+ Every per-case breakdown, every "we also checked X," every exhaustive validation sub-table → artifact/appendix.
117
+
118
+ ## The seven editorial questions (run in order)
119
+ 1. **The one-sentence point.** Write the paper's contribution in ONE sentence. If you can't, or it takes three —
120
+ that's the core problem, name it. Then check: does every section advance THAT sentence? List any that don't.
121
+ 2. **The skim test.** Read ONLY title, abstract, all headings, figure/table captions, and the first sentence of each
122
+ paragraph. Does the full argument come through? Where does skimming leave you lost or surprised? Those are
123
+ structure failures (a heading that doesn't state its point, a paragraph whose lead sentence buries the finding).
124
+ 3. **Length / verbosity audit.** Is the paper longer than it needs to be to make its point? Go section by section:
125
+ for each, ask *does removing this weaken the ARGUMENT?* If no → cut or fold to the artifact. Flag TMI: exhaustive
126
+ validation lists, defensive "we also ran X," per-case enumerations, methodology detail a reader takes on trust.
127
+ Give a concrete target ("§5 is ~1.5pp; it needs ~0.6pp — keep the two-way validation *claim* + one number, fold
128
+ the rest to the artifact").
129
+ 4. **The middle sag.** Papers drag in the middle when they ENUMERATE instead of ARGUE — a pile of parallel
130
+ sub-findings with no through-line. For the middle sections: is each one advancing the argument, or is it a data
131
+ dump the reader wades through? Recommend consolidating parallel findings and leading each with its point.
132
+ 5. **Complexity budget.** Is the paper more elaborate than its contribution warrants? A simple strong finding buried
133
+ under heavy machinery reads as over-engineered. Could the same point be made more simply / with fewer moving
134
+ parts / fewer coined terms? Name the machinery that isn't earning its keep.
135
+ 6. **Structural coherence — audit the SECTION SKELETON, not just the flow.** Section structure grows organically
136
+ and accretes cruft; check the top-level skeleton for these specific symptoms and propose a merged one:
137
+ - **Thin setup sprawl:** 3+ short sections before the first result that are all "here's the thing and how we
138
+ measured it" (e.g. separate *battery* + *corpus* + *method* sections). MERGE into one setup section with
139
+ subsections — a reader shouldn't hit four throat-clears before the payoff.
140
+ - **A sprawling Results section** (6–9 subsections in a flat list) → REGROUP into ~3 subsections **named for the
141
+ argument's steps** (e.g. the spelling→grammar→effect ladder), not for the experiments.
142
+ - **A "What actually works" / "Discussion of implications" section that duplicates** the results + discussion —
143
+ usually added because the point wasn't landing elsewhere. FOLD it into the results' close or Discussion.
144
+ - **Redundancy:** any point/stat/definition stated in 2+ sections — full once (first use), one-clause
145
+ back-reference after.
146
+ Output the CURRENT skeleton and a proposed CLEAN one (fewer, better-organized sections). A typical clean shape:
147
+ Intro · Background/threat · **one merged setup** · Results (subsections = argument steps) · Discussion ·
148
+ Related work · Ethics · Conclusion.
149
+ **But fewer sections ≠ walls of text.** Lean means *organized*, not monolithic: every merged/long section KEEPS
150
+ subsections and bold run-in heads — they're the wall-breakers (see writing-craft.md's wall-check). Don't trade a
151
+ choppy 11-section paper for an 8-section paper of unscannable blocks.
152
+ 7. **The payoff check.** Does the conclusion deliver the exact thing the intro promised — no more (no new claims), no
153
+ less (no anticlimax)? Do intro and conclusion agree on what the paper is about?
154
+
155
+ ## Aggression — the default verdict for a sentence is DELETE
156
+ The failure this skill keeps hitting is **timidity**: it concludes "the skeleton is clean, nothing major to cut"
157
+ and trims lightly, so the paper stays at the page limit and still *feels* fat (GateBench 2026-07-25: the author
158
+ called it "fat for no reason" after a pass that cut almost nothing and left it 10pp). Fix the posture:
159
+ - **Clean skeleton ≠ tight paper.** A perfectly-organized section list can still be 30–40% fat prose. "No whole
160
+ section to cut" is **NOT a stopping condition** — go INSIDE each section and cut at the paragraph and sentence
161
+ level. A tightening pass whose conclusion is "structure is already clean" has not done its job.
162
+ - **Burden of proof is on the words, not the editor.** Do not ask "can I justify removing this?" Ask "does this
163
+ sentence change what the reader BELIEVES or can DO?" If not — cut. The default verdict for any sentence is
164
+ DELETE unless it visibly advances the one-point.
165
+ - **Each section justifies its LENGTH, not just its existence.** Existence-justified but 2× too long is still a
166
+ fail. Budget each section from its job (threat model ~0.5pp not 1.5; related-work ~0.75pp; a discussion that
167
+ re-states results ~0). Over budget → cut to budget.
168
+ - **The fat inventory (hunt these in every section):** background the reader already knows; "we also ran/checked
169
+ X" reassurance; per-case enumerations (→ artifact); hedge-stacks (→ one scope sentence); a sentence that
170
+ restates the previous one in new words; throat-clearing lead-ins ("It is worth noting that…"); any paragraph
171
+ whose deletion the ARGUMENT would not notice.
172
+ - **Measured, not vibes.** Report before→after LINES (or words) per section and total. **A tightening pass that
173
+ does not move the line count materially DID NOT HAPPEN** — say so and cut harder. On a paper that "feels fat,"
174
+ −20–30% of body prose is a normal result, not an extreme one.
175
+ - **"It's all load-bearing numbers" is the SECOND timid excuse — reject it too** (the first is "the skeleton is
176
+ clean"). A paragraph can be FULL of protected numbers/cites and STILL be over-explained. Load-bearing protects
177
+ the CLAIM + its number — NOT the three sentences that motivate, teach, and restate it around them. Method:
178
+ extract the claim+number into ONE tight sentence, cut the surrounding explanation. **Dense ≠ uncuttable** — a
179
+ measurement paper's fat HIDES as explanation of real numbers, which is exactly why "it's all numbers" lets it
180
+ survive a lazy pass (GateBench 2026-07-25: a pass cut only 5% hiding behind this; the author correctly pushed
181
+ back that whole sections were over-explained, not just number-dense).
182
+ - **"Fold to the artifact" is the PRIMARY length lever for a measurement/benchmark paper — not a last resort.**
183
+ FIRST verify the artifact exists and recomputes the numbers (it usually does for these papers). Then per-case
184
+ breakdowns, secondary analyses, exhaustive robustness sub-results, ablation walkthroughs, and every "we also
185
+ checked X" MOVE there: keep the headline number + one pointer ("the artifact's per-guard matrix reports the
186
+ rest"), cut the in-paper walkthrough. This is NOT dropping a claim by omission — the public artifact recomputes
187
+ it. **A dense benchmark paper that folds NOTHING to its own artifact has not been tightened.** Make a fold list
188
+ first, before any sentence-level cutting.
189
+ - **Length is calibrated to CONTRIBUTION WEIGHT, not to the page limit.** A moderate finding + a moderate-complexity
190
+ benchmark does not need to sit at the limit; being over-length for the weight of the contribution is itself a
191
+ defect — it reads as padding even when each sentence is individually "true." Right-size to the contribution's
192
+ natural length, then stop. Ask: "for how big this finding actually is, how many pages does it deserve?" — and cut
193
+ to THAT, not to the ceiling.
194
+ - **Apply it — don't defer it (see caveats for why this is safe).** When invoked to TIGHTEN (not merely audit for
195
+ harden/pc-panel input), APPLY the prose/TMI cuts directly and report the measured delta. A plan with no applied
196
+ cuts is only acceptable for a pure pre-review audit; "tighten this, it's fat" means CUT.
197
+
198
+ ## 🔴 Write the per-section verdict INTO the paper, not just into chat
199
+
200
+ A verdict that lives in a chat log is gone by the next session, and the next session then re-derives
201
+ it or ignores it. **Every section and subsection gets a one-line verdict comment immediately above its
202
+ heading**, in the paper source, stamped with the date and the skill that produced it:
203
+
204
+ ```
205
+ <!-- TIGHTEN 2026-08-06 · score 8/10 · verdict: KEEP · 190w
206
+ carries: tools get close but none resolves a NAMED rule against a committed config
207
+ because: it is the only place the tool-ecosystem gap is closed; a reviewer who skips it
208
+ asks "hasn't this been done" and gets no answer -->
209
+ <!-- TIGHTEN 2026-08-06 · score 5/10 · verdict: SHORTEN -89w · 210w
210
+ carries: why a linter for the rules file cannot work
211
+ because: the point lands in two sentences; the rest re-establishes what §2 already did -->
212
+ <!-- TIGHTEN 2026-08-06 · score 2/10 · verdict: MOVE→artifact · 45w
213
+ carries: nothing the reader must hold to judge the contribution -->
214
+ ```
215
+
216
+ 🔴 **Before assigning any `MOVE→` verdict, read `paper-pipeline/references/body-vs-appendix.md`.**
217
+ It holds the one rule that decides where a block lives — quoted from the ACL/ARR guidelines, not
218
+ invented — plus the ordered list of what to cut first when the body overruns, and the asymmetric
219
+ case that matters most: **a qualification narrowing a number in the body belongs in the body**,
220
+ however tight the page count. Moving it out does not fix the overclaim, it hides it.
221
+
222
+ **Three fields, all three required, on every heading — and in an appendix, on every bolded block.**
223
+
224
+ | field | what it means |
225
+ |---|---|
226
+ | `score: N/10` | how much **a reviewer's decision to accept** depends on this. NOT how interesting it is, not how hard it was, not how much you like it |
227
+ | `verdict:` | one of **KEEP · SHORTEN −Nw · MOVE→§x/appendix/artifact · MERGE→§x · CUT** |
228
+ | `carries:` | the belief it holds, in one clause. If you cannot write it, that IS the finding and the verdict is not KEEP |
229
+
230
+ 🔴 **Why a score, when there was already a justification.** A free-text note is a section arguing its
231
+ own case, and a section always wins that argument: there is no scale to rank it against its
232
+ neighbours, and no slot in which the answer can come out negative. Over one paper, 23 such notes were
233
+ written and **not one ever concluded "cut me"**. Author, 2026-08-06, reading the built PDF:
234
+ *"reading the paper gives the impression — hmm, is this section really needed"* — the notes had asserted
235
+ value on every page and compared nothing.
236
+
237
+ The pairing is the mechanism: **a low score beside a KEEP verdict is a visible contradiction**, and
238
+ `structure.mjs` reports it. Prose cannot contradict itself; a number can.
239
+
240
+ **Calibration, so the scale does not drift to "everything is an 8":**
241
+ - **9–10** — remove it and a reviewer cannot assess the contribution. The claim, its evidence, its price.
242
+ - **7–8** — removing it costs a reviewer's confidence: the honest bound, the nearest competitor, the cost.
243
+ - **5–6** — a reader who already believes you wants it. Full protocols, per-item tables. This is an
244
+ **appendix** score, not a body score.
245
+ - **3–4** — real work, nobody asks for it. Its home is the artifact.
246
+ - **0–2** — duplicates something reachable, or was written for an argument the paper no longer makes.
247
+
248
+ **Anything scoring below 5 that sits in the BODY is a page-limit bug**, and the verdict says where it goes.
249
+
250
+ 🔴 **The scale does not apply to integrity content, and a low score there is never a reason to cut.**
251
+ Attribution, ethics and disclosure statements, licence and availability notes, correction records,
252
+ and the admission of a limitation all score low by construction — no reviewer's accept/reject
253
+ depends on them. That is what they are *for*. Score them honestly and **write `verdict: KEEP`
254
+ anyway**, with the reason.
255
+
256
+ Observed 2026-08-06, first run of this format: a block crediting a section title's metaphor to a
257
+ named Supreme Court dissent scored 2/10 and came back `CUT`, described as "a courtesy footnote, not
258
+ evidence". Deleting the credit while keeping the borrowing is not a saving. The pass was applying
259
+ the scale exactly as written, which made it a defect in the scale.
260
+
261
+ 🔴 **A `MOVE` or `CUT` verdict on an appendix block is INVALID unless the note says what points at
262
+ the block.** State the pointer, or state that a search found none — and if one exists, the verdict
263
+ is KEEP until the pointer is rewritten first. This is not a nicety: an executed MOVE leaves the body
264
+ saying "see Appendix B" and Appendix B saying nothing, which reads as thorough and sends the reader
265
+ into a hole. Worse than the words it saved.
266
+
267
+ Measured, first run of the format: the pass proposed **686 words of cuts across nine blocks, and
268
+ every one had to be reversed.** Four were pointed at from the body or Limitations. One held the only
269
+ citation of a reference — moving it would have left an uncited entry in the bibliography, which the
270
+ pass itself noted and proposed anyway. One was the working behind a bound that had been promoted
271
+ into the abstract that morning, so "unreached" was true when the pass started and false when it
272
+ finished. One was a population reconciliation, in a paper whose single loudest complaint is that its
273
+ populations are never related. Two were the block that *points at the artifact*, and an attribution.
274
+
275
+ **Nine for nine is not bad luck, it is a missing input.** A pass that grades blocks one at a time
276
+ cannot see what points at them, so it will keep proposing exactly these cuts. Hand it the
277
+ reachability map, or require the pointer check in the note — the second is cheaper and it is what
278
+ this rule does.
279
+
280
+ **Same day, two more verdicts had to be overruled**, both `SHORTEN` on subsections a word threshold
281
+ had flagged, both scored 7/10 and 9/10, and in both the verdict was derived *from the threshold*
282
+ rather than from reading the text — one of them on a passage carrying a standing note that says the
283
+ fix there is expansion, not compression. **A size finding says LOOK HERE. It does not say what to
284
+ do.** A pass returning SHORTEN on high-scoring sections it has not re-read is doing arithmetic, and
285
+ its verdicts should be treated as unread.
286
+
287
+ Rules for these comments:
288
+ - **Every section AND every appendix block.** Demanding one note per heading asks nothing of an
289
+ appendix, which is one heading with thirty-five arguments under it — and that is exactly where
290
+ unpriced prose accumulates, because nothing there costs a page.
291
+ - **Stale beats absent, but not by much.** A comment whose date precedes the last substantive edit to
292
+ its section is stale; re-grade it rather than trusting it.
293
+ - **A verdict nobody executed is a note, not a decision.** `structure.mjs` reports blocks still
294
+ carrying a non-KEEP verdict — a paper full of unexecuted CUTs is worse than one never graded,
295
+ because it reads as decided.
296
+ - They are working notes: stripped before typesetting, like every other `<!-- -->` block.
297
+ - The chat summary still gets written — but it is the *derivative*, and the paper is the record.
298
+
299
+ ## 🧱 Enforce subsections — a section without them is a wall
300
+
301
+ **A section that runs past roughly 700 words or five paragraphs with no `###` under it is a wall**,
302
+ and a wall is where TMI hides: nothing announces what each part is for, so nothing can be judged
303
+ individually and nothing gets cut. Readers skim headings; if a section offers none, its middle is
304
+ invisible.
305
+
306
+ For every such section, either propose the subsection split (one heading per belief the reader carries
307
+ out, named by the belief and not by the topic) or explain why the section is genuinely one indivisible
308
+ argument. Introductions and conclusions are the usual legitimate exceptions; a results or related-work
309
+ section almost never is.
310
+
311
+ Mechanical leg: `paper-lint`'s `checkPaperWalls()` reports oversized unsubsectioned sections on the Stop
312
+ pass, so this does not depend on someone remembering to run the skill.
313
+
314
+ ## Output — the verdict AND the applied cuts
315
+ Produce:
316
+ - **The one-sentence point** (as you could best extract it) + whether the paper delivers it clearly (yes / buried / no).
317
+ - **Length verdict:** is it too long? by roughly how much? Is it at the page limit because it's full of argument, or
318
+ because it's padded?
319
+ - **The cut/fold/merge/reorder plan:** a ranked list — for each: section, action (CUT / FOLD-TO-ARTIFACT / MERGE
320
+ with X / REORDER / TIGHTEN), why, and rough length saved. Lead with the highest-impact.
321
+ - **The middle-sag diagnosis** and the fix (consolidate these findings, lead each with its point).
322
+ - **Skim-test failures** (headings/lead-sentences that don't carry the argument).
323
+
324
+ ## Record the verdict
325
+
326
+ 🔴 LAST step, once the deliverable exists:
327
+
328
+ ```
329
+ node .claude/skills/paper-pipeline/scripts/ledger.mjs record tighten-paper <paper-dir> FINDING <count> <report-path>
330
+ node .claude/skills/paper-pipeline/scripts/ledger.mjs record tighten-paper <paper-dir> ABSTAINED <reason> "<one line>"
331
+ ```
332
+
333
+ **FINDING** is the normal row — `<count>` is the number of CUT / FOLD / MERGE / REORDER actions in
334
+ the plan and `<report-path>` is the plan itself. Add `--blocking` when the paper is over its limit
335
+ and the plan cannot get it under.
336
+ **ABSTAINED** — `no-witness`: a cover-to-cover read produced no action at all, which on a real draft
337
+ should be rare. `blocked`: the declined pass of the section above — content is still being added, so
338
+ there was nothing to read whole.
339
+
340
+ 🔴 **This is the check with the documented history of never saying no**: a tightening pass once
341
+ returned KEEP on 80 of 81 sections and still counted as run. It is also one of the three failures
342
+ that deleted `PASS` — the word made "I read it all and nothing moved" indistinguishable from "I did
343
+ not really read it". `status.mjs` reports a check that has never recorded a finding, on the
344
+ mutation-testing principle that a test which kills no mutant is not a test. So an `ABSTAINED
345
+ no-witness` here owes a note saying what was read and why nothing moved.
346
+
347
+ The mechanical half of this skill files separately, under `tighten-paper/structure` — one check, one
348
+ row. Do not record a `structure.mjs` result here.
349
+
350
+ ## Compose
351
+ Run this FIRST on a draft that "feels bloated" — before grade-paper-writing / the stall pass / pc-panel, because
352
+ polishing sentences in a section that should be folded to the artifact is wasted work. After the plan is applied,
353
+ THEN run the sentence-level passes on what remains. On a page-limited paper, this pass is also what *buys* the space
354
+ a sentence-level readability pass needs (cut a TMI section → the core mechanism gets room to breathe).
355
+
356
+ ## Honesty / scope caveats
357
+ - **Separate the two risk classes — they are NOT the same, and conflating them is what makes this pass timid.**
358
+ (1) **Prose/TMI cutting** — deleting fat sentences, folding enumerations to the artifact, collapsing hedge-stacks,
359
+ re-voicing academic sentences plainly — removes words that don't change what the reader believes. **LOW risk;
360
+ apply it aggressively even the day of the deadline.** Timidity here IS the failure, not the safe choice.
361
+ (2) **Skeleton surgery** — merging, reordering, or deleting whole sections — can destabilize a done paper. **THIS
362
+ is the deadline judgment call:** propose it, get author sign-off, hold for camera-ready if unsure. Never let
363
+ caution about (2) suppress (1) — a "hold big cuts for later" reflex applied to *prose* fat is exactly how a
364
+ "feels fat" paper survives a tightening pass unchanged. Don't silently do (2); do (1) hard.
365
+ - "Fold to the artifact" only works if the artifact actually exists and can hold it — verify (ties to the
366
+ availability check in `harden-paper`).
367
+ - Cutting changes claims by omission. Anything cut/folded still gets the claim-preservation diff (the `claims` row) — a
368
+ removed hedge or caveat is a claim change.