steward-cli 0.3.2__tar.gz → 0.5.0__tar.gz

steward_cli-0.5.0/.claude/skills/discord-notify/SKILL.md

@@ -0,0 +1,59 @@
+---
+name: discord-notify
+description: >
+  Send notifications to Discord via webhook. Use when: a long task completes,
+  an error needs attention, the user says "notify me", "ping me", "let me know",
+  "send to discord", or "update me when done".
+---
+
+# Discord Notify
+
+Send a message to a Discord channel using a webhook embed.
+
+## When to Use
+
+- A long-running task finishes (build, deploy, migration)
+- An error occurs that the user should know about
+- The user explicitly asks to be notified
+
+## Prerequisites
+
+The script requires the following tools on `PATH`:
+
+- `bash`
+- `curl` — sends the webhook POST
+- `jq` — builds the JSON payload safely
+
+## Environment
+
+Set `DISCORD_WEBHOOK_URL` to a Discord webhook URL before use.
+
+## Usage
+
+```bash
+# Basic info message
+bash .claude/skills/discord-notify/scripts/send-discord.sh "Build passed"
+
+# Completion (green)
+bash .claude/skills/discord-notify/scripts/send-discord.sh --type completion "Deploy finished"
+
+# Error (red)
+bash .claude/skills/discord-notify/scripts/send-discord.sh --type error "Tests failed on main"
+
+# Status update (yellow)
+bash .claude/skills/discord-notify/scripts/send-discord.sh --type status "Migration running — 3/10 tables done"
+
+# Custom title
+bash .claude/skills/discord-notify/scripts/send-discord.sh --type completion --title "CI Pipeline" "All checks green"
+
+# Different sender identity
+bash .claude/skills/discord-notify/scripts/send-discord.sh --username "Codex" "Task complete"
+```
+
+## Options
+
+| Flag | Short | Default | Description |
+|------|-------|---------|-------------|
+| `--type` | `-t` | `info` | `info` (blue), `status` (yellow), `completion` (green), `error` (red) |
+| `--title` | `-T` | auto | Override the embed title |
+| `--username` | `-u` | `Claude Code` | Sender name shown in Discord |

steward_cli-0.5.0/.claude/skills/discord-notify/scripts/send-discord.sh

