@ultrst-armada/krnl 1.0.8 → 1.0.9

package/README.md

@@ -61,6 +61,21 @@ A stopped service may be restarted. Invalid lifecycle transitions fail determini
 
 Proxy lifecycle is local client lifecycle. Proxy state is a local cache and proxy events are local subscriptions unless a transport explicitly implements synchronization.
 
+## Native Telemetry
+
+Every `ServiceFacade` includes a framework-owned telemetry controller. Services do not implement telemetry APIs individually.
+
+```ts
+service.telemetry.enable();
+service.telemetry.setMode('standard' | 'detailed' | 'profile' | 'off');
+service.telemetry.status();
+service.telemetry.snapshot();
+service.telemetry.reset();
+service.telemetry.functionalities();
+service.telemetry.functionality('operationName');
+```
+
+Telemetry is disabled by default. Standard mode records invocation timing, counts, success/error state, correlation IDs, and bounded recent traces. Detailed and profile modes additionally capture capability-detected runtime resource samples such as CPU, memory, and event-loop utilization. Service calls, functionality execution, and functionality orchestrations are instrumented automatically and correlated into trace/span hierarchies. No service-specific telemetry code is required.
 ## Validation
 
 KrnlTS has two complementary validation layers:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultrst-armada/krnl",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "private": false,
   "description": "KrnlTS backend semantic kernel for authoring, validating, and running modular TypeScript services",
   "type": "module",

package/packages/cli/dist/bin/krnl.cjs

@@ -921,6 +921,8 @@ var fs5 = __toESM(require("fs"), 1);
 var path6 = __toESM(require("path"), 1);
 var import_gutts = require("@dinilmusick/gutts");
 var gutts = __toESM(require("@dinilmusick/gutts"), 1);
+var runtimeProcess = typeof globalThis !== "undefined" ? globalThis.process : void 0;
+var runtimePerformance = typeof globalThis !== "undefined" ? globalThis.performance : void 0;
 var asyncHooks = globalThis.process?.getBuiltinModule?.("node:async_hooks");
 var KrnlPackageReconciler = class {
   /**

package/packages/cli/dist/bin/krnl.js

@@ -6,7 +6,7 @@ import {
   runDev,
   runGenerate,
   runValidate
-} from "../chunk-3DD775A7.js";
+} from "../chunk-OOVZPIMX.js";
 
 // src/bin/krnl.ts
 import * as path from "path";

package/packages/cli/dist/{chunk-3DD775A7.js → chunk-OOVZPIMX.js}

@@ -816,6 +816,8 @@ import * as fs3 from "fs";
 import * as path4 from "path";
 import { tryParseJson } from "@dinilmusick/gutts";
 import * as gutts from "@dinilmusick/gutts";
+var runtimeProcess = typeof globalThis !== "undefined" ? globalThis.process : void 0;
+var runtimePerformance = typeof globalThis !== "undefined" ? globalThis.performance : void 0;
 var asyncHooks = globalThis.process?.getBuiltinModule?.("node:async_hooks");
 var KrnlPackageReconciler = class {
   /**

package/packages/cli/dist/index.cjs

@@ -932,6 +932,8 @@ var fs5 = __toESM(require("fs"), 1);
 var path6 = __toESM(require("path"), 1);
 var import_gutts = require("@dinilmusick/gutts");
 var gutts = __toESM(require("@dinilmusick/gutts"), 1);
+var runtimeProcess = typeof globalThis !== "undefined" ? globalThis.process : void 0;
+var runtimePerformance = typeof globalThis !== "undefined" ? globalThis.performance : void 0;
 var asyncHooks = globalThis.process?.getBuiltinModule?.("node:async_hooks");
 var KrnlPackageReconciler = class {
   /**

package/packages/cli/dist/index.js

@@ -4,7 +4,7 @@ import {
   runDev,
   runGenerate,
   runValidate
-} from "./chunk-3DD775A7.js";
+} from "./chunk-OOVZPIMX.js";
 export {
   generateMagneticDeclarations,
   runBuild,