Skip to content

docs(changelog): prepare v0.3.7 release - #89

Merged
xusd320 merged 1 commit into
mainfrom
xusd320/release-v0.3.7
Aug 10, 2026
Merged

docs(changelog): prepare v0.3.7 release#89
xusd320 merged 1 commit into
mainfrom
xusd320/release-v0.3.7

Conversation

@xusd320

@xusd320 xusd320 commented Aug 10, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Prepare the EVJS v0.3.7 stable release notes from the current main branch.
  • Cover the four changes merged after v0.3.6.

Changes

  • Add a dated v0.3.7 changelog section.
  • Document Utoopack multi-entry server builds and plugin-driven development shortcuts.
  • Document immutable development sessions and their recovery behavior.
  • Document canonical MPA .html Document URLs.

Validation

Risk / rollout

  • Documentation-only change; package versions and internal workspace dependency ranges remain managed by the release workflow.
  • Publishing GitHub Release v0.3.7 after merge will publish all public @evjs/* workspaces with the npm latest dist-tag.
  • No migration, configuration, dependency, auth, security, or privacy changes are introduced by this release-preparation commit.

Reviewer notes

Summary by CodeRabbit

  • Documentation
    • Added release notes for version 0.3.7.
    • Documented immutable bundler development sessions and multi-entry server builds.
    • Added notes on plugin-driven development shortcuts and canonical MPA document URLs.
    • Clarified the scope of existing breaking changes.

@coderabbitai

coderabbitai Bot commented Aug 10, 2026

Copy link
Copy Markdown

Review Change Stack

📝 Walkthrough

Walkthrough

The changelog now includes a dated 0.3.7 release entry. It documents one breaking change and three feature updates.

Changes

Release documentation

Layer / File(s) Summary
0.3.7 release notes
CHANGELOG.md
Adds the 0.3.7 heading, scopes the immutable bundler development session change under the release, and documents Utoopack multi-entry server builds, plugin-driven development shortcuts, and canonical MPA Document URLs.

Estimated code review effort: 1 (Trivial) | ~2 minutes

Possibly related PRs

  • afx-team/evjs#62: Both pull requests add and structure a versioned CHANGELOG.md release entry.
🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly identifies this documentation-only change as preparation for the v0.3.7 release.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch xusd320/release-v0.3.7

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CHANGELOG.md`:
- Around line 31-34: Update the “Canonical MPA Document URLs” changelog entry to
clarify that semantic routes are retained only as page-resolution metadata, not
as public MPA URLs; explicitly state that `.html` URLs are the canonical public
URLs.
🪄 Autofix

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: c764da99-c2af-4681-b07e-f4c3d1eb1e87

📥 Commits

Reviewing files that changed from the base of the PR and between 2be2c06 and 7d3144f.

📒 Files selected for processing (1)
  • CHANGELOG.md

Comment thread CHANGELOG.md
Comment on lines +31 to +34
- **Canonical MPA Document URLs** — MPA Pages now materialize as `index.html`,
`about.html`, and nested `foo/bar.html` Documents while retaining their
semantic routes. Development SSR and PPR requests use the same public URLs
and resolve back to their canonical Pages.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎯 Functional Correctness | 🟡 Minor | ⚡ Quick win

Clarify that semantic routes are not public MPA URLs.

The server test in packages/server/tests/app.test.ts:1104-1138 returns 200 for /index.html and /about.html, but returns 404 for / and /about. The phrase “while retaining their semantic routes” can imply that the non-.html URLs remain public.

State that semantic routes remain page-resolution metadata, while .html URLs are the canonical public MPA URLs.

Proposed wording
-- **Canonical MPA Document URLs** — MPA Pages now materialize as `index.html`,
-  `about.html`, and nested `foo/bar.html` Documents while retaining their
-  semantic routes. Development SSR and PPR requests use the same public URLs
-  and resolve back to their canonical Pages.
+- **Canonical MPA Document URLs** — MPA Pages now materialize as `index.html`,
+  `about.html`, and nested `foo/bar.html` Documents. Their semantic routes
+  remain available for page resolution, but the `.html` URLs are the canonical
+  public URLs for development SSR and PPR requests.

As per coding guidelines, documentation should prefer declarative current behavior.

📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
- **Canonical MPA Document URLs** — MPA Pages now materialize as `index.html`,
`about.html`, and nested `foo/bar.html` Documents while retaining their
semantic routes. Development SSR and PPR requests use the same public URLs
and resolve back to their canonical Pages.
- **Canonical MPA Document URLs** — MPA Pages now materialize as `index.html`,
`about.html`, and nested `foo/bar.html` Documents. Their semantic routes
remain available for page resolution, but the `.html` URLs are the canonical
public URLs for development SSR and PPR requests.
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CHANGELOG.md` around lines 31 - 34, Update the “Canonical MPA Document URLs”
changelog entry to clarify that semantic routes are retained only as
page-resolution metadata, not as public MPA URLs; explicitly state that `.html`
URLs are the canonical public URLs.

Source: Coding guidelines

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 7d3144f692

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread CHANGELOG.md
Comment on lines +31 to +34
- **Canonical MPA Document URLs** — MPA Pages now materialize as `index.html`,
`about.html`, and nested `foo/bar.html` Documents while retaining their
semantic routes. Development SSR and PPR requests use the same public URLs
and resolve back to their canonical Pages.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Mark the MPA URL replacement as breaking

Move this entry under Breaking Changes: applications upgrading from 0.3.6 that deploy, link to, or configure hosting around an MPA output such as report/index.html must migrate to report.html, and request-time semantic URLs such as /report also stop resolving. Classifying this replacement only as a feature hides a required deployment and URL migration from readers scanning the breaking-change section.

Useful? React with 👍 / 👎.

@xusd320
xusd320 merged commit 63f0c10 into main Aug 10, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant