0xray 4.0.0 → 4.0.2

package/scripts/node/reconcile-version.mjs

@@ -1,147 +1,4 @@
 #!/usr/bin/env node
-/**
- * reconcile-version.mjs — Single version truth before bump/tag/publish.
- *
- * Sources: npm registry, package.json, latest git tag.
- *
- * Usage:
- *   node scripts/node/reconcile-version.mjs              # report
- *   node scripts/node/reconcile-version.mjs --check        # fail if not publish-ready
- *   node scripts/node/reconcile-version.mjs patch        # print next patch target
- *   node scripts/node/reconcile-version.mjs patch --apply # write package.json
- */
-
-import { execSync } from "child_process";
-import fs from "fs";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const rootDir = path.resolve(__dirname, "../..");
-const pkgPath = path.join(rootDir, "package.json");
-
-const args = process.argv.slice(2);
-const checkMode = args.includes("--check");
-const applyMode = args.includes("--apply");
-const printTarget = args.includes("--print-target");
-const bumpType = args.find((a) => ["major", "minor", "patch"].includes(a)) || null;
-
-function run(cmd) {
-  try {
-    return execSync(cmd, { cwd: rootDir, encoding: "utf-8" }).trim();
-  } catch {
-    return null;
-  }
-}
-
-function readLocalVersion() {
-  return JSON.parse(fs.readFileSync(pkgPath, "utf-8")).version;
-}
-
-function readPublishedVersion() {
-  const v = run("npm view 0xray version");
-  return v || "0.0.0";
-}
-
-function readLatestTag() {
-  const tag = run('git describe --tags --abbrev=0 2>/dev/null');
-  if (!tag) return null;
-  return tag.replace(/^v/, "");
-}
-
-function parseVersion(version) {
-  const [major, minor, patch] = version.split(".").map((n) => parseInt(n, 10));
-  return { major, minor, patch };
-}
-
-function bumpVersion(version, type) {
-  const v = parseVersion(version);
-  switch (type) {
-    case "major":
-      return `${v.major + 1}.0.0`;
-    case "minor":
-      return `${v.major}.${v.minor + 1}.0`;
-    case "patch":
-      return `${v.major}.${v.minor}.${v.patch + 1}`;
-    default:
-      return version;
-  }
-}
-
-function compare(a, b) {
-  const va = parseVersion(a);
-  const vb = parseVersion(b);
-  if (va.major !== vb.major) return va.major - vb.major;
-  if (va.minor !== vb.minor) return va.minor - vb.minor;
-  return va.patch - vb.patch;
-}
-
-function maxVersion(...versions) {
-  return versions.reduce((best, cur) => (compare(cur, best) > 0 ? cur : best));
-}
-
-function fail(msg) {
-  console.error(`❌ ${msg}`);
-  process.exit(1);
-}
-
-function main() {
-  const local = readLocalVersion();
-  const npm = readPublishedVersion();
-  const tag = readLatestTag();
-
-  const baseline = maxVersion(npm, tag || "0.0.0");
-  const target = bumpType ? bumpVersion(baseline, bumpType) : local;
-
-  if (printTarget && bumpType) {
-    console.log(target);
-    return;
-  }
-
-  console.log("\n=== Version Reconcile ===\n");
-  console.log(`  npm registry : ${npm}`);
-  console.log(`  package.json : ${local}`);
-  console.log(`  latest tag   : ${tag ? `v${tag}` : "(none)"}`);
-  if (bumpType) {
-    console.log(`  bump ${bumpType}  : ${target} (from baseline ${baseline})`);
-  }
-
-  if (applyMode && bumpType) {
-    const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
-    pkg.version = target;
-    fs.writeFileSync(pkgPath, JSON.stringify(pkg, null, 2) + "\n");
-    console.log(`\n✅ Updated package.json → ${target}`);
-  }
-
-  if (!checkMode) {
-    if (compare(local, npm) <= 0 && !bumpType) {
-      console.log("\n⚠️  Local version is not ahead of npm — bump before publishing.");
-    } else {
-      console.log("\n✅ Reconcile report complete.");
-    }
-    return;
-  }
-
-  // Strict checks for release gate / pre-tag
-  if (compare(local, npm) <= 0) {
-    fail(`package.json (${local}) must be > npm (${npm}). Run: node scripts/node/reconcile-version.mjs patch --apply`);
-  }
-
-  if (tag && compare(local, tag) < 0) {
-    fail(`package.json (${local}) is behind latest tag v${tag}`);
-  }
-
-  if (tag && compare(local, tag) === 0 && compare(npm, local) < 0) {
-    fail(`tag v${tag} exists but npm is only ${npm} — publish or retag`);
-  }
-
-  if (tag && compare(local, tag) > 0 && compare(npm, tag) === 0) {
-    console.log(`✅ Ready to tag v${local} (npm at ${npm})`);
-  } else if (compare(local, npm) > 0) {
-    console.log(`✅ Ready to publish ${local} (npm at ${npm})`);
-  } else {
-    console.log("✅ Version reconcile OK");
-  }
-}
-
-main();
+export * from "../foundry/reconcile-version.mjs";
+import { millMain } from "./foundry-shim.mjs";
+millMain(import.meta.url, "reconcile-version.mjs");

