fix: recover from native sqlite ABI mismatch

Author: Test User

docs/reference/commands.md

@@ -639,7 +639,7 @@ night-watch doctor --fix      # Auto-fix fixable issues
 
 **What it checks:**
 
-1. Node.js version (requires 18+)
+1. Node.js version (requires 22+)
 2. Git repository
 3. GitHub CLI (installed and authenticated)
 4. Provider CLI (Claude or Codex)

docs/reference/configuration.md

@@ -625,7 +625,7 @@ night-watch doctor --fix      # Auto-fix fixable issues
 
 **What it checks:**
 
-1. Node.js version (requires 18+)
+1. Node.js version (requires 22+)
 2. Git repository
 3. GitHub CLI (installed and authenticated)
 4. Provider CLI (Claude or Codex)

packages/cli/bin/night-watch.mjs

@@ -1,2 +1,66 @@
 #!/usr/bin/env node
-import('../dist/cli.js');
+import { spawnSync } from 'node:child_process';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), '..');
+const rebuildAttempted = process.env.NIGHT_WATCH_NATIVE_REBUILD_ATTEMPTED === '1';
+
+function isBetterSqliteNativeMismatch(error) {
+  const err = error ?? {};
+  const parts = [
+    err.code,
+    err.message,
+    err.stack,
+    err.cause?.code,
+    err.cause?.message,
+    err.cause?.stack,
+  ];
+  const text = parts.filter(Boolean).join('\n');
+
+  return (
+    text.includes('better_sqlite3.node') &&
+    (text.includes('NODE_MODULE_VERSION') || text.includes('ERR_DLOPEN_FAILED'))
+  );
+}
+
+function rebuildNativeSqlite() {
+  const npmBin = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+  console.error(
+    `[night-watch] Native SQLite module was built for a different Node.js version (${process.version}).`,
+  );
+  console.error('[night-watch] Rebuilding better-sqlite3 for the current Node.js runtime...');
+
+  const result = spawnSync(npmBin, ['rebuild', 'better-sqlite3'], {
+    cwd: packageRoot,
+    env: { ...process.env, NIGHT_WATCH_NATIVE_REBUILD_ATTEMPTED: '1' },
+    stdio: 'inherit',
+  });
+
+  if (result.error) {
+    console.error(`[night-watch] Failed to start npm rebuild: ${result.error.message}`);
+    process.exit(1);
+  }
+
+  if ((result.status ?? 1) !== 0) {
+    console.error('[night-watch] Failed to rebuild better-sqlite3. Try reinstalling Night Watch:');
+    console.error('  npm install -g @jonit-dev/night-watch-cli');
+    process.exit(result.status ?? 1);
+  }
+}
+
+async function run() {
+  try {
+    await import('../dist/cli.js');
+  } catch (error) {
+    if (!isBetterSqliteNativeMismatch(error) || rebuildAttempted) {
+      throw error;
+    }
+
+    rebuildNativeSqlite();
+    process.env.NIGHT_WATCH_NATIVE_REBUILD_ATTEMPTED = '1';
+    await import(`../dist/cli.js?native-rebuild=${Date.now()}`);
+  }
+}
+
+await run();

packages/cli/src/__tests__/package.test.ts

@@ -112,6 +112,16 @@ describe('Package Files', () => {
     expect(content.startsWith('#!/usr/bin/env node')).toBe(true);
   });
 
+  it('should recover from better-sqlite3 native Node ABI mismatches', () => {
+    const binPath = path.join(packageRoot, 'bin', 'night-watch.mjs');
+    const content = fs.readFileSync(binPath, 'utf-8');
+
+    expect(content).toContain('NODE_MODULE_VERSION');
+    expect(content).toContain('ERR_DLOPEN_FAILED');
+    expect(content).toContain("npmBin, ['rebuild', 'better-sqlite3']");
+    expect(content).toContain('NIGHT_WATCH_NATIVE_REBUILD_ATTEMPTED');
+  });
+
   it('should include scripts in package', () => {
     const scriptsDir = path.join(packageRoot, 'scripts');
     expect(fs.existsSync(scriptsDir)).toBe(true);

packages/cli/src/commands/doctor.ts

@@ -110,7 +110,7 @@ export function doctorCommand(program: Command): void {
         checkNum++,
         totalChecks,
         'Node.js version',
-        () => checkNodeVersion(18),
+        () => checkNodeVersion(22),
         options,
       );
       if (nodeResult.passed) passedChecks++;