@contractspec/example.policy-safe-knowledge-assistant 3.7.5 → 3.7.7

package/dist/ui/PolicySafeKnowledgeAssistantDashboard.js

@@ -1,7 +1,7 @@
 // @bun
 // src/ui/hooks/usePolicySafeKnowledgeAssistant.ts
-import { useCallback, useEffect, useMemo, useState } from "react";
 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")
@@ -152,7 +152,6 @@ function usePolicySafeKnowledgeAssistant() {
 }
 
 // src/ui/PolicySafeKnowledgeAssistantDashboard.tsx
-import { useCallback as useCallback2, useMemo as useMemo2, useState as useState2 } from "react";
 import {
   Button,
   ErrorState,
@@ -162,7 +161,6 @@ import {
 } 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,
@@ -170,6 +168,8 @@ import {
   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() {
@@ -232,7 +232,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
         className: "p-4",
         children: [
           /* @__PURE__ */ jsxDEV("h3", {
-            className: "text-lg font-semibold",
+            className: "font-semibold text-lg",
             children: "1) Onboarding (explicit locale + jurisdiction)"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV("div", {
@@ -241,7 +241,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
               /* @__PURE__ */ jsxDEV("div", {
                 children: [
                   /* @__PURE__ */ jsxDEV("div", {
-                    className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+                    className: "mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",
                     children: "Locale"
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV(Input, {
@@ -253,7 +253,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
               /* @__PURE__ */ jsxDEV("div", {
                 children: [
                   /* @__PURE__ */ jsxDEV("div", {
-                    className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+                    className: "mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",
                     children: "Jurisdiction"
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV(Input, {
@@ -265,7 +265,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
               /* @__PURE__ */ jsxDEV("div", {
                 children: [
                   /* @__PURE__ */ jsxDEV("div", {
-                    className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+                    className: "mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",
                     children: "Allowed scope"
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV(Select, {
@@ -319,7 +319,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
         className: "p-4",
         children: [
           /* @__PURE__ */ jsxDEV("h3", {
-            className: "text-lg font-semibold",
+            className: "font-semibold text-lg",
             children: "2) Ask the assistant (must cite KB snapshot)"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV("div", {
@@ -342,7 +342,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
             className: "mt-4 space-y-3",
             children: [
               state.lastAnswer.refused ? /* @__PURE__ */ jsxDEV("div", {
-                className: "text-sm text-red-600",
+                className: "text-red-600 text-sm",
                 children: [
                   "Refused: ",
                   state.lastAnswer.refusalReason ?? "UNKNOWN"
@@ -351,7 +351,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
               state.lastAnswer.sections.map((s, idx) => /* @__PURE__ */ jsxDEV("div", {
                 children: [
                   /* @__PURE__ */ jsxDEV("div", {
-                    className: "text-sm font-semibold",
+                    className: "font-semibold text-sm",
                     children: s.heading
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV("div", {
@@ -361,11 +361,11 @@ function PolicySafeKnowledgeAssistantDashboard() {
                 ]
               }, `${s.heading}-${idx}`, true, undefined, this)),
               /* @__PURE__ */ jsxDEV("div", {
-                className: "text-sm font-semibold",
+                className: "font-semibold text-sm",
                 children: "Citations"
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV("ul", {
-                className: "text-muted-foreground list-disc pl-5 text-sm",
+                className: "list-disc pl-5 text-muted-foreground text-sm",
                 children: state.lastAnswer.citations.map((c) => /* @__PURE__ */ jsxDEV("li", {
                   children: [
                     c.kbSnapshotId,
@@ -382,7 +382,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
         className: "p-4",
         children: [
           /* @__PURE__ */ jsxDEV("h3", {
-            className: "text-lg font-semibold",
+            className: "font-semibold text-lg",
             children: "3) Admin: publish a new snapshot (HITL)"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV("div", {
@@ -404,11 +404,11 @@ function PolicySafeKnowledgeAssistantDashboard() {
         className: "p-4",
         children: [
           /* @__PURE__ */ jsxDEV("h3", {
-            className: "text-lg font-semibold",
+            className: "font-semibold text-lg",
             children: "4) Learning hub (patterns)"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV("p", {
-            className: "text-muted-foreground mt-2 text-sm",
+            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)
         ]

package/dist/ui/hooks/usePolicySafeKnowledgeAssistant.js

@@ -1,7 +1,7 @@
 // @bun
 // src/ui/hooks/usePolicySafeKnowledgeAssistant.ts
-import { useCallback, useEffect, useMemo, useState } from "react";
 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")

package/dist/ui/index.js

@@ -1,7 +1,7 @@
 // @bun
 // src/ui/hooks/usePolicySafeKnowledgeAssistant.ts
-import { useCallback, useEffect, useMemo, useState } from "react";
 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")
@@ -152,7 +152,6 @@ function usePolicySafeKnowledgeAssistant() {
 }
 
 // src/ui/PolicySafeKnowledgeAssistantDashboard.tsx
-import { useCallback as useCallback2, useMemo as useMemo2, useState as useState2 } from "react";
 import {
   Button,
   ErrorState,
@@ -162,7 +161,6 @@ import {
 } 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,
@@ -170,6 +168,8 @@ import {
   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() {
@@ -232,7 +232,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
         className: "p-4",
         children: [
           /* @__PURE__ */ jsxDEV("h3", {
-            className: "text-lg font-semibold",
+            className: "font-semibold text-lg",
             children: "1) Onboarding (explicit locale + jurisdiction)"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV("div", {
@@ -241,7 +241,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
               /* @__PURE__ */ jsxDEV("div", {
                 children: [
                   /* @__PURE__ */ jsxDEV("div", {
-                    className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+                    className: "mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",
                     children: "Locale"
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV(Input, {
@@ -253,7 +253,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
               /* @__PURE__ */ jsxDEV("div", {
                 children: [
                   /* @__PURE__ */ jsxDEV("div", {
-                    className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+                    className: "mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",
                     children: "Jurisdiction"
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV(Input, {
@@ -265,7 +265,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
               /* @__PURE__ */ jsxDEV("div", {
                 children: [
                   /* @__PURE__ */ jsxDEV("div", {
-                    className: "text-muted-foreground mb-1 text-xs font-semibold tracking-wide uppercase",
+                    className: "mb-1 font-semibold text-muted-foreground text-xs uppercase tracking-wide",
                     children: "Allowed scope"
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV(Select, {
@@ -319,7 +319,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
         className: "p-4",
         children: [
           /* @__PURE__ */ jsxDEV("h3", {
-            className: "text-lg font-semibold",
+            className: "font-semibold text-lg",
             children: "2) Ask the assistant (must cite KB snapshot)"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV("div", {
@@ -342,7 +342,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
             className: "mt-4 space-y-3",
             children: [
               state.lastAnswer.refused ? /* @__PURE__ */ jsxDEV("div", {
-                className: "text-sm text-red-600",
+                className: "text-red-600 text-sm",
                 children: [
                   "Refused: ",
                   state.lastAnswer.refusalReason ?? "UNKNOWN"
@@ -351,7 +351,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
               state.lastAnswer.sections.map((s, idx) => /* @__PURE__ */ jsxDEV("div", {
                 children: [
                   /* @__PURE__ */ jsxDEV("div", {
-                    className: "text-sm font-semibold",
+                    className: "font-semibold text-sm",
                     children: s.heading
                   }, undefined, false, undefined, this),
                   /* @__PURE__ */ jsxDEV("div", {
@@ -361,11 +361,11 @@ function PolicySafeKnowledgeAssistantDashboard() {
                 ]
               }, `${s.heading}-${idx}`, true, undefined, this)),
               /* @__PURE__ */ jsxDEV("div", {
-                className: "text-sm font-semibold",
+                className: "font-semibold text-sm",
                 children: "Citations"
               }, undefined, false, undefined, this),
               /* @__PURE__ */ jsxDEV("ul", {
-                className: "text-muted-foreground list-disc pl-5 text-sm",
+                className: "list-disc pl-5 text-muted-foreground text-sm",
                 children: state.lastAnswer.citations.map((c) => /* @__PURE__ */ jsxDEV("li", {
                   children: [
                     c.kbSnapshotId,
@@ -382,7 +382,7 @@ function PolicySafeKnowledgeAssistantDashboard() {
         className: "p-4",
         children: [
           /* @__PURE__ */ jsxDEV("h3", {
-            className: "text-lg font-semibold",
+            className: "font-semibold text-lg",
             children: "3) Admin: publish a new snapshot (HITL)"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV("div", {
@@ -404,11 +404,11 @@ function PolicySafeKnowledgeAssistantDashboard() {
         className: "p-4",
         children: [
           /* @__PURE__ */ jsxDEV("h3", {
-            className: "text-lg font-semibold",
+            className: "font-semibold text-lg",
             children: "4) Learning hub (patterns)"
           }, undefined, false, undefined, this),
           /* @__PURE__ */ jsxDEV("p", {
-            className: "text-muted-foreground mt-2 text-sm",
+            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)
         ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.policy-safe-knowledge-assistant",
-  "version": "3.7.5",
+  "version": "3.7.7",
   "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",
   "types": "./dist/index.d.ts",
@@ -113,32 +113,32 @@
     "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
-    "lint:fix": "eslint src --fix",
-    "lint:check": "eslint src",
+    "lint:fix": "biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .",
+    "lint:check": "biome check .",
     "test": "bun test",
     "prebuild": "contractspec-bun-build prebuild",
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/example.kb-update-pipeline": "3.7.5",
-    "@contractspec/example.learning-patterns": "3.7.5",
-    "@contractspec/example.locale-jurisdiction-gate": "3.7.5",
-    "@contractspec/example.versioned-knowledge-base": "3.7.5",
-    "@contractspec/lib.contracts-spec": "3.7.5",
-    "@contractspec/lib.design-system": "3.7.5",
-    "@contractspec/lib.example-shared-ui": "6.0.5",
-    "@contractspec/lib.runtime-sandbox": "2.7.5",
-    "@contractspec/lib.ui-kit-web": "3.7.5",
-    "@contractspec/module.learning-journey": "3.7.5",
+    "@contractspec/example.kb-update-pipeline": "3.7.7",
+    "@contractspec/example.learning-patterns": "3.7.7",
+    "@contractspec/example.locale-jurisdiction-gate": "3.7.7",
+    "@contractspec/example.versioned-knowledge-base": "3.7.7",
+    "@contractspec/lib.contracts-spec": "4.0.0",
+    "@contractspec/lib.design-system": "3.8.0",
+    "@contractspec/lib.example-shared-ui": "6.0.7",
+    "@contractspec/lib.runtime-sandbox": "2.7.6",
+    "@contractspec/lib.ui-kit-web": "3.8.0",
+    "@contractspec/module.learning-journey": "3.7.7",
     "react": "19.2.0",
     "react-dom": "19.2.0"
   },
   "devDependencies": {
-    "@contractspec/tool.typescript": "3.7.5",
+    "@contractspec/tool.typescript": "3.7.6",
     "typescript": "^5.9.3",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.2",
-    "@contractspec/tool.bun": "3.7.5"
+    "@contractspec/tool.bun": "3.7.6"
   },
   "publishConfig": {
     "access": "public",

package/src/docs/policy-safe-knowledge-assistant.docblock.ts

@@ -2,27 +2,27 @@ import type { DocBlock } from '@contractspec/lib.contracts-spec/docs';
 import { registerDocBlocks } from '@contractspec/lib.contracts-spec/docs';
 
 const docBlocks: DocBlock[] = [
-  {
-    id: 'docs.examples.policy-safe-knowledge-assistant.goal',
-    title: 'Policy-safe Knowledge Assistant — Goal',
-    summary:
-      'End-to-end example: versioned KB snapshots + locale/jurisdiction gating + HITL pipeline + learning hub.',
-    kind: 'goal',
-    visibility: 'public',
-    route: '/docs/examples/policy-safe-knowledge-assistant/goal',
-    tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],
-    body: `## What this template proves\n- Assistant answers are structured and must cite a KB snapshot (or refuse).\n- Locale + jurisdiction are mandatory inputs for every assistant call.\n- Automation proposes KB patches; humans verify; publishing stays blocked until approvals.\n- Learning hub demonstrates drills + coaching + quests without spam.\n\n## Offline-first\n- Seeded fixtures are deterministic and require no external services.\n- Optional non-authoritative fallback can be added behind a single feature flag (disabled by default).`,
-  },
-  {
-    id: 'docs.examples.policy-safe-knowledge-assistant.usage',
-    title: 'Policy-safe Knowledge Assistant — Usage',
-    summary: '5–10 minute sandbox walkthrough for developers.',
-    kind: 'usage',
-    visibility: 'public',
-    route: '/docs/examples/policy-safe-knowledge-assistant/usage',
-    tags: ['assistant', 'knowledge', 'usage'],
-    body: `## Demo walkthrough (high level)\n1) Onboard: set locale + jurisdiction.\n2) Publish snapshot: ingest source -> propose rule -> approve -> publish.\n3) Ask assistant: must pass gate and cite snapshot.\n4) Simulate change: watcher -> review -> publish new snapshot.\n5) Learning hub: drills session, ambient tip, quest start + step completion.`,
-  },
+	{
+		id: 'docs.examples.policy-safe-knowledge-assistant.goal',
+		title: 'Policy-safe Knowledge Assistant — Goal',
+		summary:
+			'End-to-end example: versioned KB snapshots + locale/jurisdiction gating + HITL pipeline + learning hub.',
+		kind: 'goal',
+		visibility: 'public',
+		route: '/docs/examples/policy-safe-knowledge-assistant/goal',
+		tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],
+		body: `## What this template proves\n- Assistant answers are structured and must cite a KB snapshot (or refuse).\n- Locale + jurisdiction are mandatory inputs for every assistant call.\n- Automation proposes KB patches; humans verify; publishing stays blocked until approvals.\n- Learning hub demonstrates drills + coaching + quests without spam.\n\n## Offline-first\n- Seeded fixtures are deterministic and require no external services.\n- Optional non-authoritative fallback can be added behind a single feature flag (disabled by default).`,
+	},
+	{
+		id: 'docs.examples.policy-safe-knowledge-assistant.usage',
+		title: 'Policy-safe Knowledge Assistant — Usage',
+		summary: '5–10 minute sandbox walkthrough for developers.',
+		kind: 'usage',
+		visibility: 'public',
+		route: '/docs/examples/policy-safe-knowledge-assistant/usage',
+		tags: ['assistant', 'knowledge', 'usage'],
+		body: `## Demo walkthrough (high level)\n1) Onboard: set locale + jurisdiction.\n2) Publish snapshot: ingest source -> propose rule -> approve -> publish.\n3) Ask assistant: must pass gate and cite snapshot.\n4) Simulate change: watcher -> review -> publish new snapshot.\n5) Learning hub: drills session, ambient tip, quest start + step completion.`,
+	},
 ];
 
 registerDocBlocks(docBlocks);

package/src/example.ts

@@ -1,36 +1,36 @@
 import { defineExample } from '@contractspec/lib.contracts-spec';
 
 const example = defineExample({
-  meta: {
-    key: 'policy-safe-knowledge-assistant',
-    version: '1.0.0',
-    title: 'Policy-safe Knowledge Assistant',
-    description:
-      'All-in-one template: locale/jurisdiction gating + versioned KB snapshots + HITL update pipeline + learning hub.',
-    kind: 'template',
-    visibility: 'public',
-    stability: 'experimental',
-    owners: ['@platform.core'],
-    tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],
-  },
-  docs: {
-    goalDocId: 'docs.examples.policy-safe-knowledge-assistant.goal',
-    usageDocId: 'docs.examples.policy-safe-knowledge-assistant.usage',
-  },
-  entrypoints: {
-    packageName: '@contractspec/example.policy-safe-knowledge-assistant',
-    feature: './policy-safe-knowledge-assistant.feature',
-    docs: './docs',
-  },
-  surfaces: {
-    templates: true,
-    sandbox: {
-      enabled: true,
-      modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],
-    },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true },
-  },
+	meta: {
+		key: 'policy-safe-knowledge-assistant',
+		version: '1.0.0',
+		title: 'Policy-safe Knowledge Assistant',
+		description:
+			'All-in-one template: locale/jurisdiction gating + versioned KB snapshots + HITL update pipeline + learning hub.',
+		kind: 'template',
+		visibility: 'public',
+		stability: 'experimental',
+		owners: ['@platform.core'],
+		tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],
+	},
+	docs: {
+		goalDocId: 'docs.examples.policy-safe-knowledge-assistant.goal',
+		usageDocId: 'docs.examples.policy-safe-knowledge-assistant.usage',
+	},
+	entrypoints: {
+		packageName: '@contractspec/example.policy-safe-knowledge-assistant',
+		feature: './policy-safe-knowledge-assistant.feature',
+		docs: './docs',
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],
+		},
+		studio: { enabled: true, installable: true },
+		mcp: { enabled: true },
+	},
 });
 
 export default example;