feat: enhance README for Hono server plugin with usage examples and architecture details

Author: hotlong

packages/plugins/plugin-hono-server/README.md

@@ -4,16 +4,33 @@ HTTP Server adapter for ObjectStack using Hono.
 
 ## Features
 
+- **Standard Runtime**: Uses the unified `HttpDispatcher` and standard Hono adapter via `@objectstack/hono`.
 - **Fast**: Built on Hono, a high-performance web framework.
-- **Protocol Compliant**: Implements the `IHttpServer` interface required by `@objectstack/runtime`.
-- **Middleware**: Supports standard ObjectStack middleware.
+- **Full Protocol Support**: Automatically provides all ObjectStack Runtime endpoints (Auth, Data, Metadata, etc.).
+- **Middleware**: Supports standard Hono middleware.
 
 ## Usage
 
 ```typescript
-import { ObjectKernel } from '@objectstack/core';
+import { ObjectKernel } from '@objectstack/runtime';
 import { HonoServerPlugin } from '@objectstack/plugin-hono-server';
 
 const kernel = new ObjectKernel();
-kernel.use(new HonoServerPlugin({ port: 3000 }));
+
+// Register the server plugin
+kernel.use(new HonoServerPlugin({ 
+  port: 3000,
+  restConfig: {
+      api: {
+          apiPath: '/api/v1' // Customize API prefix
+      }
+  }
+}));
+
+await kernel.start();
 ```
+
+## Architecture
+
+This plugin wraps `@objectstack/hono` to provide a turnkey HTTP server solution for the Runtime. It binds the standard `HttpDispatcher` to a Hono application and starts listening on the configured port.
+

packages/plugins/plugin-msw/README.md

@@ -21,12 +21,17 @@ See [objectstack.config.ts](./objectstack.config.ts) for the complete capability
 
 ## Features
 
-- 🎯 **Automatic API Mocking**: Automatically generates MSW handlers for all ObjectStack API endpoints
-- 🔄 **Runtime Integration**: Seamlessly integrates with ObjectStack Runtime Protocol
-- 🧪 **Testing Ready**: Perfect for unit tests, integration tests, and development
-- 🌐 **Browser & Node Support**: Works in both browser and Node.js environments
-- 🎨 **Custom Handlers**: Easily add custom MSW handlers alongside standard ones
-- 📝 **TypeScript First**: Fully typed with TypeScript
+- 🎯 **Unified Dispatcher**: Uses `@objectstack/runtime`'s `HttpDispatcher` to ensure mocks behave exactly like the real server.
+- 🔄 **Full Protocol Support**: Mocks **all** Runtime endpoints:
+  - Auth (`/auth`)
+  - Metadata (`/metadata`)
+  - Data (`/data` - with filtering, batching, relations)
+  - Storage (`/storage`)
+  - Analytics (`/analytics`)
+  - Automation (`/automation`)
+- 🌐 **Universal Support**: Works in Browser (Service Worker) and Node.js (Interceptor).
+- 🎨 **Custom Handlers**: Easily inject custom MSW handlers that take precedence.
+- 📝 **TypeScript First**: Fully typed configuration.
 
 ## Installation
 
@@ -44,12 +49,21 @@ import { ObjectKernel } from '@objectstack/runtime';
 
 const kernel = new ObjectKernel();
 
+// The MSW Plugin will initialize the HttpDispatcher and intercept requests
 kernel.use(new MSWPlugin({
   enableBrowser: true,
   baseUrl: '/api/v1',
   logRequests: true
 }));
 
+await kernel.start();
+```
+
+### Architecture
+
+The plugin uses the `HttpDispatcher` from the Runtime to process requests intercepted by MSW. This means your mock server runs the **actual** ObjectStack business logic (permissions, validation, flow execution) in-memory, providing a high-fidelity simulation of the backend.
+}));
+
 await kernel.bootstrap();
 ```