prts-terrarchive 0.2.0 → 0.2.2

package/ui/rhine/investigation-board.ts

@@ -9,6 +9,7 @@ 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 { investigationVersion } from './investigation-history';
 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 };
@@ -18,9 +19,13 @@ export interface InvestigationContext {
   selectedId: string;
   workingId: string;
   ready: boolean;
+  version: number;
+  readOnly: boolean;
+  reportAvailable: boolean;
+  report?: { version:number; title:string; clues:number; sources:number };
 }
 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 };
+  panel: Panel; onInbox(value:EvidenceInboxView,open:boolean):void; askInbox?(boardId:string,title:string):Promise<void>; onReading(value: ReadingObject | null): void; onCards(cards: EvidenceCard[], total: number): 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();
@@ -35,6 +40,8 @@ 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 liveBoard:any=null, liveSources:any[]=[];
+  let selectedVersion=0, historyComplete=true;
   let syncing = false, saving = 0, refreshPending = false, loadEpoch = 0, loading = false;
   let baseline: EvidenceCard[] = [], sceneCards: EvidenceCard[] = [];
   let edits = new InvestigationEditRevisions(), pendingReset = false;
@@ -56,11 +63,12 @@ export function mountInvestigationBoard(host: HTMLElement, options: Options) {
   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 history = el('select','rhine-investigation-version'); history.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);
+  header.append(index,picker,history,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','下一组线索');
@@ -158,26 +166,50 @@ export function mountInvestigationBoard(host: HTMLElement, options: Options) {
     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);
+    options.onCards(sceneCards, activeClues(board).length);
   }
   function getContext(): InvestigationContext {
-    return { sessionId, boards: catalog.map(({id,title})=>({id,title})), selectedId, workingId, ready: contextReady };
+    const report=board?.reports.at(-1);
+    return { sessionId, boards: catalog.map(({id,title})=>({id,title})), selectedId, workingId, ready: contextReady, version:selectedVersion, readOnly:!!selectedVersion, reportAvailable:!!report, ...(report?{report:{version:report.version,title:report.title,clues:report.clues.length,sources:report.sources.length}}:{}) };
   }
   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 {}
