add hive-forge-tools: shell wrappers for common forge API operations
This commit is contained in:
damocles
Mara
parent
d348ce885f
commit
0a4cde88b0
2 changed files with 276 additions and 0 deletions
272
nix/packages/hive-forge-tools.nix
Normal file
272
nix/packages/hive-forge-tools.nix
Normal file
|
|
@ -0,0 +1,272 @@
|
||||||
|
{ pkgs, lib }:
|
||||||
|
# Small shell wrappers that replace ad-hoc curl pipelines for
|
||||||
|
# common Forgejo API operations. Every script reads credentials
|
||||||
|
# from the environment:
|
||||||
|
#
|
||||||
|
# HIVE_FORGE_URL -- base URL, e.g. http://localhost:3000
|
||||||
|
# HIVE_FORGE_REPO -- default repo, e.g. hyperhive/hyperhive
|
||||||
|
# HYPERHIVE_STATE_DIR -- state dir; forge-token lives here
|
||||||
|
#
|
||||||
|
# All scripts exit non-zero on HTTP errors and print diagnostics
|
||||||
|
# to stderr.
|
||||||
|
let
|
||||||
|
# Common prologue injected into every script: reads token and
|
||||||
|
# defines forge_get / forge_post / forge_patch / forge_delete.
|
||||||
|
commonPrologue = ''
|
||||||
|
: "''${HIVE_FORGE_URL:=http://localhost:3000}"
|
||||||
|
: "''${HIVE_FORGE_REPO:=hyperhive/hyperhive}"
|
||||||
|
_state_dir="''${HYPERHIVE_STATE_DIR:-}"
|
||||||
|
_token_file="''${_state_dir:+$_state_dir/}forge-token"
|
||||||
|
if [ ! -f "$_token_file" ]; then
|
||||||
|
echo "hive-forge: no forge-token at $_token_file" >&2
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
_token=$(cat "$_token_file")
|
||||||
|
FORGE_API="$HIVE_FORGE_URL/api/v1"
|
||||||
|
|
||||||
|
forge_get() {
|
||||||
|
${pkgs.curl}/bin/curl -sf \
|
||||||
|
-H "Authorization: token $_token" \
|
||||||
|
-H "Accept: application/json" \
|
||||||
|
"$1"
|
||||||
|
}
|
||||||
|
|
||||||
|
forge_post() {
|
||||||
|
${pkgs.curl}/bin/curl -sf -X POST \
|
||||||
|
-H "Authorization: token $_token" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-H "Accept: application/json" \
|
||||||
|
-d "$2" "$1"
|
||||||
|
}
|
||||||
|
|
||||||
|
forge_patch() {
|
||||||
|
${pkgs.curl}/bin/curl -sf -X PATCH \
|
||||||
|
-H "Authorization: token $_token" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-H "Accept: application/json" \
|
||||||
|
-d "$2" "$1"
|
||||||
|
}
|
||||||
|
|
||||||
|
forge_delete() {
|
||||||
|
local _url="$1"
|
||||||
|
local _body="''${2:-}"
|
||||||
|
if [ -n "$_body" ]; then
|
||||||
|
${pkgs.curl}/bin/curl -sf -X DELETE \
|
||||||
|
-H "Authorization: token $_token" \
|
||||||
|
-H "Content-Type: application/json" \
|
||||||
|
-H "Accept: application/json" \
|
||||||
|
-d "$_body" "$_url"
|
||||||
|
else
|
||||||
|
${pkgs.curl}/bin/curl -sf -X DELETE \
|
||||||
|
-H "Authorization: token $_token" \
|
||||||
|
-H "Accept: application/json" \
|
||||||
|
"$_url"
|
||||||
|
fi
|
||||||
|
}
|
||||||
|
'';
|
||||||
|
|
||||||
|
mkScript = name: text:
|
||||||
|
pkgs.writeShellApplication {
|
||||||
|
inherit name;
|
||||||
|
runtimeInputs = [ pkgs.curl pkgs.jq ];
|
||||||
|
text = commonPrologue + "\n" + text;
|
||||||
|
};
|
||||||
|
in
|
||||||
|
pkgs.symlinkJoin {
|
||||||
|
name = "hive-forge-tools";
|
||||||
|
paths = [
|
||||||
|
|
||||||
|
# hive-forge-view <number> [repo]
|
||||||
|
# Dump title + body + all comments for an issue or PR.
|
||||||
|
(mkScript "hive-forge-view" ''
|
||||||
|
if [ $# -lt 1 ]; then
|
||||||
|
echo "usage: hive-forge-view <number> [repo]" >&2; exit 1
|
||||||
|
fi
|
||||||
|
_n="$1"
|
||||||
|
_repo="''${2:-$HIVE_FORGE_REPO}"
|
||||||
|
|
||||||
|
_issue=$(forge_get "$FORGE_API/repos/$_repo/issues/$_n")
|
||||||
|
_title=$(printf '%s' "$_issue" | jq -r '.title')
|
||||||
|
_body=$(printf '%s' "$_issue" | jq -r '.body // ""')
|
||||||
|
_state=$(printf '%s' "$_issue" | jq -r '.state')
|
||||||
|
_user=$(printf '%s' "$_issue" | jq -r '.user.login')
|
||||||
|
_is_pr=$(printf '%s' "$_issue" | jq -r '.pull_request != null')
|
||||||
|
|
||||||
|
_kind="issue"
|
||||||
|
if [ "$_is_pr" = "true" ]; then _kind="PR"; fi
|
||||||
|
|
||||||
|
printf '# %s #%s [%s] by %s\n' "$_kind" "$_n" "$_state" "$_user"
|
||||||
|
printf '%s\n' "$_title"
|
||||||
|
if [ -n "$_body" ]; then
|
||||||
|
printf '\n%s\n' "$_body"
|
||||||
|
fi
|
||||||
|
|
||||||
|
_comments=$(forge_get "$FORGE_API/repos/$_repo/issues/$_n/comments?limit=50")
|
||||||
|
_count=$(printf '%s' "$_comments" | jq 'length')
|
||||||
|
if [ "$_count" -gt 0 ]; then
|
||||||
|
printf '\n---\n## Comments (%s)\n\n' "$_count"
|
||||||
|
printf '%s' "$_comments" | jq -r '.[] | "**\(.user.login)**: \(.body)\n"'
|
||||||
|
fi
|
||||||
|
'')
|
||||||
|
|
||||||
|
# hive-forge-issue <number> [repo]
|
||||||
|
# Print key fields of an issue as JSON.
|
||||||
|
(mkScript "hive-forge-issue" ''
|
||||||
|
if [ $# -lt 1 ]; then
|
||||||
|
echo "usage: hive-forge-issue <number> [repo]" >&2; exit 1
|
||||||
|
fi
|
||||||
|
_n="$1"
|
||||||
|
_repo="''${2:-$HIVE_FORGE_REPO}"
|
||||||
|
forge_get "$FORGE_API/repos/$_repo/issues/$_n" \
|
||||||
|
| jq '{number,title,state,user:.user.login,assignees:[.assignees[]?.login],labels:[.labels[]?.name],body}'
|
||||||
|
'')
|
||||||
|
|
||||||
|
# hive-forge-pr <number> [repo]
|
||||||
|
# Print key fields of a PR as JSON.
|
||||||
|
(mkScript "hive-forge-pr" ''
|
||||||
|
if [ $# -lt 1 ]; then
|
||||||
|
echo "usage: hive-forge-pr <number> [repo]" >&2; exit 1
|
||||||
|
fi
|
||||||
|
_n="$1"
|
||||||
|
_repo="''${2:-$HIVE_FORGE_REPO}"
|
||||||
|
forge_get "$FORGE_API/repos/$_repo/pulls/$_n" \
|
||||||
|
| jq '{number,title,state,merged,user:.user.login,head_sha:.head.sha,head_branch:.head.label,base_branch:.base.label}'
|
||||||
|
'')
|
||||||
|
|
||||||
|
# hive-forge-comment <number> [body | -f <file> | - for stdin]
|
||||||
|
# Post a comment on an issue or PR. Body can be passed as:
|
||||||
|
# - trailing args (joined with spaces)
|
||||||
|
# - -f <file> to read from a file
|
||||||
|
# - - or no args to read from stdin
|
||||||
|
(mkScript "hive-forge-comment" ''
|
||||||
|
if [ $# -lt 1 ]; then
|
||||||
|
echo "usage: hive-forge-comment <number> [body | -f <file> | -]" >&2; exit 1
|
||||||
|
fi
|
||||||
|
_n="$1"; shift
|
||||||
|
|
||||||
|
if [ $# -eq 0 ] || [ "''${1:-}" = "-" ]; then
|
||||||
|
_body=$(cat)
|
||||||
|
elif [ "''${1:-}" = "-f" ]; then
|
||||||
|
_body=$(cat "$2")
|
||||||
|
else
|
||||||
|
_body="$*"
|
||||||
|
fi
|
||||||
|
|
||||||
|
_payload=$(jq -n --arg body "$_body" '{body:$body}')
|
||||||
|
forge_post "$FORGE_API/repos/$HIVE_FORGE_REPO/issues/$_n/comments" "$_payload" \
|
||||||
|
| jq '{id,url:.html_url}'
|
||||||
|
'')
|
||||||
|
|
||||||
|
# hive-forge-assign <number> <user> [--remove]
|
||||||
|
# Assign or unassign a user on an issue or PR.
|
||||||
|
(mkScript "hive-forge-assign" ''
|
||||||
|
if [ $# -lt 2 ]; then
|
||||||
|
echo "usage: hive-forge-assign <number> <user> [--remove]" >&2; exit 1
|
||||||
|
fi
|
||||||
|
_n="$1"; _user="$2"; _remove="''${3:-}"
|
||||||
|
|
||||||
|
_payload=$(jq -n --arg u "$_user" '{assignees:[$u]}')
|
||||||
|
if [ "$_remove" = "--remove" ]; then
|
||||||
|
forge_delete "$FORGE_API/repos/$HIVE_FORGE_REPO/issues/$_n/assignees" "$_payload" \
|
||||||
|
| jq '{number,assignees:[.assignees[]?.login]}'
|
||||||
|
else
|
||||||
|
forge_post "$FORGE_API/repos/$HIVE_FORGE_REPO/issues/$_n/assignees" "$_payload" \
|
||||||
|
| jq '{number,assignees:[.assignees[]?.login]}'
|
||||||
|
fi
|
||||||
|
'')
|
||||||
|
|
||||||
|
# hive-forge-close <number>
|
||||||
|
# Close an issue or PR.
|
||||||
|
(mkScript "hive-forge-close" ''
|
||||||
|
if [ $# -lt 1 ]; then
|
||||||
|
echo "usage: hive-forge-close <number>" >&2; exit 1
|
||||||
|
fi
|
||||||
|
forge_patch "$FORGE_API/repos/$HIVE_FORGE_REPO/issues/$1" '{"state":"closed"}' \
|
||||||
|
| jq '{number,state}'
|
||||||
|
'')
|
||||||
|
|
||||||
|
# hive-forge-labels <number> [list | add <label...> | remove <label...>]
|
||||||
|
# Manage labels on an issue or PR. Default action is list.
|
||||||
|
(mkScript "hive-forge-labels" ''
|
||||||
|
if [ $# -lt 1 ]; then
|
||||||
|
echo "usage: hive-forge-labels <number> [list|add|remove] [labels...]" >&2; exit 1
|
||||||
|
fi
|
||||||
|
_n="$1"; _action="''${2:-list}"
|
||||||
|
shift; shift || true
|
||||||
|
|
||||||
|
case "$_action" in
|
||||||
|
list)
|
||||||
|
forge_get "$FORGE_API/repos/$HIVE_FORGE_REPO/issues/$_n/labels" \
|
||||||
|
| jq '[.[].name]'
|
||||||
|
;;
|
||||||
|
add)
|
||||||
|
_all=$(forge_get "$FORGE_API/repos/$HIVE_FORGE_REPO/labels?limit=100")
|
||||||
|
_ids=$(printf '%s' "$_all" | jq -r --args '[.[] | select(.name == ($ARGS.positional[])) | .id]' -- "$@")
|
||||||
|
forge_post "$FORGE_API/repos/$HIVE_FORGE_REPO/issues/$_n/labels" "{\"labels\":$_ids}" \
|
||||||
|
| jq '[.[].name]'
|
||||||
|
;;
|
||||||
|
remove)
|
||||||
|
_all=$(forge_get "$FORGE_API/repos/$HIVE_FORGE_REPO/labels?limit=100")
|
||||||
|
for _label in "$@"; do
|
||||||
|
_id=$(printf '%s' "$_all" | jq -r --arg n "$_label" '.[] | select(.name==$n) | .id')
|
||||||
|
if [ -n "$_id" ]; then
|
||||||
|
forge_delete "$FORGE_API/repos/$HIVE_FORGE_REPO/issues/$_n/labels/$_id"
|
||||||
|
fi
|
||||||
|
done
|
||||||
|
forge_get "$FORGE_API/repos/$HIVE_FORGE_REPO/issues/$_n/labels" \
|
||||||
|
| jq '[.[].name]'
|
||||||
|
;;
|
||||||
|
*)
|
||||||
|
echo "unknown action: $_action (use list, add, remove)" >&2; exit 1
|
||||||
|
;;
|
||||||
|
esac
|
||||||
|
'')
|
||||||
|
|
||||||
|
# hive-forge-pr-reviews <number> [repo]
|
||||||
|
# List reviews on a PR with id/state/user/body.
|
||||||
|
(mkScript "hive-forge-pr-reviews" ''
|
||||||
|
if [ $# -lt 1 ]; then
|
||||||
|
echo "usage: hive-forge-pr-reviews <number> [repo]" >&2; exit 1
|
||||||
|
fi
|
||||||
|
_n="$1"
|
||||||
|
_repo="''${2:-$HIVE_FORGE_REPO}"
|
||||||
|
forge_get "$FORGE_API/repos/$_repo/pulls/$_n/reviews" \
|
||||||
|
| jq '[.[] | {id,state,user:.user.login,body,comments_count}]'
|
||||||
|
'')
|
||||||
|
|
||||||
|
# hive-forge-branches [pattern] [repo]
|
||||||
|
# List branches, optionally filtered by a grep pattern.
|
||||||
|
(mkScript "hive-forge-branches" ''
|
||||||
|
_pattern="''${1:-}"
|
||||||
|
_repo="''${2:-$HIVE_FORGE_REPO}"
|
||||||
|
_result=$(forge_get "$FORGE_API/repos/$_repo/branches?limit=100" \
|
||||||
|
| jq -r '.[].name')
|
||||||
|
if [ -n "$_pattern" ]; then
|
||||||
|
printf '%s\n' "$_result" | grep "$_pattern" || true
|
||||||
|
else
|
||||||
|
printf '%s\n' "$_result"
|
||||||
|
fi
|
||||||
|
'')
|
||||||
|
|
||||||
|
# hive-forge-tree-sha <ref> [repo]
|
||||||
|
# Print the tree SHA of the commit at the given branch or commit SHA.
|
||||||
|
(mkScript "hive-forge-tree-sha" ''
|
||||||
|
if [ $# -lt 1 ]; then
|
||||||
|
echo "usage: hive-forge-tree-sha <ref> [repo]" >&2; exit 1
|
||||||
|
fi
|
||||||
|
_ref="$1"
|
||||||
|
_repo="''${2:-$HIVE_FORGE_REPO}"
|
||||||
|
# Resolve branch -> commit SHA first, then get the tree SHA
|
||||||
|
# from the git commit object (tree.sha field).
|
||||||
|
_commit_sha=$(forge_get "$FORGE_API/repos/$_repo/branches/$_ref" 2>/dev/null \
|
||||||
|
| jq -r '.commit.id // empty') || true
|
||||||
|
if [ -z "$_commit_sha" ]; then
|
||||||
|
# Assume it's already a commit SHA
|
||||||
|
_commit_sha="$_ref"
|
||||||
|
fi
|
||||||
|
forge_get "$FORGE_API/repos/$_repo/git/commits/$_commit_sha" \
|
||||||
|
| jq -r '.tree.sha // .sha'
|
||||||
|
'')
|
||||||
|
|
||||||
|
];
|
||||||
|
}
|
||||||
|
|
@ -273,6 +273,10 @@
|
||||||
jq
|
jq
|
||||||
# curl: HTTP client for forge REST API and other web requests.
|
# curl: HTTP client for forge REST API and other web requests.
|
||||||
curl
|
curl
|
||||||
|
# hive-forge-*: shell wrappers around the Forgejo REST API
|
||||||
|
# (hive-forge-view, hive-forge-pr, hive-forge-comment, etc.)
|
||||||
|
# that replace ad-hoc curl pipelines in agent turns.
|
||||||
|
(pkgs.callPackage ../packages/hive-forge-tools.nix { })
|
||||||
];
|
];
|
||||||
|
|
||||||
# One-shot: write tea's config.yml from the seeded forge token so
|
# One-shot: write tea's config.yml from the seeded forge token so
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue