Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import { mkdirSync, mkdtempSync, realpathSync, rmSync, symlinkSync, writeFileSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
import { resolveDirectoryRoot, resolveExistingNativeAncestor } from './directory-root.ts';
import { getLogger } from './logger.ts';
describe('resolveDirectoryRoot', () => {
let scratch: string;
beforeEach(() => {
scratch = mkdtempSync(join(tmpdir(), 'ok-directory-root-'));
});
afterEach(() => {
vi.restoreAllMocks();
rmSync(scratch, { recursive: true, force: true });
});
function diagnosticSpies() {
const logger = getLogger('directory-root');
const warn = vi.spyOn(logger, 'warn');
const debug = vi.spyOn(logger, 'debug');
return () => [...warn.mock.calls, ...debug.mock.calls].map(([fields]) => fields);
}
it('returns the native spelling of an existing directory reached through a link, without a diagnostic', () => {
const target = join(scratch, 'target');
mkdirSync(target);
const link = join(scratch, 'link');
symlinkSync(target, link, 'dir');
const diagnostics = diagnosticSpies();
const resolved = resolveDirectoryRoot(link, { root: 'content', component: 'asset-walk' });
expect(resolved).toBe(realpathSync.native(target));
expect(diagnostics()).toEqual([]);
});
it('resolves the existing ancestor through an alias while retaining the absent tail separately', () => {
const target = join(scratch, 'target');
mkdirSync(target);
const alias = join(scratch, 'alias');
symlinkSync(target, alias, 'junction');
expect(resolveExistingNativeAncestor(join(alias, 'new', 'note.md'))).toEqual({
ancestor: realpathSync.native(target),
missingSegments: ['new', 'note.md'],
});
});
it('propagates cycles so membership and authoritative callers can apply their own error contracts', () => {
const loop = join(scratch, 'loop');
symlinkSync(loop, loop, 'dir');
expect(() => resolveExistingNativeAncestor(join(loop, 'note.md'))).toThrow();
});
it('keeps the given path and records which root stayed unresolved, with the errno, when native resolution fails', () => {
const file = join(scratch, 'not-a-directory');
writeFileSync(file, '');
const unresolvable = join(file, 'sub');
const diagnostics = diagnosticSpies();
const resolved = resolveDirectoryRoot(unresolvable, {
root: 'project',
component: 'persistence',
});
expect(resolved).toBe(unresolvable);
expect(diagnostics()).toEqual([
expect.objectContaining({ root: 'project', component: 'persistence', code: 'ENOTDIR' }),
]);
});
});