Skip to content

muthuishere/toolnexus / .claude/skills/release

release

Flagged

Cut and verify a toolnexus release across all eight registries, with the guardrails that a green CI run does not give you. Use whenever the user says publish, release, ship it, cut a release, bump the version, or asks whether a release actually landed. Also use to re-publish a single failed registry leg.

FileKindSize
SKILL.mdskill md8.9 KB
scripts/check-release-readiness.shexecutablescript8.1 KB

scripts/check-release-readiness.sh

View on GitHub
#!/usr/bin/env bash
# Release readiness gate for toolnexus. Read-only: it never publishes, tags, or edits.
#
# Replicates release.yml's `preflight` manifest check LOCALLY, and adds the check
# preflight does NOT have — that the versioned install coordinates in the docs match
# the version being released. That gap shipped 0.14.0 with Java/Clojure install
# snippets two minor versions behind.
#
# Usage:  ./check-release-readiness.sh 0.15.0
# Exit:   0 = ready, 1 = blocked (reasons printed)

set -uo pipefail
V="${1:-}"
[ -z "$V" ] && { echo "usage: $0 <version>   e.g. $0 0.15.0"; exit 2; }
cd "$(git rev-parse --show-toplevel)" || exit 2

fail=0
note() { printf '  %s\n' "$1"; }
bad()  { printf '  ✗ %s\n' "$1"; fail=1; }
ok()   { printf '  ✓ %s\n' "$1"; }

