@loom-framework/core 0.1.0-alpha.150 → 0.1.0-alpha.151

package/builtin-skills/app-skill/SKILL.md

@@ -29,4 +29,5 @@ version: 1.0.0
 
 - 数据模型结构、CLI 语法和操作规范：**references/models.md**
 - 语义引导（示例数据生成、筛选选择、关系推断）：**references/data-semantics.md**
-<!-- AUTH_REF -->
+<!-- AUTH_REF -->
+<!-- EVENTS_REF -->

package/builtin-skills/app-skill/references/events.md

@@ -0,0 +1,119 @@
+# 事件系统参考
+
+Loom 事件系统在数据变更和系统操作时自动触发事件，可用于通知、审计和自动化。
+
+## 事件模式格式
+
+事件使用 `category:action:target` 三段式模式：
+
+| 段 | 说明 | 示例 |
+|----|------|------|
+| category | 事件类别 | `data`, `user`, `skill`, `ai`, `session`, `file` |
+| action | 操作类型 | `create`, `update`, `delete`, `login`, `logout` |
+| target | 操作对象 | 模型名、`models`、技能名等 |
+
+## 通配符订阅
+
+| 通配符 | 匹配规则 | 示例 |
+|--------|----------|------|
+| `*` | 单段匹配 | `data:*:tasks` 匹配 `data:create:tasks`、`data:update:tasks` |
+| `**` | 任意深度匹配 | `data:**` 匹配所有 data 类事件 |
+
+## 数据事件（EventEmittingAdapter 自动触发）
+
+这些事件由 DataAdapter 操作自动触发，无需手动代码：
+
+| 事件模式 | 触发时机 | Payload 字段 |
+|----------|----------|-------------|
+| `data:create:<model>` | 创建记录 | model, id, data |
+| `data:update:<model>` | 更新记录 | model, id, data, previousData, changedFields |
+| `data:delete:<model>` | 删除记录 | model, id, previousData |
+| `data:import:<model>` | CSV 导入完成 | model, imported, errors |
+| `data:batch_delete:<model>` | 批量删除完成 | model, count, errors |
+
+## 认证事件
+
+| 事件模式 | 触发时机 | Payload 字段 |
+|----------|----------|-------------|
+| `user:login` | 用户登录 | userId, username, role |
+| `user:logout` | 用户登出 | userId |
+| `user:created` | 创建用户 | userId, username, role |
+| `user:updated` | 更新用户 | userId, username, role |
+| `user:deleted` | 删除用户 | userId |
+
+## 技能管理事件
+
+| 事件模式 | 触发时机 | Payload 字段 |
+|----------|----------|-------------|
+| `skill:created` | 创建技能 | skillName |
+| `skill:deleted` | 删除技能 | skillName |
+| `skill:file_updated` | 更新技能文件 | skillName, filename, path |
+
+## AI 配置事件
+
+| 事件模式 | 触发时机 | Payload 字段 |
+|----------|----------|-------------|
+| `ai:models_updated` | 模型列表更新 | count |
+
+## 会话事件
+
+| 事件模式 | 触发时机 | Payload 字段 |
+|----------|----------|-------------|
+| `session:created` | 创建会话 | sessionId |
+| `session:deleted` | 删除会话 | sessionId |
+| `session:truncated` | 截断会话消息 | sessionId, fromIndex |
+
+## 文件上传事件
+
+| 事件模式 | 触发时机 | Payload 字段 |
+|----------|----------|-------------|
+| `file:uploaded` | 文件上传成功 | filename, sessionId, path, size |
+
+## 配置声明式订阅
+
+在 `loom.config.ts` 中声明事件处理器：
+
+```typescript
+export default defineConfig({
+  // ...
+  events: {
+    subscriptions: [
+      {
+        pattern: 'data:create:orders',
+        handler: 'webhook',
+        config: { url: 'https://example.com/webhook' },
+      },
+      {
+        pattern: 'user:login',
+        handler: 'log',
+        config: { level: 'info' },
+      },
+    ],
+  },
+});
+```
+
+## 事件 API
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/api/v1/events/notify` | POST | 外部事件注入（CLI 使用） |
+| `/api/v1/events/patterns` | GET | 查看已注册的事件模式 |
+
+### POST /api/v1/events/notify
+
+```json
+{
+  "pattern": "data:create:tasks",
+  "payload": { "model": "tasks", "id": "rec_123" },
+  "source": "cli"
+}
+```
+
+## 订阅可用处理器
+
+| handler | 说明 | config 字段 |
+|---------|------|------------|
+| `log` | 写入服务器日志 | `level`: info/debug/warn |
+| `webhook` | 发送 HTTP 请求 | `url`, `method`, `headers` |
+| `process` | 启动进程（未来） | `process`, `filter` |

package/dist/backend/auth/request-context.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Request-scoped context via AsyncLocalStorage
+ *
+ * Allows EventEmittingAdapter to access userId from the current
+ * HTTP request without coupling to the Fastify request object.
+ */
+interface RequestContext {
+    userId?: string;
+}
+/** Get the current request context (undefined if outside a request) */
+export declare function getRequestContext(): RequestContext | undefined;
+/** Set context for the current async execution path */
+export declare function setRequestContext(ctx: RequestContext): void;
+export {};
+//# sourceMappingURL=request-context.d.ts.map

package/dist/backend/auth/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../../src/backend/auth/request-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,uEAAuE;AACvE,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED,uDAAuD;AACvD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAE3D"}

package/dist/backend/auth/request-context.js

@@ -0,0 +1,17 @@
+/**
+ * Request-scoped context via AsyncLocalStorage
+ *
+ * Allows EventEmittingAdapter to access userId from the current
+ * HTTP request without coupling to the Fastify request object.
+ */
+import { AsyncLocalStorage } from 'async_hooks';
+const asyncLocalStorage = new AsyncLocalStorage();
+/** Get the current request context (undefined if outside a request) */
+export function getRequestContext() {
+    return asyncLocalStorage.getStore();
+}
+/** Set context for the current async execution path */
+export function setRequestContext(ctx) {
+    asyncLocalStorage.enterWith(ctx);
+}
+//# sourceMappingURL=request-context.js.map

package/dist/backend/auth/request-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../../src/backend/auth/request-context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAMhD,MAAM,iBAAiB,GAAG,IAAI,iBAAiB,EAAkB,CAAC;AAElE,uEAAuE;AACvE,MAAM,UAAU,iBAAiB;IAC/B,OAAO,iBAAiB,CAAC,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,iBAAiB,CAAC,GAAmB;IACnD,iBAAiB,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AACnC,CAAC"}

package/dist/backend/events/event-bus.d.ts

@@ -0,0 +1,39 @@
+/**
+ * EventBus - Universal event bus with pattern matching and batch support
+ *
+ * - Pattern matching: `data:create:tasks`, `data:*:tasks`, `data:**`, `*:create:*`
+ * - Wildcards: `*` = single segment (`[^:]+`), `**` = any depth (`.*`)
+ * - Fire-and-forget emit: handler errors are caught and logged, never propagated
+ * - beginBatch/endBatch: suppress fine-grained events, emit aggregate only
+ * - Circular detection: warn when emit depth exceeds 10
+ */
+import type { LoomEvent, EventMeta } from '../../types/event.js';
+type EventHandler = (event: LoomEvent) => void | Promise<void>;
+export declare class EventBus {
+    private handlers;
+    private wildcards;
+    private patternCache;
+    private batchStack;
+    private suppressedEvents;
+    private emitDepth;
+    /** Subscribe to an event pattern. Returns unsubscribe function. */
+    on(pattern: string, handler: EventHandler): () => void;
+    /** Unsubscribe a handler from a pattern. */
+    off(pattern: string, handler: EventHandler): void;
+    /** Emit an event — fire-and-forget. Handler errors are caught and logged. */
+    emit(pattern: string, payload: Record<string, unknown>, meta?: EventMeta): void;
+    /** Check if a pattern has any subscribers (for previousData optimization). */
+    hasSubscribers(pattern: string): boolean;
+    /** Begin a batch operation. Returns batchId. */
+    beginBatch(batchPattern: string): string;
+    /** End a batch operation. Emits aggregate event with merged payload. */
+    endBatch(batchId: string, payload: Record<string, unknown>, meta?: EventMeta): void;
+    /** Remove all handlers (for server shutdown). */
+    removeAllHandlers(): void;
+    /** Dispatch event to all matching handlers. Fire-and-forget: errors are caught, never propagated. */
+    private dispatch;
+    /** Compile a pattern string to a RegExp. Caches compiled patterns. */
+    private compilePattern;
+}
+export {};
+//# sourceMappingURL=event-bus.d.ts.map

package/dist/backend/events/event-bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.d.ts","sourceRoot":"","sources":["../../../src/backend/events/event-bus.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjE,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAQ/D,qBAAa,QAAQ;IACnB,OAAO,CAAC,QAAQ,CAA0C;IAC1D,OAAO,CAAC,SAAS,CAAuB;IACxC,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,UAAU,CAAmD;IACrE,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,SAAS,CAAK;IAEtB,mEAAmE;IACnE,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,IAAI;IAuBtD,4CAA4C;IAC5C,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAejD,6EAA6E;IAC7E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI;IA4B/E,8EAA8E;IAC9E,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAOxC,gDAAgD;IAChD,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAMxC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,IAAI;IAkBnF,iDAAiD;IACjD,iBAAiB,IAAI,IAAI;IAQzB,qGAAqG;IACrG,OAAO,CAAC,QAAQ;IAkChB,sEAAsE;IACtE,OAAO,CAAC,cAAc;CAwBvB"}

package/dist/backend/events/event-bus.js

@@ -0,0 +1,182 @@
+/**
+ * EventBus - Universal event bus with pattern matching and batch support
+ *
+ * - Pattern matching: `data:create:tasks`, `data:*:tasks`, `data:**`, `*:create:*`
+ * - Wildcards: `*` = single segment (`[^:]+`), `**` = any depth (`.*`)
+ * - Fire-and-forget emit: handler errors are caught and logged, never propagated
+ * - beginBatch/endBatch: suppress fine-grained events, emit aggregate only
+ * - Circular detection: warn when emit depth exceeds 10
+ */
+export class EventBus {
+    handlers = new Map();
+    wildcards = [];
+    patternCache = new Map();
+    batchStack = [];
+    suppressedEvents = [];
+    emitDepth = 0;
+    /** Subscribe to an event pattern. Returns unsubscribe function. */
+    on(pattern, handler) {
+        if (pattern.includes('*')) {
+            const regex = this.compilePattern(pattern);
+            this.wildcards.push({ pattern, regex, handler });
+            return () => {
+                const idx = this.wildcards.findIndex(w => w.pattern === pattern && w.handler === handler);
+                if (idx !== -1)
+                    this.wildcards.splice(idx, 1);
+            };
+        }
+        const list = this.handlers.get(pattern) ?? [];
+        list.push(handler);
+        this.handlers.set(pattern, list);
+        return () => {
+            const arr = this.handlers.get(pattern);
+            if (arr) {
+                const idx = arr.indexOf(handler);
+                if (idx !== -1)
+                    arr.splice(idx, 1);
+                if (arr.length === 0)
+                    this.handlers.delete(pattern);
+            }
+        };
+    }
+    /** Unsubscribe a handler from a pattern. */
+    off(pattern, handler) {
+        if (pattern.includes('*')) {
+            const idx = this.wildcards.findIndex(w => w.pattern === pattern && w.handler === handler);
+            if (idx !== -1)
+                this.wildcards.splice(idx, 1);
+            return;
+        }
+        const arr = this.handlers.get(pattern);
+        if (arr) {
+            const idx = arr.indexOf(handler);
+            if (idx !== -1)
+                arr.splice(idx, 1);
+            if (arr.length === 0)
+                this.handlers.delete(pattern);
+        }
+    }
+    /** Emit an event — fire-and-forget. Handler errors are caught and logged. */
+    emit(pattern, payload, meta) {
+        this.emitDepth++;
+        if (this.emitDepth > 10) {
+            console.warn(`[EventBus] Circular emit detected (depth=${this.emitDepth}) for pattern: ${pattern}`);
+        }
+        try {
+            const event = {
+                id: `evt_${Date.now()}_${Math.random().toString(36).substring(2, 10)}`,
+                pattern,
+                payload,
+                userId: meta?.userId,
+                source: meta?.source ?? 'server',
+                timestamp: new Date().toISOString(),
+            };
+            // If inside a batch, suppress the event
+            if (this.batchStack.length > 0) {
+                this.suppressedEvents.push(event);
+                return;
+            }
+            this.dispatch(event);
+        }
+        finally {
+            this.emitDepth--;
+        }
+    }
+    /** Check if a pattern has any subscribers (for previousData optimization). */
+    hasSubscribers(pattern) {
+        if (this.handlers.has(pattern) && this.handlers.get(pattern).length > 0) {
+            return true;
+        }
+        return this.wildcards.some(w => w.regex.test(pattern));
+    }
+    /** Begin a batch operation. Returns batchId. */
+    beginBatch(batchPattern) {
+        const batchId = `batch_${Date.now()}_${Math.random().toString(36).substring(2, 10)}`;
+        this.batchStack.push({ batchId, pattern: batchPattern });
+        return batchId;
+    }
+    /** End a batch operation. Emits aggregate event with merged payload. */
+    endBatch(batchId, payload, meta) {
+        const idx = this.batchStack.findIndex(b => b.batchId === batchId);
+        if (idx === -1)
+            return;
+        const batch = this.batchStack[idx];
+        // Remove from stack
+        this.batchStack.splice(idx, 1);
+        // Clear suppressed events when batch stack is empty
+        if (this.batchStack.length === 0) {
+            this.suppressedEvents = [];
+        }
+        // Emit aggregate event using the stored pattern
+        this.emit(batch.pattern, payload, meta);
+    }
+    /** Remove all handlers (for server shutdown). */
+    removeAllHandlers() {
+        this.handlers.clear();
+        this.wildcards = [];
+        this.patternCache.clear();
+        this.batchStack = [];
+        this.suppressedEvents = [];
+    }
+    /** Dispatch event to all matching handlers. Fire-and-forget: errors are caught, never propagated. */
+    dispatch(event) {
+        // Exact match handlers
+        const exactHandlers = this.handlers.get(event.pattern) ?? [];
+        for (const handler of exactHandlers) {
+            try {
+                const result = handler(event);
+                // If handler returns a promise, catch its rejection silently
+                if (result instanceof Promise) {
+                    result.catch(err => {
+                        console.error(`[EventBus] Async handler error for ${event.pattern}:`, err);
+                    });
+                }
+            }
+            catch (err) {
+                console.error(`[EventBus] Handler error for ${event.pattern}:`, err);
+            }
+        }
+        // Wildcard handlers
+        for (const entry of this.wildcards) {
+            if (entry.regex.test(event.pattern)) {
+                try {
+                    const result = entry.handler(event);
+                    if (result instanceof Promise) {
+                        result.catch(err => {
+                            console.error(`[EventBus] Async handler error for wildcard ${entry.pattern}:`, err);
+                        });
+                    }
+                }
+                catch (err) {
+                    console.error(`[EventBus] Handler error for wildcard ${entry.pattern}:`, err);
+                }
+            }
+        }
+    }
+    /** Compile a pattern string to a RegExp. Caches compiled patterns. */
+    compilePattern(pattern) {
+        const cached = this.patternCache.get(pattern);
+        if (cached)
+            return cached;
+        // Lone `*` matches everything
+        if (pattern === '*') {
+            const regex = /^.*$/;
+            this.patternCache.set(pattern, regex);
+            return regex;
+        }
+        const regexStr = pattern
+            .split(':')
+            .map(segment => {
+            if (segment === '**')
+                return '.*';
+            if (segment.includes('*'))
+                return segment.replace(/\*/g, '[^:]+');
+            return segment;
+        })
+            .join(':');
+        const regex = new RegExp(`^${regexStr}$`);
+        this.patternCache.set(pattern, regex);
+        return regex;
+    }
+}
+//# sourceMappingURL=event-bus.js.map

package/dist/backend/events/event-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-bus.js","sourceRoot":"","sources":["../../../src/backend/events/event-bus.ts"],"names":[],"mappings":"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"}

package/dist/backend/events/event-emitting-adapter.d.ts

@@ -0,0 +1,31 @@
+/**
+ * EventEmittingAdapter - Decorator that wraps DataAdapter to auto-emit events
+ *
+ * - write() → emits data:create:<model> with { model, id, data }
+ * - update() → emits data:update:<model> with { model, id, data, previousData, changedFields }
+ * - delete() → emits data:delete:<model> with { model, id, previousData }
+ * - hasSubscribers() optimization: skips previousData read when no subscribers
+ * - Events only emitted after inner operation succeeds
+ * - getUserId callback for injecting userId (auth-aware)
+ */
+import type { DataAdapter, DataRecord, ReadOptions } from '../../types/adapter.js';
+import type { ModelSchema } from '../../types/model.js';
+import type { EventBus } from './event-bus.js';
+export declare class EventEmittingAdapter implements DataAdapter {
+    private inner;
+    private eventBus;
+    private source;
+    private getUserId?;
+    readonly name: string;
+    constructor(inner: DataAdapter, eventBus: EventBus, source: 'server' | 'cli', getUserId?: (() => string | undefined) | undefined);
+    write(model: string, data: DataRecord): Promise<DataRecord>;
+    update(model: string, id: string, data: DataRecord): Promise<DataRecord>;
+    delete(model: string, id: string): Promise<void>;
+    read(model: string, options?: ReadOptions): Promise<DataRecord | DataRecord[] | null>;
+    count(model: string, options?: Omit<ReadOptions, 'limit' | 'offset' | 'sort'>): Promise<number>;
+    getSchema(model: string): Promise<ModelSchema | undefined>;
+    listModels(): Promise<string[]>;
+    initialize(): Promise<void>;
+    healthCheck(): Promise<boolean>;
+}
+//# sourceMappingURL=event-emitting-adapter.d.ts.map

package/dist/backend/events/event-emitting-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitting-adapter.d.ts","sourceRoot":"","sources":["../../../src/backend/events/event-emitting-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,qBAAa,oBAAqB,YAAW,WAAW;IAIpD,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,SAAS,CAAC;IANpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAGZ,KAAK,EAAE,WAAW,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,QAAQ,GAAG,KAAK,EACxB,SAAS,CAAC,GAAE,MAAM,MAAM,GAAG,SAAS,aAAA;IAKxC,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAU3D,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAiBxE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAehD,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,GAAG,UAAU,EAAE,GAAG,IAAI,CAAC;IAIrF,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAI/F,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAI1D,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAI/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;CAGtC"}

package/dist/backend/events/event-emitting-adapter.js

@@ -0,0 +1,70 @@
+/**
+ * EventEmittingAdapter - Decorator that wraps DataAdapter to auto-emit events
+ *
+ * - write() → emits data:create:<model> with { model, id, data }
+ * - update() → emits data:update:<model> with { model, id, data, previousData, changedFields }
+ * - delete() → emits data:delete:<model> with { model, id, previousData }
+ * - hasSubscribers() optimization: skips previousData read when no subscribers
+ * - Events only emitted after inner operation succeeds
+ * - getUserId callback for injecting userId (auth-aware)
+ */
+import { EventPatterns } from '../../types/event.js';
+export class EventEmittingAdapter {
+    inner;
+    eventBus;
+    source;
+    getUserId;
+    name;
+    constructor(inner, eventBus, source, getUserId) {
+        this.inner = inner;
+        this.eventBus = eventBus;
+        this.source = source;
+        this.getUserId = getUserId;
+        this.name = `event-emitting:${inner.name}`;
+    }
+    async write(model, data) {
+        const record = await this.inner.write(model, data);
+        void this.eventBus.emit(EventPatterns.DATA_CREATE(model), { model, id: record.id, data: record }, { userId: this.getUserId?.(), source: this.source });
+        return record;
+    }
+    async update(model, id, data) {
+        const pattern = EventPatterns.DATA_UPDATE(model);
+        const previous = this.eventBus.hasSubscribers(pattern)
+            ? await this.inner.read(model, { id }).catch(() => null)
+            : null;
+        const record = await this.inner.update(model, id, data);
+        const changedFields = previous
+            ? Object.keys(data).filter(k => data[k] !== previous?.[k])
+            : undefined;
+        void this.eventBus.emit(pattern, { model, id, data: record, previousData: previous ?? undefined, changedFields }, { userId: this.getUserId?.(), source: this.source });
+        return record;
+    }
+    async delete(model, id) {
+        const pattern = EventPatterns.DATA_DELETE(model);
+        const previous = this.eventBus.hasSubscribers(pattern)
+            ? await this.inner.read(model, { id }).catch(() => null)
+            : null;
+        await this.inner.delete(model, id);
+        void this.eventBus.emit(pattern, { model, id, previousData: previous ?? undefined }, { userId: this.getUserId?.(), source: this.source });
+    }
+    // ── Pure delegation (no events for read operations) ──
+    async read(model, options) {
+        return this.inner.read(model, options);
+    }
+    async count(model, options) {
+        return this.inner.count(model, options);
+    }
+    async getSchema(model) {
+        return this.inner.getSchema(model);
+    }
+    async listModels() {
+        return this.inner.listModels();
+    }
+    async initialize() {
+        return this.inner.initialize();
+    }
+    async healthCheck() {
+        return this.inner.healthCheck();
+    }
+}
+//# sourceMappingURL=event-emitting-adapter.js.map

package/dist/backend/events/event-emitting-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitting-adapter.js","sourceRoot":"","sources":["../../../src/backend/events/event-emitting-adapter.ts"],"names":[],"mappings":"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"}

package/dist/backend/events/event-registry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * EventRegistry - Tracks registered event patterns (P0 internal use only)
+ *
+ * Provides introspection for GET /api/v1/events/patterns (P1 API).
+ * Currently used internally by capability-generator for events.md generation.
+ */
+export declare class EventRegistry {
+    private patterns;
+    register(pattern: string, category: string, description: string, payloadShape: string): void;
+    isRegistered(pattern: string): boolean;
+    getPatterns(): Array<{
+        pattern: string;
+        category: string;
+        description: string;
+        payloadShape: string;
+    }>;
+    getByCategory(category: string): Array<{
+        pattern: string;
+        category: string;
+        description: string;
+        payloadShape: string;
+    }>;
+}
+//# sourceMappingURL=event-registry.d.ts.map

package/dist/backend/events/event-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-registry.d.ts","sourceRoot":"","sources":["../../../src/backend/events/event-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAA2F;IAE3G,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IAI5F,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAItC,WAAW,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IAItG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CAGzH"}

package/dist/backend/events/event-registry.js

@@ -0,0 +1,22 @@
+/**
+ * EventRegistry - Tracks registered event patterns (P0 internal use only)
+ *
+ * Provides introspection for GET /api/v1/events/patterns (P1 API).
+ * Currently used internally by capability-generator for events.md generation.
+ */
+export class EventRegistry {
+    patterns = new Map();
+    register(pattern, category, description, payloadShape) {
+        this.patterns.set(pattern, { category, description, payloadShape });
+    }
+    isRegistered(pattern) {
+        return this.patterns.has(pattern);
+    }
+    getPatterns() {
+        return Array.from(this.patterns.entries()).map(([pattern, info]) => ({ pattern, ...info }));
+    }
+    getByCategory(category) {
+        return this.getPatterns().filter(p => p.category === category);
+    }
+}
+//# sourceMappingURL=event-registry.js.map

package/dist/backend/events/event-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-registry.js","sourceRoot":"","sources":["../../../src/backend/events/event-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,OAAO,aAAa;IAChB,QAAQ,GAAiF,IAAI,GAAG,EAAE,CAAC;IAE3G,QAAQ,CAAC,OAAe,EAAE,QAAgB,EAAE,WAAmB,EAAE,YAAoB;QACnF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,YAAY,CAAC,OAAe;QAC1B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,WAAW;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IAC9F,CAAC;IAED,aAAa,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/backend/events/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Events Module - Barrel Export
+ */
+export { EventBus } from './event-bus.js';
+export { EventEmittingAdapter } from './event-emitting-adapter.js';
+export { EventRegistry } from './event-registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/backend/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/backend/events/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/backend/events/index.js

@@ -0,0 +1,7 @@
+/**
+ * Events Module - Barrel Export
+ */
+export { EventBus } from './event-bus.js';
+export { EventEmittingAdapter } from './event-emitting-adapter.js';
+export { EventRegistry } from './event-registry.js';
+//# sourceMappingURL=index.js.map

package/dist/backend/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/backend/events/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/backend/index.d.ts

@@ -13,6 +13,8 @@ import type { AIEngine } from '../types/ai.js';
 import type { DataAdapter } from '../types/adapter.js';
 import { UserStore } from './auth/user-store.js';
 import { TokenStore } from './auth/token-store.js';
+import { EventBus } from './events/event-bus.js';
+import { EventRegistry } from './events/event-registry.js';
 export interface LoomServerOptions {
     /** Project root directory containing loom.config.ts */
     projectRoot: string;
@@ -34,6 +36,8 @@ export declare class LoomServer {
     private fastify;
     private userStore?;
     private tokenStore?;
+    private eventBus?;
+    private eventRegistry?;
     private projectRoot;
     private options;
     constructor(options: LoomServerOptions);
@@ -59,6 +63,10 @@ export declare class LoomServer {
     getUserStore(): UserStore | undefined;
     /** Expose token store for testing */
     getTokenStore(): TokenStore | undefined;
+    /** Expose event bus for testing */
+    getEventBus(): EventBus | undefined;
+    /** Expose event registry for testing */
+    getEventRegistry(): EventRegistry | undefined;
 }
 /**
  * Create and start a LoomServer from a project root

package/dist/backend/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAM9B,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAUvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACrC,kEAAkE;IAClE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAoB;gBAEvB,OAAO,EAAE,iBAAiB;IAKtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiIjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAO3B,0CAA0C;IAC1C,UAAU,IAAI,UAAU,CAAC,OAAO,OAAO,CAAC;IAIxC,gCAAgC;IAChC,SAAS,IAAI,UAAU;IAIvB,iCAAiC;IACjC,UAAU,IAAI,WAAW;IAIzB,oCAAoC;IACpC,YAAY,IAAI,SAAS,GAAG,SAAS;IAIrC,qCAAqC;IACrC,aAAa,IAAI,UAAU,GAAG,SAAS;CAGxC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAK1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,OAAO,MAAM,SAAS,CAAC;AAM9B,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAUvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAG3D,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,WAAW,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACrC,kEAAkE;IAClE,MAAM,CAAC,EAAE,QAAQ,CAAC;IAClB,qEAAqE;IACrE,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAY;IAC9B,OAAO,CAAC,UAAU,CAAC,CAAa;IAChC,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAoB;gBAEvB,OAAO,EAAE,iBAAiB;IAKtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA6MjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAO5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B,0CAA0C;IAC1C,UAAU,IAAI,UAAU,CAAC,OAAO,OAAO,CAAC;IAIxC,gCAAgC;IAChC,SAAS,IAAI,UAAU;IAIvB,iCAAiC;IACjC,UAAU,IAAI,WAAW;IAIzB,oCAAoC;IACpC,YAAY,IAAI,SAAS,GAAG,SAAS;IAIrC,qCAAqC;IACrC,aAAa,IAAI,UAAU,GAAG,SAAS;IAIvC,mCAAmC;IACnC,WAAW,IAAI,QAAQ,GAAG,SAAS;IAInC,wCAAwC;IACxC,gBAAgB,IAAI,aAAa,GAAG,SAAS;CAG9C;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAK1E"}