cloving 1.0.1 → 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 (177) hide show
  1. package/README.md +145 -14
  2. package/dist/src/authority/commands.js +10 -2
  3. package/dist/src/authority/reconciliation.d.ts +2 -0
  4. package/dist/src/authority/reconciliation.js +10 -1
  5. package/dist/src/authority/transitions.d.ts +1 -1
  6. package/dist/src/authority/transitions.js +2 -0
  7. package/dist/src/broker/actor/authority-session.d.ts +2 -0
  8. package/dist/src/broker/actor/authority-session.js +3 -4
  9. package/dist/src/chats/analysis-batches.d.ts +24 -0
  10. package/dist/src/chats/analysis-batches.js +83 -0
  11. package/dist/src/chats/analysis-contract.d.ts +80 -0
  12. package/dist/src/chats/analysis-contract.js +16 -0
  13. package/dist/src/chats/analysis-data.d.ts +3 -0
  14. package/dist/src/chats/analysis-data.js +85 -0
  15. package/dist/src/chats/analysis-input.d.ts +12 -0
  16. package/dist/src/chats/analysis-input.js +83 -0
  17. package/dist/src/chats/analysis-links.d.ts +2 -0
  18. package/dist/src/chats/analysis-links.js +25 -0
  19. package/dist/src/chats/analysis-prompt.d.ts +10 -0
  20. package/dist/src/chats/analysis-prompt.js +16 -0
  21. package/dist/src/chats/analysis-proposal.d.ts +2 -0
  22. package/dist/src/chats/analysis-proposal.js +32 -0
  23. package/dist/src/chats/analysis-provenance.d.ts +4 -0
  24. package/dist/src/chats/analysis-provenance.js +99 -0
  25. package/dist/src/chats/analysis-shape.d.ts +3 -0
  26. package/dist/src/chats/analysis-shape.js +228 -0
  27. package/dist/src/chats/analysis.d.ts +3 -0
  28. package/dist/src/chats/analysis.js +42 -0
  29. package/dist/src/chats/corpus-input.d.ts +5 -0
  30. package/dist/src/chats/corpus-input.js +288 -0
  31. package/dist/src/chats/destination.js +3 -1
  32. package/dist/src/chats/import.d.ts +8 -6
  33. package/dist/src/chats/import.js +195 -23
  34. package/dist/src/chats/input-file.d.ts +3 -0
  35. package/dist/src/chats/input-file.js +32 -0
  36. package/dist/src/chats/normalize.d.ts +11 -2
  37. package/dist/src/chats/normalize.js +18 -2
  38. package/dist/src/chats/previous-import.d.ts +5 -0
  39. package/dist/src/chats/previous-import.js +34 -0
  40. package/dist/src/chats/reader.d.ts +7 -1
  41. package/dist/src/chats/reader.js +46 -15
  42. package/dist/src/chats/redact-import.d.ts +14 -0
  43. package/dist/src/chats/redact-import.js +141 -0
  44. package/dist/src/chats/redaction.d.ts +41 -0
  45. package/dist/src/chats/redaction.js +161 -0
  46. package/dist/src/chats/revision-input.d.ts +3 -0
  47. package/dist/src/chats/revision-input.js +180 -0
  48. package/dist/src/chats/revision.d.ts +48 -0
  49. package/dist/src/chats/revision.js +94 -0
  50. package/dist/src/chats/selection.d.ts +25 -0
  51. package/dist/src/chats/selection.js +109 -0
  52. package/dist/src/chats/source.d.ts +23 -0
  53. package/dist/src/chats/source.js +135 -0
  54. package/dist/src/chats/structure.d.ts +57 -0
  55. package/dist/src/chats/structure.js +216 -0
  56. package/dist/src/cli/arguments.d.ts +8 -0
  57. package/dist/src/cli/arguments.js +94 -13
  58. package/dist/src/cli/client.d.ts +1 -0
  59. package/dist/src/cli/client.js +38 -1
  60. package/dist/src/cli/commands.d.ts +3 -0
  61. package/dist/src/cli/commands.js +29 -11
  62. package/dist/src/cli/main.d.ts +2 -1
  63. package/dist/src/cli/main.js +61 -14
  64. package/dist/src/cli/render.d.ts +2 -0
  65. package/dist/src/cli/render.js +70 -2
  66. package/dist/src/cli/usage-render.d.ts +3 -0
  67. package/dist/src/cli/usage-render.js +28 -0
  68. package/dist/src/cli/usage.d.ts +3 -2
  69. package/dist/src/cli/usage.js +38 -6
  70. package/dist/src/cli/watch-actions.d.ts +10 -0
  71. package/dist/src/cli/watch-actions.js +58 -0
  72. package/dist/src/cli/watch-board-view.d.ts +32 -0
  73. package/dist/src/cli/watch-board-view.js +88 -15
  74. package/dist/src/cli/watch-board.js +6 -1
  75. package/dist/src/cli/watch-card-client.d.ts +1 -0
  76. package/dist/src/cli/watch-card-client.js +44 -0
  77. package/dist/src/cli/watch-card-forms.d.ts +2 -0
  78. package/dist/src/cli/watch-card-forms.js +33 -0
  79. package/dist/src/cli/watch-card-reply.d.ts +5 -0
  80. package/dist/src/cli/watch-card-reply.js +34 -0
  81. package/dist/src/cli/watch-card-view.d.ts +40 -0
  82. package/dist/src/cli/watch-card-view.js +86 -0
  83. package/dist/src/cli/watch-client.d.ts +1 -0
  84. package/dist/src/cli/watch-client.js +118 -0
  85. package/dist/src/cli/watch-model.js +31 -14
  86. package/dist/src/cli/watch-page.d.ts +1 -1
  87. package/dist/src/cli/watch-page.js +71 -85
  88. package/dist/src/cli/watch-pr-board.d.ts +3 -0
  89. package/dist/src/cli/watch-pr-board.js +26 -0
  90. package/dist/src/cli/watch-pr-command.d.ts +15 -0
  91. package/dist/src/cli/watch-pr-command.js +37 -0
  92. package/dist/src/cli/watch-pr-identity.d.ts +20 -0
  93. package/dist/src/cli/watch-pr-identity.js +62 -0
  94. package/dist/src/cli/watch-pr-observer.d.ts +19 -0
  95. package/dist/src/cli/watch-pr-observer.js +108 -0
  96. package/dist/src/cli/watch-pr-settings.d.ts +8 -0
  97. package/dist/src/cli/watch-pr-settings.js +47 -0
  98. package/dist/src/cli/watch-reads.js +4 -0
  99. package/dist/src/cli/watch-render.d.ts +16 -2
  100. package/dist/src/cli/watch-render.js +10 -3
  101. package/dist/src/cli/watch-run-input.d.ts +14 -0
  102. package/dist/src/cli/watch-run-input.js +49 -0
  103. package/dist/src/cli/watch-server.d.ts +3 -0
  104. package/dist/src/cli/watch-server.js +44 -6
  105. package/dist/src/cli/watch-start-view.d.ts +18 -0
  106. package/dist/src/cli/watch-start-view.js +77 -0
  107. package/dist/src/cli/watch-turn.d.ts +1 -0
  108. package/dist/src/cli/watch-turn.js +7 -2
  109. package/dist/src/cli/watch-usage.d.ts +6 -0
  110. package/dist/src/cli/watch-usage.js +65 -0
  111. package/dist/src/cli/watch-view.d.ts +15 -0
  112. package/dist/src/cli/watch-view.js +61 -17
  113. package/dist/src/cli.js +48 -6
  114. package/dist/src/daemon/analysis-launch.d.ts +5 -0
  115. package/dist/src/daemon/analysis-launch.js +81 -0
  116. package/dist/src/daemon/analysis-token.d.ts +6 -0
  117. package/dist/src/daemon/analysis-token.js +88 -0
  118. package/dist/src/daemon/analysis-worker.d.ts +22 -0
  119. package/dist/src/daemon/analysis-worker.js +219 -0
  120. package/dist/src/daemon/chats-files.d.ts +15 -0
  121. package/dist/src/daemon/chats-files.js +113 -0
  122. package/dist/src/daemon/chats-worker.d.ts +12 -0
  123. package/dist/src/daemon/chats-worker.js +200 -0
  124. package/dist/src/daemon/claude-turn.d.ts +10 -0
  125. package/dist/src/daemon/claude-turn.js +96 -15
  126. package/dist/src/daemon/claude-worker.d.ts +4 -1
  127. package/dist/src/daemon/claude-worker.js +99 -47
  128. package/dist/src/daemon/codex-stream.js +16 -0
  129. package/dist/src/daemon/daemon.d.ts +3 -0
  130. package/dist/src/daemon/daemon.js +16 -7
  131. package/dist/src/daemon/github-methods.js +4 -0
  132. package/dist/src/daemon/github-ticket-status.d.ts +3 -0
  133. package/dist/src/daemon/github-ticket-status.js +268 -0
  134. package/dist/src/daemon/issue-queue.d.ts +1 -0
  135. package/dist/src/daemon/issue-queue.js +115 -24
  136. package/dist/src/daemon/operation-journal.d.ts +1 -0
  137. package/dist/src/daemon/operation-journal.js +4 -2
  138. package/dist/src/daemon/retrying-turn.d.ts +9 -0
  139. package/dist/src/daemon/retrying-turn.js +185 -0
  140. package/dist/src/host/world-reconciliation.d.ts +2 -0
  141. package/dist/src/host/world-reconciliation.js +6 -0
  142. package/dist/src/host/world-runs.js +9 -1
  143. package/dist/src/service/run-handlers.js +15 -23
  144. package/dist/src/service/worker-totals.d.ts +3 -0
  145. package/dist/src/service/worker-totals.js +28 -0
  146. package/dist/src/ticket-status.d.ts +8 -0
  147. package/dist/src/ticket-status.js +45 -0
  148. package/dist/src/token-prices.d.ts +19 -0
  149. package/dist/src/token-prices.js +76 -0
  150. package/dist/src/worker-usage.d.ts +22 -0
  151. package/dist/src/worker-usage.js +44 -0
  152. package/dist/src/workflow-candidate.d.ts +29 -0
  153. package/dist/src/workflow-candidate.js +59 -0
  154. package/dist/src/workflow-contracts.d.ts +2 -0
  155. package/dist/src/workflow-contracts.js +27 -5
  156. package/dist/src/workflow-declaration.d.ts +1 -1
  157. package/dist/src/workflow-declaration.js +3 -1
  158. package/dist/src/workflows.d.ts +1 -0
  159. package/dist/src/workflows.js +1 -0
  160. package/dist/tools/self-host-processes.js +7 -2
  161. package/dist/tools/self-host-workflows.d.ts +1 -1
  162. package/dist/tools/self-host-workflows.js +2 -2
  163. package/dist/tools/self-host.js +6 -6
  164. package/dist/tools/self-update-host.d.ts +7 -0
  165. package/dist/tools/self-update-host.js +48 -1
  166. package/dist/tools/self-update.d.ts +1 -0
  167. package/dist/tools/self-update.js +85 -13
  168. package/dist/workflows/analyze-chats.d.ts +10 -0
  169. package/dist/workflows/analyze-chats.declaration.json +9 -0
  170. package/dist/workflows/analyze-chats.js +73 -0
  171. package/dist/workflows/develop-ticket.d.ts +1 -7
  172. package/dist/workflows/develop-ticket.js +42 -141
  173. package/dist/workflows/issue-labels.d.ts +3 -1
  174. package/dist/workflows/issue-labels.js +34 -0
  175. package/dist/workflows/ticket-prompts.d.ts +35 -0
  176. package/dist/workflows/ticket-prompts.js +133 -0
  177. package/package.json +5 -3
@@ -1,5 +1,22 @@
1
+ import { AddCard } from "./watch-card-view.js";
2
+ import { priceText } from "./usage-render.js";
1
3
  import { component, element } from "./watch-element.js";
2
4
  import { watchHash } from "./watch-navigation.js";
5
+ export const boardSizing = {
6
+ minimumColumnWidth: 200,
7
+ collapsedColumnWidth: 44,
8
+ gap: 12,
9
+ };
10
+ export function boardLayout(input) {
11
+ const { contentWidth, openColumns, collapsedColumns } = input;
12
+ const fixedWidth = collapsedColumns * boardSizing.collapsedColumnWidth +
13
+ Math.max(0, openColumns + collapsedColumns - 1) * boardSizing.gap;
14
+ const columnWidth = Math.max(boardSizing.minimumColumnWidth, (contentWidth - fixedWidth) / Math.max(1, openColumns));
15
+ return {
16
+ columnWidth: openColumns === 0 ? boardSizing.minimumColumnWidth : columnWidth,
17
+ totalWidth: openColumns * columnWidth + fixedWidth,
18
+ };
19
+ }
3
20
  export function cardStep(card, now) {
4
21
  if (card.endedAt !== null)
5
22
  return new Date(card.endedAt).toLocaleString();
@@ -42,8 +59,14 @@ export function completionMark(card, workflowId) {
42
59
  const mark = card.completionMark;
43
60
  if (mark === null)
44
61
  return null;
62
+ let text = mark.text;
63
+ const status = card.pullRequestObservation?.status;
64
+ if (text === "Needs attention" && status === "merged")
65
+ text = `PR merged #${String(card.pullRequestNumber)}`;
66
+ if (text === "Needs attention" && status === "unavailable")
67
+ text = "PR status unavailable";
45
68
  if (mark.laterRunId === null)
46
- return element("span", { class: "completion-mark", children: mark.text });
69
+ return element("span", { class: "completion-mark", children: text });
47
70
  return element("a", {
48
71
  class: "completion-mark",
49
72
  href: watchHash({ workflowId, runId: mark.laterRunId }),
@@ -58,8 +81,11 @@ export function Card(props) {
58
81
  element("a", {
59
82
  class: "card-run",
60
83
  href: watchHash({ workflowId, runId: card.runId }),
84
+ title: card.runId,
61
85
  children: [
62
- element("strong", { children: card.title ?? card.runId }),
86
+ element("strong", {
87
+ children: card.title ?? card.runId.slice(0, 12),
88
+ }),
63
89
  element("span", {
64
90
  class: card.endedAt === null && card.currentStep !== null
65
91
  ? "card-step active"
@@ -69,7 +95,7 @@ export function Card(props) {
69
95
  component(CardReview, { card, workflowId }),
70
96
  element("span", {
71
97
  class: "card-cost",
72
- children: `${card.claudeCostUsd.toFixed(2)} USD`,
98
+ children: `${card.currentStep === null ? "Totals" : "Totals so far"} · ${priceText(card.claudeCostUsd, card.estimatedCostUsd)}`,
73
99
  }),
74
100
  card.decisionWaiting
75
101
  ? element("span", {
@@ -77,7 +103,7 @@ export function Card(props) {
77
103
  children: "! Decision waiting",
78
104
  })
79
105
  : null,
80
- element("small", { children: card.runId }),
106
+ element("small", { children: card.runId.slice(0, 12) }),
81
107
  ],
82
108
  }),
83
109
  completionMark(card, workflowId),
@@ -101,6 +127,53 @@ export function WorkflowList(props) {
101
127
  })),
102
128
  });
103
129
  }
130
+ export function columnCollapsed(choices, name) {
131
+ const value = choices !== null && Object.hasOwn(choices, name)
132
+ ? choices[name]
133
+ : undefined;
134
+ return value ?? ["Done", "Stopped"].includes(name);
135
+ }
136
+ export function Column(props) {
137
+ const { column, workflowId, now, controls } = props;
138
+ const collapsed = columnCollapsed(controls?.choices ?? null, column.name);
139
+ const tone = column.name === "Stopped" ? "column stopped" : "column";
140
+ return element("section", {
141
+ class: `${tone}${collapsed ? " collapsed" : ""}`,
142
+ onMouseEnter: () => controls?.onHover?.(column.name),
143
+ onMouseLeave: () => controls?.onHover?.(null),
144
+ onFocusIn: () => controls?.onFocus?.(column.name),
145
+ onFocusOut: () => controls?.onFocus?.(null),
146
+ children: [
147
+ element("h3", {
148
+ class: "column-name",
149
+ children: [
150
+ element("span", { children: column.name }),
151
+ " ",
152
+ element("span", {
153
+ class: "column-count",
154
+ children: String(column.cards.length),
155
+ }),
156
+ element("button", {
157
+ type: "button",
158
+ "aria-label": `${collapsed ? "Expand" : "Collapse"} ${column.name}`,
159
+ "aria-expanded": String(!collapsed),
160
+ onClick: () => controls?.onToggle(column.name),
161
+ children: collapsed ? "+" : "−",
162
+ }),
163
+ ],
164
+ }),
165
+ collapsed
166
+ ? null
167
+ : element("div", {
168
+ class: "column-cards",
169
+ children: [
170
+ column.cards.map((card) => component(Card, { key: card.runId, card, workflowId, now })),
171
+ props.addCard,
172
+ ],
173
+ }),
174
+ ],
175
+ });
176
+ }
104
177
  export function Board(props) {
105
178
  const { workflow, now } = props;
106
179
  return element("main", {
@@ -109,18 +182,18 @@ export function Board(props) {
109
182
  element("h2", { children: workflow.workflowId }),
110
183
  element("div", {
111
184
  class: "columns",
112
- children: workflow.columns.map((column) => element("section", {
185
+ children: workflow.columns.map((column, index) => component(Column, {
113
186
  key: column.name,
114
- class: column.name === "Stopped" ? "column stopped" : "column",
115
- children: [
116
- element("h3", { class: "column-name", children: column.name }),
117
- column.cards.map((card) => component(Card, {
118
- key: card.runId,
119
- card,
120
- workflowId: workflow.workflowId,
121
- now,
122
- })),
123
- ],
187
+ column,
188
+ workflowId: workflow.workflowId,
189
+ now,
190
+ controls: props.controls,
191
+ addCard: index === 0
192
+ ? component(AddCard, {
193
+ form: props.cardForm,
194
+ controls: props.cards,
195
+ })
196
+ : null,
124
197
  })),
125
198
  }),
126
199
  ],
@@ -20,7 +20,9 @@ export function completionMarkOf(run, candidates) {
20
20
  candidate.runId !== run.runId &&
21
21
  candidate.workflowId === "develop-issue" &&
22
22
  candidate.state === "completed" &&
23
- candidate.outcome === "handoff_requested")
23
+ candidate.outcome === "handoff_requested" &&
24
+ candidate.ticketStatus !== "partial" &&
25
+ candidate.issueUpdate !== "failed")
24
26
  .map((candidate) => ({
25
27
  runId: candidate.runId,
26
28
  createdAt: eventTime(candidate, "run.created"),
@@ -100,7 +102,10 @@ function cardOf(run, runs) {
100
102
  runId: run.runId,
101
103
  title: run.title,
102
104
  completionMark: completionMarkOf(run, runs),
105
+ pullRequestObservation: null,
103
106
  claudeCostUsd: run.claudeCostUsd,
107
+ estimatedCostUsd: run.estimatedCostUsd,
108
+ usage: run.usage,
104
109
  currentStep: activeRun(run.state) ? run.currentStep : null,
105
110
  endedAt: activeRun(run.state) ? null : run.latestAt,
106
111
  decisionWaiting: run.decisions.length > 0,
@@ -0,0 +1 @@
1
+ export declare const watchCardClient = "\nasync function submitCard(workflowId) {\n const draft = state.cards[workflowId];\n if (!draft || draft.pending || draft.admitted) return;\n state.cards[workflowId] = { ...draft, pending: true, message: \"\" };\n draw();\n let result;\n try {\n const response = await fetch(\"actions/run\", {\n method: \"POST\",\n headers: { \"content-type\": \"application/json\", \"x-cloving-token\": actionToken },\n body: JSON.stringify({ workflowId, fields: draft.fields, commandId: draft.commandId }),\n });\n result = response.ok ? cardReply(await response.json()) : { admitted: false, message: \"request-refused: Refresh the page and check the input (16 KiB maximum).\" };\n } catch {\n result = cardReply({ kind: \"error\", error: { code: \"outcome-unknown\" } });\n }\n if (state.cards[workflowId]?.commandId !== draft.commandId) return;\n state.cards[workflowId] = { ...draft, ...result, pending: false };\n draw();\n}\n\nfunction cardControls(model, workflowId) {\n if (actionToken === null || workflowId === null) return undefined;\n const form = model?.cardForms?.find((item) => item.workflowId === workflowId);\n if (form === undefined) return undefined;\n const draft = state.cards[workflowId] ?? null;\n return { draft, onOpen() {\n state.cards[workflowId] = { commandId: crypto.randomUUID(), fields: {}, pending: false, admitted: false, message: \"\" };\n draw();\n document.querySelector(\".add-card-form input, .add-card-form textarea, .add-card-form button\")?.focus();\n }, onCancel() {\n delete state.cards[workflowId];\n draw();\n document.querySelector(\".add-card\")?.focus();\n },\n onChange(name, value) {\n const fields = { ...state.cards[workflowId].fields, [name]: value };\n if (form.fields.find((field) => field.name === name)?.optional && !value.trim())\n delete fields[name];\n state.cards[workflowId] = { ...state.cards[workflowId], fields };\n }, onSubmit() { submitCard(workflowId); } };\n}\n";
@@ -0,0 +1,44 @@
1
+ export const watchCardClient = `
2
+ async function submitCard(workflowId) {
3
+ const draft = state.cards[workflowId];
4
+ if (!draft || draft.pending || draft.admitted) return;
5
+ state.cards[workflowId] = { ...draft, pending: true, message: "" };
6
+ draw();
7
+ let result;
8
+ try {
9
+ const response = await fetch("actions/run", {
10
+ method: "POST",
11
+ headers: { "content-type": "application/json", "x-cloving-token": actionToken },
12
+ body: JSON.stringify({ workflowId, fields: draft.fields, commandId: draft.commandId }),
13
+ });
14
+ result = response.ok ? cardReply(await response.json()) : { admitted: false, message: "request-refused: Refresh the page and check the input (16 KiB maximum)." };
15
+ } catch {
16
+ result = cardReply({ kind: "error", error: { code: "outcome-unknown" } });
17
+ }
18
+ if (state.cards[workflowId]?.commandId !== draft.commandId) return;
19
+ state.cards[workflowId] = { ...draft, ...result, pending: false };
20
+ draw();
21
+ }
22
+
23
+ function cardControls(model, workflowId) {
24
+ if (actionToken === null || workflowId === null) return undefined;
25
+ const form = model?.cardForms?.find((item) => item.workflowId === workflowId);
26
+ if (form === undefined) return undefined;
27
+ const draft = state.cards[workflowId] ?? null;
28
+ return { draft, onOpen() {
29
+ state.cards[workflowId] = { commandId: crypto.randomUUID(), fields: {}, pending: false, admitted: false, message: "" };
30
+ draw();
31
+ document.querySelector(".add-card-form input, .add-card-form textarea, .add-card-form button")?.focus();
32
+ }, onCancel() {
33
+ delete state.cards[workflowId];
34
+ draw();
35
+ document.querySelector(".add-card")?.focus();
36
+ },
37
+ onChange(name, value) {
38
+ const fields = { ...state.cards[workflowId].fields, [name]: value };
39
+ if (form.fields.find((field) => field.name === name)?.optional && !value.trim())
40
+ delete fields[name];
41
+ state.cards[workflowId] = { ...state.cards[workflowId], fields };
42
+ }, onSubmit() { submitCard(workflowId); } };
43
+ }
44
+ `;
@@ -0,0 +1,2 @@
1
+ import { type CardForm } from "./watch-run-input.ts";
2
+ export declare function watchCardForms(directory: string): Promise<readonly CardForm[]>;
@@ -0,0 +1,33 @@
1
+ import { readdir, readFile } from "node:fs/promises";
2
+ import { join } from "node:path";
3
+ import { isWorkflowDeclaration } from "../workflow-declaration.js";
4
+ import { builtinCardForms } from "./watch-run-input.js";
5
+ export async function watchCardForms(directory) {
6
+ const forms = [...builtinCardForms()];
7
+ const files = await readdir(directory).catch(() => []);
8
+ for (const file of files
9
+ .filter((name) => name.endsWith(".declaration.json"))
10
+ .sort()) {
11
+ const value = await readFile(join(directory, file), "utf8")
12
+ .then((text) => JSON.parse(text))
13
+ .catch(() => null);
14
+ if (!isWorkflowDeclaration(value))
15
+ continue;
16
+ const entries = Object.entries(value.input.fields);
17
+ if (!entries.every(([, rule]) => rule === "string" || rule.type === "string"))
18
+ continue;
19
+ if (forms.some((form) => form.workflowId === value.workflowId))
20
+ continue;
21
+ forms.push({
22
+ workflowId: value.workflowId,
23
+ source: "input",
24
+ fields: entries.map(([name, rule]) => ({
25
+ name,
26
+ label: name,
27
+ multiline: false,
28
+ optional: rule !== "string" && rule.optional === true,
29
+ })),
30
+ });
31
+ }
32
+ return forms;
33
+ }
@@ -0,0 +1,5 @@
1
+ import type { Reply } from "../protocol.ts";
2
+ export declare function cardReply(reply: Reply): {
3
+ readonly admitted: boolean;
4
+ readonly message: string;
5
+ };
@@ -0,0 +1,34 @@
1
+ export function cardReply(reply) {
2
+ if (reply.kind === "result")
3
+ return {
4
+ admitted: true,
5
+ message: `Run ${String(reply.result["runId"])} is admitted`,
6
+ };
7
+ const explanations = {
8
+ "workflow-active": "Add the label cloving: ready to the issue to put it in the queue.",
9
+ "unknown-workflow": "This workflow is no longer registered. Refresh the page.",
10
+ "workflow-unavailable": "A required workflow capability is unavailable.",
11
+ "invalid-submission": "Check the workflow fields.",
12
+ "input-too-large": "Shorten the input and try again.",
13
+ "invalid-request": "The service could not read this run request.",
14
+ "conflicting-command": "This form was already sent with different fields. Open a new form.",
15
+ "service-unavailable": "Start the Cloving service and retry this form.",
16
+ "authority-unavailable": "The service authority is unavailable. Retry this form later.",
17
+ "permission-denied": "The service refused access to this account.",
18
+ "outcome-unknown": "The reply was lost. Retry this form with the same command ID.",
19
+ "resolver-timeout": "The input resolver timed out. Retry this form.",
20
+ "resolver-failure": "The input resolver failed. Check the service before retrying.",
21
+ "invalid-ticket-id": "Enter a valid issue number or ticket ID.",
22
+ "ticket-source-not-configured": "Configure the daemon ticket command first.",
23
+ "ticket-not-available": "The ticket could not be read.",
24
+ "next-source-not-configured": "Configure the daemon next-ticket command first.",
25
+ "next-ticket-not-available": "The next ticket could not be read.",
26
+ "no-ready-ticket": "There is no ready ticket in the queue.",
27
+ "unsupported-prompt": "This workflow requires declared input fields.",
28
+ };
29
+ const { code } = reply.error;
30
+ return {
31
+ admitted: false,
32
+ message: `${code}: ${explanations[code] ?? "The service refused this run."}`,
33
+ };
34
+ }
@@ -0,0 +1,40 @@
1
+ import { type Shown } from "./watch-element.ts";
2
+ import type { CardField, CardForm } from "./watch-run-input.ts";
3
+ export interface CardDraft {
4
+ readonly commandId: string;
5
+ readonly fields: Readonly<Record<string, string>>;
6
+ readonly pending: boolean;
7
+ readonly admitted: boolean;
8
+ readonly message: string;
9
+ }
10
+ export interface CardControls {
11
+ readonly draft: CardDraft | null;
12
+ readonly onOpen: () => void;
13
+ readonly onCancel: () => void;
14
+ readonly onChange: (name: string, value: string) => void;
15
+ readonly onSubmit: () => void;
16
+ }
17
+ export interface CardKeyEvent {
18
+ readonly key: string;
19
+ readonly defaultPrevented?: boolean;
20
+ readonly isComposing?: boolean;
21
+ readonly repeat?: boolean;
22
+ readonly ctrlKey?: boolean;
23
+ readonly metaKey?: boolean;
24
+ readonly target?: {
25
+ readonly localName?: string;
26
+ };
27
+ readonly currentTarget: object;
28
+ readonly preventDefault: () => void;
29
+ }
30
+ export declare function cardSubmitKey(event: CardKeyEvent): boolean;
31
+ export declare function cardKey(event: CardKeyEvent, controls: CardControls): void;
32
+ export declare function CardInput(props: {
33
+ readonly field: CardField;
34
+ readonly controls: CardControls;
35
+ readonly draft: CardDraft;
36
+ }): Shown;
37
+ export declare function AddCard(props: {
38
+ readonly form: CardForm | undefined;
39
+ readonly controls: CardControls | undefined;
40
+ }): Shown;
@@ -0,0 +1,86 @@
1
+ import { component, element } from "./watch-element.js";
2
+ export function cardSubmitKey(event) {
3
+ const name = event.target?.localName;
4
+ return (name === "input" ||
5
+ (name === "textarea" && Boolean(event.ctrlKey || event.metaKey)));
6
+ }
7
+ export function cardKey(event, controls) {
8
+ if (event.defaultPrevented || event.isComposing || event.repeat)
9
+ return;
10
+ if (event.key === "Escape") {
11
+ event.preventDefault();
12
+ controls.onCancel();
13
+ return;
14
+ }
15
+ if (event.key !== "Enter")
16
+ return;
17
+ if (!cardSubmitKey(event))
18
+ return;
19
+ event.preventDefault();
20
+ const prototype = Reflect.getPrototypeOf(event.currentTarget);
21
+ if (prototype === null)
22
+ return;
23
+ const requestSubmit = Reflect.get(prototype, "requestSubmit");
24
+ if (typeof requestSubmit === "function")
25
+ Reflect.apply(requestSubmit, event.currentTarget, []);
26
+ }
27
+ export function CardInput(props) {
28
+ const { field, controls, draft } = props;
29
+ return element("label", {
30
+ children: [
31
+ field.label,
32
+ element(field.multiline ? "textarea" : "input", {
33
+ name: field.name,
34
+ type: field.multiline ? undefined : "text",
35
+ rows: field.multiline ? 5 : undefined,
36
+ value: draft.fields[field.name] ?? "",
37
+ required: !field.optional,
38
+ disabled: draft.pending || draft.admitted,
39
+ onInput: (event) => {
40
+ controls.onChange(field.name, event.currentTarget.value);
41
+ },
42
+ }),
43
+ ],
44
+ });
45
+ }
46
+ export function AddCard(props) {
47
+ const { form, controls } = props;
48
+ if (form === undefined || controls === undefined)
49
+ return null;
50
+ const { draft } = controls;
51
+ if (draft === null)
52
+ return element("button", {
53
+ class: "add-card",
54
+ type: "button",
55
+ onClick: controls.onOpen,
56
+ children: "+ Add a card",
57
+ });
58
+ return element("form", {
59
+ class: "add-card-form",
60
+ onKeyDown: (event) => {
61
+ cardKey(event, controls);
62
+ },
63
+ onSubmit: (event) => {
64
+ event.preventDefault();
65
+ controls.onSubmit();
66
+ },
67
+ children: [
68
+ form.fields.map((field) => component(CardInput, { key: field.name, field, controls, draft })),
69
+ element("button", {
70
+ type: "submit",
71
+ disabled: draft.pending || draft.admitted,
72
+ children: draft.pending ? "Adding…" : "Add card",
73
+ }),
74
+ element("button", {
75
+ type: "button",
76
+ onClick: controls.onCancel,
77
+ children: "Cancel",
78
+ }),
79
+ element("p", {
80
+ role: "status",
81
+ "aria-live": "polite",
82
+ children: draft.message,
83
+ }),
84
+ ],
85
+ });
86
+ }
@@ -0,0 +1 @@
1
+ export declare const watchClient = "\nconst state = { model: null, stale: false, copied: \"\", label: \"\", run: \"\", loading: false, again: false, columns: {}, cards: {}, start: null, hovered: null, focused: null };\nfunction readPreference(key) {\n try { return JSON.parse(localStorage.getItem(key)); }\n catch { return null; }\n}\nfunction readColumnChoices(key) {\n const value = readPreference(key);\n if (typeof value !== \"object\" || value === null || Array.isArray(value)) return null;\n return Object.fromEntries(Object.entries(value).filter(([, choice]) => typeof choice === \"boolean\"));\n}\nfunction savePreference(key, value) {\n try { localStorage.setItem(key, JSON.stringify(value)); }\n catch {}\n}\nfunction startControls() {\n if (state.start === null) state.start = readPreference(\"cloving.watch.start\") === true;\n return { shown: state.start, onToggle() {\n state.start = !state.start;\n savePreference(\"cloving.watch.start\", state.start);\n draw();\n } };\n}\nfunction columnControls(model, selected) {\n const workflowId = model === null ? null : boardWorkflow(model, watchLocation(selected).workflowId);\n if (workflowId === null) return undefined;\n const key = \"cloving.watch.columns:\" + workflowId;\n if (!Object.hasOwn(state.columns, workflowId))\n state.columns = { ...state.columns, [workflowId]: readColumnChoices(key) };\n const choices = state.columns[workflowId];\n return { choices, onHover(name) { state.hovered = name; }, onFocus(name) { state.focused = name; }, onToggle(name) {\n const changed = { ...choices, [name]: !columnCollapsed(choices, name) };\n state.columns = { ...state.columns, [workflowId]: changed };\n savePreference(key, changed);\n draw();\n } };\n}\nfunction moved(next, followed) {\n const arrived = next === \"waiting_gate\" && next !== state.run;\n state.run = next;\n if (arrived) scrollTo(0, 0);\n else if (followed && next === \"running\") scrollTo(0, document.body.scrollHeight);\n}\nfunction copy(command) {\n const shown = (label) => {\n state.copied = command;\n state.label = label;\n draw();\n };\n navigator.clipboard.writeText(command).then(\n () => { shown(\"Copied\"); },\n () => { shown(\"Copy failed\"); },\n );\n}\nfunction draw() {\n const { model, stale } = state;\n const selected = location.hash.slice(1);\n const followed = innerHeight + scrollY >= document.body.scrollHeight - 80;\n const copying = { command: state.copied, label: state.label, onCopy: copy };\n const now = new Date().toISOString();\n const columns = columnControls(model, selected);\n const start = model === null ? undefined : startControls();\n const cards = cardControls(model, model === null ? null : boardWorkflow(model, watchLocation(selected).workflowId));\n const page = component(Page, { model, selected, now, stale, copying, columns, start, cards });\n render(page, document.getElementById(\"app\"));\n if (model === null) return;\n document.title = watchTitle(model, selected);\n const { runId } = watchLocation(selected);\n moved(model.runs.find((run) => run.runId === runId)?.state ?? \"\", followed);\n}\nasync function withSelectedRun(model) {\n const { runId } = watchLocation(location.hash);\n if (runId === null || model.runs.some((run) => run.runId === runId)) return model;\n const detail = await fetch(\"data.json?runId=\" + encodeURIComponent(runId), { cache: \"no-store\" });\n if (detail.status === 404) return model;\n if (!detail.ok) throw new Error(\"watch-run-not-available\");\n const { run } = await detail.json();\n if (run?.runId !== runId) throw new Error(\"watch-run-mismatch\");\n return { ...model, runs: [...model.runs, run] };\n}\nasync function load() {\n state.again = state.loading;\n if (state.loading) return;\n state.loading = true;\n try {\n const reply = await fetch(\"data.json\", { cache: \"no-store\" });\n if (!reply.ok) throw new Error(\"watch-not-available\");\n state.model = await withSelectedRun(await reply.json());\n state.stale = false;\n } catch {\n state.stale = true;\n }\n state.loading = false;\n draw();\n if (state.again) load();\n}\nfunction listen() {\n const source = new EventSource(\"events\");\n source.onmessage = () => { load(); };\n source.onerror = () => { state.stale = true; draw(); };\n}\naddEventListener(\"keydown\", (event) => {\n if (event.key !== String.fromCharCode(92) || event.defaultPrevented || event.repeat || event.isComposing) return;\n if (event.ctrlKey || event.altKey || event.metaKey || event.shiftKey) return;\n if (event.target?.closest?.(\"input, textarea, select, [contenteditable]\")) return;\n const target = state.hovered ?? state.focused;\n if (target === null || watchLocation(location.hash).runId !== null) return;\n const controls = columnControls(state.model, location.hash);\n if (controls === undefined) return;\n event.preventDefault();\n controls.onToggle(target);\n});\naddEventListener(\"hashchange\", () => { state.run = \"\"; state.hovered = null; state.focused = null; draw(); load(); });\ndraw();\nlisten();\nsetInterval(draw, 1000);\nsetInterval(load, 15000);\n";
@@ -0,0 +1,118 @@
1
+ export const watchClient = `
2
+ const state = { model: null, stale: false, copied: "", label: "", run: "", loading: false, again: false, columns: {}, cards: {}, start: null, hovered: null, focused: null };
3
+ function readPreference(key) {
4
+ try { return JSON.parse(localStorage.getItem(key)); }
5
+ catch { return null; }
6
+ }
7
+ function readColumnChoices(key) {
8
+ const value = readPreference(key);
9
+ if (typeof value !== "object" || value === null || Array.isArray(value)) return null;
10
+ return Object.fromEntries(Object.entries(value).filter(([, choice]) => typeof choice === "boolean"));
11
+ }
12
+ function savePreference(key, value) {
13
+ try { localStorage.setItem(key, JSON.stringify(value)); }
14
+ catch {}
15
+ }
16
+ function startControls() {
17
+ if (state.start === null) state.start = readPreference("cloving.watch.start") === true;
18
+ return { shown: state.start, onToggle() {
19
+ state.start = !state.start;
20
+ savePreference("cloving.watch.start", state.start);
21
+ draw();
22
+ } };
23
+ }
24
+ function columnControls(model, selected) {
25
+ const workflowId = model === null ? null : boardWorkflow(model, watchLocation(selected).workflowId);
26
+ if (workflowId === null) return undefined;
27
+ const key = "cloving.watch.columns:" + workflowId;
28
+ if (!Object.hasOwn(state.columns, workflowId))
29
+ state.columns = { ...state.columns, [workflowId]: readColumnChoices(key) };
30
+ const choices = state.columns[workflowId];
31
+ return { choices, onHover(name) { state.hovered = name; }, onFocus(name) { state.focused = name; }, onToggle(name) {
32
+ const changed = { ...choices, [name]: !columnCollapsed(choices, name) };
33
+ state.columns = { ...state.columns, [workflowId]: changed };
34
+ savePreference(key, changed);
35
+ draw();
36
+ } };
37
+ }
38
+ function moved(next, followed) {
39
+ const arrived = next === "waiting_gate" && next !== state.run;
40
+ state.run = next;
41
+ if (arrived) scrollTo(0, 0);
42
+ else if (followed && next === "running") scrollTo(0, document.body.scrollHeight);
43
+ }
44
+ function copy(command) {
45
+ const shown = (label) => {
46
+ state.copied = command;
47
+ state.label = label;
48
+ draw();
49
+ };
50
+ navigator.clipboard.writeText(command).then(
51
+ () => { shown("Copied"); },
52
+ () => { shown("Copy failed"); },
53
+ );
54
+ }
55
+ function draw() {
56
+ const { model, stale } = state;
57
+ const selected = location.hash.slice(1);
58
+ const followed = innerHeight + scrollY >= document.body.scrollHeight - 80;
59
+ const copying = { command: state.copied, label: state.label, onCopy: copy };
60
+ const now = new Date().toISOString();
61
+ const columns = columnControls(model, selected);
62
+ const start = model === null ? undefined : startControls();
63
+ const cards = cardControls(model, model === null ? null : boardWorkflow(model, watchLocation(selected).workflowId));
64
+ const page = component(Page, { model, selected, now, stale, copying, columns, start, cards });
65
+ render(page, document.getElementById("app"));
66
+ if (model === null) return;
67
+ document.title = watchTitle(model, selected);
68
+ const { runId } = watchLocation(selected);
69
+ moved(model.runs.find((run) => run.runId === runId)?.state ?? "", followed);
70
+ }
71
+ async function withSelectedRun(model) {
72
+ const { runId } = watchLocation(location.hash);
73
+ if (runId === null || model.runs.some((run) => run.runId === runId)) return model;
74
+ const detail = await fetch("data.json?runId=" + encodeURIComponent(runId), { cache: "no-store" });
75
+ if (detail.status === 404) return model;
76
+ if (!detail.ok) throw new Error("watch-run-not-available");
77
+ const { run } = await detail.json();
78
+ if (run?.runId !== runId) throw new Error("watch-run-mismatch");
79
+ return { ...model, runs: [...model.runs, run] };
80
+ }
81
+ async function load() {
82
+ state.again = state.loading;
83
+ if (state.loading) return;
84
+ state.loading = true;
85
+ try {
86
+ const reply = await fetch("data.json", { cache: "no-store" });
87
+ if (!reply.ok) throw new Error("watch-not-available");
88
+ state.model = await withSelectedRun(await reply.json());
89
+ state.stale = false;
90
+ } catch {
91
+ state.stale = true;
92
+ }
93
+ state.loading = false;
94
+ draw();
95
+ if (state.again) load();
96
+ }
97
+ function listen() {
98
+ const source = new EventSource("events");
99
+ source.onmessage = () => { load(); };
100
+ source.onerror = () => { state.stale = true; draw(); };
101
+ }
102
+ addEventListener("keydown", (event) => {
103
+ if (event.key !== String.fromCharCode(92) || event.defaultPrevented || event.repeat || event.isComposing) return;
104
+ if (event.ctrlKey || event.altKey || event.metaKey || event.shiftKey) return;
105
+ if (event.target?.closest?.("input, textarea, select, [contenteditable]")) return;
106
+ const target = state.hovered ?? state.focused;
107
+ if (target === null || watchLocation(location.hash).runId !== null) return;
108
+ const controls = columnControls(state.model, location.hash);
109
+ if (controls === undefined) return;
110
+ event.preventDefault();
111
+ controls.onToggle(target);
112
+ });
113
+ addEventListener("hashchange", () => { state.run = ""; state.hovered = null; state.focused = null; draw(); load(); });
114
+ draw();
115
+ listen();
116
+ setInterval(draw, 1000);
117
+ setInterval(load, 15000);
118
+ `;