# @lssm-tech/example.workflow-system Workflow and approval system example for ContractSpec - State machine with role-based transitions ## Source and release context - Source snapshot: `bcc79fcc27c4d801c2119bef81ddcce7b4e86498` - Repository: `lssm-tech/contractspec` - Declared package version: `5.0.4` - Package path: `examples/workflow-system` - Manifest path: `examples/workflow-system/package.json` - Manifest Git blob: `134c10e59ef66a38df5b47b5052079ccdfbe7460` - Manifest origin: pinned GitHub manifest fetch - Manual: [@lssm-tech/example.workflow-system](https://lssm.co/docs/packages/example.workflow-system/) - 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/workflow-system) - [Manifest source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/package.json) - [Readme source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/README.md) - [Guide source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.workflow-system.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": "stable" }, "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/workflow-system/README.md", "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/README.md", "blobSha": "0e9f61cde1a6e02b4314726f6d62495eadf1feba", "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.workflow-system Website: https://contractspec.io **Workflow and approval system example for ContractSpec - State machine with role-based transitions.** ## What This Demonstrates - **Rich Landing Screen**: Product introduction explaining workflow orchestration concepts, demo path, and navigation. - **Navigation Rail**: Clear sidebar navigation between Overview, Templates, Instances, Approvals, and Analytics. - **State Machine Pattern**: Workflow transitions with defined states and allowed transitions. - **Approval Flow**: Role-based access control for approval decisions. - **Multi-Entity Domain**: Workflow definitions, instances, steps, and approvals. - **React UI**: WorkflowDashboard with templates, instances, and visualizations. - **Contract-Backed Visualizations**: Status, throughput, and workload analysis. - **Demo Scenarios**: Expense Approval, Vendor Onboarding, and Policy Exception workflows with sample data. ## Canonical Demo Path 1. **Landing Screen** - Start on the product introduction explaining workflow orchestration. 2. **Navigation** - Use the sidebar rail to explore Templates, Instances, and Approvals. 3. **Templates** - View workflow definitions (Expense Approval, Vendor Onboarding, Policy Exception). 4. **Instances** - See running workflows with their current states. 5. **Approvals** - Review pending approvals and role-based access. 6. **Analytics** - View throughput metrics and workload analysis. ### New Features - **LandingScreen**: Product-style introduction with value proposition and demo path. - **WorkflowSystemPreviewV2**: Enhanced preview with sidebar navigation. - **WorkflowNav**: Navigation rail for moving between workflow sections. - **Demo Scenarios**: Three complete workflow examples with sample instances. ## Running Locally From `examples/workflow-system`: - `bun run dev` - `bun run build` - `bun run test` - `bun run typecheck` ## Usage Use `@lssm-tech/example.workflow-system` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles. ## Architecture - `src/approval` is part of the package's public or composition surface. - `src/docs/` contains docblocks and documentation-facing exports. - `src/entities/` contains domain entities and value objects. - `src/example.ts` is the runnable example entrypoint. - `src/handlers/` contains handlers or demo adapters wired to contract surfaces. - `src/index.ts` is the root public barrel and package entrypoint. - `src/instance` is part of the package's public or composition surface. ## Public Entry Points - Export `.` resolves through `./src/index.ts`. - Export `./approval` resolves through `./src/approval/index.ts`. - Export `./approval/approval.enum` resolves through `./src/approval/approval.enum.ts`. - Export `./approval/approval.event` resolves through `./src/approval/approval.event.ts`. - Export `./approval/approval.handler` resolves through `./src/approval/approval.handler.ts`. - Export `./approval/approval.operations` resolves through `./src/approval/approval.operations.ts`. - Export `./approval/approval.schema` resolves through `./src/approval/approval.schema.ts`. - Export `./docs` resolves through `./src/docs/index.ts`. - Export `./docs/workflow-system.docblock` is an alias of `./docs` and resolves through `./src/docs/index.ts`. - Export `./entities` resolves through `./src/entities/index.ts`. - The package publishes 44 total export subpaths; keep docs aligned with `package.json`. ## Local Commands - `bun run dev` — contractspec-bun-build dev - `bun run build` — contractspec-bun-build build - `bun run lint` — bun lint:fix - `bun run lint:check` — biome check . - `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write . - `bun run typecheck` — tsgo --noEmit - `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose - `bun run publish:pkg:canary` — bun publish:pkg --tag canary - `bun run clean` — rimraf dist .turbo - `bun run build:bundle` — contractspec-bun-build transpile - `bun run build:types` — contractspec-bun-build types - `bun run prebuild` — contractspec-bun-build prebuild - `bun run test` — bun test ## Recent Updates - **UI Improvements**: Added LandingScreen, WorkflowNav, and WorkflowSystemPreviewV2 with enhanced navigation. - **Demo Scenarios**: Complete workflow examples with Expense Approval, Vendor Onboarding, and Policy Exception. - Replace eslint+prettier by biomejs to optimize speed. ## Notes - Works alongside `@lssm-tech/lib.contracts-spec`, `@lssm-tech/lib.design-system`, `@lssm-tech/lib.example-shared-ui`, `@lssm-tech/lib.runtime-sandbox`, `@lssm-tech/lib.schema`, ... ## 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": "stable", "platforms": [ "server" ], "runtimes": [ "node" ], "entrypoints": [ ".", "./approval", "./approval/approval.enum", "./approval/approval.event", "./approval/approval.handler", "./approval/approval.operations", "./approval/approval.schema", "./docs", "./docs/workflow-system.docblock", "./entities", "./entities/approval", "./entities/instance", "./entities/step", "./entities/workflow", "./example", "./handlers", "./handlers/workflow.handlers", "./instance", "./instance/instance.enum", "./instance/instance.event", "./instance/instance.handler", "./instance/instance.operations", "./instance/instance.schema", "./presentations", "./seeders", "./shared", "./shared/demo-scenario", "./shared/mock-data", "./shared/types", "./state-machine", "./tests/operations.test-spec", "./ui", "./ui/components", "./ui/components/WorkflowNav", "./ui/hooks", "./ui/hooks/useWorkflowList", "./ui/renderers", "./ui/renderers/workflow.markdown", "./ui/views", "./ui/views/LandingScreen", "./ui/views/WorkflowDagScreen.deprecated", "./ui/views/WorkflowSystemPreviewV2", "./ui/WorkflowDashboard", "./ui/WorkflowDashboard.visualizations", "./visualizations", "./visualizations/catalog", "./visualizations/selectors", "./workflow", "./workflow-system.capability", "./workflow-system.feature", "./workflow/workflow.enum", "./workflow/workflow.event", "./workflow/workflow.handler", "./workflow/workflow.operations", "./workflow/workflow.schema" ], "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.workflow-system` — subpath `.` - `unconditional`: `./src/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/index.ts); verified source file. - `@lssm-tech/example.workflow-system/approval` — subpath `./approval` - `unconditional`: `./src/approval/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/approval/index.ts); verified source file. - `@lssm-tech/example.workflow-system/approval/approval.enum` — subpath `./approval/approval.enum` - `unconditional`: `./src/approval/approval.enum.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/approval/approval.enum.ts); verified source file. - `@lssm-tech/example.workflow-system/approval/approval.event` — subpath `./approval/approval.event` - `unconditional`: `./src/approval/approval.event.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/approval/approval.event.ts); verified source file. - `@lssm-tech/example.workflow-system/approval/approval.handler` — subpath `./approval/approval.handler` - `unconditional`: `./src/approval/approval.handler.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/approval/approval.handler.ts); verified source file. - `@lssm-tech/example.workflow-system/approval/approval.operations` — subpath `./approval/approval.operations` - `unconditional`: `./src/approval/approval.operations.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/approval/approval.operations.ts); verified source file. - `@lssm-tech/example.workflow-system/approval/approval.schema` — subpath `./approval/approval.schema` - `unconditional`: `./src/approval/approval.schema.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/approval/approval.schema.ts); verified source file. - `@lssm-tech/example.workflow-system/docs` — subpath `./docs` - `unconditional`: `./src/docs/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/docs/index.ts); verified source file. - `@lssm-tech/example.workflow-system/docs/workflow-system.docblock` — subpath `./docs/workflow-system.docblock` - `unconditional`: `./src/docs/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/docs/index.ts); verified source file. - `@lssm-tech/example.workflow-system/entities` — subpath `./entities` - `unconditional`: `./src/entities/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/entities/index.ts); verified source file. - `@lssm-tech/example.workflow-system/entities/approval` — subpath `./entities/approval` - `unconditional`: `./src/entities/approval.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/entities/approval.ts); verified source file. - `@lssm-tech/example.workflow-system/entities/instance` — subpath `./entities/instance` - `unconditional`: `./src/entities/instance.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/entities/instance.ts); verified source file. - `@lssm-tech/example.workflow-system/entities/step` — subpath `./entities/step` - `unconditional`: `./src/entities/step.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/entities/step.ts); verified source file. - `@lssm-tech/example.workflow-system/entities/workflow` — subpath `./entities/workflow` - `unconditional`: `./src/entities/workflow.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/entities/workflow.ts); verified source file. - `@lssm-tech/example.workflow-system/example` — subpath `./example` - `unconditional`: `./src/example.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/example.ts); verified source file. - `@lssm-tech/example.workflow-system/handlers` — subpath `./handlers` - `unconditional`: `./src/handlers/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/handlers/index.ts); verified source file. - `@lssm-tech/example.workflow-system/handlers/workflow.handlers` — subpath `./handlers/workflow.handlers` - `unconditional`: `./src/handlers/workflow.handlers.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/handlers/workflow.handlers.ts); verified source file. - `@lssm-tech/example.workflow-system/instance` — subpath `./instance` - `unconditional`: `./src/instance/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/instance/index.ts); verified source file. - `@lssm-tech/example.workflow-system/instance/instance.enum` — subpath `./instance/instance.enum` - `unconditional`: `./src/instance/instance.enum.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/instance/instance.enum.ts); verified source file. - `@lssm-tech/example.workflow-system/instance/instance.event` — subpath `./instance/instance.event` - `unconditional`: `./src/instance/instance.event.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/instance/instance.event.ts); verified source file. - `@lssm-tech/example.workflow-system/instance/instance.handler` — subpath `./instance/instance.handler` - `unconditional`: `./src/instance/instance.handler.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/instance/instance.handler.ts); verified source file. - `@lssm-tech/example.workflow-system/instance/instance.operations` — subpath `./instance/instance.operations` - `unconditional`: `./src/instance/instance.operations.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/instance/instance.operations.ts); verified source file. - `@lssm-tech/example.workflow-system/instance/instance.schema` — subpath `./instance/instance.schema` - `unconditional`: `./src/instance/instance.schema.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/instance/instance.schema.ts); verified source file. - `@lssm-tech/example.workflow-system/presentations` — subpath `./presentations` - `unconditional`: `./src/presentations/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/presentations/index.ts); verified source file. - `@lssm-tech/example.workflow-system/seeders` — subpath `./seeders` - `unconditional`: `./src/seeders/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/seeders/index.ts); verified source file. - `@lssm-tech/example.workflow-system/shared` — subpath `./shared` - `unconditional`: `./src/shared/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/shared/index.ts); verified source file. - `@lssm-tech/example.workflow-system/shared/demo-scenario` — subpath `./shared/demo-scenario` - `unconditional`: `./src/shared/demo-scenario.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/shared/demo-scenario.ts); verified source file. - `@lssm-tech/example.workflow-system/shared/mock-data` — subpath `./shared/mock-data` - `unconditional`: `./src/shared/mock-data.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/shared/mock-data.ts); verified source file. - `@lssm-tech/example.workflow-system/shared/types` — subpath `./shared/types` - `unconditional`: `./src/shared/types.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/shared/types.ts); verified source file. - `@lssm-tech/example.workflow-system/state-machine` — subpath `./state-machine` - `unconditional`: `./src/state-machine/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/state-machine/index.ts); verified source file. - `@lssm-tech/example.workflow-system/tests/operations.test-spec` — subpath `./tests/operations.test-spec` - `unconditional`: `./src/tests/operations.test-spec.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/tests/operations.test-spec.ts); verified source file. - `@lssm-tech/example.workflow-system/ui` — subpath `./ui` - `unconditional`: `./src/ui/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/index.ts); verified source file. - `@lssm-tech/example.workflow-system/ui/components` — subpath `./ui/components` - `unconditional`: `./src/ui/components/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/components/index.ts); verified source file. - `@lssm-tech/example.workflow-system/ui/components/WorkflowNav` — subpath `./ui/components/WorkflowNav` - `unconditional`: `./src/ui/components/WorkflowNav.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/components/WorkflowNav.tsx); verified source file. - `@lssm-tech/example.workflow-system/ui/hooks` — subpath `./ui/hooks` - `unconditional`: `./src/ui/hooks/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/hooks/index.ts); verified source file. - `@lssm-tech/example.workflow-system/ui/hooks/useWorkflowList` — subpath `./ui/hooks/useWorkflowList` - `unconditional`: `./src/ui/hooks/useWorkflowList.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/hooks/useWorkflowList.ts); verified source file. - `@lssm-tech/example.workflow-system/ui/renderers` — subpath `./ui/renderers` - `unconditional`: `./src/ui/renderers/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/renderers/index.ts); verified source file. - `@lssm-tech/example.workflow-system/ui/renderers/workflow.markdown` — subpath `./ui/renderers/workflow.markdown` - `unconditional`: `./src/ui/renderers/workflow.markdown.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/renderers/workflow.markdown.ts); verified source file. - `@lssm-tech/example.workflow-system/ui/views` — subpath `./ui/views` - `unconditional`: `./src/ui/views/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/views/index.ts); verified source file. - `@lssm-tech/example.workflow-system/ui/views/LandingScreen` — subpath `./ui/views/LandingScreen` - `unconditional`: `./src/ui/views/LandingScreen.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/views/LandingScreen.tsx); verified source file. - `@lssm-tech/example.workflow-system/ui/views/WorkflowDagScreen.deprecated` — subpath `./ui/views/WorkflowDagScreen.deprecated` - `unconditional`: `./src/ui/views/WorkflowDagScreen.deprecated.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/views/WorkflowDagScreen.deprecated.tsx); verified source file. - `@lssm-tech/example.workflow-system/ui/views/WorkflowSystemPreviewV2` — subpath `./ui/views/WorkflowSystemPreviewV2` - `unconditional`: `./src/ui/views/WorkflowSystemPreviewV2.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/views/WorkflowSystemPreviewV2.tsx); verified source file. - `@lssm-tech/example.workflow-system/ui/WorkflowDashboard` — subpath `./ui/WorkflowDashboard` - `unconditional`: `./src/ui/WorkflowDashboard.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/WorkflowDashboard.tsx); verified source file. - `@lssm-tech/example.workflow-system/ui/WorkflowDashboard.visualizations` — subpath `./ui/WorkflowDashboard.visualizations` - `unconditional`: `./src/ui/WorkflowDashboard.visualizations.tsx` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/ui/WorkflowDashboard.visualizations.tsx); verified source file. - `@lssm-tech/example.workflow-system/visualizations` — subpath `./visualizations` - `unconditional`: `./src/visualizations/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/visualizations/index.ts); verified source file. - `@lssm-tech/example.workflow-system/visualizations/catalog` — subpath `./visualizations/catalog` - `unconditional`: `./src/visualizations/catalog.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/visualizations/catalog.ts); verified source file. - `@lssm-tech/example.workflow-system/visualizations/selectors` — subpath `./visualizations/selectors` - `unconditional`: `./src/visualizations/selectors.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/visualizations/selectors.ts); verified source file. - `@lssm-tech/example.workflow-system/workflow` — subpath `./workflow` - `unconditional`: `./src/workflow/index.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/workflow/index.ts); verified source file. - `@lssm-tech/example.workflow-system/workflow-system.capability` — subpath `./workflow-system.capability` - `unconditional`: `./src/workflow-system.capability.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/workflow-system.capability.ts); verified source file. - `@lssm-tech/example.workflow-system/workflow-system.feature` — subpath `./workflow-system.feature` - `unconditional`: `./src/workflow-system.feature.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/workflow-system.feature.ts); verified source file. - `@lssm-tech/example.workflow-system/workflow/workflow.enum` — subpath `./workflow/workflow.enum` - `unconditional`: `./src/workflow/workflow.enum.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/workflow/workflow.enum.ts); verified source file. - `@lssm-tech/example.workflow-system/workflow/workflow.event` — subpath `./workflow/workflow.event` - `unconditional`: `./src/workflow/workflow.event.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/workflow/workflow.event.ts); verified source file. - `@lssm-tech/example.workflow-system/workflow/workflow.handler` — subpath `./workflow/workflow.handler` - `unconditional`: `./src/workflow/workflow.handler.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/workflow/workflow.handler.ts); verified source file. - `@lssm-tech/example.workflow-system/workflow/workflow.operations` — subpath `./workflow/workflow.operations` - `unconditional`: `./src/workflow/workflow.operations.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/workflow/workflow.operations.ts); verified source file. - `@lssm-tech/example.workflow-system/workflow/workflow.schema` — subpath `./workflow/workflow.schema` - `unconditional`: `./src/workflow/workflow.schema.ts` — [pinned source](https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/workflow-system/src/workflow/workflow.schema.ts); verified source file. ## Package publication metadata These are source-manifest declarations, not a registry installation check. ```json { "types": "./dist/index.d.ts", "files": [ "dist", "README.md" ], "publishExports": { ".": { "types": "./dist/index.d.ts", "browser": "./dist/browser/index.js", "bun": "./dist/index.js", "default": "./dist/index.js" }, "./approval": { "types": "./dist/approval/index.d.ts", "browser": "./dist/browser/approval/index.js", "bun": "./dist/approval/index.js", "default": "./dist/approval/index.js" }, "./approval/approval.enum": { "types": "./dist/approval/approval.enum.d.ts", "browser": "./dist/browser/approval/approval.enum.js", "bun": "./dist/approval/approval.enum.js", "default": "./dist/approval/approval.enum.js" }, "./approval/approval.event": { "types": "./dist/approval/approval.event.d.ts", "browser": "./dist/browser/approval/approval.event.js", "bun": "./dist/approval/approval.event.js", "default": "./dist/approval/approval.event.js" }, "./approval/approval.handler": { "types": "./dist/approval/approval.handler.d.ts", "browser": "./dist/browser/approval/approval.handler.js", "bun": "./dist/approval/approval.handler.js", "default": "./dist/approval/approval.handler.js" }, "./approval/approval.operations": { "types": "./dist/approval/approval.operations.d.ts", "browser": "./dist/browser/approval/approval.operations.js", "bun": "./dist/approval/approval.operations.js", "default": "./dist/approval/approval.operations.js" }, "./approval/approval.schema": { "types": "./dist/approval/approval.schema.d.ts", "browser": "./dist/browser/approval/approval.schema.js", "bun": "./dist/approval/approval.schema.js", "default": "./dist/approval/approval.schema.js" }, "./docs": { "types": "./dist/docs/index.d.ts", "browser": "./dist/browser/docs/index.js", "bun": "./dist/docs/index.js", "default": "./dist/docs/index.js" }, "./docs/workflow-system.docblock": { "types": "./dist/docs/index.d.ts", "browser": "./dist/browser/docs/index.js", "bun": "./dist/docs/index.js", "default": "./dist/docs/index.js" }, "./entities": { "types": "./dist/entities/index.d.ts", "browser": "./dist/browser/entities/index.js", "bun": "./dist/entities/index.js", "default": "./dist/entities/index.js" }, "./entities/approval": { "types": "./dist/entities/approval.d.ts", "browser": "./dist/browser/entities/approval.js", "bun": "./dist/entities/approval.js", "default": "./dist/entities/approval.js" }, "./entities/instance": { "types": "./dist/entities/instance.d.ts", "browser": "./dist/browser/entities/instance.js", "bun": "./dist/entities/instance.js", "default": "./dist/entities/instance.js" }, "./entities/step": { "types": "./dist/entities/step.d.ts", "browser": "./dist/browser/entities/step.js", "bun": "./dist/entities/step.js", "default": "./dist/entities/step.js" }, "./entities/workflow": { "types": "./dist/entities/workflow.d.ts", "browser": "./dist/browser/entities/workflow.js", "bun": "./dist/entities/workflow.js", "default": "./dist/entities/workflow.js" }, "./example": { "types": "./dist/example.d.ts", "browser": "./dist/browser/example.js", "bun": "./dist/example.js", "default": "./dist/example.js" }, "./handlers": { "types": "./dist/handlers/index.d.ts", "browser": "./dist/browser/handlers/index.js", "bun": "./dist/handlers/index.js", "default": "./dist/handlers/index.js" }, "./handlers/workflow.handlers": { "types": "./dist/handlers/workflow.handlers.d.ts", "browser": "./dist/browser/handlers/workflow.handlers.js", "bun": "./dist/handlers/workflow.handlers.js", "default": "./dist/handlers/workflow.handlers.js" }, "./instance": { "types": "./dist/instance/index.d.ts", "browser": "./dist/browser/instance/index.js", "bun": "./dist/instance/index.js", "default": "./dist/instance/index.js" }, "./instance/instance.enum": { "types": "./dist/instance/instance.enum.d.ts", "browser": "./dist/browser/instance/instance.enum.js", "bun": "./dist/instance/instance.enum.js", "default": "./dist/instance/instance.enum.js" }, "./instance/instance.event": { "types": "./dist/instance/instance.event.d.ts", "browser": "./dist/browser/instance/instance.event.js", "bun": "./dist/instance/instance.event.js", "default": "./dist/instance/instance.event.js" }, "./instance/instance.handler": { "types": "./dist/instance/instance.handler.d.ts", "browser": "./dist/browser/instance/instance.handler.js", "bun": "./dist/instance/instance.handler.js", "default": "./dist/instance/instance.handler.js" }, "./instance/instance.operations": { "types": "./dist/instance/instance.operations.d.ts", "browser": "./dist/browser/instance/instance.operations.js", "bun": "./dist/instance/instance.operations.js", "default": "./dist/instance/instance.operations.js" }, "./instance/instance.schema": { "types": "./dist/instance/instance.schema.d.ts", "browser": "./dist/browser/instance/instance.schema.js", "bun": "./dist/instance/instance.schema.js", "default": "./dist/instance/instance.schema.js" }, "./presentations": { "types": "./dist/presentations/index.d.ts", "browser": "./dist/browser/presentations/index.js", "bun": "./dist/presentations/index.js", "default": "./dist/presentations/index.js" }, "./seeders": { "types": "./dist/seeders/index.d.ts", "browser": "./dist/browser/seeders/index.js", "bun": "./dist/seeders/index.js", "default": "./dist/seeders/index.js" }, "./shared": { "types": "./dist/shared/index.d.ts", "browser": "./dist/browser/shared/index.js", "bun": "./dist/shared/index.js", "default": "./dist/shared/index.js" }, "./shared/demo-scenario": { "types": "./dist/shared/demo-scenario.d.ts", "browser": "./dist/browser/shared/demo-scenario.js", "bun": "./dist/shared/demo-scenario.js", "default": "./dist/shared/demo-scenario.js" }, "./shared/mock-data": { "types": "./dist/shared/mock-data.d.ts", "browser": "./dist/browser/shared/mock-data.js", "bun": "./dist/shared/mock-data.js", "default": "./dist/shared/mock-data.js" }, "./shared/types": { "types": "./dist/shared/types.d.ts", "browser": "./dist/browser/shared/types.js", "bun": "./dist/shared/types.js", "default": "./dist/shared/types.js" }, "./state-machine": { "types": "./dist/state-machine/index.d.ts", "browser": "./dist/browser/state-machine/index.js", "bun": "./dist/state-machine/index.js", "default": "./dist/state-machine/index.js" }, "./tests/operations.test-spec": { "types": "./dist/tests/operations.test-spec.d.ts", "browser": "./dist/browser/tests/operations.test-spec.js", "bun": "./dist/tests/operations.test-spec.js", "default": "./dist/tests/operations.test-spec.js" }, "./ui": { "types": "./dist/ui/index.d.ts", "browser": "./dist/browser/ui/index.js", "bun": "./dist/ui/index.js", "default": "./dist/ui/index.js" }, "./ui/components": { "types": "./dist/ui/components/index.d.ts", "browser": "./dist/browser/ui/components/index.js", "bun": "./dist/ui/components/index.js", "default": "./dist/ui/components/index.js" }, "./ui/components/WorkflowNav": { "types": "./dist/ui/components/WorkflowNav.d.ts", "browser": "./dist/browser/ui/components/WorkflowNav.js", "bun": "./dist/ui/components/WorkflowNav.js", "default": "./dist/ui/components/WorkflowNav.js" }, "./ui/hooks": { "types": "./dist/ui/hooks/index.d.ts", "browser": "./dist/browser/ui/hooks/index.js", "bun": "./dist/ui/hooks/index.js", "default": "./dist/ui/hooks/index.js" }, "./ui/hooks/useWorkflowList": { "types": "./dist/ui/hooks/useWorkflowList.d.ts", "browser": "./dist/browser/ui/hooks/useWorkflowList.js", "bun": "./dist/ui/hooks/useWorkflowList.js", "default": "./dist/ui/hooks/useWorkflowList.js" }, "./ui/renderers": { "types": "./dist/ui/renderers/index.d.ts", "browser": "./dist/browser/ui/renderers/index.js", "bun": "./dist/ui/renderers/index.js", "default": "./dist/ui/renderers/index.js" }, "./ui/renderers/workflow.markdown": { "types": "./dist/ui/renderers/workflow.markdown.d.ts", "browser": "./dist/browser/ui/renderers/workflow.markdown.js", "bun": "./dist/ui/renderers/workflow.markdown.js", "default": "./dist/ui/renderers/workflow.markdown.js" }, "./ui/views": { "types": "./dist/ui/views/index.d.ts", "browser": "./dist/browser/ui/views/index.js", "bun": "./dist/ui/views/index.js", "default": "./dist/ui/views/index.js" }, "./ui/views/LandingScreen": { "types": "./dist/ui/views/LandingScreen.d.ts", "browser": "./dist/browser/ui/views/LandingScreen.js", "bun": "./dist/ui/views/LandingScreen.js", "default": "./dist/ui/views/LandingScreen.js" }, "./ui/views/WorkflowDagScreen.deprecated": { "types": "./dist/ui/views/WorkflowDagScreen.deprecated.d.ts", "browser": "./dist/browser/ui/views/WorkflowDagScreen.deprecated.js", "bun": "./dist/ui/views/WorkflowDagScreen.deprecated.js", "default": "./dist/ui/views/WorkflowDagScreen.deprecated.js" }, "./ui/views/WorkflowSystemPreviewV2": { "types": "./dist/ui/views/WorkflowSystemPreviewV2.d.ts", "browser": "./dist/browser/ui/views/WorkflowSystemPreviewV2.js", "bun": "./dist/ui/views/WorkflowSystemPreviewV2.js", "default": "./dist/ui/views/WorkflowSystemPreviewV2.js" }, "./ui/WorkflowDashboard": { "types": "./dist/ui/WorkflowDashboard.d.ts", "browser": "./dist/browser/ui/WorkflowDashboard.js", "bun": "./dist/ui/WorkflowDashboard.js", "default": "./dist/ui/WorkflowDashboard.js" }, "./ui/WorkflowDashboard.visualizations": { "types": "./dist/ui/WorkflowDashboard.visualizations.d.ts", "browser": "./dist/browser/ui/WorkflowDashboard.visualizations.js", "bun": "./dist/ui/WorkflowDashboard.visualizations.js", "default": "./dist/ui/WorkflowDashboard.visualizations.js" }, "./visualizations": { "types": "./dist/visualizations/index.d.ts", "browser": "./dist/browser/visualizations/index.js", "bun": "./dist/visualizations/index.js", "default": "./dist/visualizations/index.js" }, "./visualizations/catalog": { "types": "./dist/visualizations/catalog.d.ts", "browser": "./dist/browser/visualizations/catalog.js", "bun": "./dist/visualizations/catalog.js", "default": "./dist/visualizations/catalog.js" }, "./visualizations/selectors": { "types": "./dist/visualizations/selectors.d.ts", "browser": "./dist/browser/visualizations/selectors.js", "bun": "./dist/visualizations/selectors.js", "default": "./dist/visualizations/selectors.js" }, "./workflow": { "types": "./dist/workflow/index.d.ts", "browser": "./dist/browser/workflow/index.js", "bun": "./dist/workflow/index.js", "default": "./dist/workflow/index.js" }, "./workflow-system.capability": { "types": "./dist/workflow-system.capability.d.ts", "browser": "./dist/browser/workflow-system.capability.js", "bun": "./dist/workflow-system.capability.js", "default": "./dist/workflow-system.capability.js" }, "./workflow-system.feature": { "types": "./dist/workflow-system.feature.d.ts", "browser": "./dist/browser/workflow-system.feature.js", "bun": "./dist/workflow-system.feature.js", "default": "./dist/workflow-system.feature.js" }, "./workflow/workflow.enum": { "types": "./dist/workflow/workflow.enum.d.ts", "browser": "./dist/browser/workflow/workflow.enum.js", "bun": "./dist/workflow/workflow.enum.js", "default": "./dist/workflow/workflow.enum.js" }, "./workflow/workflow.event": { "types": "./dist/workflow/workflow.event.d.ts", "browser": "./dist/browser/workflow/workflow.event.js", "bun": "./dist/workflow/workflow.event.js", "default": "./dist/workflow/workflow.event.js" }, "./workflow/workflow.handler": { "types": "./dist/workflow/workflow.handler.d.ts", "browser": "./dist/browser/workflow/workflow.handler.js", "bun": "./dist/workflow/workflow.handler.js", "default": "./dist/workflow/workflow.handler.js" }, "./workflow/workflow.operations": { "types": "./dist/workflow/workflow.operations.d.ts", "browser": "./dist/browser/workflow/workflow.operations.js", "bun": "./dist/workflow/workflow.operations.js", "default": "./dist/workflow/workflow.operations.js" }, "./workflow/workflow.schema": { "types": "./dist/workflow/workflow.schema.d.ts", "browser": "./dist/browser/workflow/workflow.schema.js", "bun": "./dist/workflow/workflow.schema.js", "default": "./dist/workflow/workflow.schema.js" } } } ``` ## Dependencies Metadata status: complete pinned manifest. ### Runtime dependencies - [@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:^` - [@lssm-tech/lib.example-shared-ui](https://lssm.co/docs/packages/lib.example-shared-ui/): `workspace:^` - [@lssm-tech/lib.presentation-runtime-core](https://lssm.co/docs/packages/lib.presentation-runtime-core/): `workspace:^` - [@lssm-tech/lib.runtime-sandbox](https://lssm.co/docs/packages/lib.runtime-sandbox/): `workspace:^` - [@lssm-tech/lib.schema](https://lssm.co/docs/packages/lib.schema/): `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 { "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose", "publish:pkg:canary": "bun publish:pkg --tag canary", "build": "contractspec-bun-build build", "build:bundle": "contractspec-bun-build transpile", "build:types": "contractspec-bun-build types", "dev": "contractspec-bun-build dev", "clean": "rimraf dist .turbo", "lint": "bun lint:fix", "lint:fix": "node ../../scripts/biome.cjs check --write --unsafe --only=nursery/useSortedClasses . && node ../../scripts/biome.cjs check --write .", "lint:check": "node ../../scripts/biome.cjs check .", "prebuild": "contractspec-bun-build prebuild", "test": "bun test", "typecheck": "tsgo --noEmit" } ``` ## Declared documentation links - [Example Workflow System documentation](https://www.npmjs.com/package/%40lssm-tech%2Fexample.workflow-system) — declared link; destination not verified. ```json { "url": "https://www.npmjs.com/package/%40lssm-tech%2Fexample.workflow-system", "kind": "readme" } ``` ## Existing agent-guide projection ```json { "path": "packages/apps/web-landing/public/llms-packages/example.workflow-system.txt", "route": "/llms/example.workflow-system", "sourceUrl": "https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/packages/apps/web-landing/public/llms-packages/example.workflow-system.txt", "blobSha": "0e9f61cde1a6e02b4314726f6d62495eadf1feba", "sourcePin": "bcc79fcc27c4d801c2119bef81ddcce7b4e86498", "bodyEqualsReadme": true, "aggregateSourcePath": "packages/apps/web-landing/public/llms-full.txt", "aggregateBlobSha": "691b1d33efee24c440598b9106c81432f56aafaf" } ```