rhachet-roles-bhrain 0.2.0 → 0.3.0

package/dist/roles/thinker/skills/brief.articulate/.demo/diverge.v2025_08_17.i1.md

@@ -0,0 +1,62 @@
+# 🧩 .brief: `<diverge>`
+
+## .what
+
+`<diverge>` is a semantic motion primitive designed to explore and identify the maximum variance within a given concept space. It aims to uncover a diverse spectrum of instances or expressions based on the core concept, pushing the boundaries to reveal the widest possible range of variations.
+
+---
+
+## 🎯 purpose
+
+- uncover the broadest set of variations or instances from a starting concept
+- facilitate the discovery of novel, unexpected, or edge-case examples
+- challenge assumptions by expanding the visible scope of a concept
+
+---
+
+## ⚙️ process
+
+1. **anchor to the core concept**
+   - define the central idea or category you are diversifying
+   - ensure a clear understanding of its basic boundaries
+
+2. **explore variance axes**
+   - identify possible axes of variation (e.g., color, shape, function)
+   - consider both obvious and non-obvious differentiation criteria
+
+3. **generate variations**
+   - systematically list distinct and contrasting examples within the concept
+   - prioritize breadth over precision at this stage
+
+4. **evaluate diversity**
+   - assess whether the variations span the intended breadth and highlight differences
+   - refine any clustering or flattening of variance points that reduce visibility
+
+---
+
+## 🌿 example: `<diverge>` applied to `colors`
+
+Identify diverse colors exemplifying maximum variance:
+- red
+- green
+- tangerine
+- scarlet
+- ivory
+
+Each selected color exemplifies unique attributes within the color spectrum, showcasing distinct hues, tints, and tones. This variance reveals the extensive diversity possible within a seemingly simple category.
+
+---
+
+## 📐 when to use
+
+- when seeking inspiration or brainstorming new possibilities
+- when needing to identify extremes or edge cases of a concept
+- when preparing for strategic decisions requiring a panoramic understanding of option space
+
+---
+
+## 💡 notes
+
+- `<diverge>` differs from clustering or focusing as it intentionally avoids centralization or narrowing
+- it complements processes that require a broad exploration phase prior to narrowing
+- can be paired with other primitives like `<contrast>` or `<compare>` for deeper analysis of the generated variations

package/dist/roles/thinker/skills/brief.articulate/.demo/diverge.v2025_08_17.i1.with_feedback.md

@@ -0,0 +1,89 @@
+# 🧩 .brief: `<diverge>`
+
+## .what
+
+`<diverge>` is a semantic motion primitive designed to explore and identify the maximum variance within a given concept space. It aims to uncover a diverse spectrum of instances or expressions based on the core concept, pushing the boundaries to reveal the widest possible range of variations.
+
+---
+
+## 🎯 purpose
+
+- uncover the broadest set of variations or instances from a starting concept
+- facilitate the discovery of novel, unexpected, or edge-case examples
+- challenge assumptions by expanding the visible scope of a concept
+
+---
+
+## ⚙️ process
+
+1. **anchor to the core concept**
+   - define the central idea or category you are diversifying
+   - ensure a clear understanding of its basic boundaries
+
+2. **explore variance axes**
+   - identify possible axes of variation (e.g., color, shape, function)
+   - consider both obvious and non-obvious differentiation criteria
+
+3. **generate variations**
+   - systematically list distinct and contrasting examples within the concept
+   - prioritize breadth over precision at this stage
+
+4. **evaluate diversity**
+   - assess whether the variations span the intended breadth and highlight differences
+   - refine any clustering or flattening of variance points that reduce visibility
+
+---
+
+## 🌿 examples
+
+### Application to `colors`
+Identify diverse colors exemplifying maximum variance:
+- red
+- green
+- tangerine
+- scarlet
+- ivory
+- cobalt
+- magenta
+
+Each selected color exemplifies unique attributes within the color spectrum, showcasing distinct hues, tints, and tones. This variance reveals the extensive diversity possible within a seemingly simple category.
+
+### Application to `modes of transport`
+Identify a wide array of transportation modes:
+- bicycle
+- skateboard
+- electric car
+- sailboat
+- helicopter
+- hovercraft
+- high-speed train
+
+These examples represent different speeds, energy sources, and terrains, illustrating the diverse possibilities in transportation.
+
+### Application to `cuisines`
+Explore the vast diversity in culinary traditions:
+- Italian
+- Japanese
+- Mexican
+- Ethiopian
+- Indian
+- Thai
+- Moroccan
+
+Each cuisine brings unique flavors, ingredients, and cultural significance, enriching the global culinary palette.
+
+---
+
+## 📐 when to use
+
+- when seeking inspiration or brainstorming new possibilities
+- when needing to identify extremes or edge cases of a concept
+- when preparing for strategic decisions requiring a panoramic understanding of option space
+
+---
+
+## 💡 notes
+
+- `<diverge>` differs from clustering or focusing as it intentionally avoids centralization or narrowing
+- it complements processes that require a broad exploration phase prior to narrowing
+- can be paired with other primitives like `<contrast>` or `<compare>` for deeper analysis of the generated variations

package/dist/roles/thinker/skills/brief.articulate/.demo/diverge.v2025_08_17.i2.md

@@ -0,0 +1,47 @@
+# 🧩 .brief: `<diverge>`
+
+## .what
+**`<diverge>`** is a semantic motion primitive focused on exploring the breadth of a given concept by identifying its most varied instances. It operates by systematically uncovering diverse elements or variations within the same conceptual category, highlighting the range of possibilities that exist.
+
+---
+
+## 🎯 purpose
+- to map out and understand the **full spectrum of a concept**
+- to enrich the concept by identifying and articulating its **maximum variance instances**
+- to facilitate creative thinking and ideation by exposing **all possible angles**
+
+---
+
+## 🗺 method
+1. **identify the core concept**
+   - determine the central idea or category you wish to explore
+   - e.g., `colors`, `solutions`, `approaches`
+
+2. **expand into variants**
+   - list out as many distinct and varied instances as possible
+   - focus on range and contrast, covering different attributes, usages, or contexts
+
+3. **categorize variance**
+   - consider organizing instances by subcategories or dimensions of variance
+   - e.g., for colors: hue, tone, saturation
+
+4. **integrate divergent discovery**
+   - apply findings to broaden perspectives or inform decisions in related activities
+   - e.g., using the diverse color palette to design inclusive artwork
+
+---
+
+## 🔍 examples
+- `<diverge>[colors]` results in a range:
+  - `red`, `green`, `tangerine`, `scarlet`, `ivory`
+- `<diverge>[cooking methods]` could produce:
+  - `baking`, `grilling`, `steaming`, `frying`, `poaching`
+- `<diverge>[musical genres]` may uncover:
+  - `jazz`, `classical`, `hip-hop`, `electronic`, `folk`
+
+---
+
+## 💡 notes
+- `<diverge>` is about **breadth over depth**, emphasizing range rather than detail
+- useful in ideation sessions, diversification strategies, and exploratory research
+- pairs well with `<converge>` to then refine or select from the expanded set of instances

package/dist/roles/thinker/skills/brief.articulate/.demo/joke.v2025_08_15.i1.md

@@ -0,0 +1,44 @@
+# 🧩 .brief: `joke`
+
+## .what
+a **joke** is a form of communication designed to elicit laughter or amusement. it often involves a play on words, a twist in meaning, or a surprising punchline that challenges expectations. jokes can be spoken, written, or performed, and are a universal element of humor across cultures.
+
+## .etymology
+the word "joke" originates from the latin word "jocus," meaning jest or joke. its use in english can be traced back to the 17th century, initially indicating a jest or something done to amuse.
+
+## .examples
+
+- **verbal joke**: "why don't scientists trust atoms? because they make up everything."
+- **knock-knock joke**:
+  - "knock, knock."
+  - "who's there?"
+  - "lettuce."
+  - "lettuce who?"
+  - "lettuce in, it's cold out here!"
+- **physical comedy**: charlie chaplin's slapstick routines, where physical movements and exaggerated actions lead to humorous outcomes.
+
+## .why
+jokes serve as a social tool for bonding, relieving tension, and expressing creative thinking. they can highlight shared knowledge or cultural references, reinforcing group identity.
+
+## .how
+a joke typically comprises a setup and a punchline. the **setup** establishes context, creating expectations. the **punchline** delivers an unexpected twist or resolution, inducing laughter by subverting those expectations.
+
+## .where
+jokes are prevalent in various settings, from casual conversations to professional comedy acts. they feature in media, classrooms, workplaces, and social gatherings, adapting to context and audience.
+
+## .when
+jokes are relevant at times where light-heartedness or relief from tension is desired, or when making a point more engaging and memorable. certain contexts, such as funerals or serious meetings, may render jokes inappropriate.
+
+## .who
+anyone can tell a joke, but effective delivery often requires a sense of timing, audience awareness, and creativity. professional comedians use jokes as their craft, while ordinary people use them to enliven interactions.
+
+## .attributes
+- **brevity:** efficient delivery is key, often with minimal words.
+- **timing:** the effectiveness of a joke highly depends on when it's told.
+- **surprise:** jokes rely on unexpected conclusions or twists.
+- **universality:** though culturally nuanced, the basic structure of jokes is global.
+
+## .relations
+- **anecdote:** a short, amusing story often containing elements of a joke.
+- **satire:** uses humor, irony, or exaggeration, often to criticize.
+- **riddle:** poses a question requiring creative thought for a humorous or clever answer.

