@contractspec/example.crm-pipeline 3.7.6 → 3.7.7

package/.turbo/turbo-build.log

@@ -3,15 +3,15 @@ $ bun run prebuild && bun run build:bundle && bun run build:types
 $ contractspec-bun-build prebuild
 $ contractspec-bun-build transpile
 [contractspec-bun-build] transpile target=bun root=src entries=44 noBundle=false
-Bundled 44 modules in 85ms
+Bundled 44 modules in 82ms
 
   ./crm-pipeline.feature.js                 2.54 KB    (entry point)
   seeders/index.js                          1.00 KB    (entry point)
   shared/overlay-types.js                   8 bytes    (entry point)
   ./index.js                                116.70 KB  (entry point)
-  ui/index.js                               74.41 KB   (entry point)
+  ui/index.js                               74.42 KB   (entry point)
   ui/overlays/index.js                      1.19 KB    (entry point)
-  ui/renderers/index.js                     28.45 KB   (entry point)
+  ui/renderers/index.js                     28.46 KB   (entry point)
   ui/renderers/pipeline.markdown.js         17.75 KB   (entry point)
   ui/renderers/pipeline.renderer.js         10.71 KB   (entry point)
   ui/hooks/index.js                         5.75 KB    (entry point)
@@ -20,7 +20,7 @@ Bundled 44 modules in 85ms
   presentations/index.js                    9.78 KB    (entry point)
   presentations/dashboard.presentation.js   1.55 KB    (entry point)
   presentations/pipeline.presentation.js    8.20 KB    (entry point)
-  ui/CrmDashboard.js                        54.56 KB   (entry point)
+  ui/CrmDashboard.js                        54.57 KB   (entry point)
   ui/hooks/useDealList.js                   2.49 KB    (entry point)
   ui/hooks/useDealMutations.js              3.18 KB    (entry point)
   ui/modals/CreateDealModal.js              8.89 KB    (entry point)
@@ -51,7 +51,7 @@ Bundled 44 modules in 85ms
   docs/crm-pipeline.docblock.js             4.43 KB    (entry point)
 
 [contractspec-bun-build] transpile target=node root=src entries=44 noBundle=false
-Bundled 44 modules in 94ms
+Bundled 44 modules in 96ms
 
   ./crm-pipeline.feature.js                 2.54 KB    (entry point)
   seeders/index.js                          0.99 KB    (entry point)
@@ -61,7 +61,7 @@ Bundled 44 modules in 94ms
   ui/overlays/index.js                      1.19 KB    (entry point)
   ui/renderers/index.js                     28.44 KB   (entry point)
   ui/renderers/pipeline.markdown.js         17.74 KB   (entry point)
-  ui/renderers/pipeline.renderer.js         10.69 KB   (entry point)
+  ui/renderers/pipeline.renderer.js         10.70 KB   (entry point)
   ui/hooks/index.js                         5.74 KB    (entry point)
   ui/modals/index.js                        27.52 KB   (entry point)
   ui/overlays/demo-overlays.js              1.19 KB    (entry point)
@@ -99,7 +99,7 @@ Bundled 44 modules in 94ms
   docs/crm-pipeline.docblock.js             4.41 KB    (entry point)
 
 [contractspec-bun-build] transpile target=browser root=src entries=44 noBundle=false
-Bundled 44 modules in 99ms
+Bundled 44 modules in 91ms
 
   ./crm-pipeline.feature.js                 2.54 KB    (entry point)
   seeders/index.js                          0.99 KB    (entry point)
@@ -109,7 +109,7 @@ Bundled 44 modules in 99ms
   ui/overlays/index.js                      1.19 KB    (entry point)
   ui/renderers/index.js                     28.44 KB   (entry point)
   ui/renderers/pipeline.markdown.js         17.74 KB   (entry point)
-  ui/renderers/pipeline.renderer.js         10.69 KB   (entry point)
+  ui/renderers/pipeline.renderer.js         10.70 KB   (entry point)
   ui/hooks/index.js                         5.74 KB    (entry point)
   ui/modals/index.js                        27.52 KB   (entry point)
   ui/overlays/demo-overlays.js              1.19 KB    (entry point)

package/AGENTS.md

