Function applyShellRunViewUpdateToTranscript

packages/cli/src/pi-transcript.ts:262–299

(
  state: MakaPiTranscriptState,
  update: ShellRunUpdate,
  options?: {
    /**
     * Whether a running → settled flip appends a transcript-tail notice.
     * Default true for live updates. Hydration catch-up (`listShellRunUpdates`)
     * passes false: replaying durable state is not a live event, and the notice
     * is never persisted, so announcing catch-up would re-announce on every
     * session attach.
     */
    announceSettle?: boolean;
  },
)

}

export function applyShellRunViewUpdateToTranscript(
  state: MakaPiTranscriptState,
  update: ShellRunUpdate,
  options?: {
    /**
     * Whether a running → settled flip appends a transcript-tail notice.
     * Default true for live updates. Hydration catch-up (`listShellRunUpdates`)
     * passes false: replaying durable state is not a live event, and the notice
     * is never persisted, so announcing catch-up would re-announce on every
     * session attach.
     */
    announceSettle?: boolean;
  },
): boolean {
  const tool = findToolEntry(state, update.sourceToolCallId);
  const wasLive = isLiveShellRunCard(tool);
  const applied = applyShellRunUpdateToTranscript(state, update.sourceToolCallId, update.result);
  if (tool && wasLive && isSettledShellRunCard(tool) && options?.announceSettle !== false) {
    pushShellRunSettledNotice(state, tool);
  }
  if (
    !tool ||
    tool.toolName !== 'Bash' ||
    tool.result?.kind !== 'shell_run' ||
    tool.result.ref !== update.result.ref ||
    !isActiveShellRunStatus(tool.result.status)
  )
    return applied;
  const status =
    update.ownership.kind === 'local'
      ? 'running'
      : update.ownership.kind === 'source_owned'
        ? 'detached'
        : 'unavailable';
  if (tool.status === status) return applied;
  tool.status = status;
  return true;
}

export function applyShellRunUpdateToTranscript(
  state: MakaPiTranscriptState,