@contractspec/bundle.library 2.9.1 → 3.1.1

package/AGENTS.md

@@ -1,13 +1,15 @@
-# bundle.library
+# AI Agent Guide — `@contractspec/bundle.library`
+
+Scope: `packages/bundles/library/*`
 
 Shared library bundle with docs, templates, MCP servers, and common components.
 
 ## Quick Context
 
-- **Type**: Bundle (shared business logic)
+- **Layer**: bundle
 - **Consumers**: `app.api-library`, `app.web-landing`, `app.web-studio`
 
-## Key Directories
+## Architecture
 
 - `src/application/mcp/` — MCP server implementations
 - `src/components/docs/` — Documentation pages
@@ -16,18 +18,23 @@ Shared library bundle with docs, templates, MCP servers, and common components.
 - `src/hooks/studio/` — React hooks for GraphQL
 - `src/providers/auth/` — Authentication providers
 
-## Exports
+## Public Exports
 
 Use subpath imports:
+
 ```typescript
-import { ... } from '@contractspec/bundle.library/components/docs';
-import { ... } from '@contractspec/bundle.library/hooks/studio';
+import { ... } from "@contractspec/bundle.library/components/docs";
+import { ... } from "@contractspec/bundle.library/hooks/studio";
 ```
 
-## Commands
+## Guardrails
 
-```bash
-bun build       # Build bundle
-bun build:types # Type check
-bun lint        # Lint code
-```
+- 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.
+
+## Local Commands
+
+- Build: `bun run build`
+- Types: `bun run build:types`
+- Lint: `bun run lint`

package/CHANGELOG.md

@@ -1,5 +1,89 @@
 # @contractspec/bundle.library
 
+## 3.1.1
+
+### Patch Changes
+
+- f1a249b: Regenerate docs-index JSON files to reflect new provider-ranking, ACP, agent, context, and database contract documentation entries produced by the build.
+- Updated dependencies [02c0cc5]
+  - @contractspec/lib.contracts-integrations@3.1.1
+  - @contractspec/lib.contracts-spec@3.1.1
+  - @contractspec/lib.design-system@3.1.1
+  - @contractspec/lib.knowledge@3.1.1
+  - @contractspec/module.context-storage@0.1.2
+  - @contractspec/lib.contracts-library@3.1.1
+  - @contractspec/lib.contracts-runtime-server-graphql@3.1.1
+  - @contractspec/lib.contracts-runtime-server-mcp@3.1.1
+  - @contractspec/lib.contracts-runtime-server-rest@3.1.1
+  - @contractspec/lib.example-shared-ui@3.1.1
+  - @contractspec/module.examples@3.1.1
+
+## 3.1.0
+
+### Minor Changes
+
+- 28987eb: chore: upgrade dependencies
+
+### Patch Changes
+
+- Updated dependencies [f2a4faf]
+- Updated dependencies [28987eb]
+- Updated dependencies [28987eb]
+  - @contractspec/lib.contracts-spec@3.1.0
+  - @contractspec/lib.contracts-runtime-server-graphql@3.1.0
+  - @contractspec/lib.contracts-runtime-server-rest@3.1.0
+  - @contractspec/lib.contracts-runtime-server-mcp@3.1.0
+  - @contractspec/lib.contracts-integrations@3.1.0
+  - @contractspec/lib.contracts-library@3.1.0
+  - @contractspec/lib.example-shared-ui@3.1.0
+  - @contractspec/lib.runtime-sandbox@2.1.0
+  - @contractspec/lib.design-system@3.1.0
+  - @contractspec/module.examples@3.1.0
+  - @contractspec/lib.ui-kit-web@3.1.0
+  - @contractspec/lib.knowledge@3.1.0
+  - @contractspec/lib.ui-link@3.1.0
+  - @contractspec/lib.logger@3.1.0
+  - @contractspec/lib.schema@3.1.0
+  - @contractspec/module.context-storage@0.1.1
+
+## 3.0.0
+
+### Major Changes
+
+- b781ce6: feat: improve ai readiness
+
+### Patch Changes
+
+- 0c438ac: Add architecture docs for the control-plane runtime and link the new page from the architecture overview and docs navigation.
+- 95c27e4: Align ecosystem docs with the Cursor marketplace catalog model by documenting the root `.cursor-plugin/marketplace.json`, package-scoped plugin sources in `packages/apps-registry/cursor-marketplace`, and catalog-wide validation via `bun run plugin:contractspec:validate`.
+
+  Rename ecosystem navigation and docblocks from generic Plugin API and Registry wording to Marketplace Plugins, Authoring Templates, and Marketplace Manifest for consistent docs discoverability.
+
+- 3aa6269: Expand the integrations docs with Mistral, Slack, GitHub, WhatsApp Meta, WhatsApp Twilio, and health transport routing pages.
+
+  Refresh the integrations overview/spec model and docs sidebar links so the new messaging and runtime guidance is discoverable from web-landing.
+
+- Updated dependencies [7cbdb7f]
+- Updated dependencies [c608804]
+- Updated dependencies [e3bc858]
+- Updated dependencies [b19ae0a]
+- Updated dependencies [aa4a9c9]
+- Updated dependencies [b781ce6]
+  - @contractspec/lib.contracts-spec@3.0.0
+  - @contractspec/lib.contracts-integrations@3.0.0
+  - @contractspec/lib.contracts-runtime-server-graphql@3.0.0
+  - @contractspec/lib.contracts-runtime-server-rest@3.0.0
+  - @contractspec/lib.contracts-runtime-server-mcp@3.0.0
+  - @contractspec/lib.contracts-library@3.0.0
+  - @contractspec/lib.example-shared-ui@3.0.0
+  - @contractspec/lib.runtime-sandbox@2.0.0
+  - @contractspec/lib.design-system@3.0.0
+  - @contractspec/module.examples@3.0.0
+  - @contractspec/lib.ui-kit-web@3.0.0
+  - @contractspec/lib.ui-link@3.0.0
+  - @contractspec/lib.logger@3.0.0
+  - @contractspec/lib.schema@3.0.0
+
 ## 2.9.1
 
 ### Patch Changes

