Self-hosted, Self-Improving, Federated Everything App — dev management, agent orchestration, persistent mind, digital twin, second brain, and creative pipeline from a single dashboard over Tailscale to port the user into the OS
JavaScript ai-agentsdashboarddeveloper-toolsdigital-twinquantified-selfsecond-brainself-hostedtailscale
/**
* Parity guard for the auth-boundary documentation.
*
* AGENTS.md's Security Model is treated as ground truth by audits, so its Auth
* bullet must name every path in ALWAYS_PUBLIC_API_PATHS. It also guards against
* docs citing the retired bare `PUBLIC_API_PATHS` identifier.
*/
import { execFileSync } from 'child_process';
import { readFileSync } from 'fs';
import { dirname, join } from 'path';
import { fileURLToPath } from 'url';
import { describe, expect, it } from 'vitest';
import { ALWAYS_PUBLIC_API_PATHS } from '../server/lib/apiAccessPolicy.js';
const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..');
describe('auth-exempt path documentation', () => {
it('AGENTS.md Auth bullet names every always-public path and its source file', () => {
const bullet = readFileSync(join(ROOT, 'AGENTS.md'), 'utf8')
.split('\n')
.find((line) => line.startsWith('- **Auth**'));
expect(bullet).toBeDefined();
expect(bullet).toContain('server/lib/apiAccessPolicy.js');
for (const path of ALWAYS_PUBLIC_API_PATHS) expect(bullet).toContain(`\`${path}\``);
});
it('no tracked file cites the retired bare PUBLIC_API_PATHS identifier', () => {
let hits = '';
try {
hits = execFileSync(
'git',
['grep', '-nw', 'PUBLIC_API_PATHS', '--', ':!.changelog', ':!docs/plans', ':!docs/auth-public-paths-doc.test.js'],
{ cwd: ROOT, encoding: 'utf8' },
);
} catch (err) {
if (err.status !== 1) throw err; // 1 = no matches
}
expect(hits).toBe('');
});
});