rhachet-roles-ehmpathy 1.4.0 → 1.7.0

package/dist/logic/roles/terminal.commander/command.exec/stepExecCommand.skill.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_COMMAND_EXEC = void 0;
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const genContextLogTrail_1 = require("../../../../.test/genContextLogTrail");
+const setSkillOutputSrc_1 = require("../../../artifact/setSkillOutputSrc");
+const genStitchStreamToDisk_1 = require("../../../context/genStitchStreamToDisk");
+const stepExecCommand_1 = require("./stepExecCommand");
+exports.SKILL_COMMAND_EXEC = (0, rhachet_1.genRoleSkill)({
+    slug: 'exec',
+    route: stepExecCommand_1.stepCommandExec,
+    threads: {
+        lookup: {
+            input: {
+                source: 'process.argv',
+                char: 'i',
+                desc: 'path to the input artifact containing the command text',
+                type: 'string',
+            },
+            output: {
+                source: 'process.argv',
+                char: 'o',
+                desc: 'path to the output artifact (markdown report)',
+                type: 'string',
+            },
+        },
+        assess: (input) => typeof input.input === 'string' &&
+            typeof input.output === 'string',
+        instantiate: async (input) => {
+            // declare where all the artifacts will be found
+            // const obsDir = getArtifactObsDir({ uri: input.output });
+            const artifacts = {
+                input: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.input }, { access: 'readonly' }),
+                output: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.output }, { versions: true }),
+            };
+            // add an src file for historic record
+            await (0, setSkillOutputSrc_1.setSkillOutputSrc)({
+                skillUri: 'commander.exec',
+                opts: input,
+            }).catch(() => { });
+            // enroll the threads
+            return {
+                commander: await (0, rhachet_1.enrollThread)({
+                    role: 'commander',
+                    stash: {
+                        art: {
+                            input: artifacts.input,
+                            output: artifacts.output,
+                        },
+                    },
+                }),
+            };
+        },
+    },
+    // no OpenAI needed for pure command execution
+    context: {
+        lookup: {},
+        assess: (_) => true,
+        instantiate: () => ({
+            ...(0, genContextLogTrail_1.genContextLogTrail)(),
+            ...(0, rhachet_1.genContextStitchTrail)({
+                stream: (0, genStitchStreamToDisk_1.genStitchStreamToDisk)({ dir: process.cwd() }), // stream events to disk
+            }),
+        }),
+    },
+    readme: '',
+});
+//# sourceMappingURL=stepExecCommand.skill.js.map

package/dist/logic/roles/terminal.commander/command.exec/stepExecCommand.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepExecCommand.skill.js","sourceRoot":"","sources":["../../../../../src/logic/roles/terminal.commander/command.exec/stepExecCommand.skill.ts"],"names":[],"mappings":";;;AAAA,qCAA4E;AAC5E,+DAA0D;AAE1D,6EAA0E;AAC1E,2EAAwE;AACxE,kFAA+E;AAC/E,uDAAoD;AAEvC,QAAA,kBAAkB,GAAG,IAAA,sBAAY,EAAC;IAC7C,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,iCAAe;IACtB,OAAO,EAAE;QACP,MAAM,EAAE;YACN,KAAK,EAAE;gBACL,MAAM,EAAE,cAAc;gBACtB,IAAI,EAAE,GAAG;gBACT,IAAI,EAAE,wDAAwD;gBAC9D,IAAI,EAAE,QAAQ;aACf;YACD,MAAM,EAAE;gBACN,MAAM,EAAE,cAAc;gBACtB,IAAI,EAAE,GAAG;gBACT,IAAI,EAAE,+CAA+C;gBACrD,IAAI,EAAE,QAAQ;aACf;SACF;QACD,MAAM,EAAE,CACN,KAAK,EAKL,EAAE,CACF,OAAQ,KAAa,CAAC,KAAK,KAAK,QAAQ;YACxC,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAElC,WAAW,EAAE,KAAK,EAAE,KAInB,EAAE,EAAE;YACH,gDAAgD;YAChD,2DAA2D;YAC3D,MAAM,SAAS,GAAG;gBAChB,KAAK,EAAE,IAAA,yCAAkB,EAAC,EAAE,GAAG,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;gBACvE,MAAM,EAAE,IAAA,yCAAkB,EAAC,EAAE,GAAG,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;aACtE,CAAC;YAEF,sCAAsC;YACtC,MAAM,IAAA,qCAAiB,EAAC;gBACtB,QAAQ,EAAE,gBAAgB;gBAC1B,IAAI,EAAE,KAAK;aACZ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAEnB,qBAAqB;YACrB,OAAO;gBACL,SAAS,EAAE,MAAM,IAAA,sBAAY,EAAC;oBAC5B,IAAI,EAAE,WAAW;oBACjB,KAAK,EAAE;wBACL,GAAG,EAAE;4BACH,KAAK,EAAE,SAAS,CAAC,KAAK;4BACtB,MAAM,EAAE,SAAS,CAAC,MAAM;yBACzB;qBACF;iBACF,CAAC;aACH,CAAC;QACJ,CAAC;KACF;IAED,8CAA8C;IAC9C,OAAO,EAAE;QACP,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,CAAC,CAAC,EAA8B,EAAE,CAAC,IAAI;QAC/C,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC;YAClB,GAAG,IAAA,uCAAkB,GAAE;YACvB,GAAG,IAAA,+BAAqB,EAAC;gBACvB,MAAM,EAAE,IAAA,6CAAqB,EAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,wBAAwB;aAChF,CAAC;SACH,CAAC;KACH;IACD,MAAM,EAAE,EAAE;CACX,CAAC,CAAC"}

package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.d.ts

@@ -0,0 +1,54 @@
+import { GStitcher, RoleContext, Threads } from 'rhachet';
+import { Artifact } from 'rhachet-artifact';
+import { GitFile } from 'rhachet-artifact-git';
+import { Focus } from '../../../../_topublish/rhachet-roles-bhrain/src/domain/objects/Focus';
+import { ContextOpenAI } from '../../../../data/sdk/sdkOpenAi';
+type StitcherDesired = GStitcher<Threads<{
+    caller: RoleContext<'caller', {
+        art: {
+            feedback: Artifact<typeof GitFile>;
+            'foci.goal.concept': Focus['concept'];
+            'foci.goal.context': Focus['context'];
+        };
+        refs: Artifact<typeof GitFile>[];
+    }>;
+    thinker: RoleContext<'thinker', {
+        art: {
+            'focus.concept': Focus['concept'];
+            'focus.context': Focus['context'];
+        };
+        briefs: Artifact<typeof GitFile>[];
+    }>;
+}>, ContextOpenAI & GStitcher['context'], {
+    content: string;
+}>;
+export declare const stepCommandPlan: import("rhachet").Stitcher<StitcherDesired>;
+export declare const loopCommandPlan: import("rhachet").Stitcher<GStitcher<Threads<{
+    caller: RoleContext<"caller", {
+        art: {
+            feedback: Artifact<typeof GitFile>;
+            'foci.goal.concept': Focus['concept'];
+            'foci.goal.context': Focus['context'];
+        };
+        refs: Artifact<typeof GitFile>[];
+    } & {
+        ask: string;
+        art: {
+            feedback: Artifact<typeof GitFile, string>;
+        };
+    }>;
+    thinker: RoleContext<"thinker", {
+        art: {
+            'focus.concept': Focus['concept'];
+            'focus.context': Focus['context'];
+        };
+        briefs: Artifact<typeof GitFile>[];
+    } & {
+        art: {
+            "focus.concept": Artifact<typeof GitFile, string>;
+        };
+    }>;
+}>, ContextOpenAI & import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: GitFile | null;
+}>>;
+export {};

package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.integration.test.d.ts

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

package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.integration.test.js

