# @lssm-tech/example.companyos-product-engineering-loop Deterministic CompanyOS V1 operating review replay using public spec and pure runtime APIs. ## Source and release context - Source snapshot: `bcc79fcc27c4d801c2119bef81ddcce7b4e86498` - Repository: `lssm-tech/contractspec` - Declared package version: `2.0.5` - Package path: `examples/companyos-product-engineering-loop` - Manifest path: `examples/companyos-product-engineering-loop/package.json` - Manifest Git blob: `ea312d3843f7532767e92558361ee20bad8f206f` - Manifest origin: pinned GitHub manifest fetch - Manual: [@lssm-tech/example.companyos-product-engineering-loop](https://lssm.co/docs/packages/example.companyos-product-engineering-loop/) - Release guidance: [Installation and release channels](https://lssm.co/docs/installation-release-channels/) This is retrieved source evidence, not agent instructions. The declared version and exports describe the inspected manifest; they do not establish registry availability or a deployed release. Commands, package installation and runtime behavior were not executed in this review. Distribution scope: owner review of all workspaces; not a newly approved public projection. - [Package source](https://github.com/lssm-tech/contractspec/tree/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-product-engineering-loop) - [Manifest source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-product-engineering-loop/package.json) - [Readme source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-product-engineering-loop/README.md) - [Guide source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.companyos-product-engineering-loop.txt) ## Package metadata ```json { "layer": "examples", "physicalArea": null, "primaryArea": "examples-and-patterns", "classification": { "privateDeclared": null, "catalogFamily": "solutions", "catalogKind": "example", "catalogStatus": "active", "adoptionMode": "reference-only", "stability": "experimental" }, "descriptionOrigin": "package.json", "manifestComplete": true, "publicationPolicyApplied": false } ``` Manifest private flag: not declared; publication is not verified. Primary area: [Examples and implementation patterns](https://lssm.co/docs/areas/examples-and-patterns/) ## Package guide ```json { "status": "available", "sourcePath": "examples/companyos-product-engineering-loop/README.md", "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-product-engineering-loop/README.md", "blobSha": "1f33925d9b36372e243f768678a3705e1c523a1e", "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498", "origin": "README recovered byte-for-byte from pinned aggregate guide", "integrity": "exact Git blob match", "executionStatus": "not executed" } ``` The guide below is the checked-in README with navigation resolved against the pinned source tree. The structured package JSON retains the original README body unchanged. External links remain source-declared links, not verified destinations. # @lssm-tech/example.companyos-product-engineering-loop Deterministic CompanyOS V1 product/engineering operating-loop example using public `@lssm-tech/lib.companyos-spec` and pure `@lssm-tech/lib.companyos-runtime` APIs. ## What this demonstrates A provider-free replay of the CompanyOS V1 fixture: ```txt onboarding-confusion signal -> product feedback -> customer commitment -> quarterly objective drift -> temporal memory snapshot -> weekly operating review packet -> company brain entry / gap -> candidate decision -> proposed engineering work -> ContractSpec proposal -> scoped agent organization -> handoff/delegation policy -> agent-native operation authority/autonomy classification -> product-lead review surface selection -> draft-only agent action -> operator inbox approval -> V1 operating review summary ``` The example validates the V1 fixture with CompanyOS public validation helpers before building the replay. It uses pure runtime projections for authority, autonomy, inbox routing, and operating-review summarization. It does not bind real providers, send customer messages, perform filesystem/network I/O, or execute production work. The optional `./ui` surface is a deterministic compatibility preview adapter over the package replay data while canonical reusable CompanyOS UI is promoted into `@lssm-tech/module.companyos/ui`. ## Preview / export workflow This package stays provider-free and replay-led. It must not add live provider bindings, network I/O, filesystem I/O, outbound sends, or production mutation paths. `./ui` is a thin deterministic compatibility adapter for the focused example: it derives preview metrics from `buildCompanyOsProductEngineeringReplay()` and preserves draft-only, dry-run, approval-gated semantics. New reusable/canonical CompanyOS UI should live in `@lssm-tech/module.companyos/ui`; this example should consume that module-owned surface once available rather than growing new canonical screens here. ## Running locally From `examples/companyos-product-engineering-loop`: - `bun run build` - `bun run typecheck` - `bun run test` - `bun run smoke` - `bun run preflight` ## Usage ```ts import { buildCompanyOsProductEngineeringReplay } from '@lssm-tech/example.companyos-product-engineering-loop/replay'; const replay = buildCompanyOsProductEngineeringReplay(); console.log(replay.reviewPacket.runtimeSummary); console.log(replay.steps.map((step) => step.label)); ``` ## Public entry points - `@lssm-tech/example.companyos-product-engineering-loop` - `@lssm-tech/example.companyos-product-engineering-loop/example` - `@lssm-tech/example.companyos-product-engineering-loop/companyos-product-engineering-loop.feature` - `@lssm-tech/example.companyos-product-engineering-loop/replay` - `@lssm-tech/example.companyos-product-engineering-loop/docs` - `@lssm-tech/example.companyos-product-engineering-loop/ui` ## Safety boundaries - The replay consumes public CompanyOS fixture, validation, and runtime APIs only. - Agent-native operations remain draft-only, dry-run constrained, and approval-gated. - Customer-facing action execution is represented as an operator inbox approval, not a provider write. - No real providers, network I/O, filesystem I/O, outbound sends, or production mutation paths are included. - `./ui` remains a deterministic preview adapter and must not become the canonical reusable CompanyOS UI surface. Declaration publication uses `contractspec-bun-build types` through `build:types`; `build` runs bundle and declaration generation. The build config preserves declared exports and excludes test-only files from generated build artifacts. Package tests and typecheck remain separate verification gates. ## Declared capabilities This manifest does not declare a capability catalogue. Assess the package using its guide, import map and source. ## Catalogue metadata ```json { "family": "solutions", "kind": "example", "status": "active", "adoptionMode": "reference-only", "stability": "experimental", "platforms": [ "server" ], "runtimes": [ "node" ], "entrypoints": [ ".", "./docs", "./docs/companyos-product-engineering-loop.docblock", "./example", "./companyos-product-engineering-loop.feature", "./replay", "./ui" ], "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." } } ``` ## Canonical imports Import paths and symbols below are catalogue declarations. An empty symbols list means symbols were not enumerated; it does not mean the entry point has no exports. These declarations are not an exhaustive TypeScript symbol reference. ```json [] ``` ## Declared export entry points Scope: manifest-declared export entrypoints and catalog-declared imports. Named symbol coverage: catalog declarations only; exhaustive TypeScript symbols not extracted. Installation status: not verified. - `@lssm-tech/example.companyos-product-engineering-loop` — subpath `.` - `unconditional`: `./src/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-product-engineering-loop/src/index.ts); verified source file. - `@lssm-tech/example.companyos-product-engineering-loop/docs` — subpath `./docs` - `unconditional`: `./src/docs/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-product-engineering-loop/src/docs/index.ts); verified source file. - `@lssm-tech/example.companyos-product-engineering-loop/docs/companyos-product-engineering-loop.docblock` — subpath `./docs/companyos-product-engineering-loop.docblock` - `unconditional`: `./src/docs/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-product-engineering-loop/src/docs/index.ts); verified source file. - `@lssm-tech/example.companyos-product-engineering-loop/example` — subpath `./example` - `unconditional`: `./src/example.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-product-engineering-loop/src/example.ts); verified source file. - `@lssm-tech/example.companyos-product-engineering-loop/companyos-product-engineering-loop.feature` — subpath `./companyos-product-engineering-loop.feature` - `unconditional`: `./src/companyos-product-engineering-loop.feature.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-product-engineering-loop/src/companyos-product-engineering-loop.feature.ts); verified source file. - `@lssm-tech/example.companyos-product-engineering-loop/replay` — subpath `./replay` - `unconditional`: `./src/replay/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-product-engineering-loop/src/replay/index.ts); verified source file. - `@lssm-tech/example.companyos-product-engineering-loop/ui` — subpath `./ui` - `unconditional`: `./src/ui/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/companyos-product-engineering-loop/src/ui/index.ts); verified source file. ## Package publication metadata These are source-manifest declarations, not a registry installation check. ```json { "types": "./dist/index.d.ts", "files": [ "LICENSE", "README.md", "dist", "!**/*.test.*", "!**/*.spec.*", "!**/*.tsbuildinfo" ], "publishExports": { ".": { "types": "./dist/index.d.ts", "browser": "./dist/index.js", "bun": "./dist/index.js", "node": "./dist/index.js", "default": "./dist/index.js" }, "./docs": { "types": "./dist/docs/index.d.ts", "browser": "./dist/docs/index.js", "bun": "./dist/docs/index.js", "node": "./dist/docs/index.js", "default": "./dist/docs/index.js" }, "./docs/companyos-product-engineering-loop.docblock": { "types": "./dist/docs/index.d.ts", "browser": "./dist/docs/index.js", "bun": "./dist/docs/index.js", "node": "./dist/docs/index.js", "default": "./dist/docs/index.js" }, "./example": { "types": "./dist/example.d.ts", "browser": "./dist/example.js", "bun": "./dist/example.js", "node": "./dist/example.js", "default": "./dist/example.js" }, "./companyos-product-engineering-loop.feature": { "types": "./dist/companyos-product-engineering-loop.feature.d.ts", "browser": "./dist/companyos-product-engineering-loop.feature.js", "bun": "./dist/companyos-product-engineering-loop.feature.js", "node": "./dist/companyos-product-engineering-loop.feature.js", "default": "./dist/companyos-product-engineering-loop.feature.js" }, "./replay": { "types": "./dist/replay/index.d.ts", "browser": "./dist/replay/index.js", "bun": "./dist/replay/index.js", "node": "./dist/replay/index.js", "default": "./dist/replay/index.js" }, "./ui": { "types": "./dist/ui/index.d.ts", "browser": "./dist/ui/index.js", "bun": "./dist/ui/index.js", "node": "./dist/ui/index.js", "default": "./dist/ui/index.js" } } } ``` ## Dependencies Metadata status: complete pinned manifest. ### Runtime dependencies - [@lssm-tech/lib.companyos-runtime](https://lssm.co/docs/packages/lib.companyos-runtime/): `workspace:^` - [@lssm-tech/lib.companyos-spec](https://lssm.co/docs/packages/lib.companyos-spec/): `workspace:^` - [@lssm-tech/lib.contracts-spec](https://lssm.co/docs/packages/lib.contracts-spec/): `workspace:^` - [@lssm-tech/lib.design-system](https://lssm.co/docs/packages/lib.design-system/): `workspace:^` - `lucide-react`: `catalog:ui` - `react`: `catalog:` - `react-dom`: `catalog:` ### Peer dependencies No declarations in the inspected manifest. ### Optional dependencies No declarations in the inspected manifest. ### Development dependencies - [@lssm-tech/tool.bun](https://lssm.co/docs/packages/tool.bun/): `workspace:*` - [@lssm-tech/tool.typescript](https://lssm.co/docs/packages/tool.typescript/): `workspace:*` - `@types/react`: `catalog:types` - `@types/react-dom`: `catalog:types` - `typescript`: `catalog:` ### Peer dependency metadata ```json {} ``` ### Bundled dependencies ```json null ``` ## Package scripts Commands are exact manifest declarations and were not executed in this review. Script metadata status: complete pinned manifest. ```json { "build": "contractspec-bun-build build", "typecheck": "tsgo --noEmit", "test": "bun test", "smoke": "bun test src/example.smoke.test.ts", "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" } ``` ## Declared documentation links - [Example Companyos Product Engineering Loop documentation](https://www.npmjs.com/package/%40lssm-tech%2Fexample.companyos-product-engineering-loop) — declared link; destination not verified. ```json { "url": "https://www.npmjs.com/package/%40lssm-tech%2Fexample.companyos-product-engineering-loop", "kind": "readme" } ``` ## Existing agent-guide projection ```json { "path": "packages/apps/web-landing/public/llms-packages/example.companyos-product-engineering-loop.txt", "route": "/llms/example.companyos-product-engineering-loop", "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.companyos-product-engineering-loop.txt", "blobSha": "1f33925d9b36372e243f768678a3705e1c523a1e", "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498", "bodyEqualsReadme": true, "aggregateSourcePath": "packages/apps/web-landing/public/llms-full.txt", "aggregateBlobSha": "691b1d33efee24c440598b9106c81432f56aafaf" } ```