AI turns documents or topics into real, native PowerPoint decks—with native shapes, transitions and animations, data-backed charts and tables on demand, audio narration from speaker notes, and support for your own .pptx templates. · by Hugo He
feat(beautify): add bounded inventory views
hugohe3a683e7c871c9
diff --git a/skills/ppt-master/scripts/beautify_inventory.py b/skills/ppt-master/scripts/beautify_inventory.pyindex 40240f3c..2ef53fd7 100644--- a/skills/ppt-master/scripts/beautify_inventory.py+++ b/skills/ppt-master/scripts/beautify_inventory.py@@ -11,10 +11,14 @@ to fill with judgment (hidden shapes, combo charts, overcrowded pages, ...).Usage:python3 scripts/beautify_inventory.py <slide_library.json> [--images <image_manifest.json>] [-o inventory.json]+ python3 scripts/beautify_inventory.py <inventory.json> --summary+ python3 scripts/beautify_inventory.py <inventory.json> --page N [--with-geometry]Examples:python3 scripts/beautify_inventory.py projects/x/analysis/<stem>.slide_library.json \--images projects/x/images/image_manifest.json -o projects/x/analysis/beautify_inventory.json+ python3 scripts/beautify_inventory.py projects/x/analysis/beautify_inventory.json --summary+ python3 scripts/beautify_inventory.py projects/x/analysis/beautify_inventory.json --page 7Dependencies:None (standard library only).@@ -28,13 +32,23 @@ import argparseimport jsonimport sysfrom pathlib import Path-from typing import Optional+from typing import Any, Optionalfrom console_encoding import configure_utf8_stdioconfigure_utf8_stdio()+_GEOMETRY_KEYS = {+ "geometry",+ "display_ratio",+ "display_left_emu",+ "display_top_emu",+ "display_width_emu",+ "display_height_emu",+}++def _images_by_slide(manifest: list) -> dict[int, list[dict]]:"""Map slide_index -> [image entries on that slide], from ppt_to_md occurrences."""by_slide: dict[int, list[dict]] = {}@@ -138,35 +152,172 @@ def build_inventory(slide_library: dict, images_by_slide: dict[int, list[dict]])}+def _view_payload(inventory: dict, view: str, slides: list[dict]) -> dict:+ """Wrap projected slides with the canonical deck-level facts."""+ return {+ "schema": "beautify_inventory.view.v1",+ "inventory_schema": inventory.get("schema", "beautify_inventory.v1"),+ "view": view,+ "source": inventory.get("source"),+ "slide_count": inventory.get("slide_count", len(inventory.get("slides", []))),+ "canvas_px": inventory.get("canvas_px"),+ "slides": slides,+ }+++def _summary_view(inventory: dict) -> dict:+ """Project the whole roster into compact per-slide counts and review flags."""+ slides = []+ for slide in inventory.get("slides", []):+ slides.append({+ "slide_index": slide.get("slide_index"),+ "page_type": slide.get("page_type"),+ "text_block_count": len(slide.get("text_blocks", [])),+ "table_count": len(slide.get("tables", [])),+ "chart_count": len(slide.get("charts", [])),+ "diagram_count": len(slide.get("diagrams", [])),+ "image_count": len(slide.get("images", [])),+ "ignored": slide.get("ignored", []),+ "needs_confirmation": slide.get("needs_confirmation", []),+ })+ return _view_payload(inventory, "summary", slides)+++def _without_geometry(value: Any) -> Any:+ """Remove explicit source-layout geometry while preserving content and data."""+ if isinstance(value, dict):+ return {+ key: _without_geometry(item)+ for key, item in value.items()+ if key not in _GEOMETRY_KEYS+ }+ if isinstance(value, list):+ return [_without_geometry(item) for item in value]+ return value+++def _page_view(inventory: dict, slide_index: int, with_geometry: bool) -> Optional[dict]:+ """Project one slide by its canonical slide_index."""+ for slide in inventory.get("slides", []):+ if slide.get("slide_index") != slide_index:+ continue+ projected = slide if with_geometry else _without_geometry(slide)+ return _view_payload(inventory, "page", [projected])+ return None+++def _positive_int(value: str) -> int:+ """Parse a positive slide index for argparse."""+ parsed = int(value)+ if parsed < 1:+ raise argparse.ArgumentTypeError("page must be a positive integer")+ return parsed++def build_parser() -> argparse.ArgumentParser:parser = argparse.ArgumentParser(- description="Merge slide_library.json + image_manifest.json into a per-slide beautify inventory.",+ description=(+ "Build a beautify inventory from a slide library, or print a read-only "+ "model view from a canonical beautify inventory."+ ),formatter_class=argparse.RawDescriptionHelpFormatter,)- parser.add_argument("slide_library", help="slide_library.json from `template_fill_pptx.py analyze`")- parser.add_argument("--images", help="image_manifest.json from `ppt_to_md.py` (optional)")- parser.add_argument("-o", "--output", help="Write JSON here (default: stdout)")+ parser.add_argument(+ "input_json",+ help="slide_library.json in builder mode, or beautify_inventory.v1 JSON in a view mode",+ )+ parser.add_argument(+ "--images",+ help="image_manifest.json for a slide_library input (optional)",+ )+ parser.add_argument(+ "-o",+ "--output",+ help="Write the full built inventory here (builder mode only; default: stdout)",+ )+ view_group = parser.add_mutually_exclusive_group()+ view_group.add_argument(+ "--summary",+ action="store_true",+ help="Print deck facts, per-slide object counts, and review flags to stdout",+ )+ view_group.add_argument(+ "--page",+ type=_positive_int,+ metavar="N",+ help="Print one slide's frozen content/data by slide_index to stdout",+ )+ parser.add_argument(+ "--with-geometry",+ action="store_true",+ help="Retain source-layout geometry in a --page view",+ )return parserdef main(argv: Optional[list[str]] = None) -> int:- args = build_parser().parse_args(argv)+ parser = build_parser()+ args = parser.parse_args(argv)++ view_requested = args.summary or args.page is not None+ if view_requested and args.output:+ parser.error("--summary/--page write to stdout and cannot be combined with --output")+ if args.with_geometry and args.page is None:+ parser.error("--with-geometry requires --page")- lib_path = Path(args.slide_library)- if not lib_path.is_file():- print(f"[ERROR] slide_library not found: {lib_path}", file=sys.stderr)+ input_path = Path(args.input_json)+ if not input_path.is_file():+ print(f"[ERROR] input JSON not found: {input_path}", file=sys.stderr)return 1- slide_library = json.loads(lib_path.read_text(encoding="utf-8"))+ input_data = json.loads(input_path.read_text(encoding="utf-8"))++ input_schema = input_data.get("schema")+ if input_schema == "beautify_inventory.view.v1":+ parser.error(+ "beautify_inventory.view.v1 is a read-only stdout projection and "+ "cannot be used as input"+ )+ is_inventory = input_schema == "beautify_inventory.v1"+ if is_inventory and not view_requested:+ parser.error(+ "beautify_inventory.v1 input requires --summary or --page; "+ "builder mode requires slide_library.json"+ )+ if is_inventory and args.images:+ parser.error("--images cannot be combined with a beautify_inventory.v1 input")+ if view_requested and not is_inventory:+ parser.error("--summary/--page require a canonical beautify_inventory.v1 input")manifest: list = []- if args.images:+ if args.images and not is_inventory:img_path = Path(args.images)if not img_path.is_file():print(f"[ERROR] image manifest not found: {img_path}", file=sys.stderr)return 1manifest = json.loads(img_path.read_text(encoding="utf-8"))- inventory = build_inventory(slide_library, _images_by_slide(manifest))+ inventory = input_data if is_inventory else build_inventory(+ input_data,+ _images_by_slide(manifest),+ )++ if args.summary:+ print(json.dumps(_summary_view(inventory), ensure_ascii=False, indent=2))+ return 0+ if args.page is not None:+ page_view = _page_view(inventory, args.page, args.with_geometry)+ if page_view is None:+ available = ", ".join(+ str(slide.get("slide_index"))+ for slide in inventory.get("slides", [])+ )+ print(+ f"[ERROR] slide_index {args.page} not found; available: {available or 'none'}",+ file=sys.stderr,+ )+ return 1+ print(json.dumps(page_view, ensure_ascii=False, indent=2))+ return 0payload = json.dumps(inventory, ensure_ascii=False, indent=2)if args.output: