rhachet-roles-ehmpathy 1.0.0 → 1.2.0

package/dist/logic/roles/mechanic/codediff/routeJudgeReleasable.template.md

@@ -0,0 +1,67 @@
+directive
+- <codediff><judge> the [diff] for release readiness
+  - input = [diff], [claims], [feedback]
+  - output must be a plain json object:
+    {
+      releasable: boolean,
+      reason: string,
+      blockers: number,
+      grade: {
+        functional: 'A' | 'B' | 'C' | 'D' | 'F',
+        technical: {
+          readable: 'A' | 'B' | 'C' | 'D' | 'F',
+          consistent: 'A' | 'B' | 'C' | 'D' | 'F',
+          maintainable: 'A' | 'B' | 'C' | 'D' | 'F'
+        }
+      }
+    }
+  - output only the json content itself. no ```'s, straight valid json
+
+context.role.traits
+- act as final gatekeeper for code releases
+- reject any code with unresolved blockers
+- reason concisely, focus on decision criteria
+- score functional and technical quality separately
+- evaluate technical quality across readability, consistency, maintainability
+
+$.rhachet{inherit.traits}
+
+context.role.skills
+$.rhachet{inherit.skills}
+
+directive
+- <codediff><judge> the [diff]
+  - input = [diff], [claims], [feedback]
+  - output must be a plain json object:
+    {
+      releasable: boolean,        // false if there are *any* blockers
+      reason: string,             // short rationale behind the decision
+      blockers: number,           // count of blocker items in feedback
+      grade: {
+        functional: 'A' | 'B' | 'C' | 'D' | 'F',
+        technical: {
+          readable: 'A' | 'B' | 'C' | 'D' | 'F',
+          consistent: 'A' | 'B' | 'C' | 'D' | 'F',
+          maintainable: 'A' | 'B' | 'C' | 'D' | 'F'
+        }
+      }
+    }
+  - output only the json content itself. no ```'s, straight valid json
+
+grading logic:
+- functional: how well the diff aligns with the claims
+- technical.readable: clarity of naming, structure, and documentation
+- technical.consistent: style, format, and adherence to established patterns
+- technical.maintainable: modularity, testability, future-proofing
+- if blockers > 0 → releasable must be false
+
+--------------------------
+
+claims =
+$.rhachet{claims}
+
+diff =
+$.rhachet{diff}
+
+feedback =
+$.rhachet{feedback}

package/dist/logic/roles/mechanic/getMechanicBrief.Options.codegen.d.ts

