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.
- package/changelog.md +16 -0
- package/dist_serve/bundle.js +6697 -5287
- package/dist_serve/bundle.js.map +2 -2
- package/dist_serve/bundle.js.third-party-notices.json +29 -29
- package/dist_serve/bundle.js.third-party-notices.txt +29 -29
- package/dist_serve/third-party-notices.md +597 -8
- package/dist_ts/00_commitinfo_data.js +1 -1
- package/dist_ts/aglapi/aglapisurface.document.js +114 -16
- package/dist_ts/aglapi/interfaces.d.ts +30 -0
- package/dist_ts/aglapi/interfaces.js +7 -1
- package/dist_ts/classes.authstore.d.ts +7 -0
- package/dist_ts/classes.authstore.js +12 -1
- package/dist_ts/classes.cli.js +10 -1
- package/dist_ts/classes.controller.d.ts +41 -11
- package/dist_ts/classes.controller.js +224 -48
- package/dist_ts/classes.harnessoperationmanager.d.ts +44 -0
- package/dist_ts/classes.harnessoperationmanager.js +15 -10
- package/dist_ts/classes.mcpclient.d.ts +5 -0
- package/dist_ts/classes.mcpclient.js +15 -3
- package/dist_ts/classes.mcpcontrollerhost.d.ts +3 -0
- package/dist_ts/classes.mcpcontrollerhost.js +14 -2
- package/dist_ts/classes.mcptools.d.ts +4 -3
- package/dist_ts/classes.mcptools.js +20 -1
- package/dist_ts/classes.mcpvalidation.js +4 -1
- package/dist_ts/classes.ticketstore.d.ts +71 -3
- package/dist_ts/classes.ticketstore.js +299 -12
- package/dist_ts/classes.validation.d.ts +2 -0
- package/dist_ts/classes.validation.js +27 -5
- package/dist_ts/driver/classes.directreports.d.ts +23 -3
- package/dist_ts/driver/classes.directreports.js +59 -2
- package/dist_ts/driver/classes.drivereventrelay.js +3 -2
- package/dist_ts/driver/functions.driverinstructions.d.ts +1 -1
- package/dist_ts/driver/functions.driverinstructions.js +12 -3
- package/dist_ts/driver/functions.drivertools.d.ts +4 -0
- package/dist_ts/driver/functions.drivertools.js +8 -2
- package/dist_ts/fleet/classes.boardpump.d.ts +53 -3
- package/dist_ts/fleet/classes.boardpump.js +237 -32
- package/dist_ts/fleet/classes.claudeworkers.d.ts +10 -3
- package/dist_ts/fleet/classes.claudeworkers.js +43 -19
- package/dist_ts/fleet/classes.codexworkers.d.ts +5 -3
- package/dist_ts/fleet/classes.codexworkers.js +26 -9
- package/dist_ts/fleet/classes.deploymonitor.d.ts +253 -0
- package/dist_ts/fleet/classes.deploymonitor.js +821 -0
- package/dist_ts/fleet/classes.gitfacts.d.ts +61 -0
- package/dist_ts/fleet/classes.gitfacts.js +125 -0
- package/dist_ts/fleet/classes.releasereconciler.d.ts +51 -0
- package/dist_ts/fleet/classes.releasereconciler.js +101 -0
- package/dist_ts/fleet/classes.service.d.ts +13 -1
- package/dist_ts/fleet/classes.service.js +76 -7
- package/dist_ts/fleet/classes.ticketeffects.d.ts +13 -0
- package/dist_ts/fleet/classes.ticketeffects.js +42 -8
- package/dist_ts/fleet/classes.workers.d.ts +10 -3
- package/dist_ts/fleet/classes.workers.js +18 -3
- package/dist_ts/fleet/functions.controllerbuild.d.ts +23 -0
- package/dist_ts/fleet/functions.controllerbuild.js +75 -0
- package/dist_ts/fleet/functions.deployprobes.d.ts +39 -0
- package/dist_ts/fleet/functions.deployprobes.js +82 -0
- package/dist_ts/fleet/functions.deployvalidation.d.ts +27 -0
- package/dist_ts/fleet/functions.deployvalidation.js +43 -0
- package/dist_ts/fleet/functions.release.d.ts +2 -1
- package/dist_ts/fleet/functions.release.js +32 -5
- package/dist_ts/fleet/functions.releasefacts.d.ts +45 -0
- package/dist_ts/fleet/functions.releasefacts.js +68 -0
- package/dist_ts/fleet/functions.validation.d.ts +3 -3
- package/dist_ts/fleet/functions.validation.js +4 -7
- package/dist_ts/fleet/functions.watchprobes.js +7 -9
- package/dist_ts/fleet/functions.workervalidation.js +4 -3
- package/dist_ts/fleet/interfaces.workers.d.ts +30 -3
- package/dist_ts/fleet/interfaces.workers.js +14 -1
- package/dist_ts/functions.deploycli.d.ts +33 -0
- package/dist_ts/functions.deploycli.js +155 -0
- package/dist_ts/functions.mcpdeploytools.d.ts +13 -0
- package/dist_ts/functions.mcpdeploytools.js +16 -0
- package/dist_ts/functions.mcptickettools.d.ts +54 -0
- package/dist_ts/functions.mcptickettools.js +8 -7
- package/dist_ts/functions.ticketautolabels.d.ts +2 -0
- package/dist_ts/functions.ticketautolabels.js +9 -3
- package/dist_ts/functions.ticketcli.d.ts +16 -2
- package/dist_ts/functions.ticketcli.js +105 -27
- package/dist_ts/functions.ticketvalidation.d.ts +55 -0
- package/dist_ts/functions.ticketvalidation.js +26 -8
- package/dist_ts_interfaces/deployments.d.ts +241 -0
- package/dist_ts_interfaces/deployments.js +5 -6
- package/dist_ts_interfaces/fleet.d.ts +12 -0
- package/dist_ts_interfaces/fleetworkers.d.ts +21 -1
- package/dist_ts_interfaces/interfaces.d.ts +4 -2
- package/dist_ts_interfaces/interfaces.js +4 -2
- package/dist_ts_interfaces/mcprequests.d.ts +3 -2
- package/dist_ts_interfaces/mcprequests.js +3 -1
- package/dist_ts_interfaces/requests.d.ts +3 -2
- package/dist_ts_interfaces/requests.directreports.d.ts +58 -6
- package/dist_ts_interfaces/requests.js +1 -1
- package/dist_ts_interfaces/requests.tickets.d.ts +25 -5
- package/dist_ts_interfaces/requests.tickets.js +2 -2
- package/dist_ts_interfaces/tickets.d.ts +71 -6
- package/dist_ts_interfaces/tickets.js +34 -6
- package/dist_ts_migration/classes.documentmigrationrunner.d.ts +7 -0
- package/dist_ts_migration/classes.documentmigrationrunner.js +14 -1
- package/dist_ts_migration/index.d.ts +2 -0
- package/dist_ts_migration/index.js +3 -1
- package/dist_ts_migration/v41_ticketclosedcolumn.d.ts +20 -0
- package/dist_ts_migration/v41_ticketclosedcolumn.js +118 -0
- package/dist_ts_migration/v41_ticketlinkrepos.d.ts +24 -0
- package/dist_ts_migration/v41_ticketlinkrepos.js +101 -0
- package/package.json +6 -2
- package/readme.md +306 -36
- package/third-party-notices.md +597 -8
- package/ts/00_commitinfo_data.ts +1 -1
- package/ts/aglapi/aglapisurface.document.ts +113 -15
- package/ts/aglapi/interfaces.ts +6 -0
- package/ts/classes.authstore.ts +13 -0
- package/ts/classes.cli.ts +9 -0
- package/ts/classes.controller.ts +238 -59
- package/ts/classes.harnessoperationmanager.ts +20 -14
- package/ts/classes.mcpclient.ts +17 -2
- package/ts/classes.mcpcontrollerhost.ts +15 -1
- package/ts/classes.mcptools.ts +21 -2
- package/ts/classes.mcpvalidation.ts +2 -0
- package/ts/classes.ticketstore.ts +312 -13
- package/ts/classes.validation.ts +28 -4
- package/ts/driver/classes.directreports.ts +58 -3
- package/ts/driver/classes.drivereventrelay.ts +2 -1
- package/ts/driver/functions.driverinstructions.ts +11 -2
- package/ts/driver/functions.drivertools.ts +10 -2
- package/ts/fleet/classes.boardpump.ts +235 -28
- package/ts/fleet/classes.claudeworkers.ts +36 -15
- package/ts/fleet/classes.codexworkers.ts +24 -7
- package/ts/fleet/classes.deploymonitor.ts +854 -0
- package/ts/fleet/classes.gitfacts.ts +135 -0
- package/ts/fleet/classes.releasereconciler.ts +103 -0
- package/ts/fleet/classes.service.ts +81 -8
- package/ts/fleet/classes.ticketeffects.ts +38 -6
- package/ts/fleet/classes.workers.ts +19 -5
- package/ts/fleet/functions.controllerbuild.ts +84 -0
- package/ts/fleet/functions.deployprobes.ts +84 -0
- package/ts/fleet/functions.deployvalidation.ts +50 -0
- package/ts/fleet/functions.release.ts +32 -3
- package/ts/fleet/functions.releasefacts.ts +91 -0
- package/ts/fleet/functions.validation.ts +3 -6
- package/ts/fleet/functions.watchprobes.ts +6 -8
- package/ts/fleet/functions.workervalidation.ts +3 -2
- package/ts/fleet/interfaces.workers.ts +23 -3
- package/ts/functions.deploycli.ts +151 -0
- package/ts/functions.mcpdeploytools.ts +18 -0
- package/ts/functions.mcptickettools.ts +7 -6
- package/ts/functions.ticketautolabels.ts +10 -2
- package/ts/functions.ticketcli.ts +100 -24
- package/ts/functions.ticketvalidation.ts +26 -7
- package/ts_interfaces/deployments.ts +194 -0
- package/ts_interfaces/fleet.ts +17 -2
- package/ts_interfaces/fleetworkers.ts +20 -0
- package/ts_interfaces/interfaces.ts +3 -1
- package/ts_interfaces/mcprequests.ts +3 -0
- package/ts_interfaces/requests.directreports.ts +52 -8
- package/ts_interfaces/requests.tickets.ts +20 -4
- package/ts_interfaces/requests.ts +6 -1
- package/ts_interfaces/tickets.ts +53 -6
- package/ts_migration/classes.documentmigrationrunner.ts +15 -0
- package/ts_migration/index.ts +2 -0
- package/ts_migration/v41_ticketclosedcolumn.ts +106 -0
- package/ts_migration/v41_ticketlinkrepos.ts +91 -0
- package/ts_web/00_commitinfo_data.ts +1 -1
- package/ts_web/elements.deployments.ts +1066 -0
- package/ts_web/elements.directreport.ts +2 -2
- package/ts_web/elements.directreportsession.ts +5 -5
- package/ts_web/elements.harnesscontrollerapp.ts +179 -13
- package/ts_web/elements.makedirectreport.ts +444 -0
- package/ts_web/elements.nativesession.ts +29 -1
- package/ts_web/elements.ticketboard.ts +74 -18
- package/ts_web/functions.deployments.ts +225 -0
- 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;
|