rhachet-roles-ehmpathy 1.0.0 → 1.1.0

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

@@ -0,0 +1,69 @@
+"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 stepCollectTermUsecases_1 = require("./stepCollectTermUsecases");
+jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 5 }));
+describe('stepCollectTermUsecases', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = stepCollectTermUsecases_1.stepCollectTermUsecases;
+    (0, test_fns_1.given)('we want to explore the home service domain', () => {
+        const askText = `
+home service domain
+- calendar event vs appointment, for a scheduling system
+- what's a term that describes the schedule that a @[provider] can be booked at (which may or may not have appointments)
+- specifically, we want to ensure that we avoid conflicts with events on their external calendar
+- we need to know when they _could_ be scheduled
+  - regardless of whether there's an service appointment already scheduled
+  - since that could be rescheduled within our system, whereas an external event like a vacation can not
+    - e.g., a @[neighbor] may want to see which other times are available
+    - e.g., a @[neighbor] cancelled their appointment, our system needs to revive the availability from the "inventory" of time the @[provider] stated was available
+    `.trim();
+        const domainArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname +
+                '/.temp/stepCollectTermUsecases/homeservice.schedule.term.usecases.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: {
+                            inflight: 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=stepCollectTermUsecases.integration.test.js.map

package/dist/logic/roles/ecologist/domain.term/stepCollectTermUsecases.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepCollectTermUsecases.integration.test.js","sourceRoot":"","sources":["../../../../../src/logic/roles/ecologist/domain.term/stepCollectTermUsecases.integration.test.ts"],"names":[],"mappings":";;AAAA,iDAAoD;AACpD,qCAA2D;AAC3D,+DAA0D;AAC1D,uCAAsD;AAEtD,6EAA0E;AAC1E,mFAAgF;AAChF,yEAAsE;AACtE,uEAAoE;AAEpE,IAAI,CAAC,UAAU,CAAC,IAAA,yBAAc,EAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEhD,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IACvC,MAAM,OAAO,GAAG;QACd,GAAG,IAAA,uCAAkB,GAAE;QACvB,GAAG,IAAA,6CAAqB,GAAE;QAC1B,GAAG,IAAA,mCAAgB,GAAE;KACtB,CAAC;IACF,MAAM,KAAK,GAAG,iDAAuB,CAAC;IAEtC,IAAA,gBAAK,EAAC,4CAA4C,EAAE,GAAG,EAAE;QACvD,MAAM,OAAO,GAAG;;;;;;;;;;KAUf,CAAC,IAAI,EAAE,CAAC;QAET,MAAM,SAAS,GAAG,IAAA,yCAAkB,EAClC;YACE,GAAG,EACD,SAAS;gBACT,sEAAsE;SACzE,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,QAAQ,EAAE,SAAS;yBACpB;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.term/stepCollectTermUsecases.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loopCollectTermUsecases = exports.stepCollectTermUsecases = void 0;
+const rhachet_1 = require("rhachet");
+const sdkOpenAi_1 = require("../../../../data/sdk/sdkOpenAi");
+const genLoopFeedback_1 = require("../../../artifact/genLoopFeedback");
+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, getEcologistBrief_1.getEcologistBriefs)([
+                    // 'term.distillation.md',
+                    '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',
+                ]),
+                ...(0, getMechanicBrief_1.getMechanicBriefs)([
+                    'architecture/ubiqlang.md',
+                    'style.names.treestruct.md',
+                ]),
+            ],
+        }),
+        domain: (await threads.student.context.stash.art.inflight.get())?.content ?? '',
+    }),
+});
+const stepImagine = (0, rhachet_1.genStepImagineViaTemplate)({
+    slug: '[student]<distill>[domain:term:usecases]<imagine>',
+    stitchee: 'student',
+    readme: '',
+    template,
+    imagine: sdkOpenAi_1.sdkOpenAi.imagine,
+});
+const stepPersist = (0, genStepArtSet_1.genStepArtSet)({
+    stitchee: 'student',
+    artee: 'inflight',
+});
+// todo: expand into separation of domain discovery vs vision discovery
+exports.stepCollectTermUsecases = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
+    slug: '[student]<collect>[domain:term:usecases]',
+    readme: '@[student]<distill>[domain:term:usecases] -> [[usecase]]s',
+    sequence: [stepImagine, stepPersist],
+}));
+exports.loopCollectTermUsecases = (0, genLoopFeedback_1.genLoopFeedback)({
+    stitchee: 'student',
+    artee: 'inflight',
+    repeatee: exports.stepCollectTermUsecases,
+});
+//# sourceMappingURL=stepCollectTermUsecases.js.map