package/scripts/node/release-gate.mjs

@@ -1,75 +1,4 @@
 #!/usr/bin/env node
-/**
- * release-gate.mjs — Single release checkpoint.
- *
- * Modes:
- *   (default)     build + test + consumer smoke (fresh + upgrade merge)
- *   --verify-only git + reconcile + release docs + consumer smoke — after push, before publish
- *   --skip-smoke  skip consumer install smoke
- *   --skip-docs   skip release docs validation (not recommended for publish)
- *
- * Usage:
- *   node scripts/node/release-gate.mjs
- *   node scripts/node/release-gate.mjs --verify-only
- */
-
-import { execSync } from "child_process";
-import path from "path";
-import { fileURLToPath } from "url";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const rootDir = path.resolve(__dirname, "../..");
-const verifyOnly = process.argv.includes("--verify-only");
-const skipSmoke = process.argv.includes("--skip-smoke");
-const skipDocs = process.argv.includes("--skip-docs");
-
-function step(label, cmd) {
-  console.log(`\n${"─".repeat(60)}\n🔄 ${label}\n${"─".repeat(60)}\n`);
-  execSync(cmd, { cwd: rootDir, stdio: "inherit" });
-}
-
-function main() {
-  const mode = verifyOnly ? "verify" : "full";
-  console.log("\n╔════════════════════════════════════════════════════════╗");
-  console.log(`║        🛡️  0xRay Release Gate (${mode})`.padEnd(57) + "║");
-  console.log("╚════════════════════════════════════════════════════════╝");
-
-  try {
-    if (verifyOnly) {
-      step("1/5 Git + reconcile", "node scripts/node/pre-publish-guard.js --verify-only");
-      if (!skipDocs) {
-        step("2/5 Release docs", "node scripts/node/validate-release-docs.mjs");
-      }
-      step(
-        "3/5 Plugin infrastructure",
-        "node scripts/test/validate-plugins-e2e.cjs --structural-only",
-      );
-      if (!skipSmoke) {
-        step("4/5 Consumer install smoke", "node scripts/node/consumer-install-smoke.mjs");
-      }
-    } else {
-      step("1/6 Build", "npm run build");
-      step("2/6 Tests", "npm test");
-      step(
-        "3/6 Consumer hook verifiers",
-        "npm run verify:pre-commit-diff && npm run verify:pre-push-diff && node scripts/mjs/verify-delegation-gate-core.mjs --host=grok && node scripts/mjs/verify-delegation-gate-core.mjs --host=hermes && node scripts/mjs/verify-delegation-gate-core.mjs --host=opencode && node scripts/mjs/verify-hermes-session-start.mjs && node scripts/mjs/verify-confer-core.mjs && npm run verify:user-aside && npm run build && node scripts/mjs/verify-pipeline-facets.mjs --package-only",
-      );
-      step(
-        "4/6 Plugin infrastructure",
-        "node scripts/test/validate-plugins-e2e.cjs --structural-only",
-      );
-      if (!skipSmoke) {
-        step("5/6 Consumer install smoke (fresh + upgrade)", "node scripts/node/consumer-install-smoke.mjs");
-      }
-    }
-
-    console.log("\n╔════════════════════════════════════════════════════════╗");
-    console.log("║  ✅ RELEASE GATE PASSED                                ║");
-    console.log("╚════════════════════════════════════════════════════════╝\n");
-  } catch {
-    console.error("\n❌ RELEASE GATE FAILED — do not tag or publish\n");
-    process.exit(1);
-  }
-}
-
-main();
+export * from "../foundry/release-gate.mjs";
+import { millMain } from "./foundry-shim.mjs";
+millMain(import.meta.url, "release-gate.mjs");

