savepoint 1.0.2 → 1.0.4

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 (242) hide show
  1. package/.claude/settings.local.json +12 -1
  2. package/.github/workflows/ci.yml +20 -0
  3. package/.golangci.yml +11 -0
  4. package/.savepoint/Design.md +40 -38
  5. package/.savepoint/{audit/v1.1/E02-cross-platform-compatibility/proposals.md → releases/v1.1/epics/E02-cross-platform-compatibility/E02-Audit.md} +48 -38
  6. package/.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/E03-Audit.md +195 -0
  7. package/.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/E03-Detail.md +14 -1
  8. package/.savepoint/releases/v1.1/epics/E03-ui-visual-refinement/tasks/T006-forced-256-color-profile.md +3 -3
  9. package/.savepoint/{audit/v1.1/E04-epic-navigation/proposals.md → releases/v1.1/epics/E04-epic-navigation/E04-Audit.md} +65 -54
  10. package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/E05-Audit.md +237 -0
  11. package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/E05-Detail.md +25 -16
  12. package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/tasks/T001-update-agents-md.md +17 -6
  13. package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/tasks/T002-update-router-md.md +15 -5
  14. package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/tasks/T003-update-design-md.md +19 -5
  15. package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/tasks/T004-implement-m-hotkey.md +11 -1
  16. package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/tasks/T005-update-help-overlay.md +9 -6
  17. package/.savepoint/releases/v1.1/epics/E05-tasking-permissions/tasks/T006-tests-and-quality-gates.md +29 -13
  18. package/.savepoint/releases/v1.1/epics/E06-audit-command/E06-Audit.md +56 -0
  19. package/.savepoint/releases/v1.1/epics/E06-audit-command/E06-Detail.md +63 -0
  20. package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T005-proposals.md +44 -0
  21. package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T007-apply-close.md +35 -0
  22. package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T009-integration.md +40 -0
  23. package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T010-audit-file-migration.md +45 -0
  24. package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T011-model-tab-state.md +26 -0
  25. package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T012-epic-audit-render.md +33 -0
  26. package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T013-handle-tab-keys.md +34 -0
  27. package/.savepoint/releases/v1.1/epics/E06-audit-command/tasks/T014-tab-indicator.md +33 -0
  28. package/.savepoint/releases/v1.1/epics/E07-init-command/E07-Audit.md +336 -0
  29. package/.savepoint/releases/v1.1/epics/E07-init-command/E07-Detail.md +61 -0
  30. package/.savepoint/releases/v1.1/epics/E07-init-command/tasks/T001-cli-entrypoint.md +37 -0
  31. package/.savepoint/releases/v1.1/epics/E07-init-command/tasks/T002-target-validation.md +28 -0
  32. package/.savepoint/releases/v1.1/epics/E07-init-command/tasks/T003-scaffold-writer.md +46 -0
  33. package/.savepoint/releases/v1.1/epics/E07-init-command/tasks/T004-atomic-writes.md +27 -0
  34. package/.savepoint/releases/v1.1/epics/E07-init-command/tasks/T005-magic-prompt.md +25 -0
  35. package/.savepoint/releases/v1.1/epics/E07-init-command/tasks/T006-clipboard.md +26 -0
  36. package/.savepoint/releases/v1.1/epics/E07-init-command/tasks/T007-integration-test.md +26 -0
  37. package/.savepoint/releases/v1.1/epics/E08-board-command/E08-Audit.md +333 -0
  38. package/.savepoint/releases/v1.1/epics/E08-board-command/E08-Detail.md +68 -0
  39. package/.savepoint/releases/v1.1/epics/E08-board-command/tasks/T001-cli-entrypoint.md +26 -0
  40. package/.savepoint/releases/v1.1/epics/E08-board-command/tasks/T002-non-tty-fallback.md +27 -0
  41. package/.savepoint/releases/v1.1/epics/E08-board-command/tasks/T003-tui-app-shell.md +28 -0
  42. package/.savepoint/releases/v1.1/epics/E08-board-command/tasks/T004-board-model.md +29 -0
  43. package/.savepoint/releases/v1.1/epics/E08-board-command/tasks/T005-detail-pane.md +27 -0
  44. package/.savepoint/releases/v1.1/epics/E08-board-command/tasks/T006-status-transitions.md +29 -0
  45. package/.savepoint/releases/v1.1/epics/E08-board-command/tasks/T007-theme-fallbacks.md +29 -0
  46. package/.savepoint/releases/v1.1/epics/E08-board-command/tasks/T008-integration-test.md +27 -0
  47. package/.savepoint/releases/v1.1/epics/E09-doctor-command/E09-Audit.md +207 -0
  48. package/.savepoint/releases/v1.1/epics/E09-doctor-command/E09-Detail.md +65 -0
  49. package/.savepoint/releases/v1.1/epics/E09-doctor-command/tasks/T001-cli-entrypoint.md +24 -0
  50. package/.savepoint/releases/v1.1/epics/E09-doctor-command/tasks/T002-config-router-validation.md +28 -0
  51. package/.savepoint/releases/v1.1/epics/E09-doctor-command/tasks/T003-structure-checks.md +29 -0
  52. package/.savepoint/releases/v1.1/epics/E09-doctor-command/tasks/T004-dependency-checks.md +27 -0
  53. package/.savepoint/releases/v1.1/epics/E09-doctor-command/tasks/T005-audit-orphan-checks.md +28 -0
  54. package/.savepoint/releases/v1.1/epics/E09-doctor-command/tasks/T006-quality-gates-report.md +31 -0
  55. package/.savepoint/releases/v1.1/epics/E11-board-refresh-fix/E11-Detail.md +36 -0
  56. package/.savepoint/releases/v1.1/epics/E11-board-refresh-fix/tasks/T001-debug-logging.md +25 -0
  57. package/.savepoint/releases/v1.1/epics/E11-board-refresh-fix/tasks/T002-increase-debounce.md +21 -0
  58. package/.savepoint/releases/v1.1/epics/E11-board-refresh-fix/tasks/T003-error-handling.md +22 -0
  59. package/.savepoint/releases/v1.1/epics/E11-board-refresh-fix/tasks/T004-test-verify.md +29 -0
  60. package/.savepoint/releases/v1.1/epics/E12-validation-fix/E12-Audit.md +444 -0
  61. package/.savepoint/releases/v1.1/epics/E12-validation-fix/E12-Detail.md +45 -0
  62. package/.savepoint/releases/v1.1/epics/E12-validation-fix/tasks/T001-default-phase.md +35 -0
  63. package/.savepoint/releases/v1.1/epics/E12-validation-fix/tasks/T002-default-status.md +19 -0
  64. package/.savepoint/releases/v1.1/epics/E12-validation-fix/tasks/T003-better-errors.md +29 -0
  65. package/.savepoint/releases/v1.1/epics/E12-validation-fix/tasks/T004-validate-on-write.md +25 -0
  66. package/.savepoint/releases/v1.1/epics/E12-validation-fix/tasks/T005-tests.md +37 -0
  67. package/.savepoint/releases/v1.1/epics/E13-audit-remediation/E13-Audit.md +118 -0
  68. package/.savepoint/releases/v1.1/epics/E13-audit-remediation/E13-Detail.md +73 -0
  69. package/.savepoint/releases/v1.1/epics/E13-audit-remediation/tasks/T001-safe-cleanup.md +66 -0
  70. package/.savepoint/releases/v1.1/epics/E13-audit-remediation/tasks/T002-bug-fixes.md +35 -0
  71. package/.savepoint/releases/v1.1/epics/E13-audit-remediation/tasks/T003-centralize-duplication.md +60 -0
  72. package/.savepoint/releases/v1.1/epics/E13-audit-remediation/tasks/T004-infrastructure.md +33 -0
  73. package/.savepoint/releases/v1.1/epics/E13-audit-remediation/tasks/T005-decompose-update.md +37 -0
  74. package/.savepoint/releases/v1.1/epics/E13-audit-remediation/tasks/T006-async-io.md +40 -0
  75. package/.savepoint/releases/v1.1/epics/E13-audit-remediation/tasks/T007-test-coverage.md +37 -0
  76. package/.savepoint/releases/v1.1/epics/E14-structural-improvements/E14-Audit.md +267 -0
  77. package/.savepoint/releases/v1.1/epics/E14-structural-improvements/E14-Detail.md +54 -0
  78. package/.savepoint/releases/v1.1/epics/E14-structural-improvements/tasks/T001-group-model.md +39 -0
  79. package/.savepoint/releases/v1.1/epics/E14-structural-improvements/tasks/T002-data-interfaces.md +42 -0
  80. package/.savepoint/releases/v1.1/epics/E14-structural-improvements/tasks/T003-discover-orphans.md +33 -0
  81. package/.savepoint/releases/v1.1/epics/E14-structural-improvements/tasks/T004-epic-panel-headings.md +35 -0
  82. package/.savepoint/releases/v1.1/epics/E14-structural-improvements/tasks/T005-shell-tokenization.md +27 -0
  83. package/.savepoint/releases/v1.1/epics/E14-structural-improvements/tasks/T006-unify-enums.md +29 -0
  84. package/.savepoint/releases/v1.1/epics/E14-structural-improvements/tasks/T007-testutil-package.md +28 -0
  85. package/.savepoint/releases/v1.1/epics/E15-hardening/E15-Audit.md +272 -0
  86. package/.savepoint/releases/v1.1/epics/E15-hardening/E15-Detail.md +60 -0
  87. package/.savepoint/releases/v1.1/epics/E15-hardening/tasks/T001-benchmarks.md +31 -0
  88. package/.savepoint/releases/v1.1/epics/E15-hardening/tasks/T002-fuzz-targets.md +34 -0
  89. package/.savepoint/releases/v1.1/epics/E15-hardening/tasks/T003-debug-flag.md +30 -0
  90. package/.savepoint/releases/v1.1/epics/E15-hardening/tasks/T004-dist-checksums.md +27 -0
  91. package/.savepoint/releases/v1.1/epics/E15-hardening/tasks/T005-windows-targets.md +28 -0
  92. package/.savepoint/releases/v1.1/epics/E15-hardening/tasks/T006-abbreviation-splitting.md +26 -0
  93. package/.savepoint/releases/v1.1/epics/E15-hardening/tasks/T007-root-test-allowlist.md +33 -0
  94. package/.savepoint/releases/v1.1/epics/E15-hardening/tasks/T008-ci-and-release-automation.md +46 -0
  95. package/.savepoint/releases/v1.1/epics/_archived/T001-cli-entrypoint.md +25 -0
  96. package/.savepoint/releases/v1.1/epics/_archived/T002-quality-gates.md +27 -0
  97. package/.savepoint/releases/v1.1/epics/_archived/T003-snapshot.md +27 -0
  98. package/.savepoint/releases/v1.1/epics/_archived/T004-ai-reconcile.md +29 -0
  99. package/.savepoint/releases/v1.1/epics/_archived/T006-tui-review.md +31 -0
  100. package/.savepoint/releases/v1.1/epics/_archived/T008-skip-handling.md +34 -0
  101. package/.savepoint/releases/v1.1/v1.1-PRD.md +67 -7
  102. package/.savepoint/router.md +10 -17
  103. package/AGENTS.md +39 -24
  104. package/Makefile +3 -1
  105. package/README.md +0 -1
  106. package/agent-skills/savepoint-audit/SKILL.md +86 -34
  107. package/agent-skills/savepoint-build-task/SKILL.md +7 -2
  108. package/agent-skills/savepoint-create-plan/SKILL.md +7 -2
  109. package/agent-skills/savepoint-create-task/SKILL.md +44 -31
  110. package/agent-skills/savepoint-draft-prd/SKILL.md +7 -2
  111. package/agent-skills/savepoint-system-design/SKILL.md +7 -2
  112. package/agent_skills_test.go +91 -0
  113. package/cmd/board.go +59 -0
  114. package/cmd/board_test.go +137 -0
  115. package/cmd/doctor.go +53 -0
  116. package/cmd/doctor_test.go +146 -0
  117. package/cmd/init.go +63 -0
  118. package/cmd/init_test.go +104 -0
  119. package/internal/board/board.go +44 -36
  120. package/internal/board/board_test.go +27 -82
  121. package/internal/board/card.go +43 -23
  122. package/internal/board/card_test.go +74 -5
  123. package/internal/board/column.go +75 -15
  124. package/internal/board/column_test.go +76 -2
  125. package/internal/board/debug.go +26 -0
  126. package/internal/board/debug_test.go +108 -0
  127. package/internal/board/detail.go +33 -47
  128. package/internal/board/detail_test.go +48 -0
  129. package/internal/board/epic_panel.go +120 -22
  130. package/internal/board/epic_panel_test.go +302 -17
  131. package/internal/board/help.go +1 -0
  132. package/internal/board/help_test.go +1 -0
  133. package/internal/board/integration_test.go +266 -0
  134. package/internal/board/interfaces.go +65 -0
  135. package/internal/board/interfaces_test.go +114 -0
  136. package/internal/board/io.go +93 -0
  137. package/internal/board/model.go +79 -118
  138. package/internal/board/plain.go +88 -0
  139. package/internal/board/plain_test.go +117 -0
  140. package/internal/board/release.go +1 -9
  141. package/internal/board/release_test.go +6 -6
  142. package/internal/board/status.go +4 -4
  143. package/internal/board/theme.go +24 -0
  144. package/internal/board/theme_test.go +31 -0
  145. package/internal/board/transitions.go +113 -88
  146. package/internal/board/transitions_test.go +164 -141
  147. package/internal/board/tui.go +32 -0
  148. package/internal/board/update.go +344 -215
  149. package/internal/board/update_test.go +326 -18
  150. package/internal/board/util.go +76 -0
  151. package/internal/board/view.go +31 -28
  152. package/internal/board/view_test.go +74 -2
  153. package/internal/board/watch.go +41 -5
  154. package/internal/buildtool/main.go +45 -15
  155. package/internal/buildtool/main_test.go +224 -0
  156. package/internal/data/config.go +17 -3
  157. package/internal/data/config_test.go +49 -0
  158. package/internal/data/discover.go +26 -0
  159. package/internal/data/discover_test.go +34 -10
  160. package/internal/data/errors.go +4 -0
  161. package/internal/data/fuzz_test.go +75 -0
  162. package/internal/data/lifecycle.go +13 -6
  163. package/internal/data/lifecycle_test.go +14 -11
  164. package/internal/data/parser.go +22 -6
  165. package/internal/data/parser_test.go +31 -7
  166. package/internal/data/task.go +0 -9
  167. package/internal/data/testdata/fuzz/FuzzSplitFrontmatterBody/68eb66b0fe91e7e3 +2 -0
  168. package/internal/data/write.go +88 -11
  169. package/internal/data/write_test.go +167 -0
  170. package/internal/doctor/checks.go +567 -0
  171. package/internal/doctor/checks_test.go +716 -0
  172. package/internal/doctor/gates.go +193 -0
  173. package/internal/doctor/gates_test.go +166 -0
  174. package/internal/doctor/interfaces.go +64 -0
  175. package/internal/doctor/interfaces_test.go +104 -0
  176. package/internal/doctor/repairs.go +80 -0
  177. package/internal/doctor/repairs_test.go +81 -0
  178. package/internal/doctor/report.go +157 -0
  179. package/internal/doctor/report_test.go +89 -0
  180. package/internal/init/clipboard.go +146 -0
  181. package/internal/init/clipboard_test.go +74 -0
  182. package/internal/init/install.go +16 -0
  183. package/internal/init/integration_test.go +197 -0
  184. package/internal/init/prompt.go +14 -0
  185. package/internal/init/prompt_test.go +77 -0
  186. package/internal/init/scaffold.go +59 -0
  187. package/internal/init/scaffold_test.go +179 -0
  188. package/internal/init/template_freshness_test.go +56 -0
  189. package/internal/init/validate.go +85 -0
  190. package/internal/init/validate_test.go +141 -0
  191. package/internal/init/write.go +73 -0
  192. package/internal/init/write_test.go +91 -0
  193. package/internal/styles/styles_test.go +133 -0
  194. package/internal/testutil/fixture.go +113 -0
  195. package/internal/testutil/fs.go +26 -0
  196. package/main.go +120 -4
  197. package/package.json +2 -2
  198. package/project-audit/audit_report_glm_5.1.md +411 -0
  199. package/project-audit/audit_report_opus_4.6.md +406 -0
  200. package/project-audit/consolidated-audit-report.md +456 -0
  201. package/templates/project/.savepoint/Design.md +2 -2
  202. package/templates/project/.savepoint/router.md +10 -10
  203. package/templates/project/AGENTS.md +33 -21
  204. package/templates/project/agent-skills/savepoint-audit/SKILL.md +87 -0
  205. package/templates/project/agent-skills/savepoint-build-task/SKILL.md +44 -0
  206. package/templates/project/agent-skills/savepoint-create-plan/SKILL.md +33 -0
  207. package/templates/project/agent-skills/savepoint-create-task/SKILL.md +44 -0
  208. package/templates/project/agent-skills/savepoint-draft-prd/SKILL.md +37 -0
  209. package/templates/project/agent-skills/savepoint-system-design/SKILL.md +38 -0
  210. package/templates/prompts/audit-reconciliation.prompt.md +33 -28
  211. package/templates/prompts/design.prompt.md +3 -1
  212. package/.savepoint/audit/v1/E01/proposals.md +0 -168
  213. package/.savepoint/audit/v1/E01/snapshot.md +0 -78
  214. package/.savepoint/audit/v1/E01-go-setup/proposals.md +0 -166
  215. package/.savepoint/audit/v1/E01-go-setup/snapshot.md +0 -71
  216. package/.savepoint/audit/v1/E01-scaffolding/proposals/AGENTS.md +0 -66
  217. package/.savepoint/audit/v1/E01-scaffolding/proposals/Design.md +0 -210
  218. package/.savepoint/audit/v1/E01-scaffolding/proposals/epic-Design.md +0 -117
  219. package/.savepoint/audit/v1/E01-scaffolding/proposals/quality-review.md +0 -101
  220. package/.savepoint/audit/v1/E01-scaffolding/snapshot.md +0 -54
  221. package/.savepoint/audit/v1/E02-data-model/snapshot.md +0 -128
  222. package/.savepoint/audit/v1/E02-data-readers/proposals.md +0 -123
  223. package/.savepoint/audit/v1/E02-data-readers/snapshot.md +0 -54
  224. package/.savepoint/audit/v1/E03-board-tui-core/proposals.md +0 -146
  225. package/.savepoint/audit/v1/E03-board-tui-core/snapshot.md +0 -57
  226. package/.savepoint/audit/v1/E03-cli-foundation/snapshot.md +0 -106
  227. package/.savepoint/audit/v1/E04-board-components/proposals.md +0 -118
  228. package/.savepoint/audit/v1/E04-board-components/snapshot.md +0 -77
  229. package/.savepoint/audit/v1/E04-templates-and-prompts/snapshot.md +0 -115
  230. package/.savepoint/audit/v1/E05-init-command/snapshot.md +0 -125
  231. package/.savepoint/audit/v1/E05-phase-transitions/proposals.md +0 -83
  232. package/.savepoint/audit/v1/E05-phase-transitions/snapshot.md +0 -36
  233. package/.savepoint/audit/v1/E06-atari-noir-layout/proposals.md +0 -130
  234. package/.savepoint/audit/v1/E06-atari-noir-layout/snapshot.md +0 -84
  235. package/.savepoint/audit/v1/E06-tui-board/snapshot.md +0 -64
  236. package/.savepoint/audit/v1/E07-audit-pipeline/snapshot.md +0 -165
  237. package/.savepoint/audit/v1/E08-board-workflow-cleanup/snapshot.md +0 -65
  238. package/.savepoint/audit/v1.1/E02-cross-platform-compatibility/snapshot.md +0 -41
  239. package/.savepoint/audit/v1.1/E04-epic-navigation/snapshot.md +0 -48
  240. package/ink-cli-ui-design.zip +0 -0
  241. package/savepoint +0 -0
  242. package/savepoint.exe +0 -0
@@ -18,14 +18,20 @@ var columnOrder = []data.ColumnType{
18
18
  func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
19
19
  switch msg := msg.(type) {
20
20
  case fileChangeMsg:
21
+ debugf("dispatch: fileChangeMsg")
21
22
  if m.Root != "" {
22
- return m, reloadTasks(m.Root)
23
+ return m, reloadTasks(m.Root, m.Dependencies)
23
24
  }
24
25
  case reloadMsg:
26
+ debugf("dispatch: reloadMsg tasks=%d releases=%d", len(msg.tasks), len(msg.releases))
25
27
  m.AllTasks = msg.tasks
26
28
  m.Releases = append([]string(nil), msg.releases...)
27
29
  m.ReleaseEpics = copyReleaseEpics(msg.releaseEpics)
28
30
  m.EpicStatus = msg.epicStatuses
31
+ if msg.routerState != nil {
32
+ m.RouterState = msg.routerState
33
+ m.RouterTask = msg.routerState.Task
34
+ }
29
35
  m.SelectedRelease = firstKnown(m.SelectedRelease, m.Releases)
30
36
  m.refreshEpicsForRelease()
31
37
  m.refreshTasks()
@@ -35,149 +41,325 @@ func (m Model) Update(msg tea.Msg) (tea.Model, tea.Cmd) {
35
41
  }
36
42
  case tea.KeyMsg:
37
43
  if m.Overlay != OverlayNone {
38
- return m.updateOverlay(msg)
44
+ return m.handleOverlay(msg)
45
+ }
46
+ return m.handleBoardKey(msg)
47
+ case tea.WindowSizeMsg:
48
+ m.Width = msg.Width
49
+ m.Height = msg.Height
50
+ if !m.epicPanelAvailable() {
51
+ m.EpicPanelFocus = false
39
52
  }
40
- switch msg.String() {
41
- case "q", "ctrl+c":
42
- if m.Watcher != nil {
43
- m.Watcher.Close()
53
+ m.ensureFocusedTaskVisible()
54
+ case routerWriteMsg:
55
+ m.StatusMessage = msg.message
56
+ m.RouterState = msg.state
57
+ m.RouterTask = msg.taskID
58
+ case taskWriteMsg:
59
+ for i, t := range m.AllTasks {
60
+ if t.ID == msg.next.ID {
61
+ m.AllTasks[i] = msg.next
62
+ break
44
63
  }
45
- return m, tea.Quit
46
- case "e":
47
- m.Overlay = OverlayEpic
48
- m.EpicCursor = epicIndex(m.Epics, m.SelectedEpic)
64
+ }
65
+ m.StatusMessage = taskTransitionMessage(msg.prefix, msg.next)
66
+ m.refreshTasks()
67
+ m.ensureFocusedTaskVisible()
68
+ case epicDetailMsg:
69
+ m.EpicDetailContent = msg.content
70
+ case auditContentMsg:
71
+ m.EpicAuditContent = msg.content
72
+ case errorMsg:
73
+ m.StatusMessage = msg.message
74
+ }
75
+ return m, nil
76
+ }
77
+
78
+ func (m Model) handleOverlay(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
79
+ switch m.Overlay {
80
+ case OverlayHelp:
81
+ return m.handleHelpOverlay(msg)
82
+ case OverlayEpic:
83
+ return m.handleEpicOverlay(msg)
84
+ case OverlayRelease:
85
+ return m.handleReleaseOverlay(msg)
86
+ case OverlayDetail:
87
+ return m.handleDetailOverlay(msg)
88
+ case OverlayEpicDetail:
89
+ return m.handleEpicDetailOverlay(msg)
90
+ }
91
+ return m, nil
92
+ }
93
+
94
+ func (m Model) handleBoardKey(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
95
+ switch msg.String() {
96
+ case "q", "ctrl+c":
97
+ if m.Watcher != nil {
98
+ m.Watcher.Close()
99
+ }
100
+ return m, tea.Quit
101
+ case "e":
102
+ m.Overlay = OverlayEpic
103
+ m.EpicCursor = sliceIndex(m.Epics, m.SelectedEpic)
104
+ return m, nil
105
+ case "r":
106
+ m.Overlay = OverlayRelease
107
+ m.ReleaseCursor = sliceIndex(m.Releases, m.SelectedRelease)
108
+ return m, nil
109
+ case "?":
110
+ m.Overlay = OverlayHelp
111
+ return m, nil
112
+ case "p":
113
+ task, ok := m.focusedTask()
114
+ if !ok {
49
115
  return m, nil
50
- case "r":
51
- m.Overlay = OverlayRelease
52
- m.ReleaseCursor = releaseIndex(m.Releases, m.SelectedRelease)
116
+ }
117
+ if taskDone(task) {
118
+ m.StatusMessage = "Router not updated: focused task is done"
53
119
  return m, nil
54
- case "?":
55
- m.Overlay = OverlayHelp
120
+ }
121
+ if m.Root == "" {
122
+ m.StatusMessage = "Router not updated: no savepoint root"
56
123
  return m, nil
57
- case "m":
58
- task, ok := m.focusedTask()
59
- if !ok {
60
- return m, nil
61
- }
62
- if taskDone(task) {
63
- m.StatusMessage = "Router not updated: focused task is done"
64
- return m, nil
65
- }
66
- if m.Root == "" {
67
- m.StatusMessage = "Router not updated: no savepoint root"
68
- return m, nil
69
- }
70
- message, err := m.writeRouterTask(task)
71
- if err != nil {
72
- m.StatusMessage = err.Error()
73
- return m, nil
74
- }
75
- m.StatusMessage = message
124
+ }
125
+ return m, writeRouterTaskCmd(m.Root, task, m.Dependencies.RouterReader)
126
+ }
127
+ if m.EpicPanelFocus {
128
+ if !m.epicPanelAvailable() {
129
+ m.EpicPanelFocus = false
130
+ } else {
131
+ return m.updateEpicPanel(msg)
132
+ }
133
+ }
134
+ switch msg.String() {
135
+ case "left", "h":
136
+ if m.FocusedColumn == data.ColumnPlanned && m.epicPanelAvailable() {
137
+ m.EpicPanelFocus = true
138
+ m.EpicPanelCursor = sliceIndex(m.Epics, m.SelectedEpic)
139
+ m.StatusMessage = ""
76
140
  return m, nil
77
141
  }
78
- if m.EpicPanelFocus {
79
- if !m.epicPanelAvailable() {
80
- m.EpicPanelFocus = false
81
- } else {
82
- return m.updateEpicPanel(msg)
142
+ m.FocusedColumn = prevColumn(m.FocusedColumn)
143
+ m.FocusedTask = 0
144
+ m.ensureFocusedTaskVisible()
145
+ m.StatusMessage = ""
146
+ case "right", "l":
147
+ m.FocusedColumn = nextColumn(m.FocusedColumn)
148
+ m.FocusedTask = 0
149
+ m.ensureFocusedTaskVisible()
150
+ m.StatusMessage = ""
151
+ case "up", "k":
152
+ if m.FocusedTask > 0 {
153
+ m.FocusedTask--
154
+ }
155
+ m.ensureFocusedTaskVisible()
156
+ m.StatusMessage = ""
157
+ case "down", "j":
158
+ if m.FocusedTask < len(m.Tasks[m.FocusedColumn])-1 {
159
+ m.FocusedTask++
160
+ }
161
+ m.ensureFocusedTaskVisible()
162
+ m.StatusMessage = ""
163
+ case "pgup":
164
+ m.scrollFocusedColumn(-m.columnPageSize())
165
+ m.StatusMessage = ""
166
+ case "pgdown":
167
+ m.scrollFocusedColumn(m.columnPageSize())
168
+ m.StatusMessage = ""
169
+ case "enter":
170
+ tasks := m.Tasks[m.FocusedColumn]
171
+ if len(tasks) > 0 && m.FocusedTask < len(tasks) {
172
+ m.Overlay = OverlayDetail
173
+ m.DetailOffset = 0
174
+ }
175
+ m.StatusMessage = ""
176
+ case " ":
177
+ return m.handleAdvanceTask()
178
+ case "backspace":
179
+ return m.handleRetreatTask()
180
+ }
181
+ return m, nil
182
+ }
183
+
184
+ func (m Model) handleAdvanceTask() (tea.Model, tea.Cmd) {
185
+ tasks := m.Tasks[m.FocusedColumn]
186
+ if len(tasks) > 0 && m.FocusedTask < len(tasks) {
187
+ task := tasks[m.FocusedTask]
188
+ if ok, reason := CanAdvance(&task, m.AllTasks); !ok {
189
+ m.StatusMessage = reason
190
+ return m, nil
191
+ }
192
+ m.StatusMessage = ""
193
+ for i, t := range m.AllTasks {
194
+ if t.ID == task.ID {
195
+ next := m.AllTasks[i]
196
+ Advance(&next)
197
+ if next.Path != "" {
198
+ return m, writeTaskStatusCmd(t, next, task.Mtime, "Moved")
199
+ }
200
+ m.AllTasks[i] = next
201
+ m.StatusMessage = taskTransitionMessage("Moved", next)
202
+ break
83
203
  }
84
204
  }
85
- switch msg.String() {
86
- case "left", "h":
87
- if m.FocusedColumn == data.ColumnPlanned && m.epicPanelAvailable() {
88
- m.EpicPanelFocus = true
89
- m.EpicPanelCursor = epicIndex(m.Epics, m.SelectedEpic)
90
- m.StatusMessage = ""
91
- return m, nil
205
+ m.refreshTasks()
206
+ m.ensureFocusedTaskVisible()
207
+ }
208
+ return m, nil
209
+ }
210
+
211
+ func (m Model) handleRetreatTask() (tea.Model, tea.Cmd) {
212
+ tasks := m.Tasks[m.FocusedColumn]
213
+ if len(tasks) > 0 && m.FocusedTask < len(tasks) {
214
+ task := tasks[m.FocusedTask]
215
+ m.StatusMessage = ""
216
+ for i, t := range m.AllTasks {
217
+ if t.ID == task.ID {
218
+ next := m.AllTasks[i]
219
+ Retreat(&next)
220
+ if next.Path != "" {
221
+ return m, writeTaskStatusCmd(t, next, task.Mtime, "Moved back")
222
+ }
223
+ m.AllTasks[i] = next
224
+ m.StatusMessage = taskTransitionMessage("Moved back", next)
225
+ break
92
226
  }
93
- m.FocusedColumn = prevColumn(m.FocusedColumn)
94
- m.FocusedTask = 0
95
- m.ensureFocusedTaskVisible()
96
- m.StatusMessage = ""
97
- case "right", "l":
98
- m.FocusedColumn = nextColumn(m.FocusedColumn)
227
+ }
228
+ m.refreshTasks()
229
+ m.ensureFocusedTaskVisible()
230
+ }
231
+ return m, nil
232
+ }
233
+
234
+ func (m Model) handleHelpOverlay(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
235
+ switch msg.String() {
236
+ case "esc", "q":
237
+ m.Overlay = OverlayNone
238
+ }
239
+ return m, nil
240
+ }
241
+
242
+ func (m Model) handleEpicOverlay(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
243
+ switch msg.String() {
244
+ case "esc", "q":
245
+ m.Overlay = OverlayNone
246
+ case "up", "k":
247
+ if m.EpicCursor > 0 {
248
+ m.EpicCursor--
249
+ }
250
+ case "down", "j":
251
+ if len(m.Epics) > 0 && m.EpicCursor < len(m.Epics)-1 {
252
+ m.EpicCursor++
253
+ }
254
+ case "enter":
255
+ if len(m.Epics) > 0 {
256
+ m.SelectedEpic = m.Epics[m.EpicCursor]
99
257
  m.FocusedTask = 0
258
+ m.DetailOffset = 0
259
+ m.refreshTasks()
100
260
  m.ensureFocusedTaskVisible()
101
- m.StatusMessage = ""
102
- case "up", "k":
103
- if m.FocusedTask > 0 {
104
- m.FocusedTask--
105
- }
106
- m.ensureFocusedTaskVisible()
107
- m.StatusMessage = ""
108
- case "down", "j":
109
- if m.FocusedTask < len(m.Tasks[m.FocusedColumn])-1 {
110
- m.FocusedTask++
261
+ m.Overlay = OverlayNone
262
+ if m.Root != "" {
263
+ return m, writeRouterReleaseEpicCmd(m.Root, m.SelectedEpic, m.SelectedRelease, m.Dependencies.RouterReader)
111
264
  }
265
+ }
266
+ }
267
+ return m, nil
268
+ }
269
+
270
+ func (m Model) handleReleaseOverlay(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
271
+ switch msg.String() {
272
+ case "esc", "q":
273
+ m.Overlay = OverlayNone
274
+ case "up", "k":
275
+ if m.ReleaseCursor > 0 {
276
+ m.ReleaseCursor--
277
+ }
278
+ case "down", "j":
279
+ if len(m.Releases) > 0 && m.ReleaseCursor < len(m.Releases)-1 {
280
+ m.ReleaseCursor++
281
+ }
282
+ case "enter":
283
+ if len(m.Releases) > 0 {
284
+ m.SelectedRelease = m.Releases[m.ReleaseCursor]
285
+ m.refreshEpicsForRelease()
286
+ m.FocusedTask = 0
287
+ m.DetailOffset = 0
288
+ m.refreshTasks()
112
289
  m.ensureFocusedTaskVisible()
113
- m.StatusMessage = ""
114
- case "pgup":
115
- m.scrollFocusedColumn(-m.columnPageSize())
116
- m.StatusMessage = ""
117
- case "pgdown":
118
- m.scrollFocusedColumn(m.columnPageSize())
119
- m.StatusMessage = ""
120
- case "enter":
121
- tasks := m.Tasks[m.FocusedColumn]
122
- if len(tasks) > 0 && m.FocusedTask < len(tasks) {
123
- m.Overlay = OverlayDetail
124
- m.DetailOffset = 0
125
- }
126
- m.StatusMessage = ""
127
- case " ":
128
- tasks := m.Tasks[m.FocusedColumn]
129
- if len(tasks) > 0 && m.FocusedTask < len(tasks) {
130
- task := tasks[m.FocusedTask]
131
- if ok, reason := CanAdvance(&task, m.AllTasks); !ok {
132
- m.StatusMessage = reason
133
- } else {
134
- m.StatusMessage = ""
135
- for i, t := range m.AllTasks {
136
- if t.ID == task.ID {
137
- Advance(&m.AllTasks[i])
138
- if m.AllTasks[i].Path != "" {
139
- if err := data.WriteTaskStatus(m.AllTasks[i].Path, &m.AllTasks[i], task.Mtime); err != nil && err != data.ErrMtimeConflict {
140
- m.StatusMessage = err.Error()
141
- }
142
- }
143
- break
144
- }
145
- }
146
- m.refreshTasks()
147
- m.ensureFocusedTaskVisible()
148
- }
290
+ m.Overlay = OverlayNone
291
+ if m.Root != "" {
292
+ return m, writeRouterReleaseEpicCmd(m.Root, m.SelectedEpic, m.SelectedRelease, m.Dependencies.RouterReader)
149
293
  }
150
- case "backspace":
151
- tasks := m.Tasks[m.FocusedColumn]
152
- if len(tasks) > 0 && m.FocusedTask < len(tasks) {
153
- task := tasks[m.FocusedTask]
154
- m.StatusMessage = ""
155
- for i, t := range m.AllTasks {
156
- if t.ID == task.ID {
157
- Retreat(&m.AllTasks[i])
158
- if m.AllTasks[i].Path != "" {
159
- if err := data.WriteTaskStatus(m.AllTasks[i].Path, &m.AllTasks[i], task.Mtime); err != nil && err != data.ErrMtimeConflict {
160
- m.StatusMessage = err.Error()
161
- }
162
- }
163
- break
164
- }
165
- }
166
- m.refreshTasks()
167
- m.ensureFocusedTaskVisible()
294
+ }
295
+ }
296
+ return m, nil
297
+ }
298
+
299
+ func (m Model) handleDetailOverlay(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
300
+ switch msg.String() {
301
+ case "esc", "q":
302
+ m.Overlay = OverlayNone
303
+ case "up", "k":
304
+ if m.DetailOffset > 0 {
305
+ m.DetailOffset--
306
+ }
307
+ case "down", "j":
308
+ m.DetailOffset++
309
+ case "pgup":
310
+ m.DetailOffset -= m.detailPageSize()
311
+ if m.DetailOffset < 0 {
312
+ m.DetailOffset = 0
313
+ }
314
+ case "pgdown":
315
+ m.DetailOffset += m.detailPageSize()
316
+ }
317
+ return m, nil
318
+ }
319
+
320
+ func (m Model) handleEpicDetailOverlay(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
321
+ switch msg.String() {
322
+ case "esc", "q":
323
+ m.Overlay = OverlayNone
324
+ case "1":
325
+ m.EpicDetailTab = 0
326
+ m.EpicDetailOffset = 0
327
+ case "2":
328
+ m.EpicDetailTab = 1
329
+ m.EpicDetailOffset = 0
330
+ if m.EpicAuditContent == "" {
331
+ epicSlug := m.epicDetailEpic()
332
+ shortEpicID := epicSlug
333
+ if idx := strings.Index(epicSlug, "-"); idx >= 0 {
334
+ shortEpicID = epicSlug[:idx]
168
335
  }
336
+ epicDir := filepath.Join(m.Root, "releases", m.SelectedRelease, "epics", epicSlug)
337
+ return m, readEpicAuditCmd(epicDir, shortEpicID)
169
338
  }
170
- case tea.WindowSizeMsg:
171
- m.Width = msg.Width
172
- m.Height = msg.Height
173
- if !m.epicPanelAvailable() {
174
- m.EpicPanelFocus = false
339
+ case "up", "k":
340
+ if m.EpicDetailOffset > 0 {
341
+ m.EpicDetailOffset--
175
342
  }
176
- m.ensureFocusedTaskVisible()
343
+ case "down", "j":
344
+ m.EpicDetailOffset++
345
+ case "pgup":
346
+ m.EpicDetailOffset -= m.detailPageSize()
347
+ if m.EpicDetailOffset < 0 {
348
+ m.EpicDetailOffset = 0
349
+ }
350
+ case "pgdown":
351
+ m.EpicDetailOffset += m.detailPageSize()
177
352
  }
178
353
  return m, nil
179
354
  }
180
355
 
356
+ func taskWriteErrorMessage(err error) string {
357
+ if err == data.ErrMtimeConflict {
358
+ return "mtime conflict: refresh before retrying"
359
+ }
360
+ return err.Error()
361
+ }
362
+
181
363
  func (m Model) updateEpicPanel(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
182
364
  if len(m.Epics) == 0 {
183
365
  m.EpicPanelFocus = false
@@ -189,29 +371,28 @@ func (m Model) updateEpicPanel(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
189
371
  case "up", "k":
190
372
  if m.EpicPanelCursor > 0 {
191
373
  m.EpicPanelCursor--
192
- m.selectEpicPanelEpic()
374
+ return m, m.selectEpicPanelEpic()
193
375
  }
194
376
  case "down", "j":
195
377
  if m.EpicPanelCursor < len(m.Epics)-1 {
196
378
  m.EpicPanelCursor++
197
- m.selectEpicPanelEpic()
379
+ return m, m.selectEpicPanelEpic()
198
380
  }
199
381
  case "enter":
200
- m.openEpicDetailOverlay()
382
+ return m, m.openEpicDetailOverlay()
201
383
  case "right", "l":
202
384
  m.EpicPanelFocus = false
203
385
  m.FocusedColumn = data.ColumnPlanned
204
386
  m.FocusedTask = 0
205
387
  m.ensureFocusedTaskVisible()
206
388
  case "left", "h":
207
- // Stay in the panel; there is no focusable region further left.
208
389
  }
209
390
  return m, nil
210
391
  }
211
392
 
212
- func (m *Model) selectEpicPanelEpic() {
393
+ func (m *Model) selectEpicPanelEpic() tea.Cmd {
213
394
  if len(m.Epics) == 0 || m.EpicPanelCursor < 0 || m.EpicPanelCursor >= len(m.Epics) {
214
- return
395
+ return nil
215
396
  }
216
397
  m.SelectedEpic = m.Epics[m.EpicPanelCursor]
217
398
  m.FocusedTask = 0
@@ -219,15 +400,14 @@ func (m *Model) selectEpicPanelEpic() {
219
400
  m.refreshTasks()
220
401
  m.ensureFocusedTaskVisible()
221
402
  if m.Root != "" {
222
- if err := m.writeRouterReleaseEpic(); err != nil {
223
- m.StatusMessage = err.Error()
224
- }
403
+ return writeRouterReleaseEpicCmd(m.Root, m.SelectedEpic, m.SelectedRelease, m.Dependencies.RouterReader)
225
404
  }
405
+ return nil
226
406
  }
227
407
 
228
- func (m *Model) openEpicDetailOverlay() {
408
+ func (m *Model) openEpicDetailOverlay() tea.Cmd {
229
409
  if len(m.Epics) == 0 || m.EpicPanelCursor < 0 || m.EpicPanelCursor >= len(m.Epics) {
230
- return
410
+ return nil
231
411
  }
232
412
  epicSlug := m.Epics[m.EpicPanelCursor]
233
413
  shortEpicID := epicSlug
@@ -235,13 +415,14 @@ func (m *Model) openEpicDetailOverlay() {
235
415
  shortEpicID = epicSlug[:idx]
236
416
  }
237
417
  epicDir := filepath.Join(m.Root, "releases", m.SelectedRelease, "epics", epicSlug)
238
- m.EpicDetailContent = readEpicDetailFile(epicDir, shortEpicID)
418
+ m.EpicDetailEpic = epicSlug
239
419
  m.EpicDetailOffset = 0
420
+ m.EpicDetailTab = 0
421
+ m.EpicAuditContent = ""
240
422
  m.Overlay = OverlayEpicDetail
423
+ return readEpicDetailCmd(epicDir, shortEpicID)
241
424
  }
242
425
 
243
- // readEpicDetailFile finds and reads the canonical detail file for an epic.
244
- // Tries E##-Detail.md then E##-Design.md; falls back to any E##-*.md in the dir.
245
426
  func readEpicDetailFile(epicDir, shortID string) string {
246
427
  for _, suffix := range []string{"-Detail.md", "-Design.md"} {
247
428
  if raw, err := os.ReadFile(filepath.Join(epicDir, shortID+suffix)); err == nil {
@@ -271,86 +452,17 @@ func copyReleaseEpics(in map[string][]string) map[string][]string {
271
452
  return out
272
453
  }
273
454
 
274
- func (m Model) updateOverlay(msg tea.KeyMsg) (tea.Model, tea.Cmd) {
275
- switch msg.String() {
276
- case "esc", "q":
277
- m.Overlay = OverlayNone
278
- case "up", "k":
279
- if m.Overlay == OverlayDetail && m.DetailOffset > 0 {
280
- m.DetailOffset--
281
- }
282
- if m.Overlay == OverlayEpicDetail && m.EpicDetailOffset > 0 {
283
- m.EpicDetailOffset--
284
- }
285
- if m.Overlay == OverlayEpic && m.EpicCursor > 0 {
286
- m.EpicCursor--
287
- }
288
- if m.Overlay == OverlayRelease && m.ReleaseCursor > 0 {
289
- m.ReleaseCursor--
290
- }
291
- case "down", "j":
292
- if m.Overlay == OverlayDetail {
293
- m.DetailOffset++
294
- }
295
- if m.Overlay == OverlayEpicDetail {
296
- m.EpicDetailOffset++
297
- }
298
- if m.Overlay == OverlayEpic && len(m.Epics) > 0 && m.EpicCursor < len(m.Epics)-1 {
299
- m.EpicCursor++
300
- }
301
- if m.Overlay == OverlayRelease && len(m.Releases) > 0 && m.ReleaseCursor < len(m.Releases)-1 {
302
- m.ReleaseCursor++
303
- }
304
- case "enter":
305
- if m.Overlay == OverlayEpic && len(m.Epics) > 0 {
306
- m.SelectedEpic = m.Epics[m.EpicCursor]
307
- m.FocusedTask = 0
308
- m.DetailOffset = 0
309
- m.refreshTasks()
310
- m.ensureFocusedTaskVisible()
311
- m.Overlay = OverlayNone
312
- if m.Root != "" {
313
- if err := m.writeRouterReleaseEpic(); err != nil {
314
- m.StatusMessage = err.Error()
315
- }
316
- }
317
- }
318
- if m.Overlay == OverlayRelease && len(m.Releases) > 0 {
319
- m.SelectedRelease = m.Releases[m.ReleaseCursor]
320
- m.refreshEpicsForRelease()
321
- m.FocusedTask = 0
322
- m.DetailOffset = 0
323
- m.refreshTasks()
324
- m.ensureFocusedTaskVisible()
325
- m.Overlay = OverlayNone
326
- if m.Root != "" {
327
- if err := m.writeRouterReleaseEpic(); err != nil {
328
- m.StatusMessage = err.Error()
329
- }
330
- }
331
- }
332
- case "pgup":
333
- if m.Overlay == OverlayDetail {
334
- m.DetailOffset -= m.detailPageSize()
335
- if m.DetailOffset < 0 {
336
- m.DetailOffset = 0
337
- }
338
- }
339
- if m.Overlay == OverlayEpicDetail {
340
- m.EpicDetailOffset -= m.detailPageSize()
341
- if m.EpicDetailOffset < 0 {
342
- m.EpicDetailOffset = 0
343
- }
344
- }
345
- case "pgdown":
346
- if m.Overlay == OverlayDetail {
347
- m.DetailOffset += m.detailPageSize()
348
- }
349
- if m.Overlay == OverlayEpicDetail {
350
- m.EpicDetailOffset += m.detailPageSize()
351
- }
455
+ func (m Model) epicDetailEpic() string {
456
+ if m.EpicDetailEpic != "" {
457
+ return m.EpicDetailEpic
352
458
  }
353
- return m, nil
459
+ if m.SelectedEpic != "" {
460
+ return m.SelectedEpic
461
+ }
462
+ if len(m.Epics) > 0 && m.EpicPanelCursor >= 0 && m.EpicPanelCursor < len(m.Epics) {
463
+ return m.Epics[m.EpicPanelCursor]
464
+ }
465
+ return ""
354
466
  }
355
467
 
356
468
  func (m *Model) ensureFocusedTaskVisible() {
@@ -411,6 +523,23 @@ func (m Model) columnPageSize() int {
411
523
  return visibleColumnTaskLimit(CalculateLayout(m.Width, h).ContentHeight)
412
524
  }
413
525
 
526
+ // conservativeColumnPageSize reserves 2 lines for scroll indicators so that
527
+ // ensureFocusedTaskVisible never sets an offset where the focused card is hidden
528
+ // by a top or bottom indicator that wasn't accounted for in the page budget.
529
+ func (m Model) conservativeColumnPageSize() int {
530
+ h := m.Height
531
+ if h == 0 {
532
+ h = defaultTermH
533
+ }
534
+ contentHeight := CalculateLayout(m.Width, h).ContentHeight
535
+ // contentHeight - 2 = card budget; subtract 2 more for both indicators.
536
+ limit := (contentHeight - 4) / 3
537
+ if limit < 1 {
538
+ return 1
539
+ }
540
+ return limit
541
+ }
542
+
414
543
  func (m Model) detailPageSize() int {
415
544
  return max(detailMaxHeight(m.Height)-3, 1)
416
545
  }