@lssm/example.crm-pipeline 0.0.0-canary-20251210171026 → 0.0.0-canary-20251212004227

package/.turbo/turbo-build.log

@@ -2,26 +2,28 @@ $ bun build:bundle && bun build:types
 $ tsdown
 ℹ tsdown v0.17.0 powered by rolldown v1.0.0-beta.53
 ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/crm-pipeline/tsdown.config.js 
-ℹ entry: src/events.ts, src/feature.ts, src/index.ts, src/entities/company.ts, src/entities/contact.ts, src/entities/deal.ts, src/entities/index.ts, src/entities/task.ts, src/handlers/deal.handlers.ts, src/handlers/index.ts, src/handlers/mock-data.ts, src/contracts/deal.ts, src/contracts/index.ts, src/presentations/dashboard.ts, src/presentations/index.ts, src/presentations/pipeline.ts
+ℹ entry: src/events.ts, src/feature.ts, src/index.ts, src/contracts/deal.ts, src/contracts/index.ts, src/docs/crm-pipeline.docblock.ts, src/docs/index.ts, src/entities/company.ts, src/entities/contact.ts, src/entities/deal.ts, src/entities/index.ts, src/entities/task.ts, src/handlers/deal.handlers.ts, src/handlers/index.ts, src/handlers/mock-data.ts, src/presentations/dashboard.ts, src/presentations/index.ts, src/presentations/pipeline.ts
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/contracts/deal.js           5.38 kB │ gzip: 1.27 kB
-ℹ dist/index.js                    3.51 kB │ gzip: 1.08 kB
-ℹ dist/handlers/mock-data.js       3.36 kB │ gzip: 0.97 kB
-ℹ dist/events.js                   3.12 kB │ gzip: 0.69 kB
-ℹ dist/entities/deal.js            2.52 kB │ gzip: 0.87 kB
-ℹ dist/entities/task.js            2.35 kB │ gzip: 0.81 kB
-ℹ dist/handlers/deal.handlers.js   1.85 kB │ gzip: 0.78 kB
-ℹ dist/entities/contact.js         1.68 kB │ gzip: 0.70 kB
-ℹ dist/presentations/pipeline.js   1.48 kB │ gzip: 0.48 kB
-ℹ dist/feature.js                  1.41 kB │ gzip: 0.44 kB
-ℹ dist/entities/company.js         1.35 kB │ gzip: 0.59 kB
-ℹ dist/contracts/index.js          0.79 kB │ gzip: 0.26 kB
-ℹ dist/entities/index.js           0.77 kB │ gzip: 0.33 kB
-ℹ dist/presentations/dashboard.js  0.74 kB │ gzip: 0.33 kB
-ℹ dist/handlers/index.js           0.60 kB │ gzip: 0.25 kB
-ℹ dist/presentations/index.js      0.47 kB │ gzip: 0.19 kB
-ℹ 16 files, total: 31.36 kB
-✔ Build complete in 48ms
+ℹ dist/contracts/deal.js              5.38 kB │ gzip: 1.27 kB
+ℹ dist/index.js                       3.54 kB │ gzip: 1.08 kB
+ℹ dist/handlers/mock-data.js          3.36 kB │ gzip: 0.97 kB
+ℹ dist/docs/crm-pipeline.docblock.js  3.31 kB │ gzip: 1.36 kB
+ℹ dist/events.js                      3.12 kB │ gzip: 0.69 kB
+ℹ dist/entities/deal.js               2.52 kB │ gzip: 0.87 kB
+ℹ dist/entities/task.js               2.35 kB │ gzip: 0.81 kB
+ℹ dist/handlers/deal.handlers.js      1.85 kB │ gzip: 0.78 kB
+ℹ dist/entities/contact.js            1.68 kB │ gzip: 0.70 kB
+ℹ dist/presentations/pipeline.js      1.48 kB │ gzip: 0.48 kB
+ℹ dist/feature.js                     1.41 kB │ gzip: 0.44 kB
+ℹ dist/entities/company.js            1.35 kB │ gzip: 0.59 kB
+ℹ dist/contracts/index.js             0.79 kB │ gzip: 0.26 kB
+ℹ dist/entities/index.js              0.77 kB │ gzip: 0.33 kB
+ℹ dist/presentations/dashboard.js     0.74 kB │ gzip: 0.33 kB
+ℹ dist/handlers/index.js              0.60 kB │ gzip: 0.25 kB
+ℹ dist/presentations/index.js         0.47 kB │ gzip: 0.19 kB
+ℹ dist/docs/index.js                  0.04 kB │ gzip: 0.06 kB
+ℹ 18 files, total: 34.73 kB
+✔ Build complete in 39ms
 $ tsc --noEmit

