clawed 2.5.0__tar.gz → 2.5.2__tar.gz

{clawed-2.5.0 → clawed-2.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: clawed
-Version: 2.5.0
+Version: 2.5.2
 Summary: Free AI lesson planner for teachers. Learns your teaching voice from your curriculum files and generates complete lesson packages. Open source, runs locally, no subscription.
 Project-URL: Homepage, https://sirhanmacx.github.io/Claw-ED
 Project-URL: Documentation, https://github.com/SirhanMacx/Claw-ED#readme
@@ -198,6 +198,10 @@ Your curriculum files (PDF, DOCX, PPTX, and 20+ formats)
 | `clawed bot --token TOKEN` | Connect Telegram bot |
 | `clawed serve` | Web dashboard |
 | `clawed mcp-server` | MCP server (for Claude Code integration) |
+| `clawed game create "Topic" -g 8` | Generate an interactive HTML learning game |
+| `clawed game create "Topic" --style "escape room"` | Game with specific style |
+| `clawed game create "Topic" --students "they love Minecraft"` | Game matching student interests |
+| `clawed game gallery` | View all your generated games |
 | `clawed demo` | Try it without an API key |
 
 ---
@@ -248,6 +252,20 @@ Every lesson can be automatically differentiated:
 - **504 accommodations:** Extended time, preferential seating, scribe access
 - **Gifted extensions:** Deeper inquiry, independent research, cross-topic connections
 
+### Interactive Learning Games
+
+Every lesson can generate an interactive HTML game as an extension activity:
+
+```bash
+clawed game create "The Missouri Compromise" -g 8 -s "US History"
+clawed game create "Photosynthesis" -g 6 --students "they love Minecraft"
+clawed game create "The Renaissance" -g 9 --style "escape room"
+```
+
+Every game is unique — the AI designs the mechanic, visuals, and interaction from scratch based on the lesson content and your students' interests. No templates. Games are single-file HTML that works on phones, Chromebooks, and any browser.
+
+Browse community games: [Game Gallery](https://sirhanmacx.github.io/Claw-ED/games)
+
 ### Autonomous Operation
 
 Claw-ED can work while you sleep:
@@ -350,10 +368,22 @@ lesson = await generate_lesson(
 
 ---
 
+## Community
+
+Claw-ED is built by a teacher for teachers. Join the conversation:
+
+- **[GitHub Discussions](https://github.com/SirhanMacx/Claw-ED/discussions)** — share how you use Claw-ED, request features, ask questions
+- **[Report issues](https://github.com/SirhanMacx/Claw-ED/issues)** — bugs, feature requests, quality feedback
+- **[Star the repo](https://github.com/SirhanMacx/Claw-ED)** — it helps other teachers find us
+
+14,000+ installs and growing. If Claw-ED saved you prep time, tell a colleague.
+
+---
+
 ## License
 
 MIT License. Free for personal and commercial use.
 
 Built by educators, for educators.
 
-[GitHub](https://github.com/SirhanMacx/Claw-ED) | [PyPI](https://pypi.org/project/clawed/) | [Changelog](CHANGELOG.md)
+[GitHub](https://github.com/SirhanMacx/Claw-ED) | [PyPI](https://pypi.org/project/clawed/) | [Discussions](https://github.com/SirhanMacx/Claw-ED/discussions) | [Changelog](CHANGELOG.md)

{clawed-2.5.0 → clawed-2.5.2}/README.md

@@ -122,6 +122,10 @@ Your curriculum files (PDF, DOCX, PPTX, and 20+ formats)
 | `clawed bot --token TOKEN` | Connect Telegram bot |
 | `clawed serve` | Web dashboard |
 | `clawed mcp-server` | MCP server (for Claude Code integration) |
+| `clawed game create "Topic" -g 8` | Generate an interactive HTML learning game |
+| `clawed game create "Topic" --style "escape room"` | Game with specific style |
+| `clawed game create "Topic" --students "they love Minecraft"` | Game matching student interests |
+| `clawed game gallery` | View all your generated games |
 | `clawed demo` | Try it without an API key |
 
 ---
@@ -172,6 +176,20 @@ Every lesson can be automatically differentiated:
 - **504 accommodations:** Extended time, preferential seating, scribe access
 - **Gifted extensions:** Deeper inquiry, independent research, cross-topic connections
 
+### Interactive Learning Games
+
+Every lesson can generate an interactive HTML game as an extension activity:
+
+```bash
+clawed game create "The Missouri Compromise" -g 8 -s "US History"
+clawed game create "Photosynthesis" -g 6 --students "they love Minecraft"
+clawed game create "The Renaissance" -g 9 --style "escape room"
+```
+
+Every game is unique — the AI designs the mechanic, visuals, and interaction from scratch based on the lesson content and your students' interests. No templates. Games are single-file HTML that works on phones, Chromebooks, and any browser.
+
+Browse community games: [Game Gallery](https://sirhanmacx.github.io/Claw-ED/games)
+
 ### Autonomous Operation
 
 Claw-ED can work while you sleep:
@@ -274,10 +292,22 @@ lesson = await generate_lesson(
 
 ---
 
+## Community
+
+Claw-ED is built by a teacher for teachers. Join the conversation:
+
+- **[GitHub Discussions](https://github.com/SirhanMacx/Claw-ED/discussions)** — share how you use Claw-ED, request features, ask questions
+- **[Report issues](https://github.com/SirhanMacx/Claw-ED/issues)** — bugs, feature requests, quality feedback
+- **[Star the repo](https://github.com/SirhanMacx/Claw-ED)** — it helps other teachers find us
+
+14,000+ installs and growing. If Claw-ED saved you prep time, tell a colleague.
+
+---
+
 ## License
 
 MIT License. Free for personal and commercial use.
 
 Built by educators, for educators.
 
-[GitHub](https://github.com/SirhanMacx/Claw-ED) | [PyPI](https://pypi.org/project/clawed/) | [Changelog](CHANGELOG.md)
+[GitHub](https://github.com/SirhanMacx/Claw-ED) | [PyPI](https://pypi.org/project/clawed/) | [Discussions](https://github.com/SirhanMacx/Claw-ED/discussions) | [Changelog](CHANGELOG.md)

{clawed-2.5.0 → clawed-2.5.2}/clawed/__init__.py

@@ -17,7 +17,7 @@ if hasattr(sys.stderr, "reconfigure"):
     except Exception:
         pass
 
-__version__ = "2.5.0"
+__version__ = "2.5.2"
 __author__ = "Jon Maccarello & Claw-ED contributors"
 __description__ = "Personal AI teaching agent. Learns your voice, works while you sleep."
 

{clawed-2.5.0 → clawed-2.5.2}/clawed/cli.py

@@ -35,6 +35,7 @@ from clawed.commands.export import (
     _lesson_to_html,
     export_app,
 )
+from clawed.commands.game import game_app
 from clawed.commands.generate import generate_app
 from clawed.commands.queue import queue_app
 from clawed.commands.schedule_cmd import schedule_app
@@ -243,6 +244,7 @@ app.add_typer(queue_app, name="queue")
 app.add_typer(workspace_app, name="workspace")
 app.add_typer(schedule_app, name="schedule")
 app.add_typer(train_app, name="train")
+app.add_typer(game_app, name="game")
 
 # ── Register top-level commands from sub-modules ────────────────────────
 # Commands from generate_app, export_app, and bot_app are registered as

clawed-2.5.2/clawed/commands/game.py

@@ -0,0 +1,179 @@
+"""Game generation command — create interactive HTML learning games."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+import typer
+
+from clawed.commands._helpers import (
+    _safe_progress,
+    console,
+    load_persona_or_exit,
+)
+from clawed.commands._helpers import output_dir as _output_dir
+from clawed.commands._helpers import (
+    run_async as _run_async,
+)
+
+game_app = typer.Typer()
+
+
+@game_app.command("create")
+def create(
+    topic: str = typer.Argument(
+        ..., help="Lesson topic (e.g. 'The Missouri Compromise')"
+    ),
+    grade: str = typer.Option("8", "--grade", "-g", help="Grade level"),
+    subject: str = typer.Option(
+        "Social Studies", "--subject", "-s", help="Subject area"
+    ),
+    style: str = typer.Option(
+        "",
+        "--style",
+        help="Game style hint (e.g. 'Among Us impostor', 'Minecraft building', "
+        "'Jeopardy', 'escape room'). Leave empty for AI to decide.",
+    ),
+    students: str = typer.Option(
+        "",
+        "--students",
+        help="What your students are into (e.g. 'they love Fortnite', "
+        "'competitive, love team challenges')",
+    ),
+    from_lesson: Optional[str] = typer.Option(
+        None,
+        "--from-lesson",
+        "-l",
+        help="Generate game from existing lesson JSON file",
+    ),
+):
+    """Generate an interactive HTML learning game.
+
+    \b
+    From a topic (generates lesson first, then game):
+        clawed game create "The Renaissance" -g 9 -s "Global History"
+
+    With student preferences:
+        clawed game create "Photosynthesis" -g 6 --students "they love Minecraft"
+
+    With style hint:
+        clawed game create "Civil War" -g 8 --style "escape room"
+
+    From an existing lesson:
+        clawed game create "topic" --from-lesson output/lesson_01.json
+    """
+    from clawed.compile_game import compile_game
+
+    persona = load_persona_or_exit()
+
+    if from_lesson:
+        # Load existing MasterContent from lesson JSON
+
+        from clawed.master_content import MasterContent
+
+        lesson_path = Path(from_lesson)
+        if not lesson_path.exists():
+            console.print(f"[red]File not found:[/red] {from_lesson}")
+            raise typer.Exit(1)
+        master = MasterContent.model_validate_json(
+            lesson_path.read_text(encoding="utf-8")
+        )
+    else:
+        # Generate a lesson first, then make the game
+        from clawed.lesson import generate_master_content
+        from clawed.models import LessonBrief, UnitPlan
+
+        unit_plan = UnitPlan(
+            title=f"{topic} Lesson",
+            subject=subject,
+            grade_level=grade,
+            topic=topic,
+            duration_weeks=1,
+            overview=f"A lesson on {topic} for grade {grade} {subject}.",
+            essential_questions=[
+                f"What are the key concepts of {topic}?"
+            ],
+            daily_lessons=[
+                LessonBrief(
+                    lesson_number=1,
+                    topic=topic,
+                    description=f"Explore {topic}.",
+                    lesson_type="direct_instruction",
+                )
+            ],
+        )
+
+        with _safe_progress(console=console) as progress:
+            task = progress.add_task(
+                "Generating lesson content...", total=None
+            )
+            master = _run_async(
+                generate_master_content(
+                    lesson_number=1,
+                    unit=unit_plan,
+                    persona=persona,
+                )
+            )
+            progress.update(task, description="Lesson content ready!")
+
+    # Generate the game
+    out_dir = _output_dir()
+    with _safe_progress(console=console) as progress:
+        task = progress.add_task(
+            "Designing your game (every game is unique)...", total=None
+        )
+        game_path = _run_async(
+            compile_game(
+                master=master,
+                persona=persona,
+                output_dir=out_dir,
+                student_preferences=students,
+                game_style=style,
+            )
+        )
+        progress.update(task, description="Game ready!")
+
+    console.print(f"\n[green]Game created:[/green] {game_path}")
+    console.print(
+        f"[dim]Open in browser: [bold]open {game_path}[/bold][/dim]"
+    )
+
+    # Auto-open in browser
+    try:
+        import subprocess
+
+        subprocess.Popen(
+            ["open", str(game_path)],
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+        )
+    except Exception:
+        pass
+
+
+@game_app.command("gallery")
+def gallery():
+    """Open the local game gallery — all games you've generated."""
+    out_dir = _output_dir()
+    games = sorted(out_dir.glob("game_*.html"))
+
+    if not games:
+        console.print(
+            "[yellow]No games generated yet.[/yellow] "
+            "Run [bold]clawed game create \"Topic\"[/bold] to make one."
+        )
+        raise typer.Exit(0)
+
+    console.print(f"\n[bold]Your Games ({len(games)}):[/bold]\n")
+    for i, g in enumerate(games, 1):
+        name = g.stem.replace("game_", "").replace("_", " ").title()
+        size = g.stat().st_size / 1024
+        console.print(f"  {i}. {name} ({size:.0f} KB)")
+
+    console.print(
+        f"\n[dim]Games are in: {out_dir}[/dim]"
+    )
+    console.print(
+        "[dim]Open any game: [bold]open path/to/game.html[/bold][/dim]"
+    )

{clawed-2.5.0 → clawed-2.5.2}/clawed/commands/generate.py

@@ -302,7 +302,14 @@ def lesson(
         True, "--multi-agent/--single-agent",
         help="Multi-agent pipeline (researcher→writer→reviewer) for higher quality. Use --single-agent for speed.",
     ),
-    fmt: str = typer.Option("markdown", "--format", "-f", help="Export format: markdown, pptx, docx, pdf, handout"),
+    game: bool = typer.Option(
+        False, "--game/--no-game",
+        help="Also generate an interactive HTML learning game",
+    ),
+    fmt: str = typer.Option(
+        "handout", "--format", "-f",
+        help="Export: handout, docx, pptx, pdf, markdown",
+    ),
 ):
     """Generate a detailed daily lesson plan.
 
@@ -404,13 +411,14 @@ def lesson(
                 from clawed.compile_teacher import compile_teacher_view
                 from clawed.multi_agent import multi_agent_generate_master_content
                 console.print("[dim]Using multi-agent pipeline (researcher→writer→reviewer)...[/dim]")
+                _ma_config = AppConfig.load()
                 master = _run_async(
                     multi_agent_generate_master_content(
                         topic=topic,
                         grade=grade,
                         subject=subject,
                         persona=persona,
-                        config=None,
+                        config=_ma_config,
                         unit_context=kb_prompt_section,
                     )
                 )
@@ -501,6 +509,42 @@ def lesson(
         )
     )
 
+    # Generate game if requested
+    if game:
+        try:
+            from clawed.compile_game import compile_game
+            with _safe_progress(console=console) as gprog:
+                gtask = gprog.add_task(
+                    "Designing learning game...", total=None
+                )
+                game_path = _run_async(
+                    compile_game(
+                        master=daily if hasattr(daily, "vocabulary") else None,
+                        persona=persona,
+                        output_dir=_output_dir(),
+                    )
+                )
+                gprog.update(gtask, description="Game ready!")
+            if game_path:
+                console.print(
+                    f"[green]Game created:[/green] {game_path}\n"
+                    f"[dim]Open: open {game_path}[/dim]"
+                )
+        except Exception as e:
+            console.print(
+                f"[yellow]Game generation failed:[/yellow] {e}"
+            )
+
+    # Star prompt — show once per session, not every time
+    import os
+    if not os.environ.get("_CLAWED_STAR_SHOWN"):
+        os.environ["_CLAWED_STAR_SHOWN"] = "1"
+        console.print(
+            "\n[dim]Claw-ED is free and open source. "
+            "If it saved you time, consider starring the repo:[/dim]\n"
+            "[dim]  https://github.com/SirhanMacx/Claw-ED[/dim]\n"
+        )
+
 
 # ── Differentiation / IEP ────────────────────────────────────────────────