@baselineos/persona 0.1.0

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@baselineos/persona",
+  "version": "0.1.0",
+  "description": "Baseline Protocol - Persona Engine & Adaptive UI System",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "@baselineos/protocol-core": "1.0.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^2.1.0"
+  },
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm --dts",
+    "dev": "tsup src/index.ts --format esm --dts --watch",
+    "test": "vitest run",
+    "lint": "eslint src/",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}

package/src/__tests__/persona-ui.test.ts

@@ -0,0 +1,336 @@
+/**
+ * Tests for PersonaUISystem
+ * Sprint 49
+ */
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { PersonaUISystem } from '../ui.js';
+import { BaselinePersonaEngine } from '../engine.js';
+import type { WorkflowInstance, UIComponent } from '../ui.js';
+
+describe('PersonaUISystem', () => {
+  let engine: BaselinePersonaEngine;
+  let ui: PersonaUISystem;
+
+  beforeEach(() => {
+    engine = new BaselinePersonaEngine();
+    ui = new PersonaUISystem(engine);
+  });
+
+  afterEach(() => {
+    ui.dispose();
+  });
+
+  // ─── Initialization ───────────────────────────────────────────────────────
+
+  it('initializes with default components', () => {
+    const status = ui.getStatus();
+    expect(status.initialized).toBe(true);
+    expect(status.components).toBeGreaterThanOrEqual(5);
+  });
+
+  it('registers default persona-selector component', () => {
+    const selector = ui.getComponent('persona-selector');
+    expect(selector).toBeDefined();
+    expect(selector!.type).toBe('selector');
+    expect(selector!.size).toEqual({ width: 320, height: 480 });
+  });
+
+  it('registers default studio-interface component', () => {
+    const studio = ui.getComponent('studio-interface');
+    expect(studio).toBeDefined();
+    expect(studio!.type).toBe('studio');
+  });
+
+  it('registers default workflow-engine component', () => {
+    const wf = ui.getComponent('workflow-engine');
+    expect(wf).toBeDefined();
+    expect(wf!.type).toBe('workflow');
+  });
+
+  // ─── Component Management ─────────────────────────────────────────────────
+
+  it('registers a custom component', () => {
+    const component: UIComponent = {
+      id: 'custom-panel',
+      type: 'panel',
+      visible: true,
+      position: { x: 100, y: 100 },
+      size: { width: 400, height: 300 },
+      config: {},
+      state: {},
+    };
+    ui.registerComponent(component);
+    expect(ui.getComponent('custom-panel')).toBeDefined();
+  });
+
+  it('emits component:registered event', () => {
+    const events: any[] = [];
+    ui.on('component:registered', (e) => events.push(e));
+    ui.registerComponent({
+      id: 'test',
+      type: 'panel',
+      visible: true,
+      position: { x: 0, y: 0 },
+      size: { width: 100, height: 100 },
+      config: {},
+      state: {},
+    });
+    expect(events.length).toBe(1);
+    expect(events[0].componentId).toBe('test');
+  });
+
+  it('updates component properties', () => {
+    ui.updateComponent('persona-selector', {
+      position: { x: 50, y: 50 },
+      config: { showSearch: false },
+    });
+    const updated = ui.getComponent('persona-selector');
+    expect(updated!.position).toEqual({ x: 50, y: 50 });
+    expect(updated!.config.showSearch).toBe(false);
+  });
+
+  it('shows and hides components', () => {
+    ui.hideComponent('persona-selector');
+    expect(ui.getComponent('persona-selector')!.visible).toBe(false);
+    ui.showComponent('persona-selector');
+    expect(ui.getComponent('persona-selector')!.visible).toBe(true);
+  });
+
+  it('removes a component', () => {
+    expect(ui.removeComponent('persona-selector')).toBe(true);
+    expect(ui.getComponent('persona-selector')).toBeUndefined();
+  });
+
+  it('lists all and visible components', () => {
+    const all = ui.getAllComponents();
+    expect(all.length).toBeGreaterThanOrEqual(5);
+    const visible = ui.getVisibleComponents();
+    expect(visible.length).toBeLessThanOrEqual(all.length);
+  });
+
+  // ─── Persona Selector ─────────────────────────────────────────────────────
+
+  it('opens and closes selector', () => {
+    ui.openSelector();
+    expect(ui.getSelectorState().isOpen).toBe(true);
+    ui.closeSelector();
+    expect(ui.getSelectorState().isOpen).toBe(false);
+  });
+
+  it('toggles selector', () => {
+    ui.toggleSelector();
+    expect(ui.getSelectorState().isOpen).toBe(true);
+    ui.toggleSelector();
+    expect(ui.getSelectorState().isOpen).toBe(false);
+  });
+
+  it('returns persona options', () => {
+    const options = ui.getPersonaOptions();
+    expect(options.length).toBe(5);
+    expect(options.map((o) => o.id)).toContain('designer');
+    expect(options.map((o) => o.id)).toContain('developer');
+  });
+
+  it('filters persona options by search query', () => {
+    const filtered = ui.setSearchQuery('design');
+    expect(filtered.length).toBeGreaterThan(0);
+    expect(filtered.some((o) => o.name.toLowerCase().includes('design'))).toBe(true);
+  });
+
+  it('returns all options for empty search', () => {
+    const filtered = ui.setSearchQuery('');
+    expect(filtered.length).toBe(5);
+  });
+
+  it('hovers persona updates state', () => {
+    ui.hoverPersona('developer');
+    expect(ui.getSelectorState().hoveredPersonaId).toBe('developer');
+  });
+
+  it('selects persona updates state and closes selector', () => {
+    ui.openSelector();
+    ui.selectPersona('developer', 'user-1');
+    const state = ui.getSelectorState();
+    expect(state.selectedPersonaId).toBe('developer');
+    expect(state.isOpen).toBe(false);
+  });
+
+  // ─── Workflow Engine ──────────────────────────────────────────────────────
+
+  it('starts a workflow', () => {
+    const wf = ui.startWorkflow('development', 'developer', 'user-1');
+    expect(wf.id).toBeDefined();
+    expect(wf.type).toBe('development');
+    expect(wf.personaId).toBe('developer');
+    expect(wf.steps.length).toBeGreaterThan(0);
+  });
+
+  it('workflow has correct initial state', () => {
+    const wf = ui.startWorkflow('design', 'designer', 'user-1');
+    expect(wf.steps[0].status).toBe('active');
+    expect(wf.steps.slice(1).every((s) => s.status === 'pending')).toBe(true);
+  });
+
+  it('retrieves workflow by id', () => {
+    const wf = ui.startWorkflow('analysis', 'data_scientist', 'user-1');
+    expect(ui.getWorkflow(wf.id)).toBeDefined();
+    expect(ui.getWorkflow(wf.id)?.type).toBe('analysis');
+  });
+
+  it('lists active and completed workflows', () => {
+    ui.startWorkflow('development', 'developer', 'user-1');
+    const active = ui.getActiveWorkflows();
+    expect(active.length).toBeGreaterThanOrEqual(0); // may have completed by now
+    const all = ui.getAllWorkflows();
+    expect(all.length).toBe(1);
+  });
+
+  it('enforces max concurrent workflows', () => {
+    const smallUi = new PersonaUISystem(engine, { maxWorkflows: 2 });
+    smallUi.startWorkflow('design', 'designer', 'user-1');
+    smallUi.startWorkflow('analysis', 'data_scientist', 'user-1');
+    expect(() => smallUi.startWorkflow('development', 'developer', 'user-1')).toThrow('Maximum concurrent workflows');
+    smallUi.dispose();
+  });
+
+  it('cancels a running workflow', async () => {
+    const wf = ui.startWorkflow('design', 'designer', 'user-1');
+    // Cancel immediately — may or may not succeed depending on timing
+    const cancelled = ui.cancelWorkflow(wf.id);
+    // Either it was still running and got cancelled, or it already finished
+    if (cancelled) {
+      expect(ui.getWorkflow(wf.id)?.status).toBe('cancelled');
+    }
+  });
+
+  it('cancel returns false for completed workflow', async () => {
+    const wf = ui.startWorkflow('default', 'developer', 'user-1');
+    // Wait for completion
+    await new Promise((r) => setTimeout(r, 2000));
+    expect(ui.cancelWorkflow(wf.id)).toBe(false);
+  });
+
+  it('emits workflow:started event', () => {
+    const events: any[] = [];
+    ui.on('workflow:started', (e) => events.push(e));
+    ui.startWorkflow('design', 'designer', 'user-1');
+    expect(events.length).toBe(1);
+    expect(events[0].type).toBe('design');
+  });
+
+  // ─── Progress Tracking ────────────────────────────────────────────────────
+
+  it('tracks progress for started workflow', () => {
+    const wf = ui.startWorkflow('development', 'developer', 'user-1');
+    const progress = ui.getProgress(wf.id);
+    expect(progress).toBeDefined();
+    expect(progress!.workflowId).toBe(wf.id);
+    expect(progress!.totalSteps).toBeGreaterThan(0);
+  });
+
+  it('returns undefined for nonexistent workflow progress', () => {
+    expect(ui.getProgress('nope')).toBeUndefined();
+  });
+
+  // ─── Result Display ───────────────────────────────────────────────────────
+
+  it('creates a result display', () => {
+    const result = ui.createResultDisplay('wf-1', 'chart', 'Revenue Analysis', { value: 42 });
+    expect(result.id).toBeDefined();
+    expect(result.workflowId).toBe('wf-1');
+    expect(result.title).toBe('Revenue Analysis');
+  });
+
+  it('retrieves and removes result display', () => {
+    const result = ui.createResultDisplay('wf-1', 'table', 'Data', {});
+    expect(ui.getResultDisplay(result.id)).toBeDefined();
+    expect(ui.removeResultDisplay(result.id)).toBe(true);
+    expect(ui.getResultDisplay(result.id)).toBeUndefined();
+  });
+
+  it('gets results for workflow', () => {
+    ui.createResultDisplay('wf-1', 'table', 'A', {});
+    ui.createResultDisplay('wf-1', 'chart', 'B', {});
+    ui.createResultDisplay('wf-2', 'table', 'C', {});
+    expect(ui.getResultsForWorkflow('wf-1').length).toBe(2);
+  });
+
+  it('clears all results', () => {
+    ui.createResultDisplay('wf-1', 'table', 'A', {});
+    ui.createResultDisplay('wf-2', 'chart', 'B', {});
+    ui.clearResults();
+    expect(ui.getAllResults().length).toBe(0);
+  });
+
+  // ─── Layout & Theme ───────────────────────────────────────────────────────
+
+  it('sets and gets layout', () => {
+    ui.setLayout('grid');
+    expect(ui.getLayout()).toBe('grid');
+  });
+
+  it('sets and gets theme', () => {
+    ui.setTheme('dark');
+    expect(ui.getTheme()).toBe('dark');
+  });
+
+  it('emits layout:changed and theme:changed events', () => {
+    const events: string[] = [];
+    ui.on('layout:changed', () => events.push('layout'));
+    ui.on('theme:changed', () => events.push('theme'));
+    ui.setLayout('sidebar');
+    ui.setTheme('light');
+    expect(events).toEqual(['layout', 'theme']);
+  });
+
+  // ─── Frame Management ─────────────────────────────────────────────────────
+
+  it('activates and deactivates frames', () => {
+    ui.activateFrame('code-editor');
+    ui.activateFrame('terminal');
+    expect(ui.getActiveFrames()).toContain('code-editor');
+    expect(ui.getActiveFrames()).toContain('terminal');
+
+    ui.deactivateFrame('code-editor');
+    expect(ui.getActiveFrames()).not.toContain('code-editor');
+  });
+
+  it('does not duplicate frames on re-activate', () => {
+    ui.activateFrame('editor');
+    ui.activateFrame('editor');
+    expect(ui.getActiveFrames().filter((f) => f === 'editor').length).toBe(1);
+  });
+
+  it('sets all active frames', () => {
+    ui.setActiveFrames(['a', 'b', 'c']);
+    expect(ui.getActiveFrames()).toEqual(['a', 'b', 'c']);
+  });
+
+  // ─── Status & Analytics ───────────────────────────────────────────────────
+
+  it('reports status', () => {
+    const status = ui.getStatus();
+    expect(status.initialized).toBe(true);
+    expect(status.components).toBeGreaterThan(0);
+    expect(status.selectorState).toBeDefined();
+    expect(status.studioState).toBeDefined();
+  });
+
+  it('reports UI analytics', () => {
+    ui.startWorkflow('design', 'designer', 'user-1');
+    const analytics = ui.getUIAnalytics();
+    expect((analytics as any).totalWorkflows).toBe(1);
+    expect((analytics as any).workflowsByType).toHaveProperty('design');
+  });
+
+  // ─── Cleanup ──────────────────────────────────────────────────────────────
+
+  it('dispose clears all state', () => {
+    ui.startWorkflow('design', 'designer', 'user-1');
+    ui.createResultDisplay('wf-1', 'table', 'A', {});
+    ui.dispose();
+    expect(ui.getAllComponents().length).toBe(0);
+    expect(ui.getAllWorkflows().length).toBe(0);
+    expect(ui.getAllResults().length).toBe(0);
+  });
+});

package/src/__tests__/smoke.test.ts

@@ -0,0 +1,16 @@
+import { describe, it, expect } from 'vitest';
+import { BaselinePersonaEngine } from '../index.js';
+
+describe('persona', () => {
+  it('should instantiate BaselinePersonaEngine', () => {
+    const persona = new BaselinePersonaEngine();
+    expect(persona).toBeDefined();
+  });
+
+  it('should load 5 core personas', () => {
+    const persona = new BaselinePersonaEngine();
+    const status = persona.getStatus();
+    expect(status.initialized).toBe(true);
+    expect(status.totalPersonas).toBe(5);
+  });
+});