@orbytautomation/engine 0.2.0 → 0.2.2

package/dist/core/EngineLogger.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Engine Logger
+ *
+ * Provides structured logging for the Orbyt Engine using ecosystem-core utilities.
+ * Supports multiple output formats and log levels with proper filtering.
+ *
+ * Features:
+ * - Severity-based log level filtering using LogLevelSeverity
+ * - Multiple output formats (pretty, text, json, structured)
+ * - Color support with ANSI codes
+ * - Context and error tracking
+ * - Performance measurement with automatic severity adjustment
+ * - Efficient level comparison using numeric severity
+ *
+ * @module core
+ */
+import { LogLevel } from '@dev-ecosystem/core';
+/**
+ * Engine-specific log format type
+ */
+export type EngineLogFormat = 'pretty' | 'text' | 'json' | 'structured';
+/**
+ * Engine logger configuration
+ */
+export interface EngineLoggerConfig {
+    /** Minimum log level to output */
+    level: LogLevel;
+    /** Output format */
+    format?: EngineLogFormat;
+    /** Enable colors in output */
+    colors?: boolean;
+    /** Include timestamps */
+    timestamp?: boolean;
+    /** Source identifier */
+    source?: string;
+}
+/**
+ * Engine Logger
+ *
+ * Wraps ecosystem-core logging utilities with engine-specific configuration.
+ */
+export declare class EngineLogger {
+    private config;
+    private formatOptions;
+    constructor(config: EngineLoggerConfig);
+    /**
+     * Log a debug message
+     */
+    debug(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an info message
+     */
+    info(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log a warning message
+     */
+    warn(message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log an error message
+     */
+    error(message: string, error?: Error, context?: Record<string, unknown>): void;
+    /**
+     * Log a fatal error message
+     */
+    fatal(message: string, error?: Error, context?: Record<string, unknown>): void;
+    /**
+     * Log with a custom level
+     */
+    logWithLevel(level: LogLevel, message: string, context?: Record<string, unknown>): void;
+    /**
+     * Log only if severity meets minimum threshold
+     */
+    logIfSeverity(minSeverity: number, level: LogLevel, message: string, context?: Record<string, unknown>): void;
+    /**
+     * Measure and log execution time with appropriate log level based on duration
+     */
+    measureExecution<T>(label: string, fn: () => Promise<T>, thresholds?: {
+        warn?: number;
+        error?: number;
+    }): Promise<T>;
+    /**
+     * Internal log method
+     */
+    private log;
+    /**
+     * Check if a level should be logged using severity comparison
+     */
+    private shouldLogLevel;
+    /**
+     * Check if a level is more severe than another
+     */
+    isMoreSevere(level: LogLevel, compareWith: LogLevel): boolean;
+    /**
+     * Get severity difference between two levels
+     */
+    getSeverityDiff(level1: LogLevel, level2: LogLevel): number;
+    /**
+     * Get the numeric severity of the current log level
+     */
+    getCurrentSeverity(): number;
+    /**
+     * Get the numeric severity of a log level
+     */
+    getSeverity(level: LogLevel): number;
+    /**
+     * Update logger configuration
+     */
+    setLevel(level: LogLevel): void;
+    /**
+     * Set level by severity (0-4)
+     */
+    setLevelBySeverity(severity: number): void;
+    /**
+     * Update colors setting
+     */
+    setColors(enabled: boolean): void;
+    /**
+     * Update format
+     */
+    setFormat(format: EngineLogFormat): void;
+    /**
+     * Check if a level will be logged
+     */
+    willLog(level: LogLevel): boolean;
+    /**
+     * Get current configuration
+     */
+    getConfig(): Readonly<EngineLoggerConfig>;
+    /**
+     * Check if debug logging is enabled
+     */
+    isDebugEnabled(): boolean;
+    /**
+     * Check if info logging is enabled
+     */
+    isInfoEnabled(): boolean;
+    /**
+     * Check if warn logging is enabled
+     */
+    isWarnEnabled(): boolean;
+    /**
+     * Check if error logging is enabled
+     */
+    isErrorEnabled(): boolean;
+}
+/**
+ * Create a logger instance from engine config
+ */
+export declare function createEngineLogger(logLevel: 'debug' | 'info' | 'warn' | 'error' | 'silent', verbose?: boolean): EngineLogger | null;
+//# sourceMappingURL=EngineLogger.d.ts.map

package/dist/core/EngineLogger.d.ts.map

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

package/dist/core/EngineLogger.js

@@ -0,0 +1,252 @@
+/**
+ * Engine Logger
+ *
+ * Provides structured logging for the Orbyt Engine using ecosystem-core utilities.
+ * Supports multiple output formats and log levels with proper filtering.
+ *
+ * Features:
+ * - Severity-based log level filtering using LogLevelSeverity
+ * - Multiple output formats (pretty, text, json, structured)
+ * - Color support with ANSI codes
+ * - Context and error tracking
+ * - Performance measurement with automatic severity adjustment
+ * - Efficient level comparison using numeric severity
+ *
+ * @module core
+ */
+import { LogLevel, LogLevelSeverity, formatLog, createLogEntry, shouldLog, } from '@dev-ecosystem/core';
+/**
+ * Engine Logger
+ *
+ * Wraps ecosystem-core logging utilities with engine-specific configuration.
+ */
+export class EngineLogger {
+    config;
+    formatOptions;
+    constructor(config) {
+        this.config = {
+            level: config.level,
+            format: config.format || 'text',
+            colors: config.colors ?? true,
+            timestamp: config.timestamp ?? true,
+            source: config.source || 'Orbyt',
+        };
+        this.formatOptions = {
+            format: this.config.format,
+            colors: this.config.colors,
+            timestamp: this.config.timestamp,
+            includeSource: true,
+        };
+    }
+    /**
+     * Log a debug message
+     */
+    debug(message, context) {
+        this.log(LogLevel.DEBUG, message, context);
+    }
+    /**
+     * Log an info message
+     */
+    info(message, context) {
+        this.log(LogLevel.INFO, message, context);
+    }
+    /**
+     * Log a warning message
+     */
+    warn(message, context) {
+        this.log(LogLevel.WARN, message, context);
+    }
+    /**
+     * Log an error message
+     */
+    error(message, error, context) {
+        this.log(LogLevel.ERROR, message, context, error);
+    }
+    /**
+     * Log a fatal error message
+     */
+    fatal(message, error, context) {
+        this.log(LogLevel.FATAL, message, context, error);
+    }
+    /**
+     * Log with a custom level
+     */
+    logWithLevel(level, message, context) {
+        this.log(level, message, context);
+    }
+    /**
+     * Log only if severity meets minimum threshold
+     */
+    logIfSeverity(minSeverity, level, message, context) {
+        if (LogLevelSeverity[level] >= minSeverity) {
+            this.log(level, message, context);
+        }
+    }
+    /**
+     * Measure and log execution time with appropriate log level based on duration
+     */
+    async measureExecution(label, fn, thresholds) {
+        const start = Date.now();
+        try {
+            const result = await fn();
+            const duration = Date.now() - start;
+            // Choose log level based on duration thresholds
+            let level = LogLevel.DEBUG;
+            if (thresholds?.error && duration > thresholds.error) {
+                level = LogLevel.ERROR;
+            }
+            else if (thresholds?.warn && duration > thresholds.warn) {
+                level = LogLevel.WARN;
+            }
+            else {
+                level = LogLevel.INFO;
+            }
+            this.log(level, `${label} completed`, { duration: `${duration}ms` });
+            return result;
+        }
+        catch (error) {
+            const duration = Date.now() - start;
+            this.log(LogLevel.ERROR, `${label} failed`, { duration: `${duration}ms` }, error instanceof Error ? error : new Error(String(error)));
+            throw error;
+        }
+    }
+    /**
+     * Internal log method
+     */
+    log(level, message, context, error) {
+        // Check if this level should be logged (using severity for better performance)
+        if (!this.shouldLogLevel(level)) {
+            return;
+        }
+        // Create log entry
+        const entry = createLogEntry(level, message, {
+            source: this.config.source,
+            context,
+            error,
+        });
+        // Format and output
+        const formatted = formatLog(entry, this.formatOptions);
+        console.log(formatted);
+    }
+    /**
+     * Check if a level should be logged using severity comparison
+     */
+    shouldLogLevel(level) {
+        return LogLevelSeverity[level] >= LogLevelSeverity[this.config.level];
+    }
+    /**
+     * Check if a level is more severe than another
+     */
+    isMoreSevere(level, compareWith) {
+        return LogLevelSeverity[level] > LogLevelSeverity[compareWith];
+    }
+    /**
+     * Get severity difference between two levels
+     */
+    getSeverityDiff(level1, level2) {
+        return LogLevelSeverity[level1] - LogLevelSeverity[level2];
+    }
+    /**
+     * Get the numeric severity of the current log level
+     */
+    getCurrentSeverity() {
+        return LogLevelSeverity[this.config.level];
+    }
+    /**
+     * Get the numeric severity of a log level
+     */
+    getSeverity(level) {
+        return LogLevelSeverity[level];
+    }
+    /**
+     * Update logger configuration
+     */
+    setLevel(level) {
+        this.config.level = level;
+    }
+    /**
+     * Set level by severity (0-4)
+     */
+    setLevelBySeverity(severity) {
+        const levels = Object.entries(LogLevelSeverity)
+            .find(([_, sev]) => sev === severity);
+        if (levels) {
+            this.config.level = levels[0];
+        }
+    }
+    /**
+     * Update colors setting
+     */
+    setColors(enabled) {
+        this.config.colors = enabled;
+        this.formatOptions.colors = enabled;
+    }
+    /**
+     * Update format
+     */
+    setFormat(format) {
+        this.config.format = format;
+        this.formatOptions.format = format;
+    }
+    /**
+     * Check if a level will be logged
+     */
+    willLog(level) {
+        return shouldLog(level, this.config.level);
+    }
+    /**
+     * Get current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Check if debug logging is enabled
+     */
+    isDebugEnabled() {
+        return this.willLog(LogLevel.DEBUG);
+    }
+    /**
+     * Check if info logging is enabled
+     */
+    isInfoEnabled() {
+        return this.willLog(LogLevel.INFO);
+    }
+    /**
+     * Check if warn logging is enabled
+     */
+    isWarnEnabled() {
+        return this.willLog(LogLevel.WARN);
+    }
+    /**
+     * Check if error logging is enabled
+     */
+    isErrorEnabled() {
+        return this.willLog(LogLevel.ERROR);
+    }
+}
+/**
+ * Create a logger instance from engine config
+ */
+export function createEngineLogger(logLevel, verbose = false) {
+    // Silent mode - no logger
+    if (logLevel === 'silent') {
+        return null;
+    }
+    // Map engine log level to ecosystem LogLevel
+    const levelMap = {
+        debug: LogLevel.DEBUG,
+        info: LogLevel.INFO,
+        warn: LogLevel.WARN,
+        error: LogLevel.ERROR,
+    };
+    const level = levelMap[logLevel] || LogLevel.INFO;
+    return new EngineLogger({
+        level,
+        format: verbose ? 'pretty' : 'text',
+        colors: true,
+        timestamp: false, // Engine adds its own prefix
+        source: 'Orbyt',
+    });
+}
+//# sourceMappingURL=EngineLogger.js.map

package/dist/core/EngineLogger.js.map

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

package/dist/core/index.d.ts

@@ -1,4 +1,5 @@
 export * from './EngineConfig.js';
 export * from './EngineContext.js';
 export * from './OrbytEngine.js';
+export * from './EngineLogger.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/core/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/core/index.js

@@ -1,4 +1,5 @@
 export * from './EngineConfig.js';
 export * from './EngineContext.js';
 export * from './OrbytEngine.js';
+export * from './EngineLogger.js';
 //# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/parser/SchemaValidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SchemaValidator.d.ts","sourceRoot":"","sources":["../../src/parser/SchemaValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAML,UAAU,EAEX,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,qBAAqB;IA2B5D;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IA0EpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAkBnC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAwChC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO;IAS7C;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,GAAG;QACtC,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,qBAAqB,CAAC;QAC7B,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB;CAmBF"}
+{"version":3,"file":"SchemaValidator.d.ts","sourceRoot":"","sources":["../../src/parser/SchemaValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACtF,OAAO,EAML,UAAU,EAEX,MAAM,oBAAoB,CAAC;AAE5B;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;;OAMG;IACH,MAAM,CAAC,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,qBAAqB;IA2B5D;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAyFpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAkBnC;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,iBAAiB;IAwChC;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,OAAO,GAAG,OAAO;IAS7C;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,OAAO,GAAG;QACtC,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,qBAAqB,CAAC;QAC7B,KAAK,CAAC,EAAE,UAAU,CAAC;KACpB;CAmBF"}

package/dist/parser/SchemaValidator.js

@@ -53,6 +53,13 @@ export class SchemaValidator {
         if (!obj || typeof obj !== 'object') {
             return;
         }
+        // Free-form field paths - these can contain any user-defined keys
+        const FREE_FORM_PATHS = ['annotations', 'context', 'secrets', 'inputs'];
+        const isFreeFormPath = FREE_FORM_PATHS.some(fp => path === fp || path.endsWith('.' + fp));
+        // Skip validation for free-form paths (user can define any fields)
+        if (isFreeFormPath) {
+            return;
+        }
         const validFields = getValidFields(path);
         const actualFields = Object.keys(obj);
         for (const field of actualFields) {
@@ -85,10 +92,15 @@ export class SchemaValidator {
                 });
             }
             // Recursively validate nested objects
+            // Skip validation for free-form fields (user-defined content)
+            const FREE_FORM_FIELDS = ['annotations', 'context', 'with', 'outputs', 'env', 'secrets', 'inputs'];
             const value = obj[field];
             if (value && typeof value === 'object' && !Array.isArray(value)) {
-                const nestedPath = path === 'root' ? field : `${path}.${field}`;
-                this.validateUnknownFields(value, nestedPath);
+                // Don't validate contents of free-form fields (they can contain any keys)
+                if (!FREE_FORM_FIELDS.includes(field)) {
+                    const nestedPath = path === 'root' ? field : `${path}.${field}`;
+                    this.validateUnknownFields(value, nestedPath);
+                }
             }
             // Validate array items (steps, triggers, etc.)
             if (Array.isArray(value)) {

package/dist/parser/SchemaValidator.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orbytautomation/engine",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Orbyt - Automation Engine Framework",
   "type": "module",
   "main": "./dist/index.js",
@@ -39,8 +39,9 @@
     "node": ">=22.0.0"
   },
   "dependencies": {
-    "@dev-ecosystem/core": "^0.3.1",
+    "@dev-ecosystem/core": "^0.4.0",
     "node-cron": "^4.2.1",
+    "yaml": "^2.8.2",
     "zod": "^4.3.6"
   },
   "devDependencies": {

package/test-security-annotations.yaml

@@ -1,20 +0,0 @@
-version: "1.0"
-kind: workflow
-
-metadata:
-  name: Security Test - Reserved Annotation
-  description: Attempts to use reserved annotation namespaces
-
-annotations:
-  # ❌ INVALID: Reserved annotation prefixes
-  engine.version: "fake-1.0"
-  system.override: "attempt"
-  internal.bypass: true
-  ai.intent: "data-pipeline"  # This one is OK
-
-workflow:
-  steps:
-    - id: test-step
-      uses: shell.exec
-      with:
-        command: echo "Should not execute"

package/test-security-context.yaml

@@ -1,21 +0,0 @@
-version: "1.0"
-kind: workflow
-
-metadata:
-  name: Security Test - Reserved Context Field
-  description: Attempts to set reserved fields in context
-
-context:
-  # ❌ INVALID: Reserved fields in context
-  _internal:
-    hack: "attempt"
-  _billing:
-    free: true
-  myData: "this is allowed"
-
-workflow:
-  steps:
-    - id: test-step
-      uses: shell.exec
-      with:
-        command: echo "Should not execute"

package/test-security.mjs

@@ -1,148 +0,0 @@
-#!/usr/bin/env node
-/**
- * Security Validation Test
- * 
- * This script tests that the engine REJECTS workflows with reserved fields
- * using the new WorkflowLoader architecture.
- * 
- * Architecture:
- * - WorkflowLoader handles file I/O and parsing (utility layer)
- * - Engine receives validated objects (execution layer)
- * - This test acts as a CLI would (interface layer)
- */
-
-import { OrbytEngine, WorkflowLoader } from './dist/index.js';
-
-/**
- * Test a workflow that should be REJECTED due to security violations
- */
-async function testSecurityViolation(engine, testFile, description) {
-  console.log(`\n📝 ${description}`);
-  console.log('-'.repeat(60));
-  
-  try {
-    const workflow = await WorkflowLoader.fromFile(testFile);
-    await engine.run(workflow);
-    
-    console.log('\n❌ SECURITY FAILURE: Workflow was NOT rejected!');
-    console.log(`   File: ${testFile}`);
-    console.log('   Reserved fields were accepted. This is a security vulnerability.');
-    return false;
-  } catch (error) {
-    if (error.message.includes('SECURITY VIOLATION') || error.message.includes('reserved')) {
-      console.log('\n✅ SUCCESS: Workflow correctly rejected!');
-      console.log(`\nError details:`);
-      console.log(error.message);
-      return true;
-    } else {
-      console.log('\n⚠️  Workflow failed but not due to security validation:');
-      console.log(error.message);
-      console.log('\nStack:');
-      console.log(error.stack);
-      return false;
-    }
-  }
-}
-
-/**
- * Test a workflow that should PASS (no security violations)
- */
-async function testValidWorkflow(engine, testFile, description) {
-  console.log(`\n📝 ${description}`);
-  console.log('-'.repeat(60));
-  
-  try {
-    const workflow = await WorkflowLoader.fromFile(testFile);
-    await engine.run(workflow);
-    console.log('\n✅ SUCCESS: Valid workflow executed!');
-    return true;
-  } catch (error) {
-    console.log('\n❌ FAILURE: Valid workflow was rejected!');
-    console.log(error.message);
-    console.log('\nStack:');
-    console.log(error.stack);
-    return false;
-  }
-}
-
-async function testSecurityValidation() {
-  console.log('🔒 Security Validation Test Suite');
-  console.log('='.repeat(60));
-  console.log('\nTesting WorkflowLoader + OrbytEngine architecture');
-  console.log('Goal: Ensure 0% chance of reserved field manipulation\n');
-  
-  const engine = new OrbytEngine({
-    logLevel: 'silent'
-  });
-  
-  const results = [];
-  
-  // Test 1: Root-level reserved fields
-  results.push(await testSecurityViolation(
-    engine,
-    './test-security.yaml',
-    'Test 1: Reserved fields at root level (should REJECT)'
-  ));
-  
-  console.log('\n' + '='.repeat(60));
-  
-  // Test 2: Context-level reserved fields
-  results.push(await testSecurityViolation(
-    engine,
-    './test-security-context.yaml',
-    'Test 2: Reserved fields in context (should REJECT)'
-  ));
-  
-  console.log('\n' + '='.repeat(60));
-  
-  // Test 3: Reserved annotation prefixes
-  results.push(await testSecurityViolation(
-    engine,
-    './test-security-annotations.yaml',
-    'Test 3: Reserved annotation prefixes (should REJECT)'
-  ));
-  
-  console.log('\n' + '='.repeat(60));
-  
-  // Test 4: Valid workflow (should pass)
-  results.push(await testValidWorkflow(
-    engine,
-    './test-valid-workflow.yaml',
-    'Test 4: Valid workflow with no violations (should ACCEPT)'
-  ));
-  
-  console.log('\n' + '='.repeat(60));
-  
-  // Summary
-  const passed = results.filter(r => r === true).length;
-  const total = results.length;
-  
-  console.log('\n📊 Test Summary');
-  console.log('='.repeat(60));
-  console.log(`\nPassed: ${passed}/${total}`);
-  
-  if (passed === total) {
-    console.log('\n🎉 All security tests passed!');
-    console.log('\n✓ Reserved fields at root level are blocked');
-    console.log('✓ Reserved fields in context are blocked');
-    console.log('✓ Reserved annotation prefixes are blocked');
-    console.log('✓ Valid workflows execute normally');
-    console.log('\n✅ Security architecture is working correctly!');
-    return true;
-  } else {
-    console.log('\n❌ Some tests failed! Security validation is not working correctly.');
-    return false;
-  }
-}
-
-// Run the test suite
-testSecurityValidation()
-  .then(success => {
-    process.exit(success ? 0 : 1);
-  })
-  .catch(error => {
-    console.error('\n💥 Unexpected error during testing:');
-    console.error(error);
-    process.exit(1);
-  });
-

package/test-security.yaml

@@ -1,19 +0,0 @@
-version: "1.0"
-kind: workflow
-
-metadata:
-  name: Security Test - Reserved Field at Root
-  description: Attempts to set _internal field at workflow root level
-
-# ❌ INVALID: Reserved field at root level
-_internal:
-  usage:
-    stepCount: 999
-    manipulated: true
-
-workflow:
-  steps:
-    - id: test-step
-      uses: shell.exec
-      with:
-        command: echo "This should never execute"

package/test-valid-workflow.yaml

@@ -1,26 +0,0 @@
-version: "1.0"
-kind: workflow
-
-metadata:
-  name: Valid Test Workflow
-  description: A clean workflow with no reserved fields
-
-annotations:
-  ai.intent: "testing"
-  custom.tag: "security-test"
-
-context:
-  testData: "allowed"
-  customField: "also allowed"
-
-workflow:
-  steps:
-    - id: echo-step
-      uses: shell.exec
-      with:
-        command: echo "Hello from valid workflow"
-    
-    - id: success-step
-      uses: shell.exec
-      with:
-        command: echo "Security validation passed!"