Skip to content

docs: reconcile the PRD and the tracker after the data-hygiene wave - #572

Merged
linhdmn merged 1 commit into
mainfrom
fix/prd-reconcile-v419
Oct 21, 2026
Merged

linhdmn merged 1 commit into
mainfrom
fix/prd-reconcile-v419

Conversation

@linhdmn

@linhdmn linhdmn commented Oct 21, 2026

Copy link
Copy Markdown
Member

The parent-owned fields, and only those — the PRD version line, the PRD codebase version, the PRD footer stamp, the tracker's **Last synced:** line, the tracker Summary table, the tracker In Progress table — plus one measurement correction inside the wave's own section.

Measurement correction. The FTS figures in the v4.19-scheduled-reclaim-real section were wrong, and are corrected here:

the live leankg store carried a 9.4 MB elements_fts_idx over 3,065 segments — 31 % of the 138 MB store

dbstat on a copy of the live store (with the -wal) says elements_fts_idx is 73,728 B (18 pages) — not 9.4 MB — and there is no "3,065 segments" figure in the store. The "31 %" belongs to the FTS tables as a whole (43,370,176 B of 138,678,272 B). What one compaction actually reclaims, measured by running the merged CompactFTS against a copy of the live store:

object before after
elements_fts_data 16,654,336 10,534,912
elements_fts_idx 73,728 40,960
keyword rows 11,584 11,584

6,152,192 B (6.15 MB) of merged segment space reclaimed, with every keyword row intact. The same correction is posted on PR #566.

The fix and its tests are unaffected; only the measured attribution was wrong.

The parent-owned fields, and only those: the PRD version line, the PRD
codebase version, the PRD footer stamp, the tracker's Last-synced line, the
tracker's Summary table, the tracker's In Progress table — plus one
measurement correction inside the wave's own section.

- PRD version 4.17-scheduled-reclaim -> 4.19-data-hygiene
- PRD codebase version 0.35.0 -> 0.35.2 (cmd/leankg/VERSION is 0.35.2 since
  the release merge); this is the drift the previous reconciliation left
  behind, one release later
- the footer stamp and the Last-synced line now describe THIS wave and name
  its seven PRs
- the Summary counts and the In Progress table: the nine-defect wave's row is
  closed (all nine merged) and the data-hygiene wave's row is added
- correction: the FTS measurement in the v4.19-scheduled-reclaim-real section
  was wrong. The index was 73,728 B, not 9.4 MB, and there is no "3,065
  segments" figure in the store; the FTS tables hold 43,370,176 B (31 % of the
  store) and the segment structures inside them hold 16,728,064 B, of which
  one compaction reclaims 6,152,192 B with every keyword row intact
  (11,584 -> 11,584). The correction is also posted on PR #566.
@linhdmn
linhdmn merged commit 83e2493 into main Oct 21, 2026
5 checks passed
@linhdmn
linhdmn deleted the fix/prd-reconcile-v419 branch October 21, 2026 18:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant