Skip to content
ContractSpec
Start here

Package manual · platform

·Interfaces, presentations and design

module.operating-cockpit

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

platformmodulev2.0.4experimentalservernode
@lssm-tech/module.operating-cockpit
bun add @lssm-tech/module.operating-cockpit
Package source ↗Manifest ↗

Manifest declarations describe the current workspace; they do not verify registry publication or runtime execution.

Package guide

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-tech/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 projectors, ROI / health rollups.
    • review snapshots), navigation surface resolvers, board-state
  • 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-tech/module.operating-cockpit

or

bun add @lssm-tech/module.operating-cockpit

Usage

Import the root entrypoint from @lssm-tech/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:.

Relationships

THIS PACKAGEmodule.operating-cockpit7 import paths

Arrows point from a package to its direct dependency. Counts are derived from captured workspace manifests.

2 declarations

Declared capabilities

Module Operating Cockpit

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

Scripts

  • publish:pkgbun publish --tolerate-republish --ignore-scripts --verbose
  • publish:pkg:canarybun publish:pkg --tag canary
  • buildcontractspec-bun-build build
  • build:bundlecontractspec-bun-build transpile
  • build:typescontractspec-bun-build types
  • devcontractspec-bun-build dev
  • cleanrimraf dist .turbo
  • lintbun lint:fix
  • lint:fixnode ../../../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../../../scripts/biome.cjs check --write .
  • lint:checknode ../../../../scripts/biome.cjs check .
  • prebuildcontractspec-bun-build prebuild
  • typechecktsgo --noEmit