@lssm/example.versioned-knowledge-base 0.0.0-canary-20251217060433 → 0.0.0-canary-20251217062139

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

@@ -7,29 +7,185 @@
 ℹ tsconfig: tsconfig.json
 ℹ Build start
 ℹ Cleaning 28 files
-ℹ dist/contracts/kb.js                              4.36 kB │ gzip: 1.33 kB
-ℹ dist/handlers/memory.handlers.js                  2.16 kB │ gzip: 0.91 kB
-ℹ dist/entities/models.js                           2.13 kB │ gzip: 0.59 kB
-ℹ dist/events.js                                    1.72 kB │ gzip: 0.49 kB
-ℹ dist/docs/versioned-knowledge-base.docblock.js    1.28 kB │ gzip: 0.59 kB
-ℹ dist/index.js                                     1.23 kB │ gzip: 0.43 kB
-ℹ dist/versioned-knowledge-base.feature.js          0.81 kB │ gzip: 0.37 kB
-ℹ dist/example.js                                   0.61 kB │ gzip: 0.36 kB
-ℹ dist/contracts/index.js                           0.33 kB │ gzip: 0.16 kB
-ℹ dist/entities/index.js                            0.24 kB │ gzip: 0.14 kB
-ℹ dist/handlers/index.js                            0.15 kB │ gzip: 0.10 kB
-ℹ dist/docs/index.js                                0.05 kB │ gzip: 0.07 kB
-ℹ dist/contracts/kb.d.ts                            7.09 kB │ gzip: 0.61 kB
-ℹ dist/entities/models.d.ts                         3.54 kB │ gzip: 0.49 kB
-ℹ dist/events.d.ts                                  1.91 kB │ gzip: 0.36 kB
-ℹ dist/handlers/memory.handlers.d.ts                1.90 kB │ gzip: 0.59 kB
-ℹ dist/index.d.ts                                   1.17 kB │ gzip: 0.35 kB
-ℹ dist/example.d.ts                                 1.09 kB │ gzip: 0.44 kB
-ℹ dist/contracts/index.d.ts                         0.29 kB │ gzip: 0.13 kB
-ℹ dist/versioned-knowledge-base.feature.d.ts        0.23 kB │ gzip: 0.16 kB
-ℹ dist/entities/index.d.ts                          0.21 kB │ gzip: 0.11 kB
-ℹ dist/handlers/index.d.ts                          0.20 kB │ gzip: 0.10 kB
-ℹ dist/docs/index.d.ts                              0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/versioned-knowledge-base.docblock.d.ts  0.01 kB │ gzip: 0.03 kB
-ℹ 24 files, total: 32.71 kB
-✔ Build complete in 8106ms
+ℹ dist/contracts/kb.js                                                            4.46 kB │ gzip: 1.34 kB
+ℹ dist/entities/models.js                                                         2.21 kB │ gzip: 0.60 kB
+ℹ dist/handlers/memory.handlers.js                                                2.16 kB │ gzip: 0.91 kB
+ℹ dist/events.js                                                                  1.85 kB │ gzip: 0.51 kB
+ℹ dist/docs/versioned-knowledge-base.docblock.js                                  1.32 kB │ gzip: 0.59 kB
+ℹ dist/index.js                                                                   1.23 kB │ gzip: 0.43 kB
+ℹ dist/versioned-knowledge-base.feature.js                                        0.81 kB │ gzip: 0.37 kB
+ℹ dist/example.js                                                                 0.61 kB │ gzip: 0.36 kB
+ℹ dist/contracts/index.js                                                         0.33 kB │ gzip: 0.16 kB
+ℹ dist/entities/index.js                                                          0.24 kB │ gzip: 0.14 kB
+ℹ dist/handlers/index.js                                                          0.15 kB │ gzip: 0.10 kB
+ℹ dist/docs/index.js                                                              0.05 kB │ gzip: 0.07 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/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/contracts/dist/spec.js                                                0.22 kB │ gzip: 0.13 kB
+ℹ dist/libs/schema/dist/index.js                                                  0.20 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/schema/dist/EnumType.js                                               0.03 kB │ gzip: 0.04 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/kb.d.ts                                                          7.09 kB │ gzip: 0.61 kB
+ℹ dist/entities/models.d.ts                                                       3.54 kB │ gzip: 0.49 kB
+ℹ dist/events.d.ts                                                                1.91 kB │ gzip: 0.36 kB
+ℹ dist/handlers/memory.handlers.d.ts                                              1.90 kB │ gzip: 0.59 kB
+ℹ dist/index.d.ts                                                                 1.11 kB │ gzip: 0.34 kB
+ℹ dist/example.d.ts                                                               1.09 kB │ gzip: 0.44 kB
+ℹ dist/contracts/index.d.ts                                                       0.29 kB │ gzip: 0.13 kB
+ℹ dist/versioned-knowledge-base.feature.d.ts                                      0.23 kB │ gzip: 0.16 kB
+ℹ dist/entities/index.d.ts                                                        0.21 kB │ gzip: 0.11 kB
+ℹ dist/handlers/index.d.ts                                                        0.20 kB │ gzip: 0.10 kB
+ℹ dist/docs/index.d.ts                                                            0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/versioned-knowledge-base.docblock.d.ts                                0.01 kB │ gzip: 0.03 kB
+ℹ 145 files, total: 204.65 kB
+[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: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 '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 '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 '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 8854ms

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @lssm/example.versioned-knowledge-base
 
-## 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/kb.d.ts

@@ -1,5 +1,5 @@
-import * as _lssm_lib_contracts3 from "@lssm/lib.contracts";
 import * as _lssm_lib_schema15 from "@lssm/lib.schema";
+import * as _lssm_lib_contracts3 from "@lssm/lib.contracts";
 
 //#region src/contracts/kb.d.ts
 declare const KbIngestSourceContract: _lssm_lib_contracts3.ContractSpec<_lssm_lib_schema15.SchemaModel<{

package/dist/contracts/kb.js

@@ -1 +1 @@
-import{KBSnapshotModel as e,RuleVersionModel as t,SourceDocumentModel as n,SourceRefModel as r}from"../entities/models.js";import{defineCommand as i,defineQuery as a}from"@lssm/lib.contracts";import{ScalarTypeEnum as o,defineSchemaModel as s}from"@lssm/lib.schema";const c=s({name:`KbIngestSourceInput`,description:`Ingest immutable source metadata referencing a stored file.`,fields:{jurisdiction:{type:o.String_unsecure(),isOptional:!1},authority:{type:o.String_unsecure(),isOptional:!1},title:{type:o.String_unsecure(),isOptional:!1},fetchedAt:{type:o.DateTime(),isOptional:!1},hash:{type:o.String_unsecure(),isOptional:!1},fileId:{type:o.String_unsecure(),isOptional:!1}}}),l=s({name:`KbUpsertRuleVersionInput`,description:`Create a new draft rule version (immutable history).`,fields:{ruleId:{type:o.String_unsecure(),isOptional:!1},content:{type:o.String_unsecure(),isOptional:!1},sourceRefs:{type:r,isArray:!0,isOptional:!1}}}),u=s({name:`KbApproveRuleVersionInput`,description:`Approve a rule version (human verification).`,fields:{ruleVersionId:{type:o.String_unsecure(),isOptional:!1},approver:{type:o.String_unsecure(),isOptional:!1}}}),d=s({name:`KbPublishSnapshotInput`,description:`Publish a snapshot for a jurisdiction as-of a date.`,fields:{jurisdiction:{type:o.String_unsecure(),isOptional:!1},asOfDate:{type:o.DateTime(),isOptional:!1}}}),f=s({name:`KbSearchInput`,description:`Search within a published snapshot.`,fields:{snapshotId:{type:o.String_unsecure(),isOptional:!1},jurisdiction:{type:o.String_unsecure(),isOptional:!1},query:{type:o.String_unsecure(),isOptional:!1}}}),p=s({name:`KbSearchOutput`,description:`Search results constrained to snapshot + jurisdiction.`,fields:{items:{type:s({name:`KbSearchResultItem`,description:`Search result referencing a specific rule version.`,fields:{ruleVersionId:{type:o.String_unsecure(),isOptional:!1},excerpt:{type:o.String_unsecure(),isOptional:!0}}}),isArray:!0,isOptional:!1}}}),m=i({meta:{name:`kb.ingestSource`,version:1,stability:`experimental`,owners:[`@examples`],tags:[`knowledge`,`sources`,`ingestion`],description:`Ingest immutable source document metadata.`,goal:`Store traceable source documents for curated KB.`,context:`Called when an admin uploads/records authoritative sources.`},io:{input:c,output:n},policy:{auth:`user`}}),h=i({meta:{name:`kb.upsertRuleVersion`,version:1,stability:`experimental`,owners:[`@examples`],tags:[`knowledge`,`rules`,`versioning`],description:`Create a new draft rule version with source references.`,goal:`Propose curated knowledge updates with traceability.`,context:`Automation or curators propose draft rule versions.`},io:{input:l,output:t,errors:{SOURCE_REFS_REQUIRED:{description:`Rule version must cite at least one sourceRef`,http:400,gqlCode:`SOURCE_REFS_REQUIRED`,when:`sourceRefs is empty`},RULE_NOT_FOUND:{description:`Rule does not exist`,http:404,gqlCode:`RULE_NOT_FOUND`,when:`ruleId is unknown`}}},policy:{auth:`user`}}),g=i({meta:{name:`kb.approveRuleVersion`,version:1,stability:`experimental`,owners:[`@examples`],tags:[`knowledge`,`rules`,`approval`],description:`Approve a draft rule version.`,goal:`Human verification step before publishing snapshots.`,context:`Curators/experts approve proposed KB changes.`},io:{input:u,output:t},policy:{auth:`user`}}),_=i({meta:{name:`kb.publishSnapshot`,version:1,stability:`experimental`,owners:[`@examples`],tags:[`knowledge`,`snapshots`,`publishing`],description:`Publish a KB snapshot for a jurisdiction.`,goal:`Create a stable snapshot that assistant answers can cite.`,context:`Publishing happens after approvals; snapshot is referenced by answers.`},io:{input:d,output:e,errors:{NO_APPROVED_RULES:{description:`No approved rule versions available to publish`,http:409,gqlCode:`NO_APPROVED_RULES`,when:`jurisdiction has zero approved rule versions`}}},policy:{auth:`user`}}),v=a({meta:{name:`kb.search`,version:1,stability:`experimental`,owners:[`@examples`],tags:[`knowledge`,`search`,`snapshots`],description:`Search within a published KB snapshot.`,goal:`Provide scoped retrieval for assistant answers.`,context:`Assistant queries curated rules from a specific snapshot.`},io:{input:f,output:p},policy:{auth:`user`}});export{g as KbApproveRuleVersionContract,m as KbIngestSourceContract,_ as KbPublishSnapshotContract,v as KbSearchContract,h as KbUpsertRuleVersionContract};
+import{n as e,t}from"../libs/contracts/dist/spec.js";import"../libs/contracts/dist/index.js";import{l as n}from"../libs/schema/dist/ScalarTypeEnum.js";import{n as r}from"../libs/schema/dist/SchemaModel.js";import"../libs/schema/dist/index.js";import{KBSnapshotModel as i,RuleVersionModel as a,SourceDocumentModel as o,SourceRefModel as s}from"../entities/models.js";const c=r({name:`KbIngestSourceInput`,description:`Ingest immutable source metadata referencing a stored file.`,fields:{jurisdiction:{type:n.String_unsecure(),isOptional:!1},authority:{type:n.String_unsecure(),isOptional:!1},title:{type:n.String_unsecure(),isOptional:!1},fetchedAt:{type:n.DateTime(),isOptional:!1},hash:{type:n.String_unsecure(),isOptional:!1},fileId:{type:n.String_unsecure(),isOptional:!1}}}),l=r({name:`KbUpsertRuleVersionInput`,description:`Create a new draft rule version (immutable history).`,fields:{ruleId:{type:n.String_unsecure(),isOptional:!1},content:{type:n.String_unsecure(),isOptional:!1},sourceRefs:{type:s,isArray:!0,isOptional:!1}}}),u=r({name:`KbApproveRuleVersionInput`,description:`Approve a rule version (human verification).`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},approver:{type:n.String_unsecure(),isOptional:!1}}}),d=r({name:`KbPublishSnapshotInput`,description:`Publish a snapshot for a jurisdiction as-of a date.`,fields:{jurisdiction:{type:n.String_unsecure(),isOptional:!1},asOfDate:{type:n.DateTime(),isOptional:!1}}}),f=r({name:`KbSearchInput`,description:`Search within a published snapshot.`,fields:{snapshotId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},query:{type:n.String_unsecure(),isOptional:!1}}}),p=r({name:`KbSearchOutput`,description:`Search results constrained to snapshot + jurisdiction.`,fields:{items:{type:r({name:`KbSearchResultItem`,description:`Search result referencing a specific rule version.`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},excerpt:{type:n.String_unsecure(),isOptional:!0}}}),isArray:!0,isOptional:!1}}}),m=t({meta:{name:`kb.ingestSource`,version:1,stability:`experimental`,owners:[`@examples`],tags:[`knowledge`,`sources`,`ingestion`],description:`Ingest immutable source document metadata.`,goal:`Store traceable source documents for curated KB.`,context:`Called when an admin uploads/records authoritative sources.`},io:{input:c,output:o},policy:{auth:`user`}}),h=t({meta:{name:`kb.upsertRuleVersion`,version:1,stability:`experimental`,owners:[`@examples`],tags:[`knowledge`,`rules`,`versioning`],description:`Create a new draft rule version with source references.`,goal:`Propose curated knowledge updates with traceability.`,context:`Automation or curators propose draft rule versions.`},io:{input:l,output:a,errors:{SOURCE_REFS_REQUIRED:{description:`Rule version must cite at least one sourceRef`,http:400,gqlCode:`SOURCE_REFS_REQUIRED`,when:`sourceRefs is empty`},RULE_NOT_FOUND:{description:`Rule does not exist`,http:404,gqlCode:`RULE_NOT_FOUND`,when:`ruleId is unknown`}}},policy:{auth:`user`}}),g=t({meta:{name:`kb.approveRuleVersion`,version:1,stability:`experimental`,owners:[`@examples`],tags:[`knowledge`,`rules`,`approval`],description:`Approve a draft rule version.`,goal:`Human verification step before publishing snapshots.`,context:`Curators/experts approve proposed KB changes.`},io:{input:u,output:a},policy:{auth:`user`}}),_=t({meta:{name:`kb.publishSnapshot`,version:1,stability:`experimental`,owners:[`@examples`],tags:[`knowledge`,`snapshots`,`publishing`],description:`Publish a KB snapshot for a jurisdiction.`,goal:`Create a stable snapshot that assistant answers can cite.`,context:`Publishing happens after approvals; snapshot is referenced by answers.`},io:{input:d,output:i,errors:{NO_APPROVED_RULES:{description:`No approved rule versions available to publish`,http:409,gqlCode:`NO_APPROVED_RULES`,when:`jurisdiction has zero approved rule versions`}}},policy:{auth:`user`}}),v=e({meta:{name:`kb.search`,version:1,stability:`experimental`,owners:[`@examples`],tags:[`knowledge`,`search`,`snapshots`],description:`Search within a published KB snapshot.`,goal:`Provide scoped retrieval for assistant answers.`,context:`Assistant queries curated rules from a specific snapshot.`},io:{input:f,output:p},policy:{auth:`user`}});export{g as KbApproveRuleVersionContract,m as KbIngestSourceContract,_ as KbPublishSnapshotContract,v as KbSearchContract,h as KbUpsertRuleVersionContract};

