@growthub/cli 0.14.4 → 0.14.6

package/assets/worker-kits/creative-strategist-v1/templates/scene-modules/hooks/meme-overlay.md

@@ -1,104 +0,0 @@
-# Scene Module: Meme Overlay Hook
-> ID: `meme-overlay`
-> Type: hook (Scene 1)
-> Compatible Formats: `bedroom-minimic-talk`
-> Status: ✅ PROVEN — Solawave BOGO (Hook A)
-
----
-
-## WHAT IT DOES
-
-Opens with a viral meme character overlaid on the creator's frame (lower 60% of screen). Creator's eyes are visible above the meme. The meme character expresses the target audience's pain state (tired, stressed, broke, defeated). The meme clears at ~2 seconds and the creator speaks — now the viewer is already emotionally calibrated.
-
-**Why it works:** The meme is a pre-loaded emotional shorthand. The viewer sees "D.W. Arthur tired face" and instantly downloads 8 words of emotional context in 0.5 seconds. It also signals "this person has the same taste as me" — a micro-trust signal before any product is mentioned.
-
----
-
-## VISUAL DIRECTION
-
-```
-Frame: Creator at bedroom desk, mini-mic at chin level.
-Meme:  [MEME_CHARACTER] overlaid — fills lower 60% of frame.
-       Creator's eyes and forehead visible above.
-       Meme should match the pain state (tired = dark circles, broke = crying money, etc.)
-Duration: 1.5–2 seconds of meme before it clears or fades.
-Lighting: Warm ambient — bedroom or desk lamp.
-```
-
-**Meme selection guide:**
-- Under-eye / tired skin → D.W. from Arthur (dark circles), "4am" memes
-- Wasted money on skincare → Sad Keanu, Crying Jordan, "SPENT $300" text meme
-- Feeling old → Miss Minutes, aging character memes
-- Frustrated with solutions not working → "This is fine" dog, "I've tried everything" formats
-- Skepticism → "well yes but actually no" meme, Pacha "ugh finally" reverse
-
----
-
-## ON-SCREEN TEXT
-
-```
-Line 1: "[RELATABLE_PAIN_STATEMENT]"
-         e.g. "me looking at my forehead every morning"
-         e.g. "oh hey 4am its me"
-         e.g. "me after spending $300 on skincare"
-
-Style:   White text, black outline. Bold key words. Bottom third.
-Timing:  Text appears with meme, stays through creator's first spoken word.
-```
-
----
-
-## ACTOR DIALOGUE (spoken after meme clears)
-
-```
-Pattern: [acknowledgment of meme state] + [pivot to discovery]
-
-Templates:
-  "ok but actually... I found something."
-  "real. and then I found [PRODUCT_NAME]."
-  "been that person. here's what actually worked."
-  "[laugh/exhale] — ok so this changed it."
-
-Delivery: Casual, slightly conspiratorial. NOT an announcer voice. 
-          Like texting a friend the thing that fixed it.
-```
-
----
-
-## BRAND-KIT PLACEHOLDERS
-
-| Placeholder | Source | Example |
-|-------------|--------|---------|
-| `[MEME_CHARACTER]` | User direction or brief | "D.W. from Arthur (tired face)" |
-| `[RELATABLE_PAIN_STATEMENT]` | `brand-kit.md → target_pain_point` | "me looking at my forehead every morning" |
-| `[PRODUCT_NAME]` | `brand-kit.md → primary_service` | "Solawave wand" |
-
----
-
-## MUSE REFERENCE
-
-Muse: @frankyshaw — frame_1s.jpg, frame_2s.jpg
-Text: "oh hey 4am its me" + "getting five"
-Meme: D.W. from Arthur (cartoon character with dark circles, tired expression)
-Format: Meme overlay on creator's face. Eyes visible above. Mini-mic in hand.
-
----
-
-## JS STUB (hookCard)
-
-```js
-hookCard("A", "Tired Skin Meme — Direct Muse Mirror",
-  "VISUAL: [MEME_CHARACTER] overlaid on lower 60% of frame. Actor's eyes visible above. Mini-mic in hand.\n\n" +
-  "ON-SCREEN TEXT: '[RELATABLE_PAIN_STATEMENT]'\n\n" +
-  "ACTOR LINE (after meme clears): '[PIVOT_LINE_TO_PRODUCT]'\n\n" +
-  "NOTE: Direct mirror of muse format. Test first — highest muse fidelity."
-)
-```
-
----
-
-## AI GENERATION PROMPT STUB
-
-```
-Photoreal female creator, [AI_ACTOR_AGE], natural look, warm skin tone. Bedroom desk. Casual [OUTFIT]. Silver condenser mini-mic held at chin. [MEME_CHARACTER] overlay fills lower 60% of frame — creator's eyes and forehead visible above. She glances slightly downward at the meme, looks up with a knowing half-smile. Warm ambient light from left (bedside lamp). Handheld feel. Authentic TikTok creator bedroom aesthetic. 9:16. 3 seconds.
-```

package/assets/worker-kits/creative-strategist-v1/templates/scene-modules/hooks/pov-confession.md

@@ -1,92 +0,0 @@
-# Scene Module: POV Mirror Confession Hook
-> ID: `pov-confession`
-> Type: hook (Scene 1)
-> Compatible Formats: `bedroom-minimic-talk`
-> Status: ✅ PROVEN — Solawave BOGO (Hook E)
-
----
-
-## WHAT IT DOES
-
-Creator is caught in a candid moment: looking at herself in a mirror, scrutinizing her skin. "POV:" text appears — a TikTok native language signal that puts the viewer IN the moment. She turns to camera with mini-mic, transitioning from the private moment to the share.
-
-**Why it works:** "POV:" is the highest-engagement text format on TikTok/Reels — it collapses the distance between creator and viewer. The mirror moment is relatable to anyone who's ever examined their own face. The turn-to-camera creates a reveal beat in 3 seconds.
-
----
-
-## VISUAL DIRECTION
-
-```
-Frame:   Creator in bathroom or bedroom, facing mirror. Camera captures her OVER THE SHOULDER
-         so we see both her face and the mirror reflection simultaneously.
-         OR: creator looking directly into front camera as if checking skin — then pulls back.
-Beat:    She leans in to look at her skin (1 second) → recognition/reaction face (0.5s) 
-         → turns toward camera/phone with mini-mic (1.5s).
-Lighting: Warm bathroom/vanity light. Natural, slightly imperfect. NOT studio.
-```
-
----
-
-## ON-SCREEN TEXT
-
-```
-Line 1:  "POV: [PAIN_POINT_AS_POV_STATEMENT]"
-
-Templates:
-  "POV: your $80 eye cream stopped working"
-  "POV: you've been using the same serum for 6 months and nothing changed"
-  "POV: you just turned [AGE] and your face noticed first"
-  "POV: you've tried every skincare thing on your FYP"
-
-Style:   White text, black outline. "POV:" in slightly smaller text than the statement.
-         Appears at top of frame (unlike other hooks which use bottom third).
-```
-
----
-
-## ACTOR DIALOGUE
-
-```
-Pattern: [names the specific failed product/investment] + [pivot to solution]
-
-Templates:
-  "Been there. Here's what actually moved the needle."
-  "That was me. And then I stopped wasting money and tried this."
-  "Same. For [TIME]. Until I found [PRODUCT_NAME]."
-  "I had that exact face every morning until [PRODUCT_NAME]."
-
-Delivery: Matter-of-fact. She's past the frustration stage — she found the answer.
-          Slight confidence in the turn-to-camera moment.
-```
-
----
-
-## BRAND-KIT PLACEHOLDERS
-
-| Placeholder | Source | Example |
-|-------------|--------|---------|
-| `[PAIN_POINT_AS_POV_STATEMENT]` | `brand-kit.md → target_pain_point` | "your $80 eye cream stopped working" |
-| `[PRODUCT_NAME]` | `brand-kit.md → primary_service` | "Solawave" |
-| `[AGE]` | `brand-kit.md → target_age_range` midpoint | "28" / "32" |
-
----
-
-## JS STUB (hookCard)
-
-```js
-hookCard("E", "POV Mirror Confession",
-  "VISUAL: Creator in bathroom/bedroom facing mirror. Camera over-shoulder — we see face + reflection.\n" +
-  "She leans in to examine skin, reaction face, then turns to camera with mini-mic.\n\n" +
-  "ON-SCREEN TEXT (top of frame): 'POV: [PAIN_POINT_AS_POV_STATEMENT]'\n\n" +
-  "ACTOR LINE: '[PIVOT_TO_SOLUTION_LINE]'\n\n" +
-  "NOTE: Native TikTok language. Mirror moment is universally relatable. Best for 25–35 female demo."
-)
-```
-
----
-
-## AI GENERATION PROMPT STUB
-
-```
-Photoreal female creator, [AI_ACTOR_AGE], natural look. Bathroom or bedroom vanity. Camera captures her over-the-shoulder — both face and mirror reflection visible. She leans in to look at her skin, expression: scrutiny → recognition → resolves to discovery. Turns to camera/phone with silver mini-mic in hand. Warm vanity/bathroom lighting. Unfiltered, authentic. Text overlay at top: 'POV: [PAIN_POINT]'. 9:16. 3 seconds.
-```

package/assets/worker-kits/creative-strategist-v1/templates/scene-modules/hooks/tiktok-comment.md

@@ -1,116 +0,0 @@
-# Scene Module: TikTok Comment Hook
-> ID: `tiktok-comment`
-> Type: hook (Scene 1)
-> Compatible Formats: `bedroom-minimic-talk`
-> Status: ✅ PROVEN — Solawave BOGO (Hook B)
-
----
-
-## WHAT IT DOES
-
-Opens with a TikTok-style comment bubble overlaid on screen. The comment voices the viewer's exact skepticism about the category/product ("Is this legit or just another skincare scam?"). The creator reads it, recognizes it, and responds directly to camera — turning the comment into a shared moment rather than a defensive rebuttal.
-
-**Why it works:** It names the objection in the viewer's own voice before the viewer consciously forms it. The comment feels like a peer asking, not an ad defending. The creator's response ("Girl, I had the same question") transforms skepticism into curiosity in 3 seconds. High persuasion hook for any category with trust barriers.
-
----
-
-## VISUAL DIRECTION
-
-```
-Frame:   Creator at bedroom desk, mini-mic in one hand.
-         She's holding her phone slightly toward the camera, or comment appears as overlay.
-Comment: TikTok-style comment bubble (dark rounded rectangle, white username + text).
-         Positioned in lower-middle or left-of-center of frame.
-         Creator glances DOWN at it → raises an eyebrow → looks UP at camera.
-Duration: Comment visible for 1.5–2 seconds.
-Lighting: Warm bedroom ambient.
-```
-
-**Comment text options (pick one per variation):**
-```
-"Is this legit or just another skincare scam?"
-"does this actually work or is it just hype"
-"Is this legit tho?"
-"wait is this actually real??"
-"tried so many of these. Do they actually work?"
-```
-
----
-
-## ON-SCREEN TEXT
-
-```
-Overlay:  [TikTok comment bubble] — "Is this legit or just another [CATEGORY] scam?"
-          Username: @[generic — e.g. @sarahtrying2024 / @beautygirl_real]
-
-After:    Comment fades. Creator's caption appears:
-          "[RESPONSE_LINE]"
-          e.g. "girl. i had the same question."
-```
-
----
-
-## ACTOR DIALOGUE
-
-```
-Pattern: [validates the question] + [earned credibility signal] + [pivot to answer]
-
-Templates:
-  "Girl. I had the same question. So I actually tested it."
-  "Literally me 3 weeks ago. I looked it up."
-  "Same. I went down the rabbit hole so you don't have to."
-  "I asked that too. Here's what I found."
-
-Delivery: Slight amused smile at the comment. Recognition, not defensiveness.
-          She's not selling — she's answering a question she had herself.
-```
-
----
-
-## BRAND-KIT PLACEHOLDERS
-
-| Placeholder | Source | Example |
-|-------------|--------|---------|
-| `[CATEGORY]` | `brand-kit.md → industry` | "skincare" / "pet" / "supplement" |
-| `[PRODUCT_NAME]` | `brand-kit.md → primary_service` | "Solawave wand" |
-| `[RESPONSE_LINE]` | Brief content | "girl. i had the same question." |
-
----
-
-## DUAL USE: Hook OR Body Scene
-
-This module works in TWO positions:
-1. **As Hook A or B** (Scene 1, 0–3s) — pure skepticism open. No product shown.
-2. **As Scene 3 body beat** (8–13s) — comment appears mid-ad as the "skeptic pivot" after the problem confession. Product is introduced immediately after.
-
-When used in Scene 3, pair with `body/tiktok-skeptic-pivot.md` for the full beat.
-
----
-
-## MUSE REFERENCE
-
-Muse: @frankyshaw — frames around 11–13s (the "if you even" + "me rn editing" beat)
-The muse doesn't use a literal TikTok comment — but addresses viewer skepticism directly at this beat.
-The TikTok comment format is the **Solawave enhancement** of that skepticism-disarm beat.
-
----
-
-## JS STUB (hookCard)
-
-```js
-hookCard("B", "TikTok Comment — 'Is This Legit?'",
-  "VISUAL: TikTok comment bubble overlaid: 'Is this legit or just another [CATEGORY] scam?'\n" +
-  "Actor glances down at it, raises eyebrow, looks back at camera with amused recognition.\n\n" +
-  "ON-SCREEN TEXT: [comment bubble] → clears → '[RESPONSE_LINE]'\n\n" +
-  "ACTOR LINE: '[RESPONSE_LINE] So I actually tested it.'\n\n" +
-  "NOTE: Preempts #1 consumer objection in the first 2 seconds. High persuasion."
-)
-```
-
----
-
-## AI GENERATION PROMPT STUB
-
-```
-Photoreal female creator, [AI_ACTOR_AGE], natural look, warm skin tone. Bedroom desk. Silver mini-mic in one hand. TikTok comment bubble overlaid on frame: 'Is this legit or just another [CATEGORY] scam?' (dark rounded rectangle, white text, @username visible). She looks down at comment, raises an eyebrow in recognition, looks up at camera with slight amused smile. Warm ambient bedroom lighting. Authentic TikTok creator aesthetic. 9:16. 3 seconds.
-```

package/assets/worker-kits/creative-strategist-v1/templates/scene-modules/hooks/villain-hook.md

@@ -1,134 +0,0 @@
-# Scene Module: Villain Character Hook
-> ID: `villain-hook`
-> Type: hook (Scene 1)
-> Compatible Formats: `villain-animation`
-> Status: ✅ PROVEN — Clarifion ODRx brief (Scenes 1–5 villain format)
-
----
-
-## WHAT IT DOES
-
-Opens with animated villain characters — the failing/competing products rendered as cartoon objects with expressive faces and small arms — standing in the problem environment. Establishes the enemy and the frustration in one visual before a single word of VO plays. The viewer's problem is externalised as a villain, not their own failure.
-
-**Why it works:** Villain characters make the problem feel conquerable. When a litter bag or a scented plug-in has a smug face, the viewer's frustration has a target. The animated format also bypasses competitor brand legal concerns while being more memorable than live footage. The emotional shorthand is immediate: chaotic + dark + villain face = "I know exactly what this is."
-
----
-
-## VISUAL DIRECTION
-
-```
-Setting:  [PROBLEM_ENVIRONMENT] — the place where the problem lives.
-          e.g. wall outlets (air quality), litter box area (pet odor), bathroom sink (skincare)
-          Color palette: dark, cool, slightly chaotic. Contrasts sharply with the hero scenes.
-
-Villain:  [VILLAIN_CHARACTER] — animated version of the competing/failed product.
-          Has: expressive face (smug, angry, mocking), small stubby arms, exaggerated emotions.
-          Positioned: center frame, between 2–3 other failed products.
-          Animation: slight idle bounce or arm-wave — alive and antagonistic.
-
-Animals/characters: If relevant to category — present and frustrated/unhappy.
-                    Positioned near the villain (reinforces the problem, not the solution).
-```
-
-**Villain design by category:**
-- Air quality / odor: Animated scented plug-in with smug face between 3 wall outlets
-- Pet behavior: Litter bag villain inside/near litter box. Clay, crystal, enzyme cleaner villains.
-- Supplement / pill: Pill bottle villain with exaggerated grimace. Supplement jar. 
-- Skincare: Cream jar or serum bottle with frustrated face. "Still not working" energy.
-- Home cleaning: Spray bottle villain, baking soda box, mop — all with villain faces.
-
----
-
-## ON-SCREEN TEXT
-
-```
-Style:  Karaoke word-by-word — 1–4 words at a time. Key word highlighted in brand accent color.
-        This is the ONLY text rhythm for this format. Do not use full sentences.
-
-Hook line template:
-  "[WHY NOTHING] / [CHANGED] / [AND YOU HAVE] / [MIGHT WORK] / [WE RAN OUT]"
-  (each chunk = one karaoke beat, ~0.5–1 second each)
-
-Examples:
-  "WHY NOTHING / WORKED" → "AND YOU SPENT" → "$[AMOUNT]" → "TRYING"
-  "STILL HAPPENING" → "EVERY SINGLE" → "DAY"
-  "YOU'VE TRIED" → "EVERYTHING" → "NOTHING STICKS"
-```
-
----
-
-## ACTOR/VO DIALOGUE
-
-```
-This format uses VOICEOVER (not on-camera creator). The VO speaks over the animation.
-
-Pattern: [addresses viewer's frustration directly] + [acknowledges failed attempts] + [implies answer is coming]
-
-Templates:
-  "Why nothing changed — and you have [FAILED_PRODUCT_1], [FAILED_PRODUCT_2], and [FAILED_PRODUCT_3]..."
-  "You've tried everything. And [VILLAIN] is still there every single morning."
-  "Still happening. Even after [DOLLAR_AMOUNT] and [TIME_SPENT]."
-
-Delivery: Direct, slightly conspiratorial. NOT an announcer. Voice of a peer who's been there.
-          Pace matches the karaoke text rhythm — one thought per beat.
-```
-
----
-
-## BRAND-KIT PLACEHOLDERS
-
-| Placeholder | Source | Example |
-|-------------|--------|---------|
-| `[PROBLEM_ENVIRONMENT]` | `brand-kit.md → target_pain_point` | "wall outlets + living room" |
-| `[VILLAIN_CHARACTER]` | Brief content / category | "animated scented plug-in with smug face" |
-| `[FAILED_PRODUCT_1/2/3]` | Brief content | "Enzyme Cleaner, Scented Plug-In, Clay Litter" |
-| `[DOLLAR_AMOUNT]` | Brief content | "$300" |
-| `[BRAND_ACCENT_COLOR]` | `brand-kit.md → colors.secondary` | "2C7FF8" (Clarifion blue) |
-
----
-
-## HOOK VARIATIONS FOR THIS MODULE (5 A–E)
-
-```
-Hook A — "Why Nothing Changed" (direct muse mirror)
-  VO: "Why nothing changed — and you've tried [FAILED_1], [FAILED_2], [FAILED_3]..."
-  Villain: center frame, mocking expression, surrounded by competing products
-
-Hook B — "You've Spent [AMOUNT]"
-  VO: "You've spent [AMOUNT] on [CATEGORY]. And [PROBLEM] is still there."
-  Villain: inside/on the failed product, arms raised triumphantly
-
-Hook C — "Every Morning / Every Night"
-  VO: "Every single [morning/night]. Same problem. Different product. Nothing works."
-  Villain: animated in daily-loop — same scene repeating
-
-Hook D — "The Thing That Actually Works"
-  VO: "The thing that actually works isn't what they keep selling you."
-  Villain: running away from incoming hero product light (tone flip tease)
-
-Hook E — "You Gave Up Too Soon"
-  VO: "You didn't give up. The products gave up on you."
-  Villain: visually failing/broken — villainizes the product, not the viewer
-```
-
----
-
-## JS STUB (hookCard)
-
-```js
-hookCard("A", "Villain Hook — Direct Muse Mirror",
-  "VISUAL: Animated [PROBLEM_ENVIRONMENT]. [VILLAIN_CHARACTER] center frame with smug/angry face + small arms.\n" +
-  "2–3 competing products visible around it. [ANIMAL/CHARACTER] unhappy nearby. Dark, chaotic color palette.\n\n" +
-  "ON-SCREEN TEXT (karaoke): '[WHY_NOTHING]' → '[CHANGED]' → '[AND_YOU_HAVE]' — key word in [ACCENT_COLOR].\n\n" +
-  "VO: '[HOOK_A_LINE]'\n\n" +
-  "NOTE: Identical villain format to muse. Test first."
-)
-```
-
----
-
-## AI GENERATION PROMPT STUB
-
-```
-3D animated [PROBLEM_ENVIRONMENT]. [VILLAIN_CHARACTER] with expressive cartoon face (smug/angry) and small stubby arms, positioned center frame. 2–3 other [FAILED_PRODUCTS] rendered as villain characters surrounding it. [ANIMAL/CHARACTER] in background looking frustrated/unhappy. Dark, cool, slightly chaotic color palette. Karaoke text overlaid word-by-word in white with [ACCENT_COLOR] highlight on key word. Animated villain has slight idle bounce. 9:16. 15–17 seconds.
-```

package/assets/worker-kits/creative-strategist-v1/templates/self-eval.md

@@ -1,67 +0,0 @@
-# Self-evaluation template — v1 primitive (Growthub, capability-agnostic)
-
-A skill's `selfEval` contract declares **what good looks like** (`criteria[]`) and **the retry ceiling** (`maxRetries`). The agent drives the loop; this file is the pattern the agent follows at every unit of work.
-
-The contract is defined in `@growthub/api-contract/skills::SkillSelfEval` and is **capability-agnostic** — the same primitive applies to code edits, copy drafts, CRM rules, API payloads, asset renders, audit passes, and every other domain. The "unit of work" is the smallest reversible change the skill operates on; concrete boundaries are defined in the kit's own `skills.md` operator runbook, not here.
-
-## Loop
-
-```
-for attempt in 1..maxRetries:          # default maxRetries = 3
-  generate       — produce a proposal (whatever the skill produces)
-  apply          — materialise the proposal against the fork
-  self-evaluate  — for each criterion in skill.selfEval.criteria:
-                     check → pass / fail / needs-confirmation
-  record         — append to project.md (human) + trace.jsonl (machine)
-
-  if all criteria pass: break
-  if attempt == maxRetries: park with needs_confirmation note. Stop.
-```
-
-## What each attempt writes
-
-### Human row — append to `.growthub-fork/project.md` "Session log"
-
-```md
-### 2026-04-23 18:40 UTC · <skill-slug>
-- **Plan.** What you intend to do this unit of work.
-- **Changes.** Material change applied (must correspond to a trace event).
-- **Self-eval.** attempt 2/3 — criterion "<one of skill.selfEval.criteria>" ✗ (<note>). Retrying.
-- **Outcome.** retry-pending / pass / parked.
-- **Next.** What the next attempt (or next session) should pick up.
-```
-
-### Machine row — append to `.growthub-fork/trace.jsonl` (via `appendKitForkTraceEvent`)
-
-```json
-{
-  "ts": "2026-04-23T18:40:00.000Z",
-  "forkId": "<fork-id>",
-  "kitId": "<kit-id>",
-  "type": "self_eval_recorded",
-  "summary": "attempt 2/3 failed on <criterion>",
-  "detail": {
-    "skill": "<skill-slug>",
-    "attempt": 2,
-    "maxRetries": 3,
-    "criterion": "<one of skill.selfEval.criteria>",
-    "outcome": "fail",
-    "notes": "<short explanation>"
-  }
-}
-```
-
-## Hard rules
-
-1. **Never exceed `maxRetries`.** At the ceiling, park with a `needs_confirmation` note and stop. Do not loop forever.
-2. **Record every attempt.** Even the first pass. Continuity depends on a complete journal.
-3. **Keep `project.md` and `trace.jsonl` in sync.** One without the other is a protocol violation.
-4. **Preserve prior entries.** Append-only. Never rewrite history.
-
-## Bound the blast radius
-
-Evaluate at the smallest unit of work the skill operates on, not only at the end of a multi-step run. The retry ceiling applies to that unit — so a bad attempt does not sink the whole job.
-
-What counts as a "unit of work" is **kit-specific** and lives in that kit's `skills.md` operator runbook — not in this agnostic template. A kit picks its own smallest reversible boundary and documents it in `skills.md`; this template does not prescribe one.
-
-The agnostic SDK (`@growthub/api-contract/skills::SkillSelfEval`) does not encode any domain-specific boundaries — it only carries `criteria[]`, `maxRetries`, and `traceTo`. See `SKILL.md::selfEval.criteria` in this kit for the concrete checks, and `skills.md` for the kit-specific unit of work.