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

package/dist/example.d.ts

@@ -0,0 +1,35 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "locale-jurisdiction-gate";
+  readonly title: "Locale / Jurisdiction Gate";
+  readonly summary: "Fail-closed gating for assistant calls: locale + jurisdiction + kbSnapshotId + allowedScope must be explicit, answers must cite a snapshot.";
+  readonly tags: readonly ["policy", "locale", "jurisdiction", "assistant", "gating"];
+  readonly kind: "knowledge";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly rootDocId: "docs.examples.locale-jurisdiction-gate";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@lssm/example.locale-jurisdiction-gate";
+    readonly feature: "./feature";
+    readonly contracts: "./contracts";
+    readonly handlers: "./handlers";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["markdown", "specs"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };

package/dist/handlers/demo.handlers.d.ts

@@ -0,0 +1,58 @@
+//#region src/handlers/demo.handlers.d.ts
+type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
+interface AssistantAnswerIR {
+  locale: string;
+  jurisdiction: string;
+  allowedScope: AllowedScope;
+  sections: {
+    heading: string;
+    body: string;
+  }[];
+  citations: {
+    kbSnapshotId: string;
+    sourceType: string;
+    sourceId: string;
+    title?: string;
+    excerpt?: string;
+  }[];
+  disclaimers?: string[];
+  riskFlags?: string[];
+  refused?: boolean;
+  refusalReason?: string;
+}
+interface DemoAssistantHandlers {
+  answer(input: {
+    envelope: {
+      traceId: string;
+      locale: string;
+      kbSnapshotId: string;
+      allowedScope: AllowedScope;
+      regulatoryContext: {
+        jurisdiction: string;
+      };
+    };
+    question: string;
+  }): Promise<AssistantAnswerIR>;
+  explainConcept(input: {
+    envelope: {
+      traceId: string;
+      locale: string;
+      kbSnapshotId: string;
+      allowedScope: AllowedScope;
+      regulatoryContext: {
+        jurisdiction: string;
+      };
+    };
+    conceptKey: string;
+  }): Promise<AssistantAnswerIR>;
+}
+/**
+ * Deterministic demo assistant handlers (no LLM).
+ *
+ * - Validates envelope
+ * - Requires citations
+ * - Enforces allowedScope (education_only blocks actionable language)
+ */
+declare function createDemoAssistantHandlers(): DemoAssistantHandlers;
+//#endregion
+export { DemoAssistantHandlers, createDemoAssistantHandlers };

package/dist/handlers/index.d.ts

@@ -0,0 +1,2 @@
+import { DemoAssistantHandlers, createDemoAssistantHandlers } from "./demo.handlers.js";
+export { DemoAssistantHandlers, createDemoAssistantHandlers };

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+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";
+import { AllowedScope, GateError, GateResult } from "./policy/types.js";
+import { enforceAllowedScope, enforceCitations, validateEnvelope } from "./policy/guard.js";
+import { LocaleJurisdictionGateFeature } from "./locale-jurisdiction-gate.feature.js";
+export { AllowedScope, AllowedScopeEnum, AssistantAnswerBlockedEvent, AssistantAnswerContract, AssistantAnswerDeliveredEvent, AssistantAnswerIRModel, AssistantAnswerRequestedEvent, AssistantAnswerSectionModel, AssistantCitationModel, AssistantExplainConceptContract, DemoAssistantHandlers, GateError, GateResult, LLMCallEnvelopeModel, LocaleJurisdictionGateFeature, RegulatoryContextModel, UserProfileModel, createDemoAssistantHandlers, enforceAllowedScope, enforceCitations, example, validateEnvelope };

package/dist/locale-jurisdiction-gate.feature.d.ts

@@ -0,0 +1,6 @@
+import { FeatureModuleSpec } from "@lssm/lib.contracts";
+
+//#region src/locale-jurisdiction-gate.feature.d.ts
+declare const LocaleJurisdictionGateFeature: FeatureModuleSpec;
+//#endregion
+export { LocaleJurisdictionGateFeature };

package/dist/policy/guard.d.ts

