@contractspec/example.policy-safe-knowledge-assistant 1.44.0

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

@@ -0,0 +1,35 @@
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ 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
+ℹ 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.23 kB │ gzip: 0.66 kB
+ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js      1.88 kB │ gzip: 0.90 kB
+ℹ dist/example.js                                            1.02 kB │ gzip: 0.51 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.53 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.41 kB │ gzip: 0.70 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/example.d.ts.map                                      0.14 kB │ gzip: 0.13 kB
+ℹ dist/feature.d.ts.map                                      0.13 kB │ gzip: 0.12 kB
+ℹ dist/orchestrator/buildAnswer.d.ts                         1.31 kB │ gzip: 0.57 kB
+ℹ dist/example.d.ts                                          1.24 kB │ gzip: 0.51 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/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.79 kB
+✔ Build complete in 11338ms

package/.turbo/turbo-build.log

@@ -0,0 +1,36 @@
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
+ℹ 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
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ dist/orchestrator/buildAnswer.js                           2.47 kB │ gzip: 0.93 kB
+ℹ dist/feature.js                                            2.23 kB │ gzip: 0.66 kB
+ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js      1.88 kB │ gzip: 0.90 kB
+ℹ dist/example.js                                            1.02 kB │ gzip: 0.51 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.53 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.41 kB │ gzip: 0.70 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/example.d.ts.map                                      0.14 kB │ gzip: 0.13 kB
+ℹ dist/feature.d.ts.map                                      0.13 kB │ gzip: 0.12 kB
+ℹ dist/orchestrator/buildAnswer.d.ts                         1.31 kB │ gzip: 0.57 kB
+ℹ dist/example.d.ts                                          1.24 kB │ gzip: 0.51 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/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.79 kB
+✔ Build complete in 18614ms

package/CHANGELOG.md

