rhachet-roles-ehmpathy 1.0.0 → 1.1.0

package/dist/logic/roles/bhrain/primitive.strategic.atomic/interpret/stepInterpret.integration.test.js

@@ -0,0 +1,115 @@
+"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 stepInterpret_1 = require("./stepInterpret");
+jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 5 }));
+describe('stepInterpret', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = stepInterpret_1.stepInterpret;
+    (0, test_fns_1.given)('we want to explore the home service domain', () => {
+        const askText = 'distill usecases for appointment scheduler in the home service domain. use @[provider] and @[neighbor] actors involved';
+        const inflightArtifact = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/stepInterpret/homeservice.schedule.inflight.md',
+        }, {
+            versions: true,
+        });
+        const feedbackArtifact = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/stepInterpret/homeservice.schedule.feedback.md',
+        }, {
+            versions: true,
+        });
+        beforeEach(async () => {
+            await inflightArtifact.del();
+            await feedbackArtifact.del();
+            await feedbackArtifact.set({ content: '' });
+        });
+        (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: feedbackArtifact,
+                        },
+                    },
+                }),
+                thinker: await (0, rhachet_1.enrollThread)({
+                    role: 'thinker',
+                    stash: {
+                        art: {
+                            inflight: inflightArtifact,
+                        },
+                    },
+                }),
+            }));
+            (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 inflightArtifact.get().expect('isPresent');
+                expect(content).toContain('pro');
+            });
+        });
+    });
+    (0, test_fns_1.given)('we want to distill usecases', () => {
+        const askText = `
+i want to explore usecases. specifically, detect+collect a ton of them, then cluster them
+
+then i want to distill them into the key ones
+      `;
+        const inflightArtifact = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/stepInterpret/homeservice.schedule.inflight.md',
+        }, {
+            versions: true,
+        });
+        const feedbackArtifact = (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/stepInterpret/homeservice.schedule.feedback.md',
+        }, {
+            versions: true,
+        });
+        beforeEach(async () => {
+            await inflightArtifact.del();
+            await feedbackArtifact.del();
+            await feedbackArtifact.set({ content: '' });
+        });
+        (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: feedbackArtifact,
+                        },
+                    },
+                }),
+                thinker: await (0, rhachet_1.enrollThread)({
+                    role: 'thinker',
+                    stash: {
+                        art: {
+                            inflight: inflightArtifact,
+                        },
+                    },
+                }),
+            }));
+            (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 inflightArtifact.get().expect('isPresent');
+                expect(content).toContain('<distill>');
+                expect(content).toContain('<cluster>');
+            });
+        });
+    });
+});
+//# sourceMappingURL=stepInterpret.integration.test.js.map

package/dist/logic/roles/bhrain/primitive.strategic.atomic/interpret/stepInterpret.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepInterpret.integration.test.js","sourceRoot":"","sources":["../../../../../../src/logic/roles/bhrain/primitive.strategic.atomic/interpret/stepInterpret.integration.test.ts"],"names":[],"mappings":";;AAAA,iDAAoD;AACpD,qCAA2D;AAC3D,+DAA0D;AAC1D,uCAAsD;AAEtD,gFAA6E;AAC7E,sFAAmF;AACnF,4EAAyE;AACzE,mDAAgD;AAEhD,IAAI,CAAC,UAAU,CAAC,IAAA,yBAAc,EAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEhD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,MAAM,OAAO,GAAG;QACd,GAAG,IAAA,uCAAkB,GAAE;QACvB,GAAG,IAAA,6CAAqB,GAAE;QAC1B,GAAG,IAAA,mCAAgB,GAAE;KACtB,CAAC;IACF,MAAM,KAAK,GAAG,6BAAa,CAAC;IAE5B,IAAA,gBAAK,EAAC,4CAA4C,EAAE,GAAG,EAAE;QACvD,MAAM,OAAO,GACX,wHAAwH,CAAC;QAE3H,MAAM,gBAAgB,GAAG,IAAA,yCAAkB,EACzC;YACE,GAAG,EACD,SAAS,GAAG,uDAAuD;SACtE,EACD;YACE,QAAQ,EAAE,IAAI;SACf,CACF,CAAC;QAEF,MAAM,gBAAgB,GAAG,IAAA,yCAAkB,EACzC;YACE,GAAG,EACD,SAAS,GAAG,uDAAuD;SACtE,EACD;YACE,QAAQ,EAAE,IAAI;SACf,CACF,CAAC;QAEF,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,gBAAgB,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9C,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,gBAAgB;yBAC3B;qBACF;iBACF,CAAC;gBACF,OAAO,EAAE,MAAM,IAAA,sBAAY,EAAC;oBAC1B,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE;wBACL,GAAG,EAAE;4BACH,QAAQ,EAAE,gBAAgB;yBAC3B;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,gBAAgB,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBACrE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;YACnC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,IAAA,gBAAK,EAAC,6BAA6B,EAAE,GAAG,EAAE;QACxC,MAAM,OAAO,GAAG;;;;OAIb,CAAC;QAEJ,MAAM,gBAAgB,GAAG,IAAA,yCAAkB,EACzC;YACE,GAAG,EACD,SAAS,GAAG,uDAAuD;SACtE,EACD;YACE,QAAQ,EAAE,IAAI;SACf,CACF,CAAC;QAEF,MAAM,gBAAgB,GAAG,IAAA,yCAAkB,EACzC;YACE,GAAG,EACD,SAAS,GAAG,uDAAuD;SACtE,EACD;YACE,QAAQ,EAAE,IAAI;SACf,CACF,CAAC;QAEF,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,gBAAgB,CAAC,GAAG,EAAE,CAAC;YAC7B,MAAM,gBAAgB,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9C,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,gBAAgB;yBAC3B;qBACF;iBACF,CAAC;gBACF,OAAO,EAAE,MAAM,IAAA,sBAAY,EAAC;oBAC1B,IAAI,EAAE,SAAS;oBACf,KAAK,EAAE;wBACL,GAAG,EAAE;4BACH,QAAQ,EAAE,gBAAgB;yBAC3B;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,gBAAgB,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;gBACrE,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;gBACvC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YACzC,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/logic/roles/bhrain/primitive.strategic.atomic/interpret/stepInterpret.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loopInterpret = exports.stepInterpret = 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 getEcologistBrief_1 = require("../../../ecologist/getEcologistBrief");
+const getMechanicBrief_1 = require("../../../mechanic/getMechanicBrief");
+const getBhrainBrief_1 = require("../../getBhrainBrief");
+const template = (0, rhachet_1.genTemplate)({
+    ref: { uri: __filename.replace('.ts', '.template.md') },
+    getVariables: async ({ threads }) => ({
+        ...(await (0, rhachet_1.getTemplateVarsFromRoleInherit)({ thread: threads.thinker })),
+        ask: (await threads.caller.context.stash.art.feedback?.get())?.content ||
+            threads.caller.context.stash.ask,
+        inflight: (await threads.thinker.context.stash.art.inflight.get())?.content || '',
+        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',
+                    'ecology/eco001.overview.md',
+                    'economy/econ001.overview.md',
+                ]),
+            ],
+        }),
+        grammar: await (0, rhachet_1.getTemplateValFromArtifacts)({
+            artifacts: (0, getBhrainBrief_1.getBhrainBriefs)(['distilisys.grammar.compressed.md']),
+        }),
+    }),
+});
+const stepImagine = (0, rhachet_1.genStepImagineViaTemplate)({
+    slug: '[thinker]<interpret>',
+    stitchee: 'thinker',
+    readme: '',
+    template,
+    imagine: sdkOpenAi_1.sdkOpenAi.imagine,
+});
+const stepPersist = (0, genStepArtSet_1.genStepArtSet)({
+    stitchee: 'thinker',
+    artee: 'inflight',
+});
+exports.stepInterpret = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
+    slug: '@[thinker]<interpret>',
+    readme: '@[thinker]<interpret> -> [[intent], [goal], [motive]]',
+    sequence: [stepImagine, stepPersist],
+}));
+exports.loopInterpret = (0, genLoopFeedback_1.genLoopFeedback)({
+    stitchee: 'thinker',
+    artee: 'inflight',
+    repeatee: exports.stepInterpret,
+});
+//# sourceMappingURL=stepInterpret.js.map

