@feasibleone/blong-chain 1.9.0 → 1.10.0

package/dist/test-types.d.ts

@@ -0,0 +1,379 @@
+import nodeAssert from 'node:assert';
+declare module 'node:assert' {
+    function snapshot(value?: unknown, name?: string, opts?: {
+        mask?: string[];
+    }): void;
+}
+/**
+ * Type definitions for the Blong parallel test framework
+ */
+/** Minimal logger interface compatible with the framework's ILogger */
+export interface ITestLogger {
+    trace?: (...args: unknown[]) => void;
+    debug?: (...args: unknown[]) => void;
+    info?: (...args: unknown[]) => void;
+    warn?: (...args: unknown[]) => void;
+    error?: (...args: unknown[]) => void;
+    fatal?: (...args: unknown[]) => void;
+}
+/**
+ * Context object passed to test step functions.
+ * All properties except $meta are thenable proxies that must be awaited.
+ */
+export interface ITestContext {
+    /** Meta information - always available directly (not a thenable proxy) */
+    $meta: IMeta;
+    /** Dynamic properties added by completed steps - accessed via thenable proxies */
+    [key: string]: unknown;
+}
+/**
+ * A single test step function
+ * @param assert - Assertion functions from node:assert or tap
+ * @param context - Test context with $meta and outputs from previous steps
+ * @returns The output to be stored in context under the function's name
+ */
+export type StepFunction = (assert: typeof nodeAssert, context: ITestContext) => unknown | Promise<unknown>;
+/**
+ * A snapshot marker — an array of step-name strings placed inside the
+ * steps array. At runtime, when the executor encounters it the relevant steps
+ * are awaited and their results snapshotted into the TAP context.
+ *
+ * - `['*']`            — snapshot ALL completed steps' results into one context object
+ * - `['step1', 'step2']` — snapshot only those specific steps
+ * - `[]`               — sync barrier only, no snapshot (the empty array is the spelling;
+ *                        there is no symbol for it, because inventing one would touch every
+ *                        call site for no gain)
+ *
+ * The array may carry an optional `.name` to give the snapshot a stable name:
+ * ```
+ * const marker = Object.assign(['*'], {name: 'provisioning-complete'});
+ * ```
+ */
+export type SnapshotMarker = string[] & {
+    name?: string;
+};
+/**
+ * Array of test steps. May contain step functions, nested step groups, or
+ * snapshot markers (string arrays; `[]` being a sync barrier).
+ */
+export type StepArray = (StepFunction | StepArray | SnapshotMarker)[] & {
+    name?: string;
+};
+/**
+ * Meta information passed through test execution
+ */
+export interface IMeta {
+    /** Optional concurrency limit for parallel step execution */
+    concurrency?: number;
+    /** Additional metadata properties */
+    [key: string]: unknown;
+}
+/**
+ * Test framework context (e.g., from node:test or tap)
+ * Enables nested test output with automatic indentation
+ */
+export interface ITestFrameworkContext {
+    /** Creates a nested test scope for proper indentation */
+    test: (name: string, fn: (t: unknown) => void | Promise<void>) => unknown;
+    /** Captures a snapshot of a value under the given name */
+    matchSnapshot?: (value: unknown, name: string) => void;
+}
+/**
+ * A thenable proxy that acts as both a Promise and supports property access.
+ * Used for automatic dependency detection in test steps.
+ *
+ * Note: This is a conceptual type. The actual implementation uses Proxy objects
+ * that intercept property access. TypeScript cannot perfectly represent this pattern.
+ */
+export type IThenableProxy<T = unknown> = Promise<T> & {
+    /** Access nested properties, returning more thenable proxies */
+    [key: string]: IThenableProxy<unknown>;
+};
+/**
+ * Promise resolution tracking for a specific context path
+ */
+export interface IPromiseEntry<T = unknown> {
+    /** The actual promise that resolves when the step completes */
+    promise: Promise<T>;
+    /** Function to resolve the promise with a value */
+    resolve: (value: T) => void;
+    /** Function to reject the promise with an error */
+    reject: (error: Error) => void;
+}
+/**
+ * Complete definition of a test step including metadata
+ */
+export interface IStepDefinition {
+    /** The step function to execute */
+    fn: StepFunction;
+    /** The step's display name (function name or custom name) */
+    name: string;
+    /** Source code location where this step was defined */
+    sourceLocation: ISourceLocation;
+    /** Parent group hierarchy */
+    groupPath: string[];
+}
+/**
+ * Source code location information
+ */
+export interface ISourceLocation {
+    /** Absolute file path */
+    file: string;
+    /** Line number (1-indexed) */
+    line: number;
+    /** Column number (1-indexed) */
+    column: number;
+    /** Optional code snippet for context */
+    snippet?: string;
+}
+/**
+ * Graph structure tracking dependencies between test steps
+ */
+export interface IDependencyGraph {
+    /** All steps in the test as graph nodes */
+    nodes: Map<string, IDependencyNode>;
+    /** Dependency relationships between steps */
+    edges: IDependencyEdge[];
+}
+/**
+ * A single node in the dependency graph
+ */
+export interface IDependencyNode {
+    /** Step name (unique identifier) */
+    stepName: string;
+    /** Hierarchy of group names this step belongs to */
+    groupPath: string[];
+    /** When step execution started (timestamp) */
+    startTime?: number;
+    /** When step execution finished (timestamp) */
+    endTime?: number;
+    /** Current execution status */
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    /** Error if step failed */
+    error?: Error;
+}
+/**
+ * An edge representing a dependency relationship
+ */
+export interface IDependencyEdge {
+    /** Step that depends on another step */
+    from: string;
+    /** Step being depended on */
+    to: string;
+    /** Which context property/path was accessed */
+    property: string;
+}
+/**
+ * Overall test execution progress
+ */
+export interface ITestProgress {
+    /** Test name */
+    testName: string;
+    /** Test start time */
+    startTime: number;
+    /** Test end time (when all steps complete) */
+    endTime?: number;
+    /** Overall test status */
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    /** Total number of steps in the test */
+    totalSteps: number;
+    /** Number of completed steps */
+    completedSteps: number;
+    /** Number of failed steps */
+    failedSteps: number;
+    /** Progress details for each step */
+    steps: Map<string, IStepProgress>;
+    /** Group hierarchy information */
+    groups: IGroupProgress[];
+}
+/**
+ * Progress information for a single step
+ */
+export interface IStepProgress {
+    /** Step name */
+    stepName: string;
+    /** Display name (may differ from stepName for reused tests) */
+    displayName: string;
+    /** Group hierarchy path */
+    groupPath: string[];
+    /** Current step status */
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    /** When step started executing */
+    startTime?: number;
+    /** When step finished executing */
+    endTime?: number;
+    /** Total duration (end - start) */
+    duration?: number;
+    /** Time spent waiting in queue before execution */
+    queueTime?: number;
+    /** Time spent actually executing the step function */
+    executionTime?: number;
+    /** Time spent waiting for dependencies to resolve */
+    waitTime?: number;
+    /** Steps this step depends on */
+    dependencies: string[];
+    /** Steps that depend on this step */
+    dependents: string[];
+    /** Source code location */
+    sourceLocation?: ISourceLocation;
+    /** Step output/result */
+    result?: unknown;
+    /** Error information if step failed */
+    error?: IStepError;
+}
+/**
+ * Error information with enhanced context
+ */
+export interface IStepError {
+    /** Error message */
+    message: string;
+    /** Stack trace */
+    stack: string;
+    /** Context snapshot at time of failure */
+    context: Record<string, unknown>;
+}
+/**
+ * Progress information for a group of steps
+ */
+export interface IGroupProgress {
+    /** Group name */
+    groupName: string;
+    /** Hierarchy path */
+    path: string[];
+    /** Group status */
+    status: 'pending' | 'running' | 'completed' | 'failed';
+    /** Step names in this group */
+    steps: string[];
+    /** Total steps in group */
+    totalSteps: number;
+    /** Completed steps in group */
+    completedSteps: number;
+}
+/**
+ * Detailed timing information for a step
+ */
+export interface IStepLatency {
+    /** Step name */
+    stepName: string;
+    /** When step was added to queue */
+    queuedAt: number;
+    /** When step execution started */
+    startedAt?: number;
+    /** When step execution completed */
+    completedAt?: number;
+    /** Time from queue entry to execution start */
+    queueTime: number;
+    /** Time spent waiting for dependencies */
+    waitTime: number;
+    /** Actual execution time (excludes wait time) */
+    executionTime: number;
+    /** Total time from queue to completion */
+    totalTime: number;
+}
+/**
+ * Aggregate latency metrics for entire test
+ */
+export interface ITestLatency {
+    /** Test name */
+    testName: string;
+    /** Total wall-clock duration */
+    totalDuration: number;
+    /** Latency details for each step */
+    steps: Map<string, IStepLatency>;
+    /** Steps on the critical path (longest dependency chain) */
+    criticalPath: string[];
+    /** Ratio of parallel efficiency (total step time / wall clock time) */
+    parallelEfficiency: number;
+    /** Steps that blocked the most other steps */
+    bottlenecks: Array<{
+        stepName: string;
+        executionTime: number;
+        blockedSteps: string[];
+    }>;
+}
+/**
+ * Event emitter interface for progress notifications
+ */
+export interface ITestEvents {
+    'test:start': (progress: ITestProgress) => void;
+    'test:end': (progress: ITestProgress) => void;
+    'step:start': (stepName: string, progress: IStepProgress) => void;
+    'step:end': (stepName: string, progress: IStepProgress) => void;
+    'step:error': (stepName: string, error: Error, progress: IStepProgress) => void;
+}
+/**
+ * Configuration for the parallel test executor
+ */
+export interface ITestExecutorConfig {
+    /** Maximum number of steps to run in parallel */
+    concurrency?: number;
+    /** Whether to capture stack traces (performance impact) */
+    captureStackTraces?: boolean;
+    /** Test framework to use (tap, node:test, etc.) */
+    framework?: unknown;
+    /** Logger instance for reporting step failures */
+    log?: ITestLogger;
+    /**
+     * Chain-level mask paths. Applied to ALL snapshot operations in this chain:
+     * `autoSnapshot`, `assert.snapshot()`, and snapshot markers.
+     *
+     * Supports:
+     * - Simple name: `'id'` — masks the `id` field in the snapshotted value
+     * - Dot-path: `'user.id'` — masks a nested field
+     * - Wildcard prefix: `'*.id'` — masks `id` inside every direct child of the
+     *   snapshotted object (useful for context-level snapshots where each child
+     *   is a step result)
+     *
+     * Per-call `{mask: [...]}` options are merged on top of this chain-level mask.
+     */
+    mask?: string[];
+    /**
+     * When `true`, automatically snapshot every step's return value under the
+     * step's function name after it completes. The chain-level `mask` is applied
+     * before snapshotting. No `assert.snapshot()` calls are needed in step
+     * functions — the framework captures everything automatically.
+     *
+     * Requires a TAP (or compatible) test context to be passed to `execute()`.
+     */
+    autoSnapshot?: boolean;
+    /**
+     * @deprecated Use `mask` (string array) instead.
+     * Custom masking function for advanced scenarios not covered by `mask`.
+     * When both are provided, `maskFn` is used and `mask` is passed to it.
+     */
+    maskFn?: (value: unknown, paths: string[]) => unknown;
+    /**
+     * Automatic rerun configuration for failing steps (Phase 1).
+     *
+     * When enabled, a step that throws an error is retried up to `maxRetries`
+     * times before being reported as failed. This is useful for flaky tests
+     * caused by race conditions or transient network issues.
+     *
+     * Phase 2 (diagnostic attachment) is not yet implemented.
+     */
+    rerun?: {
+        /** Whether to enable the retry mechanism (default: false) */
+        enabled?: boolean;
+        /**
+         * Maximum number of retry attempts per failing step (default: 1).
+         * Set to 0 to detect failures without retrying.
+         */
+        maxRetries?: number;
+    };
+}
+/**
+ * Test executor interface
+ */
+export interface ITestExecutor {
+    /** Execute test steps */
+    execute(steps: StepArray, $meta: IMeta, testContext?: ITestFrameworkContext): Promise<void>;
+    /** Get current progress snapshot */
+    getProgress(): ITestProgress;
+    /** Get dependency graph */
+    getDependencyGraph(): IDependencyGraph;
+    /** Get latency metrics */
+    getLatencyReport(): ITestLatency;
+    /** Register event listener */
+    on<E extends keyof ITestEvents>(event: E, handler: ITestEvents[E]): void;
+}
+//# sourceMappingURL=test-types.d.ts.map

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

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

package/dist/test-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=test-types.js.map

package/dist/test-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-types.js","sourceRoot":"","sources":["../test-types.ts"],"names":[],"mappings":""}

package/dist/timing-analysis.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=timing-analysis.test.d.ts.map

package/dist/timing-analysis.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing-analysis.test.d.ts","sourceRoot":"","sources":["../timing-analysis.test.ts"],"names":[],"mappings":""}

package/dist/timing-analysis.test.js.map

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

package/index.ts

@@ -371,7 +371,7 @@ function captureSourceLocation(): ISourceLocation {
 const DEFAULT_MAX_RETRIES = 1;
 
 // ============================================================================
-// Masking helpers (also used by assert.snapshot and checkpoint snapshots)
+// Masking helpers (also used by assert.snapshot and snapshot markers)
 // ============================================================================
 
 /**
@@ -542,13 +542,13 @@ export class TestExecutor extends EventEmitter {
     ): Promise<void> {
         const stepPromises: Promise<void>[] = [];
         const namedPromises = new Map<string, Promise<void>>();
-        let checkpointIndex = 0;
+        let snapshotIndex = 0;
 
         for (const step of steps) {
             if (Array.isArray(step)) {
                 // Distinguish by element type:
                 //   [] empty array        → sync barrier (existing behaviour)
-                //   ['*'] / ['s1','s2']  → snapshot checkpoint (new)
+                //   ['*'] / ['s1','s2']  → snapshot marker
                 //   [fn, ...] nested     → nested step group (existing behaviour)
                 if (step.length === 0) {
                     // Sync barrier — wait for all parallel steps in this batch
@@ -558,37 +558,35 @@ export class TestExecutor extends EventEmitter {
                 }
 
                 if (step.every(s => typeof s === 'string')) {
-                    // Snapshot checkpoint: await relevant steps, then snapshot
-                    const checkpoint = step as unknown as string[];
+                    // Snapshot marker: await the relevant steps, then snapshot
+                    const marker = step as unknown as string[];
 
-                    if (checkpoint.length === 1 && checkpoint[0] === '*') {
+                    if (marker.length === 1 && marker[0] === '*') {
                         // ['*'] — wait for entire current batch
                         await Promise.all(stepPromises);
                         stepPromises.length = 0;
                     } else {
                         // ['step1','step2'] — wait only for the named steps
-                        const namedToWait = checkpoint
+                        const namedToWait = marker
                             .map(name => namedPromises.get(name))
                             .filter((p): p is Promise<void> => p !== undefined);
                         await Promise.all(namedToWait);
                         // stepPromises is NOT cleared — other steps keep running
                     }
                     const cpName =
-                        (checkpoint as {name?: string}).name ??
-                        (checkpoint.length === 1 && checkpoint[0] === '*'
-                            ? `context`
-                            : checkpoint.join('-'));
+                        (marker as {name?: string}).name ??
+                        (marker.length === 1 && marker[0] === '*' ? `context` : marker.join('-'));
                     // Disambiguate when the same name is used more than once
                     const snapshotName =
-                        checkpointIndex === 0 ? cpName : `${cpName}-${checkpointIndex}`;
-                    checkpointIndex++;
+                        snapshotIndex === 0 ? cpName : `${cpName}-${snapshotIndex}`;
+                    snapshotIndex++;
 
                     const stepsToSnapshot =
-                        checkpoint.length === 1 && checkpoint[0] === '*'
+                        marker.length === 1 && marker[0] === '*'
                             ? [...this.progress.steps.entries()]
                                   .filter(([, s]) => s.status === 'completed')
                                   .map(([name]) => name)
-                            : checkpoint.filter(name =>
+                            : marker.filter(name =>
                                   Object.prototype.hasOwnProperty.call(this.realContext, name),
                               );
 
@@ -940,7 +938,7 @@ export class TestExecutor extends EventEmitter {
 
         for (const step of steps) {
             if (Array.isArray(step)) {
-                // Skip checkpoint markers (string-only arrays) — they are not steps
+                // Skip snapshot markers (string-only arrays) — they are not steps
                 if (step.every(s => typeof s === 'string')) continue;
                 // Recursively collect from nested step groups
                 const nested = this._collectStepNames(step as StepArray);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feasibleone/blong-chain",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Parallel testing with automatic dependencies",
   "keywords": [
     "blong",
@@ -24,7 +24,7 @@
     "@types/node": "^24",
     "tap": "^21.6.3",
     "typescript": "^6.0.3",
-    "@feasibleone/blong-dev": "1.4.0"
+    "@feasibleone/blong-dev": "1.6.0"
   },
   "scripts": {
     "build": "heft build --clean",
@@ -33,7 +33,7 @@
     "ci-lint": "blong-dev lint",
     "ci-publish": "node ../../common/scripts/install-run-rush-pnpm.js publish --access public --provenance",
     "ci-test": "blong-dev test '*.test.ts';./test-examples-ci.sh",
-    "test": "tap *.test.ts",
+    "test": "blong-dev test '*.test.ts';./test-examples-ci.sh",
     "test:examples": "node --test dist/examples/*.test.js"
   }
 }

package/test-types.ts

@@ -49,26 +49,28 @@ export type StepFunction = (
 ) => unknown | Promise<unknown>;
 
 /**
- * A snapshot checkpoint — an array of step-name strings placed inside the
- * steps array. At runtime, when the executor encounters it the current batch
- * is awaited and the listed step results are snapshotted into the TAP context.
+ * A snapshot marker — an array of step-name strings placed inside the
+ * steps array. At runtime, when the executor encounters it the relevant steps
+ * are awaited and their results snapshotted into the TAP context.
  *
  * - `['*']`            — snapshot ALL completed steps' results into one context object
  * - `['step1', 'step2']` — snapshot only those specific steps
- * - `[]`               — sync barrier only, no snapshot (existing behaviour)
+ * - `[]`               — sync barrier only, no snapshot (the empty array is the spelling;
+ *                        there is no symbol for it, because inventing one would touch every
+ *                        call site for no gain)
  *
  * The array may carry an optional `.name` to give the snapshot a stable name:
  * ```
- * const cp = Object.assign(['*'], {name: 'provisioning-complete'});
+ * const marker = Object.assign(['*'], {name: 'provisioning-complete'});
  * ```
  */
-export type CheckpointMarker = string[] & {name?: string};
+export type SnapshotMarker = string[] & {name?: string};
 
 /**
  * Array of test steps. May contain step functions, nested step groups, or
- * checkpoint markers (string arrays).
+ * snapshot markers (string arrays; `[]` being a sync barrier).
  */
-export type StepArray = (StepFunction | StepArray | CheckpointMarker)[] & {name?: string};
+export type StepArray = (StepFunction | StepArray | SnapshotMarker)[] & {name?: string};
 
 /**
  * Meta information passed through test execution
@@ -370,7 +372,7 @@ export interface ITestExecutorConfig {
     log?: ITestLogger;
     /**
      * Chain-level mask paths. Applied to ALL snapshot operations in this chain:
-     * `autoSnapshot`, `assert.snapshot()`, and checkpoint snapshots.
+     * `autoSnapshot`, `assert.snapshot()`, and snapshot markers.
      *
      * Supports:
      * - Simple name: `'id'` — masks the `id` field in the snapshotted value