waymark-cli 0.1.1__tar.gz → 0.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 (238) hide show
  1. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/.gitignore +1 -2
  2. waymark_cli-0.3.0/CHANGELOG.md +288 -0
  3. waymark_cli-0.3.0/PKG-INFO +495 -0
  4. waymark_cli-0.3.0/README.md +466 -0
  5. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/docs/architecture.md +23 -11
  6. waymark_cli-0.3.0/docs/assets/trail-dark.svg +53 -0
  7. waymark_cli-0.3.0/docs/assets/trail-light.svg +53 -0
  8. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/docs/cli.md +104 -47
  9. waymark_cli-0.3.0/docs/concepts.md +365 -0
  10. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/docs/getting-started.md +53 -33
  11. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/docs/json.md +794 -183
  12. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/docs/multi-repo.md +50 -27
  13. waymark_cli-0.3.0/docs/record.md +427 -0
  14. waymark_cli-0.3.0/docs/skills.md +302 -0
  15. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/docs/smoke-test.md +65 -23
  16. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/pyproject.toml +3 -1
  17. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/__init__.py +1 -1
  18. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/adapters/__init__.py +2 -0
  19. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/adapters/claude_code.py +2 -1
  20. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/assets/agents/wm-implementer.md +11 -6
  21. waymark_cli-0.3.0/src/waymark/assets/agents/wm-reviewer.md +51 -0
  22. waymark_cli-0.3.0/src/waymark/assets/skills/wm-apply/SKILL.md +122 -0
  23. waymark_cli-0.3.0/src/waymark/assets/skills/wm-archive/SKILL.md +66 -0
  24. waymark_cli-0.3.0/src/waymark/assets/skills/wm-explore/SKILL.md +57 -0
  25. waymark_cli-0.3.0/src/waymark/assets/skills/wm-kickoff/SKILL.md +54 -0
  26. waymark_cli-0.3.0/src/waymark/assets/skills/wm-onboard/SKILL.md +49 -0
  27. waymark_cli-0.3.0/src/waymark/assets/skills/wm-pr/SKILL.md +54 -0
  28. waymark_cli-0.3.0/src/waymark/assets/skills/wm-propose/SKILL.md +97 -0
  29. waymark_cli-0.3.0/src/waymark/assets/skills/wm-update/SKILL.md +65 -0
  30. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/cli.py +205 -53
  31. waymark_cli-0.3.0/src/waymark/hooks/commands.py +363 -0
  32. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/hooks/decide.py +158 -52
  33. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/atlas.py +23 -4
  34. waymark_cli-0.3.0/src/waymark/record/branches.py +83 -0
  35. waymark_cli-0.3.0/src/waymark/record/changes.py +377 -0
  36. waymark_cli-0.3.0/src/waymark/record/charter.py +111 -0
  37. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/config.py +9 -0
  38. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/deltas.py +197 -24
  39. waymark_cli-0.3.0/src/waymark/record/design.py +168 -0
  40. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/edits.py +31 -28
  41. waymark_cli-0.3.0/src/waymark/record/evidence.py +89 -0
  42. waymark_cli-0.3.0/src/waymark/record/explorations.py +132 -0
  43. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/files.py +10 -0
  44. waymark_cli-0.3.0/src/waymark/record/fingerprint.py +165 -0
  45. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/git.py +48 -28
  46. waymark_cli-0.3.0/src/waymark/record/layout.py +161 -0
  47. waymark_cli-0.3.0/src/waymark/record/milestones.py +204 -0
  48. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/moves.py +8 -1
  49. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/outline.py +9 -5
  50. waymark_cli-0.3.0/src/waymark/record/pointer.py +101 -0
  51. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/project.py +19 -8
  52. waymark_cli-0.3.0/src/waymark/record/proposal.py +225 -0
  53. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/record.py +41 -26
  54. waymark_cli-0.3.0/src/waymark/record/records.py +498 -0
  55. waymark_cli-0.3.0/src/waymark/record/resources.py +191 -0
  56. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/specs.py +21 -2
  57. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/state.py +193 -75
  58. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/store.py +40 -1
  59. waymark_cli-0.3.0/src/waymark/record/tasks.py +532 -0
  60. waymark_cli-0.3.0/src/waymark/record/templates/charter.md +38 -0
  61. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/templates/config.toml +1 -1
  62. waymark_cli-0.3.0/src/waymark/record/templates/delta.md +47 -0
  63. waymark_cli-0.3.0/src/waymark/record/templates/design.md +33 -0
  64. waymark_cli-0.3.0/src/waymark/record/templates/exploration.md +30 -0
  65. waymark_cli-0.3.0/src/waymark/record/templates/milestone.md +21 -0
  66. waymark_cli-0.3.0/src/waymark/record/templates/proposal.md +26 -0
  67. waymark_cli-0.3.0/src/waymark/record/templates/resource.md +48 -0
  68. waymark_cli-0.3.0/src/waymark/record/templates/tasks.md +23 -0
  69. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/templates.py +2 -2
  70. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/terms.py +8 -0
  71. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/services/atlas.py +19 -11
  72. waymark_cli-0.3.0/src/waymark/services/check.py +291 -0
  73. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/services/common.py +14 -6
  74. waymark_cli-0.3.0/src/waymark/services/context.py +456 -0
  75. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/services/doctor.py +10 -47
  76. waymark_cli-0.3.0/src/waymark/services/fix.py +112 -0
  77. waymark_cli-0.3.0/src/waymark/services/guidance.py +28 -0
  78. waymark_cli-0.3.0/src/waymark/services/instructions.py +486 -0
  79. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/services/integration.py +65 -65
  80. waymark_cli-0.3.0/src/waymark/services/lifecycle.py +659 -0
  81. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/services/pr.py +69 -31
  82. waymark_cli-0.3.0/src/waymark/services/roadmap.py +191 -0
  83. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/services/setup.py +107 -21
  84. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/views/payloads.py +111 -31
  85. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/views/render.py +186 -30
  86. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/views/schemas.py +132 -35
  87. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/adapters/snapshots/wm-implementer.md +11 -6
  88. waymark_cli-0.3.0/tests/adapters/snapshots/wm-reviewer.md +52 -0
  89. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/adapters/test_claude_code.py +31 -11
  90. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/adapters/test_integration.py +157 -23
  91. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/hooks/test_commands.py +105 -4
  92. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/hooks/test_decide.py +391 -64
  93. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/hooks/test_repo_limits.py +17 -13
  94. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_artifacts.py +117 -62
  95. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_atlas.py +48 -13
  96. waymark_cli-0.3.0/tests/record/test_authored_formats.py +340 -0
  97. waymark_cli-0.3.0/tests/record/test_branches.py +156 -0
  98. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_deltas.py +136 -2
  99. waymark_cli-0.3.0/tests/record/test_evidence.py +80 -0
  100. waymark_cli-0.3.0/tests/record/test_fingerprint.py +304 -0
  101. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_git.py +11 -1
  102. waymark_cli-0.3.0/tests/record/test_layout.py +111 -0
  103. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_project.py +19 -10
  104. waymark_cli-0.3.0/tests/record/test_records.py +279 -0
  105. waymark_cli-0.3.0/tests/record/test_resources.py +114 -0
  106. waymark_cli-0.3.0/tests/record/test_state.py +671 -0
  107. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_store.py +49 -9
  108. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_tasks.py +22 -73
  109. waymark_cli-0.3.0/tests/record/test_tasks_records.py +154 -0
  110. waymark_cli-0.3.0/tests/services/test_agent_interface.py +1047 -0
  111. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/services/test_archive.py +195 -60
  112. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/services/test_atlas.py +42 -6
  113. waymark_cli-0.3.0/tests/services/test_check.py +492 -0
  114. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/services/test_ci_and_pr.py +134 -8
  115. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/services/test_doctor.py +17 -11
  116. waymark_cli-0.3.0/tests/services/test_fix.py +91 -0
  117. waymark_cli-0.3.0/tests/services/test_lifecycle.py +489 -0
  118. waymark_cli-0.3.0/tests/services/test_lifecycle_records.py +265 -0
  119. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/services/test_milestones.py +20 -15
  120. waymark_cli-0.3.0/tests/services/test_review_added_items.py +121 -0
  121. waymark_cli-0.3.0/tests/services/test_roadmap.py +127 -0
  122. waymark_cli-0.3.0/tests/services/test_setup.py +877 -0
  123. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/support.py +73 -27
  124. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/test_agent_cli.py +2 -2
  125. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/test_atlas_cli.py +41 -0
  126. waymark_cli-0.3.0/tests/test_cli.py +295 -0
  127. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/test_docs.py +5 -1
  128. waymark_cli-0.3.0/tests/test_install_skills.py +45 -0
  129. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/test_lifecycle_cli.py +80 -43
  130. waymark_cli-0.3.0/tests/test_skills.py +112 -0
  131. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/test_views_cli.py +55 -1
  132. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/views/test_branches.py +5 -2
  133. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/views/test_views.py +208 -31
  134. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tools/docs.py +130 -69
  135. waymark_cli-0.3.0/tools/install_skills.py +51 -0
  136. waymark_cli-0.3.0/tools/skills/waymark-check-docs/SKILL.md +30 -0
  137. waymark_cli-0.3.0/tools/skills/waymark-draft-docs/SKILL.md +36 -0
  138. waymark_cli-0.3.0/tools/skills/waymark-release/SKILL.md +85 -0
  139. waymark_cli-0.3.0/tools/skills/waymark-write-docs/SKILL.md +41 -0
  140. waymark_cli-0.1.1/CHANGELOG.md +0 -64
  141. waymark_cli-0.1.1/PKG-INFO +0 -313
  142. waymark_cli-0.1.1/README.md +0 -284
  143. waymark_cli-0.1.1/docs/concepts.md +0 -152
  144. waymark_cli-0.1.1/src/waymark/assets/agents/wm-reviewer.md +0 -43
  145. waymark_cli-0.1.1/src/waymark/assets/skills/wm-apply/SKILL.md +0 -58
  146. waymark_cli-0.1.1/src/waymark/assets/skills/wm-archive/SKILL.md +0 -32
  147. waymark_cli-0.1.1/src/waymark/assets/skills/wm-explore/SKILL.md +0 -34
  148. waymark_cli-0.1.1/src/waymark/assets/skills/wm-kickoff/SKILL.md +0 -34
  149. waymark_cli-0.1.1/src/waymark/assets/skills/wm-onboard/SKILL.md +0 -27
  150. waymark_cli-0.1.1/src/waymark/assets/skills/wm-pr/SKILL.md +0 -24
  151. waymark_cli-0.1.1/src/waymark/assets/skills/wm-propose/SKILL.md +0 -32
  152. waymark_cli-0.1.1/src/waymark/assets/skills/wm-update/SKILL.md +0 -31
  153. waymark_cli-0.1.1/src/waymark/hooks/commands.py +0 -190
  154. waymark_cli-0.1.1/src/waymark/record/changes.py +0 -202
  155. waymark_cli-0.1.1/src/waymark/record/charter.py +0 -75
  156. waymark_cli-0.1.1/src/waymark/record/design.py +0 -80
  157. waymark_cli-0.1.1/src/waymark/record/evidence.py +0 -58
  158. waymark_cli-0.1.1/src/waymark/record/explorations.py +0 -66
  159. waymark_cli-0.1.1/src/waymark/record/fingerprint.py +0 -73
  160. waymark_cli-0.1.1/src/waymark/record/githooks.py +0 -108
  161. waymark_cli-0.1.1/src/waymark/record/milestones.py +0 -84
  162. waymark_cli-0.1.1/src/waymark/record/pointer.py +0 -56
  163. waymark_cli-0.1.1/src/waymark/record/proposal.py +0 -171
  164. waymark_cli-0.1.1/src/waymark/record/tasks.py +0 -415
  165. waymark_cli-0.1.1/src/waymark/record/templates/charter.md +0 -45
  166. waymark_cli-0.1.1/src/waymark/record/templates/delta.md +0 -29
  167. waymark_cli-0.1.1/src/waymark/record/templates/design.md +0 -20
  168. waymark_cli-0.1.1/src/waymark/record/templates/exploration.md +0 -22
  169. waymark_cli-0.1.1/src/waymark/record/templates/goal.md +0 -13
  170. waymark_cli-0.1.1/src/waymark/record/templates/hook-commit-msg +0 -8
  171. waymark_cli-0.1.1/src/waymark/record/templates/hook-pre-commit +0 -8
  172. waymark_cli-0.1.1/src/waymark/record/templates/proposal.md +0 -18
  173. waymark_cli-0.1.1/src/waymark/record/templates/roadmap.md +0 -4
  174. waymark_cli-0.1.1/src/waymark/record/templates/tasks.md +0 -10
  175. waymark_cli-0.1.1/src/waymark/services/check.py +0 -129
  176. waymark_cli-0.1.1/src/waymark/services/context.py +0 -296
  177. waymark_cli-0.1.1/src/waymark/services/githooks.py +0 -124
  178. waymark_cli-0.1.1/src/waymark/services/instructions.py +0 -304
  179. waymark_cli-0.1.1/src/waymark/services/lifecycle.py +0 -454
  180. waymark_cli-0.1.1/src/waymark/services/migrations.py +0 -90
  181. waymark_cli-0.1.1/tests/adapters/snapshots/wm-reviewer.md +0 -44
  182. waymark_cli-0.1.1/tests/record/test_fingerprint.py +0 -154
  183. waymark_cli-0.1.1/tests/record/test_state.py +0 -444
  184. waymark_cli-0.1.1/tests/services/test_agent_interface.py +0 -439
  185. waymark_cli-0.1.1/tests/services/test_check.py +0 -124
  186. waymark_cli-0.1.1/tests/services/test_githooks.py +0 -299
  187. waymark_cli-0.1.1/tests/services/test_lifecycle.py +0 -349
  188. waymark_cli-0.1.1/tests/services/test_migrations.py +0 -103
  189. waymark_cli-0.1.1/tests/services/test_setup.py +0 -497
  190. waymark_cli-0.1.1/tests/test_cli.py +0 -139
  191. waymark_cli-0.1.1/tests/test_git_cli.py +0 -90
  192. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/LICENSE +0 -0
  193. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/docs/assets/banner-dark.svg +0 -0
  194. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/docs/assets/banner-light.svg +0 -0
  195. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/__main__.py +0 -0
  196. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/assets/__init__.py +0 -0
  197. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/hooks/__init__.py +0 -0
  198. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/hooks/events.py +0 -0
  199. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/py.typed +0 -0
  200. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/__init__.py +0 -0
  201. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/agents.py +0 -0
  202. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/commits.py +0 -0
  203. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/ignore.py +0 -0
  204. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/links.py +0 -0
  205. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/names.py +0 -0
  206. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/problems.py +0 -0
  207. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/registry.py +0 -0
  208. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/templates/ci-workflow.yml +0 -0
  209. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/templates/config-atlas.toml +0 -0
  210. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/record/text.py +0 -0
  211. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/services/__init__.py +0 -0
  212. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/services/ci.py +0 -0
  213. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/services/references.py +0 -0
  214. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/views/__init__.py +0 -0
  215. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/src/waymark/views/style.py +0 -0
  216. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/__init__.py +0 -0
  217. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/adapters/__init__.py +0 -0
  218. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/adapters/snapshots/settings.json +0 -0
  219. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/conftest.py +0 -0
  220. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/hooks/__init__.py +0 -0
  221. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/__init__.py +0 -0
  222. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_agents.py +0 -0
  223. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_commits.py +0 -0
  224. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_config.py +0 -0
  225. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_ignore.py +0 -0
  226. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_links.py +0 -0
  227. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_names.py +0 -0
  228. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_platforms.py +0 -0
  229. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_registry.py +0 -0
  230. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_specs.py +0 -0
  231. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/record/test_text.py +0 -0
  232. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/services/__init__.py +0 -0
  233. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/test_constraints.py +0 -0
  234. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/views/__init__.py +0 -0
  235. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/views/test_style.py +0 -0
  236. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tests/views/validator.py +0 -0
  237. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tools/__init__.py +0 -0
  238. {waymark_cli-0.1.1 → waymark_cli-0.3.0}/tools/release.py +0 -0
