Skip to content

fix(installation): correct raw source URLs - #836

Merged
ss-o merged 3 commits into
mainfrom
hotfix-833
Aug 14, 2026
Merged

fix(installation): correct raw source URLs#836
ss-o merged 3 commits into
mainfrom
hotfix-833

Conversation

@ss-o

@ss-o ss-o commented Aug 14, 2026

Copy link
Copy Markdown
Member

Summary

Repair three broken production documentation links after z-shell/src moved public installer artifacts from lib/ to public/:

  • checksum: public/checksum.txt
  • installer: public/sh/install.sh
  • loader: public/zsh/init.zsh

Also make the custom Lychee integration emit structured Trunk issues from Lychee 0.23 JSON. This preserves link enforcement while allowing Trunk’s intended pull-request baseline comparison to recognize that the hotfix removes the three base findings instead of treating Lychee exit code 2 as a tool crash. The adapter handles Trunk’s sandbox symlink invocation and has regression coverage.

Validation

  • each new raw URL returns HTTP 200
  • pnpm validate:frontmatter docs/getting_started/01_installation.mdx
  • pnpm build:en
  • pnpm lint
  • node --test scripts/trunk-lychee.test.mjs
  • pnpm exec trunk check --upstream origin/main --no-fix
  • direct wrapper fixture confirms a 404 becomes a structured exit-1 Trunk issue
  • git diff --check

This is a production-link hotfix and unblocks the normal nextmain promotion in #833.

Point installer, loader, and checksum references at the live public paths in z-shell/src.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Copilot AI lite review requested due to automatic review settings August 14, 2026 14:22
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 14, 2026

Copy link
Copy Markdown

Deploying zsh with  Cloudflare Pages  Cloudflare Pages

Latest commit: 7811956
Status: ✅  Deploy successful!
Preview URL: https://fdf9796b.zsh.pages.dev
Branch Preview URL: https://hotfix-833.zsh.pages.dev

View logs

Copilot AI left a comment

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.

Pull request overview

Updates the installation documentation to point at the correct GitHub raw URLs after z-shell/src moved public installer artifacts from lib/ to public/, restoring broken production links and unblocking the nextmain promotion workflow.

Changes:

  • Update the installer raw URL to public/sh/install.sh.
  • Update the loader raw URL to public/zsh/init.zsh.
  • Update the checksum reference to public/checksum.txt.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@ss-o

ss-o commented Aug 14, 2026

Copy link
Copy Markdown
Member Author

Blocked by the required Trunk baseline comparison, not by the hotfix content.

Evidence:

  • hotfix head 926669d312fa12fa761880ae81dc4d00a88bd769 changes all three links to public/...
  • each new raw URL returns HTTP 200
  • frontmatter validation, English build, local Trunk checks, Cloudflare preview, CodeQL, and the main-source guard pass
  • required Trunk Check and Trunk Code Quality fail while Lychee evaluates unchanged base main, where the old lib/checksum.txt, lib/sh/install.sh, and lib/zsh/init.zsh URLs return 404
  • failed runs: https://github.com/z-shell/wiki/runs/94795620408 and https://github.com/z-shell/wiki/actions/runs/31809214413

No merge was attempted. I am not adding a temporary ignore, weakening the checker, or using an administrator/API bypass. A normal merge requires either a Trunk baseline-comparison fix or restoration of the old URLs by z-shell/src.

ss-o and others added 2 commits August 14, 2026 15:43
Convert Lychee JSON failures into Trunk issues so pull-request baseline comparison can distinguish fixed links from tool crashes without suppressing link validation. Canonicalize sandbox symlinks and cover them in tests.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Keep Lychee pinned as the Trunk tool while allowing the adapter to invoke the runner-provided Node runtime in isolated linter sandboxes.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@ss-o
ss-o merged commit b63ea8e into main Aug 14, 2026
8 checks passed
@ss-o
ss-o deleted the hotfix-833 branch August 15, 2026 12:36
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.

2 participants