korb 0.2.2__tar.gz → 0.2.4__tar.gz

{korb-0.2.2 → korb-0.2.4}/CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to this project will be documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/).
 
+## [0.2.3] — 2026-04-10
+
+### Added
+
+- `skill` subcommand — prints built-in AI skill prompts to stdout.
+- `skill --list` / `-l` flag — lists available skill names and filenames.
+- `korb/skills/` package with `SKILL_MAP` and `get_skill_text()` using `importlib.resources`.
+- Two bundled skills: `analysis` (team deep-dive) and `prediction` (league top-N forecast).
+- Skill markdown files now shipped inside the `korb` package (included in pip distributions).
+
+### Changed
+
+- Migrated `skills/` from project root into `korb/skills/` for proper wheel inclusion.
+
+---
+
 ## [0.2.2] — 2026-04-09
 
 ### Added

{korb-0.2.2 → korb-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: korb
-Version: 0.2.2
+Version: 0.2.4
 Summary: A CLI toolkit for DBB basketball league analysis
 Project-URL: Homepage, https://github.com/malvavisc0/korb
 Project-URL: Repository, https://github.com/malvavisc0/korb
@@ -47,6 +47,7 @@ A zero-dependency Python CLI that parses HTML from the **DBB** (Deutscher Basket
 - 🔮 **Predictions** — efficiency-model-based final standings forecast
 - 🥇 **Top N** — quick leaderboard with ASCII bar chart
 - 📥 **Download** — fetch fresh HTML data directly from basketball-bund.net
+- 🤖 **Skills** — built-in AI skill prompts for team analysis & league prediction
 - 🔧 **JSON output** — pipe-friendly `--json` flag for all commands
 
 ---
@@ -161,6 +162,19 @@ Uses a multiplicative efficiency model with recency weighting, recent form blend
 uv run korb --ligaid 12345 top -n 5
 ```
 
+### `skill` — Print AI skill prompts
+
+```bash
+# List available skills
+uv run korb skill --list
+
+# Print a specific skill prompt
+uv run korb skill analysis
+uv run korb skill prediction
+```
+
+Ships two built-in skills: `analysis` (team deep-dive) and `prediction` (league top-N forecast).
+
 ### `--download` — Fetch fresh data before any command
 
 ```bash
@@ -192,18 +206,19 @@ $ uv run korb --help
 
 usage: korb [-h] [--version] [--results RESULTS] [--schedule SCHEDULE]
             [--json] [--ligaid LIGAID] [--download]
-            {standings,team,schedule,predict,top,download} ...
+            {standings,team,schedule,predict,top,download,skill} ...
 
 Basketball league analysis tools
 
 positional arguments:
-  {standings,team,schedule,predict,top,download}
+  {standings,team,schedule,predict,top,download,skill}
     standings           Display league standings
     team                Display results for a team
     schedule            Display game schedule
     predict             Predict final standings
     top                 Show top teams from standings
     download            Download results & schedule HTML
+    skill               Print a skill prompt or list available skills
 
 options:
   -h, --help            show this help message and exit

{korb-0.2.2 → korb-0.2.4}/README.md

@@ -22,6 +22,7 @@ A zero-dependency Python CLI that parses HTML from the **DBB** (Deutscher Basket
 - 🔮 **Predictions** — efficiency-model-based final standings forecast
 - 🥇 **Top N** — quick leaderboard with ASCII bar chart
 - 📥 **Download** — fetch fresh HTML data directly from basketball-bund.net
+- 🤖 **Skills** — built-in AI skill prompts for team analysis & league prediction
 - 🔧 **JSON output** — pipe-friendly `--json` flag for all commands
 
 ---
@@ -136,6 +137,19 @@ Uses a multiplicative efficiency model with recency weighting, recent form blend
 uv run korb --ligaid 12345 top -n 5
 ```
 
+### `skill` — Print AI skill prompts
+
+```bash
+# List available skills
+uv run korb skill --list
+
+# Print a specific skill prompt
+uv run korb skill analysis
+uv run korb skill prediction
+```
+
+Ships two built-in skills: `analysis` (team deep-dive) and `prediction` (league top-N forecast).
+
 ### `--download` — Fetch fresh data before any command
 
 ```bash
@@ -167,18 +181,19 @@ $ uv run korb --help
 
 usage: korb [-h] [--version] [--results RESULTS] [--schedule SCHEDULE]
             [--json] [--ligaid LIGAID] [--download]
-            {standings,team,schedule,predict,top,download} ...
+            {standings,team,schedule,predict,top,download,skill} ...
 
 Basketball league analysis tools
 
 positional arguments:
-  {standings,team,schedule,predict,top,download}
+  {standings,team,schedule,predict,top,download,skill}
     standings           Display league standings
     team                Display results for a team
     schedule            Display game schedule
     predict             Predict final standings
     top                 Show top teams from standings
     download            Download results & schedule HTML
+    skill               Print a skill prompt or list available skills
 
 options:
   -h, --help            show this help message and exit

{korb-0.2.2 → korb-0.2.4}/korb/__init__.py

@@ -3,4 +3,4 @@
 Target: DBB Version ≤11.50.0-623b018 (legacy JSP platform).
 """
 
-__version__ = "0.2.2"
+__version__ = "0.2.4"

{korb-0.2.2 → korb-0.2.4}/korb/__main__.py

@@ -25,6 +25,7 @@ from .schedule import (
     parse_schedule,
     print_schedule,
 )
+from .skills import SKILL_MAP, get_skill_text
 from .standings import calculate_standings, print_table
 from .team import get_team_results, print_bars, print_metrics, print_results
 
@@ -352,6 +353,22 @@ def cmd_download(args: argparse.Namespace) -> None:
     _download(args.ligaid)
 
 
+def cmd_skill(args: argparse.Namespace) -> None:
+    """Handle 'skill' subcommand."""
+    if args.list_skills:
+        for name, filename in SKILL_MAP.items():
+            print(f"  {name:12s}  {filename}")
+        return
+    if args.name is None:
+        print("Error: pass a skill name or --list", file=sys.stderr)
+        sys.exit(1)
+    try:
+        print(get_skill_text(args.name))
+    except ValueError as exc:
+        print(f"Error: {exc}", file=sys.stderr)
+        sys.exit(1)
+
+
 def main() -> None:
     """Entry point for CLI."""
     parser = argparse.ArgumentParser(
@@ -478,6 +495,25 @@ def main() -> None:
     )
     p_dl.set_defaults(func=cmd_download)
 
+    p_sk = subs.add_parser(
+        "skill",
+        help="Print a skill prompt or list available skills",
+    )
+    p_sk.add_argument(
+        "name",
+        nargs="?",
+        default=None,
+        help="Skill name: analysis or prediction",
+    )
+    p_sk.add_argument(
+        "--list",
+        "-l",
+        action="store_true",
+        dest="list_skills",
+        help="List available skill names and descriptions",
+    )
+    p_sk.set_defaults(func=cmd_skill)
+
     args = parser.parse_args()
 
     # Pre-command download hook

{korb-0.2.2 → korb-0.2.4}/korb/core.py

@@ -182,10 +182,6 @@ def extract_league_info(html: str) -> LeagueInfo:
     return LeagueInfo(name=name, number=number)
 
 
-# Backward-compatible alias
-extract_league_name = extract_league_info
-
-
 def read_games(filepath: str) -> tuple[list[Game], LeagueInfo]:
     """Read all valid games from HTML results file.
 

{korb-0.2.2 → korb-0.2.4}/korb/schedule.py

@@ -126,19 +126,19 @@ class _HTMLScheduleParser(HTMLParser):
 
 
 def parse_schedule(html_file: str) -> tuple[list[ScheduledGame], LeagueInfo]:
-    """Parse HTML file into scheduled games, sorted newest first.
+    """Parse HTML file into scheduled games, sorted chronologically.
 
     Args:
         html_file: Path to HTML schedule file.
 
     Returns:
-        Tuple of (games sorted by date descending, league_info).
+        Tuple of (games sorted by date ascending, league_info).
     """
     content = read_file_safe(html_file)
     league_info = extract_league_info(content)
     parser = _HTMLScheduleParser()
     parser.feed(content)
-    parser.games.sort(key=lambda g: g.date, reverse=True)
+    parser.games.sort(key=lambda g: g.date)
     return parser.games, league_info
 
 

{korb-0.2.2 → korb-0.2.4/korb}/skills/SKILL_LEAGUE_TOP_N_ANALYSIS.md

@@ -97,5 +97,4 @@ Keep it brief (caption-like) and avoid bullet points.
 
 ## Output
 
-Return: (1) the markdown table and (2) the explanation paragraph.
-
+Return: (1) the markdown table and (2) the explanation paragraph.

{korb-0.2.2 → korb-0.2.4/korb}/skills/SKILL_TEAM_ANALYSIS.md

@@ -66,11 +66,11 @@ uv run korb --json --ligaid <LIGA_ID> team "<TEAM_NAME>"
 
 Important: in JSON mode, the CLI returns **all matching games** and does **not** apply `--last-k` slicing or `--metrics` printing logic.
 
-So to emulate “last 5 games”:
+So to emulate "last 5 games":
 
 1. Take `team_json["results"]`.
 2. Treat it as **newest-first**.
-3. Use the first 5 items as the “last 5”. If there are fewer than 5 games, use all available.
+3. Use the first 5 items as the "last 5". If there are fewer than 5 games, use all available.
 
 Compute:
 
@@ -92,7 +92,7 @@ uv run korb --json --ligaid <LIGA_ID> schedule --pending
 uv run korb --json --ligaid <LIGA_ID> predict
 ```
 
-From `predict_json["standings"]` extract the team’s **predicted rank** as `index_in_list + 1`.
+From `predict_json["standings"]` extract the team's **predicted rank** as `index_in_list + 1`.
 
 ---
 
@@ -117,5 +117,4 @@ Write the paragraph in the selected `LANGUAGE`.
 
 ## Output
 
-Return the paragraph directly. Do **not** save to a file.
-
+Return the paragraph directly. Do **not** save to a file.

korb-0.2.4/korb/skills/__init__.py

@@ -0,0 +1,28 @@
+"""Skill definitions shipped with the korb package."""
+
+from importlib.resources import files
+
+SKILL_MAP: dict[str, str] = {
+    "analysis": "SKILL_TEAM_ANALYSIS.md",
+    "prediction": "SKILL_LEAGUE_TOP_N_ANALYSIS.md",
+}
+
+
+def get_skill_text(name: str) -> str:
+    """Return the markdown text of a named skill.
+
+    Args:
+        name: Skill key from SKILL_MAP (e.g. "analysis", "prediction").
+
+    Returns:
+        The full markdown content of the skill file.
+
+    Raises:
+        ValueError: If *name* is not in SKILL_MAP.
+    """
+    if name not in SKILL_MAP:
+        raise ValueError(
+            f"unknown skill: {name!r}. Choose from: {', '.join(SKILL_MAP)}"
+        )
+    filename = SKILL_MAP[name]
+    return files(__package__).joinpath(filename).read_text(encoding="utf-8")

{korb-0.2.2 → korb-0.2.4}/tests/test_cli.py

@@ -4,7 +4,13 @@ import argparse
 
 import pytest
 
-from korb.__main__ import cmd_predict, cmd_schedule, cmd_standings, cmd_team
+from korb.__main__ import (
+    cmd_predict,
+    cmd_schedule,
+    cmd_skill,
+    cmd_standings,
+    cmd_team,
+)
 
 
 def _make_args(**kwargs) -> argparse.Namespace:
@@ -167,3 +173,34 @@ class TestCmdPredict:
         cmd_predict(args)
         captured = capsys.readouterr()
         assert "Predicted" in captured.out
+
+
+class TestCmdSkill:
+    def test_analysis_skill(self, capsys):
+        args = _make_args(name="analysis", list_skills=False)
+        cmd_skill(args)
+        out = capsys.readouterr().out
+        assert "Team Analysis" in out
+
+    def test_prediction_skill(self, capsys):
+        args = _make_args(name="prediction", list_skills=False)
+        cmd_skill(args)
+        out = capsys.readouterr().out
+        assert "League Prediction" in out
+
+    def test_list_skills(self, capsys):
+        args = _make_args(name=None, list_skills=True)
+        cmd_skill(args)
+        out = capsys.readouterr().out
+        assert "analysis" in out
+        assert "prediction" in out
+
+    def test_no_args(self):
+        args = _make_args(name=None, list_skills=False)
+        with pytest.raises(SystemExit):
+            cmd_skill(args)
+
+    def test_invalid_skill(self):
+        args = _make_args(name="nonexistent", list_skills=False)
+        with pytest.raises(SystemExit):
+            cmd_skill(args)

{korb-0.2.2 → korb-0.2.4}/tests/test_download.py

@@ -4,7 +4,6 @@ import gzip
 import zlib
 from unittest.mock import MagicMock, patch
 
-
 from korb.__main__ import _DELAY_MAX, _DELAY_MIN, _HEADERS, _read_response
 
 
@@ -46,7 +45,6 @@ class TestHeaders:
         assert _HEADERS["DNT"] == "1"
 
 
-
 def _fake_response(body: bytes, encoding: str = "") -> MagicMock:
     """Build a mock HTTP response with the given body & encoding."""
     resp = MagicMock()
@@ -90,7 +88,6 @@ class TestReadResponse:
         assert _read_response(resp) == raw
 
 
-
 class TestDownload:
     """Verify _download sends correct headers and sleeps between requests."""
 
@@ -120,9 +117,7 @@ class TestDownload:
             # Use real tmp_path for file writes
             dest_a = tmp_path / "ergebnisse.html"
             dest_b = tmp_path / "spielplan.html"
-            mock_liga.__truediv__ = MagicMock(
-                side_effect=[dest_a, dest_b]
-            )
+            mock_liga.__truediv__ = MagicMock(side_effect=[dest_a, dest_b])
             mock_root.__truediv__ = MagicMock(return_value=mock_liga)
             mock_liga.mkdir = MagicMock()
 
@@ -158,9 +153,7 @@ class TestDownload:
 
             dest_a = tmp_path / "ergebnisse.html"
             dest_b = tmp_path / "spielplan.html"
-            mock_liga.__truediv__ = MagicMock(
-                side_effect=[dest_a, dest_b]
-            )
+            mock_liga.__truediv__ = MagicMock(side_effect=[dest_a, dest_b])
             mock_root.__truediv__ = MagicMock(return_value=mock_liga)
             mock_liga.mkdir = MagicMock()
 

{korb-0.2.2 → korb-0.2.4}/tests/test_schedule.py

@@ -66,7 +66,7 @@ class TestParseSchedule:
     def test_sorting_by_date(self, spielplan_path):
         games, _ = parse_schedule(spielplan_path)
         for i in range(len(games) - 1):
-            assert games[i].date >= games[i + 1].date
+            assert games[i].date <= games[i + 1].date
 
     def test_missing_file_raises(self, tmp_path):
         with pytest.raises(SystemExit):