@delorenj/pjangler 1.2.4 → 1.2.8

package/templates/hermes-agent/docs/sentinel/providers.md

@@ -1,7 +1,7 @@
 # Provider adapters
 
 This guide is the reference for the ticket-provider abstraction: the contract
-every adapter implements, the three adapters that ship today, and a
+every adapter implements, the two adapters that ship today, and a
 step-by-step process for adding a new provider or verifying an existing one
 against a live board. Read [Architecture](architecture.md) first for how the
 adapter fits into the engine.
@@ -43,12 +43,8 @@ maps each to its back end's concrete state.
 
 ## The adapters that ship today
 
-The repository includes three adapters with different verification status.
+The repository includes two supported adapters with different verification status.
 
-- **Linear** (`providers/linear.sh`) is the reference implementation. It uses
-  the Linear GraphQL API. It's verified live against a real board. Linear's
-  `issue(id:)` field accepts both the UUID and the human identifier (for
-  example, `DEL-42`), so the engine can pass identifiers through.
 - **Plane** (`providers/plane.sh`) uses the Plane REST API with `X-API-Key`
   authentication. A Plane project maps to the board, a cycle maps to the
   milestone, and `state.group` maps to the state type. It's verified live. Note
@@ -64,21 +60,6 @@ The repository includes three adapters with different verification status.
 
 Set credentials in the environment and the board binding in `role.yaml`.
 
-<details>
-<summary>Linear</summary>
-
-- Credentials: `LINEAR_API_KEY`.
-- Binding:
-
-  ```yaml
-  ticket_provider:
-    name: linear
-    team: DEL # Linear team key
-    project: "" # optional, scopes milestone and issue queries
-  ```
-
-</details>
-
 <details>
 <summary>Plane</summary>
 
@@ -114,8 +95,9 @@ Set credentials in the environment and the board binding in `role.yaml`.
 
 To add a fourth provider, for example GitHub Issues or Jira, follow these steps.
 
-1. Create `template/.scripts/providers/<name>.sh`. Start from `linear.sh` if the
-   back end uses GraphQL, or `plane.sh` if it uses REST with a single API key.
+1. Create `template/.scripts/providers/<name>.sh`. Start from `plane.sh` if it
+   uses REST with a single API key, or `trello.sh` if it has a board/list/card
+   model.
 2. Implement every operation in [the contract](#the-contract). Return the exact
    JSON shapes shown in the table. Map your back end's states to the five
    normalized states.
@@ -127,8 +109,7 @@ To add a fourth provider, for example GitHub Issues or Jira, follow these steps.
 5. Extend `template/role.yaml.jinja` with a provider-specific binding block
    under the `{% if ticket_provider == '<name>' %}` branch.
 6. Teach `42-ticket-provider.sh` how to resolve or create the board for your
-   provider, if it differs from the existing `linear`, `plane`, and `trello`
-   cases.
+   provider, if it differs from the existing `plane` and `trello` cases.
 7. Validate and verify with the steps below.
 
 <!-- prettier-ignore -->
@@ -158,7 +139,7 @@ Before you touch a live board, confirm the adapter parses and fails cleanly.
    exit, with no Python traceback:
 
    ```bash
-   ( unset LINEAR_API_KEY; sh template/.scripts/providers/linear.sh resolve )
+   ( unset PLANE_API_KEY; sh template/.scripts/providers/plane.sh resolve )
    ```
 
 ## Verifying an adapter against a live board
@@ -169,15 +150,15 @@ never closes or modifies a ticket, so it's safe to run.
 
 ```bash
 # 1. Load the credential into the environment only (never print it).
-export LINEAR_API_KEY="$(grep -E '^(export )?LINEAR_API_KEY=' \
-  ~/.hermes/<agent>.env | head -1 | sed -E 's/^(export )?LINEAR_API_KEY=//; s/^"//; s/"$//')"
+export PLANE_API_KEY="$(grep -E '^(export )?PLANE_API_KEY=' \
+  ~/.hermes/<agent>.env | head -1 | sed -E 's/^(export )?PLANE_API_KEY=//; s/^"//; s/"$//')"
 
 # 2. Stage a role directory bound to the real board.
 T=$(mktemp -d); RD="$T/agents/hermes/pm"
 mkdir -p "$RD/.scripts/lib" "$RD/.scripts/providers"
 cp template/.scripts/lib/ticket-provider.sh "$RD/.scripts/lib/"
-cp template/.scripts/providers/linear.sh "$RD/.scripts/providers/"
-printf 'repo: demo\nrole: pm\nticket_provider:\n  name: linear\n  team: DEL\n' \
+cp template/.scripts/providers/plane.sh "$RD/.scripts/providers/"
+printf 'repo: demo\nrole: pm\nticket_provider:\n  name: plane\n  workspace: 33god\n  project: <project-uuid>\n' \
   > "$RD/role.yaml"
 
 # 3. Run the read operations.
@@ -199,5 +180,4 @@ verification.
 ## Read next
 
 - [Development guide](development.md): the full edit, validate, and propagate
-  workflow, plus the open roadmap, which includes live-verifying Plane and
-  Trello.
+  workflow, plus the open roadmap, which includes live-verifying Trello.

package/templates/hermes-agent/install-local.sh

@@ -15,10 +15,10 @@
 #
 # Environment overrides (skip the prompts):
 #   HAT_REPO=<name>            project/repo name (default: basename of CWD)
-#   HAT_PROVIDER=linear|plane|trello   (default: plane)
+#   HAT_PROVIDER=plane|trello   (default: plane)
 #   HAT_ROLES="pm"                     roles to install (default: pm)
 #   HAT_DRY_RUN=1              print actions, change nothing
-#   Provider creds: LINEAR_API_KEY | PLANE_API_KEY+PLANE_BASE | TRELLO_KEY+TRELLO_TOKEN
+#   Provider creds: PLANE_API_KEY+PLANE_BASE | TRELLO_KEY+TRELLO_TOKEN
 set -eu
 
 say()  { printf '\033[36m%s\033[0m\n' "$*"; }
@@ -100,7 +100,7 @@ TOML
 fi
 
 # --- 4. Provider credentials + board binding ---------------------------------
-ask HAT_PROVIDER "Ticket provider (linear|plane|trello)" "plane"
+ask HAT_PROVIDER "Ticket provider (plane|trello)" "plane"
 PROVIDER="$HAT_PROVIDER"
 ask HAT_REPO "Project/repo name" "$(basename "$PROJECT_DIR" | tr '[:upper:]' '[:lower:]')"
 REPO="$HAT_REPO"
@@ -109,7 +109,7 @@ PM_ENV="$HOME/.hermes/${REPO}-pm.env"
 # These get written into the pm role.yaml binding after render.
 # Pre-seed from optional env knobs so the install can run non-interactively.
 TP_WORKSPACE="${HAT_PLANE_WORKSPACE:-}"; TP_PROJECT="${HAT_PLANE_PROJECT:-}"
-TP_TEAM="${HAT_LINEAR_TEAM:-}"; TP_BOARD="${HAT_TRELLO_BOARD:-}"
+TP_BOARD="${HAT_TRELLO_BOARD:-}"
 case "$PROVIDER" in
   plane)
     ask PLANE_BASE "Plane base URL" "https://app.plane.so"
@@ -136,12 +136,6 @@ PY
     CRED_LINES="PLANE_API_KEY=$PLANE_API_KEY
 PLANE_BASE=$PLANE_BASE"
     ;;
-  linear)
-    : "${LINEAR_API_KEY:?Set LINEAR_API_KEY in your environment, then re-run}"
-    ask TP_TEAM "Linear team key (for example DEL)" ""
-    [ -n "$TP_TEAM" ] || die "team key is required"
-    CRED_LINES="LINEAR_API_KEY=$LINEAR_API_KEY"
-    ;;
   trello)
     : "${TRELLO_KEY:?Set TRELLO_KEY in your environment, then re-run}"
     : "${TRELLO_TOKEN:?Set TRELLO_TOKEN in your environment, then re-run}"
@@ -170,7 +164,7 @@ for ROLE in $ROLES; do
   DEST="$PROJECT_DIR/agents/hermes/$ROLE"
   # Scrub provider creds from copier's environment so 42-ticket-provider skips
   # board CREATION; we bind to the existing board in step 6 instead.
-  run "env -u PLANE_API_KEY -u PLANE_33GOD_API_KEY -u LINEAR_API_KEY \
+  run "env -u PLANE_API_KEY -u PLANE_33GOD_API_KEY \
         -u TRELLO_KEY -u TRELLO_TOKEN \
         copier copy '$TEMPLATE_SRC' '$DEST' --trust --defaults --overwrite \
         --data target_repo='$REPO' --data role='$ROLE' --data ticket_provider='$PROVIDER'"
@@ -180,7 +174,7 @@ done
 PM_ROLE="$PROJECT_DIR/agents/hermes/pm/role.yaml"
 if [ -f "$PM_ROLE" ] && [ "${HAT_DRY_RUN:-0}" != "1" ]; then
   say "6. binding pm to your $PROVIDER board"
-  TP_WORKSPACE="$TP_WORKSPACE" TP_PROJECT="$TP_PROJECT" TP_TEAM="$TP_TEAM" \
+  TP_WORKSPACE="$TP_WORKSPACE" TP_PROJECT="$TP_PROJECT" \
   TP_BOARD="$TP_BOARD" PROVIDER="$PROVIDER" python3 - "$PM_ROLE" <<'PY'
 import os, re, sys, pathlib
 p = pathlib.Path(sys.argv[1]); t = p.read_text()
@@ -190,7 +184,6 @@ def setleaf(text, key, val):
     return new if n else text
 t = setleaf(t, "workspace", os.environ.get("TP_WORKSPACE",""))
 t = setleaf(t, "project",   os.environ.get("TP_PROJECT",""))
-t = setleaf(t, "team",      os.environ.get("TP_TEAM",""))
 t = setleaf(t, "board",     os.environ.get("TP_BOARD",""))
 p.write_text(t)
 print("   bound:", {k:v for k,v in os.environ.items() if k.startswith("TP_") and v})

package/templates/hermes-agent/template/.scripts/42-ticket-provider.sh

@@ -46,13 +46,13 @@ PY
 }
 
 # pj_write — merge board binding (optional) + this agent into .project.json.
-# args: set_provider(0|1) provider board_id board_url workspace identifier team
+# args: set_provider(0|1) provider board_id board_url workspace identifier
 pj_write() {
   REPO="$REPO" REPO_ROOT="$REPO_ROOT" AGENT_ID="$AGENT_ID" ROLE="$ROLE" \
   ROLE_DIR_REL="$ROLE_DIR_REL" PROJECT_DESC="${PROJECT_DESC:-}" \
   python3 - "$PROJECT_JSON" "$@" <<'PY'
 import sys, os, json, pathlib
-(path, set_provider, provider, board_id, board_url, workspace, identifier, team) = sys.argv[1:9]
+(path, set_provider, provider, board_id, board_url, workspace, identifier) = sys.argv[1:8]
 p = pathlib.Path(path)
 try:
     d = json.loads(p.read_text())
@@ -72,7 +72,6 @@ if set_provider == "1":
     if identifier: tp["identifier"] = identifier
     if board_id:   tp["board_id"] = board_id
     if board_url:  tp["board_url"] = board_url
-    if team:       tp["team"] = team
 ag = d.setdefault("agents", {})
 ag[os.environ["AGENT_ID"]] = {"role": os.environ["ROLE"], "role_dir": os.environ["ROLE_DIR_REL"]}
 p.write_text(json.dumps(d, indent=2) + "\n")
@@ -82,8 +81,8 @@ PY
 
 # Mirror the binding into role.yaml so legacy consumers keep working.
 mirror_to_role_yaml() {
-  # mirror_to_role_yaml <provider> <board_id> <board_url> <workspace> <identifier> <team>
-  local provider="$1" bid="$2" burl="$3" ws="$4" ident="$5" team="$6"
+  # mirror_to_role_yaml <provider> <board_id> <board_url> <workspace> <identifier>
+  local provider="$1" bid="$2" burl="$3" ws="$4" ident="$5"
   yaml_set ticket_provider.name "$provider" 2>/dev/null || true
   [ -n "$bid" ]  && yaml_set ticket_provider.board_id "$bid" 2>/dev/null || true
   [ -n "$burl" ] && yaml_set ticket_provider.board_url "$burl" 2>/dev/null || true
@@ -98,8 +97,8 @@ mirror_to_role_yaml() {
     trello)
       [ -n "$bid" ] && yaml_set ticket_provider.board "$bid" 2>/dev/null || true
       ;;
-    linear)
-      [ -n "$team" ] && yaml_set ticket_provider.team "$team" 2>/dev/null || true
+    *)
+      die "unsupported ticket provider: $provider (expected plane|trello)"
       ;;
   esac
 }
@@ -111,7 +110,6 @@ SOT_BOARD_ID="$(pj ticket_provider.board_id)"
 SOT_URL="$(pj ticket_provider.board_url)"
 SOT_WS="$(pj ticket_provider.workspace)"
 SOT_IDENT="$(pj ticket_provider.identifier)"
-SOT_TEAM="$(pj ticket_provider.team)"
 
 # role.yaml provider comes from copier --data (the operator's pjangler choice).
 ROLE_PROVIDER="$(yaml_get ticket_provider.name)"
@@ -122,9 +120,10 @@ if [ -n "$SOT_BOARD_ID" ]; then
   if [ -n "$ROLE_PROVIDER" ] && [ "$ROLE_PROVIDER" != "$PROVIDER" ]; then
     warn "[42] requested provider '$ROLE_PROVIDER' but repo board is '$PROVIDER' (.project.json wins); binding to existing board"
   fi
+  case "$PROVIDER" in plane|trello) ;; *) die "unsupported ticket provider in .project.json: $PROVIDER (expected plane|trello)" ;; esac
   log "[42] binding $AGENT_ID to existing repo board (provider=$PROVIDER, id=$SOT_BOARD_ID)"
-  mirror_to_role_yaml "$PROVIDER" "$SOT_BOARD_ID" "$SOT_URL" "$SOT_WS" "$SOT_IDENT" "$SOT_TEAM"
-  pj_write 0 "$PROVIDER" "" "" "" "" ""   # register agent only; board already recorded
+  mirror_to_role_yaml "$PROVIDER" "$SOT_BOARD_ID" "$SOT_URL" "$SOT_WS" "$SOT_IDENT"
+  pj_write 0 "$PROVIDER" "" "" "" ""   # register agent only; board already recorded
   mark_done 42-ticket-provider
   exit 0
 fi
@@ -143,45 +142,23 @@ NAME="$(printf '%s' "$REPO" | tr '_-' '  ' | python3 -c 'import sys; print(" ".j
 DESC="Ticket board for $REPO"
 
 case "$PROVIDER" in
-  linear)
-    if [[ -z "${LINEAR_API_KEY:-}" ]]; then
-      warn "[42] LINEAR_API_KEY not set; set role.yaml/.project.json ticket_provider.team and re-run ./.scripts/42-ticket-provider.sh"
-      pj_write 1 linear "" "" "" "$IDENT" "$SOT_TEAM"
-      mark_done 42-ticket-provider; exit 0
-    fi
-    OUT="$(tp resolve 2>/dev/null || true)"
-    BID="$(printf '%s' "$OUT" | python3 -c 'import sys,json
-try: print(json.load(sys.stdin).get("board_id",""))
-except Exception: print("")')"
-    BURL="$(printf '%s' "$OUT" | python3 -c 'import sys,json
-try: print(json.load(sys.stdin).get("board_url",""))
-except Exception: print("")')"
-    if [ -n "$BID" ]; then
-      mirror_to_role_yaml linear "$BID" "$BURL" "" "$IDENT" "$SOT_TEAM"
-      pj_write 1 linear "$BID" "$BURL" "" "$IDENT" "$SOT_TEAM"
-    else
-      warn "[42] linear resolve returned no board; set ticket_provider.team and re-run"
-      pj_write 1 linear "" "" "" "$IDENT" "$SOT_TEAM"
-    fi
-    ;;
-
   plane|trello)
     KEYVAR=PLANE_API_KEY; [ "$PROVIDER" = trello ] && KEYVAR=TRELLO_KEY
     if [[ -z "${!KEYVAR:-}" ]]; then
       warn "[42] $KEYVAR not set; skipping board creation. Set creds and re-run ./.scripts/42-ticket-provider.sh"
-      pj_write 1 "$PROVIDER" "" "" "${SOT_WS:-$PLANE_WORKSPACE}" "$IDENT" ""
+      pj_write 1 "$PROVIDER" "" "" "${SOT_WS:-${PLANE_WORKSPACE:-}}" "$IDENT"
       mark_done 42-ticket-provider; exit 0
     fi
     OUT="$(tp create_board "$NAME" "$IDENT" "$DESC")" || die "create_board failed for $PROVIDER"
     BID="$(printf '%s' "$OUT" | python3 -c 'import sys,json; print(json.load(sys.stdin).get("board_id",""))')"
     BURL="$(printf '%s' "$OUT" | python3 -c 'import sys,json; print(json.load(sys.stdin).get("board_url",""))')"
-    WS="${SOT_WS:-$PLANE_WORKSPACE}"
+    WS="${SOT_WS:-${PLANE_WORKSPACE:-}}"
     [ "$PROVIDER" = trello ] && WS=""
-    mirror_to_role_yaml "$PROVIDER" "$BID" "$BURL" "$WS" "$IDENT" ""
-    pj_write 1 "$PROVIDER" "$BID" "$BURL" "$WS" "$IDENT" ""
+    mirror_to_role_yaml "$PROVIDER" "$BID" "$BURL" "$WS" "$IDENT"
+    pj_write 1 "$PROVIDER" "$BID" "$BURL" "$WS" "$IDENT"
     ;;
 
-  *) die "unknown ticket provider: $PROVIDER (expected linear|plane|trello)" ;;
+  *) die "unknown ticket provider: $PROVIDER (expected plane|trello)" ;;
 esac
 
 mark_done 42-ticket-provider

package/templates/hermes-agent/template/.scripts/70-systemd.sh

@@ -32,6 +32,8 @@ Type=simple
 Environment=HERMES_HOME=$RUNTIME
 Environment=HERMES_OAUTH_FILE=$HERMES_OAUTH_FILE
 Environment=CODEX_HOME=$CODEX_HOME
+Environment=HERMES_KANBAN_DISPATCH_IN_GATEWAY=0
+Environment=HERMES_KANBAN_SLASH_ENABLED=0
 EnvironmentFile=-$RUNTIME/.env
 ExecStart=$HERMES_BIN gateway run --replace
 Restart=on-failure

package/templates/hermes-agent/template/.scripts/lib/ticket-provider.sh

@@ -1,6 +1,6 @@
 # shellcheck shell=bash
 # Ticket-provider adapter dispatcher — the single seam between the heartbeat
-# sentinel engine and a concrete ticket system (Linear | Plane | Trello).
+# sentinel engine and a concrete ticket system (Plane | Trello).
 #
 # The engine NEVER calls a provider directly. It calls `tp <op> [args...]`,
 # which dispatches to providers/<provider>.sh. Swapping providers is a one-line
@@ -64,7 +64,7 @@ PY
 )"
     [ -n "$name" ] && { printf '%s\n' "$name"; return 0; }
   fi
-  printf 'linear\n'
+  printf 'plane\n'
 }
 
 # Directory holding provider implementations (sibling of this lib).
@@ -81,6 +81,10 @@ tp() {
 
   local name impl
   name="$(tp_provider_name)"
+  case "$name" in
+    plane|trello) ;;
+    *) echo "tp: unsupported ticket provider '$name' (expected plane|trello)" >&2; return 2 ;;
+  esac
   impl="$(tp_providers_dir)/${name}.sh"
 
   if [ ! -f "$impl" ]; then

package/templates/hermes-agent/template/.scripts/sentinel/docs/autonomous-delegated-review.md

@@ -13,7 +13,7 @@ actively tries to break the work, surface unmet acceptance criteria, hidden
 regressions, and drift. On a clean adversarial verdict the loop treats the
 ticket as done and moves on — through the ticket-provider adapter
 (`tp transition <id> <state>`) — and emits a BloodBank decision event carrying
-the full report. This works identically on Linear, Plane, or Trello.
+the full report. This works identically on Plane or Trello.
 
 The operator's verification is **deferred** to end-of-product QA over the review
 lane, backed by a queryable decision trail. A downstream regression rollback is
@@ -144,7 +144,7 @@ Write `<ISSUE>.review.md`; the script validates it:
 ```markdown
 # Autonomous Review Report: <ISSUE>
 ## Issue
-- Linear/Plane/Trello issue: <ISSUE>
+- Provider issue: <ISSUE>
 - Review lane reason:
 ## Reviewer
 - Reviewer agent: <independent-agent-id>

package/templates/hermes-agent/template/.scripts/sentinel/docs/continuous-ticket-orchestration.md

@@ -19,7 +19,7 @@ approve merges.
 All board access goes through the adapter (`tp`, from
 `.scripts/lib/ticket-provider.sh`) and reasons in normalized states:
 `backlog | unstarted | started | in_review | completed`. Never call the provider
-directly — the engine is identical across Linear, Plane, and Trello.
+directly — the engine is identical across Plane and Trello.
 
 ## Work-state feed
 

package/templates/hermes-agent/template/.scripts/sentinel.prompt.md.jinja

@@ -6,6 +6,11 @@ A cheap systemd heartbeat already decided this full pass is needed.
 Working repo: the git root containing this role at `agents/hermes/{{ role }}/`.
 Ticket provider: **{{ ticket_provider }}** (reached only through the adapter — see below).
 
+The configured ticket provider is the authoritative repo ticket board/SOT for
+this PM. Hermes local Kanban must NOT be an active durable task lifecycle
+surface. Local Kanban may only run as an explicitly configured ephemeral child
+execution queue and must never close/move authoritative repo tickets.
+
 You are the **{{ target_repo }} PM**, running your continuous board-reconciliation
 pass. Act autonomously, but stay inside the project contracts. Read
 `agents/hermes/{{ role }}/SOUL.md` and the engine docs under
@@ -27,7 +32,7 @@ tp transition <id> <normalized-state>  # backlog|unstarted|started|in_review|com
 ```
 
 Reason in **normalized states**, not provider terms. This pass works identically
-on Linear, Plane, or Trello.
+on Plane or Trello.
 
 ## Pass
 

package/templates/hermes-agent/template/SOUL.md.jinja

@@ -55,12 +55,18 @@ read it before publishing a type you haven't published before.
 {% if role == "pm" -%}
 You are the **project manager**. You triage incoming requests from Telegram /
 Bloodbank command lanes, decompose them into discrete tasks on the
-Plane board, and route work to other agents in the fleet (e.g. the dev role
+configured ticket board, and route work to other agents in the fleet (e.g. the dev role
 on `bloodbank.cmd.v1.agent.{{ target_repo }}-dev.task.assign`). You do not
 write application code. You do not approve merges.
 
+The configured ticket provider (`{{ ticket_provider }}`) is the authoritative
+repo ticket board/SOT for this PM. Hermes local Kanban must NOT be an active
+durable task lifecycle surface. The kanban toolset is removed from the PM's cli
+surface. Local Kanban may only run as an explicitly configured ephemeral child
+execution queue and must never close/move authoritative repo tickets.
+
 Default execution workflow for implementation delivery: use
-`subagent-driven-development` in kanban-orchestrated codex mode
+`subagent-driven-development` in provider-ticket-orchestrated implementation mode
 (WIP=1, spec review gate, quality review gate).
 
 Decision events you commonly emit:
@@ -106,7 +112,7 @@ declared` event so the fleet knows what to route to you.
 - **Hostnames**: Use `*.delo.sh` for external/cross-machine access (resolved
   via Cloudflare Tunnel), `localhost` for same-host, Docker network service
   names for container-to-container, Tailscale for private machine-to-machine.
-- **Plane**: Always include a Plane ticket reference in commit messages.
+- **Ticketing**: Always include the configured provider's ticket reference in commit messages.
 
 ## Memory hygiene
 

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