skeleton-crew-runtime 0.1.1 → 0.1.2

package/README.md

@@ -1,671 +1,264 @@
 # Skeleton Crew Runtime
 
-**Modernize your legacy app without rewriting it.**
+**A minimal plugin runtime for building modular JavaScript applications.**
 
-A minimal runtime that lets you add new features to existing applications using a clean plugin architecture — while keeping your old code running.
+Stop wiring up infrastructure. Start building features.
 
-## The Problem
-
-You have a working application, but:
-
-- Adding features means touching fragile legacy code
-- Different parts use different patterns (callbacks, promises, globals)
-- Testing is hard because everything is tightly coupled
-- You want to use modern patterns but can't justify a full rewrite
-
-**Sound familiar?**
-
-## The Solution
-
-Skeleton Crew lets you write new features as isolated plugins that can access your existing services — without touching legacy code.
+```bash
+npm install skeleton-crew-runtime
+```
+---
+## Documentation
 
-```typescript
-// Your existing app (unchanged)
-const legacyApp = {
-  database: new DatabaseConnection(),
-  logger: new Logger(),
-  userService: new UserService()
-};
+### Getting Started
+- **[Installation](docs/getting-started/installation.md)** - Install and setup
+- **[API Reference](docs/api/reference.md)** - Complete TypeScript API
+- **[Core Concepts](docs/getting-started/README.md)** - Understand the fundamentals
+- **[Your First Plugin](docs/getting-started/your-first-plugin.md)** - Build your first feature
 
-// Add Skeleton Crew alongside it
-const runtime = new Runtime({
-  hostContext: {
-    db: legacyApp.database,
-    logger: legacyApp.logger,
-    users: legacyApp.userService
-  }
-});
+### Guides & Examples
+- **[Migration Guide](docs/guides/migration-guide.md)** - Integrate with existing apps
+- **[Examples Guide](docs/guides/EXAMPLES_GUIDE.md)** - Learn through code examples
 
-// Write new features as clean, testable plugins
-const newFeaturePlugin = {
-  name: "analytics",
-  version: "1.0.0",
-  setup(ctx) {
-    // Access legacy services through context
-    const { db, logger } = ctx.host;
-    
-    ctx.actions.registerAction({
-      id: "analytics:track",
-      handler: async (event) => {
-        logger.info("Tracking event:", event);
-        await db.insert("analytics", event);
-        ctx.events.emit("analytics:tracked", event);
-      }
-    });
-  }
-};
+### Use Cases
+- **[Browser Extensions](docs/use-cases/BROWSER_TOOLS.md)** - Build browser tools
+- **[CLI Applications](docs/use-cases/)** - Command-line tools
+- **[Real-Time Apps](docs/use-cases/)** - Collaboration and sync
 
-await runtime.initialize();
-runtime.getContext().plugins.registerPlugin(newFeaturePlugin);
-```
+### Advanced
+- **[Architecture](docs/architecture/)** - How it works under the hood
+- **[Troubleshooting](docs/troubleshooting/)** - Common issues and solutions
 
-**Result:** New code is clean, testable, and isolated. Old code keeps working.
+---
 
-## Why This Approach Works
+## What is this?
 
-### ✅ Zero Risk
-Your existing code doesn't change. New features run alongside it.
+Skeleton Crew Runtime is a lightweight foundation for building applications where features can be added, removed, or replaced without touching existing code. Think VS Code's extension system, but for any JavaScript application.
 
-### ✅ Incremental Migration
-Migrate one feature at a time. No big-bang rewrites.
+**Core idea:** Your app is a collection of plugins. Each plugin registers actions (business logic), screens (UI definitions), and events (communication). The runtime coordinates everything.
 
-### ✅ Immediate Value
-Start writing better code today. See benefits immediately.
+**Result:** Add features by dropping in plugins. Remove features by taking them out. No refactoring. No breaking changes.
 
-### ✅ Team Friendly
-New developers work in clean plugin code. Legacy experts maintain old code.
+## Why would I use this?
 
-### ✅ Future Proof
-When you're ready, gradually replace legacy services. Or don't — both work fine.
+You're building something modular and you might know these challenges:
 
+- **Wiring up infrastructure** - Event buses, plugin loaders, action registries
+- **Tight coupling** - Changing one feature breaks three others
+- **Testing nightmares** - Can't test features in isolation
+- **Framework lock-in** - Married to React/Vue/whatever forever
+- **Refactoring hell** - Adding features means touching existing code
 
-## Quick Start: Add Your First Feature
+**Skeleton Crew Runtime gives you:**
 
-### 1. Install
+- **Plugin isolation** - Features don't know about each other
+- **Event-driven communication** - Plugins coordinate without coupling
+- **Framework freedom** - Business logic separate from UI
+- **Testability** - Mock what you need, test what matters
+- **Minimal core** - < 5KB, zero dependencies
 
-```bash
-npm install skeleton-crew-runtime
-```
+## Show me code
 
-### 2. Create Runtime with Your Existing Services
+Here's a complete plugin that adds a feature to your app:
 
 ```typescript
-import { Runtime } from "skeleton-crew-runtime";
-
-// Inject your existing services
-const runtime = new Runtime({
-  hostContext: {
-    db: yourDatabase,
-    api: yourApiClient,
-    logger: yourLogger,
-    config: yourConfig
-  }
-});
+import { Runtime, PluginDefinition } from 'skeleton-crew-runtime';
 
+// 1. Create runtime
+const runtime = new Runtime();
 await runtime.initialize();
-```
-
-### 3. Write a Plugin for Your New Feature
+const ctx = runtime.getContext();
 
-```typescript
-// plugins/notifications.ts
-export const NotificationsPlugin = {
-  name: "notifications",
-  version: "1.0.0",
+// 2. Write a plugin (this is a complete feature)
+const notificationsPlugin: PluginDefinition = {
+  name: 'notifications',
+  version: '1.0.0',
   
   setup(ctx) {
-    // Access your existing services
-    const { db, logger } = ctx.host;
-    
-    // Register an action
+    // Register business logic
     ctx.actions.registerAction({
-      id: "notifications:send",
-      handler: async ({ userId, message }) => {
-        logger.info(`Sending notification to user ${userId}`);
-        
-        // Use your existing database
-        await db.insert("notifications", {
-          userId,
-          message,
-          createdAt: new Date()
-        });
+      id: 'notifications:send',
+      handler: async ({ userId, message }, ctx) => {
+        // Your logic here
+        await sendPushNotification(userId, message);
         
-        // Emit event for other plugins
-        ctx.events.emit("notification:sent", { userId, message });
+        // Let other plugins know
+        ctx.events.emit('notification:sent', { userId });
         
         return { success: true };
       }
     });
     
-    // Listen to events from other parts of your app
-    ctx.events.on("user:registered", async (user) => {
-      await ctx.actions.runAction("notifications:send", {
+    // React to other plugins
+    ctx.events.on('user:registered', async (user) => {
+      await ctx.actions.runAction('notifications:send', {
         userId: user.id,
-        message: "Welcome to our app!"
+        message: 'Welcome!'
       });
     });
   }
 };
-```
-
-### 4. Register and Use
 
-```typescript
-const ctx = runtime.getContext();
+// 3. Register and use
+ctx.plugins.registerPlugin(notificationsPlugin);
 
-// Register your plugin
-ctx.plugins.registerPlugin(NotificationsPlugin);
-
-// Call from anywhere in your app
-await ctx.actions.runAction("notifications:send", {
+// anywhere in your app
+await ctx.actions.runAction('notifications:send', {
   userId: 123,
-  message: "Your order has shipped!"
+  message: 'Your order shipped!'
 });
 ```
 
-**That's it.** Your new feature is isolated, testable, and doesn't touch legacy code.
+**That's it.** The plugin is isolated, testable, and can be removed without breaking anything.
 
-## Core Concepts (5 Minutes to Learn)
+## Core concepts (5 minutes)
 
-### 1. Host Context: Bridge to Legacy Code
+### 1. Plugins: Isolated Features
 
-Inject your existing services so plugins can use them:
+A plugin is just an object with a name and a setup function:
 
 ```typescript
-const runtime = new Runtime({
-  hostContext: {
-    db: legacyDatabase,      // Your existing DB connection
-    cache: redisClient,      // Your existing cache
-    auth: authService        // Your existing auth
-  }
-});
+import type { PluginDefinition, RuntimeContext } from 'skeleton-crew-runtime';
 
-// Plugins access via ctx.host
-const { db, cache, auth } = ctx.host;
+export const myPlugin: PluginDefinition = {
+  name: 'my-plugin',
+  version: '1.0.0',
+  
+  setup(ctx: RuntimeContext) {
+    // Register your feature here
+  },
+  
+  dispose(ctx: RuntimeContext) {
+    // Optional: cleanup resources when plugin is removed
+    // Use this for: closing connections, clearing timers, releasing memory
+    // Event listeners auto-cleanup, so you usually don't need this
+  }
+};
 ```
 
 ### 2. Actions: Business Logic
 