@@ -0,0 +1,100 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# Discord webhook notification sender using embeds.
+# Requires DISCORD_WEBHOOK_URL environment variable.
+
+# --- Defaults ---
+TYPE="info"
+TITLE=""
+USERNAME="Claude Code"
+MESSAGE=""
+
+# --- Color map ---
+color_for_type() {
+  case "$1" in
+    info)       echo 3447003  ;;  # blue
+    status)     echo 16776960 ;;  # yellow
+    completion) echo 3066993  ;;  # green
+    error)      echo 15158332 ;;  # red
+    *) echo "Unknown type: $1" >&2; exit 1 ;;
+  esac
+}
+
+# --- Default title ---
+title_for_type() {
+  case "$1" in
+    info)       echo "Info"       ;;
+    status)     echo "Status"     ;;
+    completion) echo "Completed"  ;;
+    error)      echo "Error"      ;;
+  esac
+}
+
+# --- Parse args ---
+require_value() {
+  local flag="$1" remaining="$2"
+  if [[ "$remaining" -lt 2 ]]; then
+    echo "Error: $flag requires a value" >&2
+    echo "Usage: send-discord.sh [--type info|status|completion|error] [--title TITLE] [--username NAME] MESSAGE" >&2
+    exit 1
+  fi
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --type|-t)     require_value "$1" "$#"; TYPE="$2";     shift 2 ;;
+    --title|-T)    require_value "$1" "$#"; TITLE="$2";    shift 2 ;;
+    --username|-u) require_value "$1" "$#"; USERNAME="$2"; shift 2 ;;
+    -*)            echo "Unknown option: $1" >&2; exit 1 ;;
+    *)             MESSAGE="$1";  shift ;;
+  esac
+done
+
+# --- Validate ---
+if [[ -z "${DISCORD_WEBHOOK_URL:-}" ]]; then
+  echo "Error: DISCORD_WEBHOOK_URL environment variable is not set." >&2
+  exit 1
+fi
+
+if [[ -z "$MESSAGE" ]]; then
+  echo "Error: No message provided." >&2
+  echo "Usage: send-discord.sh [--type info|status|completion|error] [--title TITLE] [--username NAME] MESSAGE" >&2
+  exit 1
+fi
+
+COLOR=$(color_for_type "$TYPE")
+EMBED_TITLE="${TITLE:-$(title_for_type "$TYPE")}"
+TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+# --- Build JSON safely with jq ---
+PAYLOAD=$(jq -n \
+  --arg username "$USERNAME" \
+  --arg title "$EMBED_TITLE" \
+  --arg description "$MESSAGE" \
+  --argjson color "$COLOR" \
+  --arg footer "Sent by $USERNAME" \
+  --arg timestamp "$TIMESTAMP" \
+  '{
+    username: $username,
+    embeds: [{
+      title: $title,
+      description: $description,
+      color: $color,
+      footer: { text: $footer },
+      timestamp: $timestamp
+    }]
+  }')
+
+# --- Send ---
+HTTP_CODE=$(curl -s -o /dev/null -w "%{http_code}" \
+  -H "Content-Type: application/json" \
+  -d "$PAYLOAD" \
+  "$DISCORD_WEBHOOK_URL")
+
+if [[ "$HTTP_CODE" -ge 200 && "$HTTP_CODE" -lt 300 ]]; then
+  echo "Sent ($HTTP_CODE)"
+else
+  echo "Error: Discord returned HTTP $HTTP_CODE" >&2
+  exit 1
+fi

steward_cli-0.5.0/.claude/skills/gh-issues/SKILL.md

@@ -0,0 +1,45 @@
+---
+name: gh-issues
+description: >
+  Fetch GitHub issues with full body and comments. Use when checking issues,
+  reviewing bug reports, or the user says "check issues", "fetch issues",
+  "issue #N", or references GitHub issue numbers.
+triggers:
+  - check issues
+  - fetch issues
+  - issue #
+  - github issues
+  - verify issues
+---
+
+# GitHub Issues Skill
+
+Fetch one or more GitHub issues with full body text and all comments.
+
+## Usage
+
+### Single issue
+
+```bash
+bash .claude/skills/gh-issues/scripts/gh-issues.sh 191
+```
+
+### Range
+
+```bash
+bash .claude/skills/gh-issues/scripts/gh-issues.sh 191-197
+```
+
+### Specific list
+
+```bash
+bash .claude/skills/gh-issues/scripts/gh-issues.sh 191 195 197
+```
+
+### Explicit repo
+
+```bash
+bash .claude/skills/gh-issues/scripts/gh-issues.sh --repo owner/repo 42-50
+```
+
+Output is JSON per issue with: number, title, state, labels, body, and comments array.

