@north-light/cli 0.0.0 → 0.3.413

package/dist/clients/inbox/review/companion-pane.js

@@ -0,0 +1 @@
+var M=Object.defineProperty;var a=(e,o)=>M(e,"name",{value:o,configurable:!0});import{inTmux as p,liveViewerPanes as O,paneRunning as d,paneSize as _,splitWindow as m,paneExists as I,getPaneOption as N,closePane as k}from"../../../core/runtime/placement-tmux.js";import{viewerEnv as P}from"../../../commands/surface/node/placement.js";const h=99,C=40,v=12,w=.42,S=.4,z=52;function L(e){const{companionNodeId:o,cwd:s,callerPane:n}=e;if(!p())return{ok:!1,reason:"no_tmux"};const t=O().filter(r=>r.nodeId===o&&d(r.pane)).sort((r,x)=>x.stampMs-r.stampMs);if(t.length>0)return{ok:!0,paneId:t[0].pane,origin:"adopted"};if(n===void 0||n==="")return{ok:!1,reason:"no_caller_pane"};const l=_(n);if(l===null)return{ok:!1,reason:"split_refused"};let c,u;l.cols>=h?(c=!1,u=Math.max(C,Math.round(l.cols*w))):(c=!0,u=Math.max(v,Math.round(l.rows*S)));const f=m(n,{cwd:s,env:P(),command:`crtr surface attach to ${o}`,vertical:c,size:u});return f===null?{ok:!1,reason:"split_refused"}:{ok:!0,paneId:f,origin:"opened"}}a(L,"openCompanionPane");function R(e){const{nodeId:o,cwd:s,splitFrom:n}=e;if(!p())return{ok:!1,reason:"no_tmux"};if(n===void 0||n==="")return{ok:!1,reason:"no_caller_pane"};const i=_(n);if(i===null)return{ok:!1,reason:"split_refused"};if(Math.floor(i.cols/2)<z)return{ok:!1,reason:"no_room"};const t=m(n,{cwd:s,env:P(),command:`crtr surface attach to ${o}`,vertical:!1,size:Math.floor(i.cols/2)});return t===null?{ok:!1,reason:"split_refused"}:{ok:!0,paneId:t}}a(R,"openForkPane");function E(e){return I(e)&&d(e)}a(E,"companionPaneLive");function F(e,o){!I(e)||N(e,"@crtr_node")!==o||k(e)}a(F,"closeCompanionPane");export{S as COMPANION_HEIGHT_RATIO,w as COMPANION_WIDTH_RATIO,C as MIN_COMPANION_COLS,v as MIN_COMPANION_ROWS,z as MIN_FORK_COLS,h as SPLIT_MIN_COLS,F as closeCompanionPane,E as companionPaneLive,L as openCompanionPane,R as openForkPane};

package/dist/clients/inbox/review/document-surface.d.ts

@@ -0,0 +1,212 @@
+import type { SurfaceComponent, SurfaceHandle, SurfaceNoticeOptions } from '../../surfaces/host.js';
+import { type CommentAuthority } from './comments-client.js';
+import type { LiveSource } from './live-source.js';
+import type { ResolvedReview } from './review-client.js';
+/** What the surface's owner supplies for everything outside the document.
+ *
+ *  `submit` exists because the `s` key lives on the document while the review lifecycle adapter belongs to the owner: the
+ *  surface reports the intent, the owner runs `reviewClient.submit`. */
+export interface ReviewSurfaceServices {
+    notice(text: string, opts?: SurfaceNoticeOptions): void;
+    suspendForChild(): () => void;
+    requestClose(): void;
+    submit(): void;
+    cancel(): void;
+}
+export interface ReviewDocumentSurfaceOptions {
+    review: ResolvedReview;
+    source: LiveSource;
+    comments: CommentAuthority;
+    /** `host.capabilities.selfPane` — the pane the companion splits against. */
+    callerPane: string | undefined;
+    services: ReviewSurfaceServices;
+}
+/** The one mounted review surface: existing review rendering and navigation
+ *  over a live file, with comments projected from the daemon and ranges
+ *  remapped by this terminal as the file changes, plus a status row naming the
+ *  companion pane the conversation lives in. */
+export declare class ReviewDocumentSurface implements SurfaceComponent {
+    private readonly absFile;
+    private readonly fileLabel;
+    private readonly companionNodeId;
+    private readonly companionCwd;
+    private readonly callerPane;
+    private readonly kind;
+    private readonly source;
+    private readonly comments;
+    private readonly services;
+    private readonly unsubscribeComments;
+    private readonly ready;
+    private cols;
+    /** Rows the host assigned this surface; the document frame renders one
+     *  fewer, because the last line is this surface's status row. */
+    private hostRows;
+    /** The `hostRows` the current state was last reflowed against. A height
+     *  change matters as much as a width one: `reflow` is what re-runs
+     *  `ensureAnchorVisible` against the new body height, so a pane shrink
+     *  cannot strand the active anchor below the visible body. */
+    private flowedRows;
+    private _focused;
+    private closed;
+    private escapeConfirmArmed;
+    private cancelArmed;
+    private submitArmed;
+    private tornDown;
+    /** The disposition {@link teardown} stated, kept only while there was no
+     *  handle to close: the mount that follows disposes every standing notice,
+     *  so {@link setHandle} states it again once the surface is gone. */
+    private tornDownNotice;
+    private handle;
+    /** The companion pane this surface is bound to, and how it came to be.
+     *  `paneOrigin` is status-row copy only: teardown reads `paneId`. */
+    private paneId;
+    private paneOrigin;
+    /** Fork columns this surface opened, oldest first. The newest live one is
+     *  what the next fork splits against, so columns accumulate rightward. */
+    private forkPanes;
+    /** Row increments of a half-page move still to be painted, and the timer
+     *  walking them. A fresh press settles whatever is in flight before starting
+     *  its own move, so a held key cannot pile up overlapping animations. */
+    private scrollSteps;
+    private scrollTimer;
+    private state;
+    private cache;
+    /** Every non-deleted comment the daemon currently projects, newest last. */
+    private projection;
+    private status;
+    /** This surface's own error/summary state — never a host notice (D1). */
+    private problem;
+    private composeAnchorLost;
+    /** Serializes base-hash transitions so B→C cannot overtake A→B. */
+    private remapChain;
+    constructor(opts: ReviewDocumentSurfaceOptions);
+    /** Resolves once the daemon coordinate base has been aligned to the file on
+     *  disk. The owner may await it so the first painted frame already carries
+     *  current ranges; painting earlier shows only a preparing line, never a
+     *  comment at a coordinate the daemon has not accepted. */
+    open(): Promise<void>;
+    hasUnsentCompose(): boolean;
+    get focused(): boolean;
+    set focused(value: boolean);
+    setRows(rows: number): void;
+    /** Exactly the rows the host assigned: the document frame, then this
+     *  surface's status row. The document is capped at {@link DOC_MAX_COLS} and
+     *  every line is padded out to the full pane width. */
+    render(width: number): string[];
+    /** Rows the document frame itself owns. */
+    private get rows();
+    private renderDocument;
+    /** The surface consumes every chunk: nothing typed into a mounted review may
+     *  reach the transcript beneath it. Esc is the one key this surface answers
+     *  itself — it closes the review unless an unsent comment holds it open. */
+    handleInput(data: string): void;
+    /** True when the document's own modes took the chunk. */
+    private consume;
+    /** A mounted review consumes every notch, ready or not: the transcript
+     *  beneath it must never scroll while the document stands over it. */
+    handleWheel(direction: 'up' | 'down', lines: number): boolean;
+    /** A half-page move of the view and the selection together, painted at three
+     *  midpoints before its destination so the document slides rather than jumps.
+     *  Whatever is still in flight lands first, keeping every press exact. */
+    private startScrollAnimation;
+    private scheduleScrollStep;
+    /** Land every step still to be painted on the state at once. */
+    private settleScrollAnimation;
+    private stopScrollAnimation;
+    private applyScrollRows;
+    /** Repaints are scheduled by the host; this surface never draws directly. */
+    invalidate(): void;
+    /** The mounted handle is this surface's repaint and close channel, and the
+     *  host's close is what releases the document's resources. */
+    setHandle(handle: SurfaceHandle): void;
+    /** The status row's left segment: this document's state in one line. */
+    private summary;
+    /** The status row's right segment: where the companion conversation is. */
+    private companionSegment;
+    private statusRow;
+    /** Bind the conversation's pane, opening one only when this surface holds no
+     *  live pane already and there is no live companion viewer to adopt. A second
+     *  call therefore keeps the bound pane, whatever state its viewer is in. */
+    openCompanion(): void;
+    /** The pane a new fork column splits from: the newest live fork, else the
+     *  companion, else this viewer. */
+    private rightmostReviewPane;
+    /** Hand one comment to its own fork of the companion and place its column.
+     *  The comment is already saved by the time this runs, so every failure here
+     *  is stated as a notice rather than failing the comment. */
+    private forkComment;
+    /** The one path out of a review that has reached a terminal state — approved,
+     *  canceled here, or decided elsewhere. The pane goes with the review, never
+     *  with Esc: closing the document leaves the conversation standing so the
+     *  review can be re-opened over it. Idempotent. The disposition is stated
+     *  only after the close, because the host's restoring close disposes every
+     *  notice raised over the closing surface — a notice raised first would die
+     *  with the surface and the disposition would never paint. */
+    teardown(notice: string, opts?: SurfaceNoticeOptions): void;
+    /** Releases this surface's render cache and stops every projected repaint.
+     *  This surface closes the source it was handed; that close stops its watcher.
+     *  The companion pane deliberately survives: only {@link teardown} closes it. */
+    close(): void;
+    /** Bring the daemon's comment coordinates onto the bytes now on disk, then
+     *  build the first state from what the daemon accepted. The zero-comment case
+     *  still submits its batch: the base digest itself is what advances, and a
+     *  later create against current bytes is rejected until it does. */
+    private align;
+    private movedSince;
+    /** Re-derive this surface from the daemon's own coordinate base. The only
+     *  honest recovery once a batch is rejected: the local map that produced it
+     *  is no longer a true description of what the daemon holds. */
+    private realign;
+    private buildState;
+    private onSourceChanged;
+    /** One transaction covering every non-deleted comment. A rejection is stated
+     *  in this surface's own footer and the projection is re-read from the
+     *  authority, which is the only thing that can still be true afterwards. */
+    private submitBatch;
+    private refreshProjection;
+    private mutate;
+    private handleComposeKey;
+    /** The document's single-key commands, shared by view mode. Returns false
+     *  for a key that is not one of them. Space was once a prefix for these; it
+     *  is now ignored, so a remembered `space c` still lands on `c`. */
+    private handleCommandKey;
+    private submit;
+    /** Submitting ends the review, so it asks once. The armed state is answered
+     *  in {@link handleInput}, ahead of every mode's ladder. */
+    private armSubmit;
+    /** Cancelling discards the whole review, so it asks once. The armed state is
+     *  answered in {@link handleInput}, ahead of every mode's ladder. */
+    private armCancel;
+    private handleListKey;
+    private handleViewKey;
+    /** The reviewed file is the deliverable: the person's own editor writes it,
+     *  this surface never does. The source is re-read the moment the editor exits
+     *  rather than waiting for the watcher's coalescing window. */
+    private editInEditor;
+    /** The host owns cursor focus; a focused surface contributes exactly one
+     * whole marker at the same visual location the document already calls
+     * active. There is deliberately no synthetic fallback row: a marker is
+     * only valid when it belongs to a rendered anchor or the compose/list cursor. */
+    private markCursorLocation;
+    /** The frame paints source rows after its three-line header. Scroll indicators
+     * replace their source rows, so they are never cursor targets. */
+    private activeAnchorFrameRow;
+    private reflow;
+    private document;
+    private bodyHeight;
+    private composeWidth;
+    private gutterWidth;
+    /** The document frame's own footer line: its error, then its stale verdict. */
+    private footerLine;
+    private renderPlaceholder;
+    /** `frame.ts` renders the ordinary list. Detached anchors need stronger
+     *  treatment: their own leading group plus the original range and snippet,
+     *  because no document marker can lead a person back to them. */
+    private renderGroupedList;
+    /** The compose header states a lost anchor where the person is already
+     *  looking, leaving the footer's compose keys intact. */
+    private statedComposeAnchor;
+    private commentListRow;
+    private topVisibleSourceLine;
+    private repaint;
+}

