Remove parent-resolution from wool.routine wrapper — Closes #118

[conradbzura]

Summary

Remove _resolve() and its associated classmethod/staticmethod descriptor handling from wool.routine. The decorator now operates directly on the raw function passed to it, eliminating the per-invocation sys.modules walk that produced distinct class objects across workers and broke exception identity in nested dispatch scenarios.

@wool.routine now raises ValueError when applied to a classmethod or staticmethod descriptor. The correct decorator order is @classmethod @wool.routine (descriptor outer, routine inner). An info admonition documenting this requirement is added to the routine() docstring.

Closes #118

Proposed changes

Remove _resolve and simplify dispatch internals

_resolve() walked sys.modules[fn.__module__] using fn.__qualname__ to re-resolve the decorated function on every call. On spawned workers the re-imported module lives under __mp_main__, producing a different function object whose globals reference different class objects — breaking isinstance checks and except clauses for user-defined exceptions in nested dispatch.

With _resolve removed, the wrappers pass fn (the original closure-captured function) directly to _dispatch, _stream, and _execute. The parent parameter and the classmethod/staticmethod branch logic in _stream and _execute are also removed since the decorator now always receives the raw function.

Add descriptor guard with clear error message

A new guard at the top of routine() raises ValueError("@wool.routine must be applied before @classmethod/@staticmethod") when passed a descriptor object. This gives an actionable error message instead of the generic "Expected a coroutine function" that would otherwise fire.

Update decorator order in test fixtures and integration routines

All @routine @classmethod / @routine @staticmethod usages in test fixtures and integration routine definitions are flipped to the correct @classmethod @routine / @staticmethod @routine order.

Test cases

#	Test Suite	Given	When	Then	Coverage Target
1	(module)	@routine applied to a classmethod descriptor	Decorator is evaluated	ValueError with message about correct order	Descriptor guard (classmethod)
2	(module)	@routine applied to a staticmethod descriptor	Decorator is evaluated	ValueError with message about correct order	Descriptor guard (staticmethod)
3	(module)	@routine on various function types with dispatch enabled	Decorated function is called	Task is dispatched and result returned correctly	Dispatch path for all 8 function types
4	(module)	@routine on various function types with dispatch disabled	Decorated function is called	Function executes locally and result returned correctly	Local execution path for all 8 function types