@lssm/example.integration-stripe 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/.turbo/turbo-build$colon$bundle.log

@@ -7,45 +7,45 @@
 ℹ tsconfig: tsconfig.json
 ℹ Build start
 ℹ Cleaning 60 files
-ℹ dist/docs/integration-stripe.docblock.js                                        1.41 kB │ gzip: 0.67 kB
-ℹ dist/blueprint.js                                                               1.31 kB │ gzip: 0.62 kB
-ℹ dist/tenant.js                                                                  0.97 kB │ gzip: 0.52 kB
-ℹ dist/workflow.js                                                                0.93 kB │ gzip: 0.46 kB
-ℹ dist/example.js                                                                 0.62 kB │ gzip: 0.37 kB
-ℹ dist/connection.sample.js                                                       0.43 kB │ gzip: 0.28 kB
-ℹ dist/index.js                                                                   0.41 kB │ gzip: 0.20 kB
+ℹ dist/blueprint.js                                                               1.65 kB │ gzip: 0.71 kB
+ℹ dist/docs/integration-stripe.docblock.js                                        1.59 kB │ gzip: 0.73 kB
+ℹ dist/workflow.js                                                                1.29 kB │ gzip: 0.55 kB
+ℹ dist/tenant.js                                                                  1.25 kB │ gzip: 0.61 kB
+ℹ dist/example.js                                                                 0.84 kB │ gzip: 0.45 kB
+ℹ dist/connection.sample.js                                                       0.56 kB │ gzip: 0.33 kB
+ℹ dist/index.js                                                                   0.44 kB │ gzip: 0.20 kB
 ℹ dist/docs/index.js                                                              0.04 kB │ gzip: 0.06 kB
-ℹ dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js  16.51 kB │ gzip: 7.15 kB
-ℹ dist/libs/contracts/dist/docs/tech/schema/README.docblock.js                   10.97 kB │ gzip: 4.28 kB
-ℹ dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js           9.65 kB │ gzip: 3.77 kB
-ℹ dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js              9.10 kB │ gzip: 3.41 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js               8.74 kB │ gzip: 2.67 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           5.91 kB │ gzip: 2.61 kB
-ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js                5.62 kB │ gzip: 2.58 kB
-ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js               5.42 kB │ gzip: 2.25 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.35 kB │ gzip: 2.05 kB
-ℹ dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js                 3.89 kB │ gzip: 1.69 kB
-ℹ dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js                 3.58 kB │ gzip: 1.38 kB
-ℹ dist/libs/contracts/dist/docs/PUBLISHING.docblock.js                            3.42 kB │ gzip: 1.58 kB
-ℹ dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js          3.34 kB │ gzip: 1.45 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js         3.07 kB │ gzip: 1.38 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js      3.03 kB │ gzip: 1.32 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     2.98 kB │ gzip: 1.52 kB
-ℹ dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   2.81 kB │ gzip: 1.41 kB
-ℹ dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js             2.73 kB │ gzip: 1.30 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js           2.49 kB │ gzip: 1.11 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js          2.13 kB │ gzip: 1.03 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js                1.89 kB │ gzip: 0.93 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js           1.78 kB │ gzip: 0.87 kB
-ℹ dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js         1.70 kB │ gzip: 0.89 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js      1.57 kB │ gzip: 0.77 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js             1.47 kB │ gzip: 0.73 kB
-ℹ dist/libs/contracts/dist/docs/index.js                                          1.42 kB │ gzip: 0.47 kB
-ℹ dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js                    1.23 kB │ gzip: 0.68 kB
-ℹ dist/libs/contracts/dist/docs/presentations.js                                  1.14 kB │ gzip: 0.56 kB
-ℹ dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js          0.89 kB │ gzip: 0.55 kB
-ℹ dist/libs/contracts/dist/ownership.js                                           0.69 kB │ gzip: 0.38 kB
-ℹ dist/libs/contracts/dist/docs/registry.js                                       0.63 kB │ gzip: 0.39 kB
+ℹ dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js  16.91 kB │ gzip: 7.23 kB
+ℹ dist/libs/contracts/dist/docs/tech/schema/README.docblock.js                   11.21 kB │ gzip: 4.33 kB
+ℹ dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js           9.96 kB │ gzip: 3.83 kB
+ℹ dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js              9.53 kB │ gzip: 3.50 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js               9.22 kB │ gzip: 2.77 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js           6.16 kB │ gzip: 2.65 kB
+ℹ dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js                5.85 kB │ gzip: 2.66 kB
+ℹ dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js               5.66 kB │ gzip: 2.34 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js    4.62 kB │ gzip: 2.13 kB
+ℹ dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js                 4.16 kB │ gzip: 1.78 kB
+ℹ dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js                 3.85 kB │ gzip: 1.47 kB
+ℹ dist/libs/contracts/dist/docs/PUBLISHING.docblock.js                            3.62 kB │ gzip: 1.65 kB
+ℹ dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js          3.60 kB │ gzip: 1.53 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js         3.33 kB │ gzip: 1.47 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js      3.30 kB │ gzip: 1.42 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js     3.25 kB │ gzip: 1.59 kB
+ℹ dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js   3.13 kB │ gzip: 1.47 kB
+ℹ dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js             2.97 kB │ gzip: 1.38 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js           2.75 kB │ gzip: 1.22 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js          2.40 kB │ gzip: 1.13 kB
+ℹ dist/libs/contracts/dist/docs/presentations.js                                  2.18 kB │ gzip: 0.77 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js                2.13 kB │ gzip: 1.02 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js           2.04 kB │ gzip: 0.97 kB
+ℹ dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js         1.96 kB │ gzip: 0.97 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js      1.85 kB │ gzip: 0.87 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js             1.73 kB │ gzip: 0.82 kB
+ℹ dist/libs/contracts/dist/docs/index.js                                          1.58 kB │ gzip: 0.51 kB
+ℹ dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js                    1.46 kB │ gzip: 0.77 kB
+ℹ dist/libs/contracts/dist/docs/registry.js                                       1.25 kB │ gzip: 0.56 kB
+ℹ dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js          1.14 kB │ gzip: 0.65 kB
+ℹ dist/libs/contracts/dist/ownership.js                                           0.91 kB │ gzip: 0.46 kB
 ℹ dist/example.d.ts                                                               1.08 kB │ gzip: 0.45 kB
 ℹ dist/index.d.ts                                                                 0.39 kB │ gzip: 0.17 kB
 ℹ dist/connection.sample.d.ts                                                     0.23 kB │ gzip: 0.15 kB
@@ -54,5 +54,5 @@
 ℹ dist/workflow.d.ts                                                              0.19 kB │ gzip: 0.14 kB
 ℹ dist/docs/index.d.ts                                                            0.01 kB │ gzip: 0.03 kB
 ℹ dist/docs/integration-stripe.docblock.d.ts                                      0.01 kB │ gzip: 0.03 kB
-ℹ 47 files, total: 132.59 kB
-✔ Build complete in 6163ms
+ℹ 47 files, total: 143.68 kB
+✔ Build complete in 1177ms

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # @lssm/example.integration-stripe
 
-## 0.0.0-canary-20251217063201
+## 0.0.0-canary-20251217073102
 
 ### Minor Changes
 
@@ -9,4 +9,5 @@
 ### Patch Changes
 
 - Updated dependencies [66a5dfd]
-  - @lssm/lib.contracts@0.0.0-canary-20251217063201
+  - @lssm/lib.contracts@0.0.0-canary-20251217073102
+  - @lssm/lib.schema@0.0.0-canary-20251217073102

package/dist/blueprint.js

@@ -1 +1,65 @@
-import{e,r as t,t as n}from"./libs/contracts/dist/ownership.js";const r={meta:{name:`artisan.payments.stripe`,version:1,appId:`artisan`,title:`ArtisanOS Stripe Payments`,description:`Blueprint enabling card payments for ArtisanOS merchants via the Stripe integration.`,domain:`payments`,owners:[n.ProductArtisanos],tags:[t.Marketplace,`stripe`,`payments`],stability:e.Experimental},capabilities:{enabled:[{key:`payments.psp`,version:1}]},integrationSlots:[{slotId:`primary-payments`,requiredCategory:`payments`,allowedModes:[`managed`,`byok`],requiredCapabilities:[{key:`payments.psp`,version:1}],required:!0,description:`Primary card processor slot. Bind the tenant Stripe connection here.`}],branding:{appNameKey:`artisan.payments.appName`,assets:[{type:`logo`,url:`https://cdn.artisanos.dev/branding/logo.png`},{type:`favicon`,url:`https://cdn.artisanos.dev/branding/favicon.ico`}],colorTokens:{primary:`colors.brand.primary`,secondary:`colors.brand.secondary`}},translationCatalog:{name:`artisan.payments.catalog`,version:1},workflows:{collectPayment:{name:`artisan.payments.collectPayment`,version:1}},policies:[{name:`artisan.payments.default`,version:1}],notes:`Install this blueprint and pair it with the Stripe integration connection to enable card collection.`};export{r as artisanStripeBlueprint};
+import { OwnersEnum, StabilityEnum, TagsEnum } from "./libs/contracts/dist/ownership.js";
+
+//#region src/blueprint.ts
+const artisanStripeBlueprint = {
+	meta: {
+		name: "artisan.payments.stripe",
+		version: 1,
+		appId: "artisan",
+		title: "ArtisanOS Stripe Payments",
+		description: "Blueprint enabling card payments for ArtisanOS merchants via the Stripe integration.",
+		domain: "payments",
+		owners: [OwnersEnum.ProductArtisanos],
+		tags: [
+			TagsEnum.Marketplace,
+			"stripe",
+			"payments"
+		],
+		stability: StabilityEnum.Experimental
+	},
+	capabilities: { enabled: [{
+		key: "payments.psp",
+		version: 1
+	}] },
+	integrationSlots: [{
+		slotId: "primary-payments",
+		requiredCategory: "payments",
+		allowedModes: ["managed", "byok"],
+		requiredCapabilities: [{
+			key: "payments.psp",
+			version: 1
+		}],
+		required: true,
+		description: "Primary card processor slot. Bind the tenant Stripe connection here."
+	}],
+	branding: {
+		appNameKey: "artisan.payments.appName",
+		assets: [{
+			type: "logo",
+			url: "https://cdn.artisanos.dev/branding/logo.png"
+		}, {
+			type: "favicon",
+			url: "https://cdn.artisanos.dev/branding/favicon.ico"
+		}],
+		colorTokens: {
+			primary: "colors.brand.primary",
+			secondary: "colors.brand.secondary"
+		}
+	},
+	translationCatalog: {
+		name: "artisan.payments.catalog",
+		version: 1
+	},
+	workflows: { collectPayment: {
+		name: "artisan.payments.collectPayment",
+		version: 1
+	} },
+	policies: [{
+		name: "artisan.payments.default",
+		version: 1
+	}],
+	notes: "Install this blueprint and pair it with the Stripe integration connection to enable card collection."
+};
+
+//#endregion
+export { artisanStripeBlueprint };

