@im-nobsidian/core 0.12.0 → 0.14.0

package/dist/index.d.ts

@@ -474,6 +474,73 @@ interface PushResult {
      * 예전에는 아무 말 없이 대기로 적기만 해, 지운 파일이 다음 pull 에 말없이 돌아왔다(D8). 없으면 빈 목록 · 생략.
      */
     readonly unsentDeletions?: readonly string[];
+    /**
+     * 볼트에서 바꾼 DB 속성 이름(Obsidian 의 속성 이름 바꾸기)을 Notion 의 열 이름으로 바꾼 것 — dry-run 은 바꿀 것
+     * (ADR-045). 없으면 생략.
+     */
+    readonly renamedProperties?: readonly PropertyRename[];
+    /** 볼트에서 고친 사이드카의 속성을 Notion DB 에 올린 것 — dry-run 은 올릴 것(ADR-045). 없으면 생략. */
+    readonly schemaEdits?: readonly SchemaEdit[];
+    /** 볼트에서 고친 `.base` 보기를 Notion 보기에 올린 것(ADR-046) — dry-run 이면 올릴 것. */
+    readonly viewEdits?: readonly ViewEdit[];
+    /**
+     * 볼트에서 DB 폴더 안팎 · 다른 DB 폴더로 옮겨 Notion 에서 페이지 ↔ 행 · 다른 DB 의 행이 된 노트(ADR-047) — dry-run 이면
+     * 될 것. 없으면 생략.
+     */
+    readonly placementChanges?: readonly PlacementChange[];
+    /** 볼트에서 옮기거나 이름을 바꾼 DB 폴더(ADR-047) — dry-run 이면 옮길 것. 없으면 생략. */
+    readonly databaseMoves?: readonly DatabaseMove[];
+}
+/** 옮긴 DB 폴더 하나 — {@link PushResult.databaseMoves}. */
+interface DatabaseMove {
+    readonly from: string;
+    readonly to: string;
+    /** Notion 의 DB 도 옮겼나(옮기나). false 면 DB 가 볼트가 받지 않는 곳에 있어 볼트 쪽 자리만 바뀐다. dry-run 은 모른다. */
+    readonly inNotion?: boolean;
+}
+/** 옮긴 노트 하나가 Notion 에서 바뀐 자리 — {@link PushResult.placementChanges}. */
+interface PlacementChange {
+    readonly path: string;
+    /** 무엇이 되었나 — DB 의 행 · 페이지. */
+    readonly becomes: "row" | "page";
+    /** 다른 DB 에서 온 행이 대상 DB 에 더한(더할) 열 — Notion 이 값이 있는 속성을 열로 더한다. 없으면 생략. */
+    readonly addedColumns?: readonly string[];
+}
+/** 고친 `.base` 의 보기 하나가 Notion 보기에 한 일 — {@link PushResult.viewEdits}. */
+interface ViewEdit {
+    /** `.base` 경로. */
+    readonly path: string;
+    /** 보기 이름(바꿨으면 새 이름). */
+    readonly view: string;
+    /** 이름을 바꿨으면 옛 이름. */
+    readonly from?: string;
+    /** 올린 것 — 이름 · 열 · 정렬 · 필터. */
+    readonly changed: readonly ("name" | "columns" | "sort" | "filter")[];
+}
+/** 고친 사이드카 하나가 Notion DB 에 한 일 — {@link PushResult.schemaEdits}. */
+interface SchemaEdit {
+    /** 사이드카 경로. */
+    readonly path: string;
+    readonly added: readonly string[];
+    readonly removed: readonly string[];
+    /** 옛 이름 → 새 이름. */
+    readonly renamed: ReadonlyArray<readonly [string, string]>;
+    /** 속성 이름 → 새 타입. */
+    readonly retyped: ReadonlyArray<readonly [string, string]>;
+    /** 설정(수식 · 숫자 형식 · 옵션)을 바꾼 속성. */
+    readonly redefined: readonly string[];
+    /**
+     * 지운 선택 옵션 — 속성 이름 → 옵션 이름. Notion 은 그 옵션을 가진 행의 값을 비운다(옵션 이름을 바꾼 것도 지우고
+     * 새로 만든 것이다). 없으면 지운 옵션이 없다.
+     */
+    readonly droppedOptions?: ReadonlyArray<readonly [string, readonly string[]]>;
+}
+/** 볼트에서 바꾼 DB 속성 이름 하나 — {@link PushResult.renamedProperties}. */
+interface PropertyRename {
+    /** DB 폴더. */
+    readonly folder: string;
+    readonly from: string;
+    readonly to: string;
 }
 /** 노트 하나에서 올리지 않은 읽기 전용 속성. */
 interface ReadOnlySkip {
@@ -513,6 +580,22 @@ interface RemoteScanInfo {
     /** 바뀐 것이 보이지 않아 조회하지 않은 DB 수 — pull 에만. */
     readonly skippedDatabases?: number;
 }
+/** Notion 에서 바뀐 DB 속성을 행 노트의 키에 옮긴 것(ADR-045). */
+interface SchemaFollowed {
+    /** DB 폴더. */
+    readonly folder: string;
+    /** 옛 이름 → 새 이름. */
+    readonly renamed: ReadonlyArray<readonly [string, string]>;
+    /** Notion 에서 지운 속성. */
+    readonly removed: readonly string[];
+    /** 키를 바꾼 행 노트 수. */
+    readonly rows: number;
+    /** 지운 속성이지만 올리지 않은 로컬 값이 있어 노트에 남긴 키. */
+    readonly kept: ReadonlyArray<{
+        readonly path: string;
+        readonly key: string;
+    }>;
+}
 interface PullResult {
     readonly created: number;
     readonly updated: number;
@@ -525,6 +608,17 @@ interface PullResult {
     readonly restored: number;
     /** 되살린(dry-run 은 되살릴) 노트 · 행의 경로 — {@link restored} 의 목록. 없으면 생략. */
     readonly restoredPaths?: readonly string[];
+    /**
+     * 볼트에서 고쳐 덮어쓰지 않은 사이드카(`.notion.json`) — push 하면 고친 속성을 Notion 에 올린다(ADR-045). 없으면 생략.
+     */
+    readonly heldSidecars?: readonly string[];
+    /**
+     * 볼트에서 보기를 고쳐 덮어쓰지 않은 `.base` — push 하면 고친 보기 이름 · 열 · 정렬 · 필터를 Notion 에 올린다(ADR-046).
+     * 없으면 생략.
+     */
+    readonly heldBases?: readonly string[];
+    /** Notion 에서 바뀐 속성을 행 노트에 옮긴 DB 마다(ADR-045). 없으면 생략. */
+    readonly schemaFollowed?: readonly SchemaFollowed[];
     readonly conflicts: Conflict[];
     readonly writtenPaths: string[];
     readonly failed: FailedOperation[];
@@ -778,6 +872,13 @@ interface ViewRequest {
     readonly quick_filters?: Record<string, unknown>;
     readonly configuration?: Record<string, unknown>;
 }
+/** `views.update` 에 보낼 고침 — 보내지 않은 항목은 그대로, null 은 지운다. */
+interface ViewUpdateRequest {
+    readonly name?: string;
+    readonly filter?: unknown;
+    readonly sorts?: unknown[] | null;
+    readonly configuration?: Record<string, unknown>;
+}
 interface DatabaseViewsConfig {
     readonly databaseId: string;
     readonly databaseName?: string;
@@ -1399,10 +1500,14 @@ interface DatabaseMeta {
     readonly databaseId: string;
     /** DB 제목. 없으면 "". */
     readonly title: string;
-    /** 행을 조회할 data source. 비었으면 옛 단일 소스 DB 다 — DB id 로 조회한다. */
+    /**
+     * 행을 조회할 data source. 비었으면 옛 단일 소스 DB 다 — DB id 로 조회한다. `properties` 는 그 소스만의 속성
+     * 스키마(읽지 못했으면 없다) — 속성 id 는 소스마다 따로 붙는다.
+     */
     readonly dataSources: ReadonlyArray<{
         readonly id: string;
         readonly name: string;
+        readonly properties?: Readonly<Record<string, unknown>>;
     }>;
     /**
      * 속성 스키마 — 읽을 수 있는 모든 data source 의 속성을 합친 것(이름이 겹치면 앞의 것). 읽을 수 있는 data
@@ -1411,6 +1516,11 @@ interface DatabaseMeta {
     readonly properties: Readonly<Record<string, unknown>>;
     /** 페이지 본문 안에 놓인 인라인 DB 인가. */
     readonly isInline: boolean;
+    /**
+     * DB 가 바로 아래에 놓인 페이지 — 블록(토글 · 열) 안이거나 워크스페이스 맨 위면 null. 모르면(읽지 않았으면) 없다.
+     * Notion 에서 DB 를 옮겨도 수정 시각이 그대로라, 받은 DB 의 부모로만 옮긴 것을 안다(ADR-047).
+     */
+    readonly parentPageId?: string | null;
     /** DB 의 아이콘 · 커버 · 설명 · 제목 표시 — 받은 그대로. */
     readonly appearance?: DatabaseAppearance;
 }
@@ -1493,6 +1603,8 @@ declare class NotionClient {
         title: string;
         properties?: Record<string, unknown>;
         children?: BlockObjectResponse[];
+        /** 행을 둘 data source — 데이터 소스가 여럿인 DB 는 이것이 있어야 만든다. */
+        dataSourceId?: string;
     }): Promise<PageObjectResponse>;
     /**
      * 페이지 아래에 DB 를 만든다(ADR-036). 같은 요청이 두 번 적용되면 DB 가 둘이 된다 — 다시 보내지 않는다.
@@ -1527,6 +1639,8 @@ declare class NotionClient {
         title: string;
         markdown: string;
         properties?: Record<string, unknown>;
+        /** 행을 둘 data source — 데이터 소스가 여럿인 DB 는 이것이 있어야 만든다. */
+        dataSourceId?: string;
     }): Promise<PageObjectResponse>;
     /**
      * {@link createPageWithMarkdown} 이 버린 맨 앞 `# H1` 을 되살린다 — 그 markdown 이 H1 으로
@@ -1578,6 +1692,31 @@ declare class NotionClient {
      * 같은 부모로 다시 옮겨도 결과가 같아 모호한 실패는 다시 보낸다.
      */
     movePage(pageId: string, parentPageId: string): Promise<void>;
+    /**
+     * 페이지 · 행을 DB 의 data source 로 옮긴다 — 같은 `pages.move`. 페이지는 행이 되고, 다른 DB 의 행은 이 DB 의
+     * 행이 된다. id · 본문 · 자식은 그대로다(2026-10-27 실측). `database_id` 부모는 400 이라 data source 로만 옮긴다.
+     * 다른 DB 에서 오면 값이 있는 속성 가운데 이 DB 에 없는 것은 Notion 이 열로 더한다(2026-10-30 실측).
+     */
+    /**
+     * DB 의 지금 자리 — 부모와 제목. 볼트에서 옮긴 DB 폴더를 Notion 에서도 옮길지 정할 때 읽는다(ADR-047). 메타 캐시를 쓰지
+     * 않는다 — 옮기기 직전의 자리여야 한다.
+     *
+     * @returns 부모가 페이지면 `pageId`, 블록(토글 · 열 안의 인라인 DB) · 워크스페이스면 null.
+     */
+    getDatabasePlacement(databaseId: string): Promise<{
+        readonly parentType: string;
+        readonly pageId: string | null;
+        readonly title: string;
+    }>;
+    /**
+     * DB 를 다른 페이지 아래로 옮기거나 제목을 바꾼다(`databases.update`). 2026-10-30 실측 — 부모를 바꾸면 200 이고 DB id ·
+     * 행 · 보기는 그대로다. 같은 요청을 다시 보내도 결과가 같다.
+     */
+    updateDatabasePlacement(databaseId: string, change: {
+        readonly parentPageId?: string;
+        readonly title?: string;
+    }): Promise<void>;
+    movePageToDataSource(pageId: string, dataSourceId: string): Promise<void>;
     /**
      * 데이터베이스 1개를 신 모델(2025-09-03 data source 분리)로 조회한다 — DB 1회 + data source 마다 1회.
      * - title · data source 목록: database 객체에 그대로 존재한다.
@@ -1822,6 +1961,11 @@ declare class NotionClient {
     }): Promise<string>;
     /** 보기를 지운다. DB 의 마지막 보기는 지우지 못한다(400). */
     deleteView(viewId: string): Promise<void>;
+    /**
+     * 보기를 고친다(ADR-046). 보내지 않은 항목은 그대로 두고 null 은 지운다. `configuration.properties` 는 통째로 바뀐다 —
+     * 목록에 없는 속성은 숨겨지고 목록 차례가 열 차례다(2026-10-29 실측).
+     */
+    updateView(viewId: string, request: ViewUpdateRequest): Promise<void>;
     getView(viewId: string): Promise<ViewConfig | null>;
     getDatabaseViewsConfig(databaseId: string): Promise<DatabaseViewsConfig>;
     extractCover(page: PageObjectResponse): PageCover | null;
@@ -2307,6 +2451,17 @@ interface BaseFileOptions {
     readonly rangeEnds?: ReadonlyMap<string, string>;
 }
 type BasesViewType = "table" | "cards" | "list";
+/** `.base` 에 쓴 보기 하나가 어느 Notion 보기에서 왔나 — `views[]` 와 같은 차례(push 가 고친 보기를 올린다, ADR-046). */
+interface WrittenBasesView {
+    readonly viewId: string;
+    /** Notion 필터 가운데 `.base` 로 옮기지 못한 조건이 있다 — 볼트의 필터로 Notion 필터를 덮으면 그 조건이 사라진다. */
+    readonly lossyFilter: boolean;
+}
+/** `.base` 내용과 그 안의 보기들의 출처. */
+interface GeneratedBaseFile {
+    readonly content: string;
+    readonly views: readonly WrittenBasesView[];
+}
 /** Notion 뷰 하나를 Bases 로 옮길 때의 판정. */
 interface BasesViewMapping {
     /** Bases 뷰 타입. `null` = 대응이 없어 `.base` 에 실을 수 없음. */
@@ -2320,9 +2475,9 @@ interface BasesViewMapping {
 /**
  * Notion 뷰 타입 → Obsidian Bases 뷰 매핑(SSOT).
  *
- * 뷰는 현재 pull-authoritative — Notion API 가 2026-03-19 뷰 생성/수정/삭제를 열었지만
- * 본 프로젝트는 아직 뷰 write-back 을 구현하지 않았다(로드맵 항목). push 로 되돌릴 수
- * 없는 동안 "조용한 유실 금지"는 곧 "보존 + 정직한 degrade 리포트"를 의미한다.
+ * 볼트에서 고친 보기의 이름 · 열 · 정렬 · 필터는 push 가 Notion 보기에 올린다(ADR-046). 보기 타입은 옮기지
+ * 않는다 — 대응이 없는 것은 "보존 + 정직한 degrade 리포트"다. 칸반(Bases 1.14)은 최소 지원 버전(1.12.4)에
+ * 없어 보드를 카드로 둔다.
  *
  * 달력·타임라인은 예전에 `null` 이었다 — 즉 `.base` 에서 **통째로 사라졌다**. 사이드카에는
  * 남지만 Obsidian 을 여는 사람 눈에는 그 뷰가 애초에 없었던 것처럼 보인다. 격자·축은
@@ -2336,6 +2491,8 @@ declare function basesViewMappingOf(notionType: string): BasesViewMapping;
 declare function basesViewTypeOf(notionType: string): BasesViewType | null;
 declare class BaseFileGenerator {
     generate(options: BaseFileOptions): string;
+    /** `.base` 내용과 함께 쓴 보기마다 어느 Notion 보기에서 왔는지 돌려준다 — pull 이 기록해 push 가 견준다. */
+    generateWithViews(options: BaseFileOptions): GeneratedBaseFile;
     private writeFilters;
     private needsContentCoverFormula;
     private writeFormulas;
@@ -2510,6 +2667,8 @@ interface FolderDatabaseReport extends FolderDatabaseDraft {
     readonly folder: string;
     readonly sidecarPath: string;
     readonly rows: number;
+    /** 그중 이미 Notion 페이지로 올라간 노트 — push 가 같은 페이지째 행으로 옮긴다(ADR-047). */
+    readonly pagesToRows: number;
 }
 
 /**
@@ -2549,10 +2708,17 @@ declare class SyncOrchestrator {
     private readonly databaseSyncer;
     /** DB 행 push 용 — DB 마다 스키마를 읽은 매퍼. 실행마다 비운다(S-01). */
     private readonly rowSchemas;
+    /** 볼트에서 바꾼 DB 속성 이름을 Notion 의 열 이름으로(ADR-045). */
+    private readonly vaultRenames;
+    /** 볼트에서 고친 사이드카의 속성을 Notion DB 의 열로(ADR-045). */
+    private readonly sidecarEdits;
+    /** 볼트에서 고친 `.base` 의 보기를 Notion 보기로(ADR-046). */
+    private readonly viewEdits;
     private readonly observation;
     private readonly placement;
     private readonly databaseCreator;
     private readonly planner;
+    private readonly databaseMover;
     private readonly remoteMoves;
     private readonly remoteRenames;
     private readonly linkUpdater;
@@ -3060,6 +3226,31 @@ declare class ConversionPipeline {
     convertToMarkdown(content: string, context: ConversionContext, metadata?: ProcessorMetadata): string;
 }
 
+/**
+ * pull 이 `.base` 에 쓴 보기 하나의 기록 — push 가 볼트에서 고친 보기를 이것과 견줘 Notion 보기에 올린다(ADR-046).
+ *
+ * 견주는 값(이름 · 열 · 정렬 · 필터)은 쓴 글자가 아니라 **YAML 로 읽은 값**이다. Obsidian 은 보기를 고치면 `.base` 를
+ * 통째로 다시 쓴다 — 주석이 사라지고 키 차례 · 따옴표가 바뀐다(1.13.7 실측). 읽은 값으로 견줘야 그런 차이를 고친 것으로
+ * 보지 않는다.
+ */
+interface BaseViewRecord {
+    readonly viewId: string;
+    /** Bases 보기 타입 — 이름을 바꾼 보기를 자리로 찾을 때 같은 타입인지 본다. */
+    readonly type: string;
+    readonly name: string;
+    readonly order?: readonly string[];
+    readonly sort?: readonly BasesSort[];
+    readonly filters?: unknown;
+    /** Notion 필터에 `.base` 로 옮기지 못한 조건이 있었다 — 볼트의 필터로 덮으면 그 조건이 사라진다. */
+    readonly lossyFilter?: true;
+    /** 그때 Notion 보기의 지문({@link viewFingerprint}) — 그 사이 Notion 에서도 고쳤는지 가른다. */
+    readonly notion: string;
+}
+interface BasesSort {
+    readonly property: string;
+    readonly direction: string;
+}
+
 interface DbBaseFile {
     readonly basePath: string;
     readonly title: string;
@@ -3068,6 +3259,13 @@ interface DbBaseFile {
      * 적은 기록에는 없다 — 그때는 가를 수 없어 예전처럼 쓰고, 쓴 해시부터 적는다.
      */
     readonly hash?: string;
+    /**
+     * pull 이 쓴 보기들 — 볼트에서 고친 보기를 push 가 Notion 보기에 올릴 때 견준다(ADR-046). pull 이 이 경로에 쓴
+     * 파일에만 있다(직접 만든 `.base` 에는 없다).
+     */
+    readonly views?: readonly BaseViewRecord[];
+    /** 올리지 않는 나머지의 지문(`restSignature`) — 같아야 고친 것을 모두 올린 것이다. */
+    readonly rest?: string;
 }
 /**
  * DB 마다 실제로 기록한 `.base` 경로와 DB 제목 — 인라인 DB placeholder 를 `.base` 임베드로 바꿀 때
@@ -3085,6 +3283,8 @@ declare class DbBaseFiles {
     private loadedRaw;
     constructor(stateDb: Pick<IStateDB, "getMeta" | "setMeta">);
     get(databaseId: string): DbBaseFile | undefined;
+    /** 기록한 DB 모두 — 키는 줄인 DB id. */
+    all(): Array<[string, DbBaseFile]>;
     set(databaseId: string, info: DbBaseFile): void;
     /** 상태 메타에서 읽는다 — 값이 그대로면 읽어 둔 것을 쓴다. 없거나 깨졌으면 비어 있다 — 이번 실행이 기록하는 것부터 다시 쌓는다. */
     private load;
@@ -3192,8 +3392,11 @@ interface DatabaseSyncResult {
 interface PlannedRow {
     readonly pageId: string;
     readonly path: string;
-    readonly operation: "create" | "update" | "delete";
+    /** `move` — Notion 에서 다른 페이지 아래로 옮긴 DB 의 폴더를 옮긴다(`pageId` 는 DB, ADR-047). */
+    readonly operation: "create" | "update" | "delete" | "move";
     readonly restore?: boolean;
+    /** Notion 에서 DB 안으로 옮긴 페이지가 행이 되며 옮길 것 — 노트와 하위 페이지 폴더 · 옮긴 DB 의 폴더(ADR-047). */
+    readonly moves?: readonly RemoteMove[];
 }
 /**
  * 행을 받는 진행 — 진행 표시가 페이지와 행을 한 목록 · 한 수로 보이게 한다. 행은 DB 를 조회해야 몇
@@ -3237,11 +3440,21 @@ declare class DatabaseSyncer {
     private renamedRows;
     /** 볼트에서 사라져 되살린 행의 경로 — pull 마감이 가져가 화면에 알린다(D8). */
     private restoredRows;
+    /** Notion 에서 바뀐 속성을 행 노트에 옮긴 것 — pull 마감이 가져가 화면에 알린다(ADR-045). */
+    private schemaFollowed;
+    /** pull 이 마지막으로 쓴 사이드카 — 볼트에서 고친 것은 덮어쓰지 않는다(ADR-045). */
+    private readonly sidecarBases;
+    /** 이번 pull 이 고쳐 둔 것이라 덮어쓰지 않은 사이드카 경로. */
+    private heldSidecars;
+    /** 이번 pull 이 볼트에서 고친 것이라 덮어쓰지 않은 `.base` 경로(ADR-046). */
+    private heldBases;
     /**
      * 실제로 기록한 .base 경로/DB 제목 — placeholder 임베드 재작성(F22)의 SSOT. 이번 pull 이 조회하지
      * 않은 DB 의 것도 남아 있다({@link DbBaseFiles}).
      */
     readonly baseFileInfo: DbBaseFiles;
+    /** DB 마다 지난 pull 이 본 속성 — Notion 에서 바꾼 속성 이름을 행 노트에 옮기는 근거(ADR-045). */
+    private readonly schemaLedger;
     private get decorations();
     constructor(config: Config, stateDb: IStateDB, notionClient: NotionClient, vaultFs: VaultFS, pipeline: ConversionPipeline, imageHandler: ImageHandler, 
     /**
@@ -3284,6 +3497,11 @@ declare class DatabaseSyncer {
          * 행 파일은 쓰지 않는다.
          */
         rescanRowChildren?: boolean;
+        /**
+         * 발견한 DB 다 — Notion 에서 다른 페이지 아래로 옮겼으면 볼트에서도 폴더를 옮기고 알린다({@link placementMoveOf}).
+         * 설정 파일에 적은 DB 의 폴더는 사용자가 정했다 — 주지 않는다.
+         */
+        onFolderMoved?: (move: RemoteMove) => void;
     }): Promise<DatabaseSyncResult>;
     /**
      * 받지 않는 행의 본문을 읽어 하위 페이지만 알린다(`--force`). 읽지 못한 행은 경고만 남긴다 — 그 행은 받을 것이
@@ -3301,7 +3519,14 @@ declare class DatabaseSyncer {
     planDatabase(dbConfig: DatabaseSyncConfig, opts?: {
         resolveDbFolder?: (databaseId: string) => string | null;
         paths?: readonly string[];
+        /** 발견한 DB 다 — Notion 에서 옮긴 DB 의 폴더 이동도 보인다({@link pullDatabase}). */
+        followPlacement?: boolean;
+        /**
+         * 볼트에서 옮긴 레코드 — dry-run 은 옮겨 적지 않아 이동 WAL 이 없다. 실제 pull 처럼 볼트가 먼저다.
+         */
+        movingInVault?: ReadonlySet<string>;
     }): Promise<PlannedRow[]>;
+    private planRows;
     /**
      * 이 DB 에서 볼 행을 조회한다. 범위(`paths`)가 이 DB 폴더에 닿지 않으면 조회하지 않는다 — 예전에는
      * 범위와 상관없이 모든 행을 만들고 고쳤다.
@@ -3332,30 +3557,53 @@ declare class DatabaseSyncer {
      *    (틀린) 전제로 db-row 를 제외해 두었기에 양쪽 어디에도 복원 경로가 없는 상태였다.
      *    deleteSync 가 켜져 있으면 되살리지 않는다 — 지운 것은 Notion 에서도 지우라는 뜻이고, sync 는
      *    pull 을 먼저 돌려 되살리면 뒤이은 push 가 지울 것을 잃는다(detectMissingLocalFiles 와 같다).
-     *  · 예전 버전이 적은 날짜 모양이 남은 행은 그 줄만 새 모양으로 고쳐 쓴다({@link outdatedDateForm},
-     *    F-08).
+     *  · 예전 버전이 적은 날짜 모양이 남은 행, Notion 이 새로 만들거나 타입을 바꾼 속성의 값이 다른 행은 그 줄만
+     *    고쳐 쓴다({@link staleKeysToRewrite}, F-08 · ADR-045).
+     *
+     * @param refreshed 이 행의 data source 에서 새로 생기거나 타입이 바뀐 속성의 키(ADR-045).
      */
     private rowAction;
     /**
-     * 원격이 그대로인 행이지만 예전 버전이 적은 날짜 모양(`…Z` · `…+09:00` · `{start, end}`)이 남아 새
-     * 모양으로 고쳐 쓸 행인가(F-08, {@link PropertyMapper.outdatedDateKeys}). 고쳐 쓰면 사본도 새 모양이
-     * 되어 다음 pull 은 건너뛴다.
+     * 원격이 그대로인 행이지만 그 줄만 고쳐 쓸 키가 있는가 — 예전 버전이 적은 날짜 모양(`…Z` · `…+09:00` ·
+     * `{start, end}`, F-08, {@link PropertyMapper.outdatedDateKeys}), 또는 Notion 이 새로 만들거나 타입을 바꾼
+     * 속성의 값이 적힌 것과 다른 키(ADR-045 — 수식 열을 더하면 행마다 값이 생기지만 행의 수정 시각은 그대로다).
+     * 고쳐 쓰면 사본도 새 값이 되어 다음 pull 은 건너뛴다.
      *
      * 지난 동기화 뒤 로컬을 고친 행은 고르지 않는다 — 로컬 편집을 지키느라 쓰지 않으니 pull 마다 고르기만
      * 한다. 그 편집을 올린 뒤의 pull 이 고른다. 로컬 파일을 읽지 못하면 고르지 않는다.
      */
-    private outdatedDateForm;
+    private staleKeysToRewrite;
+    /** 적힌 frontmatter 에서 받은 값으로 고쳐 쓸 키 — {@link staleKeysToRewrite}. */
+    private staleKeys;
     /**
-     * 예전 버전이 적은 날짜 모양이 남은 행에서 그 키들만 새 모양으로 고쳐 쓴다(F-08) — 원격이 그대로라 본문 ·
-     * 첨부는 다시 받지 않는다. 본문은 한 글자도 바꾸지 않고, 다른 키의 줄은 그대로 둔다(키 단위로 나눠 읽을
-     * 수 없는 frontmatter 는 값만 지킨다 — {@link mergeRowFrontmatter}).
+     * 원격이 그대로인 행에서 {@link staleKeys} 의 키만 받은 값으로 고쳐 쓴다 — 본문 · 첨부는 다시 받지 않는다. 본문은
+     * 한 글자도 바꾸지 않고, 다른 키의 줄은 그대로 둔다(키 단위로 나눠 읽을 수 없는 frontmatter 는 값만 지킨다 —
+     * {@link mergeRowFrontmatter}).
      *
      * 예전에는 행을 통째로 다시 받았다. 행마다 본문을 읽어 요청이 늘고, 다시 그릴 때마다 달라지는 본문(빈
      * 블록 · 첨부 이름)까지 바뀌었다 — 실볼트 사본에서 다시 받은 149행 중 99행.
      *
      * 고른 뒤 로컬을 고쳤으면 쓰지 않는다(`skipped`) — 이어지는 push 가 올린다.
      */
-    private rewriteDateForms;
+    private rewriteStaleKeys;
+    /**
+     * Notion 에서 바뀐 속성을 지난 pull 이 본 스키마와 id 로 견줘 행 노트에 옮긴다(ADR-045) — 이름을 바꾼 속성은 키
+     * 이름을, 지운 속성은 키를. 새로 생기거나 타입이 바뀐 속성은 돌려준다 — 그대로인 행도 그 값을 고쳐 쓴다.
+     *
+     * 처음 보는 DB 는 견줄 것이 없어 적기만 한다. 행 하나라도 옮기지 못하면 본 스키마를 적지 않는다 — 다음 pull 이 다시
+     * 옮긴다(이미 옮긴 행은 바꿀 것이 없다).
+     *
+     * @returns 바뀐 속성(data source → 바뀐 것, 바뀐 소스만)과 키를 바꾼 행의 레코드 id.
+     */
+    private followSchema;
+    /** 옮긴 것을 pull 마감이 알리게 적는다 — 이름 바꿈 · 지움이 있었던 DB 만. 날짜 범위 끝 키는 따로 세지 않는다. */
+    private noteSchemaFollowed;
+    /** 이번 pull 이 행 노트에 옮긴 Notion 속성 변경 — 가져가면 비운다(ADR-045). */
+    /** 고쳐 둔 것이라 덮어쓰지 않은 사이드카 — 가져가면 비운다. */
+    takeHeldSidecars(): string[];
+    /** 고쳐 둔 것이라 덮어쓰지 않은 `.base` — 가져가면 비운다. */
+    takeHeldBases(): string[];
+    takeSchemaFollowed(): SchemaFollowed[];
     /** 이 DB 의 추적 행 가운데 이번 조회에 없던 것 — 지워졌는지는 아직 모른다. */
     private unlistedRows;
     /**
@@ -3437,6 +3685,8 @@ declare class DatabaseSyncer {
         properties: Record<string, unknown>;
         /** 받은 원격 본문의 지문(`remoteBodyFingerprint`). */
         bodyFingerprint: string;
+        /** 원격 본문에 페이지 시절의 속성 블록이 있었나 — 받으며 걷어 냈다. */
+        propertiesBlock: boolean;
     }>;
     /**
      * 행의 본문 밖이 지난 동기화 사본 그대로인가(N-05) — 제목과 보낼 수 있는 속성, 아이콘 · 커버.
@@ -3458,11 +3708,38 @@ declare class DatabaseSyncer {
     private rowPathOwners;
     /** 되살린 행의 경로를 가져가고 비운다. */
     takeRestoredRows(): string[];
+    /**
+     * Notion 에서 다른 페이지 아래로 옮긴 DB 의 폴더를 볼트에서도 옮긴다 — 옮겼으면 그 이동. 옮기지 못하면 까닭을 남기고
+     * 옛 자리에서 받는다.
+     */
+    private followPlacement;
+    /** 옮길 수 있으면 그 이동, 막혔으면 까닭을 알리고 null. */
+    private unblocked;
+    /** 볼트에서 옮기고 아직 올리지 않았나 — 이동 WAL, 또는 dry-run 이 옮겨 적지 않은 이번 이동. */
+    private movedInVault;
+    /**
+     * Notion 에서 다른 페이지 아래로 옮긴 발견 DB 의 폴더를 옮길 곳(ADR-047) — 제자리면 null.
+     *
+     * Notion 에서 DB 를 옮겨도 DB · 행의 수정 시각이 그대로라 받은 DB 의 부모로만 안다 — 전체 대조는 모든 DB 를 받으니
+     * 거기서 보인다. 새 자리는 처음 발견할 때와 같다 — 부모 페이지의 하위 폴더 이름 그대로, 루트면 `databases` 선반.
+     * 맨 위 폴더도 루트 아래로 본다(볼트에서 옮긴 DB 를 push 가 루트 아래에 둔다 — {@link DatabaseMover}).
+     * 다음은 옮기지 않는다.
+     *   - 부모가 블록(토글 · 열) 안 · 볼트가 모르는 페이지 — 볼트에 그 자리가 없다
+     *   - 볼트에서 옮긴 DB 폴더 · 부모 노트를 아직 올리지 않았다 — 볼트가 먼저다(push 가 Notion 을 옮긴다)
+     */
+    private placementMoveOf;
+    /** 이 폴더가 받는 DB — 설정한 DB 와 발견한 DB 에서. */
+    private databaseAt;
     /** 이름을 바꾼 행을 가져가고 비운다. */
     takeRenamedRows(): {
         renamed: RemoteMove[];
         applied: RemoteMove[];
     };
+    /**
+     * 행이 된 페이지의 하위 페이지 폴더 — 폴더 노트(`X/X.md`)는 든 폴더, 노트는 옆의 `X/`. 행의 하위 페이지는 `행/` 에
+     * 든다. 추적하는 노트가 없으면 null.
+     */
+    private adoptedChildrenOf;
     private pullDatabasePage;
 }
 
