rhachet 1.6.0 → 1.7.1

package/dist/logic/invoke/addAttemptQualifierToOutputPath.test.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_fns_1 = require("test-fns");
+const addAttemptQualifierToOutputPath_1 = require("./addAttemptQualifierToOutputPath");
+describe('addAttemptQualifierToOutputPath', () => {
+    describe('with replacement variable', () => {
+        (0, test_fns_1.given)('a path containing {{attempt}} once', () => {
+            const input = { path: 'dist/out.{{attempt}}.json', attempt: 3 };
+            (0, test_fns_1.when)('qualifying the path', () => {
+                const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                (0, test_fns_1.then)('it replaces the placeholder with i{attempt}', () => {
+                    expect(result).toBe('dist/out.i3.json');
+                });
+            });
+        });
+        (0, test_fns_1.given)('a path containing {{attempt}} multiple times', () => {
+            const input = { path: 'a.{{attempt}}.b.{{attempt}}.c', attempt: 9 };
+            (0, test_fns_1.when)('qualifying the path', () => {
+                const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                (0, test_fns_1.then)('it replaces each occurrence', () => {
+                    expect(result).toBe('a.i9.b.i9.c');
+                });
+            });
+        });
+        (0, test_fns_1.given)('a path with {{attempt}} and dotted directories', () => {
+            const input = { path: 'build.v2/out.{{attempt}}.log', attempt: 11 };
+            (0, test_fns_1.when)('qualifying the path', () => {
+                const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                (0, test_fns_1.then)('it replaces the placeholder in the filename and preserves directories', () => {
+                    expect(result).toBe('build.v2/out.i11.log');
+                });
+            });
+        });
+    });
+    describe('wout replacement variable', () => {
+        describe('with extension', () => {
+            (0, test_fns_1.given)('a simple file with one extension', () => {
+                const input = { path: 'out.json', attempt: 2 };
+                (0, test_fns_1.when)('qualifying the path', () => {
+                    const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                    (0, test_fns_1.then)('it inserts .i{attempt} before the final extension', () => {
+                        expect(result).toBe('out.i2.json');
+                    });
+                });
+            });
+            (0, test_fns_1.given)('a multi-dot basename but a single final extension', () => {
+                const input = { path: 'foo.bar.baz.json', attempt: 7 };
+                (0, test_fns_1.when)('qualifying the path', () => {
+                    const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                    (0, test_fns_1.then)('it inserts only before the final extension', () => {
+                        expect(result).toBe('foo.bar.baz.i7.json');
+                    });
+                });
+            });
+            (0, test_fns_1.given)('a hidden file with an extension (e.g., .env.local)', () => {
+                const input = { path: '.env.local', attempt: 4 };
+                (0, test_fns_1.when)('qualifying the path', () => {
+                    const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                    (0, test_fns_1.then)('it preserves the leading dot and inserts before the final extension', () => {
+                        expect(result).toBe('.env.i4.local'); // if folks dont want this outcome, they can use {{attempt}} replacement var instead
+                    });
+                });
+            });
+            (0, test_fns_1.given)('a dotted directory with a simple filename', () => {
+                const input = { path: 'build.v1/output.json', attempt: 5 };
+                (0, test_fns_1.when)('qualifying the path', () => {
+                    const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                    (0, test_fns_1.then)('it preserves directory dots and inserts before the final extension', () => {
+                        expect(result).toBe('build.v1/output.i5.json');
+                    });
+                });
+            });
+            (0, test_fns_1.given)('attempt number zero (edge numeric case)', () => {
+                const input = { path: 'file.txt', attempt: 0 };
+                (0, test_fns_1.when)('qualifying the path', () => {
+                    const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                    (0, test_fns_1.then)('it renders i0 in the qualified path', () => {
+                        expect(result).toBe('file.i0.txt');
+                    });
+                });
+            });
+        });
+        // explicitly not supported today
+        // todo: should we ever support this? folks can simply use template var replacement if needed. otherwise, seems like an infinite list of extensions to allowlist
+        describe.skip('double extension', () => {
+            (0, test_fns_1.given)('a nested path with .tar.gz', () => {
+                const input = { path: 'build/artifacts/output.tar.gz', attempt: 5 };
+                (0, test_fns_1.when)('qualifying the path', () => {
+                    const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                    (0, test_fns_1.then)('it inserts before the last extension only', () => {
+                        expect(result).toBe('build/artifacts/output.i5.tar.gz');
+                    });
+                });
+            });
+            (0, test_fns_1.given)('multiple dotted directories and a multi-dot filename', () => {
+                const input = {
+                    path: 'releases/2025.09.09/artifact.v2.tar.gz',
+                    attempt: 8,
+                };
+                (0, test_fns_1.when)('qualifying the path', () => {
+                    const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                    (0, test_fns_1.then)('it qualifies before the final extension and keeps directory dots intact', () => {
+                        expect(result).toBe('releases/2025.09.09/artifact.v2.i8.tar.gz');
+                    });
+                });
+            });
+        });
+        describe('no extension', () => {
+            (0, test_fns_1.given)('a regular file with no extension (e.g., README)', () => {
+                const input = { path: 'README', attempt: 1 };
+                (0, test_fns_1.when)('qualifying the path', () => {
+                    const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                    (0, test_fns_1.then)('it suffixes i{attempt}. after the basename', () => {
+                        expect(result).toBe('README.i1');
+                    });
+                });
+            });
+            (0, test_fns_1.given)('a dotfile with no extension (e.g., .env)', () => {
+                const input = { path: '.env', attempt: 7 };
+                (0, test_fns_1.when)('qualifying the path', () => {
+                    const result = (0, addAttemptQualifierToOutputPath_1.addAttemptQualifierToOutputPath)(input);
+                    (0, test_fns_1.then)('it suffixes i{attempt} after the basename while keeping the dotfile root', () => {
+                        expect(result).toBe('.env.i7');
+                    });
+                });
+            });
+        });
+    });
+});
+//# sourceMappingURL=addAttemptQualifierToOutputPath.test.js.map

package/dist/logic/invoke/addAttemptQualifierToOutputPath.test.js.map

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

package/dist/logic/invoke/getRegistriesByOpts.d.ts

@@ -0,0 +1,13 @@
+import { RoleRegistry } from '../../domain/objects';
+import { InvokeOpts } from '../../domain/objects/InvokeOpts';
+/**
+ * .what = get registries from the invocation options declared
+ * .how =
+ *   - lookup the config based on the options
+ *   - grab the registries from the config
+ */
+export declare const getRegistriesByOpts: (input: {
+    opts: InvokeOpts<{
+        config: string;
+    }>;
+}) => Promise<RoleRegistry[]>;

package/dist/logic/invoke/getRegistriesByOpts.js

@@ -0,0 +1,40 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRegistriesByOpts = void 0;
+/**
+ * .what = get registries from the invocation options declared
+ * .how =
+ *   - lookup the config based on the options
+ *   - grab the registries from the config
+ */
+const getRegistriesByOpts = async (input) => {
+    // import the config
+    const config = await Promise.resolve(`${input.opts.config}`).then(s => __importStar(require(s)));
+    // grab the registries
+    return await config.getRoleRegistries();
+};
+exports.getRegistriesByOpts = getRegistriesByOpts;
+//# sourceMappingURL=getRegistriesByOpts.js.map

package/dist/logic/invoke/getRegistriesByOpts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRegistriesByOpts.js","sourceRoot":"","sources":["../../../src/logic/invoke/getRegistriesByOpts.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAGA;;;;;GAKG;AACI,MAAM,mBAAmB,GAAG,KAAK,EAAE,KAEzC,EAA2B,EAAE;IAC5B,oBAAoB;IACpB,MAAM,MAAM,GACV,yBAAa,KAAK,CAAC,IAAI,CAAC,MAAM,uCAAC,CAAC;IAElC,sBAAsB;IACtB,OAAO,MAAM,MAAM,CAAC,iBAAiB,EAAE,CAAC;AAC1C,CAAC,CAAC;AATW,QAAA,mBAAmB,uBAS9B"}