package/CHANGELOG.md

@@ -1,15 +1,15 @@
 # @lssm/example.crm-pipeline
 
-## 0.0.0-canary-20251210171026
+## 0.0.0-canary-20251212004227
 
 ### Patch Changes
 
 - 3086383: refactor: dependencies upgrade
 - Updated dependencies [3086383]
-  - @lssm/lib.contracts@0.0.0-canary-20251210171026
-  - @lssm/lib.schema@0.0.0-canary-20251210171026
-  - @lssm/lib.jobs@0.0.0-canary-20251210171026
-  - @lssm/lib.bus@0.0.0-canary-20251210171026
-  - @lssm/lib.identity-rbac@0.0.0-canary-20251210171026
-  - @lssm/module.audit-trail@0.0.0-canary-20251210171026
-  - @lssm/module.notifications@0.0.0-canary-20251210171026
+  - @lssm/lib.contracts@0.0.0-canary-20251212004227
+  - @lssm/lib.schema@0.0.0-canary-20251212004227
+  - @lssm/lib.jobs@0.0.0-canary-20251212004227
+  - @lssm/lib.bus@0.0.0-canary-20251212004227
+  - @lssm/lib.identity-rbac@0.0.0-canary-20251212004227
+  - @lssm/module.audit-trail@0.0.0-canary-20251212004227
+  - @lssm/module.notifications@0.0.0-canary-20251212004227

package/dist/docs/crm-pipeline.docblock.js

