@contractspec/example.policy-safe-knowledge-assistant 3.7.16 → 3.7.18

package/dist/browser/orchestrator/buildAnswer.js

@@ -1,73 +1 @@
-// src/orchestrator/buildAnswer.ts
-import {
-  enforceAllowedScope,
-  enforceCitations,
-  validateEnvelope
-} from "@contractspec/example.locale-jurisdiction-gate/policy/guard";
-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;
-}
-export {
-  buildPolicySafeAnswer
-};
+import{enforceAllowedScope as G,enforceCitations as H,validateEnvelope as I}from"@contractspec/example.locale-jurisdiction-gate/policy/guard";async function K(k){let b=I(k.envelope);if(!b.ok)return{locale:k.envelope.locale??"en-GB",jurisdiction:k.envelope.regulatoryContext?.jurisdiction??"UNKNOWN",allowedScope:k.envelope.allowedScope??"education_only",sections:[{heading:"Request blocked",body:b.error.message}],citations:[],disclaimers:["This system refuses to answer without a valid envelope."],riskFlags:[b.error.code],refused:!0,refusalReason:b.error.code};let B=await k.kbSearch({snapshotId:b.value.kbSnapshotId,jurisdiction:b.value.regulatoryContext?.jurisdiction??"UNKNOWN",query:k.question}),F=B.items.map((D)=>({kbSnapshotId:b.value.kbSnapshotId,sourceType:"ruleVersion",sourceId:D.ruleVersionId,title:"Curated rule version",excerpt:D.excerpt})),h={locale:b.value.locale,jurisdiction:b.value.regulatoryContext?.jurisdiction??"UNKNOWN",allowedScope:b.value.allowedScope,sections:[{heading:"Answer (KB-derived)",body:B.items.length>0?`This answer is derived from ${B.items.length} curated rule version(s) in the referenced snapshot.`:"No curated knowledge found in the referenced snapshot."}],citations:F,disclaimers:["Educational demo only."],riskFlags:[]},q=G(b.value.allowedScope,h);if(!q.ok)return{...h,sections:[{heading:"Escalation required",body:q.error.message}],refused:!0,refusalReason:q.error.code,riskFlags:[...h.riskFlags??[],q.error.code]};let z=H(h);if(!z.ok)return{...h,sections:[{heading:"Request blocked",body:z.error.message}],citations:[],refused:!0,refusalReason:z.error.code,riskFlags:[...h.riskFlags??[],z.error.code]};return h}export{K as buildPolicySafeAnswer};

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

@@ -1,64 +1 @@
-// src/policy-safe-knowledge-assistant.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var 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" }
-    ]
-  },
-  policies: [{ key: "policy-safe.policy.gate", version: "1.0.0" }],
-  knowledge: [{ key: "policy-safe.knowledge.rules", version: "1.0.0" }],
-  jobs: [{ key: "policy-safe.job.pipeline-watch", version: "1.0.0" }],
-  docs: [
-    "docs.examples.policy-safe-knowledge-assistant.goal",
-    "docs.examples.policy-safe-knowledge-assistant.usage"
-  ]
-});
-export {
-  PolicySafeKnowledgeAssistantFeature
-};
+import{defineFeature as g}from"@contractspec/lib.contracts-spec";var j=g({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"}]},policies:[{key:"policy-safe.policy.gate",version:"1.0.0"}],knowledge:[{key:"policy-safe.knowledge.rules",version:"1.0.0"}],jobs:[{key:"policy-safe.job.pipeline-watch",version:"1.0.0"}],docs:["docs.examples.policy-safe-knowledge-assistant.goal","docs.examples.policy-safe-knowledge-assistant.usage"]});export{j as PolicySafeKnowledgeAssistantFeature};

package/dist/browser/seed/fixtures.js

@@ -1,35 +1 @@
-// src/seed/fixtures.ts
-var 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: 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 {
-  DEMO_FIXTURES
-};
+var 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};

package/dist/browser/seed/index.js

@@ -1,35 +1 @@
-// src/seed/fixtures.ts
-var 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: 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 {
-  DEMO_FIXTURES
-};
+var 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};

