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, vi, beforeEach } from 'vitest';
import { act, render, screen, waitFor, within } from '@testing-library/react';
import userEvent from '@testing-library/user-event';
import { MemoryRouter } from 'react-router';
vi.mock('../services/api', () => ({
listLooms: vi.fn(),
createLoom: vi.fn(),
deleteLoom: vi.fn(),
generateLoomSeriesPlan: vi.fn(),
getProviders: vi.fn(),
listUniverseNames: vi.fn(),
listPipelineSeriesNames: vi.fn(),
}));
vi.mock('../components/sharing/SyncToPeerButton', () => ({
default: ({ recordKind, recordId }) => <button type="button">sync {recordKind} {recordId}</button>,
}));
const navigate = vi.fn();
vi.mock('react-router', async (importOriginal) => {
const actual = await importOriginal();
return { ...actual, useNavigate: () => navigate };
});
import * as api from '../services/api';
import FableLoom from './FableLoom';
// The list endpoint returns summaries, not the episode graphs.
const looms = [
{
id: 'loom-1',
name: 'The Hollow Crown',
logline: 'A crown that remembers.',
universeId: 'uni-1',
seriesId: null,
participationMode: 'helper',
updatedAt: '2026-08-20T00:00:00Z',
episodeCount: 1,
sceneCount: 3,
endingCount: 2,
},
];
const renderPage = async () => {
const result = render(<MemoryRouter><FableLoom /></MemoryRouter>);
await act(async () => {});
return result;
};
beforeEach(() => {
vi.clearAllMocks();
api.listLooms.mockResolvedValue(looms);
api.listUniverseNames.mockResolvedValue([{ id: 'uni-1', name: 'Aria Verse' }]);
api.listPipelineSeriesNames.mockResolvedValue([]);
api.getProviders.mockResolvedValue({
activeProvider: 'codex',
providers: [{
id: 'codex', name: 'Codex', enabled: true, command: 'codex',
defaultModel: 'gpt-5.6', models: ['gpt-5.6'],
}],
});
});
describe('FableLoom index', () => {
it('lists looms with episode/scene/ending stats and the universe chip', async () => {
await renderPage();
await waitFor(() => expect(screen.getByText('The Hollow Crown')).toBeInTheDocument());
expect(screen.getByText('1 episode')).toBeInTheDocument();
expect(screen.getByText('3 scenes')).toBeInTheDocument();
expect(screen.getByText('2 endings')).toBeInTheDocument();
expect(screen.getByText('Audience helper')).toBeInTheDocument();
expect(screen.getByRole('button', { name: 'sync fableLoom loom-1' })).toBeInTheDocument();
await waitFor(() => expect(screen.getByText('Aria Verse')).toBeInTheDocument());
});
it('shows the empty state when there are no looms', async () => {
api.listLooms.mockResolvedValue([]);
await renderPage();
await waitFor(() => expect(screen.getByText(/No branching narratives yet/)).toBeInTheDocument());
});
it('shows a retriable error instead of the empty copy when looms fail to load', async () => {
api.listLooms.mockRejectedValueOnce(new Error('offline')).mockResolvedValue([]);
await renderPage();
expect(await screen.findByRole('alert')).toHaveTextContent('Could not load branching narratives');
expect(screen.queryByText(/No branching narratives yet/)).not.toBeInTheDocument();
await userEvent.setup().click(screen.getByRole('button', { name: 'Retry' }));
expect(await screen.findByText(/No branching narratives yet/)).toBeInTheDocument();
});
it('shows independent retry rows when universe or series picker options fail', async () => {
api.listUniverseNames.mockRejectedValueOnce(new Error('offline')).mockResolvedValue([{ id: 'uni-1', name: 'Aria Verse' }]);
api.listPipelineSeriesNames.mockRejectedValueOnce(new Error('offline')).mockResolvedValue([{ id: 'series-1', name: 'The Crown' }]);
const user = userEvent.setup();
await renderPage();
await user.click(screen.getByRole('button', { name: /New loom/ }));
await screen.findByText(/Could not load universes/);
expect(screen.getByText(/Could not load universes/)).toBeInTheDocument();
expect(screen.getByText(/Could not load series/)).toBeInTheDocument();
const alerts = screen.getAllByRole('alert');
await user.click(within(alerts.find((alert) => alert.textContent.includes('universes'))).getByRole('button', { name: 'Retry' }));
await user.click(within(alerts.find((alert) => alert.textContent.includes('series'))).getByRole('button', { name: 'Retry' }));
await waitFor(() => {
expect(api.listUniverseNames).toHaveBeenCalledTimes(2);
expect(api.listPipelineSeriesNames).toHaveBeenCalledTimes(2);
});
expect(screen.queryByText(/Could not load universes/)).not.toBeInTheDocument();
expect(screen.queryByText(/Could not load series/)).not.toBeInTheDocument();
expect(screen.getByRole('option', { name: 'Aria Verse' })).toBeInTheDocument();
expect(screen.getByRole('option', { name: 'The Crown' })).toBeInTheDocument();
});
it('opens the creation form from the empty-state action', async () => {
api.listLooms.mockResolvedValue([]);
const user = userEvent.setup();
await renderPage();
await waitFor(() => expect(screen.getByText(/No branching narratives yet/)).toBeInTheDocument());
expect(screen.queryByLabelText('Name')).not.toBeInTheDocument();
await user.click(screen.getByRole('button', { name: /Create your first loom/ }));
expect(screen.getByLabelText('Name')).toBeInTheDocument();
});
it('creates a loom and navigates to its editor', async () => {
api.createLoom.mockResolvedValue({ id: 'loom-9' });
const user = userEvent.setup();
await renderPage();
await waitFor(() => expect(screen.getByText('The Hollow Crown')).toBeInTheDocument());
await user.click(screen.getByRole('button', { name: /New loom/ }));
await user.type(screen.getByLabelText('Name'), 'Gate of Ash');
await user.type(screen.getByLabelText('Audience communication medium'), 'A crystal radio.');
await user.click(screen.getByRole('button', { name: 'Create loom' }));
await waitFor(() => expect(api.createLoom).toHaveBeenCalledWith({
name: 'Gate of Ash', logline: '', premise: '', styleNotes: '', format: 'prose',
participationMode: 'helper', audienceCommunicationMedium: 'A crystal radio.',
universeId: null, seriesId: null,
}, { silent: true }));
expect(navigate).toHaveBeenCalledWith('/fableloom/loom-9/plan');
expect(api.generateLoomSeriesPlan).not.toHaveBeenCalled();
});
it('creates and drafts the full plan with the chosen provider, model, and effort', async () => {
api.createLoom.mockResolvedValue({ id: 'loom-9' });
api.generateLoomSeriesPlan.mockResolvedValue({ loom: { id: 'loom-9' }, runId: 'run-draft' });
const user = userEvent.setup();
await renderPage();
await waitFor(() => expect(screen.getByText('The Hollow Crown')).toBeInTheDocument());
await user.click(screen.getByRole('button', { name: /New loom/ }));
await user.type(screen.getByLabelText('Name'), 'Gate of Ash');
await user.type(screen.getByLabelText('Audience communication medium'), 'A crystal radio.');
await user.selectOptions(await screen.findByLabelText('Plan AI provider'), 'codex');
await user.selectOptions(screen.getByLabelText('Model'), 'gpt-5.6');
await user.selectOptions(screen.getByLabelText('Thinking effort'), 'high');
await user.click(screen.getByRole('button', { name: /Create & draft plan/ }));
await waitFor(() => expect(api.generateLoomSeriesPlan).toHaveBeenCalledWith('loom-9', {
providerId: 'codex', model: 'gpt-5.6', effort: 'high',
}, { silent: true }));
expect(navigate).toHaveBeenCalledWith('/fableloom/loom-9/plan');
});
it('deletes a loom after inline confirmation', async () => {
api.deleteLoom.mockResolvedValue({});
const user = userEvent.setup();
await renderPage();
await waitFor(() => expect(screen.getByText('The Hollow Crown')).toBeInTheDocument());
await user.click(screen.getByRole('button', { name: 'Delete The Hollow Crown' }));
await user.click(screen.getByRole('button', { name: /^Delete$/ }));
await waitFor(() => expect(api.deleteLoom).toHaveBeenCalledWith('loom-1'));
await waitFor(() => expect(screen.queryByText('The Hollow Crown')).not.toBeInTheDocument());
});
});