ppef 1.0.1 → 1.1.0

package/dist/executor/worker-executor.d.ts

@@ -0,0 +1,156 @@
+/**
+ * WorkerExecutor - Core worker logic with dependency injection.
+ *
+ * This class can be tested by injecting mock dependencies,
+ * while worker-entry.ts provides real implementations.
+ */
+import type { EvaluationResult } from "../types/result.js";
+/**
+ * Type definition for a single run configuration
+ */
+export interface RunConfig {
+    runId: string;
+    sutId: string;
+    caseId: string;
+    repetition: number;
+    config: unknown;
+}
+/**
+ * Type definition for executor configuration
+ */
+export interface ExecutorConfig {
+    repetitions: number;
+    seedBase: number;
+    continueOnError: boolean;
+    timeoutMs: number;
+    collectProvenance: boolean;
+}
+/**
+ * Type definition for message sent to worker
+ */
+export interface WorkerMessage {
+    runs: RunConfig[];
+    config: ExecutorConfig;
+}
+/**
+ * Type definition for worker response
+ */
+export interface WorkerResponse {
+    results: EvaluationResult[];
+    errors: {
+        runId: string;
+        error: string;
+    }[];
+}
+/**
+ * Type definition for successful response message
+ */
+export interface WorkerSuccessMessage {
+    type: "done";
+    results: EvaluationResult[];
+    errors: {
+        runId: string;
+        error: string;
+    }[];
+}
+/**
+ * Type definition for error response message
+ */
+export interface WorkerErrorMessage {
+    type: "error";
+    error: string;
+}
+/**
+ * Type definition for any worker message
+ */
+export type WorkerOutputMessage = WorkerSuccessMessage | WorkerErrorMessage;
+/**
+ * Interface for parent port communication
+ */
+export interface IParentPort {
+    on(event: string, listener: (data: unknown) => void): void;
+    postMessage(message: unknown): void;
+}
+/**
+ * Interface for dynamically loaded executor module
+ */
+export interface IExecutorModule {
+    Executor: new (config: ExecutorConfig) => {
+        execute(suts: unknown, cases: unknown, callback: () => unknown): Promise<{
+            results: EvaluationResult[];
+            errors: {
+                runId: string;
+                error: string;
+            }[];
+        }>;
+    };
+}
+/**
+ * Interface for dynamically loaded evaluate module
+ */
+export interface IEvaluateModule {
+    getSutDefinitions(registry: ISutRegistry): unknown;
+    getCaseDefinitions(registry: unknown): unknown;
+}
+/**
+ * Interface for SUT registry
+ */
+export interface ISutRegistry {
+    list(): string[];
+    getFactory(id: string): unknown;
+}
+/**
+ * Interface for dynamically loaded registry module
+ */
+export interface IRegistryModule {
+    registerAllBenchmarkCases(): Promise<unknown>;
+}
+/**
+ * Interface for dynamically loaded SUTs module
+ */
+export interface ISutsModule {
+    registerAllSuts(): void;
+}
+/**
+ * Interface for dynamically loaded datasets module
+ */
+export interface IDatasetsModule {
+    registerBenchmarkDatasets(): Promise<void>;
+}
+/**
+ * Interface for module loader
+ */
+export interface IModuleLoader {
+    loadExecutor(): Promise<IExecutorModule>;
+    loadEvaluate(): Promise<IEvaluateModule>;
+    loadRegistry(): Promise<IRegistryModule>;
+    loadSuts(): Promise<ISutsModule>;
+    loadDatasets(): Promise<IDatasetsModule>;
+}
+/**
+ * WorkerExecutor - Core worker execution logic with injected dependencies.
+ */
+export declare class WorkerExecutor {
+    private readonly parentPort;
+    private readonly moduleLoader;
+    /**
+     * Create a new WorkerExecutor with injected dependencies.
+     * @param parentPort - Communication port to parent thread
+     * @param moduleLoader - Module loader for dynamic imports
+     * @param projectRoot - Root directory for the project (reserved for future use)
+     */
+    constructor(parentPort: IParentPort, moduleLoader: IModuleLoader, projectRoot: string);
+    /**
+     * Start listening for messages from parent thread.
+     */
+    start(): void;
+    /**
+     * Handle an incoming message from the parent thread.
+     */
+    handleMessage(data: unknown): Promise<void>;
+    /**
+     * Execute a batch of runs.
+     */
+    executeBatch(message: WorkerMessage): Promise<WorkerResponse>;
+}
+//# sourceMappingURL=worker-executor.d.ts.map