@@ -0,0 +1,97 @@
+"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 stepPlanCommand_1 = require("./stepPlanCommand");
+jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 5 }));
+const artifacts = {
+    caller: {
+        feedback: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepCommandPlan/caller.feedback.md' }, { versions: true }),
+        'foci.goal.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/stepCommandPlan/caller.foci.goal.concept.md',
+        }, { versions: true }),
+        'foci.goal.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/stepCommandPlan/caller.foci.goal.context.md',
+        }, { versions: true }),
+    },
+    thinker: {
+        'focus.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepCommandPlan/thinker.focus.concept.md' }, { versions: true }),
+        'focus.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepCommandPlan/thinker.focus.context.md' }, { versions: true }),
+    },
+};
+const enthread = () => (0, test_fns_1.usePrep)(async () => ({
+    caller: await (0, rhachet_1.enrollThread)({
+        role: 'caller',
+        stash: {
+            art: {
+                'foci.goal.concept': artifacts.caller['foci.goal.concept'],
+                'foci.goal.context': artifacts.caller['foci.goal.context'],
+                feedback: artifacts.caller.feedback,
+            },
+            refs: [],
+        },
+    }),
+    thinker: await (0, rhachet_1.enrollThread)({
+        role: 'thinker',
+        stash: {
+            art: {
+                'focus.context': artifacts.thinker['focus.context'],
+                'focus.concept': artifacts.thinker['focus.concept'],
+            },
+            briefs: [],
+        },
+        inherit: {},
+    }),
+}));
+describe('stepCommandPlan', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = stepPlanCommand_1.stepCommandPlan;
+    (0, test_fns_1.given)('we want to commandPlan a file move', () => {
+        const ask = `
+given
+
+➜ tree src/logic/roles/terminal.commander
+src/logic/roles/terminal.commander
+└── commandPlan
+    ├── stepCommandPlan.integration.test.ts
+    ├── stepCommandPlan.skill.ts
+    └── stepCommandPlan.ts
+
+rename from stepCommandPlan to just stepPlan.ts
+      `;
+        beforeEach(async () => {
+            await artifacts.caller.feedback.set({ content: '' });
+            await artifacts.thinker['focus.context'].set({
+                content: [].join('\n'),
+            });
+            await artifacts.thinker['focus.concept'].set({
+                content: [].join('\n'),
+            });
+            await artifacts.caller['foci.goal.concept'].set({
+                content: ask,
+            });
+        });
+        (0, test_fns_1.when)('invoked', () => {
+            const goalThreads = enthread();
+            (0, test_fns_1.then)('outputs an instance', async () => {
+                const result = await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads: goalThreads }, context);
+                console.log(JSON.stringify(result.stitch, null, 2));
+                console.log(artifacts.thinker['focus.concept']);
+                const { content } = await artifacts.thinker['focus.concept']
+                    .get()
+                    .expect('isPresent');
+                expect(content.toLowerCase()).toMatch(/pun|knock/i);
+            });
+        });
+    });
+});
+//# sourceMappingURL=stepPlanCommand.integration.test.js.map

package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepPlanCommand.integration.test.js","sourceRoot":"","sources":["../../../../../src/logic/roles/terminal.commander/command.plan/stepPlanCommand.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loopCommandPlan = exports.stepCommandPlan = void 0;
+const rhachet_1 = require("rhachet");
+const genLoopFeedback_1 = require("../../../artifact/genLoopFeedback");
+const stepInstantiate_1 = require("../../bhrain/khue.instantiate/stepInstantiate");
+const BRIEFS_FOR_CLIPLAN = [];
+const stepAddBriefs = new rhachet_1.StitchStepCompute({
+    slug: '@[thinker]<getBriefs>',
+    readme: "adds a set of briefs to the @[thinker]'s context",
+    form: 'COMPUTE',
+    stitchee: 'thinker',
+    invoke: async ({ threads }) => {
+        // identify the prior briefs
+        const briefsBeforeUnsanitized = threads.thinker.context.stash.briefs;
+        // drop the briefs if they were already included (we'll put them at the end again, so they're the last thought)
+        const briefsBefore = briefsBeforeUnsanitized.filter((b) => !BRIEFS_FOR_CLIPLAN.includes(b));
+        // append these briefs
+        const briefsAfter = [...briefsBefore, ...BRIEFS_FOR_CLIPLAN];
+        // add the briefs to the thinker's context
+        threads.thinker.context.stash.briefs = briefsAfter;
+        // extend the focus context to explicitly know to use these briefs; // todo: put this into its own step for observability in stitch trail
+        const focusContextBefore = (await threads.thinker.context.stash.art['focus.context'].get())?.content;
+        const focusContextToAdd = `
+instantiate a shell terminal command which will achieve the ask
+
+objectives
+- maximize readability
+- maximize maintainability
+
+tactics
+- comments and newlines -> maximize readability
+- simplify => maximize maintainability
+- yagni => maximize maintainability
+    `.trim();
+        const focusContextAfter = [
+            focusContextBefore,
+            '',
+            '---',
+            '',
+            focusContextToAdd,
+        ].join('\n');
+        await threads.thinker.context.stash.art['focus.context'].set({
+            content: focusContextAfter,
+        });
+        // and then report that we did so
+        return {
+            input: null,
+            output: {
+                briefs: {
+                    before: briefsBefore.map((artifact) => artifact.ref.uri),
+                    after: briefsAfter.map((artifact) => artifact.ref.uri),
+                },
+            },
+        };
+    },
+});
+exports.stepCommandPlan = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
+    slug: '@[thinker]<commandPlan>',
+    readme: '@[thinker]<getBriefs> -> @[thinker]<instantiate>[command][plan] -> [instance][command][plan]',
+    sequence: [stepAddBriefs, stepInstantiate_1.stepInstantiate],
+}));
+exports.loopCommandPlan = (0, genLoopFeedback_1.genLoopFeedback)({
+    stitchee: 'thinker',
+    artee: 'focus.concept',
+    repeatee: exports.stepCommandPlan,
+});
+//# sourceMappingURL=stepPlanCommand.js.map

