rhachet-roles-ehmpathy 1.1.0 → 1.3.0

package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.integration.test.js

@@ -0,0 +1,119 @@
+"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 stepDemonstrate_1 = require("./stepDemonstrate");
+jest.setTimeout((0, uni_time_1.toMilliseconds)({ minutes: 5 }));
+describe('stepDemonstrate', () => {
+    const context = {
+        ...(0, genContextLogTrail_1.genContextLogTrail)(),
+        ...(0, genContextStitchTrail_1.genContextStitchTrail)(),
+        ...(0, getContextOpenAI_1.getContextOpenAI)(),
+    };
+    const route = stepDemonstrate_1.stepDemonstrate;
+    const artifacts = {
+        caller: {
+            feedback: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepDemonstrate/caller.feedback.md' }, { versions: true }),
+            'foci.goal.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                uri: __dirname + '/.temp/stepDemonstrate/caller.foci.goal.concept.md',
+            }, { versions: true }),
+            'foci.goal.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                uri: __dirname + '/.temp/stepDemonstrate/caller.foci.goal.context.md',
+            }, { versions: true }),
+            'foci.input.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({
+                uri: __dirname + '/.temp/stepDemonstrate/caller.foci.input.concept.md',
+            }, { versions: true }),
+        },
+        thinker: {
+            'focus.concept': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepDemonstrate/thinker.focus.concept.md' }, { versions: true }),
+            'focus.context': (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: __dirname + '/.temp/stepDemonstrate/thinker.focus.context.md' }, { versions: true }),
+        },
+    };
+    (0, test_fns_1.given)('we want to demonstrate concept of joke structure', () => {
+        const inputConcept = `
+the structure of a joke
+      `.trim();
+        beforeEach(async () => {
+            await artifacts.caller.feedback.set({ content: '' });
+            await artifacts.thinker['focus.context'].set({
+                content: ['psychology', 'evolution', 'ecology'].join('\n'),
+            });
+            await artifacts.thinker['focus.concept'].set({
+                content: [].join('\n'),
+            });
+            await artifacts.caller['foci.goal.concept'].set({
+                content: 'learn how to make better jokes',
+            });
+        });
+        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'],
+                        'foci.input.concept': artifacts.caller['foci.input.concept'],
+                        feedback: artifacts.caller.feedback,
+                        templates: [],
+                    },
+                    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']),
+                },
+            }),
+        }));
+        (0, test_fns_1.when)('coherent foci.input.concept', () => {
+            beforeEach(async () => {
+                await artifacts.caller['foci.input.concept'].set({
+                    content: inputConcept,
+                });
+            });
+            const goalThreads = enthread();
+            (0, test_fns_1.then)('outputs answers', 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(/knock[- ]knock|chicken|atom/i);
+            });
+        });
+        test_fns_1.when.skip('empty foci.input.concept', () => {
+            beforeEach(async () => {
+                await artifacts.caller['foci.input.concept'].set({
+                    content: ' ',
+                });
+            });
+            const goalThreads = enthread();
+            (0, test_fns_1.then)('outputs BadRequestError', 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).toContain('BadRequestError');
+            });
+        });
+    });
+});
+//# sourceMappingURL=stepDemonstrate.integration.test.js.map

package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.integration.test.js.map

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

package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loopDemonstrate = exports.stepDemonstrate = exports.BRIEFS_FOR_DEMONSTRATE = void 0;
+const helpful_errors_1 = require("helpful-errors");
+const rhachet_1 = require("rhachet");
+const wrapper_fns_1 = require("wrapper-fns");
+const sdkOpenAi_1 = require("../../../../data/sdk/sdkOpenAi");
+const genLoopFeedback_1 = require("../../../artifact/genLoopFeedback");
+const genStepArtSet_1 = require("../../../artifact/genStepArtSet");
+const getBhrainBrief_1 = require("../getBhrainBrief");
+// exported so that we can pass them through to <ponder> too
+exports.BRIEFS_FOR_DEMONSTRATE = (0, getBhrainBrief_1.getBhrainBriefs)([
+    'trait.ocd.md',
+    'cognition/cog401.questions.._.md',
+    'cognition/cog000.overview.and.premise.md',
+    'cognition/cog101.concept.treestruct._.md',
+    'cognition/cog201.cortal.focus.p1.definition.md',
+    'cognition/cog301.traversal.1.motion.primitives._.md',
+    'cognition/cog401.questions.._.md',
+    'cognition/cog401.questions.2.1.primitives.rough._.md',
+    'cognition/cog201.cortal.focus.p2.breadth.md',
+    'cognition/cog301.traversal.1.motion.primitives.breadth.md',
+    'cognition/cog301.traversal.1.motion.primitives.breadth.vary.md',
+    'librarian.tactics/[brief].verbiage.outline.over.narrative.md',
+    // 'librarian.tactics/<demonstrate>._.[article].frame.tactical.md',
+    // 'librarian.tactics/<demonstrate>._.[article].frame.colloquial.md',
+    // 'librarian.tactics/<demonstrate>.tactics.[catalog].md',
+    'librarian.tactics/<demonstrate>._.[article].frame.colloquial.i2.by_grok.md',
+    'librarian.tactics/<demonstrate>.variants.[catalog].md',
+    // 'librarian.tactics/<demonstrate>.variants.contrast.[demo].usecase.vs_userjourney.by_chatgpt.md',
+    'librarian.tactics/<demonstrate>.variants.example.[demo].tea.darjeeling.by_grok.md',
+    'librarian.tactics/<demonstrate>.variants.counter.[demo].walkability.phoenix.by_chargpt.md',
+    'librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_chatgpt.i3.md',
+    'librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_grok.i2.md',
+    'librarian.tactics/<demonstrate>.variants.example.structure.[article].i2.md',
+    'librarian.tactics/<demonstrate>.variants.example.[lesson].howto.md',
+]);
+const template = (0, rhachet_1.genTemplate)({
+    ref: { uri: __filename.replace('.ts', '.template.md') },
+    getVariables: async ({ threads }) => ({
+        ...(await (0, rhachet_1.getTemplateVarsFromRoleInherit)({ thread: threads.thinker })),
+        guide: {
+            goal: (await threads.caller.context.stash.art['foci.goal.concept'].get())
+                ?.content ||
+                helpful_errors_1.UnexpectedCodePathError.throw('goal not declared', {
+                    art: threads.caller.context.stash.art['foci.goal.concept'],
+                }),
+            feedback: (await threads.caller.context.stash.art.feedback.get())?.content || '',
+        },
+        focus: {
+            context: (await threads.thinker.context.stash.art['focus.context'].get())
+                ?.content ||
+                (await threads.caller.context.stash.art['foci.goal.context'].get()) // fallback to @[caller].focus[goal].context
+                    ?.content ||
+                '',
+            concept: (await threads.thinker.context.stash.art['focus.concept'].get())
+                ?.content || '',
+        },
+        seed: {
+            concept: (await threads.caller.context.stash.art['foci.input.concept'].get())
+                ?.content ||
+                helpful_errors_1.UnexpectedCodePathError.throw('input not declared', {
+                    art: threads.caller.context.stash.art['foci.input.concept'],
+                }),
+        },
+        skill: {
+            briefs: await (0, rhachet_1.getTemplateValFromArtifacts)({
+                artifacts: [
+                    ...exports.BRIEFS_FOR_DEMONSTRATE,
+                    ...threads.thinker.context.stash.briefs,
+                ],
+            }),
+        },
+        references: await (0, rhachet_1.getTemplateValFromArtifacts)({
+            artifacts: threads.caller.context.stash.refs,
+        }),
+        templates: await (0, rhachet_1.getTemplateValFromArtifacts)({
+            artifacts: [...threads.caller.context.stash.art.templates],
+        }),
+    }),
+});
+const stepImagine = (0, rhachet_1.genStepImagineViaTemplate)({
+    slug: '@[thinker]<demonstrate>',
+    stitchee: 'thinker',
+    readme: '',
+    template,
+    imagine: (0, wrapper_fns_1.withRetry)((0, wrapper_fns_1.withTimeout)(sdkOpenAi_1.sdkOpenAi.imagine, { threshold: { seconds: 60 } })),
+});
+const stepPersist = (0, genStepArtSet_1.genStepArtSet)({
+    stitchee: 'thinker',
+    artee: 'focus.concept',
+});
+exports.stepDemonstrate = (0, rhachet_1.asStitcherFlat)((0, rhachet_1.genStitchRoute)({
+    slug: '@[thinker]<demonstrate>',
+    readme: '@[thinker]<demonstrate> -> [article]',
+    sequence: [stepImagine, stepPersist],
+}));
+exports.loopDemonstrate = (0, genLoopFeedback_1.genLoopFeedback)({
+    stitchee: 'thinker',
+    artee: 'focus.concept',
+    repeatee: exports.stepDemonstrate,
+});
+//# sourceMappingURL=stepDemonstrate.js.map

package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.js.map

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

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

@@ -0,0 +1,30 @@
+export declare const SKILL_DEMONSTRATE: 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>;
+            'foci.input.concept': import("rhachet-artifact").Artifact<typeof import("rhachet-artifact-git").GitFile, string>;
+            templates: 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.demonstrate/stepDemonstrate.skill.js

@@ -0,0 +1,138 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SKILL_DEMONSTRATE = 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 stepDemonstrate_1 = require("./stepDemonstrate");
+exports.SKILL_DEMONSTRATE = (0, rhachet_1.genRoleSkill)({
+    slug: 'demonstrate',
+    route: stepDemonstrate_1.loopDemonstrate,
+    threads: {
+        lookup: {
+            output: {
+                source: 'process.argv',
+                char: 'o',
+                desc: 'the output file to write against',
+                type: 'string',
+            },
+            input: {
+                source: 'process.argv',
+                char: 'i',
+                desc: 'the input file to seed from',
+                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',
+            },
+            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) => {
+            // 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 }),
+                input: (0, rhachet_artifact_git_1.genArtifactGitFile)({ uri: input.input }, { 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' })) ?? [],
+            };
+            // 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,
+                            'foci.input.concept': artifacts.input,
+                            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,
+                            ...stepDemonstrate_1.BRIEFS_FOR_DEMONSTRATE, // flow the demonstrate briefs down so that <ponder> has them in context too; this approach does cause duplicate briefs for demonstrate, 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=stepDemonstrate.skill.js.map

package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.skill.js.map

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

package/dist/logic/roles/bhrain/brief.demonstrate/stepDemonstrate.template.md

@@ -0,0 +1,135 @@
+# 🗣️ prompt: `<demonstrate>` — generate a .brief demo for a given [concept]
+
+you are a **skilled explainer** performing the **focus.motion** primitive `<demonstrate>`.
+
+---
+
+## 📜 contract
+for `<demonstrate>` to work as intended:
+
+**input = [concept][brief][article] || [concept][ref] = seed.concept**
+- a **[concept][brief][article]** is a **full article**: a complete, structured write-up containing all necessary details.
+- a **[concept][ref]** is just a **reference**: a short label or title pointing to a concept.
+- input **cannot** be empty. if `seed.concept` is empty, return:
+  `"BadRequestError: no seed.concept"`
+- input must define a **single, coherent concept** — not a bundle of unrelated topics. if not coherent, return:
+  `"BadRequestError: incoherent seed.concept"`
+
+**output = [concept][brief][demo] = focus.concept**
+- a high-signal markdown `.brief` that **demonstrates** the concept in clear, observable form
+- may be **empty** (start from scratch)
+- may be a **seed** (partial demo to expand)
+- may be **inflight** (actively being refined)
+- must include **examples, evidence, or procedures** that make the concept tangible
+- should be **convincing** enough to prove or validate the concept to the audience
+- all sections must maximize **clarity and impact**, avoiding filler
+
+**why this contract exists:**
+- demonstration transforms **abstract ideas** into **visible, provable outcomes**
+- structured `.brief` demos ensure clarity, reproducibility, and comparability
+- constraints prevent drift toward generic explanation instead of concrete showing
+
+---
+
+## ⚙️ method
+1. **anchor to the seed**
+   - identify the concept or reference to demonstrate
+   - clarify the objective (what the demo must prove, show, or validate)
+
+2. **structure**
+   - select one or more demonstration modes (hands-on, visual, case study, simulation, walkthrough, etc.)
+   - match format to audience, context, and purpose
+
+3. **execute**
+   - lay out steps, examples, or evidence
+   - show rather than tell; prioritize observable details
+
+4. **validate**
+   - highlight results, outcomes, or feedback that confirm the concept
+   - integrate audience interaction or checkpoints for understanding
+
+5. **refine**
+   - review for clarity, engagement, and persuasiveness
+   - adapt based on context or feedback
+
+---
+
+## 📐 output format
+- return **only** the `.md` brief — no extra commentary
+- always start with:
+  `# 🧩 .brief.demo: \`[concept]\``
+- use `##` headers or `---` separators
+- prose must be lowercase except proper nouns
+- include **examples, walkthroughs, or steps** in lists or concise blocks
+- avoid abstract filler; prioritize **proof and tangibility**
+
+---
+
+## 📚 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 `<demonstrate>`:
+
+---
+
+## 📎 references
+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 demo being generated by `<demonstrate>`
+
+\`\`\`md
+$.rhachet{focus.concept}
+\`\`\`
+
+---
+
+### 🎯 @[guide.goal]
+\`\`\`md
+$.rhachet{guide.goal}
+\`\`\`
+
+---
+
+### 💬 @[guide.feedback]
+\`\`\`md
+$.rhachet{guide.feedback}
+\`\`\`
+
+---
+
+### 🌱 [seed.concept]
+\`\`\`md
+$.rhachet{seed.concept}
+\`\`\`
+
+remember:
+- seed.concept **cannot** be empty. if `seed.concept` is empty, return:
+  `"BadRequestError: no seed.concept"`
+- seed.concept must define a **single, coherent concept** — not a bundle of unrelated topics. if not coherent, return:
+  `"BadRequestError: incoherent seed.concept"`

package/dist/logic/roles/bhrain/getBhrainBrief.Options.codegen.d.ts

@@ -5,6 +5,6 @@
  *  npx tsx src/contract/commands/codegenBriefOptions.ts
  * ```
  */
-declare const options: readonly ["distilisys.grammar.compressed.md", "terms.motive.intent.goal.md", "trait.ocd.md"];
+declare const options: readonly ["distilisys.grammar.compressed.md", "terms.motive.intent.goal.md", "trait.ocd.md", "cognition/cog000.overview.and.premise.md", "cognition/cog021.coordinates.spherical.md", "cognition/cog021.metaphor.cauliflorous.md", "cognition/cog021.structs.catalog.md", "cognition/cog021.structs.treestruct.md", "cognition/cog021.structs.vector.md", "cognition/cog101.concept.definition.md", "cognition/cog101.concept.treestruct._.md", "cognition/cog101.concept.treestruct.coords.1.spherical.md", "cognition/cog101.concept.treestruct.coords.2.abstractive.md", "cognition/cog101.concept.treestruct.coords.3.descriptive.md", "cognition/cog101.concept.treestruct.persp.1.perspectives.md", "cognition/cog101.concept.treestruct.persp.2.universal.md", "cognition/cog101.concept.treestruct.persp.3.relative.md", "cognition/cog101.concept.treestruct.persp.4.fractal.md", "cognition/cog151.concept.treestruct.gravity.md", "cognition/cog201.cortal.focus.p1.definition.md", "cognition/cog201.cortal.focus.p1.examples.cont.md", "cognition/cog201.cortal.focus.p2.acuity.md", "cognition/cog201.cortal.focus.p2.breadth.md", "cognition/cog201.cortal.focus.p2.depth.md", "cognition/cog251.cortal.focus.p3.fabric.md", "cognition/cog251.cortal.focus.p3.mode.md", "cognition/cog251.cortal.focus.p3.rythm.md", "cognition/cog251.cortal.focus.p3.usecases.md", "cognition/cog301.traversal.1.motion.primitives._.md", "cognition/cog301.traversal.1.motion.primitives.acuity.md", "cognition/cog301.traversal.1.motion.primitives.breadth.md", "cognition/cog301.traversal.1.motion.primitives.breadth.vary.md", "cognition/cog301.traversal.1.motion.primitives.depth.md", "cognition/cog301.traversal.2.motion.composites._.md", "cognition/cog301.traversal.2.motion.composites.grammar.md", "cognition/cog401.questions.._.md", "cognition/cog401.questions.1.persp.as.berries.md", "cognition/cog401.questions.1.persp.as.vectors.md", "cognition/cog401.questions.1.persp.has.precision.tunable.md", "cognition/cog401.questions.2.1.primitives.rough._.md", "cognition/cog401.questions.2.1.primitives.rough.interrogative.md", "cognition/cog401.questions.2.1.primitives.rough.why.[article].md", "cognition/cog401.questions.2.2.composite.smooth._.md", "cognition/cog401.questions.2.2.composite.smooth.examples.md", "cognition/cog501.cortal.assemblylang.1.primitives._.md", "cognition/cog501.cortal.assemblylang.1.primitives.recall.md", "cognition/cog501.cortal.assemblylang.1.primitives.steer.md", "cognition/cog501.cortal.assemblylang.1.primitives.think.md", "cognition/cog501.cortal.assemblylang.2.composites.zoom.md", "cognition/cog501.cortal.assemblylang.3.catalogs.md", "cognition/cog501.cortal.assemblylang.3.grammar.md", "cognition/cog501.cortal.assemblylang_.md", "librarian.context/article.variant.vision.[article].md", "librarian.context/term.expectation.vs_assumption._.md", "librarian.context/term.frame.vs_perspective.[article].md", "librarian.context/term.invariant.[article].md", "librarian.context/term.lesson._vs_article.[article].md", "librarian.context/term.ref._vs_brief.md", "librarian.context/term.referent.[article].md", "librarian.context/usage.lesson_vs_article.[lesson].md", "librarian.context/usage.lesson_vs_article_vs_demo.[lesson].md", "physics/optics.focal.acuity.md", "physics/optics.focal.breadth.md", "physics/optics.focal.depth.md", "physics/optics.focal.distance.md", "physics/optics.focal.tradeoffs.md", "librarian.tactics/<articulate>.TriageCatalog.[gallery][example].structure.md", "librarian.tactics/<articulate>._.[article].frame.cognitive.md", "librarian.tactics/<articulate>._.[article].frame.tactical.md", "librarian.tactics/<articulate>.tactic.[catalog].md", "librarian.tactics/<articulate>.tactic.concept_dimension.examples.[article][seed].md", "librarian.tactics/<articulate>.tactic.concept_dimension.invariants.[article].md", "librarian.tactics/<articulate>.tactic.from.examples.md", "librarian.tactics/<articulate>.tactic.from.seed.md", "librarian.tactics/<articulate>.tactic.with.templates.[article].md", "librarian.tactics/<articulate>.tactic.with.templates.[gallery][review].effective.md", "librarian.tactics/<articulate>.tone.bluecollar.[article][seed].md", "librarian.tactics/<catalogize>._.[article][seed].md", "librarian.tactics/<catalogize>.observation.via_clusterage_over_via_imagination.[seed].md", "librarian.tactics/<catalogize>.vs_diverge.[article].persp.save_compute.md", "librarian.tactics/<demonstrate>._.[article].frame.colloquial.i2.by_grok.md", "librarian.tactics/<demonstrate>.variants.[catalog].md", "librarian.tactics/<demonstrate>.variants.contrast.[demo].usecase.vs_userjourney.by_chatgpt.md", "librarian.tactics/<demonstrate>.variants.counter.[demo].usecase.flyer.by_chargpt.md", "librarian.tactics/<demonstrate>.variants.counter.[demo].walkability.phoenix.by_chargpt.md", "librarian.tactics/<demonstrate>.variants.example.[demo].shear_force.scissors.by_grok.md", "librarian.tactics/<demonstrate>.variants.example.[demo].tea.darjeeling.by_grok.md", "librarian.tactics/<demonstrate>.variants.example.[demo].usecase.book_flight.by_grok.md", "librarian.tactics/<demonstrate>.variants.example.[demo].usecase.order_food.by_chatgpt.md", "librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_chatgpt.i3.md", "librarian.tactics/<demonstrate>.variants.example.[demo].walkability.portland.by_grok.i2.md", "librarian.tactics/<demonstrate>.variants.example.[lesson].howto.md", "librarian.tactics/<demonstrate>.variants.example.structure.[article].i2.md", "librarian.tactics/<demonstrate>.variants.narrative.[demo].usecase.order_online.by_chatgpt.md", "librarian.tactics/<demonstrate>.variants.walkthrough.[demo].usecase.book_online.by_chatgpt.md", "librarian.tactics/[brief].verbiage.outline.over.narrative.md", "knowledge/kno101.primitives.1.ontology.[article].frame.docs_as_materializations.md", "knowledge/kno101.primitives.1.ontology.[article].frame.docs_as_references.md", "knowledge/kno101.primitives.2.rel.many_to_many.[article].md", "knowledge/kno101.primitives.3.instances.[article].md", "knowledge/kno101.primitives.4.documents.[article].md", "knowledge/kno101.primitives.5.concepts.[article].md", "knowledge/kno201.documents._.[article].md", "knowledge/kno201.documents._.[catalog].md", "knowledge/kno201.documents.articles.[article].md", "knowledge/kno201.documents.catalogs.[article].md", "knowledge/kno201.documents.demos.[article].md", "knowledge/kno201.documents.lessons.[article].md", "knowledge/kno301.doc.compression.1.refs._.[article].md", "knowledge/kno301.doc.compression.2.briefs._.[article].md", "knowledge/kno301.doc.compression._.[article].md", "knowledge/kno301.doc.enbrief.1.from_instances.[article].md", "knowledge/kno301.doc.enbrief.1.from_instances.[demo].algorithm.md", "knowledge/kno301.doc.enbrief.1.from_instances.[demo].color.md", "knowledge/kno301.doc.enbrief.1.from_instances.[demo].empathy.md", "knowledge/kno301.doc.enbrief.1.from_instances.[demo].entropy.md", "knowledge/kno301.doc.enbrief.1.from_instances.[demo].gravity.md", "knowledge/kno301.doc.enbrief.1.from_instances.[demo].joke.md", "knowledge/kno301.doc.enbrief.1.from_instances.[demo].value.md", "knowledge/kno301.doc.enbrief.2._.[catalog].md", "knowledge/kno301.doc.enbrief.2.articulate.[article].md", "knowledge/kno301.doc.enbrief.2.articulate.[lesson].md", "knowledge/kno301.doc.enbrief.2.catalogize.[article].md", "knowledge/kno301.doc.enbrief.2.catalogize.[lesson].md", "knowledge/kno301.doc.enbrief.2.demonstrate.[article].md", "knowledge/kno301.doc.enbrief.2.demonstrate.[lesson].md", "knowledge/kno301.doc.enbrief.2.lessonize.[article].md", "knowledge/kno301.doc.enbrief.2.lessonize.[lesson].md", "knowledge/kno351.docs.are_instances.[article].md", "knowledge/kno351.docs.recursion.[catalog].md", "knowledge/kno401.actors.1.role.author.[article].md", "knowledge/kno401.actors.1.role.librarian.[article].md", "knowledge/kno401.actors.2.interdependence.[article].md", "knowledge/kno501.doc.enbrief.catalog.structure1.[article].md", "knowledge/kno501.doc.enbrief.catalog.structure1.[lesson].template.md", "thinker.tactics/<cluster>._.[article].frame.tactical._.md", "thinker.tactics/<cluster>.vs_<diverge>.duality.[article].md", "thinker.tactics/<diverge>._.[article].frame.cognitive.[seed].md", "thinker.tactics/<diverge>._.[article].frame.tactical.md", "thinker.tactics/<elaborate>_vs_<elucidate>.[seed].md", "thinker.tactics/<enquestion>._.[article].md", "thinker.tactics/<enquestion>._.[gallery].plumber.diagnose.md", "thinker.tactics/<enquestion>._.[gallery].thinker.enquestion.md", "thinker.tactics/<enquestion>.tactic.perspectives.[article].md", "thinker.tactics/<triage>._.[article].frame.tactical.md", "thinker.tactics/<triage>.persp.grades_from_context.[article].md", "thinker.tactics/<triage>.persp.implicit_question.[article].md", "worders/core.matmuls_vecmuls_elemuls.md", "worders/core.transformers.as_origin.md", "worders/core.transformers.self_attention.[article].md", "worders/core.transformers.self_attention.[demo].ambig.bank.md", "worders/core.transformers.self_attention.[demo].cat_sat.md", "worders/force.repeat_input_structures.md", "worders/knowledge.interdependence.[article].md", "worders/knowledge.interdependence.[demo].domain.physics.md", "worders/knowledge.internal_vs_external.[article].artist_vs_librarian.md", "worders/knowledge.internal_vs_external.[demo].artist_vs_librarian.md", "worders/knowledge.internal_vs_external.[demo].domain.physics.md", "worders/knowledge.internalized.[article].md", "worders/knowledge.internalized.[demo].artist.md", "worders/knowledge.internalized.[demo].neural.md", "worders/knowledge.internalized.[demo].pianist.md", "worders/limits.rhyme.md", "worders/limits.spell.md", "worders/teach.via.library.examples.md", "worders/teach.via.library.explanations_vs_examples.md", "worders/trend.prefer_reuse.[seed].md", "cognition/inflight/concept.vs.idea.md", "cognition/inflight/core.concept.adjectives.md"];
 export type BriefOptionBhrain = typeof options[number];
 export {};