rhachet 1.1.0

package/dist/logic/weave/enweaveOneCycle.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enweaveOneCycle = exports.StitcherHaltedError = void 0;
+const uni_time_1 = require("@ehmpathy/uni-time");
+const helpful_errors_1 = require("helpful-errors");
+const StitchSetEvent_1 = require("../../domain/objects/StitchSetEvent");
+const withStitchTrail_1 = require("../stitch/withStitchTrail");
+const enweaveOneStitcher_1 = require("./enweaveOneStitcher");
+class StitcherHaltedError extends helpful_errors_1.HelpfulError {
+}
+exports.StitcherHaltedError = StitcherHaltedError;
+/**
+ * .what = executes a StitchCycle by looping repeatee until the decider chooses to stop
+ * .why =
+ *   - enables iterative behaviors (e.g. retry, polling, feedback loops)
+ *   - separates logic of repeated step vs control logic (decider)
+ * .note =
+ *   - will halt by default after 100 cycles or 1 hr, configurable
+ *   - if halted, will fail fast; can resume halted weaves on demand, after repair
+ */
+exports.enweaveOneCycle = (0, withStitchTrail_1.withStitchTrail)(async (input, context) => {
+    const { repeatee, decider, halter } = input.stitcher;
+    // declare the state we'll mutate while the stitch is in progress
+    const progress = {
+        beganAt: (0, uni_time_1.asUniDateTime)(new Date()),
+        repetitions: 0,
+        stitch: null,
+        threads: input.threads,
+    };
+    // declare mech to fulfil halter behavior
+    const threshold = {
+        repetitions: halter?.threshold?.repetitions ?? 100,
+        duration: halter?.threshold?.duration ?? { hours: 1 },
+    };
+    const hasBreached = () => {
+        if (progress.repetitions >= threshold.repetitions)
+            return true;
+        const now = (0, uni_time_1.asUniDateTime)(new Date());
+        const deadline = (0, uni_time_1.addDuration)(progress.beganAt, threshold.duration);
+        return now > deadline;
+    };
+    const throwHalted = ({ reason }) => StitcherHaltedError.throw(`Cycle halted due to ${reason === 'DECIDED' ? 'decider output.' : 'threshold breach'} (${reason}). See the log event stream output for details.`, {
+        reason,
+        threshold,
+        progress: {
+            ...progress,
+            duration: (0, uni_time_1.getDuration)({
+                of: {
+                    range: uni_time_1.isUniDateTimeRange.assure({
+                        since: progress.beganAt,
+                        until: (0, uni_time_1.asUniDateTime)(new Date()),
+                    }),
+                },
+            }),
+        },
+    });
+    // loop until the decider chooses to stop
+    while (true) {
+        // fail fast if the halter's threshold was breached
+        if (hasBreached())
+            throwHalted({ reason: 'BREACHED' });
+        // run the repeatee step
+        const { stitch: repeateeStitch, threads: afterRepeatee } = await (0, enweaveOneStitcher_1.enweaveOneStitcher)({ stitcher: repeatee, threads: progress.threads }, context);
+        // update progress state
+        progress.stitch = repeateeStitch;
+        progress.threads = afterRepeatee;
+        progress.repetitions++;
+        // run the decider to determine whether to continue
+        const { stitch: deciderStitch, threads: afterDecider } = await (0, enweaveOneStitcher_1.enweaveOneStitcher)({ stitcher: decider, threads: progress.threads }, context);
+        const choice = deciderStitch.output?.choice;
+        if (!choice) {
+            helpful_errors_1.UnexpectedCodePathError.throw('no choice returned from cycle decider', {
+                deciderStitch,
+            });
+        }
+        // update threads with decider result
+        progress.threads = afterDecider;
+        // determine next action
+        if (choice === 'halt')
+            throwHalted({ reason: 'DECIDED' });
+        if (choice === 'repeat')
+            continue;
+        if (choice === 'release')
+            break;
+        helpful_errors_1.UnexpectedCodePathError.throw('unexpected choice from decider', {
+            choice,
+            deciderStitch,
+        });
+    }
+    // declare the final result as a StitchSetEvent
+    return StitchSetEvent_1.StitchSetEvent.build({
+        occurredAt: (0, uni_time_1.asUniDateTime)(new Date()),
+        stitch: progress.stitch ??
+            helpful_errors_1.UnexpectedCodePathError.throw('atleast one output stitch expected by now'),
+        threads: progress.threads,
+    });
+});
+//# sourceMappingURL=enweaveOneCycle.js.map

package/dist/logic/weave/enweaveOneCycle.js.map

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

package/dist/logic/weave/enweaveOneCycle.test.d.ts

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

package/dist/logic/weave/enweaveOneCycle.test.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const uni_time_1 = require("@ehmpathy/uni-time");
+const test_fns_1 = require("test-fns");
+const genContextLogTrail_1 = require("../../__test_assets__/genContextLogTrail");
+const genContextStitchTrail_1 = require("../../__test_assets__/genContextStitchTrail");
+const StitchStep_1 = require("../../domain/objects/StitchStep");
+const genThread_1 = require("../thread/genThread");
+const genStitchCycle_1 = require("./compose/genStitchCycle");
+const enweaveOneCycle_1 = require("./enweaveOneCycle");
+describe('enweaveOneCycle', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+    };
+    (0, test_fns_1.given)('a simple repeatee that gets released', () => {
+        const repeatee = new StitchStep_1.StitchStepCompute({
+            slug: 'repeatee',
+            readme: 'Repeat logic',
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 'A' }),
+        });
+        const decider = new StitchStep_1.StitchStepCompute({
+            slug: 'decider',
+            readme: 'Choose to stop after one',
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: { choice: 'release' } }),
+        });
+        const stitcher = (0, genStitchCycle_1.genStitchCycle)({
+            slug: 'release-after-one',
+            readme: null,
+            repeatee,
+            decider,
+        });
+        (0, test_fns_1.when)('run once and released', () => {
+            const threads = {
+                main: (0, genThread_1.genThread)({ role: 'main' }),
+            };
+            (0, test_fns_1.then)('it should return after one cycle with A', async () => {
+                const result = await (0, enweaveOneCycle_1.enweaveOneCycle)({ stitcher, threads }, context);
+                expect(result.stitch.output).toBe('A');
+                expect(result.threads.main.stitches.length).toBe(2);
+            });
+        });
+    });
+    (0, test_fns_1.given)('a cycle that repeats twice then releases', () => {
+        let callCount = 0;
+        const repeatee = new StitchStep_1.StitchStepCompute({
+            slug: 'repeatee-twice',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: `call-${++callCount}` }),
+        });
+        const decider = new StitchStep_1.StitchStepCompute({
+            slug: 'decider-twice',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({
+                input: null,
+                output: { choice: callCount === 2 ? 'release' : 'repeat' },
+            }),
+        });
+        const stitcher = (0, genStitchCycle_1.genStitchCycle)({
+            slug: 'repeat-twice-then-release',
+            readme: null,
+            repeatee,
+            decider,
+        });
+        (0, test_fns_1.when)('run until released', () => {
+            const threads = {
+                main: (0, genThread_1.genThread)({ role: 'main' }),
+            };
+            (0, test_fns_1.then)('it should run repeatee twice and return second output', async () => {
+                const result = await (0, enweaveOneCycle_1.enweaveOneCycle)({ stitcher, threads }, context);
+                expect(result.stitch.output).toBe('call-2');
+                expect(result.threads.main.stitches.length).toBe(4); // 2 repeatee + 2 decider
+            });
+        });
+    });
+    (0, test_fns_1.given)('a halting decider', () => {
+        const repeatee = new StitchStep_1.StitchStepCompute({
+            slug: 'rep',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 'A' }),
+        });
+        const decider = new StitchStep_1.StitchStepCompute({
+            slug: 'halt-me',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: { choice: 'halt' } }),
+        });
+        const stitcher = (0, genStitchCycle_1.genStitchCycle)({
+            slug: 'halt-once',
+            readme: null,
+            repeatee,
+            decider,
+        });
+        (0, test_fns_1.when)('run and told to halt', () => {
+            const threads = {
+                main: (0, genThread_1.genThread)({ role: 'main' }),
+            };
+            (0, test_fns_1.then)('it should throw a StitcherHaltedError(reason=DECIDED)', async () => {
+                await expect((0, enweaveOneCycle_1.enweaveOneCycle)({ stitcher, threads }, context)).rejects.toThrowError(/DECIDED/);
+            });
+        });
+    });
+    (0, test_fns_1.given)('a repeatee that never releases, with halter on repetitions', () => {
+        const stitcherRepeatee = new StitchStep_1.StitchStepCompute({
+            slug: 'infinite-step',
+            readme: 'Always increment',
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 'tick' }),
+        });
+        const stitcherDecider = new StitchStep_1.StitchStepCompute({
+            slug: 'always-repeat',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: { choice: 'repeat' } }),
+        });
+        const stitcherCycle = (0, genStitchCycle_1.genStitchCycle)({
+            slug: 'cycle-infinite-haltered',
+            readme: null,
+            repeatee: stitcherRepeatee,
+            decider: stitcherDecider,
+            halter: { threshold: { repetitions: 5 } },
+        });
+        (0, test_fns_1.when)('executed', () => {
+            const threads = {
+                main: (0, genThread_1.genThread)({ role: 'main' }),
+            };
+            (0, test_fns_1.then)('it should halt after 5 repetitions', async () => {
+                await expect((0, enweaveOneCycle_1.enweaveOneCycle)({ stitcher: stitcherCycle, threads }, context)).rejects.toThrow(enweaveOneCycle_1.StitcherHaltedError);
+            });
+        });
+    });
+    (0, test_fns_1.given)('a repeatee that exceeds time halter', () => {
+        const stitcherRepeatee = new StitchStep_1.StitchStepCompute({
+            slug: 'sleepy-step',
+            readme: 'Sleeps each run',
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: async () => {
+                await (0, uni_time_1.sleep)({ seconds: 2 });
+                return { input: null, output: 'zzz' };
+            },
+        });
+        const stitcherDecider = new StitchStep_1.StitchStepCompute({
+            slug: 'always-repeat-sleepy',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: { choice: 'repeat' } }),
+        });
+        const stitcherCycle = (0, genStitchCycle_1.genStitchCycle)({
+            slug: 'cycle-timeout-halter',
+            readme: null,
+            repeatee: stitcherRepeatee,
+            decider: stitcherDecider,
+            halter: { threshold: { duration: { seconds: 3 } } },
+        });
+        (0, test_fns_1.when)('executed', () => {
+            const threads = {
+                main: (0, genThread_1.genThread)({ role: 'main' }),
+            };
+            (0, test_fns_1.then)('it should halt due to time threshold', async () => {
+                await expect((0, enweaveOneCycle_1.enweaveOneCycle)({ stitcher: stitcherCycle, threads }, context)).rejects.toThrow(enweaveOneCycle_1.StitcherHaltedError);
+            });
+        });
+    });
+});
+//# sourceMappingURL=enweaveOneCycle.test.js.map

package/dist/logic/weave/enweaveOneCycle.test.js.map

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

package/dist/logic/weave/enweaveOneFanout.d.ts

@@ -0,0 +1,12 @@
+import { StitchFanout } from '../../domain/objects/StitchFanout';
+import { StitchSetEvent } from '../../domain/objects/StitchSetEvent';
+import { GStitcher } from '../../domain/objects/Stitcher';
+/**
+ * .what = mechanism to enweave a full stitch fanout
+ * .how =
+ *   - executes a Promise.all(.parallels) and a .conclusion stitcher
+ */
+export declare const enweaveOneFanout: <TStitcher extends GStitcher>(input: {
+    stitcher: StitchFanout<TStitcher>;
+    threads: TStitcher['threads'];
+}, context: TStitcher['context']) => Promise<StitchSetEvent<TStitcher['threads'], TStitcher['output']>>;

package/dist/logic/weave/enweaveOneFanout.integration.test.d.ts

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

package/dist/logic/weave/enweaveOneFanout.integration.test.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const helpful_errors_1 = require("helpful-errors");
+const test_fns_1 = require("test-fns");
+const genContextLogTrail_1 = require("../../__test_assets__/genContextLogTrail");
+const genContextStitchTrail_1 = require("../../__test_assets__/genContextStitchTrail");
+const getContextOpenAI_1 = require("../../__test_assets__/getContextOpenAI");
+const genStitcherCodeReviewImagine_1 = require("../../__test_assets__/stitchers/genStitcherCodeReviewImagine");
+const stitcherFanoutRandomSum_1 = require("../../__test_assets__/stitchers/stitcherFanoutRandomSum");
+const stitcherFanoutSubroutes_1 = require("../../__test_assets__/stitchers/stitcherFanoutSubroutes");
+const StitchStep_1 = require("../../domain/objects/StitchStep");
+const Thread_1 = require("../../domain/objects/Thread");
+const genThread_1 = require("../thread/genThread");
+const genStitchFanout_1 = require("./compose/genStitchFanout");
+const enweaveOneFanout_1 = require("./enweaveOneFanout");
+describe('enweaveOneFanout', () => {
+    const context = { ...(0, genContextStitchTrail_1.genContextStitchTrail)(), ...(0, genContextLogTrail_1.genContextLogTrail)() };
+    (0, test_fns_1.given)('a fanout that computes 5 random numbers then sums them', () => {
+        const threadMain = new Thread_1.Thread({
+            context: { role: 'main' },
+            stitches: [],
+        });
+        (0, test_fns_1.when)('invoked with the correct thread', () => {
+            (0, test_fns_1.then)('it should return a number stitch equal to the sum of the random outputs', async () => {
+                const { stitch, threads } = await (0, enweaveOneFanout_1.enweaveOneFanout)({
+                    stitcher: stitcherFanoutRandomSum_1.stitcherFanoutRandomSum,
+                    threads: { main: threadMain },
+                }, context);
+                console.log({ stitch, threads });
+                // validate output is a number
+                expect(typeof stitch.output).toBe('number');
+                // validate input to the concluder is a number[]
+                expect(Array.isArray(stitch.input)).toBe(true);
+                expect(stitch.input.every((n) => typeof n === 'number')).toBe(true);
+                // validate stitch.output === sum(stitch.input)
+                const expectedSum = stitch.input.reduce((a, b) => a + b, 0);
+                expect(stitch.output).toBe(expectedSum);
+                // validate thread output is form: 'single'
+                expect(threads.main.stitches.at(-1)?.output).toBe(expectedSum);
+            });
+        });
+        (0, test_fns_1.when)('invoked with an incorrect thread role', () => {
+            const threadWrong = new Thread_1.Thread({
+                context: { role: 'wrong' },
+                stitches: [],
+            });
+            (0, test_fns_1.then)('it should throw at compile time due to wrong role', async () => {
+                await (0, helpful_errors_1.getError)((0, enweaveOneFanout_1.enweaveOneFanout)({
+                    stitcher: stitcherFanoutRandomSum_1.stitcherFanoutRandomSum,
+                    // @ts-expect-error: wrong thread role
+                    threads: { wrong: threadWrong },
+                }, context));
+            });
+        });
+    });
+    (0, test_fns_1.given)('a fanout with one route of 2 steps and another of 3 steps', () => {
+        const threadMain = new Thread_1.Thread({
+            context: { role: 'main' },
+            stitches: [],
+        });
+        (0, test_fns_1.then)('it should output a stitch where input = [3, 6] and output = 9', async () => {
+            const { stitch, threads } = await (0, enweaveOneFanout_1.enweaveOneFanout)({
+                stitcher: stitcherFanoutSubroutes_1.stitcherFanoutWithRoutes,
+                threads: { main: threadMain },
+            }, context);
+            expect(Array.isArray(stitch.input)).toBe(true);
+            expect(stitch.input).toEqual([3, 6]);
+            expect(stitch.output).toBe(9);
+            expect(threads.main.stitches.at(-1)?.output).toBe(9);
+        });
+    });
+    test_fns_1.given.only('a route with imagine stitchers, parallelized (closer to real world usecase)', () => {
+        const stitchCodeRead = {
+            input: null,
+            output: {
+                path: '__path__',
+                content: `
+import { UnexpectedCodePathError } from '@ehmpathy/error-fns';
+import { UniDateTime } from '@ehmpathy/uni-time';
+import { PickOne } from 'type-fns';
+
+import { daoJobProspect } from '../../data/dao/jobProspectDao';
+import { withDatabaseContext } from '../../utils/database/withDatabaseContext';
+
+export const getProspects = withDatabaseContext(
+async (
+input: PickOne<{
+  byProvider: { providerUuid: string };
+}> & {
+  page: {
+    since?: { openedAt: UniDateTime };
+    until?: { openedAt: UniDateTime };
+    limit: number;
+  };
+},
+context,
+) => {
+  if (input.byProvider)
+    return daoJobProspect.findAllByProvider(
+      {
+        by: {
+          providerUuid: input.byProvider.providerUuid,
+        },
+        filter: {
+          sinceOpenedAt: input.page.since?.openedAt,
+          untilOpenedAt: input.page.until?.openedAt,
+        },
+        limit: input.page.limit,
+      },
+      context,
+    );
+
+  throw new UnexpectedCodePathError('unsupported input option');
+},
+          `.trim(),
+            },
+        };
+        const stitcherCodeReviewConcluder = new StitchStep_1.StitchStepCompute({
+            slug: 'sum',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'critic',
+            invoke: ({ threads }) => {
+                const feedbacks = threads.critic.peers.map((peer) => peer.stitches.slice(-1)[0]?.output);
+                return {
+                    input: feedbacks,
+                    output: feedbacks,
+                };
+            },
+        });
+        const fanout = (0, genStitchFanout_1.genStitchFanout)({
+            slug: '[critic]<code:review>.<fanout>[[review]]',
+            readme: null,
+            parallels: [
+                (0, genStitcherCodeReviewImagine_1.genStitcherCodeReview)({ scope: 'technical', focus: 'blockers' }),
+                (0, genStitcherCodeReviewImagine_1.genStitcherCodeReview)({ scope: 'technical', focus: 'chances' }),
+                (0, genStitcherCodeReviewImagine_1.genStitcherCodeReview)({ scope: 'technical', focus: 'praises' }),
+                (0, genStitcherCodeReviewImagine_1.genStitcherCodeReview)({ scope: 'functional', focus: 'blockers' }),
+                (0, genStitcherCodeReviewImagine_1.genStitcherCodeReview)({ scope: 'functional', focus: 'chances' }),
+                (0, genStitcherCodeReviewImagine_1.genStitcherCodeReview)({ scope: 'functional', focus: 'praises' }),
+            ],
+            concluder: stitcherCodeReviewConcluder,
+        });
+        (0, test_fns_1.when)('given the threads required', () => {
+            (0, test_fns_1.then)('it should successfully execute the stitches as a weave', async () => {
+                const output = await (0, enweaveOneFanout_1.enweaveOneFanout)({
+                    stitcher: fanout,
+                    threads: {
+                        critic: {
+                            ...(0, genThread_1.genThread)({
+                                role: 'critic',
+                                tools: [],
+                                facts: [],
+                            }),
+                            stitches: [stitchCodeRead],
+                        },
+                        director: (0, genThread_1.genThread)({ role: 'director' }),
+                    },
+                }, { ...context, ...(0, getContextOpenAI_1.getContextOpenAI)() });
+                expect(output.stitch.output.length).toEqual(6);
+                console.log(output.stitch.output);
+            });
+        });
+    });
+});
+//# sourceMappingURL=enweaveOneFanout.integration.test.js.map

package/dist/logic/weave/enweaveOneFanout.integration.test.js.map

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

package/dist/logic/weave/enweaveOneFanout.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enweaveOneFanout = void 0;
+const uni_time_1 = require("@ehmpathy/uni-time");
+const StitchSetEvent_1 = require("../../domain/objects/StitchSetEvent");
+const enstitch_1 = require("../stitch/enstitch");
+const withStitchTrail_1 = require("../stitch/withStitchTrail");
+const enweaveOneStitcher_1 = require("./enweaveOneStitcher");
+/**
+ * .what = mechanism to enweave a full stitch fanout
+ * .how =
+ *   - executes a Promise.all(.parallels) and a .conclusion stitcher
+ */
+exports.enweaveOneFanout = (0, withStitchTrail_1.withStitchTrail)(async (input, context) => {
+    const { parallels, concluder } = input.stitcher;
+    // enweave parallel stitchers concurrently
+    const fanoutResults = await Promise.all(parallels.map((stitcher) => (0, enweaveOneStitcher_1.enweaveOneStitcher)({ stitcher, threads: input.threads }, context)));
+    // merge fanout results into grouped threads by role
+    const threadsAfterFanout = fanoutResults.reduce((acc, result) => {
+        for (const role of Object.keys(result.threads)) {
+            const thread = result.threads[role];
+            if (!acc[role])
+                acc[role] = { seed: input.threads[role], peers: [] };
+            acc[role].peers.push(thread);
+        }
+        return acc;
+    }, {});
+    // execute the concluder stitcher with the fanout threads
+    const { stitch: finalStitch, threads: finalThreads } = await (0, enstitch_1.enstitch)({ stitcher: concluder, threads: threadsAfterFanout }, context);
+    // declare the result
+    return StitchSetEvent_1.StitchSetEvent.build({
+        occurredAt: (0, uni_time_1.asUniDateTime)(new Date()),
+        stitch: finalStitch,
+        threads: finalThreads,
+    });
+});
+//# sourceMappingURL=enweaveOneFanout.js.map

package/dist/logic/weave/enweaveOneFanout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enweaveOneFanout.js","sourceRoot":"","sources":["../../../src/logic/weave/enweaveOneFanout.ts"],"names":[],"mappings":";;;AAAA,iDAAmD;AAMnD,wEAAqE;AAGrE,iDAA8C;AAC9C,+DAA4D;AAC5D,6DAA0D;AAE1D;;;;GAIG;AACU,QAAA,gBAAgB,GAAG,IAAA,iCAAe,EAC7C,KAAK,EACH,KAGC,EACD,OAA6B,EACuC,EAAE;IACtE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;IAEhD,0CAA0C;IAC1C,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,GAAG,CACrC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACzB,IAAA,uCAAkB,EAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAClE,CACF,CAAC;IAEF,oDAAoD;IACpD,MAAM,kBAAkB,GAAG,aAAa,CAAC,MAAM,CAC7C,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE;QACd,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAC5B,MAAM,CAAC,OAAO,CACmB,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAE,CAAC;YAErC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;gBAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACtE,GAAG,CAAC,IAAI,CAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC,EACD,EAKC,CAC8B,CAAC;IAElC,yDAAyD;IACzD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,IAAA,mBAAQ,EACnE,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,kBAAkB,EAAE,EACpD,OAAO,CACR,CAAC;IAEF,qBAAqB;IACrB,OAAO,+BAAc,CAAC,KAAK,CAAC;QAC1B,UAAU,EAAE,IAAA,wBAAa,EAAC,IAAI,IAAI,EAAE,CAAC;QACrC,MAAM,EAAE,WAAW;QACnB,OAAO,EAAE,YAAY;KACtB,CAAC,CAAC;AACL,CAAC,CACF,CAAC"}

package/dist/logic/weave/enweaveOneRoute.d.ts

@@ -0,0 +1,12 @@
+import { StitchRoute } from '../../domain/objects/StitchRoute';
+import { StitchSetEvent } from '../../domain/objects/StitchSetEvent';
+import { GStitcher } from '../../domain/objects/Stitcher';
+/**
+ * .what = mechanism to enweave a full stitch route
+ * .how =
+ *   - executes a .sequence of stitchers
+ */
+export declare const enweaveOneRoute: <TStitcher extends GStitcher>(input: {
+    stitcher: StitchRoute<TStitcher>;
+    threads: TStitcher['threads'];
+}, context: TStitcher['context']) => Promise<StitchSetEvent<TStitcher['threads'], TStitcher['output']>>;

package/dist/logic/weave/enweaveOneRoute.integration.test.d.ts

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