rhachet-roles-ehmpathy 1.1.0 → 1.2.0

package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.skill.js

@@ -0,0 +1,137 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_ARTICULATE = 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 stepArticulate_1 = require("./stepArticulate");
+exports.SKILL_ARTICULATE = (0, rhachet_1.genRoleSkill)({
+    slug: 'articulate',
+    route: stepArticulate_1.loopArticulate,
+    // route: loopsArticulateWithPonder, // todo: revive ponder when its actually helpful. today, ponder actually hurts
+    threads: {
+        lookup: {
+            target: {
+                source: 'process.argv',
+                char: 't',
+                desc: 'the target file or dir to write against',
+                type: 'string',
+            },
+            goal: {
+                source: 'process.argv',
+                char: 'g',
+                desc: 'the goal to use; if not specified, assumes ask is goal',
+                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',
+            },
+            templates: {
+                source: 'process.argv',
+                char: 'z', // todo: support undefined
+                desc: 'template files to to use, if any; delimit with commas',
+                type: '?string',
+            },
+        },
+        assess: (input) => typeof input.target === 'string',
+        instantiate: async (input) => {
+            const obsDir = (0, rhachet_artifact_git_1.getArtifactObsDir)({ uri: input.target });
+            const artifacts = {
+                goal: await (async () => {
+                    if (input.goal)
+                        return (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.goal }, { access: 'readonly' });
+                    const art = (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.goal.md' }, { versions: true });
+                    await art.set({ content: input.ask });
+                    return art;
+                })(),
+                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.target }, { versions: true }),
+                'foci.articulate.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.foci.articulate.context.md' }, { versions: true }),
+                'foci.articulate.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.foci.articulate.concept.md' }, { versions: true }),
+                'foci.ponder.que.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.foci.ponder.que.context.md' }, { versions: true }),
+                'foci.ponder.que.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.foci.ponder.que.concept.md' }, { versions: true }),
+                'foci.ponder.ans.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.foci.ponder.ans.context.md' }, { versions: true }),
+                'foci.ponder.ans.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.foci.ponder.ans.concept.md' }, { versions: true }),
+                'ponder.output': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: obsDir + '.ponder.output.md' }, { 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' })) ?? [],
+                templates: input.templates
+                    ?.split(',')
+                    .filter((uri) => !!uri)
+                    .map((template) => (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: template }, { access: 'readonly' })) ?? [],
+            };
+            return {
+                caller: await (0, rhachet_1.enrollThread)({
+                    role: 'caller',
+                    stash: {
+                        ask: input.ask,
+                        art: {
+                            'foci.goal.concept': artifacts.goal,
+                            'foci.goal.context': artifacts.goal,
+                            feedback: artifacts.feedback,
+                            templates: artifacts.templates,
+                        },
+                        refs: artifacts.references,
+                    },
+                }),
+                thinker: await (0, rhachet_1.enrollThread)({
+                    role: 'thinker',
+                    stash: {
+                        art: {
+                            'focus.context': artifacts['focus.context'],
+                            'focus.concept': artifacts['focus.concept'],
+                            'foci.articulate.context': artifacts['foci.articulate.context'],
+                            'foci.articulate.concept': artifacts['foci.articulate.concept'],
+                            'foci.ponder.ans.context': artifacts['foci.ponder.ans.context'],
+                            'foci.ponder.ans.concept': artifacts['foci.ponder.ans.concept'],
+                            'foci.ponder.que.context': artifacts['foci.ponder.que.context'],
+                            'foci.ponder.que.concept': artifacts['foci.ponder.que.concept'],
+                        },
+                        briefs: [
+                            ...artifacts.briefs,
+                            ...stepArticulate_1.BRIEFS_FOR_ARTICULATE, // flow the articulate briefs down so that <ponder> has them in context too; this approach does cause duplicate briefs for articulate, but thats no biggie
+                        ],
+                    },
+                }),
+            };
+        },
+    },
+    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, genContextStitchTrail_1.genContextStitchTrail)(),
+            };
+        },
+    },
+    readme: '',
+});
+//# sourceMappingURL=stepArticulate.skill.js.map

package/dist/logic/roles/bhrain/brief.articulate/stepArticulate.skill.js.map

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

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

@@ -0,0 +1,129 @@
+# 🗣️ 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}
+
+---
+
+### 🧠 @[ponder][output]
+> ponderage to help tune your focus
+
+\`\`\`json
+$.rhachet{ponderage}
+\`\`\`
+
+---
+
+### 🧘 @[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,55 @@
+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';
+export declare const BRIEFS_FOR_CATALOGIZE: 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'];
+        };
+        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, string>;
+            'foci.goal.concept': Artifact<typeof GitFile, string>;
+            'foci.goal.context': Artifact<typeof GitFile, string>;
+        };
+        refs: Artifact<typeof GitFile, string>[];
+    } & {
+        ask: string;
+        art: {
+            feedback: Artifact<typeof GitFile, string>;
+        };
+    }>;
+    thinker: RoleContext<"thinker", {
+        art: {
+            'focus.concept': Artifact<typeof GitFile, string>;
+            'focus.context': Artifact<typeof GitFile, string>;
+        };
+        briefs: Artifact<typeof GitFile, string>[];
+    } & {
+        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,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loopCatalogize = exports.stepCatalogize = exports.BRIEFS_FOR_CATALOGIZE = 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");
+exports.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 briefsBefore = threads.thinker.context.stash.briefs;
+        // append these briefs
+        const briefsAfter = [...briefsBefore, ...exports.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: stepInstantiate_1.stepInstantiate,
+});
+//# 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;AAEzD,QAAA,qBAAqB,GAAG,IAAA,gCAAe,EAAC;IACnD,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,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC;QAE1D,sBAAsB;QACtB,MAAM,WAAW,GAAG,CAAC,GAAG,YAAY,EAAE,GAAG,6BAAqB,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,iCAAe;CAC1B,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;
+}>>;