@lssm/example.kb-update-pipeline 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/kb-update-pipeline/tsdown.config.js 
 ℹ entry: src/events.ts, src/example.ts, src/feature.ts, src/index.ts, src/contracts/index.ts, src/contracts/pipeline.ts, src/docs/index.ts, src/docs/kb-update-pipeline.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.17 kB │ gzip: 0.11 kB
 ℹ dist/docs/index.js                        0.04 kB │ gzip: 0.06 kB
 ℹ 12 files, total: 13.72 kB
-✔ Build complete in 53ms
+✔ Build complete in 80ms
 $ tsc --noEmit

package/CHANGELOG.md

@@ -1,11 +1,11 @@
 # @lssm/example.kb-update-pipeline
 
-## 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.identity-rbac@0.0.0-canary-20251213172311
-  - @lssm/module.notifications@0.0.0-canary-20251213172311
+  - @lssm/lib.contracts@0.0.0-canary-20251215220103
+  - @lssm/lib.schema@0.0.0-canary-20251215220103
+  - @lssm/lib.identity-rbac@0.0.0-canary-20251215220103
+  - @lssm/module.notifications@0.0.0-canary-20251215220103

package/README.md

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.kb-update-pipeline",
-  "version": "0.0.0-canary-20251213172311",
+  "version": "0.0.0-canary-20251215220103",
   "description": "Example: KB update automation pipeline with HITL review and auditability.",
   "type": "module",
   "main": "./dist/index.js",
@@ -42,7 +42,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 './pipeline';
-
-

package/src/contracts/pipeline.ts

@@ -1,7 +1,11 @@
 import { defineCommand } from '@lssm/lib.contracts';
 import { ScalarTypeEnum, defineSchemaModel } from '@lssm/lib.schema';
 
-import { ChangeCandidateModel, ReviewDecisionEnum, ReviewTaskModel } from '../entities/models';
+import {
+  ChangeCandidateModel,
+  ReviewDecisionEnum,
+  ReviewTaskModel,
+} from '../entities/models';
 
 const RunWatchInput = defineSchemaModel({
   name: 'KbPipelineRunWatchInput',
@@ -15,7 +19,11 @@ const RunWatchOutput = defineSchemaModel({
   name: 'KbPipelineRunWatchOutput',
   description: 'Output containing detected changes.',
   fields: {
-    candidates: { type: ChangeCandidateModel, isArray: true, isOptional: false },
+    candidates: {
+      type: ChangeCandidateModel,
+      isArray: true,
+      isOptional: false,
+    },
   },
 });
 
@@ -23,7 +31,10 @@ const CreateReviewTaskInput = defineSchemaModel({
   name: 'KbPipelineCreateReviewTaskInput',
   description: 'Create a review task for a change candidate.',
   fields: {
-    changeCandidateId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    changeCandidateId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
   },
 });
 
@@ -34,13 +45,17 @@ const SubmitDecisionInput = defineSchemaModel({
     reviewTaskId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     decision: { type: ReviewDecisionEnum, isOptional: false },
     decidedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    decidedByRole: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    decidedByRole: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
   },
 });
 
 const PublishIfReadyInput = defineSchemaModel({
   name: 'KbPipelinePublishIfReadyInput',
-  description: 'Publish snapshot if approvals are satisfied for a jurisdiction.',
+  description:
+    'Publish snapshot if approvals are satisfied for a jurisdiction.',
   fields: {
     jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
   },
@@ -142,5 +157,3 @@ export const KbPipelinePublishIfReadyContract = defineCommand({
   },
   policy: { auth: 'user' },
 });
-
-

package/src/docs/index.ts

@@ -1,3 +1 @@
 import './kb-update-pipeline.docblock';
-
-

package/src/docs/kb-update-pipeline.docblock.ts

@@ -17,7 +17,8 @@ const docBlocks: DocBlock[] = [
   {
     id: 'docs.examples.kb-update-pipeline.reference',
     title: 'KB Update Pipeline — Reference',
-    summary: 'Entities, contracts, and events for the KB update pipeline example.',
+    summary:
+      'Entities, contracts, and events for the KB update pipeline example.',
     kind: 'reference',
     visibility: 'public',
     route: '/docs/examples/kb-update-pipeline',
@@ -27,5 +28,3 @@ const docBlocks: DocBlock[] = [
 ];
 
 registerDocBlocks(docBlocks);
-
-

package/src/entities/index.ts

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

package/src/entities/models.ts

@@ -1,4 +1,8 @@
-import { ScalarTypeEnum, defineEnum, defineSchemaModel } from '@lssm/lib.schema';
+import {
+  ScalarTypeEnum,
+  defineEnum,
+  defineSchemaModel,
+} from '@lssm/lib.schema';
 
 export const ChangeRiskLevelEnum = defineEnum('ChangeRiskLevel', [
   'low',
@@ -21,7 +25,10 @@ export const ChangeCandidateModel = defineSchemaModel({
   description: 'Candidate change detected in a source document.',
   fields: {
     id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    sourceDocumentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    sourceDocumentId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     detectedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },
     diffSummary: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     riskLevel: { type: ChangeRiskLevelEnum, isOptional: false },
@@ -33,7 +40,10 @@ export const ReviewTaskModel = defineSchemaModel({
   description: 'Human verification task for a change candidate.',
   fields: {
     id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    changeCandidateId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    changeCandidateId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }, // open|decided
     assignedRole: { type: ReviewAssignedRoleEnum, isOptional: false },
     decision: { type: ReviewDecisionEnum, isOptional: true },
@@ -41,5 +51,3 @@ export const ReviewTaskModel = defineSchemaModel({
     decidedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
   },
 });
-
-

package/src/events.ts

@@ -5,8 +5,14 @@ const KbChangeDetectedPayload = defineSchemaModel({
   name: 'KbChangeDetectedPayload',
   description: 'Emitted when a source change is detected.',
   fields: {
-    changeCandidateId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    sourceDocumentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    changeCandidateId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
+    sourceDocumentId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     riskLevel: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
   },
 });
@@ -22,7 +28,10 @@ const KbChangeSummarizedPayload = defineSchemaModel({
   name: 'KbChangeSummarizedPayload',
   description: 'Emitted when a change summary is produced.',
   fields: {
-    changeCandidateId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    changeCandidateId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     summary: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
     riskLevel: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
   },
@@ -39,7 +48,10 @@ const KbPatchProposedPayload = defineSchemaModel({
   name: 'KbPatchProposedPayload',
   description: 'Emitted when draft rule patches are proposed.',
   fields: {
-    changeCandidateId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    changeCandidateId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     proposedRuleVersionIds: {
       type: ScalarTypeEnum.String_unsecure(),
       isArray: true,
@@ -60,7 +72,10 @@ const KbReviewRequestedPayload = defineSchemaModel({
   description: 'Emitted when a review is requested.',
   fields: {
     reviewTaskId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    changeCandidateId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+    changeCandidateId: {
+      type: ScalarTypeEnum.String_unsecure(),
+      isOptional: false,
+    },
     assignedRole: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
   },
 });
@@ -88,5 +103,3 @@ export const KbReviewDecidedEvent = defineEvent({
   description: 'KB review decided.',
   payload: KbReviewDecidedPayload,
 });
-
-

package/src/example.ts

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

package/src/feature.ts

@@ -35,5 +35,3 @@ export const KbUpdatePipelineFeature: FeatureModuleSpec = {
     ],
   },
 };
-
-

package/src/handlers/index.ts

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

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

@@ -1,6 +1,9 @@
 import { describe, expect, it } from 'bun:test';
 
-import { createPipelineMemoryHandlers, createPipelineMemoryStore } from './memory.handlers';
+import {
+  createPipelineMemoryHandlers,
+  createPipelineMemoryStore,
+} from './memory.handlers';
 
 describe('@lssm/example.kb-update-pipeline memory handlers', () => {
   it('high-risk change cannot be approved by curator role', async () => {
@@ -76,5 +79,3 @@ describe('@lssm/example.kb-update-pipeline memory handlers', () => {
     ).rejects.toThrow('NOT_READY');
   });
 });
-
-

package/src/handlers/memory.handlers.ts

@@ -1,12 +1,12 @@
-type ChangeCandidate = {
+interface ChangeCandidate {
   id: string;
   sourceDocumentId: string;
   detectedAt: Date;
   diffSummary: string;
   riskLevel: 'low' | 'medium' | 'high';
-};
+}
 
-type ReviewTask = {
+interface ReviewTask {
   id: string;
   changeCandidateId: string;
   status: 'open' | 'decided';
@@ -14,20 +14,20 @@ type ReviewTask = {
   decision?: 'approve' | 'reject';
   decidedAt?: Date;
   decidedBy?: string;
-};
+}
 
 export interface PipelineMemoryStore {
   candidates: Map<string, ChangeCandidate>;
   reviewTasks: Map<string, ReviewTask>;
   proposedRuleVersionIdsByCandidate: Map<string, string[]>;
   approvedRuleVersionIds: Set<string>;
-  notifications: Array<{
+  notifications: {
     kind: 'kb.review.requested';
     reviewTaskId: string;
     changeCandidateId: string;
     assignedRole: 'curator' | 'expert';
     createdAt: Date;
-  }>;
+  }[];
 }
 
 export function createPipelineMemoryStore(): PipelineMemoryStore {
@@ -45,20 +45,26 @@ function stableId(prefix: string, value: string): string {
 }
 
 export interface PipelineMemoryHandlers {
-  runWatch(input: { jurisdiction: string }): Promise<{ candidates: ChangeCandidate[] }>;
+  runWatch(input: {
+    jurisdiction: string;
+  }): Promise<{ candidates: ChangeCandidate[] }>;
   createReviewTask(input: { changeCandidateId: string }): Promise<ReviewTask>;
   proposeRulePatch(input: {
     changeCandidateId: string;
     proposedRuleVersionIds: string[];
   }): Promise<{ proposedRuleVersionIds: string[] }>;
-  markRuleVersionApproved(input: { ruleVersionId: string }): Promise<{ ruleVersionId: string }>;
+  markRuleVersionApproved(input: {
+    ruleVersionId: string;
+  }): Promise<{ ruleVersionId: string }>;
   submitDecision(input: {
     reviewTaskId: string;
     decision: 'approve' | 'reject';
     decidedBy: string;
     decidedByRole: 'curator' | 'expert';
   }): Promise<ReviewTask>;
-  publishIfReady(input: { jurisdiction: string }): Promise<{ published: boolean; reason?: string }>;
+  publishIfReady(input: {
+    jurisdiction: string;
+  }): Promise<{ published: boolean; reason?: string }>;
 }
 
 export function createPipelineMemoryHandlers(
@@ -104,10 +110,9 @@ export function createPipelineMemoryHandlers(
     if (!store.candidates.has(input.changeCandidateId)) {
       throw new Error('CHANGE_CANDIDATE_NOT_FOUND');
     }
-    store.proposedRuleVersionIdsByCandidate.set(
-      input.changeCandidateId,
-      [...input.proposedRuleVersionIds]
-    );
+    store.proposedRuleVersionIdsByCandidate.set(input.changeCandidateId, [
+      ...input.proposedRuleVersionIds,
+    ]);
     return { proposedRuleVersionIds: [...input.proposedRuleVersionIds] };
   }
 
@@ -158,8 +163,11 @@ export function createPipelineMemoryHandlers(
     for (const task of store.reviewTasks.values()) {
       if (task.decision !== 'approve') continue;
       const proposed =
-        store.proposedRuleVersionIdsByCandidate.get(task.changeCandidateId) ?? [];
-      const unapproved = proposed.filter((id) => !store.approvedRuleVersionIds.has(id));
+        store.proposedRuleVersionIdsByCandidate.get(task.changeCandidateId) ??
+        [];
+      const unapproved = proposed.filter(
+        (id) => !store.approvedRuleVersionIds.has(id)
+      );
       if (unapproved.length) {
         throw new Error('NOT_READY');
       }
@@ -176,5 +184,3 @@ export function createPipelineMemoryHandlers(
     publishIfReady,
   };
 }
-
-

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 @@
 }
 
 
+