package/dist/docs/versioned-knowledge-base.docblock.js

@@ -1,4 +1,4 @@
-import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{id:`docs.examples.versioned-knowledge-base.goal`,title:`Versioned Knowledge Base — Goal`,summary:`Curated KB with immutable sources, versioned rules, and published snapshots referenced by answers.`,kind:`goal`,visibility:`public`,route:`/docs/examples/versioned-knowledge-base/goal`,tags:[`knowledge`,`versioning`,`snapshots`,`traceability`],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.versioned-knowledge-base.goal`,title:`Versioned Knowledge Base — Goal`,summary:`Curated KB with immutable sources, versioned rules, and published snapshots referenced by answers.`,kind:`goal`,visibility:`public`,route:`/docs/examples/versioned-knowledge-base/goal`,tags:[`knowledge`,`versioning`,`snapshots`,`traceability`],body:`## Why it matters
 - Separates raw sources from curated knowledge.
 - Ensures assistant answers cite a published snapshot.
 - Makes change review and safe regeneration possible.

package/dist/entities/models.js

@@ -1 +1 @@
-import{ScalarTypeEnum as e,defineSchemaModel as t}from"@lssm/lib.schema";const n=t({name:`SourceDocument`,description:`Immutable raw source document metadata referencing a stored file.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},authority:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},fetchedAt:{type:e.DateTime(),isOptional:!1},hash:{type:e.String_unsecure(),isOptional:!1},fileId:{type:e.String_unsecure(),isOptional:!1}}}),r=t({name:`SourceRef`,description:`Reference to a source document used to justify a rule version.`,fields:{sourceDocumentId:{type:e.String_unsecure(),isOptional:!1},excerpt:{type:e.String_unsecure(),isOptional:!0}}}),i=t({name:`Rule`,description:`Curated rule (stable identity) with topic + jurisdiction scope.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1}}}),a=t({name:`RuleVersion`,description:`A versioned rule content with source references and approval status.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},ruleId:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!1},content:{type:e.String_unsecure(),isOptional:!1},sourceRefs:{type:r,isArray:!0,isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},approvedBy:{type:e.String_unsecure(),isOptional:!0},approvedAt:{type:e.DateTime(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),o=t({name:`KBSnapshot`,description:`Published KB snapshot (as-of) referencing approved rule versions.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},asOfDate:{type:e.DateTime(),isOptional:!1},includedRuleVersionIds:{type:e.String_unsecure(),isArray:!0,isOptional:!1},publishedAt:{type:e.DateTime(),isOptional:!1}}});export{o as KBSnapshotModel,i as RuleModel,a as RuleVersionModel,n as SourceDocumentModel,r as SourceRefModel};
+import{l as e}from"../libs/schema/dist/ScalarTypeEnum.js";import{n as t}from"../libs/schema/dist/SchemaModel.js";import"../libs/schema/dist/index.js";const n=t({name:`SourceDocument`,description:`Immutable raw source document metadata referencing a stored file.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},authority:{type:e.String_unsecure(),isOptional:!1},title:{type:e.String_unsecure(),isOptional:!1},fetchedAt:{type:e.DateTime(),isOptional:!1},hash:{type:e.String_unsecure(),isOptional:!1},fileId:{type:e.String_unsecure(),isOptional:!1}}}),r=t({name:`SourceRef`,description:`Reference to a source document used to justify a rule version.`,fields:{sourceDocumentId:{type:e.String_unsecure(),isOptional:!1},excerpt:{type:e.String_unsecure(),isOptional:!0}}}),i=t({name:`Rule`,description:`Curated rule (stable identity) with topic + jurisdiction scope.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1}}}),a=t({name:`RuleVersion`,description:`A versioned rule content with source references and approval status.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},ruleId:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},topicKey:{type:e.String_unsecure(),isOptional:!1},version:{type:e.Int_unsecure(),isOptional:!1},content:{type:e.String_unsecure(),isOptional:!1},sourceRefs:{type:r,isArray:!0,isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},approvedBy:{type:e.String_unsecure(),isOptional:!0},approvedAt:{type:e.DateTime(),isOptional:!0},createdAt:{type:e.DateTime(),isOptional:!1}}}),o=t({name:`KBSnapshot`,description:`Published KB snapshot (as-of) referencing approved rule versions.`,fields:{id:{type:e.String_unsecure(),isOptional:!1},jurisdiction:{type:e.String_unsecure(),isOptional:!1},asOfDate:{type:e.DateTime(),isOptional:!1},includedRuleVersionIds:{type:e.String_unsecure(),isArray:!0,isOptional:!1},publishedAt:{type:e.DateTime(),isOptional:!1}}});export{o as KBSnapshotModel,i as RuleModel,a as RuleVersionModel,n as SourceDocumentModel,r as SourceRefModel};

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 KbSourceIngestedEvent: _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:`kb.source.ingested`,version:1,description:`Source document ingested (immutable).`,payload:t({name:`KbSourceIngestedPayload`,description:`Emitted when a source document is ingested.`,fields:{sourceDocumentId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},hash:{type:n.String_unsecure(),isOptional:!1}}})}),i=e({name:`kb.ruleVersion.created`,version:1,description:`Rule version created (draft).`,payload:t({name:`KbRuleVersionCreatedPayload`,description:`Emitted when a rule version draft is created.`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},ruleId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},status:{type:n.String_unsecure(),isOptional:!1}}})}),a=e({name:`kb.ruleVersion.approved`,version:1,description:`Rule version approved (human verified).`,payload:t({name:`KbRuleVersionApprovedPayload`,description:`Emitted when a rule version is approved.`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},approver:{type:n.String_unsecure(),isOptional:!1}}})}),o=e({name:`kb.snapshot.published`,version:1,description:`KB snapshot published.`,payload:t({name:`KbSnapshotPublishedPayload`,description:`Emitted when a KB snapshot is published.`,fields:{snapshotId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},includedRuleVersionsCount:{type:n.Int_unsecure(),isOptional:!1}}})});export{a as KbRuleVersionApprovedEvent,i as KbRuleVersionCreatedEvent,o as KbSnapshotPublishedEvent,r as KbSourceIngestedEvent};
+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:`kb.source.ingested`,version:1,description:`Source document ingested (immutable).`,payload:e({name:`KbSourceIngestedPayload`,description:`Emitted when a source document is ingested.`,fields:{sourceDocumentId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},hash:{type:n.String_unsecure(),isOptional:!1}}})}),i=t({name:`kb.ruleVersion.created`,version:1,description:`Rule version created (draft).`,payload:e({name:`KbRuleVersionCreatedPayload`,description:`Emitted when a rule version draft is created.`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},ruleId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},status:{type:n.String_unsecure(),isOptional:!1}}})}),a=t({name:`kb.ruleVersion.approved`,version:1,description:`Rule version approved (human verified).`,payload:e({name:`KbRuleVersionApprovedPayload`,description:`Emitted when a rule version is approved.`,fields:{ruleVersionId:{type:n.String_unsecure(),isOptional:!1},approver:{type:n.String_unsecure(),isOptional:!1}}})}),o=t({name:`kb.snapshot.published`,version:1,description:`KB snapshot published.`,payload:e({name:`KbSnapshotPublishedPayload`,description:`Emitted when a KB snapshot is published.`,fields:{snapshotId:{type:n.String_unsecure(),isOptional:!1},jurisdiction:{type:n.String_unsecure(),isOptional:!1},includedRuleVersionsCount:{type:n.Int_unsecure(),isOptional:!1}}})});export{a as KbRuleVersionApprovedEvent,i as KbRuleVersionCreatedEvent,o as KbSnapshotPublishedEvent,r as KbSourceIngestedEvent};

package/dist/index.d.ts

@@ -1,7 +1,5 @@
 import { KbApproveRuleVersionContract, KbIngestSourceContract, KbPublishSnapshotContract, KbSearchContract, KbUpsertRuleVersionContract } from "./contracts/kb.js";
-import "./contracts/index.js";
 import { KBSnapshotModel, RuleModel, RuleVersionModel, SourceDocumentModel, SourceRefModel } from "./entities/models.js";
-import "./entities/index.js";
 import { KbRuleVersionApprovedEvent, KbRuleVersionCreatedEvent, KbSnapshotPublishedEvent, KbSourceIngestedEvent } from "./events.js";
 import example from "./example.js";
 import { MemoryKbHandlers, MemoryKbStore, createMemoryKbHandlers, createMemoryKbStore } from "./handlers/memory.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.
+`}]);