docs: fix the real bootstrap block - pass 1 gated on a value it cannot have

Moving holdings discover to Tier 2 addressed the second link and left the
first. Pass 1 promoted only accounts with fit >= 25, but fit reaches 25 only
with an EDGAR overlap, read from confirmed holdings that do not exist on a
fresh database. So pass 1 promoted nobody, contacts enrich filtered on tier 1
and saw none, and the named-contact gate then closed Tier 1 for good. Pass 1
now admits any account with declared equity exposure - which is what choosing
who to pay to enrich actually means - while MIN_FIT still gates final Tier 1.
The spec was wrong here too, not only the plan.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016XzekHxqiXutBW4gw3Arsx

docs/superpowers/plans/2026-08-29-prospection-buyside.md

@@ -1275,12 +1275,22 @@ def test_pass1_never_includes_reach_points():
     assert not any(r.startswith("reach:") for r in result.reasons)
 
 
+def test_pass1_promotes_on_declared_equity_not_on_a_confirmed_holding():
+    """La passe 1 choisit qui vaut la dépense d'enrichissement, à un moment où
+    aucune position n'est encore confirmée. Exiger MIN_FIT ici ne promeut
+    personne, et le pipeline entier se bloque à `contacts enrich`."""
+    fresh = scoring.score_pass1(_account(), has_equity_funds=True,
+                                has_edgar_overlap=False, signals=[])
+    assert fresh.fit == 20  # sous MIN_FIT, mais non nul
+    assert scoring.assign_provisional([(1, fresh)])[1] == 1
+
+
 def test_provisional_assignment_caps_at_60_and_requires_min_fit():
     results = [(i, scoring.ScoreResult(total=80, fit=30, reasons=[])) for i in range(70)]
-    results.append((999, scoring.ScoreResult(total=95, fit=10, reasons=[])))
+    results.append((999, scoring.ScoreResult(total=95, fit=0, reasons=[])))
     tiers = scoring.assign_provisional(results)
     assert sum(1 for t in tiers.values() if t == 1) == 60
-    assert tiers[999] == 2  # fit sous MIN_FIT mais non nul : Tier 2, pas Tier 1
+    assert tiers[999] == 0  # fit nul : aucune poche actions, exclu quel que soit le total
 
 
 def test_final_assignment_demotes_accounts_without_a_named_contact():
@@ -1438,8 +1448,22 @@ def score_pass2(base: ScoreResult, contacts: list[dict]) -> ScoreResult:
                        reasons=[*base.reasons, *reach_reasons])
 
 
+def _enrichable(result: ScoreResult) -> bool:
+    """Éligible à la PASSE 1 — la population qu'on accepte de payer pour enrichir.
+
+    Le seuil est `fit > 0`, pas `MIN_FIT`, et c'est structurel. `MIN_FIT` n'est
+    atteint qu'avec un recouvrement EDGAR, lequel se lit dans les positions
+    confirmées à la main. Sur une base vierge il n'y en a aucune : exiger
+    `MIN_FIT` ici ne promeut personne, `contacts enrich` ne voit alors aucun
+    compte, aucun contact n'est jamais créé, et la porte « contact nommé » de la
+    passe 2 ferme le Tier 1 définitivement. La passe 1 sert à choisir qui vaut
+    la dépense d'enrichissement, à un moment où l'on ignore encore les positions.
+    """
+    return result.fit > 0
+
+
 def _eligible(result: ScoreResult) -> bool:
-    """Éligible au Tier 1 : la porte haute."""
+    """Éligible au Tier 1 final : la porte haute, une fois les positions connues."""
     return result.fit >= config.MIN_FIT
 
 
@@ -1456,7 +1480,7 @@ def assign_provisional(results: list[tuple[int, ScoreResult]]) -> dict[int, int]
     # Tri secondaire sur l'identifiant : le compte qui occupe la dernière place
     # sous le plafond décide qui reçoit une démo. Il ne doit pas changer d'une
     # exécution à l'autre parce que l'appelant a listé les comptes autrement.
