@lssm/example.policy-safe-knowledge-assistant 1.41.0 → 1.42.1

package/dist/orchestrator/buildAnswer.js

@@ -1 +1,77 @@
-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 "@lssm/example.locale-jurisdiction-gate/policy/guard";
+
+//#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 ?? "UNKNOWN",
+		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 ?? "UNKNOWN",
+		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 };
+//# sourceMappingURL=buildAnswer.js.map

package/dist/orchestrator/buildAnswer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildAnswer.js","names":["draft: AssistantAnswerIR"],"sources":["../../src/orchestrator/buildAnswer.ts"],"sourcesContent":["import {\n  enforceAllowedScope,\n  enforceCitations,\n  validateEnvelope,\n} from '@lssm/example.locale-jurisdiction-gate/policy/guard';\n\ntype AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';\n\nexport interface 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 BuildAnswerInput {\n  envelope: {\n    traceId: string;\n    locale: string;\n    kbSnapshotId: string;\n    allowedScope: AllowedScope;\n    regulatoryContext: { jurisdiction: string };\n  };\n  question: string;\n  kbSearch: (input: {\n    snapshotId: string;\n    jurisdiction: string;\n    query: string;\n  }) => Promise<{ items: { ruleVersionId: string; excerpt?: string }[] }>;\n}\n\n/**\n * Build a policy-safe assistant answer derived from KB search results.\n *\n * Deterministic: no LLM calls; if search yields no results, it refuses.\n */\nexport async function buildPolicySafeAnswer(\n  input: BuildAnswerInput\n): Promise<AssistantAnswerIR> {\n  const env = validateEnvelope(input.envelope);\n  if (!env.ok) {\n    return {\n      locale: input.envelope.locale ?? 'en-GB',\n      jurisdiction: input.envelope.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n      allowedScope: input.envelope.allowedScope ?? 'education_only',\n      sections: [{ heading: 'Request blocked', body: env.error.message }],\n      citations: [],\n      disclaimers: ['This system refuses to answer without a valid envelope.'],\n      riskFlags: [env.error.code],\n      refused: true,\n      refusalReason: env.error.code,\n    };\n  }\n\n  const results = await input.kbSearch({\n    snapshotId: env.value.kbSnapshotId,\n    jurisdiction: env.value.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n    query: input.question,\n  });\n\n  const citations = results.items.map((item) => ({\n    kbSnapshotId: env.value.kbSnapshotId,\n    sourceType: 'ruleVersion',\n    sourceId: item.ruleVersionId,\n    title: 'Curated rule version',\n    excerpt: item.excerpt,\n  }));\n\n  const draft: AssistantAnswerIR = {\n    locale: env.value.locale,\n    jurisdiction: env.value.regulatoryContext?.jurisdiction ?? 'UNKNOWN',\n    allowedScope: env.value.allowedScope,\n    sections: [\n      {\n        heading: 'Answer (KB-derived)',\n        body:\n          results.items.length > 0\n            ? `This answer is derived from ${results.items.length} curated rule version(s) in the referenced snapshot.`\n            : 'No curated knowledge found in the referenced snapshot.',\n      },\n    ],\n    citations,\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: [{ heading: 'Escalation required', body: scope.error.message }],\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"],"mappings":";;;;;;;;AA+CA,eAAsB,sBACpB,OAC4B;CAC5B,MAAM,MAAM,iBAAiB,MAAM,SAAS;AAC5C,KAAI,CAAC,IAAI,GACP,QAAO;EACL,QAAQ,MAAM,SAAS,UAAU;EACjC,cAAc,MAAM,SAAS,mBAAmB,gBAAgB;EAChE,cAAc,MAAM,SAAS,gBAAgB;EAC7C,UAAU,CAAC;GAAE,SAAS;GAAmB,MAAM,IAAI,MAAM;GAAS,CAAC;EACnE,WAAW,EAAE;EACb,aAAa,CAAC,0DAA0D;EACxE,WAAW,CAAC,IAAI,MAAM,KAAK;EAC3B,SAAS;EACT,eAAe,IAAI,MAAM;EAC1B;CAGH,MAAM,UAAU,MAAM,MAAM,SAAS;EACnC,YAAY,IAAI,MAAM;EACtB,cAAc,IAAI,MAAM,mBAAmB,gBAAgB;EAC3D,OAAO,MAAM;EACd,CAAC;CAEF,MAAM,YAAY,QAAQ,MAAM,KAAK,UAAU;EAC7C,cAAc,IAAI,MAAM;EACxB,YAAY;EACZ,UAAU,KAAK;EACf,OAAO;EACP,SAAS,KAAK;EACf,EAAE;CAEH,MAAMA,QAA2B;EAC/B,QAAQ,IAAI,MAAM;EAClB,cAAc,IAAI,MAAM,mBAAmB,gBAAgB;EAC3D,cAAc,IAAI,MAAM;EACxB,UAAU,CACR;GACE,SAAS;GACT,MACE,QAAQ,MAAM,SAAS,IACnB,+BAA+B,QAAQ,MAAM,OAAO,wDACpD;GACP,CACF;EACD;EACA,aAAa,CAAC,yBAAyB;EACvC,WAAW,EAAE;EACd;CAED,MAAM,QAAQ,oBAAoB,IAAI,MAAM,cAAc,MAAM;AAChE,KAAI,CAAC,MAAM,GACT,QAAO;EACL,GAAG;EACH,UAAU,CAAC;GAAE,SAAS;GAAuB,MAAM,MAAM,MAAM;GAAS,CAAC;EACzE,SAAS;EACT,eAAe,MAAM,MAAM;EAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;EAC1D;CAGH,MAAM,QAAQ,iBAAiB,MAAM;AACrC,KAAI,CAAC,MAAM,GACT,QAAO;EACL,GAAG;EACH,UAAU,CAAC;GAAE,SAAS;GAAmB,MAAM,MAAM,MAAM;GAAS,CAAC;EACrE,WAAW,EAAE;EACb,SAAS;EACT,eAAe,MAAM,MAAM;EAC3B,WAAW,CAAC,GAAI,MAAM,aAAa,EAAE,EAAG,MAAM,MAAM,KAAK;EAC1D;AAGH,QAAO"}

package/dist/seed/fixtures.d.ts

@@ -0,0 +1,35 @@
+//#region src/seed/fixtures.d.ts
+declare const DEMO_FIXTURES: {
+  readonly jurisdictions: readonly ["EU", "FR"];
+  readonly locales: readonly ["en-GB", "fr-FR"];
+  readonly demoOrgId: "org_demo";
+  readonly demoUserId: "user_demo";
+  readonly sources: {
+    readonly EU_SOURCE_1: {
+      readonly jurisdiction: "EU";
+      readonly authority: "DemoAuthority";
+      readonly title: "EU Demo Source v1";
+      readonly fetchedAt: Date;
+      readonly hash: "hash_eu_v1";
+      readonly fileId: "file_eu_v1";
+    };
+    readonly EU_SOURCE_2: {
+      readonly jurisdiction: "EU";
+      readonly authority: "DemoAuthority";
+      readonly title: "EU Demo Source v2";
+      readonly fetchedAt: Date;
+      readonly hash: "hash_eu_v2";
+      readonly fileId: "file_eu_v2";
+    };
+  };
+  readonly rules: {
+    readonly EU_RULE_TAX: {
+      readonly id: "rule_eu_tax";
+      readonly jurisdiction: "EU";
+      readonly topicKey: "tax_reporting";
+    };
+  };
+};
+//#endregion
+export { DEMO_FIXTURES };
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/seed/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","names":[],"sources":["../../src/seed/fixtures.ts"],"sourcesContent":[],"mappings":";cAAa;EAAA,SAAA,aA8BH,EAAA,SAAA,CAAA,IAAA,EAAA,IAAA,CAAA;;;;;;;;;0BAAA;;;;;;;;0BAAA"}

package/dist/seed/fixtures.js

@@ -1 +1,34 @@
-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 };
+//# sourceMappingURL=fixtures.js.map

