🚧 start to explore adding subsections to homesection

[enryH]

• probably best to assume that a single section with with no-subsection is a valid homepage
• maybe try to explore if setting a title should lead to a different behaviour

[sayalaruano]

I tested it with the apicall and chatbot cong files and it works as expected.

I also tested the HTML and revelajs formats using the basic case study config example, and there are some problems. If we define subsections in the first section, they are omitted, maybe bc on the quarto-based reports we are still reserving the first section for the components without a subsection. We should try to test it further and fix the quarto_report.py file to follow the same structure as the streamlit one.

[enryH]

In the basic example an empty home-section is created, I will have to double check if this intended

[enryH]

I tested it with the apicall and chatbot cong files and it works as expected.

I also tested the HTML and revelajs formats using the basic case study config example, and there are some problems. If we define subsections in the first section, they are omitted, maybe bc on the quarto-based reports we are still reserving the first section for the components without a subsection. We should try to test it further and fix the quarto_report.py file to follow the same structure as the streamlit one.

I added the test for html using the specified configuration file basic case study config example. I will add the streamlit-based one once we fix the setting of relative paths in streamlit (which I will do on a separate PR). but otherwise it should work.

• I get locally some error with showing .svg from GitHub, but png work from url sources.

[Copilot]

Pull Request Overview

This PR explores adding subsections to the home section and refactors report generation logic for both Streamlit and Quarto outputs, updates the CI workflow to validate protected example outputs, and regenerates test example files for multiple report formats.

• Refactor homepage generation in Streamlit and Quarto views to treat the main section uniformly
• Enhance config_manager to include main-directory components and skip empty description files
• Add CI checks in .github/workflows/cdci.yml to prevent unintended changes in example reports

Reviewed Changes

Copilot reviewed 13 out of 13 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
src/vuegen/streamlit_reportview.py	Refactored homepage generation and section-loop logic
src/vuegen/quarto_reportview.py	Removed main-section overview block and simplified section loops
src/vuegen/config_manager.py	Treat main directory as a section, skip description.md files
.github/workflows/cdci.yml	Added CI jobs to protect generated report examples
tests/report_examples/Basic_example_vuegen_demo_notebook_*/	Regenerated example QMD files for all formats

Comments suppressed due to low confidence (4)

src/vuegen/quarto_reportview.py:131

• Remove or resolve this leftover question/comment and the large commented-out block to improve code clarity.

                    self._generate_image_content(self.report.graphical_abstract)

src/vuegen/streamlit_reportview.py:158

• Remove this stray TODO comment; production code shouldn't include implementation notes.

            # ! move this into the _generate_home_section method

src/vuegen/streamlit_reportview.py:159

• This assignment is immediately overwritten and never used—consider removing it.

            subsection_page_vars = []

src/vuegen/config_manager.py:347

• Remove this debug print statement to avoid logging to stdout in library code.

                print(f"Found file in main section directory: {section_dir.name}")