@cadenza.io/core 1.11.6 → 1.11.8

package/dist/index.d.mts

@@ -114,18 +114,17 @@ declare abstract class SignalEmitter {
      */
     constructor(silent?: boolean);
     /**
-     * Emits a signal via the broker if not silent.
+     * Emits a signal via the broker.
      * @param signal The signal name.
      * @param data Optional payload (defaults to empty object).
-     * @edge No emission if silent; for metrics in silent mode, consider override or separate method.
      */
     protected emit(signal: string, data?: AnyObject): void;
     /**
-     * Emits a signal via the broker even if silent.
+     * Emits a signal via the broker if not silent.
      * @param signal The signal name.
      * @param data Optional payload (defaults to empty object).
      */
-    protected emitMetric(signal: string, data?: AnyObject): void;
+    protected emitMetrics(signal: string, data?: AnyObject): void;
 }
 
 declare abstract class ExecutionChain {
@@ -230,6 +229,7 @@ declare class GraphNode extends SignalEmitter implements Graph {
     private executeAsync;
     private work;
     protected emitWithMetadata(signal: string, ctx: AnyObject): void;
+    protected emitMetricsWithMetadata(signal: string, ctx: AnyObject): void;
     private onProgress;
     private postProcess;
     private onError;
@@ -639,7 +639,9 @@ declare class SignalBroker {
      */
     static get instance(): SignalBroker;
     private debug;
+    private verbose;
     setDebug(value: boolean): void;
+    setVerbose(value: boolean): void;
     protected validateSignalName(signalName: string): void;
     protected runner: GraphRunner | undefined;
     protected metaRunner: GraphRunner | undefined;
@@ -783,7 +785,7 @@ interface TaskOptions {
     retryDelayMax?: number;
     retryDelayFactor?: number;
 }
-type CadenzaMode = "dev" | "debug" | "production";
+type CadenzaMode = "dev" | "debug" | "verbose" | "production";
 declare class Cadenza {
     static broker: SignalBroker;
     static runner: GraphRunner;

package/dist/index.d.ts

@@ -114,18 +114,17 @@ declare abstract class SignalEmitter {
      */
     constructor(silent?: boolean);
     /**
-     * Emits a signal via the broker if not silent.
+     * Emits a signal via the broker.
      * @param signal The signal name.
      * @param data Optional payload (defaults to empty object).
-     * @edge No emission if silent; for metrics in silent mode, consider override or separate method.
      */
     protected emit(signal: string, data?: AnyObject): void;
     /**
-     * Emits a signal via the broker even if silent.
+     * Emits a signal via the broker if not silent.
      * @param signal The signal name.
      * @param data Optional payload (defaults to empty object).
      */
-    protected emitMetric(signal: string, data?: AnyObject): void;
+    protected emitMetrics(signal: string, data?: AnyObject): void;
 }
 
 declare abstract class ExecutionChain {
@@ -230,6 +229,7 @@ declare class GraphNode extends SignalEmitter implements Graph {
     private executeAsync;
     private work;
     protected emitWithMetadata(signal: string, ctx: AnyObject): void;
+    protected emitMetricsWithMetadata(signal: string, ctx: AnyObject): void;
     private onProgress;
     private postProcess;
     private onError;
@@ -639,7 +639,9 @@ declare class SignalBroker {
      */
     static get instance(): SignalBroker;
     private debug;
+    private verbose;
     setDebug(value: boolean): void;
+    setVerbose(value: boolean): void;
     protected validateSignalName(signalName: string): void;
     protected runner: GraphRunner | undefined;
     protected metaRunner: GraphRunner | undefined;
@@ -783,7 +785,7 @@ interface TaskOptions {
     retryDelayMax?: number;
     retryDelayFactor?: number;
 }
-type CadenzaMode = "dev" | "debug" | "production";
+type CadenzaMode = "dev" | "debug" | "verbose" | "production";
 declare class Cadenza {
     static broker: SignalBroker;
     static runner: GraphRunner;

package/dist/index.js

@@ -76,6 +76,7 @@ var SignalBroker = class _SignalBroker {
   // execId -> emitted signals
   constructor() {
     this.debug = false;
+    this.verbose = false;
     this.signalObservers = /* @__PURE__ */ new Map();
     this.emitStacks = /* @__PURE__ */ new Map();
     this.addSignal("meta.signal_broker.added");
@@ -93,6 +94,9 @@ var SignalBroker = class _SignalBroker {
   setDebug(value) {
     this.debug = value;
   }
+  setVerbose(value) {
+    this.verbose = value;
+  }
   validateSignalName(signalName) {
     if (signalName.length > 100) {
       throw new Error(
@@ -196,8 +200,10 @@ var SignalBroker = class _SignalBroker {
     }
   }
   execute(signal, context) {
+    var _a;
     const isMeta = signal.startsWith("meta.");
     const isSubMeta = signal.startsWith("sub_meta.");
+    const isMetric = (_a = context.__signalEmission) == null ? void 0 : _a.isMetric;
     if (!isSubMeta && (!isMeta || this.debug)) {
       const emittedAt = Date.now();
       context.__signalEmission = {
@@ -214,7 +220,7 @@ var SignalBroker = class _SignalBroker {
     } else {
       delete context.__signalEmission;
     }
-    if (this.debug) {
+    if (this.debug && (!isMetric || this.verbose)) {
       console.log(
         `Emitting signal ${signal} with context ${JSON.stringify(context)}`
       );
@@ -663,23 +669,22 @@ var SignalEmitter = class {
     this.silent = silent;
   }
   /**
-   * Emits a signal via the broker if not silent.
+   * Emits a signal via the broker.
    * @param signal The signal name.
    * @param data Optional payload (defaults to empty object).
-   * @edge No emission if silent; for metrics in silent mode, consider override or separate method.
    */
   emit(signal, data = {}) {
-    if (this.silent) {
-      return;
-    }
     Cadenza.broker.emit(signal, data);
   }
   /**
-   * Emits a signal via the broker even if silent.
+   * Emits a signal via the broker if not silent.
    * @param signal The signal name.
    * @param data Optional payload (defaults to empty object).
    */
-  emitMetric(signal, data = {}) {
+  emitMetrics(signal, data = {}) {
+    if (this.silent) {
+      return;
+    }
     Cadenza.broker.emit(signal, data);
   }
 };
@@ -785,7 +790,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
       layer.add(this);
       const context = this.context.getFullContext();
       const scheduledAt = Date.now();
-      this.emitWithMetadata("meta.node.scheduled", {
+      this.emitMetricsWithMetadata("meta.node.scheduled", {
         data: {
           uuid: this.id,
           routineExecutionId: this.routineExecId,
@@ -800,7 +805,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
         }
       });
       this.previousNodes.forEach((node) => {
-        this.emitWithMetadata("meta.node.mapped", {
+        this.emitMetricsWithMetadata("meta.node.mapped", {
           data: {
             taskExecutionId: this.id,
             previousTaskExecutionId: node.id,
@@ -812,7 +817,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
           }
         });
         if (node.failed || node.errored) {
-          this.emitWithMetadata("meta.node.failed_mapped", {
+          this.emitMetricsWithMetadata("meta.node.failed_mapped", {
             data: {
               executionCount: "increment"
             },
@@ -824,7 +829,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
         }
       });
       if (((_a = context.__signalEmission) == null ? void 0 : _a.consumed) === false && (!this.isMeta() || this.debug)) {
-        this.emitWithMetadata("meta.node.consumed_signal", {
+        this.emitMetricsWithMetadata("meta.node.consumed_signal", {
           data: {
             signalName: context.__signalEmission.signalName,
             taskId: this.task.id,
@@ -842,7 +847,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
       this.executionStart = Date.now();
     }
     if (this.previousNodes.length === 0) {
-      this.emitWithMetadata("meta.node.started_routine_execution", {
+      this.emitMetricsWithMetadata("meta.node.started_routine_execution", {
         data: {
           isRunning: true,
           started: formatTimestamp(this.executionStart)
@@ -853,7 +858,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     if (this.debug) {
       this.log();
     }
-    this.emitWithMetadata("meta.node.started", {
+    this.emitMetricsWithMetadata("meta.node.started", {
       data: {
         isRunning: true,
         started: formatTimestamp(this.executionStart)
@@ -871,7 +876,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     this.executionTime = end - this.executionStart;
     const context = this.context.getFullContext();
     if (this.errored || this.failed) {
-      this.emitWithMetadata("meta.node.errored", {
+      this.emitMetricsWithMetadata("meta.node.errored", {
         data: {
           isRunning: false,
           errored: this.errored,
@@ -881,7 +886,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
         filter: { uuid: this.id }
       });
     }
-    this.emitWithMetadata("meta.node.ended", {
+    this.emitMetricsWithMetadata("meta.node.ended", {
       data: {
         isRunning: false,
         isComplete: true,
@@ -895,7 +900,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
       filter: { uuid: this.id }
     });
     if (this.graphDone()) {
-      this.emitWithMetadata(
+      this.emitMetricsWithMetadata(
         `meta.node.ended_routine_execution:${this.routineExecId}`,
         {
           data: {
@@ -968,7 +973,6 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     }
   }
   emitWithMetadata(signal, ctx) {
-    if (this.silent) return;
     const data = { ...ctx };
     if (!this.task.isHidden) {
       data.__signalEmission = {
@@ -981,10 +985,24 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     }
     this.emit(signal, data);
   }
+  emitMetricsWithMetadata(signal, ctx) {
+    const data = { ...ctx };
+    if (!this.task.isHidden) {
+      data.__signalEmission = {
+        taskId: this.task.id,
+        taskExecutionId: this.id,
+        isMetric: true
+      };
+      data.__metadata = {
+        __routineExecId: this.routineExecId
+      };
+    }
+    this.emitMetrics(signal, data);
+  }
   onProgress(progress) {
     var _a, _b;
     progress = Math.min(Math.max(0, progress), 1);
-    this.emitWithMetadata("meta.node.progress", {
+    this.emitMetricsWithMetadata("meta.node.progress", {
       data: {
         progress
       },
@@ -992,7 +1010,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
         uuid: this.id
       }
     });
-    this.emitWithMetadata(
+    this.emitMetricsWithMetadata(
       `meta.node.routine_execution_progress:${this.routineExecId}`,
       {
         data: {
@@ -1273,8 +1291,7 @@ var GraphNode = class _GraphNode extends SignalEmitter {
     console.log(
       "Node execution:",
       this.task.name,
-      JSON.stringify(this.context.getFullContext()),
-      this.routineExecId
+      JSON.stringify(this.context.getFullContext())
     );
   }
 };
@@ -2255,7 +2272,7 @@ var GraphRunner = class extends SignalEmitter {
     const routineExecId = (_a = context.__routineExecId) != null ? _a : (0, import_uuid6.v4)();
     context.__routineExecId = routineExecId;
     if (!isSubMeta) {
-      this.emit("meta.runner.added_tasks", {
+      this.emitMetrics("meta.runner.added_tasks", {
         data: {
           uuid: routineExecId,
           name: routineName,
@@ -3046,6 +3063,11 @@ var Cadenza = class {
       this.broker.setDebug(true);
       this.runner.setDebug(true);
     }
+    if (mode === "verbose") {
+      this.broker.setDebug(true);
+      this.broker.setVerbose(true);
+      this.runner.setDebug(true);
+    }
   }
   /**
    * Validates a name for uniqueness and non-emptiness.