Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import { mkdtempSync, rmSync } from 'node:fs';
import { tmpdir } from 'node:os';
import { join } from 'node:path';
import { afterEach, beforeEach, describe, expect, test } from 'vitest';
import type { GhDetectResult } from '../../auth/gh-detect.ts';
import { FileBackend } from '../../auth/token-store.ts';
import {
buildStatusPayload,
formatStoredEntryStatus,
resolveStatusSource,
resolveStoredEntryStatus,
} from './status.ts';
function makeStore(tmpDir: string) {
return new FileBackend(join(tmpDir, 'auth.yml'));
}
function ghAvailable(token = 'ghs_test_token'): (host?: string) => GhDetectResult {
return () => ({ available: true, token });
}
function ghUnavailable(): (host?: string) => GhDetectResult {
return () => ({ available: false });
}
describe('resolveStatusSource', () => {
let tmpDir: string;
beforeEach(() => {
tmpDir = mkdtempSync(join(tmpdir(), 'ok-resolve-status-'));
});
afterEach(() => {
rmSync(tmpDir, { recursive: true, force: true });
});
test('Tier A: gh available → { tier: "A", token: <gh token> }', async () => {
const store = makeStore(tmpDir);
const result = await resolveStatusSource('github.com', store, ghAvailable('gho_from_gh'));
expect(result).toEqual({ tier: 'A', token: 'gho_from_gh' });
});
test('Tier A takes priority over a stored token (regression guard for the bug this fix addresses)', async () => {
const store = makeStore(tmpDir);
await store.set('github.com', 'alice', 'gho_stored');
const result = await resolveStatusSource('github.com', store, ghAvailable('gho_from_gh'));
expect(result).toEqual({ tier: 'A', token: 'gho_from_gh' });
});
test('Tier B: gh unavailable + https stored token → { tier: "B", token: stored }', async () => {
const store = makeStore(tmpDir);
await store.set('github.com', 'alice', 'gho_stored', { gitProtocol: 'https' });
const result = await resolveStatusSource('github.com', store, ghUnavailable());
expect(result).toEqual({ tier: 'B', token: 'gho_stored' });
});
test('Tier B: stored token without explicit gitProtocol defaults to B', async () => {
const store = makeStore(tmpDir);
await store.set('github.com', 'alice', 'gho_stored');
const result = await resolveStatusSource('github.com', store, ghUnavailable());
expect(result.tier).toBe('B');
});
test('Tier C: gh unavailable + ssh stored token → { tier: "C", token: stored }', async () => {
const store = makeStore(tmpDir);
await store.set('github.com', 'alice', 'gho_stored', { gitProtocol: 'ssh' });
const result = await resolveStatusSource('github.com', store, ghUnavailable());
expect(result).toEqual({ tier: 'C', token: 'gho_stored' });
});
test('none: gh unavailable, no stored token', async () => {
const store = makeStore(tmpDir);
const result = await resolveStatusSource('github.com', store, ghUnavailable());
expect(result).toEqual({ tier: 'none' });
});
test('gh returns available:true but empty token → falls through to TokenStore', async () => {
const store = makeStore(tmpDir);
await store.set('github.com', 'alice', 'gho_stored');
const result = await resolveStatusSource(
'github.com',
store,
() => ({ available: true, token: '' }) as GhDetectResult,
);
expect(result.tier).toBe('B');
});
test('host is forwarded to the gh detector so GHES vs github.com auth does not bleed', async () => {
const seen: (string | undefined)[] = [];
const store = makeStore(tmpDir);
await resolveStatusSource('ghe.example.com', store, (host) => {
seen.push(host);
return { available: false };
});
expect(seen).toEqual(['ghe.example.com']);
});
});
describe('buildStatusPayload', () => {
test('surfaces the active backend when unauthenticated (no token) — the headless-Linux probe shape', () => {
expect(buildStatusPayload('github.com', 'file', { authenticated: false })).toEqual({
type: 'status',
host: 'github.com',
backend: 'file',
authenticated: false,
});
});
test('surfaces the active backend when authenticated', () => {
expect(
buildStatusPayload('github.com', 'keyring', {
authenticated: true,
tier: 'B',
login: 'alice',
name: 'Alice',
email: '[email protected]',
}),
).toEqual({
type: 'status',
host: 'github.com',
backend: 'keyring',
authenticated: true,
tier: 'B',
login: 'alice',
name: 'Alice',
email: '[email protected]',
});
});
test('surfaces the active backend alongside an invalid-token error', () => {
expect(
buildStatusPayload('github.com', 'file', { authenticated: false, error: 'token invalid' }),
).toEqual({
type: 'status',
host: 'github.com',
backend: 'file',
authenticated: false,
error: 'token invalid',
});
});
});
describe('resolveStoredEntryStatus', () => {
let tmpDir: string;
beforeEach(() => {
tmpDir = mkdtempSync(join(tmpdir(), 'ok-stored-entry-status-'));
});
afterEach(() => {
rmSync(tmpDir, { recursive: true, force: true });
});
test('a stored entry reports its login as unverified', async () => {
const store = makeStore(tmpDir);
await store.set('gitea.internal', 'alice', 'tok', { gitProtocol: 'https' });
expect(await resolveStoredEntryStatus('gitea.internal', store)).toEqual({
authenticated: false,
unverified: true,
login: 'alice',
});
});
test('no stored entry reports signed out', async () => {
expect(await resolveStoredEntryStatus('gitea.internal', makeStore(tmpDir))).toEqual({
authenticated: false,
});
});
});
describe('formatStoredEntryStatus', () => {
test('the unverified line names the login and host and never claims a GitHub identity', () => {
const line = formatStoredEntryStatus(
{ authenticated: false, unverified: true, login: 'alice' },
'gitea.internal',
);
expect(line).toContain('alice');
expect(line).toContain('gitea.internal');
expect(line).toContain('git uses this credential');
expect(line).not.toContain('Logged in as');
});
test('no stored entry names the command that stores one', () => {
const line = formatStoredEntryStatus({ authenticated: false }, 'gitea.internal');
expect(line).toContain('No token stored for gitea.internal');
expect(line).toContain('ok auth token --host gitea.internal --username <username>');
});
});