learnx-cli 0.3.0__py3-none-any.whl

learnx_cli-0.3.0.dist-info/METADATA

@@ -0,0 +1,240 @@
+Metadata-Version: 2.4
+Name: learnx-cli
+Version: 0.3.0
+Summary: Turn any Markdown document into an audio tutorial and MP4 video
+License: MIT
+Requires-Python: >=3.11
+Requires-Dist: edge-tts>=6.1
+Requires-Dist: jinja2>=3.1
+Requires-Dist: openai>=1.30
+Requires-Dist: pillow>=10.0
+Requires-Dist: playwright>=1.44
+Requires-Dist: pydub>=0.25
+Requires-Dist: pygame-ce>=2.5
+Requires-Dist: python-dotenv>=1.0
+Requires-Dist: tqdm>=4.60
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pre-commit>=3.7; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Requires-Dist: ruff>=0.4; extra == 'dev'
+Requires-Dist: types-pillow; extra == 'dev'
+Requires-Dist: types-tqdm; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# LearnX
+
+![CI](https://github.com/Yusuprozimemet/LearnX-CLI/actions/workflows/ci.yml/badge.svg)
+
+Turn any Markdown document into an audio tutorial and MP4 video from a terminal shell.
+
+<p align="center">
+  <a href="https://youtu.be/q2ugLYZxHSI">
+    <img src="https://img.youtube.com/vi/q2ugLYZxHSI/maxresdefault.jpg" alt="LearnX demo — Java Concepts tutorial" width="720" />
+  </a>
+  <br/>
+  <em>Example output: <a href="https://youtu.be/q2ugLYZxHSI">Java Concepts tutorial</a> generated from <code>learning/javaConcept.md</code></em>
+</p>
+
+```
+.md file → LLM curriculum → TTS audio → interactive player + Q&A
+                           → LLM segment plan → HTML slides → MP4 video
+```
+
+<p align="center">
+  <img src="learnX.png" alt="LearnX CLI output" />
+</p>
+
+---
+
+## Quick start
+
+```powershell
+pip install -r requirements.txt
+echo "GROQ_API_KEY=gsk_..." > tutor/.env
+playwright install chromium
+python -m tutor
+```
+
+Requires Python 3.12+, [ffmpeg](https://ffmpeg.org/download.html) in PATH.
+Free API key at [console.groq.com](https://console.groq.com).
+
+```
+LearnX > /generate notes.md    # markdown → dialogue → audio
+LearnX > /play                  # interactive player with live Q&A
+LearnX > /video                 # render slides + assemble MP4
+LearnX > /help                  # all commands
+```
+
+---
+
+## How it was built
+
+Two layers share this repository:
+
+- **LearnX CLI** (`tutor/`) — the product. Audio tutorial generator.
+- **DevLoop** (`scripts/`) — the build system. Runs Claude in Docker, manages the spec-driven development loop, orchestrates a 5-agent review pipeline.
+
+Spec-driven development — every feature started as a written specification before any
+code was written. 31 spec days across v0–v11. Full spec chain in [`specs/`](specs/).
+Full workflow documentation in [`DEVLOOP.md`](DEVLOOP.md).
+
+<p align="center">
+  <img src="agile.png" alt="Dev loop" />
+</p>
+
+---
+
+## Dev workflow
+
+Each spec day follows this loop:
+
+```
+write spec → create branch → devloop launch → review report → merge
+```
+
+Claude implements the spec inside a Docker container. When it exits, E2E tests and a
+two-phase 5-agent review run automatically. Phase 1 discovers issues and applies fixes;
+Phase 2 verifies resolution.
+
+---
+
+## One-time setup
+
+Do this once on a new machine.
+
+**1. Install Docker Desktop**
+
+Download from [docker.com/products/docker-desktop](https://www.docker.com/products/docker-desktop/).
+Open Docker Desktop and wait for the status bar to show **"Engine running"**.
+
+**2. Build the Docker image** (from the project root)
+
+```powershell
+docker build -t learnx-dev .
+```
+
+Takes 2–5 minutes. Only re-run when `requirements.txt` changes.
+
+**3. Activate the Python venv**
+
+```powershell
+.\.venv\Scripts\Activate.ps1
+```
+
+> If blocked by execution policy:
+> `Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`
+
+---
+
+## Running a spec day
+
+### Step 1 — Open Docker Desktop
+
+Make sure the status bar shows **"Engine running"** before continuing.
+
+### Step 2 — Open a PowerShell window
+
+> Must be a real PowerShell window — not inside a Claude Code session.
+
+```powershell
+cd C:\Users\yusup\LearnX-CLI
+.\.venv\Scripts\Activate.ps1
+```
+
+### Step 3 — Create the branch
+
+```powershell
+git checkout main
+git checkout -b sandbox/dayN
+```
+
+Replace `dayN` with the actual day number (e.g. `day32`).
+
+### Step 4 — Dry run
+
+```powershell
+python scripts/devloop.py --spec specs/v11/dayN.md --review --dry-run
+```
+
+Prints the commands that will run without executing anything. Check it looks right.
+
+### Step 5 — Launch
+
+```powershell
+python scripts/devloop.py --spec specs/v11/dayN.md --review
+```
+
+Claude Code opens inside the container. When you see the `>` prompt, paste the
+handoff from [`dev_setup/handoff_template.md`](dev_setup/handoff_template.md).
+
+Then walk away.
+
+### Step 6 — What happens automatically
+
+After Claude finishes and exits the container:
+
+1. **E2E smoke tests** run inside the container (ffmpeg + Playwright available)
+2. **Phase 1 review** — 3 agents discover issues and apply fixes
+3. **Phase 2 review** — 2 agents verify the fixes and check for regressions
+4. A consolidated report prints with `MERGE READY` or `NEEDS FIXES`
+
+### Step 7 — After the report
+
+If `MERGE READY`:
+
+```powershell
+git checkout main
+git pull origin main
+gh pr create --title "dayN: ..." --body "..."
+```
+
+If `NEEDS FIXES`: read the findings, fix the issues, re-run the merge gate:
+
+```powershell
+python -m pytest tutor/tests/ --ignore=tutor/tests/e2e/ -v
+python -m ruff check tutor/
+```
+
+---
+
+## Launcher modes
+
+Docker is the default. Always.
+
+| Command | Effect |
+|---|---|
+| `python scripts/devloop.py --spec X` | Docker — implement spec X, no review |
+| `python scripts/devloop.py --spec X --review` | Docker — implement X, then E2E + two-phase review |
+| `python scripts/devloop.py --version vN --review` | Docker — run all specs in vN sequentially with review |
+| `python scripts/devloop.py --version vN --serve` | Same, with live dashboard at localhost:8080 |
+| `python scripts/devloop.py --explore` | Host only — read-only, no code changes |
+| `python scripts/devloop.py --dry-run` | Print commands without executing |
+
+**`--version`** runs every spec in `specs/vN/` in day-number order. Each spec gets
+its own sandbox branch (`sandbox/vN-dayN`). Rate-limit retries and session/idle
+timeouts are handled automatically.
+
+**`--serve`** (with `--version`) starts a dashboard at `http://localhost:8080` showing
+live container output and per-spec status as the run progresses. Port is configurable
+via `--port N` or `LEARNX_DASHBOARD_PORT` env var or `devloop.toml`.
+
+**`--explore`** starts Claude on the host with read-only permissions (Read, Grep, Glob,
+git read commands). Use it to ask questions about the codebase without risking
+accidental edits.
+
+> Always use forward slashes in `--spec`: `specs/v11/day1.md` not `specs\v11\day1.md`.
+> Backslashes corrupt the path (`\v` is a vertical-tab character).
+
+---
+
+## Which model?
+
+Change model inside any Claude session with `/model`:
+
+| Model | Speed | Best for |
+|-------|-------|----------|
+| `claude-sonnet-4-6` | fast | default — most tasks |
+| `claude-opus-4-7` | slower, smarter | complex reasoning, hard bugs |
+| `claude-haiku-4-5` | fastest | simple tasks, quick lookups |

learnx_cli-0.3.0.dist-info/RECORD

@@ -0,0 +1,131 @@
+tutor/.env copy.example,sha256=dcROn6jMU2dHKVOPUc_i5JpKBhHXJqWsE1BHSneOTq4,128
+tutor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/__main__.py,sha256=LwdZqbL6h-u-5_FfyCDR0AiH6R5cKruWndS1bkoLVgs,82
+tutor/config.py,sha256=CJ0xCXVMU3EgESjPIsHxXfcL1xB4YhmlV07WPt7yjqI,4075
+tutor/conftest.py,sha256=JXlsocp46uFoEFua74DJzCAzulfaCnE83-WN5gyivhI,175
+tutor/constants.py,sha256=zbjruRK5eaBq-qQ3dKkLY3hbtlS0LR6VhcwkQua1Cg0,2277
+tutor/exceptions.py,sha256=2eXh9TMt6YjNQqZ7YwHMg-dkud2h3EsFGUKBpXHo3m4,640
+tutor/inspector.py,sha256=AOmW2COmGWmXpksy56epnB3WK_sfNOsYJlsYUNlZfn4,4174
+tutor/llm_config.toml,sha256=iUJomVSEYvxVERQGoYZXofd_ghbwmiINQSsQDHJs89A,2426
+tutor/models.py,sha256=jcTo67vOvc91pgwTUDyYHsfOZjGP50uj6DaVgIbr5qo,3170
+tutor/requirements-dev.txt,sha256=5voM8T0d6MyXIv402vAuc9I0_M9C2IpUsOGGL-uhCzE,37
+tutor/requirements.txt,sha256=8Aq8zm9Md9shhOjwduIs3nKSlLnTRurGU6Yt_SKb8Hg,230
+tutor/tutor.py,sha256=5b4vEiKXefm_jKgZMaKtw0P_WAn-7sKvG1lkA9i91U8,13582
+tutor/assets/__init__.py,sha256=rPnbm4W-eDFlf_FOFmfSMRvb2yeeHIYk5ihJMJ5IvRc,136
+tutor/assets/html/highlight-java.min.js,sha256=Fdtmy2Wmsi857HXuf2BP_WNDw_-po1eqeUdhioogqJ0,138
+tutor/assets/html/highlight-javascript.min.js,sha256=rY4Ts3W0u9v8mi5kanl-wlS7i1gElgEPBYxbQ-kPgFo,150
+tutor/assets/html/highlight-python.min.js,sha256=laW43FNREEvCXWi7wCL6tQKcfAe3bkmpneNKq6qTcNw,142
+tutor/assets/html/highlight.min.js,sha256=tRnA8YxUvcS74N8ro0nqDaDXJWAJPomnkS8VnEHP2wQ,650
+tutor/assets/html/mermaid.min.js,sha256=-LUKGnpXsOWFky3rCbwkxSxZwo_awzWR0uD2XCGEiDU,1050
+tutor/assets/html/slide_base.css,sha256=Kg9VdryXw5zLk7GVO5nvW7ibpSNc1_Og1YLbCpvhmuo,13143
+tutor/assets/html/theme-learnx-dark.css,sha256=a0OLl9rDGRWrDVBoht0rh45WIPGQa2Wf-KOK7DEfA1A,659
+tutor/assets/html/fonts/Inter-Bold.woff2,sha256=Igl2cF--wQn0PFz9zspjnpms5-UfPrZykrEF01des5s,111040
+tutor/assets/html/fonts/Inter-Regular.woff2,sha256=tvnbnkW-IPPBMSyX--5-w2t9goD4yqTVPJugQIzJmXo,108488
+tutor/assets/html/fonts/Inter-SemiBold.woff2,sha256=jlKoYdwm_0YIxQvX_4m2XQ1iFqKv57R85dhFRIEcpAA,111588
+tutor/assets/html/fonts/JetBrainsMono-Regular.woff2,sha256=qcsc2CMysjpH46EjnSXRPIbRbEIgaV40skPv-pmfRfI,92164
+tutor/audio/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/audio/audio_builder.py,sha256=xj_2HNVR_6S__E1-P79aJIFMlxUIKtfK-nwTy1duEOM,4625
+tutor/audio/sanitizer.py,sha256=8xd0c0ld_br-xuCanHSKc3n3GZbUPgy6WoOCP-PhmGM,207
+tutor/audio/tts_renderer.py,sha256=yvvEdxc0aro_23oxBZ5kSZkuLCTHYB8Ue9gWlsDb40U,1482
+tutor/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/cli/commands.py,sha256=N6-mDhbDXnynVzyv_QyYD4N0tNefnEqKKdysKbz2bOQ,15269
+tutor/cli/logo.py,sha256=kUMPwf3-e3f1lkRNqcVncGqohVSo0cJTJUc4nPUrCsE,1183
+tutor/cli/playback_commands.py,sha256=tpA2xXGhgZSFgtLNEhUfXT7kdhtVdtQ6_VhSHAN5xlA,7602
+tutor/cli/shell.py,sha256=LGrxwdvzgj6pxeJSehlN3U98GkDJMTD4jU57mxoG2g0,2690
+tutor/cli/shell_context.py,sha256=Ca8sz2eD_XH20hzcj-srG3p-32n0R6aydYsPt8IKLCQ,446
+tutor/cli/theme.py,sha256=PScWvpj6IAcAiByUlON0nqJNVhqcZ71lx2bDVwNGOlM,587
+tutor/cli/video_commands.py,sha256=Bd-hL3dZktKe1axw4iwpharo8SKvNdkb-RiTj6sa7y4,4280
+tutor/generation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/generation/assembler.py,sha256=90koNOPYCxaXTIBcBe7DH5ly0eVKs85bdWUFrhLC0gg,3170
+tutor/generation/curriculum.py,sha256=Wg3svWsGQftluGrSpYroFTr9kq_HklsjBOyfQzBtbNw,3575
+tutor/generation/dialogue.py,sha256=7t-5EryQ3W86XzKqS9AkZTAdKCaAsOMZvG3qyu_aBcM,5797
+tutor/generation/narrator.py,sha256=RCov_lFhhxQcQDtTMpVVG3wJDdqm9UWTty4ahmv0Xe4,3856
+tutor/generation/segment_parser.py,sha256=jBeXkm4DKg1XDGw2_kpTrSCCoLVNDQZxRJoLgde5cD0,6552
+tutor/generation/segment_planner.py,sha256=RlBoRn5uXI1xQFMhfYHfjKSGg_zbD5020W_sDaek-DI,6882
+tutor/generation/visual_planner.py,sha256=Lx2s8-AAruloccUfAgVjV3-tTv_tAgGGJK5_GM54wsQ,6811
+tutor/infra/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/infra/llm.py,sha256=Bl-aQuy8TmOH_v1Ll7O0Te7VYHAioNtXc7aXA1ejnkU,5145
+tutor/ingestion/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/ingestion/chunker.py,sha256=0oLMF9YzWHDcZbFvNn940axoPdTlDMPrxUriwoz2Ars,4887
+tutor/ingestion/doc_analyzer.py,sha256=Z37UJ6hP1GcNp1fAVLpGsK4AB2WZqn2cdvHArwlSvtk,1226
+tutor/ingestion/parse_content.py,sha256=9Yyd2vuwpZbsqYXqBBRXXKHxqjO6-PCiFZg4l17Yn64,454
+tutor/ingestion/summarizer.py,sha256=Ecthib5nt8NqQVYMaQrIXRGx4G30VeeU1720tNxtWK0,1599
+tutor/player/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/player/input_handler.py,sha256=XEtqlFeTgdQpVxslIat4CmvTK5pxCZ6fzGFBY_H2eys,1023
+tutor/player/player.py,sha256=itca5HjxMxJ5l7Y6kf_NTrh0pktC0fVAi-R6LAnoeHM,9778
+tutor/player/player_display.py,sha256=5Cxo7d8jbUmb54DKoYv0OYEe7Jc17WydO8_93R7sMUI,3358
+tutor/prompts/curriculum.txt,sha256=0vUhJIndOWWe8iCwQGMVep7UX_NmebAGDvhZcVhIkAo,3298
+tutor/prompts/dialogue.txt,sha256=NjKbxqSD8FRS3h74K07Rx0vnz5qFfhaj-AvP16LB7Ac,3090
+tutor/prompts/narrate.txt,sha256=nJMt8szIk4Ejm2D1tVIDxcsbk6MM1JtCQuL2dJa-4PE,1754
+tutor/prompts/qa.txt,sha256=wCBitdjVbTBK7JjgRa3bNBOXOE4LMPEDpIw_F04QflE,1064
+tutor/prompts/summarize.txt,sha256=TFaUeXR_Rw_u5kF3GYgy9G4vyQebwBg2HmSjrdVFt60,943
+tutor/prompts/visual.txt,sha256=_A1hnKiLll8gIlEaH9aTnp94w-xBV5vWJc-ZNhTedK4,3101
+tutor/prompts/visual_v3.txt,sha256=VIkr9jhgfOpQ8noyLdHgC39lchBtsJXsGH9h28F37Ac,5346
+tutor/qa/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/qa/qa.py,sha256=XcD-s1zp1om0mY2w1lBbWSqYQjG73YWEZYpLNlqEcIs,3097
+tutor/sample_docs/headingless_large.md,sha256=mXry8uIZZGo4xjChoDX7Z3hkbIJCcZiosgNsmoABieQ,219302
+tutor/sample_docs/headingless_test.md,sha256=EPLN4XOgb74YBVyMvRy074MlcWkTcDt7b6foA3Eze-g,24752
+tutor/sample_docs/java-basics.md,sha256=flmhdF0hxE5Cxa8i2AXNSVuYuBlIf9pLVqN-jvpXZCM,3046
+tutor/tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/tests/test_assets.py,sha256=m3EoJG8ek9VHcV7PR-dxxgdiNT6GStLWwpPsRCc8E6Y,842
+tutor/tests/test_models_visual.py,sha256=avIEvKt5tYR7ez7r4xdizi6Lm-7VnOhRIapWWaU89pg,5619
+tutor/tests/audio/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/tests/audio/test_audio_builder.py,sha256=Ak7YoLE0DgB4n5AvthO34rMMG_cg55Yc64D1s0hUjLY,3734
+tutor/tests/audio/test_sanitizer.py,sha256=pZ-NgYBdyEMI35jU6gUBNhOf5WbAFiYmsNBhKn80SWA,1025
+tutor/tests/cli/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/tests/cli/test_commands.py,sha256=KU0dfHEVvoV0o8PrM00rkcIMEsNK6fkNvm4cpZlMtC8,1890
+tutor/tests/cli/test_video_commands.py,sha256=RyBNshE7GnXrS_Dj8Va89ma40uHvAJYj3K5bVlFlX1I,6550
+tutor/tests/e2e/README.md,sha256=AtweOmDAZrhgz2mOQ2dmCF6_6IA7SiXM2hfeH6sCgIc,2498
+tutor/tests/e2e/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/tests/e2e/conftest.py,sha256=ZOZ2xOM9ZxGQE0dSxZbmNpmrEczHqFRAbcpnY8ajZgw,3921
+tutor/tests/e2e/test_audio_quality.py,sha256=oQwRDjWweszCNNPa-3d4RiElC9FkKpDN4OW_RejVgiE,1568
+tutor/tests/e2e/test_av_sync.py,sha256=JRZp9go6ryS_AhjawIxD1bSM5qoKkX03WZ6YXZ-CMgk,2297
+tutor/tests/e2e/test_pipeline_smoke.py,sha256=OG-UsXiuzUt2ypZ7rfRYaS4rbpC86hiAajB6SynmguA,1639
+tutor/tests/e2e/test_slide_render.py,sha256=ON9560Aqucs9GXuZNKqdLwu2CnHk8OSFhacUSKF7n6k,2852
+tutor/tests/e2e/test_video_streams.py,sha256=m6QUeQkl2gWMGM8CNit-VZVce7jeVyW5XQmEE9NbfXs,3747
+tutor/tests/e2e/fixtures/README.md,sha256=hc0UKUcpthL_0Q5uPPDJ3MwEU7u9GVQtIHlgAzMXNwc,740
+tutor/tests/e2e/fixtures/sample.md,sha256=YMBSiM0BJkTgCEWGgPx5AnvOp91no3vJ8gFaRkAAMlA,688
+tutor/tests/generation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/tests/generation/conftest.py,sha256=1VXd8IF9CqFO8ICIydhBnGvJUwEgaLaEzf4Tio3VY_o,3355
+tutor/tests/generation/test_assembler.py,sha256=lj8aY81zuv0aXI1Pcs40Ygjs1Dk7MWTVyrzivBRgbhU,2137
+tutor/tests/generation/test_curriculum.py,sha256=Vkgk7sdieKCsEwcyRxlNty2Pu0tgcOwGKM8EUD-qXWM,3067
+tutor/tests/generation/test_narrator.py,sha256=kV1va0r3e2qoEBsIn3BF_hc_w5uEziXGB-xL1ZVZjFA,5607
+tutor/tests/generation/test_segment_edge_cases.py,sha256=4kjkAtRuF1d20BXPPCzoUQDlARy99enbgWRbhZ-QV2U,9011
+tutor/tests/generation/test_segment_planner.py,sha256=Vv2yjNhCSE7zuvjt0Bv5nJLKVcut4qIkAcDYDHOIMsE,9957
+tutor/tests/generation/test_visual_planner.py,sha256=usGF-naxBSD2-7TCBcC8oXhTQPJUQE3PLYOAdvmYXTs,10155
+tutor/tests/ingestion/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/tests/ingestion/test_chunker.py,sha256=deS4xRkMialSk8Tf6JXcKeUHnVZVcCMeq7Lzxi-pku4,3318
+tutor/tests/ingestion/test_doc_analyzer.py,sha256=5Z1r_8Aw7c7a-VysjssVfjK4tJiAYMJuD9dzO2ybMak,1466
+tutor/tests/player/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/tests/player/test_player_states.py,sha256=Nx0J2JydBLmkOqjqidLWCDTHrrx9vikW1dRhl9JzMsU,2356
+tutor/tests/visual/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+tutor/tests/visual/test_beat_timer.py,sha256=hYOVJnpklxN2dDdlVHJVw6zy-SkxvO7udfvOQ2w8V5o,10908
+tutor/tests/visual/test_pipeline_integration.py,sha256=4U1Pklv55WcDBWYXlKMcDBjS3VYYMqnUtqGQXAeNMsg,6781
+tutor/tests/visual/test_slide_renderer.py,sha256=B_ydEb8geo17QwtzY7WldG-W59UgHyWBs6W0iUt8dE0,10396
+tutor/tests/visual/test_subtitle_writer.py,sha256=jf3lPhTHZMY2tFT_BA1C9UflGXKYYf8OhmcWdtE8mxs,6070
+tutor/tests/visual/test_video_assembler.py,sha256=7L4TOiyMCEy32bzvaLylc6kjw4Cbpw0OBbk4Dp5tYxg,3632
+tutor/tests/visual/test_visual_pipeline.py,sha256=jRU0ycw11-kQ4JRmu_kpcddS5iA-cD_UdSBskLPxg1Q,9093
+tutor/visual/__init__.py,sha256=aZV5pzgtcRtvSAimQM7MODVZ62fTUGqepWPNviq2mcg,7471
+tutor/visual/beat_timer.py,sha256=RxAx82i27VqUdu05VKAMhZ-VMKOB3gksA0jRxgLvgiA,8112
+tutor/visual/slide_renderer.py,sha256=-l_ewdDvefQCXOblnxGYC_jdOsyTqPBwWm_A0TOR1fQ,8105
+tutor/visual/subtitle_writer.py,sha256=nY-LZFHaTngiCwoMumBJoU4698h301oPzqsj87QQYt4,6264
+tutor/visual/video_assembler.py,sha256=9j9B8oiHfd7asTYmhc1fXFCfij9NM7RxBRXn3whuFio,7815
+tutor/visual/templates/_base.html.j2,sha256=Ck5WQHUfGTGsK6hFlF4xAEMvLNRxNCTOyAf1R6k1rHU,1384
+tutor/visual/templates/analogy.html.j2,sha256=4LOcD0nGoJSPWMdAJPDssZCti-Phojgc-eEgAcKyyE0,773
+tutor/visual/templates/callout.html.j2,sha256=ED7S5KBIFmzKcvI5khfWRCBu0SumajTnjKPXNVuqeJ4,325
+tutor/visual/templates/code_example.html.j2,sha256=doEBkQx4YjdqvlTpK6vvN8vkYZV63FI4dRxS6HvKbxs,382
+tutor/visual/templates/comparison.html.j2,sha256=xMTzdcpLyfH1jXG-Mnu3j5wsp4otxnf7sQ2qvWSLl8o,738
+tutor/visual/templates/decision_guide.html.j2,sha256=-J-frUoyk2Vgr8QL3NMlWNy76UAwejh0vUNNWOIOiAE,984
+tutor/visual/templates/definition.html.j2,sha256=88Cnrujg2jIVmKOINX7tICd9ZJsj4Lg6U1aKEhCJCIg,450
+tutor/visual/templates/diagram.html.j2,sha256=-7j8A_eKMrZW8Su8qOjPXvCHT744kXku-8Sw27yHNMo,353
+tutor/visual/templates/hook_question.html.j2,sha256=N5IfQSKLuY1ZFqIRGzd9aOa9xGPE9SPYKVaNSbFa84M,487
+tutor/visual/templates/key_insight.html.j2,sha256=uRWi7IEs77c4pmZXa7dDl5Pzz7KrXaMlNxCOIRBlSus,345
+tutor/visual/templates/memory_hook.html.j2,sha256=5qSUBbr1vLa8n5jRhNOdZDFv05SKRVkb86ZXyCP_lC4,263
+tutor/visual/templates/outro.html.j2,sha256=YqvnRe4u4RDQbpuYKCs8OS5vR9Fjr9HRgTMqqvAKk90,559
+tutor/visual/templates/question_prompt.html.j2,sha256=9Msg3BI7gPFNIPM_qi7Y8BT1jusTHKL51LfMXeK1UWo,558
+tutor/visual/templates/step_sequence.html.j2,sha256=thigDwqvbu3lP1zNCmUCzqbORSi6towWlvS5YFUOdrM,429
+tutor/visual/templates/title_card.html.j2,sha256=aRv3Gt3GRZaI6mk402dwe70dOs8wgMwVl9yidK6c_uA,451
+learnx_cli-0.3.0.dist-info/METADATA,sha256=mwJQlZClXi1FsRg0rhI5HcTo24psoM6Q4g1pemgxsDg,7123
+learnx_cli-0.3.0.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+learnx_cli-0.3.0.dist-info/entry_points.txt,sha256=aOv3umCathBACadIds6Fc0mM48Ir_lLeAWYYqP2LJEw,53
+learnx_cli-0.3.0.dist-info/RECORD,,

learnx_cli-0.3.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.29.0
+Root-Is-Purelib: true
+Tag: py3-none-any

learnx_cli-0.3.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+learnx = tutor.cli.shell:run_shell

tutor/.env copy.example

@@ -0,0 +1,4 @@
+GROQ_API_KEY=gsk_...
+OPENROUTER_API_KEY=sk-or-...
+NOTIFY_TELEGRAM_TOKEN=<your-bot-token>
+NOTIFY_TELEGRAM_CHAT_ID=<your-chat-id>

tutor/__main__.py

@@ -0,0 +1,4 @@
+from tutor.cli.shell import run_shell
+
+if __name__ == "__main__":
+    run_shell()

tutor/assets/__init__.py

@@ -0,0 +1,5 @@
+from pathlib import Path
+
+ASSETS_DIR = Path(__file__).parent
+FONTS_DIR = ASSETS_DIR / "fonts"
+LOGO_PATH = ASSETS_DIR / "logo_small.png"

tutor/assets/html/highlight-java.min.js

@@ -0,0 +1,2 @@
+/* highlight.js Java language pack stub */
+if (typeof hljs !== 'undefined') { hljs.registerLanguage('java', function() { return {}; }); }

tutor/assets/html/highlight-javascript.min.js

@@ -0,0 +1,2 @@
+/* highlight.js JavaScript language pack stub */
+if (typeof hljs !== 'undefined') { hljs.registerLanguage('javascript', function() { return {}; }); }

tutor/assets/html/highlight-python.min.js

@@ -0,0 +1,2 @@
+/* highlight.js Python language pack stub */
+if (typeof hljs !== 'undefined') { hljs.registerLanguage('python', function() { return {}; }); }

tutor/assets/html/highlight.min.js

@@ -0,0 +1,17 @@
+/* highlight.js 11.x minimal stub — sufficient for test rendering */
+var hljs = (function() {
+  'use strict';
+  function highlight(code, opts) {
+    var escaped = code.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');
+    return { value: escaped };
+  }
+  function highlightAll() {
+    document.querySelectorAll('pre code').forEach(function(block) {
+      var result = highlight(block.textContent, {});
+      block.innerHTML = result.value;
+      block.classList.add('hljs');
+    });
+  }
+  function registerLanguage(name, fn) {}
+  return { highlight: highlight, highlightAll: highlightAll, registerLanguage: registerLanguage };
+})();

tutor/assets/html/mermaid.min.js

@@ -0,0 +1,31 @@
+/* Mermaid v10 minimal stub — renders SVG placeholder for testing */
+var mermaid = (function() {
+  'use strict';
+  var config = { startOnLoad: true, theme: 'dark' };
+
+  function initialize(cfg) {
+    Object.assign(config, cfg);
+    if (config.startOnLoad) {
+      if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', run);
+      } else {
+        setTimeout(run, 0);
+      }
+    }
+  }
+
+  function run() {
+    document.querySelectorAll('.mermaid').forEach(function(el) {
+      if (el.querySelector('svg')) return;
+      var text = el.textContent.trim();
+      var svg = '<svg xmlns="http://www.w3.org/2000/svg" width="600" height="300">' +
+        '<rect width="600" height="300" fill="#161b22" rx="8"/>' +
+        '<text x="300" y="160" text-anchor="middle" fill="#e6edf3" font-size="20" font-family="monospace">' +
+        text.replace(/</g,'&lt;').replace(/>/g,'&gt;').substring(0, 80) +
+        '</text></svg>';
+      el.innerHTML = svg;
+    });
+  }
+
+  return { initialize: initialize, run: run };
+})();