package/scripts/node/release.mjs

@@ -1,172 +1,4 @@
 #!/usr/bin/env node
-
-/**
- * Canonical 0xRay release script.
- *
- * 1. Bump version from npm registry baseline (reconcile-version)
- * 2. Release artifacts (CHANGELOG / README / AGENTS / docs) — before gate so docs tests pass
- * 3. Release gate (build + test + consumer smoke)
- * 4. Commit release artifacts → push
- * 5. Verify gate (reconcile + git + release docs + smoke)
- * 6. npm publish (idempotent — skip if version already on registry)
- * 7. Tag → push tag (only after successful publish)
- *
- * Usage:
- *   npm run release:patch
- *   node scripts/node/release.mjs patch --dry-run
- */
-
-import { execSync } from "child_process";
-import fs from "fs";
-import path from "path";
-import { getReleaseArtifactPaths } from "./version-manager.mjs";
-
-const rootDir = process.cwd();
-const args = process.argv.slice(2);
-const dryRun = args.includes("--dry-run");
-const releaseType = args.find((a) => ["major", "minor", "patch"].includes(a));
-
-function run(cmd, label) {
-  console.log(`\n> ${cmd}`);
-  if (dryRun) {
-    console.log(`  (dry-run skip: ${label})`);
-    return;
-  }
-  execSync(cmd, { cwd: rootDir, stdio: "inherit", encoding: "utf-8" });
-}
-
-function readVersion() {
-  return JSON.parse(fs.readFileSync(path.join(rootDir, "package.json"), "utf-8")).version;
-}
-
-function currentBranch() {
-  return execSync("git rev-parse --abbrev-ref HEAD", { cwd: rootDir, encoding: "utf-8" }).trim();
-}
-
-function npmVersionPublished(version) {
-  try {
-    const out = execSync(`npm view 0xray@${version} version`, {
-      cwd: rootDir,
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "pipe"],
-    }).trim();
-    return out === version;
-  } catch {
-    return false;
-  }
-}
-
-function publishIdempotent(version) {
-  if (dryRun) {
-    console.log(`  would: npm publish --access public (check 0xray@${version} first)`);
-    return;
-  }
-  if (npmVersionPublished(version)) {
-    console.log(`ℹ️  0xray@${version} already on npm — skipping publish`);
-    return;
-  }
-  execSync("npm publish --access public", { cwd: rootDir, stdio: "inherit", encoding: "utf-8" });
-  console.log(`✅ Published 0xray@${version}`);
-}
-
-async function main() {
-  if (!releaseType || !["major", "minor", "patch"].includes(releaseType)) {
-    console.error("Usage: node scripts/node/release.mjs [patch|minor|major] [--dry-run]");
-    process.exit(1);
-  }
-
-  console.log("╔════════════════════════════════════════════════════════╗");
-  console.log("║        🚀 0xRay Release (canonical)                   ║");
-  console.log("╚════════════════════════════════════════════════════════╝");
-  if (dryRun) console.log("\n⚠️  DRY RUN — no writes, commits, tags, or publish\n");
-
-  // 1. Version bump from npm SSOT
-  console.log(`\n📦 Step 1: Bump ${releaseType} from npm baseline`);
-  if (dryRun) {
-    execSync(`node scripts/node/reconcile-version.mjs ${releaseType}`, { cwd: rootDir, stdio: "inherit" });
-  } else {
-    run(`node scripts/node/reconcile-version.mjs ${releaseType} --apply`, "version bump");
-  }
-  const newVersion = dryRun
-    ? execSync(`node scripts/node/reconcile-version.mjs ${releaseType} --print-target`, {
-        cwd: rootDir,
-        encoding: "utf-8",
-      }).trim()
-    : readVersion();
-  console.log(`📌 Release version: ${newVersion}`);
-
-  // 2. Artifacts BEFORE gate (docs vitest matches package.json version)
-  console.log("\n📦 Step 2: Release artifacts (CHANGELOG, README, AGENTS, docs)");
-  run("node scripts/node/version-manager.mjs --artifacts-only", "release artifacts");
-
-  // 3. Gate
-  console.log("\n📦 Step 3: Release gate (build + test + smoke)");
-  run("node scripts/node/release-gate.mjs", "release gate");
-
-  // 4. Commit + push
-  console.log("\n📦 Step 4: Commit & push");
-  const releaseFiles = getReleaseArtifactPaths();
-  if (!dryRun) {
-    run(`git add ${releaseFiles.join(" ")}`, "git add");
-    try {
-      execSync(`git commit --no-verify -m "release: v${newVersion}"`, { cwd: rootDir, stdio: "inherit" });
-    } catch (e) {
-      const out = String(e.stdout || e.stderr || "");
-      if (!out.includes("nothing to commit")) throw e;
-      console.log("ℹ️  Nothing to commit (release files unchanged)");
-    }
-  } else {
-    console.log(`  would: git add ${releaseFiles.join(" ")} && git commit -m "release: v${newVersion}"`);
-  }
-
-  const branch = currentBranch();
-  run(`git push origin ${branch}`, "git push");
-
-  // 5. Post-push verify before publish
-  console.log("\n📦 Step 5: Verify gate (reconcile + git + docs + smoke)");
-  run("node scripts/node/release-gate.mjs --verify-only", "verify gate");
-
-  // 6. Publish (idempotent)
-  console.log("\n📦 Step 6: npm publish");
-  publishIdempotent(newVersion);
-
-  // 7. Tag after publish
-  console.log("\n📦 Step 7: Tag");
-  if (!dryRun) {
-    try {
-      execSync(`git tag -a v${newVersion} -m "Release v${newVersion}"`, { cwd: rootDir, stdio: "inherit" });
-      console.log(`✅ Created tag v${newVersion}`);
-    } catch (e) {
-      const msg = String(e.stderr || e.message || "");
-      if (msg.includes("already exists")) {
-        console.log(`ℹ️  Tag v${newVersion} already exists`);
-      } else {
-        throw e;
-      }
-    }
-  } else {
-    console.log(`  would: git tag -a v${newVersion}`);
-  }
-  run(`git push origin v${newVersion}`, "push tag");
-
-  console.log("\n╔════════════════════════════════════════════════════════╗");
-  console.log("║        ✅ Release Complete!                            ║");
-  console.log("╚════════════════════════════════════════════════════════╝");
-  if (!dryRun) {
-    console.log(`\n📦 0xray@${newVersion}  🏷  v${newVersion}\n`);
-    const tweetPath = path.join(rootDir, "tweets", `v${newVersion}.md`);
-    if (!fs.existsSync(tweetPath)) {
-      fs.mkdirSync(path.join(rootDir, "tweets"), { recursive: true });
-      fs.writeFileSync(
-        tweetPath,
-        `🎉 0xRay v${newVersion} is LIVE - consumer-safe upgrades!\n...\n\`\`\`\nnpm install 0xray@latest\n\`\`\`\n`,
-      );
-      console.log(`📝 Tweet template: tweets/v${newVersion}.md`);
-    }
-  }
-}
-
-main().catch((err) => {
-  console.error("\n❌ Release failed:", err.message);
-  process.exit(1);
-});
+export * from "../foundry/release.mjs";
+import { millMain } from "./foundry-shim.mjs";
+millMain(import.meta.url, "release.mjs");

