aegon-lv82 1.0.0

package/src/views/gen-ai/build-report/useReportWorkflow.ts

@@ -0,0 +1,1408 @@
+import { computed, nextTick, reactive, ref, watch } from 'vue'
+import {
+  clearChartStreamRefs,
+  upsertChartStreamRef,
+  upsertChartStreamRefsFromSources,
+} from './chartStreamRefs'
+import {
+  buildReportHistoryChapterBodies,
+  findFinalizedReportById,
+  serializeSelectedChapterLabels,
+  stripChapterNumberPrefix,
+} from './report-domain'
+import type { ReportTemplateCard } from './report-template-data'
+
+/**
+ * 只負責流程控制與路由跳轉。
+ * 接口類 API 調用寫在當前調用組件內，禁止寫在本文件。
+ */
+
+export const FILE_SIZE_LIMIT_KB = 100 * 1024
+export const SOURCE_VISIBLE_LIMIT = 20
+
+/** 章節歷史刷新：由 ReportChapterWorkspace 註冊 loadGenAiSectionVersionList */
+type ChapterHistoryReloader = () => Promise<boolean>
+let chapterHistoryReloader: ChapterHistoryReloader | null = null
+
+export function registerChapterHistoryReloader(fn: ChapterHistoryReloader | null) {
+  chapterHistoryReloader = fn
+}
+
+export async function reloadActiveChapterHistory() {
+  if (!chapterHistoryReloader) return false
+  return chapterHistoryReloader()
+}
+
+export type SourceFilterTab = 'all' | 'selected' | 'unselected'
+
+export interface PendingFile {
+  id: string
+  name: string
+  sizeKb: number
+}
+
+export interface SourceFile {
+  id: string
+  name: string
+  selected: boolean
+  /** 可選直鏈；預覽/下載優先使用 */
+  url?: string
+}
+
+export const MOCK_SOURCE_FILES: SourceFile[] = []
+
+export const MOCK_PENDING_FILES: PendingFile[] = []
+
+export type ReportEditorRole = 'initiator' | 'editor'
+
+export interface ReportEditor {
+  id: string
+  name: string
+  employeeId: string
+  department: string
+  role: ReportEditorRole
+}
+
+export interface UmsEditorCandidate {
+  id: string
+  name: string
+  employeeId: string
+  department: string
+}
+
+export const CURRENT_USER_ID = '8000121'
+
+/** 編輯者列表改由接口 / 用戶添加寫入；不再預填本地假人員 */
+export const MOCK_REPORT_EDITORS: ReportEditor[] = []
+
+export const MOCK_UMS_EDITOR_USERS: UmsEditorCandidate[] = []
+
+export type ReportModelStep = 'select' | 'detail' | 'generating' | 'prompt'
+export type PromptRightPanel = 'prompt' | 'settings'
+/** Prompt AI+ / 新增章節 AI+ → 打開智能化生成 Prompt 彈窗 */
+export type AiPromptDialogSource = 'prompt-panel' | 'add-chapter'
+
+export interface ReportHistoryItem {
+  key: string
+  title: string
+  author: string
+  finalizedAt: string
+  recordId?: string
+  /** 存為草稿後插入章節歷史首行的草稿卡片 */
+  kind?: 'draft' | 'history'
+}
+
+export const CHAPTER_DRAFT_HISTORY_KEY = 'chapter-history-draft'
+export const CHAPTER_DRAFT_HISTORY_TITLE = '您有未生成章節內容的草稿...'
+
+export interface PromptChapterForm {
+  prompt: string
+  enableBodyContent: boolean
+  bodyWordLimit: number
+  enableTable: boolean
+  tableTitle: string
+  tableRowLabels: string
+  tableColumnLabels: string
+  tableContent: string
+  enableSourceChart: boolean
+  chartDescription: string
+}
+
+export function createDefaultPromptChapterForm(): PromptChapterForm {
+  return {
+    prompt: '',
+    enableBodyContent: false,
+    bodyWordLimit: 500,
+    enableTable: true,
+    tableTitle: '',
+    tableRowLabels: '',
+    tableColumnLabels: '',
+    tableContent: '',
+    enableSourceChart: true,
+    chartDescription: '',
+  }
+}
+
+export interface ReportDraft {
+  industry: string
+  researchFocus: string
+  year: string
+  reportName: string
+  language: string
+  chapterContentLanguage: 'zh-Hant' | 'zh-Hans'
+  wordsPerChapter: string
+  model: string
+  searchMode: string
+  weight: number
+  rerank: boolean
+  rerankTopN: number
+  rerankThreshold: number
+  sourceCount: number
+}
+
+const STORAGE_KEY = 'gen-ai-report-workflow-draft'
+const TEMPLATE_STORAGE_KEY = 'gen-ai-report-workflow-template'
+const SOURCES_STORAGE_KEY = 'gen-ai-report-workflow-sources'
+const EDITORS_STORAGE_KEY = 'gen-ai-report-workflow-editors'
+const BODIES_STORAGE_KEY = 'gen-ai-report-workflow-generated-bodies'
+const TITLES_STORAGE_KEY = 'gen-ai-report-workflow-generated-titles'
+const SETTINGS_STORAGE_KEY = 'gen-ai-report-workflow-settings'
+const PROMPT_FORM_STORAGE_KEY = 'gen-ai-report-workflow-prompt-form'
+/** 一次性清掉舊版表格／圖表預填默認值 */
+const PROMPT_TABLE_DEFAULTS_CLEARED_KEY = 'gen-ai-report-prompt-table-defaults-cleared-v1'
+const GENERATING_STORAGE_KEY = 'gen-ai-report-generating-session'
+
+const draft = reactive<ReportDraft>({
+  industry: '',
+  researchFocus: '',
+  year: String(new Date().getFullYear()),
+  reportName: '',
+  language: 'zh-Hant',
+  chapterContentLanguage: 'zh-Hant',
+  wordsPerChapter: '',
+  model: 'gpt-666',
+  searchMode: 'Hybrid Search',
+  weight: 0.5,
+  rerank: true,
+  rerankTopN: 5,
+  rerankThreshold: 0.5,
+  sourceCount: 0,
+})
+
+const selectedTemplate = ref<ReportTemplateCard | null>(null)
+const modelStep = ref<ReportModelStep>('select')
+const editViewOpen = ref(false)
+/** 強制重掛整個 ReportEdit 組件（一鍵生成 / 進入編輯） */
+const reportEditMountKey = ref(0)
+/** 主動跳轉鎖：避免路由 watch / sync 在中途把 modelStep 打回舊值 */
+const reportEditNavLocked = ref(false)
+const reportEditNavTarget = ref<ReportModelStep | null>(null)
+/** 鎖定期目標右側欄；解鎖時強制寫回，避免 remount 後丟 settings */
+const reportEditNavRightPanel = ref<PromptRightPanel | null>(null)
+const promptRightPanel = ref<PromptRightPanel>('prompt')
+
+/**
+ * 右側欄 / 中欄工具列 / 中欄正文 — 各自獨立開關，由 showPrompt*Panel 原子寫入，
+ * 避免只改 promptRightPanel 時 Suspense / 路由競態導致「生成報告設置」與按鈕錯位。
+ */
+const uiShowPromptPanel = ref(true)
+const uiShowGenerateSettingsPanel = ref(false)
+const uiShowChapterEditToolbar = ref(true)
+const uiShowFinalizeToolbar = ref(false)
+const uiShowSettingsDoc = ref(false)
+const uiShowEditorSummary = ref(true)
+
+/**
+ * reportEdit 流程視圖（模組級，重掛不丟）：與路由 step / rightPanel 對齊
+ */
+const flowStep = ref<ReportModelStep>('select')
+const flowRightPanel = ref<'prompt' | 'settings'>('prompt')
+
+function applyPromptEditorUiFlags() {
+  promptRightPanel.value = 'prompt'
+  flowRightPanel.value = 'prompt'
+  uiShowPromptPanel.value = true
+  uiShowGenerateSettingsPanel.value = false
+  uiShowChapterEditToolbar.value = true
+  uiShowFinalizeToolbar.value = false
+  uiShowSettingsDoc.value = false
+  uiShowEditorSummary.value = true
+}
+
+function applyGenerateSettingsUiFlags() {
+  promptRightPanel.value = 'settings'
+  flowRightPanel.value = 'settings'
+  uiShowPromptPanel.value = false
+  uiShowGenerateSettingsPanel.value = true
+  uiShowChapterEditToolbar.value = false
+  uiShowFinalizeToolbar.value = true
+  uiShowSettingsDoc.value = true
+  uiShowEditorSummary.value = false
+}
+
+const generationDone = ref(false)
+const generatedChapterBodies = ref<string[]>([])
+/** 生成接口返回的章節標題（進入編輯後以接口為準） */
+const generatedChapterTitles = ref<string[]>([])
+
+/** 生成報告設置：章節勾選 / 排序（與中間主欄多章預覽同步） */
+export type SettingsChapterPreset = { key: string; label: string }
+export type SettingsChapterVersionOption = {
+  text: string
+  value: string
+  selected: boolean
+  uploadUsrNameDisplay?: string
+}
+
+/** AdjustInstance / 資訊源 selected 兼容 boolean、Y/N、1/0 */
+function isGenAiSelectedFlag(flag: unknown): boolean {
+  if (flag === true || flag === 1) return true
+  if (flag === false || flag === 0 || flag == null) return false
+  const raw = String(flag).trim().toUpperCase()
+  return raw === 'Y' || raw === 'TRUE' || raw === '1'
+}
+
+const settingsChapterPresets = ref<SettingsChapterPreset[]>([])
+const settingsSelectedChapters = ref<Record<string, boolean>>({})
+const settingsChapterOrder = ref<string[]>([])
+/** 右側章節版本下拉選項（AdjustInstance.instanceSections.versions） */
+const settingsChapterVersionOptions = ref<Record<string, SettingsChapterVersionOption[]>>({})
+/** 右側章節當前選中版本 value（UUID） */
+const settingsChapterVersions = ref<Record<string, string>>({})
+/** 右側章節生成人（AdjustInstance.instanceSections.createUserName） */
+const settingsChapterGenerators = ref<Record<string, string>>({})
+/**
+ * AdjustInstance / SimTradTransfer 返回的報告正文（報告頁中欄）
+ * 與右側「生成報告設置」語言下拉共享
+ */
+const adjustInstanceContents = ref<Array<{ sectionTitle: string; sectionContent: string }>>([])
+
+function setAdjustInstanceContents(
+  contents: Array<{
+    sectionTitle: string
+    sectionContent: string
+    refList?: unknown
+    Ref?: unknown
+    ref?: unknown
+    refs?: unknown
+  }>
+) {
+  const list = Array.isArray(contents) ? contents : []
+  // 靜態預覽（無打字機）也要先備好 refList，才能把 [ref:uuid] 解析成 tip
+  upsertChartStreamRefsFromSources(list)
+  adjustInstanceContents.value = list.map((item) => ({
+    sectionTitle: String(item.sectionTitle ?? ''),
+    sectionContent: String(item.sectionContent ?? ''),
+  }))
+}
+
+function upsertChapterChartStreamRefsFromSources(sources: unknown) {
+  return upsertChartStreamRefsFromSources(sources)
+}
+
+/**
+ * AdjustInstance / AdjustInstanceSetting 返回的已存在報告版本號（如 V1）
+ * 與報告歷史 instanceVersionNo 相等時，對應 card 為選中態（取第一個匹配）
+ */
+const existsInstanceVersionNo = ref<string | null>(null)
+
+function setExistsInstanceVersionNo(versionNo: unknown) {
+  if (versionNo == null || versionNo === '') {
+    existsInstanceVersionNo.value = null
+    return
+  }
+  existsInstanceVersionNo.value = String(versionNo).trim()
+}
+
+/**
+ * 連貫性檢查 CoherenceCheck.beenFinalizedFlag=Y 後：
+ * 工具列顯示「查看報告連貫性檢查結果」+「導出(Word)」
+ */
+const coherenceResultReady = ref(false)
+const coherenceCheckContentText = ref('')
+
+function setCoherenceCheckResultReady(ready: boolean, contentText = '') {
+  coherenceResultReady.value = ready
+  coherenceCheckContentText.value = ready ? String(contentText ?? '') : ''
+}
+
+function clearCoherenceCheckResultReady() {
+  coherenceResultReady.value = false
+  coherenceCheckContentText.value = ''
+}
+
+/**
+ * 避免 AdjustInstance / AdjustInstanceSetting 回寫章節後
+ * 再次觸發「章節變更 → AdjustInstanceSetting → 打字機重播」死循環閃爍
+ */
+const adjustInstanceSettingSyncKey = ref('')
+
+function markAdjustInstanceSettingSynced(versionIdList: string[]) {
+  adjustInstanceSettingSyncKey.value = (versionIdList || [])
+    .map((id) => String(id ?? '').trim())
+    .filter(Boolean)
+    .join(',')
+}
+
+function isAdjustInstanceSettingSynced(versionIdList: string[]) {
+  const key = (versionIdList || [])
+    .map((id) => String(id ?? '').trim())
+    .filter(Boolean)
+    .join(',')
+  return !!key && key === adjustInstanceSettingSyncKey.value
+}
+
+/** 進頁 / 接口回寫章節時抑制 Settings 的 AdjustInstanceSetting watch */
+const suppressAdjustInstanceSettingWatch = ref(false)
+
+function beginSuppressAdjustInstanceSettingWatch() {
+  suppressAdjustInstanceSettingWatch.value = true
+}
+
+function endSuppressAdjustInstanceSettingWatch() {
+  void nextTick(() => {
+    suppressAdjustInstanceSettingWatch.value = false
+  })
+}
+/** 拖拽排序後：通知中欄從該章節起重新打字機列印（key + token 確保可重複觸發） */
+const settingsTypewriterReplayKey = ref<string | null>(null)
+const settingsTypewriterReplayToken = ref(0)
+/** 中欄打字機當前章（供右側列表等鬆耦合滾動，不反向依賴中欄 DOM） */
+const settingsTypingChapterKey = ref<string | null>(null)
+/** 中欄是否正在打字機列印（列印中隱藏滾動條） */
+const settingsTypewriterPrinting = ref(false)
+
+function requestSettingsTypewriterReplay(key: string) {
+  if (!key) return
+  settingsTypewriterReplayKey.value = key
+  settingsTypewriterReplayToken.value += 1
+}
+
+function setSettingsTypingChapterKey(key: string | null) {
+  settingsTypingChapterKey.value = key
+}
+
+function setSettingsTypewriterPrinting(printing: boolean) {
+  settingsTypewriterPrinting.value = printing
+}
+
+/** 需求 2026-08-13 16:58：進入編輯 / settings 不打字；點「生成章節內容」才打字 */
+const chapterTypewriterActive = ref(false)
+/** 生成章節：等待首包；中欄 v-loading，首包到達後關閉 */
+const chapterContentAwaitingFirstChunk = ref(false)
+
+function startChapterContentTypewriter() {
+  chapterHistoryPreviewBody.value = ''
+  chapterTypewriterActive.value = true
+  chapterContentAwaitingFirstChunk.value = true
+  chapterHistoryApplyToken.value += 1
+}
+
+function markChapterContentFirstChunk() {
+  chapterContentAwaitingFirstChunk.value = false
+}
+
+/** 停止章節打字機；cancelStream 用於切章時中止 chartAsStream */
+const chapterContentStreamEpoch = ref(0)
+
+function stopChapterContentTypewriter(options?: { cancelStream?: boolean }) {
+  chapterTypewriterActive.value = false
+  chapterContentAwaitingFirstChunk.value = false
+  if (options?.cancelStream) chapterContentStreamEpoch.value += 1
+}
+
+const CHAPTER_CHART_AUDIT_EVENT_STORAGE_KEY = 'gen-ai-chapter-chart-audit-event-id'
+const chapterChartAuditEventId = ref('')
+
+function setChapterChartAuditEventId(id: string) {
+  const next = String(id ?? '').trim()
+  chapterChartAuditEventId.value = next
+  try {
+    if (next) sessionStorage.setItem(CHAPTER_CHART_AUDIT_EVENT_STORAGE_KEY, next)
+    else sessionStorage.removeItem(CHAPTER_CHART_AUDIT_EVENT_STORAGE_KEY)
+  } catch {
+    /* ignore */
+  }
+}
+
+function clearChapterChartAuditEventId() {
+  chapterChartAuditEventId.value = ''
+  try {
+    sessionStorage.removeItem(CHAPTER_CHART_AUDIT_EVENT_STORAGE_KEY)
+  } catch {
+    /* ignore */
+  }
+}
+
+function upsertChapterChartStreamRef(raw: unknown) {
+  return upsertChartStreamRef(raw)
+}
+
+function clearChapterChartStreamRefs() {
+  clearChartStreamRefs()
+}
+
+/** 保存時取值：內存 → sessionStorage 兜底（始終返回 string） */
+function resolveChapterChartAuditEventId() {
+  const fromMem = String(chapterChartAuditEventId.value ?? '').trim()
+  if (fromMem) return fromMem
+  try {
+    return String(sessionStorage.getItem(CHAPTER_CHART_AUDIT_EVENT_STORAGE_KEY) ?? '').trim()
+  } catch {
+    return ''
+  }
+}
+
+function patchGeneratedChapterBody(index: number, body: string) {
+  if (index < 0) return
+  const next = [...generatedChapterBodies.value]
+  while (next.length <= index) next.push('')
+  next[index] = body
+  generatedChapterBodies.value = next
+  saveGeneratedBodiesToSession()
+}
+
+function clearSettingsTypewriterReplay() {
+  settingsTypewriterReplayKey.value = null
+}
+const sourceFiles = ref<SourceFile[]>([])
+const pendingFiles = ref<PendingFile[]>([])
+const reportEditors = ref<ReportEditor[]>([])
+const reportHistoryItems = ref<ReportHistoryItem[]>([])
+const activeHistoryKey = ref('')
+const historyScrollTargetKey = ref<string | null>(null)
+const historyPreviewRecordId = ref<string | null>(null)
+const historyPreviewLayoutBaseline = ref<string | null>(null)
+const historyPreviewDirty = ref(false)
+const historyPreviewApplyToken = ref(0)
+const historyPreviewChapterBodies = ref<string[]>([])
+const chapterHistoryItems = ref<ReportHistoryItem[]>([])
+const activeChapterHistoryKey = ref('')
+const chapterHistoryPreviewBody = ref<string | null>(null)
+const chapterHistoryApplyToken = ref(0)
+/** 章節歷史折疊面板：無內容默認收起；出現「未生成草稿」時展開 */
+const chapterHistoryOpen = ref(false)
+const promptChapterForm = reactive<PromptChapterForm>(createDefaultPromptChapterForm())
+const chapterEditMode = ref(false)
+let chapterEditSnapshot: string | null = null
+
+const aiPromptDialogRequestToken = ref(0)
+const aiPromptDialogSource = ref<AiPromptDialogSource>('prompt-panel')
+
+function requestOpenAiPromptDialog(source: AiPromptDialogSource = 'prompt-panel') {
+  aiPromptDialogSource.value = source
+  aiPromptDialogRequestToken.value += 1
+}
+
+/** 設置頁「生成報告」chartAsStream 緩衝（接口調用寫在 Settings 組件） */
+const reportGenerateStreamText = ref('')
+const reportGenerateStreamActive = ref(false)
+const reportGenerateStreamEnded = ref(false)
+
+function beginReportGenerateStream() {
+  reportGenerateStreamText.value = ''
+  reportGenerateStreamActive.value = true
+  reportGenerateStreamEnded.value = false
+}
+
+function appendReportGenerateStream(chunk: string) {
+  reportGenerateStreamText.value += chunk
+}
+
+function finishReportGenerateStream() {
+  reportGenerateStreamEnded.value = true
+}
+
+function clearReportGenerateStream() {
+  reportGenerateStreamText.value = ''
+  reportGenerateStreamActive.value = false
+  reportGenerateStreamEnded.value = false
+}
+
+function serializeChapterEditState() {
+  return JSON.stringify({
+    prompt: { ...promptChapterForm },
+    sources: sourceFiles.value.map((file) => ({ id: file.id, selected: file.selected })),
+  })
+}
+
+function restoreChapterEditSnapshot(snapshot: string) {
+  const parsed = JSON.parse(snapshot) as {
+    prompt: PromptChapterForm
+    sources: Array<{ id: string; selected: boolean }>
+  }
+  Object.assign(promptChapterForm, parsed.prompt)
+  for (const file of sourceFiles.value) {
+    const saved = parsed.sources.find((item) => item.id === file.id)
+    if (saved) file.selected = saved.selected
+  }
+}
+
+function isChapterEditDirty() {
+  if (!chapterEditSnapshot) return false
+  return serializeChapterEditState() !== chapterEditSnapshot
+}
+
+function enterChapterEditMode() {
+  stopChapterContentTypewriter()
+  chapterEditSnapshot = serializeChapterEditState()
+  chapterEditMode.value = true
+}
+
+function commitChapterEdit() {
+  chapterEditSnapshot = serializeChapterEditState()
+  chapterEditMode.value = false
+}
+
+function exitChapterEditMode(revert = false) {
+  if (revert && chapterEditSnapshot) {
+    restoreChapterEditSnapshot(chapterEditSnapshot)
+  } else if (chapterEditMode.value) {
+    chapterEditSnapshot = serializeChapterEditState()
+  }
+  chapterEditMode.value = false
+}
+
+function resetChapterEditMode() {
+  chapterEditSnapshot = null
+  chapterEditMode.value = false
+}
+
+function saveDraftToSession() {
+  sessionStorage.setItem(STORAGE_KEY, JSON.stringify({ ...draft }))
+}
+
+/** 章節歷史首行插入 / 刷新「未生成草稿」卡片；出現時強制展開章節歷史 */
+function upsertChapterDraftHistory() {
+  const draftItem: ReportHistoryItem = {
+    key: CHAPTER_DRAFT_HISTORY_KEY,
+    title: CHAPTER_DRAFT_HISTORY_TITLE,
+    author: '',
+    finalizedAt: new Date().toISOString(),
+    kind: 'draft',
+  }
+  const rest = chapterHistoryItems.value.filter((item) => item.kind !== 'draft')
+  chapterHistoryItems.value = [draftItem, ...rest]
+  activeChapterHistoryKey.value = draftItem.key
+  chapterHistoryOpen.value = true
+}
+
+function removeChapterDraftHistory() {
+  const index = chapterHistoryItems.value.findIndex((item) => item.kind === 'draft')
+  if (index === -1) return false
+  chapterHistoryItems.value.splice(index, 1)
+  if (activeChapterHistoryKey.value === CHAPTER_DRAFT_HISTORY_KEY) {
+    const nextKey = chapterHistoryItems.value[0]?.key ?? ''
+    activeChapterHistoryKey.value = nextKey
+  }
+  return true
+}
+
+function loadDraftFromSession() {
+  const raw = sessionStorage.getItem(STORAGE_KEY)
+  if (!raw) return
+  try {
+    const parsed = JSON.parse(raw) as Record<string, unknown>
+    const legacyContentLanguage = parsed.chapterContentLanguage
+    if (legacyContentLanguage === 'zh') {
+      parsed.chapterContentLanguage = parsed.language === 'zh-Hans' ? 'zh-Hans' : 'zh-Hant'
+    } else if (legacyContentLanguage === 'en') {
+      parsed.chapterContentLanguage = 'zh-Hant'
+    }
+    Object.assign(draft, parsed as Partial<ReportDraft>)
+  } catch {
+    // ignore invalid cache
+  }
+}
+
+function saveTemplateToSession() {
+  if (!selectedTemplate.value) {
+    sessionStorage.removeItem(TEMPLATE_STORAGE_KEY)
+    return
+  }
+  sessionStorage.setItem(TEMPLATE_STORAGE_KEY, JSON.stringify(selectedTemplate.value))
+}
+
+function loadTemplateFromSession() {
+  const raw = sessionStorage.getItem(TEMPLATE_STORAGE_KEY)
+  if (!raw) return
+  try {
+    selectedTemplate.value = JSON.parse(raw) as ReportTemplateCard
+  } catch {
+    sessionStorage.removeItem(TEMPLATE_STORAGE_KEY)
+  }
+}
+
+function saveSourcesToSession() {
+  sessionStorage.setItem(
+    SOURCES_STORAGE_KEY,
+    JSON.stringify(
+      sourceFiles.value.map((file) => ({ id: file.id, name: file.name, selected: file.selected }))
+    )
+  )
+}
+
+function loadSourcesFromSession() {
+  const raw = sessionStorage.getItem(SOURCES_STORAGE_KEY)
+  if (!raw) return
+  try {
+    const parsed = JSON.parse(raw) as SourceFile[]
+    if (!Array.isArray(parsed) || !parsed.length) return
+    sourceFiles.value = parsed.map((file) => ({
+      id: file.id,
+      name: file.name,
+      selected: !!file.selected,
+    }))
+  } catch {
+    sessionStorage.removeItem(SOURCES_STORAGE_KEY)
+  }
+}
+
+function saveEditorsToSession() {
+  sessionStorage.setItem(EDITORS_STORAGE_KEY, JSON.stringify(reportEditors.value))
+}
+
+function loadEditorsFromSession() {
+  const raw = sessionStorage.getItem(EDITORS_STORAGE_KEY)
+  if (!raw) return
+  try {
+    const parsed = JSON.parse(raw) as ReportEditor[]
+    if (!Array.isArray(parsed) || !parsed.length) return
+    // 過濾歷史本地假編輯者（陳大文等），避免兩頁殘留 mock
+    const cleaned = parsed
+      .map((editor) => ({
+        id: String(editor.id),
+        name: String(editor.name ?? ''),
+        employeeId: String(editor.employeeId ?? editor.id),
+        department: String(editor.department ?? ''),
+        role: (editor.role === 'initiator' ? 'initiator' : 'editor') as ReportEditorRole,
+      }))
+      .filter((editor) => {
+        const id = editor.employeeId || editor.id
+        if (['8000121', '8000122', '8000123', '8808808'].includes(id)) return false
+        if (
+          editor.name.includes('陳大文') ||
+          editor.name.includes('陳大大') ||
+          editor.name.includes('張小小')
+        )
+          return false
+        return true
+      })
+    reportEditors.value = cleaned
+    if (cleaned.length !== parsed.length) saveEditorsToSession()
+  } catch {
+    sessionStorage.removeItem(EDITORS_STORAGE_KEY)
+  }
+}
+
+function saveGeneratedBodiesToSession() {
+  sessionStorage.setItem(BODIES_STORAGE_KEY, JSON.stringify(generatedChapterBodies.value))
+  sessionStorage.setItem(TITLES_STORAGE_KEY, JSON.stringify(generatedChapterTitles.value))
+}
+
+function loadGeneratedBodiesFromSession() {
+  const raw = sessionStorage.getItem(BODIES_STORAGE_KEY)
+  if (raw) {
+    try {
+      const parsed = JSON.parse(raw) as string[]
+      if (Array.isArray(parsed)) {
+        //0917 過濾 tip Mock 殘留正文
+        generatedChapterBodies.value = parsed.map((body) =>
+          looksLikeTipChartStreamMock(body) ? '' : String(body ?? '')
+        )
+        if (parsed.some((body) => looksLikeTipChartStreamMock(body))) {
+          saveGeneratedBodiesToSession()
+        }
+      }
+    } catch {
+      sessionStorage.removeItem(BODIES_STORAGE_KEY)
+    }
+  }
+  const rawTitles = sessionStorage.getItem(TITLES_STORAGE_KEY)
+  if (!rawTitles) return
+  try {
+    const parsed = JSON.parse(rawTitles) as string[]
+    if (Array.isArray(parsed)) generatedChapterTitles.value = parsed.map(String)
+  } catch {
+    sessionStorage.removeItem(TITLES_STORAGE_KEY)
+  }
+}
+
+function saveSettingsToSession() {
+  sessionStorage.setItem(
+    SETTINGS_STORAGE_KEY,
+    JSON.stringify({
+      presets: settingsChapterPresets.value,
+      selected: settingsSelectedChapters.value,
+      order: settingsChapterOrder.value,
+    })
+  )
+}
+
+function loadSettingsFromSession() {
+  const raw = sessionStorage.getItem(SETTINGS_STORAGE_KEY)
+  if (!raw) return
+  try {
+    const parsed = JSON.parse(raw) as {
+      presets?: SettingsChapterPreset[]
+      selected?: Record<string, boolean>
+      order?: string[]
+    }
+    if (parsed.presets?.length) settingsChapterPresets.value = parsed.presets
+    if (parsed.selected) settingsSelectedChapters.value = parsed.selected
+    if (parsed.order?.length) settingsChapterOrder.value = parsed.order
+  } catch {
+    sessionStorage.removeItem(SETTINGS_STORAGE_KEY)
+  }
+}
+
+function savePromptFormToSession() {
+  sessionStorage.setItem(PROMPT_FORM_STORAGE_KEY, JSON.stringify({ ...promptChapterForm }))
+}
+
+function clearPromptTableDefaults() {
+  promptChapterForm.tableTitle = ''
+  promptChapterForm.tableRowLabels = ''
+  promptChapterForm.tableColumnLabels = ''
+  promptChapterForm.tableContent = ''
+  promptChapterForm.chartDescription = ''
+}
+
+function loadPromptFormFromSession() {
+  const raw = sessionStorage.getItem(PROMPT_FORM_STORAGE_KEY)
+  if (!raw) {
+    if (!sessionStorage.getItem(PROMPT_TABLE_DEFAULTS_CLEARED_KEY)) {
+      sessionStorage.setItem(PROMPT_TABLE_DEFAULTS_CLEARED_KEY, '1')
+    }
+    return
+  }
+  try {
+    const parsed = JSON.parse(raw) as Partial<PromptChapterForm>
+    Object.assign(promptChapterForm, createDefaultPromptChapterForm(), parsed)
+    // 舊 session 可能帶有表格預填範例，統一清空為默認空值
+    if (!sessionStorage.getItem(PROMPT_TABLE_DEFAULTS_CLEARED_KEY)) {
+      clearPromptTableDefaults()
+      sessionStorage.setItem(PROMPT_TABLE_DEFAULTS_CLEARED_KEY, '1')
+      savePromptFormToSession()
+    }
+  } catch {
+    sessionStorage.removeItem(PROMPT_FORM_STORAGE_KEY)
+  }
+}
+
+export type GeneratingSessionChapter = {
+  id: string
+  sectionId: string
+  sectionName: string
+  orderSeq: number
+  status: 'pending' | 'creating' | 'success' | 'failure'
+  body?: string
+}
+
+export type GeneratingSessionSnapshot = {
+  templateId: string
+  instanceId: string
+  chapters: GeneratingSessionChapter[]
+  isComplete: boolean
+}
+
+export function saveGeneratingSession(snapshot: GeneratingSessionSnapshot) {
+  sessionStorage.setItem(GENERATING_STORAGE_KEY, JSON.stringify(snapshot))
+}
+
+export function loadGeneratingSession(): GeneratingSessionSnapshot | null {
+  const raw = sessionStorage.getItem(GENERATING_STORAGE_KEY)
+  if (!raw) return null
+  try {
+    return JSON.parse(raw) as GeneratingSessionSnapshot
+  } catch {
+    sessionStorage.removeItem(GENERATING_STORAGE_KEY)
+    return null
+  }
+}
+
+export function clearGeneratingSession() {
+  sessionStorage.removeItem(GENERATING_STORAGE_KEY)
+}
+
+/** 瀏覽器刷新後從 session 恢復 build-report 編輯態 */
+function restoreReportEditSession() {
+  //0917 清掉 tip 聯調 Mock 殘留（英文 Grade A / 中文甲級寫字樓 / CBRE tip）
+  purgeTipChartStreamMockResidue()
+  loadDraftFromSession()
+  loadTemplateFromSession()
+  loadSourcesFromSession()
+  loadEditorsFromSession()
+  loadGeneratedBodiesFromSession()
+  loadSettingsFromSession()
+  loadPromptFormFromSession()
+}
+
+/** //0917 tip 聯調 Mock 指紋：清 session 殘留，避免刪源碼後畫面仍顯示假正文 */
+const TIP_CHART_STREAM_MOCK_RE =
+  /Grade A Offices\s*[—\-]\s*H1 2024|甲級寫字樓\s*2024\s*年上半年|POC source file\s*-\s*CBRE_2024/i
+
+function looksLikeTipChartStreamMock(text: unknown) {
+  return TIP_CHART_STREAM_MOCK_RE.test(String(text ?? ''))
+}
+
+function purgeTipChartStreamMockResidue() {
+  try {
+    clearChartStreamRefs()
+    sessionStorage.removeItem('gen-ai-chart-stream-refs')
+    sessionStorage.removeItem(CHAPTER_CHART_AUDIT_EVENT_STORAGE_KEY)
+    const bodiesRaw = sessionStorage.getItem(BODIES_STORAGE_KEY)
+    if (bodiesRaw && looksLikeTipChartStreamMock(bodiesRaw)) {
+      sessionStorage.removeItem(BODIES_STORAGE_KEY)
+      sessionStorage.removeItem(TITLES_STORAGE_KEY)
+    }
+    const generatingRaw = sessionStorage.getItem(GENERATING_STORAGE_KEY)
+    if (generatingRaw && looksLikeTipChartStreamMock(generatingRaw)) {
+      sessionStorage.removeItem(GENERATING_STORAGE_KEY)
+    }
+  } catch {
+    /* ignore */
+  }
+  generatedChapterBodies.value = generatedChapterBodies.value.map((body) =>
+    looksLikeTipChartStreamMock(body) ? '' : body
+  )
+  if (looksLikeTipChartStreamMock(chapterHistoryPreviewBody.value)) {
+    chapterHistoryPreviewBody.value = null
+  }
+  if (looksLikeTipChartStreamMock(reportGenerateStreamText.value)) {
+    clearReportGenerateStream()
+  }
+}
+
+watch(
+  sourceFiles,
+  () => {
+    draft.sourceCount = sourceFiles.value.filter((file) => file.selected).length
+    saveDraftToSession()
+    saveSourcesToSession()
+  },
+  { deep: true }
+)
+
+watch(
+  reportEditors,
+  () => {
+    saveEditorsToSession()
+  },
+  { deep: true }
+)
+
+watch(
+  [settingsChapterPresets, settingsSelectedChapters, settingsChapterOrder],
+  () => {
+    if (!settingsChapterPresets.value.length) return
+    saveSettingsToSession()
+  },
+  { deep: true }
+)
+
+watch(
+  promptChapterForm,
+  () => {
+    savePromptFormToSession()
+  },
+  { deep: true }
+)
+
+export function useReportWorkflow() {
+  const hasTemplate = computed(() => !!selectedTemplate.value)
+
+  const currentUserEditor = computed(
+    () => reportEditors.value.find((editor) => editor.id === CURRENT_USER_ID) ?? null
+  )
+  const isReportInitiator = computed(() => currentUserEditor.value?.role === 'initiator')
+  const isReportEditor = computed(() => currentUserEditor.value?.role === 'editor')
+  const canManageReportEditors = computed(() => isReportInitiator.value)
+  const canEditReport = computed(() => isReportInitiator.value || isReportEditor.value)
+
+  function patchDraft(partial: Partial<ReportDraft>) {
+    Object.assign(draft, partial)
+    saveDraftToSession()
+  }
+
+  function setSelectedTemplate(template: ReportTemplateCard | null) {
+    selectedTemplate.value = template
+    saveTemplateToSession()
+  }
+
+  function setModelStep(step: ReportModelStep) {
+    modelStep.value = step
+    flowStep.value = step
+    if (step !== 'prompt') {
+      applyPromptEditorUiFlags()
+      resetChapterEditMode()
+    }
+  }
+
+  function beginReportEditNavigation(step: ReportModelStep, rightPanel?: PromptRightPanel) {
+    reportEditNavLocked.value = true
+    reportEditNavTarget.value = step
+    reportEditNavRightPanel.value =
+      rightPanel ?? (step === 'prompt' ? promptRightPanel.value : null)
+    editViewOpen.value = true
+    // 先寫模組級 flowStep，再 remount 也不會丟（一鍵生成點一次即可）
+    setModelStep(step)
+    if (step === 'prompt') {
+      if (rightPanel === 'settings') applyGenerateSettingsUiFlags()
+      else if (rightPanel === 'prompt') applyPromptEditorUiFlags()
+    } else {
+      flowRightPanel.value = 'prompt'
+    }
+  }
+
+  function endReportEditNavigation() {
+    const target = reportEditNavTarget.value
+    const panel = reportEditNavRightPanel.value
+    if (target) {
+      setModelStep(target)
+    }
+    if (target === 'prompt') {
+      if (panel === 'settings') applyGenerateSettingsUiFlags()
+      else applyPromptEditorUiFlags()
+    } else if (target) {
+      flowRightPanel.value = 'prompt'
+    }
+    reportEditNavTarget.value = null
+    reportEditNavRightPanel.value = null
+    reportEditNavLocked.value = false
+  }
+
+  function isReportEditNavLocked() {
+    return reportEditNavLocked.value
+  }
+
+  function remountReportEditPage() {
+    reportEditMountKey.value += 1
+  }
+
+  function ensureSettingsChapterLayout(chapters?: string[]) {
+    // 僅接受接口章節標題；無數據則空列表（不再回落模板 / 硬編碼 mock）
+    const source = chapters?.length ? chapters : []
+    if (!source.length) {
+      settingsChapterPresets.value = []
+      settingsChapterOrder.value = []
+      settingsSelectedChapters.value = {}
+      settingsChapterVersionOptions.value = {}
+      settingsChapterVersions.value = {}
+      settingsChapterGenerators.value = {}
+      return
+    }
+    const unavailable = new Set(['附件與數'])
+    const presets = source.map((title, index) => ({
+      key: `chapter-${index}`,
+      label: stripChapterNumberPrefix(title),
+    }))
+    settingsChapterPresets.value = presets
+    settingsChapterOrder.value = presets.map((preset) => preset.key)
+    settingsSelectedChapters.value = Object.fromEntries(
+      presets.map((preset) => [preset.key, !unavailable.has(preset.label)])
+    )
+    settingsChapterVersionOptions.value = {}
+    settingsChapterVersions.value = Object.fromEntries(presets.map((preset) => [preset.key, '']))
+    saveSettingsToSession()
+  }
+
+  /**
+   * AdjustInstance.instanceSections → 右側章節列表 + 版本下拉
+   * - sectionTitle → 章節名稱
+   * - versions[].text → 版本 select 下拉展示
+   * - versions[].value → select 綁定值（UUID）
+   * - selected → 章節是否勾選（優先 section.selected；否則 versions 任一 selected）
+   * - 版本下拉默認項：versions 中 selected 為真的項，否則取第一個
+   */
+  function applyAdjustInstanceSections(
+    sections: Array<{
+      sectionTitle: string
+      selected?: boolean | string | number
+      createUserName?: string
+      versions?: Array<{
+        text: string 
+        value: string
+        selected?: boolean | string | number
+        uploadUsrNameDisplay?: string
+      }>
+    }>
+  ) {
+    const list = Array.isArray(sections) ? sections : []
+    const presets = list.map((section, index) => ({
+      key: `chapter-${index}`,
+      label: stripChapterNumberPrefix(section.sectionTitle || `章節${index + 1}`),
+    }))
+    settingsChapterPresets.value = presets
+    settingsChapterOrder.value = presets.map((preset) => preset.key)
+
+    const optionsMap: Record<string, SettingsChapterVersionOption[]> = {}
+    const versionValueMap: Record<string, string> = {}
+    const checkedMap: Record<string, boolean> = {}
+    const generatorMap: Record<string, string> = {}
+
+    list.forEach((section, index) => {
+      const key = `chapter-${index}`
+      const sectionGenerator = String(section.createUserName ?? '').trim()
+      const versions = (Array.isArray(section.versions) ? section.versions : []).map((item) => ({
+        text: String(item.text ?? ''),
+        value: String(item.value ?? ''),
+        selected: isGenAiSelectedFlag(item.selected),
+        uploadUsrNameDisplay: String(
+          item.uploadUsrNameDisplay ?? sectionGenerator ?? ''
+        ).trim(),
+      }))
+      optionsMap[key] = versions
+
+      // 版本下拉默認：selected 的版本，否則第一個（展示 text，如 V3）
+      const picked = versions.find((item) => item.selected) ?? versions[0]
+      versionValueMap[key] = picked?.value ?? ''
+
+      // 章節勾選：優先章節自身 selected；否則看 versions 是否有 selected
+      if (section.selected !== undefined && section.selected !== null && section.selected !== '') {
+        checkedMap[key] = isGenAiSelectedFlag(section.selected)
+      } else {
+        checkedMap[key] = versions.some((item) => item.selected)
+      }
+
+      generatorMap[key] = sectionGenerator || String(picked?.uploadUsrNameDisplay ?? '').trim()
+    })
+
+    settingsChapterVersionOptions.value = optionsMap
+    settingsChapterVersions.value = versionValueMap
+    settingsSelectedChapters.value = checkedMap
+    settingsChapterGenerators.value = generatorMap
+    saveSettingsToSession()
+  }
+
+  /**
+   * AdjustInstance / AdjustInstanceSetting.instanceFileList → 資訊源列表
+   * - text → 檔案名稱
+   * - value → 文件 UUID（id）
+   * - selected → 勾選反顯（報告歷史環節只讀，不可主動改）
+   */
+  function applyAdjustInstanceFiles(
+    files: Array<{ text: string; value: string; selected?: boolean | string | number }>
+  ) {
+    const list = Array.isArray(files) ? files : []
+    sourceFiles.value = list.map((file) => ({
+      id: String(file.value ?? ''),
+      name: String(file.text ?? ''),
+      selected: isGenAiSelectedFlag(file.selected),
+    }))
+  }
+
+  function clearAdjustInstanceBindings() {
+    settingsChapterPresets.value = []
+    settingsChapterOrder.value = []
+    settingsSelectedChapters.value = {}
+    settingsChapterVersionOptions.value = {}
+    settingsChapterVersions.value = {}
+    settingsChapterGenerators.value = {}
+    adjustInstanceContents.value = []
+    existsInstanceVersionNo.value = null
+    clearCoherenceCheckResultReady()
+    adjustInstanceSettingSyncKey.value = ''
+    // 不清空 sourceFiles：返回章節編輯後「生成報告」仍依賴本地資訊源校驗；
+    // 進設置頁時由 AdjustInstance → applyAdjustInstanceFiles 覆蓋即可。
+  }
+
+  function showPromptSettingsPanel() {
+    exitChapterEditMode(true)
+    // 章節佈局等 AdjustInstance；不再用模板 mock 預填
+    applyGenerateSettingsUiFlags()
+  }
+
+  function showPromptEditorPanel() {
+    applyPromptEditorUiFlags()
+  }
+
+  function openReportEdit(step: ReportModelStep = 'select') {
+    // 鎖定期只允許跳到導航目標，避免中間態路由回寫
+    if (
+      reportEditNavLocked.value &&
+      reportEditNavTarget.value &&
+      step !== reportEditNavTarget.value
+    ) {
+      return
+    }
+    editViewOpen.value = true
+    setModelStep(step)
+    // 右側欄（prompt / settings）由 showPrompt*Panel 單獨控制，此處不覆寫
+  }
+
+  function closeReportEdit() {
+    if (reportEditNavLocked.value) return
+    editViewOpen.value = false
+  }
+
+  function setGeneratedChapterBodies(bodies: string[]) {
+    generatedChapterBodies.value = bodies
+    saveGeneratedBodiesToSession()
+  }
+
+  /** 進入編輯：以生成接口章節列表為準寫入標題 + 正文 */
+  function setGeneratedChaptersFromApi(chapters: Array<{ title: string; body: string }>) {
+    generatedChapterTitles.value = chapters.map((item) => item.title)
+    generatedChapterBodies.value = chapters.map((item) => item.body)
+    saveGeneratedBodiesToSession()
+    if (generatedChapterTitles.value.length) {
+      ensureSettingsChapterLayout(generatedChapterTitles.value)
+    }
+  }
+
+  /**
+   * 每次進入 ReportChapterWorkspace：清除歷史預覽 / 章節歷史 / Prompt，
+   * 待 getSectionVersionList 等接口覆蓋（不回填 mock）
+   */
+  function resetWorkspaceHistoryOnEnter() {
+    resetHistoryPreviewState()
+    historyPreviewApplyToken.value += 1
+    chapterHistoryItems.value = []
+    activeChapterHistoryKey.value = ''
+    chapterHistoryPreviewBody.value = null
+    chapterHistoryApplyToken.value += 1
+    Object.assign(promptChapterForm, createDefaultPromptChapterForm())
+    resetChapterEditMode()
+  }
+
+  function markGenerationSuccess() {
+    generationDone.value = true
+    editViewOpen.value = true
+    // 不在此處改 modelStep：由 handleEnterEditing → navigateAndRemount('prompt') 統一切頁
+    // 避免「store 已是 prompt、路由仍是 generating」導致畫面與路由互打
+    clearGeneratingSession()
+  }
+
+  function resetWorkflow() {
+    selectedTemplate.value = null
+    modelStep.value = 'select'
+    generationDone.value = false
+    applyPromptEditorUiFlags()
+  }
+
+  function prependReportHistory(title: string, recordId: string, finalizedAt?: string) {
+    const key = `history-${Date.now()}`
+    const author =
+      reportEditors.value.find((editor) => editor.role === 'initiator')?.name?.trim() ||
+      reportEditors.value.find((editor) => editor.id === CURRENT_USER_ID)?.name?.trim() ||
+      ''
+    reportHistoryItems.value.unshift({
+      key,
+      title,
+      author,
+      finalizedAt: finalizedAt ?? new Date().toISOString(),
+      recordId,
+    })
+    activeHistoryKey.value = key
+    historyScrollTargetKey.value = key
+    return key
+  }
+
+  function clearHistoryScrollTarget() {
+    historyScrollTargetKey.value = null
+  }
+
+  function applyHistoryPreviewSources(sourceFileIds: string[]) {
+    const selectedSet = new Set(sourceFileIds)
+    for (const file of sourceFiles.value) {
+      file.selected = selectedSet.has(file.id)
+    }
+  }
+
+  function selectHistoryReport(recordId: string) {
+    const record = findFinalizedReportById(recordId)
+    if (!record) return
+
+    const historyItem = reportHistoryItems.value.find((item) => item.recordId === recordId)
+    if (historyItem) {
+      activeHistoryKey.value = historyItem.key
+    }
+
+    historyPreviewRecordId.value = recordId
+    historyPreviewLayoutBaseline.value = serializeSelectedChapterLabels(record.chapters)
+    historyPreviewDirty.value = false
+    historyPreviewChapterBodies.value = buildReportHistoryChapterBodies(record)
+    historyPreviewApplyToken.value += 1
+    chapterHistoryPreviewBody.value = null
+    chapterHistoryApplyToken.value += 1
+
+    applyHistoryPreviewSources(record.sourceFileIds)
+    patchDraft({
+      language: record.reportLanguage,
+      chapterContentLanguage: record.chapterContentLanguage,
+    })
+    showPromptSettingsPanel()
+  }
+
+  function markHistoryPreviewDirty() {
+    if (!historyPreviewRecordId.value || historyPreviewDirty.value) return
+    historyPreviewDirty.value = true
+    historyPreviewRecordId.value = null
+    historyPreviewLayoutBaseline.value = null
+    historyPreviewChapterBodies.value = []
+  }
+
+  function resetHistoryPreviewState() {
+    historyPreviewRecordId.value = null
+    historyPreviewLayoutBaseline.value = null
+    historyPreviewDirty.value = false
+    historyPreviewChapterBodies.value = []
+  }
+
+  function selectChapterHistory(key: string) {
+    const item = chapterHistoryItems.value.find((entry) => entry.key === key)
+    if (!item) return false
+
+    activeChapterHistoryKey.value = key
+    // 正文 / Prompt 由 ReportChapterWorkspace 依接口版本列表 watch 套用；不再回落本地 mock 快照
+    return true
+  }
+
+  function renameChapterHistory(key: string, title: string) {
+    const trimmed = title.trim()
+    if (!trimmed) return false
+
+    const item = chapterHistoryItems.value.find((entry) => entry.key === key)
+    if (!item) return false
+
+    item.title = trimmed.slice(0, 50)
+    return true
+  }
+
+  function deleteChapterHistory(key: string) {
+    const index = chapterHistoryItems.value.findIndex((entry) => entry.key === key)
+    if (index === -1) return false
+
+    chapterHistoryItems.value.splice(index, 1)
+
+    if (activeChapterHistoryKey.value === key) {
+      const nextKey = chapterHistoryItems.value[0]?.key ?? ''
+      activeChapterHistoryKey.value = nextKey
+      if (!nextKey) {
+        chapterHistoryPreviewBody.value = null
+        chapterHistoryApplyToken.value += 1
+      }
+    }
+
+    return true
+  }
+
+  return {
+    draft,
+    selectedTemplate,
+    modelStep,
+    editViewOpen,
+    reportEditMountKey,
+    remountReportEditPage,
+    beginReportEditNavigation,
+    endReportEditNavigation,
+    isReportEditNavLocked,
+    promptRightPanel,
+    flowStep,
+    flowRightPanel,
+    uiShowPromptPanel,
+    uiShowGenerateSettingsPanel,
+    uiShowChapterEditToolbar,
+    uiShowFinalizeToolbar,
+    uiShowSettingsDoc,
+    uiShowEditorSummary,
+    generationDone,
+    generatedChapterBodies,
+    generatedChapterTitles,
+    settingsChapterPresets,
+    settingsSelectedChapters,
+    settingsChapterOrder,
+    settingsChapterVersionOptions,
+    settingsChapterVersions,
+    settingsChapterGenerators,
+    adjustInstanceContents,
+    setAdjustInstanceContents,
+    existsInstanceVersionNo,
+    setExistsInstanceVersionNo,
+    coherenceResultReady,
+    coherenceCheckContentText,
+    setCoherenceCheckResultReady,
+    clearCoherenceCheckResultReady,
+    adjustInstanceSettingSyncKey,
+    markAdjustInstanceSettingSynced,
+    isAdjustInstanceSettingSynced,
+    suppressAdjustInstanceSettingWatch,
+    beginSuppressAdjustInstanceSettingWatch,
+    endSuppressAdjustInstanceSettingWatch,
+    applyAdjustInstanceSections,
+    applyAdjustInstanceFiles,
+    clearAdjustInstanceBindings,
+    settingsTypewriterReplayKey,
+    settingsTypewriterReplayToken,
+    settingsTypingChapterKey,
+    settingsTypewriterPrinting,
+    requestSettingsTypewriterReplay,
+    setSettingsTypingChapterKey,
+    setSettingsTypewriterPrinting,
+    chapterTypewriterActive,
+    chapterContentAwaitingFirstChunk,
+    chapterContentStreamEpoch,
+    startChapterContentTypewriter,
+    markChapterContentFirstChunk,
+    stopChapterContentTypewriter,
+    chapterChartAuditEventId,
+    setChapterChartAuditEventId,
+    clearChapterChartAuditEventId,
+    resolveChapterChartAuditEventId,
+    upsertChapterChartStreamRef,
+    clearChapterChartStreamRefs,
+    upsertChapterChartStreamRefsFromSources,
+    reportGenerateStreamText,
+    reportGenerateStreamActive,
+    reportGenerateStreamEnded,
+    beginReportGenerateStream,
+    appendReportGenerateStream,
+    finishReportGenerateStream,
+    clearReportGenerateStream,
+    patchGeneratedChapterBody,
+    clearSettingsTypewriterReplay,
+    sourceFiles,
+    pendingFiles,
+    reportEditors,
+    reportHistoryItems,
+    activeHistoryKey,
+    historyScrollTargetKey,
+    historyPreviewRecordId,
+    historyPreviewLayoutBaseline,
+    historyPreviewDirty,
+    historyPreviewApplyToken,
+    historyPreviewChapterBodies,
+    chapterHistoryItems,
+    activeChapterHistoryKey,
+    chapterHistoryPreviewBody,
+    chapterHistoryApplyToken,
+    chapterHistoryOpen,
+    prependReportHistory,
+    clearHistoryScrollTarget,
+    selectHistoryReport,
+    markHistoryPreviewDirty,
+    resetHistoryPreviewState,
+    selectChapterHistory,
+    renameChapterHistory,
+    deleteChapterHistory,
+    currentUserEditor,
+    isReportInitiator,
+    isReportEditor,
+    canManageReportEditors,
+    canEditReport,
+    hasTemplate,
+    promptChapterForm,
+    chapterEditMode,
+    aiPromptDialogRequestToken,
+    aiPromptDialogSource,
+    requestOpenAiPromptDialog,
+    enterChapterEditMode,
+    commitChapterEdit,
+    exitChapterEditMode,
+    isChapterEditDirty,
+    resetChapterEditMode,
+    saveDraftToSession,
+    upsertChapterDraftHistory,
+    removeChapterDraftHistory,
+    loadDraftFromSession,
+    loadTemplateFromSession,
+    restoreReportEditSession,
+    saveGeneratingSession,
+    loadGeneratingSession,
+    clearGeneratingSession,
+    patchDraft,
+    setSelectedTemplate,
+    setModelStep,
+    showPromptSettingsPanel,
+    ensureSettingsChapterLayout,
+    showPromptEditorPanel,
+    openReportEdit,
+    closeReportEdit,
+    setGeneratedChapterBodies,
+    setGeneratedChaptersFromApi,
+    resetWorkspaceHistoryOnEnter,
+    markGenerationSuccess,
+    resetWorkflow,
+  }
+}