browser-automation-skill 0.71.0

package/scripts/regenerate-docs.sh

@@ -0,0 +1,99 @@
+#!/usr/bin/env bash
+# scripts/regenerate-docs.sh — manual regen of cross-cutting docs from adapter
+# metadata. Intended to be run by hand; never by hooks. Drift is caught by
+# tests/lint.sh (Task 13). See: extension-model spec §6.
+
+set -euo pipefail
+IFS=$'\n\t'
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+LIB_TOOL_DIR="${REPO_ROOT}/scripts/lib/tool"
+
+emit_tool_versions() {
+  local to_stdout="${1:-}"
+  local out_file="${REPO_ROOT}/references/tool-versions.md"
+  local body
+  body="$(
+    printf '# Tool versions (autogenerated — do not edit; run scripts/regenerate-docs.sh)\n\n'
+    printf '| Tool | Version pin | Install hint | Cheatsheet |\n'
+    printf '|---|---|---|---|\n'
+    shopt -s nullglob
+    for adapter_file in "${LIB_TOOL_DIR}"/*.sh; do
+      [ "$(basename "${adapter_file}")" = ".gitkeep" ] && continue
+      meta="$(source "${adapter_file}" 2>/dev/null; tool_metadata 2>/dev/null)"
+      # install_hint is static (in tool_metadata), NOT dynamic (tool_doctor_check),
+      # so the generator output is deterministic across environments — drift lint
+      # passes regardless of whether the tool is currently installed on PATH.
+      jq -nr --argjson meta "${meta}" \
+        '"| \($meta.name) | \($meta.version_pin) | \($meta.install_hint // "n/a") | [\($meta.cheatsheet_path)](../\($meta.cheatsheet_path)) |"'
+    done
+    shopt -u nullglob
+  )"
+  if [ "${to_stdout}" = "--to-stdout" ]; then
+    printf '%s\n' "${body}"
+  else
+    printf '%s\n' "${body}" > "${out_file}"
+  fi
+}
+
+emit_skill_md() {
+  local to_stdout="${1:-}"
+  local skill_md="${REPO_ROOT}/SKILL.md"
+  local body
+  body="$(
+    printf '<!-- BEGIN AUTOGEN: tools-table — generated by scripts/regenerate-docs.sh -->\n'
+    printf '| Tool | Strengths | Cheatsheet |\n'
+    printf '|---|---|---|\n'
+    shopt -s nullglob
+    for adapter_file in "${LIB_TOOL_DIR}"/*.sh; do
+      [ "$(basename "${adapter_file}")" = ".gitkeep" ] && continue
+      meta="$(source "${adapter_file}" 2>/dev/null; tool_metadata 2>/dev/null)"
+      caps="$(source "${adapter_file}" 2>/dev/null; tool_capabilities 2>/dev/null)"
+      verb_count="$(jq -r '.verbs | length' <<<"${caps}")"
+      jq -nr --argjson meta "${meta}" --argjson n "${verb_count}" \
+        '"| \($meta.name) | declares \($n) verbs | [\($meta.cheatsheet_path)](\($meta.cheatsheet_path)) |"'
+    done
+    shopt -u nullglob
+    printf '<!-- END AUTOGEN: tools-table -->\n'
+  )"
+  if [ "${to_stdout}" = "--to-stdout" ]; then
+    printf '%s' "${body}"
+    return
+  fi
+  local tmp body_file
+  tmp="$(mktemp)"
+  body_file="$(mktemp)"
+  printf '%s' "${body}" > "${body_file}"
+  awk -v body_file="${body_file}" '
+    /<!-- BEGIN AUTOGEN: tools-table/ {
+      while ((getline line < body_file) > 0) print line
+      close(body_file)
+      in_block=1
+      next
+    }
+    /<!-- END AUTOGEN: tools-table -->/ { in_block=0; next }
+    !in_block { print }
+  ' "${skill_md}" > "${tmp}"
+  mv "${tmp}" "${skill_md}"
+  rm -f "${body_file}"
+}
+
+case "${1:-}" in
+  --to-stdout)
+    case "${2:-}" in
+      tool-versions) emit_tool_versions --to-stdout ;;
+      skill-md)      emit_skill_md --to-stdout ;;
+      *) printf 'usage: %s --to-stdout {tool-versions|skill-md}\n' "$0" >&2; exit 2 ;;
+    esac
+    ;;
+  tool-versions) emit_tool_versions ;;
+  skill-md)      emit_skill_md ;;
+  ""|all)
+    emit_tool_versions
+    emit_skill_md
+    ;;
+  *)
+    printf 'usage: %s [tool-versions|skill-md|all|--to-stdout {tool-versions|skill-md}]\n' "$0" >&2
+    exit 2
+    ;;
+esac

package/uninstall.sh

@@ -0,0 +1,51 @@
+#!/usr/bin/env bash
+# uninstall.sh — remove the ~/.claude/skills symlink. Optionally remove state.
+set -euo pipefail
+IFS=$'\n\t'
+
+REPO_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+# shellcheck source=scripts/lib/common.sh
+# shellcheck disable=SC1091
+source "${REPO_ROOT}/scripts/lib/common.sh"
+
+KEEP_STATE=0
+DRY_RUN=0
+
+usage() {
+  cat <<'USAGE'
+Usage: ./uninstall.sh [options]
+
+  --keep-state     do not delete ~/.browser-skill/ (default; today the script
+                   never deletes state — a future release may add an opt-in
+                   --delete-state flag)
+  --dry-run        print what would happen, change nothing
+  -h, --help
+USAGE
+}
+
+for arg in "$@"; do
+  case "${arg}" in
+    --keep-state) KEEP_STATE=1 ;;
+    --dry-run)    DRY_RUN=1 ;;
+    -h|--help)    usage; exit 0 ;;
+    *)            warn "ignoring unknown arg: ${arg}" ;;
+  esac
+done
+
+init_paths
+
+link="${HOME}/.claude/skills/browser-automation-skill"
+if [ -L "${link}" ]; then
+  if [ "${DRY_RUN}" = "1" ]; then
+    ok "dry-run: would remove symlink ${link}"
+  else
+    rm "${link}"
+    ok "removed symlink: ${link}"
+  fi
+else
+  ok "no symlink at ${link} (already gone)"
+fi
+
+if [ "${KEEP_STATE}" != "1" ] && [ -d "${BROWSER_SKILL_HOME}" ]; then
+  ok "keeping state at ${BROWSER_SKILL_HOME} (use rm -rf manually to delete)"
+fi