Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import { spawnSync } from 'node:child_process';
import { existsSync } from 'node:fs';
import { afterEach, describe, expect, test } from 'vitest';
import {
createGitTriangle,
type GitTriangle,
} from '../../tests/support/git-fixture.test-helper.ts';
const triangles: GitTriangle[] = [];
function newTriangle(): GitTriangle {
const t = createGitTriangle();
triangles.push(t);
return t;
}
afterEach(() => {
for (const t of triangles.splice(0)) t.cleanup();
});
function gitExit(cwd: string, args: string[]): number {
const r = spawnSync('git', args, { cwd, encoding: 'utf-8' });
return r.status ?? -1;
}
describe('createGitTriangle — send-side freshness drift cells', () => {
test('a clean pushed doc: on origin (cat-file passes) and unchanged (diff clean) -> current', () => {
const t = newTriangle();
t.seedAndPush('doc.md', '# hello\n');
const ref = `origin/${t.branch}`;
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:doc.md`])).toBe(0);
expect(gitExit(t.senderDir, ['diff', '--quiet', ref, '--', 'doc.md'])).toBe(0);
});
test('an untracked doc: missing from the origin ref -> absent', () => {
const t = newTriangle();
t.writeWorkingTree('new.md', '# never saved\n');
const ref = `origin/${t.branch}`;
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:new.md`])).not.toBe(0);
});
test('an uncommitted edit of a pushed doc: on origin but the working tree differs -> stale', () => {
const t = newTriangle();
t.seedAndPush('doc.md', 'v1\n');
t.writeWorkingTree('doc.md', 'v2 edited, not committed\n');
const ref = `origin/${t.branch}`;
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:doc.md`])).toBe(0);
expect(gitExit(t.senderDir, ['diff', '--quiet', ref, '--', 'doc.md'])).not.toBe(0);
});
test('a committed-but-unpushed edit: origin keeps the old blob, diff differs -> stale', () => {
const t = newTriangle();
t.seedAndPush('doc.md', 'v1\n');
t.commitWithoutPush('doc.md', 'v2 committed, not pushed\n');
const ref = `origin/${t.branch}`;
expect(t.git(t.senderDir, ['show', `${ref}:doc.md`])).toBe('v1');
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:doc.md`])).toBe(0);
expect(gitExit(t.senderDir, ['diff', '--quiet', ref, '--', 'doc.md'])).not.toBe(0);
});
test('an untracked file inside a pushed folder: diff is blind to it, status catches it -> stale', () => {
const t = newTriangle();
t.seedAndPush('docs/a.md', 'a\n');
t.writeWorkingTree('docs/new.md', 'brand new, unstaged\n');
const ref = `origin/${t.branch}`;
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:docs`])).toBe(0);
expect(gitExit(t.senderDir, ['diff', '--quiet', ref, '--', 'docs'])).toBe(0);
expect(
t.git(t.senderDir, ['status', '--porcelain', '--untracked-files=all', '--', 'docs']),
).not.toBe('');
});
test('a bare directory: absent from the ref with both drift probes silent -> empty', () => {
const t = newTriangle();
t.mkdirWorkingTree('hollow');
const ref = `origin/${t.branch}`;
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:hollow`])).not.toBe(0);
expect(t.git(t.senderDir, ['diff', '--name-only', ref, '--', 'hollow'])).toBe('');
expect(
t.git(t.senderDir, ['status', '--porcelain', '--untracked-files=all', '--', 'hollow']),
).toBe('');
});
test('a clean pushed symlink: unchanged -> current, and stored as a symlink (mode 120000)', () => {
const t = newTriangle();
t.seedSymlinkAndPush('link.md', 'target.md', '# target\n');
const ref = `origin/${t.branch}`;
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:link.md`])).toBe(0);
expect(gitExit(t.senderDir, ['diff', '--quiet', ref, '--', 'link.md'])).toBe(0);
expect(t.git(t.senderDir, ['ls-files', '--stage', '--', 'link.md']).startsWith('120000')).toBe(
true,
);
});
});
describe('createGitTriangle — receive-side rename / delete legs', () => {
test('renaming a doc on origin: new path present, old path gone, classified R by -M', () => {
const t = newTriangle();
t.seedAndPush('old.md', '# stable content that survives the move intact\n');
t.renameOnOrigin('old.md', 'new.md');
const ref = `origin/${t.branch}`;
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:new.md`])).toBe(0);
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:old.md`])).not.toBe(0);
const removingCommit = t.git(t.senderDir, ['log', '-1', '--format=%H', ref, '--', 'old.md']);
expect(removingCommit).not.toBe('');
const nameStatus = t.git(t.senderDir, [
'diff-tree',
'-M',
'-r',
'--name-status',
removingCommit,
]);
expect(nameStatus).toMatch(/^R\d*\told\.md\tnew\.md$/m);
});
test('a receiver clone observes the renamed path on origin', () => {
const t = newTriangle();
t.seedAndPush('old.md', '# content that moves\n');
t.renameOnOrigin('old.md', 'renamed.md');
const receiver = t.cloneReceiver();
const ref = `origin/${t.branch}`;
expect(gitExit(receiver, ['cat-file', '-e', `${ref}:renamed.md`])).toBe(0);
expect(gitExit(receiver, ['cat-file', '-e', `${ref}:old.md`])).not.toBe(0);
});
test('renaming a folder on origin: per-file R rows share the old prefix', () => {
const t = newTriangle();
t.seedAndPush('docs/a.md', 'alpha content long enough to match on similarity\n');
t.seedAndPush('docs/b.md', 'beta content long enough to match on similarity\n');
t.renameFolderOnOrigin('docs', 'knowledge');
const ref = `origin/${t.branch}`;
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:knowledge/a.md`])).toBe(0);
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:docs/a.md`])).not.toBe(0);
const removingCommit = t.git(t.senderDir, ['log', '-1', '--format=%H', ref, '--', 'docs']);
const nameStatus = t.git(t.senderDir, [
'diff-tree',
'-M',
'-r',
'--name-status',
removingCommit,
]);
expect(nameStatus).toMatch(/^R\d*\tdocs\/a\.md\tknowledge\/a\.md$/m);
expect(nameStatus).toMatch(/^R\d*\tdocs\/b\.md\tknowledge\/b\.md$/m);
});
test('deleting a doc on origin: removal commit exists with a D row (not an R)', () => {
const t = newTriangle();
t.seedAndPush('gone.md', '# will be deleted with no successor\n');
t.deleteOnOrigin('gone.md');
const ref = `origin/${t.branch}`;
expect(gitExit(t.senderDir, ['cat-file', '-e', `${ref}:gone.md`])).not.toBe(0);
const removingCommit = t.git(t.senderDir, ['log', '-1', '--format=%H', ref, '--', 'gone.md']);
expect(removingCommit).not.toBe('');
const nameStatus = t.git(t.senderDir, [
'diff-tree',
'-M',
'-r',
'--name-status',
removingCommit,
]);
expect(nameStatus).toMatch(/^D\tgone\.md$/m);
expect(nameStatus).not.toMatch(/^R/m);
});
test('a path that never existed: empty removal-commit lookup (never-on-branch, not deleted)', () => {
const t = newTriangle();
const ref = `origin/${t.branch}`;
const removingCommit = t.git(t.senderDir, ['log', '-1', '--format=%H', ref, '--', 'never.md']);
expect(removingCommit).toBe('');
});
});
describe('createGitTriangle — lifecycle', () => {
test('cleanup removes every temp repo it created', () => {
const t = createGitTriangle();
const { senderDir, originDir } = t;
const receiver = t.cloneReceiver();
expect(existsSync(senderDir)).toBe(true);
expect(existsSync(originDir)).toBe(true);
expect(existsSync(receiver)).toBe(true);
t.cleanup();
expect(existsSync(senderDir)).toBe(false);
expect(existsSync(originDir)).toBe(false);
expect(existsSync(receiver)).toBe(false);
});
});