package/dist/clients/inbox/review/document-surface.js

@@ -0,0 +1,2 @@
+var k=Object.defineProperty;var d=(o,e)=>k(o,"name",{value:e,configurable:!0});import{relative as ee,resolve as j}from"node:path";import{CURSOR_MARKER as F,Key as te,matchesKey as se}from"@earendil-works/pi-tui";import{documentLines as ie}from"../../../core/document-lines.js";import{codeRenderedDoc as ne}from"../../../core/termrender/code-doc.js";import{deriveAnchorUnits as C,remapUnitIndex as T,unitIndexForLine as oe,unitRangeForSpan as W}from"./anchors.js";import{centerHorizontal as N,clipLine as w,CYAN as $,DIM as A,RESET as p,REVERSE as re,sanitize as O,truncate as ce,visibleWidth as v,YELLOW as B}from"../tui/ansi.js";import{ReviewDocumentError as ae}from"./comments-client.js";import{closeCompanionPane as K,companionPaneLive as I,openCompanionPane as he,openForkPane as de}from"./companion-pane.js";import{PAN_STEP as le,docSurface as ue,maxHScroll as fe,panBy as me,renderReviewDoc as pe,renderReviewFrame as ge,listHintBar as we,renderWidthForCols as be,reservedRows as _}from"./frame.js";import{matchReviewKey as M,reviewKeyText as S}from"./keys.js";import{renderInputBuffer as ve}from"../tui/render.js";import{openReviewedFileInEditor as Le}from"./nvim.js";import{buildLineMap as V,remapRange as xe}from"./remap.js";import{cleanPastedText as Re,closeCompose as Se,closeHelp as q,closeList as z,commitCompose as Ce,ensureAnchorVisible as g,halfPageRows as $e,initReviewState as Ae,moveActiveUnit as G,moveListIndex as Y,moveViewRows as Ie,openComposeEdit as Me,openComposeNew as ye,openHelp as Pe,openList as De,scrollBy as Ue,textBackspace as He,textDelete as Ee,textEnd as je,textHome as Fe,textInsert as y,textVerticalWrapped as Te,textWordBackspace as We,textWordLeft as Ne,textWordRight as Oe,deleteAtListIndex as Be,undoLast as Ke}from"./state.js";const _e=126,Ve=4,qe=24;class mt{static{d(this,"ReviewDocumentSurface")}absFile;fileLabel;companionNodeId;companionCwd;callerPane;kind;source;comments;services;unsubscribeComments;ready;cols=0;hostRows=0;flowedRows=-1;_focused=!1;closed=!1;escapeConfirmArmed=!1;cancelArmed=!1;submitArmed=!1;tornDown=!1;tornDownNotice;handle;paneId;paneOrigin;forkPanes=[];scrollSteps=[];scrollTimer;state;cache;projection=[];status="preparing";problem;composeAnchorLost=!1;remapChain=Promise.resolve();constructor(e){this.absFile=e.review.file,this.fileLabel=Xe(e.review.cwd,e.review.file),this.companionNodeId=e.review.companionNodeId,this.companionCwd=e.review.cwd,this.callerPane=e.callerPane,this.kind=ue(e.review.file),this.source=e.source,this.comments=e.comments,this.services=e.services,this.source.onChange((t,s)=>{this.onSourceChanged(t,s)}),this.unsubscribeComments=this.comments.onChanged(()=>{this.refreshProjection()}),this.ready=this.align().catch(t=>{this.closed||(this.status="refused",this.problem=b(t),this.repaint())})}open(){return this.ready}hasUnsentCompose(){const e=this.state;return e?.mode==="compose"&&e.compose!==null&&e.compose.buffer.length>0}get focused(){return this._focused}set focused(e){this._focused!==e&&(this._focused=e,this.repaint())}setRows(e){this.hostRows=Math.max(0,Math.floor(e))}render(e){const t=Math.max(0,Math.floor(e));if(this.hostRows<=0)return[];const s=Math.min(t,_e);(s!==this.cols||this.hostRows!==this.flowedRows)&&(this.cols=s,this.flowedRows=this.hostRows,this.reflow());const i=this.rows<=0||this.cols<=0?[]:this.renderDocument();return[...Ge(i,this.rows,t),this.statusRow(t)]}get rows(){return Math.max(0,this.hostRows-1)}renderDocument(){if(this.status!=="ready"||this.state===void 0)return this.renderPlaceholder();const e=this.document(this.cols,this.state.sourceRevision),t=ge(this.state,this.fileLabel,e,this.cols,this.rows,{lineNumbers:this.kind.doc==="code",...this.footerLine()===void 0?{}:{notice:this.footerLine()}}),s=this.state.mode==="list"&&this.state.comments.some(n=>n.anchorStatus==="detached")?this.renderGroupedList(t):t,i=this.state.mode==="compose"&&this.composeAnchorLost?this.statedComposeAnchor(s):s;return this.focused?this.markCursorLocation(i,this.state):i}handleInput(e){if(!this.closed){if(this.cancelArmed){this.cancelArmed=!1;const t=M(e);if(t!==null&&S(t)==="x"){this.services.cancel();return}}if(this.submitArmed){this.submitArmed=!1;const t=M(e);if(t!==null&&S(t)==="s"){this.submit();return}}if(se(e,te.escape)){if(this.escapeConfirmArmed){if(this.escapeConfirmArmed=!1,this.consume(e))return;this.services.requestClose();return}if(this.hasUnsentCompose()){this.escapeConfirmArmed=!0,this.services.notice("unsent comment \u2014 press esc again to discard"),this.repaint();return}if(this.consume(e))return;this.services.requestClose();return}this.escapeConfirmArmed&&(this.escapeConfirmArmed=!1),this.consume(e)}}consume(e){if(this.status!=="ready")return!1;const t=this.state;if(t===void 0)return!1;const s=M(e);if(s===null)return!1;if(t.mode==="compose")return this.handleComposeKey(s),this.repaint(),!0;if(t.mode==="list"){const i=this.handleListKey(s);return this.repaint(),i}return t.mode==="help"?s.type==="help"||s.type==="cancel"&&s.text===void 0?(this.state=q(t),this.repaint(),!0):s.type==="cancel"?(this.state=q(t),this.repaint(),!0):!1:this.handleViewKey(s)}handleWheel(e,t){if(this.closed)return!1;const s=this.state;if(this.status!=="ready"||s===void 0)return!0;this.settleScrollAnimation();const i=this.state??s,n=this.document(this.cols,i.sourceRevision),r=(e==="up"?-1:1)*Math.max(1,Math.floor(t));return this.state=Ue(i,r,this.bodyHeight(i),n.lines.length),this.repaint(),!0}startScrollAnimation(e){this.settleScrollAnimation();const t=ze(e),s=t.shift();s!==void 0&&(this.applyScrollRows(s),this.scrollSteps=t,this.scheduleScrollStep())}scheduleScrollStep(){this.scrollSteps.length!==0&&(this.scrollTimer=setTimeout(()=>{this.scrollTimer=void 0;const e=this.scrollSteps.shift();e===void 0||this.closed||(this.applyScrollRows(e),this.repaint(),this.scheduleScrollStep())},qe))}settleScrollAnimation(){this.stopScrollAnimation();const e=this.scrollSteps;this.scrollSteps=[];for(const t of e)this.applyScrollRows(t)}stopScrollAnimation(){this.scrollTimer!==void 0&&(clearTimeout(this.scrollTimer),this.scrollTimer=void 0)}applyScrollRows(e){const t=this.state;if(this.status!=="ready"||t===void 0)return;const s=this.document(this.cols,t.sourceRevision);this.state=Ie(t,e,this.bodyHeight(t),s.lines.length)}invalidate(){this.closed||this.handle?.invalidate()}setHandle(e){if(this.handle===void 0&&(this.handle=e,e.onClose(()=>this.close()),this.tornDown)){e.close();const t=this.tornDownNotice;this.tornDownNotice=void 0,t!==void 0&&this.services.notice(t.text,t.opts)}}summary(){if(this.status==="refused")return`${this.fileLabel} \u2014 unavailable`;if(this.status==="preparing")return`${this.fileLabel} \u2014 preparing`;const e=this.projection.filter(i=>i.status==="open").length,t=this.projection.filter(i=>i.anchorStatus==="detached").length,s=[this.fileLabel,`${e} open`];return t>0&&s.push(`${t} detached`),this.source.current().status==="stale"&&s.push(`stale (${this.source.current().staleReason??"unreadable"})`),s.join(" \xB7 ")}companionSegment(){const e=this.paneOrigin===void 0?"companion none":`companion ${this.paneOrigin}`,t=this.forkPanes.length;return t===0?e:`${e} \xB7 ${t} fork${t===1?"":"s"}`}statusRow(e){if(e<=0)return"";const t=w(this.companionSegment(),e),s=w(this.summary(),Math.max(0,e-v(t)-1)),i=Math.max(0,e-v(s)-v(t));return`${A}${s}${" ".repeat(i)}${t}${p}`}openCompanion(){if(this.closed||this.tornDown||this.paneId!==void 0&&I(this.paneId))return;const e=he({companionNodeId:this.companionNodeId,cwd:this.companionCwd,callerPane:this.callerPane});if(e.ok){this.paneId=e.paneId,this.paneOrigin=e.origin,this.repaint();return}if(e.reason==="split_refused"){this.services.notice("tmux refused the companion split \u2014 press a to retry");return}this.services.notice(`The review companion needs tmux \u2014 run: crtr surface attach to ${this.companionNodeId}`,{sticky:!0})}rightmostReviewPane(){for(let e=this.forkPanes.length-1;e>=0;e-=1){const t=this.forkPanes[e];if(I(t.paneId))return t.paneId}return this.paneId!==void 0&&I(this.paneId)?this.paneId:this.callerPane}async forkComment(e){if(this.closed||this.tornDown)return;let t;try{t=await this.comments.fork(e)}catch(i){this.services.notice(`the comment was saved, but its fork could not start \u2014 ${b(i)}`);return}if(this.closed||this.tornDown)return;const s=de({nodeId:t.nodeId,cwd:t.cwd,splitFrom:this.rightmostReviewPane()});if(s.ok){this.forkPanes.push({paneId:s.paneId,nodeId:t.nodeId}),this.repaint();return}this.services.notice(s.reason==="no_room"?`no room for another fork column \u2014 the fork is running: crtr surface attach to ${t.nodeId}`:`the fork is running, but tmux gave it no column \u2014 run: crtr surface attach to ${t.nodeId}`,{sticky:!0})}teardown(e,t){if(!this.tornDown){this.tornDown=!0;for(const s of this.forkPanes)K(s.paneId,s.nodeId);this.forkPanes=[],this.paneId!==void 0&&K(this.paneId,this.companionNodeId),this.paneId=void 0,this.paneOrigin=void 0,this.handle===void 0&&(this.tornDownNotice={text:e,...t===void 0?{}:{opts:t}}),this.handle?.close(),this.services.notice(e,t)}}close(){this.closed||(this.source.close(),this.closed=!0,this.stopScrollAnimation(),this.scrollSteps=[],this.unsubscribeComments(),this.cache=void 0)}async align(){for(;;){const e=await this.comments.anchorBase();if(this.closed)return;if(j(e.file)!==j(this.absFile))throw new Error(`review document mismatch \u2014 the daemon's canonical file is ${e.file}, not ${this.absFile}`);const t=this.source.current();if(t.status==="stale")throw new Error(`the reviewed file cannot be read (${t.staleReason??"unreadable"})`);if(e.docHash!==t.sha256){const i=await this.comments.list();if(this.closed)return;if(this.movedSince(t))continue;const n=V(ie(e.text),t.lines);if(await this.comments.remapRanges({fromDocHash:e.docHash,toDocHash:t.sha256,entries:Ze(P(i),n)}),this.closed)return}const s=await this.comments.list();if(this.closed)return;if(!this.movedSince(t)){this.projection=P(s),this.status="ready",this.buildState(t),this.repaint();return}}}movedSince(e){const t=this.source.current();return t.status==="live"&&t.sha256!==e.sha256}async realign(){if(!this.closed)try{await this.align()}catch(e){if(this.closed)return;this.status="refused",this.problem=b(e),this.repaint()}}buildState(e){const t=this.document(this.cols,e.revision);this.state=Ae(e.lines,C(t),D(this.projection),e.revision),this.state=g(this.state,t,this.bodyHeight(this.state))}onSourceChanged(e,t){if(this.closed||this.status!=="ready")return;const s=this.state;if(s===void 0)return;if(e.status==="stale"){this.problem=void 0,this.repaint();return}if(e.text===t.text){this.problem=void 0,this.repaint();return}const i=V(t.lines,e.lines),n=new Map;for(const a of this.projection)n.set(a.id,a.anchorStatus==="detached"?{range:a.originalRange??{line:a.line,endLine:a.endLine},detached:!0}:L(i,{line:a.line,endLine:a.endLine}));const r=s.compose===null||this.composeAnchorLost?void 0:L(i,s.compose.anchor),c=L(i,X(s,s.activeUnit)),u=s.selectionAnchor===null?void 0:L(i,X(s,s.selectionAnchor)),l=Je(i,this.topVisibleSourceLine(s),t.lines.length),f=this.document(this.cols,e.revision),{units:m,rowUnits:h}=C(f),J=W(m,c.range.line,c.range.endLine).hi,Q=u===void 0?null:W(m,u.range.line,u.range.endLine).lo,x=this.projection.map(a=>{const E=n.get(a.id);return E===void 0?a:Qe(a,E)});this.projection=x;const H={};for(const a of x)a.anchorStatus==="detached"&&(H[a.id]=a.originalRange??{line:a.line,endLine:a.endLine});this.composeAnchorLost=this.composeAnchorLost||r?.detached===!0;const Z=s.compose===null||r===void 0?s.compose:{...s.compose,anchor:r.range};let R={...s,sourceLines:e.lines,units:m,rowUnits:h,comments:D(x),sourceRevision:e.revision,detached:H,activeUnit:J,selectionAnchor:Q,compose:Z,listIndex:Math.max(0,Math.min(s.listIndex,x.length-1)),scroll:m[oe(m,l)]?.firstRow??0};R=g(R,f,this.bodyHeight(R)),this.state=R,this.problem=this.composeAnchorLost?"the commented lines were removed \u2014 this comment has no anchor":void 0,this.repaint(),this.remapChain=this.remapChain.then(()=>this.submitBatch(t.sha256,e.sha256,n),()=>this.submitBatch(t.sha256,e.sha256,n))}async submitBatch(e,t,s){if(this.closed)return;const i=[...s].map(([n,r])=>r.detached?{id:n,detached:!0}:{id:n,anchor:r.range});try{if(await this.comments.remapRanges({fromDocHash:e,toDocHash:t,entries:i}),this.closed)return;await this.refreshProjection()}catch(n){if(this.closed)return;this.problem=`comment ranges were rejected \u2014 ${b(n)}`,this.repaint(),await this.realign()}}async refreshProjection(){if(!(this.closed||this.status==="refused"))try{const e=P(await this.comments.list());if(this.closed)return;this.projection=e;const t=this.state;if(t!==void 0){const s=D(e);this.state={...t,comments:s,detached:Object.fromEntries(s.flatMap(i=>i.anchorStatus==="detached"?[[i.id,i.originalRange??{line:i.line,endLine:i.endLine}]]:[])),listIndex:Math.max(0,Math.min(t.listIndex,s.length-1))}}this.repaint()}catch(e){if(this.closed)return;this.problem=`comments could not be read \u2014 ${b(e)}`,this.repaint()}}async mutate(e){if(!this.closed){try{if(await e(),this.closed)return;this.problem=void 0}catch(t){if(this.closed)return;this.problem=t instanceof ae?`${t.code.replace(/_/g," ")} \u2014 the document moved under this comment`:b(t),this.repaint()}await this.refreshProjection()}}handleComposeKey(e){const t=this.state,s=t?.compose;if(t===void 0||s===null||s===void 0)return;if(e.type==="cancel"&&e.text===void 0){this.composeAnchorLost=!1,this.state=Se(t);return}if(e.type==="confirm"||e.type==="confirmFork"){if(this.composeAnchorLost){this.problem="comment not saved \u2014 its anchored lines were removed";return}const n=Ce(t);this.composeAnchorLost=!1,this.state=n.state;const r=n.commit;if(r===null)return;const c=e.type==="confirmFork",u=this.source.current().sha256;if(r.editingId===null){this.mutate(async()=>{const f=await this.comments.create({line:r.anchor.line,endLine:r.anchor.endLine,text:r.text,docHash:u});c&&await this.forkComment(f)});return}const l=this.projection.find(f=>f.id===r.editingId);if(l===void 0){this.problem="that comment no longer exists";return}this.mutate(async()=>{await this.comments.edit({id:l.id,text:r.text,ifRevision:l.revision}),c&&await this.forkComment(l.id)});return}if(e.type==="composeNewline"){this.state={...t,compose:{...s,...y(s.buffer,s.cursor,`
+`)}};return}if(e.type==="composeWordBackspace"){this.state={...t,compose:{...s,...We(s.buffer,s.cursor)}};return}if(e.type==="composeBackspace"){this.state={...t,compose:{...s,...He(s.buffer,s.cursor)}};return}if(e.type==="composeDelete"){this.state={...t,compose:{...s,...Ee(s.buffer,s.cursor)}};return}if(e.type==="composeMove"){const n=e.direction==="wordLeft"?Ne(s.buffer,s.cursor):Oe(s.buffer,s.cursor);this.state={...t,compose:{...s,cursor:n}};return}if(e.type==="arrow"&&e.direction==="left"){this.state={...t,compose:{...s,cursor:Math.max(0,s.cursor-1)}};return}if(e.type==="arrow"&&e.direction==="right"){this.state={...t,compose:{...s,cursor:Math.min([...s.buffer].length,s.cursor+1)}};return}if(e.type==="composeHome"){this.state={...t,compose:{...s,cursor:Fe(s.buffer,s.cursor)}};return}if(e.type==="composeEnd"){this.state={...t,compose:{...s,cursor:je(s.buffer,s.cursor)}};return}if(e.type==="arrow"&&(e.direction==="up"||e.direction==="down")){const n=e.direction==="up"?-1:1;this.state={...t,compose:{...s,cursor:Te(s.buffer,s.cursor,n,this.composeWidth())}};return}const i=S(e);if(i!==void 0){if(e.type==="paste"){const n=Re(i);if(n.length===0)return;this.state={...t,compose:{...s,...y(s.buffer,s.cursor,n)}};return}this.state={...t,compose:{...s,...y(s.buffer,s.cursor,i)}}}}handleCommandKey(e){const t=this.state;if(t===void 0)return!1;const s=e.type==="confirm"?"c":S(e);if(s==="c"){const i=ye(t);this.composeAnchorLost=!1,this.state=g(i,this.document(this.cols,i.sourceRevision),this.bodyHeight(i))}else if(s==="C")this.state=De(t);else if(s==="U"){const i=Ke(t);if(i.id!==null){const n=i.id;this.mutate(()=>this.comments.remove(n))}}else if(s==="e")this.editInEditor();else if(s==="s")this.armSubmit();else if(s==="a")this.openCompanion();else if(s==="x")this.armCancel();else if(s!==" ")return!1;return this.repaint(),!0}submit(){const e=this.source.current();if(e.status==="stale"){this.problem=`approval refused while the source is ${e.staleReason??"unreadable"}`,this.repaint();return}this.services.submit()}armSubmit(){this.submitArmed=!0,this.services.notice("submit and approve this review? press s again to confirm")}armCancel(){this.cancelArmed=!0,this.services.notice("cancel this review? press x again to confirm")}handleListKey(e){const t=this.state;if(t===void 0)return!1;if(e.type==="cancel")return this.state=z(t),!0;if(e.type==="moveUnit"&&e.text==="j"||e.type==="arrow"&&e.direction==="down")return this.state=Y(t,1),!0;if(e.type==="moveUnit"&&e.text==="k"||e.type==="arrow"&&e.direction==="up")return this.state=Y(t,-1),!0;if(e.type==="listEdit"||e.type==="confirm"){if(t.comments.length>0){const s=Me(t,t.listIndex);this.composeAnchorLost=!1,this.state=g(s,this.document(this.cols,s.sourceRevision),this.bodyHeight(s))}return!0}if(e.type==="scrollPage"&&e.text==="d"&&t.comments.length>0){const s=Be(t);if(s.id!==null){const i=s.id;this.mutate(()=>this.comments.remove(i))}return!0}return e.type==="printable"&&e.text==="c"?(this.state=z(t),this.handleCommandKey(e)):!1}handleViewKey(e){const t=this.state;if(t===void 0)return!1;const s=this.document(this.cols,t.sourceRevision),i=this.bodyHeight(t);if(e.type==="moveUnit"||e.type==="arrow"&&(e.direction==="up"||e.direction==="down")){const n=e.type==="moveUnit"?e.delta:e.direction==="down"?1:-1;this.state=g(G(t,n,!1),s,i)}else if(e.type==="extendUnit")this.state=g(G(t,e.delta,!0),s,i);else if(e.type==="scrollPage")this.startScrollAnimation(e.delta*$e(i));else if((e.type==="pan"||e.type==="arrow"&&(e.direction==="left"||e.direction==="right"))&&fe(t,s,this.cols,this.rows,this.gutterWidth())>0){const n=e.type==="pan"?e.delta:e.direction==="right"?1:-1;this.state=me(t,n*le,s,this.cols,this.rows,this.gutterWidth())}else if(e.type==="help")this.state=Pe(t);else return e.type==="cancel"&&e.text===void 0||e.type==="cancel"?!1:this.handleCommandKey(e);return this.repaint(),!0}editInEditor(){const e=this.state;if(e===void 0)return;const t=e.units[e.activeUnit]?.start??1,s=this.services.suspendForChild();try{const i=Le(this.absFile,t);i.error!==void 0&&(this.problem=`editor failed \u2014 ${i.error}`)}finally{s()}this.source.refreshNow()}markCursorLocation(e,t){if(t.mode==="compose")return U(e,re);if(t.mode==="list"){const i=U(e,`${$}\u25B8${p}`);if(i!==e)return i}const s=this.activeAnchorFrameRow(t);return s===void 0?e:U(e,`${$}\u258C${p}`,s)}activeAnchorFrameRow(e){const t=Math.max(1,this.rows-_(e,this.cols)),s=e.rowUnits.length,i=Math.max(0,Math.min(e.scroll,Math.max(0,s-t)));for(let n=0;n<t;n++){const r=i+n;if(!(n===0&&i>0||n===t-1&&r<s-1)&&e.rowUnits[r]===e.activeUnit)return 3+n}}reflow(){const e=this.state;if(e===void 0||this.cols<=0)return;const t=e.units[e.activeUnit],s=e.selectionAnchor===null?void 0:e.units[e.selectionAnchor],i=this.document(this.cols,e.sourceRevision),{units:n,rowUnits:r}=C(i),c={...e,units:n,rowUnits:r,activeUnit:t===void 0?0:T(n,t),selectionAnchor:s===void 0?null:T(n,s)};this.state=g(c,i,this.bodyHeight(c))}document(e,t){const s=this.cache;if(s!==void 0&&s.width===e&&s.sourceRevision===t)return s.doc;const i=this.source.current().text,n=this.kind.doc==="code"?ne(i,this.kind.language??"text",be(e)):pe(i,e);return this.cache={width:e,sourceRevision:t,doc:n},n}bodyHeight(e){const t=e.mode==="list"&&e.comments.some(s=>s.anchorStatus==="detached")?1+(e.comments.some(s=>s.anchorStatus!=="detached")?1:0):0;return Math.max(1,this.rows-_(e,this.cols)-t)}composeWidth(){return Math.max(10,Math.min(Math.max(20,this.cols-4),120)-2)}gutterWidth(){return this.kind.doc==="code"?String(this.source.current().lines.length).length:0}footerLine(){if(this.problem!==void 0)return this.problem;const e=this.source.current();if(e.status==="stale")return`source ${e.staleReason??"unreadable"} \u2014 showing the last good read; approval is refused`}renderPlaceholder(){const t=["",`  ${this.status==="refused"?`Review unavailable \u2014 ${this.problem??"the document could not be prepared"}`:`Preparing ${this.fileLabel}\u2026`}`];for(;t.length<this.rows;)t.push("");return t.slice(0,this.rows).map(s=>w(s,this.cols))}renderGroupedList(e){const t=this.state,s=Math.min(Math.max(20,this.cols-4),120),i=t.comments.filter(h=>h.anchorStatus==="detached"),n=t.comments.filter(h=>h.anchorStatus!=="detached"),r=[`  ${B}Detached${p}`];for(const h of i)r.push(this.commentListRow(h,t.comments.indexOf(h),s,!0));if(n.length>0){r.push(`  ${A}Comments${p}`);for(const h of n)r.push(this.commentListRow(h,t.comments.indexOf(h),s,!1))}r.push(""),r.push(we(s));const c=Math.max(0,this.rows-3),u=r.slice(0,c),l=Math.max(3,this.rows-u.length),f=[...e],m=N(u,this.cols,Math.min(this.cols,s+2));for(let h=0;h<m.length;h++)f[l+h]=w(m[h]??"",this.cols);return f.slice(0,this.rows)}statedComposeAnchor(e){const t=this.state;if(t?.compose==null)return e;const s=Math.min(Math.max(20,this.cols-4),120),i=ve(t.compose.buffer,t.compose.cursor,Math.max(10,s-2)).length,n=this.rows-(i+3);if(n<0||n>=e.length)return e;const r=[...e];return r[n]=w(N([`  ${B}Comment anchor removed by an edit \u2014 esc, then re-anchor:${p}`],this.cols,Math.min(this.cols,s+2))[0]??"",this.cols),r}commentListRow(e,t,s,i){const n=i?e.originalRange??{line:e.line,endLine:e.endLine}:{line:e.line,endLine:e.endLine},r=n.line===n.endLine?`L${n.line}`:`L${n.line}-${n.endLine}`,c=t===this.state.listIndex?`${$}\u25B8${p}`:" ",l=`${i?`\u201C${O(e.lineText).replace(/\s+/g," ").trim()}\u201D \xB7 `:""}${O(e.comment).replace(/\s+/g," ").trim()}`;return`  ${c} ${A}[${r}]${p} ${ce(l,Math.max(10,s-14))}`}topVisibleSourceLine(e){const t=e.rowUnits[e.scroll];if(t!=null)return e.units[t]?.start??1;for(let s=e.scroll;s<e.rowUnits.length;s++){const i=e.rowUnits[s];if(i!=null)return e.units[i]?.start??1}return 1}repaint(){this.invalidate()}}function ze(o){const e=Math.abs(o);if(e===0)return[];const t=Math.sign(o),s=Math.min(Ve,e),i=[];let n=0;for(let r=1;r<=s;r++){const c=Math.round(e*r/s);i.push((c-n)*t),n=c}return i}d(ze,"splitScrollSteps");function Ge(o,e,t){const s=o.slice(0,e).map(i=>Ye(i,t));for(;s.length<e;)s.push(" ".repeat(t));return s}d(Ge,"exactRows");function Ye(o,e){const t=o.split(F).join(""),s=v(t);if(s>e){const i=w(t,e);return i+" ".repeat(Math.max(0,e-v(i)))}return o+" ".repeat(e-s)}d(Ye,"padTo");function Xe(o,e){const t=ee(o,e);return t===""||t.startsWith("..")?e:t}d(Xe,"labelFor");function P(o){return o.filter(e=>e.status!=="deleted")}d(P,"nonDeleted");function D(o){const e=o.filter(s=>s.anchorStatus==="detached"),t=o.filter(s=>s.anchorStatus!=="detached");return[...e,...t]}d(D,"orderedForDisplay");function X(o,e){const t=o.units[e];return t===void 0?{line:1,endLine:1}:{line:t.start,endLine:t.end}}d(X,"unitRange");function L(o,e){const t=xe(o,{line:e.line-1,endLine:e.endLine});return t.kind==="detached"?{range:e,detached:!0}:{range:{line:t.line+1,endLine:Math.max(t.line+1,t.endLine)},detached:!1}}d(L,"mapRange");function Je(o,e,t){const s=e-1,i=o.get(s);if(i!==void 0)return i+1;for(let n=1;n<t;n++){const r=o.get(s+n);if(r!==void 0)return r+1;const c=o.get(s-n);if(c!==void 0)return c+1}return 1}d(Je,"mapLine");function Qe(o,e){if(e.detached)return{...o,anchorStatus:"detached",originalRange:o.originalRange??{line:o.line,endLine:o.endLine}};if(o.anchorStatus==="detached")return o;const t=e.range.line!==o.line||e.range.endLine!==o.endLine;return{...o,line:e.range.line,endLine:e.range.endLine,anchorStatus:t?"shifted":o.anchorStatus}}d(Qe,"applyMappedRange");function Ze(o,e){return o.map(t=>{if(t.anchorStatus==="detached")return{id:t.id,detached:!0};const s=L(e,{line:t.line,endLine:t.endLine});return s.detached?{id:t.id,detached:!0}:{id:t.id,anchor:s.range}})}d(Ze,"batchEntries");function U(o,e,t){const s=t??o.findIndex(c=>c.includes(e)),i=o[s];if(i===void 0)return o;const n=i.indexOf(e);if(n===-1)return o;const r=[...o];return r[s]=`${i.slice(0,n)}${F}${i.slice(n)}`,r}d(U,"markAtToken");function b(o){return o instanceof Error?o.message:String(o)}d(b,"describe");export{mt as ReviewDocumentSurface};