package/dist/executor/worker-executor.d.ts.map

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

package/dist/executor/worker-executor.js

@@ -0,0 +1,88 @@
+/**
+ * WorkerExecutor - Core worker logic with dependency injection.
+ *
+ * This class can be tested by injecting mock dependencies,
+ * while worker-entry.ts provides real implementations.
+ */
+/**
+ * WorkerExecutor - Core worker execution logic with injected dependencies.
+ */
+export class WorkerExecutor {
+    parentPort;
+    moduleLoader;
+    /**
+     * Create a new WorkerExecutor with injected dependencies.
+     * @param parentPort - Communication port to parent thread
+     * @param moduleLoader - Module loader for dynamic imports
+     * @param projectRoot - Root directory for the project (reserved for future use)
+     */
+    constructor(parentPort, moduleLoader, projectRoot) {
+        this.parentPort = parentPort;
+        this.moduleLoader = moduleLoader;
+        // projectRoot reserved for future use
+        void projectRoot;
+    }
+    /**
+     * Start listening for messages from parent thread.
+     */
+    start() {
+        this.parentPort.on("message", (data) => {
+            void this.handleMessage(data);
+        });
+    }
+    /**
+     * Handle an incoming message from the parent thread.
+     */
+    async handleMessage(data) {
+        const message = data;
+        try {
+            const result = await this.executeBatch(message);
+            this.parentPort.postMessage({ type: "done", ...result });
+        }
+        catch (error) {
+            this.parentPort.postMessage({
+                type: "error",
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    /**
+     * Execute a batch of runs.
+     */
+    async executeBatch(message) {
+        // Import the executor and other dependencies
+        const executorModule = await this.moduleLoader.loadExecutor();
+        const evaluateModule = await this.moduleLoader.loadEvaluate();
+        const registryModule = await this.moduleLoader.loadRegistry();
+        const sutsModule = await this.moduleLoader.loadSuts();
+        const datasetsModule = await this.moduleLoader.loadDatasets();
+        // Register all datasets and SUTs
+        await datasetsModule.registerBenchmarkDatasets();
+        sutsModule.registerAllSuts();
+        const caseRegistry = await registryModule.registerAllBenchmarkCases();
+        const sutRegistry = {
+            list: () => ["degree-prioritised", "standard-bfs", "frontier-balanced", "random-priority"],
+            getFactory: () => {
+                // This would need to be implemented properly
+                return null;
+            },
+        };
+        const suts = evaluateModule.getSutDefinitions(sutRegistry);
+        const cases = evaluateModule.getCaseDefinitions(caseRegistry);
+        // Create executor with no onResult callback (workers don't save checkpoints)
+        const executor = new executorModule.Executor({
+            repetitions: message.config.repetitions,
+            seedBase: message.config.seedBase,
+            continueOnError: message.config.continueOnError,
+            timeoutMs: message.config.timeoutMs,
+            collectProvenance: message.config.collectProvenance,
+        });
+        // Execute the runs
+        const results = await executor.execute(suts, cases, () => ({}));
+        return {
+            results: results.results,
+            errors: results.errors,
+        };
+    }
+}
+//# sourceMappingURL=worker-executor.js.map

package/dist/executor/worker-executor.js.map

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

package/dist/robustness/__tests__/analyzer.unit.test.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Unit tests for Robustness Analyzer
+ *
+ * Tests robustness analysis functions including:
+ * - analyzeRobustnessForMetric
+ * - analyzeRobustnessWithCurve
+ * - compareRobustness
+ * - createRobustnessAnalysis
+ */
+export {};
+//# sourceMappingURL=analyzer.unit.test.d.ts.map

package/dist/robustness/__tests__/analyzer.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.unit.test.d.ts","sourceRoot":"","sources":["../../../src/robustness/__tests__/analyzer.unit.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}