@contractspec/example.policy-safe-knowledge-assistant 1.46.1 → 1.48.0

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":";;;;;;;;;;;;AAyBA,SAAgB,wCAAwC;CACtD,MAAM,EAAE,OAAO,YAAY,iCAAiC;CAC5D,MAAM,CAAC,UAAU,eAAe,SAAS,wBAAwB;CACjE,MAAM,CAAC,SAAS,cAAc,SAC5B,yCACD;CACD,MAAM,CAAC,QAAQ,aAAa,SAAS,QAAQ;CAC7C,MAAM,CAAC,cAAc,mBAAmB,SAAS,KAAK;CACtD,MAAM,CAAC,cAAc,mBACnB,SAAuB,iBAAiB;CAE1C,MAAM,aACJ,MAAM,SAAS,gBAAgB,MAAM,kBAAkB;CAEzD,MAAM,QAAQ,cAAc;AAC1B,SAAO;GACL;IAAE,OAAO;IAAU,OAAO,MAAM,SAAS,UAAU;IAAK;GACxD;IAAE,OAAO;IAAgB,OAAO,MAAM,SAAS,gBAAgB;IAAK;GACpE;IAAE,OAAO;IAAS,OAAO,MAAM,SAAS,gBAAgB;IAAK;GAC7D;IAAE,OAAO;IAAe,OAAO,cAAc;IAAK;GACnD;IACA;EACD;EACA,MAAM,SAAS;EACf,MAAM,SAAS;EACf,MAAM,SAAS;EAChB,CAAC;CAEF,MAAM,mBAAmB,YAAY,YAAY;AAC/C,QAAM,QAAQ,WAAW;GAAE;GAAQ;GAAc;GAAc,CAAC;IAC/D;EAAC;EAAS;EAAc;EAAc;EAAO,CAAC;CAEjD,MAAM,YAAY,YAAY,YAAY;AACxC,QAAM,QAAQ,aAAa,SAAS;IACnC,CAAC,SAAS,SAAS,CAAC;CAEvB,MAAM,yBAAyB,YAAY,YAAY;EACrD,MAAM,SAAS,MAAM,cAAe,MAAM,QAAQ,gBAAgB;EAClE,MAAM,OAAO,MAAM,QAAQ,kBAAkB;GAAE;GAAQ;GAAS,CAAC;AACjE,QAAM,QAAQ,mBAAmB,KAAK;AACtC,QAAM,QAAQ,iCAAiC,KAAK;AACpD,QAAM,QAAQ,iBAAiB;IAC9B;EAAC;EAAS;EAAS,MAAM;EAAW,CAAC;AAExC,KAAI,MAAM,WAAW,CAAC,MAAM,QAC1B,QAAO,oBAAC,eAAY,OAAM,oBAAoB;AAGhD,KAAI,MAAM,MACR,QACE,oBAAC;EACC,OAAM;EACN,aAAa,MAAM,MAAM;EACzB,SAAS,QAAQ;EACjB,YAAW;GACX;AAIN,QACE,qBAAC;EAAI,WAAU;;GACb,oBAAC,2BACE,MAAM,KAAK,MACV,oBAAC;IAAuB,OAAO,EAAE;IAAO,OAAO,OAAO,EAAE,MAAM;MAA/C,EAAE,MAAiD,CAClE,GACY;GAEhB,qBAAC;IAAK,WAAU;;KACd,oBAAC;MAAG,WAAU;gBAAwB;OAEjC;KACL,qBAAC;MAAI,WAAU;;OACb,qBAAC,oBACC,oBAAC;QAAI,WAAU;kBAA2E;SAEpF,EACN,oBAAC;QAAM,OAAO;QAAQ,WAAW,MAAM,UAAU,EAAE,OAAO,MAAM;SAAI,IAChE;OACN,qBAAC,oBACC,oBAAC;QAAI,WAAU;kBAA2E;SAEpF,EACN,oBAAC;QACC,OAAO;QACP,WAAW,MAAM,gBAAgB,EAAE,OAAO,MAAM;SAChD,IACE;OACN,qBAAC,oBACC,oBAAC;QAAI,WAAU;kBAA2E;SAEpF,EACN,qBAAC;QACC,OAAO;QACP,gBAAgB,MAAM,gBAAgB,EAAkB;mBAExD,oBAAC,2BACC,oBAAC,eAAY,aAAY,iBAAiB,GAC5B,EAChB,qBAAC;SACC,oBAAC;UAAW,OAAM;oBAAiB;WAA2B;SAC9D,oBAAC;UAAW,OAAM;oBAAe;WAAyB;SAC1D,oBAAC;UAAW,OAAM;oBAAsB;WAE3B;YACC;SACT,IACL;;OACF;KACN,qBAAC;MAAI,WAAU;iBACb,oBAAC;OAAO,SAAS;iBAAkB;QAAqB,EACxD,oBAAC;OAAO,SAAQ;OAAU,SAAS,QAAQ;iBAAgB;QAElD;OACL;;KACD;GAEP,qBAAC;IAAK,WAAU;;KACd,oBAAC;MAAG,WAAU;gBAAwB;OAEjC;KACL,qBAAC;MAAI,WAAU;iBACb,oBAAC;OACC,OAAO;OACP,WAAW,MAAM,YAAY,EAAE,OAAO,MAAM;QAC5C,EACF,oBAAC;OAAI,WAAU;iBACb,oBAAC;QAAO,SAAS;kBAAW;SAAY;QACpC;OACF;KAEL,MAAM,aACL,qBAAC;MAAI,WAAU;;OACZ,MAAM,WAAW,UAChB,qBAAC;QAAI,WAAU;mBAAuB,aAC1B,MAAM,WAAW,iBAAiB;SACxC,GACJ;OACH,MAAM,WAAW,SAAS,KAAK,GAAG,QACjC,qBAAC,oBACC,oBAAC;QAAI,WAAU;kBAAyB,EAAE;SAAc,EACxD,oBAAC;QAAI,WAAU;kBAAiC,EAAE;SAAW,KAFrD,GAAG,EAAE,QAAQ,GAAG,MAGpB,CACN;OACF,oBAAC;QAAI,WAAU;kBAAwB;SAAe;OACtD,oBAAC;QAAG,WAAU;kBACX,MAAM,WAAW,UAAU,KAAK,MAC/B,qBAAC;SACE,EAAE;SAAa;SAAI,EAAE;aADf,GAAG,EAAE,aAAa,GAAG,EAAE,WAE3B,CACL;SACC;;OACD,GACJ;;KACC;GAEP,qBAAC;IAAK,WAAU;eACd,oBAAC;KAAG,WAAU;eAAwB;MAEjC,EACL,qBAAC;KAAI,WAAU;gBACb,oBAAC;MACC,OAAO;MACP,WAAW,MAAM,WAAW,EAAE,OAAO,MAAM;OAC3C,EACF,oBAAC;MAAO,SAAS;gBAAwB;OAEhC;MACL;KACD;GAEP,qBAAC;IAAK,WAAU;eACd,oBAAC;KAAG,WAAU;eAAwB;MAA+B,EACrE,oBAAC;KAAE,WAAU;eAAqC;MAI9C;KACC;;GACH"}

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"}

package/dist/ui/hooks/usePolicySafeKnowledgeAssistant.js

@@ -0,0 +1,193 @@
+'use client';
+
+import { useCallback, useEffect, useMemo, useState } from "react";
+import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
+
+//#region src/ui/hooks/usePolicySafeKnowledgeAssistant.ts
+function isCitationLike(value) {
+	if (!value || typeof value !== "object") return false;
+	const v = value;
+	return typeof v.kbSnapshotId === "string" && typeof v.sourceId === "string";
+}
+function toCitations(value) {
+	if (!Array.isArray(value)) return [];
+	return value.filter(isCitationLike).map((c) => ({
+		kbSnapshotId: c.kbSnapshotId,
+		sourceId: c.sourceId,
+		excerpt: c.excerpt
+	}));
+}
+function usePolicySafeKnowledgeAssistant() {
+	const { handlers, projectId } = useTemplateRuntime();
+	const api = handlers.policySafeKnowledgeAssistant;
+	const [state, setState] = useState({
+		context: null,
+		loading: true,
+		error: null,
+		lastAnswer: null,
+		lastRuleId: null,
+		lastRuleVersionId: null,
+		lastSnapshotId: null,
+		lastReviewTaskId: null
+	});
+	const refreshContext = useCallback(async () => {
+		try {
+			setState((s) => ({
+				...s,
+				loading: true,
+				error: null
+			}));
+			const ctx = await api.getUserContext({ projectId });
+			setState((s) => ({
+				...s,
+				context: {
+					locale: ctx.locale,
+					jurisdiction: ctx.jurisdiction,
+					allowedScope: ctx.allowedScope,
+					kbSnapshotId: ctx.kbSnapshotId
+				},
+				loading: false
+			}));
+		} catch (e) {
+			setState((s) => ({
+				...s,
+				loading: false,
+				error: e instanceof Error ? e : /* @__PURE__ */ new Error("Unknown error")
+			}));
+		}
+	}, [api, projectId]);
+	useEffect(() => {
+		refreshContext();
+	}, [refreshContext]);
+	const setContext = useCallback(async (input) => {
+		const ctx = await api.setUserContext({
+			projectId,
+			...input
+		});
+		setState((s) => ({
+			...s,
+			context: {
+				locale: ctx.locale,
+				jurisdiction: ctx.jurisdiction,
+				allowedScope: ctx.allowedScope,
+				kbSnapshotId: ctx.kbSnapshotId
+			}
+		}));
+	}, [api, projectId]);
+	const askAssistant = useCallback(async (question) => {
+		const answerUnknown = await api.answer({
+			projectId,
+			question
+		});
+		const answer = answerUnknown;
+		setState((s) => ({
+			...s,
+			lastAnswer: {
+				refused: answer.refused,
+				refusalReason: answer.refusalReason,
+				sections: answer.sections,
+				citations: toCitations(answerUnknown.citations)
+			}
+		}));
+	}, [api, projectId]);
+	const createDemoRule = useCallback(async () => {
+		const rule = await api.createRule({
+			projectId,
+			jurisdiction: state.context?.jurisdiction ?? "EU",
+			topicKey: "tax_reporting"
+		});
+		setState((s) => ({
+			...s,
+			lastRuleId: rule.id
+		}));
+		return rule.id;
+	}, [
+		api,
+		projectId,
+		state.context?.jurisdiction
+	]);
+	const upsertRuleVersion = useCallback(async (input) => {
+		const rv = await api.upsertRuleVersion({
+			projectId,
+			ruleId: input.ruleId,
+			content: input.content,
+			sourceRefs: [{
+				sourceDocumentId: "src_demo",
+				excerpt: "demo excerpt"
+			}]
+		});
+		setState((s) => ({
+			...s,
+			lastRuleVersionId: rv.id
+		}));
+		return rv.id;
+	}, [api, projectId]);
+	const approveRuleVersion = useCallback(async (ruleVersionId) => {
+		await api.approveRuleVersion({
+			ruleVersionId,
+			approver: "demo_expert"
+		});
+	}, [api]);
+	const publishSnapshot = useCallback(async () => {
+		const snap = await api.publishSnapshot({
+			projectId,
+			jurisdiction: state.context?.jurisdiction ?? "EU",
+			asOfDate: /* @__PURE__ */ new Date("2026-02-01T00:00:00.000Z")
+		});
+		setState((s) => ({
+			...s,
+			lastSnapshotId: snap.id
+		}));
+		await refreshContext();
+		return snap.id;
+	}, [
+		api,
+		projectId,
+		refreshContext,
+		state.context?.jurisdiction
+	]);
+	const simulateHighRiskChangeAndApprove = useCallback(async (ruleVersionId) => {
+		const cand = await api.createChangeCandidate({
+			projectId,
+			jurisdiction: state.context?.jurisdiction ?? "EU",
+			diffSummary: "Simulated change (demo)",
+			riskLevel: "high",
+			proposedRuleVersionIds: [ruleVersionId]
+		});
+		const review = await api.createReviewTask({ changeCandidateId: cand.id });
+		setState((s) => ({
+			...s,
+			lastReviewTaskId: review.id
+		}));
+		await api.submitDecision({
+			reviewTaskId: review.id,
+			decision: "approve",
+			decidedByRole: "expert",
+			decidedBy: "demo_expert"
+		});
+		await api.publishIfReady({ jurisdiction: state.context?.jurisdiction ?? "EU" });
+		return review.id;
+	}, [
+		api,
+		projectId,
+		state.context?.jurisdiction
+	]);
+	return {
+		state,
+		derived: useMemo(() => ({ projectId }), [projectId]),
+		actions: {
+			refreshContext,
+			setContext,
+			askAssistant,
+			createDemoRule,
+			upsertRuleVersion,
+			approveRuleVersion,
+			publishSnapshot,
+			simulateHighRiskChangeAndApprove
+		}
+	};
+}
+
+//#endregion
+export { usePolicySafeKnowledgeAssistant };
+//# sourceMappingURL=usePolicySafeKnowledgeAssistant.js.map

package/dist/ui/hooks/usePolicySafeKnowledgeAssistant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePolicySafeKnowledgeAssistant.js","names":[],"sources":["../../../src/ui/hooks/usePolicySafeKnowledgeAssistant.ts"],"sourcesContent":["'use client';\n\nimport { useCallback, useEffect, useMemo, useState } from 'react';\nimport { useTemplateRuntime } from '@contractspec/lib.example-shared-ui';\n\ntype AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';\ntype RiskLevel = 'low' | 'medium' | 'high';\n\nexport interface UsePolicySafeKnowledgeAssistantState {\n  context: {\n    locale: string;\n    jurisdiction: string;\n    allowedScope: AllowedScope;\n    kbSnapshotId: string | null;\n  } | null;\n  loading: boolean;\n  error: Error | null;\n  lastAnswer: {\n    refused?: boolean;\n    refusalReason?: string;\n    sections: { heading: string; body: string }[];\n    citations: {\n      kbSnapshotId: string;\n      sourceId: string;\n      excerpt?: string;\n    }[];\n  } | null;\n  lastRuleId: string | null;\n  lastRuleVersionId: string | null;\n  lastSnapshotId: string | null;\n  lastReviewTaskId: string | null;\n}\n\ninterface CitationLike {\n  kbSnapshotId: string;\n  sourceId: string;\n  excerpt?: string;\n}\ninterface AnswerLike {\n  refused?: boolean;\n  refusalReason?: string;\n  sections: { heading: string; body: string }[];\n  citations: CitationLike[];\n}\n\nfunction isCitationLike(value: unknown): value is CitationLike {\n  if (!value || typeof value !== 'object') return false;\n  const v = value as Record<string, unknown>;\n  return typeof v.kbSnapshotId === 'string' && typeof v.sourceId === 'string';\n}\n\nfunction toCitations(value: unknown): CitationLike[] {\n  if (!Array.isArray(value)) return [];\n  return value.filter(isCitationLike).map((c) => ({\n    kbSnapshotId: c.kbSnapshotId,\n    sourceId: c.sourceId,\n    excerpt: c.excerpt,\n  }));\n}\n\nimport type { PolicySafeKnowledgeAssistantHandlers } from '../../handlers/policy-safe-knowledge-assistant.handlers';\n\nexport function usePolicySafeKnowledgeAssistant() {\n  const { handlers, projectId } = useTemplateRuntime<{\n    policySafeKnowledgeAssistant: PolicySafeKnowledgeAssistantHandlers;\n  }>();\n  const api = handlers.policySafeKnowledgeAssistant;\n\n  const [state, setState] = useState<UsePolicySafeKnowledgeAssistantState>({\n    context: null,\n    loading: true,\n    error: null,\n    lastAnswer: null,\n    lastRuleId: null,\n    lastRuleVersionId: null,\n    lastSnapshotId: null,\n    lastReviewTaskId: null,\n  });\n\n  const refreshContext = useCallback(async () => {\n    try {\n      setState((s) => ({ ...s, loading: true, error: null }));\n      const ctx = await api.getUserContext({ projectId });\n      setState((s) => ({\n        ...s,\n        context: {\n          locale: ctx.locale,\n          jurisdiction: ctx.jurisdiction,\n          allowedScope: ctx.allowedScope,\n          kbSnapshotId: ctx.kbSnapshotId,\n        },\n        loading: false,\n      }));\n    } catch (e) {\n      setState((s) => ({\n        ...s,\n        loading: false,\n        error: e instanceof Error ? e : new Error('Unknown error'),\n      }));\n    }\n  }, [api, projectId]);\n\n  useEffect(() => {\n    refreshContext();\n  }, [refreshContext]);\n\n  const setContext = useCallback(\n    async (input: {\n      locale: string;\n      jurisdiction: string;\n      allowedScope: AllowedScope;\n    }) => {\n      const ctx = await api.setUserContext({ projectId, ...input });\n      setState((s) => ({\n        ...s,\n        context: {\n          locale: ctx.locale,\n          jurisdiction: ctx.jurisdiction,\n          allowedScope: ctx.allowedScope,\n          kbSnapshotId: ctx.kbSnapshotId,\n        },\n      }));\n    },\n    [api, projectId]\n  );\n\n  const askAssistant = useCallback(\n    async (question: string) => {\n      const answerUnknown: unknown = await api.answer({ projectId, question });\n      const answer = answerUnknown as AnswerLike;\n      setState((s) => ({\n        ...s,\n        lastAnswer: {\n          refused: answer.refused,\n          refusalReason: answer.refusalReason,\n          sections: answer.sections,\n          citations: toCitations(\n            (answerUnknown as { citations?: unknown }).citations\n          ),\n        },\n      }));\n    },\n    [api, projectId]\n  );\n\n  const createDemoRule = useCallback(async () => {\n    const rule = await api.createRule({\n      projectId,\n      jurisdiction: state.context?.jurisdiction ?? 'EU',\n      topicKey: 'tax_reporting',\n    });\n    setState((s) => ({ ...s, lastRuleId: rule.id }));\n    return rule.id as string;\n  }, [api, projectId, state.context?.jurisdiction]);\n\n  const upsertRuleVersion = useCallback(\n    async (input: { ruleId: string; content: string }) => {\n      const rv = await api.upsertRuleVersion({\n        projectId,\n        ruleId: input.ruleId,\n        content: input.content,\n        sourceRefs: [{ sourceDocumentId: 'src_demo', excerpt: 'demo excerpt' }],\n      });\n      setState((s) => ({ ...s, lastRuleVersionId: rv.id }));\n      return rv.id as string;\n    },\n    [api, projectId]\n  );\n\n  const approveRuleVersion = useCallback(\n    async (ruleVersionId: string) => {\n      await api.approveRuleVersion({ ruleVersionId, approver: 'demo_expert' });\n    },\n    [api]\n  );\n\n  const publishSnapshot = useCallback(async () => {\n    const snap = await api.publishSnapshot({\n      projectId,\n      jurisdiction: state.context?.jurisdiction ?? 'EU',\n      asOfDate: new Date('2026-02-01T00:00:00.000Z'),\n    });\n    setState((s) => ({ ...s, lastSnapshotId: snap.id }));\n    await refreshContext();\n    return snap.id as string;\n  }, [api, projectId, refreshContext, state.context?.jurisdiction]);\n\n  const simulateHighRiskChangeAndApprove = useCallback(\n    async (ruleVersionId: string) => {\n      const cand = await api.createChangeCandidate({\n        projectId,\n        jurisdiction: state.context?.jurisdiction ?? 'EU',\n        diffSummary: 'Simulated change (demo)',\n        riskLevel: 'high' satisfies RiskLevel,\n        proposedRuleVersionIds: [ruleVersionId],\n      });\n      const review = await api.createReviewTask({ changeCandidateId: cand.id });\n      setState((s) => ({ ...s, lastReviewTaskId: review.id }));\n      await api.submitDecision({\n        reviewTaskId: review.id,\n        decision: 'approve',\n        decidedByRole: 'expert',\n        decidedBy: 'demo_expert',\n      });\n      await api.publishIfReady({\n        jurisdiction: state.context?.jurisdiction ?? 'EU',\n      });\n      return review.id as string;\n    },\n    [api, projectId, state.context?.jurisdiction]\n  );\n\n  const derived = useMemo(() => ({ projectId }), [projectId]);\n\n  return {\n    state,\n    derived,\n    actions: {\n      refreshContext,\n      setContext,\n      askAssistant,\n      createDemoRule,\n      upsertRuleVersion,\n      approveRuleVersion,\n      publishSnapshot,\n      simulateHighRiskChangeAndApprove,\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/ui/index.d.ts