-Encapsulate operations as named, testable actions:
+Actions are named functions that do work:
 
 ```typescript
+// Register an action
 ctx.actions.registerAction({
-  id: "orders:create",
-  handler: async (orderData) => {
+  id: 'orders:create',
+  handler: async (orderData, ctx) => {
     const { db } = ctx.host;
-    const order = await db.insert("orders", orderData);
-    ctx.events.emit("order:created", order);
+    const order = await db.insert('orders', orderData);
+    ctx.events.emit('order:created', order);
     return order;
   }
 });
 
 // Call from anywhere
-const order = await ctx.actions.runAction("orders:create", data);
+const order = await ctx.actions.runAction('orders:create', data);
 ```
 
 ### 3. Events: Decouple Features
 
-Let features communicate without direct dependencies:
-
-```typescript
-// Feature A: Emit event
-ctx.events.emit("order:created", order);
-
-// Feature B: React to event (doesn't know about Feature A)
-ctx.events.on("order:created", (order) => {
-  ctx.actions.runAction("email:send", {
-    to: order.customerEmail,
-    template: "order-confirmation"
-  });
-});
-```
-
-### 4. Plugins: Isolated Features
-
-Group related functionality into plugins:
+Plugins communicate without knowing about each other:
 
 ```typescript
-export const OrdersPlugin = {
-  name: "orders",
-  version: "1.0.0",
-  setup(ctx) {
-    // Register actions, screens, event handlers
-    // Everything for "orders" feature in one place
-  }
-};
-```
-
-### 5. Screens (Optional): UI Definitions
-
-Define screens that any UI framework can render:
+// Plugin A: Emit event
+ctx.events.emit('order:created', order);
 
-```typescript
-ctx.screens.registerScreen({
-  id: "orders:list",
-  title: "Orders",
-  component: OrderListComponent  // React, Vue, or anything
+// Plugin B: React (doesn't know about Plugin A)
+ctx.events.on('order:created', (order) => {
+  sendConfirmationEmail(order);
 });
 ```
 
-## Real-World Migration Patterns
-
-### Pattern 1: Feature Flags (Safest)
-
-Gradually switch features from legacy to plugins:
-
-```typescript
-const features = {
-  notifications: 'plugin',  // Using Skeleton Crew
-  payments: 'legacy',       // Still using old code
-  reports: 'plugin'         // Using Skeleton Crew
-};
-
-class App {
-  async sendNotification(userId, message) {
-    if (features.notifications === 'plugin') {
-      return this.runtime.getContext().actions.runAction(
-        'notifications:send',
-        { userId, message }
-      );
-    } else {
-      return this.legacyNotifications.send(userId, message);
-    }
-  }
-}
-```
-
-**Benefits:** Roll back instantly if issues arise. Test in production with small user percentage.
+### 4. Host Context: Bridge to Existing Code
 
-### Pattern 2: New Features Only
-
-Keep legacy code frozen. All new features are plugins:
+Inject your existing services so plugins can use them:
 
 ```typescript
-// Legacy code (frozen, no changes)
-class LegacyApp {
-  constructor() {
-    this.db = new Database();
-    this.users = new UserService(this.db);
-  }
-}
+import { Runtime } from 'skeleton-crew-runtime';
 
-// New features as plugins
 const runtime = new Runtime({
   hostContext: {
-    db: legacyApp.db,
-    users: legacyApp.users
+    db: yourDatabase,
+    cache: redisClient,
+    logger: yourLogger
   }
 });
 
-// New "analytics" feature - clean plugin code
-const AnalyticsPlugin = {
-  name: "analytics",
-  version: "1.0.0",
-  setup(ctx) {
-    const { db, users } = ctx.host;
-    
-    ctx.actions.registerAction({
-      id: "analytics:track",
-      handler: async (event) => {
-        await db.insert("analytics", event);
-      }
-    });
-  }
-};
-```
-
-**Benefits:** Legacy code stays stable. New code is clean and testable. No rewrite needed.
-
-### Pattern 3: Strangler Fig
-
-Gradually replace legacy services with plugin-based ones:
-
-```typescript
-// Phase 1: Legacy service
-const legacyAuth = new LegacyAuthService();
-
-// Phase 2: New auth plugin (same interface)
-const AuthPlugin = {
-  name: "auth",
-  version: "2.0.0",
-  setup(ctx) {
-    ctx.actions.registerAction({
-      id: "auth:login",
-      handler: async (credentials) => {
-        // New implementation
-      }
-    });
-  }
-};
-
-// Phase 3: Switch gradually
-const useNewAuth = process.env.NEW_AUTH === 'true';
+await runtime.initialize();
+const ctx = runtime.getContext();
 
-async function login(credentials) {
-  if (useNewAuth) {
-    return runtime.getContext().actions.runAction('auth:login', credentials);
-  } else {
-    return legacyAuth.login(credentials);
-  }
-}
+// Plugins access via ctx.host
+const { db, logger } = ctx.host;
 ```
 
