comicforge 0.2.1__tar.gz → 0.2.2__tar.gz

{comicforge-0.2.1 → comicforge-0.2.2}/CLAUDE.md

@@ -120,3 +120,53 @@ broken cross-reference, a dead anchor, a missing snippet or a missing render.
 - Demo art is hand/LLM-authored crisp SVG, edited directly in `examples/pes/`
   (there is no procedural generator). Use `comicforge inspire` for *reference*
   images only — never auto-vectorize them; it breaks overlay/anchor registration.
+
+## Toolbox (aesop)
+
+The [aesop toolbox](https://mojzis.github.io/aesop/llms.txt) is wired in. Every
+tool documents itself: run `uv run <tool> guide` before guessing at flags
+(`madoqua`, `gerenuk`, `biston`, `zorilla`, `pycoati`, `tyf`).
+
+**On every commit** — `hooks/pre-commit` runs `madoqua`, which acts on the
+staged `.py` files only (a commit with no `.py` staged runs nothing, silently):
+
+- fix phase: `ruff check --fix`, `ruff format` (re-staged)
+- check phase, in parallel: `ruff check`, `ty check`, `biston scan --focus-args`
+  (clone pairs touching a staged file), `zorilla check` (test smells in the
+  staged test files), `gerenuk run -- -q -o addopts=` (only the tests the diff
+  can reach, whole suite when unsure; diffs the *working tree* against
+  `origin/main`, so unstaged edits count)
+
+Typical timing: `uv run madoqua stats` (log in `.git/hook-timings.jsonl`).
+Skip one check for one run: `MADOQUA_SKIP="ty check" git commit ...`.
+Known baseline: `tests/test_inspire.py` and `tests/test_scaffold.py` carry
+ZR004 assertion-roulette findings — the hook blocks the next commit that
+touches them until those tests are split. Config: `[tool.madoqua]` and
+`[tool.biston.scan]` in `pyproject.toml`.
+
+`poe check` / CI are unchanged and remain the whole-tree run.
+
+**On demand** (never in the hook):
+
+- symbols — use `uv run tyf` instead of grep for definitions and references:
+  `uv run tyf find <name>`, `uv run tyf show <name> -r`, `uv run tyf refs <name>`.
+  Stale results after big edits: `uv run tyf daemon stop` (next query restarts it).
+- `uv run gerenuk impacted-tests` — which tests the current diff reaches, and why.
+- `uv run gerenuk audit <file>` — symbols in a module nothing references.
+- `uv run pycoati . --format pretty` — periodic test-suite audit: ranks every
+  test by suspicion with a remediation ladder. Run before a test cleanup session.
+  Not a hook, not CI. Needs pytest-cov (installed) or coverage is silently null.
+- `uv run biston scan .` / `uv run zorilla check .` — whole-tree clone / test-smell scan.
+
+**Fresh clone:** `uv sync` (add `--group docs` / `--extra inspire` as needed),
+then `uv run madoqua install` once — `core.hooksPath` is local git config, the
+shim in `hooks/` is committed.
+
+**Refresh the toolbox:**
+
+```bash
+uv lock --refresh --upgrade-package madoqua --upgrade-package gerenuk --upgrade-package biston --upgrade-package zorilla --upgrade-package pycoati --upgrade-package ty-find && uv sync
+```
+
+(`--refresh` matters: without it uv may serve a cached index and miss a release
+published minutes ago.)

{comicforge-0.2.1 → comicforge-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: comicforge
-Version: 0.2.1
+Version: 0.2.2
 Summary: A tiny, scriptable comic-page engine — author comics as YAML, render to SVG / PNG / PDF
 Requires-Python: >=3.13
 Requires-Dist: cairosvg>=2.7

{comicforge-0.2.1 → comicforge-0.2.2}/comicforge/inspire.py

@@ -76,7 +76,8 @@ def load_items(path: Path) -> list[Item]:
     Each entry needs an id (``id`` / ``name``) and a description
     (``prompt`` / ``description`` / ``desc``).
     """
-    data = yaml.safe_load(path.read_text(encoding="utf-8"))
+    text = path.read_text(encoding="utf-8")
+    data = yaml.safe_load(text)
     raw = data.get("items", []) if isinstance(data, dict) else data
     if not isinstance(raw, list):
         # malformed config, not a type bug -> ValueError is the right contract

{comicforge-0.2.1 → comicforge-0.2.2}/comicforge/scene.py

@@ -1,4 +1,4 @@
-"""Load the scene library and compose a scene background.
+"""Load the scene library and compose a scene background (base + overlays).
 
 A scene is a directory mirroring a character:
     base.svg, <slot>-<variant>.svg, scene.yaml

comicforge-0.2.2/hooks/pre-commit

@@ -0,0 +1,4 @@
+#!/bin/sh
+root=$(git rev-parse --show-toplevel)
+[ -x "$root/.venv/bin/madoqua" ] && exec "$root/.venv/bin/madoqua" run
+exec madoqua run

{comicforge-0.2.1 → comicforge-0.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "comicforge"
-version = "0.2.1"
+version = "0.2.2"
 description = "A tiny, scriptable comic-page engine — author comics as YAML, render to SVG / PNG / PDF"
 readme = "README.md"
 requires-python = ">=3.13"
@@ -52,6 +52,11 @@ dev = [
     "deptry",
     "biston>=0.5.0",
     "poethepoet",
+    "madoqua>=0.2.2",
+    "gerenuk>=0.3.1",
+    "zorilla>=0.2.1",
+    "pycoati>=0.2.7",
+    "ty-find>=0.5.0",
 ]
 
 [tool.ruff]
@@ -96,3 +101,21 @@ min_confidence = 80
 
 [tool.poe]
 include = "poe_tasks.toml"
+
+# --- aesop toolbox -----------------------------------------------------------
+# madoqua is the commit hook (hooks/pre-commit shim; `uv run madoqua install`
+# once per clone). Fix phase: ruff check --fix, ruff format. Check phase: ruff
+# check, ty check, plus the siblings below. See CLAUDE.md "Toolbox".
+[tool.madoqua]
+extend_check = [
+    # madoqua appends the staged .py files. biston reads them as --focus-args focus
+    # files (only clone pairs touching a staged file); zorilla lints exactly those.
+    { name = "biston",  cmd = "biston scan --focus-args", timeout_s = 60,  max_output_lines = 80 },
+    { name = "zorilla", cmd = "zorilla check",            timeout_s = 30,  max_output_lines = 80 },
+    # gerenuk scopes itself from the git diff, so no file list. `-o addopts=`
+    # drops the --cov from [tool.pytest.ini_options] in the hook (same as `poe test`).
+    { name = "gerenuk", cmd = "gerenuk run -- -q -o addopts=", pass_files = false, timeout_s = 120, max_output_lines = 120 },
+]
+
+[tool.biston.scan]
+exclude = ["tests/**", "**/conftest.py"]

{comicforge-0.2.1 → comicforge-0.2.2}/uv.lock

@@ -47,13 +47,13 @@ wheels = [
 
 [[package]]
 name = "biston"
-version = "0.5.0"
+version = "0.7.2"
 source = { registry = "https://pypi.org/simple" }
-sdist = { url = "https://files.pythonhosted.org/packages/e1/35/ac5828c2744716da22aa52af700cd9521781b914045f264a9ab53654108d/biston-0.5.0.tar.gz", hash = "sha256:289b1a9a6d8811b04fb049ef01cc4834f2c37434e8235bad01892012d01b79ea", size = 882675, upload-time = "2026-04-16T21:39:38.738Z" }
+sdist = { url = "https://files.pythonhosted.org/packages/88/42/08c323c5bd20b274aa6576192c1a07a089e70413a73e7da9cea0713ae029/biston-0.7.2.tar.gz", hash = "sha256:04d0245f75f535a726768866f97d60bbf7ad862ccd45345a84280a971ac063bf", size = 973137, upload-time = "2026-09-06T09:43:50.91Z" }
 wheels = [
-    { url = "https://files.pythonhosted.org/packages/44/97/e255f980ba62ff27cd2d212a66562eb20d804c3d3a5779aadfc583dab59a/biston-0.5.0-py3-none-macosx_11_0_arm64.whl", hash = "sha256:fb63fbca3d059c8bb750d79de016e1d606e577b83b5c513931679323c995756c", size = 1405240, upload-time = "2026-04-16T21:39:33.562Z" },
-    { url = "https://files.pythonhosted.org/packages/ae/ae/c5b9bcbdbd7eafa4001169275b4d4f2f1f96ef12bc35140c95a5dc9b3a2d/biston-0.5.0-py3-none-manylinux_2_28_x86_64.whl", hash = "sha256:6836af938703d5a1248204729432f9c42115eb4123ae838a405ac8e69e0897d8", size = 1623075, upload-time = "2026-04-16T21:39:35.316Z" },
-    { url = "https://files.pythonhosted.org/packages/e2/62/0da884c32b256b56ee61d91ae55de4082dff5841984bf6644431eed9b1f1/biston-0.5.0-py3-none-win_amd64.whl", hash = "sha256:e2cf9ebf029958eb1e78215df301cc6d5b8885e2d6b80f744ba47c9c0285c289", size = 1477973, upload-time = "2026-04-16T21:39:37.063Z" },
+    { url = "https://files.pythonhosted.org/packages/05/2a/f7549966fa83f73237c95f0e1c7c154197e3dac8d514ce74c07665c7e42d/biston-0.7.2-py3-none-macosx_11_0_arm64.whl", hash = "sha256:8dd795b2f48bb60a9f8942187b9c0eb55fbe13d3f0f22ec2bde524a830c2d31b", size = 1515854, upload-time = "2026-09-06T09:43:45.099Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/bb/ea8082d3234e5ab538d26f13fe65fe05cc153c5f92be07e2e03663515cc5/biston-0.7.2-py3-none-manylinux_2_28_x86_64.whl", hash = "sha256:e68b7d10c0c5359f75dc52630b1124d16f8af1794154dc3be873569de5cb1ffc", size = 1750729, upload-time = "2026-09-06T09:43:46.991Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/ca/a09aea13c2cbfce4cef26f1a68594c1634b632bf645ddb578760fbbb9fc6/biston-0.7.2-py3-none-win_amd64.whl", hash = "sha256:490037b14cf366a53d49edc1ae10258de3a794f4b5742653ad17f9ce8b0afd7b", size = 1603046, upload-time = "2026-09-06T09:43:49.098Z" },
 ]
 
 [[package]]
@@ -276,7 +276,7 @@ wheels = [
 
 [[package]]
 name = "comicforge"
-version = "0.2.1"
+version = "0.2.2"
 source = { editable = "." }
 dependencies = [
     { name = "cairosvg" },
@@ -294,12 +294,17 @@ inspire = [
 dev = [
     { name = "biston" },
     { name = "deptry" },
+    { name = "gerenuk" },
+    { name = "madoqua" },
     { name = "poethepoet" },
+    { name = "pycoati" },
     { name = "pytest" },
     { name = "pytest-cov" },
     { name = "ruff" },
     { name = "ty" },
+    { name = "ty-find" },
     { name = "vulture" },
+    { name = "zorilla" },
 ]
 docs = [
     { name = "mkdocs-material" },
@@ -319,12 +324,17 @@ provides-extras = ["inspire"]
 dev = [
     { name = "biston", specifier = ">=0.5.0" },
     { name = "deptry" },
+    { name = "gerenuk", specifier = ">=0.3.1" },
+    { name = "madoqua", specifier = ">=0.2.2" },
     { name = "poethepoet" },
+    { name = "pycoati", specifier = ">=0.2.7" },
     { name = "pytest" },
     { name = "pytest-cov" },
     { name = "ruff" },
     { name = "ty" },
+    { name = "ty-find", specifier = ">=0.5.0" },
     { name = "vulture" },
+    { name = "zorilla", specifier = ">=0.2.1" },
 ]
 docs = [{ name = "mkdocs-material", specifier = ">=9.5" }]
 
@@ -442,6 +452,20 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/c7/7f/cd6b3ac8cf95f2f1c5c7a74ff6452e9098af89a9b56607381f677880641e/deptry-0.25.1-cp310-abi3-win_arm64.whl", hash = "sha256:6efffd8116fb9d2c45a251382ce4ce1c38dbb17179f581ec9231ed5390f7fc12", size = 1647020, upload-time = "2026-03-18T23:22:23.311Z" },
 ]
 
+[[package]]
+name = "gerenuk"
+version = "0.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "ty-find" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b6/d7/30c04740c694ebe0a6bfd17ecb90553ee41274033adeae787cfb369ce31d/gerenuk-0.3.1.tar.gz", hash = "sha256:0938a056fc46440f3b3a83c465526247f1815f05ed0aab26401cd8bdd8b3b727", size = 1057582, upload-time = "2026-09-06T10:17:40.989Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1d/5a/97341a2ab50e0fd73b812878d459bceec2edd54359555ba0ee4e4ce7afc2/gerenuk-0.3.1-py3-none-macosx_11_0_arm64.whl", hash = "sha256:e33289016c58ec81b1afbac0c1ae59ce2caddde2264a29f46d70bce7f7030af2", size = 1156041, upload-time = "2026-09-06T10:17:36.762Z" },
+    { url = "https://files.pythonhosted.org/packages/1b/b9/2644c11616691979f0025be61269f4be04442c79fbd7d814b26b1ac59f32/gerenuk-0.3.1-py3-none-manylinux_2_28_x86_64.whl", hash = "sha256:d80528e96c195133a9cc2c7f0470413c97dceab86afd1437a213e96e78479c55", size = 1321715, upload-time = "2026-09-06T10:17:38.138Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/1e/8039f351bcbc75f4b648ac2a98c58e832a3b41bbf354751b64300820fa5b/gerenuk-0.3.1-py3-none-win_amd64.whl", hash = "sha256:82e47509c9f101298d2a3c865fa3a9c4977f7fa632b11be6e190c4dbb79d76e9", size = 1224539, upload-time = "2026-09-06T10:17:39.69Z" },
+]
+
 [[package]]
 name = "ghp-import"
 version = "2.1.0"
@@ -521,6 +545,17 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/62/a1/3d680cbfd5f4b8f15abc1d571870c5fc3e594bb582bc3b64ea099db13e56/jinja2-3.1.6-py3-none-any.whl", hash = "sha256:85ece4451f492d0c13c5dd7c13a64681a86afae63a5f347908daf103ce6d2f67", size = 134899, upload-time = "2025-03-05T20:05:00.369Z" },
 ]
 
+[[package]]
+name = "madoqua"
+version = "0.2.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/9d/47/b638680853d3a3fd05678acb31c125b2ee73c083998f45118fd201f01623/madoqua-0.2.2.tar.gz", hash = "sha256:799f70ae2eebaf8e3d8e296a1bc6af96459aa5ad6d6f683d2d0e85d2ef186d92", size = 886386, upload-time = "2026-09-06T10:16:31.566Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5c/c1/558f9dff51b20e30297dfe144564313ca5eec797372e91af46e19883f0fd/madoqua-0.2.2-py3-none-macosx_11_0_arm64.whl", hash = "sha256:465a237666d16fa3365b92cfa58750e5bb94f8a95f7c6a3c022ffd342c6ff0e6", size = 756092, upload-time = "2026-09-06T10:16:26.915Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/e0/edffd6b495454d77ece7a0bf522f7028f0ec6db60a4554cdd2c96c1890f3/madoqua-0.2.2-py3-none-manylinux_2_28_x86_64.whl", hash = "sha256:f56ee6598683e276dcf5a00fccec2960cd166a8c4aa1dda61c82c6ef5c2de31f", size = 867899, upload-time = "2026-09-06T10:16:28.644Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/ab/16170ffe43b4b0a088cf29507fe8102533a68afa620fa8d696c3f4c2dddd/madoqua-0.2.2-py3-none-win_amd64.whl", hash = "sha256:8cde9b4a776a39c6b92d72379c9d72f0de77e4019967a5ed7c275e1793b39725", size = 775267, upload-time = "2026-09-06T10:16:30.077Z" },
+]
+
 [[package]]
 name = "markdown"
 version = "3.10.3"
@@ -810,6 +845,17 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/af/01/a9d6ea30351919298d3dc237172ae6a60ce0224ecaaee289b671ab979c13/poethepoet-0.46.0-py3-none-any.whl", hash = "sha256:dc6d770a14792d124abac9066c5a707876027d1878ac9ca26cf57e9b2a96dc89", size = 150581, upload-time = "2026-05-15T15:52:01.118Z" },
 ]
 
+[[package]]
+name = "pycoati"
+version = "0.2.7"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/73/48/32a8a15278bf6d9fd32ae649988196f80a3fe7713fc9a239e0defa284e3b/pycoati-0.2.7.tar.gz", hash = "sha256:8479936109209afdf897576fab87b0a09b6d426815853db5f443583ba0d29d19", size = 145027, upload-time = "2026-09-06T10:16:32.865Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/92/77/428eb4adaa1e975d81bca60b18b373ec867301a643e5cde76eef8364aa60/pycoati-0.2.7-py3-none-macosx_11_0_arm64.whl", hash = "sha256:9599833af88090e77025131a9903abcec274aadfe445cb8ef27c29e50b32fa68", size = 1381423, upload-time = "2026-09-06T10:16:27.856Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/56/a5ac29ba05decede07697cf016c3de438205a1223dae2df424f46d223745/pycoati-0.2.7-py3-none-manylinux_2_28_x86_64.whl", hash = "sha256:83dcf7fee42e6b57720e9866526798a4a5f33053584e712818f151e593d523d2", size = 1596183, upload-time = "2026-09-06T10:16:29.778Z" },
+    { url = "https://files.pythonhosted.org/packages/04/21/c1b336047dd795cac09c1f95d7d57d04c66bc30fe4fa5afc51fbbe1804f3/pycoati-0.2.7-py3-none-win_amd64.whl", hash = "sha256:55923c3450026564925b2cde9784aae9bcf7642281c9662368dcfc6f903bc01f", size = 1472390, upload-time = "2026-09-06T10:16:31.404Z" },
+]
+
 [[package]]
 name = "pycparser"
 version = "3.0"
@@ -1173,6 +1219,17 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/ef/a2/8959249da951ba3977fee20e688d28678b8a1d30a9ed4464228a85d45853/ty-0.0.49-py3-none-win_arm64.whl", hash = "sha256:75d5e2e7649765f31f4bed6c8adb149a75b18edd3fa6336dac4d0efc1a66466f", size = 11558965, upload-time = "2026-06-12T03:08:23.012Z" },
 ]
 
+[[package]]
+name = "ty-find"
+version = "0.5.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c0/01/e96f1bde06497386f9cb3a33225aa19b0a7aa07e2adef184ffe108d2468e/ty_find-0.5.0.tar.gz", hash = "sha256:bab7b8a107048271431853d02ac988ed65a9566cd19c3db8f801efe6ff5c1172", size = 1045795, upload-time = "2026-09-06T09:42:18.33Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/01/81/9b5d590d72393b7092b83ca575e35320295de61911e9448bba152c6fa021/ty_find-0.5.0-py3-none-macosx_11_0_arm64.whl", hash = "sha256:41b641f3c43421d1500b1c796b437772d7b49863229bfd3ce247506d9c9edd83", size = 1262109, upload-time = "2026-09-06T09:42:12.622Z" },
+    { url = "https://files.pythonhosted.org/packages/95/9d/1f5f744ad14f3259a03737c03b7d9d4f936969f91314f77627e3d0c42adb/ty_find-0.5.0-py3-none-manylinux_2_28_x86_64.whl", hash = "sha256:fed1dca32166800d391eb681050145104795418b7ac1413eb0987f88e6c4e9b7", size = 1443249, upload-time = "2026-09-06T09:42:14.728Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/e6/40493d4edf785ed26220d7e0ce56b4e5fe27175ed728e683c72717667c67/ty_find-0.5.0-py3-none-win_amd64.whl", hash = "sha256:dd2aca8b306b415a1bae6cc075201b287b95e78dd40d655b8c448e9c264b4661", size = 924217, upload-time = "2026-09-06T09:42:16.563Z" },
+]
+
 [[package]]
 name = "typing-extensions"
 version = "4.15.0"
@@ -1241,3 +1298,14 @@ sdist = { url = "https://files.pythonhosted.org/packages/0b/02/ae6ceac1baeda5308
 wheels = [
     { url = "https://files.pythonhosted.org/packages/f4/24/2a3e3df732393fed8b3ebf2ec078f05546de641fe1b667ee316ec1dcf3b7/webencodings-0.5.1-py2.py3-none-any.whl", hash = "sha256:a0af1213f3c2226497a97e2b3aa01a7e4bee4f403f95be16fc9acd2947514a78", size = 11774, upload-time = "2017-04-05T20:21:32.581Z" },
 ]
+
+[[package]]
+name = "zorilla"
+version = "0.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/eb/5a/601682072eafda550b7441ff30af74bd729a6b1618221c8929efcefa6828/zorilla-0.2.1.tar.gz", hash = "sha256:565e57d75bd2cb05519e73ebdbe0fe821362329d1748b4443122db255f82519c", size = 146975, upload-time = "2026-09-06T09:44:02.027Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0b/b0/e8da970248940cd0135b5dd119df4dd142f8b2eaea4f3b124fa9f5a03da0/zorilla-0.2.1-py3-none-macosx_11_0_arm64.whl", hash = "sha256:d5022e7ecd35e9f82486ba51d54b1f128261ae6f067cd8c6c009017d2b3b1ca9", size = 1190635, upload-time = "2026-09-06T09:43:57.396Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/24/b1f7ed13b369a29b0277079192e88e6b5dc431004c0ef0ff61bf65117788/zorilla-0.2.1-py3-none-manylinux_2_28_x86_64.whl", hash = "sha256:74d68dc2ae4e681380e818a3aa9c032f904685d613249a9d8d3371c1eef61236", size = 1386039, upload-time = "2026-09-06T09:43:59.027Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/a1/9fcda70e96ca6eadad92a42ed93cd46b5aa63508d21554837791eafec370/zorilla-0.2.1-py3-none-win_amd64.whl", hash = "sha256:c1a6c1fb8e6ce0f6724eb782e41fb4eb607fc78e1346ee8027f2c165d0109727", size = 1261320, upload-time = "2026-09-06T09:44:00.554Z" },
+]