quoxcli 0.6.0 → 0.6.1

package/vendor/dragonlab/design/janus/v4/character.mjs

@@ -0,0 +1,150 @@
+import {renderSvgRig} from '../../../factory/svg-rig-contour.mjs';
+import {poseRig as v3Pose,renderJanus as v3Render} from '../v3/character.mjs';
+
+/**
+ * Janus V4: gate acting on the approved V1 body and the V3 horns (review pending).
+ * Idle and Threshold are V3 exactly. V4 adds a compact attach entrance (notice, acknowledge,
+ * settle), Hold (gate shut and barred while the host reports a pending approval) and Deny
+ * (an offline performance: a traveller is turned back from a barred gate).
+ * Pure functions of elapsed time. Renderers draw; the host supplies approval state.
+ */
+export const JANUS_CLIPS=Object.freeze([
+ {id:'idle',title:'Watch both sides',duration:12000},
+ {id:'attach',title:'Notice, acknowledge, settle',duration:3600},
+ {id:'threshold',title:'Open the threshold',duration:12000},
+ {id:'hold',title:'Hold the gate',duration:9200},
+ {id:'grant',title:'Unbar and open',duration:1400},
+ {id:'deny',title:'Turn back at the gate',duration:6400},
+]);
+export const ATTACH_MS=3600,HOLD_ENTER_MS=1200,HOLD_LOOP_MS=8000,GRANT_MS=1400,DENY_MS=6400;
+export const STORY_DURATION=ATTACH_MS+HOLD_ENTER_MS+HOLD_LOOP_MS+GRANT_MS+12000+DENY_MS;
+const STILL=Object.freeze({idle:0,attach:1500,threshold:6500,hold:3000,grant:700,deny:2600});
+// V3 camera, held fixed for every V4 clip so nothing in the frame breathes.
+const framed=rig=>({...rig,bounds:{left:110.7777777777778,top:64.82150205761317,right:607,bottom:445}});
+const clamp=x=>Math.max(0,Math.min(1,x));
+const ease=x=>{x=clamp(x);return x*x*(3-2*x);};
+const pulse=(t,a,b)=>t<=a||t>=b?0:Math.sin(Math.PI*(t-a)/(b-a))**2;
+const mix=(a,b,k)=>a+(b-a)*k;
+
+/** One posed parameter set; every V4 clip is a timeline of these. Rest = V3 idle at t=0. */
+const REST=Object.freeze({lx:0,ly:0,rx:0,ry:0,lg:0,rg:0,cloak:0,door:0,drop:0,glow:0,key:0,flash:0,traveller:null});
+export function janusParams(scene,t){
+ if(scene==='attach'){
+  // Notice: the outer (cyan, left) face lifts first, the inner (amber, right) one follows.
+  const lift=-4*pulse(t,0,1700),liftR=-4*pulse(t,250,1950);
+  // Acknowledge: both faces dip toward the gate together and glance back at whoever arrived.
+  const nod=pulse(t,900,2700),look=ease((t-350)/550)*(1-ease((t-2300)/900));
+  return {...REST,lx:7*nod,ly:lift+7*nod,rx:-7*nod,ry:liftR+7*nod,lg:7*look,rg:-7*look,
+   // Cloak tips follow the nod late and settle last; the keystone answers the nod.
+   cloak:-5*pulse(t,1250,3500),glow:pulse(t,900,2900),key:pulse(t,1000,3100)};
+ }
+ if(scene==='hold'){
+  // The doorway darkens, then the portcullis drops from the lintel: the gate visibly closes.
+  const shut=ease(t/HOLD_ENTER_MS),drop=ease((t-200)/(HOLD_ENTER_MS-200));
+  const u=Math.max(0,t-HOLD_ENTER_MS)%HOLD_LOOP_MS;
+  // Patient watch while shut: one face keeps the gate, the other checks the fleet, then they swap.
+  const outL=pulse(u,600,3400),outR=pulse(u,4600,7400),breathe=Math.sin(Math.PI*u/HOLD_LOOP_MS)**2;
+  return {...REST,lx:10*shut-6*outL,ly:7*shut+breathe,rx:-10*shut+6*outR,ry:7*shut+breathe,
+   lg:7*shut*(1-outL)-3*outL,rg:-7*shut*(1-outR)+3*outR,door:shut,drop,glow:.5*shut,key:shut};
+ }
+ if(scene==='grant'){
+  // Starts from the shut Hold pose (loop phase zero): portcullis rises first, then the doorway and faces return to rest.
+  const k=1-ease(t/GRANT_MS),up=1-ease(t/(GRANT_MS*.6));
+  return {...REST,lx:10*k,ly:7*k,rx:-10*k,ry:7*k,lg:7*k,rg:-7*k,door:k,drop:up,glow:.5*k+.5*pulse(t,0,GRANT_MS),key:k};
+ }
+ if(scene==='deny'){
+  const turn=ease(t/700)*(1-ease((t-4600)/1400));
+  // The portcullis slams, the bars flash when the traveller meets them, and it is turned back.
+  const drop=ease((t-500)/350)*(1-ease((t-4400)/1100)),flash=pulse(t,1850,2750),rear=-4*pulse(t,1850,3000);
+  let traveller=null;
+  if(t>300&&t<4400){
+   const stop=375-(6+12*turn)-19,x=t<1900?mix(232,stop,ease((t-300)/1600)):t<2500?stop:mix(stop,232,ease((t-2500)/1600));
+   const size=11*ease((t-300)/300)*(1-ease((t-3800)/600));
+   traveller={x,size,rgb:t<2500?[243,194,109]:[226,120,96]};
+  }
+  return {...REST,lx:10*turn,ly:7*turn+rear,rx:-10*turn,ry:7*turn+rear,lg:7*turn,rg:-7*turn,door:turn,drop,glow:turn,key:turn,flash,traveller};
+ }
+ return REST;
+}
+export const BAR_Y=Object.freeze([308,330,352]);
+function poseFromParams(rig,p,{deck=false}={}){
+ const moveHead=(x,y,side)=>side==='left'?[x+p.lx,y+p.ly]:[x+p.rx,y+p.ry];
+ const paths=rig.paths.filter(q=>q.group!=='threshold').map(q=>({...q,polygons:q.polygons.map(poly=>poly.map(([x,y])=>{
+  if(q.group==='left-head'||q.group==='right-head')return moveHead(x,y,q.group.split('-')[0]);
+  if(q.group==='eyes'){
+   const side=q.id.split('-')[0],[hx,hy]=moveHead(x,y,side);
+   // Gaze: only the pupil slides, staying inside the white. Positive = toward the gate.
+   return q.id.endsWith('-pupil')?[hx+(side==='left'?p.lg:p.rg),hy]:[hx,hy];
+  }
+  // Blend the neck into the chest so the faces never detach from the body.
+  if(q.group==='necks'){const w=clamp((280-y)/85),side=x<375?'left':'right',[hx,hy]=moveHead(x,y,side);return [mix(x,hx,w),mix(y,hy,w)];}
+  // Cloak roots pinned at the shoulders; distal tips lift with distance.
+  if(q.group==='wings'){const w=clamp(Math.abs(x-375)/230);return [x,y+p.cloak*w];}
+  return [x,y];
+ }))}));
+ const add=(id,rgb,polygons,stroke=3,erase=false)=>paths.push({id,group:'effect',rgb,polygons,stroke,erase});
+ const lerp=(a,b,k)=>a.map((v,i)=>Math.round(mix(v,b[i],k)));
+ // At rest these three paths are exactly V3's closed seam.
+ const half=6+12*p.door,top=294-8*p.door,bottom=375+3*p.door;
+ add('gateway-void',[8,13,25],[[[375-half,top],[375+half,top],[375+half,bottom],[375-half,bottom]]],0,true);
+ add('cyan-jamb',lerp([111,233,235],[190,255,252],p.glow),[[[375-half,top],[375-half,bottom]]],4);
+ add('amber-jamb',lerp([246,188,106],[255,226,160],p.glow),[[[375+half,top],[375+half,bottom]]],4);
+ if(p.drop>.02){
+  // Portcullis: the lattice slides down from the lintel; only bars already inside the doorway are drawn.
+  const fall=(1-p.drop)*(BAR_Y[2]-top+6),rgb=lerp([232,238,240],[255,138,100],p.flash);
+  BAR_Y.forEach((y0,i)=>{const y=y0-fall;if(y<top+4)return;
+   add('gate-bar-'+i+'-gap',[8,13,25],[[[375-half+3,y-5],[375+half-3,y-5],[375+half-3,y+5],[375-half+3,y+5]]],0,true);
+   add('gate-bar-'+i,rgb,[[[375-half+3,y],[375+half-3,y]]],6);});
+ }
+ if(p.key>.05){
+  // Keystone: the gate's own mark, a wedge on an erased halo just above the doorway.
+  const k=p.key,w=6+6*k,h=16*k,y=top-3;
+  add('keystone-halo',[8,13,25],[[[375-w-4,y-h-4],[375+w+4,y-h-4],[375+w*.55+3,y+2],[375-w*.55-3,y+2]]],0,true);
+  add('keystone',lerp([150,160,170],[246,226,170],k),[[[375-w,y-h],[375+w,y-h],[375+w*.55,y],[375-w*.55,y]]],0);
+ }
+ if(p.traveller&&p.traveller.size>.5){
+  const {x,size,rgb}=p.traveller,y=335,d=size+5;
+  add('traveller-halo',[8,13,25],[[[x-d,y],[x,y-d],[x+d,y],[x,y+d]]],0,true);
+  add('traveller',rgb,[[[x-size,y],[x,y-size],[x+size,y],[x,y+size]]],0);
+ }
+ const map=new Map(paths.map(q=>[q.id,q]));
+ return {...rig,paths,eyes:rig.eyes.map(e=>({...e,socket:map.get(e.socket.id),white:map.get(e.white.id),pupil:map.get(e.pupil.id)}))};
+}
+
+const V4_SCENES=new Set(['attach','hold','grant','deny']);
+export function poseRig(rig,scene,ms,options={}){
+ if(!V4_SCENES.has(scene))return v3Pose(rig,scene,ms,options);
+ if(scene==='attach'&&ms>=ATTACH_MS)return v3Pose(rig,'idle',ms-ATTACH_MS,options);
+ if(scene==='grant'&&ms>=GRANT_MS)return v3Pose(rig,'idle',ms-GRANT_MS,options);
+ if(scene==='deny'&&ms>=DENY_MS)return v3Pose(rig,'idle',ms-DENY_MS,options);
+ return poseFromParams(framed(rig),janusParams(scene,ms),options);
+}
+function caption(scene,t){
+ if(scene==='attach')return t<900?'Someone at the gate.':t<2300?'Both faces acknowledge you.':'Settle. Watch both ways.';
+ if(scene==='hold')return t<HOLD_ENTER_MS?'Shut the gate.':'Gate held until you decide.';
+ if(scene==='grant')return 'Approved. Unbar the gate.';
+ if(scene==='deny')return t<700?'Face the gate.':t<2600?'Bar the way.':t<4400?'Turned back.':'Resume watch.';
+ return '';
+}
+export function renderJanus(rig,scene='idle',ms=0,options={}){
+ if(!JANUS_CLIPS.some(c=>c.id===scene))return {ok:false,code:'UNKNOWN_CLIP'};
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ if(!V4_SCENES.has(scene))return v3Render(rig,scene,ms,options);
+ // Still freezes every channel (heads, pupils, cloak, keystone, bars, traveller) at one pose.
+ const t=options.still?STILL[scene]:ms;
+ if(scene==='attach'&&t>=ATTACH_MS)return v3Render(rig,'idle',t-ATTACH_MS,options);
+ if(scene==='grant'&&t>=GRANT_MS)return v3Render(rig,'idle',t-GRANT_MS,options);
+ if(scene==='deny'&&t>=DENY_MS)return v3Render(rig,'idle',t-DENY_MS,options);
+ return {...renderSvgRig(poseRig(rig,scene,t,options),options),scene,clip:scene,caption:caption(scene,t)};
+}
+/** Offline story: attach, a pending approval holds the gate, approval unbars it, a traveller passes, then a denial. Simulated; no host state. */
+export function renderStory(rig,ms,options={}){
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ if(options.still)return renderJanus(rig,'hold',0,options);
+ const holdEnd=ATTACH_MS+HOLD_ENTER_MS+HOLD_LOOP_MS,grantEnd=holdEnd+GRANT_MS,openEnd=grantEnd+12000;
+ if(ms<ATTACH_MS)return renderJanus(rig,'attach',ms,options);
+ if(ms<holdEnd)return renderJanus(rig,'hold',ms-ATTACH_MS,options);
+ if(ms<grantEnd)return renderJanus(rig,'grant',ms-holdEnd,options);
+ if(ms<openEnd)return renderJanus(rig,'threshold',ms-grantEnd,options);
+ return renderJanus(rig,'deny',Math.min(ms-openEnd,DENY_MS-1),options);
+}

package/vendor/dragonlab/design/janus/v5/character.mjs

@@ -0,0 +1,55 @@
+import {renderSvgRig} from '../../../factory/svg-rig-contour.mjs';
+import {poseRig as v4Pose,JANUS_CLIPS,ATTACH_MS,GRANT_MS,DENY_MS,HOLD_ENTER_MS,HOLD_LOOP_MS,STORY_DURATION,janusParams,BAR_Y} from '../v4/character.mjs';
+export {JANUS_CLIPS,ATTACH_MS,GRANT_MS,DENY_MS,HOLD_ENTER_MS,HOLD_LOOP_MS,STORY_DURATION,janusParams,BAR_Y};
+
+/**
+ * Janus V5: the APPROVED V1 look (design/janus/v1/janus-master.svg: anatomy, curled horns, palette,
+ * face) driven by V4's acting (attach, idle, hold, grant, threshold, deny). Load it with the V1 master.
+ * V4 acted on V3's lower ram horns, which the owner never approved; V5 drops them.
+ * V4's camera bounds already equal the V1 master's ink bounds, so framing is V1's.
+ * One visual repair: V2 to V4 replaced V1's authored closed seam (an 18-wide dark stroke between the
+ * two jambs) with a narrower erased doorway. V5 puts V1's seam back, following the doorway's top and
+ * bottom, so the rest pose is cell-for-cell V1 and the opened doorway still erases over it.
+ * Pure functions of elapsed time. Renderers draw; the host supplies approval state.
+ */
+const STILL=Object.freeze({idle:0,attach:1500,threshold:6500,hold:3000,grant:700,deny:2600});
+const V1_SEAM={id:'closed-seam-dark',group:'threshold',rgb:[8,13,25],stroke:18,erase:true};
+
+function restoreV1Seam(posed){
+ const at=posed.paths.findIndex(p=>p.id==='gateway-void');
+ if(at<0)return posed;
+ const ys=posed.paths[at].polygons[0].map(([,y])=>y),top=Math.min(...ys),bottom=Math.max(...ys);
+ const paths=[...posed.paths.slice(0,at),{...V1_SEAM,polygons:[[[375,top],[375,bottom]]]},...posed.paths.slice(at)];
+ return {...posed,paths};
+}
+export function poseRig(rig,scene,ms,options={}){return restoreV1Seam(v4Pose(rig,scene,ms,options));}
+
+function caption(scene,t){
+ if(scene==='attach')return t<900?'Someone at the gate.':t<2300?'Both faces acknowledge you.':'Settle. Watch both ways.';
+ if(scene==='hold')return t<HOLD_ENTER_MS?'Shut the gate.':'Gate held until you decide.';
+ if(scene==='grant')return 'Approved. Unbar the gate.';
+ if(scene==='deny')return t<700?'Face the gate.':t<2600?'Bar the way.':t<4400?'Turned back.':'Resume watch.';
+ if(scene==='threshold')return t<2200?'An arrival at the gate.':t<3000?'Wait at the threshold.':t<5500?'Both guardians attend. Open the way.':t<8300?'Pass through the gateway.':'Close the passage. Resume watch.';
+ return 'One watches each side.';
+}
+const ENDS={attach:ATTACH_MS,grant:GRANT_MS,deny:DENY_MS,threshold:12000};
+export function renderJanus(rig,scene='idle',ms=0,options={}){
+ if(!JANUS_CLIPS.some(c=>c.id===scene))return {ok:false,code:'UNKNOWN_CLIP'};
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ // Still freezes every channel (heads, pupils, cloak, keystone, bars, traveller) at one pose.
+ let t=options.still?STILL[scene]:ms;
+ // Clips that hand off to idle continue on idle's clock.
+ if(ENDS[scene]&&t>=ENDS[scene]){t-=ENDS[scene];scene='idle';}
+ return {...renderSvgRig(poseRig(rig,scene,t,options),options),scene,clip:scene,caption:caption(scene,t)};
+}
+/** Offline story: attach, a pending approval holds the gate, approval unbars it, a traveller passes, then a denial. Simulated; no host state. */
+export function renderStory(rig,ms,options={}){
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ if(options.still)return renderJanus(rig,'hold',0,options);
+ const holdEnd=ATTACH_MS+HOLD_ENTER_MS+HOLD_LOOP_MS,grantEnd=holdEnd+GRANT_MS,openEnd=grantEnd+12000;
+ if(ms<ATTACH_MS)return renderJanus(rig,'attach',ms,options);
+ if(ms<holdEnd)return renderJanus(rig,'hold',ms-ATTACH_MS,options);
+ if(ms<grantEnd)return renderJanus(rig,'grant',ms-holdEnd,options);
+ if(ms<openEnd)return renderJanus(rig,'threshold',ms-grantEnd,options);
+ return renderJanus(rig,'deny',Math.min(ms-openEnd,DENY_MS-1),options);
+}

package/vendor/dragonlab/design/janus/v5/review.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import fs from 'node:fs/promises';
+import {parseSvgRig} from '../../../factory/svg-rig-contour.mjs';
+import {renderJanus,JANUS_CLIPS} from './character.mjs';
+import {artSlot,composeMessage} from '../../lucid/recovery/layout.mjs';
+import {cellsToAnsi} from '../../../vendor/quox-dragon/qart.js';
+const args=process.argv.slice(2),values=new Set(['--cols','--rows','--terminal-cols','--terminal-rows','--message','--scene','--at']);
+for(let i=0;i<args.length;i++){
+ if(values.has(args[i])){if(!args[i+1]||args[i+1].startsWith('--'))throw Error('Missing option value');i++;}
+ else if(!['--large','--mono','--help','--watch','--attach','--intro','--still','--list'].includes(args[i]))throw Error('Unknown option: '+args[i]);
+}
+const value=(name,fallback)=>args.includes(name)?args[args.indexOf(name)+1]:fallback;
+if(args.includes('--help')){console.log('Janus V5 gate studio (approved V1 look, V4 acting). --watch --attach --intro --still --scene ID --at MS --list --large --mono --message TEXT --cols N --rows N --terminal-cols N --terminal-rows N');process.exit(0);}
+if(args.includes('--list')){console.log(JANUS_CLIPS.map(c=>c.id+' · '+c.title).join('\n'));process.exit(0);}
+const w=Number(value('--terminal-cols',process.stdout.columns||80)),h=Number(value('--terminal-rows',process.stdout.rows||24));
+if(!Number.isSafeInteger(w)||!Number.isSafeInteger(h)||w<1||h<1)throw Error('Invalid terminal size');
+const slot=artSlot(w,h),large=args.includes('--large')||args.includes('--intro'),explicit=large||args.includes('--cols')||args.includes('--rows');
+const cols=Number(value('--cols',large?Math.min(120,w-4):Math.min(39,slot.cols))),rows=Number(value('--rows',large?Math.min(36,h-4):Math.min(11,slot.rows)));
+const message=value('--message','JANUS\nWatch. Judge. Open.');
+if(!slot.showArt&&!explicit){console.log(composeMessage(null,message,{terminalCols:w}).join('\n'));}
+else{
+ if(cols>w-4||rows>h-2)throw Error('Requested art exceeds terminal margins');
+ const rig=parseSvgRig(await fs.readFile(new URL('../v1/janus-master.svg',import.meta.url),'utf8'));
+ const opts={cols,rows,mono:args.includes('--mono'),still:args.includes('--still'),deck:large};
+ const scene=value('--scene',args.includes('--attach')?'attach':'idle');
+ const r=renderJanus(rig,scene,Number(value('--at',0)),opts);
+ if(!r.ok)throw Error(r.code);
+ if(args.includes('--watch')||args.includes('--attach')||args.includes('--intro')){
+  const {watch}=await import('./watch.mjs');
+  await watch(rig,opts,{terminalCols:w,terminalRows:h,large,scene:args.includes('--scene')||args.includes('--attach')?scene:null,arrival:args.includes('--attach'),message:args.includes('--message')?message:null});
+ }else{
+ const shownMessage=args.includes('--message')?message:'JANUS\n'+r.caption;
+ console.log((large?[...cellsToAnsi(r.frame),...composeMessage(null,shownMessage,{terminalCols:w})]:composeMessage(r.frame,shownMessage,{terminalCols:w})).join('\n'));
+}
+}

package/vendor/dragonlab/design/janus/v5/watch.mjs

@@ -0,0 +1,56 @@
+import {performance} from 'node:perf_hooks';
+import {JANUS_CLIPS,renderJanus,renderStory,STORY_DURATION} from './character.mjs';
+import {composeMessage} from '../../lucid/recovery/layout.mjs';
+import {cellsToAnsi} from '../../../vendor/quox-dragon/qart.js';
+
+/** One bounded performance. No alternate screen or full-screen clearing. */
+export async function watch(paths,options,config){
+  if(!process.stdout.isTTY||!process.stdin.isTTY)throw new Error('--watch/--intro needs an interactive terminal. Use --scene and --at for snapshots.');
+  const {terminalCols,terminalRows,scene,large,message}=config;
+  const clip=scene?JANUS_CLIPS.find(c=>c.id===scene):null;
+  const duration=(clip?.duration??STORY_DURATION)+(config.arrival?6000:0);
+  const realCols=process.stdout.columns,realRows=process.stdout.rows;
+  const start=performance.now();
+  const render=t=>{
+    const r=scene?renderJanus(paths,scene,t,options):renderStory(paths,t,options);
+    if(!r?.ok)throw new Error(r?.code??'Invalid story frame');
+    const caption=message??'JANUS · '+r.clip+'\n'+r.caption;
+    return large?[...cellsToAnsi(r.frame),...caption.split('\n')]:composeMessage(r.frame,caption,{terminalCols});
+  };
+  // Reserve enough lines for captions too; keep within the real terminal.
+  const height=options.rows+3;
+  if(height>=terminalRows)throw new Error('Animation needs room for its caption; reduce --rows.');
+  let ended=false,drawn=false,timer,resolveDone,rejectDone;
+  const wasRaw=Boolean(process.stdin.isRaw);
+  const done=new Promise((resolve,reject)=>{resolveDone=resolve;rejectDone=reject;});
+  const cleanup=(error)=>{
+    if(ended)return;ended=true;clearInterval(timer);
+    process.stdin.off('data',key);process.stdout.off('resize',resized);
+    process.off('SIGINT',sigint);process.off('SIGTERM',sigterm);
+    process.stdin.setRawMode(wasRaw);process.stdin.pause();
+    if(drawn)process.stdout.write(`\x1b[${height}B\r`);
+    process.stdout.write('\x1b[0m\x1b[?25h');
+    error?rejectDone(error):resolveDone();
+  };
+  const key=data=>{if(data.includes(3)||data.toString().includes('q'))cleanup();};
+  const sigint=()=>cleanup(),sigterm=()=>cleanup();
+  const resized=()=>cleanup(new Error('Terminal resized; rerun for the new art slot.'));
+  try{
+    process.stdin.setRawMode(true);process.stdin.resume();process.stdin.on('data',key);
+    process.stdout.on('resize',resized);process.on('SIGINT',sigint);process.on('SIGTERM',sigterm);
+    process.stdout.write('\x1b[?25l');
+    // Allocate the block once; each frame replaces only these lines.
+    process.stdout.write('\n'.repeat(height)+`\x1b[${height}A`);drawn=true;
+    const tick=()=>{
+      try{
+        if(process.stdout.columns!==realCols||process.stdout.rows!==realRows)return resized();
+        const t=Math.min(performance.now()-start,duration-1),lines=render(t);
+        if(lines.length>height)throw new Error('Message exceeds the animation block; use a shorter message or a static preview.');
+        process.stdout.write(Array.from({length:height},(_,i)=>'\r\x1b[2K'+(lines[i]??'')+'\n').join('')+`\x1b[${height}A`);
+        if(performance.now()-start>=duration)cleanup();
+      }catch(e){cleanup(e);}
+    };
+    tick();if(!ended)timer=setInterval(tick,1000/6);
+    await done;
+  }catch(e){cleanup(e);await done;}
+}

package/vendor/dragonlab/design/roady/v1/roady-master.svg

@@ -0,0 +1,67 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 480"><title>Roady — the way forward</title>
+<g id="far-wing">
+<path id="far-sail" d="M 391 282 Q 439 202 524 154 L 500 243 L 467 229 L 443 290 L 418 278 L 399 322 Z" fill="#b7572c"/>
+<path id="far-ribs" d="M 391 282 Q 439 202 524 154 M 391 282 L 500 243 M 391 282 L 443 290" fill="none" stroke="#3b9b9b" stroke-width="7"/>
+</g>
+<g id="tail">
+<path id="long-tail" d="M 300 352 C 234 356 217 418 156 416 C 105 415 99 376 129 346 Q 89 356 88 395 C 86 443 154 457 201 434 Q 263 398 319 396 Z" fill="#217582"/>
+<path id="tail-highlight" d="M 296 376 Q 231 393 192 426 Q 133 455 103 410 Q 136 436 184 416 Q 236 380 296 376 Z" fill="#63afa5"/>
+<path id="compass-tip" d="M 128 322 L 148 355 L 126 349 L 108 365 Z" fill="#ffb957"/>
+</g>
+<g id="body">
+<path id="body-mass" d="M 310 234 Q 357 217 395 255 L 409 331 Q 405 381 363 399 L 293 389 Q 266 349 282 303 Z" fill="#236f7c"/>
+<path id="belly" d="M 355 255 Q 383 248 393 279 L 397 334 Q 387 373 360 383 L 335 366 Q 359 314 345 279 Z" fill="#ead8aa"/>
+<path id="belly-lines" d="M 352 295 Q 372 307 396 292 M 350 324 Q 373 338 394 323 M 343 352 Q 366 363 383 352" fill="none" stroke="#b9976c" stroke-width="4"/>
+<path id="rear-leg" d="M 304 346 Q 269 353 270 389 L 250 427 L 293 435 L 324 382 Z" fill="#328b95"/>
+<path id="forward-leg" d="M 364 360 Q 389 362 390 391 L 427 417 L 459 419 L 469 435 L 407 437 L 357 403 Z" fill="#3a9ba0"/>
+<path id="claws" d="M 255 424 L 247 439 L 262 434 L 272 424 L 269 440 L 288 434 M 441 422 L 436 438 L 449 433 L 457 425 L 456 439 L 473 434" fill="#fff0d0"/>
+</g>
+<g id="near-wing">
+<path id="near-sail" d="M 318 267 Q 259 179 161 148 Q 190 193 161 239 L 204 232 L 227 287 L 262 271 L 298 321 Z" fill="#ec7938"/>
+<path id="near-web" d="M 318 267 L 161 148 Q 239 208 227 287 L 262 271 L 298 321 Z" fill="#ffa24a"/>
+<path id="near-ribs" d="M 318 267 Q 259 179 161 148 M 318 267 L 161 239 M 318 267 L 227 287" fill="none" stroke="#277d8a" stroke-width="8"/>
+<path id="shoulder" d="M 294 279 C 294 265.745166 302.50658975 255 313 255 C 323.49341025 255 332 265.745166 332 279 C 332 292.254834 323.49341025 303 313 303 C 302.50658975 303 294 292.254834 294 279 Z" fill="#3a96a0"/>
+</g>
+<g id="neck">
+<path id="neck-mass" d="M 331 176 L 386 185 Q 372 231 397 270 L 364 298 L 323 268 Q 344 224 331 176 Z" fill="#328f9a"/>
+</g>
+<g id="scarf">
+<path id="streamer" d="M 346 244 Q 289 227 252 247 L 217 229 L 232 265 L 211 282 Q 279 286 351 260 Z" fill="#ed7233"/>
+<path id="collar" d="M 320 229 Q 354 247 389 224 L 394 249 Q 357 272 321 250 Z" fill="#ff9c43"/>
+</g>
+<g id="satchel">
+<path id="strap" d="M 324 267 L 335 265 L 376 350 L 366 355 Z" fill="#e1b56b"/>
+<path id="bag" d="M 285 322 L 328 331 L 328 374 L 284 365 Z" fill="#b57743"/>
+<path id="flap" d="M 285 322 L 329 331 L 313 350 L 283 338 Z" fill="#e2af6b"/>
+</g>
+<g id="head">
+<path id="far-horn" d="M 344 142 Q 291 117 272 66 Q 313 102 360 113 Z" fill="#e5d9bc"/>
+<path id="near-horn" d="M 382 130 Q 345 91 348 53 Q 369 90 409 105 L 405 138 Z" fill="#fff0d0"/>
+<path id="ear" d="M 328 155 L 291 131 L 300 174 L 331 187 Z" fill="#4ea9a6"/>
+<path id="face" d="M 331 133 Q 373 108 405 139 Q 426 166 406 203 L 370 223 L 331 207 Q 314 172 331 133 Z" fill="#3c9aa5"/>
+<path id="muzzle" d="M 381 178 Q 426 164 460 183 L 466 204 Q 444 226 398 222 L 371 204 Z" fill="#6bb9b2"/>
+<path id="jaw" d="M 387 214 Q 433 224 458 207 Q 450 238 410 232 Z" fill="#dfd6ae"/>
+<path id="smile" d="M 386 204 Q 424 220 458 201" fill="none" stroke="#080d19" stroke-width="6"/>
+<path id="nostril" d="M 442 182 Q 456 182 451 192 L 441 190 Z" fill="#080d19"/>
+</g>
+<g id="map">
+<path id="scroll" d="M 360 332 L 446 300 L 460 328 L 373 362 Z" fill="#eddcb0"/>
+<path id="scroll-edge" d="M 360 332 L 373 362 M 446 300 L 460 328" fill="none" stroke="#fff3ce" stroke-width="10"/>
+<path id="map-tie" d="M 402 316 L 415 346" fill="none" stroke="#da6c37" stroke-width="8"/>
+<path id="scroll-end" d="M 443 314 C 443 305.71572875 447.4771525 299 453 299 C 458.5228475 299 463 305.71572875 463 314 C 463 322.28427125 458.5228475 329 453 329 C 447.4771525 329 443 322.28427125 443 314 Z" fill="#fff0cb"/>
+<path id="scroll-hole" d="M 449 314 C 449 310.13400675 450.790861 307 453 307 C 455.209139 307 457 310.13400675 457 314 C 457 317.86599325 455.209139 321 453 321 C 450.790861 321 449 317.86599325 449 314 Z" fill="#080d19"/>
+</g>
+<g id="arms">
+<path id="map-arm" d="M 350 278 Q 370 274 375 297 L 403 311 L 419 301 L 433 313 Q 417 341 395 336 L 357 317 Z" fill="#439eaa"/>
+<path id="point-arm" d="M 391 259 Q 402 247 419 263 L 442 276 L 487 250 L 493 234 L 520 223 L 526 232 L 508 245 L 526 245 L 526 255 L 499 264 L 454 305 Q 439 312 423 298 Z" fill="#59acb1"/>
+<path id="grip-claws" d="M 407 305 L 414 297 L 418 313 M 418 309 L 427 302 L 430 317" fill="#fff0cf"/>
+</g>
+<g id="eyes">
+<path id="far-eye-socket" d="M 324 167 C 324 153.19288125 332.50658975 142 343 142 C 353.49341025 142 362 153.19288125 362 167 C 362 180.80711875 353.49341025 192 343 192 C 332.50658975 192 324 180.80711875 324 167 Z" fill="#080d19"/>
+<path id="far-eye-white" d="M 331 167 C 331 157.0588745 336.372583 149 343 149 C 349.627417 149 355 157.0588745 355 167 C 355 176.9411255 349.627417 185 343 185 C 336.372583 185 331 176.9411255 331 167 Z" fill="#ffffff"/>
+<path id="far-pupil" d="M 342 167 C 342 163.13400675 344.23857625 160 347 160 C 349.76142375 160 352 163.13400675 352 167 C 352 170.86599325 349.76142375 174 347 174 C 344.23857625 174 342 170.86599325 342 167 Z" fill="#080d19"/>
+<path id="near-eye-socket" d="M 363 163 C 363 146.98374225 373.745166 134 387 134 C 400.254834 134 411 146.98374225 411 163 C 411 179.01625775 400.254834 192 387 192 C 373.745166 192 363 179.01625775 363 163 Z" fill="#080d19"/>
+<path id="near-eye-white" d="M 370 163 C 370 150.8497355 377.61115925 141 387 141 C 396.38884075 141 404 150.8497355 404 163 C 404 175.1502645 396.38884075 185 387 185 C 377.61115925 185 370 175.1502645 370 163 Z" fill="#ffffff"/>
+<path id="near-pupil" d="M 386 163 C 386 159.13400675 388.23857625 156 391 156 C 393.76142375 156 396 159.13400675 396 163 C 396 166.86599325 393.76142375 170 391 170 C 388.23857625 170 386 166.86599325 386 163 Z" fill="#080d19"/>
+</g>
+</svg>

package/vendor/dragonlab/design/roady/v2/character.mjs