package/dist/connection.sample.js

@@ -1 +1,21 @@
-const e={meta:{id:`conn-stripe-live`,tenantId:`artisan-co`,integrationKey:`payments.stripe`,integrationVersion:1,label:`Stripe Production`,environment:`production`,createdAt:`2026-01-01T00:00:00.000Z`,updatedAt:`2026-01-01T00:00:00.000Z`},ownershipMode:`managed`,config:{accountId:`acct_xxx`},secretProvider:`vault`,secretRef:`vault://integrations/artisan-co/conn-stripe-live`,status:`connected`};export{e as stripeLiveConnection};
+//#region src/connection.sample.ts
+const stripeLiveConnection = {
+	meta: {
+		id: "conn-stripe-live",
+		tenantId: "artisan-co",
+		integrationKey: "payments.stripe",
+		integrationVersion: 1,
+		label: "Stripe Production",
+		environment: "production",
+		createdAt: "2026-01-01T00:00:00.000Z",
+		updatedAt: "2026-01-01T00:00:00.000Z"
+	},
+	ownershipMode: "managed",
+	config: { accountId: "acct_xxx" },
+	secretProvider: "vault",
+	secretRef: "vault://integrations/artisan-co/conn-stripe-live",
+	status: "connected"
+};
+
+//#endregion
+export { stripeLiveConnection };

package/dist/docs/index.js

@@ -1 +1 @@
-import"./integration-stripe.docblock.js";
+import "./integration-stripe.docblock.js";

package/dist/docs/integration-stripe.docblock.js

