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
/**
* Plan-board state transitions + blocked-step triage (CDO Phase 4, #2186).
*/
import { describe, it, expect, vi, beforeEach } from 'vitest';
import { render, screen, waitFor, fireEvent, act } from '@testing-library/react';
import { MemoryRouter } from 'react-router';
vi.mock('../../services/apiCreativeDirector.js', () => ({
getCreativeToolCatalog: vi.fn(),
setCreativeDirectorDirective: vi.fn(),
replanCreativeDirectorProject: vi.fn(),
updateCreativeDirectorPlanStep: vi.fn(),
}));
vi.mock('../../services/apiUniverseBuilder.js', () => ({ listUniverseNames: vi.fn(async () => []) }));
vi.mock('../../services/apiPipeline.js', () => ({ listPipelineSeriesNames: vi.fn(async () => []) }));
vi.mock('../ui/Toast', () => ({ default: { success: vi.fn(), error: vi.fn(), info: vi.fn() } }));
import PlanTab from './PlanTab.jsx';
import {
getCreativeToolCatalog,
replanCreativeDirectorProject,
updateCreativeDirectorPlanStep,
} from '../../services/apiCreativeDirector.js';
import toast from '../ui/Toast';
const CATALOG = {
tools: [
{ id: 'pipeline_createSeries', costClass: 'free', longRunning: false, destructive: false },
{ id: 'story_generateStep', costClass: 'llm', longRunning: false, destructive: false },
{ id: 'media_enqueueImage', costClass: 'render', longRunning: true, destructive: false },
{ id: 'universe_delete', costClass: 'free', longRunning: false, destructive: true },
],
mode: 'execute',
budget: { withinBudget: true },
};
const directiveProject = (overrides = {}) => ({
id: 'cd-1',
name: 'Noir',
status: 'rendering',
directive: { goal: 'Produce a noir series', deliverables: ['story', 'covers'], constraints: { budgetCap: 50 } },
plan: {
steps: [
{ stepId: 'series', toolName: 'pipeline_createSeries', status: 'done', dependsOn: [], result: { seriesId: 's9' } },
{ stepId: 'draft', toolName: 'story_generateStep', status: 'running', dependsOn: ['series'] },
{ stepId: 'cover', toolName: 'media_enqueueImage', status: 'pending', dependsOn: ['draft'] },
],
},
runs: [{ kind: 'plan-step', stepId: 'series', startedAt: '2026-07-01T00:00:00Z', completedAt: '2026-07-01T00:01:00Z' }],
...overrides,
});
const renderTab = (project, onProjectUpdate = () => {}) =>
render(<MemoryRouter><PlanTab project={project} onProjectUpdate={onProjectUpdate} /></MemoryRouter>);
// Drain the mount fetches (catalog/universes/series) inside act so their state
// updates can't land outside it after a test body that never awaits them.
const settle = () => act(async () => {});
beforeEach(() => {
vi.clearAllMocks();
getCreativeToolCatalog.mockResolvedValue(CATALOG);
});
describe('legacy project (no directive)', () => {
it('offers to add a directive', async () => {
renderTab({ id: 'cd-1', name: 'X', status: 'draft', directive: null, plan: null, runs: [] });
expect(screen.getByText(/No production directive/i)).toBeTruthy();
expect(screen.getByRole('button', { name: /Add a directive/i })).toBeTruthy();
await settle();
});
});
describe('plan board', () => {
it('renders each step with its status + cost class badge', async () => {
renderTab(directiveProject());
await waitFor(() => expect(getCreativeToolCatalog).toHaveBeenCalled());
expect(screen.getByText('series')).toBeTruthy();
expect(screen.getByText('draft')).toBeTruthy();
expect(screen.getByText('cover')).toBeTruthy();
// done + running + pending statuses present
expect(screen.getByText('Done')).toBeTruthy();
expect(screen.getByText('Running')).toBeTruthy();
// cost badges (Render for the long-running image step)
await waitFor(() => expect(screen.getAllByText('Render').length).toBeGreaterThan(0));
});
it('links a completed series step into the pipeline series route', async () => {
renderTab(directiveProject());
await waitFor(() => expect(getCreativeToolCatalog).toHaveBeenCalled());
const link = await screen.findByRole('link', { name: /Open series/i });
expect(link.getAttribute('href')).toBe('/pipeline/series/s9');
});
it('shows the directive goal + deliverables + budget cap', async () => {
renderTab(directiveProject());
expect(screen.getByText('Produce a noir series')).toBeTruthy();
expect(screen.getByText('story')).toBeTruthy();
expect(screen.getByText('covers')).toBeTruthy();
expect(screen.getByText(/Budget cap: 50/)).toBeTruthy();
await settle();
});
it('renders a dry-run banner when creative autonomy is dry-run', async () => {
getCreativeToolCatalog.mockResolvedValue({ ...CATALOG, mode: 'dry-run' });
renderTab(directiveProject());
await waitFor(() => expect(screen.getByText(/previewed/i)).toBeTruthy());
});
});
describe('blocked-step triage', () => {
const blockedProject = () => directiveProject({
status: 'paused',
failureReason: 'Step "draft" is blocked: awaiting human review',
plan: {
steps: [
{ stepId: 'series', toolName: 'pipeline_createSeries', status: 'done', dependsOn: [], result: { seriesId: 's9' } },
{ stepId: 'draft', toolName: 'story_generateStep', status: 'blocked', dependsOn: ['series'], result: { reason: 'awaiting human review' } },
],
},
});
it('surfaces the pause reason and a resume affordance for the blocked step', async () => {
renderTab(blockedProject());
await waitFor(() => expect(getCreativeToolCatalog).toHaveBeenCalled());
expect(screen.getByText(/Plan paused/i)).toBeTruthy();
// Rendered both in the pause banner (failureReason) and the step's result reason.
expect(screen.getAllByText(/awaiting human review/i).length).toBeGreaterThan(0);
expect(screen.getByRole('button', { name: /Resume .*draft/i })).toBeTruthy();
expect(screen.getByRole('button', { name: /Request re-plan/i })).toBeTruthy();
});
it('retries a blocked step and pushes the returned project up', async () => {
const onProjectUpdate = vi.fn();
updateCreativeDirectorPlanStep.mockResolvedValue({ id: 'cd-1', status: 'rendering', plan: { steps: [] } });
renderTab(blockedProject(), onProjectUpdate);
await waitFor(() => expect(getCreativeToolCatalog).toHaveBeenCalled());
fireEvent.click(screen.getByRole('button', { name: /Resume .*draft/i }));
await waitFor(() => expect(updateCreativeDirectorPlanStep).toHaveBeenCalledWith('cd-1', 'draft', 'retry', { silent: true }));
await waitFor(() => expect(onProjectUpdate).toHaveBeenCalledWith({ id: 'cd-1', status: 'rendering', plan: { steps: [] } }));
expect(toast.success).toHaveBeenCalledWith(expect.stringMatching(/re-queued/i));
});
it('requests a re-plan', async () => {
const onProjectUpdate = vi.fn();
replanCreativeDirectorProject.mockResolvedValue({ id: 'cd-1', status: 'planning', plan: null });
renderTab(blockedProject(), onProjectUpdate);
await waitFor(() => expect(getCreativeToolCatalog).toHaveBeenCalled());
fireEvent.click(screen.getByRole('button', { name: /Request re-plan/i }));
await waitFor(() => expect(replanCreativeDirectorProject).toHaveBeenCalledWith('cd-1', { silent: true }));
await waitFor(() => expect(onProjectUpdate).toHaveBeenCalledWith({ id: 'cd-1', status: 'planning', plan: null }));
});
it('skips a pending step', async () => {
updateCreativeDirectorPlanStep.mockResolvedValue({ id: 'cd-1', status: 'rendering', plan: { steps: [] } });
renderTab(directiveProject());
await waitFor(() => expect(getCreativeToolCatalog).toHaveBeenCalled());
// The pending 'cover' step has a Skip button.
const skipButtons = screen.getAllByRole('button', { name: /^Skip$/i });
fireEvent.click(skipButtons[skipButtons.length - 1]);
await waitFor(() => expect(updateCreativeDirectorPlanStep).toHaveBeenCalledWith('cd-1', 'cover', 'skip', { silent: true }));
expect(toast.success).toHaveBeenCalledWith(expect.stringMatching(/skipped/i));
});
});
describe('approval affordances', () => {
it('renders an Approve button for a budgeted step when over budget', async () => {
getCreativeToolCatalog.mockResolvedValue({ ...CATALOG, budget: { withinBudget: false } });
renderTab(directiveProject({
plan: {
steps: [
{ stepId: 'draft', toolName: 'story_generateStep', status: 'pending', dependsOn: [] },
],
},
}));
await waitFor(() => expect(getCreativeToolCatalog).toHaveBeenCalled());
expect(await screen.findByRole('button', { name: /Approve/i })).toBeTruthy();
expect(screen.getByText(/Over the action budget/i)).toBeTruthy();
});
it('renders an Approve button for a destructive step', async () => {
renderTab(directiveProject({
plan: {
steps: [
{ stepId: 'wipe', toolName: 'universe_delete', status: 'pending', dependsOn: [] },
],
},
}));
await waitFor(() => expect(getCreativeToolCatalog).toHaveBeenCalled());
expect(await screen.findByRole('button', { name: /Approve/i })).toBeTruthy();
expect(screen.getByText(/Destructive step/i)).toBeTruthy();
});
});