@im-nobsidian/core 0.10.0 → 0.12.0

package/dist/index.d.ts

@@ -87,6 +87,7 @@ declare const ConfigSchema: z.ZodObject<{
         autoSyncInterval: z.ZodDefault<z.ZodNumber>;
         fullReconcileInterval: z.ZodDefault<z.ZodNumber>;
         deleteSync: z.ZodDefault<z.ZodBoolean>;
+        renameOnTitleChange: z.ZodDefault<z.ZodBoolean>;
         syncFiles: z.ZodDefault<z.ZodBoolean>;
         createDatabases: z.ZodDefault<z.ZodBoolean>;
         notifications: z.ZodDefault<z.ZodEnum<["silent", "default"]>>;
@@ -98,6 +99,7 @@ declare const ConfigSchema: z.ZodObject<{
         autoSyncInterval: number;
         fullReconcileInterval: number;
         deleteSync: boolean;
+        renameOnTitleChange: boolean;
         syncFiles: boolean;
         createDatabases: boolean;
     }, {
@@ -108,6 +110,7 @@ declare const ConfigSchema: z.ZodObject<{
         autoSyncInterval?: number | undefined;
         fullReconcileInterval?: number | undefined;
         deleteSync?: boolean | undefined;
+        renameOnTitleChange?: boolean | undefined;
         syncFiles?: boolean | undefined;
         createDatabases?: boolean | undefined;
     }>;
@@ -222,6 +225,7 @@ declare const ConfigSchema: z.ZodObject<{
         autoSyncInterval: number;
         fullReconcileInterval: number;
         deleteSync: boolean;
+        renameOnTitleChange: boolean;
         syncFiles: boolean;
         createDatabases: boolean;
     };
@@ -280,6 +284,7 @@ declare const ConfigSchema: z.ZodObject<{
         autoSyncInterval?: number | undefined;
         fullReconcileInterval?: number | undefined;
         deleteSync?: boolean | undefined;
+        renameOnTitleChange?: boolean | undefined;
         syncFiles?: boolean | undefined;
         createDatabases?: boolean | undefined;
     };
@@ -459,6 +464,21 @@ interface PushResult {
     readonly moved: number;
     readonly failed: FailedOperation[];
     readonly duration: number;
+    /**
+     * 볼트에서 고쳤지만 올리지 않은 읽기 전용 속성(수식 · 롤업 · ID …) — Notion 이 값을 정한다. 다음 pull 이 Notion
+     * 값으로 되돌리므로 화면이 알린다. 예전에는 로그 한 줄만 남아 고친 값이 말없이 사라졌다. 없으면 빈 목록 · 생략.
+     */
+    readonly readOnlySkipped?: readonly ReadOnlySkip[];
+    /**
+     * 볼트에서 지웠지만 Notion 에서 지우지 않은 노트(`sync.deleteSync` 꺼짐) — 다음 pull 이 Notion 에서 되살린다.
+     * 예전에는 아무 말 없이 대기로 적기만 해, 지운 파일이 다음 pull 에 말없이 돌아왔다(D8). 없으면 빈 목록 · 생략.
+     */
+    readonly unsentDeletions?: readonly string[];
+}
+/** 노트 하나에서 올리지 않은 읽기 전용 속성. */
+interface ReadOnlySkip {
+    readonly path: string;
+    readonly properties: readonly string[];
 }
 /**
  * 전체 대조를 한 이유 (ADR-027).
@@ -485,7 +505,8 @@ interface RemoteScanInfo {
     readonly nextFullAt: string | null;
     /**
      * Notion 에서 지운 노트가 아직 볼트에 반영되지 않았을 수 있나 — 바뀐 것만 찾았고 원격 삭제를 볼트에
-     * 반영하는 설정(`sync.deleteSync`)일 때. 다음 전체 대조가 반영한다. 설정이 꺼져 있으면 원격 삭제는
+     * 반영하는 설정(`sync.deleteSync`)일 때. pull 은 추적 중인 것을 차례로 몇 개씩 묻는다 — 이번에 모두
+     * 물었으면 false 다. 나머지는 다음 pull 들 · 다음 전체 대조가 반영한다. 설정이 꺼져 있으면 원격 삭제는
      * 볼트에 반영하지 않으므로 늘 false 다.
      */
     readonly deletionsDeferred: boolean;
@@ -502,6 +523,8 @@ interface PullResult {
      * 파일이 없어졌다가 복구됐다는 사실 자체를 알 수 없다.
      */
     readonly restored: number;
+    /** 되살린(dry-run 은 되살릴) 노트 · 행의 경로 — {@link restored} 의 목록. 없으면 생략. */
+    readonly restoredPaths?: readonly string[];
     readonly conflicts: Conflict[];
     readonly writtenPaths: string[];
     readonly failed: FailedOperation[];
@@ -515,11 +538,20 @@ interface PullResult {
     readonly moved?: readonly RemoteMove[];
     /** Notion 에서 옮겼지만 볼트에서 옮기지 않은 것과 그 까닭. */
     readonly moveSkipped?: readonly RemoteMoveSkip[];
+    /** 옮기거나 이름을 바꾼 노트를 가리키던 링크를 고친 노트 — 없으면 고친 것이 없다. */
+    readonly relinked?: readonly string[];
+    /**
+     * Notion 에 새로 생겼지만 동기화에서 뺀 자리(paths · `.im-nobsidian-ignore`)에 놓일 것이라 받지 않은 페이지 —
+     * 받았다면 놓였을 경로. dry-run 은 받지 않을 것.
+     */
+    readonly excluded?: readonly string[];
 }
 /** Notion 에서 옮긴 페이지를 볼트에서 옮긴 것 하나 — 노트 하나거나 폴더 하나다. */
 interface RemoteMove {
     readonly from: string;
     readonly to: string;
+    /** Notion 에서 바꾼 제목으로 이름을 바꾼 것(`sync.renameOnTitleChange`) — 없으면 옮긴 것. */
+    readonly renamed?: boolean;
 }
 /** 옮기지 않고 둔 것과 그 까닭 — 볼트에서 직접 옮기면 다음 push 가 Notion 을 맞춘다. */
 interface RemoteMoveSkip {
@@ -568,6 +600,14 @@ interface StatusResult {
     readonly lastFullScanAt: string | null;
     /** 원격을 얼마나 훑었나. 로컬만 본 확인(`statusLocal`)에는 없다. */
     readonly remoteScan?: RemoteScanInfo;
+    /**
+     * 다음 pull 이 볼트에서 옮기거나(Notion 에서 옮긴 페이지) 이름을 바꿀(바꾼 제목) 노트 · 옮기지 않을 것과 까닭.
+     * 원격을 본 확인에만 있다. 옮기기만 하고 고치지 않은 페이지는 전체 대조(pull)에서야 보인다.
+     */
+    readonly remoteMoves?: readonly RemoteMove[];
+    readonly remoteMoveSkipped?: readonly RemoteMoveSkip[];
+    /** Notion 에 새로 생겼지만 뺀 자리에 놓일 것이라 다음 pull 이 받지 않을 페이지의 경로. `remoteChanges` 에서 뺐다. */
+    readonly remoteExcluded?: readonly string[];
 }
 interface FailedOperation {
     readonly path: string;
@@ -1244,6 +1284,8 @@ declare class PropertyMapper {
      * 호출측이 기준에서 빼 두고 다시 보낸다.
      */
     relationKeys(keys: readonly string[]): string[];
+    /** 이 속성들 가운데 Notion 이 값을 정하는 것(수식 · 롤업 · ID · 생성일 …) — 볼트에서 고쳐도 보낼 수 없다. */
+    readOnlyKeys(keys: readonly string[]): string[];
     /**
      * 값을 보낼 수 있는 속성만, pull 이 적는 모양으로 — 원격 값과 로컬 값을 견줄 때 쓴다.
      *
@@ -1804,6 +1846,12 @@ declare class NotionClient {
      * 슬롯을 붙잡아 남을 막는 대신, 다 같이 보는 이 게이트로 쉬게 한다.
      */
     private cooldownUntil;
+    /**
+     * Free 워크스페이스 블록 한도에 막힌 거절과 그 시각. 막힌 동안 블록을 만드는 요청은 보내지 않고 이 거절을 그대로
+     * 돌려준다 — 플랜을 올리기 전에는 풀리지 않으므로 노트마다 같은 거절을 받으러 가지 않는다. 그 사이 플랜을
+     * 올렸을 수 있어 {@link BLOCK_LIMIT_RECHECK_MS} 가 지나면 다시 보내 본다.
+     */
+    private blockLimit;
     /**
      * 요청 1건을 rate limit 슬롯 안에서 실행하고, 재시도 가능한 실패는 백오프 후 다시 시도한다.
      *
@@ -1931,6 +1979,29 @@ declare class NotionBlockBuilder {
     static table(rows: string[][], hasColumnHeader?: boolean, hasRowHeader?: boolean): NotionBlock;
 }
 
+/** 찾을 레코드 — {@link IStateDB.getAll} 이 그대로 만족한다. */
+interface NestedFolderRecord {
+    readonly obsidianPath: string;
+    readonly notionPageId: string | null;
+    readonly notionParentId: string | null;
+    readonly fileType: string;
+}
+/** 두 겹 하나 — 바깥(Notion 부모)과 안쪽(같은 이름의 자식). */
+interface NestedFolderPage {
+    /** 두 겹이 나타내는 볼트 폴더. */
+    readonly folder: string;
+    readonly outer: {
+        readonly path: string;
+        readonly notionPageId: string;
+    };
+    readonly inner: {
+        readonly path: string;
+        readonly notionPageId: string;
+    };
+}
+/** 같은 폴더를 나타내면서 Notion 에서 부모 · 자식인 레코드 쌍. 폴더 경로 순. */
+declare function findNestedFolderPages(records: readonly NestedFolderRecord[]): NestedFolderPage[];
+
 /**
  * DB 완결성 게이트 — "원격에 있는 행이 볼트에도 전부 있는가"를 대조한다.
  *
@@ -1959,6 +2030,7 @@ declare class NotionBlockBuilder {
  * 를 순회하는 SSOT — 하나만 쓴다. 여기서 별도 쿼리를 짜면 검증기가 피검증 대상과 다른
  * 열거 규칙을 갖게 돼, 게이트가 통과해도 실제 pull 은 놓치는 상황이 생긴다.
  */
+
 /** 원격 행 열거 — {@link NotionClient} 가 그대로 만족한다(전 data source 순회 SSOT). */
 interface CompletenessRemoteSource {
     queryAllDatabasePages(databaseId: string, filter?: unknown): Promise<Array<{
@@ -2058,6 +2130,11 @@ interface VaultCompletenessReport {
     readonly databases: CompletenessReport;
     /** 페이지 모드에서만 채워진다. DB 모드에는 root 서브트리가 없어 `null`. */
     readonly pages: PageCompletenessReport | null;
+    /**
+     * 같은 이름의 두 겹 폴더 페이지 — 예전 빌드가 남긴 것(ADR-012). 알리기만 한다: 사람이 정할 일이라
+     * `complete` 에 넣지 않는다.
+     */
+    readonly nestedFolderPages: readonly NestedFolderPage[];
     /** 두 대조가 모두 통과. */
     readonly complete: boolean;
 }
@@ -2139,6 +2216,11 @@ interface VaultFS {
     moveFile(from: string, to: string): Promise<void>;
     exists(path: string): Promise<boolean>;
     ensureFolder(path: string): Promise<void>;
+    /**
+     * 폴더가 완전히 비었으면 지운다 — 파일 · 폴더 · 숨김 파일이 하나라도 있으면 두고 false. 없거나 폴더가 아니어도
+     * false. Notion 에서 지운 폴더 페이지의 폴더를 치울 때 쓴다. 없으면 폴더를 지우지 않는다.
+     */
+    removeEmptyFolder?(path: string): Promise<boolean>;
     listMarkdownFiles(): Promise<FileInfo[]>;
     listMarkdownFileStats(): Promise<FileStatInfo[]>;
     listNonMarkdownFiles(): Promise<NonMdFileInfo[]>;
@@ -2472,6 +2554,8 @@ declare class SyncOrchestrator {
     private readonly databaseCreator;
     private readonly planner;
     private readonly remoteMoves;
+    private readonly remoteRenames;
+    private readonly linkUpdater;
     private readonly detector;
     private readonly drift;
     private readonly discovery;
@@ -2492,6 +2576,11 @@ declare class SyncOrchestrator {
      */
     private assertConnectionScope;
     private executePush;
+    /**
+     * 볼트에서 지운 이 노트를 Notion 에서 지우지 않아 다음 pull 이 되살리나 — deleteSync 가 꺼져 있고 pull 이
+     * 되살리는 레코드일 때. 예전에는 대기로 적기만 하고 알리지 않아, 지운 파일이 말없이 돌아왔다(D8).
+     */
+    private unsentDeletion;
     /**
      * 만든 DB 에 relation · rollup · formula 를 붙이고, 행 스키마를 다시 읽게 한 뒤 보기를 만든다. 실패는
      * 다음 push 가 이어 붙인다 — 행은 그대로 올린다.
@@ -2500,8 +2589,15 @@ declare class SyncOrchestrator {
     /** 볼트의 노트가 마지막으로 올린 내용 그대로인가 — 읽지 못하면(지움 · 옮김) 아니다. */
     private unchangedSincePush;
     pull(options?: PullOptions): Promise<PullResult>;
+    /** 새 원격 페이지 가운데 동기화에서 뺀 자리에 놓일 것 — 페이지 id → 그 자리. dry-run 이 받지 않을 것으로 알린다. */
+    private plannedExclusions;
     /** 감지가 본, Notion 에서 옮긴 페이지를 볼트에서 옮긴다 — 경로를 좁힌 pull 은 그 범위의 것만. */
     private followRemoteMoves;
+    /**
+     * Notion 에서 제목을 바꾼 페이지의 노트 이름을 바꾼다 — `sync.renameOnTitleChange` 를 켰을 때만, 경로를 좁힌 pull 은
+     * 그 범위의 것만. 설정이 뺀 노트는 두지 않는다.
+     */
+    private followRemoteRenames;
     private executePull;
     sync(options?: SyncOptions): Promise<SyncResult>;
     private executeSync;
@@ -2603,6 +2699,8 @@ declare class NodeVaultFS implements VaultFS {
     writeFile(path: string, content: string): Promise<void>;
     writeBinary(path: string, data: Buffer): Promise<void>;
     deleteFile(path: string): Promise<void>;
+    /** `rmdir` 는 비지 않은 폴더를 지우지 않는다(ENOTEMPTY) — 숨김 파일도 그대로 둔다. */
+    removeEmptyFolder(path: string): Promise<boolean>;
     moveFile(from: string, to: string): Promise<void>;
     exists(path: string): Promise<boolean>;
     ensureFolder(path: string): Promise<void>;
@@ -2661,6 +2759,8 @@ interface ImageDownloadResult {
     readonly fileHash?: string;
     /** 임베드 별칭으로 쓸 이름 — 받은 이름에서 이 볼트가 붙인 내용 해시를 뗀 것({@link withoutOwnHash}). */
     readonly name?: string;
+    /** 크기 상한을 넘어 받지 않은 파일의 크기(바이트) — 받았거나 다른 이유로 못 받았으면 없다. */
+    readonly skippedBytes?: number;
 }
 interface ImageUploadResult {
     readonly localPath: string;
@@ -2951,6 +3051,10 @@ declare class ConversionPipeline {
     private readonly postProcessors;
     registerPreProcessor(processor: Processor): void;
     registerPostProcessor(processor: Processor): void;
+    /**
+     * 토글 헤딩은 Markdown API 경로가 변환한다(`toggle-heading.ts`) — 블록 경로로 보내면 콜아웃이 옛 이모지 꼴로
+     * 바뀐다(`CalloutTransformer`). 예전에 여기 있던 토글 헤딩 탐지는 띄어 쓴 마커를 찾아 한 번도 맞지 않았다.
+     */
     selectPath(content: string): ConversionPath;
     convertToNotion(markdown: string, context: ConversionContext): ConversionResult;
     convertToMarkdown(content: string, context: ConversionContext, metadata?: ProcessorMetadata): string;
@@ -2959,6 +3063,11 @@ declare class ConversionPipeline {
 interface DbBaseFile {
     readonly basePath: string;
     readonly title: string;
+    /**
+     * pull 이 그 경로에 마지막으로 쓴 내용의 해시 — 파일이 이것과 다르면 볼트에서 고친 것이라 덮어쓰지 않는다. 예전 버전이
+     * 적은 기록에는 없다 — 그때는 가를 수 없어 예전처럼 쓰고, 쓴 해시부터 적는다.
+     */
+    readonly hash?: string;
 }
 /**
  * DB 마다 실제로 기록한 `.base` 경로와 DB 제목 — 인라인 DB placeholder 를 `.base` 임베드로 바꿀 때
@@ -2972,10 +3081,12 @@ interface DbBaseFile {
 declare class DbBaseFiles {
     private readonly stateDb;
     private entries;
+    /** 마지막으로 읽거나 쓴 메타 값 — 그 사이 다른 쪽(폴더를 옮긴 NoteRelocator)이 고쳐 적었으면 다시 읽는다. */
+    private loadedRaw;
     constructor(stateDb: Pick<IStateDB, "getMeta" | "setMeta">);
     get(databaseId: string): DbBaseFile | undefined;
     set(databaseId: string, info: DbBaseFile): void;
-    /** 상태 메타에서 한 번 읽는다. 없거나 깨졌으면 비어 있다 — 이번 실행이 기록하는 것부터 다시 쌓는다. */
+    /** 상태 메타에서 읽는다 — 값이 그대로면 읽어 둔 것을 쓴다. 없거나 깨졌으면 비어 있다 — 이번 실행이 기록하는 것부터 다시 쌓는다. */
     private load;
 }
 
@@ -3118,9 +3229,14 @@ declare class DatabaseSyncer {
      */
     private readonly appearances;
     private readonly baseFileGenerator;
-    /** 사용자가 만든 `.base` 라 덮어쓰지 않았다고 이미 알린 경로 — 한 pull 이 같은 DB 를 여러 번 다시 쓴다. */
+    /** 사용자가 만들거나 고친 `.base` 라 덮어쓰지 않았다고 이미 알린 경로 — 한 pull 이 같은 DB 를 여러 번 다시 쓴다. */
     private readonly keptUserBases;
     private readonly sidecarGenerator;
+    /** Notion 에서 바꾼 제목으로 이름을 바꾼 행과 실제로 옮긴 차례 — pull 마감이 가져가 다른 노트의 링크를 고친다. */
+    private readonly relocator;
+    private renamedRows;
+    /** 볼트에서 사라져 되살린 행의 경로 — pull 마감이 가져가 화면에 알린다(D8). */
+    private restoredRows;
     /**
      * 실제로 기록한 .base 경로/DB 제목 — placeholder 임베드 재작성(F22)의 SSOT. 이번 pull 이 조회하지
      * 않은 DB 의 것도 남아 있다({@link DbBaseFiles}).
@@ -3273,8 +3389,8 @@ declare class DatabaseSyncer {
      */
     private appearanceOf;
     private readAppearance;
-    /** pull 이 쓰지 않은 `.base` · 사이드카가 이미 있는가 — 없거나 읽지 못하면 false. */
-    private isUserFile;
+    /** 볼트에서 고친 `.base` 를 덮어쓰거나 지우지 않았다고 한 번 알린다. */
+    private warnEditedBase;
     /**
      * DB 제목이 바뀌면 `.base`/`.notion.json` 파일명(safeName)이 바뀌어 옛 이름의 산출물이
      * 같은 폴더에 고아로 잔존한다(drift·부활 원인). DB 폴더 **직속**의 산출물 중 현재 이름이
@@ -3340,6 +3456,13 @@ declare class DatabaseSyncer {
      * (아직 push 하지 않은 노트)을 새 행이 덮어쓰면 그 글이 사라졌다. 일반 페이지 받기(`claimFilePath`)처럼 피한다.
      */
     private rowPathOwners;
+    /** 되살린 행의 경로를 가져가고 비운다. */
+    takeRestoredRows(): string[];
+    /** 이름을 바꾼 행을 가져가고 비운다. */
+    takeRenamedRows(): {
+        renamed: RemoteMove[];
+        applied: RemoteMove[];
+    };
     private pullDatabasePage;
 }
 
@@ -3494,15 +3617,15 @@ declare class FrontmatterGenerator implements Processor {
  * 핵심 전제(F28 교훈): DB 에 저장된 startIndex 는 **push 시점 문자열**의 절대
  * 오프셋이라 pull 산출물에서는 무의미하다 — 프론트매터 앞·단어 한가운데에
  * 마커를 박아 파일을 파손시켰다. 재삽입은 반드시
- *   1) 이미 의미적으로 복원된 마커는 건너뛰고(위키링크 → `[[...]]` 존재 등),
+ *   1) 다른 복원기가 맡는 마커는 건너뛰고(위키링크 · 미디어 · 표 정렬),
  *   2) 텍스트 앵커(__anchor)를 1차 위치 수단으로 쓰며,
  *   3) 프론트매터 뒤·줄 경계에만, 마커 단독 줄로 삽입한다.
  *
  * 이중 모드: `__anchor` 키가 없는 마커는 구버전 DB blob(수집기가 앵커를 안 남기던
  * 시절)이다. 이들은 구계약 — "변환이 마커만 제거했다면 startIndex 오프셋 원문 삽입이
  * 원본을 정확히 재구성한다" — 을 유지하되 프론트매터 앞 삽입만 금지한다. 위해한
- * 레거시 사례(빈 params 껍데기, 이미 복원된 위키링크)는 render-null 폐기와 의미
- * 복원 검사가 이미 걸러낸다.
+ * 레거시 사례(빈 params 껍데기, 위키링크)는 render-null 폐기와 다른 복원기 검사가
+ * 이미 걸러낸다.
  */
 declare class PreserveMarkerInjector implements Processor {
     readonly name = "PreserveMarkerInjector";
@@ -3510,8 +3633,8 @@ declare class PreserveMarkerInjector implements Processor {
     process(input: ProcessorInput): ProcessorOutput;
     /** 마커의 본문 표현. 복원 불가능한(빈) 마커는 null — 삽입하지 않고 폐기한다. */
     private renderMarker;
-    /** 마커가 이미 원래 문법으로 복원돼 있으면 재삽입은 중복·오염이다. */
-    private isSemanticallyRestored;
+    /** 다른 복원기가 맡는 마커 — 본문에 다시 끼우면 중복 · 오염이다. */
+    private restoredElsewhere;
     /** 삽입 위치: 앵커 → startIndex(줄 경계 보정) 순. 항상 프론트매터 뒤. */
     private findInsertionPoint;
 }
@@ -3947,6 +4070,7 @@ declare function notionIdsEqual(a: string, b: string): boolean;
  */
 declare function compactNotionId(id: string): string;
 
+/** Notion 제목 → 볼트 파일 이름(확장자 없이). */
 declare function sanitizeFileName(name: string): string;
 
 /** 노트(마크다운 파일)의 경로 · 이름인가. */
@@ -4006,6 +4130,8 @@ declare class PathFilter {
     private readonly include;
     private readonly exclude;
     constructor(include: readonly string[], exclude: readonly string[]);
+    /** 아무것도 빼지 않는다 — 포함 패턴이 없거나 전부(`**\/*`)이고 제외 패턴이 없다. */
+    isEmpty(): boolean;
     /** 동기화하지 않는 노트 · 첨부 — 포함 패턴 어느 것에도 맞지 않거나 제외 패턴에 맞는다. */
     excludesFile(path: string): boolean;
     /**
@@ -4014,6 +4140,10 @@ declare class PathFilter {
      */
     excludesFolder(path: string): boolean;
 }
+/**
+ * `.im-nobsidian-ignore` 의 글 → 패턴. 빈 줄과 `#` 로 시작하는 줄은 뺀다. CLI 와 플러그인이 같은 규칙으로 읽는다.
+ */
+declare function parseIgnorePatterns(content: string): string[];
 /** 운영체제 구분자로 이은 상대 경로 → 볼트 경로(`/`). `relative()` 의 결과에 쓴다. */
 declare function toVaultPath(relativePath: string, separator: string): string;
 
@@ -4068,6 +4198,37 @@ interface Logger {
 declare function setLogger(logger: Logger): void;
 declare function getLogger(): Logger;
 
+/**
+ * 경로 패턴(`paths.include` · `paths.exclude` · `.im-nobsidian-ignore`)을 목록에 대는 VaultFS.
+ *
+ * CLI 는 볼트를 걸을 때 패턴을 대지만({@link NodeVaultFS}) 플러그인은 Obsidian 이 아는 파일 목록을 그대로 쓴다 —
+ * 그래서 예전 플러그인은 패턴을 무시했다. 이 감싸개가 목록에서 뺀 파일을 지우고 `excludesPath` 를 답한다.
+ * 뺀 노트는 목록에 없어도 「볼트에서 지움」 으로 보지 않는다 — 감지 · pull 이 `excludesPath` 로 가른다.
+ *
+ * 패턴은 감싼 VaultFS 의 경로(연결 폴더 기준)에 댄다 — CLI 가 연결 폴더에서 돌 때와 같다.
+ */
+declare class FilteredVaultFS implements VaultFS {
+    private readonly inner;
+    private readonly filter;
+    readonly ownsPath?: (path: string) => boolean;
+    readonly holdsOtherConnection?: (folder: string) => boolean;
+    constructor(inner: VaultFS, filter: PathFilter);
+    excludesPath(path: string, kind?: "file" | "folder"): boolean;
+    listMarkdownFiles(): Promise<FileInfo[]>;
+    listMarkdownFileStats(): Promise<FileStatInfo[]>;
+    listNonMarkdownFiles(): Promise<NonMdFileInfo[]>;
+    readFile(path: string): Promise<string>;
+    readBinary(path: string): Promise<Buffer>;
+    writeFile(path: string, content: string): Promise<void>;
+    writeBinary(path: string, data: Buffer): Promise<void>;
+    deleteFile(path: string): Promise<void>;
+    moveFile(from: string, to: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    ensureFolder(path: string): Promise<void>;
+    removeEmptyFolder(path: string): Promise<boolean>;
+    getFileStat(path: string): Promise<FileStatInfo | null>;
+}
+
 /**
  * 볼트 하나에 연결 여럿 (ADR-038) — 연결마다 볼트 안의 폴더 하나를 맡는다.
  *
@@ -4134,6 +4295,7 @@ declare class ScopedVaultFS implements VaultFS {
     moveFile(from: string, to: string): Promise<void>;
     exists(path: string): Promise<boolean>;
     ensureFolder(path: string): Promise<void>;
+    removeEmptyFolder(path: string): Promise<boolean>;
     /** 맡은 노트만 읽는다 — 볼트 전체의 본문을 읽지 않는다. */
     listMarkdownFiles(): Promise<FileInfo[]>;
     listMarkdownFileStats(): Promise<FileStatInfo[]>;
@@ -4271,6 +4433,16 @@ declare function parseDesignColor(token: string | undefined): DesignColor | unde
 /** 한 줄을 읽는다. 마커가 없는 줄은 글 조각 하나뿐인 결과를 돌려준다. */
 declare function readDesignLine(line: string): DesignLine;
 
+/** 제목 줄인가. */
+declare function isHeadingLine(line: string): boolean;
+/** 제목 아래로 내린 마커만 있는 줄인가 — 앞줄이 제목일 때 그 제목의 것이다. */
+declare function isHeadingMarkerLine(line: string): boolean;
+/**
+ * 한 섹션의 원문 줄 — 섹션이 제목으로 끝나고 다음 줄이 그 제목의 마커 줄이면 제목 줄 끝에 붙여 돌려준다.
+ * Obsidian 은 그 마커 줄을 다음 섹션으로 가르므로, 읽기 화면이 제목을 칠하려면 다음 줄을 함께 봐야 한다.
+ */
+declare function sectionLinesWithHeadingMarkers(all: readonly string[], start: number, end: number): string[];
+
 /**
  * Notion 컬럼이 볼트 노트의 어느 줄에 걸치나 (#74).
  *
@@ -4303,4 +4475,4 @@ declare function readColumnLayout(lines: readonly string[]): (ColumnPlace | unde
 /** 열 이름표 — `열 2/3 · 50%`. 비율이 없으면 `열 2/3`. */
 declare function columnLabel(place: ColumnPlace): string;
 
-export { BaseFileGenerator, type BaseFileOptions, type BasePropertyOption, type BasePropertySchema, type BaseStatusGroup, type BaseSyncOptions, type BasesFilterNode, type BasesViewMapping, type BasesViewType, BlankLineCollapser, type BookmarkTarget, CONFIG_FILE, type CalendarEntry, type CalloutDesign, CalloutRestorer, CalloutTransformer, ChangeDetector, type ChangeDiff, ColorAnnotator, type ColumnPlace, type CompletenessFailure, type CompletenessLocalSource, type CompletenessOptions, type CompletenessRemoteSource, type CompletenessReport, type Config, ConfigManager, ConfigSchema, type Conflict, ConflictResolver, type ConflictStrategy, ConnectionBoundaryError, ConnectionScopeError, type ConversionContext, type ConversionPath, ConversionPipeline, type ConversionResult, type CoverConfig, type DBEntry, DB_VIEWS_FILE, DB_VIEWS_PATH, DEFAULT_CONFIG, DEFAULT_TITLE_PROPERTY, DEFAULT_WATCH_DEBOUNCE_MS, DIFF_SIGN, type DatabaseCompleteness, type DatabaseSyncConfig, type DatabaseSyncResult, DatabaseSyncer, type DatabaseViewsConfig, type DeferredCode, type DegradeNote, type DesignColor, type DesignLine, type DesignSegment, type DiffHunk, type DiffLine, EmbedResolver, EntryEditor, type FailedOperation, type FidelityClassification, type FidelityContext, type FidelityDefect, type FidelityDefectForm, type FidelitySummary, type FileDownloadResult, FileHandler, type FileInfo, type FileRegistryEntry, type FileStatInfo, type FileSystemEntry, type FileType, type FileUploadResult, FileWatcher, type FilterCondition, type FolderDatabaseReport, type FolderMoveChange, FrontmatterExtractor, FrontmatterGenerator, type FullScanReason, GITIGNORE_ENTRY, type GatedOperation, type GroupByConfig, type GroupedEntries, IGNORE_FILE, INTERNAL_DIR, INTERNAL_DIR_GLOB, type IStateDB, type ImageDownloadResult, ImageHandler, type ImageReference, type InferredProperty, InlineAnnotationPreserver, InlineDBParser, type InlineStyle, type LineDiffOptions, type LineRange, type LocalChange, LocalImageRestorer, type LocalMoveAdoption, type LocalScan, type LocalScanOptions, type Logger, MARKER_BRAND, type MappingResult, type MappingType, MathNormalizer, MentionToWikilink, type MergeConflictRegion, type MergeResult, NOTION_COLOR_NAMES, NOTION_TOKEN_PREFIX, NOTION_TO_BASES_VIEW, NodeVaultFS, type NonMdFileInfo, type NotionBlock, NotionBlockBuilder, NotionClient, type NotionClientOptions, type NotionColor, type NotionPageNode, type NotionRichText, type RichTextItem as NotionRichTextItem, type NotionSidecar, OBSIDIAN_CONFIG_DIR, type OperationType, type PageCompletenessRemoteSource, type PageCompletenessReport, type PageCover, type PageCreationPlan, type PageIcon, PathFilter, type PathFilterConfig, type PendingOperation, PendingWalError, type PlannedRow, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, type ProgressItem, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, type PropertyOption, type PropertySchema, type PropertyValue, type PullOptions, type PullResult, type PushOptions, type PushResult, RENDER_LINE_RULES, type RecordPendingInput, type RegisterFileInput, type RemoteChange, type RemoteMove, type RemoteMoveSkip, type RemoteObservation, type RemoteScanInfo, type RenameHints, type RenameKind, type RenderFinding, type RenderLineRule, type ResolutionChoice, type ResolutionResult, type RichTextSegment, type RowProgress, SAVED_STATE_TABLES_QUERY, SEPARATOR_BODY, STATE_DB_FILE, STATE_DB_MIGRATIONS, STATE_DB_PATH, SavedStateDbError, ScopedVaultFS, SidecarGenerator, type SidecarProperty, type SidecarView, StateDB, StateDbLockedError, type StateDbMigration, type StateDbTool, StateDbUnavailableError, StateLock, type StateLockClaim, type StateLockOwner, type StatusOptions, type StatusResult, type StyledRange, SyncBusyError, type SyncDirection, type SyncOptions, SyncOrchestrator, type SyncRecord, type SyncResult, type SyncStatus, type TableLineDesign, type TranslationResult, TreeMapper, UnsupportedBlockStripper, type UpsertSyncRecord, type VaultCompletenessReport, type VaultFS, type ViewConfig, ViewDataProvider, type ViewPropertyConfig, type ViewRenderData, type ViewType, WIKILINK_LOOKUPS, type WatchSyncOptions, type WatchSyncScope, WatchSyncService, type WikilinkEntry, type WikilinkLookup, WikilinkResolver, applicableChoices, assertNoPendingWal, basesViewMappingOf, basesViewTypeOf, choiceForStrategy, classifyBodyFidelity, columnLabel, compactNotionId, computeBufferHash, computeHash, configDirFrom, connectionFolderOf, createDefaultPipeline, extractCalendarEntries, filterByMonth, filterEntries, findConnectionFolders, formatUnifiedDiff, generateColorCSS, generateId, getLogger, getNotionBgColor, getNotionColor, getVisibleProperties, groupEntries, hasColumnLayout, hasDesignMarker, inAnyPathScope, isInternalPath, isMarkdownPath, isRemoteDeletion, lineDiff, lintRenderedMarkdown, matchesPathScope, normalizeNotionId, normalizeVaultPath, noteNameFromPath, notionIdFromInput, notionIdsEqual, operationLabel, parseDesignColor, pendingWalBytes, readColumnLayout, readDesignLine, resolvePropertyName, sanitizeFileName, setLogger, sortEntries, stateDbLockPath, stateDbWalPath, stripMarkdownExtension, summarizeFidelity, systemTimeZone, threeWayMerge, toVaultPath, translateNotionFilter, verifyDatabaseCompleteness, verifyPageCompleteness, wikilinkLookupsIn };
+export { BaseFileGenerator, type BaseFileOptions, type BasePropertyOption, type BasePropertySchema, type BaseStatusGroup, type BaseSyncOptions, type BasesFilterNode, type BasesViewMapping, type BasesViewType, BlankLineCollapser, type BookmarkTarget, CONFIG_FILE, type CalendarEntry, type CalloutDesign, CalloutRestorer, CalloutTransformer, ChangeDetector, type ChangeDiff, ColorAnnotator, type ColumnPlace, type CompletenessFailure, type CompletenessLocalSource, type CompletenessOptions, type CompletenessRemoteSource, type CompletenessReport, type Config, ConfigManager, ConfigSchema, type Conflict, ConflictResolver, type ConflictStrategy, ConnectionBoundaryError, ConnectionScopeError, type ConversionContext, type ConversionPath, ConversionPipeline, type ConversionResult, type CoverConfig, type DBEntry, DB_VIEWS_FILE, DB_VIEWS_PATH, DEFAULT_CONFIG, DEFAULT_TITLE_PROPERTY, DEFAULT_WATCH_DEBOUNCE_MS, DIFF_SIGN, type DatabaseCompleteness, type DatabaseSyncConfig, type DatabaseSyncResult, DatabaseSyncer, type DatabaseViewsConfig, type DeferredCode, type DegradeNote, type DesignColor, type DesignLine, type DesignSegment, type DiffHunk, type DiffLine, EmbedResolver, EntryEditor, type FailedOperation, type FidelityClassification, type FidelityContext, type FidelityDefect, type FidelityDefectForm, type FidelitySummary, type FileDownloadResult, FileHandler, type FileInfo, type FileRegistryEntry, type FileStatInfo, type FileSystemEntry, type FileType, type FileUploadResult, FileWatcher, type FilterCondition, FilteredVaultFS, type FolderDatabaseReport, type FolderMoveChange, FrontmatterExtractor, FrontmatterGenerator, type FullScanReason, GITIGNORE_ENTRY, type GatedOperation, type GroupByConfig, type GroupedEntries, IGNORE_FILE, INTERNAL_DIR, INTERNAL_DIR_GLOB, type IStateDB, type ImageDownloadResult, ImageHandler, type ImageReference, type InferredProperty, InlineAnnotationPreserver, InlineDBParser, type InlineStyle, type LineDiffOptions, type LineRange, type LocalChange, LocalImageRestorer, type LocalMoveAdoption, type LocalScan, type LocalScanOptions, type Logger, MARKER_BRAND, type MappingResult, type MappingType, MathNormalizer, MentionToWikilink, type MergeConflictRegion, type MergeResult, NOTION_COLOR_NAMES, NOTION_TOKEN_PREFIX, NOTION_TO_BASES_VIEW, type NestedFolderPage, type NestedFolderRecord, NodeVaultFS, type NonMdFileInfo, type NotionBlock, NotionBlockBuilder, NotionClient, type NotionClientOptions, type NotionColor, type NotionPageNode, type NotionRichText, type RichTextItem as NotionRichTextItem, type NotionSidecar, OBSIDIAN_CONFIG_DIR, type OperationType, type PageCompletenessRemoteSource, type PageCompletenessReport, type PageCover, type PageCreationPlan, type PageIcon, PathFilter, type PathFilterConfig, type PendingOperation, PendingWalError, type PlannedRow, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, type ProgressItem, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, type PropertyOption, type PropertySchema, type PropertyValue, type PullOptions, type PullResult, type PushOptions, type PushResult, RENDER_LINE_RULES, type ReadOnlySkip, type RecordPendingInput, type RegisterFileInput, type RemoteChange, type RemoteMove, type RemoteMoveSkip, type RemoteObservation, type RemoteScanInfo, type RenameHints, type RenameKind, type RenderFinding, type RenderLineRule, type ResolutionChoice, type ResolutionResult, type RichTextSegment, type RowProgress, SAVED_STATE_TABLES_QUERY, SEPARATOR_BODY, STATE_DB_FILE, STATE_DB_MIGRATIONS, STATE_DB_PATH, SavedStateDbError, ScopedVaultFS, SidecarGenerator, type SidecarProperty, type SidecarView, StateDB, StateDbLockedError, type StateDbMigration, type StateDbTool, StateDbUnavailableError, StateLock, type StateLockClaim, type StateLockOwner, type StatusOptions, type StatusResult, type StyledRange, SyncBusyError, type SyncDirection, type SyncOptions, SyncOrchestrator, type SyncRecord, type SyncResult, type SyncStatus, type TableLineDesign, type TranslationResult, TreeMapper, UnsupportedBlockStripper, type UpsertSyncRecord, type VaultCompletenessReport, type VaultFS, type ViewConfig, ViewDataProvider, type ViewPropertyConfig, type ViewRenderData, type ViewType, WIKILINK_LOOKUPS, type WatchSyncOptions, type WatchSyncScope, WatchSyncService, type WikilinkEntry, type WikilinkLookup, WikilinkResolver, applicableChoices, assertNoPendingWal, basesViewMappingOf, basesViewTypeOf, choiceForStrategy, classifyBodyFidelity, columnLabel, compactNotionId, computeBufferHash, computeHash, configDirFrom, connectionFolderOf, createDefaultPipeline, extractCalendarEntries, filterByMonth, filterEntries, findConnectionFolders, findNestedFolderPages, formatUnifiedDiff, generateColorCSS, generateId, getLogger, getNotionBgColor, getNotionColor, getVisibleProperties, groupEntries, hasColumnLayout, hasDesignMarker, inAnyPathScope, isHeadingLine, isHeadingMarkerLine, isInternalPath, isMarkdownPath, isRemoteDeletion, lineDiff, lintRenderedMarkdown, matchesPathScope, normalizeNotionId, normalizeVaultPath, noteNameFromPath, notionIdFromInput, notionIdsEqual, operationLabel, parseDesignColor, parseIgnorePatterns, pendingWalBytes, readColumnLayout, readDesignLine, resolvePropertyName, sanitizeFileName, sectionLinesWithHeadingMarkers, setLogger, sortEntries, stateDbLockPath, stateDbWalPath, stripMarkdownExtension, summarizeFidelity, systemTimeZone, threeWayMerge, toVaultPath, translateNotionFilter, verifyDatabaseCompleteness, verifyPageCompleteness, wikilinkLookupsIn };