Release version 0.16.5

AmberLee2427 · AmberLee2427 · commit 06c11d154c4a · 2026-02-04T11:37:37.000-05:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.16.5] - 2026-02-04
+
+### Fixed
+- Dossier assets are now copied into the dossier output and linked with URL-safe relative paths,
+  improving image loading in Roman Research Nexus and similar environments.
+- Event data, plots, and posteriors now resolve reliably when paths include spaces or nested folders.
+
+
 ## [0.16.4] - 2026-01-14
 
 ### Added
diff --git a/CITATION.cff b/CITATION.cff
@@ -1,7 +1,7 @@
 cff-version: 1.2.0
 message: "If you use microlens-submit, please cite it as below."
 title: "microlens-submit"
-version: "0.16.4"
+version: "0.16.5"
 authors:
   - family-names: Malpas
     given-names: Amber
diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
@@ -1,28 +1,12 @@
-# microlens-submit v0.16.4 Release Notes
+# microlens-submit v0.16.5 Release Notes
 
-**Release Date:** 2026-01-14
+**Release Date:** 2026-02-04
 
 ## Changelog
 
-## [0.16.4] - 2026-01-14
-
-### Added
-- Added `remove-event`/`remove-solution` CLI commands and `remove_event`/`remove_solution` API helpers with a `--force` guard for hard deletes.
-- Added `git_dir` metadata plus `set-git-dir` to capture Git info when the repo lives outside the submission directory.
-- Added optional GPU fields in `hardware_info` (`gpu.model`, `gpu.count`, `gpu.memory_gb`) alongside platform/OS capture.
-- Added non-Nexus hardware auto-fill using `psutil` for CPU and memory details.
-- Added conda-forge recipe (`conda/recipe/meta.yaml`) to the version bump script (`scripts/bump_version`).
-- Added sha256 update in `conda/recipe/meta.yaml` to the release workflow.
-- Added a workflow release job to copy the local updated version on the conda-forge recipe to the feedstock fork (`AmberLee2427/microlens-submit-feedstock`) and send a PR, after PyPI release.
-
-
-### Changed
-- Updated tiers to `beginner`/`experienced`; event ID validation now uses inclusive ranges and 3-digit IDs for `2018-test`.
-- CLI numeric parsing now accepts leading decimals like `.001`.
-- Clarified quickstart/tutorial guidance around working directories and hardware info requirements.
-
+## [0.16.5] - 2026-02-04
 
 ### Fixed
-- CSV import now skips blank rows to avoid NoneType parsing errors.
-- Validation messaging now highlights missing bands when flux parameters are provided.
-- Improved Windows notes editor fallback for better default editor selection.
+- Dossier assets are now copied into the dossier output and linked with URL-safe relative paths,
+  improving image loading in Roman Research Nexus and similar environments.
+- Event data, plots, and posteriors now resolve reliably when paths include spaces or nested folders.
diff --git a/TODO b/TODO
@@ -19,11 +19,11 @@
 - [x] auto populate hardware info
 - [x] ".001" gets interpreted as a string
 - [x] nexus init gives hardware warning and it doesn't need to
-- [ ] nexus dosiers (with submission in /teams/*) not displaying images (problem in AAS workshop notebook)
+- [ ] nexus dosiers (with submission in /teams/*) not displaying images (problem in AAS workshop notebooks)
 - [x] "Experienced' tier not "Advanced"
-- [ ] validate physical parameters
+- [ ] validate physical parameters (blocked)
 - [x] "piEN (instead of piEN)" when piEN was missing
-- [ ] additional model types
+- [ ] additional model types (blocked)
 - [x] git and submission in different locations (add git_dir)
 - [x] Windows build in workflow
 - [x] Release Workflow
diff --git a/conda/recipe/meta.yaml b/conda/recipe/meta.yaml
@@ -1,6 +1,6 @@
 {% set name = "microlens-submit" %}
 {% set filename_name = name | replace("-", "_") %}
-{% set version = "0.16.4" %}
+{% set version = "0.16.5" %}
 {% set python_min = "3.10" %}
 
 # NOTE: This recipe is the source of truth for conda-forge. Edit it here in
diff --git a/docs/conf.py b/docs/conf.py
@@ -8,7 +8,7 @@
 author = "RGES-PIT"
 
 # The full version, including alpha/beta/rc tags
-release = "0.16.4"
+release = "0.16.5"
 
 extensions = [
     "sphinx.ext.autodoc",
diff --git a/microlens_submit/__init__.py b/microlens_submit/__init__.py
@@ -5,7 +5,7 @@
 the command line interface.
 """
 
-__version__ = "0.16.4"
+__version__ = "0.16.5"
 
 from .models import Event, Solution, Submission
 from .utils import load
diff --git a/microlens_submit/dossier/event_page.py b/microlens_submit/dossier/event_page.py
@@ -12,6 +12,7 @@
 from .. import __version__
 from ..models import Event, Submission
 from .solution_page import generate_solution_page
+from .utils import resolve_dossier_asset_path
 
 
 def generate_event_page(event: Event, submission: Submission, output_dir: Path) -> None:
@@ -50,7 +51,17 @@ def generate_event_page(event: Event, submission: Submission, output_dir: Path)
         to individual solution pages.
     """
     # Prepare output directory (already created)
-    html = _generate_event_page_content(event, submission)
+    project_root = Path(submission.project_path)
+    event_data_link = ""
+    if hasattr(event, "event_data_path") and event.event_data_path:
+        event_data_link = resolve_dossier_asset_path(
+            event.event_data_path,
+            project_root,
+            output_dir,
+            subdir="event-data",
+            prefix=f"{event.event_id}_event_data",
+        )
+    html = _generate_event_page_content(event, submission, event_data_link=event_data_link)
     with (output_dir / f"{event.event_id}.html").open("w", encoding="utf-8") as f:
         f.write(html)
 
@@ -59,7 +70,12 @@ def generate_event_page(event: Event, submission: Submission, output_dir: Path)
         generate_solution_page(sol, event, submission, output_dir)
 
 
-def _generate_event_page_content(event: Event, submission: Submission) -> str:
+def _generate_event_page_content(
+    event: Event,
+    submission: Submission,
+    *,
+    event_data_link: str = "",
+) -> str:
     """Generate the HTML content for an event dossier page.
 
     Creates the complete HTML content for a single event page, including
@@ -163,10 +179,10 @@ def sort_key(sol):
     )
     # Optional raw data link
     raw_data_html = ""
-    if hasattr(event, "event_data_path") and event.event_data_path:
+    if event_data_link:
         raw_data_html = (
             f'<p class="text-rtd-text">Raw Event Data: '
-            f'<a href="{event.event_data_path}" '
+            f'<a href="{event_data_link}" '
             f'class="text-rtd-accent hover:underline">Download Data</a></p>'
         )
     # HTML content
diff --git a/microlens_submit/dossier/full_report.py b/microlens_submit/dossier/full_report.py
@@ -15,6 +15,7 @@
 from .dashboard import _generate_dashboard_content
 from .event_page import _generate_event_page_content
 from .solution_page import _generate_solution_page_content
+from .utils import resolve_dossier_asset_path
 
 
 def generate_full_dossier_report_html(submission: Submission, output_dir: Path) -> None:
@@ -63,19 +64,57 @@ def generate_full_dossier_report_html(submission: Submission, output_dir: Path)
     all_html_sections.append('<hr class="my-8 border-t-2 border-rtd-accent">')  # Divider after dashboard
 
     # Events and solutions
+    project_root = Path(submission.project_path)
     for event in submission.events.values():
-        event_html = _generate_event_page_content(event, submission)
+        event_data_link = ""
+        if hasattr(event, "event_data_path") and event.event_data_path:
+            event_data_link = resolve_dossier_asset_path(
+                event.event_data_path,
+                project_root,
+                output_dir,
+                subdir="event-data",
+                prefix=f"{event.event_id}_event_data",
+            )
+        event_html = _generate_event_page_content(event, submission, event_data_link=event_data_link)
         event_body = extract_main_content_body(event_html, section_type="event", section_id=event.event_id)
         all_html_sections.append(event_body)
         all_html_sections.append('<hr class="my-8 border-t-2 border-rtd-accent">')  # Divider after event
 
         for sol in event.get_active_solutions():
-            sol_html = _generate_solution_page_content(sol, event, submission)
+            lc_plot = resolve_dossier_asset_path(
+                sol.lightcurve_plot_path,
+                project_root,
+                output_dir,
+                subdir="plots",
+                prefix=f"{event.event_id}_{sol.solution_id}_lightcurve",
+            )
+            lens_plot = resolve_dossier_asset_path(
+                sol.lens_plane_plot_path,
+                project_root,
+                output_dir,
+                subdir="plots",
+                prefix=f"{event.event_id}_{sol.solution_id}_lens",
+            )
+            posterior = resolve_dossier_asset_path(
+                sol.posterior_path,
+                project_root,
+                output_dir,
+                subdir="posteriors",
+                prefix=f"{event.event_id}_{sol.solution_id}_posterior",
+            )
+            sol_html = _generate_solution_page_content(
+                sol,
+                event,
+                submission,
+                lc_plot=lc_plot,
+                lens_plot=lens_plot,
+                posterior=posterior,
+            )
             sol_body = extract_main_content_body(
                 sol_html,
                 section_type="solution",
                 section_id=sol.solution_id,
-                project_root=Path(submission.project_path),
+                project_root=project_root,
                 solution=sol,
             )
             all_html_sections.append(sol_body)
diff --git a/microlens_submit/dossier/solution_page.py b/microlens_submit/dossier/solution_page.py
@@ -8,13 +8,15 @@
 
 from datetime import datetime
 from pathlib import Path
+from typing import Optional
 
 import markdown
 
 from .. import __version__
 from ..models.event import Event
 from ..models.solution import Solution
 from ..models.submission import Submission
+from .utils import resolve_dossier_asset_path
 
 
 def generate_solution_page(solution: Solution, event: Event, submission: Submission, output_dir: Path) -> None:
@@ -55,12 +57,49 @@ def generate_solution_page(solution: Solution, event: Event, submission: Submiss
         Notes are rendered with syntax highlighting for code blocks.
     """
     # Prepare output directory (already created)
-    html = _generate_solution_page_content(solution, event, submission)
+    project_root = Path(submission.project_path)
+    lc_plot = resolve_dossier_asset_path(
+        solution.lightcurve_plot_path,
+        project_root,
+        output_dir,
+        subdir="plots",
+        prefix=f"{event.event_id}_{solution.solution_id}_lightcurve",
+    )
+    lens_plot = resolve_dossier_asset_path(
+        solution.lens_plane_plot_path,
+        project_root,
+        output_dir,
+        subdir="plots",
+        prefix=f"{event.event_id}_{solution.solution_id}_lens",
+    )
+    posterior = resolve_dossier_asset_path(
+        solution.posterior_path,
+        project_root,
+        output_dir,
+        subdir="posteriors",
+        prefix=f"{event.event_id}_{solution.solution_id}_posterior",
+    )
+    html = _generate_solution_page_content(
+        solution,
+        event,
+        submission,
+        lc_plot=lc_plot,
+        lens_plot=lens_plot,
+        posterior=posterior,
+    )
     with (output_dir / f"{solution.solution_id}.html").open("w", encoding="utf-8") as f:
         f.write(html)
 
 
-def _generate_solution_page_content(solution: Solution, event: Event, submission: Submission) -> str:
+def _generate_solution_page_content(
+    solution: Solution,
+    event: Event,
+    submission: Submission,
+    *,
+    lc_plot: Optional[str] = None,
+    lens_plot: Optional[str] = None,
+    posterior: Optional[str] = None,
+) -> str:
     """Generate the HTML content for a solution dossier page.
 
     Creates the complete HTML content for a single solution page, including
@@ -138,9 +177,9 @@ def _generate_solution_page_content(solution: Solution, event: Event, submission
     # Higher-order effects
     hoe_str = ", ".join(solution.higher_order_effects) if solution.higher_order_effects else "None"
     # Plot paths (relative to solution page)
-    lc_plot = solution.lightcurve_plot_path or ""
-    lens_plot = solution.lens_plane_plot_path or ""
-    posterior = solution.posterior_path or ""
+    lc_plot = lc_plot if lc_plot is not None else (solution.lightcurve_plot_path or "")
+    lens_plot = lens_plot if lens_plot is not None else (solution.lens_plane_plot_path or "")
+    posterior = posterior if posterior is not None else (solution.posterior_path or "")
     # Physical parameters table
     phys_rows = []
     phys = solution.physical_parameters or {}
diff --git a/microlens_submit/dossier/utils.py b/microlens_submit/dossier/utils.py
@@ -6,7 +6,11 @@
 and other helper functions.
 """
 
+import hashlib
+import shutil
+from pathlib import Path
 from typing import Any, Dict, Optional
+from urllib.parse import quote, urlparse
 
 
 def format_hardware_info(hardware_info: Optional[Dict[str, Any]]) -> str:
@@ -109,3 +113,62 @@ def extract_github_repo_name(repo_url: str) -> str:
             return f"{parts[-2]}/{parts[-1]}"
 
     return None
+
+
+def resolve_dossier_asset_path(
+    path_value: Optional[str],
+    project_root: Path,
+    output_dir: Path,
+    *,
+    subdir: str,
+    prefix: Optional[str] = None,
+) -> str:
+    """Resolve and copy a local asset into the dossier assets folder.
+
+    If the input path is a URL, it is returned unchanged. If it is a local
+    filesystem path, it is resolved relative to the project root, copied into
+    the dossier assets folder, and returned as a URL-encoded relative path.
+
+    Args:
+        path_value: The original path or URL string.
+        project_root: Root directory of the submission project.
+        output_dir: Dossier output directory containing the HTML files.
+        subdir: Subdirectory under assets/ for the copied file.
+        prefix: Optional prefix for the copied file name to avoid collisions.
+
+    Returns:
+        str: A URL or a relative path suitable for HTML src/href attributes.
+    """
+    if not path_value:
+        return ""
+
+    parsed = urlparse(path_value)
+    if parsed.scheme in {"http", "https", "data"}:
+        return path_value
+
+    if parsed.scheme == "file":
+        source_path = Path(parsed.path)
+    else:
+        source_path = Path(path_value).expanduser()
+
+    if not source_path.is_absolute():
+        source_path = (project_root / source_path).resolve()
+    else:
+        source_path = source_path.resolve()
+
+    if not source_path.exists():
+        return path_value
+
+    assets_dir = output_dir / "assets" / subdir
+    assets_dir.mkdir(parents=True, exist_ok=True)
+
+    digest = hashlib.sha1(str(source_path).encode("utf-8")).hexdigest()[:8]
+    safe_prefix = prefix or "asset"
+    dest_name = f"{safe_prefix}_{digest}_{source_path.name}"
+    dest_path = assets_dir / dest_name
+
+    if not dest_path.exists():
+        shutil.copy2(source_path, dest_path)
+
+    rel_path = dest_path.relative_to(output_dir).as_posix()
+    return quote(rel_path)
diff --git a/pyproject.toml b/pyproject.toml
@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "microlens-submit"
-version = "0.16.4"
+version = "0.16.5"
 authors = [
   { name="Amber Malpas", email="malpas.1@osu.edu" },
   {name = "Roman Science Platform Team", email = "roman-science-platform@stsci.edu"}
diff --git a/scripts/bump_version.py b/scripts/bump_version.py
diff --git a/setup.py b/setup.py
