@lssm/example.saas-boilerplate 0.0.0-canary-20251210171026 → 0.0.0-canary-20251212004227

package/.turbo/turbo-build.log

@@ -2,28 +2,30 @@ $ 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/saas-boilerplate/tsdown.config.js 
-ℹ entry: src/events.ts, src/feature.ts, src/index.ts, src/contracts/billing.ts, src/contracts/index.ts, src/contracts/project.ts, src/handlers/billing.handlers.ts, src/handlers/index.ts, src/handlers/mock-data.ts, src/handlers/project.handlers.ts, src/entities/billing.ts, src/entities/index.ts, src/entities/project.ts, src/entities/settings.ts, src/presentations/billing.ts, src/presentations/dashboard.ts, src/presentations/index.ts, src/presentations/project-list.ts
+ℹ entry: src/events.ts, src/feature.ts, src/index.ts, src/contracts/billing.ts, src/contracts/index.ts, src/contracts/project.ts, src/docs/index.ts, src/docs/saas-boilerplate.docblock.ts, src/entities/billing.ts, src/entities/index.ts, src/entities/project.ts, src/entities/settings.ts, src/handlers/billing.handlers.ts, src/handlers/index.ts, src/handlers/mock-data.ts, src/handlers/project.handlers.ts, src/presentations/billing.ts, src/presentations/dashboard.ts, src/presentations/index.ts, src/presentations/project-list.ts
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/contracts/project.js           5.13 kB │ gzip: 1.37 kB
-ℹ dist/index.js                       4.98 kB │ gzip: 1.30 kB
-ℹ dist/contracts/billing.js           4.43 kB │ gzip: 1.25 kB
-ℹ dist/events.js                      3.50 kB │ gzip: 0.76 kB
-ℹ dist/entities/billing.js            2.57 kB │ gzip: 0.94 kB
-ℹ dist/handlers/mock-data.js          2.06 kB │ gzip: 0.78 kB
-ℹ dist/feature.js                     1.95 kB │ gzip: 0.52 kB
-ℹ dist/contracts/index.js             1.70 kB │ gzip: 0.44 kB
-ℹ dist/entities/project.js            1.64 kB │ gzip: 0.67 kB
-ℹ dist/entities/settings.js           1.60 kB │ gzip: 0.67 kB
-ℹ dist/handlers/project.handlers.js   1.43 kB │ gzip: 0.64 kB
-ℹ dist/entities/index.js              0.87 kB │ gzip: 0.36 kB
-ℹ dist/presentations/project-list.js  0.84 kB │ gzip: 0.38 kB
-ℹ dist/handlers/index.js              0.78 kB │ gzip: 0.30 kB
-ℹ dist/presentations/billing.js       0.77 kB │ gzip: 0.32 kB
-ℹ dist/handlers/billing.handlers.js   0.72 kB │ gzip: 0.41 kB
-ℹ dist/presentations/dashboard.js     0.71 kB │ gzip: 0.33 kB
-ℹ dist/presentations/index.js         0.52 kB │ gzip: 0.21 kB
-ℹ 18 files, total: 36.18 kB
-✔ Build complete in 56ms
+ℹ dist/contracts/project.js               5.13 kB │ gzip: 1.37 kB
+ℹ dist/index.js                           5.00 kB │ gzip: 1.31 kB
+ℹ dist/contracts/billing.js               4.43 kB │ gzip: 1.25 kB
+ℹ dist/events.js                          3.50 kB │ gzip: 0.76 kB
+ℹ dist/docs/saas-boilerplate.docblock.js  3.46 kB │ gzip: 1.38 kB
+ℹ dist/entities/billing.js                2.57 kB │ gzip: 0.94 kB
+ℹ dist/handlers/mock-data.js              2.06 kB │ gzip: 0.78 kB
+ℹ dist/feature.js                         1.95 kB │ gzip: 0.52 kB
+ℹ dist/contracts/index.js                 1.70 kB │ gzip: 0.44 kB
+ℹ dist/entities/project.js                1.64 kB │ gzip: 0.67 kB
+ℹ dist/entities/settings.js               1.60 kB │ gzip: 0.67 kB
+ℹ dist/handlers/project.handlers.js       1.43 kB │ gzip: 0.64 kB
+ℹ dist/entities/index.js                  0.87 kB │ gzip: 0.36 kB
+ℹ dist/presentations/project-list.js      0.84 kB │ gzip: 0.38 kB
+ℹ dist/handlers/index.js                  0.78 kB │ gzip: 0.30 kB
+ℹ dist/presentations/billing.js           0.77 kB │ gzip: 0.32 kB
+ℹ dist/handlers/billing.handlers.js       0.72 kB │ gzip: 0.41 kB
+ℹ dist/presentations/dashboard.js         0.71 kB │ gzip: 0.33 kB
+ℹ dist/presentations/index.js             0.52 kB │ gzip: 0.21 kB
+ℹ dist/docs/index.js                      0.04 kB │ gzip: 0.06 kB
+ℹ 20 files, total: 39.71 kB
+✔ Build complete in 65ms
 $ tsc --noEmit

