From ace32c85c15437525183b86d8cd76f2faadfaac3 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EC=9C=A4=EC=9A=A9=EC=8B=9D?= <comnori@gmail.com>
Date: Tue, 29 Sep 2026 23:01:29 +0900
Subject: [PATCH 1/6] fix: align desktop smoke tests and validation
 expectations

---
 apps/desktop/src/renderer/app/main.tsx        |  9 ++---
 .../src/renderer/features/search/search.tsx   |  4 +--
 .../src/renderer/shared/lib/accessibility.ts  |  2 +-
 .../widgets/document-workspace/documents.tsx  |  4 +--
 .../widgets/document-workspace/preview.tsx    | 10 +++---
 scripts/integration-support.test.mjs          |  4 +--
 scripts/m1-02-smoke.mjs                       | 12 +++----
 scripts/m1-03-smoke.mjs                       |  1 +
 scripts/m1-04-smoke.mjs                       |  1 +
 scripts/m1-05-smoke.mjs                       | 12 +++----
 scripts/m1-06-smoke.mjs                       | 10 +++---
 scripts/m1-08-smoke.mjs                       |  5 +--
 scripts/m2-05-smoke.mjs                       |  3 +-
 scripts/m2-06-smoke.mjs                       | 11 +++---
 scripts/m2-07-smoke.mjs                       |  1 +
 scripts/m3-01-smoke.mjs                       |  2 +-
 scripts/m4-01-baseline.mjs                    |  1 +
 scripts/m4-02-smoke.mjs                       | 35 ++++++++++---------
 scripts/m4-03-smoke.mjs                       |  2 +-
 scripts/m4-04-smoke.mjs                       |  3 +-
 scripts/m4-05-smoke.mjs                       | 13 +++----
 scripts/m4-06-smoke.mjs                       |  9 ++---
 scripts/m4-07-smoke.mjs                       | 10 +++---
 scripts/package-cleanup.mjs                   |  3 +-
 scripts/package-cleanup.test.mjs              | 17 ++++++++-
 scripts/preview-features-smoke.mjs            |  2 +-
 scripts/test-cache-cleanup.mjs                |  5 +--
 scripts/test-cache-cleanup.test.mjs           | 13 +++++++
 scripts/ux-02-session.mjs                     | 10 +++---
 scripts/ux-escape-smoke.mjs                   |  6 ++--
 30 files changed, 132 insertions(+), 88 deletions(-)

