agl 42.2.2 → 43.0.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 (171) hide show
  1. package/changelog.md +16 -0
  2. package/dist_serve/bundle.js +6697 -5287
  3. package/dist_serve/bundle.js.map +2 -2
  4. package/dist_serve/bundle.js.third-party-notices.json +29 -29
  5. package/dist_serve/bundle.js.third-party-notices.txt +29 -29
  6. package/dist_serve/third-party-notices.md +597 -8
  7. package/dist_ts/00_commitinfo_data.js +1 -1
  8. package/dist_ts/aglapi/aglapisurface.document.js +114 -16
  9. package/dist_ts/aglapi/interfaces.d.ts +30 -0
  10. package/dist_ts/aglapi/interfaces.js +7 -1
  11. package/dist_ts/classes.authstore.d.ts +7 -0
  12. package/dist_ts/classes.authstore.js +12 -1
  13. package/dist_ts/classes.cli.js +10 -1
  14. package/dist_ts/classes.controller.d.ts +41 -11
  15. package/dist_ts/classes.controller.js +224 -48
  16. package/dist_ts/classes.harnessoperationmanager.d.ts +44 -0
  17. package/dist_ts/classes.harnessoperationmanager.js +15 -10
  18. package/dist_ts/classes.mcpclient.d.ts +5 -0
  19. package/dist_ts/classes.mcpclient.js +15 -3
  20. package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -0
  21. package/dist_ts/classes.mcpcontrollerhost.js +14 -2
  22. package/dist_ts/classes.mcptools.d.ts +4 -3
  23. package/dist_ts/classes.mcptools.js +20 -1
  24. package/dist_ts/classes.mcpvalidation.js +4 -1
  25. package/dist_ts/classes.ticketstore.d.ts +71 -3
  26. package/dist_ts/classes.ticketstore.js +299 -12
  27. package/dist_ts/classes.validation.d.ts +2 -0
  28. package/dist_ts/classes.validation.js +27 -5
  29. package/dist_ts/driver/classes.directreports.d.ts +23 -3
  30. package/dist_ts/driver/classes.directreports.js +59 -2
  31. package/dist_ts/driver/classes.drivereventrelay.js +3 -2
  32. package/dist_ts/driver/functions.driverinstructions.d.ts +1 -1
  33. package/dist_ts/driver/functions.driverinstructions.js +12 -3
  34. package/dist_ts/driver/functions.drivertools.d.ts +4 -0
  35. package/dist_ts/driver/functions.drivertools.js +8 -2
  36. package/dist_ts/fleet/classes.boardpump.d.ts +53 -3
  37. package/dist_ts/fleet/classes.boardpump.js +237 -32
  38. package/dist_ts/fleet/classes.claudeworkers.d.ts +10 -3
  39. package/dist_ts/fleet/classes.claudeworkers.js +43 -19
  40. package/dist_ts/fleet/classes.codexworkers.d.ts +5 -3
  41. package/dist_ts/fleet/classes.codexworkers.js +26 -9
  42. package/dist_ts/fleet/classes.deploymonitor.d.ts +253 -0
  43. package/dist_ts/fleet/classes.deploymonitor.js +821 -0
  44. package/dist_ts/fleet/classes.gitfacts.d.ts +61 -0
  45. package/dist_ts/fleet/classes.gitfacts.js +125 -0
  46. package/dist_ts/fleet/classes.releasereconciler.d.ts +51 -0
  47. package/dist_ts/fleet/classes.releasereconciler.js +101 -0
  48. package/dist_ts/fleet/classes.service.d.ts +13 -1
  49. package/dist_ts/fleet/classes.service.js +76 -7
  50. package/dist_ts/fleet/classes.ticketeffects.d.ts +13 -0
  51. package/dist_ts/fleet/classes.ticketeffects.js +42 -8
  52. package/dist_ts/fleet/classes.workers.d.ts +10 -3
  53. package/dist_ts/fleet/classes.workers.js +18 -3
  54. package/dist_ts/fleet/functions.controllerbuild.d.ts +23 -0
  55. package/dist_ts/fleet/functions.controllerbuild.js +75 -0
  56. package/dist_ts/fleet/functions.deployprobes.d.ts +39 -0
  57. package/dist_ts/fleet/functions.deployprobes.js +82 -0
  58. package/dist_ts/fleet/functions.deployvalidation.d.ts +27 -0
  59. package/dist_ts/fleet/functions.deployvalidation.js +43 -0
  60. package/dist_ts/fleet/functions.release.d.ts +2 -1
  61. package/dist_ts/fleet/functions.release.js +32 -5
  62. package/dist_ts/fleet/functions.releasefacts.d.ts +45 -0
  63. package/dist_ts/fleet/functions.releasefacts.js +68 -0
  64. package/dist_ts/fleet/functions.validation.d.ts +3 -3
  65. package/dist_ts/fleet/functions.validation.js +4 -7
  66. package/dist_ts/fleet/functions.watchprobes.js +7 -9
  67. package/dist_ts/fleet/functions.workervalidation.js +4 -3
  68. package/dist_ts/fleet/interfaces.workers.d.ts +30 -3
  69. package/dist_ts/fleet/interfaces.workers.js +14 -1
  70. package/dist_ts/functions.deploycli.d.ts +33 -0
  71. package/dist_ts/functions.deploycli.js +155 -0
  72. package/dist_ts/functions.mcpdeploytools.d.ts +13 -0
  73. package/dist_ts/functions.mcpdeploytools.js +16 -0
  74. package/dist_ts/functions.mcptickettools.d.ts +54 -0
  75. package/dist_ts/functions.mcptickettools.js +8 -7
  76. package/dist_ts/functions.ticketautolabels.d.ts +2 -0
  77. package/dist_ts/functions.ticketautolabels.js +9 -3
  78. package/dist_ts/functions.ticketcli.d.ts +16 -2
  79. package/dist_ts/functions.ticketcli.js +105 -27
  80. package/dist_ts/functions.ticketvalidation.d.ts +55 -0
  81. package/dist_ts/functions.ticketvalidation.js +26 -8
  82. package/dist_ts_interfaces/deployments.d.ts +241 -0
  83. package/dist_ts_interfaces/deployments.js +5 -6
  84. package/dist_ts_interfaces/fleet.d.ts +12 -0
  85. package/dist_ts_interfaces/fleetworkers.d.ts +21 -1
  86. package/dist_ts_interfaces/interfaces.d.ts +4 -2
  87. package/dist_ts_interfaces/interfaces.js +4 -2
  88. package/dist_ts_interfaces/mcprequests.d.ts +3 -2
  89. package/dist_ts_interfaces/mcprequests.js +3 -1
  90. package/dist_ts_interfaces/requests.d.ts +3 -2
  91. package/dist_ts_interfaces/requests.directreports.d.ts +58 -6
  92. package/dist_ts_interfaces/requests.js +1 -1
  93. package/dist_ts_interfaces/requests.tickets.d.ts +25 -5
  94. package/dist_ts_interfaces/requests.tickets.js +2 -2
  95. package/dist_ts_interfaces/tickets.d.ts +71 -6
  96. package/dist_ts_interfaces/tickets.js +34 -6
  97. package/dist_ts_migration/classes.documentmigrationrunner.d.ts +7 -0
  98. package/dist_ts_migration/classes.documentmigrationrunner.js +14 -1
  99. package/dist_ts_migration/index.d.ts +2 -0
  100. package/dist_ts_migration/index.js +3 -1
  101. package/dist_ts_migration/v41_ticketclosedcolumn.d.ts +20 -0
  102. package/dist_ts_migration/v41_ticketclosedcolumn.js +118 -0
  103. package/dist_ts_migration/v41_ticketlinkrepos.d.ts +24 -0
  104. package/dist_ts_migration/v41_ticketlinkrepos.js +101 -0
  105. package/package.json +6 -2
  106. package/readme.md +306 -36
  107. package/third-party-notices.md +597 -8
  108. package/ts/00_commitinfo_data.ts +1 -1
  109. package/ts/aglapi/aglapisurface.document.ts +113 -15
  110. package/ts/aglapi/interfaces.ts +6 -0
  111. package/ts/classes.authstore.ts +13 -0
  112. package/ts/classes.cli.ts +9 -0
  113. package/ts/classes.controller.ts +238 -59
  114. package/ts/classes.harnessoperationmanager.ts +20 -14
  115. package/ts/classes.mcpclient.ts +17 -2
  116. package/ts/classes.mcpcontrollerhost.ts +15 -1
  117. package/ts/classes.mcptools.ts +21 -2
  118. package/ts/classes.mcpvalidation.ts +2 -0
  119. package/ts/classes.ticketstore.ts +312 -13
  120. package/ts/classes.validation.ts +28 -4
  121. package/ts/driver/classes.directreports.ts +58 -3
  122. package/ts/driver/classes.drivereventrelay.ts +2 -1
  123. package/ts/driver/functions.driverinstructions.ts +11 -2
  124. package/ts/driver/functions.drivertools.ts +10 -2
  125. package/ts/fleet/classes.boardpump.ts +235 -28
  126. package/ts/fleet/classes.claudeworkers.ts +36 -15
  127. package/ts/fleet/classes.codexworkers.ts +24 -7
  128. package/ts/fleet/classes.deploymonitor.ts +854 -0
  129. package/ts/fleet/classes.gitfacts.ts +135 -0
  130. package/ts/fleet/classes.releasereconciler.ts +103 -0
  131. package/ts/fleet/classes.service.ts +81 -8
  132. package/ts/fleet/classes.ticketeffects.ts +38 -6
  133. package/ts/fleet/classes.workers.ts +19 -5
  134. package/ts/fleet/functions.controllerbuild.ts +84 -0
  135. package/ts/fleet/functions.deployprobes.ts +84 -0
  136. package/ts/fleet/functions.deployvalidation.ts +50 -0
  137. package/ts/fleet/functions.release.ts +32 -3
  138. package/ts/fleet/functions.releasefacts.ts +91 -0
  139. package/ts/fleet/functions.validation.ts +3 -6
  140. package/ts/fleet/functions.watchprobes.ts +6 -8
  141. package/ts/fleet/functions.workervalidation.ts +3 -2
  142. package/ts/fleet/interfaces.workers.ts +23 -3
  143. package/ts/functions.deploycli.ts +151 -0
  144. package/ts/functions.mcpdeploytools.ts +18 -0
  145. package/ts/functions.mcptickettools.ts +7 -6
  146. package/ts/functions.ticketautolabels.ts +10 -2
  147. package/ts/functions.ticketcli.ts +100 -24
  148. package/ts/functions.ticketvalidation.ts +26 -7
  149. package/ts_interfaces/deployments.ts +194 -0
  150. package/ts_interfaces/fleet.ts +17 -2
  151. package/ts_interfaces/fleetworkers.ts +20 -0
  152. package/ts_interfaces/interfaces.ts +3 -1
  153. package/ts_interfaces/mcprequests.ts +3 -0
  154. package/ts_interfaces/requests.directreports.ts +52 -8
  155. package/ts_interfaces/requests.tickets.ts +20 -4
  156. package/ts_interfaces/requests.ts +6 -1
  157. package/ts_interfaces/tickets.ts +53 -6
  158. package/ts_migration/classes.documentmigrationrunner.ts +15 -0
  159. package/ts_migration/index.ts +2 -0
  160. package/ts_migration/v41_ticketclosedcolumn.ts +106 -0
  161. package/ts_migration/v41_ticketlinkrepos.ts +91 -0
  162. package/ts_web/00_commitinfo_data.ts +1 -1
  163. package/ts_web/elements.deployments.ts +1066 -0
  164. package/ts_web/elements.directreport.ts +2 -2
  165. package/ts_web/elements.directreportsession.ts +5 -5
  166. package/ts_web/elements.harnesscontrollerapp.ts +179 -13
  167. package/ts_web/elements.makedirectreport.ts +444 -0
  168. package/ts_web/elements.nativesession.ts +29 -1
  169. package/ts_web/elements.ticketboard.ts +74 -18
  170. package/ts_web/functions.deployments.ts +225 -0
  171. package/ts_web/functions.sessionchat.ts +2 -0
@@ -0,0 +1,61 @@
1
+ import type { IFleetRepository } from '../../dist_ts_interfaces/fleet.js';
2
+ import type { IFleetDeployRelease } from '../../dist_ts_interfaces/deployments.js';
3
+ import type { TTicketData } from '../../dist_ts_interfaces/tickets.js';
4
+ import { type TFleetGitRunner } from './functions.releasefacts.js';
5
+ /**
6
+ * Where fleet mirrors a remote's release tags: refs of its own, pruned to what the remote holds, so a tag that exists
7
+ * only in a checkout is never a release, and the checkout's own tags are left as they are.
8
+ */
9
+ export declare const fleetRemoteTagRefs = "refs/agl/remote-tags";
10
+ /**
11
+ * Where fleet's deploy monitor mirrors remote main: a ref of its own, so its fetch never takes the lock of the
12
+ * `refs/remotes/<remote>/main` that a fleet land or release pushes and checks; racing one, it would fail its pass.
13
+ */
14
+ export declare const fleetRemoteMainRef = "refs/agl/remote-main";
15
+ /** The columns whose tickets have landed; a ticket elsewhere has no landed commit, whatever it links. */
16
+ export declare const fleetLandedColumns: readonly TTicketData['columnId'][];
17
+ /** What fleet knows of a repository's remote, as its last fetch left it. */
18
+ export interface IFleetRemoteState {
19
+ /** Remote main's commit. */
20
+ main?: string;
21
+ /** The remote's release tags `v<version>`, newest version first, each with the commit it names. */
22
+ releases: IFleetDeployRelease[];
23
+ }
24
+ /**
25
+ * What git says about the fleet's repositories (AGL-909), always outside a ticket transaction. A release is a tag on
26
+ * the remote: `fetch` mirrors remote main and the remote's `v*` tags into refs of the checkout fleet's own operations
27
+ * never touch (`refs/agl/remote-main`, `refs/agl/remote-tags`, pruned), and every read takes them from there without
28
+ * touching the network. Whether one commit
29
+ * holds another never changes, so it is cached.
30
+ */
31
+ export declare class FleetGitFacts {
32
+ private readonly git;
33
+ private readonly ancestry;
34
+ private readonly firstReleases;
35
+ private readonly digests;
36
+ constructor(git: TFleetGitRunner);
37
+ /**
38
+ * Mirrors the remote's main and release tags; resolves to the failure's text, or undefined. A failed fetch leaves the
39
+ * last mirrored refs as they were.
40
+ */
41
+ fetch(repoArg: IFleetRepository): Promise<string | undefined>;
42
+ /** Remote main and the remote's release tags as the last fetch mirrored them. */
43
+ remote(repoArg: IFleetRepository): Promise<IFleetRemoteState>;
44
+ /** Whether `ancestorArg` is `descendantArg` or one of its ancestors; a commit the checkout lacks is none. */
45
+ isAncestor(repoArg: Pick<IFleetRepository, 'path'>, ancestorArg: string, descendantArg: string): Promise<boolean>;
46
+ /**
47
+ * The commit a ticket landed as in a repository (AGL-909): the newest branch or commit link there whose commit remote
48
+ * main holds, for a ticket in landed, released or closed. A review branch's commit before its rebase, the commit that
49
+ * brought a bug in, a revert on another branch: none of them is a landing, and a ticket elsewhere on the board has
50
+ * none. `mainArg` is remote main's commit, or the commit a release is cut from.
51
+ */
52
+ landedSha(ticketArg: Pick<TTicketData, 'columnId' | 'links'>, repoArg: IFleetRepository, mainArg: string | undefined): Promise<string | undefined>;
53
+ /** The newest branch or commit link of the repository whose commit `mainArg` holds, whatever the ticket's column. */
54
+ newestOnMain(ticketArg: Pick<TTicketData, 'links'>, repoArg: IFleetRepository, mainArg: string): Promise<string | undefined>;
55
+ /**
56
+ * The first release, by version, whose commit holds `shaArg`: where a commit was released ("fixed in"). One git call
57
+ * lists the mirrored tags that hold it; the answer is kept while the remote's tags stay the same.
58
+ */
59
+ firstReleaseContaining(repoArg: IFleetRepository, releasesArg: IFleetDeployRelease[], shaArg: string): Promise<IFleetDeployRelease | undefined>;
60
+ private digest;
61
+ }
@@ -0,0 +1,125 @@
1
+ import * as plugins from '../plugins.js';
2
+ import { compareFleetVersions, fleetRepositoryMatches, fleetVersion } from './functions.releasefacts.js';
3
+ /**
4
+ * Where fleet mirrors a remote's release tags: refs of its own, pruned to what the remote holds, so a tag that exists
5
+ * only in a checkout is never a release, and the checkout's own tags are left as they are.
6
+ */
7
+ export const fleetRemoteTagRefs = 'refs/agl/remote-tags';
8
+ /**
9
+ * Where fleet's deploy monitor mirrors remote main: a ref of its own, so its fetch never takes the lock of the
10
+ * `refs/remotes/<remote>/main` that a fleet land or release pushes and checks; racing one, it would fail its pass.
11
+ */
12
+ export const fleetRemoteMainRef = 'refs/agl/remote-main';
13
+ /** The columns whose tickets have landed; a ticket elsewhere has no landed commit, whatever it links. */
14
+ export const fleetLandedColumns = ['landed', 'released', 'closed'];
15
+ const fullSha = /^(?:[a-f0-9]{40}|[a-f0-9]{64})$/u;
16
+ const ancestryCacheSize = 50_000;
17
+ /**
18
+ * What git says about the fleet's repositories (AGL-909), always outside a ticket transaction. A release is a tag on
19
+ * the remote: `fetch` mirrors remote main and the remote's `v*` tags into refs of the checkout fleet's own operations
20
+ * never touch (`refs/agl/remote-main`, `refs/agl/remote-tags`, pruned), and every read takes them from there without
21
+ * touching the network. Whether one commit
22
+ * holds another never changes, so it is cached.
23
+ */
24
+ export class FleetGitFacts {
25
+ git;
26
+ ancestry = new Map();
27
+ firstReleases = new Map();
28
+ digests = new WeakMap();
29
+ constructor(git) {
30
+ this.git = git;
31
+ }
32
+ /**
33
+ * Mirrors the remote's main and release tags; resolves to the failure's text, or undefined. A failed fetch leaves the
34
+ * last mirrored refs as they were.
35
+ */
36
+ async fetch(repoArg) {
37
+ // `--refmap=` keeps git from also updating the remote-tracking branch, and no FETCH_HEAD is written.
38
+ const result = await this.git('git', ['fetch', '--quiet', '--no-tags', '--prune', '--no-write-fetch-head', '--refmap=', repoArg.remote,
39
+ `+refs/heads/main:${fleetRemoteMainRef}`, `+refs/tags/v*:${fleetRemoteTagRefs}/v*`], repoArg.path);
40
+ return result.code === 0 ? undefined : (result.stderr.trim() || `git fetch exited with ${result.code}`).slice(0, 512);
41
+ }
42
+ /** Remote main and the remote's release tags as the last fetch mirrored them. */
43
+ async remote(repoArg) {
44
+ const main = await this.git('git', ['rev-parse', '--verify', '--quiet', `${fleetRemoteMainRef}^{commit}`], repoArg.path);
45
+ const tags = await this.git('git', ['for-each-ref', '--format=%(refname:lstrip=3)%09%(objectname)%09%(*objectname)%09%(creatordate:iso-strict)',
46
+ `${fleetRemoteTagRefs}/v*`], repoArg.path);
47
+ const releases = [];
48
+ if (tags.code === 0) {
49
+ for (const line of tags.stdout.split('\n')) {
50
+ const [name = '', object = '', peeled = '', taggedAt = ''] = line.split('\t');
51
+ const version = fleetVersion(name);
52
+ if (!version || !name.startsWith('v'))
53
+ continue;
54
+ releases.push({ version, sha: peeled || object, ...(taggedAt ? { taggedAt: new Date(taggedAt).toISOString() } : {}) });
55
+ }
56
+ }
57
+ const sha = main.code === 0 ? main.stdout.trim() : '';
58
+ return { ...(fullSha.test(sha) ? { main: sha } : {}), releases: releases.sort((leftArg, rightArg) => compareFleetVersions(rightArg.version, leftArg.version)) };
59
+ }
60
+ /** Whether `ancestorArg` is `descendantArg` or one of its ancestors; a commit the checkout lacks is none. */
61
+ async isAncestor(repoArg, ancestorArg, descendantArg) {
62
+ const key = `${repoArg.path}\0${ancestorArg}\0${descendantArg}`;
63
+ const known = this.ancestry.get(key);
64
+ if (known !== undefined)
65
+ return known;
66
+ const result = await this.git('git', ['merge-base', '--is-ancestor', ancestorArg, descendantArg], repoArg.path);
67
+ // 0 and 1 are answers; anything else (an unknown commit) is no answer to keep.
68
+ if (result.code === 1 || result.code === 0) {
69
+ if (fullSha.test(ancestorArg) && fullSha.test(descendantArg)) {
70
+ if (this.ancestry.size >= ancestryCacheSize)
71
+ this.ancestry.clear();
72
+ this.ancestry.set(key, result.code === 0);
73
+ }
74
+ }
75
+ return result.code === 0;
76
+ }
77
+ /**
78
+ * The commit a ticket landed as in a repository (AGL-909): the newest branch or commit link there whose commit remote
79
+ * main holds, for a ticket in landed, released or closed. A review branch's commit before its rebase, the commit that
80
+ * brought a bug in, a revert on another branch: none of them is a landing, and a ticket elsewhere on the board has
81
+ * none. `mainArg` is remote main's commit, or the commit a release is cut from.
82
+ */
83
+ async landedSha(ticketArg, repoArg, mainArg) {
84
+ if (!mainArg || !fleetLandedColumns.includes(ticketArg.columnId))
85
+ return undefined;
86
+ return await this.newestOnMain(ticketArg, repoArg, mainArg);
87
+ }
88
+ /** The newest branch or commit link of the repository whose commit `mainArg` holds, whatever the ticket's column. */
89
+ async newestOnMain(ticketArg, repoArg, mainArg) {
90
+ for (let index = ticketArg.links.length - 1; index >= 0; index--) {
91
+ const link = ticketArg.links[index];
92
+ if ((link.kind === 'branch' || link.kind === 'commit') && fleetRepositoryMatches(repoArg, link.repo)
93
+ && await this.isAncestor(repoArg, link.sha, mainArg))
94
+ return link.sha;
95
+ }
96
+ return undefined;
97
+ }
98
+ /**
99
+ * The first release, by version, whose commit holds `shaArg`: where a commit was released ("fixed in"). One git call
100
+ * lists the mirrored tags that hold it; the answer is kept while the remote's tags stay the same.
101
+ */
102
+ async firstReleaseContaining(repoArg, releasesArg, shaArg) {
103
+ const key = `${repoArg.path}\0${shaArg}\0${this.digest(releasesArg)}`;
104
+ if (this.firstReleases.has(key))
105
+ return this.firstReleases.get(key);
106
+ const result = await this.git('git', ['for-each-ref', '--contains', shaArg, '--format=%(refname:lstrip=3)', `${fleetRemoteTagRefs}/v*`], repoArg.path);
107
+ if (result.code !== 0)
108
+ return undefined;
109
+ const containing = new Set(result.stdout.split('\n').map((lineArg) => fleetVersion(lineArg)).filter((valueArg) => valueArg !== undefined));
110
+ const first = [...releasesArg].reverse().find((releaseArg) => containing.has(releaseArg.version));
111
+ if (this.firstReleases.size >= ancestryCacheSize)
112
+ this.firstReleases.clear();
113
+ this.firstReleases.set(key, first);
114
+ return first;
115
+ }
116
+ digest(releasesArg) {
117
+ let digest = this.digests.get(releasesArg);
118
+ if (digest === undefined) {
119
+ digest = plugins.crypto.createHash('sha256').update(JSON.stringify(releasesArg.map((releaseArg) => [releaseArg.version, releaseArg.sha]))).digest('hex');
120
+ this.digests.set(releasesArg, digest);
121
+ }
122
+ return digest;
123
+ }
124
+ }
125
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5naXRmYWN0cy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2ZsZWV0L2NsYXNzZXMuZ2l0ZmFjdHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLE9BQU8sTUFBTSxlQUFlLENBQUM7QUFJekMsT0FBTyxFQUFFLG9CQUFvQixFQUFFLHNCQUFzQixFQUFFLFlBQVksRUFBd0IsTUFBTSw2QkFBNkIsQ0FBQztBQUUvSDs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxzQkFBc0IsQ0FBQztBQUN6RDs7O0dBR0c7QUFDSCxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxzQkFBc0IsQ0FBQztBQUN6RCx5R0FBeUc7QUFDekcsTUFBTSxDQUFDLE1BQU0sa0JBQWtCLEdBQXVDLENBQUMsUUFBUSxFQUFFLFVBQVUsRUFBRSxRQUFRLENBQUMsQ0FBQztBQVV2RyxNQUFNLE9BQU8sR0FBRyxrQ0FBa0MsQ0FBQztBQUNuRCxNQUFNLGlCQUFpQixHQUFHLE1BQU0sQ0FBQztBQUVqQzs7Ozs7O0dBTUc7QUFDSCxNQUFNLE9BQU8sYUFBYTtJQUtLLEdBQUc7SUFKZixRQUFRLEdBQUcsSUFBSSxHQUFHLEVBQW1CLENBQUM7SUFDdEMsYUFBYSxHQUFHLElBQUksR0FBRyxFQUEyQyxDQUFDO0lBQ25FLE9BQU8sR0FBRyxJQUFJLE9BQU8sRUFBaUMsQ0FBQztJQUV4RSxZQUE2QixHQUFvQjttQkFBcEIsR0FBRztJQUFvQixDQUFDO0lBRXJEOzs7T0FHRztJQUNJLEtBQUssQ0FBQyxLQUFLLENBQUMsT0FBeUI7UUFDMUMscUdBQXFHO1FBQ3JHLE1BQU0sTUFBTSxHQUFHLE1BQU0sSUFBSSxDQUFDLEdBQUcsQ0FBQyxLQUFLLEVBQUUsQ0FBQyxPQUFPLEVBQUUsU0FBUyxFQUFFLFdBQVcsRUFBRSxTQUFTLEVBQUUsdUJBQXVCLEVBQUUsV0FBVyxFQUFFLE9BQU8sQ0FBQyxNQUFNO1lBQ3BJ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
@@ -0,0 +1,51 @@
1
+ import type { IFleetRepository } from '../../dist_ts_interfaces/fleet.js';
2
+ import type { IFleetDeployRelease } from '../../dist_ts_interfaces/deployments.js';
3
+ import type { ITicket, ITicketActor, TTicketFleetEvent } from '../../dist_ts_interfaces/tickets.js';
4
+ import type { FleetTicketEffects } from './classes.ticketeffects.js';
5
+ import type { FleetGitFacts, IFleetRemoteState } from './classes.gitfacts.js';
6
+ /** Who the reconciler's release links and moves name. */
7
+ export declare const releaseReconcilerActor: ITicketActor;
8
+ /**
9
+ * The `released` events of one release for one ticket, the only way AGL writes "released" (AGL-909): one per package the
10
+ * release is known to have published, or one without a package, each under the reconciler's actor and a key built from the facts
11
+ * (`release:<org/name>:<version>:<ticket>:<package|->`). The same release with the same packages gives the same events,
12
+ * so each applies once whoever applies it. The packages are what is known: a reconciler pass that runs between the tag
13
+ * reaching the remote and `fleet release` recording what it published writes the event without a package, so that
14
+ * release's own ticket can hold both links, each true.
15
+ */
16
+ export declare const releasedEvents: (ticketKeyArg: string, repoArg: string, releaseArg: IFleetDeployRelease, packagesArg: readonly string[]) => TTicketFleetEvent[];
17
+ /** A ticket the reconciler released: its key, and the repository and version it shipped in. */
18
+ export interface IReleaseReconcilerOutcome {
19
+ ticketKey: string;
20
+ repo: string;
21
+ version: string;
22
+ }
23
+ /**
24
+ * The one writer of "released" for work that landed (AGL-909, Linus #2). For every repository a landed or released
25
+ * ticket's code landed in whose release the ticket does not link yet, it finds the first tag on the remote that holds
26
+ * the ticket's landed commit there, whoever cut the tag (fleet, gitzone by hand, CI), and links it with `releasedEvents`.
27
+ * A ticket moves to released on its first tag; every other repository's release is linked as its tag appears, so each
28
+ * repository's deploy targets count it. Each event's key is built from the facts, so whichever pass or controller
29
+ * applies it, it applies once.
30
+ */
31
+ export declare class ReleaseReconciler {
32
+ private readonly facts;
33
+ private readonly effects;
34
+ constructor(facts: FleetGitFacts, effects: FleetTicketEffects);
35
+ /**
36
+ * The tickets the reconciler would release, in board order: each landed or released ticket with the repositories its
37
+ * code links name whose release it does not link yet.
38
+ */
39
+ static candidates(ticketsArg: ITicket[], repositoriesArg: IFleetRepository[]): {
40
+ ticket: ITicket;
41
+ repos: IFleetRepository[];
42
+ }[];
43
+ /**
44
+ * One pass: `remotesArg` holds each repository's remote as the pass fetched it. Resolves with the tickets it released;
45
+ * one ticket's failure is logged and leaves it to the next pass.
46
+ */
47
+ reconcile(ownerArg: string, candidatesArg: {
48
+ ticket: ITicket;
49
+ repos: IFleetRepository[];
50
+ }[], remotesArg: Map<string, IFleetRemoteState>, signalArg: AbortSignal): Promise<IReleaseReconcilerOutcome[]>;
51
+ }
@@ -0,0 +1,101 @@
1
+ import { findFleetRepository, fleetReleaseLinkMatches, fleetRepositorySlug } from './functions.releasefacts.js';
2
+ /** Who the reconciler's release links and moves name. */
3
+ export const releaseReconcilerActor = { id: 'agl:release-reconciler', name: 'AGL release reconciler', role: 'driver' };
4
+ /**
5
+ * The `released` events of one release for one ticket, the only way AGL writes "released" (AGL-909): one per package the
6
+ * release is known to have published, or one without a package, each under the reconciler's actor and a key built from the facts
7
+ * (`release:<org/name>:<version>:<ticket>:<package|->`). The same release with the same packages gives the same events,
8
+ * so each applies once whoever applies it. The packages are what is known: a reconciler pass that runs between the tag
9
+ * reaching the remote and `fleet release` recording what it published writes the event without a package, so that
10
+ * release's own ticket can hold both links, each true.
11
+ */
12
+ export const releasedEvents = (ticketKeyArg, repoArg, releaseArg, packagesArg) => {
13
+ const packages = [...new Set(packagesArg)].sort();
14
+ return (packages.length ? packages : [undefined]).map((packageName) => ({
15
+ ticketKey: ticketKeyArg, actor: releaseReconcilerActor, kind: 'released', version: releaseArg.version, repo: repoArg, sha: releaseArg.sha,
16
+ ...(packageName === undefined ? {} : { package: packageName }),
17
+ idempotencyKey: `release:${repoArg}:${releaseArg.version}:${ticketKeyArg}:${packageName ?? '-'}`.slice(0, 256),
18
+ }));
19
+ };
20
+ /**
21
+ * The one writer of "released" for work that landed (AGL-909, Linus #2). For every repository a landed or released
22
+ * ticket's code landed in whose release the ticket does not link yet, it finds the first tag on the remote that holds
23
+ * the ticket's landed commit there, whoever cut the tag (fleet, gitzone by hand, CI), and links it with `releasedEvents`.
24
+ * A ticket moves to released on its first tag; every other repository's release is linked as its tag appears, so each
25
+ * repository's deploy targets count it. Each event's key is built from the facts, so whichever pass or controller
26
+ * applies it, it applies once.
27
+ */
28
+ export class ReleaseReconciler {
29
+ facts;
30
+ effects;
31
+ constructor(facts, effects) {
32
+ this.facts = facts;
33
+ this.effects = effects;
34
+ }
35
+ /**
36
+ * The tickets the reconciler would release, in board order: each landed or released ticket with the repositories its
37
+ * code links name whose release it does not link yet.
38
+ */
39
+ static candidates(ticketsArg, repositoriesArg) {
40
+ return ticketsArg.flatMap((ticketArg) => {
41
+ if (ticketArg.columnId !== 'landed' && ticketArg.columnId !== 'released')
42
+ return [];
43
+ const repos = new Map();
44
+ for (const link of ticketArg.links) {
45
+ if (link.kind !== 'branch' && link.kind !== 'commit')
46
+ continue;
47
+ const repo = findFleetRepository(repositoriesArg, link.repo);
48
+ if (repo && !ticketArg.links.some((linkArg) => linkArg.kind === 'release' && fleetReleaseLinkMatches(linkArg, repo)))
49
+ repos.set(repo.path, repo);
50
+ }
51
+ return repos.size ? [{ ticket: ticketArg, repos: [...repos.values()] }] : [];
52
+ });
53
+ }
54
+ /**
55
+ * One pass: `remotesArg` holds each repository's remote as the pass fetched it. Resolves with the tickets it released;
56
+ * one ticket's failure is logged and leaves it to the next pass.
57
+ */
58
+ async reconcile(ownerArg, candidatesArg, remotesArg, signalArg) {
59
+ const outcomes = [];
60
+ // What a release published is known only where a fleet release said so; the repository's packages today are not.
61
+ const published = new Map();
62
+ const packagesOf = (slugArg, versionArg) => {
63
+ const key = `${slugArg}@${versionArg}`;
64
+ if (!published.has(key))
65
+ published.set(key, this.effects.publishedPackages(ownerArg, slugArg, versionArg));
66
+ return published.get(key);
67
+ };
68
+ for (const { ticket, repos } of candidatesArg) {
69
+ signalArg.throwIfAborted();
70
+ for (const repo of repos) {
71
+ const remote = remotesArg.get(repo.path);
72
+ if (!remote?.main)
73
+ continue;
74
+ try {
75
+ const landed = await this.facts.landedSha(ticket, repo, remote.main);
76
+ const release = landed ? await this.facts.firstReleaseContaining(repo, remote.releases, landed) : undefined;
77
+ if (!release)
78
+ continue;
79
+ const slug = fleetRepositorySlug(repo);
80
+ const events = releasedEvents(ticket.key, slug, release, await packagesOf(slug, release.version));
81
+ let applied = true;
82
+ for (const event of events) {
83
+ const prepared = await this.effects.prepare(ownerArg, event);
84
+ const { effect } = prepared.state === 'applied' ? { effect: { state: 'applied' } } : await this.effects.dispatch(prepared, signalArg);
85
+ if (effect.state !== 'applied')
86
+ applied = false;
87
+ }
88
+ if (applied)
89
+ outcomes.push({ ticketKey: ticket.key, repo: slug, version: release.version });
90
+ }
91
+ catch (errorArg) {
92
+ if (signalArg.aborted)
93
+ throw errorArg;
94
+ console.error(`Releasing ${ticket.key} from the tags of ${repo.id} failed.`, errorArg);
95
+ }
96
+ }
97
+ }
98
+ return outcomes;
99
+ }
100
+ }
101
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5yZWxlYXNlcmVjb25jaWxlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2ZsZWV0L2NsYXNzZXMucmVsZWFzZXJlY29uY2lsZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBS0EsT0FBTyxFQUFFLG1CQUFtQixFQUFFLHVCQUF1QixFQUFFLG1CQUFtQixFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFFaEgseURBQXlEO0FBQ3pELE1BQU0sQ0FBQyxNQUFNLHNCQUFzQixHQUFpQixFQUFFLEVBQUUsRUFBRSx3QkFBd0IsRUFBRSxJQUFJLEVBQUUsd0JBQXdCLEVBQUUsSUFBSSxFQUFFLFFBQVEsRUFBRSxDQUFDO0FBRXJJOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLENBQUMsTUFBTSxjQUFjLEdBQUcsQ0FBQyxZQUFvQixFQUFFLE9BQWUsRUFBRSxVQUErQixFQUFFLFdBQThCLEVBQXVCLEVBQUU7SUFDNUosTUFBTSxRQUFRLEdBQUcsQ0FBQyxHQUFHLElBQUksR0FBRyxDQUFDLFdBQVcsQ0FBQyxDQUFDLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDbEQsT0FBTyxDQUFDLFFBQVEsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLEdBQUcsQ0FBQyxDQUFDLFdBQVcsRUFBcUIsRUFBRSxDQUFDLENBQUM7UUFDekYsU0FBUyxFQUFFLFlBQVksRUFBRSxLQUFLLEVBQUUsc0JBQXNCLEVBQUUsSUFBSSxFQUFFLFVBQVUsRUFBRSxPQUFPLEVBQUUsVUFBVSxDQUFDLE9BQU8sRUFBRSxJQUFJLEVBQUUsT0FBTyxFQUFFLEdBQUcsRUFBRSxVQUFVLENBQUMsR0FBRztRQUN6SSxHQUFHLENBQUMsV0FBVyxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLE9BQU8sRUFBRSxXQUFXLEVBQUUsQ0FBQztRQUM5RCxj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
@@ -1,6 +1,6 @@
1
1
  import type { IFleetScope, IFleetRepository, IFleetOperation, TFleetOperation, TFleetRequest, TFleetResult, IFleetUnboundDriver } from '../../dist_ts_interfaces/fleet.js';
2
2
  import { type TFleetRunner } from './classes.runtime.js';
3
- import type { ITicketActor } from '../../dist_ts_interfaces/tickets.js';
3
+ import type { ITicket, ITicketActor } from '../../dist_ts_interfaces/tickets.js';
4
4
  import type { FleetTicketEffects } from './classes.ticketeffects.js';
5
5
  export interface IFleetServiceOptions {
6
6
  runner?: TFleetRunner;
@@ -13,6 +13,10 @@ export interface IFleetServiceOptions {
13
13
  drivers: IFleetUnboundDriver[];
14
14
  errors: string[];
15
15
  }>;
16
+ /** The board's tickets: a release checks their release plans and names the landed ones it ships. */
17
+ tickets?: (signal: AbortSignal) => Promise<ITicket[]>;
18
+ /** A release went out: the release reconciler links and releases the landed tickets its tag holds, now rather than at its next pass. */
19
+ released?: (repo: IFleetRepository) => void;
16
20
  }
17
21
  /** A repository's `environmentFrom` names the host values in the configuration first; the rest come from the controller's environment. */
18
22
  export declare const withHostEnvironment: (repo: IFleetRepository, host?: Record<string, string>) => IFleetRepository;
@@ -28,6 +32,14 @@ export declare class FleetService {
28
32
  status(id: string, owner: string, ticketKey?: string): IFleetOperation;
29
33
  close(): Promise<void>;
30
34
  execute<T extends TFleetOperation>(operation: T, request: TFleetRequest<T>, scope: IFleetScope, running?: () => void, owner?: string): Promise<TFleetResult<T>>;
35
+ /**
36
+ * The checks a release makes against the board (AGL-909): its own ticket is no deploy ticket, its release plan must
37
+ * name this repository and the version gitzone plans, and its newest code link here must be on the commit the release
38
+ * is cut from (a review branch that never landed is not released); every landed ticket the release holds is named
39
+ * before it publishes, and one whose plan names another version of this repository stops it. Nothing is read from the
40
+ * board after it publishes.
41
+ */
42
+ private releaseGuard;
31
43
  private exclusive;
32
44
  private land;
33
45
  private landWorktree;