@@ -0,0 +1,69 @@
+import {renderSvgRig} from '../../../factory/svg-rig-contour.mjs';
+export const STORY_DURATION=20000;
+export const ROADY_CLIPS=Object.freeze([{id:'idle',title:'Ready for the next step',duration:8000},{id:'journey',title:'Chart · Blocked · Reroute · Arrive',duration:STORY_DURATION}]);
+const clamp=x=>Math.max(0,Math.min(1,x));
+const ease=x=>{x=clamp(x);return x*x*(3-2*x);};
+const rot=(x,y,cx,cy,a)=>[cx+(x-cx)*Math.cos(a)-(y-cy)*Math.sin(a),cy+(x-cx)*Math.sin(a)+(y-cy)*Math.cos(a)];
+export function poseRig(rig,scene,ms){
+ if(scene==='journey'&&ms>=STORY_DURATION)return poseRig(rig,'idle',ms-STORY_DURATION);
+ const t=ms,active=scene==='journey',env=active?ease(t/1400)*(1-ease((t-17500)/2500)):0;
+ const open=active?ease((t-1300)/2000)*(1-ease((t-17000)/2300)):0;
+ const blocked=active?ease((t-6300)/600)*(1-ease((t-10500)/1000)):0;
+ const success=active?ease((t-13500)/1100)*(1-ease((t-17000)/1800)):0;
+ const quiet=Math.sin(t/8000*Math.PI*2);
+ const headAngle=active?(.09*blocked-.08*success+.025*Math.sin(t/700)*env):.018*quiet;
+ const head=(x,y)=>rot(x,y,355,235,headAngle);
+ const paths=rig.paths.map(p=>({...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>{
+  if(p.group==='head'||p.group==='eyes'){
+   const q=head(x,y);if(p.id.endsWith('pupil'))q[0]+=active?(-5*success+2*blocked):1.5*quiet;return q;
+  }
+  if(p.group==='neck'){const w=clamp((285-y)/100),q=head(x,y);return [x+(q[0]-x)*w,y+(q[1]-y)*w];}
+  if(p.group==='near-wing')return rot(x,y,318,267,.035*quiet+.14*success);
+  if(p.group==='far-wing')return rot(x,y,391,282,-.025*quiet-.11*success);
+  if(p.group==='tail'){const w=clamp((300-x)/210);return [x+8*w*quiet,y-12*w*quiet-10*w*success];}
+  if(p.id==='streamer'){const w=clamp((346-x)/135);return [x,y+w*(4*quiet+5*env*Math.sin(t/450))];}
+  if(p.id==='point-arm'){const w=clamp((x-405)/95);return [x+5*w*env,y+14*w*blocked-10*w*success];}
+  return [x,y];
+ }))}));
+ const add=(id,rgb,poly,stroke=0,erase=false)=>paths.push({id,group:'roadmap',rgb,polygons:[poly],stroke,erase});
+ const line=(id,rgb,a,b,w=5)=>add(id,rgb,[a,b],w);
+ if(open>.001){
+  const X=u=>453+u*open,Y=(u,v)=>320+u*.18+v;
+  const pt=(u,v)=>[X(u),Y(u,v)];
+  add('map-shadow',[8,13,25],[pt(0,-4),pt(256,-4),pt(256,111),pt(0,111)],0,true);
+  add('unfurled-map',[229,213,164],[pt(0,0),pt(250,0),pt(250,104),pt(0,104)]);
+  line('map-edge',[255,242,205],pt(250,0),pt(250,104),7);
+  const route=[[15,75],[75,51],[140,67],[222,26]];
+  const draw=(id,points,progress,rgb,w)=>{
+   let count=clamp(progress)*(points.length-1);
+   for(let i=0;i<points.length-1;i++){
+    const f=clamp(count-i);if(f>0)line(id+i,rgb,pt(...points[i]),pt(points[i][0]+(points[i+1][0]-points[i][0])*f,points[i][1]+(points[i+1][1]-points[i][1])*f),w);
+   }
+  };
+  draw('planned-route',route,(t-2800)/2700,[50,105,117],6);
+  for(let i=0;i<route.length;i++)if(t>3200+i*700){const [u,v]=route[i];add('milestone'+i,[37,104,118],[pt(u-6,v),pt(u,v-7),pt(u+6,v),pt(u,v+7)]);}
+  if(blocked>.01){const u=140,v=67;line('blocked-a',[199,58,40],pt(u-12*blocked,v-12*blocked),pt(u+12*blocked,v+12*blocked),8);line('blocked-b',[199,58,40],pt(u-12*blocked,v+12*blocked),pt(u+12*blocked,v-12*blocked),8);}
+  const detour=[[75,51],[114,20],[168,13],[222,26]];
+  if(t>9000)draw('detour',detour,(t-9000)/3500,[220,102,27],7);
+  if(t>12300){
+   const progress=clamp((t-12300)/2100)*(detour.length-1),i=Math.min(2,Math.floor(progress)),f=progress-i;
+   const [u,v]=[detour[i][0]+(detour[i+1][0]-detour[i][0])*f,detour[i][1]+(detour[i+1][1]-detour[i][1])*f];
+   add('traveller',[255,255,255],[pt(u-7,v),pt(u,v-8),pt(u+7,v),pt(u,v+8)]);
+  }
+  if(success>.001){
+   const h=48*success;line('flagpole',[37,90,103],pt(222,26),pt(222,26-h),5);
+   add('destination-flag',[238,104,35],[pt(222,26-h),pt(247,34-h+3*Math.sin(t/180)),pt(222,43-h)]);
+  }
+ }
+ const byId=new Map(paths.map(p=>[p.id,p]));
+ return {...rig,bounds:{left:65,top:35,right:730,bottom:510},paths,eyes:rig.eyes.map(e=>({...e,socket:byId.get(e.socket.id),white:byId.get(e.white.id),pupil:byId.get(e.pupil.id)}))};
+}
+export function renderRoady(rig,scene='idle',ms=0,options={}){
+ if(!ROADY_CLIPS.some(c=>c.id===scene))return {ok:false,code:'UNKNOWN_CLIP'};
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ if(!options.still&&scene==='journey'&&ms>=STORY_DURATION)return renderRoady(rig,'idle',ms-STORY_DURATION,options);
+ const t=options.still?(scene==='journey'?15000:0):ms;
+ const caption=scene==='idle'?'Every goal needs a way forward.':t<2800?'First, let’s see where we’re going.':t<6300?'A destination. A few clear steps.':t<9000?'Ah. That route is blocked.':t<12300?'There’s another way around.':t<14500?'One step at a time.':t<17500?'Told you we’d find a way.':'Ready for the next adventure.';
+ return {...renderSvgRig(poseRig(rig,scene,t),options),scene,clip:scene,caption};
+}
+export const renderStory=(rig,ms,options={})=>renderRoady(rig,'journey',ms,options);

package/vendor/dragonlab/design/roady/v3/character.mjs

@@ -0,0 +1,91 @@
+import {renderSvgRig} from '../../../factory/svg-rig-contour.mjs';
+import {poseRig as v2Pose,renderRoady as v2Render,ROADY_CLIPS as v2Clips} from '../v2/character.mjs';
+
+/**
+ * Roady V3: companion pass on the approved V1 SVG. Idle and Journey are V2 exactly.
+ * Adds 'attach' (notice, a raised-claw wave, settle; exact handoff to idle) and 'chart' (unroll the map, trace one
+ * planned route with its milestones, point the way, roll it up). Chart has no blockage, detour or arrival flag:
+ * those would claim plan facts the host never states. Pure functions of elapsed time.
+ */
+export const ATTACH_MS=3400,CHART_MS=7000;
+export const ROADY_CLIPS=Object.freeze([...v2Clips,{id:'attach',title:'Notice · wave · settle',duration:ATTACH_MS},{id:'chart',title:'Chart the route',duration:CHART_MS}]);
+export const STORY_DURATION=ATTACH_MS+CHART_MS;
+const STILL=Object.freeze({attach:1500,chart:3600});
+const clamp=x=>Math.max(0,Math.min(1,x));
+const ease=x=>{x=clamp(x);return x*x*(3-2*x);};
+const pulse=(t,a,b)=>t<=a||t>=b?0:Math.sin(Math.PI*(t-a)/(b-a))**2;
+const rot=(x,y,cx,cy,a)=>[cx+(x-cx)*Math.cos(a)-(y-cy)*Math.sin(a),cy+(x-cx)*Math.sin(a)+(y-cy)*Math.cos(a)];
+const REST=Object.freeze({head:0,pupil:0,near:0,far:0,tailX:0,tailY:0,streamer:0,armX:0,armY:0,open:0,route:0,marks:0});
+
+/** One parameter set per instant. All zero is V2 idle at t=0, the rest pose. */
+export function roadyParams(scene,t){
+ if(scene==='attach'){
+  // Notice: the head lifts and the eyes glance back at whoever arrived. Acknowledge: a nod and a raised-claw wave.
+  // Settle: wings flex, scarf and tail land last.
+  return {...REST,head:-.06*pulse(t,0,1400)+.06*pulse(t,1100,2600),pupil:-3*pulse(t,200,2400),
+   armX:4*pulse(t,900,2600),armY:-12*pulse(t,900,2600),near:.10*pulse(t,1500,3100),far:-.08*pulse(t,1700,3300),
+   tailX:4*pulse(t,1900,3400),tailY:-8*pulse(t,1900,3400),streamer:4*pulse(t,1600,3400)*Math.sin(t/300)};
+ }
+ if(scene==='chart'){
+  const env=ease(t/900)*(1-ease((t-6000)/1000));
+  return {...REST,head:.03*pulse(t,1800,4400)-.05*pulse(t,4300,5800),pupil:2*pulse(t,1500,4600),
+   armX:5*env,armY:-6*pulse(t,3800,5400),near:.05*pulse(t,4200,6000),streamer:5*env*Math.sin(t/450),
+   open:ease((t-500)/1600)*(1-ease((t-5200)/1500)),route:clamp((t-1800)/2400),marks:t<2000?0:Math.min(4,1+Math.floor((t-2000)/600))};
+ }
+ return REST;
+}
+const BOUNDS=Object.freeze({left:65,top:35,right:730,bottom:510});
+function poseFromParams(rig,P){
+ const head=(x,y)=>rot(x,y,355,235,P.head);
+ // Same anatomy transforms as V2: shared head/eye joint, neck blended into the chest, rooted wings, root-weighted tail.
+ const paths=rig.paths.map(p=>({...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>{
+  if(p.group==='head'||p.group==='eyes'){const q=head(x,y);if(p.id.endsWith('pupil'))q[0]+=P.pupil;return q;}
+  if(p.group==='neck'){const w=clamp((285-y)/100),q=head(x,y);return [x+(q[0]-x)*w,y+(q[1]-y)*w];}
+  if(p.group==='near-wing')return rot(x,y,318,267,P.near);
+  if(p.group==='far-wing')return rot(x,y,391,282,P.far);
+  if(p.group==='tail'){const w=clamp((300-x)/210);return [x+P.tailX*w,y+P.tailY*w];}
+  if(p.id==='streamer'){const w=clamp((346-x)/135);return [x,y+w*P.streamer];}
+  if(p.id==='point-arm'){const w=clamp((x-405)/95);return [x+P.armX*w,y+P.armY*w];}
+  return [x,y];
+ }))}));
+ if(P.open>.001){
+  // V2's map, planned route and milestones only. No blockage, detour, traveller or flag.
+  const add=(id,rgb,poly,stroke=0,erase=false)=>paths.push({id,group:'roadmap',rgb,polygons:[poly],stroke,erase});
+  const pt=(u,v)=>[453+u*P.open,320+u*.18+v];
+  add('map-shadow',[8,13,25],[pt(0,-4),pt(256,-4),pt(256,111),pt(0,111)],0,true);
+  add('unfurled-map',[229,213,164],[pt(0,0),pt(250,0),pt(250,104),pt(0,104)]);
+  add('map-edge',[255,242,205],[pt(250,0),pt(250,104)],7);
+  const route=[[15,75],[75,51],[140,67],[222,26]],count=P.route*(route.length-1);
+  for(let i=0;i<route.length-1;i++){const f=clamp(count-i);if(f>0)add('planned-route'+i,[50,105,117],[pt(...route[i]),pt(route[i][0]+(route[i+1][0]-route[i][0])*f,route[i][1]+(route[i+1][1]-route[i][1])*f)],6);}
+  for(let i=0;i<P.marks;i++){const [u,v]=route[i];add('milestone'+i,[37,104,118],[pt(u-6,v),pt(u,v-7),pt(u+6,v),pt(u,v+7)]);}
+ }
+ const byId=new Map(paths.map(p=>[p.id,p]));
+ return {...rig,bounds:BOUNDS,paths,eyes:rig.eyes.map(e=>({...e,socket:byId.get(e.socket.id),white:byId.get(e.white.id),pupil:byId.get(e.pupil.id)}))};
+}
+const NEW=new Set(['attach','chart']);
+export function poseRig(rig,scene,ms){
+ if(!NEW.has(scene))return v2Pose(rig,scene,ms);
+ const d=scene==='attach'?ATTACH_MS:CHART_MS;
+ if(ms>=d)return v2Pose(rig,'idle',ms-d);
+ return poseFromParams(rig,roadyParams(scene,ms));
+}
+function caption(scene,t){
+ if(scene==='attach')return t<1100?'Oh, hello there.':t<2600?'Roady waves you aboard.':'Ready for the next step.';
+ return t<1800?'Unroll the map.':t<4400?'Trace the route. Mark the milestones.':t<5200?'That way.':'Roll it up. Onward.';
+}
+export function renderRoady(rig,scene='idle',ms=0,options={}){
+ if(!ROADY_CLIPS.some(c=>c.id===scene))return {ok:false,code:'UNKNOWN_CLIP'};
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ if(!NEW.has(scene))return v2Render(rig,scene,ms,options);
+ const d=scene==='attach'?ATTACH_MS:CHART_MS;
+ if(!options.still&&ms>=d)return v2Render(rig,'idle',ms-d,options);
+ // Still freezes every channel (head, pupils, wave, wings, tail, scarf, map, route) at one pose.
+ const t=options.still?STILL[scene]:ms;
+ return {...renderSvgRig(poseRig(rig,scene,t),options),scene,clip:scene,caption:caption(scene,t)};
+}
+/** Offline companion story: attach, then chart, then idle. Simulated; no QuoxPlan state. */
+export function renderStory(rig,ms,options={}){
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ if(options.still)return renderRoady(rig,'chart',0,options);
+ return ms<ATTACH_MS?renderRoady(rig,'attach',ms,options):renderRoady(rig,'chart',ms-ATTACH_MS,options);
+}

package/vendor/dragonlab/design/roady/v3/review.mjs

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import fs from 'node:fs/promises';
+import {parseSvgRig} from '../../../factory/svg-rig-contour.mjs';
+import {renderRoady,ROADY_CLIPS} from './character.mjs';
+import {artSlot,composeMessage} from '../../lucid/recovery/layout.mjs';
+import {cellsToAnsi} from '../../../vendor/quox-dragon/qart.js';
+const args=process.argv.slice(2),values=new Set(['--cols','--rows','--terminal-cols','--terminal-rows','--message','--scene','--at']);
+for(let i=0;i<args.length;i++){
+ if(values.has(args[i])){if(!args[i+1]||args[i+1].startsWith('--'))throw Error('Missing option value');i++;}
+ else if(!['--large','--mono','--help','--watch','--attach','--intro','--still','--list'].includes(args[i]))throw Error('Unknown option: '+args[i]);
+}
+const value=(name,fallback)=>args.includes(name)?args[args.indexOf(name)+1]:fallback;
+if(args.includes('--help')){console.log('Roady V3 roadmap studio (companion attach and Chart). --watch --attach --intro --still --scene ID --at MS --list --large --mono --message TEXT --cols N --rows N --terminal-cols N --terminal-rows N');process.exit(0);}
+if(args.includes('--list')){console.log(ROADY_CLIPS.map(c=>c.id+' · '+c.title).join('\n'));process.exit(0);}
+const w=Number(value('--terminal-cols',process.stdout.columns||80)),h=Number(value('--terminal-rows',process.stdout.rows||24));
+if(!Number.isSafeInteger(w)||!Number.isSafeInteger(h)||w<1||h<1)throw Error('Invalid terminal size');
+const slot=artSlot(w,h),large=args.includes('--large')||args.includes('--intro'),explicit=large||args.includes('--cols')||args.includes('--rows');
+const cols=Number(value('--cols',large?Math.min(120,w-4):Math.min(39,slot.cols))),rows=Number(value('--rows',large?Math.min(36,h-4):Math.min(11,slot.rows)));
+const message=value('--message','ROADY\nEvery goal needs a way forward.');
+if(!slot.showArt&&!explicit){console.log(composeMessage(null,message,{terminalCols:w}).join('\n'));}
+else{
+ if(cols>w-4||rows>h-2)throw Error('Requested art exceeds terminal margins');
+ const rig=parseSvgRig(await fs.readFile(new URL('../v1/roady-master.svg',import.meta.url),'utf8'));
+ const opts={cols,rows,mono:args.includes('--mono'),still:args.includes('--still'),deck:large};
+ const scene=value('--scene',args.includes('--attach')?'attach':'idle');
+ const r=renderRoady(rig,scene,Number(value('--at',0)),opts);
+ if(!r.ok)throw Error(r.code);
+ if(args.includes('--watch')||args.includes('--attach')||args.includes('--intro')){
+  const {watch}=await import('./watch.mjs');
+  await watch(rig,opts,{terminalCols:w,terminalRows:h,large,scene:args.includes('--scene')||args.includes('--attach')?scene:null,arrival:args.includes('--attach'),message:args.includes('--message')?message:null});
+ }else{
+ const shownMessage=args.includes('--message')?message:'ROADY\n'+r.caption;
+ console.log((large?[...cellsToAnsi(r.frame),...composeMessage(null,shownMessage,{terminalCols:w})]:composeMessage(r.frame,shownMessage,{terminalCols:w})).join('\n'));
+}
+}

package/vendor/dragonlab/design/roady/v3/watch.mjs

@@ -0,0 +1,56 @@
+import {performance} from 'node:perf_hooks';
+import {ROADY_CLIPS,renderRoady,renderStory,STORY_DURATION} from './character.mjs';
+import {composeMessage} from '../../lucid/recovery/layout.mjs';
+import {cellsToAnsi} from '../../../vendor/quox-dragon/qart.js';
+
+/** One bounded performance. No alternate screen or full-screen clearing. */
+export async function watch(paths,options,config){
+  if(!process.stdout.isTTY||!process.stdin.isTTY)throw new Error('--watch/--intro needs an interactive terminal. Use --scene and --at for snapshots.');
+  const {terminalCols,terminalRows,scene,large,message}=config;
+  const clip=scene?ROADY_CLIPS.find(c=>c.id===scene):null;
+  const duration=(clip?.duration??STORY_DURATION)+(config.arrival?6000:0);
+  const realCols=process.stdout.columns,realRows=process.stdout.rows;
+  const start=performance.now();
+  const render=t=>{
+    const r=scene?renderRoady(paths,scene,t,options):renderStory(paths,t,options);
+    if(!r?.ok)throw new Error(r?.code??'Invalid story frame');
+    const caption=message??'ROADY · '+r.clip+'\n'+r.caption;
+    return large?[...cellsToAnsi(r.frame),...caption.split('\n')]:composeMessage(r.frame,caption,{terminalCols});
+  };
+  // Reserve enough lines for captions too; keep within the real terminal.
+  const height=options.rows+3;
+  if(height>=terminalRows)throw new Error('Animation needs room for its caption; reduce --rows.');
+  let ended=false,drawn=false,timer,resolveDone,rejectDone;
+  const wasRaw=Boolean(process.stdin.isRaw);
+  const done=new Promise((resolve,reject)=>{resolveDone=resolve;rejectDone=reject;});
+  const cleanup=(error)=>{
+    if(ended)return;ended=true;clearInterval(timer);
+    process.stdin.off('data',key);process.stdout.off('resize',resized);
+    process.off('SIGINT',sigint);process.off('SIGTERM',sigterm);
+    process.stdin.setRawMode(wasRaw);process.stdin.pause();
+    if(drawn)process.stdout.write(`\x1b[${height}B\r`);
+    process.stdout.write('\x1b[0m\x1b[?25h');
+    error?rejectDone(error):resolveDone();
+  };
+  const key=data=>{if(data.includes(3)||data.toString().includes('q'))cleanup();};
+  const sigint=()=>cleanup(),sigterm=()=>cleanup();
+  const resized=()=>cleanup(new Error('Terminal resized; rerun for the new art slot.'));
+  try{
+    process.stdin.setRawMode(true);process.stdin.resume();process.stdin.on('data',key);
+    process.stdout.on('resize',resized);process.on('SIGINT',sigint);process.on('SIGTERM',sigterm);
+    process.stdout.write('\x1b[?25l');
+    // Allocate the block once; each frame replaces only these lines.
+    process.stdout.write('\n'.repeat(height)+`\x1b[${height}A`);drawn=true;
+    const tick=()=>{
+      try{
+        if(process.stdout.columns!==realCols||process.stdout.rows!==realRows)return resized();
+        const t=Math.min(performance.now()-start,duration-1),lines=render(t);
+        if(lines.length>height)throw new Error('Message exceeds the animation block; use a shorter message or a static preview.');
+        process.stdout.write(Array.from({length:height},(_,i)=>'\r\x1b[2K'+(lines[i]??'')+'\n').join('')+`\x1b[${height}A`);
+        if(performance.now()-start>=duration)cleanup();
+      }catch(e){cleanup(e);}
+    };
+    tick();if(!ended)timer=setInterval(tick,1000/6);
+    await done;
+  }catch(e){cleanup(e);await done;}
+}