@contractspec/example.integration-stripe 1.44.1 → 1.45.1

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

@@ -6,32 +6,32 @@ $ tsdown
 ℹ tsconfig: tsconfig.json
 ℹ Build start
 ℹ Cleaning 28 files
-ℹ dist/blueprint.js                             1.68 kB │ gzip: 0.73 kB
+ℹ dist/blueprint.js                             1.72 kB │ gzip: 0.73 kB
 ℹ dist/docs/integration-stripe.docblock.js      1.59 kB │ gzip: 0.74 kB
-ℹ dist/workflow.js                              1.33 kB │ gzip: 0.57 kB
-ℹ dist/tenant.js                                1.28 kB │ gzip: 0.63 kB
-ℹ dist/example.js                               0.89 kB │ gzip: 0.47 kB
+ℹ dist/workflow.js                              1.35 kB │ gzip: 0.57 kB
+ℹ dist/tenant.js                                1.29 kB │ gzip: 0.63 kB
+ℹ dist/example.js                               1.00 kB │ gzip: 0.52 kB
 ℹ dist/connection.sample.js                     0.60 kB │ gzip: 0.35 kB
 ℹ dist/index.js                                 0.44 kB │ gzip: 0.20 kB
 ℹ dist/docs/index.js                            0.04 kB │ gzip: 0.06 kB
-ℹ dist/blueprint.js.map                         2.68 kB │ gzip: 1.10 kB
-ℹ dist/workflow.js.map                          2.22 kB │ gzip: 0.84 kB
-ℹ dist/tenant.js.map                            2.20 kB │ gzip: 0.97 kB
+ℹ dist/blueprint.js.map                         2.74 kB │ gzip: 1.10 kB
+ℹ dist/workflow.js.map                          2.24 kB │ gzip: 0.85 kB
+ℹ dist/tenant.js.map                            2.21 kB │ gzip: 0.98 kB
 ℹ dist/docs/integration-stripe.docblock.js.map  2.09 kB │ gzip: 0.93 kB
-ℹ dist/example.js.map                           1.25 kB │ gzip: 0.64 kB
+ℹ dist/example.js.map                           1.53 kB │ gzip: 0.73 kB
 ℹ dist/connection.sample.js.map                 1.03 kB │ gzip: 0.52 kB
 ℹ dist/connection.sample.d.ts.map               0.15 kB │ gzip: 0.13 kB
-ℹ dist/example.d.ts.map                         0.14 kB │ gzip: 0.13 kB
 ℹ dist/blueprint.d.ts.map                       0.13 kB │ gzip: 0.12 kB
 ℹ dist/workflow.d.ts.map                        0.13 kB │ gzip: 0.12 kB
+ℹ dist/example.d.ts.map                         0.12 kB │ gzip: 0.12 kB
 ℹ dist/tenant.d.ts.map                          0.12 kB │ gzip: 0.12 kB
-ℹ dist/example.d.ts                             1.12 kB │ gzip: 0.47 kB
 ℹ dist/index.d.ts                               0.39 kB │ gzip: 0.17 kB
 ℹ dist/connection.sample.d.ts                   0.28 kB │ gzip: 0.17 kB
 ℹ dist/blueprint.d.ts                           0.25 kB │ gzip: 0.17 kB
 ℹ dist/tenant.d.ts                              0.25 kB │ gzip: 0.17 kB
 ℹ dist/workflow.d.ts                            0.24 kB │ gzip: 0.16 kB
+ℹ dist/example.d.ts                             0.20 kB │ gzip: 0.16 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
-ℹ 27 files, total: 22.55 kB
-✔ Build complete in 15726ms
+ℹ 27 files, total: 22.16 kB
+✔ Build complete in 20274ms

package/.turbo/turbo-build.log

@@ -7,32 +7,32 @@ $ tsdown
 ℹ target: esnext
 ℹ tsconfig: tsconfig.json
 ℹ Build start
-ℹ dist/blueprint.js                             1.68 kB │ gzip: 0.73 kB
+ℹ dist/blueprint.js                             1.72 kB │ gzip: 0.73 kB
 ℹ dist/docs/integration-stripe.docblock.js      1.59 kB │ gzip: 0.74 kB
-ℹ dist/workflow.js                              1.33 kB │ gzip: 0.57 kB
-ℹ dist/tenant.js                                1.28 kB │ gzip: 0.63 kB
-ℹ dist/example.js                               0.89 kB │ gzip: 0.47 kB
+ℹ dist/workflow.js                              1.35 kB │ gzip: 0.57 kB
+ℹ dist/tenant.js                                1.29 kB │ gzip: 0.63 kB
+ℹ dist/example.js                               1.00 kB │ gzip: 0.52 kB
 ℹ dist/connection.sample.js                     0.60 kB │ gzip: 0.35 kB
 ℹ dist/index.js                                 0.44 kB │ gzip: 0.20 kB
 ℹ dist/docs/index.js                            0.04 kB │ gzip: 0.06 kB
-ℹ dist/blueprint.js.map                         2.68 kB │ gzip: 1.10 kB
-ℹ dist/workflow.js.map                          2.22 kB │ gzip: 0.84 kB
-ℹ dist/tenant.js.map                            2.20 kB │ gzip: 0.97 kB
+ℹ dist/blueprint.js.map                         2.74 kB │ gzip: 1.10 kB
+ℹ dist/workflow.js.map                          2.24 kB │ gzip: 0.85 kB
+ℹ dist/tenant.js.map                            2.21 kB │ gzip: 0.98 kB
 ℹ dist/docs/integration-stripe.docblock.js.map  2.09 kB │ gzip: 0.93 kB
