3D engine that AI agents drive
JavaScript 3d3d-engineagentic-aiai-agentsblenderclaude-codegame-enginegaussian-splattinggltfjavascriptmcpmcp-servermodel-context-protocolpath-tracerpath-tracingpbrrenderingthreejs-alternativewebgl2webgpu
import { readFile, writeFile, mkdir, copyFile, cp } from 'node:fs/promises';
import { existsSync } from 'node:fs';
import { spawnSync } from 'node:child_process';
import { createHash } from 'node:crypto';
import { dirname, resolve } from 'node:path';
import { fileURLToPath } from 'node:url';
import { changelogWithUnreleased, readChangelogData } from './changelog-fragments.mjs';
import { plainGuide } from './plain-guide.mjs';
import { buildApiReference } from './api-reference.mjs';
import { publishedDocuments } from './published-documents.mjs';
const root = fileURLToPath(new URL('..', import.meta.url));
const metadata = JSON.parse(await readFile(resolve(root, 'package.json'), 'utf8'));
if (!/^\d+\.\d+\.\d+(?:-[a-z0-9.-]+)?$/.test(metadata.version)) throw new Error('Release version must be valid semver.');
if (metadata.name !== '@codepawlhq/crucible') throw new Error('Unexpected package name.');
function run(executable, argumentsList, capture = false) {
const result = spawnSync(executable, argumentsList, { cwd: root, windowsHide: true, encoding: 'utf8', stdio: capture ? 'pipe' : 'inherit' });
if (result.status !== 0) throw new Error(`Release command failed: ${result.error?.message ?? result.stderr ?? executable}`);
return result.stdout?.trim();
}
const commit = run('git', ['rev-parse', 'HEAD'], true);
if (process.argv.includes('--require-clean') && run('git', ['status', '--porcelain'], true)) throw new Error('Commit release changes before production preparation.');
run(process.execPath, ['node_modules/vite/bin/vite.js', 'build', '--config', 'config/vite.lib.config.js']);
// The standalone module goes into build/ before npm pack, so the package carries it.
run(process.execPath, ['node_modules/vite/bin/vite.js', 'build', '--config', 'config/vite.browser.config.js']);
const releases = resolve(root, 'public/releases');
await mkdir(releases, { recursive: true });
const npmCli = process.env.npm_execpath ?? resolve(dirname(process.execPath), 'node_modules/npm/bin/npm-cli.js');
if (!existsSync(npmCli)) throw new Error('npm CLI unavailable. Run preparation through npm run prepare:release.');
const packResult = JSON.parse(run(process.execPath, [npmCli, 'pack', '--ignore-scripts', '--json', '--pack-destination', releases], true));
const packed = Array.isArray(packResult) ? packResult[0] : packResult[metadata.name];
if (!packed?.filename) throw new Error('npm pack did not return a package archive.');
const tarball = `/releases/${packed.filename}`;
let archive = await readFile(resolve(releases, packed.filename));
let integrity = `sha512-${createHash('sha512').update(archive).digest('base64')}`;
await cp(resolve(root, 'build'), resolve(releases, metadata.version), { recursive: true });
// The site keeps its old file name. The bytes must equal the npm file, so a CDN and the site serve the same module.
const standaloneBytes = await readFile(resolve(root, 'build/67.standalone.js'));
const siteModulePath = resolve(releases, metadata.version, '67.module.js');
await writeFile(siteModulePath, standaloneBytes);
const sha512 = (bytes) => createHash('sha512').update(bytes).digest('hex');
if (sha512(await readFile(siteModulePath)) !== sha512(standaloneBytes)) throw new Error('The site copy of the standalone module differs from build/67.standalone.js.');
// The site shows pending change notes above the released sections. Nothing here is kept by hand.
const changelogText = await readFile(resolve(root, 'CHANGELOG.md'), 'utf8');
await writeFile(resolve(root, 'public/changelog.md'), await changelogWithUnreleased(changelogText));
await writeFile(resolve(root, 'public/changelog.json'), `${JSON.stringify(await readChangelogData({ changelogText, version: metadata.version }), null, 2)}
`);
await writeFile(resolve(root, 'public/guide.md'), await plainGuide(root));
await writeFile(resolve(root, 'public/api-reference.json'), `${JSON.stringify(await buildApiReference())}
`);
await copyFile(resolve(root, 'docs/gltf.md'), resolve(root, 'public/gltf.md'));
for (const name of publishedDocuments) {
await copyFile(resolve(root, 'docs', name), resolve(root, 'public', name));
}
let registryVersion = null;
let registryPublished = false;
let publishedPackage;
try {
const response = await fetch(`https://registry.npmjs.org/${encodeURIComponent(metadata.name)}`, { signal: AbortSignal.timeout(5000) });
if (response.ok) {
const registry = await response.json();
registryVersion = registry['dist-tags']?.latest ?? null;
publishedPackage = registry.versions?.[metadata.version];
registryPublished = Boolean(publishedPackage);
}
} catch {
// The downloadable package remains usable when the external registry is unavailable.
}
if (publishedPackage) {
const canonicalURL = new URL(publishedPackage.dist.tarball);
if (canonicalURL.origin !== 'https://registry.npmjs.org') throw new Error('Unexpected registry archive origin.');
const response = await fetch(canonicalURL, { signal: AbortSignal.timeout(30000) });
if (!response.ok) throw new Error(`Canonical package download failed: HTTP ${response.status}.`);
archive = Buffer.from(await response.arrayBuffer());
integrity = `sha512-${createHash('sha512').update(archive).digest('base64')}`;
if (integrity !== publishedPackage.dist.integrity) throw new Error('Canonical package integrity verification failed.');
await writeFile(resolve(releases, packed.filename), archive);
}
const release = {
version: metadata.version,
packageName: metadata.name,
packageAlias: 'crucible',
commit,
installCommand: registryPublished ? `npm install crucible@npm:${metadata.name}@${metadata.version}` : `npm install crucible@https://crucible.codepawl.com${tarball}`,
tarball,
module: `/releases/${metadata.version}/67.module.js`,
registryPublished,
registryVersion,
integrity,
packageBytes: archive.length,
api: './docs.html#renderer-reference',
changelog: '/changelog.md',
changelogData: '/changelog.json',
};
await writeFile(resolve(root, 'public/release.json'), `${JSON.stringify(release, null, 2)}\n`);
console.log(`Prepared ${metadata.name}@${metadata.version}: ${packed.size} bytes, commit ${commit.slice(0, 8)}, registry published ${registryPublished}.`);