@contractspec/lib.contracts-library 1.56.0

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

@@ -0,0 +1,12 @@
+$ tsdown
+ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
+ℹ entry: src/index.ts
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 4 files
+ℹ dist/index.mjs        4.64 kB │ gzip: 1.15 kB
+ℹ dist/index.mjs.map    6.96 kB │ gzip: 1.45 kB
+ℹ dist/index.d.mts.map  0.26 kB │ gzip: 0.18 kB
+ℹ dist/index.d.mts      0.57 kB │ gzip: 0.22 kB
+ℹ 4 files, total: 12.43 kB
+✔ Build complete in 20046ms

package/.turbo/turbo-build.log

@@ -0,0 +1,15 @@
+
+$ bun build:types && bun build:bundle
+$ tsc --noEmit
+$ tsdown
+ℹ tsdown v0.19.0 powered by rolldown v1.0.0-beta.59
+ℹ entry: src/index.ts
+ℹ tsconfig: tsconfig.json
+ℹ Build start
+ℹ Cleaning 4 files
+ℹ dist/index.mjs        4.64 kB │ gzip: 1.15 kB
+ℹ dist/index.mjs.map    6.96 kB │ gzip: 1.45 kB
+ℹ dist/index.d.mts.map  0.26 kB │ gzip: 0.18 kB
+ℹ dist/index.d.mts      0.57 kB │ gzip: 0.22 kB
+ℹ 4 files, total: 12.43 kB
+✔ Build complete in 4181ms

package/AGENTS.md

@@ -0,0 +1,28 @@
+# lib.contracts-library
+
+Contract definitions for library templates and local runtime.
+
+## Quick Context
+
+- **Type**: Library (contracts)
+- **Consumers**: `bundle.library`
+
+## Exports
+
+- `./templates` — Template contracts
+- `./templates/recipes` — Recipe specs
+- `./templates/todos` — Todo specs
+
+## Usage
+
+```typescript
+import { RecipeSpec } from '@contractspec/lib.contracts-library/templates/recipes';
+```
+
+## Commands
+
+```bash
+bun build       # Build library
+bun build:types # Type check
+bun lint        # Lint code
+```

package/CHANGELOG.md

@@ -0,0 +1,151 @@
+# @contractspec/lib.contracts-library
+
+## 1.56.0
+
+### Minor Changes
+
+- fix: release
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/lib.contracts@1.56.0
+  - @contractspec/lib.schema@1.56.0
+
+## 1.55.0
+
+### Minor Changes
+
+- fix: unpublished packages
+
+### Patch Changes
+
+- Updated dependencies
+  - @contractspec/lib.contracts@1.55.0
+  - @contractspec/lib.schema@1.55.0
+
+## 1.54.0
+
+### Minor Changes
+
+- ec5e95c: chore: upgrade dependencies
+
+### Patch Changes
+
+- Updated dependencies [ec5e95c]
+  - @contractspec/lib.contracts@1.54.0
+  - @contractspec/lib.schema@1.54.0
+
+## 1.53.0
+
+### Minor Changes
+
+- f4180d4: fix: performance improvement
+
+### Patch Changes
+
+- Updated dependencies [5b371b1]
+- Updated dependencies [f4180d4]
+- Updated dependencies [64d84e1]
+  - @contractspec/lib.contracts@1.53.0
+  - @contractspec/lib.schema@1.53.0
+
+## 1.52.0
+
+### Minor Changes
+
+- d93e6a9: fix: improve website
+
+### Patch Changes
+
+- Updated dependencies [d93e6a9]
+  - @contractspec/lib.contracts@1.52.0
+  - @contractspec/lib.schema@1.52.0
+
+## 1.51.0
+
+### Minor Changes
+
+- e6faefb: feat: add guide to import existing codebase
+
+### Patch Changes
+
+- Updated dependencies [23e46e9]
+- Updated dependencies [ad1f852]
+- Updated dependencies [e6faefb]
+  - @contractspec/lib.contracts@1.51.0
+  - @contractspec/lib.schema@1.51.0
+
+## 1.50.0
+
+### Minor Changes
+
+- 5325d6b: feat: improve seo
+
+### Patch Changes
+
+- Updated dependencies [5325d6b]
+  - @contractspec/lib.contracts@1.50.0
+  - @contractspec/lib.schema@1.50.0
+
+## 1.49.0
+
+### Minor Changes
+
+- cafd041: fix: impact report comments within github action
+
+### Patch Changes
+
+- Updated dependencies [cafd041]
+  - @contractspec/lib.contracts@1.49.0
+  - @contractspec/lib.schema@1.49.0
+
+## 1.48.1
+
+### Patch Changes
+
+- Updated dependencies [c560ee7]
+  - @contractspec/lib.contracts@1.48.1
+
+## 1.48.0
+
+### Minor Changes
+
+- b0444a4: feat: reduce adoption's friction by allowing generation of contracts from an analyse of the codebase
+
+### Patch Changes
+
+- Updated dependencies [b0444a4]
+  - @contractspec/lib.contracts@1.48.0
+  - @contractspec/lib.schema@1.48.0
+
+## 1.47.0
+
+### Minor Changes
+
+- caf8701: feat: add cli vibe command to run workflow
+- c69b849: feat: add api web services (mcp & website)
+- 42b8d78: feat: add cli `contractspec vibe` workflow to simplify usage
+- fd38e85: feat: auto-fix contractspec issues
+
+### Patch Changes
+
+- e7ded36: feat: improve stability (adding ts-morph)
+- c231a8b: test: improve workspace stability
+- Updated dependencies [e7ded36]
+- Updated dependencies [caf8701]
+- Updated dependencies [c69b849]
+- Updated dependencies [c231a8b]
+- Updated dependencies [42b8d78]
+- Updated dependencies [fd38e85]
+  - @contractspec/lib.contracts@1.47.0
+  - @contractspec/lib.schema@1.47.0
+
+## 1.46.2
+
+### Patch Changes
+
+- 7e21625: feat: library services (landing page & api)
+- Updated dependencies [7e21625]
+  - @contractspec/lib.contracts@1.46.2
+  - @contractspec/lib.schema@1.46.2

package/README.md

@@ -0,0 +1,39 @@
+# @contractspec/lib.contracts-library
+
+Contract definitions for the ContractSpec library experience including templates and local runtime.
+
+## Overview
+
+This library provides contract specs for:
+- Template definitions (todos, recipes)
+- Local runtime operations
+- Library-specific queries and commands
+
+## Installation
+
+```bash
+bun add @contractspec/lib.contracts-library
+```
+
+## Exports
+
+- `./templates` — Template contract definitions
+- `./templates/recipes` — Recipe template specs
+- `./templates/todos` — Todo template specs
+
+## Usage
+
+```typescript
+import { RecipeSpec } from '@contractspec/lib.contracts-library/templates/recipes';
+import { TodoSpec } from '@contractspec/lib.contracts-library/templates/todos';
+```
+
+## Dependencies
+
+- `@contractspec/lib.contracts` — Core contract primitives
+- `@contractspec/lib.schema` — Schema utilities
+
+## Related Packages
+
+- [`@contractspec/bundle.library`](../../bundles/library/README.md) — Implementation
+- [`@contractspec/lib.contracts-studio`](../contracts-studio/README.md) — Studio contracts

package/dist/index.d.mts

@@ -0,0 +1,13 @@
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+
+//#region src/templates/recipes.d.ts
+declare const RecipeCapability: _contractspec_lib_contracts0.CapabilitySpec;
+//#endregion
+//#region src/templates/todos.d.ts
+declare const TaskCrudCapability: _contractspec_lib_contracts0.CapabilitySpec;
+//#endregion
+//#region src/templates/messaging.d.ts
+declare const MessagingCapability: _contractspec_lib_contracts0.CapabilitySpec;
+//#endregion
+export { MessagingCapability, RecipeCapability, TaskCrudCapability };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/templates/recipes.ts","../src/templates/todos.ts","../src/templates/messaging.ts"],"sourcesContent":[],"mappings":";;;cAIa,kBA2CX,4BAAA,CA3C2B;;;cCAhB,oBAoDX,4BAAA,CApD6B;;;cCAlB,qBAuDX,4BAAA,CAvD8B"}

package/dist/index.mjs

@@ -0,0 +1,182 @@
+import { StabilityEnum, defineCapability } from "@contractspec/lib.contracts";
+
+//#region src/templates/recipes.ts
+const OWNERS$2 = ["platform.contractspec-studio"];
+const RecipeCapability = defineCapability({
+	meta: {
+		key: "template.recipes.browse",
+		version: "1.0.0",
+		kind: "api",
+		title: "Template Recipe Browser",
+		description: "Internationalized recipe browsing, search, and detail operations for template applications.",
+		domain: "templates",
+		owners: [...OWNERS$2],
+		tags: [
+			"templates",
+			"recipes",
+			"i18n",
+			"content"
+		],
+		stability: StabilityEnum.Stable
+	},
+	provides: [
+		{
+			surface: "operation",
+			key: "template.recipe.list",
+			version: "1.0.0",
+			description: "List recipes with category, difficulty, and locale filters."
+		},
+		{
+			surface: "operation",
+			key: "template.recipe.get",
+			version: "1.0.0",
+			description: "Fetch a recipe detail view including localized content."
+		},
+		{
+			surface: "operation",
+			key: "template.recipe.search",
+			version: "1.0.0",
+			description: "Search recipes by ingredient, tag, or free text with i18n support."
+		},
+		{
+			surface: "operation",
+			key: "template.recipe.favorite",
+			version: "1.0.0",
+			description: "Toggle recipe favorites for showcasing personalization patterns."
+		}
+	],
+	requires: [{
+		key: "studio.project",
+		version: "1.0.0"
+	}]
+});
+
+//#endregion
+//#region src/templates/todos.ts
+const OWNERS$1 = ["platform.contractspec-studio"];
+const TaskCrudCapability = defineCapability({
+	meta: {
+		key: "template.todos.crud",
+		version: "1.0.0",
+		kind: "api",
+		title: "Template Tasks CRUD",
+		description: "Create, read, update, delete, and toggle template tasks with categories and priorities.",
+		domain: "templates",
+		owners: [...OWNERS$1],
+		tags: [
+			"templates",
+			"todos",
+			"productivity"
+		],
+		stability: StabilityEnum.Stable
+	},
+	provides: [
+		{
+			surface: "operation",
+			key: "template.task.create",
+			version: "1.0.0",
+			description: "Create a new task for a Studio project template."
+		},
+		{
+			surface: "operation",
+			key: "template.task.update",
+			version: "1.0.0",
+			description: "Update task metadata such as title, due date, or category."
+		},
+		{
+			surface: "operation",
+			key: "template.task.delete",
+			version: "1.0.0",
+			description: "Delete or archive a task from a template project."
+		},
+		{
+			surface: "operation",
+			key: "template.task.toggle",
+			version: "1.0.0",
+			description: "Mark a task as completed or active."
+		},
+		{
+			surface: "operation",
+			key: "template.task.list",
+			version: "1.0.0",
+			description: "List tasks with filtering, search, and sorting."
+		},
+		{
+			surface: "operation",
+			key: "template.task.category",
+			version: "1.0.0",
+			description: "Manage categories and tags for tasks."
+		}
+	],
+	requires: [{
+		key: "studio.project",
+		version: "1.0.0"
+	}]
+});
+
+//#endregion
+//#region src/templates/messaging.ts
+const OWNERS = ["platform.contractspec-studio"];
+const MessagingCapability = defineCapability({
+	meta: {
+		key: "template.messaging.core",
+		version: "1.0.0",
+		kind: "api",
+		title: "Template Messaging Core",
+		description: "Real-time messaging primitives for template applications, including conversations, participants, and delivery events.",
+		domain: "templates",
+		owners: [...OWNERS],
+		tags: [
+			"templates",
+			"messaging",
+			"realtime"
+		],
+		stability: StabilityEnum.Experimental
+	},
+	provides: [
+		{
+			surface: "operation",
+			key: "template.messaging.conversation.create",
+			version: "1.0.0",
+			description: "Create a direct or group conversation scoped to a Studio project."
+		},
+		{
+			surface: "operation",
+			key: "template.messaging.conversation.list",
+			version: "1.0.0",
+			description: "List conversations with pagination, unread counts, and filters."
+		},
+		{
+			surface: "operation",
+			key: "template.messaging.message.send",
+			version: "1.0.0",
+			description: "Send a message with attachments and optimistic delivery state."
+		},
+		{
+			surface: "operation",
+			key: "template.messaging.message.read",
+			version: "1.0.0",
+			description: "Mark messages as read and update participant cursors."
+		},
+		{
+			surface: "event",
+			key: "template.messaging.message.received",
+			version: "1.0.0",
+			description: "Emitted when a participant receives a new message."
+		},
+		{
+			surface: "event",
+			key: "template.messaging.typing",
+			version: "1.0.0",
+			description: "Emitted when a participant is typing in a conversation."
+		}
+	],
+	requires: [{
+		key: "studio.project",
+		version: "1.0.0"
+	}]
+});
+
+//#endregion
+export { MessagingCapability, RecipeCapability, TaskCrudCapability };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["OWNERS","OWNERS"],"sources":["../src/templates/recipes.ts","../src/templates/todos.ts","../src/templates/messaging.ts"],"sourcesContent":["import { defineCapability, StabilityEnum } from '@contractspec/lib.contracts';\n\nconst OWNERS = ['platform.contractspec-studio'] as const;\n\nexport const RecipeCapability = defineCapability({\n  meta: {\n    key: 'template.recipes.browse',\n    version: '1.0.0',\n    kind: 'api',\n    title: 'Template Recipe Browser',\n    description:\n      'Internationalized recipe browsing, search, and detail operations for template applications.',\n    domain: 'templates',\n    owners: [...OWNERS],\n    tags: ['templates', 'recipes', 'i18n', 'content'],\n    stability: StabilityEnum.Stable,\n  },\n  provides: [\n    {\n      surface: 'operation',\n      key: 'template.recipe.list',\n      version: '1.0.0',\n      description:\n        'List recipes with category, difficulty, and locale filters.',\n    },\n    {\n      surface: 'operation',\n      key: 'template.recipe.get',\n      version: '1.0.0',\n      description: 'Fetch a recipe detail view including localized content.',\n    },\n    {\n      surface: 'operation',\n      key: 'template.recipe.search',\n      version: '1.0.0',\n      description:\n        'Search recipes by ingredient, tag, or free text with i18n support.',\n    },\n    {\n      surface: 'operation',\n      key: 'template.recipe.favorite',\n      version: '1.0.0',\n      description:\n        'Toggle recipe favorites for showcasing personalization patterns.',\n    },\n  ],\n  requires: [{ key: 'studio.project', version: '1.0.0' }],\n});\n","import { defineCapability, StabilityEnum } from '@contractspec/lib.contracts';\n\nconst OWNERS = ['platform.contractspec-studio'] as const;\n\nexport const TaskCrudCapability = defineCapability({\n  meta: {\n    key: 'template.todos.crud',\n    version: '1.0.0',\n    kind: 'api',\n    title: 'Template Tasks CRUD',\n    description:\n      'Create, read, update, delete, and toggle template tasks with categories and priorities.',\n    domain: 'templates',\n    owners: [...OWNERS],\n    tags: ['templates', 'todos', 'productivity'],\n    stability: StabilityEnum.Stable,\n  },\n  provides: [\n    {\n      surface: 'operation',\n      key: 'template.task.create',\n      version: '1.0.0',\n      description: 'Create a new task for a Studio project template.',\n    },\n    {\n      surface: 'operation',\n      key: 'template.task.update',\n      version: '1.0.0',\n      description: 'Update task metadata such as title, due date, or category.',\n    },\n    {\n      surface: 'operation',\n      key: 'template.task.delete',\n      version: '1.0.0',\n      description: 'Delete or archive a task from a template project.',\n    },\n    {\n      surface: 'operation',\n      key: 'template.task.toggle',\n      version: '1.0.0',\n      description: 'Mark a task as completed or active.',\n    },\n    {\n      surface: 'operation',\n      key: 'template.task.list',\n      version: '1.0.0',\n      description: 'List tasks with filtering, search, and sorting.',\n    },\n    {\n      surface: 'operation',\n      key: 'template.task.category',\n      version: '1.0.0',\n      description: 'Manage categories and tags for tasks.',\n    },\n  ],\n  requires: [{ key: 'studio.project', version: '1.0.0' }],\n});\n","import { defineCapability, StabilityEnum } from '@contractspec/lib.contracts';\n\nconst OWNERS = ['platform.contractspec-studio'] as const;\n\nexport const MessagingCapability = defineCapability({\n  meta: {\n    key: 'template.messaging.core',\n    version: '1.0.0',\n    kind: 'api',\n    title: 'Template Messaging Core',\n    description:\n      'Real-time messaging primitives for template applications, including conversations, participants, and delivery events.',\n    domain: 'templates',\n    owners: [...OWNERS],\n    tags: ['templates', 'messaging', 'realtime'],\n    stability: StabilityEnum.Experimental,\n  },\n  provides: [\n    {\n      surface: 'operation',\n      key: 'template.messaging.conversation.create',\n      version: '1.0.0',\n      description:\n        'Create a direct or group conversation scoped to a Studio project.',\n    },\n    {\n      surface: 'operation',\n      key: 'template.messaging.conversation.list',\n      version: '1.0.0',\n      description:\n        'List conversations with pagination, unread counts, and filters.',\n    },\n    {\n      surface: 'operation',\n      key: 'template.messaging.message.send',\n      version: '1.0.0',\n      description:\n        'Send a message with attachments and optimistic delivery state.',\n    },\n    {\n      surface: 'operation',\n      key: 'template.messaging.message.read',\n      version: '1.0.0',\n      description: 'Mark messages as read and update participant cursors.',\n    },\n    {\n      surface: 'event',\n      key: 'template.messaging.message.received',\n      version: '1.0.0',\n      description: 'Emitted when a participant receives a new message.',\n    },\n    {\n      surface: 'event',\n      key: 'template.messaging.typing',\n      version: '1.0.0',\n      description: 'Emitted when a participant is typing in a conversation.',\n    },\n  ],\n  requires: [{ key: 'studio.project', version: '1.0.0' }],\n});\n"],"mappings":";;;AAEA,MAAMA,WAAS,CAAC,+BAA+B;AAE/C,MAAa,mBAAmB,iBAAiB;CAC/C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,GAAGA,SAAO;EACnB,MAAM;GAAC;GAAa;GAAW;GAAQ;GAAU;EACjD,WAAW,cAAc;EAC1B;CACD,UAAU;EACR;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aACE;GACH;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aAAa;GACd;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aACE;GACH;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aACE;GACH;EACF;CACD,UAAU,CAAC;EAAE,KAAK;EAAkB,SAAS;EAAS,CAAC;CACxD,CAAC;;;;AC7CF,MAAMC,WAAS,CAAC,+BAA+B;AAE/C,MAAa,qBAAqB,iBAAiB;CACjD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,GAAGA,SAAO;EACnB,MAAM;GAAC;GAAa;GAAS;GAAe;EAC5C,WAAW,cAAc;EAC1B;CACD,UAAU;EACR;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aAAa;GACd;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aAAa;GACd;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aAAa;GACd;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aAAa;GACd;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aAAa;GACd;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aAAa;GACd;EACF;CACD,UAAU,CAAC;EAAE,KAAK;EAAkB,SAAS;EAAS,CAAC;CACxD,CAAC;;;;ACtDF,MAAM,SAAS,CAAC,+BAA+B;AAE/C,MAAa,sBAAsB,iBAAiB;CAClD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,MAAM;EACN,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAa;GAAa;GAAW;EAC5C,WAAW,cAAc;EAC1B;CACD,UAAU;EACR;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aACE;GACH;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aACE;GACH;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aACE;GACH;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aAAa;GACd;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aAAa;GACd;EACD;GACE,SAAS;GACT,KAAK;GACL,SAAS;GACT,aAAa;GACd;EACF;CACD,UAAU,CAAC;EAAE,KAAK;EAAkB,SAAS;EAAS,CAAC;CACxD,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@contractspec/lib.contracts-library",
+  "version": "1.56.0",
+  "type": "module",
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "clean": "rm -rf dist",
+    "lint": "bun run lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "exports": {
+    ".": "./dist/index.js",
+    "./templates": "./dist/templates/index.js",
+    "./templates/recipes": "./dist/templates/recipes.js",
+    "./templates/todos": "./dist/templates/todos.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "dependencies": {
+    "@contractspec/lib.contracts": "1.56.0",
+    "@contractspec/lib.schema": "1.56.0"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "1.56.0",
+    "@contractspec/tool.typescript": "1.56.0",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3"
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from './templates';

