@lssm/example.locale-jurisdiction-gate 0.0.0-canary-20251217060433 → 0.0.0-canary-20251217062139

package/.turbo/turbo-build$colon$bundle.log

@@ -2,40 +2,196 @@
 $ tsdown
 ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
 ℹ config file: /Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/examples/locale-jurisdiction-gate/tsdown.config.js (unrun)
-ℹ entry: src/events.ts, src/example.ts, src/index.ts, src/locale-jurisdiction-gate.feature.ts, src/contracts/assistant.ts, src/contracts/index.ts, src/docs/index.ts, src/docs/locale-jurisdiction-gate.docblock.ts, src/entities/index.ts, src/entities/models.ts, src/policy/guard.ts, src/policy/index.ts, src/policy/types.ts, src/handlers/demo.handlers.ts, src/handlers/index.ts
+ℹ entry: src/events.ts, src/example.ts, src/index.ts, src/locale-jurisdiction-gate.feature.ts, src/contracts/assistant.ts, src/contracts/index.ts, src/docs/index.ts, src/docs/locale-jurisdiction-gate.docblock.ts, src/handlers/demo.handlers.ts, src/handlers/index.ts, src/entities/index.ts, src/entities/models.ts, src/policy/guard.ts, src/policy/index.ts, src/policy/types.ts
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
 ℹ Cleaning 35 files
-ℹ dist/entities/models.js                           2.50 kB │ gzip: 0.74 kB
-ℹ dist/contracts/assistant.js                       2.34 kB │ gzip: 0.93 kB
-ℹ dist/events.js                                    1.69 kB │ gzip: 0.48 kB
-ℹ dist/handlers/demo.handlers.js                    1.55 kB │ gzip: 0.69 kB
-ℹ dist/docs/locale-jurisdiction-gate.docblock.js    1.40 kB │ gzip: 0.67 kB
-ℹ dist/index.js                                     1.34 kB │ gzip: 0.47 kB
-ℹ dist/policy/guard.js                              1.18 kB │ gzip: 0.61 kB
-ℹ dist/locale-jurisdiction-gate.feature.js          0.72 kB │ gzip: 0.36 kB
-ℹ dist/example.js                                   0.67 kB │ gzip: 0.40 kB
-ℹ dist/entities/index.js                            0.41 kB │ gzip: 0.19 kB
-ℹ dist/policy/index.js                              0.17 kB │ gzip: 0.12 kB
-ℹ dist/contracts/index.js                           0.17 kB │ gzip: 0.11 kB
-ℹ dist/handlers/index.js                            0.11 kB │ gzip: 0.09 kB
-ℹ dist/docs/index.js                                0.05 kB │ gzip: 0.07 kB
-ℹ dist/policy/types.js                              0.00 kB │ gzip: 0.02 kB
-ℹ dist/contracts/assistant.d.ts                     6.73 kB │ gzip: 0.60 kB
-ℹ dist/entities/models.d.ts                         5.05 kB │ gzip: 0.65 kB
-ℹ dist/events.d.ts                                  1.98 kB │ gzip: 0.35 kB
-ℹ dist/handlers/demo.handlers.d.ts                  1.43 kB │ gzip: 0.53 kB
-ℹ dist/index.d.ts                                   1.37 kB │ gzip: 0.41 kB
-ℹ dist/example.d.ts                                 1.16 kB │ gzip: 0.47 kB
-ℹ dist/policy/guard.d.ts                            0.89 kB │ gzip: 0.40 kB
-ℹ dist/policy/types.d.ts                            0.42 kB │ gzip: 0.29 kB
-ℹ dist/entities/index.d.ts                          0.36 kB │ gzip: 0.16 kB
-ℹ dist/policy/index.d.ts                            0.26 kB │ gzip: 0.14 kB
-ℹ dist/locale-jurisdiction-gate.feature.d.ts        0.23 kB │ gzip: 0.16 kB
-ℹ dist/contracts/index.d.ts                         0.16 kB │ gzip: 0.10 kB
-ℹ dist/handlers/index.d.ts                          0.15 kB │ gzip: 0.09 kB
-ℹ dist/docs/index.d.ts                              0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/locale-jurisdiction-gate.docblock.d.ts  0.01 kB │ gzip: 0.03 kB
-ℹ 30 files, total: 34.50 kB
-✔ Build complete in 8030ms
+ℹ dist/entities/models.js                                                         2.61 kB │ gzip: 0.75 kB
+ℹ dist/contracts/assistant.js                                                     2.45 kB │ gzip: 0.94 kB
+ℹ dist/events.js                                                                  1.82 kB │ gzip: 0.50 kB
+ℹ dist/handlers/demo.handlers.js                                                  1.55 kB │ gzip: 0.69 kB
+ℹ dist/docs/locale-jurisdiction-gate.docblock.js                                  1.45 kB │ gzip: 0.68 kB
+ℹ dist/index.js                                                                   1.34 kB │ gzip: 0.47 kB
+ℹ dist/policy/guard.js                                                            1.18 kB │ gzip: 0.61 kB
+ℹ dist/locale-jurisdiction-gate.feature.js                                        0.72 kB │ gzip: 0.36 kB
+ℹ dist/example.js                                                                 0.67 kB │ gzip: 0.40 kB
+ℹ dist/entities/index.js                                                          0.41 kB │ gzip: 0.19 kB
+ℹ dist/policy/index.js                                                            0.17 kB │ gzip: 0.12 kB
+ℹ dist/contracts/index.js                                                         0.17 kB │ gzip: 0.11 kB
+ℹ dist/handlers/index.js                                                          0.11 kB │ gzip: 0.09 kB
+ℹ dist/docs/index.js                                                              0.05 kB │ gzip: 0.07 kB
+ℹ dist/policy/types.js                                                            0.00 kB │ gzip: 0.02 kB
+ℹ dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js  16.51 kB │ gzip: 7.15 kB
+ℹ dist/libs/contracts/dist/docs/tech/schema/README.docblock.js                   10.97 kB │ gzip: 4.28 kB
+ℹ dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js           9.65 kB │ gzip: 3.77 kB
+ℹ dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js              9.10 kB │ gzip: 3.41 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js               8.74 kB │ gzip: 2.67 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           5.91 kB │ gzip: 2.61 kB
+ℹ dist/libs/contracts/dist/integrations/contracts.js                              5.83 kB │ gzip: 1.20 kB
+ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js                5.62 kB │ gzip: 2.58 kB
+ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js               5.42 kB │ gzip: 2.25 kB
+ℹ dist/libs/contracts/dist/knowledge/contracts.js                                 4.62 kB │ gzip: 1.15 kB
+ℹ dist/libs/contracts/dist/schema/dist/ScalarTypeEnum.js                          4.45 kB │ gzip: 1.05 kB
+ℹ dist/libs/schema/dist/ScalarTypeEnum.js                                         4.45 kB │ gzip: 1.05 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.35 kB │ gzip: 2.05 kB
+ℹ dist/libs/contracts/dist/integrations/openbanking/contracts/accounts.js         3.99 kB │ gzip: 1.27 kB
+ℹ dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js                 3.89 kB │ gzip: 1.69 kB
+ℹ dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js                 3.58 kB │ gzip: 1.38 kB
+ℹ dist/libs/contracts/dist/integrations/openbanking/contracts/transactions.js     3.49 kB │ gzip: 1.12 kB
+ℹ dist/libs/contracts/dist/docs/PUBLISHING.docblock.js                            3.42 kB │ gzip: 1.58 kB
+ℹ dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js          3.34 kB │ gzip: 1.45 kB
+ℹ dist/libs/contracts/dist/onboarding-base.js                                     3.15 kB │ gzip: 0.93 kB
+ℹ dist/libs/contracts/dist/integrations/openbanking/models.js                     3.11 kB │ gzip: 0.66 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js         3.07 kB │ gzip: 1.38 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js      3.03 kB │ gzip: 1.32 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     2.98 kB │ gzip: 1.52 kB
+ℹ dist/libs/contracts/dist/index.js                                               2.87 kB │ gzip: 0.77 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   2.81 kB │ gzip: 1.41 kB
+ℹ dist/libs/contracts/dist/integrations/openbanking/contracts/balances.js         2.81 kB │ gzip: 0.99 kB
+ℹ dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js             2.73 kB │ gzip: 1.30 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js           2.49 kB │ gzip: 1.11 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js          2.13 kB │ gzip: 1.03 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js                1.89 kB │ gzip: 0.93 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js           1.78 kB │ gzip: 0.87 kB
+ℹ dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js         1.70 kB │ gzip: 0.89 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js      1.57 kB │ gzip: 0.77 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js             1.47 kB │ gzip: 0.73 kB
+ℹ dist/libs/contracts/dist/docs/index.js                                          1.42 kB │ gzip: 0.47 kB
+ℹ dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js                    1.23 kB │ gzip: 0.68 kB
+ℹ dist/libs/contracts/dist/contract-registry/schemas.js                           1.19 kB │ gzip: 0.46 kB
+ℹ dist/libs/contracts/dist/docs/presentations.js                                  1.14 kB │ gzip: 0.56 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js          0.89 kB │ gzip: 0.55 kB
+ℹ dist/libs/contracts/dist/integrations/index.js                                  0.73 kB │ gzip: 0.23 kB
+ℹ dist/libs/contracts/dist/ownership.js                                           0.69 kB │ gzip: 0.38 kB
+ℹ dist/libs/contracts/dist/docs/registry.js                                       0.63 kB │ gzip: 0.39 kB
+ℹ dist/libs/contracts/dist/schema/dist/FieldType.js                               0.61 kB │ gzip: 0.32 kB
+ℹ dist/libs/schema/dist/FieldType.js                                              0.61 kB │ gzip: 0.32 kB
+ℹ dist/libs/schema/dist/EnumType.js                                               0.48 kB │ gzip: 0.29 kB
+ℹ dist/libs/contracts/dist/integrations/openbanking/telemetry.js                  0.40 kB │ gzip: 0.16 kB
+ℹ dist/libs/contracts/dist/schema/dist/SchemaModel.js                             0.36 kB │ gzip: 0.26 kB
+ℹ dist/libs/schema/dist/SchemaModel.js                                            0.36 kB │ gzip: 0.26 kB
+ℹ dist/libs/contracts/dist/integrations/providers/index.js                        0.25 kB │ gzip: 0.13 kB
+ℹ dist/libs/contracts/dist/knowledge/index.js                                     0.23 kB │ gzip: 0.12 kB
+ℹ dist/libs/contracts/dist/integrations/providers/registry.js                     0.22 kB │ gzip: 0.12 kB
+ℹ dist/libs/contracts/dist/server/index.js                                        0.22 kB │ gzip: 0.12 kB
+ℹ dist/libs/schema/dist/index.js                                                  0.22 kB │ gzip: 0.14 kB
+ℹ dist/libs/contracts/dist/spec.js                                                0.22 kB │ gzip: 0.13 kB
+ℹ dist/libs/contracts/dist/server/graphql-pothos.js                               0.18 kB │ gzip: 0.10 kB
+ℹ dist/libs/contracts/dist/capabilities/openbanking.js                            0.18 kB │ gzip: 0.13 kB
+ℹ dist/libs/contracts/dist/knowledge/spaces/index.js                              0.17 kB │ gzip: 0.10 kB
+ℹ dist/libs/contracts/dist/schema/dist/index.js                                   0.16 kB │ gzip: 0.10 kB
+ℹ dist/libs/contracts/dist/integrations/openbanking/contracts/index.js            0.13 kB │ gzip: 0.10 kB
+ℹ dist/libs/contracts/dist/server/mcp/createMcpServer.js                          0.12 kB │ gzip: 0.08 kB
+ℹ dist/libs/contracts/dist/client/index.js                                        0.10 kB │ gzip: 0.08 kB
+ℹ dist/libs/contracts/dist/client/react/form-render.js                            0.10 kB │ gzip: 0.08 kB
+ℹ dist/libs/contracts/dist/server/mcp/registerResources.js                        0.07 kB │ gzip: 0.08 kB
+ℹ dist/libs/contracts/dist/client/react/index.js                                  0.07 kB │ gzip: 0.07 kB
+ℹ dist/libs/contracts/dist/registry.js                                            0.07 kB │ gzip: 0.08 kB
+ℹ dist/libs/contracts/dist/server/mcp/registerPresentations.js                    0.07 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/events.js                                              0.06 kB │ gzip: 0.08 kB
+ℹ dist/libs/contracts/dist/integrations/providers/mistral.js                      0.05 kB │ gzip: 0.07 kB
+ℹ dist/libs/contracts/dist/integrations/providers/powens.js                       0.05 kB │ gzip: 0.07 kB
+ℹ dist/libs/contracts/dist/integrations/providers/qdrant.js                       0.05 kB │ gzip: 0.07 kB
+ℹ dist/libs/contracts/dist/knowledge/spaces/financial-overview.js                 0.05 kB │ gzip: 0.07 kB
+ℹ dist/libs/contracts/dist/client/react/feature-render.js                         0.05 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/contract-registry/index.js                             0.05 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/schema/dist/entity/index.js                            0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/schema/dist/entity/index.js                                           0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/llm/index.js                                           0.04 kB │ gzip: 0.05 kB
+ℹ dist/libs/contracts/dist/presentations.v2.js                                    0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/integrations/providers/postmark.js                     0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/integrations/providers/stripe.js                       0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/integrations/providers/twilio-sms.js                   0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/knowledge/spaces/product-canon.js                      0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/integrations/providers/elevenlabs.js                   0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/integrations/providers/gcs-storage.js                  0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/integrations/providers/gmail.js                        0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/integrations/providers/google-calendar.js              0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/knowledge/spaces/email-threads.js                      0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/knowledge/spaces/financial-docs.js                     0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/knowledge/spaces/support-faq.js                        0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/knowledge/spaces/uploaded-docs.js                      0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/tests/runner.js                                        0.04 kB │ gzip: 0.06 kB
+ℹ dist/libs/contracts/dist/install.js                                             0.03 kB │ gzip: 0.05 kB
+ℹ dist/libs/contracts/dist/server/provider-mcp.js                                 0.03 kB │ gzip: 0.05 kB
+ℹ dist/libs/contracts/dist/regenerator/service.js                                 0.03 kB │ gzip: 0.05 kB
+ℹ dist/libs/contracts/dist/schema/dist/EnumType.js                                0.03 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/server/mcp/registerTools.js                            0.03 kB │ gzip: 0.05 kB
+ℹ dist/libs/contracts/dist/server/rest-elysia.js                                  0.03 kB │ gzip: 0.05 kB
+ℹ dist/libs/contracts/dist/server/rest-express.js                                 0.03 kB │ gzip: 0.05 kB
+ℹ dist/libs/contracts/dist/server/rest-next-app.js                                0.03 kB │ gzip: 0.05 kB
+ℹ dist/libs/contracts/dist/server/rest-next-pages.js                              0.03 kB │ gzip: 0.05 kB
+ℹ dist/libs/contracts/dist/llm/exporters.js                                       0.03 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/server/rest-generic.js                                 0.03 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/openapi.js                                             0.02 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/llm/prompts.js                                         0.02 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/regenerator/index.js                                   0.02 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/telemetry/index.js                                     0.02 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/experiments/evaluator.js                               0.02 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/tests/index.js                                         0.02 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/workflow/index.js                                      0.02 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/workflow/runner.js                                     0.02 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/jsonschema.js                                          0.02 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/presentations.js                                       0.02 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/server/mcp/registerPrompts.js                          0.02 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/telemetry/tracker.js                                   0.01 kB │ gzip: 0.04 kB
+ℹ dist/libs/contracts/dist/prompt.js                                              0.01 kB │ gzip: 0.03 kB
+ℹ dist/libs/contracts/dist/promptRegistry.js                                      0.01 kB │ gzip: 0.03 kB
+ℹ dist/libs/contracts/dist/resources.js                                           0.01 kB │ gzip: 0.03 kB
+ℹ dist/libs/contracts/dist/schema/dist/entity/defineEntity.js                     0.01 kB │ gzip: 0.03 kB
+ℹ dist/libs/contracts/dist/schema/dist/entity/types.js                            0.01 kB │ gzip: 0.03 kB
+ℹ dist/libs/schema/dist/entity/defineEntity.js                                    0.01 kB │ gzip: 0.03 kB
+ℹ dist/libs/schema/dist/entity/types.js                                           0.01 kB │ gzip: 0.03 kB
+ℹ dist/contracts/assistant.d.ts                                                   6.73 kB │ gzip: 0.60 kB
+ℹ dist/entities/models.d.ts                                                       5.05 kB │ gzip: 0.65 kB
+ℹ dist/events.d.ts                                                                1.98 kB │ gzip: 0.35 kB
+ℹ dist/handlers/demo.handlers.d.ts                                                1.43 kB │ gzip: 0.53 kB
+ℹ dist/index.d.ts                                                                 1.31 kB │ gzip: 0.40 kB
+ℹ dist/example.d.ts                                                               1.16 kB │ gzip: 0.47 kB
+ℹ dist/policy/guard.d.ts                                                          0.89 kB │ gzip: 0.40 kB
+ℹ dist/policy/types.d.ts                                                          0.42 kB │ gzip: 0.29 kB
+ℹ dist/entities/index.d.ts                                                        0.36 kB │ gzip: 0.16 kB
+ℹ dist/policy/index.d.ts                                                          0.26 kB │ gzip: 0.14 kB
+ℹ dist/locale-jurisdiction-gate.feature.d.ts                                      0.23 kB │ gzip: 0.16 kB
+ℹ dist/contracts/index.d.ts                                                       0.16 kB │ gzip: 0.10 kB
+ℹ dist/handlers/index.d.ts                                                        0.15 kB │ gzip: 0.09 kB
+ℹ dist/docs/index.d.ts                                                            0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/locale-jurisdiction-gate.docblock.d.ts                                0.01 kB │ gzip: 0.03 kB
+ℹ 151 files, total: 206.97 kB
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'turndown' in ../../libs/contracts/dist/presentations.v2.js
+ - Module not found, treating it as an external dependency in ../../libs/contracts/dist/presentations.v2.js at 93..103
+  │ 
+  │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'crypto' in ../../libs/contracts/dist/telemetry/tracker.js
+ - Module not found, treating it as an external dependency in ../../libs/contracts/dist/telemetry/tracker.js at 27..35
+  │ 
+  │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:crypto' in ../../libs/contracts/dist/experiments/evaluator.js
+ - Module not found, treating it as an external dependency in ../../libs/contracts/dist/experiments/evaluator.js at 27..40
+  │ 
+  │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:assert' in ../../libs/contracts/dist/tests/runner.js
+ - Module not found, treating it as an external dependency in ../../libs/contracts/dist/tests/runner.js at 52..65
+  │ 
+  │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:timers/promises' in ../../libs/contracts/dist/regenerator/service.js
+ - Module not found, treating it as an external dependency in ../../libs/contracts/dist/regenerator/service.js at 121..143
+  │ 
+  │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:crypto' in ../../libs/contracts/dist/workflow/runner.js
+ - Module not found, treating it as an external dependency in ../../libs/contracts/dist/workflow/runner.js at 80..93
+  │ 
+  │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:buffer' in ../../libs/contracts/dist/server/mcp/registerResources.js
+ - Module not found, treating it as an external dependency in ../../libs/contracts/dist/server/mcp/registerResources.js at 98..111
+  │ 
+  │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
+
+✔ Build complete in 9676ms

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @lssm/example.locale-jurisdiction-gate
 
