@contractspec/example.kb-update-pipeline 3.7.5 → 3.7.7

package/src/operations/pipeline.ts

@@ -1,159 +1,159 @@
 import { defineCommand } from '@contractspec/lib.contracts-spec';
-import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';
+import { defineSchemaModel, ScalarTypeEnum } from '@contractspec/lib.schema';
 
 import {
-  ChangeCandidateModel,
-  ReviewDecisionEnum,
-  ReviewTaskModel,
+	ChangeCandidateModel,
+	ReviewDecisionEnum,
+	ReviewTaskModel,
 } from '../entities/models';
 
 const RunWatchInput = defineSchemaModel({
-  name: 'KbPipelineRunWatchInput',
-  description: 'Trigger a watch cycle for KB sources (demo).',
-  fields: {
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-  },
+	name: 'KbPipelineRunWatchInput',
+	description: 'Trigger a watch cycle for KB sources (demo).',
+	fields: {
+		jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+	},
 });
 
 const RunWatchOutput = defineSchemaModel({
-  name: 'KbPipelineRunWatchOutput',
-  description: 'Output containing detected changes.',
-  fields: {
-    candidates: {
-      type: ChangeCandidateModel,
-      isArray: true,
-      isOptional: false,
-    },
-  },
+	name: 'KbPipelineRunWatchOutput',
+	description: 'Output containing detected changes.',
+	fields: {
+		candidates: {
+			type: ChangeCandidateModel,
+			isArray: true,
+			isOptional: false,
+		},
+	},
 });
 
 const CreateReviewTaskInput = defineSchemaModel({
-  name: 'KbPipelineCreateReviewTaskInput',
-  description: 'Create a review task for a change candidate.',
-  fields: {
-    changeCandidateId: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false,
-    },
-  },
+	name: 'KbPipelineCreateReviewTaskInput',
+	description: 'Create a review task for a change candidate.',
+	fields: {
+		changeCandidateId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false,
+		},
+	},
 });
 
 const SubmitDecisionInput = defineSchemaModel({
-  name: 'KbPipelineSubmitDecisionInput',
-  description: 'Submit a decision for a review task.',
-  fields: {
-    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,
-    },
-  },
+	name: 'KbPipelineSubmitDecisionInput',
+	description: 'Submit a decision for a review task.',
+	fields: {
+		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,
+		},
+	},
 });
 
 const PublishIfReadyInput = defineSchemaModel({
-  name: 'KbPipelinePublishIfReadyInput',
-  description:
-    'Publish snapshot if approvals are satisfied for a jurisdiction.',
-  fields: {
-    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-  },
+	name: 'KbPipelinePublishIfReadyInput',
+	description:
+		'Publish snapshot if approvals are satisfied for a jurisdiction.',
+	fields: {
+		jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
+	},
 });
 
 const PublishIfReadyOutput = defineSchemaModel({
-  name: 'KbPipelinePublishIfReadyOutput',
-  description: 'Output for publish-if-ready operation.',
-  fields: {
-    published: { type: ScalarTypeEnum.Boolean(), isOptional: false },
-    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-  },
+	name: 'KbPipelinePublishIfReadyOutput',
+	description: 'Output for publish-if-ready operation.',
+	fields: {
+		published: { type: ScalarTypeEnum.Boolean(), isOptional: false },
+		reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
+	},
 });
 
 export const KbPipelineRunWatchContract = defineCommand({
-  meta: {
-    key: 'kbPipeline.runWatch',
-    version: '1.0.0',
-    stability: 'experimental',
-    owners: ['@examples'],
-    tags: ['knowledge', 'pipeline', 'jobs'],
-    description: 'Detect source changes and create change candidates.',
-    goal: 'Automate discovery of updates needing review.',
-    context: 'Scheduled job or manual trigger in demos.',
-  },
-  io: { input: RunWatchInput, output: RunWatchOutput },
-  policy: { auth: 'user' },
+	meta: {
+		key: 'kbPipeline.runWatch',
+		version: '1.0.0',
+		stability: 'experimental',
+		owners: ['@examples'],
+		tags: ['knowledge', 'pipeline', 'jobs'],
+		description: 'Detect source changes and create change candidates.',
+		goal: 'Automate discovery of updates needing review.',
+		context: 'Scheduled job or manual trigger in demos.',
+	},
+	io: { input: RunWatchInput, output: RunWatchOutput },
+	policy: { auth: 'user' },
 });
 
 export const KbPipelineCreateReviewTaskContract = defineCommand({
-  meta: {
-    key: 'kbPipeline.createReviewTask',
-    version: '1.0.0',
-    stability: 'experimental',
-    owners: ['@examples'],
-    tags: ['knowledge', 'pipeline', 'hitl'],
-    description: 'Create a review task for a detected change.',
-    goal: 'Route work to human verifiers.',
-    context: 'Called after change detection or manual selection.',
-  },
-  io: { input: CreateReviewTaskInput, output: ReviewTaskModel },
-  policy: { auth: 'user' },
+	meta: {
+		key: 'kbPipeline.createReviewTask',
+		version: '1.0.0',
+		stability: 'experimental',
+		owners: ['@examples'],
+		tags: ['knowledge', 'pipeline', 'hitl'],
+		description: 'Create a review task for a detected change.',
+		goal: 'Route work to human verifiers.',
+		context: 'Called after change detection or manual selection.',
+	},
+	io: { input: CreateReviewTaskInput, output: ReviewTaskModel },
+	policy: { auth: 'user' },
 });
 
 export const KbPipelineSubmitDecisionContract = defineCommand({
-  meta: {
-    key: 'kbPipeline.submitDecision',
-    version: '1.0.0',
-    stability: 'experimental',
-    owners: ['@examples'],
-    tags: ['knowledge', 'pipeline', 'hitl', 'rbac'],
-    description: 'Submit approve/reject decision for a review task.',
-    goal: 'Ensure humans verify before publishing.',
-    context: 'Curator/expert reviews and decides.',
-  },
-  io: {
-    input: SubmitDecisionInput,
-    output: ReviewTaskModel,
-    errors: {
-      FORBIDDEN_ROLE: {
-        description: 'Role not allowed to approve the given risk level',
-        http: 403,
-        gqlCode: 'FORBIDDEN_ROLE',
-        when: 'curator attempts to approve a high-risk change',
-      },
-      REVIEW_TASK_NOT_FOUND: {
-        description: 'Review task not found',
-        http: 404,
-        gqlCode: 'REVIEW_TASK_NOT_FOUND',
-        when: 'reviewTaskId is invalid',
-      },
-    },
-  },
-  policy: { auth: 'user' },
+	meta: {
+		key: 'kbPipeline.submitDecision',
+		version: '1.0.0',
+		stability: 'experimental',
+		owners: ['@examples'],
+		tags: ['knowledge', 'pipeline', 'hitl', 'rbac'],
+		description: 'Submit approve/reject decision for a review task.',
+		goal: 'Ensure humans verify before publishing.',
+		context: 'Curator/expert reviews and decides.',
+	},
+	io: {
+		input: SubmitDecisionInput,
+		output: ReviewTaskModel,
+		errors: {
+			FORBIDDEN_ROLE: {
+				description: 'Role not allowed to approve the given risk level',
+				http: 403,
+				gqlCode: 'FORBIDDEN_ROLE',
+				when: 'curator attempts to approve a high-risk change',
+			},
+			REVIEW_TASK_NOT_FOUND: {
+				description: 'Review task not found',
+				http: 404,
+				gqlCode: 'REVIEW_TASK_NOT_FOUND',
+				when: 'reviewTaskId is invalid',
+			},
+		},
+	},
+	policy: { auth: 'user' },
 });
 
 export const KbPipelinePublishIfReadyContract = defineCommand({
-  meta: {
-    key: 'kbPipeline.publishIfReady',
-    version: '1.0.0',
-    stability: 'experimental',
-    owners: ['@examples'],
-    tags: ['knowledge', 'pipeline', 'publishing'],
-    description: 'Publish snapshot if ready (all approvals satisfied).',
-    goal: 'Prevent publishing until all required approvals exist.',
-    context: 'Called by job or UI to attempt publish.',
-  },
-  io: {
-    input: PublishIfReadyInput,
-    output: PublishIfReadyOutput,
-    errors: {
-      NOT_READY: {
-        description: 'Publishing is blocked because approvals are incomplete',
-        http: 409,
-        gqlCode: 'NOT_READY',
-        when: 'there are open review tasks or unapproved rule versions',
-      },
-    },
-  },
-  policy: { auth: 'user' },
+	meta: {
+		key: 'kbPipeline.publishIfReady',
+		version: '1.0.0',
+		stability: 'experimental',
+		owners: ['@examples'],
+		tags: ['knowledge', 'pipeline', 'publishing'],
+		description: 'Publish snapshot if ready (all approvals satisfied).',
+		goal: 'Prevent publishing until all required approvals exist.',
+		context: 'Called by job or UI to attempt publish.',
+	},
+	io: {
+		input: PublishIfReadyInput,
+		output: PublishIfReadyOutput,
+		errors: {
+			NOT_READY: {
+				description: 'Publishing is blocked because approvals are incomplete',
+				http: 409,
+				gqlCode: 'NOT_READY',
+				when: 'there are open review tasks or unapproved rule versions',
+			},
+		},
+	},
+	policy: { auth: 'user' },
 });

