hypomnema 1.3.4 → 1.4.1

package/scripts/smoke-pack.mjs

@@ -1,261 +0,0 @@
-#!/usr/bin/env node
-/**
- * scripts/smoke-pack.mjs — pre-publish smoke test
- *
- * Runs `npm pack`, installs the resulting tarball into an isolated temp
- * directory, and exercises the installed CLI to verify the published
- * artifact actually works. Catches mistakes that local tests miss:
- *   - `files:` / `.npmignore` excluding required assets
- *   - `bin` entry pointing to a missing file
- *   - runtime requires on paths not shipped in the tarball
- *
- * Usage:
- *   node scripts/smoke-pack.mjs [--keep]
- *
- * --keep   Leave the temp directory in place for inspection on success.
- */
-
-import { spawnSync } from 'node:child_process';
-import {
-  mkdtempSync,
-  rmSync,
-  readFileSync,
-  writeFileSync,
-  existsSync,
-  readdirSync,
-  renameSync,
-} from 'node:fs';
-import { join } from 'node:path';
-import { tmpdir } from 'node:os';
-import { fileURLToPath } from 'node:url';
-
-const REPO = join(fileURLToPath(new URL('.', import.meta.url)), '..');
-const KEEP = process.argv.includes('--keep');
-
-// When this script runs inside `npm publish --dry-run` (the release workflow's
-// publish-credential pre-check), npm exports `npm_config_dry_run=true` into the
-// lifecycle environment. spawnSync inherits process.env, so the nested
-// `npm pack` below would ALSO run in dry-run mode — reporting a tarball
-// filename/size it never actually writes to disk — and the subsequent
-// `npm install <tarball>` then fails with ENOENT (npm maps errno -2 → exit 254).
-// Strip the flag so the nested npm commands always perform real writes,
-// matching the real tag-push publish job (which has no outer `--dry-run`). The
-// outer workflow stays dry-run and still skips the registry PUT.
-// (This was the precheck-254 root cause; the earlier "missing NODE_AUTH_TOKEN"
-// theory was wrong — it is file absence, not auth.)
-const npmEnv = { ...process.env };
-for (const key of Object.keys(npmEnv)) {
-  if (key.toLowerCase().replaceAll('-', '_') === 'npm_config_dry_run') {
-    delete npmEnv[key];
-  }
-}
-
-const PKG = JSON.parse(readFileSync(join(REPO, 'package.json'), 'utf-8'));
-const PKG_NAME = PKG.name;
-
-function run(cmd, args, opts = {}) {
-  const res = spawnSync(cmd, args, { stdio: 'pipe', encoding: 'utf-8', ...opts });
-  if (res.status !== 0) {
-    process.stderr.write(res.stdout || '');
-    process.stderr.write(res.stderr || '');
-    throw new Error(`${cmd} ${args.join(' ')} exited ${res.status}`);
-  }
-  return res;
-}
-
-function step(msg) {
-  console.log(`\n▸ ${msg}`);
-}
-
-const work = mkdtempSync(join(tmpdir(), 'hypo-smoke-'));
-const sandboxHome = join(work, 'home');
-const installRoot = join(work, 'install');
-const wikiDir = join(work, 'wiki');
-let cleanupOk = false;
-
-try {
-  // Capture pre-commit hook contents (if any) BEFORE pack so we can prove
-  // `npm pack` didn't mutate it. The `prepare` lifecycle script runs during
-  // `npm pack` and could theoretically touch .git/hooks/pre-commit; the
-  // installer's CI/lifecycle guards must prevent that.
-  const preCommitPath = join(REPO, '.git', 'hooks', 'pre-commit');
-  const preCommitBefore = existsSync(preCommitPath) ? readFileSync(preCommitPath, 'utf-8') : null;
-
-  step('npm pack');
-  const pack = run('npm', ['pack', '--json'], { cwd: REPO, env: npmEnv });
-  const meta = JSON.parse(pack.stdout)[0];
-  const tarball = join(REPO, meta.filename);
-  console.log(`  → ${meta.filename} (${meta.size} bytes, ${meta.entryCount} entries)`);
-
-  step(`install into ${installRoot}`);
-  run('mkdir', ['-p', installRoot]);
-  writeFileSync(
-    join(installRoot, 'package.json'),
-    JSON.stringify({
-      name: 'hypo-smoke-host',
-      version: '0.0.0',
-      private: true,
-    }) + '\n',
-  );
-  // No `--silent`: run() only prints npm's stdout/stderr on a non-zero exit, so
-  // a real nested-install failure must not be muted (the precheck-254 error was
-  // masked by `--silent` for two release cycles).
-  run('npm', ['install', '--no-audit', '--no-fund', tarball], { cwd: installRoot, env: npmEnv });
-
-  // Move tarball into the work dir so it's not left in the repo.
-  renameSync(tarball, join(work, meta.filename));
-
-  const cliBin = join(installRoot, 'node_modules', '.bin', 'hypomnema');
-  if (!existsSync(cliBin)) {
-    throw new Error(`bin not installed at ${cliBin}`);
-  }
-
-  step('hypomnema --help (installed)');
-  const help = run(cliBin, ['--help']);
-  if (!help.stdout.includes('Usage: hypomnema')) {
-    throw new Error('--help output did not match expected banner');
-  }
-
-  step('hypomnema init --dry-run (installed)');
-  const dryEnv = { ...process.env, HOME: sandboxHome, HYPO_DIR: wikiDir };
-  const dry = run(
-    cliBin,
-    [
-      'init',
-      '--dry-run',
-      `--hypo-dir=${wikiDir}`,
-      '--no-hooks',
-      '--no-commands',
-      '--no-git-init',
-      '--no-shell',
-    ],
-    { env: dryEnv },
-  );
-  if (!/dry[\s-]?run/i.test(dry.stdout + dry.stderr)) {
-    console.log(dry.stdout);
-    throw new Error('init --dry-run did not announce dry-run mode');
-  }
-
-  step('verify shipped assets are present');
-  const required = [
-    'scripts/init.mjs',
-    'scripts/upgrade.mjs',
-    'hooks',
-    'commands',
-    'templates',
-    'README.md',
-  ];
-  const pkgRoot = join(installRoot, 'node_modules', PKG_NAME);
-  for (const rel of required) {
-    if (!existsSync(join(pkgRoot, rel))) {
-      throw new Error(`shipped tarball missing: ${rel}`);
-    }
-  }
-
-  step('hypomnema feedback-sync (installed) — check/write idempotency + bootstrap');
-  // Seed a fixture wiki + claude-home and exercise the feedback-sync surface
-  // through the installed CLI (proves the subcommand is routed + shipped and the
-  // Phase D bootstrap helper runs end-to-end). --check exits 1 on a fresh
-  // (un-written) projection, so use spawnSync (run() throws on non-zero).
-  const fbWiki = join(work, 'fb-wiki');
-  const fbHome = join(work, 'fb-home');
-  const fbProject = 'smoke';
-  run('mkdir', ['-p', join(fbWiki, 'pages', 'feedback')]);
-  run('mkdir', ['-p', join(fbHome, 'projects', fbProject, 'memory')]);
-  writeFileSync(
-    join(fbWiki, 'hypo-config.md'),
-    '---\ntitle: config\ntype: reference\n---\n# config\n',
-  );
-  writeFileSync(
-    join(fbWiki, 'pages', 'feedback', 'smoke-rule.md'),
-    [
-      '---',
-      'title: Smoke Rule',
-      'type: feedback',
-      'status: active',
-      'scope: global',
-      'tier: L1',
-      'targets: [project-memory, claude-learned]',
-      'sensitivity: public',
-      'priority: 4',
-      'memory_summary: smoke rule for the packed CLI',
-      'global_summary: always smoke-test the packed CLI',
-      'promote_to_global: true',
-      'reason: catch packaging regressions',
-      'source: session:2026-05-21',
-      'updated: 2026-05-21',
-      '---',
-      'body',
-      '',
-    ].join('\n'),
-  );
-  writeFileSync(
-    join(fbHome, 'CLAUDE.md'),
-    '# Global\n<learned_behaviors>\n- [2026-05-20] legacy hand rule — 이유: bootstrap source\n</learned_behaviors>\n',
-  );
-  writeFileSync(join(fbHome, 'projects', fbProject, 'memory', 'MEMORY.md'), '# Memory Index\n');
-
-  const fbArgs = [`--hypo-dir=${fbWiki}`, `--claude-home=${fbHome}`, `--project-id=${fbProject}`];
-  const fbRun = (extra) =>
-    spawnSync(cliBin, ['feedback-sync', ...extra, ...fbArgs], { encoding: 'utf-8' });
-
-  const fbCheck1 = fbRun(['--check']);
-  if (fbCheck1.status !== 1) {
-    throw new Error(
-      `feedback-sync --check on fresh projection expected exit 1, got ${fbCheck1.status}`,
-    );
-  }
-  const fbWrite = fbRun(['--write']);
-  if (fbWrite.status !== 0) {
-    throw new Error(
-      `feedback-sync --write expected exit 0, got ${fbWrite.status}: ${fbWrite.stderr}`,
-    );
-  }
-  if (
-    !readFileSync(join(fbHome, 'CLAUDE.md'), 'utf-8').includes(
-      'HYPO:FEEDBACK-SYNC:START source=smoke-rule',
-    )
-  ) {
-    throw new Error('feedback-sync --write did not project the managed block into CLAUDE.md');
-  }
-  const fbCheck2 = fbRun(['--check']);
-  if (fbCheck2.status !== 0) {
-    throw new Error(
-      `feedback-sync --check after --write expected clean exit 0, got ${fbCheck2.status}`,
-    );
-  }
-  const fbBootstrap = fbRun(['--bootstrap', '--dry-run']);
-  if (fbBootstrap.status !== 0 || !/would create draft/.test(fbBootstrap.stderr)) {
-    throw new Error(
-      `feedback-sync --bootstrap --dry-run did not announce drafts (exit ${fbBootstrap.status})`,
-    );
-  }
-
-  step('verify pre-commit hook was not mutated by npm pack');
-  const preCommitAfter = existsSync(preCommitPath) ? readFileSync(preCommitPath, 'utf-8') : null;
-  if (preCommitBefore !== preCommitAfter) {
-    throw new Error(
-      'npm pack mutated .git/hooks/pre-commit — the prepare lifecycle ' +
-        'guard (npm_command=pack) is not firing.',
-    );
-  }
-
-  console.log('\n✓ smoke-pack passed');
-  cleanupOk = true;
-} catch (err) {
-  console.error(`\n✗ smoke-pack failed: ${err.message}`);
-  console.error(`  work dir preserved: ${work}`);
-  process.exitCode = 1;
-} finally {
-  if (cleanupOk && !KEEP) {
-    rmSync(work, { recursive: true, force: true });
-  } else if (KEEP) {
-    console.log(`\nwork dir kept: ${work}`);
-  }
-  // Sweep any stray tarballs left in the repo root from a crashed run.
-  for (const f of readdirSync(REPO)) {
-    if (f.startsWith(`${PKG_NAME}-`) && f.endsWith('.tgz')) {
-      rmSync(join(REPO, f), { force: true });
-    }
-  }
-}