rhachet 1.1.0

package/dist/logic/weave/compose/genStitchFanout.d.ts

@@ -0,0 +1,17 @@
+import { StitchFanout, ThreadsFromFanout } from '../../../domain/objects/StitchFanout';
+import { StitchStep } from '../../../domain/objects/StitchStep';
+import { GStitcher, Stitcher } from '../../../domain/objects/Stitcher';
+import { Threads } from '../../../domain/objects/Threads';
+import { GStitcherInferredFromFanout } from './GStitcherInferredFromFanout.generic';
+/**
+ * .what = generates a stitcher that fans out to multiple parallel stitchers, then concludes with a final one
+ * .why =
+ *   - enables parallel feedback or computation from multiple perspectives
+ *   - merges results into a final output via the concluding stitcher
+ */
+export declare const genStitchFanout: <TParallels extends readonly [Stitcher<GStitcher<Threads<any, "single">, any, any>>, ...Stitcher<GStitcher<Threads<any, "single">, any, any>>[]], TConcluder extends StitchStep<GStitcher<ThreadsFromFanout<GStitcherInferredFromFanout<TParallels, TConcluder>>, any, any>>>(input: {
+    slug: string;
+    readme: string | null;
+    parallels: TParallels;
+    concluder: TConcluder;
+}) => StitchFanout<GStitcherInferredFromFanout<TParallels, TConcluder>>;

package/dist/logic/weave/compose/genStitchFanout.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genStitchFanout = void 0;
+const StitchFanout_1 = require("../../../domain/objects/StitchFanout");
+/**
+ * .what = generates a stitcher that fans out to multiple parallel stitchers, then concludes with a final one
+ * .why =
+ *   - enables parallel feedback or computation from multiple perspectives
+ *   - merges results into a final output via the concluding stitcher
+ */
+const genStitchFanout = (input) => {
+    return new StitchFanout_1.StitchFanout({
+        form: 'FANOUT',
+        slug: input.slug,
+        readme: input.readme,
+        parallels: input.parallels,
+        concluder: input.concluder,
+    });
+};
+exports.genStitchFanout = genStitchFanout;
+//# sourceMappingURL=genStitchFanout.js.map

package/dist/logic/weave/compose/genStitchFanout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genStitchFanout.js","sourceRoot":"","sources":["../../../../src/logic/weave/compose/genStitchFanout.ts"],"names":[],"mappings":";;;AAAA,uEAG8C;AAM9C;;;;;GAKG;AACI,MAAM,eAAe,GAAG,CAY7B,KAKD,EAAqE,EAAE;IACtE,OAAO,IAAI,2BAAY,CAAC;QACtB,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,SAAS,EAAE,KAAK,CAAC,SAAgB;QACjC,SAAS,EAAE,KAAK,CAAC,SAAgB;KAClC,CAAC,CAAC;AACL,CAAC,CAAC;AAzBW,QAAA,eAAe,mBAyB1B"}

package/dist/logic/weave/compose/genStitchFanout.test.d.ts

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

package/dist/logic/weave/compose/genStitchFanout.test.js