@@ -5,6 +5,6 @@
  *  npx tsx src/contract/commands/codegenBriefOptions.ts
  * ```
  */
-declare const options: readonly ["style.compressed.md", "style.compressed.prompt.md", "style.names.treestruct.md", "style.names.ubiqlang.md", "style.words.lowercase.md", "architecture/bounded-contexts.md", "architecture/directional-dependencies.md", "architecture/domain-driven-design.md", "architecture/ubiqlang.md", "codestyle/_mech.compressed.md", "codestyle/_mech.compressed.prompt.md", "codestyle/flow.failfast.md", "codestyle/flow.idempotency.md", "codestyle/flow.immutability.md", "codestyle/flow.narratives.md", "codestyle/flow.single-responsibility.md", "codestyle/mech.args.input-context.md", "codestyle/mech.arrowonly.md", "codestyle/mech.clear-contracts.md", "codestyle/mech.tests.given-when-then.md", "codestyle/mech.what-why.md", "codestyle/mech.what-why.v2.md", "engineer/dependency-injection.md"];
+declare const options: readonly ["style.compressed.md", "style.compressed.prompt.md", "style.names.treestruct.md", "style.names.ubiqlang.md", "style.words.lowercase.md", "architecture/bounded-contexts.md", "architecture/directional-dependencies.md", "architecture/domain-driven-design.md", "architecture/ubiqlang.md", "engineer/dependency-injection.md", "codestyle/_mech.compressed.md", "codestyle/_mech.compressed.prompt.md", "codestyle/flow.failfast.md", "codestyle/flow.idempotency.md", "codestyle/flow.immutability.md", "codestyle/flow.narratives.md", "codestyle/flow.single-responsibility.md", "codestyle/mech.args.input-context.md", "codestyle/mech.args.input-inline.md", "codestyle/mech.arrowonly.md", "codestyle/mech.clear-contracts.md", "codestyle/mech.tests.given-when-then.md", "codestyle/mech.what-why.md", "codestyle/mech.what-why.v2.md", "codestyle/pit-of-success.via.minimize-surface-area.md"];
 export type BriefOptionMechanic = typeof options[number];
 export {};

package/dist/logic/roles/mechanic/getMechanicBrief.Options.codegen.js

@@ -17,6 +17,7 @@ const options = [
     'architecture/directional-dependencies.md',
     'architecture/domain-driven-design.md',
     'architecture/ubiqlang.md',
+    'engineer/dependency-injection.md',
     'codestyle/_mech.compressed.md',
     'codestyle/_mech.compressed.prompt.md',
     'codestyle/flow.failfast.md',
@@ -25,11 +26,12 @@ const options = [
     'codestyle/flow.narratives.md',
     'codestyle/flow.single-responsibility.md',
     'codestyle/mech.args.input-context.md',
+    'codestyle/mech.args.input-inline.md',
     'codestyle/mech.arrowonly.md',
     'codestyle/mech.clear-contracts.md',
     'codestyle/mech.tests.given-when-then.md',
     'codestyle/mech.what-why.md',
     'codestyle/mech.what-why.v2.md',
-    'engineer/dependency-injection.md',
+    'codestyle/pit-of-success.via.minimize-surface-area.md',
 ];
 //# sourceMappingURL=getMechanicBrief.Options.codegen.js.map

package/dist/logic/roles/mechanic/getMechanicBrief.Options.codegen.js.map

@@ -1 +1 @@
-{"version":3,"file":"getMechanicBrief.Options.codegen.js","sourceRoot":"","sources":["../../../../src/logic/roles/mechanic/getMechanicBrief.Options.codegen.ts"],"names":[],"mappings":";;AAAA;;;;;;GAMG;AACH,MAAM,OAAO,GAAG;IACd,qBAAqB;IACrB,4BAA4B;IAC5B,2BAA2B;IAC3B,yBAAyB;IACzB,0BAA0B;IAC1B,kCAAkC;IAClC,0CAA0C;IAC1C,sCAAsC;IACtC,0BAA0B;IAC1B,+BAA+B;IAC/B,sCAAsC;IACtC,4BAA4B;IAC5B,+BAA+B;IAC/B,gCAAgC;IAChC,8BAA8B;IAC9B,yCAAyC;IACzC,sCAAsC;IACtC,6BAA6B;IAC7B,mCAAmC;IACnC,yCAAyC;IACzC,4BAA4B;IAC5B,+BAA+B;IAC/B,kCAAkC;CAC1B,CAAC"}
+{"version":3,"file":"getMechanicBrief.Options.codegen.js","sourceRoot":"","sources":["../../../../src/logic/roles/mechanic/getMechanicBrief.Options.codegen.ts"],"names":[],"mappings":";;AAAA;;;;;;GAMG;AACH,MAAM,OAAO,GAAG;IACd,qBAAqB;IACrB,4BAA4B;IAC5B,2BAA2B;IAC3B,yBAAyB;IACzB,0BAA0B;IAC1B,kCAAkC;IAClC,0CAA0C;IAC1C,sCAAsC;IACtC,0BAA0B;IAC1B,kCAAkC;IAClC,+BAA+B;IAC/B,sCAAsC;IACtC,4BAA4B;IAC5B,+BAA+B;IAC/B,gCAAgC;IAChC,8BAA8B;IAC9B,yCAAyC;IACzC,sCAAsC;IACtC,qCAAqC;IACrC,6BAA6B;IAC7B,mCAAmC;IACnC,yCAAyC;IACzC,4BAA4B;IAC5B,+BAA+B;IAC/B,uDAAuD;CAC/C,CAAC"}

package/dist/logic/roles/mechanic/getMechanicRole.js

@@ -2,13 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ROLE_MECHANIC = void 0;
 const rhachet_1 = require("rhachet");
-const rhachet_artifact_git_1 = require("rhachet-artifact-git");
-const genContextLogTrail_1 = require("../../../.test/genContextLogTrail");
-const genContextStitchTrail_1 = require("../../../.test/genContextStitchTrail");
-const getContextOpenAI_1 = require("../../../.test/getContextOpenAI");
-const getRefOrgPatterns_1 = require("./codediff/getRefOrgPatterns");
-const routeMechanicCodePropose_1 = require("./codediff/routeMechanicCodePropose");
-const getMechanicBrief_1 = require("./getMechanicBrief");
+const getSkillCodePropose_1 = require("./skills/getSkillCodePropose");
+const loopWrite_skill_1 = require("./write/loopWrite.skill");
 exports.ROLE_MECHANIC = rhachet_1.Role.build({
     slug: 'mechanic',
     name: 'Mechanic',
@@ -23,135 +18,6 @@ exports.ROLE_MECHANIC = rhachet_1.Role.build({
 Used to write and revise the actual logic that runs the system.
   `.trim(),
     traits: [],