echo "== 1. Manifest parity (same check release.yml preflight runs) =="
JS=$(node -p "require('./js/package.json').version" 2>/dev/null)
PY=$(grep -E '^version' python/pyproject.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
CS=$(grep -oE '<Version>[^<]+</Version>' csharp/src/Toolnexus/Toolnexus.csproj | head -1 | sed -E 's/<\/?Version>//g')
JAVA=$(grep -E "^version" java/build.gradle | head -1 | sed -E "s/.*'([^']+)'.*/\1/")
EX=$(grep -E '@version "' elixir/mix.exs | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
CLJ=$(grep -E '^\(def version ' clojure/build.clj | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
RS=$(grep -E '^version' rust/Cargo.toml | head -1 | sed -E 's/.*"([^"]+)".*/\1/')
for pair in "js:$JS" "python:$PY" "csharp:$CS" "java:$JAVA" "elixir:$EX" "clojure:$CLJ" "rust:$RS"; do
  n="${pair%%:*}"; v="${pair#*:}"
  [ "$v" = "$V" ] && ok "$n = $v" || bad "$n = ${v:-<unreadable>}, expected $V"
done
note "(golang has no manifest — it releases as the tag golang/v$V)"

echo
echo "== 2. Docs install coordinates (preflight does NOT check these) =="
# Exact coordinate forms only — a broad version grep matches unrelated things like
# serverInfo `version: "0.1.0"` defaults. Historical prose ("since v0.13.0",
# "as of 0.12.0", "Versions measured") is intentionally NOT checked: rewriting it
# would falsify the record.
MINOR="${V%.*}"                      # 0.14.0 -> 0.14, for the elixir `~>` form
DOCS=$(git ls-files '*.md' '*.mdx' '*.edn' | grep -vE "^(CHANGELOG|docs/adr/|docs/spikes/|openspec/)")
stale=""
for f in $DOCS; do
  # a) elixir:   {:toolnexus, "~> 0.14"}
  while IFS= read -r hit; do
    echo "$hit" | grep -q '<version>' && continue      # PUBLISHING.md templates
    echo "$hit" | grep -q "~> $MINOR\"" || stale="$stale\n  $f: $hit"
  done < <(grep -n '{:toolnexus, "~>' "$f" 2>/dev/null)
  # b) maven:    io.github.muthuishere:toolnexus:0.14.0
  while IFS= read -r hit; do
    echo "$hit" | grep -q ":toolnexus:$V" || stale="$stale\n  $f: $hit"
  done < <(grep -n 'io\.github\.muthuishere:toolnexus:[0-9]' "$f" 2>/dev/null)
  # c) clojars, BOTH spellings — deps.edn leaves the artifact bare, cljgo's
  #    build.cljgo quotes it: (dep b "net.clojars.muthuishere/toolnexus" {...}).
  #    Matching only the bare form let a cljgo-ex1 coordinate sit at 0.13.0 for
  #    two releases, which is precisely what this section exists to prevent.
  while IFS= read -r hit; do
    echo "$hit" | grep -q '"<version>"' && continue    # PUBLISHING.md templates
    echo "$hit" | grep -q "\"$V\"" || stale="$stale\n  $f: $hit"
  done < <(grep -n 'muthuishere/toolnexus" \?{:mvn/version\|muthuishere/toolnexus {:mvn/version' "$f" 2>/dev/null)
  # e) crates:   toolnexus = "0.24.0"  (Cargo.toml dependency line)
  while IFS= read -r hit; do
    echo "$hit" | grep -q '"<version>"' && continue
    echo "$hit" | grep -qE "\"(\\^)?($V|$MINOR)\"" || stale="$stale\n  $f: $hit"
  done < <(grep -nE '^\s*toolnexus = "[0-9^]' "$f" 2>/dev/null)
  # d) maven xml: <version>..</version> in a file that installs the java artifact
  if grep -q 'artifactId>toolnexus<' "$f" 2>/dev/null; then
    while IFS= read -r hit; do
      echo "$hit" | grep -q ">$V<" || stale="$stale\n  $f: $hit"
    done < <(grep -n '<version>[0-9]' "$f" 2>/dev/null)
  fi
done
if [ -n "$stale" ]; then
  bad "install coordinates not at $V:"; printf "$stale\n" | sed 's/^/    /'
else
  ok "every live install coordinate reads $V (maven, clojars, elixir ~> $MINOR)"
fi

echo
echo "== 3. CHANGELOG =="
if grep -qE "^## $V — [0-9]{4}-[0-9]{2}-[0-9]{2}$" CHANGELOG.md; then
  ok "has a dated '## $V' section"
else
  bad "no '## $V — YYYY-MM-DD' section (roll '## Unreleased' down and add a fresh empty one above)"
fi
grep -qE "^## Unreleased" CHANGELOG.md && ok "'## Unreleased' still present for the next cycle" \
  || bad "no '## Unreleased' heading left at the top"

echo
echo "== 4. Git state =="
BR=$(git rev-parse --abbrev-ref HEAD)
[ -z "$(git status --porcelain --untracked-files=no)" ] && ok "working tree clean" || bad "uncommitted changes — commit or stash before releasing"
if [ "$BR" = "main" ]; then
  git fetch -q origin main 2>/dev/null
  [ "$(git rev-list --count origin/main..HEAD)" = "0" ] && ok "on main, in sync with origin" \
    || bad "on main but ahead of origin — push first; never release unmerged code"
else
  bad "on '$BR', not main — the release must be cut from merged code"
fi
git ls-remote --tags origin 2>/dev/null | grep -q "refs/tags/v$V$" \
  && bad "tag v$V ALREADY EXISTS — a version can never be reused on any registry" \
  || ok "tag v$V is free"

echo
echo "== 5. Publish gates (a leg that is off is skipped SILENTLY) =="
if command -v gh >/dev/null 2>&1; then
  for v in ENABLE_NPM ENABLE_PYPI ENABLE_GO ENABLE_NUGET ENABLE_JAVA ENABLE_ELIXIR ENABLE_CLOJARS ENABLE_CRATES; do
    val=$(gh variable list 2>/dev/null | awk -v k="$v" '$1==k{print $2}')
    [ "$val" = "true" ] && ok "$v=true" || note "  ! $v=${val:-unset} — this registry will NOT publish"
  done
else
  note "gh not available — check the ENABLE_* variables by hand"
fi

echo
echo "== 6. Licensing =="
missing=""
for d in js python golang java csharp elixir clojure; do
  [ -f "$d/LICENSE" ] || missing="$missing $d"
done
[ -z "$missing" ] && ok "every port carries a LICENSE" || bad "no LICENSE in:$missing"
[ -f THIRD-PARTY-NOTICES.md ] && ok "THIRD-PARTY-NOTICES.md present" || bad "THIRD-PARTY-NOTICES.md missing"

# The real drift risk: a dependency was added and never listed in the notices.
# Name-presence only — verifying the LICENSE of each pinned version needs a
# per-ecosystem resolver, which this gate deliberately does not attempt.
if [ -f THIRD-PARTY-NOTICES.md ]; then
  undoc=""
  add() { grep -q -- "$1" THIRD-PARTY-NOTICES.md || undoc="$undoc\n    $2: $1"; }
  for dep in $(node -p "Object.keys(require('./js/package.json').dependencies||{}).join('\n')" 2>/dev/null); do add "$dep" js; done
  for dep in $(sed -n '/^dependencies = \[/,/^\]/p' python/pyproject.toml | grep -oE '"[a-zA-Z0-9_.-]+' | tr -d '"' | grep -v '^dependencies$'); do add "$dep" python; done
  for dep in $(grep -oE '^\t[a-z0-9./-]+\.[a-z]+/[^ ]+' golang/go.mod | tr -d '\t'); do add "$dep" golang; done
  # shipped configurations only — testImplementation/testRuntimeOnly are not distributed
  for dep in $(grep -E "^\s+(api|implementation|compileOnly|runtimeOnly) " java/build.gradle \
               | grep -oE "'[a-z0-9.]+:[a-z0-9.-]+:[0-9]" | sed -E "s/'([^:]+:[^:]+):.*/\1/"); do add "$dep" java; done
  for dep in $(grep -oE 'PackageReference Include="[^"]+"' csharp/src/Toolnexus/Toolnexus.csproj | sed 's/.*="//;s/"//'); do add "$dep" csharp; done
  for dep in $(sed -n '/defp deps do/,/^  end/p' elixir/mix.exs | grep -oE '\{:[a-z_]+' | tr -d '{:' | grep -vE '^(excoveralls|ex_doc)$'); do add "$dep" elixir; done
  for dep in $(grep -oE '^\s+[a-z0-9./]+/[a-z0-9.-]+ \{:mvn' clojure/deps.edn | awk '{print $1}'); do add "$dep" clojure; done
  if [ -n "$undoc" ]; then
    bad "declared dependencies absent from THIRD-PARTY-NOTICES.md:"; printf "$undoc\n"
  else
    ok "every declared dependency appears in THIRD-PARTY-NOTICES.md"
  fi
fi
grep -q 'LICENSE' elixir/mix.exs && ok "elixir Hex package ships LICENSE" \
  || bad "elixir mix.exs \`files:\` omits LICENSE — Hex consumers get no license text"

echo
if [ "$fail" = "0" ]; then
  echo "READY for $V. Cutting the release is still an owner decision."
else
  echo "BLOCKED — fix the ✗ items above."
fi
exit $fail
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall