@loom-framework/core 0.1.0-alpha.19 → 0.1.0-alpha.191

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":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,OAAO,oBAAoB;IAIrB;IACA;IACA;IACA;IAND,IAAI,CAAS;IAEtB,YACU,KAAkB,EAClB,QAAkB,EAClB,MAAwB,EACxB,SAAoC;QAHpC,UAAK,GAAL,KAAK,CAAa;QAClB,aAAQ,GAAR,QAAQ,CAAU;QAClB,WAAM,GAAN,MAAM,CAAkB;QACxB,cAAS,GAAT,SAAS,CAA2B;QAE5C,IAAI,CAAC,IAAI,GAAG,kBAAkB,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,IAAgB;QACzC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACnD,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CACrB,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,EAChC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,CAAC,EAAY,EAAE,IAAI,EAAE,MAAM,EAAE,EAChD,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACpD,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,EAAU,EAAE,IAAgB;QACtD,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC;YACpD,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YACxD,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;QACxD,MAAM,aAAa,GAAG,QAAQ;YAC5B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAM,QAAoC,EAAE,CAAC,CAAC,CAAC,CAAC;YACvF,CAAC,CAAC,SAAS,CAAC;QACd,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CACrB,OAAO,EACP,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,IAAI,SAAS,EAAE,aAAa,EAAE,EAC/E,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACpD,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,EAAU;QACpC,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,OAAO,CAAC;YACpD,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;YACxD,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACnC,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CACrB,OAAO,EACP,EAAE,KAAK,EAAE,EAAE,EAAE,YAAY,EAAE,QAAQ,IAAI,SAAS,EAAE,EAClD,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CACpD,CAAC;IACJ,CAAC;IAED,wDAAwD;IAExD,KAAK,CAAC,IAAI,CAAC,KAAa,EAAE,OAAqB;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAa,EAAE,OAAwD;QACjF,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,CAAC;CACF"}

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

@@ -0,0 +1,22 @@
+/**
+ * EventRegistry - Tracks registered event patterns for discoverability
+ *
+ * Provides introspection for GET /api/v1/events/patterns API
+ * and capability-generator for events.md generation.
+ */
+export interface PatternInfo {
+    pattern: string;
+    category: string;
+    description: string;
+    payloadShape: string;
+}
+export declare class EventRegistry {
+    private patterns;
+    register(pattern: string, category: string, description: string, payloadShape: string): void;
+    unregister(pattern: string): boolean;
+    unregisterByPrefix(prefix: string): number;
+    isRegistered(pattern: string): boolean;
+    getPatterns(): PatternInfo[];
+    getByCategory(category: string): PatternInfo[];
+}
+//# 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,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,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,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIpC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAW1C,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAItC,WAAW,IAAI,WAAW,EAAE;IAI5B,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;CAG/C"}

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