package/dist/logic/roles/ecologist/domain.term/stepCollectTermUsecases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepCollectTermUsecases.js","sourceRoot":"","sources":["../../../../../src/logic/roles/ecologist/domain.term/stepCollectTermUsecases.ts"],"names":[],"mappings":";;;AAAA,qCAUiB;AAIjB,8DAA0E;AAC1E,uEAAoE;AACpE,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,sCAAkB,EAAC;oBACpB,0BAA0B;oBAE1B,yCAAyC;oBACzC,6CAA6C;oBAC7C,qDAAqD;oBACrD,2DAA2D;oBAC3D,qDAAqD;oBACrD,yDAAyD;oBACzD,4BAA4B;oBAC5B,6CAA6C;oBAC7C,wCAAwC;oBACxC,6BAA6B;oBAC7B,mCAAmC;oBACnC,uCAAuC;oBACvC,gDAAgD;oBAEhD,yCAAyC;oBACzC,2BAA2B;iBAC5B,CAAC;gBACF,GAAG,IAAA,oCAAiB,EAAC;oBACnB,0BAA0B;oBAC1B,2BAA2B;iBAC5B,CAAC;aACH;SACF,CAAC;QACF,MAAM,EACJ,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;KAC1E,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,mCAAyB,EAAkB;IAC7D,IAAI,EAAE,mDAAmD;IACzD,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,UAAU;CAClB,CAAC,CAAC;AAEH,uEAAuE;AAE1D,QAAA,uBAAuB,GAAG,IAAA,wBAAc,EACnD,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,0CAA0C;IAChD,MAAM,EAAE,2DAA2D;IACnE,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;CACrC,CAAC,CACH,CAAC;AAEW,QAAA,uBAAuB,GAAG,IAAA,iCAAe,EAAC;IACrD,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,+BAAuB;CAClC,CAAC,CAAC"}

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

