audrey 1.0.0 → 1.0.2

package/scripts/create-arxiv-source.mjs

@@ -1,6 +1,6 @@
 import { createHash } from 'node:crypto';
 import { cpSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { dirname, join, relative, resolve } from 'node:path';
+import { dirname, join, resolve } from 'node:path';
 import { fileURLToPath } from 'node:url';
 
 const ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..');
@@ -60,9 +60,11 @@ function protectInline(text) {
   };
 
   let next = text.replace(/\[([^\]]+)\]\((https?:\/\/[^)]+)\)/g, (_, label, url) =>
-    protect(`\\href{${latexEscape(url)}}{${latexEscape(label)}}`));
+    protect(`\\href{${latexEscape(url)}}{${latexEscape(label)}}`),
+  );
   next = next.replace(/\[([^\]]+)\]\(([^)]+)\)/g, (_, label, url) =>
-    protect(`\\texttt{${latexEscape(label)}} (${latexEscape(url)})`));
+    protect(`\\texttt{${latexEscape(label)}} (${latexEscape(url)})`),
+  );
   next = next.replace(/\[@([^\]]+)\]/g, (_, rawIds) => {
     const ids = rawIds
       .split(/;\s*@?|\s*,\s*@?/)
@@ -288,17 +290,21 @@ export function writeArxivSourcePackage(options = {}) {
 
   writeFileSync(join(outDir, 'main.tex'), built.tex, 'utf-8');
   cpSync(fromRoot(SOURCE_BIB), join(outDir, 'references.bib'));
-  writeFileSync(join(outDir, 'README-arxiv.txt'), [
-    'Audrey arXiv source package',
-    '',
-    'Main file: main.tex',
-    'Bibliography: references.bib',
-    '',
-    'Generated from docs/paper/audrey-paper-v1.md and docs/paper/publication-pack.json.',
-    'This host did not require a local TeX compiler to generate the source package.',
-    'Before final arXiv upload, compile with a TeX toolchain and preview the PDF in arXiv.',
-    '',
-  ].join('\n'), 'utf-8');
+  writeFileSync(
+    join(outDir, 'README-arxiv.txt'),
+    [
+      'Audrey arXiv source package',
+      '',
+      'Main file: main.tex',
+      'Bibliography: references.bib',
+      '',
+      'Generated from docs/paper/audrey-paper-v1.md and docs/paper/publication-pack.json.',
+      'This host did not require a local TeX compiler to generate the source package.',
+      'Before final arXiv upload, compile with a TeX toolchain and preview the PDF in arXiv.',
+      '',
+    ].join('\n'),
+    'utf-8',
+  );
 
   const files = [
     fileRecord(outDir, 'main.tex', SOURCE_MARKDOWN),

package/scripts/create-paper-submission-bundle.mjs

@@ -138,10 +138,14 @@ export async function writePaperSubmissionBundle(options = {}) {
   const claimVerification = await verifyPaperClaims();
   const publicationPackVerification = await verifyPublicationPack();
   if (!claimVerification.ok) {
-    throw new Error(`Cannot create paper submission bundle with invalid claims: ${claimVerification.failures.join('; ')}`);
+    throw new Error(
+      `Cannot create paper submission bundle with invalid claims: ${claimVerification.failures.join('; ')}`,
+    );
   }
   if (!publicationPackVerification.ok) {
-    throw new Error(`Cannot create paper submission bundle with invalid publication pack: ${publicationPackVerification.failures.join('; ')}`);
+    throw new Error(
+      `Cannot create paper submission bundle with invalid publication pack: ${publicationPackVerification.failures.join('; ')}`,
+    );
   }
 
   rmSync(outDir, { recursive: true, force: true });

package/scripts/finalize-release.mjs

@@ -67,7 +67,8 @@ function safeRepoRelativePath(value, label) {
 function normalizeArgs(args) {
   args.version = safeVersion(args.version);
   args.artifactDir = safeRepoRelativePath(args.artifactDir, '--artifact-dir');
-  if (args.commitMessage !== null) args.commitMessage = safeString(args.commitMessage, '--commit-message');
+  if (args.commitMessage !== null)
+    args.commitMessage = safeString(args.commitMessage, '--commit-message');
   if (args.npmOtp !== null) args.npmOtp = safeString(args.npmOtp, '--npm-otp');
   return args;
 }
@@ -109,7 +110,8 @@ function parseArgs(argv = process.argv.slice(2)) {
 
   for (let i = 0; i < argv.length; i++) {
     const token = argv[i];
-    if ((token === '--version' || token === '--target-version') && argv[i + 1]) args.version = argv[++i];
+    if ((token === '--version' || token === '--target-version') && argv[i + 1])
+      args.version = argv[++i];
     else if (token === '--artifact-dir' && argv[i + 1]) args.artifactDir = argv[++i];
     else if (token === '--commit-message' && argv[i + 1]) args.commitMessage = argv[++i];
     else if (token === '--npm-otp' && argv[i + 1]) args.npmOtp = argv[++i];
@@ -162,7 +164,9 @@ function commandFor(command, args) {
   if (!RELEASE_COMMANDS.has(command)) {
     throw new Error(`Unsupported release command: ${command}`);
   }
-  const safeArgs = args.map((arg, index) => safeString(String(arg), `${command} argument ${index + 1}`));
+  const safeArgs = args.map((arg, index) =>
+    safeString(String(arg), `${command} argument ${index + 1}`),
+  );
   if (process.platform === 'win32' && command === 'npm') {
     return { command: 'cmd.exe', args: ['/d', '/c', 'npm', ...safeArgs] };
   }
@@ -218,7 +222,9 @@ function listArtifacts(artifactDir, version) {
   }
 
   return files.map(path => ({
-    path: path.startsWith(ROOT) ? path.slice(ROOT.length + 1).replaceAll('\\', '/') : path.replaceAll('\\', '/'),
+    path: path.startsWith(ROOT)
+      ? path.slice(ROOT.length + 1).replaceAll('\\', '/')
+      : path.replaceAll('\\', '/'),
     sha256: sha256(path),
     bytes: readFileSync(path).byteLength,
   }));
@@ -280,15 +286,23 @@ function buildPlan(args) {
   if (args.tag) commands.push(`git tag -a ${tagName} -m "Audrey ${args.version}"`);
   if (args.push) commands.push(`git push origin HEAD:master --follow-tags`);
   if (args.pack) commands.push(`npm pack --pack-destination ${args.artifactDir}`);
-  if (args.sourceBundle) commands.push(`git bundle create ${args.artifactDir}/audrey-${args.version}.git.bundle refs/heads/master refs/tags/v${args.version}`);
+  if (args.sourceBundle)
+    commands.push(
+      `git bundle create ${args.artifactDir}/audrey-${args.version}.git.bundle refs/heads/master refs/tags/v${args.version}`,
+    );
   if (args.publishNpm) {
     const otp = args.npmOtp ? ' --otp <provided>' : '';
-    commands.push(`npm publish ${args.artifactDir}/audrey-${args.version}.tgz --access public --registry ${NPM_REGISTRY}${otp}`);
+    commands.push(
+      `npm publish ${args.artifactDir}/audrey-${args.version}.tgz --access public --registry ${NPM_REGISTRY}${otp}`,
+    );
   }
-  if (args.publishPypi) commands.push(`python -m twine upload python/dist/audrey_memory-${args.version}*`);
+  if (args.publishPypi)
+    commands.push(`python -m twine upload python/dist/audrey_memory-${args.version}*`);
 
   if (actions.length === 0) {
-    blockers.push('Select at least one action such as --pack, --source-bundle, --commit, --tag, --push, --publish-npm, or --publish-pypi');
+    blockers.push(
+      'Select at least one action such as --pack, --source-bundle, --commit, --tag, --push, --publish-npm, or --publish-pypi',
+    );
   }
   if (args.publishPypi && !pypiCredentialEnv()) {
     blockers.push('Set TWINE_PASSWORD, PYPI_API_TOKEN, or UV_PUBLISH_TOKEN before --publish-pypi');
@@ -312,12 +326,18 @@ function buildPlan(args) {
 }
 
 function runReadiness(plan) {
-  const readiness = run('node', ['scripts/verify-release-readiness.mjs', '--allow-pending', '--json'], { timeout: 180_000 });
+  const readiness = run(
+    'node',
+    ['scripts/verify-release-readiness.mjs', '--allow-pending', '--json'],
+    { timeout: 180_000 },
+  );
   plan.results.push(readiness);
   assertOk(readiness);
   const report = JSON.parse(readiness.stdout);
   if (!report.ok) {
-    throw new Error(`release readiness failed: ${report.failures?.join('; ') || 'unknown failure'}`);
+    throw new Error(
+      `release readiness failed: ${report.failures?.join('; ') || 'unknown failure'}`,
+    );
   }
   plan.readiness = {
     ok: report.ok,
@@ -367,7 +387,20 @@ function createSourceBundle(args, plan) {
   }
 
   const tree = assertOk(run('git', ['write-tree'], { env })).stdout;
-  const commit = assertOk(run('git', ['commit-tree', tree, '-p', 'HEAD', '-m', args.commitMessage ?? `Release Audrey ${args.version}`], { env })).stdout;
+  const commit = assertOk(
+    run(
+      'git',
+      [
+        'commit-tree',
+        tree,
+        '-p',
+        'HEAD',
+        '-m',
+        args.commitMessage ?? `Release Audrey ${args.version}`,
+      ],
+      { env },
+    ),
+  ).stdout;
   const tagContent = [
     `object ${commit}`,
     'type commit',
@@ -384,17 +417,33 @@ function createSourceBundle(args, plan) {
   mkdirSync(join(gitDir, 'refs', 'heads'), { recursive: true });
   mkdirSync(join(gitDir, 'refs', 'tags'), { recursive: true });
   writeFileSync(join(gitDir, 'HEAD'), 'ref: refs/heads/master\n', 'utf-8');
-  writeFileSync(join(gitDir, 'config'), '[core]\n\trepositoryformatversion = 0\n\tfilemode = false\n\tbare = true\n', 'utf-8');
+  writeFileSync(
+    join(gitDir, 'config'),
+    '[core]\n\trepositoryformatversion = 0\n\tfilemode = false\n\tbare = true\n',
+    'utf-8',
+  );
   writeFileSync(join(gitDir, 'refs', 'heads', 'master'), `${commit}\n`, 'utf-8');
   writeFileSync(join(gitDir, 'refs', 'tags', `v${args.version}`), `${tag}\n`, 'utf-8');
 
-  const bundle = run('git', ['--git-dir', gitDir, 'bundle', 'create', bundlePath, 'refs/heads/master', `refs/tags/v${args.version}`], {
-    env: {
-      GIT_OBJECT_DIRECTORY: objectDir,
-      GIT_ALTERNATE_OBJECT_DIRECTORIES: fromRoot('.git/objects'),
+  const bundle = run(
+    'git',
+    [
+      '--git-dir',
+      gitDir,
+      'bundle',
+      'create',
+      bundlePath,
+      'refs/heads/master',
+      `refs/tags/v${args.version}`,
+    ],
+    {
+      env: {
+        GIT_OBJECT_DIRECTORY: objectDir,
+        GIT_ALTERNATE_OBJECT_DIRECTORIES: fromRoot('.git/objects'),
+      },
+      timeout: 180_000,
     },
-    timeout: 180_000,
-  });
+  );
   plan.results.push(bundle);
   assertOk(bundle);
 
@@ -410,7 +459,11 @@ function createSourceBundle(args, plan) {
     indexFile: '.tmp/release.index',
     bundle: args.artifactDir.replaceAll('\\', '/') + `/audrey-${args.version}.git.bundle`,
   };
-  writeFileSync(fromRoot('.tmp/release-git-object-report.json'), `${JSON.stringify(objectReport, null, 2)}\n`, 'utf-8');
+  writeFileSync(
+    fromRoot('.tmp/release-git-object-report.json'),
+    `${JSON.stringify(objectReport, null, 2)}\n`,
+    'utf-8',
+  );
   plan.sourceControl = objectReport;
 }
 
@@ -434,18 +487,22 @@ function execute(args, plan) {
   }
 
   if (args.push) {
-    const push = run('git', [
-      '-c',
-      'http.sslBackend=openssl',
-      '-c',
-      'credential.helper=',
-      '-c',
-      'core.askPass=',
-      'push',
-      'origin',
-      'HEAD:master',
-      '--follow-tags',
-    ], { timeout: 45_000 });
+    const push = run(
+      'git',
+      [
+        '-c',
+        'http.sslBackend=openssl',
+        '-c',
+        'credential.helper=',
+        '-c',
+        'core.askPass=',
+        'push',
+        'origin',
+        'HEAD:master',
+        '--follow-tags',
+      ],
+      { timeout: 45_000 },
+    );
     plan.results.push(push);
     assertOk(push);
   }
@@ -464,7 +521,14 @@ function execute(args, plan) {
     const whoami = run('npm', ['whoami', '--registry', NPM_REGISTRY]);
     plan.results.push(whoami);
     assertOk(whoami);
-    const publishArgs = ['publish', npmTarballPath(args.artifactDir, args.version), '--access', 'public', '--registry', NPM_REGISTRY];
+    const publishArgs = [
+      'publish',
+      npmTarballPath(args.artifactDir, args.version),
+      '--access',
+      'public',
+      '--registry',
+      NPM_REGISTRY,
+    ];
     if (args.npmOtp) publishArgs.push('--otp', args.npmOtp);
     const publish = run('npm', publishArgs, { timeout: 180_000 });
     plan.results.push(publish);
@@ -473,19 +537,29 @@ function execute(args, plan) {
 
   if (args.publishPypi) {
     const uploadEnv = pypiCredentialEnv();
-    if (!uploadEnv) throw new Error('Missing PyPI credentials: set TWINE_PASSWORD, PYPI_API_TOKEN, or UV_PUBLISH_TOKEN');
+    if (!uploadEnv)
+      throw new Error(
+        'Missing PyPI credentials: set TWINE_PASSWORD, PYPI_API_TOKEN, or UV_PUBLISH_TOKEN',
+      );
     const build = run('npm', ['run', 'python:release:check'], { timeout: 180_000 });
     plan.results.push(build);
     assertOk(build);
     const artifacts = pythonArtifactPaths(args.version);
     if (artifacts.length === 0) throw new Error(`No Python artifacts found for ${args.version}`);
-    const upload = run('python', ['-m', 'twine', 'upload', ...artifacts], { timeout: 180_000, env: uploadEnv });
+    const upload = run('python', ['-m', 'twine', 'upload', ...artifacts], {
+      timeout: 180_000,
+      env: uploadEnv,
+    });
     plan.results.push(upload);
     assertOk(upload);
   }
 
   plan.artifacts = listArtifacts(artifactDir, args.version);
-  writeFileSync(join(artifactDir, 'release-finalize-report.json'), `${JSON.stringify(plan, null, 2)}\n`, 'utf-8');
+  writeFileSync(
+    join(artifactDir, 'release-finalize-report.json'),
+    `${JSON.stringify(plan, null, 2)}\n`,
+    'utf-8',
+  );
 }
 
 function printPlan(plan, json) {
@@ -503,7 +577,8 @@ function printPlan(plan, json) {
   }
   if (plan.artifacts.length) {
     console.log('Artifacts:');
-    for (const artifact of plan.artifacts) console.log(`- ${artifact.path} sha256=${artifact.sha256}`);
+    for (const artifact of plan.artifacts)
+      console.log(`- ${artifact.path} sha256=${artifact.sha256}`);
   }
 }
 

package/scripts/prepare-release-cut.mjs

@@ -4,7 +4,8 @@ import { fileURLToPath } from 'node:url';
 
 const ROOT = process.cwd();
 const DEFAULT_TARGET_VERSION = '1.0.0';
-const VERSION_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
+const VERSION_RE =
+  /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-[0-9A-Za-z.-]+)?(?:\+[0-9A-Za-z.-]+)?$/;
 
 function fromRoot(path) {
   return resolve(ROOT, path);
@@ -34,7 +35,8 @@ function parseArgs(argv = process.argv.slice(2)) {
 
   for (let i = 0; i < argv.length; i++) {
     const token = argv[i];
-    if ((token === '--target-version' || token === '--version') && argv[i + 1]) args.targetVersion = argv[++i];
+    if ((token === '--target-version' || token === '--version') && argv[i + 1])
+      args.targetVersion = argv[++i];
     else if (token === '--date' && argv[i + 1]) args.date = argv[++i];
     else if (token === '--apply') args.apply = true;
     else if (token === '--json') args.json = true;
@@ -203,10 +205,14 @@ export function prepareReleaseCut(options = {}) {
   const versions = currentVersionSnapshot();
   const versionValues = Object.values(versions);
   const failures = [];
-  if (versionValues.some(value => !value)) failures.push('One or more release version surfaces are missing');
-  if (new Set(versionValues).size !== 1) failures.push(`Release version surfaces are not aligned: ${JSON.stringify(versions)}`);
+  if (versionValues.some(value => !value))
+    failures.push('One or more release version surfaces are missing');
+  if (new Set(versionValues).size !== 1)
+    failures.push(`Release version surfaces are not aligned: ${JSON.stringify(versions)}`);
   if (versions.packageJson && compareCoreVersions(targetVersion, versions.packageJson) < 0) {
-    failures.push(`Target version ${targetVersion} is lower than current package version ${versions.packageJson}`);
+    failures.push(
+      `Target version ${targetVersion} is lower than current package version ${versions.packageJson}`,
+    );
   }
 
   const files = plannedFiles(targetVersion, date).map(([path, after]) => {
@@ -251,7 +257,9 @@ async function main() {
     console.log(JSON.stringify(report, null, 2));
   } else if (report.ok) {
     const changed = report.files.filter(file => file.changed).map(file => file.path);
-    console.log(`${report.apply ? 'Applied' : 'Planned'} Audrey ${report.targetVersion} release cut: ${changed.length} file(s)`);
+    console.log(
+      `${report.apply ? 'Applied' : 'Planned'} Audrey ${report.targetVersion} release cut: ${changed.length} file(s)`,
+    );
     for (const file of changed) console.log(`- ${file}`);
   } else {
     console.error('Release cut preparation failed:');

package/scripts/publish-release-bundle.mjs

@@ -22,7 +22,8 @@ function parseArgs(argv = process.argv.slice(2)) {
 
   for (let i = 0; i < argv.length; i++) {
     const token = argv[i];
-    if ((token === '--version' || token === '--target-version') && argv[i + 1]) args.version = argv[++i];
+    if ((token === '--version' || token === '--target-version') && argv[i + 1])
+      args.version = argv[++i];
     else if (token === '--bundle' && argv[i + 1]) args.bundle = argv[++i];
     else if (token === '--remote' && argv[i + 1]) args.remote = argv[++i];
     else if (token === '--apply') args.apply = true;
@@ -72,7 +73,12 @@ function run(command, args, options = {}) {
 }
 
 function firstLine(result) {
-  return `${result.stderr}\n${result.stdout}`.split(/\r?\n/).map(line => line.trim()).find(Boolean) ?? '';
+  return (
+    `${result.stderr}\n${result.stdout}`
+      .split(/\r?\n/)
+      .map(line => line.trim())
+      .find(Boolean) ?? ''
+  );
 }
 
 function parseBundleRefs(output, version) {
@@ -101,9 +107,27 @@ function parseRemoteRefs(output, version) {
 }
 
 function remoteHead(args) {
-  let result = run('git', ['ls-remote', args.remote, 'refs/heads/master', `refs/tags/v${args.version}`], { timeout: 60_000 });
-  if (!result.ok && /schannel|AcquireCredentialsHandle|SEC_E_NO_CREDENTIALS/i.test(firstLine(result))) {
-    result = run('git', ['-c', 'http.sslBackend=openssl', 'ls-remote', args.remote, 'refs/heads/master', `refs/tags/v${args.version}`], { timeout: 60_000 });
+  let result = run(
+    'git',
+    ['ls-remote', args.remote, 'refs/heads/master', `refs/tags/v${args.version}`],
+    { timeout: 60_000 },
+  );
+  if (
+    !result.ok &&
+    /schannel|AcquireCredentialsHandle|SEC_E_NO_CREDENTIALS/i.test(firstLine(result))
+  ) {
+    result = run(
+      'git',
+      [
+        '-c',
+        'http.sslBackend=openssl',
+        'ls-remote',
+        args.remote,
+        'refs/heads/master',
+        `refs/tags/v${args.version}`,
+      ],
+      { timeout: 60_000 },
+    );
     result.fallback = 'openssl';
   }
   return result;
@@ -112,20 +136,26 @@ function remoteHead(args) {
 function publishFromBundle(args, refs) {
   const temp = mkdtempSync(join(tmpdir(), 'audrey-release-push-'));
   try {
-    const clone = run('git', ['clone', '--bare', resolve(ROOT, args.bundle), temp], { timeout: 120_000 });
+    const clone = run('git', ['clone', '--bare', resolve(ROOT, args.bundle), temp], {
+      timeout: 120_000,
+    });
     if (!clone.ok) return [clone];
-    const push = run('git', [
-      '-c',
-      'http.sslBackend=openssl',
-      '-c',
-      'credential.helper=',
-      '-c',
-      'core.askPass=',
-      'push',
-      args.remote,
-      `${refs.master}:refs/heads/master`,
-      `${refs.tag}:refs/tags/v${args.version}`,
-    ], { cwd: temp, timeout: 45_000 });
+    const push = run(
+      'git',
+      [
+        '-c',
+        'http.sslBackend=openssl',
+        '-c',
+        'credential.helper=',
+        '-c',
+        'core.askPass=',
+        'push',
+        args.remote,
+        `${refs.master}:refs/heads/master`,
+        `${refs.tag}:refs/tags/v${args.version}`,
+      ],
+      { cwd: temp, timeout: 45_000 },
+    );
     return [clone, push];
   } finally {
     rmSync(temp, { recursive: true, force: true });
@@ -135,16 +165,22 @@ function publishFromBundle(args, refs) {
 export function planPublish(args) {
   const verify = run('git', ['bundle', 'verify', args.bundle], { timeout: 60_000 });
   const remote = remoteHead(args);
-  const bundleRefs = verify.ok ? parseBundleRefs(verify.stdout, args.version) : { master: null, tag: null };
-  const remoteRefs = remote.ok ? parseRemoteRefs(remote.stdout, args.version) : { master: null, tag: null };
+  const bundleRefs = verify.ok
+    ? parseBundleRefs(verify.stdout, args.version)
+    : { master: null, tag: null };
+  const remoteRefs = remote.ok
+    ? parseRemoteRefs(remote.stdout, args.version)
+    : { master: null, tag: null };
   const blockers = [];
 
   if (!verify.ok) blockers.push(`Bundle verification failed: ${firstLine(verify)}`);
   if (!bundleRefs.master) blockers.push('Bundle is missing refs/heads/master');
   if (!bundleRefs.tag) blockers.push(`Bundle is missing refs/tags/v${args.version}`);
   if (!remote.ok) blockers.push(`Remote check failed: ${firstLine(remote)}`);
-  if (remoteRefs.tag && remoteRefs.tag !== bundleRefs.tag) blockers.push(`Remote v${args.version} already points at ${remoteRefs.tag}`);
-  if (remoteRefs.master === bundleRefs.master && remoteRefs.tag === bundleRefs.tag) blockers.push('Remote already matches the release bundle');
+  if (remoteRefs.tag && remoteRefs.tag !== bundleRefs.tag)
+    blockers.push(`Remote v${args.version} already points at ${remoteRefs.tag}`);
+  if (remoteRefs.master === bundleRefs.master && remoteRefs.tag === bundleRefs.tag)
+    blockers.push('Remote already matches the release bundle');
 
   return {
     schemaVersion: '1.0.0',
@@ -198,7 +234,10 @@ async function main() {
 }
 
 function isDirectRun() {
-  return Boolean(process.argv[1]) && resolve(process.argv[1]).toLowerCase() === fileURLToPath(import.meta.url).toLowerCase();
+  return (
+    Boolean(process.argv[1]) &&
+    resolve(process.argv[1]).toLowerCase() === fileURLToPath(import.meta.url).toLowerCase()
+  );
 }
 
 if (isDirectRun()) {