rhachet-roles-bhrain 0.1.0

package/dist/roles/thinker/skills/brief.articulate/stepArticulate.skill.js

@@ -0,0 +1,125 @@
+"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 getContextOpenAI_1 = require("../../../../.test/getContextOpenAI");
+const setSkillOutputSrc_1 = require("../../../../domain.operations/artifact/setSkillOutputSrc");
+const genStitchStreamToDisk_1 = require("../../../../domain.operations/context/genStitchStreamToDisk");
+const stepArticulate_1 = require("./stepArticulate");
+exports.SKILL_ARTICULATE = (0, rhachet_1.genRoleSkill)({
+    slug: 'articulate',
+    route: stepArticulate_1.loopArticulate,
+    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 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.output === 'string',
+        instantiate: async (input) => {
+            const obsDir = (0, rhachet_artifact_git_1.getArtifactObsDir)({ uri: input.output });
+            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.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' })) ?? [],
+                templates: input.templates
+                    ?.split(',')
+                    .filter((uri) => !!uri)
+                    .map((template) => (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: template }, { access: 'readonly' })) ?? [],
+            };
+            // add an src file for historic record
+            await (0, setSkillOutputSrc_1.setSkillOutputSrc)({ skillUri: 'bhrain.articulate', opts: input }); // todo: get skillUri from context
+            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'],
+                        },
+                        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=stepArticulate.skill.js.map

package/dist/roles/thinker/skills/brief.articulate/stepArticulate.skill.js.map

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

package/dist/roles/thinker/skills/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/roles/thinker/skills/brief.catalogize/stepCatalogize.d.ts

@@ -0,0 +1,54 @@
+import { type GStitcher, type RoleContext, type Threads } from 'rhachet';
+import type { Artifact } from 'rhachet-artifact';
+import type { GitFile } from 'rhachet-artifact-git';
+import type { Focus } from '../../../../_topublish/rhachet-roles-bhrain/src/domain/objects/Focus';
+import type { ContextOpenAI } from '../../../../access/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("as-procedure").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: GitFile | null;
+}>>;
+export {};

package/dist/roles/thinker/skills/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("../../../../domain.operations/artifact/genLoopFeedback");
+const getThinkerBrief_1 = require("../../../../roles/thinker/getThinkerBrief");
+const stepInstantiate_1 = require("../../../../roles/thinker/skills/khue.instantiate/stepInstantiate");
+const BRIEFS_FOR_CATALOGIZE = (0, getThinkerBrief_1.getThinkerBriefs)([
+    '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/roles/thinker/skills/brief.catalogize/stepCatalogize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepCatalogize.js","sourceRoot":"","sources":["../../../../../src/roles/thinker/skills/brief.catalogize/stepCatalogize.ts"],"names":[],"mappings":";;;AAAA,qCAOiB;AAMjB,qFAAkF;AAClF,wEAAsE;AACtE,gGAA6F;AAE7F,MAAM,qBAAqB,GAAG,IAAA,kCAAgB,EAAC;IAC7C,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/roles/thinker/skills/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("../../../../access/sdk/sdkOpenAi").ContextOpenAI & import("as-procedure").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: import("rhachet-artifact-git").GitFile | null;
+}>>;

package/dist/roles/thinker/skills/brief.catalogize/stepCatalogize.skill.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_CATALOGIZE = 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("../../../../domain.operations/artifact/setSkillOutputSrc");
+const genStitchStreamToDisk_1 = require("../../../../domain.operations/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: (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 its 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.catalogize', 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=stepCatalogize.skill.js.map

package/dist/roles/thinker/skills/brief.catalogize/stepCatalogize.skill.js.map

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

package/dist/roles/thinker/skills/brief.demonstrate/stepDemonstrate.d.ts

@@ -0,0 +1,59 @@
+import { type GStitcher, type RoleContext, type Threads } from 'rhachet';
+import type { Artifact } from 'rhachet-artifact';
+import type { GitFile } from 'rhachet-artifact-git';
+import type { Focus } from '../../../../_topublish/rhachet-roles-bhrain/src/domain/objects/Focus';
+import { type ContextOpenAI } from '../../../../access/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("as-procedure").ContextLogTrail & import("rhachet").ContextStitchTrail, {
+    feedback: GitFile | null;
+}>>;
+export {};