feat(tagging+archetypes): add Pillowfort/Politics/Midrange/Toolbox tagging and unify archetype presence skip logic

code/scripts/cleanup_placeholder_examples.py

@@ -0,0 +1,61 @@
+"""Remove placeholder ' Anchor' example_commanders when real examples have been added.
+
+Usage:
+  python code/scripts/cleanup_placeholder_examples.py --dry-run
+  python code/scripts/cleanup_placeholder_examples.py --apply
+
+Rules:
+ - If a theme's example_commanders list contains at least one non-placeholder entry
+   AND at least one placeholder (suffix ' Anchor'), strip all placeholder entries.
+ - If the list becomes empty (edge case), leave one placeholder (first) to avoid
+   violating minimum until regeneration.
+ - Report counts of cleaned themes.
+"""
+from __future__ import annotations
+from pathlib import Path
+import argparse
+
+try:
+    import yaml  # type: ignore
+except Exception:  # pragma: no cover
+    yaml = None
+
+ROOT = Path(__file__).resolve().parents[2]
+CATALOG_DIR = ROOT / 'config' / 'themes' / 'catalog'
+
+def is_placeholder(s: str) -> bool:
+    return s.endswith(' Anchor')
+
+def main(dry_run: bool) -> int:  # pragma: no cover
+    if yaml is None:
+        print('PyYAML missing')
+        return 1
+    cleaned = 0
+    for p in sorted(CATALOG_DIR.glob('*.yml')):
+        data = yaml.safe_load(p.read_text(encoding='utf-8'))
+        if not isinstance(data, dict) or not data.get('display_name'):
+            continue
+        notes = data.get('notes')
+        if isinstance(notes, str) and 'Deprecated alias file' in notes:
+            continue
+        ex = data.get('example_commanders')
+        if not isinstance(ex, list) or not ex:
+            continue
+        placeholders = [e for e in ex if isinstance(e, str) and is_placeholder(e)]
+        real = [e for e in ex if isinstance(e, str) and not is_placeholder(e)]
+        if placeholders and real:
+            new_list = real if real else placeholders[:1]
+            if new_list != ex:
+                print(f"[cleanup] {p.name}: removed {len(placeholders)} placeholders -> {len(new_list)} examples")
+                cleaned += 1
+                if not dry_run:
+                    data['example_commanders'] = new_list
+                    p.write_text(yaml.safe_dump(data, sort_keys=False, allow_unicode=True), encoding='utf-8')
+    print(f"[cleanup] cleaned {cleaned} themes")
+    return 0
+
+if __name__ == '__main__':  # pragma: no cover
+    ap = argparse.ArgumentParser()
+    ap.add_argument('--apply', action='store_true')
+    args = ap.parse_args()
+    raise SystemExit(main(not args.apply))