jackherd 1.7.0 → 1.8.0

package/docs/workflow.svg

@@ -1,4 +1,4 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="960" height="708" viewBox="0 0 960 708" role="img" aria-labelledby="t d"><title id="t">jackherd in herdr</title><desc id="d">Animated schematic of one herdr window, told in five numbered steps. 1, Lane search works: its state is a teal dot and its progress counts up. 2, It hits an open question: search turns to an amber diamond and sends the question as text. 3, The coordinator asks you: the question appears in the coordinator pane as a choice. 4, You pick: option 1 is selected. 5, The lane works on: the answer goes back to search, which is a teal dot again, and the herd counts one more box.</desc><defs><style>.s{font-family:ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif}.m{font-family:ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace}@keyframes k1{0%{opacity:1.0}0%{opacity:1.0}38.12%{opacity:1.0}40%{opacity:0.42}80%{opacity:0.42}81.88%{opacity:1.0}100%{opacity:1.0}}.k1{animation:k1 16s linear infinite both}@keyframes k2{0%{opacity:0.42}40%{opacity:0.42}41.88%{opacity:1.0}81.88%{opacity:1.0}83.75%{opacity:0.42}100%{opacity:0.42}}.k2{animation:k2 16s linear infinite both}@keyframes k3{0%{opacity:0.42}100%{opacity:0.42}}.k3{animation:k3 16s linear infinite both}@keyframes k4{0%{opacity:0}21.25%{opacity:0}23.75%{opacity:1}82.5%{opacity:1}85%{opacity:0}100%{opacity:0}}.k4{animation:k4 16s linear infinite both}@keyframes k5{0%{opacity:0;transform:translate(64px,198px)}23.75%{opacity:0;transform:translate(64px,198px)}23.94%{opacity:1;transform:translate(64px,198px)}24.32%{opacity:1;transform:translate(60.4px,197.5px)}24.9%{opacity:1;transform:translate(57.1px,196.1px)}25.47%{opacity:1;transform:translate(54.2px,193.9px)}26.04%{opacity:1;transform:translate(51.6px,191.1px)}26.61%{opacity:1;transform:translate(49.4px,187.6px)}27.19%{opacity:1;transform:translate(47.6px,183.8px)}27.76%{opacity:1;transform:translate(46.3px,179.6px)}28.33%{opacity:1;transform:translate(45.4px,175.2px)}28.91%{opacity:1;transform:translate(45px,170.7px)}29.48%{opacity:1;transform:translate(45.1px,166.3px)}30.05%{opacity:1;transform:translate(45.8px,162px)}30.63%{opacity:0;transform:translate(47px,158px)}100%{opacity:0;transform:translate(47px,158px)}}.k5{animation:k5 16s linear infinite both}@keyframes k6{0%{opacity:0;transform:translate(47px,158px)}81.25%{opacity:0;transform:translate(47px,158px)}81.44%{opacity:1;transform:translate(47px,158px)}81.67%{opacity:1;transform:translate(45.8px,162px)}82.08%{opacity:1;transform:translate(45.1px,166.3px)}82.5%{opacity:1;transform:translate(45px,170.7px)}82.92%{opacity:1;transform:translate(45.4px,175.2px)}83.33%{opacity:1;transform:translate(46.3px,179.6px)}83.75%{opacity:1;transform:translate(47.6px,183.8px)}84.17%{opacity:1;transform:translate(49.4px,187.6px)}84.58%{opacity:1;transform:translate(51.6px,191.1px)}85%{opacity:1;transform:translate(54.2px,193.9px)}85.42%{opacity:1;transform:translate(57.1px,196.1px)}85.83%{opacity:1;transform:translate(60.4px,197.5px)}86.25%{opacity:0;transform:translate(64px,198px)}100%{opacity:0;transform:translate(64px,198px)}}.k6{animation:k6 16s linear infinite both}@keyframes k7{0%{opacity:0}31.25%{opacity:0}33.75%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k7{animation:k7 16s linear infinite both}@keyframes k8{0%{opacity:0}41.25%{opacity:0}43.75%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k8{animation:k8 16s linear infinite both}@keyframes k9{0%{opacity:0}63.75%{opacity:0}66.25%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k9{animation:k9 16s linear infinite both}@keyframes k10{0%{opacity:0}68.75%{opacity:0}71.25%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k10{animation:k10 16s linear infinite both}@keyframes k11{0%{opacity:0}81.25%{opacity:0}83.75%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k11{animation:k11 16s linear infinite both}@keyframes k12{0%{opacity:1}21.25%{opacity:1}23.75%{opacity:0}82.5%{opacity:0}85%{opacity:1}100%{opacity:1}}.k12{animation:k12 16s linear infinite both}@keyframes k13{0%{opacity:0}8.75%{opacity:0}10.62%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k13{animation:k13 16s linear infinite both}@keyframes k14{0%{opacity:0}88.75%{opacity:0}90.62%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k14{animation:k14 16s linear infinite both}@keyframes k15{0%{opacity:1}8.75%{opacity:1}10.62%{opacity:0}96.25%{opacity:0}100%{opacity:1}}.k15{animation:k15 16s linear infinite both}@keyframes k16{0%{opacity:0}8.75%{opacity:0}10.62%{opacity:1}88.75%{opacity:1}90.62%{opacity:0}100%{opacity:0}}.k16{animation:k16 16s linear infinite both}@keyframes k17{0%{opacity:0}88.75%{opacity:0}90.62%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k17{animation:k17 16s linear infinite both}@keyframes k18{0%{opacity:1}8.75%{opacity:1}10.62%{opacity:0}96.25%{opacity:0}100%{opacity:1}}.k18{animation:k18 16s linear infinite both}@keyframes k19{0%{opacity:0}8.75%{opacity:0}10.62%{opacity:1}88.75%{opacity:1}90.62%{opacity:0}100%{opacity:0}}.k19{animation:k19 16s linear infinite both}@keyframes k20{0%{opacity:0}88.75%{opacity:0}90.62%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k20{animation:k20 16s linear infinite both}@keyframes k21{0%{opacity:1}18.13%{opacity:1}20%{opacity:0}100%{opacity:0}}.k21{animation:k21 16s linear infinite both}@keyframes k22{0%{opacity:1}18.13%{opacity:1}20%{opacity:0.62}100%{opacity:0.62}}.k22{animation:k22 16s linear infinite both}@keyframes k23{0%{opacity:0}20%{opacity:0}21.88%{opacity:1}38.12%{opacity:1}40%{opacity:0}100%{opacity:0}}.k23{animation:k23 16s linear infinite both}@keyframes k24{0%{opacity:0.62}20%{opacity:0.62}21.88%{opacity:1.0}38.12%{opacity:1.0}40%{opacity:0.62}100%{opacity:0.62}}.k24{animation:k24 16s linear infinite both}@keyframes k25{0%{opacity:0}40%{opacity:0}41.88%{opacity:1}58.12%{opacity:1}60%{opacity:0}100%{opacity:0}}.k25{animation:k25 16s linear infinite both}@keyframes k26{0%{opacity:0.62}40%{opacity:0.62}41.88%{opacity:1.0}58.12%{opacity:1.0}60%{opacity:0.62}100%{opacity:0.62}}.k26{animation:k26 16s linear infinite both}@keyframes k27{0%{opacity:0}60%{opacity:0}61.88%{opacity:1}78.12%{opacity:1}80%{opacity:0}100%{opacity:0}}.k27{animation:k27 16s linear infinite both}@keyframes k28{0%{opacity:0.62}60%{opacity:0.62}61.88%{opacity:1.0}78.12%{opacity:1.0}80%{opacity:0.62}100%{opacity:0.62}}.k28{animation:k28 16s linear infinite both}@keyframes k29{0%{opacity:0}80%{opacity:0}81.88%{opacity:1}98.12%{opacity:1}100%{opacity:0}}.k29{animation:k29 16s linear infinite both}@keyframes k30{0%{opacity:0.62}80%{opacity:0.62}81.88%{opacity:1}98.12%{opacity:1}100%{opacity:0.62}}.k30{animation:k30 16s linear infinite both}@media (prefers-reduced-motion:reduce){*{animation:none!important}}</style><clipPath id="jack-clip"><rect width="240" height="240" rx="50"/></clipPath><symbol id="jack" viewBox="0 0 240 240"><rect width="240" height="240" rx="50" fill="#212E34"/><g clip-path="url(#jack-clip)"><g transform="translate(34 8)"><path fill="#4A4E51" d="M80 50.5c.2 .1 .2 .1 1 1c-.2 .6-.3 1.3-.5 2c-.7 .4-.7 .4-4 2c-6 3.3-6 3.3-7 6.5c1.2-.4 2.3-.6 3.5-1c.8 0 1.7 0 2.5 0c.2 .1 .2 .1 1 1c-.5 2-.5 2-5.5 6.5c-3 5-3 5-5.5 11c.2 .3 .2 .3 1 2c.2 .3 .3 .7 .5 1c-.7 .7-1.3 1.3-2 2c-1.3-.2-2.6-.3-4-.5c0-1.2 0-2.3 0-3.5c-.2 .1-.2 .1-1.5 .5c-1.2 2.7-2.4 5.3-3.5 8c-1 2.1-2 4.2-3 6.3c-2.5 5.7-2.5 5.7-3 8.2c.5 0 1 0 1.5 0c.1-.8 .4-1.7 .5-2.5c.6 0 1.3 0 2 0c.5 2 1 3.9 1.6 6c1 4 2.2 8 3.4 11.9c2.1 8.4 1.1 15.5-3 23.1c-.6-.2-1.3-.3-2-.5c-.1-1.5-.3-3-.5-4.6c-.3-2.6-.5-5.2-1-7.9c-.5 0-1 0-1.5 0c-.1 1.7-.4 3.3-.5 5c-2.7 10.2-2.7 10.2-6 13.5c-6.1-3.1-9-14.9-11-21c-1.1-8.2 .9-14.7 3.5-22.5c-8.4 8.3-8.3 20.5-9 31.5c-.6-.2-1.3-.3-2-.5c-5.4-8.9-5.1-15-3-25c.5-1 1-2 1.5-3c-3 1.5-3 1.5-6.5 5c-.4 0-.6 0-1 0c.8-6.5 3.2-10.2 7.5-15c.6-.8 .6-.8 3.5-5c2.6-2.6 5.2-5.1 8-7.5c.6-.6 .6-.6 3.5-3.5c-.5-2-.5-2-1-3.5c3.6-6 6.5-9.2 12.5-13c.4-.6 .6-1.3 1-2c-.5-.6-1-1.3-1.5-2c2-3 2-3 4.5-4.5c.5 1 .5 1 1 3.5c2.5-1 2.5-1 8.5-5.5c.3 0 .7 0 1 0c-.1-.4-.1-.4-.5-2.5c4.3-3.3 10-2.5 15-1zM153 69.5c1.2 .2 2.3 .3 3.5 .5c.3 .7 .7 1.3 1 2c.3 0 .7 0 1 0c.5 1.2 1 2.3 1.5 3.5c3.4 7.6 6.2 13.7 12.2 19.6c3.3 3.4 3.3 3.4 3.8 5.9c-.2 .2-.3 .3-.5 .5c.1 .7 .1 .7 .5 4.5c-.5 .3-1 .7-1.5 1c-.8-.3-1.7-.7-2.5-1c.3 .7 .7 1.3 1 2c1.2 5.8 1.4 10 1 16c-.7 0-1.3 0-2 0c-.4-1.3-.8-2.7-1.3-4.1c-2.1-6.1-5.2-11.4-8.7-16.9c-.2-.8-.2-.8-1.5-5c-.3-.6-.3-.6-2.1-3.5c-1.9-3.5-1.9-3.5-2.9-8.5c.7 0 1.3 0 2 0c.5 .5 1 1 1.5 1.5c-.8-2.3-1.7-4.6-2.5-7c-.7-2-1.3-4-2-6c-.7-1-1.3-2-2-3c.2-.7 .3-1.3 .5-2zM86.5 100.5c1 0 2 0 3 0c1.3 .8 2.7 1.7 4 2.5c-2.5 2.5-2.5 2.5-8 5.5c-5.5 4.3-8.6 7-10 14c-.8 2.2-1.7 4.3-2.5 6.5c-1.2 4.6-.5 9.3 0 14c-.5 0-1 0-1.5 0c-.2 2-.3 3.9-.5 6c-.7 0-1.3 0-2 0c-.3-.6-.3-.6-2-3.5c-1-.8-2-1.7-3-2.5c-.5-1.5-.5-1.5 1.5-8.5c.3-10.3-1-18.2-4-28c0-4 0-4 1-6c2 2 2 2 3 6.5c2.5-.5 2.5-.5 8-4c9.8-3.5 9.8-3.5 13-2.5zM43 161.5c2.5 2.5 2.5 2.5 3 5c-1.5 2.5-1.5 2.5-4 5c.5 3.5 .5 3.5 4 6.5c-.1 1.2-.4 2.3-.5 3.5c-5.3 3.5-5.3 3.5-8.5 3.5c-6-2.5-6-2.5-11.5-7c0-3 0-3 4-8c9.5-8.5 9.5-8.5 13.5-8.5z"/><path fill="#9B9D9E" d="M142.5 60.5c.5 1 .5 1-.5 4.5c1.2 1.5 2.3 3 3.5 4.5c2 4.5 2 4.5 2.5 9.5c-.5 .2-1 .3-1.5 .5c-.1 .2-.1 .2-.5 1c-2-1-3.9-2-6-3c-.8-.3-1.7-.7-2.5-1c-.3-.7-.7-1.3-1-2c.3-.5 .7-1 1-1.5c-.2-.7-.3-1.3-.5-2c-3.5 .5-3.5 .5-7.5 4c-.5 3-.5 3 0 5.5c-2 4-2 4-3.5 5.5c-.3 0-.7 0-1 0c0 .7 0 1.3 0 2c-2-1-2-1-2.5-2.5c.3-13.7 .3-13.7 4.8-18.5c4.1-3.9 6.3-4.8 11.7-6c1-.5 1-.5 3.5-.5zM98 70.5c.5 .3 1 .7 1.5 1c1.3 .3 2.7 .7 4 1c4.4 5.8 6.5 10.3 6.5 17.5c-2 2-2 2-5 2.5c-.3 .2-.3 .2-2 1c-.2-.2-.2-.2-1.5-1c.5-3 .5-3 1-5c-.7-.8-1.3-1.7-2-2.5c-.2-1.7-.3-3.3-.5-5c-4.5-2.7-8.5-3-13.5-2.5c-.1 .3-.1 .3-.5 1.5c1.3 .8 2.7 1.7 4 2.5c-.1 .4-.1 .4-.5 2.5c-2.3 1.2-4.6 2.3-7 3.5c-5.5 5.5-5.5 5.5-6.5 7c0 .5 0 1 0 1.5c.9-.1 .9-.1 5.5-.5c1 1.3 2 2.7 3 4c-.2 .5-.3 1-.5 1.5c-1.7 .5-3.2 1-5 1.6c-5.5 1.9-5.5 1.9-11 5.4c-.4 .1-.4 .1-2.5 .5c-1.5-1.5-1.5-1.5-2.5-6c-.4-.3-.6-.7-1-1c0-6.7 .9-11.7 3-18c.2-.6 .2-.6 1-3.5c7.8-9.7 20.5-14.1 32-9.5z"/><path fill="#FAF9F8" d="M103.5 40c0 .4 0 .6 0 1c2.2-.1 4.3-.4 6.5-.5c7 0 7 0 9.5 1c-.2 .6-.3 1.3-.5 2c-1.8 .6-3.7 1.3-5.5 2c-.2 .5-.3 1-.5 1.5c.7-.1 1.3-.4 2-.5c13.4-.3 13.4-.3 19.5 3.5c-.3 .6-.7 1.3-1 2c-1 0-2 0-3 0c0 .5 0 1 0 1.5c1.2 .1 1.2 .1 7 .5c3.5 2 3.5 2 5.5 4.5c0 1 0 2 0 3c-3.3 .9-6.7 1.6-10 2.5c-7.5 5-7.5 5-8.5 9c-.3 4.5-.4 9-.5 13.5c1.5 1 1.5 1 7.5 2.5c.9 .6 .9 .6 5.5 3.5c2 1 2 1 9 2.5c7.9 4 11.3 8.3 15 16.5c0 .5 0 1 0 1.5c-1 .2-2 .3-3 .5c.5 1.8 1 3.7 1.5 5.5c.3 8.5-.8 13.6-6 20.5c-.7-.2-1.3-.3-2-.5c0-1.7 0-3.3 0-5c-.7 .2-1.3 .3-2 .5c-1.3 2.7-2.7 5.3-4 8c-3.2 3.7-6.4 6.2-11 8c-1-1-1-1-1.5-3c-2.5 1.3-4.8 2.9-7 4.5c-6.3 2.8-10.8 3.2-17.6 1c-1.3-.5-2.6-1-3.9-1.5c.2 1.2 .3 2.3 .5 3.5c-.2 .3-.3 .7-.5 1c-5.9 0-9-1.8-14-5c-3-3.5-3-3.5-3-4.5c-.7 0-1.3 0-2 0c.5 2.2 1 4.3 1.5 6.5c-.3 .3-.7 .7-1 1c-4.5-.9-7.6-3.6-11-6.5c-4-6-4-9.3-4-16.5c2.5-7.5 2.5-7.5 3.5-9.5c.3-1.7 .7-3.3 1-5c6.4-8 14.7-13 24.5-16c6.4-6.3 6.4-6.3 8.5-10.5c0-6-1.6-9.8-4.5-15c-.2-.5-.3-1-.5-1.5c-1.7-.3-3.3-.7-5-1c-1.3-.7-2.7-1.3-4-2c-5.7-1.9-10.2-.3-15.5 1.5c-10 5.5-10 5.5-13 10c-.3-.2-.3-.2-2-1c1.3-6.8 4.6-11.7 9.5-16.5c.5-.3 1-.6 1.5-1c.2-.5 .3-1 .5-1.5c-1 .1-1 .1-6 1c-.3-.4-.7-.6-1-1c.5-2 .5-2 4-6c5-2.5 5-2.5 7.5-3c0-.5 0-1 0-1.5c-10.5-1.5-18.5 1-27 7c-.5 .9-1 1.6-1.5 2.5c-.9 .6-.9 .6-5.5 4c-4 3.5-7.6 7-11 11c-4.6 3.8-8.7 6.8-14 9.5c-.7-.3-1.3-.7-2-1c.2-.7 .3-1.3 .5-2c1.8-1 3.7-2 5.5-3c5.2-4.2 9.7-8.5 14-13.5c3.1-2.8 6.2-5.5 9.5-8c1.3-1.3 2.6-2.6 4-4c5.6-3.6 10.4-6.1 17-7c.5-1 1-2 1.5-3c7.2-2.4 12.5-2.2 20-.5c.2 .1 .2 .1 1 .5c3.5 0 3.5 0 8.5-3.5c1-.5 1-.5 3-.5zM118 92.5c-1 1.2-2 2.3-3 3.5c.5 2.5 .5 2.5 3 5c1.8 .8 3.7 1.7 5.5 2.5c.5 1 .5 1 .5 4.5c-4 4.8-6.1 5-12.5 6c0 .7 0 1.3 0 2c4.7 1.5 7.7 .2 12-1.5c1.2-.7 2.3-1.3 3.5-2c1.3 .3 2.7 .7 4 1c3.5 0 3.5 0 5.5-1.5c-.2-.5-.3-1-.5-1.5c-1.7-.3-3.3-.7-5-1c-2.5-2-2.5-2-3-5.5c2-3 2-3 4-5.5c.5-3.5 .5-3.5-1.5-6.5c-4.3-2.2-8.2-1-12.5 .5zM146 58.5c5.8 1.1 8.3 3.9 12.5 8c3.7 5.9 4.4 7.3 5 14c2.8 6.2 5.4 10 10.5 14.5c5.2 5.2 7.2 10.3 9 17.5c0 3.5 0 3.5-2 11c-.2 1.3-.2 1.3-1 7.5c-3.8 10.7-3.8 10.7-8.5 13.5c-.5 .2-.5 .2-3 1c-1 1.3-2 2.7-3 4c-4.5 3-4.5 3-10.5 5c-2.7-.6-5.3-1.3-8-2c-1.7 1.2-3.3 2.3-5 3.5c-2 1-2 1-4 .5c.5-1.5 .5-1.5 6-5c.3-.3 .3-.3 2-2c2.4 0 4.9 0 7.5 0c.5 .5 1 1 1.5 1.5c4.3-.6 7.1-2.3 10.5-5c3.5-5.5 3.5-5.5 4-7c1.5 0 2.9 0 4.5 0c4.3-8.7 4.6-14 2.5-23.5c-.3-1-.7-2-1-3c.3 .1 .3 .1 2 .5c1.5 2.5 1.5 2.5 1.5 4c.5-.2 1-.3 1.5-.5c-.8-10-4.3-16-11.4-22.8c-3.7-3.8-5.5-6.9-7.6-11.7c-.7-1.5-1.5-2.9-2.3-4.4c-1.7-3.6-1.7-3.6-1.7-5.6c.3-.2 .7-.3 1-.5c-.5-3-.5-3-4.5-7c-2-1-3.9-2-6-3c-.7-.4-1.3-.6-2-1c0-.6 0-1.3 0-2zM33.5 83.5c-1 4-5.1 6.4-8 9c-8.6 8.1-14.6 17.2-15.2 29.2c.3 8.1 .3 8.1 2.2 11.8c.5 0 1 0 1.5 0c.4-2.9 .6-6 1-9c.6 0 1.3 0 2 0c.2 1.3 .4 2.7 .6 4.1c1.8 9.3 5.3 14.8 12.9 20.4c2.3 1.2 4.6 2.3 7 3.5c.7 .6 .7 .6 4.5 3.5c3.5 0 3.5 0 8.5-1.5c1 0 2 0 3 0c-1 2-1 2-2.5 3.5c-6.5 1.7-9.6 .9-16-1.5c-1.1-1-2.3-2-3.5-3c-1.5-.7-2.9-1.3-4.5-2c-3.9-3.4-6.9-6.5-9.5-11c-1.1-.5-2.3-1-3.5-1.5c-5.9-6.7-8-12.7-8-21.5c2.4-12.2 7.2-19.8 16.5-28c4.5-4 4.5-4 6-5.5c3.5-1 3.5-1 5-.5zM50.5 172c2.5 1 2.5 1 7 6.5c6 6.2 12 11.8 18.8 17.1c5.7 4.5 11.3 9.1 16.7 13.9c1.3 1.2 2.7 2.3 4 3.5c.7 .7 1.3 1.3 2 2c-.2 .8-.3 1.7-.5 2.5c-6 2.9-11.7 4-18.5 4c-2.6-2.6-4.3-5.5-5.5-9c-.3 .1-.3 .1-1.5 .5c0 2.3 0 4.6 0 7c-.3 .5-.7 1-1 1.5c-13.3 0-24.6-4.6-34.5-13.5c-4.5-4.5-4.5-4.5-8.5-11c.5-2.5 .5-2.5 4.5-7c5-3 5-3 8-3.5c.5 .3 1 .7 1.5 1c2-.5 2-.5 4-2c.9-4.2 1.7-8.3 2.5-12.5c.4-.3 .6-.7 1-1z"/><path fill="#03B5BD" d="M58.5 149.5c2.5 .5 2.5 .5 7 3.5c9.8 5.2 18.9 7.9 30 8.5c2.2 .5 4.3 1 6.5 1.5c7 0 7 0 9-.5c2.3-.2 4.6-.3 7-.5c3.2-.9 6.3-1.9 9.5-3c1.3-.2 2.7-.3 4-.5c.2 .2 .3 .3 .5 .5c-.8 6.3-4.1 10.2-8 15c-.2 .5-.3 1-.5 1.5c1.7-1 3.3-2 5-3c.7 .2 1.3 .3 2 .5c-3 12.2-9.3 20.3-17.5 29.5c-.7 .7-.7 .7-4 4.5c-1 .8-2 1.7-3 2.5c-3.5-.5-3.5-.5-8-5c-2.3-1.8-4.7-3.7-7-5.5c-2.7-2.2-5.3-4.3-8-6.5c-.8-.6-.8-.6-4.5-3.5c-11-9.3-20.7-18.8-28.5-31c3-4 3-4 8.5-8.5z"/><ellipse cx="94" cy="94" rx="6.5" ry="6.5" fill="#212E34"/><ellipse cx="135" cy="85.6" rx="6.2" ry="5.8" fill="#212E34"/><g fill="#FAF9F8"><circle cx="91.5" cy="91.5" r="2.1"/><circle cx="134.6" cy="84.3" r="2"/></g><ellipse cx="124" cy="93.8" rx="3.4" ry="1.1" fill="#9B9D9E" transform="rotate(-6 124 93.8)"/></g></g><rect x="5" y="5" width="230" height="230" rx="45" fill="none"/></symbol></defs>
+<svg xmlns="http://www.w3.org/2000/svg" width="960" height="724" viewBox="0 0 960 724" role="img" aria-labelledby="t d"><title id="t">jackherd in herdr</title><desc id="d">Animated schematic of one herdr window, told in five numbered steps. 1, Lane search works: its state is a teal dot and its progress counts up. 2, It hits an open question: search turns to an amber diamond and sends the question as text. 3, The coordinator asks you: the question appears in the coordinator pane as a choice. 4, You pick: option 1 is selected. 5, The lane works on: the answer goes back to search, which is a teal dot again, and the herd counts one more box.</desc><defs><style>.s{font-family:ui-sans-serif, system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif}.m{font-family:ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace}@keyframes k1{0%{opacity:1.0}0%{opacity:1.0}38.12%{opacity:1.0}40%{opacity:0.42}80%{opacity:0.42}81.88%{opacity:1.0}100%{opacity:1.0}}.k1{animation:k1 16s linear infinite both}@keyframes k2{0%{opacity:0.42}40%{opacity:0.42}41.88%{opacity:1.0}81.88%{opacity:1.0}83.75%{opacity:0.42}100%{opacity:0.42}}.k2{animation:k2 16s linear infinite both}@keyframes k3{0%{opacity:0.42}100%{opacity:0.42}}.k3{animation:k3 16s linear infinite both}@keyframes k4{0%{opacity:0}21.25%{opacity:0}23.75%{opacity:1}82.5%{opacity:1}85%{opacity:0}100%{opacity:0}}.k4{animation:k4 16s linear infinite both}@keyframes k5{0%{opacity:0;transform:translate(64px,198px)}23.75%{opacity:0;transform:translate(64px,198px)}23.94%{opacity:1;transform:translate(64px,198px)}24.32%{opacity:1;transform:translate(60.4px,197.5px)}24.9%{opacity:1;transform:translate(57.1px,196.1px)}25.47%{opacity:1;transform:translate(54.2px,193.9px)}26.04%{opacity:1;transform:translate(51.6px,191.1px)}26.61%{opacity:1;transform:translate(49.4px,187.6px)}27.19%{opacity:1;transform:translate(47.6px,183.8px)}27.76%{opacity:1;transform:translate(46.3px,179.6px)}28.33%{opacity:1;transform:translate(45.4px,175.2px)}28.91%{opacity:1;transform:translate(45px,170.7px)}29.48%{opacity:1;transform:translate(45.1px,166.3px)}30.05%{opacity:1;transform:translate(45.8px,162px)}30.63%{opacity:0;transform:translate(47px,158px)}100%{opacity:0;transform:translate(47px,158px)}}.k5{animation:k5 16s linear infinite both}@keyframes k6{0%{opacity:0;transform:translate(47px,158px)}81.25%{opacity:0;transform:translate(47px,158px)}81.44%{opacity:1;transform:translate(47px,158px)}81.67%{opacity:1;transform:translate(45.8px,162px)}82.08%{opacity:1;transform:translate(45.1px,166.3px)}82.5%{opacity:1;transform:translate(45px,170.7px)}82.92%{opacity:1;transform:translate(45.4px,175.2px)}83.33%{opacity:1;transform:translate(46.3px,179.6px)}83.75%{opacity:1;transform:translate(47.6px,183.8px)}84.17%{opacity:1;transform:translate(49.4px,187.6px)}84.58%{opacity:1;transform:translate(51.6px,191.1px)}85%{opacity:1;transform:translate(54.2px,193.9px)}85.42%{opacity:1;transform:translate(57.1px,196.1px)}85.83%{opacity:1;transform:translate(60.4px,197.5px)}86.25%{opacity:0;transform:translate(64px,198px)}100%{opacity:0;transform:translate(64px,198px)}}.k6{animation:k6 16s linear infinite both}@keyframes k7{0%{opacity:0}31.25%{opacity:0}33.75%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k7{animation:k7 16s linear infinite both}@keyframes k8{0%{opacity:0}41.25%{opacity:0}43.75%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k8{animation:k8 16s linear infinite both}@keyframes k9{0%{opacity:0}63.75%{opacity:0}66.25%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k9{animation:k9 16s linear infinite both}@keyframes k10{0%{opacity:0}68.75%{opacity:0}71.25%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k10{animation:k10 16s linear infinite both}@keyframes k11{0%{opacity:0}81.25%{opacity:0}83.75%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k11{animation:k11 16s linear infinite both}@keyframes k12{0%{opacity:1}21.25%{opacity:1}23.75%{opacity:0}82.5%{opacity:0}85%{opacity:1}100%{opacity:1}}.k12{animation:k12 16s linear infinite both}@keyframes k13{0%{opacity:0}8.75%{opacity:0}10.62%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k13{animation:k13 16s linear infinite both}@keyframes k14{0%{opacity:0}88.75%{opacity:0}90.62%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k14{animation:k14 16s linear infinite both}@keyframes k15{0%{opacity:1}8.75%{opacity:1}10.62%{opacity:0}96.25%{opacity:0}100%{opacity:1}}.k15{animation:k15 16s linear infinite both}@keyframes k16{0%{opacity:0}8.75%{opacity:0}10.62%{opacity:1}88.75%{opacity:1}90.62%{opacity:0}100%{opacity:0}}.k16{animation:k16 16s linear infinite both}@keyframes k17{0%{opacity:0}88.75%{opacity:0}90.62%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k17{animation:k17 16s linear infinite both}@keyframes k18{0%{opacity:1}8.75%{opacity:1}10.62%{opacity:0}96.25%{opacity:0}100%{opacity:1}}.k18{animation:k18 16s linear infinite both}@keyframes k19{0%{opacity:0}8.75%{opacity:0}10.62%{opacity:1}88.75%{opacity:1}90.62%{opacity:0}100%{opacity:0}}.k19{animation:k19 16s linear infinite both}@keyframes k20{0%{opacity:0}88.75%{opacity:0}90.62%{opacity:1}96.25%{opacity:1}100%{opacity:0}}.k20{animation:k20 16s linear infinite both}@keyframes k21{0%{opacity:1}18.13%{opacity:1}20%{opacity:0}100%{opacity:0}}.k21{animation:k21 16s linear infinite both}@keyframes k22{0%{opacity:1}18.13%{opacity:1}20%{opacity:0.62}100%{opacity:0.62}}.k22{animation:k22 16s linear infinite both}@keyframes k23{0%{opacity:0}20%{opacity:0}21.88%{opacity:1}38.12%{opacity:1}40%{opacity:0}100%{opacity:0}}.k23{animation:k23 16s linear infinite both}@keyframes k24{0%{opacity:0.62}20%{opacity:0.62}21.88%{opacity:1.0}38.12%{opacity:1.0}40%{opacity:0.62}100%{opacity:0.62}}.k24{animation:k24 16s linear infinite both}@keyframes k25{0%{opacity:0}40%{opacity:0}41.88%{opacity:1}58.12%{opacity:1}60%{opacity:0}100%{opacity:0}}.k25{animation:k25 16s linear infinite both}@keyframes k26{0%{opacity:0.62}40%{opacity:0.62}41.88%{opacity:1.0}58.12%{opacity:1.0}60%{opacity:0.62}100%{opacity:0.62}}.k26{animation:k26 16s linear infinite both}@keyframes k27{0%{opacity:0}60%{opacity:0}61.88%{opacity:1}78.12%{opacity:1}80%{opacity:0}100%{opacity:0}}.k27{animation:k27 16s linear infinite both}@keyframes k28{0%{opacity:0.62}60%{opacity:0.62}61.88%{opacity:1.0}78.12%{opacity:1.0}80%{opacity:0.62}100%{opacity:0.62}}.k28{animation:k28 16s linear infinite both}@keyframes k29{0%{opacity:0}80%{opacity:0}81.88%{opacity:1}98.12%{opacity:1}100%{opacity:0}}.k29{animation:k29 16s linear infinite both}@keyframes k30{0%{opacity:0.62}80%{opacity:0.62}81.88%{opacity:1}98.12%{opacity:1}100%{opacity:0.62}}.k30{animation:k30 16s linear infinite both}@media (prefers-reduced-motion:reduce){*{animation:none!important}}</style><clipPath id="jack-clip"><rect width="240" height="240" rx="50"/></clipPath><symbol id="jack" viewBox="0 0 240 240"><rect width="240" height="240" rx="50" fill="#212E34"/><g clip-path="url(#jack-clip)"><g transform="translate(34 8)"><path fill="#4A4E51" d="M80 50.5c.2 .1 .2 .1 1 1c-.2 .6-.3 1.3-.5 2c-.7 .4-.7 .4-4 2c-6 3.3-6 3.3-7 6.5c1.2-.4 2.3-.6 3.5-1c.8 0 1.7 0 2.5 0c.2 .1 .2 .1 1 1c-.5 2-.5 2-5.5 6.5c-3 5-3 5-5.5 11c.2 .3 .2 .3 1 2c.2 .3 .3 .7 .5 1c-.7 .7-1.3 1.3-2 2c-1.3-.2-2.6-.3-4-.5c0-1.2 0-2.3 0-3.5c-.2 .1-.2 .1-1.5 .5c-1.2 2.7-2.4 5.3-3.5 8c-1 2.1-2 4.2-3 6.3c-2.5 5.7-2.5 5.7-3 8.2c.5 0 1 0 1.5 0c.1-.8 .4-1.7 .5-2.5c.6 0 1.3 0 2 0c.5 2 1 3.9 1.6 6c1 4 2.2 8 3.4 11.9c2.1 8.4 1.1 15.5-3 23.1c-.6-.2-1.3-.3-2-.5c-.1-1.5-.3-3-.5-4.6c-.3-2.6-.5-5.2-1-7.9c-.5 0-1 0-1.5 0c-.1 1.7-.4 3.3-.5 5c-2.7 10.2-2.7 10.2-6 13.5c-6.1-3.1-9-14.9-11-21c-1.1-8.2 .9-14.7 3.5-22.5c-8.4 8.3-8.3 20.5-9 31.5c-.6-.2-1.3-.3-2-.5c-5.4-8.9-5.1-15-3-25c.5-1 1-2 1.5-3c-3 1.5-3 1.5-6.5 5c-.4 0-.6 0-1 0c.8-6.5 3.2-10.2 7.5-15c.6-.8 .6-.8 3.5-5c2.6-2.6 5.2-5.1 8-7.5c.6-.6 .6-.6 3.5-3.5c-.5-2-.5-2-1-3.5c3.6-6 6.5-9.2 12.5-13c.4-.6 .6-1.3 1-2c-.5-.6-1-1.3-1.5-2c2-3 2-3 4.5-4.5c.5 1 .5 1 1 3.5c2.5-1 2.5-1 8.5-5.5c.3 0 .7 0 1 0c-.1-.4-.1-.4-.5-2.5c4.3-3.3 10-2.5 15-1zM153 69.5c1.2 .2 2.3 .3 3.5 .5c.3 .7 .7 1.3 1 2c.3 0 .7 0 1 0c.5 1.2 1 2.3 1.5 3.5c3.4 7.6 6.2 13.7 12.2 19.6c3.3 3.4 3.3 3.4 3.8 5.9c-.2 .2-.3 .3-.5 .5c.1 .7 .1 .7 .5 4.5c-.5 .3-1 .7-1.5 1c-.8-.3-1.7-.7-2.5-1c.3 .7 .7 1.3 1 2c1.2 5.8 1.4 10 1 16c-.7 0-1.3 0-2 0c-.4-1.3-.8-2.7-1.3-4.1c-2.1-6.1-5.2-11.4-8.7-16.9c-.2-.8-.2-.8-1.5-5c-.3-.6-.3-.6-2.1-3.5c-1.9-3.5-1.9-3.5-2.9-8.5c.7 0 1.3 0 2 0c.5 .5 1 1 1.5 1.5c-.8-2.3-1.7-4.6-2.5-7c-.7-2-1.3-4-2-6c-.7-1-1.3-2-2-3c.2-.7 .3-1.3 .5-2zM86.5 100.5c1 0 2 0 3 0c1.3 .8 2.7 1.7 4 2.5c-2.5 2.5-2.5 2.5-8 5.5c-5.5 4.3-8.6 7-10 14c-.8 2.2-1.7 4.3-2.5 6.5c-1.2 4.6-.5 9.3 0 14c-.5 0-1 0-1.5 0c-.2 2-.3 3.9-.5 6c-.7 0-1.3 0-2 0c-.3-.6-.3-.6-2-3.5c-1-.8-2-1.7-3-2.5c-.5-1.5-.5-1.5 1.5-8.5c.3-10.3-1-18.2-4-28c0-4 0-4 1-6c2 2 2 2 3 6.5c2.5-.5 2.5-.5 8-4c9.8-3.5 9.8-3.5 13-2.5zM43 161.5c2.5 2.5 2.5 2.5 3 5c-1.5 2.5-1.5 2.5-4 5c.5 3.5 .5 3.5 4 6.5c-.1 1.2-.4 2.3-.5 3.5c-5.3 3.5-5.3 3.5-8.5 3.5c-6-2.5-6-2.5-11.5-7c0-3 0-3 4-8c9.5-8.5 9.5-8.5 13.5-8.5z"/><path fill="#9B9D9E" d="M142.5 60.5c.5 1 .5 1-.5 4.5c1.2 1.5 2.3 3 3.5 4.5c2 4.5 2 4.5 2.5 9.5c-.5 .2-1 .3-1.5 .5c-.1 .2-.1 .2-.5 1c-2-1-3.9-2-6-3c-.8-.3-1.7-.7-2.5-1c-.3-.7-.7-1.3-1-2c.3-.5 .7-1 1-1.5c-.2-.7-.3-1.3-.5-2c-3.5 .5-3.5 .5-7.5 4c-.5 3-.5 3 0 5.5c-2 4-2 4-3.5 5.5c-.3 0-.7 0-1 0c0 .7 0 1.3 0 2c-2-1-2-1-2.5-2.5c.3-13.7 .3-13.7 4.8-18.5c4.1-3.9 6.3-4.8 11.7-6c1-.5 1-.5 3.5-.5zM98 70.5c.5 .3 1 .7 1.5 1c1.3 .3 2.7 .7 4 1c4.4 5.8 6.5 10.3 6.5 17.5c-2 2-2 2-5 2.5c-.3 .2-.3 .2-2 1c-.2-.2-.2-.2-1.5-1c.5-3 .5-3 1-5c-.7-.8-1.3-1.7-2-2.5c-.2-1.7-.3-3.3-.5-5c-4.5-2.7-8.5-3-13.5-2.5c-.1 .3-.1 .3-.5 1.5c1.3 .8 2.7 1.7 4 2.5c-.1 .4-.1 .4-.5 2.5c-2.3 1.2-4.6 2.3-7 3.5c-5.5 5.5-5.5 5.5-6.5 7c0 .5 0 1 0 1.5c.9-.1 .9-.1 5.5-.5c1 1.3 2 2.7 3 4c-.2 .5-.3 1-.5 1.5c-1.7 .5-3.2 1-5 1.6c-5.5 1.9-5.5 1.9-11 5.4c-.4 .1-.4 .1-2.5 .5c-1.5-1.5-1.5-1.5-2.5-6c-.4-.3-.6-.7-1-1c0-6.7 .9-11.7 3-18c.2-.6 .2-.6 1-3.5c7.8-9.7 20.5-14.1 32-9.5z"/><path fill="#FAF9F8" d="M103.5 40c0 .4 0 .6 0 1c2.2-.1 4.3-.4 6.5-.5c7 0 7 0 9.5 1c-.2 .6-.3 1.3-.5 2c-1.8 .6-3.7 1.3-5.5 2c-.2 .5-.3 1-.5 1.5c.7-.1 1.3-.4 2-.5c13.4-.3 13.4-.3 19.5 3.5c-.3 .6-.7 1.3-1 2c-1 0-2 0-3 0c0 .5 0 1 0 1.5c1.2 .1 1.2 .1 7 .5c3.5 2 3.5 2 5.5 4.5c0 1 0 2 0 3c-3.3 .9-6.7 1.6-10 2.5c-7.5 5-7.5 5-8.5 9c-.3 4.5-.4 9-.5 13.5c1.5 1 1.5 1 7.5 2.5c.9 .6 .9 .6 5.5 3.5c2 1 2 1 9 2.5c7.9 4 11.3 8.3 15 16.5c0 .5 0 1 0 1.5c-1 .2-2 .3-3 .5c.5 1.8 1 3.7 1.5 5.5c.3 8.5-.8 13.6-6 20.5c-.7-.2-1.3-.3-2-.5c0-1.7 0-3.3 0-5c-.7 .2-1.3 .3-2 .5c-1.3 2.7-2.7 5.3-4 8c-3.2 3.7-6.4 6.2-11 8c-1-1-1-1-1.5-3c-2.5 1.3-4.8 2.9-7 4.5c-6.3 2.8-10.8 3.2-17.6 1c-1.3-.5-2.6-1-3.9-1.5c.2 1.2 .3 2.3 .5 3.5c-.2 .3-.3 .7-.5 1c-5.9 0-9-1.8-14-5c-3-3.5-3-3.5-3-4.5c-.7 0-1.3 0-2 0c.5 2.2 1 4.3 1.5 6.5c-.3 .3-.7 .7-1 1c-4.5-.9-7.6-3.6-11-6.5c-4-6-4-9.3-4-16.5c2.5-7.5 2.5-7.5 3.5-9.5c.3-1.7 .7-3.3 1-5c6.4-8 14.7-13 24.5-16c6.4-6.3 6.4-6.3 8.5-10.5c0-6-1.6-9.8-4.5-15c-.2-.5-.3-1-.5-1.5c-1.7-.3-3.3-.7-5-1c-1.3-.7-2.7-1.3-4-2c-5.7-1.9-10.2-.3-15.5 1.5c-10 5.5-10 5.5-13 10c-.3-.2-.3-.2-2-1c1.3-6.8 4.6-11.7 9.5-16.5c.5-.3 1-.6 1.5-1c.2-.5 .3-1 .5-1.5c-1 .1-1 .1-6 1c-.3-.4-.7-.6-1-1c.5-2 .5-2 4-6c5-2.5 5-2.5 7.5-3c0-.5 0-1 0-1.5c-10.5-1.5-18.5 1-27 7c-.5 .9-1 1.6-1.5 2.5c-.9 .6-.9 .6-5.5 4c-4 3.5-7.6 7-11 11c-4.6 3.8-8.7 6.8-14 9.5c-.7-.3-1.3-.7-2-1c.2-.7 .3-1.3 .5-2c1.8-1 3.7-2 5.5-3c5.2-4.2 9.7-8.5 14-13.5c3.1-2.8 6.2-5.5 9.5-8c1.3-1.3 2.6-2.6 4-4c5.6-3.6 10.4-6.1 17-7c.5-1 1-2 1.5-3c7.2-2.4 12.5-2.2 20-.5c.2 .1 .2 .1 1 .5c3.5 0 3.5 0 8.5-3.5c1-.5 1-.5 3-.5zM118 92.5c-1 1.2-2 2.3-3 3.5c.5 2.5 .5 2.5 3 5c1.8 .8 3.7 1.7 5.5 2.5c.5 1 .5 1 .5 4.5c-4 4.8-6.1 5-12.5 6c0 .7 0 1.3 0 2c4.7 1.5 7.7 .2 12-1.5c1.2-.7 2.3-1.3 3.5-2c1.3 .3 2.7 .7 4 1c3.5 0 3.5 0 5.5-1.5c-.2-.5-.3-1-.5-1.5c-1.7-.3-3.3-.7-5-1c-2.5-2-2.5-2-3-5.5c2-3 2-3 4-5.5c.5-3.5 .5-3.5-1.5-6.5c-4.3-2.2-8.2-1-12.5 .5zM146 58.5c5.8 1.1 8.3 3.9 12.5 8c3.7 5.9 4.4 7.3 5 14c2.8 6.2 5.4 10 10.5 14.5c5.2 5.2 7.2 10.3 9 17.5c0 3.5 0 3.5-2 11c-.2 1.3-.2 1.3-1 7.5c-3.8 10.7-3.8 10.7-8.5 13.5c-.5 .2-.5 .2-3 1c-1 1.3-2 2.7-3 4c-4.5 3-4.5 3-10.5 5c-2.7-.6-5.3-1.3-8-2c-1.7 1.2-3.3 2.3-5 3.5c-2 1-2 1-4 .5c.5-1.5 .5-1.5 6-5c.3-.3 .3-.3 2-2c2.4 0 4.9 0 7.5 0c.5 .5 1 1 1.5 1.5c4.3-.6 7.1-2.3 10.5-5c3.5-5.5 3.5-5.5 4-7c1.5 0 2.9 0 4.5 0c4.3-8.7 4.6-14 2.5-23.5c-.3-1-.7-2-1-3c.3 .1 .3 .1 2 .5c1.5 2.5 1.5 2.5 1.5 4c.5-.2 1-.3 1.5-.5c-.8-10-4.3-16-11.4-22.8c-3.7-3.8-5.5-6.9-7.6-11.7c-.7-1.5-1.5-2.9-2.3-4.4c-1.7-3.6-1.7-3.6-1.7-5.6c.3-.2 .7-.3 1-.5c-.5-3-.5-3-4.5-7c-2-1-3.9-2-6-3c-.7-.4-1.3-.6-2-1c0-.6 0-1.3 0-2zM33.5 83.5c-1 4-5.1 6.4-8 9c-8.6 8.1-14.6 17.2-15.2 29.2c.3 8.1 .3 8.1 2.2 11.8c.5 0 1 0 1.5 0c.4-2.9 .6-6 1-9c.6 0 1.3 0 2 0c.2 1.3 .4 2.7 .6 4.1c1.8 9.3 5.3 14.8 12.9 20.4c2.3 1.2 4.6 2.3 7 3.5c.7 .6 .7 .6 4.5 3.5c3.5 0 3.5 0 8.5-1.5c1 0 2 0 3 0c-1 2-1 2-2.5 3.5c-6.5 1.7-9.6 .9-16-1.5c-1.1-1-2.3-2-3.5-3c-1.5-.7-2.9-1.3-4.5-2c-3.9-3.4-6.9-6.5-9.5-11c-1.1-.5-2.3-1-3.5-1.5c-5.9-6.7-8-12.7-8-21.5c2.4-12.2 7.2-19.8 16.5-28c4.5-4 4.5-4 6-5.5c3.5-1 3.5-1 5-.5zM50.5 172c2.5 1 2.5 1 7 6.5c6 6.2 12 11.8 18.8 17.1c5.7 4.5 11.3 9.1 16.7 13.9c1.3 1.2 2.7 2.3 4 3.5c.7 .7 1.3 1.3 2 2c-.2 .8-.3 1.7-.5 2.5c-6 2.9-11.7 4-18.5 4c-2.6-2.6-4.3-5.5-5.5-9c-.3 .1-.3 .1-1.5 .5c0 2.3 0 4.6 0 7c-.3 .5-.7 1-1 1.5c-13.3 0-24.6-4.6-34.5-13.5c-4.5-4.5-4.5-4.5-8.5-11c.5-2.5 .5-2.5 4.5-7c5-3 5-3 8-3.5c.5 .3 1 .7 1.5 1c2-.5 2-.5 4-2c.9-4.2 1.7-8.3 2.5-12.5c.4-.3 .6-.7 1-1z"/><path fill="#03B5BD" d="M58.5 149.5c2.5 .5 2.5 .5 7 3.5c9.8 5.2 18.9 7.9 30 8.5c2.2 .5 4.3 1 6.5 1.5c7 0 7 0 9-.5c2.3-.2 4.6-.3 7-.5c3.2-.9 6.3-1.9 9.5-3c1.3-.2 2.7-.3 4-.5c.2 .2 .3 .3 .5 .5c-.8 6.3-4.1 10.2-8 15c-.2 .5-.3 1-.5 1.5c1.7-1 3.3-2 5-3c.7 .2 1.3 .3 2 .5c-3 12.2-9.3 20.3-17.5 29.5c-.7 .7-.7 .7-4 4.5c-1 .8-2 1.7-3 2.5c-3.5-.5-3.5-.5-8-5c-2.3-1.8-4.7-3.7-7-5.5c-2.7-2.2-5.3-4.3-8-6.5c-.8-.6-.8-.6-4.5-3.5c-11-9.3-20.7-18.8-28.5-31c3-4 3-4 8.5-8.5z"/><ellipse cx="94" cy="94" rx="6.5" ry="6.5" fill="#212E34"/><ellipse cx="135" cy="85.6" rx="6.2" ry="5.8" fill="#212E34"/><g fill="#FAF9F8"><circle cx="91.5" cy="91.5" r="2.1"/><circle cx="134.6" cy="84.3" r="2"/></g><ellipse cx="124" cy="93.8" rx="3.4" ry="1.1" fill="#9B9D9E" transform="rotate(-6 124 93.8)"/></g></g><rect x="5" y="5" width="230" height="230" rx="45" fill="none"/></symbol></defs>
 <rect x="4" y="4" width="952" height="632" rx="18" fill="#FAF9F8" stroke="#C4CBCE" stroke-width="1.5"/>
 <path d="M4 22a18 18 0 0 1 18-18h916a18 18 0 0 1 18 18v24H4z" fill="#212E34"/>
 <circle cx="26" cy="25" r="5" fill="#C4CBCE" opacity="0.55"/>

package/herdr-plugin/herdr-plugin.toml

@@ -1,6 +1,6 @@
 id = "crossdelta.jackherd"
 name = "jackherd"
-version = "1.7.0"
+version = "1.8.0"
 min_herdr_version = "0.8.2"
 description = "Show the herd, the state of a board's lanes, in a herdr pane"
 platforms = ["linux", "macos"]

package/install.sh

@@ -9,7 +9,7 @@ set -eu
 
 # The default is the version this file ships with. The release bump changes it together with
 # package.json; install.test.ts fails while the two differ. Overridable, but only by a plain release.
-JACKHERD_VERSION="${JACKHERD_VERSION:-1.7.0}"
+JACKHERD_VERSION="${JACKHERD_VERSION:-1.8.0}"
 
 JACKHERD_PACKAGE='jackherd'
 # Test seam: the terminal the wizard asks its questions on.

package/kit/hooks/hooks/approval-gate/herdr-panes.ts

@@ -1,15 +1,6 @@
 import { resolve } from 'node:path'
-import { isRecord, type JsonObject } from '../shared/json'
-
-/** A client's session id as a UUID; nothing else may reach a path. */
-const SESSION_ID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
-
-const sessionOf = (pane: JsonObject): string | null => {
-  const session = isRecord(pane.agent_session) ? pane.agent_session.value : undefined
-  return typeof pane.agent === 'string' && pane.agent !== '' && typeof session === 'string' && SESSION_ID.test(session)
-    ? session
-    : null
-}
+import { isRecord } from '../shared/json'
+import { sessionOf } from '../shared/pane-agent'
 
 /**
  * The sessions of the agents that run in the main checkout, from the `result` of `herdr pane list`: the coordinator
@@ -21,4 +12,3 @@ export const coordinatorSessions = (listing: unknown, main: string): string[] =>
     typeof pane.cwd === 'string' && resolve(pane.cwd) === resolve(main) ? (sessionOf(pane) ?? []) : [],
   )
 }
-

package/kit/hooks/hooks/approval-gate/index.ts

@@ -1,13 +1,14 @@
-// PermissionRequest hook of Claude Code, shipped by jackherd: the client adapter of the approval gate. In a lane it
-// holds a call that would open a permission dialog, records it for the coordinator and answers with the user's decision
-// from the coordinator's dialog; elsewhere, and on any failure, it answers nothing and the dialog stays. argv[2..5]: the
-// allow label, the deny label, the text for a call still pending after the wait, the text for a denied call, rendered
-// into the hook entry by `sync`.
+// PermissionRequest hook of Claude Code, shipped by jackherd: the client adapter of the approval gate. In a lane, known
+// by the herdr agent of the pane and not by the directory of the call, it holds a call that would open a permission
+// dialog, records it for the coordinator and answers with the user's decision from the coordinator's dialog; elsewhere,
+// and on any failure, it answers nothing and the dialog stays. argv[2..5]: the allow label, the deny label, the text for
+// a call still pending after the wait, the text for a denied call, rendered into the hook entry by `sync`.
 import { homedir } from 'node:os'
 import { mainCheckoutOf } from '../shared/checkout'
 import { commandOutput } from '../shared/command'
 import { readConfig } from '../shared/config'
 import { isRecord } from '../shared/json'
+import { ownPaneAgent } from '../shared/own-pane'
 import { coordinatorSessions } from './herdr-panes'
 import { type ClientCall, type GateDependencies, type GateOutcome, runGate } from './run'
 import { approvalsDirectory, claimRequest, pruneRequests, readRequests, writeRequest } from './store'
@@ -22,15 +23,16 @@ const herdrPanes = (): unknown => {
   return answer.result
 }
 
-/** Claude Code's hook input: `cwd`, `tool_name`, `tool_input`. */
+/** Claude Code's hook input: `cwd`, `session_id`, `tool_name`, `tool_input`. */
 const clientCallOf = (text: string): ClientCall | null => {
   const input: unknown = JSON.parse(text)
   if (!isRecord(input) || typeof input.cwd !== 'string' || typeof input.tool_name !== 'string') return null
-  return { cwd: input.cwd, tool: input.tool_name, input: input.tool_input ?? null }
+  if (typeof input.session_id !== 'string') return null
+  return { cwd: input.cwd, session: input.session_id, tool: input.tool_name, input: input.tool_input ?? null }
 }
 
 const dependencies: GateDependencies = {
-  inLaneSession: process.env.HERDR_ENV === '1',
+  paneAgent: () => ownPaneAgent(),
   mainCheckoutOf,
   config: (main) => readConfig([main, homedir()]),
   readRequests: (main) => readRequests(approvalsDirectory(main)),

package/kit/hooks/hooks/approval-gate/run.ts

@@ -1,20 +1,22 @@
 import type { DialogAnswer } from '../shared/dialog-answer'
+import { ASK_USER_QUESTION_TOOL } from '../shared/dialog-answers'
 import { isFresh } from '../shared/fresh'
+import { laneOfAgent } from '../shared/lane'
+import type { PaneAgent } from '../shared/pane-agent'
 import { gateDecision, type GateLabels } from './decision'
-import { laneOf } from './lane'
 import { type ApprovalRequest, callHash, type GateCall, isStorableInput, newRequest, requestId } from './request'
 import { gateSettingsOf } from './settings'
 
 /** A call as the client's hook hands it over, before it is known to be a lane's. */
-export type ClientCall = { cwd: string; tool: string; input: unknown }
+export type ClientCall = { cwd: string; session: string; tool: string; input: unknown }
 
 /** What the gate decided; null decides nothing, so the client's own dialog stays. */
 export type GateOutcome = { kind: 'allow' } | { kind: 'denied' } | { kind: 'pending' } | null
 
 /** Everything with a side effect, passed in so a test reaches the flow without a multiplexer, git or files. */
 export type GateDependencies = {
-  /** Whether this session runs in a pane of the terminal multiplexer. */
-  inLaneSession: boolean
+  /** The agent of the multiplexer pane this session runs in; null outside the multiplexer. */
+  paneAgent: () => PaneAgent | null
   mainCheckoutOf: (cwd: string) => string
   config: (main: string) => Record<string, unknown>
   readRequests: (main: string) => ApprovalRequest[]
@@ -70,24 +72,31 @@ const awaitDecision = async (
   }
 }
 
+/** A question to the user asks for an answer, not for a permission: the lane asks the coordinator in its text instead. */
+const isHeld = ({ tool, input }: ClientCall): boolean => tool !== ASK_USER_QUESTION_TOOL && isStorableInput(input)
+
 /**
  * The gate for a call that would open a permission dialog in a lane: it records the call as a request the watcher
- * reports, waits for the user's answer to the coordinator's dialog, and allows or denies. Outside a lane, for a call too
- * large to store, and on any failure (the multiplexer or git cannot be asked), it decides nothing, so the dialog stays.
+ * reports, waits for the user's answer to the coordinator's dialog, and allows or denies. The lane is the agent of the
+ * pane, never the directory of the call. Outside a lane, for a question or a call too large to store, and on any failure
+ * (the multiplexer or git cannot be asked), it decides nothing, so the dialog stays.
  */
 export const runGate = async (
   clientCall: ClientCall,
   labels: GateLabels,
   dependencies: GateDependencies,
 ): Promise<GateOutcome> => {
-  if (!dependencies.inLaneSession || !isStorableInput(clientCall.input)) return null
+  if (!isHeld(clientCall)) return null
   try {
-    const main = dependencies.mainCheckoutOf(clientCall.cwd)
-    const settings = gateSettingsOf(dependencies.config(main))
-    const lane = laneOf({ cwd: clientCall.cwd, main, worktreeDirectory: settings.worktreeDirectory })
+    const agent = dependencies.paneAgent()
+    if (agent === null || agent.cwd === null) return null
+    const main = dependencies.mainCheckoutOf(agent.cwd)
+    const { worktreeDirectory, waitMinutes } = gateSettingsOf(dependencies.config(main))
+    const lane = laneOfAgent({ agent, session: clientCall.session, main, worktreeDirectory })
     if (!lane) return null
-    const request = openRequest(main, { lane, ...clientCall }, dependencies)
-    return await awaitDecision(main, request.hash, labels, settings.waitMinutes, dependencies)
+    const { cwd, tool, input } = clientCall
+    const request = openRequest(main, { lane, cwd, tool, input }, dependencies)
+    return await awaitDecision(main, request.hash, labels, waitMinutes, dependencies)
   } catch {
     return null
   }

package/kit/hooks/hooks/ask-hint/decision.ts

@@ -1,3 +1,5 @@
+import { ASK_USER_QUESTION_TOOL } from '../shared/dialog-answers'
+
 export type HintInput = {
   message: string
   tools: string[]
@@ -8,8 +10,6 @@ export type HintInput = {
 
 export type HintDecision = { kind: 'silent' } | { kind: 'hint'; message: string }
 
-const ASK_TOOL = 'AskUserQuestion'
-
 /** A lane prompt names the lane in its first line; a lane started from a hand-over file reads the file first. */
 const LANE_PROMPT = /^\s*(<pasted_content[^>]*>\s*)?(Du bist die Spur|You are the lane|Read `\.claude\/handover\/)/i
 
@@ -23,6 +23,6 @@ export const isLanePrompt = (firstPrompt: string): boolean => LANE_PROMPT.test(f
 
 export const decideHint = (input: HintInput): HintDecision => {
   if (!input.enabled || input.stopHookActive || input.lane) return { kind: 'silent' }
-  if (!endsWithQuestion(input.message) || input.tools.includes(ASK_TOOL)) return { kind: 'silent' }
+  if (!endsWithQuestion(input.message) || input.tools.includes(ASK_USER_QUESTION_TOOL)) return { kind: 'silent' }
   return { kind: 'hint', message: HINT }
 }

package/kit/hooks/hooks/git-guard/decision.ts

@@ -1,4 +1,5 @@
 import { posix } from 'node:path'
+import { commandTextRunnerIndex, searchableText } from '../shared/command-text-runners'
 import {
   ASSIGNMENT,
   inlineScript,
@@ -7,8 +8,26 @@ import {
   programName,
   readsScriptFromInput,
   ruleStart,
+  runsInterpreterProgram,
 } from '../shared/program-position'
-import { parseShell, ShellParseError, type SimpleCommand, type Word } from '../shared/shell'
+import {
+  expandingHereDocumentAdvice,
+  isExpanded,
+  parseShell,
+  ShellParseError,
+  type SimpleCommand,
+  UNREADABLE_ADVICE,
+  type Word,
+} from '../shared/shell'
+import {
+  definesShellAlias,
+  mayRunDefinedFunction,
+  NO_DEFINITIONS,
+  type ShellDefinitions,
+  shellDefinitionAt,
+  shellDefinitionHint,
+} from '../shared/shell-aliases'
+import { type PushCall, type PushContext, pushTargetDenial } from './push-target'
 
 export type GitGuardDecision = { kind: 'pass' } | { kind: 'deny'; reason: string }
 
@@ -64,6 +83,9 @@ type SplitArguments = { options: string[]; operands: string[] }
 
 const PASS: GitGuardDecision = { kind: 'pass' }
 
+/** The programs whose alias or function the guard refuses: one that runs git or gh hides it from the rules (D42). */
+const DEFINITION_PROGRAMS = ['git', 'gh']
+
 const FORCE_PUSH =
   'A force push is refused. Use `--force-with-lease` instead, and only after the user agreed to rewrite the remote branch.'
 const SKIP_HOOKS =
@@ -75,6 +97,10 @@ const PROGRAM_HINT =
   'Refused: the program is expanded from a variable or a substitution and is followed by a protected git verb, so the permission rules cannot see it. Write `git` plainly.'
 const BRACE_HINT =
   'Refused: an option of this git call is written as a brace expansion, so neither the permission rules nor this hook can tell what git receives. Write the option plainly.'
+const INLINE_EXPANSION_HINT =
+  'Refused: `eval` or `sh -c` runs a script held in a variable or a substitution, so neither the permission rules nor this hook can read it. Write the commands out.'
+const EXPANDED_FUNCTION_HINT =
+  'Refused: the program is expanded from a variable or a substitution, and it may name a shell function that runs git or gh, which hides the command from the permission rules. Run the command written out instead.'
 const ALIAS_HINT =
   'Refused: `-c alias.…` defines a git alias inline, which hides the verb from the permission rules. Run the git command it stands for directly.'
 
@@ -149,6 +175,19 @@ const HOOK_SKIPPING_VARIABLE = /^(HUSKY|LEFTHOOK|SKIP)\+?=/
 const REDIRECTING_VARIABLE = /^(GIT_CONFIG\w*|GIT_DIR|GIT_WORK_TREE|GIT_INDEX_FILE)\+?=/
 /** An option the shell rewrites before git sees it: `--forc{e,}` reaches git as `--force`. */
 const BRACE_IN_OPTION = /^-.*\{.*(,|\.\.).*\}/
+/** Push options that send every local branch, the base branch among them. */
+const ALL_BRANCHES = ['--all', '--branches', '--mirror']
+const DIRECTORY_CHANGERS = new Set(['cd', 'pushd', 'popd'])
+/** Git verbs that can change which branch `HEAD` names, or where a push of it goes. */
+const BRANCH_MOVING_VERBS = new Set([
+  PROTECTED_VERB.checkout,
+  'switch',
+  'branch',
+  'config',
+  'symbolic-ref',
+  'update-ref',
+  'worktree',
+])
 const PROTECTED_MENTION = new RegExp(`\\bgit\\b[\\s\\S]*\\b(${Object.values(PROTECTED_VERB).join('|')})\\b`)
 
 const isProtectedVerb = (value: string): value is ProtectedVerb =>
@@ -320,16 +359,65 @@ const denyIfMentionsProtectedVerb = (script: string, reason: string): GitGuardDe
   return verb ? deny(`Refused: ${reason}, and it mentions \`git ${verb}\`. ${plainInstead(verb)}`) : PASS
 }
 
-const judgeWord = (words: SimpleCommand, index: number, context: ScriptContext): GitGuardDecision => {
+const judgeDefinition = (
+  words: SimpleCommand,
+  index: number,
+  definitions: () => ShellDefinitions,
+): GitGuardDecision => {
+  const definition = shellDefinitionAt(words, index, definitions, DEFINITION_PROGRAMS)
+  return definition ? deny(`Refused: ${shellDefinitionHint(definition)}`) : PASS
+}
+
+/**
+ * A program that runs command text it is given (`watch '…'`, sed's `e`) is refused when that text names a protected
+ * verb; when the text is itself an expansion, the searchable script is searched instead.
+ */
+const judgeCommandText = (words: SimpleCommand, searchable: string): GitGuardDecision => {
+  const runner = commandTextRunnerIndex(words)
+  if (runner === -1) return PASS
+  const given = words.slice(runner + 1)
+  const text = given.some(({ value }) => isExpanded(value)) ? searchable : given.map(({ value }) => value).join(' ')
+  return denyIfMentionsProtectedVerb(text, 'a program runs command text it is given, which no rule inspects')
+}
+
+const judgeWord = (
+  words: SimpleCommand,
+  index: number,
+  context: ScriptContext,
+  definitions: () => ShellDefinitions,
+  searchable: string,
+): GitGuardDecision => {
   const script = inlineScript(words, index)
-  if (script !== undefined) return judgeScript(script, SCRIPT_CONTEXT.nested)
-  if (!isGit(words[index])) return PASS
+  if (script !== undefined) return judgeScript(script, SCRIPT_CONTEXT.nested, definitions, searchable)
+  if (!isGit(words[index])) return judgeDefinition(words, index, definitions)
   const invocation = readInvocation(words, index)
   return invocation ? judgeInvocation(invocation, gitPosition(words, index, context)) : PASS
 }
 
-const judgeCommand = (words: SimpleCommand, context: ScriptContext): GitGuardDecision =>
-  firstDenial([...words.map((_word, index) => judgeWord(words, index, context)), judgeExpandedProgram(words)])
+/** Inside `eval` or `sh -c`, an expanded program means the script was held in a variable: refused after D22. */
+const judgeInlineExpansion = (words: SimpleCommand, context: ScriptContext): GitGuardDecision =>
+  context === SCRIPT_CONTEXT.nested && runsExpandedProgram(words) ? deny(INLINE_EXPANSION_HINT) : PASS
+
+const judgeExpandedFunction = (
+  words: SimpleCommand,
+  definitions: () => ShellDefinitions,
+  searchable: string,
+): GitGuardDecision =>
+  mayRunDefinedFunction(words, definitions, DEFINITION_PROGRAMS, searchable) ? deny(EXPANDED_FUNCTION_HINT) : PASS
+
+const judgeCommand = (
+  words: SimpleCommand,
+  context: ScriptContext,
+  definitions: () => ShellDefinitions,
+  searchable: string,
+): GitGuardDecision =>
+  firstDenial([
+    ...words.map((_word, index) => judgeWord(words, index, context, definitions, searchable)),
+    judgeInlineExpansion(words, context),
+    judgeExpandedProgram(words),
+    judgeCommandText(words, searchable),
+    judgeExpandedFunction(words, definitions, searchable),
+  ])
 
 /**
  * What no single command shows. Each check reads the whole script, so a harmless git call beside
@@ -340,21 +428,101 @@ const judgeScriptWide = (script: string, commands: SimpleCommand[]): GitGuardDec
   if (commands.some(readsScriptFromInput)) {
     return denyIfMentionsProtectedVerb(script, 'a shell reads its script from input here, which no rule inspects')
   }
+  if (commands.some(runsInterpreterProgram)) {
+    return denyIfMentionsProtectedVerb(
+      script,
+      'an interpreter runs program text given inline or on its input, which no rule inspects',
+    )
+  }
+  if (commands.some(definesShellAlias)) {
+    return denyIfMentionsProtectedVerb(
+      script,
+      'the script defines a shell alias, which hides its command from the rules',
+    )
+  }
   if (commands.some(setsGitVariable)) {
-    return denyIfMentionsProtectedVerb(script, 'a `HUSKY`, `LEFTHOOK`, `SKIP` or `GIT_*` variable is set, which changes the git calls')
+    return denyIfMentionsProtectedVerb(
+      script,
+      'a `HUSKY`, `LEFTHOOK`, `SKIP` or `GIT_*` variable is set, which changes the git calls',
+    )
   }
   if (commands.some(runsExpandedProgram)) {
-    return denyIfMentionsProtectedVerb(script, 'a program is expanded from a variable or a substitution and could be git')
+    return denyIfMentionsProtectedVerb(
+      script,
+      'a program is expanded from a variable or a substitution and could be git',
+    )
   }
   return PASS
 }
 
-const judgeScript = (script: string, context: ScriptContext): GitGuardDecision => {
+/** `whole` is the text the mention search reads at the outer level: a nested script's variables are set there. */
+const judgeParsed = (
+  commands: SimpleCommand[],
+  context: ScriptContext,
+  definitions: () => ShellDefinitions,
+  whole: string,
+): GitGuardDecision => {
+  const text = searchableText(whole, commands)
+  return firstDenial([
+    ...commands.map((words) => judgeCommand(words, context, definitions, text)),
+    judgeScriptWide(text, commands),
+  ])
+}
+
+const judgeScript = (
+  script: string,
+  context: ScriptContext,
+  definitions: () => ShellDefinitions,
+  whole: string,
+): GitGuardDecision => judgeParsed(parseShell(script), context, definitions, whole)
+
+/** A `cd` or a git call that switches, renames or reconfigures the branch: `HEAD` at a later push is another one. */
+const movesHead = (words: SimpleCommand): boolean =>
+  words.some((word, index) => {
+    if (!isProgramPosition(words, index)) return false
+    if (DIRECTORY_CHANGERS.has(programName(word))) return true
+    return isGit(word) && BRANCH_MOVING_VERBS.has(readInvocation(words, index)?.verb.value ?? '')
+  })
+
+/** A plain `git push` where a rule matches; every other form of it is refused before this is asked. */
+const pushCallOf = (words: SimpleCommand, headMoves: boolean): PushCall | undefined => {
+  const start = ruleStart(words)
+  const program = words.at(start)
+  if (program === undefined || !isGit(program) || words[start + 1]?.value !== PROTECTED_VERB.push) return undefined
+  const { options, operands } = splitArguments(words.slice(start + 2), VERB_SYNTAX.push)
+  const allBranches = options.some((option) => ALL_BRANCHES.some((name) => matchesLong(option, name)))
+  return { operands, allBranches, headMoves }
+}
+
+const judgePushes = (commands: SimpleCommand[], context: PushContext): GitGuardDecision => {
+  const headMoves = commands.some(movesHead)
+  const calls = commands.flatMap((words) => pushCallOf(words, headMoves) ?? [])
+  const reason = calls.map((call) => pushTargetDenial(call, context)).find((each) => each !== undefined)
+  return reason ? deny(reason) : PASS
+}
+
+/**
+ * Quotes split a word (`g\it`, `pu''sh`), an expansion hides a command: in text the parse cannot follow, no search
+ * can tell whether a protected git verb runs, so every unreadable script is refused (fail closed).
+ */
+const denyUnreadable = ({ message }: ShellParseError): GitGuardDecision =>
+  deny(
+    `Refused: the command could not be read (${message}), so neither the permission rules nor this hook can tell whether it runs git. ${UNREADABLE_ADVICE}`,
+  )
+
+/** A refusal of a script with an expanding here-document says how to keep its text from running. */
+const withHereDocumentAdvice = (decision: GitGuardDecision, script: string): GitGuardDecision => {
+  const advice = expandingHereDocumentAdvice(script)
+  return decision.kind === 'deny' && advice !== '' ? deny(`${decision.reason} ${advice}`) : decision
+}
+
+const judgeTop = (command: string, push: PushContext, definitions: () => ShellDefinitions): GitGuardDecision => {
   try {
-    const commands = parseShell(script)
-    return firstDenial([...commands.map((words) => judgeCommand(words, context)), judgeScriptWide(script, commands)])
+    const commands = parseShell(command)
+    const decision = judgeParsed(commands, SCRIPT_CONTEXT.top, definitions, command)
+    return decision.kind === 'deny' ? decision : judgePushes(commands, push)
   } catch (error) {
-    if (error instanceof ShellParseError) return denyIfMentionsProtectedVerb(script, 'the command could not be parsed')
+    if (error instanceof ShellParseError) return denyUnreadable(error)
     throw error
   }
 }
@@ -363,7 +531,13 @@ const judgeScript = (script: string, context: ScriptContext): GitGuardDecision =
  * Decides on a Bash command before it runs. Denies a protected git verb that a permission rule
  * written as `git <verb> …` would not match (options or `GIT_*` variables before the verb, a
  * wrapper, a path to git, a quoted verb, a line continuation, `sh -c`, `eval`, a script piped into
- * a shell), and denies a force push, a skipped hook and a hard reset in any form. Everything else
- * passes on to the project's own permission rules.
+ * a shell, an interpreter's program text), and denies a force push, a skipped hook and a hard reset in any
+ * form. Denies a push that updates the base branch, or whose target it cannot tell, every script it cannot read,
+ * and a shell alias or function (`definitions`, read only for a word that is no known program) that runs git or gh.
+ * Everything else passes on to the project's own permission rules.
  */
-export const decideBashCommand = (command: string): GitGuardDecision => judgeScript(command, SCRIPT_CONTEXT.top)
+export const decideBashCommand = (
+  command: string,
+  push: PushContext,
+  definitions: () => ShellDefinitions = () => NO_DEFINITIONS,
+): GitGuardDecision => withHereDocumentAdvice(judgeTop(command, push, definitions), command)

package/kit/hooks/hooks/git-guard/index.ts

@@ -1,13 +1,23 @@
 // PreToolUse hook for Bash, shipped by jackherd. Reads the hook input on stdin and
 // answers with a deny decision on stdout, or with nothing to leave the call to the permission rules.
 // Any failure denies: a guard that crashes must not wave the command through.
+import { once } from '../shared/once'
+import { readShellDefinitions } from '../shared/shell-snapshots'
 import { decideBashCommand, type GitGuardDecision } from './decision'
+import { repositoryPushContext } from './repository'
 
-type HookInput = { tool_input?: { command?: unknown } }
+type HookInput = { cwd?: unknown; tool_input?: { command?: unknown } }
 
 const decideInput = (text: string): GitGuardDecision | undefined => {
-  const command = (JSON.parse(text) as HookInput).tool_input?.command
-  return typeof command === 'string' ? decideBashCommand(command) : undefined
+  const input = JSON.parse(text) as HookInput
+  const command = input.tool_input?.command
+  const cwd = typeof input.cwd === 'string' ? input.cwd : process.cwd()
+  if (typeof command !== 'string') return undefined
+  return decideBashCommand(
+    command,
+    repositoryPushContext(cwd),
+    once(() => readShellDefinitions()),
+  )
 }
 
 const failureDecision = (error: unknown): GitGuardDecision => ({

package/kit/hooks/hooks/git-guard/push-target.ts

@@ -0,0 +1,85 @@
+import { expandsBraces, isExpanded } from '../shared/shell'
+
+/**
+ * What only the repository knows about a push, asked only when the script holds one: a guard that reads the config
+ * or runs git for every Bash call would cost each of them.
+ */
+export type PushContext = {
+  /** The project's base branch; undefined when the config cannot be read or names one that is no branch name. */
+  baseBranch: () => string | undefined
+  /**
+   * The branches a push without a refspec, or with `HEAD`, updates: the current branch and the one its push goes to;
+   * undefined when git cannot tell (a detached HEAD).
+   */
+  defaultPushBranches: () => string[] | undefined
+}
+
+/** A plain `git push` of the script, as the guard reads it. */
+export type PushCall = {
+  /** The words after `git push` that are neither options nor their values: the remote and the refspecs. */
+  operands: string[]
+  /** `--all`, `--branches` or `--mirror`: every local branch, the base branch among them. */
+  allBranches: boolean
+  /** The script changes directory or branch, so the branch `HEAD` names at the push is not the one git reports now. */
+  headMoves: boolean
+}
+
+const HEAD_NAMES = new Set(['HEAD', '@'])
+/** A `?` or `[` glob; `*` is a refspec wildcard as well and counts as the base branch below. */
+const GLOB = /[?[]/
+const BRANCH_PREFIX = /^(refs\/)?(heads\/)?/
+
+const branchOf = (ref: string): string => ref.replace(BRANCH_PREFIX, '')
+
+/**
+ * The branch a refspec updates on the remote: the part after `:`, or the source when there is none (`main`,
+ * `+main`, `main:`); empty for the matching refspec `:`; undefined for `HEAD`, which pushes the current branch under its
+ * push name.
+ */
+const destinationOf = (refspec: string): string | undefined => {
+  const plain = refspec.replace(/^\+/, '')
+  const colon = plain.indexOf(':')
+  const destination = colon === -1 || colon === plain.length - 1 ? plain.replace(/:$/, '') : plain.slice(colon + 1)
+  return HEAD_NAMES.has(destination) ? undefined : branchOf(destination)
+}
+
+const isRewrittenByShell = (operand: string): boolean => GLOB.test(operand) || expandsBraces(operand)
+
+/** A wildcard refspec, or the matching refspec `:` whose empty destination stands for every branch both sides have. */
+const reachesEveryBranch = (destination: string | undefined): boolean =>
+  destination !== undefined && (destination === '' || destination.includes('*'))
+
+const toBase = (base: string): string =>
+  `Refused: this push updates \`${base}\`, the base branch (baseBranch in .jackherd/config.json), and goes around the merge guard. Push your own branch and merge it through a pull request.`
+
+const unknownTarget = (why: string): string =>
+  `Refused: the guard cannot tell which branch this push updates (${why}), and a push to the base branch goes around the merge guard. Name the branch plainly, \`git push origin <branch>\`, as a command of its own.`
+
+const INVALID_BASE =
+  'Refused: .jackherd/config.json cannot be read or its baseBranch is no branch name, so the guard cannot tell whether this push updates the base branch. Fix the config.'
+
+/** Whether HEAD decides the target: no refspec, or one whose destination is `HEAD`. */
+const pushesHead = (operands: string[], destinations: (string | undefined)[]): boolean =>
+  operands.length <= 1 || destinations.includes(undefined)
+
+const headDenial = (call: PushCall, context: PushContext, base: string): string | undefined => {
+  if (call.headMoves) return unknownTarget('the script changes directory or branch before it')
+  const branches = context.defaultPushBranches()
+  if (branches === undefined) return unknownTarget('git cannot tell the current branch')
+  return branches.some((branch) => branchOf(branch) === base) ? toBase(base) : undefined
+}
+
+/**
+ * Why a plain `git push` is refused, or undefined when it does not reach the base branch. Every operand counts as a
+ * refspec, the remote too (`--repo` makes the first one a refspec): that can only refuse more, never less.
+ */
+export const pushTargetDenial = (call: PushCall, context: PushContext): string | undefined => {
+  if (call.operands.some(isExpanded)) return unknownTarget('a refspec is expanded')
+  if (call.operands.some(isRewrittenByShell)) return unknownTarget('the shell rewrites a refspec by a glob or braces')
+  const base = context.baseBranch()
+  if (base === undefined) return INVALID_BASE
+  if (call.allBranches) return toBase(base)
+  const destinations = call.operands.map(destinationOf)
+  if (destinations.some((destination) => reachesEveryBranch(destination) || destination === base)) return toBase(base)
+  return pushesHead(call.operands, destinations) ? headDenial(call, context, base) : undefined
+}