package/dist/application/context-storage/index.d.ts

@@ -0,0 +1,18 @@
+import type { DatabaseProvider, EmbeddingProvider, VectorStoreProvider } from '@contractspec/lib.contracts-integrations';
+import { DocumentProcessor, type VectorIndexConfig } from '@contractspec/lib.knowledge/ingestion';
+import { ContextSnapshotPipeline, PostgresContextStorage } from '@contractspec/module.context-storage';
+export interface ContextStorageServiceOptions {
+    database: DatabaseProvider;
+    schema?: string;
+    createTablesIfMissing?: boolean;
+    documentProcessor?: DocumentProcessor;
+    embeddingProvider?: EmbeddingProvider;
+    embeddingBatchSize?: number;
+    vectorStoreProvider?: VectorStoreProvider;
+    vectorIndex?: VectorIndexConfig;
+}
+export interface ContextStorageService {
+    store: PostgresContextStorage;
+    pipeline: ContextSnapshotPipeline;
+}
+export declare function createContextStorageService(options: ContextStorageServiceOptions): ContextStorageService;

package/dist/application/context-storage/index.js

@@ -0,0 +1,29 @@
+// @bun
+// src/application/context-storage/index.ts
+import {
+  EmbeddingService,
+  VectorIndexer
+} from "@contractspec/lib.knowledge/ingestion";
+import {
+  ContextSnapshotPipeline,
+  PostgresContextStorage
+} from "@contractspec/module.context-storage";
+function createContextStorageService(options) {
+  const store = new PostgresContextStorage({
+    database: options.database,
+    schema: options.schema,
+    createTablesIfMissing: options.createTablesIfMissing
+  });
+  const embeddingService = options.embeddingProvider ? new EmbeddingService(options.embeddingProvider, options.embeddingBatchSize) : undefined;
+  const vectorIndexer = options.vectorStoreProvider && options.vectorIndex ? new VectorIndexer(options.vectorStoreProvider, options.vectorIndex) : undefined;
+  const pipeline = new ContextSnapshotPipeline({
+    store,
+    documentProcessor: options.documentProcessor,
+    embeddingService,
+    vectorIndexer
+  });
+  return { store, pipeline };
+}
+export {
+  createContextStorageService
+};

package/dist/application/index.d.ts

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