@danhachuel/thunderbolt 0.4.24 → 0.4.25

package/hermes_ui/storage.py

@@ -368,8 +368,17 @@ def seed_blueprints() -> None:
             shutil.copy2(source, target)
     pair_source = SEED_BLUEPRINTS / "thumbnail_blueprint_pairs.json"
     pair_target = BLUEPRINTS / "thumbnail_blueprint_pairs.json"
-    if pair_source.exists() and not pair_target.exists():
-        shutil.copy2(pair_source, pair_target)
+    if pair_source.exists():
+        try:
+            seeded_pairs = json.loads(pair_source.read_text(encoding="utf-8"))
+            current_pairs = json.loads(pair_target.read_text(encoding="utf-8")) if pair_target.exists() else {}
+            if isinstance(seeded_pairs, dict) and isinstance(current_pairs, dict):
+                merged_pairs = {**seeded_pairs, **current_pairs}
+                if merged_pairs != current_pairs:
+                    atomic_write(pair_target, merged_pairs)
+        except (OSError, UnicodeError, json.JSONDecodeError):
+            if not pair_target.exists():
+                shutil.copy2(pair_source, pair_target)
 
 
 def seed_prompt_masters() -> None:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danhachuel/thunderbolt",
-  "version": "0.4.24",
+  "version": "0.4.25",
   "description": "Thunderbolt — interface local para operação de canais faceless e motor MoneyPrinterTurbo",
   "license": "MIT",
   "main": "scripts/cli.mjs",

package/scripts/install.mjs

@@ -143,7 +143,17 @@ function copySeedBlueprints(storageRoot) {
   }
   const pairSource = join(seedRoot, "thumbnail_blueprint_pairs.json");
   const pairTarget = join(storageRoot, "blueprints", "thumbnail_blueprint_pairs.json");
-  if (existsSync(pairSource) && !existsSync(pairTarget)) copyFileSync(pairSource, pairTarget);
+  if (existsSync(pairSource)) {
+    try {
+      const seededPairs = JSON.parse(readFileSync(pairSource, "utf8"));
+      const currentPairs = existsSync(pairTarget) ? JSON.parse(readFileSync(pairTarget, "utf8")) : {};
+      if (seededPairs && currentPairs && typeof seededPairs === "object" && typeof currentPairs === "object") {
+        writeFileSync(pairTarget, JSON.stringify({ ...seededPairs, ...currentPairs }, null, 2) + "\n", "utf8");
+      }
+    } catch {
+      if (!existsSync(pairTarget)) copyFileSync(pairSource, pairTarget);
+    }
+  }
 }
 
 function copySeedPromptMasters(storageRoot) {

package/seed/blueprints/thumbnail_blueprint_pairs.json

@@ -1,4 +1,9 @@
 {
   "BLUEPRINTCANALMILITAR": "Militar_Thumbnail_Blueprint",
-  "MILITAR": "Militar_Thumbnail_Blueprint"
+  "MILITAR": "Militar_Thumbnail_Blueprint",
+  "blueprintcanalfinanças": "FINANCE_Thumbnail_Blueprint",
+  "blueprintcanalfinancas": "FINANCE_Thumbnail_Blueprint",
+  "BLUEPRINT CANAL FINANÇAS": "FINANCE_Thumbnail_Blueprint",
+  "FINANÇAS": "FINANCE_Thumbnail_Blueprint",
+  "FINANCAS": "FINANCE_Thumbnail_Blueprint"
 }

package/seed/blueprints/thumbnails/FINANCE_Thumbnail_Blueprint.md

@@ -0,0 +1,193 @@
+🔒 STYLE LOCK — NON-NEGOTIABLE
+
+Clean, educational whiteboard/animation-style thumbnails for personal finance content. The visual language is approachable, simplified, and focused on breaking down complex money topics into digestible visuals. Thumbnails feature a consistent animated character (Nick) as the host, surrounded by financial symbols, charts, and money-related iconography. The overall vibe is friendly, trustworthy, and educational — not aggressive, not overly polished/realistic, and never cluttered.
+
+❌ Not allowed:
+
+Photorealistic faces or live-action photography
+
+Dark, moody, or dramatic lighting (keep it bright and clean)
+
+Cluttered backgrounds with more than 3–4 distinct visual elements
+
+Text that exceeds 5–6 words total on the thumbnail
+
+Aggressive red "clickbait" arrows or excessive attention-grabbing graphics
+
+Stock photo-style imagery (everything should match the whiteboard/animated aesthetic)
+
+🧍‍♂️ FRAMING & POSE
+
+Primary subject: A consistent animated character representing "Nick" — a friendly, approachable male figure with a neutral-to-enthusiastic expression. The character is drawn in a simple, flat 2D illustration style consistent with whiteboard animation aesthetics.
+
+Framing: Medium shot (chest/head and shoulders) or full-body character positioned on the left or right side of the frame, leaving the opposite side for text and visual elements.
+
+Angle: Straight-on, eye-level perspective — no dramatic low or high angles. The character faces the viewer or slightly angles toward the center of the frame.
+
+Energy: Calm, confident, and informative. The character may point toward a chart, hold money, or gesture toward the text area. No extreme emotions (no shock, fear, or anger faces).
+
+Cropping: Generous breathing room around the character — never cropped tightly against the edges.
+
+🎨 BACKGROUND & LIGHTING
+
+Environment: Clean, minimal background — typically a solid or subtly gradient color (light blue, soft green, warm yellow, or white) that suggests a "whiteboard" or educational setting. Sometimes features a simple grid pattern or subtle chalkboard texture.
+
+Lighting: Flat, even, shadowless illumination — consistent with 2D animation. No dramatic shadows, no harsh highlights.
+
+Depth: Minimal — the background and foreground are clearly separated but exist on the same visual plane. No complex 3D depth or parallax.
+
+Visual noise: Extremely low. Background contains at most 1–2 supporting visual elements (e.g., a simple bar chart, a stack of coins, an upward arrow) placed behind or beside the character.
+
+🧭 IDENTIFICADORES / SÍMBOLOS DO CANAL
+
+Recurring visual symbols:
+
+Money symbols: Dollar signs ($), stacks of coins, bundles of cash
+
+Financial charts: Simple upward-trending line graphs or bar charts (green/blue)
+
+Arrows: Clean, single-direction arrows (green for up, red for down) — minimal use
+
+Icons: Piggy bank, calculator, calendar, clock (all in simple 2D icon style)
+
+The host character: A consistent illustrated "Nick" figure — the channel's recognizable mascot/personality
+
+Placement: Symbols are placed strategically around the character or integrated into the background — never overlapping the character's face or the main text.
+
+🚨 VISUAL ATTENTION ELEMENT
+
+Usage: Minimal and purposeful. The channel appears to avoid aggressive clickbait tactics.
+
+If used:
+
+A single, clean arrow (green or yellow) pointing toward the key visual or text
+
+A subtle circle or highlight around a specific element (e.g., a number, a dollar amount)
+
+No emojis, no multiple arrows, no neon glow effects
+
+Rule: Less is more. If an attention element is used, it serves to guide the viewer's eye, not to shock or overwhelm.
+
+📝 TEXT STYLE
+
+Structure:
+
+Maximum 2 lines of text
+
+Positioned on the opposite side of the character (if character is left, text is right; if character is right, text is left)
+
+Text occupies approximately 15–20% of the thumbnail area
+
+Typography:
+
+Bold, sans-serif font (e.g., Montserrat, Roboto, or similar clean geometric font)
+
+Primary text: White or bright yellow, with a dark outline or subtle shadow for contrast
+
+Secondary text (if used): Smaller, in a contrasting color (e.g., green or blue)
+
+Hierarchy:
+
+Line 1: Primary hook (largest, boldest) — 3–4 words max
+
+Line 2: Supporting context (smaller) — 2–3 words max
+
+Background for text: Optional — a semi-transparent pill-shaped or rectangular bar behind the text to ensure readability against any background.
+
+🧠 TEXT PSYCHOLOGY
+
+Tone: Curious, educational, slightly urgent but not alarmist. The text promises value and clarity — "Here's what you need to know" energy.
+
+Common psychological triggers observed/inferred:
+
+Curiosity gap: "What They Don't Tell You About..."
+
+Number/List: "3 Ways to..." / "5 Mistakes..."
+
+Direct address: "You're Doing This Wrong"
+
+Benefit-driven: "How to Save $___"
+
+Question: "Is This a Scam?"
+
+Examples of likely headline patterns:
+
+"3 Passive Income Ideas"
+
+"This One Rule Changed Everything"
+
+"Why 90% Lose Money"
+
+"How to Retire Early"
+
+"The Truth About Investing"
+
+🎯 COMPOSITION RULES
+
+Rule of thirds: Character placed on the left or right vertical third line. Text occupies the opposite side. Supporting visual elements (charts, icons) are placed in the remaining quadrants.
+
+Focal hierarchy:
+
+Primary: Character's face (human connection)
+
+Secondary: Text (the promise/hook)
+
+Tertiary: Supporting visuals (context/reinforcement)
+
+Negative space: Generous use of empty space around the character and text — nothing feels cramped.
+
+Distraction control: Maximum 3–4 distinct visual elements total (character, text, 1–2 symbols/charts).
+
+Mobile-first: Text is large enough to read on a smartphone screen. Character's face is clearly visible even at small sizes.
+
+📐 FORMAT & QUALITY
+
+Aspect ratio:
+16:9
+
+Resolution:
+1280 × 720 minimum
+
+Image style: 2D illustration / whiteboard animation style — flat colors, clean lines, no gradients or 3D rendering. The aesthetic should match "explainer video" illustration quality.
+
+Sharpness: Crisp and clear — no blur, no painterly effects.
+
+Technical restrictions: No photographic elements. No live-action footage. All elements must be in a consistent illustration style. Colors should be bright and saturated but not neon.
+
+🧠 FINAL OBJECTIVE
+
+Primary goal:
+Maximize YouTube CTR for personal finance / investing education content
+
+Target emotional triggers:
+
+Curiosity about money and investing
+
+Desire for financial security and passive income
+
+Fear of missing out on wealth-building opportunities
+
+Trust in an expert/guide figure
+
+Target audience: Beginners to intermediate investors — people looking to understand personal finance, build wealth, and manage debt in a simple, approachable way.
+
+🧾 FINAL INPUT FORMAT
+
+VIDEO TITLE:
+"[placeholder — will be filled in the next step with the actual video title/script]"
+
+⚙️ FINAL SYSTEM INSTRUCTION
+
+You are a thumbnail designer for the Nick Invests YouTube channel. Using the style guide above, generate 2–4 headline options (2–5 words each) derived from the provided VIDEO TITLE. Then create a thumbnail image that follows all style rules above:
+
+2D illustration / whiteboard animation style
+
+Nick character (animated host) on one side
+
+Clean, bright background with minimal visual noise
+
+Text on the opposite side (max 2 lines, bold sans-serif)
+
+1–2 supporting financial symbols (optional)
+
+No photographic elements, no aggressive clickbait styling