@git.zone/cli 7.2.6 → 7.3.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 (43) hide show
  1. package/assets/templates/npm/.package.json +1 -1
  2. package/assets/templates/service/.package.json +1 -1
  3. package/assets/templates/wcc/.package.json +1 -1
  4. package/assets/templates/website/.package.json +1 -1
  5. package/dist_ts/00_commitinfo_data.js +1 -1
  6. package/dist_ts/helpers.climode.js +2 -1
  7. package/dist_ts/helpers.workflow.d.ts +19 -1
  8. package/dist_ts/helpers.workflow.js +31 -2
  9. package/dist_ts/mod_config/index.js +18 -2
  10. package/dist_ts/mod_release/classes.detachedrelease.d.ts +85 -0
  11. package/dist_ts/mod_release/classes.detachedrelease.js +506 -0
  12. package/dist_ts/mod_release/classes.releasejournal.d.ts +34 -0
  13. package/dist_ts/mod_release/classes.releasejournal.js +134 -2
  14. package/dist_ts/mod_release/helpers.giteaassets.d.ts +19 -0
  15. package/dist_ts/mod_release/helpers.giteaassets.js +53 -4
  16. package/dist_ts/mod_release/helpers.gitremote.d.ts +52 -0
  17. package/dist_ts/mod_release/helpers.gitremote.js +87 -0
  18. package/dist_ts/mod_release/helpers.releasebranch.d.ts +5 -0
  19. package/dist_ts/mod_release/helpers.releasebranch.js +39 -15
  20. package/dist_ts/mod_release/helpers.releasepreparation.js +18 -8
  21. package/dist_ts/mod_release/helpers.releasepublication.d.ts +3 -0
  22. package/dist_ts/mod_release/helpers.releasepublication.js +19 -15
  23. package/dist_ts/mod_release/index.js +303 -66
  24. package/dist_ts/mod_services/classes.interprocesslock.d.ts +12 -0
  25. package/dist_ts/mod_services/classes.interprocesslock.js +35 -12
  26. package/dist_ts/paths.d.ts +6 -0
  27. package/dist_ts/paths.js +7 -1
  28. package/package.json +4 -4
  29. package/readme.md +158 -21
  30. package/ts/00_commitinfo_data.ts +1 -1
  31. package/ts/helpers.climode.ts +1 -0
  32. package/ts/helpers.workflow.ts +50 -0
  33. package/ts/mod_config/index.ts +19 -0
  34. package/ts/mod_release/classes.detachedrelease.ts +655 -0
  35. package/ts/mod_release/classes.releasejournal.ts +181 -1
  36. package/ts/mod_release/helpers.giteaassets.ts +67 -5
  37. package/ts/mod_release/helpers.gitremote.ts +147 -0
  38. package/ts/mod_release/helpers.releasebranch.ts +75 -30
  39. package/ts/mod_release/helpers.releasepreparation.ts +25 -7
  40. package/ts/mod_release/helpers.releasepublication.ts +27 -36
  41. package/ts/mod_release/index.ts +443 -87
  42. package/ts/mod_services/classes.interprocesslock.ts +44 -15
  43. package/ts/paths.ts +10 -0
