@im-nobsidian/core 0.12.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -474,6 +474,51 @@ interface PushResult {
474
474
  * 예전에는 아무 말 없이 대기로 적기만 해, 지운 파일이 다음 pull 에 말없이 돌아왔다(D8). 없으면 빈 목록 · 생략.
475
475
  */
476
476
  readonly unsentDeletions?: readonly string[];
477
+ /**
478
+ * 볼트에서 바꾼 DB 속성 이름(Obsidian 의 속성 이름 바꾸기)을 Notion 의 열 이름으로 바꾼 것 — dry-run 은 바꿀 것
479
+ * (ADR-045). 없으면 생략.
480
+ */
481
+ readonly renamedProperties?: readonly PropertyRename[];
482
+ /** 볼트에서 고친 사이드카의 속성을 Notion DB 에 올린 것 — dry-run 은 올릴 것(ADR-045). 없으면 생략. */
483
+ readonly schemaEdits?: readonly SchemaEdit[];
484
+ /** 볼트에서 고친 `.base` 보기를 Notion 보기에 올린 것(ADR-046) — dry-run 이면 올릴 것. */
485
+ readonly viewEdits?: readonly ViewEdit[];
486
+ }
487
+ /** 고친 `.base` 의 보기 하나가 Notion 보기에 한 일 — {@link PushResult.viewEdits}. */
488
+ interface ViewEdit {
489
+ /** `.base` 경로. */
490
+ readonly path: string;
491
+ /** 보기 이름(바꿨으면 새 이름). */
492
+ readonly view: string;
493
+ /** 이름을 바꿨으면 옛 이름. */
494
+ readonly from?: string;
495
+ /** 올린 것 — 이름 · 열 · 정렬 · 필터. */
496
+ readonly changed: readonly ("name" | "columns" | "sort" | "filter")[];
497
+ }
498
+ /** 고친 사이드카 하나가 Notion DB 에 한 일 — {@link PushResult.schemaEdits}. */
499
+ interface SchemaEdit {
500
+ /** 사이드카 경로. */
501
+ readonly path: string;
502
+ readonly added: readonly string[];
503
+ readonly removed: readonly string[];
504
+ /** 옛 이름 → 새 이름. */
505
+ readonly renamed: ReadonlyArray<readonly [string, string]>;
506
+ /** 속성 이름 → 새 타입. */
507
+ readonly retyped: ReadonlyArray<readonly [string, string]>;
508
+ /** 설정(수식 · 숫자 형식 · 옵션)을 바꾼 속성. */
509
+ readonly redefined: readonly string[];
510
+ /**
511
+ * 지운 선택 옵션 — 속성 이름 → 옵션 이름. Notion 은 그 옵션을 가진 행의 값을 비운다(옵션 이름을 바꾼 것도 지우고
512
+ * 새로 만든 것이다). 없으면 지운 옵션이 없다.
513
+ */
514
+ readonly droppedOptions?: ReadonlyArray<readonly [string, readonly string[]]>;
515
+ }
516
+ /** 볼트에서 바꾼 DB 속성 이름 하나 — {@link PushResult.renamedProperties}. */
517
+ interface PropertyRename {
518
+ /** DB 폴더. */
519
+ readonly folder: string;
520
+ readonly from: string;
521
+ readonly to: string;
477
522
  }
478
523
  /** 노트 하나에서 올리지 않은 읽기 전용 속성. */
479
524
  interface ReadOnlySkip {
@@ -513,6 +558,22 @@ interface RemoteScanInfo {
513
558
  /** 바뀐 것이 보이지 않아 조회하지 않은 DB 수 — pull 에만. */
514
559
  readonly skippedDatabases?: number;
515
560
  }
561
+ /** Notion 에서 바뀐 DB 속성을 행 노트의 키에 옮긴 것(ADR-045). */
562
+ interface SchemaFollowed {
563
+ /** DB 폴더. */
564
+ readonly folder: string;
565
+ /** 옛 이름 → 새 이름. */
566
+ readonly renamed: ReadonlyArray<readonly [string, string]>;
567
+ /** Notion 에서 지운 속성. */
568
+ readonly removed: readonly string[];
569
+ /** 키를 바꾼 행 노트 수. */
570
+ readonly rows: number;
571
+ /** 지운 속성이지만 올리지 않은 로컬 값이 있어 노트에 남긴 키. */
572
+ readonly kept: ReadonlyArray<{
573
+ readonly path: string;
574
+ readonly key: string;
575
+ }>;
576
+ }
516
577
  interface PullResult {
517
578
  readonly created: number;
518
579
  readonly updated: number;
@@ -525,6 +586,17 @@ interface PullResult {
525
586
  readonly restored: number;
526
587
  /** 되살린(dry-run 은 되살릴) 노트 · 행의 경로 — {@link restored} 의 목록. 없으면 생략. */
527
588
  readonly restoredPaths?: readonly string[];
589
+ /**
590
+ * 볼트에서 고쳐 덮어쓰지 않은 사이드카(`.notion.json`) — push 하면 고친 속성을 Notion 에 올린다(ADR-045). 없으면 생략.
591
+ */
592
+ readonly heldSidecars?: readonly string[];
593
+ /**
594
+ * 볼트에서 보기를 고쳐 덮어쓰지 않은 `.base` — push 하면 고친 보기 이름 · 열 · 정렬 · 필터를 Notion 에 올린다(ADR-046).
595
+ * 없으면 생략.
596
+ */
597
+ readonly heldBases?: readonly string[];
598
+ /** Notion 에서 바뀐 속성을 행 노트에 옮긴 DB 마다(ADR-045). 없으면 생략. */
599
+ readonly schemaFollowed?: readonly SchemaFollowed[];
528
600
  readonly conflicts: Conflict[];
529
601
  readonly writtenPaths: string[];
530
602
  readonly failed: FailedOperation[];
@@ -778,6 +850,13 @@ interface ViewRequest {
778
850
  readonly quick_filters?: Record<string, unknown>;
779
851
  readonly configuration?: Record<string, unknown>;
780
852
  }
853
+ /** `views.update` 에 보낼 고침 — 보내지 않은 항목은 그대로, null 은 지운다. */
854
+ interface ViewUpdateRequest {
855
+ readonly name?: string;
856
+ readonly filter?: unknown;
857
+ readonly sorts?: unknown[] | null;
858
+ readonly configuration?: Record<string, unknown>;
859
+ }
781
860
  interface DatabaseViewsConfig {
782
861
  readonly databaseId: string;
783
862
  readonly databaseName?: string;
@@ -1399,10 +1478,14 @@ interface DatabaseMeta {
1399
1478
  readonly databaseId: string;
1400
1479
  /** DB 제목. 없으면 "". */
1401
1480
  readonly title: string;
1402
- /** 행을 조회할 data source. 비었으면 옛 단일 소스 DB 다 — DB id 로 조회한다. */
1481
+ /**
1482
+ * 행을 조회할 data source. 비었으면 옛 단일 소스 DB 다 — DB id 로 조회한다. `properties` 는 그 소스만의 속성
1483
+ * 스키마(읽지 못했으면 없다) — 속성 id 는 소스마다 따로 붙는다.
1484
+ */
1403
1485
  readonly dataSources: ReadonlyArray<{
1404
1486
  readonly id: string;
1405
1487
  readonly name: string;
1488
+ readonly properties?: Readonly<Record<string, unknown>>;
1406
1489
  }>;
1407
1490
  /**
1408
1491
  * 속성 스키마 — 읽을 수 있는 모든 data source 의 속성을 합친 것(이름이 겹치면 앞의 것). 읽을 수 있는 data
@@ -1493,6 +1576,8 @@ declare class NotionClient {
1493
1576
  title: string;
1494
1577
  properties?: Record<string, unknown>;
1495
1578
  children?: BlockObjectResponse[];
1579
+ /** 행을 둘 data source — 데이터 소스가 여럿인 DB 는 이것이 있어야 만든다. */
1580
+ dataSourceId?: string;
1496
1581
  }): Promise<PageObjectResponse>;
1497
1582
  /**
1498
1583
  * 페이지 아래에 DB 를 만든다(ADR-036). 같은 요청이 두 번 적용되면 DB 가 둘이 된다 — 다시 보내지 않는다.
@@ -1527,6 +1612,8 @@ declare class NotionClient {
1527
1612
  title: string;
1528
1613
  markdown: string;
1529
1614
  properties?: Record<string, unknown>;
1615
+ /** 행을 둘 data source — 데이터 소스가 여럿인 DB 는 이것이 있어야 만든다. */
1616
+ dataSourceId?: string;
1530
1617
  }): Promise<PageObjectResponse>;
1531
1618
  /**
1532
1619
  * {@link createPageWithMarkdown} 이 버린 맨 앞 `# H1` 을 되살린다 — 그 markdown 이 H1 으로
@@ -1822,6 +1909,11 @@ declare class NotionClient {
1822
1909
  }): Promise<string>;
1823
1910
  /** 보기를 지운다. DB 의 마지막 보기는 지우지 못한다(400). */
1824
1911
  deleteView(viewId: string): Promise<void>;
1912
+ /**
1913
+ * 보기를 고친다(ADR-046). 보내지 않은 항목은 그대로 두고 null 은 지운다. `configuration.properties` 는 통째로 바뀐다 —
1914
+ * 목록에 없는 속성은 숨겨지고 목록 차례가 열 차례다(2026-10-29 실측).
1915
+ */
1916
+ updateView(viewId: string, request: ViewUpdateRequest): Promise<void>;
1825
1917
  getView(viewId: string): Promise<ViewConfig | null>;
1826
1918
  getDatabaseViewsConfig(databaseId: string): Promise<DatabaseViewsConfig>;
1827
1919
  extractCover(page: PageObjectResponse): PageCover | null;
@@ -2307,6 +2399,17 @@ interface BaseFileOptions {
2307
2399
  readonly rangeEnds?: ReadonlyMap<string, string>;
2308
2400
  }
2309
2401
  type BasesViewType = "table" | "cards" | "list";
2402
+ /** `.base` 에 쓴 보기 하나가 어느 Notion 보기에서 왔나 — `views[]` 와 같은 차례(push 가 고친 보기를 올린다, ADR-046). */
2403
+ interface WrittenBasesView {
2404
+ readonly viewId: string;
2405
+ /** Notion 필터 가운데 `.base` 로 옮기지 못한 조건이 있다 — 볼트의 필터로 Notion 필터를 덮으면 그 조건이 사라진다. */
2406
+ readonly lossyFilter: boolean;
2407
+ }
2408
+ /** `.base` 내용과 그 안의 보기들의 출처. */
2409
+ interface GeneratedBaseFile {
2410
+ readonly content: string;
2411
+ readonly views: readonly WrittenBasesView[];
2412
+ }
2310
2413
  /** Notion 뷰 하나를 Bases 로 옮길 때의 판정. */
2311
2414
  interface BasesViewMapping {
2312
2415
  /** Bases 뷰 타입. `null` = 대응이 없어 `.base` 에 실을 수 없음. */
@@ -2320,9 +2423,9 @@ interface BasesViewMapping {
2320
2423
  /**
2321
2424
  * Notion 뷰 타입 → Obsidian Bases 뷰 매핑(SSOT).
2322
2425
  *
2323
- * 뷰는 현재 pull-authoritative — Notion API 가 2026-03-19 뷰 생성/수정/삭제를 열었지만
2324
- * 본 프로젝트는 아직 뷰 write-back 을 구현하지 않았다(로드맵 항목). push 로 되돌릴 수
2325
- * 없는 동안 "조용한 유실 금지"는 곧 "보존 + 정직한 degrade 리포트"를 의미한다.
2426
+ * 볼트에서 고친 보기의 이름 · 열 · 정렬 · 필터는 push 가 Notion 보기에 올린다(ADR-046). 보기 타입은 옮기지
2427
+ * 않는다 — 대응이 없는 것은 "보존 + 정직한 degrade 리포트"다. 칸반(Bases 1.14)은 최소 지원 버전(1.12.4)에
2428
+ * 없어 보드를 카드로 둔다.
2326
2429
  *
2327
2430
  * 달력·타임라인은 예전에 `null` 이었다 — 즉 `.base` 에서 **통째로 사라졌다**. 사이드카에는
2328
2431
  * 남지만 Obsidian 을 여는 사람 눈에는 그 뷰가 애초에 없었던 것처럼 보인다. 격자·축은
@@ -2336,6 +2439,8 @@ declare function basesViewMappingOf(notionType: string): BasesViewMapping;
2336
2439
  declare function basesViewTypeOf(notionType: string): BasesViewType | null;
2337
2440
  declare class BaseFileGenerator {
2338
2441
  generate(options: BaseFileOptions): string;
2442
+ /** `.base` 내용과 함께 쓴 보기마다 어느 Notion 보기에서 왔는지 돌려준다 — pull 이 기록해 push 가 견준다. */
2443
+ generateWithViews(options: BaseFileOptions): GeneratedBaseFile;
2339
2444
  private writeFilters;
2340
2445
  private needsContentCoverFormula;
2341
2446
  private writeFormulas;
@@ -2549,6 +2654,12 @@ declare class SyncOrchestrator {
2549
2654
  private readonly databaseSyncer;
2550
2655
  /** DB 행 push 용 — DB 마다 스키마를 읽은 매퍼. 실행마다 비운다(S-01). */
2551
2656
  private readonly rowSchemas;
2657
+ /** 볼트에서 바꾼 DB 속성 이름을 Notion 의 열 이름으로(ADR-045). */
2658
+ private readonly vaultRenames;
2659
+ /** 볼트에서 고친 사이드카의 속성을 Notion DB 의 열로(ADR-045). */
2660
+ private readonly sidecarEdits;
2661
+ /** 볼트에서 고친 `.base` 의 보기를 Notion 보기로(ADR-046). */
2662
+ private readonly viewEdits;
2552
2663
  private readonly observation;
2553
2664
  private readonly placement;
2554
2665
  private readonly databaseCreator;
@@ -3060,6 +3171,31 @@ declare class ConversionPipeline {
3060
3171
  convertToMarkdown(content: string, context: ConversionContext, metadata?: ProcessorMetadata): string;
3061
3172
  }
3062
3173
 
3174
+ /**
3175
+ * pull 이 `.base` 에 쓴 보기 하나의 기록 — push 가 볼트에서 고친 보기를 이것과 견줘 Notion 보기에 올린다(ADR-046).
3176
+ *
3177
+ * 견주는 값(이름 · 열 · 정렬 · 필터)은 쓴 글자가 아니라 **YAML 로 읽은 값**이다. Obsidian 은 보기를 고치면 `.base` 를
3178
+ * 통째로 다시 쓴다 — 주석이 사라지고 키 차례 · 따옴표가 바뀐다(1.13.7 실측). 읽은 값으로 견줘야 그런 차이를 고친 것으로
3179
+ * 보지 않는다.
3180
+ */
3181
+ interface BaseViewRecord {
3182
+ readonly viewId: string;
3183
+ /** Bases 보기 타입 — 이름을 바꾼 보기를 자리로 찾을 때 같은 타입인지 본다. */
3184
+ readonly type: string;
3185
+ readonly name: string;
3186
+ readonly order?: readonly string[];
3187
+ readonly sort?: readonly BasesSort[];
3188
+ readonly filters?: unknown;
3189
+ /** Notion 필터에 `.base` 로 옮기지 못한 조건이 있었다 — 볼트의 필터로 덮으면 그 조건이 사라진다. */
3190
+ readonly lossyFilter?: true;
3191
+ /** 그때 Notion 보기의 지문({@link viewFingerprint}) — 그 사이 Notion 에서도 고쳤는지 가른다. */
3192
+ readonly notion: string;
3193
+ }
3194
+ interface BasesSort {
3195
+ readonly property: string;
3196
+ readonly direction: string;
3197
+ }
3198
+
3063
3199
  interface DbBaseFile {
3064
3200
  readonly basePath: string;
3065
3201
  readonly title: string;
@@ -3068,6 +3204,13 @@ interface DbBaseFile {
3068
3204
  * 적은 기록에는 없다 — 그때는 가를 수 없어 예전처럼 쓰고, 쓴 해시부터 적는다.
3069
3205
  */
3070
3206
  readonly hash?: string;
3207
+ /**
3208
+ * pull 이 쓴 보기들 — 볼트에서 고친 보기를 push 가 Notion 보기에 올릴 때 견준다(ADR-046). pull 이 이 경로에 쓴
3209
+ * 파일에만 있다(직접 만든 `.base` 에는 없다).
3210
+ */
3211
+ readonly views?: readonly BaseViewRecord[];
3212
+ /** 올리지 않는 나머지의 지문(`restSignature`) — 같아야 고친 것을 모두 올린 것이다. */
3213
+ readonly rest?: string;
3071
3214
  }
3072
3215
  /**
3073
3216
  * DB 마다 실제로 기록한 `.base` 경로와 DB 제목 — 인라인 DB placeholder 를 `.base` 임베드로 바꿀 때
@@ -3085,6 +3228,8 @@ declare class DbBaseFiles {
3085
3228
  private loadedRaw;
3086
3229
  constructor(stateDb: Pick<IStateDB, "getMeta" | "setMeta">);
3087
3230
  get(databaseId: string): DbBaseFile | undefined;
3231
+ /** 기록한 DB 모두 — 키는 줄인 DB id. */
3232
+ all(): Array<[string, DbBaseFile]>;
3088
3233
  set(databaseId: string, info: DbBaseFile): void;
3089
3234
  /** 상태 메타에서 읽는다 — 값이 그대로면 읽어 둔 것을 쓴다. 없거나 깨졌으면 비어 있다 — 이번 실행이 기록하는 것부터 다시 쌓는다. */
3090
3235
  private load;
@@ -3237,11 +3382,21 @@ declare class DatabaseSyncer {
3237
3382
  private renamedRows;
3238
3383
  /** 볼트에서 사라져 되살린 행의 경로 — pull 마감이 가져가 화면에 알린다(D8). */
3239
3384
  private restoredRows;
3385
+ /** Notion 에서 바뀐 속성을 행 노트에 옮긴 것 — pull 마감이 가져가 화면에 알린다(ADR-045). */
3386
+ private schemaFollowed;
3387
+ /** pull 이 마지막으로 쓴 사이드카 — 볼트에서 고친 것은 덮어쓰지 않는다(ADR-045). */
3388
+ private readonly sidecarBases;
3389
+ /** 이번 pull 이 고쳐 둔 것이라 덮어쓰지 않은 사이드카 경로. */
3390
+ private heldSidecars;
3391
+ /** 이번 pull 이 볼트에서 고친 것이라 덮어쓰지 않은 `.base` 경로(ADR-046). */
3392
+ private heldBases;
3240
3393
  /**
3241
3394
  * 실제로 기록한 .base 경로/DB 제목 — placeholder 임베드 재작성(F22)의 SSOT. 이번 pull 이 조회하지
3242
3395
  * 않은 DB 의 것도 남아 있다({@link DbBaseFiles}).
3243
3396
  */
3244
3397
  readonly baseFileInfo: DbBaseFiles;
3398
+ /** DB 마다 지난 pull 이 본 속성 — Notion 에서 바꾼 속성 이름을 행 노트에 옮기는 근거(ADR-045). */
3399
+ private readonly schemaLedger;
3245
3400
  private get decorations();
3246
3401
  constructor(config: Config, stateDb: IStateDB, notionClient: NotionClient, vaultFs: VaultFS, pipeline: ConversionPipeline, imageHandler: ImageHandler,
3247
3402
  /**
@@ -3332,30 +3487,53 @@ declare class DatabaseSyncer {
3332
3487
  * (틀린) 전제로 db-row 를 제외해 두었기에 양쪽 어디에도 복원 경로가 없는 상태였다.
3333
3488
  * deleteSync 가 켜져 있으면 되살리지 않는다 — 지운 것은 Notion 에서도 지우라는 뜻이고, sync 는
3334
3489
  * pull 을 먼저 돌려 되살리면 뒤이은 push 가 지울 것을 잃는다(detectMissingLocalFiles 와 같다).
3335
- * · 예전 버전이 적은 날짜 모양이 남은 행은 그 줄만 새 모양으로 고쳐 쓴다({@link outdatedDateForm},
3336
- * F-08).
3490
+ * · 예전 버전이 적은 날짜 모양이 남은 행, Notion 이 새로 만들거나 타입을 바꾼 속성의 값이 다른 행은 그 줄만
3491
+ * 고쳐 쓴다({@link staleKeysToRewrite}, F-08 · ADR-045).
3492
+ *
3493
+ * @param refreshed 이 행의 data source 에서 새로 생기거나 타입이 바뀐 속성의 키(ADR-045).
3337
3494
  */
3338
3495
  private rowAction;
3339
3496
  /**
3340
- * 원격이 그대로인 행이지만 예전 버전이 적은 날짜 모양(`…Z` · `…+09:00` · `{start, end}`)이 남아 새
3341
- * 모양으로 고쳐 쓸 행인가(F-08, {@link PropertyMapper.outdatedDateKeys}). 고쳐 쓰면 사본도 새 모양이
3342
- * 되어 다음 pull 은 건너뛴다.
3497
+ * 원격이 그대로인 행이지만 그 줄만 고쳐 쓸 키가 있는가 — 예전 버전이 적은 날짜 모양(`…Z` · `…+09:00` ·
3498
+ * `{start, end}`, F-08, {@link PropertyMapper.outdatedDateKeys}), 또는 Notion 이 새로 만들거나 타입을 바꾼
3499
+ * 속성의 값이 적힌 것과 다른 키(ADR-045 — 수식 열을 더하면 행마다 값이 생기지만 행의 수정 시각은 그대로다).
3500
+ * 고쳐 쓰면 사본도 새 값이 되어 다음 pull 은 건너뛴다.
3343
3501
  *
3344
3502
  * 지난 동기화 뒤 로컬을 고친 행은 고르지 않는다 — 로컬 편집을 지키느라 쓰지 않으니 pull 마다 고르기만
3345
3503
  * 한다. 그 편집을 올린 뒤의 pull 이 고른다. 로컬 파일을 읽지 못하면 고르지 않는다.
3346
3504
  */
3347
- private outdatedDateForm;
3505
+ private staleKeysToRewrite;
3506
+ /** 적힌 frontmatter 에서 받은 값으로 고쳐 쓸 키 — {@link staleKeysToRewrite}. */
3507
+ private staleKeys;
3348
3508
  /**
3349
- * 예전 버전이 적은 날짜 모양이 남은 행에서 그 키들만 새 모양으로 고쳐 쓴다(F-08) — 원격이 그대로라 본문 ·
3350
- * 첨부는 다시 받지 않는다. 본문은 한 글자도 바꾸지 않고, 다른 키의 줄은 그대로 둔다(키 단위로 나눠 읽을
3351
- * 수 없는 frontmatter 는 값만 지킨다 — {@link mergeRowFrontmatter}).
3509
+ * 원격이 그대로인 행에서 {@link staleKeys} 의 키만 받은 값으로 고쳐 쓴다 — 본문 · 첨부는 다시 받지 않는다. 본문은
3510
+ * 한 글자도 바꾸지 않고, 다른 키의 줄은 그대로 둔다(키 단위로 나눠 읽을 수 없는 frontmatter 는 값만 지킨다 —
3511
+ * {@link mergeRowFrontmatter}).
3352
3512
  *
3353
3513
  * 예전에는 행을 통째로 다시 받았다. 행마다 본문을 읽어 요청이 늘고, 다시 그릴 때마다 달라지는 본문(빈
3354
3514
  * 블록 · 첨부 이름)까지 바뀌었다 — 실볼트 사본에서 다시 받은 149행 중 99행.
3355
3515
  *
3356
3516
  * 고른 뒤 로컬을 고쳤으면 쓰지 않는다(`skipped`) — 이어지는 push 가 올린다.
3357
3517
  */
3358
- private rewriteDateForms;
3518
+ private rewriteStaleKeys;
3519
+ /**
3520
+ * Notion 에서 바뀐 속성을 지난 pull 이 본 스키마와 id 로 견줘 행 노트에 옮긴다(ADR-045) — 이름을 바꾼 속성은 키
3521
+ * 이름을, 지운 속성은 키를. 새로 생기거나 타입이 바뀐 속성은 돌려준다 — 그대로인 행도 그 값을 고쳐 쓴다.
3522
+ *
3523
+ * 처음 보는 DB 는 견줄 것이 없어 적기만 한다. 행 하나라도 옮기지 못하면 본 스키마를 적지 않는다 — 다음 pull 이 다시
3524
+ * 옮긴다(이미 옮긴 행은 바꿀 것이 없다).
3525
+ *
3526
+ * @returns 바뀐 속성(data source → 바뀐 것, 바뀐 소스만)과 키를 바꾼 행의 레코드 id.
3527
+ */
3528
+ private followSchema;
3529
+ /** 옮긴 것을 pull 마감이 알리게 적는다 — 이름 바꿈 · 지움이 있었던 DB 만. 날짜 범위 끝 키는 따로 세지 않는다. */
3530
+ private noteSchemaFollowed;
3531
+ /** 이번 pull 이 행 노트에 옮긴 Notion 속성 변경 — 가져가면 비운다(ADR-045). */
3532
+ /** 고쳐 둔 것이라 덮어쓰지 않은 사이드카 — 가져가면 비운다. */
3533
+ takeHeldSidecars(): string[];
3534
+ /** 고쳐 둔 것이라 덮어쓰지 않은 `.base` — 가져가면 비운다. */
3535
+ takeHeldBases(): string[];
3536
+ takeSchemaFollowed(): SchemaFollowed[];
3359
3537
  /** 이 DB 의 추적 행 가운데 이번 조회에 없던 것 — 지워졌는지는 아직 모른다. */
3360
3538
  private unlistedRows;
3361
3539
  /**
@@ -3886,7 +4064,7 @@ declare function resolvePropertyName(propertyId: string, schema: Record<string,
3886
4064
  *
3887
4065
  * ## 부분 번역의 안전 규칙 — 이 파일의 핵심
3888
4066
  *
3889
- * Notion 필터 문법은 Bases 보다 넓다(rollup any/every/none, 상대 날짜, formula 등).
4067
+ * Notion 필터 문법은 Bases 보다 넓다(rollup any/every/none, 이번 주(this_week), formula 등).
3890
4068
  * 못 옮기는 리프를 만났을 때 **어느 방향으로 틀릴지**는 논리 위치에 따라 다르다:
3891
4069
  *
3892
4070
  * - `and` 안에서 리프 하나를 버리면 조건이 느슨해진다 → 결과는 **상위집합**.
@@ -4069,6 +4247,7 @@ declare function notionIdsEqual(a: string, b: string): boolean;
4069
4247
  * markdown-api 경로(convertPageMentions)가 동일 형태로 수렴하도록 한다(rank20/I3).
4070
4248
  */
4071
4249
  declare function compactNotionId(id: string): string;
4250
+ declare function shortNotionId(id: string): string;
4072
4251
 
4073
4252
  /** Notion 제목 → 볼트 파일 이름(확장자 없이). */
4074
4253
  declare function sanitizeFileName(name: string): string;
@@ -4475,4 +4654,4 @@ declare function readColumnLayout(lines: readonly string[]): (ColumnPlace | unde
4475
4654
  /** 열 이름표 — `열 2/3 · 50%`. 비율이 없으면 `열 2/3`. */
4476
4655
  declare function columnLabel(place: ColumnPlace): string;
4477
4656
 
4478
- 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 };
4657
+ 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 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 };