rhachet-roles-ehmpathy 1.15.12 → 1.15.14

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

@@ -1,124 +0,0 @@
-"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/bhrain/brief.catalogize/stepCatalogize.skill.js.map

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

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

@@ -1,59 +0,0 @@
-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 {};

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

@@ -1,103 +0,0 @@
-"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("../../../access/sdk/sdkOpenAi");
-const genLoopFeedback_1 = require("../../../domain.operations/artifact/genLoopFeedback");
-const genStepArtSet_1 = require("../../../domain.operations/artifact/genStepArtSet");
-const getBhrainBrief_1 = require("../../../roles/bhrain/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/roles/bhrain/brief.demonstrate/stepDemonstrate.js.map

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

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

@@ -1,30 +0,0 @@
-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("../../../access/sdk/sdkOpenAi").ContextOpenAI & import("as-procedure").ContextLogTrail & import("rhachet").ContextStitchTrail, {
-    feedback: import("rhachet-artifact-git").GitFile | null;
-}>>;

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

@@ -1,138 +0,0 @@
-"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/roles/bhrain/brief.demonstrate/stepDemonstrate.skill.js.map

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

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

@@ -1,135 +0,0 @@
-# 🗣️ 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"`