+    savePreference();
+  }
+  function savePreference(version=selectedVersion) {
+    try { if(selectedId)localStorage.setItem(preference(),JSON.stringify({id:selectedId,version})); } catch {}
+  }
+  function projectVersion() {
+    const view=investigationVersion(liveBoard,liveSources,selectedVersion);
+    board=view.board;sourceRows=view.sources;historyComplete=view.complete;
+  }
+  async function selectVersion(version:number, reading=false) {
+    const generation=aborter;
+    options.panel.closeTools();
+    await queue;
+    if(disposed||generation!==aborter)return;
+    if(version&&!liveBoard?.reports.some((r:any)=>r.version===version))return;
+    cancelReturn();drawer.hidden=true;report.hidden=true;inbox.hide(true);
+    selectedVersion=version;followWorking=false;page=0;savePreference();
+    projectVersion();edits=new InvestigationEditRevisions();renderCards(true);render();syncReading();
+    if(reading)showReport(version||undefined);
   }
   function render() {
     options.onContext?.(getContext());
-    inbox.setData(board,sourceRows);
+    // The inbox is editable live state; historical views expose saved clues only.
+    inbox.setData(selectedVersion?null:board,selectedVersion?[]: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;
+    follow.hidden=!selectedVersion&&(!workingId||workingId===selectedId);
+    history.replaceChildren();const current=el('option','','工作板');current.value='0';history.append(current);
+    for(const r of [...(liveBoard?.reports||[])].reverse()){const option=el('option','',`V${r.version}${r.boardSnapshot?'':' · 报告依据'}`);option.value=String(r.version);history.append(option);}
+    history.value=String(selectedVersion);history.hidden=!liveBoard?.reports.length;history.disabled=!!saving||loading;
+    hint.textContent=selectedVersion?historyComplete?'历史快照 · 只读 · 点击阅读':'旧版本仅保留报告依据，连线与完整布局未保存':'重要线索随调查加入 · 点击阅读，双击编辑';
     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?' · 有新线索待更新':''}`:'线索已保存';
+    status.textContent=selectedVersion?`V${selectedVersion} · ${historyComplete?'整板快照':'部分依据'} · 只读`: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;
   }
@@ -201,7 +233,10 @@ export function mountInvestigationBoard(host: HTMLElement, options: Options) {
       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||[];
+    if(oldId&&oldId!==selectedId)selectedVersion=0;
+    liveBoard=result?.board||null;liveSources=result?.sources||[];
+    if(selectedVersion&&!liveBoard?.reports.some((r:any)=>r.version===selectedVersion))selectedVersion=0;
+    projectVersion();
     page=Math.min(page,pageCount(board)-1);loading=false;contextReady=true;
     const resetCards=pendingReset||oldId!==selectedId;pendingReset=false;renderCards(resetCards);render();
   }
@@ -218,7 +253,7 @@ export function mountInvestigationBoard(host: HTMLElement, options: Options) {
     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);
+    const edit=el('button','','编辑这条线索 ↗');edit.type='button';edit.hidden=!!selectedVersion;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','','尚无来源，不能作为已核实结论。'));
@@ -245,9 +280,9 @@ export function mountInvestigationBoard(host: HTMLElement, options: Options) {
   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;
+    holdReadingContext();options.panel.closeTools();
+    versions.replaceChildren();for(const r of [...(liveBoard?.reports||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=(liveBoard?.reports||board.reports).find((r:any)=>r.version===(version||selectedVersion))||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','','查看此版本使用的线索与来源'));
@@ -257,6 +292,7 @@ export function mountInvestigationBoard(host: HTMLElement, options: Options) {
   }
   function userChange(rawCards:EvidenceCard[]) {
     if(syncing||disposed)return;
+    if(selectedVersion){renderCards(true);options.notify('历史板只读；返回工作板后可继续编辑。');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;
@@ -287,9 +323,9 @@ export function mountInvestigationBoard(host: HTMLElement, options: Options) {
       return {changes,relations};
     }
     const {changes,relations}=prepare();
-    if(!changes.length&&!relations.length){options.onCards([...sceneCards.filter(c=>c.id===REPORT_ID),...cards]);return;}
+    if(!changes.length&&!relations.length){options.onCards([...sceneCards.filter(c=>c.id===REPORT_ID),...cards],activeClues(board).length-toCards().length+cards.length);return;}
     baseline=cards;saving++;render();
-    options.onCards([...sceneCards.filter(c=>c.id===REPORT_ID),...cards]);
+    options.onCards([...sceneCards.filter(c=>c.id===REPORT_ID),...cards],activeClues(board).length-toCards().length+cards.length);
     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');
@@ -312,20 +348,31 @@ export function mountInvestigationBoard(host: HTMLElement, options: Options) {
   }
   async function start() {
     const generation=aborter;
-    try{const preferenceValue=localStorage.getItem(preference());selectedId=preferenceValue||'';followWorking=!preferenceValue;}catch{}
+    try{const preferenceValue=localStorage.getItem(preference());
+      if(preferenceValue?.startsWith('{')){const saved=JSON.parse(preferenceValue);selectedId=typeof saved.id==='string'?saved.id:'';selectedVersion=Number.isSafeInteger(saved.version)&&saved.version>0?saved.version:0;}
+      else selectedId=preferenceValue||'';followWorking=!selectedId;
+    }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);};
+  picker.onchange=()=>{selectedId=picker.value;followWorking=false;page=0;savePreference(0);void refresh(true).catch(fail);};
+  history.onchange=()=>{void selectVersion(Number(history.value)).catch(fail);};
+  follow.onclick=()=>{void (async()=>{
+    const generation=aborter;
+    // Replace the historical projection before making the working board editable.
+    await selectVersion(0);
+    if(disposed||generation!==aborter)return;
+    followWorking=true;page=0;try{localStorage.removeItem(preference());}catch{}
+    await 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));
+  directory.onclick=showDirectory;close.onclick=closeReading;reportClose.onclick=closeReading;versions.onchange=()=>{void selectVersion(Number(versions.value),true).catch(fail);};
   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);},
+  return { showReport, async prepareReport(){if(loading||!contextReady)await refresh();return !!board?.reports.length;}, 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||selectedVersion))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();},
+    setBoardFrame, setInboxAnchor:(value:EvidenceInboxAnchor)=>inbox.setAnchor(value), getInboxState:()=>inbox.state(), openInbox(){if(selectedVersion){options.notify('历史板只读；返回工作板后查看重点证据盒。');return;}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();},
+    async setSession(id:string){if(id===sessionId)return;cancelReturn();aborter.abort();aborter=new AbortController();loadEpoch++;sessionId=id;board=null;liveBoard=null;liveSources=[];selectedVersion=0;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);
@@ -341,8 +388,8 @@ export function mountInvestigationBoard(host: HTMLElement, options: Options) {
       });
       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();},
+    async addSource(source:ArchiveSource){if(selectedVersion)throw new Error('历史板只读；返回工作板后再添加线索。');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};},
+    stats(){return{inbox:inbox.stats(),selectedVersion,historyComplete,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-history.ts

@@ -0,0 +1,15 @@
+/** Historical boards never borrow mutable clues or relations from the working board. */
+export function investigationVersion(board: any, sources: any[], version: number) {
+  if (!board || !version) return { board, sources, complete: true };
+  const report = board.reports.find((item: any) => item.version === version);
+  if (!report) throw new Error('该调查版本不存在，请重新选择版本。');
+  const saved = report.boardSnapshot;
+  const historical = saved || {
+    id: board.id, title: report.title, objective: report.summary,
+    createdAt: report.publishedAt, updatedAt: report.publishedAt,
+    knowledgeRevision: report.basisKnowledgeRevision, layoutRevision: 0,
+    clues: report.clues, relations: [], openQuestions: [], evidenceInbox: [], inboxRevision: 0,
+  };
+  return { board: structuredClone({ ...historical, reports: [report] }),
+    sources: structuredClone(saved?.sources || report.sources), complete: Boolean(saved) };
+}

package/ui/rhine/reading-room.css

@@ -1,4 +1,4 @@
-/* A physical document at left, a quiet transparent reading surface at right. */
+/* A physical document at left, an opaque paper reading surface at right. */
 .rhine-workbench{--reading-ink:#30362b;--reading-muted:#7d806e;--reading-rule:#aca78f88}
 .rhine-workbench :is(.rhine-investigation-report,.rhine-investigation-drawer){position:absolute;inset:0;z-index:45;width:auto;max-width:none;padding:0;border:0;box-shadow:none;backdrop-filter:none;overflow:hidden;color:var(--reading-ink);background:linear-gradient(90deg,transparent 38%,#ebe8e04d 50%,#ebe8e0e0 72%,#ebe8e0eb 100%)}
 .rhine-workbench .rhine-investigation-report>header,.rhine-workbench .rhine-investigation-drawer-top{position:absolute;left:56%;right:5%;top:22%;height:36px;display:flex;align-items:center;justify-content:space-between;gap:14px;padding:0;border:0;font-size:11px;letter-spacing:.06em;color:var(--reading-muted)}
@@ -14,7 +14,7 @@
 .rhine-workbench .rhine-investigation-report .rhine-report-body>:not(.rhine-report-table){max-width:none}
 .rhine-workbench .rhine-investigation-provenance{padding-bottom:20px;border-bottom:1px solid var(--reading-rule);color:var(--reading-muted)}
 .rhine-workbench .rhine-report.modal-backdrop{background:transparent;backdrop-filter:none}
-.rhine-workbench .rhine-report-modal{position:absolute;left:56%;right:5%;top:22%;bottom:12%;width:auto;height:auto;max-height:none;padding:0;background:linear-gradient(90deg,#ebe8e0b3,#ebe8e0eb);box-shadow:none;border:0}
+.rhine-workbench .rhine-report-modal{position:absolute;left:56%;right:5%;top:22%;bottom:12%;width:auto;height:auto;max-height:none;padding:0;background:#f4f1e8;box-shadow:0 12px 50px #393a2520;border:1px solid #c6c2ae;padding:24px;box-sizing:border-box}
 .rhine-workbench .rhine-report-layout{grid-template-columns:minmax(0,1fr);grid-template-rows:auto minmax(0,1fr) auto;gap:16px;padding-top:16px}
 .rhine-workbench .rhine-report-outline{max-height:68px;overflow:auto;border:0}
 .rhine-workbench .rhine-report-toc{display:flex;gap:16px;flex-wrap:wrap}
@@ -46,10 +46,21 @@
 .rhine-workbench :is(.rhine-investigation-report,.rhine-investigation-drawer){animation:none}
 
 /* Board controls stay in place behind the reading mode, then return unchanged. */
-.rhine-workbench.has-reading-object :is(.rhine-investigation-hud,.rhine-board-toolbar,.rhine-board-chalk-hit,.rhine-evidence-panel,.rhine-zone-nav,.rhine-scene-edges,.rhine-board-tool-status){visibility:hidden;pointer-events:none}
+.rhine-workbench.has-reading-object :is(.rhine-investigation-hud,.rhine-board-toolbar,.rhine-board-chalk-hit,.rhine-evidence-panel,.rhine-zone-nav,.rhine-scene-edges,.rhine-board-tool-status,.rhine-investigation-brief,.rhine-agent-form,.rhine-rack-legend,.rhine-shelf-report){visibility:hidden;pointer-events:none}
 .rhine-workbench .rhine-investigation-report .rhine-report-body{box-sizing:border-box;margin:0;justify-self:stretch}
 .rhine-workbench .rhine-investigation-report .rhine-report-body>:not(.rhine-report-table){margin-left:0;margin-right:0;max-width:none}
 
 /* Keep the fading layer as the pointer shield until the fade completes. */
 .rhine-workbench :is(.rhine-investigation-report,.rhine-investigation-drawer)[data-transition=closing]{animation:none;pointer-events:auto}
 .rhine-workbench :is(.rhine-investigation-report,.rhine-investigation-drawer)[data-transition=closing]>*{pointer-events:none}
+
+/* Saved reports keep their book on the left and a continuous paper surface on the right. */
+.rhine-workbench .rhine-investigation-report::before,.rhine-workbench .rhine-investigation-drawer::before{content:"";position:absolute;left:52%;right:3%;top:15%;bottom:9%;background:#f4f1e8;border:1px solid #c6c2ae;box-shadow:0 12px 50px #393a2520;pointer-events:none}
+.rhine-workbench .rhine-investigation-report>header,.rhine-workbench .rhine-investigation-drawer-top{left:54%;right:5%;top:18%;border-bottom:1px solid var(--reading-rule);padding-bottom:12px}
+.rhine-workbench .rhine-investigation-report-scroll,.rhine-workbench .rhine-investigation-drawer-body{left:54%;top:26%;bottom:12%;padding-right:14px}
+.rhine-workbench .rhine-investigation-report-intro>h2{font-size:clamp(21px,1.8vw,28px);line-height:1.5;overflow-wrap:anywhere}
+.rhine-workbench .rhine-investigation-report .rhine-report-body{font-size:16px;line-height:1.9}
+.rhine-workbench .rhine-report-title{font-size:25px;line-height:1.4;margin:12px 0}
+.rhine-workbench :is([data-layout=compact],[data-layout=portrait]) :is(.rhine-investigation-report,.rhine-investigation-drawer)::before{left:49%;right:2%;top:13%;bottom:6%}
+.rhine-workbench [data-layout=portrait] :is(.rhine-investigation-report,.rhine-investigation-drawer)::before{left:3%;right:3%;top:37%;bottom:3%}
+.rhine-workbench [data-layout=portrait] .rhine-report-modal{padding:18px}

package/ui/rhine/scene.ts

@@ -123,11 +123,12 @@ export async function createRhineScene(host: HTMLElement, options: RhineSceneOpt
   let userPriorityUntil = 0;
   let followAgent = true;
   const userOwnsView = () => !followAgent || performance.now() < userPriorityUntil;
-  const prioritizeUser = () => { userPriorityUntil = performance.now() + 4000; scanElapsed = 0; };
+  const prioritizeUser = () => { userPriorityUntil = performance.now() + 4000; };
   let scanElapsed = ARCHIVE_STEP_SECONDS - 0.35;
   let scanSteps = 0;
   let readingScanDirection = 1;
   let arrivalScanRemaining = 0;
+  let searchVisualRemaining = 0;
   let deskAmount = 0;
   let boardAmount = 0;
   let boardZoom = BOARD_ZOOM_MIN;
@@ -261,10 +262,11 @@ export async function createRhineScene(host: HTMLElement, options: RhineSceneOpt
     const position = Math.max(0, lanes[lane].findIndex(item => sourceIdentity(item) === sourceIdentity(source)));
     return lane * 8 + wrap(slotRows[lane] + position - laneRows[lane], 8);
   };
-  const readingActive = () => [...operations.values()].some(item => item.kind === 'read' && item.state === 'active')
-    || (!!investigation?.running && investigation.phase === 'reading');
-  const scanningActive = () => searching || [...operations.values()].some(item => item.kind === 'search' && item.state === 'active')
-    || (!!investigation?.searching && investigation.phase !== 'reading') || arrivalScanRemaining > 0;
+  const activityCancelled = () => investigation?.outcome === 'interrupted' || investigation?.outcome === 'error';
+  const readingActive = () => !activityCancelled() && ([...operations.values()].some(item => item.kind === 'read' && item.state === 'active')
+    || (!!investigation?.running && investigation.phase === 'reading'));
+  const scanningActive = () => searching || !activityCancelled() && ([...operations.values()].some(item => item.kind === 'search' && item.state === 'active')
+    || (!!investigation?.searching && investigation.phase !== 'reading') || arrivalScanRemaining > 0 || searchVisualRemaining > 0);
   const archiveBusy = () => readingActive() || scanningActive();
 
   // Preserve the authored shell; resting files can share a captured interior.
@@ -467,36 +469,36 @@ export async function createRhineScene(host: HTMLElement, options: RhineSceneOpt
       }, target.axis === 'pointer' ? 5 : target.axis === 'activity' ? 4 : -2);
     }
   };
-  const notifyArchive = () => {
+  const notifyArchive = (automatic = false) => {
     const source = currentArchiveSource();
     const inspected = location === 'desk' && selectedId ? sourceList.find(item => item.id === selectedId) : undefined;
     const labelSource = inspected || source;
     original.setArchiveLabel(labelSource ? archivePrint(labelSource) : null);
     syncLabelPrefetch();
-    options.onArchiveSelect?.(archiveIndex);
+    if (!automatic || !userOwnsView()) options.onArchiveSelect?.(archiveIndex);
     // Empty lanes still participate in the original mechanical loop. Keep
     // the last real UI selection, otherwise source synchronization repeatedly
     // falls back to the first result and pulls the moving track backwards.
-    if (source || !archiveBusy()) options.onArchiveSourceSelect?.(source?.id || null, archiveLaneIndex, userOwnsView());
+    if ((!automatic || !userOwnsView()) && (source || !archiveBusy())) options.onArchiveSourceSelect?.(source?.id || null, archiveLaneIndex, userOwnsView());
   };
-  const chooseArchive = (index: number, navigation?: ArchiveNavigation) => {
+  const chooseArchive = (index: number, navigation?: ArchiveNavigation, automatic = false) => {
     archiveIndex = wrap(index, 40);
     archiveLaneIndex = fileLocation(archiveIndex).lane;
     slotRows[archiveLaneIndex] = archiveIndex % 8;
     if (detail) { detail = false; original.setMode('archive'); }
     original.select(archiveIndex, navigation);
-    notifyArchive(); wake();
+    notifyArchive(automatic); wake();
   };
-  const stepArchive = (axis: 'row' | 'lane', direction: number) => {
+  const stepArchive = (axis: 'row' | 'lane', direction: number, automatic = false) => {
     if (disposed || location !== 'archive' || detail) return;
     const step = direction < 0 ? -1 : 1;
     if (axis === 'row') {
       const count = lanes[archiveLaneIndex].length;
       if (count) laneRows[archiveLaneIndex] = wrap(laneRows[archiveLaneIndex] + step, count);
-      chooseArchive(archiveLaneIndex * 8 + wrap(slotRows[archiveLaneIndex] + step, 8), { axis: 'row', direction: step });
+      chooseArchive(archiveLaneIndex * 8 + wrap(slotRows[archiveLaneIndex] + step, 8), { axis: 'row', direction: step }, automatic);
     } else {
       const next = wrap(archiveLaneIndex + step, archiveColumns.length);
-      chooseArchive(next * 8 + slotRows[next], { axis: 'lane', direction: step });
+      chooseArchive(next * 8 + slotRows[next], { axis: 'lane', direction: step }, automatic);
     }
   };
   const acceptArchiveNavigation = (intent: Record<string, string | number> = {}) => {
@@ -711,7 +713,14 @@ export async function createRhineScene(host: HTMLElement, options: RhineSceneOpt
         || previous === undefined && (Number.isFinite(operation.completedAt)
           ? operation.completedAt! < activitySince : snapshot.loadingHistory));
       if (historical) historicalOperations.add(operation.id);
-      if (operation.kind !== 'read' || operation.state === 'error' || historical
+      // A quick or repeated search must still finish a visible mechanical step.
+      // Refreshes of the same receipt never replay it; old chat history is a baseline.
+      if (!historical && !historicalOperations.has(operation.id) && operation.kind === 'search'
+        && operation.state !== 'error' && previous !== operation.state && active && !document.hidden && !reduced && !activityCancelled()) {
+        searchVisualRemaining = ARCHIVE_STEP_SECONDS + 0.4;
+        if (previous === undefined) scanElapsed = Math.max(scanElapsed, ARCHIVE_STEP_SECONDS - 0.2);
+      }
+      if (operation.kind !== 'read' || operation.state === 'error' || historical || activityCancelled()
         || previous === 'complete' && !scheduledReads.has(`${operation.id}:0`)) continue;
       const returned = operationSources(operation);
       const targets: (ArchiveSource | undefined)[] = returned.length ? returned : [undefined];
@@ -747,7 +756,7 @@ export async function createRhineScene(host: HTMLElement, options: RhineSceneOpt
       clearActivities(); transferred.clear(); waitingArrivals.clear();
       observedOperations.clear(); historicalOperations.clear(); scheduledReads.clear(); operations.clear(); operationsInitialized = false;
       activitySince = Date.now();
-      userPriorityUntil = 0; searching = false; arrivalScanRemaining = 0;
+      userPriorityUntil = 0; searching = false; arrivalScanRemaining = 0; searchVisualRemaining = 0;
       scanElapsed = ARCHIVE_STEP_SECONDS - 0.35; scanSteps = 0;
       selectedId = null; focusedId = null; shelfPage = 0;
       setSources([], false); setArchiveSources([]);
@@ -755,7 +764,13 @@ export async function createRhineScene(host: HTMLElement, options: RhineSceneOpt
     sessionId = snapshot.sessionId;
     // Local directory loading and host investigation state have independent
     // lifetimes. Streaming snapshots must not reset the mechanical scan timer.
-    observeOperations(); wake();
+    observeOperations();
+    if (activityCancelled()) {
+      searchVisualRemaining = arrivalScanRemaining = 0;
+      activityQueue.length = 0;
+      for (const actor of activityFiles) beginReturn(actor);
+    }
+    wake();
   };
 
   const occupyingArray = (actor: ActivityFile) => actor.stage !== 'travelling' || actor.elapsed < 2.4 * 0.28;
@@ -807,9 +822,9 @@ export async function createRhineScene(host: HTMLElement, options: RhineSceneOpt
       if (operation?.state === 'error' || request.age > 9 && operation?.state !== 'active') activityQueue.splice(index, 1);
     }
     if (activityQueue.length !== queuedBefore) { activityLabelSource = null; syncLabelPrefetch(); }
-    // Explicit browsing owns the view. Pointer hover does not cancel a running
-    // lift, and a finished fast tool still receives its full minimum sequence.
-    if (!reduced && !detail && !cameraTravel && !userOwnsView()
+    // Manual browsing owns the camera and selected document, not Agent activity.
+    // A short read still receives its complete minimum physical sequence.
+    if (!reduced && !detail && !cameraTravel
       && activityFiles.length < MAX_ACTIVITY_FILES && activityQueue.length && activitySpacing === 0) {
       const requestSlot = (request: ActivityRequest) => request.source ? sourceSlot(request.source)
         : Array.from({ length: MAX_ACTIVITY_FILES + 1 }, (_, offset) => archiveLaneIndex * 8 + wrap(slotRows[archiveLaneIndex] + offset, 8))
@@ -834,7 +849,7 @@ export async function createRhineScene(host: HTMLElement, options: RhineSceneOpt
       }
       if (next >= 0) {
         const request = activityQueue.splice(next, 1)[0];
-        const focusSource = location === 'archive' && !activityFiles.some(occupyingArray) && request.source;
+        const focusSource = !userOwnsView() && location === 'archive' && !activityFiles.some(occupyingArray) && request.source;
         if (focusSource) focusArchiveSource(focusSource.id);
         const index = requestSlot(request);
         const number = request.source ? sourceNumber(request.source) : -1;
@@ -1052,7 +1067,7 @@ export async function createRhineScene(host: HTMLElement, options: RhineSceneOpt
     try {
       const dt = lastFrame ? Math.min(0.05, (ms - lastFrame) / 1000) : 0.016;
       lastFrame = ms;
-      const scanning = scanningActive() && location === 'archive' && !detail && !reduced && !userOwnsView();
+      const scanning = scanningActive() && location === 'archive' && !detail && !reduced;
       original.setInvestigationScanning(scanning);
       // Use precisely the original select path: track, shoulder, signed pulse and
       // preview lift. Allow its spring to settle before advancing to the next cell.
@@ -1065,15 +1080,16 @@ export async function createRhineScene(host: HTMLElement, options: RhineSceneOpt
           if (activityFiles.some(item => item.stage === 'holding')) {
             // A parallel search can keep moving beside a long read without
             // carrying its pinned cassette all the way out of the composition.
-            stepArchive('row', readingScanDirection);
+            stepArchive('row', readingScanDirection, true);
             readingScanDirection *= -1;
           } else {
             readingScanDirection = 1;
-            stepArchive(++scanSteps % 3 === 0 ? 'lane' : 'row', 1);
+            stepArchive(++scanSteps % 3 === 0 ? 'lane' : 'row', 1, true);
           }
         }
       }
       arrivalScanRemaining = Math.max(0, arrivalScanRemaining - dt);
+      searchVisualRemaining = Math.max(0, searchVisualRemaining - dt);
       updateCollection(dt);
       evidenceBoard.update(dt);
       options.performanceProbe?.checkpoint(measured, 'collection');
@@ -1350,13 +1366,17 @@ export async function createRhineScene(host: HTMLElement, options: RhineSceneOpt
     pointRay(event);
     if(!boardPanKey&&!middlePan&&boardTool.mode==='select'&&evidenceInbox.pick(raycaster)){down=null;event.preventDefault();options.onInboxOpen?.();return;}
     let id = evidenceBoard.pick(raycaster);
+    if (options.isBoardReadOnly?.() && !boardPanKey && !middlePan) {
+      if (id) { down = null; event.preventDefault(); options.onBoardSelect?.(id, false); return; }
+      if (evidenceBoard.pickTool(raycaster)) { down = null; return; }
+    }
     if (!boardPanKey && !middlePan && (evidenceBoard.pickTool(raycaster) || boardTool.mode !== 'select')) {
       boardPress = { pointerId: event.pointerId, kind: evidenceBoard.pickTool(raycaster) ? 'chalk' : 'tool', cardId: id, moved: false };
       event.preventDefault(); original.renderer.domElement.setPointerCapture(event.pointerId);
       updateToolPreview(event); return;
     }
     if (!boardPanKey && !middlePan && boardTool.mode === 'select') {
-      let resizeId = pickResizeHandle(event);
+      let resizeId = options.isBoardReadOnly?.() ? null : pickResizeHandle(event);
       if (resizeId) {
         // Flush/promote an edited sample before freezing the resize reference.
         options.onBoardSelect?.(resizeId, false);

package/ui/rhine/tool-activity.ts

@@ -47,12 +47,19 @@ export function operationSource(operation: ArchiveOperation, sources: ArchiveSou
 
 /** One card per real read call, including a repeat read of the same document. */
 export function latestReadFocus(snapshot: InvestigationSnapshot, sources: ArchiveSource[]) {
-  const reads = (snapshot.operations || []).filter(call => call.kind === 'read');
-  const operation = reads.at(-1);
-  if (!operation) return undefined;
-  const source = operationSource(operation, sources);
-  if (!source) return undefined;
-  return { key: `${snapshot.sessionId}:${snapshot.investigationId || ''}:${operation.id}`, source, operation };
+  const reads = (snapshot.operations || []).filter(call => call.kind === 'read').slice().reverse();
+  if (snapshot.lastRead) reads.push(snapshot.lastRead);
+  let failed: { key: string; source: ArchiveSource; operation: ArchiveOperation } | undefined;
+  for (const operation of reads) {
+    const source = operationSource(operation, sources);
+    if (!source) continue;
+    const focus = { key: `${snapshot.sessionId}:${operation.id}`, source, operation };
+    // A failed request must not replace the last actual reading target. Keep
+    // its error card only when there is no earlier read to return to.
+    if (operation.state !== 'error') return focus;
+    failed ??= focus;
+  }
+  return failed;
 }
 
 /** New calls move the whole card downward once; streamed snapshots stay still. */

package/ui/rhine/types.ts

@@ -26,6 +26,8 @@ export interface ArchiveSource {
   origin: ArchiveOrigin;
   state: ArchiveState;
   agentRead?: boolean;
+  /** Delivered to the Agent in this session; independent of reading or citation. */
+  agentReceived?: boolean;
   excerpt: string;
   /** The exact web_fetch text received by the Agent, separate from the preview excerpt. */
   content?: string;
@@ -100,6 +102,8 @@ export interface InvestigationSnapshot {
   records?: { id: string; tool: string; state: 'active' | 'complete' | 'error'; query: string; text: string }[];
   /** Current-turn tool activities; parallel and already completed calls remain distinct. */
   operations?: ArchiveOperation[];
+  /** Latest successful read in loaded session history, retained across turns. */
+  lastRead?: ArchiveOperation;
   /** All current-turn Host tools, including nested and non-corpus calls. */
   toolCalls?: InvestigationToolCall[];
 }
@@ -141,6 +145,7 @@ export interface RhineScene {
   dispose(): void;
 }
 export interface RhineSceneOptions {
+  isBoardReadOnly?: () => boolean;
   assetBase: string;
   navigationLimiter?: import('./archive-navigation-limit').ArchiveNavigationLimiter;
   /** TEMPORARY RHINE PROFILER */
@@ -183,6 +188,7 @@ export interface RhineOptions {
   isSettingsOpen?: () => boolean;
 }
 export interface RhineHostState {
+  cancelling?: boolean;
   sessionId: string;
   title: string;
   workspace: string;