Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import type { ShareTargetStatusResponse } from '@inkeep/open-knowledge-core';
import { cleanup, fireEvent, render, screen, waitFor, within } from '@testing-library/react';
import { useSyncExternalStore } from 'react';
import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
import type { GitSyncStatus } from '@/hooks/use-git-sync-status';
import { pendingReceiveNavStore } from '@/lib/share/pending-receive-nav-store';
let autoSyncWrites: boolean[] = [];
vi.doMock('@/lib/config-provider', () => ({
useConfigContext: () => ({
projectLocalBinding: {
patch: (value: { autoSync?: { enabled?: boolean } }) => {
if (value.autoSync?.enabled !== undefined) autoSyncWrites.push(value.autoSync.enabled);
return { ok: true };
},
},
projectLocalSynced: true,
}),
}));
let syncStatus: GitSyncStatus | null = null;
const syncStatusListeners = new Set<() => void>();
function setSyncStatus(next: GitSyncStatus | null): void {
syncStatus = next;
for (const listener of syncStatusListeners) listener();
}
vi.doMock('@/hooks/use-git-sync-status', () => ({
useGitSyncStatus: () =>
useSyncExternalStore(
(onStoreChange: () => void) => {
syncStatusListeners.add(onStoreChange);
return () => syncStatusListeners.delete(onStoreChange);
},
() => syncStatus,
),
useGitSyncStatusDetailed: () => ({ status: syncStatus, fetchError: null }),
}));
let syncTriggers: string[] = [];
vi.doMock('@/lib/trigger-sync', () => ({
triggerSync: (op: string) => {
syncTriggers.push(op);
return Promise.resolve();
},
}));
function makeSyncStatus(partial: Partial<GitSyncStatus>): GitSyncStatus {
return {
state: 'idle',
lastSyncUtc: '2026-07-06T00:00:00Z',
lastFetchUtc: null,
ahead: 0,
behind: 0,
conflictCount: 0,
hasRemote: true,
syncEnabled: true,
...partial,
};
}
function pullableSyncStatus(partial: Partial<GitSyncStatus> = {}): GitSyncStatus {
return makeSyncStatus({
syncEnabled: false,
state: 'disabled',
lastPullUtc: 'p0',
lastPullOutcome: null,
...partial,
});
}
const { ShareReceiveMissPanel } = await import('./ShareReceiveMissPanel');
const { __resetFollowOfferLatchForTests } = await import('./share-receive-miss-content');
type FetchTargetStatus = (req: {
projectPath: string;
branch: string;
path: string;
kind: 'doc' | 'folder';
}) => Promise<ShareTargetStatusResponse | null>;
function installBridge(fetchTargetStatus: FetchTargetStatus): void {
(window as { okDesktop?: unknown }).okDesktop = {
config: { projectPath: '/project' },
project: { fetchTargetStatus },
};
}
function stubVerdict(response: ShareTargetStatusResponse | null): FetchTargetStatus {
return () => Promise.resolve(response);
}
const DOC_NAV = { kind: 'doc' as const, path: 'notes/plan', branch: 'feature' };
async function renderResolved(nav: typeof DOC_NAV = DOC_NAV): Promise<HTMLElement> {
render(<ShareReceiveMissPanel nav={nav} />);
const panel = await screen.findByTestId('share-receive-miss-panel');
await screen.findByText((_, el) => el?.getAttribute('data-phase') === 'resolved');
return panel;
}
beforeEach(() => {
cleanup();
window.location.hash = '';
pendingReceiveNavStore.clear();
__resetFollowOfferLatchForTests();
});
afterEach(() => {
cleanup();
Reflect.deleteProperty(window, 'okDesktop');
window.location.hash = '';
pendingReceiveNavStore.clear();
autoSyncWrites = [];
syncTriggers = [];
syncStatus = null;
syncStatusListeners.clear();
});
describe('ShareReceiveMissPanel verdict surfaces', () => {
test('renamed verdict offers to open the redirect target', async () => {
installBridge(stubVerdict({ verdict: 'renamed', renamedTo: 'knowledge/new-plan' }));
const panel = await renderResolved();
expect(panel.getAttribute('data-verdict')).toBe('renamed');
expect(panel.textContent).toContain('moved to');
expect(panel.textContent).toContain('knowledge/new-plan');
expect(screen.getByTestId('share-receive-miss-open-renamed')).toBeTruthy();
expect(screen.getByTestId('share-receive-miss-browse')).toBeTruthy();
});
test('accepting the rename navigates to the redirect and re-arms the miss guard', async () => {
installBridge(stubVerdict({ verdict: 'renamed', renamedTo: 'knowledge/new-plan' }));
await renderResolved();
fireEvent.click(screen.getByTestId('share-receive-miss-open-renamed'));
expect(window.location.hash).toBe('#/knowledge/new-plan');
expect(pendingReceiveNavStore.getSnapshot()).toEqual({
kind: 'doc',
path: 'knowledge/new-plan',
repositoryPath: 'knowledge/new-plan',
branch: 'feature',
});
});
test('the verdict fetch preserves the share target file extension', async () => {
let captured: { path: string; branch: string; kind: string } | null = null;
installBridge((req) => {
captured = { path: req.path, branch: req.branch, kind: req.kind };
return Promise.resolve({ verdict: 'deleted' });
});
await renderResolved({ kind: 'doc', path: 'docs/moved.md', branch: 'main' });
expect(captured).toEqual({ path: 'docs/moved.md', branch: 'main', kind: 'doc' });
});
test('deleted verdict shows an honest removed message with a browse escape', async () => {
installBridge(stubVerdict({ verdict: 'deleted' }));
const panel = await renderResolved();
expect(panel.getAttribute('data-verdict')).toBe('deleted');
expect(panel.textContent).toContain('was removed from branch');
expect(panel.textContent).toContain('feature');
expect(screen.queryByTestId('share-receive-miss-open-renamed')).toBeNull();
expect(screen.getByTestId('share-receive-miss-browse')).toBeTruthy();
});
test('never-on-branch verdict is not messaged as removed', async () => {
installBridge(stubVerdict({ verdict: 'never-on-branch' }));
const panel = await renderResolved();
expect(panel.getAttribute('data-verdict')).toBe('never-on-branch');
expect(panel.textContent).toContain("isn't on branch");
expect(panel.textContent).toContain('may not have been pushed yet');
expect(panel.textContent).not.toContain('was removed');
});
test('on-origin verdict shows the stale-local pull guidance', async () => {
installBridge(stubVerdict({ verdict: 'on-origin' }));
const panel = await renderResolved();
expect(panel.getAttribute('data-verdict')).toBe('on-origin');
expect(panel.textContent).toContain('is behind');
expect(panel.textContent).toContain('Pull the latest changes');
});
test('changed-locally verdict shows the local-change message and enables auto-sync in place', async () => {
installBridge(stubVerdict({ verdict: 'changed-locally' }));
setSyncStatus(makeSyncStatus({ syncEnabled: false, state: 'disabled' }));
const panel = await renderResolved();
expect(panel.getAttribute('data-verdict')).toBe('changed-locally');
expect(panel.textContent).toContain('has been moved, renamed, or deleted');
expect(panel.textContent).not.toContain('Pull the latest changes');
expect(screen.getByTestId('share-receive-miss-browse')).toBeTruthy();
expect(screen.queryByTestId('share-receive-miss-sync-now')).toBeNull();
fireEvent.click(screen.getByTestId('share-receive-miss-enable-sync'));
const dialog = screen.getByRole('dialog');
expect(autoSyncWrites).toEqual([]);
fireEvent.click(within(dialog).getByRole('button', { name: 'Enable Auto (Pull and Push)' }));
expect(autoSyncWrites).toEqual([true]);
expect(window.location.hash).toBe('#/notes/');
});
test('changed-locally with auto-sync ON offers Sync now, not Enable auto-sync', async () => {
installBridge(stubVerdict({ verdict: 'changed-locally' }));
setSyncStatus(makeSyncStatus({ syncEnabled: true }));
const panel = await renderResolved();
expect(panel.getAttribute('data-verdict')).toBe('changed-locally');
expect(panel.textContent).toContain("hasn't synced yet");
expect(screen.getByTestId('share-receive-miss-sync-now')).toBeTruthy();
expect(screen.queryByTestId('share-receive-miss-enable-sync')).toBeNull();
});
test('a failed target-status fetch falls back to pull guidance', async () => {
installBridge(stubVerdict(null));
const panel = await renderResolved();
expect(panel.getAttribute('data-verdict')).toBe('unknown');
expect(panel.textContent).toContain('Pull the latest changes');
});
test('a rejected target-status fetch falls back to pull guidance', async () => {
installBridge(() => Promise.reject(new Error('ipc closed')));
const panel = await renderResolved();
expect(panel.getAttribute('data-verdict')).toBe('unknown');
expect(panel.textContent).toContain('Pull the latest changes');
});
test('no desktop bridge (web host) falls back to pull guidance without fetching', async () => {
Reflect.deleteProperty(window, 'okDesktop');
const panel = await renderResolved();
expect(panel.getAttribute('data-verdict')).toBe('unknown');
expect(panel.textContent).toContain('Pull the latest changes');
});
test('the browse-folder escape navigates to the parent folder view', async () => {
installBridge(stubVerdict({ verdict: 'deleted' }));
await renderResolved();
fireEvent.click(screen.getByTestId('share-receive-miss-browse'));
expect(window.location.hash).toBe('#/notes/');
});
test('folder-share copy substitutes the folder noun', async () => {
installBridge(stubVerdict({ verdict: 'deleted' }));
const panel = await renderResolved({ kind: 'folder', path: 'knowledge', branch: 'feature' });
expect(panel.textContent).toContain('folder');
});
test('exposes an accessible status region with a decorative icon', async () => {
installBridge(stubVerdict({ verdict: 'deleted' }));
const panel = await renderResolved();
expect(panel.getAttribute('role')).toBe('status');
expect(panel.querySelector('svg')?.getAttribute('aria-hidden')).toBe('true');
expect(screen.getByTestId('share-receive-miss-browse').textContent).toContain('Browse folder');
});
test('moves focus to the primary action when the verdict resolves', async () => {
installBridge(stubVerdict({ verdict: 'renamed', renamedTo: 'knowledge/new-plan' }));
await renderResolved();
expect(document.activeElement).toBe(screen.getByTestId('share-receive-miss-open-renamed'));
});
});
describe('ShareReceiveMissPanel pull recovery', () => {
test('the behind cell offers Pull latest changes on a pull-capable engine', async () => {
installBridge(stubVerdict({ verdict: 'on-origin' }));
setSyncStatus(pullableSyncStatus());
const panel = await renderResolved();
expect(panel.getAttribute('data-verdict')).toBe('on-origin');
expect(screen.getByTestId('share-receive-miss-pull-now')).toBeTruthy();
expect(panel.textContent).toContain('is behind');
expect(panel.textContent).not.toContain('then open the link again');
expect(screen.getByTestId('share-receive-miss-browse')).toBeTruthy();
expect(document.activeElement).toBe(screen.getByTestId('share-receive-miss-pull-now'));
});
test('a landed pull re-probes the target status once the follow offer is answered', async () => {
const verdicts: ShareTargetStatusResponse[] = [
{ verdict: 'on-origin' },
{ verdict: 'deleted' },
];
let probeCount = 0;
installBridge(() => Promise.resolve(verdicts[Math.min(probeCount++, verdicts.length - 1)]));
setSyncStatus(pullableSyncStatus());
const panel = await renderResolved();
fireEvent.click(screen.getByTestId('share-receive-miss-pull-now'));
expect(syncTriggers).toEqual(['pull']);
setSyncStatus(pullableSyncStatus({ lastPullUtc: 'p1', lastPullOutcome: 'succeeded' }));
const consent = await screen.findByRole('dialog');
fireEvent.click(within(consent).getByRole('button', { name: 'Cancel' }));
await waitFor(() => {
expect(panel.getAttribute('data-verdict')).toBe('deleted');
});
expect(probeCount).toBe(2);
});
test('a pull refused for an unsafe incoming symlink explains the pause instead of asking to retry', async () => {
installBridge(stubVerdict({ verdict: 'on-origin' }));
setSyncStatus(pullableSyncStatus());
await renderResolved();
fireEvent.click(screen.getByTestId('share-receive-miss-pull-now'));
setSyncStatus(
pullableSyncStatus({
lastPullUtc: 'p1',
lastPullOutcome: 'refused',
pausedReason: 'unsafe-incoming-symlinks',
refusedSymlinkPaths: ['notes/leak.md', 'skills/chain'],
}),
);
const failure = await screen.findByTestId('share-receive-miss-pull-error');
await waitFor(() => {
expect(failure.textContent).toContain('symlink');
});
expect(failure.textContent).not.toContain('Try again in a moment');
const refused = screen.getByTestId('sync-refused-symlinks');
expect(
within(refused)
.getAllByRole('listitem')
.map((item) => item.textContent),
).toEqual(['notes/leak.md', 'skills/chain']);
});
test('an already-syncing receiver re-probes directly, with no follow offer in between', async () => {
const verdicts: ShareTargetStatusResponse[] = [
{ verdict: 'on-origin' },
{ verdict: 'deleted' },
];
let probeCount = 0;
installBridge(() => Promise.resolve(verdicts[Math.min(probeCount++, verdicts.length - 1)]));
setSyncStatus(pullableSyncStatus({ syncEnabled: true, state: 'idle' }));
const panel = await renderResolved();
fireEvent.click(screen.getByTestId('share-receive-miss-pull-now'));
setSyncStatus(
pullableSyncStatus({
syncEnabled: true,
state: 'idle',
lastPullUtc: 'p1',
lastPullOutcome: 'succeeded',
}),
);
await waitFor(() => {
expect(panel.getAttribute('data-verdict')).toBe('deleted');
});
expect(probeCount).toBe(2);
expect(screen.queryByRole('dialog')).toBeNull();
expect(autoSyncWrites).toEqual([]);
});
});