@@ -1,15 +1,30 @@
-import{a as e}from"../libs/contracts/dist/docs/registry.js";import"../libs/contracts/dist/docs/index.js";e([{id:`docs.examples.integration-stripe`,title:`Integration Example — Stripe Payments`,summary:`How to wire IntegrationSpec/TenantAppConfig + blueprint + workflow to enable Stripe-backed payments.`,kind:`reference`,visibility:`public`,route:`/docs/examples/integration-stripe`,tags:[`stripe`,`payments`,`integrations`,`example`],body:`## Included
-- App blueprint enabling \`payments.psp\` capability.
-- Workflow invoking Stripe operations (prepare → charge → confirm).
-- Tenant app config binding workflow to an IntegrationConnection.
+import { registerDocBlocks } from "../libs/contracts/dist/docs/registry.js";
+import "../libs/contracts/dist/docs/index.js";
 
-## Notes
-- Secrets live in secret providers; connection config is non-secret.
-- Use \`ctx.resolvedAppConfig\` in operation executors to access integrations, branding, and translations.`},{id:`docs.examples.integration-stripe.usage`,title:`Stripe Integration Example — Usage`,summary:`How to use the blueprint, workflow, and tenant config together.`,kind:`usage`,visibility:`public`,route:`/docs/examples/integration-stripe/usage`,tags:[`stripe`,`usage`],body:`## Usage
-1) Register the blueprint + workflow + catalog in your registry.
-2) Persist an IntegrationConnection (see connection sample).
-3) Bind the tenant app config to the connection.
+//#region src/docs/integration-stripe.docblock.ts
+registerDocBlocks([{
+	id: "docs.examples.integration-stripe",
+	title: "Integration Example — Stripe Payments",
+	summary: "How to wire IntegrationSpec/TenantAppConfig + blueprint + workflow to enable Stripe-backed payments.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/examples/integration-stripe",
+	tags: [
+		"stripe",
+		"payments",
+		"integrations",
+		"example"
+	],
+	body: `## Included\n- App blueprint enabling \`payments.psp\` capability.\n- Workflow invoking Stripe operations (prepare → charge → confirm).\n- Tenant app config binding workflow to an IntegrationConnection.\n\n## Notes\n- Secrets live in secret providers; connection config is non-secret.\n- Use \`ctx.resolvedAppConfig\` in operation executors to access integrations, branding, and translations.`
+}, {
+	id: "docs.examples.integration-stripe.usage",
+	title: "Stripe Integration Example — Usage",
+	summary: "How to use the blueprint, workflow, and tenant config together.",
+	kind: "usage",
+	visibility: "public",
+	route: "/docs/examples/integration-stripe/usage",
+	tags: ["stripe", "usage"],
+	body: `## Usage\n1) Register the blueprint + workflow + catalog in your registry.\n2) Persist an IntegrationConnection (see connection sample).\n3) Bind the tenant app config to the connection.\n\n## Guardrails\n- Never log secrets.\n- Keep payment semantics spec-defined; gate breaking changes behind flags.`
+}]);
 
-## Guardrails
-- Never log secrets.
-- Keep payment semantics spec-defined; gate breaking changes behind flags.`}]);
+//#endregion

package/dist/example.js

@@ -1 +1,39 @@
-var e={id:`integration-stripe`,title:`Integration — Stripe Payments`,summary:`Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).`,tags:[`stripe`,`payments`,`integration`,`blueprint`,`workflow`],kind:`integration`,visibility:`public`,docs:{rootDocId:`docs.examples.integration-stripe`,usageDocId:`docs.examples.integration-stripe.usage`},entrypoints:{packageName:`@lssm/example.integration-stripe`,docs:`./docs`},surfaces:{templates:!0,sandbox:{enabled:!0,modes:[`markdown`,`specs`]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}};export{e as default};
+//#region src/example.ts
+const example = {
+	id: "integration-stripe",
+	title: "Integration — Stripe Payments",
+	summary: "Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).",
+	tags: [
+		"stripe",
+		"payments",
+		"integration",
+		"blueprint",
+		"workflow"
+	],
+	kind: "integration",
+	visibility: "public",
+	docs: {
+		rootDocId: "docs.examples.integration-stripe",
+		usageDocId: "docs.examples.integration-stripe.usage"
+	},
+	entrypoints: {
+		packageName: "@lssm/example.integration-stripe",
+		docs: "./docs"
+	},
+	surfaces: {
+		templates: true,
+		sandbox: {
+			enabled: true,
+			modes: ["markdown", "specs"]
+		},
+		studio: {
+			enabled: true,
+			installable: true
+		},
+		mcp: { enabled: true }
+	}
+};
+var example_default = example;
+
+//#endregion
+export { example_default as default };

package/dist/index.js

@@ -1 +1,8 @@
-import{artisanStripeBlueprint as e}from"./blueprint.js";import{stripeLiveConnection as t}from"./connection.sample.js";import n from"./example.js";import{collectPaymentWorkflow as r}from"./workflow.js";import{artisanStripeTenantConfig as i}from"./tenant.js";import"./docs/index.js";export{e as artisanStripeBlueprint,i as artisanStripeTenantConfig,r as collectPaymentWorkflow,n as example,t as stripeLiveConnection};
+import { artisanStripeBlueprint } from "./blueprint.js";
+import { stripeLiveConnection } from "./connection.sample.js";
+import example_default from "./example.js";
+import { collectPaymentWorkflow } from "./workflow.js";
+import { artisanStripeTenantConfig } from "./tenant.js";
+import "./docs/index.js";
+
+export { artisanStripeBlueprint, artisanStripeTenantConfig, collectPaymentWorkflow, example_default as example, stripeLiveConnection };

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