fix: improve type safety in plugin interfaces per code review

- Use unknown[] instead of any for logger args in PluginContext
- Type kernel.use() parameter as AppMetadataPlugin | Record<string, unknown>
- Use PluginContext type in install() method and all example plugins
- Import PluginContext in CRMPlugin, TodoPlugin, KitchenSinkPlugin

Co-authored-by: hotlong <50353452+hotlong@users.noreply.github.com>

Author: Copilot

ROADMAP.md

@@ -1,6 +1,6 @@
 # ObjectUI Development Roadmap
 
-> **Last Updated:** March 2, 2026
+> **Last Updated:** March 4, 2026
 > **Current Version:** v0.5.x
 > **Spec Version:** @objectstack/spec v3.2.0
 > **Client Version:** @objectstack/client v3.2.0
@@ -1164,6 +1164,38 @@ The `FlowDesigner` is a canvas-based flow editor that bridges the gap between th
 - [ ] Conflict resolution on reconnection wired into Console flow
 - [ ] Optimistic updates with TransactionManager state application
 
+### P2.6 Plugin Modularization & Dynamic Management
+
+> **Status:** Phase 1 complete — Plugin class standard, install/uninstall API, example plugin classes.
+
+Plugin architecture refactoring to support true modular development, plugin isolation, and dynamic plugin install/uninstall at runtime.
+
+**Phase 1 — Plugin Class Standard & Example Plugins ✅**
+- [x] Define `AppMetadataPlugin` interface in `@object-ui/types` (name, version, type, description, init/start/stop/getConfig)
+- [x] Define `PluginContext` interface for lifecycle hook context (logger, kernel)
+- [x] Add `install(plugin)` / `uninstall(pluginName)` convenience methods to `PluginSystem` in `@object-ui/core`
+- [x] Create `CRMPlugin` with full lifecycle (init/start/stop/getConfig) — `examples/crm/plugin.ts`
+- [x] Create `TodoPlugin` — `examples/todo/plugin.ts`
+- [x] Create `KitchenSinkPlugin` — `examples/kitchen-sink/plugin.ts`
+- [x] Update `package.json` exports for all example apps (`./plugin` entry point)
+- [x] Refactor root `objectstack.config.ts` to use plugin-based config collection via `getConfig()`
+- [x] Unit tests for `install()` / `uninstall()` (5 new tests, 18 total in PluginSystem)
+
+**Phase 2 — Dynamic Plugin Loading (Planned)**
+- [ ] Hot-reload / lazy loading of plugins for development
+- [ ] Runtime plugin discovery and loading from registry
+- [ ] Plugin dependency graph visualization in Console
+
+**Phase 3 — Plugin Identity & Isolation (Planned)**
+- [ ] Preserve origin plugin metadata on objects, actions, dashboards for runtime inspection
+- [ ] Per-plugin i18n namespace support
+- [ ] Per-plugin permissions and data isolation
+
+**Phase 4 — Cross-Repo Plugin Ecosystem (Planned)**
+- [ ] Plugin marketplace / registry for third-party plugins
+- [ ] Plugin publish/validate tooling (spec v3.0.9 `PluginBuildOptions`, `PluginPublishOptions`)
+- [ ] Cross-repo plugin loading from npm packages
+
 ---
 
 ## 🔮 P3 — Future Vision (Deferred)

examples/crm/plugin.ts

@@ -18,6 +18,7 @@
  *   import { crmConfig } from '@object-ui/example-crm/plugin';
  */
 
+import type { PluginContext } from '@object-ui/types';
 import config from './objectstack.config';
 
 /** Raw CRM stack configuration for direct merging */
@@ -39,7 +40,7 @@ export class CRMPlugin {
     // No initialization needed
   }
 
-  async start(ctx: any) {
+  async start(ctx: PluginContext) {
     const logger = ctx.logger || console;
 
     try {

examples/kitchen-sink/plugin.ts

@@ -18,6 +18,7 @@
  *   import { kitchenSinkConfig } from '@object-ui/example-kitchen-sink/plugin';
  */
 
+import type { PluginContext } from '@object-ui/types';
 import config from './objectstack.config';
 
 /** Raw Kitchen Sink stack configuration for direct merging */
@@ -39,7 +40,7 @@ export class KitchenSinkPlugin {
     // No initialization needed
   }
 
-  async start(ctx: any) {
+  async start(ctx: PluginContext) {
     const logger = ctx.logger || console;
 
     try {

examples/todo/plugin.ts

@@ -18,6 +18,7 @@
  *   import { todoConfig } from '@object-ui/example-todo/plugin';
  */
 
+import type { PluginContext } from '@object-ui/types';
 import config from './objectstack.config';
 
 /** Raw Todo stack configuration for direct merging */
@@ -39,7 +40,7 @@ export class TodoPlugin {
     // No initialization needed
   }
 
-  async start(ctx: any) {
+  async start(ctx: PluginContext) {
     const logger = ctx.logger || console;
 
     try {

packages/core/src/registry/PluginSystem.ts

@@ -7,7 +7,7 @@
  */
 
 import type { Registry } from './Registry.js';
-import type { PluginScope, PluginScopeConfig, AppMetadataPlugin } from '@object-ui/types';
+import type { PluginScope, PluginScopeConfig, AppMetadataPlugin, PluginContext } from '@object-ui/types';
 import { PluginScopeImpl } from './PluginScopeImpl.js';
 
 export interface PluginDefinition {
@@ -169,7 +169,7 @@ export class PluginSystem {
    * @param registry - The component registry
    * @param ctx - Optional context passed to the plugin's start() hook
    */
-  async install(plugin: AppMetadataPlugin, registry: Registry, ctx?: Record<string, any>): Promise<void> {
+  async install(plugin: AppMetadataPlugin, registry: Registry, ctx?: PluginContext): Promise<void> {
     if (this.loaded.has(plugin.name)) {
       console.warn(`Plugin "${plugin.name}" is already installed. Skipping.`);
       return;

packages/types/src/plugin-scope.ts

@@ -189,10 +189,10 @@ export type PluginEventHandler = (data?: any) => void;
  */
 export interface PluginContext {
   /** Logger instance (falls back to console) */
-  logger?: { info: (...args: any[]) => void; warn: (...args: any[]) => void; error: (...args: any[]) => void };
+  logger?: { info: (...args: unknown[]) => void; warn: (...args: unknown[]) => void; error: (...args: unknown[]) => void };
   /** Kernel/runtime reference for plugin registration */
-  kernel?: { use?: (plugin: any) => Promise<void> | void };
-  [key: string]: any;
+  kernel?: { use?: (plugin: AppMetadataPlugin | Record<string, unknown>) => Promise<void> | void };
+  [key: string]: unknown;
 }
 
 /**