-**Benefits:** Replace services one at a time. Run both versions in parallel. Validate before full switch.
-
-### Pattern 4: Event-Driven Integration
+### 5. Screens (Optional): UI Definitions
 
-Let legacy code emit events that plugins handle:
+Define screens that any UI framework can render:
 
 ```typescript
-// Legacy code (minimal change - just emit events)
-class LegacyUserService {
-  async createUser(userData) {
-    const user = await this.db.insert('users', userData);
-    
-    // Add this one line
-    eventBus.emit('user:created', user);
-    
-    return user;
-  }
-}
-
-// New plugin reacts to legacy events
-const WelcomeEmailPlugin = {
-  name: "welcome-emails",
-  version: "1.0.0",
-  setup(ctx) {
-    ctx.events.on('user:created', async (user) => {
-      await ctx.actions.runAction('email:send', {
-        to: user.email,
-        template: 'welcome'
-      });
-    });
-  }
-};
+ctx.screens.registerScreen({
+  id: 'orders:list',
+  title: 'Orders',
+  component: 'OrderListComponent'  // string, class, function, or any type
+});
 ```
 
-**Benefits:** Minimal legacy changes. New features are completely isolated. Easy to add/remove features.
-
-## When to Use Skeleton Crew
-
-### ✅ Perfect For
-
-- **Legacy modernization** - Add features without touching old code
-- **Internal tools** - Admin panels, dashboards, dev tools
-- **Browser extensions** - Background scripts with plugin architecture
-- **Modular applications** - Features that can be enabled/disabled
-- **Multi-team codebases** - Teams work on isolated plugins
-- **Gradual rewrites** - Migrate piece by piece
-
-### ❌ Not Ideal For
-
-- **Greenfield apps with simple needs** - Might be overkill
-- **Static websites** - No need for runtime architecture
-- **Apps with single feature** - Plugin system adds unnecessary complexity
-
 ---
 
-## Advanced Features
-
-### Introspection API
-
-Debug and monitor your runtime:
-
-```typescript
-const ctx = runtime.getContext();
-
-// List all registered resources
-const actions = ctx.introspect.listActions();
-const plugins = ctx.introspect.listPlugins();
-const screens = ctx.introspect.listScreens();
+## What can I build?
 
-// Get metadata
-const stats = ctx.introspect.getMetadata();
-// { runtimeVersion: "0.1.0", totalActions: 15, totalPlugins: 5 }
-```
-
-**Use cases:** Admin dashboards, debugging tools, runtime monitoring.
+Skeleton Crew works for any modular JavaScript application:
 
-### Action Timeouts
+### Developer Tools
+- **CLI tools** - Task runners, deployment scripts, dev environments
+- **Browser extensions** - Tab managers, productivity tools, dev tools
+- **Build tools** - Custom bundlers, code generators, linters
 
-Prevent hanging operations:
-
-```typescript
-ctx.actions.registerAction({
-  id: "api:fetch",
-  timeout: 5000,  // 5 seconds max
-  handler: async () => {
-    return await fetch('/api/data');
-  }
-});
-```
+### Internal Applications
+- **Admin panels** - User management, content moderation, analytics
+- **Dashboards** - Monitoring, reporting, data visualization
+- **Workflow tools** - Approval systems, task management, automation
 
