@contractspec/example.kb-update-pipeline 1.44.0

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

@@ -0,0 +1,140 @@
+//#region src/kb-update-pipeline.feature.ts
+const KbUpdatePipelineFeature = {
+	meta: {
+		key: "kb-update-pipeline",
+		version: 1,
+		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
+		},
+		{
+			key: "kbPipeline.createReviewTask",
+			version: 1
+		},
+		{
+			key: "kbPipeline.submitDecision",
+			version: 1
+		},
+		{
+			key: "kbPipeline.publishIfReady",
+			version: 1
+		}
+	],
+	events: [
+		{
+			key: "kb.change.detected",
+			version: 1
+		},
+		{
+			key: "kb.change.summarized",
+			version: 1
+		},
+		{
+			key: "kb.patch.proposed",
+			version: 1
+		},
+		{
+			key: "kb.review.requested",
+			version: 1
+		},
+		{
+			key: "kb.review.decided",
+			version: 1
+		}
+	],
+	presentations: [
+		{
+			key: "kb.dashboard",
+			version: 1
+		},
+		{
+			key: "kb.review.list",
+			version: 1
+		},
+		{
+			key: "kb.review.form",
+			version: 1
+		}
+	],
+	opToPresentation: [
+		{
+			op: {
+				key: "kbPipeline.runWatch",
+				version: 1
+			},
+			pres: {
+				key: "kb.dashboard",
+				version: 1
+			}
+		},
+		{
+			op: {
+				key: "kbPipeline.createReviewTask",
+				version: 1
+			},
+			pres: {
+				key: "kb.review.list",
+				version: 1
+			}
+		},
+		{
+			op: {
+				key: "kbPipeline.submitDecision",
+				version: 1
+			},
+			pres: {
+				key: "kb.review.form",
+				version: 1
+			}
+		}
+	],
+	presentationsTargets: [
+		{
+			key: "kb.dashboard",
+			version: 1,
+			targets: ["react", "markdown"]
+		},
+		{
+			key: "kb.review.list",
+			version: 1,
+			targets: ["react", "markdown"]
+		},
+		{
+			key: "kb.review.form",
+			version: 1,
+			targets: ["react"]
+		}
+	],
+	capabilities: { requires: [
+		{
+			key: "identity",
+			version: 1
+		},
+		{
+			key: "notifications",
+			version: 1
+		},
+		{
+			key: "audit-trail",
+			version: 1
+		}
+	] }
+};
+
+//#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":["KbUpdatePipelineFeature: FeatureModuleSpec"],"sources":["../src/kb-update-pipeline.feature.ts"],"sourcesContent":["import type { FeatureModuleSpec } from '@contractspec/lib.contracts';\n\nexport const KbUpdatePipelineFeature: FeatureModuleSpec = {\n  meta: {\n    key: 'kb-update-pipeline',\n    version: 1,\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 },\n    { key: 'kbPipeline.createReviewTask', version: 1 },\n    { key: 'kbPipeline.submitDecision', version: 1 },\n    { key: 'kbPipeline.publishIfReady', version: 1 },\n  ],\n  events: [\n    { key: 'kb.change.detected', version: 1 },\n    { key: 'kb.change.summarized', version: 1 },\n    { key: 'kb.patch.proposed', version: 1 },\n    { key: 'kb.review.requested', version: 1 },\n    { key: 'kb.review.decided', version: 1 },\n  ],\n  presentations: [\n    { key: 'kb.dashboard', version: 1 },\n    { key: 'kb.review.list', version: 1 },\n    { key: 'kb.review.form', version: 1 },\n  ],\n  opToPresentation: [\n    {\n      op: { key: 'kbPipeline.runWatch', version: 1 },\n      pres: { key: 'kb.dashboard', version: 1 },\n    },\n    {\n      op: { key: 'kbPipeline.createReviewTask', version: 1 },\n      pres: { key: 'kb.review.list', version: 1 },\n    },\n    {\n      op: { key: 'kbPipeline.submitDecision', version: 1 },\n      pres: { key: 'kb.review.form', version: 1 },\n    },\n  ],\n  presentationsTargets: [\n    { key: 'kb.dashboard', version: 1, targets: ['react', 'markdown'] },\n    { key: 'kb.review.list', version: 1, targets: ['react', 'markdown'] },\n    { key: 'kb.review.form', version: 1, targets: ['react'] },\n  ],\n  capabilities: {\n    requires: [\n      { key: 'identity', version: 1 },\n      { key: 'notifications', version: 1 },\n      { key: 'audit-trail', version: 1 },\n    ],\n  },\n};\n"],"mappings":";AAEA,MAAaA,0BAA6C;CACxD,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;GAAG;EAC1C;GAAE,KAAK;GAA+B,SAAS;GAAG;EAClD;GAAE,KAAK;GAA6B,SAAS;GAAG;EAChD;GAAE,KAAK;GAA6B,SAAS;GAAG;EACjD;CACD,QAAQ;EACN;GAAE,KAAK;GAAsB,SAAS;GAAG;EACzC;GAAE,KAAK;GAAwB,SAAS;GAAG;EAC3C;GAAE,KAAK;GAAqB,SAAS;GAAG;EACxC;GAAE,KAAK;GAAuB,SAAS;GAAG;EAC1C;GAAE,KAAK;GAAqB,SAAS;GAAG;EACzC;CACD,eAAe;EACb;GAAE,KAAK;GAAgB,SAAS;GAAG;EACnC;GAAE,KAAK;GAAkB,SAAS;GAAG;EACrC;GAAE,KAAK;GAAkB,SAAS;GAAG;EACtC;CACD,kBAAkB;EAChB;GACE,IAAI;IAAE,KAAK;IAAuB,SAAS;IAAG;GAC9C,MAAM;IAAE,KAAK;IAAgB,SAAS;IAAG;GAC1C;EACD;GACE,IAAI;IAAE,KAAK;IAA+B,SAAS;IAAG;GACtD,MAAM;IAAE,KAAK;IAAkB,SAAS;IAAG;GAC5C;EACD;GACE,IAAI;IAAE,KAAK;IAA6B,SAAS;IAAG;GACpD,MAAM;IAAE,KAAK;IAAkB,SAAS;IAAG;GAC5C;EACF;CACD,sBAAsB;EACpB;GAAE,KAAK;GAAgB,SAAS;GAAG,SAAS,CAAC,SAAS,WAAW;GAAE;EACnE;GAAE,KAAK;GAAkB,SAAS;GAAG,SAAS,CAAC,SAAS,WAAW;GAAE;EACrE;GAAE,KAAK;GAAkB,SAAS;GAAG,SAAS,CAAC,QAAQ;GAAE;EAC1D;CACD,cAAc,EACZ,UAAU;EACR;GAAE,KAAK;GAAY,SAAS;GAAG;EAC/B;GAAE,KAAK;GAAiB,SAAS;GAAG;EACpC;GAAE,KAAK;GAAe,SAAS;GAAG;EACnC,EACF;CACF"}

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_contracts0 from "@contractspec/lib.contracts";
+import * as _contractspec_lib_schema0 from "@contractspec/lib.schema";
+
+//#region src/operations/pipeline.d.ts
+declare const KbPipelineRunWatchContract: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{
+  jurisdiction: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema0.SchemaModel<{
+  candidates: {
+    type: _contractspec_lib_schema0.SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      sourceDocumentId: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      detectedAt: {
+        type: _contractspec_lib_schema0.FieldType<Date, string>;
+        isOptional: false;
+      };
+      diffSummary: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      riskLevel: {
+        type: _contractspec_lib_schema0.EnumType<[string, string, string]>;
+        isOptional: false;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const KbPipelineCreateReviewTaskContract: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{
+  changeCandidateId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema0.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  changeCandidateId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  assignedRole: {
+    type: _contractspec_lib_schema0.EnumType<[string, string]>;
+    isOptional: false;
+  };
+  decision: {
+    type: _contractspec_lib_schema0.EnumType<[string, string]>;
+    isOptional: true;
+  };
+  decidedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  decidedBy: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+declare const KbPipelineSubmitDecisionContract: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{
+  reviewTaskId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  decision: {
+    type: _contractspec_lib_schema0.EnumType<[string, string]>;
+    isOptional: false;
+  };
+  decidedBy: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  decidedByRole: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema0.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  changeCandidateId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  status: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  assignedRole: {
+    type: _contractspec_lib_schema0.EnumType<[string, string]>;
+    isOptional: false;
+  };
+  decision: {
+    type: _contractspec_lib_schema0.EnumType<[string, string]>;
+    isOptional: true;
+  };
+  decidedAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+  decidedBy: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+}>, undefined>;
+declare const KbPipelinePublishIfReadyContract: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{
+  jurisdiction: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+}>, _contractspec_lib_schema0.SchemaModel<{
+  published: {
+    type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+  reason: {
+    type: _contractspec_lib_schema0.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,yDAA0B,wCAAA;;UAarC,yBAAA,CAAA;;EAbW,CAAA;CAaX,CAAA,uCAAA,CAAA;;IAbqC,IAAA,uCAAA,CAAA;;cAAA,yBAAA,CAAA;;;;;;;MAAA,UAAA,EAAA;QAe1B,IAAA,qCAaX,KAAA,EAAA,MAAA,CAAA;QAAA,UAAA,EAAA,KAAA;;MAb6C,WAAA,EAAA;;;;;;;;;;IAAA,UAAA,EAAA,KAAA;EAelC,CAAA;CA8BX,CAAA,EAAA,SAAA,CAAA;cA7CW,iEAAkC,wCAAA;;UAa7C,yBAAA,CAAA;;EAE2C,CAAA;;;UAfE,yBAAA,CAAA;;;;;;;EAeF,MAAA,EAAA;IAgChC,IAAA,qCAwBX,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,KAAA;;EAxB2C,YAAA,EAAA;;;;EAAA,QAAA,EAAA;;;;;;;;;;;;;cAhChC,+DAAgC,wCAAA;;UA8B3C,yBAAA,CAAA;;;;;;;;;;;;;;;;;UA9B2C,yBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAgChC,+DAAgC,wCAAA;;UAwB3C,yBAAA,CAAA;;;;;UAxB2C,yBAAA,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,
+		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,
+		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,
+		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,
+		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,\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,\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,\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,\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 { PresentationSpec } from "@contractspec/lib.contracts";
+
+//#region src/presentations.d.ts
+declare const KbDashboardPresentation: PresentationSpec;
+declare const KbReviewListPresentation: PresentationSpec;
+declare const KbReviewFormPresentation: 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":";;;cAIa,yBAAyB;cAsBzB,0BAA0B;AAtB1B,cA4CA,wBA5CyB,EA4CC,gBAxBtC"}

package/dist/presentations.js

@@ -0,0 +1,71 @@
+import { ChangeCandidateModel, ReviewTaskModel } from "./entities/models.js";
+import { StabilityEnum } from "@contractspec/lib.contracts";
+
+//#region src/presentations.ts
+const KbDashboardPresentation = {
+	meta: {
+		key: "kb.dashboard",
+		version: 1,
+		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 = {
+	meta: {
+		key: "kb.review.list",
+		version: 1,
+		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 = {
+	meta: {
+		key: "kb.review.form",
+		version: 1,
+		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":["KbDashboardPresentation: PresentationSpec","KbReviewListPresentation: PresentationSpec","KbReviewFormPresentation: PresentationSpec"],"sources":["../src/presentations.ts"],"sourcesContent":["import { StabilityEnum } from '@contractspec/lib.contracts';\nimport type { PresentationSpec } from '@contractspec/lib.contracts';\nimport { ChangeCandidateModel, ReviewTaskModel } from './entities/models';\n\nexport const KbDashboardPresentation: PresentationSpec = {\n  meta: {\n    key: 'kb.dashboard',\n    version: 1,\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: PresentationSpec = {\n  meta: {\n    key: 'kb.review.list',\n    version: 1,\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: PresentationSpec = {\n  meta: {\n    key: 'kb.review.form',\n    version: 1,\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":";;;;AAIA,MAAaA,0BAA4C;CACvD,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;AAED,MAAaC,2BAA6C;CACxD,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;AAED,MAAaC,2BAA6C;CACxD,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"}

package/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';

package/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@contractspec/example.kb-update-pipeline",
+  "version": "1.44.0",
+  "description": "Example: KB update automation pipeline with HITL review and auditability.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/kb-update-pipeline.docblock": "./dist/docs/kb-update-pipeline.docblock.js",
+    "./entities": "./dist/entities/index.js",
+    "./entities/models": "./dist/entities/models.js",
+    "./events": "./dist/events.js",
+    "./example": "./dist/example.js",
+    "./feature": "./dist/feature.js",
+    "./handlers": "./dist/handlers/index.js",
+    "./handlers/memory.handlers": "./dist/handlers/memory.handlers.js",
+    "./kb-update-pipeline.feature": "./dist/kb-update-pipeline.feature.js",
+    "./operations": "./dist/operations/index.js",
+    "./operations/pipeline": "./dist/operations/pipeline.js",
+    "./presentations": "./dist/presentations.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "test": "bun test"
+  },
+  "dependencies": {
+    "@contractspec/lib.contracts": "1.44.0",
+    "@contractspec/lib.identity-rbac": "1.44.0",
+    "@contractspec/lib.schema": "1.44.0",
+    "@contractspec/module.notifications": "1.44.0",
+    "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.44.0",
+    "@contractspec/tool.typescript": "1.44.0",
+    "tsdown": "^0.18.3",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./contracts": "./dist/contracts/index.js",
+      "./contracts/pipeline": "./dist/contracts/pipeline.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/kb-update-pipeline.docblock": "./dist/docs/kb-update-pipeline.docblock.js",
+      "./entities": "./dist/entities/index.js",
+      "./entities/models": "./dist/entities/models.js",
+      "./events": "./dist/events.js",
+      "./example": "./dist/example.js",
+      "./feature": "./dist/feature.js",
+      "./handlers": "./dist/handlers/index.js",
+      "./handlers/memory.handlers": "./dist/handlers/memory.handlers.js",
+      "./kb-update-pipeline.feature": "./dist/kb-update-pipeline.feature.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/kb-update-pipeline"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/docs/index.ts

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