package/dist/seed/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","names":[],"sources":["../../src/seed/fixtures.ts"],"sourcesContent":["export const DEMO_FIXTURES = {\n  jurisdictions: ['EU', 'FR'] as const,\n  locales: ['en-GB', 'fr-FR'] as const,\n  demoOrgId: 'org_demo',\n  demoUserId: 'user_demo',\n  sources: {\n    EU_SOURCE_1: {\n      jurisdiction: 'EU',\n      authority: 'DemoAuthority',\n      title: 'EU Demo Source v1',\n      fetchedAt: new Date('2026-01-01T00:00:00.000Z'),\n      hash: 'hash_eu_v1',\n      fileId: 'file_eu_v1',\n    },\n    EU_SOURCE_2: {\n      jurisdiction: 'EU',\n      authority: 'DemoAuthority',\n      title: 'EU Demo Source v2',\n      fetchedAt: new Date('2026-02-01T00:00:00.000Z'),\n      hash: 'hash_eu_v2',\n      fileId: 'file_eu_v2',\n    },\n  },\n  rules: {\n    EU_RULE_TAX: {\n      id: 'rule_eu_tax',\n      jurisdiction: 'EU',\n      topicKey: 'tax_reporting',\n    },\n  },\n} as const;\n"],"mappings":";AAAA,MAAa,gBAAgB;CAC3B,eAAe,CAAC,MAAM,KAAK;CAC3B,SAAS,CAAC,SAAS,QAAQ;CAC3B,WAAW;CACX,YAAY;CACZ,SAAS;EACP,aAAa;GACX,cAAc;GACd,WAAW;GACX,OAAO;GACP,2BAAW,IAAI,KAAK,2BAA2B;GAC/C,MAAM;GACN,QAAQ;GACT;EACD,aAAa;GACX,cAAc;GACd,WAAW;GACX,OAAO;GACP,2BAAW,IAAI,KAAK,2BAA2B;GAC/C,MAAM;GACN,QAAQ;GACT;EACF;CACD,OAAO,EACL,aAAa;EACX,IAAI;EACJ,cAAc;EACd,UAAU;EACX,EACF;CACF"}

package/dist/seed/index.d.ts

@@ -0,0 +1,2 @@
+import { DEMO_FIXTURES } from "./fixtures.js";
+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,24 +1,26 @@
 {
   "name": "@lssm/example.policy-safe-knowledge-assistant",
-  "version": "1.41.0",
+  "version": "1.42.1",
   "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",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {
-    ".": "./src/index.ts",
-    "./docs": "./src/docs/index.ts",
-    "./docs/policy-safe-knowledge-assistant.docblock": "./src/docs/policy-safe-knowledge-assistant.docblock.ts",
-    "./example": "./src/example.ts",
-    "./feature": "./src/feature.ts",
-    "./orchestrator/buildAnswer": "./src/orchestrator/buildAnswer.ts",
-    "./seed": "./src/seed/index.ts",
-    "./seed/fixtures": "./src/seed/fixtures.ts",
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/policy-safe-knowledge-assistant.docblock": "./dist/docs/policy-safe-knowledge-assistant.docblock.js",
+    "./example": "./dist/example.js",
+    "./feature": "./dist/feature.js",
+    "./orchestrator/buildAnswer": "./dist/orchestrator/buildAnswer.js",
+    "./seed": "./dist/seed/index.js",
+    "./seed/fixtures": "./dist/seed/fixtures.js",
     "./*": "./*"
   },
   "scripts": {
-    "build": "bun build:bundle && bun build:types",
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
     "build:bundle": "tsdown",
     "build:types": "tsc --noEmit",
     "dev": "bun build:bundle --watch",
@@ -29,24 +31,25 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/example.locale-jurisdiction-gate": "workspace:*",
-    "@lssm/example.versioned-knowledge-base": "workspace:*",
-    "@lssm/example.kb-update-pipeline": "workspace:*",
-    "@lssm/example.learning-patterns": "workspace:*",
-    "@lssm/lib.contracts": "workspace:*",
-    "@lssm/lib.identity-rbac": "workspace:*",
-    "@lssm/lib.jobs": "workspace:*",
-    "@lssm/lib.feature-flags": "workspace:*",
-    "@lssm/lib.files": "workspace:*",
-    "@lssm/lib.metering": "workspace:*",
-    "@lssm/module.audit-trail": "workspace:*",
-    "@lssm/module.notifications": "workspace:*",
-    "@lssm/module.learning-journey": "workspace:*"
+    "@lssm/example.locale-jurisdiction-gate": "1.42.1",
+    "@lssm/example.versioned-knowledge-base": "1.42.1",
+    "@lssm/example.kb-update-pipeline": "1.42.1",
+    "@lssm/example.learning-patterns": "1.42.1",
+    "@lssm/lib.schema": "1.42.1",
+    "@lssm/lib.contracts": "1.42.1",
+    "@lssm/lib.identity-rbac": "1.42.1",
+    "@lssm/lib.jobs": "1.42.1",
+    "@lssm/lib.feature-flags": "1.42.1",
+    "@lssm/lib.files": "1.42.1",
+    "@lssm/lib.metering": "1.42.1",
+    "@lssm/module.audit-trail": "1.42.1",
+    "@lssm/module.notifications": "1.42.1",
+    "@lssm/module.learning-journey": "1.42.1"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "workspace:*",
-    "@lssm/tool.typescript": "workspace:*",
-    "tsdown": "^0.17.4",
+    "@lssm/tool.tsdown": "1.42.1",
+    "@lssm/tool.typescript": "1.42.1",
+    "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },
   "publishConfig": {
@@ -61,6 +64,13 @@
       "./seed": "./dist/seed/index.js",
       "./seed/fixtures": "./dist/seed/fixtures.js",
       "./*": "./*"
-    }
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/policy-safe-knowledge-assistant"
   }
 }