package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepPlanCommand.js","sourceRoot":"","sources":["../../../../../src/logic/roles/terminal.commander/command.plan/stepPlanCommand.ts"],"names":[],"mappings":";;;AAAA,qCAOiB;AAMjB,uEAAoE;AACpE,mFAAgF;AAEhF,MAAM,kBAAkB,GAA+B,EAAE,CAAC;AA8B1D,MAAM,aAAa,GAAG,IAAI,2BAAiB,CAMzC;IACA,IAAI,EAAE,uBAAuB;IAC7B,MAAM,EAAE,kDAAkD;IAC1D,IAAI,EAAE,SAAS;IACf,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,4BAA4B;QAC5B,MAAM,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAErE,+GAA+G;QAC/G,MAAM,YAAY,GAAG,uBAAuB,CAAC,MAAM,CACjD,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,CACvC,CAAC;QAEF,sBAAsB;QACtB,MAAM,WAAW,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,kBAAkB,CAAC,CAAC;QAE7D,0CAA0C;QAC1C,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC;QAEnD,yIAAyI;QACzI,MAAM,kBAAkB,GAAG,CACzB,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,GAAG,EAAE,CAC/D,EAAE,OAAO,CAAC;QACX,MAAM,iBAAiB,GAAG;;;;;;;;;;;KAWzB,CAAC,IAAI,EAAE,CAAC;QACT,MAAM,iBAAiB,GAAG;YACxB,kBAAkB;YAClB,EAAE;YACF,KAAK;YACL,EAAE;YACF,iBAAiB;SAClB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACb,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC;YAC3D,OAAO,EAAE,iBAAiB;SAC3B,CAAC,CAAC;QAEH,iCAAiC;QACjC,OAAO;YACL,KAAK,EAAE,IAAI;YACX,MAAM,EAAE;gBACN,MAAM,EAAE;oBACN,MAAM,EAAE,YAAY,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;oBACxD,KAAK,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;iBACvD;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEU,QAAA,eAAe,GAAG,IAAA,wBAAc,EAC3C,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,yBAAyB;IAC/B,MAAM,EACJ,8FAA8F;IAChG,QAAQ,EAAE,CAAC,aAAa,EAAE,iCAAe,CAAC;CAC3C,CAAC,CACH,CAAC;AAEW,QAAA,eAAe,GAAG,IAAA,iCAAe,EAAC;IAC7C,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,eAAe;IACtB,QAAQ,EAAE,uBAAe;CAC1B,CAAC,CAAC"}

package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.skill.d.ts

@@ -0,0 +1,28 @@
+export declare const SKILL_COMMAND_PLAN: import("rhachet").RoleSkill<import("rhachet").GStitcher<import("rhachet").Threads<{
+    caller: import("rhachet").RoleContext<"caller", {
+        art: {
+            feedback: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            'foci.goal.concept': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            'foci.goal.context': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+        refs: 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: {
+            'focus.concept': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            'focus.context': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+        briefs: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>[];
+    } & {
+        art: {
+            "focus.concept": 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/terminal.commander/command.plan/stepPlanCommand.skill.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_COMMAND_PLAN = void 0;
+const fast_glob_1 = require("fast-glob");
+const rhachet_1 = require("rhachet");
+const rhachet_artifact_git_1 = require("rhachet-artifact-git");
+const genContextLogTrail_1 = require("../../../../.test/genContextLogTrail");
+const getContextOpenAI_1 = require("../../../../.test/getContextOpenAI");
+const setSkillOutputSrc_1 = require("../../../artifact/setSkillOutputSrc");
+const genStitchStreamToDisk_1 = require("../../../context/genStitchStreamToDisk");
+const stepPlanCommand_1 = require("./stepPlanCommand");
+exports.SKILL_COMMAND_PLAN = (0, rhachet_1.genRoleSkill)({
+    slug: 'plan',
+    route: stepPlanCommand_1.loopCommandPlan,
+    threads: {
+        lookup: {
+            output: {
+                source: 'process.argv',
+                char: 'o',
+                desc: 'the output file to write against',
+                type: 'string',
+            },
+            goal: {
+                source: 'process.argv',
+                char: 'g',
+                desc: 'the goal of the request',
+                type: '?string',
+            },
+            references: {
+                source: 'process.argv',
+                char: 'f',
+                desc: 'reference files to use, if any; delimit with commas',
+                type: '?string',
+            },
+            briefs: {
+                source: 'process.argv',
+                char: 'b',
+                desc: 'brief files to use, if any; delimit with commas',
+                type: '?string',
+            },
+        },
+        assess: (input) => typeof input.output === 'string',
+        instantiate: async (input) => {
+            // declare where all the artifacts will be found
+            const obsDir = (0, rhachet_artifact_git_1.getArtifactObsDir)({ uri: input.output });
+            const artifacts = {
+                goal: {
+                    concept: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.goal.concept.md' }, { versions: true }),
+                    context: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.goal.context.md' }, { versions: true }),
+                },
+                feedback: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.feedback.md' }, { versions: true }),
+                'focus.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.focus.context.md' }, { versions: true }),
+                'focus.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.output }, { versions: true }),
+                references: (await Promise.all(input.references
+                    ?.split(',')
+                    .filter((uri) => !!uri)
+                    .map(async (pattern) => await (0, fast_glob_1.glob)(pattern)) ?? []))
+                    .flat()
+                    .map((reference) => (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: reference }, { access: 'readonly' })),
+                briefs: input.briefs
+                    ?.split(',')
+                    .filter((uri) => !!uri)
+                    .map((brief) => (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: brief }, { access: 'readonly' })) ?? [],
+            };
+            // detect the goal of the caller
+            const goalConcept = await (async () => {
+                // if goal explicitly defined, use it
+                if (input.goal)
+                    return ((await (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.goal }, { access: 'readonly' }).get())?.content ?? input.ask);
+                // otherwise, assume it's the ask
+                return input.ask;
+            })();
+            await artifacts.goal.concept.set({ content: goalConcept });
+            // add an src file for historic record
+            await (0, setSkillOutputSrc_1.setSkillOutputSrc)({ skillUri: 'bhrain.commandPlan', opts: input }); // todo: get skillUri from context
+            return {
+                caller: await (0, rhachet_1.enrollThread)({
+                    role: 'caller',
+                    stash: {
+                        ask: '',
+                        art: {
+                            'foci.goal.concept': artifacts.goal.concept,
+                            'foci.goal.context': artifacts.goal.context,
+                            feedback: artifacts.feedback,
+                        },
+                        refs: artifacts.references,
+                    },
+                }),
+                thinker: await (0, rhachet_1.enrollThread)({
+                    role: 'thinker',
+                    stash: {
+                        art: {
+                            'focus.context': artifacts['focus.context'],
+                            'focus.concept': artifacts['focus.concept'],
+                        },
+                        briefs: artifacts.briefs,
+                    },
+                }),
+            };
+        },
+    },
+    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)(),
+                ...(0, genContextLogTrail_1.genContextLogTrail)(),
+                ...(0, rhachet_1.genContextStitchTrail)({
+                    stream: (0, genStitchStreamToDisk_1.genStitchStreamToDisk)({ dir: process.cwd() }), // stream events to disk
+                }),
+            };
+        },
+    },
+    readme: '',
+});
+//# sourceMappingURL=stepPlanCommand.skill.js.map

