@lssm/example.versioned-knowledge-base 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/versioned-knowledge-base/tsdown.config.js 
 ℹ entry: src/events.ts, src/example.ts, src/feature.ts, src/index.ts, src/contracts/index.ts, src/contracts/kb.ts, src/docs/index.ts, src/docs/versioned-knowledge-base.docblock.ts, src/entities/index.ts, src/entities/models.ts, src/handlers/index.ts, src/handlers/memory.handlers.ts
 ℹ target: esnext
@@ -19,5 +19,5 @@ $ tsdown
 ℹ dist/handlers/index.js                          0.15 kB │ gzip: 0.10 kB
 ℹ dist/docs/index.js                              0.05 kB │ gzip: 0.07 kB
 ℹ 12 files, total: 15.02 kB
-✔ Build complete in 66ms
+✔ Build complete in 77ms
 $ tsc --noEmit

package/CHANGELOG.md

@@ -1,9 +1,9 @@
 # @lssm/example.versioned-knowledge-base
 
-## 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.schema@0.0.0-canary-20251213172311
+  - @lssm/lib.contracts@0.0.0-canary-20251215220103
+  - @lssm/lib.schema@0.0.0-canary-20251215220103

package/README.md

@@ -22,3 +22,4 @@ bun test
 ```
 
 
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.versioned-knowledge-base",
-  "version": "0.0.0-canary-20251213172311",
+  "version": "0.0.0-canary-20251215220103",
   "description": "Example: curated, versioned knowledge base with immutable sources, rule versions, and published snapshots.",
   "type": "module",
   "main": "./dist/index.js",
@@ -40,7 +40,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/contracts/index.ts

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

package/src/contracts/kb.ts

@@ -35,7 +35,10 @@ const ApproveRuleVersionInput = defineSchemaModel({
   name: 'KbApproveRuleVersionInput',
   description: 'Approve a rule version (human verification).',
   fields: {
-    ruleVersionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    ruleVersionId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     approver: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
   },
 });
@@ -63,7 +66,10 @@ const SearchKbResultItem = defineSchemaModel({
   name: 'KbSearchResultItem',
   description: 'Search result referencing a specific rule version.',
   fields: {
-    ruleVersionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    ruleVersionId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
   },
 });
@@ -153,7 +159,8 @@ export const KbPublishSnapshotContract = defineCommand({
     tags: ['knowledge', 'snapshots', 'publishing'],
     description: 'Publish a KB snapshot for a jurisdiction.',
     goal: 'Create a stable snapshot that assistant answers can cite.',
-    context: 'Publishing happens after approvals; snapshot is referenced by answers.',
+    context:
+      'Publishing happens after approvals; snapshot is referenced by answers.',
   },
   io: {
     input: PublishSnapshotInput,
@@ -187,5 +194,3 @@ export const KbSearchContract = defineQuery({
   },
   policy: { auth: 'user' },
 });
-
-

package/src/docs/index.ts

@@ -1,3 +1 @@
 import './versioned-knowledge-base.docblock';
-
-

package/src/docs/versioned-knowledge-base.docblock.ts

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

package/src/entities/index.ts

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

package/src/entities/models.ts

@@ -2,7 +2,8 @@ import { ScalarTypeEnum, defineSchemaModel } from '@lssm/lib.schema';
 
 export const SourceDocumentModel = defineSchemaModel({
   name: 'SourceDocument',
-  description: 'Immutable raw source document metadata referencing a stored file.',
+  description:
+    'Immutable raw source document metadata referencing a stored file.',
   fields: {
     id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
@@ -18,14 +19,18 @@ export const SourceRefModel = defineSchemaModel({
   name: 'SourceRef',
   description: 'Reference to a source document used to justify a rule version.',
   fields: {
-    sourceDocumentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    sourceDocumentId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     excerpt: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
   },
 });
 
 export const RuleModel = defineSchemaModel({
   name: 'Rule',
-  description: 'Curated rule (stable identity) with topic + jurisdiction scope.',
+  description:
+    'Curated rule (stable identity) with topic + jurisdiction scope.',
   fields: {
     id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
@@ -35,7 +40,8 @@ export const RuleModel = defineSchemaModel({
 
 export const RuleVersionModel = defineSchemaModel({
   name: 'RuleVersion',
-  description: 'A versioned rule content with source references and approval status.',
+  description:
+    'A versioned rule content with source references and approval status.',
   fields: {
     id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
@@ -53,7 +59,8 @@ export const RuleVersionModel = defineSchemaModel({
 
 export const KBSnapshotModel = defineSchemaModel({
   name: 'KBSnapshot',
-  description: 'Published KB snapshot (as-of) referencing approved rule versions.',
+  description:
+    'Published KB snapshot (as-of) referencing approved rule versions.',
   fields: {
     id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
@@ -66,5 +73,3 @@ export const KBSnapshotModel = defineSchemaModel({
     publishedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
   },
 });
-
-

package/src/events.ts

@@ -5,7 +5,10 @@ const KbSourceIngestedPayload = defineSchemaModel({
   name: 'KbSourceIngestedPayload',
   description: 'Emitted when a source document is ingested.',
   fields: {
-    sourceDocumentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    sourceDocumentId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     hash: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
   },
@@ -22,7 +25,10 @@ const KbRuleVersionCreatedPayload = defineSchemaModel({
   name: 'KbRuleVersionCreatedPayload',
   description: 'Emitted when a rule version draft is created.',
   fields: {
-    ruleVersionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    ruleVersionId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     ruleId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
@@ -40,7 +46,10 @@ const KbRuleVersionApprovedPayload = defineSchemaModel({
   name: 'KbRuleVersionApprovedPayload',
   description: 'Emitted when a rule version is approved.',
   fields: {
-    ruleVersionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    ruleVersionId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     approver: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
   },
 });
@@ -58,7 +67,10 @@ const KbSnapshotPublishedPayload = defineSchemaModel({
   fields: {
     snapshotId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    includedRuleVersionsCount: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },
+    includedRuleVersionsCount: {
+      type: ScalarTypeEnum.Int_unsecure(),
+      isOptional: false,
+    },
   },
 });
 
@@ -68,5 +80,3 @@ export const KbSnapshotPublishedEvent = defineEvent({
   description: 'KB snapshot published.',
   payload: KbSnapshotPublishedPayload,
 });
-
-

package/src/example.ts

@@ -25,5 +25,3 @@ const example = {
 } as const;
 
 export default example;
-
-

package/src/feature.ts

@@ -31,5 +31,3 @@ export const VersionedKnowledgeBaseFeature: FeatureModuleSpec = {
     requires: [{ key: 'knowledge', version: 1 }],
   },
 };
-
-

package/src/handlers/index.ts

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

package/src/handlers/memory.handlers.test.ts

@@ -51,7 +51,11 @@ describe('@lssm/example.versioned-knowledge-base memory handlers', () => {
     const store = createMemoryKbStore();
     const kb = createMemoryKbHandlers(store);
 
-    await kb.createRule({ id: 'rule_eu', jurisdiction: 'EU', topicKey: 'topic' });
+    await kb.createRule({
+      id: 'rule_eu',
+      jurisdiction: 'EU',
+      topicKey: 'topic',
+    });
     const euDraft = await kb.upsertRuleVersion({
       ruleId: 'rule_eu',
       content: 'This is about reporting obligations',
@@ -75,5 +79,3 @@ describe('@lssm/example.versioned-knowledge-base memory handlers', () => {
     expect(ok.items.map((i) => i.ruleVersionId)).toEqual([euDraft.id]);
   });
 });
-
-

package/src/handlers/memory.handlers.ts

@@ -1,5 +1,8 @@
-type SourceRef = { sourceDocumentId: string; excerpt?: string };
-type SourceDocument = {
+interface SourceRef {
+  sourceDocumentId: string;
+  excerpt?: string;
+}
+interface SourceDocument {
   id: string;
   jurisdiction: string;
   authority: string;
@@ -7,9 +10,13 @@ type SourceDocument = {
   fetchedAt: Date;
   hash: string;
   fileId: string;
-};
-type Rule = { id: string; jurisdiction: string; topicKey: string };
-type RuleVersion = {
+}
+interface Rule {
+  id: string;
+  jurisdiction: string;
+  topicKey: string;
+}
+interface RuleVersion {
   id: string;
   ruleId: string;
   jurisdiction: string;
@@ -21,14 +28,14 @@ type RuleVersion = {
   approvedBy?: string;
   approvedAt?: Date;
   createdAt: Date;
-};
-type KBSnapshot = {
+}
+interface KBSnapshot {
   id: string;
   jurisdiction: string;
   asOfDate: Date;
   includedRuleVersionIds: string[];
   publishedAt: Date;
-};
+}
 
 export interface MemoryKbStore {
   sources: Map<string, SourceDocument>;
@@ -68,7 +75,7 @@ export interface MemoryKbHandlers {
     snapshotId: string;
     jurisdiction: string;
     query: string;
-  }): Promise<{ items: Array<{ ruleVersionId: string; excerpt?: string }> }>;
+  }): Promise<{ items: { ruleVersionId: string; excerpt?: string }[] }>;
 }
 
 function stableId(prefix: string, value: string): string {
@@ -171,7 +178,7 @@ export function createMemoryKbHandlers(store: MemoryKbStore): MemoryKbHandlers {
     snapshotId: string;
     jurisdiction: string;
     query: string;
-  }): Promise<{ items: Array<{ ruleVersionId: string; excerpt?: string }> }> {
+  }): Promise<{ items: { ruleVersionId: string; excerpt?: string }[] }> {
     const snapshot = store.snapshots.get(input.snapshotId);
     if (!snapshot) {
       throw new Error('SNAPSHOT_NOT_FOUND');
@@ -180,7 +187,10 @@ export function createMemoryKbHandlers(store: MemoryKbStore): MemoryKbHandlers {
       throw new Error('JURISDICTION_MISMATCH');
     }
     const q = input.query.toLowerCase();
-    const tokens = q.split(/\s+/).map((t) => t.trim()).filter(Boolean);
+    const tokens = q
+      .split(/\s+/)
+      .map((t) => t.trim())
+      .filter(Boolean);
     const items = snapshot.includedRuleVersionIds
       .map((id) => store.ruleVersions.get(id))
       .filter((rv): rv is RuleVersion => Boolean(rv))
@@ -189,7 +199,10 @@ export function createMemoryKbHandlers(store: MemoryKbStore): MemoryKbHandlers {
         const hay = rv.content.toLowerCase();
         return tokens.every((token) => hay.includes(token));
       })
-      .map((rv) => ({ ruleVersionId: rv.id, excerpt: rv.content.slice(0, 120) }));
+      .map((rv) => ({
+        ruleVersionId: rv.id,
+        excerpt: rv.content.slice(0, 120),
+      }));
     return { items };
   }
 
@@ -202,5 +215,3 @@ export function createMemoryKbHandlers(store: MemoryKbStore): MemoryKbHandlers {
     search,
   };
 }
-
-

package/src/index.ts

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

package/tsconfig.json

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