roadkeep 0.2.0__tar.gz → 0.2.576__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 (192) hide show
  1. roadkeep-0.2.576/PKG-INFO +299 -0
  2. roadkeep-0.2.576/README.md +269 -0
  3. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/__init__.py +1 -1
  4. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/adopting.py +908 -59
  5. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/authoring.py +574 -85
  6. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/backlog.py +388 -11
  7. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/blocking.py +253 -26
  8. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/briefing.py +407 -43
  9. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/budgeting.py +1137 -19
  10. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/capturing.py +67 -20
  11. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/claiming.py +55 -18
  12. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/cli.py +349 -38
  13. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/config.py +1026 -50
  14. roadkeep-0.2.576/plugin/src/roadkeep/counting.py +859 -0
  15. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/criteria.py +22 -12
  16. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/deferring.py +205 -17
  17. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/describing.py +150 -9
  18. roadkeep-0.2.576/plugin/src/roadkeep/dismissing.py +593 -0
  19. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/exporting.py +1 -1
  20. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/fixing.py +50 -7
  21. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/governing.py +356 -19
  22. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/guarding.py +301 -33
  23. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/history.py +783 -74
  24. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/ids.py +7 -2
  25. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/installing.py +1400 -65
  26. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/kernel/document.py +37 -2
  27. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/kernel/schema.py +351 -8
  28. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/linting.py +961 -33
  29. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/locking.py +101 -10
  30. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/markers.py +7 -1
  31. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/picking.py +190 -15
  32. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/provenance.py +325 -4
  33. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/queueing.py +14 -7
  34. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/ranking.py +91 -12
  35. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/referring.py +22 -0
  36. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/remaining.py +161 -7
  37. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/remedying.py +521 -28
  38. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/rendering.py +516 -3
  39. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/renumbering.py +3 -3
  40. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/reverting.py +9 -9
  41. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/scoping.py +167 -12
  42. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/sections.py +273 -49
  43. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/serving.py +622 -43
  44. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/shipping.py +971 -111
  45. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/showing.py +386 -19
  46. roadkeep-0.2.576/plugin/src/roadkeep/validating.py +680 -0
  47. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/verbs/adopting.py +465 -64
  48. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/verbs/authoring.py +285 -67
  49. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/verbs/declaring.py +126 -9
  50. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/verbs/linting.py +64 -38
  51. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/verbs/querying.py +982 -255
  52. roadkeep-0.2.576/plugin/src/roadkeep/verbs/refusing.py +429 -0
  53. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/verbs/sections.py +217 -238
  54. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/verbs/shipping.py +358 -91
  55. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/weighing.py +150 -2
  56. roadkeep-0.2.576/plugin/src/roadkeep.egg-info/PKG-INFO +299 -0
  57. roadkeep-0.2.576/plugin/src/roadkeep.egg-info/SOURCES.txt +177 -0
  58. {roadkeep-0.2.0 → roadkeep-0.2.576}/pyproject.toml +9 -2
  59. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_adopting.py +561 -19
  60. roadkeep-0.2.576/tests/test_advisories.py +457 -0
  61. roadkeep-0.2.576/tests/test_answers.py +855 -0
  62. roadkeep-0.2.576/tests/test_area.py +299 -0
  63. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_asking.py +19 -2
  64. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_authoring.py +378 -4
  65. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_backlog.py +289 -0
  66. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_backstop.py +77 -3
  67. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_blocking.py +346 -0
  68. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_briefing.py +267 -6
  69. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_budgeted.py +1 -1
  70. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_budgeting.py +1591 -4
  71. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_caches.py +1 -1
  72. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_capturing.py +195 -18
  73. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_carrying.py +25 -5
  74. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_checkout.py +2 -2
  75. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_claiming.py +118 -1
  76. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_commanding.py +63 -0
  77. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_commands.py +30 -2
  78. roadkeep-0.2.576/tests/test_composed.py +151 -0
  79. roadkeep-0.2.576/tests/test_composing.py +2325 -0
  80. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_config.py +397 -1
  81. roadkeep-0.2.576/tests/test_configured.py +565 -0
  82. roadkeep-0.2.576/tests/test_contents.py +123 -0
  83. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_corpora.py +168 -1
  84. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_counting.py +483 -3
  85. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_criteria.py +330 -2
  86. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_cycles.py +19 -0
  87. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_deferring.py +288 -0
  88. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_describing.py +54 -1
  89. roadkeep-0.2.576/tests/test_dismissing.py +456 -0
  90. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_document.py +80 -10
  91. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_doors.py +9 -4
  92. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_doors_in_both_registers.py +5 -2
  93. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_editor.py +119 -22
  94. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_encoding.py +119 -1
  95. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_events.py +51 -1
  96. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_exporting.py +13 -6
  97. roadkeep-0.2.576/tests/test_figures.py +191 -0
  98. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_findings.py +19 -14
  99. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_fixing.py +31 -3
  100. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_governing.py +451 -8
  101. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_guarding.py +135 -8
  102. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_history.py +660 -2
  103. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_importing.py +258 -0
  104. roadkeep-0.2.576/tests/test_installing.py +3638 -0
  105. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_invariants.py +285 -12
  106. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_kernel.py +8 -2
  107. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_launching.py +311 -13
  108. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_linting.py +547 -9
  109. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_locking.py +46 -5
  110. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_merging.py +7 -3
  111. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_model_page.py +2 -2
  112. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_namespaces.py +12 -4
  113. roadkeep-0.2.576/tests/test_naming.py +185 -0
  114. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_owned.py +2 -2
  115. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_packaging.py +185 -23
  116. roadkeep-0.2.576/tests/test_pairs.py +909 -0
  117. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_payloads.py +357 -26
  118. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_picking.py +329 -1
  119. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_plugin.py +46 -26
  120. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_prevention.py +81 -3
  121. roadkeep-0.2.576/tests/test_priced.py +77 -0
  122. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_provenance.py +75 -2
  123. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_queueing.py +59 -0
  124. roadkeep-0.2.576/tests/test_quoting.py +84 -0
  125. roadkeep-0.2.576/tests/test_ranking.py +915 -0
  126. roadkeep-0.2.576/tests/test_reading.py +195 -0
  127. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_recording.py +119 -1
  128. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_reference.py +30 -12
  129. roadkeep-0.2.576/tests/test_registers.py +292 -0
  130. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_remaining.py +107 -1
  131. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_remedying.py +348 -8
  132. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_renumbering.py +3 -0
  133. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_repairing.py +59 -1
  134. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_replaying.py +7 -1
  135. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_retiring.py +158 -0
  136. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_reverting.py +4 -1
  137. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_schema.py +132 -2
  138. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_scoping.py +628 -1
  139. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_screening.py +2 -2
  140. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_sections.py +164 -9
  141. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_serving.py +591 -22
  142. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_session_page.py +2 -2
  143. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_shipping.py +629 -3
  144. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_showing.py +335 -6
  145. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_skill.py +188 -17
  146. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_spelling.py +16 -0
  147. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_status.py +33 -4
  148. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_surfaces.py +236 -17
  149. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_turning.py +7 -6
  150. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_twins.py +8 -8
  151. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_unpaired.py +4 -4
  152. roadkeep-0.2.576/tests/test_validating.py +496 -0
  153. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_walkthrough.py +15 -4
  154. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_weighing.py +240 -2
  155. roadkeep-0.2.0/PKG-INFO +0 -453
  156. roadkeep-0.2.0/README.md +0 -423
  157. roadkeep-0.2.0/src/roadkeep/counting.py +0 -376
  158. roadkeep-0.2.0/src/roadkeep/verbs/refusing.py +0 -146
  159. roadkeep-0.2.0/src/roadkeep.egg-info/PKG-INFO +0 -453
  160. roadkeep-0.2.0/src/roadkeep.egg-info/SOURCES.txt +0 -164
  161. roadkeep-0.2.0/tests/test_answers.py +0 -342
  162. roadkeep-0.2.0/tests/test_area.py +0 -212
  163. roadkeep-0.2.0/tests/test_composing.py +0 -387
  164. roadkeep-0.2.0/tests/test_configured.py +0 -145
  165. roadkeep-0.2.0/tests/test_installing.py +0 -1881
  166. roadkeep-0.2.0/tests/test_pairs.py +0 -304
  167. roadkeep-0.2.0/tests/test_ranking.py +0 -323
  168. {roadkeep-0.2.0 → roadkeep-0.2.576}/LICENSE +0 -0
  169. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/attesting.py +0 -0
  170. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/commanding.py +0 -0
  171. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/graph.py +0 -0
  172. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/kernel/__init__.py +0 -0
  173. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/merging.py +0 -0
  174. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/repairing.py +0 -0
  175. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/screening.py +0 -0
  176. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/storing.py +0 -0
  177. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/verbs/__init__.py +0 -0
  178. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep/verbs/reading.py +0 -0
  179. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep.egg-info/dependency_links.txt +0 -0
  180. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep.egg-info/entry_points.txt +0 -0
  181. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep.egg-info/requires.txt +0 -0
  182. {roadkeep-0.2.0 → roadkeep-0.2.576/plugin}/src/roadkeep.egg-info/top_level.txt +0 -0
  183. {roadkeep-0.2.0 → roadkeep-0.2.576}/setup.cfg +0 -0
  184. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_attesting.py +0 -0
  185. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_baseline.py +0 -0
  186. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_graph.py +0 -0
  187. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_hinting.py +0 -0
  188. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_ids.py +0 -0
  189. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_markers.py +0 -0
  190. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_referring.py +0 -0
  191. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_shadowing.py +0 -0
  192. {roadkeep-0.2.0 → roadkeep-0.2.576}/tests/test_storing.py +0 -0
