@delorenj/pjangler 1.2.6 → 1.2.9

package/templates/hermes-agent/template/role.yaml.jinja

@@ -21,17 +21,14 @@ profile: {{ agent_id }}
 telegram:
   bot_username: "{{ bot_handle }}"
 
-# Ticket-provider binding (linear | plane | trello).
+# Ticket-provider binding (plane | trello).
 # The heartbeat reconciliation pass talks ONLY to this via .scripts/lib/ticket-provider.sh;
 # swapping providers is a one-line change here. Filled in by 42-ticket-provider.sh.
 ticket_provider:
   name: {{ ticket_provider }}
   board_id: ""
   board_url: ""
-{%- if ticket_provider == 'linear' %}
-  team: ""        # Linear team key, e.g. DEL  (set before first sentinel run)
-  project: ""     # optional Linear project name to scope milestones/issues
-{%- elif ticket_provider == 'plane' %}
+{%- if ticket_provider == 'plane' %}
   workspace: "{{ plane_workspace }}"
   project: ""     # Plane project uuid (set by 42-ticket-provider.sh)
 {%- elif ticket_provider == 'trello' %}
@@ -47,7 +44,7 @@ reconcile:
   grace_hours: 0             # 0 = no human-approval wait (adversarially-reviewed review-lane = done); set >0 to require a wait
   auto_review: true          # autonomous adversarial review (act, do not wait) on/off
 
-# Plane project (1:1 with this agent) — retained for fleet-registry back-compat.
+# Plane metadata — retained for fleet-registry back-compat when provider=plane.
 plane:
   # Empty -> resolved from ~/.config/hermes-agent-template/config.toml [plane].workspace
   workspace: "{{ plane_workspace }}"

package/templates/hermes-agent/template/.scripts/40-plane.sh