package/dist/logic/invoke/getSkillThread.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSkillThread.test.js","sourceRoot":"","sources":["../../../src/logic/invoke/getSkillThread.test.ts"],"names":[],"mappings":";;AAAA,mDAA0E;AAC1E,uCAAuD;AAGvD,gFAAiF;AACjF,mDAAgD;AAChD,uDAAoD;AAEpD,MAAM,aAAa,GAAG,2CAAsB,CAAC,KAAK,CAKhD;IACA,MAAM,EAAE;QACN,MAAM,EAAE;YACN,MAAM,EAAE,cAAc;YACtB,IAAI,EAAE,oBAAoB;YAC1B,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,QAAQ;SACf;KACF;IACD,MAAM,EAAE,CAAC,KAAU,EAA4C,EAAE,CAC/D,OAAO,KAAK,EAAE,MAAM,KAAK,QAAQ,IAAI,OAAO,KAAK,EAAE,GAAG,KAAK,QAAQ;IACrE,WAAW,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACvB,MAAM,EAAE,IAAA,qBAAS,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;KAC5D,CAAC;CACH,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,IAAA,gBAAK,EAAC,4CAA4C,EAAE,GAAG,EAAE;QACvD,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,CAAC;QAErC,IAAA,eAAI,EACF,iEAAiE,EACjE,GAAG,EAAE;YACH,IAAA,eAAI,EAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;gBAC7D,MAAM,MAAM,GAAG,MAAM,IAAA,iCAAe,EAAC;oBACnC,MAAM;oBACN,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE;iBAC9D,CAAC,CAAC;gBACH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,MAAM,EAAE,IAAA,qBAAS,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;iBAC9D,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CACF,CAAC;QAEF,IAAA,eAAI,EAAC,mCAAmC,EAAE,GAAG,EAAE;YAC7C,IAAA,eAAI,EAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;gBACjD,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAChC,IAAA,iCAAe,EAAC;oBACd,MAAM;oBACN,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,EAAS,EAAE;iBACvC,CAAC,CACH,CAAC;gBACF,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,gCAAe,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,4DAA4D,EAAE,GAAG,EAAE;YACtE,IAAA,eAAI,EAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;gBAC7D,MAAM,MAAM,GAAG,MAAM,IAAA,iCAAe,EAAC;oBACnC,MAAM;oBACN,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,EAAE,QAAQ,EAAE,EAAE,EAAE;iBACrE,CAAC,CAAC;gBACH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,MAAM,EAAE,IAAA,qBAAS,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;iBAC7D,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,yDAAyD,EAAE,GAAG,EAAE;YACnE,IAAA,eAAI,EAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;gBAC7D,MAAM,MAAM,GAAG,MAAM,IAAA,iCAAe,EAAC;oBACnC,MAAM;oBACN,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC,EAAE,aAAa,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE;iBAClE,CAAC,CAAC;gBACH,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;oBACrB,MAAM,EAAE,IAAA,qBAAS,EAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;iBAC7D,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,6CAA6C,EAAE,GAAG,EAAE;YACvD,IAAA,eAAI,EAAC,oDAAoD,EAAE,KAAK,IAAI,EAAE;gBACpE,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAChC,IAAA,iCAAe,EAAC;oBACd,MAAM;oBACN,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,gBAAgB,EAAE,EAAE,EAAE;iBACtD,CAAC,CACH,CAAC;gBACF,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,gCAAe,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,wDAAwD,EAAE,GAAG,EAAE;YAClE,IAAA,eAAI,EAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;gBACjE,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAChC,IAAA,iCAAe,EAAC;oBACd,MAAM;oBACN,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE;iBACnD,CAAC,CACH,CAAC;gBACF,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,gCAAe,CAAC,CAAC;gBAC9C,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;YACjD,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,IAAA,gBAAK,EAAC,iDAAiD,EAAE,GAAG,EAAE;QAC5D,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,CAAC;YACjC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,CAAQ;SAC7B,CAAC,CAAC;QAEH,IAAA,eAAI,EACF,gEAAgE,EAChE,GAAG,EAAE;YACH,IAAA,eAAI,EAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;gBACzD,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAChC,IAAA,iCAAe,EAAC;oBACd,MAAM;oBACN,IAAI,EAAE;wBACJ,MAAM,EAAE;4BACN,IAAI,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,aAAa,EAAE;yBACnD;qBACF;iBACF,CAAC,CACH,CAAC;gBACF,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,wCAAuB,CAAC,CAAC;YACxD,CAAC,CAAC,CAAC;QACL,CAAC,CACF,CAAC;QAEF,IAAA,eAAI,EACF,gEAAgE,EAChE,GAAG,EAAE;YACH,IAAA,eAAI,EAAC,iCAAiC,EAAE,KAAK,IAAI,EAAE;gBACjD,MAAM,KAAK,GAAG,MAAM,IAAA,mBAAQ,EAAC,GAAG,EAAE,CAChC,IAAA,iCAAe,EAAC;oBACd,MAAM;oBACN,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,WAAW,EAAE,EAAE;iBAC7D,CAAC,CACH,CAAC;gBACF,MAAM,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,gCAAe,CAAC,CAAC;YAChD,CAAC,CAAC,CAAC;QACL,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"getSkillThread.test.js","sourceRoot":"","sources":["../../../src/logic/invoke/getSkillThread.test.ts"],"names":[],"mappings":"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"}

package/dist/logic/invoke/getSkillThreads.d.ts

@@ -1,5 +1,6 @@
 import { PickOne } from 'type-fns';
 import { Threads } from '../../domain/objects';