@@ -3886,7 +4163,7 @@ declare function resolvePropertyName(propertyId: string, schema: Record<string,
  *
  * ## 부분 번역의 안전 규칙 — 이 파일의 핵심
  *
- * Notion 필터 문법은 Bases 보다 넓다(rollup any/every/none, 상대 날짜, formula 등).
+ * Notion 필터 문법은 Bases 보다 넓다(rollup any/every/none, 이번 주(this_week), formula 등).
  * 못 옮기는 리프를 만났을 때 **어느 방향으로 틀릴지**는 논리 위치에 따라 다르다:
  *
  *   - `and` 안에서 리프 하나를 버리면 조건이 느슨해진다 → 결과는 **상위집합**.
@@ -4069,6 +4346,7 @@ declare function notionIdsEqual(a: string, b: string): boolean;
  * markdown-api 경로(convertPageMentions)가 동일 형태로 수렴하도록 한다(rank20/I3).
  */
 declare function compactNotionId(id: string): string;
+declare function shortNotionId(id: string): string;
 
 /** Notion 제목 → 볼트 파일 이름(확장자 없이). */
 declare function sanitizeFileName(name: string): string;
@@ -4475,4 +4753,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, 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 };
+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 DatabaseMove, 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 PlacementChange, type PlannedRow, type PreserveMarker, PreserveMarkerCollector, PreserveMarkerInjector, type Processor, type ProcessorInput, type ProcessorMetadata, type ProcessorOutput, type ProgressCallback, type ProgressItem, PropertiesTableInjector, PropertiesTableRestorer, PropertyMapper, type PropertyOption, type PropertyRename, 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, type SchemaEdit, type SchemaFollowed, 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 ViewEdit, 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, shortNotionId, sortEntries, stateDbLockPath, stateDbWalPath, stripMarkdownExtension, summarizeFidelity, systemTimeZone, threeWayMerge, toVaultPath, translateNotionFilter, verifyDatabaseCompleteness, verifyPageCompleteness, wikilinkLookupsIn };