package/scripts/node/validate-release-docs.mjs

@@ -1,286 +1,4 @@
 #!/usr/bin/env node
-/**
- * validate-release-docs.mjs — Blocking guard for release doc freshness.
- *
- * Ensures README, AGENTS, SKILLS, CHANGELOG, Docusaurus headers, and required
- * guides match package.json version and live framework counts before tag/publish.
- *
- * Usage:
- *   node scripts/node/validate-release-docs.mjs
- *   node scripts/node/validate-release-docs.mjs --json
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import {
-  buildDocsHeader,
-  DOCS_SITE_HEADER_FILES,
-  getFrameworkCounts,
-  getReleaseArtifactPaths,
-} from './version-manager.mjs';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const defaultRoot = path.resolve(__dirname, '../..');
-
-const STANDARD_HEADER_RE =
-  /^\*{0,2}v[\d.]+\*{0,2}\s*—\s*a suit that survives the context window/m;
-
-/** Guides that must exist and reference the current release (body or header). */
-const REQUIRED_GUIDES = [
-  'docs-site/docs/guides/features-since-3.1.md',
-  'docs-site/docs/guides/features-json.md',
-  'docs-site/docs/guides/memory-routing.md',
-  'docs-site/docs/guides/aside-context.md',
-  'docs-site/docs/guides/repertoire.md',
-  'docs-site/docs/guides/integrations.md',
-  'docs-site/docs/guides/consumer-migration.md',
-  'docs-site/docs/mcp/README.md',
-  'docs-site/docs/agents/README.md',
-];
-
-const ROOT_DOC_CHECKS = [
-  {
-    rel: 'README.md',
-    validate: (content, version, counts, header) => {
-      const errors = [];
-      if (!content.includes(header)) {
-        errors.push(`missing kernel header (expected substring: ${header})`);
-      }
-      if (!content.includes('survive the context window') && !content.includes('survives the context window')) {
-        errors.push('missing context-window / exo kernel copy');
-      }
-      if (!content.includes('SKILLS.md')) {
-        errors.push('missing SKILLS.md reference in postinstall/docs section');
-      }
-      if (!content.includes('install-bridges') && !content.includes('installAllBridges')) {
-        errors.push('missing install-bridges / installAllBridges reference');
-      }
-      return errors;
-    },
-  },
-  {
-    rel: 'AGENTS.md',
-    validate: (content, version, counts) => {
-      const errors = [];
-      if (!content.includes(`**v${version}**`)) {
-        errors.push(`missing version marker **v${version}**`);
-      }
-      if (!content.includes('survive the context window') && !content.includes('survives the context window') && !content.includes('Exo, not catalog')) {
-        errors.push('missing exo / context-window kernel copy');
-      }
-      if (!content.includes('aside-context.md') && !content.includes('AsideContext')) {
-        errors.push('missing AsideContext documentation reference');
-      }
-      if (!content.includes('SKILLS.md')) {
-        errors.push('missing SKILLS.md link');
-      }
-      return errors;
-    },
-  },
-  {
-    rel: 'AGENTS-consumer.md',
-    validate: (content, version, counts) => {
-      const errors = [];
-      if (!content.includes(`**v${version}**`)) {
-        errors.push(`missing version marker **v${version}**`);
-      }
-      if (!content.includes('survive the context window') && !content.includes('survives the context window')) {
-        errors.push('consumer header missing context-window kernel copy');
-      }
-      if (!content.includes('SKILLS.md')) {
-        errors.push('missing SKILLS.md in postinstall section');
-      }
-      if (!content.includes('AsideContext')) {
-        errors.push('missing AsideContext section');
-      }
-      return errors;
-    },
-  },
-  {
-    rel: 'SKILLS.md',
-    validate: (content, version, counts) => {
-      const errors = [];
-      const expected = `**v${version}** — **${counts.skills} skills**`;
-      if (!content.includes(expected)) {
-        errors.push(`header stale (expected: ${expected})`);
-      }
-      return errors;
-    },
-  },
-];
-
-function readFile(rootDir, rel) {
-  const full = path.join(rootDir, rel);
-  if (!fs.existsSync(full)) return null;
-  return fs.readFileSync(full, 'utf-8');
-}
-
-function getPackageVersion(rootDir) {
-  const pkg = JSON.parse(fs.readFileSync(path.join(rootDir, 'package.json'), 'utf-8'));
-  return pkg.version;
-}
-
-function getCodexTermCount(rootDir) {
-  const codexPath = path.join(rootDir, '.xray/codex.json');
-  if (!fs.existsSync(codexPath)) return null;
-  const codex = JSON.parse(fs.readFileSync(codexPath, 'utf-8'));
-  return Object.keys(codex.terms || {}).length;
-}
-
-function validateChangelog(content, version) {
-  const errors = [];
-  const first = content.match(/^## \[([^\]]+)\]/m);
-  if (!first) {
-    errors.push('no version sections found');
-    return errors;
-  }
-  if (first[1] !== version) {
-    errors.push(`top CHANGELOG entry is [${first[1]}], expected [${version}]`);
-  }
-  if (!content.includes(`## [${version}]`)) {
-    errors.push(`missing ## [${version}] section`);
-  }
-  return errors;
-}
-
-function validateStandardHeader(content, expectedHeader, label) {
-  if (!content.includes(expectedHeader) && !STANDARD_HEADER_RE.test(content)) {
-    return [`${label}: missing kernel header (expected substring: ${expectedHeader})`];
-  }
-  return [];
-}
-
-function validateDocusaurusTagline(content) {
-  const errors = [];
-  if (!content.includes('survive the context window') && !content.includes('survives the context window')) {
-    errors.push('docusaurus.config.ts tagline missing context-window kernel copy');
-  }
-  return errors;
-}
-
-/**
- * @param {string} [rootDir]
- * @returns {{ ok: boolean; version: string; counts: object; errors: string[]; warnings: string[] }}
- */
-export function validateReleaseDocs(rootDir = defaultRoot) {
-  const errors = [];
-  const warnings = [];
-  const version = getPackageVersion(rootDir);
-  const counts = getFrameworkCounts(rootDir);
-  const expectedHeader = buildDocsHeader(counts, version);
-  const codexTerms = getCodexTermCount(rootDir);
-
-  if (codexTerms !== null && counts.codexTerms && codexTerms !== counts.codexTerms) {
-    warnings.push(`codex.json has ${codexTerms} terms (counts.codexTerms is ${counts.codexTerms})`);
-  }
-
-  const changelog = readFile(rootDir, 'CHANGELOG.md');
-  if (!changelog) {
-    errors.push('CHANGELOG.md missing');
-  } else {
-    errors.push(...validateChangelog(changelog, version).map((e) => `CHANGELOG.md: ${e}`));
-  }
-
-  for (const check of ROOT_DOC_CHECKS) {
-    const content = readFile(rootDir, check.rel);
-    if (!content) {
-      errors.push(`${check.rel}: file missing`);
-      continue;
-    }
-    const relErrors = check.validate(content, version, counts, expectedHeader);
-    for (const e of relErrors) {
-      errors.push(`${check.rel}: ${e}`);
-    }
-  }
-
-  for (const rel of DOCS_SITE_HEADER_FILES) {
-    const content = readFile(rootDir, rel);
-    if (!content) {
-      errors.push(`${rel}: file missing`);
-      continue;
-    }
-    errors.push(...validateStandardHeader(content, expectedHeader, rel));
-  }
-
-  for (const rel of REQUIRED_GUIDES) {
-    const content = readFile(rootDir, rel);
-    if (!content) {
-      errors.push(`${rel}: required guide missing`);
-      continue;
-    }
-    if (content.trim().length < 200) {
-      errors.push(`${rel}: guide too short — likely stub`);
-    }
-    if (rel.includes('features-since-3.1') && !content.includes(version)) {
-      errors.push(`${rel}: must reference current version ${version}`);
-    }
-  }
-
-  const docusaurus = readFile(rootDir, 'docs-site/docusaurus.config.ts');
-  if (!docusaurus) {
-    errors.push('docs-site/docusaurus.config.ts: missing');
-  } else {
-    errors.push(...validateDocusaurusTagline(docusaurus));
-  }
-
-  for (const rel of getReleaseArtifactPaths()) {
-    if (!fs.existsSync(path.join(rootDir, rel))) {
-      errors.push(`release artifact path missing: ${rel}`);
-    }
-  }
-
-  return {
-    ok: errors.length === 0,
-    version,
-    counts,
-    errors,
-    warnings,
-  };
-}
-
-function main() {
-  const jsonOut = process.argv.includes('--json');
-  const result = validateReleaseDocs();
-
-  if (!jsonOut) {
-    console.log('\n╔════════════════════════════════════════════════════════╗');
-    console.log('║        📚 Release Docs Validation                      ║');
-    console.log('╚════════════════════════════════════════════════════════╝');
-    console.log(`\n📌 package.json version: v${result.version}`);
-    console.log(
-      `📊 counts: ${result.counts.agents} agents · ${result.counts.skills} skills · ${result.counts.mcps} MCP servers\n`,
-    );
-  }
-
-  if (result.warnings.length > 0 && !jsonOut) {
-    console.log('⚠️  Warnings:');
-    for (const w of result.warnings) console.log(`   - ${w}`);
-    console.log();
-  }
-
-  if (!result.ok) {
-    if (jsonOut) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      console.error('❌ Release docs validation FAILED:\n');
-      for (const e of result.errors) console.error(`   • ${e}`);
-      console.error('\nFix docs then run: npm run version:sync');
-      console.error('Or: node scripts/node/validate-release-docs.mjs\n');
-    }
-    process.exit(1);
-  }
-
-  if (jsonOut) {
-    console.log(JSON.stringify(result, null, 2));
-  } else {
-    console.log('✅ Release docs validation passed\n');
-  }
-}
-
-const isMain =
-  process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url);
-
-if (isMain) {
-  main();
-}
+export * from "../foundry/validate-release-docs.mjs";
+import { millMain } from "./foundry-shim.mjs";
+millMain(import.meta.url, "validate-release-docs.mjs");