@lssm/example.locale-jurisdiction-gate 0.0.0-canary-20251217083314 → 1.41.0

package/dist/handlers/demo.handlers.js

@@ -1,85 +1 @@
-import { enforceAllowedScope, enforceCitations, validateEnvelope } from "../policy/guard.js";
-
-//#region src/handlers/demo.handlers.ts
-/**
-* Deterministic demo assistant handlers (no LLM).
-*
-* - Validates envelope
-* - Requires citations
-* - Enforces allowedScope (education_only blocks actionable language)
-*/
-function createDemoAssistantHandlers() {
-	async function answer(input) {
-		const env = validateEnvelope(input.envelope);
-		if (!env.ok) return {
-			locale: input.envelope.locale ?? "en-US",
-			jurisdiction: input.envelope.regulatoryContext?.jurisdiction ?? "UNKNOWN",
-			allowedScope: input.envelope.allowedScope ?? "education_only",
-			sections: [{
-				heading: "Request blocked",
-				body: env.error.message
-			}],
-			citations: [],
-			disclaimers: ["This system refuses to answer without a valid envelope."],
-			riskFlags: [env.error.code],
-			refused: true,
-			refusalReason: env.error.code
-		};
-		const draft = {
-			locale: env.value.locale,
-			jurisdiction: env.value.regulatoryContext.jurisdiction,
-			allowedScope: env.value.allowedScope,
-			sections: [{
-				heading: "Answer (demo)",
-				body: `You asked: "${input.question}". This demo answer is derived from the KB snapshot only.`
-			}],
-			citations: [{
-				kbSnapshotId: env.value.kbSnapshotId,
-				sourceType: "ruleVersion",
-				sourceId: "rv_demo",
-				title: "Demo rule version",
-				excerpt: "Demo excerpt"
-			}],
-			disclaimers: ["Educational demo only."],
-			riskFlags: []
-		};
-		const scope = enforceAllowedScope(env.value.allowedScope, draft);
-		if (!scope.ok) return {
-			...draft,
-			sections: [{
-				heading: "Escalation required",
-				body: scope.error.message
-			}],
-			citations: draft.citations,
-			refused: true,
-			refusalReason: scope.error.code,
-			riskFlags: [...draft.riskFlags ?? [], scope.error.code]
-		};
-		const cited = enforceCitations(draft);
-		if (!cited.ok) return {
-			...draft,
-			sections: [{
-				heading: "Request blocked",
-				body: cited.error.message
-			}],
-			citations: [],
-			refused: true,
-			refusalReason: cited.error.code,
-			riskFlags: [...draft.riskFlags ?? [], cited.error.code]
-		};
-		return draft;
-	}
-	async function explainConcept(input) {
-		return await answer({
-			envelope: input.envelope,
-			question: `Explain concept: ${input.conceptKey}`
-		});
-	}
-	return {
-		answer,
-		explainConcept
-	};
-}
-
-//#endregion
-export { createDemoAssistantHandlers };
+import{enforceAllowedScope as e,enforceCitations as t,validateEnvelope as n}from"../policy/guard.js";function r(){async function r(r){let i=n(r.envelope);if(!i.ok)return{locale:r.envelope.locale??`en-US`,jurisdiction:r.envelope.regulatoryContext?.jurisdiction??`UNKNOWN`,allowedScope:r.envelope.allowedScope??`education_only`,sections:[{heading:`Request blocked`,body:i.error.message}],citations:[],disclaimers:[`This system refuses to answer without a valid envelope.`],riskFlags:[i.error.code],refused:!0,refusalReason:i.error.code};let a={locale:i.value.locale,jurisdiction:i.value.regulatoryContext.jurisdiction,allowedScope:i.value.allowedScope,sections:[{heading:`Answer (demo)`,body:`You asked: "${r.question}". This demo answer is derived from the KB snapshot only.`}],citations:[{kbSnapshotId:i.value.kbSnapshotId,sourceType:`ruleVersion`,sourceId:`rv_demo`,title:`Demo rule version`,excerpt:`Demo excerpt`}],disclaimers:[`Educational demo only.`],riskFlags:[]},o=e(i.value.allowedScope,a);if(!o.ok)return{...a,sections:[{heading:`Escalation required`,body:o.error.message}],citations:a.citations,refused:!0,refusalReason:o.error.code,riskFlags:[...a.riskFlags??[],o.error.code]};let s=t(a);return s.ok?a:{...a,sections:[{heading:`Request blocked`,body:s.error.message}],citations:[],refused:!0,refusalReason:s.error.code,riskFlags:[...a.riskFlags??[],s.error.code]}}async function i(e){return await r({envelope:e.envelope,question:`Explain concept: ${e.conceptKey}`})}return{answer:r,explainConcept:i}}export{r as createDemoAssistantHandlers};

