@ouija-dev/plugin-sdk 0.1.0

package/dist/config-validator.d.ts

@@ -0,0 +1,27 @@
+import type { JSONSchema } from '@ouija-dev/types';
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+/**
+ * Validate `data` against a JSON Schema.
+ *
+ * On success: `{ valid: true, errors: [] }`
+ * On failure: `{ valid: false, errors: ['apiToken is required', ...] }`
+ *
+ * The caller is responsible for narrowing the type after a `valid` check.
+ * Typical usage:
+ *
+ *   const result = validateConfig(manifest.configSchema, rawConfig);
+ *   if (!result.valid) throw new Error(result.errors.join('; '));
+ *   const config = rawConfig as MyPluginConfig; // safe after validation
+ */
+export declare function validateConfig(schema: JSONSchema, data: unknown): ValidationResult;
+/**
+ * Validate config and format error messages with the plugin name prefix.
+ * Throws if config is invalid.
+ *
+ * Example error: "Plugin @ouija-dev/plugin-plane config error: apiToken is required"
+ */
+export declare function validateConfigOrThrow(pluginName: string, schema: JSONSchema, data: unknown): void;
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../src/config-validator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAenD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CA6BlF;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,OAAO,GACZ,IAAI,CAMN"}

package/dist/config-validator.js

@@ -0,0 +1,61 @@
+import { Ajv } from 'ajv';
+import { createRequire } from 'node:module';
+// ajv-formats is a CJS-only package; use createRequire to import it
+// in a way that works with NodeNext module resolution.
+const require = createRequire(import.meta.url);
+// eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+const addFormats = require('ajv-formats');
+// ---- Ajv instance (shared, compiled schemas are cached) ----
+const ajv = new Ajv({ allErrors: true, strict: false });
+addFormats(ajv);
+/**
+ * Validate `data` against a JSON Schema.
+ *
+ * On success: `{ valid: true, errors: [] }`
+ * On failure: `{ valid: false, errors: ['apiToken is required', ...] }`
+ *
+ * The caller is responsible for narrowing the type after a `valid` check.
+ * Typical usage:
+ *
+ *   const result = validateConfig(manifest.configSchema, rawConfig);
+ *   if (!result.valid) throw new Error(result.errors.join('; '));
+ *   const config = rawConfig as MyPluginConfig; // safe after validation
+ */
+export function validateConfig(schema, data) {
+    const validate = ajv.compile(schema);
+    const valid = validate(data);
+    if (valid) {
+        return { valid: true, errors: [] };
+    }
+    const errors = (validate.errors ?? []).map((err) => {
+        // Build human-readable messages that include the field path.
+        // err.instancePath is empty for top-level missing-required errors;
+        // the field name comes from err.params in that case.
+        const path = err.instancePath
+            ? err.instancePath.replace(/^\//, '').replace(/\//g, '.')
+            : '';
+        if (err.keyword === 'required') {
+            const field = err.params.missingProperty;
+            return `${field} is required`;
+        }
+        if (path) {
+            return `${path} ${err.message ?? 'is invalid'}`;
+        }
+        return err.message ?? 'validation failed';
+    });
+    return { valid: false, errors };
+}
+/**
+ * Validate config and format error messages with the plugin name prefix.
+ * Throws if config is invalid.
+ *
+ * Example error: "Plugin @ouija-dev/plugin-plane config error: apiToken is required"
+ */
+export function validateConfigOrThrow(pluginName, schema, data) {
+    const result = validateConfig(schema, data);
+    if (!result.valid) {
+        const messages = result.errors.join('; ');
+        throw new Error(`Plugin ${pluginName} config error: ${messages}`);
+    }
+}
+//# sourceMappingURL=config-validator.js.map

package/dist/config-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.js","sourceRoot":"","sources":["../src/config-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,oEAAoE;AACpE,uDAAuD;AACvD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,mEAAmE;AACnE,MAAM,UAAU,GAAkB,OAAO,CAAC,aAAa,CAAkB,CAAC;AAE1E,+DAA+D;AAE/D,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;AACxD,UAAU,CAAC,GAAG,CAAC,CAAC;AAShB;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkB,EAAE,IAAa;IAC9D,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAY,CAAC;IAExC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACjD,6DAA6D;QAC7D,mEAAmE;QACnE,qDAAqD;QACrD,MAAM,IAAI,GAAG,GAAG,CAAC,YAAY;YAC3B,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;YACzD,CAAC,CAAC,EAAE,CAAC;QAEP,IAAI,GAAG,CAAC,OAAO,KAAK,UAAU,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAI,GAAG,CAAC,MAAsC,CAAC,eAAe,CAAC;YAC1E,OAAO,GAAG,KAAK,cAAc,CAAC;QAChC,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,GAAG,IAAI,IAAI,GAAG,CAAC,OAAO,IAAI,YAAY,EAAE,CAAC;QAClD,CAAC;QAED,OAAO,GAAG,CAAC,OAAO,IAAI,mBAAmB,CAAC;IAC5C,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,UAAkB,EAClB,MAAkB,EAClB,IAAa;IAEb,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC5C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClB,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,UAAU,UAAU,kBAAkB,QAAQ,EAAE,CAAC,CAAC;IACpE,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { validateConfig, validateConfigOrThrow } from './config-validator.js';
+export type { ValidationResult } from './config-validator.js';
+export { PluginLoader } from './plugin-loader.js';
+export type { PluginRegistration, PluginFactory } from './plugin-loader.js';
+export * from './test-utils/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9E,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAO5E,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,10 @@
+// ---- Plugin SDK public API ----
+export { validateConfig, validateConfigOrThrow } from './config-validator.js';
+export { PluginLoader } from './plugin-loader.js';
+// Test utilities are intentionally kept under a sub-path so production code
+// cannot accidentally import mocks. Re-exported here for convenience when
+// tests are co-located with source (the test runner resolves from the package
+// root). Plugin authors can also import directly from
+// '@ouija-dev/plugin-sdk/test-utils'.
+export * from './test-utils/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9E,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,4EAA4E;AAC5E,0EAA0E;AAC1E,8EAA8E;AAC9E,sDAAsD;AACtD,sCAAsC;AACtC,cAAc,uBAAuB,CAAC"}

package/dist/plugin-loader.d.ts

@@ -0,0 +1,87 @@
+import type { BasePlugin, PluginLogger, PluginHealth, JSONSchema, PluginContext } from '@ouija-dev/types';
+/**
+ * A single plugin registration entry.
+ * `module` is the import specifier (file path or package name).
+ * `config` is the raw config object that will be validated against the manifest schema.
+ */
+export interface PluginRegistration {
+    module: string;
+    config: Record<string, unknown>;
+}
+/**
+ * The shape of the default export (or named `PluginFactory` export) expected
+ * from each plugin module.
+ *
+ * Plugin modules must export a factory object whose `manifest` is read before
+ * `create()` is called.
+ */
+export interface PluginFactory<TConfig = unknown> {
+    manifest: {
+        name: string;
+        version: string;
+        type: 'kanban' | 'git' | 'agent' | 'notification';
+        coreApiVersion: string;
+        configSchema: JSONSchema;
+        dependencies?: string[];
+    };
+    create(): BasePlugin<TConfig>;
+}
+/** Shape of an imported plugin module. */
+type PluginModule = {
+    default?: PluginFactory<unknown>;
+    PluginFactory?: PluginFactory<unknown>;
+};
+/** Context factory signature. */
+export type ContextFactory = (pluginName: string, config: Record<string, unknown>) => PluginContext<unknown>;
+/**
+ * Manages the full lifecycle for a set of registered plugins:
+ *   register → loadAll (import + validate + sort + init) → startAll → stopAll
+ */
+export declare class PluginLoader {
+    private readonly logger;
+    private readonly registrations;
+    /** Ordered by dependency resolution (dependencies first). */
+    private loadedPlugins;
+    private started;
+    constructor(logger: PluginLogger);
+    /**
+     * Register a plugin module + config pair. The module is not imported yet.
+     */
+    register(registration: PluginRegistration): void;
+    /**
+     * Import all registered modules, validate their configs, resolve dependency
+     * order, and call `plugin.init(context)` for each in dependency order.
+     *
+     * @param contextFactory - builds the PluginContext for each plugin.
+     * @param importFn - override the import mechanism (default: dynamic import).
+     *   Pass a custom function in tests to avoid filesystem lookups.
+     *
+     * Throws on:
+     *  - `coreApiVersion` incompatibility
+     *  - Config validation failure
+     *  - Circular dependencies
+     *  - Unknown dependency references
+     */
+    loadAll(contextFactory: ContextFactory, importFn?: (moduleSpecifier: string) => Promise<PluginModule>): Promise<void>;
+    /**
+     * Start all loaded plugins concurrently.
+     * A failing plugin logs the error but does not prevent others from starting.
+     */
+    startAll(): Promise<void>;
+    /**
+     * Stop all plugins in reverse dependency order.
+     * Each plugin gets `timeoutMs` (default 5 000 ms) to shut down.
+     */
+    stopAll(timeoutMs?: number): Promise<void>;
+    /**
+     * Get a loaded plugin by name, cast to type `T`.
+     * Throws if the plugin is not found.
+     */
+    getPlugin<T>(name: string): T;
+    /**
+     * Poll all loaded plugins for their health status.
+     */
+    getHealthStatuses(): Promise<Map<string, PluginHealth>>;
+}
+export {};
+//# sourceMappingURL=plugin-loader.d.ts.map

package/dist/plugin-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-loader.d.ts","sourceRoot":"","sources":["../src/plugin-loader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAK1G;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,OAAO;IAC9C,QAAQ,EAAE;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,OAAO,GAAG,cAAc,CAAC;QAClD,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,UAAU,CAAC;QACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;CAC/B;AAED,0CAA0C;AAC1C,KAAK,YAAY,GAAG;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IACjC,aAAa,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;CACxC,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,cAAc,GAAG,CAC3B,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,aAAa,CAAC,OAAO,CAAC,CAAC;AAa5B;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA8C;IAC5E,6DAA6D;IAC7D,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,OAAO,CAAS;gBAEZ,MAAM,EAAE,YAAY;IAIhC;;OAEG;IACH,QAAQ,CAAC,YAAY,EAAE,kBAAkB,GAAG,IAAI;IAIhD;;;;;;;;;;;;;OAaG;IACG,OAAO,CACX,cAAc,EAAE,cAAc,EAC9B,QAAQ,GAAE,CAAC,eAAe,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CACvB,GACnC,OAAO,CAAC,IAAI,CAAC;IA6DhB;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAkB/B;;;OAGG;IACG,OAAO,CAAC,SAAS,SAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB/C;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAQ7B;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CAmB9D"}

package/dist/plugin-loader.js

@@ -0,0 +1,202 @@
+import semver from 'semver';
+import { validateConfigOrThrow } from './config-validator.js';
+// ---- Core API version this loader implements ----
+const CORE_API_VERSION = '1.0.0';
+// ---- PluginLoader ----
+/**
+ * Manages the full lifecycle for a set of registered plugins:
+ *   register → loadAll (import + validate + sort + init) → startAll → stopAll
+ */
+export class PluginLoader {
+    logger;
+    registrations = new Map();
+    /** Ordered by dependency resolution (dependencies first). */
+    loadedPlugins = [];
+    started = false;
+    constructor(logger) {
+        this.logger = logger;
+    }
+    /**
+     * Register a plugin module + config pair. The module is not imported yet.
+     */
+    register(registration) {
+        this.registrations.set(registration.module, registration);
+    }
+    /**
+     * Import all registered modules, validate their configs, resolve dependency
+     * order, and call `plugin.init(context)` for each in dependency order.
+     *
+     * @param contextFactory - builds the PluginContext for each plugin.
+     * @param importFn - override the import mechanism (default: dynamic import).
+     *   Pass a custom function in tests to avoid filesystem lookups.
+     *
+     * Throws on:
+     *  - `coreApiVersion` incompatibility
+     *  - Config validation failure
+     *  - Circular dependencies
+     *  - Unknown dependency references
+     */
+    async loadAll(contextFactory, importFn = (m) => import(m)) {
+        // 1. Import all modules and extract factories.
+        const factories = new Map();
+        // Map from plugin name → module specifier so we can find the registration.
+        const nameToModule = new Map();
+        for (const [moduleSpecifier, registration] of this.registrations) {
+            const mod = await importFn(moduleSpecifier);
+            const factory = mod.default ?? mod.PluginFactory;
+            if (!factory || typeof factory.create !== 'function') {
+                throw new Error(`Plugin module "${moduleSpecifier}" must export a default PluginFactory with a create() method`);
+            }
+            const { name, coreApiVersion, configSchema } = factory.manifest;
+            // 2. Check coreApiVersion compatibility.
+            if (!semver.satisfies(CORE_API_VERSION, coreApiVersion)) {
+                throw new Error(`Plugin ${name} requires coreApiVersion "${coreApiVersion}" but core is at ${CORE_API_VERSION}`);
+            }
+            // 3. Validate config against manifest schema.
+            validateConfigOrThrow(name, configSchema, registration.config);
+            factories.set(name, factory);
+            nameToModule.set(name, moduleSpecifier);
+        }
+        // 4. Topological sort by dependencies.
+        const sortedNames = topoSort(factories);
+        // 5. Create plugin instances in sorted order and init them.
+        for (const name of sortedNames) {
+            const factory = factories.get(name);
+            if (!factory)
+                continue;
+            const moduleSpecifier = nameToModule.get(name);
+            if (!moduleSpecifier) {
+                throw new Error(`Internal error: no module specifier found for plugin "${name}"`);
+            }
+            const registration = this.registrations.get(moduleSpecifier);
+            if (!registration) {
+                throw new Error(`Internal error: no registration found for plugin "${name}"`);
+            }
+            const plugin = factory.create();
+            const context = contextFactory(name, registration.config);
+            this.logger.info(`Initialising plugin "${name}"`);
+            await plugin.init(context);
+            this.loadedPlugins.push({ plugin, name });
+        }
+    }
+    /**
+     * Start all loaded plugins concurrently.
+     * A failing plugin logs the error but does not prevent others from starting.
+     */
+    async startAll() {
+        this.started = true;
+        const results = await Promise.allSettled(this.loadedPlugins.map(async ({ plugin, name }) => {
+            this.logger.info(`Starting plugin "${name}"`);
+            await plugin.start();
+        }));
+        for (const result of results) {
+            if (result.status === 'rejected') {
+                this.logger.error('Plugin failed to start', {
+                    error: String(result.reason),
+                });
+            }
+        }
+    }
+    /**
+     * Stop all plugins in reverse dependency order.
+     * Each plugin gets `timeoutMs` (default 5 000 ms) to shut down.
+     */
+    async stopAll(timeoutMs = 5_000) {
+        const reversed = [...this.loadedPlugins].reverse();
+        for (const { plugin, name } of reversed) {
+            this.logger.info(`Stopping plugin "${name}"`);
+            try {
+                await Promise.race([
+                    plugin.stop(),
+                    new Promise((_, reject) => setTimeout(() => reject(new Error(`Plugin "${name}" stop timed out`)), timeoutMs)),
+                ]);
+            }
+            catch (err) {
+                this.logger.error(`Plugin "${name}" stop error`, { error: String(err) });
+            }
+        }
+        this.started = false;
+    }
+    /**
+     * Get a loaded plugin by name, cast to type `T`.
+     * Throws if the plugin is not found.
+     */
+    getPlugin(name) {
+        const entry = this.loadedPlugins.find((e) => e.name === name);
+        if (!entry) {
+            throw new Error(`Plugin "${name}" is not loaded`);
+        }
+        return entry.plugin;
+    }
+    /**
+     * Poll all loaded plugins for their health status.
+     */
+    async getHealthStatuses() {
+        const results = new Map();
+        await Promise.all(this.loadedPlugins.map(async ({ plugin, name }) => {
+            try {
+                const health = await plugin.healthCheck();
+                results.set(name, health);
+            }
+            catch (err) {
+                results.set(name, {
+                    healthy: false,
+                    message: `healthCheck threw: ${String(err)}`,
+                });
+            }
+        }));
+        return results;
+    }
+}
+// ---- Topological sort ----
+/**
+ * Kahn's algorithm (BFS-based topological sort).
+ * Returns plugin names in dependency-first order.
+ * Throws on circular dependencies or missing dependency references.
+ */
+function topoSort(factories) {
+    const inDegree = new Map();
+    // dependents[dep] = plugins that depend on dep
+    const dependents = new Map();
+    for (const [name] of factories) {
+        inDegree.set(name, 0);
+        dependents.set(name, []);
+    }
+    for (const [name, factory] of factories) {
+        for (const dep of factory.manifest.dependencies ?? []) {
+            if (!factories.has(dep)) {
+                throw new Error(`Plugin "${name}" depends on "${dep}", but "${dep}" is not registered`);
+            }
+            const existing = dependents.get(dep) ?? [];
+            existing.push(name);
+            dependents.set(dep, existing);
+            inDegree.set(name, (inDegree.get(name) ?? 0) + 1);
+        }
+    }
+    // Start with nodes that have no unmet dependencies.
+    const queue = [];
+    for (const [name, degree] of inDegree) {
+        if (degree === 0)
+            queue.push(name);
+    }
+    const sorted = [];
+    while (queue.length > 0) {
+        // Stable alphabetical sort within the queue for determinism.
+        queue.sort();
+        const current = queue.shift();
+        sorted.push(current);
+        for (const dependent of dependents.get(current) ?? []) {
+            const newDegree = (inDegree.get(dependent) ?? 1) - 1;
+            inDegree.set(dependent, newDegree);
+            if (newDegree === 0) {
+                queue.push(dependent);
+            }
+        }
+    }
+    if (sorted.length !== factories.size) {
+        const inCycle = [...factories.keys()].filter((n) => !sorted.includes(n));
+        throw new Error(`Circular dependency detected among plugins: ${inCycle.sort().join(', ')}`);
+    }
+    return sorted;
+}
+//# sourceMappingURL=plugin-loader.js.map

package/dist/plugin-loader.js.map

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

package/dist/test-utils/index.d.ts

@@ -0,0 +1,7 @@
+export { createMockLogger, createMockContext } from './mock-context.js';
+export type { RecordedLogEntry, MockLogger, MockContext } from './mock-context.js';
+export { MockKanbanPlugin } from './mock-kanban.js';
+export { MockGitPlugin } from './mock-git.js';
+export { MockAgentPlugin } from './mock-agent.js';
+export type { DispatchRecord, CancelRecord } from './mock-agent.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/test-utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/test-utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AACxE,YAAY,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/test-utils/index.js

@@ -0,0 +1,5 @@
+export { createMockLogger, createMockContext } from './mock-context.js';
+export { MockKanbanPlugin } from './mock-kanban.js';
+export { MockGitPlugin } from './mock-git.js';
+export { MockAgentPlugin } from './mock-agent.js';
+//# sourceMappingURL=index.js.map

package/dist/test-utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/test-utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/test-utils/mock-agent.d.ts

@@ -0,0 +1,54 @@
+import type { AgentPlugin, WorkOrder, AgentStatus, AgentStatusState, PluginManifest, PluginContext, PluginHealth } from '@ouija-dev/types';
+import type { DispatchId } from '@ouija-dev/types';
+/** A dispatched work order with the ID assigned to it. */
+export interface DispatchRecord {
+    dispatchId: DispatchId;
+    workOrder: WorkOrder;
+}
+/** A recorded cancellation. */
+export interface CancelRecord {
+    dispatchId: DispatchId;
+}
+/**
+ * In-memory AgentPlugin for engine integration tests.
+ *
+ * - `dispatch()` records the work order and returns a deterministic fake ID.
+ * - `cancel()` records the cancellation request.
+ * - `getStatus()` returns a configurable default state (`idle` by default).
+ *   Override per-dispatch via `setStatus()`.
+ *
+ * Inspect `dispatchedWorkOrders` and `cancelledIds` in test assertions.
+ */
+export declare class MockAgentPlugin implements AgentPlugin<Record<string, never>> {
+    readonly manifest: PluginManifest;
+    /** All work orders passed to `dispatch()`, in insertion order. */
+    readonly dispatchedWorkOrders: DispatchRecord[];
+    /** All dispatch IDs passed to `cancel()`, in insertion order. */
+    readonly cancelledIds: CancelRecord[];
+    /** Override per-dispatch status here for getStatus() to return. */
+    private readonly statusOverrides;
+    /** Default state returned when no override exists. */
+    private defaultState;
+    private dispatchCounter;
+    private initialised;
+    private running;
+    init(_context: PluginContext<Record<string, never>>): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    healthCheck(): Promise<PluginHealth>;
+    dispatch(workOrder: WorkOrder): Promise<DispatchId>;
+    cancel(id: DispatchId): Promise<void>;
+    getStatus(id: DispatchId): Promise<AgentStatus>;
+    /**
+     * Set a specific status that `getStatus()` will return for the given dispatch ID.
+     * Useful for simulating state transitions in tests.
+     */
+    setStatus(id: DispatchId, status: Omit<AgentStatus, 'dispatchId'>): void;
+    /**
+     * Change the default state returned by `getStatus()` when no override is set.
+     */
+    setDefaultState(state: AgentStatusState): void;
+    /** Reset all recorded data and overrides. Useful between tests. */
+    reset(): void;
+}
+//# sourceMappingURL=mock-agent.d.ts.map

package/dist/test-utils/mock-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-agent.d.ts","sourceRoot":"","sources":["../../src/test-utils/mock-agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,kBAAkB,CAAC;AAK/D,0DAA0D;AAC1D,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,UAAU,CAAC;IACvB,SAAS,EAAE,SAAS,CAAC;CACtB;AAED,+BAA+B;AAC/B,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;;;;;;;;GASG;AACH,qBAAa,eAAgB,YAAW,WAAW,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACxE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAO/B;IAEF,kEAAkE;IAClE,QAAQ,CAAC,oBAAoB,EAAE,cAAc,EAAE,CAAM;IACrD,iEAAiE;IACjE,QAAQ,CAAC,YAAY,EAAE,YAAY,EAAE,CAAM;IAE3C,mEAAmE;IACnE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA2C;IAC3E,sDAAsD;IACtD,OAAO,CAAC,YAAY,CAA4B;IAEhD,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IAIlB,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAcpC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAOnD,MAAM,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrC,SAAS,CAAC,EAAE,EAAE,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC;IAcrD;;;OAGG;IACH,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,GAAG,IAAI;IAIxE;;OAEG;IACH,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI;IAI9C,mEAAmE;IACnE,KAAK,IAAI,IAAI;CAOd"}

package/dist/test-utils/mock-agent.js

@@ -0,0 +1,97 @@
+import { dispatchId, instanceId } from '@ouija-dev/types';
+/**
+ * In-memory AgentPlugin for engine integration tests.
+ *
+ * - `dispatch()` records the work order and returns a deterministic fake ID.
+ * - `cancel()` records the cancellation request.
+ * - `getStatus()` returns a configurable default state (`idle` by default).
+ *   Override per-dispatch via `setStatus()`.
+ *
+ * Inspect `dispatchedWorkOrders` and `cancelledIds` in test assertions.
+ */
+export class MockAgentPlugin {
+    manifest = {
+        name: '@ouija-dev/mock-agent',
+        version: '0.1.0',
+        type: 'agent',
+        coreApiVersion: '>=1.0.0 <2.0.0',
+        configSchema: { type: 'object', properties: {}, additionalProperties: false },
+        dependencies: [],
+    };
+    /** All work orders passed to `dispatch()`, in insertion order. */
+    dispatchedWorkOrders = [];
+    /** All dispatch IDs passed to `cancel()`, in insertion order. */
+    cancelledIds = [];
+    /** Override per-dispatch status here for getStatus() to return. */
+    statusOverrides = new Map();
+    /** Default state returned when no override exists. */
+    defaultState = 'idle';
+    dispatchCounter = 0;
+    initialised = false;
+    running = false;
+    // ---- Lifecycle ----
+    async init(_context) {
+        this.initialised = true;
+    }
+    async start() {
+        this.running = true;
+    }
+    async stop() {
+        this.running = false;
+    }
+    async healthCheck() {
+        return {
+            healthy: true,
+            message: 'Mock agent plugin is always healthy',
+            details: {
+                initialised: this.initialised,
+                running: this.running,
+                dispatched: this.dispatchedWorkOrders.length,
+            },
+        };
+    }
+    // ---- AgentPlugin methods ----
+    async dispatch(workOrder) {
+        this.dispatchCounter += 1;
+        const id = dispatchId(`mock-dispatch-${this.dispatchCounter}`);
+        this.dispatchedWorkOrders.push({ dispatchId: id, workOrder });
+        return id;
+    }
+    async cancel(id) {
+        this.cancelledIds.push({ dispatchId: id });
+    }
+    async getStatus(id) {
+        const override = this.statusOverrides.get(id);
+        if (override)
+            return { ...override };
+        return {
+            dispatchId: id,
+            instanceId: instanceId('mock-instance'),
+            state: this.defaultState,
+            updatedAt: new Date().toISOString(),
+        };
+    }
+    // ---- Test helpers ----
+    /**
+     * Set a specific status that `getStatus()` will return for the given dispatch ID.
+     * Useful for simulating state transitions in tests.
+     */
+    setStatus(id, status) {
+        this.statusOverrides.set(id, { ...status, dispatchId: id });
+    }
+    /**
+     * Change the default state returned by `getStatus()` when no override is set.
+     */
+    setDefaultState(state) {
+        this.defaultState = state;
+    }
+    /** Reset all recorded data and overrides. Useful between tests. */
+    reset() {
+        this.dispatchedWorkOrders.length = 0;
+        this.cancelledIds.length = 0;
+        this.statusOverrides.clear();
+        this.dispatchCounter = 0;
+        this.defaultState = 'idle';
+    }
+}
+//# sourceMappingURL=mock-agent.js.map

package/dist/test-utils/mock-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-agent.js","sourceRoot":"","sources":["../../src/test-utils/mock-agent.ts"],"names":[],"mappings":"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"}

package/dist/test-utils/mock-context.d.ts

@@ -0,0 +1,32 @@
+import type { PluginContext, PluginLogger } from '@ouija-dev/types';
+export interface RecordedLogEntry {
+    level: 'debug' | 'info' | 'warn' | 'error';
+    msg: string;
+    meta?: Record<string, unknown>;
+}
+export interface MockLogger extends PluginLogger {
+    /** All recorded log calls in insertion order. */
+    entries: RecordedLogEntry[];
+    /** Convenience: only entries at a given level. */
+    entriesAt(level: RecordedLogEntry['level']): RecordedLogEntry[];
+}
+export declare function createMockLogger(): MockLogger;
+export interface MockContext<TConfig> extends PluginContext<TConfig> {
+    logger: MockLogger;
+    /** All events published via publishEvent(), in insertion order. */
+    publishedEvents: Array<{
+        topic: string;
+        payload: unknown;
+    }>;
+    /** All jobs enqueued via enqueueJob(), in insertion order. */
+    enqueuedJobs: Array<{
+        queue: string;
+        job: unknown;
+        options?: {
+            delay?: number;
+            attempts?: number;
+        };
+    }>;
+}
+export declare function createMockContext<TConfig>(config: TConfig): MockContext<TConfig>;
+//# sourceMappingURL=mock-context.d.ts.map

package/dist/test-utils/mock-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-context.d.ts","sourceRoot":"","sources":["../../src/test-utils/mock-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAIpE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IAC3C,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAW,SAAQ,YAAY;IAC9C,iDAAiD;IACjD,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,kDAAkD;IAClD,SAAS,CAAC,KAAK,EAAE,gBAAgB,CAAC,OAAO,CAAC,GAAG,gBAAgB,EAAE,CAAC;CACjE;AAED,wBAAgB,gBAAgB,IAAI,UAAU,CAmB7C;AAID,MAAM,WAAW,WAAW,CAAC,OAAO,CAAE,SAAQ,aAAa,CAAC,OAAO,CAAC;IAClE,MAAM,EAAE,UAAU,CAAC;IACnB,mEAAmE;IACnE,eAAe,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC5D,8DAA8D;IAC9D,YAAY,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE;YAAE,KAAK,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAC;CACvG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAqBhF"}

package/dist/test-utils/mock-context.js

@@ -0,0 +1,35 @@
+export function createMockLogger() {
+    const entries = [];
+    function log(level, msg, meta) {
+        entries.push({ level, msg, ...(meta !== undefined ? { meta } : {}) });
+    }
+    const logger = {
+        entries,
+        entriesAt(level) {
+            return entries.filter((e) => e.level === level);
+        },
+        debug: (msg, meta) => log('debug', msg, meta),
+        info: (msg, meta) => log('info', msg, meta),
+        warn: (msg, meta) => log('warn', msg, meta),
+        error: (msg, meta) => log('error', msg, meta),
+    };
+    return logger;
+}
+export function createMockContext(config) {
+    const logger = createMockLogger();
+    const publishedEvents = [];
+    const enqueuedJobs = [];
+    return {
+        config,
+        logger,
+        publishedEvents,
+        enqueuedJobs,
+        publishEvent: async (topic, payload) => {
+            publishedEvents.push({ topic, payload });
+        },
+        enqueueJob: async (queue, job, options) => {
+            enqueuedJobs.push({ queue, job, ...(options !== undefined ? { options } : {}) });
+        },
+    };
+}
+//# sourceMappingURL=mock-context.js.map

package/dist/test-utils/mock-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-context.js","sourceRoot":"","sources":["../../src/test-utils/mock-context.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,gBAAgB;IAC9B,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,SAAS,GAAG,CAAC,KAAgC,EAAE,GAAW,EAAE,IAA8B;QACxF,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACxE,CAAC;IAED,MAAM,MAAM,GAAe;QACzB,OAAO;QACP,SAAS,CAAC,KAAK;YACb,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;QAClD,CAAC;QACD,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;QAC7C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC3C,IAAI,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC;QAC3C,KAAK,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC;KAC9C,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAYD,MAAM,UAAU,iBAAiB,CAAU,MAAe;IACxD,MAAM,MAAM,GAAG,gBAAgB,EAAE,CAAC;IAClC,MAAM,eAAe,GAA+C,EAAE,CAAC;IACvE,MAAM,YAAY,GAA4F,EAAE,CAAC;IAEjH,OAAO;QACL,MAAM;QACN,MAAM;QACN,eAAe;QACf,YAAY;QACZ,YAAY,EAAE,KAAK,EAAE,KAAa,EAAE,OAAgB,EAAiB,EAAE;YACrE,eAAe,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,UAAU,EAAE,KAAK,EACf,KAAa,EACb,GAAY,EACZ,OAA+C,EAChC,EAAE;YACjB,YAAY,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACnF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/test-utils/mock-git.d.ts

@@ -0,0 +1,31 @@
+import type { GitPlugin, StandardPR, OpenPRParams, PluginManifest, PluginContext, PluginHealth } from '@ouija-dev/types';
+import type { PrId } from '@ouija-dev/types';
+/**
+ * In-memory GitPlugin for use in engine integration tests and plugin development.
+ * No network calls. Branches and PRs are tracked in Maps.
+ *
+ * `openPR()` generates deterministic fake IDs and URLs.
+ * `mergePR()` marks the PR as merged in-place.
+ */
+export declare class MockGitPlugin implements GitPlugin<Record<string, never>> {
+    readonly manifest: PluginManifest;
+    /** repoUrl → Set of branch names */
+    readonly branches: Map<string, Set<string>>;
+    /** PR id → StandardPR */
+    readonly prs: Map<PrId, StandardPR>;
+    /** PR id → list of comment bodies */
+    readonly prComments: Map<PrId, string[]>;
+    private prCounter;
+    private initialised;
+    private running;
+    init(_context: PluginContext<Record<string, never>>): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    healthCheck(): Promise<PluginHealth>;
+    createBranch(repoUrl: string, branchName: string, _fromBranch: string): Promise<void>;
+    openPR(repoUrl: string, params: OpenPRParams): Promise<StandardPR>;
+    mergePR(id: PrId): Promise<void>;
+    addPRComment(id: PrId, body: string): Promise<void>;
+    getPR(id: PrId): Promise<StandardPR>;
+}
+//# sourceMappingURL=mock-git.d.ts.map

package/dist/test-utils/mock-git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-git.d.ts","sourceRoot":"","sources":["../../src/test-utils/mock-git.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,SAAS,EACT,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAK7C;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAO/B;IAEF,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAa;IACxD,yBAAyB;IACzB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAa;IAChD,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,CAAa;IAErD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IAIlB,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAUpC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrF,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAsBlE,OAAO,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAShC,YAAY,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,KAAK,CAAC,EAAE,EAAE,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC;CAO3C"}

package/dist/test-utils/mock-git.js

@@ -0,0 +1,90 @@
+import { prId } from '@ouija-dev/types';
+// ---- Mock Git Plugin ----
+/**
+ * In-memory GitPlugin for use in engine integration tests and plugin development.
+ * No network calls. Branches and PRs are tracked in Maps.
+ *
+ * `openPR()` generates deterministic fake IDs and URLs.
+ * `mergePR()` marks the PR as merged in-place.
+ */
+export class MockGitPlugin {
+    manifest = {
+        name: '@ouija-dev/mock-git',
+        version: '0.1.0',
+        type: 'git',
+        coreApiVersion: '>=1.0.0 <2.0.0',
+        configSchema: { type: 'object', properties: {}, additionalProperties: false },
+        dependencies: [],
+    };
+    /** repoUrl → Set of branch names */
+    branches = new Map();
+    /** PR id → StandardPR */
+    prs = new Map();
+    /** PR id → list of comment bodies */
+    prComments = new Map();
+    prCounter = 0;
+    initialised = false;
+    running = false;
+    // ---- Lifecycle ----
+    async init(_context) {
+        this.initialised = true;
+    }
+    async start() {
+        this.running = true;
+    }
+    async stop() {
+        this.running = false;
+    }
+    async healthCheck() {
+        return {
+            healthy: true,
+            message: 'Mock git plugin is always healthy',
+            details: { initialised: this.initialised, running: this.running },
+        };
+    }
+    // ---- GitPlugin methods ----
+    async createBranch(repoUrl, branchName, _fromBranch) {
+        const repo = this.branches.get(repoUrl) ?? new Set();
+        repo.add(branchName);
+        this.branches.set(repoUrl, repo);
+    }
+    async openPR(repoUrl, params) {
+        this.prCounter += 1;
+        const id = prId(`mock-pr-${this.prCounter}`);
+        const now = new Date().toISOString();
+        const pr = {
+            id,
+            url: `https://mock.git/${repoUrl}/pull/${this.prCounter}`,
+            title: params.title,
+            body: params.body,
+            branch: params.branch,
+            baseBranch: params.baseBranch,
+            state: 'open',
+            draft: params.draft ?? false,
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.prs.set(id, pr);
+        return { ...pr };
+    }
+    async mergePR(id) {
+        const pr = this.prs.get(id);
+        if (!pr) {
+            throw new Error(`MockGitPlugin: PR "${id}" not found`);
+        }
+        const now = new Date().toISOString();
+        this.prs.set(id, { ...pr, state: 'merged', mergedAt: now, updatedAt: now });
+    }
+    async addPRComment(id, body) {
+        const existing = this.prComments.get(id) ?? [];
+        this.prComments.set(id, [...existing, body]);
+    }
+    async getPR(id) {
+        const pr = this.prs.get(id);
+        if (!pr) {
+            throw new Error(`MockGitPlugin: PR "${id}" not found`);
+        }
+        return { ...pr };
+    }
+}
+//# sourceMappingURL=mock-git.js.map

package/dist/test-utils/mock-git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-git.js","sourceRoot":"","sources":["../../src/test-utils/mock-git.ts"],"names":[],"mappings":"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"}

package/dist/test-utils/mock-kanban.d.ts

@@ -0,0 +1,54 @@
+import type { KanbanPlugin, KanbanCard, KanbanColumn, PluginManifest, PluginContext, PluginHealth } from '@ouija-dev/types';
+import type { CardId, ColumnId, BoardId } from '@ouija-dev/types';
+/**
+ * In-memory KanbanPlugin for use in engine integration tests and plugin
+ * development. No network calls. All methods operate on internal Maps.
+ *
+ * Seed data via the `cards`, `columns`, and `assignments` properties before
+ * calling the plugin's methods.
+ */
+export declare class MockKanbanPlugin implements KanbanPlugin<Record<string, never>> {
+    readonly manifest: PluginManifest;
+    /** Mutable store: card ID → card */
+    readonly cards: Map<CardId, KanbanCard>;
+    /** Mutable store: board ID → columns */
+    readonly columns: Map<BoardId, KanbanColumn[]>;
+    /** Recorded comments: card ID → list of comment bodies */
+    readonly comments: Map<CardId, string[]>;
+    /** Recorded assignments: card ID → list of user IDs */
+    readonly assignments: Map<CardId, string[]>;
+    private initialised;
+    private running;
+    init(_context: PluginContext<Record<string, never>>): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    healthCheck(): Promise<PluginHealth>;
+    getCard(id: CardId): Promise<KanbanCard>;
+    moveCard(id: CardId, toColumnId: ColumnId): Promise<void>;
+    addComment(id: CardId, body: string): Promise<void>;
+    assignUser(id: CardId, userId: string): Promise<void>;
+    getColumns(board: BoardId): Promise<KanbanColumn[]>;
+    /**
+     * Add a card to the in-memory store.
+     * All fields have sensible defaults — only `id`, `title`, and `columnId` are required.
+     */
+    seedCard(partial: {
+        id: string;
+        title: string;
+        columnId: string;
+        boardId?: string;
+        description?: string;
+        labels?: string[];
+        assignees?: string[];
+        url?: string;
+        createdAt?: string;
+        updatedAt?: string;
+    }): KanbanCard;
+    /** Add columns for a board. */
+    seedColumns(board: string, cols: Array<{
+        id: string;
+        name: string;
+        position: number;
+    }>): void;
+}
+//# sourceMappingURL=mock-kanban.d.ts.map

package/dist/test-utils/mock-kanban.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-kanban.d.ts","sourceRoot":"","sources":["../../src/test-utils/mock-kanban.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAKlE;;;;;;GAMG;AACH,qBAAa,gBAAiB,YAAW,YAAY,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1E,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAO/B;IAEF,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAa;IACpD,wCAAwC;IACxC,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,CAAa;IAC3D,0DAA0D;IAC1D,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAa;IACrD,uDAAuD;IACvD,QAAQ,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAa;IAExD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IAIlB,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAInE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,WAAW,IAAI,OAAO,CAAC,YAAY,CAAC;IAUpC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAQxC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnD,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAerD,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAMzD;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE;QAChB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,UAAU;IAkBd,+BAA+B;IAC/B,WAAW,CACT,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GAC1D,IAAI;CAMR"}

package/dist/test-utils/mock-kanban.js

@@ -0,0 +1,108 @@
+import { cardId, columnId, boardId } from '@ouija-dev/types';
+// ---- Mock Kanban Plugin ----
+/**
+ * In-memory KanbanPlugin for use in engine integration tests and plugin
+ * development. No network calls. All methods operate on internal Maps.
+ *
+ * Seed data via the `cards`, `columns`, and `assignments` properties before
+ * calling the plugin's methods.
+ */
+export class MockKanbanPlugin {
+    manifest = {
+        name: '@ouija-dev/mock-kanban',
+        version: '0.1.0',
+        type: 'kanban',
+        coreApiVersion: '>=1.0.0 <2.0.0',
+        configSchema: { type: 'object', properties: {}, additionalProperties: false },
+        dependencies: [],
+    };
+    /** Mutable store: card ID → card */
+    cards = new Map();
+    /** Mutable store: board ID → columns */
+    columns = new Map();
+    /** Recorded comments: card ID → list of comment bodies */
+    comments = new Map();
+    /** Recorded assignments: card ID → list of user IDs */
+    assignments = new Map();
+    initialised = false;
+    running = false;
+    // ---- Lifecycle ----
+    async init(_context) {
+        this.initialised = true;
+    }
+    async start() {
+        this.running = true;
+    }
+    async stop() {
+        this.running = false;
+    }
+    async healthCheck() {
+        return {
+            healthy: true,
+            message: 'Mock kanban plugin is always healthy',
+            details: { initialised: this.initialised, running: this.running },
+        };
+    }
+    // ---- KanbanPlugin methods ----
+    async getCard(id) {
+        const card = this.cards.get(id);
+        if (!card) {
+            throw new Error(`MockKanbanPlugin: card "${id}" not found`);
+        }
+        return { ...card };
+    }
+    async moveCard(id, toColumnId) {
+        const card = this.cards.get(id);
+        if (!card) {
+            throw new Error(`MockKanbanPlugin: card "${id}" not found`);
+        }
+        this.cards.set(id, { ...card, columnId: toColumnId, updatedAt: new Date().toISOString() });
+    }
+    async addComment(id, body) {
+        const existing = this.comments.get(id) ?? [];
+        this.comments.set(id, [...existing, body]);
+    }
+    async assignUser(id, userId) {
+        const existing = this.assignments.get(id) ?? [];
+        this.assignments.set(id, [...existing, userId]);
+        // Mirror the assignee onto the card.
+        const card = this.cards.get(id);
+        if (card) {
+            this.cards.set(id, {
+                ...card,
+                assignees: [...card.assignees, userId],
+                updatedAt: new Date().toISOString(),
+            });
+        }
+    }
+    async getColumns(board) {
+        return this.columns.get(board) ?? [];
+    }
+    // ---- Seeding helpers ----
+    /**
+     * Add a card to the in-memory store.
+     * All fields have sensible defaults — only `id`, `title`, and `columnId` are required.
+     */
+    seedCard(partial) {
+        const now = new Date().toISOString();
+        const card = {
+            id: cardId(partial.id),
+            title: partial.title,
+            description: partial.description ?? '',
+            columnId: columnId(partial.columnId),
+            boardId: boardId(partial.boardId ?? 'board-1'),
+            labels: partial.labels ?? [],
+            assignees: partial.assignees ?? [],
+            url: partial.url ?? `https://mock.kanban/cards/${partial.id}`,
+            createdAt: partial.createdAt ?? now,
+            updatedAt: partial.updatedAt ?? now,
+        };
+        this.cards.set(card.id, card);
+        return card;
+    }
+    /** Add columns for a board. */
+    seedColumns(board, cols) {
+        this.columns.set(boardId(board), cols.map((c) => ({ id: columnId(c.id), name: c.name, position: c.position })));
+    }
+}
+//# sourceMappingURL=mock-kanban.js.map

package/dist/test-utils/mock-kanban.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-kanban.js","sourceRoot":"","sources":["../../src/test-utils/mock-kanban.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@ouija-dev/plugin-sdk",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist/", "README.md"],
+  "publishConfig": { "access": "public" },
+  "repository": { "type": "git", "url": "https://github.com/muhammadkh4n/ouija.git" },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@ouija-dev/types": "*",
+    "@types/semver": "^7.7.1",
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1",
+    "semver": "^7.7.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  }
+}