@feasibleone/blong-chain 1.8.2 → 1.10.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## [1.10.0](https://github.com/feasibleone/blong/compare/blong-chain-v1.9.0...blong-chain-v1.10.0) (2026-09-24)
+
+
+### Features
+
+* sequence diagram progress points ([dc5b153](https://github.com/feasibleone/blong/commit/dc5b15327f31698a26a75ec73bdf9a0956a43dd9))
+
+## [1.9.0](https://github.com/feasibleone/blong/compare/blong-chain-v1.8.2...blong-chain-v1.9.0) (2026-09-15)
+
+
+### Features
+
+* **blong-dev:** keep frictions, todos and decisions as verified memory files ([4ca7a3b](https://github.com/feasibleone/blong/commit/4ca7a3be1f8919e0dc121974d3d5ad713883c456))
+* improve CI reports ([93276a2](https://github.com/feasibleone/blong/commit/93276a2745d038da49ae1d521259c3d85654d6cc))
+
 ## [1.8.2](https://github.com/feasibleone/blong/compare/blong-chain-v1.8.1...blong-chain-v1.8.2) (2026-09-10)
 
 

package/README.md

@@ -2,9 +2,9 @@
 
 **Parallel test execution with automatic dependency detection through thenable proxies.**
 
-`blong-chain` is a TypeScript test framework that automatically detects
-dependencies between test steps and executes them in parallel when possible,
-maximizing performance while maintaining correctness.
+`blong-chain` is a TypeScript test framework that automatically detects dependencies between test
+steps and executes them in parallel when possible, maximizing performance while maintaining
+correctness.
 
 ## Key Features
 
@@ -14,10 +14,8 @@ maximizing performance while maintaining correctness.
 - 🎯 **Thenable Proxies** - Natural async/await syntax for step dependencies
 - 📈 **Performance Metrics** - Queue time, execution time, and critical path analysis
 - 🌳 **Nested Groups** - Hierarchical test organization with proper indentation
-- 🔧 **Error Handling** - Graceful failure with continued execution of
-  independent steps
-- 🧪 **Test Framework Integration** - Works seamlessly with node:test, tap,
-  and others
+- 🔧 **Error Handling** - Graceful failure with continued execution of independent steps
+- 🧪 **Test Framework Integration** - Works seamlessly with node:test, tap, and others
 
 ## Installation
 
@@ -32,7 +30,7 @@ import {TestExecutor} from '@feasibleone/blong-chain';
 import assert from 'node:assert/strict';
 import {test} from 'node:test';
 
-test('parallel execution example', async (t) => {
+test('parallel execution example', async t => {
     const executor = new TestExecutor({concurrency: 10});
 
     const steps = [
@@ -69,8 +67,7 @@ test('parallel execution example', async (t) => {
 
 ### Thenable Proxies
 
-Steps access previous results through thenable proxies that automatically track
-dependencies:
+Steps access previous results through thenable proxies that automatically track dependencies:
 
 ```typescript
 // Pattern 1: Direct await
@@ -89,7 +86,14 @@ async function step3(assert, {previousStep}) {
 }
 
 // Pattern 4: Deep destructuring
-async function step4(assert, {previousStep: {user: {name}}}) {
+async function step4(
+    assert,
+    {
+        previousStep: {
+            user: {name},
+        },
+    },
+) {
     const userName = await name;
 }
 ```
@@ -155,23 +159,37 @@ Organize steps into hierarchical groups for better structure and output:
 
 ```typescript
 const databaseSetup = [
-    async function connect() { return {connected: true}; },
-    async function createSchema() { return {created: true}; },
-    async function seedData() { return {users: []}; },
+    async function connect() {
+        return {connected: true};
+    },
+    async function createSchema() {
+        return {created: true};
+    },
+    async function seedData() {
+        return {users: []};
+    },
 ] as any;
 databaseSetup.name = 'Database Setup';
 
 const apiTests = [
-    async function testEndpoint1() { return {status: 200}; },
-    async function testEndpoint2() { return {status: 200}; },
+    async function testEndpoint1() {
+        return {status: 200};
+    },
+    async function testEndpoint2() {
+        return {status: 200};
+    },
 ] as any;
 apiTests.name = 'API Tests';
 
 const steps = [
-    async function initialize() { return {ready: true}; },
-    databaseSetup,  // Nested group
-    apiTests,       // Nested group
-    async function cleanup() { return {done: true}; },
+    async function initialize() {
+        return {ready: true};
+    },
+    databaseSetup, // Nested group
+    apiTests, // Nested group
+    async function cleanup() {
+        return {done: true};
+    },
 ];
 
 await executor.execute(steps, {}, t);
@@ -194,9 +212,13 @@ await executor.execute(steps, {}, t);
   ✔ cleanup
 ```
 
-### Checkpoints (Synchronization Barriers)
+### Sync Barriers
+
+Use empty arrays `[]` as sync barriers to synchronize parallel execution. All steps before a barrier
+must complete before any steps after it begin:
 
-Use empty arrays `[]` as checkpoints to synchronize parallel execution. All steps before a checkpoint must complete before any steps after it begin:
+(A _snapshot marker_ — `snapshot('name', ...steps)` — is a different thing: it waits for steps
+**and** snapshots their results. A sync barrier snapshots nothing.)
 
 ```typescript
 const steps = [
@@ -216,7 +238,7 @@ const steps = [
         return {loggerReady: true};
     },
 
-    // Checkpoint: Wait for all Phase 1 steps to complete
+    // Sync barrier: Wait for all Phase 1 steps to complete
     [],
 
     // Phase 2: These run in parallel, but only after Phase 1 completes
@@ -230,7 +252,7 @@ const steps = [
         return await fetchProducts(config.apiUrl);
     },
 
-    // Another checkpoint
+    // Another barrier
     [],
 
     // Phase 3: Runs only after Phase 2 completes
@@ -243,6 +265,7 @@ const steps = [
 ```
 
 **Use Cases:**
+
 - **Phased execution**: Separate initialization, data loading, processing, and cleanup phases
 - **Resource management**: Ensure all resources are ready before proceeding
 - **Testing stages**: Complete all setup before running tests, then cleanup
@@ -255,7 +278,7 @@ Monitor test execution in real-time:
 ```typescript
 const executor = new TestExecutor({concurrency: 10});
 
-executor.on('test:start', (progress) => {
+executor.on('test:start', progress => {
     console.log('Test started:', progress.testName);
 });
 
@@ -314,9 +337,7 @@ console.log(`Critical path: ${latency.criticalPath.join(' → ')}`);
 
 // View bottlenecks
 for (const bottleneck of latency.bottlenecks) {
-    console.log(
-        `${bottleneck.stepName} blocked ${bottleneck.blockedSteps.length} steps`
-    );
+    console.log(`${bottleneck.stepName} blocked ${bottleneck.blockedSteps.length} steps`);
 }
 
 // View individual step metrics
@@ -391,7 +412,7 @@ const executor = new TestExecutor({
 ## Real-World Example
 
 ```typescript
-test('e-commerce checkout flow', async (t) => {
+test('e-commerce checkout flow', async t => {
     const executor = new TestExecutor({concurrency: 5});
 
     const steps = [
@@ -421,9 +442,7 @@ test('e-commerce checkout flow', async (t) => {
             return {amount: product.price * 0.08};
         },
 
-        async function calculateTotal(assert, {
-            loadProduct, calculateShipping, calculateTax
-        }) {
+        async function calculateTotal(assert, {loadProduct, calculateShipping, calculateTax}) {
             const product = await loadProduct;
             const shipping = await calculateShipping;
             const tax = await calculateTax;
@@ -438,9 +457,7 @@ test('e-commerce checkout flow', async (t) => {
             };
         },
 
-        async function processPayment(assert, {
-            calculateTotal, validateInventory
-        }) {
+        async function processPayment(assert, {calculateTotal, validateInventory}) {
             const total = await calculateTotal;
             const inventory = await validateInventory;
 
@@ -465,10 +482,14 @@ test('e-commerce checkout flow', async (t) => {
         },
     ];
 
-    await executor.execute(steps, {
-        testId: 'checkout-001',
-        environment: 'test',
-    }, t);
+    await executor.execute(
+        steps,
+        {
+            testId: 'checkout-001',
+            environment: 'test',
+        },
+        t,
+    );
 
     // Verify results
     const progress = executor.getProgress();
@@ -494,8 +515,7 @@ In this example:
 
 - **[SHOWCASE.md](./SHOWCASE.md)** - Comprehensive feature showcase with all patterns
 - **[TESTING.md](./TESTING.md)** - Testing guide and CI integration
-- **[NESTED_TEST_CONTEXT.md](./NESTED_TEST_CONTEXT.md)** - Test framework
-  integration details
+- **[NESTED_TEST_CONTEXT.md](./NESTED_TEST_CONTEXT.md)** - Test framework integration details
 - **[test-types.ts](./test-types.ts)** - Complete TypeScript API documentation
 
 ## Running Tests
@@ -514,17 +534,17 @@ npm run test:all
 
 ## How It Works
 
-1. **Detection Phase**: When you destructure or access `context.stepName`, a
-   thenable proxy is returned
+1. **Detection Phase**: When you destructure or access `context.stepName`, a thenable proxy is
+   returned
 2. **Dependency Tracking**: The access is recorded as a dependency
 3. **Scheduling Phase**: Steps are added to a priority queue based on dependencies
 4. **Execution Phase**: Steps run as soon as all their dependencies complete
 5. **Resolution Phase**: Step results are stored and proxies are resolved
-6. **Checkpoints**: Empty arrays `[]` create synchronization barriers, waiting for
-   all previous steps to complete before continuing
+6. **Sync Barriers**: Empty arrays `[]` create synchronization barriers, waiting for all previous
+   steps to complete before continuing
 
-This creates a dynamic dependency graph that enables maximum parallelization
-while ensuring correctness, with optional synchronization points for phased execution.
+This creates a dynamic dependency graph that enables maximum parallelization while ensuring
+correctness, with optional synchronization points for phased execution.
 
 ## Use Cases
 

package/dist/examples/demo.test.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Demonstration of nested test context with automatic indentation
+ * Run with: node --test demo.test.js
+ */
+export {};
+//# sourceMappingURL=demo.test.d.ts.map

package/dist/examples/demo.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.test.d.ts","sourceRoot":"","sources":["../../examples/demo.test.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/examples/demo.test.js.map

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

package/dist/examples/error-demo.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Demonstration of error reporting in nested test contexts
+ *
+ * This file shows how errors are properly reported with indentation and tracking.
+ * Run with: node --test error-demo.test.js
+ *
+ * You'll see that:
+ * 1. Errors appear in the nested test output with proper indentation
+ * 2. Error details (message, stack trace) are captured
+ * 3. Progress tracking records all error information
+ * 4. Other independent steps continue executing
+ */
+export {};
+//# sourceMappingURL=error-demo.test.d.ts.map

package/dist/examples/error-demo.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-demo.test.d.ts","sourceRoot":"","sources":["../../examples/error-demo.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/examples/error-demo.test.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Parallel Test Executor
+ *
+ * Implements the new parallel test execution framework with:
+ * - Thenable proxies for automatic dependency detection
+ * - Parallel execution with configurable concurrency
+ * - Dependency graph tracking
+ * - Live progress tracking
+ * - Enhanced error reporting
+ * - Latency metrics
+ */
+import { EventEmitter } from 'node:events';
+import type { IDependencyGraph, IMeta, ITestEvents, ITestExecutorConfig, ITestFrameworkContext, ITestLatency, ITestProgress, StepArray } from './test-types.js';
+/**
+ * Main test executor class
+ */
+export declare class TestExecutor extends EventEmitter {
+    private config;
+    private queue;
+    private dependencyTracker;
+    private log?;
+    private progress;
+    private graph;
+    private latencyMetrics;
+    private realContext;
+    private promiseManager;
+    private testContext?;
+    private stepNamesUsed;
+    constructor(config?: ITestExecutorConfig);
+    /**
+     * Executes an array of test steps
+     */
+    execute(steps: StepArray, $meta: IMeta, testContext?: ITestFrameworkContext): Promise<void>;
+    /**
+     * Recursively executes steps, handling both functions and nested arrays
+     */
+    private _executeSteps;
+    /**
+     * Executes a single step function
+     */
+    private _executeStep;
+    /**
+     * Counts total number of steps (including nested)
+     */
+    private _countSteps;
+    /**
+     * Collects all step names (including nested)
+     */
+    private _collectStepNames;
+    /**
+     * Checks for duplicate step names and throws an error if found
+     */
+    private _checkForDuplicateStepName;
+    /**
+     * Applies the chain-level `mask` (and optional per-call `extraPaths`) to
+     * `value`. Returns the original reference unchanged when no masking is
+     * configured. Falls back to the deprecated `maskFn` when supplied.
+     */
+    private _applyMask;
+    /**
+     * Gets the current progress snapshot
+     */
+    getProgress(): ITestProgress;
+    /**
+     * Gets the dependency graph
+     */
+    getDependencyGraph(): IDependencyGraph;
+    /**
+     * Gets latency metrics
+     */
+    getLatencyReport(): ITestLatency;
+    /**
+     * Calculates the critical path (longest dependency chain)
+     */
+    private _calculateCriticalPath;
+    /**
+     * Identifies bottleneck steps that blocked many other steps
+     */
+    private _identifyBottlenecks;
+    /**
+     * Type-safe event emitter
+     */
+    on<E extends keyof ITestEvents>(event: E, handler: ITestEvents[E]): this;
+    emit<E extends keyof ITestEvents>(event: E, ...args: Parameters<ITestEvents[E]>): boolean;
+}
+export type * from './test-types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAC,YAAY,EAAC,MAAM,aAAa,CAAC;AAEzC,OAAO,KAAK,EAER,gBAAgB,EAChB,KAAK,EAOL,WAAW,EACX,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EAEZ,aAAa,EAEb,SAAS,EAEZ,MAAM,iBAAiB,CAAC;AAsXzB;;GAEG;AACH,qBAAa,YAAa,SAAQ,YAAY;IAC1C,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,iBAAiB,CAA2B;IACpD,OAAO,CAAC,GAAG,CAAC,CAAc;IAG1B,OAAO,CAAC,QAAQ,CASd;IAGF,OAAO,CAAC,KAAK,CAGX;IAGF,OAAO,CAAC,cAAc,CAAmC;IAGzD,OAAO,CAAC,WAAW,CAA+B;IAGlD,OAAO,CAAC,cAAc,CAAiB;IAGvC,OAAO,CAAC,WAAW,CAAC,CAAwB;IAG5C,OAAO,CAAC,aAAa,CAAqB;gBAE9B,MAAM,GAAE,mBAAwB;IAqB5C;;OAEG;IACG,OAAO,CACT,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,KAAK,EACZ,WAAW,CAAC,EAAE,qBAAqB,GACpC,OAAO,CAAC,IAAI,CAAC;IAwDhB;;OAEG;YACW,aAAa;IAoH3B;;OAEG;YACW,YAAY;IAmQ1B;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAUlC;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,WAAW,IAAI,aAAa;IAI5B;;OAEG;IACH,kBAAkB,IAAI,gBAAgB;IAItC;;OAEG;IACH,gBAAgB,IAAI,YAAY;IA4BhC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA+C9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA4B5B;;OAEG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI;IAIxE,IAAI,CAAC,CAAC,SAAS,MAAM,WAAW,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO;CAG5F;AAGD,mBAAmB,iBAAiB,CAAC"}