@@ -0,0 +1,299 @@
1
+ Metadata-Version: 2.4
2
+ Name: roadkeep
3
+ Version: 0.2.576
4
+ Summary: Owns the writes to a project's ROADMAP, CHANGELOG, IMPROVEMENTS and STRATEGY files, so the format is a schema at the point of insertion.
5
+ Author: Alexandre Oliveira
6
+ License-Expression: Apache-2.0
7
+ Project-URL: Homepage, https://github.com/alegauss/roadkeep
8
+ Project-URL: Repository, https://github.com/alegauss/roadkeep
9
+ Project-URL: Issues, https://github.com/alegauss/roadkeep/issues
10
+ Project-URL: Changelog, https://github.com/alegauss/roadkeep/blob/main/docs/CHANGELOG.md
11
+ Keywords: roadmap,changelog,markdown,backlog,linter,pre-commit,agents,claude-code
12
+ Classifier: Development Status :: 4 - Beta
13
+ Classifier: Environment :: Console
14
+ Classifier: Intended Audience :: Developers
15
+ Classifier: Operating System :: OS Independent
16
+ Classifier: Programming Language :: Python :: 3
17
+ Classifier: Programming Language :: Python :: 3.11
18
+ Classifier: Programming Language :: Python :: 3.12
19
+ Classifier: Programming Language :: Python :: 3.13
20
+ Classifier: Topic :: Software Development :: Documentation
21
+ Classifier: Topic :: Software Development :: Quality Assurance
22
+ Classifier: Topic :: Text Processing :: Markup :: Markdown
23
+ Requires-Python: >=3.11
24
+ Description-Content-Type: text/markdown
25
+ License-File: LICENSE
26
+ Provides-Extra: dev
27
+ Requires-Dist: pytest>=8; extra == "dev"
28
+ Requires-Dist: pytest-xdist>=3; extra == "dev"
29
+ Dynamic: license-file
30
+
31
+ <!--
32
+ Assets in site/public/assets/ — the mark is task lines cut at a gate, with the refused
33
+ remainder faded beyond it. The SVGs follow the reader's light/dark theme; a PNG
34
+ cannot, so each carries a fixed dark palette.
35
+
36
+ roadkeep-mark.svg 160x160 icon, the header below. Absolute and served by the
37
+ site because this file is also the PyPI project page
38
+ (RK19): a relative path resolves against pypi.org, and
39
+ raw.githubusercontent serves an SVG as text/plain.
40
+ Every link below is absolute for the same reason.
41
+ roadkeep-logo.svg 520x160 mark + wordmark
42
+ roadkeep-banner.svg 1200x300 banner source
43
+ roadkeep-banner.png 1200x300 banner
44
+ roadkeep-social.svg 1280x640 source for the link preview
45
+ roadkeep-social.png 1280x640 upload at Settings > General > Social preview.
46
+ This is what renders when the repo URL is pasted
47
+ into LinkedIn, Slack or a link card anywhere else.
48
+ Re-render either PNG after editing its SVG:
49
+ msedge --headless=new --window-size=1200,300 \
50
+ --screenshot=site/public/assets/roadkeep-banner.png \
51
+ file:///.../site/public/assets/roadkeep-banner.svg
52
+ -->
53
+
54
+ <div align="center">
55
+
56
+ <img src="https://alegauss.github.io/roadkeep/assets/roadkeep-mark.svg" alt="roadkeep logo" width="120">
57
+
58
+ # roadkeep
59
+
60
+ **Stop paying tokens to keep your docs.** A Claude Code plugin that turns your `ROADMAP.md`
61
+ and `CHANGELOG.md` into a format a command enforces, so the agent calls one command
62
+ instead of reading, rewriting and re-checking the file.
63
+
64
+ ```sh
65
+ claude plugin marketplace add alegauss/roadkeep --scope project
66
+ claude plugin install roadkeep@alegauss --scope project
67
+ ```
68
+
69
+ Python 3.11+ · zero runtime dependencies · your files stay plain Markdown
70
+
71
+ **[alegauss.github.io/roadkeep](https://alegauss.github.io/roadkeep/)** · [docs](https://alegauss.github.io/roadkeep/docs/)
72
+
73
+ </div>
74
+
75
+ - **Measured where it hurt.** On a real project the roadmap averaged 142 words a line against
76
+ a one-sentence rule, and `agents.md` reached 186 KB. Every one of those words is context
77
+ the agent reads again on the next turn.
78
+ - **Refused before the prose exists.** A line has fields with limits, so an over-long one is
79
+ refused when it is written, not reported by a linter after the tokens are spent.
80
+ - **A hand-edit is denied, with the command to call instead.** The hook names the exact
81
+ `add`, `ship` or `status`, so the right path is also the cheapest one.
82
+ - **Ask instead of read.** `pick`, `brief` and `list` answer what is next and why, so an agent
83
+ never reads a whole backlog to find one line.
84
+ - **Your existing files.** One line per task in the `ROADMAP.md` you already have; nothing to
85
+ migrate into.
86
+
87
+ ---
88
+
89
+ > **Unofficial / community project.** Not affiliated with, endorsed by, or sponsored by
90
+ > Anthropic. "Claude" and "Claude Code" are trademarks of Anthropic.
91
+
92
+ ## Install
93
+
94
+ Run the two commands above in the repository you want governed. You need a **Python 3.11+**
95
+ interpreter as `python`; the plugin carries the package itself, so there is nothing to
96
+ `pip install`.
97
+
98
+ `--scope project` writes both declarations into that repository's `.claude/settings.json`:
99
+
100
+ ```jsonc
101
+ "extraKnownMarketplaces": { "alegauss": { "source": { "source": "github", "repo": "alegauss/roadkeep" } } },
102
+ "enabledPlugins": { "roadkeep@alegauss": true }
103
+ ```
104
+
105
+ Commit that file and **every clone is wired**, with no step per machine. What arrives:
106
+
107
+ - the **hook** that denies a hand-edit of a governed file and names the command, and runs
108
+ `lint` before the turn ends;
109
+ - the **MCP tools** (`mcp__roadkeep__*`), whose input schema is *your* project's: its limits,
110
+ its markers, its id shape;
111
+ - four **slash commands**, `/roadkeep:add`, `/roadkeep:ship`, `/roadkeep:pick` and
112
+ `/roadkeep:lint`;
113
+ - the **skill**, loaded only when a governed file is in play.
114
+
115
+ Inside an interactive session, `/plugin marketplace add alegauss/roadkeep` and
116
+ `/plugin install roadkeep@alegauss` do the same for your user alone.
117
+
118
+ ## First session
119
+
120
+ The format is declared once per repository, in `roadkeep.toml`. Ask for it:
121
+
122
+ > Adopt docs/ROADMAP.md under roadkeep, with the prefix SH.
123
+
124
+ For a backlog you already have, that runs `adopt` first, which measures your file and reports
125
+ what a limit would refuse before anything changes. Then it runs `init --existing`, which
126
+ declares your roadmap untouched: the prefix comes off the ids it already carries and the
127
+ blocks off its own headings. On a new project, a bare `init` writes the config and the empty
128
+ files. Years of lines written before the rules can be forgiven by name with `--baseline`, so
129
+ the gate goes into CI on the first day. The whole run, with every refusal it printed, is in
130
+ [Adopting a backlog you already have](https://alegauss.github.io/roadkeep/docs/adopting/).
131
+
132
+ From then on, ask in plain words:
133
+
134
+ > Add a task to block B: the export drops the last line when the file has no trailing newline.
135
+
136
+ > What should I work on next?
137
+
138
+ > Ship RK12: export keeps the last line.
139
+
140
+ Claude calls `add`, `pick` and `ship`. If the symptom is too long, the refusal says by how
141
+ much, and `ship` moves the line to the changelog and drops its rationale section in one write.
142
+ If Claude reaches for `Edit` on the roadmap out of habit, the hook stops it and names the call.
143
+ [In a session](https://alegauss.github.io/roadkeep/docs/session/) covers everything the agent
144
+ receives.
145
+
146
+ ## Run it as a gate
147
+
148
+ `roadkeep lint` exits **1** on a file that drifted and **0** on one that did not. That exit
149
+ code is the whole contract, so every surface calls the same command: the plugin's hook at
150
+ the end of a turn, a pre-commit hook and a GitHub Action, and every finding names the
151
+ command that fixes it:
152
+
153
+ ```yaml
154
+ # .github/workflows/gate.yml — the action this repository ships
155
+ steps:
156
+ - uses: actions/checkout@v4
157
+ - uses: alegauss/roadkeep@v0 # with: {directory: .}
158
+
159
+ # .pre-commit-config.yaml — the same command, one step earlier
160
+ repos:
161
+ - repo: https://github.com/alegauss/roadkeep
162
+ rev: v0.2.0 # a release tag; `main` tracks unreleased
163
+ hooks:
164
+ - id: roadkeep-lint # or roadkeep-lint-fix, which normalizes first
165
+ ```
166
+
167
+ `--fix` repairs only what the format *derives* — the dep annotation, the pointer, dep order,
168
+ an invisible codepoint, whitespace around a field, a queue entry whose task has left, a
169
+ criteria heading addressed to nothing — and
170
+ leaves every editorial finding to a human, which is what keeps a first run on a real backlog
171
+ down to a report somebody reads.
172
+
173
+ Every finding names the command that closes it. `roadkeep repair` runs the ones that need no
174
+ decision, `repair --dry-run` prints them without running, and `roadkeep explain <code>` says
175
+ what a finding code means.
176
+
177
+ ## Without Claude Code
178
+
179
+ ```sh
180
+ uvx roadkeep lint # no install, no checkout
181
+ pip install roadkeep # or into an environment you keep
182
+
183
+ # A fix that is on main and not yet released: the same run, resolved by URL
184
+ uvx --from git+https://github.com/alegauss/roadkeep roadkeep lint
185
+ ```
186
+
187
+ Every command takes `--json`, which also says which file and line the answer came from.
188
+
189
+ ### On Claude Code on the web
190
+
191
+ [Claude Code on the web](https://code.claude.com/docs/en/claude-code-on-the-web) never
192
+ installs a marketplace plugin. It reads only what the repository commits, so the plugin
193
+ commands above wire nothing there, and an agent with no guard falls back to hand-editing the
194
+ governed files. The fix is a small launcher committed to the repository, which the hook and
195
+ the MCP server point at instead of the plugin root. It finds an engine at run time, and its
196
+ guard stands down where the plugin is installed. [Viglet Shio](https://github.com/openviglet/shio) carries
197
+ the reference copy at
198
+ [`.claude/hooks/roadkeep-launch.py`](https://github.com/openviglet/shio/blob/main/.claude/hooks/roadkeep-launch.py),
199
+ and [In a session](https://alegauss.github.io/roadkeep/docs/session/) explains the wiring.
200
+
201
+ ### From a checkout beside it
202
+
203
+ A project adopting an unreleased version runs a sibling checkout, and `install` writes the
204
+ hook, the MCP server and the skill into that project itself:
205
+
206
+ ```sh
207
+ python ../roadkeep/plugin/scripts/roadkeep.py -C . install
208
+ python ../roadkeep/plugin/scripts/roadkeep.py -C . install --check # in CI: still in step?
209
+ ```
210
+
211
+ ## Why it exists
212
+
213
+ It started as three readings from a real production repository, where all three files
214
+ declared a format and none enforced it:
215
+
216
+ | Artefact | Declared rule | Actual reading |
217
+ |---|---|---|
218
+ | `docs/ROADMAP.md` | one sentence per task | 92 lines, **142 words** average, worst **1406 characters** |
219
+ | `agents.md` | index only, loaded every turn | grew to **186 KB (~46k tokens)** |
220
+ | `docs/IMPROVEMENTS.md` | rationale for *unshipped* work | a sibling project's reached **539 KB** |
221
+
222
+ Six of the eight worst lines were written in the session that then diagnosed the problem. An
223
+ author, human or model, who has the whole design in mind writes it where the reader is, and an
224
+ instruction to be terse does not survive that. A linter reports after the prose exists, when
225
+ the author is asked to delete work just done. A field with `maxLength: 200` refuses before the
226
+ sentence is composed.
227
+
228
+ Six laws bind the design, and a change that breaks one is wrong even if requested
229
+ ([§0.3](https://github.com/alegauss/roadkeep/blob/main/docs/IMPROVEMENTS.md)):
230
+
231
+ | # | Law |
232
+ |---|---|
233
+ | L1 | The format is a schema, **enforced where the text is created**; `lint` is the backstop. |
234
+ | L2 | **The store is the repository**: Markdown, greppable, diffable. No database, no service. |
235
+ | L3 | **Round-trip or don't write**: parse → render → byte-identical. |
236
+ | L4 | **The tool never writes prose**: it validates and renders. |
237
+ | L5 | **Query instead of read**: every question is a command. |
238
+ | L6 | **Configuration, not convention**: prefix, paths, markers and limits are per project. |
239
+
240
+ The non-goals: no web UI and no server, no issue-tracker sync, no model and no prompts inside
241
+ the tool, and no dates, quarters or estimates.
242
+
243
+ ## Status
244
+
245
+ The table below is **not written by hand**: `roadkeep export --readme` derives it from
246
+ `docs/`, so it cannot restate a backlog it no longer matches.
247
+
248
+ <!-- roadkeep:begin -->
249
+ <!-- generated by `roadkeep export --readme`; edit the governed files instead -->
250
+
251
+ | Block | Open | Shipped | Retired |
252
+ | --- | --- | --- | --- |
253
+ | A — The model (a task is data before it is a line) | 0 | 46 | 2 |
254
+ | B — Authoring (insert, never hand-edit) | 0 | 239 | 2 |
255
+ | C — Query (consult without reading the file) | 0 | 205 | 7 |
256
+ | D — The gate | 0 | 319 | 7 |
257
+ | E — Adoption | 0 | 127 | 1 |
258
+ | F — The Claude Code plugin (the guardrail at the agent boundary) | 0 | 169 | 4 |
259
+ | G — The editor surface (the backlog where the file is open) | 0 | 15 | 0 |
260
+ | H — The tool's own shape (what one verb costs to change) | 0 | 45 | 1 |
261
+ | I — The documentation area (what an adopter reads before there is a session to ask) | 0 | 22 | 0 |
262
+ | J — Validation (whether a person ever tried it) | 0 | 5 | 0 |
263
+ | K — The desktop app (one installer for the reader and the plugin) | 0 | 9 | 0 |
264
+ | L — Product sites on the package | 1 | 2 | 0 |
265
+ | M — Codex integration (one engine, host-specific adapters) | 9 | 0 | 0 |
266
+ | **Total** | 10 | 1203 | 24 |
267
+
268
+ **Next ready:**
269
+
270
+ - 📋 **RK1730** (deps: —) **The guard ignores Codex apply_patch calls that edit governed files** — Recognize Codex patch targets before execution so roadmap ownership also applies to the native editing tool. → §RK1730
271
+ <!-- roadkeep:end -->
272
+
273
+ Open work is in
274
+ [docs/ROADMAP.md](https://github.com/alegauss/roadkeep/blob/main/docs/ROADMAP.md). Every
275
+ repository of its author is governed by it, and these have a public roadmap to read:
276
+ [Turing](https://github.com/openviglet/turing/blob/2026.3/docs/ROADMAP.md),
277
+ [Shio](https://github.com/openviglet/shio/blob/2026.3/docs/ROADMAP.md),
278
+ [Dumont](https://github.com/openviglet/dumont/blob/2026.3/docs/ROADMAP.md),
279
+ [polyweave](https://github.com/alegauss/polyweave/blob/main/docs/ROADMAP.md),
280
+ [winwright](https://github.com/alegauss/winwright/blob/main/docs/ROADMAP.md) and
281
+ [commitclerk](https://github.com/alegauss/commitclerk/blob/main/docs/ROADMAP.md). No adopter
282
+ outside the author is known yet. This repository is its
283
+ own conformance fixture: `roadkeep lint` must pass on `docs/` here, and the suite asserts it.
284
+
285
+ ## More tools by alegauss
286
+
287
+ For Claude Code:
288
+
289
+ - **[Claude Code Tray](https://alegauss.github.io/claude-tray/)**: your rate-limit usage as a Windows tray icon that turns red before you run out.
290
+ - **[commitclerk](https://alegauss.github.io/commitclerk/)**: Conventional Commits messages from your staged diff, in a single-file Python CLI.
291
+ - **[polyweave](https://alegauss.github.io/polyweave/)**: a Claude Code plugin that makes a game's 3D assets, sounds and names by declaring what each has to satisfy.
292
+
293
+ For Windows developers:
294
+
295
+ - **[winwright](https://alegauss.github.io/winwright/)**: drives a Windows desktop app from a test and reports what was actually observed.
296
+ - **[FreeHarbor](https://alegauss.github.io/freeharbor/)**: Docker on Windows without Docker Desktop, with no admin prompt and no telemetry.
297
+ - **[Quickshell](https://alegauss.github.io/quickshell/)**: an SSH client for Windows with sessions, keys, SFTP and tunnels, and without the rest of the suite.
298
+
299
+ All of them: [alegauss.github.io](https://alegauss.github.io/)
@@ -0,0 +1,269 @@
1
+ <!--
2
+ Assets in site/public/assets/ — the mark is task lines cut at a gate, with the refused
3
+ remainder faded beyond it. The SVGs follow the reader's light/dark theme; a PNG
4
+ cannot, so each carries a fixed dark palette.
5
+
6
+ roadkeep-mark.svg 160x160 icon, the header below. Absolute and served by the
7
+ site because this file is also the PyPI project page
8
+ (RK19): a relative path resolves against pypi.org, and
9
+ raw.githubusercontent serves an SVG as text/plain.
10
+ Every link below is absolute for the same reason.
11
+ roadkeep-logo.svg 520x160 mark + wordmark
12
+ roadkeep-banner.svg 1200x300 banner source
13
+ roadkeep-banner.png 1200x300 banner
14
+ roadkeep-social.svg 1280x640 source for the link preview
15
+ roadkeep-social.png 1280x640 upload at Settings > General > Social preview.
16
+ This is what renders when the repo URL is pasted
17
+ into LinkedIn, Slack or a link card anywhere else.
18
+ Re-render either PNG after editing its SVG:
19
+ msedge --headless=new --window-size=1200,300 \
20
+ --screenshot=site/public/assets/roadkeep-banner.png \
21
+ file:///.../site/public/assets/roadkeep-banner.svg
22
+ -->
23
+
24
+ <div align="center">
25
+
26
+ <img src="https://alegauss.github.io/roadkeep/assets/roadkeep-mark.svg" alt="roadkeep logo" width="120">
27
+
28
+ # roadkeep
29
+
30
+ **Stop paying tokens to keep your docs.** A Claude Code plugin that turns your `ROADMAP.md`
31
+ and `CHANGELOG.md` into a format a command enforces, so the agent calls one command
32
+ instead of reading, rewriting and re-checking the file.
33
+
34
+ ```sh
35
+ claude plugin marketplace add alegauss/roadkeep --scope project
36
+ claude plugin install roadkeep@alegauss --scope project
37
+ ```
38
+
39
+ Python 3.11+ · zero runtime dependencies · your files stay plain Markdown
40
+
41
+ **[alegauss.github.io/roadkeep](https://alegauss.github.io/roadkeep/)** · [docs](https://alegauss.github.io/roadkeep/docs/)
42
+
43
+ </div>
44
+
45
+ - **Measured where it hurt.** On a real project the roadmap averaged 142 words a line against
46
+ a one-sentence rule, and `agents.md` reached 186 KB. Every one of those words is context
47
+ the agent reads again on the next turn.
48
+ - **Refused before the prose exists.** A line has fields with limits, so an over-long one is
49
+ refused when it is written, not reported by a linter after the tokens are spent.
50
+ - **A hand-edit is denied, with the command to call instead.** The hook names the exact
51
+ `add`, `ship` or `status`, so the right path is also the cheapest one.
52
+ - **Ask instead of read.** `pick`, `brief` and `list` answer what is next and why, so an agent
53
+ never reads a whole backlog to find one line.
54
+ - **Your existing files.** One line per task in the `ROADMAP.md` you already have; nothing to
55
+ migrate into.
56
+
57
+ ---
58
+
59
+ > **Unofficial / community project.** Not affiliated with, endorsed by, or sponsored by
60
+ > Anthropic. "Claude" and "Claude Code" are trademarks of Anthropic.
61
+
62
+ ## Install
63
+
64
+ Run the two commands above in the repository you want governed. You need a **Python 3.11+**
65
+ interpreter as `python`; the plugin carries the package itself, so there is nothing to
66
+ `pip install`.
67
+
68
+ `--scope project` writes both declarations into that repository's `.claude/settings.json`:
69
+
70
+ ```jsonc
71
+ "extraKnownMarketplaces": { "alegauss": { "source": { "source": "github", "repo": "alegauss/roadkeep" } } },
72
+ "enabledPlugins": { "roadkeep@alegauss": true }
73
+ ```
74
+
75
+ Commit that file and **every clone is wired**, with no step per machine. What arrives:
76
+
77
+ - the **hook** that denies a hand-edit of a governed file and names the command, and runs
78
+ `lint` before the turn ends;
79
+ - the **MCP tools** (`mcp__roadkeep__*`), whose input schema is *your* project's: its limits,
80
+ its markers, its id shape;
81
+ - four **slash commands**, `/roadkeep:add`, `/roadkeep:ship`, `/roadkeep:pick` and
82
+ `/roadkeep:lint`;
83
+ - the **skill**, loaded only when a governed file is in play.
84
+
85
+ Inside an interactive session, `/plugin marketplace add alegauss/roadkeep` and
86
+ `/plugin install roadkeep@alegauss` do the same for your user alone.
87
+
88
+ ## First session
89
+
90
+ The format is declared once per repository, in `roadkeep.toml`. Ask for it:
91
+
92
+ > Adopt docs/ROADMAP.md under roadkeep, with the prefix SH.
93
+
94
+ For a backlog you already have, that runs `adopt` first, which measures your file and reports
95
+ what a limit would refuse before anything changes. Then it runs `init --existing`, which
96
+ declares your roadmap untouched: the prefix comes off the ids it already carries and the
97
+ blocks off its own headings. On a new project, a bare `init` writes the config and the empty
98
+ files. Years of lines written before the rules can be forgiven by name with `--baseline`, so
99
+ the gate goes into CI on the first day. The whole run, with every refusal it printed, is in
100
+ [Adopting a backlog you already have](https://alegauss.github.io/roadkeep/docs/adopting/).
101
+
102
+ From then on, ask in plain words:
103
+
104
+ > Add a task to block B: the export drops the last line when the file has no trailing newline.
105
+
106
+ > What should I work on next?
107
+
108
+ > Ship RK12: export keeps the last line.
109
+
110
+ Claude calls `add`, `pick` and `ship`. If the symptom is too long, the refusal says by how
111
+ much, and `ship` moves the line to the changelog and drops its rationale section in one write.
112
+ If Claude reaches for `Edit` on the roadmap out of habit, the hook stops it and names the call.
113
+ [In a session](https://alegauss.github.io/roadkeep/docs/session/) covers everything the agent
114
+ receives.
115
+
116
+ ## Run it as a gate
117
+
118
+ `roadkeep lint` exits **1** on a file that drifted and **0** on one that did not. That exit
119
+ code is the whole contract, so every surface calls the same command: the plugin's hook at
120
+ the end of a turn, a pre-commit hook and a GitHub Action, and every finding names the
121
+ command that fixes it:
122
+
123
+ ```yaml
124
+ # .github/workflows/gate.yml — the action this repository ships
125
+ steps:
126
+ - uses: actions/checkout@v4
127
+ - uses: alegauss/roadkeep@v0 # with: {directory: .}
128
+
129
+ # .pre-commit-config.yaml — the same command, one step earlier
130
+ repos:
131
+ - repo: https://github.com/alegauss/roadkeep
132
+ rev: v0.2.0 # a release tag; `main` tracks unreleased
133
+ hooks:
134
+ - id: roadkeep-lint # or roadkeep-lint-fix, which normalizes first
135
+ ```
136
+
137
+ `--fix` repairs only what the format *derives* — the dep annotation, the pointer, dep order,
138
+ an invisible codepoint, whitespace around a field, a queue entry whose task has left, a
139
+ criteria heading addressed to nothing — and
140
+ leaves every editorial finding to a human, which is what keeps a first run on a real backlog
141
+ down to a report somebody reads.
142
+
143
+ Every finding names the command that closes it. `roadkeep repair` runs the ones that need no
144
+ decision, `repair --dry-run` prints them without running, and `roadkeep explain <code>` says
145
+ what a finding code means.
146
+
147
+ ## Without Claude Code
148
+
149
+ ```sh
150
+ uvx roadkeep lint # no install, no checkout
151
+ pip install roadkeep # or into an environment you keep
152
+
153
+ # A fix that is on main and not yet released: the same run, resolved by URL
154
+ uvx --from git+https://github.com/alegauss/roadkeep roadkeep lint
155
+ ```
156
+
157
+ Every command takes `--json`, which also says which file and line the answer came from.
158
+
159
+ ### On Claude Code on the web
160
+
161
+ [Claude Code on the web](https://code.claude.com/docs/en/claude-code-on-the-web) never
162
+ installs a marketplace plugin. It reads only what the repository commits, so the plugin
163
+ commands above wire nothing there, and an agent with no guard falls back to hand-editing the
164
+ governed files. The fix is a small launcher committed to the repository, which the hook and
165
+ the MCP server point at instead of the plugin root. It finds an engine at run time, and its
166
+ guard stands down where the plugin is installed. [Viglet Shio](https://github.com/openviglet/shio) carries
167
+ the reference copy at
168
+ [`.claude/hooks/roadkeep-launch.py`](https://github.com/openviglet/shio/blob/main/.claude/hooks/roadkeep-launch.py),
169
+ and [In a session](https://alegauss.github.io/roadkeep/docs/session/) explains the wiring.
170
+
171
+ ### From a checkout beside it
172
+
173
+ A project adopting an unreleased version runs a sibling checkout, and `install` writes the
174
+ hook, the MCP server and the skill into that project itself:
175
+
176
+ ```sh
177
+ python ../roadkeep/plugin/scripts/roadkeep.py -C . install
178
+ python ../roadkeep/plugin/scripts/roadkeep.py -C . install --check # in CI: still in step?
179
+ ```
180
+
181
+ ## Why it exists
182
+
183
+ It started as three readings from a real production repository, where all three files
184
+ declared a format and none enforced it:
185
+
186
+ | Artefact | Declared rule | Actual reading |
187
+ |---|---|---|
188
+ | `docs/ROADMAP.md` | one sentence per task | 92 lines, **142 words** average, worst **1406 characters** |
189
+ | `agents.md` | index only, loaded every turn | grew to **186 KB (~46k tokens)** |
190
+ | `docs/IMPROVEMENTS.md` | rationale for *unshipped* work | a sibling project's reached **539 KB** |
191
+
192
+ Six of the eight worst lines were written in the session that then diagnosed the problem. An
193
+ author, human or model, who has the whole design in mind writes it where the reader is, and an
194
+ instruction to be terse does not survive that. A linter reports after the prose exists, when
195
+ the author is asked to delete work just done. A field with `maxLength: 200` refuses before the
196
+ sentence is composed.
197
+
198
+ Six laws bind the design, and a change that breaks one is wrong even if requested
199
+ ([§0.3](https://github.com/alegauss/roadkeep/blob/main/docs/IMPROVEMENTS.md)):
200
+
201
+ | # | Law |
202
+ |---|---|
203
+ | L1 | The format is a schema, **enforced where the text is created**; `lint` is the backstop. |
204
+ | L2 | **The store is the repository**: Markdown, greppable, diffable. No database, no service. |
205
+ | L3 | **Round-trip or don't write**: parse → render → byte-identical. |
206
+ | L4 | **The tool never writes prose**: it validates and renders. |
207
+ | L5 | **Query instead of read**: every question is a command. |
208
+ | L6 | **Configuration, not convention**: prefix, paths, markers and limits are per project. |
209
+
210
+ The non-goals: no web UI and no server, no issue-tracker sync, no model and no prompts inside
211
+ the tool, and no dates, quarters or estimates.
212
+
213
+ ## Status
214
+
215
+ The table below is **not written by hand**: `roadkeep export --readme` derives it from
216
+ `docs/`, so it cannot restate a backlog it no longer matches.
217
+
218
+ <!-- roadkeep:begin -->
219
+ <!-- generated by `roadkeep export --readme`; edit the governed files instead -->
220
+
221
+ | Block | Open | Shipped | Retired |
222
+ | --- | --- | --- | --- |
223
+ | A — The model (a task is data before it is a line) | 0 | 46 | 2 |
224
+ | B — Authoring (insert, never hand-edit) | 0 | 239 | 2 |
225
+ | C — Query (consult without reading the file) | 0 | 205 | 7 |
226
+ | D — The gate | 0 | 319 | 7 |
227
+ | E — Adoption | 0 | 127 | 1 |
228
+ | F — The Claude Code plugin (the guardrail at the agent boundary) | 0 | 169 | 4 |
229
+ | G — The editor surface (the backlog where the file is open) | 0 | 15 | 0 |
230
+ | H — The tool's own shape (what one verb costs to change) | 0 | 45 | 1 |
231
+ | I — The documentation area (what an adopter reads before there is a session to ask) | 0 | 22 | 0 |
232
+ | J — Validation (whether a person ever tried it) | 0 | 5 | 0 |
233
+ | K — The desktop app (one installer for the reader and the plugin) | 0 | 9 | 0 |
234
+ | L — Product sites on the package | 1 | 2 | 0 |
235
+ | M — Codex integration (one engine, host-specific adapters) | 9 | 0 | 0 |
236
+ | **Total** | 10 | 1203 | 24 |
237
+
238
+ **Next ready:**
239
+
240
+ - 📋 **RK1730** (deps: —) **The guard ignores Codex apply_patch calls that edit governed files** — Recognize Codex patch targets before execution so roadmap ownership also applies to the native editing tool. → §RK1730
241
+ <!-- roadkeep:end -->
242
+
243
+ Open work is in
244
+ [docs/ROADMAP.md](https://github.com/alegauss/roadkeep/blob/main/docs/ROADMAP.md). Every
245
+ repository of its author is governed by it, and these have a public roadmap to read:
246
+ [Turing](https://github.com/openviglet/turing/blob/2026.3/docs/ROADMAP.md),
247
+ [Shio](https://github.com/openviglet/shio/blob/2026.3/docs/ROADMAP.md),
248
+ [Dumont](https://github.com/openviglet/dumont/blob/2026.3/docs/ROADMAP.md),
249
+ [polyweave](https://github.com/alegauss/polyweave/blob/main/docs/ROADMAP.md),
250
+ [winwright](https://github.com/alegauss/winwright/blob/main/docs/ROADMAP.md) and
251
+ [commitclerk](https://github.com/alegauss/commitclerk/blob/main/docs/ROADMAP.md). No adopter
252
+ outside the author is known yet. This repository is its
253
+ own conformance fixture: `roadkeep lint` must pass on `docs/` here, and the suite asserts it.
254
+
255
+ ## More tools by alegauss
256
+
257
+ For Claude Code:
258
+
259
+ - **[Claude Code Tray](https://alegauss.github.io/claude-tray/)**: your rate-limit usage as a Windows tray icon that turns red before you run out.
260
+ - **[commitclerk](https://alegauss.github.io/commitclerk/)**: Conventional Commits messages from your staged diff, in a single-file Python CLI.
261
+ - **[polyweave](https://alegauss.github.io/polyweave/)**: a Claude Code plugin that makes a game's 3D assets, sounds and names by declaring what each has to satisfy.
262
+
263
+ For Windows developers:
264
+
265
+ - **[winwright](https://alegauss.github.io/winwright/)**: drives a Windows desktop app from a test and reports what was actually observed.
266
+ - **[FreeHarbor](https://alegauss.github.io/freeharbor/)**: Docker on Windows without Docker Desktop, with no admin prompt and no telemetry.
267
+ - **[Quickshell](https://alegauss.github.io/quickshell/)**: an SSH client for Windows with sessions, keys, SFTP and tunnels, and without the rest of the suite.
268
+
269
+ All of them: [alegauss.github.io](https://alegauss.github.io/)
@@ -47,7 +47,7 @@ __all__ = [
47
47
  #: The one place the version is written (RK19). `pyproject.toml` declares it `dynamic` and
48
48
  #: reads this literal, so a release cannot ship a number the package disagrees with — which
49
49
  #: is also why it stays eager: a build backend parses this file, it does not import it.
50
- __version__ = "0.2.0"
50
+ __version__ = "0.2.576"
51
51
 
52
52
 
53
53
  #: What the names above are, resolved once each. A frozenset and not a `TYPE_CHECKING`