package/dist/roles/thinker/skills/brief.articulate/.demo/joke.v2025_08_15.i2.md

@@ -0,0 +1,63 @@
+# 🧩 .brief: `joke`
+
+## .what
+A **joke** is a form of communication intended to provoke laughter or amusement. This typically involves a comedic twist, element of surprise, or play on words. Jokes are a ubiquitous part of human interaction and transcend cultural barriers, often shedding light on social norms, shared experiences, or human folly.
+
+---
+
+## 🔍 etymology
+The term **"joke"** derives from the Latin word *"jocus"*, meaning jest or play. The use of "joke" in the comedic sense became prevalent in the English language in the 17th century, reflecting the evolution of humor as a structured form of entertainment and expression.
+
+---
+
+## 🎯 purpose
+- to entertain and amuse
+- to express wit and creativity
+- to build social connections and foster group cohesion
+- to provide relief from tension or stress
+
+---
+
+## 🔧 how it works
+Jokes function through various comedic mechanisms, including:
+- **Incongruity**: presenting an unexpected or absurd outcome
+- **Exaggeration**: amplifying truth for humorous effect
+- **Wordplay**: utilizing homophones, puns, and multiple meanings
+- **Timing**: expertly pacing the punchline for maximum effect
+
+---
+
+## 🧩 examples
+1. **Classic**: "Why did the chicken cross the road? To get to the other side."
+   - **Mechanism**: Incongruity; subverts expectation of a complex answer with simplicity.
+
+2. **Wordplay**: "I told my wife she was drawing her eyebrows too high. She looked surprised."
+   - **Mechanism**: Play on the dual meaning of "surprised."
+
+3. **One-liner**: "I have a split personality," said Tom, being Frank.
+   - **Mechanism**: Pun; relies on the humor of name wordplay and idiomatic phrases.
+
+---
+
+## 🎨 cultural references
+Jokes can take many forms across cultures, from stand-up routines and comedic skits to riddles and visual gags. They often reflect societal norms and values, serving as a mirror to the intricacies of human life.
+
+---
+
+## 🎭 real-world implications
+Beyond humor, jokes play a role in:
+- **Psychological resilience**: offering coping mechanisms during challenging times
+- **Cultural exchange**: bridging gaps between languages and traditions
+- **Social critique**: providing commentary on political or societal issues
+
+---
+
+## 📘 related terms
+- **Pun**: A joke exploiting different meanings of a word or similar words
+- **Satire**: Humor, irony, or ridicule used to criticize or mock
+- **Gag**: A specific joke or comedic sequence
+
+---
+
+## 🧠 insights
+Jokes elucidate the human need to find lightness in life. While they serve as simple entertainment, their implications extend into psychological, social, and cultural realms, demonstrating their significant and multifaceted value.

package/dist/roles/thinker/skills/brief.articulate/.demo/joke.v2025_08_15.i3.md

@@ -0,0 +1,51 @@
+# 🧩 .brief: `joke`
+
+## .what
+a **joke** is a form of expression, often verbal, intended to provoke laughter or amusement. it typically involves a setup and a punchline or twist that creates humor through a play on words, situations, or expectations.
+
+---
+
+## .etymology
+the word "joke" originates from the latin "jocus," meaning jest or play. it entered middle english through old french as "jouer," evolving into the modern term "joke."
+
+---
+
+## .definition
+- a **joke** is a narrative or phrase crafted to elicit laughter by exploiting incongruities in language, logic, or irony.
+- jokes can be cultural artifacts, reflecting societal norms, insights, and taboos.
+
+---
+
+## .types
+1. **knock-knock jokes**: involve a call-and-response format, often playful or pun-based.
+2. **one-liners**: concise, single-sentence jokes focusing on wordplay or surprise.
+3. **anecdotal jokes**: short narratives ending in a humorous twist.
+4. **practical jokes**: physical or situational gags designed to surprise or irritate for comedic effect.
+
+---
+
+## .examples
+- **knock-knock joke**: "knock, knock." "who’s there?" "lettuce." "lettuce who?" "lettuce in, it’s cold out here!"
+- **one-liner**: "i told my wife she was drawing her eyebrows too high. she looked surprised."
+- **anecdotal joke**: "why don’t scientists trust atoms? because they make up everything."
+
+---
+
+## .purpose & effects
+- jokes often serve to break tension, share cultural insights, or provide social commentary.
+- humor is a social adhesive, fostering community bonds through shared laughter.
+
+---
+
+## .psychology & anthropology
+studies suggest that humor evolved as a cognitive function to enhance group cohesion and social learning. jokes can reveal power dynamics and social norms within cultures.
+
+---
+
+## .narrative arc
+a joke typically follows a simple arc: setup (establish context) → punchline (introduce humor twist).
+
+---
+
+## .insights & cultural value
+while jokes might appear frivolous, they carry cultural and linguistic insights, revealing societal values and collective human experience. they differ across cultures, reflecting unique linguistic structures and societal taboos.

package/dist/roles/thinker/skills/brief.articulate/.demo/user-journey.v2025_08_17.i1.md

@@ -0,0 +1,62 @@
+# 🧩 .brief: `user journey`
+
+## .what
+A **user journey** is the series of experiences a user goes through to accomplish a specific goal within a product or service. It maps out the end-to-end experience from the user’s perspective, capturing interactions, emotions, and environments throughout the process.
+
+---
+
+## 🎯 purpose
+- **Improve user experience**: Identifies pain points and opportunities for enhancement.
+- **Guide design decisions**: Provides a user-centered framework for creating or refining touchpoints.
+- **Communicate user needs**: Helps stakeholders understand the user’s perspective and priorities.
+
+---
+
+## 🛠 components
+- **Personas**: Representations of different user archetypes.
+- **Scenarios**: Contexts in which the journey unfolds.
+- **Touchpoints**: Key moments of interaction between the user and the product/service.
+- **Emotions**: User feelings at different stages.
+- **Pain Points**: Challenges or frustrations encountered by the user.
+- **Goals**: Desired outcomes the user aims to achieve.
+
+---
+
+## 🌀 stages
+1. **Discovery**: User learns about the product or service.
+2. **Consideration**: User evaluates options or gathers information.
+3. **Purchase/Decision**: User commits to a product or service.
+4. **Onboarding**: User starts using the product/service.
+5. **Usage**: Regular interaction with the product/service.
+6. **Support**: Seeks help or resolution to issues.
+7. **Feedback**: Shares experience or leaves a review.
+
+---
+
+## 🌐 context
+A user journey occurs across multiple channels and platforms, including websites, mobile apps, customer support, and physical locations. It is essential for businesses aiming for omnichannel consistency to maintain seamless transitions and coherent messaging across all touchpoints.
+
+---
+
+## 🎨 examples
+- **Online shopping**: From discovering a product on social media, navigating through the website, purchasing, and finally receiving the product.
+- **Healthcare service**: Scheduling an appointment, receiving care, and follow-up communications.
+
+---
+
+## 📈 benefits
+- Reduces friction and improves satisfaction by addressing user needs at each stage.
+- Informs cross-functional teams (e.g., marketing, design, development) to align their efforts with user-focused goals.
+- Facilitates continuous improvement through ongoing assessment and refinement of the user experience.
+
+---
+
+## 📚 when to use
+- During the design phase of a new product or service.
+- When changes are made to existing services seeking to improve user experience.
+- To understand and solve specific user experience challenges.
+
+---
+
+## 🔄 evolution
+As user expectations and technologies evolve, so must user journeys. They should be reviewed and updated regularly to reflect actual user behavior and preferences effectively.

package/dist/roles/thinker/skills/brief.articulate/.demo/user-journey.v2025_08_17.i2.md

@@ -0,0 +1,49 @@
+# 🧩 .brief: `user journey`
+
+## .what
+a **user journey** is a narrative or framework that maps out the interactions an individual has with a product or service over time. it focuses on capturing the complete user experience from initial contact to final engagement, highlighting the touchpoints and channels encountered along the way.
+
+---
+## 🎯 purpose
+- to understand and enhance the user experience
+- to identify pain points and opportunities for improvement
+- to align organizational goals with user needs and expectations
+
+---
+## 🛠️ components
+- **personas**: fictional characters representing user types
+- **touchpoints**: instances of interaction between user and service
+- **emotional journey**: a map of user emotions throughout the process
+- **channels**: platforms and mediums used during the interaction
+- **goals**: user objectives and desired outcomes
+
+---
+## 🗺️ structure
+1. **awareness**: how the user first learns about the product or service
+2. **consideration**: exploration of options and seeking further information
+3. **purchase/decision**: the point of transaction or commitment
+4. **retention**: user's continued use and experience with the service
+5. **advocacy**: user's likelihood to recommend the product or service to others
+
+---
+## 💡 examples
+- a customer's journey from learning about a new smartphone through an online ad, visiting a store to try it out, purchasing it online, and finally using and recommending it to friends.
+- a traveler's interactions from booking a flight, entering the airport, experiencing the flight, arriving at the destination, and sharing their trip online.
+
+---
+## 🔄 variations
+- **self-service journeys**: focused on users navigating services themselves without direct support (e.g., online shopping)
+- **in-person journeys**: primarily conducted in physical locations (e.g., dining at a restaurant)
+- **digital-first journeys**: interactions primarily occur through digital platforms (e.g., using a mobile banking app)
+
+---
+## 🎯 why it matters
+- facilitates a user-centered design approach
+- helps in identifying user pain points to optimize conversion rates
+- aids in creating seamless and cohesive experiences across different channels
+
+---
+## 📈 benefits
+- improved user satisfaction and loyalty
+- increased efficiency in product or service design
+- stronger alignment of product offerings with user expectations

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

@@ -104,7 +104,7 @@ exports.SKILL_ARTICULATE = (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/brief.articulate/stepArticulate.skill.js.map

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

@@ -0,0 +1,168 @@
+import { enrollThread, genContextStitchTrail, genRoleSkill } from 'rhachet';
+import { genArtifactGitFile, getArtifactObsDir } from 'rhachet-artifact-git';
+
+import { genContextLogTrail } from '@src/.test/genContextLogTrail';
+import { getContextOpenAI } from '@src/.test/getContextOpenAI';
+import { setSkillOutputSrc } from '@src/domain.operations/artifact/setSkillOutputSrc';
+import { genStitchStreamToDisk } from '@src/domain.operations/context/genStitchStreamToDisk';
+
+import { loopArticulate } from './stepArticulate';
+
+export const SKILL_ARTICULATE = genRoleSkill({
+  slug: 'articulate',
+  route: 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,
+    ): input is {
+      output: string;
+      goal: string;
+      references: string;
+      briefs: string;
+      templates?: string;
+      ask: string;
+    } => typeof input.output === 'string',
+    instantiate: async (input: {
+      output: string;
+      goal: string;
+      references: string;
+      briefs: string;
+      templates?: string;
+      ask: string;
+    }) => {
+      const obsDir = getArtifactObsDir({ uri: input.output });
+      const artifacts = {
+        goal: await (async () => {
+          if (input.goal)
+            return genArtifactGitFile(
+              { uri: input.goal },
+              { access: 'readonly' },
+            );
+
+          const art = genArtifactGitFile(
+            { uri: obsDir + '.goal.md' },
+            { versions: true },
+          );
+          await art.set({ content: input.ask });
+          return art;
+        })(),
+        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 },
+        ),
+        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' }),
+            ) ?? [],
+        templates:
+          input.templates
+            ?.split(',')
+            .filter((uri) => !!uri)
+            .map((template) =>
+              genArtifactGitFile({ uri: template }, { access: 'readonly' }),
+            ) ?? [],
+      };
+
+      // add an src file for historic record
+      await setSkillOutputSrc({ skillUri: 'bhrain.articulate', opts: input }); // todo: get skillUri from context
+
+      return {
+        caller: await 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 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: '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({
+          stream: genStitchStreamToDisk({ dir: process.cwd() }), // stream events to disk
+        }),
+      };
+    },
+  },
+  readme: '',
+});