@orbytautomation/engine 0.4.1 → 0.6.0

package/dist/security/ReservedFields.js

@@ -11,7 +11,7 @@
  *
  * @module security
  */
-import { SecurityError, } from '../errors/SecurityErrors.js';
+import { SecurityError } from '../errors/SecurityErrors.js';
 import { RESERVED_ANNOTATION_PREFIXES, RESERVED_CONTEXT_FIELDS, RESERVED_STEP_FIELDS, RESERVED_WORKFLOW_FIELDS, SecurityErrorCode } from '../types/core-types.js';
 /**
  * Check if a field name is reserved
@@ -118,67 +118,104 @@ export function findReservedFields(obj, reservedList, checkPrefix = true) {
  * @throws {SecurityError} If reserved fields are found
  */
 export function validateWorkflowSecurity(workflow) {
+    // 1. Check top-level workflow fields for reserved/internal fields
+    for (const key of Object.keys(workflow)) {
+        if (isReservedWorkflowField(key)) {
+            const code = determineErrorCode(key);
+            const reason = getFieldReason(key);
+            const err = SecurityError.reservedFieldOverride(key, 'workflow (root level)', code === SecurityErrorCode.BILLING_FIELD_OVERRIDE ? 'billing' : 'internal');
+            err.reason = reason;
+            throw err;
+        }
+    }
+    // 2. workflow.context fields
+    if (workflow.context && typeof workflow.context === 'object') {
+        const contextViolations = findReservedFields(workflow.context, RESERVED_CONTEXT_FIELDS);
+        if (contextViolations.length > 0) {
+            const key = contextViolations[0];
+            const code = determineErrorCode(key);
+            const reason = getFieldReason(key);
+            const err = SecurityError.reservedFieldOverride(key, 'workflow.context', code === SecurityErrorCode.BILLING_FIELD_OVERRIDE ? 'billing' : 'internal');
+            err.reason = reason;
+            throw err;
+        }
+    }
+    // 3. Annotations
+    if (workflow.annotations && typeof workflow.annotations === 'object') {
+        for (const key of Object.keys(workflow.annotations)) {
+            if (isReservedAnnotation(key)) {
+                throw SecurityError.reservedAnnotation(key, 'workflow.annotations');
+            }
+        }
+    }
+    // 4. Steps
+    if (workflow.workflow?.steps && Array.isArray(workflow.workflow.steps)) {
+        for (let index = 0; index < workflow.workflow.steps.length; index++) {
+            const step = workflow.workflow.steps[index];
+            const stepViolations = findReservedFields(step, RESERVED_STEP_FIELDS);
+            if (stepViolations.length > 0) {
+                const key = stepViolations[0];
+                const code = determineErrorCode(key);
+                const reason = getFieldReason(key);
+                const err = SecurityError.reservedFieldOverride(key, `workflow.steps[${index}] (${step.id || 'unnamed'})`, code === SecurityErrorCode.BILLING_FIELD_OVERRIDE ? 'billing' : 'internal');
+                err.reason = reason;
+                throw err;
+            }
+        }
+    }
+}
+/**
+ * Collect all reserved field violations in a workflow (for advanced use/testing)
+ * Returns an array of violation objects with code, reason, and location
+ */
+export function getAllReservedFieldViolations(workflow) {
     const violations = [];
-    // 1. Check top-level workflow fields
-    const topLevelViolations = findReservedFields(workflow, RESERVED_WORKFLOW_FIELDS);
-    for (const field of topLevelViolations) {
+    // 1. Top-level
+    for (const key of findReservedFields(workflow, RESERVED_WORKFLOW_FIELDS)) {
         violations.push({
-            code: determineErrorCode(field),
+            field: key,
             location: 'workflow (root level)',
-            field,
-            attemptedValue: workflow[field],
-            reason: getFieldReason(field),
-            suggestion: `Remove '${field}' from your workflow YAML. The engine will inject this field automatically during execution.`,
+            code: determineErrorCode(key),
+            reason: getFieldReason(key),
         });
     }
-    // 2. Check workflow.context for reserved fields
+    // 2. Context
     if (workflow.context && typeof workflow.context === 'object') {
-        const contextViolations = findReservedFields(workflow.context, RESERVED_CONTEXT_FIELDS);
-        for (const field of contextViolations) {
+        for (const key of findReservedFields(workflow.context, RESERVED_CONTEXT_FIELDS)) {
             violations.push({
-                code: determineErrorCode(field),
+                field: key,
                 location: 'workflow.context',
-                field,
-                attemptedValue: workflow.context[field],
-                reason: getFieldReason(field),
-                suggestion: `Remove '${field}' from workflow.context. Use custom field names like 'myContext' or 'customData' instead.`,
+                code: determineErrorCode(key),
+                reason: getFieldReason(key),
             });
         }
     }
-    // 3. Check annotations for reserved prefixes
+    // 3. Annotations
     if (workflow.annotations && typeof workflow.annotations === 'object') {
         for (const key of Object.keys(workflow.annotations)) {
             if (isReservedAnnotation(key)) {
                 violations.push({
-                    code: SecurityErrorCode.RESERVED_ANNOTATION_NAMESPACE,
-                    location: 'workflow.annotations',
                     field: key,
-                    attemptedValue: workflow.annotations[key],
+                    location: 'workflow.annotations',
+                    code: SecurityErrorCode.RESERVED_ANNOTATION_NAMESPACE,
                     reason: `Annotation namespace '${key.split('.')[0]}.' is reserved for engine use.`,
-                    suggestion: `Use a custom prefix like 'custom.${key}' or 'my.${key}' instead.`,
                 });
             }
         }
     }
-    // 4. Check steps for reserved fields
+    // 4. Steps
     if (workflow.workflow?.steps && Array.isArray(workflow.workflow.steps)) {
         workflow.workflow.steps.forEach((step, index) => {
-            const stepViolations = findReservedFields(step, RESERVED_STEP_FIELDS);
-            for (const field of stepViolations) {
+            for (const key of findReservedFields(step, RESERVED_STEP_FIELDS)) {
                 violations.push({
-                    code: determineErrorCode(field),
+                    field: key,
                     location: `workflow.steps[${index}] (${step.id || 'unnamed'})`,
-                    field,
-                    attemptedValue: step[field],
-                    reason: getFieldReason(field),
-                    suggestion: `Remove '${field}' from step definition. The engine tracks execution state internally.`,
+                    code: determineErrorCode(key),
+                    reason: getFieldReason(key),
                 });
             }
         });
     }
-    // If violations found, throw SecurityError
-    if (violations.length > 0) {
-        throw new SecurityError(violations);
-    }
+    return violations;
 }
 //# sourceMappingURL=ReservedFields.js.map

package/dist/security/ReservedFields.js.map

@@ -1 +1 @@
-{"version":3,"file":"ReservedFields.js","sourceRoot":"","sources":["../../src/security/ReservedFields.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ReservedFields.js","sourceRoot":"","sources":["../../src/security/ReservedFields.ts"],"names":[],"mappings":"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"}

package/dist/types/log-types.d.ts

@@ -1,4 +1,36 @@
 import { LogLevel } from "@dev-ecosystem/core";
+/**
+ * Log categories (phase-based, not feature-based)
+ *
+ * - 'system': Engine lifecycle, infrastructure, configuration, adapter registration
+ * - 'analysis': Parsing, validation, explain, plan building, cycle detection
+ * - 'runtime': Actual workflow execution (steps, retries, completion, failures)
+ * - 'security': Internal field violation, reserved field usage, permission rejection
+ *
+ * Never add feature, adapter, or business domain categories here.
+ */
+export type LogCategory = 'system' | 'analysis' | 'runtime' | 'security';
+/**
+ * Enum for log categories (for strict usage)
+ */
+export declare enum LogCategoryEnum {
+    SYSTEM = "system",
+    ANALYSIS = "analysis",
+    RUNTIME = "runtime",
+    SECURITY = "security"
+}
+/**
+ * Interface for a structured engine log entry
+ * Every log must have a category and source.
+ */
+export interface EngineLog {
+    timestamp: number;
+    level: 'info' | 'warn' | 'error';
+    category: LogCategory;
+    source: string;
+    message: string;
+    context?: Record<string, unknown>;
+}
 /**
  * Engine-specific log format type
  */
@@ -36,7 +68,7 @@ export declare enum EngineLogType {
     ERROR = "error"
 }
 /**
- * Structured engine log event
+ * Structured engine log event (with category and source)
  */
 export interface EngineLogEvent {
     /** Event type */
@@ -45,6 +77,10 @@ export interface EngineLogEvent {
     timestamp: Date;
     /** Log message */
     message: string;
+    /** Log category (phase) */
+    category: LogCategory;
+    /** Log source (component/module) */
+    source: string;
     /** Additional context */
     context?: Record<string, unknown>;
     /** Error object if applicable */
@@ -98,8 +134,104 @@ export interface EngineLoggerConfig {
     /** Include timestamps */
     timestamp?: boolean;
     /** Source identifier */
-    source?: string;
+    source: string;
     /** Enable structured event logging */
     structuredEvents?: boolean;
+    /** Log category */
+    category: LogCategory;
+    /**
+     * Maximum number of log events to keep in the in-memory history ring-buffer.
+     * Older entries are silently dropped once the limit is reached. A value of
+     * `0` (the default) disables the limit so all events are retained.
+     */
+    maxHistorySize?: number;
+}
+/**
+ * Workflow context — attached to the logger for the duration of a
+ * run / explain / validate session.
+ *
+ * When set via `EngineLogger.setWorkflowContext()`, every subsequent log
+ * entry automatically includes this under the `workflow` key so that log
+ * consumers can filter, group and display logs per workflow file without
+ * parsing the message text.
+ *
+ * Build it from a `ParsedWorkflow`:
+ * ```typescript
+ * logger.setWorkflowContext({
+ *   name:              workflow.name,
+ *   version:           workflow.version,
+ *   kind:              workflow.kind,
+ *   description:       workflow.description,
+ *   stepCount:         workflow.steps.length,
+ *   filePath:          '/user/project/deploy.yaml',
+ *   tags:              workflow.tags,
+ * });
+ * ```
+ */
+export interface WorkflowContext {
+    /** Workflow name from the YAML file (e.g. "deploy-api") */
+    name?: string;
+    /** Semantic version string (e.g. "1.2.0") */
+    version?: string;
+    /** Document kind (e.g. "workflow", "pipeline") */
+    kind?: string;
+    /** Human-readable description from the file */
+    description?: string;
+    /** Total number of declared steps */
+    stepCount?: number;
+    /** Absolute path to the source YAML/JSON file */
+    filePath?: string;
+    /** Tags from workflow metadata */
+    tags?: string[];
+    /** Inferred execution strategy */
+    executionStrategy?: 'sequential' | 'parallel' | 'mixed';
+}
+/**
+ * Export logs in formats suitable for different consumers
+ */
+export interface ExportedLogs {
+    /** Raw JSON logs */
+    raw: EngineLogEvent[];
+    /** Logs grouped by type */
+    grouped: Record<string, EngineLogEvent[]>;
+    /** Workflow context snapshot at the time of export (if set) */
+    workflowContext?: WorkflowContext;
+    /** Statistics */
+    stats: {
+        total: number;
+        byType: Record<string, number>;
+        /** Count per phase category (`system`, `runtime`, `analysis`, `security`) */
+        byCategory: Record<string, number>;
+        withErrors: number;
+        withMetrics: number;
+        timeRange: {
+            first?: Date;
+            last?: Date;
+        };
+    };
+    /** Workflow execution summary for explanation */
+    execution?: {
+        workflow?: {
+            name: string;
+            status: string;
+            duration?: number;
+        };
+        steps: Array<{
+            id: string;
+            name: string;
+            status: string;
+            duration?: number;
+        }>;
+        errors: Array<{
+            step?: string;
+            message: string;
+            error?: Error;
+        }>;
+        metrics: Array<{
+            label: string;
+            duration?: number;
+            memory?: number;
+        }>;
+    };
 }
 //# sourceMappingURL=log-types.d.ts.map

package/dist/types/log-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"log-types.d.ts","sourceRoot":"","sources":["../../src/types/log-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"log-types.d.ts","sourceRoot":"","sources":["../../src/types/log-types.ts"],"names":[],"mappings":"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"}

package/dist/types/log-types.js

@@ -1,3 +1,13 @@
+/**
+ * Enum for log categories (for strict usage)
+ */
+export var LogCategoryEnum;
+(function (LogCategoryEnum) {
+    LogCategoryEnum["SYSTEM"] = "system";
+    LogCategoryEnum["ANALYSIS"] = "analysis";
+    LogCategoryEnum["RUNTIME"] = "runtime";
+    LogCategoryEnum["SECURITY"] = "security";
+})(LogCategoryEnum || (LogCategoryEnum = {}));
 /**
  * Engine log event types - All possible log events in the engine
  */

package/dist/types/log-types.js.map

@@ -1 +1 @@
-{"version":3,"file":"log-types.js","sourceRoot":"","sources":["../../src/types/log-types.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,MAAM,CAAN,IAAY,aA2CX;AA3CD,WAAY,aAAa;IACvB,qBAAqB;IACrB,sDAAqC,CAAA;IACrC,0DAAyC,CAAA;IACzC,oDAAmC,CAAA;IACnC,4DAA2C,CAAA;IAE3C,iBAAiB;IACjB,8CAA6B,CAAA;IAC7B,kDAAiC,CAAA;IACjC,4CAA2B,CAAA;IAC3B,0CAAyB,CAAA;IACzB,8CAA6B,CAAA;IAE7B,cAAc;IACd,gEAA+C,CAAA;IAC/C,0DAAyC,CAAA;IAEzC,mBAAmB;IACnB,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,sDAAqC,CAAA;IACrC,oDAAmC,CAAA;IAEnC,gBAAgB;IAChB,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,sDAAqC,CAAA;IAErC,cAAc;IACd,0DAAyC,CAAA;IACzC,kDAAiC,CAAA;IAEjC,SAAS;IACT,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,sDAAqC,CAAA;IAErC,UAAU;IACV,8BAAa,CAAA;IACb,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,gCAAe,CAAA;AACjB,CAAC,EA3CW,aAAa,KAAb,aAAa,QA2CxB"}
+{"version":3,"file":"log-types.js","sourceRoot":"","sources":["../../src/types/log-types.ts"],"names":[],"mappings":"AAmBA;;GAEG;AACH,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACzB,oCAAiB,CAAA;IACjB,wCAAqB,CAAA;IACrB,sCAAmB,CAAA;IACnB,wCAAqB,CAAA;AACvB,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B;AAoBD;;GAEG;AACH,MAAM,CAAN,IAAY,aA2CX;AA3CD,WAAY,aAAa;IACvB,qBAAqB;IACrB,sDAAqC,CAAA;IACrC,0DAAyC,CAAA;IACzC,oDAAmC,CAAA;IACnC,4DAA2C,CAAA;IAE3C,iBAAiB;IACjB,8CAA6B,CAAA;IAC7B,kDAAiC,CAAA;IACjC,4CAA2B,CAAA;IAC3B,0CAAyB,CAAA;IACzB,8CAA6B,CAAA;IAE7B,cAAc;IACd,gEAA+C,CAAA;IAC/C,0DAAyC,CAAA;IAEzC,mBAAmB;IACnB,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,sDAAqC,CAAA;IACrC,oDAAmC,CAAA;IAEnC,gBAAgB;IAChB,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,sDAAqC,CAAA;IAErC,cAAc;IACd,0DAAyC,CAAA;IACzC,kDAAiC,CAAA;IAEjC,SAAS;IACT,kDAAiC,CAAA;IACjC,kDAAiC,CAAA;IACjC,sDAAqC,CAAA;IAErC,UAAU;IACV,8BAAa,CAAA;IACb,gCAAe,CAAA;IACf,oCAAmB,CAAA;IACnB,gCAAe,CAAA;AACjB,CAAC,EA3CW,aAAa,KAAb,aAAa,QA2CxB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbytautomation/engine",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "description": "Orbyt - Automation Engine Framework",
   "type": "module",
   "main": "./dist/index.js",