package/dist/clients/inbox/review/frame.d.ts

@@ -0,0 +1,57 @@
+import type { RenderedDoc } from '../../../core/termrender/termrender.js';
+import type { ReviewState } from './state.js';
+/** Width prose is rendered at for a given terminal width: 2-col left
+ *  margin + 2-col gutter before the content, capped for readability. */
+export declare function renderWidthForCols(cols: number): number;
+/** The body rectangle a rendered row is painted into: the terminal minus the
+ *  4-col gutter prefix. Diagram blocks render at this width (no prose cap),
+ *  and every emitted body row is contained within it. */
+export declare function contentWidthForCols(cols: number): number;
+/** Body width left after an optional line-number gutter. */
+export declare function bodyWidth(cols: number, gutterW?: number): number;
+/** The mapped render this surface paints: prose at the readability cap,
+ *  diagrams at the full body width. */
+export declare function renderReviewDoc(content: string, cols: number): RenderedDoc;
+/** Widest painted row, in display cells, for a body window. */
+export declare function widestVisibleRow(doc: RenderedDoc, scroll: number, bodyHeight: number): number;
+/** How far the body can pan right, given what is currently on screen. Zero
+ *  when nothing visible overflows — which is also what makes h/l contextual:
+ *  the keys only pan while an overflowing row is in view. */
+export declare function maxHScroll(state: ReviewState, doc: RenderedDoc, cols: number, rows: number, gutterW?: number): number;
+/** Pan the body horizontally, clamped to what is currently reachable. The
+ *  stored offset is only ever clamped against the live window, so vertical
+ *  scrolling and resize can never leave it pointing past the content. */
+export declare function panBy(state: ReviewState, delta: number, doc: RenderedDoc, cols: number, rows: number, gutterW?: number): ReviewState;
+/** Cells one h/l press pans by — a chunk large enough to cross a diagram in a
+ *  few presses, small enough to keep orientation. */
+export declare const PAN_STEP = 8;
+/** One labeled key. A key is never shown without what it does. */
+export interface KeyHint {
+    key: string;
+    label: string;
+    /** Lower survives a narrow pane longer. */
+    priority: number;
+}
+/** The hints that fit `width`, in their declared order. When they do not all
+ *  fit, the least important are dropped whole — never cut mid-label. */
+export declare function fitHints(hints: readonly KeyHint[], width: number): KeyHint[];
+/** The comment list's key bar, for the grouped list the surface paints itself. */
+export declare function listHintBar(width: number): string;
+/** Reserved (non-body) rows for each mode's fixed header/footer chrome. Kept in
+ *  sync with renderReviewFrame so scroll math can clamp before a repaint — the
+ *  compose case counts the same hard-wrapped input lines the frame renders. */
+export declare function reservedRows(state: ReviewState, cols: number): number;
+export declare function renderReviewFrame(state: ReviewState, fileLabel: string, doc: RenderedDoc, cols: number, rows: number, opts?: {
+    lineNumbers?: boolean;
+    notice?: string;
+}): string[];
+export interface ReviewSurfaceKind {
+    /** `markdown` renders the file AS a document; `code` renders it as a
+     *  syntax-highlighted source panel with a line-number gutter. */
+    doc: 'markdown' | 'code';
+    /** Fence language for `doc: 'code'` (see `fenceLanguageFor`). */
+    language?: string;
+}
+/** How a reviewed file is presented: markdown renders as a document, anything
+ * else as a syntax-highlighted source panel. */
+export declare function docSurface(absFile: string): ReviewSurfaceKind;

package/dist/clients/inbox/review/frame.js

@@ -0,0 +1 @@
+var ee=Object.defineProperty;var a=(e,n)=>ee(e,"name",{value:n,configurable:!0});import ne from"string-width";import{renderMarkdownBlockAware as te}from"../../../core/termrender/termrender.js";import{fenceLanguageFor as oe,isMarkdownFile as re}from"../../../core/termrender/code-doc.js";import{renderInputBuffer as H}from"../tui/render.js";import{BOLD as v,CYAN as g,DIM as $,ESC as T,RESET as i,YELLOW as S,centerHorizontal as I,clipLine as B,hline as ie,panLine as le,sanitize as se,truncate as ae,visibleWidth as M}from"../tui/ansi.js";import{commentedUnitSet as ce,selectedUnitBounds as he}from"./state.js";function O(e){return Math.min(Math.max(20,e-6),120)}a(O,"renderWidthForCols");function _(e){return Math.max(20,e-4)}a(_,"contentWidthForCols");function F(e,n=0){return Math.max(1,_(e)-(n>0?n+1:0))}a(F,"bodyWidth");function We(e,n){return te(e,O(n),_(n))}a(We,"renderReviewDoc");function N(e,n,o){const t=[];for(let h=0;h<o;h++){const l=n+h;t.push(l<e.lines.length?{abs:l,line:e.lines[l]}:{abs:null,line:""})}n>0&&t.length>0&&(t[0]={abs:null,line:`  ${$}\u2191 ${n} more above${i}`});const s=e.lines.length-(n+o);return s>0&&t.length>0&&(t[t.length-1]={abs:null,line:`  ${$}\u2193 ${s} more below${i}`}),t}a(N,"paintedBodyRows");function P(e,n,o){let t=0;for(const s of N(e,n,o))t=Math.max(t,M(s.line));return t}a(P,"widestVisibleRow");function me(e,n,o,t,s=0){const h=Math.max(1,t-ge(e,o)),l=Math.max(0,n.lines.length-h),m=Math.max(0,Math.min(e.scroll,l));return Math.max(0,P(n,m,h)-F(o,s))}a(me,"maxHScroll");function Re(e,n,o,t,s,h=0){const l=me(e,o,t,s,h),m=Math.max(0,Math.min(e.hscroll+n,l));return m===e.hscroll?e:{...e,hscroll:m}}a(Re,"panBy");const Ie=8,D=`${T}48;5;236m`;function ue(e,n){const o=Math.max(0,n-ne(se(e)));return D+e.replaceAll(i,i+D)+" ".repeat(o)+i}a(ue,"tintRow");const A=`${T}48;5;237m`;function y(e,n){const o=B(e,n),t=Math.max(0,n-M(o));return`  ${A}${o.replaceAll(i,i+A)}${" ".repeat(t)}${i}`}a(y,"chromeRow");const pe=[{key:"c",label:"comment",priority:0},{key:"C",label:"all comments",priority:2},{key:"U",label:"undo",priority:6},{key:"a",label:"agent pane",priority:3},{key:"e",label:"$EDITOR",priority:7},{key:"s",label:"submit",priority:4},{key:"x",label:"cancel",priority:8},{key:"?",label:"all keys",priority:1},{key:"esc",label:"close",priority:5}],$e=[{key:"enter",label:"save",priority:0},{key:"^\u23CE/^F",label:"save + hand to its own agent",priority:2},{key:"^J/\u2325\u23CE",label:"newline",priority:3},{key:"esc",label:"discard",priority:1}],U=[{key:"\u2191\u2193/jk",label:"move",priority:1},{key:"enter/e",label:"edit",priority:0},{key:"d",label:"delete",priority:2},{key:"c",label:"new comment",priority:3},{key:"esc",label:"back",priority:0}];function de(e){return`${v}${g}${e.key}${i} ${e.label}`}a(de,"hintText");function fe(e,n){const t=a(l=>1+l.reduce((m,x,c)=>m+M(`${x.key} ${x.label}`)+(c===0?0:3),0),"cost");let s=[...e];const h=[...e].sort((l,m)=>m.priority-l.priority);for(const l of h){if(t(s)<=n)break;s=s.filter(m=>m!==l)}return s}a(fe,"fitHints");function E(e,n){const o=fe(e,n);return y(` ${o.map(de).join(` ${$}\xB7${i} `)}`,n)}a(E,"hintBar");function Ce(e){return E(U,e)}a(Ce,"listHintBar");const K=[{title:"Comment",rows:[["c / enter","comment on the highlighted block (J/K widens it)"],["C","all comments \u2014 edit or delete them there"],["U","undo your last comment"],["^\u23CE / ^F","while writing: save + hand to its own agent"]]},{title:"Read",rows:[["\u2191\u2193 / j k","next / previous block"],["J / K","extend the highlight down / up"],["u / d","half a page up / down"],["\u2190\u2192 / h l","pan a diagram wider than the pane"]]},{title:"Finish",rows:[["a","open the agent pane beside the document"],["e","edit the document yourself in $EDITOR"],["s s","approve and submit the review"],["x x","cancel the review"],["esc","leave \u2014 the review stays open in the inbox"]]}],ye=12;function xe(e){const n=[y(` ${v}Keys${i}  ${$}? or esc closes this${i}`,e)];for(const o of K){n.push(y("",e)),n.push(y(` ${S}${o.title}${i}`,e));for(const[t,s]of o.rows)n.push(y(`   ${v}${g}${t.padEnd(ye)}${i}${s}`,e))}return n}a(xe,"helpPanel");const be=1+K.reduce((e,n)=>e+2+n.rows.length,0);function ge(e,n){if(e.mode==="view")return 4;if(e.mode==="compose"){const t=e.compose,s=Math.min(Math.max(20,n-4),120);return 6+(t?H(t.buffer,t.cursor,Math.max(10,s-2)).length:1)}return e.mode==="list"?3+Math.max(1,e.comments.length)+2:3+be}a(ge,"reservedRows");function He(e,n,o,t,s,h){const l=Math.min(Math.max(20,t-4),120),m=O(t),x=["",`  ${v}${g}Review \u2014 ${n}${i}  ${$}${e.comments.length} comment${e.comments.length===1?"":"s"}${i}`,`  ${$}${ie(l)}${i}`],c=[];if(e.mode==="compose"&&e.compose){const r=e.compose,u=r.anchor.line===r.anchor.endLine?`L${r.anchor.line}`:`L${r.anchor.line}-${r.anchor.endLine}`;c.push(`  ${S}${r.editingId!==null?"Edit comment":"Comment"} on ${u}:${i}`);for(const p of H(r.buffer,r.cursor,Math.max(10,l-2)))c.push(`  ${p}`);c.push(""),c.push(E($e,l))}else e.mode==="list"?(e.comments.length===0?c.push(`  ${$}(no comments yet \u2014 press c to comment on the highlighted block)${i}`):e.comments.forEach((r,u)=>{const p=r.line===r.endLine?`L${r.line}`:`L${r.line}-${r.endLine}`,L=u===e.listIndex?`${g}\u25B8${i}`:" ",b=ae(r.comment.replace(/\n/g," / "),Math.max(10,l-14));c.push(`  ${L} ${$}[${p}]${i} ${b}`)}),c.push(""),c.push(E(U,l))):e.mode==="help"?c.push(...xe(l)):c.push(E(pe,l));h?.notice!==void 0&&c.length>0&&(c[c.length-1]=y(` ${S}${h.notice}${i}`,l));const j=x.length+c.length,k=Math.max(1,s-j),J=Math.max(0,o.lines.length-k),C=Math.max(0,Math.min(e.scroll,J)),d=h?.lineNumbers===!0?String(o.lines.length).length:0,W=F(t,d),Y=P(o,C,k),z=Math.max(0,Y-W),G=Math.max(0,Math.min(e.hscroll,z)),{lo:V,hi:q}=he(e),Q=ce(e),f=[];for(const r of N(o,C,k)){if(r.abs===null){f.push(`  ${" ".repeat(d>0?d+1:0)}${r.line}`);continue}const u=le(r.line,G,W),p=e.rowUnits[r.abs]??null,L=o.spans[r.abs]?.[0],b=d>0?L===void 0?" ".repeat(d+1):`${$}${String(L).padStart(d)}${i} `:"",Z=Math.min(W,Math.max(m,M(u)));p!==null&&p>=V&&p<=q?f.push(`  ${g}\u258C${i} ${b}${ue(u,Z)}`):p!==null&&Q.has(p)?f.push(`  ${S}\u258E${i} ${b}${u}`):f.push(`    ${b}${u}`)}for(;f.length<k;)f.push("");const w=Math.min(t,Math.max(l+2,m+4+(d>0?d+1:0))),X=f.map(r=>{const u=M(r)>w?t:w;return I([r],t,u)[0]??""}),R=[...I(x,t,w),...X,...I(c,t,w)];for(;R.length<s;)R.push("");return R.slice(0,s).map(r=>B(r,t))}a(He,"renderReviewFrame");function Te(e){return re(e)?{doc:"markdown"}:{doc:"code",language:oe(e)}}a(Te,"docSurface");export{Ie as PAN_STEP,F as bodyWidth,_ as contentWidthForCols,Te as docSurface,fe as fitHints,Ce as listHintBar,me as maxHScroll,Re as panBy,We as renderReviewDoc,He as renderReviewFrame,O as renderWidthForCols,ge as reservedRows,P as widestVisibleRow};

package/dist/clients/inbox/review/keys.d.ts

@@ -0,0 +1,69 @@
+/** A semantic keypress for the review surface. Textual commands retain their
+ * text because their meaning is mode-dependent: `j` navigates in view/list
+ * mode and inserts in compose mode, for example. */
+export type ReviewKey = {
+    type: 'moveUnit';
+    delta: -1 | 1;
+    text: 'j' | 'k';
+} | {
+    type: 'extendUnit';
+    delta: -1 | 1;
+    text: 'J' | 'K';
+} | {
+    type: 'scrollPage';
+    delta: -1 | 1;
+    text?: 'u' | 'd';
+} | {
+    type: 'pan';
+    delta: -1 | 1;
+    text?: 'h' | 'l';
+} | {
+    type: 'space';
+    text: ' ';
+} | {
+    type: 'help';
+    text: '?';
+} | {
+    type: 'listEdit';
+    text: 'e';
+} | {
+    type: 'cancel';
+    text?: 'q';
+} | {
+    type: 'confirm';
+} | {
+    type: 'confirmFork';
+} | {
+    type: 'tab';
+    reverse: boolean;
+} | {
+    type: 'composeNewline';
+} | {
+    type: 'composeBackspace';
+} | {
+    type: 'composeWordBackspace';
+} | {
+    type: 'composeDelete';
+} | {
+    type: 'composeHome';
+} | {
+    type: 'composeEnd';
+} | {
+    type: 'composeMove';
+    direction: 'wordLeft' | 'wordRight';
+} | {
+    type: 'arrow';
+    direction: 'left' | 'right' | 'up' | 'down';
+} | {
+    type: 'printable';
+    text: string;
+} | {
+    type: 'paste';
+    text: string;
+};
+/** Return text that compose mode inserts. Semantic textual commands deliberately
+ * retain their payload so compose can preserve the old branch order. */
+export declare function reviewKeyText(key: ReviewKey): string | undefined;
+/** Match one complete pi-tui input chunk. pi-tui owns ESC/meta disambiguation;
+ * this function has neither terminal state nor a fallback raw-sequence parser. */
+export declare function matchReviewKey(data: string): ReviewKey | null;

package/dist/clients/inbox/review/keys.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var f=(n,e)=>a(n,"name",{value:e,configurable:!0});import{Key as r,decodeKittyPrintable as o,matchesKey as t,parseKey as u}from"@earendil-works/pi-tui";import{normalizeShiftedMeta as s}from"../../../core/keybindings/index.js";function m(n){switch(n.type){case"moveUnit":case"extendUnit":case"space":case"help":case"listEdit":case"printable":case"paste":return n.text;case"scrollPage":case"pan":case"cancel":return n.text;default:return}}f(m,"reviewKeyText");function g(n){const e=s(n);if(t(e,r.ctrl("j"))||t(e,r.alt("enter")))return{type:"composeNewline"};if(t(e,r.alt("backspace"))||t(e,r.ctrl("w")))return{type:"composeWordBackspace"};if(t(e,r.backspace))return{type:"composeBackspace"};if(t(e,r.delete))return{type:"composeDelete"};if(t(e,r.alt("left"))||t(e,r.ctrl("left"))||t(e,r.super("left"))||t(e,r.alt("b")))return{type:"composeMove",direction:"wordLeft"};if(t(e,r.alt("right"))||t(e,r.ctrl("right"))||t(e,r.super("right"))||t(e,r.alt("f")))return{type:"composeMove",direction:"wordRight"};if(t(e,r.home)||t(e,r.ctrl("a")))return{type:"composeHome"};if(t(e,r.end)||t(e,r.ctrl("e")))return{type:"composeEnd"};if(t(e,r.shift("tab")))return{type:"tab",reverse:!0};if(t(e,r.tab))return{type:"tab",reverse:!1};if(t(e,r.ctrl("enter"))||t(e,r.ctrl("f")))return{type:"confirmFork"};if(t(e,r.enter))return{type:"confirm"};if(t(e,r.escape))return{type:"cancel"};if(t(e,r.up))return{type:"arrow",direction:"up"};if(t(e,r.down))return{type:"arrow",direction:"down"};if(t(e,r.left))return{type:"arrow",direction:"left"};if(t(e,r.right))return{type:"arrow",direction:"right"};if(t(e,r.pageUp))return{type:"scrollPage",delta:-1};if(t(e,r.pageDown))return{type:"scrollPage",delta:1};if(t(e,r.shift("j")))return{type:"extendUnit",delta:1,text:"J"};if(t(e,r.shift("k")))return{type:"extendUnit",delta:-1,text:"K"};if(t(e,r.shift("c")))return{type:"printable",text:"C"};if(t(e,r.shift("u")))return{type:"printable",text:"U"};if(t(e,"j"))return{type:"moveUnit",delta:1,text:"j"};if(t(e,"k"))return{type:"moveUnit",delta:-1,text:"k"};if(t(e,"u"))return{type:"scrollPage",delta:-1,text:"u"};if(t(e,"d"))return{type:"scrollPage",delta:1,text:"d"};if(t(e,"h"))return{type:"pan",delta:-1,text:"h"};if(t(e,"l"))return{type:"pan",delta:1,text:"l"};if(t(e,r.space))return{type:"space",text:" "};if(t(e,r.question))return{type:"help",text:"?"};if(t(e,"e"))return{type:"listEdit",text:"e"};if(t(e,"q"))return{type:"cancel",text:"q"};const p=u(e),i=d(n,p);return i==="?"?{type:"help",text:i}:i!==void 0?{type:"printable",text:i}:p!==void 0?null:[...n].length>1?{type:"paste",text:n}:null}f(g,"matchReviewKey");function d(n,e){const p=o(n);if(p!==void 0&&l(p))return p;if(e!==void 0){const i=e.startsWith("shift+"),c=i?e.slice(6):e;if([...c].length===1&&l(c))return i&&/^[a-z]$/.test(c)?c.toUpperCase():c}return[...n].length===1&&l(n)?n:void 0}f(d,"printableText");function l(n){return!new RegExp("\\p{C}","u").test(n)}f(l,"isPrintable");export{g as matchReviewKey,m as reviewKeyText};

package/dist/clients/inbox/review/launch.d.ts

@@ -0,0 +1,16 @@
+import type { SurfaceHost } from '../../surfaces/host.js';
+import { type ResolvedReview } from './review-client.js';
+export interface ReviewSurfaceOptions {
+    review: ResolvedReview;
+}
+/** Open a dedicated viewer window for a review without replacing the caller's
+ *  conversation window. The fresh viewer consumes the review id at startup. */
+export declare function openReviewWindow(host: SurfaceHost, review: ResolvedReview): boolean;
+/** The status-line toast shown once a review window opens. */
+export declare function reviewOpenedMessage(toIndex: number, windowName: string, fromIndex: number | null): string;
+/** Consume the review id handed to a dedicated attach viewer. */
+export declare function takeStartupReviewId(): string | undefined;
+/** Resolve and mount the review seeded into a dedicated viewer window. */
+export declare function openReviewSurfaceById(host: SurfaceHost, reviewId: string): Promise<void>;
+/** Mount the review document inside its dedicated viewer window. */
+export declare function openReviewSurface(host: SurfaceHost, opts: ReviewSurfaceOptions): Promise<void>;

package/dist/clients/inbox/review/launch.js

@@ -0,0 +1 @@
+var y=Object.defineProperty;var i=(e,o)=>y(e,"name",{value:o,configurable:!0});import{basename as g}from"node:path";import{displayMessage as C,getPaneOption as I,openNodeWindow as E,paneLocation as T,selectWindow as x,shellQuote as P,viewerSplitEnv as S,windowIndex as h}from"../../../core/runtime/placement-tmux.js";import{ReviewDocumentSurface as A}from"./document-surface.js";import{openLiveSource as _}from"./live-source.js";import{createReviewClient as R,ReviewTerminalError as N,terminalRefusalNotice as W}from"./review-client.js";const m="CRTR_ATTACH_REVIEW_ID";function B(e,o){if(e.capabilities.remote)return e.notice("The review is unavailable in a remote attach \u2014 the file and companion live on the host."),!1;const n=e.capabilities.selfPane;if(n===void 0||n==="")return e.notice("Opening a review needs a local viewer in tmux."),!1;const r=T(n),c=I(n,"@crtr_node");if(r===null||c===void 0||c==="")return e.notice("Could not resolve the current viewer for this review."),!1;const a=`review:${g(o.file)}`,l=E({session:r.session,name:a,cwd:o.cwd,env:{...S(),[m]:o.reviewId},command:`crtr surface attach to ${P(c)}`});if(l===null)return e.notice("tmux could not open the review window."),!1;const u=h(r.window),s=h(l.window);return x(r.session,l.window),s!==null&&C(k(s,a,u),n,5e3),!0}i(B,"openReviewWindow");function k(e,o,n){const r=n===null?"":n<=9?` \u2014 prefix ${n} returns to window ${n}`:` \u2014 you were in window ${n}`;return`Review opened in new window ${e} (${o})${r}`}i(k,"reviewOpenedMessage");function Q(){const e=process.env[m];return delete process.env[m],e===void 0||e===""?void 0:e}i(Q,"takeStartupReviewId");async function j(e,o){try{const n=await R().byId(o);await H(e,{review:n})}catch(n){e.notice(n instanceof N?W(n):`couldn't open review: ${f(n)}`)}}i(j,"openReviewSurfaceById");async function H(e,o){const n=o.review;let r;try{r=_(n.file)}catch(t){e.notice(`couldn't open ${n.file}: ${f(t)}`);return}let c=!1;const a=R({onTerminalConflict:i(t=>{c=!0,w(t)},"onTerminalConflict")}),l=a.comments(n.reviewId);let u,s=!1,p=!1;const d=new A({review:n,source:r,comments:l,callerPane:e.capabilities.selfPane,services:{notice:i((t,v)=>e.notice(t,v),"notice"),suspendForChild:i(()=>e.suspendForChild(),"suspendForChild"),requestClose:i(()=>u?.close(),"requestClose"),submit:i(()=>{b()},"submit"),cancel:i(()=>{$()},"cancel")}});await d.open(),u=e.mount(d),d.setHandle(u),setImmediate(()=>{d.openCompanion()});async function b(){if(!s){s=!0;try{const t=await a.submit(n.reviewId);if(t.outcome==="approved"){w(O(t));return}w("Review submitted before the companion finished \u2014 the agent resumes when the review completes.",{sticky:!0})}catch(t){if(c)return;s=!1,e.notice(`couldn't submit review: ${f(t)}`)}}}i(b,"submit");function w(t,v){d.teardown(t,v)}i(w,"finish");async function $(){if(!p){p=!0;try{await a.cancel(n.reviewId,"canceled from the review surface"),w("Review canceled.")}catch(t){if(c)return;p=!1,e.notice(`couldn't cancel review: ${f(t)}`)}}}i($,"cancel")}i(H,"openReviewSurface");function O(e){return e.changed?`Approved \u2014 the document changed during review. Result: ${e.resultPath}`:`Approved \u2014 the document was not modified. Result: ${e.resultPath}`}i(O,"approvalNotice");function f(e){return e instanceof Error?e.message:String(e)}i(f,"describeError");export{H as openReviewSurface,j as openReviewSurfaceById,B as openReviewWindow,k as reviewOpenedMessage,Q as takeStartupReviewId};

package/dist/clients/inbox/review/live-source.d.ts

@@ -0,0 +1,24 @@
+/** The trailing delay used to collapse an editor's write/rename burst. */
+export declare const COALESCE_MS = 120;
+export type StaleReason = 'missing' | 'unreadable' | 'too-large' | 'binary';
+export interface SourceSnapshot {
+    text: string;
+    lines: string[];
+    revision: number;
+    status: 'live' | 'stale';
+    staleReason?: StaleReason;
+    sha256: string;
+    loadedAt: string;
+}
+export interface LiveSource {
+    current(): SourceSnapshot;
+    /** The text captured when the surface opened. */
+    openText(): string;
+    /** Fires only when text changes or the live/stale status flips. */
+    onChange(fn: (next: SourceSnapshot, previous: SourceSnapshot) => void): void;
+    /** Read immediately, bypassing the directory watcher and coalescing timer. */
+    refreshNow(): void;
+    close(): void;
+}
+/** Watch the containing directory so atomic replacement of the file remains live. */
+export declare function openLiveSource(absFile: string): LiveSource;

package/dist/clients/inbox/review/live-source.js

@@ -0,0 +1 @@
+var w=Object.defineProperty;var r=(t,e)=>w(t,"name",{value:e,configurable:!0});import{createHash as T}from"node:crypto";import{readFileSync as y,statSync as A,watch as C}from"node:fs";import{basename as E,dirname as k}from"node:path";import{documentLines as x}from"../../../core/document-lines.js";import{checkReviewableFile as R}from"../../../core/human/visible-paths.js";const L=120;function N(t){return T("sha256").update(t,"utf8").digest("hex")}r(N,"hashText");function O(t){return t.includes("UTF-8")?"binary":t.includes("too large")||t.includes("too long")?"too-large":"unreadable"}r(O,"staleReasonFromCheck");function p(t){try{if(!A(t).isFile())return{status:"stale",reason:"missing"}}catch(a){return{status:"stale",reason:a.code==="ENOENT"?"missing":"unreadable"}}const e=R(t);if(!e.ok)return e.reason==="not a file"?{status:"stale",reason:"unreadable"}:{status:"stale",reason:O(e.reason)};try{const a=y(t,"utf8");return{status:"live",text:a,sha256:N(a),loadedAt:new Date().toISOString()}}catch{return{status:"stale",reason:"unreadable"}}}r(p,"readSource");function b(t){const e=p(t);if(e.status==="stale")throw new Error(`Unable to open live source ${t}: ${e.reason}`);return{text:e.text,lines:x(e.text),revision:0,status:"live",sha256:e.sha256,loadedAt:e.loadedAt}}r(b,"initialSnapshot");function M(t){let e=b(t);const a=e.text,c=new Set,g=E(t);let l,i,o=!1;const f=r(()=>{if(o)return;const s=p(t),n=e;if(s.status==="stale"){const u={...n,status:"stale",staleReason:s.reason};if(e=u,n.status===u.status)return;for(const S of c)o||S(u,n);return}const d=s.text!==n.text,h=n.status!=="live",m={text:s.text,lines:d?x(s.text):n.lines,revision:n.revision+(d?1:0),status:"live",sha256:s.sha256,loadedAt:d||h?s.loadedAt:n.loadedAt};if(e=m,!(!d&&!h))for(const u of c)o||u(m,n)},"refreshNow"),v=r(()=>{o||(i!==void 0&&clearTimeout(i),i=setTimeout(()=>{i=void 0,o||f()},L))},"scheduleRefresh");try{l=C(k(t),(s,n)=>{!o&&n!==null&&String(n)===g&&v()}),l.on("error",()=>{})}catch{}return{current:r(()=>e,"current"),openText:r(()=>a,"openText"),onChange:r(s=>{o||c.add(s)},"onChange"),refreshNow:f,close:r(()=>{if(!o){o=!0,i!==void 0&&(clearTimeout(i),i=void 0),c.clear();try{l?.close()}catch{}l=void 0}},"close")}}r(M,"openLiveSource");export{L as COALESCE_MS,M as openLiveSource};

package/dist/clients/inbox/review/nvim.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Open the reviewed file in the user's configured editor, optionally at a specific line.
+ * Resolves $VISUAL, then $EDITOR, then the first installed of nano/pico/micro/nvim/vim/vi.
+ * The configured value may be a shell fragment such as "code --wait" — it runs whole
+ * through /bin/sh, exactly like the comment-compose round-trip editor.
+ * For vi-family editors (nvim, vim, vi, view), passes the line with the +line syntax.
+ * For other editors, opens the file without line positioning.
+ *
+ * @param absFile - Absolute path to the file to edit
+ * @param line - 1-based line number (only used for vi-family editors)
+ * @returns An object with an optional `error` property if the editor launch or execution failed
+ */
+export declare function openReviewedFileInEditor(absFile: string, line: number): {
+    error?: string;
+};

package/dist/clients/inbox/review/nvim.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var o=(t,n)=>a(t,"name",{value:n,configurable:!0});import{spawnSync as l}from"node:child_process";import{announceFallbackEditor as c,editorBasename as u,isViFamilyEditor as $,NO_EDITOR_MESSAGE as d,resolveEditor as E}from"../../../core/editor-resolver.js";function I(t,n){const s=E();if(s===null)return{error:d};const e=s.command,i=$(e)||u(e)==="nano"?` "+${n}"`:"";try{c(s);const r=l("/bin/sh",["-c",`${e}${i} "$1"`,"sh",t],{stdio:"inherit"});return r.error?{error:`$EDITOR ("${e}") failed to launch: ${r.error.message}`}:r.signal!==null?{error:`$EDITOR ("${e}") was killed by signal ${r.signal}`}:r.status===127||r.status===126?{error:`$EDITOR ("${e}") failed to launch (shell exit ${r.status}) \u2014 check $VISUAL/$EDITOR`}:r.status!==0?{error:`$EDITOR ("${e}") exited with code ${r.status}`}:{}}catch(r){return{error:r instanceof Error?r.message:String(r)}}}o(I,"openReviewedFileInEditor");export{I as openReviewedFileInEditor};

package/dist/clients/inbox/review/remap.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Line-based range remapping with whole-line LCS.
+ *
+ * Normalizes lines, trims common prefix/suffix, applies monotone LCS to the
+ * middle section, and builds a stable mapping from old→new line numbers.
+ * Remapped ranges become detached when no line survives, shifted when partly
+ * deleted, or kept when both endpoints are unmoved.
+ */
+/**
+ * A monotone partial mapping from old line numbers to new ones (both 0-based).
+ * Returns undefined when a line was deleted.
+ */
+export interface LineMap {
+    get(oldLine: number): number | undefined;
+}
+/**
+ * The result of remapping a range: kept (unmoved), shifted (partially survived),
+ * or detached (no lines survived).
+ */
+export type RemapResult = {
+    kind: 'kept';
+    line: number;
+    endLine: number;
+} | {
+    kind: 'shifted';
+    line: number;
+    endLine: number;
+} | {
+    kind: 'detached';
+};
+/**
+ * Build a monotone line-number mapping from old→new using LCS.
+ *
+ * - Normalizes all lines using D14: `line.replace(/\s+/g, ' ').trim()`
+ * - Trims common prefix and suffix before LCS
+ * - Applies whole-line LCS to the middle section
+ * - Returns a map where `get(oldLine)` is the new line number or undefined
+ */
+export declare function buildLineMap(oldLines: readonly string[], newLines: readonly string[]): LineMap;
+/**
+ * Remap a range [line, endLine) using the built LineMap.
+ *
+ * Returns:
+ * - `kept`: both endpoints are unmoved
+ * - `shifted`: the range is partially deleted; maps to the min/max of survivors
+ * - `detached`: no lines from the range survived
+ */
+export declare function remapRange(map: LineMap, range: {
+    line: number;
+    endLine: number;
+}): RemapResult;

package/dist/clients/inbox/review/remap.js

@@ -0,0 +1 @@
+var x=Object.defineProperty;var u=(r,f)=>x(r,"name",{value:f,configurable:!0});function m(r){return r.replace(/\s+/g," ").trim()}u(m,"normalizeLine");function k(r,f){const i=r.map(m),l=f.map(m);let e=0;const s=Math.min(i.length,l.length);for(;e<s&&i[e]===l[e];)e++;let n=0;const c=Math.min(i.length-e,l.length-e);for(;n<c&&i[i.length-1-n]===l[l.length-1-n];)n++;const o=i.length-n,t=l.length-n,g=i.slice(e,o),p=l.slice(e,t),M=L(g,p),a=new Map;for(let d=0;d<e;d++)a.set(d,d);M.forEach((d,h)=>{a.set(e+h,e+d)});for(let d=0;d<n;d++){const h=o+d,w=t+d;a.set(h,w)}return{get(d){return a.get(d)}}}u(k,"buildLineMap");function L(r,f){const i=r.length,l=f.length;if(i===0||l===0)return new Map;const e=Array(i+1).fill(null).map(()=>Array(l+1).fill(0));for(let o=1;o<=i;o++)for(let t=1;t<=l;t++)r[o-1]===f[t-1]?e[o][t]=e[o-1][t-1]+1:e[o][t]=Math.max(e[o-1][t],e[o][t-1]);const s=new Map;let n=i,c=l;for(;n>0&&c>0;)r[n-1]===f[c-1]?(s.set(n-1,c-1),n--,c--):e[n-1][c]>e[n][c-1]?n--:c--;return s}u(L,"computeLCS");function v(r,f){const i=f.line,l=f.endLine;let e,s;for(let o=i;o<l;o++){const t=r.get(o);t!==void 0&&((e===void 0||t<e)&&(e=t),(s===void 0||t>s)&&(s=t))}if(e===void 0)return{kind:"detached"};const n=r.get(i),c=r.get(l-1);return n===i&&c===l-1?{kind:"kept",line:n,endLine:c+1}:{kind:"shifted",line:e,endLine:s+1}}u(v,"remapRange");export{k as buildLineMap,v as remapRange};

package/dist/clients/inbox/review/review-client.d.ts

@@ -0,0 +1,43 @@
+import { type CommentAuthority } from './comments-client.js';
+export declare class ReviewTerminalError extends Error {
+    readonly state: 'approved' | 'canceled';
+    readonly resultPath?: string;
+    readonly reason?: string;
+    constructor(state: 'approved', resultPath: string);
+    constructor(state: 'canceled', reason?: string);
+}
+export interface ResolvedReview {
+    reviewId: string;
+    companionNodeId: string;
+    file: string;
+    cwd: string;
+}
+export interface ReviewClient {
+    byId(reviewId: string): Promise<ResolvedReview>;
+    /** Exactly one of a file path or a document ref. */
+    createInline(p: {
+        originNodeId: string;
+    } & ({
+        file: string;
+    } | {
+        document: string;
+    })): Promise<ResolvedReview>;
+    comments(reviewId: string): CommentAuthority;
+    submit(reviewId: string): Promise<SubmitDisposition>;
+    cancel(reviewId: string, reason: string): Promise<void>;
+}
+/** An approval that landed, or one the daemon is holding for the companion. */
+export type SubmitDisposition = {
+    outcome: 'approved';
+    changed: boolean;
+    resultPath: string;
+} | {
+    outcome: 'awaiting_companion';
+};
+export interface ReviewClientOptions {
+    onTerminalConflict?: (notice: string) => void;
+}
+/** The terminal's complete daemon seam for review lifecycle and comment operations. */
+export declare function createReviewClient(opts?: ReviewClientOptions): ReviewClient;
+export declare function terminalRefusalNotice(error: ReviewTerminalError): string;
+export declare function terminalConflictNotice(error: unknown): string | undefined;

package/dist/clients/inbox/review/review-client.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var r=(e,t)=>u(e,"name",{value:t,configurable:!0});import{randomUUID as l}from"node:crypto";import{ApiError as w}from"../../../api/errors.js";import{cliClient as a}from"../../../commands/api-client.js";import{createCommentAuthority as p}from"./comments-client.js";class s extends Error{static{r(this,"ReviewTerminalError")}state;resultPath;reason;constructor(t,n){if(t==="approved"){if(n===void 0||n==="")throw new Error("approved review omitted its canonical result path");super(`review is already approved; see ${n}`),this.resultPath=n}else super(n===void 0||n===""?"review is already canceled":`review is already canceled: ${n}`),n!==void 0&&n!==""&&(this.reason=n);this.name="ReviewTerminalError",this.state=t}}function b(e={}){const t=r(async n=>{try{return await n()}catch(i){const o=h(i);throw o!==void 0&&e.onTerminalConflict?.(o),i}},"request");return{async byId(n){const i=await t(()=>a().getReview(n));return await c(i,i.companion_node_id,t)},async createInline(n){const i=await t(()=>a().createReview({origin_kind:"inline",origin_node_id:n.originNodeId,..."file"in n?{file:n.file}:{document:n.document},idempotency_key:l()}));return await c(i,i.companion_node_id,t)},comments(n){return p(n,t)},async submit(n){const i=await t(()=>a().submitReview(n));return i.outcome==="awaiting_companion"?{outcome:"awaiting_companion"}:{outcome:"approved",changed:m(i.review),resultPath:d(i.review)}},async cancel(n,i){await t(()=>a().cancelReview(n,{reason:i,actor:"human",disposition:"dismissed"}))}}}r(b,"createReviewClient");async function c(e,t,n){if(e.state!=="open")throw f(e);const i=await n(()=>a().getNode(t));return{reviewId:e.review_id,companionNodeId:t,file:e.file,cwd:i.cwd}}r(c,"resolveReview");function f(e){if(e.state!=="approved"&&e.state!=="canceled")throw new Error(`terminal review ${e.review_id} has invalid state ${e.state}`);return e.state==="approved"?new s("approved",d(e)):new s("canceled",e.cancel_reason)}r(f,"terminalError");function m(e){if(typeof e.changed!="boolean")throw new Error(`approved review ${e.review_id} omitted its changed disposition`);return e.changed}r(m,"requireChanged");function d(e){if(typeof e.result_path!="string"||e.result_path==="")throw new Error(`terminal review ${e.review_id} omitted its canonical result path`);return e.result_path}r(d,"requireResultPath");function T(e){return e.state==="approved"?`This review was already approved. Result: ${e.resultPath??"unknown"}`:e.reason===void 0||e.reason===""?"This review was canceled.":`This review was canceled: ${e.reason}`}r(T,"terminalRefusalNotice");function h(e){if(!(e instanceof w)||e.status!==409||e.code!=="review_terminal_conflict")return;const t=e.details?.review;if(t!==void 0){if(t.state==="approved")return t.result_path===void 0?"This review was already approved by someone else.":`This review was already approved by someone else. Result: ${t.result_path}`;if(t.state==="canceled")return t.cancel_reason===void 0||t.cancel_reason===""?"This review was canceled before this submission landed.":`This review was canceled before this submission landed: ${t.cancel_reason}`}}r(h,"terminalConflictNotice");export{s as ReviewTerminalError,b as createReviewClient,h as terminalConflictNotice,T as terminalRefusalNotice};