quoxcli 0.2.0 → 0.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "quoxcli",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Quox: the conversational front door to your self-hosted AI agent control plane",
   "type": "module",
   "bin": {
@@ -53,9 +53,13 @@
   "files": [
     "bin/",
     "lib/",
+    "vendor/",
     "!lib/**/*.test.js",
     "!lib/**/*.test.jsx",
     "!lib/**/__tests__/",
+    "!lib/vendor/",
+    "!lib/core/websiteSession.js",
+    "!lib/quoxon/whatsnew.md",
     "README.md",
     "LICENSE"
   ],

package/vendor/dragonlab/SOURCE

@@ -0,0 +1,4 @@
+repo: quoxai/dragonlab
+commit: 5b478a813554eb80793b848d14da1468ea3bdcef
+branch: HEAD
+files: 52

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

@@ -0,0 +1,46 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 480">
+<title>Cipher — network operations, electric-blue listening dragon</title>
+<g id="wings">
+<path id="far-sail" fill="#185a9b" d="M 352 288 Q 363 205 445 105 L 430 222 L 484 181 L 451 285 Z"/>
+<path id="near-sail" fill="#297cc4" d="M 398 302 Q 450 189 564 144 L 531 227 L 579 209 L 537 272 L 572 272 L 483 329 Z"/>
+<path id="sail-ribs" fill="none" stroke="#81ddff" stroke-width="8" d="M 398 302 L 564 144 L 481 272 L 537 272 M 352 288 L 445 105 L 398 246"/>
+</g>
+<g id="tail">
+<path id="tail-ribbon" fill="#2988da" d="M 475 305 C 538 278 625 287 658 327 C 696 378 630 409 589 387 C 547 366 564 328 613 313 C 673 294 711 263 695 218 Q 683 189 654 197 Q 691 201 677 234 C 663 262 600 266 559 295 C 502 337 525 398 576 419 C 644 446 731 395 696 332 C 663 266 548 253 469 275 Z"/>
+<path id="tail-edge" fill="none" stroke="#9aefff" stroke-width="7" d="M 491 294 C 554 274 641 289 665 335 C 686 374 637 404 594 384 M 613 313 C 673 294 711 263 695 218"/>
+<path id="tail-fin" fill="#76dbfb" d="M 688 226 L 641 221 L 658 202 L 635 180 Q 688 178 699 215 Z"/>
+</g>
+<g id="body">
+<path id="torso" fill="#287fc3" d="M 288 246 C 328 225 374 246 402 266 C 445 267 494 287 510 317 Q 524 356 476 367 L 331 354 Q 282 335 278 291 Z"/>
+<path id="silver-belly" fill="#bddceb" d="M 291 265 Q 346 301 426 308 L 480 340 Q 405 365 336 337 Q 295 319 291 265 Z"/>
+<path id="belly-plates" fill="none" stroke="#477b9d" stroke-width="5" d="M 320 295 L 315 325 M 348 306 L 344 339 M 379 311 L 376 345 M 410 315 L 408 348"/>
+<path id="rear-legs" fill="#2367a8" d="M 455 314 Q 496 299 505 338 L 495 386 L 526 399 L 525 412 L 468 412 L 469 362 L 443 347 Z M 388 329 L 405 376 L 435 391 L 429 405 L 382 402 L 366 345 Z"/>
+<path id="front-legs" fill="#409bde" d="M 298 290 Q 323 283 332 307 L 322 378 L 349 400 L 345 416 L 293 415 Q 283 409 290 390 L 291 330 Z M 265 288 L 281 312 L 265 378 L 280 393 L 270 408 L 231 405 L 243 371 Z"/>
+<path id="talons" fill="#e8f7ff" d="M 296 403 L 289 417 L 305 412 L 313 401 L 311 417 L 327 412 L 335 404 L 337 417 L 350 411 M 474 400 L 466 413 L 483 410 L 490 399 L 490 414 L 507 410 L 515 400 L 519 413 L 531 408 M 235 393 L 230 406 L 247 402 L 255 392 L 255 408 L 272 401"/>
+<path id="dorsal-fins" fill="#7ae6ff" d="M 330 249 L 341 224 L 356 258 L 374 238 L 386 269 L 409 251 L 421 276 L 445 260 L 457 289"/>
+</g>
+<g id="neck">
+<path id="neck-mass" fill="#358bd1" d="M 230 180 Q 281 156 310 193 Q 316 231 349 273 Q 305 315 263 281 Q 271 239 230 180 Z"/>
+<path id="neck-silver" fill="#d1e8f4" d="M 237 201 Q 259 214 274 233 Q 281 259 274 282 Q 295 297 314 284 Q 294 249 288 221 Z"/>
+</g>
+<g id="head">
+<path id="antenna-far" fill="none" stroke="#9eeeff" stroke-width="9" d="M 233 127 Q 225 82 263 46 L 283 22"/>
+<path id="antenna-near" fill="none" stroke="#d5f5ff" stroke-width="10" d="M 278 130 Q 286 74 332 55 L 366 33"/>
+<path id="ear-far" fill="#5dc8f5" d="M 216 146 L 166 106 L 185 161 L 165 172 L 218 179 Z"/>
+<path id="head-mass" fill="#469ee0" d="M 203 143 Q 217 112 263 116 Q 301 117 312 152 Q 324 189 295 217 Q 255 245 216 218 L 192 188 Z"/>
+<path id="ear-near" fill="#70d8fa" d="M 291 153 L 354 113 L 332 157 L 362 150 L 334 185 L 347 189 L 302 205 Z"/>
+<path id="ear-cut" fill="none" stroke="#2978bb" stroke-width="5" d="M 305 169 L 337 139 M 309 182 L 336 168"/>
+<path id="muzzle" fill="#9bd7ed" d="M 208 181 Q 187 177 178 190 Q 166 208 191 220 Q 229 238 266 218 L 270 204 Q 237 215 208 181 Z"/>
+<path id="nose" fill="#080d19" d="M 185 194 Q 195 186 202 194 Q 197 202 185 199 Z"/>
+<path id="smile" fill="none" stroke="#164668" stroke-width="5" d="M 185 211 Q 218 231 255 214"/>
+<path id="brow" fill="none" stroke="#a6edff" stroke-width="6" d="M 213 143 Q 230 130 245 143 M 259 140 Q 280 125 295 141"/>
+</g>
+<g id="eyes">
+<path id="far-eye-socket" fill="#080d19" d="M 210 154 Q 223 138 240 149 Q 253 164 243 184 Q 222 197 211 177 Z"/>
+<path id="far-eye-white" fill="#ffffff" d="M 216 156 Q 227 145 237 155 Q 246 166 238 179 Q 224 188 216 174 Z"/>
+<path id="far-pupil" fill="#080d19" d="M 225 166 C 225 157 234 157 234 166 C 234 175 225 175 225 166 Z"/>
+<path id="near-eye-socket" fill="#080d19" d="M 253 153 Q 272 134 293 149 Q 310 168 295 190 Q 271 204 254 183 Z"/>
+<path id="near-eye-white" fill="#ffffff" d="M 260 155 Q 275 142 289 154 Q 301 169 290 184 Q 274 194 261 179 Z"/>
+<path id="near-pupil" fill="#080d19" d="M 272 168 C 272 157 283 157 283 168 C 283 179 272 179 272 168 Z"/>
+</g>
+</svg>

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

@@ -0,0 +1,49 @@
+import {renderSvgRig} from '../../../factory/svg-rig.mjs';
+const pulse=(t,a,b)=>t<=a||t>=b?0:Math.sin(Math.PI*(t-a)/(b-a))**2;
+const ease=x=>{x=Math.max(0,Math.min(1,x));return x*x*(3-2*x);};
+export const CIPHER_CLIPS=[{id:'idle',title:'Listening',duration:12000},{id:'attach',title:'Link Up',duration:3200},{id:'inspect',title:'Following Traffic',duration:3600},{id:'trace',title:'Trace Route',duration:4800},{id:'delay',title:'Delayed Hop',duration:4800},{id:'broken',title:'Broken Link',duration:4800},{id:'restored',title:'Route Restored',duration:4800}];
+export const STORY=[['attach',3200],['idle',1600],['inspect',3600],['trace',4800],['delay',4800],['broken',4800],['restored',4800],['idle',2400]];
+export const STORY_DURATION=STORY.reduce((s,b)=>s+b[1],0);
+export function poseRig(rig,t,scene){
+ const cycle=t%12000,arrival=scene==='attach'&&t<3200;
+ const attention=arrival?pulse(t,0,2800):pulse(cycle,600,3400);
+ const fin=arrival?pulse(t,500,2900):pulse(cycle,2600,4300);
+ const tail=arrival?pulse(t,1000,3200):pulse(cycle,6200,10500);
+ const paths=rig.paths.map(p=>({...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>{
+  if(p.id.endsWith('-pupil'))x+=(scene==='inspect'?Math.sin(t/700):attention)*2;
+  if(p.group==='head'||p.group==='eyes'){x+=attention*3;y-=attention*3;if(p.id.startsWith('ear-'))y-=fin*4*ease((x-290)/65);if(p.id.startsWith('antenna-'))x+=fin*4*ease((130-y)/100);}
+  if(p.group==='neck'){const w=ease((290-y)/100);x+=attention*3*w;y-=attention*3*w;}
+  if(p.group==='wings'){const w=ease((300-y)/170);x-=fin*3*w;y+=fin*3*w;}
+  if(p.group==='tail'){const w=ease((x-490)/150);x-=tail*4*w;y+=tail*4*w*Math.sin((x-490)/70);}
+  return [x,y];
+ }))}));
+ const byId=new Map(paths.map(p=>[p.id,p]));
+ return {...rig,paths,bounds:{left:rig.bounds.left-7,top:rig.bounds.top-7,right:rig.bounds.right+7,bottom:rig.bounds.bottom+7},eyes:rig.eyes.map(e=>({...e,socket:byId.get(e.socket.id),white:byId.get(e.white.id),pupil:byId.get(e.pupil.id)}))};
+}
+function route(frame,t,scene,mono){
+ const cols=frame[0].length,rows=frame.length,y=1;
+ const nodes=[.53,.69,.85].map(f=>Math.round(f*(cols-1)));
+ let effectCells=0;
+ const put=(x,ch,rgb)=>{if(x<1||x>=cols-1||y>=rows-1||frame[y][x].ch!==' ')return;frame[y][x]={ch,rgb:mono?null:rgb,bg:null};effectCells++;};
+ const cyan=[103,226,255],amber=[255,194,76],red=[255,100,103];
+ const p=Math.min(1,t/4000),blocked=scene==='broken',delayed=scene==='delay';
+ nodes.forEach((x,i)=>put(x,'⠿',(i===1&&(blocked||delayed))?(blocked?red:amber):cyan));
+ for(let x=nodes[0];x<=nodes[2];x++){if(blocked&&x>nodes[1]&&x<nodes[1]+3)continue;put(x,'⠒',cyan);}
+ // Replace our route cells only; never overwrite original art.
+ const set=(x,ch,rgb)=>{if(x>=nodes[0]&&x<=nodes[2]&&['⠒','⠿'].includes(frame[y][x].ch))frame[y][x]={ch,rgb:mono?null:rgb,bg:null};};
+ let progress=p;if(delayed)progress=p<.3?p/.6:p<.7?.5:.5+(p-.7)/.6;if(blocked)progress=Math.min(.5,p);
+ const x=Math.round(nodes[0]+(nodes[2]-nodes[0])*Math.min(1,progress));
+ set(x,'⣿',blocked?red:delayed&&progress===.5?amber:[255,255,255]);
+ return effectCells;
+}
+export function renderCipher(rig,scene='idle',ms=0,options={}){
+ const clip=CIPHER_CLIPS.find(c=>c.id===scene);if(!clip)return {ok:false,code:'UNKNOWN_CLIP'};
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ const t=options.still?0:ms;
+ const idleT=scene==='attach'&&t>=3200?t-3200:t;
+ const posed=poseRig(rig,options.still?0:(options.motionTime??idleT),scene==='attach'&&t>=3200?'idle':scene);
+ const r=renderSvgRig(posed,options),power=['trace','delay','broken','restored'].includes(scene);
+ const effectCells=power?route(r.frame,options.still?2400:t,scene,options.mono):0;
+ return {...r,scene,clip:clip.title,caption:power?clip.title+' · simulated network state':'Listening to the network.',effectCells};
+}
+export function renderStory(rig,ms,options={}){let t=options.still?0:Math.min(ms,STORY_DURATION-1);for(const [scene,duration]of STORY){if(t<duration)return renderCipher(rig,scene,t,{...options});t-=duration;}}

