@lssm/example.locale-jurisdiction-gate 0.0.0-canary-20251220002821 → 0.0.0-canary-20251220021406

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

@@ -9,7 +9,7 @@ $ tsdown
 ℹ dist/entities/models.js                                                              3.55 kB │ gzip:  0.82 kB
 ℹ dist/contracts/assistant.js                                                          3.18 kB │ gzip:  1.05 kB
 ℹ dist/events.js                                                                       2.57 kB │ gzip:  0.58 kB
-ℹ dist/handlers/demo.handlers.js                                                       2.41 kB │ gzip:  0.90 kB
+ℹ dist/handlers/demo.handlers.js                                                       2.46 kB │ gzip:  0.90 kB
 ℹ dist/policy/guard.js                                                                 1.90 kB │ gzip:  0.76 kB
 ℹ dist/docs/locale-jurisdiction-gate.docblock.js                                       1.69 kB │ gzip:  0.76 kB
 ℹ dist/index.js                                                                        1.27 kB │ gzip:  0.40 kB
@@ -46,9 +46,9 @@ $ tsdown
 ℹ dist/libs/contracts/dist/knowledge/contracts.js                                      6.68 kB │ gzip:  1.33 kB
 ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js.map                 6.33 kB │ gzip:  2.84 kB
 ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js.map                6.17 kB │ gzip:  2.52 kB
+ℹ dist/handlers/demo.handlers.js.map                                                   5.97 kB │ gzip:  1.81 kB
 ℹ dist/entities/models.js.map                                                          5.92 kB │ gzip:  1.22 kB
 ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js                     5.90 kB │ gzip:  2.68 kB
-ℹ dist/handlers/demo.handlers.js.map                                                   5.78 kB │ gzip:  1.76 kB
 ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js                    5.71 kB │ gzip:  2.36 kB
 ℹ dist/libs/contracts/dist/integrations/openbanking/contracts/accounts.js              5.63 kB │ gzip:  1.50 kB
 ℹ dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js.map                  5.10 kB │ gzip:  1.98 kB
@@ -127,7 +127,7 @@ $ tsdown
 ℹ dist/libs/contracts/dist/integrations/providers/twilio-sms.js                        1.56 kB │ gzip:  0.73 kB
 ℹ dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js                         1.51 kB │ gzip:  0.79 kB
 ℹ dist/libs/contracts/dist/integrations/providers/elevenlabs.js                        1.47 kB │ gzip:  0.72 kB
-ℹ dist/libs/contracts/dist/ownership.js.map                                            1.41 kB │ gzip:  0.61 kB
+ℹ dist/libs/contracts/dist/ownership.js.map                                            1.47 kB │ gzip:  0.63 kB
 ℹ dist/libs/contracts/dist/docs/meta.docs.js.map                                       1.38 kB │ gzip:  0.78 kB
 ℹ dist/libs/contracts/dist/docs/index.js                                               1.38 kB │ gzip:  0.43 kB
 ℹ dist/example.js.map                                                                  1.33 kB │ gzip:  0.68 kB
@@ -145,8 +145,8 @@ $ tsdown
 ℹ dist/libs/contracts/dist/integrations/index.js                                       0.78 kB │ gzip:  0.27 kB
 ℹ dist/policy/guard.d.ts.map                                                           0.76 kB │ gzip:  0.39 kB
 ℹ dist/libs/contracts/dist/spec.js                                                     0.68 kB │ gzip:  0.33 kB
+ℹ dist/libs/contracts/dist/ownership.js                                                0.68 kB │ gzip:  0.34 kB
 ℹ dist/contracts/assistant.d.ts.map                                                    0.67 kB │ gzip:  0.28 kB
-ℹ dist/libs/contracts/dist/ownership.js                                                0.64 kB │ gzip:  0.33 kB
 ℹ dist/libs/contracts/dist/integrations/openbanking/telemetry.js                       0.60 kB │ gzip:  0.28 kB
 ℹ dist/events.d.ts.map                                                                 0.57 kB │ gzip:  0.25 kB
 ℹ dist/libs/contracts/dist/events.js.map                                               0.53 kB │ gzip:  0.35 kB
@@ -214,33 +214,13 @@ $ tsdown
 ℹ 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
