mcp-event-intelligence 0.2.0 → 0.2.1

package/CHANGELOG.md

@@ -2,6 +2,21 @@
 
 All notable public changes are documented here.
 
+## [0.2.1] - 2026-09-20
+
+Patch hardening for shutdown determinism and multi-tenant verification.
+
+### Fixed
+
+- host shutdown now drains in-flight MCP polling, temporal/wake schedulers and persistent JSONL writes before returning;
+- prevents background writes from racing temporary-directory cleanup and causing intermittent `ENOTEMPTY` failures;
+- scoped isolation regression coverage now includes event source discovery, MCP client state/cursors, occurrences, audit records and wake visibility.
+
+### Clarified
+
+- the exported ERPNext helper is a typed MCP Events provider factory, not a credential-owning ERP connector;
+- the production authenticated ERPNext implementation remains in `world-capability-mcp`, where real data access, tenant/company filtering, pagination, cursors and timezone handling are implemented.
+
 ## [0.2.0] - 2026-09-20
 
 Production-hardening release for shared Event Intelligence hosts.

package/README.md

@@ -4,7 +4,7 @@
 
 [![CI](https://github.com/sarooo17/event-intelligence/actions/workflows/ci.yml/badge.svg)](https://github.com/sarooo17/event-intelligence/actions/workflows/ci.yml)
 [![npm](https://img.shields.io/npm/v/mcp-event-intelligence.svg)](https://www.npmjs.com/package/mcp-event-intelligence)
-[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-v0.2.0-5b5bd6)](https://registry.modelcontextprotocol.io/?q=io.github.sarooo17%2Fevent-intelligence)
+[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-v0.2.1-5b5bd6)](https://registry.modelcontextprotocol.io/?q=io.github.sarooo17%2Fevent-intelligence)
 [![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
 
 MCP Event Intelligence is an experimental event runtime for agents that need to react to **future conditions over multiple event sources** without keeping an LLM or agent loop alive.
@@ -125,7 +125,7 @@ The package owns capability advertisement, `server/discover`, `events/list`, `ev
 This adapter remains experimental compatibility work around MCP Events; it is not a claim of finalized MCP Events conformance.
 
 
-A concrete ERP-shaped adapter is also exported, so the provider abstraction is exercised against a source structurally different from GitHub:
+An ERPNext-shaped **provider factory** is also exported:
 
 ```js
 import {
@@ -140,7 +140,19 @@ const events = createErpNextEventsProvider({
 });
 ```
 
-It exposes `erpnext.sales_invoice.submitted` and `erpnext.sales_order.created` while leaving ERP authentication/query ownership with the provider.
+This helper owns the MCP Events descriptors, schemas and response validation for
+`erpnext.sales_invoice.submitted` and `erpnext.sales_order.created`. It is
+**not** a credential-owning ERPNext connector: the host/provider must supply the
+actual data-access functions. That separation is intentional so Event
+Intelligence never duplicates provider authentication.
+
+The production proof that the abstraction works against a real ERP data layer
+lives in `sarooo17/world-capability-mcp`: its ERP Events implementation uses
+`createMcpEventsProvider` with authenticated ERPNext/Frappe record queries,
+tenant/company filters, opaque replay-safe cursors, pagination/`hasMore`,
+timezone normalization and deterministic occurrence IDs. The local factory in
+this package should therefore be read as a typed convenience API, not as the
+production ERP connector itself.
 
 ## What v0.1 implements
 

package/bin/mcp-event-intelligence.mjs

@@ -4,7 +4,7 @@ const args = process.argv.slice(2);
 const flags = new Set(args);
 
 if (flags.has('--version') || flags.has('-v')) {
-  console.log('0.2.0');
+  console.log('0.2.1');
   process.exit(0);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-event-intelligence",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Durable temporal event intelligence for agent hosts: host-owned MCP event discovery, composite triggers, derived events, and targeted wakeups.",
   "license": "Apache-2.0",
   "type": "module",

package/scripts/lib/local-event-intelligence-runtime.mjs

@@ -275,9 +275,11 @@ export async function createLocalEventIntelligenceRuntime({
       wakeRetryScheduler,
       wakeCoordinator,
       wakeCoordinators,
-      close() {
-        temporalScheduler.stop();
-        wakeRetryScheduler.stop();
+      async close() {
+        await Promise.all([
+          temporalScheduler.close(),
+          wakeRetryScheduler.close(),
+        ]);
       },
     };
     scopeContexts.set(scopeId, context);
@@ -329,9 +331,17 @@ export async function createLocalEventIntelligenceRuntime({
       return [...scopeContexts.keys()].sort();
     },
     async close() {
-      mcpEventsClient.stop();
-      for (const context of scopeContexts.values()) {
-        context.close();
+      await mcpEventsClient.close();
+      const contexts = [...scopeContexts.values()];
+      await Promise.all(contexts.map((context) => context.close()));
+
+      const stores = new Set(contexts.map((context) => context.store));
+      for (const store of stores) {
+        if (typeof store.close === 'function') {
+          await store.close();
+        } else if (typeof store.drain === 'function') {
+          await store.drain();
+        }
       }
     },
   };

package/scripts/lib/mcp-events-client.mjs

@@ -599,6 +599,17 @@ export class McpEventsClientManager {
     this.intervals.clear();
   }
 
+  async drain() {
+    while (this.pollInFlight.size > 0) {
+      await Promise.allSettled([...this.pollInFlight.values()]);
+    }
+  }
+
+  async close() {
+    this.stop();
+    await this.drain();
+  }
+
   status() {
     return [...this.connections.values()].map((connection) => {
       const context = this.scopeContexts.get(

package/scripts/lib/persistent-event-store.mjs

@@ -1057,6 +1057,18 @@ export class PersistentEventStore {
     return this.#auditChain.verify();
   }
 
+  async drain() {
+    await this.#queue;
+    const scoped = [...this.#scopeStores.values()];
+    await Promise.all(scoped.map((store) =>
+      typeof store.drain === 'function' ? store.drain() : undefined
+    ));
+  }
+
+  async close() {
+    await this.drain();
+  }
+
   #eventKey(lineage) {
     return `${lineage.environmentId}:${lineage.subscriptionId}:${lineage.sourceEventId}`;
   }

package/scripts/lib/temporal-deadline-scheduler.mjs

@@ -104,8 +104,18 @@ export class TemporalDeadlineScheduler {
   }
 
   stop() {
-    if (!this.timer) return;
-    clearInterval(this.timer);
+    if (this.timer) clearInterval(this.timer);
     this.timer = null;
   }
+
+  async drain() {
+    while (this.running) {
+      await new Promise((resolve) => setImmediate(resolve));
+    }
+  }
+
+  async close() {
+    this.stop();
+    await this.drain();
+  }
 }

package/scripts/lib/wake-retry-scheduler.mjs

@@ -87,8 +87,18 @@ export class WakeRetryScheduler {
   }
 
   stop() {
-    if (!this.timer) return;
-    clearInterval(this.timer);
+    if (this.timer) clearInterval(this.timer);
     this.timer = null;
   }
+
+  async drain() {
+    while (this.running) {
+      await new Promise((resolve) => setImmediate(resolve));
+    }
+  }
+
+  async close() {
+    this.stop();
+    await this.drain();
+  }
 }

package/scripts/mcp-stdio-server.mjs

@@ -341,7 +341,7 @@ export async function buildEventIntelligenceMcpServer({
   const server = new McpServer(
     {
       name: 'mcp-event-intelligence',
-      version: '0.2.0',
+      version: '0.2.1',
     },
     {
       instructions:

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.sarooo17/event-intelligence",
   "title": "MCP Event Intelligence",
   "description": "Durable temporal event intelligence: composite triggers, derived events, and runtime wakeups.",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "repository": {
     "url": "https://github.com/sarooo17/event-intelligence",
     "source": "github"
@@ -13,7 +13,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "mcp-event-intelligence",
-      "version": "0.2.0",
+      "version": "0.2.1",
       "transport": {
         "type": "stdio"
       },