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