repomatic 8.1.0__tar.gz → 8.3.0__tar.gz

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 (713) hide show
  1. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/.claude-plugin/plugin.json +1 -1
  2. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/agents/sphinx-docs.md +148 -122
  3. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/babysit-ci/SKILL.md +12 -12
  4. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.claude}/skills/babysit-ci/references/failure-patterns.md +3 -0
  5. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/benchmark-update/SKILL.md +4 -4
  6. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.claude}/skills/brand-assets/SKILL.md +9 -1
  7. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.claude}/skills/file-bug-report/SKILL.md +19 -3
  8. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.claude}/skills/github-housekeeping/SKILL.md +1 -1
  9. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.claude}/skills/probe-workflow/SKILL.md +2 -1
  10. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.claude}/skills/repomatic-changelog/SKILL.md +1 -1
  11. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/repomatic-deps/SKILL.md +29 -8
  12. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/repomatic-ship/SKILL.md +23 -12
  13. repomatic-8.3.0/.claude/skills/repomatic-ship/references/deep-pass.md +116 -0
  14. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.claude}/skills/repomatic-ship/references/short-ship.md +1 -1
  15. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/repomatic-test-matrix/SKILL.md +1 -1
  16. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/repomatic-upgrade/SKILL.md +49 -19
  17. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.claude}/skills/sphinx-docs-sync/SKILL.md +1 -1
  18. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.claude}/skills/upstream-audit/SKILL.md +10 -7
  19. {repomatic-8.1.0 → repomatic-8.3.0}/.claude-plugin/marketplace.json +2 -2
  20. {repomatic-8.1.0 → repomatic-8.3.0}/.github/actions/publish-pypi/action.yaml +2 -2
  21. {repomatic-8.1.0 → repomatic-8.3.0}/.github/workflows/_release-build.yaml +25 -13
  22. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.github/workflows}/_release-engine.yaml +37 -37
  23. {repomatic-8.1.0 → repomatic-8.3.0}/.github/workflows/autofix.yaml +75 -75
  24. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.github/workflows}/autolock.yaml +3 -3
  25. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.github/workflows}/cancel-runs.yaml +3 -3
  26. {repomatic-8.1.0 → repomatic-8.3.0}/.github/workflows/changelog.yaml +19 -19
  27. {repomatic-8.1.0 → repomatic-8.3.0}/.github/workflows/debug.yaml +6 -6
  28. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.github/workflows}/docs.yaml +26 -20
  29. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.github/workflows}/labels.yaml +11 -11
  30. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.github/workflows}/lint.yaml +58 -29
  31. {repomatic-8.1.0 → repomatic-8.3.0}/.github/workflows/metrics.yaml +4 -4
  32. {repomatic-8.1.0 → repomatic-8.3.0}/.github/workflows/release.yaml +3 -3
  33. {repomatic-8.1.0 → repomatic-8.3.0}/.github/workflows/self-maintenance.yaml +5 -5
  34. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.github/workflows}/tests.yaml +10 -10
  35. {repomatic-8.1.0/repomatic/data → repomatic-8.3.0/.github/workflows}/unsubscribe.yaml +3 -3
  36. {repomatic-8.1.0 → repomatic-8.3.0}/.gitignore +3 -0
  37. {repomatic-8.1.0 → repomatic-8.3.0}/AGENTS.md +3 -6
  38. {repomatic-8.1.0 → repomatic-8.3.0}/PKG-INFO +5 -5
  39. {repomatic-8.1.0 → repomatic-8.3.0}/changelog.md +106 -0
  40. {repomatic-8.1.0 → repomatic-8.3.0}/docs/_static/custom.css +14 -20
  41. {repomatic-8.1.0 → repomatic-8.3.0}/docs/agent-skills.md +13 -6
  42. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/binaries.csv +12 -0
  43. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/dependencies.mmd +5 -9
  44. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/help-dark-screen.svg +6 -6
  45. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/help-light-screen.svg +6 -6
  46. repomatic-8.3.0/docs/assets/matrix-grid-screen.svg +27 -0
  47. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/metrics.csv +330 -700
  48. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/star-history-compared.svg +15 -19
  49. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/virustotal-scans.csv +12 -0
  50. repomatic-8.3.0/docs/benchmark.md +214 -0
  51. {repomatic-8.1.0 → repomatic-8.3.0}/docs/binaries.md +1 -1
  52. {repomatic-8.1.0 → repomatic-8.3.0}/docs/claude-code-plugin.md +5 -5
  53. {repomatic-8.1.0 → repomatic-8.3.0}/docs/conf.py +43 -199
  54. {repomatic-8.1.0 → repomatic-8.3.0}/docs/configuration.md +6 -1
  55. {repomatic-8.1.0 → repomatic-8.3.0}/docs/dependencies.md +5 -3
  56. {repomatic-8.1.0 → repomatic-8.3.0}/docs/docs_update.py +50 -35
  57. {repomatic-8.1.0 → repomatic-8.3.0}/docs/history.md +1 -1
  58. {repomatic-8.1.0 → repomatic-8.3.0}/docs/install.md +27 -10
  59. {repomatic-8.1.0 → repomatic-8.3.0}/docs/operation-contracts.md +2 -2
  60. repomatic-8.3.0/docs/repomatic.init.local_edits.md +8 -0
  61. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.init.md +1 -0
  62. {repomatic-8.1.0 → repomatic-8.3.0}/docs/security.md +2 -2
  63. repomatic-8.3.0/docs/subagent-grunt-qa.md +6 -0
  64. repomatic-8.3.0/docs/subagent-qa-engineer.md +6 -0
  65. repomatic-8.3.0/docs/subagent-sphinx-docs.md +6 -0
  66. {repomatic-8.1.0 → repomatic-8.3.0}/docs/subagents.md +12 -5
  67. {repomatic-8.1.0 → repomatic-8.3.0}/docs/test-matrix.md +12 -6
  68. {repomatic-8.1.0 → repomatic-8.3.0}/docs/todolist.md +1 -1
  69. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tool-runner.md +17 -11
  70. {repomatic-8.1.0 → repomatic-8.3.0}/docs/upstream-development.md +36 -0
  71. {repomatic-8.1.0 → repomatic-8.3.0}/docs/upstream.md +12 -13
  72. {repomatic-8.1.0 → repomatic-8.3.0}/docs/workflows.md +29 -12
  73. {repomatic-8.1.0 → repomatic-8.3.0}/pyproject.toml +15 -17
  74. {repomatic-8.1.0 → repomatic-8.3.0}/pyproject.toml.orig +39 -35
  75. {repomatic-8.1.0 → repomatic-8.3.0}/readme.md +1 -1
  76. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/__init__.py +2 -2
  77. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cache.py +3 -38
  78. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cli/ci.py +42 -14
  79. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cli/deps.py +7 -3
  80. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cli/github.py +109 -0
  81. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cli/main.py +1 -0
  82. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cli/release.py +4 -0
  83. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cli/repo.py +14 -11
  84. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cloudflare/api.py +1 -2
  85. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/config.py +21 -14
  86. {repomatic-8.1.0/.github/workflows → repomatic-8.3.0/repomatic/data}/_release-engine.yaml +37 -37
  87. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/action-publish-pypi.yaml +2 -2
  88. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/agent-sphinx-docs.md +148 -122
  89. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/autofix.yaml +75 -75
  90. {repomatic-8.1.0/.github/workflows → repomatic-8.3.0/repomatic/data}/autolock.yaml +3 -3
  91. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/awesome_template/.github/contributing.md +2 -2
  92. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/awesome_template/.github/contributing.zh.md +2 -2
  93. {repomatic-8.1.0/.github/workflows → repomatic-8.3.0/repomatic/data}/cancel-runs.yaml +3 -3
  94. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/changelog.yaml +19 -19
  95. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/debug.yaml +6 -6
  96. {repomatic-8.1.0/.github/workflows → repomatic-8.3.0/repomatic/data}/docs.yaml +26 -20
  97. {repomatic-8.1.0/.github/workflows → repomatic-8.3.0/repomatic/data}/labels.yaml +11 -11
  98. {repomatic-8.1.0/.github/workflows → repomatic-8.3.0/repomatic/data}/lint.yaml +58 -29
  99. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/metrics.yaml +4 -4
  100. repomatic-8.3.0/repomatic/data/octicons.toml +98 -0
  101. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/pytest.toml +3 -1
  102. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/release.yaml +3 -3
  103. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/babysit-ci/SKILL.md +12 -12
  104. {repomatic-8.1.0/.claude → repomatic-8.3.0/repomatic/data}/skills/babysit-ci/references/failure-patterns.md +3 -0
  105. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/benchmark-update/SKILL.md +4 -4
  106. {repomatic-8.1.0/.claude → repomatic-8.3.0/repomatic/data}/skills/brand-assets/SKILL.md +9 -1
  107. {repomatic-8.1.0/.claude → repomatic-8.3.0/repomatic/data}/skills/file-bug-report/SKILL.md +19 -3
  108. {repomatic-8.1.0/.claude → repomatic-8.3.0/repomatic/data}/skills/github-housekeeping/SKILL.md +1 -1
  109. {repomatic-8.1.0/.claude → repomatic-8.3.0/repomatic/data}/skills/probe-workflow/SKILL.md +2 -1
  110. {repomatic-8.1.0/.claude → repomatic-8.3.0/repomatic/data}/skills/repomatic-changelog/SKILL.md +1 -1
  111. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/repomatic-deps/SKILL.md +29 -8
  112. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/repomatic-ship/SKILL.md +23 -12
  113. repomatic-8.3.0/repomatic/data/skills/repomatic-ship/references/deep-pass.md +116 -0
  114. {repomatic-8.1.0/.claude → repomatic-8.3.0/repomatic/data}/skills/repomatic-ship/references/short-ship.md +1 -1
  115. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/repomatic-test-matrix/SKILL.md +1 -1
  116. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/repomatic-upgrade/SKILL.md +49 -19
  117. {repomatic-8.1.0/.claude → repomatic-8.3.0/repomatic/data}/skills/sphinx-docs-sync/SKILL.md +1 -1
  118. {repomatic-8.1.0/.claude → repomatic-8.3.0/repomatic/data}/skills/upstream-audit/SKILL.md +10 -7
  119. {repomatic-8.1.0/.github/workflows → repomatic-8.3.0/repomatic/data}/tests.yaml +10 -10
  120. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/typos.toml +4 -0
  121. {repomatic-8.1.0/.github/workflows → repomatic-8.3.0/repomatic/data}/unsubscribe.yaml +3 -3
  122. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/cooldown.py +37 -13
  123. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/lockfile.py +40 -0
  124. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/provenance.py +48 -22
  125. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/report.py +22 -15
  126. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/shippable.py +106 -26
  127. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/docs.py +8 -3
  128. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/file_inventory.py +5 -1
  129. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/git_ops.py +77 -2
  130. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/ci_status.py +173 -25
  131. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/event.py +18 -0
  132. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/gh.py +51 -13
  133. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/issue.py +28 -16
  134. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/labels.py +2 -2
  135. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/outputs.py +8 -0
  136. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/pr_body.py +1 -0
  137. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/runs.py +6 -7
  138. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/workflow_files.py +50 -3
  139. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/workflow_sync.py +6 -4
  140. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/http.py +25 -7
  141. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/images.py +2 -1
  142. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/init/__init__.py +2 -0
  143. repomatic-8.3.0/repomatic/init/local_edits.py +156 -0
  144. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/init/run.py +242 -18
  145. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/init/upgrade.py +45 -24
  146. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/lint_changelog.py +66 -9
  147. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/lint_repo/pins.py +13 -0
  148. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/lint_repo/roster.py +40 -3
  149. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/lint_repo/site.py +191 -3
  150. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/lint_repo/tool_config.py +42 -0
  151. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/matrix/runner_sync.py +118 -7
  152. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/metadata/core.py +3 -0
  153. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/metadata/git.py +12 -0
  154. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/pypi.py +149 -45
  155. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/release/binaries_page.py +6 -22
  156. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/release/virustotal.py +8 -8
  157. repomatic-8.3.0/repomatic/templates/upgrade-invite.md +12 -0
  158. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/tooling/binaries.py +108 -9
  159. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/tooling/registry.py +44 -40
  160. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/tooling/runner.py +51 -2
  161. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/upstream.py +9 -0
  162. {repomatic-8.1.0 → repomatic-8.3.0}/tests/cli-test-suite.toml +7 -0
  163. {repomatic-8.1.0 → repomatic-8.3.0}/tests/conftest.py +12 -0
  164. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_awesome_template.py +29 -0
  165. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_binaries.py +113 -5
  166. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_binaries_page.py +1 -0
  167. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_broken_links.py +0 -1
  168. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_cache.py +3 -2
  169. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_checksums.py +1 -1
  170. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_ci_status.py +352 -5
  171. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_cli.py +0 -4
  172. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_dep_sources.py +160 -0
  173. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_docs.py +28 -0
  174. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_event.py +31 -0
  175. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_gh.py +69 -9
  176. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_git_ops.py +54 -0
  177. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_github_caches.py +14 -0
  178. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_http.py +36 -8
  179. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_init_project.py +605 -7
  180. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_issue.py +126 -6
  181. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_labels.py +46 -3
  182. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_lint_changelog.py +102 -0
  183. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_lint_repo.py +208 -2
  184. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_metadata.py +3 -5
  185. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_metadata_git.py +10 -5
  186. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_pr_body.py +2 -0
  187. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_provenance.py +237 -53
  188. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_pypi.py +41 -4
  189. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_release_workflow_steps.py +73 -1
  190. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_releases.py +2 -2
  191. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_runner_sync.py +201 -1
  192. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_sphinx_crossrefs.py +46 -27
  193. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_tool_runner.py +68 -0
  194. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_uv.py +79 -28
  195. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_virustotal.py +7 -7
  196. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_workflow_files.py +37 -0
  197. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_workflow_sync.py +33 -0
  198. {repomatic-8.1.0 → repomatic-8.3.0}/uv.lock +169 -188
  199. repomatic-8.1.0/docs/assets/matrix-grid-screen.svg +0 -27
  200. repomatic-8.1.0/docs/benchmark.md +0 -199
  201. repomatic-8.1.0/repomatic/templates/upgrade-invite.md +0 -12
  202. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/agents/grunt-qa.md +0 -0
  203. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/agents/qa-engineer.md +0 -0
  204. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/av-false-positive/SKILL.md +0 -0
  205. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/awesome-triage/SKILL.md +0 -0
  206. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/repomatic-init/SKILL.md +0 -0
  207. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/repomatic-ship/references/findings-in-repomatic.md +0 -0
  208. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/repomatic-topics/SKILL.md +0 -0
  209. {repomatic-8.1.0 → repomatic-8.3.0}/.claude/skills/translation-sync/SKILL.md +0 -0
  210. {repomatic-8.1.0 → repomatic-8.3.0}/.github/ISSUE_TEMPLATE/bug-report.yml +0 -0
  211. {repomatic-8.1.0 → repomatic-8.3.0}/.github/code-of-conduct.md +0 -0
  212. {repomatic-8.1.0 → repomatic-8.3.0}/.github/funding.yml +0 -0
  213. {repomatic-8.1.0 → repomatic-8.3.0}/.mailmap +0 -0
  214. {repomatic-8.1.0 → repomatic-8.3.0}/docs/404.html +0 -0
  215. {repomatic-8.1.0 → repomatic-8.3.0}/docs/_redirects +0 -0
  216. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/banner-social-dark.png +0 -0
  217. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/banner-social-light.png +0 -0
  218. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/banner-social.svg +0 -0
  219. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/config-snippet-screen.svg +0 -0
  220. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/desktop-autosync-warning.png +0 -0
  221. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/desktop-plugin-agents.png +0 -0
  222. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/desktop-plugin-contents.png +0 -0
  223. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/desktop-plugin-skills.png +0 -0
  224. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/favicon.svg +0 -0
  225. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/icon.icns +0 -0
  226. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/icon.ico +0 -0
  227. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/icon.png +0 -0
  228. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/logo-banner-dark.png +0 -0
  229. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/logo-banner-light.png +0 -0
  230. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/logo-banner.svg +0 -0
  231. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/logo-square-dark.png +0 -0
  232. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/logo-square-light.png +0 -0
  233. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/logo-square.svg +0 -0
  234. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/star-history.svg +0 -0
  235. {repomatic-8.1.0 → repomatic-8.3.0}/docs/assets/sync-deps-trail-screen.svg +0 -0
  236. {repomatic-8.1.0 → repomatic-8.3.0}/docs/changelog-archive.md +0 -0
  237. {repomatic-8.1.0 → repomatic-8.3.0}/docs/changelog.md +0 -0
  238. {repomatic-8.1.0 → repomatic-8.3.0}/docs/cli.md +0 -0
  239. {repomatic-8.1.0 → repomatic-8.3.0}/docs/cloudflare.md +0 -0
  240. {repomatic-8.1.0 → repomatic-8.3.0}/docs/code-of-conduct.md +0 -0
  241. {repomatic-8.1.0 → repomatic-8.3.0}/docs/commit-messages.md +0 -0
  242. {repomatic-8.1.0 → repomatic-8.3.0}/docs/contributing.md +0 -0
  243. {repomatic-8.1.0 → repomatic-8.3.0}/docs/index.md +1 -1
  244. {repomatic-8.1.0 → repomatic-8.3.0}/docs/license.md +0 -0
  245. {repomatic-8.1.0 → repomatic-8.3.0}/docs/man.md +0 -0
  246. {repomatic-8.1.0 → repomatic-8.3.0}/docs/nuitka.md +0 -0
  247. {repomatic-8.1.0 → repomatic-8.3.0}/docs/packaging.md +0 -0
  248. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.awesome_toc.md +0 -0
  249. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.broken_links.md +0 -0
  250. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.bundle.md +0 -0
  251. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cache.md +0 -0
  252. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.changelog.md +0 -0
  253. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.checks.md +0 -0
  254. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.claude_plugin.md +0 -0
  255. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cli.ci.md +0 -0
  256. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cli.deps.md +0 -0
  257. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cli.github.md +0 -0
  258. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cli.main.md +0 -0
  259. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cli.md +0 -0
  260. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cli.release.md +0 -0
  261. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cli.repo.md +0 -0
  262. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cli.site.md +0 -0
  263. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cli.tools.md +0 -0
  264. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cloudflare.api.md +0 -0
  265. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cloudflare.md +0 -0
  266. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cloudflare.pages.md +0 -0
  267. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cloudflare.r2.md +0 -0
  268. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.cloudflare.redirects.md +0 -0
  269. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.components.md +0 -0
  270. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.config.md +0 -0
  271. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.data.awesome_template.md +0 -0
  272. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.data.md +0 -0
  273. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.audit.md +0 -0
  274. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.cooldown.md +0 -0
  275. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.graph.md +0 -0
  276. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.lockfile.md +0 -0
  277. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.md +0 -0
  278. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.pins.md +0 -0
  279. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.policy.md +0 -0
  280. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.provenance.md +0 -0
  281. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.report.md +0 -0
  282. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.requirements.md +0 -0
  283. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.shippable.md +0 -0
  284. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.sources.md +0 -0
  285. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.sync.md +0 -0
  286. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.deps.uv.md +0 -0
  287. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.docs.md +0 -0
  288. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.file_inventory.md +0 -0
  289. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.file_ops.md +0 -0
  290. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.frontmatter.md +0 -0
  291. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.git_ops.md +0 -0
  292. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.caches.md +0 -0
  293. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.ci_status.md +0 -0
  294. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.dev_release.md +0 -0
  295. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.event.md +0 -0
  296. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.gh.md +0 -0
  297. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.issue.md +0 -0
  298. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.job_timings.md +0 -0
  299. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.labels.md +0 -0
  300. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.md +0 -0
  301. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.outputs.md +0 -0
  302. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.pr.md +0 -0
  303. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.pr_body.md +0 -0
  304. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.release_sync.md +0 -0
  305. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.releases.md +0 -0
  306. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.runs.md +0 -0
  307. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.sponsor.md +0 -0
  308. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.status.md +0 -0
  309. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.threads.md +0 -0
  310. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.token.md +0 -0
  311. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.unsubscribe.md +0 -0
  312. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.urls.md +0 -0
  313. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.workflow_files.md +0 -0
  314. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.github.workflow_sync.md +0 -0
  315. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.gitignore.md +0 -0
  316. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.hashing.md +0 -0
  317. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.http.md +0 -0
  318. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.humanize.md +0 -0
  319. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.images.md +0 -0
  320. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.init.removed_assets.md +0 -0
  321. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.init.run.md +0 -0
  322. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.init.tool_config.md +0 -0
  323. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.init.upgrade.md +0 -0
  324. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.lint_changelog.md +0 -0
  325. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.lint_repo.context.md +0 -0
  326. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.lint_repo.md +0 -0
  327. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.lint_repo.pins.md +0 -0
  328. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.lint_repo.repo.md +0 -0
  329. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.lint_repo.roster.md +0 -0
  330. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.lint_repo.settings.md +0 -0
  331. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.lint_repo.site.md +0 -0
  332. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.lint_repo.tool_config.md +0 -0
  333. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.lint_repo.workflows.md +0 -0
  334. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.mailmap.md +0 -0
  335. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.markdown.md +0 -0
  336. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.matrix.axes.md +0 -0
  337. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.matrix.md +0 -0
  338. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.matrix.model.md +0 -0
  339. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.matrix.runner_sync.md +0 -0
  340. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.matrix.runners.md +0 -0
  341. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.md +0 -0
  342. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.metadata.core.md +0 -0
  343. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.metadata.env.md +0 -0
  344. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.metadata.git.md +0 -0
  345. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.metadata.matrix.md +0 -0
  346. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.metadata.md +0 -0
  347. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.metadata.output.md +0 -0
  348. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.metadata.project.md +0 -0
  349. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.metrics.chart.md +0 -0
  350. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.metrics.forge.md +0 -0
  351. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.metrics.md +0 -0
  352. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.metrics.store.md +0 -0
  353. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.npm.md +0 -0
  354. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.pypi.md +0 -0
  355. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.pyproject.md +0 -0
  356. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.release.attestation.md +0 -0
  357. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.release.binaries_page.md +0 -0
  358. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.release.binary.md +0 -0
  359. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.release.manpages.md +0 -0
  360. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.release.md +0 -0
  361. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.release.prepare_release.md +0 -0
  362. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.release.protocol.md +0 -0
  363. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.release.self_pin.md +0 -0
  364. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.release.verify.md +0 -0
  365. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.release.virustotal.md +0 -0
  366. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.setup_guide.md +0 -0
  367. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.skills.md +0 -0
  368. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.tabular.md +0 -0
  369. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.templates.md +0 -0
  370. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.templating.md +0 -0
  371. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.tooling.binaries.md +0 -0
  372. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.tooling.checksums.md +0 -0
  373. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.tooling.md +0 -0
  374. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.tooling.nuitka.md +0 -0
  375. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.tooling.registry.md +0 -0
  376. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.tooling.runner.md +0 -0
  377. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.upstream.md +0 -0
  378. {repomatic-8.1.0 → repomatic-8.3.0}/docs/repomatic.versions.md +0 -0
  379. {repomatic-8.1.0 → repomatic-8.3.0}/docs/robots.txt +0 -0
  380. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.conftest.md +0 -0
  381. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.md +0 -0
  382. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_attestation.md +0 -0
  383. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_awesome_template.md +0 -0
  384. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_awesome_toc.md +0 -0
  385. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_binaries.md +0 -0
  386. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_binaries_page.md +0 -0
  387. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_binary.md +0 -0
  388. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_broken_links.md +0 -0
  389. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_cache.md +0 -0
  390. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_changelog.md +0 -0
  391. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_checks.md +0 -0
  392. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_checksums.md +0 -0
  393. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_ci_status.md +0 -0
  394. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_claude_assets.md +0 -0
  395. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_cli.md +0 -0
  396. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_cloudflare.md +0 -0
  397. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_cloudflare_r2.md +0 -0
  398. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_config.md +0 -0
  399. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_coverage_floor.md +0 -0
  400. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_dep_graph.md +0 -0
  401. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_dep_policy.md +0 -0
  402. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_dep_report.md +0 -0
  403. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_dep_sources.md +0 -0
  404. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_dev_release.md +0 -0
  405. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_docs.md +0 -0
  406. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_docstrings.md +0 -0
  407. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_event.md +0 -0
  408. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_file_ops.md +0 -0
  409. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_forge.md +0 -0
  410. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_frontmatter.md +0 -0
  411. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_gh.md +0 -0
  412. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_git_ops.md +0 -0
  413. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_github_caches.md +0 -0
  414. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_gitignore.md +0 -0
  415. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_hashing.md +0 -0
  416. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_help.md +0 -0
  417. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_http.md +0 -0
  418. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_humanize.md +0 -0
  419. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_images.md +0 -0
  420. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_imports.md +0 -0
  421. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_init_project.md +0 -0
  422. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_issue.md +0 -0
  423. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_job_timings.md +0 -0
  424. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_labels.md +0 -0
  425. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_lint_changelog.md +0 -0
  426. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_lint_repo.md +0 -0
  427. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_mailmap.md +0 -0
  428. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_manpages.md +0 -0
  429. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_markdown.md +0 -0
  430. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_matrix.md +0 -0
  431. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_metadata.md +0 -0
  432. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_metadata_git.md +0 -0
  433. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_metrics.md +0 -0
  434. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_npm.md +0 -0
  435. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_nuitka.md +0 -0
  436. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_outputs.md +0 -0
  437. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_pages_redirects.md +0 -0
  438. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_platform_keys.md +0 -0
  439. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_plugin.md +0 -0
  440. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_plugin_update_detection.md +0 -0
  441. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_pr.md +0 -0
  442. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_pr_body.md +0 -0
  443. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_prepare_release.md +0 -0
  444. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_protocol.md +0 -0
  445. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_provenance.md +0 -0
  446. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_pypi.md +0 -0
  447. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_pyproject.md +0 -0
  448. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_readme.md +0 -0
  449. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_release_sync.md +0 -0
  450. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_release_workflow_steps.md +0 -0
  451. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_releases.md +0 -0
  452. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_runner_catalog.md +0 -0
  453. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_runner_sync.md +0 -0
  454. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_runs.md +0 -0
  455. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_self_pin.md +0 -0
  456. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_setup_guide.md +0 -0
  457. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_skills.md +0 -0
  458. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_sphinx_crossrefs.md +0 -0
  459. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_sponsor.md +0 -0
  460. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_status.md +0 -0
  461. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_suite_hygiene.md +0 -0
  462. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_sync_ops.md +0 -0
  463. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_tabular.md +0 -0
  464. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_templating.md +0 -0
  465. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_threads.md +0 -0
  466. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_todolist.md +0 -0
  467. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_token.md +0 -0
  468. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_tool_runner.md +0 -0
  469. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_unsubscribe.md +0 -0
  470. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_upstream.md +0 -0
  471. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_urls.md +0 -0
  472. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_uv.md +0 -0
  473. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_verify.md +0 -0
  474. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_version_sync.md +0 -0
  475. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_versions.md +0 -0
  476. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_virustotal.md +0 -0
  477. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_vulnerable_deps.md +0 -0
  478. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_workflow_files.md +0 -0
  479. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_workflow_sync.md +0 -0
  480. {repomatic-8.1.0 → repomatic-8.3.0}/docs/tests.test_workflows.md +0 -0
  481. {repomatic-8.1.0 → repomatic-8.3.0}/license +0 -0
  482. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/__main__.py +0 -0
  483. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/awesome_toc.py +0 -0
  484. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/broken_links.py +0 -0
  485. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/bundle.py +0 -0
  486. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/changelog.py +0 -0
  487. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/checks.py +0 -0
  488. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/claude_plugin.py +0 -0
  489. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cli/__init__.py +0 -0
  490. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cli/site.py +0 -0
  491. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cli/tools.py +0 -0
  492. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cloudflare/__init__.py +0 -0
  493. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cloudflare/pages.py +0 -0
  494. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cloudflare/r2.py +0 -0
  495. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/cloudflare/redirects.py +0 -0
  496. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/components.py +0 -0
  497. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/__init__.py +0 -0
  498. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/actionlint-matcher.json +0 -0
  499. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/actionlint.yaml +0 -0
  500. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/agent-grunt-qa.md +0 -0
  501. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/agent-qa-engineer.md +0 -0
  502. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/awesome_template/.github/ISSUE_TEMPLATE/config.yml +0 -0
  503. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/awesome_template/.github/ISSUE_TEMPLATE/new-link.yaml +0 -0
  504. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/awesome_template/.github/code-of-conduct.md +0 -0
  505. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/awesome_template/.github/funding.yml +0 -0
  506. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/awesome_template/.github/pull_request_template.md +0 -0
  507. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/awesome_template/__init__.py +0 -0
  508. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/awesome_template/license +0 -0
  509. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/bumpversion.toml +0 -0
  510. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/coverage.toml +0 -0
  511. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/labels.toml +0 -0
  512. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/lychee.toml +0 -0
  513. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/mdformat.toml +0 -0
  514. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/mypy.toml +0 -0
  515. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/ruff.toml +0 -0
  516. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/av-false-positive/SKILL.md +0 -0
  517. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/awesome-triage/SKILL.md +0 -0
  518. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/repomatic-init/SKILL.md +0 -0
  519. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/repomatic-ship/references/findings-in-repomatic.md +0 -0
  520. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/repomatic-topics/SKILL.md +0 -0
  521. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/skills/translation-sync/SKILL.md +0 -0
  522. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/uv.toml +0 -0
  523. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/vt-trend-chart.js +0 -0
  524. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/yamllint.yaml +0 -0
  525. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/data/zizmor.yaml +0 -0
  526. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/__init__.py +0 -0
  527. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/audit.py +0 -0
  528. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/graph.py +0 -0
  529. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/pins.py +0 -0
  530. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/policy.py +0 -0
  531. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/requirements.py +0 -0
  532. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/sources.py +0 -0
  533. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/sync.py +0 -0
  534. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/deps/uv.py +0 -0
  535. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/file_ops.py +0 -0
  536. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/frontmatter.py +0 -0
  537. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/__init__.py +0 -0
  538. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/caches.py +0 -0
  539. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/dev_release.py +0 -0
  540. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/job_timings.py +0 -0
  541. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/pr.py +0 -0
  542. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/release_sync.py +0 -0
  543. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/releases.py +0 -0
  544. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/sponsor.py +0 -0
  545. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/status.py +0 -0
  546. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/threads.py +0 -0
  547. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/token.py +0 -0
  548. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/unsubscribe.py +0 -0
  549. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/github/urls.py +0 -0
  550. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/gitignore.py +0 -0
  551. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/hashing.py +0 -0
  552. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/humanize.py +0 -0
  553. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/init/removed_assets.py +0 -0
  554. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/init/tool_config.py +0 -0
  555. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/lint_repo/__init__.py +0 -0
  556. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/lint_repo/context.py +0 -0
  557. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/lint_repo/repo.py +0 -0
  558. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/lint_repo/settings.py +0 -0
  559. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/lint_repo/workflows.py +0 -0
  560. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/mailmap.py +0 -0
  561. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/markdown.py +0 -0
  562. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/matrix/__init__.py +0 -0
  563. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/matrix/axes.py +0 -0
  564. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/matrix/model.py +0 -0
  565. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/matrix/runners.py +0 -0
  566. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/metadata/__init__.py +0 -0
  567. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/metadata/env.py +0 -0
  568. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/metadata/matrix.py +0 -0
  569. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/metadata/output.py +0 -0
  570. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/metadata/project.py +0 -0
  571. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/metrics/__init__.py +0 -0
  572. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/metrics/chart.py +0 -0
  573. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/metrics/forge.py +0 -0
  574. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/metrics/store.py +0 -0
  575. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/npm.py +0 -0
  576. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/py.typed +0 -0
  577. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/pyproject.py +0 -0
  578. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/release/__init__.py +0 -0
  579. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/release/attestation.py +0 -0
  580. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/release/binary.py +0 -0
  581. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/release/manpages.py +0 -0
  582. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/release/prepare_release.py +0 -0
  583. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/release/protocol.py +0 -0
  584. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/release/self_pin.py +0 -0
  585. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/release/verify.py +0 -0
  586. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/setup_guide.py +0 -0
  587. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/skills.py +0 -0
  588. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/tabular.py +0 -0
  589. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/__init__.py +0 -0
  590. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/available-admonition.md +0 -0
  591. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/broken-links-issue.md +0 -0
  592. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/bump-version.md +0 -0
  593. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/development-warning.md +0 -0
  594. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/fix-changelog.md +0 -0
  595. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/fix-typos.md +0 -0
  596. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/fix-vulnerable-deps.md +0 -0
  597. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/format-images.md +0 -0
  598. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/format-json.md +0 -0
  599. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/format-markdown.md +0 -0
  600. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/format-pyproject.md +0 -0
  601. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/format-python.md +0 -0
  602. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/format-shell.md +0 -0
  603. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/generated-footer.md +0 -0
  604. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/github-releases.md +0 -0
  605. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/immutable-releases.md +0 -0
  606. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/pr-metadata.md.noformat +0 -0
  607. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/prepare-release.md.noformat +0 -0
  608. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/refresh-tip.md +0 -0
  609. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/release-notes.md +0 -0
  610. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/release-sync-report.md.noformat +0 -0
  611. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sample-metrics.md +0 -0
  612. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/scan-virustotal.md +0 -0
  613. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-branch-ruleset.md +0 -0
  614. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-cloudflare-pages.md +0 -0
  615. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-cloudflare-r2.md +0 -0
  616. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-dependabot.md +0 -0
  617. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-fork-pr-approval.md +0 -0
  618. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-notifications-pat.md +0 -0
  619. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-pages-source.md +0 -0
  620. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-pypi-trusted-publisher.md +0 -0
  621. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-sha-pinning-required.md +0 -0
  622. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-token.md +0 -0
  623. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-verify.md +0 -0
  624. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide-virustotal.md +0 -0
  625. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/setup-guide.md +0 -0
  626. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/squashed-release.md +0 -0
  627. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sync-action-pins.md +0 -0
  628. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sync-bumpversion.md +0 -0
  629. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sync-dep-sources.md +0 -0
  630. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sync-gitignore.md +0 -0
  631. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sync-mailmap.md +0 -0
  632. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sync-repomatic-upgrade.md +0 -0
  633. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sync-repomatic.md +0 -0
  634. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sync-runner-images.md +0 -0
  635. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sync-tool-versions.md +0 -0
  636. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sync-uv-lock.md +0 -0
  637. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/sync-workflow-pins.md +0 -0
  638. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/unavailable-admonition.md +0 -0
  639. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/unsubscribe-report.md +0 -0
  640. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/update-dep-graph.md +0 -0
  641. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/update-docs.md +0 -0
  642. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templates/yanked-admonition.md +0 -0
  643. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/templating.py +0 -0
  644. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/tooling/__init__.py +0 -0
  645. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/tooling/checksums.py +0 -0
  646. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/tooling/nuitka.py +0 -0
  647. {repomatic-8.1.0 → repomatic-8.3.0}/repomatic/versions.py +0 -0
  648. {repomatic-8.1.0 → repomatic-8.3.0}/tests/__init__.py +0 -0
  649. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_attestation.py +0 -0
  650. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_awesome_toc.py +0 -0
  651. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_binary.py +0 -0
  652. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_changelog.py +0 -0
  653. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_checks.py +0 -0
  654. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_claude_assets.py +0 -0
  655. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_cloudflare.py +0 -0
  656. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_cloudflare_r2.py +0 -0
  657. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_config.py +0 -0
  658. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_coverage_floor.py +0 -0
  659. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_dep_graph.py +0 -0
  660. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_dep_policy.py +0 -0
  661. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_dep_report.py +0 -0
  662. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_dev_release.py +0 -0
  663. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_docstrings.py +0 -0
  664. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_file_ops.py +0 -0
  665. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_forge.py +0 -0
  666. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_frontmatter.py +0 -0
  667. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_gitignore.py +0 -0
  668. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_hashing.py +0 -0
  669. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_help.py +0 -0
  670. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_humanize.py +0 -0
  671. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_images.py +0 -0
  672. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_imports.py +0 -0
  673. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_job_timings.py +0 -0
  674. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_mailmap.py +0 -0
  675. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_manpages.py +0 -0
  676. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_markdown.py +0 -0
  677. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_matrix.py +0 -0
  678. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_metrics.py +0 -0
  679. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_npm.py +0 -0
  680. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_nuitka.py +0 -0
  681. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_outputs.py +0 -0
  682. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_pages_redirects.py +0 -0
  683. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_platform_keys.py +0 -0
  684. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_plugin.py +0 -0
  685. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_plugin_update_detection.py +0 -0
  686. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_pr.py +0 -0
  687. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_prepare_release.py +0 -0
  688. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_protocol.py +0 -0
  689. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_pyproject.py +0 -0
  690. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_readme.py +0 -0
  691. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_release_sync.py +0 -0
  692. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_runner_catalog.py +0 -0
  693. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_runs.py +0 -0
  694. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_self_pin.py +0 -0
  695. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_setup_guide.py +0 -0
  696. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_skills.py +0 -0
  697. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_sponsor.py +0 -0
  698. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_status.py +0 -0
  699. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_suite_hygiene.py +0 -0
  700. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_sync_ops.py +0 -0
  701. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_tabular.py +0 -0
  702. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_templating.py +0 -0
  703. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_threads.py +0 -0
  704. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_todolist.py +0 -0
  705. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_token.py +0 -0
  706. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_unsubscribe.py +0 -0
  707. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_upstream.py +0 -0
  708. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_urls.py +0 -0
  709. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_verify.py +0 -0
  710. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_version_sync.py +0 -0
  711. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_versions.py +0 -0
  712. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_vulnerable_deps.py +0 -0
  713. {repomatic-8.1.0 → repomatic-8.3.0}/tests/test_workflows.py +0 -0
