@contractspec/bundle.library 3.7.6 → 3.8.2

package/AGENTS.md

@@ -2,39 +2,57 @@
 
 Scope: `packages/bundles/library/*`
 
-Shared library bundle with docs, templates, MCP servers, and common components.
+Shared library bundle that composes docs, templates, integrations, MCP implementations, and reusable presentation surfaces.
 
 ## Quick Context
 
-- **Layer**: bundle
-- **Consumers**: `app.api-library`, `app.web-landing`, `app.web-studio`
+- Layer: `bundle`.
+- Package visibility: published package.
+- Primary consumers are apps and higher-level composed product surfaces.
+- Related packages: `@contractspec/lib.ai-providers`, `@contractspec/lib.content-gen`, `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-library`, `@contractspec/lib.contracts-runtime-server-graphql`, `@contractspec/lib.contracts-runtime-server-mcp`, ...
 
 ## Architecture
 
-- `src/application/mcp/` — MCP server implementations
-- `src/components/docs/` — Documentation pages
-- `src/components/templates/` — Template implementations
-- `src/components/integrations/` — Integration marketplace
-- `src/hooks/studio/` — React hooks for GraphQL
-- `src/providers/auth/` — Authentication providers
-
-## Public Exports
-
-Use subpath imports:
-
-```typescript
-import { ... } from "@contractspec/bundle.library/components/docs";
-import { ... } from "@contractspec/bundle.library/hooks/studio";
-```
+- `src/application/` contains application services including MCP implementations and cross-surface orchestration.
+- `src/components/` contains reusable docs, integrations, legal, shell, and template presentation code.
+- `src/features/`, `src.config/`, `src.infrastructure/`, and `src.libs/` hold bundle-local composition helpers.
+- `src/presentation/` contains feature-specific UI composition exported to consuming apps.
+- `src/index.ts` is the root public barrel and package entrypoint.
+
+## Public Surface
+
+- Large multi-subpath bundle exporting docs, integrations, templates, shell layout, email helpers, and MCP application surfaces.
+- Export `.` resolves through `./src/index.ts`.
+- Export `./application` resolves through `./src/application/index.ts`.
+- Export `./application/context-storage` resolves through `./src/application/context-storage/index.ts`.
+- Export `./application/mcp` resolves through `./src/application/mcp/index.ts`.
+- Export `./application/mcp/cliMcp` resolves through `./src/application/mcp/cliMcp.ts`.
+- Export `./application/mcp/common` resolves through `./src/application/mcp/common.ts`.
+- Export `./application/mcp/contractsMcp` resolves through `./src/application/mcp/contractsMcp.ts`.
+- Export `./application/mcp/contractsMcpResources` resolves through `./src/application/mcp/contractsMcpResources.ts`.
+- Export `./application/mcp/contractsMcpTools` resolves through `./src/application/mcp/contractsMcpTools.ts`.
+- Export `./application/mcp/contractsMcpTypes` resolves through `./src/application/mcp/contractsMcpTypes.ts`.
+- The package publishes 297 total export subpaths; keep docs aligned with `package.json`.
 
 ## Guardrails
 
-- This bundle is consumed by multiple apps — breaking export changes cascade widely.
-- MCP server implementations must stay transport-agnostic (the app layer wires the transport).
-- Keep side effects behind explicit adapters; do not perform I/O at import time.
+- This bundle has wide blast radius across web and API apps; export changes cascade quickly.
+- Keep transport details in app shells; MCP services here should remain transport-agnostic.
+- Avoid import-time side effects because many consumers only need narrow subpath exports.
+- Changes here can affect downstream packages such as `@contractspec/lib.ai-providers`, `@contractspec/lib.content-gen`, `@contractspec/lib.contracts-integrations`, `@contractspec/lib.contracts-library`, `@contractspec/lib.contracts-runtime-server-graphql`, `@contractspec/lib.contracts-runtime-server-mcp`, ...
 
 ## Local Commands
 
-- Build: `bun run build`
-- Types: `bun run build:types`
-- Lint: `bun run lint`
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun run lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rm -rf dist
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # @contractspec/bundle.library
 
+## 3.8.2
+
+### Patch Changes
+
+- 1a44cb6: feat: improve examples to increase coverage of Contracts type
+- Updated dependencies [1a44cb6]
+  - @contractspec/lib.contracts-runtime-server-graphql@3.7.10
+  - @contractspec/lib.contracts-runtime-server-rest@3.7.10
+  - @contractspec/lib.contracts-runtime-server-mcp@3.7.10
+  - @contractspec/lib.contracts-integrations@3.8.2
+  - @contractspec/module.context-storage@0.7.10
+  - @contractspec/lib.contracts-library@3.7.10
+  - @contractspec/lib.example-shared-ui@6.0.10
+  - @contractspec/lib.provider-ranking@0.7.8
+  - @contractspec/lib.runtime-sandbox@2.7.9
+  - @contractspec/lib.surface-runtime@0.5.10
+  - @contractspec/lib.contracts-spec@4.1.2
+  - @contractspec/lib.design-system@3.8.3
+  - @contractspec/lib.ai-providers@3.7.8
+  - @contractspec/lib.content-gen@3.7.10
+  - @contractspec/module.examples@3.8.2
+  - @contractspec/lib.ui-kit-web@3.9.2
+  - @contractspec/lib.knowledge@3.7.10
+  - @contractspec/lib.ui-link@3.7.8
+  - @contractspec/lib.logger@3.7.8
+  - @contractspec/lib.schema@3.7.8
+
+## 3.8.1
+
+### Patch Changes
+
+- fix: release
+- Updated dependencies
+  - @contractspec/lib.contracts-runtime-server-graphql@3.7.9
+  - @contractspec/lib.contracts-runtime-server-rest@3.7.9
+  - @contractspec/lib.contracts-runtime-server-mcp@3.7.9
+  - @contractspec/lib.contracts-integrations@3.8.1
+  - @contractspec/module.context-storage@0.7.9
+  - @contractspec/lib.contracts-library@3.7.9
+  - @contractspec/lib.example-shared-ui@6.0.9
+  - @contractspec/lib.runtime-sandbox@2.7.8
+  - @contractspec/lib.surface-runtime@0.5.9
+  - @contractspec/lib.contracts-spec@4.1.1
+  - @contractspec/lib.design-system@3.8.2
+  - @contractspec/lib.content-gen@3.7.9
+  - @contractspec/module.examples@3.8.1
+  - @contractspec/lib.ui-kit-web@3.9.1
+  - @contractspec/lib.knowledge@3.7.9
+  - @contractspec/lib.ui-link@3.7.7
+  - @contractspec/lib.ai-providers@3.7.7
+  - @contractspec/lib.logger@3.7.7
+  - @contractspec/lib.provider-ranking@0.7.7
+  - @contractspec/lib.schema@3.7.7
+
 ## 3.7.6
 
 ### Patch Changes
@@ -231,6 +285,7 @@
 ### Patch Changes
 
 - 27b77db: feat(ai-models): add latest models and align defaults
+
   - Add claude-opus-4-6, claude-sonnet-4-6, claude-haiku-4-5, gpt-5.4, gpt-5-mini
   - Add mistral-large-2512, mistral-medium-2508, mistral-small-2506, devstral-2512
   - Add gemini-3.1-pro-preview, gemini-3.1-flash-lite-preview, gemini-3-flash-preview
@@ -380,6 +435,7 @@
 ### Patch Changes
 
 - 1fa29a0: feat(bundle.library): add LibraryBundle, WorkspaceShellRenderer, bundles export
+
   - Add LibraryBundle and bundles/index for workspace shell composition
   - Add WorkspaceShellRenderer component for dynamic slot rendering
   - Add @contractspec/lib.surface-runtime dependency

package/README.md

@@ -1,54 +1,76 @@
 # @contractspec/bundle.library
 
-Shared library bundle providing documentation pages, templates, MCP servers, and common UI components.
+**Shared library bundle that composes docs, templates, integrations, MCP implementations, and reusable presentation surfaces.**
 
-## Overview
+## What It Provides
 
-This bundle provides reusable components for the library experience:
-- Documentation pages (getting-started, integrations, architecture)
-- Template components (todos, recipes, CRM, messaging, etc.)
-- MCP (Model Context Protocol) servers for AI integration
-- Learning journey components
-- Auth providers
-- Marketing sections
+- Provides the reusable product-facing bundle consumed by API, web, and documentation surfaces.
+- Aggregates docs pages, integration marketplace UI, templates, and library-side MCP implementations.
+- Acts as the main composition layer between lower-level libraries and app-specific delivery shells.
+- `src/presentation/` contains presentation-layer components and renderers.
 
 ## Installation
 
-```bash
-bun add @contractspec/bundle.library
-```
+`npm install @contractspec/bundle.library`
 
-## Exports
+or
 
-### Application Layer
-- `application/mcp` — MCP server implementations (CLI, docs, internal)
+`bun add @contractspec/bundle.library`
 
-### Components
-- `components/docs/*` — Documentation pages by category
-- `components/templates/*` — Template implementations
-- `components/integrations/*` — Integration marketplace components
-- `components/learning/*` — Learning journey and coaching
-- `components/marketing/*` — Marketing sections and pages
+## Usage
 
-### Hooks
-- `hooks/studio/*` — Studio query and mutation hooks
+Import the root entrypoint from `@contractspec/bundle.library`, or choose a documented subpath when you only need one part of the package surface.
 
-### Infrastructure
-- `infrastructure/elysia` — Elysia HTTP utilities
-- `infrastructure/runtime-local-web` — Browser-based runtime
+## Architecture
 
-### Providers
-- `providers/auth` — Authentication context and guards
+- `src/application/` contains application services including MCP implementations and cross-surface orchestration.
+- `src/components/` contains reusable docs, integrations, legal, shell, and template presentation code.
+- `src/features/`, `src.config/`, `src.infrastructure/`, and `src.libs/` hold bundle-local composition helpers.
+- `src/presentation/` contains feature-specific UI composition exported to consuming apps.
+- `src/index.ts` is the root public barrel and package entrypoint.
 
-## Dependencies
+## Public Entry Points
 
-- `@contractspec/lib.design-system` — Design tokens
-- `@contractspec/lib.ui-kit-web` — UI components
-- `@contractspec/lib.contracts-library` — Library contracts
-- `@contractspec/lib.database-studio` — Database types
+- Large multi-subpath bundle exporting docs, integrations, templates, shell layout, email helpers, and MCP application surfaces.
+- Export `.` resolves through `./src/index.ts`.
+- Export `./application` resolves through `./src/application/index.ts`.
+- Export `./application/context-storage` resolves through `./src/application/context-storage/index.ts`.
+- Export `./application/mcp` resolves through `./src/application/mcp/index.ts`.
+- Export `./application/mcp/cliMcp` resolves through `./src/application/mcp/cliMcp.ts`.
+- Export `./application/mcp/common` resolves through `./src/application/mcp/common.ts`.
+- Export `./application/mcp/contractsMcp` resolves through `./src/application/mcp/contractsMcp.ts`.
+- Export `./application/mcp/contractsMcpResources` resolves through `./src/application/mcp/contractsMcpResources.ts`.
+- Export `./application/mcp/contractsMcpTools` resolves through `./src/application/mcp/contractsMcpTools.ts`.
+- Export `./application/mcp/contractsMcpTypes` resolves through `./src/application/mcp/contractsMcpTypes.ts`.
+- The package publishes 297 total export subpaths; keep docs aligned with `package.json`.
 
-## Related Packages
+## Local Commands
 
-- [`@contractspec/app.api-library`](../../apps/api-library/README.md) — API server
-- [`@contractspec/bundle.marketing`](../marketing/README.md) — Marketing bundle
-- [`@contractspec/bundle.studio`](../studio/README.md) — Studio bundle
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test
+- `bun run lint` — bun run lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rm -rf dist
+- `bun run build:bundle` — contractspec-bun-build transpile
+- `bun run build:types` — contractspec-bun-build types
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Package exports.
+- Vnext ai-native.
+- Add latest models and align defaults.
+- Standardize tool naming to underscore notation.
+- Add changesets and apply pending fixes.
+
+## Notes
+
+- This bundle is consumed by multiple apps — breaking export changes cascade widely.
+- MCP server implementations must stay transport-agnostic (the app layer wires the transport).
+- Keep side effects behind explicit adapters; do not perform I/O at import time.

package/dist/application/index.d.ts

@@ -1,2 +1,2 @@
-export * from './mcp';
 export * from './context-storage';
+export * from './mcp';