merge origin/main into docs font branch

scripts/build-public-npm-package.test.mjs

@@ -141,10 +141,13 @@ async function writeWorkspaceFixture(root) {
 describe('publicNpmPackageLayout', () => {
   it('uses the public npm release version for the tarball name', () => {
     const layout = publicNpmPackageLayout('/repo/ktx');
-    const expectedTarballName = `kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`;
 
-    assert.equal(publicNpmPackageTarballName(), expectedTarballName);
-    assert.equal(layout.tarballPath, `/repo/ktx/dist/artifacts/npm/${expectedTarballName}`);
+    assert.match(PUBLIC_NPM_PACKAGE_VERSION, /^\d+\.\d+\.\d+/);
+    assert.equal(publicNpmPackageTarballName(), `kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`);
+    assert.equal(
+      layout.tarballPath,
+      `/repo/ktx/dist/artifacts/npm/kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`,
+    );
   });
 });
 
@@ -268,7 +271,6 @@ describe('createPublicNpmPackageTree', () => {
 describe('publicNpmPackCommand', () => {
   it('packs the assembled public package with pnpm', () => {
     const layout = publicNpmPackageLayout('/repo/ktx');
-    const expectedTarballName = `kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`;
 
     assert.deepEqual(publicNpmPackCommand(layout), {
       command: 'pnpm',
@@ -276,7 +278,7 @@ describe('publicNpmPackCommand', () => {
         '--config.node-linker=hoisted',
         'pack',
         '--out',
-        `/repo/ktx/dist/artifacts/npm/${expectedTarballName}`,
+        `/repo/ktx/dist/artifacts/npm/kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`,
       ],
       cwd: '/repo/ktx/dist/public-npm-package',
     });

scripts/build-python-runtime-wheel.test.mjs

@@ -52,7 +52,7 @@ describe('runtimeWheelPyproject', () => {
     const pyproject = runtimeWheelPyproject();
 
     assert.match(pyproject, /name = "kaelio-ktx"/);
-    assert.match(pyproject, new RegExp(`version = "${RUNTIME_WHEEL_PACKAGE_VERSION.replaceAll('.', '\\.')}"`));
+    assert.match(pyproject, new RegExp(`version = "${RUNTIME_WHEEL_PACKAGE_VERSION.replace(/\./g, '\\.')}"`));
     assert.match(pyproject, /ktx-daemon = "ktx_daemon\.__main__:main"/);
     assert.match(pyproject, /packages = \["semantic_layer", "ktx_daemon"\]/);
     assert.match(pyproject, /\[project\.optional-dependencies\]/);
@@ -110,6 +110,6 @@ describe('runtimeWheelBuildCommand', () => {
       cwd: '/repo/ktx',
     });
     assert.equal(RUNTIME_WHEEL_DISTRIBUTION_NAME, 'kaelio-ktx');
-    assert.match(RUNTIME_WHEEL_PACKAGE_VERSION, /^\d+\.\d+\.\d+(?:rc\d+)?$/);
+    assert.match(RUNTIME_WHEEL_PACKAGE_VERSION, /^\d+\.\d+\.\d+/);
   });
 });

scripts/local-embeddings-runtime-smoke.test.mjs

@@ -2,6 +2,7 @@ import assert from 'node:assert/strict';
 import { readFile } from 'node:fs/promises';
 import { describe, it } from 'node:test';
 
+import { PUBLIC_NPM_PACKAGE_VERSION } from './build-public-npm-package.mjs';
 import {
   buildLocalEmbeddingsSmokeEnv,
   expectedPublicKtxVersionPattern,
@@ -11,10 +12,8 @@ import {
   publicKtxTarballName,
   validateEmbeddingResponse,
 } from './local-embeddings-runtime-smoke.mjs';
-import {
-  PUBLIC_NPM_PACKAGE_NAME,
-  PUBLIC_NPM_PACKAGE_VERSION,
-} from './build-public-npm-package.mjs';
+const PUBLIC_TARBALL_NAME = `kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`;
+const OTHER_PUBLIC_TARBALL_NAME = 'kaelio-ktx-9.9.9.tgz';
 
 describe('localEmbeddingsSmokeOptIn', () => {
   it('skips unless the smoke is explicitly enabled', () => {
@@ -39,10 +38,7 @@ describe('localEmbeddingsSmokeOptIn', () => {
 
 describe('publicKtxTarballName', () => {
   it('selects the public @kaelio/ktx tarball name', () => {
-    assert.equal(
-      publicKtxTarballName(['kaelio-ktx-0.1.0-rc.1.tgz', 'ignore-me.tgz']),
-      'kaelio-ktx-0.1.0-rc.1.tgz',
-    );
+    assert.equal(publicKtxTarballName([PUBLIC_TARBALL_NAME, 'ignore-me.tgz']), PUBLIC_TARBALL_NAME);
   });
 
   it('fails when the public package tarball is missing', () => {
@@ -54,7 +50,7 @@ describe('publicKtxTarballName', () => {
 
   it('fails when multiple public package tarballs are present', () => {
     assert.throws(
-      () => publicKtxTarballName(['kaelio-ktx-0.1.0-rc.1.tgz', 'kaelio-ktx-0.2.0.tgz']),
+      () => publicKtxTarballName([PUBLIC_TARBALL_NAME, OTHER_PUBLIC_TARBALL_NAME]),
       /Expected exactly one @kaelio\/ktx tarball/,
     );
   });
@@ -64,7 +60,7 @@ describe('expectedPublicKtxVersionPattern', () => {
   it('matches the public package version and rejects the private workspace version', () => {
     const pattern = expectedPublicKtxVersionPattern();
 
-    assert.match(`${PUBLIC_NPM_PACKAGE_NAME} ${PUBLIC_NPM_PACKAGE_VERSION}\n`, pattern);
+    assert.match(`@kaelio/ktx ${PUBLIC_NPM_PACKAGE_VERSION}\n`, pattern);
     assert.doesNotMatch('@kaelio/ktx 0.0.0-private\n', pattern);
   });
 });

scripts/package-artifacts.test.mjs

@@ -28,9 +28,6 @@ import {
   writeArtifactManifest,
 } from './package-artifacts.mjs';
 
-const PUBLIC_NPM_TARBALL_NAME = `kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`;
-const RUNTIME_WHEEL_FILE = `kaelio_ktx-${RUNTIME_WHEEL_PACKAGE_VERSION}-py3-none-any.whl`;
-
 async function writeJson(path, value) {
   await writeFile(path, `${JSON.stringify(value, null, 2)}\n`);
 }
@@ -75,6 +72,10 @@ async function writeReleaseMetadataInputs(root) {
   }
 }
 
+function runtimeWheelFilename(version = RUNTIME_WHEEL_PACKAGE_VERSION) {
+  return `kaelio_ktx-${version}-py3-none-any.whl`;
+}
+
 async function writeUploadableArtifactFixtures(layout) {
   await mkdir(layout.npmDir, { recursive: true });
   await mkdir(layout.pythonDir, { recursive: true });
@@ -84,7 +85,10 @@ async function writeUploadableArtifactFixtures(layout) {
       layout.npmTarballs[packageInfo.name],
       `${packageInfo.name}-tarball`,
     ]),
-    [join(layout.pythonDir, RUNTIME_WHEEL_FILE), 'kaelio-ktx-runtime-wheel'],
+    [
+      join(layout.pythonDir, runtimeWheelFilename()),
+      'kaelio-ktx-runtime-wheel',
+    ],
   ]);
 
   for (const [path, contents] of fileContents) {
@@ -99,7 +103,10 @@ describe('packageArtifactLayout', () => {
     assert.equal(layout.artifactDir, '/repo/ktx/dist/artifacts');
     assert.equal(layout.npmDir, '/repo/ktx/dist/artifacts/npm');
     assert.equal(layout.pythonDir, '/repo/ktx/dist/artifacts/python');
-    assert.equal(layout.cliTarball, `/repo/ktx/dist/artifacts/npm/${PUBLIC_NPM_TARBALL_NAME}`);
+    assert.equal(
+      layout.cliTarball,
+      `/repo/ktx/dist/artifacts/npm/kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`,
+    );
     assert.deepEqual(Object.keys(layout.npmTarballs), ['@kaelio/ktx']);
   });
 });
@@ -154,10 +161,10 @@ describe('findPythonArtifacts', () => {
   it('finds the bundled runtime wheel only', async () => {
     const root = await mkdtemp(join(tmpdir(), 'ktx-artifacts-test-'));
     try {
-      await writeFile(join(root, RUNTIME_WHEEL_FILE), '');
+      await writeFile(join(root, runtimeWheelFilename()), '');
 
       assert.deepEqual(await findPythonArtifacts(root), {
-        runtimeWheel: join(root, RUNTIME_WHEEL_FILE),
+        runtimeWheel: join(root, runtimeWheelFilename()),
       });
     } finally {
       await rm(root, { recursive: true, force: true });
@@ -233,7 +240,7 @@ describe('artifact manifest', () => {
             ecosystem: 'npm',
             packageName: '@kaelio/ktx',
             packageVersion: PUBLIC_NPM_PACKAGE_VERSION,
-            path: `npm/${PUBLIC_NPM_TARBALL_NAME}`,
+            path: `npm/kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`,
           },
         ],
       );
@@ -253,12 +260,14 @@ describe('artifact manifest', () => {
             ecosystem: 'python',
             packageName: 'kaelio-ktx',
             packageVersion: RUNTIME_WHEEL_PACKAGE_VERSION,
-            path: `python/${RUNTIME_WHEEL_FILE}`,
+            path: `python/${runtimeWheelFilename()}`,
           },
         ],
       );
 
-      const npmEntry = manifest.files.find((file) => file.path === `npm/${PUBLIC_NPM_TARBALL_NAME}`);
+      const npmEntry = manifest.files.find(
+        (file) => file.path === `npm/kaelio-ktx-${PUBLIC_NPM_PACKAGE_VERSION}.tgz`,
+      );
       assert.ok(npmEntry);
       assert.equal(npmEntry.bytes, Buffer.byteLength('@kaelio/ktx-tarball'));
       assert.equal(npmEntry.sha256, createHash('sha256').update('@kaelio/ktx-tarball').digest('hex'));
@@ -361,15 +370,18 @@ describe('copyRuntimeWheelAssets', () => {
     const layout = packageArtifactLayout(root, PUBLIC_NPM_PACKAGE_VERSION);
     try {
       await mkdir(layout.pythonDir, { recursive: true });
-      await writeFile(join(layout.pythonDir, RUNTIME_WHEEL_FILE), 'kaelio-ktx-runtime-wheel');
+      await writeFile(
+        join(layout.pythonDir, runtimeWheelFilename()),
+        'kaelio-ktx-runtime-wheel',
+      );
 
       const assets = await copyRuntimeWheelAssets(layout, {
-        runtimeWheel: join(layout.pythonDir, RUNTIME_WHEEL_FILE),
+        runtimeWheel: join(layout.pythonDir, runtimeWheelFilename()),
       });
 
       assert.equal(
         assets.wheelPath,
-        join(root, 'packages', 'cli', 'assets', 'python', RUNTIME_WHEEL_FILE),
+        join(root, 'packages', 'cli', 'assets', 'python', runtimeWheelFilename()),
       );
       assert.equal(
         assets.manifestPath,
@@ -382,7 +394,7 @@ describe('copyRuntimeWheelAssets', () => {
         normalizedName: RUNTIME_WHEEL_NORMALIZED_NAME,
         version: RUNTIME_WHEEL_PACKAGE_VERSION,
         wheel: {
-          file: RUNTIME_WHEEL_FILE,
+          file: runtimeWheelFilename(),
           sha256: createHash('sha256')
             .update('kaelio-ktx-runtime-wheel')
             .digest('hex'),

scripts/release-readiness.test.mjs

@@ -7,15 +7,13 @@ import { describe, it } from 'node:test';
 import {
   INTERNAL_NPM_WORKSPACE_PACKAGES,
   NPM_ARTIFACT_PACKAGES,
-  RUNTIME_WHEEL_PACKAGE_VERSION,
   packageArtifactLayout,
   writeArtifactManifest,
 } from './package-artifacts.mjs';
 import { PUBLIC_NPM_PACKAGE_VERSION } from './build-public-npm-package.mjs';
+import { RUNTIME_WHEEL_PACKAGE_VERSION } from './build-python-runtime-wheel.mjs';
 import { readReleasePolicy, releasePolicyPath, releaseReadinessReport } from './release-readiness.mjs';
 
-const RUNTIME_WHEEL_FILE = `kaelio_ktx-${RUNTIME_WHEEL_PACKAGE_VERSION}-py3-none-any.whl`;
-
 async function writeJson(path, value) {
   await writeFile(path, `${JSON.stringify(value, null, 2)}\n`);
 }
@@ -40,7 +38,10 @@ async function writeUploadableArtifactFixtures(layout) {
       layout.npmTarballs[packageInfo.name],
       `${packageInfo.name}-tarball`,
     ]),
-    [join(layout.pythonDir, RUNTIME_WHEEL_FILE), 'kaelio-ktx-runtime-wheel'],
+    [
+      join(layout.pythonDir, `kaelio_ktx-${RUNTIME_WHEEL_PACKAGE_VERSION}-py3-none-any.whl`),
+      'kaelio-ktx-runtime-wheel',
+    ],
   ]);
 
   for (const [path, contents] of fileContents) {