package/dist/browser/seeders/index.js

@@ -1,12 +1,2 @@
-// src/seeders/index.ts
-async function seedPolicyKnowledgeAssistant(params) {
-  const { projectId, db } = params;
-  const existing = await db.query(`SELECT COUNT(*) as count FROM psa_user_context WHERE "projectId" = $1`, [projectId]);
-  if (existing.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"]);
-}
-export {
-  seedPolicyKnowledgeAssistant
-};
+async function s(o){let{projectId:t,db:e}=o;if((await e.query('SELECT COUNT(*) as count FROM psa_user_context WHERE "projectId" = $1',[t])).rows[0]?.count>0)return;await e.execute(`INSERT INTO psa_user_context ("projectId", locale, jurisdiction, "allowedScope")
+     VALUES ($1, $2, $3, $4)`,[t,"en-GB","EU","education_only"])}export{s as seedPolicyKnowledgeAssistant};

package/dist/browser/ui/PolicySafeKnowledgeAssistantDashboard.js

@@ -1,420 +1 @@
-// src/ui/hooks/usePolicySafeKnowledgeAssistant.ts
-import { useTemplateRuntime } from "@contractspec/lib.example-shared-ui";
-import { useCallback, useEffect, useMemo, useState } from "react";
-"use client";
-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 : 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: 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]);
-  const derived = useMemo(() => ({ projectId }), [projectId]);
-  return {
-    state,
-    derived,
-    actions: {
-      refreshContext,
-      setContext,
-      askAssistant,
-      createDemoRule,
-      upsertRuleVersion,
-      approveRuleVersion,
-      publishSnapshot,
-      simulateHighRiskChangeAndApprove
-    }
-  };
-}
-
-// src/ui/PolicySafeKnowledgeAssistantDashboard.tsx
-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 {
-  Select,
-  SelectContent,
-  SelectItem,
-  SelectTrigger,
-  SelectValue
-} from "@contractspec/lib.ui-kit-web/ui/select";
-import { Textarea } from "@contractspec/lib.ui-kit-web/ui/textarea";
-import { useCallback as useCallback2, useMemo as useMemo2, useState as useState2 } from "react";
-import { jsxDEV } from "react/jsx-dev-runtime";
-"use client";
-function PolicySafeKnowledgeAssistantDashboard() {
-  const { state, actions } = usePolicySafeKnowledgeAssistant();
-  const [question, setQuestion] = useState2("reporting obligations");
-  const [content, setContent] = useState2("EU: Reporting obligations v2 (updated)");
-  const [locale, setLocale] = useState2("en-GB");
-  const [jurisdiction, setJurisdiction] = useState2("EU");
-  const [allowedScope, setAllowedScope] = useState2("education_only");
-  const snapshotId = state.context?.kbSnapshotId ?? state.lastSnapshotId ?? null;
-  const stats = useMemo2(() => {
-    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 = useCallback2(async () => {
-    await actions.setContext({ locale, jurisdiction, allowedScope });
-  }, [actions, allowedScope, jurisdiction, locale]);
-  const handleAsk = useCallback2(async () => {
-    await actions.askAssistant(question);
-  }, [actions, question]);
-  const handleAdminPublishFlow = useCallback2(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__ */ jsxDEV(LoaderBlock, {
-      label: "Loading demo..."
-    }, undefined, false, undefined, this);
-  }
-  if (state.error) {
-    return /* @__PURE__ */ jsxDEV(ErrorState, {
-      title: "Failed to load demo",
-      description: state.error.message,
-      onRetry: actions.refreshContext,
-      retryLabel: "Retry"
-    }, undefined, false, undefined, this);
-  }
-  return /* @__PURE__ */ jsxDEV("div", {
-    className: "space-y-6",
-    children: [
-      /* @__PURE__ */ jsxDEV(StatCardGroup, {
-        children: stats.map((s) => /* @__PURE__ */ jsxDEV(StatCard, {
-          label: s.label,
-          value: String(s.value)
-        }, s.label, false, undefined, this))
-      }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV(Card, {
-        className: "p-4",
-        children: [
-          /* @__PURE__ */ jsxDEV("h3", {
-            className: "font-semibold text-lg",
-            children: "1) Onboarding (explicit locale + jurisdiction)"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("div", {
-            className: "mt-3 grid gap-3 md:grid-cols-3",
-            children: [
-              /* @__PURE__ */ jsxDEV("div", {
-                children: [
-                  /* @__PURE__ */ jsxDEV("div", {
-                    className: "mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",
-                    children: "Locale"
-                  }, undefined, false, undefined, this),
-                  /* @__PURE__ */ jsxDEV(Input, {
-                    value: locale,
-                    onChange: (e) => setLocale(e.target.value)
-                  }, undefined, false, undefined, this)
-                ]
-              }, undefined, true, undefined, this),
-              /* @__PURE__ */ jsxDEV("div", {
-                children: [
-                  /* @__PURE__ */ jsxDEV("div", {
-                    className: "mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",
-                    children: "Jurisdiction"
-                  }, undefined, false, undefined, this),
-                  /* @__PURE__ */ jsxDEV(Input, {
-                    value: jurisdiction,
-                    onChange: (e) => setJurisdiction(e.target.value)
-                  }, undefined, false, undefined, this)
-                ]
-              }, undefined, true, undefined, this),
-              /* @__PURE__ */ jsxDEV("div", {
-                children: [
-                  /* @__PURE__ */ jsxDEV("div", {
-                    className: "mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",
-                    children: "Allowed scope"
-                  }, undefined, false, undefined, this),
-                  /* @__PURE__ */ jsxDEV(Select, {
-                    value: allowedScope,
-                    onValueChange: (v) => setAllowedScope(v),
-                    children: [
-                      /* @__PURE__ */ jsxDEV(SelectTrigger, {
-                        children: /* @__PURE__ */ jsxDEV(SelectValue, {
-                          placeholder: "Select scope"
-                        }, undefined, false, undefined, this)
-                      }, undefined, false, undefined, this),
-                      /* @__PURE__ */ jsxDEV(SelectContent, {
-                        children: [
-                          /* @__PURE__ */ jsxDEV(SelectItem, {
-                            value: "education_only",
-                            children: "education_only"
-                          }, undefined, false, undefined, this),
-                          /* @__PURE__ */ jsxDEV(SelectItem, {
-                            value: "generic_info",
-                            children: "generic_info"
-                          }, undefined, false, undefined, this),
-                          /* @__PURE__ */ jsxDEV(SelectItem, {
-                            value: "escalation_required",
-                            children: "escalation_required"
-                          }, undefined, false, undefined, this)
-                        ]
-                      }, undefined, true, undefined, this)
-                    ]
-                  }, undefined, true, undefined, this)
-                ]
-              }, undefined, true, undefined, this)
-            ]
-          }, undefined, true, undefined, this),
-          /* @__PURE__ */ jsxDEV("div", {
-            className: "mt-4 flex gap-2",
-            children: [
-              /* @__PURE__ */ jsxDEV(Button, {
-                onPress: handleSetContext,
-                children: "Save context"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV(Button, {
-                variant: "outline",
-                onPress: actions.refreshContext,
-                children: "Refresh"
-              }, undefined, false, undefined, this)
-            ]
-          }, undefined, true, undefined, this)
-        ]
-      }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV(Card, {
-        className: "p-4",
-        children: [
-          /* @__PURE__ */ jsxDEV("h3", {
-            className: "font-semibold text-lg",
-            children: "2) Ask the assistant (must cite KB snapshot)"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("div", {
-            className: "mt-3 flex flex-col gap-3",
-            children: [
-              /* @__PURE__ */ jsxDEV(Input, {
-                value: question,
-                onChange: (e) => setQuestion(e.target.value)
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV("div", {
-                className: "flex gap-2",
-                children: /* @__PURE__ */ jsxDEV(Button, {
-                  onPress: handleAsk,
-                  children: "Ask"
-                }, undefined, false, undefined, this)
-              }, undefined, false, undefined, this)
-            ]
-          }, undefined, true, undefined, this),
-          state.lastAnswer ? /* @__PURE__ */ jsxDEV("div", {
-            className: "mt-4 space-y-3",
-            children: [
-              state.lastAnswer.refused ? /* @__PURE__ */ jsxDEV("div", {
-                className: "text-red-600 text-sm",
-                children: [
-                  "Refused: ",
-                  state.lastAnswer.refusalReason ?? "UNKNOWN"
-                ]
-              }, undefined, true, undefined, this) : null,
-              state.lastAnswer.sections.map((s, idx) => /* @__PURE__ */ jsxDEV("div", {
-                children: [
-                  /* @__PURE__ */ jsxDEV("div", {
-                    className: "font-semibold text-sm",
-                    children: s.heading
-                  }, undefined, false, undefined, this),
-                  /* @__PURE__ */ jsxDEV("div", {
-                    className: "text-muted-foreground text-sm",
-                    children: s.body
-                  }, undefined, false, undefined, this)
-                ]
-              }, `${s.heading}-${idx}`, true, undefined, this)),
-              /* @__PURE__ */ jsxDEV("div", {
-                className: "font-semibold text-sm",
-                children: "Citations"
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV("ul", {
-                className: "list-disc pl-5 text-muted-foreground text-sm",
-                children: state.lastAnswer.citations.map((c) => /* @__PURE__ */ jsxDEV("li", {
-                  children: [
-                    c.kbSnapshotId,
-                    " — ",
-                    c.sourceId
-                  ]
-                }, `${c.kbSnapshotId}-${c.sourceId}`, true, undefined, this))
-              }, undefined, false, undefined, this)
-            ]
-          }, undefined, true, undefined, this) : null
-        ]
-      }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV(Card, {
-        className: "p-4",
-        children: [
-          /* @__PURE__ */ jsxDEV("h3", {
-            className: "font-semibold text-lg",
-            children: "3) Admin: publish a new snapshot (HITL)"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("div", {
-            className: "mt-3 space-y-3",
-            children: [
-              /* @__PURE__ */ jsxDEV(Textarea, {
-                value: content,
-                onChange: (e) => setContent(e.target.value)
-              }, undefined, false, undefined, this),
-              /* @__PURE__ */ jsxDEV(Button, {
-                onPress: handleAdminPublishFlow,
-                children: "Simulate change → review → approve → publish snapshot"
-              }, undefined, false, undefined, this)
-            ]
-          }, undefined, true, undefined, this)
-        ]
-      }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV(Card, {
-        className: "p-4",
-        children: [
-          /* @__PURE__ */ jsxDEV("h3", {
-            className: "font-semibold text-lg",
-            children: "4) Learning hub (patterns)"
-          }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV("p", {
-            className: "mt-2 text-muted-foreground 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."
-          }, undefined, false, undefined, this)
-        ]
-      }, undefined, true, undefined, this)
-    ]
-  }, undefined, true, undefined, this);
-}
-export {
-  PolicySafeKnowledgeAssistantDashboard
-};
+import{useTemplateRuntime as f}from"@contractspec/lib.example-shared-ui";import{useCallback as F,useEffect as m,useMemo as A,useState as k}from"react";function v(O){if(!O||typeof O!=="object")return!1;let z=O;return typeof z.kbSnapshotId==="string"&&typeof z.sourceId==="string"}function h(O){if(!Array.isArray(O))return[];return O.filter(v).map((z)=>({kbSnapshotId:z.kbSnapshotId,sourceId:z.sourceId,excerpt:z.excerpt}))}function V(){let{handlers:O,projectId:z}=f(),Z=O.policySafeKnowledgeAssistant,[E,$]=k({context:null,loading:!0,error:null,lastAnswer:null,lastRuleId:null,lastRuleVersionId:null,lastSnapshotId:null,lastReviewTaskId:null}),G=F(async()=>{try{$((Y)=>({...Y,loading:!0,error:null}));let X=await Z.getUserContext({projectId:z});$((Y)=>({...Y,context:{locale:X.locale,jurisdiction:X.jurisdiction,allowedScope:X.allowedScope,kbSnapshotId:X.kbSnapshotId},loading:!1}))}catch(X){$((Y)=>({...Y,loading:!1,error:X instanceof Error?X:Error("Unknown error")}))}},[Z,z]);m(()=>{G()},[G]);let H=F(async(X)=>{let Y=await Z.setUserContext({projectId:z,...X});$((D)=>({...D,context:{locale:Y.locale,jurisdiction:Y.jurisdiction,allowedScope:Y.allowedScope,kbSnapshotId:Y.kbSnapshotId}}))},[Z,z]),U=F(async(X)=>{let Y=await Z.answer({projectId:z,question:X}),D=Y;$((W)=>({...W,lastAnswer:{refused:D.refused,refusalReason:D.refusalReason,sections:D.sections,citations:h(Y.citations)}}))},[Z,z]),J=F(async()=>{let X=await Z.createRule({projectId:z,jurisdiction:E.context?.jurisdiction??"EU",topicKey:"tax_reporting"});return $((Y)=>({...Y,lastRuleId:X.id})),X.id},[Z,z,E.context?.jurisdiction]),P=F(async(X)=>{let Y=await Z.upsertRuleVersion({projectId:z,ruleId:X.ruleId,content:X.content,sourceRefs:[{sourceDocumentId:"src_demo",excerpt:"demo excerpt"}]});return $((D)=>({...D,lastRuleVersionId:Y.id})),Y.id},[Z,z]),M=F(async(X)=>{await Z.approveRuleVersion({ruleVersionId:X,approver:"demo_expert"})},[Z]),R=F(async()=>{let X=await Z.publishSnapshot({projectId:z,jurisdiction:E.context?.jurisdiction??"EU",asOfDate:new Date("2026-02-01T00:00:00.000Z")});return $((Y)=>({...Y,lastSnapshotId:X.id})),await G(),X.id},[Z,z,G,E.context?.jurisdiction]),y=F(async(X)=>{let Y=await Z.createChangeCandidate({projectId:z,jurisdiction:E.context?.jurisdiction??"EU",diffSummary:"Simulated change (demo)",riskLevel:"high",proposedRuleVersionIds:[X]}),D=await Z.createReviewTask({changeCandidateId:Y.id});return $((W)=>({...W,lastReviewTaskId:D.id})),await Z.submitDecision({reviewTaskId:D.id,decision:"approve",decidedByRole:"expert",decidedBy:"demo_expert"}),await Z.publishIfReady({jurisdiction:E.context?.jurisdiction??"EU"}),D.id},[Z,z,E.context?.jurisdiction]),b=A(()=>({projectId:z}),[z]);return{state:E,derived:b,actions:{refreshContext:G,setContext:H,askAssistant:U,createDemoRule:J,upsertRuleVersion:P,approveRuleVersion:M,publishSnapshot:R,simulateHighRiskChangeAndApprove:y}}}import{Button as L,ErrorState as I,LoaderBlock as w,StatCard as C,StatCardGroup as S}from"@contractspec/lib.design-system";import{Card as T}from"@contractspec/lib.ui-kit-web/ui/card";import{Input as q}from"@contractspec/lib.ui-kit-web/ui/input";import{Select as d,SelectContent as p,SelectItem as B,SelectTrigger as u,SelectValue as l}from"@contractspec/lib.ui-kit-web/ui/select";import{Textarea as j}from"@contractspec/lib.ui-kit-web/ui/textarea";import{useCallback as g,useMemo as c,useState as Q}from"react";import{jsx as N,jsxs as _}from"react/jsx-runtime";function Nz(){let{state:O,actions:z}=V(),[Z,E]=Q("reporting obligations"),[$,G]=Q("EU: Reporting obligations v2 (updated)"),[H,U]=Q("en-GB"),[J,P]=Q("EU"),[M,R]=Q("education_only"),y=O.context?.kbSnapshotId??O.lastSnapshotId??null,b=c(()=>{return[{label:"Locale",value:O.context?.locale??"—"},{label:"Jurisdiction",value:O.context?.jurisdiction??"—"},{label:"Scope",value:O.context?.allowedScope??"—"},{label:"KB Snapshot",value:y??"—"}]},[y,O.context?.allowedScope,O.context?.jurisdiction,O.context?.locale]),X=g(async()=>{await z.setContext({locale:H,jurisdiction:J,allowedScope:M})},[z,M,J,H]),Y=g(async()=>{await z.askAssistant(Z)},[z,Z]),D=g(async()=>{let W=O.lastRuleId??await z.createDemoRule(),K=await z.upsertRuleVersion({ruleId:W,content:$});await z.approveRuleVersion(K),await z.simulateHighRiskChangeAndApprove(K),await z.publishSnapshot()},[z,$,O.lastRuleId]);if(O.loading&&!O.context)return N(w,{label:"Loading demo..."});if(O.error)return N(I,{title:"Failed to load demo",description:O.error.message,onRetry:z.refreshContext,retryLabel:"Retry"});return _("div",{className:"space-y-6",children:[N(S,{children:b.map((W)=>N(C,{label:W.label,value:String(W.value)},W.label))}),_(T,{className:"p-4",children:[N("h3",{className:"font-semibold text-lg",children:"1) Onboarding (explicit locale + jurisdiction)"}),_("div",{className:"mt-3 grid gap-3 md:grid-cols-3",children:[_("div",{children:[N("div",{className:"mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",children:"Locale"}),N(q,{value:H,onChange:(W)=>U(W.target.value)})]}),_("div",{children:[N("div",{className:"mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",children:"Jurisdiction"}),N(q,{value:J,onChange:(W)=>P(W.target.value)})]}),_("div",{children:[N("div",{className:"mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",children:"Allowed scope"}),_(d,{value:M,onValueChange:(W)=>R(W),children:[N(u,{children:N(l,{placeholder:"Select scope"})}),_(p,{children:[N(B,{value:"education_only",children:"education_only"}),N(B,{value:"generic_info",children:"generic_info"}),N(B,{value:"escalation_required",children:"escalation_required"})]})]})]})]}),_("div",{className:"mt-4 flex gap-2",children:[N(L,{onPress:X,children:"Save context"}),N(L,{variant:"outline",onPress:z.refreshContext,children:"Refresh"})]})]}),_(T,{className:"p-4",children:[N("h3",{className:"font-semibold text-lg",children:"2) Ask the assistant (must cite KB snapshot)"}),_("div",{className:"mt-3 flex flex-col gap-3",children:[N(q,{value:Z,onChange:(W)=>E(W.target.value)}),N("div",{className:"flex gap-2",children:N(L,{onPress:Y,children:"Ask"})})]}),O.lastAnswer?_("div",{className:"mt-4 space-y-3",children:[O.lastAnswer.refused?_("div",{className:"text-red-600 text-sm",children:["Refused: ",O.lastAnswer.refusalReason??"UNKNOWN"]}):null,O.lastAnswer.sections.map((W,K)=>_("div",{children:[N("div",{className:"font-semibold text-sm",children:W.heading}),N("div",{className:"text-muted-foreground text-sm",children:W.body})]},`${W.heading}-${K}`)),N("div",{className:"font-semibold text-sm",children:"Citations"}),N("ul",{className:"list-disc pl-5 text-muted-foreground text-sm",children:O.lastAnswer.citations.map((W)=>_("li",{children:[W.kbSnapshotId," — ",W.sourceId]},`${W.kbSnapshotId}-${W.sourceId}`))})]}):null]}),_(T,{className:"p-4",children:[N("h3",{className:"font-semibold text-lg",children:"3) Admin: publish a new snapshot (HITL)"}),_("div",{className:"mt-3 space-y-3",children:[N(j,{value:$,onChange:(W)=>G(W.target.value)}),N(L,{onPress:D,children:"Simulate change → review → approve → publish snapshot"})]})]}),_(T,{className:"p-4",children:[N("h3",{className:"font-semibold text-lg",children:"4) Learning hub (patterns)"}),N("p",{className:"mt-2 text-muted-foreground 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."})]})]})}export{Nz as PolicySafeKnowledgeAssistantDashboard};