package/src/templates/index.ts

@@ -0,0 +1,3 @@
+export * from './recipes';
+export * from './todos';
+export * from './messaging';

package/src/templates/messaging.ts

@@ -0,0 +1,60 @@
+import { defineCapability, StabilityEnum } from '@contractspec/lib.contracts';
+
+const OWNERS = ['platform.contractspec-studio'] as const;
+
+export const MessagingCapability = defineCapability({
+  meta: {
+    key: 'template.messaging.core',
+    version: '1.0.0',
+    kind: 'api',
+    title: 'Template Messaging Core',
+    description:
+      'Real-time messaging primitives for template applications, including conversations, participants, and delivery events.',
+    domain: 'templates',
+    owners: [...OWNERS],
+    tags: ['templates', 'messaging', 'realtime'],
+    stability: StabilityEnum.Experimental,
+  },
+  provides: [
+    {
+      surface: 'operation',
+      key: 'template.messaging.conversation.create',
+      version: '1.0.0',
+      description:
+        'Create a direct or group conversation scoped to a Studio project.',
+    },
+    {
+      surface: 'operation',
+      key: 'template.messaging.conversation.list',
+      version: '1.0.0',
+      description:
+        'List conversations with pagination, unread counts, and filters.',
+    },
+    {
+      surface: 'operation',
+      key: 'template.messaging.message.send',
+      version: '1.0.0',
+      description:
+        'Send a message with attachments and optimistic delivery state.',
+    },
+    {
+      surface: 'operation',
+      key: 'template.messaging.message.read',
+      version: '1.0.0',
+      description: 'Mark messages as read and update participant cursors.',
+    },
+    {
+      surface: 'event',
+      key: 'template.messaging.message.received',
+      version: '1.0.0',
+      description: 'Emitted when a participant receives a new message.',
+    },
+    {
+      surface: 'event',
+      key: 'template.messaging.typing',
+      version: '1.0.0',
+      description: 'Emitted when a participant is typing in a conversation.',
+    },
+  ],
+  requires: [{ key: 'studio.project', version: '1.0.0' }],
+});