package/dist/logic/roles/terminal.commander/command.plan/stepPlanCommand.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepPlanCommand.skill.js","sourceRoot":"","sources":["../../../../../src/logic/roles/terminal.commander/command.plan/stepPlanCommand.skill.ts"],"names":[],"mappings":"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"}

package/dist/logic/roles/terminal.commander/getCommanderRole.d.ts

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

package/dist/logic/roles/terminal.commander/getCommanderRole.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ROLE_COMMANDER = void 0;
+const rhachet_1 = require("rhachet");
+const getBhrainBrief_1 = require("../bhrain/getBhrainBrief");
+const getMechanicBrief_1 = require("../mechanic/getMechanicBrief");
+const stepExecCommand_skill_1 = require("./command.exec/stepExecCommand.skill");
+const stepPlanCommand_skill_1 = require("./command.plan/stepPlanCommand.skill");
+exports.ROLE_COMMANDER = rhachet_1.Role.build({
+    slug: 'commander',
+    name: 'Commander',
+    purpose: 'command the terminal',
+    readme: `
+## 🐧 Commander
+
+a helpful terminal commander, at your service
+- plan shell commands to achieve your goals
+- exec shell commands on your behalf
+- achive to plan and exec, in one operation
+  `.trim(),
+    traits: [
+        rhachet_1.RoleTrait.build({
+            slug: 'ocd',
+            readme: 'obsesses over structure, precision, and clarity',
+            brief: (0, getBhrainBrief_1.getBhrainBrief)('trait.ocd.md'),
+        }),
+        rhachet_1.RoleTrait.build({
+            slug: 'vibes',
+            readme: 'careful about the aesthetics of their output',
+            brief: (0, getMechanicBrief_1.getMechanicBrief)('style.words.lowercase.md'),
+        }),
+    ],
+    skills: [stepPlanCommand_skill_1.SKILL_COMMAND_PLAN, stepExecCommand_skill_1.SKILL_COMMAND_EXEC],
+    briefs: { dir: __dirname + '/.briefs' },
+});
+//# sourceMappingURL=getCommanderRole.js.map

package/dist/logic/roles/terminal.commander/getCommanderRole.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getCommanderRole.js","sourceRoot":"","sources":["../../../../src/logic/roles/terminal.commander/getCommanderRole.ts"],"names":[],"mappings":";;;AAAA,qCAA0C;AAE1C,6DAA0D;AAC1D,mEAAgE;AAChE,gFAA0E;AAC1E,gFAA0E;AAE7D,QAAA,cAAc,GAAG,cAAI,CAAC,KAAK,CAAC;IACvC,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,sBAAsB;IAC/B,MAAM,EAAE;;;;;;;GAOP,CAAC,IAAI,EAAE;IACR,MAAM,EAAE;QACN,mBAAS,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,iDAAiD;YACzD,KAAK,EAAE,IAAA,+BAAc,EAAC,cAAc,CAAC;SACtC,CAAC;QACF,mBAAS,CAAC,KAAK,CAAC;YACd,IAAI,EAAE,OAAO;YACb,MAAM,EAAE,8CAA8C;YACtD,KAAK,EAAE,IAAA,mCAAgB,EAAC,0BAA0B,CAAC;SACpD,CAAC;KACH;IACD,MAAM,EAAE,CAAC,0CAAkB,EAAE,0CAAkB,CAAC;IAChD,MAAM,EAAE,EAAE,GAAG,EAAE,SAAS,GAAG,UAAU,EAAE;CACxC,CAAC,CAAC"}

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet-roles-ehmpathy",
   "author": "ehmpathy",
   "description": "empathetic software construction roles and skills, via rhachet",
-  "version": "1.4.0",
+  "version": "1.7.0",
   "repository": "ehmpathy/rhachet-roles-ehmpathy",
   "homepage": "https://github.com/ehmpathy/rhachet-roles-ehmpathy",
   "keywords": [
@@ -57,7 +57,7 @@
     "helpful-errors": "1.3.8",
     "inquirer": "12.7.0",
     "openai": "5.8.2",
-    "rhachet": "1.7.2",
+    "rhachet": "1.10.0",
     "rhachet-artifact": "1.0.0",
     "rhachet-artifact-git": "1.1.0",
     "serde-fns": "1.2.0",