gap CLI: DB's ~90 s static analysis is silent past the daemon wait, so every DB daemon check falls back cold

オープン
#173 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
バグ
明瞭さ
おおむね明確
活発さ
活発
技術スタック
javascript, typescript
領域
cli, performance

調査の方向性

Start with check.mjs, analysis.mjs, and daemon.mjs to trace how analysis blocks the daemon heartbeat and triggers the cold fallback; compare the two proposed approaches. Build the issue’s required oracle-first end-to-end history using a test-only pause point to hold analysis past the CLI wait. Done when the daemon check is served with unchanged reuse and no “runs cold” note, and the witness fails on main.

索引モデルが issue の本文から書いたものです。

説明

Summary

On TanStack DB's packages/db, the gap CLI's static analysis phase takes about 90 s, and the daemon sends nothing during it. #131 made the CLI check cold when a daemon has sent nothing for 60 s (WAIT_MS, daemon.mjs). So on DB the daemon never serves a check: the CLI always falls back cold (v21.2 R39), and the daemon default (R13) saves nothing there.

Measurement

Arca pool, Linux, 8 vCPU. DB at 21c52a07, --package packages/db --source src/query/subset-dedupe.ts. Phase durations come from the CLI's progress lines (pool tag do-dbphase). Each row is one run.

CLI warm contexts find test files static analysis
main 1.1 s 17 ms 91.2 s
main 0.7 s 21 ms 88.9 s
#133 head 0.8 s 17 ms 91.4 s
#133 head 0.8 s 17 ms 91.6 s
  • The time is the same on main and on #133, so #133 did not cause it.
  • The DB daemon bench for #133 had to raise the CLI's wait with the test-only knob ORACLE_GAPS_TEST_WAIT_MS for the daemon to serve any check.

Cause

  • checkIn (check.mjs) calls analyze (analysis.mjs) synchronously on every check. analyze instruments the sources and then calls ts.createProgram over the sources and the files that owns names. On DB, that means the type checker reads a large part of the package.
  • While it runs, the event loop is blocked, so the daemon cannot send its beat.
  • daemon.mjs's send already names this case: "a phase with no running copy (a session's start, a warm-up, the analysis) that runs longer than the bound".
  • The analysis runs in each check, not once per session. So this probably affects every daemon check on DB, not only the first. This is not measured separately.

Proposed fix (choose one)

  1. A beat around the analysis. The daemon sends a beat at each phase boundary, and also from inside the analysis between its steps: after each source is instrumented, and before and after createProgram. This is small. But createProgram alone can still run past 60 s on a big package, so it does not close the case by itself.
  2. Analysis off the main thread. Run analyze in a worker thread, so the daemon's event loop stays free to send beats on its normal schedule. This closes the case for any package size. It also lets a later change keep the ts.Program between checks (oldProgram), which would make rechecks cheaper.

Either fix needs a witness that is oracle-first (P9): a constructed e2e history whose analysis phase is held past the CLI's wait at a test-only pause point (R57, never by time), and whose daemon check must still be served (unchanged reuse, no runs cold note). It must fail on main.

Authority

  • R13 / M-30: the daemon is the default.
  • R39: a cold fallback is not a failure, but it must stay the exception.
  • Raised in the review of #131 and measured during #133.

This issue was written by Isaac.

主要言語
JavaScript
スター
5
フォーク
1
平均マージ
11時間 18分
マージ済み PR(30日)
66

環境構築

このプロジェクトには開発コンテナ、Dockerfile、コントリビューションガイドがありません。まず README を読み、一般的な手順ははじめてのコントリビューションガイドを参照してください。

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

TanStack/oracles のほかの issue

TanStack/oracles の issue をすべて見る

似ている issue

JavaScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。