@@ -0,0 +1,79 @@
+"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 StitchStep_1 = require("../../../domain/objects/StitchStep");
+const Thread_1 = require("../../../domain/objects/Thread");
+const enweaveOneFanout_1 = require("../enweaveOneFanout");
+const genStitchFanout_1 = require("./genStitchFanout");
+describe('genStitchFanout type preservation', () => {
+    const context = { ...(0, genContextStitchTrail_1.genContextStitchTrail)(), ...(0, genContextLogTrail_1.genContextLogTrail)() };
+    (0, test_fns_1.given)('a fanout with two compute steps and a numeric concluder', () => {
+        const threadMain = new Thread_1.Thread({
+            context: { role: 'main' },
+            stitches: [],
+        });
+        const parallelA = new StitchStep_1.StitchStepCompute({
+            slug: 'random:a',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 10 }),
+        });
+        const parallelB = new StitchStep_1.StitchStepCompute({
+            slug: 'random:b',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 20 }),
+        });
+        const concluder = new StitchStep_1.StitchStepCompute({
+            slug: 'sum',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: ({ threads }) => {
+                const numbers = [threads.main.seed, ...threads.main.peers].map((t) => t.stitches.at(-1)?.output ?? 0);
+                return {
+                    input: numbers,
+                    output: numbers.reduce((a, b) => a + b, 0),
+                };
+            },
+        });
+        const stitcherFanout = (0, genStitchFanout_1.genStitchFanout)({
+            slug: 'test:fanout:sum',
+            readme: null,
+            parallels: [parallelA, parallelB],
+            concluder,
+        });
+        (0, test_fns_1.when)('used in enweaveOneFanout', () => {
+            (0, test_fns_1.then)('it should produce a stitch.output of type number and multiple threads', async () => {
+                const { stitch, threads } = await (0, enweaveOneFanout_1.enweaveOneFanout)({
+                    stitcher: stitcherFanout,
+                    threads: { main: threadMain },
+                }, context);
+                // ✅ Compile-time check: output is number
+                const testOutput = stitch.output;
+                // ✅ Compile-time check: threads.main is in single shape
+                const stitches = threads.main.stitches;
+                // ✅ Runtime check: sum = 30
+                expect(testOutput).toEqual(30);
+                expect(stitches.length);
+            });
+            (0, test_fns_1.then)('it should fail if you assume wrong output type', async () => {
+                await (0, helpful_errors_1.getError)(async () => {
+                    const { stitch } = await (0, enweaveOneFanout_1.enweaveOneFanout)({
+                        stitcher: stitcherFanout,
+                        threads: { main: threadMain },
+                    }, context);
+                    // @ts-expect-error: stitch.output is number, not string
+                    const wrongType = stitch.output;
+                    expect(wrongType);
+                });
+            });
+        });
+    });
+});
+//# sourceMappingURL=genStitchFanout.test.js.map

package/dist/logic/weave/compose/genStitchFanout.test.js.map

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

package/dist/logic/weave/compose/genStitchRoute.d.ts

@@ -0,0 +1,15 @@
+import { StitchRoute } from '../../../domain/objects/StitchRoute';
+import { GStitcher, Stitcher } from '../../../domain/objects/Stitcher';
+import { Threads } from '../../../domain/objects/Threads';
+import { GStitcherInferredFromRoute } from './GStitcherInferredFromRoute.generic';
+/**
+ * .what = generates a thoroughly typesafe stitch route
+ * .why =
+ *   - ensures typescript considers the input stitcher sequence to infer a composite stitcher for the stitch route declaration
+ *   - results in a composite superset type of threads and context, plus accurate output type, on the output
+ */
+export declare const genStitchRoute: <TSequence extends readonly [Stitcher<GStitcher<Threads<any, "single">, any, any>>, ...Stitcher<GStitcher<Threads<any, "single">, any, any>>[]]>(input: {
+    slug: string;
+    readme: string | null;
+    sequence: TSequence;
+}) => StitchRoute<GStitcherInferredFromRoute<TSequence>>;

package/dist/logic/weave/compose/genStitchRoute.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genStitchRoute = void 0;
+const StitchRoute_1 = require("../../../domain/objects/StitchRoute");
+/**
+ * .what = generates a thoroughly typesafe stitch route
+ * .why =
+ *   - ensures typescript considers the input stitcher sequence to infer a composite stitcher for the stitch route declaration
+ *   - results in a composite superset type of threads and context, plus accurate output type, on the output
+ */
+const genStitchRoute = (input) => {
+    return new StitchRoute_1.StitchRoute({
+        form: 'ROUTE',
+        slug: input.slug,
+        readme: input.readme,
+        sequence: input.sequence,
+    });
+};
+exports.genStitchRoute = genStitchRoute;
+//# sourceMappingURL=genStitchRoute.js.map

package/dist/logic/weave/compose/genStitchRoute.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genStitchRoute.js","sourceRoot":"","sources":["../../../../src/logic/weave/compose/genStitchRoute.ts"],"names":[],"mappings":";;;AAAA,qEAAkE;AAKlE;;;;;GAKG;AACI,MAAM,cAAc,GAAG,CAK5B,KAID,EAAsD,EAAE;IACvD,OAAO,IAAI,yBAAW,CAAC;QACrB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAe;KAChC,CAAC,CAAC;AACL,CAAC,CAAC;AAhBW,QAAA,cAAc,kBAgBzB"}

