@objectstack/core 0.9.2 → 1.0.1

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @objectstack/core
 
+## 1.0.1
+
+### Patch Changes
+
+- @objectstack/spec@1.0.1
+
+## 1.0.0
+
+### Major Changes
+
+- Major version release for ObjectStack Protocol v1.0.
+  - Stabilized Protocol Definitions
+  - Enhanced Runtime Plugin Support
+  - Fixed Type Compliance across Monorepo
+
+### Patch Changes
+
+- Updated dependencies
+  - @objectstack/spec@1.0.0
+
 ## 0.9.2
 
 ### Patch Changes

package/README.md

@@ -1,377 +1,35 @@
 # @objectstack/core
 
-Microkernel Core for ObjectStack - A lightweight, plugin-based architecture with enterprise-grade features.
-
-## Overview
-
-This package defines the fundamental runtime mechanics of the ObjectStack architecture:
-1. **Dependency Injection (DI)**: Advanced service registry with factory functions and lifecycle management
-2. **Plugin Lifecycle**: `init` (Registration) -> `start` (Execution) -> `destroy` (Cleanup)
-3. **Event Bus**: Simple hook system (`hook`, `trigger`) for event-driven communication
-4. **Configurable Logging**: Universal logger using [Pino](https://github.com/pinojs/pino) for Node.js and simple console for browsers
-5. **Enhanced Features**: Version compatibility, health checks, timeout control, graceful shutdown, and more
-
-It is completely agnostic of "Data", "HTTP", or "Apps". It only knows `Plugin` and `Service`.
-
-## 🤖 AI Development Context
-
-**Role**: Microkernel / Runtime Orchestrator
-**Usage**:
-- Use `ObjectKernel` to bootstrap the application.
-- Implement `Plugin` interface to add functionality (not business logic directly).
-- Use `PluginLoader` features for dependency injection.
-
-**Architectural Interaction**:
-- `Kernel` loads `Plugins`.
-- `Plugins` register `Services`.
-- `Services` implement logic defined in `spec`.
+The **Kernel** of the ObjectStack architecture. It provides the fundamental building blocks for a modular, plugin-based system.
 
 ## Features
 
-### Core Features
-- **Plugin-based Architecture**: Modular microkernel that manages plugin lifecycle
-- **Service Registry**: Dependency injection for inter-plugin communication
-- **Event/Hook System**: Flexible event-driven communication
-- **High-Performance Logging**: 
-  - Node.js: Powered by [Pino](https://github.com/pinojs/pino) - extremely fast, low-overhead structured logging
-  - Browser: Lightweight console-based logger
-- **Environment Detection**: Automatic runtime detection (Node.js/browser)
-- **Dependency Resolution**: Automatic topological sorting of plugin dependencies
-- **Security**: Automatic sensitive data redaction in logs
-
-### Enhanced Features (EnhancedObjectKernel)
-- **Async Plugin Loading**: Load plugins asynchronously with validation
-- **Version Compatibility**: Semantic versioning support and validation
-- **Plugin Signatures**: Security verification (extensible)
-- **Configuration Validation**: Zod-based schema validation for plugin configs
-- **Service Factories**: Factory-based service instantiation with lifecycle control
-- **Service Lifecycles**: Singleton, Transient, and Scoped service management
-- **Circular Dependency Detection**: Automatic detection and reporting
-- **Lazy Loading**: Services created on-demand
-- **Timeout Control**: Configurable timeouts for plugin initialization
-- **Failure Rollback**: Automatic rollback on startup failures
-- **Health Checks**: Monitor plugin health at runtime
-- **Performance Metrics**: Track plugin startup times
-- **Graceful Shutdown**: Proper cleanup with timeout control
+- **ObjectKernel**: A robust Dependency Injection (DI) container and plugin manager.
+- **Plugin Architecture**: A standard interface (`Plugin`) with lifecycle hooks (`init`, `start`, `stop`).
+- **Service Management**: Register and resolve services with type safety.
+- **Logging**: Structured logging interface with swappable backends.
 
 ## Installation
 
 ```bash
-npm install @objectstack/core
-# or
 pnpm add @objectstack/core
 ```
 
-## Quick Start
-
-```typescript
-import { ObjectKernel, Plugin, PluginContext } from '@objectstack/core';
-
-// 1. Define a Plugin
-const myPlugin: Plugin = {
-    name: 'my-plugin',
-    
-    async init(ctx: PluginContext) {
-        ctx.logger.info('Initializing plugin');
-        ctx.registerService('my-service', { hello: 'world' });
-    }
-};
-
-// 2. Boot Kernel with logging config
-const kernel = new ObjectKernel({
-  logger: {
-    level: 'info',
-    format: 'pretty'
-  }
-});
-
-kernel.use(myPlugin);
-await kernel.bootstrap();
-
-// 3. Use Service
-const service = kernel.getService('my-service');
-
-// 4. Cleanup
-await kernel.shutdown();
-```
-
-## 🤖 AI Quick Reference
-
-**For AI Agents:** This package implements a microkernel architecture. Key concepts:
-
-1. **Plugin Lifecycle**: `init()` → `start()` → `destroy()`
-2. **Service Registry**: Share functionality via `ctx.registerService(name, service)` and `ctx.getService(name)`
-3. **Dependencies**: Declare plugin dependencies for automatic load ordering
-4. **Hooks/Events**: Decouple plugins with `ctx.hook(event, handler)` and `ctx.trigger(event, ...args)`
-5. **Logger**: Always use `ctx.logger` for consistent, structured logging
-
-**Common Plugin Pattern:**
-```typescript
-const plugin: Plugin = {
-  name: 'my-plugin',
-  dependencies: ['other-plugin'], // Load after these plugins
-  
-  async init(ctx: PluginContext) {
-    // Register services and hooks
-    const otherService = ctx.getService('other-service');
-    ctx.registerService('my-service', new MyService(otherService));
-    ctx.hook('data:created', async (data) => { /* ... */ });
-  },
-  
-  async start(ctx: PluginContext) {
-    // Execute business logic
-    const service = ctx.getService('my-service');
-    await service.initialize();
-  },
-  
-  async destroy() {
-    // Cleanup resources
-    await service.close();
-  }
-};
-```
-
-## Configurable Logger
-
-The logger uses **[Pino](https://github.com/pinojs/pino)** for Node.js environments (high-performance, low-overhead) and a simple console-based logger for browsers. It automatically detects the runtime environment.
-
-### Why Pino?
-
-- **Fast**: One of the fastest Node.js loggers available
-- **Low Overhead**: Minimal performance impact on your application
-- **Structured Logging**: Native JSON output for log aggregation tools
-- **Production Ready**: Battle-tested in production environments
-- **Feature Rich**: Automatic log rotation, transports, child loggers, and more
-
-### Logger Configuration
+## Basic Usage
 
 ```typescript
-const kernel = new ObjectKernel({
-  logger: {
-    level: 'debug',        // 'debug' | 'info' | 'warn' | 'error' | 'fatal'
-    format: 'pretty',      // 'json' | 'text' | 'pretty'
-    sourceLocation: true,  // Include file/line numbers
-    redact: ['password', 'token', 'apiKey'], // Keys to redact
-    file: './logs/app.log',     // Node.js only
-    rotation: {                 // File rotation (Node.js only)
-      maxSize: '10m',
-      maxFiles: 5
-    }
-  }
-});
-```
+import { ObjectKernel } from '@objectstack/core';
 
-### Using Logger in Plugins
+const kernel = new ObjectKernel();
 
-```typescript
-const myPlugin: Plugin = {
+// Register a simple plugin
+kernel.use({
   name: 'my-plugin',
-  
-  init: async (ctx: PluginContext) => {
-    // Basic logging
-    ctx.logger.info('Plugin initialized');
-    ctx.logger.debug('Debug info', { details: 'data' });
-    ctx.logger.warn('Warning message');
-    ctx.logger.error('Error occurred', new Error('Oops'));
-    
-    // Sensitive data is automatically redacted
-    ctx.logger.info('User login', {
-      username: 'john',
-      password: 'secret123'  // Logged as '***REDACTED***'
-    });
-  }
-};
-```
-
-### Standalone Logger
-
-```typescript
-import { createLogger } from '@objectstack/core';
-
-const logger = createLogger({
-  level: 'info',
-  format: 'json'
-});
-
-logger.info('Application started');
-
-// Child logger with context
-const requestLogger = logger.child({
-  requestId: '123',
-  userId: 'user-456'
-});
-
-requestLogger.info('Processing request');
-
-// Distributed tracing
-const tracedLogger = logger.withTrace('trace-id-123', 'span-id-456');
-
-// Cleanup
-await logger.destroy();
-```
-
-## Log Formats
-
-### JSON (default for Node.js)
-```json
-{"timestamp":"2026-01-29T22:47:36.441Z","level":"info","message":"User action","context":{"userId":"123"}}
-```
-
-### Text
-```
-2026-01-29T22:47:36.441Z | INFO | User action | {"userId":"123"}
-```
-
-### Pretty (default for browser)
-```
-[INFO] User action { userId: '123' }
-```
-
-## Plugin Development
-
-```typescript
-import { Plugin, PluginContext } from '@objectstack/core';
-
-const databasePlugin: Plugin = {
-  name: 'database',
   version: '1.0.0',
-  
-  init: async (ctx: PluginContext) => {
-    const db = await connectToDatabase();
-    ctx.registerService('db', db);
-    ctx.logger.info('Database connected');
-  },
-  
-  start: async (ctx: PluginContext) => {
-    ctx.logger.info('Database ready');
-  },
-  
-  destroy: async () => {
-    await db.close();
-  }
-};
-
-const apiPlugin: Plugin = {
-  name: 'api',
-  dependencies: ['database'],  // Load after database
-  
-  init: async (ctx: PluginContext) => {
-    const db = ctx.getService('db');
-    const server = createServer(db);
-    ctx.registerService('api', server);
-  }
-};
-
-kernel.use(databasePlugin);
-kernel.use(apiPlugin);
-await kernel.bootstrap();
-```
-
-## Advanced Kernel Usage
-
-For production applications, use `ObjectKernel` (formerly `EnhancedObjectKernel`) for advanced features:
-
-```typescript
-import { ObjectKernel, PluginMetadata, ServiceLifecycle } from '@objectstack/core';
-
-// Create kernel with advanced configuration
-const kernel = new ObjectKernel({
-  logger: { level: 'info', format: 'pretty' },
-  defaultStartupTimeout: 30000,   // 30 seconds
-  gracefulShutdown: true,
-  shutdownTimeout: 60000,         // 60 seconds
-  rollbackOnFailure: true,        // Rollback on failures
-});
-
-// Plugin with version and health check
-const plugin: PluginMetadata = {
-  name: 'my-plugin',
-  version: '1.2.3',
-  startupTimeout: 10000,
-  
   async init(ctx) {
-    ctx.registerService('my-service', serviceInstance);
-  },
-  
-  async healthCheck() {
-    return {
-      healthy: true,
-      message: 'Service is operational'
-    };
+    ctx.logger.info('Plugin initializing...');
   }
-};
-
-// Register service factory with lifecycle
-kernel.registerServiceFactory(
-  'database',
-  async (ctx) => await connectToDatabase(),
-  ServiceLifecycle.SINGLETON
-);
+});
 
-await kernel.use(plugin);
 await kernel.bootstrap();
-
-// Check health
-const health = await kernel.checkPluginHealth('my-plugin');
-console.log(health);
-
-// Get metrics
-const metrics = kernel.getPluginMetrics();
-console.log(metrics);
-
-// Graceful shutdown
-await kernel.shutdown();
 ```
-
-See [ENHANCED_FEATURES.md](./ENHANCED_FEATURES.md) for comprehensive documentation.
-See [examples/enhanced-kernel-example.ts](./examples/enhanced-kernel-example.ts) for a complete example.
-
-## Environment Support
-
-### Node.js Features (via Pino)
-- High-performance structured logging
-- Automatic file logging with rotation
-- JSON format for log aggregation tools (Elasticsearch, Splunk, etc.)
-- Pretty printing for development (via pino-pretty)
-- Child loggers with inherited context
-- Minimal performance overhead
-
-### Browser Features  
-- Pretty console output with colors
-- DevTools integration
-- Lightweight implementation
-- No external dependencies
-
-## Security
-
-Automatic sensitive data redaction:
-- Default keys: `password`, `token`, `secret`, `key`
-- Configurable via `redact` option
-- Recursive through nested objects
-
-## API Reference
-
-### LiteKernel (Minimal)
-- `LiteKernel` - Lightweight microkernel for serverless/test
-- `createLogger(config)` - Create standalone logger
-- `Plugin` - Plugin interface
-- `PluginContext` - Runtime context for plugins
-- `Logger` - Logger interface
-
-### ObjectKernel (Production)
-- `ObjectKernel` - Full-featured enterprise microkernel
-- `PluginLoader` - Plugin loading and validation
-- `ServiceLifecycle` - Service lifecycle management (SINGLETON, TRANSIENT, SCOPED)
-- `PluginMetadata` - Extended plugin interface with metadata
-- `PluginHealthStatus` - Health check result interface
-
-See [TypeScript definitions](./src/types.ts) for complete API.
-
-## Documentation
-
-- [ADVANCED_FEATURES.md](./ADVANCED_FEATURES.md) - Comprehensive guide to kernel features
-- [examples/kernel-features-example.ts](./examples/kernel-features-example.ts) - Complete working example
-
-## License
-
-Apache-2.0

package/dist/api-registry-plugin.test.js

@@ -5,7 +5,9 @@ import { ApiRegistry } from './api-registry';
 describe('API Registry Plugin', () => {
     let kernel;
     beforeEach(() => {
-        kernel = new ObjectKernel();
+        kernel = new ObjectKernel({
+            skipSystemValidation: true
+        });
     });
     describe('Plugin Registration', () => {
         it('should register API Registry as a service', async () => {

package/dist/api-registry.test.js

@@ -580,8 +580,8 @@ describe('ApiRegistry', () => {
                 endpoints: [],
             });
             const snapshot = registry.getRegistry();
-            expect(snapshot.byType?.rest.length).toBe(2);
-            expect(snapshot.byType?.graphql.length).toBe(1);
+            expect(snapshot.byType?.rest?.length).toBe(2);
+            expect(snapshot.byType?.graphql?.length).toBe(1);
         });
     });
     describe('clear', () => {

package/dist/dependency-resolver.d.ts

@@ -1,4 +1,4 @@
-import type { SemanticVersion, VersionConstraint, CompatibilityLevel, DependencyConflict } from '@objectstack/spec/system';
+import type { SemanticVersion, VersionConstraint, CompatibilityLevel, DependencyConflict } from '@objectstack/spec/kernel';
 import type { ObjectLogger } from './logger.js';
 /**
  * Semantic Version Parser and Comparator

package/dist/health-monitor.d.ts

@@ -1,4 +1,4 @@
-import type { PluginHealthStatus, PluginHealthCheck, PluginHealthReport } from '@objectstack/spec/system';
+import type { PluginHealthStatus, PluginHealthCheck, PluginHealthReport } from '@objectstack/spec/kernel';
 import type { ObjectLogger } from './logger.js';
 import type { Plugin } from './types.js';
 /**

package/dist/hot-reload.d.ts

@@ -1,4 +1,4 @@
-import type { HotReloadConfig } from '@objectstack/spec/system';
+import type { HotReloadConfig } from '@objectstack/spec/kernel';
 import type { ObjectLogger } from './logger.js';
 import type { Plugin } from './types.js';
 /**

package/dist/kernel.d.ts

@@ -14,6 +14,8 @@ export interface ObjectKernelConfig {
     shutdownTimeout?: number;
     /** Whether to rollback on startup failure */
     rollbackOnFailure?: boolean;
+    /** Whether to skip strict system requirement validation (Critical for testing) */
+    skipSystemValidation?: boolean;
 }
 /**
  * Enhanced ObjectKernel with Advanced Plugin Management
@@ -49,10 +51,18 @@ export declare class ObjectKernel {
      * Register a plugin with enhanced validation
      */
     use(plugin: Plugin): Promise<this>;
+    /**
+     * Register a service instance directly
+     */
+    registerService<T>(name: string, service: T): this;
     /**
      * Register a service factory with lifecycle management
      */
     registerServiceFactory<T>(name: string, factory: ServiceFactory<T>, lifecycle?: ServiceLifecycle, dependencies?: string[]): this;
+    /**
+     * Validate Critical System Requirements
+     */
+    private validateSystemRequirements;
     /**
      * Bootstrap the kernel with enhanced features
      */

package/dist/kernel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAgC,gBAAgB,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAC;AAEzH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/B,qDAAqD;IACrD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,KAAK,CAA2E;IACxF,OAAO,CAAC,KAAK,CAAwE;IACrF,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,gBAAgB,CAAkC;gBAE9C,MAAM,GAAE,kBAAuB;IAyF3C;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBxC;;OAEG;IACH,sBAAsB,CAAC,CAAC,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,SAAS,GAAE,gBAA6C,EACxD,YAAY,CAAC,EAAE,MAAM,EAAE,GACxB,IAAI;IAUP;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAqDhC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC/B;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAIzD;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAWxD;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIvC;;OAEG;IACH,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAI9B;;OAEG;IACG,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpE;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,MAAM;YAMJ,qBAAqB;YAerB,sBAAsB;YA6CtB,sBAAsB;YAkBtB,eAAe;IA2B7B,OAAO,CAAC,mBAAmB;IAyC3B,OAAO,CAAC,uBAAuB;IA2B/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAGjD"}
+{"version":3,"file":"kernel.d.ts","sourceRoot":"","sources":["../src/kernel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,YAAY,CAAC;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAgC,gBAAgB,EAAE,cAAc,EAAuB,MAAM,oBAAoB,CAAC;AAEzH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/B,qDAAqD;IACrD,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,6CAA6C;IAC7C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAE5B,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,OAAO,CAA0C;IACzD,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,KAAK,CAA2E;IACxF,OAAO,CAAC,KAAK,CAAwE;IACrF,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,cAAc,CAA0B;IAChD,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,gBAAgB,CAAkC;gBAE9C,MAAM,GAAE,kBAAuB;IAoF3C;;OAEG;IACG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBxC;;OAEG;IACH,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI;IAUlD;;OAEG;IACH,sBAAsB,CAAC,CAAC,EACpB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,SAAS,GAAE,gBAA6C,EACxD,YAAY,CAAC,EAAE,MAAM,EAAE,GACxB,IAAI;IAUP;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAwClC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAsDhC;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAqC/B;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAIzD;;OAEG;IACG,qBAAqB,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAWxD;;OAEG;IACH,gBAAgB,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAIvC;;OAEG;IACH,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC;IAI9B;;OAEG;IACG,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIpE;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,QAAQ,IAAI,MAAM;YAMJ,qBAAqB;YAerB,sBAAsB;YA6CtB,sBAAsB;YAkBtB,eAAe;IA2B7B,OAAO,CAAC,mBAAmB;IAyC3B,OAAO,CAAC,uBAAuB;IA2B/B;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CAGjD"}

package/dist/kernel.js

@@ -1,4 +1,5 @@
 import { createLogger } from './logger.js';
+import { ServiceRequirementDef } from '@objectstack/spec/system';
 import { PluginLoader, ServiceLifecycle } from './plugin-loader.js';
 /**
  * Enhanced ObjectKernel with Advanced Plugin Management
@@ -38,12 +39,7 @@ export class ObjectKernel {
         // Initialize context
         this.context = {
             registerService: (name, service) => {
-                if (this.services.has(name)) {
-                    throw new Error(`[Kernel] Service '${name}' already registered`);
-                }
-                this.services.set(name, service);
-                this.pluginLoader.registerService(name, service);
-                this.logger.info(`Service '${name}' registered`, { service: name });
+                this.registerService(name, service);
             },
             getService: (name) => {
                 // 1. Try direct service map first (synchronous cache)
@@ -125,6 +121,18 @@ export class ObjectKernel {
         });
         return this;
     }
+    /**
+     * Register a service instance directly
+     */
+    registerService(name, service) {
+        if (this.services.has(name)) {
+            throw new Error(`[Kernel] Service '${name}' already registered`);
+        }
+        this.services.set(name, service);
+        this.pluginLoader.registerService(name, service);
+        this.logger.info(`Service '${name}' registered`, { service: name });
+        return this;
+    }
     /**
      * Register a service factory with lifecycle management
      */
@@ -137,6 +145,44 @@ export class ObjectKernel {
         });
         return this;
     }
+    /**
+     * Validate Critical System Requirements
+     */
+    validateSystemRequirements() {
+        if (this.config.skipSystemValidation) {
+            this.logger.debug('System requirement validation skipped');
+            return;
+        }
+        this.logger.debug('Validating system service requirements...');
+        const missingServices = [];
+        const missingCoreServices = [];
+        // Iterate through all defined requirements
+        for (const [serviceName, criticality] of Object.entries(ServiceRequirementDef)) {
+            const hasService = this.services.has(serviceName) || this.pluginLoader.hasService(serviceName);
+            if (!hasService) {
+                if (criticality === 'required') {
+                    this.logger.error(`CRITICAL: Required service missing: ${serviceName}`);
+                    missingServices.push(serviceName);
+                }
+                else if (criticality === 'core') {
+                    this.logger.warn(`CORE: Core service missing, functionality may be degraded: ${serviceName}`);
+                    missingCoreServices.push(serviceName);
+                }
+                else {
+                    this.logger.info(`Info: Optional service not present: ${serviceName}`);
+                }
+            }
+        }
+        if (missingServices.length > 0) {
+            const errorMsg = `System failed to start. Missing critical services: ${missingServices.join(', ')}`;
+            this.logger.error(errorMsg);
+            throw new Error(errorMsg);
+        }
+        if (missingCoreServices.length > 0) {
+            this.logger.warn(`System started with degraded capabilities. Missing core services: ${missingCoreServices.join(', ')}`);
+        }
+        this.logger.info('System requirement check passed');
+    }
     /**
      * Bootstrap the kernel with enhanced features
      */
@@ -174,6 +220,7 @@ export class ObjectKernel {
                 }
             }
             // Phase 3: Trigger kernel:ready hook
+            this.validateSystemRequirements(); // Final check before ready
             this.logger.debug('Triggering kernel:ready hook');
             await this.context.trigger('kernel:ready');
             this.logger.info('✅ Bootstrap complete');

package/dist/kernel.test.js

@@ -7,6 +7,7 @@ describe('ObjectKernel', () => {
         kernel = new ObjectKernel({
             logger: { level: 'error' }, // Suppress logs in tests
             gracefulShutdown: false, // Disable for tests
+            skipSystemValidation: true,
         });
     });
     describe('Plugin Registration and Loading', () => {
@@ -166,6 +167,7 @@ describe('ObjectKernel', () => {
                 logger: { level: 'error' },
                 rollbackOnFailure: false,
                 gracefulShutdown: false,
+                skipSystemValidation: true,
             });
             let plugin1Destroyed = false;
             const plugin1 = {

package/dist/plugin-loader.d.ts

@@ -128,6 +128,10 @@ export declare class PluginLoader {
      * Register a static service instance (legacy support)
      */
     registerService(name: string, service: any): void;
+    /**
+     * Check if a service is registered (either as instance or factory)
+     */
+    hasService(name: string): boolean;
     /**
      * Detect circular dependencies in service factories
      * Note: This only detects cycles in service dependencies, not plugin dependencies.

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

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

package/dist/plugin-loader.js

@@ -127,6 +127,12 @@ export class PluginLoader {
         }
         this.serviceInstances.set(name, service);
     }
+    /**
+     * Check if a service is registered (either as instance or factory)
+     */
+    hasService(name) {
+        return this.serviceInstances.has(name) || this.serviceFactories.has(name);
+    }
     /**
      * Detect circular dependencies in service factories
      * Note: This only detects cycles in service dependencies, not plugin dependencies.

package/dist/security/permission-manager.d.ts

@@ -1,4 +1,4 @@
-import type { Permission, PermissionSet, PermissionAction, ResourceType } from '@objectstack/spec/system';
+import type { Permission, PermissionSet, PermissionAction, ResourceType } from '@objectstack/spec/kernel';
 import type { ObjectLogger } from '../logger.js';
 /**
  * Permission Grant

package/dist/security/plugin-permission-enforcer.d.ts

@@ -1,5 +1,5 @@
 import type { Logger } from '@objectstack/spec/contracts';
-import type { PluginCapability } from '@objectstack/spec/system';
+import type { PluginCapability } from '@objectstack/spec/kernel';
 import type { PluginContext } from '../types.js';
 /**
  * Plugin Permissions

package/dist/security/sandbox-runtime.d.ts

@@ -1,4 +1,4 @@
-import type { SandboxConfig } from '@objectstack/spec/system';
+import type { SandboxConfig } from '@objectstack/spec/kernel';
 import type { ObjectLogger } from '../logger.js';
 /**
  * Resource Usage Statistics

package/dist/security/security-scanner.d.ts

@@ -1,4 +1,4 @@
-import type { SecurityVulnerability, SecurityScanResult } from '@objectstack/spec/system';
+import type { SecurityVulnerability, SecurityScanResult } from '@objectstack/spec/kernel';
 import type { ObjectLogger } from '../logger.js';
 /**
  * Scan Target

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@objectstack/core",
-  "version": "0.9.2",
+  "version": "1.0.1",
+  "license": "Apache-2.0",
   "description": "Microkernel Core for ObjectStack",
   "type": "module",
   "main": "dist/index.js",
@@ -14,7 +15,7 @@
     "pino": "^8.17.0",
     "pino-pretty": "^10.3.0",
     "zod": "^4.3.6",
-    "@objectstack/spec": "0.9.2"
+    "@objectstack/spec": "1.0.1"
   },
   "peerDependencies": {
     "pino": "^8.0.0"

package/src/api-registry-plugin.test.ts

@@ -9,7 +9,9 @@ describe('API Registry Plugin', () => {
   let kernel: ObjectKernel;
 
   beforeEach(() => {
-    kernel = new ObjectKernel();
+    kernel = new ObjectKernel({
+        skipSystemValidation: true
+    });
   });
 
   describe('Plugin Registration', () => {

package/src/api-registry.test.ts

@@ -657,8 +657,8 @@ describe('ApiRegistry', () => {
       });
 
       const snapshot = registry.getRegistry();
-      expect(snapshot.byType?.rest.length).toBe(2);
-      expect(snapshot.byType?.graphql.length).toBe(1);
+      expect(snapshot.byType?.rest?.length).toBe(2);
+      expect(snapshot.byType?.graphql?.length).toBe(1);
     });
   });
 

package/src/dependency-resolver.ts

@@ -3,7 +3,7 @@ import type {
   VersionConstraint,
   CompatibilityLevel,
   DependencyConflict
-} from '@objectstack/spec/system';
+} from '@objectstack/spec/kernel';
 import type { ObjectLogger } from './logger.js';
 
 /**

package/src/health-monitor.test.ts

@@ -1,7 +1,7 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { PluginHealthMonitor } from './health-monitor.js';
 import { createLogger } from './logger.js';
-import type { PluginHealthCheck } from '@objectstack/spec/system';
+import type { PluginHealthCheck } from '@objectstack/spec/kernel';
 
 describe('PluginHealthMonitor', () => {
   let monitor: PluginHealthMonitor;

package/src/health-monitor.ts

@@ -2,7 +2,7 @@ import type {
   PluginHealthStatus, 
   PluginHealthCheck, 
   PluginHealthReport 
-} from '@objectstack/spec/system';
+} from '@objectstack/spec/kernel';
 import type { ObjectLogger } from './logger.js';
 import type { Plugin } from './types.js';
 

package/src/hot-reload.ts

@@ -1,7 +1,7 @@
 import type { 
   HotReloadConfig, 
   PluginStateSnapshot 
-} from '@objectstack/spec/system';
+} from '@objectstack/spec/kernel';
 import type { ObjectLogger } from './logger.js';
 import type { Plugin } from './types.js';
 

package/src/kernel.test.ts

@@ -10,6 +10,7 @@ describe('ObjectKernel', () => {
         kernel = new ObjectKernel({
             logger: { level: 'error' }, // Suppress logs in tests
             gracefulShutdown: false, // Disable for tests
+            skipSystemValidation: true,
         });
     });
 
@@ -226,6 +227,7 @@ describe('ObjectKernel', () => {
                 logger: { level: 'error' },
                 rollbackOnFailure: false,
                 gracefulShutdown: false,
+                skipSystemValidation: true,
             });
 
             let plugin1Destroyed = false;

package/src/kernel.ts

@@ -1,6 +1,7 @@
 import { Plugin, PluginContext } from './types.js';
 import { createLogger, ObjectLogger } from './logger.js';
 import type { LoggerConfig } from '@objectstack/spec/system';
+import { ServiceRequirementDef } from '@objectstack/spec/system';
 import { PluginLoader, PluginMetadata, ServiceLifecycle, ServiceFactory, PluginStartupResult } from './plugin-loader.js';
 
 /**
@@ -20,6 +21,9 @@ export interface ObjectKernelConfig {
     
     /** Whether to rollback on startup failure */
     rollbackOnFailure?: boolean;
+    
+    /** Whether to skip strict system requirement validation (Critical for testing) */
+    skipSystemValidation?: boolean;
 }
 
 /**
@@ -67,12 +71,7 @@ export class ObjectKernel {
         // Initialize context
         this.context = {
             registerService: (name, service) => {
-                if (this.services.has(name)) {
-                    throw new Error(`[Kernel] Service '${name}' already registered`);
-                }
-                this.services.set(name, service);
-                this.pluginLoader.registerService(name, service);
-                this.logger.info(`Service '${name}' registered`, { service: name });
+                this.registerService(name, service);
             },
             getService: <T>(name: string) => {
                 // 1. Try direct service map first (synchronous cache)
@@ -167,6 +166,19 @@ export class ObjectKernel {
         return this;
     }
 
+    /**
+     * Register a service instance directly
+     */
+    registerService<T>(name: string, service: T): this {
+        if (this.services.has(name)) {
+            throw new Error(`[Kernel] Service '${name}' already registered`);
+        }
+        this.services.set(name, service);
+        this.pluginLoader.registerService(name, service);
+        this.logger.info(`Service '${name}' registered`, { service: name });
+        return this;
+    }
+
     /**
      * Register a service factory with lifecycle management
      */
@@ -185,6 +197,49 @@ export class ObjectKernel {
         return this;
     }
 
+    /**
+     * Validate Critical System Requirements
+     */
+    private validateSystemRequirements() {
+        if (this.config.skipSystemValidation) {
+            this.logger.debug('System requirement validation skipped');
+            return;
+        }
+
+        this.logger.debug('Validating system service requirements...');
+        const missingServices: string[] = [];
+        const missingCoreServices: string[] = [];
+        
+        // Iterate through all defined requirements
+        for (const [serviceName, criticality] of Object.entries(ServiceRequirementDef)) {
+            const hasService = this.services.has(serviceName) || this.pluginLoader.hasService(serviceName);
+            
+            if (!hasService) {
+                if (criticality === 'required') {
+                    this.logger.error(`CRITICAL: Required service missing: ${serviceName}`);
+                    missingServices.push(serviceName);
+                } else if (criticality === 'core') {
+                    this.logger.warn(`CORE: Core service missing, functionality may be degraded: ${serviceName}`);
+                    missingCoreServices.push(serviceName);
+                } else {
+                    this.logger.info(`Info: Optional service not present: ${serviceName}`);
+                }
+            }
+        }
+
+        if (missingServices.length > 0) {
+            const errorMsg = `System failed to start. Missing critical services: ${missingServices.join(', ')}`;
+            this.logger.error(errorMsg);
+            throw new Error(errorMsg);
+        }
+
+        if (missingCoreServices.length > 0) {
+            this.logger.warn(`System started with degraded capabilities. Missing core services: ${missingCoreServices.join(', ')}`);
+        }
+        
+        this.logger.info('System requirement check passed');
+    }
+
     /**
      * Bootstrap the kernel with enhanced features
      */
@@ -231,6 +286,7 @@ export class ObjectKernel {
             }
 
             // Phase 3: Trigger kernel:ready hook
+            this.validateSystemRequirements(); // Final check before ready
             this.logger.debug('Triggering kernel:ready hook');
             await this.context.trigger('kernel:ready');
 

package/src/plugin-loader.ts

@@ -246,6 +246,13 @@ export class PluginLoader {
         this.serviceInstances.set(name, service);
     }
 
+    /**
+     * Check if a service is registered (either as instance or factory)
+     */
+    hasService(name: string): boolean {
+        return this.serviceInstances.has(name) || this.serviceFactories.has(name);
+    }
+
     /**
      * Detect circular dependencies in service factories
      * Note: This only detects cycles in service dependencies, not plugin dependencies.

package/src/security/permission-manager.test.ts

@@ -1,7 +1,7 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { PluginPermissionManager } from './permission-manager.js';
 import { createLogger } from '../logger.js';
-import type { PermissionSet } from '@objectstack/spec/system';
+import type { PermissionSet } from '@objectstack/spec/kernel';
 
 describe('PluginPermissionManager', () => {
   let manager: PluginPermissionManager;

package/src/security/permission-manager.ts

@@ -3,7 +3,7 @@ import type {
   PermissionSet,
   PermissionAction,
   ResourceType
-} from '@objectstack/spec/system';
+} from '@objectstack/spec/kernel';
 import type { ObjectLogger } from '../logger.js';
 
 /**

package/src/security/plugin-permission-enforcer.test.ts

@@ -1,7 +1,7 @@
 import { describe, it, expect, beforeEach } from 'vitest';
 import { PluginPermissionEnforcer, SecurePluginContext } from './plugin-permission-enforcer.js';
 import { createLogger } from '../logger.js';
-import type { PluginCapability } from '@objectstack/spec/system';
+import type { PluginCapability } from '@objectstack/spec/kernel';
 import type { PluginContext } from '../types.js';
 
 describe('PluginPermissionEnforcer', () => {

package/src/security/plugin-permission-enforcer.ts

@@ -1,5 +1,5 @@
 import type { Logger } from '@objectstack/spec/contracts';
-import type { PluginCapability } from '@objectstack/spec/system';
+import type { PluginCapability } from '@objectstack/spec/kernel';
 import type { PluginContext } from '../types.js';
 
 /**

package/src/security/sandbox-runtime.ts

@@ -1,6 +1,6 @@
 import type { 
   SandboxConfig
-} from '@objectstack/spec/system';
+} from '@objectstack/spec/kernel';
 import type { ObjectLogger } from '../logger.js';
 
 /**

package/src/security/security-scanner.ts

@@ -1,7 +1,7 @@
 import type { 
   SecurityVulnerability,
   SecurityScanResult
-} from '@objectstack/spec/system';
+} from '@objectstack/spec/kernel';
 import type { ObjectLogger } from '../logger.js';
 
 /**