@@ -0,0 +1,26 @@
+import { GateResult } from "./types.js";
+
+//#region src/policy/guard.d.ts
+interface EnvelopeLike {
+  locale?: string;
+  kbSnapshotId?: string;
+  allowedScope?: 'education_only' | 'generic_info' | 'escalation_required';
+  regulatoryContext?: {
+    jurisdiction?: string;
+  };
+}
+interface AnswerLike {
+  citations?: unknown[];
+  sections?: {
+    heading: string;
+    body: string;
+  }[];
+  refused?: boolean;
+  refusalReason?: string;
+  allowedScope?: 'education_only' | 'generic_info' | 'escalation_required';
+}
+declare function validateEnvelope(envelope: EnvelopeLike): GateResult<Required<EnvelopeLike>>;
+declare function enforceCitations(answer: AnswerLike): GateResult<AnswerLike>;
+declare function enforceAllowedScope(allowedScope: EnvelopeLike['allowedScope'], answer: AnswerLike): GateResult<AnswerLike>;
+//#endregion
+export { enforceAllowedScope, enforceCitations, validateEnvelope };

package/dist/policy/index.d.ts

@@ -0,0 +1,3 @@
+import { AllowedScope, GateError, GateResult } from "./types.js";
+import { enforceAllowedScope, enforceCitations, validateEnvelope } from "./guard.js";
+export { AllowedScope, GateError, GateResult, enforceAllowedScope, enforceCitations, validateEnvelope };

package/dist/policy/types.d.ts

@@ -0,0 +1,15 @@
+//#region src/policy/types.d.ts
+type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
+interface GateError {
+  code: 'LOCALE_REQUIRED' | 'JURISDICTION_REQUIRED' | 'KB_SNAPSHOT_REQUIRED' | 'CITATIONS_REQUIRED' | 'SCOPE_VIOLATION';
+  message: string;
+}
+type GateResult<T> = {
+  ok: true;
+  value: T;
+} | {
+  ok: false;
+  error: GateError;
+};
+//#endregion
+export { AllowedScope, GateError, GateResult };

package/package.json

@@ -1,27 +1,27 @@
 {
   "name": "@lssm/example.locale-jurisdiction-gate",
-  "version": "0.0.0-canary-20251217054315",
+  "version": "0.0.0-canary-20251217060804",
   "description": "Example: enforce locale + jurisdiction + kbSnapshotId + allowed scope for assistant calls (fail-closed).",
   "type": "module",
   "main": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./contracts": "./src/contracts/index.ts",
-    "./contracts/assistant": "./src/contracts/assistant.ts",
-    "./docs": "./src/docs/index.ts",
-    "./docs/locale-jurisdiction-gate.docblock": "./src/docs/locale-jurisdiction-gate.docblock.ts",
-    "./entities": "./src/entities/index.ts",
-    "./entities/models": "./src/entities/models.ts",
-    "./events": "./src/events.ts",
-    "./example": "./src/example.ts",
-    "./handlers": "./src/handlers/index.ts",
-    "./handlers/demo.handlers": "./src/handlers/demo.handlers.ts",
-    "./locale-jurisdiction-gate.feature": "./src/locale-jurisdiction-gate.feature.ts",
-    "./policy": "./src/policy/index.ts",
-    "./policy/guard": "./src/policy/guard.ts",
-    "./policy/types": "./src/policy/types.ts",
+    ".": "./dist/index.js",
+    "./contracts": "./dist/contracts/index.js",
+    "./contracts/assistant": "./dist/contracts/assistant.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/locale-jurisdiction-gate.docblock": "./dist/docs/locale-jurisdiction-gate.docblock.js",
+    "./entities": "./dist/entities/index.js",
+    "./entities/models": "./dist/entities/models.js",
+    "./events": "./dist/events.js",
+    "./example": "./dist/example.js",
+    "./handlers": "./dist/handlers/index.js",
+    "./handlers/demo.handlers": "./dist/handlers/demo.handlers.js",
+    "./locale-jurisdiction-gate.feature": "./dist/locale-jurisdiction-gate.feature.js",
+    "./policy": "./dist/policy/index.js",
+    "./policy/guard": "./dist/policy/guard.js",
+    "./policy/types": "./dist/policy/types.js",
     "./*": "./*"
   },
   "scripts": {
@@ -38,13 +38,13 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/lib.contracts": "0.0.0-canary-20251217054315",
-    "@lssm/lib.schema": "0.0.0-canary-20251217054315",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217060804",
+    "@lssm/lib.schema": "0.0.0-canary-20251217060804",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217054315",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217054315",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217060804",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217060804",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },