@ultrst-armada/krnl 1.0.0 → 1.0.2

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.2",
   "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",
@@ -41,7 +41,7 @@
     "registry": "https://registry.npmjs.org/"
   },
   "scripts": {
-    "build": "pnpm --filter @dinilmusick/krnl-core run build",
+    "build": "pnpm -r run build",
     "test": "vitest run",
     "validate": "node packages/cli/dist/bin/krnl.js validate",
     "dev": "node packages/cli/dist/bin/krnl.js dev",
@@ -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",