coding-agent-harness 1.0.8 → 1.1.0

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 (232) hide show
  1. package/CHANGELOG.md +10 -0
  2. package/CONTRIBUTING.md +8 -4
  3. package/README.md +12 -2
  4. package/README.zh-CN.md +10 -2
  5. package/SKILL.md +14 -3
  6. package/dist/build-dist.mjs +19 -6
  7. package/dist/check-dist-observation.mjs +57 -29
  8. package/dist/check-harness.mjs +0 -1
  9. package/dist/check-import-graph.mjs +44 -27
  10. package/dist/check-lite-forbidden-surfaces.mjs +121 -0
  11. package/dist/check-no-ts-nocheck.mjs +7 -7
  12. package/dist/check-runtime-emit.mjs +10 -3
  13. package/dist/check-type-boundaries.mjs +51 -9
  14. package/dist/commands/dashboard-command.mjs +52 -14
  15. package/dist/commands/migration-command.mjs +18 -8
  16. package/dist/commands/module-command.mjs +142 -0
  17. package/dist/commands/preset-command.mjs +51 -12
  18. package/dist/commands/registry.mjs +483 -0
  19. package/dist/commands/task-command.mjs +109 -52
  20. package/dist/harness.mjs +6 -304
  21. package/dist/lib/capability-registry.mjs +229 -53
  22. package/dist/lib/check-module-parallel.mjs +1 -6
  23. package/dist/lib/check-profiles.mjs +39 -46
  24. package/dist/lib/check-task-contracts.mjs +6 -4
  25. package/dist/lib/command-registry.mjs +248 -0
  26. package/dist/lib/core-shared.mjs +78 -3
  27. package/dist/lib/dashboard-data.mjs +203 -22
  28. package/dist/lib/dashboard-workbench.mjs +245 -21
  29. package/dist/lib/dashboard-writer.mjs +4 -1
  30. package/dist/lib/git-status-summary.mjs +0 -1
  31. package/dist/lib/governance-index-generator.mjs +7 -5
  32. package/dist/lib/governance-sync.mjs +46 -121
  33. package/dist/lib/governance-table-boundary.mjs +1 -14
  34. package/dist/lib/harness-core.mjs +4 -1
  35. package/dist/lib/harness-paths.mjs +115 -1
  36. package/dist/lib/impact-classifier.mjs +420 -0
  37. package/dist/lib/lesson-maintenance.mjs +1 -2
  38. package/dist/lib/markdown-utils.mjs +50 -1
  39. package/dist/lib/migration-planner.mjs +31 -16
  40. package/dist/lib/migration-support.mjs +5 -4
  41. package/dist/lib/module-registry.mjs +296 -0
  42. package/dist/lib/preset-audit-contracts.mjs +24 -1
  43. package/dist/lib/preset-engine.mjs +67 -29
  44. package/dist/lib/preset-registry.mjs +361 -71
  45. package/dist/lib/preset-runner.mjs +292 -26
  46. package/dist/lib/review-confirm-git-gate.mjs +73 -19
  47. package/dist/lib/status-builder.mjs +23 -8
  48. package/dist/lib/structure-migration.mjs +6 -4
  49. package/dist/lib/subagent-authorization-audit.mjs +8 -2
  50. package/dist/lib/task-archive-eligibility.mjs +65 -0
  51. package/dist/lib/task-audit-metadata.mjs +25 -11
  52. package/dist/lib/task-audit-migration.mjs +21 -14
  53. package/dist/lib/task-discovery-contract.mjs +32 -0
  54. package/dist/lib/task-index.mjs +3 -2
  55. package/dist/lib/task-lesson-candidates.mjs +1 -2
  56. package/dist/lib/task-lesson-sedimentation.mjs +310 -9
  57. package/dist/lib/task-lifecycle/create-task-helpers.mjs +6 -3
  58. package/dist/lib/task-lifecycle/phase-sync.mjs +0 -1
  59. package/dist/lib/task-lifecycle/preset-interop.mjs +16 -0
  60. package/dist/lib/task-lifecycle/review-confirm.mjs +34 -2
  61. package/dist/lib/task-lifecycle/review-gates.mjs +12 -5
  62. package/dist/lib/task-lifecycle/review-submission.mjs +1 -2
  63. package/dist/lib/task-lifecycle/scaffold-provenance.mjs +0 -1
  64. package/dist/lib/task-lifecycle/template-files.mjs +2 -5
  65. package/dist/lib/task-lifecycle.mjs +116 -160
  66. package/dist/lib/task-metadata.mjs +10 -5
  67. package/dist/lib/task-preset-contract-drift.mjs +45 -0
  68. package/dist/lib/task-repository.mjs +192 -0
  69. package/dist/lib/task-review-model.mjs +36 -17
  70. package/dist/lib/task-scanner.mjs +74 -23
  71. package/dist/lib/task-template-materials.mjs +131 -0
  72. package/dist/lib/task-tombstone-commands.mjs +186 -29
  73. package/dist/lib/types/check-profiles.js +1 -0
  74. package/dist/lib/types/impact.js +1 -0
  75. package/dist/lib/types/preset.js +1 -0
  76. package/dist/lib/types/task-lifecycle.js +1 -0
  77. package/dist/lib/types/task-scanner.js +1 -0
  78. package/dist/postinstall.mjs +2 -2
  79. package/dist/run-built-tests.mjs +10 -3
  80. package/docs-release/README.md +1 -0
  81. package/docs-release/architecture/document-contract-kernel/README.md +150 -0
  82. package/docs-release/architecture/document-contract-kernel/products/full-skill-overlay.md +29 -0
  83. package/docs-release/architecture/document-contract-kernel/products/lite-forbidden-surfaces.txt +26 -0
  84. package/docs-release/architecture/document-contract-kernel/products/lite-skill-overlay.md +37 -0
  85. package/docs-release/architecture/overview.md +2 -2
  86. package/docs-release/architecture/overview.zh-CN.md +2 -2
  87. package/docs-release/architecture/system-explainer/01-system-overview.md +11 -7
  88. package/docs-release/architecture/system-explainer/02-module-dependency.md +4 -4
  89. package/docs-release/architecture/system-explainer/03-task-lifecycle.md +17 -12
  90. package/docs-release/architecture/system-explainer/05-data-flow.md +6 -6
  91. package/docs-release/architecture/system-explainer/06-preset-and-migration.md +2 -2
  92. package/docs-release/architecture/system-explainer/README.md +1 -1
  93. package/docs-release/architecture/system-explainer/en-US/01-system-overview.md +12 -8
  94. package/docs-release/architecture/system-explainer/en-US/02-module-dependency.md +5 -5
  95. package/docs-release/architecture/system-explainer/en-US/03-task-lifecycle.md +19 -11
  96. package/docs-release/architecture/system-explainer/en-US/05-data-flow.md +5 -5
  97. package/docs-release/architecture/system-explainer/en-US/06-preset-and-migration.md +2 -2
  98. package/docs-release/architecture/system-explainer/en-US/README.md +1 -1
  99. package/docs-release/guides/agent-installation.en-US.md +4 -6
  100. package/docs-release/guides/agent-installation.md +11 -8
  101. package/docs-release/guides/contributing.md +10 -3
  102. package/docs-release/guides/contributing.zh-CN.md +10 -3
  103. package/docs-release/guides/legacy-migration-agent-prompt.md +1 -1
  104. package/docs-release/guides/legacy-migration-agent-prompt.zh-CN.md +1 -1
  105. package/docs-release/guides/migration-playbook.en-US.md +9 -6
  106. package/docs-release/guides/migration-playbook.md +9 -6
  107. package/docs-release/guides/preset-development.md +68 -2
  108. package/docs-release/guides/task-state-machine.en-US.md +8 -8
  109. package/docs-release/guides/task-state-machine.md +7 -7
  110. package/docs-release/guides/typescript-runtime-migration-closeout.md +17 -13
  111. package/package.json +16 -12
  112. package/postinstall.mjs +37 -0
  113. package/presets/legacy-migration/preset.yaml +5 -5
  114. package/presets/legacy-migration/templates/execution_strategy.append.md +1 -1
  115. package/presets/lesson-sedimentation/preset.yaml +3 -3
  116. package/presets/module/preset.yaml +2 -2
  117. package/presets/module/templates/execution_strategy.append.md +1 -1
  118. package/presets/module/templates/task_plan.append.md +3 -3
  119. package/presets/release-closeout/checks/check-release-package.mjs +6 -1
  120. package/presets/release-closeout/preset.yaml +9 -9
  121. package/presets/release-closeout/scripts/generate-release-package.mjs +387 -25
  122. package/presets/release-closeout/templates/task_plan.append.md +5 -5
  123. package/presets/standard-task/preset.yaml +2 -2
  124. package/references/agents-md-pattern.md +23 -17
  125. package/references/lessons-governance.md +2 -2
  126. package/references/module-parallel-standard.md +3 -6
  127. package/references/ssot-governance.md +2 -2
  128. package/references/taskr-gap-analysis.md +3 -3
  129. package/run-dist.mjs +34 -0
  130. package/skills/preset-creator/SKILL.md +40 -8
  131. package/skills/preset-creator/references/complex-task-skeleton/brief.md +32 -8
  132. package/skills/preset-creator/references/preset-package-skeleton.md +15 -5
  133. package/skills/preset-creator/references/structure-aware-paths.md +112 -0
  134. package/templates/AGENTS.md.template +28 -26
  135. package/templates/architecture/README.md +2 -2
  136. package/templates/architecture/service-catalog.md +2 -2
  137. package/templates/architecture/services/service-template.md +1 -1
  138. package/templates/dashboard/assets/app-src/00-state.js +5 -1
  139. package/templates/dashboard/assets/app-src/10-router.js +7 -0
  140. package/templates/dashboard/assets/app-src/20-overview.js +8 -8
  141. package/templates/dashboard/assets/app-src/30-tasks.js +132 -40
  142. package/templates/dashboard/assets/app-src/32-task-swimlane.js +314 -0
  143. package/templates/dashboard/assets/app-src/35-task-detail.js +35 -5
  144. package/templates/dashboard/assets/app-src/40-modules.js +257 -41
  145. package/templates/dashboard/assets/app-src/45-review.js +127 -1
  146. package/templates/dashboard/assets/app-src/90-bindings.js +185 -2
  147. package/templates/dashboard/assets/app.css +928 -53
  148. package/templates/dashboard/assets/app.css.manifest.json +2 -0
  149. package/templates/dashboard/assets/app.js +1071 -98
  150. package/templates/dashboard/assets/app.manifest.json +1 -0
  151. package/templates/dashboard/assets/css-src/00-foundation.css +12 -6
  152. package/templates/dashboard/assets/css-src/10-panels-flow.css +2 -2
  153. package/templates/dashboard/assets/css-src/30-task-index.css +21 -13
  154. package/templates/dashboard/assets/css-src/31-archive.css +94 -0
  155. package/templates/dashboard/assets/css-src/32-task-swimlane.css +487 -0
  156. package/templates/dashboard/assets/css-src/35-review-workspace.css +78 -0
  157. package/templates/dashboard/assets/css-src/40-detail-modules-migration.css +191 -14
  158. package/templates/dashboard/assets/css-src/50-responsive-overrides.css +23 -0
  159. package/templates/dashboard/assets/i18n.js +166 -2
  160. package/templates/development/README.md +9 -9
  161. package/templates/development/cross-repo-debugging.md +3 -3
  162. package/templates/development/external-context/service-template.md +1 -1
  163. package/templates/development/external-source-packs/README.md +2 -2
  164. package/templates/integrations/README.md +4 -4
  165. package/templates/integrations/api-contract.md +1 -1
  166. package/templates/integrations/event-contract.md +1 -1
  167. package/templates/integrations/third-party/vendor-template.md +1 -1
  168. package/templates/integrations/webhook-contract.md +1 -1
  169. package/templates/ledger/Harness-Ledger.md +1 -1
  170. package/templates/modules/module_brief.md +50 -0
  171. package/templates/modules/module_plan.md +49 -0
  172. package/templates/modules/registry_view.md +9 -0
  173. package/templates/modules/session_prompt_pack.md +55 -0
  174. package/templates/planning/brief.md +32 -8
  175. package/templates/planning/module_brief.md +28 -3
  176. package/templates/planning/module_plan.md +26 -11
  177. package/templates/planning/module_session_prompt.md +11 -2
  178. package/templates/planning/optional/slices/_slice-template/brief.md +28 -0
  179. package/templates/planning/review.md +1 -1
  180. package/templates/planning/visual_map.md +1 -1
  181. package/templates/reference/docs-library-standard.md +7 -7
  182. package/templates/reference/execution-workflow-standard.md +13 -0
  183. package/templates/reference/external-source-intake-standard.md +10 -10
  184. package/templates/reference/repo-governance-standard.md +1 -1
  185. package/templates/reference/review-routing-standard.md +4 -0
  186. package/templates/ssot/Module-Registry.md +4 -38
  187. package/templates/walkthrough/walkthrough-template.md +1 -1
  188. package/templates-zh-CN/AGENTS.md.template +27 -25
  189. package/templates-zh-CN/CLAUDE.md.template +1 -1
  190. package/templates-zh-CN/architecture/README.md +2 -2
  191. package/templates-zh-CN/architecture/service-catalog.md +2 -2
  192. package/templates-zh-CN/architecture/services/service-template.md +1 -1
  193. package/templates-zh-CN/development/README.md +9 -9
  194. package/templates-zh-CN/development/cross-repo-debugging.md +3 -3
  195. package/templates-zh-CN/development/external-context/service-template.md +1 -1
  196. package/templates-zh-CN/development/external-source-packs/README.md +2 -2
  197. package/templates-zh-CN/integrations/README.md +4 -4
  198. package/templates-zh-CN/integrations/api-contract.md +1 -1
  199. package/templates-zh-CN/integrations/event-contract.md +1 -1
  200. package/templates-zh-CN/integrations/third-party/vendor-template.md +1 -1
  201. package/templates-zh-CN/integrations/webhook-contract.md +1 -1
  202. package/templates-zh-CN/ledger/Harness-Ledger.md +1 -1
  203. package/templates-zh-CN/lessons/lesson-arch-process-change.md +1 -1
  204. package/templates-zh-CN/lessons/lesson-new-doc.md +3 -3
  205. package/templates-zh-CN/lessons/lesson-ref-change.md +4 -4
  206. package/templates-zh-CN/modules/module_brief.md +47 -0
  207. package/templates-zh-CN/modules/module_plan.md +48 -0
  208. package/templates-zh-CN/modules/registry_view.md +9 -0
  209. package/templates-zh-CN/modules/session_prompt_pack.md +50 -0
  210. package/templates-zh-CN/planning/INDEX.md +1 -0
  211. package/templates-zh-CN/planning/brief.md +26 -7
  212. package/templates-zh-CN/planning/module_brief.md +24 -2
  213. package/templates-zh-CN/planning/module_plan.md +35 -29
  214. package/templates-zh-CN/planning/module_session_prompt.md +15 -11
  215. package/templates-zh-CN/planning/optional/slices/_slice-template/brief.md +28 -11
  216. package/templates-zh-CN/planning/review.md +1 -1
  217. package/templates-zh-CN/reference/adversarial-review-standard.md +1 -1
  218. package/templates-zh-CN/reference/delivery-operating-model-standard.md +3 -3
  219. package/templates-zh-CN/reference/docs-library-standard.md +27 -27
  220. package/templates-zh-CN/reference/execution-workflow-standard.md +12 -2
  221. package/templates-zh-CN/reference/external-source-intake-standard.md +10 -10
  222. package/templates-zh-CN/reference/harness-ledger-standard.md +3 -3
  223. package/templates-zh-CN/reference/regression-ssot-governance.md +2 -2
  224. package/templates-zh-CN/reference/repo-governance-standard.md +1 -1
  225. package/templates-zh-CN/reference/review-routing-standard.md +3 -0
  226. package/templates-zh-CN/reference/walkthrough-standard.md +2 -2
  227. package/templates-zh-CN/reference/worktree-standard.md +1 -1
  228. package/templates-zh-CN/regression/Cadence-Ledger.md +2 -2
  229. package/templates-zh-CN/ssot/Delivery-SSoT.md +2 -2
  230. package/templates-zh-CN/ssot/Module-Registry.md +5 -44
  231. package/templates-zh-CN/ssot/Regression-SSoT.md +2 -2
  232. package/templates-zh-CN/walkthrough/walkthrough-template.md +4 -4
