{"id":"@lssm-tech/example.communication-os","slug":"example.communication-os","name":"@lssm-tech/example.communication-os","version":"3.0.6","path":"examples/communication-os","manifestPath":"examples/communication-os/package.json","manifestBlobSha":"96e246262aa92041cdea731685703ea73a5ff81e","layer":"examples","physicalArea":null,"primaryArea":"examples-and-patterns","classification":{"privateDeclared":null,"catalogFamily":"solutions","catalogKind":"example","catalogStatus":"active","adoptionMode":"reference-only","stability":"stable"},"description":"Standalone CommunicationOS examples, fixtures, and replay proof for external adopter flows.","descriptionOrigin":"package.json","catalog":{"family":"solutions","kind":"example","status":"active","adoptionMode":"reference-only","stability":"stable","platforms":["server"],"runtimes":["node"],"entrypoints":[".","./docs","./example","./examples","./fixtures","./proof","./contracts","./handlers","./mcp","./ui","./ui/CommunicationOsPreview","./ui/communication-os-preview.data","./ui/communication-os.types","./communication-os.feature"],"documentation":[{"title":"Example Communication Os documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fexample.communication-os","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/communication-os.example.smoke.test.ts","lint:check":"node ../../scripts/biome.cjs check .","lint":"bun lint:fix","lint:fix":"node ../../scripts/biome.cjs check --write .","build:bundle":"contractspec-bun-build transpile","build:types":"contractspec-bun-build types"},"scriptStatus":"complete pinned manifest","dependencies":{"@lssm-tech/lib.communication-spec":"workspace:^","@lssm-tech/lib.communication-runtime":"workspace:^","@lssm-tech/lib.contracts-spec":"workspace:^","@lssm-tech/lib.design-system":"workspace:^","@lssm-tech/lib.schema":"workspace:^","@lssm-tech/module.communication-os":"workspace:^","react":"catalog:","react-dom":"catalog:"},"devDependencies":{"@lssm-tech/tool.typescript":"workspace:*","typescript":"catalog:","@types/react":"catalog:types","@types/react-dom":"catalog:types","@lssm-tech/tool.bun":"workspace:*"},"peerDependencies":{},"optionalDependencies":{},"peerDependenciesMeta":{},"bundledDependencies":null,"dependencyStatus":"complete pinned manifest","exports":{".":"./src/index.ts","./docs":"./src/docs/index.ts","./example":"./src/example.ts","./examples":"./src/examples/index.ts","./fixtures":"./src/fixtures/index.ts","./proof":"./src/proof/index.ts","./contracts":"./src/contracts/index.ts","./handlers":"./src/handlers/index.ts","./mcp":"./src/mcp/index.ts","./ui":"./src/ui/index.ts","./ui/CommunicationOsPreview":"./src/ui/CommunicationOsPreview.tsx","./ui/communication-os-preview.data":"./src/ui/communication-os-preview.data.ts","./ui/communication-os.types":"./src/ui/communication-os.types.ts","./communication-os.feature":"./src/communication-os.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"},"./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"},"./examples":{"types":"./dist/examples/index.d.ts","browser":"./dist/browser/examples/index.js","bun":"./dist/examples/index.js","node":"./dist/node/examples/index.js","default":"./dist/examples/index.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"},"./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"},"./handlers":{"types":"./dist/handlers/index.d.ts","browser":"./dist/browser/handlers/index.js","bun":"./dist/handlers/index.js","node":"./dist/node/handlers/index.js","default":"./dist/handlers/index.js"},"./mcp":{"types":"./dist/mcp/index.d.ts","browser":"./dist/browser/mcp/index.js","bun":"./dist/mcp/index.js","node":"./dist/node/mcp/index.js","default":"./dist/mcp/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/CommunicationOsPreview":{"types":"./dist/ui/CommunicationOsPreview.d.ts","browser":"./dist/browser/ui/CommunicationOsPreview.js","bun":"./dist/ui/CommunicationOsPreview.js","node":"./dist/node/ui/CommunicationOsPreview.js","default":"./dist/ui/CommunicationOsPreview.js"},"./ui/communication-os-preview.data":{"types":"./dist/ui/communication-os-preview.data.d.ts","browser":"./dist/browser/ui/communication-os-preview.data.js","bun":"./dist/ui/communication-os-preview.data.js","node":"./dist/node/ui/communication-os-preview.data.js","default":"./dist/ui/communication-os-preview.data.js"},"./ui/communication-os.types":{"types":"./dist/ui/communication-os.types.d.ts","browser":"./dist/browser/ui/communication-os.types.js","bun":"./dist/ui/communication-os.types.js","node":"./dist/node/ui/communication-os.types.js","default":"./dist/ui/communication-os.types.js"},"./communication-os.feature":{"types":"./dist/communication-os.feature.d.ts","browser":"./dist/browser/communication-os.feature.js","bun":"./dist/communication-os.feature.js","node":"./dist/node/communication-os.feature.js","default":"./dist/communication-os.feature.js"}},"types":null,"files":["LICENSE","README.md","dist","!**/*.test.*","!**/*.spec.*","!**/*.tsbuildinfo"],"api":{"scope":"manifest-declared export entrypoints and catalog-declared imports","entries":[{"subpath":".","importPath":"@lssm-tech/example.communication-os","target":"./src/index.ts","targets":[{"conditions":[],"target":"./src/index.ts","sourcePath":"examples/communication-os/src/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./docs","importPath":"@lssm-tech/example.communication-os/docs","target":"./src/docs/index.ts","targets":[{"conditions":[],"target":"./src/docs/index.ts","sourcePath":"examples/communication-os/src/docs/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/docs/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./example","importPath":"@lssm-tech/example.communication-os/example","target":"./src/example.ts","targets":[{"conditions":[],"target":"./src/example.ts","sourcePath":"examples/communication-os/src/example.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/example.ts","sourceStatus":"verified source file"}]},{"subpath":"./examples","importPath":"@lssm-tech/example.communication-os/examples","target":"./src/examples/index.ts","targets":[{"conditions":[],"target":"./src/examples/index.ts","sourcePath":"examples/communication-os/src/examples/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/examples/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./fixtures","importPath":"@lssm-tech/example.communication-os/fixtures","target":"./src/fixtures/index.ts","targets":[{"conditions":[],"target":"./src/fixtures/index.ts","sourcePath":"examples/communication-os/src/fixtures/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/fixtures/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./proof","importPath":"@lssm-tech/example.communication-os/proof","target":"./src/proof/index.ts","targets":[{"conditions":[],"target":"./src/proof/index.ts","sourcePath":"examples/communication-os/src/proof/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/proof/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./contracts","importPath":"@lssm-tech/example.communication-os/contracts","target":"./src/contracts/index.ts","targets":[{"conditions":[],"target":"./src/contracts/index.ts","sourcePath":"examples/communication-os/src/contracts/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/contracts/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./handlers","importPath":"@lssm-tech/example.communication-os/handlers","target":"./src/handlers/index.ts","targets":[{"conditions":[],"target":"./src/handlers/index.ts","sourcePath":"examples/communication-os/src/handlers/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/handlers/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./mcp","importPath":"@lssm-tech/example.communication-os/mcp","target":"./src/mcp/index.ts","targets":[{"conditions":[],"target":"./src/mcp/index.ts","sourcePath":"examples/communication-os/src/mcp/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/mcp/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./ui","importPath":"@lssm-tech/example.communication-os/ui","target":"./src/ui/index.ts","targets":[{"conditions":[],"target":"./src/ui/index.ts","sourcePath":"examples/communication-os/src/ui/index.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/ui/index.ts","sourceStatus":"verified source file"}]},{"subpath":"./ui/CommunicationOsPreview","importPath":"@lssm-tech/example.communication-os/ui/CommunicationOsPreview","target":"./src/ui/CommunicationOsPreview.tsx","targets":[{"conditions":[],"target":"./src/ui/CommunicationOsPreview.tsx","sourcePath":"examples/communication-os/src/ui/CommunicationOsPreview.tsx","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/ui/CommunicationOsPreview.tsx","sourceStatus":"verified source file"}]},{"subpath":"./ui/communication-os-preview.data","importPath":"@lssm-tech/example.communication-os/ui/communication-os-preview.data","target":"./src/ui/communication-os-preview.data.ts","targets":[{"conditions":[],"target":"./src/ui/communication-os-preview.data.ts","sourcePath":"examples/communication-os/src/ui/communication-os-preview.data.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/ui/communication-os-preview.data.ts","sourceStatus":"verified source file"}]},{"subpath":"./ui/communication-os.types","importPath":"@lssm-tech/example.communication-os/ui/communication-os.types","target":"./src/ui/communication-os.types.ts","targets":[{"conditions":[],"target":"./src/ui/communication-os.types.ts","sourcePath":"examples/communication-os/src/ui/communication-os.types.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/ui/communication-os.types.ts","sourceStatus":"verified source file"}]},{"subpath":"./communication-os.feature","importPath":"@lssm-tech/example.communication-os/communication-os.feature","target":"./src/communication-os.feature.ts","targets":[{"conditions":[],"target":"./src/communication-os.feature.ts","sourcePath":"examples/communication-os/src/communication-os.feature.ts","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/src/communication-os.feature.ts","sourceStatus":"verified source file"}]}],"entryCount":14,"namedSymbolCoverage":"catalog declarations only; exhaustive TypeScript symbols not extracted","installationStatus":"not verified"},"docsLinks":[{"title":"Example Communication Os documentation","url":"https://www.npmjs.com/package/%40lssm-tech%2Fexample.communication-os","kind":"readme","pinnedUrl":null,"sourceStatus":"declared link; destination not verified"}],"sourceUrls":{"package":"https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os","manifest":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/package.json","readme":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/README.md","guide":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.communication-os.txt"},"readme":{"status":"available","body":"# @lssm-tech/example.communication-os\n\nStandalone CommunicationOS examples, fixtures, replay proof, and composition adapters. This package consumes public CommunicationOS surfaces as an adopter would, keeps example data out of the module package, and imports reusable UI from `@lssm-tech/module.communication-os/ui`.\n\n## Entry Points\n\n- `.`\n- `./docs`\n- `./example`\n- `./examples`\n- `./fixtures`\n- `./proof`\n- `./contracts`\n- `./handlers`\n- `./ui`\n- `./ui/CommunicationOsPreview`\n- `./ui/communication-os-preview.data`\n- `./ui/communication-os.types`\n- `./communication-os.feature`\n\n## Preview / export workflow\n\nCommunicationOS preview work must keep this package as the source of truth for example fixtures and replay proof. Public preview discovery requires compatible `./example`, `./docs`, `./examples`, `./fixtures`, and `./proof` publish exports before an inline `./ui` surface can be generated.\n\n`./ui` is a thin example adapter: it builds deterministic local communication fixture data and passes it into `@lssm-tech/module.communication-os/ui`. Adapter tests assert that actions/drafts remain review-gated and fixture-owned. Do not duplicate reusable screen components here and do not move example data back into the module package.\n\nThe adapter also mounts the CommunicationOS translation catalog, because the reusable module UI reads its copy through `useI18n` and never mounts a provider. It follows the host's active locale (en, fr, es) and falls back to the host translator for keys it does not own, so the preview shows real copy instead of `commOs.*` keys in any host. Once the preview has mounted on the client, its root carries `data-communication-os-preview-ready=\"true\"`; hosts and browser tests wait for it before interacting. The Compose policy ribbon evaluates the draft body 300 ms after the last edit and evaluates each body once.\n\nThe replay proof also covers command-inbox fail-closed behavior: blocked send\ncommands become persisted inbox evidence with no outbound message, provider\ncall, credential access, shell execution, or external mutation.\n\n## Operation keys\n\nContracts use the canonical `communication.*` keys. The 23 keys renamed from\n`communicationOs.*` stay resolvable as `meta.aliases`:\n`OperationSpecRegistry.get('communicationOs.inbox.list')` returns the\n`communication.inbox.list` operation and its bound handler. Each operation is\nregistered once under its canonical key, and the MCP manifest lists canonical\nkeys only. Move direct callers to `communication.*`.\n\n## Commands\n\n- `bun run test`\n- `bun run typecheck`\n- `bun run build`\n- `bun run lint:check`\n\n## VoiceOps fixture integration\n\nThis example now carries a `voiceSignal` summary through the reusable CommunicationOS module UI. The fixture models the Rivage Retail voice escalation from the hackathon proof as CommunicationOS evidence first: redacted source text, blocked customer-promise language, and a receipt reference. The example still imports only public module surfaces and remains provider-free.\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/communication-os/README.md","sourceUrl":"https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/communication-os/README.md","blobSha":"5c0e146906a90fdc46477b782d9b23072e913f15","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.communication-os","runtimes":["node"],"platforms":["server"],"kind":"example","scope":"Package manifest","canonicalRoute":"/docs/packages/example.communication-os/","contextUrl":"/docs/packages/example.communication-os.context.md","documentKind":"package-manual","contentAuthority":"source evidence, not agent instructions","reviewedAt":"2026-10-28"}