package/src/templates/recipes.ts

@@ -0,0 +1,48 @@
+import { defineCapability, StabilityEnum } from '@contractspec/lib.contracts';
+
+const OWNERS = ['platform.contractspec-studio'] as const;
+
+export const RecipeCapability = defineCapability({
+  meta: {
+    key: 'template.recipes.browse',
+    version: '1.0.0',
+    kind: 'api',
+    title: 'Template Recipe Browser',
+    description:
+      'Internationalized recipe browsing, search, and detail operations for template applications.',
+    domain: 'templates',
+    owners: [...OWNERS],
+    tags: ['templates', 'recipes', 'i18n', 'content'],
+    stability: StabilityEnum.Stable,
+  },
+  provides: [
+    {
+      surface: 'operation',
+      key: 'template.recipe.list',
+      version: '1.0.0',
+      description:
+        'List recipes with category, difficulty, and locale filters.',
+    },
+    {
+      surface: 'operation',
+      key: 'template.recipe.get',
+      version: '1.0.0',
+      description: 'Fetch a recipe detail view including localized content.',
+    },
+    {
+      surface: 'operation',
+      key: 'template.recipe.search',
+      version: '1.0.0',
+      description:
+        'Search recipes by ingredient, tag, or free text with i18n support.',
+    },
+    {
+      surface: 'operation',
+      key: 'template.recipe.favorite',
+      version: '1.0.0',
+      description:
+        'Toggle recipe favorites for showcasing personalization patterns.',
+    },
+  ],
+  requires: [{ key: 'studio.project', version: '1.0.0' }],
+});

package/src/templates/todos.ts

@@ -0,0 +1,57 @@
+import { defineCapability, StabilityEnum } from '@contractspec/lib.contracts';
+
+const OWNERS = ['platform.contractspec-studio'] as const;
+
+export const TaskCrudCapability = defineCapability({
+  meta: {
+    key: 'template.todos.crud',
+    version: '1.0.0',
+    kind: 'api',
+    title: 'Template Tasks CRUD',
+    description:
+      'Create, read, update, delete, and toggle template tasks with categories and priorities.',
+    domain: 'templates',
+    owners: [...OWNERS],
+    tags: ['templates', 'todos', 'productivity'],
+    stability: StabilityEnum.Stable,
+  },
+  provides: [
+    {
+      surface: 'operation',
+      key: 'template.task.create',
+      version: '1.0.0',
+      description: 'Create a new task for a Studio project template.',
+    },
+    {
+      surface: 'operation',
+      key: 'template.task.update',
+      version: '1.0.0',
+      description: 'Update task metadata such as title, due date, or category.',
+    },
+    {
+      surface: 'operation',
+      key: 'template.task.delete',
+      version: '1.0.0',
+      description: 'Delete or archive a task from a template project.',
+    },
+    {
+      surface: 'operation',
+      key: 'template.task.toggle',
+      version: '1.0.0',
+      description: 'Mark a task as completed or active.',
+    },
+    {
+      surface: 'operation',
+      key: 'template.task.list',
+      version: '1.0.0',
+      description: 'List tasks with filtering, search, and sorting.',
+    },
+    {
+      surface: 'operation',
+      key: 'template.task.category',
+      version: '1.0.0',
+      description: 'Manage categories and tags for tasks.',
+    },
+  ],
+  requires: [{ key: 'studio.project', version: '1.0.0' }],
+});

package/tsconfig.json

@@ -0,0 +1,4 @@
+{
+  "extends": "@contractspec/tool.typescript/base.json",
+  "include": ["src/**/*"]
+}