Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import { fileURLToPath } from 'node:url';
import { describe, expect, test } from 'vitest';
import { describeNativeFailure, requireNativeConfigModule } from './load-native-config.ts';
function withCapturedStderr(fn: () => void): string {
const original = process.stderr.write.bind(process.stderr);
const priorEnv = process.env.OK_DEBUG_NATIVE;
let captured = '';
process.env.OK_DEBUG_NATIVE = '1';
// biome-ignore lint/suspicious/noExplicitAny: minimal stderr.write spy for the test.
process.stderr.write = ((chunk: any) => {
captured += String(chunk);
return true;
}) as typeof process.stderr.write;
try {
fn();
} finally {
process.stderr.write = original;
if (priorEnv === undefined) delete process.env.OK_DEBUG_NATIVE;
else process.env.OK_DEBUG_NATIVE = priorEnv;
}
return captured;
}
const BROKEN_BINARY_URL = 'file:///app/dist/cli.mjs';
function moduleNotFound(id: string): never {
throw Object.assign(new Error(`Cannot find module '${id}'`), { code: 'MODULE_NOT_FOUND' });
}
const BUNDLED_MODULE_URL = 'file:///app/dist/cli.mjs';
const SENTINEL_BUNDLED = { source: 'bundled' };
const SENTINEL_WORKSPACE = { source: 'workspace' };
function bundledLoaderPath(moduleUrl: string): string {
return fileURLToPath(moduleUrl).replace(/cli\.mjs$/, 'native/index.js');
}
describe('requireNativeConfigModule resolution order', () => {
test('loads the dist-relative bundle first when present', () => {
const expectedBundlePath = bundledLoaderPath(BUNDLED_MODULE_URL);
let workspaceTried = false;
const mod = requireNativeConfigModule({
moduleUrl: BUNDLED_MODULE_URL,
requireModule: (id) => {
if (id === expectedBundlePath) return SENTINEL_BUNDLED;
workspaceTried = true;
return SENTINEL_WORKSPACE;
},
});
expect(mod).toBe(SENTINEL_BUNDLED);
expect(workspaceTried).toBe(false);
});
test('falls back to the workspace package when no bundled binary exists', () => {
const mod = requireNativeConfigModule({
moduleUrl: BUNDLED_MODULE_URL,
requireModule: (id) => {
if (id === '@inkeep/open-knowledge-native-config') return SENTINEL_WORKSPACE;
throw new Error(`MODULE_NOT_FOUND: ${id}`);
},
});
expect(mod).toBe(SENTINEL_WORKSPACE);
});
test('returns null when neither the bundle nor the workspace package resolves', () => {
const mod = requireNativeConfigModule({
moduleUrl: BUNDLED_MODULE_URL,
requireModule: (id) => {
throw new Error(`MODULE_NOT_FOUND: ${id}`);
},
});
expect(mod).toBeNull();
});
test('computes the bundled path relative to the calling module dir', () => {
const requested: string[] = [];
requireNativeConfigModule({
moduleUrl: 'file:///somewhere/else/dist/index.mjs',
requireModule: (id) => {
requested.push(id);
if (id.endsWith('index.js')) return SENTINEL_BUNDLED;
throw new Error(`MODULE_NOT_FOUND: ${id}`);
},
});
expect(requested).toContain('/somewhere/else/dist/native/index.js');
});
});
describe('broken-binary diagnostic (OK_DEBUG_NATIVE)', () => {
test('surfaces a present-but-broken binary, distinct from the silent no-binary case', () => {
const captured = withCapturedStderr(() => {
const mod = requireNativeConfigModule({
moduleUrl: BROKEN_BINARY_URL,
requireModule: () => {
throw new Error('dlopen failed: wrong ELF class');
},
});
expect(mod).toBeNull();
});
expect(captured).toContain('native-config');
expect(captured).toContain('dlopen failed');
});
test('stays silent for the no-binary case even under OK_DEBUG_NATIVE', () => {
const captured = withCapturedStderr(() => {
const mod = requireNativeConfigModule({
moduleUrl: BROKEN_BINARY_URL,
requireModule: (id) => moduleNotFound(id),
});
expect(mod).toBeNull();
});
expect(captured).toBe('');
});
});
describe('describeNativeFailure', () => {
test('renders the innermost cause first and drops the outermost past the bound', () => {
let err = new Error('link-1');
for (let i = 2; i <= 6; i++) err = Object.assign(new Error(`link-${i}`), { cause: err });
const rendered = describeNativeFailure('load failed', err);
expect(rendered).toBe('load failed: link-1 -> link-2 -> link-3 -> link-4 -> link-5');
expect(rendered).not.toContain('link-6');
});
test('terminates on a cause chain that points back into itself', () => {
const outer = new Error('outer');
const inner = Object.assign(new Error('inner'), { cause: outer });
outer.cause = inner;
const rendered = describeNativeFailure('load failed', outer);
expect(rendered).toBe('load failed: inner -> outer');
});
test('renders a non-Error without a chain', () => {
expect(describeNativeFailure('load failed', null)).toBe('load failed: null');
expect(describeNativeFailure('load failed', { code: 'EACCES' })).toBe(
'load failed: object keys=[code]',
);
});
});