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

package/.turbo/turbo-build$colon$bundle.log

@@ -1,35 +1,55 @@
 $ tsdown
-ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
 ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/policy-safe-knowledge-assistant/tsdown.config.js 
-ℹ entry: src/example.ts, src/feature.ts, src/index.ts, src/docs/index.ts, src/docs/policy-safe-knowledge-assistant.docblock.ts, src/orchestrator/buildAnswer.ts, src/seed/fixtures.ts, src/seed/index.ts
+ℹ entry: src/example.ts, src/index.ts, src/policy-safe-knowledge-assistant.feature.ts, src/docs/index.ts, src/docs/policy-safe-knowledge-assistant.docblock.ts, src/handlers/index.ts, src/handlers/policy-safe-knowledge-assistant.handlers.ts, src/orchestrator/buildAnswer.ts, src/seed/fixtures.ts, src/seed/index.ts, src/seeders/index.ts, src/ui/PolicySafeKnowledgeAssistantDashboard.tsx, src/ui/index.ts, src/ui/hooks/usePolicySafeKnowledgeAssistant.ts
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ Cleaning 28 files
-ℹ dist/orchestrator/buildAnswer.js                           2.47 kB │ gzip: 0.93 kB
-ℹ dist/feature.js                                            2.40 kB │ gzip: 0.67 kB
-ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js      1.88 kB │ gzip: 0.90 kB
-ℹ dist/example.js                                            1.13 kB │ gzip: 0.56 kB
-ℹ dist/seed/fixtures.js                                      0.80 kB │ gzip: 0.40 kB
-ℹ dist/index.js                                              0.38 kB │ gzip: 0.20 kB
-ℹ dist/seed/index.js                                         0.07 kB │ gzip: 0.07 kB
-ℹ dist/docs/index.js                                         0.06 kB │ gzip: 0.08 kB
-ℹ dist/orchestrator/buildAnswer.js.map                       5.08 kB │ gzip: 1.68 kB
-ℹ dist/feature.js.map                                        3.71 kB │ gzip: 1.05 kB
-ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js.map  2.38 kB │ gzip: 1.08 kB
-ℹ dist/example.js.map                                        1.69 kB │ gzip: 0.79 kB
-ℹ dist/seed/fixtures.js.map                                  1.29 kB │ gzip: 0.55 kB
-ℹ dist/orchestrator/buildAnswer.d.ts.map                     0.39 kB │ gzip: 0.25 kB
-ℹ dist/seed/fixtures.d.ts.map                                0.20 kB │ gzip: 0.15 kB
-ℹ dist/feature.d.ts.map                                      0.13 kB │ gzip: 0.12 kB
-ℹ dist/example.d.ts.map                                      0.12 kB │ gzip: 0.12 kB
-ℹ dist/orchestrator/buildAnswer.d.ts                         1.31 kB │ gzip: 0.57 kB
-ℹ dist/seed/fixtures.d.ts                                    1.03 kB │ gzip: 0.37 kB
-ℹ dist/index.d.ts                                            0.40 kB │ gzip: 0.20 kB
-ℹ dist/feature.d.ts                                          0.26 kB │ gzip: 0.18 kB
-ℹ dist/example.d.ts                                          0.20 kB │ gzip: 0.16 kB
-ℹ dist/seed/index.d.ts                                       0.07 kB │ gzip: 0.07 kB
-ℹ dist/docs/index.d.ts                                       0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/policy-safe-knowledge-assistant.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
-ℹ 25 files, total: 27.47 kB
-✔ Build complete in 17209ms
+ℹ Cleaning 52 files
+ℹ dist/handlers/policy-safe-knowledge-assistant.handlers.js         9.46 kB │ gzip: 2.58 kB
+ℹ dist/ui/PolicySafeKnowledgeAssistantDashboard.js                  8.14 kB │ gzip: 2.11 kB
+ℹ dist/ui/hooks/usePolicySafeKnowledgeAssistant.js                  4.78 kB │ gzip: 1.47 kB
+ℹ dist/policy-safe-knowledge-assistant.feature.js                   2.55 kB │ gzip: 0.71 kB
+ℹ dist/orchestrator/buildAnswer.js                                  2.47 kB │ gzip: 0.93 kB
+ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js             1.88 kB │ gzip: 0.90 kB
+ℹ dist/example.js                                                   1.24 kB │ gzip: 0.59 kB
+ℹ dist/seed/fixtures.js                                             0.80 kB │ gzip: 0.40 kB
+ℹ dist/index.js                                                     0.73 kB │ gzip: 0.26 kB
+ℹ dist/seeders/index.js                                             0.54 kB │ gzip: 0.38 kB
+ℹ dist/handlers/index.js                                            0.16 kB │ gzip: 0.11 kB
+ℹ dist/ui/index.js                                                  0.15 kB │ gzip: 0.09 kB
+ℹ dist/seed/index.js                                                0.07 kB │ gzip: 0.07 kB
+ℹ dist/docs/index.js                                                0.06 kB │ gzip: 0.08 kB
+ℹ dist/handlers/policy-safe-knowledge-assistant.handlers.js.map    20.30 kB │ gzip: 5.31 kB
+ℹ dist/ui/PolicySafeKnowledgeAssistantDashboard.js.map             10.46 kB │ gzip: 3.10 kB
+ℹ dist/ui/hooks/usePolicySafeKnowledgeAssistant.js.map              9.84 kB │ gzip: 2.85 kB
+ℹ dist/orchestrator/buildAnswer.js.map                              5.05 kB │ gzip: 1.68 kB
+ℹ dist/policy-safe-knowledge-assistant.feature.js.map               3.71 kB │ gzip: 1.05 kB
+ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js.map         2.38 kB │ gzip: 1.08 kB
+ℹ dist/example.js.map                                               1.71 kB │ gzip: 0.80 kB
+ℹ dist/seed/fixtures.js.map                                         1.29 kB │ gzip: 0.55 kB
+ℹ dist/handlers/policy-safe-knowledge-assistant.handlers.d.ts.map   0.94 kB │ gzip: 0.44 kB
+ℹ dist/seeders/index.js.map                                         0.93 kB │ gzip: 0.61 kB
+ℹ dist/ui/hooks/usePolicySafeKnowledgeAssistant.d.ts.map            0.50 kB │ gzip: 0.29 kB
+ℹ dist/orchestrator/buildAnswer.d.ts.map                            0.39 kB │ gzip: 0.25 kB
+ℹ dist/ui/PolicySafeKnowledgeAssistantDashboard.d.ts.map            0.23 kB │ gzip: 0.17 kB
+ℹ dist/seed/fixtures.d.ts.map                                       0.20 kB │ gzip: 0.15 kB
+ℹ dist/policy-safe-knowledge-assistant.feature.d.ts.map             0.20 kB │ gzip: 0.16 kB
+ℹ dist/seeders/index.d.ts.map                                       0.16 kB │ gzip: 0.14 kB
+ℹ dist/example.d.ts.map                                             0.14 kB │ gzip: 0.13 kB
+ℹ dist/handlers/policy-safe-knowledge-assistant.handlers.d.ts       3.21 kB │ gzip: 0.86 kB
+ℹ dist/ui/hooks/usePolicySafeKnowledgeAssistant.d.ts                1.64 kB │ gzip: 0.58 kB
+ℹ dist/orchestrator/buildAnswer.d.ts                                1.31 kB │ gzip: 0.57 kB
+ℹ dist/seed/fixtures.d.ts                                           1.03 kB │ gzip: 0.37 kB
+ℹ dist/index.d.ts                                                   0.83 kB │ gzip: 0.27 kB
+ℹ dist/policy-safe-knowledge-assistant.feature.d.ts                 0.37 kB │ gzip: 0.20 kB
+ℹ dist/ui/PolicySafeKnowledgeAssistantDashboard.d.ts                0.34 kB │ gzip: 0.20 kB
+ℹ dist/seeders/index.d.ts                                           0.30 kB │ gzip: 0.23 kB
+ℹ dist/example.d.ts                                                 0.25 kB │ gzip: 0.17 kB
+ℹ dist/handlers/index.d.ts                                          0.24 kB │ gzip: 0.12 kB
+ℹ dist/ui/index.d.ts                                                0.15 kB │ gzip: 0.09 kB
+ℹ dist/seed/index.d.ts                                              0.07 kB │ gzip: 0.07 kB
+ℹ dist/docs/index.d.ts                                              0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/policy-safe-knowledge-assistant.docblock.d.ts           0.01 kB │ gzip: 0.03 kB
+ℹ 45 files, total: 101.22 kB
+✔ Build complete in 27662ms

package/.turbo/turbo-build.log

@@ -1,36 +1,56 @@
 $ bun build:types && bun build:bundle
 $ tsc --noEmit
 $ tsdown
-ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
 ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/policy-safe-knowledge-assistant/tsdown.config.js 
-ℹ entry: src/example.ts, src/feature.ts, src/index.ts, src/docs/index.ts, src/docs/policy-safe-knowledge-assistant.docblock.ts, src/orchestrator/buildAnswer.ts, src/seed/fixtures.ts, src/seed/index.ts
+ℹ entry: src/example.ts, src/index.ts, src/policy-safe-knowledge-assistant.feature.ts, src/docs/index.ts, src/docs/policy-safe-knowledge-assistant.docblock.ts, src/handlers/index.ts, src/handlers/policy-safe-knowledge-assistant.handlers.ts, src/orchestrator/buildAnswer.ts, src/seed/fixtures.ts, src/seed/index.ts, src/seeders/index.ts, src/ui/PolicySafeKnowledgeAssistantDashboard.tsx, src/ui/index.ts, src/ui/hooks/usePolicySafeKnowledgeAssistant.ts
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/orchestrator/buildAnswer.js                           2.47 kB │ gzip: 0.93 kB
-ℹ dist/feature.js                                            2.40 kB │ gzip: 0.67 kB
-ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js      1.88 kB │ gzip: 0.90 kB
-ℹ dist/example.js                                            1.13 kB │ gzip: 0.56 kB
-ℹ dist/seed/fixtures.js                                      0.80 kB │ gzip: 0.40 kB
-ℹ dist/index.js                                              0.38 kB │ gzip: 0.20 kB
-ℹ dist/seed/index.js                                         0.07 kB │ gzip: 0.07 kB
-ℹ dist/docs/index.js                                         0.06 kB │ gzip: 0.08 kB
-ℹ dist/orchestrator/buildAnswer.js.map                       5.08 kB │ gzip: 1.68 kB
-ℹ dist/feature.js.map                                        3.71 kB │ gzip: 1.05 kB
-ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js.map  2.38 kB │ gzip: 1.08 kB
-ℹ dist/example.js.map                                        1.69 kB │ gzip: 0.79 kB
-ℹ dist/seed/fixtures.js.map                                  1.29 kB │ gzip: 0.55 kB
-ℹ dist/orchestrator/buildAnswer.d.ts.map                     0.39 kB │ gzip: 0.25 kB
-ℹ dist/seed/fixtures.d.ts.map                                0.20 kB │ gzip: 0.15 kB
-ℹ dist/feature.d.ts.map                                      0.13 kB │ gzip: 0.12 kB
-ℹ dist/example.d.ts.map                                      0.12 kB │ gzip: 0.12 kB
-ℹ dist/orchestrator/buildAnswer.d.ts                         1.31 kB │ gzip: 0.57 kB
-ℹ dist/seed/fixtures.d.ts                                    1.03 kB │ gzip: 0.37 kB
-ℹ dist/index.d.ts                                            0.40 kB │ gzip: 0.20 kB
-ℹ dist/feature.d.ts                                          0.26 kB │ gzip: 0.18 kB
-ℹ dist/example.d.ts                                          0.20 kB │ gzip: 0.16 kB
-ℹ dist/seed/index.d.ts                                       0.07 kB │ gzip: 0.07 kB
-ℹ dist/docs/index.d.ts                                       0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/policy-safe-knowledge-assistant.docblock.d.ts    0.01 kB │ gzip: 0.03 kB
-ℹ 25 files, total: 27.47 kB
-✔ Build complete in 13342ms
+ℹ dist/handlers/policy-safe-knowledge-assistant.handlers.js         9.46 kB │ gzip: 2.58 kB
+ℹ dist/ui/PolicySafeKnowledgeAssistantDashboard.js                  8.14 kB │ gzip: 2.11 kB
+ℹ dist/ui/hooks/usePolicySafeKnowledgeAssistant.js                  4.78 kB │ gzip: 1.47 kB
+ℹ dist/policy-safe-knowledge-assistant.feature.js                   2.55 kB │ gzip: 0.71 kB
+ℹ dist/orchestrator/buildAnswer.js                                  2.47 kB │ gzip: 0.93 kB
+ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js             1.88 kB │ gzip: 0.90 kB
+ℹ dist/example.js                                                   1.24 kB │ gzip: 0.59 kB
+ℹ dist/seed/fixtures.js                                             0.80 kB │ gzip: 0.40 kB
+ℹ dist/index.js                                                     0.73 kB │ gzip: 0.26 kB
+ℹ dist/seeders/index.js                                             0.54 kB │ gzip: 0.38 kB
+ℹ dist/handlers/index.js                                            0.16 kB │ gzip: 0.11 kB
+ℹ dist/ui/index.js                                                  0.15 kB │ gzip: 0.09 kB
+ℹ dist/seed/index.js                                                0.07 kB │ gzip: 0.07 kB
+ℹ dist/docs/index.js                                                0.06 kB │ gzip: 0.08 kB
+ℹ dist/handlers/policy-safe-knowledge-assistant.handlers.js.map    20.30 kB │ gzip: 5.31 kB
+ℹ dist/ui/PolicySafeKnowledgeAssistantDashboard.js.map             10.46 kB │ gzip: 3.10 kB
+ℹ dist/ui/hooks/usePolicySafeKnowledgeAssistant.js.map              9.84 kB │ gzip: 2.85 kB
+ℹ dist/orchestrator/buildAnswer.js.map                              5.05 kB │ gzip: 1.68 kB
+ℹ dist/policy-safe-knowledge-assistant.feature.js.map               3.71 kB │ gzip: 1.05 kB
+ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js.map         2.38 kB │ gzip: 1.08 kB
+ℹ dist/example.js.map                                               1.71 kB │ gzip: 0.80 kB
+ℹ dist/seed/fixtures.js.map                                         1.29 kB │ gzip: 0.55 kB
+ℹ dist/handlers/policy-safe-knowledge-assistant.handlers.d.ts.map   0.94 kB │ gzip: 0.44 kB
+ℹ dist/seeders/index.js.map                                         0.93 kB │ gzip: 0.61 kB
+ℹ dist/ui/hooks/usePolicySafeKnowledgeAssistant.d.ts.map            0.50 kB │ gzip: 0.29 kB
+ℹ dist/orchestrator/buildAnswer.d.ts.map                            0.39 kB │ gzip: 0.25 kB
+ℹ dist/ui/PolicySafeKnowledgeAssistantDashboard.d.ts.map            0.23 kB │ gzip: 0.17 kB
+ℹ dist/seed/fixtures.d.ts.map                                       0.20 kB │ gzip: 0.15 kB
+ℹ dist/policy-safe-knowledge-assistant.feature.d.ts.map             0.20 kB │ gzip: 0.16 kB
+ℹ dist/seeders/index.d.ts.map                                       0.16 kB │ gzip: 0.14 kB
+ℹ dist/example.d.ts.map                                             0.14 kB │ gzip: 0.13 kB
+ℹ dist/handlers/policy-safe-knowledge-assistant.handlers.d.ts       3.21 kB │ gzip: 0.86 kB
+ℹ dist/ui/hooks/usePolicySafeKnowledgeAssistant.d.ts                1.64 kB │ gzip: 0.58 kB
+ℹ dist/orchestrator/buildAnswer.d.ts                                1.31 kB │ gzip: 0.57 kB
+ℹ dist/seed/fixtures.d.ts                                           1.03 kB │ gzip: 0.37 kB
+ℹ dist/index.d.ts                                                   0.83 kB │ gzip: 0.27 kB
+ℹ dist/policy-safe-knowledge-assistant.feature.d.ts                 0.37 kB │ gzip: 0.20 kB
+ℹ dist/ui/PolicySafeKnowledgeAssistantDashboard.d.ts                0.34 kB │ gzip: 0.20 kB
+ℹ dist/seeders/index.d.ts                                           0.30 kB │ gzip: 0.23 kB
+ℹ dist/example.d.ts                                                 0.25 kB │ gzip: 0.17 kB
+ℹ dist/handlers/index.d.ts                                          0.24 kB │ gzip: 0.12 kB
+ℹ dist/ui/index.d.ts                                                0.15 kB │ gzip: 0.09 kB
+ℹ dist/seed/index.d.ts                                              0.07 kB │ gzip: 0.07 kB
+ℹ dist/docs/index.d.ts                                              0.01 kB │ gzip: 0.03 kB
+ℹ dist/docs/policy-safe-knowledge-assistant.docblock.d.ts           0.01 kB │ gzip: 0.03 kB
+ℹ 45 files, total: 101.22 kB
+✔ Build complete in 28762ms

package/CHANGELOG.md

@@ -1,5 +1,51 @@
 # @contractspec/example.policy-safe-knowledge-assistant
 
+## 1.47.0
+
+### Minor Changes
+
+- caf8701: feat: add cli vibe command to run workflow
+- c69b849: feat: add api web services (mcp & website)
+- 42b8d78: feat: add cli `contractspec vibe` workflow to simplify usage
+- fd38e85: feat: auto-fix contractspec issues
+
+### Patch Changes
+
+- e7ded36: feat: improve stability (adding ts-morph)
+- c231a8b: test: improve workspace stability
+- Updated dependencies [e7ded36]
+- Updated dependencies [caf8701]
+- Updated dependencies [c69b849]
+- Updated dependencies [c231a8b]
+- Updated dependencies [42b8d78]
+- Updated dependencies [fd38e85]
+  - @contractspec/example.locale-jurisdiction-gate@1.47.0
+  - @contractspec/example.versioned-knowledge-base@1.47.0
+  - @contractspec/example.kb-update-pipeline@1.47.0
+  - @contractspec/example.learning-patterns@1.47.0
+  - @contractspec/module.learning-journey@1.47.0
+  - @contractspec/lib.example-shared-ui@1.1.0
+  - @contractspec/lib.runtime-sandbox@0.2.0
+  - @contractspec/lib.design-system@1.47.0
+  - @contractspec/lib.ui-kit-web@1.47.0
+  - @contractspec/lib.contracts@1.47.0
+
+## 1.46.2
+
+### Patch Changes
+
+- 7e21625: feat: library services (landing page & api)
+- Updated dependencies [7e21625]
+  - @contractspec/example.locale-jurisdiction-gate@1.46.2
+  - @contractspec/example.versioned-knowledge-base@1.46.2
+  - @contractspec/example.kb-update-pipeline@1.46.2
+  - @contractspec/example.learning-patterns@1.46.2
+  - @contractspec/module.learning-journey@1.46.2
+  - @contractspec/lib.example-shared-ui@1.0.1
+  - @contractspec/lib.runtime-sandbox@0.1.1
+  - @contractspec/lib.design-system@1.46.2
+  - @contractspec/lib.contracts@1.46.2
+
 ## 1.46.1
 
 ### Patch Changes

package/README.md

@@ -11,13 +11,12 @@ All-in-one template example demonstrating a **policy-safe knowledge assistant**
 - Learning hub (drills, ambient coach, quests)
 - Cross-cutting modules wired: identity/RBAC, audit trail, notifications, jobs, feature flags, files, metering, learning journey
 
-This package is the **spec-first** source of truth. The sandbox UI/runtime integration lives in `@contractspec/bundle.studio`.\n+\n+## Seed scenario\n+\n+See `src/seed/fixtures.ts` for deterministic offline fixtures (no web dependencies).\n+\n+## Running tests\n+\n+```bash\n+bun test\n+```\n+
-
-
-
-
-
-
-
+This package is the **spec-first** source of truth. The sandbox UI/runtime integration lives in `@contractspec/bundle.studio`.
 
+## Seed scenario
+See `src/seed/fixtures.ts` for deterministic offline fixtures (no web dependencies).
 
+## Running tests
+```bash
+bun test
+```

package/dist/example.d.ts

@@ -1,7 +1,7 @@
-import { ExampleSpec } from "@contractspec/lib.contracts";
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
 
 //#region src/example.d.ts
-declare const example: ExampleSpec;
+declare const example: _contractspec_lib_contracts0.ExampleSpec;
 //#endregion
 export { example as default };
 //# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SAAS"}
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";;;cAEM,SA+BJ,4BAAA,CA/BW"}

package/dist/example.js

@@ -1,5 +1,7 @@
+import { defineExample } from "@contractspec/lib.contracts";
+
 //#region src/example.ts
-const example = {
+const example = defineExample({
 	meta: {
 		key: "policy-safe-knowledge-assistant",
 		version: "1.0.0",
@@ -23,7 +25,7 @@ const example = {
 	},
 	entrypoints: {
 		packageName: "@contractspec/example.policy-safe-knowledge-assistant",
-		feature: "./feature",
+		feature: "./policy-safe-knowledge-assistant.feature",
 		docs: "./docs"
 	},
 	surfaces: {
@@ -44,7 +46,7 @@ const example = {
 		},
 		mcp: { enabled: true }
 	}
-};
+});
 var example_default = example;
 
 //#endregion

package/dist/example.js.map

@@ -1 +1 @@
-{"version":3,"file":"example.js","names":["example: ExampleSpec"],"sources":["../src/example.ts"],"sourcesContent":["import type { ExampleSpec } from '@contractspec/lib.contracts';\n\nconst example: ExampleSpec = {\n  meta: {\n    key: 'policy-safe-knowledge-assistant',\n    version: '1.0.0',\n    title: 'Policy-safe Knowledge Assistant',\n    description:\n      'All-in-one template: locale/jurisdiction gating + versioned KB snapshots + HITL update pipeline + learning hub.',\n    kind: 'template',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],\n  },\n  docs: {\n    goalDocId: 'docs.examples.policy-safe-knowledge-assistant.goal',\n    usageDocId: 'docs.examples.policy-safe-knowledge-assistant.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.policy-safe-knowledge-assistant',\n    feature: './feature',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: {\n      enabled: true,\n      modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],\n    },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n};\n\nexport default example;\n"],"mappings":";AAEA,MAAMA,UAAuB;CAC3B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAa;GAAa;GAAU;GAAQ;GAAW;EAC/D;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GACP,SAAS;GACT,OAAO;IAAC;IAAc;IAAS;IAAW;IAAY;IAAY;GACnE;EACD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["import { defineExample } from '@contractspec/lib.contracts';\n\nconst example = defineExample({\n  meta: {\n    key: 'policy-safe-knowledge-assistant',\n    version: '1.0.0',\n    title: 'Policy-safe Knowledge Assistant',\n    description:\n      'All-in-one template: locale/jurisdiction gating + versioned KB snapshots + HITL update pipeline + learning hub.',\n    kind: 'template',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],\n  },\n  docs: {\n    goalDocId: 'docs.examples.policy-safe-knowledge-assistant.goal',\n    usageDocId: 'docs.examples.policy-safe-knowledge-assistant.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.policy-safe-knowledge-assistant',\n    feature: './policy-safe-knowledge-assistant.feature',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: {\n      enabled: true,\n      modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],\n    },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n});\n\nexport default example;\n"],"mappings":";;;AAEA,MAAM,UAAU,cAAc;CAC5B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAa;GAAa;GAAU;GAAQ;GAAW;EAC/D;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GACP,SAAS;GACT,OAAO;IAAC;IAAc;IAAS;IAAW;IAAY;IAAY;GACnE;EACD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF,CAAC;AAEF,sBAAe"}

package/dist/handlers/index.d.ts

@@ -0,0 +1,2 @@
+import { PolicySafeKnowledgeAssistantHandlers, createPolicySafeKnowledgeAssistantHandlers } from "./policy-safe-knowledge-assistant.handlers.js";
+export { PolicySafeKnowledgeAssistantHandlers, createPolicySafeKnowledgeAssistantHandlers };

package/dist/handlers/index.js

@@ -0,0 +1,3 @@
+import { createPolicySafeKnowledgeAssistantHandlers } from "./policy-safe-knowledge-assistant.handlers.js";
+
+export { createPolicySafeKnowledgeAssistantHandlers };

package/dist/handlers/policy-safe-knowledge-assistant.handlers.d.ts

@@ -0,0 +1,127 @@
+import { AssistantAnswerIR } from "../orchestrator/buildAnswer.js";
+import "../index.js";
+import { DatabasePort } from "@contractspec/lib.runtime-sandbox";
+
+//#region src/handlers/policy-safe-knowledge-assistant.handlers.d.ts
+
+type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
+type RiskLevel = 'low' | 'medium' | 'high';
+type ReviewRole = 'curator' | 'expert';
+declare function createPolicySafeKnowledgeAssistantHandlers(db: DatabasePort): {
+  getUserContext: (input: {
+    projectId: string;
+  }) => Promise<{
+    projectId: string;
+    locale: string;
+    jurisdiction: string;
+    allowedScope: AllowedScope;
+    kbSnapshotId: string | null;
+  }>;
+  setUserContext: (input: {
+    projectId: string;
+    locale: string;
+    jurisdiction: string;
+    allowedScope: AllowedScope;
+  }) => Promise<{
+    projectId: string;
+    locale: string;
+    jurisdiction: string;
+    allowedScope: AllowedScope;
+    kbSnapshotId: string | null;
+  }>;
+  createRule: (input: {
+    projectId: string;
+    jurisdiction: string;
+    topicKey: string;
+  }) => Promise<{
+    projectId: string;
+    jurisdiction: string;
+    topicKey: string;
+    id: string;
+  }>;
+  upsertRuleVersion: (input: {
+    projectId: string;
+    ruleId: string;
+    content: string;
+    sourceRefs: {
+      sourceDocumentId: string;
+      excerpt?: string;
+    }[];
+  }) => Promise<{
+    id: string;
+    ruleId: string;
+    jurisdiction: string;
+    topicKey: string;
+    version: number;
+    content: string;
+    status: string;
+    sourceRefs: {
+      sourceDocumentId: string;
+      excerpt?: string;
+    }[];
+    createdAt: Date;
+  }>;
+  approveRuleVersion: (input: {
+    ruleVersionId: string;
+    approver: string;
+  }) => Promise<{
+    ruleVersionId: string;
+    status: "approved";
+  }>;
+  publishSnapshot: (input: {
+    projectId: string;
+    jurisdiction: string;
+    asOfDate: Date;
+  }) => Promise<{
+    id: string;
+    jurisdiction: string;
+    includedRuleVersionIds: string[];
+  }>;
+  searchKb: (input: {
+    snapshotId: string;
+    jurisdiction: string;
+    query: string;
+  }) => Promise<{
+    items: {
+      ruleVersionId: string;
+      excerpt?: string;
+    }[];
+  }>;
+  answer: (input: {
+    projectId: string;
+    question: string;
+  }) => Promise<AssistantAnswerIR>;
+  createChangeCandidate: (input: {
+    projectId: string;
+    jurisdiction: string;
+    diffSummary: string;
+    riskLevel: RiskLevel;
+    proposedRuleVersionIds: string[];
+  }) => Promise<{
+    id: string;
+  }>;
+  createReviewTask: (input: {
+    changeCandidateId: string;
+  }) => Promise<{
+    id: string;
+    assignedRole: ReviewRole;
+  }>;
+  submitDecision: (input: {
+    reviewTaskId: string;
+    decision: "approve" | "reject";
+    decidedByRole: ReviewRole;
+    decidedBy: string;
+  }) => Promise<{
+    id: string;
+    status: "decided";
+  }>;
+  publishIfReady: (input: {
+    jurisdiction: string;
+  }) => Promise<{
+    published: true;
+  }>;
+};
+type PolicySafeKnowledgeAssistantHandlers = ReturnType<typeof createPolicySafeKnowledgeAssistantHandlers>;
+//#endregion
+export { PolicySafeKnowledgeAssistantHandlers, createPolicySafeKnowledgeAssistantHandlers };
+//# sourceMappingURL=policy-safe-knowledge-assistant.handlers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"policy-safe-knowledge-assistant.handlers.d.ts","names":[],"sources":["../../src/handlers/policy-safe-knowledge-assistant.handlers.ts"],"sourcesContent":[],"mappings":";;;;;;KAcK,YAAA,GA6E0D,gBAAA,GAAA,cAAA,GAAA,qBAAA;KA5E1D,SAAA;KACA,UAAA,GA4EuD,SAAA,GAAA,QAAA;AA4B1C,iBA7BF,0CAAA,CA6BE,EAAA,EA7B6C,YA6B7C,CAAA,EAAA;;IACf,SAAA,EAAA,MAAA;EA6BA,CAAA,EAAA,GA1DyD,OA0DzD,CAAA;;IAcA,MAAA,EAAA,MAAA;IAoDA,YAAA,EAAA,MAAA;IAYW,YAAA,cAAA;IACX,YAAA,EAAA,MAAA,GAAA,IAAA;EAsCA,CAAA,CAAA;EAAA,cAAA,EAAA,CAAA,KAAA,EAAA;IAiCmE,SAAA,EAAA,MAAA;IAkCvD,MAAA,EAAA,MAAA;IAEZ,YAAA,EAAA,MAAA;kBAxNe;EA0OoD,CAAA,EAAA,GAzOnE,OAyOmE,CAAA;IAqBnD,SAAA,EAAA,MAAA;IAEhB,MAAA,EAAA,MAAA;IAoC4D,YAAA,EAAA,MAAA;IAAA,YAAA,cAAA;IA4DnD,YAAA,EAAA,MAAA,GAAA,IAAA;;;;;;QAnUT;;;;;;;;;;;;;;QAcA;;;;;;;;;;;;;;;;;QAoDA;;;;;;;cAYW;QACX;;;;;;;;;QAsCA;;;;;;;;;QAiCmE,QAjCnE,iBAAA;;;;;eAmEY;;QAEZ;;;;;QAkBmE;;;;;;;mBAqBnD;;QAEhB;;;;;;QAoC4D;;;;KA4DnD,oCAAA,GAAuC,kBAC1C"}