rig-review 2.13.0 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/README.md +1 -1
  2. package/docs/PARTS_VIEW.md +1 -1
  3. package/docs/REVIEW_PACKAGE.md +32 -91
  4. package/docs/STABILITY.md +27 -194
  5. package/docs/WORKFLOWS.md +0 -107
  6. package/package.json +1 -1
  7. package/skills/rig-review/SKILL.md +11 -25
  8. package/src/build.ts +2 -2
  9. package/src/direction-inspection.ts +6 -2
  10. package/src/front.ts +4 -193
  11. package/src/interview-scene.ts +3 -3
  12. package/src/job-act.ts +1 -35
  13. package/src/job-api.ts +27 -19
  14. package/src/job-cli.ts +3 -3
  15. package/src/job-contract.ts +14 -50
  16. package/src/job-front.ts +17 -44
  17. package/src/job-host.ts +1 -4
  18. package/src/job-session.ts +22 -10
  19. package/src/job-source.ts +3 -17
  20. package/src/job-store.ts +80 -6
  21. package/src/job-worker.ts +1 -47
  22. package/src/manifest.ts +23 -4
  23. package/src/open.ts +2 -3
  24. package/src/scene-inspection.ts +50 -0
  25. package/src/server.ts +1 -1
  26. package/web/catalog-en.ts +37 -27
  27. package/web/catalog-ko.ts +37 -27
  28. package/web/compare.css +0 -4
  29. package/web/direction-panel.ts +22 -6
  30. package/web/inspector-blocks.ts +8 -4
  31. package/web/job-rig-capture.ts +62 -12
  32. package/web/job-rig-screen.ts +75 -55
  33. package/web/job-session.ts +89 -1091
  34. package/web/main.ts +113 -56
  35. package/web/parts-viewport-provider.ts +8 -3
  36. package/web/retained-frame-stage.ts +7 -7
  37. package/web/rig-host.ts +5 -3
  38. package/web/rig-viewport-provider.ts +2 -0
  39. package/web/scene-plates.ts +57 -4
  40. package/web/styles.css +12 -82
  41. package/web/viewport-capture.ts +12 -2
  42. package/web/workspace-ui.ts +5 -6
  43. package/src/front-worker.ts +0 -2
  44. package/src/job-hub.ts +0 -304
  45. package/src/job-image-set.ts +0 -73
  46. package/web/job-hub.ts +0 -160
