@jenga-ai/agent 1.0.0

package/skills/publish/scripts/droplet_pipeline.sh

@@ -0,0 +1,208 @@
+#!/usr/bin/env bash
+# droplet_pipeline.sh — Generate (or update) .github/workflows/publish-droplet.yml
+# and commit it.  With --dry-run, print the YAML to stdout only.
+#
+# Usage:
+#   droplet_pipeline.sh --target <name> [--config <path>] [--dry-run] [--non-interactive]
+#
+# Exit codes:
+#   0  success
+#   2  pre-flight failure (bad args, missing tools)
+#   4  validation failure (missing required config fields)
+
+set -euo pipefail
+
+EXIT_PRE_FLIGHT=2
+EXIT_ENV_INVALID=4
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+# ---------------------------------------------------------------------------
+# Resolve repo root
+# ---------------------------------------------------------------------------
+if REPO_ROOT="$(git -C "${SCRIPT_DIR}" rev-parse --show-toplevel 2>/dev/null)"; then
+  :
+else
+  REPO_ROOT="$(cd "${SCRIPT_DIR}/../../.." && pwd)"
+fi
+
+# ---------------------------------------------------------------------------
+# Source shared helpers
+# ---------------------------------------------------------------------------
+# shellcheck source=publish_common.sh
+source "${SCRIPT_DIR}/publish_common.sh"
+
+# ---------------------------------------------------------------------------
+# Arg parsing
+# ---------------------------------------------------------------------------
+TARGET_NAME=""
+CONFIG_PATH=""
+DRY_RUN=0
+NON_INTERACTIVE=0
+
+usage() {
+  cat <<'USAGE'
+Usage: droplet_pipeline.sh --target <name> [--config <path>] [--dry-run] [--non-interactive]
+USAGE
+}
+
+fail_pre() {
+  printf 'droplet pipeline pre-flight failure: %s\n' "$1" >&2
+  exit "${EXIT_PRE_FLIGHT}"
+}
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --target)
+      [[ $# -ge 2 ]] || fail_pre "--target requires a value"
+      TARGET_NAME="$2"
+      shift 2
+      ;;
+    --target=*)
+      TARGET_NAME="${1#*=}"
+      shift
+      ;;
+    --config)
+      [[ $# -ge 2 ]] || fail_pre "--config requires a value"
+      CONFIG_PATH="$2"
+      shift 2
+      ;;
+    --config=*)
+      CONFIG_PATH="${1#*=}"
+      shift
+      ;;
+    --dry-run)
+      DRY_RUN=1
+      shift
+      ;;
+    --non-interactive)
+      NON_INTERACTIVE=1
+      shift
+      ;;
+    -h|--help)
+      usage
+      exit 0
+      ;;
+    *)
+      usage >&2
+      fail_pre "unknown option: $1"
+      ;;
+  esac
+done
+
+# Silence unused-variable warning; flag is reserved for CI callers.
+: "${NON_INTERACTIVE:=0}"
+
+[[ -n "${TARGET_NAME}" ]] || fail_pre "--target <name> is required"
+
+# ---------------------------------------------------------------------------
+# Resolve config path
+# ---------------------------------------------------------------------------
+if [[ -z "${CONFIG_PATH}" ]]; then
+  if [[ -f "${REPO_ROOT}/publish.json" ]]; then
+    CONFIG_PATH="${REPO_ROOT}/publish.json"
+  elif [[ -f "${REPO_ROOT}/project/configs/publish.json" ]]; then
+    CONFIG_PATH="${REPO_ROOT}/project/configs/publish.json"
+  else
+    fail_pre "publish.json not found at '${REPO_ROOT}/publish.json' or '${REPO_ROOT}/project/configs/publish.json'"
+  fi
+fi
+
+[[ -f "${CONFIG_PATH}" ]] || fail_pre "publish config not found at '${CONFIG_PATH}'"
+command -v jq >/dev/null 2>&1 || fail_pre "jq is required but not found on PATH"
+
+# ---------------------------------------------------------------------------
+# Validate
+# ---------------------------------------------------------------------------
+if ! bash "${SCRIPT_DIR}/validate_droplet_env.sh" "${CONFIG_PATH}" "${TARGET_NAME}"; then
+  exit "${EXIT_ENV_INVALID}"
+fi
+
+# ---------------------------------------------------------------------------
+# Extract config values
+# ---------------------------------------------------------------------------
+TARGET_JSON="$(jq -c --arg t "${TARGET_NAME}" \
+  '.targets[]? | select(.name == $t and .type == "droplet")' \
+  "${CONFIG_PATH}")"
+
+DEPLOY_PATH="$(printf '%s' "${TARGET_JSON}" | jq -r '.droplet.deploy_path')"
+DEPLOY_BRANCH="$(printf '%s' "${TARGET_JSON}" | jq -r '.droplet.deploy_branch')"
+BUILD_CMD="$(printf '%s' "${TARGET_JSON}" | jq -r '.droplet.build_cmd // empty')"
+START_CMD="$(printf '%s' "${TARGET_JSON}" | jq -r '.droplet.start_cmd')"
+GITHUB_REPO="$(printf '%s' "${TARGET_JSON}" | jq -r '.droplet.github_repo')"
+SSH_KEY_SECRET="$(printf '%s' "${TARGET_JSON}" | jq -r '.secrets.ssh_key_secret')"
+KNOWN_HOSTS_SECRET="$(printf '%s' "${TARGET_JSON}" | jq -r '.secrets.known_hosts_secret')"
+
+# Conventional GH Actions secret names for host/user/port
+SSH_HOST_SECRET="DROPLET_SSH_HOST"
+SSH_USER_SECRET="DROPLET_SSH_USER"
+SSH_PORT_SECRET="DROPLET_SSH_PORT"
+
+# Keep GITHUB_REPO available for callers / future gh-trigger use.
+: "${GITHUB_REPO}"
+
+# ---------------------------------------------------------------------------
+# Generate workflow YAML
+# ---------------------------------------------------------------------------
+WORKFLOW_HEADER="$(cat <<EOF
+# Generated by /publish droplet pipeline -- do not edit manually
+name: "Publish -- ${TARGET_NAME} (Droplet)"
+on:
+  workflow_dispatch:
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Deploy via SSH
+        # appleboy/ssh-action pinned SHA: 4a13f365c4cb2c5a7b0a2e0a54db7a4a7b5f6fd1
+        uses: appleboy/ssh-action@4a13f365c4cb2c5a7b0a2e0a54db7a4a7b5f6fd1
+        with:
+          host: \${{ secrets.${SSH_HOST_SECRET} }}
+          username: \${{ secrets.${SSH_USER_SECRET} }}
+          port: \${{ secrets.${SSH_PORT_SECRET} }}
+          key: \${{ secrets.${SSH_KEY_SECRET} }}
+          known_hosts: \${{ secrets.${KNOWN_HOSTS_SECRET} }}
+          script: |
+            cd ${DEPLOY_PATH}
+            git pull origin ${DEPLOY_BRANCH}
+EOF
+)"
+
+# Build the script block lines separately so newlines are always present
+SCRIPT_LINES=""
+if [[ -n "${BUILD_CMD}" ]]; then
+  SCRIPT_LINES+="            ${BUILD_CMD}"$'\n'
+fi
+SCRIPT_LINES+="            ${START_CMD}"$'\n'
+
+WORKFLOW_YAML="${WORKFLOW_HEADER}"$'\n'"${SCRIPT_LINES}"
+
+# ---------------------------------------------------------------------------
+# Dry-run: print and exit
+# ---------------------------------------------------------------------------
+if (( DRY_RUN )); then
+  printf '%s' "${WORKFLOW_YAML}"
+  exit 0
+fi
+
+# ---------------------------------------------------------------------------
+# Write workflow file
+# ---------------------------------------------------------------------------
+WORKFLOW_DIR="${REPO_ROOT}/.github/workflows"
+WORKFLOW_FILE="${WORKFLOW_DIR}/publish-droplet.yml"
+
+mkdir -p "${WORKFLOW_DIR}"
+printf '%s' "${WORKFLOW_YAML}" > "${WORKFLOW_FILE}"
+
+# Commit only when the file actually changed
+if git -C "${REPO_ROOT}" diff --quiet -- ".github/workflows/publish-droplet.yml" 2>/dev/null && \
+   git -C "${REPO_ROOT}" diff --cached --quiet -- ".github/workflows/publish-droplet.yml" 2>/dev/null && \
+   git -C "${REPO_ROOT}" ls-files --error-unmatch ".github/workflows/publish-droplet.yml" >/dev/null 2>&1; then
+  printf 'Workflow unchanged, skipping commit.\n'
+  exit 0
+fi
+
+git -C "${REPO_ROOT}" add ".github/workflows/publish-droplet.yml"
+git -C "${REPO_ROOT}" commit -m "chore(publish): update droplet workflow for target ${TARGET_NAME}"
+printf 'Workflow committed: %s\n' "${WORKFLOW_FILE}"

package/skills/publish/scripts/generate_release_notes.sh

@@ -0,0 +1,200 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+source "$SCRIPT_DIR/publish_common.sh"
+
+usage() {
+  cat <<'USAGE'
+Usage: generate_release_notes.sh [--target <name>] [--from-tag <tag>] [--to-ref <git-ref>] [--output <path>] [<publish_json_path>]
+USAGE
+}
+
+TARGET_NAME=""
+FROM_TAG=""
+TO_REF="HEAD"
+OUTPUT_PATH=""
+CONFIG_PATH=""
+POSITIONAL_COUNT=0
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --target)
+      [[ $# -ge 2 ]] || { usage >&2; exit 1; }
+      TARGET_NAME="$2"
+      shift 2
+      ;;
+    --from-tag)
+      [[ $# -ge 2 ]] || { usage >&2; exit 1; }
+      FROM_TAG="$2"
+      shift 2
+      ;;
+    --to-ref)
+      [[ $# -ge 2 ]] || { usage >&2; exit 1; }
+      TO_REF="$2"
+      shift 2
+      ;;
+    --output)
+      [[ $# -ge 2 ]] || { usage >&2; exit 1; }
+      OUTPUT_PATH="$2"
+      shift 2
+      ;;
+    --help|-h)
+      usage
+      exit 0
+      ;;
+    --*)
+      usage >&2
+      exit 1
+      ;;
+    *)
+      POSITIONAL_COUNT=$((POSITIONAL_COUNT + 1))
+      if (( POSITIONAL_COUNT > 1 )); then
+        usage >&2
+        exit 1
+      fi
+      CONFIG_PATH="$1"
+      shift
+      ;;
+  esac
+done
+
+command -v jq >/dev/null 2>&1 || { echo 'jq is required.' >&2; exit 1; }
+
+git rev-parse --verify "$TO_REF" >/dev/null 2>&1 || {
+  echo "Unknown git ref: $TO_REF" >&2
+  exit 1
+}
+
+HISTORY_FILE="$(publish_resolve_history_file "$CONFIG_PATH")"
+LAST_TAG="$FROM_TAG"
+FIRST_RELEASE=0
+CUTOFF_DATE=""
+
+if [[ -z "$LAST_TAG" ]]; then
+  if LAST_TAG="$(publish_resolve_last_publish_tag "$HISTORY_FILE" "$TO_REF" 2>/dev/null || true)" && [[ -n "$LAST_TAG" ]]; then
+    :
+  else
+    LAST_TAG=""
+    FIRST_RELEASE=1
+  fi
+fi
+
+if [[ -n "$LAST_TAG" ]]; then
+  git rev-parse --verify "$LAST_TAG" >/dev/null 2>&1 || {
+    echo "Unknown git tag: $LAST_TAG" >&2
+    exit 1
+  }
+  CUTOFF_DATE="$(git log -1 --format=%cI "$LAST_TAG" 2>/dev/null | cut -dT -f1)"
+fi
+
+FEATURES=()
+BUG_FIXES=()
+OTHER=()
+
+if [[ -n "$LAST_TAG" ]]; then
+  LOG_RANGE=("$LAST_TAG..$TO_REF")
+else
+  LOG_RANGE=("$TO_REF")
+fi
+
+while IFS=$'\t' read -r subject short_sha || [[ -n "${subject:-}${short_sha:-}" ]]; do
+  [[ -z "${subject:-}" ]] && continue
+  line="- $subject ($short_sha)"
+  if printf '%s\n' "$subject" | grep -Eq '^feat(\([^)]+\))?!?: '; then
+    FEATURES+=("$line")
+  elif printf '%s\n' "$subject" | grep -Eq '^fix(\([^)]+\))?!?: '; then
+    BUG_FIXES+=("$line")
+  else
+    OTHER+=("$line")
+  fi
+done < <(git log "${LOG_RANGE[@]}" --pretty=format:'%s%x09%h')
+
+collect_completed_tasks() {
+  local cutoff_date="$1"
+  local tasks_dir="$PUBLISH_REPO_ROOT/project/board/tasks"
+  local collected=()
+  local task_file status completed_date task_id task_title
+
+  [[ -d "$tasks_dir" ]] || return 0
+
+  while IFS= read -r -d '' task_file; do
+    case "$task_file" in
+      *_INSTRUCTIONS.md) continue ;;
+    esac
+
+    status="$(awk '/^status: /{sub(/^status: /, ""); print; exit}' "$task_file" 2>/dev/null || true)"
+    [[ "$status" == "Passed" ]] || continue
+
+    completed_date="$(awk '/^date_completed: /{sub(/^date_completed: /, ""); print; exit}' "$task_file" 2>/dev/null || true)"
+    [[ -n "$completed_date" ]] || continue
+
+    if [[ -n "$cutoff_date" && "$completed_date" < "$cutoff_date" ]]; then
+      continue
+    fi
+
+    task_id="$(awk '/^id: /{sub(/^id: /, ""); print; exit}' "$task_file" 2>/dev/null || true)"
+    task_title="$(awk '/^title: /{sub(/^title: /, ""); print; exit}' "$task_file" 2>/dev/null || true)"
+    [[ -n "$task_id" ]] || continue
+    [[ -n "$task_title" ]] || task_title="$task_id"
+    collected+=("- $task_id — $task_title")
+  done < <(find "$tasks_dir" -maxdepth 1 -type f -name '*.md' -print0 2>/dev/null)
+
+  if (( ${#collected[@]} > 0 )); then
+    printf '%s\n' "${collected[@]}" | LC_ALL=C sort -u
+  fi
+}
+
+if [[ -z "$OUTPUT_PATH" ]]; then
+  OUTPUT_PATH="$(publish_temp_release_notes_path)"
+fi
+mkdir -p "$(dirname "$OUTPUT_PATH")"
+
+write_section() {
+  local heading="$1"
+  local array_name="$2"
+  local item_count
+
+  eval "item_count=\${#${array_name}[@]}"
+  {
+    printf '### %s\n' "$heading"
+    if (( item_count > 0 )); then
+      eval "printf '%s\\n' \"\${${array_name}[@]}\""
+    else
+      printf -- '- None\n'
+    fi
+    printf '\n'
+  } >> "$OUTPUT_PATH"
+}
+
+GENERATED_AT="$(date -u +"%Y-%m-%dT%H:%M:%SZ")"
+{
+  printf '# Release notes\n\n'
+  printf -- '- Generated: %s\n' "$GENERATED_AT"
+  if [[ -n "$TARGET_NAME" ]]; then
+    printf -- '- Target: %s\n' "$TARGET_NAME"
+  fi
+  if [[ -n "$LAST_TAG" ]]; then
+    printf -- '- Changes: %s..%s\n\n' "$LAST_TAG" "$TO_REF"
+  else
+    printf -- '- Changes: full history through %s\n\n' "$TO_REF"
+    if (( FIRST_RELEASE )); then
+      printf '> First release — full history included\n\n'
+    fi
+  fi
+} > "$OUTPUT_PATH"
+
+write_section 'Features' FEATURES
+write_section 'Bug Fixes' BUG_FIXES
+write_section 'Other' OTHER
+
+COMPLETED_TASKS="$(collect_completed_tasks "$CUTOFF_DATE" || true)"
+if [[ -n "$COMPLETED_TASKS" ]]; then
+  {
+    printf '### Completed tasks\n'
+    printf '%s\n' "$COMPLETED_TASKS"
+    printf '\n'
+  } >> "$OUTPUT_PATH"
+fi
+
+printf '📝 Release notes draft written to %s\n' "$OUTPUT_PATH"