ktx/scripts/update-public-release-version.mjs
Andrey Avtomonov 99f7a31919 refactor(release): single source of truth for package version
Make packages/cli/package.json the single source of truth for the
@kaelio/ktx version. publicNpmPackageVersion() now reads it directly,
so artifact filenames, release-readiness checks, and the Python wheel
version all derive from one field. The duplicate
release-policy.json.publicNpmPackageVersion is removed.

Previously the two fields could drift: tarballs were named
kaelio-ktx-0.4.1.tgz while internally containing
@kaelio/ktx@0.0.0-private.

- update-public-release-version.mjs rewrites both Python pyproject.toml
  files (ktx-daemon, ktx-sl) alongside the npm package.jsons,
  normalizing the version for PEP 440 (e.g. 0.1.0-rc.2 -> 0.1.0rc2).
- semantic-release-config.cjs adds the two pyproject.toml files to
  @semantic-release/git assets so the release commit back to main
  carries every version source in lockstep.
- The six "?? '0.0.0-private'" fallback literals across the CLI are
  replaced with "?? getKtxCliPackageInfo().version", and
  createDefaultKtxMcpServer makes its version arg required.
- docs/release.md describes the actual commit-back model: the dev tree
  always reflects the most recent release; no sentinel pin to
  maintain.

Verified: pnpm run artifacts:build now produces
kaelio-ktx-0.4.1.tgz and kaelio_ktx-0.4.1-py3-none-any.whl with
@kaelio/ktx@0.4.1 inside. Full type-check, dead-code, and
2287 vitests + 173 script tests pass.
2026-05-21 14:23:28 +02:00

127 lines
3.8 KiB
JavaScript

#!/usr/bin/env node
import { readFile, writeFile } from 'node:fs/promises';
import { dirname, join, resolve } from 'node:path';
import { fileURLToPath, pathToFileURL } from 'node:url';
import {
PUBLIC_NPM_PACKAGE_NAME,
assertPublicNpmPackageVersion,
assertPublicNpmReleaseTag,
publicNpmPackageVersionToPythonVersion,
releasePolicyPath,
} from './public-npm-release-metadata.mjs';
function scriptRootDir() {
return resolve(dirname(fileURLToPath(import.meta.url)), '..');
}
async function readJson(path) {
return JSON.parse(await readFile(path, 'utf8'));
}
async function writeJson(path, value) {
await writeFile(path, `${JSON.stringify(value, null, 2)}\n`);
}
function pyprojectWithProjectVersion(source, version) {
const lines = source.split('\n');
let inProject = false;
let replaced = false;
for (let index = 0; index < lines.length; index += 1) {
const line = lines[index];
const sectionMatch = /^\s*\[([^\]]+)\]\s*$/.exec(line);
if (sectionMatch) {
inProject = sectionMatch[1] === 'project';
continue;
}
if (inProject && /^\s*version\s*=\s*"[^"]*"\s*$/.test(line)) {
lines[index] = `version = "${version}"`;
replaced = true;
break;
}
}
if (!replaced) {
throw new Error('No [project].version assignment found in pyproject.toml');
}
return lines.join('\n');
}
async function rewritePyprojectVersion(path, version) {
const source = await readFile(path, 'utf8');
await writeFile(path, pyprojectWithProjectVersion(source, version));
}
function safePythonVersionFor(version) {
try {
return publicNpmPackageVersionToPythonVersion(version);
} catch {
return null;
}
}
export async function updatePublicReleaseVersion(rootDir, version, tag) {
const safeVersion = assertPublicNpmPackageVersion(version);
const safeTag = assertPublicNpmReleaseTag(tag);
const packageJsonPath = join(rootDir, 'package.json');
const packageJson = await readJson(packageJsonPath);
packageJson.version = safeVersion;
await writeJson(packageJsonPath, packageJson);
const cliPackageJsonPath = join(rootDir, 'packages', 'cli', 'package.json');
const cliPackageJson = await readJson(cliPackageJsonPath);
cliPackageJson.version = safeVersion;
await writeJson(cliPackageJsonPath, cliPackageJson);
const pythonVersion = safePythonVersionFor(safeVersion);
if (pythonVersion !== null) {
await rewritePyprojectVersion(join(rootDir, 'python', 'ktx-daemon', 'pyproject.toml'), pythonVersion);
await rewritePyprojectVersion(join(rootDir, 'python', 'ktx-sl', 'pyproject.toml'), pythonVersion);
}
const policyPath = releasePolicyPath(rootDir);
const policy = await readJson(policyPath);
delete policy.publicNpmPackageVersion;
policy.releaseMode = 'npm-public-release-ready';
policy.requiredBeforePublishing = [];
policy.npm = {
...policy.npm,
publish: true,
registry: policy.npm?.registry ?? null,
access: 'public',
tag: safeTag,
packages: [PUBLIC_NPM_PACKAGE_NAME],
};
policy.publishedPackageSmoke = {
...policy.publishedPackageSmoke,
packageName: PUBLIC_NPM_PACKAGE_NAME,
version: safeVersion,
};
await writeJson(policyPath, policy);
return {
version: safeVersion,
tag: safeTag,
pythonVersion,
};
}
async function main() {
const [version, tag] = process.argv.slice(2);
if (!version || !tag) {
throw new Error('Usage: node scripts/update-public-release-version.mjs <version> <latest|next>');
}
const result = await updatePublicReleaseVersion(scriptRootDir(), version, tag);
process.stdout.write(`Updated ${PUBLIC_NPM_PACKAGE_NAME} release metadata to ${result.version} (${result.tag})\n`);
}
if (import.meta.url === pathToFileURL(process.argv[1] ?? '').href) {
try {
await main();
} catch (error) {
process.stderr.write(`${error instanceof Error ? error.stack : String(error)}\n`);
process.exitCode = 1;
}
}