rhachet-roles-ehmpathy 1.4.0 → 1.6.0

package/dist/logic/roles/getRoleRegistry.js

@@ -6,6 +6,7 @@ const getBhrainRole_1 = require("./bhrain/getBhrainRole");
 // import { ROLE_ECOLOGIST } from './ecologist/getEcologistRole';
 const getRoleRegistry_readme_1 = require("./getRoleRegistry.readme");
 const getMechanicRole_1 = require("./mechanic/getMechanicRole");
+const getCommanderRole_1 = require("./terminal.commander/getCommanderRole");
 /**
  * .what = returns the core registry of predefined roles and skills
  * .why =
@@ -19,6 +20,7 @@ const getRoleRegistry = () => new rhachet_1.RoleRegistry({
         getBhrainRole_1.ROLE_BHRAIN, // todo: lift bhrain role into own repo
         // ROLE_ECOLOGIST,
         getMechanicRole_1.ROLE_MECHANIC,
+        getCommanderRole_1.ROLE_COMMANDER,
     ],
 });
 exports.getRoleRegistry = getRoleRegistry;

package/dist/logic/roles/getRoleRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"getRoleRegistry.js","sourceRoot":"","sources":["../../../src/logic/roles/getRoleRegistry.ts"],"names":[],"mappings":";;;AAAA,qCAAuC;AAEvC,0DAAqD;AACrD,iEAAiE;AACjE,qEAAoE;AACpE,gEAA2D;AAE3D;;;;;GAKG;AACI,MAAM,eAAe,GAAG,GAAiB,EAAE,CAChD,IAAI,sBAAY,CAAC;IACf,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,iDAAwB;IAChC,KAAK,EAAE;QACL,2BAAW,EAAE,uCAAuC;QACpD,kBAAkB;QAClB,+BAAa;KACd;CACF,CAAC,CAAC;AATQ,QAAA,eAAe,mBASvB"}
+{"version":3,"file":"getRoleRegistry.js","sourceRoot":"","sources":["../../../src/logic/roles/getRoleRegistry.ts"],"names":[],"mappings":";;;AAAA,qCAAuC;AAEvC,0DAAqD;AACrD,iEAAiE;AACjE,qEAAoE;AACpE,gEAA2D;AAC3D,4EAAuE;AAEvE;;;;;GAKG;AACI,MAAM,eAAe,GAAG,GAAiB,EAAE,CAChD,IAAI,sBAAY,CAAC;IACf,IAAI,EAAE,UAAU;IAChB,MAAM,EAAE,iDAAwB;IAChC,KAAK,EAAE;QACL,2BAAW,EAAE,uCAAuC;QACpD,kBAAkB;QAClB,+BAAa;QAEb,iCAAc;KACf;CACF,CAAC,CAAC;AAXQ,QAAA,eAAe,mBAWvB"}

package/dist/logic/roles/terminal.commander/command.exec/stepExecCommand.d.ts

@@ -0,0 +1,42 @@
+import { UniDateTime, UniDuration } from '@ehmpathy/uni-time';
+import { GStitcher, RoleContext, StitchStepCompute, Threads } from 'rhachet';
+import { Focus } from '../../../../_topublish/rhachet-roles-bhrain/src/domain/objects/Focus';
+export declare const stepCommandExec: StitchStepCompute<GStitcher<Threads<{
+    commander: RoleContext<'commander', {
+        art: {
+            /**
+             * the command to execute
+             */
+            input: Focus['concept'];
+            /**
+             * the output that was produced
+             */
+            output: Focus['concept'];
+        };
+    }>;
+}>, import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+}>>;
+type Clock = {
+    range: {
+        since: UniDateTime;
+        until: UniDateTime;
+    };
+    duration: UniDuration;
+};
+/**
+ * spawns a login-capable subshell and runs the provided command.
+ * chooses a single shell (no fallback). defaults to bash if $SHELL contains "bash", otherwise "sh".
+ */
+export declare const runInSubshell: (command: string, opts?: {
+    shell?: 'bash' | 'sh';
+    logPrefix?: string;
+}) => Promise<{
+    code: number | null;
+    stdout: string;
+    stderr: string;
+    clock: Clock;
+}>;
+export {};

package/dist/logic/roles/terminal.commander/command.exec/stepExecCommand.integration.test.d.ts

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

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

@@ -0,0 +1,76 @@
+"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 stepExecCommand_1 = require("./stepExecCommand");
+jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 5 }));
+const artifacts = {
+    commander: {
+        input: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepCommandExec/commander.input.sh' }, { versions: true }),
+        output: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepCommandExec/commander.output.md' }, { versions: true }),
+    },
+};
+const enthread = () => (0, test_fns_1.usePrep)(async () => ({
+    commander: await (0, rhachet_1.enrollThread)({
+        role: 'commander',
+        stash: {
+            art: {
+                input: artifacts.commander.input,
+                output: artifacts.commander.output,
+            },
+            refs: [],
+        },
+        inherit: {},
+    }),
+}));
+describe('stepCommandExec', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = stepExecCommand_1.stepCommandExec;
+    (0, test_fns_1.given)('a simple shell pipeline that writes to stdout and stderr', () => {
+        // prints 'hi' and 'done' to stdout, and 'oops' to stderr
+        const command = `printf "hi\\n"; echo "oops" 1>&2; printf "done\\n"`;
+        beforeEach(async () => {
+            await artifacts.commander.input.set({ content: command });
+            await artifacts.commander.output.set({ content: '' });
+        });
+        (0, test_fns_1.when)('invoked', () => {
+            const threads = enthread();
+            (0, test_fns_1.then)('runs the command in a subshell and writes a markdown report', async () => {
+                const result = await (0, rhachet_1.enweaveOneStitcher)({ stitcher: route, threads }, context);
+                console.log(JSON.stringify(result.stitch, null, 2));
+                console.log(artifacts.commander.output);
+                const { content: md } = await artifacts.commander.output
+                    .get()
+                    .expect('isPresent');
+                // command section
+                expect(md).toContain('### 🐚 command');
+                expect(md).toContain('```sh');
+                expect(md).toContain(command);
+                // exit code section
+                expect(md).toContain('### 🏁 exit code');
+                expect(md).toMatch(/\n0\s*\n/);
+                // stdout section
+                expect(md).toContain('### 📦 stdout');
+                expect(md).toContain('```');
+                expect(md).toMatch(/hi/i);
+                expect(md).toMatch(/done/i);
+                // stderr section
+                expect(md).toContain('### 🚧 stderr');
+                expect(md).toContain('```');
+                expect(md).toMatch(/oops/i);
+                // sanity: artifact path ends with .md (we chose a .md uri above)
+                expect(artifacts.commander.output.ref.uri).toMatch(/\.md$/);
+            });
+        });
+    });
+});
+//# sourceMappingURL=stepExecCommand.integration.test.js.map

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

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

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

@@ -0,0 +1,126 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runInSubshell = exports.stepCommandExec = void 0;
+const uni_time_1 = require("@ehmpathy/uni-time");
+const child_process_1 = require("child_process");
+const helpful_errors_1 = require("helpful-errors");
+const readline = __importStar(require("readline"));
+const rhachet_1 = require("rhachet");
+exports.stepCommandExec = new rhachet_1.StitchStepCompute({
+    slug: '@[commander][command]<exec>',
+    readme: 'executes a terminal command',
+    form: 'COMPUTE',
+    stitchee: 'commander',
+    invoke: async ({ threads }) => {
+        // grab the command from the input artifact
+        const command = (await threads.commander.context.stash.art.input.get())?.content ??
+            helpful_errors_1.UnexpectedCodePathError.throw('no command found in the commander art.input artifact', {
+                artifact: threads.commander.context.stash.art.input,
+            });
+        // spawn a subshell and execute it
+        const { code, stdout, stderr } = await (0, exports.runInSubshell)(command);
+        // save the outputs
+        await threads.commander.context.stash.art.output.set({
+            content: [
+                '# command execution',
+                '',
+                '### 🐚 command',
+                '',
+                '```sh',
+                command,
+                '```',
+                '',
+                '',
+                '### 🏁 exit code',
+                '',
+                `${code ?? '(null)'}`,
+                '',
+                '',
+                '### 📦 stdout',
+                '',
+                '```',
+                stdout?.trim()?.length ? stdout : '(empty)',
+                '```',
+                '',
+                '',
+                '### 🚧 stderr',
+                '',
+                '```',
+                stderr?.trim()?.length ? stderr : '(empty)',
+                '```',
+                '',
+            ].join('\n'),
+        });
+        return {
+            input: { command },
+            output: { code, stdout, stderr },
+        };
+    },
+});
+/**
+ * spawns a login-capable subshell and runs the provided command.
+ * chooses a single shell (no fallback). defaults to bash if $SHELL contains "bash", otherwise "sh".
+ */
+const runInSubshell = async (command, opts) => {
+    // capture start time as early as possible
+    const beganAt = (0, uni_time_1.asUniDateTime)(new Date());
+    return await new Promise((resolve, reject) => {
+        const shell = opts?.shell ?? (process.env.SHELL?.includes('bash') ? 'bash' : 'sh');
+        const child = (0, child_process_1.spawn)(shell, ['-lc', command], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        const bufsOut = [];
+        const bufsErr = [];
+        // stream lines to parent with optional prefix (observability)
+        // while also buffering raw bytes for return payload
+        const wire = (stream, onChunk, write) => {
+            if (!stream)
+                return;
+            const rl = readline.createInterface({ input: stream });
+            rl.on('line', (line) => write((opts?.logPrefix ?? '') + line + '\n'));
+            stream.on('data', (d) => onChunk(Buffer.isBuffer(d) ? d : Buffer.from(d)));
+        };
+        wire(child.stdout, (b) => bufsOut.push(b), (s) => process.stdout.write(s));
+        wire(child.stderr, (b) => bufsErr.push(b), (s) => process.stderr.write(s));
+        child.once('error', reject);
+        child.once('exit', (code) => {
+            const until = (0, uni_time_1.asUniDateTime)(new Date());
+            const range = { since: beganAt, until };
+            const clock = {
+                range,
+                duration: (0, uni_time_1.getDuration)({ of: { range } }),
+            };
+            resolve({
+                code,
+                stdout: Buffer.concat(bufsOut).toString('utf8'),
+                stderr: Buffer.concat(bufsErr).toString('utf8'),
+                clock,
+            });
+        });
+    });
+};
+exports.runInSubshell = runInSubshell;
+//# sourceMappingURL=stepExecCommand.js.map

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

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

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

@@ -0,0 +1,12 @@
+export declare const SKILL_COMMAND_EXEC: import("rhachet").RoleSkill<import("rhachet").GStitcher<import("rhachet").Threads<{
+    commander: import("rhachet").RoleContext<"commander", {
+        art: {
+            input: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            output: import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+        };
+    }>;
+}>, import("simple-log-methods").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    code: number | null;
+    stdout: string;
+    stderr: string;
+}>>;

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;
+}>>;