Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import {
existsSync,
lstatSync,
mkdirSync,
mkdtempSync,
readFileSync,
readlinkSync,
renameSync,
rmSync,
symlinkSync,
writeFileSync,
} from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { describe, expect, test } from 'vitest';
import { LAUNCH_CONFIG_NAME } from './init.ts';
import { removeOwnLaunchEntry } from './launch-json-removal.ts';
function project(): string {
const dir = mkdtempSync(join(tmpdir(), 'ok-launch-'));
mkdirSync(join(dir, '.claude'), { recursive: true });
return dir;
}
function writeLaunch(projectRoot: string, value: unknown): string {
const p = join(projectRoot, '.claude', 'launch.json');
writeFileSync(p, JSON.stringify(value, null, 2));
return p;
}
describe('removeOwnLaunchEntry', () => {
test('surgically removes OK’s entry, preserving a user’s other configuration', () => {
const dir = project();
try {
const p = writeLaunch(dir, {
version: '0.2.0',
configurations: [
{ name: 'My App', type: 'node', request: 'launch' },
{
name: LAUNCH_CONFIG_NAME,
runtimeExecutable: '/bin/sh',
runtimeArgs: ['-l', '-c', '# ok-ui-v1\nexec ok start'],
},
],
});
const outcome = removeOwnLaunchEntry(dir);
expect(outcome.kind).toBe('removed');
const after = JSON.parse(readFileSync(p, 'utf-8'));
expect(after.configurations).toHaveLength(1);
expect(after.configurations[0].name).toBe('My App');
expect(after.version).toBe('0.2.0');
} finally {
rmSync(dir, { recursive: true, force: true });
}
});
test('keeps the containing file when OK’s entry was the only configuration', () => {
const dir = project();
try {
const p = writeLaunch(dir, {
version: '0.2.0',
configurations: [
{
name: LAUNCH_CONFIG_NAME,
runtimeExecutable: '/bin/sh',
runtimeArgs: ['-l', '-c', '# ok-ui-v1\nexec ok start'],
},
],
});
const outcome = removeOwnLaunchEntry(dir);
expect(outcome.kind).toBe('removed');
expect(existsSync(p)).toBe(true);
expect(JSON.parse(readFileSync(p, 'utf8'))).toEqual({
version: '0.2.0',
configurations: [],
});
} finally {
rmSync(dir, { recursive: true, force: true });
}
});
test.each([
['@inkeep/open-knowledge', 'ui'],
['-y', '@inkeep/open-knowledge', 'ui'],
['-y', '@inkeep/open-knowledge@latest', 'ui'],
])('removes the historical generated npx form %j', (...runtimeArgs) => {
const dir = project();
try {
const p = writeLaunch(dir, {
configurations: [
{ name: 'My App', type: 'node' },
{
name: LAUNCH_CONFIG_NAME,
runtimeExecutable: 'npx',
runtimeArgs,
},
],
});
expect(removeOwnLaunchEntry(dir).kind).toBe('removed');
expect(JSON.parse(readFileSync(p, 'utf8')).configurations).toEqual([
{ name: 'My App', type: 'node' },
]);
} finally {
rmSync(dir, { recursive: true, force: true });
}
});
test('not-present when there is no file, no configurations, or no OK entry', () => {
const dir = project();
try {
expect(removeOwnLaunchEntry(dir).kind).toBe('not-present');
writeLaunch(dir, { configurations: [{ name: 'Only Mine', type: 'node' }] });
expect(removeOwnLaunchEntry(dir).kind).toBe('not-present');
writeLaunch(dir, { version: '0.2.0' });
expect(removeOwnLaunchEntry(dir).kind).toBe('not-present');
} finally {
rmSync(dir, { recursive: true, force: true });
}
});
test('preserves a leading BOM while surgically removing OK’s entry', () => {
const dir = project();
try {
const p = join(dir, '.claude', 'launch.json');
const body = JSON.stringify(
{
version: '0.2.0',
configurations: [
{ name: 'My App', type: 'node' },
{
name: LAUNCH_CONFIG_NAME,
runtimeExecutable: '/bin/sh',
runtimeArgs: ['-l', '-c', '# ok-ui-v1\nexec ok start'],
},
],
},
null,
2,
);
writeFileSync(p, `\uFEFF${body}`);
expect(removeOwnLaunchEntry(dir).kind).toBe('removed');
const after = readFileSync(p, 'utf-8');
expect(after.charCodeAt(0)).toBe(0xfeff);
const parsed = JSON.parse(after.slice(1));
expect(parsed.configurations).toHaveLength(1);
expect(parsed.configurations[0].name).toBe('My App');
} finally {
rmSync(dir, { recursive: true, force: true });
}
});
test('declines a malformed launch.json, leaving it byte-identical', () => {
const dir = project();
try {
const p = join(dir, '.claude', 'launch.json');
const raw = '{ not valid json ]';
writeFileSync(p, raw);
expect(removeOwnLaunchEntry(dir).kind).toBe('declined');
expect(readFileSync(p, 'utf-8')).toBe(raw);
} finally {
rmSync(dir, { recursive: true, force: true });
}
});
test('preserves a same-name foreign configuration without a generated marker', () => {
const dir = project();
try {
const p = writeLaunch(dir, {
configurations: [
{
name: LAUNCH_CONFIG_NAME,
runtimeExecutable: '/bin/sh',
runtimeArgs: ['-l', '-c', 'exec my-own-preview'],
},
],
});
const before = readFileSync(p, 'utf8');
expect(removeOwnLaunchEntry(dir).kind).toBe('not-present');
expect(readFileSync(p, 'utf8')).toBe(before);
} finally {
rmSync(dir, { recursive: true, force: true });
}
});
});
describe('removeOwnLaunchEntry — symlinks', () => {
test.skipIf(process.platform === 'win32')(
'preserves a symlink and edits the destination launch configuration',
() => {
const dir = project();
try {
const p = writeLaunch(dir, {
configurations: [
{ name: 'My App', type: 'node' },
{
name: LAUNCH_CONFIG_NAME,
runtimeExecutable: 'npx',
runtimeArgs: ['-y', '@inkeep/open-knowledge', 'ui'],
},
],
});
const target = join(dir, 'dotfiles-launch.json');
renameSync(p, target);
symlinkSync('../dotfiles-launch.json', p);
expect(removeOwnLaunchEntry(dir).kind).toBe('removed');
expect(lstatSync(p).isSymbolicLink()).toBe(true);
expect(readlinkSync(p)).toBe('../dotfiles-launch.json');
expect(JSON.parse(readFileSync(target, 'utf8')).configurations).toEqual([
{ name: 'My App', type: 'node' },
]);
} finally {
rmSync(dir, { recursive: true, force: true });
}
},
);
test.skipIf(process.platform === 'win32').each(['dangling', 'cycle'])(
'declines a %s launch symlink without removing it',
(kind) => {
const dir = project();
try {
const p = join(dir, '.claude', 'launch.json');
symlinkSync(kind === 'cycle' ? 'launch.json' : 'missing.json', p);
expect(removeOwnLaunchEntry(dir)).toEqual({
kind: 'declined',
reason: kind === 'cycle' ? 'unresolved-symlink' : 'missing-symlink-target',
});
expect(lstatSync(p).isSymbolicLink()).toBe(true);
expect(existsSync(join(dir, '.claude', 'missing.json'))).toBe(false);
} finally {
rmSync(dir, { recursive: true, force: true });
}
},
);
});