rhachet-roles-bhrain 0.2.0 → 0.3.0

package/dist/roles/thinker/skills/khue.instantiate/stepInstantiate.ts

@@ -0,0 +1,132 @@
+import { UnexpectedCodePathError } from 'helpful-errors';
+import {
+  asStitcherFlat,
+  type GStitcher,
+  genStepImagineViaTemplate,
+  genStitchRoute,
+  genTemplate,
+  getTemplatePathByCallerPath,
+  getTemplateValFromArtifacts,
+  getTemplateVarsFromRoleInherit,
+  type RoleContext,
+  type Threads,
+} from 'rhachet';
+import type { Artifact } from 'rhachet-artifact';
+import type { GitFile } from 'rhachet-artifact-git';
+import { withRetry, withTimeout } from 'wrapper-fns';
+
+import type { Focus } from '@src/_topublish/rhachet-roles-bhrain/src/domain/objects/Focus';
+import { type ContextOpenAI, sdkOpenAi } from '@src/access/sdk/sdkOpenAi';
+import { genLoopFeedback } from '@src/domain.operations/artifact/genLoopFeedback';
+import { genStepArtSet } from '@src/domain.operations/artifact/genStepArtSet';
+import { getThinkerBriefs } from '@src/roles/thinker/getThinkerBrief';
+
+export const BRIEFS_FOR_INSTANTIATE = getThinkerBriefs([
+  '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/kno301.doc.enbrief.1.from_instances.[article].md',
+  'knowledge/kno351.docs.are_instances.[article].md',
+]);
+
+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 }
+>;
+
+const template = genTemplate<StitcherDesired['threads']>({
+  ref: { uri: getTemplatePathByCallerPath({ auto: true }) },
+  getVariables: async ({ threads }) => ({
+    ...(await getTemplateVarsFromRoleInherit({ thread: threads.thinker })),
+
+    guide: {
+      goal:
+        (await threads.caller.context.stash.art['foci.goal.concept'].get())
+          ?.content ||
+        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 || '',
+      concept:
+        (await threads.thinker.context.stash.art['focus.concept'].get())
+          ?.content || '',
+    },
+
+    skill: {
+      briefs: await getTemplateValFromArtifacts({
+        artifacts: (() => {
+          const briefs = [
+            ...BRIEFS_FOR_INSTANTIATE,
+            ...threads.thinker.context.stash.briefs,
+          ];
+          // console.log(briefs.map((brief) => brief.ref)); // ?: left here to aid in debug, when needed
+          return briefs;
+        })(),
+      }),
+    },
+
+    references: await getTemplateValFromArtifacts({
+      artifacts: threads.caller.context.stash.refs,
+    }),
+  }),
+});
+
+const stepImagine = genStepImagineViaTemplate<StitcherDesired>({
+  slug: '@[thinker]<instantiate>',
+  stitchee: 'thinker',
+  readme: '',
+  template,
+  imagine: withRetry(
+    withTimeout(sdkOpenAi.imagine, { threshold: { seconds: 60 } }), // allow up to 60 sec, for longer files
+  ),
+});
+
+const stepPersist = genStepArtSet({
+  stitchee: 'thinker',
+  artee: 'focus.concept',
+});
+
+export const stepInstantiate = asStitcherFlat<StitcherDesired>(
+  genStitchRoute({
+    slug: '@[thinker]<instantiate>',
+    readme: '@[thinker]<instantiate> -> [instance]',
+    sequence: [stepImagine, stepPersist],
+  }),
+);
+
+export const loopInstantiate = genLoopFeedback({
+  stitchee: 'thinker',
+  artee: 'focus.concept',
+  repeatee: stepInstantiate,
+});

package/dist/roles/thinker/skills/khue.triage/.demo/laughs.v2025_08_18.i1.md

