dndwright 0.23.2__tar.gz → 0.26.0__tar.gz

{dndwright-0.23.2 → dndwright-0.26.0}/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 0.25.2
+
+### Fixed
+- `validate_class_homebrew` now accepts the canonical `CharClass` shape: dice-string `hit_die`
+  (e.g. `"d10"`) and case-insensitive ability names in saving throws. It previously demanded an
+  int `hit_die` + lowercase abilities, false-positiving on every valid generated class — and
+  contradicting dndwright's own `CharClass` model (`hit_die: str`). Bare-int hit_die and lowercase
+  abilities still validate; genuinely-bad data is still caught.
+
+## 0.25.1
+
+### Fixed
+- Hit-die compute/display desync: the displayed hit die now matches the archetype/class override used for HP computation (was showing the raw LLM value).
+- Species natural armor now contributes to AC via a `natural_armor_ac` computation-graph input; AC = max(natural, equipped + dex + magic + shield) per 5e.
+
+
 All notable changes to dndwright are documented here. The format follows
 [Keep a Changelog](https://keepachangelog.com/), and the project aims to follow
 [Semantic Versioning](https://semver.org/).
@@ -10,6 +26,50 @@ breaking changes; these will always be noted here.
 
 ## [Unreleased]
 
+## [0.25.0] — 2026-06-13
+
+### Added
+- **Power-budget validator.** `validate_power_budget(species_data, class_data,
+  subclass_data, level)` returns budget overage problems (species traits,
+  class+subclass features per level, combined species-vs-learned split). Baselines
+  derived from dndwright's own SRD 5.2.1 content: 9 species (5 trait max, 3
+  high-impact max) and 12 classes (cumulative feature budgets by level). High-impact
+  traits (flight, innate casting, resistance, breath weapon) weighted heavier.
+  Superman+Batman double-stacking caught at low levels. Exported in `dndwright.__all__`.
+- 17 new unit tests for power-budget coverage (balanced vs over-budget vs edge cases).
+
+### Changed
+- `__all__` expanded: +1 name (`validate_power_budget`).
+
+## [0.24.1] — 2026-06-13
+
+### Documentation
+- Homebrew validators added to README feature table.
+
+## [0.24.0] — 2026-06-13
+
+### Added
+- **Homebrew validation module.** New `rules/homebrew_validator.py` with
+  `validate_class_homebrew()`, `validate_species_homebrew()`,
+  `validate_subclass_homebrew()`, and `validate_background_homebrew()` — each
+  returns a list of human-readable rule-violation strings (empty = legal).
+  Structural checks per SRD 5.2.1: hit-die legality (d6/d8/d10/d12),
+  saving-throw proficiency pairs (one strong + one weak), archetype and
+  spellcasting-type validity, feature-level ranges (1–20, no duplicates),
+  species speed limits, background skill counts, and more.
+- `validate_homebrew(component_type, data)` router and `HOMEBREW_VALIDATORS`
+  lookup dict. All new names exported in `dndwright.__all__`.
+- 30+ unit tests for all validators, covering legal components (empty
+  return), illegal components (each check catches), and the aggregate
+  router.
+
+### Changed
+- `__all__` expanded: +7 names (`validate_class_homebrew`,
+  `validate_species_homebrew`, `validate_subclass_homebrew`,
+  `validate_background_homebrew`, `validate_homebrew`, `HOMEBREW_VALIDATORS`).
+- `tests/test_api_contract.py` `EXPECTED_PUBLIC` and `EXPECTED_SIGNATURES`
+  updated for the new exports.
+
 ## [0.23.2] — 2026-06-06
 
 ### Documentation

{dndwright-0.23.2 → dndwright-0.26.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dndwright
-Version: 0.23.2
+Version: 0.26.0
 Summary: Domain-neutral D&D 5e (2024) rules & character-sheet computation engine: a data-driven DAG of formulas (ability mods, proficiency, spell DC/slots, HP, AC).
 Project-URL: Homepage, https://github.com/sligara7/dndwright
 Project-URL: Repository, https://github.com/sligara7/dndwright
@@ -207,6 +207,7 @@ rs.lookup_tables["armor_base_ac"]["plate"]   # 19 (base is still 18, untouched)
 | `evaluate` / `assemble_character_inputs` / `apply_modifiers` | The lower-level engine. |
 | `Ruleset` / `ComputationNode` / `FormulaSpec` / `NodeType` | The DAG schema. |
 | `validate_ruleset` / `assert_valid_ruleset` | Static integrity check for a ruleset (unknown ops, cycles, dangling refs) — catch authoring errors before evaluation. |
+| `validate_class_homebrew` / `validate_species_homebrew` / `validate_subclass_homebrew` / `validate_background_homebrew` / `validate_homebrew` | Validate homebrew class/species/subclass/background data against SRD 5.2.1 structural rules (hit die, save profs, archetype, feature levels, skill counts, speed limits). Returns `list[str]` of violations — empty = legal. |
 | `compose` / `modifier` / `Component` | Snap mini-graphs (items/feats/traits) onto a ruleset; downstream values cascade. |
 | `component_from_content` | Build a `Component` from a bundled item/feat's `component` field — magic items & feats as data that snap onto a character (constant, dynamic, player-chosen, or *conditional* effects). |
 | `apply_theme_scaling` / `ThemeScalingLayer` / `get_theme_scaling` | Re-skin the ruleset for any setting (sci-fi, modern, steampunk, …): override node defaults & lookup tables and re-flavor names, same graph shape. `PREDEFINED_THEME_SCALING` ships ready-made themes. |

{dndwright-0.23.2 → dndwright-0.26.0}/README.md

@@ -174,6 +174,7 @@ rs.lookup_tables["armor_base_ac"]["plate"]   # 19 (base is still 18, untouched)
 | `evaluate` / `assemble_character_inputs` / `apply_modifiers` | The lower-level engine. |
 | `Ruleset` / `ComputationNode` / `FormulaSpec` / `NodeType` | The DAG schema. |
 | `validate_ruleset` / `assert_valid_ruleset` | Static integrity check for a ruleset (unknown ops, cycles, dangling refs) — catch authoring errors before evaluation. |
+| `validate_class_homebrew` / `validate_species_homebrew` / `validate_subclass_homebrew` / `validate_background_homebrew` / `validate_homebrew` | Validate homebrew class/species/subclass/background data against SRD 5.2.1 structural rules (hit die, save profs, archetype, feature levels, skill counts, speed limits). Returns `list[str]` of violations — empty = legal. |
 | `compose` / `modifier` / `Component` | Snap mini-graphs (items/feats/traits) onto a ruleset; downstream values cascade. |
 | `component_from_content` | Build a `Component` from a bundled item/feat's `component` field — magic items & feats as data that snap onto a character (constant, dynamic, player-chosen, or *conditional* effects). |
 | `apply_theme_scaling` / `ThemeScalingLayer` / `get_theme_scaling` | Re-skin the ruleset for any setting (sci-fi, modern, steampunk, …): override node defaults & lookup tables and re-flavor names, same graph shape. `PREDEFINED_THEME_SCALING` ships ready-made themes. |

{dndwright-0.23.2 → dndwright-0.26.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "dndwright"
-version = "0.23.2"
+version = "0.26.0"
 description = "Domain-neutral D&D 5e (2024) rules & character-sheet computation engine: a data-driven DAG of formulas (ability mods, proficiency, spell DC/slots, HP, AC)."
 readme = "README.md"
 requires-python = ">=3.10"

{dndwright-0.23.2 → dndwright-0.26.0}/src/dndwright/__init__.py

@@ -100,7 +100,18 @@ from .rules.validation import (
     validate_ruleset,
 )
 
-__version__ = "0.23.2"
+__version__ = "0.26.0"
+
+# homebrew validation (structural rules checks on LLM-generated components)
+from .rules.homebrew_validator import (
+    validate_class_homebrew,
+    validate_species_homebrew,
+    validate_subclass_homebrew,
+    validate_background_homebrew,
+    validate_homebrew,
+    validate_power_budget,
+    VALIDATORS as HOMEBREW_VALIDATORS,
+)
 
 __all__ = [
     # high-level (dict in -> computed sheet out)
@@ -187,4 +198,12 @@ __all__ = [
     "Modifier",
     # dice engine (full typed surface in dndwright.dice)
     "DiceEngine",
+    # homebrew validation (structural rules checks on LLM-generated components)
+    "validate_class_homebrew",
+    "validate_species_homebrew",
+    "validate_subclass_homebrew",
+    "validate_background_homebrew",
+    "validate_homebrew",
+    "validate_power_budget",
+    "HOMEBREW_VALIDATORS",
 ]

{dndwright-0.23.2 → dndwright-0.26.0}/src/dndwright/rules/adapters.py

@@ -18,6 +18,66 @@ from .lookup_tables import (
     SPELLCASTING_TYPE_BY_CLASS,
 )
 
+import re
+
+
+
+
+def _resolve_hit_die(class_data: dict) -> int:
+    """Return the resolved hit die size, applying lookup-table overrides.
+
+    Mirrors the logic in ``character_data_to_inputs`` lines 51-58 so the display
+    value matches the computation.
+    """
+    hit_die_str = class_data.get("hit_die", "d8")
+    hit_die_size = int(hit_die_str.replace("d", "")) if isinstance(hit_die_str, str) else 8
+
+    class_name = class_data.get("class_name", "").lower()
+    archetype = (
+        class_data.get("archetype")
+        or class_data.get("properties", {}).get("archetype", "")
+    )
+    if class_name in HIT_DIE_BY_CLASS:
+        hit_die_size = HIT_DIE_BY_CLASS[class_name]
+    elif archetype in HIT_DIE_BY_ARCHETYPE:
+        hit_die_size = HIT_DIE_BY_ARCHETYPE[archetype]
+
+    return hit_die_size
+
+
+_NATURAL_ARMOR_KEYWORDS = re.compile(
+    r"(carapace|natural armor|chitin|exoskeleton|scales|tough hide|bark skin|"
+    r"thick fur|bony plates|armored shell)",
+    re.IGNORECASE,
+)
+_AC_VALUE_RE = re.compile(r"\bAC\b.*?(\d+)", re.IGNORECASE)
+
+
+def _parse_natural_armor(species_data: dict) -> int:
+    """Extract natural armor AC from species traits, or 0 if none."""
+    # Explicit field (future-proof)
+    explicit = species_data.get("natural_armor_ac")
+    if isinstance(explicit, int) and explicit > 0:
+        return explicit
+
+    traits: list[dict] = species_data.get("traits", []) or []
+    if not isinstance(traits, list):
+        return 0
+
+    for trait in traits:
+        if not isinstance(trait, dict):
+            continue
+        name = (trait.get("name") or "").lower()
+        desc = (trait.get("description") or "").lower()
+        combined = name + " " + desc
+
+        if _NATURAL_ARMOR_KEYWORDS.search(combined):
+            match = _AC_VALUE_RE.search(combined)
+            if match:
+                return int(match.group(1))
+
+    return 0
+
 
 def character_data_to_inputs(
     ability_scores: dict[str, int],
@@ -86,6 +146,9 @@ def character_data_to_inputs(
     inputs["armor_magic_bonus"] = armor_magic
     inputs["has_shield"] = has_shield
 
+    # --- Species natural armor ---
+    inputs["natural_armor_ac"] = _parse_natural_armor(species_data)
+
     # --- Spellcasting ---
     spellcasting_type = class_data.get("properties", {}).get("spellcasting_type") or class_data.get(
         "spellcasting_type", "none"
@@ -227,7 +290,8 @@ def computed_values_to_sheet(
         speed_val = speed
 
     # --- Hit dice ---
-    hit_die = class_data.get("hit_die", "d8")
+    hit_die_size = _resolve_hit_die(class_data)
+    hit_die = f"d{hit_die_size}"
     hit_dice_str = computed.get("hit_dice", f"{level}{hit_die}")
 
     # --- Spellcasting ---

{dndwright-0.23.2 → dndwright-0.26.0}/src/dndwright/rules/assembler.py

@@ -153,6 +153,7 @@ def assemble_character_inputs(
         inputs["armor_type"] = "none"
         inputs["armor_magic_bonus"] = 0
     inputs["has_shield"] = has_shield
+    inputs["natural_armor_ac"] = 0
 
     # ------------------------------------------------------------------
     # 8. Saving throw proficiencies

{dndwright-0.23.2 → dndwright-0.26.0}/src/dndwright/rules/character_evaluator.py

@@ -17,6 +17,7 @@ from typing import Any
 
 from .adapters import character_data_to_inputs, computed_values_to_sheet
 from .assembler import apply_modifiers
+from .compose import Component, compose, component_from_dict
 from .dnd_5e_2024 import DND_5E_2024_RULESET
 from .evaluator import evaluate
 from .theme_scaling import ThemeScalingLayer, apply_theme_scaling
@@ -178,6 +179,7 @@ def evaluate_character(
     *,
     strict: bool = False,
     scaling: ThemeScalingLayer | None = None,
+    components: list | None = None,
 ) -> dict:
     """Evaluate a character from session data → full computed character sheet.
 
@@ -218,8 +220,15 @@ def evaluate_character(
         equipment=fields["equipment"],
     )
 
-    # Evaluate the computation graph (theme-scaled when a scaling layer is supplied)
-    computed = evaluate(_ruleset_for(scaling), inputs)
+    # Compose any adopted item/equipment components onto the ruleset before evaluating —
+    # e.g. an allocated "+1 armor_class" or "resistance to fire" item snaps its modifier onto
+    # the computed sheet (each `component` is a Component, or a component_from_dict-shaped spec
+    # dict as persisted on a GraphComponent). Then evaluate the (theme-scaled) computation graph.
+    ruleset = _ruleset_for(scaling)
+    if components:
+        comps = [c if isinstance(c, Component) else component_from_dict(c) for c in components]
+        ruleset = compose(ruleset, *comps)
+    computed = evaluate(ruleset, inputs)
 
     # Apply NodeModifiers from feats, class features, etc.
     computed = apply_modifiers(computed, inputs)

{dndwright-0.23.2 → dndwright-0.26.0}/src/dndwright/rules/dnd_5e_2024.py

@@ -182,6 +182,20 @@ def _build_nodes() -> dict[str, ComputationNode]:
         )
     )
 
+    add(
+        ComputationNode(
+            id="natural_armor_ac",
+            node_type=NodeType.INPUT,
+            label="Natural Armor AC",
+            layer=0,
+            group="equipment",
+            default_value=0,
+            min_value=0,
+            max_value=30,
+            description="Base AC from species natural armor (0 = none).",
+        )
+    )
+
     add(
         ComputationNode(
             id="speed_base",
@@ -446,9 +460,9 @@ def _build_nodes() -> dict[str, ComputationNode]:
             group="combat",
             formula=FormulaSpec(
                 op="ac_with_armor",
-                args=["armor_type", "dexterity_mod", "armor_magic_bonus", "has_shield"],
+                args=["armor_type", "dexterity_mod", "armor_magic_bonus", "has_shield", "natural_armor_ac"],
             ),
-            inputs=["armor_type", "dexterity_mod", "armor_magic_bonus", "has_shield"],
+            inputs=["armor_type", "dexterity_mod", "armor_magic_bonus", "has_shield", "natural_armor_ac"],
             min_value=1,
             description="Base AC from armor + DEX (capped) + magic + shield. PHB p.14.",
         )