package/dist/handlers/index.js

@@ -1,3 +1 @@
-import { createDemoAssistantHandlers } from "./demo.handlers.js";
-
-export { createDemoAssistantHandlers };
+import{createDemoAssistantHandlers as e}from"./demo.handlers.js";export{e as createDemoAssistantHandlers};

package/dist/index.js

@@ -1,12 +1 @@
-import { AssistantAnswerBlockedEvent, AssistantAnswerDeliveredEvent, AssistantAnswerRequestedEvent } from "./events.js";
-import example_default from "./example.js";
-import { AllowedScopeEnum, AssistantAnswerIRModel, AssistantAnswerSectionModel, AssistantCitationModel, LLMCallEnvelopeModel, RegulatoryContextModel, UserProfileModel } from "./entities/models.js";
-import "./entities/index.js";
-import { AssistantAnswerContract, AssistantExplainConceptContract } from "./contracts/assistant.js";
-import "./contracts/index.js";
-import { enforceAllowedScope, enforceCitations, validateEnvelope } from "./policy/guard.js";
-import { createDemoAssistantHandlers } from "./handlers/demo.handlers.js";
-import { LocaleJurisdictionGateFeature } from "./locale-jurisdiction-gate.feature.js";
-import "./docs/index.js";
-
-export { AllowedScopeEnum, AssistantAnswerBlockedEvent, AssistantAnswerContract, AssistantAnswerDeliveredEvent, AssistantAnswerIRModel, AssistantAnswerRequestedEvent, AssistantAnswerSectionModel, AssistantCitationModel, AssistantExplainConceptContract, LLMCallEnvelopeModel, LocaleJurisdictionGateFeature, RegulatoryContextModel, UserProfileModel, createDemoAssistantHandlers, enforceAllowedScope, enforceCitations, example_default as example, validateEnvelope };
+import{AssistantAnswerBlockedEvent as e,AssistantAnswerDeliveredEvent as t,AssistantAnswerRequestedEvent as n}from"./events.js";import r from"./example.js";import{AllowedScopeEnum as i,AssistantAnswerIRModel as a,AssistantAnswerSectionModel as o,AssistantCitationModel as s,LLMCallEnvelopeModel as c,RegulatoryContextModel as l,UserProfileModel as u}from"./entities/models.js";import"./entities/index.js";import{AssistantAnswerContract as d,AssistantExplainConceptContract as f}from"./contracts/assistant.js";import"./contracts/index.js";import{enforceAllowedScope as p,enforceCitations as m,validateEnvelope as h}from"./policy/guard.js";import{createDemoAssistantHandlers as g}from"./handlers/demo.handlers.js";import{LocaleJurisdictionGateFeature as _}from"./locale-jurisdiction-gate.feature.js";import"./docs/index.js";export{i as AllowedScopeEnum,e as AssistantAnswerBlockedEvent,d as AssistantAnswerContract,t as AssistantAnswerDeliveredEvent,a as AssistantAnswerIRModel,n as AssistantAnswerRequestedEvent,o as AssistantAnswerSectionModel,s as AssistantCitationModel,f as AssistantExplainConceptContract,c as LLMCallEnvelopeModel,_ as LocaleJurisdictionGateFeature,l as RegulatoryContextModel,u as UserProfileModel,g as createDemoAssistantHandlers,p as enforceAllowedScope,m as enforceCitations,r as example,h as validateEnvelope};