package/dist/logic/roles/bhrain/primitive.strategic.atomic/interpret/stepInterpret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepInterpret.js","sourceRoot":"","sources":["../../../../../../src/logic/roles/bhrain/primitive.strategic.atomic/interpret/stepInterpret.ts"],"names":[],"mappings":";;;AAAA,qCAUiB;AAIjB,iEAA6E;AAC7E,0EAAuE;AACvE,sEAAmE;AACnE,4EAA0E;AAC1E,yEAAuE;AACvE,yDAAuD;AA0BvD,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,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;QACzE,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,4BAA4B;oBAC5B,6BAA6B;iBAC9B,CAAC;aACH;SACF,CAAC;QACF,OAAO,EAAE,MAAM,IAAA,qCAA2B,EAAC;YACzC,SAAS,EAAE,IAAA,gCAAe,EAAC,CAAC,kCAAkC,CAAC,CAAC;SACjE,CAAC;KACH,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,mCAAyB,EAAkB;IAC7D,IAAI,EAAE,sBAAsB;IAC5B,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;AAEU,QAAA,aAAa,GAAG,IAAA,wBAAc,EACzC,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,uBAAuB;IAC7B,MAAM,EAAE,uDAAuD;IAC/D,QAAQ,EAAE,CAAC,WAAW,EAAE,WAAW,CAAC;CACrC,CAAC,CACH,CAAC;AAEW,QAAA,aAAa,GAAG,IAAA,iCAAe,EAAC;IAC3C,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,UAAU;IACjB,QAAQ,EAAE,qBAAa;CACxB,CAAC,CAAC"}

package/dist/logic/roles/bhrain/primitive.strategic.atomic/interpret/stepInterpret.skill.d.ts

@@ -0,0 +1,24 @@
+export declare const SKILL_INTERPRET: 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>;
+        };
+    } & {
+        ask: string;
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+    thinker: import("rhachet").RoleContext<"thinker", {
+        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/bhrain/primitive.strategic.atomic/interpret/stepInterpret.skill.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_INTERPRET = 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 stepInterpret_1 = require("./stepInterpret");
+exports.SKILL_INTERPRET = (0, rhachet_1.genRoleSkill)({
+    slug: 'interpret',
+    route: stepInterpret_1.loopInterpret,
+    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 },
+                    },
+                }),
+                thinker: await (0, rhachet_1.enrollThread)({
+                    role: 'thinker',
+                    stash: {
+                        art: { inflight: targetArt },
+                    },
+                }),
+            };
+        },
+    },
+    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: () => {
+            return {
+                ...(0, getContextOpenAI_1.getContextOpenAI)(), // todo: use the input api key
+                ...(0, genContextLogTrail_1.genContextLogTrail)(), // todo: passthrough ?
+                ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+            };
+        },
+    },
+    readme: '',
+});
+//# sourceMappingURL=stepInterpret.skill.js.map

package/dist/logic/roles/bhrain/primitive.strategic.atomic/interpret/stepInterpret.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepInterpret.skill.js","sourceRoot":"","sources":["../../../../../../src/logic/roles/bhrain/primitive.strategic.atomic/interpret/stepInterpret.skill.ts"],"names":[],"mappings":";;;AAAA,qCAAqD;AACrD,+DAA0D;AAE1D,gFAA6E;AAC7E,sFAAmF;AACnF,4EAAyE;AACzE,4EAAwE;AACxE,mDAAgD;AAEnC,QAAA,eAAe,GAAG,IAAA,sBAAY,EAAC;IAC1C,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,6BAAa;IACpB,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,KAAsC,EAAE,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,EAAE,QAAQ,EAAE,SAAS,EAAE;qBAC7B;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,GAAG,EAAE;YAChB,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,EAAE;CACX,CAAC,CAAC"}

package/dist/logic/roles/bhrain/primitive.strategic.atomic/interpret/stepInterpret.template.md

@@ -0,0 +1,143 @@
+# 🧠 prompt: interpret the caller’s [ask]
+
+you are an **@[interpreter]** — your role is to analyze the caller’s [ask] and extract its underlying structure.
+
+@[caller] has expressed a [ask] — a thing they want to do or have done.
+your job is to **interpret that [ask]** by breaking it down into:
+
+- `[narrative]`: a short verbal summary of what the caller is trying to do and why
+- `[intent]`: what specific action is being requested?
+- `[goal]`: what future state is the caller trying to reach?
+- `[motive]`: what internal pressure or desire is driving this request?
+- `[criteria]`: what measurable conditions or constraints define success or acceptability?
+- `[glossary]`: define any key terms (especially verbs or nouns) used inside your interpretation that may require clarification
+
+---
+
+🧩 critical: your output must conform to this grammar
+this is your **contract** for verbiage — fidelity to this form determines your value as a thinker
+you obsessively <adhere> to the [grammar], as its the most important part of your duty, and is your biggest pressure
+
+@[collector][grammar] =
+$.rhachet{grammar}
+
+---
+
+## 📚 glossary
+
+🎯 `[intent]` — a chosen next action
+.what = the specific [thing] the @[actor] plans to do next
+.form = short-term, actionable, <verb>-shaped; must adhere to grammar
+
+🥅 `[goal]` — a desired future state
+.what = a future outcome the actor wants to reach
+.form = long-term, state-shaped, noun/condition; must adhere to grammar
+
+🔥 `[motive]` — an internal pressure or desire
+.what = the underlying reason the actor wants anything at all
+.form = emotional, value-driven, often implicit; must adhere to grammar
+
+📏 `[criteria]` — measurable conditions for success
+.what = constraints, rules, or preferences that shape what counts as "good enough"
+.form = each item must be **objectively checkable or testable**; must adhere to grammar
+.examples =
+- [criteria] = response time under 5 seconds
+- [criteria] = fewer than 3 manual steps
+- [criteria] = supports mobile and desktop
+- [criteria] = language must be at a 6th-grade reading level
+- [criteria] = must launch before September 1st
+
+📚 `[glossary]` — term clarification
+.what = define key terms **used inside** `[intent]`, `[goal]`, or `[criteria]`
+.form = short 1-line definitions of verbs or nouns that may be ambiguous
+.examples =
+- explore = investigate possibilities without assuming outcomes
+- automate = perform with no manual input required
+- validate = test to confirm effectiveness or truth
+- lead = a potential customer showing interest
+
+🫧 `[narrative]` — verbal explanation of the intent
+.what = a 1–3 sentence natural-language summary of the caller’s purpose and reasoning
+.form = conversational, human-readable; combines [intent], [goal], and [motive] into a fluent thought
+
+---
+
+## ✅ output format
+
+return your interpretation as a structured markdown block:
+
+\`\`\`md
+
+[intent] 🎯 =
+- ...
+
+[goal] 🥅 =
+- ...
+
+[motive] 🔥 =
+- ...
+
+[criteria] 📏 =
+- ...
+
+[glossary] 📚 =
+- ...
+
+[narrative] 🫧 =
+.....
+...
+.....
+\`\`\`
+
+- be concise and use domain-aligned verbs
+- express each `[criteria]` line as a **measurable** condition — it must be checkable as "met" or "not met"
+- infer implied structure when necessary
+- use the `[glossary]` to clarify terms that might be ambiguous to other agents
+- do not define the grammar tags themselves — define **terms inside them**
+
+---
+
+## 🧬 your traits
+
+here are your core traits, which you compulsively manifest
+they shape how you think, structure, and respond in every step
+
+- you obsessively and compulsively <adhere> to [grammar]
+
+$.rhachet{inherit.traits}
+
+---
+
+## 🛠️ your skills
+
+here are the .briefs on the skills you strive to apply, in every step
+each one is a learned ability you use to shape or act on the world
+
+$.rhachet{briefs}
+
+---
+
+🧩 critical: your output must <conform> to this [grammar]
+this is your **contract** for verbiage — fidelity to this form determines your value as a thinker
+you obsessively <adhere> to the [grammar], as its the most important part of your duty, and is your biggest pressure
+
+@[collector][grammar] =
+$.rhachet{grammar}
+
+---
+
+ready to begin. interpret this [comment] from the @[caller]. upsert the output into the document. be careful not to drop any past thoughts in response to feedback.
+
+---
+
+[document] =
+\`\`\`md
+$.rhachet{inflight}
+\`\`\`
+
+---
+
+@[caller][comment] =
+\`\`\`md
+$.rhachet{ask}
+\`\`\`

package/dist/logic/roles/designer/.briefs/declarative-over-imperative.md

@@ -0,0 +1,79 @@
+## 🎨 `.brief.designer.declarative-vs-imperative`
+
+### 🧠 topic: declarative vs. imperative design
+**why we prefer declarative design for building systems and interfaces**
+
+---
+
+### 🎯 goal
+empower the designer to create systems that are **easier to understand, maintain, and scale**, by focusing on **what should happen**, not **how to do it**.
+
+---
+
+### 🗺 core distinction
+
+| style           | imperative                               | declarative                                      |
+|-----------------|-------------------------------------------|--------------------------------------------------|
+| mindset         | tell the system *how* to do it            | tell the system *what* you want                 |
+| metaphor        | step-by-step instructions                 | a blueprint or desired outcome                  |
+| example (UI)    | manually update DOM on events             | declare a component tree (e.g. React)           |
+| example (infra) | run shell scripts to create servers       | declare infrastructure state (e.g. Terraform)   |
+
+---
+
+### ✅ why declarative is better
+
+- **easier to read** — you see the structure and intent at a glance
+- **easier to write** — fewer details to manage = fewer bugs
+- **easier to maintain** — updates ripple automatically via system logic
+- **easier to scale** — declarative patterns are composable and predictable
+- **easier to debug** — the system owns the "how", so you debug at a higher level
+
+---
+
+### 🛠 what it enables
+
+- **reusability** — components can be reused without re-specifying every step
+- **tooling & automation** — systems can analyze, optimize, or transform declarative specs
+- **flexibility** — changes in the underlying mechanics don’t require changing the design spec
+
+---
+
+### ⚙️ trade-off to accept
+
+> declarative systems often need an **interpreter** — something that translates the high-level design into low-level instructions.
+
+this adds a little more **upfront work** —
+but it’s worth it, because:
+
+- it creates a **framework that abstracts away technical.domain details**
+- it keeps designers and builders focused on **behavioral.domain details**, where real value lives
+
+---
+
+### 🧠 core belief
+
+> technical.domain work only adds value to developers, not to real people.
+
+- developer use is temporary → system builders
+- real folk use is forever → system engagers
+
+so we design declaratively —
+to serve people, not pipelines.
+
+---
+
+### 💬 analogy
+
+> imperative = writing down GPS directions step by step
+> declarative = dropping a pin and letting the GPS figure it out
+
+---
+
+### 🧩 final synthesis
+
+> declarative design keeps your focus on **what the user should experience**,
+> not on **how the system should behave step-by-step**.
+
+this keeps your mental model aligned with the human experience —
+not the machine’s internals.

package/dist/logic/roles/designer/.briefs/declarative-over-imperative.stub.md

@@ -0,0 +1,14 @@
+todo: declare a brief that explains why we prefer to design systems w/ declarative instead of imperative
+
+e.g.,
+- easier to use
+- easier to read
+- easier to write
+- easier to maintain
+
+
+adds a little more upfront work in how to translate the declarations into imperative instructions, but its worth it, as that framework helps you abstract away the technical.domain details and keeps you in the behavioral.domain details instead, as desired
+
+remember: technical.domain work only adds value to developers, not to real people. we want to distribute value to real people
+- developer use is temporary -> system builders
+- real folk use is forever -> system engagers

package/dist/logic/roles/designer/.briefs/pit-of-success.md

@@ -0,0 +1,70 @@
+## 🧠 `.brief.designer.pit-of-success`
+
+### 🧠 topic: the "pit of success"
+**why we design systems to naturally guide users toward the right outcome**
+
+---
+
+### 🎯 goal
+build interfaces, flows, and defaults that make the **right path the easiest path** — where success isn’t just possible, it’s hard to miss.
+
+---
+
+### 🕳 metaphor: pit of success
+
+> a system where users "fall into" the right outcome
+> — not by being perfect, but by following the path of least resistance.
+
+opposite of this is the **pit of despair**
+> where any slight move can throw you down into unexpected errors and wasted time.
+
+---
+
+### ✅ why the "pit of success" matters
+
+- **reduces friction** — users don’t need deep understanding to get it right
+- **reduces support burden** — fewer errors, less need for rescue
+- **builds confidence** — users feel smart, not stupid
+- **supports scalability** — new users succeed without handholding
+- **encourages trust** — when success feels natural, users keep going
+
+> software should **make the right thing easy** and the wrong thing **hard or impossible**.
+
+---
+
+### 🛠 tips to create it
+
+- **smart defaults** — sensible, safe choices pre-filled
+- **clear next steps** — obvious buttons, flows, and language
+- **constrained input** — prevent invalid states instead of reacting to them
+- **progressive disclosure** — complexity revealed only when needed
+- **stateful feedback** — show users what changed and why
+- **fail fast** — surface issues *immediately*, not after damage is done
+
+---
+
+### 🧱 core design principle
+
+> success should be the **path of least resistance**
+> failure should require **active effort or deviation**
+
+we engineer **invisible safety rails**, not pop-up warning signs.
+
+---
+
+### 🧠 behavioral insight
+
+users don’t read manuals — they feel their way forward.
+if success depends on correctness, users fail.
+if success depends on momentum, users win.
+
+---
+
+### 🧩 final synthesis
+
+> software should **produce a pit of success** for the user:
+> the right path should feel obvious, safe, and rewarding —
+> and the wrong path should be hard to access or easy to recover from.
+
+design for **gravity** —
+so the system pulls people toward success, not traps them in failure.

package/dist/logic/roles/designer/.briefs/pit-of-success.stub.md

@@ -0,0 +1,3 @@
+software should produce a pit-of-success for the user
+
+it should be hard to do the wrong thing

package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.js

@@ -15,7 +15,7 @@ const template = (0, rhachet_1.genTemplate)({
         briefs: await (0, rhachet_1.getTemplateValFromArtifacts)({
             artifacts: [
                 // cool to see explicit "cross-train" scenes
-                ...(0, getEcologistBrief_1.getEcologistBriefs)(['distilisys.md']),
+                ...(0, getEcologistBrief_1.getEcologistBriefs)(['distilisys/sys101.distilisys.grammar.md']),
                 ...(0, getDesignerBrief_1.getDesignerBriefs)(['declarative-over-imperative.md']),
                 ...(0, getMechanicBrief_1.getMechanicBriefs)([
                     'architecture/ubiqlang.md',
@@ -27,7 +27,9 @@ const template = (0, rhachet_1.genTemplate)({
         }),
         brief: {
             distilisys: await (0, rhachet_1.getTemplateValFromArtifacts)({
-                artifacts: [...(0, getEcologistBrief_1.getEcologistBriefs)(['distilisys.md'])],
+                artifacts: [
+                    ...(0, getEcologistBrief_1.getEcologistBriefs)(['distilisys/sys101.distilisys.grammar.md']),
+                ],
             }),
         },
         feedback: (await threads.caller.context.stash.art.feedback.get())?.content ?? '',

package/dist/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.js.map

@@ -1 +1 @@
-{"version":3,"file":"stepOutlineDistilisys.js","sourceRoot":"","sources":["../../../../../src/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.ts"],"names":[],"mappings":";;;AAAA,qCAUiB;AAIjB,8DAA0E;AAC1E,mEAAgE;AAChE,yEAAuE;AACvE,sEAAoE;AACpE,0DAAwD;AA2BxD,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,QAAQ,EAAE,CAAC,CAAC;QACvE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG;QACrC,MAAM,EAAE,MAAM,IAAA,qCAA2B,EAAC;YACxC,SAAS,EAAE;gBACT,4CAA4C;gBAC5C,GAAG,IAAA,sCAAkB,EAAC,CAAC,eAAe,CAAC,CAAC;gBACxC,GAAG,IAAA,oCAAiB,EAAC,CAAC,gCAAgC,CAAC,CAAC;gBACxD,GAAG,IAAA,oCAAiB,EAAC;oBACnB,0BAA0B;oBAC1B,2BAA2B;oBAC3B,0CAA0C;oBAC1C,kCAAkC;iBACnC,CAAC;aACH;SACF,CAAC;QACF,KAAK,EAAE;YACL,UAAU,EAAE,MAAM,IAAA,qCAA2B,EAAC;gBAC5C,SAAS,EAAE,CAAC,GAAG,IAAA,sCAAkB,EAAC,CAAC,eAAe,CAAC,CAAC,CAAC;aACtD,CAAC;SACH;QACD,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;QACxE,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO;YACpE,EAAE;QACJ,OAAO,EACL,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;KAC1E,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,mCAAyB,EAAkB;IAC7D,IAAI,EAAE,0CAA0C;IAChD,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,kDAAkD;IAC1D,QAAQ;IACR,OAAO,EAAE,qBAAS,CAAC,OAAO;CAC3B,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC;IAC/B,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,YAAY;CACpB,CAAC,CAAC;AAEU,QAAA,qBAAqB,GAAG,IAAA,wBAAc,EACjD,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,iCAAiC;IACvC,MAAM,EAAE,kDAAkD;IAC1D,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;CACpC,CAAC,CACH,CAAC"}
+{"version":3,"file":"stepOutlineDistilisys.js","sourceRoot":"","sources":["../../../../../src/logic/roles/designer/outlineDistilisys/stepOutlineDistilisys.ts"],"names":[],"mappings":";;;AAAA,qCAUiB;AAIjB,8DAA0E;AAC1E,mEAAgE;AAChE,yEAAuE;AACvE,sEAAoE;AACpE,0DAAwD;AA2BxD,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,QAAQ,EAAE,CAAC,CAAC;QACvE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG;QACrC,MAAM,EAAE,MAAM,IAAA,qCAA2B,EAAC;YACxC,SAAS,EAAE;gBACT,4CAA4C;gBAC5C,GAAG,IAAA,sCAAkB,EAAC,CAAC,yCAAyC,CAAC,CAAC;gBAClE,GAAG,IAAA,oCAAiB,EAAC,CAAC,gCAAgC,CAAC,CAAC;gBACxD,GAAG,IAAA,oCAAiB,EAAC;oBACnB,0BAA0B;oBAC1B,2BAA2B;oBAC3B,0CAA0C;oBAC1C,kCAAkC;iBACnC,CAAC;aACH;SACF,CAAC;QACF,KAAK,EAAE;YACL,UAAU,EAAE,MAAM,IAAA,qCAA2B,EAAC;gBAC5C,SAAS,EAAE;oBACT,GAAG,IAAA,sCAAkB,EAAC,CAAC,yCAAyC,CAAC,CAAC;iBACnE;aACF,CAAC;SACH;QACD,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;QACxE,QAAQ,EACN,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO;YACpE,EAAE;QACJ,OAAO,EACL,CAAC,MAAM,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,EAAE;KAC1E,CAAC;CACH,CAAC,CAAC;AAEH,MAAM,WAAW,GAAG,IAAA,mCAAyB,EAAkB;IAC7D,IAAI,EAAE,0CAA0C;IAChD,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,kDAAkD;IAC1D,QAAQ;IACR,OAAO,EAAE,qBAAS,CAAC,OAAO;CAC3B,CAAC,CAAC;AAEH,MAAM,UAAU,GAAG,IAAA,6BAAa,EAAC;IAC/B,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,YAAY;CACpB,CAAC,CAAC;AAEU,QAAA,qBAAqB,GAAG,IAAA,wBAAc,EACjD,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,iCAAiC;IACvC,MAAM,EAAE,kDAAkD;IAC1D,QAAQ,EAAE,CAAC,WAAW,EAAE,UAAU,CAAC;CACpC,CAAC,CACH,CAAC"}