skeleton-crew-runtime 0.1.1

package/dist/runtime-context.d.ts

@@ -0,0 +1,127 @@
+import type { RuntimeContext, ScreenDefinition, ActionDefinition, PluginDefinition } from './types.js';
+import type { ScreenRegistry } from './screen-registry.js';
+import type { ActionEngine } from './action-engine.js';
+import type { PluginRegistry } from './plugin-registry.js';
+import type { EventBus } from './event-bus.js';
+import type { Runtime } from './types.js';
+/**
+ * RuntimeContext provides a safe API facade for subsystems.
+ * Passed to plugins and action handlers without exposing internal mutable structures.
+ *
+ * Requirements: 1.2, 9.1, 9.2, 9.3, 9.4, 9.5, 9.6
+ */
+export declare class RuntimeContextImpl implements RuntimeContext {
+    private screenRegistry;
+    private actionEngine;
+    private pluginRegistry;
+    private eventBus;
+    private runtime;
+    private hostContext;
+    constructor(screenRegistry: ScreenRegistry, actionEngine: ActionEngine, pluginRegistry: PluginRegistry, eventBus: EventBus, runtime: Runtime, hostContext: Record<string, unknown>);
+    /**
+     * Screens API - exposes Screen Registry operations
+     * Requirements: 4.1, 4.2, 4.3, 4.4, 4.5, 10.1, 10.2, 10.3, 10.4, 10.5
+     */
+    get screens(): {
+        registerScreen: (screen: ScreenDefinition) => (() => void);
+        getScreen: (id: string) => ScreenDefinition | null;
+        getAllScreens: () => ScreenDefinition[];
+    };
+    /**
+     * Actions API - exposes Action Engine operations
+     * Requirements: 4.1, 4.2, 4.3, 4.4, 4.5
+     */
+    get actions(): {
+        registerAction: <P = unknown, R = unknown>(action: ActionDefinition<P, R>) => (() => void);
+        runAction: <P = unknown, R = unknown>(id: string, params?: P) => Promise<R>;
+    };
+    /**
+     * Plugins API - exposes Plugin Registry operations
+     * Requirements: 13.1, 13.2, 13.3, 13.4, 13.5
+     */
+    get plugins(): {
+        registerPlugin: (plugin: PluginDefinition) => void;
+        getPlugin: (name: string) => PluginDefinition | null;
+        getAllPlugins: () => PluginDefinition[];
+        getInitializedPlugins: () => string[];
+    };
+    /**
+     * Events API - exposes Event Bus operations
+     * Requirements: 12.1, 12.2, 12.3, 12.4, 12.5
+     */
+    get events(): {
+        emit: (event: string, data?: unknown) => void;
+        emitAsync: (event: string, data?: unknown) => Promise<void>;
+        on: (event: string, handler: (data: unknown) => void) => (() => void);
+    };
+    /**
+     * Returns the Runtime instance
+     * Requirement: 9.6
+     */
+    getRuntime(): Runtime;
+    /**
+     * Host context - readonly access to injected host services
+     * Requirements: 1.2, 1.3, 1.4
+     *
+     * Returns a frozen shallow copy of the host context to prevent mutation.
+     * This ensures plugins can access host services but cannot modify them.
+     */
+    get host(): Readonly<Record<string, unknown>>;
+    /**
+     * Introspection API - query runtime metadata
+     * Requirements: 3.1, 4.1, 5.1, 6.1
+     */
+    get introspect(): {
+        /**
+         * List all registered action IDs
+         * Requirements: 3.1
+         */
+        listActions: () => string[];
+        /**
+         * Get action metadata by ID (excludes handler function)
+         * Requirements: 3.2, 3.3, 3.4, 3.5
+         */
+        getActionDefinition: (id: string) => Readonly<{
+            id: string;
+            timeout: number | undefined;
+        }> | null;
+        /**
+         * List all registered plugin names
+         * Requirements: 4.1
+         */
+        listPlugins: () => string[];
+        /**
+         * Get plugin metadata by name (excludes setup/dispose functions)
+         * Requirements: 4.2, 4.3, 4.4, 4.5
+         */
+        getPluginDefinition: (name: string) => Readonly<{
+            name: string;
+            version: string;
+        }> | null;
+        /**
+         * List all registered screen IDs
+         * Requirements: 5.1
+         */
+        listScreens: () => string[];
+        /**
+         * Get screen definition by ID (includes all properties)
+         * Requirements: 5.2, 5.3, 5.4, 5.5
+         */
+        getScreenDefinition: (id: string) => Readonly<{
+            id: string;
+            title: string;
+            component: string;
+        }> | null;
+        /**
+         * Get runtime metadata with statistics
+         * Requirements: 6.1, 6.2, 6.3, 6.4, 6.5
+         */
+        getMetadata: () => Readonly<{
+            runtimeVersion: string;
+            totalActions: number;
+            totalPlugins: number;
+            totalScreens: number;
+        }>;
+    };
+}
+//# sourceMappingURL=runtime-context.d.ts.map

package/dist/runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-context.d.ts","sourceRoot":"","sources":["../src/runtime-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACvG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAkC1C;;;;;GAKG;AACH,qBAAa,kBAAmB,YAAW,cAAc;IACvD,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,WAAW,CAA0B;gBAG3C,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,EAC1B,cAAc,EAAE,cAAc,EAC9B,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAUtC;;;OAGG;IACH,IAAI,OAAO;iCAEkB,gBAAgB,KAAG,CAAC,MAAM,IAAI,CAAC;wBAGxC,MAAM,KAAG,gBAAgB,GAAG,IAAI;6BAG7B,gBAAgB,EAAE;MAIxC;IAED;;;OAGG;IACH,IAAI,OAAO;yBAEU,CAAC,YAAY,CAAC,oBAAoB,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,CAAC,MAAM,IAAI,CAAC;oBAG5E,CAAC,YAAY,CAAC,gBAAgB,MAAM,WAAW,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC;MAI5E;IAED;;;OAGG;IACH,IAAI,OAAO;iCAEkB,gBAAgB,KAAG,IAAI;0BAG9B,MAAM,KAAG,gBAAgB,GAAG,IAAI;6BAG/B,gBAAgB,EAAE;qCAGV,MAAM,EAAE;MAItC;IAED;;;OAGG;IACH,IAAI,MAAM;sBAEQ,MAAM,SAAS,OAAO,KAAG,IAAI;2BAGxB,MAAM,SAAS,OAAO,KAAG,OAAO,CAAC,IAAI,CAAC;oBAG7C,MAAM,WAAW,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,KAAG,CAAC,MAAM,IAAI,CAAC;MAItE;IAED;;;OAGG;IACH,UAAU,IAAI,OAAO;IAIrB;;;;;;OAMG;IACH,IAAI,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAE5C;IAED;;;OAGG;IACH,IAAI,UAAU;QAEV;;;WAGG;2BACc,MAAM,EAAE;QAIzB;;;WAGG;kCACuB,MAAM;;;;QAchC;;;WAGG;2BACc,MAAM,EAAE;QAIzB;;;WAGG;oCACyB,MAAM;;;;QAclC;;;WAGG;2BACc,MAAM,EAAE;QAIzB;;;WAGG;kCACuB,MAAM;;;;;QAehC;;;WAGG;;;;;;;MAaN;CACF"}

package/dist/runtime-context.js

@@ -0,0 +1,227 @@
+/**
+ * Deep freeze utility - recursively freezes an object and all nested objects.
+ * Internal use only, not exported.
+ *
+ * Requirements: 7.1, 7.2, 7.3, 7.4, 7.5
+ *
+ * @param obj - The object to deep freeze
+ * @returns The frozen object with proper typing
+ */
+function deepFreeze(obj) {
+    // Freeze the object itself (Requirement 7.1)
+    Object.freeze(obj);
+    // Iterate over all properties (Requirement 7.2)
+    Object.getOwnPropertyNames(obj).forEach(prop => {
+        const value = obj[prop];
+        // Skip functions (Requirement 7.4)
+        if (typeof value === 'function') {
+            return;
+        }
+        // Skip already frozen objects (Requirement 7.5)
+        if (value && typeof value === 'object' && !Object.isFrozen(value)) {
+            // Recursively freeze nested objects and arrays (Requirements 7.2, 7.3)
+            deepFreeze(value);
+        }
+    });
+    return obj;
+}
+/**
+ * RuntimeContext provides a safe API facade for subsystems.
+ * Passed to plugins and action handlers without exposing internal mutable structures.
+ *
+ * Requirements: 1.2, 9.1, 9.2, 9.3, 9.4, 9.5, 9.6
+ */
+export class RuntimeContextImpl {
+    screenRegistry;
+    actionEngine;
+    pluginRegistry;
+    eventBus;
+    runtime;
+    hostContext;
+    constructor(screenRegistry, actionEngine, pluginRegistry, eventBus, runtime, hostContext) {
+        this.screenRegistry = screenRegistry;
+        this.actionEngine = actionEngine;
+        this.pluginRegistry = pluginRegistry;
+        this.eventBus = eventBus;
+        this.runtime = runtime;
+        this.hostContext = hostContext;
+    }
+    /**
+     * Screens API - exposes Screen Registry operations
+     * Requirements: 4.1, 4.2, 4.3, 4.4, 4.5, 10.1, 10.2, 10.3, 10.4, 10.5
+     */
+    get screens() {
+        return {
+            registerScreen: (screen) => {
+                return this.screenRegistry.registerScreen(screen);
+            },
+            getScreen: (id) => {
+                return this.screenRegistry.getScreen(id);
+            },
+            getAllScreens: () => {
+                return this.screenRegistry.getAllScreens();
+            }
+        };
+    }
+    /**
+     * Actions API - exposes Action Engine operations
+     * Requirements: 4.1, 4.2, 4.3, 4.4, 4.5
+     */
+    get actions() {
+        return {
+            registerAction: (action) => {
+                return this.actionEngine.registerAction(action);
+            },
+            runAction: (id, params) => {
+                return this.actionEngine.runAction(id, params);
+            }
+        };
+    }
+    /**
+     * Plugins API - exposes Plugin Registry operations
+     * Requirements: 13.1, 13.2, 13.3, 13.4, 13.5
+     */
+    get plugins() {
+        return {
+            registerPlugin: (plugin) => {
+                this.pluginRegistry.registerPlugin(plugin);
+            },
+            getPlugin: (name) => {
+                return this.pluginRegistry.getPlugin(name);
+            },
+            getAllPlugins: () => {
+                return this.pluginRegistry.getAllPlugins();
+            },
+            getInitializedPlugins: () => {
+                return this.pluginRegistry.getInitializedPlugins();
+            }
+        };
+    }
+    /**
+     * Events API - exposes Event Bus operations
+     * Requirements: 12.1, 12.2, 12.3, 12.4, 12.5
+     */
+    get events() {
+        return {
+            emit: (event, data) => {
+                this.eventBus.emit(event, data);
+            },
+            emitAsync: (event, data) => {
+                return this.eventBus.emitAsync(event, data);
+            },
+            on: (event, handler) => {
+                return this.eventBus.on(event, handler);
+            }
+        };
+    }
+    /**
+     * Returns the Runtime instance
+     * Requirement: 9.6
+     */
+    getRuntime() {
+        return this.runtime;
+    }
+    /**
+     * Host context - readonly access to injected host services
+     * Requirements: 1.2, 1.3, 1.4
+     *
+     * Returns a frozen shallow copy of the host context to prevent mutation.
+     * This ensures plugins can access host services but cannot modify them.
+     */
+    get host() {
+        return Object.freeze({ ...this.hostContext });
+    }
+    /**
+     * Introspection API - query runtime metadata
+     * Requirements: 3.1, 4.1, 5.1, 6.1
+     */
+    get introspect() {
+        return {
+            /**
+             * List all registered action IDs
+             * Requirements: 3.1
+             */
+            listActions: () => {
+                return this.actionEngine.getAllActions().map(action => action.id);
+            },
+            /**
+             * Get action metadata by ID (excludes handler function)
+             * Requirements: 3.2, 3.3, 3.4, 3.5
+             */
+            getActionDefinition: (id) => {
+                const action = this.actionEngine.getAction(id);
+                if (!action)
+                    return null;
+                // Extract only id and timeout (exclude handler function)
+                const metadata = {
+                    id: action.id,
+                    timeout: action.timeout
+                };
+                // Deep freeze the metadata
+                return deepFreeze(metadata);
+            },
+            /**
+             * List all registered plugin names
+             * Requirements: 4.1
+             */
+            listPlugins: () => {
+                return this.pluginRegistry.getAllPlugins().map(plugin => plugin.name);
+            },
+            /**
+             * Get plugin metadata by name (excludes setup/dispose functions)
+             * Requirements: 4.2, 4.3, 4.4, 4.5
+             */
+            getPluginDefinition: (name) => {
+                const plugin = this.pluginRegistry.getPlugin(name);
+                if (!plugin)
+                    return null;
+                // Extract only name and version (exclude setup/dispose functions)
+                const metadata = {
+                    name: plugin.name,
+                    version: plugin.version
+                };
+                // Deep freeze the metadata
+                return deepFreeze(metadata);
+            },
+            /**
+             * List all registered screen IDs
+             * Requirements: 5.1
+             */
+            listScreens: () => {
+                return this.screenRegistry.getAllScreens().map(screen => screen.id);
+            },
+            /**
+             * Get screen definition by ID (includes all properties)
+             * Requirements: 5.2, 5.3, 5.4, 5.5
+             */
+            getScreenDefinition: (id) => {
+                const screen = this.screenRegistry.getScreen(id);
+                if (!screen)
+                    return null;
+                // Include all screen properties
+                const metadata = {
+                    id: screen.id,
+                    title: screen.title,
+                    component: screen.component
+                };
+                // Deep freeze the metadata
+                return deepFreeze(metadata);
+            },
+            /**
+             * Get runtime metadata with statistics
+             * Requirements: 6.1, 6.2, 6.3, 6.4, 6.5
+             */
+            getMetadata: () => {
+                const metadata = {
+                    runtimeVersion: '0.1.0',
+                    totalActions: this.actionEngine.getAllActions().length,
+                    totalPlugins: this.pluginRegistry.getAllPlugins().length,
+                    totalScreens: this.screenRegistry.getAllScreens().length
+                };
+                // Deep freeze the metadata
+                return deepFreeze(metadata);
+            }
+        };
+    }
+}
+//# sourceMappingURL=runtime-context.js.map

package/dist/runtime-context.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,125 @@
+import type { RuntimeContext, UIProvider, PluginDefinition, RuntimeOptions } from './types.js';
+import { RuntimeState } from './types.js';
+/**
+ * Runtime is the main orchestrator that coordinates all subsystems.
+ * Handles initialization, shutdown, and lifecycle state tracking.
+ *
+ * Requirements: 1.1, 1.2, 1.3, 1.4, 1.5, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.1, 3.5, 7.1, 7.2, 7.3, 7.4, 7.5, 7.6, 9.7, 9.9, 15.1, 15.3, 15.5, 16.1, 16.2, 16.3, 16.4, 16.5
+ */
+export declare class Runtime {
+    private plugins;
+    private screens;
+    private actions;
+    private events;
+    private ui;
+    private context;
+    private initialized;
+    private pendingPlugins;
+    private logger;
+    private state;
+    private hostContext;
+    /**
+     * Creates a new Runtime instance with optional configuration.
+     *
+     * @param options - Optional configuration object
+     * @param options.logger - Custom logger implementation (defaults to ConsoleLogger)
+     * @param options.hostContext - Host application services to inject (defaults to empty object)
+     *
+     * Requirements: 1.1, 1.5, 7.1, 7.2, 7.3, 7.4, 7.5, 7.6
+     */
+    constructor(options?: RuntimeOptions);
+    /**
+     * Validates host context and logs warnings for common mistakes.
+     * Does not throw errors or modify the context.
+     *
+     * @param context - The host context to validate
+     *
+     * Requirements: 2.1, 2.2, 2.3, 2.4
+     */
+    private validateHostContext;
+    /**
+     * Registers a plugin before initialization.
+     * Plugins registered this way will have their setup callbacks executed during initialize().
+     *
+     * @param plugin - The plugin definition to register
+     * @throws Error if runtime is already initialized
+     */
+    registerPlugin(plugin: PluginDefinition): void;
+    /**
+     * Initializes the runtime following the strict initialization sequence.
+     * Creates all subsystems in order, then executes plugin setup callbacks.
+     * Emits runtime:initialized event after successful initialization.
+     *
+     * @throws Error if initialize is called twice
+     * @throws Error if any plugin setup fails
+     *
+     * Requirements: 1.1, 1.2, 1.3, 1.4, 1.5, 2.1, 2.2, 2.3, 2.4, 2.5, 2.6, 3.1, 3.5, 15.1, 15.3, 15.5, 16.1, 16.2, 16.3, 16.4, 16.5, 17.1, 17.2, 17.3
+     */
+    initialize(): Promise<void>;
+    /**
+     * Shuts down the runtime following the strict shutdown sequence.
+     * Emits runtime:shutdown event at start of shutdown.
+     * Disposes initialized plugins, shuts down UI provider, clears all registries, and releases resources.
+     * Safe to call multiple times (idempotent).
+     *
+     * Requirements: 4.1, 4.2, 4.3, 4.4, 4.5, 9.5, 15.2, 15.4, 15.6, 16.1, 16.2, 16.3, 16.4, 16.5, 17.4, 17.5
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Returns the RuntimeContext for this runtime instance.
+     *
+     * @returns The RuntimeContext
+     * @throws Error if runtime is not initialized
+     *
+     * Requirement: 9.1
+     */
+    getContext(): RuntimeContext;
+    /**
+     * Returns whether the runtime has been initialized.
+     *
+     * @returns true if runtime is initialized, false otherwise
+     *
+     * Requirements: 16.1, 16.2, 16.3
+     */
+    isInitialized(): boolean;
+    /**
+     * Returns the current lifecycle state of the runtime.
+     *
+     * @returns The current RuntimeState
+     *
+     * Requirements: 16.1, 16.2, 16.3, 16.4, 16.5
+     */
+    getState(): RuntimeState;
+    /**
+     * Registers a UI provider with the runtime.
+     * Delegates to UIBridge subsystem.
+     * Can be called after initialization completes.
+     *
+     * @param provider - The UI provider implementation
+     * @throws Error if provider is invalid or already registered
+     *
+     * Requirements: 10.3, 10.9
+     */
+    setUIProvider(provider: UIProvider): void;
+    /**
+     * Returns the registered UI provider.
+     * Delegates to UIBridge subsystem.
+     *
+     * @returns The registered UIProvider or null if none registered
+     *
+     * Requirement: 10.4
+     */
+    getUIProvider(): UIProvider | null;
+    /**
+     * Renders a screen by looking it up in the ScreenRegistry and delegating to UIBridge.
+     *
+     * @param screenId - The screen identifier to render
+     * @returns The result from the UI provider's render method
+     * @throws Error if screen is not found
+     * @throws Error if no UI provider is registered
+     *
+     * Requirement: 10.5
+     */
+    renderScreen(screenId: string): unknown;
+}
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,gBAAgB,EAAE,cAAc,EAAU,MAAM,YAAY,CAAC;AACvG,OAAO,EAAiB,YAAY,EAAE,MAAM,YAAY,CAAC;AAQzD;;;;;GAKG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,EAAE,CAAY;IACtB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,WAAW,CAAkB;IACrC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAA4C;IACzD,OAAO,CAAC,WAAW,CAA0B;IAE7C;;;;;;;;OAQG;gBACS,OAAO,CAAC,EAAE,cAAc;IAMpC;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IA2B3B;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAO9C;;;;;;;;;OASG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiEjC;;;;;;;OAOG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC/B;;;;;;;OAOG;IACH,UAAU,IAAI,cAAc;IAO5B;;;;;;OAMG;IACH,aAAa,IAAI,OAAO;IAIxB;;;;;;OAMG;IACH,QAAQ,IAAI,YAAY;IAIxB;;;;;;;;;OASG;IACH,aAAa,CAAC,QAAQ,EAAE,UAAU,GAAG,IAAI;IAIzC;;;;;;;OAOG;IACH,aAAa,IAAI,UAAU,GAAG,IAAI;IAIlC;;;;;;;;;OASG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;CAYxC"}