mirror of
https://github.com/yogeshojha/rengine.git
synced 2026-10-20 23:31:31 +02:00
The comment rule in CLAUDE.md is one line maximum, never narration: no multi-line blocks, no module-header explainers, no sentences that explain or justify the code to the reader. The tree had drifted a long way from it, and most of the drift is mine. Removed: 232 lines of multi-line comment blocks 203 single-line comments that argued instead of stating 154 comments joined by so/because/otherwise/rather-than 143 narrating comments in the frontend 112 test docstrings (the test name already says what it asserts) 25 test module docstrings and 25 decorative section dividers Collapsed: 324 multi-line docstrings to one factual line 271 one-line docstrings that had a justifying clause bolted on Kept: functional directives, section dividers, short field labels, alembic revision headers, and the eight FastAPI route docstrings that render in /docs. Where a fact was load-bearing it is in CLAUDE.md, which is where it belongs. 284 python tests and 34 frontend tests pass, ruff and ruff-format clean across ten packages, svelte-check 0 errors, prettier and eslint clean, app.main imports. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_013dKUV96WkQQETZBMoAG98C
41 lines
1.1 KiB
Python
41 lines
1.1 KiB
Python
"""Tools are discovered by module."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import importlib
|
|
from functools import lru_cache
|
|
from pathlib import Path
|
|
|
|
from shared.logging import get_logger
|
|
from toolbox.base import Tool
|
|
|
|
logger = get_logger(__name__)
|
|
|
|
_SKIP = {"__init__"}
|
|
|
|
|
|
@lru_cache(maxsize=1)
|
|
def discover() -> dict[str, type[Tool]]:
|
|
found: dict[str, type[Tool]] = {}
|
|
for module in sorted(Path(__file__).parent.glob("*.py")):
|
|
if module.stem in _SKIP or module.stem.startswith("_"):
|
|
continue
|
|
try:
|
|
namespace = importlib.import_module(f"toolbox.tools.{module.stem}")
|
|
except Exception as exc:
|
|
logger.warning("toolbox tool skipped", module=module.stem, error=str(exc))
|
|
continue
|
|
for obj in vars(namespace).values():
|
|
if (
|
|
isinstance(obj, type)
|
|
and issubclass(obj, Tool)
|
|
and obj is not Tool
|
|
and not getattr(obj, "__abstractmethods__", None)
|
|
and getattr(obj, "name", None)
|
|
):
|
|
found.setdefault(obj.name, obj)
|
|
return found
|
|
|
|
|
|
__all__ = ["discover"]
|