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:
- Verifica herramientas nativas (python3, pip3, df)
- Detecta deps Python via
python3 -c "import X" 2>/dev/null
- Mide disk free
- Clasifica verdict por 3 categorias
- Lista reasons humanas para cada fallo
- 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
1---2name: tier3-probes3description: "Skill: Tier 3 Probes"4---56# Skill: Tier 3 Probes78> Feasibility probes antes de instalar dependencias pesadas.9> Ref: Era 183 Tier 3 Champions.1011## Cuando usar1213- Antes de `pip install` pesado para un champion Tier 314- Verificar entorno tras travel-pack a maquina nueva15- Auditoria periodica de preconditions ML stack16- Pre-activacion de MCP templates (scrapling opt-in)1718## Inventario1920| Probe | Champion | Spec | Verifica |21|---|---|---|---|22| `scrapling-probe.sh` | Scrapling | SE-061 | Python >= 3.10, scrapling, lxml, opcional playwright+chromium |23| `oumi-probe.sh` | Oumi training | SE-028 | Python 3.10+, oumi, torch, disk >= 10GB |24| `memvid-probe.sh` | Memvid backup | SE-041 | Python 3.10+, memvid |25| `bertopic-probe.sh` | BERTopic | SE-033 | Python, bertopic, sentence-transformers, UMAP, HDBSCAN |26| `reranker-probe.sh` | Cross-encoder | SE-032 | Python, sentence-transformers, torch, BAAI model availability |27| `pdf-extract-probe.sh` | PDF chain | SPEC-102/103/104 | Python, pdfminer, java deps |2829## Invocacion uniforme3031Todos los probes siguen el mismo contrato:3233```bash34bash scripts/X-probe.sh # Verbose output35bash scripts/X-probe.sh --json # Machine-readable36```3738### Output schema (JSON)3940```json41{42 "verdict": "VIABLE|NEEDS_INSTALL|BLOCKED",43 "python_version": "3.12.3",44 "{package}_installed": 0|1,45 "disk_free_gb": 100,46 "reasons": ["human-readable explanation"]47}48```4950### Exit codes5152- `0` — VIABLE o NEEDS_INSTALL (no bloqueador)53- `1` — BLOCKED (Python incompatible, disk insuficiente, dep critica ausente)54- `2` — usage error (flag desconocido)5556## Casos de uso5758### Pre-install check59```bash60bash scripts/scrapling-probe.sh --json | jq .verdict61# → "VIABLE" → proceder con `pip install scrapling`62```6364### Batch check environment readiness65```bash66for p in scrapling oumi memvid bertopic reranker pdf-extract; do67 echo "=== $p ==="68 bash scripts/$p-probe.sh --json | jq .verdict69done70```7172### CI gate (opcional)73Un PR que añade champion Tier 3 puede verificar que el probe devuelve VIABLE|NEEDS_INSTALL antes de merge.7475## No hacen7677- No instalan dependencias (solo verifican)78- No descargan modelos79- No ejecutan inference (eso es Slice 2+ de cada champion)80- No auto-fixer (requiere intervención humana)8182## Patron de diseno (SE-061 reference)8384Cada probe:851. Verifica herramientas nativas (python3, pip3, df)862. Detecta deps Python via `python3 -c "import X" 2>/dev/null`873. Mide disk free884. Clasifica verdict por 3 categorias895. Lista reasons humanas para cada fallo906. JSON estable para automatizacion9192Replicar este patron para nuevos Slice 1 de champions futuros.9394## Referencias9596- SE-061 Scrapling: `docs/propuestas/SE-061-scrapling-research-backend.md`97- SE-032 Reranker: `docs/propuestas/SE-032-reranker-layer.md`98- SE-033 BERTopic: `docs/propuestas/SE-033-topic-cluster-skill.md`99- SE-041 Memvid: `docs/propuestas/SE-041-memvid-portable-memory.md`100- SE-028 Oumi: `docs/propuestas/SE-028-oumi-training-pipeline.md` (diferido)101- Roadmap Era 183: `docs/ROADMAP.md` §Tier 3 Champions