-## 0.0.0-canary-20251217060433
+## 0.0.0-canary-20251217062139
 
 ### Minor Changes
 
@@ -9,5 +9,5 @@
 ### Patch Changes
 
 - Updated dependencies [66a5dfd]
-  - @lssm/lib.contracts@0.0.0-canary-20251217060433
-  - @lssm/lib.schema@0.0.0-canary-20251217060433
+  - @lssm/lib.contracts@0.0.0-canary-20251217062139
+  - @lssm/lib.schema@0.0.0-canary-20251217062139

package/dist/contracts/assistant.d.ts

@@ -1,5 +1,5 @@
-import * as _lssm_lib_contracts2 from "@lssm/lib.contracts";
 import * as _lssm_lib_schema63 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts2 from "@lssm/lib.contracts";
 
 //#region src/contracts/assistant.d.ts
 declare const AssistantAnswerContract: _lssm_lib_contracts2.ContractSpec<_lssm_lib_schema63.SchemaModel<{

package/dist/contracts/assistant.js

@@ -1 +1 @@
-import{AssistantAnswerIRModel as e,LLMCallEnvelopeModel as t}from"../entities/models.js";import{defineCommand as n}from"@lssm/lib.contracts";import{ScalarTypeEnum as r,defineSchemaModel as i}from"@lssm/lib.schema";const a=i({name:`AssistantQuestionInput`,description:`Input for assistant calls with mandatory envelope.`,fields:{envelope:{type:t,isOptional:!1},question:{type:r.String_unsecure(),isOptional:!1}}}),o=i({name:`AssistantConceptInput`,description:`Input for explaining a concept with mandatory envelope.`,fields:{envelope:{type:t,isOptional:!1},conceptKey:{type:r.String_unsecure(),isOptional:!1}}}),s=n({meta:{name:`assistant.answer`,version:1,stability:`experimental`,owners:[`examples`],tags:[`assistant`,`policy`,`locale`,`jurisdiction`,`knowledge`],description:`Answer a user question using a KB snapshot with strict locale/jurisdiction gating.`,goal:`Provide policy-safe answers that cite a KB snapshot or refuse.`,context:`Called by UI or workflows; must fail-closed if envelope is invalid or citations are missing.`},io:{input:a,output:e,errors:{LOCALE_REQUIRED:{description:`Locale is required and must be supported`,http:400,gqlCode:`LOCALE_REQUIRED`,when:`locale is missing or unsupported`},JURISDICTION_REQUIRED:{description:`Jurisdiction is required`,http:400,gqlCode:`JURISDICTION_REQUIRED`,when:`jurisdiction is missing`},KB_SNAPSHOT_REQUIRED:{description:`KB snapshot id is required`,http:400,gqlCode:`KB_SNAPSHOT_REQUIRED`,when:`kbSnapshotId is missing`},CITATIONS_REQUIRED:{description:`Answers must include citations to a KB snapshot`,http:422,gqlCode:`CITATIONS_REQUIRED`,when:`answer has no citations`},SCOPE_VIOLATION:{description:`Answer violates allowed scope and must be refused/escalated`,http:403,gqlCode:`SCOPE_VIOLATION`,when:`output includes forbidden content under the given allowedScope`}}},policy:{auth:`user`}}),c=n({meta:{name:`assistant.explainConcept`,version:1,stability:`experimental`,owners:[`examples`],tags:[`assistant`,`policy`,`knowledge`,`concepts`],description:`Explain a concept using a KB snapshot with strict locale/jurisdiction gating.`,goal:`Explain concepts with citations or refuse.`,context:`Same constraints as assistant.answer.`},io:{input:o,output:e,errors:s.io.errors},policy:{auth:`user`}});export{s as AssistantAnswerContract,c as AssistantExplainConceptContract};
+import{t as e}from"../libs/contracts/dist/spec.js";import"../libs/contracts/dist/index.js";import{l as t}from"../libs/schema/dist/ScalarTypeEnum.js";import{n}from"../libs/schema/dist/SchemaModel.js";import"../libs/schema/dist/index.js";import{AssistantAnswerIRModel as r,LLMCallEnvelopeModel as i}from"../entities/models.js";const a=n({name:`AssistantQuestionInput`,description:`Input for assistant calls with mandatory envelope.`,fields:{envelope:{type:i,isOptional:!1},question:{type:t.String_unsecure(),isOptional:!1}}}),o=n({name:`AssistantConceptInput`,description:`Input for explaining a concept with mandatory envelope.`,fields:{envelope:{type:i,isOptional:!1},conceptKey:{type:t.String_unsecure(),isOptional:!1}}}),s=e({meta:{name:`assistant.answer`,version:1,stability:`experimental`,owners:[`examples`],tags:[`assistant`,`policy`,`locale`,`jurisdiction`,`knowledge`],description:`Answer a user question using a KB snapshot with strict locale/jurisdiction gating.`,goal:`Provide policy-safe answers that cite a KB snapshot or refuse.`,context:`Called by UI or workflows; must fail-closed if envelope is invalid or citations are missing.`},io:{input:a,output:r,errors:{LOCALE_REQUIRED:{description:`Locale is required and must be supported`,http:400,gqlCode:`LOCALE_REQUIRED`,when:`locale is missing or unsupported`},JURISDICTION_REQUIRED:{description:`Jurisdiction is required`,http:400,gqlCode:`JURISDICTION_REQUIRED`,when:`jurisdiction is missing`},KB_SNAPSHOT_REQUIRED:{description:`KB snapshot id is required`,http:400,gqlCode:`KB_SNAPSHOT_REQUIRED`,when:`kbSnapshotId is missing`},CITATIONS_REQUIRED:{description:`Answers must include citations to a KB snapshot`,http:422,gqlCode:`CITATIONS_REQUIRED`,when:`answer has no citations`},SCOPE_VIOLATION:{description:`Answer violates allowed scope and must be refused/escalated`,http:403,gqlCode:`SCOPE_VIOLATION`,when:`output includes forbidden content under the given allowedScope`}}},policy:{auth:`user`}}),c=e({meta:{name:`assistant.explainConcept`,version:1,stability:`experimental`,owners:[`examples`],tags:[`assistant`,`policy`,`knowledge`,`concepts`],description:`Explain a concept using a KB snapshot with strict locale/jurisdiction gating.`,goal:`Explain concepts with citations or refuse.`,context:`Same constraints as assistant.answer.`},io:{input:o,output:r,errors:s.io.errors},policy:{auth:`user`}});export{s as AssistantAnswerContract,c as AssistantExplainConceptContract};

package/dist/docs/locale-jurisdiction-gate.docblock.js

@@ -1,4 +1,4 @@
-import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.examples.locale-jurisdiction-gate.goal`,title:`Locale/Jurisdiction Gate — Goal`,summary:`Fail-closed gate that forces locale + jurisdiction + kbSnapshotId + allowedScope for assistant calls.`,kind:`goal`,visibility:`public`,route:`/docs/examples/locale-jurisdiction-gate/goal`,tags:[`assistant`,`policy`,`locale`,`jurisdiction`,`knowledge`],body:`## Why it matters
+import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{id:`docs.examples.locale-jurisdiction-gate.goal`,title:`Locale/Jurisdiction Gate — Goal`,summary:`Fail-closed gate that forces locale + jurisdiction + kbSnapshotId + allowedScope for assistant calls.`,kind:`goal`,visibility:`public`,route:`/docs/examples/locale-jurisdiction-gate/goal`,tags:[`assistant`,`policy`,`locale`,`jurisdiction`,`knowledge`],body:`## Why it matters
 - Forces all assistant behavior to be bound to explicit inputs (no guessing).
 - Requires KB snapshot citations to make answers traceable and regenerable.
 

package/dist/entities/models.js

@@ -1 +1 @@
-import{ScalarTypeEnum as e,defineEnum as t,defineSchemaModel as n}from"@lssm/lib.schema";const r=t(`AllowedScope`,[`education_only`,`generic_info`,`escalation_required`]),i=n({name:`UserProfile`,description:`User profile inputs used to derive regulatory context.`,fields:{preferredLocale:{type:e.String_unsecure(),isOptional:!0},residencyCountry:{type:e.String_unsecure(),isOptional:!0},taxResidenceCountry:{type:e.String_unsecure(),isOptional:!0},clientType:{type:e.String_unsecure(),isOptional:!0}}}),a=n({name:`RegulatoryContext`,description:`Explicit regulatory context (no guessing).`,fields:{jurisdiction:{type:e.String_unsecure(),isOptional:!1},region:{type:e.String_unsecure(),isOptional:!0},clientType:{type:e.String_unsecure(),isOptional:!0},allowedScope:{type:r,isOptional:!1}}}),o=n({name:`LLMCallEnvelope`,description:`Mandatory envelope for assistant calls. All fields are explicit and required for policy gating.`,fields:{traceId:{type:e.String_unsecure(),isOptional:!1},locale:{type:e.String_unsecure(),isOptional:!1},regulatoryContext:{type:a,isOptional:!1},kbSnapshotId:{type:e.String_unsecure(),isOptional:!1},allowedScope:{type:r,isOptional:!1}}}),s=n({name:`AssistantCitation`,description:`Citation referencing a KB snapshot + a specific item within it.`,fields:{kbSnapshotId:{type:e.String_unsecure(),isOptional:!1},sourceType:{type:e.String_unsecure(),isOptional:!1},sourceId:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!0},excerpt:{type:e.String_unsecure(),isOptional:!0}}}),c=n({name:`AssistantAnswerSection`,description:`Structured answer section.`,fields:{heading:{type:e.String_unsecure(),isOptional:!1},body:{type:e.String_unsecure(),isOptional:!1}}}),l=n({name:`AssistantAnswerIR`,description:`Structured assistant answer with mandatory citations and explicit locale/jurisdiction.`,fields:{locale:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},allowedScope:{type:r,isOptional:!1},sections:{type:c,isArray:!0,isOptional:!1},citations:{type:s,isArray:!0,isOptional:!1},disclaimers:{type:e.String_unsecure(),isArray:!0,isOptional:!0},riskFlags:{type:e.String_unsecure(),isArray:!0,isOptional:!0},refused:{type:e.Boolean(),isOptional:!0},refusalReason:{type:e.String_unsecure(),isOptional:!0}}});export{r as AllowedScopeEnum,l as AssistantAnswerIRModel,c as AssistantAnswerSectionModel,s as AssistantCitationModel,o as LLMCallEnvelopeModel,a as RegulatoryContextModel,i as UserProfileModel};
+import{r as e}from"../libs/schema/dist/EnumType.js";import{l as t}from"../libs/schema/dist/ScalarTypeEnum.js";import{n}from"../libs/schema/dist/SchemaModel.js";import"../libs/schema/dist/index.js";const r=e(`AllowedScope`,[`education_only`,`generic_info`,`escalation_required`]),i=n({name:`UserProfile`,description:`User profile inputs used to derive regulatory context.`,fields:{preferredLocale:{type:t.String_unsecure(),isOptional:!0},residencyCountry:{type:t.String_unsecure(),isOptional:!0},taxResidenceCountry:{type:t.String_unsecure(),isOptional:!0},clientType:{type:t.String_unsecure(),isOptional:!0}}}),a=n({name:`RegulatoryContext`,description:`Explicit regulatory context (no guessing).`,fields:{jurisdiction:{type:t.String_unsecure(),isOptional:!1},region:{type:t.String_unsecure(),isOptional:!0},clientType:{type:t.String_unsecure(),isOptional:!0},allowedScope:{type:r,isOptional:!1}}}),o=n({name:`LLMCallEnvelope`,description:`Mandatory envelope for assistant calls. All fields are explicit and required for policy gating.`,fields:{traceId:{type:t.String_unsecure(),isOptional:!1},locale:{type:t.String_unsecure(),isOptional:!1},regulatoryContext:{type:a,isOptional:!1},kbSnapshotId:{type:t.String_unsecure(),isOptional:!1},allowedScope:{type:r,isOptional:!1}}}),s=n({name:`AssistantCitation`,description:`Citation referencing a KB snapshot + a specific item within it.`,fields:{kbSnapshotId:{type:t.String_unsecure(),isOptional:!1},sourceType:{type:t.String_unsecure(),isOptional:!1},sourceId:{type:t.String_unsecure(),isOptional:!1},title:{type:t.String_unsecure(),isOptional:!0},excerpt:{type:t.String_unsecure(),isOptional:!0}}}),c=n({name:`AssistantAnswerSection`,description:`Structured answer section.`,fields:{heading:{type:t.String_unsecure(),isOptional:!1},body:{type:t.String_unsecure(),isOptional:!1}}}),l=n({name:`AssistantAnswerIR`,description:`Structured assistant answer with mandatory citations and explicit locale/jurisdiction.`,fields:{locale:{type:t.String_unsecure(),isOptional:!1},jurisdiction:{type:t.String_unsecure(),isOptional:!1},allowedScope:{type:r,isOptional:!1},sections:{type:c,isArray:!0,isOptional:!1},citations:{type:s,isArray:!0,isOptional:!1},disclaimers:{type:t.String_unsecure(),isArray:!0,isOptional:!0},riskFlags:{type:t.String_unsecure(),isArray:!0,isOptional:!0},refused:{type:t.Boolean(),isOptional:!0},refusalReason:{type:t.String_unsecure(),isOptional:!0}}});export{r as AllowedScopeEnum,l as AssistantAnswerIRModel,c as AssistantAnswerSectionModel,s as AssistantCitationModel,o as LLMCallEnvelopeModel,a as RegulatoryContextModel,i as UserProfileModel};

package/dist/events.d.ts

@@ -1,5 +1,5 @@
-import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
 import * as _lssm_lib_schema0 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts0 from "@lssm/lib.contracts";
 
 //#region src/events.d.ts
 declare const AssistantAnswerRequestedEvent: _lssm_lib_contracts0.EventSpec<_lssm_lib_schema0.SchemaModel<{

package/dist/events.js

@@ -1 +1 @@
-import{defineEvent as e,defineSchemaModel as t}from"@lssm/lib.contracts";import{ScalarTypeEnum as n}from"@lssm/lib.schema";const r=e({name:`assistant.answer.requested`,version:1,description:`Assistant answer requested (policy gate will run).`,payload:t({name:`AssistantAnswerRequestedPayload`,description:`Emitted when an assistant answer is requested (pre-gate).`,fields:{traceId:{type:n.String_unsecure(),isOptional:!1},locale:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},kbSnapshotId:{type:n.String_unsecure(),isOptional:!1},allowedScope:{type:n.String_unsecure(),isOptional:!1}}})}),i=e({name:`assistant.answer.blocked`,version:1,description:`Assistant answer blocked (fail-closed).`,payload:t({name:`AssistantAnswerBlockedPayload`,description:`Emitted when a request is blocked by the gate.`,fields:{traceId:{type:n.String_unsecure(),isOptional:!1},reasonCode:{type:n.String_unsecure(),isOptional:!1},reason:{type:n.String_unsecure(),isOptional:!1}}})}),a=e({name:`assistant.answer.delivered`,version:1,description:`Assistant answer delivered (must include KB snapshot citations).`,payload:t({name:`AssistantAnswerDeliveredPayload`,description:`Emitted when a structured, cited answer is delivered.`,fields:{traceId:{type:n.String_unsecure(),isOptional:!1},locale:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},kbSnapshotId:{type:n.String_unsecure(),isOptional:!1},allowedScope:{type:n.String_unsecure(),isOptional:!1},citationsCount:{type:n.Int_unsecure(),isOptional:!1}}})});export{i as AssistantAnswerBlockedEvent,a as AssistantAnswerDeliveredEvent,r as AssistantAnswerRequestedEvent};
+import{n as e}from"./libs/contracts/dist/schema/dist/SchemaModel.js";import{e as t}from"./libs/contracts/dist/events.js";import"./libs/contracts/dist/index.js";import{l as n}from"./libs/schema/dist/ScalarTypeEnum.js";import"./libs/schema/dist/index.js";const r=t({name:`assistant.answer.requested`,version:1,description:`Assistant answer requested (policy gate will run).`,payload:e({name:`AssistantAnswerRequestedPayload`,description:`Emitted when an assistant answer is requested (pre-gate).`,fields:{traceId:{type:n.String_unsecure(),isOptional:!1},locale:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},kbSnapshotId:{type:n.String_unsecure(),isOptional:!1},allowedScope:{type:n.String_unsecure(),isOptional:!1}}})}),i=t({name:`assistant.answer.blocked`,version:1,description:`Assistant answer blocked (fail-closed).`,payload:e({name:`AssistantAnswerBlockedPayload`,description:`Emitted when a request is blocked by the gate.`,fields:{traceId:{type:n.String_unsecure(),isOptional:!1},reasonCode:{type:n.String_unsecure(),isOptional:!1},reason:{type:n.String_unsecure(),isOptional:!1}}})}),a=t({name:`assistant.answer.delivered`,version:1,description:`Assistant answer delivered (must include KB snapshot citations).`,payload:e({name:`AssistantAnswerDeliveredPayload`,description:`Emitted when a structured, cited answer is delivered.`,fields:{traceId:{type:n.String_unsecure(),isOptional:!1},locale:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},kbSnapshotId:{type:n.String_unsecure(),isOptional:!1},allowedScope:{type:n.String_unsecure(),isOptional:!1},citationsCount:{type:n.Int_unsecure(),isOptional:!1}}})});export{i as AssistantAnswerBlockedEvent,a as AssistantAnswerDeliveredEvent,r as AssistantAnswerRequestedEvent};

package/dist/index.d.ts

@@ -1,7 +1,5 @@
 import { AssistantAnswerContract, AssistantExplainConceptContract } from "./contracts/assistant.js";
-import "./contracts/index.js";
 import { AllowedScopeEnum, AssistantAnswerIRModel, AssistantAnswerSectionModel, AssistantCitationModel, LLMCallEnvelopeModel, RegulatoryContextModel, UserProfileModel } from "./entities/models.js";
-import "./entities/index.js";
 import { AssistantAnswerBlockedEvent, AssistantAnswerDeliveredEvent, AssistantAnswerRequestedEvent } from "./events.js";
 import example from "./example.js";
 import { DemoAssistantHandlers, createDemoAssistantHandlers } from "./handlers/demo.handlers.js";

package/dist/libs/contracts/dist/capabilities/openbanking.js

@@ -0,0 +1 @@
+import{e}from"../ownership.js";const t=[`platform.finance`],n=[`open-banking`,`finance`];[...t],[...n],e.Experimental,[...t],[...n],e.Experimental,[...t],[...n],e.Experimental;

package/dist/libs/contracts/dist/client/index.js

@@ -0,0 +1 @@
+"use client";import"./react/feature-render.js";import"./react/form-render.js";import"./react/index.js";

package/dist/libs/contracts/dist/client/react/feature-render.js

@@ -0,0 +1 @@
+import"../../presentations.v2.js";import"react";

package/dist/libs/contracts/dist/client/react/form-render.js

@@ -0,0 +1 @@
+import"react";import"react-hook-form";import"@hookform/resolvers/zod";import"react/jsx-runtime";

package/dist/libs/contracts/dist/client/react/index.js

@@ -0,0 +1 @@
+"use client";import"./feature-render.js";import"./form-render.js";

package/dist/libs/contracts/dist/contract-registry/index.js

@@ -0,0 +1 @@
+import{i as e,n as t,r as n}from"./schemas.js";

package/dist/libs/contracts/dist/contract-registry/schemas.js

@@ -0,0 +1 @@
+import{e}from"../ownership.js";import t from"zod";const n=t.enum([`contractspec:operation`,`contractspec:event`,`contractspec:presentation`,`contractspec:form`,`contractspec:feature`,`contractspec:workflow`,`contractspec:template`,`contractspec:integration`,`contractspec:data-view`,`contractspec:migration`,`contractspec:telemetry`,`contractspec:experiment`,`contractspec:app-config`,`contractspec:knowledge`]),r=t.object({path:t.string().min(1),type:t.string().min(1),content:t.string().optional()}),i=t.object({name:t.string().min(1),type:n,version:t.number().int().nonnegative(),title:t.string().min(1),description:t.string().min(1),meta:t.object({stability:t.enum([e.Idea,e.InCreation,e.Experimental,e.Beta,e.Stable,e.Deprecated]),owners:t.array(t.string().min(1)).default([]),tags:t.array(t.string().min(1)).default([])}),dependencies:t.array(t.string().min(1)).optional(),registryDependencies:t.array(t.string().min(1)).optional(),files:t.array(r).min(1),schema:t.object({input:t.unknown().optional(),output:t.unknown().optional()}).optional()});t.object({$schema:t.string().min(1).optional(),name:t.string().min(1),homepage:t.string().min(1).optional(),items:t.array(i)});export{i,n,r};

package/dist/libs/contracts/dist/docs/PUBLISHING.docblock.js

@@ -0,0 +1,76 @@
+import{a as e}from"./registry.js";e([{id:`docs.PUBLISHING`,title:`Publishing ContractSpec Libraries`,summary:`This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).`,kind:`reference`,visibility:`public`,route:`/docs/PUBLISHING`,tags:[`PUBLISHING`],body:`# Publishing ContractSpec Libraries
+
+This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).
+
+## Release Tracks
+
+| Track | Branch | npm Tag | Frequency | Versioning | Use Case |
+|-------|--------|---------|-----------|------------|----------|
+| **Stable** | \`release\` | \`latest\` | Manual | SemVer (e.g., \`1.7.4\`) | Production, external users |
+| **Canary** | \`main\` | \`canary\` | Every Push | Snapshot (e.g., \`1.7.4-canary...\`) | Dev, internal testing |
+
+## Prerequisites
+
+- ✅ \`NPM_TOKEN\` secret is configured in GitHub (owner or automation token with _publish_ scope).
+- ✅ \`GITHUB_TOKEN\` (built-in) has permissions to create PRs (enabled by default in new repos).
+- ✅ For stable releases: \`release\` branch exists and is protected.
+
+## Canary Workflow (Automatic)
+
+Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
+
+1. **Trigger**: Push to \`main\`.
+2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
+3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
+
+### Consuming Canary Builds
+
+To install the latest bleeding-edge version:
+
+\`\`\`bash
+npm install @lssm/lib.contracts@canary
+# or
+bun add @lssm/lib.contracts@canary
+\`\`\`
+
+## Stable Release Workflow (Manual)
+
+Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
+
+1. **Develop on \`main\`**: Create features and fixes.
+2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
+3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
+4. **"Version Packages" PR**:
+   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
+   - This PR contains the version bumps and updated \`CHANGELOG.md\` files.
+5. **Merge & Publish**:
+   - Review and merge the "Version Packages" PR.
+   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
+
+### Publishing Steps
+
+1. Ensure all changesets are present on \`main\`.
+2. Merge \`main\` into \`release\`:
+   \`\`\`bash
+   git checkout release
+   git pull origin release
+   git merge main
+   git push origin release
+   \`\`\`
+3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
+4. Merge that PR.
+5. The release is now live on npm!
+
+## Manual Verification (Optional)
+
+Before publishing a new version you can run:
+
+\`\`\`bash
+bun run build:not-apps
+npx npm-packlist --json packages/libs/contracts
+\`\`\`
+
+## Rollback
+
+If a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use \`npm deprecate <package>@<version>\` if we need to warn consumers about a broken release.
+`}]);