@contractspec/example.policy-safe-knowledge-assistant 0.0.0-canary-20260113170453

package/dist/orchestrator/buildAnswer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildAnswer.js","names":[],"sources":["../../src/orchestrator/buildAnswer.ts"],"sourcesContent":["import {\n  enforceAllowedScope,\n  enforceCitations,\n  validateEnvelope,\n} from '@contractspec/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,MAAM,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/policy-safe-knowledge-assistant.feature.d.ts

@@ -0,0 +1,7 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+
+//#region src/policy-safe-knowledge-assistant.feature.d.ts
+declare const PolicySafeKnowledgeAssistantFeature: _contractspec_lib_contracts0.FeatureModuleSpec;
+//#endregion
+export { PolicySafeKnowledgeAssistantFeature };
+//# sourceMappingURL=policy-safe-knowledge-assistant.feature.d.ts.map

package/dist/policy-safe-knowledge-assistant.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-safe-knowledge-assistant.feature.d.ts","names":[],"sources":["../src/policy-safe-knowledge-assistant.feature.ts"],"sourcesContent":[],"mappings":";;;cAEa,qCAuDX,4BAAA,CAvD8C"}

package/dist/policy-safe-knowledge-assistant.feature.js

@@ -0,0 +1,150 @@
+import { defineFeature } from "@contractspec/lib.contracts";
+
+//#region src/policy-safe-knowledge-assistant.feature.ts
+const PolicySafeKnowledgeAssistantFeature = defineFeature({
+	meta: {
+		key: "policy-safe-knowledge-assistant",
+		version: "1.0.0",
+		title: "Policy-safe Knowledge Assistant",
+		description: "All-in-one example composing locale/jurisdiction gate + versioned KB + HITL pipeline + learning hub.",
+		domain: "knowledge",
+		owners: ["@examples"],
+		tags: [
+			"assistant",
+			"knowledge",
+			"policy",
+			"hitl",
+			"learning"
+		],
+		stability: "experimental"
+	},
+	operations: [
+		{
+			key: "assistant.answer",
+			version: "1.0.0"
+		},
+		{
+			key: "assistant.explainConcept",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.ingestSource",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.upsertRuleVersion",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.approveRuleVersion",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.publishSnapshot",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.search",
+			version: "1.0.0"
+		},
+		{
+			key: "kbPipeline.runWatch",
+			version: "1.0.0"
+		},
+		{
+			key: "kbPipeline.createReviewTask",
+			version: "1.0.0"
+		},
+		{
+			key: "kbPipeline.submitDecision",
+			version: "1.0.0"
+		},
+		{
+			key: "kbPipeline.publishIfReady",
+			version: "1.0.0"
+		}
+	],
+	events: [
+		{
+			key: "assistant.answer.requested",
+			version: "1.0.0"
+		},
+		{
+			key: "assistant.answer.blocked",
+			version: "1.0.0"
+		},
+		{
+			key: "assistant.answer.delivered",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.source.ingested",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.ruleVersion.created",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.ruleVersion.approved",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.snapshot.published",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.change.detected",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.review.requested",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.review.decided",
+			version: "1.0.0"
+		}
+	],
+	presentations: [],
+	opToPresentation: [],
+	presentationsTargets: [],
+	capabilities: { requires: [
+		{
+			key: "identity",
+			version: "1.0.0"
+		},
+		{
+			key: "audit-trail",
+			version: "1.0.0"
+		},
+		{
+			key: "notifications",
+			version: "1.0.0"
+		},
+		{
+			key: "jobs",
+			version: "1.0.0"
+		},
+		{
+			key: "feature-flags",
+			version: "1.0.0"
+		},
+		{
+			key: "files",
+			version: "1.0.0"
+		},
+		{
+			key: "metering",
+			version: "1.0.0"
+		},
+		{
+			key: "learning-journey",
+			version: "1.0.0"
+		}
+	] }
+});
+
+//#endregion
+export { PolicySafeKnowledgeAssistantFeature };
+//# sourceMappingURL=policy-safe-knowledge-assistant.feature.js.map

package/dist/policy-safe-knowledge-assistant.feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-safe-knowledge-assistant.feature.js","names":[],"sources":["../src/policy-safe-knowledge-assistant.feature.ts"],"sourcesContent":["import { defineFeature } from '@contractspec/lib.contracts';\n\nexport const PolicySafeKnowledgeAssistantFeature = defineFeature({\n  meta: {\n    key: 'policy-safe-knowledge-assistant',\n    version: '1.0.0',\n    title: 'Policy-safe Knowledge Assistant',\n    description:\n      'All-in-one example composing locale/jurisdiction gate + versioned KB + HITL pipeline + learning hub.',\n    domain: 'knowledge',\n    owners: ['@examples'],\n    tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],\n    stability: 'experimental',\n  },\n  operations: [\n    // Gate\n    { key: 'assistant.answer', version: '1.0.0' },\n    { key: 'assistant.explainConcept', version: '1.0.0' },\n    // KB\n    { key: 'kb.ingestSource', version: '1.0.0' },\n    { key: 'kb.upsertRuleVersion', version: '1.0.0' },\n    { key: 'kb.approveRuleVersion', version: '1.0.0' },\n    { key: 'kb.publishSnapshot', version: '1.0.0' },\n    { key: 'kb.search', version: '1.0.0' },\n    // Pipeline\n    { key: 'kbPipeline.runWatch', version: '1.0.0' },\n    { key: 'kbPipeline.createReviewTask', version: '1.0.0' },\n    { key: 'kbPipeline.submitDecision', version: '1.0.0' },\n    { key: 'kbPipeline.publishIfReady', version: '1.0.0' },\n  ],\n  events: [\n    { key: 'assistant.answer.requested', version: '1.0.0' },\n    { key: 'assistant.answer.blocked', version: '1.0.0' },\n    { key: 'assistant.answer.delivered', version: '1.0.0' },\n    { key: 'kb.source.ingested', version: '1.0.0' },\n    { key: 'kb.ruleVersion.created', version: '1.0.0' },\n    { key: 'kb.ruleVersion.approved', version: '1.0.0' },\n    { key: 'kb.snapshot.published', version: '1.0.0' },\n    { key: 'kb.change.detected', version: '1.0.0' },\n    { key: 'kb.review.requested', version: '1.0.0' },\n    { key: 'kb.review.decided', version: '1.0.0' },\n  ],\n  presentations: [],\n  opToPresentation: [],\n  presentationsTargets: [],\n  capabilities: {\n    requires: [\n      { key: 'identity', version: '1.0.0' },\n      { key: 'audit-trail', version: '1.0.0' },\n      { key: 'notifications', version: '1.0.0' },\n      { key: 'jobs', version: '1.0.0' },\n      { key: 'feature-flags', version: '1.0.0' },\n      { key: 'files', version: '1.0.0' },\n      { key: 'metering', version: '1.0.0' },\n      { key: 'learning-journey', version: '1.0.0' },\n    ],\n  },\n});\n"],"mappings":";;;AAEA,MAAa,sCAAsC,cAAc;CAC/D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAa;GAAU;GAAQ;GAAW;EAC9D,WAAW;EACZ;CACD,YAAY;EAEV;GAAE,KAAK;GAAoB,SAAS;GAAS;EAC7C;GAAE,KAAK;GAA4B,SAAS;GAAS;EAErD;GAAE,KAAK;GAAmB,SAAS;GAAS;EAC5C;GAAE,KAAK;GAAwB,SAAS;GAAS;EACjD;GAAE,KAAK;GAAyB,SAAS;GAAS;EAClD;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAAa,SAAS;GAAS;EAEtC;GAAE,KAAK;GAAuB,SAAS;GAAS;EAChD;GAAE,KAAK;GAA+B,SAAS;GAAS;EACxD;GAAE,KAAK;GAA6B,SAAS;GAAS;EACtD;GAAE,KAAK;GAA6B,SAAS;GAAS;EACvD;CACD,QAAQ;EACN;GAAE,KAAK;GAA8B,SAAS;GAAS;EACvD;GAAE,KAAK;GAA4B,SAAS;GAAS;EACrD;GAAE,KAAK;GAA8B,SAAS;GAAS;EACvD;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAA0B,SAAS;GAAS;EACnD;GAAE,KAAK;GAA2B,SAAS;GAAS;EACpD;GAAE,KAAK;GAAyB,SAAS;GAAS;EAClD;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAAuB,SAAS;GAAS;EAChD;GAAE,KAAK;GAAqB,SAAS;GAAS;EAC/C;CACD,eAAe,EAAE;CACjB,kBAAkB,EAAE;CACpB,sBAAsB,EAAE;CACxB,cAAc,EACZ,UAAU;EACR;GAAE,KAAK;GAAY,SAAS;GAAS;EACrC;GAAE,KAAK;GAAe,SAAS;GAAS;EACxC;GAAE,KAAK;GAAiB,SAAS;GAAS;EAC1C;GAAE,KAAK;GAAQ,SAAS;GAAS;EACjC;GAAE,KAAK;GAAiB,SAAS;GAAS;EAC1C;GAAE,KAAK;GAAS,SAAS;GAAS;EAClC;GAAE,KAAK;GAAY,SAAS;GAAS;EACrC;GAAE,KAAK;GAAoB,SAAS;GAAS;EAC9C,EACF;CACF,CAAC"}

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

@@ -0,0 +1,34 @@
+//#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

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

package/dist/seeders/index.d.ts

@@ -0,0 +1,10 @@
+import { DatabasePort } from "@contractspec/lib.runtime-sandbox";
+
+//#region src/seeders/index.d.ts
+declare function seedPolicyKnowledgeAssistant(params: {
+  projectId: string;
+  db: DatabasePort;
+}): Promise<void>;
+//#endregion
+export { seedPolicyKnowledgeAssistant };
+//# sourceMappingURL=index.d.ts.map

package/dist/seeders/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/seeders/index.ts"],"sourcesContent":[],"mappings":";;;iBAEsB,4BAAA;;EAAA,EAAA,EAEhB,YAFgB;IAGrB"}

package/dist/seeders/index.js

@@ -0,0 +1,16 @@
+//#region src/seeders/index.ts
+async function seedPolicyKnowledgeAssistant(params) {
+	const { projectId, db } = params;
+	if ((await db.query(`SELECT COUNT(*) as count FROM psa_user_context WHERE "projectId" = $1`, [projectId])).rows[0]?.count > 0) return;
+	await db.execute(`INSERT INTO psa_user_context ("projectId", locale, jurisdiction, "allowedScope")
+     VALUES ($1, $2, $3, $4)`, [
+		projectId,
+		"en-GB",
+		"EU",
+		"education_only"
+	]);
+}
+
+//#endregion
+export { seedPolicyKnowledgeAssistant };
+//# sourceMappingURL=index.js.map

package/dist/seeders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/seeders/index.ts"],"sourcesContent":["import type { DatabasePort } from '@contractspec/lib.runtime-sandbox';\n\nexport async function seedPolicyKnowledgeAssistant(params: {\n  projectId: string;\n  db: DatabasePort;\n}) {\n  const { projectId, db } = params;\n\n  const existing = await db.query(\n    `SELECT COUNT(*) as count FROM psa_user_context WHERE \"projectId\" = $1`,\n    [projectId]\n  );\n  if ((existing.rows[0]?.count as number) > 0) return;\n\n  await db.execute(\n    `INSERT INTO psa_user_context (\"projectId\", locale, jurisdiction, \"allowedScope\")\n     VALUES ($1, $2, $3, $4)`,\n    [projectId, 'en-GB', 'EU', 'education_only']\n  );\n}\n"],"mappings":";AAEA,eAAsB,6BAA6B,QAGhD;CACD,MAAM,EAAE,WAAW,OAAO;AAM1B,MAJiB,MAAM,GAAG,MACxB,yEACA,CAAC,UAAU,CACZ,EACa,KAAK,IAAI,QAAmB,EAAG;AAE7C,OAAM,GAAG,QACP;+BAEA;EAAC;EAAW;EAAS;EAAM;EAAiB,CAC7C"}

package/dist/ui/PolicySafeKnowledgeAssistantDashboard.d.ts

@@ -0,0 +1,7 @@
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/ui/PolicySafeKnowledgeAssistantDashboard.d.ts
+declare function PolicySafeKnowledgeAssistantDashboard(): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { PolicySafeKnowledgeAssistantDashboard };
+//# sourceMappingURL=PolicySafeKnowledgeAssistantDashboard.d.ts.map

package/dist/ui/PolicySafeKnowledgeAssistantDashboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolicySafeKnowledgeAssistantDashboard.d.ts","names":[],"sources":["../../src/ui/PolicySafeKnowledgeAssistantDashboard.tsx"],"sourcesContent":[],"mappings":";;;iBAyBgB,qCAAA,CAAA,GAAqC,kBAAA,CAAA,GAAA,CAAA"}

package/dist/ui/PolicySafeKnowledgeAssistantDashboard.js

@@ -0,0 +1,231 @@
+'use client';
+
+import { usePolicySafeKnowledgeAssistant } from "./hooks/usePolicySafeKnowledgeAssistant.js";
+import { useCallback, useMemo, useState } from "react";
+import { Button, ErrorState, LoaderBlock, StatCard, StatCardGroup } from "@contractspec/lib.design-system";
+import { Card } from "@contractspec/lib.ui-kit-web/ui/card";
+import { Input } from "@contractspec/lib.ui-kit-web/ui/input";
+import { Textarea } from "@contractspec/lib.ui-kit-web/ui/textarea";
+import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "@contractspec/lib.ui-kit-web/ui/select";
+import { jsx, jsxs } from "react/jsx-runtime";
+
+//#region src/ui/PolicySafeKnowledgeAssistantDashboard.tsx
+function PolicySafeKnowledgeAssistantDashboard() {
+	const { state, actions } = usePolicySafeKnowledgeAssistant();
+	const [question, setQuestion] = useState("reporting obligations");
+	const [content, setContent] = useState("EU: Reporting obligations v2 (updated)");
+	const [locale, setLocale] = useState("en-GB");
+	const [jurisdiction, setJurisdiction] = useState("EU");
+	const [allowedScope, setAllowedScope] = useState("education_only");
+	const snapshotId = state.context?.kbSnapshotId ?? state.lastSnapshotId ?? null;
+	const stats = useMemo(() => {
+		return [
+			{
+				label: "Locale",
+				value: state.context?.locale ?? "—"
+			},
+			{
+				label: "Jurisdiction",
+				value: state.context?.jurisdiction ?? "—"
+			},
+			{
+				label: "Scope",
+				value: state.context?.allowedScope ?? "—"
+			},
+			{
+				label: "KB Snapshot",
+				value: snapshotId ?? "—"
+			}
+		];
+	}, [
+		snapshotId,
+		state.context?.allowedScope,
+		state.context?.jurisdiction,
+		state.context?.locale
+	]);
+	const handleSetContext = useCallback(async () => {
+		await actions.setContext({
+			locale,
+			jurisdiction,
+			allowedScope
+		});
+	}, [
+		actions,
+		allowedScope,
+		jurisdiction,
+		locale
+	]);
+	const handleAsk = useCallback(async () => {
+		await actions.askAssistant(question);
+	}, [actions, question]);
+	const handleAdminPublishFlow = useCallback(async () => {
+		const ruleId = state.lastRuleId ?? await actions.createDemoRule();
+		const rvId = await actions.upsertRuleVersion({
+			ruleId,
+			content
+		});
+		await actions.approveRuleVersion(rvId);
+		await actions.simulateHighRiskChangeAndApprove(rvId);
+		await actions.publishSnapshot();
+	}, [
+		actions,
+		content,
+		state.lastRuleId
+	]);
+	if (state.loading && !state.context) return /* @__PURE__ */ jsx(LoaderBlock, { label: "Loading demo..." });
+	if (state.error) return /* @__PURE__ */ jsx(ErrorState, {
+		title: "Failed to load demo",
+		description: state.error.message,
+		onRetry: actions.refreshContext,
+		retryLabel: "Retry"
+	});
+	return /* @__PURE__ */ jsxs("div", {
+		className: "space-y-6",
+		children: [
+			/* @__PURE__ */ jsx(StatCardGroup, { children: stats.map((s) => /* @__PURE__ */ jsx(StatCard, {
+				label: s.label,
+				value: String(s.value)
+			}, s.label)) }),
+			/* @__PURE__ */ jsxs(Card, {
+				className: "p-4",
+				children: [
+					/* @__PURE__ */ jsx("h3", {
+						className: "text-lg font-semibold",
+						children: "1) Onboarding (explicit locale + jurisdiction)"
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "mt-3 grid gap-3 md:grid-cols-3",
+						children: [
+							/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("div", {
+								className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+								children: "Locale"
+							}), /* @__PURE__ */ jsx(Input, {
+								value: locale,
+								onChange: (e) => setLocale(e.target.value)
+							})] }),
+							/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("div", {
+								className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+								children: "Jurisdiction"
+							}), /* @__PURE__ */ jsx(Input, {
+								value: jurisdiction,
+								onChange: (e) => setJurisdiction(e.target.value)
+							})] }),
+							/* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("div", {
+								className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+								children: "Allowed scope"
+							}), /* @__PURE__ */ jsxs(Select, {
+								value: allowedScope,
+								onValueChange: (v) => setAllowedScope(v),
+								children: [/* @__PURE__ */ jsx(SelectTrigger, { children: /* @__PURE__ */ jsx(SelectValue, { placeholder: "Select scope" }) }), /* @__PURE__ */ jsxs(SelectContent, { children: [
+									/* @__PURE__ */ jsx(SelectItem, {
+										value: "education_only",
+										children: "education_only"
+									}),
+									/* @__PURE__ */ jsx(SelectItem, {
+										value: "generic_info",
+										children: "generic_info"
+									}),
+									/* @__PURE__ */ jsx(SelectItem, {
+										value: "escalation_required",
+										children: "escalation_required"
+									})
+								] })]
+							})] })
+						]
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "mt-4 flex gap-2",
+						children: [/* @__PURE__ */ jsx(Button, {
+							onPress: handleSetContext,
+							children: "Save context"
+						}), /* @__PURE__ */ jsx(Button, {
+							variant: "outline",
+							onPress: actions.refreshContext,
+							children: "Refresh"
+						})]
+					})
+				]
+			}),
+			/* @__PURE__ */ jsxs(Card, {
+				className: "p-4",
+				children: [
+					/* @__PURE__ */ jsx("h3", {
+						className: "text-lg font-semibold",
+						children: "2) Ask the assistant (must cite KB snapshot)"
+					}),
+					/* @__PURE__ */ jsxs("div", {
+						className: "mt-3 flex flex-col gap-3",
+						children: [/* @__PURE__ */ jsx(Input, {
+							value: question,
+							onChange: (e) => setQuestion(e.target.value)
+						}), /* @__PURE__ */ jsx("div", {
+							className: "flex gap-2",
+							children: /* @__PURE__ */ jsx(Button, {
+								onPress: handleAsk,
+								children: "Ask"
+							})
+						})]
+					}),
+					state.lastAnswer ? /* @__PURE__ */ jsxs("div", {
+						className: "mt-4 space-y-3",
+						children: [
+							state.lastAnswer.refused ? /* @__PURE__ */ jsxs("div", {
+								className: "text-sm text-red-600",
+								children: ["Refused: ", state.lastAnswer.refusalReason ?? "UNKNOWN"]
+							}) : null,
+							state.lastAnswer.sections.map((s, idx) => /* @__PURE__ */ jsxs("div", { children: [/* @__PURE__ */ jsx("div", {
+								className: "text-sm font-semibold",
+								children: s.heading
+							}), /* @__PURE__ */ jsx("div", {
+								className: "text-muted-foreground text-sm",
+								children: s.body
+							})] }, `${s.heading}-${idx}`)),
+							/* @__PURE__ */ jsx("div", {
+								className: "text-sm font-semibold",
+								children: "Citations"
+							}),
+							/* @__PURE__ */ jsx("ul", {
+								className: "text-muted-foreground list-disc pl-5 text-sm",
+								children: state.lastAnswer.citations.map((c) => /* @__PURE__ */ jsxs("li", { children: [
+									c.kbSnapshotId,
+									" — ",
+									c.sourceId
+								] }, `${c.kbSnapshotId}-${c.sourceId}`))
+							})
+						]
+					}) : null
+				]
+			}),
+			/* @__PURE__ */ jsxs(Card, {
+				className: "p-4",
+				children: [/* @__PURE__ */ jsx("h3", {
+					className: "text-lg font-semibold",
+					children: "3) Admin: publish a new snapshot (HITL)"
+				}), /* @__PURE__ */ jsxs("div", {
+					className: "mt-3 space-y-3",
+					children: [/* @__PURE__ */ jsx(Textarea, {
+						value: content,
+						onChange: (e) => setContent(e.target.value)
+					}), /* @__PURE__ */ jsx(Button, {
+						onPress: handleAdminPublishFlow,
+						children: "Simulate change → review → approve → publish snapshot"
+					})]
+				})]
+			}),
+			/* @__PURE__ */ jsxs(Card, {
+				className: "p-4",
+				children: [/* @__PURE__ */ jsx("h3", {
+					className: "text-lg font-semibold",
+					children: "4) Learning hub (patterns)"
+				}), /* @__PURE__ */ jsx("p", {
+					className: "text-muted-foreground mt-2 text-sm",
+					children: "This template includes drills, ambient coach, and quests as reusable Learning Journey tracks. The interactive learning UI is demonstrated in dedicated Learning Journey examples."
+				})]
+			})
+		]
+	});
+}
+
+//#endregion
+export { PolicySafeKnowledgeAssistantDashboard };
+//# sourceMappingURL=PolicySafeKnowledgeAssistantDashboard.js.map

