Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import { describe, expect, test } from 'vitest';
import {
type OffCwdCandidate,
type OffCwdResolverDeps,
projectDirOfLockDir,
resolveOffCwdTarget,
} from './off-cwd-resolver.ts';
function makeDeps(
candidates: OffCwdCandidate[],
realpathMap: Record<string, string> = {},
): OffCwdResolverDeps {
return {
discover: async () => candidates.map((c) => c.lockDir),
inspect: async (lockDir) => candidates.find((c) => c.lockDir === lockDir) ?? null,
realpath: async (p) => realpathMap[p] ?? p,
};
}
function candidate(contentDir: string, port: number, alive = true): OffCwdCandidate {
return {
lockDir: `${contentDir}/.ok/local`,
contentDir,
baseUrl: `http://127.0.0.1:${port}`,
alive,
};
}
describe('resolveOffCwdTarget', () => {
test('matches a target to the one server whose contentDir contains it', async () => {
const deps = makeDeps([candidate('/repo/feat-a', 5101), candidate('/repo/feat-b', 5102)]);
const r = await resolveOffCwdTarget('/repo/feat-b/specs/foo.md', deps);
expect(r).toEqual({ baseUrl: 'http://127.0.0.1:5102', docName: 'specs/foo' });
});
test('longest-prefix wins: nested worktree beats its parent checkout', async () => {
const deps = makeDeps([candidate('/repo', 5100), candidate('/repo/.claude/worktrees/b', 5102)]);
const r = await resolveOffCwdTarget('/repo/.claude/worktrees/b/docs/x.md', deps);
expect(r?.baseUrl).toBe('http://127.0.0.1:5102');
expect(r?.docName).toBe('docs/x');
});
test('contentDir != projectDir: matches the config-derived content subdir', async () => {
const deps = makeDeps([candidate('/proj/docs', 5103)]);
const r = await resolveOffCwdTarget('/proj/docs/guide.mdx', deps);
expect(r).toEqual({ baseUrl: 'http://127.0.0.1:5103', docName: 'guide' });
});
test('dead servers are skipped (liveness gate)', async () => {
const deps = makeDeps([
candidate('/repo/feat-b', 5102, false),
candidate('/repo/feat-a', 5101, true),
]);
const r = await resolveOffCwdTarget('/repo/feat-b/specs/foo.md', deps);
expect(r).toBeNull();
});
test('live shorter-prefix wins over a dead longer-prefix match (liveness gates before longest-prefix)', async () => {
const deps = makeDeps([candidate('/repo', 5101, true), candidate('/repo/feat-b', 5102, false)]);
const r = await resolveOffCwdTarget('/repo/feat-b/specs/foo.md', deps);
expect(r).toEqual({ baseUrl: 'http://127.0.0.1:5101', docName: 'feat-b/specs/foo' });
});
test('no server contains the target → null (caller ensures/refuses)', async () => {
const deps = makeDeps([candidate('/repo/feat-a', 5101)]);
const r = await resolveOffCwdTarget('/somewhere/else/notes.md', deps);
expect(r).toBeNull();
});
test('symlinked target is realpath-resolved before matching', async () => {
const deps = makeDeps([candidate('/repo/feat-b', 5102)], {
'/link/notes.md': '/repo/feat-b/notes.md',
});
const r = await resolveOffCwdTarget('/link/notes.md', deps);
expect(r).toEqual({ baseUrl: 'http://127.0.0.1:5102', docName: 'notes' });
});
test('a doc at the contentDir root resolves to its bare name', async () => {
const deps = makeDeps([candidate('/proj', 5104)]);
const r = await resolveOffCwdTarget('/proj/README.md', deps);
expect(r).toEqual({ baseUrl: 'http://127.0.0.1:5104', docName: 'README' });
});
test('an inspect failure on one candidate does not sink the resolution', async () => {
const good = candidate('/repo/feat-b', 5102);
const deps: OffCwdResolverDeps = {
discover: async () => ['/bad/.ok/local', good.lockDir],
inspect: async (d) => {
if (d === '/bad/.ok/local') throw new Error('stat failed');
return good;
},
realpath: async (p) => p,
};
const r = await resolveOffCwdTarget('/repo/feat-b/x.md', deps);
expect(r?.baseUrl).toBe('http://127.0.0.1:5102');
});
});
describe('projectDirOfLockDir', () => {
test('walks up from <projectDir>/.ok/local to <projectDir>', () => {
expect(projectDirOfLockDir('/repo/feat-a/.ok/local')).toBe('/repo/feat-a');
});
});