@@ -0,0 +1,35 @@
+/**
+ * EventRegistry - Tracks registered event patterns for discoverability
+ *
+ * Provides introspection for GET /api/v1/events/patterns API
+ * and capability-generator for events.md generation.
+ */
+export class EventRegistry {
+    patterns = new Map();
+    register(pattern, category, description, payloadShape) {
+        this.patterns.set(pattern, { category, description, payloadShape });
+    }
+    unregister(pattern) {
+        return this.patterns.delete(pattern);
+    }
+    unregisterByPrefix(prefix) {
+        let count = 0;
+        for (const key of this.patterns.keys()) {
+            if (key.startsWith(prefix)) {
+                this.patterns.delete(key);
+                count++;
+            }
+        }
+        return count;
+    }
+    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;AASH,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,UAAU,CAAC,OAAe;QACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IAED,kBAAkB,CAAC,MAAc;QAC/B,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;YACvC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC1B,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC;QACD,OAAO,KAAK,CAAC;IACf,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/events/subscription-service.d.ts

@@ -0,0 +1,46 @@
+/**
+ * SubscriptionService — Business logic for event subscription CRUD.
+ *
+ * Centralises the read-modify-write config cycle + runtime registration/unregistration
+ * that was previously duplicated across event-routes.ts and process-routes.ts.
+ */
+import type { EventBus } from './event-bus.js';
+import type { ProcessEngine } from '../process/engine.js';
+import type { LifecycleManager } from '../lifecycle/index.js';
+import type { EventSubscription } from '../../types/event.js';
+export interface SubscriptionServiceOptions {
+    processEngine?: ProcessEngine;
+    eventBus?: EventBus;
+    lifecycleManager?: LifecycleManager;
+    projectRoot?: string;
+}
+export declare class SubscriptionService {
+    private processEngine?;
+    private eventBus?;
+    private lifecycleManager?;
+    private projectRoot?;
+    constructor(options: SubscriptionServiceOptions);
+    /** Read all subscriptions from config, optionally enriched with active status. */
+    listSubscriptions(enrich?: boolean): Promise<EventSubscription[]>;
+    /** Get subscriptions for a specific process, enriched with active status. */
+    listSubscriptionsForProcess(processName: string): Promise<Array<EventSubscription & {
+        active?: boolean;
+    }>>;
+    /** Add a new subscription: persist to config + runtime registration. */
+    addSubscription(sub: {
+        pattern: string;
+        handler: string;
+        config: Record<string, unknown>;
+    }): Promise<EventSubscription>;
+    /** Update a subscription (partial update): persist + runtime re-registration. */
+    updateSubscription(id: string, updates: {
+        pattern?: string;
+        handler?: string;
+        config?: Record<string, unknown>;
+    }): Promise<EventSubscription>;
+    /** Remove a subscription by ID: persist + runtime cleanup. */
+    removeSubscription(id: string): Promise<EventSubscription>;
+    /** Remove all subscriptions for a process (used by process delete cascade). */
+    removeSubscriptionsForProcess(processName: string): Promise<string[]>;
+}
+//# sourceMappingURL=subscription-service.d.ts.map

package/dist/backend/events/subscription-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscription-service.d.ts","sourceRoot":"","sources":["../../../src/backend/events/subscription-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAI9D,MAAM,WAAW,0BAA0B;IACzC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAID,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,QAAQ,CAAC,CAAW;IAC5B,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,WAAW,CAAC,CAAS;gBAEjB,OAAO,EAAE,0BAA0B;IAO/C,kFAAkF;IAC5E,iBAAiB,CAAC,MAAM,UAAQ,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAcrE,6EAA6E;IACvE,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,iBAAiB,GAAG;QAAE,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAWhH,wEAAwE;IAClE,eAAe,CAAC,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2D7H,iFAAiF;IAC3E,kBAAkB,CACtB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAChF,OAAO,CAAC,iBAAiB,CAAC;IA6E7B,8DAA8D;IACxD,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAoChE,+EAA+E;IACzE,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;CAmB5E"}

package/dist/backend/events/subscription-service.js

@@ -0,0 +1,220 @@
+/**
+ * SubscriptionService — Business logic for event subscription CRUD.
+ *
+ * Centralises the read-modify-write config cycle + runtime registration/unregistration
+ * that was previously duplicated across event-routes.ts and process-routes.ts.
+ */
+import { deriveLifecycleNames } from '../process/process-helpers.js';
+import { generateId } from '../../utils/id.js';
+import { readEventSubscriptions, writeEventSubscriptionsToConfig } from '../routes/config-writer.js';
+const VALID_HANDLERS = ['process', 'webhook', 'log', 'notify'];
+export class SubscriptionService {
+    processEngine;
+    eventBus;
+    lifecycleManager;
+    projectRoot;
+    constructor(options) {
+        this.processEngine = options.processEngine;
+        this.eventBus = options.eventBus;
+        this.lifecycleManager = options.lifecycleManager;
+        this.projectRoot = options.projectRoot;
+    }
+    /** Read all subscriptions from config, optionally enriched with active status. */
+    async listSubscriptions(enrich = false) {
+        if (!this.projectRoot)
+            return [];
+        const subscriptions = await readEventSubscriptions(this.projectRoot);
+        if (!enrich)
+            return subscriptions;
+        return subscriptions.map(sub => {
+            if (sub.handler === 'process' && this.processEngine) {
+                const procName = sub.config.process;
+                const isActive = this.processEngine.getEventSubscriptions(procName).length > 0;
+                return { ...sub, active: isActive };
+            }
+            return { ...sub, active: !!this.eventBus };
+        });
+    }
+    /** Get subscriptions for a specific process, enriched with active status. */
+    async listSubscriptionsForProcess(processName) {
+        if (!this.projectRoot)
+            return [];
+        const allSubs = await readEventSubscriptions(this.projectRoot);
+        if (!this.processEngine)
+            return allSubs.filter(s => s.handler === 'process' && s.config.process === processName);
+        const runtimeSubs = this.processEngine.getEventSubscriptions(processName);
+        const runtimePatterns = new Set(runtimeSubs.map(s => s.pattern));
+        return allSubs
+            .filter(s => s.handler === 'process' && s.config.process === processName)
+            .map(s => ({ ...s, active: runtimePatterns.has(s.pattern) }));
+    }
+    /** Add a new subscription: persist to config + runtime registration. */
+    async addSubscription(sub) {
+        if (!this.projectRoot)
+            throw new Error('Project root not configured');
+        const { pattern, handler, config } = sub;
+        if (!pattern || typeof pattern !== 'string')
+            throw new Error('pattern is required');
+        if (!handler || !VALID_HANDLERS.includes(handler)) {
+            throw new Error(`handler must be one of: ${VALID_HANDLERS.join(', ')}`);
+        }
+        if (!config || typeof config !== 'object')
+            throw new Error('config is required');
+        if (handler === 'process') {
+            const procCfg = config;
+            if (!procCfg.process || typeof procCfg.process !== 'string') {
+                throw new Error('process handler requires config.process (process name)');
+            }
+            if (this.processEngine) {
+                const exists = await this.processEngine.getProcess(procCfg.process);
+                if (!exists)
+                    throw new Error(`Process "${procCfg.process}" not found`);
+            }
+        }
+        else if (handler === 'webhook') {
+            const webhookCfg = config;
+            if (!webhookCfg.url || typeof webhookCfg.url !== 'string') {
+                throw new Error('webhook handler requires config.url');
+            }
+        }
+        const subscriptions = await readEventSubscriptions(this.projectRoot);
+        const newSub = { id: generateId('sub'), pattern, handler, config };
+        subscriptions.push(newSub);
+        await writeEventSubscriptionsToConfig(this.projectRoot, subscriptions);
+        // Runtime registration for process handler
+        if (handler === 'process' && this.processEngine && this.eventBus) {
+            const procCfg = config;
+            const proc = await this.processEngine.getProcess(procCfg.process);
+            this.processEngine.registerEventSubscription(procCfg.process, this.eventBus, pattern, procCfg.filter, procCfg.debounceMs, !proc?.paused);
+            // Start feeder(s) if process has sources and is not paused
+            if (this.lifecycleManager && proc && proc.sources.length > 0 && !proc.paused) {
+                const names = deriveLifecycleNames(proc.name, proc.sources);
+                for (let i = 0; i < proc.sources.length; i++) {
+                    const scriptName = names[i];
+                    if (scriptName) {
+                        this.lifecycleManager.addScript({ name: scriptName, command: proc.sources[i].command, env: proc.sources[i].env });
+                    }
+                }
+                for (const name of names) {
+                    await this.lifecycleManager.start(name);
+                }
+            }
+        }
+        return newSub;
+    }
+    /** Update a subscription (partial update): persist + runtime re-registration. */
+    async updateSubscription(id, updates) {
+        if (!this.projectRoot)
+            throw new Error('Project root not configured');
+        const subscriptions = await readEventSubscriptions(this.projectRoot);
+        const idx = subscriptions.findIndex(s => s.id === id);
+        if (idx === -1)
+            throw new Error(`Subscription ${id} not found`);
+        const oldSub = subscriptions[idx];
+        const newPattern = typeof updates.pattern === 'string' ? updates.pattern : oldSub.pattern;
+        const newHandler = typeof updates.handler === 'string' ? updates.handler : oldSub.handler;
+        const newConfig = (updates.config && typeof updates.config === 'object') ? updates.config : oldSub.config;
+        // Validate handler-specific config
+        if (newHandler === 'process') {
+            const procCfg = newConfig;
+            if (!procCfg.process || typeof procCfg.process !== 'string') {
+                throw new Error('process handler requires config.process (process name)');
+            }
+            if (this.processEngine) {
+                const exists = await this.processEngine.getProcess(procCfg.process);
+                if (!exists)
+                    throw new Error(`Process "${procCfg.process}" not found`);
+            }
+        }
+        else if (newHandler === 'webhook') {
+            const webhookCfg = newConfig;
+            if (!webhookCfg.url || typeof webhookCfg.url !== 'string') {
+                throw new Error('webhook handler requires config.url');
+            }
+        }
+        const handlerChanged = oldSub.handler !== newHandler;
+        const patternChanged = oldSub.pattern !== newPattern;
+        // Unregister old runtime subscription if handler or pattern changed
+        if (oldSub.handler === 'process' && this.processEngine && (handlerChanged || patternChanged)) {
+            const oldCfg = oldSub.config;
+            this.processEngine.unregisterEventSubscription(oldCfg.process, oldSub.pattern);
+        }
+        const updatedSub = {
+            ...oldSub,
+            id: oldSub.id ?? generateId('sub'),
+            pattern: newPattern,
+            handler: newHandler,
+            config: newConfig,
+        };
+        subscriptions[idx] = updatedSub;
+        await writeEventSubscriptionsToConfig(this.projectRoot, subscriptions);
+        // Register new runtime subscription if process handler and something changed
+        if (updatedSub.handler === 'process' && this.processEngine && this.eventBus && (handlerChanged || patternChanged)) {
+            const procCfg = updatedSub.config;
+            const proc = await this.processEngine.getProcess(procCfg.process);
+            this.processEngine.registerEventSubscription(procCfg.process, this.eventBus, updatedSub.pattern, procCfg.filter, procCfg.debounceMs, !proc?.paused);
+        }
+        // If process handler config changed (but handler+pattern same), re-register
+        if (updatedSub.handler === 'process' && this.processEngine && this.eventBus && !handlerChanged && !patternChanged) {
+            const oldProcCfg = oldSub.config;
+            const newProcCfg = updatedSub.config;
+            if (JSON.stringify(oldProcCfg) !== JSON.stringify(newProcCfg)) {
+                this.processEngine.unregisterEventSubscription(oldProcCfg.process, oldSub.pattern);
+                const proc = await this.processEngine.getProcess(newProcCfg.process);
+                this.processEngine.registerEventSubscription(newProcCfg.process, this.eventBus, updatedSub.pattern, newProcCfg.filter, newProcCfg.debounceMs, !proc?.paused);
+            }
+        }
+        return updatedSub;
+    }
+    /** Remove a subscription by ID: persist + runtime cleanup. */
+    async removeSubscription(id) {
+        if (!this.projectRoot)
+            throw new Error('Project root not configured');
+        const subscriptions = await readEventSubscriptions(this.projectRoot);
+        const idx = subscriptions.findIndex(s => s.id === id);
+        if (idx === -1)
+            throw new Error(`Subscription ${id} not found`);
+        const removed = subscriptions.splice(idx, 1)[0];
+        await writeEventSubscriptionsToConfig(this.projectRoot, subscriptions);
+        // Runtime cleanup for process handler
+        if (removed.handler === 'process' && this.processEngine) {
+            const procCfg = removed.config;
+            this.processEngine.unregisterEventSubscription(procCfg.process, removed.pattern);
+            // Stop feeder(s) if this was the last subscription for the process with sources
+            if (this.lifecycleManager) {
+                const remainingSubsForProcess = subscriptions.filter(s => s.handler === 'process' && s.config.process === procCfg.process);
+                if (remainingSubsForProcess.length === 0) {
+                    const proc = await this.processEngine.getProcess(procCfg.process);
+                    if (proc && proc.sources.length > 0) {
+                        // Each process has its own uniquely named lifecycle scripts, so safe to remove all
+                        const names = deriveLifecycleNames(proc.name, proc.sources);
+                        for (const name of names) {
+                            try {
+                                await this.lifecycleManager.removeScript(name);
+                            }
+                            catch { /* may not exist */ }
+                        }
+                    }
+                }
+            }
+        }
+        return removed;
+    }
+    /** Remove all subscriptions for a process (used by process delete cascade). */
+    async removeSubscriptionsForProcess(processName) {
+        if (!this.projectRoot)
+            return [];
+        const subscriptions = await readEventSubscriptions(this.projectRoot);
+        const removedPatterns = subscriptions
+            .filter(s => s.handler === 'process' && s.config.process === processName)
+            .map(s => s.pattern);
+        const remainingSubs = subscriptions.filter(s => !(s.handler === 'process' && s.config.process === processName));
+        await writeEventSubscriptionsToConfig(this.projectRoot, remainingSubs);
+        // Runtime cleanup
+        if (this.processEngine) {
+            this.processEngine.unregisterEventSubscription(processName);
+        }
+        return removedPatterns;
+    }
+}
+//# sourceMappingURL=subscription-service.js.map

package/dist/backend/events/subscription-service.js.map

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

package/dist/backend/index.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @loom-framework/backend - Main Server
+ *
+ * Assembles Fastify server with:
+ * - HTTP SSE chat route (Ant Design X compatible)
+ * - REST routes for DataAdapter CRUD + health check + sessions
+ * - Static file serving for production mode
+ * - Configuration from loom.config.ts
+ */
+import Fastify from 'fastify';
+import type { LoomConfig, ServerConfig } from '../types/config.js';
+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';
+import { ProcessEngine } from './process/engine.js';
+import { LifecycleManager } from './lifecycle/index.js';
+import { NotificationStorage } from './notifications/notification-storage.js';
+export interface LoomServerOptions {
+    /** Project root directory containing loom.config.ts */
+    projectRoot: string;
+    /** Override server config (merges over config file) */
+    serverConfig?: Partial<ServerConfig>;
+    /** Custom AI engine (defaults to ClaudeCodeEngine from config) */
+    engine?: AIEngine;
+    /** Custom DataAdapter (defaults to FileSystemAdapter from config) */
+    adapter?: DataAdapter;
+    /** Logger level */
+    logLevel?: string;
+}
+export declare class LoomServer {
+    private config;
+    private engine;
+    private adapter;
+    private sessionManager;
+    private interactionLogger;
+    private fastify;
+    private userStore?;
+    private tokenStore?;
+    private eventBus?;
+    private eventRegistry?;
+    private processEngine?;
+    private lifecycleManager?;
+    private notificationStorage?;
+    private subscriptionService?;
+    private projectRoot;
+    private options;
+    constructor(options: LoomServerOptions);
+    /**
+     * Initialize server: load config, create engine/adapter, register routes
+     */
+    initialize(): Promise<void>;
+    /**
+     * Start listening
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+    /** Expose Fastify instance for testing */
+    getFastify(): ReturnType<typeof Fastify>;
+    /** Expose config for testing */
+    getConfig(): LoomConfig;
+    /** Expose adapter for testing */
+    getAdapter(): DataAdapter;
+    /** Expose user store for testing */
+    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;
+    /** Expose process engine for testing */
+    getProcessEngine(): ProcessEngine | undefined;
+    /** Expose lifecycle manager for testing */
+    getLifecycleManager(): LifecycleManager | undefined;
+    /** Expose notification storage for testing */
+    getNotificationStorage(): NotificationStorage | undefined;
+    /**
+     * Load .env file into process.env (simple key=value parser, no dependencies).
+     * Skips comments and empty lines. Does not override existing env vars.
+     */
+    private loadEnvFile;
+}
+/**
+ * Create and start a LoomServer from a project root
+ */
+export declare function startServer(projectRoot: string): Promise<LoomServer>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +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,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAK9E,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,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,gBAAgB,CAAC,CAAmB;IAC5C,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAoB;gBAEvB,OAAO,EAAE,iBAAiB;IAKtC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkWjC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAa5B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAe3B,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;IAI7C,wCAAwC;IACxC,gBAAgB,IAAI,aAAa,GAAG,SAAS;IAI7C,2CAA2C;IAC3C,mBAAmB,IAAI,gBAAgB,GAAG,SAAS;IAInD,8CAA8C;IAC9C,sBAAsB,IAAI,mBAAmB,GAAG,SAAS;IAIzD;;;OAGG;YACW,WAAW;CAqB1B;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAK1E"}