@@ -1,51 +0,0 @@
-#!/usr/bin/env bash
-# Create a Plane project in the configured workspace (one project per agent).
-# Workspace + base URL come from role.yaml / config.toml (see _lib.sh).
-# shellcheck source=_lib.sh
-source "$(dirname "$0")/_lib.sh"
-load_role_env
-
-already_done 40-plane && { log "[40] plane already set up — skipping"; exit 0; }
-[[ "${SKIP_PLANE:-0}" == "1" ]] && { log "[40] plane — SKIPPED"; mark_done 40-plane; exit 0; }
-
-[[ -n "$PLANE_API_KEY" ]] || { warn "[40] PLANE_API_KEY not set; skipping. set PLANE_33GOD_API_KEY and re-run ./.scripts/40-plane.sh"; exit 0; }
-
-# Build the 5-char identifier: <repo[0..2]><role[0..1]> uppercased
-RAW=$(printf '%s%s' "${REPO:0:3}" "${ROLE:0:2}" | tr -cd '[:alnum:]' | tr '[:lower:]' '[:upper:]')
-while (( ${#RAW} < 3 )); do RAW="${RAW}X"; done
-IDENT="${RAW:0:5}"
-
-# Project name = display_name (already smart-cased: "Bloodbank PM", "Hermes-Agent Dev").
-# Plane forbids hyphens in names — substitute spaces.
-NAME="${DISPLAY_NAME//-/ }"
-
-log "[40] creating plane project '$NAME' [$IDENT]"
-
-# Check for existing project with this identifier
-EXISTING=$(curl -sS "$PLANE_BASE/api/v1/workspaces/$PLANE_WORKSPACE/projects/?per_page=200" \
-  -H "X-API-Key: $PLANE_API_KEY" \
-  | python3 -c "
-import sys, json
-d = json.load(sys.stdin)
-ident = '$IDENT'
-for p in d.get('results', []):
-    if (p.get('identifier') or '').upper() == ident:
-        print(p['id']); break")
-
-if [[ -n "$EXISTING" ]]; then
-  log "    plane project $IDENT already exists (id=$EXISTING) — reusing"
-  PROJECT_ID="$EXISTING"
-else
-  RESP=$(curl -sS -X POST "$PLANE_BASE/api/v1/workspaces/$PLANE_WORKSPACE/projects/" \
-    -H "X-API-Key: $PLANE_API_KEY" \
-    -H "Content-Type: application/json" \
-    -d "$(python3 -c "import json,sys; print(json.dumps({'name': sys.argv[1], 'identifier': sys.argv[2], 'description': sys.argv[3]}))" \
-        "$NAME" "$IDENT" "Hermes agent board for $AGENT_ID")")
-  PROJECT_ID=$(echo "$RESP" | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('id') or '')")
-  [[ -n "$PROJECT_ID" ]] || die "plane create failed: $RESP"
-  log "    plane project created id=$PROJECT_ID"
-fi
-
-yaml_set plane.identifier "$IDENT"
-echo "$PROJECT_ID" > "$ROLE_DIR/.scripts/.plane-project-id"
-mark_done 40-plane

package/templates/hermes-agent/template/.scripts/providers/linear.sh

@@ -1,176 +0,0 @@
-#!/usr/bin/env sh
-# Linear ticket-provider adapter (reference implementation).
-#
-# Credentials:  LINEAR_API_KEY
-# Board binding (role.yaml `ticket_provider:`):
-#   name: linear
-#   team:    <TEAM_KEY>          e.g. DEL
-#   project: "<Project name>"    optional; scopes milestone/issue queries
-#   state_map: { in_review: "In Review", completed: "Done" }   optional overrides
-#
-# Implements the contract in lib/ticket-provider.sh. All Linear access goes
-# through GraphQL so the same envelope works in unattended runs.
-set -eu
-
-OP="${1:-}"; shift 2>/dev/null || true
-ROLE_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
-ROLE_YAML="$ROLE_DIR/role.yaml"
-
-die() { echo "linear: $*" >&2; exit 1; }
-need_key() { [ -n "${LINEAR_API_KEY:-}" ] || die "LINEAR_API_KEY is not set"; }
-
-# tp_cfg KEY — read ticket_provider.<KEY> from role.yaml (best-effort, flat).
-tp_cfg() {
-  [ -f "$ROLE_YAML" ] || return 0
-  python3 - "$ROLE_YAML" "$1" <<'PY'
-import sys, re, pathlib
-text = pathlib.Path(sys.argv[1]).read_text()
-m = re.search(r'(?ms)^ticket_provider:\s*$(.*?)(?=^\S)', text + "\n\x00")
-block = m.group(1) if m else ""
-key = sys.argv[2]
-mm = re.search(rf'(?m)^\s*{re.escape(key)}:\s*"?([^"\n]*)"?\s*$', block)
-print(mm.group(1).strip() if mm else "")
-PY
-}
-
-# pj_cfg KEY — read ticket_provider.<KEY> from the repo-root .project.json (the
-# SOT), walking up from the role dir. Preferred over role.yaml.
-pj_cfg() {
-  python3 - "$ROLE_DIR" "$1" <<'PY'
-import sys, json, pathlib
-start = pathlib.Path(sys.argv[1]).resolve(); key = sys.argv[2]
-for parent in [start, *start.parents]:
-    f = parent / ".project.json"
-    if f.is_file():
-        try: tp = (json.loads(f.read_text()).get("ticket_provider") or {})
-        except Exception: tp = {}
-        print(tp.get(key, "") if isinstance(tp, dict) else ""); break
-else:
-    print("")
-PY
-}
-
-# gql QUERY [VARS_JSON] — POST a GraphQL request, print data JSON, fail on errors.
-gql() {
-  need_key
-  _vars="${2:-}"; [ -n "$_vars" ] || _vars='{}'
-  python3 - "$1" "$_vars" <<'PY'
-import json, os, sys, urllib.request, urllib.error
-q, variables = sys.argv[1], json.loads(sys.argv[2])
-req = urllib.request.Request(
-    "https://api.linear.app/graphql",
-    data=json.dumps({"query": q, "variables": variables}).encode(),
-    headers={"Authorization": os.environ["LINEAR_API_KEY"],
-             "Content-Type": "application/json"},
-    method="POST")
-try:
-    body = json.loads(urllib.request.urlopen(req, timeout=30).read())
-except urllib.error.HTTPError as e:
-    body = json.loads(e.read() or "{}")
-except urllib.error.URLError as e:
-    print(f"linear request failed: {e}", file=sys.stderr); sys.exit(1)
-if body.get("errors"):
-    print(json.dumps(body["errors"]), file=sys.stderr); sys.exit(1)
-print(json.dumps(body.get("data") or {}))
-PY
-}
-
-TEAM="$(pj_cfg team)"; [ -n "$TEAM" ] || TEAM="$(tp_cfg team)"
-PROJECT="$(pj_cfg project)"; [ -n "$PROJECT" ] || PROJECT="$(tp_cfg project)"
-SM_IN_REVIEW="$(tp_cfg in_review)"; SM_IN_REVIEW="${SM_IN_REVIEW:-In Review}"
-SM_DONE="$(tp_cfg completed)"; SM_DONE="${SM_DONE:-Done}"
-
-# All Linear ops require the API key; fail fast and clean before any pipe.
-need_key
-
-case "$OP" in
-  resolve)
-    [ -n "$TEAM" ] || die "ticket_provider.team (Linear team key) not set in role.yaml"
-    gql 'query($k:String!){ teams(filter:{key:{eq:$k}}){nodes{id key name}} }' \
-        "$(printf '{"k":"%s"}' "$TEAM")" \
-      | python3 -c 'import sys,json; d=json.load(sys.stdin); t=(d.get("teams",{}).get("nodes") or [{}])[0]; print(json.dumps({"provider":"linear","board_id":t.get("id",""),"board_url":"https://linear.app/team/"+t.get("key","")}))'
-    ;;
-
-  active_milestone)
-    # Linear project milestones; pick the first non-completed milestone in the project.
-    gql 'query($p:String){ projects(filter:{name:{eq:$p}}){nodes{ id name projectMilestones{nodes{id name targetDate}} state }} }' \
-        "$(printf '{"p":"%s"}' "$PROJECT")" \
-      | python3 -c 'import sys,json
-d=json.load(sys.stdin); ps=d.get("projects",{}).get("nodes") or []
-p=ps[0] if ps else {}
-ms=(p.get("projectMilestones",{}) or {}).get("nodes") or []
-m=ms[0] if ms else {"id":p.get("id",""),"name":p.get("name","")}
-print(json.dumps({"id":m.get("id",""),"name":m.get("name",""),"state":p.get("state","")}))'
-    ;;
-
-  list_issues)
-    [ -n "$TEAM" ] || die "ticket_provider.team not set"
-    gql 'query($k:String!){ issues(first:100, filter:{team:{key:{eq:$k}}}){nodes{ id identifier title updatedAt url state{name type} assignee{name} }} }' \
-        "$(printf '{"k":"%s"}' "$TEAM")" \
-      | python3 -c 'import sys,json
-d=json.load(sys.stdin); out=[]
-for n in d.get("issues",{}).get("nodes") or []:
-    st=n.get("state") or {}
-    out.append({"id":n["id"],"key":n.get("identifier",""),"title":n.get("title",""),
-                "state":st.get("name",""),"state_type":st.get("type",""),
-                "updated_at":n.get("updatedAt",""),
-                "assignee":(n.get("assignee") or {}).get("name",""),"url":n.get("url","")})
-print(json.dumps(out))'
-    ;;
-
-  get_issue)
-    ID="${1:?usage: get_issue <id>}"
-    gql 'query($id:String!){ issue(id:$id){ id identifier title description state{name type} comments{nodes{id body user{name}}} } }' \
-        "$(printf '{"id":"%s"}' "$ID")" \
-      | python3 -c 'import sys,json
-d=json.load(sys.stdin); i=d.get("issue") or {}
-st=i.get("state") or {}
-cs=[{"id":c["id"],"body":c.get("body",""),"author":(c.get("user") or {}).get("name","")} for c in (i.get("comments",{}) or {}).get("nodes") or []]
-print(json.dumps({"id":i.get("id",""),"key":i.get("identifier",""),"title":i.get("title",""),
-                  "description":i.get("description",""),"acceptance":i.get("description",""),
-                  "state":st.get("name",""),"state_type":st.get("type",""),"comments":cs}))'
-    ;;
-
-  comment)
-    ID="${1:?usage: comment <id> <body>}"; BODY="${2:?usage: comment <id> <body>}"
-    gql 'mutation($id:String!,$b:String!){ commentCreate(input:{issueId:$id,body:$b}){ comment{id} success } }' \
-        "$(python3 -c 'import json,sys; print(json.dumps({"id":sys.argv[1],"b":sys.argv[2]}))' "$ID" "$BODY")" \
-      | python3 -c 'import sys,json; d=json.load(sys.stdin); print((d.get("commentCreate",{}).get("comment") or {}).get("id",""))'
-    ;;
-
-  transition)
-    ID="${1:?usage: transition <id> <normalized-state>}"; TARGET="${2:?}"
-    # Map normalized -> a concrete Linear state name, then resolve its id on the team.
-    case "$TARGET" in
-      completed)  WANT_TYPE=completed; WANT_NAME="$SM_DONE" ;;
-      in_review)  WANT_TYPE=started;   WANT_NAME="$SM_IN_REVIEW" ;;
-      started)    WANT_TYPE=started;   WANT_NAME="" ;;
-      unstarted)  WANT_TYPE=unstarted; WANT_NAME="" ;;
-      backlog)    WANT_TYPE=backlog;   WANT_NAME="" ;;
-      *) die "invalid normalized state: $TARGET" ;;
-    esac
-    STATE_ID="$(gql 'query($id:String!){ issue(id:$id){ team{ states{nodes{id name type}} } } }' \
-        "$(printf '{"id":"%s"}' "$ID")" \
-      | WANT_TYPE="$WANT_TYPE" WANT_NAME="$WANT_NAME" python3 -c 'import sys,json,os
-d=json.load(sys.stdin)
-states=((d.get("issue") or {}).get("team") or {}).get("states",{}).get("nodes") or []
-want_t=os.environ["WANT_TYPE"]; want_n=os.environ.get("WANT_NAME","")
-named=[s for s in states if want_n and s["name"].lower()==want_n.lower()]
-typed=[s for s in states if s.get("type")==want_t]
-pick=(named or typed or [{}])[0]
-print(pick.get("id",""))')"
-    [ -n "$STATE_ID" ] || die "no Linear state for normalized '$TARGET'"
-    gql 'mutation($id:String!,$s:String!){ issueUpdate(id:$id,input:{stateId:$s}){ success issue{identifier state{name}} } }' \
-        "$(python3 -c 'import json,sys; print(json.dumps({"id":sys.argv[1],"s":sys.argv[2]}))' "$ID" "$STATE_ID")" \
-      | python3 -c 'import sys,json; u=json.load(sys.stdin).get("issueUpdate",{});
-print(("ok " + (u.get("issue") or {}).get("identifier","")) if u.get("success") else "FAILED"); sys.exit(0 if u.get("success") else 1)'
-    ;;
-
-  create_board)
-    # Linear teams/projects are created by humans; the adapter resolves, not creates.
-    echo "linear: create_board is a no-op (Linear team/project created via Linear UI); using resolve" >&2
-    exec sh "$0" resolve
-    ;;
-
-  *) die "unknown op: $OP" ;;
-esac