@@ -0,0 +1,506 @@
1
+ import * as plugins from "./mod.plugins.js";
2
+ import * as paths from "../paths.js";
3
+ import { InterProcessLock } from "../mod_services/classes.interprocesslock.js";
4
+ import { ReleaseJournalStore, resolveGitCommonDirectory, } from "./classes.releasejournal.js";
5
+ /**
6
+ * A detached release runs as two processes in a session of their own: a
7
+ * supervisor, which holds the project's detached-release lock, and the release
8
+ * itself (the worker), the supervisor's child. The supervisor records the run
9
+ * beside the release journals, writes the worker's output to the run's log, and
10
+ * records how the worker ended, also when it was killed.
11
+ *
12
+ * <release storage>/detached.lock held by the supervisor for the run
13
+ * <release storage>/detached/<id>.json the run record
14
+ * <release storage>/detached/<id>.log stdout and stderr of the release
15
+ */
16
+ export const detachedReleaseRunKind = "gitzone-release-detached-run";
17
+ /** Names the supervisor role and carries its launch data; never inherited by the worker. */
18
+ const supervisorEnvironmentKey = "GITZONE_RELEASE_DETACHED_SUPERVISOR";
19
+ const runIdPattern = /^[0-9a-f]{32}$/;
20
+ const supervisorStartTimeoutMs = 60_000;
21
+ /** How long a supervisor the launcher terminates has before it is killed. */
22
+ const supervisorStopTimeoutMs = 10_000;
23
+ const forwardedSignals = ["SIGHUP", "SIGINT", "SIGTERM"];
24
+ const isPlainObject = (valueArg) => typeof valueArg === "object" && valueArg !== null && !Array.isArray(valueArg);
25
+ const isTimestamp = (valueArg) => typeof valueArg === "string" &&
26
+ !Number.isNaN(Date.parse(valueArg)) &&
27
+ new Date(valueArg).toISOString() === valueArg;
28
+ const isPid = (valueArg) => Number.isSafeInteger(valueArg) && valueArg > 0;
29
+ const isExitCode = (valueArg) => Number.isSafeInteger(valueArg) &&
30
+ valueArg >= 0 &&
31
+ valueArg <= 255;
32
+ const isSignalName = (valueArg) => typeof valueArg === "string" &&
33
+ Object.hasOwn(plugins.os.constants.signals, valueArg);
34
+ const runKeys = [
35
+ "kind",
36
+ "id",
37
+ "command",
38
+ "version",
39
+ "cwd",
40
+ "supervisorPid",
41
+ "workerPid",
42
+ "logPath",
43
+ "startedAt",
44
+ "state",
45
+ "exitCode",
46
+ "signal",
47
+ "finishedAt",
48
+ ];
49
+ export const assertDetachedReleaseRun = (valueArg) => {
50
+ if (!isPlainObject(valueArg) ||
51
+ Object.keys(valueArg).length !== runKeys.length ||
52
+ runKeys.some((keyArg) => !Object.hasOwn(valueArg, keyArg))) {
53
+ throw new Error("Detached release run record has an invalid shape.");
54
+ }
55
+ const run = valueArg;
56
+ const finished = run.state === "succeeded" || run.state === "failed";
57
+ if (run.kind !== detachedReleaseRunKind ||
58
+ typeof run.id !== "string" ||
59
+ !runIdPattern.test(run.id) ||
60
+ !Array.isArray(run.command) ||
61
+ run.command.some((argArg) => typeof argArg !== "string") ||
62
+ typeof run.version !== "string" ||
63
+ typeof run.cwd !== "string" ||
64
+ !plugins.path.isAbsolute(run.cwd) ||
65
+ !isPid(run.supervisorPid) ||
66
+ !isPid(run.workerPid) ||
67
+ typeof run.logPath !== "string" ||
68
+ !plugins.path.isAbsolute(run.logPath) ||
69
+ !isTimestamp(run.startedAt) ||
70
+ !(run.state === "running" || finished) ||
71
+ !(run.exitCode === null || isExitCode(run.exitCode)) ||
72
+ !(run.signal === null || isSignalName(run.signal)) ||
73
+ !(run.finishedAt === null || isTimestamp(run.finishedAt))) {
74
+ throw new Error("Detached release run record is invalid.");
75
+ }
76
+ if (finished !== (run.finishedAt !== null) ||
77
+ (finished && (run.exitCode === null) === (run.signal === null)) ||
78
+ (run.state === "succeeded" && run.exitCode !== 0) ||
79
+ (run.state === "failed" && run.exitCode === 0) ||
80
+ (run.state === "running" && (run.exitCode !== null || run.signal !== null))) {
81
+ throw new Error("Detached release run record states an impossible outcome.");
82
+ }
83
+ return run;
84
+ };
85
+ /** Detached runs of one project, stored beside its release journals. */
86
+ export class DetachedReleaseRuns {
87
+ storageRoot;
88
+ directory;
89
+ lock;
90
+ constructor(releaseStorageRootArg) {
91
+ if (!plugins.path.isAbsolute(releaseStorageRootArg)) {
92
+ throw new Error("Detached release storage requires an absolute path.");
93
+ }
94
+ this.storageRoot = plugins.path.resolve(releaseStorageRootArg);
95
+ this.directory = plugins.path.join(this.storageRoot, "detached");
96
+ this.lock = new InterProcessLock({
97
+ lockPath: plugins.path.join(this.storageRoot, "detached.lock"),
98
+ description: "Detached release of this project",
99
+ // A launch never waits for a running release; it is refused at once.
100
+ timeoutMs: 1,
101
+ });
102
+ }
103
+ getRecordPath(idArg) {
104
+ return plugins.path.join(this.directory, `${this.assertId(idArg)}.json`);
105
+ }
106
+ getLogPath(idArg) {
107
+ return plugins.path.join(this.directory, `${this.assertId(idArg)}.log`);
108
+ }
109
+ async read(idArg) {
110
+ const content = await plugins.fs.readFile(this.getRecordPath(idArg), "utf8");
111
+ const run = assertDetachedReleaseRun(JSON.parse(content));
112
+ if (run.id !== idArg) {
113
+ throw new Error("Detached release run record path and id do not match.");
114
+ }
115
+ return run;
116
+ }
117
+ /** Every recorded run, the latest first. */
118
+ async list() {
119
+ let entries;
120
+ try {
121
+ entries = await plugins.fs.readdir(this.directory);
122
+ }
123
+ catch (error) {
124
+ if (error.code === "ENOENT")
125
+ return [];
126
+ throw new Error("Detached release runs could not be listed.", {
127
+ cause: error,
128
+ });
129
+ }
130
+ const runs = [];
131
+ for (const entry of entries) {
132
+ const match = /^([0-9a-f]{32})\.json$/.exec(entry);
133
+ if (match)
134
+ runs.push(await this.read(match[1]));
135
+ }
136
+ return runs.sort((leftArg, rightArg) => rightArg.startedAt.localeCompare(leftArg.startedAt));
137
+ }
138
+ async write(runArg) {
139
+ const run = assertDetachedReleaseRun(runArg);
140
+ const recordPath = this.getRecordPath(run.id);
141
+ const temporaryPath = `${recordPath}.tmp-${process.pid}-${plugins.crypto.randomBytes(12).toString("hex")}`;
142
+ try {
143
+ await plugins.fs.writeFile(temporaryPath, `${JSON.stringify(run, null, 2)}\n`, { encoding: "utf8", flag: "wx", mode: 0o600 });
144
+ await plugins.fs.rename(temporaryPath, recordPath);
145
+ }
146
+ catch (error) {
147
+ await plugins.fs.rm(temporaryPath, { force: true });
148
+ throw new Error(`Detached release run ${run.id} could not be recorded.`, {
149
+ cause: error,
150
+ });
151
+ }
152
+ }
153
+ /**
154
+ * Refuses to start a release while a detached release of this project runs.
155
+ * The run's own worker, a child of the supervisor that holds the lock, passes.
156
+ */
157
+ async assertNoForeignRun() {
158
+ const holder = await this.lock.readHolder();
159
+ if (!holder || (holder.pid !== null && holder.pid === process.ppid))
160
+ return;
161
+ throw new Error(`A detached release of this project is running (supervisor pid ${holder.pid ?? "unknown"}, started ${holder.createdAt ?? "unknown"}). ` +
162
+ `\`gitzone release inspect\` shows its state. If that process no longer exists, inspect and remove ${this.lock.lockPath}.`);
163
+ }
164
+ assertId(idArg) {
165
+ if (!runIdPattern.test(idArg)) {
166
+ throw new Error("Invalid detached release run id.");
167
+ }
168
+ return idArg;
169
+ }
170
+ }
171
+ /** The detached runs of the repository that contains `cwdArg`. */
172
+ export const openDetachedReleaseRuns = async (cwdArg) => {
173
+ const smartshell = new plugins.smartshell.Smartshell({
174
+ executor: "bash",
175
+ sourceFilePaths: [],
176
+ });
177
+ return new DetachedReleaseRuns(new ReleaseJournalStore(await resolveGitCommonDirectory(smartshell, cwdArg))
178
+ .rootPath);
179
+ };
180
+ /**
181
+ * The worker's arguments: the launcher's own, without `--detach`. Everything
182
+ * after `--` is an operand and stays.
183
+ */
184
+ export const getDetachedWorkerArguments = (rawArgvArg) => {
185
+ const separator = rawArgvArg.indexOf("--");
186
+ const options = separator === -1 ? rawArgvArg : rawArgvArg.slice(0, separator);
187
+ const operands = separator === -1 ? [] : rawArgvArg.slice(separator);
188
+ const workerOptions = options.filter((argArg) => argArg !== "--detach");
189
+ if (workerOptions.length === options.length) {
190
+ throw new Error("--detach must be given as the bare flag on the command line.");
191
+ }
192
+ return [...workerOptions, ...operands];
193
+ };
194
+ const describeExit = (codeArg, signalArg) => codeArg !== null ? `exit code ${codeArg}` : `signal ${signalArg}`;
195
+ /** The supervisor's report, validated; anything else throws. */
196
+ const readSupervisorMessage = (valueArg) => {
197
+ if (isPlainObject(valueArg)) {
198
+ if (valueArg.kind === "refused" && typeof valueArg.error === "string") {
199
+ return { kind: "refused", error: valueArg.error };
200
+ }
201
+ if (valueArg.kind === "started") {
202
+ return { kind: "started", run: assertDetachedReleaseRun(valueArg.run) };
203
+ }
204
+ }
205
+ throw new Error("The detached release supervisor sent an invalid report.");
206
+ };
207
+ const signalProcessGroup = (groupArg, signalArg) => {
208
+ try {
209
+ process.kill(-groupArg, signalArg);
210
+ }
211
+ catch (error) {
212
+ // A group that is gone already has nothing left to stop.
213
+ if (error.code !== "ESRCH")
214
+ throw error;
215
+ }
216
+ };
217
+ /**
218
+ * Starts the supervisor in a new session and returns once it reports the
219
+ * release running, or throws when it refused to start one. A supervisor that
220
+ * does not report in time is terminated with its whole process group before
221
+ * this throws, and the error says whether a release had started.
222
+ */
223
+ export const launchDetachedRelease = async (optionsArg) => {
224
+ const startTimeoutMs = optionsArg.startTimeoutMs ?? supervisorStartTimeoutMs;
225
+ if (!Number.isSafeInteger(startTimeoutMs) || startTimeoutMs <= 0) {
226
+ throw new Error("The supervisor start timeout must be a positive integer.");
227
+ }
228
+ const handoff = { version: optionsArg.version };
229
+ // The supervisor runs the same gitzone build as a plain `node <entry>`, the
230
+ // way the `gitzone` binary does; the launcher's own Node flags (an inspector
231
+ // port, for instance) are not carried over.
232
+ const supervisor = plugins.childProcess.spawn(process.execPath, [paths.cliEntryPath, ...optionsArg.workerArguments], {
233
+ cwd: optionsArg.cwd,
234
+ detached: true,
235
+ stdio: ["ignore", "ignore", "ignore", "ipc"],
236
+ env: {
237
+ ...process.env,
238
+ [supervisorEnvironmentKey]: JSON.stringify(handoff),
239
+ },
240
+ });
241
+ let startTimer;
242
+ let stopTimer;
243
+ try {
244
+ return await new Promise((resolve, reject) => {
245
+ let terminated = false;
246
+ let killed = false;
247
+ let lateReport;
248
+ let lateReportError;
249
+ /** The supervisor did not report in time: stop everything it runs. */
250
+ const terminate = () => {
251
+ const group = supervisor.pid;
252
+ // A supervisor without a pid never started; its `error` rejects.
253
+ if (group === undefined)
254
+ return;
255
+ terminated = true;
256
+ try {
257
+ // The supervisor leads its own process group; the release and
258
+ // everything the release started belong to it as well.
259
+ signalProcessGroup(group, "SIGTERM");
260
+ stopTimer = setTimeout(() => {
261
+ killed = true;
262
+ try {
263
+ signalProcessGroup(group, "SIGKILL");
264
+ }
265
+ catch (error) {
266
+ reject(new Error(`The detached release supervisor (pid ${supervisor.pid}) could not be killed.`, { cause: error }));
267
+ }
268
+ }, supervisorStopTimeoutMs);
269
+ }
270
+ catch (error) {
271
+ reject(new Error(`The detached release supervisor (pid ${supervisor.pid}) did not report within ${startTimeoutMs / 1000} s and could not be terminated.`, { cause: error }));
272
+ }
273
+ };
274
+ /** What the terminated supervisor had done, once it is gone. */
275
+ const describeTermination = () => {
276
+ const stopped = killed
277
+ ? `killed with SIGKILL after it did not stop within ${supervisorStopTimeoutMs / 1000} s of SIGTERM`
278
+ : "terminated";
279
+ const summary = `The detached release supervisor (pid ${supervisor.pid}) did not report within ${startTimeoutMs / 1000} s whether it started the release, so its process group was ${stopped}.`;
280
+ if (lateReport?.kind === "started") {
281
+ return (`${summary} It reported run ${lateReport.run.id} started as it was stopped, so that release was stopped as well. ` +
282
+ `\`gitzone release inspect\` shows the recorded outcome of the run and what the release of v${lateReport.run.version} published.`);
283
+ }
284
+ if (lateReport?.kind === "refused") {
285
+ return `${summary} It had not started the release: ${lateReport.error}`;
286
+ }
287
+ if (lateReportError) {
288
+ return `${summary} Its report could not be read, so whether it had started the release is unknown: \`gitzone release inspect\` lists a run if it did.`;
289
+ }
290
+ if (killed) {
291
+ return (`${summary} Whether it had started the release is unknown: \`gitzone release inspect\` lists a run if it did. ` +
292
+ `If ${optionsArg.runs.lock.lockPath} still exists, the killed supervisor left it; remove it after checking that no process of the run is left.`);
293
+ }
294
+ return `${summary} It had not started the release.`;
295
+ };
296
+ startTimer = setTimeout(terminate, startTimeoutMs);
297
+ supervisor.once("error", (error) => reject(new Error("The detached release supervisor could not be started.", {
298
+ cause: error,
299
+ })));
300
+ supervisor.on("message", (messageArg) => {
301
+ let message;
302
+ try {
303
+ message = readSupervisorMessage(messageArg);
304
+ }
305
+ catch (error) {
306
+ if (terminated)
307
+ lateReportError ??= error;
308
+ else
309
+ reject(error);
310
+ return;
311
+ }
312
+ // Only the first report counts; one arriving while the supervisor is
313
+ // stopped is told with the termination.
314
+ if (terminated)
315
+ lateReport ??= message;
316
+ else if (message.kind === "started")
317
+ resolve(message.run);
318
+ else
319
+ reject(new Error(message.error));
320
+ });
321
+ // `close` follows every report the supervisor sent before it ended.
322
+ supervisor.once("close", (codeArg, signalArg) => reject(new Error(terminated
323
+ ? describeTermination()
324
+ : `The detached release supervisor exited (${describeExit(codeArg, signalArg)}) before it started the release.`)));
325
+ });
326
+ }
327
+ finally {
328
+ clearTimeout(startTimer);
329
+ clearTimeout(stopTimer);
330
+ if (supervisor.connected)
331
+ supervisor.disconnect();
332
+ supervisor.unref();
333
+ }
334
+ };
335
+ export const describeDetachedReleaseLaunch = (runArg) => `Release running detached: run ${runArg.id}, process group ${runArg.supervisorPid}, log ${runArg.logPath}. ` +
336
+ `Follow it with \`tail -f ${runArg.logPath}\`; \`gitzone release inspect\` shows its outcome.`;
337
+ /** True in the process a detached launch started as its supervisor. */
338
+ export const isDetachedReleaseSupervisor = () => process.env[supervisorEnvironmentKey] !== undefined;
339
+ const readSupervisorHandoff = () => {
340
+ const raw = process.env[supervisorEnvironmentKey];
341
+ // The worker and everything it runs must not take the supervisor role.
342
+ delete process.env[supervisorEnvironmentKey];
343
+ let handoff;
344
+ try {
345
+ handoff = JSON.parse(raw ?? "");
346
+ }
347
+ catch (error) {
348
+ throw new Error("The detached release launch data is not valid JSON.", {
349
+ cause: error,
350
+ });
351
+ }
352
+ if (!isPlainObject(handoff) || typeof handoff.version !== "string") {
353
+ throw new Error("The detached release launch data is invalid.");
354
+ }
355
+ return { version: handoff.version };
356
+ };
357
+ /** Starts the release with its output in the log; never awaits. */
358
+ const startWorker = (commandArg, logFdArg) => {
359
+ const worker = plugins.childProcess.spawn(process.execPath, [paths.cliEntryPath, ...commandArg], { cwd: process.cwd(), stdio: ["ignore", logFdArg, logFdArg] });
360
+ // Both listeners exist before anything is awaited, so a spawn error is
361
+ // always observed.
362
+ return {
363
+ process: worker,
364
+ exited: new Promise((resolve) => worker.once("exit", (code, signal) => resolve({ code, signal }))),
365
+ spawnFailed: new Promise((resolve) => worker.once("error", resolve)),
366
+ };
367
+ };
368
+ /**
369
+ * The supervisor: holds the project's detached-release lock, starts the
370
+ * release with its output in the run's log, reports the start to the
371
+ * launcher, and records how the release ended.
372
+ */
373
+ export const superviseDetachedRelease = async () => {
374
+ const sendToLauncher = process.send?.bind(process);
375
+ const disconnectLauncher = process.disconnect?.bind(process);
376
+ if (!sendToLauncher || !disconnectLauncher) {
377
+ delete process.env[supervisorEnvironmentKey];
378
+ throw new Error("The detached release supervisor runs only when `gitzone release --detach` starts it.");
379
+ }
380
+ const report = (messageArg) => new Promise((resolve) => {
381
+ if (!process.connected)
382
+ return resolve();
383
+ sendToLauncher(messageArg, undefined, {}, () => {
384
+ if (process.connected)
385
+ disconnectLauncher();
386
+ resolve();
387
+ });
388
+ });
389
+ // No signal ends the supervisor while it holds the lock or a release runs.
390
+ // Until the release is started, a signal cancels the launch; from then on
391
+ // it is passed on to the release, each signal once, and the supervisor
392
+ // stays to record how the release ended. Either way the lock is released.
393
+ let worker;
394
+ let cancelledBy;
395
+ const forwarded = new Set();
396
+ const onSignal = (signalArg) => {
397
+ if (!worker) {
398
+ cancelledBy ??= signalArg;
399
+ return;
400
+ }
401
+ if (forwarded.has(signalArg) ||
402
+ worker.exitCode !== null ||
403
+ worker.signalCode !== null) {
404
+ return;
405
+ }
406
+ forwarded.add(signalArg);
407
+ worker.kill(signalArg);
408
+ };
409
+ const assertNotCancelled = () => {
410
+ if (cancelledBy) {
411
+ throw new Error(`The detached release supervisor received ${cancelledBy} before it started the release; nothing was started.`);
412
+ }
413
+ };
414
+ for (const signal of forwardedSignals)
415
+ process.on(signal, onSignal);
416
+ let logPath;
417
+ try {
418
+ const handoff = readSupervisorHandoff();
419
+ const runs = await openDetachedReleaseRuns(process.cwd());
420
+ const command = process.argv.slice(2);
421
+ assertNotCancelled();
422
+ await runs.lock.runExclusive(async () => {
423
+ await plugins.fs.mkdir(runs.directory, { recursive: true, mode: 0o700 });
424
+ const id = plugins.crypto.randomBytes(16).toString("hex");
425
+ const runLogPath = runs.getLogPath(id);
426
+ const log = await plugins.fs.open(runLogPath, "wx", 0o600);
427
+ let started;
428
+ try {
429
+ // Nothing is awaited between this check and the spawn, so a signal
430
+ // either cancels the launch here or reaches the started release.
431
+ if (cancelledBy === undefined) {
432
+ started = startWorker(command, log.fd);
433
+ if (started.process.pid !== undefined)
434
+ worker = started.process;
435
+ }
436
+ }
437
+ finally {
438
+ // The worker holds its own descriptors of the log.
439
+ await log.close();
440
+ }
441
+ const workerPid = worker?.pid;
442
+ if (!started || !worker || workerPid === undefined) {
443
+ // No run exists, so its log is removed with it.
444
+ await plugins.fs.rm(runLogPath, { force: true });
445
+ assertNotCancelled();
446
+ throw new Error("The detached release could not be started.", {
447
+ cause: await started?.spawnFailed,
448
+ });
449
+ }
450
+ logPath = runLogPath;
451
+ const run = {
452
+ kind: detachedReleaseRunKind,
453
+ id,
454
+ command,
455
+ version: handoff.version,
456
+ cwd: process.cwd(),
457
+ supervisorPid: process.pid,
458
+ workerPid,
459
+ logPath: runLogPath,
460
+ startedAt: new Date().toISOString(),
461
+ state: "running",
462
+ exitCode: null,
463
+ signal: null,
464
+ finishedAt: null,
465
+ };
466
+ try {
467
+ await runs.write(run);
468
+ }
469
+ catch (error) {
470
+ // Nothing may run that the run record does not name.
471
+ worker.kill("SIGKILL");
472
+ await started.exited;
473
+ throw error;
474
+ }
475
+ await report({ kind: "started", run });
476
+ const { code, signal } = await started.exited;
477
+ await plugins.fs.appendFile(runLogPath, `\nDetached release finished: ${describeExit(code, signal)}\n`);
478
+ await runs.write({
479
+ ...run,
480
+ state: code === 0 ? "succeeded" : "failed",
481
+ exitCode: code,
482
+ signal,
483
+ finishedAt: new Date().toISOString(),
484
+ });
485
+ process.exitCode = code ?? 1;
486
+ });
487
+ }
488
+ catch (error) {
489
+ const message = error instanceof Error ? error.message : String(error);
490
+ if (process.connected) {
491
+ await report({ kind: "refused", error: message });
492
+ }
493
+ else if (logPath) {
494
+ // The launcher is gone; the log is the one place left to say why.
495
+ await plugins.fs
496
+ .appendFile(logPath, `\nDetached release supervisor failed: ${message}\n`)
497
+ .catch(() => { });
498
+ }
499
+ throw error;
500
+ }
501
+ finally {
502
+ for (const signal of forwardedSignals)
503
+ process.off(signal, onSignal);
504
+ }
505
+ };
506
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5kZXRhY2hlZHJlbGVhc2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9tb2RfcmVsZWFzZS9jbGFzc2VzLmRldGFjaGVkcmVsZWFzZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEtBQUssT0FBTyxNQUFNLGtCQUFrQixDQUFDO0FBQzVDLE9BQU8sS0FBSyxLQUFLLE1BQU0sYUFBYSxDQUFDO0FBQ3JDLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLDZDQUE2QyxDQUFDO0FBQy9FLE9BQU8sRUFDTCxtQkFBbUIsRUFDbkIseUJBQXlCLEdBQzFCLE1BQU0sNkJBQTZCLENBQUM7QUFFckM7Ozs7Ozs7Ozs7R0FVRztBQUVILE1BQU0sQ0FBQyxNQUFNLHNCQUFzQixHQUFHLDhCQUF1QyxDQUFDO0FBRTlFLDRGQUE0RjtBQUM1RixNQUFNLHdCQUF3QixHQUFHLHFDQUFxQyxDQUFDO0FBQ3ZFLE1BQU0sWUFBWSxHQUFHLGdCQUFnQixDQUFDO0FBQ3RDLE1BQU0sd0JBQXdCLEdBQUcsTUFBTSxDQUFDO0FBQ3hDLDZFQUE2RTtBQUM3RSxNQUFNLHVCQUF1QixHQUFHLE1BQU0sQ0FBQztBQUN2QyxNQUFNLGdCQUFnQixHQUFHLENBQUMsUUFBUSxFQUFFLFFBQVEsRUFBRSxTQUFTLENBQVUsQ0FBQztBQStCbEUsTUFBTSxhQUFhLEdBQUcsQ0FDcEIsUUFBaUIsRUFDb0IsRUFBRSxDQUN2QyxPQUFPLFFBQVEsS0FBSyxRQUFRLElBQUksUUFBUSxLQUFLLElBQUksSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLENBQUM7QUFFaEYsTUFBTSxXQUFXLEdBQUcsQ0FBQyxRQUFpQixFQUFzQixFQUFFLENBQzVELE9BQU8sUUFBUSxLQUFLLFFBQVE7SUFDNUIsQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsUUFBUSxDQUFDLENBQUM7SUFDbkMsSUFBSSxJ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
@@ -1,4 +1,5 @@
1
1
  import * as plugins from "./mod.plugins.js";