@@ -0,0 +1,29 @@
+{
+  "most_laughs": [
+    { "item": "Why don't scientists trust atoms? Because they make up everything!", "rationale": "This joke is likely to elicit the most laughs due to its clever play on words and the surprising insight into the nature of atoms." },
+    { "item": "What do you call cheese that isn't yours? Nacho cheese!", "rationale": "This joke has broad appeal and is a classic example of wordplay, likely generating consistent laughter." },
+    { "item": "Why don’t skeletons fight each other? They don’t have the guts.", "rationale": "This joke plays on both literal and metaphorical meanings of having 'guts,' making it an effective and humorous pun." }
+  ],
+  "moderate_laughs": [
+    { "item": "Why did the chicken cross the road? To get to the other side!", "rationale": "As a classic and familiar setup, it may generate moderate laughs due to its simplicity and nostalgic appeal." },
+    { "item": "Why was the math book sad? Because it had too many problems.", "rationale": "This joke ties into a common school subject and its inherent challenges, which makes it relatable and mildly amusing." },
+    { "item": "Why did the scarecrow win an award? Because he was outstanding in his field!", "rationale": "This joke is clever due to its play on the word 'outstanding,' offering a good example of wordplay." },
+    { "item": "Why couldn’t the bicycle stand up by itself? It was two tired.", "rationale": "This relies on a pun involving the homophones 'too' and 'two,' delivering moderate humor." },
+    { "item": "What do you call fake spaghetti? An impasta!", "rationale": "A pun that combines a common food with a clever play on the word 'imposter,' likely to evoke moderate laughter." },
+    { "item": "What did one wall say to the other wall? I'll meet you at the corner!", "rationale": "A simple and predictable punchline that provides a chuckle through personifying walls." }
+  ],
+  "fewest_laughs": [
+    { "item": "How do you organize a space party? You planet!", "rationale": "This joke may elicit fewer laughs due to its predictability, although the pun on 'planet' is moderately clever." },
+    { "item": "What did the janitor say when he jumped out of the closet? Supplies!", "rationale": "While surprising, it may generate limited laughter unless aligned with specific situational contexts." },
+    { "item": "Why did the picture go to jail? Because it was framed!", "rationale": "This joke offers a straightforward pun, but the humor might not resonate as profoundly." },
+    { "item": "Why can’t your nose be 12 inches long? Because then it would be a foot!", "rationale": "This joke leverages a play on measurement units but might not be inherently hilarious." },
+    { "item": "What do you call a boomerang that won’t come back? A stick.", "rationale": "A simple observation, this joke often receives chuckles more than outright laughter." },
+    { "item": "What do you call a fish with no eye? Fsh!", "rationale": "A minimalist joke that relies on spelling humor, setting it apart with minimalistic appeal." },
+    { "item": "What do you call a bear with no teeth? A gummy bear!", "rationale": "A straightforward pun, its humor might be niche or context-reliant." },
+    { "item": "What do you get when you cross a snowman with a vampire? Frostbite.", "rationale": "While creative, the humor might not strike everyone." },
+    { "item": "How does a penguin build its house? Igloos it together!", "rationale": "The joke relies on a basic pun combining 'igloos' and 'glues,' delivering straightforward humor." },
+    { "item": "Why did the golfer bring two pairs of pants? In case he got a hole in one!", "rationale": "This joke delivers a golfing pun but might not resonate with those unfamiliar with golfing terms." },
+    { "item": "What do you get if you put a radio in the fridge? Cool music.", "rationale": "This joke involves a play on words relating to temperature but may not yield substantial laughter." },
+    { "item": "Why did the tomato turn red? Because it saw the salad dressing!", "rationale": "A play on words using 'dressing,' it may elicit small laughs based on its predictable punchline." }
+  ]
+}

package/dist/roles/thinker/skills/khue.triage/.demo/user.journeys.v2025_08_17.i1.md

