---
name: stx.notebook
description: Jupyter notebook reproducibility — verify execution via Clew sessions, scan for untracked I/O (`scitex.io` calls outside `@scitex.session`), reconstruct the true cell-dependency DAG from recorded execution timestamps, compile a notebook into a Mermaid DAG diagram OR a topologically-ordered standalone `.py` script, and convert `.ipynb` → SciTeX Python script with `@stx.session` decorators. Use whenever the user asks to "verify my notebook", "check notebook reproducibility", "is this notebook reproducible?", "audit untracked I/O in this notebook", "convert this .ipynb to a Python script", "export notebook as .py", "show me the cell DAG", "reorder cells by dependency", "visualize notebook execution order", "turn this Jupyter mess into a clean script", or works with Jupyter notebooks that need to become production-ready scripts. Embodies the "do what you want, organize later" workflow: execute cells in any order during exploration, then compile back to a clean DAG-ordered script via Clew DB timestamps.
tags: [scitex-notebook, scitex-package]
---

# stx.notebook — Skills Index

Verify, compile, and convert Jupyter notebooks. Reconstructs the actual execution dependency DAG from clew DB timestamps — "do what you want, organize later."

## Sub-skills

| File | Description |
|------|-------------|
| [parse-and-convert.md](parse-and-convert.md) | parse_notebook, get_code_cells, get_notebook_name, convert_notebook |
| [dag-compile.md](dag-compile.md) | compile_notebook, CompiledNotebook.to_mermaid(), to_script(), DAG edge logic |
| [verify.md](verify.md) | verify_notebook (clew session results), check_notebook (untracked IO scan) |

## Quick Reference

```python
from scitex.notebook import (
    parse_notebook, get_code_cells,
    compile_notebook, convert_notebook,
    verify_notebook, check_notebook,
)

cells = parse_notebook("experiment.ipynb")
compiled = compile_notebook("experiment.ipynb")
print(compiled.to_mermaid())   # Mermaid DAG
print(compiled.to_script())    # Topologically-ordered .py

results = verify_notebook("experiment.ipynb")
issues = check_notebook("experiment.ipynb")
```