Orchestrata Ultimate › Plans › plan_vizint_phase_6 › roadmap

VizInt Command Center — Gap Closure Roadmap

Source: plans/plan_vizint_phase_6/roadmap.md at 8a2cb42ad · last changed 2026-07-27 · first committed 2026-05-26 · 322 lines.

Prose pending.

Plan text

VizInt Command Center — Gap Closure Roadmap

Status: All 4 Sprints Complete | Target: 100% Requirements + 90% Constitutional Compliance
Current: ~86% Requirements (253/294) | 44% Constitutional (63/142)
Gap: 41 Requirements | 79 Constitutional Items to reach 90%

Executive Summary

The Command Center is functionally complete for all P1 and P2 gadgets. The remaining work falls into four categories:

1. Gadget Polish (29 requirements): Deferred work, task detail panels, file tree deep-dive, export features
2. Personal Gadgets (8 requirements): Todoist, Email, Calendar integrations + Web Crypto token storage
3. Observability & Resilience (40 constitutional items): Debug panel, error boundaries, metrics, recovery
4. Code Quality & Documentation (45 constitutional items): JSDoc, error handling, API docs, testing standards

Estimated Effort: ~120 hours (3 weeks at full-time, 6 weeks at 50%)

Priority Order: Resilience → Gadget Polish → Observability → Personal Gadgets → Documentation

Part I: Requirements Gap Analysis (52 Missing)

Category A: Project Explorer Deep-Dive (9 requirements | 18h)

Implementation Strategy: Add a FileTree sub-component to ProjectExplorer. Use existing knowledge.nodes pagination. Extract sparkline as reusable CanvasSparkline class. Use ctx.bus.emit('kg-explorer:filter', { node_type }) for cross-gadget navigation.

Category B: Session Manager Enhancements (10 requirements | 24h)

Implementation Strategy: Add DeferredWorkPanel and WorkLogPanel sub-components. Backend needs session.deferredWork RPCs (list, add, update, delete) and session.logWork. Store deferred work in session context.json.

Category C: Volk Status Polish (3 requirements | 6h)

Category D: Task Board Detail Panel (7 requirements | 16h)

Implementation Strategy: Slide-out panel pattern (reuse property panel from KGExplorer). Backend needs projects.taskUpdate RPC. Conflict resolution via last-write-wins with timestamp comparison.

Category E: Claude Chat Search (1 requirement | 2h)

Category F: Audit Trail Export (4 requirements | 6h)

Category G: Personal Gadgets (8 requirements | 32h)

Decision Point: Todoist/Email/Calendar gadgets are P3 (nice-to-have). They add significant value for daily driver usage but are not required for core orchestrata functionality. Recommendation: Implement Web Crypto token storage first (unblocks all personal gadgets), then Todoist as the highest-value personal gadget.

Part II: Constitutional Gap Analysis (120 Missing)

Article I: Agent Autonomy (10 items | 4h)

All items are behavioral guarantees already satisfied by the architecture but not formally verified:

• Dashboard only displays data; all mutations go through gateway RPCs
• CXP feed renders packets without modification
• TaskBoard sends suggestions via projects.taskCreate, not direct commands

Verification: Add integration tests proving no gadget bypasses the gateway. Mark as verified.

Article II: Prolog SSOT (10 items | 8h)

• CONST-II-001: PAM++ auth enforced by gateway → already true, verify with audit
• CONST-II-007: UI disables on -32001 unauthorized → add error handling in bridge
• CONST-II-002, 003–006, 008–010: Governance fidelity → verify AuditTrail displays raw Prolog output

Implementation: Add governance.evaluate and governance.rules RPC handlers. Ensure AuditTrail renders raw JSON without reformatting.

Article III: Session Isolation (12 items | 12h)

Critical for production safety. Requires:

1. Session-scoped test_id equivalent for all gadget data operations
2. session_id parameter on all RPC calls
3. Per-session localStorage namespace
4. Gadget state reset on session switch

Implementation: Add sessionScope wrapper to StateSync. Prefix all localStorage keys with active session ID. Clear gadget state on session.close event.

Article IV: Hooks for Extensibility (10 items | 16h)

• CONST-IV-001: Plugin gadget loading via manifest URL → add registry.loadFromURL(url)
• CONST-IV-004: Custom themes → add <link rel="stylesheet"> dynamic injection
• CONST-IV-005: Custom layout profiles → already implemented in Phase 4
• CONST-IV-007: NotificationManager hooks → add registerHandler(type, callback)

Implementation: Add plugin API surface to Registry, NotificationManager, and Theme system.

Article V: Minimal Core (8 items | 4h)

Mostly verified. Remaining:

• CONST-V-001: Core handles only bridge/registry/layout/theming/notifications → verify
• CONST-V-003: Personal productivity are gadgets → true by design
• CONST-V-007: Core dependencies minimal → verify no charting library imported
• CONST-V-009: Core API versioned → API_VERSION implemented

Article VI: JS ES2024 Standards (11 items | 20h)

High-impact code quality work:

• CONST-VI-003: Web Workers for heavy computation → KGExplorer force-directed graph
• CONST-VI-004: Promise.all for concurrent ops → audit all async functions
• CONST-VI-005: structuredClone → replace all JSON.parse(JSON.stringify())
• CONST-VI-008: try/catch on all async → add error boundaries
• CONST-VI-013: JSDoc on all public APIs → 20+ files to document
• CONST-VI-014: No console.log → audit and redirect to logger
• CONST-VI-015: Functions < 40 lines → refactor long functions
• CONST-VI-016: No global mutable state → audit window.* mutations
• CONST-VI-018: Event listener cleanup → verify all unmount() methods

Article VII: Testing Without Mocks (10 items | 16h)

• CONST-VII-001: Real WebSocket connections → WsTestServer is real WS
• CONST-VII-007: Integration tests with real gateway → add tests against live gateway
• CONST-VII-009: Race condition tests → concurrent subscription tests

Implementation: Add tests/integration/ directory with tests against real gateway server.

Article VIII: Observability (20 items | 40h)

Largest single category. Requires building:

1. MetricsCollector class (CONST-VIII-001–010): Track render times, RPC latency, event delivery, memory, FPS, errors
2. DebugPanel gadget (CONST-VIII-016): Toggle overlay showing subscriptions, RPC queue, bus traffic
3. PerformanceOverlay (CONST-VIII-017): FPS counter, memory gauge, render time histogram
4. GadgetHealthIndicator (CONST-VIII-015): Error/loading states in chrome titlebar

Architecture:

// lib/metrics.js
export class MetricsCollector {
  recordRender(gadgetId, duration) {}
  recordRpcLatency(method, duration) {}
  recordEventDelivery(topic, latency) {}
  recordError(gadgetId, error) {}
  getSnapshot() {}
}

Article IX: Graceful Degradation (20 items | 32h)

Critical for production reliability:

1. ErrorBoundary (CONST-IX-006, 007, 014): Wrap each gadget mount in try/catch, show error state with retry button
2. RPC Queue (CONST-IX-003, 013): Bridge already queues 100 calls; verify flush on reconnect
3. Auto-re-subscription (CONST-IX-008, 012): Track active subscriptions, re-subscribe after reconnect
4. localStorage Quota (CONST-IX-010): Measure usage, evict oldest entries
5. Read-only mode (CONST-IX-001): Disable inputs when bridge disconnected

Article X: Versioning (10 items | 12h)

• CONST-X-003: Gateway protocol version check → call gateway.info on connect
• CONST-X-004: Incompatible version warning → banner in header
• CONST-X-008: CSS custom properties prefixed → audit --cc-* prefix usage
• CONST-X-009: Deprecation warnings → add deprecate() helper

Article XI: Documentation (10 items | 16h)

• CONST-XI-002–005: API docs for GadgetBridge, WebSocketBridge, StateSync, NotificationManager
• CONST-XI-007–008: Theme system and layout profile docs
• CONST-XI-009: Plugin gadget development guide
• CONST-XI-010: Performance budget documentation

Part III: Prioritized Implementation Plan

Sprint 1: Resilience Foundation (Week 1 | 40h)

Goal: Close all Article IX degradation items + Article VIII observability core

Exit Criteria: All 20 Article IX items verified. 10 Article VIII items verified.

Sprint 2: Gadget Polish (Week 2 | 40h)

Goal: Close 29 requirements in Categories A–F

Exit Criteria: All Category A–F requirements checked. Backend RPCs pass tests.

Sprint 3: Code Quality & Standards (Week 3 | 40h)

Goal: Close Article VI, VII, X + documentation

Exit Criteria: All Article VI items verified. Article VII integration tests passing. API docs complete.

Sprint 4: Personal Gadgets & Final Polish (Week 4 | 32h)

Goal: Web Crypto, Todoist gadget, remaining constitutional items

Exit Criteria: ≥90% constitutional compliance (128/142). 100% requirements completion.

Part IV: Risk Register

Part V: Verification Checklist

Per-Sprint Gates

Before starting next sprint:

• [ ] All previous sprint tests pass (npm test, npx playwright test)
• [ ] Lint clean (npm run lint)
• [ ] Compliance checker updated (node scripts/compliance-check.js)
• [ ] Requirements checklist updated
• [ ] Constitutional checklist updated

Final Gate (End of Sprint 4)

• [ ] All 294 requirements checked [x]
• [ ] ≥128/142 constitutional items checked [x] (90%)
• [ ] 250+ unit tests passing
• [ ] 100+ E2E tests passing
• [ ] Security audit clean (node scripts/security-audit.js)
• [ ] Performance budget met (node scripts/perf-budget.js)
• [ ] Integration tests against real gateway passing
• [ ] Documentation complete (API docs, plugin guide, performance budget)

Related

• Plans
• Orchestrata Ultimate — project index
• Workflow
• Tasks