diff --git a/apps/desktop/src/renderer/app/main.tsx b/apps/desktop/src/renderer/app/main.tsx
index 02027e3..cee05be 100644
--- a/apps/desktop/src/renderer/app/main.tsx
+++ b/apps/desktop/src/renderer/app/main.tsx
@@ -59,6 +59,7 @@ async function call<T>(work: () => Promise<Result<T>>): Promise<Result<T>> {
 }
 function App() {
   const documents = useRef<DocumentsHandle>(null);
+  const [inspectorTarget, setInspectorTarget] = useState<HTMLDivElement | null>(null);
   const [helpOpen, setHelpOpen] = useState(false);
   const [settingsOpen, setSettingsOpen] = useState(false);
   const [hideHints, setHideHints] = useState(() => { try { return localStorage.getItem('metis.welcome.hidden.v1') === 'true'; } catch { return false; } });
@@ -337,7 +338,7 @@ function App() {
     { id: 'workspace.refresh', label: '폴더 새로 고침', reason: folderReady, run: () => list(session!, folder) },
     { id: 'workspace.newDocument', label: '새 문서', reason: writable, run: () => beginCreate('document') },
     { id: 'workspace.newDirectory', label: '새 폴더', reason: writable, run: () => beginCreate('directory') },
-    { id: 'search.text', label: '검색', shortcut: 'Ctrl/Cmd+Shift+F', reason: needsWorkspace, run: () => { setSearchMode('text'); if (layout.narrow) layout.setMobile('left'); else layout.update({ ...layout.value, left: { ...layout.value.left, open: true, active: 'search' } }); } },
+    { id: 'search.text', label: '검색', shortcut: 'Ctrl/Cmd+Shift+F', reason: needsWorkspace, run: () => { setSearchMode('text'); if (layout.narrow) layout.setMobile('left'); layout.update({ ...layout.value, left: { ...layout.value.left, open: true, active: 'search' } }); } },
     { id: 'search.files', label: '빠른 열기', shortcut: 'Ctrl/Cmd+P', reason: needsWorkspace, run: () => setSearchMode('files') },
     { id: 'proposal.open', label: '변경 제안 검토', reason: () => needsWorkspace() ?? (!document ? '먼저 문서를 열어 주세요.' : undefined), run: () => setProposalOpen(true) },
     { id: 'semantic.open', label: '의미·텍스트 비교', reason: () => needsWorkspace() ?? (!document ? '먼저 문서를 열어 주세요.' : undefined), run: () => setSemanticOpen(true) },
@@ -409,14 +410,14 @@ function App() {
         {sidebarCommandButton('workspace.newDirectory', 'folder', '새 폴더')}{sidebarCommandButton('workspace.newDocument', 'document', '새 문서')}</div>
       <nav className="file-tree" aria-label="파일 탐색">{treeRows()}</nav>
       {loading ? <p>목록을 읽고 있습니다.</p> : !entries.length && <p>표시할 폴더나 AsciiDoc 문서가 없습니다.</p>}</>}</div>}
-      {layout.value.left.active === 'search' && session && <Search embedded key={`${session.workspaceId}-${session.workspaceEpoch}-text`} memory={searchMemory.current.text ??= {}} session={session} initialMode="text" close={() => { if (layout.narrow) layout.setMobile(undefined); else layout.update({ ...layout.value, left: { ...layout.value.left, open: false } }); }} open={hit => { void read({ name: hit.label, relativePath: hit.relativePath, kind: 'document' }, hit.kind === 'file' ? undefined : hit.line, hit.revision); }} />}
+      {layout.value.left.active === 'search' && session && <Search embedded key={`${session.workspaceId}-${session.workspaceEpoch}-text`} memory={searchMemory.current.text ??= {}} session={session} initialMode="text" close={() => { if (layout.narrow) layout.setMobile(undefined); layout.update({ ...layout.value, left: { ...layout.value.left, active: 'files', open: layout.narrow ? layout.value.left.open : false } }); window.document.querySelector<HTMLButtonElement>('.ribbon-button[aria-label="검색"]')?.focus(); }} open={hit => { void read({ name: hit.label, relativePath: hit.relativePath, kind: 'document' }, hit.kind === 'file' ? undefined : hit.line, hit.revision); }} />}
       {layout.value.left.active === 'favorites' && <div className="sidebar-panel favorites-panel"><h2>즐겨찾기</h2>{favorites.length ? favorites.map(path => <div className={`favorite-row ${document?.relativePath === path ? 'active' : ''}`} key={path}><button title={path} onClick={() => void read({ name: path.split('/').at(-1) ?? path, relativePath: path, kind: 'document' })}>{path}</button><button aria-label={`${path} 즐겨찾기 제거`} onClick={() => toggleFavorite(path)}>★</button></div>) : <p>즐겨찾기한 문서가 없습니다.</p>}</div>}
     </aside>
     {leftVisible && !layout.narrow && <PanelResizer side="left" value={layout.value.left.width} min={180} max={420} resize={layout.resizeLeft} />}
     <main className="center-workspace" tabIndex={-1} aria-label="문서 작업 영역">
       <div className="workspace-tabs" role="tablist" aria-label="열린 뷰" onKeyDown={event => { if (!['ArrowLeft', 'ArrowRight', 'Home', 'End'].includes(event.key)) return; const tabs = [...event.currentTarget.querySelectorAll<HTMLButtonElement>('[role=tab]')], index = tabs.indexOf(event.target as HTMLButtonElement); if (index < 0) return; event.preventDefault(); tabs[event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : Math.min(tabs.length - 1, Math.max(0, index + (event.key === 'ArrowRight' ? 1 : -1)))].focus(); tabs[event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : Math.min(tabs.length - 1, Math.max(0, index + (event.key === 'ArrowRight' ? 1 : -1)))].click(); }}>{documentTabs.map(tab => <div className={`workspace-tab ${centerView === 'documents' && document?.relativePath === tab.path ? 'active' : ''}`} key={tab.path}><button role="tab" aria-selected={centerView === 'documents' && document?.relativePath === tab.path} title={tab.path} onClick={() => selectDocumentTab(tab.path)}>{tab.dirty ? '● ' : ''}{tab.path.split('/').at(-1)}</button><button className="tab-close" aria-label={`${tab.path} 탭 닫기`} onClick={() => void documents.current?.closeTab(tab.path)}>×</button></div>)}{graphOpen && <div className={`workspace-tab ${centerView === 'graph' ? 'active' : ''}`}><button role="tab" aria-selected={centerView === 'graph'} onClick={() => setCenterView('graph')}>◎ 그래프</button><button className="tab-close" aria-label="그래프 탭 닫기" onClick={() => { setGraphOpen(false); setCenterView('documents'); }}>×</button></div>}</div>
       {error && !creating && <div className="operation-status" data-phase="failed"><p role="alert"><strong>작업 실패</strong> — {error}</p><button onClick={() => setError('')}>오류 안내 닫기</button>{document && <details><summary>편집 보존·복구 작업</summary><p>저장·외부 변경 문제라면 현재 편집을 보존하고 원문 상태를 확인하세요.</p>{commandButton('document.preserve')}{commandButton('document.inspect')}{commandButton('recovery.open')}{commandButton('recovery.folder')}</details>}</div>}{warning && <div className="notice">{warning}</div>}
-      <div className="document-workspace" hidden={centerView !== 'documents' || !document}><Documents appearance={appearance.value} stylesheetVersion={stylesheetVersion} favorites={favorites} onToggleFavorite={toggleFavorite} onCommandsChanged={() => updateCommands(value => value + 1)} ref={documents} session={session} onSource={entry => { void read({ name: entry.relativePath, relativePath: entry.relativePath, kind: 'document' }, entry.line); }} onActive={value => { reading.current++; setDocument(value); setActiveAnalysis(undefined); }} onAnalysis={(_path, analysis) => setActiveAnalysis(analysis)} onTabsChanged={(tabs) => setDocumentTabs(tabs)} onError={setError} onStatus={setStatus} onBusy={value => { locked.current = value; setBusy(value); }} /></div>
+      <div className="document-workspace" hidden={centerView !== 'documents' || !document}><Documents inspectorTarget={inspectorTarget} appearance={appearance.value} stylesheetVersion={stylesheetVersion} favorites={favorites} onToggleFavorite={toggleFavorite} onCommandsChanged={() => updateCommands(value => value + 1)} ref={documents} session={session} onSource={entry => { void read({ name: entry.relativePath, relativePath: entry.relativePath, kind: 'document' }, entry.line); }} onActive={value => { reading.current++; setDocument(value); setActiveAnalysis(undefined); }} onAnalysis={(_path, analysis) => setActiveAnalysis(analysis)} onTabsChanged={(tabs) => setDocumentTabs(tabs)} onError={setError} onStatus={setStatus} onBusy={value => { locked.current = value; setBusy(value); }} /></div>
       {session && graphOpen && <div className="graph-tab-workspace" hidden={centerView !== 'graph'}><Relations embedded key={`${session.workspaceId}-${session.workspaceEpoch}-graph`} session={session} initialPath={document?.relativePath} initialMode="graph" close={() => { setGraphOpen(false); setCenterView('documents'); }} open={(source, revision) => { setCenterView('documents'); void read({ name: source.relativePath, relativePath: source.relativePath, kind: 'document' }, source.line, revision); }} /></div>}
       {centerView === 'documents' && !document &&
       <div className="empty"><div className="mark">M</div><h1>{session ? '작업 공간을 열었습니다.' : '문서가 있는 곳에서 시작하세요.'}</h1>
@@ -427,7 +428,7 @@ function App() {
       </div>}</main>
     {rightVisible && !layout.narrow && <PanelResizer side="right" value={layout.value.right.width} min={220} max={420} resize={layout.resizeRight} />}
     <aside className="right-sidebar" aria-label="오른쪽 사이드바" inert={!rightVisible}><div className="sidebar-tabs" role="tablist" aria-label="오른쪽 패널"><button role="tab" aria-selected={layout.value.right.active === 'outline'} onClick={() => layout.update({ ...layout.value, right: { ...layout.value.right, active: 'outline', open: true } })}>목차</button><button role="tab" aria-selected={layout.value.right.active === 'relations'} onClick={() => layout.update({ ...layout.value, right: { ...layout.value.right, active: 'relations', open: true } })}>관계</button><button role="tab" aria-selected={layout.value.right.active === 'diagnostics'} onClick={() => layout.update({ ...layout.value, right: { ...layout.value.right, active: 'diagnostics', open: true } })}>진단</button></div><div className="sidebar-panel inspector-panel">
-      {layout.value.right.active === 'outline' && <section aria-label="문서 목차"><h2>목차</h2>{activeAnalysis?.outline.length ? activeAnalysis.outline.map(item => <button className="inspector-item" style={{ paddingLeft: `${8 + (item.level - 1) * 12}px` }} key={`${item.id}-${item.line}`} onClick={() => document && void read({ name: document.relativePath, relativePath: item.relativePath, kind: 'document' }, item.line)}>{item.title}</button>) : <p>활성 문서의 목차가 없습니다.</p>}</section>}
+      <div ref={setInspectorTarget} hidden={layout.value.right.active !== 'outline'} aria-label="문서 목차" />
       {layout.value.right.active === 'relations' && <section aria-label="문서 관계"><h2>관계</h2>{activeAnalysis?.relations.length ? activeAnalysis.relations.map((item, index) => <button className="inspector-item" key={index} onClick={() => void read({ name: item.destination?.relativePath ?? item.relativePath, relativePath: item.destination?.relativePath ?? item.relativePath, kind: 'document' }, item.destination?.line ?? item.line)}>{item.kind === 'xref' ? '참조' : '포함'} · {item.target}</button>) : <p>활성 문서에서 해석된 관계가 없습니다.</p>}</section>}
       {layout.value.right.active === 'diagnostics' && <section aria-label="문서 진단"><h2>진단</h2>{activeAnalysis?.diagnostics.length ? activeAnalysis.diagnostics.map((item, index) => <button className="inspector-item" key={index} onClick={() => void read({ name: item.relativePath, relativePath: item.relativePath, kind: 'document' }, item.line)}>{item.line} · {item.message}</button>) : <p>활성 문서의 진단이 없습니다.</p>}</section>}
     </div></aside>
diff --git a/apps/desktop/src/renderer/features/search/search.tsx b/apps/desktop/src/renderer/features/search/search.tsx
index bc7ea4b..d377ac0 100644
--- a/apps/desktop/src/renderer/features/search/search.tsx
+++ b/apps/desktop/src/renderer/features/search/search.tsx
@@ -41,7 +41,7 @@ export function Search({ session, initialMode, memory, close, open, embedded = f
     <p>저장된 .adoc 기준 · 미저장 편집 제외 · 외부 변경은 다시 검색하면 반영됩니다.</p>
     <div className="search-controls"><label>검색 모드<select value={mode} onChange={event => setMode(event.target.value as SearchRequest['mode'])}><option value="text">본문</option><option value="files">파일 · 빠른 열기</option><option value="symbols">심볼 · 절</option></select></label>
       <label><input type="checkbox" checked={caseSensitive} onChange={event => setCase(event.target.checked)} />대소문자 구분</label></div>
-    <label>검색어<input autoFocus={!embedded} type="search" maxLength={200} value={query} onChange={event => setQuery(event.target.value)} onKeyDown={event => { if (event.nativeEvent.isComposing || event.keyCode === 229) return; if (event.key === 'ArrowDown') { event.preventDefault(); container.current?.querySelector<HTMLButtonElement>('.search-result')?.focus(); } if (event.key === 'Enter') setRetry(value => value + 1); }} /></label>
+    <label>검색어<input autoFocus type="search" maxLength={200} value={query} onChange={event => setQuery(event.target.value)} onKeyDown={event => { if (event.nativeEvent.isComposing || event.keyCode === 229) return; if (event.key === 'ArrowDown') { event.preventDefault(); container.current?.querySelector<HTMLButtonElement>('.search-result')?.focus(); } if (event.key === 'Enter') setRetry(value => value + 1); }} /></label>
     <div className="tools"><button onClick={() => setRetry(value => value + 1)}>다시 검색</button>{running && <button onClick={cancel}>검색 취소</button>}</div>
     <div className="search-controls"><label>결과 경로 필터<input value={pathFilter} maxLength={200} onChange={event => setPathFilter(event.target.value)} /></label><label>결과 종류<select value={kindFilter} onChange={event => setKindFilter(event.target.value)}><option value="">전체</option>{Object.entries(kinds).map(([key, label]) => <option key={key} value={key}>{label}</option>)}</select></label><button onClick={() => { setPathFilter(''); setKindFilter(''); }}>필터 초기화</button></div>
     <p>Escape로 검색어를 지우지 않고 창을 닫습니다. 글자 조합 중에는 창을 유지합니다. 필터는 받은 결과 안에서 적용됩니다. 검색어에서 아래 방향키로 결과 이동, 위·아래/Home/End로 선택, Enter로 열 수 있습니다.</p>
@@ -61,6 +61,6 @@ export function Search({ session, initialMode, memory, close, open, embedded = f
         <strong>{kinds[hit.kind]} · {hit.label}</strong><small>{hit.relativePath}:{hit.line}</small><span>{hit.context}</span></button>)}</div></>}
   </>;
   return embedded
-    ? <section className="search-panel" ref={node => { container.current = node; }} aria-labelledby="search-title">{content}</section>
+    ? <section {...escape} className="search-panel" ref={node => { container.current = node; }} aria-labelledby="search-title">{content}</section>
     : <dialog {...escape} className="search-dialog" ref={node => { container.current = node; }} aria-labelledby="search-title" onCancel={event => { event.preventDefault(); close(); }}>{content}</dialog>;
 }
diff --git a/apps/desktop/src/renderer/shared/lib/accessibility.ts b/apps/desktop/src/renderer/shared/lib/accessibility.ts
index cbf5f99..82b3961 100644
--- a/apps/desktop/src/renderer/shared/lib/accessibility.ts
+++ b/apps/desktop/src/renderer/shared/lib/accessibility.ts
@@ -25,7 +25,7 @@ export function useSearchDialogEscape(close: () => void) {
   return {
     onCompositionStartCapture: () => { composing.current = true; },
     onCompositionEndCapture: () => { composing.current = false; },
-    onKeyDownCapture: (event: KeyboardEvent<HTMLDialogElement>) => {
+    onKeyDownCapture: (event: KeyboardEvent<HTMLElement>) => {
       if (event.key !== 'Escape') return;
       event.preventDefault();
       event.stopPropagation();
diff --git a/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx b/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
index 98be0bf..12aa3e9 100644
--- a/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
+++ b/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
@@ -43,7 +43,7 @@ function Editor({ tab, changed, save }: { tab: Tab; changed(): void; save(): voi
   useEffect(() => { const readonly = !!tab.baseline.readOnly || tab.baseline.eol === 'mixed'; tab.view?.dispatch({ effects: access.current.reconfigure([EditorState.readOnly.of(readonly), EditorView.editable.of(!readonly)]) }); }, [tab, tab.baseline.readOnly, tab.baseline.eol]);
   return <div className="source" ref={element} />;
 }
-export const Documents = forwardRef<DocumentsHandle, { session?: Session; appearance: WorkspaceAppearanceV1; stylesheetVersion: number; favorites: string[]; onToggleFavorite(path: string): void; onSource(entry: OutlineEntry): void; onActive(document?: DocumentSnapshot): void; onAnalysis(path: string, analysis: Analysis): void; onTabsChanged(tabs: DocumentTabSnapshot[], active: string): void; onError(message: string): void; onStatus(message: string): void; onBusy(value: boolean): void; onCommandsChanged(): void }>(function Documents(props, ref) {
+export const Documents = forwardRef<DocumentsHandle, { session?: Session; inspectorTarget?: HTMLElement | null; appearance: WorkspaceAppearanceV1; stylesheetVersion: number; favorites: string[]; onToggleFavorite(path: string): void; onSource(entry: OutlineEntry): void; onActive(document?: DocumentSnapshot): void; onAnalysis(path: string, analysis: Analysis): void; onTabsChanged(tabs: DocumentTabSnapshot[], active: string): void; onError(message: string): void; onStatus(message: string): void; onBusy(value: boolean): void; onCommandsChanged(): void }>(function Documents(props, ref) {
   const tabs = useRef(new Map<string, Tab>());
   const [active, setActive] = useState('');
   const activeRef = useRef('');
@@ -295,7 +295,7 @@ export const Documents = forwardRef<DocumentsHandle, { session?: Session; appear
     {review && <Conflict baseline={review.tab.baseline} disk={review.disk} text={review.tab.text} close={() => setReview(undefined)} resolve={resolve} />}
     <div className={`document-body mode-${mode}`}>
       <div className="editors" hidden={mode === 'preview'}>{[...tabs.current].map(([path, tab]) => <div className="editor-panel" hidden={path !== active} key={path}><Editor tab={tab} changed={() => { scheduleDraft(tab); changed(); }} save={() => void runDocumentCommand('document.save')} /></div>)}</div>
-      {selected && props.session && <Preview appearance={props.appearance} stylesheetVersion={props.stylesheetVersion} inspector={false} key={active} position={selected.previewPosition ??= { x: 0, y: 0, outline: 0 }} editorLine={() => selected.view?.state.doc.lineAt(selected.view.state.selection.main.head).number ?? 1} reveal={() => setMode('split')} session={props.session} relativePath={active} text={selected.text} mode={mode} onAnalysis={value => { selected.analysis = value; selected.analysisText = analyzedText; props.onAnalysis(active, value); }} navigate={entry => { setMode('split'); if (entry.relativePath === active) jump(selected, entry.line); else props.onSource(entry); }} />}
+      {selected && props.session && <Preview appearance={props.appearance} stylesheetVersion={props.stylesheetVersion} inspector={false} inspectorTarget={props.inspectorTarget} key={active} position={selected.previewPosition ??= { x: 0, y: 0, outline: 0 }} editorLine={() => selected.view?.state.doc.lineAt(selected.view.state.selection.main.head).number ?? 1} reveal={() => setMode('split')} session={props.session} relativePath={active} text={selected.text} mode={mode} onAnalysis={value => { selected.analysis = value; selected.analysisText = analyzedText; props.onAnalysis(active, value); }} navigate={entry => { setMode('split'); if (entry.relativePath === active) jump(selected, entry.line); else props.onSource(entry); }} />}
     </div>
   </section>;
 });
diff --git a/apps/desktop/src/renderer/widgets/document-workspace/preview.tsx b/apps/desktop/src/renderer/widgets/document-workspace/preview.tsx
index 68e9bb8..a741e7e 100644
--- a/apps/desktop/src/renderer/widgets/document-workspace/preview.tsx
+++ b/apps/desktop/src/renderer/widgets/document-workspace/preview.tsx
@@ -1,3 +1,4 @@
+import { createPortal } from 'react-dom';
 import React, { useEffect, useLayoutEffect, useMemo, useRef, useState } from 'react';
 import DOMPurify from 'dompurify';
 import { OperationStatus } from '../../shared/ui/operation-status';
@@ -21,7 +22,7 @@ export function safePreview(html: string, appearance: WorkspaceAppearanceV1 = de
   return `<!doctype html><html lang="ko"><head><meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="default-src 'none'; script-src 'none'; style-src 'unsafe-inline'; connect-src 'none'; img-src 'none'; font-src 'none'; media-src 'none'; form-action 'none'; base-uri 'none'"><style data-theme="asciidoctor">${asciidoctorPreviewCss}</style><style data-theme="highlight">${highlightPreviewCss}</style><style data-theme="metis">${metisCss}</style></head><body>${fragment.body.innerHTML}</body></html>`;
 }
 export interface PreviewPosition { text?: string; html?: string; x: number; y: number; outline: number }
-export function Preview({ session, relativePath, text, mode, navigate, onAnalysis, position, editorLine, reveal, appearance, stylesheetVersion, inspector = true }: { session: Session; relativePath: string; text: string; mode: 'source' | 'split' | 'preview'; navigate(entry: OutlineEntry): void; onAnalysis(value: Analysis): void; position: PreviewPosition; editorLine(): number; reveal(): void; appearance: WorkspaceAppearanceV1; stylesheetVersion: number; inspector?: boolean }) {
+export function Preview({ session, relativePath, text, mode, navigate, onAnalysis, position, editorLine, reveal, appearance, stylesheetVersion, inspector = true, inspectorTarget }: { session: Session; relativePath: string; text: string; mode: 'source' | 'split' | 'preview'; navigate(entry: OutlineEntry): void; onAnalysis(value: Analysis): void; position: PreviewPosition; editorLine(): number; reveal(): void; appearance: WorkspaceAppearanceV1; stylesheetVersion: number; inspector?: boolean; inspectorTarget?: HTMLElement | null }) {
   const [analysis, setAnalysis] = useState<Analysis>();
   const [basis, setBasis] = useState<string>();
   const current = !!analysis && basis === text;
@@ -116,8 +117,7 @@ export function Preview({ session, relativePath, text, mode, navigate, onAnalysi
     if (pendingId.current && mode !== 'source' && current && !running) { const id = pendingId.current; pendingId.current = undefined; scrollToId(id); }
   };
   useEffect(() => { const custom = frame.current?.contentDocument?.querySelector<HTMLStyleElement>('style[data-metis-custom]'); if (custom) custom.textContent = customCss; }, [customCss]);
-  return <div className={`analysis analysis-${mode}`}>
-    {inspector && <aside className="outline" ref={outline} onScroll={e => { position.outline = e.currentTarget.scrollTop; }}><h2>목차</h2><OperationStatus task="문서 해석" phase={running ? 'running' : current ? 'complete' : 'failed'} message={status} next={!running && !current ? '원문을 확인하고 미리보기 새로 고침을 누르세요. 원문 편집은 계속할 수 있습니다.' : undefined} /><button disabled={!current || running} onClick={alignEditor}>편집 위치와 맞추기</button><p>절 시작 위치로 맞춥니다. 본문 내부의 세부 위치는 동기화하지 않습니다. 원문이 바뀌면 이전 미리보기 위치를 초기화합니다.</p><button onClick={() => setRetry(value => value + 1)}>미리보기 새로 고침</button>
+  const inspectorContent = <aside className="outline" ref={outline} onScroll={e => { position.outline = e.currentTarget.scrollTop; }}><h2>목차</h2><OperationStatus task="문서 해석" phase={running ? 'running' : current ? 'complete' : 'failed'} message={status} next={!running && !current ? '원문을 확인하고 미리보기 새로 고침을 누르세요. 원문 편집은 계속할 수 있습니다.' : undefined} /><button disabled={!current || running} onClick={alignEditor}>편집 위치와 맞추기</button><p>절 시작 위치로 맞춥니다. 본문 내부의 세부 위치는 동기화하지 않습니다. 원문이 바뀌면 이전 미리보기 위치를 초기화합니다.</p><button onClick={() => setRetry(value => value + 1)}>미리보기 새로 고침</button>
       {analysis?.outline.map((entry, index) => <div key={`${entry.id}-${index}`}><button className="outline-item" style={{ paddingLeft: 8 + Math.min(entry.level, 6) * 8 }} disabled={!current || running} onClick={() => jump(entry)}>{outlineLabels[index]}<small>{entry.relativePath}:{entry.line}</small></button>{entry.relativePath === relativePath && <button disabled={!current || running} onClick={() => navigate(entry)}>원문 위치 열기: {entry.line}</button>}{entry.relativePath !== relativePath && <button disabled={!current || running} onClick={() => navigate(entry)}>포함 원문 열기: {entry.relativePath}</button>}</div>)}
       {analysis?.outline.length === 0 && <p>절이 없습니다.</p>}
       {analysis && <section aria-label="관계 탐색"><h3>참조 · 포함</h3>
@@ -135,7 +135,9 @@ export function Preview({ session, relativePath, text, mode, navigate, onAnalysi
       </details>}
       {!!displayAnalysis?.diagnostics.length && <section aria-label="해석 진단"><h3>진단</h3>{displayAnalysis.diagnostics.map((d, index) => <p key={index}>{d.relativePath}:{d.line} — {d.message}</p>)}</section>}
       <p>이미지·외부 링크는 이 미리보기에서 차단됩니다.</p>
-    </aside>}
+    </aside>;
+  return <div className={`analysis analysis-${mode}`}>
+    {inspectorTarget ? createPortal(inspectorContent, inspectorTarget) : inspector && inspectorContent}
     <div className="preview-surface" hidden={mode === 'source'}><p role="status">{running || !current ? '미리보기 갱신 대기 · 이전 내용일 수 있습니다.' : '현재 편집 기준 · 포함·참조 파일은 해석 시점 저장본'}</p><iframe ref={frame} onLoad={loaded} title="AsciiDoc 미리보기" sandbox="allow-same-origin" srcDoc={srcDoc} /></div>
   </div>;
 }
diff --git a/scripts/integration-support.test.mjs b/scripts/integration-support.test.mjs
index 293f3d0..496a3d7 100644
--- a/scripts/integration-support.test.mjs
+++ b/scripts/integration-support.test.mjs
@@ -1,6 +1,6 @@
 import test from 'node:test';
 import assert from 'node:assert/strict';
-import { mkdtemp, mkdir, writeFile, readFile, rm } from 'node:fs/promises';
+import { mkdtemp, mkdir, writeFile, readFile, realpath, rm } from 'node:fs/promises';
 import path from 'node:path';
 import os from 'node:os';
 import { packageRelativePath, latestExecutable, runLogged } from './integration-support.mjs';
@@ -30,7 +30,7 @@ test('all native layouts resolve with spaces and a newline in the marker', async
   for (const platform of ['win32', 'darwin', 'linux']) for (const arch of ['x64', 'arm64']) {
     const executable = path.join(stage, packageRelativePath(platform, arch));
     await mkdir(path.dirname(executable), { recursive: true }); await writeFile(executable, 'fixture');
-    assert.equal(await latestExecutable(root, platform, arch), executable);
+    assert.equal(await latestExecutable(root, platform, arch), await realpath(executable));
   }
 });
 test('stale package and out-of-staging marker fail closed', async t => {
diff --git a/scripts/m1-02-smoke.mjs b/scripts/m1-02-smoke.mjs
index 2421780..37276cc 100644
--- a/scripts/m1-02-smoke.mjs
+++ b/scripts/m1-02-smoke.mjs
@@ -26,10 +26,10 @@ try {
   await page.getByRole('button', { name: '≡note.adoc', exact: true }).click();
   const editor = () => page.locator('.editor-panel:not([hidden]) .cm-content');
   await editor().click(); await page.keyboard.press('ControlOrMeta+a'); await page.keyboard.insertText('= 편집\n본문  ');
-  await page.getByRole('tab', { name: 'note.adoc ●', exact: true }).waitFor();
+  await page.getByRole('tab', { name: '● note.adoc', exact: true }).waitFor();
   await page.getByRole('button', { name: '≡other.adoc', exact: true }).click();
   await page.getByRole('heading', { name: 'other.adoc', exact: true }).waitFor();
-  await page.getByRole('tab', { name: 'note.adoc ●', exact: true }).click();
+  await page.getByRole('tab', { name: '● note.adoc', exact: true }).click();
   assert.equal(await editor().innerText(), '= 편집\n본문  ');
   await page.getByRole('button', { name: '실행 취소', exact: true }).click();
   assert.match(await editor().innerText(), /Original/);
@@ -49,14 +49,14 @@ try {
   assert.match(await editor().innerText(), /new edit/);
   assert.equal(await readFile(path.join(fixture, 'note.adoc'), 'utf8'), '= External\n'); checks.push('external conflict retains source and editor');
   await page.getByRole('button', { name: 'note.adoc 탭 닫기', exact: true }).click();
-  await page.getByRole('tab', { name: 'note.adoc ●', exact: true }).waitFor();
+  await page.getByRole('tab', { name: '● note.adoc', exact: true }).waitFor();
   await uiCommand(page, '폴더 닫기');
-  await page.getByRole('tab', { name: 'note.adoc ●', exact: true }).waitFor();
+  await page.getByRole('tab', { name: '● note.adoc', exact: true }).waitFor();
   await app.evaluate(({ BrowserWindow }) => BrowserWindow.getAllWindows()[0].close());
-  await page.getByRole('tab', { name: 'note.adoc ●', exact: true }).waitFor(); checks.push('cancel dirty tab, workspace and window close');
+  await page.getByRole('tab', { name: '● note.adoc', exact: true }).waitFor(); checks.push('cancel dirty tab, workspace and window close');
   await app.evaluate(({ dialog }) => { dialog.showMessageBoxSync = () => 1; });
   await page.getByRole('button', { name: 'note.adoc 탭 닫기', exact: true }).click();
-  await page.getByRole('tab', { name: 'note.adoc ●', exact: true }).waitFor({ state: 'detached' }); checks.push('explicit discard closes tab');
+  await page.getByRole('tab', { name: '● note.adoc', exact: true }).waitFor({ state: 'detached' }); checks.push('explicit discard closes tab');
   await page.getByRole('button', { name: '새 문서', exact: true }).click();
   await page.getByLabel('문서 이름 (.adoc)').fill('new.adoc');
   await page.getByRole('button', { name: '만들기', exact: true }).click();
diff --git a/scripts/m1-03-smoke.mjs b/scripts/m1-03-smoke.mjs
index d5f6b65..b8f5e1b 100644
--- a/scripts/m1-03-smoke.mjs
+++ b/scripts/m1-03-smoke.mjs
@@ -20,6 +20,7 @@ try {
   await app.evaluate(({ dialog }, fixture) => { dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); dialog.showMessageBoxSync = () => 1; }, fixture);
   await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click();
   await page.getByRole('button', { name: '≡note.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '오른쪽 사이드바', exact: true }).click();
   await page.locator('.outline-item').filter({ hasText: 'Included section' }).waitFor(); checks.push('parser outline with include source');
   assert.ok(await page.locator('.cm-content .cm-line span').count()); checks.push('syntax highlighting');
   await page.getByRole('button', { name: '분할', exact: true }).click();
diff --git a/scripts/m1-04-smoke.mjs b/scripts/m1-04-smoke.mjs
index f652703..01a4801 100644
--- a/scripts/m1-04-smoke.mjs
+++ b/scripts/m1-04-smoke.mjs
@@ -18,6 +18,7 @@ try {
   await app.evaluate(({ dialog }, fixture) => { dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); dialog.showMessageBoxSync = () => 1; }, fixture);
   await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click();
   await page.getByRole('button', { name: '≡note.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '오른쪽 사이드바', exact: true }).click();
   const relations = page.getByRole('region', { name: '관계 탐색' });
   await relations.getByText('참조 · missing · 대상 없음', { exact: true }).waitFor();
   assert.equal(await relations.getByText(/ghost/).count(), 0); checks.push('missing local reference and inactive exclusion');
diff --git a/scripts/m1-05-smoke.mjs b/scripts/m1-05-smoke.mjs
index 0e45b88..965e465 100644
--- a/scripts/m1-05-smoke.mjs
+++ b/scripts/m1-05-smoke.mjs
@@ -16,17 +16,17 @@ try {
   const page = await app.firstWindow(); page.on('dialog', dialog => { void dialog.dismiss().catch(() => {}); });
   await app.evaluate(({ dialog }, fixture) => { dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); dialog.showMessageBoxSync = () => 1; }, fixture);
   await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click();
-  await page.waitForFunction(() => [...document.querySelectorAll('button')].some(button => button.textContent === '빠른 열기' && !button.disabled));
+  await page.getByRole('button', { name: '새 문서', exact: true }).waitFor();
   await page.keyboard.press('ControlOrMeta+p');
-  const modal = page.locator('dialog'), query = modal.getByRole('searchbox', { name: '검색어' });
+  let modal = page.getByRole('dialog', { name: '빠른 열기' }), query = modal.getByRole('searchbox', { name: '검색어' });
   await query.fill('docs/');
   await modal.getByRole('button', { name: /파일 · other.adoc/ }).click();
   await page.getByRole('heading', { name: 'docs/other.adoc', exact: true }).waitFor(); checks.push('keyboard quick open filters nested file paths');
-  await page.keyboard.press('ControlOrMeta+Shift+f'); await query.fill('Needle body');
+  await page.keyboard.press('ControlOrMeta+Shift+f'); modal = page.getByRole('region', { name: '작업 공간 검색' }); query = modal.getByRole('searchbox', { name: '검색어' }); await query.fill('Needle body');
   await modal.getByRole('button', { name: /본문 · note.adoc/ }).filter({ hasText: 'note.adoc:7' }).click();
   await page.getByRole('heading', { name: 'note.adoc', exact: true }).waitFor();
   await page.waitForFunction(() => window.getSelection()?.anchorNode?.textContent?.includes('Needle body')); checks.push('body snippet opens matching source line');
-  await page.getByRole('button', { name: '검색', exact: true }).click();
+  await page.keyboard.press('ControlOrMeta+Shift+f');
   await modal.getByLabel('검색 모드').selectOption('symbols'); await query.fill('topic');
   await modal.getByRole('button', { name: /속성 · topic/ }).filter({ hasText: 'note.adoc:2' }).waitFor();
   await query.fill('Needle'); await modal.getByRole('button', { name: /절 · Needle section/ }).waitFor();
@@ -41,11 +41,11 @@ try {
   assert.ok((await editor.textContent()).includes('External saved content')); checks.push('changed source reloads clean tab without stale line jump');
   await editor.click(); await page.keyboard.press('ControlOrMeta+a'); await page.keyboard.insertText('= Unsaved buffer\n\nKeep my changes');
   await writeFile(path.join(fixture, 'note.adoc'), source);
-  await page.getByRole('button', { name: '검색', exact: true }).click(); await query.fill('Needle body');
+  await page.keyboard.press('ControlOrMeta+Shift+f'); await query.fill('Needle body');
   await modal.getByRole('button', { name: /본문 · note.adoc/ }).click();
   await page.locator('footer').filter({ hasText: '미저장 편집을 유지' }).waitFor();
   assert.ok((await editor.textContent()).includes('Keep my changes')); checks.push('saved-file result preserves dirty tab and warns about location');
-  await page.getByRole('button', { name: '검색', exact: true }).click(); await query.fill('Needle');
+  await page.keyboard.press('ControlOrMeta+Shift+f'); await query.fill('Needle');
   await modal.getByRole('button', { name: '검색 취소', exact: true }).dispatchEvent('click');
   await modal.getByRole('status').filter({ hasText: '검색을 취소했습니다' }).waitFor();
   await modal.getByRole('button', { name: '다시 검색', exact: true }).click();
diff --git a/scripts/m1-06-smoke.mjs b/scripts/m1-06-smoke.mjs
index 19976bb..4f9e5ce 100644
--- a/scripts/m1-06-smoke.mjs
+++ b/scripts/m1-06-smoke.mjs
@@ -19,7 +19,7 @@ try {
   checks.push('automatic polling reloads clean external change');
   await editor.click(); await page.keyboard.press('ControlOrMeta+a'); await page.keyboard.insertText('= Local\n\nKeep local');
   await writeFile(file, '= External two\n\nOther edit');
-  await page.getByRole('button', { name: '외부 변경 확인', exact: true }).click(); await page.getByRole('button', { name: '변경 비교', exact: true }).click();
+  await uiCommand(page, '외부 변경 확인'); await page.getByRole('button', { name: '변경 비교', exact: true }).click();
   const comparison = page.getByRole('dialog', { name: '충돌 비교', exact: true });
   assert.ok((await comparison.getByLabel('편집 기준').inputValue()).includes('Fresh disk'));
   assert.ok((await comparison.getByLabel('해결안').inputValue()).includes('Keep local'));
@@ -28,19 +28,19 @@ try {
   await comparison.getByRole('alert').filter({ hasText: '외부에서 문서가 변경' }).waitFor();
   assert.ok((await readFile(file, 'utf8')).includes('Changed during review')); checks.push('three-way comparison and repeated external change reject stale resolution');
   await comparison.getByRole('button', { name: '취소', exact: true }).click(); assert.ok((await editor.textContent()).includes('Keep local'));
-  await page.getByRole('button', { name: '외부 변경 확인', exact: true }).click();
+  await uiCommand(page, '외부 변경 확인');
   await page.getByRole('button', { name: '변경 비교', exact: true }).click();
   await comparison.getByLabel('해결안').fill('= Resolved\n\nResolved text'); await comparison.getByRole('button', { name: '해결안 저장', exact: true }).click();
   await comparison.waitFor({ state: 'hidden' }); assert.equal(await readFile(file, 'utf8'), '= Resolved\n\nResolved text'); checks.push('cancel preserves buffer and reviewed merge saves');
   await editor.click(); await page.keyboard.press('ControlOrMeta+a'); await page.keyboard.insertText('= Local discard\n\nRecover me');
-  await writeFile(file, '= Chosen disk\n\nDisk wins'); await page.getByRole('button', { name: '외부 변경 확인', exact: true }).click(); await page.getByRole('button', { name: '변경 비교', exact: true }).click();
+  await writeFile(file, '= Chosen disk\n\nDisk wins'); await uiCommand(page, '외부 변경 확인'); await page.getByRole('button', { name: '변경 비교', exact: true }).click();
   await comparison.getByRole('button', { name: '편집 보존 후 디스크 사용', exact: true }).click(); await comparison.waitFor({ state: 'hidden' });
   assert.ok((await editor.textContent()).includes('Disk wins')); checks.push('disk adoption preserves replaced edit as recovery draft');
-  await unlink(file); await page.getByRole('button', { name: '외부 변경 확인', exact: true }).click();
+  await unlink(file); await uiCommand(page, '외부 변경 확인');
   await page.locator('.external-change').filter({ hasText: '삭제되거나 이동' }).waitFor(); assert.ok((await editor.textContent()).includes('Disk wins'));
   await page.getByLabel('사본 파일 이름').fill('copy.adoc'); await page.getByRole('button', { name: '다른 이름으로 저장', exact: true }).click();
   await page.locator('footer').filter({ hasText: '사본을 저장' }).waitFor(); assert.equal(await readFile(path.join(fixture, 'copy.adoc'), 'utf8'), '= Chosen disk\n\nDisk wins'); checks.push('deleted source stays in buffer and copies to a new file');
-  await page.getByRole('button', { name: '편집 보존', exact: true }).click(); await page.locator('footer').filter({ hasText: '복구 사본으로 보존' }).waitFor();
+  await uiCommand(page, '편집 보존'); await page.locator('footer').filter({ hasText: '복구 사본으로 보존' }).waitFor();
   await uiCommand(page, '복구 사본'); const recovery = page.getByRole('dialog', { name: '복구 사본', exact: true });
   await recovery.getByRole('button', { name: '편집 사본', exact: true }).first().click();
   assert.ok((await recovery.getByLabel('복구 내용').inputValue()).includes('Disk wins'));
diff --git a/scripts/m1-08-smoke.mjs b/scripts/m1-08-smoke.mjs
index 6ebca8a..ed6b371 100644
--- a/scripts/m1-08-smoke.mjs
+++ b/scripts/m1-08-smoke.mjs
@@ -25,7 +25,7 @@ try {
   const create = page.getByRole('dialog', { name: '새 문서', exact: true }); await create.waitFor();
   for (let i = 0; i < 8; i++) { await page.keyboard.press('Tab'); assert.equal(await page.evaluate(() => !!document.activeElement?.closest('dialog[open]')), true); }
   await page.keyboard.press('Escape'); await create.waitFor({ state: 'detached' });
-  assert.equal(await page.evaluate(() => document.activeElement?.textContent), '새 문서');
+  assert.equal(await page.evaluate(() => document.activeElement?.getAttribute('aria-label')), '새 문서');
   checks.push('create dialog traps focus and Escape restores invoker');
   await page.getByRole('button', { name: '검색', exact: true }).click();
   const query = page.getByRole('searchbox', { name: '검색어' }); await query.fill('needle');
@@ -33,7 +33,7 @@ try {
   assert.equal(await page.locator('.search-result').nth(1).evaluate(node => node === document.activeElement), true);
   await page.keyboard.press('Home'); await page.keyboard.press('ArrowUp'); assert.equal(await query.evaluate(node => node === document.activeElement), true);
   await page.keyboard.press('ArrowDown'); await page.keyboard.press('Escape');
-  await page.locator('dialog.search-dialog').waitFor({ state: 'detached' }); checks.push('search keyboard navigation returns from first result to query');
+  await page.locator('.search-panel').waitFor({ state: 'detached' }); checks.push('search keyboard navigation returns from first result to query');
   const cancelled = await page.evaluate(async () => {
     const api = window.metis, opened = await api.openWorkspace({ requestId: 'open-test' }); if (!opened.ok) throw Error(opened.error.message);
     const scope = { requestId: 'review-test', workspaceId: opened.value.workspaceId, workspaceEpoch: opened.value.workspaceEpoch };
@@ -48,6 +48,7 @@ try {
   for (let i = 0; i < 205; i++) await writeFile(path.join(fixture, `fixture-${i}.adoc`), '= Fixture\n\nneedle');
   await writeFile(path.join(fixture, 'large.adoc'), ('가'.repeat(100) + '\n').repeat(4000));
   await uiCommand(page, '폴더 열기');
+  await page.getByRole('button', { name: '파일', exact: true }).click();
   await page.getByRole('button', { name: 'a.adoc 파일 변경', exact: true }).click();
   const reviewDialog = page.getByRole('dialog', { name: '파일 변경 검토' });
   await reviewDialog.getByLabel('새 상대 경로').fill('renamed.adoc');
diff --git a/scripts/m2-05-smoke.mjs b/scripts/m2-05-smoke.mjs
index 785f0ae..b6572be 100644
--- a/scripts/m2-05-smoke.mjs
+++ b/scripts/m2-05-smoke.mjs
@@ -15,7 +15,8 @@ try {
   await uiCommand(page, '확장 관리'); const manager = page.getByRole('dialog', { name: '확장 관리' });
   await manager.getByRole('status').filter({ hasText: '비활성' }).waitFor(); await manager.getByRole('button', { name: '활성화', exact: true }).click(); await manager.getByRole('status').filter({ hasText: /^활성$/ }).waitFor(); await manager.getByRole('button', { name: '닫기', exact: true }).click();
   await page.reload(); await uiCommand(page, '확장 관리'); await manager.getByRole('button', { name: '비활성화', exact: true }).waitFor(); await manager.getByRole('button', { name: '닫기', exact: true }).click(); checks.push('bundled extension defaults disabled; enabling survives renderer restart');
-  await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click(); await page.getByRole('button', { name: '≡a.adoc', exact: true }).click(); await page.locator('.outline-item').filter({ hasText: 'First' }).waitFor();
+  await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click(); await page.getByRole('button', { name: '≡a.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '오른쪽 사이드바', exact: true }).click(); await page.locator('.outline-item').filter({ hasText: 'First' }).waitFor();
   const editor = page.locator('.editor-panel:not([hidden]) .cm-content'); await editor.click(); await page.keyboard.press('ControlOrMeta+End'); await page.keyboard.insertText('\n\n== Unsaved section'); await page.locator('.outline-item').filter({ hasText: 'Unsaved section' }).waitFor();
   const palette = page.getByRole('dialog', { name: '명령 팔레트' });
   await page.keyboard.press('ControlOrMeta+Shift+P'); await palette.getByRole('combobox').fill('확장: 문서 개요'); await palette.getByRole('combobox').press('Enter');
diff --git a/scripts/m2-06-smoke.mjs b/scripts/m2-06-smoke.mjs
index caa1037..72f8ab6 100644
--- a/scripts/m2-06-smoke.mjs
+++ b/scripts/m2-06-smoke.mjs
@@ -1,3 +1,4 @@
+import { uiCommand } from './ui-command.mjs';
 import { electron } from './test-electron.mjs';
 import executablePath from 'electron';
 import { mkdir, writeFile, readFile } from 'node:fs/promises';
@@ -20,15 +21,15 @@ try {
   await app.evaluate(({ dialog }) => { dialog.showMessageBoxSync = () => 0; }); await launch(['--workspace', other, '--file', 'other.adoc']); await page.locator('footer').filter({ hasText: 'CLI 열기를 취소했습니다' }).waitFor(); assert.ok((await editor.textContent()).includes('Unsaved')); checks.push('CLI workspace switch honors discard cancellation');
   await launch(['--workspace', fixture, '--file', '../other/other.adoc']); await page.getByRole('alert').filter({ hasText: '요청 형식' }).waitFor(); assert.equal(await readFile(target, 'utf8'), '= A\n\nCLI target line\n\nBody'); checks.push('invalid CLI traversal is rejected without replacing document');
   await app.evaluate(({ dialog }) => { dialog.showMessageBoxSync = () => 1; });
-  await page.getByRole('button', { name: '외부 편집기로 열기', exact: true }).click(); await page.getByRole('alert').filter({ hasText: '외부 편집기 설정' }).waitFor(); assert.ok((await editor.textContent()).includes('Unsaved')); checks.push('missing external editor configuration preserves current edit');
+  await uiCommand(page, '외부 편집기로 열기'); await page.getByRole('alert').filter({ hasText: '외부 편집기 설정' }).waitFor(); assert.ok((await editor.textContent()).includes('Unsaved')); checks.push('missing external editor configuration preserves current edit');
   // Stub process spawning at the host boundary; real literal-argument launch is covered by the unit test.
   await app.evaluate(({ dialog }, executable) => { dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [executable] }); globalThis.externalCalls = []; const cp = process.getBuiltinModule('child_process'); const { EventEmitter } = process.getBuiltinModule('events'); cp.spawn = (file, args, options) => { globalThis.externalCalls.push({ file, args, shell: options.shell }); const child = new EventEmitter(); child.unref = () => {}; process.nextTick(() => child.emit('spawn')); return child; }; }, process.execPath);
   await page.getByRole('button', { name: '명령 팔레트', exact: true }).click(); const palette = page.getByRole('dialog', { name: '명령 팔레트' }); await palette.getByRole('combobox').fill('외부 편집기 설정'); await palette.getByRole('combobox').press('Enter'); await page.locator('footer').filter({ hasText: '외부 편집기:' }).waitFor();
-  await page.getByRole('button', { name: '외부 편집기로 열기', exact: true }).click(); await page.locator('footer').filter({ hasText: '저장본 열기를 요청했습니다' }).waitFor(); assert.ok((await editor.textContent()).includes('Unsaved')); assert.ok(!(await readFile(target, 'utf8')).includes('Unsaved'));
+  await uiCommand(page, '외부 편집기로 열기'); await page.locator('footer').filter({ hasText: '저장본 열기를 요청했습니다' }).waitFor(); assert.ok((await editor.textContent()).includes('Unsaved')); assert.ok(!(await readFile(target, 'utf8')).includes('Unsaved'));
   const calls = await app.evaluate(() => globalThis.externalCalls); assert.equal(calls.length, 1); assert.deepEqual(calls[0].args, [target]); assert.equal(calls[0].shell, false); checks.push('disk-only external opening passes one guarded file argument and leaves dirty buffer unsaved');
-  await app.evaluate(({ dialog }) => { dialog.showMessageBoxSync = () => 0; }); await page.getByRole('button', { name: '외부 편집기로 열기', exact: true }).click(); await page.waitForFunction(() => document.querySelector('.document-title')?.textContent?.includes('저장됨')); assert.ok((await readFile(target, 'utf8')).includes('Unsaved')); assert.equal(await app.evaluate(async () => { for (let i = 0; i < 100 && globalThis.externalCalls.length < 2; i++) await new Promise(resolve => setTimeout(resolve, 20)); return globalThis.externalCalls.length; }), 2); checks.push('save-then-open uses the normal guarded save');
-  await editor.click(); await page.keyboard.press('ControlOrMeta+End'); await page.keyboard.insertText('\nLocal conflict'); await writeFile(target, '= External changed'); await page.getByRole('button', { name: '외부 변경 확인', exact: true }).click(); await page.locator('.external-change').filter({ hasText: '충돌' }).waitFor();
-  await page.getByRole('button', { name: '외부 편집기로 열기', exact: true }).click(); await page.getByRole('alert').filter({ hasText: '외부에서 문서가 변경' }).waitFor(); assert.equal((await app.evaluate(() => globalThis.externalCalls)).length, 2); assert.ok((await editor.textContent()).includes('Local conflict')); assert.equal(await readFile(target, 'utf8'), '= External changed'); checks.push('external conflict blocks save-then-open and preserves both versions');
+  await app.evaluate(({ dialog }) => { dialog.showMessageBoxSync = () => 0; }); await uiCommand(page, '외부 편집기로 열기'); await page.waitForFunction(() => document.querySelector('.document-title')?.textContent?.includes('저장됨')); assert.ok((await readFile(target, 'utf8')).includes('Unsaved')); assert.equal(await app.evaluate(async () => { for (let i = 0; i < 100 && globalThis.externalCalls.length < 2; i++) await new Promise(resolve => setTimeout(resolve, 20)); return globalThis.externalCalls.length; }), 2); checks.push('save-then-open uses the normal guarded save');
+  await editor.click(); await page.keyboard.press('ControlOrMeta+End'); await page.keyboard.insertText('\nLocal conflict'); await writeFile(target, '= External changed'); await uiCommand(page, '외부 변경 확인'); await page.locator('.external-change').filter({ hasText: '충돌' }).waitFor();
+  await uiCommand(page, '외부 편집기로 열기'); await page.getByRole('alert').filter({ hasText: '외부에서 문서가 변경' }).waitFor(); assert.equal((await app.evaluate(() => globalThis.externalCalls)).length, 2); assert.ok((await editor.textContent()).includes('Local conflict')); assert.equal(await readFile(target, 'utf8'), '= External changed'); checks.push('external conflict blocks save-then-open and preserves both versions');
   await page.screenshot({ path: path.join(run, 'external-conflict.png') }); await writeFile(path.join(run, 'results.json'), JSON.stringify({ packaged: !!packaged, checks }, null, 2)); console.log(JSON.stringify({ run, checks }, null, 2));
 } catch (error) { console.error('Completed:', checks); console.error(await app.evaluate(() => ({ argv: process.argv, defaultApp: process.defaultApp }))); console.error(await (await app.firstWindow()).locator('body').innerText()); throw error; }
 finally { await app.evaluate(({ dialog }) => { dialog.showMessageBoxSync = () => 1; }).catch(() => {}); await app.close(); }
diff --git a/scripts/m2-07-smoke.mjs b/scripts/m2-07-smoke.mjs
index 68ec399..7037f25 100644
--- a/scripts/m2-07-smoke.mjs
+++ b/scripts/m2-07-smoke.mjs
@@ -29,6 +29,7 @@ try {
   async function command(label) { await page.keyboard.press('ControlOrMeta+Shift+P'); await palette.getByRole('combobox').fill(label); await palette.getByRole('combobox').press('Enter'); }
   await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click();
   await page.getByRole('button', { name: '≡a.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '오른쪽 사이드바', exact: true }).click();
   await uiCommand(page, '확장 관리');
   const manager = page.getByRole('dialog', { name: '확장 관리' });
   await manager.getByRole('button', { name: '활성화', exact: true }).click(); await manager.getByRole('button', { name: '닫기', exact: true }).click();
diff --git a/scripts/m3-01-smoke.mjs b/scripts/m3-01-smoke.mjs
index 5ff2a76..897c014 100644
--- a/scripts/m3-01-smoke.mjs
+++ b/scripts/m3-01-smoke.mjs
@@ -45,7 +45,7 @@ try {
   checks.push('scope change invalidates previous bundle and explicit rebuild restores it');
   await result.getByRole('button', { name: '출처: shared.adoc:2', exact: true }).first().click(); await modal.waitFor({ state: 'hidden' });
   await page.getByRole('heading', { name: 'shared.adoc', exact: true }).waitFor();
-  await page.getByRole('tab', { name: 'a.adoc ●', exact: true }).click(); assert.ok((await editor.textContent()).includes('UNSAVED ONLY'));
+  await page.getByRole('tab', { name: '● a.adoc', exact: true }).click(); assert.ok((await editor.textContent()).includes('UNSAVED ONLY'));
   checks.push('context evidence opens original include line and retains unsaved parent tab');
   await uiCommand(page, '문서 맥락 검토'); await build();
   await unlink(path.join(fixture, 'a.adoc'));
diff --git a/scripts/m4-01-baseline.mjs b/scripts/m4-01-baseline.mjs
index c3b2868..3e8fff7 100644
--- a/scripts/m4-01-baseline.mjs
+++ b/scripts/m4-01-baseline.mjs
@@ -15,6 +15,7 @@ try {
   const page = await app.firstWindow(); page.setDefaultTimeout(15000);
   await app.evaluate(({ BrowserWindow, dialog }, fixture) => { BrowserWindow.getAllWindows()[0].showInactive(); dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); }, fixture);
   await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click(); await page.getByRole('button', { name: '≡guide.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '오른쪽 사이드바', exact: true }).click();
   await page.locator('.outline-item').filter({ hasText: 'Reused section' }).waitFor();
   for (const [width, height, zoom] of [[1180, 800, 1], [800, 600, 1], [1180, 800, 2]]) {
     await app.evaluate(({ BrowserWindow }, size) => { const win = BrowserWindow.getAllWindows()[0]; win.setContentSize(size[0], size[1]); win.webContents.setZoomFactor(size[2]); }, [width, height, zoom]);
diff --git a/scripts/m4-02-smoke.mjs b/scripts/m4-02-smoke.mjs
index f5be928..52383ec 100644
--- a/scripts/m4-02-smoke.mjs
+++ b/scripts/m4-02-smoke.mjs
@@ -17,37 +17,38 @@ async function launch() {
 try {
   await launch(); const editor = page.locator('.editor-panel:not([hidden]) .cm-content');
   await editor.click(); await page.keyboard.press('ControlOrMeta+End'); await page.keyboard.insertText('\nUNSAVED');
-  await page.getByText('도구·보기', { exact: true }).click(); await page.getByRole('button', { name: '문서 집합 검증', exact: true }).click();
+  await page.getByLabel('도구 메뉴', { exact: true }).click(); await page.getByRole('button', { name: '문서 집합 검증', exact: true }).click();
   await page.getByRole('dialog', { name: '문서 집합 검증' }).getByRole('button', { name: '닫기', exact: true }).click();
   assert.equal(await page.locator('.layout-menu').getAttribute('open'), null);
-  await page.getByRole('button', { name: '파일 패널', exact: true }).click(); assert.equal(await page.locator('.body>aside').isVisible(), false);
-  await page.getByRole('button', { name: '파일 패널', exact: true }).click();
-  await page.getByText('도구·보기', { exact: true }).click(); const width = page.getByRole('slider', { name: /파일 패널 너비/ }); await width.focus(); await width.press('End');
-  await page.keyboard.press('Escape'); assert.equal(Math.round((await page.locator('.body>aside').boundingBox()).width), 360);
+  await page.getByRole('button', { name: '파일', exact: true }).click(); assert.equal(await page.locator('.left-sidebar').isVisible(), false);
+  await page.getByRole('button', { name: '파일', exact: true }).click();
+  await uiCommand(page, '보기 설정'); const width = page.getByRole('group', { name: '좌측 사이드바' }).getByRole('slider'); await width.focus(); await width.press('End');
+  await page.keyboard.press('Escape'); assert.equal(Math.round((await page.locator('.left-sidebar').boundingBox()).width), 420);
   assert.ok((await editor.textContent()).includes('UNSAVED')); assert.equal(await readFile(path.join(fixture, 'a.adoc'), 'utf8'), original);
   checks.push('grouped commands, keyboard panel sizing and collapse preserve dirty document and disk');
   await app.evaluate(({ BrowserWindow }) => BrowserWindow.getAllWindows()[0].setContentSize(800, 600));
-  await page.waitForFunction(() => !document.querySelector('.body>aside').checkVisibility());
+  await page.waitForFunction(() => document.querySelector('.left-sidebar').hasAttribute('inert'));
   const source = page.locator('.editor-panel:not([hidden]) .source'); assert.ok((await source.boundingBox()).height >= 240);
-  await page.getByRole('button', { name: '파일 패널', exact: true }).click(); await page.locator('.body>aside').waitFor({ state: 'visible' });
-  await page.keyboard.press('Escape'); assert.equal(await page.getByRole('button', { name: '파일 패널', exact: true }).evaluate(e => e === document.activeElement), true);
-  await page.getByRole('button', { name: '목차 패널', exact: true }).click(); await page.locator('.outline').waitFor({ state: 'visible' }); await page.keyboard.press('Escape');
+  await page.getByRole('button', { name: '파일', exact: true }).click(); await page.locator('.left-sidebar').waitFor({ state: 'visible' });
+  await page.keyboard.press('Escape'); assert.equal(await page.getByRole('button', { name: '파일', exact: true }).evaluate(e => e === document.activeElement), true);
+  await page.getByRole('button', { name: '오른쪽 사이드바', exact: true }).click(); await page.locator('.outline').waitFor({ state: 'visible' }); await page.keyboard.press('Escape');
   await app.evaluate(({ BrowserWindow }) => { const w = BrowserWindow.getAllWindows()[0]; w.setContentSize(1180, 800); w.webContents.setZoomFactor(2); });
   await page.waitForFunction(() => innerWidth === 590); assert.ok((await source.boundingBox()).height >= 120);
   await page.screenshot({ path: path.join(run, 'zoom.png') });
   await app.evaluate(({ BrowserWindow }) => BrowserWindow.getAllWindows()[0].webContents.setZoomFactor(1));
-  await page.waitForFunction(() => document.querySelector('.body>aside').getBoundingClientRect().width === 360);
+  await page.waitForFunction(() => document.querySelector('.left-sidebar').getBoundingClientRect().width === 420);
   checks.push('narrow and 200% layouts retain editor space; temporary panels restore focus without changing wide settings');
-  await page.getByRole('button', { name: '목차 패널', exact: true }).click();
+  await page.getByRole('button', { name: '오른쪽 사이드바', exact: true }).click();
+  await page.getByRole('button', { name: '오른쪽 사이드바', exact: true }).click();
   await app.close(); app = undefined; await launch();
-  assert.equal(Math.round((await page.locator('.body>aside').boundingBox()).width), 360); assert.equal(await page.locator('.outline').isVisible(), false);
+  assert.equal(Math.round((await page.locator('.left-sidebar').boundingBox()).width), 420); assert.equal(await page.locator('.outline').isVisible(), false);
   checks.push('workspace widths and collapsed state survive process restart');
   const other = path.join(run, 'other'); await mkdir(other); await app.evaluate(({ dialog }, other) => { dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [other] }); }, other);
-  await uiCommand(page, '폴더 열기'); await page.locator('.body>aside h2').filter({ hasText: /^other$/ }).waitFor(); assert.equal(Math.round((await page.locator('.body>aside').boundingBox()).width), 240);
-  await app.evaluate(({ dialog }, fixture) => { dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); }, fixture); await uiCommand(page, '폴더 열기'); await page.locator('.body>aside h2').filter({ hasText: /^workspace$/ }).waitFor();
-  assert.equal(Math.round((await page.locator('.body>aside').boundingBox()).width), 360);
-  await page.getByText('도구·보기', { exact: true }).click(); await page.getByRole('button', { name: '보기 기본값 복원' }).click(); await page.keyboard.press('Escape');
-  assert.equal(Math.round((await page.locator('.body>aside').boundingBox()).width), 240); assert.equal(await readFile(path.join(fixture, 'a.adoc'), 'utf8'), original);
+  await uiCommand(page, '폴더 열기'); await page.locator('.left-sidebar h2').filter({ hasText: /^other$/ }).waitFor(); assert.equal(Math.round((await page.locator('.left-sidebar').boundingBox()).width), 240);
+  await app.evaluate(({ dialog }, fixture) => { dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); }, fixture); await uiCommand(page, '폴더 열기'); await page.locator('.left-sidebar h2').filter({ hasText: /^workspace$/ }).waitFor();
+  assert.equal(Math.round((await page.locator('.left-sidebar').boundingBox()).width), 420);
+  await uiCommand(page, '보기 설정'); await page.getByRole('button', { name: '보기 기본값 복원' }).click(); await page.keyboard.press('Escape');
+  assert.equal(Math.round((await page.locator('.left-sidebar').boundingBox()).width), 240); assert.equal(await readFile(path.join(fixture, 'a.adoc'), 'utf8'), original);
   checks.push('distinct workspaces have independent preferences; reset restores defaults without writing source');
   await writeFile(path.join(run, 'results.json'), JSON.stringify({ packaged: !!packaged, checks }, null, 2)); console.log(JSON.stringify({ run, checks }, null, 2));
 } catch (e) { console.error('Completed:', checks); if (page) console.error(await page.locator('body').innerText().catch(() => '')); throw e; }
diff --git a/scripts/m4-03-smoke.mjs b/scripts/m4-03-smoke.mjs
index 32a3aa7..9ab49c5 100644
--- a/scripts/m4-03-smoke.mjs
+++ b/scripts/m4-03-smoke.mjs
@@ -20,7 +20,7 @@ try {
   await hint.getByRole('button', { name: '안내 건너뛰기' }).click(); await hint.waitFor({ state: 'hidden' }); await page.reload(); await hint.waitFor({ state: 'hidden' });
   await uiCommand(page, '시작 안내'); await guide.getByRole('button', { name: '시작 화면 안내 다시 표시' }).click(); await hint.waitFor();
   checks.push('guide and read-only sample create no files; Escape restores focus; skip persists and palette can restore hints');
-  await page.getByRole('button', { name: '폴더 열기', exact: true }).click();
+  await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click();
   await page.getByRole('button', { name: '이 폴더에 문서 만들기' }).click();
   const create = page.getByRole('dialog', { name: '새 문서' }); await create.getByLabel('문서 이름 (.adoc)').fill('first.adoc'); await create.getByRole('button', { name: '만들기', exact: true }).click();
   const editor = page.locator('.editor-panel:not([hidden]) .cm-content'); await editor.click(); const text = '= First note\n\nMy first saved document.'; await page.keyboard.insertText(text);
diff --git a/scripts/m4-04-smoke.mjs b/scripts/m4-04-smoke.mjs
index f7dfd74..aac63bd 100644
--- a/scripts/m4-04-smoke.mjs
+++ b/scripts/m4-04-smoke.mjs
@@ -14,7 +14,8 @@ const app = await electron.launch({ executablePath: packaged || executablePath,
 try {
   page = await app.firstWindow(); page.setDefaultTimeout(15000); page.on('dialog', d => { void d.dismiss().catch(() => {}); });
   await app.evaluate(({ BrowserWindow, dialog }, fixture) => { BrowserWindow.getAllWindows()[0].showInactive(); dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); dialog.showMessageBoxSync = () => 1; }, fixture);
-  await page.getByRole('button', { name: '폴더 열기', exact: true }).click(); await page.getByRole('button', { name: '≡long.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click(); await page.getByRole('button', { name: '≡long.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '오른쪽 사이드바', exact: true }).click();
   const frame = page.locator('iframe[title="AsciiDoc 미리보기"]');
   const ready = () => page.getByRole('button', { name: '편집 위치와 맞추기', exact: true }).waitFor({ state: 'visible' });
   await ready(); await page.locator('.outline-item').filter({ hasText: /^Section 20/ }).click();
diff --git a/scripts/m4-05-smoke.mjs b/scripts/m4-05-smoke.mjs
index b546561..f344a66 100644
--- a/scripts/m4-05-smoke.mjs
+++ b/scripts/m4-05-smoke.mjs
@@ -15,11 +15,11 @@ let page;
 try {
   page = await app.firstWindow(); page.setDefaultTimeout(15000); page.on('dialog', d => { void d.dismiss().catch(() => {}); });
   await app.evaluate(({ BrowserWindow, dialog }, fixture) => { BrowserWindow.getAllWindows()[0].showInactive(); dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); dialog.showMessageBoxSync = () => 1; }, fixture);
-  await page.getByRole('button', { name: '폴더 열기', exact: true }).click(); await page.getByRole('button', { name: '≡a.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click(); await page.getByRole('button', { name: '≡a.adoc', exact: true }).click();
   const editor = page.locator('.editor-panel:not([hidden]) .cm-content');
   await editor.focus(); await page.keyboard.press('ControlOrMeta+End'); await page.keyboard.insertText('\nUnsaved!'); await page.keyboard.press('Shift+ArrowLeft');
-  await page.getByRole('button', { name: '검색', exact: true }).click();
-  const search = page.getByRole('dialog', { name: '작업 공간 검색' }), query = search.getByRole('searchbox', { name: '검색어' });
+  await page.keyboard.press('ControlOrMeta+Shift+f');
+  const search = page.getByRole('region', { name: '작업 공간 검색' }), query = search.getByRole('searchbox', { name: '검색어' });
   await query.fill('Needle'); await search.locator('.search-result').nth(1).waitFor();
   await search.getByLabel('결과 경로 필터').fill('b.adoc'); await search.getByLabel('결과 종류').selectOption('text');
   assert.equal(await search.locator('.search-result').count(), 1);
@@ -30,7 +30,7 @@ try {
   assert.ok((await editor.textContent()).includes('Unsaved!'));
   await uiCommand(page, '탐색 앞으로'); await page.getByRole('heading', { name: 'b.adoc', exact: true }).waitFor();
   checks.push('filtered keyboard search opens source; back restores dirty source selection and forward returns to result');
-  await page.getByRole('button', { name: '검색', exact: true }).click();
+  await page.keyboard.press('ControlOrMeta+Shift+f');
   assert.equal(await query.inputValue(), 'Needle'); assert.equal(await search.getByLabel('결과 경로 필터').inputValue(), 'b.adoc');
   await search.locator('.search-result').waitFor();
   await search.getByLabel('결과 경로 필터').fill('absent'); await search.getByText('필터 적용: 0개 표시 · 필터를 변경하거나 초기화하세요.', { exact: true }).waitFor();
@@ -52,14 +52,15 @@ try {
   checks.push('automatic relation refresh retains graph DOM, keyboard focus, selection and layout; list shares selection');
   await modal.getByRole('button', { name: '관계 그래프', exact: true }).click(); await page.screenshot({ path: path.join(run, 'relations.png') });
   await modal.getByRole('button', { name: '닫기', exact: true }).click();
-  await page.getByRole('button', { name: '검색', exact: true }).click(); await search.locator('.search-result').filter({ hasText: 'b.adoc' }).waitFor();
+  await page.keyboard.press('ControlOrMeta+Shift+f'); await search.locator('.search-result').filter({ hasText: 'b.adoc' }).waitFor();
   await unlink(path.join(fixture, 'b.adoc'));
   await search.locator('.search-result').filter({ hasText: 'b.adoc' }).click();
   assert.equal(await page.getByRole('heading', { name: 'a.adoc', exact: true }).count(), 1); assert.ok((await editor.textContent()).includes('Unsaved!'));
   assert.equal(await readFile(path.join(fixture, 'a.adoc'), 'utf8'), files['a.adoc']);
   checks.push('missing search target leaves current dirty document and disk unchanged');
+  await page.getByRole('button', { name: '파일', exact: true }).click();
   await page.getByRole('button', { name: '≡shared.adoc', exact: true }).click();
-  await page.getByRole('tab', { name: 'a.adoc ●', exact: true }).click();
+  await page.getByRole('tab', { name: '● a.adoc', exact: true }).click();
   await editor.focus(); await page.keyboard.press('ControlOrMeta+End'); await page.keyboard.insertText(' changed');
   await uiCommand(page, '탐색 뒤로'); await page.getByRole('heading', { name: 'shared.adoc', exact: true }).waitFor();
   await uiCommand(page, '탐색 뒤로'); await page.locator('footer').filter({ hasText: '이력 이후 편집 내용이 바뀌어' }).waitFor();
diff --git a/scripts/m4-06-smoke.mjs b/scripts/m4-06-smoke.mjs
index b0276cc..18a0db2 100644
--- a/scripts/m4-06-smoke.mjs
+++ b/scripts/m4-06-smoke.mjs
@@ -12,7 +12,8 @@ const app = await electron.launch({ executablePath: packaged || executablePath,
 try {
   const page = await app.firstWindow(); page.setDefaultTimeout(15000); page.on('dialog', d => { void d.dismiss().catch(() => {}); });
   await app.evaluate(({ BrowserWindow, dialog }, fixture) => { BrowserWindow.getAllWindows()[0].showInactive(); dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); dialog.showMessageBoxSync = () => 1; }, fixture);
-  await page.getByRole('button', { name: '폴더 열기', exact: true }).click(); await page.getByRole('button', { name: '≡note.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click(); await page.getByRole('button', { name: '≡note.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '오른쪽 사이드바', exact: true }).click();
   await page.locator('.outline .operation-status[data-phase="complete"]').waitFor();
   await app.evaluate(({ ipcMain }) => {
     let calls = 0;
@@ -24,8 +25,8 @@ try {
       return { ok: true, requestId: request.requestId, value: { hits: [], scanned: 1, partial: calls === 2, warnings: ['검사용 일부 범위'], completedAt: new Date().toISOString() } };
     });
   });
-  await page.getByRole('button', { name: '검색', exact: true }).click();
-  const search = page.getByRole('dialog', { name: '작업 공간 검색' }); await search.getByRole('searchbox').fill('Body');
+  await page.keyboard.press('ControlOrMeta+Shift+f');
+  const search = page.getByRole('region', { name: '작업 공간 검색' }); await search.getByRole('searchbox').fill('Body');
   await search.getByRole('alert').filter({ hasText: '검색 · 실패' }).waitFor();
   await search.getByText('다음 행동: 검색어와 모드를 확인하고 다시 검색을 누르세요.', { exact: true }).waitFor();
   await search.getByRole('button', { name: '다시 검색', exact: true }).click(); await search.locator('[data-phase="partial"]').waitFor();
@@ -47,7 +48,7 @@ try {
   const proposal = page.getByRole('dialog', { name: '변경 제안 검토' });
   await proposal.getByRole('region', { name: '변경 범위와 복구' }).waitFor(); await proposal.getByRole('button', { name: '전체 거부하고 닫기', exact: true }).click();
   await writeFile(path.join(fixture, 'note.adoc'), '= External\n\nChanged');
-  await page.getByRole('button', { name: '외부 변경 확인', exact: true }).click(); await page.getByRole('button', { name: '변경 비교', exact: true }).click();
+  await uiCommand(page, '외부 변경 확인'); await page.getByRole('button', { name: '변경 비교', exact: true }).click();
   const conflict = page.getByRole('dialog', { name: '충돌 비교' });
   await conflict.getByRole('region', { name: '변경 범위와 복구' }).getByText(/해결안 저장은 이 파일의 디스크 원문을 변경/).waitFor();
   await page.screenshot({ path: path.join(run, 'conflict.png') }); await conflict.getByRole('button', { name: '취소', exact: true }).click();
diff --git a/scripts/m4-07-smoke.mjs b/scripts/m4-07-smoke.mjs
index 5b91a0e..5b64173 100644
--- a/scripts/m4-07-smoke.mjs
+++ b/scripts/m4-07-smoke.mjs
@@ -12,16 +12,16 @@ const app = await electron.launch({ executablePath: packaged || executablePath,
 try {
   const page = await app.firstWindow(); page.setDefaultTimeout(15000); page.on('dialog', d => { void d.dismiss().catch(() => {}); });
   await app.evaluate(({ BrowserWindow, dialog }, fixture) => { BrowserWindow.getAllWindows()[0].showInactive(); dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); dialog.showMessageBoxSync = () => 1; }, fixture);
-  await page.getByRole('button', { name: '폴더 열기', exact: true }).click(); await page.getByRole('button', { name: '≡note.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click(); await page.getByRole('button', { name: '≡note.adoc', exact: true }).click();
   const editor = page.locator('.editor-panel:not([hidden]) .cm-content');
   await page.getByRole('button', { name: '편집기로 바로 이동', exact: true }).focus(); await page.keyboard.press('Enter');
   assert.equal(await editor.evaluate(e => e === document.activeElement), true); await page.keyboard.press('ControlOrMeta+End'); await page.keyboard.insertText('\nUnsaved');
   await page.getByRole('button', { name: '검색', exact: true }).click(); await page.getByRole('searchbox', { name: '검색어' }).waitFor(); await page.keyboard.press('Escape');
-  await page.waitForFunction(() => document.activeElement?.textContent === '검색');
+  await page.waitForFunction(() => document.activeElement?.getAttribute('aria-label') === '검색');
   checks.push('skip action focuses editor; search Escape returns focus to invoking button and retains dirty buffer');
   await uiCommand(page, '보기 설정'); const settings = page.getByRole('dialog', { name: '보기 설정' });
-  await settings.getByRole('searchbox').fill('파일'); assert.equal(await settings.getByRole('group', { name: '목차 패널' }).count(), 0);
-  const width = settings.getByRole('slider', { name: /파일 패널 너비/ }); await width.focus(); await page.keyboard.press('ArrowRight'); assert.equal(await width.inputValue(), '250');
+  await settings.getByRole('searchbox').fill('파일'); assert.equal(await settings.getByRole('group', { name: '우측 사이드바' }).count(), 0);
+  const width = settings.getByRole('group', { name: '좌측 사이드바' }).getByRole('slider'); await width.focus(); await page.keyboard.press('ArrowRight'); assert.equal(await width.inputValue(), '250');
   await settings.getByRole('button', { name: '보기 기본값 복원', exact: true }).click(); assert.equal(await width.inputValue(), '240');
   await settings.getByRole('button', { name: '초기화 이전 값 복원', exact: true }).click(); assert.equal(await width.inputValue(), '250');
   await settings.getByRole('searchbox').fill('없는항목'); await settings.getByRole('status').filter({ hasText: '일치하는 보기 설정' }).waitFor();
@@ -31,7 +31,7 @@ try {
   assert.ok((await editor.textContent()).includes('Unsaved')); assert.equal(await readFile(path.join(fixture, 'note.adoc'), 'utf8'), original);
   checks.push('settings filter, keyboard range, reset and undo work; modal contains focus and fallback restores palette entry');
   await page.getByRole('button', { name: '명령 팔레트', exact: true }).click(); const palette = page.getByRole('dialog', { name: '명령 팔레트' });
-  await palette.getByRole('combobox').fill('빠른 열기'); assert.equal(await palette.locator('kbd').textContent(), 'Ctrl+P'); await page.keyboard.press('Escape');
+  await palette.getByRole('combobox').fill('빠른 열기'); assert.equal(await palette.locator('kbd').textContent(), process.platform === 'darwin' ? 'Cmd+P' : 'Ctrl+P'); await page.keyboard.press('Escape');
   await uiCommand(page, '복구 사본'); await page.getByRole('dialog', { name: '복구 사본' }).waitFor(); await page.keyboard.press('Escape'); await page.waitForFunction(() => document.activeElement?.hasAttribute('data-focus-home'));
   checks.push('Windows shortcut label uses Ctrl; recovery dialog Escape restores a usable keyboard entry');
   await page.emulateMedia({ forcedColors: 'active', reducedMotion: 'reduce' });
diff --git a/scripts/package-cleanup.mjs b/scripts/package-cleanup.mjs
index 8ba168d..61f7dd2 100644
--- a/scripts/package-cleanup.mjs
+++ b/scripts/package-cleanup.mjs
@@ -5,7 +5,8 @@ export async function cleanupPackages(root, currentStage) {
   const runs = path.join(await realpath(root), '.pre04-runs');
   if (await realpath(runs) !== runs) throw new Error('Package directory must not be a link');
   const current = path.basename(currentStage);
-  if (path.resolve(currentStage) !== path.join(runs, current) || !/^package-\d+$/.test(current)) {
+  // Validate against the caller's root spelling; deletion uses the canonical root.
+  if (path.resolve(currentStage) !== path.resolve(root, '.pre04-runs', current) || !/^package-\d+$/.test(current)) {
     throw new Error('Invalid current package directory');
   }
   const entries = (await readdir(runs, { withFileTypes: true }))
diff --git a/scripts/package-cleanup.test.mjs b/scripts/package-cleanup.test.mjs
index 0a36c47..77ba0ff 100644
--- a/scripts/package-cleanup.test.mjs
+++ b/scripts/package-cleanup.test.mjs
@@ -1,6 +1,6 @@
 import { test } from 'node:test';
 import assert from 'node:assert/strict';
-import { mkdtemp, mkdir, readdir, rm, writeFile } from 'node:fs/promises';
+import { mkdtemp, mkdir, readdir, rm, writeFile, symlink } from 'node:fs/promises';
 import os from 'node:os';
 import path from 'node:path';
 import { cleanupPackages } from './package-cleanup.mjs';
@@ -19,3 +19,18 @@ test('retains latest two packages and unrelated evidence', async t => {
   await cleanupPackages(root, path.join(runs, 'package-11'));
   assert.deepEqual((await readdir(runs)).sort(), ['latest-package.txt', 'package-10', 'package-11', 'package-not-a-run', 'smoke-1']);
 });
+
+test('root aliases work while linked staging directories are rejected', async t => {
+  const parent = await mkdtemp(path.join(os.tmpdir(), 'metis-cleanup-'));
+  t.after(() => rm(parent, { recursive: true, force: true }));
+  const root = path.join(parent, 'actual'), alias = path.join(parent, 'alias');
+  const runs = path.join(root, '.pre04-runs');
+  for (const name of ['package-1', 'package-2', 'package-3']) await mkdir(path.join(runs, name), { recursive: true });
+  await symlink(root, alias, 'junction');
+  await cleanupPackages(alias, path.join(alias, '.pre04-runs', 'package-3'));
+  assert.deepEqual((await readdir(runs)).sort(), ['package-2', 'package-3']);
+  const linkedRoot = path.join(parent, 'linked');
+  await mkdir(linkedRoot);
+  await symlink(runs, path.join(linkedRoot, '.pre04-runs'), 'junction');
+  await assert.rejects(cleanupPackages(linkedRoot, path.join(linkedRoot, '.pre04-runs', 'package-3')), /link/);
+});
diff --git a/scripts/preview-features-smoke.mjs b/scripts/preview-features-smoke.mjs
index 18edd99..336a061 100644
--- a/scripts/preview-features-smoke.mjs
+++ b/scripts/preview-features-smoke.mjs
@@ -32,7 +32,7 @@ const app = await electron.launch({ executablePath, args: [path.join(root, 'apps
 try {
   const page = await app.firstWindow(); page.setDefaultTimeout(20000);
   await app.evaluate(({ BrowserWindow, dialog }, fixture) => { BrowserWindow.getAllWindows()[0].showInactive(); dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); }, fixture);
-  await page.getByRole('button', { name: '폴더 열기', exact: true }).click();
+  await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click();
   await page.getByRole('button', { name: '≡preview.adoc', exact: true }).click();
   await page.getByRole('button', { name: '미리보기', exact: true }).click();
   const preview = page.frameLocator('iframe[title="AsciiDoc 미리보기"]');
diff --git a/scripts/test-cache-cleanup.mjs b/scripts/test-cache-cleanup.mjs
index 2c7e178..7a47230 100644
--- a/scripts/test-cache-cleanup.mjs
+++ b/scripts/test-cache-cleanup.mjs
@@ -16,11 +16,12 @@ async function hasLink(target) {
 // Call only after the test application has closed. Preserve state and evidence.
 export async function cleanupTestCache(root, profile) {
   const runs = path.join(await realpath(root), '.pre04-runs');
-  const target = path.resolve(profile);
-  const relative = path.relative(runs, target).split(path.sep);
+  // Root aliases (/var on macOS, Windows short paths) are valid; links inside runs are not.
+  const relative = path.relative(path.resolve(root, '.pre04-runs'), path.resolve(profile)).split(path.sep);
   if (relative.length !== 2 || relative[1] !== 'profile' || relative[0].startsWith('package-') || !/^[a-z0-9-]+-\d+$/.test(relative[0])) {
     throw new Error('Refusing profile outside a test run');
   }
+  const target = path.join(runs, ...relative);
   if (await realpath(target) !== target) throw new Error('Refusing linked test profile');
   for (const name of cacheNames) {
     const cache = path.join(target, name);
diff --git a/scripts/test-cache-cleanup.test.mjs b/scripts/test-cache-cleanup.test.mjs
index 5615be4..9c840d3 100644
--- a/scripts/test-cache-cleanup.test.mjs
+++ b/scripts/test-cache-cleanup.test.mjs
@@ -36,6 +36,19 @@ test('linked profiles cannot redirect cleanup', async t => {
   await access(path.join(profile, 'Cache', 'data'));
 });
 
+test('root aliases allow cleanup without allowing linked runs', async t => {
+  const { root, profile } = await fixture(t);
+  const alias = path.join(root, 'alias');
+  await symlink(root, alias, 'junction');
+  const linked = path.join(root, '.pre04-runs', 'smoke-456');
+  await symlink(path.dirname(profile), linked, 'junction');
+  await assert.rejects(cleanupTestCache(alias, path.join(alias, '.pre04-runs', 'smoke-456', 'profile')), /linked/);
+  await access(path.join(profile, 'Cache', 'data'));
+  await cleanupTestCache(alias, path.join(alias, '.pre04-runs', 'smoke-123', 'profile'));
+  await assert.rejects(access(path.join(profile, 'Cache')), { code: 'ENOENT' });
+  await access(path.join(profile, 'recovery', 'data'));
+});
+
 test('cleanup runs after close and does not run when close fails', async t => {
   const { root, profile } = await fixture(t);
   let fail = true;
diff --git a/scripts/ux-02-session.mjs b/scripts/ux-02-session.mjs
index a681055..d0d1373 100644
--- a/scripts/ux-02-session.mjs
+++ b/scripts/ux-02-session.mjs
@@ -36,7 +36,7 @@ try {
     await page.getByRole('heading', { name, exact: true }).waitFor();
     await editor.focus(); await page.keyboard.press('ControlOrMeta+End'); await page.keyboard.insertText(`\nDRAFT-${name}`); await ready();
   }
-  assert.deepEqual(await page.getByRole('tab').allTextContents(), [...originals.keys()].map(name => name + ' ●'));
+  assert.deepEqual(await page.getByRole('tablist', { name: '열린 뷰', exact: true }).getByRole('tab').allTextContents(), [...originals.keys()].map(name => '● ' + name));
   await page.getByRole('button', { name: '분할', exact: true }).click();
   const cdp = await page.context().newCDPSession(page); await cdp.send('Performance.enable');
   async function sample(cycle) {
@@ -51,12 +51,12 @@ try {
   const names = [...originals.keys()], measuredStart = Date.now();
   for (let cycle = 1; cycle <= cycles; cycle++) {
     const name = names[(cycle - 1) % names.length], other = names[cycle % names.length];
-    await page.getByRole('tab', { name: `${name} ●`, exact: true }).click(); await ready();
+    await page.getByRole('tab', { name: `● ${name}`, exact: true }).click(); await ready();
     await editor.focus(); await page.keyboard.press('ControlOrMeta+End');
     assert.ok((await editor.textContent()).includes(`DRAFT-${name}`));
     await page.keyboard.press('Shift+ArrowLeft');
-    await page.getByRole('tab', { name: `${other} ●`, exact: true }).click(); await ready();
-    await page.getByRole('tab', { name: `${name} ●`, exact: true }).click(); await ready();
+    await page.getByRole('tab', { name: `● ${other}`, exact: true }).click(); await ready();
+    await page.getByRole('tab', { name: `● ${name}`, exact: true }).click(); await ready();
     await editor.focus(); await page.keyboard.insertText('X');
     assert.ok((await editor.textContent()).includes(`DRAFT-${name.slice(0, -1)}X`), 'selection survives tab round trip');
     await page.keyboard.press('ControlOrMeta+z'); await ready();
@@ -73,7 +73,7 @@ try {
   // Fill beyond the cap, then inspect public command availability while draining it.
   for (let i = 0; i < 105; i++) {
     const name = names[i % names.length];
-    await page.getByRole('tab', { name: name + ' ●', exact: true }).click();
+    await page.getByRole('tab', { name: '● ' + name, exact: true }).click();
     await page.getByRole('heading', { name, exact: true }).waitFor();
   }
   let historySteps = 0;
diff --git a/scripts/ux-escape-smoke.mjs b/scripts/ux-escape-smoke.mjs
index 08d1af6..306191a 100644
--- a/scripts/ux-escape-smoke.mjs
+++ b/scripts/ux-escape-smoke.mjs
@@ -12,13 +12,13 @@ const app = await electron.launch({ executablePath: packaged || executablePath,
 try {
   const page = await app.firstWindow(); page.setDefaultTimeout(15000); page.on('dialog', d => { void d.dismiss().catch(() => {}); });
   await app.evaluate(({ BrowserWindow, dialog }, fixture) => { BrowserWindow.getAllWindows()[0].showInactive(); dialog.showOpenDialog = async () => ({ canceled: false, filePaths: [fixture] }); dialog.showMessageBoxSync = () => 1; }, fixture);
-  await page.getByRole('button', { name: '폴더 열기', exact: true }).click(); await page.getByRole('button', { name: '≡note.adoc', exact: true }).click();
+  await page.getByRole('button', { name: '폴더 열기', exact: true }).first().click(); await page.getByRole('button', { name: '≡note.adoc', exact: true }).click();
   const editor = page.locator('.editor-panel:not([hidden]) .cm-content'); await editor.focus(); await page.keyboard.press('ControlOrMeta+End'); await page.keyboard.insertText('\nUnsaved');
   for (const scenario of ['search-filled', 'search-empty', 'search-result', 'quick-open-filled', 'settings-filled']) {
     for (let attempt = 1; attempt <= 3; attempt++) {
       const settings = scenario === 'settings-filled', quick = scenario === 'quick-open-filled';
       await uiCommand(page, settings ? '보기 설정' : quick ? '빠른 열기' : '검색');
-      const dialog = page.getByRole('dialog', { name: settings ? '보기 설정' : quick ? '빠른 열기' : '작업 공간 검색', exact: true });
+      const dialog = page.getByRole(settings || quick ? 'dialog' : 'region', { name: settings ? '보기 설정' : quick ? '빠른 열기' : '작업 공간 검색', exact: true });
       const query = dialog.getByRole('searchbox'); await query.fill(settings ? '파일' : quick ? 'note' : scenario === 'search-empty' ? '' : 'needle');
       await query.evaluate(e => e.dispatchEvent(new CompositionEvent('compositionstart', { bubbles: true })));
       await page.keyboard.press('Escape'); assert.equal(await dialog.isVisible(), true);
@@ -35,7 +35,7 @@ try {
       observations.push({ scenario, attempt, dialogOpenAfterEscape: open, queryAfterEscape: open ? await query.inputValue() : null });
       if (open) await dialog.getByRole('button', { name: settings ? '닫기' : '검색 닫기', exact: true }).click();
       await dialog.waitFor({ state: 'detached' });
-      await page.waitForFunction(() => document.activeElement?.hasAttribute('data-focus-home'));
+      await page.waitForFunction(() => document.activeElement?.hasAttribute('data-focus-home') || document.activeElement?.getAttribute('aria-label') === '검색');
       await uiCommand(page, settings ? '보기 설정' : quick ? '빠른 열기' : '검색');
       await query.waitFor();
       assert.equal(await query.inputValue(), settings ? '' : quick ? 'note' : scenario === 'search-empty' ? '' : 'needle');

From 2a24a8a38454cd81b543961ca482e9f7f87c2784 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EC=9C=A4=EC=9A=A9=EC=8B=9D?= <comnori@gmail.com>
Date: Fri, 2 Oct 2026 23:39:58 +0900
Subject: [PATCH 2/6] feat(ui): implement Phase 1 UX improvements (theming,
 folding, link jump, status bar)

---
 apps/desktop/src/renderer/app/main.tsx        |  21 ++--
 .../desktop/src/renderer/app/styles/style.css | 110 +++++++++++++++++-
 .../asciidoc-folding.test.ts                  |  62 ++++++++++
 .../document-workspace/asciidoc-language.ts   |  33 +++++-
 .../widgets/document-workspace/documents.tsx  |  78 ++++++++++++-
 5 files changed, 289 insertions(+), 15 deletions(-)
 create mode 100644 apps/desktop/src/renderer/widgets/document-workspace/asciidoc-folding.test.ts

diff --git a/apps/desktop/src/renderer/app/main.tsx b/apps/desktop/src/renderer/app/main.tsx
index cee05be..7c170ca 100644
--- a/apps/desktop/src/renderer/app/main.tsx
+++ b/apps/desktop/src/renderer/app/main.tsx
@@ -67,6 +67,9 @@ function App() {
   const [session, setSession] = useState<Session>();
   const layout = useLayout(session?.viewKey);
   const appearance = useAppearance(session?.viewKey);
+  useEffect(() => {
+    window.document.documentElement.setAttribute('data-theme', appearance.value.previewTheme);
+  }, [appearance.value.previewTheme]);
   const [stylesheet, setStylesheet] = useState<PreviewStylesheet>({ active: false });
   const [stylesheetVersion, setStylesheetVersion] = useState(0);
   const menu = useRef<HTMLDetailsElement>(null), filesButton = useRef<HTMLButtonElement>(null), outlineButton = useRef<HTMLButtonElement>(null);
@@ -144,7 +147,7 @@ function App() {
       if (event.defaultPrevented || event.isComposing || event.keyCode === 229 || event.repeat || event.altKey || window.document.querySelector('dialog[open]') || !(event.ctrlKey || event.metaKey)) return;
       const key = event.key.toLowerCase();
       if (key === 'p' && event.shiftKey) { event.preventDefault(); if (!locked.current) setPaletteOpen(true); return; }
-      const id = key === 'p' && !event.shiftKey ? 'search.files' : key === 'f' && event.shiftKey ? 'search.text' : key === 's' && !event.shiftKey ? 'document.save' : undefined;
+      const id = (key === 'p' || key === 'o') && !event.shiftKey ? 'search.files' : key === 'f' && event.shiftKey ? 'search.text' : key === 's' && !event.shiftKey ? 'document.save' : undefined;
       if (id) { event.preventDefault(); void dispatch(id); }
     };
     window.addEventListener('keydown', shortcut); return () => window.removeEventListener('keydown', shortcut);
@@ -252,16 +255,20 @@ function App() {
   function beginCreate(kind: 'workspace' | 'directory' | 'document') { createInvoker.current = window.document.activeElement as HTMLElement; setName(kind === 'document' ? 'untitled.adoc' : ''); setError(''); setCreating(kind); }
   async function create(event: React.FormEvent) {
     event.preventDefault();
-    if (!validFolderName(name) || locked.current) return;
-    if (creating === 'workspace') return changeWorkspace(() => window.metis.createWorkspace({ requestId: requestId(), name }));
+    let finalName = name.trim();
+    if (creating === 'document' && !/\.adoc$/i.test(finalName)) {
+      finalName = `${finalName}.adoc`;
+    }
+    if (!validFolderName(finalName) || locked.current) return;
+    if (creating === 'workspace') return changeWorkspace(() => window.metis.createWorkspace({ requestId: requestId(), name: finalName }));
     if (!session) return;
     locked.current = true; setBusy(true); setError('');
     try {
       if (creating === 'document') {
-        const result = await call(() => window.metis.createDocument({ ...scope(session), relativePath: folder, name }));
+        const result = await call(() => window.metis.createDocument({ ...scope(session), relativePath: folder, name: finalName }));
         if (result.ok) { setCreating(undefined); await list(session, folder); documents.current?.open(result.value); setStatus('문서를 만들었습니다.'); } else report(result);
       } else {
-        const result = await call(() => window.metis.createDirectory({ ...scope(session), relativePath: folder, name }));
+        const result = await call(() => window.metis.createDirectory({ ...scope(session), relativePath: folder, name: finalName }));
         if (result.ok) { setCreating(undefined); await list(session, folder); setStatus('폴더를 만들었습니다.'); } else report(result);
       }
     } finally { locked.current = false; setBusy(false); }
@@ -377,7 +384,7 @@ function App() {
     '--document-font-family': appearance.value.documentFontFamily,
     '--document-font-size': `${appearance.value.documentFontSize}px`
   } as React.CSSProperties;
-  return <div className={`app workspace-shell ${leftVisible ? 'show-left' : ''} ${rightVisible ? 'show-right' : ''} ${layout.mobile ? `mobile-${layout.mobile}` : ''}`} style={panelStyle}>
+  return <div data-theme={appearance.value.previewTheme} className={`app workspace-shell ${leftVisible ? 'show-left' : ''} ${rightVisible ? 'show-right' : ''} ${layout.mobile ? `mobile-${layout.mobile}` : ''}`} style={panelStyle}>
     <button className="skip-editor" onClick={() => { const editor = window.document.querySelector<HTMLElement>('.editor-panel:not([hidden]) .cm-content'); if (editor?.getClientRects().length) editor.focus(); else window.document.querySelector<HTMLElement>('main')?.focus(); }}>편집기로 바로 이동</button>
     <nav className="ribbon" aria-label="워크스페이스 리본">
       <details className="workspace-switcher"><summary className="ribbon-button brand-ribbon" aria-label="Metis 작업 공간 전환" title="작업 공간 전환"><span aria-hidden="true">M</span></summary><div className="ribbon-popover"><strong>{session?.name ?? 'Metis'}</strong>{commandButton('workspace.open')}{commandButton('workspace.create')}{session && commandButton('workspace.close')}{recentWarning && <p className="notice">{recentWarning}</p>}{recent.map(item => <article key={item.id}>
@@ -432,7 +439,7 @@ function App() {
       {layout.value.right.active === 'relations' && <section aria-label="문서 관계"><h2>관계</h2>{activeAnalysis?.relations.length ? activeAnalysis.relations.map((item, index) => <button className="inspector-item" key={index} onClick={() => void read({ name: item.destination?.relativePath ?? item.relativePath, relativePath: item.destination?.relativePath ?? item.relativePath, kind: 'document' }, item.destination?.line ?? item.line)}>{item.kind === 'xref' ? '참조' : '포함'} · {item.target}</button>) : <p>활성 문서에서 해석된 관계가 없습니다.</p>}</section>}
       {layout.value.right.active === 'diagnostics' && <section aria-label="문서 진단"><h2>진단</h2>{activeAnalysis?.diagnostics.length ? activeAnalysis.diagnostics.map((item, index) => <button className="inspector-item" key={index} onClick={() => void read({ name: item.relativePath, relativePath: item.relativePath, kind: 'document' }, item.line)}>{item.line} · {item.message}</button>) : <p>활성 문서의 진단이 없습니다.</p>}</section>}
     </div></aside>
-    {settingsOpen && <ViewSettings value={layout.value} update={layout.update} appearance={appearance.value} updateAppearance={appearance.update} workspace={!!session} stylesheet={stylesheet} selectStylesheet={selectStylesheet} reloadStylesheet={reloadStylesheet} clearStylesheet={clearStylesheet} warning={[layout.warning, appearance.warning].filter(Boolean).join(' ')} close={() => setSettingsOpen(false)} />}<footer role="status">{error ? '작업 실패 · 오류 안내와 해결 행동을 확인하세요.' : busy ? '작업 진행 중 · 완료될 때까지 기다려 주세요.' : status}</footer>{paletteOpen && <CommandPalette commands={commands} close={() => setPaletteOpen(false)} execute={id => { void dispatch(id); }} />}
+    {settingsOpen && <ViewSettings value={layout.value} update={layout.update} appearance={appearance.value} updateAppearance={appearance.update} workspace={!!session} stylesheet={stylesheet} selectStylesheet={selectStylesheet} reloadStylesheet={reloadStylesheet} clearStylesheet={clearStylesheet} warning={[layout.warning, appearance.warning].filter(Boolean).join(' ')} close={() => setSettingsOpen(false)} />}<footer role="status"><span className="footer-status-text">{error ? '작업 실패 · 오류 안내와 해결 행동을 확인하세요.' : busy ? '작업 진행 중 · 완료될 때까지 기다려 주세요.' : status}</span>{document && <span className="footer-document-stats"><span className="footer-stat-badge">UTF-8{document.bom ? ' BOM' : ''}</span><span className="footer-stat-badge">{document.eol.toUpperCase()}</span><span className="footer-stat-badge">{document.readOnly ? '읽기 전용' : '편집 가능'}</span></span>}</footer>{paletteOpen && <CommandPalette commands={commands} close={() => setPaletteOpen(false)} execute={id => { void dispatch(id); }} />}
     {helpOpen && <GettingStarted workspace={session?.name} documentPath={document?.relativePath} readOnly={session?.readOnly} close={() => setHelpOpen(false)} showHints={() => { setHintsHidden(false); setHelpOpen(false); setStatus('시작 화면 안내를 다시 표시합니다. 문서가 열려 있으면 탭을 닫은 빈 화면에서 확인하세요.'); }} />}
     {extensionsOpen && <ExtensionsPanel runtime={extensions} close={() => setExtensionsOpen(false)} />}
     {extensionView && <ExtensionView key={`${extensionView.owner}-${extensionView.id}`} runtime={extensions} {...extensionView} close={() => setExtensionView(undefined)} />}
diff --git a/apps/desktop/src/renderer/app/styles/style.css b/apps/desktop/src/renderer/app/styles/style.css
index 066f6b1..f71b578 100644
--- a/apps/desktop/src/renderer/app/styles/style.css
+++ b/apps/desktop/src/renderer/app/styles/style.css
@@ -29,6 +29,63 @@
   --radius: 6px;
 }
 
+:root[data-theme="dark"], .app[data-theme="dark"] {
+  color-scheme: dark;
+  color: #e6edf3;
+  background: #0d1117;
+  --canvas: #0d1117;
+  --surface: #161b22;
+  --surface-raised: #1c2128;
+  --surface-hover: #21262d;
+  --surface-selected: #1f3547;
+  --border: #30363d;
+  --border-strong: #484f58;
+  --text: #e6edf3;
+  --muted: #8b949e;
+  --faint: #6e7681;
+  --primary: #161b22;
+  --primary-hover: #21262d;
+  --secondary: #58a6ff;
+  --secondary-soft: #1f3547;
+  --accent: #f2c75c;
+  --accent-strong: #d6a84b;
+  --accent-soft: #382c16;
+  --success: #3fb950;
+  --warning: #d29922;
+  --warning-soft: #382c16;
+  --danger: #f85149;
+  --shadow: 0 12px 32px rgba(0, 0, 0, .5);
+}
+
+:root[data-theme="sepia"], .app[data-theme="sepia"] {
+  color-scheme: light;
+  color: #463c2c;
+  background: #f7f0df;
+  --canvas: #f7f0df;
+  --surface: #eee3ca;
+  --surface-raised: #fbf7ee;
+  --surface-hover: #e5d8bc;
+  --surface-selected: #eddcb5;
+  --border: #cbbd9d;
+  --border-strong: #aa9368;
+  --text: #463c2c;
+  --muted: #765a2d;
+  --faint: #927546;
+  --primary: #3b2f1e;
+  --primary-hover: #4e3f2a;
+  --secondary: #8c5d26;
+  --secondary-soft: #eeddbb;
+  --accent: #b07d2b;
+  --accent-strong: #8c5d26;
+  --accent-soft: #fcf1d5;
+  --success: #3f7d52;
+  --warning: #9a6c28;
+  --warning-soft: #fff4cf;
+  --danger: #a84242;
+  --shadow: 0 12px 32px rgba(70, 60, 44, .18);
+}
+
+
 * { box-sizing: border-box; }
 body { margin: 0; background: var(--canvas); }
 button, input, select, textarea { font: inherit; }
@@ -70,17 +127,66 @@ main { flex: 1; min-width: 0; display: flex; flex-direction: column; background:
 .source { flex: 1; overflow: auto; background: var(--surface-raised); }
 .cm-editor { min-height: 100%; font-size: var(--document-font-size, 15px); color: var(--text); }
 .cm-content { font-family: var(--document-font-family, "Cascadia Code", Consolas, monospace); padding: 28px 0 120px; line-height: 1.65; caret-color: var(--secondary); }
-.cm-line { padding-left: 22px; padding-right: 32px; }
+.cm-line { padding-left: 18px; padding-right: 32px; }
 .cm-activeLine { background: rgba(20, 119, 131, .06) !important; }
 .cm-selectionBackground { background: var(--secondary-soft) !important; }
 .cm-gutters { background: var(--canvas) !important; border-right: 1px solid var(--border) !important; color: var(--faint) !important; }
 
+/* CodeMirror Folding Gutter */
+.cm-foldGutter { width: 14px; cursor: pointer; color: var(--faint); text-align: center; }
+.cm-foldGutter:hover { color: var(--secondary); }
+.cm-foldPlaceholder { background: var(--surface-hover); border: 1px solid var(--border); border-radius: 3px; padding: 0 5px; margin: 0 3px; color: var(--muted); font-size: 0.85em; cursor: pointer; }
+
+/* CodeMirror Link Hover Indicator */
+.cm-content.cm-ctrl-pressed .cm-link { cursor: pointer; text-decoration: underline; color: var(--secondary) !important; }
+
+/* Dark Theme Specific Overrides */
+.app[data-theme="dark"] .cm-gutters { background: var(--canvas) !important; border-right-color: var(--border) !important; color: var(--muted) !important; }
+.app[data-theme="dark"] .cm-activeLine { background: rgba(88, 166, 255, .08) !important; }
+.app[data-theme="dark"] .cm-selectionBackground { background: rgba(56, 139, 253, .3) !important; }
+.app[data-theme="dark"] .modal form, .app[data-theme="dark"] .create-dialog { background: var(--surface-raised); color: var(--text); }
+.app[data-theme="dark"] .ribbon-button { color: #8b949e; }
+.app[data-theme="dark"] .ribbon-button:hover:not(:disabled), .app[data-theme="dark"] .ribbon-button.active { background: #21262d; color: var(--accent); }
+.app[data-theme="dark"] .sidebar-tooltip { background: var(--surface); color: var(--text); border-color: var(--border); }
+.app[data-theme="dark"] .sidebar-tooltip::before { background: var(--surface); }
+
+/* Sepia Theme Specific Overrides */
+.app[data-theme="sepia"] .modal form, .app[data-theme="sepia"] .create-dialog { background: var(--surface-raised); color: var(--text); }
+.app[data-theme="sepia"] .ribbon-button { color: #765a2d; }
+.app[data-theme="sepia"] .ribbon-button:hover:not(:disabled), .app[data-theme="sepia"] .ribbon-button.active { background: #eeddbb; color: var(--accent); }
+
 footer {
   min-height: 28px;
   padding: 6px 14px;
   border-top: 1px solid var(--border);
   background: var(--surface);
-  font-size:calc(11px * var(--ui-font-scale, 1));
+  font-size: calc(11px * var(--ui-font-scale, 1));
+  color: var(--muted);
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+}
+.footer-status-text {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  flex: 1;
+  min-width: 0;
+}
+.footer-document-stats {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-shrink: 0;
+}
+.footer-stat-badge {
+  padding: 2px 6px;
+  border-radius: 3px;
+  background: var(--surface-raised);
+  border: 1px solid var(--border);
+  font-size: calc(10px * var(--ui-font-scale, 1));
   color: var(--muted);
 }
 [role=alert] { background: var(--warning-soft); color: var(--warning); padding: 12px 18px; }
+
diff --git a/apps/desktop/src/renderer/widgets/document-workspace/asciidoc-folding.test.ts b/apps/desktop/src/renderer/widgets/document-workspace/asciidoc-folding.test.ts
new file mode 100644
index 0000000..0bf526a
--- /dev/null
+++ b/apps/desktop/src/renderer/widgets/document-workspace/asciidoc-folding.test.ts
@@ -0,0 +1,62 @@
+import { describe, it, expect } from 'vitest';
+import { EditorState } from '@codemirror/state';
+import { foldable } from '@codemirror/language';
+import { asciidocFolding } from './asciidoc-language';
+
+describe('asciidocFolding', () => {
+  it('folds section headings based on heading level', () => {
+    const doc = [
+      '= Document Title',
+      'Intro paragraph 1',
+      'Intro paragraph 2',
+      '== Section 1',
+      'Content for section 1',
+      '=== Sub Section 1.1',
+      'Sub content',
+      '== Section 2',
+      'Content for section 2'
+    ].join('\n');
+
+    const state = EditorState.create({ doc, extensions: [asciidocFolding] });
+
+    // Title line (line 1, from 0 to 16)
+    const titleFold = foldable(state, 0, 16);
+    expect(titleFold).not.toBeNull();
+    expect(titleFold?.from).toBe(16);
+    expect(titleFold?.to).toBe(state.doc.length);
+
+    // Section 1 line (line 4)
+    const sec1Line = state.doc.line(4);
+    const sec1Fold = foldable(state, sec1Line.from, sec1Line.to);
+    expect(sec1Fold).not.toBeNull();
+    // Should fold up to the start of Section 2 (line 7 end)
+    const subContentLine = state.doc.line(7);
+    expect(sec1Fold?.to).toBe(subContentLine.to);
+
+    // Sub Section 1.1 (line 6)
+    const subLine = state.doc.line(6);
+    const subFold = foldable(state, subLine.from, subLine.to);
+    expect(subFold).not.toBeNull();
+    expect(subFold?.to).toBe(subContentLine.to);
+  });
+
+  it('folds delimited blocks like source and quote blocks', () => {
+    const doc = [
+      '= Title',
+      '[source,typescript]',
+      '----',
+      'const x = 1;',
+      'const y = 2;',
+      '----',
+      'After block'
+    ].join('\n');
+
+    const state = EditorState.create({ doc, extensions: [asciidocFolding] });
+
+    const openDelimLine = state.doc.line(3);
+    const blockFold = foldable(state, openDelimLine.from, openDelimLine.to);
+    expect(blockFold).not.toBeNull();
+    const closeDelimLine = state.doc.line(6);
+    expect(blockFold?.to).toBe(closeDelimLine.to);
+  });
+});
diff --git a/apps/desktop/src/renderer/widgets/document-workspace/asciidoc-language.ts b/apps/desktop/src/renderer/widgets/document-workspace/asciidoc-language.ts
index c14394c..8b8bf77 100644
--- a/apps/desktop/src/renderer/widgets/document-workspace/asciidoc-language.ts
+++ b/apps/desktop/src/renderer/widgets/document-workspace/asciidoc-language.ts
@@ -1,4 +1,4 @@
-import { StreamLanguage, syntaxHighlighting, defaultHighlightStyle } from '@codemirror/language';
+import { StreamLanguage, syntaxHighlighting, defaultHighlightStyle, foldService } from '@codemirror/language';
 // Lexical editing aid only. Semantic sections and diagnostics come from Asciidoctor.
 export const asciidocLanguage = StreamLanguage.define({
   startState: () => ({ delimiter: '' }),
@@ -27,3 +27,34 @@ export const asciidocLanguage = StreamLanguage.define({
   }
 });
 export const asciidocHighlighting = syntaxHighlighting(defaultHighlightStyle);
+
+export const asciidocFolding = foldService.of((state, lineStart) => {
+  const line = state.doc.lineAt(lineStart);
+  const text = line.text;
+
+  const headingMatch = text.match(/^(=+)\s+/);
+  if (headingMatch) {
+    const level = headingMatch[1].length;
+    let end = line.to;
+    for (let i = line.number + 1; i <= state.doc.lines; i++) {
+      const nextLine = state.doc.line(i);
+      const nextMatch = nextLine.text.match(/^(=+)\s+/);
+      if (nextMatch && nextMatch[1].length <= level) break;
+      end = nextLine.to;
+    }
+    if (end > line.to) return { from: line.to, to: end };
+  }
+
+  const delimMatch = text.match(/^(----+|\.\.\.\.+|\+\+\+\+|\/\/\/\/|\*\*\*\*|\|===+)$/);
+  if (delimMatch) {
+    const delim = delimMatch[1];
+    for (let i = line.number + 1; i <= state.doc.lines; i++) {
+      const nextLine = state.doc.line(i);
+      if (nextLine.text.trim() === delim) {
+        return { from: line.to, to: nextLine.to };
+      }
+    }
+  }
+  return null;
+});
+
diff --git a/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx b/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
index 12aa3e9..80cd5eb 100644
--- a/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
+++ b/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
@@ -2,9 +2,10 @@ import React, { forwardRef, useEffect, useImperativeHandle, useRef, useState } f
 import { EditorState, EditorSelection, Compartment } from '@codemirror/state';
 import { EditorView, keymap, lineNumbers } from '@codemirror/view';
 import { history, historyKeymap, defaultKeymap, undo, redo } from '@codemirror/commands';
+import { foldGutter, foldKeymap } from '@codemirror/language';
 import type { DocumentSnapshot, Session } from '@metis/contracts';
 import type { OutlineEntry } from '@metis/contracts';
-import { asciidocLanguage, asciidocHighlighting } from './asciidoc-language';
+import { asciidocLanguage, asciidocHighlighting, asciidocFolding } from './asciidoc-language';
 import { Preview, type PreviewPosition } from './preview';
 import { autocompletion } from '@codemirror/autocomplete';
 import { complete } from './completions';
@@ -25,17 +26,82 @@ function jump(tab: Tab, line: number) {
   tab.view.dispatch({ selection: { anchor: position }, effects: EditorView.scrollIntoView(position, { y: 'center' }) });
   tab.view.focus();
 }
-function Editor({ tab, changed, save }: { tab: Tab; changed(): void; save(): void }) {
+function findLinkAt(text: string, col: number) {
+  const xrefRegex = /xref:([^\s\[]+)(?:\[(.*?)\])?/g;
+  let match;
+  while ((match = xrefRegex.exec(text)) !== null) {
+    if (col >= match.index && col <= match.index + match[0].length) {
+      const [path, anchor] = match[1].split('#');
+      return { path: path || undefined, anchor, label: match[2] };
+    }
+  }
+  const includeRegex = /include::([^\s\[]+)\[(.*?)\]/g;
+  while ((match = includeRegex.exec(text)) !== null) {
+    if (col >= match.index && col <= match.index + match[0].length) {
+      return { path: match[1], label: match[2] };
+    }
+  }
+  const anchorRegex = /<<([^\s>,]+)(?:,\s*([^>]*))?>>/g;
+  while ((match = anchorRegex.exec(text)) !== null) {
+    if (col >= match.index && col <= match.index + match[0].length) {
+      const raw = match[1];
+      const [path, anchor] = raw.includes('#') ? raw.split('#') : ['', raw];
+      return { path: path || undefined, anchor, label: match[2] };
+    }
+  }
+  return null;
+}
+function resolveDocPath(fromDoc: string, targetPath: string): string {
+  if (!targetPath) return fromDoc;
+  const parts = fromDoc.includes('/') ? fromDoc.split('/').slice(0, -1) : [];
+  for (const segment of targetPath.split('/')) {
+    if (segment === '.' || !segment) continue;
+    if (segment === '..') parts.pop();
+    else parts.push(segment);
+  }
+  return parts.join('/');
+}
+function Editor({ tab, changed, save, onSource, onJump }: { tab: Tab; changed(): void; save(): void; onSource?(entry: OutlineEntry): void; onJump?(line: number): void }) {
   const saveCurrent = useRef(save); saveCurrent.current = save;
+  const onSourceCurrent = useRef(onSource); onSourceCurrent.current = onSource;
+  const onJumpCurrent = useRef(onJump); onJumpCurrent.current = onJump;
   const element = useRef<HTMLDivElement>(null);
   const access = useRef(new Compartment());
   useEffect(() => {
     const readonly = !!tab.baseline.readOnly || tab.baseline.eol === 'mixed';
-    tab.view = new EditorView({ parent: element.current!, state: EditorState.create({ doc: tab.text, extensions: [lineNumbers(), history(), asciidocLanguage, asciidocHighlighting,
+    tab.view = new EditorView({ parent: element.current!, state: EditorState.create({ doc: tab.text, extensions: [
+      lineNumbers(), foldGutter(), asciidocFolding, history(), asciidocLanguage, asciidocHighlighting,
       autocompletion({ override: [context => complete(context, tab.baseline.relativePath, tab.analysis)] }),
-      keymap.of([{ key: 'Mod-s', run: () => { saveCurrent.current(); return true; } }, ...defaultKeymap, ...historyKeymap]),
+      keymap.of([{ key: 'Mod-s', run: () => { saveCurrent.current(); return true; } }, ...defaultKeymap, ...historyKeymap, ...foldKeymap]),
       access.current.of([EditorState.readOnly.of(readonly), EditorView.editable.of(!readonly)]), EditorView.lineWrapping,
       EditorView.contentAttributes.of({ 'aria-label': '문서 편집기' }),
+      EditorView.domEventHandlers({
+        keydown(event, view) {
+          if (event.key === 'Control' || event.key === 'Meta') view.contentDOM.classList.add('cm-ctrl-pressed');
+        },
+        keyup(event, view) {
+          if (event.key === 'Control' || event.key === 'Meta') view.contentDOM.classList.remove('cm-ctrl-pressed');
+        },
+        click(event, view) {
+          if ((event.ctrlKey || event.metaKey) && event.button === 0) {
+            const pos = view.posAtCoords({ x: event.clientX, y: event.clientY });
+            if (pos !== null) {
+              const line = view.state.doc.lineAt(pos);
+              const link = findLinkAt(line.text, pos - line.from);
+              if (link) {
+                event.preventDefault();
+                const targetDoc = resolveDocPath(tab.baseline.relativePath, link.path ?? '');
+                if (targetDoc === tab.baseline.relativePath && link.anchor) {
+                  const match = tab.analysis?.anchors.find(a => a.id === link.anchor);
+                  if (match) { onJumpCurrent.current?.(match.line); return true; }
+                }
+                onSourceCurrent.current?.({ relativePath: targetDoc, line: 1, id: link.anchor ?? '', title: link.label ?? '', level: 1 });
+                return true;
+              }
+            }
+          }
+        }
+      }),
       EditorView.updateListener.of(update => { if (update.docChanged) { tab.text = update.state.doc.toString(); changed(); } })] }) });
     if (tab.jumpLine) { jump(tab, tab.jumpLine); tab.jumpLine = undefined; }
     return () => { tab.view?.destroy(); tab.view = undefined; };
@@ -43,6 +109,7 @@ function Editor({ tab, changed, save }: { tab: Tab; changed(): void; save(): voi
   useEffect(() => { const readonly = !!tab.baseline.readOnly || tab.baseline.eol === 'mixed'; tab.view?.dispatch({ effects: access.current.reconfigure([EditorState.readOnly.of(readonly), EditorView.editable.of(!readonly)]) }); }, [tab, tab.baseline.readOnly, tab.baseline.eol]);
   return <div className="source" ref={element} />;
 }
+
 export const Documents = forwardRef<DocumentsHandle, { session?: Session; inspectorTarget?: HTMLElement | null; appearance: WorkspaceAppearanceV1; stylesheetVersion: number; favorites: string[]; onToggleFavorite(path: string): void; onSource(entry: OutlineEntry): void; onActive(document?: DocumentSnapshot): void; onAnalysis(path: string, analysis: Analysis): void; onTabsChanged(tabs: DocumentTabSnapshot[], active: string): void; onError(message: string): void; onStatus(message: string): void; onBusy(value: boolean): void; onCommandsChanged(): void }>(function Documents(props, ref) {
   const tabs = useRef(new Map<string, Tab>());
   const [active, setActive] = useState('');
@@ -294,8 +361,9 @@ export const Documents = forwardRef<DocumentsHandle, { session?: Session; inspec
     {selected?.external && <div className="external-change" role="status">{selected.external.message}<div className="tools">{selected.external.disk && <button disabled={saving.current} onClick={() => setReview({ tab: selected, disk: selected.external!.disk! })}>변경 비교</button>}<button disabled={saving.current} onClick={() => runDocumentCommand('document.inspect')}>다시 확인</button></div><div className="copy-controls"><input aria-label="사본 파일 이름" value={copyName} onChange={event => setCopyName(event.target.value)} /><button disabled={saving.current || !validFolderName(copyName) || !/\.adoc$/i.test(copyName)} onClick={() => keepOrCopy(selected, true)}>다른 이름으로 저장</button></div></div>}
     {review && <Conflict baseline={review.tab.baseline} disk={review.disk} text={review.tab.text} close={() => setReview(undefined)} resolve={resolve} />}
     <div className={`document-body mode-${mode}`}>
-      <div className="editors" hidden={mode === 'preview'}>{[...tabs.current].map(([path, tab]) => <div className="editor-panel" hidden={path !== active} key={path}><Editor tab={tab} changed={() => { scheduleDraft(tab); changed(); }} save={() => void runDocumentCommand('document.save')} /></div>)}</div>
+      <div className="editors" hidden={mode === 'preview'}>{[...tabs.current].map(([path, tab]) => <div className="editor-panel" hidden={path !== active} key={path}><Editor tab={tab} changed={() => { scheduleDraft(tab); changed(); }} save={() => void runDocumentCommand('document.save')} onSource={props.onSource} onJump={line => jump(tab, line)} /></div>)}</div>
       {selected && props.session && <Preview appearance={props.appearance} stylesheetVersion={props.stylesheetVersion} inspector={false} inspectorTarget={props.inspectorTarget} key={active} position={selected.previewPosition ??= { x: 0, y: 0, outline: 0 }} editorLine={() => selected.view?.state.doc.lineAt(selected.view.state.selection.main.head).number ?? 1} reveal={() => setMode('split')} session={props.session} relativePath={active} text={selected.text} mode={mode} onAnalysis={value => { selected.analysis = value; selected.analysisText = analyzedText; props.onAnalysis(active, value); }} navigate={entry => { setMode('split'); if (entry.relativePath === active) jump(selected, entry.line); else props.onSource(entry); }} />}
     </div>
+
   </section>;
 });

From c4ca4fea0d8e48a20f9528087c7d09840d5f5e7b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EC=9C=A4=EC=9A=A9=EC=8B=9D?= <comnori@gmail.com>
Date: Fri, 2 Oct 2026 23:43:19 +0900
Subject: [PATCH 3/6] feat(ui): add middle-click tab close, radial graph
 layout, and semantic syntax highlighting

---
 apps/desktop/src/renderer/app/main.tsx        |  2 +-
 .../renderer/features/relations/related.tsx   | 17 ++++++++++----
 .../document-workspace/asciidoc-language.ts   | 22 +++++++++++++++++--
 3 files changed, 34 insertions(+), 7 deletions(-)

diff --git a/apps/desktop/src/renderer/app/main.tsx b/apps/desktop/src/renderer/app/main.tsx
index 7c170ca..5ed2e44 100644
--- a/apps/desktop/src/renderer/app/main.tsx
+++ b/apps/desktop/src/renderer/app/main.tsx
@@ -422,7 +422,7 @@ function App() {
     </aside>
     {leftVisible && !layout.narrow && <PanelResizer side="left" value={layout.value.left.width} min={180} max={420} resize={layout.resizeLeft} />}
     <main className="center-workspace" tabIndex={-1} aria-label="문서 작업 영역">
-      <div className="workspace-tabs" role="tablist" aria-label="열린 뷰" onKeyDown={event => { if (!['ArrowLeft', 'ArrowRight', 'Home', 'End'].includes(event.key)) return; const tabs = [...event.currentTarget.querySelectorAll<HTMLButtonElement>('[role=tab]')], index = tabs.indexOf(event.target as HTMLButtonElement); if (index < 0) return; event.preventDefault(); tabs[event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : Math.min(tabs.length - 1, Math.max(0, index + (event.key === 'ArrowRight' ? 1 : -1)))].focus(); tabs[event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : Math.min(tabs.length - 1, Math.max(0, index + (event.key === 'ArrowRight' ? 1 : -1)))].click(); }}>{documentTabs.map(tab => <div className={`workspace-tab ${centerView === 'documents' && document?.relativePath === tab.path ? 'active' : ''}`} key={tab.path}><button role="tab" aria-selected={centerView === 'documents' && document?.relativePath === tab.path} title={tab.path} onClick={() => selectDocumentTab(tab.path)}>{tab.dirty ? '● ' : ''}{tab.path.split('/').at(-1)}</button><button className="tab-close" aria-label={`${tab.path} 탭 닫기`} onClick={() => void documents.current?.closeTab(tab.path)}>×</button></div>)}{graphOpen && <div className={`workspace-tab ${centerView === 'graph' ? 'active' : ''}`}><button role="tab" aria-selected={centerView === 'graph'} onClick={() => setCenterView('graph')}>◎ 그래프</button><button className="tab-close" aria-label="그래프 탭 닫기" onClick={() => { setGraphOpen(false); setCenterView('documents'); }}>×</button></div>}</div>
+      <div className="workspace-tabs" role="tablist" aria-label="열린 뷰" onKeyDown={event => { if (!['ArrowLeft', 'ArrowRight', 'Home', 'End'].includes(event.key)) return; const tabs = [...event.currentTarget.querySelectorAll<HTMLButtonElement>('[role=tab]')], index = tabs.indexOf(event.target as HTMLButtonElement); if (index < 0) return; event.preventDefault(); tabs[event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : Math.min(tabs.length - 1, Math.max(0, index + (event.key === 'ArrowRight' ? 1 : -1)))].focus(); tabs[event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : Math.min(tabs.length - 1, Math.max(0, index + (event.key === 'ArrowRight' ? 1 : -1)))].click(); }}>{documentTabs.map(tab => <div className={`workspace-tab ${centerView === 'documents' && document?.relativePath === tab.path ? 'active' : ''}`} key={tab.path} onAuxClick={event => { if (event.button === 1) { event.preventDefault(); void documents.current?.closeTab(tab.path); } }}><button role="tab" aria-selected={centerView === 'documents' && document?.relativePath === tab.path} title={tab.path} onClick={() => selectDocumentTab(tab.path)}>{tab.dirty ? '● ' : ''}{tab.path.split('/').at(-1)}</button><button className="tab-close" aria-label={`${tab.path} 탭 닫기`} onClick={() => void documents.current?.closeTab(tab.path)}>×</button></div>)}{graphOpen && <div className={`workspace-tab ${centerView === 'graph' ? 'active' : ''}`} onAuxClick={event => { if (event.button === 1) { event.preventDefault(); setGraphOpen(false); setCenterView('documents'); } }}><button role="tab" aria-selected={centerView === 'graph'} onClick={() => setCenterView('graph')}>◎ 그래프</button><button className="tab-close" aria-label="그래프 탭 닫기" onClick={() => { setGraphOpen(false); setCenterView('documents'); }}>×</button></div>}</div>
       {error && !creating && <div className="operation-status" data-phase="failed"><p role="alert"><strong>작업 실패</strong> — {error}</p><button onClick={() => setError('')}>오류 안내 닫기</button>{document && <details><summary>편집 보존·복구 작업</summary><p>저장·외부 변경 문제라면 현재 편집을 보존하고 원문 상태를 확인하세요.</p>{commandButton('document.preserve')}{commandButton('document.inspect')}{commandButton('recovery.open')}{commandButton('recovery.folder')}</details>}</div>}{warning && <div className="notice">{warning}</div>}
       <div className="document-workspace" hidden={centerView !== 'documents' || !document}><Documents inspectorTarget={inspectorTarget} appearance={appearance.value} stylesheetVersion={stylesheetVersion} favorites={favorites} onToggleFavorite={toggleFavorite} onCommandsChanged={() => updateCommands(value => value + 1)} ref={documents} session={session} onSource={entry => { void read({ name: entry.relativePath, relativePath: entry.relativePath, kind: 'document' }, entry.line); }} onActive={value => { reading.current++; setDocument(value); setActiveAnalysis(undefined); }} onAnalysis={(_path, analysis) => setActiveAnalysis(analysis)} onTabsChanged={(tabs) => setDocumentTabs(tabs)} onError={setError} onStatus={setStatus} onBusy={value => { locked.current = value; setBusy(value); }} /></div>
       {session && graphOpen && <div className="graph-tab-workspace" hidden={centerView !== 'graph'}><Relations embedded key={`${session.workspaceId}-${session.workspaceEpoch}-graph`} session={session} initialPath={document?.relativePath} initialMode="graph" close={() => { setGraphOpen(false); setCenterView('documents'); }} open={(source, revision) => { setCenterView('documents'); void read({ name: source.relativePath, relativePath: source.relativePath, kind: 'document' }, source.line, revision); }} /></div>}
diff --git a/apps/desktop/src/renderer/features/relations/related.tsx b/apps/desktop/src/renderer/features/relations/related.tsx
index 44828a7..57aefa3 100644
--- a/apps/desktop/src/renderer/features/relations/related.tsx
+++ b/apps/desktop/src/renderer/features/relations/related.tsx
@@ -9,22 +9,31 @@ export function RelatedView({ index, selected, initialMode = 'list', open }: { i
   const model = useMemo(() => relatedDocuments(index?.edges ?? [], selected, 12), [index, selected]);
   const detail = model.documents.find(doc => doc.path === focused);
   const names = [selected, ...model.documents.map(doc => doc.path)].filter(Boolean);
-  const position = (name: string, i: number) => positions[name] ?? (i === 0 ? { x: 450, y: 40 } : { x: 150 + ((i - 1) % 3) * 300, y: 145 + Math.floor((i - 1) / 3) * 95 });
+  const position = (name: string, i: number) => {
+    if (positions[name]) return positions[name];
+    if (i === 0) return { x: 450, y: 250 };
+    const count = Math.max(1, names.length - 1);
+    const angle = (2 * Math.PI * (i - 1)) / count - Math.PI / 2;
+    const radius = 170 + ((i % 2) * 35);
+    const x = Math.round(450 + radius * Math.cos(angle) * 1.4);
+    const y = Math.round(250 + radius * Math.sin(angle) * 0.95);
+    return { x: Math.max(80, Math.min(820, x)), y: Math.max(40, Math.min(460, y)) };
+  };
   const move = (name: string, x: number, y: number) => setPositions(values => ({ ...values, [name]: { x: Math.max(100, Math.min(800, x)), y: Math.max(30, Math.min(470, y)) } }));
   return <section aria-label="관련 문서"><h3>관련 문서</h3>
     <div className="tools"><button aria-pressed={mode === 'list'} onClick={() => setMode('list')}>관련 목록</button><button aria-pressed={mode === 'graph'} onClick={() => setMode('graph')}>관계 그래프</button><button onClick={() => setPositions({})}>그래프 배치 초기화</button></div>
-    <p>직접 참조·포함과 공통 참조를 근거로 합니다. 문서 내용의 의미 유사도를 추론하지 않습니다.</p>
+    <p>직접 참조·포함과 공통 참조를 근거로 합니다. 더블 클릭하면 해당 문서를 엽니다.</p>
     {!index ? <p>새 관계 조사 결과를 기다리고 있습니다.</p> : <>
       {(model.truncated || index.partial) && <p role="note">일부 관계만 표시합니다. 관련 문서 최대 12개·문서별 근거 최대 5개입니다. 조사 범위 경고도 확인하세요.</p>}
       {!model.documents.length && <p>확인된 관련 문서가 없습니다.</p>}
       {mode === 'list' ? <ul>{model.documents.map(doc => <li key={doc.path}><button aria-pressed={focused === doc.path} onClick={() => setFocused(doc.path)}>관련 문서: {doc.path}</button></li>)}</ul> : <>
-        <p>실선: 직접 참조·포함 · 점선: 같은 대상을 참조하는 간접 관계. 노드를 선택하면 근거를 표시합니다. 드래그 또는 방향키는 화면 배치만 바꿉니다.</p>
+        <p>실선: 직접 참조·포함 · 점선: 같은 대상을 참조하는 간접 관계. 노드를 선택하면 근거를 표시하며 더블 클릭하면 바로 엽니다.</p>
         <div className="relation-graph" aria-label="관련 문서 그래프">
           <svg viewBox="0 0 900 500" preserveAspectRatio="none" aria-hidden="true">{model.documents.map((doc, i) => {
             const center = position(selected, 0), node = position(doc.path, i + 1);
             return <line key={doc.path} x1={center.x} y1={center.y} x2={node.x} y2={node.y} stroke="var(--secondary)" strokeWidth="2" strokeDasharray={doc.reasons.every(reason => reason.kind === 'common') ? '6 5' : undefined} />;
           })}</svg>
-          {names.map((name, i) => { const point = position(name, i); return <button key={name} className="graph-node" style={{ left: `${point.x / 9}%`, top: `${point.y / 5}%` }} aria-label={`그래프 문서: ${name}`} aria-pressed={focused === name} onClick={() => setFocused(name)} onKeyDown={event => {
+          {names.map((name, i) => { const point = position(name, i); return <button key={name} className="graph-node" style={{ left: `${point.x / 9}%`, top: `${point.y / 5}%` }} aria-label={`그래프 문서: ${name}`} aria-pressed={focused === name} onClick={() => setFocused(name)} onDoubleClick={() => open({ relativePath: name, line: 1 })} onKeyDown={event => {
             if (event.nativeEvent.isComposing || !['ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown'].includes(event.key)) return;
             event.preventDefault(); move(name, point.x + (event.key === 'ArrowLeft' ? -15 : event.key === 'ArrowRight' ? 15 : 0), point.y + (event.key === 'ArrowUp' ? -15 : event.key === 'ArrowDown' ? 15 : 0));
           }} onPointerDown={event => { if (event.button !== 0) return; event.preventDefault(); event.currentTarget.focus(); event.currentTarget.setPointerCapture(event.pointerId); drag.current = { path: name, x: point.x, y: point.y, startX: event.clientX, startY: event.clientY }; }} onPointerMove={event => {
diff --git a/apps/desktop/src/renderer/widgets/document-workspace/asciidoc-language.ts b/apps/desktop/src/renderer/widgets/document-workspace/asciidoc-language.ts
index 8b8bf77..1857698 100644
--- a/apps/desktop/src/renderer/widgets/document-workspace/asciidoc-language.ts
+++ b/apps/desktop/src/renderer/widgets/document-workspace/asciidoc-language.ts
@@ -1,4 +1,5 @@
-import { StreamLanguage, syntaxHighlighting, defaultHighlightStyle, foldService } from '@codemirror/language';
+import { StreamLanguage, syntaxHighlighting, defaultHighlightStyle, HighlightStyle, foldService } from '@codemirror/language';
+import { tags } from '@lezer/highlight';
 // Lexical editing aid only. Semantic sections and diagnostics come from Asciidoctor.
 export const asciidocLanguage = StreamLanguage.define({
   startState: () => ({ delimiter: '' }),
@@ -26,7 +27,24 @@ export const asciidocLanguage = StreamLanguage.define({
     stream.next(); return null;
   }
 });
-export const asciidocHighlighting = syntaxHighlighting(defaultHighlightStyle);
+
+export const asciidocHighlightStyle = HighlightStyle.define([
+  { tag: tags.heading, fontWeight: '700', color: 'var(--text)' },
+  { tag: tags.link, color: 'var(--secondary)', textDecoration: 'underline' },
+  { tag: tags.emphasis, fontStyle: 'italic' },
+  { tag: tags.strong, fontWeight: '700' },
+  { tag: tags.monospace, color: 'var(--secondary)' },
+  { tag: tags.keyword, color: 'var(--secondary)', fontWeight: '600' },
+  { tag: tags.propertyName, color: 'var(--primary-hover)', fontWeight: '500' },
+  { tag: tags.comment, color: 'var(--faint)', fontStyle: 'italic' },
+  { tag: tags.meta, color: 'var(--muted)' }
+]);
+
+export const asciidocHighlighting = [
+  syntaxHighlighting(asciidocHighlightStyle),
+  syntaxHighlighting(defaultHighlightStyle, { fallback: true })
+];
+
 
 export const asciidocFolding = foldService.of((state, lineStart) => {
   const line = state.doc.lineAt(lineStart);

From f63fb112b9a8c50a2599424576acb698cd77003c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EC=9C=A4=EC=9A=A9=EC=8B=9D?= <comnori@gmail.com>
Date: Fri, 2 Oct 2026 23:50:32 +0900
Subject: [PATCH 4/6] feat(ui-ux): add slash commands, attribute/link hover
 tooltips, and tab context menu

---
 apps/desktop/src/renderer/app/main.tsx        | 42 +++++++++-
 .../desktop/src/renderer/app/styles/style.css | 75 ++++++++++++++++++
 .../widgets/document-workspace/completions.ts | 29 ++++++-
 .../widgets/document-workspace/documents.tsx  | 76 +++++++++++++++++--
 .../document-core/src/completions.test.ts     | 27 +++++++
 5 files changed, 241 insertions(+), 8 deletions(-)

diff --git a/apps/desktop/src/renderer/app/main.tsx b/apps/desktop/src/renderer/app/main.tsx
index 5ed2e44..eb5d4ce 100644
--- a/apps/desktop/src/renderer/app/main.tsx
+++ b/apps/desktop/src/renderer/app/main.tsx
@@ -84,6 +84,20 @@ function App() {
   const [activeAnalysis, setActiveAnalysis] = useState<Analysis>();
   const [centerView, setCenterView] = useState<'documents' | 'graph'>('documents');
   const [graphOpen, setGraphOpen] = useState(false);
+  const [tabContextMenu, setTabContextMenu] = useState<{ x: number; y: number; path: string; isGraph?: boolean } | null>(null);
+  useEffect(() => {
+    if (!tabContextMenu) return;
+    const dismiss = (e: MouseEvent | KeyboardEvent) => {
+      if (e instanceof KeyboardEvent && e.key !== 'Escape') return;
+      setTabContextMenu(null);
+    };
+    window.addEventListener('click', dismiss);
+    window.addEventListener('keydown', dismiss);
+    return () => {
+      window.removeEventListener('click', dismiss);
+      window.removeEventListener('keydown', dismiss);
+    };
+  }, [tabContextMenu]);
   const [error, setError] = useState('');
   const [warning, setWarning] = useState('');
   const [status, setStatus] = useState('폴더를 열어 시작하세요.');
@@ -422,7 +436,33 @@ function App() {
     </aside>
     {leftVisible && !layout.narrow && <PanelResizer side="left" value={layout.value.left.width} min={180} max={420} resize={layout.resizeLeft} />}
     <main className="center-workspace" tabIndex={-1} aria-label="문서 작업 영역">
-      <div className="workspace-tabs" role="tablist" aria-label="열린 뷰" onKeyDown={event => { if (!['ArrowLeft', 'ArrowRight', 'Home', 'End'].includes(event.key)) return; const tabs = [...event.currentTarget.querySelectorAll<HTMLButtonElement>('[role=tab]')], index = tabs.indexOf(event.target as HTMLButtonElement); if (index < 0) return; event.preventDefault(); tabs[event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : Math.min(tabs.length - 1, Math.max(0, index + (event.key === 'ArrowRight' ? 1 : -1)))].focus(); tabs[event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : Math.min(tabs.length - 1, Math.max(0, index + (event.key === 'ArrowRight' ? 1 : -1)))].click(); }}>{documentTabs.map(tab => <div className={`workspace-tab ${centerView === 'documents' && document?.relativePath === tab.path ? 'active' : ''}`} key={tab.path} onAuxClick={event => { if (event.button === 1) { event.preventDefault(); void documents.current?.closeTab(tab.path); } }}><button role="tab" aria-selected={centerView === 'documents' && document?.relativePath === tab.path} title={tab.path} onClick={() => selectDocumentTab(tab.path)}>{tab.dirty ? '● ' : ''}{tab.path.split('/').at(-1)}</button><button className="tab-close" aria-label={`${tab.path} 탭 닫기`} onClick={() => void documents.current?.closeTab(tab.path)}>×</button></div>)}{graphOpen && <div className={`workspace-tab ${centerView === 'graph' ? 'active' : ''}`} onAuxClick={event => { if (event.button === 1) { event.preventDefault(); setGraphOpen(false); setCenterView('documents'); } }}><button role="tab" aria-selected={centerView === 'graph'} onClick={() => setCenterView('graph')}>◎ 그래프</button><button className="tab-close" aria-label="그래프 탭 닫기" onClick={() => { setGraphOpen(false); setCenterView('documents'); }}>×</button></div>}</div>
+      <div className="workspace-tabs" role="tablist" aria-label="열린 뷰" onKeyDown={event => { if (!['ArrowLeft', 'ArrowRight', 'Home', 'End'].includes(event.key)) return; const tabs = [...event.currentTarget.querySelectorAll<HTMLButtonElement>('[role=tab]')], index = tabs.indexOf(event.target as HTMLButtonElement); if (index < 0) return; event.preventDefault(); tabs[event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : Math.min(tabs.length - 1, Math.max(0, index + (event.key === 'ArrowRight' ? 1 : -1)))].focus(); tabs[event.key === 'Home' ? 0 : event.key === 'End' ? tabs.length - 1 : Math.min(tabs.length - 1, Math.max(0, index + (event.key === 'ArrowRight' ? 1 : -1)))].click(); }}>{documentTabs.map(tab => <div className={`workspace-tab ${centerView === 'documents' && document?.relativePath === tab.path ? 'active' : ''}`} key={tab.path} onContextMenu={event => { event.preventDefault(); setTabContextMenu({ x: event.clientX, y: event.clientY, path: tab.path }); }} onAuxClick={event => { if (event.button === 1) { event.preventDefault(); void documents.current?.closeTab(tab.path); } }}><button role="tab" aria-selected={centerView === 'documents' && document?.relativePath === tab.path} title={tab.path} onClick={() => selectDocumentTab(tab.path)}>{tab.dirty ? '● ' : ''}{tab.path.split('/').at(-1)}</button><button className="tab-close" aria-label={`${tab.path} 탭 닫기`} onClick={() => void documents.current?.closeTab(tab.path)}>×</button></div>)}{graphOpen && <div className={`workspace-tab ${centerView === 'graph' ? 'active' : ''}`} onContextMenu={event => { event.preventDefault(); setTabContextMenu({ x: event.clientX, y: event.clientY, path: 'graph', isGraph: true }); }} onAuxClick={event => { if (event.button === 1) { event.preventDefault(); setGraphOpen(false); setCenterView('documents'); } }}><button role="tab" aria-selected={centerView === 'graph'} onClick={() => setCenterView('graph')}>◎ 그래프</button><button className="tab-close" aria-label="그래프 탭 닫기" onClick={() => { setGraphOpen(false); setCenterView('documents'); }}>×</button></div>}</div>
+      {tabContextMenu && (
+        <div
+          className="tab-context-menu"
+          role="menu"
+          aria-label="탭 메뉴"
+          style={{ left: Math.min(window.innerWidth - 180, tabContextMenu.x), top: tabContextMenu.y }}
+          onClick={e => e.stopPropagation()}
+        >
+          {tabContextMenu.isGraph ? (
+            <>
+              <button role="menuitem" onClick={() => { setGraphOpen(false); setCenterView('documents'); setTabContextMenu(null); }}>그래프 탭 닫기</button>
+              <button role="menuitem" disabled={!documentTabs.length} onClick={() => { void documents.current?.closeAllTabs?.(); setTabContextMenu(null); }}>다른 문서 탭 모두 닫기</button>
+            </>
+          ) : (
+            <>
+              <button role="menuitem" onClick={() => { void documents.current?.closeTab(tabContextMenu.path); setTabContextMenu(null); }}>탭 닫기</button>
+              <button role="menuitem" disabled={documentTabs.length <= 1} onClick={() => { void documents.current?.closeOtherTabs?.(tabContextMenu.path); setTabContextMenu(null); }}>다른 탭 닫기</button>
+              <button role="menuitem" disabled={documentTabs.findIndex(t => t.path === tabContextMenu.path) === documentTabs.length - 1} onClick={() => { void documents.current?.closeTabsToRight?.(tabContextMenu.path); setTabContextMenu(null); }}>오른쪽 탭 닫기</button>
+              <button role="menuitem" onClick={() => { void documents.current?.closeAllTabs?.(); setTabContextMenu(null); }}>모든 탭 닫기</button>
+              <div className="menu-divider" />
+              <button role="menuitem" onClick={() => { void window.navigator?.clipboard?.writeText(tabContextMenu.path); setStatus(`${tabContextMenu.path} 경로를 복사했습니다.`); setTabContextMenu(null); }}>문서 경로 복사</button>
+              <button role="menuitem" onClick={() => { toggleFavorite(tabContextMenu.path); setTabContextMenu(null); }}>{favorites.includes(tabContextMenu.path) ? '★ 즐겨찾기 해제' : '☆ 즐겨찾기 추가'}</button>
+            </>
+          )}
+        </div>
+      )}
       {error && !creating && <div className="operation-status" data-phase="failed"><p role="alert"><strong>작업 실패</strong> — {error}</p><button onClick={() => setError('')}>오류 안내 닫기</button>{document && <details><summary>편집 보존·복구 작업</summary><p>저장·외부 변경 문제라면 현재 편집을 보존하고 원문 상태를 확인하세요.</p>{commandButton('document.preserve')}{commandButton('document.inspect')}{commandButton('recovery.open')}{commandButton('recovery.folder')}</details>}</div>}{warning && <div className="notice">{warning}</div>}
       <div className="document-workspace" hidden={centerView !== 'documents' || !document}><Documents inspectorTarget={inspectorTarget} appearance={appearance.value} stylesheetVersion={stylesheetVersion} favorites={favorites} onToggleFavorite={toggleFavorite} onCommandsChanged={() => updateCommands(value => value + 1)} ref={documents} session={session} onSource={entry => { void read({ name: entry.relativePath, relativePath: entry.relativePath, kind: 'document' }, entry.line); }} onActive={value => { reading.current++; setDocument(value); setActiveAnalysis(undefined); }} onAnalysis={(_path, analysis) => setActiveAnalysis(analysis)} onTabsChanged={(tabs) => setDocumentTabs(tabs)} onError={setError} onStatus={setStatus} onBusy={value => { locked.current = value; setBusy(value); }} /></div>
       {session && graphOpen && <div className="graph-tab-workspace" hidden={centerView !== 'graph'}><Relations embedded key={`${session.workspaceId}-${session.workspaceEpoch}-graph`} session={session} initialPath={document?.relativePath} initialMode="graph" close={() => { setGraphOpen(false); setCenterView('documents'); }} open={(source, revision) => { setCenterView('documents'); void read({ name: source.relativePath, relativePath: source.relativePath, kind: 'document' }, source.line, revision); }} /></div>}
diff --git a/apps/desktop/src/renderer/app/styles/style.css b/apps/desktop/src/renderer/app/styles/style.css
index f71b578..5f8173c 100644
--- a/apps/desktop/src/renderer/app/styles/style.css
+++ b/apps/desktop/src/renderer/app/styles/style.css
@@ -140,6 +140,81 @@ main { flex: 1; min-width: 0; display: flex; flex-direction: column; background:
 /* CodeMirror Link Hover Indicator */
 .cm-content.cm-ctrl-pressed .cm-link { cursor: pointer; text-decoration: underline; color: var(--secondary) !important; }
 
+/* CodeMirror Hover Tooltips */
+.cm-tooltip.cm-tooltip-asciidoc {
+  padding: 6px 10px;
+  background: var(--surface);
+  color: var(--text);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  box-shadow: 0 4px 14px rgba(0, 0, 0, 0.16);
+  font-size: 12px;
+  max-width: 320px;
+  line-height: 1.45;
+  pointer-events: none;
+  z-index: 100;
+}
+.cm-tooltip.cm-tooltip-asciidoc code {
+  color: var(--secondary);
+  background: var(--surface-hover);
+  padding: 1px 4px;
+  border-radius: 3px;
+  font-family: var(--document-font-family, monospace);
+  font-size: 0.9em;
+}
+.cm-tooltip.cm-tooltip-asciidoc .tooltip-title {
+  font-weight: 600;
+  margin-bottom: 2px;
+}
+.cm-tooltip.cm-tooltip-asciidoc .tooltip-body {
+  margin-bottom: 3px;
+  word-break: break-all;
+}
+.cm-tooltip.cm-tooltip-asciidoc .tooltip-meta {
+  font-size: 11px;
+  color: var(--muted);
+}
+
+/* Tab Context Menu */
+.tab-context-menu {
+  position: fixed;
+  z-index: 1000;
+  background: var(--surface);
+  color: var(--text);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  box-shadow: 0 6px 18px rgba(0, 0, 0, 0.18);
+  padding: 4px;
+  min-width: 160px;
+  display: flex;
+  flex-direction: column;
+  gap: 1px;
+}
+.tab-context-menu button {
+  text-align: left;
+  background: none;
+  border: none;
+  padding: 6px 12px;
+  font-size: 13px;
+  color: var(--text);
+  border-radius: 4px;
+  cursor: pointer;
+  width: 100%;
+}
+.tab-context-menu button:hover:not(:disabled) {
+  background: var(--secondary-soft);
+  color: var(--secondary);
+}
+.tab-context-menu button:disabled {
+  opacity: 0.4;
+  cursor: not-allowed;
+}
+.tab-context-menu .menu-divider {
+  height: 1px;
+  background: var(--border);
+  margin: 3px 0;
+}
+
 /* Dark Theme Specific Overrides */
 .app[data-theme="dark"] .cm-gutters { background: var(--canvas) !important; border-right-color: var(--border) !important; color: var(--muted) !important; }
 .app[data-theme="dark"] .cm-activeLine { background: rgba(88, 166, 255, .08) !important; }
diff --git a/apps/desktop/src/renderer/widgets/document-workspace/completions.ts b/apps/desktop/src/renderer/widgets/document-workspace/completions.ts
index 0e144de..d6c3353 100644
--- a/apps/desktop/src/renderer/widgets/document-workspace/completions.ts
+++ b/apps/desktop/src/renderer/widgets/document-workspace/completions.ts
@@ -6,9 +6,36 @@ export function relativeTarget(from: string, to: string) {
   return [...base.map(() => '..'), ...target].join('/');
 }
 export function complete(context: CompletionContext, path: string, analysis?: Analysis): CompletionResult | null {
-  if (!analysis) return null;
   const line = context.state.doc.lineAt(context.pos), before = line.text.slice(0, context.pos - line.from);
   const after = line.text.slice(context.pos - line.from);
+
+  const slashMatch = /(?:^|\s)\/([a-zA-Z0-9-]*)$/.exec(before);
+  if (slashMatch) {
+    const slashWord = slashMatch[1];
+    const slashFrom = context.pos - slashWord.length - 1;
+    const slashOptions = [
+      { label: '/note', apply: '[NOTE]\n====\n\n====\n', detail: '참고 경고문 (Note admonition)', type: 'keyword' },
+      { label: '/tip', apply: '[TIP]\n====\n\n====\n', detail: '팁 블록 (Tip admonition)', type: 'keyword' },
+      { label: '/warning', apply: '[WARNING]\n====\n\n====\n', detail: '경고 블록 (Warning admonition)', type: 'keyword' },
+      { label: '/important', apply: '[IMPORTANT]\n====\n\n====\n', detail: '중요 블록 (Important admonition)', type: 'keyword' },
+      { label: '/caution', apply: '[CAUTION]\n====\n\n====\n', detail: '주의 블록 (Caution admonition)', type: 'keyword' },
+      { label: '/code', apply: '[source]\n----\n\n----\n', detail: '소스 코드 블록 (Source code block)', type: 'keyword' },
+      { label: '/table', apply: '|===\n| 열 1 | 열 2\n\n| 항목 1 | 항목 2\n|===\n', detail: 'AsciiDoc 표 (Table)', type: 'keyword' },
+      { label: '/mermaid', apply: '[mermaid]\n----\nflowchart TD\n    A[시작] --> B[완료]\n----\n', detail: 'Mermaid 다이어그램 블록', type: 'keyword' },
+      { label: '/quote', apply: '[quote]\n____\n\n____\n', detail: '인용 블록 (Quote block)', type: 'keyword' },
+      { label: '/sidebar', apply: '****\n\n****\n', detail: '사이드바 블록 (Sidebar block)', type: 'keyword' },
+      { label: '/example', apply: '====\n\n====\n', detail: '예제 블록 (Example block)', type: 'keyword' },
+      { label: '/todo', apply: '* [ ] ', detail: '체크리스트 할 일 (Task checklist)', type: 'keyword' },
+      { label: '/h1', apply: '= ', detail: '문서 제목 / 레벨 1 제목', type: 'keyword' },
+      { label: '/h2', apply: '== ', detail: '섹션 제목 / 레벨 2 제목', type: 'keyword' },
+      { label: '/h3', apply: '=== ', detail: '소제목 / 레벨 3 제목', type: 'keyword' },
+      { label: '/include', apply: 'include::[]', detail: '문서 포함 지시자 (Include)', type: 'keyword' },
+      { label: '/xref', apply: 'xref:[]', detail: '문서 상호 참조 (Cross reference)', type: 'keyword' }
+    ];
+    return { from: slashFrom, options: slashOptions, validFor: /^\/[a-zA-Z0-9-]*$/ };
+  }
+
+  if (!analysis) return null;
   const macro = /(include::|xref:)([^\s\[]*)$/.exec(before), short = /<<([^>,]*)$/.exec(before), attr = /(?<!\\)\{([\w-]*)$/.exec(before);
   if (!macro && !short && !attr) return null;
   const prefix = attr?.[1] ?? macro?.[2] ?? short![1];
diff --git a/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx b/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
index 80cd5eb..7151a6a 100644
--- a/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
+++ b/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
@@ -1,6 +1,6 @@
 import React, { forwardRef, useEffect, useImperativeHandle, useRef, useState } from 'react';
 import { EditorState, EditorSelection, Compartment } from '@codemirror/state';
-import { EditorView, keymap, lineNumbers } from '@codemirror/view';
+import { EditorView, keymap, lineNumbers, hoverTooltip } from '@codemirror/view';
 import { history, historyKeymap, defaultKeymap, undo, redo } from '@codemirror/commands';
 import { foldGutter, foldKeymap } from '@codemirror/language';
 import type { DocumentSnapshot, Session } from '@metis/contracts';
@@ -19,26 +19,26 @@ interface Tab { previewPosition?: PreviewPosition; baseline: DocumentSnapshot; t
 const dirty = (tab: Tab) => tab.text !== normalized(tab.baseline.text) || !!tab.external?.missing;
 interface Visit { path: string; text: string; selection: ReturnType<EditorSelection['toJSON']>; top: number; left: number; mode: 'source' | 'split' | 'preview' }
 export interface DocumentTabSnapshot { path: string; dirty: boolean }
-export interface DocumentsHandle { extensionModel(): import('@metis/contracts').ExtensionModel | undefined; commands(): Command[]; open(document: DocumentSnapshot, line?: number): void; activate(path: string): void; closeTab(path: string): Promise<void>; draft(path: string): string | undefined; restoreDraft(disk: DocumentSnapshot, text: string, expectedDraft: string | undefined): Promise<string | undefined>; isDirty(path: string): boolean; fileChanged(source: string, destination: string, affected: string[]): void; clear(): void; allowLeave(): Promise<boolean> }
+export interface DocumentsHandle { extensionModel(): import('@metis/contracts').ExtensionModel | undefined; commands(): Command[]; open(document: DocumentSnapshot, line?: number): void; activate(path: string): void; closeTab(path: string): Promise<void>; closeOtherTabs?(path: string): Promise<void>; closeTabsToRight?(path: string): Promise<void>; closeAllTabs?(): Promise<void>; draft(path: string): string | undefined; restoreDraft(disk: DocumentSnapshot, text: string, expectedDraft: string | undefined): Promise<string | undefined>; isDirty(path: string): boolean; fileChanged(source: string, destination: string, affected: string[]): void; clear(): void; allowLeave(): Promise<boolean> }
 function jump(tab: Tab, line: number) {
   if (!tab.view) { tab.jumpLine = line; return; }
   const position = tab.view.state.doc.line(Math.max(1, Math.min(tab.view.state.doc.lines, line))).from;
   tab.view.dispatch({ selection: { anchor: position }, effects: EditorView.scrollIntoView(position, { y: 'center' }) });
   tab.view.focus();
 }
-function findLinkAt(text: string, col: number) {
+function findLinkAt(text: string, col: number): { path?: string; anchor?: string; label?: string; start: number; end: number } | null {
   const xrefRegex = /xref:([^\s\[]+)(?:\[(.*?)\])?/g;
   let match;
   while ((match = xrefRegex.exec(text)) !== null) {
     if (col >= match.index && col <= match.index + match[0].length) {
       const [path, anchor] = match[1].split('#');
-      return { path: path || undefined, anchor, label: match[2] };
+      return { path: path || undefined, anchor, label: match[2], start: match.index, end: match.index + match[0].length };
     }
   }
   const includeRegex = /include::([^\s\[]+)\[(.*?)\]/g;
   while ((match = includeRegex.exec(text)) !== null) {
     if (col >= match.index && col <= match.index + match[0].length) {
-      return { path: match[1], label: match[2] };
+      return { path: match[1], label: match[2], start: match.index, end: match.index + match[0].length };
     }
   }
   const anchorRegex = /<<([^\s>,]+)(?:,\s*([^>]*))?>>/g;
@@ -46,11 +46,59 @@ function findLinkAt(text: string, col: number) {
     if (col >= match.index && col <= match.index + match[0].length) {
       const raw = match[1];
       const [path, anchor] = raw.includes('#') ? raw.split('#') : ['', raw];
-      return { path: path || undefined, anchor, label: match[2] };
+      return { path: path || undefined, anchor, label: match[2], start: match.index, end: match.index + match[0].length };
     }
   }
   return null;
 }
+function asciidocHoverTooltip(tab: Tab) {
+  return hoverTooltip((view, pos) => {
+    const line = view.state.doc.lineAt(pos);
+    const col = pos - line.from;
+    const text = line.text;
+
+    const attrRegex = /(?<!\\)\{([\w-]+)\}/g;
+    let match;
+    while ((match = attrRegex.exec(text)) !== null) {
+      if (col >= match.index && col <= match.index + match[0].length) {
+        const attrName = match[1];
+        const attr = tab.analysis?.attributes.find(a => a.name === attrName && a.applied);
+        return {
+          pos: line.from + match.index,
+          end: line.from + match.index + match[0].length,
+          above: true,
+          create() {
+            const dom = document.createElement('div');
+            dom.className = 'cm-tooltip-asciidoc';
+            if (attr) {
+              dom.innerHTML = `<div class="tooltip-title">속성 <code>{${attrName}}</code></div><div class="tooltip-body">${attr.value}</div><div class="tooltip-meta">${attr.relativePath}:${attr.line}</div>`;
+            } else {
+              dom.innerHTML = `<div class="tooltip-title">속성 <code>{${attrName}}</code></div><div class="tooltip-meta">정의되지 않았거나 미적용 속성</div>`;
+            }
+            return { dom };
+          }
+        };
+      }
+    }
+
+    const link = findLinkAt(text, col);
+    if (link) {
+      return {
+        pos: line.from + link.start,
+        end: line.from + link.end,
+        above: true,
+        create() {
+          const dom = document.createElement('div');
+          dom.className = 'cm-tooltip-asciidoc';
+          const targetStr = link.path ? (link.anchor ? `${link.path}#${link.anchor}` : link.path) : `#${link.anchor}`;
+          dom.innerHTML = `<div class="tooltip-title">링크 대상: <code>${targetStr}</code></div><div class="tooltip-meta">Ctrl+클릭하여 바로 이동</div>`;
+          return { dom };
+        }
+      };
+    }
+    return null;
+  });
+}
 function resolveDocPath(fromDoc: string, targetPath: string): string {
   if (!targetPath) return fromDoc;
   const parts = fromDoc.includes('/') ? fromDoc.split('/').slice(0, -1) : [];
@@ -72,6 +120,7 @@ function Editor({ tab, changed, save, onSource, onJump }: { tab: Tab; changed():
     tab.view = new EditorView({ parent: element.current!, state: EditorState.create({ doc: tab.text, extensions: [
       lineNumbers(), foldGutter(), asciidocFolding, history(), asciidocLanguage, asciidocHighlighting,
       autocompletion({ override: [context => complete(context, tab.baseline.relativePath, tab.analysis)] }),
+      asciidocHoverTooltip(tab),
       keymap.of([{ key: 'Mod-s', run: () => { saveCurrent.current(); return true; } }, ...defaultKeymap, ...historyKeymap, ...foldKeymap]),
       access.current.of([EditorState.readOnly.of(readonly), EditorView.editable.of(!readonly)]), EditorView.lineWrapping,
       EditorView.contentAttributes.of({ 'aria-label': '문서 편집기' }),
@@ -294,6 +343,21 @@ export const Documents = forwardRef<DocumentsHandle, { session?: Session; inspec
     },
     activate(path) { const tab = tabs.current.get(path); if (!tab || path === activeRef.current) return; remember(); select(path); current.current.onActive(tab.baseline); changed(); },
     closeTab: close,
+    async closeOtherTabs(path: string) {
+      for (const p of Array.from(tabs.current.keys())) {
+        if (p !== path) await close(p);
+      }
+    },
+    async closeTabsToRight(path: string) {
+      const allPaths = Array.from(tabs.current.keys());
+      const idx = allPaths.indexOf(path);
+      if (idx >= 0) {
+        for (const p of allPaths.slice(idx + 1)) await close(p);
+      }
+    },
+    async closeAllTabs() {
+      for (const p of Array.from(tabs.current.keys())) await close(p);
+    },
     clear() { tabs.current.clear(); back.current = []; forward.current = []; setReview(undefined); select(''); props.onActive(undefined); changed(); }, allowLeave
   }));
   async function save(path: string) {
diff --git a/packages/document-core/src/completions.test.ts b/packages/document-core/src/completions.test.ts
index 7b371a8..8380cf7 100644
--- a/packages/document-core/src/completions.test.ts
+++ b/packages/document-core/src/completions.test.ts
@@ -18,3 +18,30 @@ test.each([
   expect(result.options.find(option => option.label === label)?.apply).toBe(apply);
   expect(result.from).toBe(before.length - (before.match(/\{([\w-]*)$/)?.[1].length ?? before.match(/(?:include::|xref:|<<)(.*)$/)?.[1].length ?? 0));
 });
+
+test('slash command completions trigger on / and provide AsciiDoc templates', () => {
+  const contextSlash = new CompletionContext(EditorState.create({ doc: '/' }), 1, true);
+  const resultSlash = complete(contextSlash, 'docs/main.adoc');
+  expect(resultSlash).not.toBeNull();
+  expect(resultSlash!.from).toBe(0);
+  expect(resultSlash!.options.some(o => o.label === '/note')).toBe(true);
+  expect(resultSlash!.options.some(o => o.label === '/table')).toBe(true);
+  expect(resultSlash!.options.some(o => o.label === '/todo')).toBe(true);
+
+  const contextNote = new CompletionContext(EditorState.create({ doc: '/not' }), 4, true);
+  const resultNote = complete(contextNote, 'docs/main.adoc')!;
+  const noteOpt = resultNote.options.find(o => o.label === '/note');
+  expect(noteOpt?.apply).toBe('[NOTE]\n====\n\n====\n');
+  expect(resultNote.from).toBe(0);
+
+  const contextIndent = new CompletionContext(EditorState.create({ doc: '   /tip' }), 7, true);
+  const resultIndent = complete(contextIndent, 'docs/main.adoc')!;
+  expect(resultIndent.from).toBe(3);
+
+  // Comments like // and URLs like http://... should NOT trigger slash commands
+  const contextComment = new CompletionContext(EditorState.create({ doc: '//' }), 2, true);
+  expect(complete(contextComment, 'docs/main.adoc')).toBeNull();
+
+  const contextUrl = new CompletionContext(EditorState.create({ doc: 'https://example.com/' }), 20, true);
+  expect(complete(contextUrl, 'docs/main.adoc')).toBeNull();
+});

From 83370d2ec3d5707bfde3bd2266561b64f14aa4cf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EC=9C=A4=EC=9A=A9=EC=8B=9D?= <comnori@gmail.com>
Date: Fri, 2 Oct 2026 23:55:50 +0900
Subject: [PATCH 5/6] feat(ui-ux): add real-time cursor line/col and
 word/character count to status bar

---
 apps/desktop/src/renderer/app/main.tsx        |  5 ++-
 .../widgets/document-workspace/documents.tsx  | 38 ++++++++++++++++---
 2 files changed, 36 insertions(+), 7 deletions(-)

diff --git a/apps/desktop/src/renderer/app/main.tsx b/apps/desktop/src/renderer/app/main.tsx
index eb5d4ce..85d38da 100644
--- a/apps/desktop/src/renderer/app/main.tsx
+++ b/apps/desktop/src/renderer/app/main.tsx
@@ -84,6 +84,7 @@ function App() {
   const [activeAnalysis, setActiveAnalysis] = useState<Analysis>();
   const [centerView, setCenterView] = useState<'documents' | 'graph'>('documents');
   const [graphOpen, setGraphOpen] = useState(false);
+  const [editorStats, setEditorStats] = useState<{ line: number; col: number; words: number; chars: number }>();
   const [tabContextMenu, setTabContextMenu] = useState<{ x: number; y: number; path: string; isGraph?: boolean } | null>(null);
   useEffect(() => {
     if (!tabContextMenu) return;
@@ -464,7 +465,7 @@ function App() {
         </div>
       )}
       {error && !creating && <div className="operation-status" data-phase="failed"><p role="alert"><strong>작업 실패</strong> — {error}</p><button onClick={() => setError('')}>오류 안내 닫기</button>{document && <details><summary>편집 보존·복구 작업</summary><p>저장·외부 변경 문제라면 현재 편집을 보존하고 원문 상태를 확인하세요.</p>{commandButton('document.preserve')}{commandButton('document.inspect')}{commandButton('recovery.open')}{commandButton('recovery.folder')}</details>}</div>}{warning && <div className="notice">{warning}</div>}
-      <div className="document-workspace" hidden={centerView !== 'documents' || !document}><Documents inspectorTarget={inspectorTarget} appearance={appearance.value} stylesheetVersion={stylesheetVersion} favorites={favorites} onToggleFavorite={toggleFavorite} onCommandsChanged={() => updateCommands(value => value + 1)} ref={documents} session={session} onSource={entry => { void read({ name: entry.relativePath, relativePath: entry.relativePath, kind: 'document' }, entry.line); }} onActive={value => { reading.current++; setDocument(value); setActiveAnalysis(undefined); }} onAnalysis={(_path, analysis) => setActiveAnalysis(analysis)} onTabsChanged={(tabs) => setDocumentTabs(tabs)} onError={setError} onStatus={setStatus} onBusy={value => { locked.current = value; setBusy(value); }} /></div>
+      <div className="document-workspace" hidden={centerView !== 'documents' || !document}><Documents inspectorTarget={inspectorTarget} appearance={appearance.value} stylesheetVersion={stylesheetVersion} favorites={favorites} onToggleFavorite={toggleFavorite} onCommandsChanged={() => updateCommands(value => value + 1)} ref={documents} session={session} onSource={entry => { void read({ name: entry.relativePath, relativePath: entry.relativePath, kind: 'document' }, entry.line); }} onActive={value => { reading.current++; setDocument(value); setActiveAnalysis(undefined); if (!value) setEditorStats(undefined); }} onStats={setEditorStats} onAnalysis={(_path, analysis) => setActiveAnalysis(analysis)} onTabsChanged={(tabs) => setDocumentTabs(tabs)} onError={setError} onStatus={setStatus} onBusy={value => { locked.current = value; setBusy(value); }} /></div>
       {session && graphOpen && <div className="graph-tab-workspace" hidden={centerView !== 'graph'}><Relations embedded key={`${session.workspaceId}-${session.workspaceEpoch}-graph`} session={session} initialPath={document?.relativePath} initialMode="graph" close={() => { setGraphOpen(false); setCenterView('documents'); }} open={(source, revision) => { setCenterView('documents'); void read({ name: source.relativePath, relativePath: source.relativePath, kind: 'document' }, source.line, revision); }} /></div>}
       {centerView === 'documents' && !document &&
       <div className="empty"><div className="mark">M</div><h1>{session ? '작업 공간을 열었습니다.' : '문서가 있는 곳에서 시작하세요.'}</h1>
@@ -479,7 +480,7 @@ function App() {
       {layout.value.right.active === 'relations' && <section aria-label="문서 관계"><h2>관계</h2>{activeAnalysis?.relations.length ? activeAnalysis.relations.map((item, index) => <button className="inspector-item" key={index} onClick={() => void read({ name: item.destination?.relativePath ?? item.relativePath, relativePath: item.destination?.relativePath ?? item.relativePath, kind: 'document' }, item.destination?.line ?? item.line)}>{item.kind === 'xref' ? '참조' : '포함'} · {item.target}</button>) : <p>활성 문서에서 해석된 관계가 없습니다.</p>}</section>}
       {layout.value.right.active === 'diagnostics' && <section aria-label="문서 진단"><h2>진단</h2>{activeAnalysis?.diagnostics.length ? activeAnalysis.diagnostics.map((item, index) => <button className="inspector-item" key={index} onClick={() => void read({ name: item.relativePath, relativePath: item.relativePath, kind: 'document' }, item.line)}>{item.line} · {item.message}</button>) : <p>활성 문서의 진단이 없습니다.</p>}</section>}
     </div></aside>
-    {settingsOpen && <ViewSettings value={layout.value} update={layout.update} appearance={appearance.value} updateAppearance={appearance.update} workspace={!!session} stylesheet={stylesheet} selectStylesheet={selectStylesheet} reloadStylesheet={reloadStylesheet} clearStylesheet={clearStylesheet} warning={[layout.warning, appearance.warning].filter(Boolean).join(' ')} close={() => setSettingsOpen(false)} />}<footer role="status"><span className="footer-status-text">{error ? '작업 실패 · 오류 안내와 해결 행동을 확인하세요.' : busy ? '작업 진행 중 · 완료될 때까지 기다려 주세요.' : status}</span>{document && <span className="footer-document-stats"><span className="footer-stat-badge">UTF-8{document.bom ? ' BOM' : ''}</span><span className="footer-stat-badge">{document.eol.toUpperCase()}</span><span className="footer-stat-badge">{document.readOnly ? '읽기 전용' : '편집 가능'}</span></span>}</footer>{paletteOpen && <CommandPalette commands={commands} close={() => setPaletteOpen(false)} execute={id => { void dispatch(id); }} />}
+    {settingsOpen && <ViewSettings value={layout.value} update={layout.update} appearance={appearance.value} updateAppearance={appearance.update} workspace={!!session} stylesheet={stylesheet} selectStylesheet={selectStylesheet} reloadStylesheet={reloadStylesheet} clearStylesheet={clearStylesheet} warning={[layout.warning, appearance.warning].filter(Boolean).join(' ')} close={() => setSettingsOpen(false)} />}<footer role="status"><span className="footer-status-text">{error ? '작업 실패 · 오류 안내와 해결 행동을 확인하세요.' : busy ? '작업 진행 중 · 완료될 때까지 기다려 주세요.' : status}</span>{document && <span className="footer-document-stats">{editorStats && <span className="footer-stat-badge">{editorStats.words.toLocaleString()} 단어 · {editorStats.chars.toLocaleString()} 자</span>}{editorStats && <span className="footer-stat-badge">줄 {editorStats.line}, 열 {editorStats.col}</span>}<span className="footer-stat-badge">UTF-8{document.bom ? ' BOM' : ''}</span><span className="footer-stat-badge">{document.eol.toUpperCase()}</span><span className="footer-stat-badge">{document.readOnly ? '읽기 전용' : '편집 가능'}</span></span>}</footer>{paletteOpen && <CommandPalette commands={commands} close={() => setPaletteOpen(false)} execute={id => { void dispatch(id); }} />}
     {helpOpen && <GettingStarted workspace={session?.name} documentPath={document?.relativePath} readOnly={session?.readOnly} close={() => setHelpOpen(false)} showHints={() => { setHintsHidden(false); setHelpOpen(false); setStatus('시작 화면 안내를 다시 표시합니다. 문서가 열려 있으면 탭을 닫은 빈 화면에서 확인하세요.'); }} />}
     {extensionsOpen && <ExtensionsPanel runtime={extensions} close={() => setExtensionsOpen(false)} />}
     {extensionView && <ExtensionView key={`${extensionView.owner}-${extensionView.id}`} runtime={extensions} {...extensionView} close={() => setExtensionView(undefined)} />}
diff --git a/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx b/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
index 7151a6a..c7d80ac 100644
--- a/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
+++ b/apps/desktop/src/renderer/widgets/document-workspace/documents.tsx
@@ -109,14 +109,18 @@ function resolveDocPath(fromDoc: string, targetPath: string): string {
   }
   return parts.join('/');
 }
-function Editor({ tab, changed, save, onSource, onJump }: { tab: Tab; changed(): void; save(): void; onSource?(entry: OutlineEntry): void; onJump?(line: number): void }) {
+function Editor({ tab, changed, save, onSource, onJump, onStats }: { tab: Tab; changed(): void; save(): void; onSource?(entry: OutlineEntry): void; onJump?(line: number): void; onStats?(stats: { line: number; col: number; words: number; chars: number }): void }) {
   const saveCurrent = useRef(save); saveCurrent.current = save;
   const onSourceCurrent = useRef(onSource); onSourceCurrent.current = onSource;
   const onJumpCurrent = useRef(onJump); onJumpCurrent.current = onJump;
+  const onStatsCurrent = useRef(onStats); onStatsCurrent.current = onStats;
   const element = useRef<HTMLDivElement>(null);
   const access = useRef(new Compartment());
   useEffect(() => {
     const readonly = !!tab.baseline.readOnly || tab.baseline.eol === 'mixed';
+    const initText = tab.text;
+    const initWords = initText.trim() ? initText.trim().split(/\s+/).length : 0;
+    onStatsCurrent.current?.({ line: 1, col: 1, words: initWords, chars: initText.length });
     tab.view = new EditorView({ parent: element.current!, state: EditorState.create({ doc: tab.text, extensions: [
       lineNumbers(), foldGutter(), asciidocFolding, history(), asciidocLanguage, asciidocHighlighting,
       autocompletion({ override: [context => complete(context, tab.baseline.relativePath, tab.analysis)] }),
@@ -151,7 +155,17 @@ function Editor({ tab, changed, save, onSource, onJump }: { tab: Tab; changed():
           }
         }
       }),
-      EditorView.updateListener.of(update => { if (update.docChanged) { tab.text = update.state.doc.toString(); changed(); } })] }) });
+      EditorView.updateListener.of(update => {
+        if (update.docChanged) { tab.text = update.state.doc.toString(); changed(); }
+        if (update.docChanged || update.selectionSet) {
+          const head = update.state.selection.main.head;
+          const line = update.state.doc.lineAt(head);
+          const col = head - line.from + 1;
+          const text = update.state.doc.toString();
+          const words = text.trim() ? text.trim().split(/\s+/).length : 0;
+          onStatsCurrent.current?.({ line: line.number, col, words, chars: text.length });
+        }
+      })] }) });
     if (tab.jumpLine) { jump(tab, tab.jumpLine); tab.jumpLine = undefined; }
     return () => { tab.view?.destroy(); tab.view = undefined; };
   }, [tab]);
@@ -159,7 +173,7 @@ function Editor({ tab, changed, save, onSource, onJump }: { tab: Tab; changed():
   return <div className="source" ref={element} />;
 }
 
-export const Documents = forwardRef<DocumentsHandle, { session?: Session; inspectorTarget?: HTMLElement | null; appearance: WorkspaceAppearanceV1; stylesheetVersion: number; favorites: string[]; onToggleFavorite(path: string): void; onSource(entry: OutlineEntry): void; onActive(document?: DocumentSnapshot): void; onAnalysis(path: string, analysis: Analysis): void; onTabsChanged(tabs: DocumentTabSnapshot[], active: string): void; onError(message: string): void; onStatus(message: string): void; onBusy(value: boolean): void; onCommandsChanged(): void }>(function Documents(props, ref) {
+export const Documents = forwardRef<DocumentsHandle, { session?: Session; inspectorTarget?: HTMLElement | null; appearance: WorkspaceAppearanceV1; stylesheetVersion: number; favorites: string[]; onToggleFavorite(path: string): void; onSource(entry: OutlineEntry): void; onActive(document?: DocumentSnapshot): void; onStats?(stats: { line: number; col: number; words: number; chars: number } | undefined): void; onAnalysis(path: string, analysis: Analysis): void; onTabsChanged(tabs: DocumentTabSnapshot[], active: string): void; onError(message: string): void; onStatus(message: string): void; onBusy(value: boolean): void; onCommandsChanged(): void }>(function Documents(props, ref) {
   const tabs = useRef(new Map<string, Tab>());
   const [active, setActive] = useState('');
   const activeRef = useRef('');
@@ -192,7 +206,21 @@ export const Documents = forwardRef<DocumentsHandle, { session?: Session; inspec
     if (!session || current.current.session !== session) return;
     await window.metis.deleteDraft({ requestId: crypto.randomUUID(), workspaceId: session.workspaceId, workspaceEpoch: session.workspaceEpoch, relativePath: path }).catch(() => undefined);
   }
-  const select = (path: string) => { activeRef.current = path; setActive(path); };
+  const select = (path: string) => {
+    activeRef.current = path; setActive(path);
+    if (current.current.onStats) {
+      const tab = tabs.current.get(path);
+      if (tab) {
+        const text = tab.text;
+        const words = text.trim() ? text.trim().split(/\s+/).length : 0;
+        const head = tab.view?.state.selection.main.head ?? 0;
+        const line = tab.view ? tab.view.state.doc.lineAt(head) : { number: 1, from: 0 };
+        current.current.onStats({ line: line.number, col: head - line.from + 1, words, chars: text.length });
+      } else {
+        current.current.onStats(undefined);
+      }
+    }
+  };
   function location(): Visit | undefined {
     const tab = tabs.current.get(active), view = tab?.view;
     if (!tab || !view) return;
@@ -425,7 +453,7 @@ export const Documents = forwardRef<DocumentsHandle, { session?: Session; inspec
     {selected?.external && <div className="external-change" role="status">{selected.external.message}<div className="tools">{selected.external.disk && <button disabled={saving.current} onClick={() => setReview({ tab: selected, disk: selected.external!.disk! })}>변경 비교</button>}<button disabled={saving.current} onClick={() => runDocumentCommand('document.inspect')}>다시 확인</button></div><div className="copy-controls"><input aria-label="사본 파일 이름" value={copyName} onChange={event => setCopyName(event.target.value)} /><button disabled={saving.current || !validFolderName(copyName) || !/\.adoc$/i.test(copyName)} onClick={() => keepOrCopy(selected, true)}>다른 이름으로 저장</button></div></div>}
     {review && <Conflict baseline={review.tab.baseline} disk={review.disk} text={review.tab.text} close={() => setReview(undefined)} resolve={resolve} />}
     <div className={`document-body mode-${mode}`}>
-      <div className="editors" hidden={mode === 'preview'}>{[...tabs.current].map(([path, tab]) => <div className="editor-panel" hidden={path !== active} key={path}><Editor tab={tab} changed={() => { scheduleDraft(tab); changed(); }} save={() => void runDocumentCommand('document.save')} onSource={props.onSource} onJump={line => jump(tab, line)} /></div>)}</div>
+      <div className="editors" hidden={mode === 'preview'}>{[...tabs.current].map(([path, tab]) => <div className="editor-panel" hidden={path !== active} key={path}><Editor tab={tab} changed={() => { scheduleDraft(tab); changed(); }} save={() => void runDocumentCommand('document.save')} onSource={props.onSource} onJump={line => jump(tab, line)} onStats={stats => { if (path === activeRef.current) current.current.onStats?.(stats); }} /></div>)}</div>
       {selected && props.session && <Preview appearance={props.appearance} stylesheetVersion={props.stylesheetVersion} inspector={false} inspectorTarget={props.inspectorTarget} key={active} position={selected.previewPosition ??= { x: 0, y: 0, outline: 0 }} editorLine={() => selected.view?.state.doc.lineAt(selected.view.state.selection.main.head).number ?? 1} reveal={() => setMode('split')} session={props.session} relativePath={active} text={selected.text} mode={mode} onAnalysis={value => { selected.analysis = value; selected.analysisText = analyzedText; props.onAnalysis(active, value); }} navigate={entry => { setMode('split'); if (entry.relativePath === active) jump(selected, entry.line); else props.onSource(entry); }} />}
     </div>
 

From a6d2851f9a2347a8d4f8a3905d0111d04856ca8d Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=EC=9C=A4=EC=9A=A9=EC=8B=9D?= <comnori@gmail.com>
Date: Mon, 5 Oct 2026 21:30:05 +0900
Subject: [PATCH 6/6] chore: prepare v0.2.5 patch and localize Git workflow
 docs

---
 .gitignore                             |  1 -
 apps/desktop/package.json              |  2 +-
 doc/README.ko.adoc                     |  4 ++--
 doc/diagrams/git-policy-ko.mmd         |  9 +++++++++
 doc/diagrams/git-policy-ko.svg         |  2 ++
 doc/diagrams/git-policy.mmd            | 16 ++++++++--------
 doc/diagrams/git-policy.svg            |  4 ++--
 doc/git-strategy.adoc                  |  4 ++--
 {docs => doc}/renderer-architecture.md |  0
 package-lock.json                      | 14 +++++++-------
 package.json                           |  2 +-
 packages/contracts/package.json        |  2 +-
 packages/document-core/package.json    |  2 +-
 packages/knowledge-index/package.json  |  2 +-
 packages/workspace/package.json        |  2 +-
 15 files changed, 38 insertions(+), 28 deletions(-)
 create mode 100644 doc/diagrams/git-policy-ko.mmd
 create mode 100644 doc/diagrams/git-policy-ko.svg
 rename {docs => doc}/renderer-architecture.md (100%)

diff --git a/.gitignore b/.gitignore
index a1be097..44a48ed 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,5 +8,4 @@
 /apps/desktop/dist/
 /.pre04-runs/
 /docs/*
-!/docs/renderer-architecture.md
 /tsconfig.tsbuildinfo
diff --git a/apps/desktop/package.json b/apps/desktop/package.json
index fbc21b1..ad2cfb4 100644
--- a/apps/desktop/package.json
+++ b/apps/desktop/package.json
@@ -1,4 +1,4 @@
 {
-  "name": "@metis/desktop", "version": "0.2.4", "private": true,
+  "name": "@metis/desktop", "version": "0.2.5", "private": true,
   "main": "dist/main/main.cjs"
 }
diff --git a/doc/README.ko.adoc b/doc/README.ko.adoc
index 3bc88ed..f246dcc 100644
--- a/doc/README.ko.adoc
+++ b/doc/README.ko.adoc
@@ -105,9 +105,9 @@ $metisPackage = Get-Content .pre04-runs/latest-package.txt
 
 `main` 중심으로 개발하며 짧은 작업 브랜치와 PR은 필요할 때 사용합니다. 작은 변경은 `main`에 직접 push할 수 있고, 검토나 자동 Core 검사가 필요하면 PR을 만듭니다. 이 구성은 브랜치 보호를 강제하지 않습니다.
 
-image::diagrams/git-policy.svg[Git workflow]
+image::diagrams/git-policy-ko.svg[Git workflow]
 
-link:diagrams/git-policy.mmd[Mermaid source]
+link:diagrams/git-policy-ko.mmd[Mermaid source]
 
 [cols="1,3,3",options="header"]
 |===
diff --git a/doc/diagrams/git-policy-ko.mmd b/doc/diagrams/git-policy-ko.mmd
new file mode 100644
index 0000000..146b336
--- /dev/null
+++ b/doc/diagrams/git-policy-ko.mmd
@@ -0,0 +1,9 @@
+flowchart TD
+    Change["개발 변경"] --> Main["main 직접 push"]
+    Change --> PR["선택적으로 main 대상 PR 생성"]
+    PR --> Core["Core 자동 실행 · Windows / macOS / Linux"]
+    Manual["Desktop Full 수동 실행"] --> Target["main 또는 열린 PR의 병합 커밋"]
+    Target --> Full["Core + 개발 앱·패키지 통합 검사 · 3개 OS"]
+    Release["main에서 Desktop release 수동 실행"] --> Bump["patch / minor / major 선택"]
+    Bump --> Verify["Core · 패키징 · 보안 검증"]
+    Verify --> Publish["버전 커밋 + v태그 + GitHub Release"]
diff --git a/doc/diagrams/git-policy-ko.svg b/doc/diagrams/git-policy-ko.svg
new file mode 100644
index 0000000..5f35945
--- /dev/null
+++ b/doc/diagrams/git-policy-ko.svg
@@ -0,0 +1,2 @@
+<!-- Mermaid source SHA-256: a59c7edb6a5c8395bc4a696bb6691210dd11bf2891328c6c93660626080c56a6 -->
+<svg xmlns="http://www.w3.org/2000/svg" id="git-policy" width="744" class="flowchart" style="max-width: 744px;" viewBox="4 4 744 544" role="graphics-document document" aria-roledescription="flowchart-v2" height="544"><style>#git-policy{font-family:Arial,"Malgun Gothic",sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#git-policy .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#git-policy .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#git-policy .error-icon{fill:#552222;}#git-policy .error-text{fill:#552222;stroke:#552222;}#git-policy .edge-thickness-normal{stroke-width:1px;}#git-policy .edge-thickness-thick{stroke-width:3.5px;}#git-policy .edge-pattern-solid{stroke-dasharray:0;}#git-policy .edge-thickness-invisible{stroke-width:0;fill:none;}#git-policy .edge-pattern-dashed{stroke-dasharray:3;}#git-policy .edge-pattern-dotted{stroke-dasharray:2;}#git-policy .marker{fill:#333333;stroke:#333333;}#git-policy .marker.cross{stroke:#333333;}#git-policy svg{font-family:Arial,"Malgun Gothic",sans-serif;font-size:16px;}#git-policy p{margin:0;}#git-policy .label{font-family:Arial,"Malgun Gothic",sans-serif;color:#333;}#git-policy .cluster-label text{fill:#333;}#git-policy .cluster-label span{color:#333;}#git-policy .cluster-label span p{background-color:transparent;}#git-policy .label text,#git-policy span{fill:#333;color:#333;}#git-policy .node rect,#git-policy .node circle,#git-policy .node ellipse,#git-policy .node polygon,#git-policy .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#git-policy .rough-node .label text,#git-policy .node .label text,#git-policy .image-shape .label,#git-policy .icon-shape .label{text-anchor:middle;}#git-policy .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#git-policy .rough-node .label,#git-policy .node .label,#git-policy .image-shape .label,#git-policy .icon-shape .label{text-align:center;}#git-policy .node.clickable{cursor:pointer;}#git-policy .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#git-policy .arrowheadPath{fill:#333333;}#git-policy .edgePaths .path{stroke:#333333;stroke-width:1px;}#git-policy .flowchart-link{stroke:#333333;fill:none;}#git-policy .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#git-policy .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#git-policy .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#git-policy .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#git-policy .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#git-policy .cluster text{fill:#333;}#git-policy .cluster span{color:#333;}#git-policy .node .collapsed-indicator{fill:#aaaa33;stroke:none;opacity:0.6;}#git-policy .node .collapsed-separator{stroke:#aaaa33;stroke-width:0.75px;}#git-policy div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:Arial,"Malgun Gothic",sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#git-policy .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#git-policy rect.text{fill:none;stroke-width:0;}#git-policy .icon-shape,#git-policy .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#git-policy .icon-shape p,#git-policy .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#git-policy .icon-shape .label rect,#git-policy .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#git-policy .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#git-policy .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#git-policy .node .neo-node{stroke:#9370DB;}#git-policy [data-look="neo"].node rect,#git-policy [data-look="neo"].cluster rect,#git-policy [data-look="neo"].node polygon{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].swimlane.cluster rect{filter:none;}#git-policy [data-look="neo"].node path{stroke:#9370DB;stroke-width:1px;}#git-policy [data-look="neo"].node .outer-path{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].node .neo-line path{stroke:#9370DB;filter:none;}#git-policy [data-look="neo"].node circle{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].node circle .state-start{fill:#000000;}#git-policy [data-look="neo"].icon-shape .icon{fill:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].icon-shape .icon-neo path{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy :root{--mermaid-font-family:Arial,"Malgun Gothic",sans-serif;}</style><g><marker id="git-policy_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-pointEnd-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="11.5" refY="7" markerUnits="userSpaceOnUse" markerWidth="10.5" markerHeight="14" orient="auto"><path d="M 0 0 L 11.5 7 L 0 14 z" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-pointStart-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="1" refY="7" markerUnits="userSpaceOnUse" markerWidth="11.5" markerHeight="14" orient="auto"><polygon points="0,7 11.5,14 11.5,0" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleEnd-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refY="5" refX="12.25" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleStart-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-2" refY="5" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-crossEnd-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="17.7" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5;"/></marker><marker id="git-policy_flowchart-v2-crossStart-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="-3.5" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"/><g class="edges edgePaths"><path d="M162,132L162,144.92893218813452Q162,152 154.92893218813452,152L95.07106781186548,152Q88,152 88,159.07106781186548L88,168" id="git-policy-L_Change_Main_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 100.67163848876953 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Change_Main_0" data-points="W3sieCI6MTYyLCJ5IjoxMzJ9LHsieCI6MTYyLCJ5IjoxNTJ9LHsieCI6ODgsInkiOjE1Mn0seyJ4Ijo4OCwieSI6MTcyfV0=" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M206,132L206,144.92893218813452Q206,152 213.07106781186548,152L272.9289321881345,152Q280,152 280,159.07106781186548L280,168" id="git-policy-L_Change_PR_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 100.67166900634766 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Change_PR_0" data-points="W3sieCI6MjA2LCJ5IjoxMzJ9LHsieCI6MjA2LCJ5IjoxNTJ9LHsieCI6MjgwLCJ5IjoxNTJ9LHsieCI6MjgwLCJ5IjoxNzJ9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M280,268L280,304" id="git-policy-L_PR_Core_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 32 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_PR_Core_0" data-points="W3sieCI6MjgwLCJ5IjoyNjh9LHsieCI6MjgwLCJ5IjozMDh9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M472,132L472,180" id="git-policy-L_Manual_Target_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 44 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Manual_Target_0" data-points="W3sieCI6NDcyLCJ5IjoxMzJ9LHsieCI6NDcyLCJ5IjoxODR9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M472,256L472,304" id="git-policy-L_Target_Full_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 44 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Target_Full_0" data-points="W3sieCI6NDcyLCJ5IjoyNTZ9LHsieCI6NDcyLCJ5IjozMDh9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M664,132L664,180" id="git-policy-L_Release_Bump_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 44 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Release_Bump_0" data-points="W3sieCI6NjY0LCJ5IjoxMzJ9LHsieCI6NjY0LCJ5IjoxODR9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M664,256L664,316" id="git-policy-L_Bump_Verify_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 56 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Bump_Verify_0" data-points="W3sieCI6NjY0LCJ5IjoyNTZ9LHsieCI6NjY0LCJ5IjozMjB9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M664,392L664,440" id="git-policy-L_Verify_Publish_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 44 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Verify_Publish_0" data-points="W3sieCI6NjY0LCJ5IjozOTJ9LHsieCI6NjY0LCJ5Ijo0NDR9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/></g><g class="edgeLabels"/><g class="nodes"><g class="node default" id="git-policy-flowchart-Change-0" data-look="neo" transform="translate(184, 108)"><rect class="basic label-container" style="" x="-76" y="-24" width="152" height="48"/><g class="label" style="" transform="translate(-60, -12)"><rect/><foreignObject width="120" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: nowrap; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>개발 변경</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Main-1" data-look="neo" transform="translate(88, 196)"><rect class="basic label-container" style="" x="-76" y="-24" width="152" height="48"/><g class="label" style="" transform="translate(-60, -12)"><rect/><foreignObject width="120" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: nowrap; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>main 직접 push</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-PR-3" data-look="neo" transform="translate(280, 220)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>선택적으로 main 대상 PR 생성</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Core-5" data-look="neo" transform="translate(280, 356)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Core 자동 실행 · Windows / macOS / Linux</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Manual-6" data-look="neo" transform="translate(472, 96)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Desktop Full 수동 실행</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Target-7" data-look="neo" transform="translate(472, 220)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>main 또는 열린 PR의 병합 커밋</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Full-9" data-look="neo" transform="translate(472, 356)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Core + 개발 앱·패키지 통합 검사 · 3개 OS</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Release-10" data-look="neo" transform="translate(664, 72)"><rect class="basic label-container" style="" x="-76" y="-60" width="152" height="120"/><g class="label" style="" transform="translate(-60, -48)"><rect/><foreignObject width="120" height="96"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>main에서 Desktop release 수동 실행</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Bump-11" data-look="neo" transform="translate(664, 220)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>patch / minor / major 선택</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Verify-13" data-look="neo" transform="translate(664, 356)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Core · 패키징 · 보안 검증</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Publish-15" data-look="neo" transform="translate(664, 492)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>버전 커밋 + v태그 + GitHub Release</p></span></div></foreignObject></g></g></g></g></g><defs><filter id="git-policy-drop-shadow" height="130%" width="130%"><feDropShadow dx="4" dy="4" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><defs><filter id="git-policy-drop-shadow-small" height="150%" width="150%"><feDropShadow dx="2" dy="2" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs></svg>
diff --git a/doc/diagrams/git-policy.mmd b/doc/diagrams/git-policy.mmd
index 146b336..7516701 100644
--- a/doc/diagrams/git-policy.mmd
+++ b/doc/diagrams/git-policy.mmd
@@ -1,9 +1,9 @@
 flowchart TD
-    Change["개발 변경"] --> Main["main 직접 push"]
-    Change --> PR["선택적으로 main 대상 PR 생성"]
-    PR --> Core["Core 자동 실행 · Windows / macOS / Linux"]
-    Manual["Desktop Full 수동 실행"] --> Target["main 또는 열린 PR의 병합 커밋"]
-    Target --> Full["Core + 개발 앱·패키지 통합 검사 · 3개 OS"]
-    Release["main에서 Desktop release 수동 실행"] --> Bump["patch / minor / major 선택"]
-    Bump --> Verify["Core · 패키징 · 보안 검증"]
-    Verify --> Publish["버전 커밋 + v태그 + GitHub Release"]
+    Change["Development changes"] --> Main["Push directly to main"]
+    Change --> PR["Optionally open a PR targeting main"]
+    PR --> Core["Automatic Core checks · Windows / macOS / Linux"]
+    Manual["Run Desktop Full manually"] --> Target["main or an open PR's merge commit"]
+    Target --> Full["Core + development app and package integration checks · 3 OSes"]
+    Release["Run Desktop release manually on main"] --> Bump["Select patch / minor / major"]
+    Bump --> Verify["Core · packaging · security checks"]
+    Verify --> Publish["Version commit + v-tag + GitHub Release"]
diff --git a/doc/diagrams/git-policy.svg b/doc/diagrams/git-policy.svg
index 5f35945..e0921e5 100644
--- a/doc/diagrams/git-policy.svg
+++ b/doc/diagrams/git-policy.svg
@@ -1,2 +1,2 @@
-<!-- Mermaid source SHA-256: a59c7edb6a5c8395bc4a696bb6691210dd11bf2891328c6c93660626080c56a6 -->
-<svg xmlns="http://www.w3.org/2000/svg" id="git-policy" width="744" class="flowchart" style="max-width: 744px;" viewBox="4 4 744 544" role="graphics-document document" aria-roledescription="flowchart-v2" height="544"><style>#git-policy{font-family:Arial,"Malgun Gothic",sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#git-policy .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#git-policy .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#git-policy .error-icon{fill:#552222;}#git-policy .error-text{fill:#552222;stroke:#552222;}#git-policy .edge-thickness-normal{stroke-width:1px;}#git-policy .edge-thickness-thick{stroke-width:3.5px;}#git-policy .edge-pattern-solid{stroke-dasharray:0;}#git-policy .edge-thickness-invisible{stroke-width:0;fill:none;}#git-policy .edge-pattern-dashed{stroke-dasharray:3;}#git-policy .edge-pattern-dotted{stroke-dasharray:2;}#git-policy .marker{fill:#333333;stroke:#333333;}#git-policy .marker.cross{stroke:#333333;}#git-policy svg{font-family:Arial,"Malgun Gothic",sans-serif;font-size:16px;}#git-policy p{margin:0;}#git-policy .label{font-family:Arial,"Malgun Gothic",sans-serif;color:#333;}#git-policy .cluster-label text{fill:#333;}#git-policy .cluster-label span{color:#333;}#git-policy .cluster-label span p{background-color:transparent;}#git-policy .label text,#git-policy span{fill:#333;color:#333;}#git-policy .node rect,#git-policy .node circle,#git-policy .node ellipse,#git-policy .node polygon,#git-policy .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#git-policy .rough-node .label text,#git-policy .node .label text,#git-policy .image-shape .label,#git-policy .icon-shape .label{text-anchor:middle;}#git-policy .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#git-policy .rough-node .label,#git-policy .node .label,#git-policy .image-shape .label,#git-policy .icon-shape .label{text-align:center;}#git-policy .node.clickable{cursor:pointer;}#git-policy .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#git-policy .arrowheadPath{fill:#333333;}#git-policy .edgePaths .path{stroke:#333333;stroke-width:1px;}#git-policy .flowchart-link{stroke:#333333;fill:none;}#git-policy .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#git-policy .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#git-policy .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#git-policy .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#git-policy .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#git-policy .cluster text{fill:#333;}#git-policy .cluster span{color:#333;}#git-policy .node .collapsed-indicator{fill:#aaaa33;stroke:none;opacity:0.6;}#git-policy .node .collapsed-separator{stroke:#aaaa33;stroke-width:0.75px;}#git-policy div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:Arial,"Malgun Gothic",sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#git-policy .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#git-policy rect.text{fill:none;stroke-width:0;}#git-policy .icon-shape,#git-policy .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#git-policy .icon-shape p,#git-policy .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#git-policy .icon-shape .label rect,#git-policy .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#git-policy .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#git-policy .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#git-policy .node .neo-node{stroke:#9370DB;}#git-policy [data-look="neo"].node rect,#git-policy [data-look="neo"].cluster rect,#git-policy [data-look="neo"].node polygon{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].swimlane.cluster rect{filter:none;}#git-policy [data-look="neo"].node path{stroke:#9370DB;stroke-width:1px;}#git-policy [data-look="neo"].node .outer-path{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].node .neo-line path{stroke:#9370DB;filter:none;}#git-policy [data-look="neo"].node circle{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].node circle .state-start{fill:#000000;}#git-policy [data-look="neo"].icon-shape .icon{fill:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].icon-shape .icon-neo path{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy :root{--mermaid-font-family:Arial,"Malgun Gothic",sans-serif;}</style><g><marker id="git-policy_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-pointEnd-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="11.5" refY="7" markerUnits="userSpaceOnUse" markerWidth="10.5" markerHeight="14" orient="auto"><path d="M 0 0 L 11.5 7 L 0 14 z" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-pointStart-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="1" refY="7" markerUnits="userSpaceOnUse" markerWidth="11.5" markerHeight="14" orient="auto"><polygon points="0,7 11.5,14 11.5,0" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleEnd-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refY="5" refX="12.25" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleStart-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-2" refY="5" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-crossEnd-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="17.7" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5;"/></marker><marker id="git-policy_flowchart-v2-crossStart-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="-3.5" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"/><g class="edges edgePaths"><path d="M162,132L162,144.92893218813452Q162,152 154.92893218813452,152L95.07106781186548,152Q88,152 88,159.07106781186548L88,168" id="git-policy-L_Change_Main_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 100.67163848876953 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Change_Main_0" data-points="W3sieCI6MTYyLCJ5IjoxMzJ9LHsieCI6MTYyLCJ5IjoxNTJ9LHsieCI6ODgsInkiOjE1Mn0seyJ4Ijo4OCwieSI6MTcyfV0=" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M206,132L206,144.92893218813452Q206,152 213.07106781186548,152L272.9289321881345,152Q280,152 280,159.07106781186548L280,168" id="git-policy-L_Change_PR_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 100.67166900634766 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Change_PR_0" data-points="W3sieCI6MjA2LCJ5IjoxMzJ9LHsieCI6MjA2LCJ5IjoxNTJ9LHsieCI6MjgwLCJ5IjoxNTJ9LHsieCI6MjgwLCJ5IjoxNzJ9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M280,268L280,304" id="git-policy-L_PR_Core_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 32 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_PR_Core_0" data-points="W3sieCI6MjgwLCJ5IjoyNjh9LHsieCI6MjgwLCJ5IjozMDh9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M472,132L472,180" id="git-policy-L_Manual_Target_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 44 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Manual_Target_0" data-points="W3sieCI6NDcyLCJ5IjoxMzJ9LHsieCI6NDcyLCJ5IjoxODR9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M472,256L472,304" id="git-policy-L_Target_Full_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 44 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Target_Full_0" data-points="W3sieCI6NDcyLCJ5IjoyNTZ9LHsieCI6NDcyLCJ5IjozMDh9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M664,132L664,180" id="git-policy-L_Release_Bump_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 44 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Release_Bump_0" data-points="W3sieCI6NjY0LCJ5IjoxMzJ9LHsieCI6NjY0LCJ5IjoxODR9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M664,256L664,316" id="git-policy-L_Bump_Verify_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 56 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Bump_Verify_0" data-points="W3sieCI6NjY0LCJ5IjoyNTZ9LHsieCI6NjY0LCJ5IjozMjB9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M664,392L664,440" id="git-policy-L_Verify_Publish_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 44 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Verify_Publish_0" data-points="W3sieCI6NjY0LCJ5IjozOTJ9LHsieCI6NjY0LCJ5Ijo0NDR9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/></g><g class="edgeLabels"/><g class="nodes"><g class="node default" id="git-policy-flowchart-Change-0" data-look="neo" transform="translate(184, 108)"><rect class="basic label-container" style="" x="-76" y="-24" width="152" height="48"/><g class="label" style="" transform="translate(-60, -12)"><rect/><foreignObject width="120" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: nowrap; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>개발 변경</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Main-1" data-look="neo" transform="translate(88, 196)"><rect class="basic label-container" style="" x="-76" y="-24" width="152" height="48"/><g class="label" style="" transform="translate(-60, -12)"><rect/><foreignObject width="120" height="24"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: nowrap; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>main 직접 push</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-PR-3" data-look="neo" transform="translate(280, 220)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>선택적으로 main 대상 PR 생성</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Core-5" data-look="neo" transform="translate(280, 356)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Core 자동 실행 · Windows / macOS / Linux</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Manual-6" data-look="neo" transform="translate(472, 96)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Desktop Full 수동 실행</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Target-7" data-look="neo" transform="translate(472, 220)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>main 또는 열린 PR의 병합 커밋</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Full-9" data-look="neo" transform="translate(472, 356)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Core + 개발 앱·패키지 통합 검사 · 3개 OS</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Release-10" data-look="neo" transform="translate(664, 72)"><rect class="basic label-container" style="" x="-76" y="-60" width="152" height="120"/><g class="label" style="" transform="translate(-60, -48)"><rect/><foreignObject width="120" height="96"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>main에서 Desktop release 수동 실행</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Bump-11" data-look="neo" transform="translate(664, 220)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>patch / minor / major 선택</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Verify-13" data-look="neo" transform="translate(664, 356)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Core · 패키징 · 보안 검증</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Publish-15" data-look="neo" transform="translate(664, 492)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>버전 커밋 + v태그 + GitHub Release</p></span></div></foreignObject></g></g></g></g></g><defs><filter id="git-policy-drop-shadow" height="130%" width="130%"><feDropShadow dx="4" dy="4" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><defs><filter id="git-policy-drop-shadow-small" height="150%" width="150%"><feDropShadow dx="2" dy="2" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs></svg>
+<!-- Mermaid source SHA-256: 3fff56c61438db9eac53c5d43375ad4beaa4c427766ba8902ede776fad679c10 -->
+<svg xmlns="http://www.w3.org/2000/svg" id="git-policy" width="744" class="flowchart" style="max-width: 744px;" viewBox="4 4 744 616" role="graphics-document document" aria-roledescription="flowchart-v2" height="616"><style>#git-policy{font-family:Arial,"Malgun Gothic",sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#git-policy .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#git-policy .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#git-policy .error-icon{fill:#552222;}#git-policy .error-text{fill:#552222;stroke:#552222;}#git-policy .edge-thickness-normal{stroke-width:1px;}#git-policy .edge-thickness-thick{stroke-width:3.5px;}#git-policy .edge-pattern-solid{stroke-dasharray:0;}#git-policy .edge-thickness-invisible{stroke-width:0;fill:none;}#git-policy .edge-pattern-dashed{stroke-dasharray:3;}#git-policy .edge-pattern-dotted{stroke-dasharray:2;}#git-policy .marker{fill:#333333;stroke:#333333;}#git-policy .marker.cross{stroke:#333333;}#git-policy svg{font-family:Arial,"Malgun Gothic",sans-serif;font-size:16px;}#git-policy p{margin:0;}#git-policy .label{font-family:Arial,"Malgun Gothic",sans-serif;color:#333;}#git-policy .cluster-label text{fill:#333;}#git-policy .cluster-label span{color:#333;}#git-policy .cluster-label span p{background-color:transparent;}#git-policy .label text,#git-policy span{fill:#333;color:#333;}#git-policy .node rect,#git-policy .node circle,#git-policy .node ellipse,#git-policy .node polygon,#git-policy .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#git-policy .rough-node .label text,#git-policy .node .label text,#git-policy .image-shape .label,#git-policy .icon-shape .label{text-anchor:middle;}#git-policy .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#git-policy .rough-node .label,#git-policy .node .label,#git-policy .image-shape .label,#git-policy .icon-shape .label{text-align:center;}#git-policy .node.clickable{cursor:pointer;}#git-policy .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#git-policy .arrowheadPath{fill:#333333;}#git-policy .edgePaths .path{stroke:#333333;stroke-width:1px;}#git-policy .flowchart-link{stroke:#333333;fill:none;}#git-policy .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#git-policy .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#git-policy .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#git-policy .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#git-policy .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#git-policy .cluster text{fill:#333;}#git-policy .cluster span{color:#333;}#git-policy .node .collapsed-indicator{fill:#aaaa33;stroke:none;opacity:0.6;}#git-policy .node .collapsed-separator{stroke:#aaaa33;stroke-width:0.75px;}#git-policy div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:Arial,"Malgun Gothic",sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#git-policy .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#git-policy rect.text{fill:none;stroke-width:0;}#git-policy .icon-shape,#git-policy .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#git-policy .icon-shape p,#git-policy .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#git-policy .icon-shape .label rect,#git-policy .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#git-policy .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#git-policy .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#git-policy .node .neo-node{stroke:#9370DB;}#git-policy [data-look="neo"].node rect,#git-policy [data-look="neo"].cluster rect,#git-policy [data-look="neo"].node polygon{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].swimlane.cluster rect{filter:none;}#git-policy [data-look="neo"].node path{stroke:#9370DB;stroke-width:1px;}#git-policy [data-look="neo"].node .outer-path{filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].node .neo-line path{stroke:#9370DB;filter:none;}#git-policy [data-look="neo"].node circle{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].node circle .state-start{fill:#000000;}#git-policy [data-look="neo"].icon-shape .icon{fill:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy [data-look="neo"].icon-shape .icon-neo path{stroke:#9370DB;filter:drop-shadow(1px 2px 2px rgba(185, 185, 185, 1));}#git-policy :root{--mermaid-font-family:Arial,"Malgun Gothic",sans-serif;}</style><g><marker id="git-policy_flowchart-v2-pointEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 0 L 10 5 L 0 10 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-pointStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="4.5" refY="5" markerUnits="userSpaceOnUse" markerWidth="8" markerHeight="8" orient="auto"><path d="M 0 5 L 10 10 L 10 0 z" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-pointEnd-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="11.5" refY="7" markerUnits="userSpaceOnUse" markerWidth="10.5" markerHeight="14" orient="auto"><path d="M 0 0 L 11.5 7 L 0 14 z" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-pointStart-margin" class="marker flowchart-v2" viewBox="0 0 11.5 14" refX="1" refY="7" markerUnits="userSpaceOnUse" markerWidth="11.5" markerHeight="14" orient="auto"><polygon points="0,7 11.5,14 11.5,0" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleEnd" class="marker flowchart-v2" viewBox="0 0 10 10" refX="11" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleStart" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-1" refY="5" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 1; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleEnd-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refY="5" refX="12.25" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-circleStart-margin" class="marker flowchart-v2" viewBox="0 0 10 10" refX="-2" refY="5" markerUnits="userSpaceOnUse" markerWidth="14" markerHeight="14" orient="auto"><circle cx="5" cy="5" r="5" class="arrowMarkerPath" style="stroke-width: 0; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-crossEnd" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="12" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-crossStart" class="marker cross flowchart-v2" viewBox="0 0 11 11" refX="-1" refY="5.2" markerUnits="userSpaceOnUse" markerWidth="11" markerHeight="11" orient="auto"><path d="M 1,1 l 9,9 M 10,1 l -9,9" class="arrowMarkerPath" style="stroke-width: 2; stroke-dasharray: 1, 0;"/></marker><marker id="git-policy_flowchart-v2-crossEnd-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="17.7" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5;"/></marker><marker id="git-policy_flowchart-v2-crossStart-margin" class="marker cross flowchart-v2" viewBox="0 0 15 15" refX="-3.5" refY="7.5" markerUnits="userSpaceOnUse" markerWidth="12" markerHeight="12" orient="auto"><path d="M 1,1 L 14,14 M 1,14 L 14,1" class="arrowMarkerPath" style="stroke-width: 2.5; stroke-dasharray: 1, 0;"/></marker><g class="root"><g class="clusters"/><g class="edges edgePaths"><path d="M162,132L162,144.92893218813452Q162,152 154.92893218813452,152L95.07106781186548,152Q88,152 88,159.07106781186548L88,168" id="git-policy-L_Change_Main_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 100.67163848876953 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Change_Main_0" data-points="W3sieCI6MTYyLCJ5IjoxMzJ9LHsieCI6MTYyLCJ5IjoxNTJ9LHsieCI6ODgsInkiOjE1Mn0seyJ4Ijo4OCwieSI6MTcyfV0=" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M206,132L206,144.92893218813452Q206,152 213.07106781186548,152L272.9289321881345,152Q280,152 280,159.07106781186548L280,168" id="git-policy-L_Change_PR_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 100.67166900634766 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Change_PR_0" data-points="W3sieCI6MjA2LCJ5IjoxMzJ9LHsieCI6MjA2LCJ5IjoxNTJ9LHsieCI6MjgwLCJ5IjoxNTJ9LHsieCI6MjgwLCJ5IjoxNzJ9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M280,268L280,304" id="git-policy-L_PR_Core_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 32 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_PR_Core_0" data-points="W3sieCI6MjgwLCJ5IjoyNjh9LHsieCI6MjgwLCJ5IjozMDh9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M472,132L472,168" id="git-policy-L_Manual_Target_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 32 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Manual_Target_0" data-points="W3sieCI6NDcyLCJ5IjoxMzJ9LHsieCI6NDcyLCJ5IjoxNzJ9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M472,268L472,304" id="git-policy-L_Target_Full_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 32 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Target_Full_0" data-points="W3sieCI6NDcyLCJ5IjoyNjh9LHsieCI6NDcyLCJ5IjozMDh9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M664,132L664,180" id="git-policy-L_Release_Bump_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 44 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Release_Bump_0" data-points="W3sieCI6NjY0LCJ5IjoxMzJ9LHsieCI6NjY0LCJ5IjoxODR9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M664,256L664,340" id="git-policy-L_Bump_Verify_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 80 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Bump_Verify_0" data-points="W3sieCI6NjY0LCJ5IjoyNTZ9LHsieCI6NjY0LCJ5IjozNDR9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/><path d="M664,440L664,512" id="git-policy-L_Verify_Publish_0" class="edge-thickness-normal edge-pattern-solid edge-thickness-normal edge-pattern-solid flowchart-link" style="stroke-dasharray: 0 0 68 4; stroke-dashoffset: 0;;" data-edge="true" data-et="edge" data-id="L_Verify_Publish_0" data-points="W3sieCI6NjY0LCJ5Ijo0NDB9LHsieCI6NjY0LCJ5Ijo1MTZ9XQ==" data-look="neo" marker-end="url(#git-policy_flowchart-v2-pointEnd-margin)"/></g><g class="edgeLabels"/><g class="nodes"><g class="node default" id="git-policy-flowchart-Change-0" data-look="neo" transform="translate(184, 96)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Development changes</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Main-1" data-look="neo" transform="translate(88, 208)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Push directly to main</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-PR-3" data-look="neo" transform="translate(280, 220)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Optionally open a PR targeting main</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Core-5" data-look="neo" transform="translate(280, 368)"><rect class="basic label-container" style="" x="-76" y="-60" width="152" height="120"/><g class="label" style="" transform="translate(-60, -48)"><rect/><foreignObject width="120" height="96"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Automatic Core checks · Windows / macOS / Linux</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Manual-6" data-look="neo" transform="translate(472, 96)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Run Desktop Full manually</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Target-7" data-look="neo" transform="translate(472, 220)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>main or an open PR's merge commit</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Full-9" data-look="neo" transform="translate(472, 392)"><rect class="basic label-container" style="" x="-76" y="-84" width="152" height="168"/><g class="label" style="" transform="translate(-60, -72)"><rect/><foreignObject width="120" height="144"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Core + development app and package integration checks · 3 OSes</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Release-10" data-look="neo" transform="translate(664, 72)"><rect class="basic label-container" style="" x="-76" y="-60" width="152" height="120"/><g class="label" style="" transform="translate(-60, -48)"><rect/><foreignObject width="120" height="96"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Run Desktop release manually on main</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Bump-11" data-look="neo" transform="translate(664, 220)"><rect class="basic label-container" style="" x="-76" y="-36" width="152" height="72"/><g class="label" style="" transform="translate(-60, -24)"><rect/><foreignObject width="120" height="48"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Select patch / minor / major</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Verify-13" data-look="neo" transform="translate(664, 392)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Core · packaging · security checks</p></span></div></foreignObject></g></g><g class="node default" id="git-policy-flowchart-Publish-15" data-look="neo" transform="translate(664, 564)"><rect class="basic label-container" style="" x="-76" y="-48" width="152" height="96"/><g class="label" style="" transform="translate(-60, -36)"><rect/><foreignObject width="120" height="72"><div xmlns="http://www.w3.org/1999/xhtml" style="display: table; white-space: break-spaces; line-height: 1.5; max-width: 120px; text-align: center; width: 120px;"><span class="nodeLabel"><p>Version commit + v-tag + GitHub Release</p></span></div></foreignObject></g></g></g></g></g><defs><filter id="git-policy-drop-shadow" height="130%" width="130%"><feDropShadow dx="4" dy="4" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs><defs><filter id="git-policy-drop-shadow-small" height="150%" width="150%"><feDropShadow dx="2" dy="2" stdDeviation="0" flood-opacity="0.06" flood-color="#000000"/></filter></defs></svg>
diff --git a/doc/git-strategy.adoc b/doc/git-strategy.adoc
index 9eaaa84..7940949 100644
--- a/doc/git-strategy.adoc
+++ b/doc/git-strategy.adoc
@@ -1,8 +1,8 @@
 = Git 전략
 
-image::diagrams/git-policy.svg[1인 개발의 검사와 릴리즈 흐름]
+image::diagrams/git-policy-ko.svg[1인 개발의 검사와 릴리즈 흐름]
 
-link:diagrams/git-policy.mmd[Mermaid 원본]
+link:diagrams/git-policy-ko.mmd[Mermaid 원본]
 
 == 브랜치와 병합
 
diff --git a/docs/renderer-architecture.md b/doc/renderer-architecture.md
similarity index 100%
rename from docs/renderer-architecture.md
rename to doc/renderer-architecture.md
diff --git a/package-lock.json b/package-lock.json
index 038e46e..3aaf012 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "metis",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "metis",
-      "version": "0.2.4",
+      "version": "0.2.5",
       "workspaces": [
         "apps/*",
         "packages/*"
@@ -40,7 +40,7 @@
     },
     "apps/desktop": {
       "name": "@metis/desktop",
-      "version": "0.2.4"
+      "version": "0.2.5"
     },
     "node_modules/@antfu/install-pkg": {
       "version": "2.1.0",
@@ -9175,19 +9175,19 @@
     },
     "packages/contracts": {
       "name": "@metis/contracts",
-      "version": "0.2.4"
+      "version": "0.2.5"
     },
     "packages/document-core": {
       "name": "@metis/document-core",
-      "version": "0.2.4"
+      "version": "0.2.5"
     },
     "packages/knowledge-index": {
       "name": "@metis/knowledge-index",
-      "version": "0.2.4"
+      "version": "0.2.5"
     },
     "packages/workspace": {
       "name": "@metis/workspace",
-      "version": "0.2.4"
+      "version": "0.2.5"
     }
   }
 }
diff --git a/package.json b/package.json
index d155e3e..1145771 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "metis",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "private": true,
   "type": "module",
   "workspaces": [
diff --git a/packages/contracts/package.json b/packages/contracts/package.json
index 1d1b92b..4347d1c 100644
--- a/packages/contracts/package.json
+++ b/packages/contracts/package.json
@@ -1 +1 @@
-{ "name": "@metis/contracts", "version": "0.2.4", "private": true, "exports": "./src/index.ts" }
+{ "name": "@metis/contracts", "version": "0.2.5", "private": true, "exports": "./src/index.ts" }
diff --git a/packages/document-core/package.json b/packages/document-core/package.json
index 283c1b3..b05e24e 100644
--- a/packages/document-core/package.json
+++ b/packages/document-core/package.json
@@ -1 +1 @@
-{ "name": "@metis/document-core", "version": "0.2.4", "private": true, "exports": "./src/index.ts" }
+{ "name": "@metis/document-core", "version": "0.2.5", "private": true, "exports": "./src/index.ts" }
diff --git a/packages/knowledge-index/package.json b/packages/knowledge-index/package.json
index 1b76bff..9c48946 100644
--- a/packages/knowledge-index/package.json
+++ b/packages/knowledge-index/package.json
@@ -1,6 +1,6 @@
 {
   "name": "@metis/knowledge-index",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "private": true,
   "exports": {
     ".": "./src/index.ts",
diff --git a/packages/workspace/package.json b/packages/workspace/package.json
index 528b8a9..82fc0ed 100644
--- a/packages/workspace/package.json
+++ b/packages/workspace/package.json
@@ -1 +1 @@
-{ "name": "@metis/workspace", "version": "0.2.4", "private": true, "exports": "./src/index.ts" }
+{ "name": "@metis/workspace", "version": "0.2.5", "private": true, "exports": "./src/index.ts" }