@@ -0,0 +1,86 @@
+{
+  "high_priority": [
+    {
+      "item": "A road tripper planning a route with a digital map for scenic stops.",
+      "rationale": "This reflects a proactive, planning-focused user journey, critical for ensuring a positive travel experience and suitable for demonstrating effective digital mapping interfaces."
+    },
+    {
+      "item": "A parent navigating a grocery store app to build their weekly shopping list.",
+      "rationale": "Demonstrates a time-sensitive and frequently repeated task, highlighting user interaction with essential everyday applications."
+    },
+    {
+      "item": "A small business owner managing orders and inventory via an online platform.",
+      "rationale": "Involves complex user interactions with high impact on business operations and is crucial for illustrating commercial application use cases."
+    }
+  ],
+  "medium_priority": [
+    {
+      "item": "A fitness enthusiast booking classes and tracking goals in a workout app.",
+      "rationale": "Emphasizes goal-setting and tracking over time, providing a clear depiction of personalized user experiences."
+    },
+    {
+      "item": "A cafe regular pre-ordering their daily coffee through a mobile app.",
+      "rationale": "Represents habitual, low-effort usage scenarios, suitable for showing user retention strategies."
+    },
+    {
+      "item": "A student using an online learning platform to complete daily algebra exercises.",
+      "rationale": "Illustrates educational technology use, particularly in structured learning environments."
+    },
+    {
+      "item": "A traveler using a language app daily to build vocabulary before a trip.",
+      "rationale": "Focuses on consistent, long-term user engagement, showcasing how apps support progression and readiness for specific goals."
+    },
+    {
+      "item": "A yoga practitioner following an online video series for daily sessions.",
+      "rationale": "Highlights user commitment to maintaining fitness habits through digital resources, reflective of user journey consistency."
+    }
+  ],
+  "low_priority": [
+    {
+      "item": "A new pet owner researching breed-specific care tips on a vet's website.",
+      "rationale": "Represents an informative, sporadic interaction, more reflective of ad-hoc information-seeking than continuous engagement."
+    },
+    {
+      "item": "A book lover cataloging and reviewing recent reads in a book community app.",
+      "rationale": "Emphasizes community interaction and content contribution, which are secondary compared to more active use journeys."
+    },
+    {
+      "item": "An environmentalist tracking local wildlife sightings with a citizen science app.",
+      "rationale": "Reflects a niche interest and periodic use, providing specific but less universally relatable user journeys."
+    },
+    {
+      "item": "A commuter reading news headlines on their phone while on the train.",
+      "rationale": "Represents passive content consumption, providing weaker demonstrations of interactive user journeys."
+    },
+    {
+      "item": "A babysitter logging hours and generating invoices via a babysitting service app.",
+      "rationale": "Focuses on transactional operations rather than highlighting broader user journey dynamics."
+    },
+    {
+      "item": "A gardener logging plant growth in a digital garden journal app.",
+      "rationale": "Involves self-monitoring and hobbyist engagement, suitable for niche content rather than core interactions."
+    }
+  ],
+  "special_interest": [
+    {
+      "item": "An influencer planning photo shoots and posting schedules with a content calendar app.",
+      "rationale": "Demonstrates unique needs around content scheduling and social media engagement, useful for highlighting specialized user journeys."
+    },
+    {
+      "item": "An event organizer sending out e-invites and tracking RSVPs through an event app.",
+      "rationale": "Provides insights into event management-related user journeys, substantial in scope but typically less frequent."
+    },
+    {
+      "item": "A high school student organizing study schedules and assignment deadlines in a planner app.",
+      "rationale": "Good for illustrating goal management and organizational skills within educational contexts, particularly for younger users."
+    },
+    {
+      "item": "A DIY enthusiast following step-by-step guides on a home improvement site.",
+      "rationale": "Applicable for showcasing self-guided learning and resourcefulness, fitting for outcome-oriented journeys but peripheral in daily routines."
+    },
+    {
+      "item": "A home cook using a meal kit service website to pick new recipes.",
+      "rationale": "Emphasizes decision-making and culinary exploration, albeit within limited, hobby-driven scope."
+    }
+  ]
+}

package/dist/roles/thinker/skills/khue.triage/.demo/user.journeys.v2025_08_17.i2.md

@@ -0,0 +1,68 @@
+{
+  "top_examples": [
+    {
+      "item": "A customer's morning routine as they use their smartwatch to track steps.",
+      "rationale": "This example represents a daily habit observable in many users, demonstrating a routine interaction with technology for health tracking, which is a common use case in user journeys."
+    },
+    {
+      "item": "A parent navigating a grocery store app to build their weekly shopping list.",
+      "rationale": "This example illustrates a practical application of technology in managing household tasks, which resonates with a wide audience and exemplifies the integration of digital tools in everyday life."
+    },
+    {
+      "item": "A student using an online learning platform to complete daily algebra exercises.",
+      "rationale": "Represents the educational sector's shift towards online platforms, highlighting a user journey centered around learning and skill development, key for demonstrating educational technology use cases."
+    },
+    {
+      "item": "A traveler using a language app daily to build vocabulary before a trip.",
+      "rationale": "Captures the intentional use of technology for personal growth and preparation, common in user journeys involving self-improvement or learning, especially in travel contexts."
+    },
+    {
+      "item": "A fitness enthusiast booking classes and tracking goals in a workout app.",
+      "rationale": "This scenario reflects the fitness industry's use of digital solutions to enhance user engagement and motivation, making it a strong example of goal-oriented user journeys."
+    }
+  ],
+  "secondary_examples": [
+    {
+      "item": "A road tripper planning a route with a digital map for scenic stops.",
+      "rationale": "Highlights the use of digital maps for travel planning, a specialized user journey relevant to context-specific applications, offering modest demonstration value."
+    },
+    {
+      "item": "A new pet owner researching breed-specific care tips on a vet's website.",
+      "rationale": "Demonstrates an informative user journey for pet care, showing how digital resources aid in decision-making and learning specific to pet ownership."
+    },
+    {
+      "item": "A cafe regular pre-ordering their daily coffee through a mobile app.",
+      "rationale": "Illustrates routine-based interaction catering to convenience, common in food service applications, offering limited variability."
+    },
+    {
+      "item": "A gardener logging plant growth in a digital garden journal app.",
+      "rationale": "Represents niche user journeys in self-directed projects using digital tracking tools, but may have less general appeal."
+    },
+    {
+      "item": "A music lover exploring new playlists and artists on a streaming service.",
+      "rationale": "Shows a leisure-focused interaction with music technology, reflecting exploratory behavior typical in entertainment-driven journeys."
+    }
+  ],
+  "low_priority_examples": [
+    {
+      "item": "A home cook using a meal kit service website to pick new recipes.",
+      "rationale": "While it represents practical use of digital solutions, its appeal and impact are limited compared to more broadly relevant examples."
+    },
+    {
+      "item": "An influencer planning photo shoots and posting schedules with a content calendar app.",
+      "rationale": "This use case is industry-specific and less relatable to the general user demographic, reducing its appeal for broad demonstration."
+    },
+    {
+      "item": "An event organizer sending out e-invites and tracking RSVPs through an event app.",
+      "rationale": "Though relevant, it caters to specific roles rather than general user behavior, thus is less impactful in demonstrating a general user journey."
+    },
+    {
+      "item": "A commuter reading news headlines on their phone while on the train.",
+      "rationale": "Represents a passive interaction with minimal engagement, providing limited insights into complex user journeys."
+    },
+    {
+      "item": "A small business owner managing orders and inventory via an online platform.",
+      "rationale": "Reflects a professional use case with business-specific applications, reducing its representativeness in demonstrating consumer-focused user journeys."
+    }
+  ]
+}

package/dist/roles/thinker/skills/khue.triage/stepTriage.skill.js