+import { InvokeOpts } from '../../domain/objects/InvokeOpts';
 import { RoleSkillThreadsGetter } from '../../domain/objects/RoleSkillArgGetter';
 /**
  * .what = hydrates skill threads using either passin or lookup mode
@@ -10,7 +11,9 @@ export declare const getSkillThreads: <TOutput extends Threads<any>, TVars exten
     from: PickOne<{
         passin: TVars;
         lookup: {
-            argv: Record<string, string>;
+            argv: InvokeOpts<{
+                ask: string;
+            }>;
         };
     }>;
 }) => Promise<TOutput>;

package/dist/logic/invoke/getSkillThreads.js

@@ -27,7 +27,7 @@ const getSkillThreads = async (input) => {
         for (const [key, spec] of Object.entries(getter.lookup)) {
             const val = argv[key] ?? (spec.char ? argv[spec.char] : undefined);
             if (val !== undefined)
-                collected[key] = val;
+                collected[key] = String(val);
             if (val === undefined && !spec.type.startsWith('?'))
                 helpful_errors_1.BadRequestError.throw(`missing required arg --${key} (-${spec.char})`, {
                     key,

package/dist/logic/invoke/getSkillThreads.js.map

@@ -1 +1 @@
-{"version":3,"file":"getSkillThreads.js","sourceRoot":"","sources":["../../../src/logic/invoke/getSkillThreads.ts"],"names":[],"mappings":";;;AAAA,mDAA0E;AAM1E;;;GAGG;AACI,MAAM,eAAe,GAAG,KAAK,EAGlC,KAMD,EAAoB,EAAE;IACrB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAE/B,sBAAsB;IACtB,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;YAC7B,gCAAe,CAAC,KAAK,CACnB,kDAAkD,EAClD,EAAE,IAAI,EAAE,CACT,CAAC;QACJ,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,sBAAsB;IACtB,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAE9B,+DAA+D;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;QACrB,IAAI,CAAC,GAAG;YACN,gCAAe,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtE,sCAAsC;QACtC,MAAM,SAAS,GAA2B,EAAE,GAAG,EAAE,CAAC;QAElD,8BAA8B;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACnE,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;YAC5C,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBACjD,gCAAe,CAAC,KAAK,CAAC,0BAA0B,GAAG,MAAM,IAAI,CAAC,IAAI,GAAG,EAAE;oBACrE,GAAG;oBACH,IAAI;iBACL,CAAC,CAAC;QACP,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;YAC3B,wCAAuB,CAAC,KAAK,CAC3B,+FAA+F,EAC/F,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;QAEJ,cAAc;QACd,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,IAAI,wCAAuB,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1E,CAAC,CAAC;AAzDW,QAAA,eAAe,mBAyD1B"}
+{"version":3,"file":"getSkillThreads.js","sourceRoot":"","sources":["../../../src/logic/invoke/getSkillThreads.ts"],"names":[],"mappings":";;;AAAA,mDAA0E;AAO1E;;;GAGG;AACI,MAAM,eAAe,GAAG,KAAK,EAGlC,KAMD,EAAoB,EAAE;IACrB,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IAE/B,sBAAsB;IACtB,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;YAC7B,gCAAe,CAAC,KAAK,CACnB,kDAAkD,EAClD,EAAE,IAAI,EAAE,CACT,CAAC;QACJ,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,sBAAsB;IACtB,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;QAE9B,+DAA+D;QAC/D,MAAM,GAAG,GAAW,IAAI,CAAC,GAAG,CAAC;QAC7B,IAAI,CAAC,GAAG;YACN,gCAAe,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAEtE,sCAAsC;QACtC,MAAM,SAAS,GAA2B,EAAE,GAAG,EAAE,CAAC;QAElD,8BAA8B;QAC9B,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACxD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACnE,IAAI,GAAG,KAAK,SAAS;gBAAE,SAAS,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACpD,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBACjD,gCAAe,CAAC,KAAK,CAAC,0BAA0B,GAAG,MAAM,IAAI,CAAC,IAAI,GAAG,EAAE;oBACrE,GAAG;oBACH,IAAI;iBACL,CAAC,CAAC;QACP,CAAC;QAED,yBAAyB;QACzB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;YAC3B,wCAAuB,CAAC,KAAK,CAC3B,+FAA+F,EAC/F,EAAE,IAAI,EAAE,SAAS,EAAE,CACpB,CAAC;QAEJ,cAAc;QACd,OAAO,MAAM,MAAM,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,IAAI,wCAAuB,CAAC,yBAAyB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;AAC1E,CAAC,CAAC;AAzDW,QAAA,eAAe,mBAyD1B"}

package/dist/logic/invoke/performInCurrentThread.d.ts

@@ -0,0 +1,16 @@
+import { RoleRegistry } from '../../domain/objects';
+import { InvokeOpts } from '../../domain/objects/InvokeOpts';
+/**
+ * .what = perform a skill within the current thread
+ * .why =
+ *   - this is the default way to perform a skill; contrasted to within isolated threads, for isolated parallelism
+ *   - this is reused within the performance of skills within isolated threads
+ */
+export declare const performInCurrentThread: (input: {
+    opts: InvokeOpts<{
+        ask: string;
+        role?: string;
+        skill?: string;
+    }>;
+    registries: RoleRegistry[];
+}) => Promise<void>;