@@ -0,0 +1,314 @@
1
+ const swimlaneStageOrder = [
2
+ ["planned", "swimlaneStagePlanned"],
3
+ ["in_progress", "swimlaneStageInProgress"],
4
+ ["evidence", "swimlaneStageEvidence"],
5
+ ["review", "swimlaneStageReview"],
6
+ ["confirmed", "swimlaneStageConfirmed"],
7
+ ["closeout", "swimlaneStageCloseout"],
8
+ ["blocked", "swimlaneStageBlocked"],
9
+ ];
10
+ const swimlaneCellPageSize = 10;
11
+ const swimlaneMiniColumnLimit = 5;
12
+
13
+ function taskSwimlaneModel(tasks) {
14
+ const cards = sortTasksByTime(tasks)
15
+ .filter((task) => taskVisibleInSwimlane(task))
16
+ .map((task) => {
17
+ const lane = taskModuleKey(task);
18
+ const stage = taskSwimlaneStage(task);
19
+ return {
20
+ task,
21
+ lane,
22
+ stage,
23
+ id: task.id,
24
+ title: task.title,
25
+ reason: taskSwimlaneReason(task),
26
+ };
27
+ });
28
+ const laneKeys = [...new Set(cards.map((card) => card.lane))].sort((left, right) => {
29
+ if (left === "legacy-unclassified") return 1;
30
+ if (right === "legacy-unclassified") return -1;
31
+ return left.localeCompare(right);
32
+ });
33
+ return {
34
+ stages: swimlaneStageOrder.map(([key, labelKey]) => ({ key, label: t(labelKey) })),
35
+ lanes: laneKeys.map((key) => ({ key, label: taskModuleDisplayLabel(key) })),
36
+ cards,
37
+ };
38
+ }
39
+
40
+ function taskVisibleInSwimlane(task) {
41
+ const stateValue = String(task.state || "");
42
+ const closeout = String(task.closeoutStatus || "");
43
+ if (["done", "closed", "finalized"].includes(stateValue)) return false;
44
+ if (["closed", "finalized"].includes(closeout)) return false;
45
+ if (clampCompletion(task.completion) >= 100 && !["review", "blocked", "reopened", "current-evidence"].includes(stateValue)) return false;
46
+ return ["active", "planned", "not_started", "in_progress", "review", "blocked", "reopened", "current-evidence"].includes(stateValue)
47
+ || ["ready-to-confirm", "needs-material", "review-blocked"].includes(String(task.reviewQueueState || ""))
48
+ || ["agent-reviewed", "confirmed", "blocked-open-findings"].includes(String(task.reviewStatus || ""));
49
+ }
50
+
51
+ function taskSwimlaneStage(task) {
52
+ const stateValue = String(task.state || "");
53
+ const review = String(task.reviewStatus || "");
54
+ const reviewQueue = String(task.reviewQueueState || "");
55
+ const closeout = String(task.closeoutStatus || "");
56
+ if (stateValue === "blocked" || review.includes("blocked") || reviewQueue.includes("blocked")) return "blocked";
57
+ if (review === "confirmed" && taskHasPendingLessonWork(task)) return "closeout";
58
+ if (review === "confirmed" && ["missing", "pending", "required", "closing"].includes(closeout)) return "closeout";
59
+ if (review === "confirmed") return "confirmed";
60
+ if (stateValue === "review" || reviewQueue === "ready-to-confirm" || (task.taskQueues || []).includes("review") || ["agent-reviewed", "in_review"].includes(review)) return "review";
61
+ if (["planned", "not_started"].includes(stateValue)) return "planned";
62
+ if (taskNeedsEvidence(task)) return "evidence";
63
+ if (["active", "in_progress", "reopened", "current-evidence"].includes(stateValue)) return "in_progress";
64
+ return "planned";
65
+ }
66
+
67
+ function taskNeedsEvidence(task) {
68
+ if (["missing", "legacy-only"].includes(String(task.visualMapStatus || ""))) return true;
69
+ if (task.briefSource && task.briefSource !== "standalone") return true;
70
+ return (task.phases || []).some((phase) => ["missing", "partial"].includes(String(phase.evidenceStatus || "")));
71
+ }
72
+
73
+ function taskSwimlaneReason(task) {
74
+ const reasons = Array.isArray(task.queueReasons) ? task.queueReasons.filter(Boolean) : [];
75
+ if (reasons.length) return reasons[0];
76
+ if (taskNeedsEvidence(task)) return t("swimlaneNeedsEvidence");
77
+ if (task.reviewQueueState === "ready-to-confirm") return t("swimlaneReadyToConfirm");
78
+ if (task.closeoutStatus === "missing") return t("swimlaneNeedsCloseout");
79
+ return "";
80
+ }
81
+
82
+ function taskSwimlane(tasks) {
83
+ const model = taskSwimlaneModel(tasks);
84
+ if (!model.cards.length) return `<section class="task-swimlane empty-state">${escapeHtml(t("swimlaneEmpty"))}</section>`;
85
+ const view = taskSwimlaneHeatmapModel(model);
86
+ const active = taskSwimlaneActiveExpansion(view);
87
+ return `<section class="task-swimlane" aria-label="${escapeAttr(t("layoutSwimlane"))}">
88
+ <div class="swimlane-header">
89
+ <div>
90
+ <p class="eyebrow">${t("swimlaneEyebrow")}</p>
91
+ <h2>${t("swimlaneTitle")}</h2>
92
+ </div>
93
+ <span class="subtle">${model.cards.length} · ${t("tasks")}</span>
94
+ </div>
95
+ ${taskSwimlaneHeatmap(view, active)}
96
+ ${taskSwimlaneMobileList(view, active)}
97
+ ${taskSwimlaneDrilldown(view, active)}
98
+ </section>`;
99
+ }
100
+
101
+ function taskSwimlaneHeatmapModel(model) {
102
+ const stageTotals = Object.fromEntries(model.stages.map((stage) => [stage.key, 0]));
103
+ const lanes = taskSwimlaneRenderLanes(model).map((lane) => {
104
+ const stageCards = Object.fromEntries(model.stages.map((stage) => [stage.key, []]));
105
+ for (const card of model.cards) {
106
+ if (card.lane !== lane.key) continue;
107
+ stageCards[card.stage] = stageCards[card.stage] || [];
108
+ stageCards[card.stage].push(card);
109
+ stageTotals[card.stage] = (stageTotals[card.stage] || 0) + 1;
110
+ }
111
+ const total = Object.values(stageCards).reduce((sum, cards) => sum + cards.length, 0);
112
+ return { ...lane, total, stageCards };
113
+ }).sort((left, right) => {
114
+ if (left.key === "legacy-unclassified") return 1;
115
+ if (right.key === "legacy-unclassified") return -1;
116
+ const totalDiff = right.total - left.total;
117
+ return totalDiff || left.label.localeCompare(right.label);
118
+ });
119
+ const total = model.cards.length;
120
+ const columnTemplate = model.stages.map((stage) => {
121
+ const count = stageTotals[stage.key] || 0;
122
+ if (count === 0) return "minmax(44px, 0.36fr)";
123
+ if (count <= 3) return "minmax(74px, 0.7fr)";
124
+ if (count <= 7) return "minmax(88px, 1fr)";
125
+ return "minmax(104px, 1.16fr)";
126
+ }).join(" ");
127
+ return { stages: model.stages, lanes, stageTotals, total, columnTemplate };
128
+ }
129
+
130
+ function taskSwimlaneRenderLanes(model) {
131
+ const lanes = new Map(model.lanes.map((lane) => [lane.key, { ...lane }]));
132
+ const modules = typeof dashboardModules === "function" ? dashboardModules() : [];
133
+ for (const module of modules) {
134
+ const key = String(module.key || "").trim();
135
+ if (!key || key === "legacy-unclassified") continue;
136
+ const label = key === "base" ? taskModuleDisplayLabel(key) : String(module.title || taskModuleDisplayLabel(key) || key);
137
+ lanes.set(key, { ...(lanes.get(key) || { key }), key, label });
138
+ }
139
+ return [...lanes.values()];
140
+ }
141
+
142
+ function taskSwimlaneHeatmap(view, active) {
143
+ const style = `--swimlane-stage-columns: ${escapeAttr(view.columnTemplate)}`;
144
+ return `<div class="swimlane-heatmap" data-swimlane-heatmap="true" style="${style}" aria-label="${escapeAttr(t("swimlaneHeatmapLabel"))}">
145
+ <div class="swimlane-heatmap-row swimlane-heatmap-head">
146
+ <div class="swimlane-axis-label">${escapeHtml(t("swimlaneModuleColumn"))}</div>
147
+ ${view.stages.map((stage) => {
148
+ const total = view.stageTotals[stage.key] || 0;
149
+ return `<div class="swimlane-stage-header" data-swimlane-stage-total="${escapeAttr(stage.key)}" data-total="${total}">
150
+ <span>${escapeHtml(stage.label)}</span>
151
+ <strong>${total}</strong>
152
+ </div>`;
153
+ }).join("")}
154
+ <div class="swimlane-total-header">${escapeHtml(t("swimlaneTotalColumn"))}</div>
155
+ </div>
156
+ ${view.lanes.map((lane) => taskSwimlaneHeatmapRow(lane, view, active)).join("")}
157
+ </div>`;
158
+ }
159
+
160
+ function taskSwimlaneHeatmapRow(lane, view, active) {
161
+ const laneActive = active?.mode === "lane" && active.lane === lane.key;
162
+ return `<div class="swimlane-heatmap-row" data-swimlane-row="${escapeAttr(lane.key)}" data-swimlane-row-total="${lane.total}">
163
+ <button class="swimlane-lane-button ${laneActive ? "active" : ""}" type="button" data-swimlane-expand="lane" data-lane="${escapeAttr(lane.key)}" aria-expanded="${laneActive ? "true" : "false"}" aria-controls="swimlane-drilldown-panel">
164
+ <strong>${escapeHtml(lane.label)}</strong>
165
+ <span>${lane.total}</span>
166
+ </button>
167
+ ${view.stages.map((stage) => taskSwimlaneHeatmapCell(lane, stage, active)).join("")}
168
+ <div class="swimlane-row-total"><strong>${lane.total}</strong></div>
169
+ </div>`;
170
+ }
171
+
172
+ function taskSwimlaneHeatmapCell(lane, stage, active) {
173
+ const cards = lane.stageCards[stage.key] || [];
174
+ const count = cards.length;
175
+ const cellActive = active?.mode === "cell" && active.lane === lane.key && active.stage === stage.key;
176
+ const disabled = count === 0 ? " disabled" : "";
177
+ const label = `${lane.label} · ${stage.label} · ${count} ${t("tasks")}`;
178
+ return `<button class="swimlane-heat-cell heat-${taskSwimlaneHeatLevel(count)} ${cellActive ? "active" : ""}" type="button" data-swimlane-expand="cell" data-lane="${escapeAttr(lane.key)}" data-swimlane-stage="${escapeAttr(stage.key)}" data-count="${count}" aria-label="${escapeAttr(label)}" aria-expanded="${cellActive ? "true" : "false"}" aria-controls="swimlane-drilldown-panel"${disabled}>
179
+ <span>${count}</span>
180
+ </button>`;
181
+ }
182
+
183
+ function taskSwimlaneMobileList(view, active) {
184
+ return `<div class="swimlane-mobile-list" aria-label="${escapeAttr(t("swimlaneHeatmapLabel"))}">
185
+ ${view.lanes.map((lane) => {
186
+ const laneActive = active?.mode === "lane" && active.lane === lane.key;
187
+ return `<button class="swimlane-mobile-module ${laneActive ? "active" : ""}" type="button" data-swimlane-expand="lane" data-lane="${escapeAttr(lane.key)}" aria-expanded="${laneActive ? "true" : "false"}" aria-controls="swimlane-drilldown-panel">
188
+ <span><strong>${escapeHtml(lane.label)}</strong><small>${lane.total} · ${t("tasks")}</small></span>
189
+ <span class="swimlane-mobile-stages">${view.stages.map((stage) => {
190
+ const count = (lane.stageCards[stage.key] || []).length;
191
+ return count ? `<em>${escapeHtml(stage.label)} ${count}</em>` : "";
192
+ }).join("")}</span>
193
+ </button>`;
194
+ }).join("")}
195
+ </div>`;
196
+ }
197
+
198
+ function taskSwimlaneDrilldown(view, active) {
199
+ if (!active) return `<div class="swimlane-drilldown-host" data-swimlane-drilldown-host="true"></div>`;
200
+ const lane = view.lanes.find((candidate) => candidate.key === active.lane);
201
+ if (!lane) return `<div class="swimlane-drilldown-host" data-swimlane-drilldown-host="true"></div>`;
202
+ const cards = active.mode === "cell" ? (lane.stageCards[active.stage] || []) : Object.values(lane.stageCards).flat();
203
+ const title = active.mode === "cell"
204
+ ? `${lane.label} · ${view.stages.find((stage) => stage.key === active.stage)?.label || active.stage}`
205
+ : lane.label;
206
+ return `<div class="swimlane-drilldown-host open" data-swimlane-drilldown-host="true">
207
+ <section class="swimlane-drilldown" id="swimlane-drilldown-panel" aria-label="${escapeAttr(t("swimlaneDrilldownLabel"))}">
208
+ <div class="swimlane-drilldown-head">
209
+ <div>
210
+ <p class="eyebrow">${escapeHtml(t("swimlaneDrilldownLabel"))}</p>
211
+ <h3>${escapeHtml(title)}</h3>
212
+ </div>
213
+ <div class="swimlane-drilldown-actions">
214
+ <span>${cards.length} · ${t("tasks")}</span>
215
+ <button type="button" data-swimlane-collapse>${escapeHtml(t("swimlaneCollapse"))}</button>
216
+ </div>
217
+ </div>
218
+ ${active.mode === "lane" ? taskSwimlaneLaneBoard(lane, view.stages) : taskSwimlanePagedCardList(cards, active.page || 0)}
219
+ </section>
220
+ </div>`;
221
+ }
222
+
223
+ function taskSwimlaneLaneBoard(lane, stages) {
224
+ return `<div class="swimlane-mini-board">
225
+ ${stages.map((stage) => {
226
+ const cards = lane.stageCards[stage.key] || [];
227
+ const visibleCards = cards.slice(0, swimlaneMiniColumnLimit);
228
+ const hidden = Math.max(0, cards.length - visibleCards.length);
229
+ return `<div class="swimlane-mini-column">
230
+ <div class="swimlane-mini-column-head"><span>${escapeHtml(stage.label)}</span><strong>${cards.length}</strong></div>
231
+ <div class="swimlane-card-list">${visibleCards.map((card) => taskSwimlaneCard(card)).join("") || `<span class="swimlane-mini-empty">${escapeHtml(t("none"))}</span>`}</div>
232
+ ${hidden ? `<button class="swimlane-stage-drilldown" type="button" data-swimlane-expand="cell" data-swimlane-stage-drilldown="${escapeAttr(stage.key)}" data-lane="${escapeAttr(lane.key)}" data-swimlane-stage="${escapeAttr(stage.key)}">
233
+ <span>+${hidden}</span>
234
+ <strong>${escapeHtml(t("swimlaneViewStage"))}</strong>
235
+ </button>` : ""}
236
+ </div>`;
237
+ }).join("")}
238
+ </div>`;
239
+ }
240
+
241
+ function taskSwimlanePagedCardList(cards, page) {
242
+ const total = cards.length;
243
+ const pageCount = Math.max(1, Math.ceil(total / swimlaneCellPageSize));
244
+ const safePage = Math.max(0, Math.min(pageCount - 1, Number(page) || 0));
245
+ const start = safePage * swimlaneCellPageSize;
246
+ const end = Math.min(total, start + swimlaneCellPageSize);
247
+ const visibleCards = cards.slice(start, end);
248
+ return `<div class="swimlane-paged-list">
249
+ <div class="swimlane-card-list">${visibleCards.map((card) => taskSwimlaneCard(card)).join("")}</div>
250
+ ${total > swimlaneCellPageSize ? `<div class="swimlane-pager" data-swimlane-page="${safePage}" aria-label="${escapeAttr(t("swimlanePageLabel"))}">
251
+ <button type="button" data-swimlane-page-action="prev" data-page="${safePage - 1}" ${safePage <= 0 ? "disabled" : ""}>${escapeHtml(t("swimlanePrevPage"))}</button>
252
+ <span>${start + 1}-${end} / ${total}</span>
253
+ <button type="button" data-swimlane-page-action="next" data-page="${safePage + 1}" ${safePage >= pageCount - 1 ? "disabled" : ""}>${escapeHtml(t("swimlaneNextPage"))}</button>
254
+ </div>` : ""}
255
+ </div>`;
256
+ }
257
+
258
+ function taskSwimlaneCard(card) {
259
+ const task = card.task;
260
+ const completion = clampCompletion(task.completion);
261
+ return `<article class="swimlane-card ${escapeAttr(card.stage)}" data-open-drawer="${escapeAttr(task.id)}" style="--row-accent: var(${stateToColorVar(task.state)}); --task-progress: ${completion}%">
262
+ <span class="swimlane-status-dot" aria-hidden="true"></span>
263
+ <strong>${escapeHtml(task.title)}</strong>
264
+ <span class="swimlane-progress" aria-label="${completion}%"><i></i></span>
265
+ </article>`;
266
+ }
267
+
268
+ function taskSwimlaneHeatLevel(count) {
269
+ if (count <= 0) return 0;
270
+ if (count <= 3) return 1;
271
+ if (count <= 7) return 2;
272
+ return 3;
273
+ }
274
+
275
+ function taskSwimlaneActiveExpansion(view) {
276
+ if (!swimlaneExpansion) return null;
277
+ const lane = view.lanes.find((candidate) => candidate.key === swimlaneExpansion.lane);
278
+ if (!lane) return null;
279
+ if (swimlaneExpansion.mode === "cell" && !view.stages.some((stage) => stage.key === swimlaneExpansion.stage)) return null;
280
+ if (swimlaneExpansion.mode !== "cell") return swimlaneExpansion;
281
+ const count = (lane.stageCards[swimlaneExpansion.stage] || []).length;
282
+ const pageCount = Math.max(1, Math.ceil(count / swimlaneCellPageSize));
283
+ const page = Math.max(0, Math.min(pageCount - 1, Number(swimlaneExpansion.page) || 0));
284
+ return { ...swimlaneExpansion, page };
285
+ }
286
+
287
+ let swimlaneExpansion = null;
288
+
289
+ if (typeof window !== "undefined" && typeof document !== "undefined" && typeof document.addEventListener === "function" && !window.__HARNESS_SWIMLANE_BOUND__) {
290
+ window.__HARNESS_SWIMLANE_BOUND__ = true;
291
+ document.addEventListener("click", (event) => {
292
+ const collapse = event.target.closest?.("[data-swimlane-collapse]");
293
+ const pager = event.target.closest?.("[data-swimlane-page-action]");
294
+ const trigger = event.target.closest?.("[data-swimlane-expand]");
295
+ if (!collapse && !pager && !trigger) return;
296
+ event.preventDefault();
297
+ if (collapse) {
298
+ swimlaneExpansion = null;
299
+ app();
300
+ return;
301
+ }
302
+ if (pager && swimlaneExpansion?.mode === "cell") {
303
+ swimlaneExpansion = { ...swimlaneExpansion, page: Number(pager.dataset.page) || 0 };
304
+ app();
305
+ return;
306
+ }
307
+ const mode = trigger.dataset.swimlaneExpand;
308
+ const lane = trigger.dataset.lane;
309
+ const stage = trigger.dataset.swimlaneStage || "";
310
+ const same = swimlaneExpansion?.mode === mode && swimlaneExpansion?.lane === lane && (swimlaneExpansion?.stage || "") === stage;
311
+ swimlaneExpansion = same ? null : { mode, lane, stage, page: 0 };
312
+ app();
313
+ });
314
+ }
@@ -226,26 +226,41 @@ function reviewActionPanel(task, { mode = "summary" } = {}) {
226
226
  if (!isTaskInReviewQueue(task)) return "";
227
227
  const blocking = task.reviewStatus === "blocked-open-findings" || (task.risks || []).some((risk) => /^P[0-2]$/i.test(risk.severity || "") && (risk.open || risk.blocksRelease));
228
228
  const confirmed = task.reviewStatus === "confirmed";
229
+ const readyForCloseout = taskReadyForCloseout(task);
230
+ const hasLessonWork = taskHasPendingLessonWork(task);
229
231
  const candidateBlocked = task.budget !== "simple" && !task.lessonCandidateDecisionComplete;
230
232
  const candidateStatus = task.lessonCandidateStatus || "missing";
231
233
  if (mode !== "workspace") {
234
+ const summaryMessage = confirmed && hasLessonWork ? t("reviewConfirmedLessonPending") : confirmed && readyForCloseout ? t("reviewConfirmedCloseoutReady") : confirmed ? t("reviewAlreadyConfirmed") : t("reviewOpenInWorkspace");
232
235
  return `<section class="side-panel review-actions">
233
236
  <h3>${t("reviewActions")}</h3>
234
- <p>${escapeHtml(confirmed ? t("reviewAlreadyConfirmed") : t("reviewOpenInWorkspace"))}</p>
237
+ <p>${escapeHtml(summaryMessage)}</p>
235
238
  <p>${escapeHtml(t("lessonCandidateStatus"))}: ${tag(candidateStatus)}</p>
236
239
  <a href="#/review/${encodeURIComponent(task.id)}">${t("openReviewWorkspace")}</a>
237
240
  </section>`;
238
241
  }
239
- if (!canUseWorkbenchAction("review-complete")) {
242
+ if (confirmed) {
243
+ if (hasLessonWork) {
244
+ return `<section class="side-panel review-actions">
245
+ <h3>${t("reviewActions")}</h3>
246
+ <p>${escapeHtml(t("reviewConfirmedLessonPending"))}</p>
247
+ <p>${escapeHtml(t("lessonCandidateStatus"))}: ${tag(candidateStatus)}</p>
248
+ ${lessonCandidatePanel(task, { context: "detail", limit: 3 })}
249
+ </section>`;
250
+ }
251
+ const closeoutDisabled = !readyForCloseout || !canUseWorkbenchAction("task-complete");
240
252
  return `<section class="side-panel review-actions">
241
253
  <h3>${t("reviewActions")}</h3>
242
- <p>${escapeHtml(t("staticReadOnlyDetail"))}</p>
254
+ <p>${escapeHtml(readyForCloseout ? t("reviewConfirmedCloseoutReady") : t("reviewAlreadyConfirmed"))}</p>
255
+ <p>${escapeHtml(t("lessonCandidateStatus"))}: ${tag(candidateStatus)}</p>
256
+ <button data-task-complete="${escapeAttr(task.id)}" ${closeoutDisabled ? "disabled" : ""}>${t("completeTaskCloseout")}</button>
257
+ <div class="review-result" data-task-complete-result="${escapeAttr(task.id)}"></div>
243
258
  </section>`;
244
259
  }
245
- if (confirmed) {
260
+ if (!canUseWorkbenchAction("review-complete")) {
246
261
  return `<section class="side-panel review-actions">
247
262
  <h3>${t("reviewActions")}</h3>
248
- <p>${escapeHtml(t("reviewAlreadyConfirmed"))}</p>
263
+ <p>${escapeHtml(t("staticReadOnlyDetail"))}</p>
249
264
  </section>`;
250
265
  }
251
266
  const missingWalkthrough = task.budget !== "simple" && !task.walkthroughPath;
@@ -277,6 +292,21 @@ function taskCanBeHumanConfirmed(task) {
277
292
  return task?.reviewQueueState === "ready-to-confirm" && Array.isArray(task?.taskQueues) && task.taskQueues.includes("review");
278
293
  }
279
294
 
295
+ function taskHasPendingLessonWork(task) {
296
+ const queues = Array.isArray(task?.taskQueues) ? task.taskQueues : [];
297
+ const candidates = Array.isArray(task?.lessonCandidateRows) ? task.lessonCandidateRows : [];
298
+ return queues.includes("lessons")
299
+ || task?.lessonCandidateStatus === "needs-promotion"
300
+ || task?.lessonCandidatePromotionState === "queued"
301
+ || candidates.some((candidate) => ["ready-for-review", "needs-promotion"].includes(String(candidate?.status || "")));
302
+ }
303
+
304
+ function taskReadyForCloseout(task) {
305
+ if (!task || task.reviewStatus !== "confirmed" || task.closeoutStatus === "closed") return false;
306
+ if (taskHasPendingLessonWork(task)) return false;
307
+ return ["no-candidate-accepted", "promoted", "rejected"].includes(String(task.lessonCandidateStatus || ""));
308
+ }
309
+
280
310
  function evidenceList(task) {
281
311
  const evidence = task.evidence || [];
282
312
  return `<section class="side-panel">