Method fire

src/db/wal-valve.ts:260–289

()

  }

  private fire(): void {
    this.log(`fire: wal=${this.mb(this.db.getWalSizeBytes())} baseline=${this.mb(this.sizeAtLastFullBackfill)}`);
    const p = this.db
      .checkpointWalPassive()
      .then((res) => {
        this.log(`timer pass: ${res ? `busy=${res.busy} log=${res.log} checkpointed=${res.checkpointed}` : 'null (machinery unavailable)'} wal=${this.mb(this.db.getWalSizeBytes())}`);
        // Full backfill (busy 0, every log frame checkpointed) ⇒ the writer's
        // next commit wraps the WAL; the file's current size becomes the new
        // growth baseline. A partial pass (writer appended during it, or a
        // read transaction pinned frames) leaves the baseline alone, so the
        // next tick fires again and copies the remainder. In non-WAL mode
        // SQLite reports log = checkpointed = -1, which is harmless here.
        if (res && res.busy === 0 && res.log === res.checkpointed) {
          this.sizeAtLastFullBackfill = this.db.getWalSizeBytes();
          // NO truncate here. A truncate checkpoint that starts against an
          // ACTIVE writer wins the lock race and then blocks that writer for
          // its entire backfill — after a multi-GB single-transaction burst
          // (edge-index recreate) that exceeds the writer's 5s busy_timeout
          // and fails the index with "database is locked" (§7a.2 record run).
          // The file chop happens exclusively at parked barriers
          // (backpressure/foldNow), where the writer is awaiting us by
          // construction and cannot collide.
        }
      })
      .catch(() => { /* best-effort */ })
      .finally(() => {
        if (this.inflight === p) this.inflight = null;
      });
    this.inflight = p;
  }
}