@lssm/example.policy-safe-knowledge-assistant 0.0.0-canary-20251217054315 → 0.0.0-canary-20251217060433

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

@@ -0,0 +1,27 @@
+
+$ tsdown
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
+ℹ config file: /Users/tboutron/Documents/clients/lssm/monorepo-lssm/packages/contractspec/packages/examples/policy-safe-knowledge-assistant/tsdown.config.js (unrun)
+ℹ entry: src/example.ts, src/feature.ts, src/index.ts, src/docs/index.ts, src/docs/policy-safe-knowledge-assistant.docblock.ts, src/seed/fixtures.ts, src/seed/index.ts, src/orchestrator/buildAnswer.ts
+ℹ target: esnext
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 19 files
+ℹ dist/orchestrator/buildAnswer.js                         1.65 kB │ gzip: 0.71 kB
+ℹ dist/docs/policy-safe-knowledge-assistant.docblock.js    1.62 kB │ gzip: 0.83 kB
+ℹ dist/feature.js                                          1.57 kB │ gzip: 0.57 kB
+ℹ dist/example.js                                          0.72 kB │ gzip: 0.41 kB
+ℹ dist/seed/fixtures.js                                    0.56 kB │ gzip: 0.31 kB
+ℹ dist/index.js                                            0.35 kB │ gzip: 0.20 kB
+ℹ dist/seed/index.js                                       0.07 kB │ gzip: 0.08 kB
+ℹ dist/docs/index.js                                       0.05 kB │ gzip: 0.07 kB
+ℹ dist/orchestrator/buildAnswer.d.ts                       1.27 kB │ gzip: 0.55 kB
+ℹ dist/example.d.ts                                        1.20 kB │ gzip: 0.48 kB
+ℹ dist/seed/fixtures.d.ts                                  0.99 kB │ gzip: 0.35 kB
+ℹ dist/index.d.ts                                          0.40 kB │ gzip: 0.20 kB
+ℹ dist/feature.d.ts                                        0.21 kB │ gzip: 0.15 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
+ℹ 16 files, total: 10.77 kB
+✔ Build complete in 4821ms

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @lssm/example.policy-safe-knowledge-assistant
 
-## 0.0.0-canary-20251217054315
+## 0.0.0-canary-20251217060433
 
 ### Minor Changes
 
@@ -9,62 +9,16 @@
 ### Patch Changes
 
 - Updated dependencies [66a5dfd]
-  - @lssm/example.kb-update-pipeline@0.0.0-canary-20251217054315
-  - @lssm/example.learning-patterns@0.0.0-canary-20251217054315
-  - @lssm/example.locale-jurisdiction-gate@0.0.0-canary-20251217054315
-  - @lssm/example.versioned-knowledge-base@0.0.0-canary-20251217054315
-  - @lssm/lib.contracts@0.0.0-canary-20251217054315
-  - @lssm/lib.feature-flags@0.0.0-canary-20251217054315
-  - @lssm/lib.files@0.0.0-canary-20251217054315
-  - @lssm/lib.identity-rbac@0.0.0-canary-20251217054315
-  - @lssm/lib.jobs@0.0.0-canary-20251217054315
-  - @lssm/lib.metering@0.0.0-canary-20251217054315
-  - @lssm/module.audit-trail@0.0.0-canary-20251217054315
-  - @lssm/module.learning-journey@0.0.0-canary-20251217054315
-  - @lssm/module.notifications@0.0.0-canary-20251217054315
-
-## 1.42.0
-
-### Minor Changes
-
-- 66a5dfd: initial release
-
-### Patch Changes
-
-- Updated dependencies [66a5dfd]
-  - @lssm/example.kb-update-pipeline@1.42.0
-  - @lssm/example.learning-patterns@1.42.0
-  - @lssm/example.locale-jurisdiction-gate@1.42.0
-  - @lssm/example.versioned-knowledge-base@1.42.0
-  - @lssm/lib.contracts@1.42.0
-  - @lssm/lib.feature-flags@1.42.0
-  - @lssm/lib.files@1.42.0
-  - @lssm/lib.identity-rbac@1.42.0
-  - @lssm/lib.jobs@1.42.0
-  - @lssm/lib.metering@1.42.0
-  - @lssm/module.audit-trail@1.42.0
-  - @lssm/module.learning-journey@1.42.0
-  - @lssm/module.notifications@1.42.0
-
-## 0.0.0-canary-20251217053014
-
-### Minor Changes
-
-- 66a5dfd: initial release
-
-### Patch Changes
-
-- Updated dependencies [66a5dfd]
-  - @lssm/example.kb-update-pipeline@0.0.0-canary-20251217053014
-  - @lssm/example.learning-patterns@0.0.0-canary-20251217053014
-  - @lssm/example.locale-jurisdiction-gate@0.0.0-canary-20251217053014
-  - @lssm/example.versioned-knowledge-base@0.0.0-canary-20251217053014
-  - @lssm/lib.contracts@0.0.0-canary-20251217053014
-  - @lssm/lib.feature-flags@0.0.0-canary-20251217053014
-  - @lssm/lib.files@0.0.0-canary-20251217053014
-  - @lssm/lib.identity-rbac@0.0.0-canary-20251217053014
-  - @lssm/lib.jobs@0.0.0-canary-20251217053014
-  - @lssm/lib.metering@0.0.0-canary-20251217053014
-  - @lssm/module.audit-trail@0.0.0-canary-20251217053014
-  - @lssm/module.learning-journey@0.0.0-canary-20251217053014
-  - @lssm/module.notifications@0.0.0-canary-20251217053014
+  - @lssm/example.kb-update-pipeline@0.0.0-canary-20251217060433
+  - @lssm/example.learning-patterns@0.0.0-canary-20251217060433
+  - @lssm/example.locale-jurisdiction-gate@0.0.0-canary-20251217060433
+  - @lssm/example.versioned-knowledge-base@0.0.0-canary-20251217060433
+  - @lssm/lib.contracts@0.0.0-canary-20251217060433
+  - @lssm/lib.feature-flags@0.0.0-canary-20251217060433
+  - @lssm/lib.files@0.0.0-canary-20251217060433
+  - @lssm/lib.identity-rbac@0.0.0-canary-20251217060433
+  - @lssm/lib.jobs@0.0.0-canary-20251217060433
+  - @lssm/lib.metering@0.0.0-canary-20251217060433
+  - @lssm/module.audit-trail@0.0.0-canary-20251217060433
+  - @lssm/module.learning-journey@0.0.0-canary-20251217060433
+  - @lssm/module.notifications@0.0.0-canary-20251217060433

package/dist/docs/index.d.ts

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

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

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

package/dist/example.d.ts

@@ -0,0 +1,34 @@
+//#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: "@lssm/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 };

package/dist/feature.d.ts

@@ -0,0 +1,6 @@
+import { FeatureModuleSpec } from "@lssm/lib.contracts";
+
+//#region src/feature.d.ts
+declare const PolicySafeKnowledgeAssistantFeature: FeatureModuleSpec;
+//#endregion
+export { PolicySafeKnowledgeAssistantFeature };

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import example from "./example.js";
+import { PolicySafeKnowledgeAssistantFeature } from "./feature.js";
+import { DEMO_FIXTURES } from "./seed/fixtures.js";
+import { AssistantAnswerIR, BuildAnswerInput, buildPolicySafeAnswer } from "./orchestrator/buildAnswer.js";
+export { AssistantAnswerIR, BuildAnswerInput, DEMO_FIXTURES, PolicySafeKnowledgeAssistantFeature, buildPolicySafeAnswer, example };

package/dist/orchestrator/buildAnswer.d.ts

@@ -0,0 +1,52 @@
+//#region src/orchestrator/buildAnswer.d.ts
+type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
+interface AssistantAnswerIR {
+  locale: string;
+  jurisdiction: string;
+  allowedScope: AllowedScope;
+  sections: {
+    heading: string;
+    body: string;
+  }[];
+  citations: {
+    kbSnapshotId: string;
+    sourceType: string;
+    sourceId: string;
+    title?: string;
+    excerpt?: string;
+  }[];
+  disclaimers?: string[];
+  riskFlags?: string[];
+  refused?: boolean;
+  refusalReason?: string;
+}
+interface BuildAnswerInput {
+  envelope: {
+    traceId: string;
+    locale: string;
+    kbSnapshotId: string;
+    allowedScope: AllowedScope;
+    regulatoryContext: {
+      jurisdiction: string;
+    };
+  };
+  question: string;
+  kbSearch: (input: {
+    snapshotId: string;
+    jurisdiction: string;
+    query: string;
+  }) => Promise<{
+    items: {
+      ruleVersionId: string;
+      excerpt?: string;
+    }[];
+  }>;
+}
+/**
+ * Build a policy-safe assistant answer derived from KB search results.
+ *
+ * Deterministic: no LLM calls; if search yields no results, it refuses.
+ */
+declare function buildPolicySafeAnswer(input: BuildAnswerInput): Promise<AssistantAnswerIR>;
+//#endregion
+export { AssistantAnswerIR, BuildAnswerInput, buildPolicySafeAnswer };

package/dist/seed/fixtures.d.ts

@@ -0,0 +1,34 @@
+//#region src/seed/fixtures.d.ts
+declare const DEMO_FIXTURES: {
+  readonly jurisdictions: readonly ["EU", "FR"];
+  readonly locales: readonly ["en-GB", "fr-FR"];
+  readonly demoOrgId: "org_demo";
+  readonly demoUserId: "user_demo";
+  readonly sources: {
+    readonly EU_SOURCE_1: {
+      readonly jurisdiction: "EU";
+      readonly authority: "DemoAuthority";
+      readonly title: "EU Demo Source v1";
+      readonly fetchedAt: Date;
+      readonly hash: "hash_eu_v1";
+      readonly fileId: "file_eu_v1";
+    };
+    readonly EU_SOURCE_2: {
+      readonly jurisdiction: "EU";
+      readonly authority: "DemoAuthority";
+      readonly title: "EU Demo Source v2";
+      readonly fetchedAt: Date;
+      readonly hash: "hash_eu_v2";
+      readonly fileId: "file_eu_v2";
+    };
+  };
+  readonly rules: {
+    readonly EU_RULE_TAX: {
+      readonly id: "rule_eu_tax";
+      readonly jurisdiction: "EU";
+      readonly topicKey: "tax_reporting";
+    };
+  };
+};
+//#endregion
+export { DEMO_FIXTURES };

package/dist/seed/index.d.ts

@@ -0,0 +1,2 @@
+import { DEMO_FIXTURES } from "./fixtures.js";
+export { DEMO_FIXTURES };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.policy-safe-knowledge-assistant",
-  "version": "0.0.0-canary-20251217054315",
+  "version": "0.0.0-canary-20251217060433",
   "description": "All-in-one template example: policy-safe knowledge assistant with locale/jurisdiction gating, versioned KB snapshots, HITL update pipeline, and learning hub.",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,23 +31,23 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@lssm/example.locale-jurisdiction-gate": "0.0.0-canary-20251217054315",
-    "@lssm/example.versioned-knowledge-base": "0.0.0-canary-20251217054315",
-    "@lssm/example.kb-update-pipeline": "0.0.0-canary-20251217054315",
-    "@lssm/example.learning-patterns": "0.0.0-canary-20251217054315",
-    "@lssm/lib.contracts": "0.0.0-canary-20251217054315",
-    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217054315",
-    "@lssm/lib.jobs": "0.0.0-canary-20251217054315",
-    "@lssm/lib.feature-flags": "0.0.0-canary-20251217054315",
-    "@lssm/lib.files": "0.0.0-canary-20251217054315",
-    "@lssm/lib.metering": "0.0.0-canary-20251217054315",
-    "@lssm/module.audit-trail": "0.0.0-canary-20251217054315",
-    "@lssm/module.notifications": "0.0.0-canary-20251217054315",
-    "@lssm/module.learning-journey": "0.0.0-canary-20251217054315"
+    "@lssm/example.locale-jurisdiction-gate": "0.0.0-canary-20251217060433",
+    "@lssm/example.versioned-knowledge-base": "0.0.0-canary-20251217060433",
+    "@lssm/example.kb-update-pipeline": "0.0.0-canary-20251217060433",
+    "@lssm/example.learning-patterns": "0.0.0-canary-20251217060433",
+    "@lssm/lib.contracts": "0.0.0-canary-20251217060433",
+    "@lssm/lib.identity-rbac": "0.0.0-canary-20251217060433",
+    "@lssm/lib.jobs": "0.0.0-canary-20251217060433",
+    "@lssm/lib.feature-flags": "0.0.0-canary-20251217060433",
+    "@lssm/lib.files": "0.0.0-canary-20251217060433",
+    "@lssm/lib.metering": "0.0.0-canary-20251217060433",
+    "@lssm/module.audit-trail": "0.0.0-canary-20251217060433",
+    "@lssm/module.notifications": "0.0.0-canary-20251217060433",
+    "@lssm/module.learning-journey": "0.0.0-canary-20251217060433"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217054315",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217054315",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217060433",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217060433",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },