@contractspec/example.kb-update-pipeline 0.0.0-canary-20260113162409

package/dist/kb-update-pipeline.feature.js

@@ -0,0 +1,142 @@
+import { defineFeature } from "@contractspec/lib.contracts";
+
+//#region src/kb-update-pipeline.feature.ts
+const KbUpdatePipelineFeature = defineFeature({
+	meta: {
+		key: "kb-update-pipeline",
+		version: "1.0.0",
+		title: "KB Update Pipeline (HITL)",
+		description: "Automation proposes KB patches; humans verify; publishing is blocked until approvals are complete.",
+		domain: "knowledge",
+		owners: ["@examples"],
+		tags: [
+			"knowledge",
+			"pipeline",
+			"hitl",
+			"audit",
+			"notifications"
+		],
+		stability: "experimental"
+	},
+	operations: [
+		{
+			key: "kbPipeline.runWatch",
+			version: "1.0.0"
+		},
+		{
+			key: "kbPipeline.createReviewTask",
+			version: "1.0.0"
+		},
+		{
+			key: "kbPipeline.submitDecision",
+			version: "1.0.0"
+		},
+		{
+			key: "kbPipeline.publishIfReady",
+			version: "1.0.0"
+		}
+	],
+	events: [
+		{
+			key: "kb.change.detected",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.change.summarized",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.patch.proposed",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.review.requested",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.review.decided",
+			version: "1.0.0"
+		}
+	],
+	presentations: [
+		{
+			key: "kb.dashboard",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.review.list",
+			version: "1.0.0"
+		},
+		{
+			key: "kb.review.form",
+			version: "1.0.0"
+		}
+	],
+	opToPresentation: [
+		{
+			op: {
+				key: "kbPipeline.runWatch",
+				version: "1.0.0"
+			},
+			pres: {
+				key: "kb.dashboard",
+				version: "1.0.0"
+			}
+		},
+		{
+			op: {
+				key: "kbPipeline.createReviewTask",
+				version: "1.0.0"
+			},
+			pres: {
+				key: "kb.review.list",
+				version: "1.0.0"
+			}
+		},
+		{
+			op: {
+				key: "kbPipeline.submitDecision",
+				version: "1.0.0"
+			},
+			pres: {
+				key: "kb.review.form",
+				version: "1.0.0"
+			}
+		}
+	],
+	presentationsTargets: [
+		{
+			key: "kb.dashboard",
+			version: "1.0.0",
+			targets: ["react", "markdown"]
+		},
+		{
+			key: "kb.review.list",
+			version: "1.0.0",
+			targets: ["react", "markdown"]
+		},
+		{
+			key: "kb.review.form",
+			version: "1.0.0",
+			targets: ["react"]
+		}
+	],
+	capabilities: { requires: [
+		{
+			key: "identity",
+			version: "1.0.0"
+		},
+		{
+			key: "notifications",
+			version: "1.0.0"
+		},
+		{
+			key: "audit-trail",
+			version: "1.0.0"
+		}
+	] }
+});
+
+//#endregion
+export { KbUpdatePipelineFeature };
+//# sourceMappingURL=kb-update-pipeline.feature.js.map