@@ -0,0 +1,365 @@
+# @contractspec/example.policy-safe-knowledge-assistant
+
+## 1.44.0
+
+### Minor Changes
+
+- 5f3a868: chore: isolate branding to contractspec.io
+
+### Patch Changes
+
+- Updated dependencies [5f3a868]
+  - @contractspec/example.locale-jurisdiction-gate@1.44.0
+  - @contractspec/example.versioned-knowledge-base@1.44.0
+  - @contractspec/example.kb-update-pipeline@1.44.0
+  - @contractspec/example.learning-patterns@1.44.0
+  - @contractspec/module.learning-journey@1.44.0
+  - @contractspec/module.notifications@1.44.0
+  - @contractspec/module.audit-trail@1.44.0
+  - @contractspec/lib.feature-flags@1.44.0
+  - @contractspec/lib.identity-rbac@1.44.0
+  - @contractspec/lib.contracts@1.44.0
+  - @contractspec/lib.metering@1.44.0
+  - @contractspec/lib.schema@1.44.0
+  - @contractspec/lib.files@1.44.0
+  - @contractspec/lib.jobs@1.44.0
+
+## 1.43.4
+
+### Patch Changes
+
+- 9216062: fix: cross-platform compatibility
+- Updated dependencies [9216062]
+  - @contractspec/example.locale-jurisdiction-gate@1.43.4
+  - @contractspec/example.versioned-knowledge-base@1.43.4
+  - @contractspec/example.kb-update-pipeline@1.43.4
+  - @contractspec/example.learning-patterns@1.43.3
+  - @contractspec/module.learning-journey@1.43.4
+  - @contractspec/module.notifications@1.43.4
+  - @contractspec/module.audit-trail@1.43.4
+  - @contractspec/lib.feature-flags@1.43.4
+  - @contractspec/lib.identity-rbac@1.43.4
+  - @contractspec/lib.contracts@1.43.4
+  - @contractspec/lib.metering@1.43.4
+  - @contractspec/lib.schema@1.43.3
+  - @contractspec/lib.files@1.43.4
+  - @contractspec/lib.jobs@1.43.4
+
+## 1.43.3
+
+### Patch Changes
+
+- 24d9759: improve documentation
+- Updated dependencies [24d9759]
+  - @contractspec/example.locale-jurisdiction-gate@1.43.3
+  - @contractspec/example.versioned-knowledge-base@1.43.3
+  - @contractspec/example.kb-update-pipeline@1.43.3
+  - @contractspec/example.learning-patterns@1.43.2
+  - @contractspec/module.learning-journey@1.43.3
+  - @contractspec/module.notifications@1.43.3
+  - @contractspec/module.audit-trail@1.43.3
+  - @contractspec/lib.feature-flags@1.43.3
+  - @contractspec/lib.identity-rbac@1.43.3
+  - @contractspec/lib.contracts@1.43.3
+  - @contractspec/lib.metering@1.43.3
+  - @contractspec/lib.schema@1.43.2
+  - @contractspec/lib.files@1.43.3
+  - @contractspec/lib.jobs@1.43.3
+
+## 1.43.2
+
+### Patch Changes
+
+- e147271: fix: improve stability
+- Updated dependencies [e147271]
+  - @contractspec/example.locale-jurisdiction-gate@1.43.2
+  - @contractspec/example.versioned-knowledge-base@1.43.2
+  - @contractspec/example.kb-update-pipeline@1.43.2
+  - @contractspec/example.learning-patterns@1.43.2
+  - @contractspec/module.learning-journey@1.43.2
+  - @contractspec/module.notifications@1.43.2
+  - @contractspec/module.audit-trail@1.43.2
+  - @contractspec/lib.feature-flags@1.43.2
+  - @contractspec/lib.identity-rbac@1.43.2
+  - @contractspec/lib.contracts@1.43.2
+  - @contractspec/lib.metering@1.43.2
+  - @contractspec/lib.files@1.43.2
+  - @contractspec/lib.jobs@1.43.2
+  - @contractspec/lib.schema@1.43.1
+
+## 1.43.1
+
+### Patch Changes
+
+- Updated dependencies [f28fdad]
+  - @contractspec/lib.contracts@1.43.1
+  - @contractspec/example.kb-update-pipeline@1.43.1
+  - @contractspec/example.learning-patterns@1.43.1
+  - @contractspec/example.locale-jurisdiction-gate@1.43.1
+  - @contractspec/example.versioned-knowledge-base@1.43.1
+  - @contractspec/lib.feature-flags@1.43.1
+  - @contractspec/lib.files@1.43.1
+  - @contractspec/lib.identity-rbac@1.43.1
+  - @contractspec/lib.jobs@1.43.1
+  - @contractspec/lib.metering@1.43.1
+  - @contractspec/module.audit-trail@1.43.1
+  - @contractspec/module.learning-journey@1.43.1
+  - @contractspec/module.notifications@1.43.1
+
+## 1.43.0
+
+### Minor Changes
+
+- 042d072: feat: schema declaration using json schema, including zod
+
+### Patch Changes
+
+- Updated dependencies [042d072]
+  - @contractspec/example.locale-jurisdiction-gate@1.43.0
+  - @contractspec/example.versioned-knowledge-base@1.43.0
+  - @contractspec/example.kb-update-pipeline@1.43.0
+  - @contractspec/example.learning-patterns@1.43.0
+  - @contractspec/module.learning-journey@1.43.0
+  - @contractspec/module.notifications@1.43.0
+  - @contractspec/module.audit-trail@1.43.0
+  - @contractspec/lib.feature-flags@1.43.0
+  - @contractspec/lib.identity-rbac@1.43.0
+  - @contractspec/lib.contracts@1.43.0
+  - @contractspec/lib.metering@1.43.0
+  - @contractspec/lib.schema@1.43.0
+  - @contractspec/lib.files@1.43.0
+  - @contractspec/lib.jobs@1.43.0
+
+## 1.42.10
+
+### Patch Changes
+
+- 1e6a0f1: fix: mcp server
+- Updated dependencies [1e6a0f1]
+  - @contractspec/example.locale-jurisdiction-gate@1.42.10
+  - @contractspec/example.versioned-knowledge-base@1.42.10
+  - @contractspec/example.kb-update-pipeline@1.42.10
+  - @contractspec/example.learning-patterns@1.42.9
+  - @contractspec/module.learning-journey@1.42.10
+  - @contractspec/module.notifications@1.42.10
+  - @contractspec/module.audit-trail@1.42.10
+  - @contractspec/lib.feature-flags@1.42.10
+  - @contractspec/lib.identity-rbac@1.42.10
+  - @contractspec/lib.contracts@1.42.10
+  - @contractspec/lib.metering@1.42.10
+  - @contractspec/lib.schema@1.42.10
+  - @contractspec/lib.files@1.42.10
+  - @contractspec/lib.jobs@1.42.10
+
+## 1.42.9
+
+### Patch Changes
+
+- 9281db7: fix ModelRegistry
+- Updated dependencies [9281db7]
+  - @contractspec/example.locale-jurisdiction-gate@1.42.9
+  - @contractspec/example.versioned-knowledge-base@1.42.9
+  - @contractspec/example.kb-update-pipeline@1.42.9
+  - @contractspec/example.learning-patterns@1.42.8
+  - @contractspec/module.learning-journey@1.42.9
+  - @contractspec/module.notifications@1.42.9
+  - @contractspec/module.audit-trail@1.42.9
+  - @contractspec/lib.feature-flags@1.42.9
+  - @contractspec/lib.identity-rbac@1.42.9
+  - @contractspec/lib.contracts@1.42.9
+  - @contractspec/lib.metering@1.42.9
+  - @contractspec/lib.schema@1.42.9
+  - @contractspec/lib.files@1.42.9
+  - @contractspec/lib.jobs@1.42.9
+
+## 1.42.8
+
+### Patch Changes
+
+- e07b5ac: fix
+- Updated dependencies [e07b5ac]
+  - @contractspec/example.locale-jurisdiction-gate@1.42.8
+  - @contractspec/example.versioned-knowledge-base@1.42.8
+  - @contractspec/example.kb-update-pipeline@1.42.8
+  - @contractspec/example.learning-patterns@1.42.7
+  - @contractspec/module.learning-journey@1.42.8
+  - @contractspec/module.notifications@1.42.8
+  - @contractspec/module.audit-trail@1.42.8
+  - @contractspec/lib.feature-flags@1.42.8
+  - @contractspec/lib.identity-rbac@1.42.8
+  - @contractspec/lib.contracts@1.42.8
+  - @contractspec/lib.metering@1.42.8
+  - @contractspec/lib.schema@1.42.8
+  - @contractspec/lib.files@1.42.8
+  - @contractspec/lib.jobs@1.42.8
+
+## 1.42.7
+
+### Patch Changes
+
+- e9b575d: fix release
+- Updated dependencies [e9b575d]
+  - @contractspec/example.locale-jurisdiction-gate@1.42.7
+  - @contractspec/example.versioned-knowledge-base@1.42.7
+  - @contractspec/example.kb-update-pipeline@1.42.7
+  - @contractspec/example.learning-patterns@1.42.6
+  - @contractspec/module.learning-journey@1.42.7
+  - @contractspec/module.notifications@1.42.7
+  - @contractspec/module.audit-trail@1.42.7
+  - @contractspec/lib.feature-flags@1.42.7
+  - @contractspec/lib.identity-rbac@1.42.7
+  - @contractspec/lib.contracts@1.42.7
+  - @contractspec/lib.metering@1.42.7
+  - @contractspec/lib.schema@1.42.7
+  - @contractspec/lib.files@1.42.7
+  - @contractspec/lib.jobs@1.42.7
+
+## 1.42.6
+
+### Patch Changes
+
+- 1500242: fix tooling
+- Updated dependencies [1500242]
+  - @contractspec/example.locale-jurisdiction-gate@1.42.6
+  - @contractspec/example.versioned-knowledge-base@1.42.6
+  - @contractspec/example.kb-update-pipeline@1.42.6
+  - @contractspec/example.learning-patterns@1.42.5
+  - @contractspec/module.learning-journey@1.42.6
+  - @contractspec/module.notifications@1.42.6
+  - @contractspec/module.audit-trail@1.42.6
+  - @contractspec/lib.feature-flags@1.42.6
+  - @contractspec/lib.identity-rbac@1.42.6
+  - @contractspec/lib.contracts@1.42.6
+  - @contractspec/lib.metering@1.42.6
+  - @contractspec/lib.schema@1.42.6
+  - @contractspec/lib.files@1.42.6
+  - @contractspec/lib.jobs@1.42.6
+
+## 1.42.5
+
+### Patch Changes
+
+- 1299719: fix vscode
+- Updated dependencies [1299719]
+  - @contractspec/example.locale-jurisdiction-gate@1.42.5
+  - @contractspec/example.versioned-knowledge-base@1.42.5
+  - @contractspec/example.kb-update-pipeline@1.42.5
+  - @contractspec/example.learning-patterns@1.42.4
+  - @contractspec/module.learning-journey@1.42.5
+  - @contractspec/module.notifications@1.42.5
+  - @contractspec/module.audit-trail@1.42.5
+  - @contractspec/lib.feature-flags@1.42.5
+  - @contractspec/lib.identity-rbac@1.42.5
+  - @contractspec/lib.contracts@1.42.5
+  - @contractspec/lib.metering@1.42.5
+  - @contractspec/lib.schema@1.42.5
+  - @contractspec/lib.files@1.42.5
+  - @contractspec/lib.jobs@1.42.5
+
+## 1.42.4
+
+### Patch Changes
+
+- ac28b99: fix: generate from openapi
+- Updated dependencies [ac28b99]
+  - @contractspec/example.locale-jurisdiction-gate@1.42.4
+  - @contractspec/example.versioned-knowledge-base@1.42.4
+  - @contractspec/example.kb-update-pipeline@1.42.4
+  - @contractspec/example.learning-patterns@1.42.3
+  - @contractspec/module.learning-journey@1.42.4
+  - @contractspec/module.notifications@1.42.4
+  - @contractspec/module.audit-trail@1.42.4
+  - @contractspec/lib.feature-flags@1.42.4
+  - @contractspec/lib.identity-rbac@1.42.4
+  - @contractspec/lib.contracts@1.42.4
+  - @contractspec/lib.metering@1.42.4
+  - @contractspec/lib.schema@1.42.4
+  - @contractspec/lib.files@1.42.4
+  - @contractspec/lib.jobs@1.42.4
+
+## 1.42.3
+
+### Patch Changes
+
+- 3f5d015: fix(tooling): cicd
+- Updated dependencies [3f5d015]
+  - @contractspec/example.kb-update-pipeline@1.42.3
+  - @contractspec/example.learning-patterns@1.42.2
+  - @contractspec/example.locale-jurisdiction-gate@1.42.3
+  - @contractspec/example.versioned-knowledge-base@1.42.3
+  - @contractspec/lib.contracts@1.42.3
+  - @contractspec/lib.feature-flags@1.42.3
+  - @contractspec/lib.files@1.42.3
+  - @contractspec/lib.identity-rbac@1.42.3
+  - @contractspec/lib.jobs@1.42.3
+  - @contractspec/lib.metering@1.42.3
+  - @contractspec/lib.schema@1.42.3
+  - @contractspec/module.audit-trail@1.42.3
+  - @contractspec/module.learning-journey@1.42.3
+  - @contractspec/module.notifications@1.42.3
+
+## 1.42.2
+
+### Patch Changes
+
+- 1f9ac4c: fix
+- Updated dependencies [1f9ac4c]
+  - @contractspec/example.kb-update-pipeline@1.42.2
+  - @contractspec/example.learning-patterns@1.42.2
+  - @contractspec/example.locale-jurisdiction-gate@1.42.2
+  - @contractspec/example.versioned-knowledge-base@1.42.2
+  - @contractspec/lib.contracts@1.42.2
+  - @contractspec/lib.feature-flags@1.42.2
+  - @contractspec/lib.files@1.42.2
+  - @contractspec/lib.identity-rbac@1.42.2
+  - @contractspec/lib.jobs@1.42.2
+  - @contractspec/lib.metering@1.42.2
+  - @contractspec/lib.schema@1.42.2
+  - @contractspec/module.audit-trail@1.42.2
+  - @contractspec/module.learning-journey@1.42.2
+  - @contractspec/module.notifications@1.42.2
+
+## 1.42.1
+
+### Patch Changes
+
+- f043995: Fix release
+- Updated dependencies [f043995]
+  - @contractspec/example.locale-jurisdiction-gate@1.42.1
+  - @contractspec/example.versioned-knowledge-base@1.42.1
+  - @contractspec/example.kb-update-pipeline@1.42.1
+  - @contractspec/example.learning-patterns@1.42.1
+  - @contractspec/module.learning-journey@1.42.1
+  - @contractspec/module.notifications@1.42.1
+  - @contractspec/module.audit-trail@1.42.1
+  - @contractspec/lib.feature-flags@1.42.1
+  - @contractspec/lib.identity-rbac@1.42.1
+  - @contractspec/lib.contracts@1.42.1
+  - @contractspec/lib.metering@1.42.1
+  - @contractspec/lib.schema@1.42.1
+  - @contractspec/lib.files@1.42.1
+  - @contractspec/lib.jobs@1.42.1
+
+## 1.42.0
+
+### Minor Changes
+
+- 8eefd9c: initial release
+
+### Patch Changes
+
+- Updated dependencies [8eefd9c]
+  - @contractspec/example.kb-update-pipeline@1.42.0
+  - @contractspec/example.learning-patterns@1.42.0
+  - @contractspec/example.locale-jurisdiction-gate@1.42.0
+  - @contractspec/example.versioned-knowledge-base@1.42.0
+  - @contractspec/lib.contracts@1.42.0
+  - @contractspec/lib.feature-flags@1.42.0
+  - @contractspec/lib.files@1.42.0
+  - @contractspec/lib.identity-rbac@1.42.0
+  - @contractspec/lib.jobs@1.42.0
+  - @contractspec/lib.metering@1.42.0
+  - @contractspec/lib.schema@1.42.0
+  - @contractspec/module.audit-trail@1.42.0
+  - @contractspec/module.learning-journey@1.42.0
+  - @contractspec/module.notifications@1.42.0

package/IMPLEMENTATION_SKETCH.md

@@ -0,0 +1,40 @@
+## Implementation sketch — Policy-safe Knowledge Assistant (example)
+
+This example package is **spec-first** and demonstrates how to compose:
+
+- `@contractspec/example.locale-jurisdiction-gate`
+- `@contractspec/example.versioned-knowledge-base`
+- `@contractspec/example.kb-update-pipeline`
+- `@contractspec/example.learning-patterns`
+
+The runnable **sandbox UI/runtime** lives in `@contractspec/bundle.studio` (wired later).
+
+### Package boundaries
+
+- **Gate**: validates `locale`, `jurisdiction`, `kbSnapshotId`, `allowedScope`. Refuses if citations are missing or scope is violated.
+- **Versioned KB**: stores immutable sources and versioned rules; publishes snapshots containing only approved rule versions.
+- **Update Pipeline (HITL)**: detects changes, creates review tasks, gates approvals by risk level; publishing remains blocked until all proposed rule versions are approved.
+- **Learning patterns**: drills/coach/quests as event-driven Learning Journey tracks.
+
+### Key invariants (fail-closed)
+
+- No assistant call without explicit `locale` and `jurisdiction`.
+- No assistant answer without at least one citation referencing a **KB snapshot**.
+- Snapshot publishing includes only approved rule versions and is jurisdiction-scoped.
+- High-risk KB changes require expert approval.
+
+### What is stubbed vs real
+
+- **LLM**: stubbed/deterministic (no external calls). Answers are derived from KB search results.
+- **Source fetching**: stubbed/offline fixtures (no web truth).
+- **Storage**: in tests, in-memory stores; in sandbox, browser SQLite + IndexedDB.
+
+
+
+
+
+
+
+
+
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Chaman Ventures, SASU
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# `@contractspec/example.policy-safe-knowledge-assistant`
+
+Website: https://contractspec.io/
+
+
+All-in-one template example demonstrating a **policy-safe knowledge assistant** end-to-end:
+
+- Locale + jurisdiction gating (fail-closed)
+- Versioned curated KB + published snapshots
+- Automated KB update pipeline with HITL review + traceability
+- 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+
+
+
+
+
+
+
+
+
+

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./policy-safe-knowledge-assistant.docblock.js";

package/dist/docs/policy-safe-knowledge-assistant.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/policy-safe-knowledge-assistant.docblock.js

@@ -0,0 +1,35 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/policy-safe-knowledge-assistant.docblock.ts
+registerDocBlocks([{
+	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.`
+}]);
+
+//#endregion
+//# sourceMappingURL=policy-safe-knowledge-assistant.docblock.js.map

package/dist/docs/policy-safe-knowledge-assistant.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy-safe-knowledge-assistant.docblock.js","names":[],"sources":["../../src/docs/policy-safe-knowledge-assistant.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst docBlocks: DocBlock[] = [\n  {\n    id: 'docs.examples.policy-safe-knowledge-assistant.goal',\n    title: 'Policy-safe Knowledge Assistant — Goal',\n    summary:\n      'End-to-end example: versioned KB snapshots + locale/jurisdiction gating + HITL pipeline + learning hub.',\n    kind: 'goal',\n    visibility: 'public',\n    route: '/docs/examples/policy-safe-knowledge-assistant/goal',\n    tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],\n    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).`,\n  },\n  {\n    id: 'docs.examples.policy-safe-knowledge-assistant.usage',\n    title: 'Policy-safe Knowledge Assistant — Usage',\n    summary: '5–10 minute sandbox walkthrough for developers.',\n    kind: 'usage',\n    visibility: 'public',\n    route: '/docs/examples/policy-safe-knowledge-assistant/usage',\n    tags: ['assistant', 'knowledge', 'usage'],\n    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.`,\n  },\n];\n\nregisterDocBlocks(docBlocks);\n"],"mappings":";;;AA2BA,kBAxB8B,CAC5B;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAa;EAAa;EAAU;EAAQ;EAAW;CAC9D,MAAM;CACP,EACD;CACE,IAAI;CACJ,OAAO;CACP,SAAS;CACT,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAa;EAAa;EAAQ;CACzC,MAAM;CACP,CACF,CAE2B"}

package/dist/example.d.ts

@@ -0,0 +1,35 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "policy-safe-knowledge-assistant";
+  readonly title: "Policy-safe Knowledge Assistant";
+  readonly summary: "All-in-one template: locale/jurisdiction gating + versioned KB snapshots + HITL update pipeline + learning hub.";
+  readonly tags: readonly ["assistant", "knowledge", "policy", "hitl", "learning"];
+  readonly kind: "template";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly goalDocId: "docs.examples.policy-safe-knowledge-assistant.goal";
+    readonly usageDocId: "docs.examples.policy-safe-knowledge-assistant.usage";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@contractspec/example.policy-safe-knowledge-assistant";
+    readonly feature: "./feature";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["playground", "specs", "builder", "markdown", "evolution"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EA0BI,EAAA,iCAAA"}

package/dist/example.js

@@ -0,0 +1,47 @@
+//#region src/example.ts
+const example = {
+	id: "policy-safe-knowledge-assistant",
+	title: "Policy-safe Knowledge Assistant",
+	summary: "All-in-one template: locale/jurisdiction gating + versioned KB snapshots + HITL update pipeline + learning hub.",
+	tags: [
+		"assistant",
+		"knowledge",
+		"policy",
+		"hitl",
+		"learning"
+	],
+	kind: "template",
+	visibility: "public",
+	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: "./feature",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: [
+				"playground",
+				"specs",
+				"builder",
+				"markdown",
+				"evolution"
+			]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map