{"id":"@lssm-tech/example.companyos-communicationos-operating-cockpit","slug":"example.companyos-communicationos-operating-cockpit","name":"@lssm-tech/example.companyos-communicationos-operating-cockpit","version":"2.0.6","path":"examples/companyos-communicationos-operating-cockpit","manifestPath":"examples/companyos-communicationos-operating-cockpit/package.json","manifestBlobSha":"9ee89dd94e6dd035392d043d631b6210545a9e18","layer":"examples","physicalArea":null,"primaryArea":"examples-and-patterns","classification":{"privateDeclared":null,"catalogFamily":"ui","catalogKind":"example","catalogStatus":"active","adoptionMode":"reference-only","stability":"experimental"},"description":"Deterministic combined CompanyOS and CommunicationOS operating cockpit example for governed conversation-to-work loops.","descriptionOrigin":"package.json","catalog":{"family":"ui","kind":"example","status":"active","adoptionMode":"reference-only","stability":"experimental","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./contracts","./docs","./example","./fixtures","./proof","./ui","./ui/OperatingCockpitPreview","./companyos-communicationos-operating-cockpit.feature"],"documentation":[{"title":"Example Companyos Communicationos Operating Cockpit documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fexample.companyos-communicationos-operating-cockpit","kind":"readme"}],"examples":[],"replacements":[],"nonAdoptableRationale":"This example is published for reference and learning, not as a reusable library dependency.","visualTesting":{"status":"deferred","owner":"@contractspec-core","targetWave":"wave-3-react-packages","rationale":"Foundational Storybook adoption establishes shared catalogs and guardrails before this package migrates."}},"canonicalImports":[],"scripts":{"build":"contractspec-bun-build build","typecheck":"tsgo --noEmit","test":"bun test","smoke":"bun test src/example.smoke.test.ts","lint:check":"node ../../scripts/biome.cjs check .","lint":"bun lint:fix","lint:fix":"node ../../scripts/biome.cjs check --write .","preflight":"bun run build && bun run typecheck && bun run test && bun run smoke","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/bundle.managed-companyos":"workspace:^","@lssm-tech/lib.cockpit-kit-web":"workspace:^","@lssm-tech/lib.companyos-spec":"workspace:^","@lssm-tech/lib.contracts-spec":"workspace:^","@lssm-tech/lib.design-system":"workspace:^","@lssm-tech/lib.example-shared-ui":"workspace:^","@lssm-tech/module.communication-os":"workspace:^","@lssm-tech/module.companyos":"workspace:^","react":"catalog:","react-dom":"catalog:"},"devDependencies":{"@lssm-tech/tool.typescript":"workspace:*","@types/react":"catalog:types","@types/react-dom":"catalog:types","typescript":"catalog:","@lssm-tech/tool.bun":"workspace:*"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./contracts":"./src/contracts/index.ts","./docs":"./src/docs/index.ts","./example":"./src/example.ts","./fixtures":"./src/fixtures/index.ts","./proof":"./src/proof/index.ts","./ui":"./src/ui/index.ts","./ui/OperatingCockpitPreview":"./src/ui/OperatingCockpitPreview.tsx","./companyos-communicationos-operating-cockpit.feature":"./src/companyos-communicationos-operating-cockpit.feature.ts"},"publishExports":{".":{"types":"./dist/index.d.ts","browser":"./dist/browser/index.js","bun":"./dist/index.js","node":"./dist/node/index.js","default":"./dist/index.js"},"./contracts":{"types":"./dist/contracts/index.d.ts","browser":"./dist/browser/contracts/index.js","bun":"./dist/contracts/index.js","node":"./dist/node/contracts/index.js","default":"./dist/contracts/index.js"},"./docs":{"types":"./dist/docs/index.d.ts","browser":"./dist/browser/docs/index.js","bun":"./dist/docs/index.js","node":"./dist/node/docs/index.js","default":"./dist/docs/index.js"},"./example":{"types":"./dist/example.d.ts","browser":"./dist/browser/example.js","bun":"./dist/example.js","node":"./dist/node/example.js","default":"./dist/example.js"},"./fixtures":{"types":"./dist/fixtures/index.d.ts","browser":"./dist/browser/fixtures/index.js","bun":"./dist/fixtures/index.js","node":"./dist/node/fixtures/index.js","default":"./dist/fixtures/index.js"},"./proof":{"types":"./dist/proof/index.d.ts","browser":"./dist/browser/proof/index.js","bun":"./dist/proof/index.js","node":"./dist/node/proof/index.js","default":"./dist/proof/index.js"},"./ui":{"types":"./dist/ui/index.d.ts","browser":"./dist/browser/ui/index.js","bun":"./dist/ui/index.js","node":"./dist/node/ui/index.js","default":"./dist/ui/index.js"},"./ui/OperatingCockpitPreview":{"types":"./dist/ui/OperatingCockpitPreview.d.ts","browser":"./dist/browser/ui/OperatingCockpitPreview.js","bun":"./dist/ui/OperatingCockpitPreview.js","node":"./dist/node/ui/OperatingCockpitPreview.js","default":"./dist/ui/OperatingCockpitPreview.js"},"./companyos-communicationos-operating-cockpit.feature":{"types":"./dist/companyos-communicationos-operating-cockpit.feature.d.ts","browser":"./dist/browser/companyos-communicationos-operating-cockpit.feature.js","bun":"./dist/companyos-communicationos-operating-cockpit.feature.js","node":"./dist/node/companyos-communicationos-operating-cockpit.feature.js","default":"./dist/companyos-communicationos-operating-cockpit.feature.js"}},"types":"./dist/index.d.ts","files":["LICENSE","README.md","dist","!**/*.test.*","!**/*.spec.*","!**/*.tsbuildinfo"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/example.companyos-communicationos-operating-cockpit","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"examples/companyos-communicationos-operating-cockpit/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./contracts","importPath":"@lssm-tech/example.companyos-communicationos-operating-cockpit/contracts","target":"./src/contracts/index.ts","targets":[{"conditions":[],"target":"./src/contracts/index.ts","sourcePath":"examples/companyos-communicationos-operating-cockpit/src/contracts/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/src/contracts/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./docs","importPath":"@lssm-tech/example.companyos-communicationos-operating-cockpit/docs","target":"./src/docs/index.ts","targets":[{"conditions":[],"target":"./src/docs/index.ts","sourcePath":"examples/companyos-communicationos-operating-cockpit/src/docs/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/src/docs/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./example","importPath":"@lssm-tech/example.companyos-communicationos-operating-cockpit/example","target":"./src/example.ts","targets":[{"conditions":[],"target":"./src/example.ts","sourcePath":"examples/companyos-communicationos-operating-cockpit/src/example.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/src/example.ts","sourceStatus":"verified source file"}]},{"subpath":"./fixtures","importPath":"@lssm-tech/example.companyos-communicationos-operating-cockpit/fixtures","target":"./src/fixtures/index.ts","targets":[{"conditions":[],"target":"./src/fixtures/index.ts","sourcePath":"examples/companyos-communicationos-operating-cockpit/src/fixtures/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/src/fixtures/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./proof","importPath":"@lssm-tech/example.companyos-communicationos-operating-cockpit/proof","target":"./src/proof/index.ts","targets":[{"conditions":[],"target":"./src/proof/index.ts","sourcePath":"examples/companyos-communicationos-operating-cockpit/src/proof/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/src/proof/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./ui","importPath":"@lssm-tech/example.companyos-communicationos-operating-cockpit/ui","target":"./src/ui/index.ts","targets":[{"conditions":[],"target":"./src/ui/index.ts","sourcePath":"examples/companyos-communicationos-operating-cockpit/src/ui/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/src/ui/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./ui/OperatingCockpitPreview","importPath":"@lssm-tech/example.companyos-communicationos-operating-cockpit/ui/OperatingCockpitPreview","target":"./src/ui/OperatingCockpitPreview.tsx","targets":[{"conditions":[],"target":"./src/ui/OperatingCockpitPreview.tsx","sourcePath":"examples/companyos-communicationos-operating-cockpit/src/ui/OperatingCockpitPreview.tsx","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/src/ui/OperatingCockpitPreview.tsx","sourceStatus":"verified source file"}]},{"subpath":"./companyos-communicationos-operating-cockpit.feature","importPath":"@lssm-tech/example.companyos-communicationos-operating-cockpit/companyos-communicationos-operating-cockpit.feature","target":"./src/companyos-communicationos-operating-cockpit.feature.ts","targets":[{"conditions":[],"target":"./src/companyos-communicationos-operating-cockpit.feature.ts","sourcePath":"examples/companyos-communicationos-operating-cockpit/src/companyos-communicationos-operating-cockpit.feature.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/src/companyos-communicationos-operating-cockpit.feature.ts","sourceStatus":"verified source file"}]}],"entryCount":9,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Example Companyos Communicationos Operating Cockpit documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fexample.companyos-communicationos-operating-cockpit","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.companyos-communicationos-operating-cockpit.txt"},"readme":{"status":"available","body":"# CompanyOS + CommunicationOS Operating Cockpit\n\nDeterministic combined example that turns CommunicationOS thread/action evidence into a CompanyOS work execution plan, runs it through policy-gated dry-run execution, and feeds the result back into a CommunicationOS audit/action state.\n\n## Boundaries\n\n- Provider-free by default: no network I/O, credentials, outbound messages, deployments, or production actions.\n- Imports reusable modules/libs only; it does not import other examples.\n- Package-local `src/contracts` describe proof fixtures for this example, not canonical reusable cross-OS contracts.\n- CompanyOS execution uses deterministic module adapters from `@lssm-tech/module.companyos`.\n- Message-originated commands enter the CommunicationOS command inbox as evidence only; production sends and CompanyOS high-impact bypass attempts are blocked before execution.\n\n\n## Rich cockpit proof\n\n- The UI exports an app-like `TemplateShell` cockpit from `@lssm-tech/lib.example-shared-ui/TemplateShell` with ten named screens: home, dashboard, CommunicationOS inbox, thread detail, evidence map, CompanyOS work graph, policy gate, dry-run console, audit feedback, and starter-kit guide.\n- The start/home and dashboard screens introduce the cross-OS story, deterministic safety boundaries, metrics, production-readiness checks, command lanes, operator notes, and quick actions before the deeper workflow screens.\n- Sidebar navigation, thread selection, evidence drill-down, workflow-stage inspection, policy approval, dry-run execution, audit viewing, operator notes, and reset are backed by a pure reducer so the preview is interactive without providers or side effects.\n- Selecting a CommunicationOS thread advances deterministic state into CompanyOS work mapping; running the dry-run advances the proof into CommunicationOS audit feedback without outbound effects.\n- Reusable starter-kit proof imports CompanyOS and CommunicationOS UI/runtime surfaces from `@lssm-tech/module.companyos` and `@lssm-tech/module.communication-os`; scenario copy and fixtures remain package-local.\n- The proof summary includes `commandInboxStatus: blocked` and `companyOsBridgeStatus: blocked` so release evidence catches any accidental execution bypass.\n\n## Public integration surfaces\n\nImport the package-native cockpit UI from `@lssm-tech/example.companyos-communicationos-operating-cockpit/ui` when a host wants the combined proof without depending on another example package. The `./ui` subpath exports:\n\n- `OperatingCockpitPreview` for the deterministic app-like cockpit.\n- `OperatingCockpitScreen`, `OPERATING_COCKPIT_SCREEN_HREFS`, and `operatingCockpitNavigation` for host routing, docs anchors, and preview catalogs.\n- `createInitialOperatingCockpitState`, `reduceOperatingCockpitState`, `serializeOperatingCockpitState`, `parseOperatingCockpitState`, and `createInMemoryOperatingCockpitPersistence` for host-owned state snapshots. The example never writes to browser storage, disk, or a backend by itself; hosts provide persistence adapters explicitly.\n- `OriginChip`, `OriginChipProps`, and `COCKPIT_ORIGIN_KINDS` for rendering source-origin context from CompanyOS action-origin types while falling back safely for unknown kinds.\n\nPublic discovery is integrated through `@lssm-tech/module.examples`: registry entries point at this package's `./docs`, feature entrypoint, sandbox link, LLMS guide, and package-native `./ui` preview. Regenerate the example registry after changing these exports or discovery fields.\n\n## Commands\n\n```bash\nbun run --cwd examples/companyos-communicationos-operating-cockpit test\nbun run --cwd examples/companyos-communicationos-operating-cockpit typecheck\nbun run --cwd examples/companyos-communicationos-operating-cockpit build\nbun run --cwd examples/companyos-communicationos-operating-cockpit lint:check\nbun run --cwd examples/registry generate:registry\nbun test packages/bundles/marketing/src/components/templates/template-catalog.test.ts packages/bundles/marketing/src/components/templates/template-preview.test.ts\n```\n\n## VoiceOps operating cockpit story\n\nThe cockpit fixture now starts from the Rivage Retail voice escalation: CommunicationOS holds the redacted voice evidence, CompanyOS drafts an internal security-documentation product gap, and customer-facing promises/security claims remain blocked. The dry-run remains deterministic and side-effect free while surfacing the same receipt/proof language as the VoiceOps workbench.\n\n## Roadmap: UI/UX refresh\n\nThe example is still intentionally thin around `@lssm-tech/bundle.managed-companyos` cockpit templates. The next refresh should make the cockpit feel like a proper operator product surface while keeping the package deterministic and provider-free:\n\n- Implement the reusable UI work in `packages/bundles/managed-companyos/src/ui/cockpit/templates/operating-cockpit`, then let this example provide fixtures and proof coverage.\n- Upgrade the home/dashboard into an operator-grade command center with loop state, selected thread, policy, dry-run, audit, contact identity, and evidence context.\n- Add richer CommunicationOS inbox/thread/contact affordances inspired by the messaging workspace: searchable conversations, contact-to-conversation navigation, detail drawers, edit/delete actions, and evidence-aware actions.\n- Keep provider adapters host-owned; the example must remain no-network, no-credential, no-send, and no-production-action by default.\n\nDeclaration publication uses `contractspec-bun-build types` through\n`build:types`; `build` runs bundle and declaration generation. The build config\npreserves declared exports and excludes test-only files from generated build artifacts.\nPackage tests and typecheck remain separate verification gates.\n\nFull `build` regenerates JavaScript and declarations in one output transaction,\nrestoring previous `dist` if either stage fails. Standalone `build:bundle` still\npreserves declarations; use full `build` to reconcile obsolete output layouts.\n","sourcePath":"examples/companyos-communicationos-operating-cockpit/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-communicationos-operating-cockpit/README.md","blobSha":"7ac74a0c16496c65152a5c06f8818df76338f4d3","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","origin":"README recovered byte-for-byte from pinned aggregate guide","integrity":"exact Git blob match","executionStatus":"not executed"},"provenance":{"repository":"lssm-tech/contractspec","sourcePin":"bcc79fcc27c4d801c2119bef81ddcce7b4e86498","manifestOrigin":"pinned GitHub manifest fetch","manifestComplete":true,"publicationPolicyApplied":false},"areaSlug":"examples-and-patterns","areaTitle":"Examples and implementation patterns","displayName":"example.companyos-communicationos-operating-cockpit","runtimes":["node"],"platforms":["server"],"kind":"example","scope":"Package manifest","canonicalRoute":"/docs/packages/example.companyos-communicationos-operating-cockpit/","contextUrl":"/docs/packages/example.companyos-communicationos-operating-cockpit.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}