@@ -20,5 +20,5 @@
20
20
  "license": "GPL-2.0-or-later",
21
21
  "name": "repomatic",
22
22
  "repository": "https://github.com/kdeldycke/repomatic",
23
- "version": "8.1.0"
23
+ "version": "8.3.0"
24
24
  }
@@ -19,7 +19,7 @@ When a doc shows the result of running code, prefer a Sphinx directive that exec
19
19
 
20
20
  - `{click:run}` renders the simulated terminal output with ANSI colors via the `ansi-shell-session` Pygments lexer. By default it hides the source and shows only the results, so import statements inside the block run silently. Use it for `--help`, `--list`, and any command whose output is the point of the example.
21
21
  - `{click:source}` renders the Python source instead of the result. Use to teach readers what a Click `invoke(...)` call looks like, or with `:hide-source:` to seed shared symbols (see below).
22
- - **Namespace persistence is asymmetric across the two directives.** `{click:source}` calls `exec(code, namespace)`, so top-level assignments land in the per-document runner namespace and are visible to every later block. `{click:run}` calls `exec(code, namespace, local_vars)`, so top-level assignments land in `local_vars` (per Python's exec semantics when `globals != locals`) and are discarded after the block. An `import` inside a `{click:run}` block is local to that block. Source: `ClickRunner.execute_source` vs `ClickRunner.run_cli` in `click_extra/sphinx/click.py`.
22
+ - **Namespace persistence is asymmetric across the two directives.** `{click:source}` calls `exec(code, namespace)`, so top-level assignments land in the per-document runner namespace and are visible to every later block. `{click:run}` calls `exec(code, namespace, local_vars)`, so top-level assignments land in `local_vars` (per Python's exec semantics when `globals != locals`) and are discarded after the block. An `import` inside a `{click:run}` block is local to that block. Source: `ClickRunner.execute_source` vs `ClickRunner.run_cli` in `click_extra/sphinx/click_runner.py`.
23
23
  - Therefore: when a document has **more than one** `{click:run}` block, seed shared imports in a leading `{click:source}` `:hide-source:` block. When the document has only one `{click:run}`, an inline import inside that block is fine.
24
24
 
25
25
  Pattern to copy (multi-block document):
@@ -103,7 +103,7 @@ Guidance:
103
103
  - **Prefix (`startswith`) for layouts.** Lock the top of an output (Usage line, first option) when prose discusses ordering or section structure. Lets later sections evolve without churn.
104
104
  - **Exact (`==`) for short outputs.** Reserve for `--version` and similar one-shot strings where any drift is a real change worth surfacing.
105
105
  - **Use `\x1b[...m` literals to assert color.** That's the whole reason ANSI is preserved end-to-end: if you only care about plain text, the assertion can use `result.output` and ignore the codes, but locking the codes catches accidental theme changes.
106
- - **`result.exit_code == 0` is rarely worth it.** A non-zero exit already aborts the build; only assert exit codes when you intentionally invoke a failure path and want the docs to prove it errored cleanly.
106
+ - **Always assert `result.exit_code`.** `invoke()` returns the result of a failed run and raises nothing, so the build stays green and the page publishes the error output. Assert `0` on a success path, and the expected code when the example shows a failure on purpose.
107
107
  - **Keep one logical assertion per block.** Multiple bound results (`r1 = invoke(...); r2 = invoke(...)`) work, but the rendered output is a single concatenated terminal trace — readers can't tell where one command ends and the next begins. Split into separate `{click:run}` blocks.
108
108
 
109
109
  The auto-generated `cli.md` reference (one block per `--help` per command) is the wrong place for assertions: nothing prose-anchored to assert, and the regenerator would have to track the assertion text. Reserve assertions for hand-written docs where the example illustrates a specific behavior.
@@ -164,11 +164,11 @@ Anti-pattern: any `render`-family block that takes more than a second or two to
164
164
 
165
165
  #### Keeping a committed copy: the `:mirror:` flag
166
166
 
167
- `{python:render}` (the plain form only, not `-myst`/`-rst`) accepts a `:mirror:` flag that keeps a copy of the generated Markdown committed in the source `.md`, between `<!-- mirror -->` / `<!-- mirror-end -->` markers directly below the fence. In mirror mode the directive itself renders nothing (`_run_mirror` returns `[]` unless `:show-source:`); the committed region is what the host parser renders, refreshed in memory at `source-read` time on every build and on disk by `click-extra refresh-directives` (the last `repomatic update-docs` phase). This gives you build-time freshness *and* a reviewable, GitHub-rendered copy — the true replacement for the `docs_update.py` marker-region pattern. Mirror generators must `print` `mdformat`-canonical Markdown (`render_table(..., GITHUB)`) or the generator and `mdformat` fight over the region.
167
+ `{python:render}` (the plain form only, not `-myst`/`-rst`) accepts a `:mirror:` flag that keeps a copy of the generated Markdown committed in the source `.md`, between `<!-- mirror -->` / `<!-- mirror-end -->` markers directly below the fence. In mirror mode the directive itself renders nothing (`PythonRenderBaseDirective.run` executes no mirror block, and shows its source only under `:show-source:`); the committed region is what the host parser renders, refreshed in memory at `source-read` time on every build and on disk by `click-extra refresh-directives` (the last `repomatic update-docs` phase). This gives you build-time freshness *and* a reviewable, GitHub-rendered copy — the true replacement for the `docs_update.py` marker-region pattern. Mirror generators must `print` `mdformat`-canonical Markdown (`render_table(..., GITHUB)`) or the generator and `mdformat` fight over the region.
168
168
 
169
- **Hard prerequisite — the generator must be importable from the installed package.** The mirror refresher and the `source-read` rebuild both `exec` each block with a bare namespace and no `sys.path` setup, so a mirror block may only import from the installed distribution (`from {package}.x import ...`), never a docs-local helper under `docs/`. A block that does `from docs_update import ...` raises `ModuleNotFoundError` under `click-extra refresh-directives` run from the repo root (verified in extra-platforms), which fails that whole refresh phase.
169
+ **A mirror generator imports from the installed package, or from a module beside its page.** The mirror refresher and the `source-read` rebuild both `exec` each block with the directory of its page on `sys.path`, since click-extra `8.6.0`. A block on a `docs/` page can then run `from docs_update import ...` offline, as it does at build time. Anything else must be importable from the installed distribution (`from {package}.x import ...`): a block whose import fails raises under `click-extra refresh-directives`, which fails that whole refresh phase.
170
170
 
171
- If the generators are docs-only tooling you don't want in the public API, ship them in a **private** package module — a leading-underscore name keeps them out of the public surface while still installed and importable. Extra-platforms moved its table/diagram generators from `docs/docs_update.py` into `extra_platforms/_docs.py`; the `:mirror:` blocks do `from extra_platforms._docs import generate_trait_table`. Two things to get right when a docs-only dep is involved: keep the package's runtime clean by never importing the private module from `__init__` (extra_platforms stays dependency-free at import; `_docs` pulls `click_extra.table` only when a docs build calls it), and add a mypy override (`[[tool.mypy.overrides]] module = "click_extra.*" ignore_missing_imports = true`) because the type-check venv (`uv run` with no `--group docs`) lacks the docs dependency. `docs/docs_update.py` then keeps only what can't be a mirror block: the `readme.md` mindmaps (a `:mirror:` block would expose the generator's `{python:render}` fence on the user-facing README) and the reST `{eval-rst}` autodoc regions (autodoc can't be a Markdown mirror). Update those marker regions through click-extra's own `update_blocks(paths, rewrite, *, check=False)` — the walk/write/dry-run primitive behind `:mirror:` and `{matrix}` — instead of a hand-rolled `wcmatch` loop; it hands you a `--check` mode for CI drift detection for free. It is public API since click-extra `8.8.0`. Import it from `click_extra.markdown.blocks` since `10.0.0`, and from `click_extra.blocks` or `click_extra.sphinx` before.
171
+ If the generators are docs-only tooling you don't want in the public API, ship them in a **private** package module — a leading-underscore name keeps them out of the public surface while still installed and importable. Extra-platforms moved its table/diagram generators from `docs/docs_update.py` into `extra_platforms/_docs.py`; the `:mirror:` blocks do `from extra_platforms._docs import generate_trait_table`. Two things to get right when a docs-only dep is involved: keep the package's runtime clean by never importing the private module from `__init__` (extra_platforms stays dependency-free at import; `_docs` pulls `click_extra.table` only when a docs build calls it), and add a mypy override (`[[tool.mypy.overrides]] module = "click_extra.*" ignore_missing_imports = true`) because the type-check venv (`uv run` with no `--group docs`) lacks the docs dependency. A generator whose fence must stay off the page, like that of a `readme.md` mindmap that GitHub and PyPI render from the raw Markdown, goes into a `<!-- mirror-src -->` comment (see § Auto-generated reference tables). extra-platforms moved its mindmaps there and its autodoc regions into live `{python:render}` blocks, then deleted `docs/docs_update.py`. A project that still keeps a regenerator updates its marker regions through click-extra's own `update_blocks(paths, rewrite, *, check=False)` — the walk/write/dry-run primitive behind `:mirror:` and `{matrix}` — instead of a hand-rolled `wcmatch` loop; it hands you a `--check` mode for CI drift detection for free. It is public API since click-extra `8.8.0`. Import it from `click_extra.markdown.blocks` since `10.0.0`, and from `click_extra.blocks` or `click_extra.sphinx` before.
172
172
 
173
173
  ### `:emphasize-lines:` vs `:emphasize-result-lines:`
174
174
 
@@ -271,7 +271,7 @@ Cross-references that survive renames:
271
271
 
272
272
  ## Inline syntax highlighting in prose
273
273
 
274
- The `attrs_inline` MyST extension (already in the standard `myst_enable_extensions` set) lets you tag any inline code span with a Pygments lexer:
274
+ The `attrs_inline` MyST extension (see § Standard extension set) lets you tag any inline code span with a Pygments lexer:
275
275
 
276
276
  ```markdown
277
277
  Renders as `<span style="color: #rrggbb">`{l=html} tags.
@@ -334,9 +334,9 @@ Choices that are project-specific:
334
334
  - **`sphinxcontrib.jquery` + `sphinx_datatables`** — only for projects shipping the binaries catalog (a `binaries.md` page rendering `assets/binaries.csv` as a searchable, sortable `sphinx-datatable`). jQuery must be listed explicitly: sphinx-datatables only activates it from a `html-page-context` callback, too late for the `jquery.js` static file to be registered and copied, leaving `$` undefined at runtime. Pair with the shared `datatables_options` raw-JS block (empty `order` preserving the CSV's newest-first rows, 25-row pages, a relative-time hint appended to the Released column at display time) that click-extra and repomatic both carry verbatim.
335
335
  - **`sphinx_issues`** — **don't adopt**. The extension's `:issue:`/`:pr:`/`:user:`/`:commit:` roles only render inside Sphinx, so the same source files (changelogs, docstrings, comments) display as raw `` :issue:`1234` `` text everywhere else: GitHub's markdown viewer in the repo browser, IDE previews, `pip show`, the PyPI long-description page, downstream tooling reading the changelog. Write explicit GitHub URLs instead, which work in every renderer and keep the changelog identically readable on GitHub and on the docs site.
336
336
 
337
- Standard `myst_enable_extensions`, alphabetized (omit only when the project demonstrably doesn't use the syntax):
337
+ The `myst_enable_extensions` this lineage draws from, alphabetized. Enable one only once the docs use its syntax (see § `docs/conf.py` hygiene › MyST and theme config):
338
338
 
339
- - `alert` — renders GitHub-style alerts (`> [!NOTE]`, `> [!WARNING]`, …) as admonitions. Native to `myst-parser` ≥ 5.1, which `click_extra.sphinx` defers to from that version on; every repo in this lineage enables it. Preferred over `colon_fence` for alert rendering.
339
+ - `alert` — renders GitHub-style alerts (`> [!NOTE]`, `> [!WARNING]`, …) as admonitions. Native to `myst-parser` ≥ 5.1, which the `sphinx` extra of click-extra requires since `10.0.0`; every repo in this lineage enables it. Preferred over `colon_fence` for alert rendering.
340
340
  - `attrs_block`, `attrs_inline` — class/style attributes on blocks and inline spans.
341
341
  - `colon_fence` — enables `:::`-delimited directives, and GitHub `[!NOTE]` admonitions when paired with `myst_parser` ≥ 3 (though `alert` above is the preferred path for those). This lineage otherwise discourages colon-fence admonitions (`mdformat` churns the colons; see § MyST docstrings and admonitions), so enable it only when a project genuinely uses `:::` syntax.
342
342
  - `deflist` — definition lists (`term : definition`).
@@ -357,7 +357,14 @@ For `pyproject.toml` schemas, CLI command lists, and tool registries, generate t
357
357
  - `<!-- managers-sankey -->` / `<!-- managers-sankey-end -->` (a Mermaid sankey of supported managers).
358
358
  - `<!-- operation-matrix -->` / `<!-- operation-matrix-end -->` (a feature-coverage table).
359
359
  - `<!-- pytest-decorators-autodata -->` / `<!-- pytest-decorators-autodata-end -->` (autodata blocks for pytest fixtures).
360
- - `<!-- python-compat-matrix -->` / `<!-- python-compat-matrix-end -->` (a compatibility table refreshed by a regenerator).
360
+
361
+ click-extra owns five region names, and `click-extra refresh-directives` rewrites each region on disk. Never give a project's own region one of these names:
362
+
363
+ - `<!-- envelope {axis}... -->` / `<!-- envelope-end -->`: the dated obsolete bounds of the support envelope across the axes it names, like `<!-- envelope python -->` on the install page. Since click-extra `10.2.0`.
364
+ - `<!-- matrix {axis} -->` / `<!-- matrix-end -->`: a compatibility table, like `<!-- matrix python -->` on the install page. Options follow the axis as `key=value` pairs and bare flags, like `<!-- matrix click show-spec -->`. Since click-extra `8.2.0`.
365
+ - `<!-- mirror -->` / `<!-- mirror-end -->`: the committed output of a `{python:render}` fence with the `:mirror:` flag, directly below the fence.
366
+ - `<!-- mirror-src` / `<!-- mirror-src-end -->`: the opening line starts an HTML comment that holds the generator Python, up to a closing `-->` line. The output follows the comment up to the end marker, so GitHub and PyPI show the output alone. Since click-extra `8.7.0`.
367
+ - `<!-- screenshot -->` / `<!-- screenshot-end -->`: the image link of a `{click:run}` capture with the `:screenshot:` and `:mirror:` options, directly below the fence. Since click-extra `9.0.0`.
361
368
 
362
369
  Pick the `{feature}` slug from the canonical name of the source-of-truth (registry name, dataclass name, command path); pick the `{kind}` slug from the output shape (`table`, `sankey`, `mindmap`, `chart`, `autodata`, `automodule`, `autodoc`, `reference`).
363
370
 
@@ -369,7 +376,7 @@ Document **dataclass fields with attribute docstrings** (PEP 257 string literal
369
376
 
370
377
  ## Recipes for common doc artifacts
371
378
 
372
- The patterns below are how this repo renders `docs/configuration.md`, `docs/cli.md`, and `docs/install.md`. Downstream CLI projects can replicate them verbatim by pointing at their own dataclass schema and Click root command. Every reference page renders live (click-extra directives for the CLI and config references, `{python:render}` blocks over `repomatic.tooling.registry` for the tool registry); the repo's `docs_update.py` regenerates the committed CLI captures rather than any doc region, and only `install.md`'s matrix stays checked in as a marker region for GitHub rendering. Free-form per-tool prose lives in the registry itself (`ToolSpec.docs_notes`), not in the page, so it survives without marker islands.
379
+ The patterns below are how this repo renders `docs/configuration.md`, `docs/cli.md`, and `docs/install.md`. Downstream CLI projects can replicate them verbatim by pointing at their own dataclass schema and Click root command. Every reference page renders live (click-extra directives for the CLI and config references, `{python:render}` blocks over `repomatic.tooling.registry` for the tool registry); the repo's `docs_update.py` regenerates the committed CLI captures and the octicon table of this file, but no region of these pages. Only the matrix and envelope regions of `install.md` stay checked in as marker regions, for GitHub rendering. Free-form per-tool prose lives in the registry itself (`ToolSpec.docs_notes`), not in the page, so it survives without marker islands.
373
380
 
374
381
  ### `configuration.md`: option reference from a dataclass
375
382
 
@@ -449,9 +456,9 @@ Hand-written, but with a strict structure that downstream projects should mirror
449
456
 
450
457
  When the package is not on Repology at all, list only the directly-controlled installers (uv, pip, pipx for PyPI projects) and skip the `Installation methods` tab-set entirely if even those don't apply.
451
458
 
452
- 5. **Python compatibility matrix** — a `<!-- matrix python -->` / `<!-- matrix-end -->` comment-marker region whose embedded table is regenerated by `click-extra refresh-directives` (the last `repomatic update-docs` phase runs it automatically), so it refreshes on every release without manual intervention. click-extra's matrix machinery owns the generation logic: per-tag Python support from classifiers with `requires-python`/Poetry/`setup.py` fallbacks, release-date capping, and range grouping. Keep the marker form (not the live `{matrix}` fence) so the table also renders when browsing the file on GitHub. Rendering conventions the reader relies on: `✅` / `❌` glyph cells, consecutive same-support tags grouped into one row labelled `` `4.25.x` → `6.15.x` ``, newest ranges on top. Tags with no Python declaration at all are out of scope; note the cutoff in a sentence beneath the table rather than padding with blank rows.
459
+ 5. **Python compatibility matrix** — a `<!-- matrix python -->` / `<!-- matrix-end -->` comment-marker region whose embedded table is regenerated by `click-extra refresh-directives` (the last `repomatic update-docs` phase runs it automatically), so it refreshes on every release without manual intervention. click-extra's matrix machinery owns the generation logic: per-tag Python support from classifiers with `requires-python`/Poetry/`setup.py` fallbacks, release-date capping, range grouping, and since click-extra `10.2.0` a trim to the support envelope of the project, which drops the oldest ranges. Keep the marker form (not the live `{matrix}` fence) so the table also renders when browsing the file on GitHub. Rendering conventions the reader relies on: `✅`, `❌` and `–` glyph cells (a version the release declares, one its `requires-python` rules out, and one it neither declares nor excludes, which an open-ended `requires-python` leaves for a Python published after the tag), consecutive same-support tags grouped into one row labelled `` `4.25.x` → `6.15.x` ``, newest ranges on top. Tags with no Python declaration at all are out of scope; note the cutoff in a sentence beneath the table rather than padding with blank rows. A `## Support envelope` section above the table lists the obsolete bounds of that envelope, in a `<!-- envelope python -->` region refreshed the same way.
453
460
 
454
- 6. **Binaries** table linking to GitHub Release binaries for each platform/architecture. Its URLs belong to the release freeze (`PrepareRelease.freeze_install_download_urls`), which ratchets them forward to `/releases/download/vX.Y.Z/<package>-X.Y.Z-linux-arm64.bin` on every release: a repo that has shipped once carries versioned URLs permanently, and there is no unfreeze step. A never-released repo starts from the evergreen `releases/latest/download/<package>-linux-arm64.bin` form, which resolves because the release pipeline uploads versionless alias assets alongside the version-stamped ones. Both spellings resolve, so neither is drift: never hand-edit one into the other.
461
+ 6. **Binaries** table linking to GitHub Release binaries for each platform/architecture. A downstream repo links the evergreen `releases/latest/download/<package>-linux-arm64.bin` form, and keeps it for good. That URL resolves because the release pipeline uploads versionless alias assets alongside the version-stamped ones. The release freeze (`PrepareRelease.freeze_install_download_urls`) rewrites these URLs in repomatic alone: it runs only where the repository is `kdeldycke/repomatic`, and matches only repomatic's own binary names. There it ratchets them forward to `/releases/download/vX.Y.Z/repomatic-X.Y.Z-linux-arm64.bin` on every release, with no unfreeze step. Both spellings resolve, so neither is drift: never hand-edit one into the other.
455
462
 
456
463
  7. **Release verification** section showing `gh attestation verify` against the package's own repo, with the `--signer-repo` flag if the release workflow runs as a reusable workflow from another repo. Mirror exactly: a stale flag here breaks reader trust.
457
464
 
@@ -461,7 +468,7 @@ Sync rules:
461
468
 
462
469
  - Re-check the Repology page on every release. New distros get a new tab; dropped distros get the tab removed.
463
470
  - The Python compatibility matrix is auto-generated; never hand-edit it.
464
- - Download URLs in `install.md` are generated, not hand-maintained, so a version number in one is expected rather than drift. The single manual intervention is the documented repair: when a release's binary lane failed, re-point the table at the last release that actually carries binaries, since the freeze pins the version optimistically before the binaries exist (`lint-repo` reports the gap but never repairs it; see the `repomatic-ship` skill's § Repairing a short ship).
471
+ - Download URLs in repomatic's own `install.md` are generated, not hand-maintained, so a version number in one is expected rather than drift. The single manual intervention there is the documented repair: when a release's binary lane failed, re-point the table at the last release that actually carries binaries, since the freeze pins the version optimistically before the binaries exist (`lint-repo` reports the gap but never repairs it; see the `repomatic-ship` skill's § Repairing a short ship). In a downstream repo nothing rewrites the `latest/download/` URLs, and `lint-repo` checks them against the latest release.
465
472
  - The Try it now tab-set's `Specific version` tab does carry a pinned version as an example — that's intentional (it teaches the syntax). From repomatic `v7.4.0` on, the prepare-release freeze step bumps it automatically (`freeze_install_cli_version` rewrites `{package}@X.Y.Z` and `{package}==X.Y.Z` pins in `docs/install.md`); hand-bumping is only needed on repos pinned to older release engines.
466
473
 
467
474
  ### `packaging.md`: distribution and dependency reference
@@ -484,11 +491,11 @@ User-facing pages, and when a project carries one:
484
491
  02. `cli` — § Recipes › `cli.md`. CLIs only.
485
492
  03. `man` — Index of the man pages `click_extra_manpages` emits, one link per (sub)command. Only when the project declares that list; pair it with a `## Man pages` section in `install.md` covering `--man`, the release tarball and regeneration, or the emitted `man/` tree publishes unreachable.
486
493
  04. `configuration` — § Recipes › `configuration.md`. Projects with `[tool.X]` schema.
487
- 05. `dependencies` — Dependency policy page (version-specifier rules, floor-comment conventions, audit procedures). The project's own dependency graph is not a page of its own: it renders in `packaging.md`'s `## Dependencies` section (see § Recipes › `packaging.md`).
494
+ 05. `dependencies` — Upstream page: the dependency policy (version-specifier rules, floor-comment conventions, audit procedures) of every repomatic-managed repository. A downstream repo links to [repomatic's copy](https://repomatic.net/dependencies) instead of carrying one. The project's own dependency graph is not a page of its own: it renders in `packaging.md`'s `## Dependencies` section (see § Recipes › `packaging.md`).
488
495
  06. `tool-runner` — Only when the project ships a `repomatic run`-style tool runner.
489
496
  07. `workflows` — Only when the project publishes reusable workflows.
490
497
  08. `test-matrix` — Only when the project documents its CI test-matrix composition.
491
- 09. `nuitka` — Only for projects compiling standalone executables through the release engine: the canonical home for build targets, fleet cadence, compile caching and measured build times (the `binaries` page below stays the per-release catalog).
498
+ 09. `nuitka` — Upstream page: the canonical home for the build targets, fleet cadence, compile caching and measured build times of the release engine. A downstream repo compiling standalone executables through that engine links to [repomatic's copy](https://repomatic.net/nuitka) instead of carrying one (the `binaries` page below stays its per-release catalog).
492
499
  10. `security` — Optional, and absent by default: a security page with nothing project-specific to say (no real threat model, no attack surface worth describing, no dedicated reporting channel) is boilerplate that dilutes the docs. Add it only when the project has a genuine security consideration. When present, single-source it as `docs/security.md`: GitHub's security tab detects the file in `docs/` as well as `.github/`, so no duplicate copy is needed.
493
500
  11. `benchmark` — Optional comparison page; only useful for projects positioning against alternatives. MyST docstring authoring needs no local page: it is canonically documented on the [click-extra MyST docstrings page](https://kdeldycke.github.io/click-extra/myst-docstrings.html), which also covers the `click-extra convert-to-myst` migration command.
494
501
 
@@ -501,10 +508,10 @@ Agent tooling toctree, in this order. Drop the whole block when the project ship
501
508
  Maintainer-facing pages, and when a project carries one:
502
509
 
503
510
  01. `contributing` — Setup, dev loop, code-style pointers (or `{include} ../contributing.md` if the root file already exists). The one home of developer setup: `readme.md` and `AGENTS.md` link to it.
504
- 02. `commit-messages` — Only when automation reads or writes the project's commit subjects, which makes the subject a shared namespace rather than free text: the reserved-prefix rules, who else parses a message, and how to write a subject and body.
511
+ 02. `commit-messages` — Upstream page: the reserved-prefix rules, who else parses a message, and how to write a subject and body. The repomatic automation reads and writes the commit subjects of every repository it manages, which makes the subject a shared namespace rather than free text. A downstream repo links to [repomatic's copy](https://repomatic.net/commit-messages) instead of carrying one.
505
512
  03. `upstream-development` — Project-internal release process. Mark `(upstream maintainers only)` in the page heading so readers know this is not for consumers.
506
513
  04. `operation-contracts` — Optional, for projects with formal automated-operation contracts.
507
- 05. `{package}`, `tests` — Autodoc API pages: the package's root autodoc page and the test-suite package. Name them bare, never as an `API <{package}>` alias: the `API reference` caption they sit under already says what they are, and the alias then prints the word twice. Both keep plain octicon-free headings (see Title octicons below).
514
+ 05. `{package}`, `tests` — Autodoc API pages: the package's root autodoc page and the test-suite package. Name them bare, never as an `API <{package}>` alias: the `API reference` caption they sit under already says what they are, and the alias then prints the word twice. Both keep plain octicon-free headings (see § Title octicons below).
508
515
  06. `packaging` — Distribution and dependency reference (see § Recipes › `packaging.md`). Every project renders its dependency graph here; projects distributed through package managers add their per-channel build instructions alongside it. Maintainer/packager-facing, so it sits here rather than among the user-facing pages.
509
516
  07. `binaries` — Standalone-executables catalog written by the repomatic binaries pipeline. Only for projects compiling Nuitka binaries; a maintainer-facing reference, so it belongs here rather than in the primary toctree (end users reach the same downloads through `install.md`'s `## Binaries` section).
510
517
  08. `cloudflare` — Only when the project sets `[tool.repomatic] site.deploy = "cloudflare-pages"`: the operating manual for that hosting model (deploy mechanics, token scope and rotation, the drift check, the `_redirects` engine). Deploy tokens and an audit log are maintainer material, so it sits here rather than in the primary toctree.
@@ -536,99 +543,7 @@ Page-shape rules that apply across the roster:
536
543
 
537
544
  - **Single-source content with `{include}`.** `changelog.md`, `code-of-conduct.md`, `license.md`, and `contributing.md` should `{include}` the root-level file when one exists. Two copies drift; one copy is enforced.
538
545
 
539
- - **Title octicons.** Every top-level page heading uses an `{octicon}` icon for visual scanning: `` # {octicon}`download` Installation ``, `` # {octicon}`command-palette` CLI ``, etc. Not just decoration — the Furo theme's sidebar uses them as visual anchors. Canonical icon registry, alphabetized:
540
-
541
- | Page | Octicon |
542
- | :------------------------- | :--------------------- |
543
- | `add-new-manager.md` | `diff-added` |
544
- | `add-packaging-channel.md` | `git-merge` |
545
- | `agent-skills.md` | `mortar-board` |
546
- | `architectures.md` | `cpu` |
547
- | `augmentations.md` | `plus-circle` |
548
- | `bar-plugin.md` | `plug` |
549
- | `benchmark.md` | `trophy` |
550
- | `binaries.md` | `desktop-download` |
551
- | `carapace.md` | `chevron-right` |
552
- | `changelog-archive.md` | `history` |
553
- | `changelog.md` | `diff` |
554
- | `ci.md` | `container` |
555
- | `claude-code-plugin.md` | `plug` |
556
- | `cli-parameters.md` | `command-palette` |
557
- | `cli.md` | `command-palette` |
558
- | `cloudflare.md` | `cloud` |
559
- | `code-of-conduct.md` | `code-of-conduct` |
560
- | `colorize.md` | `paintbrush` |
561
- | `commands.md` | `apps` |
562
- | `commit-messages.md` | `git-commit` |
563
- | `concurrency.md` | `cpu` |
564
- | `config.md` | `sliders` |
565
- | `configuration.md` | `sliders` |
566
- | `context.md` | `database` |
567
- | `contributing.md` | `git-pull-request` |
568
- | `cooldown.md` | `history` |
569
- | `decorators.md` | `mention` |
570
- | `dependencies.md` | `package-dependencies` |
571
- | `desktop-menus.md` | `device-desktop` |
572
- | `detection.md` | `pulse` |
573
- | `dump.md` | `file-moved` |
574
- | `duplicates.md` | `stack` |
575
- | `envvar.md` | `pin` |
576
- | `execution.md` | `play` |
577
- | `falsehoods.md` | `copilot-warning` |
578
- | `gnome-shell.md` | `plug` |
579
- | `groups.md` | `apps` |
580
- | `history.md` | `log` |
581
- | `infrastructure.md` | `globe` |
582
- | `install.md` | `download` |
583
- | `license.md` | `law` |
584
- | `logging.md` | `log` |
585
- | `man-page.md` | `repo` |
586
- | `man.md` | `book` |
587
- | `managers.md` | `file-submodule` |
588
- | `mkdocs.md` | `markdown` |
589
- | `myst-docstrings.md` | `pencil` |
590
- | `nuitka.md` | `file-binary` |
591
- | `operation-contracts.md` | `tasklist` |
592
- | `output-formats.md` | `table` |
593
- | `overrides.md` | `pin` |
594
- | `packaging.md` | `package-dependents` |
595
- | `parameters.md` | `tasklist` |
596
- | `platforms.md` | `codespaces` |
597
- | `pygments.md` | `file-code` |
598
- | `pytest.md` | `meter` |
599
- | `releasing.md` | `rocket` |
600
- | `sbom.md` | `verified` |
601
- | `screenshots.md` | `device-camera` |
602
- | `security.md` | `shield-lock` |
603
- | `shells.md` | `chevron-right` |
604
- | `sphinx.md` | `book` |
605
- | `spinner.md` | `sync` |
606
- | `styling.md` | `typography` |
607
- | `subagents.md` | `dependabot` |
608
- | `sudo.md` | `key` |
609
- | `table.md` | `table` |
610
- | `telemetry.md` | `broadcast` |
611
- | `terminals.md` | `terminal` |
612
- | `test-matrix.md` | `pivot-column` |
613
- | `test-suite.md` | `beaker` |
614
- | `testing.md` | `shield-check` |
615
- | `theme.md` | `sun` |
616
- | `todolist.md` | `checklist` |
617
- | `tool-runner.md` | `tools` |
618
- | `trait.md` | `tag` |
619
- | `tree.md` | `workflow` |
620
- | `tutorial.md` | `mortar-board` |
621
- | `typer.md` | `git-compare` |
622
- | `types.md` | `file-binary` |
623
- | `unsupported.md` | `circle-slash` |
624
- | `upstream-development.md` | `gear` |
625
- | `upstream.md` | `cross-reference` |
626
- | `usecase.md` | `light-bulb` |
627
- | `version.md` | `iterations` |
628
- | `workflows.md` | `workflow` |
629
- | `wrap.md` | `terminal` |
630
-
631
- When introducing a page that's not in the table, pick the closest [GitHub Octicon](https://primer.style/foundations/icons) and add the entry here so the next repo follows suit. Icons must be unique within a repo — two pages sharing an icon defeats the visual-anchor purpose. A generated, homogeneous page catalog is exempt: meta-package-manager's `docs/managers/<id>.md` stubs (one per supported manager) all share a single category icon (`package`) as a group marker and sit under their own `{toctree}`, not competing for sidebar anchoring, so the uniqueness rule governs the hand-authored roster, not such catalogs. A hand-authored *family* is exempt on the same grounds: meta-package-manager's `bar-plugin.md` and `gnome-shell.md` both take `plug` because they document the two desktop-menu frontends of one feature, which a reader scans as a pair rather than tells apart by icon. The rule bites when two *unrelated* pages collide. Across repos, reuse is acceptable when the concepts are related (`sliders` for anything configuration-shaped, `chevron-right` for anything shell-shaped); at fleet scale some reuse is inevitable. Auto-generated API pages (`<package>.md`, `tests.md`, and other autodoc module pages) keep plain octicon-free headings, with the package name in backticked form (like `` # `click_extra` package ``): their sidebar icons come from the `custom.css` toctree workaround instead.
546
+ - **Title octicons.** Every top-level page heading uses an `{octicon}` icon: § Title octicons below holds the registry and its rules.
632
547
 
633
548
  - **Sentence case in titles.** "Repository conventions", not "Repository Conventions".
634
549
 
@@ -638,7 +553,7 @@ Page-shape rules that apply across the roster:
638
553
 
639
554
  Skills and subagents pages (when shipped):
640
555
 
641
- - `docs/agent-skills.md` and `docs/subagents.md` lead with a one-line install pointer, then a `{click:run}` block rendering the live `repomatic list-skills` / equivalent, then a manual table that links each skill/agent to its source-file URL on GitHub. Avoid restating skill descriptions — they're already in the SKILL.md frontmatter.
556
+ - `docs/agent-skills.md` and `docs/subagents.md` lead with a one-line install pointer, then a manual table that links each skill or agent to its source-file URL on GitHub. Between the two, the skills page renders the live `repomatic list-skills` in a `{click:run}` block: no command lists the subagents. A subagent rendered on a page of its own, like repomatic's `subagent-{name}.md` wrappers that `{include}` the agent file, links to that page instead. Avoid restating skill descriptions — they're already in the SKILL.md frontmatter.
642
557
 
643
558
  Pages that **don't** belong in the roster:
644
559
 
@@ -646,6 +561,101 @@ Pages that **don't** belong in the roster:
646
561
  - A "Glossary" page. Inline definitions next to first use are easier to maintain. If a term appears project-wide, record its spelling in `AGENTS.md` instead.
647
562
  - "Tutorials" separate from feature pages. Each feature page should carry its own walkthrough; a separate tutorial section bit-rots fast.
648
563
 
564
+ ### Title octicons
565
+
566
+ Every top-level page heading uses an `{octicon}` icon for visual scanning: `` # {octicon}`download` Installation ``, `` # {octicon}`command-palette` CLI ``, etc. The Furo sidebar shows them, so a reader finds a page by its icon. This table renders the canonical registry, `repomatic/data/octicons.toml` in repomatic, with one row per icon:
567
+
568
+ | Octicon | Pages |
569
+ | :----------------------------------------------------- | :--------------------------------------------------------- |
570
+ | {octicon}`apps` `apps` | `commands.md`, `groups.md` |
571
+ | {octicon}`beaker` `beaker` | `test-suite.md` |
572
+ | {octicon}`book` `book` | `man.md`, `sphinx.md` |
573
+ | {octicon}`broadcast` `broadcast` | `telemetry.md` |
574
+ | {octicon}`checklist` `checklist` | `operation-contracts.md` |
575
+ | {octicon}`chevron-right` `chevron-right` | `carapace.md`, `shells.md` |
576
+ | {octicon}`circle-slash` `circle-slash` | `unsupported.md` |
577
+ | {octicon}`cloud` `cloud` | `cloudflare.md` |
578
+ | {octicon}`code` `code` | `machine-readable.md` |
579
+ | {octicon}`code-of-conduct` `code-of-conduct` | `code-of-conduct.md` |
580
+ | {octicon}`code-square` `code-square` | `python-directives.md` |
581
+ | {octicon}`codespaces` `codespaces` | `platforms.md` |
582
+ | {octicon}`command-palette` `command-palette` | `cli-*.md`, `cli.md` |
583
+ | {octicon}`container` `container` | `ci.md` |
584
+ | {octicon}`copilot-warning` `copilot-warning` | `falsehoods.md` |
585
+ | {octicon}`cpu` `cpu` | `architectures.md`, `concurrency.md` |
586
+ | {octicon}`cross-reference` `cross-reference` | `upstream.md` |
587
+ | {octicon}`database` `database` | `context.md` |
588
+ | {octicon}`dependabot` `dependabot` | `agents.md`, `subagent-*.md`, `subagents.md` |
589
+ | {octicon}`desktop-download` `desktop-download` | `binaries.md` |
590
+ | {octicon}`device-camera` `device-camera` | `screenshots.md` |
591
+ | {octicon}`device-desktop` `device-desktop` | `desktop-menus.md` |
592
+ | {octicon}`diff` `diff` | `changelog.md` |
593
+ | {octicon}`diff-added` `diff-added` | `add-new-manager.md` |
594
+ | {octicon}`download` `download` | `install.md` |
595
+ | {octicon}`file-binary` `file-binary` | `nuitka.md` |
596
+ | {octicon}`file-code` `file-code` | `pygments.md` |
597
+ | {octicon}`file-moved` `file-moved` | `dump.md` |
598
+ | {octicon}`file-submodule` `file-submodule` | `managers.md` |
599
+ | {octicon}`file-symlink-file` `file-symlink-file` | `multicall.md` |
600
+ | {octicon}`gear` `gear` | `upstream-development.md` |
601
+ | {octicon}`git-commit` `git-commit` | `commit-messages.md` |
602
+ | {octicon}`git-compare` `git-compare` | `typer.md` |
603
+ | {octicon}`git-merge` `git-merge` | `add-packaging-channel.md` |
604
+ | {octicon}`git-pull-request` `git-pull-request` | `contributing.md` |
605
+ | {octicon}`globe` `globe` | `infrastructure.md` |
606
+ | {octicon}`history` `history` | `changelog-archive.md`, `cooldown.md` |
607
+ | {octicon}`image` `image` | `snippets.md` |
608
+ | {octicon}`inbox` `inbox` | `formats.md` |
609
+ | {octicon}`iterations` `iterations` | `version.md` |
610
+ | {octicon}`key` `key` | `sudo.md` |
611
+ | {octicon}`law` `law` | `license.md` |
612
+ | {octicon}`light-bulb` `light-bulb` | `design.md`, `usecase.md` |
613
+ | {octicon}`log` `log` | `logging.md` |
614
+ | {octicon}`markdown` `markdown` | `mkdocs.md` |
615
+ | {octicon}`mention` `mention` | `decorators.md` |
616
+ | {octicon}`meter` `meter` | `pytest.md` |
617
+ | {octicon}`milestone` `milestone` | `history.md` |
618
+ | {octicon}`mortar-board` `mortar-board` | `agent-skills.md`, `tutorial.md` |
619
+ | {octicon}`multi-select` `multi-select` | `types.md` |
620
+ | {octicon}`package-dependencies` `package-dependencies` | `dependencies.md` |
621
+ | {octicon}`package-dependents` `package-dependents` | `packaging.md` |
622
+ | {octicon}`paintbrush` `paintbrush` | `colorize.md` |
623
+ | {octicon}`pencil` `pencil` | `myst-docstrings.md` |
624
+ | {octicon}`pin` `pin` | `envvar.md`, `overrides.md` |
625
+ | {octicon}`pivot-column` `pivot-column` | `test-matrix.md` |
626
+ | {octicon}`play` `play` | `execution.md` |
627
+ | {octicon}`plug` `plug` | `bar-plugin.md`, `claude-code-plugin.md`, `gnome-shell.md` |
628
+ | {octicon}`plus-circle` `plus-circle` | `augmentations.md` |
629
+ | {octicon}`project-roadmap` `project-roadmap` | `layout.md` |
630
+ | {octicon}`project-template` `project-template` | `config-schema.md` |
631
+ | {octicon}`pulse` `pulse` | `detection.md` |
632
+ | {octicon}`repo` `repo` | `man-page.md` |
633
+ | {octicon}`rocket` `rocket` | `releasing.md` |
634
+ | {octicon}`search` `search` | `config-discovery.md` |
635
+ | {octicon}`shield-check` `shield-check` | `testing.md` |
636
+ | {octicon}`shield-lock` `shield-lock` | `security.md` |
637
+ | {octicon}`sliders` `sliders` | `config.md`, `configuration.md` |
638
+ | {octicon}`stack` `stack` | `config-formats.md`, `duplicates.md` |
639
+ | {octicon}`sun` `sun` | `theme.md` |
640
+ | {octicon}`sync` `sync` | `spinner.md` |
641
+ | {octicon}`table` `table` | `output-formats.md`, `table.md` |
642
+ | {octicon}`tag` `tag` | `trait.md` |
643
+ | {octicon}`tasklist` `tasklist` | `todolist.md` |
644
+ | {octicon}`telescope` `telescope` | `parameters.md` |
645
+ | {octicon}`terminal` `terminal` | `terminals.md`, `wrap.md` |
646
+ | {octicon}`tools` `tools` | `tool-runner.md` |
647
+ | {octicon}`trophy` `trophy` | `benchmark.md` |
648
+ | {octicon}`typography` `typography` | `styling.md` |
649
+ | {octicon}`verified` `verified` | `config-validation.md`, `sbom.md` |
650
+ | {octicon}`workflow` `workflow` | `tree.md`, `workflows.md` |
651
+ | {octicon}`zap` `zap` | `performance.md` |
652
+
653
+ A row lists every page that takes its icon, across the repositories following this convention. A glob in a row, like `cli-*.md`, covers each page its pattern matches. Add a new page to the row of the icon it takes, in the data file. When no row fits, pick the closest [GitHub Octicon](https://primer.style/octicons/) and add a row, so the next repo follows suit. Primer publishes icons before sphinx-design bundles them, so take the name from the `sphinx_design/compiled/octicons.json` of the sphinx-design version the project locks. An unknown name leaves the raw role text on the page and logs `Invalid octicon content`.
654
+
655
+ The `title-octicons` check of `repomatic lint-repo` holds each page title to this registry. It also warns on two pages of one site that share an icon, unless the registry declares them a family.
656
+
657
+ Auto-generated API pages (`<package>.md`, `tests.md`, and other autodoc module pages) keep plain octicon-free headings, with the package name in backticked form (like `` # `click_extra` package ``): their sidebar icons come from the `custom.css` toctree workaround instead. That workaround takes four icons: `code-review` for the package page, `codescan-checkmark` for `tests`, `list-unordered` for `genindex` and `package` for `modindex`. Match each of those entries on the end of its href. The href is relative to the current page, so it gains a `../` per level of nesting, and the `dirhtml` builder ends it with `/` instead of `.html`. A rule like `:is([href="tests/"], [href$="/tests/"])` holds on every page, where `[href="tests.html"]` matches only on the top-level pages of an `html` build.
658
+
649
659
  ## Guide pages carry the prose, API pages carry the API
650
660
 
651
661
  A guide page teaches one subject: what a feature does, how to invoke it, what its output means. The generated API reference answers a different question for a different reader. Repeating it at the foot of the guide serves neither, so **no narrative page carries an `automodule` block**. Each module is documented once, on the page `sphinx-apidoc` writes for it.
@@ -678,9 +688,21 @@ Default-pruning rule:
678
688
  - Periodically diff against a fresh `sphinx-quickstart` output in a tmpdir to spot defaults that have shifted under you.
679
689
  - Drop conditional import shims once the project's minimum Python no longer needs them. The `try: import tomllib / except: import tomli` pattern is dead code on `requires-python = ">=3.11"`. Same for any `if sys.version_info < (3, X):` branch where `X` is now below the floor. The deps group should lose the corresponding fallback dependency in the same PR.
680
690
  - Always pass `encoding="UTF-8"` to `Path.read_text()` calls in `conf.py`. Bare `read_text()` picks up the locale, which on minimal CI runners has bitten many projects.
691
+ - Name a helper variable of `conf.py` after no config value. Sphinx reads every top-level name there as configuration, so a helper called `today` or `language` sets that value, and one of the wrong type logs a warning that fails a `--fail-on-warning` build.
681
692
  - `exclude_patterns = ["_build", "_linkcheck", "html", "Thumbs.db", ".DS_Store"]` is the canonical set: `_build` and `_linkcheck` are the build and linkcheck output directories (both also gitignored), and `html` catches stray in-tree builds left by ad-hoc `sphinx-build` invocations.
682
- - Publish content, not build scaffolding. `html_copy_source = False` and `html_show_sourcelink = False` together drop the `_sources/` copy of every document, which no page in this lineage links to and only a hand-typed URL could reach. Name both: they gate different halves of the feature, and a theme reading only the second offers a link to files that are no longer there. Sphinx still creates the (now empty) directory and writes `.buildinfo` from an unconditional finish task, so a `build-finished` hook removing `.buildinfo`, `.buildinfo.bak` and the empty `_sources/` is what actually keeps them out of the deployed tree.
683
- - `sphinx_sitemap` earns its place on any site big enough that a crawler would have to walk the whole link graph to find the API pages. It needs `html_baseurl`, and **that value must end in a slash**: sphinx-sitemap concatenates it with each page link (its own normalization line computes the slash-terminated form and discards the result), so a slash-less base emits `https://example.netinstall.html`. Derive it once from `project.urls.Documentation` with `.rstrip("/") + "/"`, feed both `html_baseurl` and `ogp_site_url` from it, and set `sitemap_url_scheme = "{link}"`: the default `{lang}{version}{link}` layout is for sites publishing translations or versions side by side, and yields 404s anywhere else. Pair it with a self-contained `404.html` in `html_extra_path`: when none is present, Cloudflare Pages answers an unmatched route with the home page and a `200`, which tells a crawler every misspelled URL is real. A site on its own host also gets a `robots.txt` there that names the sitemap. A GitHub Pages project site under `{user}.github.io/{project}/` gets none, because crawlers read `robots.txt` only at the host root. The links in its `404.html` start from `/{project}/`, because the page can answer at any depth.
693
+ - Publish content, not build scaffolding. `html_copy_source = False` and `html_show_sourcelink = False` together drop the `_sources/` copy of every document, which no page in this lineage links to and only a hand-typed URL could reach. Name both: they gate different halves of the feature, and a theme reading only the second offers a link to files that are no longer there. Sphinx still creates the (now empty) directory and writes `.buildinfo` from an unconditional finish task, so a `build-finished` hook keeps them out of the deployed tree. It removes the empty `_sources/` from every build, and `.buildinfo` and `.buildinfo.bak` only when `extra_platforms.is_github_ci()` is true. That CI build starts from an empty tree and is the one deployed. A local incremental build needs `.buildinfo`: without it, Sphinx `9.2.0` compares file times alone and misses a changed html-only setting like `html_title`.
694
+ - `sphinx_sitemap` earns its place on any site big enough that a crawler would have to walk the whole link graph to find the API pages. It needs `html_baseurl`, and **that value must end in a slash**: sphinx-sitemap concatenates it with each page link (its own normalization line computes the slash-terminated form and discards the result), so a slash-less base emits `https://example.netinstall.html`. Derive it once from `project.urls.Documentation` with `.rstrip("/") + "/"`, feed both `html_baseurl` and `ogp_site_url` from it, and set `sitemap_url_scheme = "{link}"`: the default `{lang}{version}{link}` layout is for sites publishing translations or versions side by side, and yields 404s anywhere else. Pair it with a self-contained `404.html` in `html_extra_path`: when none is present, Cloudflare Pages answers an unmatched route with the home page and a `200`, which tells a crawler every misspelled URL is real. A site on its own host also gets a `robots.txt` there that names the sitemap. A GitHub Pages project site under `{user}.github.io/{project}/` gets none, because crawlers read `robots.txt` only at the host root. The links in its `404.html` start from `/{project}/`, because the page can answer at any depth. List the generated navigation pages in `sitemap_excludes`, spelled the way sphinx-sitemap records each link: `["genindex.html", "py-modindex.html", "search.html"]` under the `html` builder, and `["genindex/", "py-modindex/", "search/"]` under `dirhtml`. sphinx-sitemap matches them with `fnmatch`, so a pattern in the spelling of the other builder excludes nothing.
695
+ - `copybutton_exclude = ".linenos, .gp, .go"` copies the commands of a `shell-session` block alone. `.gp` is the Pygments class of the prompt, and `.go` the class of the output lines. The default, `.linenos`, copies every `$ ` and every output line along with the command.
696
+
697
+ Build hooks that `click_extra.sphinx` registers since `10.2.0`, so `conf.py` keeps no copy of them:
698
+
699
+ - **The nodes an `{eval-rst}` block moves point at their page.** myst-parser parses the block into a throwaway document and moves its nodes into the page, still attached to that document. Without the hook, every page holding such a block, which is every `sphinx-apidoc` stub, pickles the whole build environment: 7 to 15 MB a page (Sphinx `9.2.0`, myst-parser `5.1.0`).
700
+ - **The viewcode modules that no document links are dropped.** A parallel read (`--jobs auto`, which `docs.yaml` passes) otherwise publishes a page for each, like `_modules/pathlib/` ([sphinx-doc/sphinx#14675](https://github.com/sphinx-doc/sphinx/issues/14675)).
701
+ - **`autoclasstree` diagrams let the page scroll** when `sphinxcontrib.mermaid` runs with `mermaid_d3_zoom = True`.
702
+ - **Link checks to github.com carry the `GITHUB_TOKEN`** that the linkcheck step exposes, release downloads excepted.
703
+ - **Each changelog release gets an anchor made from its version**, like `#v1-4-2`, once `conf.py` sets `click_extra_release_anchors = True`.
704
+
705
+ An announcement banner counting the years since the first release reads them from `click_extra.sphinx.announcement.years_since(date(...))`.
684
706
 
685
707
  Extensions list:
686
708
 
@@ -697,13 +719,13 @@ MyST and theme config:
697
719
 
698
720
  Linkcheck and intersphinx:
699
721
 
700
- - `linkcheck_anchors_ignore` is for *known* JS-rendered anchors (GitHub `issuecomment-`, README anchors, `Lnnn` blob lines). Each pattern needs a one-line comment naming the source. Don't add catch-all patterns to silence linkcheck — fix the broken link instead.
722
+ - `linkcheck_anchors_ignore` is for *known* JS-rendered anchors on a host whose other anchors linkcheck can still check. GitHub's `issuecomment-`, README and `Lnnn` blob-line anchors belong to the per-host setting below instead. Each pattern needs a one-line comment naming the source. Setting the list replaces Sphinx's default `['^!']`, so keep that pattern in it. Don't add catch-all patterns to silence linkcheck — fix the broken link instead.
701
723
 
702
724
  - `linkcheck_anchors_ignore_for_url` (Sphinx ≥ 7.1) silences anchor checks on a per-host basis instead of a per-anchor basis. Use it for hosts whose entire anchor set is JS-rendered (e.g., `r"https://github\.com/"`) instead of a stack of individual anchor patterns. Fewer entries to maintain, fewer false positives when the host adds new fragment shapes.
703
725
 
704
726
  - `linkcheck_retries = 3` absorbs hosts that intermittently time out for the linkcheck bot. Prefer it over adding a flaky-but-valid host to `linkcheck_ignore`: retries keep the link checked, an ignore blinds the build to it.
705
727
 
706
- - `linkcheck_ignore` is for hosts that 403 bots or have flaky availability. Each entry needs a one-line comment naming the host and reason. Re-test on every release; remove patterns that have started working again. Categorize entries so the comment style matches the cause:
728
+ - `linkcheck_ignore` is for hosts that 403 bots or have flaky availability. Each entry needs a one-line comment naming the host and reason. Re-test on every release; remove patterns that have started working again. A host listed for timeouts or connection errors needs several passing runs before its entry goes: one passing run proves nothing for a flaky host. Categorize entries so the comment style matches the cause:
707
729
 
708
730
  | Category | Examples | Comment style |
709
731
  | :-------------------- | :------------------------------------------------------------------------------------------ | :---------------------------------------------------------------------------------------------------- |
@@ -712,12 +734,14 @@ Linkcheck and intersphinx:
712
734
  | Client-side fragments | `github.com/.../runner-images#...`, `github.com/.../README#...` | `# Fragment anchors rendered client-side.` (prefer `linkcheck_anchors_ignore_for_url` when possible). |
713
735
  | CI flakiness | `gnu.org`, `midnightbsd.org` | `# Intermittently unreachable from CI.` |
714
736
 
737
+ - `[tool.lychee] exclude` and `linkcheck_ignore` cover different crawls. The `check-broken-links` job of `docs.yaml` runs lychee over the doc files of the repository, and the Sphinx linkcheck builder over the built pages, generated content included. Put an exclude in the list of the checker that meets the link: a URL that only a `{python:render}` block or a docstring emits never reaches lychee, so it needs no `[tool.lychee]` entry.
738
+
715
739
  - `intersphinx_mapping` should cover every external project the docs cross-reference. Use `{role}` cross-refs in prose instead of bare URLs so a project move shows up as a build error, not a silent 404 in the rendered HTML. Before adding a mapping, probe the inventory with `curl -sI {base-url}/objects.inv`: a 429/403 carrying `cf-mitigated: challenge` (Cloudflare's bot gate) means Sphinx's fetcher can never retrieve it and the mapping would break every CI build. Blanket the unreachable project's refs in `nitpick_ignore_regex` with a dated comment instead.
716
740
 
717
741
  Strictness flags:
718
742
 
719
743
  - `nitpicky = True` is the default in this lineage. Each missing reference then logs a warning, which fails a build run with `-W`. Don't disable it; fix the missing target.
720
- - `click_extra_fail_on_warnings = ["myst.xref_missing"]` fails the build on a `[text](#anchor)` or `[text](page.md#anchor)` link that lands nowhere. myst-parser only logs that warning, and ships the link as written. Set it on a build that logs too many warnings to run with `-W`. The setting needs click-extra `9.4.0`: an older release ignores it, and the build passes. A `page.md#anchor` link to an ID that autodoc generates reports the same warning, though the ID exists: write it as a `{role}` cross-reference.
744
+ - `click_extra_fail_on_warnings = ["myst.xref_missing"]` fails the build on a `[text](#anchor)` or `[text](page.md#anchor)` link that lands nowhere. myst-parser only logs that warning, and ships the link as written. Set it on a build that logs too many warnings to run with `-W`. The setting needs click-extra `9.4.0`: an older release ignores it, and the build passes. A `page.md#anchor` link to an ID that autodoc generates reports the same warning, though the ID exists: write it as a `{role}` cross-reference. List `click_extra.todo_unrendered` beside it to also fail on a `{todo}` that no page renders, which needs click-extra `9.5.1`.
721
745
  - `autosectionlabel_prefix_document = True` avoids duplicate-label warnings when two pages have the same heading. Pair with `"sphinx.ext.autosectionlabel"` in `extensions`.
722
746
 
723
747
  `suppress_warnings` governance:
@@ -727,7 +751,6 @@ Strictness flags:
727
751
  - Canonical entries observed across sibling repos:
728
752
  - `sphinx_autodoc_typehints.forward_reference` — pytest decorators dynamically generated at import time; pytest's `Mark` type is unavailable during the docs build. Cosmetic.
729
753
  - `myst.directive` — empty mermaid directives produced by automated diagram generators with sparse data.
730
- - `myst.domains` — upstream limitation in `click_extra.sphinx` (no `resolve_any_xref` method on the click domain).
731
754
  - `myst.strikethrough` — `~~text~~` marks deprecated/incorrect spellings in docstrings; the project ships HTML only.
732
755
  - `myst.header` — `readme.md` starts at `## ` because GitHub supplies the H1 from the repo name; intentional.
733
756
  - `docutils` — code examples in docstrings whose indentation trips reST parsing; usually in test fixtures.
@@ -743,8 +766,9 @@ Theme assets and OpenGraph:
743
766
 
744
767
  - The sidebar logo is Furo's `light_logo`/`dark_logo` **pair** of theme options, set to `"logo-square-light.png"` and `"logo-square-dark.png"`. Never `html_logo`: Furo performs no dark-mode swap on a single logo, so the light-only `assets/logo-square.svg` keeps its near-black wordmark on the dark theme, where it lands around 1.2:1 against Furo's background. Both options must be set for the pair to render at all, and `html_logo` must be unset, since Furo's `sidebar/brand.html` prefers it and skips the pair when it is present. Furo resolves both names against `_static/`, so each PNG needs its own `html_static_path` entry (that setting accepts individual files, which land at the root of `_static/`; listing `docs/assets/` wholesale would copy every screenshot and report along with them). The two PNGs are same-aspect exports of the same SVG, so the swap holds geometry.
745
768
  - `html_favicon = "assets/favicon.svg"` is the canonical path, an SVG since browsers handle SVG favicons natively. The `/brand-assets` skill is the canonical producer of every one of these files: it manages the SVG sources (favicon, square logo, banner, social banner), exports light/dark PNG variants, and wires the new files into `docs/conf.py`. When they are missing or out of date, run `/brand-assets` instead of editing the assets by hand.
746
- - `ogp_image` names the social card, and the card is served by the site itself: add `assets/banner-social-<variant>.png` to `html_static_path` and set `ogp_image = "_static/banner-social-<variant>.png"`. `sphinxext.opengraph` joins that onto `ogp_site_url`, so every page emits the same absolute URL whatever its depth, one origin answers for it, and a redeploy refreshes it. Pair it with `ogp_image_alt = project`. What the path must never be is a bare `assets/...`: `docs/assets/` is not copied into the built site, so that resolves to a URL which 404s for the social crawlers that only ever see the raw HTML — the `html_static_path` entry is the whole reason the `_static/` spelling works. An absolute `raw.githubusercontent.com` URL also resolves and was the earlier rule here, but it hands a second origin a page asset and pins it to whatever sits on `main`. Set one or the other whenever the project has a banner; without `ogp_image`, `sphinxext.opengraph` falls back to the favicon, which scales poorly. Define `ogp_site_url` from the same constant `html_baseurl` reads, so the `og:url` a crawler gets can never name a different host than the canonical link beside it. The PNG is exported from `assets/banner-social.svg` by the `/brand-assets` skill (which also produces the dark variant for dark-mode social cards on platforms that support them).
769
+ - `ogp_image` names the social card, and the card is served by the site itself: add `assets/banner-social-<variant>.png` to `html_static_path` and set `ogp_image = "_static/banner-social-<variant>.png"`. `sphinxext.opengraph` joins that onto `ogp_site_url`, so every page emits the same absolute URL whatever its depth, one origin answers for it, and a redeploy refreshes it. Leave `ogp_image_alt` unset: the alt text then defaults to the site name, which is `project`. What the path must never be is a bare `assets/...`: `docs/assets/` is not copied into the built site, so that resolves to a URL which 404s for the social crawlers that only ever see the raw HTML — the `html_static_path` entry is the whole reason the `_static/` spelling works. An absolute `raw.githubusercontent.com` URL also resolves and was the earlier rule here, but it hands a second origin a page asset and pins it to whatever sits on `main`. Set one or the other whenever the project has a banner; without `ogp_image`, `sphinxext.opengraph` falls back to the favicon, which scales poorly. Define `ogp_site_url` from the same constant `html_baseurl` reads, so the `og:url` a crawler gets can never name a different host than the canonical link beside it. The PNG is exported from `assets/banner-social.svg` by the `/brand-assets` skill (which also produces the dark variant for dark-mode social cards on platforms that support them).
747
770
  - The Furo `announcement` banner template across this lineage references the same `github_user` constant defined at the top of `conf.py`. Rebuilding the announcement string locally inside `html_theme_options` avoids a per-theme override layer.
771
+ - When `index.md` includes a `readme.md` that opens on a centered banner, hide that banner on the site, where the sidebar already shows the logo: `article p[align="center"]:has(img[alt="{project}"]) { display: none; }` in `custom.css`.
748
772
 
749
773
  Pruning checklist before merging any `conf.py` change:
750
774
 
@@ -755,10 +779,12 @@ Pruning checklist before merging any `conf.py` change:
755
779
 
756
780
  ## Sphinx tests
757
781
 
758
- The build itself is the strongest test: `sphinx-build -W` fails on missing references, broken `{click:run}` examples, and unresolved typehints. Beyond that, two test patterns recur in this lineage and are worth keeping in mind:
782
+ The build itself is the strongest test: `sphinx-build -W` fails on missing references, a `{click:run}` block that raises, and unresolved typehints. Beyond that, four test patterns recur in this lineage and are worth keeping in mind:
759
783
 
760
784
  - **CLI directive tests** (e.g., `tests/sphinx/test_sphinx_click.py` in `click-extra`). Cover `{click:run}` and `{click:source}` directive options (`:show-source:`, `:hide-results:`, `:emphasize-lines:`, language overrides), runner-namespace persistence across blocks, exit-code propagation, and isolated-filesystem helpers. Only relevant for projects that *publish* their own Sphinx directive; consumer projects use the directives without testing them.
761
- - **Cross-reference render tests** (e.g., `tests/test_sphinx_crossrefs.py` in `extra-platforms`). Build the docs once via a `built_docs()` fixture, then parametrize over `(source page, link text, expected href)` triples to assert that rendered links resolve to the right anchors. Catches: a `{data}` cross-ref that silently 404s, a renamed symbol whose autodoc anchor changed, an `intersphinx_mapping` URL that drifted. Use `pytest.mark.xdist_group("sphinx")` with `--dist=loadgroup` in the pytest addopts, so the build runs in a single worker: the default `load` scheduler ignores the marker; gate the test on the docs floor (Linux + minimum Python the docs require).
785
+ - **Cross-reference render tests** (e.g., `tests/test_sphinx_crossrefs.py` in `extra-platforms`). Build the docs once via a `built_docs()` fixture, then parametrize over `(source page, link text, expected href)` triples to assert that rendered links resolve to the right anchors. Catches: a `{data}` cross-ref that silently 404s, a renamed symbol whose autodoc anchor changed, an `intersphinx_mapping` URL that drifted. Use `pytest.mark.xdist_group("sphinx")` with `--dist=loadgroup` in the pytest addopts, so the build runs in a single worker: the default `load` scheduler ignores the marker. pytest `9.2.0` with pytest-xdist `3.8.0` makes `loadgroup` ignore it too, so a build fixture that shares an output directory also holds an exclusive `fcntl.flock` on a file under `tmp_path_factory.getbasetemp().parent`. Gate the test on the docs floor (Linux + minimum Python the docs require).
786
+ - **Raw-Markdown anchor tests** (`tests/test_docs_anchors.py` in `click-extra`). Read every Markdown file as text and check that each fragment link also resolves on GitHub, which slugs a heading differently from the `make_id` ids Sphinx renders. A heading whose two slugs disagree carries an `<a name>` companion with the `make_id` spelling. The test needs no build and no network, so it runs where the render tests are skipped.
787
+ - **Directive assertion tests** (`tests/test_docs_directives.py` in `click-extra`). Read every Markdown file as text and require each `{click:run}` block, one with a lexer argument like `{click:run} sql` included, to carry at least one `assert`. The build fails only on a block that raises, and § Anchor docs with assertions says why a block that asserts nothing publishes its error.
762
788
 
763
789
  When introducing a new doc convention worth defending mechanically (e.g., "every CLI option must have an anchor"), prefer a render test over prose: a test that walks the rendered HTML catches drift the moment it lands, while a prose rule depends on a future reader noticing the violation.
764
790
 
@@ -790,7 +816,7 @@ Watch for these every pass:
790
816
  - New CLI subcommand merged but `docs/cli.md` not regenerated, leaving the summary table and per-command sections missing the new entry.
791
817
  - Captured `--help` output stuck on an old option set.
792
818
  - A new `[tool.repomatic]` field added without a docstring, producing an empty Description cell.
793
- - `{click:run}` blocks that fail at build time because the CLI was renamed: Sphinx logs the failure but the build still produces a page with a missing block.
819
+ - A `{click:run}` block that a rename left behind. A renamed import raises inside the block's `exec()`, which aborts the build. A renamed subcommand or option only exits with code 2: the build stays green and the page publishes the usage error, unless the block asserts `result.exit_code`.
794
820
  - Cross-references to docs/ pages from skills/agents that don't degrade gracefully when the target page is excluded downstream.
795
821
  - A `{toctree}` that outgrew the ~12-entry threshold and is still flat, or a captioned section left holding a single entry after pages moved around it. See § Grouping pages into sidebar sections.
796
822
  - An `automodule` block on a narrative page, repeating what the module's own API page already documents. Every such pair costs a duplicate object description per member and buries the guide's message; see § Guide pages carry the prose, API pages carry the API.
@@ -802,7 +828,7 @@ Watch for these every pass:
802
828
  - `click_extra.sphinx` listed in `extensions` without `click_extra_enable_exec_directives = True` in `conf.py`. Since click-extra `v7.15.0` the directives are off by default; without the flag, every `{click:run}` / `{click:source}` / `{python:*}` reference logs an "Unknown directive" warning and the page renders without the live block.
803
829
  - `suppress_warnings` entries that no longer fire because the upstream extension was fixed. Sweep on every upgrade — entries should grow stale and be removed, not accumulate.
804
830
  - Auto-region markers using bare `<!-- start -->` / `<!-- end -->` instead of named `<!-- {feature}-{kind} -->` / `<!-- {feature}-{kind}-end -->`. Migrate on first touch; the regenerator must be updated in the same commit.
805
- - Two pages on the same project using different octicons for the same concept (e.g., one page uses `book` for documentation, another uses `pencil`). Pick from the canonical registry in § Standard page roster › Title octicons; if none fit, add to the table.
831
+ - Two pages on the same project using different octicons for the same concept (e.g., one page uses `book` for documentation, another uses `pencil`). Pick from the canonical registry in § Standard page roster › Title octicons; if none fit, add a row.
806
832
  - `{click:run}` block whose `result.output` is missing ANSI codes despite the example being about colored output. `runner.invoke(color=True)` controls Click's TTY emulation, but click-extra's `--color/--no-color` callback re-evaluates from the env-var family (`NO_COLOR`, `FORCE_COLOR`, `CLICOLOR`, …) and overrides the runner's flag. The reliable fix is to pass `env={"FORCE_COLOR": "1"}` to the invocation: `result = invoke(cli, args=[...], env={"FORCE_COLOR": "1"})`. Symptom in the rendered HTML: a code block with `<span class="gp">$ </span>` for the prompt and plain unstyled text for everything else, no `-Ansi-*` classes anywhere in the output region.
807
833
  - A `{click:run}` block invoking `--version`. Under the directive runner, click-extra's version option resolves the owning package by frame inspection, walks into Sphinx's own frames, and prints Sphinx's version wearing the CLI's name ("Click Extra, version 9.1.0" while the package sat at `8.7.0.dev0`). Keep version examples as command-only `shell-session` blocks; `--help` renders are unaffected because help text does no package detection.
808
834
  - Sphinx auto-anchor slugs strip leading digits. `## 256-color palette swatch` → `#color-palette-swatch`, `## 24-bit true color` → `#bit-true-color`. Plan link targets accordingly: when writing `[text](#anchor)` cross-refs, derive the anchor from the heading minus any leading digits, or add an explicit `(canonical-anchor)=` directly above the heading.