@@ -0,0 +1,49 @@
+import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.examples.crm-pipeline.goal`,title:`CRM Pipeline — Goal`,summary:`Deals, stages, contacts, companies, and tasks with auditable stage movement.`,kind:`goal`,visibility:`public`,route:`/docs/examples/crm-pipeline/goal`,tags:[`crm`,`goal`],body:`## Why it matters
+- Regenerable CRM flow for deals/stages without code drift.
+- Ensures stage movement, tasks, and contacts stay aligned across surfaces.
+
+## Business/Product goal
+- Give sales teams a governed pipeline with auditable moves and notifications.
+- Allow experimentation (feature flags) on stage definitions and task flows.
+
+## Success criteria
+- Stage/state changes emit events and remain declarative in spec.
+- PII (contacts) is scoped/redacted in presentations.`},{id:`docs.examples.crm-pipeline.usage`,title:`CRM Pipeline — Usage`,summary:`How to seed, extend, and regenerate the CRM pipeline.`,kind:`usage`,visibility:`public`,route:`/docs/examples/crm-pipeline/usage`,tags:[`crm`,`usage`],body:`## Setup
+1) Seed (if available) or create pipeline stages, deals, contacts, companies, tasks.
+2) Configure Notifications for stage changes/tasks; set policy.pii for contact data.
+
+## Extend & regenerate
+1) Adjust stage schema/order, deal fields, task fields in the spec.
+2) Regenerate to sync UI/API/events; ensure kanban/action buttons update.
+3) Use Feature Flags to trial new stages or SLA rules.
+
+## Guardrails
+- Emit events for stage moves and task completions; log to Audit Trail.
+- Keep required fields enforced in contracts; avoid freeform state.
+- Redact contact PII in markdown/JSON outputs.`},{id:`docs.examples.crm-pipeline.reference`,title:`CRM Pipeline — Reference`,summary:`Entities, contracts, events, and presentations for the CRM template.`,kind:`reference`,visibility:`public`,route:`/docs/examples/crm-pipeline`,tags:[`crm`,`reference`],body:`## Entities
+- Contact, Company, Deal, Pipeline, Stage, Task.
+
+## Contracts
+- deal/create, stage/move, contact/company CRUD, task create/complete.
+
+## Events
+- deal.created, stage.moved, task.completed, contact.updated.
+
+## Presentations
+- Pipelines/kanban, deal detail, contact/company profiles, task lists.
+
+## Notes
+- Stage definitions should be declarative; enforce via spec and regeneration.
+- Use Notifications for deal/task updates; Audit Trail for state changes.`},{id:`docs.examples.crm-pipeline.constraints`,title:`CRM Pipeline — Constraints & Safety`,summary:`Internal guardrails for stages, PII, and regeneration semantics in the CRM template.`,kind:`reference`,visibility:`internal`,route:`/docs/examples/crm-pipeline/constraints`,tags:[`crm`,`constraints`,`internal`],body:`## Constraints
+- Stage definitions/order must remain declarative; no imperative overrides in code.
+- Events to emit: deal.created, stage.moved, task.completed, contact.updated (minimum).
+- Regeneration should not alter stage semantics without explicit spec change.
+
+## PII
+- Mark contact/company PII (emails, phones) for redaction in presentations.
+- Ensure MCP/web outputs avoid raw PII when not needed.
+
+## Verification
+- Add fixtures for stage move rules and SLA/task changes.
+- Ensure Audit/Notifications remain wired for stage and task events.
+- Use Feature Flags for experimental stages/SLAs; default safe/off.`}]);

package/dist/docs/index.js

@@ -0,0 +1 @@
+import"./crm-pipeline.docblock.js";

package/dist/index.js

@@ -1 +1 @@
-import{ContactCreatedEvent as e,CrmPipelineEvents as t,DealCreatedEvent as n,DealLostEvent as r,DealMovedEvent as i,DealWonEvent as a,TaskCompletedEvent as o}from"./events.js";import{CrmPipelineFeature as s}from"./feature.js";import{ContactEntity as c,ContactStatusEnum as l}from"./entities/contact.js";import{CompanyEntity as u,CompanySizeEnum as d}from"./entities/company.js";import{DealEntity as f,DealStatusEnum as p,PipelineEntity as m,StageEntity as h}from"./entities/deal.js";import{ActivityEntity as g,TaskEntity as _,TaskPriorityEnum as v,TaskStatusEnum as y,TaskTypeEnum as b}from"./entities/task.js";import{crmPipelineEntities as x,crmPipelineSchemaContribution as S}from"./entities/index.js";import{CreateDealContract as C,CreateDealInputModel as w,DealLostPayloadModel as T,DealModel as E,DealMovedPayloadModel as D,DealStatusFilterEnum as O,DealWonPayloadModel as k,ListDealsContract as ee,ListDealsInputModel as A,ListDealsOutputModel as j,LoseDealContract as M,LoseDealInputModel as N,MoveDealContract as P,MoveDealInputModel as F,WinDealContract as I,WinDealInputModel as L}from"./contracts/deal.js";import"./contracts/index.js";import{MOCK_COMPANIES as R,MOCK_CONTACTS as z,MOCK_DEALS as B,MOCK_STAGES as V}from"./handlers/mock-data.js";import{mockCreateDealHandler as H,mockGetDealsByStageHandler as U,mockGetPipelineStagesHandler as W,mockListDealsHandler as G,mockLoseDealHandler as K,mockMoveDealHandler as q,mockWinDealHandler as J}from"./handlers/deal.handlers.js";import{DealCardPresentation as Y,DealDetailPresentation as X,DealListPresentation as Z,PipelineKanbanPresentation as Q}from"./presentations/pipeline.js";import{CrmDashboardPresentation as $,PipelineMetricsPresentation as te}from"./presentations/dashboard.js";import{CrmPipelinePresentations as ne}from"./presentations/index.js";import{identityRbacSchemaContribution as re}from"@lssm/lib.identity-rbac";import{auditTrailSchemaContribution as ie}from"@lssm/module.audit-trail";import{notificationsSchemaContribution as ae}from"@lssm/module.notifications";const oe={modules:[re,ie,ae,S],provider:`postgresql`,outputPath:`./prisma/schema/generated.prisma`};export{g as ActivityEntity,u as CompanyEntity,d as CompanySizeEnum,e as ContactCreatedEvent,c as ContactEntity,l as ContactStatusEnum,C as CreateDealContract,w as CreateDealInputModel,$ as CrmDashboardPresentation,t as CrmPipelineEvents,s as CrmPipelineFeature,ne as CrmPipelinePresentations,Y as DealCardPresentation,n as DealCreatedEvent,X as DealDetailPresentation,f as DealEntity,Z as DealListPresentation,r as DealLostEvent,T as DealLostPayloadModel,E as DealModel,i as DealMovedEvent,D as DealMovedPayloadModel,p as DealStatusEnum,O as DealStatusFilterEnum,a as DealWonEvent,k as DealWonPayloadModel,ee as ListDealsContract,A as ListDealsInputModel,j as ListDealsOutputModel,M as LoseDealContract,N as LoseDealInputModel,R as MOCK_COMPANIES,z as MOCK_CONTACTS,B as MOCK_DEALS,V as MOCK_STAGES,P as MoveDealContract,F as MoveDealInputModel,m as PipelineEntity,Q as PipelineKanbanPresentation,te as PipelineMetricsPresentation,h as StageEntity,o as TaskCompletedEvent,_ as TaskEntity,v as TaskPriorityEnum,y as TaskStatusEnum,b as TaskTypeEnum,I as WinDealContract,L as WinDealInputModel,x as crmPipelineEntities,S as crmPipelineSchemaContribution,H as mockCreateDealHandler,U as mockGetDealsByStageHandler,W as mockGetPipelineStagesHandler,G as mockListDealsHandler,K as mockLoseDealHandler,q as mockMoveDealHandler,J as mockWinDealHandler,oe as schemaComposition};
+import{ContactCreatedEvent as e,CrmPipelineEvents as t,DealCreatedEvent as n,DealLostEvent as r,DealMovedEvent as i,DealWonEvent as a,TaskCompletedEvent as o}from"./events.js";import{CrmPipelineFeature as s}from"./feature.js";import{ContactEntity as c,ContactStatusEnum as l}from"./entities/contact.js";import{CompanyEntity as u,CompanySizeEnum as d}from"./entities/company.js";import{DealEntity as f,DealStatusEnum as p,PipelineEntity as m,StageEntity as h}from"./entities/deal.js";import{ActivityEntity as g,TaskEntity as _,TaskPriorityEnum as v,TaskStatusEnum as y,TaskTypeEnum as b}from"./entities/task.js";import{crmPipelineEntities as x,crmPipelineSchemaContribution as S}from"./entities/index.js";import{CreateDealContract as C,CreateDealInputModel as w,DealLostPayloadModel as T,DealModel as E,DealMovedPayloadModel as D,DealStatusFilterEnum as O,DealWonPayloadModel as k,ListDealsContract as ee,ListDealsInputModel as A,ListDealsOutputModel as j,LoseDealContract as M,LoseDealInputModel as N,MoveDealContract as P,MoveDealInputModel as F,WinDealContract as I,WinDealInputModel as L}from"./contracts/deal.js";import"./contracts/index.js";import{MOCK_COMPANIES as R,MOCK_CONTACTS as z,MOCK_DEALS as B,MOCK_STAGES as V}from"./handlers/mock-data.js";import{mockCreateDealHandler as H,mockGetDealsByStageHandler as U,mockGetPipelineStagesHandler as W,mockListDealsHandler as G,mockLoseDealHandler as K,mockMoveDealHandler as q,mockWinDealHandler as J}from"./handlers/deal.handlers.js";import{DealCardPresentation as Y,DealDetailPresentation as X,DealListPresentation as Z,PipelineKanbanPresentation as Q}from"./presentations/pipeline.js";import{CrmDashboardPresentation as $,PipelineMetricsPresentation as te}from"./presentations/dashboard.js";import{CrmPipelinePresentations as ne}from"./presentations/index.js";import"./docs/index.js";import{identityRbacSchemaContribution as re}from"@lssm/lib.identity-rbac";import{auditTrailSchemaContribution as ie}from"@lssm/module.audit-trail";import{notificationsSchemaContribution as ae}from"@lssm/module.notifications";const oe={modules:[re,ie,ae,S],provider:`postgresql`,outputPath:`./prisma/schema/generated.prisma`};export{g as ActivityEntity,u as CompanyEntity,d as CompanySizeEnum,e as ContactCreatedEvent,c as ContactEntity,l as ContactStatusEnum,C as CreateDealContract,w as CreateDealInputModel,$ as CrmDashboardPresentation,t as CrmPipelineEvents,s as CrmPipelineFeature,ne as CrmPipelinePresentations,Y as DealCardPresentation,n as DealCreatedEvent,X as DealDetailPresentation,f as DealEntity,Z as DealListPresentation,r as DealLostEvent,T as DealLostPayloadModel,E as DealModel,i as DealMovedEvent,D as DealMovedPayloadModel,p as DealStatusEnum,O as DealStatusFilterEnum,a as DealWonEvent,k as DealWonPayloadModel,ee as ListDealsContract,A as ListDealsInputModel,j as ListDealsOutputModel,M as LoseDealContract,N as LoseDealInputModel,R as MOCK_COMPANIES,z as MOCK_CONTACTS,B as MOCK_DEALS,V as MOCK_STAGES,P as MoveDealContract,F as MoveDealInputModel,m as PipelineEntity,Q as PipelineKanbanPresentation,te as PipelineMetricsPresentation,h as StageEntity,o as TaskCompletedEvent,_ as TaskEntity,v as TaskPriorityEnum,y as TaskStatusEnum,b as TaskTypeEnum,I as WinDealContract,L as WinDealInputModel,x as crmPipelineEntities,S as crmPipelineSchemaContribution,H as mockCreateDealHandler,U as mockGetDealsByStageHandler,W as mockGetPipelineStagesHandler,G as mockListDealsHandler,K as mockLoseDealHandler,q as mockMoveDealHandler,J as mockWinDealHandler,oe as schemaComposition};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.crm-pipeline",
-  "version": "0.0.0-canary-20251210171026",
+  "version": "0.0.0-canary-20251212004227",
   "description": "CRM Pipeline - Contacts, Companies, Deals, Tasks",
   "type": "module",
   "main": "./dist/index.js",
@@ -9,6 +9,8 @@
     ".": "./src/index.ts",
     "./contracts": "./src/contracts/index.ts",
     "./contracts/deal": "./src/contracts/deal.ts",
+    "./docs": "./src/docs/index.ts",
+    "./docs/crm-pipeline.docblock": "./src/docs/crm-pipeline.docblock.ts",
     "./entities": "./src/entities/index.ts",
     "./entities/company": "./src/entities/company.ts",
     "./entities/contact": "./src/entities/contact.ts",
@@ -57,6 +59,8 @@
       ".": "./dist/index.js",
       "./contracts": "./dist/contracts/index.js",
       "./contracts/deal": "./dist/contracts/deal.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/crm-pipeline.docblock": "./dist/docs/crm-pipeline.docblock.js",
       "./entities": "./dist/entities/index.js",
       "./entities/company": "./dist/entities/company.js",
       "./entities/contact": "./dist/entities/contact.js",

package/src/docs/crm-pipeline.docblock.ts

@@ -0,0 +1,98 @@
+import type { DocBlock } from '@lssm/lib.contracts/docs';
+import { registerDocBlocks } from '@lssm/lib.contracts/docs';
+
+const crmPipelineDocBlocks: DocBlock[] = [
+  {
+    id: 'docs.examples.crm-pipeline.goal',
+    title: 'CRM Pipeline — Goal',
+    summary:
+      'Deals, stages, contacts, companies, and tasks with auditable stage movement.',
+    kind: 'goal',
+    visibility: 'public',
+    route: '/docs/examples/crm-pipeline/goal',
+    tags: ['crm', 'goal'],
+    body: `## Why it matters
+- Regenerable CRM flow for deals/stages without code drift.
+- Ensures stage movement, tasks, and contacts stay aligned across surfaces.
+
+## Business/Product goal
+- Give sales teams a governed pipeline with auditable moves and notifications.
+- Allow experimentation (feature flags) on stage definitions and task flows.
+
+## Success criteria
+- Stage/state changes emit events and remain declarative in spec.
+- PII (contacts) is scoped/redacted in presentations.`,
+  },
+  {
+    id: 'docs.examples.crm-pipeline.usage',
+    title: 'CRM Pipeline — Usage',
+    summary: 'How to seed, extend, and regenerate the CRM pipeline.',
+    kind: 'usage',
+    visibility: 'public',
+    route: '/docs/examples/crm-pipeline/usage',
+    tags: ['crm', 'usage'],
+    body: `## Setup
+1) Seed (if available) or create pipeline stages, deals, contacts, companies, tasks.
+2) Configure Notifications for stage changes/tasks; set policy.pii for contact data.
+
+## Extend & regenerate
+1) Adjust stage schema/order, deal fields, task fields in the spec.
+2) Regenerate to sync UI/API/events; ensure kanban/action buttons update.
+3) Use Feature Flags to trial new stages or SLA rules.
+
+## Guardrails
+- Emit events for stage moves and task completions; log to Audit Trail.
+- Keep required fields enforced in contracts; avoid freeform state.
+- Redact contact PII in markdown/JSON outputs.`,
+  },
+  {
+    id: 'docs.examples.crm-pipeline.reference',
+    title: 'CRM Pipeline — Reference',
+    summary:
+      'Entities, contracts, events, and presentations for the CRM template.',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/examples/crm-pipeline',
+    tags: ['crm', 'reference'],
+    body: `## Entities
+- Contact, Company, Deal, Pipeline, Stage, Task.
+
+## Contracts
+- deal/create, stage/move, contact/company CRUD, task create/complete.
+
+## Events
+- deal.created, stage.moved, task.completed, contact.updated.
+
+## Presentations
+- Pipelines/kanban, deal detail, contact/company profiles, task lists.
+
+## Notes
+- Stage definitions should be declarative; enforce via spec and regeneration.
+- Use Notifications for deal/task updates; Audit Trail for state changes.`,
+  },
+  {
+    id: 'docs.examples.crm-pipeline.constraints',
+    title: 'CRM Pipeline — Constraints & Safety',
+    summary:
+      'Internal guardrails for stages, PII, and regeneration semantics in the CRM template.',
+    kind: 'reference',
+    visibility: 'internal',
+    route: '/docs/examples/crm-pipeline/constraints',
+    tags: ['crm', 'constraints', 'internal'],
+    body: `## Constraints
+- Stage definitions/order must remain declarative; no imperative overrides in code.
+- Events to emit: deal.created, stage.moved, task.completed, contact.updated (minimum).
+- Regeneration should not alter stage semantics without explicit spec change.
+
+## PII
+- Mark contact/company PII (emails, phones) for redaction in presentations.
+- Ensure MCP/web outputs avoid raw PII when not needed.
+
+## Verification
+- Add fixtures for stage move rules and SLA/task changes.
+- Ensure Audit/Notifications remain wired for stage and task events.
+- Use Feature Flags for experimental stages/SLAs; default safe/off.`,
+  },
+];
+
+registerDocBlocks(crmPipelineDocBlocks);

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './crm-pipeline.docblock';

package/src/index.ts

@@ -7,6 +7,7 @@ export * from './events';
 export * from './handlers';
 export * from './presentations';
 export * from './feature';
+import './docs';
 
 // Schema composition configuration
 import { identityRbacSchemaContribution } from '@lssm/lib.identity-rbac';