jarvisplot 2.1.10__tar.gz → 2.1.11__tar.gz

jarvisplot-2.1.11/CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+Release history of the `JarvisPLOT` distribution (import package `jarvisplot`,
+CLI `jplot`). Design documents, specifications and the roadmap live in
+[Jarvis-Books `Docs/Jarvis-PLOT/`](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/README.md).
+
+## 2.1.11 — 2026-10-18
+
+- Exclude maintainer release helpers, local configuration, credentials, and
+  generated files from distribution archives.
+
+- `./jprel X.Y.Z` now completes PyPI upload, local editable install, Git tag,
+  and GitHub release. `--dry` checks inputs without changing the checkout.
+- Remove private research cards and scripts under `bin/` from version control
+  and distribution archives; public examples remain under `Example/`.
+- Cache cleanup removes empty registered cache directories whose marker is
+  missing, while retaining unmarked directories containing files.
+- Font card: `jplot fonts show|list|resolve|check|set|reset` and
+  `jplot man fonts`. Normal YAML rendering applies the bundled role card
+  (Helvetica sans, STIXGeneral serif, STIX MathText); explicit YAML fonts and
+  sizes take precedence. Personal overrides live in
+  `~/.jarvis/plot-fonts.json` (`JARVIS_HOME` overrides the directory).
+- When Helvetica is absent, the first installed of Arial, Liberation Sans,
+  Nimbus Sans and DejaVu Sans is used; `check` and `resolve` report the actual
+  font and the substitution reason.
+- Cut descriptions take their MathText font from the font card by default.
+- Documentation moved to Jarvis-Books; the repository keeps only `README.md`,
+  `CHANGELOG.md` and the example READMEs. The source distribution ships
+  `CHANGELOG.md` instead of a `docs/` tree, and `tools/check_release.py` checks
+  the latest `CHANGELOG.md` entry instead of the old release-note files.
+
+## 2.1.10 — 2026-10-13
+
+- Native forest figures read multi-interval CSV sources and mappings,
+  intervals-only rows, box/scatter coexistence and literal CSV value
+  annotations. Values are plotted as supplied, never computed.
+- Explicit shared x ticks, independent of grid divisions.
+- MathText needs `math: true`; formula fonts are STIX by default with DejaVu
+  Sans as an alternative, selected separately for legends and cut
+  descriptions. Header notes, paragraphs and formulas are preserved, and
+  layout uses the actual font, glyph and annotation bounds.
+- TTC faces keep their weight and slant; an explicit font size governs
+  measurement.
+- CLI, manuals, render reports and image metadata read the version from
+  `jarvisplot/version.py`. SVG output carries Dublin Core metadata; export
+  retries only on a backend's unsupported-metadata error and reports drawing
+  and I/O failures.
+- Packaged AI README (`jplot man agent-readme --json`), schema, manual and
+  example updates.
+- `tools/check_release.py` source, tag and wheel gates; the sdist includes the
+  native forest examples; CI runs Linux Python 3.10–3.13 and macOS 3.13.
+
+Existing forest YAML needs no migration. Custom export metadata must use keys
+the selected backend supports; invalid SVG keys are now reported.
+
+## Earlier releases
+
+See the [PyPI release history](https://pypi.org/project/JarvisPLOT/#history)
+and [GitHub Releases](https://github.com/Pengxuan-Zhu-Phys/Jarvis-PLOT/releases).
+Earlier release notes are archived in Jarvis-Books
+`Docs/archive/Jarvis-PLOT/2026-10-17/docs/release/`.

{jarvisplot-2.1.10 → jarvisplot-2.1.11}/Example/forest/README.md

@@ -54,7 +54,7 @@ The normal chart shows a shared top numerical axis and continuous vertical grid;
 The default canvas is white, with no row shading, numbered metadata or legend heading. Point legend markers and their labels are left aligned using compact keys.
 
 For a study previously using `jarvis_forest_preview`, install the formal project in the same
-Python environment (`python -m pip install -e /Users/p.zhu/Jarvis-Workshop/Jarvis-PLOT`),
+Python environment (`python -m pip install -e .` from the Jarvis-PLOT repository root),
 remove its preview path from the shell/launcher PYTHONPATH, and call the formal `jplot` on
 the existing YAML. The native interface accepts the established `intervals`, annotation,
 MathText, header_note and geometry keys; no task-specific names or data conversion are needed.

{jarvisplot-2.1.10 → jarvisplot-2.1.11}/JarvisPLOT.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: JarvisPLOT
-Version: 2.1.10
+Version: 2.1.11
 Summary: Jarvis-PLOT: YAML-driven plotting engine
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -27,8 +27,8 @@ but it can also be used as a **standalone scientific plotting tool**.
 
 It provides a simple command-line interface (CLI) to generate publication-quality figures from YAML configuration files, with most layout and style decisions handled by predefined profiles and style cards.
 
-Current source candidate: **2.1.10** (`jplot -v` reports the installed version).
-Local release review does not publish or tag a release; see [release notes](docs/release/releases/v2.1.10.md).
+Current source candidate: **2.1.11** (`jplot -v` reports the installed version).
+Release history: [CHANGELOG.md](CHANGELOG.md). Design documents and specifications: [Jarvis-Books `Docs/Jarvis-PLOT/`](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/README.md).
 
 ---
 
@@ -110,6 +110,39 @@ jplot doctor plot.yaml              # validate + dryrun in one pass
 
 Every one of these takes `--json`.
 
+### Default fonts
+
+The bundled font card recommends **Helvetica** for sans text and **STIXGeneral**
+for serif text, with **STIX** MathText formulas. Normal YAML rendering applies
+the card automatically; explicit YAML fonts and sizes take precedence.
+When Helvetica is absent, Jarvis-PLOT selects the first installed similar family:
+Arial, Liberation Sans, Nimbus Sans, then DejaVu Sans. `check` and `resolve`
+report the actual font and substitution reason.
+
+```bash
+jplot fonts                         # role card: title, labels, ticks, legend, text, annotations, caption
+jplot fonts show title --json       # current defaults for one role
+jplot fonts show --recommended --json
+jplot fonts list --filter Helvetica --json
+jplot fonts list --refresh --json   # rescan after installing fonts
+jplot fonts resolve Helvetica --weight bold --json
+jplot fonts check --json            # actual installed faces used by the card
+jplot fonts set roles.title.family sans
+jplot fonts set roles.legend.family serif
+jplot fonts set roles.title.size_pt 9
+jplot fonts set roles.title.size_pt null  # inherit the plot style's size
+jplot fonts reset roles.title.size_pt
+jplot fonts reset                   # remove all personal overrides
+jplot man fonts --json
+```
+
+Personal overrides persist in `~/.jarvis/plot-fonts.json` (`JARVIS_HOME` overrides
+the directory). Queries never create that file. `size_pt: null` preserves the
+plot style's canvas-specific size; `recommended_size_pt` is drafting advice.
+Font discovery uses Matplotlib's cached system and bundled font index, while
+TTC face selection preserves the requested weight and slant. `$...$` uses
+MathText; an external LaTeX compiler has its own font configuration.
+
 ### Design-Reference Overlay
 
 Set `debug: true` on a figure and Jarvis-PLOT draws a dimension overlay on top
@@ -127,7 +160,7 @@ Figures:
 
 The style card's `Debug` block decides what the annotations look like and which
 of them appear; a per-figure `debug:` mapping overrides the card for that figure
-only. See `jplot man debug-overlay` and `docs/specs/STYLE_SCHEMA.md`.
+only. See `jplot man debug-overlay` and [STYLE_SCHEMA.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/STYLE_SCHEMA.md).
 
 > `Figures[].debug` is not the `jplot --debug` flag — the flag only raises the
 > log level.
@@ -152,6 +185,9 @@ TTY** — piping is enough.
 
 The loop `jplot man` prints is:
 
+Before drafting, inspect `jplot fonts show --json` and `jplot fonts check --json`
+for the typography defaults and actual installed font choices.
+
 1. `jplot data describe <file> --json` — column names from the real file. Never
    invent one; a wrong name is a hard error, not a warning.
 2. `jplot cap methods|styles|cmaps|funcs|transforms|types --json` — the legal
@@ -175,13 +211,13 @@ with the same object regroup automatically using card templates such as
 single-component object. `frame.<axes>.legend` owns card selection, `order`,
 `ncols`, position and spacing. JSON cards provide
 reusable defaults, and YAML can override them. See
-[the legend contract](docs/specs/LEGEND.md) and the
+[the legend contract](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/LEGEND.md) and the
 [self-contained example](Example/compact_legend.yaml).
 
 For continuous one-dimensional distributions from raw samples, use `PDF1D`
 (CDF plus PDF) or `CDF1D` in a data transform. `coordinates.x` owns `expr`,
 `lim`, and `grid`; optional `repeat` computes independent batch means and
-standard deviations. See [the contract](docs/specs/PDF_CDF_1D.md) and the
+standard deviations. See [the contract](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/PDF_CDF_1D.md) and the
 [runnable example](Example/pdf_cdf_1d.yaml).
 Reconstruction defaults to adaptive true CDF anchors and `monotone_c2`
 interpolation (C2 CDF / C1 PDF). Set `anchors: all` and `interpolation: pchip`
@@ -192,7 +228,7 @@ Two things worth knowing before trusting a config:
 - `jplot validate` checks shape and contracts and never touches the data;
   `jplot dryrun` loads the data and reports the row ledger and JP-VIZ render
   health. Passing the first says nothing about the second.
-- `docs/specs/AGENT_DATA_API.md` describes a *different*, still-frozen bridge
+- [AGENT_DATA_API.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/AGENT_DATA_API.md) describes a *different*, still-frozen bridge
   (a numeric digest channel for Jarvis-Agent). The surface above is what ships
   today.
 
@@ -249,24 +285,26 @@ multiple directory trees; overlapping selections are deduplicated. Use
 All cache subcommands accept `--json` and use the existing CLI envelope and
 exit codes (0 success/partial, 1 failure, 2 usage). Non-TTY stdout defaults to
 JSON; human results go to stderr. Active caches are skipped (`ok: null` when
-the remaining operation succeeds), and records for missing paths are pruned
-during cleanup. Only marked Jarvis-PLOT components are removed; source data,
+the remaining operation succeeds), and records for missing paths or unmarked
+`.cache` directories containing only empty Jarvis-PLOT component directories
+are pruned during cleanup. Only marked
+Jarvis-PLOT components are removed; source data,
 plots, and unrelated `.cache` content are retained. Failed deletions retain
-their registry entries. Scanning adopts legacy caches only when the four
+their registry entries; nonempty unmarked directories remain invalid and are
+not deleted. Scanning adopts legacy caches only when the four
 pipeline directories and a compatible `manifest.json` identify them; old
 unmarked twin-only directories need a new `dryrun --with-data` run to register.
 An explicitly supplied `--out-dir` is an export directory and is not registered.
 Concurrent registry writes use a lock and atomic replacement. Registration
 failures warn without preventing rendering.
 
-### Example: SUSYRun2 Ternary Plots
+### Example: Ternary Layouts
 
 ```bash
-jplot ./bin/SUSYRun2_EWMSSM.yaml
-jplot ./bin/SUSYRun2_GEWMSSM.yaml
+jplot ./Example/gambit_2x1.yaml
 ```
 
-> **Note:** The data file paths inside the YAML files must be updated to match your local setup.
+This layout reference uses bundled style cards and renders without external data.
 
 ### Example: Dynesty Runplot
 
@@ -288,7 +326,7 @@ Figures:
   - dynesty_runplot
 ```
 
-See `docs/specs/DYNESTY_RUNPLOT.md` for the default axes, KDE, scatter overlay,
+See [DYNESTY_RUNPLOT.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/DYNESTY_RUNPLOT.md) for the default axes, KDE, scatter overlay,
 and evidence summary behavior.
 
 ---
@@ -330,19 +368,19 @@ and evidence summary behavior.
 ### Documentation
 [https://pengxuan-zhu-phys.github.io/Jarvis-Docs/](https://pengxuan-zhu-phys.github.io/Jarvis-Docs/)
 
-### Repository Docs
+### Project Docs
 
-Tracked project docs live in `docs/`.
+This repository keeps only `README.md` and `CHANGELOG.md`. Design documents,
+specifications and the roadmap live in Jarvis-Books:
 
-- `docs/README.md` - repo doc index
-- `docs/context/JARVIS_PLOT_CONTEXT.md` - primary Codex-facing boundary doc
-- `docs/context/CODE_MAP_JARVIS_PLOT.md` - concrete code owner map
-- `docs/context/JARVIS_PLOT_FRAMEWORK_LOGIC.md` - runtime execution contract
-- `docs/roadmap/IMPLEMENTATION_ROADMAP.md` - active backlog and future work list
-- `docs/specs/AGENT_DATA_API.md` - planned numeric agent bridge (spec only, frozen — not the shipped CLI agent surface above)
-- `docs/specs/STYLE_SCHEMA.md` - style card contract, including the `Debug` overlay block
-- `docs/dev/DEVELOPER_RULES.md` - current pipeline and cache rules
-- `docs/dev/MEMORY_OPTIMIZATION_GUIDE.md` - narrow-table memory notes
+- [Doc index](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/README.md)
+- [JARVIS_PLOT_CONTEXT.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/context/JARVIS_PLOT_CONTEXT.md) - project boundary; read before changing code
+- [CODE_MAP_JARVIS_PLOT.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/context/CODE_MAP_JARVIS_PLOT.md) - code owner map
+- [JARVIS_PLOT_FRAMEWORK_LOGIC.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/context/JARVIS_PLOT_FRAMEWORK_LOGIC.md) - runtime execution contract
+- [IMPLEMENTATION_ROADMAP.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/roadmap/IMPLEMENTATION_ROADMAP.md) - open work
+- [RELEASING.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/release/RELEASING.md) - versioning, `tools/check_release.py` and CI verification
+- [STYLE_SCHEMA.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/STYLE_SCHEMA.md) - style card contract, including the `Debug` overlay block
+- [DEVELOPER_RULES.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/dev/DEVELOPER_RULES.md) - pipeline and cache rules
 
 Read the context docs and roadmap before changing parsing, transforms, rendering, or layout-related behavior.
 
@@ -352,6 +390,25 @@ Read the context docs and roadmap before changing parsing, transforms, rendering
 
 MIT License
 
-Create a continuous forest figure with `type: forest`, a generic row table, optional points and multiple supplied intervals per row. Native YAML supports class-specific interval lanes, CSV value annotations, explicit `x.ticks`, opt-in MathText, header notes and a shared-format legend. The default Swiss-column card uses 82.5 mm width and 5.5 mm row pitch; every row shares one numerical x domain. See [the forest contract](docs/specs/FOREST.md), [native examples](Example/forest/README.md), or `jplot man forest --json`.
+Create a continuous forest figure with `type: forest`, a generic row table, optional points and multiple supplied intervals per row. Native YAML supports class-specific interval lanes, CSV value annotations, explicit `x.ticks`, opt-in MathText, header notes and a shared-format legend. The default Swiss-column card uses 82.5 mm width and 5.5 mm row pitch; every row shares one numerical x domain. See [the forest contract](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/FOREST.md), [native examples](Example/forest/README.md), or `jplot man forest --json`.
 
 AI agents: start with `jplot man agent-readme --json` for the official-package YAML workflow and missing-feature reporting instructions. Feature requests include the installed version from `jplot --version`; the CLI does not send email automatically.
+
+## Releasing
+
+`jprel` is a maintainer-local script, excluded from Git and distribution archives.
+
+Record changes in `CHANGELOG.md`, then run from this checkout (replace the
+example version with the intended release):
+
+```bash
+./jprel 2.1.11 --dry
+./jprel 2.1.11
+```
+
+`--dry` performs read-only source and release-note checks. The normal command
+requires a clean Git checkout, builds and checks the wheel and sdist, uploads
+to PyPI, refreshes the local version with `python3 -m pip install -e .`, and
+verifies the installed version. Only then does it commit the version, push the
+`vX.Y.Z` tag, and create a GitHub release with changelog notes. Configure Twine
+and `gh` authentication before publishing.

{jarvisplot-2.1.10 → jarvisplot-2.1.11}/JarvisPLOT.egg-info/SOURCES.txt

@@ -1,3 +1,4 @@
+CHANGELOG.md
 MANIFEST.in
 README.md
 VERSION
@@ -24,63 +25,6 @@ JarvisPLOT.egg-info/dependency_links.txt
 JarvisPLOT.egg-info/entry_points.txt
 JarvisPLOT.egg-info/requires.txt
 JarvisPLOT.egg-info/top_level.txt
-docs/README.md
-docs/archive/JARVIS_PLOT_CODE_REVIEW_2026-03-04.md
-docs/archive/README.md
-docs/context/CODEX_JARVIS_PLOT_STYLE.md
-docs/context/CODE_MAP_JARVIS_PLOT.md
-docs/context/JARVIS_PLOT_CONTEXT.md
-docs/context/JARVIS_PLOT_FRAMEWORK_LOGIC.md
-docs/context/README.md
-docs/design/ARCHITECTURE_OVERVIEW.md
-docs/design/DATAFLOW_ARCHITECTURE.md
-docs/design/LAYOUT_ENGINE_DESIGN.md
-docs/design/PROFILE_SYSTEM_DESIGN.md
-docs/design/README.md
-docs/design/STYLE_SYSTEM_DESIGN.md
-docs/design/YAML_DESIGN.md
-docs/dev/AGENT_CLI_CLOSURE_AUDIT_2026-08-07.md
-docs/dev/AGENT_CLI_FULL_REVIEW_2026-08-06.md
-docs/dev/AGENT_OUTPUT_YAML_DESIGN.md
-docs/dev/CONTRIBUTION_GUIDE.md
-docs/dev/DEVELOPER_RULES.md
-docs/dev/MAN_CLI.md
-docs/dev/MEMORY_OPTIMIZATION_GUIDE.md
-docs/dev/MEMTRACE_SYSTEM.md
-docs/dev/README.md
-docs/dev/YAML_HUMAN_AI_OCCAM_REVIEW.md
-docs/release/README.md
-docs/release/RELEASE_PLAYBOOK.md
-docs/release/releases/README.md
-docs/release/releases/v1.2.6.md
-docs/release/releases/v2.1.10.md
-docs/release/releases/v2.1.6.md
-docs/release/releases/v2.1.9.md
-docs/roadmap/IMPLEMENTATION_ROADMAP.md
-docs/roadmap/README.md
-docs/roadmap/V2_AGENT_CLI_SURFACE.md
-docs/roadmap/V2_DEV_LEDGER.md
-docs/roadmap/V2_YAML_AGENT_ERGONOMICS.md
-docs/roadmap/soft-cooking-wilkinson.md
-docs/specs/AGENT_DATA_API.md
-docs/specs/CORRELATION_DIAMOND.md
-docs/specs/CORRELATION_MATRIX.md
-docs/specs/DYNESTY_RUNPLOT.md
-docs/specs/FOREST.md
-docs/specs/INTERP_2D.md
-docs/specs/LAYER_TYPE_REGISTRY.md
-docs/specs/LEGEND.md
-docs/specs/PDF_CDF_1D.md
-docs/specs/POSTERIOR_DENSITY.md
-docs/specs/PROFILE_SCHEMA.md
-docs/specs/README.md
-docs/specs/SCENE_JSON_SCHEMA.md
-docs/specs/STYLE_SCHEMA.md
-docs/specs/TRANSFORMS.md
-docs/templates/README.md
-docs/templates/profile.example.json
-docs/templates/scene.example.json
-docs/templates/style.example.json
 jarvisplot/__init__.py
 jarvisplot/agent_digest.py
 jarvisplot/agent_io.py
@@ -111,6 +55,8 @@ jarvisplot/dryrun_runtime.py
 jarvisplot/expr_names.py
 jarvisplot/fix_apply.py
 jarvisplot/flowchart.py
+jarvisplot/font_runtime.py
+jarvisplot/fonts.py
 jarvisplot/forest_contract.py
 jarvisplot/forest_text.py
 jarvisplot/generated_data.py
@@ -191,6 +137,7 @@ jarvisplot/cards/corrplot/diamond.json
 jarvisplot/cards/corrplot/matrix.json
 jarvisplot/cards/default/output.json
 jarvisplot/cards/flowchart/default.json
+jarvisplot/cards/fonts/default.json
 jarvisplot/cards/forest/swiss_column.json
 jarvisplot/cards/gambit/1x1/ternary.json
 jarvisplot/cards/gambit/2x1/rect_cmap.json
@@ -218,6 +165,7 @@ jarvisplot/manual_cards/debug-overlay.yaml
 jarvisplot/manual_cards/diagnostics.yaml
 jarvisplot/manual_cards/dryrun-viz.yaml
 jarvisplot/manual_cards/field-interp.yaml
+jarvisplot/manual_cards/fonts.yaml
 jarvisplot/manual_cards/generated-data.yaml
 jarvisplot/manual_cards/layer-method.yaml
 jarvisplot/manual_cards/legend.yaml
@@ -287,6 +235,7 @@ jarvisplot/verbs/data.py
 jarvisplot/verbs/doctor.py
 jarvisplot/verbs/dryrun.py
 jarvisplot/verbs/explain.py
+jarvisplot/verbs/fonts.py
 jarvisplot/verbs/man.py
 jarvisplot/verbs/suggest.py
 jarvisplot/verbs/template.py
@@ -322,7 +271,6 @@ tests/test_density_cell_transform.py
 tests/test_design_runtime.py
 tests/test_diagnostic_guidance.py
 tests/test_distribution_1d_transform.py
-tests/test_docs_status_labels.py
 tests/test_doctor_partial.py
 tests/test_examples_validate.py
 tests/test_explain.py
@@ -331,6 +279,9 @@ tests/test_figure_contracts.py
 tests/test_figure_type_expander.py
 tests/test_fix_application.py
 tests/test_flowchart_renderer.py
+tests/test_font_runtime.py
+tests/test_fonts.py
+tests/test_fonts_cli.py
 tests/test_forest.py
 tests/test_forest_examples.py
 tests/test_forest_text.py
@@ -358,7 +309,6 @@ tests/test_schema_catalog.py
 tests/test_suggest.py
 tests/test_suggest_axes.py
 tests/test_template_catalog.py
-tests/test_template_json.py
 tests/test_ternary_debug.py
 tests/test_transform_contracts.py
 tests/test_validate_no_matplotlib.py

jarvisplot-2.1.11/MANIFEST.in

@@ -0,0 +1,36 @@
+include VERSION
+include tools/check_release.py
+include CHANGELOG.md
+recursive-include Example/forest *.yaml *.csv *.md
+
+# Git ignores do not control source distributions.
+exclude jprel
+prune docs
+prune .github
+prune .claude
+prune .codex
+prune .agents
+prune .cursor
+prune .idea
+prune .vscode
+prune .aws
+prune .ssh
+prune .twine
+prune .pypi
+prune .venv
+prune venv
+prune env
+prune .cache
+prune .pytest_cache
+prune .ruff_cache
+prune .mypy_cache
+prune .tox
+prune .nox
+prune .ipynb_checkpoints
+global-exclude .DS_Store *.py[cod] .env .env.* .envrc .pypirc .pypirc.* .twinerc .pypi-token* .mcp.json release.env twine.env *.code-workspace *.swp *.swo *~ *.bak *.tmp
+prune bin
+prune Workshop
+prune Example/plots
+prune Example/.cache
+prune Example/forest/plots
+prune Example/forest/.cache

{jarvisplot-2.1.10 → jarvisplot-2.1.11}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: JarvisPLOT
-Version: 2.1.10
+Version: 2.1.11
 Summary: Jarvis-PLOT: YAML-driven plotting engine
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -27,8 +27,8 @@ but it can also be used as a **standalone scientific plotting tool**.
 
 It provides a simple command-line interface (CLI) to generate publication-quality figures from YAML configuration files, with most layout and style decisions handled by predefined profiles and style cards.
 
-Current source candidate: **2.1.10** (`jplot -v` reports the installed version).
-Local release review does not publish or tag a release; see [release notes](docs/release/releases/v2.1.10.md).
+Current source candidate: **2.1.11** (`jplot -v` reports the installed version).
+Release history: [CHANGELOG.md](CHANGELOG.md). Design documents and specifications: [Jarvis-Books `Docs/Jarvis-PLOT/`](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/README.md).
 
 ---
 
@@ -110,6 +110,39 @@ jplot doctor plot.yaml              # validate + dryrun in one pass
 
 Every one of these takes `--json`.
 
+### Default fonts
+
+The bundled font card recommends **Helvetica** for sans text and **STIXGeneral**
+for serif text, with **STIX** MathText formulas. Normal YAML rendering applies
+the card automatically; explicit YAML fonts and sizes take precedence.
+When Helvetica is absent, Jarvis-PLOT selects the first installed similar family:
+Arial, Liberation Sans, Nimbus Sans, then DejaVu Sans. `check` and `resolve`
+report the actual font and substitution reason.
+
+```bash
+jplot fonts                         # role card: title, labels, ticks, legend, text, annotations, caption
+jplot fonts show title --json       # current defaults for one role
+jplot fonts show --recommended --json
+jplot fonts list --filter Helvetica --json
+jplot fonts list --refresh --json   # rescan after installing fonts
+jplot fonts resolve Helvetica --weight bold --json
+jplot fonts check --json            # actual installed faces used by the card
+jplot fonts set roles.title.family sans
+jplot fonts set roles.legend.family serif
+jplot fonts set roles.title.size_pt 9
+jplot fonts set roles.title.size_pt null  # inherit the plot style's size
+jplot fonts reset roles.title.size_pt
+jplot fonts reset                   # remove all personal overrides
+jplot man fonts --json
+```
+
+Personal overrides persist in `~/.jarvis/plot-fonts.json` (`JARVIS_HOME` overrides
+the directory). Queries never create that file. `size_pt: null` preserves the
+plot style's canvas-specific size; `recommended_size_pt` is drafting advice.
+Font discovery uses Matplotlib's cached system and bundled font index, while
+TTC face selection preserves the requested weight and slant. `$...$` uses
+MathText; an external LaTeX compiler has its own font configuration.
+
 ### Design-Reference Overlay
 
 Set `debug: true` on a figure and Jarvis-PLOT draws a dimension overlay on top
@@ -127,7 +160,7 @@ Figures:
 
 The style card's `Debug` block decides what the annotations look like and which
 of them appear; a per-figure `debug:` mapping overrides the card for that figure
-only. See `jplot man debug-overlay` and `docs/specs/STYLE_SCHEMA.md`.
+only. See `jplot man debug-overlay` and [STYLE_SCHEMA.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/STYLE_SCHEMA.md).
 
 > `Figures[].debug` is not the `jplot --debug` flag — the flag only raises the
 > log level.
@@ -152,6 +185,9 @@ TTY** — piping is enough.
 
 The loop `jplot man` prints is:
 
+Before drafting, inspect `jplot fonts show --json` and `jplot fonts check --json`
+for the typography defaults and actual installed font choices.
+
 1. `jplot data describe <file> --json` — column names from the real file. Never
    invent one; a wrong name is a hard error, not a warning.
 2. `jplot cap methods|styles|cmaps|funcs|transforms|types --json` — the legal
@@ -175,13 +211,13 @@ with the same object regroup automatically using card templates such as
 single-component object. `frame.<axes>.legend` owns card selection, `order`,
 `ncols`, position and spacing. JSON cards provide
 reusable defaults, and YAML can override them. See
-[the legend contract](docs/specs/LEGEND.md) and the
+[the legend contract](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/LEGEND.md) and the
 [self-contained example](Example/compact_legend.yaml).
 
 For continuous one-dimensional distributions from raw samples, use `PDF1D`
 (CDF plus PDF) or `CDF1D` in a data transform. `coordinates.x` owns `expr`,
 `lim`, and `grid`; optional `repeat` computes independent batch means and
-standard deviations. See [the contract](docs/specs/PDF_CDF_1D.md) and the
+standard deviations. See [the contract](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/PDF_CDF_1D.md) and the
 [runnable example](Example/pdf_cdf_1d.yaml).
 Reconstruction defaults to adaptive true CDF anchors and `monotone_c2`
 interpolation (C2 CDF / C1 PDF). Set `anchors: all` and `interpolation: pchip`
@@ -192,7 +228,7 @@ Two things worth knowing before trusting a config:
 - `jplot validate` checks shape and contracts and never touches the data;
   `jplot dryrun` loads the data and reports the row ledger and JP-VIZ render
   health. Passing the first says nothing about the second.
-- `docs/specs/AGENT_DATA_API.md` describes a *different*, still-frozen bridge
+- [AGENT_DATA_API.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/AGENT_DATA_API.md) describes a *different*, still-frozen bridge
   (a numeric digest channel for Jarvis-Agent). The surface above is what ships
   today.
 
@@ -249,24 +285,26 @@ multiple directory trees; overlapping selections are deduplicated. Use
 All cache subcommands accept `--json` and use the existing CLI envelope and
 exit codes (0 success/partial, 1 failure, 2 usage). Non-TTY stdout defaults to
 JSON; human results go to stderr. Active caches are skipped (`ok: null` when
-the remaining operation succeeds), and records for missing paths are pruned
-during cleanup. Only marked Jarvis-PLOT components are removed; source data,
+the remaining operation succeeds), and records for missing paths or unmarked
+`.cache` directories containing only empty Jarvis-PLOT component directories
+are pruned during cleanup. Only marked
+Jarvis-PLOT components are removed; source data,
 plots, and unrelated `.cache` content are retained. Failed deletions retain
-their registry entries. Scanning adopts legacy caches only when the four
+their registry entries; nonempty unmarked directories remain invalid and are
+not deleted. Scanning adopts legacy caches only when the four
 pipeline directories and a compatible `manifest.json` identify them; old
 unmarked twin-only directories need a new `dryrun --with-data` run to register.
 An explicitly supplied `--out-dir` is an export directory and is not registered.
 Concurrent registry writes use a lock and atomic replacement. Registration
 failures warn without preventing rendering.
 
-### Example: SUSYRun2 Ternary Plots
+### Example: Ternary Layouts
 
 ```bash
-jplot ./bin/SUSYRun2_EWMSSM.yaml
-jplot ./bin/SUSYRun2_GEWMSSM.yaml
+jplot ./Example/gambit_2x1.yaml
 ```
 
-> **Note:** The data file paths inside the YAML files must be updated to match your local setup.
+This layout reference uses bundled style cards and renders without external data.
 
 ### Example: Dynesty Runplot
 
@@ -288,7 +326,7 @@ Figures:
   - dynesty_runplot
 ```
 
-See `docs/specs/DYNESTY_RUNPLOT.md` for the default axes, KDE, scatter overlay,
+See [DYNESTY_RUNPLOT.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/DYNESTY_RUNPLOT.md) for the default axes, KDE, scatter overlay,
 and evidence summary behavior.
 
 ---
@@ -330,19 +368,19 @@ and evidence summary behavior.
 ### Documentation
 [https://pengxuan-zhu-phys.github.io/Jarvis-Docs/](https://pengxuan-zhu-phys.github.io/Jarvis-Docs/)
 
-### Repository Docs
+### Project Docs
 
-Tracked project docs live in `docs/`.
+This repository keeps only `README.md` and `CHANGELOG.md`. Design documents,
+specifications and the roadmap live in Jarvis-Books:
 
-- `docs/README.md` - repo doc index
-- `docs/context/JARVIS_PLOT_CONTEXT.md` - primary Codex-facing boundary doc
-- `docs/context/CODE_MAP_JARVIS_PLOT.md` - concrete code owner map
-- `docs/context/JARVIS_PLOT_FRAMEWORK_LOGIC.md` - runtime execution contract
-- `docs/roadmap/IMPLEMENTATION_ROADMAP.md` - active backlog and future work list
-- `docs/specs/AGENT_DATA_API.md` - planned numeric agent bridge (spec only, frozen — not the shipped CLI agent surface above)
-- `docs/specs/STYLE_SCHEMA.md` - style card contract, including the `Debug` overlay block
-- `docs/dev/DEVELOPER_RULES.md` - current pipeline and cache rules
-- `docs/dev/MEMORY_OPTIMIZATION_GUIDE.md` - narrow-table memory notes
+- [Doc index](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/README.md)
+- [JARVIS_PLOT_CONTEXT.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/context/JARVIS_PLOT_CONTEXT.md) - project boundary; read before changing code
+- [CODE_MAP_JARVIS_PLOT.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/context/CODE_MAP_JARVIS_PLOT.md) - code owner map
+- [JARVIS_PLOT_FRAMEWORK_LOGIC.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/context/JARVIS_PLOT_FRAMEWORK_LOGIC.md) - runtime execution contract
+- [IMPLEMENTATION_ROADMAP.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/roadmap/IMPLEMENTATION_ROADMAP.md) - open work
+- [RELEASING.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/release/RELEASING.md) - versioning, `tools/check_release.py` and CI verification
+- [STYLE_SCHEMA.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/STYLE_SCHEMA.md) - style card contract, including the `Debug` overlay block
+- [DEVELOPER_RULES.md](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/dev/DEVELOPER_RULES.md) - pipeline and cache rules
 
 Read the context docs and roadmap before changing parsing, transforms, rendering, or layout-related behavior.
 
@@ -352,6 +390,25 @@ Read the context docs and roadmap before changing parsing, transforms, rendering
 
 MIT License
 
-Create a continuous forest figure with `type: forest`, a generic row table, optional points and multiple supplied intervals per row. Native YAML supports class-specific interval lanes, CSV value annotations, explicit `x.ticks`, opt-in MathText, header notes and a shared-format legend. The default Swiss-column card uses 82.5 mm width and 5.5 mm row pitch; every row shares one numerical x domain. See [the forest contract](docs/specs/FOREST.md), [native examples](Example/forest/README.md), or `jplot man forest --json`.
+Create a continuous forest figure with `type: forest`, a generic row table, optional points and multiple supplied intervals per row. Native YAML supports class-specific interval lanes, CSV value annotations, explicit `x.ticks`, opt-in MathText, header notes and a shared-format legend. The default Swiss-column card uses 82.5 mm width and 5.5 mm row pitch; every row shares one numerical x domain. See [the forest contract](https://github.com/Pengxuan-Zhu-Phys/Jarvis-Books/blob/main/Docs/Jarvis-PLOT/specs/FOREST.md), [native examples](Example/forest/README.md), or `jplot man forest --json`.
 
 AI agents: start with `jplot man agent-readme --json` for the official-package YAML workflow and missing-feature reporting instructions. Feature requests include the installed version from `jplot --version`; the CLI does not send email automatically.
+
+## Releasing
+
+`jprel` is a maintainer-local script, excluded from Git and distribution archives.
+
+Record changes in `CHANGELOG.md`, then run from this checkout (replace the
+example version with the intended release):
+
+```bash
+./jprel 2.1.11 --dry
+./jprel 2.1.11
+```
+
+`--dry` performs read-only source and release-note checks. The normal command
+requires a clean Git checkout, builds and checks the wheel and sdist, uploads
+to PyPI, refreshes the local version with `python3 -m pip install -e .`, and
+verifies the installed version. Only then does it commit the version, push the
+`vX.Y.Z` tag, and create a GitHub release with changelog notes. Configure Twine
+and `gh` authentication before publishing.