@ankhorage/devtools 2.3.26 → 2.3.28

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/README.md CHANGED
@@ -3,7 +3,7 @@
3
3
 
4
4
  # @ankhorage/devtools
5
5
 
6
- ![license: MIT](././paradox/badges/license.svg) ![npm: v2.3.26](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
6
+ ![license: MIT](././paradox/badges/license.svg) ![npm: v2.3.28](././paradox/badges/npm.svg) ![runtime: bun](././paradox/badges/runtime.svg) ![typescript: strict](././paradox/badges/typescript.svg) ![eslint: checked](././paradox/badges/eslint.svg) ![prettier: checked](././paradox/badges/prettier.svg) ![build: checked](././paradox/badges/build.svg) ![tests: checked](././paradox/badges/tests.svg) ![paradox: warnings](././paradox/badges/docs.svg)
7
7
 
8
8
  Shared tooling, repository automation, and agent standards for Ankhorage TypeScript projects
9
9
 
@@ -1,4 +1,4 @@
1
1
  #!/usr/bin/env node
2
- import { runStandaloneTool } from '../runStandaloneTool.js';
3
- const result = await runStandaloneTool('changeset', process.argv.slice(2));
2
+ import { runChangesetAsync } from '../runChangesetAsync.js';
3
+ const result = await runChangesetAsync(process.argv.slice(2));
4
4
  process.exit(result.exitCode);
@@ -0,0 +1,9 @@
1
+ import type { DevtoolsRunResult } from './runExternalTool.js';
2
+ interface RunChangesetDependencies {
3
+ readonly readCurrentPackageManifestAsync: () => Promise<string>;
4
+ readonly readGitFileAsync: (baseReference: string) => Promise<string>;
5
+ readonly runExternalToolAsync: (argv: readonly string[]) => Promise<DevtoolsRunResult>;
6
+ }
7
+ /*** Run Changesets with rename-aware status validation for a renamed root package. */
8
+ export declare function runChangesetAsync(argv: readonly string[], dependencies?: RunChangesetDependencies): Promise<DevtoolsRunResult>;
9
+ export {};
@@ -0,0 +1,118 @@
1
+ import { execFile } from 'node:child_process';
2
+ import { mkdtemp, readFile, rm } from 'node:fs/promises';
3
+ import { tmpdir } from 'node:os';
4
+ import { join } from 'node:path';
5
+ import { promisify } from 'node:util';
6
+ import { getDevtoolsToolCommand } from './commands.js';
7
+ import { runExternalTool } from './runExternalTool.js';
8
+ const execFileAsync = promisify(execFile);
9
+ const defaultRunChangesetDependencies = {
10
+ readCurrentPackageManifestAsync: async () => await readFile('package.json', 'utf8'),
11
+ readGitFileAsync,
12
+ runExternalToolAsync: async (argv) => await runExternalTool(getDevtoolsToolCommand('changeset'), argv),
13
+ };
14
+ /*** Run Changesets with rename-aware status validation for a renamed root package. */
15
+ export async function runChangesetAsync(argv, dependencies = defaultRunChangesetDependencies) {
16
+ const invocation = await resolveChangesetInvocationAsync(argv, dependencies);
17
+ if (invocation.renamedPackageName === undefined) {
18
+ return await dependencies.runExternalToolAsync(invocation.argv);
19
+ }
20
+ return await runRenamedPackageStatusAsync({ argv: invocation.argv, renamedPackageName: invocation.renamedPackageName }, dependencies);
21
+ }
22
+ /*** Omit the base comparison only when it compares a renamed root package identity. */
23
+ async function resolveChangesetInvocationAsync(argv, dependencies) {
24
+ const baseReference = getStatusBaseReference(argv);
25
+ if (baseReference === undefined)
26
+ return { argv };
27
+ const packageNames = await readPackageNamesAsync(baseReference, dependencies);
28
+ if (packageNames === undefined || packageNames.current === packageNames.base)
29
+ return { argv };
30
+ return {
31
+ argv: removeStatusBaseReference(argv),
32
+ renamedPackageName: packageNames.current,
33
+ };
34
+ }
35
+ /*** Run renamed-package status with a release-plan check for the current identity. */
36
+ async function runRenamedPackageStatusAsync(invocation, dependencies) {
37
+ const directory = await mkdtemp(join(tmpdir(), 'ankhorage-changeset-status-'));
38
+ const outputPath = join(directory, 'status.json');
39
+ try {
40
+ const result = await dependencies.runExternalToolAsync([
41
+ ...withoutStatusOutput(invocation.argv),
42
+ '--output',
43
+ outputPath,
44
+ ]);
45
+ if (result.exitCode !== 0)
46
+ return result;
47
+ const releasePlan = JSON.parse(await readFile(outputPath, 'utf8'));
48
+ if (hasReleaseForPackage(releasePlan, invocation.renamedPackageName))
49
+ return result;
50
+ console.error(`Changesets did not declare release intent for renamed package ${invocation.renamedPackageName}.`);
51
+ return { exitCode: 1 };
52
+ }
53
+ catch (error) {
54
+ console.error(`Failed to validate renamed package Changeset: ${getErrorMessage(error)}`);
55
+ return { exitCode: 1 };
56
+ }
57
+ finally {
58
+ await rm(directory, { force: true, recursive: true });
59
+ }
60
+ }
61
+ /*** Read the package identities being compared by a Changesets status command. */
62
+ async function readPackageNamesAsync(baseReference, dependencies) {
63
+ try {
64
+ const current = readPackageName(await dependencies.readCurrentPackageManifestAsync());
65
+ const base = readPackageName(await dependencies.readGitFileAsync(baseReference));
66
+ return { base, current };
67
+ }
68
+ catch {
69
+ return undefined;
70
+ }
71
+ }
72
+ /*** Read one package name from a package manifest. */
73
+ function readPackageName(contents) {
74
+ const manifest = JSON.parse(contents);
75
+ if (!isRecord(manifest) || typeof manifest.name !== 'string' || manifest.name.length === 0) {
76
+ throw new Error('package.json must declare a package name.');
77
+ }
78
+ return manifest.name;
79
+ }
80
+ /*** Read the base revision package manifest through Git. */
81
+ async function readGitFileAsync(baseReference) {
82
+ const result = await execFileAsync('git', ['show', `${baseReference}:package.json`]);
83
+ return result.stdout;
84
+ }
85
+ /*** Return the comparison ref from a Changesets status invocation. */
86
+ function getStatusBaseReference(argv) {
87
+ if (argv[0] !== 'status')
88
+ return undefined;
89
+ const inlineReference = argv.find((argument) => argument.startsWith('--since='));
90
+ if (inlineReference !== undefined)
91
+ return inlineReference.slice('--since='.length);
92
+ const sinceIndex = argv.indexOf('--since');
93
+ return sinceIndex === -1 ? undefined : argv[sinceIndex + 1];
94
+ }
95
+ /*** Remove the base comparison arguments after verifying the root package identity changed. */
96
+ function removeStatusBaseReference(argv) {
97
+ return argv.filter((argument, index) => !argument.startsWith('--since=') && argument !== '--since' && argv[index - 1] !== '--since');
98
+ }
99
+ /*** Remove user output arguments before reserving the status-plan output path. */
100
+ function withoutStatusOutput(argv) {
101
+ return argv.filter((argument, index) => !argument.startsWith('--output=') &&
102
+ argument !== '--output' &&
103
+ argv[index - 1] !== '--output');
104
+ }
105
+ /*** Confirm that Changesets planned a release for the current renamed root package. */
106
+ function hasReleaseForPackage(value, packageName) {
107
+ if (!isRecord(value) || !Array.isArray(value.releases))
108
+ return false;
109
+ return value.releases.some((release) => isRecord(release) && release.name === packageName);
110
+ }
111
+ /*** Render an unknown error as a deterministic diagnostic. */
112
+ function getErrorMessage(error) {
113
+ return error instanceof Error ? error.message : String(error);
114
+ }
115
+ /*** Narrow an unknown JSON value to a plain record. */
116
+ function isRecord(value) {
117
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
118
+ }
@@ -121,6 +121,7 @@ jobs:
121
121
  run: |
122
122
  base_sha='${{ github.event.pull_request.base.sha }}'
123
123
  head_sha='${{ github.event.pull_request.head.sha }}'
124
+ git branch --force main "$base_sha"
124
125
  export ANKH_PR_CHANGESET_FILES
125
126
  ANKH_PR_CHANGESET_FILES="$(git diff --name-only --diff-filter=AMCR "$base_sha" "$head_sha" -- .changeset)"
126
127
  if [ -z "$ANKH_PR_CHANGESET_FILES" ]; then
@@ -117,13 +117,15 @@ jobs:
117
117
  stable.sort((left, right) => compare(parse(left), parse(right)));
118
118
  process.stdout.write(stable.at(-1) ?? "");
119
119
  ' "$registry_evidence")"
120
- elif node -e '
120
+ elif PACKAGE_NAME="$package_name" node -e '
121
121
  const { readFileSync } = require("node:fs");
122
122
  const error = readFileSync(process.argv[1], "utf8");
123
+ const packageName = process.env.PACKAGE_NAME;
124
+ const notFoundRequest = /^npm error 404 Not Found - GET (https:\/\/registry\.npmjs\.org\/[^\s?#]+) - Not found$/mu.exec(error);
125
+ const requestedPackage = notFoundRequest === null ? undefined : decodeURIComponent(new URL(notFoundRequest[1]).pathname.slice(1));
123
126
  const packageNotFound =
124
127
  /^npm error code E404$/mu.test(error) &&
125
- /^npm error 404 Not Found - GET https:\/\/registry\.npmjs\.org\/.+ - Not found$/mu.test(error) &&
126
- /^npm error 404 .+ is not in this registry\.$/mu.test(error);
128
+ requestedPackage === packageName;
127
129
  process.exit(packageNotFound ? 0 : 1);
128
130
  ' "$registry_error"; then
129
131
  highest_published_version=""
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ankhorage/devtools",
3
- "version": "2.3.26",
3
+ "version": "2.3.28",
4
4
  "description": "Shared tooling, repository automation, and agent standards for Ankhorage TypeScript projects",
5
5
  "license": "MIT",
6
6
  "homepage": "https://github.com/ankhorage/devtools#readme",