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

package/dist/entities/models.d.ts

@@ -1,135 +1,135 @@
-import * as _lssm_lib_schema74 from "@lssm/lib.schema";
+import * as _lssm_lib_schema16 from "@lssm/lib.schema";
 
 //#region src/entities/models.d.ts
-declare const AllowedScopeEnum: _lssm_lib_schema74.EnumType<[string, string, string]>;
-declare const UserProfileModel: _lssm_lib_schema74.SchemaModel<{
+declare const AllowedScopeEnum: _lssm_lib_schema16.EnumType<[string, string, string]>;
+declare const UserProfileModel: _lssm_lib_schema16.SchemaModel<{
   preferredLocale: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: true;
   };
   residencyCountry: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: true;
   };
   taxResidenceCountry: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: true;
   };
   clientType: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: true;
   };
 }>;
-declare const RegulatoryContextModel: _lssm_lib_schema74.SchemaModel<{
+declare const RegulatoryContextModel: _lssm_lib_schema16.SchemaModel<{
   jurisdiction: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   region: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: true;
   };
   clientType: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: true;
   };
   allowedScope: {
-    type: _lssm_lib_schema74.EnumType<[string, string, string]>;
+    type: _lssm_lib_schema16.EnumType<[string, string, string]>;
     isOptional: false;
   };
 }>;
-declare const LLMCallEnvelopeModel: _lssm_lib_schema74.SchemaModel<{
+declare const LLMCallEnvelopeModel: _lssm_lib_schema16.SchemaModel<{
   traceId: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   locale: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   regulatoryContext: {
-    type: _lssm_lib_schema74.SchemaModel<{
+    type: _lssm_lib_schema16.SchemaModel<{
       jurisdiction: {
-        type: _lssm_lib_schema74.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       region: {
-        type: _lssm_lib_schema74.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: true;
       };
       clientType: {
-        type: _lssm_lib_schema74.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: true;
       };
       allowedScope: {
-        type: _lssm_lib_schema74.EnumType<[string, string, string]>;
+        type: _lssm_lib_schema16.EnumType<[string, string, string]>;
         isOptional: false;
       };
     }>;
     isOptional: false;
   };
   kbSnapshotId: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   allowedScope: {
-    type: _lssm_lib_schema74.EnumType<[string, string, string]>;
+    type: _lssm_lib_schema16.EnumType<[string, string, string]>;
     isOptional: false;
   };
 }>;
-declare const AssistantCitationModel: _lssm_lib_schema74.SchemaModel<{
+declare const AssistantCitationModel: _lssm_lib_schema16.SchemaModel<{
   kbSnapshotId: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   sourceType: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   sourceId: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   title: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: true;
   };
   excerpt: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: true;
   };
 }>;
-declare const AssistantAnswerSectionModel: _lssm_lib_schema74.SchemaModel<{
+declare const AssistantAnswerSectionModel: _lssm_lib_schema16.SchemaModel<{
   heading: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   body: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
 }>;
-declare const AssistantAnswerIRModel: _lssm_lib_schema74.SchemaModel<{
+declare const AssistantAnswerIRModel: _lssm_lib_schema16.SchemaModel<{
   locale: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   jurisdiction: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: false;
   };
   allowedScope: {
-    type: _lssm_lib_schema74.EnumType<[string, string, string]>;
+    type: _lssm_lib_schema16.EnumType<[string, string, string]>;
     isOptional: false;
   };
   sections: {
-    type: _lssm_lib_schema74.SchemaModel<{
+    type: _lssm_lib_schema16.SchemaModel<{
       heading: {
-        type: _lssm_lib_schema74.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       body: {
-        type: _lssm_lib_schema74.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
     }>;
@@ -137,25 +137,25 @@ declare const AssistantAnswerIRModel: _lssm_lib_schema74.SchemaModel<{
     isOptional: false;
   };
   citations: {
-    type: _lssm_lib_schema74.SchemaModel<{
+    type: _lssm_lib_schema16.SchemaModel<{
       kbSnapshotId: {
-        type: _lssm_lib_schema74.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       sourceType: {
-        type: _lssm_lib_schema74.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       sourceId: {
-        type: _lssm_lib_schema74.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: false;
       };
       title: {
-        type: _lssm_lib_schema74.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: true;
       };
       excerpt: {
-        type: _lssm_lib_schema74.FieldType<string, string>;
+        type: _lssm_lib_schema16.FieldType<string, string>;
         isOptional: true;
       };
     }>;
@@ -163,21 +163,21 @@ declare const AssistantAnswerIRModel: _lssm_lib_schema74.SchemaModel<{
     isOptional: false;
   };
   disclaimers: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isArray: true;
     isOptional: true;
   };
   riskFlags: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isArray: true;
     isOptional: true;
   };
   refused: {
-    type: _lssm_lib_schema74.FieldType<boolean, boolean>;
+    type: _lssm_lib_schema16.FieldType<boolean, boolean>;
     isOptional: true;
   };
   refusalReason: {
-    type: _lssm_lib_schema74.FieldType<string, string>;
+    type: _lssm_lib_schema16.FieldType<string, string>;
     isOptional: true;
   };
 }>;

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.
+`}]);