-ℹ 208 files, total: 1262.82 kB
-[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:crypto' in ../../libs/contracts/dist/workflow/runner.js
-   ╭─[ ../../libs/contracts/dist/workflow/runner.js:2:28 ]
-   │
- 2 │ import { randomUUID } from "node:crypto";
-   │                            ──────┬──────  
-   │                                  ╰──────── Module not found, treating it as an external dependency
-   │ 
-   │ 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
-   ╭─[ ../../libs/contracts/dist/experiments/evaluator.js:1:28 ]
-   │
- 1 │ import { createHash } from "node:crypto";
-   │                            ──────┬──────  
-   │                                  ╰──────── Module not found, treating it as an external dependency
-   │ 
-   │ 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
-   ╭─[ ../../libs/contracts/dist/regenerator/service.js:2:28 ]
+ℹ 208 files, total: 1263.15 kB
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'turndown' in ../../libs/contracts/dist/presentations.v2.js
+   ╭─[ ../../libs/contracts/dist/presentations.v2.js:3:29 ]
    │
- 2 │ import { setTimeout } from "node:timers/promises";
-   │                            ───────────┬──────────  
-   │                                       ╰──────────── Module not found, treating it as an external dependency
+ 3 │ import TurndownService from "turndown";
+   │                             ─────┬────  
+   │                                  ╰────── Module not found, treating it as an external dependency
    │ 
    │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
 ───╯
@@ -265,12 +245,32 @@ $ tsdown
    │ 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
-   ╭─[ ../../libs/contracts/dist/presentations.v2.js:3:29 ]
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:crypto' in ../../libs/contracts/dist/experiments/evaluator.js
+   ╭─[ ../../libs/contracts/dist/experiments/evaluator.js:1:28 ]
    │
- 3 │ import TurndownService from "turndown";
-   │                             ─────┬────  
-   │                                  ╰────── Module not found, treating it as an external dependency
+ 1 │ import { createHash } from "node:crypto";
+   │                            ──────┬──────  
+   │                                  ╰──────── Module not found, treating it as an external dependency
+   │ 
+   │ 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
+   ╭─[ ../../libs/contracts/dist/workflow/runner.js:2:28 ]
+   │
+ 2 │ import { randomUUID } from "node:crypto";
+   │                            ──────┬──────  
+   │                                  ╰──────── Module not found, treating it as an external dependency
+   │ 
+   │ 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
+   ╭─[ ../../libs/contracts/dist/regenerator/service.js:2:28 ]
+   │
+ 2 │ import { setTimeout } from "node:timers/promises";
+   │                            ───────────┬──────────  
+   │                                       ╰──────────── Module not found, treating it as an external dependency
    │ 
    │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
 ───╯
@@ -285,4 +285,4 @@ $ tsdown
    │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
 ───╯
 
-✔ Build complete in 46932ms
+✔ Build complete in 49555ms

package/.turbo/turbo-build.log

@@ -9,7 +9,7 @@ $ tsdown
 ℹ dist/entities/models.js                                                              3.55 kB │ gzip:  0.82 kB
 ℹ dist/contracts/assistant.js                                                          3.18 kB │ gzip:  1.05 kB
 ℹ dist/events.js                                                                       2.57 kB │ gzip:  0.58 kB
-ℹ dist/handlers/demo.handlers.js                                                       2.41 kB │ gzip:  0.90 kB
+ℹ dist/handlers/demo.handlers.js                                                       2.46 kB │ gzip:  0.90 kB
 ℹ dist/policy/guard.js                                                                 1.90 kB │ gzip:  0.76 kB
 ℹ dist/docs/locale-jurisdiction-gate.docblock.js                                       1.69 kB │ gzip:  0.76 kB
 ℹ dist/index.js                                                                        1.27 kB │ gzip:  0.40 kB
@@ -46,9 +46,9 @@ $ tsdown
 ℹ dist/libs/contracts/dist/knowledge/contracts.js                                      6.68 kB │ gzip:  1.33 kB
 ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js.map                 6.33 kB │ gzip:  2.84 kB
 ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js.map                6.17 kB │ gzip:  2.52 kB
+ℹ dist/handlers/demo.handlers.js.map                                                   5.97 kB │ gzip:  1.81 kB
 ℹ dist/entities/models.js.map                                                          5.92 kB │ gzip:  1.22 kB
 ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js                     5.90 kB │ gzip:  2.68 kB
-ℹ dist/handlers/demo.handlers.js.map                                                   5.78 kB │ gzip:  1.76 kB
 ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js                    5.71 kB │ gzip:  2.36 kB
 ℹ dist/libs/contracts/dist/integrations/openbanking/contracts/accounts.js              5.63 kB │ gzip:  1.50 kB
 ℹ dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js.map                  5.10 kB │ gzip:  1.98 kB
@@ -127,7 +127,7 @@ $ tsdown
 ℹ dist/libs/contracts/dist/integrations/providers/twilio-sms.js                        1.56 kB │ gzip:  0.73 kB
 ℹ dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js                         1.51 kB │ gzip:  0.79 kB
 ℹ dist/libs/contracts/dist/integrations/providers/elevenlabs.js                        1.47 kB │ gzip:  0.72 kB
-ℹ dist/libs/contracts/dist/ownership.js.map                                            1.41 kB │ gzip:  0.61 kB
+ℹ dist/libs/contracts/dist/ownership.js.map                                            1.47 kB │ gzip:  0.63 kB
 ℹ dist/libs/contracts/dist/docs/meta.docs.js.map                                       1.38 kB │ gzip:  0.78 kB
 ℹ dist/libs/contracts/dist/docs/index.js                                               1.38 kB │ gzip:  0.43 kB
 ℹ dist/example.js.map                                                                  1.33 kB │ gzip:  0.68 kB
@@ -145,10 +145,10 @@ $ tsdown
 ℹ dist/libs/contracts/dist/integrations/index.js                                       0.78 kB │ gzip:  0.27 kB
 ℹ dist/policy/guard.d.ts.map                                                           0.76 kB │ gzip:  0.39 kB
 ℹ dist/libs/contracts/dist/spec.js                                                     0.68 kB │ gzip:  0.33 kB
+ℹ dist/libs/contracts/dist/ownership.js                                                0.68 kB │ gzip:  0.34 kB
 ℹ dist/contracts/assistant.d.ts.map                                                    0.67 kB │ gzip:  0.28 kB
-ℹ dist/libs/contracts/dist/ownership.js                                                0.64 kB │ gzip:  0.33 kB
 ℹ dist/libs/contracts/dist/integrations/openbanking/telemetry.js                       0.60 kB │ gzip:  0.28 kB
-ℹ dist/events.d.ts.map                                                                 0.57 kB │ gzip:  0.25 kB
+ℹ dist/events.d.ts.map                                                                 0.57 kB │ gzip:  0.26 kB
 ℹ dist/libs/contracts/dist/events.js.map                                               0.53 kB │ gzip:  0.35 kB
 ℹ dist/libs/contracts/dist/llm/exporters.js                                            0.46 kB │ gzip:  0.26 kB
 ℹ dist/handlers/demo.handlers.d.ts.map                                                 0.45 kB │ gzip:  0.26 kB
@@ -201,7 +201,7 @@ $ tsdown
 ℹ dist/libs/contracts/dist/resources.js                                                0.01 kB │ gzip:  0.03 kB
 ℹ dist/contracts/assistant.d.ts                                                        6.77 kB │ gzip:  0.62 kB
 ℹ dist/entities/models.d.ts                                                            5.04 kB │ gzip:  0.67 kB
-ℹ dist/events.d.ts                                                                     2.03 kB │ gzip:  0.38 kB
+ℹ dist/events.d.ts                                                                     2.05 kB │ gzip:  0.38 kB
 ℹ dist/handlers/demo.handlers.d.ts                                                     1.48 kB │ gzip:  0.55 kB
 ℹ dist/index.d.ts                                                                      1.31 kB │ gzip:  0.40 kB
 ℹ dist/example.d.ts                                                                    1.19 kB │ gzip:  0.49 kB
@@ -214,7 +214,7 @@ $ tsdown
 ℹ 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
-ℹ 208 files, total: 1262.79 kB
+ℹ 208 files, total: 1263.14 kB
 [UNRESOLVED_IMPORT] Warning: Could not resolve 'turndown' in ../../libs/contracts/dist/presentations.v2.js
    ╭─[ ../../libs/contracts/dist/presentations.v2.js:3:29 ]
    │
@@ -225,20 +225,20 @@ $ tsdown
    │ 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
-   ╭─[ ../../libs/contracts/dist/tests/runner.js:2:33 ]
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:timers/promises' in ../../libs/contracts/dist/regenerator/service.js
+   ╭─[ ../../libs/contracts/dist/regenerator/service.js:2:28 ]
    │
- 2 │ import { deepStrictEqual } from "node:assert";
-   │                                 ──────┬──────  
-   │                                       ╰──────── Module not found, treating it as an external dependency
+ 2 │ import { setTimeout } from "node:timers/promises";
+   │                            ───────────┬──────────  
+   │                                       ╰──────────── Module not found, treating it as an external dependency
    │ 
    │ 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
-   ╭─[ ../../libs/contracts/dist/experiments/evaluator.js:1:28 ]
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:crypto' in ../../libs/contracts/dist/workflow/runner.js
+   ╭─[ ../../libs/contracts/dist/workflow/runner.js:2:28 ]
    │
- 1 │ import { createHash } from "node:crypto";
+ 2 │ import { randomUUID } from "node:crypto";
    │                            ──────┬──────  
    │                                  ╰──────── Module not found, treating it as an external dependency
    │ 
@@ -255,20 +255,20 @@ $ tsdown
    │ 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
-   ╭─[ ../../libs/contracts/dist/regenerator/service.js:2:28 ]
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:assert' in ../../libs/contracts/dist/tests/runner.js
+   ╭─[ ../../libs/contracts/dist/tests/runner.js:2:33 ]
    │
- 2 │ import { setTimeout } from "node:timers/promises";
-   │                            ───────────┬──────────  
-   │                                       ╰──────────── Module not found, treating it as an external dependency
+ 2 │ import { deepStrictEqual } from "node:assert";
+   │                                 ──────┬──────  
+   │                                       ╰──────── Module not found, treating it as an external dependency
    │ 
    │ 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
-   ╭─[ ../../libs/contracts/dist/workflow/runner.js:2:28 ]
+[UNRESOLVED_IMPORT] Warning: Could not resolve 'node:crypto' in ../../libs/contracts/dist/experiments/evaluator.js
+   ╭─[ ../../libs/contracts/dist/experiments/evaluator.js:1:28 ]
    │
- 2 │ import { randomUUID } from "node:crypto";
+ 1 │ import { createHash } from "node:crypto";
    │                            ──────┬──────  
    │                                  ╰──────── Module not found, treating it as an external dependency
    │ 
@@ -285,5 +285,5 @@ $ tsdown
    │ Help: The "main" field here was ignored. Main fields must be configured explicitly when using the "neutral" platform.
 ───╯
 
-✔ Build complete in 88268ms
+✔ Build complete in 49862ms
 $ tsc --noEmit

package/CHANGELOG.md

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

package/dist/handlers/demo.handlers.js

@@ -27,14 +27,14 @@ function createDemoAssistantHandlers() {
 		};
 		const draft = {
 			locale: env.value.locale,
-			jurisdiction: env.value.regulatoryContext.jurisdiction,
-			allowedScope: env.value.allowedScope,
+			jurisdiction: env.value.regulatoryContext?.jurisdiction ?? "UNKNOWN",
+			allowedScope: env.value.allowedScope ?? "education_only",
 			sections: [{
 				heading: "Answer (demo)",
 				body: `You asked: "${input.question}". This demo answer is derived from the KB snapshot only.`
 			}],
 			citations: [{
-				kbSnapshotId: env.value.kbSnapshotId,
+				kbSnapshotId: env.value.kbSnapshotId ?? "unknown",
 				sourceType: "ruleVersion",
 				sourceId: "rv_demo",
 				title: "Demo rule version",

package/dist/handlers/demo.handlers.js.map

@@ -1 +1 @@
-{"version":3,"file":"demo.handlers.js","names":["draft: AssistantAnswerIR"],"sources":["../../src/handlers/demo.handlers.ts"],"sourcesContent":["import {\n  enforceAllowedScope,\n  enforceCitations,\n  validateEnvelope,\n} from '../policy/guard';\n\ntype AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';\n\ninterface AssistantAnswerIR {\n  locale: string;\n  jurisdiction: string;\n  allowedScope: AllowedScope;\n  sections: { heading: string; body: string }[];\n  citations: {\n    kbSnapshotId: string;\n    sourceType: string;\n    sourceId: string;\n    title?: string;\n    excerpt?: string;\n  }[];\n  disclaimers?: string[];\n  riskFlags?: string[];\n  refused?: boolean;\n  refusalReason?: string;\n}\n\nexport interface DemoAssistantHandlers {\n  answer(input: {\n    envelope: {\n      traceId: string;\n      locale: string;\n      kbSnapshotId: string;\n      allowedScope: AllowedScope;\n      regulatoryContext: { jurisdiction: string };\n    };\n    question: string;\n  }): Promise<AssistantAnswerIR>;\n\n  explainConcept(input: {\n    envelope: {\n      traceId: string;\n      locale: string;\n      kbSnapshotId: string;\n      allowedScope: AllowedScope;\n      regulatoryContext: { jurisdiction: string };\n    };\n    conceptKey: string;\n  }): Promise<AssistantAnswerIR>;\n}\n\n/**\n * Deterministic demo assistant handlers (no LLM).\n *\n * - Validates envelope\n * - Requires citations\n * - Enforces allowedScope (education_only blocks actionable language)\n */\nexport function createDemoAssistantHandlers(): DemoAssistantHandlers {\n  async function answer(input: {\n    envelope: DemoAssistantHandlers['answer'] extends (a: infer A) => any\n      ? A extends { envelope: infer E }\n        ? E\n        : never\n      : never;\n    question: string;\n  }): Promise<AssistantAnswerIR> {\n    const env = validateEnvelope(input.envelope);\n    if (!env.ok) {\n      return {\n        locale: input.envelope.locale ?? 'en-US',\n        jurisdiction:\n          input.envelope.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n        allowedScope: input.envelope.allowedScope ?? 'education_only',\n        sections: [\n          {\n            heading: 'Request blocked',\n            body: env.error.message,\n          },\n        ],\n        citations: [],\n        disclaimers: [\n          'This system refuses to answer without a valid envelope.',\n        ],\n        riskFlags: [env.error.code],\n        refused: true,\n        refusalReason: env.error.code,\n      };\n    }\n\n    const draft: AssistantAnswerIR = {\n      locale: env.value.locale,\n      jurisdiction: env.value.regulatoryContext!.jurisdiction!,\n      allowedScope: env.value.allowedScope!,\n      sections: [\n        {\n          heading: 'Answer (demo)',\n          body: `You asked: \"${input.question}\". This demo answer is derived from the KB snapshot only.`,\n        },\n      ],\n      citations: [\n        {\n          kbSnapshotId: env.value.kbSnapshotId!,\n          sourceType: 'ruleVersion',\n          sourceId: 'rv_demo',\n          title: 'Demo rule version',\n          excerpt: 'Demo excerpt',\n        },\n      ],\n      disclaimers: ['Educational demo only.'],\n      riskFlags: [],\n    };\n\n    const scope = enforceAllowedScope(env.value.allowedScope, draft);\n    if (!scope.ok) {\n      return {\n        ...draft,\n        sections: [\n          { heading: 'Escalation required', body: scope.error.message },\n        ],\n        citations: draft.citations,\n        refused: true,\n        refusalReason: scope.error.code,\n        riskFlags: [...(draft.riskFlags ?? []), scope.error.code],\n      };\n    }\n\n    const cited = enforceCitations(draft);\n    if (!cited.ok) {\n      return {\n        ...draft,\n        sections: [{ heading: 'Request blocked', body: cited.error.message }],\n        citations: [],\n        refused: true,\n        refusalReason: cited.error.code,\n        riskFlags: [...(draft.riskFlags ?? []), cited.error.code],\n      };\n    }\n\n    return draft;\n  }\n\n  async function explainConcept(input: {\n    envelope: DemoAssistantHandlers['explainConcept'] extends (\n      a: infer A\n    ) => any\n      ? A extends { envelope: infer E }\n        ? E\n        : never\n      : never;\n    conceptKey: string;\n  }): Promise<AssistantAnswerIR> {\n    return await answer({\n      envelope: input.envelope,\n      question: `Explain concept: ${input.conceptKey}`,\n    });\n  }\n\n  return { answer, explainConcept };\n}\n"],"mappings":";;;;;;;;;;AAyDA,SAAgB,8BAAqD;CACnE,eAAe,OAAO,OAOS;EAC7B,MAAM,MAAM,iBAAiB,MAAM,SAAS;AAC5C,MAAI,CAAC,IAAI,GACP,QAAO;GACL,QAAQ,MAAM,SAAS,UAAU;GACjC,cACE,MAAM,SAAS,mBAAmB,gBAAgB;GACpD,cAAc,MAAM,SAAS,gBAAgB;GAC7C,UAAU,CACR;IACE,SAAS;IACT,MAAM,IAAI,MAAM;IACjB,CACF;GACD,WAAW,EAAE;GACb,aAAa,CACX,0DACD;GACD,WAAW,CAAC,IAAI,MAAM,KAAK;GAC3B,SAAS;GACT,eAAe,IAAI,MAAM;GAC1B;EAGH,MAAMA,QAA2B;GAC/B,QAAQ,IAAI,MAAM;GAClB,cAAc,IAAI,MAAM,kBAAmB;GAC3C,cAAc,IAAI,MAAM;GACxB,UAAU,CACR;IACE,SAAS;IACT,MAAM,eAAe,MAAM,SAAS;IACrC,CACF;GACD,WAAW,CACT;IACE,cAAc,IAAI,MAAM;IACxB,YAAY;IACZ,UAAU;IACV,OAAO;IACP,SAAS;IACV,CACF;GACD,aAAa,CAAC,yBAAyB;GACvC,WAAW,EAAE;GACd;EAED,MAAM,QAAQ,oBAAoB,IAAI,MAAM,cAAc,MAAM;AAChE,MAAI,CAAC,MAAM,GACT,QAAO;GACL,GAAG;GACH,UAAU,CACR;IAAE,SAAS;IAAuB,MAAM,MAAM,MAAM;IAAS,CAC9D;GACD,WAAW,MAAM;GACjB,SAAS;GACT,eAAe,MAAM,MAAM;GAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;GAC1D;EAGH,MAAM,QAAQ,iBAAiB,MAAM;AACrC,MAAI,CAAC,MAAM,GACT,QAAO;GACL,GAAG;GACH,UAAU,CAAC;IAAE,SAAS;IAAmB,MAAM,MAAM,MAAM;IAAS,CAAC;GACrE,WAAW,EAAE;GACb,SAAS;GACT,eAAe,MAAM,MAAM;GAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;GAC1D;AAGH,SAAO;;CAGT,eAAe,eAAe,OASC;AAC7B,SAAO,MAAM,OAAO;GAClB,UAAU,MAAM;GAChB,UAAU,oBAAoB,MAAM;GACrC,CAAC;;AAGJ,QAAO;EAAE;EAAQ;EAAgB"}
+{"version":3,"file":"demo.handlers.js","names":["draft: AssistantAnswerIR"],"sources":["../../src/handlers/demo.handlers.ts"],"sourcesContent":["import {\n  enforceAllowedScope,\n  enforceCitations,\n  validateEnvelope,\n} from '../policy/guard';\n\ntype AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';\n\ninterface AssistantAnswerIR {\n  locale: string;\n  jurisdiction: string;\n  allowedScope: AllowedScope;\n  sections: { heading: string; body: string }[];\n  citations: {\n    kbSnapshotId: string;\n    sourceType: string;\n    sourceId: string;\n    title?: string;\n    excerpt?: string;\n  }[];\n  disclaimers?: string[];\n  riskFlags?: string[];\n  refused?: boolean;\n  refusalReason?: string;\n}\n\nexport interface DemoAssistantHandlers {\n  answer(input: {\n    envelope: {\n      traceId: string;\n      locale: string;\n      kbSnapshotId: string;\n      allowedScope: AllowedScope;\n      regulatoryContext: { jurisdiction: string };\n    };\n    question: string;\n  }): Promise<AssistantAnswerIR>;\n\n  explainConcept(input: {\n    envelope: {\n      traceId: string;\n      locale: string;\n      kbSnapshotId: string;\n      allowedScope: AllowedScope;\n      regulatoryContext: { jurisdiction: string };\n    };\n    conceptKey: string;\n  }): Promise<AssistantAnswerIR>;\n}\n\n/**\n * Deterministic demo assistant handlers (no LLM).\n *\n * - Validates envelope\n * - Requires citations\n * - Enforces allowedScope (education_only blocks actionable language)\n */\nexport function createDemoAssistantHandlers(): DemoAssistantHandlers {\n  async function answer(input: {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    envelope: DemoAssistantHandlers['answer'] extends (a: infer A) => any\n      ? A extends { envelope: infer E }\n        ? E\n        : never\n      : never;\n    question: string;\n  }): Promise<AssistantAnswerIR> {\n    const env = validateEnvelope(input.envelope);\n    if (!env.ok) {\n      return {\n        locale: input.envelope.locale ?? 'en-US',\n        jurisdiction:\n          input.envelope.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n        allowedScope: input.envelope.allowedScope ?? 'education_only',\n        sections: [\n          {\n            heading: 'Request blocked',\n            body: env.error.message,\n          },\n        ],\n        citations: [],\n        disclaimers: [\n          'This system refuses to answer without a valid envelope.',\n        ],\n        riskFlags: [env.error.code],\n        refused: true,\n        refusalReason: env.error.code,\n      };\n    }\n\n    const draft: AssistantAnswerIR = {\n      locale: env.value.locale,\n      jurisdiction: env.value.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n      allowedScope: env.value.allowedScope ?? 'education_only',\n      sections: [\n        {\n          heading: 'Answer (demo)',\n          body: `You asked: \"${input.question}\". This demo answer is derived from the KB snapshot only.`,\n        },\n      ],\n      citations: [\n        {\n          kbSnapshotId: env.value.kbSnapshotId ?? 'unknown',\n          sourceType: 'ruleVersion',\n          sourceId: 'rv_demo',\n          title: 'Demo rule version',\n          excerpt: 'Demo excerpt',\n        },\n      ],\n      disclaimers: ['Educational demo only.'],\n      riskFlags: [],\n    };\n\n    const scope = enforceAllowedScope(env.value.allowedScope, draft);\n    if (!scope.ok) {\n      return {\n        ...draft,\n        sections: [\n          { heading: 'Escalation required', body: scope.error.message },\n        ],\n        citations: draft.citations,\n        refused: true,\n        refusalReason: scope.error.code,\n        riskFlags: [...(draft.riskFlags ?? []), scope.error.code],\n      };\n    }\n\n    const cited = enforceCitations(draft);\n    if (!cited.ok) {\n      return {\n        ...draft,\n        sections: [{ heading: 'Request blocked', body: cited.error.message }],\n        citations: [],\n        refused: true,\n        refusalReason: cited.error.code,\n        riskFlags: [...(draft.riskFlags ?? []), cited.error.code],\n      };\n    }\n\n    return draft;\n  }\n\n  async function explainConcept(input: {\n    envelope: DemoAssistantHandlers['explainConcept'] extends (\n      a: infer A\n    ) => any // eslint-disable-line @typescript-eslint/no-explicit-any\n      ? A extends { envelope: infer E }\n        ? E\n        : never\n      : never;\n    conceptKey: string;\n  }): Promise<AssistantAnswerIR> {\n    return await answer({\n      envelope: input.envelope,\n      question: `Explain concept: ${input.conceptKey}`,\n    });\n  }\n\n  return { answer, explainConcept };\n}\n"],"mappings":";;;;;;;;;;AAyDA,SAAgB,8BAAqD;CACnE,eAAe,OAAO,OAQS;EAC7B,MAAM,MAAM,iBAAiB,MAAM,SAAS;AAC5C,MAAI,CAAC,IAAI,GACP,QAAO;GACL,QAAQ,MAAM,SAAS,UAAU;GACjC,cACE,MAAM,SAAS,mBAAmB,gBAAgB;GACpD,cAAc,MAAM,SAAS,gBAAgB;GAC7C,UAAU,CACR;IACE,SAAS;IACT,MAAM,IAAI,MAAM;IACjB,CACF;GACD,WAAW,EAAE;GACb,aAAa,CACX,0DACD;GACD,WAAW,CAAC,IAAI,MAAM,KAAK;GAC3B,SAAS;GACT,eAAe,IAAI,MAAM;GAC1B;EAGH,MAAMA,QAA2B;GAC/B,QAAQ,IAAI,MAAM;GAClB,cAAc,IAAI,MAAM,mBAAmB,gBAAgB;GAC3D,cAAc,IAAI,MAAM,gBAAgB;GACxC,UAAU,CACR;IACE,SAAS;IACT,MAAM,eAAe,MAAM,SAAS;IACrC,CACF;GACD,WAAW,CACT;IACE,cAAc,IAAI,MAAM,gBAAgB;IACxC,YAAY;IACZ,UAAU;IACV,OAAO;IACP,SAAS;IACV,CACF;GACD,aAAa,CAAC,yBAAyB;GACvC,WAAW,EAAE;GACd;EAED,MAAM,QAAQ,oBAAoB,IAAI,MAAM,cAAc,MAAM;AAChE,MAAI,CAAC,MAAM,GACT,QAAO;GACL,GAAG;GACH,UAAU,CACR;IAAE,SAAS;IAAuB,MAAM,MAAM,MAAM;IAAS,CAC9D;GACD,WAAW,MAAM;GACjB,SAAS;GACT,eAAe,MAAM,MAAM;GAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;GAC1D;EAGH,MAAM,QAAQ,iBAAiB,MAAM;AACrC,MAAI,CAAC,MAAM,GACT,QAAO;GACL,GAAG;GACH,UAAU,CAAC;IAAE,SAAS;IAAmB,MAAM,MAAM,MAAM;IAAS,CAAC;GACrE,WAAW,EAAE;GACb,SAAS;GACT,eAAe,MAAM,MAAM;GAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;GAC1D;AAGH,SAAO;;CAGT,eAAe,eAAe,OASC;AAC7B,SAAO,MAAM,OAAO;GAClB,UAAU,MAAM;GAChB,UAAU,oBAAoB,MAAM;GACrC,CAAC;;AAGJ,QAAO;EAAE;EAAQ;EAAgB"}

package/dist/libs/contracts/dist/ownership.js

@@ -13,6 +13,7 @@ const OwnersEnum = {
 	ProductArtisanos: "product.artisanos",
 	PlatformSigil: "platform.sigil",
 	PlatformMarketplace: "platform.marketplace",
+	PlatformMessaging: "platform.messaging",
 	PlatformContent: "platform.content",
 	PlatformFeatureFlags: "platform.featureflags",
 	PlatformFinance: "platform.finance"

package/dist/libs/contracts/dist/ownership.js.map

@@ -1 +1 @@
-{"version":3,"file":"ownership.js","names":[],"sources":["../../../../../../libs/contracts/dist/ownership.js"],"sourcesContent":["//#region src/ownership.ts\nconst StabilityEnum = {\n\tIdea: \"idea\",\n\tInCreation: \"in_creation\",\n\tExperimental: \"experimental\",\n\tBeta: \"beta\",\n\tStable: \"stable\",\n\tDeprecated: \"deprecated\"\n};\nconst OwnersEnum = {\n\tProductColiving: \"product.coliving\",\n\tProductStrit: \"product.strit\",\n\tProductArtisanos: \"product.artisanos\",\n\tPlatformSigil: \"platform.sigil\",\n\tPlatformMarketplace: \"platform.marketplace\",\n\tPlatformContent: \"platform.content\",\n\tPlatformFeatureFlags: \"platform.featureflags\",\n\tPlatformFinance: \"platform.finance\"\n};\nconst Owners = OwnersEnum;\nconst TagsEnum = {\n\tSpots: \"spots\",\n\tCollectivity: \"collectivity\",\n\tMarketplace: \"marketplace\",\n\tSellers: \"sellers\",\n\tAuth: \"auth\",\n\tLogin: \"login\",\n\tSignup: \"signup\",\n\tGuide: \"guide\",\n\tDocs: \"docs\",\n\tI18n: \"i18n\",\n\tIncident: \"incident\",\n\tAutomation: \"automation\",\n\tHygiene: \"hygiene\"\n};\nconst Tags = TagsEnum;\n\n//#endregion\nexport { Owners, OwnersEnum, StabilityEnum, Tags, TagsEnum };"],"mappings":";AACA,MAAM,gBAAgB;CACrB,MAAM;CACN,YAAY;CACZ,cAAc;CACd,MAAM;CACN,QAAQ;CACR,YAAY;CACZ;AACD,MAAM,aAAa;CAClB,iBAAiB;CACjB,cAAc;CACd,kBAAkB;CAClB,eAAe;CACf,qBAAqB;CACrB,iBAAiB;CACjB,sBAAsB;CACtB,iBAAiB;CACjB"}
+{"version":3,"file":"ownership.js","names":[],"sources":["../../../../../../libs/contracts/dist/ownership.js"],"sourcesContent":["//#region src/ownership.ts\nconst StabilityEnum = {\n\tIdea: \"idea\",\n\tInCreation: \"in_creation\",\n\tExperimental: \"experimental\",\n\tBeta: \"beta\",\n\tStable: \"stable\",\n\tDeprecated: \"deprecated\"\n};\nconst OwnersEnum = {\n\tProductColiving: \"product.coliving\",\n\tProductStrit: \"product.strit\",\n\tProductArtisanos: \"product.artisanos\",\n\tPlatformSigil: \"platform.sigil\",\n\tPlatformMarketplace: \"platform.marketplace\",\n\tPlatformMessaging: \"platform.messaging\",\n\tPlatformContent: \"platform.content\",\n\tPlatformFeatureFlags: \"platform.featureflags\",\n\tPlatformFinance: \"platform.finance\"\n};\nconst Owners = OwnersEnum;\nconst TagsEnum = {\n\tSpots: \"spots\",\n\tCollectivity: \"collectivity\",\n\tMarketplace: \"marketplace\",\n\tSellers: \"sellers\",\n\tAuth: \"auth\",\n\tLogin: \"login\",\n\tSignup: \"signup\",\n\tGuide: \"guide\",\n\tDocs: \"docs\",\n\tI18n: \"i18n\",\n\tIncident: \"incident\",\n\tAutomation: \"automation\",\n\tHygiene: \"hygiene\"\n};\nconst Tags = TagsEnum;\n\n//#endregion\nexport { Owners, OwnersEnum, StabilityEnum, Tags, TagsEnum };"],"mappings":";AACA,MAAM,gBAAgB;CACrB,MAAM;CACN,YAAY;CACZ,cAAc;CACd,MAAM;CACN,QAAQ;CACR,YAAY;CACZ;AACD,MAAM,aAAa;CAClB,iBAAiB;CACjB,cAAc;CACd,kBAAkB;CAClB,eAAe;CACf,qBAAqB;CACrB,mBAAmB;CACnB,iBAAiB;CACjB,sBAAsB;CACtB,iBAAiB;CACjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.locale-jurisdiction-gate",
-  "version": "0.0.0-canary-20251220002821",
+  "version": "0.0.0-canary-20251220021406",
   "description": "Example: enforce locale + jurisdiction + kbSnapshotId + allowed scope for assistant calls (fail-closed).",
   "type": "module",
   "main": "./dist/index.js",
@@ -38,13 +38,13 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/lib.contracts": "0.0.0-canary-20251220002821",
-    "@lssm/lib.schema": "0.0.0-canary-20251220002821",
+    "@lssm/lib.contracts": "0.0.0-canary-20251220021406",
+    "@lssm/lib.schema": "0.0.0-canary-20251220021406",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251220002821",
-    "@lssm/tool.typescript": "0.0.0-canary-20251220002821",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251220021406",
+    "@lssm/tool.typescript": "0.0.0-canary-20251220021406",
     "tsdown": "^0.18.1",
     "typescript": "^5.9.3"
   },

package/src/handlers/demo.handlers.ts

@@ -57,6 +57,7 @@ export interface DemoAssistantHandlers {
  */
 export function createDemoAssistantHandlers(): DemoAssistantHandlers {
   async function answer(input: {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
     envelope: DemoAssistantHandlers['answer'] extends (a: infer A) => any
       ? A extends { envelope: infer E }
         ? E
@@ -89,8 +90,8 @@ export function createDemoAssistantHandlers(): DemoAssistantHandlers {
 
     const draft: AssistantAnswerIR = {
       locale: env.value.locale,
-      jurisdiction: env.value.regulatoryContext!.jurisdiction!,
-      allowedScope: env.value.allowedScope!,
+      jurisdiction: env.value.regulatoryContext?.jurisdiction ?? 'UNKNOWN',
+      allowedScope: env.value.allowedScope ?? 'education_only',
       sections: [
         {
           heading: 'Answer (demo)',
@@ -99,7 +100,7 @@ export function createDemoAssistantHandlers(): DemoAssistantHandlers {
       ],
       citations: [
         {
-          kbSnapshotId: env.value.kbSnapshotId!,
+          kbSnapshotId: env.value.kbSnapshotId ?? 'unknown',
           sourceType: 'ruleVersion',
           sourceId: 'rv_demo',
           title: 'Demo rule version',
@@ -142,7 +143,7 @@ export function createDemoAssistantHandlers(): DemoAssistantHandlers {
   async function explainConcept(input: {
     envelope: DemoAssistantHandlers['explainConcept'] extends (
       a: infer A
-    ) => any
+    ) => any // eslint-disable-line @typescript-eslint/no-explicit-any
       ? A extends { envelope: infer E }
         ? E
         : never