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
import { describe, it, expect } from 'vitest';
import {
normalizeToken,
formatTaxonomyToken,
createTaxonomyTally
} from './taxonomyTally.js';
// A tiny fixture taxonomy exercising the engine through its single public seam
// (`createTaxonomyTally`), independent of the two LI consumers whose own suites pin
// the domain-facing contracts.
const VOCAB = ['alpha', 'beta', 'gamma'];
const SENTINEL = 'unknown-x';
const LABELS = { alpha: 'the alpha cause', beta: 'the beta cause', gamma: 'the gamma cause', [SENTINEL]: 'no known cause' };
const gloss = (t) => formatTaxonomyToken(t, LABELS);
const engine = createTaxonomyTally({
predicate: (r) => r.kind === 'counted',
select: (r) => r.token,
field: 'token',
vocabulary: VOCAB,
sentinel: SENTINEL,
glossFn: gloss,
gapWording: {
unknown: (n, total) => `${n} of ${total} with no known cause`,
unclassified: (n, total) => `${n} of ${total} not yet classified`
}
});
const rec = (token) => ({ kind: 'counted', token });
describe('normalizeToken', () => {
it('lowercases and collapses separators', () => {
expect(normalizeToken('Not_Planned')).toBe('not-planned');
expect(normalizeToken('Test Failure')).toBe('test-failure');
expect(normalizeToken(' git---conflict ')).toBe('git-conflict');
});
it('returns empty string for a non-string', () => {
expect(normalizeToken(null)).toBe('');
expect(normalizeToken(undefined)).toBe('');
expect(normalizeToken(42)).toBe('');
});
});
describe('formatTaxonomyToken', () => {
it('glosses a known token and passes an unglossed token through', () => {
expect(formatTaxonomyToken('alpha', LABELS)).toBe('the alpha cause');
expect(formatTaxonomyToken('future-token', LABELS)).toBe('future-token');
});
it('renders a nullish input as empty, never a sentinel', () => {
expect(formatTaxonomyToken(null, LABELS)).toBe('');
expect(formatTaxonomyToken(undefined, LABELS)).toBe('');
expect(formatTaxonomyToken('', LABELS)).toBe('');
});
});
describe('createTaxonomyTally — summarize', () => {
it('counts only population records, commonest first, and keys entries by field', () => {
const { entries, diagnosed, total } = engine.summarize(
[rec('beta'), rec('beta'), rec('alpha'), { kind: 'ignored', token: 'beta' }]
);
expect(entries).toEqual([{ token: 'beta', count: 2 }, { token: 'alpha', count: 1 }]);
expect(diagnosed).toBe(2 + 1);
expect(total).toBe(3);
});
it('breaks count ties by vocabulary order, independent of record order', () => {
const forward = engine.summarize([rec('gamma'), rec('alpha')]);
const reverse = engine.summarize([rec('alpha'), rec('gamma')]);
expect(forward.entries.map((e) => e.token)).toEqual(['alpha', 'gamma']);
expect(forward.entries).toEqual(reverse.entries);
});
it('separates the sentinel (unknown) from absent/unrecognized (unclassified)', () => {
const { entries, unknown, unclassified, diagnosed, total } = engine.summarize(
[rec('alpha'), rec(SENTINEL), rec(null), rec('not-in-vocab')]
);
expect(entries).toEqual([{ token: 'alpha', count: 1 }]);
expect(unknown).toBe(1);
expect(unclassified).toBe(2);
expect(diagnosed).toBe(1);
expect(total).toBe(4);
});
it('tolerates junk input and nullish records', () => {
expect(engine.summarize(null).total).toBe(0);
expect(engine.summarize([null, undefined, 'x']).total).toBe(0);
// Default arg: called with no records at all.
expect(engine.summarize().total).toBe(0);
});
});
describe('createTaxonomyTally — format', () => {
it('returns empty ONLY when the population is empty', () => {
expect(engine.format([])).toBe('');
expect(engine.format()).toBe('');
});
it('lists glossed diagnoses with counts, then names every non-zero gap', () => {
const line = engine.format([rec('alpha'), rec('alpha'), rec(SENTINEL), rec(null)]);
expect(line).toBe('the alpha cause (2) — 1 of 4 with no known cause — 1 of 4 not yet classified');
});
it('caps listed diagnoses at the limit but still counts the gap over everything', () => {
const line = engine.format([rec('alpha'), rec('beta'), rec('gamma'), rec(SENTINEL)], 2);
expect(line.split(' — ')[0].split(';').length).toBe(2);
expect(line).toContain('1 of 4 with no known cause');
});
it('never falls silent on an all-undiagnosed population', () => {
expect(engine.format([rec(null), rec(null)])).toBe('2 of 2 not yet classified');
});
it('defaults the limit to 3 listed diagnoses', () => {
const line = engine.format([rec('alpha'), rec('beta'), rec('gamma')]);
expect(line.split(';').length).toBe(3);
});
});