# @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, render UI, send customer messages, perform filesystem/network I/O, or execute production work.

## Preview / export workflow

This package intentionally stays replay-only and provider-free. It must not add UI components, live provider bindings, network I/O, filesystem I/O, outbound sends, or production mutation paths.

Preview consumers should render package-owned replay data through approved module/examples runtime surfaces rather than adding a `./ui` export here. Any preview-only adapter outside this package must preserve draft-only, dry-run, approval-gated semantics and be documented in a release capsule.

## Running locally

From `packages/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`

## 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, UI, network I/O, filesystem I/O, outbound sends, or production mutation paths are included.