@rig-c/review 3.7.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 (109) hide show
  1. package/README.md +1 -1
  2. package/docs/DESIGN.md +145 -74
  3. package/docs/PANELS.md +20 -12
  4. package/docs/PARTS_VIEW.md +133 -76
  5. package/docs/REVIEW_PACKAGE.md +445 -99
  6. package/docs/STABILITY.md +132 -198
  7. package/docs/WORKFLOWS.md +41 -120
  8. package/package.json +4 -3
  9. package/skills/rig-review/SKILL.md +41 -27
  10. package/src/build.ts +10 -2
  11. package/src/cli.ts +17 -16
  12. package/src/comment-crops.ts +6 -1
  13. package/src/compare-html.ts +22 -24
  14. package/src/compare-server.ts +1 -1
  15. package/src/compare-session.ts +41 -3
  16. package/src/correction-handoff.ts +27 -4
  17. package/src/create-pin-gate.ts +3 -0
  18. package/src/direction-inspection.ts +6 -2
  19. package/src/feedback-export.ts +68 -1
  20. package/src/front.ts +5 -200
  21. package/src/handoff.ts +1 -1
  22. package/src/interview-routes.ts +1 -1
  23. package/src/interview-scene.ts +3 -3
  24. package/src/job-act.ts +77 -73
  25. package/src/job-api.ts +326 -13
  26. package/src/job-checkpoint-evidence.ts +113 -0
  27. package/src/job-cli.ts +27 -14
  28. package/src/job-contract.ts +284 -62
  29. package/src/job-front.ts +157 -58
  30. package/src/job-host.ts +23 -4
  31. package/src/job-session.ts +109 -24
  32. package/src/job-source.ts +209 -57
  33. package/src/job-store.ts +80 -6
  34. package/src/job-worker.ts +1 -47
  35. package/src/joined-project.ts +61 -4
  36. package/src/manifest.ts +32 -4
  37. package/src/open-workspace.ts +12 -12
  38. package/src/open.ts +19 -12
  39. package/src/parts-comment-crops.ts +126 -31
  40. package/src/parts-comment.ts +351 -28
  41. package/src/parts-server.ts +19 -7
  42. package/src/parts-view.ts +588 -109
  43. package/src/scene-inspection.ts +50 -0
  44. package/src/server.ts +31 -22
  45. package/src/session.ts +58 -0
  46. package/src/stage-comment.ts +48 -1
  47. package/src/stage-parts.ts +23 -11
  48. package/web/animation-inspection.ts +1 -1
  49. package/web/bones-panel.ts +1 -3
  50. package/web/catalog-en.ts +175 -39
  51. package/web/catalog-ko.ts +175 -39
  52. package/web/cloth-panel.ts +1 -2
  53. package/web/compare.css +3 -13
  54. package/web/compare.html +3 -3
  55. package/web/compare.ts +69 -64
  56. package/web/cuts-panel.ts +1 -3
  57. package/web/density-strip-panel.ts +1 -2
  58. package/web/direction-panel.ts +22 -6
  59. package/web/i18n.ts +13 -1
  60. package/web/idle-panel.ts +1 -2
  61. package/web/index.html +1 -5
  62. package/web/inspection-persistence.ts +2 -1
  63. package/web/inspector-blocks.ts +149 -40
  64. package/web/instance-access.ts +24 -5
  65. package/web/interview-panel.ts +224 -175
  66. package/web/job-rig-capture.ts +164 -21
  67. package/web/job-rig-screen.ts +337 -0
  68. package/web/job-session.ts +611 -1437
  69. package/web/main.ts +614 -151
  70. package/web/mesh-panel.ts +1 -2
  71. package/web/owner-workspace.ts +88 -109
  72. package/web/part-selection.ts +47 -6
  73. package/web/part-thumbnails.ts +20 -6
  74. package/web/parts-render.ts +26 -19
  75. package/web/parts-viewport-provider.ts +181 -7
  76. package/web/physics-panel.ts +1 -2
  77. package/web/readings-panel.ts +1 -2
  78. package/web/requirements-panel.ts +1 -3
  79. package/web/retained-frame-stage.ts +105 -0
  80. package/web/retarget-panel.ts +2 -3
  81. package/web/rig-fields-panel.ts +1 -2
  82. package/web/rig-host.ts +64 -0
  83. package/web/rig-viewport-provider.ts +65 -16
  84. package/web/scene-plates.ts +57 -4
  85. package/web/stage-comments.ts +103 -46
  86. package/web/styles.css +117 -63
  87. package/web/view-controls.ts +201 -12
  88. package/web/viewport-capture.ts +12 -2
  89. package/web/viewport-controller.ts +107 -27
  90. package/web/viewport-pair.ts +2 -1
  91. package/web/workspace-preferences.ts +5 -4
  92. package/web/workspace-ui.ts +151 -19
  93. package/src/front-worker.ts +0 -2
  94. package/src/interview-server.ts +0 -54
  95. package/src/job-hub.ts +0 -304
  96. package/src/job-image-set.ts +0 -50
  97. package/web/interview.css +0 -28
  98. package/web/interview.html +0 -17
  99. package/web/interview.ts +0 -40
  100. package/web/job-hub.css +0 -14
  101. package/web/job-hub.html +0 -5
  102. package/web/job-hub.ts +0 -179
  103. package/web/owner-workspace.css +0 -14
  104. package/web/owner-workspace.html +0 -5
  105. package/web/parts-flags.ts +0 -48
  106. package/web/parts.css +0 -104
  107. package/web/parts.html +0 -49
  108. package/web/parts.ts +0 -604
  109. package/web/stage-nav.ts +0 -136