-### Event Patterns
+### Real-Time Applications
+- **Collaboration tools** - Shared editing, presence, chat
+- **Live dashboards** - Stock tickers, sports scores, IoT monitoring
+- **Multiplayer features** - Game state sync, player coordination
 
-**Fire-and-forget:**
-```typescript
-ctx.events.emit('user:created', user);  // Synchronous
-```
+### Modular Systems
+- **Plugin marketplaces** - Let users extend your app
+- **White-label products** - Different features for different customers
+- **Microservices** - Coordinate distributed services
 
-**Wait for handlers:**
-```typescript
-await ctx.events.emitAsync('order:processed', order);  // Asynchronous
-```
+**Not ideal for:** Public-facing websites (use Next.js), complex routing (use React Router), heavy state management (use Redux).
 
 ---
 
-## Learning Resources
+## Real examples
 
-### Complete Migration Guide
-
-See [Migration Guide](docs/guides/migration-guide.md) for:
-- Step-by-step migration strategies
-- Real-world examples
-- Common pitfalls and solutions
-- Testing strategies
-
-### Tutorial: Build a Task Manager
-
-Learn by building a complete app from scratch:
+### CLI Tool (150 lines vs 500+)
+**What you'll see:** Interactive CLI that runs commands, shows output, handles errors. All plugin-based.
 
 ```bash
-npm run build
-npm run tutorial:01  # Start with step 1
+# Build a command palette for Git, npm, and Docker:
+cd demo/dev-launcher
+npm install && npm start
 ```
 
-See [example/tutorial/README.md](example/tutorial/README.md).
-
-### Example Applications
-
-Run focused examples:
+### Real-Time Collaboration (130 lines vs 500+)
+**What you'll see:** Multiple clients syncing state in real-time. No Firebase, no Socket.io boilerplate.
 
 ```bash
-npm run example:01  # Plugin System
-npm run example:02  # Screen Registry
-npm run example:03  # Action Engine
-npm run example:04  # Event Bus
-npm run example:05  # Runtime Context
-npm run example     # Complete playground
-```
-
-## How It Works
-
-```
-┌─────────────────────────────────────────────────┐
-│           Your Legacy Application               │
-│  ┌──────────┐  ┌──────────┐  ┌──────────┐     │
-│  │ Database │  │   API    │  │  Logger  │     │
-│  └────┬─────┘  └────┬─────┘  └────┬─────┘     │
-│       │             │              │            │
-│       └─────────────┴──────────────┘            │
-│                     │                            │
-│              Host Context (injected)             │
-└─────────────────────┬───────────────────────────┘
-                      │
-┌─────────────────────▼───────────────────────────┐
-│         Skeleton Crew Runtime                   │
-│                                                  │
-│  ┌──────────────────────────────────────────┐  │
-│  │  Plugin 1    Plugin 2    Plugin 3        │  │
-│  │  (new code)  (new code)  (new code)      │  │
-│  └──────────────────────────────────────────┘  │
-│         │            │            │             │
-│    ┌────▼────┐  ┌───▼────┐  ┌───▼────┐        │
-│    │ Actions │  │ Events │  │Screens │        │
-│    └─────────┘  └────────┘  └────────┘        │
-└─────────────────────────────────────────────────┘
-```
-
-**Key insight:** Legacy services flow up through host context. New features are isolated plugins that use those services.
-
-## Testing Your Plugins
-
-One of the biggest wins: plugins are easy to test.
-
-```typescript
-import { describe, it, expect, beforeEach } from 'vitest';
-import { Runtime } from 'skeleton-crew-runtime';
-import { NotificationsPlugin } from './notifications.js';
-
-describe('NotificationsPlugin', () => {
-  let runtime;
-  let mockDb;
-  
-  beforeEach(async () => {
-    // Mock your legacy services
-    mockDb = {
-      insert: vi.fn().mockResolvedValue({ id: 1 })
-    };
-    
-    // Create isolated runtime for testing
-    runtime = new Runtime({
-      hostContext: { db: mockDb }
-    });
-    
-    await runtime.initialize();
-    runtime.getContext().plugins.registerPlugin(NotificationsPlugin);
-  });
-  
-  it('sends notification', async () => {
-    const ctx = runtime.getContext();
-    
-    const result = await ctx.actions.runAction('notifications:send', {
-      userId: 123,
-      message: 'Test'
-    });
-    
-    expect(result.success).toBe(true);
-    expect(mockDb.insert).toHaveBeenCalledWith('notifications', {
-      userId: 123,
-      message: 'Test',
-      createdAt: expect.any(Date)
-    });
-  });
-});
-```
-
-**Benefits:**
-- No need to set up entire legacy app
-- Mock only what you need
-- Fast, isolated tests
-- Easy to test edge cases
-
-## API Quick Reference
-
-### Runtime Setup
-
-```typescript
-import { Runtime } from 'skeleton-crew-runtime';
-
-const runtime = new Runtime({
-  hostContext: {
-    // Your existing services
-    db: yourDatabase,
-    logger: yourLogger
-  }
-});
-
-await runtime.initialize();
-const ctx = runtime.getContext();
-```
-
-### Working with Actions
-
-```typescript
-// Register
-ctx.actions.registerAction({
-  id: 'feature:action',
-  timeout: 5000,  // optional
-  handler: async (params) => {
-    const { db } = ctx.host;
-    return await db.query(params);
-  }
-});
-
-// Execute
-const result = await ctx.actions.runAction('feature:action', params);
-```
-
-### Working with Events
-
-```typescript
-// Subscribe
-ctx.events.on('entity:changed', (data) => {
-  console.log('Changed:', data);
-});
-
-// Emit (fire-and-forget)
-ctx.events.emit('entity:changed', { id: 123 });
-
-// Emit (wait for handlers)
-await ctx.events.emitAsync('entity:changed', { id: 123 });
+# Build a multi-user sync system:
+cd demo/collab-hub
+npm install && npm run build
+npm run server  # Terminal 1
+npm run client  # Terminal 2-3
 ```
 
-### Working with Plugins
+**[See all demos →](demo/README.md)**
 
-```typescript
-// Define
-export const MyPlugin = {
-  name: 'my-plugin',
-  version: '1.0.0',
-  setup(ctx) {
-    // Register actions, screens, events
-  },
-  dispose(ctx) {
-    // Optional cleanup
-  }
-};
-
-// Register
-ctx.plugins.registerPlugin(MyPlugin);
-```
-
-### Accessing Host Context
-
-```typescript
-// In any plugin
-setup(ctx) {
-  const { db, logger, cache } = ctx.host;
-  
-  // Use your existing services
-  await db.query('SELECT * FROM users');
-  logger.info('Plugin initialized');
-}
-```
-
-### Introspection
-
-```typescript
-// List resources
-const actions = ctx.introspect.listActions();
-const plugins = ctx.introspect.listPlugins();
-
-// Get metadata
-const actionMeta = ctx.introspect.getActionDefinition('feature:action');
-const stats = ctx.introspect.getMetadata();
-```
-
-**Full API documentation:** [API.md](docs/api/API.md)
+---
 
 ## FAQ
 
@@ -695,32 +288,4 @@ Yes. The runtime is stable and tested. Start with non-critical features, then ex
 
 ---
 
-## Documentation
-
-- **[Migration Guide](docs/guides/migration-guide.md)** - Step-by-step migration strategies
-- **[API Reference](docs/api/API.md)** - Complete TypeScript API
-- **[Examples Guide](docs/guides/EXAMPLES_GUIDE.md)** - Learn through examples
-- **[Browser Extensions](docs/use-cases/BROWSER_TOOLS.md)** - Building browser tools
-- **[Project Overview](docs/PROJECT_OVERVIEW.md)** - Architecture deep dive
-
-## Get Started
-
-```bash
-npm install skeleton-crew-runtime
-```
-
-Then follow the [Quick Start](#quick-start-add-your-first-feature) above.
-
----
-
-## Contributing
-
-We welcome contributions! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
-
-## License
-
-MIT
-
----
-
 **Built for developers who need to modernize legacy apps without the risk of a full rewrite.**

package/dist/runtime-context.d.ts

@@ -1,4 +1,4 @@
-import type { RuntimeContext, ScreenDefinition, ActionDefinition, PluginDefinition } from './types.js';
+import type { RuntimeContext, ScreenDefinition, ActionDefinition, PluginDefinition, IntrospectionAPI } from './types.js';
 import type { ScreenRegistry } from './screen-registry.js';
 import type { ActionEngine } from './action-engine.js';
 import type { PluginRegistry } from './plugin-registry.js';
@@ -16,7 +16,8 @@ export declare class RuntimeContextImpl implements RuntimeContext {
     private pluginRegistry;
     private eventBus;
     private runtime;
-    private hostContext;
+    private frozenHostContext;
+    private introspectionAPI;
     constructor(screenRegistry: ScreenRegistry, actionEngine: ActionEngine, pluginRegistry: PluginRegistry, eventBus: EventBus, runtime: Runtime, hostContext: Record<string, unknown>);
     /**
      * Screens API - exposes Screen Registry operations
@@ -63,65 +64,23 @@ export declare class RuntimeContextImpl implements RuntimeContext {
      * 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.
+     * Returns a cached frozen shallow copy of the host context to prevent mutation.
      * This ensures plugins can access host services but cannot modify them.
+     * The frozen copy is cached to avoid memory leaks from repeated access.
      */
     get host(): Readonly<Record<string, unknown>>;
     /**
      * Introspection API - query runtime metadata
      * Requirements: 3.1, 4.1, 5.1, 6.1
+     *
+     * Returns a cached introspection API object to prevent memory leaks
+     * from repeated access.
      */
-    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;
-        }>;
-    };
+    get introspect(): IntrospectionAPI;
+    /**
+     * Creates the introspection API object.
+     * Called once during construction and cached.
+     */
+    private createIntrospectionAPI;
 }
 //# sourceMappingURL=runtime-context.d.ts.map

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

