From 9976f38a0b834b5a62394880db0d1af662c58d83 Mon Sep 17 00:00:00 2001 From: tonym Date: Mon, 17 Aug 2026 00:15:52 -0500 Subject: [PATCH] =?UTF-8?q?docs(CLAUDE.md):=20paging=20appends=20=E2=80=94?= =?UTF-8?q?=20exclude=20before=20ranking,=20never=20re-look-up?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Records the v0.6.0 invariants as a house rule: 36/page, exclude already-shown names before ranking (a new seed alone reshuffles the same pool), appends reuse the current runId and look up only new domains. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01XStQKxPfEjrTvWo83KFCxG --- CLAUDE.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 24d576e..cb75d76 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -77,6 +77,16 @@ brings that output straight back: `diversify()` caps each strategy at ~28% of the list. Without it the top 20 came back as eighteen coinages — raw score ranking clumps badly. +## Paging appends — never re-look-up + +36 names per page (`NAME_COUNT`), and **"Show me more" appends**: Finder passes the +names already on screen as `exclude`, and `generateNames` drops them *before* ranking. +A new seed alone mostly reshuffles the same pool — that was the old behaviour and it +re-checked domains the visitor had already seen. Two invariants: an append reuses the +current `runId` (so earlier cards keep resolving) and only looks up the NEW domains; +changing keywords/style/extensions starts a fresh list. When the pool is exhausted the +UI says so rather than silently returning nothing. + ## Shared OTM widgets need Tailwind The bottom-right feedback chat-pop is `SuggestionLightbulb` from