@lssm/example.team-hub 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217072406

package/dist/events.js

@@ -1 +1,162 @@
-import{l as e}from"./libs/schema/dist/ScalarTypeEnum.js";import{n as t}from"./libs/schema/dist/SchemaModel.js";import"./libs/schema/dist/index.js";import{e as n}from"./libs/contracts/dist/events.js";import"./libs/contracts/dist/index.js";const r=t({name:`SpaceEventPayload`,description:`Payload for space events`,fields:{spaceId:{type:e.String_unsecure(),isOptional:!1},orgId:{type:e.String_unsecure(),isOptional:!1},ownerId:{type:e.String_unsecure(),isOptional:!1},timestamp:{type:e.DateTime(),isOptional:!1}}}),i=t({name:`TaskEventPayload`,description:`Payload for task events`,fields:{taskId:{type:e.String_unsecure(),isOptional:!1},spaceId:{type:e.String_unsecure(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},assigneeId:{type:e.String_unsecure(),isOptional:!0},orgId:{type:e.String_unsecure(),isOptional:!1},timestamp:{type:e.DateTime(),isOptional:!1}}}),a=t({name:`RitualEventPayload`,description:`Payload for ritual events`,fields:{ritualId:{type:e.String_unsecure(),isOptional:!1},spaceId:{type:e.String_unsecure(),isOptional:!1},scheduledFor:{type:e.DateTime(),isOptional:!1},status:{type:e.String_unsecure(),isOptional:!1},orgId:{type:e.String_unsecure(),isOptional:!1}}}),o=t({name:`AnnouncementPayload`,description:`Payload for announcements`,fields:{announcementId:{type:e.String_unsecure(),isOptional:!1},spaceId:{type:e.String_unsecure(),isOptional:!0},audience:{type:e.String_unsecure(),isOptional:!1},orgId:{type:e.String_unsecure(),isOptional:!1},createdBy:{type:e.String_unsecure(),isOptional:!1},createdAt:{type:e.DateTime(),isOptional:!1}}}),s=n({name:`team.space.created`,version:1,description:`A space was created.`,payload:r}),c=n({name:`team.task.created`,version:1,description:`A task was created.`,payload:i}),l=n({name:`team.task.status_changed`,version:1,description:`A task status changed.`,payload:i}),u=n({name:`team.ritual.scheduled`,version:1,description:`A ritual was scheduled.`,payload:a}),d=n({name:`team.ritual.occurred`,version:1,description:`A ritual occurrence was logged.`,payload:a}),f=n({name:`team.announcement.posted`,version:1,description:`An announcement was posted.`,payload:o}),p={SpaceCreatedEvent:s,TaskCreatedEvent:c,TaskStatusChangedEvent:l,RitualScheduledEvent:u,RitualOccurredEvent:d,AnnouncementPostedEvent:f};export{f as AnnouncementPostedEvent,d as RitualOccurredEvent,u as RitualScheduledEvent,s as SpaceCreatedEvent,c as TaskCreatedEvent,l as TaskStatusChangedEvent,p as TeamHubEvents};
+import { ScalarTypeEnum } from "./libs/schema/dist/ScalarTypeEnum.js";
+import { defineSchemaModel } from "./libs/schema/dist/SchemaModel.js";
+import "./libs/schema/dist/index.js";
+import { defineEvent } from "./libs/contracts/dist/events.js";
+import "./libs/contracts/dist/index.js";
+
+//#region src/events.ts
+const SpaceEventPayload = defineSchemaModel({
+	name: "SpaceEventPayload",
+	description: "Payload for space events",
+	fields: {
+		spaceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		ownerId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const TaskEventPayload = defineSchemaModel({
+	name: "TaskEventPayload",
+	description: "Payload for task events",
+	fields: {
+		taskId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		spaceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		assigneeId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		timestamp: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const RitualEventPayload = defineSchemaModel({
+	name: "RitualEventPayload",
+	description: "Payload for ritual events",
+	fields: {
+		ritualId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		spaceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		scheduledFor: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		},
+		status: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		}
+	}
+});
+const AnnouncementPayload = defineSchemaModel({
+	name: "AnnouncementPayload",
+	description: "Payload for announcements",
+	fields: {
+		announcementId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		spaceId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: true
+		},
+		audience: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		orgId: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		createdBy: {
+			type: ScalarTypeEnum.String_unsecure(),
+			isOptional: false
+		},
+		createdAt: {
+			type: ScalarTypeEnum.DateTime(),
+			isOptional: false
+		}
+	}
+});
+const SpaceCreatedEvent = defineEvent({
+	name: "team.space.created",
+	version: 1,
+	description: "A space was created.",
+	payload: SpaceEventPayload
+});
+const TaskCreatedEvent = defineEvent({
+	name: "team.task.created",
+	version: 1,
+	description: "A task was created.",
+	payload: TaskEventPayload
+});
+const TaskStatusChangedEvent = defineEvent({
+	name: "team.task.status_changed",
+	version: 1,
+	description: "A task status changed.",
+	payload: TaskEventPayload
+});
+const RitualScheduledEvent = defineEvent({
+	name: "team.ritual.scheduled",
+	version: 1,
+	description: "A ritual was scheduled.",
+	payload: RitualEventPayload
+});
+const RitualOccurredEvent = defineEvent({
+	name: "team.ritual.occurred",
+	version: 1,
+	description: "A ritual occurrence was logged.",
+	payload: RitualEventPayload
+});
+const AnnouncementPostedEvent = defineEvent({
+	name: "team.announcement.posted",
+	version: 1,
+	description: "An announcement was posted.",
+	payload: AnnouncementPayload
+});
+const TeamHubEvents = {
+	SpaceCreatedEvent,
+	TaskCreatedEvent,
+	TaskStatusChangedEvent,
+	RitualScheduledEvent,
+	RitualOccurredEvent,
+	AnnouncementPostedEvent
+};
+
+//#endregion
+export { AnnouncementPostedEvent, RitualOccurredEvent, RitualScheduledEvent, SpaceCreatedEvent, TaskCreatedEvent, TaskStatusChangedEvent, TeamHubEvents };

package/dist/example.js

@@ -1 +1,50 @@
-var e={id:`team-hub`,title:`Team Hub`,summary:`Internal collaboration hub with spaces, tasks, rituals, and announcements.`,tags:[`tasks`,`rituals`,`announcements`,`collaboration`],kind:`template`,visibility:`public`,docs:{rootDocId:`docs.examples.team-hub`,goalDocId:`docs.examples.team-hub.goal`,usageDocId:`docs.examples.team-hub.usage`,constraintsDocId:`docs.examples.team-hub.constraints`},entrypoints:{packageName:`@lssm/example.team-hub`,feature:`./feature`,contracts:`./contracts`,presentations:`./presentations`,handlers:`./handlers`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`playground`,`specs`,`builder`,`markdown`,`evolution`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};
+//#region src/example.ts
+const example = {
+	id: "team-hub",
+	title: "Team Hub",
+	summary: "Internal collaboration hub with spaces, tasks, rituals, and announcements.",
+	tags: [
+		"tasks",
+		"rituals",
+		"announcements",
+		"collaboration"
+	],
+	kind: "template",
+	visibility: "public",
+	docs: {
+		rootDocId: "docs.examples.team-hub",
+		goalDocId: "docs.examples.team-hub.goal",
+		usageDocId: "docs.examples.team-hub.usage",
+		constraintsDocId: "docs.examples.team-hub.constraints"
+	},
+	entrypoints: {
+		packageName: "@lssm/example.team-hub",
+		feature: "./feature",
+		contracts: "./contracts",
+		presentations: "./presentations",
+		handlers: "./handlers",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: [
+				"playground",
+				"specs",
+				"builder",
+				"markdown",
+				"evolution"
+			]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };

package/dist/handlers/index.js

@@ -1 +1,8 @@
-function e(){}export{e as registerTeamHubHandlers};
+//#region src/handlers/index.ts
+/**
+* Placeholder handler registry for Team Hub contracts.
+*/
+function registerTeamHubHandlers() {}
+
+//#endregion
+export { registerTeamHubHandlers };

package/dist/index.js

@@ -1 +1,14 @@
-import{CreateSpaceInputModel as e,SpaceModel as t}from"./space/space.schema.js";import{CreateSpaceContract as n}from"./space/space.contracts.js";import"./space/index.js";import{CreateTaskInputModel as r,TaskModel as i,UpdateTaskStatusInputModel as a}from"./task/task.schema.js";import{CreateTaskContract as o,ListTasksInputModel as s,ListTasksOperation as c,ListTasksOutputModel as l,UpdateTaskStatusContract as u}from"./task/task.contracts.js";import"./task/index.js";import{LogRitualOccurrenceInputModel as d,RitualModel as f,ScheduleRitualInputModel as p}from"./ritual/ritual.schema.js";import{LogRitualOccurrenceContract as m,ScheduleRitualContract as h}from"./ritual/ritual.contracts.js";import"./ritual/index.js";import{AnnouncementModel as g,PostAnnouncementInputModel as _}from"./announcement/announcement.schema.js";import{PostAnnouncementContract as v}from"./announcement/announcement.contracts.js";import"./announcement/index.js";export{g as AnnouncementModel,n as CreateSpaceContract,e as CreateSpaceInputModel,o as CreateTaskContract,r as CreateTaskInputModel,s as ListTasksInputModel,c as ListTasksOperation,l as ListTasksOutputModel,m as LogRitualOccurrenceContract,d as LogRitualOccurrenceInputModel,v as PostAnnouncementContract,_ as PostAnnouncementInputModel,f as RitualModel,h as ScheduleRitualContract,p as ScheduleRitualInputModel,t as SpaceModel,i as TaskModel,u as UpdateTaskStatusContract,a as UpdateTaskStatusInputModel};
+import { CreateSpaceInputModel, SpaceModel } from "./space/space.schema.js";
+import { CreateSpaceContract } from "./space/space.contracts.js";
+import "./space/index.js";
+import { CreateTaskInputModel, TaskModel, UpdateTaskStatusInputModel } from "./task/task.schema.js";
+import { CreateTaskContract, ListTasksInputModel, ListTasksOperation, ListTasksOutputModel, UpdateTaskStatusContract } from "./task/task.contracts.js";
+import "./task/index.js";
+import { LogRitualOccurrenceInputModel, RitualModel, ScheduleRitualInputModel } from "./ritual/ritual.schema.js";
+import { LogRitualOccurrenceContract, ScheduleRitualContract } from "./ritual/ritual.contracts.js";
+import "./ritual/index.js";
+import { AnnouncementModel, PostAnnouncementInputModel } from "./announcement/announcement.schema.js";
+import { PostAnnouncementContract } from "./announcement/announcement.contracts.js";
+import "./announcement/index.js";
+
+export { AnnouncementModel, CreateSpaceContract, CreateSpaceInputModel, CreateTaskContract, CreateTaskInputModel, ListTasksInputModel, ListTasksOperation, ListTasksOutputModel, LogRitualOccurrenceContract, LogRitualOccurrenceInputModel, PostAnnouncementContract, PostAnnouncementInputModel, RitualModel, ScheduleRitualContract, ScheduleRitualInputModel, SpaceModel, TaskModel, UpdateTaskStatusContract, UpdateTaskStatusInputModel };

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