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
// @vitest-environment node
import { describe, it, expect } from 'vitest';
import {
buildInstallFailureTask,
installLogTail,
INSTALL_FAILURE_LOG_TAIL_LINES,
INSTALL_FAILURE_LOG_TAIL_CHARS,
} from './installFailureTask.js';
describe('installLogTail', () => {
it('renders the hook log entries as text and keeps a short log whole', () => {
const tail = installLogTail([
{ kind: 'stage', text: 'venv' },
{ kind: 'log', text: 'creating venv' },
{ kind: 'error', text: 'boom' },
]);
expect(tail).toBe('venv\ncreating venv\nboom');
expect(tail).not.toMatch(/omitted/);
});
it('drops empty entries and non-arrays rather than emitting blank lines', () => {
expect(installLogTail([{ text: 'a' }, { text: ' ' }, {}, 'b'])).toBe('a\nb');
expect(installLogTail(null)).toBe('');
expect(installLogTail([])).toBe('');
});
it('keeps only the tail of a long log and says it truncated', () => {
const logs = Array.from({ length: INSTALL_FAILURE_LOG_TAIL_LINES + 40 }, (_, i) => ({ text: `line ${i}` }));
const tail = installLogTail(logs);
const lines = tail.split('\n');
// One extra line for the truncation note.
expect(lines).toHaveLength(INSTALL_FAILURE_LOG_TAIL_LINES + 1);
expect(lines[0]).toMatch(/omitted/);
// The LAST lines survive — the traceback is at the end of a failed install.
expect(tail).toContain(`line ${INSTALL_FAILURE_LOG_TAIL_LINES + 39}`);
expect(tail).not.toContain('line 0\n');
});
it('bounds the payload by characters too, so a few very long lines cannot blow up the body', () => {
const logs = [{ text: 'x'.repeat(INSTALL_FAILURE_LOG_TAIL_CHARS * 2) }];
const tail = installLogTail(logs);
expect(tail.length).toBeLessThanOrEqual(INSTALL_FAILURE_LOG_TAIL_CHARS + 64);
expect(tail).toMatch(/omitted/);
});
it('cuts the char cap on a line boundary rather than mid-token', () => {
const logs = [
{ text: 'y'.repeat(INSTALL_FAILURE_LOG_TAIL_CHARS) },
{ text: 'final traceback line' },
];
const body = installLogTail(logs).split('\n').slice(1).join('\n');
// The partially-retained first line is dropped whole; the last line survives intact.
expect(body).toBe('final traceback line');
});
it('never emits a lone surrogate when one huge line is cut mid-pair', () => {
// Pairs plus ONE trailing BMP char, so the fixed-width cut from the end lands
// at an ODD offset inside the pair region — an actual mid-pair slice. (An
// even-length all-pairs line always cuts cleanly and proves nothing.)
const logs = [{ text: `${'\u{1F40D}'.repeat(INSTALL_FAILURE_LOG_TAIL_CHARS)}x` }];
const tail = installLogTail(logs);
expect(tail).not.toMatch(/[\uD800-\uDBFF](?![\uDC00-\uDFFF])/);
expect(tail).not.toMatch(/(?<![\uD800-\uDBFF])[\uDC00-\uDFFF]/);
// Sanity: the tail really is the end of that line, so the guard had to fire.
expect(tail.endsWith('x')).toBe(true);
});
it('redacts home-directory paths and neutralizes fences in the log tail', () => {
const tail = installLogTail([
{ text: 'ERROR: could not write /Users/someone/Library/Caches/pip' },
{ text: ' File "/home/someone/.venv/lib/x.py", line 3' },
{ text: 'C:\\Users\\someone\\AppData\\Local\\pip' },
{ text: '``` echo pwned' },
]);
expect(tail).toContain('/Users/<user>/Library/Caches/pip');
expect(tail).toContain('/home/<user>/.venv');
expect(tail).toContain('C:\\Users\\<user>\\AppData');
expect(tail).not.toContain('someone');
expect(tail).not.toContain('```');
});
});
describe('buildInstallFailureTask', () => {
it('names the installer and the failing stage in the description', () => {
const { description } = buildInstallFailureTask({ label: 'FLUX.2 Runtime', stage: 'venv' });
expect(description).toBe('Fix FLUX.2 Runtime installer failure at the venv stage');
});
it('omits the stage clause when the surface reports no stage', () => {
const { description } = buildInstallFailureTask({ label: 'TRELLIS.2', stage: '' });
expect(description).toBe('Fix TRELLIS.2 installer failure');
});
it('carries the stage, error, surface and log tail into the agent prompt', () => {
const { prompt } = buildInstallFailureTask({
label: 'TRELLIS.2',
stage: 'clone',
error: 'git exited 128',
logs: [{ text: 'cloning repo' }, { text: 'fatal: repository not found' }],
surface: 'client/src/components/install/RuntimeInstallModal.jsx',
});
expect(prompt).toContain('Installer: TRELLIS.2');
expect(prompt).toContain('Failing stage: clone');
expect(prompt).toContain('Error: git exited 128');
expect(prompt).toContain('Reported from: client/src/components/install/RuntimeInstallModal.jsx');
expect(prompt).toContain('fatal: repository not found');
// The fenced tail is labelled so the queued agent reads it as evidence, not orders.
expect(prompt).toMatch(/untrusted third-party process output/i);
});
it('redacts the error line too — useInstallStream copies it into the logs as well', () => {
const raw = 'ERROR: no write access to /Users/someone/.cache/pip';
const { prompt } = buildInstallFailureTask({
label: 'FLUX.2 Runtime',
error: raw,
logs: [{ kind: 'error', text: raw }],
});
expect(prompt).not.toContain('someone');
expect(prompt).toContain('Error: ERROR: no write access to /Users/<user>/.cache/pip');
});
it('still produces a usable task when the stream failed with no message or logs', () => {
const { description, prompt } = buildInstallFailureTask({});
expect(description).toBe('Fix PortOS installer failure');
expect(prompt).toContain('Failing stage: (not reported)');
expect(prompt).toContain('Installer failed with no error message.');
expect(prompt).not.toContain('Install log tail');
});
});