@lssm/example.policy-safe-knowledge-assistant 1.41.0 → 1.42.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.turbo/turbo-build$colon$bundle.log +35 -0
- package/.turbo/turbo-build.log +30 -13
- package/CHANGELOG.md +46 -0
- package/LICENSE +21 -0
- package/README.md +3 -0
- package/dist/docs/index.d.ts +1 -0
- package/dist/docs/index.js +1 -1
- package/dist/docs/policy-safe-knowledge-assistant.docblock.d.ts +1 -0
- package/dist/docs/policy-safe-knowledge-assistant.docblock.js +34 -13
- package/dist/docs/policy-safe-knowledge-assistant.docblock.js.map +1 -0
- package/dist/example.d.ts +35 -0
- package/dist/example.d.ts.map +1 -0
- package/dist/example.js +47 -1
- package/dist/example.js.map +1 -0
- package/dist/feature.d.ts +7 -0
- package/dist/feature.d.ts.map +1 -0
- package/dist/feature.js +148 -1
- package/dist/feature.js.map +1 -0
- package/dist/index.d.ts +5 -0
- package/dist/index.js +7 -1
- package/dist/orchestrator/buildAnswer.d.ts +53 -0
- package/dist/orchestrator/buildAnswer.d.ts.map +1 -0
- package/dist/orchestrator/buildAnswer.js +77 -1
- package/dist/orchestrator/buildAnswer.js.map +1 -0
- package/dist/seed/fixtures.d.ts +35 -0
- package/dist/seed/fixtures.d.ts.map +1 -0
- package/dist/seed/fixtures.js +34 -1
- package/dist/seed/fixtures.js.map +1 -0
- package/dist/seed/index.d.ts +2 -0
- package/dist/seed/index.js +3 -1
- package/package.json +37 -27
- package/src/feature.ts +23 -22
- package/src/orchestrator/buildAnswer.ts +2 -2
- package/tsconfig.tsbuildinfo +1 -1
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
$ tsdown
|
|
2
|
+
[34mℹ[39m tsdown [2mv0.18.3[22m powered by rolldown [2mv1.0.0-beta.57[22m
|
|
3
|
+
[34mℹ[39m config file: [4m/home/runner/work/contractspec/contractspec/packages/examples/policy-safe-knowledge-assistant/tsdown.config.js[24m
|
|
4
|
+
[34mℹ[39m entry: [34msrc/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[39m
|
|
5
|
+
[34mℹ[39m target: [34mesnext[39m
|
|
6
|
+
[34mℹ[39m tsconfig: [34mtsconfig.json[39m
|
|
7
|
+
[34mℹ[39m Build start
|
|
8
|
+
[34mℹ[39m Cleaning 28 files
|
|
9
|
+
[34mℹ[39m [2mdist/[22m[1morchestrator/buildAnswer.js[22m [2m2.46 kB[22m [2m│ gzip: 0.92 kB[22m
|
|
10
|
+
[34mℹ[39m [2mdist/[22m[1mfeature.js[22m [2m2.23 kB[22m [2m│ gzip: 0.66 kB[22m
|
|
11
|
+
[34mℹ[39m [2mdist/[22m[1mdocs/policy-safe-knowledge-assistant.docblock.js[22m [2m1.87 kB[22m [2m│ gzip: 0.90 kB[22m
|
|
12
|
+
[34mℹ[39m [2mdist/[22m[1mexample.js[22m [2m1.01 kB[22m [2m│ gzip: 0.51 kB[22m
|
|
13
|
+
[34mℹ[39m [2mdist/[22m[1mseed/fixtures.js[22m [2m0.80 kB[22m [2m│ gzip: 0.40 kB[22m
|
|
14
|
+
[34mℹ[39m [2mdist/[22m[1mindex.js[22m [2m0.38 kB[22m [2m│ gzip: 0.20 kB[22m
|
|
15
|
+
[34mℹ[39m [2mdist/[22m[1mseed/index.js[22m [2m0.07 kB[22m [2m│ gzip: 0.07 kB[22m
|
|
16
|
+
[34mℹ[39m [2mdist/[22m[1mdocs/index.js[22m [2m0.06 kB[22m [2m│ gzip: 0.08 kB[22m
|
|
17
|
+
[34mℹ[39m [2mdist/[22morchestrator/buildAnswer.js.map [2m5.07 kB[22m [2m│ gzip: 1.67 kB[22m
|
|
18
|
+
[34mℹ[39m [2mdist/[22mfeature.js.map [2m3.52 kB[22m [2m│ gzip: 1.05 kB[22m
|
|
19
|
+
[34mℹ[39m [2mdist/[22mdocs/policy-safe-knowledge-assistant.docblock.js.map [2m2.36 kB[22m [2m│ gzip: 1.08 kB[22m
|
|
20
|
+
[34mℹ[39m [2mdist/[22mexample.js.map [2m1.40 kB[22m [2m│ gzip: 0.69 kB[22m
|
|
21
|
+
[34mℹ[39m [2mdist/[22mseed/fixtures.js.map [2m1.29 kB[22m [2m│ gzip: 0.55 kB[22m
|
|
22
|
+
[34mℹ[39m [2mdist/[22morchestrator/buildAnswer.d.ts.map [2m0.39 kB[22m [2m│ gzip: 0.25 kB[22m
|
|
23
|
+
[34mℹ[39m [2mdist/[22mseed/fixtures.d.ts.map [2m0.20 kB[22m [2m│ gzip: 0.15 kB[22m
|
|
24
|
+
[34mℹ[39m [2mdist/[22mexample.d.ts.map [2m0.14 kB[22m [2m│ gzip: 0.13 kB[22m
|
|
25
|
+
[34mℹ[39m [2mdist/[22mfeature.d.ts.map [2m0.13 kB[22m [2m│ gzip: 0.12 kB[22m
|
|
26
|
+
[34mℹ[39m [2mdist/[22m[32m[1morchestrator/buildAnswer.d.ts[22m[39m [2m1.31 kB[22m [2m│ gzip: 0.57 kB[22m
|
|
27
|
+
[34mℹ[39m [2mdist/[22m[32m[1mexample.d.ts[22m[39m [2m1.23 kB[22m [2m│ gzip: 0.50 kB[22m
|
|
28
|
+
[34mℹ[39m [2mdist/[22m[32m[1mseed/fixtures.d.ts[22m[39m [2m1.03 kB[22m [2m│ gzip: 0.37 kB[22m
|
|
29
|
+
[34mℹ[39m [2mdist/[22m[32m[1mindex.d.ts[22m[39m [2m0.40 kB[22m [2m│ gzip: 0.20 kB[22m
|
|
30
|
+
[34mℹ[39m [2mdist/[22m[32m[1mfeature.d.ts[22m[39m [2m0.25 kB[22m [2m│ gzip: 0.17 kB[22m
|
|
31
|
+
[34mℹ[39m [2mdist/[22m[32m[1mseed/index.d.ts[22m[39m [2m0.07 kB[22m [2m│ gzip: 0.07 kB[22m
|
|
32
|
+
[34mℹ[39m [2mdist/[22m[32m[1mdocs/index.d.ts[22m[39m [2m0.01 kB[22m [2m│ gzip: 0.03 kB[22m
|
|
33
|
+
[34mℹ[39m [2mdist/[22m[32m[1mdocs/policy-safe-knowledge-assistant.docblock.d.ts[22m[39m [2m0.01 kB[22m [2m│ gzip: 0.03 kB[22m
|
|
34
|
+
[34mℹ[39m 25 files, total: 27.70 kB
|
|
35
|
+
[32m✔[39m Build complete in [32m11151ms[39m
|
package/.turbo/turbo-build.log
CHANGED
|
@@ -1,19 +1,36 @@
|
|
|
1
|
-
$ bun build:
|
|
1
|
+
$ bun build:types && bun build:bundle
|
|
2
|
+
$ tsc --noEmit
|
|
2
3
|
$ tsdown
|
|
3
|
-
[34mℹ[39m tsdown [2mv0.
|
|
4
|
+
[34mℹ[39m tsdown [2mv0.18.3[22m powered by rolldown [2mv1.0.0-beta.57[22m
|
|
4
5
|
[34mℹ[39m config file: [4m/home/runner/work/contractspec/contractspec/packages/examples/policy-safe-knowledge-assistant/tsdown.config.js[24m
|
|
5
6
|
[34mℹ[39m entry: [34msrc/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[39m
|
|
6
7
|
[34mℹ[39m target: [34mesnext[39m
|
|
7
8
|
[34mℹ[39m tsconfig: [34mtsconfig.json[39m
|
|
8
9
|
[34mℹ[39m Build start
|
|
9
|
-
[34mℹ[39m [2mdist/[22m[1morchestrator/buildAnswer.js[22m
|
|
10
|
-
[34mℹ[39m [2mdist/[22m[
|
|
11
|
-
[34mℹ[39m [2mdist/[22m[
|
|
12
|
-
[34mℹ[39m [2mdist/[22m[1mexample.js[22m
|
|
13
|
-
[34mℹ[39m [2mdist/[22m[1mseed/fixtures.js[22m
|
|
14
|
-
[34mℹ[39m [2mdist/[22m[1mindex.js[22m
|
|
15
|
-
[34mℹ[39m [2mdist/[22m[1mseed/index.js[22m
|
|
16
|
-
[34mℹ[39m [2mdist/[22m[1mdocs/index.js[22m
|
|
17
|
-
[34mℹ[39m
|
|
18
|
-
[
|
|
19
|
-
|
|
10
|
+
[34mℹ[39m [2mdist/[22m[1morchestrator/buildAnswer.js[22m [2m2.46 kB[22m [2m│ gzip: 0.92 kB[22m
|
|
11
|
+
[34mℹ[39m [2mdist/[22m[1mfeature.js[22m [2m2.23 kB[22m [2m│ gzip: 0.66 kB[22m
|
|
12
|
+
[34mℹ[39m [2mdist/[22m[1mdocs/policy-safe-knowledge-assistant.docblock.js[22m [2m1.87 kB[22m [2m│ gzip: 0.90 kB[22m
|
|
13
|
+
[34mℹ[39m [2mdist/[22m[1mexample.js[22m [2m1.01 kB[22m [2m│ gzip: 0.51 kB[22m
|
|
14
|
+
[34mℹ[39m [2mdist/[22m[1mseed/fixtures.js[22m [2m0.80 kB[22m [2m│ gzip: 0.40 kB[22m
|
|
15
|
+
[34mℹ[39m [2mdist/[22m[1mindex.js[22m [2m0.38 kB[22m [2m│ gzip: 0.20 kB[22m
|
|
16
|
+
[34mℹ[39m [2mdist/[22m[1mseed/index.js[22m [2m0.07 kB[22m [2m│ gzip: 0.07 kB[22m
|
|
17
|
+
[34mℹ[39m [2mdist/[22m[1mdocs/index.js[22m [2m0.06 kB[22m [2m│ gzip: 0.08 kB[22m
|
|
18
|
+
[34mℹ[39m [2mdist/[22morchestrator/buildAnswer.js.map [2m5.07 kB[22m [2m│ gzip: 1.67 kB[22m
|
|
19
|
+
[34mℹ[39m [2mdist/[22mfeature.js.map [2m3.52 kB[22m [2m│ gzip: 1.05 kB[22m
|
|
20
|
+
[34mℹ[39m [2mdist/[22mdocs/policy-safe-knowledge-assistant.docblock.js.map [2m2.36 kB[22m [2m│ gzip: 1.08 kB[22m
|
|
21
|
+
[34mℹ[39m [2mdist/[22mexample.js.map [2m1.40 kB[22m [2m│ gzip: 0.69 kB[22m
|
|
22
|
+
[34mℹ[39m [2mdist/[22mseed/fixtures.js.map [2m1.29 kB[22m [2m│ gzip: 0.55 kB[22m
|
|
23
|
+
[34mℹ[39m [2mdist/[22morchestrator/buildAnswer.d.ts.map [2m0.39 kB[22m [2m│ gzip: 0.25 kB[22m
|
|
24
|
+
[34mℹ[39m [2mdist/[22mseed/fixtures.d.ts.map [2m0.20 kB[22m [2m│ gzip: 0.15 kB[22m
|
|
25
|
+
[34mℹ[39m [2mdist/[22mexample.d.ts.map [2m0.14 kB[22m [2m│ gzip: 0.13 kB[22m
|
|
26
|
+
[34mℹ[39m [2mdist/[22mfeature.d.ts.map [2m0.13 kB[22m [2m│ gzip: 0.12 kB[22m
|
|
27
|
+
[34mℹ[39m [2mdist/[22m[32m[1morchestrator/buildAnswer.d.ts[22m[39m [2m1.31 kB[22m [2m│ gzip: 0.57 kB[22m
|
|
28
|
+
[34mℹ[39m [2mdist/[22m[32m[1mexample.d.ts[22m[39m [2m1.23 kB[22m [2m│ gzip: 0.50 kB[22m
|
|
29
|
+
[34mℹ[39m [2mdist/[22m[32m[1mseed/fixtures.d.ts[22m[39m [2m1.03 kB[22m [2m│ gzip: 0.37 kB[22m
|
|
30
|
+
[34mℹ[39m [2mdist/[22m[32m[1mindex.d.ts[22m[39m [2m0.40 kB[22m [2m│ gzip: 0.20 kB[22m
|
|
31
|
+
[34mℹ[39m [2mdist/[22m[32m[1mfeature.d.ts[22m[39m [2m0.25 kB[22m [2m│ gzip: 0.17 kB[22m
|
|
32
|
+
[34mℹ[39m [2mdist/[22m[32m[1mseed/index.d.ts[22m[39m [2m0.07 kB[22m [2m│ gzip: 0.07 kB[22m
|
|
33
|
+
[34mℹ[39m [2mdist/[22m[32m[1mdocs/index.d.ts[22m[39m [2m0.01 kB[22m [2m│ gzip: 0.03 kB[22m
|
|
34
|
+
[34mℹ[39m [2mdist/[22m[32m[1mdocs/policy-safe-knowledge-assistant.docblock.d.ts[22m[39m [2m0.01 kB[22m [2m│ gzip: 0.03 kB[22m
|
|
35
|
+
[34mℹ[39m 25 files, total: 27.70 kB
|
|
36
|
+
[32m✔[39m Build complete in [32m16138ms[39m
|
package/CHANGELOG.md
ADDED
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
# @lssm/example.policy-safe-knowledge-assistant
|
|
2
|
+
|
|
3
|
+
## 1.42.1
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- f043995: Fix release
|
|
8
|
+
- Updated dependencies [f043995]
|
|
9
|
+
- @lssm/example.locale-jurisdiction-gate@1.42.1
|
|
10
|
+
- @lssm/example.versioned-knowledge-base@1.42.1
|
|
11
|
+
- @lssm/example.kb-update-pipeline@1.42.1
|
|
12
|
+
- @lssm/example.learning-patterns@1.42.1
|
|
13
|
+
- @lssm/module.learning-journey@1.42.1
|
|
14
|
+
- @lssm/module.notifications@1.42.1
|
|
15
|
+
- @lssm/module.audit-trail@1.42.1
|
|
16
|
+
- @lssm/lib.feature-flags@1.42.1
|
|
17
|
+
- @lssm/lib.identity-rbac@1.42.1
|
|
18
|
+
- @lssm/lib.contracts@1.42.1
|
|
19
|
+
- @lssm/lib.metering@1.42.1
|
|
20
|
+
- @lssm/lib.schema@1.42.1
|
|
21
|
+
- @lssm/lib.files@1.42.1
|
|
22
|
+
- @lssm/lib.jobs@1.42.1
|
|
23
|
+
|
|
24
|
+
## 1.42.0
|
|
25
|
+
|
|
26
|
+
### Minor Changes
|
|
27
|
+
|
|
28
|
+
- 8eefd9c: initial release
|
|
29
|
+
|
|
30
|
+
### Patch Changes
|
|
31
|
+
|
|
32
|
+
- Updated dependencies [8eefd9c]
|
|
33
|
+
- @lssm/example.kb-update-pipeline@1.42.0
|
|
34
|
+
- @lssm/example.learning-patterns@1.42.0
|
|
35
|
+
- @lssm/example.locale-jurisdiction-gate@1.42.0
|
|
36
|
+
- @lssm/example.versioned-knowledge-base@1.42.0
|
|
37
|
+
- @lssm/lib.contracts@1.42.0
|
|
38
|
+
- @lssm/lib.feature-flags@1.42.0
|
|
39
|
+
- @lssm/lib.files@1.42.0
|
|
40
|
+
- @lssm/lib.identity-rbac@1.42.0
|
|
41
|
+
- @lssm/lib.jobs@1.42.0
|
|
42
|
+
- @lssm/lib.metering@1.42.0
|
|
43
|
+
- @lssm/lib.schema@1.42.0
|
|
44
|
+
- @lssm/module.audit-trail@1.42.0
|
|
45
|
+
- @lssm/module.learning-journey@1.42.0
|
|
46
|
+
- @lssm/module.notifications@1.42.0
|
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2025 Chaman Ventures, SASU
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { };
|
package/dist/docs/index.js
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
import"./policy-safe-knowledge-assistant.docblock.js";
|
|
1
|
+
import "./policy-safe-knowledge-assistant.docblock.js";
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
export { };
|
|
@@ -1,14 +1,35 @@
|
|
|
1
|
-
import{registerDocBlocks
|
|
2
|
-
- Assistant answers are structured and must cite a KB snapshot (or refuse).
|
|
3
|
-
- Locale + jurisdiction are mandatory inputs for every assistant call.
|
|
4
|
-
- Automation proposes KB patches; humans verify; publishing stays blocked until approvals.
|
|
5
|
-
- Learning hub demonstrates drills + coaching + quests without spam.
|
|
1
|
+
import { registerDocBlocks } from "@lssm/lib.contracts/docs";
|
|
6
2
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
3
|
+
//#region src/docs/policy-safe-knowledge-assistant.docblock.ts
|
|
4
|
+
registerDocBlocks([{
|
|
5
|
+
id: "docs.examples.policy-safe-knowledge-assistant.goal",
|
|
6
|
+
title: "Policy-safe Knowledge Assistant — Goal",
|
|
7
|
+
summary: "End-to-end example: versioned KB snapshots + locale/jurisdiction gating + HITL pipeline + learning hub.",
|
|
8
|
+
kind: "goal",
|
|
9
|
+
visibility: "public",
|
|
10
|
+
route: "/docs/examples/policy-safe-knowledge-assistant/goal",
|
|
11
|
+
tags: [
|
|
12
|
+
"assistant",
|
|
13
|
+
"knowledge",
|
|
14
|
+
"policy",
|
|
15
|
+
"hitl",
|
|
16
|
+
"learning"
|
|
17
|
+
],
|
|
18
|
+
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).`
|
|
19
|
+
}, {
|
|
20
|
+
id: "docs.examples.policy-safe-knowledge-assistant.usage",
|
|
21
|
+
title: "Policy-safe Knowledge Assistant — Usage",
|
|
22
|
+
summary: "5–10 minute sandbox walkthrough for developers.",
|
|
23
|
+
kind: "usage",
|
|
24
|
+
visibility: "public",
|
|
25
|
+
route: "/docs/examples/policy-safe-knowledge-assistant/usage",
|
|
26
|
+
tags: [
|
|
27
|
+
"assistant",
|
|
28
|
+
"knowledge",
|
|
29
|
+
"usage"
|
|
30
|
+
],
|
|
31
|
+
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.`
|
|
32
|
+
}]);
|
|
33
|
+
|
|
34
|
+
//#endregion
|
|
35
|
+
//# sourceMappingURL=policy-safe-knowledge-assistant.docblock.js.map
|
|
@@ -0,0 +1 @@
|
|
|
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 '@lssm/lib.contracts/docs';\nimport { registerDocBlocks } from '@lssm/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"}
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
//#region src/example.d.ts
|
|
2
|
+
declare const example: {
|
|
3
|
+
readonly id: "policy-safe-knowledge-assistant";
|
|
4
|
+
readonly title: "Policy-safe Knowledge Assistant";
|
|
5
|
+
readonly summary: "All-in-one template: locale/jurisdiction gating + versioned KB snapshots + HITL update pipeline + learning hub.";
|
|
6
|
+
readonly tags: readonly ["assistant", "knowledge", "policy", "hitl", "learning"];
|
|
7
|
+
readonly kind: "template";
|
|
8
|
+
readonly visibility: "public";
|
|
9
|
+
readonly docs: {
|
|
10
|
+
readonly goalDocId: "docs.examples.policy-safe-knowledge-assistant.goal";
|
|
11
|
+
readonly usageDocId: "docs.examples.policy-safe-knowledge-assistant.usage";
|
|
12
|
+
};
|
|
13
|
+
readonly entrypoints: {
|
|
14
|
+
readonly packageName: "@lssm/example.policy-safe-knowledge-assistant";
|
|
15
|
+
readonly feature: "./feature";
|
|
16
|
+
readonly docs: "./docs";
|
|
17
|
+
};
|
|
18
|
+
readonly surfaces: {
|
|
19
|
+
readonly templates: true;
|
|
20
|
+
readonly sandbox: {
|
|
21
|
+
readonly enabled: true;
|
|
22
|
+
readonly modes: readonly ["playground", "specs", "builder", "markdown", "evolution"];
|
|
23
|
+
};
|
|
24
|
+
readonly studio: {
|
|
25
|
+
readonly enabled: true;
|
|
26
|
+
readonly installable: true;
|
|
27
|
+
};
|
|
28
|
+
readonly mcp: {
|
|
29
|
+
readonly enabled: true;
|
|
30
|
+
};
|
|
31
|
+
};
|
|
32
|
+
};
|
|
33
|
+
//#endregion
|
|
34
|
+
export { example as default };
|
|
35
|
+
//# sourceMappingURL=example.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EA0BI,EAAA,iCAAA"}
|
package/dist/example.js
CHANGED
|
@@ -1 +1,47 @@
|
|
|
1
|
-
|
|
1
|
+
//#region src/example.ts
|
|
2
|
+
const example = {
|
|
3
|
+
id: "policy-safe-knowledge-assistant",
|
|
4
|
+
title: "Policy-safe Knowledge Assistant",
|
|
5
|
+
summary: "All-in-one template: locale/jurisdiction gating + versioned KB snapshots + HITL update pipeline + learning hub.",
|
|
6
|
+
tags: [
|
|
7
|
+
"assistant",
|
|
8
|
+
"knowledge",
|
|
9
|
+
"policy",
|
|
10
|
+
"hitl",
|
|
11
|
+
"learning"
|
|
12
|
+
],
|
|
13
|
+
kind: "template",
|
|
14
|
+
visibility: "public",
|
|
15
|
+
docs: {
|
|
16
|
+
goalDocId: "docs.examples.policy-safe-knowledge-assistant.goal",
|
|
17
|
+
usageDocId: "docs.examples.policy-safe-knowledge-assistant.usage"
|
|
18
|
+
},
|
|
19
|
+
entrypoints: {
|
|
20
|
+
packageName: "@lssm/example.policy-safe-knowledge-assistant",
|
|
21
|
+
feature: "./feature",
|
|
22
|
+
docs: "./docs"
|
|
23
|
+
},
|
|
24
|
+
surfaces: {
|
|
25
|
+
templates: true,
|
|
26
|
+
sandbox: {
|
|
27
|
+
enabled: true,
|
|
28
|
+
modes: [
|
|
29
|
+
"playground",
|
|
30
|
+
"specs",
|
|
31
|
+
"builder",
|
|
32
|
+
"markdown",
|
|
33
|
+
"evolution"
|
|
34
|
+
]
|
|
35
|
+
},
|
|
36
|
+
studio: {
|
|
37
|
+
enabled: true,
|
|
38
|
+
installable: true
|
|
39
|
+
},
|
|
40
|
+
mcp: { enabled: true }
|
|
41
|
+
}
|
|
42
|
+
};
|
|
43
|
+
var example_default = example;
|
|
44
|
+
|
|
45
|
+
//#endregion
|
|
46
|
+
export { example_default as default };
|
|
47
|
+
//# sourceMappingURL=example.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n id: 'policy-safe-knowledge-assistant',\n title: 'Policy-safe Knowledge Assistant',\n summary:\n 'All-in-one template: locale/jurisdiction gating + versioned KB snapshots + HITL update pipeline + learning hub.',\n tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],\n kind: 'template',\n visibility: 'public',\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: '@lssm/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} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAa;EAAa;EAAU;EAAQ;EAAW;CAC9D,MAAM;CACN,YAAY;CACZ,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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"feature.d.ts","names":[],"sources":["../src/feature.ts"],"sourcesContent":[],"mappings":";;;cAEa,qCAAqC"}
|
package/dist/feature.js
CHANGED
|
@@ -1 +1,148 @@
|
|
|
1
|
-
|
|
1
|
+
//#region src/feature.ts
|
|
2
|
+
const PolicySafeKnowledgeAssistantFeature = {
|
|
3
|
+
meta: {
|
|
4
|
+
key: "policy-safe-knowledge-assistant",
|
|
5
|
+
version: 1,
|
|
6
|
+
title: "Policy-safe Knowledge Assistant",
|
|
7
|
+
description: "All-in-one example composing locale/jurisdiction gate + versioned KB + HITL pipeline + learning hub.",
|
|
8
|
+
domain: "knowledge",
|
|
9
|
+
owners: ["@examples"],
|
|
10
|
+
tags: [
|
|
11
|
+
"assistant",
|
|
12
|
+
"knowledge",
|
|
13
|
+
"policy",
|
|
14
|
+
"hitl",
|
|
15
|
+
"learning"
|
|
16
|
+
],
|
|
17
|
+
stability: "experimental"
|
|
18
|
+
},
|
|
19
|
+
operations: [
|
|
20
|
+
{
|
|
21
|
+
key: "assistant.answer",
|
|
22
|
+
version: 1
|
|
23
|
+
},
|
|
24
|
+
{
|
|
25
|
+
key: "assistant.explainConcept",
|
|
26
|
+
version: 1
|
|
27
|
+
},
|
|
28
|
+
{
|
|
29
|
+
key: "kb.ingestSource",
|
|
30
|
+
version: 1
|
|
31
|
+
},
|
|
32
|
+
{
|
|
33
|
+
key: "kb.upsertRuleVersion",
|
|
34
|
+
version: 1
|
|
35
|
+
},
|
|
36
|
+
{
|
|
37
|
+
key: "kb.approveRuleVersion",
|
|
38
|
+
version: 1
|
|
39
|
+
},
|
|
40
|
+
{
|
|
41
|
+
key: "kb.publishSnapshot",
|
|
42
|
+
version: 1
|
|
43
|
+
},
|
|
44
|
+
{
|
|
45
|
+
key: "kb.search",
|
|
46
|
+
version: 1
|
|
47
|
+
},
|
|
48
|
+
{
|
|
49
|
+
key: "kbPipeline.runWatch",
|
|
50
|
+
version: 1
|
|
51
|
+
},
|
|
52
|
+
{
|
|
53
|
+
key: "kbPipeline.createReviewTask",
|
|
54
|
+
version: 1
|
|
55
|
+
},
|
|
56
|
+
{
|
|
57
|
+
key: "kbPipeline.submitDecision",
|
|
58
|
+
version: 1
|
|
59
|
+
},
|
|
60
|
+
{
|
|
61
|
+
key: "kbPipeline.publishIfReady",
|
|
62
|
+
version: 1
|
|
63
|
+
}
|
|
64
|
+
],
|
|
65
|
+
events: [
|
|
66
|
+
{
|
|
67
|
+
key: "assistant.answer.requested",
|
|
68
|
+
version: 1
|
|
69
|
+
},
|
|
70
|
+
{
|
|
71
|
+
key: "assistant.answer.blocked",
|
|
72
|
+
version: 1
|
|
73
|
+
},
|
|
74
|
+
{
|
|
75
|
+
key: "assistant.answer.delivered",
|
|
76
|
+
version: 1
|
|
77
|
+
},
|
|
78
|
+
{
|
|
79
|
+
key: "kb.source.ingested",
|
|
80
|
+
version: 1
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
key: "kb.ruleVersion.created",
|
|
84
|
+
version: 1
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
key: "kb.ruleVersion.approved",
|
|
88
|
+
version: 1
|
|
89
|
+
},
|
|
90
|
+
{
|
|
91
|
+
key: "kb.snapshot.published",
|
|
92
|
+
version: 1
|
|
93
|
+
},
|
|
94
|
+
{
|
|
95
|
+
key: "kb.change.detected",
|
|
96
|
+
version: 1
|
|
97
|
+
},
|
|
98
|
+
{
|
|
99
|
+
key: "kb.review.requested",
|
|
100
|
+
version: 1
|
|
101
|
+
},
|
|
102
|
+
{
|
|
103
|
+
key: "kb.review.decided",
|
|
104
|
+
version: 1
|
|
105
|
+
}
|
|
106
|
+
],
|
|
107
|
+
presentations: [],
|
|
108
|
+
opToPresentation: [],
|
|
109
|
+
presentationsTargets: [],
|
|
110
|
+
capabilities: { requires: [
|
|
111
|
+
{
|
|
112
|
+
key: "identity",
|
|
113
|
+
version: 1
|
|
114
|
+
},
|
|
115
|
+
{
|
|
116
|
+
key: "audit-trail",
|
|
117
|
+
version: 1
|
|
118
|
+
},
|
|
119
|
+
{
|
|
120
|
+
key: "notifications",
|
|
121
|
+
version: 1
|
|
122
|
+
},
|
|
123
|
+
{
|
|
124
|
+
key: "jobs",
|
|
125
|
+
version: 1
|
|
126
|
+
},
|
|
127
|
+
{
|
|
128
|
+
key: "feature-flags",
|
|
129
|
+
version: 1
|
|
130
|
+
},
|
|
131
|
+
{
|
|
132
|
+
key: "files",
|
|
133
|
+
version: 1
|
|
134
|
+
},
|
|
135
|
+
{
|
|
136
|
+
key: "metering",
|
|
137
|
+
version: 1
|
|
138
|
+
},
|
|
139
|
+
{
|
|
140
|
+
key: "learning-journey",
|
|
141
|
+
version: 1
|
|
142
|
+
}
|
|
143
|
+
] }
|
|
144
|
+
};
|
|
145
|
+
|
|
146
|
+
//#endregion
|
|
147
|
+
export { PolicySafeKnowledgeAssistantFeature };
|
|
148
|
+
//# sourceMappingURL=feature.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"feature.js","names":["PolicySafeKnowledgeAssistantFeature: FeatureModuleSpec"],"sources":["../src/feature.ts"],"sourcesContent":["import type { FeatureModuleSpec } from '@lssm/lib.contracts';\n\nexport const PolicySafeKnowledgeAssistantFeature: FeatureModuleSpec = {\n meta: {\n key: 'policy-safe-knowledge-assistant',\n version: 1,\n title: 'Policy-safe Knowledge Assistant',\n description:\n 'All-in-one example composing locale/jurisdiction gate + versioned KB + HITL pipeline + learning hub.',\n domain: 'knowledge',\n owners: ['@examples'],\n tags: ['assistant', 'knowledge', 'policy', 'hitl', 'learning'],\n stability: 'experimental',\n },\n operations: [\n // Gate\n { key: 'assistant.answer', version: 1 },\n { key: 'assistant.explainConcept', version: 1 },\n // KB\n { key: 'kb.ingestSource', version: 1 },\n { key: 'kb.upsertRuleVersion', version: 1 },\n { key: 'kb.approveRuleVersion', version: 1 },\n { key: 'kb.publishSnapshot', version: 1 },\n { key: 'kb.search', version: 1 },\n // Pipeline\n { key: 'kbPipeline.runWatch', version: 1 },\n { key: 'kbPipeline.createReviewTask', version: 1 },\n { key: 'kbPipeline.submitDecision', version: 1 },\n { key: 'kbPipeline.publishIfReady', version: 1 },\n ],\n events: [\n { key: 'assistant.answer.requested', version: 1 },\n { key: 'assistant.answer.blocked', version: 1 },\n { key: 'assistant.answer.delivered', version: 1 },\n { key: 'kb.source.ingested', version: 1 },\n { key: 'kb.ruleVersion.created', version: 1 },\n { key: 'kb.ruleVersion.approved', version: 1 },\n { key: 'kb.snapshot.published', version: 1 },\n { key: 'kb.change.detected', version: 1 },\n { key: 'kb.review.requested', version: 1 },\n { key: 'kb.review.decided', version: 1 },\n ],\n presentations: [],\n opToPresentation: [],\n presentationsTargets: [],\n capabilities: {\n requires: [\n { key: 'identity', version: 1 },\n { key: 'audit-trail', version: 1 },\n { key: 'notifications', version: 1 },\n { key: 'jobs', version: 1 },\n { key: 'feature-flags', version: 1 },\n { key: 'files', version: 1 },\n { key: 'metering', version: 1 },\n { key: 'learning-journey', version: 1 },\n ],\n },\n};\n"],"mappings":";AAEA,MAAaA,sCAAyD;CACpE,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAa;GAAU;GAAQ;GAAW;EAC9D,WAAW;EACZ;CACD,YAAY;EAEV;GAAE,KAAK;GAAoB,SAAS;GAAG;EACvC;GAAE,KAAK;GAA4B,SAAS;GAAG;EAE/C;GAAE,KAAK;GAAmB,SAAS;GAAG;EACtC;GAAE,KAAK;GAAwB,SAAS;GAAG;EAC3C;GAAE,KAAK;GAAyB,SAAS;GAAG;EAC5C;GAAE,KAAK;GAAsB,SAAS;GAAG;EACzC;GAAE,KAAK;GAAa,SAAS;GAAG;EAEhC;GAAE,KAAK;GAAuB,SAAS;GAAG;EAC1C;GAAE,KAAK;GAA+B,SAAS;GAAG;EAClD;GAAE,KAAK;GAA6B,SAAS;GAAG;EAChD;GAAE,KAAK;GAA6B,SAAS;GAAG;EACjD;CACD,QAAQ;EACN;GAAE,KAAK;GAA8B,SAAS;GAAG;EACjD;GAAE,KAAK;GAA4B,SAAS;GAAG;EAC/C;GAAE,KAAK;GAA8B,SAAS;GAAG;EACjD;GAAE,KAAK;GAAsB,SAAS;GAAG;EACzC;GAAE,KAAK;GAA0B,SAAS;GAAG;EAC7C;GAAE,KAAK;GAA2B,SAAS;GAAG;EAC9C;GAAE,KAAK;GAAyB,SAAS;GAAG;EAC5C;GAAE,KAAK;GAAsB,SAAS;GAAG;EACzC;GAAE,KAAK;GAAuB,SAAS;GAAG;EAC1C;GAAE,KAAK;GAAqB,SAAS;GAAG;EACzC;CACD,eAAe,EAAE;CACjB,kBAAkB,EAAE;CACpB,sBAAsB,EAAE;CACxB,cAAc,EACZ,UAAU;EACR;GAAE,KAAK;GAAY,SAAS;GAAG;EAC/B;GAAE,KAAK;GAAe,SAAS;GAAG;EAClC;GAAE,KAAK;GAAiB,SAAS;GAAG;EACpC;GAAE,KAAK;GAAQ,SAAS;GAAG;EAC3B;GAAE,KAAK;GAAiB,SAAS;GAAG;EACpC;GAAE,KAAK;GAAS,SAAS;GAAG;EAC5B;GAAE,KAAK;GAAY,SAAS;GAAG;EAC/B;GAAE,KAAK;GAAoB,SAAS;GAAG;EACxC,EACF;CACF"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,5 @@
|
|
|
1
|
+
import example from "./example.js";
|
|
2
|
+
import { PolicySafeKnowledgeAssistantFeature } from "./feature.js";
|
|
3
|
+
import { DEMO_FIXTURES } from "./seed/fixtures.js";
|
|
4
|
+
import { AssistantAnswerIR, BuildAnswerInput, buildPolicySafeAnswer } from "./orchestrator/buildAnswer.js";
|
|
5
|
+
export { AssistantAnswerIR, BuildAnswerInput, DEMO_FIXTURES, PolicySafeKnowledgeAssistantFeature, buildPolicySafeAnswer, example };
|
package/dist/index.js
CHANGED
|
@@ -1 +1,7 @@
|
|
|
1
|
-
import
|
|
1
|
+
import example_default from "./example.js";
|
|
2
|
+
import { PolicySafeKnowledgeAssistantFeature } from "./feature.js";
|
|
3
|
+
import { DEMO_FIXTURES } from "./seed/fixtures.js";
|
|
4
|
+
import { buildPolicySafeAnswer } from "./orchestrator/buildAnswer.js";
|
|
5
|
+
import "./docs/index.js";
|
|
6
|
+
|
|
7
|
+
export { DEMO_FIXTURES, PolicySafeKnowledgeAssistantFeature, buildPolicySafeAnswer, example_default as example };
|
|
@@ -0,0 +1,53 @@
|
|
|
1
|
+
//#region src/orchestrator/buildAnswer.d.ts
|
|
2
|
+
type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
|
|
3
|
+
interface AssistantAnswerIR {
|
|
4
|
+
locale: string;
|
|
5
|
+
jurisdiction: string;
|
|
6
|
+
allowedScope: AllowedScope;
|
|
7
|
+
sections: {
|
|
8
|
+
heading: string;
|
|
9
|
+
body: string;
|
|
10
|
+
}[];
|
|
11
|
+
citations: {
|
|
12
|
+
kbSnapshotId: string;
|
|
13
|
+
sourceType: string;
|
|
14
|
+
sourceId: string;
|
|
15
|
+
title?: string;
|
|
16
|
+
excerpt?: string;
|
|
17
|
+
}[];
|
|
18
|
+
disclaimers?: string[];
|
|
19
|
+
riskFlags?: string[];
|
|
20
|
+
refused?: boolean;
|
|
21
|
+
refusalReason?: string;
|
|
22
|
+
}
|
|
23
|
+
interface BuildAnswerInput {
|
|
24
|
+
envelope: {
|
|
25
|
+
traceId: string;
|
|
26
|
+
locale: string;
|
|
27
|
+
kbSnapshotId: string;
|
|
28
|
+
allowedScope: AllowedScope;
|
|
29
|
+
regulatoryContext: {
|
|
30
|
+
jurisdiction: string;
|
|
31
|
+
};
|
|
32
|
+
};
|
|
33
|
+
question: string;
|
|
34
|
+
kbSearch: (input: {
|
|
35
|
+
snapshotId: string;
|
|
36
|
+
jurisdiction: string;
|
|
37
|
+
query: string;
|
|
38
|
+
}) => Promise<{
|
|
39
|
+
items: {
|
|
40
|
+
ruleVersionId: string;
|
|
41
|
+
excerpt?: string;
|
|
42
|
+
}[];
|
|
43
|
+
}>;
|
|
44
|
+
}
|
|
45
|
+
/**
|
|
46
|
+
* Build a policy-safe assistant answer derived from KB search results.
|
|
47
|
+
*
|
|
48
|
+
* Deterministic: no LLM calls; if search yields no results, it refuses.
|
|
49
|
+
*/
|
|
50
|
+
declare function buildPolicySafeAnswer(input: BuildAnswerInput): Promise<AssistantAnswerIR>;
|
|
51
|
+
//#endregion
|
|
52
|
+
export { AssistantAnswerIR, BuildAnswerInput, buildPolicySafeAnswer };
|
|
53
|
+
//# sourceMappingURL=buildAnswer.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"buildAnswer.d.ts","names":[],"sources":["../../src/orchestrator/buildAnswer.ts"],"sourcesContent":[],"mappings":";KAMK,YAAA;AAAA,UAEY,iBAAA,CAFA;EAEA,MAAA,EAAA,MAAA;EAkBA,YAAA,EAAA,MAAgB;EAqBX,YAAA,EApCN,YAoC2B;EAClC,QAAA,EAAA;IACE,OAAA,EAAA,MAAA;IAAR,IAAA,EAAA,MAAA;EAAO,CAAA,EAAA;;;;;;;;;;;;;UAvBO,gBAAA;;;;;kBAKC;;;;;;;;;;QAQV;;;;;;;;;;;;iBAQc,qBAAA,QACb,mBACN,QAAQ"}
|