-    skills: [
-        rhachet_1.RoleSkill.build({
-            slug: 'upsert',
-            route: routeMechanicCodePropose_1.routeMechanicCodePropose,
-            // : {
-            //   target: {
-            //     char: 't',
-            //     desc: 'the target file or dir to upsert against',
-            //     shape: 'string',
-            //   },
-            // },
-            threads: {
-                lookup: {
-                    target: {
-                        source: 'process.argv',
-                        char: 't',
-                        desc: 'the target file or dir to upsert against',
-                        type: 'string',
-                    },
-                },
-                assess: (input) => typeof input.target === 'string',
-                instantiate: async (input) => {
-                    const targetArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.target });
-                    const claimsArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
-                        uri: input.target + '.rhachet.claims.md', // todo: namespace within a .rhachet directory
-                    });
-                    const feedbackArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
-                        uri: input.target + '.rhachet.feedback.md',
-                    });
-                    const feedbackCodestyleArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
-                        uri: input.target + '.rhachet.feedback.codestyle.md',
-                    });
-                    const judgementArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
-                        uri: input.target + '.rhachet.judgement.md',
-                    });
-                    return {
-                        artist: await (0, rhachet_1.enrollThread)({
-                            role: 'artist',
-                            stash: {
-                                ask: input.ask,
-                                art: { inflight: targetArt },
-                                org: {
-                                    patterns: (0, getRefOrgPatterns_1.getRefOrgPatterns)({ purpose: 'produce' }),
-                                },
-                                scene: { coderefs: [] },
-                            },
-                            inherit: {
-                                traits: [(0, getMechanicBrief_1.getMechanicBrief)('style.compressed.md')],
-                            },
-                        }),
-                        critic: await (0, rhachet_1.enrollThread)({
-                            role: 'critic',
-                            stash: {
-                                art: {
-                                    feedback: feedbackArt,
-                                    feedbackCodestyle: feedbackCodestyleArt,
-                                },
-                                org: {
-                                    patterns: (0, getRefOrgPatterns_1.getRefOrgPatterns)({ purpose: 'produce' }),
-                                },
-                            },
-                            inherit: {
-                                traits: [(0, getMechanicBrief_1.getMechanicBrief)('style.compressed.md')],
-                            },
-                        }),
-                        student: await (0, rhachet_1.enrollThread)({
-                            role: 'student',
-                            stash: { art: { claims: claimsArt } },
-                        }),
-                        judge: await (0, rhachet_1.enrollThread)({
-                            role: 'judge',
-                            stash: { art: { judgement: judgementArt } },
-                        }),
-                        mechanic: await (0, rhachet_1.enrollThread)({
-                            role: 'mechanic',
-                            stash: {},
-                        }),
-                    };
-                },
-            },
-            context: {
-                lookup: {
-                    apiKeyOpenai: {
-                        source: 'process.env',
-                        envar: 'PREP_OPENAI_KEY',
-                        desc: 'the openai key to use',
-                        type: 'string',
-                    },
-                },
-                assess: (input) => typeof input.apiKeyOpenai === 'string',
-                instantiate: (input) => {
-                    return {
-                        ...(0, getContextOpenAI_1.getContextOpenAI)(), // todo: use the input api key
-                        ...(0, genContextLogTrail_1.genContextLogTrail)(), // todo: passthrough ?
-                        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
-                    };
-                },
-            },
-            readme: `
-### \`ask -r mechanic -s upsert\`
-
-you can ask the mechanic to upsert the code in a target file or dir
-- if it exists, it'll update
-- if it doesn't, it'll create
-
-
-\`\`\`sh
-npx rhachet ask -r mechanic -s upsert -t ./path/to/file.ts "your ask"
-\`\`\`
-
-\`\`\`sh
-npx rhachet ask \
-  --role mechanic \
-  --skill upsert \
-  --target ./path/to/file.ts \
-  "your ask"
-\`\`\`
-
-once it's self reviewed, it'll ask you for feedback
-
-\`\`\`sh
-? have notes? (Use arrow keys)
-❯ no notes
-  yes notes
-\`\`\`
-
-it'll loop until you tell it you have \`no notes\`
-    `.trim(),
-        }),
-    ],
+    skills: [loopWrite_skill_1.SKILL_WRITE, getSkillCodePropose_1.SKILL_CODE_PROPOSE],
 });
 //# sourceMappingURL=getMechanicRole.js.map

package/dist/logic/roles/mechanic/getMechanicRole.js.map

@@ -1 +1 @@
-{"version":3,"file":"getMechanicRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/mechanic/getMechanicRole.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"getMechanicRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/mechanic/getMechanicRole.ts"],"names":[],"mappings":";;;AAAA,qCAA+B;AAE/B,sEAAkE;AAClE,6DAAsD;AAEzC,QAAA,aAAa,GAAG,cAAI,CAAC,KAAK,CAAC;IACtC,IAAI,EAAE,UAAU;IAChB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE;;;;;;;;GAQP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE,EAAE;IACV,MAAM,EAAE,CAAC,6BAAW,EAAE,wCAAkB,CAAC;CAC1C,CAAC,CAAC"}

package/dist/logic/roles/mechanic/skills/getSkillCodePropose.d.ts

@@ -0,0 +1,2 @@
+import { RoleSkill } from 'rhachet';
+export declare const SKILL_CODE_PROPOSE: import("domain-objects/dist/manipulation/immute/withImmute").WithImmute<RoleSkill<import("../codediff/routeMechanicCodePropose").RouteMechanicCodeProposeStitcher>>;

package/dist/logic/roles/mechanic/skills/getSkillCodePropose.js

@@ -0,0 +1,140 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_CODE_PROPOSE = void 0;
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const genContextLogTrail_1 = require("../../../../.test/genContextLogTrail");
+const genContextStitchTrail_1 = require("../../../../.test/genContextStitchTrail");
+const getContextOpenAI_1 = require("../../../../.test/getContextOpenAI");
+const getRefOrgPatterns_1 = require("../codediff/getRefOrgPatterns");
+const routeMechanicCodePropose_1 = require("../codediff/routeMechanicCodePropose");
+const getMechanicBrief_1 = require("../getMechanicBrief");
+exports.SKILL_CODE_PROPOSE = rhachet_1.RoleSkill.build({
+    slug: 'code.propose', // crafts some code
+    route: routeMechanicCodePropose_1.routeMechanicCodePropose,
+    // : {
+    //   target: {
+    //     char: 't',
+    //     desc: 'the target file or dir to upsert against',
+    //     shape: 'string',
+    //   },
+    // },
+    threads: {
+        lookup: {
+            target: {
+                source: 'process.argv',
+                char: 't',
+                desc: 'the target file or dir to upsert against',
+                type: 'string',
+            },
+        },
+        assess: (input) => typeof input.target === 'string',
+        instantiate: async (input) => {
+            const targetArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.target });
+            const claimsArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                uri: input.target + '.rhachet.claims.md', // todo: namespace within a .rhachet directory
+            });
+            const feedbackArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                uri: input.target + '.rhachet.feedback.md',
+            });
+            const feedbackCodestyleArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                uri: input.target + '.rhachet.feedback.codestyle.md',
+            });
+            const judgementArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                uri: input.target + '.rhachet.judgement.md',
+            });
+            return {
+                artist: await (0, rhachet_1.enrollThread)({
+                    role: 'artist',
+                    stash: {
+                        ask: input.ask,
+                        art: { inflight: targetArt },
+                        org: {
+                            patterns: (0, getRefOrgPatterns_1.getRefOrgPatterns)({ purpose: 'produce' }),
+                        },
+                        scene: { coderefs: [] },
+                    },
+                    inherit: {
+                        traits: [(0, getMechanicBrief_1.getMechanicBrief)('style.compressed.md')],
+                    },
+                }),
+                critic: await (0, rhachet_1.enrollThread)({
+                    role: 'critic',
+                    stash: {
+                        art: {
+                            feedback: feedbackArt,
+                            feedbackCodestyle: feedbackCodestyleArt,
+                        },
+                        org: {
+                            patterns: (0, getRefOrgPatterns_1.getRefOrgPatterns)({ purpose: 'produce' }),
+                        },
+                    },
+                    inherit: {
+                        traits: [(0, getMechanicBrief_1.getMechanicBrief)('style.compressed.md')],
+                    },
+                }),
+                student: await (0, rhachet_1.enrollThread)({
+                    role: 'student',
+                    stash: { art: { claims: claimsArt } },
+                }),
+                judge: await (0, rhachet_1.enrollThread)({
+                    role: 'judge',
+                    stash: { art: { judgement: judgementArt } },
+                }),
+                mechanic: await (0, rhachet_1.enrollThread)({
+                    role: 'mechanic',
+                    stash: {},
+                }),
+            };
+        },
+    },
+    context: {
+        lookup: {
+            apiKeyOpenai: {
+                source: 'process.env',
+                envar: 'PREP_OPENAI_KEY',
+                desc: 'the openai key to use',
+                type: 'string',
+            },
+        },
+        assess: (input) => typeof input.apiKeyOpenai === 'string',
+        instantiate: (input) => {
+            return {
+                ...(0, getContextOpenAI_1.getContextOpenAI)(), // todo: use the input api key
+                ...(0, genContextLogTrail_1.genContextLogTrail)(), // todo: passthrough ?
+                ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+            };
+        },
+    },
+    readme: `
+### \`ask -r mechanic -s code.propose\`
+
+you can ask the mechanic to upsert the code in a target file or dir
+- if it exists, it'll update
+- if it doesn't, it'll create
+
+
+\`\`\`sh
+npx rhachet ask -r mechanic -s code.propose -t ./path/to/file.ts --ask "your ask"
+\`\`\`
+
+\`\`\`sh
+npx rhachet ask \
+--role mechanic \
+--skill upsert \
+--target ./path/to/file.ts \
+"your ask"
+\`\`\`
+
+once it's self reviewed, it'll ask you for feedback
+
+\`\`\`sh
+? have notes? (Use arrow keys)
+❯ no notes
+yes notes
+\`\`\`
+
+it'll loop until you tell it you have \`no notes\`
+`.trim(),
+});
+//# sourceMappingURL=getSkillCodePropose.js.map

package/dist/logic/roles/mechanic/skills/getSkillCodePropose.js.map

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

package/dist/logic/roles/mechanic/study/routeStudyAsk.template.md

@@ -0,0 +1,73 @@
+directive
+- <study><distill> the [ask]
+  - input = ask
+  - output =
+  ```json
+  {
+      ask: { summary: string },
+      claims: { lessons[], assumptions[], questions[] },
+      cases: {
+        use: { who, when, what }[],
+        test: { form = 'positive' | 'negative', given, when, then, because }[]
+      }
+  }
+  ```
+- do not execute the [ask], only execute <study><distill>
+
+context.role.traits
+- maximally concise; prefer treestructs and outlines; maximize signal, minimize words
+- systematically distill scenes with ubiquitous language
+- uses treestructs and bullet points to maximize signal-to-noise
+- explain .what and .why with comments for each code paragraph // and each code procedure /**
+$.rhachet{inherit.traits}
+
+context.role.skills
+- tactic: <study>(ask) to determine the contract and requirements to declare in stubout
+  - declare the lessons, assumptions, and questions that you have
+  - produce a [[pool]] of [[case:use]], usecases to support
+  - produce a [[pool]] of [[case:test]], test cases to implement
+  - output =
+  ```json
+  {
+      ask: { summary: string },
+      claims: { lessons: { what, why }[], assumptions: { what, why }[], questions: { what, why }[] },
+      contract: { input, output },
+      cases: {
+        use: { who, when, what }[],
+        test: { form = 'positive' | 'negative', given, when, then, because }[]
+      }
+  }
+  ```
+- tactic: <declare>([case:use])
+  - specify in terms of { who, when, what }
+  - look for functional boundary cases and frequent cases
+- tactic: <declare>([case:test])
+  - specify in terms of { form = 'positive' | 'negative', given, when, then, because }
+  - look for hazards that could exist based on the contract or assumptions
+$.rhachet{inherit.skills}
+
+context.scene
+$.rhachet{scene}
+
+
+directive
+- <study><distill> the [ask]
+  - input = ask
+  - output =
+  ```json
+  {
+      ask: { summary: string },
+      claims: { lessons[], assumptions[], questions[] },
+      cases: {
+        use: { who, when, what }[],
+        test: { form = 'positive' | 'negative', given, when, then, because }[]
+      }
+  }
+  ```
+- do not execute the [ask], only execute <study><distill>
+
+--------------------------
+
+ask =
+
+$.rhachet{ask}

package/dist/logic/roles/mechanic/write/.test/prior.template.md

@@ -0,0 +1,21 @@
+you're an @[ecologist]. help envision the [option] the @[caller] is talking about
+
+output the updated ```md of the "vision", only. update the [vision] doc based on the @[caller]s current [comment]
+
+---
+
+here's some .briefs on the skills you have, as a refresher
+
+$.rhachet{briefs}
+
+---
+
+[vision] =
+```md
+$.rhachet{vision}
+```
+
+@[caller][comment] =
+```md
+$.rhachet{ask}
+```

package/dist/logic/roles/mechanic/write/loopWrite.d.ts

@@ -0,0 +1,25 @@
+export declare const loopWrite: import("rhachet").Stitcher<import("rhachet").GStitcher<import("rhachet").Threads<{
+    caller: import("rhachet").RoleContext<"caller", {
+        ask: string;
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string> | null;
+            references: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>[];
+        };
+    } & {
+        ask: string;
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+    mechanic: import("rhachet").RoleContext<"mechanic", {
+        art: {
+            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    } & {
+        art: {
+            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+}>, import("../../../../data/sdk/sdkOpenAi").ContextOpenAI & import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: import("rhachet-artifact-git").GitFile | null;
+}>>;

package/dist/logic/roles/mechanic/write/loopWrite.integration.test.d.ts

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

package/dist/logic/roles/mechanic/write/loopWrite.integration.test.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const test_fns_1 = require("test-fns");
+const genContextLogTrail_1 = require("../../../../.test/genContextLogTrail");
+const genContextStitchTrail_1 = require("../../../../.test/genContextStitchTrail");
+const getContextOpenAI_1 = require("../../../../.test/getContextOpenAI");
+const loopWrite_1 = require("./loopWrite");
+describe('loopWrite', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = loopWrite_1.loopWrite;
+    (0, test_fns_1.given)('we want it write a poem, from scratch', () => {
+        const askText = `
+write a poem about brevity and concise, precise language
+
+keep it between 3-5 lines
+
+use the word precise at least once
+    `.trim();
+        const inflightArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/loopWrite/poem.fromempty.inflight.md' }, { versions: true });
+        const feedbackArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/loopWrite/poem.fromempty.feedback.md' }, { versions: true });
+        beforeEach(async () => {
+            await inflightArt.del();
+        });
+        (0, test_fns_1.when)('executed', () => {
+            const threads = (0, test_fns_1.usePrep)(async () => ({
+                caller: await (0, rhachet_1.enrollThread)({
+                    role: 'caller',
+                    stash: {
+                        ask: askText,
+                        art: { feedback: feedbackArt, references: [] },
+                    },
+                }),
+                mechanic: await (0, rhachet_1.enrollThread)({
+                    role: 'mechanic',
+                    stash: {
+                        ask: askText,
+                        art: {
+                            inflight: inflightArt,
+                        },
+                    },
+                }),
+            }));
+            (0, test_fns_1.then)('upserts the artifact', async () => {
+                await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads }, context);
+                const { content } = await inflightArt.get().expect('isPresent');
+                expect(content).toContain('precise');
+            });
+        });
+    });
+});
+//# sourceMappingURL=loopWrite.integration.test.js.map

package/dist/logic/roles/mechanic/write/loopWrite.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopWrite.integration.test.js","sourceRoot":"","sources":["../../../../../src/logic/roles/mechanic/write/loopWrite.integration.test.ts"],"names":[],"mappings":";;AAAA,qCAA2D;AAC3D,+DAA0D;AAC1D,uCAAsD;AAEtD,6EAA0E;AAC1E,mFAAgF;AAChF,yEAAsE;AACtE,2CAAwC;AAExC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;IACzB,MAAM,OAAO,GAAG;QACd,GAAG,IAAA,uCAAkB,GAAE;QACvB,GAAG,IAAA,6CAAqB,GAAE;QAC1B,GAAG,IAAA,mCAAgB,GAAE;KACtB,CAAC;IACF,MAAM,KAAK,GAAG,qBAAS,CAAC;IAExB,IAAA,gBAAK,EAAC,uCAAuC,EAAE,GAAG,EAAE;QAClD,MAAM,OAAO,GAAG;;;;;;KAMf,CAAC,IAAI,EAAE,CAAC;QAET,MAAM,WAAW,GAAG,IAAA,yCAAkB,EACpC,EAAE,GAAG,EAAE,SAAS,GAAG,6CAA6C,EAAE,EAClE,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;QACF,MAAM,WAAW,GAAG,IAAA,yCAAkB,EACpC,EAAE,GAAG,EAAE,SAAS,GAAG,6CAA6C,EAAE,EAClE,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;QAEF,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,IAAA,eAAI,EAAC,UAAU,EAAE,GAAG,EAAE;YACpB,MAAM,OAAO,GAAG,IAAA,kBAAO,EAAC,KAAK,IAAI,EAAE,CAAC,CAAC;gBACnC,MAAM,EAAE,MAAM,IAAA,sBAAY,EAAC;oBACzB,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE;wBACL,GAAG,EAAE,OAAO;wBACZ,GAAG,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE;qBAC/C;iBACF,CAAC;gBACF,QAAQ,EAAE,MAAM,IAAA,sBAAY,EAAC;oBAC3B,IAAI,EAAE,UAAU;oBAChB,KAAK,EAAE;wBACL,GAAG,EAAE,OAAO;wBACZ,GAAG,EAAE;4BACH,QAAQ,EAAE,WAAW;yBACtB;qBACF;iBACF,CAAC;aACH,CAAC,CAAC,CAAC;YAEJ,IAAA,eAAI,EAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;gBACtC,MAAM,IAAA,4BAAkB,EAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;gBAEhE,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBAChE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;YACvC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/logic/roles/mechanic/write/loopWrite.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loopWrite = void 0;
+const genLoopFeedback_1 = require("../../../artifact/genLoopFeedback");
+const stepWrite_1 = require("./stepWrite");
+exports.loopWrite = (0, genLoopFeedback_1.genLoopFeedback)({
+    stitchee: 'mechanic',
+    artee: 'inflight',
+    repeatee: stepWrite_1.stepWrite,
+});
+//# sourceMappingURL=loopWrite.js.map

package/dist/logic/roles/mechanic/write/loopWrite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopWrite.js","sourceRoot":"","sources":["../../../../../src/logic/roles/mechanic/write/loopWrite.ts"],"names":[],"mappings":";;;AAAA,uEAAoE;AACpE,2CAAwC;AAE3B,QAAA,SAAS,GAAG,IAAA,iCAAe,EAAC;IACvC,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,qBAAS;CACpB,CAAC,CAAC"}

package/dist/logic/roles/mechanic/write/loopWrite.skill.d.ts

@@ -0,0 +1,25 @@
+export declare const SKILL_WRITE: import("rhachet").RoleSkill<import("rhachet").GStitcher<import("rhachet").Threads<{
+    caller: import("rhachet").RoleContext<"caller", {
+        ask: string;
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string> | null;
+            references: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>[];
+        };
+    } & {
+        ask: string;
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+    mechanic: import("rhachet").RoleContext<"mechanic", {
+        art: {
+            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    } & {
+        art: {
+            inflight: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+}>, import("../../../../data/sdk/sdkOpenAi").ContextOpenAI & import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: import("rhachet-artifact-git").GitFile | null;
+}>>;