@@ -1,7 +1,104 @@
1
1
  /** Browser workspace presentation. Source selection, player clocks and review decisions stay with the page. */
2
2
  import {WorkspacePreferenceStore,panelBounds,type WorkspaceLanguage,type WorkspacePanels,type WorkspacePreferences,type WorkspaceTheme} from './workspace-preferences.ts';
3
3
  import {allocateWorkspaceLayout,bindWorkspaceSeparator,bindWorkspaceDrawer,defaultWorkspaceColumns,InspectorScrollMemory,inspectorTabs,workspaceMinimums,type InspectorTab,type WorkspaceColumns,type WorkspacePanel,type SeparatorRange} from './workspace-layout.ts';
4
- import {bindDomI18n,getLinkLanguage,setLanguagePreference,setLinkLanguage,tr} from './i18n.ts';
4
+ import {bindDomI18n,getLinkLanguage,setLanguagePreference,setLinkLanguage,tr,onLanguageChange} from './i18n.ts';
5
+ import {panelMake,actionButton,labelledControl} from './view-controls.ts';
6
+
7
+ /** Header availability belongs to the shared shell, independently of the removed step chips. */
8
+ export function bindHeaderModeAvailability(options:{model:boolean;preRig?:boolean;parts?:boolean;root?:Pick<Document,'querySelectorAll'>}):()=>void {
9
+ const root=options.root??document,reason=options.preRig?'RIG_VERSION_UNAVAILABLE: this draft has no recorded rig review package.':!options.model?'MODEL_UNAVAILABLE: no compiled model is supplied in this inspection.':null;
10
+ if(!reason)return ()=>{};
11
+ const modes=[...root.querySelectorAll<HTMLButtonElement>('[data-mode]')].map(button=>({button,disabled:button.disabled,title:button.getAttribute('title'),pressed:button.getAttribute('aria-pressed')}));
12
+ const render=()=>{for(const {button}of modes){if(options.parts&&button.dataset.mode==='rig')continue;button.disabled=true;button.title=tr(reason);button.setAttribute('title',tr(reason));if(button.getAttribute('aria-pressed')!=='false')button.setAttribute('aria-pressed','false');}};
13
+ const refuse=(event:Event)=>{event.preventDefault();event.stopImmediatePropagation();render();};
14
+ const observer=new MutationObserver(render);for(const {button}of modes){observer.observe(button,{attributes:true,attributeFilter:['aria-pressed']});button.addEventListener('click',refuse,true);}
15
+ const off=onLanguageChange(render);render();
16
+ return ()=>{off();observer.disconnect();for(const {button,disabled,title,pressed}of modes){button.removeEventListener('click',refuse,true);button.disabled=disabled;button.title=title??'';if(title===null)button.removeAttribute('title');else button.setAttribute('title',title);if(pressed===null)button.removeAttribute('aria-pressed');else button.setAttribute('aria-pressed',pressed);}};
17
+ }
18
+
19
+ export interface WorkspaceStatusBarOptions {
20
+ message:HTMLElement|string;readouts:readonly HTMLElement[];source?:HTMLElement;
21
+ }
22
+ /** One C11 DOM constructor; screens supply their existing readout and source nodes. */
23
+ export function mountStatusBar(options:{placement:'inline';message:HTMLElement|string}):{message:HTMLElement};
24
+ export function mountStatusBar(options:WorkspaceStatusBarOptions):{footer:HTMLElement;message:HTMLElement};
25
+ export function mountStatusBar(options:WorkspaceStatusBarOptions|{placement:'inline';message:HTMLElement|string}):{footer?:HTMLElement;message:HTMLElement} {
26
+ const message=typeof options.message==='string'?panelMake('span',{id:'message',className:'status-message',textContent:options.message}):options.message;
27
+ message.setAttribute('role','status');message.setAttribute('aria-live','polite');
28
+ // Retained hosts already place their status in the header; preserve that node and geometry.
29
+ if('placement' in options)return {message};
30
+ const readouts=panelMake('div',{className:'status-readouts'},...options.readouts);readouts.setAttribute('aria-label','Status');
31
+ const footer=panelMake('footer',{className:'status-bar'},message,readouts);
32
+ if(options.source)footer.append(options.source);
33
+ return {footer,message};
34
+ }
35
+
36
+ export type WorkspaceHeaderCompatibility = 'rigStep1'|'legacyCompareStep3'|'legacyPartsStep2'|'legacyInterviewStep4'|'legacyOwnerStep6';
37
+ export interface WorkspaceHeaderOptions {
38
+ compatibility:WorkspaceHeaderCompatibility;embedded?:boolean;title?:string;revision?:string;
39
+ /** Only the stopped compare host supplies its existing domain controls and actions. */
40
+ compare?:{modeSwitch:HTMLElement;buildPicker:HTMLElement;actions:HTMLElement};
41
+ }
42
+ export interface WorkspaceHeader {
43
+ header:HTMLElement;title:HTMLElement;subtitle:HTMLElement|null;modeSwitch:HTMLElement|null;dirty:HTMLElement|null;
44
+ stages:HTMLElement|null;status:HTMLParagraphElement|null;language:HTMLSelectElement|null;languageLabel:HTMLLabelElement|null;
45
+ dispose:()=>void;
46
+ }
47
+ /** One C1 construction path; the finite legacy choices expire at their named screen migrations. */
48
+ export function mountWorkspaceShell(options:WorkspaceHeaderOptions):WorkspaceHeader {
49
+ const kind=options.compatibility,rig=kind==='rigStep1',compare=kind==='legacyCompareStep3',parts=kind==='legacyPartsStep2',interview=kind==='legacyInterviewStep4',owner=kind==='legacyOwnerStep6';
50
+ const branded=rig||compare||parts,settingsLanguage=rig||compare;
51
+ const header=panelMake('header');
52
+ const headerClass=rig?'topbar':parts?'pv-top':owner?'owner-header':null;
53
+ if(headerClass)header.className=headerClass;
54
+ if(branded){
55
+ const brand=panelMake('div',{className:parts?'pv-brand':'brand'});
56
+ const mark=panelMake('span',compare?{}:{className:parts?'pv-mark':'brand-mark'},compare?'COMPARE':'r');
57
+ if(compare)brand.append('rig review ',mark);else brand.append(mark,'rig review');
58
+ header.append(brand);
59
+ }
60
+ const title=panelMake(rig||parts?'strong':'h1');
61
+ const titleId=rig?'package-title':compare?'title':parts?'pv-title':null;
62
+ if(titleId)title.id=titleId;
63
+ title.textContent=options.title??(rig?'Review package':compare?'A / B comparison':parts?'Parts review':'');
64
+ let subtitle:HTMLElement|null=null;
65
+ if(branded){
66
+ subtitle=panelMake('span',{id:rig?'revision':compare?'animation':'pv-mode',className:rig?'subtle':compare?'hint':'pv-subtle',textContent:options.revision??''});
67
+ const identity=panelMake('div',{},title,...(parts?[' ']:[]),subtitle);header.append(identity);
68
+ }else{if(interview)header.append('\n ');header.append(title);}
69
+ let modeSwitch:HTMLElement|null=null,dirty:HTMLElement|null=null;
70
+ if(rig||compare){
71
+ modeSwitch=compare?options.compare!.modeSwitch:panelMake('div',{className:'mode-switch'});
72
+ if(rig){
73
+ modeSwitch.setAttribute('role','group');modeSwitch.setAttribute('aria-label','Mode');
74
+ for(const [mode,label] of [['rig','Setup'],['playback','Animate'],['compare','Compare']] as const){
75
+ const button=actionButton(label,null);button.dataset.mode=mode;button.setAttribute('aria-pressed',String(mode==='rig'));
76
+ if(mode==='compare'){button.disabled=true;button.title='No second build supplied: reopen with --compare <built> --reference <video>';}
77
+ else{button.dataset.inspector=mode;button.setAttribute('aria-controls','inspector-'+mode);}
78
+ modeSwitch.append(button);
79
+ }
80
+ }
81
+ header.append(modeSwitch);
82
+ if(compare)header.append(options.compare!.buildPicker,options.compare!.actions);
83
+ else{dirty=panelMake('span',{id:'dirty',className:'subtle',textContent:'Loading…'});header.append(panelMake('div',{className:'top-actions'},dirty));}
84
+ }
85
+ let stages:HTMLElement|null=null,status:HTMLParagraphElement|null=null;
86
+
87
+ if(owner){status=panelMake('p',{className:'owner-status'});status.setAttribute('role','status');header.append(status);}
88
+ let language:HTMLSelectElement|null=null,languageLabel:HTMLLabelElement|null=null;
89
+ if(!parts){
90
+ language=panelMake('select');
91
+ if(settingsLanguage){language.id='settings-language';language.dataset.appPreference='';}
92
+ for(const value of settingsLanguage?['system','en','ko']:['en','ko']){
93
+ const text=settingsLanguage?(value==='system'?'System':value==='en'?'English':'한국어'):interview?(value==='en'?'English':'한국어'):'';
94
+ language.append(panelMake('option',{value,textContent:text}));
95
+ }
96
+ if(settingsLanguage){languageLabel=labelledControl('Language ',language);if(rig)header.append(languageLabel);}
97
+ else{if(interview)header.append('\n ');header.append(language);if(interview)header.append('\n ');}
98
+ }
99
+ if(options.embedded){if(rig||parts)header.hidden=true;else if(interview)language!.hidden=true;}
100
+ return {header,title,subtitle,modeSwitch,dirty,stages,status,language,languageLabel,dispose(){header.remove();languageLabel?.remove();}};
101
+ }
5
102
 
6
103
  /** Reachable effective bounds, accounting for the other panel's saved desired size. */
7
104
  export function workspaceResizeRange(available:{width:number;height:number},desired:WorkspacePanels,panel:WorkspacePanel,columns:WorkspaceColumns=defaultWorkspaceColumns):SeparatorRange {
@@ -23,20 +120,26 @@ export function selectedInspector(root:Pick<Document,'querySelector'>=document):
23
120
  }
24
121
  export interface WorkspaceUI {
25
122
  defaults:()=>WorkspacePreferences;beforeTab:()=>void;afterTab:()=>void;scroll:()=>string;restoreScroll:(value:unknown)=>void;
26
- revealInspector:()=>void;refresh:()=>void;dispose:()=>void;
123
+ revealInspector:()=>void;refresh:()=>void;element:(id:string)=>HTMLElement|null;settle:()=>Promise<void>;dispose:()=>void;
124
+ }
125
+ /** Caller-owned shell regions. The left preference may retain a migrated screen's saved width. */
126
+ export interface WorkspaceRegions {
127
+ layout:HTMLElement;left:HTMLElement;main:HTMLElement;stage:HTMLElement;bottom:HTMLElement;right?:HTMLElement;
128
+ columns?:WorkspaceColumns;
27
129
  }
28
130
  /** `currentTheme`, when given, is the appearance the Settings theme select shows; otherwise it shows the saved default. */
29
- export function bindWorkspaceUI(options:{changed:()=>void;defaultTheme:(theme:WorkspaceTheme)=>void;currentTheme?:()=>WorkspaceTheme|undefined}):WorkspaceUI {
30
- const require=<T extends HTMLElement=HTMLElement>(id:string)=>{const node=document.getElementById(id);if(!node)throw new Error('Missing workspace element: '+id);return node as T;};
31
- const layout=document.querySelector<HTMLElement>('.layout')!,main=layout.querySelector<HTMLElement>('main')!,stage=require('stage-layout'),inspector=document.querySelector<HTMLElement>('.inspector')!,explorer=require('parts-explorer');
131
+ export function bindWorkspaceUI(options:{root?:HTMLElement;regions?:WorkspaceRegions;changed:()=>void;defaultTheme:(theme:WorkspaceTheme)=>void;currentTheme?:()=>WorkspaceTheme|undefined;language?:HTMLSelectElement;bottomPanel?:{kind:string;strip:HTMLElement;act:HTMLElement;actHome:HTMLElement;collapse:HTMLButtonElement}}):WorkspaceUI {
132
+ const scope=options.root??document,dialogs={} as Record<WorkspacePanel,HTMLDialogElement>;
133
+ const require=<T extends HTMLElement=HTMLElement>(id:string,optional=false)=>{const selector='#'+id,node=(options.root?.id===id?options.root:scope.querySelector<HTMLElement>(selector))??Object.values(dialogs).map(dialog=>dialog.id===id?dialog:dialog.querySelector<HTMLElement>(selector)).find(Boolean)??null;if(!node&&!optional)throw new Error('Missing workspace element: '+id);return node as T;};
134
+ const regions=options.regions,layout=regions?.layout??document.querySelector<HTMLElement>('.layout')!,main=regions?.main??layout.querySelector<HTMLElement>('main')!,stage=regions?.stage??require('stage-layout'),inspector=regions?.bottom??document.querySelector<HTMLElement>('.inspector')!,explorer=regions?regions.right:document.getElementById('parts-explorer');
32
135
  layout.classList.add('workspace-layout');
33
- let left=layout.querySelector<HTMLElement>('.left-panel');if(!left){left=document.createElement('aside');left.className='left-panel';left.innerHTML='<h2>INPUTS</h2><p class="hint">A and B retain their fixed source bindings. The reference video and shared animation are named above the stage.</p>';layout.prepend(left);}left.id='workspace-left';inspector.id='workspace-inspector';
136
+ let left=regions?.left??layout.querySelector<HTMLElement>('.left-panel');if(!left){left=document.createElement('aside');left.className='left-panel';left.innerHTML='<h2>INPUTS</h2><p class="hint">A and B retain their fixed source bindings. The reference video and shared animation are named above the stage.</p>';layout.prepend(left);}left.id='workspace-left';inspector.id='workspace-inspector';
34
137
  // A parts explorer placed inside the left column makes that column the explorer: it keeps the explorer's
35
138
  // saved width and the page has no right column. Otherwise sources stay left and the explorer stays right.
36
- const explorerLeft=left.contains(explorer),columns:WorkspaceColumns=explorerLeft?{left:'rightWidth',right:null}:defaultWorkspaceColumns;
139
+ const explorerLeft=regions?regions.columns?.left==='rightWidth'&&!regions.right:!!explorer&&left.contains(explorer),columns:WorkspaceColumns=regions?.columns??(explorerLeft?{left:'rightWidth',right:null}:explorer?defaultWorkspaceColumns:{left:'leftWidth',right:null});
37
140
  // A section is an Inspector panel only while it carries data-inspector-panel; the review page's Feedback
38
141
  // section lives in the review dialog instead and keeps its id without being a panel.
39
- const tabs=inspectorTabs.filter(tab=>document.getElementById('inspector-'+tab)?.dataset.inspectorPanel===tab);if(!tabs.length)throw new Error('Missing workspace element: inspector-'+inspectorTabs.join('|inspector-'));
142
+ const tabs=inspectorTabs.filter(tab=>require('inspector-'+tab,true)?.dataset.inspectorPanel===tab);if(!tabs.length&&!regions)throw new Error('Missing workspace element: inspector-'+inspectorTabs.join('|inspector-'));
40
143
  // The left column is a fixed header row (a leading `.left-header`, when the page has one) and one scrolling
41
144
  // body holding everything else, Settings included: the body is the column's only scroll container.
42
145
  const header=[...left.children].find(node=>node.className.split(' ').includes('left-header'))??null;
@@ -44,16 +147,18 @@ export function bindWorkspaceUI(options:{changed:()=>void;defaultTheme:(theme:Wo
44
147
  const settings=document.createElement('section');settings.className='workspace-settings';settings.setAttribute('aria-label','Settings');
45
148
  // The header holds the expand/collapse control; the body is hidden while collapsed (a workspace preference, default collapsed).
46
149
  const settingsHeader=document.createElement('h2'),settingsToggle=document.createElement('button'),settingsBody=document.createElement('div');settingsHeader.className='sticky-header settings-header';settingsToggle.type='button';settingsToggle.id='settings-toggle';settingsToggle.className='settings-toggle';settingsToggle.textContent='Settings';settingsToggle.setAttribute('aria-controls','settings-body');settingsBody.id='settings-body';settingsBody.className='settings-body';settingsHeader.append(settingsToggle);settings.append(settingsHeader,settingsBody);
47
- settingsBody.innerHTML='<label>Theme <select id="settings-theme" data-app-preference><option value="system">System</option><option value="dark">Dark</option><option value="light">Light</option></select></label><label>Language <select id="settings-language" data-app-preference><option value="system">System</option><option value="en">English</option><option value="ko">한국어</option></select></label><label><input id="settings-sync" data-app-preference type="checkbox">Sync cameras by default</label><label><input id="settings-idle" data-app-preference type="checkbox">Repeat idle by default</label><button id="settings-reset" type="button">Reset layout</button><p class="hint">Defaults apply to new inspections. Links and source drafts retain their explicit view.</p><p id="settings-state" class="hint" role="status"></p>';
150
+ settingsBody.innerHTML='<label>Theme <select id="settings-theme" data-app-preference><option value="system">System</option><option value="dark">Dark</option><option value="light">Light</option></select></label><label><input id="settings-sync" data-app-preference type="checkbox">Sync cameras by default</label><label><input id="settings-idle" data-app-preference type="checkbox">Repeat idle by default</label><button id="settings-reset" type="button">Reset layout</button><p class="hint">Defaults apply to new inspections. Links and source drafts retain their explicit view.</p><p id="settings-state" class="hint" role="status"></p>';
151
+ const sharedLanguage=options.language??require<HTMLSelectElement>('settings-language');
152
+ if(!sharedLanguage.closest('header'))settingsBody.firstElementChild!.after(sharedLanguage.parentElement!);
48
153
  sourceList.append(settings);
49
- const theme=require<HTMLSelectElement>('settings-theme'),language=require<HTMLSelectElement>('settings-language'),sync=require<HTMLInputElement>('settings-sync'),idle=require<HTMLInputElement>('settings-idle'),status=require('settings-state');
154
+ const theme=require<HTMLSelectElement>('settings-theme'),language=sharedLanguage,sync=require<HTMLInputElement>('settings-sync'),idle=require<HTMLInputElement>('settings-idle'),status=require('settings-state');
50
155
  const store=new WorkspacePreferenceStore({onStatus:value=>{status.textContent=tr(value.detail);}});let desired={...store.get().panels};
51
156
  const stack=document.createElement('div');stack.className='workspace-stage-stack';for(const child of [...main.children])if(child!==inspector)stack.append(child);main.prepend(stack);
52
157
  const triggers=document.createElement('div');triggers.className='workspace-drawer-triggers';triggers.setAttribute('aria-label','Workspace panels');stack.prepend(triggers);
53
- const panels:Partial<Record<WorkspacePanel,HTMLElement>>=explorerLeft?{rightWidth:left,inspectorHeight:inspector}:{leftWidth:left,rightWidth:explorer,inspectorHeight:inspector};
54
- const sides:Partial<Record<WorkspacePanel,'left'|'right'>>=explorerLeft?{rightWidth:'left'}:{leftWidth:'left',rightWidth:'right'};
158
+ const panels:Partial<Record<WorkspacePanel,HTMLElement>>={};if(columns.left)panels[columns.left]=left;if(columns.right&&explorer)panels[columns.right]=explorer;panels.inspectorHeight=inspector;
159
+ const sides:Partial<Record<WorkspacePanel,'left'|'right'>>={};if(columns.left)sides[columns.left]='left';if(columns.right&&explorer)sides[columns.right]='right';
55
160
  const labels:Record<WorkspacePanel,string>=explorerLeft?{leftWidth:'Sources and settings',rightWidth:'Parts and settings',inspectorHeight:'Inspector'}:{leftWidth:'Sources and settings',rightWidth:'Parts explorer',inspectorHeight:'Inspector'};
56
- const handles={} as Record<WorkspacePanel,HTMLElement>,dialogs={} as Record<WorkspacePanel,HTMLDialogElement>,buttons={} as Record<WorkspacePanel,HTMLButtonElement>,disposers:(()=>void)[]=[];
161
+ const handles={} as Record<WorkspacePanel,HTMLElement>,buttons={} as Record<WorkspacePanel,HTMLButtonElement>,disposers:(()=>void)[]=[];
57
162
  const present=Object.keys(panels) as WorkspacePanel[],node=(panel:WorkspacePanel)=>panels[panel]!;
58
163
  for(const panel of present){
59
164
  const handle=document.createElement('div');handle.className='workspace-separator workspace-'+panel+(sides[panel]?' workspace-side-'+sides[panel]:'');handles[panel]=handle;
@@ -64,15 +169,24 @@ export function bindWorkspaceUI(options:{changed:()=>void;defaultTheme:(theme:Wo
64
169
  const header=document.createElement('div');header.className='sticky-header workspace-drawer-header';const title=document.createElement('span');title.textContent=labels[panel];header.append(title,close);dialog.append(header);document.body.append(dialog);dialogs[panel]=dialog;
65
170
  disposers.push(bindWorkspaceDrawer({trigger,drawer:dialog,label:labels[panel],close}));
66
171
  }
67
- const memory=new InspectorScrollMemory();const active=():InspectorTab=>{const tab=selectedInspector() as InspectorTab|undefined;return tab&&tabs.includes(tab)?tab:tabs[0]!;};
172
+ const bottom=options.bottomPanel,bottomBody=bottom?inspector.querySelector<HTMLElement>('.inspector-body')!:null,bottomHeading=bottom?bottom.strip.parentElement!:null;
173
+ const bottomCollapseKey=bottom?`rig-review-bottom-collapsed/${bottom.kind}`:'';
174
+ let collapsed=false;
175
+ if(bottom){try{collapsed=localStorage.getItem(bottomCollapseKey)==='true';}catch{}}
176
+ const memory=new InspectorScrollMemory();const active=():InspectorTab=>{const tab=selectedInspector(scope) as InspectorTab|undefined;return tab&&tabs.includes(tab)?tab:tabs[0]!;};
68
177
  let disposed=false,frame=0,applying=false,available={width:0,height:0},effective=allocateWorkspaceLayout(available,desired,columns);
69
178
  const panelFor=(tab:InspectorTab)=>{const section=require('inspector-'+tab);return (typeof section.querySelector==='function'?section.querySelector<HTMLElement>('.animate-blocks-panel'):null)??section;};
70
179
  const userByTab=new Map<InspectorTab,boolean>(),extentByTab=new Map<InspectorTab,string>(),extentOf=(panel:HTMLElement)=>`${panel.scrollWidth}:${panel.scrollHeight}:${panel.clientWidth}:${panel.clientHeight}`;
71
- const capture=()=>{const tab=active(),section=require('inspector-'+tab),panel=panelFor(tab),saved=memory.snapshot()[tab];if(!section.hidden&&(!saved||saved.x<=Math.max(0,panel.scrollWidth-panel.clientWidth)&&saved.y<=Math.max(0,panel.scrollHeight-panel.clientHeight)))memory.capture(tab,panel,false);};
72
- const restore=()=>{if(disposed)return;const tab=active(),panel=panelFor(tab);if(panel.clientWidth>0||panel.clientHeight>0)extentByTab.set(tab,extentOf(panel));memory.restore(tab,panel);};
180
+ const capture=()=>{if(!tabs.length)return;const tab=active(),section=require('inspector-'+tab),panel=panelFor(tab),saved=memory.snapshot()[tab];if(!section.hidden&&(!saved||saved.x<=Math.max(0,panel.scrollWidth-panel.clientWidth)&&saved.y<=Math.max(0,panel.scrollHeight-panel.clientHeight)))memory.capture(tab,panel,false);};
181
+ const restore=()=>{if(disposed||!tabs.length)return;const tab=active(),panel=panelFor(tab);if(panel.clientWidth>0||panel.clientHeight>0)extentByTab.set(tab,extentOf(panel));memory.restore(tab,panel);};
73
182
  const schedule=()=>{if(!disposed&&!frame)frame=requestAnimationFrame(()=>{frame=0;apply();});};
74
183
  const dock=(panel:WorkspacePanel,drawer:boolean)=>{
75
184
  const element=node(panel),dialog=dialogs[panel],trigger=buttons[panel];trigger.hidden=!drawer;handles[panel].hidden=drawer;
185
+ if(bottom&&panel==='inspectorHeight'){
186
+ trigger.hidden=true;handles[panel].hidden=drawer||collapsed;
187
+ if(!drawer&&dialog.open)dialog.close();
188
+ const target=drawer?dialog:inspector;if(bottomBody!.parentElement!==target)target.append(bottomBody!);return;
189
+ }
76
190
  if(drawer&&element.parentElement!==dialog){const focus=element.contains(document.activeElement);dialog.append(element);if(focus)trigger.focus({preventScroll:true});}
77
191
  if(!drawer&&element.parentElement===dialog){const focused=element.contains(document.activeElement)||document.activeElement===trigger;if(dialog.open)dialog.close();trigger.setAttribute('aria-expanded','false');if(sides[panel]==='left')layout.prepend(element);else if(sides[panel]==='right')layout.append(element);else main.append(element);if(focused){element.tabIndex=-1;element.focus({preventScroll:true});}}
78
192
  };
@@ -88,11 +202,28 @@ export function bindWorkspaceUI(options:{changed:()=>void;defaultTheme:(theme:Wo
88
202
  for(const panel of present)dock(panel,mode(panel)==='drawer');
89
203
  const gap=workspaceMinimums.separator,side=(key:WorkspaceColumns['left'])=>key&&mode(key)==='panel'?{width:effective[key],separator:gap}:{width:0,separator:0},l=side(columns.left),r=side(columns.right);
90
204
  layout.style.setProperty('--workspace-columns',`${l.width}px ${l.separator}px minmax(0,1fr) ${r.separator}px ${r.width}px`);
91
- main.style.gridTemplateRows=`minmax(0,1fr) ${effective.inspectorMode==='panel'?gap:0}px ${effective.inspectorHeight}px`;
205
+ let bottomHeight=effective.inspectorHeight;
206
+ if(bottom){
207
+ const compact=collapsed||effective.inspectorMode==='drawer';bottomBody!.hidden=collapsed;
208
+ const actTarget=dialogs.inspectorHeight.open?bottom.actHome:bottomHeading!;if(bottom.act.parentElement!==actTarget)actTarget.append(bottom.act);
209
+ inspector.dataset.collapsed=String(compact);bottom.collapse.setAttribute('aria-expanded',String(!collapsed));bottom.collapse.textContent=tr(collapsed?'Expand bottom panel':'Collapse bottom panel');
210
+ if(compact)bottomHeight=bottomHeading!.getBoundingClientRect().height;
211
+ }
212
+ main.style.gridTemplateRows=`minmax(0,1fr) ${effective.inspectorMode==='panel'&&!collapsed?gap:0}px ${bottomHeight}px`;
92
213
  layout.dataset.stageMinimum=String(effective.stageMinimumSatisfied);for(const binding of bindings)binding.refresh();options.changed();restore();
93
214
  }finally{applying=false;}
94
215
  }
95
216
  const renderSettings=()=>{const value=store.get();setLanguagePreference(value.language);settingsToggle.setAttribute('aria-expanded',String(!value.settingsCollapsed));settingsBody.hidden=value.settingsCollapsed;settings.dataset.collapsed=String(value.settingsCollapsed);theme.value=options.currentTheme?.()??value.theme;language.value=getLinkLanguage()??value.language;sync.checked=value.defaultCameraSync;idle.checked=value.defaultIdleRepeat;status.textContent=tr(store.status().detail);};
217
+ const revealInspector=()=>{
218
+ if(bottom&&collapsed){collapsed=false;try{localStorage.setItem(bottomCollapseKey,'false');}catch{}apply();}
219
+ if(effective.inspectorMode==='drawer'&&!dialogs.inspectorHeight.open){for(const dialog of Object.values(dialogs))if(dialog.open)dialog.close();buttons.inspectorHeight.click();if(bottom)apply();}
220
+ };
221
+ if(bottom){
222
+ const closed=()=>{if(disposed)return;apply();bottom.strip.querySelector<HTMLButtonElement>('[aria-selected=true]')?.focus({preventScroll:true});};
223
+ dialogs.inspectorHeight.addEventListener('close',closed);
224
+ bottom.collapse.onclick=()=>{capture();collapsed=!collapsed;try{localStorage.setItem(bottomCollapseKey,String(collapsed));}catch{}if(dialogs.inspectorHeight.open)dialogs.inspectorHeight.close();apply();if(!collapsed)revealInspector();};
225
+ disposers.push(()=>{bottom.collapse.onclick=null;dialogs.inspectorHeight.removeEventListener('close',closed);});
226
+ }
96
227
  theme.onchange=()=>{store.update({theme:theme.value as WorkspaceTheme});options.defaultTheme(store.get().theme);};language.onchange=()=>{setLinkLanguage(null);store.update({language:language.value as WorkspaceLanguage});setLanguagePreference(store.get().language);};sync.onchange=()=>{store.update({defaultCameraSync:sync.checked});};idle.onchange=()=>{store.update({defaultIdleRepeat:idle.checked});};require<HTMLButtonElement>('settings-reset').onclick=()=>store.resetLayout();settingsToggle.onclick=()=>{store.update({settingsCollapsed:!store.get().settingsCollapsed});};
97
228
  bindDomI18n(document);const unsubscribe=store.subscribe(value=>{desired={...value.panels};renderSettings();schedule();});renderSettings();
98
229
  for(const tab of tabs){
@@ -110,7 +241,8 @@ export function bindWorkspaceUI(options:{changed:()=>void;defaultTheme:(theme:Wo
110
241
  }
111
242
  const observer=new ResizeObserver(schedule);observer.observe(layout);for(const node of [...stack.children])if(node!==stage)observer.observe(node);for(const tab of tabs)observer.observe(panelFor(tab));
112
243
  const resumed=()=>{if(!document.hidden)store.refresh();};document.addEventListener('visibilitychange',resumed);schedule();
113
- return {defaults:()=>store.get(),beforeTab:capture,afterTab:restore,scroll:()=>{capture();return JSON.stringify(memory.snapshot());},restoreScroll(value){if(typeof value!=='string')return;memory.replace(JSON.parse(value));restore();},revealInspector(){if(effective.inspectorMode==='drawer'&&!dialogs.inspectorHeight.open){for(const dialog of Object.values(dialogs))if(dialog.open)dialog.close();buttons.inspectorHeight.click();}},refresh:schedule,
114
- dispose(){if(disposed)return;capture();disposed=true;if(frame)cancelAnimationFrame(frame);observer.disconnect();document.removeEventListener('visibilitychange',resumed);unsubscribe();for(const binding of bindings)binding.dispose();for(const dispose of disposers)dispose();memory.dispose();store.dispose();}
244
+ return {defaults:()=>store.get(),beforeTab:capture,afterTab:restore,scroll:()=>{capture();return JSON.stringify(memory.snapshot());},restoreScroll(value){if(typeof value!=='string')return;memory.replace(JSON.parse(value));restore();},revealInspector,refresh:schedule,element:id=>require(id,true)??null,
245
+ async settle(){if(disposed)return;if(frame){cancelAnimationFrame(frame);frame=0;}apply();await new Promise<void>(resolve=>requestAnimationFrame(()=>requestAnimationFrame(()=>resolve())));if(!disposed)apply();},
246
+ dispose(){if(disposed)return;capture();disposed=true;if(frame)cancelAnimationFrame(frame);observer.disconnect();document.removeEventListener('visibilitychange',resumed);unsubscribe();for(const binding of bindings)binding.dispose();for(const dispose of disposers)dispose();for(const dialog of Object.values(dialogs)){if(dialog.open)dialog.close();dialog.remove();}memory.dispose();store.dispose();}
115
247
  };
116
248
  }
@@ -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);});
@@ -1,54 +0,0 @@
1
- import { readFile } from 'node:fs/promises';
2
- import { randomBytes } from 'node:crypto';
3
- import { appRoot, buildWeb } from './build.ts';
4
- import { createLiveLifecycle, LIVE_PATH } from './live-lifecycle.ts';
5
- import { interviewHeaders, interviewRoutes } from './interview-routes.ts';
6
-
7
- export async function startInterviewServer(root: string, output: string, port: number, exitOnClose = false) {
8
- const capability = randomBytes(32).toString('hex');
9
- const route = interviewRoutes(root, output, capability);
10
- const bundle = await buildWeb('interview');
11
- const [html, css] = await Promise.all(['interview.html','interview.css'].map(path => readFile(appRoot + 'web/' + path)));
12
- const live = createLiveLifecycle({label:'review interview', exitOnClose, stopServer:() => server.stop(true)});
13
- const server = Bun.serve({hostname:'127.0.0.1', port, websocket:live.websocket, async fetch(req, srv) {
14
- const origin = 'http://127.0.0.1:' + srv.port;
15
- const {pathname} = new URL(req.url);
16
- if (pathname === LIVE_PATH && req.method === 'GET') {
17
- if (req.headers.get('origin') !== origin) return new Response(null, {status:403});
18
- return live.upgrade(req, srv, interviewHeaders);
19
- }
20
- live.onRequestStart(pathname);
21
- try {
22
- const response = await route(req, origin);
23
- if (response) return response;
24
- const files = new Map([
25
- ['/', [html, 'text/html; charset=utf-8']],
26
- ['/interview.css', [css, 'text/css']],
27
- ['/interview.js', [bundle, 'text/javascript']],
28
- ] as const);
29
- const file = req.method === 'GET' ? files.get(pathname as '/' | '/interview.css' | '/interview.js') : undefined;
30
- return file ? new Response(file[0] as BodyInit, {headers:{...interviewHeaders,'Content-Type':file[1]}}) :
31
- new Response(null, {status:404, headers:interviewHeaders});
32
- } finally {live.onRequestEnd(pathname);}
33
- }});
34
- return {url:'http://127.0.0.1:' + server.port + '/#cap=' + capability, stop:() => {live.stop(); server.stop(true);}};
35
- }
36
-
37
- export const interviewUsage = 'Usage: rig-review interview <create-root> --picks-dir <project-relative directory> [--port <n>]';
38
- export async function interviewCommand(args: string[]) {
39
- if (!args.length || args[0] === '--help' || args[0] === '-h') {console.log(interviewUsage); return;}
40
- const root = args.shift()!;
41
- let output: string | undefined;
42
- let port: number | undefined;
43
- while (args.length) {
44
- const flag = args.shift();
45
- const value = args.shift();
46
- if (flag === '--picks-dir' && value && output === undefined) output = value;
47
- else if (flag === '--port' && value && /^\d+$/.test(value) && Number(value) <= 65535 && port === undefined) port = Number(value);
48
- else throw new Error(interviewUsage);
49
- }
50
- if (!output) throw new Error(interviewUsage);
51
- const running = await startInterviewServer(root, output, port ?? 4317, true);
52
- console.log(running.url);
53
- for (const signal of ['SIGINT', 'SIGTERM'] as const) process.once(signal, () => running.stop());
54
- }
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/' ? 'job-hub.html' : url.pathname === '/hub/job-hub.js' ? 'job-hub.js'
158
- : url.pathname === '/hub/job-hub.css' ? 'job-hub.css' : 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 === 'job-hub.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 === 'job-hub.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
- }