@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.
@@ -0,0 +1,35 @@
1
+ $ tsdown
2
+ ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
3
+ ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/policy-safe-knowledge-assistant/tsdown.config.js
4
+ ℹ 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
5
+ ℹ target: esnext
6
+ ℹ tsconfig: tsconfig.json
7
+ ℹ Build start
8
+ ℹ Cleaning 28 files
9
+ ℹ dist/orchestrator/buildAnswer.js 2.46 kB │ gzip: 0.92 kB
10
+ ℹ dist/feature.js 2.23 kB │ gzip: 0.66 kB
11
+ ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js 1.87 kB │ gzip: 0.90 kB
12
+ ℹ dist/example.js 1.01 kB │ gzip: 0.51 kB
13
+ ℹ dist/seed/fixtures.js 0.80 kB │ gzip: 0.40 kB
14
+ ℹ dist/index.js 0.38 kB │ gzip: 0.20 kB
15
+ ℹ dist/seed/index.js 0.07 kB │ gzip: 0.07 kB
16
+ ℹ dist/docs/index.js 0.06 kB │ gzip: 0.08 kB
17
+ ℹ dist/orchestrator/buildAnswer.js.map 5.07 kB │ gzip: 1.67 kB
18
+ ℹ dist/feature.js.map 3.52 kB │ gzip: 1.05 kB
19
+ ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js.map 2.36 kB │ gzip: 1.08 kB
20
+ ℹ dist/example.js.map 1.40 kB │ gzip: 0.69 kB
21
+ ℹ dist/seed/fixtures.js.map 1.29 kB │ gzip: 0.55 kB
22
+ ℹ dist/orchestrator/buildAnswer.d.ts.map 0.39 kB │ gzip: 0.25 kB
23
+ ℹ dist/seed/fixtures.d.ts.map 0.20 kB │ gzip: 0.15 kB
24
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
25
+ ℹ dist/feature.d.ts.map 0.13 kB │ gzip: 0.12 kB
26
+ ℹ dist/orchestrator/buildAnswer.d.ts 1.31 kB │ gzip: 0.57 kB
27
+ ℹ dist/example.d.ts 1.23 kB │ gzip: 0.50 kB
28
+ ℹ dist/seed/fixtures.d.ts 1.03 kB │ gzip: 0.37 kB
29
+ ℹ dist/index.d.ts 0.40 kB │ gzip: 0.20 kB
30
+ ℹ dist/feature.d.ts 0.25 kB │ gzip: 0.17 kB
31
+ ℹ dist/seed/index.d.ts 0.07 kB │ gzip: 0.07 kB
32
+ ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
33
+ ℹ dist/docs/policy-safe-knowledge-assistant.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
34
+ ℹ 25 files, total: 27.70 kB
35
+ ✔ Build complete in 11151ms
@@ -1,19 +1,36 @@
1
- $ bun build:bundle && bun build:types
1
+ $ bun build:types && bun build:bundle
2
+ $ tsc --noEmit
2
3
  $ tsdown
3
- ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
4
+ ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
4
5
  ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/policy-safe-knowledge-assistant/tsdown.config.js
5
6
  ℹ 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
6
7
  ℹ target: esnext
7
8
  ℹ tsconfig: tsconfig.json
8
9
  ℹ Build start
9
- ℹ dist/orchestrator/buildAnswer.js 1.65 kB │ gzip: 0.71 kB
10
- ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js 1.62 kB │ gzip: 0.83 kB
11
- ℹ dist/feature.js 1.57 kB │ gzip: 0.57 kB
12
- ℹ dist/example.js 0.72 kB │ gzip: 0.41 kB
13
- ℹ dist/seed/fixtures.js 0.56 kB │ gzip: 0.31 kB
14
- ℹ dist/index.js 0.35 kB │ gzip: 0.20 kB
15
- ℹ dist/seed/index.js 0.07 kB │ gzip: 0.08 kB
16
- ℹ dist/docs/index.js 0.05 kB │ gzip: 0.07 kB
17
- ℹ 8 files, total: 6.60 kB
18
- ✔ Build complete in 78ms
19
- $ tsc --noEmit
10
+ ℹ dist/orchestrator/buildAnswer.js 2.46 kB │ gzip: 0.92 kB
11
+ ℹ dist/feature.js 2.23 kB │ gzip: 0.66 kB
12
+ ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js 1.87 kB │ gzip: 0.90 kB
13
+ ℹ dist/example.js 1.01 kB │ gzip: 0.51 kB
14
+ ℹ dist/seed/fixtures.js 0.80 kB │ gzip: 0.40 kB
15
+ ℹ dist/index.js 0.38 kB │ gzip: 0.20 kB
16
+ ℹ dist/seed/index.js 0.07 kB │ gzip: 0.07 kB
17
+ ℹ dist/docs/index.js 0.06 kB │ gzip: 0.08 kB
18
+ ℹ dist/orchestrator/buildAnswer.js.map 5.07 kB │ gzip: 1.67 kB
19
+ ℹ dist/feature.js.map 3.52 kB │ gzip: 1.05 kB
20
+ ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js.map 2.36 kB │ gzip: 1.08 kB
21
+ ℹ dist/example.js.map 1.40 kB │ gzip: 0.69 kB
22
+ ℹ dist/seed/fixtures.js.map 1.29 kB │ gzip: 0.55 kB
23
+ ℹ dist/orchestrator/buildAnswer.d.ts.map 0.39 kB │ gzip: 0.25 kB
24
+ ℹ dist/seed/fixtures.d.ts.map 0.20 kB │ gzip: 0.15 kB
25
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
26
+ ℹ dist/feature.d.ts.map 0.13 kB │ gzip: 0.12 kB
27
+ ℹ dist/orchestrator/buildAnswer.d.ts 1.31 kB │ gzip: 0.57 kB
28
+ ℹ dist/example.d.ts 1.23 kB │ gzip: 0.50 kB
29
+ ℹ dist/seed/fixtures.d.ts 1.03 kB │ gzip: 0.37 kB
30
+ ℹ dist/index.d.ts 0.40 kB │ gzip: 0.20 kB
31
+ ℹ dist/feature.d.ts 0.25 kB │ gzip: 0.17 kB
32
+ ℹ dist/seed/index.d.ts 0.07 kB │ gzip: 0.07 kB
33
+ ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
34
+ ℹ dist/docs/policy-safe-knowledge-assistant.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
35
+ ℹ 25 files, total: 27.70 kB
36
+ ✔ Build complete in 16138ms
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
@@ -1,5 +1,8 @@
1
1
  # `@lssm/example.policy-safe-knowledge-assistant`
2
2
 
3
+ Website: https://contractspec.lssm.tech/
4
+
5
+
3
6
  All-in-one template example demonstrating a **policy-safe knowledge assistant** end-to-end:
4
7
 
5
8
  - Locale + jurisdiction gating (fail-closed)
@@ -0,0 +1 @@
1
+ export { };
@@ -1 +1 @@
1
- import"./policy-safe-knowledge-assistant.docblock.js";
1
+ import "./policy-safe-knowledge-assistant.docblock.js";
@@ -1,14 +1,35 @@
1
- import{registerDocBlocks as e}from"@lssm/lib.contracts/docs";e([{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
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
- ## Offline-first
8
- - Seeded fixtures are deterministic and require no external services.
9
- - 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)
10
- 1) Onboard: set locale + jurisdiction.
11
- 2) Publish snapshot: ingest source -> propose rule -> approve -> publish.
12
- 3) Ask assistant: must pass gate and cite snapshot.
13
- 4) Simulate change: watcher -> review -> publish new snapshot.
14
- 5) Learning hub: drills session, ambient tip, quest start + step completion.`}]);
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
- var e={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:`@lssm/example.policy-safe-knowledge-assistant`,feature:`./feature`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`playground`,`specs`,`builder`,`markdown`,`evolution`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};
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,7 @@
1
+ import { FeatureModuleSpec } from "@lssm/lib.contracts";
2
+
3
+ //#region src/feature.d.ts
4
+ declare const PolicySafeKnowledgeAssistantFeature: FeatureModuleSpec;
5
+ //#endregion
6
+ export { PolicySafeKnowledgeAssistantFeature };
7
+ //# sourceMappingURL=feature.d.ts.map
@@ -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
- const e={meta:{key:`policy-safe-knowledge-assistant`,title:`Policy-safe Knowledge Assistant`,description:`All-in-one example composing locale/jurisdiction gate + versioned KB + HITL pipeline + learning hub.`,domain:`knowledge`,owners:[`examples`],tags:[`assistant`,`knowledge`,`policy`,`hitl`,`learning`],stability:`experimental`},operations:[{name:`assistant.answer`,version:1},{name:`assistant.explainConcept`,version:1},{name:`kb.ingestSource`,version:1},{name:`kb.upsertRuleVersion`,version:1},{name:`kb.approveRuleVersion`,version:1},{name:`kb.publishSnapshot`,version:1},{name:`kb.search`,version:1},{name:`kbPipeline.runWatch`,version:1},{name:`kbPipeline.createReviewTask`,version:1},{name:`kbPipeline.submitDecision`,version:1},{name:`kbPipeline.publishIfReady`,version:1}],events:[{name:`assistant.answer.requested`,version:1},{name:`assistant.answer.blocked`,version:1},{name:`assistant.answer.delivered`,version:1},{name:`kb.source.ingested`,version:1},{name:`kb.ruleVersion.created`,version:1},{name:`kb.ruleVersion.approved`,version:1},{name:`kb.snapshot.published`,version:1},{name:`kb.change.detected`,version:1},{name:`kb.review.requested`,version:1},{name:`kb.review.decided`,version:1}],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{requires:[{key:`identity`,version:1},{key:`audit-trail`,version:1},{key:`notifications`,version:1},{key:`jobs`,version:1},{key:`feature-flags`,version:1},{key:`files`,version:1},{key:`metering`,version:1},{key:`learning-journey`,version:1}]}};export{e as PolicySafeKnowledgeAssistantFeature};
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"}
@@ -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 e from"./example.js";import{PolicySafeKnowledgeAssistantFeature as t}from"./feature.js";import{DEMO_FIXTURES as n}from"./seed/fixtures.js";import{buildPolicySafeAnswer as r}from"./orchestrator/buildAnswer.js";import"./docs/index.js";export{n as DEMO_FIXTURES,t as PolicySafeKnowledgeAssistantFeature,r as buildPolicySafeAnswer,e as example};
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"}