@git.zone/cli 6.14.0 → 6.16.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.
@@ -0,0 +1,148 @@
1
+ import { inferVersionTypeFromPending } from "../helpers.changelog.js";
2
+ import { calculateNewVersion, } from "../mod_commit/mod.helpers.js";
3
+ export class ReleaseVersionError extends Error {
4
+ code;
5
+ constructor(code, messageArg) {
6
+ super(messageArg);
7
+ this.code = code;
8
+ this.name = "ReleaseVersionError";
9
+ }
10
+ }
11
+ const canonicalVersionPattern = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
12
+ // The semver.org 2.0.0 grammar. It is consulted only after the canonical form
13
+ // failed, so a match here means prerelease or build metadata.
14
+ const decoratedSemverPattern = /^(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)\.(?:0|[1-9]\d*)(?:-(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*)?(?:\+[0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*)?$/;
15
+ export const isCanonicalReleaseVersion = (valueArg) => canonicalVersionPattern.test(valueArg);
16
+ const parseVersionCore = (valueArg) => {
17
+ const match = canonicalVersionPattern.exec(valueArg);
18
+ if (!match) {
19
+ throw new ReleaseVersionError("noncanonical-version", `Release versions must be canonical x.y.z semver, found ${JSON.stringify(valueArg)}.`);
20
+ }
21
+ return [BigInt(match[1]), BigInt(match[2]), BigInt(match[3])];
22
+ };
23
+ /** Orders two canonical x.y.z versions: negative, zero or positive. */
24
+ export const compareReleaseVersions = (leftArg, rightArg) => {
25
+ const left = parseVersionCore(leftArg);
26
+ const right = parseVersionCore(rightArg);
27
+ for (let index = 0; index < left.length; index++) {
28
+ if (left[index] !== right[index])
29
+ return left[index] < right[index] ? -1 : 1;
30
+ }
31
+ return 0;
32
+ };
33
+ const majorOf = (versionArg) => parseVersionCore(versionArg)[0];
34
+ // npm and the version bump arithmetic handle only safe integer components.
35
+ const hasSafeIntegerComponents = (versionArg) => versionArg
36
+ .split(".")
37
+ .every((componentArg) => Number.isSafeInteger(Number(componentArg)));
38
+ /** Validates `release.versionFloor`; absent means no floor. */
39
+ export const parseReleaseVersionFloor = (valueArg) => {
40
+ if (valueArg === undefined)
41
+ return undefined;
42
+ if (typeof valueArg === "string" && isCanonicalReleaseVersion(valueArg)) {
43
+ if (hasSafeIntegerComponents(valueArg))
44
+ return valueArg;
45
+ throw new ReleaseVersionError("malformed-version-floor", `release.versionFloor components must not exceed ${Number.MAX_SAFE_INTEGER}, found ${JSON.stringify(valueArg)}.`);
46
+ }
47
+ if (typeof valueArg === "string" && decoratedSemverPattern.test(valueArg)) {
48
+ throw new ReleaseVersionError("unsupported-prerelease-floor", `release.versionFloor ${JSON.stringify(valueArg)} carries prerelease or build metadata; GitZone releases only canonical x.y.z versions.`);
49
+ }
50
+ throw new ReleaseVersionError("malformed-version-floor", `release.versionFloor must be a canonical x.y.z semver string, found ${JSON.stringify(valueArg)}.`);
51
+ };
52
+ const decideFloorOutcome = (currentVersionArg, inferredVersionArg, floorArg) => {
53
+ if (compareReleaseVersions(floorArg, currentVersionArg) <= 0)
54
+ return "inert";
55
+ if (compareReleaseVersions(floorArg, inferredVersionArg) <= 0) {
56
+ return "satisfied";
57
+ }
58
+ return "applied";
59
+ };
60
+ /**
61
+ * The only place that decides the next release version: the level-inferred
62
+ * version, raised to `release.versionFloor` when the floor is higher.
63
+ */
64
+ export const resolveReleaseVersion = (requestArg) => {
65
+ const pendingLevel = inferVersionTypeFromPending(requestArg.pendingChangelog);
66
+ const level = requestArg.levelOverride ?? pendingLevel;
67
+ const inferredVersion = calculateNewVersion(requestArg.currentVersion, level);
68
+ const levelSource = requestArg.levelOverride
69
+ ? "flag"
70
+ : "pending-changelog";
71
+ const unfloored = {
72
+ currentVersion: requestArg.currentVersion,
73
+ level,
74
+ levelSource,
75
+ inferredVersion,
76
+ };
77
+ const floor = parseReleaseVersionFloor(requestArg.versionFloor);
78
+ if (floor === undefined) {
79
+ return {
80
+ ...unfloored,
81
+ version: inferredVersion,
82
+ versionFloor: null,
83
+ floorRaisesMajorWithoutBreakingChanges: false,
84
+ };
85
+ }
86
+ if (!isCanonicalReleaseVersion(requestArg.currentVersion)) {
87
+ throw new ReleaseVersionError("noncanonical-version", `release.versionFloor needs a canonical x.y.z current version to compare against, found ${JSON.stringify(requestArg.currentVersion)}.`);
88
+ }
89
+ const outcome = decideFloorOutcome(requestArg.currentVersion, inferredVersion, floor);
90
+ const version = outcome === "applied" ? floor : inferredVersion;
91
+ return {
92
+ ...unfloored,
93
+ version,
94
+ versionFloor: { floor, outcome },
95
+ floorRaisesMajorWithoutBreakingChanges: outcome === "applied" &&
96
+ majorOf(version) > majorOf(inferredVersion) &&
97
+ pendingLevel !== "major",
98
+ };
99
+ };
100
+ /**
101
+ * The version files must still hold the version the release was resolved
102
+ * from; otherwise the resolved version no longer follows from the checkout.
103
+ */
104
+ export const assertResolvedCurrentVersion = (resolutionArg, checkoutVersionArg) => {
105
+ if (checkoutVersionArg !== resolutionArg.currentVersion) {
106
+ throw new ReleaseVersionError("current-version-changed", `The release checkout carries version ${checkoutVersionArg}, but v${resolutionArg.version} was resolved from ${resolutionArg.currentVersion}.`);
107
+ }
108
+ };
109
+ const createVersionFloorRecord = (resolutionArg, floorArg) => ({
110
+ floor: floorArg,
111
+ inferredVersion: resolutionArg.inferredVersion,
112
+ });
113
+ export const toReleaseVersionFloorRecord = (resolutionArg) => resolutionArg.versionFloor?.outcome === "applied"
114
+ ? createVersionFloorRecord(resolutionArg, resolutionArg.versionFloor.floor)
115
+ : undefined;
116
+ /** Shared wording for the plan and the journal summary. */
117
+ export const describeAppliedVersionFloor = (recordArg, versionArg) => `version floor: ${recordArg.floor} applied (inferred ${recordArg.inferredVersion} -> release ${versionArg})`;
118
+ const describeVersionFloor = (resolutionArg) => {
119
+ const decision = resolutionArg.versionFloor;
120
+ if (!decision)
121
+ return [];
122
+ switch (decision.outcome) {
123
+ case "inert":
124
+ return [
125
+ `version floor: ${decision.floor} inert (current ${resolutionArg.currentVersion} already meets it); remove release.versionFloor`,
126
+ ];
127
+ case "satisfied":
128
+ return [
129
+ `version floor: ${decision.floor} satisfied by inferred ${resolutionArg.inferredVersion}`,
130
+ ];
131
+ case "applied":
132
+ return [
133
+ describeAppliedVersionFloor(createVersionFloorRecord(resolutionArg, decision.floor), resolutionArg.version),
134
+ ...(resolutionArg.floorRaisesMajorWithoutBreakingChanges
135
+ ? [
136
+ `version notice: the floor raises the major version above inferred ${resolutionArg.inferredVersion}, and Pending has no "### Breaking Changes" section`,
137
+ ]
138
+ : []),
139
+ ];
140
+ }
141
+ };
142
+ /** Plan lines that explain where the release version comes from. */
143
+ export const describeReleaseVersion = (resolutionArg) => [
144
+ `version: ${resolutionArg.currentVersion} -> ${resolutionArg.version}`,
145
+ `version level: ${resolutionArg.level} (${resolutionArg.levelSource === "flag" ? `--${resolutionArg.level}` : "Pending changelog"})`,
146
+ ...describeVersionFloor(resolutionArg),
147
+ ];
148
+ //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVycy5yZWxlYXNldmVyc2lvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL21vZF9yZWxlYXNlL2hlbHBlcnMucmVsZWFzZXZlcnNpb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLDJCQUEyQixFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDdEUsT0FBTyxFQUNMLG1CQUFtQixHQUVwQixNQUFNLDhCQUE4QixDQUFDO0FBUXRDLE1BQU0sT0FBTyxtQkFBb0IsU0FBUSxLQUFLO0lBRTFCO0lBRGxCLFlBQ2tCLElBQThCLEVBQzlDLFVBQWtCO1FBRWxCLEtBQUssQ0FBQyxVQUFVLENBQUMsQ0FBQztRQUhGLFNBQUksR0FBSixJQUFJLENBQTBCO1FBSTlDLElBQUksQ0FBQyxJQUFJLEdBQUcscUJBQXFCLENBQUM7SUFDcEMsQ0FBQztDQUNGO0FBcUNELE1BQU0sdUJBQXVCLEdBQUcsNENBQTRDLENBQUM7QUFDN0UsOEVBQThFO0FBQzlFLDhEQUE4RDtBQUM5RCxNQUFNLHNCQUFzQixHQUMxQix1TEFBdUwsQ0FBQztBQUUxTCxNQUFNLENBQUMsTUFBTSx5QkFBeUIsR0FBRyxDQUFDLFFBQWdCLEVBQVcsRUFBRSxDQUNyRSx1QkFBdUIsQ0FBQyxJQUFJLENBQUMsUUFBUSxDQUFDLENBQUM7QUFFekMsTUFBTSxnQkFBZ0IsR0FBRyxDQUFDLFFBQWdCLEVBQTRCLEVBQUU7SUFDdEUsTUFBTSxLQUFLLEdBQUcsdUJBQXVCLENBQUMsSUFBSSxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQ3JELElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztRQUNYLE1BQU0sSUFBSSxtQkFBbUIsQ0FDM0Isc0JBQXNCLEVBQ3RCLDBEQUEwRCxJQUFJLENBQUMsU0FBUyxDQUFDLFFBQVEsQ0FBQyxHQUFHLENBQ3RGLENBQUM7SUFDSixDQUFDO0lBQ0QsT0FBTyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDLENB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
@@ -1,11 +1,20 @@
1
1
  import * as plugins from "./mod.plugins.js";
2
2
  import type { ICliMode } from "../helpers.climode.js";
3
3
  import { type IResolvedReleaseWorkflow } from "../helpers.workflow.js";
4
+ import { type IReleaseBranchContext } from "./helpers.releasebranch.js";
4
5
  import { ReleaseJournalStore, type TReleaseJournal } from "./classes.releasejournal.js";
5
6
  import { type IPnpmReleaseCapability } from "./helpers.npmartifact.js";
6
7
  import { type ITsdockerReleaseClient, type IReleaseQualificationRequest } from "./helpers.tsdockerprotocol.js";
8
+ import { type IReleaseVersionFloorRecord } from "./helpers.releaseversion.js";
7
9
  export { buildReleaseGitPushArgs } from "./helpers.releasepublication.js";
8
10
  export declare const run: (argvArg: any) => Promise<void>;
11
+ /**
12
+ * Test logs are release diagnostics, so only a journal that reached completion
13
+ * may drop them. A failure keeps them for the investigation, and a journal left
14
+ * incomplete — an npm target still awaiting availability, for instance — keeps
15
+ * them for the resume that finishes it; that resume then runs this cleanup.
16
+ */
17
+ export declare const cleanTestArtifactsForCompletedRelease: (smartshellArg: plugins.smartshell.Smartshell, cwdArg: string, journalArg: Pick<TReleaseJournal, "completedAt">, cleanRequestedArg: boolean) => Promise<void>;
9
18
  interface ICreateReleaseJournalOptions {
10
19
  pnpmCapability?: IPnpmReleaseCapability;
11
20
  smartshell: plugins.smartshell.Smartshell;
@@ -16,6 +25,7 @@ interface ICreateReleaseJournalOptions {
16
25
  releasePushUrl?: string;
17
26
  expectedRemoteMainOid?: string;
18
27
  version: string;
28
+ versionFloor?: IReleaseVersionFloorRecord;
19
29
  refs: IReleaseRefs;
20
30
  dockerRequest?: IReleaseQualificationRequest;
21
31
  tsdocker?: ITsdockerReleaseClient;
@@ -30,6 +40,15 @@ interface IReleaseRefs {
30
40
  mainOid: string;
31
41
  tagOid: string;
32
42
  }
43
+ /**
44
+ * Resume reads the journaled release commit through its tag. Only a resume
45
+ * that still has publication work left must run from that exact commit; a
46
+ * verification-only resume accepts a main that already moved past it.
47
+ */
48
+ export declare const resolveResumeReleaseRefs: (smartshellInstanceArg: plugins.smartshell.Smartshell, cwdArg: string, journalArg: TReleaseJournal, branchContextArg: IReleaseBranchContext) => Promise<{
49
+ refs: IReleaseRefs;
50
+ verificationOnly: boolean;
51
+ }>;
33
52
  type TDockerCommandWorkflow = Pick<IResolvedReleaseWorkflow, "dockerRegistry" | "dockerBuildRegistries" | "dockerTest" | "dockerCached" | "dockerParallel" | "dockerContext" | "dockerPatterns">;
34
53
  export declare function buildTsdockerPushCommand(workflow: TDockerCommandWorkflow): string;
35
54
  export declare function showHelp(mode?: ICliMode): void;