package/dist/logic/weave/compose/genStitchRoute.test.d.ts

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

package/dist/logic/weave/compose/genStitchRoute.test.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const test_fns_1 = require("test-fns");
+const StitchStep_1 = require("../../../domain/objects/StitchStep");
+const asStitcher_1 = require("./asStitcher");
+const genStitchRoute_1 = require("./genStitchRoute");
+describe('genStitchRoute type preservation', () => {
+    (0, test_fns_1.given)('a route with two compute steps on the same thread', () => {
+        const step1 = new StitchStep_1.StitchStepCompute({
+            slug: 'step-1',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 1 }),
+        });
+        const check1 = true;
+        expect(check1);
+        const step2 = new StitchStep_1.StitchStepCompute({
+            slug: 'step-2',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 2 }),
+        });
+        const check2 = true;
+        expect(check2);
+        const route = (0, genStitchRoute_1.genStitchRoute)({
+            slug: 'route:example',
+            readme: null,
+            sequence: [step1, step2],
+        });
+        (0, test_fns_1.when)('checking assignability to Stitcher<GStitcher>', () => {
+            (0, test_fns_1.then)('it should produce single threads', () => {
+                const isSingle = true;
+                expect(isSingle);
+            });
+            (0, test_fns_1.then)('it should produce a valid gstitcher', () => {
+                const isValid = true;
+                expect(isValid);
+            });
+            (0, test_fns_1.then)('it should be assignable to StitchRoute<T extends GStitcher>', () => {
+                const isAssignable = true;
+                expect(isAssignable);
+            });
+            (0, test_fns_1.then)('it cannot be assignable to StitchRoute<GStitcher>', () => {
+                // @ts-expect-error: due to Generic Invariance on Classes
+                const isAssignable = true;
+                expect(isAssignable);
+            });
+            (0, test_fns_1.then)('it should be assignable generically', () => {
+                const checkA = true;
+                expect(checkA);
+                const checkB = true;
+                expect(checkB);
+                const checkC = true;
+                expect(checkC);
+            });
+            (0, test_fns_1.then)('it cannot be assignable exactly', () => {
+                // @ts-expect-error: due to Generic Invariance on Classes
+                const checkA = true;
+                expect(checkA);
+                // @ts-expect-error: due to Generic Invariance on Classes
+                const checkB = true;
+                expect(checkB);
+            });
+        });
+        (0, test_fns_1.then)('you can still cast it manually with loss of type safety', () => {
+            const forced = route;
+            expect(forced.slug).toBe('route:example');
+        });
+        (0, test_fns_1.then)('it should be assignable if you normalize threads to Threads<..., "single">', () => {
+            const normalized = route;
+            expect(normalized.slug).toBe('route:example');
+        });
+    });
+    (0, test_fns_1.given)('a route within a route', () => {
+        const step1 = new StitchStep_1.StitchStepCompute({
+            slug: 'step-1',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 1 }),
+        });
+        const step2 = new StitchStep_1.StitchStepCompute({
+            slug: 'step-2',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 2 }),
+        });
+        const innerRoute = (0, genStitchRoute_1.genStitchRoute)({
+            slug: 'route:inner',
+            readme: null,
+            sequence: [step1, step2],
+        });
+        const outerRoute = (0, genStitchRoute_1.genStitchRoute)({
+            slug: 'route:outer',
+            readme: null,
+            sequence: [(0, asStitcher_1.asStitcher)(innerRoute)],
+        });
+        (0, test_fns_1.then)('innerRoute should be assignable to Stitcher<GStitcher>', () => {
+            const result = true;
+            expect(result);
+        });
+        (0, test_fns_1.then)('outerRoute should be assignable to Stitcher<GStitcher>', () => {
+            const result = true;
+            expect(result);
+        });
+        (0, test_fns_1.then)('innerRoute should be assignable to StitchRoute<GStitcher>', () => {
+            const result = true;
+            expect(result);
+        });
+        (0, test_fns_1.then)('outerRoute stitches should include the inner step structure', () => {
+            const slug = outerRoute.slug;
+            expect(slug).toBe('route:outer');
+            expect(outerRoute.sequence[0].slug).toBe('route:inner');
+        });
+    });
+});
+//# sourceMappingURL=genStitchRoute.test.js.map

package/dist/logic/weave/compose/genStitchRoute.test.js.map

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

package/dist/logic/weave/enweave.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=enweave.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enweave.js","sourceRoot":"","sources":["../../../src/logic/weave/enweave.ts"],"names":[],"mappings":""}

package/dist/logic/weave/enweaveAllStitchers.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=enweaveAllStitchers.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enweaveAllStitchers.js","sourceRoot":"","sources":["../../../src/logic/weave/enweaveAllStitchers.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,14 @@
+import { StitchChoice } from '../../domain/objects/StitchChoice';
+import { StitchSetEvent } from '../../domain/objects/StitchSetEvent';
+import { GStitcher } from '../../domain/objects/Stitcher';
+/**
+ * .what = executes a StitchChoice by first running the decider to choose an option, then running the chosen option
+ * .why =
+ *   - enables runtime branching based on input, context, or prior stitches
+ *   - helps model decision trees, dynamic workflows, and rule-based logic
+ *   - separates decision logic (decider) from action logic (options)
+ */
+export declare const enweaveOneChoice: <TStitcher extends GStitcher>(input: {
+    stitcher: StitchChoice<TStitcher>;
+    threads: TStitcher['threads'];
+}, context: TStitcher['context']) => Promise<StitchSetEvent<TStitcher['threads'], TStitcher['output']>>;

package/dist/logic/weave/enweaveOneChoice.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enweaveOneChoice = 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");
+/**
+ * .what = executes a StitchChoice by first running the decider to choose an option, then running the chosen option
+ * .why =
+ *   - enables runtime branching based on input, context, or prior stitches
+ *   - helps model decision trees, dynamic workflows, and rule-based logic
+ *   - separates decision logic (decider) from action logic (options)
+ */
+exports.enweaveOneChoice = (0, withStitchTrail_1.withStitchTrail)(async (input, context) => {
+    const { decider, options } = input.stitcher;
+    // run the decider
+    const { stitch: decisionStitch, threads: threadsAfterDecide } = await (0, enweaveOneStitcher_1.enweaveOneStitcher)({
+        stitcher: decider,
+        threads: input.threads,
+    }, context);
+    // grab the chosen stitcher slug
+    const slugChosen = decisionStitch.output?.choice?.slug;
+    if (typeof slugChosen !== 'string')
+        helpful_errors_1.UnexpectedCodePathError.throw('no slug chosen from decider', {
+            decisionStitch,
+        });
+    // find the chosen stitcher
+    const chosenStitcher = options.find((s) => s.slug === slugChosen) ??
+        helpful_errors_1.UnexpectedCodePathError.throw('could not find chosen option', {
+            decisionStitch,
+            slugChosen,
+            options: options.map((option) => option.slug),
+        });
+    // run the chosen stitcher
+    const { stitch: resultStitch, threads: threadsAfterChoice } = await (0, enweaveOneStitcher_1.enweaveOneStitcher)({
+        stitcher: chosenStitcher,
+        threads: threadsAfterDecide,
+    }, context);
+    // declare the result
+    return StitchSetEvent_1.StitchSetEvent.build({
+        occurredAt: (0, uni_time_1.asUniDateTime)(new Date()),
+        stitch: resultStitch,
+        threads: threadsAfterChoice,
+    });
+});
+//# sourceMappingURL=enweaveOneChoice.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enweaveOneChoice.js","sourceRoot":"","sources":["../../../src/logic/weave/enweaveOneChoice.ts"],"names":[],"mappings":";;;AAAA,iDAAmD;AACnD,mDAAyD;AAGzD,wEAAqE;AAErE,+DAA4D;AAC5D,6DAA0D;AAE1D;;;;;;GAMG;AACU,QAAA,gBAAgB,GAAG,IAAA,iCAAe,EAC7C,KAAK,EACH,KAGC,EACD,OAA6B,EACuC,EAAE;IACtE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;IAE5C,kBAAkB;IAClB,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAC3D,MAAM,IAAA,uCAAkB,EACtB;QACE,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,EACD,OAAO,CACR,CAAC;IAEJ,gCAAgC;IAChC,MAAM,UAAU,GAAG,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;IACvD,IAAI,OAAO,UAAU,KAAK,QAAQ;QAChC,wCAAuB,CAAC,KAAK,CAAC,6BAA6B,EAAE;YAC3D,cAAc;SACf,CAAC,CAAC;IAEL,2BAA2B;IAC3B,MAAM,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;QAC1C,wCAAuB,CAAC,KAAK,CAAC,8BAA8B,EAAE;YAC5D,cAAc;YACd,UAAU;YACV,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC;SAC9C,CAAC,CAAC;IAEL,0BAA0B;IAC1B,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,GACzD,MAAM,IAAA,uCAAkB,EACtB;QACE,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,kBAAkB;KAC5B,EACD,OAAO,CACR,CAAC;IAEJ,qBAAqB;IACrB,OAAO,+BAAc,CAAC,KAAK,CAAC;QAC1B,UAAU,EAAE,IAAA,wBAAa,EAAC,IAAI,IAAI,EAAE,CAAC;QACrC,MAAM,EAAE,YAAY;QACpB,OAAO,EAAE,kBAAkB;KAC5B,CAAC,CAAC;AACL,CAAC,CACF,CAAC"}

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

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

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

@@ -0,0 +1,181 @@
+"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 asStitcher_1 = require("./compose/asStitcher");
+const genStitchChoice_1 = require("./compose/genStitchChoice");
+const enweaveOneChoice_1 = require("./enweaveOneChoice");
+describe('enweaveOneChoice', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+    };
+    (0, test_fns_1.given)('a release decision with 3 options: release, iterate, abort', () => {
+        const stitcherOptionRelease = new StitchStep_1.StitchStepCompute({
+            slug: 'stitcherOptionRelease',
+            readme: 'Push this to prod',
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 'released' }),
+        });
+        const stitcherOptionIterate = new StitchStep_1.StitchStepCompute({
+            slug: 'stitcherOptionIterate',
+            readme: 'Keep improving before release',
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 'iterated' }),
+        });
+        const stitcherOptionAbort = new StitchStep_1.StitchStepCompute({
+            slug: 'stitcherOptionAbort',
+            readme: 'Stop this effort',
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 'aborted' }),
+        });
+        const stitcherDecideNextStep = new StitchStep_1.StitchStepCompute({
+            slug: 'stitcherDecideNextStep',
+            readme: 'Choose next step based on quality',
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({
+                input: null,
+                output: { choice: { slug: 'stitcherOptionIterate' } },
+            }),
+        });
+        const chooseNextStep = (0, genStitchChoice_1.genStitchChoice)({
+            slug: 'chooseNextStep',
+            readme: 'Should we now release, iterate, or abort?',
+            decider: stitcherDecideNextStep,
+            options: [
+                stitcherOptionRelease,
+                stitcherOptionIterate,
+                stitcherOptionAbort,
+            ],
+        });
+        (0, test_fns_1.when)('evaluating whether to release', () => {
+            const threads = {
+                main: (0, genThread_1.genThread)({ role: 'main' }),
+            };
+            (0, test_fns_1.then)('it should select "iterate" as next step', async () => {
+                const result = await (0, enweaveOneChoice_1.enweaveOneChoice)({
+                    stitcher: chooseNextStep,
+                    threads,
+                }, context);
+                console.log(JSON.stringify(result, null, 2));
+                expect(result.stitch.output).toBe('iterated');
+                expect(result.threads.main.stitches.length).toBe(2);
+                expect(result.occurredAt).toEqual((0, uni_time_1.asUniDateTime)(result.occurredAt));
+            });
+        });
+    });
+    (0, test_fns_1.given)('a nested decision tree for triaging a home issue', () => {
+        // Leaf stitchers
+        const stitcherOptionPlumberUrgent = new StitchStep_1.StitchStepCompute({
+            slug: 'plumber-urgent',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 'plumber-urgent' }),
+        });
+        const stitcherOptionPlumberSchedule = new StitchStep_1.StitchStepCompute({
+            slug: 'inspect-later',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 'inspection-scheduled' }),
+        });
+        const stitcherOptionElectricianRefer = new StitchStep_1.StitchStepCompute({
+            slug: 'refer-utility',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 'refer-utility' }),
+        });
+        const stitcherOptionElectricianDispatch = new StitchStep_1.StitchStepCompute({
+            slug: 'dispatch-electrician',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({ input: null, output: 'dispatch-electrician' }),
+        });
+        // Inner choice for "leaking water"
+        const leakDecider = new StitchStep_1.StitchStepCompute({
+            slug: 'decide-leak-type',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({
+                input: null,
+                output: { choice: { slug: 'inspect-later' } },
+            }),
+        });
+        const leakChoice = (0, genStitchChoice_1.genStitchChoice)({
+            slug: 'choice:leak',
+            readme: null,
+            decider: leakDecider,
+            options: [stitcherOptionPlumberUrgent, stitcherOptionPlumberSchedule],
+        });
+        // Root decision tree
+        const rootDecider = new StitchStep_1.StitchStepCompute({
+            slug: 'decide-main-issue',
+            readme: null,
+            form: 'COMPUTE',
+            stitchee: 'main',
+            invoke: () => ({
+                input: null,
+                output: { choice: { slug: 'choice:leak' } },
+            }),
+        });
+        const rootChoice = (0, genStitchChoice_1.genStitchChoice)({
+            slug: 'choice:root',
+            readme: 'What kind of issue is this?',
+            decider: rootDecider,
+            options: [
+                (0, asStitcher_1.asStitcher)(leakChoice),
+                stitcherOptionElectricianRefer,
+                stitcherOptionElectricianDispatch,
+            ],
+        });
+        (0, test_fns_1.when)('executing a multi-level decision tree', () => {
+            const threads = {
+                main: (0, genThread_1.genThread)({ role: 'main' }),
+            };
+            (0, test_fns_1.then)('it should follow nested decisions and reach final output', async () => {
+                const result = await (0, enweaveOneChoice_1.enweaveOneChoice)({
+                    stitcher: rootChoice,
+                    threads,
+                }, context);
+                expect(result.stitch.output).toEqual('inspection-scheduled');
+                expect(result.threads.main.stitches.length).toBeGreaterThanOrEqual(2);
+                expect(result.occurredAt).toEqual((0, uni_time_1.asUniDateTime)(result.occurredAt));
+            });
+            (0, test_fns_1.then)('it should error if decider picks an invalid slug', async () => {
+                const badDecider = new StitchStep_1.StitchStepCompute({
+                    slug: 'bad-decider',
+                    readme: null,
+                    form: 'COMPUTE',
+                    stitchee: 'main',
+                    invoke: () => ({
+                        input: null,
+                        output: { choice: { slug: 'not-real' } },
+                    }),
+                });
+                const brokenChoice = (0, genStitchChoice_1.genStitchChoice)({
+                    slug: 'broken-choice',
+                    readme: null,
+                    decider: badDecider,
+                    options: [stitcherOptionPlumberUrgent],
+                });
+                await expect((0, enweaveOneChoice_1.enweaveOneChoice)({
+                    stitcher: brokenChoice,
+                    threads,
+                }, context)).rejects.toThrow('could not find chosen option');
+            });
+        });
+    });
+});
+//# sourceMappingURL=enweaveOneChoice.test.js.map

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

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

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

@@ -0,0 +1,19 @@
+import { HelpfulError } from 'helpful-errors';
+import { StitchCycle } from '../../domain/objects/StitchCycle';
+import { StitchSetEvent } from '../../domain/objects/StitchSetEvent';
+import { GStitcher } from '../../domain/objects/Stitcher';
+export declare class StitcherHaltedError extends HelpfulError {
+}
+/**
+ * .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
+ */
+export declare const enweaveOneCycle: <TStitcher extends GStitcher>(input: {
+    stitcher: StitchCycle<TStitcher>;
+    threads: TStitcher['threads'];
+}, context: TStitcher['context']) => Promise<StitchSetEvent<TStitcher['threads'], TStitcher['output']>>;