-    ranked = sorted((r for r in results if _eligible(r[1])),
+    ranked = sorted((r for r in results if _enrichable(r[1])),
                     key=lambda r: (-r[1].total, r[0]))
     promoted = {account_id for account_id, _ in ranked[:config.TIER1_PROVISIONAL_CAP]}
     return {
@@ -4763,6 +4787,34 @@ def test_universe_to_tier_runs_end_to_end_with_no_paid_provider(tmp_path):
         "une position confirmée doit ouvrir le Tier 1, sans aucun provider payant")
 
 
+def test_the_documented_sequence_reaches_an_enrichable_population(tmp_path):
+    """Le maillon que la narration d'amorçage tenait pour acquis.
+
+    `contacts enrich` ne visite que le Tier 1 provisoire. Si la passe 1 ne
+    promeut personne, aucun contact n'est jamais créé et la porte « contact
+    nommé » ferme le Tier 1 pour toujours — le pipeline se bloque à la
+    quatrième commande, pas à la découverte des positions.
+    """
+    for row in amf_registry.parse_rows(FIXTURE):
+        if amf_registry.is_in_scope(row)[0]:
+            db.upsert_account({**row, "effectif": 18, "activites": row.get("activite"),
+                               "dirigeants": ["Marie Durand"],
+                               "independante": int(amf_registry.is_independent(row["nom"]))})
+
+    results = []
+    for account in db.list_accounts():
+        equity, overlap, signals = cli._score_inputs(account)
+        assert overlap is False, "aucune position n'est confirmée à ce stade"
+        results.append((account["id"],
+                        scoring.score_pass1(account, has_equity_funds=equity,
+                                            has_edgar_overlap=overlap, signals=signals)))
+
+    provisional = scoring.assign_provisional(results)
+    assert 1 in provisional.values(), (
+        "la passe 1 doit produire une population enrichissable, sinon "
+        "`contacts enrich` ne visite aucun compte et le Tier 1 reste fermé")
+
+
 def test_no_paid_provider_is_enabled_by_default():
     assert [p.name for p in registry.build_providers() if p.enabled()] == ["pattern"]
 

docs/superpowers/specs/2026-08-29-prospection-buyside-design.md

@@ -183,8 +183,16 @@ Chaque point écrit sa raison dans `score_reasons`.
 qu'après enrichissement et que l'enrichissement coûte :
 
 - **Passe 1 — `score`** : fit + accessibilité + signal (0–90). Produit
-  `tier_provisoire`. Les 60 meilleurs comptes avec fit ≥ 25 deviennent
+  `tier_provisoire`. Les 60 meilleurs comptes **avec fit > 0** deviennent
   `tier_provisoire = 1` : c'est la seule population enrichie.
+
+  Le seuil est `fit > 0` et non `MIN_FIT`, et c'est structurel : `MIN_FIT` n'est
+  atteint qu'avec un recouvrement EDGAR, lequel se lit dans les positions
+  confirmées à la main. Sur une base vierge il n'en existe aucune, donc exiger
+  `MIN_FIT` dès la passe 1 ne promeut personne, `contacts enrich` ne visite alors
+  aucun compte, et la porte « contact nommé » de la passe 2 ferme le Tier 1
+  définitivement. La passe 1 choisit qui vaut la dépense d'enrichissement, à un
+  moment où les positions sont encore inconnues.
 - **Passe 2 — `score --final`**, après `contacts enrich` : ajoute la
   joignabilité et applique la porte finale.
 
@@ -341,7 +349,7 @@ python -m prospection.cli signals scan            # signaux d'intention
 python -m prospection.cli score                   # passe 1 → tier provisoire (60 max)
 python -m prospection.cli contacts enrich         # sur le tier provisoire 1 seulement
 python -m prospection.cli score --final           # passe 2 → Tier 1 définitif (40 max)
-python -m prospection.cli holdings discover --tier 1
+python -m prospection.cli holdings discover        # Tier 2 par défaut : amorçage
 python -m prospection.cli holdings confirm        # revue humaine
 python -m prospection.cli demo build --tier 1     # ingest → brief → PDF
 python -m prospection.cli campaign draft --tier 1