@monoes/monomindcli 2.11.1 → 2.11.3

package/dist/src/utils/native-binding.js

@@ -0,0 +1,281 @@
+/**
+ * Native-addon (better-sqlite3) load diagnosis and recovery.
+ *
+ * Issue #231: `monograph build` died with a raw NODE_MODULE_VERSION dump and the
+ * reporter then ran `npm rebuild better-sqlite3` five times — from their project
+ * directory and against a *separate* global `@monoes/monograph` install — while the
+ * binary that actually gets loaded lives several node_modules levels deeper, under
+ * the globally installed `monomind` -> `@monoes/monomindcli` -> `@monoes/monograph`.
+ * Every attempt left the file byte-identical because none of them ever touched it.
+ *
+ * So the useful thing to report is not "run npm rebuild" — it is *which physical
+ * file* is being loaded and *which directory* owns the node_modules tree it lives
+ * in, which is what these helpers derive.
+ */
+import { spawnSync } from 'node:child_process';
+import { accessSync, constants } from 'node:fs';
+import { createRequire } from 'node:module';
+import { delimiter, dirname } from 'node:path';
+function currentRuntime() {
+    return { nodeVersion: process.version, runtimeAbi: process.versions.modules };
+}
+/**
+ * Works out where a `.node` binary's package lives and which directory a rebuild
+ * has to run from. `rebuildCwd` is the part users can't guess: for a nested
+ * global install it is not the project, and not the top-level global package,
+ * but the intermediate package that owns the node_modules holding the binary.
+ */
+export function deriveRebuildTarget(binaryPath) {
+    const norm = binaryPath.replace(/\\/g, '/');
+    const lastIdx = norm.lastIndexOf('/node_modules/');
+    if (lastIdx === -1)
+        return null;
+    const rest = norm.slice(lastIdx + '/node_modules/'.length).split('/');
+    if (rest.length === 0 || rest[0] === '')
+        return null;
+    const nameSegs = rest[0].startsWith('@') ? rest.slice(0, 2) : rest.slice(0, 1);
+    if (nameSegs.length === 2 && !nameSegs[1])
+        return null;
+    const packageDir = `${norm.slice(0, lastIdx)}/node_modules/${nameSegs.join('/')}`;
+    // pnpm keeps every package in a content-addressed store at
+    // <root>/node_modules/.pnpm/<name>@<version>/node_modules/<name>. Rebuilding
+    // from inside the store is not how pnpm works — the rebuild is driven from the
+    // project/workspace root that owns the store.
+    const pnpmMarker = '/node_modules/.pnpm/';
+    const pnpmIdx = norm.indexOf(pnpmMarker);
+    if (pnpmIdx !== -1) {
+        return { packageManager: 'pnpm', rebuildCwd: norm.slice(0, pnpmIdx), packageDir };
+    }
+    return { packageManager: 'npm', rebuildCwd: norm.slice(0, lastIdx), packageDir };
+}
+function fixCommand(module, status, target) {
+    // `--build-from-source` matters for the ABI case specifically: a plain rebuild
+    // can resolve a cached prebuilt of the wrong ABI and change nothing at all.
+    const rebuild = target?.packageManager === 'pnpm'
+        ? `pnpm rebuild ${module}`
+        : `npm rebuild ${module}${status === 'abi-mismatch' ? ' --build-from-source' : ''}`;
+    return target ? `cd ${target.rebuildCwd} && ${rebuild}` : rebuild;
+}
+/** Message of an error plus its immediate cause, on one line. */
+function firstLine(err) {
+    if (!(err instanceof Error))
+        return String(err);
+    const cause = err.cause;
+    if (cause === undefined)
+        return err.message;
+    return `${err.message}: ${cause instanceof Error ? cause.message : String(cause)}`;
+}
+/**
+ * Flattens an error and its `.cause` chain into one searchable blob. The native
+ * failure arrives wrapped (MonographError('Failed to open database at …', cause)),
+ * and neither `.message` nor `.stack` of the wrapper contains the cause's text.
+ */
+function errorText(err, depth = 0) {
+    if (depth > 5)
+        return '';
+    if (!(err instanceof Error))
+        return String(err);
+    const cause = err.cause;
+    const head = `${err.message}\n${err.stack ?? ''}`;
+    return cause === undefined ? head : `${head}\n${errorText(cause, depth + 1)}`;
+}
+/**
+ * Turns a native-addon load failure into a diagnosis naming the running Node, the
+ * ABI the binary was built for, the file itself, and the exact fix command.
+ * Pure — takes the runtime facts rather than reading them, so it is testable.
+ */
+export function diagnoseNativeLoadError(err, module, runtime = currentRuntime(), 
+/**
+ * Absolute path of the module as resolved by the caller. The "bindings file not
+ * found" error lists only *candidate* paths, most of them relative, so there is
+ * nothing trustworthy in its text to locate the install from.
+ */
+resolvedModulePath) {
+    const raw = errorText(err);
+    const base = { module, nodeVersion: runtime.nodeVersion, runtimeAbi: runtime.runtimeAbi, raw };
+    const binaryPath = raw.match(/The module '([^']+)'/)?.[1];
+    const target = (binaryPath ? deriveRebuildTarget(binaryPath) : null) ??
+        (resolvedModulePath ? deriveRebuildTarget(resolvedModulePath) : null) ??
+        undefined;
+    // build.log is append-only, so several failures can pile up; match bounded
+    // pairs and take the last (most recent) one.
+    const pairs = [
+        ...raw.matchAll(/NODE_MODULE_VERSION (\d+)[\s\S]{0,200}?NODE_MODULE_VERSION (\d+)/g),
+    ];
+    if (pairs.length > 0) {
+        const [, builtForAbi] = pairs[pairs.length - 1];
+        return {
+            ...base,
+            status: 'abi-mismatch',
+            builtForAbi,
+            binaryPath,
+            target,
+            summary: `\`${module}\`'s native binary was built for Node ABI ${builtForAbi}, but this ` +
+                `process is Node ${runtime.nodeVersion} (ABI ${runtime.runtimeAbi})`,
+            fix: fixCommand(module, 'abi-mismatch', target),
+        };
+    }
+    if (/Could not locate the bindings file/i.test(raw)) {
+        return {
+            ...base,
+            status: 'missing-binary',
+            binaryPath,
+            target,
+            summary: `\`${module}\`'s native binary was never built for this platform (it does not exist — ` +
+                'not an ABI mismatch). Its install script was most likely blocked or failed silently',
+            fix: fixCommand(module, 'missing-binary', target),
+        };
+    }
+    return {
+        ...base,
+        status: 'load-error',
+        binaryPath,
+        target,
+        summary: `\`${module}\` failed to load: ${firstLine(err)}`,
+        fix: target ? fixCommand(module, 'load-error', target) : undefined,
+    };
+}
+/** Multi-line, human-facing rendering of a failed diagnosis. */
+export function formatNativeDiagnosis(diag) {
+    const lines = [diag.summary];
+    if (diag.binaryPath)
+        lines.push(`  binary  : ${diag.binaryPath}`);
+    if (diag.target)
+        lines.push(`  owned by: ${diag.target.rebuildCwd}`);
+    if (diag.fix)
+        lines.push(`  fix     : ${diag.fix}`);
+    if (diag.status === 'abi-mismatch') {
+        lines.push('  note    : rebuilding from your project directory, or reinstalling a different copy ' +
+            'of the package, will not touch the file above — the command must run in the ' +
+            'directory named there.');
+    }
+    return lines.join('\n');
+}
+/**
+ * A `require` rooted at @monoes/monograph, so `better-sqlite3` resolves exactly as
+ * it does for the code that actually uses it. Monograph is ESM-only (its exports
+ * map has no `require` condition), so `require.resolve` can't find it and
+ * `import.meta.resolve` has to do the locating. Falls back to resolving from this
+ * package when that isn't available.
+ */
+function requireFromMonograph() {
+    const here = createRequire(import.meta.url);
+    try {
+        const url = import.meta.resolve?.('@monoes/monograph');
+        if (url)
+            return createRequire(url);
+    }
+    catch {
+        /* fall back to this package's own resolution below */
+    }
+    return here;
+}
+/** Where `@monoes/monograph` resolves a module to, or undefined if it can't. */
+function resolveFromMonograph(module) {
+    try {
+        return requireFromMonograph().resolve(module);
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Diagnoses a failure thrown while monograph was using better-sqlite3, locating the
+ * install through monograph's own resolution rather than guessing from error text.
+ */
+export function diagnoseMonographNativeError(err) {
+    return diagnoseNativeLoadError(err, 'better-sqlite3', currentRuntime(), resolveFromMonograph('better-sqlite3'));
+}
+/**
+ * Loads the very same `better-sqlite3` copy `@monoes/monograph` will load (resolved
+ * from monograph's own location, not the CLI's — under nested installs they can
+ * differ, which is the whole point) and opens an in-memory database to force the
+ * addon binding.
+ *
+ * Runs in a child process on purpose. Once an addon has failed to dlopen in a
+ * process, later attempts report a useless "Module did not self-register" instead
+ * of the real ABI error — and doctor has other checks that touch sqlite before
+ * this one. A fresh process also means a binary that segfaults on load can't take
+ * doctor down with it.
+ */
+export function probeMonographSqliteBinding(runtime = currentRuntime()) {
+    const module = 'better-sqlite3';
+    const base = { module, nodeVersion: runtime.nodeVersion, runtimeAbi: runtime.runtimeAbi };
+    const entry = resolveFromMonograph(module);
+    if (!entry) {
+        return {
+            ...base,
+            status: 'load-error',
+            summary: `\`${module}\` could not be resolved from @monoes/monograph — is it installed?`,
+        };
+    }
+    const res = spawnSync(process.execPath, ['-e', `new (require(${JSON.stringify(entry)}))(':memory:').close()`], { encoding: 'utf8', timeout: 60_000 });
+    if (res.status === 0) {
+        return {
+            ...base,
+            status: 'ok',
+            binaryPath: entry,
+            summary: `${module} loads under Node ${runtime.nodeVersion} (ABI ${runtime.runtimeAbi})`,
+        };
+    }
+    const text = `${res.stderr ?? ''}\n${res.stdout ?? ''}`.trim();
+    const crashed = res.signal ? ` (killed by ${res.signal})` : '';
+    return diagnoseNativeLoadError(new Error(text || `probe exited with status ${res.status}${crashed}`), module, runtime, entry);
+}
+/**
+ * Decides whether monomind may rebuild the module itself. Deliberately
+ * conservative: a native rebuild mutates an install tree that may be a shared or
+ * root-owned global one, so it only runs when the current user can actually
+ * write there and the user hasn't opted out.
+ */
+export function planAutoRebuild(diag, opts = {}) {
+    if (diag.status === 'ok')
+        return { attempt: false, reason: 'binding already loads' };
+    if (opts.disabled)
+        return { attempt: false, reason: 'MONOMIND_NO_NATIVE_REBUILD is set' };
+    if (!diag.target)
+        return { attempt: false, reason: 'could not locate the install directory' };
+    const writable = opts.isWritable ?? defaultIsWritable;
+    if (!writable(diag.target.rebuildCwd)) {
+        return { attempt: false, reason: `${diag.target.rebuildCwd} is not writable by this user` };
+    }
+    return { attempt: true, reason: `rebuilding in ${diag.target.rebuildCwd}` };
+}
+function defaultIsWritable(dir) {
+    try {
+        accessSync(dir, constants.W_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Runs the single rebuild `planAutoRebuild` approved. */
+export function runNativeRebuild(diag) {
+    const target = diag.target;
+    if (!target)
+        return { ok: false, command: '', output: 'no rebuild target' };
+    const bin = target.packageManager === 'pnpm' ? 'pnpm' : 'npm';
+    const args = ['rebuild', diag.module];
+    if (bin === 'npm' && diag.status === 'abi-mismatch')
+        args.push('--build-from-source');
+    const res = spawnSync(bin, args, {
+        cwd: target.rebuildCwd,
+        encoding: 'utf8',
+        timeout: 15 * 60_000,
+        // node-gyp compiles against whichever `node` it finds on PATH. If monomind
+        // is running under a different Node than the PATH default — the exact
+        // situation that produces an ABI mismatch — an inherited PATH would rebuild
+        // for the wrong ABI again, so put the running Node first.
+        env: {
+            ...process.env,
+            PATH: `${dirname(process.execPath)}${delimiter}${process.env.PATH ?? ''}`,
+        },
+    });
+    return {
+        ok: res.status === 0,
+        command: `cd ${target.rebuildCwd} && ${bin} ${args.join(' ')}`,
+        output: `${res.stdout ?? ''}${res.stderr ?? ''}`.trim(),
+    };
+}
+//# sourceMappingURL=native-binding.js.map

package/dist/src/utils/native-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-binding.js","sourceRoot":"","sources":["../../../src/utils/native-binding.ts"],"names":[],"mappings":"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"}

package/dist/src/utils/native-error.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native-error.d.ts","sourceRoot":"","sources":["../../../src/utils/native-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2DrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1E"}
+{"version":3,"file":"native-error.d.ts","sourceRoot":"","sources":["../../../src/utils/native-error.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA0ErE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAG1E"}

package/dist/src/utils/native-error.js

@@ -1,3 +1,4 @@
+import { deriveRebuildTarget } from './native-binding.js';
 /**
  * Formats an Error together with its `.cause`, if present, so wrapper errors
  * (e.g. MonographError('Failed to open database at ...', err)) don't silently
@@ -30,8 +31,21 @@ export function classifyNativeModuleError(text) {
     ];
     if (pairs.length > 0) {
         const [, builtFor, required] = pairs[pairs.length - 1];
+        // Name the directory that actually owns the binary. Issue #231's reporter ran
+        // `npm rebuild` five times from their project and against a separate global
+        // copy, all of which left the loaded file byte-identical — because none of
+        // them was the tree it lives in.
+        const binaryPath = text.match(/The module '([^']+)'/)?.[1];
+        const target = binaryPath ? deriveRebuildTarget(binaryPath) : null;
+        const precise = target
+            ? `The binary actually loaded is ${binaryPath} — rebuild it where it lives: ` +
+                `\`cd ${target.rebuildCwd} && ${target.packageManager === 'pnpm'
+                    ? 'pnpm rebuild better-sqlite3'
+                    : 'npm rebuild better-sqlite3 --build-from-source'}\`. A rebuild run anywhere else will not touch that file. `
+            : '';
         return (`Native module built for Node ABI ${builtFor}, but this Node needs ABI ${required} ` +
-            `(NODE_MODULE_VERSION mismatch). Try: delete the module's build/ or prebuilds/ ` +
+            `(NODE_MODULE_VERSION mismatch). ${precise}` +
+            `Otherwise: delete the module's build/ or prebuilds/ ` +
             `directory and reinstall, or reinstall under the exact Node version you run ` +
             `monomind with. If a plain reinstall never changes the binary at all (same size, ` +
             `same mtime, every time), it's likely resolving a cached prebuilt asset instead of ` +

package/dist/src/utils/native-error.js.map

@@ -1 +1 @@
-{"version":3,"file":"native-error.js","sourceRoot":"","sources":["../../../src/utils/native-error.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAY;IAC/C,IAAI,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC;IAChD,MAAM,KAAK,GAAI,GAA2B,CAAC,KAAK,CAAC;IACjD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,OAAO,CAAC;IAC5C,MAAM,SAAS,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzE,OAAO,GAAG,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,IAAY;IACpD,0EAA0E;IAC1E,uEAAuE;IACvE,sEAAsE;IACtE,uEAAuE;IACvE,qEAAqE;IACrE,kDAAkD;IAClD,MAAM,KAAK,GAAG;QACZ,GAAG,IAAI,CAAC,QAAQ,CAAC,mEAAmE,CAAC;KACtF,CAAC;IACF,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACvD,OAAO,CACL,oCAAoC,QAAQ,6BAA6B,QAAQ,GAAG;YACpF,gFAAgF;YAChF,6EAA6E;YAC7E,kFAAkF;YAClF,oFAAoF;YACpF,8DAA8D;YAC9D,gFAAgF;YAChF,kFAAkF;YAClF,mFAAmF;YACnF,6EAA6E;YAC7E,gFAAgF;YAChF,6CAA6C,CAC9C,CAAC;IACJ,CAAC;IACD,IAAI,mDAAmD,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACnE,OAAO,CACL,8EAA8E;YAC9E,uFAAuF,CACxF,CAAC;IACJ,CAAC;IACD,0EAA0E;IAC1E,sEAAsE;IACtE,sEAAsE;IACtE,+DAA+D;IAC/D,yEAAyE;IACzE,uEAAuE;IACvE,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,gDAAgD,CAAC,CAAC;IAClF,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;QACvB,yEAAyE;QACzE,wEAAwE;QACxE,uEAAuE;QACvE,yEAAyE;QACzE,kEAAkE;QAClE,MAAM,WAAW,GAAG,IAAI;aACrB,KAAK,CAAC,WAAW,CAAC;aAClB,KAAK,CAAC,sDAAsD,CAAC,CAAC;QACjE,MAAM,UAAU,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QACpC,OAAO,CACL,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,CAAC,CAAC,CAAC,iBAAiB,gCAAgC;YACvF,wFAAwF;YACxF,sDAAsD;YACtD,iBAAiB,UAAU,IAAI,UAAU,8CAA8C;YACvF,iCAAiC,CAClC,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAAY;IACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,sDAAsD,CAAC,CAAC;IACjF,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"native-error.js","sourceRoot":"","sources":["../../../src/utils/native-error.ts"],"names":[],"mappings":"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"}