package/src/presentations.ts

@@ -1,71 +1,71 @@
 import {
-  definePresentation,
-  StabilityEnum,
+	definePresentation,
+	StabilityEnum,
 } from '@contractspec/lib.contracts-spec';
 import { ChangeCandidateModel, ReviewTaskModel } from './entities/models';
 
 export const KbDashboardPresentation = definePresentation({
-  meta: {
-    key: 'kb.dashboard',
-    version: '1.0.0',
-    title: 'KB Update Dashboard',
-    description: 'Overview of KB change candidates and review tasks.',
-    domain: 'knowledge',
-    owners: ['@examples'],
-    tags: ['dashboard', 'knowledge'],
-    stability: StabilityEnum.Experimental,
-    goal: 'Visualize status',
-    context: 'Dashboard',
-  },
-  source: {
-    type: 'component',
-    framework: 'react',
-    componentKey: 'KbDashboard',
-    props: ChangeCandidateModel, // Simplified props mapping for example
-  },
-  targets: ['react', 'markdown'],
+	meta: {
+		key: 'kb.dashboard',
+		version: '1.0.0',
+		title: 'KB Update Dashboard',
+		description: 'Overview of KB change candidates and review tasks.',
+		domain: 'knowledge',
+		owners: ['@examples'],
+		tags: ['dashboard', 'knowledge'],
+		stability: StabilityEnum.Experimental,
+		goal: 'Visualize status',
+		context: 'Dashboard',
+	},
+	source: {
+		type: 'component',
+		framework: 'react',
+		componentKey: 'KbDashboard',
+		props: ChangeCandidateModel, // Simplified props mapping for example
+	},
+	targets: ['react', 'markdown'],
 });
 
 export const KbReviewListPresentation = definePresentation({
-  meta: {
-    key: 'kb.review.list',
-    version: '1.0.0',
-    title: 'Review Tasks',
-    description: 'List of pending review tasks for the current user.',
-    domain: 'knowledge',
-    owners: ['@examples'],
-    tags: ['list', 'review'],
-    stability: StabilityEnum.Experimental,
-    goal: 'List tasks',
-    context: 'Inbox',
-  },
-  source: {
-    type: 'component',
-    framework: 'react',
-    componentKey: 'ReviewTaskList',
-    props: ReviewTaskModel,
-  },
-  targets: ['react', 'markdown'],
+	meta: {
+		key: 'kb.review.list',
+		version: '1.0.0',
+		title: 'Review Tasks',
+		description: 'List of pending review tasks for the current user.',
+		domain: 'knowledge',
+		owners: ['@examples'],
+		tags: ['list', 'review'],
+		stability: StabilityEnum.Experimental,
+		goal: 'List tasks',
+		context: 'Inbox',
+	},
+	source: {
+		type: 'component',
+		framework: 'react',
+		componentKey: 'ReviewTaskList',
+		props: ReviewTaskModel,
+	},
+	targets: ['react', 'markdown'],
 });
 
 export const KbReviewFormPresentation = definePresentation({
-  meta: {
-    key: 'kb.review.form',
-    version: '1.0.0',
-    title: 'Review Change',
-    description: 'Form to approve or reject a KB change candidate.',
-    domain: 'knowledge',
-    owners: ['@examples'],
-    tags: ['form', 'review'],
-    stability: StabilityEnum.Experimental,
-    goal: 'Review',
-    context: 'Detail',
-  },
-  source: {
-    type: 'component',
-    framework: 'react',
-    componentKey: 'ReviewDecisionForm',
-    props: ReviewTaskModel,
-  },
-  targets: ['react'],
+	meta: {
+		key: 'kb.review.form',
+		version: '1.0.0',
+		title: 'Review Change',
+		description: 'Form to approve or reject a KB change candidate.',
+		domain: 'knowledge',
+		owners: ['@examples'],
+		tags: ['form', 'review'],
+		stability: StabilityEnum.Experimental,
+		goal: 'Review',
+		context: 'Detail',
+	},
+	source: {
+		type: 'component',
+		framework: 'react',
+		componentKey: 'ReviewDecisionForm',
+		props: ReviewTaskModel,
+	},
+	targets: ['react'],
 });

package/src/tests/operations.test-spec.ts

@@ -1,82 +1,82 @@
 import { defineTestSpec } from '@contractspec/lib.contracts-spec/tests';
 
 export const RunWatchTest = defineTestSpec({
-  meta: {
-    key: 'kbPipeline.runWatch.test',
-    version: '1.0.0',
-    stability: 'experimental',
-    owners: ['@example.kb-update-pipeline'],
-    description: 'Test for run watch operation',
-    tags: ['test'],
-  },
-  target: {
-    type: 'operation',
-    operation: { key: 'kbPipeline.runWatch', version: '1.0.0' },
-  },
-  scenarios: [
-    {
-      key: 'success',
-      when: { operation: { key: 'kbPipeline.runWatch' } },
-      then: [{ type: 'expectOutput', match: {} }],
-    },
-    {
-      key: 'error',
-      when: { operation: { key: 'kbPipeline.runWatch' } },
-      then: [{ type: 'expectError' }],
-    },
-  ],
+	meta: {
+		key: 'kbPipeline.runWatch.test',
+		version: '1.0.0',
+		stability: 'experimental',
+		owners: ['@example.kb-update-pipeline'],
+		description: 'Test for run watch operation',
+		tags: ['test'],
+	},
+	target: {
+		type: 'operation',
+		operation: { key: 'kbPipeline.runWatch', version: '1.0.0' },
+	},
+	scenarios: [
+		{
+			key: 'success',
+			when: { operation: { key: 'kbPipeline.runWatch' } },
+			then: [{ type: 'expectOutput', match: {} }],
+		},
+		{
+			key: 'error',
+			when: { operation: { key: 'kbPipeline.runWatch' } },
+			then: [{ type: 'expectError' }],
+		},
+	],
 });
 
 export const CreateReviewTaskTest = defineTestSpec({
-  meta: {
-    key: 'kbPipeline.createReviewTask.test',
-    version: '1.0.0',
-    stability: 'experimental',
-    owners: ['@example.kb-update-pipeline'],
-    description: 'Test for creating review task',
-    tags: ['test'],
-  },
-  target: {
-    type: 'operation',
-    operation: { key: 'kbPipeline.createReviewTask', version: '1.0.0' },
-  },
-  scenarios: [
-    {
-      key: 'success',
-      when: { operation: { key: 'kbPipeline.createReviewTask' } },
-      then: [{ type: 'expectOutput', match: {} }],
-    },
-    {
-      key: 'error',
-      when: { operation: { key: 'kbPipeline.createReviewTask' } },
-      then: [{ type: 'expectError' }],
-    },
-  ],
+	meta: {
+		key: 'kbPipeline.createReviewTask.test',
+		version: '1.0.0',
+		stability: 'experimental',
+		owners: ['@example.kb-update-pipeline'],
+		description: 'Test for creating review task',
+		tags: ['test'],
+	},
+	target: {
+		type: 'operation',
+		operation: { key: 'kbPipeline.createReviewTask', version: '1.0.0' },
+	},
+	scenarios: [
+		{
+			key: 'success',
+			when: { operation: { key: 'kbPipeline.createReviewTask' } },
+			then: [{ type: 'expectOutput', match: {} }],
+		},
+		{
+			key: 'error',
+			when: { operation: { key: 'kbPipeline.createReviewTask' } },
+			then: [{ type: 'expectError' }],
+		},
+	],
 });
 
 export const SubmitDecisionTest = defineTestSpec({
-  meta: {
-    key: 'kbPipeline.submitDecision.test',
-    version: '1.0.0',
-    stability: 'experimental',
-    owners: ['@example.kb-update-pipeline'],
-    description: 'Test for submitting decision',
-    tags: ['test'],
-  },
-  target: {
-    type: 'operation',
-    operation: { key: 'kbPipeline.submitDecision', version: '1.0.0' },
-  },
-  scenarios: [
-    {
-      key: 'success',
-      when: { operation: { key: 'kbPipeline.submitDecision' } },
-      then: [{ type: 'expectOutput', match: {} }],
-    },
-    {
-      key: 'error',
-      when: { operation: { key: 'kbPipeline.submitDecision' } },
-      then: [{ type: 'expectError' }],
-    },
-  ],
+	meta: {
+		key: 'kbPipeline.submitDecision.test',
+		version: '1.0.0',
+		stability: 'experimental',
+		owners: ['@example.kb-update-pipeline'],
+		description: 'Test for submitting decision',
+		tags: ['test'],
+	},
+	target: {
+		type: 'operation',
+		operation: { key: 'kbPipeline.submitDecision', version: '1.0.0' },
+	},
+	scenarios: [
+		{
+			key: 'success',
+			when: { operation: { key: 'kbPipeline.submitDecision' } },
+			then: [{ type: 'expectOutput', match: {} }],
+		},
+		{
+			key: 'error',
+			when: { operation: { key: 'kbPipeline.submitDecision' } },
+			then: [{ type: 'expectError' }],
+		},
+	],
 });

package/tsconfig.json

@@ -1,19 +1,9 @@
 {
-  "extends": "@contractspec/tool.typescript/react-library.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "rootDir": "./src"
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
+	"extends": "@contractspec/tool.typescript/react-library.json",
+	"compilerOptions": {
+		"outDir": "./dist",
+		"rootDir": "./src"
+	},
+	"include": ["src/**/*"],
+	"exclude": ["node_modules", "dist"]
 }
-
-
-
-
-
-
-
-
-
-

package/tsdown.config.js

@@ -1,16 +1,10 @@
-import { defineConfig, moduleLibrary, withDevExports } from '@contractspec/tool.bun';
+import {
+	defineConfig,
+	moduleLibrary,
+	withDevExports,
+} from '@contractspec/tool.bun';
 
 export default defineConfig(() => ({
-  ...moduleLibrary,
-  ...withDevExports,
+	...moduleLibrary,
+	...withDevExports,
 }));
-
-
-
-
-
-
-
-
-
-