2
+ import { type TReleaseRecordedPlan } from "../helpers.workflow.js";
2
3
  import { type IGiteaAssetDestination, type IGiteaFrozenAsset } from "./helpers.giteaassets.js";
3
4
  import { type IReleaseCleanupResult, type IReleasePromotionContext, type IReleaseQualificationRequest, type IReleaseQualificationResult, type TReleasePromotionEvidence } from "./helpers.tsdockerprotocol.js";
4
5
  import { type IReleaseVersionFloorRecord } from "./helpers.releaseversion.js";
@@ -7,6 +8,7 @@ export declare const legacyReleaseJournalSchemaVersion: 1;
7
8
  export declare const releaseJournalSchemaVersion: 2;
8
9
  export declare const releaseArtifactFileName: "package.tgz";
9
10
  export declare const releaseJournalFileName: "journal.json";
11
+ export declare const releaseIntentKind: "gitzone-release-intent";
10
12
  /**
11
13
  * `accepted` records a destination that took the upload without rejecting it
12
14
  * while its read-back is still missing. It is neither a success nor a failure:
@@ -157,6 +159,27 @@ export declare const getReleaseDockerPromotionContext: (journalArg: IReleaseJour
157
159
  export declare const assertReleaseJournal: (valueArg: unknown) => TReleaseJournal;
158
160
  export declare const serializeReleaseJournal: (journalArg: TReleaseJournal) => string;
159
161
  export declare const parseReleaseJournal: (contentArg: string) => TReleaseJournal;
162
+ /** The Git destination state a recorded release leases when it publishes. */
163
+ export interface IReleaseIntentGit {
164
+ remote: string;
165
+ destinationHash: string;
166
+ expectedRemoteMainOid: string;
167
+ }
168
+ /**
169
+ * What a release settled before it prepared its journal: its local commit and
170
+ * tag, the Git destination state it leases, and the command-line choices that
171
+ * shaped it. It is recorded as soon as the tag exists, so a failure before the
172
+ * journal is installed resumes from the release commit instead of stranding
173
+ * it. The installed journal supersedes it.
174
+ */
175
+ export interface IReleaseIntent {
176
+ kind: typeof releaseIntentKind;
177
+ release: IReleaseIdentity;
178
+ plan: TReleaseRecordedPlan;
179
+ git: IReleaseIntentGit | null;
180
+ createdAt: string;
181
+ }
182
+ export declare const assertReleaseIntent: (valueArg: unknown) => IReleaseIntent;
160
183
  export declare const createReleaseAttempt: () => IReleaseAttempt;
161
184
  export declare const resolveGitCommonDirectory: (smartshellArg: plugins.smartshell.Smartshell, cwdArg: string) => Promise<string>;
162
185
  export declare class ReleaseJournalStore {
@@ -165,6 +188,17 @@ export declare class ReleaseJournalStore {
165
188
  getReleaseDirectory(versionArg: string): string;
166
189
  getArtifactPath(versionArg: string, fileArg?: string): string;
167
190
  createTemporaryDirectory(versionArg: string): Promise<string>;
191
+ /** Beside the release directory, so installing the journal never meets it. */
192
+ getIntentPath(versionArg: string): string;
193
+ hasJournal(versionArg: string): Promise<boolean>;
194
+ /**
195
+ * Records the intent atomically. A fresh release just created its tag, so
196
+ * an intent left behind by an earlier, unwound attempt at this version no
197
+ * longer names an existing tag and is replaced.
198
+ */
199
+ recordIntent(intentArg: IReleaseIntent): Promise<void>;
200
+ /** The recorded intent of a release without an installed journal, if any. */
201
+ readIntent(versionArg: string): Promise<IReleaseIntent | null>;
168
202
  read(versionArg: string): Promise<TReleaseJournal>;
169
203
  list(): Promise<TReleaseJournal[]>;
170
204
  installPrepared(temporaryDirectoryArg: string, journalArg: TReleaseJournal): Promise<TReleaseJournal>;