rhachet-roles-ehmpathy 1.0.0 → 1.2.0

package/dist/.test/getContextOpenAI.js

@@ -9,7 +9,8 @@ const getContextOpenAI = () => ({
                 helpful_errors_1.UnexpectedCodePathError.throw('prep openai key not declared in env'),
         },
         llm: {
-            model: 'gpt-4-turbo-2024-04-09',
+            // model: 'gpt-4-turbo-2024-04-09',
+            model: 'gpt-4o',
             output: 'words',
         },
     },

package/dist/.test/getContextOpenAI.js.map

@@ -1 +1 @@
-{"version":3,"file":"getContextOpenAI.js","sourceRoot":"","sources":["../../src/.test/getContextOpenAI.ts"],"names":[],"mappings":";;;AAAA,mDAAyD;AAIlD,MAAM,gBAAgB,GAAG,GAAkB,EAAE,CAAC,CAAC;IACpD,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,GAAG,EACD,OAAO,CAAC,GAAG,CAAC,eAAe;gBAC3B,wCAAuB,CAAC,KAAK,CAAC,qCAAqC,CAAC;SACvE;QACD,GAAG,EAAE;YACH,KAAK,EAAE,wBAAwB;YAC/B,MAAM,EAAE,OAAO;SAChB;KACF;CACF,CAAC,CAAC;AAZU,QAAA,gBAAgB,oBAY1B"}
+{"version":3,"file":"getContextOpenAI.js","sourceRoot":"","sources":["../../src/.test/getContextOpenAI.ts"],"names":[],"mappings":";;;AAAA,mDAAyD;AAIlD,MAAM,gBAAgB,GAAG,GAAkB,EAAE,CAAC,CAAC;IACpD,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,GAAG,EACD,OAAO,CAAC,GAAG,CAAC,eAAe;gBAC3B,wCAAuB,CAAC,KAAK,CAAC,qCAAqC,CAAC;SACvE;QACD,GAAG,EAAE;YACH,mCAAmC;YACnC,KAAK,EAAE,QAAQ;YACf,MAAM,EAAE,OAAO;SAChB;KACF;CACF,CAAC,CAAC;AAbU,QAAA,gBAAgB,oBAa1B"}

package/dist/_topublish/domain-glossary-brief/src/domain/objects/Catalog.js

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

package/dist/_topublish/domain-glossary-brief/src/domain/objects/Catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Catalog.js","sourceRoot":"","sources":["../../../../../../src/_topublish/domain-glossary-brief/src/domain/objects/Catalog.ts"],"names":[],"mappings":""}

package/dist/_topublish/domain-glossary-brief/src/domain/objects/TriageCatalog.d.ts

@@ -0,0 +1,18 @@
+export type TriageTier = 'P0' | 'P1' | 'P2' | 'P3';
+/**
+ * A TriageCatalog is a structured collection of items
+ * organized into discrete priority tiers.
+ *
+ * - `TTier` = the allowed priority labels (e.g. 'P0' | 'P1' | 'P2' | 'P3')
+ * - `TItem` = the type of each catalog entry (e.g. Question)
+ *
+ * Each tier key holds an **ordered list** of items
+ * that share the same level of urgency, leverage, or essentiality.
+ *
+ * This type is typically the **output** of a <triage> operation
+ * applied to a raw catalog, where the catalog is partitioned
+ * into meaningful priority groupings.
+ */
+export type TriageCatalog<TItem, TTier extends string = TriageTier> = {
+    readonly [K in TTier]: readonly TItem[];
+};

package/dist/_topublish/domain-glossary-brief/src/domain/objects/TriageCatalog.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=TriageCatalog.js.map

package/dist/_topublish/domain-glossary-brief/src/domain/objects/TriageCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriageCatalog.js","sourceRoot":"","sources":["../../../../../../src/_topublish/domain-glossary-brief/src/domain/objects/TriageCatalog.ts"],"names":[],"mappings":""}

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.d.ts

@@ -0,0 +1,34 @@
+import { DomainEntity } from 'domain-objects';
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+/**
+ * .what = a focus that a @[thinker] can adopt
+ * .why =
+ *   - declares a distinct context and concept with which to think
+ *   - enables focus switches, persistence, replication, etc
+ * .ref = @[bhrain].briefs/cognition
+ */
+export interface Focus {
+    /**
+     * .what = the unique identifier of this focus
+     * .why = enables identification of mutable focus
+     */
+    exid: string;
+    /**
+     * .what = ⚓ the anchor concept, represents the position within the semantic treestruct at focus
+     * .why =
+     *   - serves as the point from which the thinker's perspective is based
+     *   - serves as the topic onto which the thinker's imagination is applied
+     */
+    concept: Artifact<typeof GitFile>;
+    /**
+     * .what = 🔦 the visible concepts, represent the positions within the semantic treestruct included for leverage
+     * .why =
+     *   - defines which concepts can be leveraged for manipulation of the focus.concept
+     *   - can be mutated to grow or shrink, along dimensions of .depth, .breadth, and .acuity
+     */
+    context: Artifact<typeof GitFile>;
+}
+export declare class Focus extends DomainEntity<Focus> implements Focus {
+    static unique: readonly ["exid"];
+}

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Focus = void 0;
+const domain_objects_1 = require("domain-objects");
+class Focus extends domain_objects_1.DomainEntity {
+}
+exports.Focus = Focus;
+Focus.unique = ['exid'];
+//# sourceMappingURL=Focus.js.map

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Focus.js","sourceRoot":"","sources":["../../../../../../src/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus.ts"],"names":[],"mappings":";;;AAAA,mDAA8C;AAkC9C,MAAa,KAAM,SAAQ,6BAAmB;;AAA9C,sBAEC;AADe,YAAM,GAAG,CAAC,MAAM,CAAU,CAAC"}

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/PonderCatalog.d.ts