package/dist/ui/PolicySafeKnowledgeAssistantDashboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PolicySafeKnowledgeAssistantDashboard.js","names":[],"sources":["../../src/ui/PolicySafeKnowledgeAssistantDashboard.tsx"],"sourcesContent":["'use client';\n\nimport { useCallback, useMemo, useState } from 'react';\nimport {\n  Button,\n  ErrorState,\n  LoaderBlock,\n  StatCard,\n  StatCardGroup,\n} from '@contractspec/lib.design-system';\nimport { Card } from '@contractspec/lib.ui-kit-web/ui/card';\nimport { Input } from '@contractspec/lib.ui-kit-web/ui/input';\nimport { Textarea } from '@contractspec/lib.ui-kit-web/ui/textarea';\nimport {\n  Select,\n  SelectContent,\n  SelectItem,\n  SelectTrigger,\n  SelectValue,\n} from '@contractspec/lib.ui-kit-web/ui/select';\n\nimport { usePolicySafeKnowledgeAssistant } from './hooks/usePolicySafeKnowledgeAssistant';\n\ntype AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';\n\nexport function PolicySafeKnowledgeAssistantDashboard() {\n  const { state, actions } = usePolicySafeKnowledgeAssistant();\n  const [question, setQuestion] = useState('reporting obligations');\n  const [content, setContent] = useState(\n    'EU: Reporting obligations v2 (updated)'\n  );\n  const [locale, setLocale] = useState('en-GB');\n  const [jurisdiction, setJurisdiction] = useState('EU');\n  const [allowedScope, setAllowedScope] =\n    useState<AllowedScope>('education_only');\n\n  const snapshotId =\n    state.context?.kbSnapshotId ?? state.lastSnapshotId ?? null;\n\n  const stats = useMemo(() => {\n    return [\n      { label: 'Locale', value: state.context?.locale ?? '—' },\n      { label: 'Jurisdiction', value: state.context?.jurisdiction ?? '—' },\n      { label: 'Scope', value: state.context?.allowedScope ?? '—' },\n      { label: 'KB Snapshot', value: snapshotId ?? '—' },\n    ];\n  }, [\n    snapshotId,\n    state.context?.allowedScope,\n    state.context?.jurisdiction,\n    state.context?.locale,\n  ]);\n\n  const handleSetContext = useCallback(async () => {\n    await actions.setContext({ locale, jurisdiction, allowedScope });\n  }, [actions, allowedScope, jurisdiction, locale]);\n\n  const handleAsk = useCallback(async () => {\n    await actions.askAssistant(question);\n  }, [actions, question]);\n\n  const handleAdminPublishFlow = useCallback(async () => {\n    const ruleId = state.lastRuleId ?? (await actions.createDemoRule());\n    const rvId = await actions.upsertRuleVersion({ ruleId, content });\n    await actions.approveRuleVersion(rvId);\n    await actions.simulateHighRiskChangeAndApprove(rvId);\n    await actions.publishSnapshot();\n  }, [actions, content, state.lastRuleId]);\n\n  if (state.loading && !state.context) {\n    return <LoaderBlock label=\"Loading demo...\" />;\n  }\n\n  if (state.error) {\n    return (\n      <ErrorState\n        title=\"Failed to load demo\"\n        description={state.error.message}\n        onRetry={actions.refreshContext}\n        retryLabel=\"Retry\"\n      />\n    );\n  }\n\n  return (\n    <div className=\"space-y-6\">\n      <StatCardGroup>\n        {stats.map((s) => (\n          <StatCard key={s.label} label={s.label} value={String(s.value)} />\n        ))}\n      </StatCardGroup>\n\n      <Card className=\"p-4\">\n        <h3 className=\"text-lg font-semibold\">\n          1) Onboarding (explicit locale + jurisdiction)\n        </h3>\n        <div className=\"mt-3 grid gap-3 md:grid-cols-3\">\n          <div>\n            <div className=\"text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase\">\n              Locale\n            </div>\n            <Input value={locale} onChange={(e) => setLocale(e.target.value)} />\n          </div>\n          <div>\n            <div className=\"text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase\">\n              Jurisdiction\n            </div>\n            <Input\n              value={jurisdiction}\n              onChange={(e) => setJurisdiction(e.target.value)}\n            />\n          </div>\n          <div>\n            <div className=\"text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase\">\n              Allowed scope\n            </div>\n            <Select\n              value={allowedScope}\n              onValueChange={(v) => setAllowedScope(v as AllowedScope)}\n            >\n              <SelectTrigger>\n                <SelectValue placeholder=\"Select scope\" />\n              </SelectTrigger>\n              <SelectContent>\n                <SelectItem value=\"education_only\">education_only</SelectItem>\n                <SelectItem value=\"generic_info\">generic_info</SelectItem>\n                <SelectItem value=\"escalation_required\">\n                  escalation_required\n                </SelectItem>\n              </SelectContent>\n            </Select>\n          </div>\n        </div>\n        <div className=\"mt-4 flex gap-2\">\n          <Button onPress={handleSetContext}>Save context</Button>\n          <Button variant=\"outline\" onPress={actions.refreshContext}>\n            Refresh\n          </Button>\n        </div>\n      </Card>\n\n      <Card className=\"p-4\">\n        <h3 className=\"text-lg font-semibold\">\n          2) Ask the assistant (must cite KB snapshot)\n        </h3>\n        <div className=\"mt-3 flex flex-col gap-3\">\n          <Input\n            value={question}\n            onChange={(e) => setQuestion(e.target.value)}\n          />\n          <div className=\"flex gap-2\">\n            <Button onPress={handleAsk}>Ask</Button>\n          </div>\n        </div>\n\n        {state.lastAnswer ? (\n          <div className=\"mt-4 space-y-3\">\n            {state.lastAnswer.refused ? (\n              <div className=\"text-sm text-red-600\">\n                Refused: {state.lastAnswer.refusalReason ?? 'UNKNOWN'}\n              </div>\n            ) : null}\n            {state.lastAnswer.sections.map((s, idx) => (\n              <div key={`${s.heading}-${idx}`}>\n                <div className=\"text-sm font-semibold\">{s.heading}</div>\n                <div className=\"text-muted-foreground text-sm\">{s.body}</div>\n              </div>\n            ))}\n            <div className=\"text-sm font-semibold\">Citations</div>\n            <ul className=\"text-muted-foreground list-disc pl-5 text-sm\">\n              {state.lastAnswer.citations.map((c) => (\n                <li key={`${c.kbSnapshotId}-${c.sourceId}`}>\n                  {c.kbSnapshotId} — {c.sourceId}\n                </li>\n              ))}\n            </ul>\n          </div>\n        ) : null}\n      </Card>\n\n      <Card className=\"p-4\">\n        <h3 className=\"text-lg font-semibold\">\n          3) Admin: publish a new snapshot (HITL)\n        </h3>\n        <div className=\"mt-3 space-y-3\">\n          <Textarea\n            value={content}\n            onChange={(e) => setContent(e.target.value)}\n          />\n          <Button onPress={handleAdminPublishFlow}>\n            Simulate change → review → approve → publish snapshot\n          </Button>\n        </div>\n      </Card>\n\n      <Card className=\"p-4\">\n        <h3 className=\"text-lg font-semibold\">4) Learning hub (patterns)</h3>\n        <p className=\"text-muted-foreground mt-2 text-sm\">\n          This template includes drills, ambient coach, and quests as reusable\n          Learning Journey tracks. The interactive learning UI is demonstrated\n          in dedicated Learning Journey examples.\n        </p>\n      </Card>\n    </div>\n  );\n}\n"],"mappings":"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"}

package/dist/ui/hooks/usePolicySafeKnowledgeAssistant.d.ts

@@ -0,0 +1,55 @@
+//#region src/ui/hooks/usePolicySafeKnowledgeAssistant.d.ts
+type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
+interface UsePolicySafeKnowledgeAssistantState {
+  context: {
+    locale: string;
+    jurisdiction: string;
+    allowedScope: AllowedScope;
+    kbSnapshotId: string | null;
+  } | null;
+  loading: boolean;
+  error: Error | null;
+  lastAnswer: {
+    refused?: boolean;
+    refusalReason?: string;
+    sections: {
+      heading: string;
+      body: string;
+    }[];
+    citations: {
+      kbSnapshotId: string;
+      sourceId: string;
+      excerpt?: string;
+    }[];
+  } | null;
+  lastRuleId: string | null;
+  lastRuleVersionId: string | null;
+  lastSnapshotId: string | null;
+  lastReviewTaskId: string | null;
+}
+declare function usePolicySafeKnowledgeAssistant(): {
+  state: UsePolicySafeKnowledgeAssistantState;
+  derived: {
+    projectId: string;
+  };
+  actions: {
+    refreshContext: () => Promise<void>;
+    setContext: (input: {
+      locale: string;
+      jurisdiction: string;
+      allowedScope: AllowedScope;
+    }) => Promise<void>;
+    askAssistant: (question: string) => Promise<void>;
+    createDemoRule: () => Promise<string>;
+    upsertRuleVersion: (input: {
+      ruleId: string;
+      content: string;
+    }) => Promise<string>;
+    approveRuleVersion: (ruleVersionId: string) => Promise<void>;
+    publishSnapshot: () => Promise<string>;
+    simulateHighRiskChangeAndApprove: (ruleVersionId: string) => Promise<string>;
+  };
+};
+//#endregion
+export { UsePolicySafeKnowledgeAssistantState, usePolicySafeKnowledgeAssistant };
+//# sourceMappingURL=usePolicySafeKnowledgeAssistant.d.ts.map

package/dist/ui/hooks/usePolicySafeKnowledgeAssistant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePolicySafeKnowledgeAssistant.d.ts","names":[],"sources":["../../../src/ui/hooks/usePolicySafeKnowledgeAssistant.ts"],"sourcesContent":[],"mappings":";KAKK,YAAA;AAAA,UAGY,oCAAA,CAHA;EAGA,OAAA,EAAA;IAsDD,MAAA,EAAA,MAAA;;kBAlDE;IAkGE,YAAA,EAAA,MAAA,GAAA,IAAA;EACf,CAAA,GAAA,IAAA;EAgBsB,OAAA,EAAA,OAAA;SA/GlB;EA4I4C,UAAA,EAAA;IAcrB,OAAA,CAAA,EAAA,OAAA;;IAkBA,QAAA,EAAA;MAAA,OAAA,EAAA,MAAA;;;;;;;;;;;;;;iBA9HhB,+BAAA,CAAA;;;;;;;;;;oBAgDI;UACf;wCAgBsB;;;;;UA6B0B;mDAcrB;;iEAkBA"}