steward_cli-0.5.0/.claude/skills/gh-issues/scripts/gh-issues.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+# Fetch GitHub issues with full body and comments
+# Usage: gh-issues.sh [RANGE|NUMBER] [--repo OWNER/REPO]
+#   gh-issues.sh 191-197          # range
+#   gh-issues.sh 191              # single
+#   gh-issues.sh 191 192 195      # list
+#   gh-issues.sh --repo foo/bar 5 # explicit repo
+
+set -euo pipefail
+
+REPO_FLAG=""
+NUMBERS=()
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)
+      if [[ $# -lt 2 || -z "$2" ]]; then
+        echo "Error: --repo requires a value (OWNER/REPO)" >&2
+        echo "Usage: gh-issues.sh [RANGE|NUMBER...] [--repo OWNER/REPO]" >&2
+        exit 1
+      fi
+      REPO_FLAG="--repo $2"
+      shift 2 ;;
+    *-*)  # range like 191-197
+      IFS='-' read -r start end <<< "$1"
+      for ((i=start; i<=end; i++)); do NUMBERS+=("$i"); done
+      shift ;;
+    *)  NUMBERS+=("$1"); shift ;;
+  esac
+done
+
+if [[ ${#NUMBERS[@]} -eq 0 ]]; then
+  echo "Usage: gh-issues.sh [RANGE|NUMBER...] [--repo OWNER/REPO]" >&2
+  exit 1
+fi
+
+for num in "${NUMBERS[@]}"; do
+  echo "========================================"
+  echo "ISSUE #${num}"
+  echo "========================================"
+  # shellcheck disable=SC2086
+  gh issue view "$num" $REPO_FLAG --json number,title,state,labels,body,comments \
+    --jq '{
+      number: .number,
+      title: .title,
+      state: .state,
+      labels: [.labels[].name],
+      body: .body,
+      comments: [.comments[] | {author: .author.login, body: .body}]
+    }' 2>/dev/null || echo "ERROR: Could not fetch issue #${num}"
+  echo
+done

steward_cli-0.5.0/.claude/skills/jekyll-test/SKILL.md

@@ -0,0 +1,57 @@
+---
+name: jekyll-test
+description: >
+  Build a Jekyll site (GitHub Pages / Cloudflare Pages) and validate the
+  output: build succeeds, custom color scheme is applied, permalinked pages
+  exist, just-the-docs navigation is consistent. Use after editing
+  `_config.yml`, theme files, SCSS, or page front matter; or when the user
+  says "test the site", "did the site build", "check jekyll", or
+  "verify pages".
+---
+
+# Jekyll Test
+
+Conditional skill — only meaningful when the sibling repo ships a Jekyll
+site. Detected by the presence of `_config.yml` somewhere in the repo.
+
+The original version of this skill was a ten-step manual checklist. The
+script does all ten steps in one shot and prints a single-screen summary;
+follow the script, not a manual procedure.
+
+## Usage
+
+```bash
+# Test the site whose _config.yml is at or above the current directory
+bash .claude/skills/jekyll-test/scripts/test-site.sh
+
+# Test a specific site (path to repo root)
+bash .claude/skills/jekyll-test/scripts/test-site.sh /path/to/jekyll-site
+```
+
+## What the script checks
+
+The script walks up to find `_config.yml`, runs `bundle install --quiet`
+and `bundle exec jekyll build` (the only hard-fail step), then reports
+non-fatal validation findings:
+
+- Build status and elapsed time.
+- For `color_scheme: <name>` declarations, every hex from
+  `_sass/color_schemes/<name>.scss` is grep'd for in the built
+  `_site/assets/css/*` — missing colors are listed.
+- Every `permalink:` in front matter is checked against the generated
+  `<permalink>/index.html` — missing pages are listed.
+- For `just-the-docs` sites, every `parent:` value is matched against
+  parent pages' `title:` — orphans (children whose parent is not found)
+  are listed. Parent counts and child counts are printed.
+- `_includes/footer_custom.html` and `_includes/head_custom.html`, if
+  they exist, are checked for inclusion in `_site/index.html`.
+
+The output is a single summary block plus per-category failure detail.
+
+## Requirements
+
+- `bundle` (Bundler) on PATH.
+- `ruby` on PATH (whatever the site's `Gemfile` requires).
+- `python3` on PATH (used to parse `_config.yml`; PyYAML preferred,
+  regex fallback if it is not installed).
+- A Jekyll project (must contain `_config.yml`).

steward_cli-0.5.0/.claude/skills/jekyll-test/scripts/test-site.sh

@@ -0,0 +1,232 @@
+#!/usr/bin/env bash
+# test-site.sh — Build a Jekyll site and validate the output.
+# Replaces the manual ten-step checklist that lived in the original
+# jekyll-test SKILL.md.
+#
+# Usage:
+#   test-site.sh              # tests the site at/above $PWD
+#   test-site.sh /path/to/site
+#
+# Exits non-zero only if the Jekyll project cannot be found or the build
+# itself fails. Validation findings (missing colors, missing permalinks,
+# orphan navigation children, missing includes) are reported but do not
+# fail the run — the agent reading the output decides what to do.
+
+set -euo pipefail
+
+START_DIR="${1:-$PWD}"
+
+# --- Locate Jekyll root (walk up from START_DIR looking for _config.yml) ---
+SITE_ROOT=""
+dir="$(cd "$START_DIR" && pwd)"
+while [[ "$dir" != "/" && "$dir" != "" ]]; do
+  if [[ -f "$dir/_config.yml" ]]; then
+    SITE_ROOT="$dir"
+    break
+  fi
+  dir="$(dirname "$dir")"
+done
+
+if [[ -z "$SITE_ROOT" ]]; then
+  echo "Error: no _config.yml found at or above $START_DIR — not a Jekyll project" >&2
+  exit 1
+fi
+
+cd "$SITE_ROOT"
+echo "Site root: $SITE_ROOT"
+
+# --- Read selected _config.yml keys via Python (PyYAML if available, else regex) ---
+if ! command -v python3 >/dev/null 2>&1; then
+  echo "Error: python3 is required to parse _config.yml but was not found on PATH" >&2
+  exit 1
+fi
+
+read_config() {
+  python3 - <<'PY' 2>/dev/null
+import os, sys, re
+path = "_config.yml"
+try:
+    import yaml
+    with open(path) as f:
+        cfg = yaml.safe_load(f) or {}
+except Exception:
+    cfg = {}
+    line_re = re.compile(r"^(\w+):\s*(.*)$")
+    with open(path) as f:
+        for line in f:
+            m = line_re.match(line)
+            if m:
+                cfg[m.group(1)] = m.group(2).strip().strip('"').strip("'")
+for key in ("color_scheme", "theme", "remote_theme", "baseurl", "url"):
+    val = cfg.get(key, "")
+    print(f"{key}={val}")
+PY
+}
+
+declare -A CFG=()
+while IFS='=' read -r k v; do
+  [[ -n "$k" ]] && CFG["$k"]="$v"
+done < <(read_config)
+
+THEME="${CFG[theme]:-${CFG[remote_theme]:-}}"
+COLOR_SCHEME="${CFG[color_scheme]:-}"
+
+echo "Theme:        ${THEME:-<none>}"
+echo "Color scheme: ${COLOR_SCHEME:-<none>}"
+
+# --- Bundler dependencies ---
+if ! command -v bundle >/dev/null 2>&1; then
+  echo "Error: bundle (Bundler) is not on PATH — install Ruby + bundler first" >&2
+  exit 1
+fi
+
+if ! bundle check >/dev/null 2>&1; then
+  echo "Installing gem dependencies via 'bundle install'..."
+  bundle install --quiet
+fi
+
+# --- just-the-docs search index init (only when used as a gem theme) ---
+if [[ "$THEME" == "just-the-docs" && ! -f "assets/js/zzzz-search-data.json" ]]; then
+  echo "Initialising just-the-docs search index..."
+  bundle exec just-the-docs rake search:init >/dev/null 2>&1 || true
+fi
+
+# --- Build ---
+echo
+echo "Building site..."
+BUILD_LOG="$(mktemp)"
+trap 'rm -f "$BUILD_LOG"' EXIT
+BUILD_OK=1
+BUILD_TIME=""
+if bundle exec jekyll build >"$BUILD_LOG" 2>&1; then
+  BUILD_TIME="$(grep -oE 'done in [0-9.]+ seconds' "$BUILD_LOG" | tail -1 || echo)"
+else
+  BUILD_OK=0
+fi
+
+if [[ "$BUILD_OK" -eq 0 ]]; then
+  echo "Build:        FAILED"
+  echo "--- last 40 lines of build log ---"
+  tail -40 "$BUILD_LOG"
+  exit 1
+fi
+echo "Build:        OK ${BUILD_TIME:+($BUILD_TIME)}"
+
+# --- Color scheme verification ---
+COLOR_FOUND=0
+COLOR_TOTAL=0
+COLOR_MISSING=()
+if [[ -n "$COLOR_SCHEME" ]]; then
+  SCSS_FILE="_sass/color_schemes/${COLOR_SCHEME}.scss"
+  if [[ -f "$SCSS_FILE" ]]; then
+    # Pull every `#abcdef` hex from the SCSS file
+    mapfile -t HEXES < <(grep -ohE '#[0-9a-fA-F]{3,8}' "$SCSS_FILE" | sort -u)
+    COLOR_TOTAL=${#HEXES[@]}
+    if [[ "$COLOR_TOTAL" -gt 0 ]]; then
+      CSS_BLOB="$(cat _site/assets/css/*.css 2>/dev/null || true)"
+      for hex in "${HEXES[@]}"; do
+        if grep -qiF "$hex" <<<"$CSS_BLOB"; then
+          ((COLOR_FOUND++)) || true
+        else
+          COLOR_MISSING+=("$hex")
+        fi
+      done
+    fi
+  fi
+fi
+
+# --- Permalink verification ---
+PERMA_TOTAL=0
+PERMA_OK=0
+PERMA_MISSING=()
+while IFS= read -r mdfile; do
+  perma="$(awk '
+    /^---$/ {fm = !fm; next}
+    fm && /^permalink:/ {sub(/^permalink:[ \t]*/, ""); gsub(/["'\'']/, ""); print; exit}
+  ' "$mdfile")"
+  [[ -z "$perma" ]] && continue
+  ((PERMA_TOTAL++)) || true
+  perma_clean="${perma#/}"
+  perma_clean="${perma_clean%/}"
+  if [[ -f "_site/${perma_clean}/index.html" || -f "_site/${perma_clean}.html" ]]; then
+    ((PERMA_OK++)) || true
+  else
+    PERMA_MISSING+=("$perma")
+  fi
+done < <(find . -type f -name '*.md' -not -path './_site/*' -not -path './vendor/*' -not -path './node_modules/*' 2>/dev/null)
+
+# --- just-the-docs navigation consistency ---
+NAV_PARENTS=0
+NAV_CHILDREN=0
+NAV_ORPHANS=()
+if [[ "$THEME" == "just-the-docs" ]]; then
+  declare -A PARENT_TITLES=()
+  while IFS= read -r mdfile; do
+    has_kids="$(awk '/^---$/{fm=!fm;next} fm && /^has_children:[ \t]*true/{print "yes";exit}' "$mdfile")"
+    title="$(awk '/^---$/{fm=!fm;next} fm && /^title:/{sub(/^title:[ \t]*/,"");gsub(/["'\'']/,"");print;exit}' "$mdfile")"
+    if [[ "$has_kids" == "yes" && -n "$title" ]]; then
+      PARENT_TITLES["$title"]=1
+      ((NAV_PARENTS++)) || true
+    fi
+  done < <(find . -type f -name '*.md' -not -path './_site/*' -not -path './vendor/*' 2>/dev/null)
+
+  while IFS= read -r mdfile; do
+    parent="$(awk '/^---$/{fm=!fm;next} fm && /^parent:/{sub(/^parent:[ \t]*/,"");gsub(/["'\'']/,"");print;exit}' "$mdfile")"
+    [[ -z "$parent" ]] && continue
+    ((NAV_CHILDREN++)) || true
+    if [[ -z "${PARENT_TITLES[$parent]:-}" ]]; then
+      NAV_ORPHANS+=("$mdfile -> parent:$parent")
+    fi
+  done < <(find . -type f -name '*.md' -not -path './_site/*' -not -path './vendor/*' 2>/dev/null)
+fi
+
+# --- Custom includes ---
+INC_FOOTER="-"
+INC_HEAD="-"
+if [[ -f _includes/footer_custom.html ]]; then
+  if grep -qF "$(head -3 _includes/footer_custom.html)" _site/index.html 2>/dev/null; then
+    INC_FOOTER="ok"
+  else
+    INC_FOOTER="missing"
+  fi
+fi
+if [[ -f _includes/head_custom.html ]]; then
+  if grep -qF "$(head -3 _includes/head_custom.html)" _site/index.html 2>/dev/null; then
+    INC_HEAD="ok"
+  else
+    INC_HEAD="missing"
+  fi
+fi
+
+# --- Summary ---
+echo
+echo "Jekyll Site Test Results"
+echo "========================"
+echo "Theme:        ${THEME:-<none>}"
+echo "Color scheme: ${COLOR_SCHEME:-<none>}"
+echo "Build:        OK ${BUILD_TIME:+($BUILD_TIME)}"
+if [[ -n "$COLOR_SCHEME" && "$COLOR_TOTAL" -gt 0 ]]; then
+  echo "Colors:       $COLOR_FOUND/$COLOR_TOTAL custom colors found in CSS"
+fi
+echo "Pages:        $PERMA_OK/$PERMA_TOTAL permalinked pages built"
+if [[ "$THEME" == "just-the-docs" ]]; then
+  echo "Navigation:   $NAV_PARENTS parents, $NAV_CHILDREN children, ${#NAV_ORPHANS[@]} orphans"
+fi
+echo "Includes:     footer=$INC_FOOTER, head=$INC_HEAD"
+
+# --- Failure detail (reported, not fatal) ---
+if [[ ${#COLOR_MISSING[@]} -gt 0 ]]; then
+  echo
+  echo "Missing colors:"
+  printf '  %s\n' "${COLOR_MISSING[@]}"
+fi
+if [[ ${#PERMA_MISSING[@]} -gt 0 ]]; then
+  echo
+  echo "Missing permalinked pages:"
+  printf '  %s\n' "${PERMA_MISSING[@]}"
+fi
+if [[ ${#NAV_ORPHANS[@]} -gt 0 ]]; then
+  echo
+  echo "Orphan nav children (parent not found):"
+  printf '  %s\n' "${NAV_ORPHANS[@]}"
+fi

steward_cli-0.5.0/.claude/skills/notebooklm/SKILL.md

@@ -0,0 +1,47 @@
+---
+name: notebooklm
+description: >
+  Generate GitHub links to repo documentation for NotebookLM ingestion.
+  Use when: the user wants to create a NotebookLM notebook about a project,
+  needs doc links for a repo, or says "notebooklm", "notebook sources",
+  "get repo sources", or "doc links".
+---
+
+# NotebookLM — Repo Source Links
+
+Generate GitHub blob URLs for all documentation in the current repo, ready to paste into Google NotebookLM as sources.
+
+## When to Use
+
+- Creating a NotebookLM notebook about a project
+- Gathering all doc links for a repo
+- Exporting documentation URLs for any external tool
+
+## Usage
+
+```bash
+# Categorized output (default)
+bash .claude/skills/notebooklm/scripts/get-repo-sources.sh
+
+# Plain URLs only (for copy-paste)
+bash .claude/skills/notebooklm/scripts/get-repo-sources.sh --plain
+
+# Include plans and specs
+bash .claude/skills/notebooklm/scripts/get-repo-sources.sh --all
+
+# Override branch
+bash .claude/skills/notebooklm/scripts/get-repo-sources.sh --branch develop
+```
+
+## Options
+
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--all` | off | Include plans, specs, and changelogs |
+| `--plain` | off | Output only URLs, one per line (no headers) |
+| `--branch NAME` | auto-detect | Override the git branch used in URLs |
+
+## Requirements
+
+- Must be run inside a git repository with a GitHub remote
+- `git` CLI available