@@ -0,0 +1,9 @@
+import { TriageCatalog } from '../../../../domain-glossary-brief/src/domain/objects/TriageCatalog';
+import { Question } from './Question';
+/**
+ * A PonderCatalog stores the triaged questions available for use in a ponder operation
+ */
+export type PonderCatalog = {
+    contextualize: TriageCatalog<Question>;
+    conceptualize: TriageCatalog<Question>;
+};

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/PonderCatalog.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=PonderCatalog.js.map

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/PonderCatalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PonderCatalog.js","sourceRoot":"","sources":["../../../../../../src/_topublish/rhachet-roles-bhrain/src/domain/objects/PonderCatalog.ts"],"names":[],"mappings":""}

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Question.d.ts

@@ -0,0 +1 @@
+export type Question = string;

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Question.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Question.js.map

package/dist/_topublish/rhachet-roles-bhrain/src/domain/objects/Question.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Question.js","sourceRoot":"","sources":["../../../../../../src/_topublish/rhachet-roles-bhrain/src/domain/objects/Question.ts"],"names":[],"mappings":""}

package/dist/contract/commands/codegenBriefOptions.js

@@ -53,5 +53,6 @@ if (require.main === module) {
     // void command({ role: 'Architect' });
     void command({ role: 'Designer' });
     void command({ role: 'Mechanic' });
+    void command({ role: 'Bhrain' });
 }
 //# sourceMappingURL=codegenBriefOptions.js.map

package/dist/contract/commands/codegenBriefOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"codegenBriefOptions.js","sourceRoot":"","sources":["../../../src/contract/commands/codegenBriefOptions.ts"],"names":[],"mappings":";;;;;AAAA,qDAAiD;AACjD,0DAA6B;AAC7B,4CAAoB;AACpB,gDAAwB;AACxB,+DAAsD;AAEtD,MAAM,OAAO,GAAG,IAAA,sBAAS,EACvB;IACE,IAAI,EAAE,cAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC/B,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,SAAS,GAAG,QAAQ;IACzB,GAAG,EAAE,OAAO;CACb,EACD,KAAK,EAAE,KAEN,EAAE,EAAE;IACH,kDAAkD;IAClD,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CACzB,CAAC,MAAM,IAAA,qCAAc,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACzC,oBAAoB,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CACzD,CAAC;IACF,MAAM,QAAQ,GAAG;QACf,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,cAAc;QAC5C,GAAG,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,4FAA4F;KACxI,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,IAAA,mBAAI,EAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,6BAA6B;IAC7B,MAAM,IAAI,GAAG,SAAS;SACnB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SACtD,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CAAC,cAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAC7D,CAAC;IACJ,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7D,MAAM,YAAY,GAAG;;0DAEiC,KAAK,CAAC,IAAI;;;oCAGhC,cAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;;;;EAI3D,YAAY;;;yBAGW,KAAK,CAAC,IAAI;CAClC,CAAC;IAEE,qBAAqB;IACrB,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAC1B,SAAS,EACT,SAAS,KAAK,CAAC,IAAI,0BAA0B,CAC9C,CAAC;IACF,YAAE,CAAC,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;IACtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AACtC,CAAC,CACF,CAAC;AAEF,uDAAuD;AACvD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACpC,uCAAuC;IACvC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACnC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;AACrC,CAAC"}
+{"version":3,"file":"codegenBriefOptions.js","sourceRoot":"","sources":["../../../src/contract/commands/codegenBriefOptions.ts"],"names":[],"mappings":";;;;;AAAA,qDAAiD;AACjD,0DAA6B;AAC7B,4CAAoB;AACpB,gDAAwB;AACxB,+DAAsD;AAEtD,MAAM,OAAO,GAAG,IAAA,sBAAS,EACvB;IACE,IAAI,EAAE,cAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC/B,KAAK,EAAE,MAAM;IACb,GAAG,EAAE,SAAS,GAAG,QAAQ;IACzB,GAAG,EAAE,OAAO;CACb,EACD,KAAK,EAAE,KAEN,EAAE,EAAE;IACH,kDAAkD;IAClD,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CACzB,CAAC,MAAM,IAAA,qCAAc,EAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACzC,oBAAoB,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,UAAU,CACzD,CAAC;IACF,MAAM,QAAQ,GAAG;QACf,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,EAAE,cAAc;QAC5C,GAAG,GAAG,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,EAAE,4FAA4F;KACxI,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,IAAA,mBAAI,EAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5D,6BAA6B;IAC7B,MAAM,IAAI,GAAG,SAAS;SACnB,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,cAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;SACtD,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CAAC,cAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAC7D,CAAC;IACJ,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE7D,MAAM,YAAY,GAAG;;0DAEiC,KAAK,CAAC,IAAI;;;oCAGhC,cAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;;;;EAI3D,YAAY;;;yBAGW,KAAK,CAAC,IAAI;CAClC,CAAC;IAEE,qBAAqB;IACrB,MAAM,UAAU,GAAG,cAAI,CAAC,IAAI,CAC1B,SAAS,EACT,SAAS,KAAK,CAAC,IAAI,0BAA0B,CAC9C,CAAC;IACF,YAAE,CAAC,aAAa,CAAC,UAAU,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;IACtC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,CAAC;AACtC,CAAC,CACF,CAAC;AAEF,uDAAuD;AACvD,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IACpC,uCAAuC;IACvC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACnC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IACnC,KAAK,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACnC,CAAC"}

package/dist/contract/sdk/index.d.ts

@@ -0,0 +1 @@
+export { getRoleRegistry } from '../../logic/roles/getRoleRegistry';

package/dist/contract/sdk/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRoleRegistry = void 0;
+var getRoleRegistry_1 = require("../../logic/roles/getRoleRegistry");
+Object.defineProperty(exports, "getRoleRegistry", { enumerable: true, get: function () { return getRoleRegistry_1.getRoleRegistry; } });
+//# sourceMappingURL=index.js.map

package/dist/contract/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/contract/sdk/index.ts"],"names":[],"mappings":";;;AAAA,qEAAoE;AAA3D,kHAAA,eAAe,OAAA"}

package/dist/data/sdk/sdkOpenAi.js

@@ -30,7 +30,11 @@ const imagine = async (input, context) => {
         throw new helpful_errors_1.UnexpectedCodePathError('no content provided in response', {
             response,
         });
-    return response.choices[0].message.content;
+    const content = response.choices[0].message.content.trim();
+    const stripped = content.startsWith('```') && content.endsWith('```') // strip ```{ext} automatically if its just the exterior surround
+        ? content.split('\n').slice(1, -1).join('\n').trim()
+        : content;
+    return stripped;
 };
 exports.sdkOpenAi = {
     imagine,

package/dist/data/sdk/sdkOpenAi.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdkOpenAi.js","sourceRoot":"","sources":["../../../src/data/sdk/sdkOpenAi.ts"],"names":[],"mappings":";;;;;;AACA,mDAAyD;AACzD,oDAA4B;AAa5B,MAAM,OAAO,GAAG,KAAK,EACnB,KAAa,EACb,OAAwC,EACvB,EAAE;IACnB,MAAM,MAAM,GAAG,IAAI,gBAAM,CAAC;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;KAChC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACpD,eAAe,EACb,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;YAClC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE;YACzB,CAAC,CAAC,SAAS;QACf,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,KAAK;aACf;SACF;QACD,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK;KAChC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACtB,MAAM,IAAI,wCAAuB,CAC/B,iDAAiD,EACjD,EAAE,QAAQ,EAAE,CACb,CAAC;IACJ,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAC7B,MAAM,IAAI,wCAAuB,CAC/B,wCAAwC,EACxC,EAAE,QAAQ,EAAE,CACb,CAAC;IACJ,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;QACtC,MAAM,IAAI,wCAAuB,CAAC,iCAAiC,EAAE;YACnE,QAAQ;SACT,CAAC,CAAC;IACL,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC;AAC7C,CAAC,CAAC;AAEW,QAAA,SAAS,GAAG;IACvB,OAAO;CACR,CAAC"}
+{"version":3,"file":"sdkOpenAi.js","sourceRoot":"","sources":["../../../src/data/sdk/sdkOpenAi.ts"],"names":[],"mappings":";;;;;;AACA,mDAAyD;AACzD,oDAA4B;AAa5B,MAAM,OAAO,GAAG,KAAK,EACnB,KAAa,EACb,OAAwC,EACvB,EAAE;IACnB,MAAM,MAAM,GAAG,IAAI,gBAAM,CAAC;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;KAChC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC;QACpD,eAAe,EACb,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;YAClC,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE;YACzB,CAAC,CAAC,SAAS;QACf,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,KAAK;aACf;SACF;QACD,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK;KAChC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QACtB,MAAM,IAAI,wCAAuB,CAC/B,iDAAiD,EACjD,EAAE,QAAQ,EAAE,CACb,CAAC;IACJ,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QAC7B,MAAM,IAAI,wCAAuB,CAC/B,wCAAwC,EACxC,EAAE,QAAQ,EAAE,CACb,CAAC;IACJ,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO;QACtC,MAAM,IAAI,wCAAuB,CAAC,iCAAiC,EAAE;YACnE,QAAQ;SACT,CAAC,CAAC;IACL,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;IAC3D,MAAM,QAAQ,GACZ,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,iEAAiE;QACpH,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QACpD,CAAC,CAAC,OAAO,CAAC;IACd,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEW,QAAA,SAAS,GAAG;IACvB,OAAO;CACR,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './contract/sdk';

package/dist/index.js

@@ -1,2 +1,18 @@
 "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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./contract/sdk"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}

package/dist/logic/artifact/asDotRhachetFile.d.ts

@@ -0,0 +1,5 @@
+/**
+ * .what = computes dir from input path as `.rhachet/{key}/` next to the given file
+ * .why = allows tools to store metadata or config files locally and consistently
+ */
+export declare const asDotRhachetDir: (from: string) => string;

package/dist/logic/artifact/asDotRhachetFile.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.asDotRhachetDir = void 0;
+const path_1 = require("path");
+/**
+ * .what = computes dir from input path as `.rhachet/{key}/` next to the given file
+ * .why = allows tools to store metadata or config files locally and consistently
+ */
+const asDotRhachetDir = (from) => {
+    const baseDir = (0, path_1.dirname)(from);
+    const baseKey = (0, path_1.basename)(from);
+    const rhachetDir = (0, path_1.join)(baseDir, '.rhachet', baseKey);
+    return rhachetDir;
+};
+exports.asDotRhachetDir = asDotRhachetDir;
+//# sourceMappingURL=asDotRhachetFile.js.map

package/dist/logic/artifact/asDotRhachetFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asDotRhachetFile.js","sourceRoot":"","sources":["../../../src/logic/artifact/asDotRhachetFile.ts"],"names":[],"mappings":";;;AAAA,+BAA+C;AAE/C;;;GAGG;AACI,MAAM,eAAe,GAAG,CAAC,IAAY,EAAU,EAAE;IACtD,MAAM,OAAO,GAAG,IAAA,cAAO,EAAC,IAAI,CAAC,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAA,eAAQ,EAAC,IAAI,CAAC,CAAC;IAC/B,MAAM,UAAU,GAAG,IAAA,WAAI,EAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;IACtD,OAAO,UAAU,CAAC;AACpB,CAAC,CAAC;AALW,QAAA,eAAe,mBAK1B"}

package/dist/logic/artifact/genLoopFeedback.d.ts

@@ -0,0 +1,18 @@
+import { GStitcher, Threads, RoleContext, StitchCycle, Stitcher, GStitcherOf } from 'rhachet';
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+export declare const genLoopFeedback: <TStitchee extends string, TArtee extends string, TRepeatee extends Stitcher<GStitcher<any, any, any>>, TThreads extends GStitcherOf<TRepeatee>["threads"], TContext extends GStitcherOf<TRepeatee>["context"]>({ stitchee, artee, repeatee, halter, }: {
+    stitchee: TStitchee;
+    artee: TArtee;
+    repeatee: TRepeatee;
+    halter?: StitchCycle<any>['halter'];
+}) => Stitcher<GStitcher<Threads<{ [K in keyof TThreads & string]: RoleContext<K, K extends "caller" ? TThreads["caller"]["context"]["stash"] & {
+    ask: string;
+    art: {
+        feedback: Artifact<typeof GitFile>;
+    };
+} : K extends TStitchee ? TThreads[TStitchee]["context"]["stash"] & {
+    art: { [P in TArtee]: Artifact<typeof GitFile, string>; };
+} : TThreads[K]["context"]["stash"]>; }>, TContext, {
+    feedback: GitFile | null;
+}>>;

package/dist/logic/artifact/genLoopFeedback.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.genLoopFeedback = void 0;
+const rhachet_1 = require("rhachet");
+const genStepGrabCallerFeedbackToArtifact_1 = require("./genStepGrabCallerFeedbackToArtifact");
+const genLoopFeedback = ({ stitchee, artee, repeatee, halter, }) => {
+    const stepGetFeedback = (0, genStepGrabCallerFeedbackToArtifact_1.genStepGrabCallerFeedbackToArtifact)({
+        stitchee,
+        artee,
+    });
+    const route = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
+        slug: `[${stitchee}]<write>(<repeatee>-><write>-><feedback>)`,
+        readme: `@[${stitchee}] imagines, writes, then @[caller] gives feedback`,
+        sequence: [repeatee, (0, rhachet_1.asStitcher)(stepGetFeedback)],
+    }));
+    const stepDecide = new rhachet_1.StitchStepCompute({
+        form: 'COMPUTE',
+        slug: `[caller]<feedback><hasNotes?>`,
+        stitchee: 'caller',
+        readme: `check if feedback has content`,
+        invoke: async ({ threads }) => {
+            const thread = threads.caller;
+            const feedback = await thread.context.stash.art.feedback.get();
+            return {
+                input: { feedback },
+                output: { choice: feedback ? 'repeat' : 'release' },
+            };
+        },
+    });
+    const cycle = (0, rhachet_1.asStitcher)((0, rhachet_1.genStitchCycle)({
+        slug: `${repeatee.slug}<🌀loop:feedback>`,
+        readme: `@${repeatee.slug} -> @[caller]<feedback> -> { notes? repeat, none?: <release> }`,
+        repeatee: (0, rhachet_1.asStitcher)(route),
+        decider: (0, rhachet_1.asStitcher)(stepDecide),
+        halter,
+    }));
+    return cycle;
+};
+exports.genLoopFeedback = genLoopFeedback;
+//# sourceMappingURL=genLoopFeedback.js.map

package/dist/logic/artifact/genLoopFeedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genLoopFeedback.js","sourceRoot":"","sources":["../../../src/logic/artifact/genLoopFeedback.ts"],"names":[],"mappings":";;;AAAA,qCAaiB;AAIjB,+FAA4F;AAErF,MAAM,eAAe,GAAG,CAM7B,EACA,QAAQ,EACR,KAAK,EACL,QAAQ,EACR,MAAM,GAMP,EAuBC,EAAE;IACF,MAAM,eAAe,GAAG,IAAA,yEAAmC,EAIzD;QACA,QAAQ;QACR,KAAK;KACN,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAA,wBAAc,EAC1B,IAAA,wBAAc,EAAC;QACb,IAAI,EAAE,IAAI,QAAQ,2CAA2C;QAC7D,MAAM,EAAE,KAAK,QAAQ,mDAAmD;QACxE,QAAQ,EAAE,CAAC,QAAe,EAAE,IAAA,oBAAU,EAAC,eAAe,CAAC,CAAC;KACzD,CAAQ,CACV,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,2BAAiB,CAMtC;QACA,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,+BAA+B;QACrC,QAAQ,EAAE,QAAiB;QAC3B,MAAM,EAAE,+BAA+B;QACvC,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;YAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,MAEtB,CAAC;YACF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC;YAC/D,OAAO;gBACL,KAAK,EAAE,EAAE,QAAQ,EAAE;gBACnB,MAAM,EAAE,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EAAE;aACpD,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAA,oBAAU,EACtB,IAAA,wBAAc,EAAC;QACb,IAAI,EAAE,GAAG,QAAQ,CAAC,IAAI,mBAAmB;QACzC,MAAM,EAAE,IAAI,QAAQ,CAAC,IAAI,gEAAgE;QACzF,QAAQ,EAAE,IAAA,oBAAU,EAAC,KAAK,CAAC;QAC3B,OAAO,EAAE,IAAA,oBAAU,EAAC,UAAU,CAAC;QAC/B,MAAM;KACP,CAAC,CACH,CAAC;IAEF,OAAO,KAAY,CAAC;AACtB,CAAC,CAAC;AA3FW,QAAA,eAAe,mBA2F1B"}

package/dist/logic/artifact/genStepArtSet.d.ts

@@ -7,7 +7,8 @@ import { GitFile } from 'rhachet-artifact-git';
  */
 export declare const genStepArtSet: <TStitchee extends string, TArtee extends string, TThreads extends Threads<{ [K in TStitchee]: RoleContext<K, {
     art: { [P in TArtee]: Artifact<typeof GitFile, string>; };
-}>; }>>({ stitchee, artee, }: {
+}>; }>>({ stitchee, artee, mode, }: {
     stitchee: TStitchee;
     artee: TArtee;
+    mode?: 'upsert' | 'append';
 }) => StitchStepCompute<GStitcher<TThreads, import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, GitFile>>;

package/dist/logic/artifact/genStepArtSet.js

@@ -3,11 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.genStepArtSet = void 0;
 const helpful_errors_1 = require("helpful-errors");
 const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
 /**
  * .what = creates a compute step that sets content onto a thread's stashed artifact
  * .why  = allows downstream steps to persist imagined or computed content into code artifacts
  */
-const genStepArtSet = ({ stitchee, artee, }) => new rhachet_1.StitchStepCompute({
+const genStepArtSet = ({ stitchee, artee, mode = 'upsert', }) => new rhachet_1.StitchStepCompute({
     form: 'COMPUTE',
     readme: null,
     slug: `[${stitchee}]<artifact:set>[${artee}]`,
@@ -15,14 +16,33 @@ const genStepArtSet = ({ stitchee, artee, }) => new rhachet_1.StitchStepCompute(
     invoke: async ({ threads }) => {
         const thread = threads[stitchee];
         const artifact = thread.context.stash.art[artee];
-        const content = (0, rhachet_1.getStitch)({
+        // grab the content to write
+        const contentAddition = (0, rhachet_1.getStitch)({
             from: thread.stitches,
             where: (stitch) => 'content' in stitch.output &&
                 typeof stitch.output.content === 'string',
         })?.output.content ??
             helpful_errors_1.UnexpectedCodePathError.throw('could not find stitch with output.content', { thread });
-        const output = await artifact.set({ content });
-        return { input: { artifact, content }, output };
+        // decide what to set to the artifact
+        const contentOutcome = await (async () => {
+            // if its an upsert, then replace the content
+            if (mode === 'upsert')
+                return contentAddition;
+            // if its an append, then append the content
+            if (mode === 'append')
+                return [
+                    (await artifact.get())?.content,
+                    '',
+                    '---',
+                    '',
+                    contentAddition,
+                ].join('\n');
+            // otherwise, unexpected
+            throw new helpful_errors_1.UnexpectedCodePathError('unsupported mode', { mode });
+        })();
+        const output = await artifact.set({ content: contentOutcome });
+        console.log(`🎨️  art.${mode}ed, saved to ${artifact.ref.uri.replace(await (0, rhachet_artifact_git_1.getGitRepoRoot)({ from: process.cwd() }), '')}\n`);
+        return { input: { mode, artifact, content: contentAddition }, output };
     },
 });
 exports.genStepArtSet = genStepArtSet;

package/dist/logic/artifact/genStepArtSet.js.map

@@ -1 +1 @@
-{"version":3,"file":"genStepArtSet.js","sourceRoot":"","sources":["../../../src/logic/artifact/genStepArtSet.ts"],"names":[],"mappings":";;;AAAA,mDAAyD;AACzD,qCAQiB;AAIjB;;;GAGG;AACI,MAAM,aAAa,GAAG,CAa3B,EACA,QAAQ,EACR,KAAK,GAIN,EAAE,EAAE,CACH,IAAI,2BAAiB,CAAqD;IACxE,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI,QAAQ,mBAAmB,KAAK,GAAG;IAC7C,QAAQ;IACR,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAS9B,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEjD,MAAM,OAAO,GACX,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,MAAM,CAAC,QAAQ;YACrB,KAAK,EAAE,CAAC,MAAM,EAAyC,EAAE,CACvD,SAAS,IAAI,MAAM,CAAC,MAAM;gBAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ;SAC5C,CAAC,EAAE,MAAM,CAAC,OAAO;YAClB,wCAAuB,CAAC,KAAK,CAC3B,2CAA2C,EAC3C,EAAE,MAAM,EAAE,CACX,CAAC;QAEJ,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;QAC/C,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC;IAClD,CAAC;CACF,CAAC,CAAC;AArDQ,QAAA,aAAa,iBAqDrB"}
+{"version":3,"file":"genStepArtSet.js","sourceRoot":"","sources":["../../../src/logic/artifact/genStepArtSet.ts"],"names":[],"mappings":";;;AAAA,mDAAyD;AACzD,qCAQiB;AAEjB,+DAA+D;AAE/D;;;GAGG;AACI,MAAM,aAAa,GAAG,CAa3B,EACA,QAAQ,EACR,KAAK,EACL,IAAI,GAAG,QAAQ,GAKhB,EAAE,EAAE,CACH,IAAI,2BAAiB,CAAqD;IACxE,IAAI,EAAE,SAAS;IACf,MAAM,EAAE,IAAI;IACZ,IAAI,EAAE,IAAI,QAAQ,mBAAmB,KAAK,GAAG;IAC7C,QAAQ;IACR,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAS9B,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEjD,4BAA4B;QAC5B,MAAM,eAAe,GACnB,IAAA,mBAAS,EAAC;YACR,IAAI,EAAE,MAAM,CAAC,QAAQ;YACrB,KAAK,EAAE,CAAC,MAAM,EAAyC,EAAE,CACvD,SAAS,IAAI,MAAM,CAAC,MAAM;gBAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,KAAK,QAAQ;SAC5C,CAAC,EAAE,MAAM,CAAC,OAAO;YAClB,wCAAuB,CAAC,KAAK,CAC3B,2CAA2C,EAC3C,EAAE,MAAM,EAAE,CACX,CAAC;QAEJ,qCAAqC;QACrC,MAAM,cAAc,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE;YACvC,6CAA6C;YAC7C,IAAI,IAAI,KAAK,QAAQ;gBAAE,OAAO,eAAe,CAAC;YAE9C,4CAA4C;YAC5C,IAAI,IAAI,KAAK,QAAQ;gBACnB,OAAO;oBACL,CAAC,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO;oBAC/B,EAAE;oBACF,KAAK;oBACL,EAAE;oBACF,eAAe;iBAChB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEf,wBAAwB;YACxB,MAAM,IAAI,wCAAuB,CAAC,kBAAkB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAClE,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,CAAC,CAAC;QAE/D,OAAO,CAAC,GAAG,CACT,YAAY,IAAI,gBAAgB,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CACtD,MAAM,IAAA,qCAAc,EAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAC7C,EAAE,CACH,IAAI,CACN,CAAC;QAEF,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,EAAE,EAAE,MAAM,EAAE,CAAC;IACzE,CAAC;CACF,CAAC,CAAC;AAnFQ,QAAA,aAAa,iBAmFrB"}

package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.js

@@ -73,6 +73,13 @@ const genStepGrabCallerFeedbackToArtifact = ({ stitchee, artee, }) => new rhache
         const updated = await feedbackArt.set({
             content: feedback,
         });
+        console.log('');
+        console.log(`🎙️  heard, saved to ${feedbackArt.ref.uri}`);
+        console.log('');
+        console.log(feedback);
+        console.log('');
+        console.log('🫡  on it!');
+        console.log('');
         // return the feedback file
         return {
             input: target,

package/dist/logic/artifact/genStepGrabCallerFeedbackToArtifact.js.map

@@ -1 +1 @@
-{"version":3,"file":"genStepGrabCallerFeedbackToArtifact.js","sourceRoot":"","sources":["../../../src/logic/artifact/genStepGrabCallerFeedbackToArtifact.ts"],"names":[],"mappings":";;;;;;AAAA,wDAAgC;AAChC,qCAMiB;AAIjB;;;GAGG;AACI,MAAM,mCAAmC,GAAG,CAWjD,EACA,QAAQ,EACR,KAAK,GAIN,EAAE,EAAE,CACH,IAAI,2BAAiB,CAEnB;IACA,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,+BAA+B,QAAQ,IAAI,KAAK,GAAG;IACzD,MAAM,EAAE,+BAA+B,QAAQ,MAAM,KAAK,uCAAuC;IACjG,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,8BAA8B;QAC9B,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAKrC,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;aACxD,GAAG,EAAE;aACL,MAAM,CAAC,WAAW,CAAC,CAAC;QAEvB,2CAA2C;QAC3C,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QAErD,4CAA4C;QAC5C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,kBAAQ,CAAC,MAAM,CAAuB;YAC/D;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,aAAa;gBACtB,OAAO,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;aACnC;SACF,CAAC,CAAC;QAEH,wBAAwB;QACxB,MAAM,YAAY,GAAG,OAAO,CAAC,MAE5B,CAAC;QACF,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;QAE5D,yCAAyC;QACzC,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,mCAAmC;YAC5D,OAAO;gBACL,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC3B,CAAC;QACJ,CAAC;QAED,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE;YACjC,sBAAsB;YACtB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,kBAAQ,CAAC,MAAM,CAAyB;gBACnE;oBACE,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,+CAA+C;iBACzD;aACF,CAAC,CAAC;YAEH,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC;YACtD,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,4CAA4C;gBAC5C,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1C,CAAC;YAED,kCAAkC;YAClC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,kBAAQ,CAAC,MAAM,CAAyB;gBACnE;oBACE,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,2BAA2B;oBACpC,OAAO,EAAE,yCAAyC;iBACnD;aACF,CAAC,CAAC;YAEH,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC,EAAE,CAAC;QAEL,4CAA4C;QAC5C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC;YACpC,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;QAEH,2BAA2B;QAC3B,OAAO;YACL,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;SAC9B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AA1GQ,QAAA,mCAAmC,uCA0G3C"}
+{"version":3,"file":"genStepGrabCallerFeedbackToArtifact.js","sourceRoot":"","sources":["../../../src/logic/artifact/genStepGrabCallerFeedbackToArtifact.ts"],"names":[],"mappings":";;;;;;AAAA,wDAAgC;AAChC,qCAMiB;AAIjB;;;GAGG;AACI,MAAM,mCAAmC,GAAG,CAWjD,EACA,QAAQ,EACR,KAAK,GAIN,EAAE,EAAE,CACH,IAAI,2BAAiB,CAEnB;IACA,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,+BAA+B,QAAQ,IAAI,KAAK,GAAG;IACzD,MAAM,EAAE,+BAA+B,QAAQ,MAAM,KAAK,uCAAuC;IACjG,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,8BAA8B;QAC9B,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAKrC,CAAC;QACF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC;aACxD,GAAG,EAAE;aACL,MAAM,CAAC,WAAW,CAAC,CAAC;QAEvB,2CAA2C;QAC3C,OAAO,CAAC,GAAG,CAAC,yBAAyB,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QAErD,4CAA4C;QAC5C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,kBAAQ,CAAC,MAAM,CAAuB;YAC/D;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,aAAa;gBACtB,OAAO,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;aACnC;SACF,CAAC,CAAC;QAEH,wBAAwB;QACxB,MAAM,YAAY,GAAG,OAAO,CAAC,MAE5B,CAAC;QACF,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;QAE5D,yCAAyC;QACzC,IAAI,QAAQ,KAAK,UAAU,EAAE,CAAC;YAC5B,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,mCAAmC;YAC5D,OAAO;gBACL,KAAK,EAAE,MAAM;gBACb,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;aAC3B,CAAC;QACJ,CAAC;QAED,8DAA8D;QAC9D,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE;YACjC,sBAAsB;YACtB,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,kBAAQ,CAAC,MAAM,CAAyB;gBACnE;oBACE,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,+CAA+C;iBACzD;aACF,CAAC,CAAC;YAEH,MAAM,eAAe,GAAG,UAAU,CAAC,IAAI,EAAE,KAAK,OAAO,CAAC;YACtD,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,4CAA4C;gBAC5C,OAAO,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC1C,CAAC;YAED,kCAAkC;YAClC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,kBAAQ,CAAC,MAAM,CAAyB;gBACnE;oBACE,IAAI,EAAE,QAAQ;oBACd,IAAI,EAAE,YAAY;oBAClB,OAAO,EAAE,2BAA2B;oBACpC,OAAO,EAAE,yCAAyC;iBACnD;aACF,CAAC,CAAC;YAEH,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC,EAAE,CAAC;QAEL,4CAA4C;QAC5C,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,GAAG,CAAC;YACpC,OAAO,EAAE,QAAQ;SAClB,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,wBAAwB,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtB,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAEhB,2BAA2B;QAC3B,OAAO;YACL,KAAK,EAAE,MAAM;YACb,MAAM,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE;SAC9B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAlHQ,QAAA,mCAAmC,uCAkH3C"}

package/dist/logic/artifact/genStepResetFeedback.d.ts

@@ -0,0 +1,12 @@
+import { StitchStepCompute, GStitcher, Threads, RoleContext } from 'rhachet';
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+export declare const stepResetFeedback: StitchStepCompute<GStitcher<Threads<{
+    caller: RoleContext<'caller', {
+        art: {
+            feedback: Artifact<typeof GitFile>;
+        };
+    }>;
+}>, import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: null;
+}>>;

package/dist/logic/artifact/genStepResetFeedback.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stepResetFeedback = void 0;
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+/**
+ * .what = creates a compute step that clears out the caller.art.feedback file
+ * .why = ensures feedback state is reset before new input is gathered
+ */
+const genStepResetFeedback = (input) => new rhachet_1.StitchStepCompute({
+    form: 'COMPUTE',
+    slug: `[caller]<feedback><reset>`,
+    readme: `clears caller.art.feedback (resets it to null)`,
+    stitchee: 'caller',
+    invoke: async ({ threads }) => {
+        const callerThread = threads.caller;
+        const feedbackArt = callerThread.context.stash.art.feedback;
+        await feedbackArt.del();
+        console.log(`🧹 [feedback]<reset>: ${feedbackArt.ref.uri.replace(await (0, rhachet_artifact_git_1.getGitRepoRoot)({ from: process.cwd() }), '')}\n`);
+        return {
+            input: null,
+            output: { feedback: null },
+        };
+    },
+});
+exports.stepResetFeedback = genStepResetFeedback();
+//# sourceMappingURL=genStepResetFeedback.js.map

package/dist/logic/artifact/genStepResetFeedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genStepResetFeedback.js","sourceRoot":"","sources":["../../../src/logic/artifact/genStepResetFeedback.ts"],"names":[],"mappings":";;;AAAA,qCAMiB;AAEjB,+DAA+D;AAG/D;;;GAGG;AACH,MAAM,oBAAoB,GAAG,CAY3B,KAAa,EACb,EAAE,CACF,IAAI,2BAAiB,CAEnB;IACA,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,2BAA2B;IACjC,MAAM,EAAE,gDAAgD;IACxD,QAAQ,EAAE,QAAQ;IAClB,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,YAAY,GAAG,OAAO,CAAC,MAE5B,CAAC;QAEF,MAAM,WAAW,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;QAE5D,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC;QAExB,OAAO,CAAC,GAAG,CACT,yBAAyB,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAClD,MAAM,IAAA,qCAAc,EAAC,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAC7C,EAAE,CACH,IAAI,CACN,CAAC;QAEF,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;SAC3B,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEQ,QAAA,iBAAiB,GAAG,oBAAoB,EAAE,CAAC"}

package/dist/logic/artifact/genStepSwapArtifact.d.ts

@@ -0,0 +1,57 @@
+import { StitchStepCompute, GStitcher, Threads, RoleContext } from 'rhachet';
+import { Artifact } from 'rhachet-artifact';
+/**
+ * .what = a step which takes an getArteeFrom(@[$stitchee]) and sets it as @[$stitchee].[$artee]
+ * .why.cases =
+ *   - enables swap out of which artifact is in inflight between steps (e.g., <diverge> -> <collect>)
+ *   - enables swap out of which artifact is in upstream between flights (e.g., <diverge> -> <collect)
+ *
+ * !: do not use this directly. useGenStepSwapArtifact should be used directly instead for a pit-of-success
+ */
+export declare const genStepSwapArtifact: <TThreads extends Threads<any>, TFromStitchee extends keyof TThreads & string, TFromArtee extends keyof TThreads[TFromStitchee]["context"]["stash"]["art"] & string, TOntoStitchee extends keyof TThreads & string, TOntoArtee extends string>({ use: from, as: onto, }: {
+    use: {
+        stitchee: TFromStitchee;
+        artee: TFromArtee;
+    };
+    as: {
+        stitchee: TOntoStitchee;
+        artee: TOntoArtee;
+    };
+}) => StitchStepCompute<GStitcher<Threads<{ [K in TFromStitchee | TOntoStitchee]: RoleContext<K, {
+    art: K extends TFromStitchee ? K extends TOntoStitchee ? Record<string, unknown> & { [P in TFromArtee]: Artifact<any, string>; } & { [P_1 in TOntoArtee]: Artifact<any, string> | null; } : Record<string, unknown> & { [P_2 in TFromArtee]: Artifact<any, string>; } : K extends TOntoStitchee ? Record<string, unknown> & { [P_3 in TOntoArtee]: Artifact<any, string> | null; } : Record<string, unknown>;
+}>; }>, import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    from: {
+        stitchee: TFromStitchee;
+        artee: TFromArtee;
+    } & {
+        artifact: Pick<Artifact<any>, 'ref'>;
+    };
+    onto: {
+        stitchee: TOntoStitchee;
+        artee: TOntoArtee;
+    };
+}>>;
+/**
+ *.what = prepares a pre-bound generator for `SwapArtifact` steps, using a specific `Threads<T>` context
+ * .why = enables inline, type-safe creation of `SwapArtifact` steps without repeating thread type declarations
+ *   - ensures that artifact keys (`use`, `as`) exist within the declared thread structure
+ *   - streamlines definition of multiple swaps in routes without type repetition
+ *
+ * @example
+ * const swapArt = useGenStepSwapArtifactFor<StitcherDesired['threads']>();
+ * swapArt({
+ *   // set @thinker[inflight] = @thinker.inflights.diverge
+ *   use: { stitchee: 'thinker', artee: 'inflights.diverge' },
+ *   as:  { stitchee: 'thinker', artee: 'inflight' },
+ * });
+ */
+export declare const useGenStepSwapArtifactFor: <TThreads extends Threads<any>>() => <TFromStitchee extends keyof TThreads & string, TFromArtee extends keyof TThreads[TFromStitchee]["context"]["stash"]["art"] & string, TOntoStitchee extends keyof TThreads & string, TOntoArtee extends string>(input: {
+    use: {
+        stitchee: TFromStitchee;
+        artee: TFromArtee;
+    };
+    as: {
+        stitchee: TOntoStitchee;
+        artee: TOntoArtee;
+    };
+}) => StitchStepCompute<GStitcher<TThreads, GStitcher['context'], any>>;

package/dist/logic/artifact/genStepSwapArtifact.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useGenStepSwapArtifactFor = exports.genStepSwapArtifact = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const rhachet_1 = require("rhachet");
+/**
+ * .what = a step which takes an getArteeFrom(@[$stitchee]) and sets it as @[$stitchee].[$artee]
+ * .why.cases =
+ *   - enables swap out of which artifact is in inflight between steps (e.g., <diverge> -> <collect>)
+ *   - enables swap out of which artifact is in upstream between flights (e.g., <diverge> -> <collect)
+ *
+ * !: do not use this directly. useGenStepSwapArtifact should be used directly instead for a pit-of-success
+ */
+const genStepSwapArtifact = ({ use: from, as: onto, }) => new rhachet_1.StitchStepCompute({
+    form: 'COMPUTE',
+    slug: `[${onto.stitchee}]<artifact:swap>[${onto.artee}]`,
+    readme: `set @${onto.stitchee}.art.${onto.artee} = @${from.stitchee}.art.${from.artee}`,
+    stitchee: onto.stitchee,
+    invoke: async ({ threads }) => {
+        const fromThread = threads[from.stitchee];
+        const ontoThread = threads[onto.stitchee];
+        const artifact = fromThread.context.stash.art[from.artee] ??
+            helpful_errors_1.UnexpectedCodePathError.throw(`could not resolve artifact from @${from.stitchee}[art:${from.artee}]`, {
+                fromDef: from,
+                fromStash: fromThread.context.stash,
+            });
+        ontoThread.context.stash.art[onto.artee] = artifact;
+        return {
+            input: { from, onto },
+            output: {
+                from: {
+                    stitchee: from.stitchee,
+                    artee: from.artee,
+                    artifact: { ref: artifact.ref },
+                },
+                onto,
+            },
+        };
+    },
+});
+exports.genStepSwapArtifact = genStepSwapArtifact;
+/**
+ *.what = prepares a pre-bound generator for `SwapArtifact` steps, using a specific `Threads<T>` context
+ * .why = enables inline, type-safe creation of `SwapArtifact` steps without repeating thread type declarations
+ *   - ensures that artifact keys (`use`, `as`) exist within the declared thread structure
+ *   - streamlines definition of multiple swaps in routes without type repetition
+ *
+ * @example
+ * const swapArt = useGenStepSwapArtifactFor<StitcherDesired['threads']>();
+ * swapArt({
+ *   // set @thinker[inflight] = @thinker.inflights.diverge
+ *   use: { stitchee: 'thinker', artee: 'inflights.diverge' },
+ *   as:  { stitchee: 'thinker', artee: 'inflight' },
+ * });
+ */
+const useGenStepSwapArtifactFor = () => (input) => (0, exports.genStepSwapArtifact)(input);
+exports.useGenStepSwapArtifactFor = useGenStepSwapArtifactFor;
+//# sourceMappingURL=genStepSwapArtifact.js.map

package/dist/logic/artifact/genStepSwapArtifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"genStepSwapArtifact.js","sourceRoot":"","sources":["../../../src/logic/artifact/genStepSwapArtifact.ts"],"names":[],"mappings":";;;AAAA,mDAAyD;AACzD,qCAMiB;AAGjB;;;;;;;GAOG;AACI,MAAM,mBAAmB,GAAG,CAOjC,EACA,GAAG,EAAE,IAAI,EACT,EAAE,EAAE,IAAI,GAIT,EAAE,EAAE,CACH,IAAI,2BAAiB,CA4BnB;IACA,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,IAAI,IAAI,CAAC,QAAQ,oBAAoB,IAAI,CAAC,KAAK,GAAG;IACxD,MAAM,EAAE,QAAQ,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,KAAK,OAAO,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,KAAK,EAAE;IACvF,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAOvC,CAAC;QACF,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,QAAQ,CAOvC,CAAC;QAEF,MAAM,QAAQ,GACZ,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;YACxC,wCAAuB,CAAC,KAAK,CAC3B,oCAAoC,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,KAAK,GAAG,EACtE;gBACE,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK;aACpC,CACF,CAAC;QAEJ,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;QAEpD,OAAO;YACL,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;YACrB,MAAM,EAAE;gBACN,IAAI,EAAE;oBACJ,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,KAAK,EAAE,IAAI,CAAC,KAAK;oBACjB,QAAQ,EAAE,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE;iBAChC;gBACD,IAAI;aACL;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAzFQ,QAAA,mBAAmB,uBAyF3B;AAEL;;;;;;;;;;;;;GAaG;AACI,MAAM,yBAAyB,GACpC,GAAkC,EAAE,CACpC,CAME,KAGD,EAAqE,EAAE,CACtE,IAAA,2BAAmB,EAMjB,KAAK,CAAQ,CAAC;AAlBP,QAAA,yBAAyB,6BAkBlB"}