package/dist/locale-jurisdiction-gate.feature.js

@@ -1,49 +1 @@
-//#region src/locale-jurisdiction-gate.feature.ts
-const LocaleJurisdictionGateFeature = {
-	meta: {
-		key: "locale-jurisdiction-gate",
-		title: "Locale + Jurisdiction Gate",
-		description: "Fail-closed gating for assistant calls requiring locale/jurisdiction/snapshot/scope and citations.",
-		domain: "knowledge",
-		owners: ["@examples"],
-		tags: [
-			"assistant",
-			"policy",
-			"locale",
-			"jurisdiction",
-			"knowledge"
-		],
-		stability: "experimental"
-	},
-	operations: [{
-		name: "assistant.answer",
-		version: 1
-	}, {
-		name: "assistant.explainConcept",
-		version: 1
-	}],
-	events: [
-		{
-			name: "assistant.answer.requested",
-			version: 1
-		},
-		{
-			name: "assistant.answer.blocked",
-			version: 1
-		},
-		{
-			name: "assistant.answer.delivered",
-			version: 1
-		}
-	],
-	presentations: [],
-	opToPresentation: [],
-	presentationsTargets: [],
-	capabilities: { requires: [{
-		key: "knowledge",
-		version: 1
-	}] }
-};
-
-//#endregion
-export { LocaleJurisdictionGateFeature };
+const e={meta:{key:`locale-jurisdiction-gate`,title:`Locale + Jurisdiction Gate`,description:`Fail-closed gating for assistant calls requiring locale/jurisdiction/snapshot/scope and citations.`,domain:`knowledge`,owners:[`@examples`],tags:[`assistant`,`policy`,`locale`,`jurisdiction`,`knowledge`],stability:`experimental`},operations:[{name:`assistant.answer`,version:1},{name:`assistant.explainConcept`,version:1}],events:[{name:`assistant.answer.requested`,version:1},{name:`assistant.answer.blocked`,version:1},{name:`assistant.answer.delivered`,version:1}],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{requires:[{key:`knowledge`,version:1}]}};export{e as LocaleJurisdictionGateFeature};

package/dist/policy/guard.js

