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

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.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

@@ -1 +1,88 @@
-import{e}from"../ownership.js";const t=[`platform.finance`],n=[`open-banking`,`finance`];[...t],[...n],e.Experimental,[...t],[...n],e.Experimental,[...t],[...n],e.Experimental;
+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

@@ -1 +1,5 @@
-"use client";import"./react/feature-render.js";import"./react/form-render.js";import"./react/index.js";
+'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

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

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

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

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

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

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

@@ -1 +1 @@
-import{i as e,n as t,r as n}from"./schemas.js";
+import { ContractRegistryFileSchema, ContractRegistryItemSchema, ContractRegistryItemTypeSchema } from "./schemas.js";

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

@@ -1 +1,60 @@
-import{e}from"../ownership.js";import t from"zod";const n=t.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`]),r=t.object({path:t.string().min(1),type:t.string().min(1),content:t.string().optional()}),i=t.object({name:t.string().min(1),type:n,version:t.number().int().nonnegative(),title:t.string().min(1),description:t.string().min(1),meta:t.object({stability:t.enum([e.Idea,e.InCreation,e.Experimental,e.Beta,e.Stable,e.Deprecated]),owners:t.array(t.string().min(1)).default([]),tags:t.array(t.string().min(1)).default([])}),dependencies:t.array(t.string().min(1)).optional(),registryDependencies:t.array(t.string().min(1)).optional(),files:t.array(r).min(1),schema:t.object({input:t.unknown().optional(),output:t.unknown().optional()}).optional()});t.object({$schema:t.string().min(1).optional(),name:t.string().min(1),homepage:t.string().min(1).optional(),items:t.array(i)});export{i,n,r};
+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

@@ -1,76 +1,16 @@
-import{a as e}from"./registry.js";e([{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
-
-This guide describes how we release the ContractSpec libraries to npm. We use a dual-track release system: **Stable** (manual) and **Canary** (automatic).
-
-## Release Tracks
-
-| Track | Branch | npm Tag | Frequency | Versioning | Use Case |
-|-------|--------|---------|-----------|------------|----------|
-| **Stable** | \`release\` | \`latest\` | Manual | SemVer (e.g., \`1.7.4\`) | Production, external users |
-| **Canary** | \`main\` | \`canary\` | Every Push | Snapshot (e.g., \`1.7.4-canary...\`) | Dev, internal testing |
-
-## Prerequisites
-
-- ✅ \`NPM_TOKEN\` secret is configured in GitHub (owner or automation token with _publish_ scope).
-- ✅ \`GITHUB_TOKEN\` (built-in) has permissions to create PRs (enabled by default in new repos).
-- ✅ For stable releases: \`release\` branch exists and is protected.
-
-## Canary Workflow (Automatic)
-
-Every commit pushed to \`main\` triggers the \`.github/workflows/publish-canary.yml\` workflow.
-
-1. **Trigger**: Push to \`main\`.
-2. **Versioning**: Runs \`changeset version --snapshot canary\` to generate a temporary snapshot version.
-3. **Publish**: Packages are published to npm with the \`canary\` tag using \`changeset publish --tag canary\`.
-
-### Consuming Canary Builds
-
-To install the latest bleeding-edge version:
-
-\`\`\`bash
-npm install @lssm/lib.contracts@canary
-# or
-bun add @lssm/lib.contracts@canary
-\`\`\`
-
-## Stable Release Workflow (Manual)
-
-Stable releases are managed via the \`release\` branch using the standard [Changesets Action](https://github.com/changesets/action).
-
-1. **Develop on \`main\`**: Create features and fixes.
-2. **Add Changesets**: Run \`bun changeset\` to document changes and impact (major/minor/patch).
-3. **Merge to \`release\`**: When ready to ship, open a PR from \`main\` to \`release\` or merge manually.
-4. **"Version Packages" PR**:
-   - The GitHub Action detects new changesets and automatically creates a Pull Request titled **"Version Packages"**.
-   - This PR contains the version bumps and updated \`CHANGELOG.md\` files.
-5. **Merge & Publish**:
-   - Review and merge the "Version Packages" PR.
-   - The Action runs again, detects the versions have been bumped, builds the libraries, and publishes them to npm with the \`latest\` tag.
-
-### Publishing Steps
-
-1. Ensure all changesets are present on \`main\`.
-2. Merge \`main\` into \`release\`:
-   \`\`\`bash
-   git checkout release
-   git pull origin release
-   git merge main
-   git push origin release
-   \`\`\`
-3. Go to GitHub Pull Requests. You will see a **"Version Packages"** PR created by the bot.
-4. Merge that PR.
-5. The release is now live on npm!
-
-## Manual Verification (Optional)
-
-Before publishing a new version you can run:
-
-\`\`\`bash
-bun run build:not-apps
-npx npm-packlist --json packages/libs/contracts
-\`\`\`
-
-## Rollback
-
-If 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.
-`}]);
+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