@@ -0,0 +1,2 @@
+import { PolicySafeKnowledgeAssistantDashboard } from "./PolicySafeKnowledgeAssistantDashboard.js";
+export { PolicySafeKnowledgeAssistantDashboard };

package/dist/ui/index.js

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

package/package.json

@@ -1,20 +1,24 @@
 {
   "name": "@contractspec/example.policy-safe-knowledge-assistant",
-  "version": "1.46.1",
+  "version": "1.48.0",
   "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": {
     ".": "./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",
+    "./handlers": "./dist/handlers/index.js",
+    "./handlers/policy-safe-knowledge-assistant.handlers": "./dist/handlers/policy-safe-knowledge-assistant.handlers.js",
     "./orchestrator/buildAnswer": "./dist/orchestrator/buildAnswer.js",
+    "./policy-safe-knowledge-assistant.feature": "./dist/policy-safe-knowledge-assistant.feature.js",
     "./seed": "./dist/seed/index.js",
     "./seed/fixtures": "./dist/seed/fixtures.js",
+    "./seeders": "./dist/seeders/index.js",
+    "./ui": "./dist/ui/index.js",
+    "./ui/hooks/usePolicySafeKnowledgeAssistant": "./dist/ui/hooks/usePolicySafeKnowledgeAssistant.js",
+    "./ui/PolicySafeKnowledgeAssistantDashboard": "./dist/ui/PolicySafeKnowledgeAssistantDashboard.js",
     "./*": "./*"
   },
   "scripts": {
@@ -31,18 +35,26 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@contractspec/example.locale-jurisdiction-gate": "1.46.1",
-    "@contractspec/example.versioned-knowledge-base": "1.46.1",
-    "@contractspec/example.kb-update-pipeline": "1.46.1",
-    "@contractspec/example.learning-patterns": "1.46.1",
-    "@contractspec/lib.contracts": "1.46.1",
-    "@contractspec/module.learning-journey": "1.46.1"
+    "@contractspec/example.kb-update-pipeline": "1.48.0",
+    "@contractspec/example.learning-patterns": "1.48.0",
+    "@contractspec/example.locale-jurisdiction-gate": "1.48.0",
+    "@contractspec/example.versioned-knowledge-base": "1.48.0",
+    "@contractspec/lib.contracts": "1.48.0",
+    "@contractspec/lib.design-system": "1.48.0",
+    "@contractspec/lib.example-shared-ui": "1.2.0",
+    "@contractspec/lib.runtime-sandbox": "0.3.0",
+    "@contractspec/lib.ui-kit-web": "1.48.0",
+    "@contractspec/module.learning-journey": "1.48.0",
+    "react": "19.2.3",
+    "react-dom": "19.2.3"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.46.1",
-    "@contractspec/tool.typescript": "1.46.1",
-    "tsdown": "^0.18.3",
-    "typescript": "^5.9.3"
+    "@contractspec/tool.tsdown": "1.48.0",
+    "@contractspec/tool.typescript": "1.48.0",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3",
+    "@types/react": "^19.2.8",
+    "@types/react-dom": "^19.2.2"
   },
   "publishConfig": {
     "access": "public",
@@ -51,7 +63,7 @@
       "./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",
+      "./policy-safe-knowledge-assistant.feature": "./dist/policy-safe-knowledge-assistant.feature.js",
       "./orchestrator/buildAnswer": "./dist/orchestrator/buildAnswer.js",
       "./seed": "./dist/seed/index.js",
       "./seed/fixtures": "./dist/seed/fixtures.js",

package/src/example.ts

@@ -1,6 +1,6 @@
-import type { ExampleSpec } from '@contractspec/lib.contracts';
+import { defineExample } from '@contractspec/lib.contracts';
 
-const example: ExampleSpec = {
+const example = defineExample({
   meta: {
     key: 'policy-safe-knowledge-assistant',
     version: '1.0.0',
@@ -19,7 +19,7 @@ const example: ExampleSpec = {
   },
   entrypoints: {
     packageName: '@contractspec/example.policy-safe-knowledge-assistant',
-    feature: './feature',
+    feature: './policy-safe-knowledge-assistant.feature',
     docs: './docs',
   },
   surfaces: {
@@ -31,6 +31,6 @@ const example: ExampleSpec = {
     studio: { enabled: true, installable: true },
     mcp: { enabled: true },
   },
-};
+});
 
 export default example;

package/src/handlers/index.ts

@@ -0,0 +1 @@
+export * from './policy-safe-knowledge-assistant.handlers';