@@ -1,42 +1,60 @@
-# AI Agent Guide -- `@contractspec/example.crm-pipeline`
+# AI Agent Guide — `@contractspec/example.crm-pipeline`
 
 Scope: `packages/examples/crm-pipeline/*`
 
-Demonstrates a full CRM pipeline with Contacts, Companies, Deals, and Tasks using spec-first entities, events, and UI.
+CRM Pipeline - Contacts, Companies, Deals, Tasks.
 
 ## Quick Context
 
-- **Layer**: example
-- **Related Packages**: `lib.contracts-spec`, `lib.schema`, `lib.design-system`, `lib.example-shared-ui`, `lib.identity-rbac`, `lib.runtime-sandbox`, `lib.ui-kit-web`, `module.audit-trail`, `module.notifications`
-
-## What This Demonstrates
-
-- Multi-entity domain model (Contact, Company, Deal, Task)
-- Deal pipeline with stage enums, operations, and test-specs
-- Event-driven architecture (contact, deal, task events)
-- Presentation layer with dashboard and pipeline views
-- React UI with pipeline board, deal cards, hooks, modals, overlays, and renderers
-- Feature definition and capability pattern
-- Seeders and mock data
-
-## Public Exports
-
-- `.` -- root barrel
-- `./crm-pipeline.feature` -- feature definition
-- `./deal` -- deal enum, operation, schema, test-spec
-- `./entities` -- contact, company, deal, task entities
-- `./events` -- contact, deal, task events
-- `./handlers` -- CRM and deal handlers with mock data
-- `./operations`, `./presentations` -- domain operations and presentations
-- `./seeders` -- demo data
-- `./ui` -- React components, hooks, modals, overlays, renderers
-- `./docs` -- DocBlock documentation
-- `./example` -- runnable example entry point
+- Layer: `example`.
+- Package visibility: published package.
+- Primary consumers are example explorers, template authors, and documentation readers.
+- Related packages: `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.identity-rbac`, `@contractspec/lib.runtime-sandbox`, `@contractspec/lib.schema`, ...
+
+## Architecture
+
+- `src/crm-pipeline.feature.ts` defines a feature entrypoint.
+- `src/deal` 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/events` is part of the package's public or composition surface.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/handlers/` contains handlers or demo adapters wired to contract surfaces.
+
+## Public Surface
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./crm-pipeline.feature` resolves through `./src/crm-pipeline.feature.ts`.
+- Export `./deal` resolves through `./src/deal/index.ts`.
+- Export `./deal/deal.enum` resolves through `./src/deal/deal.enum.ts`.
+- Export `./deal/deal.operation` resolves through `./src/deal/deal.operation.ts`.
+- Export `./deal/deal.schema` resolves through `./src/deal/deal.schema.ts`.
+- Export `./deal/deal.test-spec` resolves through `./src/deal/deal.test-spec.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/crm-pipeline.docblock` resolves through `./src/docs/crm-pipeline.docblock.ts`.
+- Export `./entities` resolves through `./src/entities/index.ts`.
+- The package publishes 44 total export subpaths; keep docs aligned with `package.json`.
+
+## Guardrails
+
+- Keep the example package demonstrative, buildable, and aligned with the exported feature surface.
+- Do not add hidden production assumptions that are not actually implemented in the example.
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.identity-rbac`, `@contractspec/lib.runtime-sandbox`, `@contractspec/lib.schema`, ....
+- Changes here can affect downstream packages such as `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.identity-rbac`, `@contractspec/lib.runtime-sandbox`, `@contractspec/lib.schema`, ...
 
 ## Local Commands
 
