prts-terrarchive 0.2.0

package/ui/rhine/evidence-inbox.ts

@@ -0,0 +1,104 @@
+import type { ArchiveSource } from './types';
+import { SurfaceTransition } from './original/ui-transitions';
+import './evidence-inbox.css';
+
+export interface EvidenceInboxView { boardId:string; title:string; count:number; titles:string[] }
+export interface EvidenceInboxAnchor { x:number; y:number; visible:boolean }
+type Options = {
+  mutate(payload:Record<string,unknown>):Promise<unknown>;
+  read(source:ArchiveSource):void; notify(message:string):void;
+  scene(value:EvidenceInboxView,open:boolean):void;
+  ask?(boardId:string,title:string):Promise<void>;
+};
+const el=<K extends keyof HTMLElementTagNameMap>(tag:K,cls='',text='')=>{const n=document.createElement(tag);n.className=cls;n.textContent=text;return n;};
+const button=(cls:string,text:string,fn:()=>void)=>{const n=el('button',cls,text);n.type='button';n.onclick=fn;return n;};
+
+/** A board-owned staging queue. Opening a source and pinning a clue are separate actions. */
+export function mountEvidenceInbox(host:HTMLElement,options:Options){
+  let board:any=null,sources:any[]=[],active=false,opened=false,busy=false,disposed=false,selected='',page=0,editing=false;
+  let anchor:EvidenceInboxAnchor={x:0,y:0,visible:false},signature='';
+  const motion=matchMedia('(prefers-reduced-motion: reduce)'),events=new AbortController();
+  const entry=button('rhine-inbox-entry','',()=>open());entry.setAttribute('aria-label','打开重点证据盒');entry.setAttribute('aria-expanded','false');entry.hidden=true;
+  const entryLabel=el('span','','重点证据盒'),count=el('b','','00'),entryHint=el('small','','待整理 ↗');entry.append(entryLabel,count,entryHint);
+  const panel=el('section','rhine-inbox-panel');panel.hidden=true;panel.setAttribute('role','dialog');panel.setAttribute('aria-label','重点证据盒');panel.tabIndex=-1;
+  const header=el('header'),kicker=el('span','','EVIDENCE / 待整理'),close=button('rhine-inbox-close','返回调查板 ↗',()=>hide());header.append(kicker,close);
+  const content=el('div','rhine-inbox-content'),title=el('h2','','重点证据盒'),subtitle=el('p','rhine-inbox-subtitle');
+  const tools=el('div','rhine-inbox-tools'),filter=el('input','rhine-inbox-filter');filter.type='search';filter.placeholder='按标题或待核对问题查找';filter.setAttribute('aria-label','筛选重点证据');
+  const ask=button('rhine-inbox-ask','交给 Agent 整理 ↗',()=>{if(!board||!options.ask||busy)return;const target=board;busy=true;paint();void options.ask(target.id,target.title).then(()=>options.notify('已请 Agent 继续整理这块调查板的证据盒。')).catch(fail).finally(()=>{busy=false;paint();});});ask.hidden=!options.ask;
+  tools.append(filter,ask);
+  const list=el('div','rhine-inbox-list');list.setAttribute('role','list');
+  const pager=el('div','rhine-inbox-pager'),prev=button('','← 上一页',()=>{page--;renderList();}),next=button('','下一页 →',()=>{page++;renderList();}),pageText=el('span');pager.append(prev,pageText,next);
+  const details=el('div','rhine-inbox-details'),detailTitle=el('h3'),meta=el('p','rhine-inbox-meta'),note=el('p','rhine-inbox-note');
+  const actions=el('div','rhine-inbox-actions'),read=button('rhine-inbox-read','阅读原文 ↗',()=>{const source=currentSource();if(source)options.read({...source,id:source.sourceId} as ArchiveSource);}),promote=button('rhine-inbox-promote','整理上板 ＋',()=>edit()),remove=button('rhine-inbox-remove','移出',()=>{if(selected)void mutate({action:'remove',source_id:selected});});actions.append(read,promote,remove);details.append(detailTitle,meta,note,actions);
+  const form=el('form','rhine-inbox-form');form.hidden=true;
+  const heading=el('input');heading.maxLength=120;heading.required=true;heading.setAttribute('aria-label','线索标题');
+  const body=el('textarea');body.maxLength=12000;body.required=true;body.rows=5;body.setAttribute('aria-label','线索摘记');
+  const kind=el('select');kind.setAttribute('aria-label','线索款式');for(const [value,label]of [['excerpt','原文摘录'],['finding','研究发现'],['question','未解问题'],['contrast','交叉对照'],['relation','关键关联'],['time','时间节点']]){const o=el('option','',label);o.value=value;kind.append(o);}
+  const interpretation=el('select');interpretation.setAttribute('aria-label','核验状态');for(const [value,label]of [['question','待核验'],['observation','观察记录'],['inference','推断']]){const o=el('option','',label);o.value=value;interpretation.append(o);}
+  const formOptions=el('div','rhine-inbox-form-options');formOptions.append(kind,interpretation);
+  const submit=el('button','','保存线索并上板 ↗');submit.type='submit';const cancel=button('','取消',()=>{editing=false;paint();});
+  const formActions=el('div','rhine-inbox-actions');formActions.append(cancel,submit);
+  form.append(el('small','','整理成一条线索 · 原始来源会保留'),heading,body,formOptions,formActions);
+  form.onsubmit=event=>{event.preventDefault();if(!busy&&heading.value.trim()&&body.value.trim())void mutate({action:'promote',source_id:selected,title:heading.value,detail:body.value,kind:kind.value,interpretation:interpretation.value});};
+  content.append(title,subtitle,tools,list,pager,details,form);panel.append(header,content);host.append(entry,panel);
+  const transition=new SurfaceTransition(panel,content,280,220);
+  const pending=()=>board?.evidenceInbox?.filter((item:any)=>item.status==='pending')||[];
+  const currentItem=()=>pending().find((item:any)=>item.source_id===selected);
+  const currentSource=()=>sources.find(s=>s.id===selected);
+  function scene(){const items=pending();options.scene({boardId:board?.id||'',title:board?.title||'',count:items.length,titles:items.slice(0,6).map((item:any)=>sources.find(s=>s.id===item.source_id)?.title||'待整理资料')},opened&&active);}
+  function fail(error:any){if(!disposed)options.notify(error?.message||'证据盒同步失败，材料仍保留。');}
+  async function mutate(payload:Record<string,unknown>){
+    if(!board||busy)return;
+    const target=board.id;busy=true;paint();
+    try{const result:any=await options.mutate({board_id:target,expected_inbox_revision:board.inboxRevision,...payload});if(board?.id===target){editing=false;paint();}options.notify(result?.clue_id?'线索已放上证据板，原始资料仍可回查。':'已移出待整理区。');}
+    catch(error){fail(error);}finally{busy=false;paint();}
+  }
+  function renderList(){
+    const query=filter.value.trim().toLowerCase();const items=pending().filter((item:any)=>{const source=sources.find(s=>s.id===item.source_id);return !query||`${source?.title||''} ${item.note}`.toLowerCase().includes(query);});
+    page=Math.max(0,Math.min(page,Math.ceil(items.length/6)-1));list.replaceChildren();
+    if(!items.length)list.append(el('p','rhine-inbox-empty',query?'没有匹配的重点材料。':board?'暂时没有待整理的证据。\n可从检索阵列、档案架或原文页放入；Agent 也会挑选值得核对的资料。':'先选择或创建一块调查板，再收集重点证据。'));
+    for(const item of items.slice(page*6,page*6+6)){
+      const source=sources.find(s=>s.id===item.source_id),row=el('div','rhine-inbox-row');row.setAttribute('role','listitem');
+      const select=button('rhine-inbox-select','',()=>{selected=item.source_id;editing=false;paint();});select.dataset.sourceId=item.source_id;select.setAttribute('aria-pressed',String(item.source_id===selected));select.disabled=busy;
+      select.append(el('small','',`${item.addedBy==='user'?'手动选入':'Agent 筛选'} · ${source?.agentRead?'Agent 已读':'待核对原文'}`),el('strong','',source?.title||'资料暂不可用'),el('span','',item.note||'等待进一步核对与整理'));row.append(select);list.append(row);
+    }
+    prev.disabled=page===0||busy;next.disabled=(page+1)*6>=items.length||busy;pageText.textContent=`${items.length? page*6+1:0}–${Math.min((page+1)*6,items.length)} / ${items.length}`;pager.hidden=items.length<=6;
+  }
+  function edit(){const source=currentSource();if(!source)return;editing=true;heading.value=source.title.slice(0,120);body.value=(source.excerpt||currentItem()?.note||'').slice(0,12000);kind.value='excerpt';interpretation.value='question';paint();heading.focus();}
+  function paint(){
+    if(disposed)return;const items=pending();if(!items.some((item:any)=>item.source_id===selected)){selected=items[0]?.source_id||'';editing=false;}
+    count.textContent=String(items.length).padStart(2,'0');entry.setAttribute('aria-label',`打开重点证据盒，${items.length} 份待整理材料`);entry.title=board?`${board.title} · ${items.length} 份待整理`:'重点证据盒';
+    subtitle.textContent=board?`${board.title} · ${items.length} 份待整理材料`:'材料先暂存，整理后再上板';
+    ask.disabled=busy||!board||!items.length;filter.disabled=busy;
+    content.classList.toggle('is-editing',editing);renderList();const item=currentItem(),source=currentSource();details.hidden=!item||editing;form.hidden=!editing;
+    if(item){detailTitle.textContent=source?.title||'资料暂不可用';meta.textContent=`${({source:'资料',web:'网页',story:'剧情原文',wiki:'Wiki',entity:'实体资料'} as Record<string,string>)[source?.kind]||source?.kind||'资料'} · ${source?.origin==='web'?'联网来源':source?.origin==='cloud'?'云端资料':'本地资料'} · ${source?.agentRead?'Agent 已读':'仅有返回摘要'}`;note.textContent=item.note||source?.excerpt||'等待核对原文。';}
+    read.disabled=busy||!source;promote.disabled=busy||!source;remove.disabled=busy||!item;submit.disabled=cancel.disabled=heading.disabled=body.disabled=kind.disabled=interpretation.disabled=busy;
+    syncEntry();scene();
+  }
+  function syncEntry(){
+    entry.hidden=!active||opened;entry.setAttribute('aria-expanded',String(opened));
+    entry.classList.toggle('is-anchored',anchor.visible);entry.style.left=anchor.visible?`${anchor.x}px`:'';entry.style.top=anchor.visible?`${anchor.y}px`:'';
+  }
+  function open(){if(!active)return;opened=true;host.classList.add('has-evidence-inbox');transition.show(motion.matches);paint();close.focus({preventScroll:true});}
+  function hide(immediate=false){
+    opened=false;scene();
+    const done=()=>{host.classList.remove('has-evidence-inbox');syncEntry();if(active&&!immediate)entry.focus({preventScroll:true});};
+    if(immediate){transition.dispose();panel.hidden=true;delete panel.dataset.transition;done();}else transition.hide(motion.matches,done);
+  }
+  function handleKeydown(event:KeyboardEvent){
+    if(panel.hidden||!active||event.isComposing)return false;
+    if(event.key==='Escape'){event.preventDefault();if(panel.dataset.transition!=='closing'){if(editing){editing=false;paint();promote.focus();}else hide();}return true;}
+    if(event.key==='Tab'){const focusable=[...panel.querySelectorAll<HTMLElement>('button:not(:disabled),input:not(:disabled),textarea:not(:disabled),select:not(:disabled)')].filter(n=>n.getClientRects().length);const first=focusable[0],last=focusable.at(-1);if(first&&(!panel.contains(document.activeElement)||event.shiftKey&&document.activeElement===first||!event.shiftKey&&document.activeElement===last)){event.preventDefault();(event.shiftKey?last!:first).focus();}return true;}
+    return panel.contains(event.target as Node);
+  }
+  motion.addEventListener('change',()=>{if(motion.matches)transition.finish();},{signal:events.signal});
+  filter.oninput=()=>{page=0;renderList();};
+  return {open,hide,handleKeydown,isOpen:()=>opened,
+    setData(value:any,rows:any[]){const next=JSON.stringify([value?.id,value?.title,value?.inboxRevision,rows.map(s=>[s.id,s.title,s.agentRead])]);const changed=board?.id!==value?.id;board=value;sources=rows;if(changed){selected='';page=0;editing=false;filter.value='';hide(true);}if(signature!==next){signature=next;paint();}},
+    setActive(value:boolean){active=value;if(!active)hide(true);syncEntry();},
+    setAnchor(value:EvidenceInboxAnchor){anchor=value;syncEntry();},
+    state(){return{boardId:board?.id||'',title:board?.title||'',count:pending().length,titles:pending().slice(0,6).map((item:any)=>sources.find(s=>s.id===item.source_id)?.title||'待整理资料')};},
+    stats(){return{open:opened,count:pending().length,boardId:board?.id||'',selected,editing,busy};},
+    dispose(){disposed=true;transition.dispose();events.abort();host.classList.remove('has-evidence-inbox');entry.remove();panel.remove();}
+  };
+}

