Skip to content

docs: update What's New (2026-04-08)#230

Closed
edspencer wants to merge 10 commits intomainfrom
changelog/auto-update-2026-04-08
Closed

docs: update What's New (2026-04-08)#230
edspencer wants to merge 10 commits intomainfrom
changelog/auto-update-2026-04-08

Conversation

@edspencer
Copy link
Copy Markdown
Owner

@edspencer edspencer commented Apr 8, 2026

Summary

Details

The only user-facing change in this batch was the Windows path separator fix in @herdctl/core@5.10.1. This fixed path traversal security validation that was incorrectly failing on Windows systems due to hardcoded forward slashes in the check logic.

Other commits were housekeeping, audit state updates, or the version packages commit itself.

Test plan

  • Entry follows existing format and style
  • Date is correct (2026-03-17 for the actual fix, formatted properly)
  • Version numbers match package CHANGELOGs
  • PR link is included
  • State file updated correctly

🤖 Generated with Claude Code

Summary by CodeRabbit

  • Bug Fixes
    • Fixed Windows path traversal validation that was incorrectly rejecting valid operations due to platform-specific path separator handling.

edspencer and others added 10 commits April 2, 2026 05:00
Analyzed 8 commits since last check (1114870..1c3f5db):
- 4 housekeeping commits (agent state updates)
- 2 documentation commits (already addressed gaps)
- 1 version bump commit
- 1 bug fix commit (Windows path.sep fix)

No documentation gaps found. The Windows compatibility fix in commit
31c675c is an internal implementation detail that doesn't require
user-facing documentation updates.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Analyzed 2 commits since last check (1c3f5db..8818ab1):
- 1 documentation audit state update (ce7d60e)
- 1 engineer agent housekeeping commit (8818ab1)

No documentation gaps found. Both commits are internal maintenance
(agent state updates) and don't require user-facing documentation changes.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Add entry for Windows path separator fix (PR #210) that corrects
path traversal validation to use platform-specific separators.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Track completion of What's New update for 2026-04-08.
Analyzed 12 commits, added 1 entry (Windows path fix).

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown
Contributor

coderabbitai bot commented Apr 8, 2026

📝 Walkthrough

Walkthrough

Automated state file updates across multiple agent systems and documentation, including changelog and documentation audit metadata updates, engineer housekeeping activity logs, and a new Windows path separator fix release note.

Changes

Cohort / File(s) Summary
Agent State Updates
agents/changelog/state.md, agents/docs/state.md, agents/engineer/state.md
Updated frontmatter metadata including last_checked_commit, last_run, and last_active timestamps; updated "Current Position" and "Run History" tables with new run entries and status information.
Engineer Activity Log
agents/engineer/conversations.md
Added daily housekeeping entries for dates 2026-04-02 through 2026-04-07 documenting state file maintenance and token counts; increased token_estimate frontmatter from 2000 to 2600.
Release Notes
docs/src/content/docs/whats-new.md
Added release note entry for March 17, 2026, documenting Windows path separator validation fix in @herdctl/core@5.10.1 and herdctl@1.5.8 that corrects hardcoded forward slash path checks to use platform-specific separators.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

Poem

🐰 Hop along the timeline we go,
State files sprouting row by row,
Windows paths now traverse just right,
Housekeeping logs keep things tight!
Timestamps dancing, entries grow,
The maintenance burrow steals the show!

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title 'docs: update What's New (2026-04-08)' accurately reflects the main change: updating documentation with a new release notes entry. However, it is generic and does not specify what was actually added (Windows path separator fix).
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch changelog/auto-update-2026-04-08

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 and usage tips.

@cloudflare-workers-and-pages
Copy link
Copy Markdown

Deploying herdctl with  Cloudflare Pages  Cloudflare Pages

Latest commit: c2796e1
Status: ✅  Deploy successful!
Preview URL: https://edb503bc.herdctl.pages.dev
Branch Preview URL: https://changelog-auto-update-2026-0-n15t.herdctl.pages.dev

View logs

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@agents/changelog/state.md`:
- Around line 2-5: The page-level "Last Updated" timestamp in the changelog page
header is out of sync with the state file's last_run value; update the header's
Last Updated timestamp to exactly match last_run ("2026-04-08T00:00:00Z") so the
document header and agents/changelog/state.md last_run are consistent, and apply
the same correction wherever the old timestamp appears (e.g., other header
occurrences referenced by "Last Updated").

In `@docs/src/content/docs/whats-new.md`:
- Line 10: The new section heading "Windows Path Separator Fix" uses ### without
a parent ## which triggers markdownlint MD001; fix by making this heading one
level higher (change "### Windows Path Separator Fix" to "## Windows Path
Separator Fix") or add an appropriate parent "##" section above it so the
heading hierarchy is valid for markdownlint MD001.
🪄 Autofix (Beta)

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

Run ID: 159ab710-2bcb-4d60-8956-93c84d6b5560

📥 Commits

Reviewing files that changed from the base of the PR and between 3662d18 and c2796e1.

📒 Files selected for processing (5)
  • agents/changelog/state.md
  • agents/docs/state.md
  • agents/engineer/conversations.md
  • agents/engineer/state.md
  • docs/src/content/docs/whats-new.md

Comment thread agents/changelog/state.md
Comment on lines +2 to +5
last_checked_commit: 1e472a2
last_run: "2026-04-08T00:00:00Z"
entries_added: 1
branches_created: ["docs/changelog-update-2026-02-22", "docs/changelog-update-2026-02-23-manual", "changelog/auto-update-2026-02-25", "changelog/auto-update-2026-02-26", "changelog/auto-update-2026-03-01", "changelog/auto-update-2026-03-06", "changelog/auto-update-2026-03-13", "changelog/auto-update-2026-04-08"]
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Update the page-level “Last Updated” timestamp to match the new run metadata.
last_run is 2026-04-08T00:00:00Z, but the document header still shows 2026-02-25T04:05:06Z, which makes the state file internally inconsistent.

🛠 Proposed fix
-**Last Updated:** 2026-02-25T04:05:06Z
+**Last Updated:** 2026-04-08T00:00:00Z

Also applies to: 22-25

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@agents/changelog/state.md` around lines 2 - 5, The page-level "Last Updated"
timestamp in the changelog page header is out of sync with the state file's
last_run value; update the header's Last Updated timestamp to exactly match
last_run ("2026-04-08T00:00:00Z") so the document header and
agents/changelog/state.md last_run are consistent, and apply the same correction
wherever the old timestamp appears (e.g., other header occurrences referenced by
"Last Updated").


---

### Windows Path Separator Fix
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor

Fix heading-level increment for the new section (markdownlint MD001).
This new ### heading is introduced without a preceding ## section, which triggers the configured lint rule.

🛠 Proposed fix
 ---
+## 2026
+
 ### Windows Path Separator Fix
 **March 17, 2026** · `@herdctl/core@5.10.1` · `herdctl@1.5.8`
📝 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
### Windows Path Separator Fix
---
## 2026
### Windows Path Separator Fix
**March 17, 2026** · `@herdctl/core@5.10.1` · `herdctl@1.5.8`
🧰 Tools
🪛 markdownlint-cli2 (0.22.0)

[warning] 10-10: Heading levels should only increment by one level at a time
Expected: h2; Actual: h3

(MD001, heading-increment)

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In `@docs/src/content/docs/whats-new.md` at line 10, The new section heading
"Windows Path Separator Fix" uses ### without a parent ## which triggers
markdownlint MD001; fix by making this heading one level higher (change "###
Windows Path Separator Fix" to "## Windows Path Separator Fix") or add an
appropriate parent "##" section above it so the heading hierarchy is valid for
markdownlint MD001.

@edspencer edspencer closed this Apr 12, 2026
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