@contractspec/example.kb-update-pipeline 3.7.6 → 3.7.10

package/src/events.ts

@@ -1,130 +1,130 @@
 import { defineEvent, StabilityEnum } from '@contractspec/lib.contracts-spec';
-import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';
+import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
 
 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,
-    },
-    riskLevel: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-  },
+	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,
+		},
+		riskLevel: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+	},
 });
 
 export const KbChangeDetectedEvent = defineEvent({
-  meta: {
-    key: 'kb.change.detected',
-    version: '1.0.0',
-    description: 'KB source change detected.',
-    stability: StabilityEnum.Experimental,
-    owners: [],
-    tags: [],
-  },
-  payload: KbChangeDetectedPayload,
+	meta: {
+		key: 'kb.change.detected',
+		version: '1.0.0',
+		description: 'KB source change detected.',
+		stability: StabilityEnum.Experimental,
+		owners: [],
+		tags: [],
+	},
+	payload: KbChangeDetectedPayload,
 });
 
 const KbChangeSummarizedPayload = defineSchemaModel({
-  name: 'KbChangeSummarizedPayload',
-  description: 'Emitted when a change summary is produced.',
-  fields: {
-    changeCandidateId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false,
-    },
-    summary: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    riskLevel: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-  },
+	name: 'KbChangeSummarizedPayload',
+	description: 'Emitted when a change summary is produced.',
+	fields: {
+		changeCandidateId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+		summary: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		riskLevel: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+	},
 });
 
 export const KbChangeSummarizedEvent = defineEvent({
-  meta: {
-    key: 'kb.change.summarized',
-    version: '1.0.0',
-    description: 'KB change summarized.',
-    stability: StabilityEnum.Experimental,
-    owners: [],
-    tags: [],
-  },
-  payload: KbChangeSummarizedPayload,
+	meta: {
+		key: 'kb.change.summarized',
+		version: '1.0.0',
+		description: 'KB change summarized.',
+		stability: StabilityEnum.Experimental,
+		owners: [],
+		tags: [],
+	},
+	payload: KbChangeSummarizedPayload,
 });
 
 const KbPatchProposedPayload = defineSchemaModel({
-  name: 'KbPatchProposedPayload',
-  description: 'Emitted when draft rule patches are proposed.',
-  fields: {
-    changeCandidateId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false,
-    },
-    proposedRuleVersionIds: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isArray: true,
-      isOptional: false,
-    },
-  },
+	name: 'KbPatchProposedPayload',
+	description: 'Emitted when draft rule patches are proposed.',
+	fields: {
+		changeCandidateId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+		proposedRuleVersionIds: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isArray: true,
+			isOptional: false,
+		},
+	},
 });
 
 export const KbPatchProposedEvent = defineEvent({
-  meta: {
-    key: 'kb.patch.proposed',
-    version: '1.0.0',
-    description: 'KB rule patch proposed (draft versions created).',
-    stability: StabilityEnum.Experimental,
-    owners: [],
-    tags: [],
-  },
-  payload: KbPatchProposedPayload,
+	meta: {
+		key: 'kb.patch.proposed',
+		version: '1.0.0',
+		description: 'KB rule patch proposed (draft versions created).',
+		stability: StabilityEnum.Experimental,
+		owners: [],
+		tags: [],
+	},
+	payload: KbPatchProposedPayload,
 });
 
 const KbReviewRequestedPayload = defineSchemaModel({
-  name: 'KbReviewRequestedPayload',
-  description: 'Emitted when a review is requested.',
-  fields: {
-    reviewTaskId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    changeCandidateId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false,
-    },
-    assignedRole: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-  },
+	name: 'KbReviewRequestedPayload',
+	description: 'Emitted when a review is requested.',
+	fields: {
+		reviewTaskId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		changeCandidateId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+		assignedRole: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+	},
 });
 
 export const KbReviewRequestedEvent = defineEvent({
-  meta: {
-    key: 'kb.review.requested',
-    version: '1.0.0',
-    description: 'KB review requested.',
-    stability: StabilityEnum.Experimental,
-    owners: [],
-    tags: [],
-  },
-  payload: KbReviewRequestedPayload,
+	meta: {
+		key: 'kb.review.requested',
+		version: '1.0.0',
+		description: 'KB review requested.',
+		stability: StabilityEnum.Experimental,
+		owners: [],
+		tags: [],
+	},
+	payload: KbReviewRequestedPayload,
 });
 
 const KbReviewDecidedPayload = defineSchemaModel({
-  name: 'KbReviewDecidedPayload',
-  description: 'Emitted when a review task is decided.',
-  fields: {
-    reviewTaskId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    decision: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    decidedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-  },
+	name: 'KbReviewDecidedPayload',
+	description: 'Emitted when a review task is decided.',
+	fields: {
+		reviewTaskId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		decision: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+		decidedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+	},
 });
 
 export const KbReviewDecidedEvent = defineEvent({
-  meta: {
-    key: 'kb.review.decided',
-    version: '1.0.0',
-    description: 'KB review decided.',
-    stability: StabilityEnum.Experimental,
-    owners: [],
-    tags: [],
-  },
-  payload: KbReviewDecidedPayload,
+	meta: {
+		key: 'kb.review.decided',
+		version: '1.0.0',
+		description: 'KB review decided.',
+		stability: StabilityEnum.Experimental,
+		owners: [],
+		tags: [],
+	},
+	payload: KbReviewDecidedPayload,
 });

package/src/example.ts

@@ -1,34 +1,34 @@
 import { defineExample } from '@contractspec/lib.contracts-spec';
 
 const example = defineExample({
-  meta: {
-    key: 'kb-update-pipeline',
-    version: '1.0.0',
-    title: 'KB Update Pipeline',
-    description:
-      'Automation proposes KB updates; humans verify; everything audited and notified.',
-    kind: 'knowledge',
-    visibility: 'public',
-    stability: 'experimental',
-    owners: ['@platform.core'],
-    tags: ['knowledge', 'pipeline', 'hitl', 'audit'],
-  },
-  docs: {
-    rootDocId: 'docs.examples.kb-update-pipeline',
-  },
-  entrypoints: {
-    packageName: '@contractspec/example.kb-update-pipeline',
-    feature: './feature',
-    contracts: './contracts',
-    handlers: './handlers',
-    docs: './docs',
-  },
-  surfaces: {
-    templates: true,
-    sandbox: { enabled: true, modes: ['markdown', 'specs', 'builder'] },
-    studio: { enabled: true, installable: true },
-    mcp: { enabled: true },
-  },
+	meta: {
+		key: 'kb-update-pipeline',
+		version: '1.0.0',
+		title: 'KB Update Pipeline',
+		description:
+			'Automation proposes KB updates; humans verify; everything audited and notified.',
+		kind: 'knowledge',
+		visibility: 'public',
+		stability: 'experimental',
+		owners: ['@platform.core'],
+		tags: ['knowledge', 'pipeline', 'hitl', 'audit'],
+	},
+	docs: {
+		rootDocId: 'docs.examples.kb-update-pipeline',
+	},
+	entrypoints: {
+		packageName: '@contractspec/example.kb-update-pipeline',
+		feature: './feature',
+		contracts: './contracts',
+		handlers: './handlers',
+		docs: './docs',
+	},
+	surfaces: {
+		templates: true,
+		sandbox: { enabled: true, modes: ['markdown', 'specs', 'builder'] },
+		studio: { enabled: true, installable: true },
+		mcp: { enabled: true },
+	},
 });
 
 export default example;

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

@@ -1,81 +1,81 @@
 import { describe, expect, it } from 'bun:test';
 
 import {
-  createPipelineMemoryHandlers,
-  createPipelineMemoryStore,
+	createPipelineMemoryHandlers,
+	createPipelineMemoryStore,
 } from './memory.handlers';
 
 describe('@contractspec/example.kb-update-pipeline memory handlers', () => {
-  it('high-risk change cannot be approved by curator role', async () => {
-    const store = createPipelineMemoryStore();
-    const pipeline = createPipelineMemoryHandlers(store);
+	it('high-risk change cannot be approved by curator role', async () => {
+		const store = createPipelineMemoryStore();
+		const pipeline = createPipelineMemoryHandlers(store);
 
-    store.candidates.set('c1', {
-      id: 'c1',
-      sourceDocumentId: 'EU_src1',
-      detectedAt: new Date(),
-      diffSummary: 'Change detected',
-      riskLevel: 'high',
-    });
+		store.candidates.set('c1', {
+			id: 'c1',
+			sourceDocumentId: 'EU_src1',
+			detectedAt: new Date(),
+			diffSummary: 'Change detected',
+			riskLevel: 'high',
+		});
 
-    const review = await pipeline.createReviewTask({ changeCandidateId: 'c1' });
-    await expect(
-      pipeline.submitDecision({
-        reviewTaskId: review.id,
-        decision: 'approve',
-        decidedBy: 'u_curator',
-        decidedByRole: 'curator',
-      })
-    ).rejects.toThrow('FORBIDDEN_ROLE');
-  });
+		const review = await pipeline.createReviewTask({ changeCandidateId: 'c1' });
+		await expect(
+			pipeline.submitDecision({
+				reviewTaskId: review.id,
+				decision: 'approve',
+				decidedBy: 'u_curator',
+				decidedByRole: 'curator',
+			})
+		).rejects.toThrow('FORBIDDEN_ROLE');
+	});
 
-  it('fires a notification when review is requested', async () => {
-    const store = createPipelineMemoryStore();
-    const pipeline = createPipelineMemoryHandlers(store);
+	it('fires a notification when review is requested', async () => {
+		const store = createPipelineMemoryStore();
+		const pipeline = createPipelineMemoryHandlers(store);
 
-    store.candidates.set('c2', {
-      id: 'c2',
-      sourceDocumentId: 'EU_src2',
-      detectedAt: new Date(),
-      diffSummary: 'Minor change',
-      riskLevel: 'low',
-    });
+		store.candidates.set('c2', {
+			id: 'c2',
+			sourceDocumentId: 'EU_src2',
+			detectedAt: new Date(),
+			diffSummary: 'Minor change',
+			riskLevel: 'low',
+		});
 
-    const review = await pipeline.createReviewTask({ changeCandidateId: 'c2' });
-    expect(store.notifications.length).toBe(1);
-    expect(store.notifications[0]?.reviewTaskId).toBe(review.id);
-    expect(store.notifications[0]?.assignedRole).toBe('curator');
-  });
+		const review = await pipeline.createReviewTask({ changeCandidateId: 'c2' });
+		expect(store.notifications.length).toBe(1);
+		expect(store.notifications[0]?.reviewTaskId).toBe(review.id);
+		expect(store.notifications[0]?.assignedRole).toBe('curator');
+	});
 
-  it('publishing fails if any included rule versions are not approved', async () => {
-    const store = createPipelineMemoryStore();
-    const pipeline = createPipelineMemoryHandlers(store);
+	it('publishing fails if any included rule versions are not approved', async () => {
+		const store = createPipelineMemoryStore();
+		const pipeline = createPipelineMemoryHandlers(store);
 
-    store.candidates.set('c3', {
-      id: 'c3',
-      sourceDocumentId: 'EU_src3',
-      detectedAt: new Date(),
-      diffSummary: 'Change',
-      riskLevel: 'low',
-    });
+		store.candidates.set('c3', {
+			id: 'c3',
+			sourceDocumentId: 'EU_src3',
+			detectedAt: new Date(),
+			diffSummary: 'Change',
+			riskLevel: 'low',
+		});
 
-    const review = await pipeline.createReviewTask({ changeCandidateId: 'c3' });
-    await pipeline.proposeRulePatch({
-      changeCandidateId: 'c3',
-      proposedRuleVersionIds: ['rv1', 'rv2'],
-    });
-    await pipeline.submitDecision({
-      reviewTaskId: review.id,
-      decision: 'approve',
-      decidedBy: 'u_curator',
-      decidedByRole: 'curator',
-    });
+		const review = await pipeline.createReviewTask({ changeCandidateId: 'c3' });
+		await pipeline.proposeRulePatch({
+			changeCandidateId: 'c3',
+			proposedRuleVersionIds: ['rv1', 'rv2'],
+		});
+		await pipeline.submitDecision({
+			reviewTaskId: review.id,
+			decision: 'approve',
+			decidedBy: 'u_curator',
+			decidedByRole: 'curator',
+		});
 
-    // only approve one of the proposed rule versions
-    await pipeline.markRuleVersionApproved({ ruleVersionId: 'rv1' });
+		// only approve one of the proposed rule versions
+		await pipeline.markRuleVersionApproved({ ruleVersionId: 'rv1' });
 
-    await expect(
-      pipeline.publishIfReady({ jurisdiction: 'EU' })
-    ).rejects.toThrow('NOT_READY');
-  });
+		await expect(
+			pipeline.publishIfReady({ jurisdiction: 'EU' })
+		).rejects.toThrow('NOT_READY');
+	});
 });