package/dist/logic/invoke/performInCurrentThread.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performInCurrentThread = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const enweaveOneStitcher_1 = require("../weave/enweaveOneStitcher");
+const assureFindRole_1 = require("./assureFindRole");
+const getSkillContext_1 = require("./getSkillContext");
+const getSkillThreads_1 = require("./getSkillThreads");
+/**
+ * .what = perform a skill within the current thread
+ * .why =
+ *   - this is the default way to perform a skill; contrasted to within isolated threads, for isolated parallelism
+ *   - this is reused within the performance of skills within isolated threads
+ */
+const performInCurrentThread = async (input) => {
+    // lookup the role
+    const role = (0, assureFindRole_1.assureFindRole)({
+        registries: input.registries,
+        slug: input.opts.role ??
+            helpful_errors_1.UnexpectedCodePathError.throw('opts.role slug not defined. why not?', {
+                opts: input.opts,
+            }),
+    });
+    if (!role)
+        helpful_errors_1.BadRequestError.throw(`unknown role "${input.opts.role}"`);
+    // lookup the skill
+    const skill = role.skills.find((s) => s.slug === input.opts.skill);
+    if (!skill)
+        helpful_errors_1.BadRequestError.throw(`unknown skill "${input.opts.skill}" under role "${input.opts.role}"`);
+    // instantiate the threads
+    const threads = await (0, getSkillThreads_1.getSkillThreads)({
+        getter: skill.threads,
+        from: { lookup: { argv: input.opts } },
+    });
+    // instantiate the context
+    const env = process.env;
+    const context = await (0, getSkillContext_1.getSkillContext)({
+        getter: skill.context,
+        from: { lookup: { env } },
+    });
+    // execute the weave
+    console.log('');
+    console.log('');
+    console.log('🎙️  heard');
+    console.log('');
+    console.log(input.opts.ask);
+    console.log('');
+    console.log('🫡  on it!');
+    console.log('');
+    await (0, enweaveOneStitcher_1.enweaveOneStitcher)({
+        stitcher: skill.route,
+        threads,
+    }, context);
+};
+exports.performInCurrentThread = performInCurrentThread;
+//# sourceMappingURL=performInCurrentThread.js.map

package/dist/logic/invoke/performInCurrentThread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performInCurrentThread.js","sourceRoot":"","sources":["../../../src/logic/invoke/performInCurrentThread.ts"],"names":[],"mappings":";;;AAAA,mDAA0E;AAI1E,oEAAiE;AACjE,qDAAkD;AAClD,uDAAoD;AACpD,uDAAoD;AAEpD;;;;;GAKG;AACI,MAAM,sBAAsB,GAAG,KAAK,EAAE,KAO5C,EAAiB,EAAE;IAClB,kBAAkB;IAClB,MAAM,IAAI,GAAG,IAAA,+BAAc,EAAC;QAC1B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,IAAI,EACF,KAAK,CAAC,IAAI,CAAC,IAAI;YACf,wCAAuB,CAAC,KAAK,CAAC,sCAAsC,EAAE;gBACpE,IAAI,EAAE,KAAK,CAAC,IAAI;aACjB,CAAC;KACL,CAAC,CAAC;IACH,IAAI,CAAC,IAAI;QAAE,gCAAe,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC;IAEtE,mBAAmB;IACnB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnE,IAAI,CAAC,KAAK;QACR,gCAAe,CAAC,KAAK,CACnB,kBAAkB,KAAK,CAAC,IAAI,CAAC,KAAK,iBAAiB,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CACtE,CAAC;IAEJ,0BAA0B;IAC1B,MAAM,OAAO,GAAG,MAAM,IAAA,iCAAe,EAAC;QACpC,MAAM,EAAE,KAAK,CAAC,OAAO;QACrB,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE;KACvC,CAAC,CAAC;IAEH,0BAA0B;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAyC,CAAC;IAC9D,MAAM,OAAO,GAAG,MAAM,IAAA,iCAAe,EAAC;QACpC,MAAM,EAAE,KAAK,CAAC,OAAO;QACrB,IAAI,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,EAAE,EAAE;KAC1B,CAAC,CAAC;IAEH,oBAAoB;IACpB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;IAC1B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,MAAM,IAAA,uCAAkB,EACtB;QACE,QAAQ,EAAE,KAAK,CAAC,KAAK;QACrB,OAAO;KACR,EACD,OAAO,CACR,CAAC;AACJ,CAAC,CAAC;AAvDW,QAAA,sBAAsB,0BAuDjC"}

