@lssm/example.kb-update-pipeline 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

package/dist/events.js

@@ -1 +1,127 @@
-import{defineEvent as e,defineSchemaModel as t}from"@lssm/lib.contracts";import{ScalarTypeEnum as n}from"@lssm/lib.schema";const r=e({name:`kb.change.detected`,version:1,description:`KB source change detected.`,payload:t({name:`KbChangeDetectedPayload`,description:`Emitted when a source change is detected.`,fields:{changeCandidateId:{type:n.String_unsecure(),isOptional:!1},sourceDocumentId:{type:n.String_unsecure(),isOptional:!1},riskLevel:{type:n.String_unsecure(),isOptional:!1}}})}),i=e({name:`kb.change.summarized`,version:1,description:`KB change summarized.`,payload:t({name:`KbChangeSummarizedPayload`,description:`Emitted when a change summary is produced.`,fields:{changeCandidateId:{type:n.String_unsecure(),isOptional:!1},summary:{type:n.String_unsecure(),isOptional:!1},riskLevel:{type:n.String_unsecure(),isOptional:!1}}})}),a=e({name:`kb.patch.proposed`,version:1,description:`KB rule patch proposed (draft versions created).`,payload:t({name:`KbPatchProposedPayload`,description:`Emitted when draft rule patches are proposed.`,fields:{changeCandidateId:{type:n.String_unsecure(),isOptional:!1},proposedRuleVersionIds:{type:n.String_unsecure(),isArray:!0,isOptional:!1}}})}),o=e({name:`kb.review.requested`,version:1,description:`KB review requested.`,payload:t({name:`KbReviewRequestedPayload`,description:`Emitted when a review is requested.`,fields:{reviewTaskId:{type:n.String_unsecure(),isOptional:!1},changeCandidateId:{type:n.String_unsecure(),isOptional:!1},assignedRole:{type:n.String_unsecure(),isOptional:!1}}})}),s=e({name:`kb.review.decided`,version:1,description:`KB review decided.`,payload:t({name:`KbReviewDecidedPayload`,description:`Emitted when a review task is decided.`,fields:{reviewTaskId:{type:n.String_unsecure(),isOptional:!1},decision:{type:n.String_unsecure(),isOptional:!1},decidedBy:{type:n.String_unsecure(),isOptional:!1}}})});export{r as KbChangeDetectedEvent,i as KbChangeSummarizedEvent,a as KbPatchProposedEvent,s as KbReviewDecidedEvent,o as KbReviewRequestedEvent};
+import { defineSchemaModel } from "./libs/contracts/dist/schema/dist/SchemaModel.js";
+import { defineEvent } from "./libs/contracts/dist/events.js";
+import "./libs/contracts/dist/index.js";
+import { ScalarTypeEnum } from "./libs/schema/dist/ScalarTypeEnum.js";
+import "./libs/schema/dist/index.js";
+
+//#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({
+	name: "kb.change.detected",
+	version: 1,
+	description: "KB source change detected.",
+	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({
+	name: "kb.change.summarized",
+	version: 1,
+	description: "KB change summarized.",
+	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({
+	name: "kb.patch.proposed",
+	version: 1,
+	description: "KB rule patch proposed (draft versions created).",
+	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({
+	name: "kb.review.requested",
+	version: 1,
+	description: "KB review requested.",
+	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({
+	name: "kb.review.decided",
+	version: 1,
+	description: "KB review decided.",
+	payload: KbReviewDecidedPayload
+});
+
+//#endregion
+export { KbChangeDetectedEvent, KbChangeSummarizedEvent, KbPatchProposedEvent, KbReviewDecidedEvent, KbReviewRequestedEvent };

package/dist/example.js

@@ -1 +1,42 @@
-var e={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:`@lssm/example.kb-update-pipeline`,feature:`./feature`,contracts:`./contracts`,handlers:`./handlers`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`markdown`,`specs`,`builder`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};
+//#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: "@lssm/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 };

package/dist/feature.js

@@ -1 +1,78 @@
-const e={meta:{key:`kb-update-pipeline`,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:[{name:`kbPipeline.runWatch`,version:1},{name:`kbPipeline.createReviewTask`,version:1},{name:`kbPipeline.submitDecision`,version:1},{name:`kbPipeline.publishIfReady`,version:1}],events:[{name:`kb.change.detected`,version:1},{name:`kb.change.summarized`,version:1},{name:`kb.patch.proposed`,version:1},{name:`kb.review.requested`,version:1},{name:`kb.review.decided`,version:1}],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{requires:[{key:`identity`,version:1},{key:`notifications`,version:1},{key:`audit-trail`,version:1}]}};export{e as KbUpdatePipelineFeature};
+//#region src/feature.ts
+const KbUpdatePipelineFeature = {
+	meta: {
+		key: "kb-update-pipeline",
+		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: [
+		{
+			name: "kbPipeline.runWatch",
+			version: 1
+		},
+		{
+			name: "kbPipeline.createReviewTask",
+			version: 1
+		},
+		{
+			name: "kbPipeline.submitDecision",
+			version: 1
+		},
+		{
+			name: "kbPipeline.publishIfReady",
+			version: 1
+		}
+	],
+	events: [
+		{
+			name: "kb.change.detected",
+			version: 1
+		},
+		{
+			name: "kb.change.summarized",
+			version: 1
+		},
+		{
+			name: "kb.patch.proposed",
+			version: 1
+		},
+		{
+			name: "kb.review.requested",
+			version: 1
+		},
+		{
+			name: "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 };

package/dist/handlers/index.js

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

package/dist/handlers/memory.handlers.js

@@ -1 +1,92 @@
-function e(){return{candidates:new Map,reviewTasks:new Map,proposedRuleVersionIdsByCandidate:new Map,approvedRuleVersionIds:new Set,notifications:[]}}function t(e,t){return`${e}_${t.replace(/[^a-zA-Z0-9_-]/g,`_`)}`}function n(e){async function n(t){return{candidates:[...e.candidates.values()].filter(e=>e.sourceDocumentId.startsWith(`${t.jurisdiction}_`)||!0)}}async function r(n){let r=e.candidates.get(n.changeCandidateId);if(!r)throw Error(`CHANGE_CANDIDATE_NOT_FOUND`);let i=r.riskLevel===`high`?`expert`:`curator`,a=t(`review`,n.changeCandidateId),o={id:a,changeCandidateId:n.changeCandidateId,status:`open`,assignedRole:i,decision:void 0,decidedAt:void 0,decidedBy:void 0};return e.reviewTasks.set(a,o),e.notifications.push({kind:`kb.review.requested`,reviewTaskId:a,changeCandidateId:n.changeCandidateId,assignedRole:i,createdAt:new Date}),o}async function i(t){if(!e.candidates.has(t.changeCandidateId))throw Error(`CHANGE_CANDIDATE_NOT_FOUND`);return e.proposedRuleVersionIdsByCandidate.set(t.changeCandidateId,[...t.proposedRuleVersionIds]),{proposedRuleVersionIds:[...t.proposedRuleVersionIds]}}async function a(t){return e.approvedRuleVersionIds.add(t.ruleVersionId),{ruleVersionId:t.ruleVersionId}}async function o(t){let n=e.reviewTasks.get(t.reviewTaskId);if(!n)throw Error(`REVIEW_TASK_NOT_FOUND`);let r=e.candidates.get(n.changeCandidateId);if(!r)throw Error(`CHANGE_CANDIDATE_NOT_FOUND`);if(r.riskLevel===`high`&&t.decision===`approve`&&t.decidedByRole!==`expert`)throw Error(`FORBIDDEN_ROLE`);let i={...n,status:`decided`,decision:t.decision,decidedAt:new Date,decidedBy:t.decidedBy};return e.reviewTasks.set(i.id,i),i}async function s(t){if([...e.reviewTasks.values()].filter(e=>e.status!==`decided`).length)throw Error(`NOT_READY`);if([...e.reviewTasks.values()].some(e=>e.decision===`reject`))return{published:!1,reason:`REJECTED`};for(let t of e.reviewTasks.values())if(t.decision===`approve`&&(e.proposedRuleVersionIdsByCandidate.get(t.changeCandidateId)??[]).filter(t=>!e.approvedRuleVersionIds.has(t)).length)throw Error(`NOT_READY`);return{published:!0}}return{runWatch:n,createReviewTask:r,proposeRulePatch:i,markRuleVersionApproved:a,submitDecision:o,publishIfReady:s}}export{n as createPipelineMemoryHandlers,e as createPipelineMemoryStore};
+//#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 };

package/dist/index.d.ts

@@ -1,7 +1,5 @@
 import { KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract } from "./contracts/pipeline.js";
-import "./contracts/index.js";
 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";

package/dist/index.js

@@ -1 +1,11 @@
-import{KbChangeDetectedEvent as e,KbChangeSummarizedEvent as t,KbPatchProposedEvent as n,KbReviewDecidedEvent as r,KbReviewRequestedEvent as i}from"./events.js";import a from"./example.js";import{ChangeCandidateModel as o,ChangeRiskLevelEnum as s,ReviewAssignedRoleEnum as c,ReviewDecisionEnum as l,ReviewTaskModel as u}from"./entities/models.js";import"./entities/index.js";import{KbPipelineCreateReviewTaskContract as d,KbPipelinePublishIfReadyContract as f,KbPipelineRunWatchContract as p,KbPipelineSubmitDecisionContract as m}from"./contracts/pipeline.js";import"./contracts/index.js";import{createPipelineMemoryHandlers as h,createPipelineMemoryStore as g}from"./handlers/memory.handlers.js";import{KbUpdatePipelineFeature as _}from"./kb-update-pipeline.feature.js";import"./docs/index.js";export{o as ChangeCandidateModel,s as ChangeRiskLevelEnum,e as KbChangeDetectedEvent,t as KbChangeSummarizedEvent,n as KbPatchProposedEvent,d as KbPipelineCreateReviewTaskContract,f as KbPipelinePublishIfReadyContract,p as KbPipelineRunWatchContract,m as KbPipelineSubmitDecisionContract,r as KbReviewDecidedEvent,i as KbReviewRequestedEvent,_ as KbUpdatePipelineFeature,c as ReviewAssignedRoleEnum,l as ReviewDecisionEnum,u as ReviewTaskModel,h as createPipelineMemoryHandlers,g as createPipelineMemoryStore,a as example};
+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 "./contracts/pipeline.js";
+import "./contracts/index.js";
+import { createPipelineMemoryHandlers, createPipelineMemoryStore } from "./handlers/memory.handlers.js";
+import { KbUpdatePipelineFeature } from "./kb-update-pipeline.feature.js";
+import "./docs/index.js";
+
+export { ChangeCandidateModel, ChangeRiskLevelEnum, KbChangeDetectedEvent, KbChangeSummarizedEvent, KbPatchProposedEvent, KbPipelineCreateReviewTaskContract, KbPipelinePublishIfReadyContract, KbPipelineRunWatchContract, KbPipelineSubmitDecisionContract, KbReviewDecidedEvent, KbReviewRequestedEvent, KbUpdatePipelineFeature, ReviewAssignedRoleEnum, ReviewDecisionEnum, ReviewTaskModel, createPipelineMemoryHandlers, createPipelineMemoryStore, example_default as example };

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

@@ -1 +1,78 @@
-const e={meta:{key:`kb-update-pipeline`,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:[{name:`kbPipeline.runWatch`,version:1},{name:`kbPipeline.createReviewTask`,version:1},{name:`kbPipeline.submitDecision`,version:1},{name:`kbPipeline.publishIfReady`,version:1}],events:[{name:`kb.change.detected`,version:1},{name:`kb.change.summarized`,version:1},{name:`kb.patch.proposed`,version:1},{name:`kb.review.requested`,version:1},{name:`kb.review.decided`,version:1}],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{requires:[{key:`identity`,version:1},{key:`notifications`,version:1},{key:`audit-trail`,version:1}]}};export{e as KbUpdatePipelineFeature};
+//#region src/kb-update-pipeline.feature.ts
+const KbUpdatePipelineFeature = {
+	meta: {
+		key: "kb-update-pipeline",
+		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: [
+		{
+			name: "kbPipeline.runWatch",
+			version: 1
+		},
+		{
+			name: "kbPipeline.createReviewTask",
+			version: 1
+		},
+		{
+			name: "kbPipeline.submitDecision",
+			version: 1
+		},
+		{
+			name: "kbPipeline.publishIfReady",
+			version: 1
+		}
+	],
+	events: [
+		{
+			name: "kb.change.detected",
+			version: 1
+		},
+		{
+			name: "kb.change.summarized",
+			version: 1
+		},
+		{
+			name: "kb.patch.proposed",
+			version: 1
+		},
+		{
+			name: "kb.review.requested",
+			version: 1
+		},
+		{
+			name: "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 };

package/dist/libs/contracts/dist/capabilities/openbanking.js

@@ -0,0 +1,88 @@
+import { StabilityEnum } from "../ownership.js";
+
+//#region ../../libs/contracts/dist/capabilities/openbanking.js
+const OWNERS = ["platform.finance"];
+const TAGS = ["open-banking", "finance"];
+const openBankingAccountsReadCapability = {
+	meta: {
+		key: "openbanking.accounts.read",
+		version: 1,
+		kind: "integration",
+		title: "Open Banking Accounts (Read)",
+		description: "Provides read-only access to linked bank accounts, including account summaries and metadata.",
+		domain: "finance",
+		owners: [...OWNERS],
+		tags: [...TAGS],
+		stability: StabilityEnum.Experimental
+	},
+	provides: [
+		{
+			surface: "operation",
+			name: "openbanking.accounts.list",
+			version: 1,
+			description: "List bank accounts linked to a Powens open banking connection."
+		},
+		{
+			surface: "operation",
+			name: "openbanking.accounts.get",
+			version: 1,
+			description: "Retrieve the canonical bank account record for a specific account."
+		},
+		{
+			surface: "operation",
+			name: "openbanking.accounts.sync",
+			version: 1,
+			description: "Trigger a refresh of bank account metadata from the open banking provider."
+		}
+	]
+};
+const openBankingTransactionsReadCapability = {
+	meta: {
+		key: "openbanking.transactions.read",
+		version: 1,
+		kind: "integration",
+		title: "Open Banking Transactions (Read)",
+		description: "Enables retrieval of transaction history for linked bank accounts via open banking providers.",
+		domain: "finance",
+		owners: [...OWNERS],
+		tags: [...TAGS, "transactions"],
+		stability: StabilityEnum.Experimental
+	},
+	provides: [{
+		surface: "operation",
+		name: "openbanking.transactions.list",
+		version: 1,
+		description: "List transactions for a given bank account with optional date filtering."
+	}, {
+		surface: "operation",
+		name: "openbanking.transactions.sync",
+		version: 1,
+		description: "Synchronise transactions from the open banking provider into the canonical ledger."
+	}]
+};
+const openBankingBalancesReadCapability = {
+	meta: {
+		key: "openbanking.balances.read",
+		version: 1,
+		kind: "integration",
+		title: "Open Banking Balances (Read)",
+		description: "Allows querying of current and available balances for linked bank accounts via open banking providers.",
+		domain: "finance",
+		owners: [...OWNERS],
+		tags: [...TAGS, "balances"],
+		stability: StabilityEnum.Experimental
+	},
+	provides: [{
+		surface: "operation",
+		name: "openbanking.balances.get",
+		version: 1,
+		description: "Retrieve the latest known balances for a specified bank account."
+	}, {
+		surface: "operation",
+		name: "openbanking.balances.refresh",
+		version: 1,
+		description: "Force a balance refresh from the open banking provider."
+	}]
+};
+
+//#endregion

package/dist/libs/contracts/dist/client/index.js

@@ -0,0 +1,5 @@
+'use client';
+
+import "./react/feature-render.js";
+import "./react/form-render.js";
+import "./react/index.js";

package/dist/libs/contracts/dist/client/react/feature-render.js

@@ -0,0 +1,2 @@
+import "../../presentations.v2.js";
+import "react";

package/dist/libs/contracts/dist/client/react/form-render.js

@@ -0,0 +1,4 @@
+import "react";
+import "react-hook-form";
+import "@hookform/resolvers/zod";
+import "react/jsx-runtime";

package/dist/libs/contracts/dist/client/react/index.js

@@ -0,0 +1,4 @@
+'use client';
+
+import "./feature-render.js";
+import "./form-render.js";

package/dist/libs/contracts/dist/contract-registry/index.js

@@ -0,0 +1 @@
+import { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema } from "./schemas.js";

package/dist/libs/contracts/dist/contract-registry/schemas.js

@@ -0,0 +1,60 @@
+import { StabilityEnum } from "../ownership.js";
+import z from "zod";
+
+//#region ../../libs/contracts/dist/contract-registry/schemas.js
+const ContractRegistryItemTypeSchema = z.enum([
+	"contractspec:operation",
+	"contractspec:event",
+	"contractspec:presentation",
+	"contractspec:form",
+	"contractspec:feature",
+	"contractspec:workflow",
+	"contractspec:template",
+	"contractspec:integration",
+	"contractspec:data-view",
+	"contractspec:migration",
+	"contractspec:telemetry",
+	"contractspec:experiment",
+	"contractspec:app-config",
+	"contractspec:knowledge"
+]);
+const ContractRegistryFileSchema = z.object({
+	path: z.string().min(1),
+	type: z.string().min(1),
+	content: z.string().optional()
+});
+const ContractRegistryItemSchema = z.object({
+	name: z.string().min(1),
+	type: ContractRegistryItemTypeSchema,
+	version: z.number().int().nonnegative(),
+	title: z.string().min(1),
+	description: z.string().min(1),
+	meta: z.object({
+		stability: z.enum([
+			StabilityEnum.Idea,
+			StabilityEnum.InCreation,
+			StabilityEnum.Experimental,
+			StabilityEnum.Beta,
+			StabilityEnum.Stable,
+			StabilityEnum.Deprecated
+		]),
+		owners: z.array(z.string().min(1)).default([]),
+		tags: z.array(z.string().min(1)).default([])
+	}),
+	dependencies: z.array(z.string().min(1)).optional(),
+	registryDependencies: z.array(z.string().min(1)).optional(),
+	files: z.array(ContractRegistryFileSchema).min(1),
+	schema: z.object({
+		input: z.unknown().optional(),
+		output: z.unknown().optional()
+	}).optional()
+});
+const ContractRegistryManifestSchema = z.object({
+	$schema: z.string().min(1).optional(),
+	name: z.string().min(1),
+	homepage: z.string().min(1).optional(),
+	items: z.array(ContractRegistryItemSchema)
+});
+
+//#endregion
+export { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema };

package/dist/libs/contracts/dist/docs/PUBLISHING.docblock.js

@@ -0,0 +1,16 @@
+import { registerDocBlocks } from "./registry.js";
+
+//#region ../../libs/contracts/dist/docs/PUBLISHING.docblock.js
+const PUBLISHING_DocBlocks = [{
+	id: "docs.PUBLISHING",
+	title: "Publishing ContractSpec Libraries",
+	summary: "This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/PUBLISHING",
+	tags: ["PUBLISHING"],
+	body: "# Publishing ContractSpec Libraries\n\nThis guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).\n\n## Release Tracks\n\n| Track | Branch | npm Tag | Frequency | Versioning | Use Case |\n|-------|--------|---------|-----------|------------|----------|\n| **Stable** | `release` | `latest` | Manual | SemVer (e.g., `1.7.4`) | Production, external users |\n| **Canary** | `main` | `canary` | Every Push | Snapshot (e.g., `1.7.4-canary...`) | Dev, internal testing |\n\n## Prerequisites\n\n- ✅ `NPM_TOKEN` secret is configured in GitHub (owner or automation token with _publish_ scope).\n- ✅ `GITHUB_TOKEN` (built-in) has permissions to create PRs (enabled by default in new repos).\n- ✅ For stable releases: `release` branch exists and is protected.\n\n## Canary Workflow (Automatic)\n\nEvery commit pushed to `main` triggers the `.github/workflows/publish-canary.yml` workflow.\n\n1. **Trigger**: Push to `main`.\n2. **Versioning**: Runs `changeset version --snapshot canary` to generate a temporary snapshot version.\n3. **Publish**: Packages are published to npm with the `canary` tag using `changeset publish --tag canary`.\n\n### Consuming Canary Builds\n\nTo install the latest bleeding-edge version:\n\n```bash\nnpm install @lssm/lib.contracts@canary\n# or\nbun add @lssm/lib.contracts@canary\n```\n\n## Stable Release Workflow (Manual)\n\nStable releases are managed via the `release` branch using the standard [Changesets Action](https://github.com/changesets/action).\n\n1. **Develop on `main`**: Create features and fixes.\n2. **Add Changesets**: Run `bun changeset` to document changes and impact (major/minor/patch).\n3. **Merge to `release`**: When ready to ship, open a PR from `main` to `release` or merge manually.\n4. **\"Version Packages\" PR**:\n   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **\"Version Packages\"**.\n   - This PR contains the version bumps and updated `CHANGELOG.md` files.\n5. **Merge & Publish**:\n   - Review and merge the \"Version Packages\" PR.\n   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the `latest` tag.\n\n### Publishing Steps\n\n1. Ensure all changesets are present on `main`.\n2. Merge `main` into `release`:\n   ```bash\n   git checkout release\n   git pull origin release\n   git merge main\n   git push origin release\n   ```\n3. Go to GitHub Pull Requests. You will see a **\"Version Packages\"** PR created by the bot.\n4. Merge that PR.\n5. The release is now live on npm!\n\n## Manual Verification (Optional)\n\nBefore publishing a new version you can run:\n\n```bash\nbun run build:not-apps\nnpx npm-packlist --json packages/libs/contracts\n```\n\n## Rollback\n\nIf a publish fails mid-way, re-run the workflow once the issue is fixed. Already published packages are skipped automatically. Use `npm deprecate <package>@<version>` if we need to warn consumers about a broken release.\n"
+}];
+registerDocBlocks(PUBLISHING_DocBlocks);
+
+//#endregion