@lssm/example.policy-safe-knowledge-assistant 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217073102

package/dist/orchestrator/buildAnswer.js

@@ -1 +1,76 @@
-import{enforceAllowedScope as e,enforceCitations as t,validateEnvelope as n}from"@lssm/example.locale-jurisdiction-gate/policy/guard";async function r(r){let i=n(r.envelope);if(!i.ok)return{locale:r.envelope.locale??`en-GB`,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=await r.kbSearch({snapshotId:i.value.kbSnapshotId,jurisdiction:i.value.regulatoryContext.jurisdiction,query:r.question}),o=a.items.map(e=>({kbSnapshotId:i.value.kbSnapshotId,sourceType:`ruleVersion`,sourceId:e.ruleVersionId,title:`Curated rule version`,excerpt:e.excerpt})),s={locale:i.value.locale,jurisdiction:i.value.regulatoryContext.jurisdiction,allowedScope:i.value.allowedScope,sections:[{heading:`Answer (KB-derived)`,body:a.items.length>0?`This answer is derived from ${a.items.length} curated rule version(s) in the referenced snapshot.`:`No curated knowledge found in the referenced snapshot.`}],citations:o,disclaimers:[`Educational demo only.`],riskFlags:[]},c=e(i.value.allowedScope,s);if(!c.ok)return{...s,sections:[{heading:`Escalation required`,body:c.error.message}],refused:!0,refusalReason:c.error.code,riskFlags:[...s.riskFlags??[],c.error.code]};let l=t(s);return l.ok?s:{...s,sections:[{heading:`Request blocked`,body:l.error.message}],citations:[],refused:!0,refusalReason:l.error.code,riskFlags:[...s.riskFlags??[],l.error.code]}}export{r as buildPolicySafeAnswer};
+import { enforceAllowedScope, enforceCitations, validateEnvelope } from "../examples/locale-jurisdiction-gate/dist/policy/guard.js";
+
+//#region src/orchestrator/buildAnswer.ts
+/**
+* Build a policy-safe assistant answer derived from KB search results.
+*
+* Deterministic: no LLM calls; if search yields no results, it refuses.
+*/
+async function buildPolicySafeAnswer(input) {
+	const env = validateEnvelope(input.envelope);
+	if (!env.ok) return {
+		locale: input.envelope.locale ?? "en-GB",
+		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 results = await input.kbSearch({
+		snapshotId: env.value.kbSnapshotId,
+		jurisdiction: env.value.regulatoryContext.jurisdiction,
+		query: input.question
+	});
+	const citations = results.items.map((item) => ({
+		kbSnapshotId: env.value.kbSnapshotId,
+		sourceType: "ruleVersion",
+		sourceId: item.ruleVersionId,
+		title: "Curated rule version",
+		excerpt: item.excerpt
+	}));
+	const draft = {
+		locale: env.value.locale,
+		jurisdiction: env.value.regulatoryContext.jurisdiction,
+		allowedScope: env.value.allowedScope,
+		sections: [{
+			heading: "Answer (KB-derived)",
+			body: results.items.length > 0 ? `This answer is derived from ${results.items.length} curated rule version(s) in the referenced snapshot.` : "No curated knowledge found in the referenced snapshot."
+		}],
+		citations,
+		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
+		}],
+		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;
+}
+
+//#endregion
+export { buildPolicySafeAnswer };

package/dist/seed/fixtures.js

@@ -1 +1,33 @@
-const e={jurisdictions:[`EU`,`FR`],locales:[`en-GB`,`fr-FR`],demoOrgId:`org_demo`,demoUserId:`user_demo`,sources:{EU_SOURCE_1:{jurisdiction:`EU`,authority:`DemoAuthority`,title:`EU Demo Source v1`,fetchedAt:new Date(`2026-01-01T00:00:00.000Z`),hash:`hash_eu_v1`,fileId:`file_eu_v1`},EU_SOURCE_2:{jurisdiction:`EU`,authority:`DemoAuthority`,title:`EU Demo Source v2`,fetchedAt:new Date(`2026-02-01T00:00:00.000Z`),hash:`hash_eu_v2`,fileId:`file_eu_v2`}},rules:{EU_RULE_TAX:{id:`rule_eu_tax`,jurisdiction:`EU`,topicKey:`tax_reporting`}}};export{e as DEMO_FIXTURES};
+//#region src/seed/fixtures.ts
+const DEMO_FIXTURES = {
+	jurisdictions: ["EU", "FR"],
+	locales: ["en-GB", "fr-FR"],
+	demoOrgId: "org_demo",
+	demoUserId: "user_demo",
+	sources: {
+		EU_SOURCE_1: {
+			jurisdiction: "EU",
+			authority: "DemoAuthority",
+			title: "EU Demo Source v1",
+			fetchedAt: /* @__PURE__ */ new Date("2026-01-01T00:00:00.000Z"),
+			hash: "hash_eu_v1",
+			fileId: "file_eu_v1"
+		},
+		EU_SOURCE_2: {
+			jurisdiction: "EU",
+			authority: "DemoAuthority",
+			title: "EU Demo Source v2",
+			fetchedAt: /* @__PURE__ */ new Date("2026-02-01T00:00:00.000Z"),
+			hash: "hash_eu_v2",
+			fileId: "file_eu_v2"
+		}
+	},
+	rules: { EU_RULE_TAX: {
+		id: "rule_eu_tax",
+		jurisdiction: "EU",
+		topicKey: "tax_reporting"
+	} }
+};
+
+//#endregion
+export { DEMO_FIXTURES };

package/dist/seed/index.js

@@ -1 +1,3 @@
-import{DEMO_FIXTURES as e}from"./fixtures.js";export{e as DEMO_FIXTURES};
+import { DEMO_FIXTURES } from "./fixtures.js";
+
+export { DEMO_FIXTURES };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.policy-safe-knowledge-assistant",
-  "version": "0.0.0-canary-20251217060834",
+  "version": "0.0.0-canary-20251217073102",
   "description": "All-in-one template example: policy-safe knowledge assistant with locale/jurisdiction gating, versioned KB snapshots, HITL update pipeline, and learning hub.",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,23 +31,24 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/example.locale-jurisdiction-gate": "0.0.0-canary-20251217060834",
-    "@lssm/example.versioned-knowledge-base": "0.0.0-canary-20251217060834",
-    "@lssm/example.kb-update-pipeline": "0.0.0-canary-20251217060834",
-    "@lssm/example.learning-patterns": "0.0.0-canary-20251217060834",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217060834",
-    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217060834",
-    "@lssm/lib.jobs": "0.0.0-canary-20251217060834",
-    "@lssm/lib.feature-flags": "0.0.0-canary-20251217060834",
-    "@lssm/lib.files": "0.0.0-canary-20251217060834",
-    "@lssm/lib.metering": "0.0.0-canary-20251217060834",
-    "@lssm/module.audit-trail": "0.0.0-canary-20251217060834",
-    "@lssm/module.notifications": "0.0.0-canary-20251217060834",
-    "@lssm/module.learning-journey": "0.0.0-canary-20251217060834"
+    "@lssm/example.locale-jurisdiction-gate": "0.0.0-canary-20251217073102",
+    "@lssm/example.versioned-knowledge-base": "0.0.0-canary-20251217073102",
+    "@lssm/example.kb-update-pipeline": "0.0.0-canary-20251217073102",
+    "@lssm/example.learning-patterns": "0.0.0-canary-20251217073102",
+    "@lssm/lib.schema": "0.0.0-canary-20251217073102",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217073102",
+    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217073102",
+    "@lssm/lib.jobs": "0.0.0-canary-20251217073102",
+    "@lssm/lib.feature-flags": "0.0.0-canary-20251217073102",
+    "@lssm/lib.files": "0.0.0-canary-20251217073102",
+    "@lssm/lib.metering": "0.0.0-canary-20251217073102",
+    "@lssm/module.audit-trail": "0.0.0-canary-20251217073102",
+    "@lssm/module.notifications": "0.0.0-canary-20251217073102",
+    "@lssm/module.learning-journey": "0.0.0-canary-20251217073102"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217060834",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217060834",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217073102",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217073102",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },