diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md
index 47f7d43..e7706e9 100644
--- a/docs/ROADMAP.md
+++ b/docs/ROADMAP.md
@@ -781,6 +781,25 @@ called.**
| **UI** | The suggestion section on Pins, above the list; `useEnvStore.suggestions` keyed on its own `suggestionsFor`; the app's first `type="number"` in Settings. |
| **Docs** | UI-SPEC §4 (the section, and the Settings threshold), PRD P1-2 marked shipped. |
+**The one thing only a real environment could say: 94 suggestions.**
+
+Against `C:\Python314` — 352 packages, the scale fixture — the default threshold of 5 qualifies
+**94 packages**, a quarter of the environment. The top of the list is right (`setuptools` at 150
+dependents, then `zope` at 93, `zope-interface` at 86) but a "Worth pinning" section with 94 rows
+is not a suggestion, it is a second package list.
+
+Raising the default was the wrong fix: a deep dependency tree is exactly where a bulk update is
+most dangerous, so it is exactly where the feature has to work. The screen shows the top
+`SUGGESTIONS_SHOWN = 8` and says how many more qualify — the `RUFF_ROWS_SHOWN` pattern, and for
+the same reason: the count comes from the **full** list, so a capped view never misreports a total.
+`pins::suggest` still returns everything at or above the threshold, which is what makes it
+composable.
+
+Measured while there, in `--release`: the probe is **605 ms** and the graph build plus the whole
+suggest pass is **1 ms**. The plan's worry that `dependent_count` looping over 350 packages would
+be O(n·m) enough to matter was unfounded — the subprocess dominates completely, and there is no
+case for a batched counts method.
+
**Three things the plan had wrong, all found by doing it.**
1. **A six-place checklist, not five.** `crates/pipdock-cli/tests/golden.rs` keeps its *own* copy of
diff --git a/docs/UI-SPEC.md b/docs/UI-SPEC.md
index 645db33..053d871 100644
--- a/docs/UI-SPEC.md
+++ b/docs/UI-SPEC.md
@@ -103,6 +103,12 @@ having acted, and it is absent entirely when there is nothing to suggest. Accept
ordinary `Exclude` pin with the count as its reason (PRD P1-2's "suggest pin with reason"), which
the reason field below can then replace.
+**It shows the top 8 and says how many more qualify.** Measured against the 352-package fixture,
+the default threshold of 5 qualifies 94 — a quarter of the environment. Raising the default would
+be the wrong fix, because a deep dependency tree is exactly where a bulk update is most dangerous;
+the count in the "N more" line comes from the full list, so a capped view never misreports a total.
+Same rule as `RUFF_ROWS_SHOWN` in the Health report.
+
It costs one `probe.py` run, and that is why it is here rather than on a sidebar badge: only
someone who opened this tab pays for it. It is also **silent on failure** — this screen's job is
listing pins and it does that either way, so an error row about an advisory would be the loudest
diff --git a/ui/src/locales/en/common.json b/ui/src/locales/en/common.json
index 3da509d..debad69 100644
--- a/ui/src/locales/en/common.json
+++ b/ui/src/locales/en/common.json
@@ -174,6 +174,8 @@
"suggestIntro": "These are depended on by a lot of what you have installed, so a bulk update is more likely to disturb something. Pinning keeps them out of Select all — you can still update them one at a time.",
"suggest_one": "{{pkg}} — {{count}} package depends on it.",
"suggest_other": "{{pkg}} — {{count}} packages depend on it.",
+ "suggestMore_one": "{{count}} more package would qualify. Pin some of these, or raise the count in Settings.",
+ "suggestMore_other": "{{count}} more packages would qualify. Pin some of these, or raise the count in Settings.",
"suggestAccept": "Pin",
"suggestAcceptFor": "Pin {{pkg}}",
"suggestReason_one": "{{count}} package depended on it",
diff --git a/ui/src/locales/vi/common.json b/ui/src/locales/vi/common.json
index 44719a2..9d5fb09 100644
--- a/ui/src/locales/vi/common.json
+++ b/ui/src/locales/vi/common.json
@@ -166,6 +166,7 @@
"suggestTitle": "Nên cân nhắc ghim",
"suggestIntro": "Rất nhiều gói bạn đang cài phụ thuộc vào những gói này, nên một lần cập nhật hàng loạt dễ làm xáo trộn thứ gì đó. Ghim sẽ giữ chúng ngoài Chọn tất cả — bạn vẫn có thể cập nhật từng gói một.",
"suggest_other": "{{pkg}} — {{count}} gói phụ thuộc vào nó.",
+ "suggestMore_other": "Còn {{count}} gói nữa cũng đủ điều kiện. Hãy ghim bớt, hoặc nâng ngưỡng trong Cài đặt.",
"suggestAccept": "Ghim",
"suggestAcceptFor": "Ghim {{pkg}}",
"suggestReason_other": "{{count}} gói đã phụ thuộc vào nó"
diff --git a/ui/src/screens/PdPins.test.tsx b/ui/src/screens/PdPins.test.tsx
index 4df6fa0..871f6f4 100644
--- a/ui/src/screens/PdPins.test.tsx
+++ b/ui/src/screens/PdPins.test.tsx
@@ -186,6 +186,24 @@ describe('PdPins', () => {
expect(ipc.pinSuggestions).toHaveBeenCalledTimes(1)
})
+ it('caps the list and says how many it did not show', async () => {
+ // Found by running against the 352-package fixture: the default threshold of 5 qualifies 94
+ // packages there. A quarter of the environment is not a suggestion, it is a second package
+ // list — and the deep trees where that happens are exactly where the feature matters, so
+ // the answer is a bounded view, not a higher default.
+ withEnv()
+ vi.mocked(ipc.pinSuggestions).mockResolvedValue(
+ Array.from({ length: 94 }, (_, i) => ({ pkg: `pkg${i}`, dependents: 100 - i })),
+ )
+ render(
{t('pins.suggestIntro')}
+ {t('pins.suggestMore', { count: suggestions.length - SUGGESTIONS_SHOWN })} +
+ ) : null} ) : null}