package/src/feature.ts

@@ -3,41 +3,42 @@ import type { FeatureModuleSpec } from '@lssm/lib.contracts';
 export const PolicySafeKnowledgeAssistantFeature: FeatureModuleSpec = {
   meta: {
     key: 'policy-safe-knowledge-assistant',
+    version: 1,
     title: 'Policy-safe Knowledge Assistant',
     description:
       'All-in-one example composing locale/jurisdiction gate + versioned KB + HITL pipeline + learning hub.',
     domain: 'knowledge',
-    owners: ['examples'],
+    owners: ['@examples'],
     tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],
     stability: 'experimental',
   },
   operations: [
     // Gate
-    { name: 'assistant.answer', version: 1 },
-    { name: 'assistant.explainConcept', version: 1 },
+    { key: 'assistant.answer', version: 1 },
+    { key: 'assistant.explainConcept', version: 1 },
     // KB
-    { name: 'kb.ingestSource', version: 1 },
-    { name: 'kb.upsertRuleVersion', version: 1 },
-    { name: 'kb.approveRuleVersion', version: 1 },
-    { name: 'kb.publishSnapshot', version: 1 },
-    { name: 'kb.search', version: 1 },
+    { key: 'kb.ingestSource', version: 1 },
+    { key: 'kb.upsertRuleVersion', version: 1 },
+    { key: 'kb.approveRuleVersion', version: 1 },
+    { key: 'kb.publishSnapshot', version: 1 },
+    { key: 'kb.search', version: 1 },
     // Pipeline
-    { name: 'kbPipeline.runWatch', version: 1 },
-    { name: 'kbPipeline.createReviewTask', version: 1 },
-    { name: 'kbPipeline.submitDecision', version: 1 },
-    { name: 'kbPipeline.publishIfReady', version: 1 },
+    { key: 'kbPipeline.runWatch', version: 1 },
+    { key: 'kbPipeline.createReviewTask', version: 1 },
+    { key: 'kbPipeline.submitDecision', version: 1 },
+    { key: 'kbPipeline.publishIfReady', version: 1 },
   ],
   events: [
-    { name: 'assistant.answer.requested', version: 1 },
-    { name: 'assistant.answer.blocked', version: 1 },
-    { name: 'assistant.answer.delivered', version: 1 },
-    { name: 'kb.source.ingested', version: 1 },
-    { name: 'kb.ruleVersion.created', version: 1 },
-    { name: 'kb.ruleVersion.approved', version: 1 },
-    { name: 'kb.snapshot.published', version: 1 },
-    { name: 'kb.change.detected', version: 1 },
-    { name: 'kb.review.requested', version: 1 },
-    { name: 'kb.review.decided', version: 1 },
+    { key: 'assistant.answer.requested', version: 1 },
+    { key: 'assistant.answer.blocked', version: 1 },
+    { key: 'assistant.answer.delivered', version: 1 },
+    { key: 'kb.source.ingested', version: 1 },
+    { key: 'kb.ruleVersion.created', version: 1 },
+    { key: 'kb.ruleVersion.approved', version: 1 },
+    { key: 'kb.snapshot.published', version: 1 },
+    { key: 'kb.change.detected', version: 1 },
+    { key: 'kb.review.requested', version: 1 },
+    { key: 'kb.review.decided', version: 1 },
   ],
   presentations: [],
   opToPresentation: [],

package/src/orchestrator/buildAnswer.ts

@@ -65,7 +65,7 @@ export async function buildPolicySafeAnswer(
 
   const results = await input.kbSearch({
     snapshotId: env.value.kbSnapshotId,
-    jurisdiction: env.value.regulatoryContext!.jurisdiction!,
+    jurisdiction: env.value.regulatoryContext?.jurisdiction ?? 'UNKNOWN',
     query: input.question,
   });
 
@@ -79,7 +79,7 @@ export async function buildPolicySafeAnswer(
 
   const draft: AssistantAnswerIR = {
     locale: env.value.locale,
-    jurisdiction: env.value.regulatoryContext!.jurisdiction!,
+    jurisdiction: env.value.regulatoryContext?.jurisdiction ?? 'UNKNOWN',
     allowedScope: env.value.allowedScope,
     sections: [
       {