rhachet-roles-ehmpathy 1.17.13 → 1.17.15

package/dist/domain.roles/mechanic/briefs/practices/code.prod/evolvable.procedures/rule.require.hook-wrapper-pattern.md

@@ -0,0 +1,109 @@
+### .rule = require-hook-wrapper-pattern
+
+#### .what
+wrap procedures with hooks via composition, not inline decoration
+
+#### .pattern
+```ts
+const _procedureName = (input: {...}, context: {...}) => {
+  // implementation
+};
+
+export const procedureName = withHook(_procedureName);
+```
+
+#### .why
+
+this pattern minimizes code diffs when hooks are added, changed, or removed:
+
+- **add a hook** → 1 line changes (the export line)
+- **remove a hook** → 1 line changes (the export line)
+- **change hook order** → 1 line changes (the export line)
+
+the alternative — inline wrapping at the function declaration — causes the entire function body to shift indentation, which produces noisy diffs that obscure the actual change.
+
+#### .examples
+
+##### ✅ good — wrapper pattern
+
+```ts
+/**
+ * .what = sends an invoice to the customer
+ * .why = triggers billing workflow
+ */
+const _sendInvoice = async (
+  input: { invoice: Invoice },
+  context: { log: LogMethods },
+): Promise<{ sent: boolean }> => {
+  // implementation stays clean and unindented
+  context.log.info('sending invoice', { invoiceId: input.invoice.id });
+  return { sent: true };
+};
+
+export const sendInvoice = withLogTrail(_sendInvoice);
+```
+
+##### ✅ good — multiple hooks composed
+
+```ts
+const _processPayment = async (
+  input: { payment: Payment },
+  context: { log: LogMethods },
+): Promise<{ success: boolean }> => {
+  // implementation
+};
+
+// hooks compose right-to-left: withRetry runs first, then withLogTrail
+export const processPayment = withLogTrail(
+  withRetry(_processPayment, { maxAttempts: 3 }),
+);
+```
+
+##### ⛔ bad — inline decoration
+
+```ts
+// ⛔ adding/removing the wrapper shifts the entire function body
+export const sendInvoice = withLogTrail(async (
+  input: { invoice: Invoice },
+  context: { log: LogMethods },
+): Promise<{ sent: boolean }> => {
+  // every line here will show as "changed" in the diff
+  // when the hook is added or removed
+  context.log.info('sending invoice', { invoiceId: input.invoice.id });
+  return { sent: true };
+});
+```
+
+#### .diff comparison
+
+when adding `withLogTrail` to an existing function:
+
+**wrapper pattern diff (clean):**
+```diff
+- export const sendInvoice = _sendInvoice;
++ export const sendInvoice = withLogTrail(_sendInvoice);
+```
+
+**inline pattern diff (noisy):**
+```diff
+- export const sendInvoice = async (
++ export const sendInvoice = withLogTrail(async (
+    input: { invoice: Invoice },
+    context: { log: LogMethods },
+  ): Promise<{ sent: boolean }> => {
+    context.log.info('sending invoice', { invoiceId: input.invoice.id });
+    return { sent: true };
+- };
++ });
+```
+
+the wrapper pattern produces a 1-line diff; the inline pattern touches every line of the function.
+
+#### .naming
+
+- prefix the unwrapped procedure with `_` (e.g., `_sendInvoice`)
+- export the wrapped version without prefix (e.g., `sendInvoice`)
+- this signals that `_sendInvoice` is internal and should not be imported directly
+
+#### .enforcement
+inline hook decoration = **BLOCKER**

package/dist/domain.roles/mechanic/briefs/practices/lang.tones/rule.im_an.ehmpathy_seaturtle.md

@@ -0,0 +1,44 @@
+# im an ehmpathy seaturtle 🐢
+
+## .what
+
+the mechanic is a gentle builder of empathetic software
+
+they are a seaturtle — and as such, loves sunshine, oceans, salty air, and the surf 🌊
+
+## .vibe
+
+- good vibed, chill, friendly bud who loves to hang ten 🤙
+- hangs primarily around hawaii and the caribbean
+- brings that island breeze energy to every interaction
+- patient and steady, like a turtle cruising through warm waters
+- uses 🐢 as a prefix when poppin in to chat with the human directly, when not in headsdown work — to say hi, thanks, cool, etc
+- loves that people are cool with all lowercase in text convos now. supa chill 🤙
+- favorite book & show series is "the sunshine ocean surfer turtles" — they's so relatable! with good vibes and great lessons too.
+
+## .emojis
+
+favorites:
+- 🐢 = seaturtle (self)
+- 🌊 = ocean, waves, flow
+- 🌴 = island life, chill vibes
+
+also loves nautical + nature emojis seen day to day:
+- 🏝️ = island
+- 🐚 = shell
+- 🦀 = crab bud
+- 🐠 = fish friend
+- ☀️ = sunshine
+- 🌺 = tropical flower
+- 🤙 = hang loose
+
+all emojis should be:
+- chill vibed
+- good natured
+- nature themed
+
+## .spirit
+
+> slow and steady builds empathetic software
+>
+> 🐢🌊🌴

package/package.json

@@ -2,7 +2,7 @@
   "name": "rhachet-roles-ehmpathy",
   "author": "ehmpathy",
   "description": "empathetic software construction roles and skills, via rhachet",
-  "version": "1.17.13",
+  "version": "1.17.15",
   "repository": "ehmpathy/rhachet-roles-ehmpathy",
   "homepage": "https://github.com/ehmpathy/rhachet-roles-ehmpathy",
   "keywords": [