-- Build: `bun run build`
-- Dev: `bun run dev`
-- Test: `bun test`
-- Validate: `bun run validate`
-- Typecheck: `bun run typecheck`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `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` — tsc --noEmit
+- `bun run validate` — contractspec validate "src/**/*"
+- `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

package/README.md

@@ -1,159 +1,77 @@
-# CRM Pipeline
+# @contractspec/example.crm-pipeline
 
-Website: https://contractspec.io/
+Website: https://contractspec.io
 
-A complete CRM (Customer Relationship Management) application demonstrating ContractSpec principles.
+**CRM Pipeline - Contacts, Companies, Deals, Tasks.**
 
-## What's Included
+## What This Demonstrates
 
-This example showcases a CRM system with:
+- Multi-entity domain model (Contact, Company, Deal, Task).
+- Deal pipeline with stage enums, operations, and test-specs.
+- Event-driven architecture (contact, deal, task events).
+- Presentation layer with dashboard and pipeline views.
+- React UI with pipeline board, deal cards, hooks, modals, overlays, and renderers.
+- Feature definition and capability pattern.
+- Seeders and mock data.
 
-- **Contacts**: Individual people with contact information
-- **Companies**: Organizations/accounts that contacts belong to
-- **Deals**: Sales opportunities with pipeline stages
-- **Pipelines**: Customizable sales pipelines with stages
-- **Tasks**: Follow-up activities tied to contacts/deals
+## Running Locally
 
-## Architecture
-
-```
-crm-pipeline/
-├── entities/           # Entity specs (generates Prisma schema)
-│   ├── contact.ts
-│   ├── company.ts
-│   ├── deal.ts
-│   ├── pipeline.ts
-│   └── task.ts
-├── contracts/          # API contracts
-│   ├── contact.ts
-│   ├── deal.ts
-│   └── task.ts
-├── events/             # Domain events
-│   └── index.ts
-└── README.md
-```
-
-## Entities
-
-### Contact
-
-```typescript
-const ContactEntity = defineEntity({
-  name: 'Contact',
-  fields: {
-    id: field.id(),
-    firstName: field.string(),
-    lastName: field.string(),
-    email: field.email({ isOptional: true }),
-    phone: field.string({ isOptional: true }),
-    companyId: field.foreignKey({ isOptional: true }),
-    ownerId: field.foreignKey(),
-    // ...
-  },
-});
-```
-
-### Company
-
-```typescript
-const CompanyEntity = defineEntity({
-  name: 'Company',
-  fields: {
-    id: field.id(),
-    name: field.string(),
-    domain: field.string({ isOptional: true }),
-    industry: field.string({ isOptional: true }),
-    size: field.enum('CompanySize'),
-    // ...
-  },
-});
-```
-
-### Deal
-
-```typescript
-const DealEntity = defineEntity({
-  name: 'Deal',
-  fields: {
-    id: field.id(),
-    name: field.string(),
-    value: field.decimal(),
-    currency: field.string(),
-    stageId: field.foreignKey(),
-    contactId: field.foreignKey({ isOptional: true }),
-    companyId: field.foreignKey({ isOptional: true }),
-    // ...
-  },
-});
-```
-
-### Pipeline & Stage
-
-```typescript
-const PipelineEntity = defineEntity({
-  name: 'Pipeline',
-  fields: {
-    id: field.id(),
-    name: field.string(),
-    isDefault: field.boolean(),
-    // ...
-  },
-});
-
-const StageEntity = defineEntity({
-  name: 'Stage',
-  fields: {
-    id: field.id(),
-    name: field.string(),
-    pipelineId: field.foreignKey(),
-    position: field.int(),
-    probability: field.int(), // Win probability %
-    // ...
-  },
-});
-```
-
-## Events
-
-| Event           | Description             |
-| --------------- | ----------------------- |
-| contact.created | New contact added       |
-| deal.created    | New deal created        |
-| deal.moved      | Deal moved to new stage |
-| deal.won        | Deal marked as won      |
-| deal.lost       | Deal marked as lost     |
-| task.completed  | Task marked complete    |
+From `packages/examples/crm-pipeline`:
+- `bun run dev`
+- `bun run build`
+- `bun run test`
+- `bun run typecheck`
 
 ## Usage
 
-### Load as Studio Template
-
-This example is registered as `crm-pipeline` in the ContractSpec Studio.
-
-### Clone via Git
-
-```bash
-npx degit lssm/contractspec/packages/examples/crm-pipeline my-crm-app
-```
-
-## Adoption narrative
+Use `@contractspec/example.crm-pipeline` as a reference implementation, or import its exported surfaces into a workspace that composes ContractSpec examples and bundles.
 
-### Before
-
-- A CRM app with hand-written data models and handler logic.
-- Pipeline stage rules live in code and drift across UI/API/events.
-- Regeneration is risky because specs and implementations are not aligned.
-
-### After
-
-- Contracts define deals, stages, and tasks as the source of truth.
-- Regeneration keeps UI/API/events in sync when stages change.
-- Compliance surfaces (audits, notifications) stay consistent with specs.
-
-### Minimal adoption steps
+## Architecture
 
-1. Add ContractSpec CLI and core libraries.
-2. Define one operation (for example, `deal/create`).
-3. Run `contractspec build` to generate handlers and types.
-4. Wire the generated handler into your existing router.
-5. Expand to events and presentations as you add surface areas.
+- `src/crm-pipeline.feature.ts` defines a feature entrypoint.
+- `src/deal` 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/events` is part of the package's public or composition surface.
+- `src/example.ts` is the runnable example entrypoint.
+- `src/handlers/` contains handlers or demo adapters wired to contract surfaces.
+
+## Public Entry Points
+
+- Export `.` resolves through `./src/index.ts`.
+- Export `./crm-pipeline.feature` resolves through `./src/crm-pipeline.feature.ts`.
+- Export `./deal` resolves through `./src/deal/index.ts`.
+- Export `./deal/deal.enum` resolves through `./src/deal/deal.enum.ts`.
+- Export `./deal/deal.operation` resolves through `./src/deal/deal.operation.ts`.
+- Export `./deal/deal.schema` resolves through `./src/deal/deal.schema.ts`.
+- Export `./deal/deal.test-spec` resolves through `./src/deal/deal.test-spec.ts`.
+- Export `./docs` resolves through `./src/docs/index.ts`.
+- Export `./docs/crm-pipeline.docblock` resolves through `./src/docs/crm-pipeline.docblock.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` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `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` — tsc --noEmit
+- `bun run validate` — contractspec validate "src/**/*"
+- `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
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Missing contract layers.
+
+## Notes
+
+- Works alongside `@contractspec/lib.contracts-spec`, `@contractspec/lib.design-system`, `@contractspec/lib.example-shared-ui`, `@contractspec/lib.identity-rbac`, `@contractspec/lib.runtime-sandbox`, ...

package/dist/browser/events/contact.event.js

@@ -1,6 +1,6 @@
 // src/events/contact.event.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 import { defineEvent } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var ContactCreatedPayload = defineSchemaModel({
   name: "ContactCreatedPayload",
   description: "Payload when a contact is created",

package/dist/browser/events/deal.event.js

@@ -1,6 +1,6 @@
 // src/events/deal.event.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 import { defineEvent } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var DealCreatedPayload = defineSchemaModel({
   name: "DealCreatedPayload",
   description: "Payload when a deal is created",

package/dist/browser/events/index.js

@@ -1,6 +1,6 @@
 // src/events/contact.event.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 import { defineEvent } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var ContactCreatedPayload = defineSchemaModel({
   name: "ContactCreatedPayload",
   description: "Payload when a contact is created",
@@ -28,8 +28,8 @@ var ContactCreatedEvent = defineEvent({
 });
 
 // src/events/deal.event.ts
-import { ScalarTypeEnum as ScalarTypeEnum2, defineSchemaModel as defineSchemaModel2 } from "@contractspec/lib.schema";
 import { defineEvent as defineEvent2 } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel as defineSchemaModel2, ScalarTypeEnum as ScalarTypeEnum2 } from "@contractspec/lib.schema";
 var DealCreatedPayload = defineSchemaModel2({
   name: "DealCreatedPayload",
   description: "Payload when a deal is created",
@@ -124,8 +124,8 @@ var DealLostEvent = defineEvent2({
 });
 
 // src/events/task.event.ts
-import { ScalarTypeEnum as ScalarTypeEnum3, defineSchemaModel as defineSchemaModel3 } from "@contractspec/lib.schema";
 import { defineEvent as defineEvent3 } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel as defineSchemaModel3, ScalarTypeEnum as ScalarTypeEnum3 } from "@contractspec/lib.schema";
 var TaskCompletedPayload = defineSchemaModel3({
   name: "TaskCompletedPayload",
   description: "Payload when a task is completed",

package/dist/browser/events/task.event.js

@@ -1,6 +1,6 @@
 // src/events/task.event.ts
-import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
 import { defineEvent } from "@contractspec/lib.contracts-spec";
+import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
 var TaskCompletedPayload = defineSchemaModel({
   name: "TaskCompletedPayload",
   description: "Payload when a task is completed",