@@ -1,72 +1,2 @@
-//#region src/policy/guard.ts
-const SUPPORTED_LOCALES = new Set([
-	"en-US",
-	"en-GB",
-	"fr-FR"
-]);
-function err(code, message) {
-	return {
-		code,
-		message
-	};
-}
-function validateEnvelope(envelope) {
-	if (!envelope.locale || !SUPPORTED_LOCALES.has(envelope.locale)) return {
-		ok: false,
-		error: err("LOCALE_REQUIRED", "locale is required and must be supported")
-	};
-	if (!envelope.regulatoryContext?.jurisdiction) return {
-		ok: false,
-		error: err("JURISDICTION_REQUIRED", "jurisdiction is required")
-	};
-	if (!envelope.kbSnapshotId) return {
-		ok: false,
-		error: err("KB_SNAPSHOT_REQUIRED", "kbSnapshotId is required")
-	};
-	if (!envelope.allowedScope) return {
-		ok: false,
-		error: err("SCOPE_VIOLATION", "allowedScope is required")
-	};
-	return {
-		ok: true,
-		value: envelope
-	};
-}
-function enforceCitations(answer) {
-	const citations = answer.citations ?? [];
-	if (!Array.isArray(citations) || citations.length === 0) return {
-		ok: false,
-		error: err("CITATIONS_REQUIRED", "answers must include at least one citation")
-	};
-	return {
-		ok: true,
-		value: answer
-	};
-}
-const EDUCATION_ONLY_FORBIDDEN_PATTERNS = [
-	/\b(buy|sell)\b/i,
-	/\b(should\s+buy|should\s+sell)\b/i,
-	/\b(guarantee(d)?|promise(d)?)\b/i
-];
-function enforceAllowedScope(allowedScope, answer) {
-	if (!allowedScope) return {
-		ok: false,
-		error: err("SCOPE_VIOLATION", "allowedScope is required")
-	};
-	if (allowedScope !== "education_only") return {
-		ok: true,
-		value: answer
-	};
-	const bodies = (answer.sections ?? []).map((s) => s.body).join("\n");
-	if (EDUCATION_ONLY_FORBIDDEN_PATTERNS.some((re) => re.test(bodies))) return {
-		ok: false,
-		error: err("SCOPE_VIOLATION", "answer violates education_only scope (contains actionable or promotional language)")
-	};
-	return {
-		ok: true,
-		value: answer
-	};
-}
-
-//#endregion
-export { enforceAllowedScope, enforceCitations, validateEnvelope };
+const e=new Set([`en-US`,`en-GB`,`fr-FR`]);function t(e,t){return{code:e,message:t}}function n(n){return!n.locale||!e.has(n.locale)?{ok:!1,error:t(`LOCALE_REQUIRED`,`locale is required and must be supported`)}:n.regulatoryContext?.jurisdiction?n.kbSnapshotId?n.allowedScope?{ok:!0,value:n}:{ok:!1,error:t(`SCOPE_VIOLATION`,`allowedScope is required`)}:{ok:!1,error:t(`KB_SNAPSHOT_REQUIRED`,`kbSnapshotId is required`)}:{ok:!1,error:t(`JURISDICTION_REQUIRED`,`jurisdiction is required`)}}function r(e){let n=e.citations??[];return!Array.isArray(n)||n.length===0?{ok:!1,error:t(`CITATIONS_REQUIRED`,`answers must include at least one citation`)}:{ok:!0,value:e}}const i=[/\b(buy|sell)\b/i,/\b(should\s+buy|should\s+sell)\b/i,/\b(guarantee(d)?|promise(d)?)\b/i];function a(e,n){if(!e)return{ok:!1,error:t(`SCOPE_VIOLATION`,`allowedScope is required`)};if(e!==`education_only`)return{ok:!0,value:n};let r=(n.sections??[]).map(e=>e.body).join(`
+`);return i.some(e=>e.test(r))?{ok:!1,error:t(`SCOPE_VIOLATION`,`answer violates education_only scope (contains actionable or promotional language)`)}:{ok:!0,value:n}}export{a as enforceAllowedScope,r as enforceCitations,n as validateEnvelope};

package/dist/policy/index.js

@@ -1,3 +1 @@
-import { enforceAllowedScope, enforceCitations, validateEnvelope } from "./guard.js";
-
-export { enforceAllowedScope, enforceCitations, validateEnvelope };
+import{enforceAllowedScope as e,enforceCitations as t,validateEnvelope as n}from"./guard.js";export{e as enforceAllowedScope,t as enforceCitations,n as validateEnvelope};

package/package.json

@@ -1,32 +1,30 @@
 {
   "name": "@lssm/example.locale-jurisdiction-gate",
-  "version": "0.0.0-canary-20251217083314",
+  "version": "1.41.0",
   "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": {
-    ".": "./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",
+    ".": "./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",
     "./*": "./*"
   },
   "scripts": {
-    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
-    "publish:pkg:canary": "bun publish:pkg --tag canary",
     "build": "bun build:bundle && bun build:types",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
@@ -38,13 +36,13 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/lib.contracts": "0.0.0-canary-20251217083314",
-    "@lssm/lib.schema": "0.0.0-canary-20251217083314",
+    "@lssm/lib.contracts": "workspace:*",
+    "@lssm/lib.schema": "workspace:*",
     "zod": "^4.1.13"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217083314",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217083314",
+    "@lssm/tool.tsdown": "workspace:*",
+    "@lssm/tool.typescript": "workspace:*",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },