Extract Krea cast and hardcore cleanup helpers

docs/prompt-architecture-improvement-plan.md

@@ -61,6 +61,15 @@ route-specific owner. It also preserves ordinary words such as `composition`
 inside normal sentences; empty field-label cleanup is limited to standalone
 labels.
 
+Shared hardcore phrase cleanup now has one home:
+
+- `hardcore_text_cleanup.py`
+
+It owns environment-anchor normalization used by both prompt generation and
+Krea formatting, including malformed surface joins and bed/sheet/couch anchors
+that should become model-neutral body-support language. It must stay
+route-neutral: no Krea prose, no SDXL tags, and no category selection logic.
+
 Current integration points:
 
 - `prompt_builder.build_prompt`
@@ -95,8 +104,9 @@ Already isolated:
 - camera-scene prose and coworking composition adaptation live in
   `scene_camera_adapters.py`; `prompt_builder.py` still owns camera config
   parsing and row mutation.
-- shared hardcore environment-anchor cleanup normalizes malformed pool joins
-  such as `on against a wall` before metadata reaches formatter routes.
+- shared hardcore environment-anchor cleanup lives in
+  `hardcore_text_cleanup.py` and normalizes malformed pool joins before metadata
+  reaches formatter routes.
 
 ### Pair / Adapter Layer
 
@@ -125,17 +135,21 @@ Owner: `krea_formatter.py`.
 Keep here:
 
 - Krea prose style;
-- cast prose;
 - hardcore action sentence rewriting;
 - POV sentence rewriting;
 - clothing naturalization;
 - camera-scene preservation;
 - fallback text parsing.
 
+Already isolated:
+
+- `krea_cast.py` owns cast descriptor parsing, cast prose, label joining, and
+  natural label replacement for formatter routes.
+
 Improve later:
 
 - split semantic blocks into modules:
-  `krea_cast.py`, `krea_actions.py`, `krea_pov.py`, `krea_clothing.py`;
+  `krea_actions.py`, `krea_pov.py`, `krea_clothing.py`;
 - add route-level smoke fixtures for representative metadata rows;
 - make `_hardcore_action_sentence` dispatch by action family instead of long
   conditional chains.
@@ -316,7 +330,8 @@ Medium-term:
 
 ## Recommended Next Passes
 
-1. Split Krea action/POV/clothing helpers into separate modules.
+1. Split Krea action/POV/clothing helpers into separate modules, using
+   `krea_cast.py` as the pattern for stable import aliases and smoke coverage.
 2. Split `__init__.py` node classes by family after behavior is covered by smoke
    checks.
 3. Add metadata fields such as `action_family` / `position_family` to reduce

docs/prompt-pool-routing-map.md

@@ -84,7 +84,7 @@ These recipes identify the intended road before editing prompt text.
 | --- | --- | --- | --- |
 | Keep character/location but change only sexual pose | `Global Seed` or fixed seed config -> builder/pair | Keep `person_seed` and `scene_seed` fixed; change `pose_seed` and usually `role_seed`; for hardcore categories check `content_seed_axis` | `sexual_poses.json`, `hardcore_position_config`, Krea `_hardcore_action_sentence` |
 | Generate a specific hardcore oral/blowjob scene | `Hardcore Position Pool` -> `Hardcore Action Filter` -> `Insta/OF Prompt Pair` or `Prompt Builder` | Use `focus=oral_only` or disable non-oral families; keep `allow_oral=true`; constrain position pool to kneeling/standing/oral variants when needed | `sexual_poses.json` oral subcategory/templates, `_apply_hardcore_position_config_to_subcategory`, `_hardcore_action_sentence` |
-| Generate POV oral or POV penetration | `Man Slot` with POV presence -> `character_cast` -> pair/builder -> Krea2 formatter | POV man must be in the cast; use metadata into Krea2; normal camera directive is suppressed by POV | `_pov_hardcore_pose_sentence`, `_pov_action_phrase`, `_cast_prose` omit-label handling |
+| Generate POV oral or POV penetration | `Man Slot` with POV presence -> `character_cast` -> pair/builder -> Krea2 formatter | POV man must be in the cast; use metadata into Krea2; normal camera directive is suppressed by POV | `_pov_hardcore_pose_sentence`, `_pov_action_phrase`, `krea_cast.cast_prose` omit-label handling |
 | Generate porn-scene interaction beats | `Hardcore Position Pool` -> `Hardcore Action Filter` -> pair/builder | Use `focus=interaction_only` for kissing/body worship/transitions/guidance/camera/watching/aftercare, or `focus=manual_only` for fingering/clit/manual stimulation; constrain keys such as `camera_showing`, `wrist_pinning`, `fingering`, `aftercare` | `sexual_poses.json` interaction/manual subcategories, `_role_graph`, Krea `_is_foreplay_text` / `_hardcore_action_sentence` |
 | Same woman, same room, softcore and hardcore outputs | `Character Slot/Profile` -> `Insta/OF Options` -> `Insta/OF Prompt Pair` | `continuity=same_creator_same_room`; set `softcore_cast` as needed; use pair metadata into formatter | `build_insta_of_pair`, `softcore_row`, `hardcore_row`, pair metadata fields |
 | Same cast in softcore and hardcore | Character slot chain -> `Insta/OF Options` | `softcore_cast=same_as_hardcore`; configure partner slots/outfits if needed | `_insta_of_partner_styling`, character slot clothing, pair Krea branch |
@@ -715,6 +715,7 @@ pair metadata through the core Python APIs, then verifies:
 | Trigger missing in Krea2 fallback | `format_krea2_prompt` preserve-trigger fallback behavior. |
 | SDXL tags too weak/wrong style | `sdxl_formatter.py` presets and `_row_core_tags` / `_soft_tags` / `_hard_tags`. |
 | Duplicate punctuation, empty labels, repeated trigger, repeated tag item | `prompt_hygiene.py`, then the route-specific formatter if the repeated content is semantic. |
+| Bed/sheet/couch or malformed surface wording leaks into hardcore prompts | `hardcore_text_cleanup.py`, then the relevant category pool/template. |
 | Saved profile does not match liked character | Profile save/load path and whether the saved input is row metadata or regenerated slot config. |
 | Accumulator preview behavior wrong | `loop_nodes.py` accumulator methods and `web/accumulator_preview.js`. |