rhachet-roles-ehmpathy 1.1.0 → 1.3.0

package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.template.md

@@ -0,0 +1,120 @@
+# 🗣️ prompt: `<articulate>` — generate a .brief article for a given [concept]
+
+you are a **skilled explainer** performing the **focus.motion** primitive `<articulate>`.
+
+---
+
+## 📜 contract
+for `<articulate>` to work as intended:
+
+input = [concept][brief] = `focus.concept`
+  - may be **empty** (start from scratch)
+  - may be a **seed** (partial brief to expand)
+  - may be **inflight** (actively being refined)
+  - must define a **single, coherent concept** — not a bundle of unrelated topics
+
+output = [concept][brief]
+  - a high-signal markdown `.brief` that captures the concept in clear, accessible form
+  - must be **complete** enough to serve as a stable reference for others or your future self
+  - all sections should maximize **signal-to-noise** and avoid filler
+
+**why this contract exists:**
+- articulation turns **implicit understanding** into **explicit, structured form**
+- consistent `.brief` structure ensures clarity, comparability, and reuse
+- constraints prevent drift away from the core concept
+
+---
+
+## ⚙️ method
+1. **anchor to the seed**
+   - establish the core concept or seed you’re articulating
+   - lock in scope and avoid redefining mid-process
+
+2. **structure**
+   - choose an organizational frame (outline, template, narrative, gallery-based, etc.)
+   - match format to purpose and audience
+   - when producing the brief:
+     - leverage **the provided templates** when relevant
+     - and/or **imagine the most useful aspects to articulate** for the concept, based on its nature and context
+
+3. **express**
+   - render the concept in clear, direct language
+   - surface key attributes, context, and distinctions
+
+4. **refine**
+   - check for clarity, completeness, and fidelity to the original intent
+   - adjust wording or structure as needed
+
+---
+
+## 📐 output format
+- return **only** the `.md` brief — no extra commentary
+- always start with:
+  `# 🧩 .brief.article: \`[concept]\``
+- all section headers use `##` or `---` separators
+- prose must be lowercase except proper nouns
+- use concise lists and short paragraphs; avoid long blocks of text
+
+
+---
+
+## 📚 briefs
+
+here are the .briefs you've studied for this skill and actively strive to leverage
+
+$.rhachet{skill.briefs}
+
+---
+
+## 📥 inputs
+
+the following inputs define the semantic frame for `<articulate>`:
+
+---
+
+## 📎 references
+
+here are possibly relevant references you may need
+
+$.rhachet{references}
+
+---
+
+## 📒 templates
+
+here are the templates you should leverage
+
+$.rhachet{templates}
+
+---
+
+### 🧘 @[focus.context]
+> the context in focus available for leverage
+
+\`\`\`md
+$.rhachet{focus.context}
+\`\`\`
+
+---
+
+### 🫐 @[focus.concept]
+> the **inflight document of output** — the seed brief being refined by `<articulate>`
+> if this is empty, treat it as **no seed** and start from scratch
+
+\`\`\`md
+$.rhachet{focus.concept}
+\`\`\`
+
+---
+
+### 🎯 @[guide.goal]
+\`\`\`md
+$.rhachet{guide.goal}
+\`\`\`
+
+---
+
+### 💬 @[guide.feedback]
+\`\`\`md
+$.rhachet{guide.feedback}
+\`\`\`

package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.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 stepCatalogize: import("rhachet").Stitcher<StitcherDesired>;
+export declare const loopCatalogize: 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/bhrain/brief.catalogize/stepCatalogize.integration.test.js

@@ -0,0 +1,118 @@
+"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 getBhrainBrief_1 = require("../getBhrainBrief");
+const stepCatalogize_1 = require("./stepCatalogize");
+jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 5 }));
+const artifacts = {
+    caller: {
+        feedback: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepCatalogize/caller.feedback.md' }, { versions: true }),
+        'foci.goal.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/stepCatalogize/caller.foci.goal.concept.md',
+        }, { versions: true }),
+        'foci.goal.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({
+            uri: __dirname + '/.temp/stepCatalogize/caller.foci.goal.context.md',
+        }, { versions: true }),
+    },
+    thinker: {
+        'focus.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepCatalogize/thinker.focus.concept.md' }, { versions: true }),
+        'focus.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepCatalogize/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: {
+            traits: (0, getBhrainBrief_1.getBhrainBriefs)(['trait.ocd.md']),
+        },
+    }),
+}));
+describe('stepCatalogize', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = stepCatalogize_1.stepCatalogize;
+    (0, test_fns_1.given)('we want to catalogize joke variants', () => {
+        const ask = 'what are different types of jokes? show atleast (but hopefully more than) 5 clusters with 3 sub-clusters each';
+        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);
+            });
+        });
+    });
+    (0, test_fns_1.given)('we want to catalogize persona usecases', () => {
+        const goalConcept = 'what are different usecases for personas?';
+        const goalContext = [].join('\n');
+        beforeEach(async () => {
+            await artifacts.caller.feedback.set({ content: '' });
+            await artifacts.thinker['focus.context'].set({
+                content: goalContext, // todo: why is this on focus.context and not goal.context?
+            });
+            await artifacts.thinker['focus.concept'].set({
+                content: [].join('\n'),
+            });
+            await artifacts.caller['foci.goal.concept'].set({
+                content: goalConcept,
+            });
+        });
+        (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);
+                console.log(artifacts.thinker['focus.concept']);
+                const { content } = await artifacts.thinker['focus.concept']
+                    .get()
+                    .expect('isPresent');
+                expect(content.toLowerCase()).toMatch(/product/i);
+            });
+        });
+    });
+});
+//# sourceMappingURL=stepCatalogize.integration.test.js.map

package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.integration.test.js.map

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

package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loopCatalogize = exports.stepCatalogize = void 0;
+const rhachet_1 = require("rhachet");
+const genLoopFeedback_1 = require("../../../artifact/genLoopFeedback");
+const getBhrainBrief_1 = require("../getBhrainBrief");
+const stepInstantiate_1 = require("../khue.instantiate/stepInstantiate");
+const BRIEFS_FOR_CATALOGIZE = (0, getBhrainBrief_1.getBhrainBriefs)([
+    'cognition/cog021.structs.catalog.md',
+    'knowledge/kno201.documents.catalogs.[article].md',
+    'knowledge/kno201.documents._.[catalog].md',
+    'knowledge/kno301.doc.enbrief.2._.[catalog].md',
+    'knowledge/kno301.doc.enbrief.2.catalogize.[article].md',
+    'knowledge/kno301.doc.enbrief.2.catalogize.[lesson].md',
+    'knowledge/kno301.doc.enbrief.1.from_instances.[demo].color.md',
+    'knowledge/kno301.doc.enbrief.1.from_instances.[demo].gravity.md',
+    'knowledge/kno301.doc.enbrief.1.from_instances.[demo].entropy.md',
+    'knowledge/kno501.doc.enbrief.catalog.structure1.[article].md',
+    'knowledge/kno501.doc.enbrief.catalog.structure1.[lesson].template.md',
+]);
+const stepAddThinkerBriefs = 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_CATALOGIZE.includes(b));
+        // append these briefs
+        const briefsAfter = [...briefsBefore, ...BRIEFS_FOR_CATALOGIZE];
+        // 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 the concept as a [catalog] via the <catalogize> mechanism, defined in your briefs.
+
+in particular, leverage 'catalog.structure.s1' when possible
+    `.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.stepCatalogize = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
+    slug: '@[thinker]<catalogize>',
+    readme: '@[thinker]<getBriefs> -> @[thinker]<instantiate>[catalog] -> [instance][catalog]',
+    sequence: [stepAddThinkerBriefs, stepInstantiate_1.stepInstantiate],
+}));
+exports.loopCatalogize = (0, genLoopFeedback_1.genLoopFeedback)({
+    stitchee: 'thinker',
+    artee: 'focus.concept',
+    repeatee: exports.stepCatalogize,
+});
+//# sourceMappingURL=stepCatalogize.js.map

package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepCatalogize.js","sourceRoot":"","sources":["../../../../../src/logic/roles/bhrain/brief.catalogize/stepCatalogize.ts"],"names":[],"mappings":";;;AAAA,qCAOiB;AAMjB,uEAAoE;AACpE,sDAAoD;AACpD,yEAAsE;AAEtE,MAAM,qBAAqB,GAAG,IAAA,gCAAe,EAAC;IAC5C,qCAAqC;IACrC,kDAAkD;IAClD,2CAA2C;IAC3C,+CAA+C;IAC/C,wDAAwD;IACxD,uDAAuD;IACvD,+DAA+D;IAC/D,iEAAiE;IACjE,iEAAiE;IACjE,8DAA8D;IAC9D,sEAAsE;CACvE,CAAC,CAAC;AA8BH,MAAM,oBAAoB,GAAG,IAAI,2BAAiB,CAMhD;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,qBAAqB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAC1C,CAAC;QAEF,sBAAsB;QACtB,MAAM,WAAW,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,qBAAqB,CAAC,CAAC;QAEhE,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;;;;KAIzB,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,cAAc,GAAG,IAAA,wBAAc,EAC1C,IAAA,wBAAc,EAAC;IACb,IAAI,EAAE,wBAAwB;IAC9B,MAAM,EACJ,kFAAkF;IACpF,QAAQ,EAAE,CAAC,oBAAoB,EAAE,iCAAe,CAAC;CAClD,CAAC,CACH,CAAC;AAEW,QAAA,cAAc,GAAG,IAAA,iCAAe,EAAC;IAC5C,QAAQ,EAAE,SAAS;IACnB,KAAK,EAAE,eAAe;IACtB,QAAQ,EAAE,sBAAc;CACzB,CAAC,CAAC"}