package/CHANGELOG.md

@@ -1,15 +1,15 @@
 # @lssm/example.saas-boilerplate
 
-## 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/index.js

@@ -0,0 +1 @@
+import"./saas-boilerplate.docblock.js";

package/dist/docs/saas-boilerplate.docblock.js

@@ -0,0 +1,49 @@
+import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.examples.saas-boilerplate.goal`,title:`SaaS Boilerplate — Goal`,summary:`Multi-tenant SaaS foundation with orgs, members, projects, settings, and usage.`,kind:`goal`,visibility:`public`,route:`/docs/examples/saas-boilerplate/goal`,tags:[`saas`,`goal`],body:`## Why it matters
+- Provides a regenerable SaaS base: orgs, members, projects, settings, usage/billing.
+- Avoids drift across identity, settings, and usage capture.
+
+## Business/Product goal
+- Ship SaaS faster with tenant isolation, RBAC, and usage metering baked in.
+- Keep audit/notifications ready for compliance and customer comms.
+
+## Success criteria
+- Spec changes to org/project/settings/usage regenerate UI/API/events cleanly.
+- Tenant isolation and RBAC stay enforced; usage data is captured with PII scopes.`},{id:`docs.examples.saas-boilerplate.usage`,title:`SaaS Boilerplate — Usage`,summary:`How to seed, extend, and regenerate the SaaS base.`,kind:`usage`,visibility:`public`,route:`/docs/examples/saas-boilerplate/usage`,tags:[`saas`,`usage`],body:`## Setup
+1) Seed (if available) or create orgs, members, and projects via UI.
+2) Configure Notifications for invites and project events; set policy.pii for sensitive fields.
+
+## Extend & regenerate
+1) Adjust schemas (project metadata, settings, usage records) in spec.
+2) Regenerate to sync UI/API/events and usage metering.
+3) Use Feature Flags to roll out new settings or billing fields gradually.
+
+## Guardrails
+- Keep tenant/role context explicit in contracts and presentations.
+- Emit events for invites, project changes, and usage records; log in Audit Trail.
+- Redact sensitive user/org data in markdown/JSON outputs.`},{id:`docs.examples.saas-boilerplate.reference`,title:`SaaS Boilerplate — Reference`,summary:`Entities, contracts, events, and presentations for the SaaS starter.`,kind:`reference`,visibility:`public`,route:`/docs/examples/saas-boilerplate`,tags:[`saas`,`reference`],body:`## Entities
+- Organization, Member, Role, Project, AppSettings, UserSettings, BillingUsage.
+
+## Contracts
+- org/project CRUD, invites, role assignment, usage recording.
+
+## Events
+- org.created, member.invited/accepted, project.created/updated, usage.recorded.
+
+## Presentations
+- Org/project dashboards, member management, settings screens, usage views.
+
+## Notes
+- Tenant isolation is mandatory; enforce via RBAC/policies.
+- Usage/Metering drives billing/limits; keep units explicit.`},{id:`docs.examples.saas-boilerplate.constraints`,title:`SaaS Boilerplate — Constraints & Safety`,summary:`Internal guardrails for tenancy, RBAC, usage metering, and regeneration.`,kind:`reference`,visibility:`internal`,route:`/docs/examples/saas-boilerplate/constraints`,tags:[`saas`,`constraints`,`internal`],body:`## Constraints
+- Tenant isolation and RBAC must remain explicit in spec; no implicit defaults in code.
+- Events to emit: org.created, member.invited/accepted, project.created/updated, usage.recorded.
+- Regeneration must not change billing/usage semantics without spec diffs.
+
+## PII & Settings
+- Mark PII (user emails, names) for redaction; keep settings scoped to org/member.
+- Avoid leaking secrets/config in markdown/JSON presentations.
+
+## Verification
+- Add fixtures for usage recording and role changes.
+- Ensure Audit/Notifications remain wired for invites/project updates.
+- Use Feature Flags for new settings/billing fields; default safe/off.`}]);

package/dist/index.js

@@ -1 +1 @@
-import{ProjectArchivedEvent as e,ProjectCreatedEvent as t,ProjectDeletedEvent as n,ProjectUpdatedEvent as r,SaasBoilerplateEvents as i,SubscriptionChangedEvent as a,UsageLimitReachedEvent as o,UsageRecordedEvent as s}from"./events.js";import{SaasBoilerplateFeature as c}from"./feature.js";import{ProjectEntity as l,ProjectMemberEntity as u,ProjectStatusEnum as d}from"./entities/project.js";import{FeatureFlagEntity as f,SettingsEntity as p,SettingsScopeEnum as m}from"./entities/settings.js";import{BillingUsageEntity as h,SubscriptionEntity as g,SubscriptionStatusEnum as _,UsageLimitEntity as v}from"./entities/billing.js";import{identityRbacEntities as y,identityRbacSchemaContribution as b,saasBoilerplateEntities as x,saasBoilerplateSchemaContribution as S}from"./entities/index.js";import{CreateProjectContract as C,CreateProjectInputModel as w,DeleteProjectContract as T,DeleteProjectInputModel as E,DeleteProjectOutputModel as D,GetProjectContract as O,GetProjectInputModel as k,ListProjectsContract as A,ListProjectsInputModel as j,ListProjectsOutputModel as M,ProjectDeletedPayloadModel as N,ProjectModel as P,ProjectStatusFilterEnum as F,UpdateProjectContract as I,UpdateProjectInputModel as L}from"./contracts/project.js";import{CheckFeatureAccessContract as R,CheckFeatureAccessInputModel as z,CheckFeatureAccessOutputModel as B,FeatureAccessReasonEnum as V,GetSubscriptionContract as ee,GetUsageSummaryContract as H,GetUsageSummaryInputModel as U,GetUsageSummaryOutputModel as W,RecordUsageContract as G,RecordUsageInputModel as K,RecordUsageOutputModel as q,SubscriptionModel as J,UsageRecordedPayloadModel as Y,UsageSummaryModel as X}from"./contracts/billing.js";import"./contracts/index.js";import{MOCK_PROJECTS as Z,MOCK_SUBSCRIPTION as Q,MOCK_USAGE_SUMMARY as $}from"./handlers/mock-data.js";import{mockCreateProjectHandler as te,mockDeleteProjectHandler as ne,mockGetProjectHandler as re,mockListProjectsHandler as ie,mockUpdateProjectHandler as ae}from"./handlers/project.handlers.js";import{mockCheckFeatureAccessHandler as oe,mockGetSubscriptionHandler as se,mockGetUsageSummaryHandler as ce,mockRecordUsageHandler as le}from"./handlers/billing.handlers.js";import{ProjectDetailPresentation as ue,ProjectListPresentation as de}from"./presentations/project-list.js";import{SubscriptionPresentation as fe,UsageDashboardPresentation as pe}from"./presentations/billing.js";import{SaasDashboardPresentation as me,SettingsPanelPresentation as he}from"./presentations/dashboard.js";import{SaasBoilerplatePresentations as ge}from"./presentations/index.js";import{identityRbacSchemaContribution as _e}from"@lssm/lib.identity-rbac";import{jobsSchemaContribution as ve}from"@lssm/lib.jobs";import{auditTrailSchemaContribution as ye}from"@lssm/module.audit-trail";import{notificationsSchemaContribution as be}from"@lssm/module.notifications";const xe={modules:[_e,ve,ye,be,S],provider:`postgresql`,outputPath:`./prisma/schema/generated.prisma`};export{h as BillingUsageEntity,R as CheckFeatureAccessContract,z as CheckFeatureAccessInputModel,B as CheckFeatureAccessOutputModel,C as CreateProjectContract,w as CreateProjectInputModel,T as DeleteProjectContract,E as DeleteProjectInputModel,D as DeleteProjectOutputModel,V as FeatureAccessReasonEnum,f as FeatureFlagEntity,O as GetProjectContract,k as GetProjectInputModel,ee as GetSubscriptionContract,H as GetUsageSummaryContract,U as GetUsageSummaryInputModel,W as GetUsageSummaryOutputModel,A as ListProjectsContract,j as ListProjectsInputModel,M as ListProjectsOutputModel,Z as MOCK_PROJECTS,Q as MOCK_SUBSCRIPTION,$ as MOCK_USAGE_SUMMARY,e as ProjectArchivedEvent,t as ProjectCreatedEvent,n as ProjectDeletedEvent,N as ProjectDeletedPayloadModel,ue as ProjectDetailPresentation,l as ProjectEntity,de as ProjectListPresentation,u as ProjectMemberEntity,P as ProjectModel,d as ProjectStatusEnum,F as ProjectStatusFilterEnum,r as ProjectUpdatedEvent,G as RecordUsageContract,K as RecordUsageInputModel,q as RecordUsageOutputModel,i as SaasBoilerplateEvents,c as SaasBoilerplateFeature,ge as SaasBoilerplatePresentations,me as SaasDashboardPresentation,p as SettingsEntity,he as SettingsPanelPresentation,m as SettingsScopeEnum,a as SubscriptionChangedEvent,g as SubscriptionEntity,J as SubscriptionModel,fe as SubscriptionPresentation,_ as SubscriptionStatusEnum,I as UpdateProjectContract,L as UpdateProjectInputModel,pe as UsageDashboardPresentation,v as UsageLimitEntity,o as UsageLimitReachedEvent,s as UsageRecordedEvent,Y as UsageRecordedPayloadModel,X as UsageSummaryModel,y as identityRbacEntities,b as identityRbacSchemaContribution,oe as mockCheckFeatureAccessHandler,te as mockCreateProjectHandler,ne as mockDeleteProjectHandler,re as mockGetProjectHandler,se as mockGetSubscriptionHandler,ce as mockGetUsageSummaryHandler,ie as mockListProjectsHandler,le as mockRecordUsageHandler,ae as mockUpdateProjectHandler,x as saasBoilerplateEntities,S as saasBoilerplateSchemaContribution,xe as schemaComposition};
+import{ProjectArchivedEvent as e,ProjectCreatedEvent as t,ProjectDeletedEvent as n,ProjectUpdatedEvent as r,SaasBoilerplateEvents as i,SubscriptionChangedEvent as a,UsageLimitReachedEvent as o,UsageRecordedEvent as s}from"./events.js";import{SaasBoilerplateFeature as c}from"./feature.js";import{ProjectEntity as l,ProjectMemberEntity as u,ProjectStatusEnum as d}from"./entities/project.js";import{FeatureFlagEntity as f,SettingsEntity as p,SettingsScopeEnum as m}from"./entities/settings.js";import{BillingUsageEntity as h,SubscriptionEntity as g,SubscriptionStatusEnum as _,UsageLimitEntity as v}from"./entities/billing.js";import{identityRbacEntities as y,identityRbacSchemaContribution as b,saasBoilerplateEntities as x,saasBoilerplateSchemaContribution as S}from"./entities/index.js";import{CreateProjectContract as C,CreateProjectInputModel as w,DeleteProjectContract as T,DeleteProjectInputModel as E,DeleteProjectOutputModel as D,GetProjectContract as O,GetProjectInputModel as k,ListProjectsContract as A,ListProjectsInputModel as j,ListProjectsOutputModel as M,ProjectDeletedPayloadModel as N,ProjectModel as P,ProjectStatusFilterEnum as F,UpdateProjectContract as I,UpdateProjectInputModel as L}from"./contracts/project.js";import{CheckFeatureAccessContract as R,CheckFeatureAccessInputModel as z,CheckFeatureAccessOutputModel as B,FeatureAccessReasonEnum as V,GetSubscriptionContract as ee,GetUsageSummaryContract as H,GetUsageSummaryInputModel as U,GetUsageSummaryOutputModel as W,RecordUsageContract as G,RecordUsageInputModel as K,RecordUsageOutputModel as q,SubscriptionModel as J,UsageRecordedPayloadModel as Y,UsageSummaryModel as X}from"./contracts/billing.js";import"./contracts/index.js";import{MOCK_PROJECTS as Z,MOCK_SUBSCRIPTION as Q,MOCK_USAGE_SUMMARY as $}from"./handlers/mock-data.js";import{mockCreateProjectHandler as te,mockDeleteProjectHandler as ne,mockGetProjectHandler as re,mockListProjectsHandler as ie,mockUpdateProjectHandler as ae}from"./handlers/project.handlers.js";import{mockCheckFeatureAccessHandler as oe,mockGetSubscriptionHandler as se,mockGetUsageSummaryHandler as ce,mockRecordUsageHandler as le}from"./handlers/billing.handlers.js";import{ProjectDetailPresentation as ue,ProjectListPresentation as de}from"./presentations/project-list.js";import{SubscriptionPresentation as fe,UsageDashboardPresentation as pe}from"./presentations/billing.js";import{SaasDashboardPresentation as me,SettingsPanelPresentation as he}from"./presentations/dashboard.js";import{SaasBoilerplatePresentations as ge}from"./presentations/index.js";import"./docs/index.js";import{identityRbacSchemaContribution as _e}from"@lssm/lib.identity-rbac";import{jobsSchemaContribution as ve}from"@lssm/lib.jobs";import{auditTrailSchemaContribution as ye}from"@lssm/module.audit-trail";import{notificationsSchemaContribution as be}from"@lssm/module.notifications";const xe={modules:[_e,ve,ye,be,S],provider:`postgresql`,outputPath:`./prisma/schema/generated.prisma`};export{h as BillingUsageEntity,R as CheckFeatureAccessContract,z as CheckFeatureAccessInputModel,B as CheckFeatureAccessOutputModel,C as CreateProjectContract,w as CreateProjectInputModel,T as DeleteProjectContract,E as DeleteProjectInputModel,D as DeleteProjectOutputModel,V as FeatureAccessReasonEnum,f as FeatureFlagEntity,O as GetProjectContract,k as GetProjectInputModel,ee as GetSubscriptionContract,H as GetUsageSummaryContract,U as GetUsageSummaryInputModel,W as GetUsageSummaryOutputModel,A as ListProjectsContract,j as ListProjectsInputModel,M as ListProjectsOutputModel,Z as MOCK_PROJECTS,Q as MOCK_SUBSCRIPTION,$ as MOCK_USAGE_SUMMARY,e as ProjectArchivedEvent,t as ProjectCreatedEvent,n as ProjectDeletedEvent,N as ProjectDeletedPayloadModel,ue as ProjectDetailPresentation,l as ProjectEntity,de as ProjectListPresentation,u as ProjectMemberEntity,P as ProjectModel,d as ProjectStatusEnum,F as ProjectStatusFilterEnum,r as ProjectUpdatedEvent,G as RecordUsageContract,K as RecordUsageInputModel,q as RecordUsageOutputModel,i as SaasBoilerplateEvents,c as SaasBoilerplateFeature,ge as SaasBoilerplatePresentations,me as SaasDashboardPresentation,p as SettingsEntity,he as SettingsPanelPresentation,m as SettingsScopeEnum,a as SubscriptionChangedEvent,g as SubscriptionEntity,J as SubscriptionModel,fe as SubscriptionPresentation,_ as SubscriptionStatusEnum,I as UpdateProjectContract,L as UpdateProjectInputModel,pe as UsageDashboardPresentation,v as UsageLimitEntity,o as UsageLimitReachedEvent,s as UsageRecordedEvent,Y as UsageRecordedPayloadModel,X as UsageSummaryModel,y as identityRbacEntities,b as identityRbacSchemaContribution,oe as mockCheckFeatureAccessHandler,te as mockCreateProjectHandler,ne as mockDeleteProjectHandler,re as mockGetProjectHandler,se as mockGetSubscriptionHandler,ce as mockGetUsageSummaryHandler,ie as mockListProjectsHandler,le as mockRecordUsageHandler,ae as mockUpdateProjectHandler,x as saasBoilerplateEntities,S as saasBoilerplateSchemaContribution,xe as schemaComposition};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.saas-boilerplate",
-  "version": "0.0.0-canary-20251210171026",
+  "version": "0.0.0-canary-20251212004227",
   "description": "SaaS Boilerplate - Users, Orgs, Projects, Billing, Settings",
   "type": "module",
   "main": "./dist/index.js",
@@ -10,6 +10,8 @@
     "./contracts": "./src/contracts/index.ts",
     "./contracts/billing": "./src/contracts/billing.ts",
     "./contracts/project": "./src/contracts/project.ts",
+    "./docs": "./src/docs/index.ts",
+    "./docs/saas-boilerplate.docblock": "./src/docs/saas-boilerplate.docblock.ts",
     "./entities": "./src/entities/index.ts",
     "./entities/billing": "./src/entities/billing.ts",
     "./entities/project": "./src/entities/project.ts",
@@ -60,6 +62,8 @@
       "./contracts": "./dist/contracts/index.js",
       "./contracts/billing": "./dist/contracts/billing.js",
       "./contracts/project": "./dist/contracts/project.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/saas-boilerplate.docblock": "./dist/docs/saas-boilerplate.docblock.js",
       "./entities": "./dist/entities/index.js",
       "./entities/billing": "./dist/entities/billing.js",
       "./entities/project": "./dist/entities/project.js",

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './saas-boilerplate.docblock';

package/src/docs/saas-boilerplate.docblock.ts

@@ -0,0 +1,98 @@
+import type { DocBlock } from '@lssm/lib.contracts/docs';
+import { registerDocBlocks } from '@lssm/lib.contracts/docs';
+
+const saasBoilerplateDocBlocks: DocBlock[] = [
+  {
+    id: 'docs.examples.saas-boilerplate.goal',
+    title: 'SaaS Boilerplate — Goal',
+    summary:
+      'Multi-tenant SaaS foundation with orgs, members, projects, settings, and usage.',
+    kind: 'goal',
+    visibility: 'public',
+    route: '/docs/examples/saas-boilerplate/goal',
+    tags: ['saas', 'goal'],
+    body: `## Why it matters
+- Provides a regenerable SaaS base: orgs, members, projects, settings, usage/billing.
+- Avoids drift across identity, settings, and usage capture.
+
+## Business/Product goal
+- Ship SaaS faster with tenant isolation, RBAC, and usage metering baked in.
+- Keep audit/notifications ready for compliance and customer comms.
+
+## Success criteria
+- Spec changes to org/project/settings/usage regenerate UI/API/events cleanly.
+- Tenant isolation and RBAC stay enforced; usage data is captured with PII scopes.`,
+  },
+  {
+    id: 'docs.examples.saas-boilerplate.usage',
+    title: 'SaaS Boilerplate — Usage',
+    summary: 'How to seed, extend, and regenerate the SaaS base.',
+    kind: 'usage',
+    visibility: 'public',
+    route: '/docs/examples/saas-boilerplate/usage',
+    tags: ['saas', 'usage'],
+    body: `## Setup
+1) Seed (if available) or create orgs, members, and projects via UI.
+2) Configure Notifications for invites and project events; set policy.pii for sensitive fields.
+
+## Extend & regenerate
+1) Adjust schemas (project metadata, settings, usage records) in spec.
+2) Regenerate to sync UI/API/events and usage metering.
+3) Use Feature Flags to roll out new settings or billing fields gradually.
+
+## Guardrails
+- Keep tenant/role context explicit in contracts and presentations.
+- Emit events for invites, project changes, and usage records; log in Audit Trail.
+- Redact sensitive user/org data in markdown/JSON outputs.`,
+  },
+  {
+    id: 'docs.examples.saas-boilerplate.reference',
+    title: 'SaaS Boilerplate — Reference',
+    summary:
+      'Entities, contracts, events, and presentations for the SaaS starter.',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/examples/saas-boilerplate',
+    tags: ['saas', 'reference'],
+    body: `## Entities
+- Organization, Member, Role, Project, AppSettings, UserSettings, BillingUsage.
+
+## Contracts
+- org/project CRUD, invites, role assignment, usage recording.
+
+## Events
+- org.created, member.invited/accepted, project.created/updated, usage.recorded.
+
+## Presentations
+- Org/project dashboards, member management, settings screens, usage views.
+
+## Notes
+- Tenant isolation is mandatory; enforce via RBAC/policies.
+- Usage/Metering drives billing/limits; keep units explicit.`,
+  },
+  {
+    id: 'docs.examples.saas-boilerplate.constraints',
+    title: 'SaaS Boilerplate — Constraints & Safety',
+    summary:
+      'Internal guardrails for tenancy, RBAC, usage metering, and regeneration.',
+    kind: 'reference',
+    visibility: 'internal',
+    route: '/docs/examples/saas-boilerplate/constraints',
+    tags: ['saas', 'constraints', 'internal'],
+    body: `## Constraints
+- Tenant isolation and RBAC must remain explicit in spec; no implicit defaults in code.
+- Events to emit: org.created, member.invited/accepted, project.created/updated, usage.recorded.
+- Regeneration must not change billing/usage semantics without spec diffs.
+
+## PII & Settings
+- Mark PII (user emails, names) for redaction; keep settings scoped to org/member.
+- Avoid leaking secrets/config in markdown/JSON presentations.
+
+## Verification
+- Add fixtures for usage recording and role changes.
+- Ensure Audit/Notifications remain wired for invites/project updates.
+- Use Feature Flags for new settings/billing fields; default safe/off.`,
+  },
+];
+
+registerDocBlocks(saasBoilerplateDocBlocks);

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';