package/dist/logic/invoke/performInIsolatedThread.execute.d.ts

@@ -0,0 +1,14 @@
+import { InvokeOpts } from '../../domain/objects/InvokeOpts';
+/**
+ * .what = executes the performance of a skill within a currently isolated thread
+ *   - looks up the registries from the opts
+ *   - performs in current thread
+ */
+export declare const executePerformInIsolatedThread: (input: {
+    opts: InvokeOpts<{
+        config: string;
+        ask: string;
+        role: string;
+        skill: string;
+    }>;
+}) => Promise<void>;

package/dist/logic/invoke/performInIsolatedThread.execute.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executePerformInIsolatedThread = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const serde_fns_1 = require("serde-fns");
+const getRegistriesByOpts_1 = require("./getRegistriesByOpts");
+const performInCurrentThread_1 = require("./performInCurrentThread");
+/**
+ * .what = executes the performance of a skill within a currently isolated thread
+ *   - looks up the registries from the opts
+ *   - performs in current thread
+ */
+const executePerformInIsolatedThread = async (input) => {
+    // grab the registries for the current options
+    const registries = await (0, getRegistriesByOpts_1.getRegistriesByOpts)({ opts: input.opts });
+    // perform in the current thread
+    await (0, performInCurrentThread_1.performInCurrentThread)({ opts: input.opts, registries });
+};
+exports.executePerformInIsolatedThread = executePerformInIsolatedThread;
+/**
+ * .what = subthread entrypoint
+ * .why =
+ *   - when this module is executed directly, automatically execute the attempt
+ * .how =
+ *   - is main import, run the executor with `workerData`, exit 0/1
+ */
+if (require.main === module)
+    (async () => {
+        // decode the payload from env
+        const payloadEnvVar = process.env.RHACHET_INVOKE_OPTS_PAYLOAD ??
+            helpful_errors_1.BadRequestError.throw('RHACHET_INVOKE_OPTS_PAYLOAD was not defined');
+        const payloadDecoded = (0, serde_fns_1.deSerialJSON)(serde_fns_1.isSerialJSON.assure((0, serde_fns_1.deSerialBase64)(serde_fns_1.isSerialBase64.assure(payloadEnvVar))));
+        if (!payloadDecoded.opts)
+            // basic runtime validation
+            throw new helpful_errors_1.BadRequestError('did not find .opts on payload decoded', {
+                payloadDecoded,
+            });
+        // execute against that payload
+        await (0, exports.executePerformInIsolatedThread)(payloadDecoded);
+    })()
+        .then(() => {
+        process.exit(0);
+    })
+        .catch((error) => {
+        console.error(error);
+        process.exit(1);
+    });
+//# sourceMappingURL=performInIsolatedThread.execute.js.map

package/dist/logic/invoke/performInIsolatedThread.execute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performInIsolatedThread.execute.js","sourceRoot":"","sources":["../../../src/logic/invoke/performInIsolatedThread.execute.ts"],"names":[],"mappings":";;;AACA,mDAAiD;AACjD,yCAKmB;AAGnB,+DAA4D;AAC5D,qEAAkE;AAElE;;;;GAIG;AACI,MAAM,8BAA8B,GAAG,KAAK,EAAE,KAOpD,EAAiB,EAAE;IAClB,8CAA8C;IAC9C,MAAM,UAAU,GAAG,MAAM,IAAA,yCAAmB,EAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAEnE,gCAAgC;IAChC,MAAM,IAAA,+CAAsB,EAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;AACjE,CAAC,CAAC;AAbW,QAAA,8BAA8B,kCAazC;AAEF;;;;;;GAMG;AACH,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM;IACzB,CAAC,KAAK,IAAI,EAAE;QACV,8BAA8B;QAC9B,MAAM,aAAa,GACjB,OAAO,CAAC,GAAG,CAAC,2BAA2B;YACvC,gCAAe,CAAC,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACvE,MAAM,cAAc,GAAG,IAAA,wBAAY,EAGjC,wBAAY,CAAC,MAAM,CAAC,IAAA,0BAAc,EAAC,0BAAc,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAC1E,CAAC;QACF,IAAI,CAAC,cAAc,CAAC,IAAI;YACtB,2BAA2B;YAC3B,MAAM,IAAI,gCAAe,CAAC,uCAAuC,EAAE;gBACjE,cAAc;aACf,CAAC,CAAC;QAEL,+BAA+B;QAC/B,MAAM,IAAA,sCAA8B,EAAC,cAAc,CAAC,CAAC;IACvD,CAAC,CAAC,EAAE;SACD,IAAI,CAAC,GAAG,EAAE;QACT,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;SACD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QACf,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC"}