@@ -1 +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"}
+{"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,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACzH,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,iBAAiB,CAAoC;IAC7D,OAAO,CAAC,gBAAgB,CAAmB;gBAGzC,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;IAgBtC;;;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;;;;;;;OAOG;IACH,IAAI,IAAI,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAE5C;IAED;;;;;;OAMG;IACH,IAAI,UAAU,IAAI,gBAAgB,CAEjC;IAED;;;OAGG;IACH,OAAO,CAAC,sBAAsB;CAkG/B"}

package/dist/runtime-context.js

@@ -37,14 +37,20 @@ export class RuntimeContextImpl {
     pluginRegistry;
     eventBus;
     runtime;
-    hostContext;
+    frozenHostContext;
+    introspectionAPI;
     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;
+        // Cache the frozen copy to avoid creating new objects on every access
+        // This prevents memory leaks when host context is accessed repeatedly
+        this.frozenHostContext = Object.freeze({ ...hostContext });
+        // Cache the introspection API to avoid creating new objects on every access
+        // This prevents memory leaks when introspection is used repeatedly
+        this.introspectionAPI = this.createIntrospectionAPI();
     }
     /**
      * Screens API - exposes Screen Registry operations
@@ -125,17 +131,28 @@ export class RuntimeContextImpl {
      * 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.
+     * Returns a cached frozen shallow copy of the host context to prevent mutation.
      * This ensures plugins can access host services but cannot modify them.
+     * The frozen copy is cached to avoid memory leaks from repeated access.
      */
     get host() {
-        return Object.freeze({ ...this.hostContext });
+        return this.frozenHostContext;
     }
     /**
      * Introspection API - query runtime metadata
      * Requirements: 3.1, 4.1, 5.1, 6.1
+     *
+     * Returns a cached introspection API object to prevent memory leaks
+     * from repeated access.
      */
     get introspect() {
+        return this.introspectionAPI;
+    }
+    /**
+     * Creates the introspection API object.
+     * Called once during construction and cached.
+     */
+    createIntrospectionAPI() {
         return {
             /**
              * List all registered action IDs

package/dist/runtime-context.js.map

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

package/dist/runtime.d.ts.map

@@ -1 +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"}
+{"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;IAwC/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"}

package/dist/runtime.js

@@ -170,7 +170,9 @@ export class Runtime {
         this.actions.clear();
         this.events.clear();
         this.plugins.clear();
-        // 4. Set initialized flag to false (Requirement 4.5)
+        // 4. Clear context reference in ActionEngine to break circular reference
+        this.actions.setContext(null);
+        // 5. Set initialized flag to false (Requirement 4.5)
         this.initialized = false;
         // Set state to Shutdown (Requirement 16.4)
         this.state = RuntimeState.Shutdown;

package/dist/runtime.js.map

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

package/package.json

@@ -1,53 +1,70 @@
 {
   "name": "skeleton-crew-runtime",
-  "version": "0.1.1",
-  "description": "A minimal, plugin-based application runtime for building internal tools and modular applications",
+  "version": "0.1.2",
+  "description": "A minimal plugin runtime for building modular JavaScript applications.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [
     "dist/",
     "LICENSE",
-    "README.md",
-    "package.json"
-  ],
-  "exclude": [
-    "dist-example/"
+    "README.md"
   ],
   "scripts": {
-    "build": "rm -rf dist 2>&1 & tsc",
-    "build:examples": "tsc -p tsconfig.examples.json",
+    "build": "rimraf dist && tsc",
+    "build:examples": "rimraf dist-examples && tsc -p tsconfig.examples.json",
     "test": "vitest run",
     "test:watch": "vitest",
-    "example": "npm run build:examples && node dist-example/example/index.js",
-    "example:01": "npm run build:examples && node dist-example/example/01-plugin-system/index.js",
-    "example:02": "npm run build:examples && node dist-example/example/02-screen-registry/index.js",
-    "example:03": "npm run build:examples && node dist-example/example/03-action-engine/index.js",
-    "example:04": "npm run build:examples && node dist-example/example/04-event-bus/index.js",
-    "example:05": "npm run build:examples && node dist-example/example/05-runtime-context/index.js",
-    "tutorial:01": "npm run build:examples && node dist-example/example/tutorial/01-basic-task-plugin/index.js",
-    "tutorial:02": "npm run build:examples && node dist-example/example/tutorial/02-multiple-plugins/index.js",
-    "tutorial:03": "npm run build:examples && node dist-example/example/tutorial/03-event-communication/index.js",
-    "tutorial:04": "npm run build:examples && vite dist-example/example/tutorial/04-ui-provider-swap",
-    "tutorial:05": "npm run build:examples && node dist-example/example/tutorial/05-custom-plugin/index.js"
+    "prepublishOnly": "npm run build && npm test",
+    "examples": "npm run build:examples && node dist-example/examples/playground/index.js",
+    "example:01": "npm run build:examples && node dist-example/examples/basics/01-plugin-system/index.js",
+    "example:02": "npm run build:examples && node dist-example/examples/basics/02-screen-registry/index.js",
+    "example:03": "npm run build:examples && node dist-example/examples/basics/03-action-engine/index.js",
+    "example:04": "npm run build:examples && node dist-example/examples/basics/04-event-bus/index.js",
+    "example:05": "npm run build:examples && node dist-example/examples/basics/05-runtime-context/index.js",
+    "tutorial:01": "npm run build:examples && node dist-example/examples/tutorial/01-basic-task-plugin/index.js",
+    "tutorial:02": "npm run build:examples && node dist-example/examples/tutorial/02-multiple-plugins/index.js",
+    "tutorial:03": "npm run build:examples && node dist-example/examples/tutorial/03-event-communication/index.js",
+    "tutorial:04": "npm run build:examples && vite dist-example/examples/tutorial/04-ui-provider-swap",
+    "tutorial:05": "npm run build:examples && node dist-example/examples/tutorial/05-custom-plugin/index.js"
   },
   "keywords": [
     "runtime",
     "plugin",
+    "plugin-system",
     "framework",
     "internal-tools",
     "modular",
-    "ui-agnostic"
+    "ui-agnostic",
+    "event-driven",
+    "browser-extension",
+    "cli-tools",
+    "typescript"
   ],
-  "author": "skcrew",
-  "email": "skeleton-crew-runtime@gmail.com",
+  "author": {
+    "name": "skcrew",
+    "email": "skeletoncrewruntime@gmail.com"
+  },
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/skcrew/runtime.git"
+  },
+  "homepage": "https://github.com/skcrew/runtime#readme",
+  "bugs": {
+    "url": "https://github.com/skcrew/runtime/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "npm": ">=8.0.0"
+  },
   "devDependencies": {
     "@types/node": "^20.10.0",
-    "@vitest/coverage-v8": "^1.6.1",
+    "@vitest/coverage-v8": "^4.0.15",
     "fast-check": "^3.15.0",
+    "rimraf": "^6.1.2",
     "typescript": "^5.3.3",
-    "vitest": "^1.1.0"
+    "vitest": "^4.0.15"
   },
   "optionalDependencies": {
     "@types/react": "^18.2.0",
@@ -55,6 +72,6 @@
     "@vitejs/plugin-react": "^4.2.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "vite": "^5.0.0"
+    "vite": "^7.2.6"
   }
 }