Skill: Tier 3 Probes

Feasibility probes antes de instalar dependencias pesadas. Ref: Era 183 Tier 3 Champions.

Cuando usar

• Antes de pip install pesado para un champion Tier 3
• Verificar entorno tras travel-pack a maquina nueva
• Auditoria periodica de preconditions ML stack
• Pre-activacion de MCP templates (scrapling opt-in)

Inventario

Probe	Champion	Spec	Verifica
scrapling-probe.sh	Scrapling	SE-061	Python >= 3.10, scrapling, lxml, opcional playwright+chromium
oumi-probe.sh	Oumi training	SE-028	Python 3.10+, oumi, torch, disk >= 10GB
memvid-probe.sh	Memvid backup	SE-041	Python 3.10+, memvid
bertopic-probe.sh	BERTopic	SE-033	Python, bertopic, sentence-transformers, UMAP, HDBSCAN
reranker-probe.sh	Cross-encoder	SE-032	Python, sentence-transformers, torch, BAAI model availability
pdf-extract-probe.sh	PDF chain	SPEC-102/103/104	Python, pdfminer, java deps

Invocacion uniforme

Todos los probes siguen el mismo contrato:

bash scripts/X-probe.sh            # Verbose output
bash scripts/X-probe.sh --json     # Machine-readable

Output schema (JSON)

{
  "verdict": "VIABLE|NEEDS_INSTALL|BLOCKED",
  "python_version": "3.12.3",
  "{package}_installed": 0|1,
  "disk_free_gb": 100,
  "reasons": ["human-readable explanation"]
}

Exit codes

• 0 — VIABLE o NEEDS_INSTALL (no bloqueador)
• 1 — BLOCKED (Python incompatible, disk insuficiente, dep critica ausente)
• 2 — usage error (flag desconocido)

Casos de uso

Pre-install check

bash scripts/scrapling-probe.sh --json | jq .verdict
# → "VIABLE" → proceder con `pip install scrapling`

Batch check environment readiness

for p in scrapling oumi memvid bertopic reranker pdf-extract; do
  echo "=== $p ==="
  bash scripts/$p-probe.sh --json | jq .verdict
done

CI gate (opcional)

Un PR que añade champion Tier 3 puede verificar que el probe devuelve VIABLE|NEEDS_INSTALL antes de merge.

No hacen

• No instalan dependencias (solo verifican)
• No descargan modelos
• No ejecutan inference (eso es Slice 2+ de cada champion)
• No auto-fixer (requiere intervención humana)

Patron de diseno (SE-061 reference)

Cada probe:

1. Verifica herramientas nativas (python3, pip3, df)
2. Detecta deps Python via python3 -c "import X" 2>/dev/null
3. Mide disk free
4. Clasifica verdict por 3 categorias
5. Lista reasons humanas para cada fallo
6. JSON estable para automatizacion

Replicar este patron para nuevos Slice 1 de champions futuros.

Referencias

• SE-061 Scrapling: docs/propuestas/SE-061-scrapling-research-backend.md
• SE-032 Reranker: docs/propuestas/SE-032-reranker-layer.md
• SE-033 BERTopic: docs/propuestas/SE-033-topic-cluster-skill.md
• SE-041 Memvid: docs/propuestas/SE-041-memvid-portable-memory.md
• SE-028 Oumi: docs/propuestas/SE-028-oumi-training-pipeline.md (diferido)
• Roadmap Era 183: docs/ROADMAP.md §Tier 3 Champions