package/dist/kb-update-pipeline.feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb-update-pipeline.feature.js","names":[],"sources":["../src/kb-update-pipeline.feature.ts"],"sourcesContent":["import { defineFeature } from '@contractspec/lib.contracts';\n\nexport const KbUpdatePipelineFeature = defineFeature({\n  meta: {\n    key: 'kb-update-pipeline',\n    version: '1.0.0',\n    title: 'KB Update Pipeline (HITL)',\n    description:\n      'Automation proposes KB patches; humans verify; publishing is blocked until approvals are complete.',\n    domain: 'knowledge',\n    owners: ['@examples'],\n    tags: ['knowledge', 'pipeline', 'hitl', 'audit', 'notifications'],\n    stability: 'experimental',\n  },\n  operations: [\n    { key: 'kbPipeline.runWatch', version: '1.0.0' },\n    { key: 'kbPipeline.createReviewTask', version: '1.0.0' },\n    { key: 'kbPipeline.submitDecision', version: '1.0.0' },\n    { key: 'kbPipeline.publishIfReady', version: '1.0.0' },\n  ],\n  events: [\n    { key: 'kb.change.detected', version: '1.0.0' },\n    { key: 'kb.change.summarized', version: '1.0.0' },\n    { key: 'kb.patch.proposed', version: '1.0.0' },\n    { key: 'kb.review.requested', version: '1.0.0' },\n    { key: 'kb.review.decided', version: '1.0.0' },\n  ],\n  presentations: [\n    { key: 'kb.dashboard', version: '1.0.0' },\n    { key: 'kb.review.list', version: '1.0.0' },\n    { key: 'kb.review.form', version: '1.0.0' },\n  ],\n  opToPresentation: [\n    {\n      op: { key: 'kbPipeline.runWatch', version: '1.0.0' },\n      pres: { key: 'kb.dashboard', version: '1.0.0' },\n    },\n    {\n      op: { key: 'kbPipeline.createReviewTask', version: '1.0.0' },\n      pres: { key: 'kb.review.list', version: '1.0.0' },\n    },\n    {\n      op: { key: 'kbPipeline.submitDecision', version: '1.0.0' },\n      pres: { key: 'kb.review.form', version: '1.0.0' },\n    },\n  ],\n  presentationsTargets: [\n    { key: 'kb.dashboard', version: '1.0.0', targets: ['react', 'markdown'] },\n    { key: 'kb.review.list', version: '1.0.0', targets: ['react', 'markdown'] },\n    { key: 'kb.review.form', version: '1.0.0', targets: ['react'] },\n  ],\n  capabilities: {\n    requires: [\n      { key: 'identity', version: '1.0.0' },\n      { key: 'notifications', version: '1.0.0' },\n      { key: 'audit-trail', version: '1.0.0' },\n    ],\n  },\n});\n"],"mappings":";;;AAEA,MAAa,0BAA0B,cAAc;CACnD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAY;GAAQ;GAAS;GAAgB;EACjE,WAAW;EACZ;CACD,YAAY;EACV;GAAE,KAAK;GAAuB,SAAS;GAAS;EAChD;GAAE,KAAK;GAA+B,SAAS;GAAS;EACxD;GAAE,KAAK;GAA6B,SAAS;GAAS;EACtD;GAAE,KAAK;GAA6B,SAAS;GAAS;EACvD;CACD,QAAQ;EACN;GAAE,KAAK;GAAsB,SAAS;GAAS;EAC/C;GAAE,KAAK;GAAwB,SAAS;GAAS;EACjD;GAAE,KAAK;GAAqB,SAAS;GAAS;EAC9C;GAAE,KAAK;GAAuB,SAAS;GAAS;EAChD;GAAE,KAAK;GAAqB,SAAS;GAAS;EAC/C;CACD,eAAe;EACb;GAAE,KAAK;GAAgB,SAAS;GAAS;EACzC;GAAE,KAAK;GAAkB,SAAS;GAAS;EAC3C;GAAE,KAAK;GAAkB,SAAS;GAAS;EAC5C;CACD,kBAAkB;EAChB;GACE,IAAI;IAAE,KAAK;IAAuB,SAAS;IAAS;GACpD,MAAM;IAAE,KAAK;IAAgB,SAAS;IAAS;GAChD;EACD;GACE,IAAI;IAAE,KAAK;IAA+B,SAAS;IAAS;GAC5D,MAAM;IAAE,KAAK;IAAkB,SAAS;IAAS;GAClD;EACD;GACE,IAAI;IAAE,KAAK;IAA6B,SAAS;IAAS;GAC1D,MAAM;IAAE,KAAK;IAAkB,SAAS;IAAS;GAClD;EACF;CACD,sBAAsB;EACpB;GAAE,KAAK;GAAgB,SAAS;GAAS,SAAS,CAAC,SAAS,WAAW;GAAE;EACzE;GAAE,KAAK;GAAkB,SAAS;GAAS,SAAS,CAAC,SAAS,WAAW;GAAE;EAC3E;GAAE,KAAK;GAAkB,SAAS;GAAS,SAAS,CAAC,QAAQ;GAAE;EAChE;CACD,cAAc,EACZ,UAAU;EACR;GAAE,KAAK;GAAY,SAAS;GAAS;EACrC;GAAE,KAAK;GAAiB,SAAS;GAAS;EAC1C;GAAE,KAAK;GAAe,SAAS;GAAS;EACzC,EACF;CACF,CAAC"}

