@indigoai-us/hq-cli 5.77.13 → 5.78.0

package/assets/scaffold/core/scripts/rebuild-public-knowledge-index.sh

@@ -0,0 +1,83 @@
+#!/usr/bin/env bash
+# rebuild-public-knowledge-index.sh — regenerate core/knowledge/public/INDEX.md.
+#
+# Pure bash + jq. Lists each public-knowledge subdir with a file count.
+# Description: prefer the subdir's README.md first heading, else first
+# alphabetical .md file's first heading, else "{N} file(s)".
+
+set -euo pipefail
+
+HQ_ROOT="${HQ_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+cd "$HQ_ROOT"
+
+KNOWLEDGE_DIR="core/knowledge/public"
+OUT="${KNOWLEDGE_DIR}/INDEX.md"
+DATE=$(date -u +%Y-%m-%d)
+
+[[ -d "$KNOWLEDGE_DIR" ]] || { echo "rebuild-public-knowledge-index: ${KNOWLEDGE_DIR}/ missing, skipping" >&2; exit 0; }
+
+sanitize_cell() {
+  printf '%s' "$1" | tr '\n' ' ' | sed -e 's/|/\\|/g' -e 's/  */ /g' -e 's/^ *//' -e 's/ *$//'
+}
+trunc() {
+  local s="$1" n="$2"
+  if [[ ${#s} -le $n ]]; then printf '%s' "$s"; else printf '%s…' "${s:0:$((n-1))}"; fi
+}
+
+heading_of() {
+  awk '/^# / { sub(/^# +/, ""); print; exit }' "$1" 2>/dev/null || true
+}
+
+describe_subdir() {
+  local d="$1"
+  local n
+  n=$(find "$d" -mindepth 1 -maxdepth 1 -name '*.md' ! -name 'INDEX.md' 2>/dev/null | wc -l | tr -d ' ')
+  local readme="${d}/README.md"
+  local h=""
+  if [[ -f "$readme" ]]; then
+    h=$(heading_of "$readme")
+  fi
+  if [[ -z "$h" ]]; then
+    # First alphabetical .md file (excluding INDEX.md, README.md).
+    local first
+    first=$(find "$d" -mindepth 1 -maxdepth 1 -name '*.md' ! -name 'INDEX.md' ! -name 'README.md' 2>/dev/null | sort | head -1)
+    [[ -n "$first" ]] && h=$(heading_of "$first")
+  fi
+  if [[ -n "$h" ]]; then
+    echo "${h} (${n} file(s))"
+  else
+    echo "${n} file(s)"
+  fi
+}
+
+{
+  echo "# Public Knowledge"
+  echo ""
+  echo "> Auto-generated. Updated: ${DATE}"
+  echo ""
+  echo "| Name | Description |"
+  echo "|------|-------------|"
+  while IFS= read -r d; do
+    name=$(basename "$d")
+    [[ "$name" == .* ]] && continue
+    desc=$(describe_subdir "$d")
+    desc=$(sanitize_cell "$desc")
+    desc=$(trunc "$desc" 100)
+    printf '| `%s/` | %s |\n' "$name" "$desc"
+  done < <(find "$KNOWLEDGE_DIR" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+
+  # Loose top-level .md files
+  while IFS= read -r f; do
+    name=$(basename "$f")
+    [[ "$name" == "INDEX.md" ]] && continue
+    [[ "$name" == .* ]] && continue
+    desc=$(heading_of "$f")
+    [[ -z "$desc" ]] && desc="$name"
+    desc=$(sanitize_cell "$desc")
+    desc=$(trunc "$desc" 100)
+    printf '| `%s` | %s |\n' "$name" "$desc"
+  done < <(find "$KNOWLEDGE_DIR" -mindepth 1 -maxdepth 1 -type f -name '*.md' 2>/dev/null | sort)
+} > "$OUT"
+
+n=$(find "$KNOWLEDGE_DIR" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | wc -l | tr -d ' ')
+echo "rebuild-public-knowledge-index: wrote ${OUT} (${n} subdir(s))" >&2

package/assets/scaffold/core/scripts/rebuild-reports-index.sh

@@ -0,0 +1,114 @@
+#!/usr/bin/env bash
+# rebuild-reports-index.sh — regenerate workspace/reports/INDEX.md.
+#
+# Pure bash. Lists subdirs + individual report files. Skips the curated
+# "Report Series" section — that's manually maintained by the gardener.
+# Description: prefer first `#` heading for .md, <title> for .html.
+# Date: parse YYYY-MM-DD or YYYY-Www prefix from filename, else "—".
+
+set -euo pipefail
+
+HQ_ROOT="${HQ_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+cd "$HQ_ROOT"
+
+OUT="workspace/reports/INDEX.md"
+DATE=$(date -u +%Y-%m-%d)
+
+[[ -d workspace/reports ]] || { echo "rebuild-reports-index: workspace/reports/ missing, skipping" >&2; exit 0; }
+
+sanitize_cell() {
+  printf '%s' "$1" | tr '\n' ' ' | sed -e 's/|/\\|/g' -e 's/  */ /g' -e 's/^ *//' -e 's/ *$//'
+}
+trunc() {
+  local s="$1" n="$2"
+  if [[ ${#s} -le $n ]]; then printf '%s' "$s"; else printf '%s…' "${s:0:$((n-1))}"; fi
+}
+
+heading_md() {
+  awk '/^# / { sub(/^# +/, ""); print; exit }' "$1" 2>/dev/null || true
+}
+title_html() {
+  awk 'BEGIN{IGNORECASE=1} /<title>/ { sub(/.*<title>/, ""); sub(/<\/title>.*/, ""); print; exit }' "$1" 2>/dev/null || true
+}
+
+extract_date() {
+  local name="$1"
+  if [[ "$name" =~ ^([0-9]{4}-[0-9]{2}-[0-9]{2}) ]]; then
+    echo "${BASH_REMATCH[1]}"
+  elif [[ "$name" =~ ^([0-9]{4}-W[0-9]{2}) ]]; then
+    echo "${BASH_REMATCH[1]}"
+  else
+    echo "—"
+  fi
+}
+
+describe_file() {
+  local f="$1"
+  local name
+  name=$(basename "$f")
+  case "$name" in
+    *.md)
+      local h
+      h=$(heading_md "$f")
+      [[ -z "$h" ]] && h="${name%.md}"
+      echo "$h"
+      ;;
+    *.html|*.htm)
+      local t
+      t=$(title_html "$f")
+      [[ -z "$t" ]] && t="${name%.*}"
+      echo "$t"
+      ;;
+    *)
+      echo "${name}"
+      ;;
+  esac
+}
+
+describe_subdir() {
+  local d="$1"
+  local n
+  n=$(find "$d" -mindepth 1 -maxdepth 1 ! -name '.*' 2>/dev/null | wc -l | tr -d ' ')
+  echo "${n} item(s)"
+}
+
+{
+  echo "# Reports"
+  echo ""
+  echo "> Auto-generated. Updated: ${DATE}"
+  echo ""
+  echo "Personal/HQ reports only. Company reports moved to \`companies/{co}/data/reports/\`."
+  echo ""
+  echo "## Directories"
+  echo ""
+  echo "| Name | Description |"
+  echo "|------|-------------|"
+  while IFS= read -r d; do
+    name=$(basename "$d")
+    [[ "$name" == .* ]] && continue
+    desc=$(describe_subdir "$d")
+    desc=$(sanitize_cell "$desc")
+    desc=$(trunc "$desc" 100)
+    printf '| `%s/` | %s |\n' "$name" "$desc"
+  done < <(find workspace/reports -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+
+  echo ""
+  echo "## Individual Reports"
+  echo ""
+  echo "| Name | Date | Description |"
+  echo "|------|------|-------------|"
+  while IFS= read -r f; do
+    name=$(basename "$f")
+    [[ "$name" == "INDEX.md" ]] && continue
+    [[ "$name" == .* ]] && continue
+    d=$(extract_date "$name")
+    desc=$(describe_file "$f")
+    desc=$(sanitize_cell "$desc")
+    desc=$(trunc "$desc" 100)
+    [[ -z "$desc" ]] && desc="—"
+    printf '| `%s` | %s | %s |\n' "$name" "$d" "$desc"
+  done < <(find workspace/reports -mindepth 1 -maxdepth 1 -type f 2>/dev/null | sort)
+} > "$OUT"
+
+n=$(find workspace/reports -mindepth 1 -maxdepth 1 -type f ! -name 'INDEX.md' 2>/dev/null | wc -l | tr -d ' ')
+echo "rebuild-reports-index: wrote ${OUT} (${n} individual report(s))" >&2

package/assets/scaffold/core/scripts/rebuild-social-drafts-index.sh

@@ -0,0 +1,135 @@
+#!/usr/bin/env bash
+# rebuild-social-drafts-index.sh — regenerate workspace/social-drafts/INDEX.md.
+#
+# Pure bash. Lists:
+#   - "Recent Drafts": 20 most-recently-modified .md files under date-channel
+#     subdirs (x/, linkedin/, blog/, tiktok/). Description = first `#` heading.
+#   - "Directories": top-level subdirs + loose files with description.
+
+set -euo pipefail
+
+HQ_ROOT="${HQ_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+# shellcheck source=core/scripts/lib/portable.sh
+. "$HQ_ROOT/core/scripts/lib/portable.sh"
+cd "$HQ_ROOT"
+
+OUT="workspace/social-drafts/INDEX.md"
+DATE=$(date -u +%Y-%m-%d)
+
+[[ -d workspace/social-drafts ]] || { echo "rebuild-social-drafts-index: workspace/social-drafts/ missing, skipping" >&2; exit 0; }
+
+sanitize_cell() {
+  printf '%s' "$1" | tr '\n' ' ' | sed -e 's/|/\\|/g' -e 's/  */ /g' -e 's/^ *//' -e 's/ *$//'
+}
+trunc() {
+  local s="$1" n="$2"
+  if [[ ${#s} -le $n ]]; then printf '%s' "$s"; else printf '%s…' "${s:0:$((n-1))}"; fi
+}
+
+heading_md() {
+  awk '/^# / { sub(/^# +/, ""); print; exit }' "$1" 2>/dev/null || true
+}
+
+describe_subdir() {
+  local d="$1"
+  local name
+  name=$(basename "$d")
+  local n_files n_dirs
+  n_files=$(find "$d" -mindepth 1 -maxdepth 1 -type f ! -name '.*' 2>/dev/null | wc -l | tr -d ' ')
+  n_dirs=$(find "$d" -mindepth 1 -maxdepth 1 -type d ! -name '.*' 2>/dev/null | wc -l | tr -d ' ')
+  case "$name" in
+    x)        echo "X/Twitter post drafts (${n_files} files)" ;;
+    linkedin) echo "LinkedIn post drafts (${n_files} files)" ;;
+    blog)     echo "Blog post drafts (${n_files} files)" ;;
+    tiktok)   echo "TikTok scripts/drafts (${n_files} files)" ;;
+    images)   echo "Infographics and post images (${n_dirs} dirs)" ;;
+    *)
+      if [[ "$n_dirs" -gt 0 ]]; then
+        echo "${n_dirs} subdir(s), ${n_files} file(s)"
+      else
+        echo "${n_files} file(s)"
+      fi
+      ;;
+  esac
+}
+
+describe_file() {
+  local f="$1"
+  local name
+  name=$(basename "$f")
+  case "$name" in
+    *.md)
+      local h
+      h=$(heading_md "$f")
+      [[ -z "$h" ]] && h="${name%.md}"
+      echo "$h"
+      ;;
+    *.json)
+      echo "${name%.json} data"
+      ;;
+    *.py|*.sh)
+      echo "Script: ${name}"
+      ;;
+    *)
+      echo "${name}"
+      ;;
+  esac
+}
+
+{
+  echo "# Social Drafts"
+  echo ""
+  echo "> Auto-generated. Updated: ${DATE}"
+  echo ""
+  echo "## Recent Drafts"
+  echo ""
+  # 20 most-recently-modified .md files in date-channel subdirs
+  # (use find -printf if GNU; macOS find lacks -printf — fall back to stat)
+  while IFS= read -r f; do
+    rel="${f#workspace/social-drafts/}"
+    desc=$(heading_md "$f")
+    [[ -z "$desc" ]] && desc=$(basename "$f" .md)
+    desc=$(sanitize_cell "$desc")
+    desc=$(trunc "$desc" 100)
+    printf -- '- `%s` - %s\n' "$rel" "$desc"
+  done < <(
+    {
+      for chan in x linkedin blog tiktok; do
+        [[ -d "workspace/social-drafts/${chan}" ]] || continue
+        find "workspace/social-drafts/${chan}" -mindepth 1 -maxdepth 1 -type f -name '*.md' 2>/dev/null
+      done
+    } | while IFS= read -r f; do
+      # Sortable timestamp (portable BSD/GNU stat)
+      ts=$(portable_stat_mtime "$f" 2>/dev/null || echo 0)
+      printf '%s\t%s\n' "$ts" "$f"
+    done | sort -rn | head -20 | cut -f2
+  )
+
+  echo ""
+  echo "## Directories"
+  echo ""
+  echo "| Name | Description |"
+  echo "|------|-------------|"
+  while IFS= read -r d; do
+    name=$(basename "$d")
+    [[ "$name" == .* ]] && continue
+    desc=$(describe_subdir "$d")
+    desc=$(sanitize_cell "$desc")
+    desc=$(trunc "$desc" 100)
+    printf '| `%s/` | %s |\n' "$name" "$desc"
+  done < <(find workspace/social-drafts -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+
+  # Loose top-level files
+  while IFS= read -r f; do
+    name=$(basename "$f")
+    [[ "$name" == "INDEX.md" ]] && continue
+    [[ "$name" == .* ]] && continue
+    desc=$(describe_file "$f")
+    desc=$(sanitize_cell "$desc")
+    desc=$(trunc "$desc" 100)
+    printf '| `%s` | %s |\n' "$name" "$desc"
+  done < <(find workspace/social-drafts -mindepth 1 -maxdepth 1 -type f 2>/dev/null | sort)
+} > "$OUT"
+
+n=$(find workspace/social-drafts -mindepth 2 -type f -name '*.md' 2>/dev/null | wc -l | tr -d ' ')
+echo "rebuild-social-drafts-index: wrote ${OUT} (${n} draft file(s))" >&2

package/assets/scaffold/core/scripts/rebuild-threads-index.sh

@@ -0,0 +1,82 @@
+#!/usr/bin/env bash
+# rebuild-threads-index.sh — regenerate workspace/threads/INDEX.md from thread JSON files.
+#
+# Pure bash + jq. Zero Claude context. Reads active thread JSONs (not archive/),
+# batches metadata through a single jq invocation (vs 1 subprocess per file).
+#
+# Usage:
+#   core/scripts/rebuild-threads-index.sh              # regen INDEX.md
+#   core/scripts/rebuild-threads-index.sh --recent     # regen recent.md only (last 15)
+#   core/scripts/rebuild-threads-index.sh --both       # regen both
+
+set -euo pipefail
+
+HQ_ROOT="${HQ_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+cd "$HQ_ROOT"
+
+MODE="${1:---index}"
+
+THREADS_DIR="workspace/threads"
+INDEX_PATH="${THREADS_DIR}/INDEX.md"
+RECENT_PATH="${THREADS_DIR}/recent.md"
+TS=$(date -u +%Y-%m-%dT%H:%M:%SZ)
+
+mkdir -p "$THREADS_DIR"
+
+# Gather active thread files (exclude archive/), newest first by mtime.
+# Portable (bash 3.x compatible) — avoid mapfile.
+THREAD_FILES=()
+while IFS= read -r line; do
+  # Each primary thread record can have a changeset sidecar. The T-*.json
+  # glob also matches that sidecar, but it is not a thread record.
+  [[ "$line" == *.changeset.json ]] && continue
+  THREAD_FILES+=("$line")
+done < <(ls -t "$THREADS_DIR"/T-*.json 2>/dev/null || true)
+COUNT=${#THREAD_FILES[@]}
+
+extract_metadata() {
+  [[ $# -eq 0 ]] && return 0
+  jq -rs '
+    .[] | [
+      (.thread_id // "-"),
+      (.type // "-"),
+      (.updated_at // "-"),
+      ((.metadata.title // "-") | gsub("\\|"; "/") | gsub("\n"; " "))
+    ] | @tsv
+  ' "$@" 2>/dev/null || true
+}
+
+write_table() {
+  local out="$1"; shift
+  local title="$1"; shift
+  local limit="$1"; shift
+  # remaining args are files
+
+  {
+    echo "# ${title}"
+    echo ""
+    echo "Generated: ${TS}"
+    echo "Active threads: ${COUNT} (archive/ excluded)"
+    echo ""
+    echo "| Thread | Type | Updated | Title |"
+    echo "|--------|------|---------|-------|"
+    if [[ $# -gt 0 ]]; then
+      local rows
+      rows=$(extract_metadata "$@")
+      if [[ "$limit" -gt 0 ]]; then
+        rows=$(printf "%s\n" "$rows" | awk -v n="$limit" 'NR <= n')
+      fi
+      printf "%s\n" "$rows" | awk -F'\t' 'NF>=4 { printf "| %s | %s | %s | %s |\n", $1, $2, $3, $4 }'
+    fi
+  } > "$out"
+}
+
+if [[ "$MODE" == "--index" || "$MODE" == "--both" ]]; then
+  write_table "$INDEX_PATH" "Threads INDEX" 0 "${THREAD_FILES[@]+"${THREAD_FILES[@]}"}"
+  echo "rebuild-threads-index: wrote ${INDEX_PATH} (${COUNT} threads)" >&2
+fi
+
+if [[ "$MODE" == "--recent" || "$MODE" == "--both" ]]; then
+  write_table "$RECENT_PATH" "Recent Threads" 15 "${THREAD_FILES[@]+"${THREAD_FILES[@]}"}"
+  echo "rebuild-threads-index: wrote ${RECENT_PATH} (last 15)" >&2
+fi

package/assets/scaffold/core/scripts/rebuild-workers-index.sh

@@ -0,0 +1,97 @@
+#!/usr/bin/env bash
+# rebuild-workers-index.sh — regenerate core/workers/public/INDEX.md (and
+# core/workers/INDEX.md at the top level if it exists).
+#
+# Pure bash + yq. Each worker subdir has worker.yaml — extract .worker.description
+# for the table row.
+
+set -euo pipefail
+
+HQ_ROOT="${HQ_ROOT:-$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)}"
+cd "$HQ_ROOT"
+
+DATE=$(date -u +%Y-%m-%d)
+
+sanitize_cell() {
+  printf '%s' "$1" | tr '\n' ' ' | sed -e 's/|/\\|/g' -e 's/  */ /g' -e 's/^ *//' -e 's/ *$//'
+}
+trunc() {
+  local s="$1" n="$2"
+  if [[ ${#s} -le $n ]]; then printf '%s' "$s"; else printf '%s…' "${s:0:$((n-1))}"; fi
+}
+
+worker_desc() {
+  local yaml="$1"
+  [[ -f "$yaml" ]] || { echo ""; return; }
+  if command -v yq >/dev/null 2>&1; then
+    yq -r '.worker.description // .worker.bio.role // ""' "$yaml" 2>/dev/null || echo ""
+  else
+    # Fallback: first-line description grep
+    awk -F: '/^[[:space:]]+description:/ { sub(/^[^:]+: */, ""); gsub(/^["\x27]|["\x27]$/, ""); print; exit }' "$yaml" 2>/dev/null || echo ""
+  fi
+}
+
+write_workers_subindex() {
+  local subdir="$1"
+  local label="$2"
+  local out="${subdir}/INDEX.md"
+  [[ -d "$subdir" ]] || return 0
+  {
+    echo "# ${label}"
+    echo ""
+    echo "> Auto-generated. Updated: ${DATE}"
+    echo ""
+    echo "| Name | Description |"
+    echo "|------|-------------|"
+    while IFS= read -r d; do
+      name=$(basename "$d")
+      [[ "$name" == .* ]] && continue
+      desc=$(worker_desc "${d}/worker.yaml")
+      desc=$(sanitize_cell "$desc")
+      desc=$(trunc "$desc" 100)
+      [[ -z "$desc" ]] && desc="—"
+      printf '| `%s/` | %s |\n' "$name" "$desc"
+    done < <(find "$subdir" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+  } > "$out"
+  echo "rebuild-workers-index: wrote ${out}" >&2
+}
+
+write_workers_root() {
+  local root="core/workers"
+  local out="${root}/INDEX.md"
+  [[ -d "$root" ]] || return 0
+  {
+    echo "# Workers"
+    echo ""
+    echo "> Auto-generated. Updated: ${DATE}"
+    echo ""
+    echo "Shared workers live under \`public/\`. Private/local workers live under \`personal/workers/\`. \`registry.yaml\` is the auto-generated index (regenerated by core/scripts/generate-workers-registry.sh)."
+    echo ""
+    echo "| Name | Description |"
+    echo "|------|-------------|"
+    while IFS= read -r d; do
+      name=$(basename "$d")
+      [[ "$name" == .* ]] && continue
+      [[ "$name" == "public" ]] && { printf '| `public/` | Shared public workers (see public/INDEX.md) |\n'; continue; }
+      desc=$(worker_desc "${d}/worker.yaml")
+      desc=$(sanitize_cell "$desc")
+      desc=$(trunc "$desc" 100)
+      [[ -z "$desc" ]] && desc="—"
+      printf '| `%s/` | %s |\n' "$name" "$desc"
+    done < <(find "$root" -mindepth 1 -maxdepth 1 -type d 2>/dev/null | sort)
+  } > "$out"
+  echo "rebuild-workers-index: wrote ${out}" >&2
+}
+
+# Public workers (always present)
+write_workers_subindex "core/workers/public" "Public Workers"
+
+# Personal workers (only if dir exists)
+if [[ -d "personal/workers" ]]; then
+  write_workers_subindex "personal/workers" "Personal Workers"
+fi
+
+# Root workers INDEX (covers top-level pr-* workers + public/ pointer)
+write_workers_root
+
+echo "rebuild-workers-index: done" >&2

package/assets/scaffold/core/scripts/resize-screenshot.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+# resize-screenshot.sh — Resize screenshot to max 1800px (longest dimension), in-place.
+# Uses sips (macOS native). Falls back to magick if sips unavailable.
+# Usage: resize-screenshot.sh <path-to-image>
+#
+# 1800px chosen to stay under the 2000px API limit with margin.
+# JPEG at q=85 is visually lossless for audit work.
+
+set -euo pipefail
+
+MAX_DIM=1800
+FILE="${1:-}"
+
+[[ -n "$FILE" && -f "$FILE" ]] || { echo "resize-screenshot: file not found: $FILE" >&2; exit 1; }
+
+# Get current dimensions via sips
+W=$(sips -g pixelWidth "$FILE" 2>/dev/null | awk '/pixelWidth/{print $2}')
+H=$(sips -g pixelHeight "$FILE" 2>/dev/null | awk '/pixelHeight/{print $2}')
+
+[[ -n "$W" && -n "$H" ]] || { echo "resize-screenshot: cannot read dimensions" >&2; exit 2; }
+
+if [[ "$W" -le "$MAX_DIM" && "$H" -le "$MAX_DIM" ]]; then
+  echo "resize-screenshot: ${W}x${H} — within bounds, skipping"
+  exit 0
+fi
+
+# Determine new size (preserve aspect ratio, shrink longest dimension to MAX_DIM)
+if [[ "$W" -ge "$H" ]]; then
+  NEW_W=$MAX_DIM
+  NEW_H=$(( H * MAX_DIM / W ))
+else
+  NEW_H=$MAX_DIM
+  NEW_W=$(( W * MAX_DIM / H ))
+fi
+
+echo "resize-screenshot: ${W}x${H} → ${NEW_W}x${NEW_H} ($FILE)"
+
+if command -v sips &>/dev/null; then
+  sips --resampleHeightWidth "$NEW_H" "$NEW_W" "$FILE" --out "$FILE" >/dev/null 2>&1
+elif command -v magick &>/dev/null; then
+  magick "$FILE" -resize "${MAX_DIM}x${MAX_DIM}>" "$FILE"
+else
+  echo "resize-screenshot: no image tool available (sips/magick)" >&2
+  exit 2
+fi
+
+echo "resize-screenshot: done"