@@ -0,0 +1,25 @@
+import { RoleSkill } from 'rhachet';
+export declare const SKILL_DOMAIN_TERM_COLLECT_USECASES: import("domain-objects/dist/manipulation/immute/withImmute").WithImmute<RoleSkill<import("rhachet").GStitcher<import("rhachet").Threads<{
+    student: import("rhachet").RoleContext<"student", {
+        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>;
+        };
+    }>;
+    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.term/stepCollectTermUsecases.skill.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_DOMAIN_TERM_COLLECT_USECASES = 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 stepCollectTermUsecases_1 = require("./stepCollectTermUsecases");
+exports.SKILL_DOMAIN_TERM_COLLECT_USECASES = rhachet_1.RoleSkill.build({
+    slug: 'domain.term.usecases.collect',
+    route: stepCollectTermUsecases_1.loopCollectTermUsecases,
+    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: { inflight: 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 domain.term.usecases.collect \`
+
+\`\`\`sh
+npx rhachet ask -r ecologist -s domain.term.usecases.collect -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=stepCollectTermUsecases.skill.js.map

package/dist/logic/roles/ecologist/domain.term/stepCollectTermUsecases.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepCollectTermUsecases.skill.js","sourceRoot":"","sources":["../../../../../src/logic/roles/ecologist/domain.term/stepCollectTermUsecases.skill.ts"],"names":[],"mappings":";;;AAAA,qCAA+D;AAC/D,+DAA0D;AAE1D,6EAA0E;AAC1E,mFAAgF;AAChF,yEAAsE;AACtE,yEAAqE;AACrE,sEAAmE;AACnE,uEAAoE;AAEvD,QAAA,kCAAkC,GAAG,mBAAS,CAAC,KAAK,CAE/D;IACA,IAAI,EAAE,8BAA8B;IACpC,KAAK,EAAE,iDAAuB;IAC9B,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,EAAmE,EAAE;YACpE,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,QAAQ,EAAE,SAAS,EAAE;qBAC7B;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,EAA0D,EAAE;YAC3D,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;;;;;;;;;;;;;;;;CAgBT,CAAC,IAAI,EAAE;CACP,CAAC,CAAC"}

package/dist/logic/roles/ecologist/domain.term/stepCollectTermUsecases.template.md

@@ -0,0 +1,160 @@
+you're an @[ecologist]. help collect the usecases for the term @[caller] is talking about
+
+---
+
+update the [term] doc based on the @[caller]'s current [comment]
+
+output
+- the claims we've accumulated so far
+- the usecases for the term we've accumulated so far
+- only include the \```md contents; dont include the wrapper \```md; only the document.body
+
+critical
+- seek to extract claims (especially lessons) from feedback
+- do not use any particular term. always use the placeholder of __TERM__
+- specifically use __TERM__ atleast once in the document
+- dont get lazy; exhaust the fundamental usecases that could exist
+- avoid capital characters like the plague
+- use more than one case.example
+
+
+the output should be in outline format with the following sections
+
+  ```md
+    # 🎯 purpose - what is this document about
+
+    ---
+
+    # 📚 claims - what info we have accumulated
+
+    ### questions
+
+    - ...
+
+    ### assumptions
+
+    - ...
+
+    ### patterns
+
+    - ...
+
+    ### lessons
+
+    - ...
+
+    ---
+
+    # 📌 usecases
+
+    ### ✅ positive - usecases when we leverage the term
+
+    > specific examples of when we need the __TERM__, to <<gain>>[precision]
+    > minimum of 3 required, maximum of 10 recommended
+
+    📌 case.p1 = 3-10 word summary
+      .who = @[actor]
+      .what = @[actor]<get> "what"
+        - detail
+        - detail
+        - ...
+      .why =
+        - motive.1 =
+        - motive.2 =
+        - ...
+      .examples =
+        - example.1 =
+        - ...
+
+
+    📌 case.p2 = 3-10 word summary
+      .who = @[actor]
+      .what = @[actor]<set> "what"
+        - detail
+        - detail
+        - ...
+      .why =
+        - motive.1 =
+        - motive.2 =
+        - ...
+      .examples =
+        - example.1 =
+        - ...
+
+
+    📌 ...
+
+
+    ### 🛑 negative - usecases when a different term is needed
+
+    > specific examples of when we avoid __TERM__, to <<drop>>[confusion]
+    > minimum of 1 required, maximum of 10 recommended
+
+    📌 case.n1 = 3-10 word summary
+      .who = @[actor]
+      .what = @[actor]<get> "what"
+        - detail
+        - detail
+        - ...
+      .why =
+        - motive.1 =
+        - motive.2 =
+        - ...
+      .examples =
+        - example.1 =
+        - ...
+
+    📌 ...
+
+    ---
+
+
+    # 📎 appendix (optional)
+
+    > deeper traces, example flows, or edge notes
+
+
+    ---
+
+
+    ## 🪵 changelog
+
+    - v0 =
+
+  ```
+---
+
+this is a technical document which will evolve over time.
+
+keep it as high signal, minimum noise as possible.
+- dont use capitals unless for [Resource] (PascalCase) or <mechanism> (camelCase)
+- use distilisys.grammar to maximize signal via visuals
+
+tips:
+- @[actor]<get/set> "what, when, why" is a good structure and can declare many usecases
+
+---------------------------------------------------------------------------------------
+---------------------------------------------------------------------------------------
+---------------------------------------------------------------------------------------
+
+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}
+
+---------------------------------------------------------------------------------------
+---------------------------------------------------------------------------------------
+---------------------------------------------------------------------------------------
+
+[term] =
+```md
+$.rhachet{domain}
+```
+
+@[caller][comment] =
+```md
+$.rhachet{ask}
+```

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

@@ -0,0 +1,47 @@
+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>;
+            usecases: Artifact<typeof GitFile> | null;
+        };
+    }>;
+    student: RoleContext<'student', {
+        art: {
+            inflight: Artifact<typeof GitFile>;
+        };
+    }>;
+}>, ContextOpenAI & GStitcher['context'], {
+    content: string;
+}>;
+export declare const stepDistillTerm: import("rhachet").Stitcher<StitcherDesired>;
+export declare const loopDistillTerm: 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>;
+            usecases: 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/stepDistillTerm.integration.test.d.ts

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

package/dist/logic/roles/ecologist/domain.term/stepDistillTerm.integration.test.js

@@ -0,0 +1,127 @@
+"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 stepDistillTerm_1 = require("./stepDistillTerm");
+jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 5 }));
+describe('stepDistillTerm', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = stepDistillTerm_1.stepDistillTerm;
+    (0, test_fns_1.given)('we want to explore the home service domain, no usecases', () => {
+        const askText = `
+home service domain
+- calendar event vs appointment, for a scheduling system
+- what's a term that describes the schedule that a @[provider] can be booked at (which may or may not have appointments)
+- specifically, we want to ensure that we avoid conflicts with events on their external calendar
+- we need to know when they _could_ be scheduled
+  - regardless of whether there's an service appointment already scheduled
+  - since that could be rescheduled within our system, whereas an external event like a vacation can not
+    - e.g., a @[neighbor] may want to see which other times are available
+    - e.g., a @[neighbor] cancelled their appointment, our system needs to revive the availability from the "inventory" of time the @[provider] stated was available
+    `.trim();
+        const inflightArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname +
+                '/.temp/stepDistillTerm/woutcases.homeservice.schedule.term.md',
+        }, {
+            versions: true,
+        });
+        const feedbackArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname +
+                '/.temp/stepDistillTerm/woutcases.homeservice.schedule.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,
+                            usecases: null,
+                        },
+                    },
+                }),
+                student: await (0, rhachet_1.enrollThread)({
+                    role: 'student',
+                    stash: {
+                        art: {
+                            inflight: inflightArt,
+                        },
+                    },
+                }),
+            }));
+            (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 inflightArt.get().expect('isPresent');
+                expect(content).toContain('pro');
+            });
+        });
+    });
+    (0, test_fns_1.given)('we want to explore the home service domain, w/ usecases', () => {
+        const askText = `
+home service domain
+- calendar event vs appointment, for a scheduling system
+- what's a term that describes the schedule that a @[provider] can be booked at (which may or may not have appointments)
+- specifically, we want to ensure that we avoid conflicts with events on their external calendar
+- we need to know when they _could_ be scheduled
+  - regardless of whether there's an service appointment already scheduled
+  - since that could be rescheduled within our system, whereas an external event like a vacation can not
+    - e.g., a @[neighbor] may want to see which other times are available
+    - e.g., a @[neighbor] cancelled their appointment, our system needs to revive the availability from the "inventory" of time the @[provider] stated was available
+    `.trim();
+        const inflightArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname +
+                '/.temp/stepDistillTerm/withcases.homeservice.schedule.inflight.md',
+        }, { versions: true });
+        const feedbackArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname +
+                '/.temp/stepDistillTerm/withcases.homeservice.schedule.feedback.md',
+        }, { versions: true });
+        const usecasesArt = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.test/schedule.term.usecases.md' }, { access: 'readonly' });
+        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,
+                            usecases: usecasesArt,
+                        },
+                    },
+                }),
+                student: await (0, rhachet_1.enrollThread)({
+                    role: 'student',
+                    stash: {
+                        art: {
+                            inflight: inflightArt,
+                        },
+                    },
+                }),
+            }));
+            (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 inflightArt.get().expect('isPresent');
+                expect(content).toContain('pro');
+            });
+        });
+    });
+});
+//# sourceMappingURL=stepDistillTerm.integration.test.js.map

package/dist/logic/roles/ecologist/domain.term/stepDistillTerm.integration.test.js.map

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