jan/masque
1
1
Fork 0
Code Issues Pull requests Releases Wiki Activity

misc doc updates

Browse source
This commit is contained in:
Jan Petykiewicz 2026-07-13 14:58:09 -07:00
commit ddb7742493
4 changed files with 25 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

13
MIGRATION.md
View file

@ -421,6 +421,10 @@ may add explicit probes. Empty discovery is an error unless
Validation returns normally on success and otherwise raises an
`ExceptionGroup` of contextual `ToolContractError`s.
Run this validation during Tool development, testing, or application startup.
It is the comprehensive semantic preflight for custom Tools; those checks are
intentionally not repeated for every offer evaluation in the routing hot path.
Positional routing bounds (`p`, `pos`, `position`, `x`, and `y`) now require a
nearly Manhattan input-port direction. Arbitrarily angled ports remain valid
for non-positional/extension routing.
@ -449,9 +453,12 @@ import it from user code.
`trace_into()` uses the same primitive-offer route selection and now searches
bounded route topologies with up to four bend roles. This preserves the common
straight, bend, S-like, U-like, and dogleg cases while allowing routes that
need an additional bounded bend pair. Among legal bounded candidates,
`trace_into()` selects the lowest total primitive-offer cost; bend count and
step count are used only to break exact cost ties.
need an additional bounded bend pair. Bend-family requests search one-bend
routes before three-bend routes; other families search zero-to-two-bend routes
before four-bend routes. The first band with a legal route wins. Within that
band, candidates are ordered by total primitive-offer cost, adapter count, step
count, and deterministic discovery order. The route `strategy` affects only
that final discovery-order tie-break.
Explicit-length `jog()` routes may also be satisfied by composing a straight
primitive before or after an omitted-length native S primitive. `uturn()` routes