@ultrst-armada/krnl 1.0.0 → 1.0.1

package/README.md

@@ -1,6 +1,18 @@
 # Krnl Framework
 
-> **Krnl**: High-Performance Full-Stack TypeScript Framework with Direct-DOM VanJS Reactivity, ts-morph AST Purity Gates, Autonomous Code Evolution, and the **Krnl Studio Visual Node IDE**.
+> **Krnl**: Backend Service Framework for Skipo — a modular TypeScript framework for authoring, composing, executing, and validating backend services, facades, protocols, and workflows.
+
+---
+
+## 🚀 Overview
+
+In the **Skipo** ecosystem, services are the foundational backend modules. **Krnl** provides the kernel architecture, lifecycle hooks, transport gateways, protocol decoders, and validation engine for building robust, decoupled backend services.
+
+- **Modular Service Architecture**: Define pure, stateful, and protocol-enabled backend service facades.
+- **Workflow & Flow Execution**: Compose multi-service pipelines and background execution boundaries.
+- **AST Purity & Validation**: Enforce 4-layer function purity, contract standards, and architecture rules via `ts-morph`.
+- **Protocol & Network Ingress**: Support REST, WebSocket, RPC, and MCP protocol bindings out of the box.
+- **Universal Backend Readiness**: Run seamlessly across Local FS, Local-Hosted, and Serverless environments.
 
 ---
 
@@ -11,44 +23,45 @@ Run the official interactive project generator:
 
 ```bash
 # Using npm
-npm create krnl my-app
+npm create krnl my-service-app
 
 # Using npx
-npx create-krnl my-app
+npx create-krnl my-service-app
 
 # Using pnpm
-pnpm dlx create-krnl my-app
+pnpm dlx create-krnl my-service-app
 ```
 
-This generates a fully configured Krnl workspace:
+This generates a fully configured Krnl backend workspace:
 - `krnl.json` (Workspace manifest & provider bindings)
 - `package.json` & `tsconfig.json`
-- `src/entities/App/` (Root entity with magnetic auto-discovery)
-- `src/entities/App/functionalities/Hello/` (Sample Quad-Unit functionality)
-- `src/libraries/AppConcepts.ts` (Layer 0 pure concept library)
+- `src/services/` (Backend service definitions & facades)
+- `src/libraries/` (Layer 0 pure concept libraries)
 - `docs/HISTORY.md` (Project intent & architectural memory)
 
 ---
 
-### 2. Launch Krnl Studio (Visual Node IDE)
+### 2. Run and Validate Services
 
 ```bash
-cd my-app
+cd my-service-app
+
+# Start Krnl service dev server
 krnl dev
-```
-Open **`http://localhost:8080`** in your browser (Brave, Chrome, Safari).
 
-Krnl Studio provides three visual canvases switchable via the bottom dock:
-- **🏗️ Architecture Canvas**: Node graph for visually adding Entities, Quad-Unit Functionalities, and Concept Libraries (surgically writing `.ts` code to disk).
-- **🎨 UI Composer Canvas**: Drag-and-drop palette of KrnlUI atoms (`KrnlButton`, `KrnlTextInput`, `KrnlDropdown`, `KrnlTile`, `KrnlDock`) with real-time **Monaco TypeScript** code generation.
-- **🧪 Live Test Console**: Sandboxed per-function execution in isolated worker threads with **Monaco JSON Editor** inputs and latency benchmarking.
+# Run deep AST 4-layer service purity validation
+krnl validate
+
+# Build production bundle
+krnl build
+```
 
 ---
 
 ### 3. CLI Commands Reference
 
 ```bash
-# Start Visual Node IDE and dev server
+# Start Krnl service dev server & boot service entrypoint
 krnl dev
 
 # Run deep AST 4-layer function purity audit
@@ -71,13 +84,11 @@ krnl generate subapp OrderEngine
 
 ## 🏛️ Monorepo Framework Packages
 