package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.skill.d.ts

@@ -0,0 +1,28 @@
+export declare const SKILL_CATALOGIZE: 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/bhrain/brief.catalogize/stepCatalogize.skill.js

@@ -0,0 +1,118 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_CATALOGIZE = void 0;
+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 genStitchStreamToDisk_1 = require("../../../context/genStitchStreamToDisk");
+const stepCatalogize_1 = require("./stepCatalogize");
+exports.SKILL_CATALOGIZE = (0, rhachet_1.genRoleSkill)({
+    slug: 'catalogize',
+    route: stepCatalogize_1.loopCatalogize,
+    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 to use, if any; delimit with commas',
+                type: '?string',
+            },
+            briefs: {
+                source: 'process.argv',
+                char: 'b',
+                desc: 'brief files to 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: input.references
+                    ?.split(',')
+                    .filter((uri) => !!uri)
+                    .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 its the ask
+                return input.ask;
+            })();
+            await artifacts.goal.concept.set({ content: goalConcept });
+            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=stepCatalogize.skill.js.map

package/dist/logic/roles/bhrain/brief.catalogize/stepCatalogize.skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepCatalogize.skill.js","sourceRoot":"","sources":["../../../../../src/logic/roles/bhrain/brief.catalogize/stepCatalogize.skill.ts"],"names":[],"mappings":"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"}

package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.d.ts

@@ -0,0 +1,59 @@
+import { GStitcher, Threads, RoleContext } 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';
+export declare const BRIEFS_FOR_DEMONSTRATE: Artifact<typeof GitFile, string>[];
+type StitcherDesired = GStitcher<Threads<{
+    caller: RoleContext<'caller', {
+        art: {
+            feedback: Artifact<typeof GitFile>;
+            'foci.goal.concept': Focus['concept'];
+            'foci.goal.context': Focus['context'];
+            'foci.input.concept': Focus['concept'];
+            templates: Artifact<typeof GitFile>[];
+        };
+        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 stepDemonstrate: import("rhachet").Stitcher<StitcherDesired>;
+export declare const loopDemonstrate: import("rhachet").Stitcher<GStitcher<Threads<{
+    caller: RoleContext<"caller", {
+        art: {
+            feedback: Artifact<typeof GitFile>;
+            'foci.goal.concept': Focus['concept'];
+            'foci.goal.context': Focus['context'];
+            'foci.input.concept': Focus['concept'];
+            templates: Artifact<typeof GitFile>[];
+        };
+        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 {};