rhachet-roles-ehmpathy 1.0.0 → 1.1.0

package/dist/logic/roles/ecologist/.briefs/term.distillation.md

@@ -0,0 +1,93 @@
+# 📘 term-selection.brief: how to distill the best term
+
+> this brief defines a systematic method to choose the **clearest, strongest term** for a concept, pattern, or unit.
+> good terms collapse synonyms, avoid confusion, and align with intuitive grasp — enabling fluent reuse across systems.
+
+---
+
+## 🧭 goals of a good term
+
+- **🧼 clarity** – avoids ambiguity and misreading
+- **🧲 gravity** – feels “right” and sticks in memory
+- **🔁 reuse** – unlocks consistent expression across contexts
+- **🧠 intuition** – fits what a first-time reader expects
+- **🧯 disambiguation** – contrasts clearly from neighbors or opposites
+
+---
+
+## ⚠️ key naming hazards
+
+| hazard            | example                     | fix                                                                 |
+|-------------------|-----------------------------|----------------------------------------------------------------------|
+| ❗ ambiguity       | `target`, `value`, `state`  | clarify the type or role (e.g. `goal`, `rank`, `setting`)            |
+| 🔀 synonym clash   | `impact` vs `effect` vs `outcome` | collapse to one canonical form with clear internal grammar          |
+| 🧱 intuition gap   | `vectorize` used for ranking | choose a more vivid or grounded term (e.g. `score`, `grade`, `weigh`) |
+| ⚓ overload        | `tag` meaning many things   | constrain usage or rename distinctly (`label`, `marker`, `flag`)     |
+
+---
+
+## 🧪 test criteria for term selection
+
+ask these when evaluating term candidates:
+
+1. **is it vivid?**
+   does it evoke the right imagery or mechanic?
+
+2. **is it distinct?**
+   does it clearly differ from adjacent terms?
+
+3. **is it reusable?**
+   can this term scale across similar use cases?
+
+4. **does it collapse synonyms?**
+   can it absorb nearby concepts under one roof?
+
+5. **does it pass the "blank slate" test?**
+   what would a first-time reader *assume* it means?
+
+---
+
+## 🔧 process to distill best term
+
+1. **collect contenders**
+   list all possible terms, including wild ideas
+
+2. **tag each**
+   note for each: clarity, conflicts, connotations, candidates it might replace
+
+3. **simulate usage**
+   plug into real example sentences or data flows
+
+4. **eliminate and converge**
+   remove fuzzy or redundant terms; prefer intuitive clarity over cleverness
+
+5. **test opposite / inverse**
+   name the inverse or contrast (e.g. if this is `<gain>`, what’s the `<drop>`?)
+
+6. **declare and lock**
+   publish as part of `.brief` or `ubiqlang`
+
+---
+
+## 📦 output format
+
+distilled term entry should include:
+
+```ts
+{
+  name: 'chance',
+  role: 'a positively motivated [option]',
+  replaces: ['opportunity', 'magnet', 'upside'],
+  inverse: 'threat',
+  test_case: '<enmotive> → <<gain>>[chance] → <choose>',
+  note: '“chance” works as a synonym for “opportunity” without implying randomness'
+}
+```
+
+---
+
+## 🧭 guidance phrases
+
+- “would this confuse someone from another domain?”
+- “can this become a root word in our grammar?”
+- “if we only had one word for this… which feels truest?”

package/dist/logic/roles/ecologist/domain.sketch/loopStudyDomain.d.ts

@@ -0,0 +1,24 @@
+export declare const loopStudyDomain: import("rhachet").Stitcher<import("rhachet").GStitcher<import("rhachet").Threads<{
+    student: import("rhachet").RoleContext<"student", {
+        art: {
+            domain: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    } & {
+        art: {
+            domain: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+    caller: import("rhachet").RoleContext<"caller", {
+        ask: string;
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string> | null;
+        };
+    } & {
+        ask: string;
+        art: {
+            feedback: 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/ecologist/domain.sketch/loopStudyDomain.integration.test.d.ts

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

package/dist/logic/roles/ecologist/domain.sketch/loopStudyDomain.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 loopStudyDomain_1 = require("./loopStudyDomain");
+describe('loopStudyDomain', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = loopStudyDomain_1.loopStudyDomain;
+    (0, test_fns_1.given)('we want to explore the home service domain', () => {
+        const askText = `
+home service domain
+- [pro] = [provider] = a brand
+- [doer] = a person under a pro
+- [nei] = [neighbor] = a local resident, manager, etc; customer
+
+neighbors need to schedule with providers
+    `.trim();
+        const inflightArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/loopStudyDomain/homeService.inflight.md' }, { versions: true });
+        const feedbackArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/loopStudyDomain/homeService.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 },
+                    },
+                }),
+                student: await (0, rhachet_1.enrollThread)({
+                    role: 'student',
+                    stash: {
+                        art: {
+                            domain: 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=loopStudyDomain.integration.test.js.map

package/dist/logic/roles/ecologist/domain.sketch/loopStudyDomain.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopStudyDomain.integration.test.js","sourceRoot":"","sources":["../../../../../src/logic/roles/ecologist/domain.sketch/loopStudyDomain.integration.test.ts"],"names":[],"mappings":";;AAAA,qCAA2D;AAC3D,+DAA0D;AAC1D,uCAAsD;AAEtD,6EAA0E;AAC1E,mFAAgF;AAChF,yEAAsE;AACtE,uDAAoD;AAEpD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,MAAM,OAAO,GAAG;QACd,GAAG,IAAA,uCAAkB,GAAE;QACvB,GAAG,IAAA,6CAAqB,GAAE;QAC1B,GAAG,IAAA,mCAAgB,GAAE;KACtB,CAAC;IACF,MAAM,KAAK,GAAG,iCAAe,CAAC;IAE9B,IAAA,gBAAK,EAAC,4CAA4C,EAAE,GAAG,EAAE;QACvD,MAAM,OAAO,GAAG;;;;;;;KAOf,CAAC,IAAI,EAAE,CAAC;QAET,MAAM,WAAW,GAAG,IAAA,yCAAkB,EACpC,EAAE,GAAG,EAAE,SAAS,GAAG,gDAAgD,EAAE,EACrE,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;QACF,MAAM,WAAW,GAAG,IAAA,yCAAkB,EACpC,EAAE,GAAG,EAAE,SAAS,GAAG,gDAAgD,EAAE,EACrE,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;qBAC/B;iBACF,CAAC;gBACF,OAAO,EAAE,MAAM,IAAA,sBAAY,EAAC;oBAC1B,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE;wBACL,GAAG,EAAE;4BACH,MAAM,EAAE,WAAW;yBACpB;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/ecologist/domain.sketch/loopStudyDomain.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loopStudyDomain = void 0;
+const genLoopFeedback_1 = require("../../../artifact/genLoopFeedback");
+const stepStudyDomain_1 = require("./stepStudyDomain");
+exports.loopStudyDomain = (0, genLoopFeedback_1.genLoopFeedback)({
+    stitchee: 'student',
+    artee: 'domain',
+    repeatee: stepStudyDomain_1.stepStudyDomain,
+});
+//# sourceMappingURL=loopStudyDomain.js.map

package/dist/logic/roles/ecologist/domain.sketch/loopStudyDomain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loopStudyDomain.js","sourceRoot":"","sources":["../../../../../src/logic/roles/ecologist/domain.sketch/loopStudyDomain.ts"],"names":[],"mappings":";;;AAAA,uEAAoE;AACpE,uDAAoD;AAEvC,QAAA,eAAe,GAAG,IAAA,iCAAe,EAAC;IAC7C,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,QAAQ;IACf,QAAQ,EAAE,iCAAe;CAC1B,CAAC,CAAC"}

package/dist/logic/roles/ecologist/domain.sketch/skillStudyDomain.d.ts

@@ -0,0 +1,25 @@
+import { RoleSkill } from 'rhachet';
+export declare const SKILL_STUDY_DOMAIN: import("domain-objects/dist/manipulation/immute/withImmute").WithImmute<RoleSkill<import("rhachet").GStitcher<import("rhachet").Threads<{
+    student: import("rhachet").RoleContext<"student", {
+        art: {
+            domain: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    } & {
+        art: {
+            domain: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+    caller: import("rhachet").RoleContext<"caller", {
+        ask: string;
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string> | null;
+        };
+    } & {
+        ask: string;
+        art: {
+            feedback: 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/ecologist/domain.sketch/skillStudyDomain.js

@@ -0,0 +1,90 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_STUDY_DOMAIN = 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 asDotRhachetFile_1 = require("../../../artifact/asDotRhachetFile");
+const getMechanicBrief_1 = require("../../mechanic/getMechanicBrief");
+const loopStudyDomain_1 = require("./loopStudyDomain");
+exports.SKILL_STUDY_DOMAIN = rhachet_1.RoleSkill.build({
+    slug: 'domain.study',
+    route: loopStudyDomain_1.loopStudyDomain,
+    threads: {
+        lookup: {
+            target: {
+                source: 'process.argv',
+                char: 't',
+                desc: 'the target file or dir to write against',
+                type: 'string',
+            },
+        },
+        assess: (input) => typeof input.target === 'string',
+        instantiate: async (input) => {
+            const targetArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.target }, { versions: true });
+            const feedbackArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: (0, asDotRhachetFile_1.asDotRhachetDir)(input.target) + '/feedback.md' }, { versions: true });
+            return {
+                caller: await (0, rhachet_1.enrollThread)({
+                    role: 'caller',
+                    stash: {
+                        ask: input.ask,
+                        art: { feedback: feedbackArt },
+                    },
+                }),
+                student: await (0, rhachet_1.enrollThread)({
+                    role: 'student',
+                    stash: {
+                        ask: input.ask,
+                        art: { domain: targetArt },
+                    },
+                    inherit: {
+                        traits: [(0, getMechanicBrief_1.getMechanicBrief)('style.compressed.md')],
+                    },
+                }),
+            };
+        },
+    },
+    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 ecologist -s study.domain\`
+
+you can ask the mechanic to write anything to a target file
+- if it exists, it'll update
+- if it doesn't, it'll create
+
+
+\`\`\`sh
+npx rhachet ask -r ecologist -s study.domain -t ./path/to/file.ts --ask "your ask"
+\`\`\`
+
+once it's written, 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=skillStudyDomain.js.map

package/dist/logic/roles/ecologist/domain.sketch/skillStudyDomain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillStudyDomain.js","sourceRoot":"","sources":["../../../../../src/logic/roles/ecologist/domain.sketch/skillStudyDomain.ts"],"names":[],"mappings":";;;AAAA,qCAA+D;AAC/D,+DAA0D;AAE1D,6EAA0E;AAC1E,mFAAgF;AAChF,yEAAsE;AACtE,yEAAqE;AACrE,sEAAmE;AACnE,uDAAoD;AAEvC,QAAA,kBAAkB,GAAG,mBAAS,CAAC,KAAK,CAE/C;IACA,IAAI,EAAE,cAAc;IACpB,KAAK,EAAE,iCAAe;IACtB,OAAO,EAAE;QACP,MAAM,EAAE;YACN,MAAM,EAAE;gBACN,MAAM,EAAE,cAAc;gBACtB,IAAI,EAAE,GAAG;gBACT,IAAI,EAAE,yCAAyC;gBAC/C,IAAI,EAAE,QAAQ;aACf;SACF;QACD,MAAM,EAAE,CAAC,KAAK,EAA4C,EAAE,CAC1D,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAClC,WAAW,EAAE,KAAK,EAAE,KAGnB,EAA2D,EAAE;YAC5D,MAAM,SAAS,GAAG,IAAA,yCAAkB,EAClC,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,EACrB,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;YACF,MAAM,WAAW,GAAG,IAAA,yCAAkB,EACpC,EAAE,GAAG,EAAE,IAAA,kCAAe,EAAC,KAAK,CAAC,MAAM,CAAC,GAAG,cAAc,EAAE,EACvD,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;YACF,OAAO;gBACL,MAAM,EAAE,MAAM,IAAA,sBAAY,EAAC;oBACzB,IAAI,EAAE,QAAQ;oBACd,KAAK,EAAE;wBACL,GAAG,EAAE,KAAK,CAAC,GAAG;wBACd,GAAG,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE;qBAC/B;iBACF,CAAC;gBACF,OAAO,EAAE,MAAM,IAAA,sBAAY,EAAC;oBAC1B,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE;wBACL,GAAG,EAAE,KAAK,CAAC,GAAG;wBACd,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE;qBAC3B;oBACD,OAAO,EAAE;wBACP,MAAM,EAAE,CAAC,IAAA,mCAAgB,EAAC,qBAAqB,CAAC,CAAC;qBAClD;iBACF,CAAC;aACH,CAAC;QACJ,CAAC;KACF;IACD,OAAO,EAAE;QACP,MAAM,EAAE;YACN,YAAY,EAAE;gBACZ,MAAM,EAAE,aAAa;gBACrB,KAAK,EAAE,iBAAiB;gBACxB,IAAI,EAAE,uBAAuB;gBAC7B,IAAI,EAAE,QAAQ;aACf;SACF;QACD,MAAM,EAAE,CAAC,KAAK,EAAqC,EAAE,CACnD,OAAO,KAAK,CAAC,YAAY,KAAK,QAAQ;QACxC,WAAW,EAAE,CAAC,KAEb,EAAkD,EAAE;YACnD,OAAO;gBACL,GAAG,IAAA,mCAAgB,GAAE,EAAE,8BAA8B;gBACrD,GAAG,IAAA,uCAAkB,GAAE,EAAE,sBAAsB;gBAC/C,GAAG,IAAA,6CAAqB,GAAE;aAC3B,CAAC;QACJ,CAAC;KACF;IACD,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;CAqBT,CAAC,IAAI,EAAE;CACP,CAAC,CAAC"}

package/dist/logic/roles/ecologist/{distill/distillDomain.ActionsAndActors.d.ts → domain.sketch/stepStudyDomain.d.ts}

@@ -3,14 +3,19 @@ import { Artifact } from 'rhachet-artifact';
 import { GitFile } from 'rhachet-artifact-git';
 import { ContextOpenAI } from '../../../../data/sdk/sdkOpenAi';
 type StitcherDesired = GStitcher<Threads<{
-    student: RoleContext<'student', {
+    caller: RoleContext<'caller', {
         ask: string;
         art: {
-            distilledActorsAndActions: Artifact<typeof GitFile>;
+            feedback: Artifact<typeof GitFile> | null;
+        };
+    }>;
+    student: RoleContext<'student', {
+        art: {
+            domain: Artifact<typeof GitFile>;
         };
     }>;
 }>, ContextOpenAI & GStitcher['context'], {
     content: string;
 }>;
-export declare const distillDomainActorsAndActions: import("rhachet").Stitcher<StitcherDesired>;
+export declare const stepStudyDomain: import("rhachet").Stitcher<StitcherDesired>;
 export {};

package/dist/logic/roles/ecologist/domain.sketch/stepStudyDomain.integration.test.d.ts

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

package/dist/logic/roles/ecologist/domain.sketch/stepStudyDomain.integration.test.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const uni_time_1 = require("@ehmpathy/uni-time");
+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 stepStudyDomain_1 = require("./stepStudyDomain");
+jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 5 }));
+describe('stepStudyDomain', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = stepStudyDomain_1.stepStudyDomain;
+    (0, test_fns_1.given)('we want to explore the home service domain', () => {
+        const askText = `
+home service domain
+- [pro] = [provider] = a brand
+- [doer] = a person under a pro
+- [nei] = [neighbor] = a local resident, manager, etc; customer
+
+neighbors need to schedule with providers
+    `.trim();
+        const domainArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/stepStudyDomain/homeServices.domain.md',
+        }, {
+            versions: true,
+        });
+        beforeEach(async () => {
+            await domainArt.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: null,
+                        },
+                    },
+                }),
+                student: await (0, rhachet_1.enrollThread)({
+                    role: 'student',
+                    stash: {
+                        art: {
+                            domain: domainArt,
+                        },
+                    },
+                }),
+            }));
+            (0, test_fns_1.then)('upserts the artifact', async () => {
+                const result = await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads }, context);
+                console.log(JSON.stringify(result.stitch, null, 2));
+                const { content } = await domainArt.get().expect('isPresent');
+                expect(content).toContain('pro');
+            });
+        });
+    });
+});
+//# sourceMappingURL=stepStudyDomain.integration.test.js.map

package/dist/logic/roles/ecologist/domain.sketch/stepStudyDomain.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepStudyDomain.integration.test.js","sourceRoot":"","sources":["../../../../../src/logic/roles/ecologist/domain.sketch/stepStudyDomain.integration.test.ts"],"names":[],"mappings":";;AAAA,iDAAoD;AACpD,qCAA2D;AAC3D,+DAA0D;AAC1D,uCAAsD;AAEtD,6EAA0E;AAC1E,mFAAgF;AAChF,yEAAsE;AACtE,uDAAoD;AAEpD,IAAI,CAAC,UAAU,CAAC,IAAA,yBAAc,EAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEhD,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,MAAM,OAAO,GAAG;QACd,GAAG,IAAA,uCAAkB,GAAE;QACvB,GAAG,IAAA,6CAAqB,GAAE;QAC1B,GAAG,IAAA,mCAAgB,GAAE;KACtB,CAAC;IACF,MAAM,KAAK,GAAG,iCAAe,CAAC;IAE9B,IAAA,gBAAK,EAAC,4CAA4C,EAAE,GAAG,EAAE;QACvD,MAAM,OAAO,GAAG;;;;;;;KAOf,CAAC,IAAI,EAAE,CAAC;QAET,MAAM,SAAS,GAAG,IAAA,yCAAkB,EAClC;YACE,GAAG,EAAE,SAAS,GAAG,+CAA+C;SACjE,EACD;YACE,QAAQ,EAAE,IAAI;SACf,CACF,CAAC;QAEF,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC;QACxB,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;4BACH,QAAQ,EAAE,IAAI;yBACf;qBACF;iBACF,CAAC;gBACF,OAAO,EAAE,MAAM,IAAA,sBAAY,EAAC;oBAC1B,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE;wBACL,GAAG,EAAE;4BACH,MAAM,EAAE,SAAS;yBAClB;qBACF;iBACF,CAAC;aACH,CAAC,CAAC,CAAC;YAEJ,IAAA,eAAI,EAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE;gBACtC,MAAM,MAAM,GAAG,MAAM,IAAA,4BAAkB,EACrC,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,EAC5B,OAAO,CACR,CAAC;gBAEF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBAEpD,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBAC9D,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/logic/roles/ecologist/domain.sketch/stepStudyDomain.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stepStudyDomain = void 0;
+const rhachet_1 = require("rhachet");
+const sdkOpenAi_1 = require("../../../../data/sdk/sdkOpenAi");
+const genStepArtSet_1 = require("../../../artifact/genStepArtSet");
+const getMechanicBrief_1 = require("../../mechanic/getMechanicBrief");
+const getEcologistBrief_1 = require("../getEcologistBrief");
+const template = (0, rhachet_1.genTemplate)({
+    ref: { uri: __filename.replace('.ts', '.template.md') },
+    getVariables: async ({ threads }) => ({
+        ...(await (0, rhachet_1.getTemplateVarsFromRoleInherit)({ thread: threads.student })),
+        ask: (await threads.caller.context.stash.art.feedback?.get())?.content ||
+            threads.caller.context.stash.ask,
+        briefs: await (0, rhachet_1.getTemplateValFromArtifacts)({
+            artifacts: [
+                ...(0, getMechanicBrief_1.getMechanicBriefs)([
+                    'architecture/ubiqlang.md',
+                    'style.names.treestruct.md',
+                ]),
+                ...(0, getEcologistBrief_1.getEcologistBriefs)([
+                    'distilisys/sys101.distilisys.grammar.md',
+                    'distilisys/sys201.actor.motive._.summary.md',
+                    'distilisys/sys201.actor.motive.p5.motive.grammar.md',
+                    'distilisys/sys211.actor.resources._.primitives.summary.md',
+                    'distilisys/sys211.actor.resources.pt5.composites.md',
+                    'distilisys/sys231.actor.claims.p1.primitive.exchange.md',
+                    'ecology/eco001.overview.md',
+                    'ecology/eco101.core-system-understanding.md',
+                    'ecology/eco505.systems-thinking.md',
+                    'economy/econ001.overview.md',
+                    'economy/econ101.core-mechanics.md',
+                    'economy/econ501.p1.game-theory.md',
+                    'economy/econ501.p4.behavioral-economics.md',
+                    // 'analysis.behavior-reveals-system.md',
+                    // 'core.term.price.v2.md',
+                ]),
+            ],
+        }),
+        domain: (await threads.student.context.stash.art.domain.get())?.content ?? '',
+    }),
+});
+const stepImagine = (0, rhachet_1.genStepImagineViaTemplate)({
+    slug: '[student]<study>[domain]<imagine>',
+    stitchee: 'student',
+    readme: '',
+    template,
+    imagine: sdkOpenAi_1.sdkOpenAi.imagine,
+});
+const stepPersist = (0, genStepArtSet_1.genStepArtSet)({
+    stitchee: 'student',
+    artee: 'domain',
+});
+// todo: expand into separation of domain discovery vs vision discovery
+exports.stepStudyDomain = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
+    slug: '[student]<study>[domain]',
+    readme: '@[student]<study>[domain] -> [[claim]]s',
+    sequence: [stepImagine, stepPersist],
+}));
+//# sourceMappingURL=stepStudyDomain.js.map

package/dist/logic/roles/ecologist/domain.sketch/stepStudyDomain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepStudyDomain.js","sourceRoot":"","sources":["../../../../../src/logic/roles/ecologist/domain.sketch/stepStudyDomain.ts"],"names":[],"mappings":";;;AAAA,qCAUiB;AAIjB,8DAA0E;AAC1E,mEAAgE;AAChE,sEAAoE;AACpE,4DAA0D;AA0B1D,MAAM,QAAQ,GAAG,IAAA,qBAAW,EAA6B;IACvD,GAAG,EAAE,EAAE,GAAG,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,cAAc,CAAC,EAAE;IACvD,YAAY,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QACpC,GAAG,CAAC,MAAM,IAAA,wCAA8B,EAAC,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACtE,GAAG,EACD,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO;YACjE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG;QAClC,MAAM,EAAE,MAAM,IAAA,qCAA2B,EAAC;YACxC,SAAS,EAAE;gBACT,GAAG,IAAA,oCAAiB,EAAC;oBACnB,0BAA0B;oBAC1B,2BAA2B;iBAC5B,CAAC;gBACF,GAAG,IAAA,sCAAkB,EAAC;oBACpB,yCAAyC;oBACzC,6CAA6C;oBAC7C,qDAAqD;oBACrD,2DAA2D;oBAC3D,qDAAqD;oBACrD,yDAAyD;oBACzD,4BAA4B;oBAC5B,6CAA6C;oBAC7C,oCAAoC;oBACpC,6BAA6B;oBAC7B,mCAAmC;oBACnC,mCAAmC;oBACnC,4CAA4C;oBAE5C,yCAAyC;oBACzC,2BAA2B;iBAC5B,CAAC;aACH;SACF,CAAC;QACF,MAAM,EACJ,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;KACxE,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,mCAAyB,EAAkB;IAC7D,IAAI,EAAE,mCAAmC;IACzC,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,EAAE;IACV,QAAQ;IACR,OAAO,EAAE,qBAAS,CAAC,OAAO;CAC3B,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,6BAAa,EAAC;IAChC,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,QAAQ;CAChB,CAAC,CAAC;AAEH,uEAAuE;AAE1D,QAAA,eAAe,GAAG,IAAA,wBAAc,EAC3C,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,0BAA0B;IAChC,MAAM,EAAE,yCAAyC;IACjD,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;CACrC,CAAC,CACH,CAAC"}

package/dist/logic/roles/ecologist/domain.sketch/stepStudyDomain.template.md

@@ -0,0 +1,93 @@
+you're an @[ecologist]. help study the [domain] the @[caller] is talking about
+
+update the [domain] doc based on the @[caller]'s current [comment]
+
+output
+- the claims we've accumulated so far
+- a sketch of the "domain"
+
+the output should be in outline format with the following sections
+
+  ```md
+  # scope - what this domain document cares about
+
+  ---
+
+  # claims - what info we have accumulated
+
+  ### questions
+
+  ### assumptions
+
+  ### patterns
+
+  ### lessons
+
+  ---
+
+  # domain usecases - what usecases we care about
+
+  - usecase.1 = 3-10 word summary
+    - .grammar = @[actor]<mechanism> -> [resource] -> {motive}
+    - .verbage = @[actor] uses <mechanism> to produce [resource] due to {motive}
+
+  ---
+
+  # domain sketch - what domain knowledge we've distilled
+
+  ### [resource]s
+
+  ### <mechanism>s
+
+  ### @[actor]s
+
+  ### @[actor]{driver}s
+
+  ### @[actor]<action>s
+
+  ---
+
+  # appendix - any additional notes
+
+  ---
+
+  # changelog - what we've changed and why
+
+  - v0 = ...
+  ```
+---
+
+this is a technical document which will evolve over time.
+
+keep it as high signal, minimum noise as possible.
+- dont use capitals unless it's for [Resources] (PascalCase) or <mechanisms> (camelCase)
+
+leverage
+- distilisys.grammar
+- motive.grammar
+
+---------------------------------------------------------------------------------------
+---------------------------------------------------------------------------------------
+---------------------------------------------------------------------------------------
+
+here's some .traits you have, as a refresher
+$.rhachet{inherit.traits}
+
+---
+
+here's some .briefs on the skills you have, as a refresher
+$.rhachet{briefs}
+
+---------------------------------------------------------------------------------------
+---------------------------------------------------------------------------------------
+---------------------------------------------------------------------------------------
+
+[domain] =
+```md
+$.rhachet{domain}
+```
+
+@[caller][comment] =
+```md
+$.rhachet{ask}
+```

package/dist/logic/roles/ecologist/domain.term/stepCollectTermUsecases.d.ts

@@ -0,0 +1,45 @@
+import { GStitcher, Threads, RoleContext } from 'rhachet';
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+import { ContextOpenAI } from '../../../../data/sdk/sdkOpenAi';
+type StitcherDesired = GStitcher<Threads<{
+    caller: RoleContext<'caller', {
+        ask: string;
+        art: {
+            feedback: Artifact<typeof GitFile> | null;
+        };
+    }>;
+    student: RoleContext<'student', {
+        art: {
+            inflight: Artifact<typeof GitFile>;
+        };
+    }>;
+}>, ContextOpenAI & GStitcher['context'], {
+    content: string;
+}>;
+export declare const stepCollectTermUsecases: import("rhachet").Stitcher<StitcherDesired>;
+export declare const loopCollectTermUsecases: import("rhachet").Stitcher<GStitcher<Threads<{
+    student: RoleContext<"student", {
+        art: {
+            inflight: Artifact<typeof GitFile>;
+        };
+    } & {
+        art: {
+            inflight: Artifact<typeof GitFile, string>;
+        };
+    }>;
+    caller: RoleContext<"caller", {
+        ask: string;
+        art: {
+            feedback: Artifact<typeof GitFile> | null;
+        };
+    } & {
+        ask: string;
+        art: {
+            feedback: Artifact<typeof GitFile, string>;
+        };
+    }>;
+}>, ContextOpenAI & import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: GitFile | null;
+}>>;
+export {};

package/dist/logic/roles/ecologist/domain.term/stepCollectTermUsecases.integration.test.d.ts

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