package/dist/logic/invoke/performInIsolatedThread.invoke.d.ts

@@ -0,0 +1,31 @@
+import { UniDateTimeRange, UniDuration } from '@ehmpathy/uni-time';
+import { InvokeOpts } from '../../domain/objects/InvokeOpts';
+/**
+ * .what = perform a single skill execution in an isolated child thread (subprocess)
+ * .why =
+ *   - isolates side-effects and resources per attempt
+ *   - enables parallel fan-out while keeping logs readable per attempt
+ * .how =
+ *   - invokes a worker which spins up an isolated thread to execute the performance
+ *   - streams the logs to main thread with identifiable prefix, for observability
+ */
+export declare const invokePerformInIsolatedThread: (input: {
+    opts: InvokeOpts<{
+        config: string;
+        attempt: number;
+    }>;
+    peer: {
+        /**
+         * the total number of peer threads that we expect. used to format log prefixes
+         */
+        attempts: number;
+    };
+}) => Promise<{
+    attempt: number;
+    code: number | null;
+    clock: {
+        range: UniDateTimeRange;
+        duration: UniDuration;
+    };
+}>;
+export { invokePerformInIsolatedThread as performInIsolatedThread };

package/dist/logic/invoke/performInIsolatedThread.invoke.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/logic/invoke/performInIsolatedThread.invoke.integration.test.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_path_1 = __importDefault(require("node:path"));
+const test_fns_1 = require("test-fns");
+const directory_1 = require("../../.test/directory");
+const performInIsolatedThread_invoke_1 = require("./performInIsolatedThread.invoke");
+describe('performInIsolatedThread', () => {
+    // observe stdout
+    let stdoutObserved = '';
+    const originalWrite = process.stdout.write;
+    beforeAll(() => {
+        process.stdout.write = (chunk, ...args) => {
+            stdoutObserved += chunk.toString();
+            return originalWrite.call(process.stdout, chunk, ...args);
+        };
+    });
+    afterAll(() => {
+        process.stdout.write = originalWrite;
+    });
+    (0, test_fns_1.given)('a simple demo config', () => {
+        // declare the demo config via path
+        const configPath = node_path_1.default.resolve(directory_1.TEST_FIXTURE_DIRECTORY, './example.use.repo/example.rhachet.use.ts');
+        (0, test_fns_1.when)('asked to perform a skill registered in the config', () => {
+            const opts = {
+                config: configPath,
+                skill: 'echo',
+                role: 'echoer',
+                attempt: 1,
+                ask: 'do it',
+            };
+            (0, test_fns_1.then)('it should successfully execute it', async () => {
+                await (0, performInIsolatedThread_invoke_1.performInIsolatedThread)({ opts, peer: { attempts: 3 } });
+            });
+            (0, test_fns_1.then)('it should have logged with observable prefixes', async () => {
+                expect(stdoutObserved).toContain('○ i1 ›');
+                expect(stdoutObserved).toContain(`🫡  on it!`);
+            });
+        });
+        (0, test_fns_1.when)('asked to perform a skill registered in the config with 100 peer attempts', () => {
+            const opts = {
+                config: configPath,
+                skill: 'echo',
+                role: 'echoer',
+                attempt: 1,
+                ask: 'do it',
+            };
+            (0, test_fns_1.then)('it should successfully execute it', async () => {
+                await (0, performInIsolatedThread_invoke_1.performInIsolatedThread)({ opts, peer: { attempts: 100 } });
+            });
+            (0, test_fns_1.then)('it should have logged with padded observable prefixes', async () => {
+                expect(stdoutObserved).toContain('○ i001 ›');
+            });
+        });
+        (0, test_fns_1.when)('asked to perform a skill registered in the config on attempt number 3', () => {
+            const opts = {
+                config: configPath,
+                skill: 'echo',
+                role: 'echoer',
+                attempt: 3,
+                ask: 'do it',
+            };
+            (0, test_fns_1.then)('it should successfully execute it', async () => {
+                await (0, performInIsolatedThread_invoke_1.performInIsolatedThread)({ opts, peer: { attempts: 3 } });
+            });
+            (0, test_fns_1.then)('it should have logged with padded observable prefixes', async () => {
+                expect(stdoutObserved).toContain('○ i3 ›');
+            });
+        });
+    });
+});
+//# sourceMappingURL=performInIsolatedThread.invoke.integration.test.js.map

package/dist/logic/invoke/performInIsolatedThread.invoke.integration.test.js.map

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

package/dist/logic/invoke/performInIsolatedThread.invoke.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.performInIsolatedThread = exports.invokePerformInIsolatedThread = void 0;
+const uni_time_1 = require("@ehmpathy/uni-time");
+const chalk_1 = __importDefault(require("chalk"));
+const helpful_errors_1 = require("helpful-errors");
+const node_child_process_1 = require("node:child_process");
+const node_path_1 = __importDefault(require("node:path"));
+const node_readline_1 = __importDefault(require("node:readline"));
+const serde_fns_1 = require("serde-fns");
+/**
+ * .what = gets the standard output prefix for this attempt
+ * .why =
+ *   - makes it easy to detect logs per attempt
+ */
+const getLogPrefixForAttempt = (input) => {
+    const palette = [
+        chalk_1.default.cyan,
+        chalk_1.default.green,
+        chalk_1.default.magenta,
+        chalk_1.default.yellow,
+        chalk_1.default.blue,
+        chalk_1.default.hex('#ffb5a7'), // pastel coral
+        chalk_1.default.hex('#b5ead7'), // pastel mint
+        chalk_1.default.hex('#ffd6a5'), // pastel orange
+        chalk_1.default.hex('#e2f0cb'), // pastel lime
+        chalk_1.default.hex('#d2b48c'), // pastel wood
+        chalk_1.default.hex('#ffe5ec'), // pastel rose
+    ];
+    const color = palette[(input.attempt - 1) % palette.length];
+    const pads = String(input.peers).length;
+    const prefix = color(`○ i${String(input.attempt).padStart(pads, '0')} › `);
+    return prefix;
+};
+/**
+ * .what = perform a single skill execution in an isolated child thread (subprocess)
+ * .why =
+ *   - isolates side-effects and resources per attempt
+ *   - enables parallel fan-out while keeping logs readable per attempt
+ * .how =
+ *   - invokes a worker which spins up an isolated thread to execute the performance
+ *   - streams the logs to main thread with identifiable prefix, for observability
+ */
+const invokePerformInIsolatedThread = async (input) => {
+    // grab the attempt index from the argv
+    const attempt = input.opts.attempt ??
+        helpful_errors_1.UnexpectedCodePathError.throw('attempt should have been declared in argv if this was called', { argv: input.opts });
+    // grab the prefix to log with
+    const logPrefix = getLogPrefixForAttempt({
+        attempt,
+        peers: input.peer.attempts,
+    });
+    // serialize the payload
+    const payload = (0, serde_fns_1.asSerialBase64)((0, serde_fns_1.asSerialJSON)({ opts: input.opts }));
+    // define the executor
+    const EXECUTOR_PATH = node_path_1.default.resolve(__dirname, 'performInIsolatedThread.execute');
+    const TSX_CLI = require.resolve('tsx/cli');
+    return await new Promise((resolve) => {
+        // spawn child thread that'll run the executor, with stdout/stderr streams exposed
+        const child = (0, node_child_process_1.spawn)(process.execPath, [TSX_CLI, EXECUTOR_PATH], {
+            stdio: ['ignore', 'pipe', 'pipe', 'ipc'],
+            env: {
+                ...process.env,
+                RHACHET_ATTEMPT: String(input.opts.attempt),
+                RHACHET_ATTEMPTS: String(input.peer.attempts),
+                RHACHET_INVOKE_OPTS_PAYLOAD: payload,
+            },
+        });
+        // forward the workers logs, with the prefix attached, for observability
+        const pipe = (stream, write) => {
+            const rl = node_readline_1.default.createInterface({ input: stream });
+            rl.on('line', (line) => write(logPrefix + line));
+        };
+        pipe(child.stdout, (s) => process.stdout.write(s + '\n'));
+        pipe(child.stderr, (s) => process.stderr.write(s + '\n'));
+        // resolve this procedure on exit of worker
+        const beganAt = (0, uni_time_1.asUniDateTime)(new Date());
+        child.once('exit', (code) => {
+            const range = { since: beganAt, until: (0, uni_time_1.asUniDateTime)(new Date()) };
+            resolve({
+                attempt,
+                code,
+                clock: { range, duration: (0, uni_time_1.getDuration)({ of: { range } }) },
+            });
+        });
+    });
+};
+exports.invokePerformInIsolatedThread = invokePerformInIsolatedThread;
+exports.performInIsolatedThread = exports.invokePerformInIsolatedThread;
+//# sourceMappingURL=performInIsolatedThread.invoke.js.map

package/dist/logic/invoke/performInIsolatedThread.invoke.js.map

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