-ℹ dist/example.js.map                           1.25 kB │ gzip: 0.64 kB
+ℹ dist/example.js.map                           1.53 kB │ gzip: 0.73 kB
 ℹ dist/connection.sample.js.map                 1.03 kB │ gzip: 0.52 kB
 ℹ dist/connection.sample.d.ts.map               0.15 kB │ gzip: 0.13 kB
-ℹ dist/example.d.ts.map                         0.14 kB │ gzip: 0.13 kB
 ℹ dist/blueprint.d.ts.map                       0.13 kB │ gzip: 0.12 kB
 ℹ dist/workflow.d.ts.map                        0.13 kB │ gzip: 0.12 kB
+ℹ dist/example.d.ts.map                         0.12 kB │ gzip: 0.12 kB
 ℹ dist/tenant.d.ts.map                          0.12 kB │ gzip: 0.12 kB
-ℹ dist/example.d.ts                             1.12 kB │ gzip: 0.47 kB
 ℹ dist/index.d.ts                               0.39 kB │ gzip: 0.17 kB
 ℹ dist/connection.sample.d.ts                   0.28 kB │ gzip: 0.17 kB
 ℹ dist/blueprint.d.ts                           0.25 kB │ gzip: 0.17 kB
 ℹ dist/tenant.d.ts                              0.25 kB │ gzip: 0.17 kB
 ℹ dist/workflow.d.ts                            0.24 kB │ gzip: 0.16 kB
+ℹ dist/example.d.ts                             0.20 kB │ gzip: 0.16 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
-ℹ 27 files, total: 22.55 kB
-✔ Build complete in 17014ms
+ℹ 27 files, total: 22.16 kB
+✔ Build complete in 19380ms

package/CHANGELOG.md

@@ -1,5 +1,40 @@
 # @contractspec/example.integration-stripe
 
+## 1.45.1
+
+### Patch Changes
+
+- feat: improve app config and examples contracts
+- Updated dependencies
+  - @contractspec/lib.contracts@1.45.1
+  - @contractspec/lib.schema@1.45.1
+
+## 1.45.0
+
+### Minor Changes
+
+- e73ca1d: feat: improve app config and examples contracts
+  feat: Contract layers support (features, examples, app-configs)
+
+  ### New CLI Commands
+  - `contractspec list layers` - List all contract layers with filtering
+
+  ### Enhanced Commands
+  - `contractspec ci` - New `layers` check category validates features/examples/config
+  - `contractspec doctor` - New `layers` health checks
+  - `contractspec integrity` - Now shows layer statistics
+
+  ### New APIs
+  - `discoverLayers()` - Scan workspace for all layer files
+  - `scanExampleSource()` - Parse ExampleSpec from source code
+  - `isExampleFile()` - Check if file is an example spec
+
+### Patch Changes
+
+- Updated dependencies [e73ca1d]
+  - @contractspec/lib.contracts@1.45.0
+  - @contractspec/lib.schema@1.45.0
+
 ## 1.44.1
 
 ### Patch Changes

package/dist/blueprint.js

@@ -4,7 +4,7 @@ import { OwnersEnum, StabilityEnum, TagsEnum } from "@contractspec/lib.contracts
 const artisanStripeBlueprint = {
 	meta: {
 		key: "artisan.payments.stripe",
-		version: 1,
+		version: "1.0.0",
 		appId: "artisan",
 		title: "ArtisanOS Stripe Payments",
 		description: "Blueprint enabling card payments for ArtisanOS merchants via the Stripe integration.",
@@ -19,7 +19,7 @@ const artisanStripeBlueprint = {
 	},
 	capabilities: { enabled: [{
 		key: "payments.psp",
-		version: 1
+		version: "1.0.0"
 	}] },
 	integrationSlots: [{
 		slotId: "primary-payments",
@@ -27,7 +27,7 @@ const artisanStripeBlueprint = {
 		allowedModes: ["managed", "byok"],
 		requiredCapabilities: [{
 			key: "payments.psp",
-			version: 1
+			version: "1.0.0"
 		}],
 		required: true,
 		description: "Primary card processor slot. Bind the tenant Stripe connection here."
@@ -48,15 +48,15 @@ const artisanStripeBlueprint = {
 	},
 	translationCatalog: {
 		key: "artisan.payments.catalog",
-		version: 1
+		version: "1.0.0"
 	},
 	workflows: { collectPayment: {
 		key: "artisan.payments.collectPayment",
-		version: 1
+		version: "1.0.0"
 	} },
 	policies: [{
 		key: "artisan.payments.default",
-		version: 1
+		version: "1.0.0"
 	}],
 	notes: "Install this blueprint and pair it with the Stripe integration connection to enable card collection."
 };

package/dist/blueprint.js.map

@@ -1 +1 @@
-{"version":3,"file":"blueprint.js","names":["artisanStripeBlueprint: AppBlueprintSpec"],"sources":["../src/blueprint.ts"],"sourcesContent":["import type { AppBlueprintSpec } from '@contractspec/lib.contracts/app-config/spec';\nimport {\n  OwnersEnum,\n  StabilityEnum,\n  TagsEnum,\n} from '@contractspec/lib.contracts/ownership';\n\nexport const artisanStripeBlueprint: AppBlueprintSpec = {\n  meta: {\n    key: 'artisan.payments.stripe',\n    version: 1,\n    appId: 'artisan',\n    title: 'ArtisanOS Stripe Payments',\n    description:\n      'Blueprint enabling card payments for ArtisanOS merchants via the Stripe integration.',\n    domain: 'payments',\n    owners: [OwnersEnum.PlatformCore],\n    tags: [TagsEnum.Marketplace, 'stripe', 'payments'],\n    stability: StabilityEnum.Experimental,\n  },\n  capabilities: {\n    enabled: [{ key: 'payments.psp', version: 1 }],\n  },\n  integrationSlots: [\n    {\n      slotId: 'primary-payments',\n      requiredCategory: 'payments',\n      allowedModes: ['managed', 'byok'],\n      requiredCapabilities: [{ key: 'payments.psp', version: 1 }],\n      required: true,\n      description:\n        'Primary card processor slot. Bind the tenant Stripe connection here.',\n    },\n  ],\n  branding: {\n    appNameKey: 'artisan.payments.appName',\n    assets: [\n      { type: 'logo', url: 'https://cdn.artisanos.dev/branding/logo.png' },\n      {\n        type: 'favicon',\n        url: 'https://cdn.artisanos.dev/branding/favicon.ico',\n      },\n    ],\n    colorTokens: {\n      primary: 'colors.brand.primary',\n      secondary: 'colors.brand.secondary',\n    },\n  },\n  translationCatalog: {\n    key: 'artisan.payments.catalog',\n    version: 1,\n  },\n  workflows: {\n    collectPayment: { key: 'artisan.payments.collectPayment', version: 1 },\n  },\n  policies: [{ key: 'artisan.payments.default', version: 1 }],\n  notes:\n    'Install this blueprint and pair it with the Stripe integration connection to enable card collection.',\n};\n"],"mappings":";;;AAOA,MAAaA,yBAA2C;CACtD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,WAAW,aAAa;EACjC,MAAM;GAAC,SAAS;GAAa;GAAU;GAAW;EAClD,WAAW,cAAc;EAC1B;CACD,cAAc,EACZ,SAAS,CAAC;EAAE,KAAK;EAAgB,SAAS;EAAG,CAAC,EAC/C;CACD,kBAAkB,CAChB;EACE,QAAQ;EACR,kBAAkB;EAClB,cAAc,CAAC,WAAW,OAAO;EACjC,sBAAsB,CAAC;GAAE,KAAK;GAAgB,SAAS;GAAG,CAAC;EAC3D,UAAU;EACV,aACE;EACH,CACF;CACD,UAAU;EACR,YAAY;EACZ,QAAQ,CACN;GAAE,MAAM;GAAQ,KAAK;GAA+C,EACpE;GACE,MAAM;GACN,KAAK;GACN,CACF;EACD,aAAa;GACX,SAAS;GACT,WAAW;GACZ;EACF;CACD,oBAAoB;EAClB,KAAK;EACL,SAAS;EACV;CACD,WAAW,EACT,gBAAgB;EAAE,KAAK;EAAmC,SAAS;EAAG,EACvE;CACD,UAAU,CAAC;EAAE,KAAK;EAA4B,SAAS;EAAG,CAAC;CAC3D,OACE;CACH"}
+{"version":3,"file":"blueprint.js","names":["artisanStripeBlueprint: AppBlueprintSpec"],"sources":["../src/blueprint.ts"],"sourcesContent":["import type { AppBlueprintSpec } from '@contractspec/lib.contracts/app-config/spec';\nimport {\n  OwnersEnum,\n  StabilityEnum,\n  TagsEnum,\n} from '@contractspec/lib.contracts/ownership';\n\nexport const artisanStripeBlueprint: AppBlueprintSpec = {\n  meta: {\n    key: 'artisan.payments.stripe',\n    version: '1.0.0',\n    appId: 'artisan',\n    title: 'ArtisanOS Stripe Payments',\n    description:\n      'Blueprint enabling card payments for ArtisanOS merchants via the Stripe integration.',\n    domain: 'payments',\n    owners: [OwnersEnum.PlatformCore],\n    tags: [TagsEnum.Marketplace, 'stripe', 'payments'],\n    stability: StabilityEnum.Experimental,\n  },\n  capabilities: {\n    enabled: [{ key: 'payments.psp', version: '1.0.0' }],\n  },\n  integrationSlots: [\n    {\n      slotId: 'primary-payments',\n      requiredCategory: 'payments',\n      allowedModes: ['managed', 'byok'],\n      requiredCapabilities: [{ key: 'payments.psp', version: '1.0.0' }],\n      required: true,\n      description:\n        'Primary card processor slot. Bind the tenant Stripe connection here.',\n    },\n  ],\n  branding: {\n    appNameKey: 'artisan.payments.appName',\n    assets: [\n      { type: 'logo', url: 'https://cdn.artisanos.dev/branding/logo.png' },\n      {\n        type: 'favicon',\n        url: 'https://cdn.artisanos.dev/branding/favicon.ico',\n      },\n    ],\n    colorTokens: {\n      primary: 'colors.brand.primary',\n      secondary: 'colors.brand.secondary',\n    },\n  },\n  translationCatalog: {\n    key: 'artisan.payments.catalog',\n    version: '1.0.0',\n  },\n  workflows: {\n    collectPayment: {\n      key: 'artisan.payments.collectPayment',\n      version: '1.0.0',\n    },\n  },\n  policies: [{ key: 'artisan.payments.default', version: '1.0.0' }],\n  notes:\n    'Install this blueprint and pair it with the Stripe integration connection to enable card collection.',\n};\n"],"mappings":";;;AAOA,MAAaA,yBAA2C;CACtD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,WAAW,aAAa;EACjC,MAAM;GAAC,SAAS;GAAa;GAAU;GAAW;EAClD,WAAW,cAAc;EAC1B;CACD,cAAc,EACZ,SAAS,CAAC;EAAE,KAAK;EAAgB,SAAS;EAAS,CAAC,EACrD;CACD,kBAAkB,CAChB;EACE,QAAQ;EACR,kBAAkB;EAClB,cAAc,CAAC,WAAW,OAAO;EACjC,sBAAsB,CAAC;GAAE,KAAK;GAAgB,SAAS;GAAS,CAAC;EACjE,UAAU;EACV,aACE;EACH,CACF;CACD,UAAU;EACR,YAAY;EACZ,QAAQ,CACN;GAAE,MAAM;GAAQ,KAAK;GAA+C,EACpE;GACE,MAAM;GACN,KAAK;GACN,CACF;EACD,aAAa;GACX,SAAS;GACT,WAAW;GACZ;EACF;CACD,oBAAoB;EAClB,KAAK;EACL,SAAS;EACV;CACD,WAAW,EACT,gBAAgB;EACd,KAAK;EACL,SAAS;EACV,EACF;CACD,UAAU,CAAC;EAAE,KAAK;EAA4B,SAAS;EAAS,CAAC;CACjE,OACE;CACH"}

package/dist/connection.sample.js

@@ -4,7 +4,7 @@ const stripeLiveConnection = {
 		id: "conn-stripe-live",
 		tenantId: "artisan-co",
 		integrationKey: "payments.stripe",
-		integrationVersion: 1,
+		integrationVersion: "1",
 		label: "Stripe Production",
 		environment: "production",
 		createdAt: "2026-01-01T00:00:00.000Z",

package/dist/connection.sample.js.map

@@ -1 +1 @@
-{"version":3,"file":"connection.sample.js","names":["stripeLiveConnection: IntegrationConnection"],"sources":["../src/connection.sample.ts"],"sourcesContent":["import type { IntegrationConnection } from '@contractspec/lib.contracts/integrations/connection';\n\nexport const stripeLiveConnection: IntegrationConnection = {\n  meta: {\n    id: 'conn-stripe-live',\n    tenantId: 'artisan-co',\n    integrationKey: 'payments.stripe',\n    integrationVersion: 1,\n    label: 'Stripe Production',\n    environment: 'production',\n    createdAt: '2026-01-01T00:00:00.000Z',\n    updatedAt: '2026-01-01T00:00:00.000Z',\n  },\n  ownershipMode: 'managed',\n  config: {\n    accountId: 'acct_xxx',\n  },\n  secretProvider: 'vault',\n  secretRef: 'vault://integrations/artisan-co/conn-stripe-live',\n  status: 'connected',\n};\n"],"mappings":";AAEA,MAAaA,uBAA8C;CACzD,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,gBAAgB;EAChB,oBAAoB;EACpB,OAAO;EACP,aAAa;EACb,WAAW;EACX,WAAW;EACZ;CACD,eAAe;CACf,QAAQ,EACN,WAAW,YACZ;CACD,gBAAgB;CAChB,WAAW;CACX,QAAQ;CACT"}
+{"version":3,"file":"connection.sample.js","names":["stripeLiveConnection: IntegrationConnection"],"sources":["../src/connection.sample.ts"],"sourcesContent":["import type { IntegrationConnection } from '@contractspec/lib.contracts/integrations/connection';\n\nexport const stripeLiveConnection: IntegrationConnection = {\n  meta: {\n    id: 'conn-stripe-live',\n    tenantId: 'artisan-co',\n    integrationKey: 'payments.stripe',\n    integrationVersion: '1',\n    label: 'Stripe Production',\n    environment: 'production',\n    createdAt: '2026-01-01T00:00:00.000Z',\n    updatedAt: '2026-01-01T00:00:00.000Z',\n  },\n  ownershipMode: 'managed',\n  config: {\n    accountId: 'acct_xxx',\n  },\n  secretProvider: 'vault',\n  secretRef: 'vault://integrations/artisan-co/conn-stripe-live',\n  status: 'connected',\n};\n"],"mappings":";AAEA,MAAaA,uBAA8C;CACzD,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,gBAAgB;EAChB,oBAAoB;EACpB,OAAO;EACP,aAAa;EACb,WAAW;EACX,WAAW;EACZ;CACD,eAAe;CACf,QAAQ,EACN,WAAW,YACZ;CACD,gBAAgB;CAChB,WAAW;CACX,QAAQ;CACT"}

package/dist/example.d.ts

@@ -1,34 +1,7 @@
+import { ExampleSpec } from "@contractspec/lib.contracts";
+
 //#region src/example.d.ts
-declare const example: {
-  readonly id: "integration-stripe";
-  readonly title: "Integration — Stripe Payments";
-  readonly summary: "Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).";
-  readonly tags: readonly ["stripe", "payments", "integration", "blueprint", "workflow"];
-  readonly kind: "integration";
-  readonly visibility: "public";
-  readonly docs: {
-    readonly rootDocId: "docs.examples.integration-stripe";
-    readonly usageDocId: "docs.examples.integration-stripe.usage";
-  };
-  readonly entrypoints: {
-    readonly packageName: "@contractspec/example.integration-stripe";
-    readonly docs: "./docs";
-  };
-  readonly surfaces: {
-    readonly templates: true;
-    readonly sandbox: {
-      readonly enabled: true;
-      readonly modes: readonly ["markdown", "specs"];
-    };
-    readonly studio: {
-      readonly enabled: true;
-      readonly installable: true;
-    };
-    readonly mcp: {
-      readonly enabled: true;
-    };
-  };
-};
+declare const example: ExampleSpec;
 //#endregion
 export { example as default };
 //# sourceMappingURL=example.d.ts.map

package/dist/example.d.ts.map

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

package/dist/example.js

@@ -1,17 +1,22 @@
 //#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",
+	meta: {
+		key: "integration-stripe",
+		version: "1.0.0",
+		title: "Integration — Stripe Payments",
+		description: "Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).",
+		kind: "integration",
+		visibility: "public",
+		stability: "experimental",
+		owners: ["@platform.core"],
+		tags: [
+			"stripe",
+			"payments",
+			"integration",
+			"blueprint",
+			"workflow"
+		]
+	},
 	docs: {
 		rootDocId: "docs.examples.integration-stripe",
 		usageDocId: "docs.examples.integration-stripe.usage"

package/dist/example.js.map

@@ -1 +1 @@
-{"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n  id: 'integration-stripe',\n  title: 'Integration — Stripe Payments',\n  summary:\n    'Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).',\n  tags: ['stripe', 'payments', 'integration', 'blueprint', 'workflow'],\n  kind: 'integration',\n  visibility: 'public',\n  docs: {\n    rootDocId: 'docs.examples.integration-stripe',\n    usageDocId: 'docs.examples.integration-stripe.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.integration-stripe',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAU;EAAY;EAAe;EAAa;EAAW;CACpE,MAAM;CACN,YAAY;CACZ,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}
+{"version":3,"file":"example.js","names":["example: ExampleSpec"],"sources":["../src/example.ts"],"sourcesContent":["import type { ExampleSpec } from '@contractspec/lib.contracts';\n\nconst example: ExampleSpec = {\n  meta: {\n    key: 'integration-stripe',\n    version: '1.0.0',\n    title: 'Integration — Stripe Payments',\n    description:\n      'Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).',\n    kind: 'integration',\n    visibility: 'public',\n    stability: 'experimental',\n    owners: ['@platform.core'],\n    tags: ['stripe', 'payments', 'integration', 'blueprint', 'workflow'],\n  },\n  docs: {\n    rootDocId: 'docs.examples.integration-stripe',\n    usageDocId: 'docs.examples.integration-stripe.usage',\n  },\n  entrypoints: {\n    packageName: '@contractspec/example.integration-stripe',\n    docs: './docs',\n  },\n  surfaces: {\n    templates: true,\n    sandbox: { enabled: true, modes: ['markdown', 'specs'] },\n    studio: { enabled: true, installable: true },\n    mcp: { enabled: true },\n  },\n};\n\nexport default example;\n"],"mappings":";AAEA,MAAMA,UAAuB;CAC3B,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,MAAM;EACN,YAAY;EACZ,WAAW;EACX,QAAQ,CAAC,iBAAiB;EAC1B,MAAM;GAAC;GAAU;GAAY;GAAe;GAAa;GAAW;EACrE;CACD,MAAM;EACJ,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,QAAQ;GAAE;EACxD,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}

package/dist/tenant.js

@@ -5,9 +5,9 @@ const artisanStripeTenantConfig = {
 		tenantId: "artisan-co",
 		appId: "artisan",
 		blueprintName: "artisan.payments.stripe",
-		blueprintVersion: 1,
+		blueprintVersion: "1.0.0",
 		environment: "production",
-		version: 1,
+		version: "1.0.0",
 		status: "published",
 		createdAt: (/* @__PURE__ */ new Date()).toISOString(),
 		updatedAt: (/* @__PURE__ */ new Date()).toISOString()

package/dist/tenant.js.map

@@ -1 +1 @@
-{"version":3,"file":"tenant.js","names":["artisanStripeTenantConfig: TenantAppConfig"],"sources":["../src/tenant.ts"],"sourcesContent":["import type { TenantAppConfig } from '@contractspec/lib.contracts/app-config/spec';\n\nexport const artisanStripeTenantConfig: TenantAppConfig = {\n  meta: {\n    id: 'tenant-config-artisan-stripe',\n    tenantId: 'artisan-co',\n    appId: 'artisan',\n    blueprintName: 'artisan.payments.stripe',\n    blueprintVersion: 1,\n    environment: 'production',\n    version: 1,\n    status: 'published',\n    createdAt: new Date().toISOString(),\n    updatedAt: new Date().toISOString(),\n  },\n  integrations: [\n    {\n      slotId: 'primary-payments',\n      connectionId: 'conn-stripe-live',\n      scope: {\n        workflows: ['collectPayment'],\n        operations: ['payments.stripe.chargeCard'],\n      },\n    },\n  ],\n  knowledge: [],\n  locales: {\n    defaultLocale: 'en',\n    enabledLocales: ['en', 'fr'],\n  },\n  translationOverrides: {\n    entries: [\n      {\n        key: 'artisan.payments.appName',\n        locale: 'en',\n        value: 'Artisan Payments Portal',\n      },\n    ],\n  },\n  branding: {\n    appName: { en: 'Artisan Payments Portal' },\n    assets: [\n      { type: 'logo', url: 'https://tenant.artisanos.dev/logo.png' },\n      { type: 'logo-dark', url: 'https://tenant.artisanos.dev/logo-dark.png' },\n    ],\n    colors: {\n      primary: '#F97316',\n      secondary: '#1F2937',\n    },\n    customDomain: 'pay.artisanos.dev',\n  },\n  notes: 'Stripe connection bound for production payments.',\n};\n"],"mappings":";AAEA,MAAaA,4BAA6C;CACxD,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,OAAO;EACP,eAAe;EACf,kBAAkB;EAClB,aAAa;EACb,SAAS;EACT,QAAQ;EACR,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,4BAAW,IAAI,MAAM,EAAC,aAAa;EACpC;CACD,cAAc,CACZ;EACE,QAAQ;EACR,cAAc;EACd,OAAO;GACL,WAAW,CAAC,iBAAiB;GAC7B,YAAY,CAAC,6BAA6B;GAC3C;EACF,CACF;CACD,WAAW,EAAE;CACb,SAAS;EACP,eAAe;EACf,gBAAgB,CAAC,MAAM,KAAK;EAC7B;CACD,sBAAsB,EACpB,SAAS,CACP;EACE,KAAK;EACL,QAAQ;EACR,OAAO;EACR,CACF,EACF;CACD,UAAU;EACR,SAAS,EAAE,IAAI,2BAA2B;EAC1C,QAAQ,CACN;GAAE,MAAM;GAAQ,KAAK;GAAyC,EAC9D;GAAE,MAAM;GAAa,KAAK;GAA8C,CACzE;EACD,QAAQ;GACN,SAAS;GACT,WAAW;GACZ;EACD,cAAc;EACf;CACD,OAAO;CACR"}
+{"version":3,"file":"tenant.js","names":["artisanStripeTenantConfig: TenantAppConfig"],"sources":["../src/tenant.ts"],"sourcesContent":["import type { TenantAppConfig } from '@contractspec/lib.contracts/app-config/spec';\n\nexport const artisanStripeTenantConfig: TenantAppConfig = {\n  meta: {\n    id: 'tenant-config-artisan-stripe',\n    tenantId: 'artisan-co',\n    appId: 'artisan',\n    blueprintName: 'artisan.payments.stripe',\n    blueprintVersion: '1.0.0',\n    environment: 'production',\n    version: '1.0.0',\n    status: 'published',\n    createdAt: new Date().toISOString(),\n    updatedAt: new Date().toISOString(),\n  },\n  integrations: [\n    {\n      slotId: 'primary-payments',\n      connectionId: 'conn-stripe-live',\n      scope: {\n        workflows: ['collectPayment'],\n        operations: ['payments.stripe.chargeCard'],\n      },\n    },\n  ],\n  knowledge: [],\n  locales: {\n    defaultLocale: 'en',\n    enabledLocales: ['en', 'fr'],\n  },\n  translationOverrides: {\n    entries: [\n      {\n        key: 'artisan.payments.appName',\n        locale: 'en',\n        value: 'Artisan Payments Portal',\n      },\n    ],\n  },\n  branding: {\n    appName: { en: 'Artisan Payments Portal' },\n    assets: [\n      { type: 'logo', url: 'https://tenant.artisanos.dev/logo.png' },\n      { type: 'logo-dark', url: 'https://tenant.artisanos.dev/logo-dark.png' },\n    ],\n    colors: {\n      primary: '#F97316',\n      secondary: '#1F2937',\n    },\n    customDomain: 'pay.artisanos.dev',\n  },\n  notes: 'Stripe connection bound for production payments.',\n};\n"],"mappings":";AAEA,MAAaA,4BAA6C;CACxD,MAAM;EACJ,IAAI;EACJ,UAAU;EACV,OAAO;EACP,eAAe;EACf,kBAAkB;EAClB,aAAa;EACb,SAAS;EACT,QAAQ;EACR,4BAAW,IAAI,MAAM,EAAC,aAAa;EACnC,4BAAW,IAAI,MAAM,EAAC,aAAa;EACpC;CACD,cAAc,CACZ;EACE,QAAQ;EACR,cAAc;EACd,OAAO;GACL,WAAW,CAAC,iBAAiB;GAC7B,YAAY,CAAC,6BAA6B;GAC3C;EACF,CACF;CACD,WAAW,EAAE;CACb,SAAS;EACP,eAAe;EACf,gBAAgB,CAAC,MAAM,KAAK;EAC7B;CACD,sBAAsB,EACpB,SAAS,CACP;EACE,KAAK;EACL,QAAQ;EACR,OAAO;EACR,CACF,EACF;CACD,UAAU;EACR,SAAS,EAAE,IAAI,2BAA2B;EAC1C,QAAQ,CACN;GAAE,MAAM;GAAQ,KAAK;GAAyC,EAC9D;GAAE,MAAM;GAAa,KAAK;GAA8C,CACzE;EACD,QAAQ;GACN,SAAS;GACT,WAAW;GACZ;EACD,cAAc;EACf;CACD,OAAO;CACR"}

package/dist/workflow.js

@@ -4,7 +4,7 @@ import { OwnersEnum, StabilityEnum, TagsEnum } from "@contractspec/lib.contracts
 const collectPaymentWorkflow = {
 	meta: {
 		key: "artisan.payments.collectPayment",
-		version: 1,
+		version: "1.0.0",
 		title: "Collect Card Payment",
 		description: "Charge a customer using the tenant Stripe connection and record settlement details.",
 		domain: "payments",
@@ -21,7 +21,7 @@ const collectPaymentWorkflow = {
 				label: "Prepare charge parameters",
 				action: { operation: {
 					key: "payments.prepareCharge",
-					version: 1
+					version: "1.0.0"
 				} }
 			},
 			{
@@ -30,7 +30,7 @@ const collectPaymentWorkflow = {
 				label: "Charge card via Stripe",
 				action: { operation: {
 					key: "payments.stripe.chargeCard",
-					version: 1
+					version: "1.0.0"
 				} }
 			},
 			{
@@ -39,7 +39,7 @@ const collectPaymentWorkflow = {
 				label: "Confirm settlement",
 				action: { operation: {
 					key: "payments.recordSettlement",
-					version: 1
+					version: "1.0.0"
 				} }
 			}
 		],

package/dist/workflow.js.map

@@ -1 +1 @@
-{"version":3,"file":"workflow.js","names":["collectPaymentWorkflow: WorkflowSpec"],"sources":["../src/workflow.ts"],"sourcesContent":["import type { WorkflowSpec } from '@contractspec/lib.contracts/workflow/spec';\nimport {\n  OwnersEnum,\n  StabilityEnum,\n  TagsEnum,\n} from '@contractspec/lib.contracts/ownership';\n\nexport const collectPaymentWorkflow: WorkflowSpec = {\n  meta: {\n    key: 'artisan.payments.collectPayment',\n    version: 1,\n    title: 'Collect Card Payment',\n    description:\n      'Charge a customer using the tenant Stripe connection and record settlement details.',\n    domain: 'payments',\n    owners: [OwnersEnum.PlatformCore],\n    tags: [TagsEnum.Marketplace, 'stripe'],\n    stability: StabilityEnum.Experimental,\n  },\n  definition: {\n    entryStepId: 'prepare',\n    steps: [\n      {\n        id: 'prepare',\n        type: 'automation',\n        label: 'Prepare charge parameters',\n        action: {\n          operation: { key: 'payments.prepareCharge', version: 1 },\n        },\n      },\n      {\n        id: 'charge',\n        type: 'automation',\n        label: 'Charge card via Stripe',\n        action: {\n          operation: { key: 'payments.stripe.chargeCard', version: 1 },\n        },\n      },\n      {\n        id: 'confirm',\n        type: 'automation',\n        label: 'Confirm settlement',\n        action: {\n          operation: { key: 'payments.recordSettlement', version: 1 },\n        },\n      },\n    ],\n    transitions: [\n      { from: 'prepare', to: 'charge' },\n      { from: 'charge', to: 'confirm', condition: 'output.success === true' },\n    ],\n  },\n};\n"],"mappings":";;;AAOA,MAAaA,yBAAuC;CAClD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,WAAW,aAAa;EACjC,MAAM,CAAC,SAAS,aAAa,SAAS;EACtC,WAAW,cAAc;EAC1B;CACD,YAAY;EACV,aAAa;EACb,OAAO;GACL;IACE,IAAI;IACJ,MAAM;IACN,OAAO;IACP,QAAQ,EACN,WAAW;KAAE,KAAK;KAA0B,SAAS;KAAG,EACzD;IACF;GACD;IACE,IAAI;IACJ,MAAM;IACN,OAAO;IACP,QAAQ,EACN,WAAW;KAAE,KAAK;KAA8B,SAAS;KAAG,EAC7D;IACF;GACD;IACE,IAAI;IACJ,MAAM;IACN,OAAO;IACP,QAAQ,EACN,WAAW;KAAE,KAAK;KAA6B,SAAS;KAAG,EAC5D;IACF;GACF;EACD,aAAa,CACX;GAAE,MAAM;GAAW,IAAI;GAAU,EACjC;GAAE,MAAM;GAAU,IAAI;GAAW,WAAW;GAA2B,CACxE;EACF;CACF"}
+{"version":3,"file":"workflow.js","names":["collectPaymentWorkflow: WorkflowSpec"],"sources":["../src/workflow.ts"],"sourcesContent":["import type { WorkflowSpec } from '@contractspec/lib.contracts/workflow/spec';\nimport {\n  OwnersEnum,\n  StabilityEnum,\n  TagsEnum,\n} from '@contractspec/lib.contracts/ownership';\n\nexport const collectPaymentWorkflow: WorkflowSpec = {\n  meta: {\n    key: 'artisan.payments.collectPayment',\n    version: '1.0.0',\n    title: 'Collect Card Payment',\n    description:\n      'Charge a customer using the tenant Stripe connection and record settlement details.',\n    domain: 'payments',\n    owners: [OwnersEnum.PlatformCore],\n    tags: [TagsEnum.Marketplace, 'stripe'],\n    stability: StabilityEnum.Experimental,\n  },\n  definition: {\n    entryStepId: 'prepare',\n    steps: [\n      {\n        id: 'prepare',\n        type: 'automation',\n        label: 'Prepare charge parameters',\n        action: {\n          operation: { key: 'payments.prepareCharge', version: '1.0.0' },\n        },\n      },\n      {\n        id: 'charge',\n        type: 'automation',\n        label: 'Charge card via Stripe',\n        action: {\n          operation: { key: 'payments.stripe.chargeCard', version: '1.0.0' },\n        },\n      },\n      {\n        id: 'confirm',\n        type: 'automation',\n        label: 'Confirm settlement',\n        action: {\n          operation: { key: 'payments.recordSettlement', version: '1.0.0' },\n        },\n      },\n    ],\n    transitions: [\n      { from: 'prepare', to: 'charge' },\n      { from: 'charge', to: 'confirm', condition: 'output.success === true' },\n    ],\n  },\n};\n"],"mappings":";;;AAOA,MAAaA,yBAAuC;CAClD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,WAAW,aAAa;EACjC,MAAM,CAAC,SAAS,aAAa,SAAS;EACtC,WAAW,cAAc;EAC1B;CACD,YAAY;EACV,aAAa;EACb,OAAO;GACL;IACE,IAAI;IACJ,MAAM;IACN,OAAO;IACP,QAAQ,EACN,WAAW;KAAE,KAAK;KAA0B,SAAS;KAAS,EAC/D;IACF;GACD;IACE,IAAI;IACJ,MAAM;IACN,OAAO;IACP,QAAQ,EACN,WAAW;KAAE,KAAK;KAA8B,SAAS;KAAS,EACnE;IACF;GACD;IACE,IAAI;IACJ,MAAM;IACN,OAAO;IACP,QAAQ,EACN,WAAW;KAAE,KAAK;KAA6B,SAAS;KAAS,EAClE;IACF;GACF;EACD,aAAa,CACX;GAAE,MAAM;GAAW,IAAI;GAAU,EACjC;GAAE,MAAM;GAAU,IAAI;GAAW,WAAW;GAA2B,CACxE;EACF;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/example.integration-stripe",
-  "version": "1.44.1",
+  "version": "1.45.1",
   "description": "Integration example – Stripe Payments (blueprint + workflow + tenant config).",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,12 +30,12 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@contractspec/lib.schema": "1.44.1",
-    "@contractspec/lib.contracts": "1.44.1"
+    "@contractspec/lib.schema": "1.45.1",
+    "@contractspec/lib.contracts": "1.45.1"
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.44.1",
-    "@contractspec/tool.typescript": "1.44.1",
+    "@contractspec/tool.tsdown": "1.45.1",
+    "@contractspec/tool.typescript": "1.45.1",
     "tsdown": "^0.18.3",
     "typescript": "^5.9.3"
   },

package/src/blueprint.ts

@@ -8,7 +8,7 @@ import {
 export const artisanStripeBlueprint: AppBlueprintSpec = {
   meta: {
     key: 'artisan.payments.stripe',
-    version: 1,
+    version: '1.0.0',
     appId: 'artisan',
     title: 'ArtisanOS Stripe Payments',
     description:
@@ -19,14 +19,14 @@ export const artisanStripeBlueprint: AppBlueprintSpec = {
     stability: StabilityEnum.Experimental,
   },
   capabilities: {
-    enabled: [{ key: 'payments.psp', version: 1 }],
+    enabled: [{ key: 'payments.psp', version: '1.0.0' }],
   },
   integrationSlots: [
     {
       slotId: 'primary-payments',
       requiredCategory: 'payments',
       allowedModes: ['managed', 'byok'],
-      requiredCapabilities: [{ key: 'payments.psp', version: 1 }],
+      requiredCapabilities: [{ key: 'payments.psp', version: '1.0.0' }],
       required: true,
       description:
         'Primary card processor slot. Bind the tenant Stripe connection here.',
@@ -48,12 +48,15 @@ export const artisanStripeBlueprint: AppBlueprintSpec = {
   },
   translationCatalog: {
     key: 'artisan.payments.catalog',
-    version: 1,
+    version: '1.0.0',
   },
   workflows: {
-    collectPayment: { key: 'artisan.payments.collectPayment', version: 1 },
+    collectPayment: {
+      key: 'artisan.payments.collectPayment',
+      version: '1.0.0',
+    },
   },
-  policies: [{ key: 'artisan.payments.default', version: 1 }],
+  policies: [{ key: 'artisan.payments.default', version: '1.0.0' }],
   notes:
     'Install this blueprint and pair it with the Stripe integration connection to enable card collection.',
 };

package/src/connection.sample.ts

@@ -5,7 +5,7 @@ export const stripeLiveConnection: IntegrationConnection = {
     id: 'conn-stripe-live',
     tenantId: 'artisan-co',
     integrationKey: 'payments.stripe',
-    integrationVersion: 1,
+    integrationVersion: '1',
     label: 'Stripe Production',
     environment: 'production',
     createdAt: '2026-01-01T00:00:00.000Z',

package/src/example.ts

@@ -1,11 +1,18 @@
-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',
+import type { ExampleSpec } from '@contractspec/lib.contracts';
+
+const example: ExampleSpec = {
+  meta: {
+    key: 'integration-stripe',
+    version: '1.0.0',
+    title: 'Integration — Stripe Payments',
+    description:
+      'Wire AppBlueprint + Workflow + TenantAppConfig to enable Stripe-backed payments (spec-first integration pattern).',
+    kind: 'integration',
+    visibility: 'public',
+    stability: 'experimental',
+    owners: ['@platform.core'],
+    tags: ['stripe', 'payments', 'integration', 'blueprint', 'workflow'],
+  },
   docs: {
     rootDocId: 'docs.examples.integration-stripe',
     usageDocId: 'docs.examples.integration-stripe.usage',
@@ -20,6 +27,6 @@ const example = {
     studio: { enabled: true, installable: true },
     mcp: { enabled: true },
   },
-} as const;
+};
 
 export default example;

package/src/tenant.ts

@@ -6,9 +6,9 @@ export const artisanStripeTenantConfig: TenantAppConfig = {
     tenantId: 'artisan-co',
     appId: 'artisan',
     blueprintName: 'artisan.payments.stripe',
-    blueprintVersion: 1,
+    blueprintVersion: '1.0.0',
     environment: 'production',
-    version: 1,
+    version: '1.0.0',
     status: 'published',
     createdAt: new Date().toISOString(),
     updatedAt: new Date().toISOString(),

package/src/workflow.ts

@@ -8,7 +8,7 @@ import {
 export const collectPaymentWorkflow: WorkflowSpec = {
   meta: {
     key: 'artisan.payments.collectPayment',
-    version: 1,
+    version: '1.0.0',
     title: 'Collect Card Payment',
     description:
       'Charge a customer using the tenant Stripe connection and record settlement details.',
@@ -25,7 +25,7 @@ export const collectPaymentWorkflow: WorkflowSpec = {
         type: 'automation',
         label: 'Prepare charge parameters',
         action: {
-          operation: { key: 'payments.prepareCharge', version: 1 },
+          operation: { key: 'payments.prepareCharge', version: '1.0.0' },
         },
       },
       {
@@ -33,7 +33,7 @@ export const collectPaymentWorkflow: WorkflowSpec = {
         type: 'automation',
         label: 'Charge card via Stripe',
         action: {
-          operation: { key: 'payments.stripe.chargeCard', version: 1 },
+          operation: { key: 'payments.stripe.chargeCard', version: '1.0.0' },
         },
       },
       {
@@ -41,7 +41,7 @@ export const collectPaymentWorkflow: WorkflowSpec = {
         type: 'automation',
         label: 'Confirm settlement',
         action: {
-          operation: { key: 'payments.recordSettlement', version: 1 },
+          operation: { key: 'payments.recordSettlement', version: '1.0.0' },
         },
       },
     ],