package/vendor/dragonlab/design/cipher/v2/review.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import fs from 'node:fs/promises';
+import {parseSvgRig} from '../../../factory/svg-rig.mjs';
+import {renderCipher,CIPHER_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('Cipher V2 acting studio. --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(CIPHER_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','CIPHER\nOn guard.');
+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/cipher-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=renderCipher(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
+ console.log((large?[...cellsToAnsi(r.frame),...composeMessage(null,message,{terminalCols:w})]:composeMessage(r.frame,message,{terminalCols:w})).join('\n'));
+}

package/vendor/dragonlab/design/cipher/v2/watch.mjs

@@ -0,0 +1,56 @@
+import {performance} from 'node:perf_hooks';
+import {CIPHER_CLIPS,renderCipher,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?CIPHER_CLIPS.find(c=>c.id===scene):null;
+  const duration=(config.arrival&&options.deck?3200: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?renderCipher(paths,scene,t,options):renderStory(paths,t,options);
+    if(!r?.ok)throw new Error(r?.code??'Invalid story frame');
+    const caption=message??'CIPHER · '+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/drago/v1/character.mjs

@@ -0,0 +1,19 @@
+import {renderSvgRig} from '../../../factory/svg-rig.mjs';
+import {flattenPath} from '../../stage3/svg-coverage.js';
+export const DRAGO_CLIPS=Object.freeze(['idle','active']);
+const glare={
+ 'far-eye-white':'M 325 113 L 358 128 L 357 141 Q 336 138 325 124 Z',
+ 'near-eye-white':'M 382 128 L 424 111 L 422 126 Q 405 139 383 141 Z',
+ 'far-pupil':'M 341 128 C 341 122 348 122 348 128 C 348 134 341 134 341 128 Z',
+ 'near-pupil':'M 398 128 C 398 122 405 122 405 128 C 405 134 398 134 398 128 Z'
+};
+export function poseDrago(rig,scene='idle'){
+ if(!DRAGO_CLIPS.includes(scene))throw RangeError('Unknown Drago scene: '+scene);
+ const paths=rig.paths.map(p=>scene==='active'&&glare[p.id]?{...p,polygons:flattenPath(glare[p.id])}:p);
+ const byId=new Map(paths.map(p=>[p.id,p]));
+ return {...rig,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 renderDrago(rig,scene='idle',ms=0,options={}){
+ if(!Number.isFinite(ms)||ms<0)throw RangeError('Invalid time');
+ return {...renderSvgRig(poseDrago(rig,scene),options),scene,staticStudy:true,caption:'DRAGO\n'+(scene==='active'?'Active glare study.':'On guard.')};
+}

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

@@ -0,0 +1,56 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 480">
+<title>Drago — crimson engagement guardian, shield-bearing terminal master</title>
+<g id="wings">
+<path id="left-wing" fill="#922837" d="M 349 289 C 286 246 246 199 224 146 Q 208 115 183 103 C 197 184 158 282 109 365 Q 156 334 181 348 Q 218 308 246 340 Q 275 308 302 350 Z"/>
+<path id="left-wing-ribs" fill="none" stroke="#ef5350" stroke-width="8" d="M 349 289 Q 240 207 183 103 M 183 103 Q 201 242 109 365 M 204 178 Q 235 272 181 348 M 232 217 L 246 340"/>
+<path id="right-wing" fill="#6d2433" d="M 445 266 Q 520 206 566 108 Q 585 80 605 83 C 585 165 628 273 687 361 Q 647 333 623 349 Q 589 305 563 332 Q 529 301 501 347 Z"/>
+<path id="right-wing-ribs" fill="none" stroke="#d34243" stroke-width="9" d="M 445 266 Q 546 167 605 83 M 605 83 Q 583 203 687 361 M 584 153 Q 554 234 623 349 M 556 194 L 563 332"/>
+<path id="wing-claws" fill="#ffc28e" d="M 180 121 Q 162 93 192 86 L 183 103 Z M 593 100 Q 600 69 621 74 L 605 91 Z"/>
+</g>
+<g id="body">
+<path id="haunches" fill="#b53b43" d="M 346 250 C 293 266 267 326 278 380 Q 291 422 342 420 L 476 420 Q 536 416 543 372 C 544 311 493 259 450 242 Z"/>
+<path id="neck" fill="#c34143" d="M 348 146 C 335 205 327 243 310 294 Q 382 324 473 285 C 438 245 442 195 432 146 Z"/>
+<path id="throat" fill="#e9ac8a" d="M 361 166 Q 358 233 339 280 Q 388 307 435 278 Q 414 224 410 166 Z"/>
+<path id="throat-plates" fill="none" stroke="#79303b" stroke-width="6" d="M 359 199 Q 386 211 415 197 M 356 221 Q 387 235 420 221 M 350 245 Q 387 258 426 245 M 344 267 Q 388 281 433 267"/>
+<path id="spine" fill="#ff6048" d="M 433 156 L 473 160 L 447 180 L 485 197 L 448 206 L 481 230 L 451 232 L 491 262 L 464 260 L 510 287 L 481 288 Z"/>
+<path id="feet" fill="#bd4249" d="M 301 357 Q 278 379 244 398 Q 230 420 262 428 L 329 428 L 344 383 Z M 481 362 Q 518 375 548 407 Q 552 428 523 429 L 463 429 L 450 384 Z"/>
+<path id="foot-talons" fill="#f5c59d" d="M 251 410 L 243 430 L 267 422 L 278 409 L 274 431 L 295 421 L 306 409 L 307 430 L 326 421 M 477 410 L 467 431 L 489 423 L 500 411 L 500 433 L 520 423 L 531 414 L 535 431 L 548 424"/>
+</g>
+<g id="head">
+<path id="far-horn" fill="#f5b47f" d="M 343 107 C 309 93 296 63 290 27 Q 320 65 365 70 Z"/>
+<path id="near-horn" fill="#ffc18b" d="M 410 91 C 459 81 482 50 502 18 C 499 64 462 104 430 121 Z"/>
+<path id="skull" fill="#d84a49" d="M 323 112 Q 320 79 362 75 Q 412 65 437 101 L 444 145 Q 425 184 380 188 Q 329 183 312 149 Z"/>
+<path id="brow-armour" fill="#f06956" d="M 324 104 L 349 78 L 366 86 L 386 62 L 401 84 L 426 79 L 438 106 L 395 121 L 365 118 Z"/>
+<path id="cheek-blades" fill="#ff7458" d="M 434 119 L 478 100 L 453 132 L 480 134 L 447 152 L 461 168 L 425 169 Z M 321 119 L 294 105 L 303 132 L 288 137 L 315 153 Z"/>
+<path id="muzzle" fill="#e0715b" d="M 328 145 Q 357 135 379 150 Q 401 142 422 151 L 414 174 Q 379 196 332 178 L 313 164 Z"/>
+<path id="nose" fill="#080d19" d="M 329 153 L 341 151 L 336 158 Z M 400 153 L 411 151 L 404 159 Z"/>
+<path id="mouth" fill="none" stroke="#080d19" stroke-width="5" d="M 327 172 Q 370 184 414 168"/>
+<path id="fangs" fill="#fff0d4" d="M 337 176 L 346 193 L 350 179 Z M 398 176 L 402 188 L 409 172 Z"/>
+</g>
+<g id="shield">
+<path id="shield-outer" fill="#ff7058" d="M 386 260 Q 430 289 492 294 L 486 350 Q 471 401 390 440 Q 312 401 296 350 L 290 294 Q 347 290 386 260 Z"/>
+<path id="shield-dark" fill="#080d19" d="M 386 273 Q 435 301 478 303 L 473 348 Q 456 391 390 425 Q 327 391 309 348 L 304 303 Q 352 298 386 273 Z"/>
+<path id="shield-left" fill="#bd3841" d="M 385 285 L 385 411 Q 333 381 321 346 L 317 314 Q 355 307 385 285 Z"/>
+<path id="shield-right" fill="#842d3d" d="M 394 286 Q 431 309 466 314 L 461 345 Q 448 382 394 411 Z"/>
+<path id="shield-rune" fill="none" stroke="#ffc999" stroke-width="8" d="M 360 334 L 389 354 L 418 334 M 389 354 L 389 386"/>
+</g>
+<g id="hands">
+<path id="left-arm" fill="#d74b4a" d="M 315 264 Q 279 270 283 298 L 317 321 L 337 304 L 312 288 Z"/>
+<path id="right-arm" fill="#ba3c43" d="M 454 260 Q 501 265 501 296 L 464 320 L 442 305 L 475 286 Z"/>
+<path id="gripping-talons" fill="#ffe0b2" d="M 311 297 Q 322 286 333 301 L 330 321 L 323 305 L 318 323 Z M 329 297 Q 342 291 348 306 L 343 323 L 338 307 Z M 445 297 Q 457 290 462 303 L 456 324 L 451 308 Z M 464 297 Q 478 288 482 302 L 473 322 L 471 305 Z"/>
+</g>
+<g id="tail">
+<path id="tail-coil" fill="#aa3541" d="M 501 350 C 554 351 608 371 605 405 C 601 440 507 464 392 460 C 271 458 190 439 180 406 Q 169 376 199 359 Q 178 392 232 407 C 326 438 473 431 535 411 Q 564 393 502 384 Z"/>
+<path id="tail-rim" fill="none" stroke="#ed5a50" stroke-width="9" d="M 199 359 Q 178 392 232 407 C 326 438 473 431 535 411"/>
+<path id="tail-tip" fill="#ff815e" d="M 201 359 L 169 346 L 180 379 L 162 390 L 195 395 Q 181 376 201 359 Z"/>
+<path id="tail-scutes" fill="none" stroke="#752939" stroke-width="6" d="M 226 410 L 218 434 M 264 420 L 257 444 M 305 428 L 302 453 M 351 434 L 350 458 M 400 435 L 402 459 M 451 432 L 459 457 M 500 425 L 514 449 M 543 410 L 563 432"/>
+</g>
+<g id="eyes">
+<path id="far-eye-socket" fill="#080d19" d="M 321 111 Q 340 100 362 114 L 363 145 Q 336 154 320 134 Z"/>
+<path id="far-eye-white" fill="#ffffff" d="M 326 115 Q 342 109 357 118 L 357 139 Q 338 147 326 131 Z"/>
+<path id="far-pupil" fill="#080d19" d="M 338 127 C 338 117 348 117 348 127 C 348 137 338 137 338 127 Z"/>
+<path id="near-eye-socket" fill="#080d19" d="M 377 115 Q 405 99 429 109 L 429 135 Q 410 153 379 144 Z"/>
+<path id="near-eye-white" fill="#ffffff" d="M 383 119 Q 405 108 423 113 L 423 132 Q 407 146 383 139 Z"/>
+<path id="near-pupil" fill="#080d19" d="M 397 127 C 397 116 408 116 408 127 C 408 138 397 138 397 127 Z"/>
+</g>
+</svg>

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

@@ -0,0 +1,87 @@
+import {renderSvgRig} from '../../../factory/svg-rig.mjs';
+import {poseDrago} from '../v1/character.mjs';
+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;
+export const DRAGO_CLIPS=Object.freeze([
+ {id:'idle',title:'Keeping Watch',duration:14000},
+ {id:'attach',title:'The Guardian Arrives',duration:3800},
+ {id:'active',title:'Locked On',duration:3600},
+ {id:'inspect',title:'Closer Inspection',duration:3800},
+ {id:'guard',title:'Hold the Line',duration:4200,power:true},
+ {id:'concerned',title:'Needs Attention',duration:3200},
+ {id:'acknowledge',title:'Understood',duration:2800},
+ {id:'standby',title:'Awaiting You',duration:3200}
+]);
+export const STORY=[['attach',3800],['idle',2400],['inspect',3800],['active',3600],['guard',4200],['concerned',3200],['acknowledge',2800],['standby',3200],['idle',2500]];
+export const STORY_DURATION=STORY.reduce((n,b)=>n+b[1],0);
+const captions={idle:'On guard.',attach:'At your side.',active:'Active expression study.',inspect:'Inspection expression study.',guard:'Shield-forward visual study.',concerned:'Concern expression study.',acknowledge:'Acknowledgement expression study.',standby:'Waiting expression study.'};
+export function bodyPose(ms){const t=ms%14000;return {
+ breath:1.8*pulse(t,500,6500),wing:.025*pulse(t,3000,6500),far:.019*pulse(t,3500,7000),tail:1.1*pulse(t,7500,12000),
+ turn:.009*pulse(t,900,3800),nod:1.8*pulse(t,900,3800),shield:0,grip:0,gaze:0,glare:false,eye:1
+};}
+function performance(scene,ms,options){
+ const t=options.still?0:ms;
+ let pose=bodyPose(options.still?0:(options.motionTime??t));
+ if(scene==='attach'){
+  const duration=options.deck?4800:3800;
+  if(t>=duration)return bodyPose(t-duration);
+  const u=t/duration;
+  pose={...bodyPose(0),gaze:.6*pulse(u,0,.55),turn:-.015*pulse(u,.1,.7),nod:5*pulse(u,.32,.9),
+   wing:.06*pulse(u,.16,.8),far:.045*pulse(u,.23,.88),shield:.65*pulse(u,.3,.86),grip:pulse(u,.3,.86),tail:pulse(u,.45,1),glare:u>.32&&u<.67};
+ }
+ if(scene==='active')pose={...pose,glare:true,nod:pose.nod+3,grip:.7,gaze:.2};
+ if(scene==='inspect')pose={...pose,gaze:.8*Math.sin(t/1100),turn:pose.turn+.018*Math.sin(t/1100),nod:pose.nod+1};
+ if(scene==='guard'){const p=options.still?1:pulse(t,0,4200);pose={...pose,glare:true,shield:p,grip:p,wing:pose.wing+.045*p,far:pose.far+.035*p,nod:pose.nod+5*p};}
+ if(scene==='concerned')pose={...pose,turn:pose.turn-.022,nod:pose.nod+2,gaze:-.5,eye:1.08};
+ if(scene==='acknowledge')pose={...pose,nod:pose.nod+6*pulse(t,300,2100),eye:1.05};
+ if(scene==='standby')pose={...pose,gaze:-.65,turn:pose.turn-.012,eye:.9};
+ if(options.still)pose={...pose,breath:0,wing:0,far:0,tail:0,nod:0,turn:0,gaze:0};
+ return pose;
+}
+const rotate=(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,pose){
+ const source=poseDrago(rig,pose.glare?'active':'idle');
+ const paths=source.paths.map(p=>({...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>{
+  if(p.id.endsWith('-eye-white')||p.id.endsWith('-pupil')){
+   y=127+(y-127)*pose.eye;
+   if(p.id.endsWith('-pupil'))x+=pose.gaze*3;
+  }
+  if(p.group==='head'||p.group==='eyes'){
+   const v=rotate(x,y,385,190,pose.turn);return [v[0],v[1]+pose.nod-pose.breath];
+  }
+  if(['neck','throat','throat-plates','spine'].includes(p.id)){
+   const w=ease((290-y)/100),v=rotate(x,y,385,190,pose.turn*w);return [v[0],v[1]+(pose.nod-pose.breath)*w];
+  }
+  if(p.group==='wings'){
+   const right=x>400,a=right?-pose.far:pose.wing;return rotate(x,y,right?455:335,290,a);
+  }
+  if(p.group==='tail'){
+   // Pin the upper-right attachment. Distal coil gathers inward with a small settling recoil.
+   const w=ease((y-360)/55)*ease((610-x)/160),recoil=pose.tail-.24*pose.tail*pose.tail;
+   return [x+(390-x)*.025*w*recoil,y-5*w*recoil];
+  }
+  if(p.group==='shield')return [390+(x-390)*(1+.06*pose.shield),350+(y-350)*(1+.06*pose.shield)-9*pose.shield-pose.breath*.3];
+  if(p.group==='hands'){
+   const w=ease((y-270)/40);return [x+(x<390?2:-2)*pose.grip*w+(x-390)*.06*pose.shield*w,y-(9*pose.shield+pose.breath*.3)*w];
+  }
+  return [x,y];
+ }))}));
+ const byId=new Map(paths.map(p=>[p.id,p]));
+ return {...source,paths,bounds:{left:rig.bounds.left-10,top:rig.bounds.top-10,right:rig.bounds.right+10,bottom:rig.bounds.bottom+6},
+ eyes:source.eyes.map(e=>({...e,socket:byId.get(e.socket.id),white:byId.get(e.white.id),pupil:byId.get(e.pupil.id)}))};
+}
+export function renderDrago(rig,scene='idle',ms=0,options={}){
+ const clip=DRAGO_CLIPS.find(c=>c.id===scene);
+ if(!clip)return {ok:false,code:'UNKNOWN_CLIP'};
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ const pose=performance(scene,ms,options),posed=poseRig(rig,pose),r=renderSvgRig(posed,options);
+ // A local shield glow, never a claim about security posture or real authorisation.
+ if(scene==='guard'&&!options.mono){const brightness=options.still?.9:pulse(ms,0,4200);for(const row of r.frame)for(const cell of row)if(cell.rgb&&cell.rgb[0]===255&&cell.rgb[1]===112){cell.rgb=[255,Math.round(112+70*brightness),Math.round(88+50*brightness)];}}
+ return {...r,scene,clip:clip.title,caption:captions[scene],pose,staticStudy:false};
+}
+export function renderStory(rig,ms,options={}){
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ let t=options.still?0:Math.min(ms,STORY_DURATION-1);
+ for(const [scene,duration]of STORY){if(t<duration)return renderDrago(rig,scene,t,{...options,deck:false,motionTime:Math.max(0,ms-3800)});t-=duration;}
+}

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

@@ -0,0 +1,67 @@
+import {turnHead} from './profile.mjs';
+import {renderDrago as renderV2,poseRig,bodyPose,DRAGO_CLIPS as V2_CLIPS} from '../v2/character.mjs';
+import {renderSvgRig} from '../../../factory/svg-rig.mjs';
+import {flattenPath} from '../../stage3/svg-coverage.js';
+const clamp=x=>Math.max(0,Math.min(1,x));
+const ease=x=>{x=clamp(x);return x*x*(3-2*x);};
+const envelope=(t,a,b,c,d)=>ease((t-a)/(b-a))*(1-ease((t-c)/(d-c)));
+export const FIRE_DURATION=6800;
+export const DRAGO_CLIPS=Object.freeze([...V2_CLIPS,{id:'fire',title:'Scoped Inferno',duration:FIRE_DURATION,power:true}]);
+export const STORY=[['attach',3800],['idle',1400],['fire',FIRE_DURATION],['idle',2400]];
+export const STORY_DURATION=STORY.reduce((n,b)=>n+b[1],0);
+const path=(id,d,rgb,stroke=0)=>({id,group:'fire-effect',polygons:flattenPath(d),rgb,stroke,erase:rgb.every((v,i)=>v===[8,13,25][i])});
+const point=([x,y])=>`${x.toFixed(3)} ${y.toFixed(3)}`;
+export function fireRig(rig,ms,options={}){
+ const t=options.still?3000:ms;
+ const aim=envelope(t,0,900,5600,FIRE_DURATION),blast=envelope(t,1200,1700,4300,4800),embers=envelope(t,4400,4700,5200,5600);
+ const pose={...bodyPose(0),glare:aim>.2,grip:aim,shield:.25*aim,nod:2*aim,gaze:.5*aim,turn:.018*aim,wing:.012*aim,far:0};
+ const posed=poseRig(rig,pose);
+ // Lower the right sail so the line of fire clears its claw and membrane.
+ let paths=posed.paths.map(p=>({...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>p.group==='wings'&&x>400?[x,y+28*aim*ease((300-y)/160)]:[x,y]))}));
+ const turn=ease(Math.max(0,Math.min(1,(t-180)/720)))*(1-ease((t-5600)/1200));
+ paths=turnHead(paths,turn);
+ const mouth=[419+(502-419)*turn,169+(124-169)*turn],target=[650,57],dx=target[0]-mouth[0],dy=target[1]-mouth[1],length=Math.hypot(dx,dy),normal=[-dy/length,dx/length];
+ if(aim>.02){
+  // A visible target box describes the animation's scope; it is not an approval badge.
+  const c=blast>.1?[255,116,56]:[210,148,92];
+  paths.push(path('scope-brackets','M 634 24 L 619 24 L 619 39 M 665 24 L 681 24 L 681 39 M 619 75 L 619 91 L 635 91 M 665 91 L 681 91 L 681 75',c,5));
+  paths.push(path('scope-target','M 650 44 L 663 57 L 650 70 L 637 57 Z',[255,185,94],3));
+ }
+ if(blast>.01){
+  const reach=ease((t-1200)/500),tip=[mouth[0]+dx*reach,mouth[1]+dy*reach];
+  const flame=(id,width,rgb,phase)=>{
+   const sides=[[],[]];
+   for(let i=0;i<=24;i++){
+    const u=i/24,x=mouth[0]+(tip[0]-mouth[0])*u,y=mouth[1]+(tip[1]-mouth[1])*u;
+    const rip=.70+.30*Math.sin(u*33-t*.025+phase),w=(2+width*Math.sin(Math.PI*u*.76))*blast*rip;
+    for(let side=0;side<2;side++){const s=side?1:-1;sides[side].push([x+normal[0]*w*s,y+normal[1]*w*s]);}
+   }
+   paths.push(path(id,'M '+[...sides[0],...sides[1].reverse()].map(point).join(' L ')+' Z',rgb));
+  };
+  flame('fire-outer',20,[235,48,30],0);flame('fire-orange',13,[255,116,30],.5);flame('fire-gold',7,[255,211,70],1);flame('fire-core',2.5,[255,249,215],1.4);
+  if(reach>.95){
+   // Impact burst remains wholly within the target's fixed box.
+   const ring=[];for(let j=0;j<20;j++){const a=j*Math.PI/10,r=(j%2?9:19+4*Math.sin(t*.03+j))*blast;ring.push([650+Math.cos(a)*r,57+Math.sin(a)*r]);}
+   paths.push(path('fire-impact','M '+ring.map(point).join(' L ')+' Z',[255,176,45]));
+   paths.push(path('fire-impact-core','M 650 48 L 658 57 L 650 66 L 642 57 Z',[255,249,215]));
+  }
+ }
+ if(embers>.01)for(let i=0;i<7;i++){
+  const age=clamp((t-4400)/1200),x=632+i*5,y=45+((i*13)%22)+age*10;
+  paths.push(path('fire-ember-'+i,`M ${x} ${y} L ${x+2} ${y} L ${x+2} ${y+3} L ${x} ${y+3} Z`,[255,Math.round(110+80*embers),35]));
+ }
+ const byId=new Map(paths.map(p=>[p.id,p]));
+ return {rig:{...posed,paths,eyes:posed.eyes.filter(e=>turn<.95||e.name!=='far').map(e=>({...e,socket:byId.get(e.socket.id),white:byId.get(e.white.id),pupil:byId.get(e.pupil.id)}))},pose,phase:t<1200?'Aim':t<4800?'Directed fire':t<5600?'Embers':'Settle',blast,aim,mouth,target};
+}
+export function renderDrago(rig,scene='idle',ms=0,options={}){
+ if(scene!=='fire')return renderV2(rig,scene,ms,options);
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ if(!options.still&&ms>=FIRE_DURATION)return renderV2(rig,'idle',ms-FIRE_DURATION,options);
+ const f=fireRig(rig,ms,options),r=renderSvgRig(f.rig,options);
+ return {...r,scene,clip:'Scoped Inferno',caption:`${f.phase} · visual rehearsal`,pose:f.pose,phase:f.phase,blast:f.blast,mouth:f.mouth,target:f.target,staticStudy:false};
+}
+export function renderStory(rig,ms,options={}){
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ let t=options.still?0:Math.min(ms,STORY_DURATION-1);
+ for(const [scene,duration]of STORY){if(t<duration)return renderDrago(rig,scene,t,{...options,deck:false,motionTime:Math.max(0,ms-3800)});t-=duration;}
+}

package/vendor/dragonlab/design/drago/v4/profile.mjs

@@ -0,0 +1,35 @@
+import {flattenPath} from '../../stage3/svg-coverage.js';
+// Authored right-facing head: swept-back horns, one visible eye, elongated muzzle and open jaw.
+const shapes={
+ 'far-horn':'M 380 101 Q 330 87 313 51 Q 353 77 405 77 Z',
+ 'near-horn':'M 403 92 Q 362 59 346 23 Q 391 59 435 72 Z',
+ 'skull':'M 365 123 Q 356 91 398 84 Q 434 78 456 99 L 486 98 L 505 110 L 500 120 L 446 139 Q 422 171 383 167 Z',
+ 'brow-armour':'M 376 100 L 393 79 L 413 84 L 430 71 L 448 95 L 430 109 Z',
+ 'cheek-blades':'M 386 118 L 344 105 L 362 131 L 339 142 L 376 152 L 357 173 L 400 161 Z',
+ 'muzzle':'M 427 120 L 491 99 L 506 109 L 502 118 L 443 139 Z M 402 145 L 443 145 L 493 130 L 503 137 Q 458 164 420 170 L 393 159 Z',
+ 'nose':'M 483 107 L 496 106 L 492 113 L 484 114 Z',
+ 'mouth-line':'M 425 144 L 500 119',
+ 'mouth':'M 425 144 L 500 119',
+ 'fangs':'M 465 129 L 474 140 L 477 125 Z M 487 120 L 493 132 L 498 117 Z',
+ 'near-eye-socket':'M 397 110 L 439 103 L 440 126 Q 421 143 400 131 Z',
+ 'near-eye-white':'M 403 115 L 434 109 L 434 124 Q 422 135 405 128 Z',
+ 'near-pupil':'M 422 121 C 422 112 430 112 430 121 C 430 130 422 130 422 121 Z'
+};
+function samples(polys,n=72){
+ const p=polys[0],edges=p.map((v,i)=>{const q=p[(i+1)%p.length];return Math.hypot(q[0]-v[0],q[1]-v[1]);}),total=edges.reduce((a,b)=>a+b,0);
+ return Array.from({length:n},(_,i)=>{let s=i*total/n,j=0;while(j<edges.length-1&&s>edges[j])s-=edges[j++];const a=p[j],b=p[(j+1)%p.length],f=edges[j]?s/edges[j]:0;return [a[0]+(b[0]-a[0])*f,a[1]+(b[1]-a[1])*f];});
+}
+export function turnHead(paths,amount){
+ return paths.map(p=>{
+  if(p.group!=='head'&&p.group!=='eyes'&&!['neck','throat','throat-plates','spine'].includes(p.id))return p;
+  if(p.group!=='head'&&p.group!=='eyes')return {...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>[x+22*amount*Math.max(0,Math.min(1,(290-y)/110)),y]))};
+  if(p.id.startsWith('far-eye')||p.id==='far-pupil'){
+   return {...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>[390+(x-390)*(1-amount),122+(y-122)*(1-amount)]))};
+  }
+  const d=shapes[p.id];if(!d)return p;
+  const target=flattenPath(d);if(amount>=.999)return {...p,polygons:target};
+  if(amount<=0)return p;
+  const a=samples(p.polygons),b=samples(target);
+  return {...p,polygons:[a.map(([x,y],i)=>[x+(b[i][0]-x)*amount,y+(b[i][1]-y)*amount])]};
+ });
+}

package/vendor/dragonlab/design/drago/v4/review.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import fs from 'node:fs/promises';
+import {parseSvgRig} from '../../../factory/svg-rig.mjs';
+import {renderDrago,DRAGO_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('Drago V4 scoped fire studio. --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(DRAGO_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','DRAGO\nOn guard.');
+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/drago-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=renderDrago(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
+ console.log((large?[...cellsToAnsi(r.frame),...composeMessage(null,message,{terminalCols:w})]:composeMessage(r.frame,message,{terminalCols:w})).join('\n'));
+}

package/vendor/dragonlab/design/drago/v4/watch.mjs

@@ -0,0 +1,56 @@
+import {performance} from 'node:perf_hooks';
+import {DRAGO_CLIPS,renderDrago,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?DRAGO_CLIPS.find(c=>c.id===scene):null;
+  const duration=(config.arrival&&options.deck?4800: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?renderDrago(paths,scene,t,options):renderStory(paths,t,options);
+    if(!r?.ok)throw new Error(r?.code??'Invalid story frame');
+    const caption=message??'DRAGO · '+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;}
+}