@@ -13,6 +13,7 @@ export interface RigViewportHost {
13
13
  /** Additional compiled panes share the renderer while retaining their declared framing basis. */
14
14
  panes?:{target:CameraTarget;viewport:HTMLElement;pane:HTMLElement;root:HTMLElement;fallback?:CameraTarget;
15
15
  box:()=>PoseBounds|null;player:()=>RigPlayer|null;scale:(value:number)=>void}[];
16
+ framingBox?:()=>PoseBounds|null;
16
17
  rigMargins?:{x:number;y:number};
17
18
  referenceTransform?:{content:HTMLElement;mode:'relative'};
18
19
  layoutKey?:ViewportProvider['layoutKey'];
@@ -35,6 +36,7 @@ export function createRigViewportProvider(host:RigViewportHost,state:ViewportSta
35
36
  }
36
37
  function rigFramingBox():PoseBounds|null {
37
38
  const player=host.player(),assets=host.assets();if(!player)return null;
39
+ const authored=host.framingBox?.();if(authored)return authored;
38
40
  const declared=assets?.stage;
39
41
  // A model without a positive declared stage keeps its existing live pose/filter basis.
40
42
  if(!positiveBounds(declared))return player.bounds();
@@ -1,3 +1,8 @@
1
+ import {loadViewportImage} from './parts-viewport-provider.ts';
2
+ import {t} from './i18n.ts';
3
+ import {CanvasRenderer,type RigPlayer} from '@rig-c/play';
4
+ import type {SceneInspection,SceneBox} from '../src/scene-inspection.ts';
5
+ import type {DirectionInspection} from '../src/direction-inspection.ts';
1
6
  type Rect = Readonly<{ x: number; y: number; width: number; height: number }>;
2
7
 
3
8
  type Plate = Readonly<{
@@ -10,7 +15,7 @@ type Plate = Readonly<{
10
15
  type Frame = Readonly<{
11
16
  clip: Rect;
12
17
  background: Plate | null;
13
- foreground: Plate | null;
18
+ foreground: Plate | null | undefined;
14
19
  rigTransform: readonly [number, number, number, number, number, number];
15
20
  drawRig: (ctx: CanvasRenderingContext2D) => void;
16
21
  }>;
@@ -48,7 +53,7 @@ export function renderScenePlates(ctx: CanvasRenderingContext2D, frame: Frame):
48
53
  const { background, foreground, clip, rigTransform, drawRig } = frame;
49
54
  // Complete validation precedes every canvas operation, including clearing the held frame.
50
55
  validatePlate(background, 'background');
51
- validatePlate(foreground, 'foreground');
56
+ if(foreground!==undefined)validatePlate(foreground, 'foreground');
52
57
  validateRect(clip, 'clip');
53
58
  if (!rigTransform || rigTransform.length !== 6 || !Array.from(rigTransform).every(Number.isFinite)) {
54
59
  throw new Error('SCENE_TRANSFORM_INVALID');
@@ -86,10 +91,58 @@ export function renderScenePlates(ctx: CanvasRenderingContext2D, frame: Frame):
86
91
  ctx.restore();
87
92
  }
88
93
 
89
- const front = foreground.rect;
94
+ if(foreground){const front = foreground.rect;
90
95
  ctx.drawImage(foreground.image, 0, 0, foreground.width, foreground.height,
91
- front.x, front.y, front.width, front.height);
96
+ front.x, front.y, front.width, front.height);}
92
97
  } finally {
93
98
  ctx.restore();
94
99
  }
95
100
  }
101
+
102
+ /** One interpolation policy for the authored camera and rig timing; a key owns the interval after it. */
103
+ export function takeSample(direction:DirectionInspection,time:number):{box:SceneBox;sourceTime:number}{
104
+ const at=Math.min(direction.take.duration,Math.max(0,time));
105
+ function sample<T extends {time:number;easing:string}>(keys:T[]):{a:T;b:T;mix:number}{
106
+ const index=keys.findIndex(key=>key.time>at),a=keys[index<0?keys.length-1:Math.max(0,index-1)]!,b=index<0?a:keys[index]!;
107
+ let mix=b.time===a.time?0:(at-a.time)/(b.time-a.time);
108
+ if(a.easing==='hold')mix=0;else if(a.easing==='smoothstep')mix=mix*mix*(3-2*mix);
109
+ return {a,b,mix};
110
+ }
111
+ const camera=sample(direction.camera.keys),timing=sample(direction.timing),box={...camera.a.box};
112
+ for(const key of ['x','y','width','height'] as const)box[key]+=(camera.b.box[key]-box[key])*camera.mix;
113
+ return {box,sourceTime:timing.a.source_time+(timing.b.source_time-timing.a.source_time)*timing.mix};
114
+ }
115
+ /** Load only the byte identities already validated by the package reader; never follow a scene URL. */
116
+ export async function loadScenePlates(scene:SceneInspection,url:(path:string)=>string):Promise<Map<string,HTMLImageElement>>{
117
+ const images=new Map<string,HTMLImageElement>();
118
+ for(const plate of scene.plates){
119
+ const response=await fetch(url(plate.path));if(!response.ok)throw new Error(t('scene.required',[plate.path]));
120
+ const bytes=await response.clone().arrayBuffer(),digest=await crypto.subtle.digest('SHA-256',bytes);
121
+ if(Array.from(new Uint8Array(digest),v=>v.toString(16).padStart(2,'0')).join('')!==plate.sha256)throw new Error(t('scene.plateChanged',[plate.path]));
122
+ let image:HTMLImageElement;
123
+ try{image=await loadViewportImage(response);}catch{throw new Error(t('scene.plateDimensions',[plate.path]));}
124
+ if(image.naturalWidth!==plate.width||image.naturalHeight!==plate.height)throw new Error(t('scene.plateDimensions',[plate.path]));
125
+ images.set(plate.path,image);
126
+ }
127
+ return images;
128
+ }
129
+ /** Scratch buffers only: the player's existing canvas remains the sole displayed image and comment surface. */
130
+ export function bindScenePlates(scene:SceneInspection,images:Map<string,HTMLImageElement>){
131
+ const rig=document.createElement('canvas'),scratch=document.createElement('canvas');let last:CanvasRenderer|null=null;
132
+ return {draw(player:RigPlayer,box:SceneBox){
133
+ const renderer=player.renderer;if(!(renderer instanceof CanvasRenderer))throw new Error(t('scene.canvasRequired'));
134
+ const canvas=renderer.canvas,width=canvas.width,height=canvas.height;
135
+ if(!width||!height)return;
136
+ if(last!==renderer||!renderer.framesReused||rig.width!==width||rig.height!==height){
137
+ rig.width=width;rig.height=height;rig.getContext('2d')!.drawImage(canvas,0,0);last=renderer;
138
+ }
139
+ scratch.width=width;scratch.height=height;
140
+ const raster={x:Math.floor(box.x),y:Math.floor(box.y),width:Math.ceil(box.x+box.width)-Math.floor(box.x),height:Math.ceil(box.y+box.height)-Math.floor(box.y)};
141
+ // CanvasRenderer rounds backing dimensions up, but projects world units with its pixel ratio.
142
+ const sx=renderer.pixelRatio,sy=renderer.pixelRatio;
143
+ const plate=(role:'background'|'foreground')=>{const p=scene.plates.find(p=>p.role===role);return p?{...p,image:images.get(p.path)??null,
144
+ rect:{x:(p.rect.x-raster.x)*sx,y:(raster.y+raster.height-p.rect.y-p.rect.height)*sy,width:p.rect.width*sx,height:p.rect.height*sy}}:undefined;};
145
+ renderScenePlates(scratch.getContext('2d')!,{clip:{x:(box.x-raster.x)*sx,y:(raster.y+raster.height-box.y-box.height)*sy,width:box.width*sx,height:box.height*sy},background:plate('background')??null,foreground:plate('foreground'),rigTransform:[1,0,0,1,0,0],drawRig:ctx=>ctx.drawImage(rig,0,0)});
146
+ const ctx=canvas.getContext('2d')!;ctx.clearRect(0,0,width,height);ctx.drawImage(scratch,0,0);
147
+ }};
148
+ }
package/web/styles.css CHANGED
@@ -454,74 +454,6 @@ main{position:relative}.toolbar{anchor-name:--stage-comment-bar}#stage-comment{w
454
454
  }
455
455
 
456
456
  /* Persistent job inspection uses the canonical pair and camera controls. */
457
- body.job-window{display:grid;grid-template-rows:auto auto minmax(0,1fr);height:100dvh;overflow:hidden}
458
- .job-window .job-header{display:flex;align-items:center;gap:12px;padding:10px 16px;background:var(--rv-bar);border-bottom:1px solid var(--border)}
459
- .job-window .job-header h1{font-size:16px;margin:0;flex:1;min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
460
- .job-window .job-header select{width:auto;flex:0 0 auto;max-width:12rem}
461
- .job-window .job-notice{padding:8px 16px;margin:0;color:var(--fg-soft);background:var(--rv-panel);border-bottom:1px solid var(--border)}
462
- .job-window .job-notice[data-failed=true]{color:var(--fail)}
463
- .job-window .job-inspection{display:grid;flex:1;grid-template-columns:230px minmax(0,1fr);grid-template-rows:250px minmax(0,1fr);min-height:0;overflow:hidden}
464
- .job-window .job-sidebar{grid-row:1/-1;overflow:auto;padding:12px;border-right:1px solid var(--border);background:var(--rv-panel);min-width:0}
465
- .job-window .job-sidebar select,.job-window .job-sidebar img{max-width:100%}
466
- .job-window .job-stage{display:flex;flex-direction:column;min-height:0;min-width:0;overflow:hidden}
467
- .job-window .job-stage #stage-layout{height:auto;flex:1;min-height:0}
468
- .job-window .job-stage .viewbar,.job-window .job-transport{flex:none;display:flex;gap:8px;align-items:center;flex-wrap:wrap;padding:8px}
469
- .job-window .job-inspection .job-stage:has(>#stage-layout:not([hidden])) #stage-layout{min-height:max(60%,150px)}
470
- .job-window .job-inspection .job-stage:has(>#stage-layout:not([hidden]))>:is(.viewbar,.job-transport){height:48px;flex-wrap:nowrap;padding:2px 8px;overflow-x:auto;overflow-y:hidden;white-space:nowrap}
471
- .job-window .job-inspection .job-stage:has(>#stage-layout:not([hidden]))>:is(.viewbar,.job-transport)>*{flex:none}
472
- .job-window .job-inspection .job-stage:has(>#stage-layout:not([hidden]))>:is(.viewbar,.job-transport)>label{display:flex;align-items:center;gap:4px}
473
- .job-window .job-inspection .job-stage:has(>#stage-layout:not([hidden]))>.job-transport>select{width:auto}
474
- .job-window .job-inspection .job-stage:has(>#stage-layout:not([hidden]))>.job-transport input[type=number]{width:8rem}
475
- .job-window .job-forms{overflow:auto;border-top:1px solid var(--border);padding:12px;background:var(--rv-panel)}
476
- .job-window .job-forms form{margin:0 0 12px;padding:12px;border:1px solid var(--border);border-radius:var(--radius)}
477
- .job-window .job-forms fieldset{border:0;padding:0;min-width:0}
478
- .job-window .job-forms label{display:block;margin:6px 0}
479
- .job-window .job-forms textarea{display:block;width:100%;min-height:64px;box-sizing:border-box}
480
- .job-window .job-forms .job-source,.job-window .job-history{overflow-wrap:anywhere;font-family:var(--font-mono);font-size:11px;color:var(--fg-muted)}
481
- .job-window .job-history{white-space:pre-wrap;color:var(--warn)}
482
- .job-window .job-direction{white-space:pre-wrap;overflow-wrap:anywhere}
483
- @media(max-width:780px){.job-window .job-inspection{grid-template-columns:160px minmax(0,1fr)}.job-window .job-stage #stage-layout{grid-template-columns:minmax(0,1fr);grid-template-rows:repeat(2,minmax(0,1fr))}}
484
-
485
-
486
- .job-window #rig-viewport[data-job-rig-canonical] > #rig-root {
487
- visibility: hidden;
488
- }
489
- .job-window #rig-viewport > .job-rig-presentation {
490
- position: absolute;
491
- z-index: 0;
492
- visibility: visible;
493
- pointer-events: none;
494
- user-select: none;
495
- transform: none;
496
- opacity: 1;
497
- }
498
-
499
- .job-window [data-job-checkpoint-evidence]{min-width:0;margin:12px 0}
500
- /* The shared gallery supplies inline column flow; checkpoint tiles wrap inside the existing form. */
501
- .job-window [data-job-checkpoint-evidence]>section{grid-auto-flow:row!important;grid-template-columns:repeat(auto-fit,minmax(180px,1fr))}
502
- .job-window [data-job-checkpoint-evidence] table{border-collapse:collapse;width:100%}
503
- .job-window [data-job-checkpoint-evidence] th,.job-window [data-job-checkpoint-evidence] td{padding:6px 10px;border:1px solid var(--border);text-align:left;white-space:pre-wrap;overflow-wrap:anywhere}
504
- .job-window [data-job-checkpoint-evidence] caption{text-align:left;margin-bottom:8px}
505
- .job-window [data-job-checkpoint-evidence] pre{white-space:pre-wrap;overflow-wrap:anywhere}
506
-
507
- .job-window .job-plan-text{min-width:0;overflow-wrap:anywhere}
508
- .job-window .job-plan-steps{padding-left:1.4rem;margin:8px 0}
509
- .job-window .job-plan-steps>li{margin:8px 0}
510
- .job-window .job-plan-steps summary{cursor:pointer;font-weight:600;overflow-wrap:anywhere}
511
- .job-window .job-plan-steps code{display:block;overflow-wrap:anywhere}
512
- .job-window .job-plan-steps dl{margin:8px 0}
513
- .job-window .job-plan-steps dt{font-weight:600;margin-top:8px}
514
- .job-window .job-plan-steps dd{margin:2px 0 8px;white-space:pre-wrap;overflow-wrap:anywhere}
515
- .job-window .job-plan-steps dd ul{padding-left:1.2rem;margin:0}
516
-
517
- .job-window .job-inspection[data-job-plan-workspace]{grid-template-columns:minmax(0,1fr) minmax(0,1fr);grid-template-rows:minmax(0,1fr)}
518
- .job-window .job-inspection[data-job-plan-workspace]>.job-sidebar{display:none}
519
- .job-window .job-inspection[data-job-plan-workspace]>.job-stage{grid-column:1;grid-row:1;min-width:0;overflow:auto;padding:12px}
520
- .job-window .job-inspection[data-job-plan-workspace]>.job-forms{grid-column:2;grid-row:1;min-width:0;min-height:0;border-top:0;border-left:1px solid var(--border)}
521
-
522
- .job-window .job-inspection[data-job-plan-workspace]>.job-stage .job-source,
523
- .job-window .job-inspection[data-job-plan-workspace]>.job-stage pre{min-width:0;white-space:pre-wrap;overflow-wrap:anywhere}
524
-
525
457
  /* Step 1 rig composition: primary camera/comment actions and auxiliary tools have distinct regions. */
526
458
  .workspace-main-toolbar{display:flex;align-items:center;justify-content:space-between;gap:8px;flex-wrap:wrap;padding:8px 12px;border-bottom:1px solid var(--border-strong);background:var(--rv-panel)}
527
459
  .workspace-secondary-toolbar{display:flex;align-items:center;gap:8px;flex-wrap:wrap;padding:6px 12px;border-bottom:1px solid var(--border)}
@@ -586,17 +518,15 @@ body.job-window{display:grid;grid-template-rows:auto auto minmax(0,1fr);height:1
586
518
  /* Retained hosts keep main's header, row and frame geometry on the shared entry. */
587
519
  #app[data-retained-workspace]{height:100%;grid-template:auto 1fr/minmax(12rem,18rem) minmax(0,1fr);color:var(--fg);background:var(--bg)}
588
520
  #app[data-retained-workspace=owner]{grid-template-columns:minmax(12rem,18rem) 1fr}
589
- .hub-header,.owner-header{grid-column:1/-1;display:flex;align-items:center;gap:1rem;padding:.75rem 1rem;border-bottom:1px solid var(--border)}
590
- .hub-header h1,.owner-header h1{margin:0;font-size:1rem}
591
- .hub-header h1{flex:0 0 auto}
592
- .hub-header select,.owner-header select{width:auto;min-width:6rem;max-width:12rem;flex:0 0 auto}
593
- .hub-status,.owner-status{flex:1;color:var(--fg-muted)}
594
- .hub-status{min-width:0}
595
- .hub-list,.owner-list{overflow:auto;border-right:1px solid var(--border);padding:.5rem}
596
- .hub-list button,.owner-list button{width:100%;display:grid;gap:.25rem;margin-bottom:.5rem;padding:.75rem;text-align:left}
597
- .hub-list button[aria-pressed=true],.owner-list button[aria-pressed=true]{border-color:var(--pass)}
598
- .hub-list span,.owner-target-title{overflow-wrap:anywhere}
599
- .hub-job-state,.hub-job-source,.owner-target-status,.owner-target-animation{color:var(--fg-muted);font-size:.8rem}
600
- .hub-stage,.owner-stage{position:relative;min-width:0;min-height:0}
601
- .hub-stage iframe,.owner-stage iframe{position:absolute;inset:0;width:100%;height:100%;border:0}
602
- .hub-stage iframe[hidden],.owner-stage iframe[hidden]{display:block!important;visibility:hidden;pointer-events:none}
521
+ .owner-header{grid-column:1/-1;display:flex;align-items:center;gap:1rem;padding:.75rem 1rem;border-bottom:1px solid var(--border)}
522
+ .owner-header h1{margin:0;font-size:1rem}
523
+ .owner-header select{width:auto;min-width:6rem;max-width:12rem;flex:0 0 auto}
524
+ .owner-status{flex:1;color:var(--fg-muted)}
525
+ .owner-list{overflow:auto;border-right:1px solid var(--border);padding:.5rem}
526
+ .owner-list button{width:100%;display:grid;gap:.25rem;margin-bottom:.5rem;padding:.75rem;text-align:left}
527
+ .owner-list button[aria-pressed=true]{border-color:var(--pass)}
528
+ .owner-target-title{overflow-wrap:anywhere}
529
+ .owner-target-status,.owner-target-animation{color:var(--fg-muted);font-size:.8rem}
530
+ .owner-stage{position:relative;min-width:0;min-height:0}
531
+ .owner-stage iframe{position:absolute;inset:0;width:100%;height:100%;border:0}
532
+ .owner-stage iframe[hidden]{display:block!important;visibility:hidden;pointer-events:none}
@@ -120,6 +120,17 @@ function displayedRig(ctx:CanvasRenderingContext2D,capture:ViewportCapture,frame
120
120
  ctx.restore();
121
121
  }return true;
122
122
  }
123
+ /** Shared off-screen rendering for inspection crops and fixed job evidence. */
124
+ export function paintPosedViewport(ctx:CanvasRenderingContext2D,posed:PosedFrame,assets:ModelAssets,
125
+ camera:ControlNumericCamera,backend:CanvasBackend):void {
126
+ if(backend==='canvas2d'&&posed.order.some(row=>row.tint.slice(0,3).some(c=>c!==1)||row.dark?.some(c=>c!==0)))throw new Error('COMMENT_CAPTURE_UNAVAILABLE: Canvas2D cannot reproduce active RGB/dark tint');
127
+ const root=document.createElement('div'),renderer=new CanvasRenderer(root,assets.pageImages);
128
+ try {
129
+ renderer.backend=backend;renderer.viewport={...camera.visible};
130
+ renderer.pixelRatio=camera.viewport.width/camera.visible.width;
131
+ renderer.render(posed);ctx.drawImage(renderer.canvas,0,0,camera.viewport.width,camera.viewport.height);
132
+ }finally{renderer.dispose();}
133
+ }
123
134
  export function paintInspectionViewport(ctx:CanvasRenderingContext2D,area:MarkRegion,capture:ViewportCapture,pose:{camera:ControlNumericCamera;posed?:PosedFrame;assets?:ModelAssets;media?:HTMLVideoElement|HTMLImageElement}):void {
124
135
  if(capture.nearest)ctx.imageSmoothingEnabled=false;
125
136
  const overlays=capture.includeOverlays===false?[]:[...capture.pane.querySelectorAll<HTMLCanvasElement>('canvas')].filter(node=>!capture.root?.contains(node)&&node!==capture.canvas).map(node=>displayedPixels(node,capture.pane)).filter((v):v is PixelLayer=>v!==null);
@@ -127,8 +138,7 @@ export function paintInspectionViewport(ctx:CanvasRenderingContext2D,area:MarkRe
127
138
  if(capture.canvas){if(capture.strictActualPixels&&getComputedStyle(capture.canvas).filter!=='none')throw new Error('JOB_STILL_CAPTURE_FAILED');const pixels=displayedPixels(capture.canvas,capture.pane,!capture.root?.contains(capture.canvas));if(pixels){ctx.save();ctx.globalAlpha=pixels.opacity;ctx.drawImage(pixels.image,pixels.rect.x,pixels.rect.y,pixels.rect.width,pixels.rect.height);ctx.restore();return;}}
128
139
  if(pose.posed&&pose.assets){if(displayedRig(ctx,capture,pose.posed,pose.camera))return;
129
140
  if(capture.strictActualPixels)throw new Error('JOB_STILL_CAPTURE_FAILED');
130
- if(capture.backend==='canvas2d'&&pose.posed.order.some(row=>row.tint.slice(0,3).some(c=>c!==1)||row.dark?.some(c=>c!==0)))throw new Error('COMMENT_CAPTURE_UNAVAILABLE: Canvas2D cannot reproduce active RGB/dark tint');
131
- const root=document.createElement('div'),renderer=new CanvasRenderer(root,pose.assets.pageImages);try{renderer.backend=capture.backend;renderer.viewport={...pose.camera.visible};renderer.pixelRatio=pose.camera.viewport.width/pose.camera.visible.width;renderer.render(pose.posed);ctx.drawImage(renderer.canvas,0,0,pose.camera.viewport.width,pose.camera.viewport.height);}finally{renderer.dispose();}
141
+ paintPosedViewport(ctx,pose.posed,pose.assets,pose.camera,capture.backend);
132
142
  }else if(capture.strictActualPixels){throw new Error('JOB_STILL_CAPTURE_FAILED');
133
143
  }else if(pose.media){const media=pose.media,style=getComputedStyle(media),a=media.getBoundingClientRect(),b=capture.pane.getBoundingClientRect();if(!transparent(style.backgroundColor)){ctx.fillStyle=style.backgroundColor;ctx.fillRect(a.left-b.left-capture.pane.clientLeft,a.top-b.top-capture.pane.clientTop,a.width,a.height);}const w=media instanceof HTMLVideoElement?media.videoWidth:media.naturalWidth,h=media instanceof HTMLVideoElement?media.videoHeight:media.naturalHeight,first=projectMark({x:0,y:0},pose.camera),last=projectMark({x:w,y:h},pose.camera);ctx.drawImage(media,first.x,first.y,last.x-first.x,last.y-first.y);
134
144
  }else throw new Error('COMMENT_CROP_UNAVAILABLE: this viewport has no rendered pixels');
@@ -33,7 +33,7 @@ export function mountStatusBar(options:WorkspaceStatusBarOptions|{placement:'inl
33
33
  return {footer,message};
34
34
  }
35
35
 
36
- export type WorkspaceHeaderCompatibility = 'rigStep1'|'legacyCompareStep3'|'legacyPartsStep2'|'legacyInterviewStep4'|'legacyJobStep5'|'legacyHubStep6'|'legacyOwnerStep6';
36
+ export type WorkspaceHeaderCompatibility = 'rigStep1'|'legacyCompareStep3'|'legacyPartsStep2'|'legacyInterviewStep4'|'legacyOwnerStep6';
37
37
  export interface WorkspaceHeaderOptions {
38
38
  compatibility:WorkspaceHeaderCompatibility;embedded?:boolean;title?:string;revision?:string;
39
39
  /** Only the stopped compare host supplies its existing domain controls and actions. */
@@ -46,10 +46,10 @@ export interface WorkspaceHeader {
46
46
  }
47
47
  /** One C1 construction path; the finite legacy choices expire at their named screen migrations. */
48
48
  export function mountWorkspaceShell(options:WorkspaceHeaderOptions):WorkspaceHeader {
49
- const kind=options.compatibility,rig=kind==='rigStep1',compare=kind==='legacyCompareStep3',parts=kind==='legacyPartsStep2',interview=kind==='legacyInterviewStep4',job=kind==='legacyJobStep5',hub=kind==='legacyHubStep6',owner=kind==='legacyOwnerStep6';
49
+ const kind=options.compatibility,rig=kind==='rigStep1',compare=kind==='legacyCompareStep3',parts=kind==='legacyPartsStep2',interview=kind==='legacyInterviewStep4',owner=kind==='legacyOwnerStep6';
50
50
  const branded=rig||compare||parts,settingsLanguage=rig||compare;
51
51
  const header=panelMake('header');
52
- const headerClass=rig?'topbar':parts?'pv-top':job?'job-header':hub?'hub-header':owner?'owner-header':null;
52
+ const headerClass=rig?'topbar':parts?'pv-top':owner?'owner-header':null;
53
53
  if(headerClass)header.className=headerClass;
54
54
  if(branded){
55
55
  const brand=panelMake('div',{className:parts?'pv-brand':'brand'});
@@ -61,7 +61,6 @@ export function mountWorkspaceShell(options:WorkspaceHeaderOptions):WorkspaceHea
61
61
  const titleId=rig?'package-title':compare?'title':parts?'pv-title':null;
62
62
  if(titleId)title.id=titleId;
63
63
  title.textContent=options.title??(rig?'Review package':compare?'A / B comparison':parts?'Parts review':'');
64
- if(job)title.dataset.jobText='job.title';
65
64
  let subtitle:HTMLElement|null=null;
66
65
  if(branded){
67
66
  subtitle=panelMake('span',{id:rig?'revision':compare?'animation':'pv-mode',className:rig?'subtle':compare?'hint':'pv-subtle',textContent:options.revision??''});
@@ -85,13 +84,13 @@ export function mountWorkspaceShell(options:WorkspaceHeaderOptions):WorkspaceHea
85
84
  }
86
85
  let stages:HTMLElement|null=null,status:HTMLParagraphElement|null=null;
87
86
 
88
- if(hub||owner){status=panelMake('p',{className:hub?'hub-status':'owner-status'});status.setAttribute('role','status');header.append(status);}
87
+ if(owner){status=panelMake('p',{className:'owner-status'});status.setAttribute('role','status');header.append(status);}
89
88
  let language:HTMLSelectElement|null=null,languageLabel:HTMLLabelElement|null=null;
90
89
  if(!parts){
91
90
  language=panelMake('select');
92
91
  if(settingsLanguage){language.id='settings-language';language.dataset.appPreference='';}
93
92
  for(const value of settingsLanguage?['system','en','ko']:['en','ko']){
94
- const text=settingsLanguage?(value==='system'?'System':value==='en'?'English':'한국어'):interview?(value==='en'?'English':'한국어'):job?value:'';
93
+ const text=settingsLanguage?(value==='system'?'System':value==='en'?'English':'한국어'):interview?(value==='en'?'English':'한국어'):'';
95
94
  language.append(panelMake('option',{value,textContent:text}));
96
95
  }
97
96
  if(settingsLanguage){languageLabel=labelledControl('Language ',language);if(rig)header.append(languageLabel);}
@@ -1,2 +0,0 @@
1
- import {runFront} from './front.ts';
2
- if(import.meta.main)runFront(Bun.argv[2]??'').catch(error=>{console.error(error instanceof Error?error.message:String(error));process.exit(1);});
package/src/job-hub.ts DELETED
@@ -1,304 +0,0 @@
1
- /** Embedded job owner. Trusted callback registrations never cross a process boundary. */
2
- import {randomBytes, randomUUID} from 'node:crypto';
3
- import {mkdir, unlink} from 'node:fs/promises';
4
- import {join} from 'node:path';
5
- import {buildWeb} from './build.ts';
6
- import {jobBody, jobObject, sameCapability} from './job-api.ts';
7
- import {JOB_API_SCHEMA, JOB_ACT_SCHEMA, JOB_CAPABILITIES, type JobCapabilities, type JobHostPorts, type JobReviewerBinding} from './job-contract.ts';
8
- import {assertJobHostCompatible, createJobRequestContext, installJobWriterBinding, jobHostIdentity,
9
- jobWindowResources, type JobHostOptions, type JobHostReuseExpectation, type JobHostRecord} from './job-front.ts';
10
- import {JobSession} from './job-session.ts';
11
- import {captureJobRoot} from './job-source.ts';
12
- import {JobError} from './job-store.ts';
13
- import {acquireClaim, readOpenStatus, releaseClaim, running} from './open.ts';
14
- import {assertPrivate, readPrivate, writePrivate} from './open-workspace-state.ts';
15
- import {canonicalStatePath} from './state-dir.ts';
16
-
17
- export interface JobHubOptions {
18
- readonly stateDir: string;
19
- readonly reviewer: JobReviewerBinding;
20
- readonly port?: number;
21
- }
22
- export type JobHubJobOptions = Omit<JobHostOptions, 'stateDir' | 'port' | 'reviewer' | 'reuseOnly'>;
23
- export interface JobHubJob {
24
- readonly session: JobSession;
25
- readonly ports: JobHostPorts;
26
- readonly origin: string;
27
- readonly jobUrl: string;
28
- readonly reused: boolean;
29
- readonly attachment: JobHostReuseExpectation;
30
- }
31
- export interface JobOwnerHub {
32
- readonly origin: string;
33
- readonly ownerUrl: string;
34
- openJob(options: JobHubJobOptions): Promise<JobHubJob>;
35
- stop(): Promise<void>;
36
- }
37
-
38
- export interface JobHubRow {
39
- jobId: string;
40
- generation: number;
41
- status: 'active' | 'closed';
42
- publication: {publicationId: string; instanceKey: string; sourceHash: string; label: string} | null;
43
- pendingCount: number;
44
- }
45
- export interface JobHubList {
46
- schema: 'rig-review-job-hub/1';
47
- capabilities?: JobCapabilities;
48
- incarnation: string;
49
- limit: number;
50
- jobs: JobHubRow[];
51
- }
52
-
53
- const schema = 'rig-review-job-hub/1';
54
- const maximumJobs = 32;
55
- const responseHeaders = {'Cache-Control': 'no-store', 'X-Content-Type-Options': 'nosniff', 'Referrer-Policy': 'no-referrer'};
56
- type HubCode = 'JOB_HUB_ALREADY_RUNNING' | 'JOB_HUB_EXTERNAL_HOST' | 'JOB_HUB_HOST_UNRESPONSIVE' |
57
- 'JOB_HUB_CLOSED' | 'JOB_HUB_LIMIT' | 'JOB_HUB_STATE_INVALID';
58
- class HubError extends Error {
59
- constructor(readonly code: HubCode) {super(code);}
60
- }
61
- interface HubRecord {
62
- schema: typeof schema;
63
- pid: number;
64
- origin: string;
65
- incarnation: string;
66
- capability: string;
67
- }
68
- interface Member {
69
- root: string;
70
- fingerprint: string;
71
- session: JobSession;
72
- context: ReturnType<typeof createJobRequestContext>;
73
- recordPath: string;
74
- ready: boolean;
75
- }
76
- function refused(code: string, status: number) {
77
- return Response.json({ok: false, error: {code, message: code}}, {status, headers: responseHeaders});
78
- }
79
- function hostRecord(value: unknown, jobId?: string): JobHostRecord {
80
- if (!value || typeof value !== 'object') throw new HubError('JOB_HUB_STATE_INVALID');
81
- const row = value as JobHostRecord;
82
- let origin: URL;
83
- try {origin = new URL(row.origin);} catch {throw new HubError('JOB_HUB_STATE_INVALID');}
84
- if (row.schema !== 'rig-review-job-host/1' || typeof row.jobId !== 'string' || jobId && row.jobId !== jobId ||
85
- typeof row.fingerprint !== 'string' || !Number.isSafeInteger(row.pid) || row.pid < 1 ||
86
- origin.origin !== row.origin || origin.protocol !== 'http:' || origin.hostname !== '127.0.0.1') {
87
- throw new HubError('JOB_HUB_STATE_INVALID');
88
- }
89
- return row;
90
- }
91
-
92
- export async function startJobHub(options: JobHubOptions): Promise<JobOwnerHub> {
93
- const reviewer = structuredClone(options.reviewer);
94
- if (!reviewer?.id || !['owner', 'delegate'].includes(reviewer.role)) throw new JobError('JOB_AUTHORITY_REFUSED');
95
- if (options.port !== undefined && (!Number.isSafeInteger(options.port) || options.port < 0 || options.port > 65535)) {
96
- throw new JobError('JOB_REQUEST_INVALID');
97
- }
98
- const stateDir = canonicalStatePath(options.stateDir);
99
- const directory = join(stateDir, 'job-hub'), control = join(stateDir, 'job-ui');
100
- for (const path of [directory, control]) {
101
- await mkdir(path, {recursive: true, mode: 0o700}); await assertPrivate(path, true);
102
- }
103
- const recordPath = join(directory, 'host.json'), incarnation = randomUUID();
104
- const capability = randomBytes(32).toString('hex');
105
- async function refuseLiveHub(): Promise<null> {
106
- const previous = await readPrivate(recordPath) as HubRecord | null;
107
- if (!previous) return null;
108
- if (previous.schema !== schema || !Number.isSafeInteger(previous.pid) || previous.pid < 1) {
109
- throw new HubError('JOB_HUB_STATE_INVALID');
110
- }
111
- if (running(previous.pid)) throw new HubError('JOB_HUB_ALREADY_RUNNING');
112
- return null;
113
- }
114
- await refuseLiveHub();
115
- const acquired = await acquireClaim(directory, 'hub', incarnation, refuseLiveHub,
116
- performance.now() + 20_000, 'JOB_HUB_ALREADY_RUNNING');
117
- if (!('claim' in acquired)) throw new HubError('JOB_HUB_ALREADY_RUNNING');
118
- const hubClaim = acquired.claim;
119
- let server: ReturnType<typeof Bun.serve> | undefined;
120
- const members = new Map<string, Member>();
121
- let queue = Promise.resolve(), closing = false, requests = 0;
122
- let stopping: Promise<void> | undefined;
123
- const resources = jobWindowResources();
124
- let hubBundle: Promise<Blob> | undefined;
125
- async function removeOwned(path: string) {
126
- const value = await readPrivate(path) as {incarnation?: string; hubIncarnation?: string} | null;
127
- if (value?.incarnation === incarnation || value?.hubIncarnation === incarnation) {
128
- await unlink(path).catch(error => {if (error.code !== 'ENOENT') throw error;});
129
- }
130
- }
131
- function stop(): Promise<void> {
132
- if (stopping) return stopping;
133
- closing = true;
134
- stopping = (async () => {
135
- await queue;
136
- for (const member of members.values()) member.context.stop();
137
- while (requests || [...members.values()].some(member => member.context.busy)) await Bun.sleep(10);
138
- await server?.stop(true);
139
- for (const member of members.values()) {
140
- member.session.dispose(); await removeOwned(member.recordPath);
141
- }
142
- members.clear();
143
- await removeOwned(recordPath);
144
- await releaseClaim(hubClaim, incarnation);
145
- })();
146
- return stopping;
147
- }
148
- try {
149
- await refuseLiveHub();
150
- server = Bun.serve({hostname: '127.0.0.1', port: options.port ?? 0, idleTimeout: 0,
151
- async fetch(request): Promise<Response> {
152
- if (closing) return refused('JOB_HUB_CLOSED', 503);
153
- requests++;
154
- try {
155
- const url = new URL(request.url);
156
- if (url.origin !== origin) return refused('JOB_LOOPBACK_REQUIRED', 403);
157
- const resource = url.pathname === '/hub/' ? 'index.html' : url.pathname === '/hub/main.js' ? 'main.js'
158
- : url.pathname === '/hub/styles.css' ? 'styles.css' : null;
159
- if (resource) {
160
- if (!['GET', 'HEAD'].includes(request.method)) return refused('JOB_REQUEST_INVALID', 405);
161
- if (request.headers.get('sec-fetch-site') === 'cross-site' ||
162
- request.headers.get('origin') !== null && request.headers.get('origin') !== origin) return refused('JOB_SAME_ORIGIN_REQUIRED', 403);
163
- if (resource === 'index.html') {
164
- if (url.searchParams.get('workspace') !== incarnation ||
165
- [...url.searchParams.keys()].some(key => !['workspace', 'lang'].includes(key) || url.searchParams.getAll(key).length !== 1) ||
166
- url.searchParams.has('lang') && !['en', 'ko'].includes(url.searchParams.get('lang')!)) return refused('JOB_REQUEST_INVALID', 400);
167
- } else if (url.search) return refused('JOB_REQUEST_INVALID', 400);
168
- let body: BodyInit | null = null;
169
- if (request.method !== 'HEAD') {
170
- if (resource === 'main.js') body = await (hubBundle ??= buildWeb('job-hub'));
171
- else body = Bun.file(new URL('../web/' + resource, import.meta.url));
172
- }
173
- return new Response(body, {headers: {...responseHeaders,
174
- 'Content-Type': resource.endsWith('.html') ? 'text/html; charset=utf-8' : resource.endsWith('.js') ? 'text/javascript' : 'text/css',
175
- 'Content-Security-Policy': "default-src 'none'; script-src 'self'; style-src 'self'; frame-src 'self'; connect-src 'self'; base-uri 'none'; frame-ancestors 'none'; form-action 'none'"}});
176
- }
177
- const selected = /^\/hub\/api\/jobs\/([A-Za-z0-9][A-Za-z0-9._-]{0,127})\/open$/.exec(url.pathname);
178
- if (url.pathname === '/hub/host' || url.pathname === '/hub/api/jobs' || selected) {
179
- if (request.method !== (selected ? 'POST' : 'GET') || url.search) return refused('JOB_REQUEST_INVALID', 400);
180
- if (request.headers.get('sec-fetch-site') === 'cross-site' ||
181
- request.headers.get('origin') !== null && request.headers.get('origin') !== origin) {
182
- return refused('JOB_SAME_ORIGIN_REQUIRED', 403);
183
- }
184
- if (!sameCapability(request.headers.get('X-Review-Capability'), capability)) {
185
- return refused('JOB_CAPABILITY_REQUIRED', 403);
186
- }
187
- if (selected) {
188
- if (request.headers.get('origin') !== origin) return refused('JOB_SAME_ORIGIN_REQUIRED', 403);
189
- try {
190
- const input = jobObject(await jobBody(request), ['schema', 'incarnation']);
191
- if (input.schema !== schema || input.incarnation !== incarnation) return refused('JOB_REQUEST_INVALID', 400);
192
- } catch (error) {return refused(error instanceof JobError ? error.code : 'JOB_REQUEST_INVALID',
193
- error instanceof JobError && error.code === 'JOB_BODY_LIMIT' ? 413 : 400);}
194
- const member = members.get(selected[1]!);
195
- if (!member?.ready) return refused('JOB_UNKNOWN', 404);
196
- if (member.session.status().status === 'closed') return refused('JOB_CLOSED', 409);
197
- return Response.json({schema, incarnation, jobId: selected[1],
198
- entry: `/jobs/${selected[1]}/?hub=${incarnation}`, capability: member.session.hostCredentials().ui}, {headers: responseHeaders});
199
- }
200
- if (url.pathname === '/hub/host') return Response.json({schema, incarnation, pid: process.pid,
201
- origin, apiSchema: JOB_API_SCHEMA, actSchema: JOB_ACT_SCHEMA, capabilities: JOB_CAPABILITIES}, {headers: responseHeaders});
202
- return Response.json({schema, incarnation, capabilities: JOB_CAPABILITIES, limit: maximumJobs, jobs: [...members.values()].filter(member => member.ready).map(member => {
203
- const status = member.session.status();
204
- return {jobId: status.jobId, generation: status.generation, status: status.status,
205
- publication: status.publication && {publicationId: status.publication.publicationId,
206
- instanceKey: status.publication.instanceKey, sourceHash: status.publication.source.sourceHash,
207
- label: status.publication.label.slice(0, 512)}, pendingCount: status.pending.length};
208
- })}, {headers: responseHeaders});
209
- }
210
- const match = /^\/jobs\/([A-Za-z0-9][A-Za-z0-9._-]{0,127})\//.exec(url.pathname);
211
- const member = match && members.get(match[1]!);
212
- return member ? await member.context.fetch(request) : refused('JOB_UNKNOWN', 404);
213
- } finally {requests--;}
214
- },
215
- });
216
- const origin: string = `http://127.0.0.1:${server.port}`;
217
- const record: HubRecord = {schema, pid: process.pid, origin, incarnation, capability};
218
- await writePrivate(recordPath, record);
219
- async function register(input: JobHubJobOptions): Promise<JobHubJob> {
220
- if (closing) throw new HubError('JOB_HUB_CLOSED');
221
- if (!input || typeof input !== 'object' || 'reuseOnly' in (input as Record<string, unknown>)) {
222
- throw new JobError('JOB_REQUEST_INVALID');
223
- }
224
- const startup: JobHostOptions = {...input, stateDir, reviewer};
225
- const identity = jobHostIdentity(startup);
226
- const root = captureJobRoot(startup.root).path;
227
- if (members.size >= maximumJobs && ![...members.values()].some(member =>
228
- member.root === root && member.fingerprint === startup.fingerprint && member.session.status().status === 'active')) {
229
- throw new HubError('JOB_HUB_LIMIT');
230
- }
231
- const session = new JobSession(startup);
232
- let retained = false;
233
- let claim: string | undefined;
234
- let member: Member | undefined;
235
- const nonce = randomUUID();
236
- try {
237
- const existing = members.get(session.jobId);
238
- if (existing) {
239
- assertJobHostCompatible(existing.context.record, identity);
240
- await installJobWriterBinding(existing.session, startup, origin);
241
- return {session: existing.session, ports: existing.context.ports, origin,
242
- jobUrl: origin + `/jobs/${session.jobId}/#cap=${existing.session.hostCredentials().ui}`, reused: true, attachment: existing.context.ownerAttachment()};
243
- }
244
- if (members.size >= maximumJobs) throw new HubError('JOB_HUB_LIMIT');
245
- const path = join(control, session.jobId + '.json');
246
- async function refuseExternal(): Promise<null> {
247
- const value = await readPrivate(path);
248
- if (!value) return null;
249
- const row = hostRecord(value, session.jobId);
250
- if (row.fingerprint !== startup.fingerprint) throw new HubError('JOB_HUB_STATE_INVALID');
251
- if (!running(row.pid)) return null;
252
- let remote: JobHostRecord;
253
- try {
254
- const response = await fetch(row.origin + `/jobs/${session.jobId}/host`, {
255
- headers: {'X-Review-Capability': session.hostCredentials().ui}, redirect: 'error', signal: AbortSignal.timeout(1500),
256
- });
257
- if (!response.ok) {await response.body?.cancel(); throw new HubError('JOB_HUB_HOST_UNRESPONSIVE');}
258
- remote = hostRecord(await readOpenStatus(response, 1500), session.jobId);
259
- if (remote.origin !== row.origin || remote.pid !== row.pid || remote.fingerprint !== row.fingerprint) {
260
- throw new HubError('JOB_HUB_HOST_UNRESPONSIVE');
261
- }
262
- } catch {throw new HubError('JOB_HUB_HOST_UNRESPONSIVE');}
263
- assertJobHostCompatible(row, identity); assertJobHostCompatible(remote, identity);
264
- throw new HubError('JOB_HUB_EXTERNAL_HOST');
265
- }
266
- await refuseExternal();
267
- const acquiredJob = await acquireClaim(control, 'job-' + session.jobId, nonce, refuseExternal,
268
- performance.now() + 20_000, 'JOB_HUB_EXTERNAL_HOST');
269
- if (!('claim' in acquiredJob)) throw new HubError('JOB_HUB_EXTERNAL_HOST');
270
- claim = acquiredJob.claim;
271
- await refuseExternal();
272
- const context = createJobRequestContext(session, startup, origin, identity, resources, incarnation, incarnation, () => !closing && !!member?.ready);
273
- Object.assign(context.record, {hubIncarnation: incarnation});
274
- member = {root, fingerprint: startup.fingerprint, session, context, recordPath: path, ready: false};
275
- members.set(session.jobId, member);
276
- await installJobWriterBinding(session, startup, origin);
277
- if (closing) throw new HubError('JOB_HUB_CLOSED');
278
- await writePrivate(path, context.descriptor().record);
279
- context.publish();
280
- member.ready = true; retained = true;
281
- return {session, ports: context.ports, origin,
282
- jobUrl: origin + `/jobs/${session.jobId}/#cap=${session.hostCredentials().ui}`, reused: false, attachment: context.ownerAttachment()};
283
- } finally {
284
- if (!retained) {
285
- if (member) {
286
- members.delete(session.jobId); member.context.stop();
287
- while (member.context.busy) await Bun.sleep(10);
288
- }
289
- session.dispose();
290
- }
291
- if (claim) await releaseClaim(claim, nonce);
292
- }
293
- }
294
- return {origin, ownerUrl: origin + '/hub/?workspace=' + incarnation + '#cap=' + capability,
295
- openJob(input) {
296
- const startup = {...input};
297
- const task = queue.then(() => register(startup));
298
- queue = task.then(() => {}, () => {});
299
- return task;
300
- }, stop};
301
- } catch (error) {
302
- await stop(); throw error;
303
- }
304
- }