@lssm/module.operating-cockpit

Website: https://contractspec.io

Operator cockpit shell for the Agent + Workflow pillar — fleet board, navigation surface, and cross-domain operating screens.

What It Provides

• Layer: module.
• Consumers: @lssm/bundle.managed-companyos, the web-application-monolith /operating/** + /fleet/** routes and the navigation shell that wraps the entire Agent + Workflow pillar, and future native shells via shared view-models.
• src/core/ — fleet read-model aggregators (composing agent + workflow
  • review snapshots), navigation surface resolvers, board-state projectors, ROI / health rollups.
• src/presentation/ — promoted screens (OperatorLandingScreen, OperatorOverviewScreen, FleetBoardScreen, NavigationShell).
• src/handlers/ — operation handlers for the 3 fleet.* contracts.
• src/data-views/ — data-view specs for the fleet/board/landing tables.

Installation

npm install @lssm/module.operating-cockpit

or

bun add @lssm/module.operating-cockpit

Usage

Import the root entrypoint from @lssm/module.operating-cockpit, or choose a documented subpath when you only need one slice of the surface.

Architecture

• src/operating-cockpit.capability.ts — capability declaration.
• src/operating-cockpit.feature.ts — feature manifest listing the 3 fleet.* operations the module owns.
• src/core/ — domain logic (aggregation + navigation).
• src/presentation/ — UI (design-system-first).
• src/handlers/ — aggregating operation handlers.
• src/data-views/ — data-view specs.
• src/index.ts — public barrel.

Public Entry Points

• . → ./src/index.ts
• ./operating-cockpit.capability → ./src/operating-cockpit.capability.ts
• ./operating-cockpit.feature → ./src/operating-cockpit.feature.ts
• ./core → ./src/core/index.ts
• ./presentation → ./src/presentation/index.ts
• ./handlers → ./src/handlers/index.ts
• ./data-views → ./src/data-views/index.ts

Notes

• fleet.* handlers compose read-models from agent.*, workflow.*, and review.* handlers only — never direct store access. Seam contract lives in lib.contracts-spec/src/operations/SEAMS.md.
• The 28 NavSurface routes (Phase 0.6) are the single source of truth for the cockpit navigation shell.
• Capability gates resolve to disabled + tooltip, never silent strip.
• Design-system primitives first; fallbacks marked // DS-FALLBACK:.