@contractspec/example.kb-update-pipeline 1.44.0

package/dist/events.js

@@ -0,0 +1,150 @@
+import { StabilityEnum, defineEvent, defineSchemaModel } from "@contractspec/lib.contracts";
+import { ScalarTypeEnum } from "@contractspec/lib.schema";
+
+//#region src/events.ts
+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
+		}
+	}
+});
+const KbChangeDetectedEvent = defineEvent({
+	meta: {
+		key: "kb.change.detected",
+		version: 1,
+		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
+		}
+	}
+});
+const KbChangeSummarizedEvent = defineEvent({
+	meta: {
+		key: "kb.change.summarized",
+		version: 1,
+		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
+		}
+	}
+});
+const KbPatchProposedEvent = defineEvent({
+	meta: {
+		key: "kb.patch.proposed",
+		version: 1,
+		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
+		}
+	}
+});
+const KbReviewRequestedEvent = defineEvent({
+	meta: {
+		key: "kb.review.requested",
+		version: 1,
+		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
+		}
+	}
+});
+const KbReviewDecidedEvent = defineEvent({
+	meta: {
+		key: "kb.review.decided",
+		version: 1,
+		description: "KB review decided.",
+		stability: StabilityEnum.Experimental,
+		owners: [],
+		tags: []
+	},
+	payload: KbReviewDecidedPayload
+});
+
+//#endregion
+export { KbChangeDetectedEvent, KbChangeSummarizedEvent, KbPatchProposedEvent, KbReviewDecidedEvent, KbReviewRequestedEvent };
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","names":[],"sources":["../src/events.ts"],"sourcesContent":["import {\n  defineEvent,\n  defineSchemaModel,\n  StabilityEnum,\n} from '@contractspec/lib.contracts';\nimport { ScalarTypeEnum } from '@contractspec/lib.schema';\n\nconst KbChangeDetectedPayload = defineSchemaModel({\n  name: 'KbChangeDetectedPayload',\n  description: 'Emitted when a source change is detected.',\n  fields: {\n    changeCandidateId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    sourceDocumentId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    riskLevel: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const KbChangeDetectedEvent = defineEvent({\n  meta: {\n    key: 'kb.change.detected',\n    version: 1,\n    description: 'KB source change detected.',\n    stability: StabilityEnum.Experimental,\n    owners: [],\n    tags: [],\n  },\n  payload: KbChangeDetectedPayload,\n});\n\nconst KbChangeSummarizedPayload = defineSchemaModel({\n  name: 'KbChangeSummarizedPayload',\n  description: 'Emitted when a change summary is produced.',\n  fields: {\n    changeCandidateId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    summary: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    riskLevel: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const KbChangeSummarizedEvent = defineEvent({\n  meta: {\n    key: 'kb.change.summarized',\n    version: 1,\n    description: 'KB change summarized.',\n    stability: StabilityEnum.Experimental,\n    owners: [],\n    tags: [],\n  },\n  payload: KbChangeSummarizedPayload,\n});\n\nconst KbPatchProposedPayload = defineSchemaModel({\n  name: 'KbPatchProposedPayload',\n  description: 'Emitted when draft rule patches are proposed.',\n  fields: {\n    changeCandidateId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    proposedRuleVersionIds: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isArray: true,\n      isOptional: false,\n    },\n  },\n});\n\nexport const KbPatchProposedEvent = defineEvent({\n  meta: {\n    key: 'kb.patch.proposed',\n    version: 1,\n    description: 'KB rule patch proposed (draft versions created).',\n    stability: StabilityEnum.Experimental,\n    owners: [],\n    tags: [],\n  },\n  payload: KbPatchProposedPayload,\n});\n\nconst KbReviewRequestedPayload = defineSchemaModel({\n  name: 'KbReviewRequestedPayload',\n  description: 'Emitted when a review is requested.',\n  fields: {\n    reviewTaskId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    changeCandidateId: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    assignedRole: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const KbReviewRequestedEvent = defineEvent({\n  meta: {\n    key: 'kb.review.requested',\n    version: 1,\n    description: 'KB review requested.',\n    stability: StabilityEnum.Experimental,\n    owners: [],\n    tags: [],\n  },\n  payload: KbReviewRequestedPayload,\n});\n\nconst KbReviewDecidedPayload = defineSchemaModel({\n  name: 'KbReviewDecidedPayload',\n  description: 'Emitted when a review task is decided.',\n  fields: {\n    reviewTaskId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    decision: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    decidedBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nexport const KbReviewDecidedEvent = defineEvent({\n  meta: {\n    key: 'kb.review.decided',\n    version: 1,\n    description: 'KB review decided.',\n    stability: StabilityEnum.Experimental,\n    owners: [],\n    tags: [],\n  },\n  payload: KbReviewDecidedPayload,\n});\n"],"mappings":";;;;AAOA,MAAM,0BAA0B,kBAAkB;CAChD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,mBAAmB;GACjB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,kBAAkB;GAChB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,WAAW;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACzE;CACF,CAAC;AAEF,MAAa,wBAAwB,YAAY;CAC/C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW,cAAc;EACzB,QAAQ,EAAE;EACV,MAAM,EAAE;EACT;CACD,SAAS;CACV,CAAC;AAEF,MAAM,4BAA4B,kBAAkB;CAClD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,mBAAmB;GACjB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,SAAS;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACtE,WAAW;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACzE;CACF,CAAC;AAEF,MAAa,0BAA0B,YAAY;CACjD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW,cAAc;EACzB,QAAQ,EAAE;EACV,MAAM,EAAE;EACT;CACD,SAAS;CACV,CAAC;AAEF,MAAM,yBAAyB,kBAAkB;CAC/C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,mBAAmB;GACjB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,wBAAwB;GACtB,MAAM,eAAe,iBAAiB;GACtC,SAAS;GACT,YAAY;GACb;EACF;CACF,CAAC;AAEF,MAAa,uBAAuB,YAAY;CAC9C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW,cAAc;EACzB,QAAQ,EAAE;EACV,MAAM,EAAE;EACT;CACD,SAAS;CACV,CAAC;AAEF,MAAM,2BAA2B,kBAAkB;CACjD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,mBAAmB;GACjB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC5E;CACF,CAAC;AAEF,MAAa,yBAAyB,YAAY;CAChD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW,cAAc;EACzB,QAAQ,EAAE;EACV,MAAM,EAAE;EACT;CACD,SAAS;CACV,CAAC;AAEF,MAAM,yBAAyB,kBAAkB;CAC/C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EAC3E,UAAU;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACvE,WAAW;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACzE;CACF,CAAC;AAEF,MAAa,uBAAuB,YAAY;CAC9C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,WAAW,cAAc;EACzB,QAAQ,EAAE;EACV,MAAM,EAAE;EACT;CACD,SAAS;CACV,CAAC"}

package/dist/example.d.ts

@@ -0,0 +1,36 @@
+//#region src/example.d.ts
+declare const example: {
+  readonly id: "kb-update-pipeline";
+  readonly title: "KB Update Pipeline";
+  readonly summary: "Automation proposes KB updates; humans verify; everything audited and notified.";
+  readonly tags: readonly ["knowledge", "pipeline", "hitl", "audit"];
+  readonly kind: "knowledge";
+  readonly visibility: "public";
+  readonly docs: {
+    readonly rootDocId: "docs.examples.kb-update-pipeline";
+  };
+  readonly entrypoints: {
+    readonly packageName: "@contractspec/example.kb-update-pipeline";
+    readonly feature: "./feature";
+    readonly contracts: "./contracts";
+    readonly handlers: "./handlers";
+    readonly docs: "./docs";
+  };
+  readonly surfaces: {
+    readonly templates: true;
+    readonly sandbox: {
+      readonly enabled: true;
+      readonly modes: readonly ["markdown", "specs", "builder"];
+    };
+    readonly studio: {
+      readonly enabled: true;
+      readonly installable: true;
+    };
+    readonly mcp: {
+      readonly enabled: true;
+    };
+  };
+};
+//#endregion
+export { example as default };
+//# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EAwBI,EAAA,oBAAA"}

package/dist/example.js

@@ -0,0 +1,43 @@
+//#region src/example.ts
+const example = {
+	id: "kb-update-pipeline",
+	title: "KB Update Pipeline",
+	summary: "Automation proposes KB updates; humans verify; everything audited and notified.",
+	tags: [
+		"knowledge",
+		"pipeline",
+		"hitl",
+		"audit"
+	],
+	kind: "knowledge",
+	visibility: "public",
+	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 }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };
+//# sourceMappingURL=example.js.map

package/dist/example.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'kb-update-pipeline',\n  title: 'KB Update Pipeline',\n  summary:\n    'Automation proposes KB updates; humans verify; everything audited and notified.',\n  tags: ['knowledge', 'pipeline', 'hitl', 'audit'],\n  kind: 'knowledge',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.examples.kb-update-pipeline',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.kb-update-pipeline',\n    feature: './feature',\n    contracts: './contracts',\n    handlers: './handlers',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs', 'builder'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAa;EAAY;EAAQ;EAAQ;CAChD,MAAM;CACN,YAAY;CACZ,MAAM,EACJ,WAAW,oCACZ;CACD,aAAa;EACX,aAAa;EACb,SAAS;EACT,WAAW;EACX,UAAU;EACV,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO;IAAC;IAAY;IAAS;IAAU;GAAE;EACnE,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/feature.d.ts

@@ -0,0 +1,7 @@
+import { FeatureModuleSpec } from "@contractspec/lib.contracts";
+
+//#region src/feature.d.ts
+declare const KbUpdatePipelineFeature: FeatureModuleSpec;
+//#endregion
+export { KbUpdatePipelineFeature };
+//# sourceMappingURL=feature.d.ts.map

package/dist/feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.d.ts","names":[],"sources":["../src/feature.ts"],"sourcesContent":[],"mappings":";;;cAEa,yBAAyB"}

package/dist/feature.js

@@ -0,0 +1,80 @@
+//#region src/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: [],
+	opToPresentation: [],
+	presentationsTargets: [],
+	capabilities: { requires: [
+		{
+			key: "identity",
+			version: 1
+		},
+		{
+			key: "notifications",
+			version: 1
+		},
+		{
+			key: "audit-trail",
+			version: 1
+		}
+	] }
+};
+
+//#endregion
+export { KbUpdatePipelineFeature };
+//# sourceMappingURL=feature.js.map

package/dist/feature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature.js","names":["KbUpdatePipelineFeature: FeatureModuleSpec"],"sources":["../src/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  opToPresentation: [],\n  presentationsTargets: [],\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,EAAE;CACjB,kBAAkB,EAAE;CACpB,sBAAsB,EAAE;CACxB,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/handlers/index.d.ts

@@ -0,0 +1,2 @@
+import { PipelineMemoryHandlers, PipelineMemoryStore, createPipelineMemoryHandlers, createPipelineMemoryStore } from "./memory.handlers.js";
+export { PipelineMemoryHandlers, PipelineMemoryStore, createPipelineMemoryHandlers, createPipelineMemoryStore };

package/dist/handlers/index.js

@@ -0,0 +1,3 @@
+import { createPipelineMemoryHandlers, createPipelineMemoryStore } from "./memory.handlers.js";
+
+export { createPipelineMemoryHandlers, createPipelineMemoryStore };

package/dist/handlers/memory.handlers.d.ts

@@ -0,0 +1,68 @@
+//#region src/handlers/memory.handlers.d.ts
+interface ChangeCandidate {
+  id: string;
+  sourceDocumentId: string;
+  detectedAt: Date;
+  diffSummary: string;
+  riskLevel: 'low' | 'medium' | 'high';
+}
+interface ReviewTask {
+  id: string;
+  changeCandidateId: string;
+  status: 'open' | 'decided';
+  assignedRole: 'curator' | 'expert';
+  decision?: 'approve' | 'reject';
+  decidedAt?: Date;
+  decidedBy?: string;
+}
+interface PipelineMemoryStore {
+  candidates: Map<string, ChangeCandidate>;
+  reviewTasks: Map<string, ReviewTask>;
+  proposedRuleVersionIdsByCandidate: Map<string, string[]>;
+  approvedRuleVersionIds: Set<string>;
+  notifications: {
+    kind: 'kb.review.requested';
+    reviewTaskId: string;
+    changeCandidateId: string;
+    assignedRole: 'curator' | 'expert';
+    createdAt: Date;
+  }[];
+}
+declare function createPipelineMemoryStore(): PipelineMemoryStore;
+interface PipelineMemoryHandlers {
+  runWatch(input: {
+    jurisdiction: string;
+  }): Promise<{
+    candidates: ChangeCandidate[];
+  }>;
+  createReviewTask(input: {
+    changeCandidateId: string;
+  }): Promise<ReviewTask>;
+  proposeRulePatch(input: {
+    changeCandidateId: string;
+    proposedRuleVersionIds: string[];
+  }): Promise<{
+    proposedRuleVersionIds: string[];
+  }>;
+  markRuleVersionApproved(input: {
+    ruleVersionId: string;
+  }): Promise<{
+    ruleVersionId: string;
+  }>;
+  submitDecision(input: {
+    reviewTaskId: string;
+    decision: 'approve' | 'reject';
+    decidedBy: string;
+    decidedByRole: 'curator' | 'expert';
+  }): Promise<ReviewTask>;
+  publishIfReady(input: {
+    jurisdiction: string;
+  }): Promise<{
+    published: boolean;
+    reason?: string;
+  }>;
+}
+declare function createPipelineMemoryHandlers(store: PipelineMemoryStore): PipelineMemoryHandlers;
+//#endregion
+export { PipelineMemoryHandlers, PipelineMemoryStore, createPipelineMemoryHandlers, createPipelineMemoryStore };
+//# sourceMappingURL=memory.handlers.d.ts.map

package/dist/handlers/memory.handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.handlers.d.ts","names":[],"sources":["../../src/handlers/memory.handlers.ts"],"sourcesContent":[],"mappings":";UAAU,eAAA;EAAA,EAAA,EAAA,MAAA;EAQA,gBAAU,EAAA,MAAA;EAUH,UAAA,EAfH,IAeG;EACS,WAAA,EAAA,MAAA;EAAZ,SAAA,EAAA,KAAA,GAAA,QAAA,GAAA,MAAA;;UAXJ,UAAA,CAYK;EACsB,EAAA,EAAA,MAAA;EACX,iBAAA,EAAA,MAAA;EAMX,MAAA,EAAA,MAAA,GAAA,SAAA;EAAI,YAAA,EAAA,SAAA,GAAA,QAAA;EAIH,QAAA,CAAA,EAAA,SAAA,GAAA,QAAyB;EAcxB,SAAA,CAAA,EAhCH,IAgCG;EAGW,SAAA,CAAA,EAAA,MAAA;;AACsC,UAhCjD,mBAAA,CAgCiD;EAAR,UAAA,EA/B5C,GA+B4C,CAAA,MAAA,EA/BhC,eA+BgC,CAAA;EAIpD,WAAA,EAlCS,GAkCT,CAAA,MAAA,EAlCqB,UAkCrB,CAAA;EAGA,iCAAA,EApC+B,GAoC/B,CAAA,MAAA,EAAA,MAAA,EAAA,CAAA;EAMQ,sBAAA,EAzCY,GAyCZ,CAAA,MAAA,CAAA;EAAR,aAAA,EAAA;IAGA,IAAA,EAAA,qBAAA;IAAO,YAAA,EAAA,MAAA;IAGG,iBAAA,EAAA,MAAA;;eAzCD;;;iBAIC,yBAAA,CAAA,GAA6B;UAc5B,sBAAA;;;MAGX;gBAAsB;;;;MAC8B,QAAQ;;;;MAI5D;;;;;MAGA;;;;;;;;MAMA,QAAQ;;;MAGR;;;;;iBAGU,4BAAA,QACP,sBACN"}

package/dist/handlers/memory.handlers.js

@@ -0,0 +1,93 @@
+//#region src/handlers/memory.handlers.ts
+function createPipelineMemoryStore() {
+	return {
+		candidates: /* @__PURE__ */ new Map(),
+		reviewTasks: /* @__PURE__ */ new Map(),
+		proposedRuleVersionIdsByCandidate: /* @__PURE__ */ new Map(),
+		approvedRuleVersionIds: /* @__PURE__ */ new Set(),
+		notifications: []
+	};
+}
+function stableId(prefix, value) {
+	return `${prefix}_${value.replace(/[^a-zA-Z0-9_-]/g, "_")}`;
+}
+function createPipelineMemoryHandlers(store) {
+	async function runWatch(input) {
+		return { candidates: [...store.candidates.values()].filter((c) => c.sourceDocumentId.startsWith(`${input.jurisdiction}_`) || true) };
+	}
+	async function createReviewTask(input) {
+		const candidate = store.candidates.get(input.changeCandidateId);
+		if (!candidate) throw new Error("CHANGE_CANDIDATE_NOT_FOUND");
+		const assignedRole = candidate.riskLevel === "high" ? "expert" : "curator";
+		const id = stableId("review", input.changeCandidateId);
+		const task = {
+			id,
+			changeCandidateId: input.changeCandidateId,
+			status: "open",
+			assignedRole,
+			decision: void 0,
+			decidedAt: void 0,
+			decidedBy: void 0
+		};
+		store.reviewTasks.set(id, task);
+		store.notifications.push({
+			kind: "kb.review.requested",
+			reviewTaskId: id,
+			changeCandidateId: input.changeCandidateId,
+			assignedRole,
+			createdAt: /* @__PURE__ */ new Date()
+		});
+		return task;
+	}
+	async function proposeRulePatch(input) {
+		if (!store.candidates.has(input.changeCandidateId)) throw new Error("CHANGE_CANDIDATE_NOT_FOUND");
+		store.proposedRuleVersionIdsByCandidate.set(input.changeCandidateId, [...input.proposedRuleVersionIds]);
+		return { proposedRuleVersionIds: [...input.proposedRuleVersionIds] };
+	}
+	async function markRuleVersionApproved(input) {
+		store.approvedRuleVersionIds.add(input.ruleVersionId);
+		return { ruleVersionId: input.ruleVersionId };
+	}
+	async function submitDecision(input) {
+		const task = store.reviewTasks.get(input.reviewTaskId);
+		if (!task) throw new Error("REVIEW_TASK_NOT_FOUND");
+		const candidate = store.candidates.get(task.changeCandidateId);
+		if (!candidate) throw new Error("CHANGE_CANDIDATE_NOT_FOUND");
+		if (candidate.riskLevel === "high" && input.decision === "approve") {
+			if (input.decidedByRole !== "expert") throw new Error("FORBIDDEN_ROLE");
+		}
+		const decided = {
+			...task,
+			status: "decided",
+			decision: input.decision,
+			decidedAt: /* @__PURE__ */ new Date(),
+			decidedBy: input.decidedBy
+		};
+		store.reviewTasks.set(decided.id, decided);
+		return decided;
+	}
+	async function publishIfReady(_input) {
+		if ([...store.reviewTasks.values()].filter((t) => t.status !== "decided").length) throw new Error("NOT_READY");
+		if ([...store.reviewTasks.values()].some((t) => t.decision === "reject")) return {
+			published: false,
+			reason: "REJECTED"
+		};
+		for (const task of store.reviewTasks.values()) {
+			if (task.decision !== "approve") continue;
+			if ((store.proposedRuleVersionIdsByCandidate.get(task.changeCandidateId) ?? []).filter((id) => !store.approvedRuleVersionIds.has(id)).length) throw new Error("NOT_READY");
+		}
+		return { published: true };
+	}
+	return {
+		runWatch,
+		createReviewTask,
+		proposeRulePatch,
+		markRuleVersionApproved,
+		submitDecision,
+		publishIfReady
+	};
+}
+
+//#endregion
+export { createPipelineMemoryHandlers, createPipelineMemoryStore };
+//# sourceMappingURL=memory.handlers.js.map

package/dist/handlers/memory.handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.handlers.js","names":["task: ReviewTask","decided: ReviewTask"],"sources":["../../src/handlers/memory.handlers.ts"],"sourcesContent":["interface ChangeCandidate {\n  id: string;\n  sourceDocumentId: string;\n  detectedAt: Date;\n  diffSummary: string;\n  riskLevel: 'low' | 'medium' | 'high';\n}\n\ninterface ReviewTask {\n  id: string;\n  changeCandidateId: string;\n  status: 'open' | 'decided';\n  assignedRole: 'curator' | 'expert';\n  decision?: 'approve' | 'reject';\n  decidedAt?: Date;\n  decidedBy?: string;\n}\n\nexport interface PipelineMemoryStore {\n  candidates: Map<string, ChangeCandidate>;\n  reviewTasks: Map<string, ReviewTask>;\n  proposedRuleVersionIdsByCandidate: Map<string, string[]>;\n  approvedRuleVersionIds: Set<string>;\n  notifications: {\n    kind: 'kb.review.requested';\n    reviewTaskId: string;\n    changeCandidateId: string;\n    assignedRole: 'curator' | 'expert';\n    createdAt: Date;\n  }[];\n}\n\nexport function createPipelineMemoryStore(): PipelineMemoryStore {\n  return {\n    candidates: new Map(),\n    reviewTasks: new Map(),\n    proposedRuleVersionIdsByCandidate: new Map(),\n    approvedRuleVersionIds: new Set(),\n    notifications: [],\n  };\n}\n\nfunction stableId(prefix: string, value: string): string {\n  return `${prefix}_${value.replace(/[^a-zA-Z0-9_-]/g, '_')}`;\n}\n\nexport interface PipelineMemoryHandlers {\n  runWatch(input: {\n    jurisdiction: string;\n  }): Promise<{ candidates: ChangeCandidate[] }>;\n  createReviewTask(input: { changeCandidateId: string }): Promise<ReviewTask>;\n  proposeRulePatch(input: {\n    changeCandidateId: string;\n    proposedRuleVersionIds: string[];\n  }): Promise<{ proposedRuleVersionIds: string[] }>;\n  markRuleVersionApproved(input: {\n    ruleVersionId: string;\n  }): Promise<{ ruleVersionId: string }>;\n  submitDecision(input: {\n    reviewTaskId: string;\n    decision: 'approve' | 'reject';\n    decidedBy: string;\n    decidedByRole: 'curator' | 'expert';\n  }): Promise<ReviewTask>;\n  publishIfReady(input: {\n    jurisdiction: string;\n  }): Promise<{ published: boolean; reason?: string }>;\n}\n\nexport function createPipelineMemoryHandlers(\n  store: PipelineMemoryStore\n): PipelineMemoryHandlers {\n  async function runWatch(input: { jurisdiction: string }) {\n    // demo: always returns empty unless caller pre-seeds candidates\n    const candidates = [...store.candidates.values()].filter(\n      (c) => c.sourceDocumentId.startsWith(`${input.jurisdiction}_`) || true\n    );\n    return { candidates };\n  }\n\n  async function createReviewTask(input: { changeCandidateId: string }) {\n    const candidate = store.candidates.get(input.changeCandidateId);\n    if (!candidate) throw new Error('CHANGE_CANDIDATE_NOT_FOUND');\n    const assignedRole = candidate.riskLevel === 'high' ? 'expert' : 'curator';\n    const id = stableId('review', input.changeCandidateId);\n    const task: ReviewTask = {\n      id,\n      changeCandidateId: input.changeCandidateId,\n      status: 'open',\n      assignedRole,\n      decision: undefined,\n      decidedAt: undefined,\n      decidedBy: undefined,\n    };\n    store.reviewTasks.set(id, task);\n    store.notifications.push({\n      kind: 'kb.review.requested',\n      reviewTaskId: id,\n      changeCandidateId: input.changeCandidateId,\n      assignedRole,\n      createdAt: new Date(),\n    });\n    return task;\n  }\n\n  async function proposeRulePatch(input: {\n    changeCandidateId: string;\n    proposedRuleVersionIds: string[];\n  }): Promise<{ proposedRuleVersionIds: string[] }> {\n    if (!store.candidates.has(input.changeCandidateId)) {\n      throw new Error('CHANGE_CANDIDATE_NOT_FOUND');\n    }\n    store.proposedRuleVersionIdsByCandidate.set(input.changeCandidateId, [\n      ...input.proposedRuleVersionIds,\n    ]);\n    return { proposedRuleVersionIds: [...input.proposedRuleVersionIds] };\n  }\n\n  async function markRuleVersionApproved(input: {\n    ruleVersionId: string;\n  }): Promise<{ ruleVersionId: string }> {\n    store.approvedRuleVersionIds.add(input.ruleVersionId);\n    return { ruleVersionId: input.ruleVersionId };\n  }\n\n  async function submitDecision(input: {\n    reviewTaskId: string;\n    decision: 'approve' | 'reject';\n    decidedBy: string;\n    decidedByRole: 'curator' | 'expert';\n  }) {\n    const task = store.reviewTasks.get(input.reviewTaskId);\n    if (!task) throw new Error('REVIEW_TASK_NOT_FOUND');\n    const candidate = store.candidates.get(task.changeCandidateId);\n    if (!candidate) throw new Error('CHANGE_CANDIDATE_NOT_FOUND');\n    if (candidate.riskLevel === 'high' && input.decision === 'approve') {\n      if (input.decidedByRole !== 'expert') throw new Error('FORBIDDEN_ROLE');\n    }\n    const decided: ReviewTask = {\n      ...task,\n      status: 'decided',\n      decision: input.decision,\n      decidedAt: new Date(),\n      decidedBy: input.decidedBy,\n    };\n    store.reviewTasks.set(decided.id, decided);\n    return decided;\n  }\n\n  async function publishIfReady(_input: { jurisdiction: string }) {\n    const openTasks = [...store.reviewTasks.values()].filter(\n      (t) => t.status !== 'decided'\n    );\n    if (openTasks.length) {\n      throw new Error('NOT_READY');\n    }\n    const rejected = [...store.reviewTasks.values()].some(\n      (t) => t.decision === 'reject'\n    );\n    if (rejected) return { published: false, reason: 'REJECTED' };\n\n    // Ensure every proposed rule version is approved before publishing.\n    for (const task of store.reviewTasks.values()) {\n      if (task.decision !== 'approve') continue;\n      const proposed =\n        store.proposedRuleVersionIdsByCandidate.get(task.changeCandidateId) ??\n        [];\n      const unapproved = proposed.filter(\n        (id) => !store.approvedRuleVersionIds.has(id)\n      );\n      if (unapproved.length) {\n        throw new Error('NOT_READY');\n      }\n    }\n    return { published: true };\n  }\n\n  return {\n    runWatch,\n    createReviewTask,\n    proposeRulePatch,\n    markRuleVersionApproved,\n    submitDecision,\n    publishIfReady,\n  };\n}\n"],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { ChangeCandidateModel, ChangeRiskLevelEnum, ReviewAssignedRoleEnum, ReviewDecisionEnum, ReviewTaskModel } from "./entities/models.js";
+import "./entities/index.js";
+import { KbChangeDetectedEvent, KbChangeSummarizedEvent, KbPatchProposedEvent, KbReviewDecidedEvent, KbReviewRequestedEvent } from "./events.js";
+import example from "./example.js";
+import { PipelineMemoryHandlers, PipelineMemoryStore, createPipelineMemoryHandlers, createPipelineMemoryStore } from "./handlers/memory.handlers.js";
+import { KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract } from "./operations/pipeline.js";
+import "./operations/index.js";
+import { KbUpdatePipelineFeature } from "./kb-update-pipeline.feature.js";
+import { KbDashboardPresentation, KbReviewFormPresentation, KbReviewListPresentation } from "./presentations.js";
+export { ChangeCandidateModel, ChangeRiskLevelEnum, KbChangeDetectedEvent, KbChangeSummarizedEvent, KbDashboardPresentation, KbPatchProposedEvent, KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract, KbReviewDecidedEvent, KbReviewFormPresentation, KbReviewListPresentation, KbReviewRequestedEvent, KbUpdatePipelineFeature, PipelineMemoryHandlers, PipelineMemoryStore, ReviewAssignedRoleEnum, ReviewDecisionEnum, ReviewTaskModel, createPipelineMemoryHandlers, createPipelineMemoryStore, example };

package/dist/index.js

@@ -0,0 +1,12 @@
+import { KbChangeDetectedEvent, KbChangeSummarizedEvent, KbPatchProposedEvent, KbReviewDecidedEvent, KbReviewRequestedEvent } from "./events.js";
+import example_default from "./example.js";
+import { ChangeCandidateModel, ChangeRiskLevelEnum, ReviewAssignedRoleEnum, ReviewDecisionEnum, ReviewTaskModel } from "./entities/models.js";
+import "./entities/index.js";
+import { KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract } from "./operations/pipeline.js";
+import "./operations/index.js";
+import { createPipelineMemoryHandlers, createPipelineMemoryStore } from "./handlers/memory.handlers.js";
+import { KbUpdatePipelineFeature } from "./kb-update-pipeline.feature.js";
+import { KbDashboardPresentation, KbReviewFormPresentation, KbReviewListPresentation } from "./presentations.js";
+import "./docs/index.js";
+
+export { ChangeCandidateModel, ChangeRiskLevelEnum, KbChangeDetectedEvent, KbChangeSummarizedEvent, KbDashboardPresentation, KbPatchProposedEvent, KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract, KbReviewDecidedEvent, KbReviewFormPresentation, KbReviewListPresentation, KbReviewRequestedEvent, KbUpdatePipelineFeature, ReviewAssignedRoleEnum, ReviewDecisionEnum, ReviewTaskModel, createPipelineMemoryHandlers, createPipelineMemoryStore, example_default as example };

package/dist/kb-update-pipeline.feature.d.ts

@@ -0,0 +1,7 @@
+import { FeatureModuleSpec } from "@contractspec/lib.contracts";
+
+//#region src/kb-update-pipeline.feature.d.ts
+declare const KbUpdatePipelineFeature: FeatureModuleSpec;
+//#endregion
+export { KbUpdatePipelineFeature };
+//# sourceMappingURL=kb-update-pipeline.feature.d.ts.map

package/dist/kb-update-pipeline.feature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb-update-pipeline.feature.d.ts","names":[],"sources":["../src/kb-update-pipeline.feature.ts"],"sourcesContent":[],"mappings":";;;cAEa,yBAAyB"}