package/ui/rhine/index.ts

@@ -0,0 +1,12 @@
+import './workbench.css'
+import './evidence-board.css'
+import './evidence-board-controls.css'
+import './readability.css'
+import './reading-room.css'
+import './source-selection.css'
+import './manual-search.css'
+import './interaction.css'
+export { mountRhineWorkbench } from './workbench'
+export { createRhineScene } from './scene'
+export type * from './types'
+export const RUNTIME_ABI = 1

package/ui/rhine/interaction.css

@@ -0,0 +1,20 @@
+/* Interaction controls share the transparent HUD surface. */
+.rhine-workbench [data-layout] .rhine-follow-controls{display:flex;align-items:center;justify-content:space-between;gap:16px;margin:10px 0;color:#727963;font-size:11px;line-height:1.5}
+.rhine-workbench [data-layout] .rhine-follow-toggle{color:#4b5c3c;font-size:12px;min-height:30px;white-space:nowrap}
+.rhine-workbench [data-layout] .rhine-evidence-target{display:flex;align-items:center;gap:10px;min-width:0;margin:8px 0;font-size:11px;line-height:1.5;color:#737965;background:transparent;flex:none}
+.rhine-workbench [data-layout] .rhine-evidence-target>span{flex:none}
+.rhine-workbench [data-layout] .rhine-evidence-target select{min-width:0;max-width:100%;flex:1;background:transparent;color:#4f5c42;border:0;border-bottom:1px solid #7c81643d;border-radius:0;padding:5px 18px 5px 0;font:inherit;text-overflow:ellipsis;cursor:pointer}
+.rhine-workbench [data-layout] .rhine-evidence-target select:focus-visible{outline:1px solid #7a845e;outline-offset:2px}
+.rhine-workbench [data-layout] .rhine-evidence-target option{background:#eeece5;color:#30382d}
+.rhine-workbench [data-layout] .rhine-evidence-target select:disabled{opacity:.55;cursor:wait}
+.rhine-workbench [data-layout] .rhine-agent-board-context{font-size:10px;color:#7b806d;overflow:hidden;white-space:nowrap;text-overflow:ellipsis;margin-top:6px;line-height:1.5}
+.rhine-workbench [data-layout] .rhine-shelf-current .rhine-evidence-target{margin-bottom:0}
+.rhine-workbench [data-layout] .rhine-reader .rhine-evidence-target{margin:5px 0}
+.rhine-workbench [data-layout] .rhine-index-modal>.rhine-evidence-target{margin:0 0 8px}
+@media(max-width:650px){.rhine-workbench [data-layout] .rhine-follow-controls{gap:8px;margin:5px 0}.rhine-workbench [data-layout] .rhine-evidence-target{gap:6px;font-size:10px}}
+
+.rhine-workbench [data-layout=compact] .rhine-desk-panel{top:120px}
+.rhine-workbench [data-layout=compact] .rhine-desk-panel>.rhine-rack-intro{display:none}
+.rhine-workbench [data-layout=compact] .rhine-desk-panel h2{margin:6px 0}
+.rhine-workbench [data-layout=portrait] .rhine-desk-panel{top:210px}
+.rhine-workbench [data-layout=portrait] .rhine-desk-panel>.rhine-rack-intro{display:none}

package/ui/rhine/investigation-board-plane.ts

@@ -0,0 +1,5 @@
+/** Shared board-local rectangle for the interactive print, at 100 CSS pixels per world unit. */
+export const INVESTIGATION_BOARD_PLANE = {
+  left: -7.75, top: 4.45, width: 15.5, height: 8.7, z: 0.181,
+  pixelWidth: 1550, pixelHeight: 870,
+} as const;

package/ui/rhine/investigation-board.css

@@ -0,0 +1,34 @@
+/* Coordinates are printed on the board at 100px per world unit; the camera supplies the perspective. */
+.rhine-investigation-hud{position:absolute;left:0;top:0;z-index:8;transform-origin:0 0;transition:none;pointer-events:none;color:#343a2e;overflow:hidden}
+.rhine-investigation-heading{position:absolute;left:30px;top:12px;width:1080px;height:56px;box-sizing:border-box;padding:6px 18px;display:flex;align-items:center;gap:16px;pointer-events:auto;font-size:18px;white-space:nowrap}
+.rhine-investigation-index{display:flex;flex-direction:column;gap:3px;flex:none;width:172px;border-right:1px solid #96958055;color:#5f6155}
+.rhine-investigation-index b{font-size:20px;font-weight:550;letter-spacing:.025em}.rhine-investigation-index small{font-size:11px;letter-spacing:.07em;color:#828371}
+.rhine-investigation-picker{flex:1;min-width:0;border:0;border-bottom:1px solid #9b9a8766;background:transparent;color:#33392d;font:inherit;font-size:22px;padding:5px 6px;text-overflow:ellipsis}
+.rhine-investigation-picker option{background:#eeece3;color:#33392d}
+.rhine-investigation-heading button,.rhine-investigation-footer button{flex:none;border:0;background:transparent;color:inherit;font:inherit;cursor:pointer;padding:6px}
+.rhine-investigation-heading button:hover,.rhine-investigation-footer button:hover{color:#8c764b}
+.rhine-investigation-heading button:disabled,.rhine-investigation-footer button:disabled{opacity:.4;cursor:default}
+.rhine-investigation-heading :focus-visible,.rhine-investigation-footer button:focus-visible{outline:1px solid #878f72;outline-offset:3px}
+.rhine-investigation-status{margin-left:auto;color:#747b65;font-size:16px;max-width:260px;overflow:hidden;text-overflow:ellipsis}
+.rhine-investigation-follow{color:#866b39!important;border-bottom:1px solid #ad9b75!important}
+.rhine-investigation-footer{position:absolute;left:45px;right:45px;bottom:16px;height:24px;display:flex;align-items:center;gap:22px;font-size:16px;color:#727969;pointer-events:auto}
+.rhine-investigation-footer button{padding:0 6px}
+.rhine-investigation-hud [hidden]{display:none}
+.rhine-investigation-hint{margin-right:auto;letter-spacing:.04em}
+.rhine-investigation-empty{position:absolute;left:345px;top:320px;width:860px;pointer-events:none}
+.rhine-investigation-empty small{font-size:15px;letter-spacing:.16em;color:#8c907e}
+.rhine-investigation-empty h2{font-size:40px;font-weight:450;line-height:1.5;margin:22px 0}
+.rhine-investigation-empty p{font-size:21px;line-height:2;color:#818675;max-width:790px;margin:0}
+.rhine-investigation-drawer{position:absolute;right:3%;top:16%;bottom:17%;width:min(385px,40%);z-index:35;padding:24px;box-sizing:border-box;background:rgba(243,241,233,.94);backdrop-filter:blur(14px);border-left:1px solid #a9ab9855;box-shadow:-12px 0 40px #77715b0c;color:#333a2e;overflow:auto;scrollbar-width:thin;scrollbar-color:#979c8666 transparent}
+.rhine-investigation-drawer-top{display:flex;justify-content:space-between;align-items:center;gap:12px;border-bottom:1px solid #b3b09c66;padding-bottom:18px}.rhine-investigation-drawer-top small{font-size:10px;letter-spacing:.08em}
+.rhine-investigation-drawer button,.rhine-investigation-report button{cursor:pointer;background:transparent;border:0;color:#626f50;font:inherit;padding:8px 0;text-align:left}
+.rhine-investigation-drawer h2{font-size:23px;line-height:1.6;font-weight:500}.rhine-investigation-drawer h3{font-size:12px;font-weight:500;margin-top:28px;letter-spacing:.05em}.rhine-investigation-clue-text{white-space:pre-wrap;font-size:14px;line-height:1.9;overflow-wrap:anywhere}
+.rhine-investigation-provenance{font-size:10px;color:#899077;margin:12px 0 24px}.rhine-investigation-source{display:block;width:100%;padding:14px 0!important;border-bottom:1px solid #bcbba566!important;white-space:pre-line;line-height:1.7!important;font-size:12px!important;overflow-wrap:anywhere}.rhine-investigation-drawer blockquote{margin:14px 0;border-left:2px solid #969c7a;padding-left:14px;font-size:13px;line-height:1.8}
+.rhine-investigation-drawer input,.rhine-investigation-drawer textarea{box-sizing:border-box;width:100%;margin-top:18px;padding:12px;border:1px solid #a9ad9988;background:#f8f7f166;color:inherit;font:inherit}.rhine-investigation-drawer textarea{min-height:250px;font-size:11px}
+.rhine-investigation-report{position:absolute;inset:14% 10% 13% 24%;z-index:45;padding:30px 44px;box-sizing:border-box;background:rgba(246,244,237,.96);backdrop-filter:blur(18px);color:#2c3327;border-top:1px solid #a5ab9455;overflow:auto;scrollbar-width:thin;scrollbar-color:#969c8266 transparent;box-shadow:0 18px 65px #615f3b14}
+.rhine-investigation-report header{display:flex;align-items:center;justify-content:space-between;gap:16px;font-size:11px;color:#838971;flex-wrap:wrap}.rhine-investigation-report select{border:0;background:transparent;color:inherit;max-width:50%;font:inherit}.rhine-investigation-report h2{font-size:28px;line-height:1.5;font-weight:550;margin:30px 0 15px}.rhine-investigation-report-notice{font-size:11px;color:#899078;padding-bottom:20px;border-bottom:1px solid #aeae9555}.rhine-investigation-report .rhine-report-body{display:block;max-height:none;height:auto;overflow:visible;padding:12px 0;font-size:15px;line-height:1.95}.rhine-investigation-report-evidence{border-top:1px solid #b1b29b55;margin-top:36px;padding-top:20px;font-size:12px}.rhine-investigation-report-evidence p{white-space:pre-line}
+.rhine-investigation-hud[hidden],.rhine-investigation-drawer[hidden],.rhine-investigation-report[hidden]{display:none}
+@media(max-width:900px){.rhine-investigation-drawer{right:4%;width:60%;top:24%;bottom:15%}.rhine-investigation-report{inset:18% 4% 12%;padding:22px}}
+@media(prefers-reduced-motion:no-preference){.rhine-investigation-drawer,.rhine-investigation-report{animation:investigation-arrive .24s ease-out}@keyframes investigation-arrive{from{opacity:0;transform:translateY(-7px)}to{opacity:1;transform:none}}}
+
+.rhine-workbench .rhine-evidence-panel>.rhine-evidence-kicker,.rhine-workbench .rhine-evidence-panel>.rhine-evidence-heading,.rhine-workbench .rhine-evidence-panel>.rhine-evidence-count{display:none}

package/ui/rhine/investigation-board.ts

@@ -0,0 +1,348 @@
+import { mountEvidenceInbox, type EvidenceInboxView, type EvidenceInboxAnchor } from './evidence-inbox';
+import { READING_ENTER_MS, READING_RETURN_MS, READING_FADE_EASING, readingFrameTime, type ReadingObject } from './reading-object';
+import { SurfaceTransition } from './original/ui-transitions';
+import { createPreviewCards, evidenceStorageKey, parseEvidenceCards, type EvidenceCard } from './evidence-board-model';
+import { investigationPositions, investigationClueIndex } from './investigation-layout';
+import { renderReportMarkdown } from './report-markdown';
+import type { ArchiveSource, BoardAnchorFrame } from './types';
+import { boardPlaneTransform } from './board-plane-transform';
+import { INVESTIGATION_BOARD_PLANE } from './investigation-board-plane';
+import { InvestigationEditRevisions } from './investigation-edits';
+import { referenceSource } from './source-reading';
+import './investigation-board.css';
+
+type Panel = { closeTools():void; getCards(): EvidenceCard[]; remapIds(mapping:Record<string,string>,revisions?:Record<string,{content_revision:number;layout_revision:number}>):void; replaceCards(cards: EvidenceCard[], reset?: boolean): void; select(id: string | null, edit?: boolean): void };
+export interface InvestigationContext {
+  sessionId: string;
+  boards: { id: string; title: string }[];
+  selectedId: string;
+  workingId: string;
+  ready: boolean;
+}
+type Options = { onContext?(value: InvestigationContext): void; onRackRevision?(revision:number):void; sessionId: string; api(endpoint: string, payload?: any, signal?: AbortSignal): Promise<any>;
+  panel: Panel; onInbox(value:EvidenceInboxView,open:boolean):void; askInbox?(boardId:string,title:string):Promise<void>; onReading(value: ReadingObject | null): void; onCards(cards: EvidenceCard[]): void; openSource(source: ArchiveSource, inbox?:boolean): void; notify(text: string): void };
+const REPORT_ID = 'investigation-report';
+const labels: Record<string, string> = { excerpt: '原文摘录', finding: '研究发现', time: '时间节点', relation: '关键关联', question: '未解问题', contrast: '交叉对照' };
+const uid = () => crypto.randomUUID();
+const clueSlot = investigationClueIndex;
+const pageCount = (board:any) => Math.max(1,...activeClues(board).map((c:any)=>Math.floor(clueSlot(c)/12)+1));
+const same = (a: any, b: any) => JSON.stringify(a) === JSON.stringify(b);
+const activeClues = (board: any) => (board?.clues || []).filter((c: any) => !['superseded','retracted'].includes(c.status));
+const el = <K extends keyof HTMLElementTagNameMap>(tag: K, className: string, text?: string) => { const n = document.createElement(tag); n.className = className; if (text !== undefined) n.textContent = text; return n; };
+
+/** The viewed board is a browser preference; only investigation_open binds agent work. */
+export function mountInvestigationBoard(host: HTMLElement, options: Options) {
+  let sessionId = options.sessionId, board: any = null, catalog: any[] = [], sourceRows: any[] = [];
+  let selectedId = '', workingId = '', followWorking = true, page = 0, commitSeq = 0, disposed = false, active = false;
+  let contextReady = false;
+  let syncing = false, saving = 0, refreshPending = false, loadEpoch = 0, loading = false;
+  let baseline: EvidenceCard[] = [], sceneCards: EvidenceCard[] = [];
+  let edits = new InvestigationEditRevisions(), pendingReset = false;
+  let editTarget = { boardId: '' };
+  let aborter = new AbortController(), queue = Promise.resolve(), inboxStageQueue = Promise.resolve();
+  const events = new AbortController();
+  const hud = el('section', 'rhine-investigation-hud'); hud.hidden = true;
+  hud.style.width = `${INVESTIGATION_BOARD_PLANE.pixelWidth}px`;
+  hud.style.height = `${INVESTIGATION_BOARD_PLANE.pixelHeight}px`;
+  let planeVisible = false;
+  function setBoardFrame(frame: BoardAnchorFrame) {
+    const transform = frame.visible && frame.surface.every(point => point.visible)
+      ? boardPlaneTransform(frame.surface, INVESTIGATION_BOARD_PLANE.pixelWidth, INVESTIGATION_BOARD_PLANE.pixelHeight) : null;
+    planeVisible = Boolean(transform);
+    if (transform) hud.style.transform = transform;
+    hud.hidden = !active || !planeVisible;
+  }
+  const header = el('div', 'rhine-investigation-heading');
+  const index = el('span','rhine-investigation-index');
+  index.append(el('b','','RHINE LAB'),el('small','','RESEARCH / 研究调查'));
+  const picker = el('select','rhine-investigation-picker'); picker.setAttribute('aria-label','切换调查板');
+  const status = el('span','rhine-investigation-status'); status.setAttribute('role','status');
+  const follow = el('button','rhine-investigation-follow','查看工作板 ↗'); follow.type='button'; follow.hidden=true;
+  const directory = el('button','rhine-investigation-directory','线索目录 ↗'); directory.type='button';
+  const add = el('button','rhine-investigation-add','＋ 手动建板'); add.type='button';
+  header.append(index,picker,status,follow,directory,add); hud.append(header);
+  const footer=el('div','rhine-investigation-footer');
+  const previous=el('button','','←'), next=el('button','','→'), paging=el('span','','');
+  previous.type=next.type='button'; previous.setAttribute('aria-label','上一组线索'); next.setAttribute('aria-label','下一组线索');
+  const hint=el('span','rhine-investigation-hint','重要线索随调查加入 · 点击阅读，双击编辑'); footer.append(hint,previous,paging,next);hud.append(footer);
+  const empty=el('div','rhine-investigation-empty'); empty.append(el('small','','RESEARCH / READY'),el('h2','','从一个值得调查的问题开始'),el('p','','Agent 会在这里整理重要线索，并在中央留下报告。追问可以延续同一块板。'));hud.append(empty);
+  const drawer=el('aside','rhine-investigation-drawer');drawer.hidden=true;drawer.setAttribute('aria-label','线索详情');
+  const drawerTop=el('div','rhine-investigation-drawer-top'), close=el('button','','返回调查板 ↗');close.type='button';
+  const drawerLabel=el('small','','');drawerTop.append(drawerLabel,close);const drawerBody=el('div','rhine-investigation-drawer-body');drawer.append(drawerTop,drawerBody);
+  const report=el('section','rhine-investigation-report');report.hidden=true; report.setAttribute('role','dialog');report.setAttribute('aria-label','调查报告');report.tabIndex=-1;
+  const reportHeader=el('header',''), reportLabel=el('span','','RESEARCH REPORT / 调查报告'), versions=el('select','');versions.setAttribute('aria-label','报告版本');
+  const reportClose=el('button','','返回调查板 ↗');reportClose.setAttribute('aria-keyshortcuts','Escape');reportClose.type='button';reportHeader.append(reportLabel,versions,reportClose);
+  const reportTitle=el('h2','',''), reportNotice=el('p','rhine-investigation-report-notice'),reportArticle=el('article','rhine-report-body');
+  const reportIntro=el('div','rhine-investigation-report-intro');reportIntro.append(reportTitle,reportNotice);
+  const reportScroll=el('div','rhine-investigation-report-scroll');reportScroll.tabIndex=0;reportScroll.append(reportIntro,reportArticle);
+  report.append(reportHeader,reportScroll);host.append(hud,drawer,report);
+  const motion=window.matchMedia('(prefers-reduced-motion: reduce)');
+  const readingTransitions=new Map([[report,new SurfaceTransition(report,undefined,READING_ENTER_MS,READING_RETURN_MS,READING_FADE_EASING,READING_FADE_EASING,true)],
+    [drawer,new SurfaceTransition(drawer,undefined,READING_ENTER_MS,READING_RETURN_MS,READING_FADE_EASING,READING_FADE_EASING,true)]]);
+  let enterStartedAt:number|undefined,returnStartedAt:number|undefined;
+  const inbox=mountEvidenceInbox(host,{
+    scene:options.onInbox,notify:options.notify,ask:options.askInbox,
+    read:source=>options.openSource(source,true),
+    async mutate(payload){const currentSession=sessionId;try{const result=await request('inbox',{mutation_id:uid(),...payload});if(sessionId===currentSession)await refresh();return result;}catch(error){if(sessionId===currentSession)await refresh().catch(()=>{});throw error;}}
+  });
+
+  function syncReading(){
+    options.onReading(!active?null:!report.hidden?{title:reportTitle.textContent||'调查报告',code:`REPORT / V${versions.value}`,kind:'report',enterStartedAt,returnStartedAt}:!drawer.hidden?{title:drawerBody.querySelector('h2')?.textContent||drawerLabel.textContent||'线索记录',code:drawerLabel.textContent?.split(' / ')[0]||'EVIDENCE',kind:'clue',enterStartedAt,returnStartedAt}:null);
+  }
+  function showReading(layer:HTMLElement){
+    if(layer.hidden||!layer.dataset.transition){
+      enterStartedAt=readingFrameTime();readingTransitions.get(layer)!.show(motion.matches);
+    }
+    syncReading();
+  }
+  const visibility=new MutationObserver(()=>{
+    // Hiding a layer to open a source or leave the board must cancel its entrance,
+    // otherwise its completion callback would make the old report visible again.
+    for(const [layer,transition]of readingTransitions)if(layer.hidden){transition.dispose();delete layer.dataset.transition;}
+    syncReading();
+  });visibility.observe(report,{attributes:true,attributeFilter:['hidden']});visibility.observe(drawer,{attributes:true,attributeFilter:['hidden']});
+  function cancelReturn(){
+    if(returnStartedAt===undefined)return;
+    returnStartedAt=undefined;
+    for(const [layer,transition]of readingTransitions){transition.dispose();delete layer.dataset.transition;layer.removeAttribute('aria-busy');}
+  }
+  function closeReading(){
+    if(returnStartedAt!==undefined)return;
+    const layer=!report.hidden?report:!drawer.hidden?drawer:null;if(!layer)return;
+    returnStartedAt=readingFrameTime();layer.setAttribute('aria-busy','true');syncReading();
+    readingTransitions.get(layer)!.hide(motion.matches,()=>{
+      report.hidden=true;drawer.hidden=true;returnStartedAt=undefined;layer.removeAttribute('aria-busy');syncReading();
+      if(active&&!disposed)(picker.hidden?add:picker).focus({preventScroll:true});
+    });
+  }
+  motion.addEventListener('change',()=>{if(motion.matches)for(const transition of readingTransitions.values())transition.finish();},{signal:events.signal});
+  function handleKeydown(event:KeyboardEvent){
+    if(inbox.handleKeydown(event))return true;
+    const layer=!report.hidden?report:!drawer.hidden?drawer:null;if(!active||!layer||event.isComposing)return false;
+    if(returnStartedAt!==undefined){event.preventDefault();return true;}
+    if(event.key==='Escape'){event.preventDefault();closeReading();return true;}
+    if(event.key==='Tab'){
+      const focusable=[...layer.querySelectorAll<HTMLElement>('button:not(:disabled),a[href],input,textarea,select,summary,[tabindex="0"]')].filter(n=>n.getClientRects().length&&!n.closest('[hidden]'));
+      const first=focusable[0],last=focusable.at(-1);
+      if(first&&(!layer.contains(document.activeElement)||event.shiftKey&&document.activeElement===first||!event.shiftKey&&document.activeElement===last)){event.preventDefault();(event.shiftKey?last!:first).focus();}
+    }
+    return layer.contains(event.target as Node)||event.key==='Tab';
+  }
+  const preference=()=>`prts-investigation-view:${encodeURIComponent(sessionId)}`;
+  function request(endpoint: string, payload: any = {}, signal=aborter.signal) { return options.api(`investigation.${endpoint}`,{ session_id:sessionId,...payload },signal); }
+  function fail(error: any) { if (disposed || error?.name==='AbortError' || aborter.signal.aborted) return; loading=false;render();status.textContent='同步未完成'; options.notify(error?.message || '调查板暂时无法同步，请稍后重试'); }
+  function sourceFor(ref: any): ArchiveSource | null {
+    const s=sourceRows.find(s=>s.id===ref.source_id);if(!s)return null;
+    return referenceSource({ ...s,id:s.sourceId,excerpt:s.excerpt||'',state:s.state } as ArchiveSource,ref);
+  }
+  function toCards(): EvidenceCard[] {
+    const clues=activeClues(board), offset=page*12, positions=investigationPositions(board?.clues || []);
+    return clues.filter((c:any)=>clueSlot(c)>=offset&&clueSlot(c)<offset+12).map((c:any)=>{
+      const i=clueSlot(c)%12;
+      const source=sourceRows.find(s=>s.id===c.sources[0]?.source_id);
+      const position=positions.get(c.id)||{x:0,y:2.65};
+      return {id:c.id,contentRevision:c.contentRevision,layoutRevision:c.layoutRevision,title:c.title,body:c.detail||c.summary,summary:c.summary,clueKind:c.kind,variant:c.variant,
+        evidenceLabel:c.interpretation==='inference'?'推断':c.kind==='question'?'待核验':c.sources.some((r:any)=>!sourceRows.find(s=>s.id===r.source_id)?.agentRead)?'含检索摘要':'已核对来源',
+        kind:c.kind==='question'?'question':c.kind==='excerpt'?'source':'note',stage:c.status==='unresolved'?0:c.importance==='key'?2:1,
+        position:c.position||position,rotation:c.rotation??[-1.6,.9,-.7][c.variant ?? i%3],scale:c.scale||1,
+        sourceId:source?.sourceId,sourceTitle:source?.title,
+        sourceLabel:[...new Set(c.sources.map((r:any)=>r.source_id))].join(' · '),
+        relationKinds:Object.fromEntries(board.relations.filter((r:any)=>r.from===c.id).map((r:any)=>[r.to,r.type])),
+        links:board.relations.filter((r:any)=>r.from===c.id).map((r:any)=>r.to)};
+    });
+  }
+  function renderCards(reset=false) {
+    if(saving){refreshPending=true;return;}
+    baseline=toCards();edits.observe(board?.clues||[]);
+    syncing=true;options.panel.replaceCards(baseline,reset);syncing=false;
+    const latest=board?.reports.at(-1), running=catalog.find(b=>b.id===selectedId)?.run?.status==='running';
+    sceneCards=board?[{id:REPORT_ID,title:latest?.title||(running?'调查进行中':'等待调查报告'),body:latest?.summary||'重要线索正在汇入，报告将在调查完成后发布。',kind:'note',stage:2,clueKind:'report',
+      evidenceLabel:latest?`REPORT / V${String(latest.version).padStart(2,'0')}`:'RESEARCH / IN PROGRESS',sourceLabel:`${activeClues(board).length} 条线索 · ${latest?.sources?.length || 0} 份来源`,position:{x:0,y:0},rotation:0,scale:1},...baseline]:[];
+    options.onCards(sceneCards);
+  }
+  function getContext(): InvestigationContext {
+    return { sessionId, boards: catalog.map(({id,title})=>({id,title})), selectedId, workingId, ready: contextReady };
+  }
+  function holdReadingContext() {
+    // A source detour must return to the same board even if the agent starts another investigation.
+    followWorking=false;
+    try { if(selectedId)localStorage.setItem(preference(),selectedId); } catch {}
+  }
+  function render() {
+    options.onContext?.(getContext());
+    inbox.setData(board,sourceRows);
+    const value=selectedId;picker.replaceChildren();
+    for(const row of catalog){const option=el('option','',`${row.title} · ${row.clueCount} 条线索`);option.value=row.id;picker.append(option);}picker.value=value;
+    picker.disabled=!catalog.length||!!saving||loading;picker.hidden=!catalog.length;empty.hidden=!!board;directory.disabled=!board;
+    follow.disabled=add.disabled=!!saving||loading;
+    follow.hidden=!workingId||workingId===selectedId;
+    const row=catalog.find(b=>b.id===selectedId),latest=board?.reports.at(-1);
+    status.textContent=saving?'正在保存…':loading?'正在同步…':!board?'尚无调查':row?.run?.status==='running'?'● Agent 正在整理':row?.run?.status==='interrupted'?'已暂停 · 线索已保留':latest?`报告 V${latest.version}${row?.reportStale?' · 有新线索待更新':''}`:'线索已保存';
+    const pages=pageCount(board);previous.disabled=page===0||!!saving||loading;next.disabled=page>=pages-1||!!saving||loading;
+    paging.textContent=`${page+1} / ${pages}  ·  ${activeClues(board).length} 条线索`;footer.hidden=!board;
+  }
+  async function refresh(reset=false) {
+    pendingReset ||= reset;
+    if(disposed||saving){refreshPending=true;return;}
+    const epoch=++loadEpoch;loading=true;render();
+    const directory=await request('get',{limit:128});if(disposed||epoch!==loadEpoch)return;
+    // Only the catalog snapshot may advance the watch cursor; a newer board read can race a catalog change.
+    catalog=directory.boards;workingId=directory.workingBoardId||'';commitSeq=directory.commitSeq;
+    options.onRackRevision?.(directory.rackRevision || 0);
+    const oldId=board?.id||'';
+    if(followWorking&&workingId)selectedId=workingId;
+    if(!catalog.some(b=>b.id===selectedId))selectedId=workingId||catalog[0]?.id||'';
+    let result:any=null;
+    if(selectedId){result=await request('get',{board_id:selectedId});if(disposed||epoch!==loadEpoch)return;}
+    if(oldId!==selectedId){
+      // Flush against the still-mounted board before replacing its editor.
+      options.panel.closeTools();
+      if(saving){pendingReset=true;refreshPending=true;loading=false;render();return;}
+      cancelReturn();page=0;drawer.hidden=true;report.hidden=true;edits=new InvestigationEditRevisions();editTarget={boardId:selectedId};
+    }
+    if(saving){refreshPending=true;loading=false;return;}
+    board=result?.board||null;sourceRows=result?.sources||[];
+    page=Math.min(page,pageCount(board)-1);loading=false;contextReady=true;
+    const resetCards=pendingReset||oldId!==selectedId;pendingReset=false;renderCards(resetCards);render();
+  }
+  async function loop(generation: AbortController) {
+    while(!disposed&&!generation.signal.aborted){
+      try{if(saving){await queue;continue;}const value=await request('watch',{after:commitSeq},generation.signal);if(generation!==aborter)return;if(value.commitSeq>commitSeq)await refresh();}
+      catch(error){if(generation.signal.aborted||disposed)return;status.textContent='连接暂断 · 保留当前内容';await new Promise<void>(resolve=>{const timer=setTimeout(resolve,3000);generation.signal.addEventListener('abort',()=>{clearTimeout(timer);resolve();},{once:true});});if(generation.signal.aborted||disposed)return;try{await refresh();}catch{}}
+    }
+  }
+  function showClue(id:string) {
+    cancelReturn();inbox.hide(true);
+    const clue=board?.clues.find((c:any)=>c.id===id);if(!clue)return;
+    options.panel.closeTools();options.panel.select(id,false);report.hidden=true;
+    drawerLabel.textContent=`${clue.id} / ${labels[clue.kind]}`;drawerBody.replaceChildren();
+    drawerBody.append(el('h2','',clue.title),el('p','rhine-investigation-provenance',`${clue.interpretation==='inference'?'推断':clue.interpretation==='question'?'待核验':'观察'} · ${clue.editedBy==='user'?'用户整理':'Agent 整理'}`));
+    const content=el('div','rhine-investigation-clue-text rhine-markdown');renderReportMarkdown(content,clue.detail||clue.summary);drawerBody.append(content);
+    const edit=el('button','','编辑这条线索 ↗');edit.type='button';edit.onclick=()=>{drawer.hidden=true;options.panel.select(id,true);};drawerBody.append(edit);
+    drawerBody.append(el('h3','','来源与核验'));
+    for(const ref of clue.sources){const source=sourceFor(ref);if(!source)continue;const button=el('button','rhine-investigation-source',`${source.agentRead?'已读':'检索摘要'} · ${source.title} ↗`);button.type='button';button.onclick=()=>options.openSource(source);drawerBody.append(button);if(ref.quote)drawerBody.append(el('blockquote','',ref.quote));}
+    if(!clue.sources.length)drawerBody.append(el('p','','尚无来源，不能作为已核实结论。'));
+    const relations=board.relations.filter((r:any)=>r.from===id||r.to===id);
+    if(relations.length){
+      drawerBody.append(el('h3','','关联线索'));
+      const names:Record<string,string>={supports:'支持',contradicts:'存在矛盾',precedes:'时间在先',relates:'相关'};
+      for(const relation of relations){
+        const outgoing=relation.from===id,otherId=outgoing?relation.to:relation.from;
+        const other=board.clues.find((c:any)=>c.id===otherId&&!['superseded','retracted'].includes(c.status));if(!other)continue;
+        const meaning=outgoing?names[relation.type]:relation.type==='supports'?'得到支持':relation.type==='precedes'?'时间在后':names[relation.type];
+        const button=el('button','rhine-investigation-source',`${meaning} · ${other.id}\n${other.title}${relation.label?'\n'+relation.label:''}`);button.type='button';
+        button.onclick=()=>{page=Math.floor(clueSlot(other)/12);renderCards();render();showClue(other.id);};drawerBody.append(button);
+      }
+    }
+    showReading(drawer);syncReading();
+  }
+  function showDirectory() {
+    cancelReturn();inbox.hide(true);
+    options.panel.closeTools();report.hidden=true;
+    drawerLabel.textContent='INVESTIGATION / 全部线索';drawerBody.replaceChildren();
+    for(const [i,c]of activeClues(board).entries()){const button=el('button','rhine-investigation-source',`${c.id} · ${labels[c.kind]}\n${c.title}`);button.type='button';button.onclick=()=>{page=Math.floor(clueSlot(c)/12);renderCards();render();showClue(c.id);};drawerBody.append(button);}showReading(drawer);syncReading();
+  }
+  function showReport(version?:number) {
+    cancelReturn();inbox.hide(true);
+    if(!board?.reports.length){options.notify('报告尚未发布，已保存的线索可以先阅读。');return;}
+    options.panel.closeTools();
+    versions.replaceChildren();for(const r of [...board.reports].reverse()){const o=el('option','',`V${r.version} · ${new Date(r.publishedAt).toLocaleString()}`);o.value=String(r.version);versions.append(o);}
+    const r=board.reports.find((r:any)=>r.version===version)||board.reports.at(-1);versions.value=String(r.version);reportTitle.textContent=r.title;
+    reportNotice.textContent=`${r.clues.length} 条依据 · ${r.sources.length} 份来源 · ${r.basisKnowledgeRevision!==board.knowledgeRevision?'发布后已有线索更新，以下保留当时版本':'已保存版本'}`;
+    renderReportMarkdown(reportArticle,r.markdown.replace(/\[(C\d+)\](?!\()/g, (_match:string,id:string) => r.clues.some((c:any)=>c.id===id) ? `[${id}](#investigation-clue-${id})` : `[${id}]`));
+    const details=el('details','rhine-investigation-report-evidence');details.append(el('summary','','查看此版本使用的线索与来源'));
+    for(const c of r.clues){const heading=el('h3','',`${c.id} · ${c.title}`);heading.id=`investigation-clue-${c.id}`;details.append(heading,el('p','',c.summary));for(const ref of c.sources){const s=r.sources.find((s:any)=>s.id===ref.source_id);if(s){const button=el('button','rhine-investigation-source',`${s.title}${ref.line_start?` · L${ref.line_start}–${ref.line_end}`:''} ↗`);button.type='button';button.onclick=()=>options.openSource(referenceSource({...s,id:s.sourceId} as ArchiveSource,ref));details.append(button);if(ref.quote)details.append(el('blockquote','',ref.quote));}}}reportArticle.append(details);
+    reportArticle.onclick=event=>{const anchor=(event.target as HTMLElement).closest<HTMLAnchorElement>('a[href^="#investigation-clue-"]');if(!anchor)return;event.preventDefault();details.open=true;reportArticle.querySelector(anchor.getAttribute('href')!)?.scrollIntoView({block:'nearest'});};
+    drawer.hidden=true;showReading(report);reportScroll.scrollTop=0;syncReading();report.focus({preventScroll:true});
+  }
+  function userChange(rawCards:EvidenceCard[]) {
+    if(syncing||disposed)return;
+    const cards=structuredClone(rawCards), before=structuredClone(baseline), sources=sourceRows;
+    const ledger=edits, context=editTarget, target=board?.id||context.boardId, currentSession=sessionId, generation=aborter;
+    const current=()=>!disposed&&generation===aborter;
+    // Build again when the queue reaches this edit: prior writes may assign IDs
+    // and advance revisions while the user keeps typing or dragging a slider.
+    function prepare() {
+      const changes:any[]=[],relations:any[]=[],live=new Set(cards.map(c=>ledger.id(c.id)));
+      for(const c of cards){
+        const id=ledger.id(c.id),old=before.find(o=>ledger.id(o.id)===id),existing=ledger.has(c.id);
+        const content={title:c.title,summary:!old?c.summary??c.body.slice(0,480):c.body.slice(0,480),detail:c.body,
+          kind:!old||c.kind===old.kind?c.clueKind||(c.kind==='question'?'question':c.kind==='source'?'excerpt':'finding'):c.kind==='question'?'question':c.kind==='source'?'excerpt':'finding',
+          importance:c.stage===2?'key':'supporting',status:c.stage===0?'unresolved':'active'};
+        if(!old&&!existing)changes.push({...content,client_key:c.id,position:c.position,scale:c.scale,rotation:c.rotation,
+          sources:sources.filter(s=>s.sourceId===c.sourceId).map(s=>({source_id:s.id})),interpretation:'question'});
+        else{
+          if(!old||c.title!==old.title||c.body!==old.body||c.kind!==old.kind||c.stage!==old.stage)
+            changes.push({...content,id,expected_content_revision:ledger.revision(c.id,c.contentRevision,'content_revision')});
+          if(!old||!same(c.position,old.position)||c.scale!==old.scale||c.rotation!==old.rotation)
+            changes.push({id,action:'layout',expected_layout_revision:ledger.revision(c.id,c.layoutRevision,'layout_revision'),position:c.position,scale:c.scale,rotation:c.rotation});
+        }
+        const oldLinks=(old?.links||[]).map(to=>ledger.id(to)),links=(c.links||[]).map(to=>ledger.id(to));
+        for(const to of c.links||[])if(!oldLinks.includes(ledger.id(to)))relations.push({from:id,to:ledger.id(to),type:c.relationKinds?.[to]||'relates'});
+        // Retraction hides endpoints; preserve those edges for undo. Only an
+        // explicit unlink between two visible cards removes a stored relation.
+        for(const to of oldLinks)if(live.has(to)&&!links.includes(to))relations.push({from:id,to,remove:true});
+      }
+      for(const c of before)if(!live.has(ledger.id(c.id)))changes.push({id:ledger.id(c.id),action:'retract',expected_content_revision:ledger.revision(c.id,c.contentRevision,'content_revision')});
+      return {changes,relations};
+    }
+    const {changes,relations}=prepare();
+    if(!changes.length&&!relations.length){options.onCards([...sceneCards.filter(c=>c.id===REPORT_ID),...cards]);return;}
+    baseline=cards;saving++;render();
+    options.onCards([...sceneCards.filter(c=>c.id===REPORT_ID),...cards]);
+    const send=(endpoint:string,payload:any)=>options.api(`investigation.${endpoint}`,{session_id:currentSession,...payload},generation.signal);
+    queue=queue.then(async()=>{
+      if(!current())throw new DOMException('编辑会话已切换','AbortError');
+      let boardId=target||context.boardId;
+      if(!boardId){const created=await send('create',{mutation_id:uid()});boardId=created.board_id;context.boardId=boardId;if(!current())throw new DOMException('编辑会话已切换','AbortError');selectedId=boardId;followWorking=false;}
+      const payload=prepare();
+      const result=await send('edit',{mutation_id:uid(),board_id:boardId,...payload});
+      if(!current())return;
+      ledger.acknowledge(payload.changes,result);
+      options.panel.remapIds(result.created_ids,result.clue_revisions);
+    }).catch(error=>{
+      const draft=JSON.stringify(cards,null,2);try{localStorage.setItem(`prts-investigation-draft:${currentSession}:${target}`,draft);}catch{}
+      if(!current())return;
+      fail(error);drawerLabel.textContent='编辑尚未保存';drawerBody.replaceChildren(el('p','','内容出现冲突或同步失败，草稿已保留。复制下面的内容，刷新后可重新编辑。'));const area=el('textarea','');area.value=draft;area.readOnly=true;drawerBody.append(area);showReading(drawer);
+    }).finally(async()=>{if(!current())return;saving--;if(!saving){refreshPending=false;try{await refresh();}catch(error){fail(error);}}});
+  }
+  async function migrate() {
+    let cards:EvidenceCard[]=[];try{const raw=localStorage.getItem(evidenceStorageKey(sessionId));if(raw){const parsed=JSON.parse(raw);cards=parseEvidenceCards(parsed.cards);const previews=new Map(createPreviewCards().map(c=>[c.id,c]));cards=cards.filter(c=>{const original=previews.get(c.id);return !original||c.title!==original.title||c.body!==original.body;});}}catch{}
+    if(cards.length)await request('import',{migration_id:`legacy:${sessionId}`,cards});
+  }
+  async function start() {
+    const generation=aborter;
+    try{const preferenceValue=localStorage.getItem(preference());selectedId=preferenceValue||'';followWorking=!preferenceValue;}catch{}
+    try{await migrate();if(generation!==aborter||disposed)return;await refresh(true);if(generation===aborter&&!disposed)void loop(generation);}catch(error){if(generation===aborter&&!disposed){fail(error);void loop(generation);}}
+  }
+  picker.onchange=()=>{selectedId=picker.value;followWorking=false;page=0;try{localStorage.setItem(preference(),selectedId);}catch{};void refresh(true).catch(fail);};
+  follow.onclick=()=>{followWorking=true;page=0;try{localStorage.removeItem(preference());}catch{};void refresh(true).catch(fail);};
+  previous.onclick=()=>{page=Math.max(0,page-1);renderCards(true);render();};next.onclick=()=>{page++;renderCards(true);render();};
+  directory.onclick=showDirectory;close.onclick=closeReading;reportClose.onclick=closeReading;versions.onchange=()=>showReport(Number(versions.value));
+  add.onclick=()=>{cancelReturn();options.panel.closeTools();report.hidden=true;drawerLabel.textContent='NEW / 新建手动调查';drawerBody.replaceChildren();const input=el('input','');input.placeholder='调查标题';input.maxLength=120;input.setAttribute('aria-label','新调查标题');const button=el('button','','创建调查板');button.type='button';button.onclick=async()=>{if(!input.value.trim())return;button.disabled=true;try{const r=await request('create',{mutation_id:uid(),title:input.value.trim()});selectedId=r.board_id;followWorking=false;drawer.hidden=true;await refresh(true);}catch(error){fail(error);button.disabled=false;}};drawerBody.append(input,button);showReading(drawer);input.focus();};
+  void start();
+  return { userChange, handleKeydown, getContext, holdReadingContext, getCards:()=>sceneCards, select(id:string|null,edit=false){cancelReturn();drawer.hidden=true;report.hidden=true;if(id===REPORT_ID){showReport();return;}if(id&&!edit)showClue(id);else options.panel.select(id,edit);},
+    resumeReading(kind:'report'|'clue'|'inbox'){if(!active)return;if(kind==='inbox'){inbox.open();return;}cancelReturn();if(kind==='report'){showReading(report);report.focus({preventScroll:true});}else showReading(drawer);syncReading();},
+    setBoardFrame, setInboxAnchor:(value:EvidenceInboxAnchor)=>inbox.setAnchor(value), getInboxState:()=>inbox.state(), openInbox(){options.panel.closeTools();cancelReturn();report.hidden=true;drawer.hidden=true;syncReading();inbox.open();},
+    setActive(value:boolean){active=value;inbox.setActive(value);hud.hidden=!value||!planeVisible;if(!value){cancelReturn();drawer.hidden=true;report.hidden=true;}syncReading();},
+    async setSession(id:string){if(id===sessionId)return;cancelReturn();aborter.abort();aborter=new AbortController();loadEpoch++;sessionId=id;board=null;selectedId='';workingId='';contextReady=false;catalog=[];sourceRows=[];baseline=[];edits=new InvestigationEditRevisions();editTarget={boardId:''};queue=Promise.resolve();saving=0;refreshPending=false;pendingReset=false;commitSeq=0;page=0;drawer.hidden=true;report.hidden=true;renderCards(true);render();await start();},
+    stageSource(source:ArchiveSource,targetId?:string){
+      const currentSession=sessionId,generation=aborter,targetAtClick=targetId ?? (workingId||selectedId);
+      const send=(endpoint:string,payload:Record<string,unknown>)=>options.api(`investigation.${endpoint}`,{session_id:currentSession,...payload},generation.signal);
+      const task=inboxStageQueue.then(async()=>{
+        if(disposed||sessionId!==currentSession||generation.signal.aborted)return;
+        if(loading||!catalog.length)await refresh();
+        if(disposed||sessionId!==currentSession||generation.signal.aborted)return;
+        let target=targetAtClick||workingId||selectedId;
+        if(!target){const created=await send('create',{mutation_id:uid()});if(sessionId!==currentSession||generation.signal.aborted)return;target=created.board_id;selectedId=target;followWorking=false;}
+        const current=await send('get',{board_id:target});
+        await send('inbox',{mutation_id:uid(),board_id:target,expected_inbox_revision:current.board.inboxRevision,action:'add',source_id:source.id,sources:[source],note:''});
+        if(sessionId===currentSession&&!disposed){await refresh();options.notify(`已放入「${current.board.title}」的重点证据盒。`);}
+      });
+      inboxStageQueue=task.catch(()=>{});return task;
+    },
+    async addSource(source:ArchiveSource){if(loading)await refresh();let target=selectedId;if(!target){const created=await request('create',{mutation_id:uid()});target=created.board_id;selectedId=target;followWorking=false;}await request('edit',{mutation_id:uid(),board_id:target,sources:[source],changes:[{title:source.title.slice(0,120),summary:source.excerpt.slice(0,480),detail:source.excerpt.slice(0,12000),kind:'excerpt',interpretation:'question',sources:[{source_id:source.id}]}]});await refresh();},
+    dispose(){disposed=true;inbox.dispose();cancelReturn();for(const transition of readingTransitions.values())transition.dispose();visibility.disconnect();options.onReading(null);aborter.abort();events.abort();hud.remove();drawer.remove();report.remove();},
+    stats(){return{inbox:inbox.stats(),selectedId,workingId,boards:catalog.length,clues:activeClues(board).length,reportVersions:board?.reports.length||0,reportOpen:!report.hidden,returning:returnStartedAt!==undefined,drawerOpen:!drawer.hidden,commitSeq,active,saving};},
+  };
+}

package/ui/rhine/investigation-edits.ts

@@ -0,0 +1,46 @@
+type Revision = { content_revision: number; layout_revision: number };
+type Axis = keyof Revision;
+
+/** Advance only revisions acknowledged by this editor, never remote edits. */
+export class InvestigationEditRevisions {
+  private aliases = new Map<string, string>();
+  private current = new Map<string, Revision>();
+  private created = new Map<string, Revision>();
+  private successors = new Map<string, Map<number, number>>();
+
+  id(value: string) { return this.aliases.get(value) || value; }
+  has(value: string) { return this.current.has(this.id(value)); }
+  observe(clues: { id: string; contentRevision: number; layoutRevision: number }[]) {
+    for (const clue of clues) this.current.set(clue.id, {
+      content_revision: clue.contentRevision, layout_revision: clue.layoutRevision,
+    });
+  }
+  revision(value: string, expected: number | undefined, axis: Axis) {
+    const id = this.id(value);
+    // A temporary card can inherit another card's revision when duplicated.
+    let revision = id !== value ? this.created.get(id)?.[axis] : expected;
+    revision ??= this.current.get(id)?.[axis];
+    const next = this.successors.get(`${id}:${axis}`);
+    while (revision !== undefined && next?.has(revision)) revision = next.get(revision);
+    return revision;
+  }
+  acknowledge(changes: { id?: string; expected_content_revision?: number; expected_layout_revision?: number }[],
+    result: { created_ids: Record<string, string>; clue_revisions: Record<string, Revision> }) {
+    for (const [from, to] of Object.entries(result.created_ids)) if (from !== to) {
+      this.aliases.set(from, to);
+      if (!this.created.has(to)) this.created.set(to, result.clue_revisions[to]);
+    }
+    for (const [id, revision] of Object.entries(result.clue_revisions)) this.current.set(id, revision);
+    for (const change of changes) {
+      if (!change.id) continue;
+      const revision = result.clue_revisions[change.id];
+      if (!revision) continue;
+      for (const axis of ['content_revision', 'layout_revision'] as const) {
+        const before = change[`expected_${axis}`], after = revision[axis];
+        if (before === undefined || after <= before) continue;
+        const key = `${change.id}:${axis}`, chain = this.successors.get(key) || new Map();
+        chain.set(before, after); this.successors.set(key, chain);
+      }
+    }
+  }
+}