antcolony

7.3 KB

1. // deploy.hl — mission 027 (ticket antcolony#1, first live batch 2026-09-24): the DEPLOY GATE's two commands.
2. //
3. // Why: the creator can only test on the live site. A passed, complete report on a project whose registry has `live`
4. // is therefore NOT "ready for you to test" (report.hl deployGate): it gets ONE line "Built — goes live with the next
5. // deploy." (machine line `colony-report: S · sha256 H · controller pass · ready to deploy`) and the ticket stays
6. // `in progress` — out of `next`, its lease never expires (lease.hl readyOf / leaseOf kind `ready`).
7. //
8. // ./colony ready every ticket waiting for a deploy (GETs only), grouped by project, with the live
9. // site and the deploy note of the registry
10. // ./colony deployed <project> <n> after the architect deployed: the readable comment — "Now live on <site> — <result>",
11. // **Test:** as a numbered list, ≤ 3 details (questions, problems filed elsewhere,
12. // Decided, not done …), machine line `colony-deployed: S · sha256 H` — from the
13. // session's runs/<S>/report.json on THIS host; then `in progress → awaiting creator`
14. // ("Ready for you to test — see the last comment."). Idempotent: a second call writes
15. // nothing (a missing state change is repaired).
16. import { env } from 'hl:proc'
17. import { loadRegistry } from './registry.hl'
18. import { getJson, postJson, readToken, ticketPath, pageUrl, allTickets } from './tickets.hl'
19. import { readyOf } from './lease.hl'
20. import { survey } from './next.hl'
21. import { deployedCommentOf, siteName, linkOf, refLabel } from './report.hl'
22. import { sha256 } from 'hl:crypto'
23. import { NL, readJson, fromCwd, positionals } from './util.hl'
25. static runsDirOf = () => {
26. let r = env('COLONY_RUNS_DIR')
27. if (r != null && r != '') { return fromCwd(r) }
28. let home = env('COLONY_HOME')
29. return home == null || home == '' ? './runs' : home + '/runs'
30. }
32. // `./colony ready`
33. static runReady = (argv) => {
34. let sv = survey()
35. if (sv.error != null) {
36. console.log('ready: ' + sv.error)
37. return false
38. }
39. let n = 0
40. for (e of sv.notEligible) {
41. let t = e.t
42. if (t.state == 'in progress' && t.readySession != null) {
43. n = n + 1
44. let m = sv.reg.projects[t.project]
45. let live = m == null || m.live == null ? '(no live entry any more)' : (m.live.url != null ? m.live.url : m.live.host + ':' + m.live.folder)
46. let dep = m == null || m.deploy == null ? '' : ' · deploy: ' + m.deploy
47. console.log('READY ' + t.project + t.ref + ' "' + t.subject + '" — built by session ' + t.readySession + ' · live ' + live + dep + ' · after the deploy: ./colony deployed ' + t.project + ' ' + t.number + ' · ' + pageUrl(t))
48. }
49. }
50. console.log('READY: ' + n + ' ticket(s) waiting for a deploy' + (n > 0 ? ' — deploy, then `./colony deployed <project> <n>` for each' : ''))
51. return true
52. }
54. // the filed questions / issues of a session (by their `source`) → { asked: [link], filed: [{ link, blocks, unknown }] }
55. static filedOf = (session, report) => {
56. let asked = []
57. let filed = []
58. let all = allTickets()
59. if (all.error != null) { return { asked = asked filed = filed } }
60. let pre = 'colony-report:' + session + ':'
61. let qi = 0
62. while (qi < report.questions.length) {
63. for (t of all.tickets) { if (t.source == pre + 'questions:' + qi) { asked.push(linkOf(t)) } }
64. qi = qi + 1
65. }
66. let ii = 0
67. while (ii < report.issues.length) {
68. for (t of all.tickets) {
69. if (t.source == pre + 'issue:' + ii) { filed.push({ link = linkOf(t) blocks = report.issues[ii].blocks unknown = false }) }
70. else if (t.source == pre + 'question:' + ii) { filed.push({ link = linkOf(t) blocks = false unknown = true }) }
71. }
72. ii = ii + 1
73. }
74. return { asked = asked filed = filed }
75. }
77. // `./colony deployed <project> <n>`
78. static runDeployed = (argv) => {
79. let pos = positionals(argv)
80. if (pos.length != 3) {
81. console.log('usage: deployed <project> <number>')
82. return false
83. }
84. let project = pos[1]
85. let number = pos[2]
86. let ref = project + '#' + number
87. let tk = readToken()
88. if (tk.error != null) {
89. console.log('deployed: REFUSED — ' + tk.error)
90. return false
91. }
92. let got = getJson(ticketPath(project, number))
93. if (got.status != 200) {
94. console.log('deployed: REFUSED — ticket ' + ref + ' → ' + got.status)
95. return false
96. }
97. let t = got.json.ticket
98. let events = got.json.events
99. // already done? (idempotent: the deployed comment of the last ready session exists)
100. let lastReady = null
101. for (e of events) {
102. if (e.kind == 'comment' && e.text != null) {
103. for (l of e.text.split(NL)) {
104. let x = l.trim()
105. if (x.startsWith('colony-report: ') && x.endsWith(' · ready to deploy')) { lastReady = x.slice(15).split(' · ')[0].trim() }
106. }
107. }
108. }
109. let have = false
110. if (lastReady != null) {
111. for (e of events) { if (e.kind == 'comment' && e.text != null && e.text.includes('colony-deployed: ' + lastReady + ' ·')) { have = true } }
112. }
113. let session = readyOf(events)
114. if (session == null && !have) {
115. console.log('deployed: REFUSED — ' + ref + ' is "' + t.state + '" and not waiting for a deploy (no "ready to deploy" report of a colony session' + (lastReady != null ? '; the last one, ' + lastReady + ', is void: the ticket left "in progress" or another session started' : '') + '). Nothing written.')
116. return false
117. }
118. if (session == null) { session = lastReady }
119. let reg = loadRegistry()
120. let m = reg.projects[project]
121. let site = m != null && m.live != null && m.live.url != null ? siteName(m.live.url) : project
122. let token = tk.token
123. if (have) {
124. console.log(' HAVE the deployed comment of session ' + session + ' on ' + ref + ' — not written again')
125. } else {
126. let dir = runsDirOf() + '/' + session
127. let rj = readJson(dir + '/report.json')
128. if (rj.error != null) {
129. console.log('deployed: REFUSED — the report of session ' + session + ' is not on this host (' + rj.error + '); run `deployed` where the session ran. Nothing written.')
130. return false
131. }
132. let r = rj.value
133. if (r.session != session || r.ticket != ref) {
134. console.log('deployed: REFUSED — ' + dir + '/report.json is for ' + r.ticket + ' session ' + r.session + ', not ' + ref + ' session ' + session + '. Nothing written.')
135. return false
136. }
137. let hash = sha256(JSON.stringify(r)).slice(0, 12)
138. let f = filedOf(session, r)
139. let text = deployedCommentOf(r, f.filed, f.asked, site, hash)
140. let c = postJson(ticketPath(project, number) + '/comments', { text = text }, token)
141. if (c.status != 201) {
142. console.log('deployed: FAILED — comment on ' + ref + ': ' + c.status + ' ' + c.text)
143. return false
144. }
145. console.log(' POSTED the deployed comment on ' + ref + ' ' + pageUrl(t))
146. for (l of text.split(NL)) { console.log(' | ' + l) }
147. t = c.json.ticket
148. }
149. if (t.state == 'in progress') {
150. let s = postJson(ticketPath(project, number) + '/state', { state = 'awaiting creator' text = 'Ready for you to test — see the last comment.' }, token)
151. if (s.status != 201) {
152. console.log('deployed: FAILED — state of ' + ref + ': ' + s.status + ' ' + s.text + ' — re-run (idempotent)')
153. return false
154. }
155. console.log(' STATE ' + ref + ': in progress → awaiting creator')
156. } else {
157. console.log(' STATE left as "' + t.state + '"')
158. }
159. console.log('DEPLOYED — ' + ref + ' (session ' + session + ', live on ' + site + ')' + (have ? ': nothing new' : ''))
160. return true
161. }