@ultrst-armada/krnl 1.0.0 → 1.0.2

package/packages/cli/dist/index.js

@@ -2,26 +2,7 @@ import {
   generateMagneticDeclarations,
   runGenerate,
   runValidate
-} from "./chunk-F5EHXE2O.js";
-import "./chunk-RJNYUXZD.js";
-import "./chunk-BOXWWXQG.js";
-import "./chunk-OHVMVRBP.js";
-import "./chunk-EG7T2IAD.js";
-import "./chunk-SRTOPJ5W.js";
-import "./chunk-6NIKAMUZ.js";
-import "./chunk-P2PCLEKX.js";
-import "./chunk-FDNCADFE.js";
-import "./chunk-PJQIUOX2.js";
-import "./chunk-GDLRMDAN.js";
-import "./chunk-I74QIQOD.js";
-import "./chunk-ZAAV3JXQ.js";
-import "./chunk-5JDK35TG.js";
-import "./chunk-Q45257P6.js";
-import "./chunk-3TRM6CYL.js";
-import "./chunk-XIRFOO3H.js";
-import "./chunk-JTLSTO25.js";
-import "./chunk-JULBBJ27.js";
-import "./chunk-X5LOIFM7.js";
+} from "./chunk-ESTKOQ7T.js";
 export {
   generateMagneticDeclarations,
   runGenerate,

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

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   HttpProtocolAdapter: () => HttpProtocolAdapter,
+  KrnlPackageReconciler: () => KrnlPackageReconciler,
   LifecycleManager: () => LifecycleManager,
   MemoryTransport: () => MemoryTransport,
   P2PProtocolAdapter: () => P2PProtocolAdapter,
@@ -382,8 +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,15 @@ var WebSocketProtocolAdapter = class {
   wss;
   port;
   async expose(service, port = 0) {
-    this.server = import_http2.default.createServer();
-    this.wss = new import_ws.WebSocketServer({ server: this.server });
+    const httpMod = await import("http");
+    const http2 = httpMod.default || httpMod;
+    const wsMod = await import("ws").catch(() => null);
+    if (!wsMod) {
+      throw new Error('WebSocketProtocolAdapter.expose requires "ws" package in Node.js environment.');
+    }
+    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) => {
       ws.on("message", async (raw) => {
         try {
@@ -445,8 +451,16 @@ var WebSocketProtocolAdapter = class {
     };
   }
   async send(endpoint, envelope) {
+    let WS = globalThis.WebSocket;
+    if (!WS) {
+      const wsMod = await import("ws").catch(() => null);
+      WS = wsMod?.WebSocket || wsMod?.default?.WebSocket || wsMod;
+    }
+    if (!WS) {
+      throw new Error("No WebSocket client implementation available in this environment.");
+    }
     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));
       });
@@ -724,6 +738,126 @@ var ServiceDiscovery = class {
   }
 };
 
+// src/discovery/KrnlPackageReconciler.ts
+var fs = __toESM(require("fs"), 1);
+var path = __toESM(require("path"), 1);
+var KrnlPackageReconciler = class {
+  /**
+   * Scans all manifest.json files across backend and frontend and reconciles root package.json.
+   */
+  static reconcile(projectRoot = process.cwd(), writeChanges = true) {
+    const manifests = this.findManifests(projectRoot);
+    const aggregatedDeps = {};
+    const aggregatedDevDeps = {};
+    for (const mPath of manifests) {
+      try {
+        const raw = fs.readFileSync(mPath, "utf8");
+        const json = JSON.parse(raw);
+        if (json.dependencies && typeof json.dependencies === "object") {
+          for (const [pkg, ver] of Object.entries(json.dependencies)) {
+            if (!aggregatedDeps[pkg]) aggregatedDeps[pkg] = [];
+            if (!aggregatedDeps[pkg].includes(String(ver))) {
+              aggregatedDeps[pkg].push(String(ver));
+            }
+          }
+        }
+        if (json.devDependencies && typeof json.devDependencies === "object") {
+          for (const [pkg, ver] of Object.entries(json.devDependencies)) {
+            if (!aggregatedDevDeps[pkg]) aggregatedDevDeps[pkg] = [];
+            if (!aggregatedDevDeps[pkg].includes(String(ver))) {
+              aggregatedDevDeps[pkg].push(String(ver));
+            }
+          }
+        }
+      } catch (err) {
+        console.warn(`[KrnlPackageReconciler] Warning: Could not parse ${mPath}:`, err);
+      }
+    }
+    const conflicts = [];
+    const resolvedDeps = {};
+    const resolvedDevDeps = {};
+    for (const [pkg, versions] of Object.entries(aggregatedDeps)) {
+      if (versions.length > 1) {
+        conflicts.push({ package: pkg, versions });
+      }
+      resolvedDeps[pkg] = versions[versions.length - 1];
+    }
+    for (const [pkg, versions] of Object.entries(aggregatedDevDeps)) {
+      if (versions.length > 1 && !conflicts.some((c) => c.package === pkg)) {
+        conflicts.push({ package: pkg, versions });
+      }
+      resolvedDevDeps[pkg] = versions[versions.length - 1];
+    }
+    const pkgJsonPath = path.join(projectRoot, "package.json");
+    let updated = false;
+    if (fs.existsSync(pkgJsonPath)) {
+      const pkgContent = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
+      pkgContent.dependencies = pkgContent.dependencies || {};
+      pkgContent.devDependencies = pkgContent.devDependencies || {};
+      let hasChanges = false;
+      for (const [pkg, ver] of Object.entries(resolvedDeps)) {
+        if (pkgContent.dependencies[pkg] !== ver) {
+          pkgContent.dependencies[pkg] = ver;
+          hasChanges = true;
+        }
+      }
+      for (const [pkg, ver] of Object.entries(resolvedDevDeps)) {
+        if (!pkgContent.dependencies[pkg] && pkgContent.devDependencies[pkg] !== ver) {
+          pkgContent.devDependencies[pkg] = ver;
+          hasChanges = true;
+        }
+      }
+      if (hasChanges && writeChanges) {
+        fs.writeFileSync(pkgJsonPath, JSON.stringify(pkgContent, null, 2) + "\n");
+        updated = true;
+        console.log(`[KrnlPackageReconciler] Reconciled package.json from ${manifests.length} manifest(s).`);
+      }
+    }
+    return {
+      updated,
+      totalManifests: manifests.length,
+      addedDependencies: resolvedDeps,
+      addedDevDependencies: resolvedDevDeps,
+      conflicts
+    };
+  }
+  /**
+   * Discovers all manifest.json files in krnl/ (or src/)
+   */
+  static findManifests(projectRoot) {
+    const searchDirs = [
+      path.join(projectRoot, "krnl", "backend", "libraries"),
+      path.join(projectRoot, "krnl", "backend", "functionalities"),
+      path.join(projectRoot, "krnl", "frontend", "libraries"),
+      path.join(projectRoot, "krnl", "frontend", "functionalities"),
+      path.join(projectRoot, "src", "functionalities"),
+      path.join(projectRoot, "src", "libraries")
+    ];
+    const found = [];
+    for (const dir of searchDirs) {
+      if (fs.existsSync(dir)) {
+        this.scanRecursive(dir, found);
+      }
+    }
+    return found;
+  }
+  static scanRecursive(dir, found) {
+    try {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.name === "node_modules" || entry.name === "dist" || entry.name === ".git") continue;
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          this.scanRecursive(full, found);
+        } else if (entry.isFile() && entry.name === "manifest.json") {
+          found.push(full);
+        }
+      }
+    } catch {
+    }
+  }
+};
+
 // src/connectivity/ProtocolResolver.ts
 var ProtocolResolver = class {
   static selectProtocol(requiredCapabilities, availableEndpoints) {
@@ -738,6 +872,7 @@ var ProtocolResolver = class {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   HttpProtocolAdapter,
+  KrnlPackageReconciler,
   LifecycleManager,
   MemoryTransport,
   P2PProtocolAdapter,

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 {
@@ -310,6 +310,28 @@ declare class ServiceDiscovery {
     findPeer(id: string): PeerRecord | undefined;
 }
 
+interface ReconcileResult {
+    updated: boolean;
+    totalManifests: number;
+    addedDependencies: Record<string, string>;
+    addedDevDependencies: Record<string, string>;
+    conflicts: Array<{
+        package: string;
+        versions: string[];
+    }>;
+}
+declare class KrnlPackageReconciler {
+    /**
+     * Scans all manifest.json files across backend and frontend and reconciles root package.json.
+     */
+    static reconcile(projectRoot?: string, writeChanges?: boolean): ReconcileResult;
+    /**
+     * Discovers all manifest.json files in krnl/ (or src/)
+     */
+    static findManifests(projectRoot: string): string[];
+    private static scanRecursive;
+}
+
 /**
  * @file ServiceStateStore.ts
  * @description State management primitive for stateful services.
@@ -357,4 +379,4 @@ declare class ProtocolResolver {
     static getSupportedProtocols(definition: ServiceDefinition): ProtocolType[];
 }
 
-export { type Connection, type DependencyContract, type EndpointDescriptor, type EventContract, HttpProtocolAdapter, type IService, type LifecycleContract, LifecycleManager, MemoryTransport, type OperationContext, type OperationContract, P2PProtocolAdapter, type PeerRecord, type ProtocolAdapter, type ProtocolCapabilities, type ProtocolEnvelope, ProtocolResolver, type ProtocolType, type RegisteredServiceRecord, type ServiceCapability, type ServiceDefinition, ServiceDiscovery, ServiceEventBus, ServiceInstance, ServiceProxy, ServiceRegistry, ServiceRuntime, ServiceStateStore, type ServiceStatus, type StateContract, UdpProtocolAdapter, WebSocketProtocolAdapter, createService, createServiceDefinition, createServiceProxy };
+export { type Connection, type DependencyContract, type EndpointDescriptor, type EventContract, HttpProtocolAdapter, type IService, KrnlPackageReconciler, type LifecycleContract, LifecycleManager, MemoryTransport, type OperationContext, type OperationContract, P2PProtocolAdapter, type PeerRecord, type ProtocolAdapter, type ProtocolCapabilities, type ProtocolEnvelope, ProtocolResolver, type ProtocolType, type ReconcileResult, type RegisteredServiceRecord, type ServiceCapability, type ServiceDefinition, ServiceDiscovery, ServiceEventBus, ServiceInstance, ServiceProxy, ServiceRegistry, ServiceRuntime, ServiceStateStore, type ServiceStatus, type StateContract, UdpProtocolAdapter, WebSocketProtocolAdapter, createService, createServiceDefinition, createServiceProxy };

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 {
@@ -310,6 +310,28 @@ declare class ServiceDiscovery {
     findPeer(id: string): PeerRecord | undefined;
 }
 
+interface ReconcileResult {
+    updated: boolean;
+    totalManifests: number;
+    addedDependencies: Record<string, string>;
+    addedDevDependencies: Record<string, string>;
+    conflicts: Array<{
+        package: string;
+        versions: string[];
+    }>;
+}
+declare class KrnlPackageReconciler {
+    /**
+     * Scans all manifest.json files across backend and frontend and reconciles root package.json.
+     */
+    static reconcile(projectRoot?: string, writeChanges?: boolean): ReconcileResult;
+    /**
+     * Discovers all manifest.json files in krnl/ (or src/)
+     */
+    static findManifests(projectRoot: string): string[];
+    private static scanRecursive;
+}
+
 /**
  * @file ServiceStateStore.ts
  * @description State management primitive for stateful services.
@@ -357,4 +379,4 @@ declare class ProtocolResolver {
     static getSupportedProtocols(definition: ServiceDefinition): ProtocolType[];
 }
 
-export { type Connection, type DependencyContract, type EndpointDescriptor, type EventContract, HttpProtocolAdapter, type IService, type LifecycleContract, LifecycleManager, MemoryTransport, type OperationContext, type OperationContract, P2PProtocolAdapter, type PeerRecord, type ProtocolAdapter, type ProtocolCapabilities, type ProtocolEnvelope, ProtocolResolver, type ProtocolType, type RegisteredServiceRecord, type ServiceCapability, type ServiceDefinition, ServiceDiscovery, ServiceEventBus, ServiceInstance, ServiceProxy, ServiceRegistry, ServiceRuntime, ServiceStateStore, type ServiceStatus, type StateContract, UdpProtocolAdapter, WebSocketProtocolAdapter, createService, createServiceDefinition, createServiceProxy };
+export { type Connection, type DependencyContract, type EndpointDescriptor, type EventContract, HttpProtocolAdapter, type IService, KrnlPackageReconciler, type LifecycleContract, LifecycleManager, MemoryTransport, type OperationContext, type OperationContract, P2PProtocolAdapter, type PeerRecord, type ProtocolAdapter, type ProtocolCapabilities, type ProtocolEnvelope, ProtocolResolver, type ProtocolType, type ReconcileResult, type RegisteredServiceRecord, type ServiceCapability, type ServiceDefinition, ServiceDiscovery, ServiceEventBus, ServiceInstance, ServiceProxy, ServiceRegistry, ServiceRuntime, ServiceStateStore, type ServiceStatus, type StateContract, UdpProtocolAdapter, WebSocketProtocolAdapter, createService, createServiceDefinition, createServiceProxy };

package/packages/core/dist/index.js

@@ -330,8 +330,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 +345,13 @@ var WebSocketProtocolAdapter = class {
   wss;
   port;
   async expose(service, port = 0) {
+    const httpMod = await import("http");
+    const http2 = httpMod.default || httpMod;
+    const wsMod = await import("ws").catch(() => null);
+    if (!wsMod) {
+      throw new Error('WebSocketProtocolAdapter.expose requires "ws" package in Node.js environment.');
+    }
+    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 +398,16 @@ var WebSocketProtocolAdapter = class {
     };
   }
   async send(endpoint, envelope) {
+    let WS = globalThis.WebSocket;
+    if (!WS) {
+      const wsMod = await import("ws").catch(() => null);
+      WS = wsMod?.WebSocket || wsMod?.default?.WebSocket || wsMod;
+    }
+    if (!WS) {
+      throw new Error("No WebSocket client implementation available in this environment.");
+    }
     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));
       });
@@ -672,6 +685,126 @@ var ServiceDiscovery = class {
   }
 };
 
+// src/discovery/KrnlPackageReconciler.ts
+import * as fs from "fs";
+import * as path from "path";
+var KrnlPackageReconciler = class {
+  /**
+   * Scans all manifest.json files across backend and frontend and reconciles root package.json.
+   */
+  static reconcile(projectRoot = process.cwd(), writeChanges = true) {
+    const manifests = this.findManifests(projectRoot);
+    const aggregatedDeps = {};
+    const aggregatedDevDeps = {};
+    for (const mPath of manifests) {
+      try {
+        const raw = fs.readFileSync(mPath, "utf8");
+        const json = JSON.parse(raw);
+        if (json.dependencies && typeof json.dependencies === "object") {
+          for (const [pkg, ver] of Object.entries(json.dependencies)) {
+            if (!aggregatedDeps[pkg]) aggregatedDeps[pkg] = [];
+            if (!aggregatedDeps[pkg].includes(String(ver))) {
+              aggregatedDeps[pkg].push(String(ver));
+            }
+          }
+        }
+        if (json.devDependencies && typeof json.devDependencies === "object") {
+          for (const [pkg, ver] of Object.entries(json.devDependencies)) {
+            if (!aggregatedDevDeps[pkg]) aggregatedDevDeps[pkg] = [];
+            if (!aggregatedDevDeps[pkg].includes(String(ver))) {
+              aggregatedDevDeps[pkg].push(String(ver));
+            }
+          }
+        }
+      } catch (err) {
+        console.warn(`[KrnlPackageReconciler] Warning: Could not parse ${mPath}:`, err);
+      }
+    }
+    const conflicts = [];
+    const resolvedDeps = {};
+    const resolvedDevDeps = {};
+    for (const [pkg, versions] of Object.entries(aggregatedDeps)) {
+      if (versions.length > 1) {
+        conflicts.push({ package: pkg, versions });
+      }
+      resolvedDeps[pkg] = versions[versions.length - 1];
+    }
+    for (const [pkg, versions] of Object.entries(aggregatedDevDeps)) {
+      if (versions.length > 1 && !conflicts.some((c) => c.package === pkg)) {
+        conflicts.push({ package: pkg, versions });
+      }
+      resolvedDevDeps[pkg] = versions[versions.length - 1];
+    }
+    const pkgJsonPath = path.join(projectRoot, "package.json");
+    let updated = false;
+    if (fs.existsSync(pkgJsonPath)) {
+      const pkgContent = JSON.parse(fs.readFileSync(pkgJsonPath, "utf8"));
+      pkgContent.dependencies = pkgContent.dependencies || {};
+      pkgContent.devDependencies = pkgContent.devDependencies || {};
+      let hasChanges = false;
+      for (const [pkg, ver] of Object.entries(resolvedDeps)) {
+        if (pkgContent.dependencies[pkg] !== ver) {
+          pkgContent.dependencies[pkg] = ver;
+          hasChanges = true;
+        }
+      }
+      for (const [pkg, ver] of Object.entries(resolvedDevDeps)) {
+        if (!pkgContent.dependencies[pkg] && pkgContent.devDependencies[pkg] !== ver) {
+          pkgContent.devDependencies[pkg] = ver;
+          hasChanges = true;
+        }
+      }
+      if (hasChanges && writeChanges) {
+        fs.writeFileSync(pkgJsonPath, JSON.stringify(pkgContent, null, 2) + "\n");
+        updated = true;
+        console.log(`[KrnlPackageReconciler] Reconciled package.json from ${manifests.length} manifest(s).`);
+      }
+    }
+    return {
+      updated,
+      totalManifests: manifests.length,
+      addedDependencies: resolvedDeps,
+      addedDevDependencies: resolvedDevDeps,
+      conflicts
+    };
+  }
+  /**
+   * Discovers all manifest.json files in krnl/ (or src/)
+   */
+  static findManifests(projectRoot) {
+    const searchDirs = [
+      path.join(projectRoot, "krnl", "backend", "libraries"),
+      path.join(projectRoot, "krnl", "backend", "functionalities"),
+      path.join(projectRoot, "krnl", "frontend", "libraries"),
+      path.join(projectRoot, "krnl", "frontend", "functionalities"),
+      path.join(projectRoot, "src", "functionalities"),
+      path.join(projectRoot, "src", "libraries")
+    ];
+    const found = [];
+    for (const dir of searchDirs) {
+      if (fs.existsSync(dir)) {
+        this.scanRecursive(dir, found);
+      }
+    }
+    return found;
+  }
+  static scanRecursive(dir, found) {
+    try {
+      const entries = fs.readdirSync(dir, { withFileTypes: true });
+      for (const entry of entries) {
+        if (entry.name === "node_modules" || entry.name === "dist" || entry.name === ".git") continue;
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+          this.scanRecursive(full, found);
+        } else if (entry.isFile() && entry.name === "manifest.json") {
+          found.push(full);
+        }
+      }
+    } catch {
+    }
+  }
+};
+
 // src/connectivity/ProtocolResolver.ts
 var ProtocolResolver = class {
   static selectProtocol(requiredCapabilities, availableEndpoints) {
@@ -685,6 +818,7 @@ var ProtocolResolver = class {
 };
 export {
   HttpProtocolAdapter,
+  KrnlPackageReconciler,
   LifecycleManager,
   MemoryTransport,
   P2PProtocolAdapter,

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.2",
+  "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",