-- **[`@dinilmusick/krnl-core`](packages/core)**: Entity hierarchy, Flow builder, MagneticLoader, Universal Backend suite.
-- **[`@dinilmusick/krnl-ui`](packages/ui)**: Direct-DOM VanJS reactive atoms with Neo-Brutalist 2.5D theme and Monaco editor.
-- **[`@dinilmusick/krnl-validate`](packages/validate)**: `ts-morph` AST engine enforcing 4-layer function purity and 200-line limits.
-- **[`@dinilmusick/eslint-plugin-krnl`](packages/eslint-plugin)**: 6 ESLint rules with auto-fixers for Krnl paradigms.
-- **[`@dinilmusick/krnl-studio`](packages/studio)**: Visual Node IDE, UI Composer, and Live Test Console.
-- **[`@dinilmusick/krnl-cli`](packages/cli)**: Unified `krnl` binary.
-- **[`create-krnl`](packages/create-krnl)**: Interactive project scaffolder.
+- **[`@ultrst-armada/krnl`](packages/core)**: Core runtime engine, Service facades, Protocols, Transports, Registry, Lifecycle, and Execution flows.
+- **[`@dinilmusick/krnl-validate`](packages/validate)**: `ts-morph` AST engine enforcing 4-layer function purity, backend contracts, and line limits.
+- **[`@dinilmusick/eslint-plugin-krnl`](packages/eslint-plugin)**: ESLint rules with auto-fixers for Krnl backend service standards.
+- **[`@dinilmusick/krnl-cli`](packages/cli)**: Unified `krnl` binary for running, building, and validating backend services.
+- **[`create-krnl`](packages/create-krnl)**: Interactive project scaffolder for Krnl backend service modules.
 
 ---
 

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@ultrst-armada/krnl",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "private": false,
-  "description": "Krnl: Full-Stack Multiplatform Framework with Direct-DOM Reactivity, AST Purity Gates, Code Evolution, and Visual Node IDE",
+  "description": "Krnl: Backend Service Framework for Skipo — authoring, executing, and validating modular backend services, facades, and workflows",
   "type": "module",
   "main": "./packages/core/dist/index.js",
   "module": "./packages/core/dist/index.js",
@@ -49,15 +49,15 @@
   },
   "keywords": [
     "krnl",
-    "framework",
-    "full-stack",
-    "multiplatform",
-    "vanjs",
-    "code-evolution",
-    "visual-ide",
-    "node-editor",
-    "ast-purity",
-    "orchestrator"
+    "skipo",
+    "service-framework",
+    "backend",
+    "backend-modules",
+    "services",
+    "service-facades",
+    "protocols",
+    "workflows",
+    "ast-purity"
   ],
   "author": "Dinil Palackal",
   "license": "MIT",

package/packages/cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dinilmusick/krnl-cli",
-  "version": "1.0.0",
-  "description": "Unified CLI for the Krnl Framework",
+  "version": "1.0.1",
+  "description": "Unified CLI for the Krnl Backend Service Framework",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/packages/core/dist/index.cjs

@@ -383,7 +383,6 @@ var HttpProtocolAdapter = class {
 
 // src/protocols/WebSocketProtocolAdapter.ts
 var import_http2 = __toESM(require("http"), 1);
-var import_ws = require("ws");
 var WebSocketProtocolAdapter = class {
   protocol = "ws";
   capabilities = {
@@ -399,8 +398,10 @@ var WebSocketProtocolAdapter = class {
   wss;
   port;
   async expose(service, port = 0) {
+    const wsMod = await import("ws");
+    const WebSocketServer = wsMod.WebSocketServer || wsMod.default?.WebSocketServer || wsMod.Server;
     this.server = import_http2.default.createServer();
-    this.wss = new import_ws.WebSocketServer({ server: this.server });
+    this.wss = new WebSocketServer({ server: this.server });
     this.wss.on("connection", (ws) => {
       ws.on("message", async (raw) => {
         try {
@@ -445,8 +446,10 @@ var WebSocketProtocolAdapter = class {
     };
   }
   async send(endpoint, envelope) {
+    const wsMod = await import("ws");
+    const WS = wsMod.WebSocket || wsMod.default || globalThis.WebSocket;
     return new Promise((resolve, reject) => {
-      const ws = new import_ws.WebSocket(`ws://${endpoint.address}:${endpoint.port}`);
+      const ws = new WS(`ws://${endpoint.address}:${endpoint.port}`);
       ws.on("open", () => {
         ws.send(JSON.stringify(envelope));
       });

package/packages/core/dist/index.d.cts

@@ -203,7 +203,7 @@ declare class HttpProtocolAdapter implements ProtocolAdapter {
 
 /**
  * @file WebSocketProtocolAdapter.ts
- * @description WebSocket full-duplex protocol adapter for services.
+ * @description WebSocket full-duplex protocol adapter for services (browser + Node safe).
  */
 
 declare class WebSocketProtocolAdapter implements ProtocolAdapter {

package/packages/core/dist/index.d.ts

@@ -203,7 +203,7 @@ declare class HttpProtocolAdapter implements ProtocolAdapter {
 
 /**
  * @file WebSocketProtocolAdapter.ts
- * @description WebSocket full-duplex protocol adapter for services.
+ * @description WebSocket full-duplex protocol adapter for services (browser + Node safe).
  */
 
 declare class WebSocketProtocolAdapter implements ProtocolAdapter {

package/packages/core/dist/index.js

@@ -331,7 +331,6 @@ var HttpProtocolAdapter = class {
 
 // src/protocols/WebSocketProtocolAdapter.ts
 import http2 from "http";
-import { WebSocketServer, WebSocket } from "ws";
 var WebSocketProtocolAdapter = class {
   protocol = "ws";
   capabilities = {
@@ -347,6 +346,8 @@ var WebSocketProtocolAdapter = class {
   wss;
   port;
   async expose(service, port = 0) {
+    const wsMod = await import("ws");
+    const WebSocketServer = wsMod.WebSocketServer || wsMod.default?.WebSocketServer || wsMod.Server;
     this.server = http2.createServer();
     this.wss = new WebSocketServer({ server: this.server });
     this.wss.on("connection", (ws) => {
@@ -393,8 +394,10 @@ var WebSocketProtocolAdapter = class {
     };
   }
   async send(endpoint, envelope) {
+    const wsMod = await import("ws");
+    const WS = wsMod.WebSocket || wsMod.default || globalThis.WebSocket;
     return new Promise((resolve, reject) => {
-      const ws = new WebSocket(`ws://${endpoint.address}:${endpoint.port}`);
+      const ws = new WS(`ws://${endpoint.address}:${endpoint.port}`);
       ws.on("open", () => {
         ws.send(JSON.stringify(envelope));
       });

package/packages/core/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dinilmusick/krnl-core",
-  "version": "1.0.0",
-  "description": "Core runtime engine, Entity system, Flows, and Universal Backend for Krnl",
+  "version": "1.0.1",
+  "description": "Core runtime engine, Service facades, Protocols, Transports, and Execution flows for Krnl backend services",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/packages/create-krnl/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-krnl",
-  "version": "1.0.0",
-  "description": "Interactive project scaffolder for the Krnl Framework",
+  "version": "1.0.1",
+  "description": "Interactive project scaffolder for Krnl backend service projects",
   "type": "module",
   "main": "dist/index.js",
   "bin": {

package/packages/eslint-plugin/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dinilmusick/eslint-plugin-krnl",
-  "version": "1.0.0",
-  "description": "ESLint plugin enforcing Krnl 4-layer function purity, line limits, and architectural paradigms",
+  "version": "1.0.1",
+  "description": "ESLint plugin enforcing Krnl backend service purity, 4-layer architecture, and backend standards",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/packages/validate/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@dinilmusick/krnl-validate",
-  "version": "1.0.0",
-  "description": "Deep AST Validation and 4-Layer Function Purity Engine for Krnl",
+  "version": "1.0.1",
+  "description": "Deep AST validation and 4-layer function purity engine for Krnl backend services",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",