@lssm/example.policy-safe-knowledge-assistant 0.0.0-canary-20251213172311 → 0.0.0-canary-20251215220103

package/.turbo/turbo-build.log

@@ -1,6 +1,6 @@
 $ bun build:bundle && bun build:types
 $ tsdown
-ℹ tsdown v0.17.0 powered by rolldown v1.0.0-beta.53
+ℹ tsdown v0.17.4 powered by rolldown v1.0.0-beta.53
 ℹ 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
@@ -15,5 +15,5 @@ $ tsdown
 ℹ dist/seed/index.js                                     0.07 kB │ gzip: 0.08 kB
 ℹ dist/docs/index.js                                     0.05 kB │ gzip: 0.07 kB
 ℹ 8 files, total: 6.60 kB
-✔ Build complete in 57ms
+✔ Build complete in 65ms
 $ tsc --noEmit

package/CHANGELOG.md

@@ -1,20 +1,20 @@
 # @lssm/example.policy-safe-knowledge-assistant
 
-## 0.0.0-canary-20251213172311
+## 0.0.0-canary-20251215220103
 
 ### Patch Changes
 
 - Updated dependencies [3086383]
-  - @lssm/lib.contracts@0.0.0-canary-20251213172311
-  - @lssm/lib.jobs@0.0.0-canary-20251213172311
-  - @lssm/example.kb-update-pipeline@0.0.0-canary-20251213172311
-  - @lssm/example.locale-jurisdiction-gate@0.0.0-canary-20251213172311
-  - @lssm/example.versioned-knowledge-base@0.0.0-canary-20251213172311
-  - @lssm/lib.feature-flags@0.0.0-canary-20251213172311
-  - @lssm/lib.files@0.0.0-canary-20251213172311
-  - @lssm/lib.identity-rbac@0.0.0-canary-20251213172311
-  - @lssm/lib.metering@0.0.0-canary-20251213172311
-  - @lssm/module.audit-trail@0.0.0-canary-20251213172311
-  - @lssm/module.learning-journey@0.0.0-canary-20251213172311
-  - @lssm/module.notifications@0.0.0-canary-20251213172311
-  - @lssm/example.learning-patterns@0.0.0-canary-20251213172311
+  - @lssm/lib.contracts@0.0.0-canary-20251215220103
+  - @lssm/lib.jobs@0.0.0-canary-20251215220103
+  - @lssm/example.kb-update-pipeline@0.0.0-canary-20251215220103
+  - @lssm/example.locale-jurisdiction-gate@0.0.0-canary-20251215220103
+  - @lssm/example.versioned-knowledge-base@0.0.0-canary-20251215220103
+  - @lssm/lib.feature-flags@0.0.0-canary-20251215220103
+  - @lssm/lib.files@0.0.0-canary-20251215220103
+  - @lssm/lib.identity-rbac@0.0.0-canary-20251215220103
+  - @lssm/lib.metering@0.0.0-canary-20251215220103
+  - @lssm/module.audit-trail@0.0.0-canary-20251215220103
+  - @lssm/module.learning-journey@0.0.0-canary-20251215220103
+  - @lssm/module.notifications@0.0.0-canary-20251215220103
+  - @lssm/example.learning-patterns@0.0.0-canary-20251215220103

package/IMPLEMENTATION_SKETCH.md

@@ -30,3 +30,4 @@ The runnable **sandbox UI/runtime** lives in `@lssm/bundle.contractspec-studio`
 - **Storage**: in tests, in-memory stores; in sandbox, browser SQLite + IndexedDB.
 
 
+

package/README.md

@@ -10,3 +10,4 @@ All-in-one template example demonstrating a **policy-safe knowledge assistant**
 
 This package is the **spec-first** source of truth. The sandbox UI/runtime integration lives in `@lssm/bundle.contractspec-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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.policy-safe-knowledge-assistant",
-  "version": "0.0.0-canary-20251213172311",
+  "version": "0.0.0-canary-20251215220103",
   "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",
@@ -46,7 +46,7 @@
   "devDependencies": {
     "@lssm/tool.tsdown": "workspace:*",
     "@lssm/tool.typescript": "workspace:*",
-    "tsdown": "^0.17.0",
+    "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },
   "publishConfig": {

package/src/docs/index.ts

@@ -1,3 +1 @@
 import './policy-safe-knowledge-assistant.docblock';
-
-

package/src/docs/policy-safe-knowledge-assistant.docblock.ts

@@ -26,5 +26,3 @@ const docBlocks: DocBlock[] = [
 ];
 
 registerDocBlocks(docBlocks);
-
-

package/src/example.ts

@@ -17,12 +17,13 @@ const example = {
   },
   surfaces: {
     templates: true,
-    sandbox: { enabled: true, modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'] },
+    sandbox: {
+      enabled: true,
+      modes: ['playground', 'specs', 'builder', 'markdown', 'evolution'],
+    },
     studio: { enabled: true, installable: true },
     mcp: { enabled: true },
   },
 } as const;
 
 export default example;
-
-

package/src/index.ts

@@ -7,5 +7,3 @@ export * from './orchestrator/buildAnswer';
 export { default as example } from './example';
 
 import './docs';
-
-

package/src/integration.test.ts

@@ -1,7 +1,13 @@
 import { describe, expect, it } from 'bun:test';
 
-import { createMemoryKbHandlers, createMemoryKbStore } from '@lssm/example.versioned-knowledge-base/handlers/memory.handlers';
-import { createPipelineMemoryHandlers, createPipelineMemoryStore } from '@lssm/example.kb-update-pipeline/handlers/memory.handlers';
+import {
+  createMemoryKbHandlers,
+  createMemoryKbStore,
+} from '@lssm/example.versioned-knowledge-base/handlers/memory.handlers';
+import {
+  createPipelineMemoryHandlers,
+  createPipelineMemoryStore,
+} from '@lssm/example.kb-update-pipeline/handlers/memory.handlers';
 
 import { buildPolicySafeAnswer } from './orchestrator/buildAnswer';
 import { DEMO_FIXTURES } from './seed/fixtures';
@@ -23,7 +29,10 @@ describe('@lssm/example.policy-safe-knowledge-assistant integration', () => {
       content: 'EU: Reporting obligations v1',
       sourceRefs: [{ sourceDocumentId: 'src_eu_v1', excerpt: 'v1 excerpt' }],
     });
-    await kb.approveRuleVersion({ ruleVersionId: rv1.id, approver: 'expert_1' });
+    await kb.approveRuleVersion({
+      ruleVersionId: rv1.id,
+      approver: 'expert_1',
+    });
     const snap1 = await kb.publishSnapshot({
       jurisdiction: 'EU',
       asOfDate: new Date('2026-01-01T00:00:00.000Z'),
@@ -54,7 +63,9 @@ describe('@lssm/example.policy-safe-knowledge-assistant integration', () => {
       diffSummary: 'Updated obligations',
       riskLevel: 'high',
     });
-    const review = await pipeline.createReviewTask({ changeCandidateId: 'cand_1' });
+    const review = await pipeline.createReviewTask({
+      changeCandidateId: 'cand_1',
+    });
     await pipeline.submitDecision({
       reviewTaskId: review.id,
       decision: 'approve',
@@ -68,7 +79,10 @@ describe('@lssm/example.policy-safe-knowledge-assistant integration', () => {
       content: 'EU: Reporting obligations v2 (updated)',
       sourceRefs: [{ sourceDocumentId: 'src_eu_v2', excerpt: 'v2 excerpt' }],
     });
-    await kb.approveRuleVersion({ ruleVersionId: rv2.id, approver: 'expert_2' });
+    await kb.approveRuleVersion({
+      ruleVersionId: rv2.id,
+      approver: 'expert_2',
+    });
 
     // Link pipeline proposal to the actual KB rule version id, then mark it approved
     await pipeline.proposeRulePatch({
@@ -92,5 +106,3 @@ describe('@lssm/example.policy-safe-knowledge-assistant integration', () => {
     expect(a2.citations[0]?.kbSnapshotId).toBe(snap2.id);
   });
 });
-
-

package/src/orchestrator/buildAnswer.ts

@@ -6,23 +6,23 @@ import {
 
 type AllowedScope = 'education_only' | 'generic_info' | 'escalation_required';
 
-export type AssistantAnswerIR = {
+export interface AssistantAnswerIR {
   locale: string;
   jurisdiction: string;
   allowedScope: AllowedScope;
-  sections: Array<{ heading: string; body: string }>;
-  citations: Array<{
+  sections: { heading: string; body: string }[];
+  citations: {
     kbSnapshotId: string;
     sourceType: string;
     sourceId: string;
     title?: string;
     excerpt?: string;
-  }>;
+  }[];
   disclaimers?: string[];
   riskFlags?: string[];
   refused?: boolean;
   refusalReason?: string;
-};
+}
 
 export interface BuildAnswerInput {
   envelope: {
@@ -37,7 +37,7 @@ export interface BuildAnswerInput {
     snapshotId: string;
     jurisdiction: string;
     query: string;
-  }) => Promise<{ items: Array<{ ruleVersionId: string; excerpt?: string }> }>;
+  }) => Promise<{ items: { ruleVersionId: string; excerpt?: string }[] }>;
 }
 
 /**
@@ -120,5 +120,3 @@ export async function buildPolicySafeAnswer(
 
   return draft;
 }
-
-

package/src/seed/fixtures.ts

@@ -29,5 +29,3 @@ export const DEMO_FIXTURES = {
     },
   },
 } as const;
-
-

package/src/seed/index.ts

@@ -1,3 +1 @@
 export * from './fixtures';
-
-

package/tsconfig.json

@@ -9,3 +9,4 @@
 }
 
 
+