fix(tui): split hero scenes out of lock_boards

Move HeroScene/paint_hero into readme_hero_boards so lock_boards stays
under its main-line count and the source-policy gate stops regressing.
Banner-green focus is unchanged.

Co-authored-by: Mathis <echobt@users.noreply.github.com>

Author: cursoragent

src/cortex-tui/src/lib.rs

@@ -104,6 +104,7 @@ pub mod lock_boards;
 pub mod lock_proof;
 pub mod lock_v2;
 pub mod readme_hero;
+pub mod readme_hero_boards;
 
 // Backtracking system for conversation history navigation
 pub mod backtrack;

src/cortex-tui/src/lock_boards.rs

@@ -822,58 +822,34 @@ fn paint_launch_header(area: Rect, buf: &mut Buffer, full: bool) -> u16 {
 // Boards 01–10
 // ---------------------------------------------------------------------------
 
+fn paint_splash_chrome(area: Rect, buf: &mut Buffer, composer: Composer<'_>) {
+    let y = paint_launch_header(area, buf, true);
+    paint_composer(area, buf, y, composer);
+    paint_footer(area, buf, &format!("{MODEL} · Agent · 100% context"));
+}
+
 fn board_splash(area: Rect, buf: &mut Buffer) {
-    paint_hero(area, buf, HeroScene::Splash);
+    paint_splash_chrome(area, buf, Composer::Ghost(GHOST_IDLE));
 }
 
 fn board_typing(area: Rect, buf: &mut Buffer) {
-    paint_hero(area, buf, HeroScene::Typing(USER_PROMPT));
-}
-
-/// README hero beat: signed splash, typing, working, then local command boards.
-#[derive(Debug, Clone, Copy)]
-pub enum HeroScene<'a> {
-    /// Dual-hairline splash with the idle placeholder.
-    Splash,
-    /// Splash chrome with `text` in the composer (partial or full prompt).
-    Typing(&'a str),
-    /// Submitted prompt plus the working indicator.
-    Working,
-    /// Slash palette (`/` typed) — local commands, not a cloud handoff.
-    Palette,
-    /// `/model` picker with effort radios.
-    Model,
-    /// Live Shell tool row (`✓` mint on passing tests).
-    Shell,
-    /// Back to the idle composer after the first user turn (no welcome card).
-    Composer,
-}
-
-/// Paint one README-hero / lock frame from the signed chrome.
-pub fn paint_hero(area: Rect, buf: &mut Buffer, scene: HeroScene<'_>) {
-    match scene {
-        HeroScene::Splash => {
-            let y = paint_launch_header(area, buf, true);
-            paint_composer(area, buf, y, Composer::Ghost(GHOST_IDLE));
-            paint_footer(area, buf, &format!("{MODEL} · Agent · 100% context"));
-        }
-        HeroScene::Typing(text) => {
-            let y = paint_launch_header(area, buf, true);
-            paint_composer(area, buf, y, Composer::Typed(text));
-            paint_footer(area, buf, &format!("{MODEL} · Agent · 100% context"));
-        }
-        HeroScene::Working => board_working(area, buf),
-        HeroScene::Palette => board_palette(area, buf),
-        HeroScene::Model => board_model_full(area, buf),
-        HeroScene::Shell => board_shell(area, buf),
-        HeroScene::Composer => paint_session(
-            area,
-            buf,
-            user_prompt_lines(area),
-            &format!("{MODEL} · Agent · 92% context"),
-            GHOST_IDLE,
-        ),
-    }
+    paint_splash_chrome(area, buf, Composer::Typed(USER_PROMPT));
+}
+
+/// README hero typing frames use a partial prompt; lock board 02 uses the full one.
+pub(crate) fn paint_typed_splash(area: Rect, buf: &mut Buffer, text: &str) {
+    paint_splash_chrome(area, buf, Composer::Typed(text));
+}
+
+/// README hero return-to-composer beat: past user turn + idle ghost, no splash.
+pub(crate) fn paint_hero_composer(area: Rect, buf: &mut Buffer) {
+    paint_session(
+        area,
+        buf,
+        user_prompt_lines(area),
+        &format!("{MODEL} · Agent · 92% context"),
+        GHOST_IDLE,
+    );
 }
 
 const PALETTE_ROWS: &[(&str, &str)] = &[

src/cortex-tui/src/readme_hero.rs

@@ -12,7 +12,8 @@ use cortex_tui_capture::{
 };
 use ratatui::widgets::Clear;
 
-use crate::lock_boards::{self, HeroScene, USER_PROMPT};
+use crate::lock_boards::USER_PROMPT;
+use crate::readme_hero_boards::{self, HeroScene};
 
 /// The prompt the hero types — same copy as the typing lock board.
 pub const HERO_PROMPT: &str = USER_PROMPT;
@@ -32,7 +33,7 @@ fn paint_beat(scene: HeroScene<'_>) -> impl FnOnce(&mut ratatui::Frame<'_>) + '_
     move |frame| {
         let area = frame.area();
         frame.render_widget(Clear, area);
-        lock_boards::paint_hero(area, frame.buffer_mut(), scene);
+        readme_hero_boards::paint_hero(area, frame.buffer_mut(), scene);
     }
 }
 

src/cortex-tui/src/readme_hero_boards.rs

@@ -0,0 +1,43 @@
+//! README hero scene dispatch. Split out of [`crate::lock_boards`] so the
+//! storyboard can grow without pushing that file past the source-policy
+//! line-count gate.
+//!
+//! Painting stays on the signed lock chrome (banner-green focus). This
+//! module does not restyle anything.
+
+use ratatui::buffer::Buffer;
+use ratatui::layout::Rect;
+
+use crate::lock_boards;
+
+/// README hero beat: signed splash, typing, working, then local command boards.
+#[derive(Debug, Clone, Copy)]
+pub enum HeroScene<'a> {
+    /// Dual-hairline splash with the idle placeholder.
+    Splash,
+    /// Splash chrome with `text` in the composer (partial or full prompt).
+    Typing(&'a str),
+    /// Submitted prompt plus the working indicator.
+    Working,
+    /// Slash palette (`/` typed) — local commands, not a cloud handoff.
+    Palette,
+    /// `/model` picker with effort radios.
+    Model,
+    /// Live Shell tool row (`✓` mint on passing tests).
+    Shell,
+    /// Back to the idle composer after the first user turn (no welcome card).
+    Composer,
+}
+
+/// Paint one README-hero / lock frame from the signed chrome.
+pub fn paint_hero(area: Rect, buf: &mut Buffer, scene: HeroScene<'_>) {
+    match scene {
+        HeroScene::Splash => lock_boards::render_lock_board("splash", area, buf),
+        HeroScene::Typing(text) => lock_boards::paint_typed_splash(area, buf, text),
+        HeroScene::Working => lock_boards::render_lock_board("working", area, buf),
+        HeroScene::Palette => lock_boards::render_lock_board("palette", area, buf),
+        HeroScene::Model => lock_boards::render_lock_board("model_full", area, buf),
+        HeroScene::Shell => lock_boards::render_lock_board("shell", area, buf),
+        HeroScene::Composer => lock_boards::paint_hero_composer(area, buf),
+    }
+}