Skip to content

0.38

Latest

Choose a tag to compare

@karero karero released this 20 Nov 22:20
Immutable release. Only release title and notes can be modified.
8e3c002

Croftweaver 0.38 — checks you can trust 🩺

As always: your favorite AI assistant takes you by the hand. Just ask it, in your own words, and it does the work.

What's new:

  • 🔗 New pages arrive linked and ready for AI answers. Once your assistant has built a new page, it checks two things before the code review. Can an AI answer find and quote the page? And is the page linked properly: at least two pages point to it, one from its text; it links back to its section's main page; and it sits at most three clicks from your home page. What it finds, it fixes in the same change. The page brief has a new Links field, so you approve which pages will link to the new one, and the sentence each gets.
  • 📝 The check of your approved words reads whole sentences. When your assistant compares a new page with the text you approved, a link with a small icon or a hidden "(opens in a new tab)" note no longer cuts a sentence into false changes.
  • 🩺 Tests that say what's wrong. If your site isn't built yet, or its address is missing, npm test tells you so in one line, instead of failing somewhere else.
  • 🔗 A link check that stays on your side. It no longer lists your 404 page as a lost page, stops with a clear message when the build failed, and understands more of the ways a page links to a spot further down. Pages you leave unlinked on purpose, such as an ad's landing page, now go in a plain list, orphan-exempt.txt, one address per line.
  • 🖼️ The Astro logo can't sneak back into your tab. The build spots Astro's icon even after an optimizer has rewritten it, and no longer stops your own icon just because a comment in it mentions Astro.
  • 🚀 Publishing reads your settings right. npm run ship checks the address your site really uses, says which settings file it read, and tells you plainly what happens if GitHub refuses the push.

Recently added:

  • 🧭 A simple signpost for Anthropic's plugin directory. What Croftweaver offers the directory is one short page with no code: what Croftweaver is, and the install commands to type yourself.
  • 🚀 Your first launch on Cloudflare goes the right way round. Your assistant walks you through Cloudflare's import, has you choose your live branch, and connects your domain only after that.
  • 🔄 Publishing offers to try again. If your live site still shows the old version a few minutes after you publish, npm run ship asks once whether to ship again.
  • 📝 Every new page gets judged before it's built. Your assistant writes the page out first, a fresh reviewer reads it as your visitor would, and you approve the exact sentences.
  • ☁️ Publish straight from your computer. New sites start on Cloudflare Workers, with no GitHub connection needed.

New here? How to start: download croftweaver.zip below, unzip it, and paste the starter prompt from the README into your AI assistant. It takes you by the hand from there. Works on macOS, Linux, WSL, and Git Bash on Windows. To check the download, put SHA256SUMS beside it and follow the README's two-line check.

Already have a site?

  • 💬 Ask your assistant: "check if my site needs any updates from the latest Croftweaver version". Go through what it suggests together: nothing changes on its own. It now skips the test files you chose to leave out.
  • 🚀 Taking the new publishing script? Take scripts/ship.sh together with tests/check_ship_push.sh, and scripts/deploy.sh together with tests/check_deploy.sh: each pair must match.
  • 🔗 Left a page unlinked on purpose? If you added any to ORPHAN_EXEMPT in tests/orphans.spec.ts, write each address on its own line of a new orphan-exempt.txt first; if you added none, you need no file. Then take tests/orphans.spec.ts, scripts/orphan-exempt.mjs and scripts/check_internal_links.sh together, never one without the others.
  • 📝 Gave the page-text check your own --skip list? Your list replaces the default, so add .vh,.sr-only,.visually-hidden to it, or the hidden notes come back as false changes.
  • 🔒 Update Node.js on your computer. Run node --version: if it's older than 22.23.5, 24.22.3 or 26.13.1 (for your line), update it.
  • 🖼️ Skipped 0.37? Check your tab icon first. Open https://<your address>/favicon.svg and https://<your address>/favicon.ico. If either shows the Astro logo, replace it before your next build: run node scripts/make-icons.mjs --setup, or ask your assistant to use the brand-kit skill.
  • 📚 Moving a site, or want every detail? The 0.37, 0.36 and 0.35 notes list each part and setting, and the move guide covers moving to Workers.

For the technically curious, 0.38
  • npm run ship reads only the site: key of astro.config.mjs (not website:, subsite:, a site: inside a string or after a comment); the "no domain yet" message names the Workers config it read; the ship-again offer says a protected main refuses its push too; PUBLISHING.md says when ship keeps SHIP-AGAIN.txt — PR #610.
  • Starter: the favicon guard knows Astro's icon after svgo and ignores a mention in comments or metadata, and gives its make-icons advice only where the script exists; npm test explains a missing dist/ or a SITE.url that is not an address; the cloud-browser fallback needs a headless shell; check_internal_links.sh skips /404; check_external_links.sh stops on a failed build and reads &amp;; the anchor and navigation tests read single-quoted ids, encoded fragments and page-relative links; AGENTS.md §2 names the one commit ship pushes on "Ship again?" — PR #611.
  • whats-new: a site with a tests stamp and an unstamped skills folder is told the skills were not compared and how to stamp them; files the site lists as left_out: or kept: are no longer reported missing — PR #612.
  • Maintainer tooling: publish_directory.sh --compare ignores only the root version of plugin.json, and the directory checker requires plugin.json to be one JSON object — PR #614; version 0.38.0 — PR #615.
  • Starter: the icon test refuses a SITE.url with no host, such as localhost:4321 — PR #616. The link checks, ship.sh (now 0.36) and deploy.sh read the host from the site: key only, the same way in every locale — PR #617. The unlinked-pages list moved from ORPHAN_EXEMPT in tests/orphans.spec.ts to orphan-exempt.txt, read by scripts/orphan-exempt.mjs; the link check warns when a site still has the old list — PR #620.
  • Maintainer tooling: the leak scans read only the files git knows, one timing-sensitive test group runs on its own, and the Antigravity release test gains a deny-rule warning — PR #618.
  • website-new-page's page-text check no longer splits a sentence at a skipped inline element, and keeps an inline svg in its sentence — PR #621; it skips nav,footer,aside,.vh,.sr-only,.visually-hidden by default, and a --skip replaces that list — PR #624.
  • website-new-page gains a step 8 before the code review: ai-seo's Step 3 extractability table and Step 4 bot check on the built page, then internal-link-audit's new scripts/check_page_links.py (two or more linking pages, one from a page body; hub and back link; at most three clicks from home; Python only, no network). The page brief gains a Links field — PR #622.