Phase 30: Notebook interface and DataFrame display layer

[gparadis]

Goal:
Add an optional notebook-facing layer on top of modelwright.wrappers that exposes wrapped generated models as Jupyter-friendly, pandas-backed analyst workflows.

The goal is not a full spreadsheet UI. It is a live-kernel interface where users can inspect inputs, outputs, and tables; mutate scenarios; recalculate; render declared tables as pandas.DataFrame; and compare scenarios without directly handling raw generated source or Sheet!A1 dictionaries in the common path.

Release target: modelwright==0.1.0a5

Branch: feature/p30-notebook-dataframe-interface

Child tasks:

• P30.1 Define notebook adapter contract. Child issue: P30.1 Define notebook adapter contract #175.
• P30.2 Implement DataFrame view helpers. Child issue: P30.2 Implement DataFrame view helpers #178.
• P30.3 Implement scenario comparison helpers. Child issue: P30.3 Implement scenario comparison helpers #176.
• P30.4 Add notebook-oriented docs. Child issue: P30.4 Add notebook-oriented docs #177.
• P30.5 Validate synthetic and FABLE notebook workflows. Child issue: P30.5 Validate synthetic and FABLE notebook workflows #179.
• P30.6 Add examples gallery. Child issue: P30.6 Add examples gallery #181.
• P30.7 Publish modelwright==0.1.0a5. Child issue: P30.7 Publish modelwright 0.1.0a5 #180.

Current evidence:

• Added modelwright.notebooks with lazy pandas-backed helpers for inputs, outputs, scenarios, tables, reports, and scenario comparisons.
• Added notebook optional extra with pandas>=2, while keeping pandas out of core dependencies.
• Added always-on synthetic notebook tests and extended the opt-in FABLE wrapper benchmark.
• Added a tracked Examples Gallery with synthetic and compressed generated 2020 FABLE model examples.
• Local verification passed: bootstrap, Ruff, default pytest (163 passed, 1 skipped), Sphinx warning-as-error docs, docs theme verifier, release artifact checks, and opt-in FABLE notebook wrapper benchmark (1 passed in 149.67s).

Acceptance boundary:

• May claim initial Jupyter/DataFrame-facing helpers for wrapped generated models.
• May claim optional pandas-backed display helpers.
• May claim scenario mutation and comparison as notebook-native workflows.
• May claim synthetic and opt-in FABLE evidence that notebook helpers do not change calculation behavior.
• May claim tracked examples for synthetic and generated 2020 FABLE notebook-facing wrappers.
• Must not claim a full spreadsheet UI, dashboard application, widget framework, automatic workbook semantic recovery, stable public API compatibility, or compact runtime IR production readiness.

[gparadis]

Activated Phase 30 on branch feature/p30-notebook-dataframe-interface. Local planning updates now add the Phase 30 roadmap section, record child issues #175, #178, #176, #177, #179, and #180, and add planning/notebook-dataframe-interface.md as the initial contract note. P30.1 remains open while the contract is reviewed/refined before implementation.

[gparadis]

P30.1 through P30.5 are complete and closed. Local verification passed, including default pytest with 161 passed / 1 skipped and the opt-in FABLE notebook wrapper benchmark with 1 passed in 149.67s. P30.6 (#180) remains open for the release closeout.

[gparadis]

Correction to the previous comment: P30.6 (#180) remains open for the 0.1.0a5 release closeout.

[gparadis]

Phase 30 is complete. P30.1 through P30.7 are closed, PR #182 merged, published to PyPI, matching GitHub prerelease created, clean PyPI notebook-extra install verified, and live Pages docs verified. Closeout recorded in commit 50dda6b.

[gparadis]

Correction: Phase 30 published v0.1.0a5 / modelwright==0.1.0a5 to PyPI and created the matching GitHub prerelease.