antcolony

8.8 KB

1. // keywords.hl — the creator's short commands in a comment (ticket antcolony#17; concept docs/scheduler-agent.md §2
2. // "Comment keywords (code, no LLM)"): /confirm, /reject <why>, /prio <high|normal|low|-9..9>, /hold.
3. //
4. // A keyword counts only when it is the FIRST word of a comment written by the creator (`creatorNames()`, the same
5. // names the librarian uses). Nothing is stored here: what was handled is in the ticket's history.
6. // * /hold → state `on hold` ("On hold, as you asked.")
7. // * /confirm → state `confirmed`, /reject <why> → state `rejected` (the reason is the state text, so a rework
8. // brief quotes it). The colony's own token may NOT confirm/reject (tickets: creator only) — these
9. // two need the creator's token in COLONY_CREATOR_TOKEN_FILE; without it the colony answers once
10. // in a comment ("use the button") instead of pretending.
11. // * /prio → the last valid /prio decides (read by `next` / `run`, see prioOf); the colony answers once.
12. // A state keyword is stale — ignored — when a state change came after it (not the tickets app's automatic `answered` after
13. // the creator's comment), or the ticket is already in that state.
14. // Every answer comment carries `colony-keyword: <event id> · <keyword>` (idempotence: a keyword with that marker
15. // in the history is done); state keywords rely on the state event that follows them.
16. import { env } from 'hl:proc'
17. import { readFile, exists } from 'hl:fs'
18. import { getJson, postJson, ticketPath, allTickets, readToken, pageUrl, isCreatorEvent } from './tickets.hl'
19. import { creatorNames } from './librarian.hl'
20. import { NL, fromCwd } from './util.hl'
22. static MARK = 'colony-keyword: '
23. static WORDS = ['/confirm' '/reject' '/prio' '/hold']
25. // the creator's token for /confirm and /reject (optional): { token } or { error }
26. static readCreatorToken = () => {
27. let f = env('COLONY_CREATOR_TOKEN_FILE')
28. if (f == null || f == '') { return { error = 'COLONY_CREATOR_TOKEN_FILE is not set' } }
29. let p = fromCwd(f)
30. if (!exists(p)) { return { error = 'COLONY_CREATOR_TOKEN_FILE: no such file: ' + p } }
31. let t = readFile(p).trim()
32. if (t == '') { return { error = 'COLONY_CREATOR_TOKEN_FILE is empty: ' + p } }
33. return { token = t }
34. }
36. // priority word / number → a whole number in -9..9 or null. higher = sooner; normal = 0
37. static prioValue = (arg) => {
38. let a = arg.trim().toLowerCase()
39. if (a == 'high') { return 1 }
40. if (a == 'normal') { return 0 }
41. if (a == 'low') { return -1 }
42. let neg = a.startsWith('-')
43. let d = neg ? a.slice(1) : a
44. if (d.length != 1 || '0123456789'.indexOf(d) < 0) { return null }
45. let n = '0123456789'.indexOf(d)
46. return neg ? 0 - n : n
47. }
49. // a comment text → { kind: confirm|reject|prio|hold, arg } or null. The first non-empty line must start with the word
50. // (and end or continue with a space); for /reject the reason is the rest of the line plus the following lines.
51. static parseKeyword = (text) => {
52. if (text == null) { return null }
53. let t = text.trim()
54. if (!t.startsWith('/')) { return null }
55. for (w of WORDS) {
56. if (t.startsWith(w)) {
57. let rest = t.slice(w.length)
58. if (rest == '' || rest.startsWith(' ') || rest.startsWith(NL) || rest.startsWith('\t')) {
59. let arg = rest.trim()
60. if (w != '/reject') {
61. let nl = arg.indexOf(NL)
62. if (nl >= 0) { arg = arg.slice(0, nl).trim() }
63. }
64. return { kind = w.slice(1) arg = arg }
65. }
66. }
67. }
68. return null
69. }
71. // the priority of a ticket from its history: the last valid `/prio` by the creator, else 0
72. static prioOf = (events, project) => {
73. let names = creatorNames()
74. let p = 0
75. for (e of events) {
76. if (e.kind == 'comment' && isCreatorEvent(project, e, names)) {
77. let k = parseKeyword(e.text)
78. if (k != null && k.kind == 'prio') {
79. let v = prioValue(k.arg)
80. if (v != null) { p = v }
81. }
82. }
83. }
84. return p
85. }
87. static prioWord = (p) => {
88. if (p == 1) { return 'high' }
89. if (p == 0) { return 'normal' }
90. if (p == -1) { return 'low' }
91. return '' + p
92. }
94. static handledIn = (events, id) => {
95. let m = MARK + id
96. for (e of events) { if (e.text != null && e.text.indexOf(m) >= 0) { return true } }
97. return false
98. }
100. // → the keywords of one ticket still to act on: [{ event, kind, arg, stale }] (oldest first)
101. static pendingOf = (events, names, project) => {
102. let out = []
103. let i = 0
104. while (i < events.length) {
105. let e = events[i]
106. if (e.kind == 'comment' && isCreatorEvent(project, e, names)) {
107. let k = parseKeyword(e.text)
108. if (k != null && !handledIn(events, e.id)) {
109. let later = false
110. let j = i + 1
111. while (j < events.length) {
112. // a state change after the keyword makes it stale — except the tickets app's own move of the creator's
113. // answered question to `answered` (the creator's comment triggers it, it is not a decision)
114. let ev = events[j]
115. if (ev.kind == 'state' && !(isCreatorEvent(project, ev, names) && ev.to == 'answered')) { later = true }
116. j = j + 1
117. }
118. out.push({ event = e kind = k.kind arg = k.arg stale = later })
119. }
120. }
121. i = i + 1
122. }
123. return out
124. }
126. static reply = (project, number, text, e, kind, token) => {
127. let r = postJson(ticketPath(project, number) + '/comments', { text = text + NL + NL + MARK + e.id + ' · ' + kind }, token)
128. return r.status == 201 ? 'answered' : 'ANSWER FAILED ' + r.status + ' ' + r.text
129. }
131. // act on one keyword → a line of text
132. static act = (t, p, post, tk, ck) => {
133. let e = p.event
134. let path = ticketPath(t.project, t.number)
135. if (p.kind == 'prio') {
136. let v = prioValue(p.arg)
137. if (v == null) { return post ? reply(t.project, t.number, 'I did not understand the priority "' + p.arg + '". Write /prio high, /prio normal, /prio low or a number from -9 to 9 (higher = sooner).', e, 'prio-refused', tk.token) : 'would refuse: not a priority' }
138. if (!post) { return 'would set priority ' + prioWord(v) }
139. return 'priority ' + prioWord(v) + ' — ' + reply(t.project, t.number, 'Priority is now ' + prioWord(v) + ' (higher goes first).', e, 'prio', tk.token)
140. }
141. if (p.stale) { return 'ignored (the state changed after it)' }
142. if (p.kind == 'hold') {
143. if (t.state == 'on hold') { return 'ignored (already on hold)' }
144. if (!post) { return 'would put the ticket on hold' }
145. let s = postJson(path + '/state', { state = 'on hold' text = 'On hold, as you asked.' }, tk.token)
146. return s.status == 201 ? 'on hold' : 'FAILED ' + s.status + ' ' + s.text
147. }
148. // confirm / reject: creator only
149. let target = p.kind == 'confirm' ? 'confirmed' : 'rejected'
150. if (t.state == target) { return 'ignored (already ' + target + ')' }
151. if (p.kind == 'reject' && p.arg == '') {
152. return post ? reply(t.project, t.number, 'A rejection needs a reason. Write /reject and then what is wrong.', e, 'reject-refused', tk.token) : 'would refuse: /reject without a reason'
153. }
154. if (ck.error != null) {
155. return post ? reply(t.project, t.number, 'I cannot ' + p.kind + ' for you: only you may, and the colony has no permission to do it in your name. Please use the button on this page.', e, p.kind + '-refused', tk.token) : 'would refuse: no creator token (' + ck.error + ')'
156. }
157. if (!post) { return 'would set ' + target }
158. let s = postJson(path + '/state', { state = target text = p.kind == 'confirm' ? 'Confirmed.' : p.arg }, ck.token)
159. return s.status == 201 ? target : 'FAILED ' + s.status + ' ' + s.text
160. }
162. // one pass over every ticket. opts = { post, seen } — `seen` (an object, optional) remembers each ticket's updatedMs so an
163. // unchanged ticket is not read again (the daemon keeps one). → { acted, error }
164. static keywordPass = (post, seen) => {
165. let all = allTickets()
166. if (all.error != null) { return { error = all.error acted = 0 } }
167. let names = creatorNames()
168. let tk = post ? readToken() : { token = '' }
169. if (tk.error != null) { return { error = tk.error acted = 0 } }
170. let ck = readCreatorToken()
171. let acted = 0
172. for (t of all.tickets) {
173. let upd = t.updatedMs == null ? 0 : t.updatedMs
174. if (seen == null || seen[t.id] != upd) {
175. let d = getJson(t.apiHref)
176. if (d.status == 200) {
177. let pend = pendingOf(d.json.events, names, t.project)
178. let done = true
179. for (p of pend) {
180. let line = act(t, p, post, tk, ck)
181. console.log('KEYWORD ' + t.project + t.ref + ' /' + p.kind + (p.arg == '' ? '' : ' ' + p.arg.slice(0, 40)) + ' — ' + line + ' ' + pageUrl(t))
182. if (line.indexOf('ignored') != 0) { acted = acted + 1 }
183. if (line.indexOf('FAILED') >= 0) { done = false }
184. if (!post) { done = false }
185. }
186. // remember the ticket unless an action failed (a written answer changes updatedMs → read once more, finds it handled)
187. if (seen != null && done) { seen[t.id] = upd }
188. }
189. }
190. }
191. return { acted = acted error = null }
192. }
194. static runKeywords = (argv) => {
195. let post = argv.includes('--post')
196. let r = keywordPass(post, null)
197. if (r.error != null) {
198. console.log('keywords: ' + r.error)
199. return false
200. }
201. console.log('keywords: ' + r.acted + ' keyword(s) ' + (post ? 'handled' : 'pending (dry run; --post acts)'))
202. return true
203. }