@@ -108,7 +108,7 @@ exports.SKILL_TRIAGE = (0, rhachet_1.genRoleSkill)({
         lookup: {
             apiKeyOpenai: {
                 source: 'process.env',
-                envar: 'PREP_OPENAI_KEY',
+                envar: 'OPENAI_API_KEY',
                 desc: 'the openai key to use',
                 type: 'string',
             },

package/dist/roles/thinker/skills/khue.triage/stepTriage.skill.js.map

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

package/dist/roles/thinker/skills/khue.triage/stepTriage.skill.ts

@@ -0,0 +1,174 @@
+import { enrollThread, genRoleSkill } from 'rhachet';
+import { genArtifactGitFile, getArtifactObsDir } from 'rhachet-artifact-git';
+
+import { genContextLogTrail } from '@src/.test/genContextLogTrail';
+import { genContextStitchTrail } from '@src/.test/genContextStitchTrail';
+import { getContextOpenAI } from '@src/.test/getContextOpenAI';
+
+import { BRIEFS_FOR_TRIAGE, loopTriage } from './stepTriage';
+
+export const SKILL_TRIAGE = genRoleSkill({
+  slug: 'triage',
+  route: loopTriage,
+  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',
+      },
+    },
+    assess: (
+      input,
+    ): input is {
+      output: string;
+      input: string;
+      goal: string;
+      references: string;
+      briefs: string;
+      ask: string;
+    } => typeof input.output === 'string',
+    instantiate: async (input: {
+      output: string;
+      input: string;
+      goal: string;
+      references: string;
+      briefs: string;
+      ask: string;
+    }) => {
+      // declare where all the artifacts will be found
+      const obsDir = getArtifactObsDir({ uri: input.output });
+      const artifacts = {
+        goal: {
+          concept: genArtifactGitFile(
+            { uri: obsDir + '.goal.concept.md' },
+            { versions: true },
+          ),
+          context: genArtifactGitFile(
+            { uri: obsDir + '.goal.context.md' },
+            { versions: true },
+          ),
+        },
+        feedback: genArtifactGitFile(
+          { uri: obsDir + '.feedback.md' },
+          { versions: true },
+        ),
+        'focus.context': genArtifactGitFile(
+          { uri: obsDir + '.focus.context.md' },
+          { versions: true },
+        ),
+        'focus.concept': genArtifactGitFile(
+          { uri: input.output },
+          { versions: true },
+        ),
+        input: genArtifactGitFile({ uri: input.input }, { versions: true }),
+        references:
+          input.references
+            ?.split(',')
+            .filter((uri) => !!uri)
+            .map((reference) =>
+              genArtifactGitFile({ uri: reference }, { access: 'readonly' }),
+            ) ?? [],
+        briefs:
+          input.briefs
+            ?.split(',')
+            .filter((uri) => !!uri)
+            .map((brief) =>
+              genArtifactGitFile({ uri: brief }, { access: 'readonly' }),
+            ) ?? [],
+      };
+
+      // detect the goal of the caller
+      const goalConcept: string = await (async () => {
+        // if goal explicitly defined, use it
+        if (input.goal)
+          return (
+            (
+              await 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 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,
+            },
+            refs: artifacts.references,
+          },
+        }),
+        thinker: await enrollThread({
+          role: 'thinker',
+          stash: {
+            art: {
+              'focus.context': artifacts['focus.context'],
+              'focus.concept': artifacts['focus.concept'],
+            },
+            briefs: [
+              ...artifacts.briefs,
+              ...BRIEFS_FOR_TRIAGE, // flow the triage briefs down so that <ponder> has them in context too; this approach does cause duplicate briefs for triage, but thats no biggie
+            ],
+          },
+        }),
+      };
+    },
+  },
+  context: {
+    lookup: {
+      apiKeyOpenai: {
+        source: 'process.env',
+        envar: 'OPENAI_API_KEY',
+        desc: 'the openai key to use',
+        type: 'string',
+      },
+    },
+    assess: (input): input is { apiKeyOpenai: string } =>
+      typeof input.apiKeyOpenai === 'string',
+    instantiate: () => {
+      return {
+        ...getContextOpenAI(),
+        ...genContextLogTrail(),
+        ...genContextStitchTrail(),
+      };
+    },
+  },
+  readme: '',
+});