package/dist/operations/index.d.ts

@@ -0,0 +1,2 @@
+import { KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract } from "./pipeline.js";
+export { KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract };

package/dist/operations/index.js

@@ -0,0 +1,3 @@
+import { KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract } from "./pipeline.js";
+
+export { KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract };

package/dist/operations/pipeline.d.ts

@@ -0,0 +1,137 @@
+import * as _contractspec_lib_contracts12 from "@contractspec/lib.contracts";
+import * as _contractspec_lib_schema35 from "@contractspec/lib.schema";
+
+//#region src/operations/pipeline.d.ts
+declare const KbPipelineRunWatchContract: _contractspec_lib_contracts12.OperationSpec<_contractspec_lib_schema35.SchemaModel<{
+  jurisdiction: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema35.SchemaModel<{
+  candidates: {
+    type: _contractspec_lib_schema35.SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema35.FieldType<string, string>;
+        isOptional: false;
+      };
+      sourceDocumentId: {
+        type: _contractspec_lib_schema35.FieldType<string, string>;
+        isOptional: false;
+      };
+      detectedAt: {
+        type: _contractspec_lib_schema35.FieldType<Date, string>;
+        isOptional: false;
+      };
+      diffSummary: {
+        type: _contractspec_lib_schema35.FieldType<string, string>;
+        isOptional: false;
+      };
+      riskLevel: {
+        type: _contractspec_lib_schema35.EnumType<[string, string, string]>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const KbPipelineCreateReviewTaskContract: _contractspec_lib_contracts12.OperationSpec<_contractspec_lib_schema35.SchemaModel<{
+  changeCandidateId: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema35.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+  changeCandidateId: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+  assignedRole: {
+    type: _contractspec_lib_schema35.EnumType<[string, string]>;
+    isOptional: false;
+  };
+  decision: {
+    type: _contractspec_lib_schema35.EnumType<[string, string]>;
+    isOptional: true;
+  };
+  decidedAt: {
+    type: _contractspec_lib_schema35.FieldType<Date, string>;
+    isOptional: true;
+  };
+  decidedBy: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+declare const KbPipelineSubmitDecisionContract: _contractspec_lib_contracts12.OperationSpec<_contractspec_lib_schema35.SchemaModel<{
+  reviewTaskId: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+  decision: {
+    type: _contractspec_lib_schema35.EnumType<[string, string]>;
+    isOptional: false;
+  };
+  decidedBy: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+  decidedByRole: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema35.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+  changeCandidateId: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+  assignedRole: {
+    type: _contractspec_lib_schema35.EnumType<[string, string]>;
+    isOptional: false;
+  };
+  decision: {
+    type: _contractspec_lib_schema35.EnumType<[string, string]>;
+    isOptional: true;
+  };
+  decidedAt: {
+    type: _contractspec_lib_schema35.FieldType<Date, string>;
+    isOptional: true;
+  };
+  decidedBy: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+declare const KbPipelinePublishIfReadyContract: _contractspec_lib_contracts12.OperationSpec<_contractspec_lib_schema35.SchemaModel<{
+  jurisdiction: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema35.SchemaModel<{
+  published: {
+    type: _contractspec_lib_schema35.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  reason: {
+    type: _contractspec_lib_schema35.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+//#endregion
+export { KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract };
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/operations/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","names":[],"sources":["../../src/operations/pipeline.ts"],"sourcesContent":[],"mappings":";;;;cAwEa,0DAA0B,yCAAA;;UAarC,0BAAA,CAAA;;EAbW,CAAA;CAaX,CAAA,wCAAA,CAAA;;IAbqC,IAAA,wCAAA,CAAA;;cAAA,0BAAA,CAAA;;;;;;;MAAA,UAAA,EAAA;QAe1B,IAAA,sCAaX,KAAA,EAAA,MAAA,CAAA;QAAA,UAAA,EAAA,KAAA;;MAb6C,WAAA,EAAA;;;;;;;;;;IAAA,UAAA,EAAA,KAAA;EAelC,CAAA;CA8BX,CAAA,EAAA,SAAA,CAAA;cA7CW,kEAAkC,yCAAA;;UAa7C,0BAAA,CAAA;;EAE2C,CAAA;;;UAfE,0BAAA,CAAA;;;;;;;EAeF,MAAA,EAAA;IAgChC,IAAA,sCAwBX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;EAxB2C,YAAA,EAAA;;;;EAAA,QAAA,EAAA;;;;;;;;;;;;;cAhChC,gEAAgC,yCAAA;;UA8B3C,0BAAA,CAAA;;;;;;;;;;;;;;;;;UA9B2C,0BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAgChC,gEAAgC,yCAAA;;UAwB3C,0BAAA,CAAA;;;;;UAxB2C,0BAAA,CAAA"}

package/dist/operations/pipeline.js

@@ -0,0 +1,183 @@
+import { ChangeCandidateModel, ReviewDecisionEnum, ReviewTaskModel } from "../entities/models.js";
+import { defineCommand } from "@contractspec/lib.contracts";
+import { ScalarTypeEnum, defineSchemaModel as defineSchemaModel$1 } from "@contractspec/lib.schema";
+
+//#region src/operations/pipeline.ts
+const RunWatchInput = defineSchemaModel$1({
+	name: "KbPipelineRunWatchInput",
+	description: "Trigger a watch cycle for KB sources (demo).",
+	fields: { jurisdiction: {
+		type: ScalarTypeEnum.String_unsecure(),
+		isOptional: false
+	} }
+});
+const RunWatchOutput = defineSchemaModel$1({
+	name: "KbPipelineRunWatchOutput",
+	description: "Output containing detected changes.",
+	fields: { candidates: {
+		type: ChangeCandidateModel,
+		isArray: true,
+		isOptional: false
+	} }
+});
+const CreateReviewTaskInput = defineSchemaModel$1({
+	name: "KbPipelineCreateReviewTaskInput",
+	description: "Create a review task for a change candidate.",
+	fields: { changeCandidateId: {
+		type: ScalarTypeEnum.String_unsecure(),
+		isOptional: false
+	} }
+});
+const SubmitDecisionInput = defineSchemaModel$1({
+	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$1({
+	name: "KbPipelinePublishIfReadyInput",
+	description: "Publish snapshot if approvals are satisfied for a jurisdiction.",
+	fields: { jurisdiction: {
+		type: ScalarTypeEnum.String_unsecure(),
+		isOptional: false
+	} }
+});
+const PublishIfReadyOutput = defineSchemaModel$1({
+	name: "KbPipelinePublishIfReadyOutput",
+	description: "Output for publish-if-ready operation.",
+	fields: {
+		published: {
+			type: ScalarTypeEnum.Boolean(),
+			isOptional: false
+		},
+		reason: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		}
+	}
+});
+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" }
+});
+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" }
+});
+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" }
+});
+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" }
+});
+
+//#endregion
+export { KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract };
+//# sourceMappingURL=pipeline.js.map

package/dist/operations/pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.js","names":["defineSchemaModel"],"sources":["../../src/operations/pipeline.ts"],"sourcesContent":["import { defineCommand } from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\n\nimport {\n  ChangeCandidateModel,\n  ReviewDecisionEnum,\n  ReviewTaskModel,\n} from '../entities/models';\n\nconst RunWatchInput = defineSchemaModel({\n  name: 'KbPipelineRunWatchInput',\n  description: 'Trigger a watch cycle for KB sources (demo).',\n  fields: {\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst RunWatchOutput = defineSchemaModel({\n  name: 'KbPipelineRunWatchOutput',\n  description: 'Output containing detected changes.',\n  fields: {\n    candidates: {\n      type: ChangeCandidateModel,\n      isArray: true,\n      isOptional: false,\n    },\n  },\n});\n\nconst CreateReviewTaskInput = defineSchemaModel({\n  name: 'KbPipelineCreateReviewTaskInput',\n  description: 'Create a review task for a change candidate.',\n  fields: {\n    changeCandidateId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n  },\n});\n\nconst SubmitDecisionInput = defineSchemaModel({\n  name: 'KbPipelineSubmitDecisionInput',\n  description: 'Submit a decision for a review task.',\n  fields: {\n    reviewTaskId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    decision: { type: ReviewDecisionEnum, isOptional: false },\n    decidedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    decidedByRole: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n  },\n});\n\nconst PublishIfReadyInput = defineSchemaModel({\n  name: 'KbPipelinePublishIfReadyInput',\n  description:\n    'Publish snapshot if approvals are satisfied for a jurisdiction.',\n  fields: {\n    jurisdiction: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst PublishIfReadyOutput = defineSchemaModel({\n  name: 'KbPipelinePublishIfReadyOutput',\n  description: 'Output for publish-if-ready operation.',\n  fields: {\n    published: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    reason: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nexport const KbPipelineRunWatchContract = defineCommand({\n  meta: {\n    key: 'kbPipeline.runWatch',\n    version: '1.0.0',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'pipeline', 'jobs'],\n    description: 'Detect source changes and create change candidates.',\n    goal: 'Automate discovery of updates needing review.',\n    context: 'Scheduled job or manual trigger in demos.',\n  },\n  io: { input: RunWatchInput, output: RunWatchOutput },\n  policy: { auth: 'user' },\n});\n\nexport const KbPipelineCreateReviewTaskContract = defineCommand({\n  meta: {\n    key: 'kbPipeline.createReviewTask',\n    version: '1.0.0',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'pipeline', 'hitl'],\n    description: 'Create a review task for a detected change.',\n    goal: 'Route work to human verifiers.',\n    context: 'Called after change detection or manual selection.',\n  },\n  io: { input: CreateReviewTaskInput, output: ReviewTaskModel },\n  policy: { auth: 'user' },\n});\n\nexport const KbPipelineSubmitDecisionContract = defineCommand({\n  meta: {\n    key: 'kbPipeline.submitDecision',\n    version: '1.0.0',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'pipeline', 'hitl', 'rbac'],\n    description: 'Submit approve/reject decision for a review task.',\n    goal: 'Ensure humans verify before publishing.',\n    context: 'Curator/expert reviews and decides.',\n  },\n  io: {\n    input: SubmitDecisionInput,\n    output: ReviewTaskModel,\n    errors: {\n      FORBIDDEN_ROLE: {\n        description: 'Role not allowed to approve the given risk level',\n        http: 403,\n        gqlCode: 'FORBIDDEN_ROLE',\n        when: 'curator attempts to approve a high-risk change',\n      },\n      REVIEW_TASK_NOT_FOUND: {\n        description: 'Review task not found',\n        http: 404,\n        gqlCode: 'REVIEW_TASK_NOT_FOUND',\n        when: 'reviewTaskId is invalid',\n      },\n    },\n  },\n  policy: { auth: 'user' },\n});\n\nexport const KbPipelinePublishIfReadyContract = defineCommand({\n  meta: {\n    key: 'kbPipeline.publishIfReady',\n    version: '1.0.0',\n    stability: 'experimental',\n    owners: ['@examples'],\n    tags: ['knowledge', 'pipeline', 'publishing'],\n    description: 'Publish snapshot if ready (all approvals satisfied).',\n    goal: 'Prevent publishing until all required approvals exist.',\n    context: 'Called by job or UI to attempt publish.',\n  },\n  io: {\n    input: PublishIfReadyInput,\n    output: PublishIfReadyOutput,\n    errors: {\n      NOT_READY: {\n        description: 'Publishing is blocked because approvals are incomplete',\n        http: 409,\n        gqlCode: 'NOT_READY',\n        when: 'there are open review tasks or unapproved rule versions',\n      },\n    },\n  },\n  policy: { auth: 'user' },\n});\n"],"mappings":";;;;;AASA,MAAM,gBAAgBA,oBAAkB;CACtC,MAAM;CACN,aAAa;CACb,QAAQ,EACN,cAAc;EAAE,MAAM,eAAe,iBAAiB;EAAE,YAAY;EAAO,EAC5E;CACF,CAAC;AAEF,MAAM,iBAAiBA,oBAAkB;CACvC,MAAM;CACN,aAAa;CACb,QAAQ,EACN,YAAY;EACV,MAAM;EACN,SAAS;EACT,YAAY;EACb,EACF;CACF,CAAC;AAEF,MAAM,wBAAwBA,oBAAkB;CAC9C,MAAM;CACN,aAAa;CACb,QAAQ,EACN,mBAAmB;EACjB,MAAM,eAAe,iBAAiB;EACtC,YAAY;EACb,EACF;CACF,CAAC;AAEF,MAAM,sBAAsBA,oBAAkB;CAC5C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,UAAU;GAAE,MAAM;GAAoB,YAAY;GAAO;EACzD,WAAW;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE,eAAe;GACb,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACF;CACF,CAAC;AAEF,MAAM,sBAAsBA,oBAAkB;CAC5C,MAAM;CACN,aACE;CACF,QAAQ,EACN,cAAc;EAAE,MAAM,eAAe,iBAAiB;EAAE,YAAY;EAAO,EAC5E;CACF,CAAC;AAEF,MAAM,uBAAuBA,oBAAkB;CAC7C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,WAAW;GAAE,MAAM,eAAe,SAAS;GAAE,YAAY;GAAO;EAChE,QAAQ;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACrE;CACF,CAAC;AAEF,MAAa,6BAA6B,cAAc;CACtD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAY;GAAO;EACvC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EAAE,OAAO;EAAe,QAAQ;EAAgB;CACpD,QAAQ,EAAE,MAAM,QAAQ;CACzB,CAAC;AAEF,MAAa,qCAAqC,cAAc;CAC9D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAY;GAAO;EACvC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EAAE,OAAO;EAAuB,QAAQ;EAAiB;CAC7D,QAAQ,EAAE,MAAM,QAAQ;CACzB,CAAC;AAEF,MAAa,mCAAmC,cAAc;CAC5D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAY;GAAQ;GAAO;EAC/C,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACR,QAAQ;GACN,gBAAgB;IACd,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACD,uBAAuB;IACrB,aAAa;IACb,MAAM;IACN,SAAS;IACT,MAAM;IACP;GACF;EACF;CACD,QAAQ,EAAE,MAAM,QAAQ;CACzB,CAAC;AAEF,MAAa,mCAAmC,cAAc;CAC5D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,YAAY;EACrB,MAAM;GAAC;GAAa;GAAY;GAAa;EAC7C,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACR,QAAQ,EACN,WAAW;GACT,aAAa;GACb,MAAM;GACN,SAAS;GACT,MAAM;GACP,EACF;EACF;CACD,QAAQ,EAAE,MAAM,QAAQ;CACzB,CAAC"}

package/dist/presentations.d.ts

@@ -0,0 +1,9 @@
+import * as _contractspec_lib_contracts9 from "@contractspec/lib.contracts";
+
+//#region src/presentations.d.ts
+declare const KbDashboardPresentation: _contractspec_lib_contracts9.PresentationSpec;
+declare const KbReviewListPresentation: _contractspec_lib_contracts9.PresentationSpec;
+declare const KbReviewFormPresentation: _contractspec_lib_contracts9.PresentationSpec;
+//#endregion
+export { KbDashboardPresentation, KbReviewFormPresentation, KbReviewListPresentation };
+//# sourceMappingURL=presentations.d.ts.map

package/dist/presentations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.d.ts","names":[],"sources":["../src/presentations.ts"],"sourcesContent":[],"mappings":";;;cAGa,yBAoBX,4BAAA,CApBkC;cAsBvB,0BAoBX,4BAAA,CApBmC;cAsBxB,0BAoBX,4BAAA,CApBmC"}

package/dist/presentations.js

@@ -0,0 +1,71 @@
+import { ChangeCandidateModel, ReviewTaskModel } from "./entities/models.js";
+import { StabilityEnum, definePresentation } from "@contractspec/lib.contracts";
+
+//#region src/presentations.ts
+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
+	},
+	targets: ["react", "markdown"]
+});
+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"]
+});
+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"]
+});
+
+//#endregion
+export { KbDashboardPresentation, KbReviewFormPresentation, KbReviewListPresentation };
+//# sourceMappingURL=presentations.js.map

package/dist/presentations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"presentations.js","names":[],"sources":["../src/presentations.ts"],"sourcesContent":["import { definePresentation, StabilityEnum } from '@contractspec/lib.contracts';\nimport { ChangeCandidateModel, ReviewTaskModel } from './entities/models';\n\nexport const KbDashboardPresentation = definePresentation({\n  meta: {\n    key: 'kb.dashboard',\n    version: '1.0.0',\n    title: 'KB Update Dashboard',\n    description: 'Overview of KB change candidates and review tasks.',\n    domain: 'knowledge',\n    owners: ['@examples'],\n    tags: ['dashboard', 'knowledge'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Visualize status',\n    context: 'Dashboard',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'KbDashboard',\n    props: ChangeCandidateModel, // Simplified props mapping for example\n  },\n  targets: ['react', 'markdown'],\n});\n\nexport const KbReviewListPresentation = definePresentation({\n  meta: {\n    key: 'kb.review.list',\n    version: '1.0.0',\n    title: 'Review Tasks',\n    description: 'List of pending review tasks for the current user.',\n    domain: 'knowledge',\n    owners: ['@examples'],\n    tags: ['list', 'review'],\n    stability: StabilityEnum.Experimental,\n    goal: 'List tasks',\n    context: 'Inbox',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'ReviewTaskList',\n    props: ReviewTaskModel,\n  },\n  targets: ['react', 'markdown'],\n});\n\nexport const KbReviewFormPresentation = definePresentation({\n  meta: {\n    key: 'kb.review.form',\n    version: '1.0.0',\n    title: 'Review Change',\n    description: 'Form to approve or reject a KB change candidate.',\n    domain: 'knowledge',\n    owners: ['@examples'],\n    tags: ['form', 'review'],\n    stability: StabilityEnum.Experimental,\n    goal: 'Review',\n    context: 'Detail',\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'ReviewDecisionForm',\n    props: ReviewTaskModel,\n  },\n  targets: ['react'],\n});\n"],"mappings":";;;;AAGA,MAAa,0BAA0B,mBAAmB;CACxD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,aAAa,YAAY;EAChC,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS,CAAC,SAAS,WAAW;CAC/B,CAAC;AAEF,MAAa,2BAA2B,mBAAmB;CACzD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,QAAQ,SAAS;EACxB,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS,CAAC,SAAS,WAAW;CAC/B,CAAC;AAEF,MAAa,2BAA2B,mBAAmB;CACzD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aAAa;EACb,QAAQ;EACR,QAAQ,CAAC,YAAY;EACrB,MAAM,CAAC,QAAQ,SAAS;EACxB,WAAW,cAAc;EACzB,MAAM;EACN,SAAS;EACV;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS,CAAC,QAAQ;CACnB,CAAC"}

package/dist/tests/operations.test-spec.d.ts

@@ -0,0 +1,9 @@
+import * as _contractspec_lib_contracts4 from "@contractspec/lib.contracts";
+
+//#region src/tests/operations.test-spec.d.ts
+declare const RunWatchTest: _contractspec_lib_contracts4.TestSpec;
+declare const CreateReviewTaskTest: _contractspec_lib_contracts4.TestSpec;
+declare const SubmitDecisionTest: _contractspec_lib_contracts4.TestSpec;
+//#endregion
+export { CreateReviewTaskTest, RunWatchTest, SubmitDecisionTest };
+//# sourceMappingURL=operations.test-spec.d.ts.map

package/dist/tests/operations.test-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.test-spec.d.ts","names":[],"sources":["../../src/tests/operations.test-spec.ts"],"sourcesContent":[],"mappings":";;;cAEa,cAyBX,4BAAA,CAzBuB;cA2BZ,sBAyBX,4BAAA,CAzB+B;cA2BpB,oBAyBX,4BAAA,CAzB6B"}