no-mistakes(document): Updated CLAUDE.md pre-release reference; fixed shellcheck warnings

Author: dmealing

CLAUDE.md

@@ -565,7 +565,7 @@ PRs welcome. When contributing:
 
 For significant new features or architectural changes, open an issue first to discuss the approach.
 
-**Publishing to npm:** see [docs/RELEASING.md](docs/RELEASING.md) — the procedure (RC → smoke-test → promote) plus the non-obvious gotchas (publish with `bun`, regen the lockfile after every version bump, runtime imports must be `dependencies`, verify a real external install in npm *and* pnpm).
+**Publishing:** To iterate an unreleased change against a downstream project, use [docs/features/prerelease.md](docs/features/prerelease.md) — publish to the private registry (`bun run prerelease`), consume it, iterate, and revert with one verified command. For full public releases, see [docs/RELEASING.md](docs/RELEASING.md) — the procedure (RC → smoke-test → promote) plus the non-obvious gotchas (publish with `bun`, regen the lockfile after every version bump, runtime imports must be `dependencies`, verify a real external install in npm *and* pnpm).
 
 ## Roadmap pointer
 

tools/prerelease/bootstrap.sh

@@ -44,7 +44,10 @@ fi
 
 echo "waiting for $HOST ..."
 for _ in $(seq 1 60); do
-  curl -fsS -o /dev/null "$HOST/" && break || sleep 1
+  if curl -fsS -o /dev/null "$HOST/"; then
+    break
+  fi
+  sleep 1
 done
 
 if ! curl -fsS -o /dev/null -u "$OWNER:$PASS" "$HOST/api/v1/user" 2>/dev/null; then

tools/prerelease/detect-prerelease-pins.sh

@@ -42,6 +42,7 @@ NS_RE='@metaobjectsdev/|com\.metaobjects|(^|[^A-Za-z])MetaObjects(\.|"|<|$)|(^|[
 # publisher's config. MO_REGISTRY_BASE overrides it for a different registry.
 DEFAULT_REGISTRY_HOST='gitea.mealing.com'
 CFG="$(cd "$(dirname "$0")" && pwd)/registry.env"
+# shellcheck source=/dev/null
 [ -f "$CFG" ] && . "$CFG"
 REGISTRY_HOST="$DEFAULT_REGISTRY_HOST"
 if [ -n "${MO_REGISTRY_BASE:-}" ]; then
@@ -114,6 +115,7 @@ scan() {  # scan <label> <grep-args...>
   out=$(grep -rInE --binary-files=without-match "${MANIFESTS[@]}" "${EXCLUDES[@]}" "$@" "$ROOT" 2>/dev/null | head -20) || return 0
   [ -n "$out" ] || return 0
   hit "$label"
+  # shellcheck disable=SC2001
   echo "$out" | sed 's/^/      /' >&2
 }
 
@@ -147,6 +149,7 @@ while IFS= read -r f; do
   ' "$f")
   if [ -n "$bad" ]; then
     hit "vendor dependency pinned to a pre-release version"
+    # shellcheck disable=SC2001
     echo "$bad" | sed "s|^|      $f:|" >&2
   fi
 done < <(grep -rIlE --binary-files=without-match "${LOCKFILES[@]}" "${EXCLUDES[@]}" \
@@ -168,6 +171,7 @@ while IFS= read -r pom; do
   ' "$pom")
   if [ -n "$bad" ]; then
     hit "pom pins a pre-release version (dependency or version property)"
+    # shellcheck disable=SC2001
     echo "$bad" | sed "s|^|      $pom:|" >&2
   fi
 done < <(grep -rIl --exclude-dir=.git --include=pom.xml 'com\.metaobjects' "$ROOT" 2>/dev/null)

tools/prerelease/prerelease-link.sh

@@ -69,6 +69,7 @@ die()  { printf '\033[31m✗ %s\033[0m\n' "$*" >&2; exit 1; }
 #
 #     MO_REGISTRY_OWNER=<owner> tools/prerelease/prerelease-link.sh link --version <ver>
 DEFAULT_REGISTRY='https://gitea.mealing.com'
+# shellcheck source=/dev/null
 [ -f "$HERE/registry.env" ] && . "$HERE/registry.env"
 BASE="${MO_REGISTRY_BASE:-$DEFAULT_REGISTRY}"; OWNER="${MO_REGISTRY_OWNER:-}"; TOKEN="${MO_REGISTRY_TOKEN:-}"
 BASE="${BASE%/}"