@@ -20,7 +20,7 @@ dist/
20
20
  /.opencode/
21
21
  /.windsurf/
22
22
  /.gemini/
23
- /.agents/skills/wm-*/
23
+ /.agents/
24
24
  /.waymark/
25
25
 
26
26
  # Editors and operating systems
@@ -34,5 +34,4 @@ Thumbs.db
34
34
  /.claude/skills/wm-*/
35
35
  /.claude/agents/wm-*.md
36
36
  /.claude/settings.json
37
- /.waymark/hooks/
38
37
  # end of Waymark
@@ -0,0 +1,288 @@
1
+ # Changelog
2
+
3
+ All notable changes to Waymark, one entry per release.
4
+
5
+ ## [0.3.0] - 2026-11-18
6
+
7
+ Context beyond the code: resources, a spec's Background and one list of project
8
+ rules give every fact an agent needs one place. Milestones link their changes and
9
+ keep a log, changes have branches and bases, and the record format resets to 1.
10
+
11
+ - **Behavior change: record format 1, with no migration.** `wm` reads and writes
12
+ only format 1, and this release's record is format 1. A record in any other
13
+ format, including the format 3 that 0.2.0 writes, is refused with one reason:
14
+ install the `wm` version that wrote it. `wm update` migrates nothing. It
15
+ regenerates the files `wm` owns and adds missing `.gitkeep` files. `wm check`
16
+ no longer reports older layouts on their own; such a line fails the check
17
+ that applies to it. `.waymark/atlas.toml` is no longer read as an atlas
18
+ pointer, and `wm doctor` no longer looks for `.waymark/hooks/`.
19
+ - **Behavior change: `wm-fix` is gone; `/wm-propose` does work of any size.**
20
+ It reads the specs and the code and picks the path itself: tiny, built after
21
+ your yes; short, a change with no design; or full, a change with a design,
22
+ with any open question blocking acceptance. `wm init` and `wm update` remove
23
+ the `wm-*` skill folders `wm` no longer ships, and print `removed:` for each.
24
+ - **Record folders stay in git.** `wm init` writes an empty `.gitkeep` into
25
+ `specs/`, `changes/`, `changes/archive/`, `explorations/`, `milestones/` and
26
+ `milestones/archive/`, and `wm update` adds any that are missing.
27
+ - **Behavior change: an item added after a review is reviewed on its own.**
28
+ `(review)` and `(self-review)` records now name the items they cover, as
29
+ `covers <item>...`; a record without it covers every item. Once an item added
30
+ after a passing review is ticked, the next step is a review of the items no
31
+ passing review covers, and the reviewer's pack holds only those. `wm archive`
32
+ refuses a change with such an item unless you override it with a reason.
33
+ `wm show` and the JSON payloads give what each review covers.
34
+ - **A change names its milestone.** A proposal may have a `- Milestone: <name>`
35
+ line. For an active change, `wm check` reports an error when that line and the
36
+ milestones' roadmaps disagree, including a roadmap that links a change whose
37
+ proposal has no such line. `wm new change <name> --milestone <milestone>`
38
+ writes the line and links the change from the roadmap. The implement and
39
+ review context packs carry the milestone's Goal and Non-goals, in a new
40
+ `milestone` field.
41
+ - **A milestone keeps a log, and its roadmap changes only through `wm`.**
42
+ `wm roadmap add`, `wm roadmap drop --reason` and `wm roadmap move --after|--first`
43
+ change the roadmap, and each writes a record in a `## Log` at the end of
44
+ `milestone.md`, as do `wm new change --milestone` and `wm archive`. An agent's
45
+ hand edit to a roadmap line or the Log is refused.
46
+ - **Behavior change: `wm close` needs every roadmap line archived.** A planned
47
+ line that was never proposed now keeps a milestone open, until it is proposed
48
+ or dropped with `wm roadmap drop`.
49
+ - **Each change has a branch and a base.** A proposal may say which change it
50
+ comes after, in an `- After: <change>` line written by
51
+ `wm new change <name> --after <change>`. `wm instructions`, `wm pr` and
52
+ `wm status` show each change's branch and base, `wm pr`'s JSON has a `base` for
53
+ the pull request to target, and `wm check` warns when the change it comes after
54
+ has merged. The default branch comes from the `origin` remote's HEAD, or is
55
+ `main`. The skills open a plan pull request for a new milestone and create
56
+ each change's branch from its base.
57
+ - **Resources.** A new kind of note, `waymark/resources/<name>.md`, holds the
58
+ facts about one thing outside the repo: its kind, the specs it serves, its
59
+ status, the day it was verified, and six sections. `wm new resource <name>
60
+ <kind>`, `wm ls resources` and `wm show <name> --kind resource` work with them,
61
+ and `wm check` holds them to their layout. The explore context pack gains a
62
+ `resources` index, and the implement and review packs a `resources` field with
63
+ the resources serving the change's specs. An implementer may edit resources,
64
+ and `wm init` and `wm update` keep `resources/` in git.
65
+ - **A spec may have a Background.** A `## Background` section, between Purpose
66
+ and Requirements, holds the facts about the spec's area that aren't
67
+ requirements. A delta's `## Background` replaces the spec's whole at archive or
68
+ sync. `wm check` reports an empty one. The implement and review packs gain a
69
+ `backgrounds` field with the Background of each spec the change has a delta
70
+ for, the delta's when it has one. The delta template and the specs step's
71
+ guidance say where a fact goes.
72
+ - **Behavior change: the charter's Rules are one numbered list.** `## Rules`
73
+ holds `1. <rule>` lines, like Goals and Constraints, and every agent gets the
74
+ whole list at every step: `wm instructions` and every `wm context` pack show
75
+ it under "Project rules", and `rules` in their JSON holds all of it. A step
76
+ heading or a bullet under Rules is a `numbered-list-format` error, and the
77
+ `unknown-step` problem is gone. A charter with step headings must be rewritten
78
+ by hand. `wm init` writes Rules without step headings.
79
+
80
+ Smoke test: passed on 2026-11-18 with Claude Code 2.1.327 on Windows.
81
+
82
+ ## [0.2.0] - 2026-11-16
83
+
84
+ The planner builds by default and each change is reviewed once. Small work takes
85
+ a tiny path. The record moves to format 3, with structured notes, step
86
+ checklists and one layout for every skill.
87
+
88
+ - **Behavior change: the planner builds the items.** At the apply step,
89
+ `wm instructions` tells the session to build the item from its context pack,
90
+ run the checks the item touches, and record the result with `wm tick`,
91
+ `wm block` or `wm gap`. An item with a `- Build: delegate` line still goes to a
92
+ fresh implementer. In an atlas, the planner may edit any code repo; an
93
+ implementer edits only its item's repo.
94
+ - **Behavior change: one review per change.** A change's review level comes from
95
+ a `- Review:` line in its proposal, or from `default_review`; items no longer
96
+ carry one. Once every item is ticked, the whole change is reviewed once, with
97
+ `wm review <change> --self "<summary>"` or by the `wm-reviewer` agent started
98
+ with the change's name. A `changes` verdict names the items to rebuild, and
99
+ `wm reopen` reopens each one. A pass with a critical finding is refused.
100
+ - **The tiny path.** Work that adds, changes or removes no requirement needs no
101
+ change. The new `wm-fix` skill builds it after your yes, commits it, and offers
102
+ a pull request. `wm-propose` asks first which path fits.
103
+ - **Archive before the pull request.** A change is archived on its own branch, so
104
+ the code, the merged specs and the archived change go in one pull request.
105
+ `wm pr` describes an archived change, with its outcome.
106
+ - **Adding an item keeps acceptance.** The `(accepted)` record names the items it
107
+ covers. Changing or removing an accepted item, the proposal, a delta or the
108
+ design still withdraws it.
109
+ - **Behavior change: no `.waymark/` folder and no git hooks.** `wm git-hooks` and
110
+ `wm run-hook` are removed. In Claude Code, the command hook refuses a
111
+ `git commit` whose message isn't a conventional commit with an allowed scope;
112
+ commits made outside an agent aren't checked. A code repo points at its atlas
113
+ through a pointer-only `waymark/config.toml`, written by `wm atlas point`.
114
+ `.waymark/atlas.toml` is still read, with a warning.
115
+ - **Upgrading from 0.1.x.** This version can't migrate a record made by 0.1.x,
116
+ which is format 1: `wm update` refuses it and changes nothing (see record
117
+ format 3 below). In each clone that 0.1.0 or 0.1.1 set up, run
118
+ `git config --unset core.hooksPath` and delete the hooks folder it named, as
119
+ [Upgrading](docs/getting-started.md#upgrading) describes.
120
+ - **A new README and two new references.** The README opens with a diagram of
121
+ a change's trail and works as an index: the three paths and the steps, a
122
+ quick start with a setup matrix, the skills, and a real walk-through of adding
123
+ dark mode with the files it writes. [The record](docs/record.md) covers every
124
+ file and [Skills and agents](docs/skills.md) every skill and agent.
125
+ - **One severity rubric for every review.** `wm context --for review` and
126
+ `wm instructions` at the review step give it, as "Severity rubric" and, in the
127
+ JSON, `severity_rubric`: critical when a criterion or scenario doesn't hold,
128
+ warning when everything holds but something is fragile, suggestion for
129
+ clarity, and the higher of two when torn. The reviewer and the self-review in
130
+ `wm-apply` grade by it.
131
+ - **Stopping rules for the implementer.** `wm context --for implement` gives
132
+ them, as "When to stop" and, in the JSON, `stopping_rules`: `spec-gap`,
133
+ `blocked`, or `partial` after three attempts at the same failing check.
134
+ - **The skills share one layout:** Role, Inputs, Steps, any sections of their
135
+ own, Quality bar, Show the human, When to stop and Rules. Each says what good
136
+ output looks like, the fixed shape of what it shows you, and when it stops.
137
+ - `wm-propose` asks what the record doesn't settle before drafting, and checks
138
+ the proposal, deltas, design and tasks against each other before acceptance.
139
+ - `wm-kickoff` interviews you one charter section at a time.
140
+ - `wm-explore` states what the record says, the questions, two or more
141
+ approaches with their costs, and a recommendation.
142
+ - **`wm instructions` gives the specs step rules for writing requirements,** and
143
+ the tasks step rules for sizing items, in its guidance.
144
+ - **`wm instructions` gives each drafting step a checklist** (propose, specs,
145
+ design, tasks): what must hold before moving on, each check marked when
146
+ `wm check` enforces it. The JSON gains `checklist`, a list of `text` and
147
+ `enforced`.
148
+ - **`wm instructions` gives every step the shared rules** that every skill
149
+ follows, as "Shared rules" and, in the JSON, `shared_rules`. The skills no
150
+ longer repeat them.
151
+ - **Behavior change: two new checks for active changes.** A task item needs a
152
+ `- Criteria:` and a `- Verify:` line (`item-incomplete`), and a design
153
+ decision needs at least two options under `- Options:` (`decision-options`),
154
+ as bullets or on the line joined by "or" or ";".
155
+ - **Behavior change: a milestone is one `milestone.md`,** with `## Goal`,
156
+ `## Done when`, `## Non-goals` and `## Roadmap` in that order, instead of
157
+ `goal.md` and `roadmap.md`. `wm new milestone` writes it, only the list lines
158
+ under `## Roadmap` count as the milestone's changes, and archiving a change
159
+ ticks its line there. `wm check` reports a `goal.md` or `roadmap.md` in a
160
+ milestone folder, active or archived; merge the two files into `milestone.md`
161
+ by hand, goal first, then the roadmap's lines under `## Roadmap`.
162
+ - **Behavior change: `wm archive --built` and `--differs` replace `--outcome`.**
163
+ The archived proposal's Outcome holds a `- Built: <text>` line and a
164
+ `- Differs: <text>` line, `none` when `--differs` is left out. A hand-written
165
+ Outcome needs both lines. `wm pr` shows them.
166
+ - **Behavior change: a proposal's Impact has three lines,** `- Specs:`,
167
+ `- User-visible:` and `- Code:`. `Specs:` names each spec the change has a
168
+ delta for, in backticks, or says `none`, and `wm check` reports a spec named
169
+ without a delta and a delta whose spec isn't named. `- Specs: none` replaces
170
+ "No spec changes" as the way to say a change has no deltas.
171
+ - **Behavior change: a design's decisions are settled before acceptance.** Each
172
+ decision has a `- Status: proposed|decided` line and a
173
+ `- Decided by: human|planner` line, and the design an `## Open questions`
174
+ section, holding a list or `None.`. While a decision is proposed or a question
175
+ is listed, the next step stays at the design, and `wm accept` refuses with a
176
+ reason that names each one.
177
+ - **The charter's goals and constraints are numbered lists,** `1. <text>`,
178
+ counted from 1. `wm check` reports a line in another form.
179
+ - **A task item's `- Verify:` may be a nested list,** one step per bullet, like
180
+ `- Criteria:`.
181
+ - **An exploration's status comes from its `- Status:` line alone.** A
182
+ Conclusion starting with `Parked:` no longer parks it, and a missing status
183
+ line is reported as `missing-status` instead of an old layout.
184
+ - **The templates carry a good and a bad example** in a comment. Comments are
185
+ left out of the acceptance fingerprint, so editing or deleting them keeps an
186
+ acceptance.
187
+ - These layouts are required of active changes, the charter and explorations.
188
+ Archived changes are read as they were written, and the record format stays
189
+ 3.
190
+ - **Behavior change: record format 3.** `wm` reads and writes only format 3. It
191
+ doesn't migrate a record in format 1 or 2: `wm update` refuses one, names its
192
+ format, and changes nothing. Waymark's own record was the only one in an older
193
+ format, and was moved by a migration that has since been removed.
194
+ - **The layouts humans write:**
195
+ - a proposal's facts are bullets: `- Owner: <name>`, `- Review: <level>`,
196
+ `- Path: short`;
197
+ - the charter's glossary is a list of `- **<term>**: <meaning>`, and step
198
+ headings under Rules are capitalized (`### Apply`) and may be left out;
199
+ - a task item's criteria may be a nested list under `- Criteria:`, and the
200
+ delegation tag is a `- Build: delegate` line under the item;
201
+ - a delta's sections are `## ADDED Requirements`, `## MODIFIED Requirements`
202
+ and `## REMOVED Requirements`, and `## RENAMED Requirements` with `- From:`
203
+ and `- To:` renames a requirement and keeps its text;
204
+ - an exploration says where it stands in a `- Status: open|parked|led-to
205
+ <link>` line under its title.
206
+
207
+ `wm check` reports each older layout and says to run `wm update`.
208
+ - **Behavior change: what `wm` writes is a dated record,**
209
+ `(kind) YYYY-MM-DD [<args>] [by <who>]: <text>`. `(blocked)`, `(gap)`,
210
+ `(note)`, `(reopened)` and `(resolved)` sit under items; `(accepted)`,
211
+ `(synced)`, `(self-review)`, `(review)`, `(resolved)` and `(override)` sit in a
212
+ `## Log` section at the end of the task list, which replaces `## Review`. The
213
+ proposal no longer holds `Accepted:` or `Synced:` lines.
214
+ - **Records are never removed.** `wm resolve` adds a `(resolved)` record and
215
+ keeps the blocker or spec gap it resolves. Accepting again adds a new
216
+ `(accepted)` record; the latest counts.
217
+ - **Every writing command takes `--by`**; records name your git name by default,
218
+ and `wm-implementer` or `wm-reviewer` for an agent's result.
219
+ - **`wm note <change> <item> "<text>"`** writes a note. An implementer no longer
220
+ edits the task list; `wm note` is the one writing command it may run.
221
+ - **`wm check --fix`** puts the active record in its standard layout and never
222
+ changes wording. The acceptance fingerprint is taken over that layout, so a
223
+ fix never withdraws an acceptance.
224
+ - **Findings** put their place in backticks: ``warning `src/a.py:12`: <text>``.
225
+ - **`wm show --json`**: the `show.change` schema is version 3, with a `log` of
226
+ records, a `by` on every record, and no item `notes` or review `records`.
227
+
228
+ Smoke test: passed on 2026-11-16 with Claude Code 2.1.326 on Windows.
229
+
230
+ ## [0.1.1] - 2026-11-15
231
+
232
+ Each machine sets itself up, and background agents' results are recorded.
233
+ Waymark is now developed with its own record.
234
+
235
+ - **Behavior change: the agent tool files and git hooks belong to each
236
+ machine.** `wm init`, `wm update` and `wm git-hooks` keep them out of git with
237
+ a marked block in `.gitignore`, and the git hooks are no longer staged. Commit
238
+ `waymark/` and `.gitignore`; after cloning, run `wm init`.
239
+ - **`wm init` in a clone that has a record** sets up this machine instead of
240
+ refusing, and leaves the record alone. It needs the pinned `wm`, and says to
241
+ run `wm update` when the record needs migrating.
242
+ - **`wm doctor`** warns when files `wm` writes for a machine are tracked in git,
243
+ with the `git rm -r --cached` command that stops sharing them. Its message for
244
+ missing agent files says to run `wm init`.
245
+ - **`wm update`** asks you to commit only when the record, `.gitignore` or the
246
+ CI workflow changed.
247
+ - **Fix: results from agents run in the background are recorded.** In Claude
248
+ Code, an implementer's or reviewer's report handed back through
249
+ `SubagentHandback` is read by the hooks, so ticks and verdicts are written
250
+ without the planner. The agents may now use that tool.
251
+ - **Upgrading from 0.1.0:** change the pin to 0.1.1, install it, and run
252
+ `wm update`. It adds the `.gitignore` block. Then run `wm doctor` and the
253
+ `git rm -r --cached` command it gives, and commit. The record format is
254
+ unchanged (format 1); nothing is migrated.
255
+
256
+ Smoke test: passed on 2026-11-15 with Claude Code 2.1.325 on Windows.
257
+
258
+ ## [0.1.0] - 2026-11-13
259
+
260
+ The first release: the foundation.
261
+
262
+ - **The record:** charter, settings, living specs, changes (proposal, deltas,
263
+ design, tasks), milestones, explorations and a dated archive, all plain
264
+ markdown in `waymark/`. Record format 1.
265
+ - **The workflow:** propose, specs, design, tasks, accept, apply, review and
266
+ archive, with a short path for small changes. Acceptance is fingerprinted, and
267
+ editing an accepted change withdraws it.
268
+ - **Review:** levels `self`, `independent` and `none`; evidence written only by
269
+ `wm`; the accept, delegation and archive gates; `wm archive --override` for a
270
+ missing review, with the reason recorded.
271
+ - **Commands:** setup (`init`, `update`, `doctor`), authoring (`new`), the agent
272
+ interface (`instructions`, `context`), the lifecycle commands, and the views
273
+ (`status`, `inbox`, `show`, `ls`, `check`), with `--json` and versioned
274
+ schemas. Styled output with an ASCII fallback.
275
+ - **Claude Code:** eight skills, the implementer and reviewer agents, and hooks
276
+ that enforce the agent-side rules and record results from agents' final lines.
277
+ - **Teams:** change owners, branch-safe merges, overlaps reported by `wm check`
278
+ and mismatches blocked at archive.
279
+ - **Multi-repo:** atlases, a per-machine registry, pointer files in code repos,
280
+ read-only references to other atlases, edit limits across repositories, and
281
+ `wm atlas doctor`.
282
+ - **Git and CI:** committed git hooks (commit-message check, and `wm check` on
283
+ commits that touch the record), a GitHub Actions workflow (`wm ci`), and pull
284
+ request text from a change (`wm pr`).
285
+ - Runs on Windows, macOS and Linux, on Python 3.11 and newer, with no
286
+ dependencies beyond the standard library.
287
+
288
+ Smoke test: passed on 2026-11-13 with Claude Code 2.1.325 on Windows.