@delorenj/pjangler 1.2.4 → 1.2.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delorenj/pjangler",
-  "version": "1.2.4",
+  "version": "1.2.8",
   "description": "Project subsystem bootstrapper CLI",
   "type": "module",
   "main": "dist/index.js",

package/templates/commonproject/AGENTS.md

@@ -20,7 +20,7 @@ CommonProject/
 │   ├── .agentvibes/        # AgentVibes config
 │   ├── .mise/tasks/        # File-based mise tasks
 │   ├── .scripts/           # Post-generation utilities
-│   │   └── setup-plane.py  # Creates Plane project + ticket_provider block in .project.json
+│   │   └── setup-plane.py  # Creates/links ticket provider board + ticket_provider block in .project.json
 │   ├── AGENTS.md.jinja     # Generated project's agent SSOT
 │   ├── CLAUDE.md           # Symlink → AGENTS.md
 │   ├── GEMINI.md           # Symlink → AGENTS.md
@@ -46,7 +46,7 @@ Root-level files describe the template itself. Files in `template/` are what Cop
 Only two questions asked: `project_name` and `project_description`. Everything else is derived or automated:
 - `project_slug` derived from project_name
 - `user_name` / `user_skill_level` hardcoded for BMAD config
-- Plane project created via API in post-generation task
+- Ticket board created or linked via post-generation task
 - .gitignore copied from ~/.config/git/ignore
 - git init + initial commit run automatically
 
@@ -55,7 +55,7 @@ Only two questions asked: `project_name` and `project_description`. Everything e
 After rendering, Copier automatically:
 1. Copies .gitignore from ~/.config/git/ignore
 2. Makes scripts executable
-3. Runs setup-plane.py (creates Plane project, writes the ticket_provider block in .project.json)
+3. Runs setup-plane.py (creates/links the ticket board, writes the ticket_provider block in .project.json)
 4. Runs git init + git add -A + git commit
 
 ### BMAD System

package/templates/commonproject/README.md

@@ -1,13 +1,13 @@
 # CommonProject
 
-Copier template for creating new 33GOD ecosystem components with BMAD methodology, Plane ticket enforcement, and multi-agent development tooling.
+Copier template for creating new 33GOD ecosystem components with BMAD methodology, ticket-provider enforcement, and multi-agent development tooling.
 
 ## Features
 
 - **Language Support**: Python, TypeScript, Rust
 - **Event-Driven Architecture**: Optional [Bloodbank](https://github.com/delorenj/Bloodbank) integration
-- **Plane Integration**: `.project.json` for ticket management and project config
-- **Ticket Enforcement**: Git hooks enforce Plane ticket requirements
+- **Ticket Provider Integration**: `.project.json` records Plane or Trello board bindings
+- **Ticket Enforcement**: Git hooks enforce configured ticket-provider requirements
 - [TODO] **BMAD Integration**: Full BMAD methodology structure by auto running `npx bmad-method@latest install`
 - [TODO] Multiple-choice selection for different workflows: BMAD, GSD, GoogleAgentSkills, None.
 - **Containerization**: Optional Docker + Docker Compose
@@ -25,7 +25,7 @@ uv tool install copier
 # Or with pip
 pip install copier
 
-# Set up Plane API key (for automated project creation)
+# Set up a provider key if you want automated board creation/linking
 export PLANE_API_KEY="your-plane-api-key"
 OR
 [TODO] export PLANE_API_KEY=op://VaultName/Key/Field
@@ -36,14 +36,14 @@ OR
 
 ### Option 1: Automated Init (Recommended)
 
-[TODO] One command handles everything: Plane project creation + Copier template:
+[TODO] One command handles everything: ticket board creation/linking + Copier template:
 
 > TASK - Implement the following:
 > Currently, I have to run `copier copy --trust ~/code CommonProject .` globally, or `mise run init-project` while in the CommonProject source dir - but this is not ideal.
 > I would rather run `commonProject .` globally.
 
 ```bash
-# Interactive wizard - creates Plane project automatically
+# Interactive wizard - creates/links the configured ticket board automatically
 mise run init-project
 
 # Or non-interactive (uses defaults)
@@ -56,7 +56,7 @@ mise run init-project-non-interactive
 The wizard will:
 
 1. Ask for project details (name, description, type)
-2. Create the Plane project automatically
+2. Create or link the configured ticket board
 3. Run Copier with all answers pre-filled
 4. Output next steps
 
@@ -83,9 +83,10 @@ The template asks for:
 - **Project Slug**: Directory/package name (auto-generated from name)
 - **Description**: One-sentence project description
 
-### Plane Integration
+### Ticket Provider Integration
 
-- **Workspace**: Plane workspace slug (default: 33god)
+- **Provider**: Plane or Trello
+- **Workspace**: Provider workspace slug when applicable (Plane default: 33god)
 - **Project Name**
 - **Project Identifier**: 2+ character ticket prefix (e.g., HOLO, VERN)
 
@@ -110,10 +111,10 @@ The template asks for:
    git commit -m "Initial commit from template"
    ```
 
-3. **Create Plane Ticket**
+3. **Create or Claim Ticket**
 
    ```bash
-   # Create ticket in Plane (or it was already created for you!)
+   # Create or claim a ticket in the configured provider
    # Move to "In Progress"
    git checkout -b <IDENTIFIER>-123-initial-setup
    ```

package/templates/commonproject/copier.yml

@@ -3,7 +3,7 @@
 #
 # Generic base project template. Creates a project skeleton with:
 # - BMAD methodology (pre-initialized)
-# - Plane project (auto-created in 33god workspace)
+# - Ticket-provider metadata (Plane or Trello)
 # - mise environment management
 # - CLI coder configs (Claude, Codex, Gemini, etc.)
 
@@ -30,16 +30,15 @@ project_description:
   help: One-line description
   default: ""
 
-# Ticket board provider for this project. The board itself is created by
-# init-project.sh (create-plane-project.sh) BEFORE copier runs; its identity is
-# threaded back in via plane_* below and persisted into .project.json so it is
-# the single source of truth shared with the hermes-agent template's agents.
+# Ticket board provider for this project. Plane boards can be created before
+# Copier runs; Trello boards are linked by id/url. The board identity is
+# persisted into .project.json so it is the single source of truth shared with
+# the hermes-agent template's agents.
 ticket_provider:
   type: str
   help: Ticket board provider this project's board lives in
   default: plane
   choices:
-    Linear: linear
     Plane: plane
     Trello: trello
 
@@ -50,8 +49,7 @@ project_slug:
   default: "{{ project_name | lower | replace(' ', '-') | replace('_', '-') }}"
   when: false
 
-# Board binding — supplied by init-project.sh's --data-file after the board is
-# created. Defaults keep a bare `copier copy` rendering valid (empty binding).
+# Back-compat aliases kept for existing pjangler/CommonProject callers.
 plane_workspace:
   type: str
   default: "33god"
@@ -72,6 +70,24 @@ plane_base:
   default: "https://plane.delo.sh"
   when: false
 
+# Provider-agnostic board binding — supplied by pjangler's --data values after
+# the board is created or linked. Defaults keep a bare `copier copy` rendering
+# valid, and fall back to the legacy plane_* aliases above.
+board_id:
+  type: str
+  default: "{{ plane_project_id }}"
+  when: false
+
+board_url:
+  type: str
+  default: ""
+  when: false
+
+ticket_workspace:
+  type: str
+  default: "{{ plane_workspace if ticket_provider == 'plane' else '' }}"
+  when: false
+
 # Drives conditional blocks in rendered files (e.g. _.python.venv in mise.toml).
 # Not asked interactively; init-project.sh can override via --data-file.
 primary_language:
@@ -79,8 +95,41 @@ primary_language:
   default: python
   when: false
 
-# --- Post-generation tasks ---
+# Whether to scaffold the project-scoped agent-hooks + skill fan-out layer
+# (.agents/hooks + the mise enter/leave wiring that injects into each agent CLI's
+# per-user config). Defaults true so a bare `copier copy` still gets it. pjangler
+# passes `--data agent_hooks_layer=false` when the machine already runs a GLOBAL
+# agent-hooks install (~/.agents/hooks) — so a fresh project never re-injects the
+# same hooks into shared per-user configs like ~/.codex or ~/.kimi-code.
+agent_hooks_layer:
+  type: bool
+  default: true
+  when: false
 
+# When agent_hooks_layer is false, omit the project-scoped hook tree + skill-link
+# scripts entirely (the mise.toml wiring is already gated inside the template).
+# The `.copier-noop-never-matches` sentinel keeps every pattern non-empty when the
+# layer is enabled, which copier requires.
+_exclude:
+  - "copier.yml"
+  - "~*"
+  - "*.py[co]"
+  - "__pycache__"
+  - ".git"
+  - ".DS_Store"
+  - ".svn"
+  - "{% if agent_hooks_layer %}.copier-noop-never-matches{% else %}.agents/hooks{% endif %}"
+  - "{% if agent_hooks_layer %}.copier-noop-never-matches{% else %}.agents/hooks/**{% endif %}"
+  - "{% if agent_hooks_layer %}.copier-noop-never-matches{% else %}.agents/local.example.json{% endif %}"
+  - "{% if agent_hooks_layer %}.copier-noop-never-matches{% else %}.mise/scripts/link-project-skills-to-clis.sh{% endif %}"
+  - "{% if agent_hooks_layer %}.copier-noop-never-matches{% else %}.mise/scripts/unlink-project-skills-from-clis.sh{% endif %}"
+
+# --- Post-generation tasks ---
+#
+# NOTE: intentionally does NOT run `mise trust`. Trusting the repo fires the mise
+# `[hooks].enter` array, which (when the agent-hooks layer is present) injects
+# into the caller's shared per-user CLI configs. Scaffolding must never mutate
+# global state as a side effect — the operator trusts/enters the repo themselves.
 _tasks:
   - "cp ~/.config/git/ignore .gitignore 2>/dev/null || echo '# Add ignores here' > .gitignore"
   # Ensure secrets + per-dev agent-hook/skill overrides are ignored (appended after the base ignore).
@@ -89,4 +138,3 @@ _tasks:
   - "ln -sf AGENTS.md GEMINI.md"
   # Stamp the repo's absolute path into .project.json (the SOT) post-render.
   - "python3 -c \"import json,os,pathlib; p=pathlib.Path('.project.json'); d=json.loads(p.read_text()); d['repo_path']=os.getcwd(); p.write_text(json.dumps(d,indent=2)+chr(10))\""
-  - "mise trust"

package/templates/commonproject/mise.toml

@@ -17,11 +17,11 @@ patterns = ["AGENTS.md"]
 task = "link-agentfiles"
 
 [tasks]
-# Project initialization - creates Plane project + runs Copier
-init-project = { run = ".mise/scripts/init-project.sh", description = "Initialize new 33GOD project with Plane + Copier" }
+# Project initialization - creates/links ticket board + runs Copier
+init-project = { run = ".mise/scripts/init-project.sh", description = "Initialize new 33GOD project with ticket provider + Copier" }
 init-project-non-interactive = { run = ".mise/scripts/init-project.sh --non-interactive", description = "Non-interactive project init" }
 
-# Direct Plane project creation
+# Direct Plane project creation helper
 create-plane-project = { run = ".mise/scripts/create-plane-project.sh", description = "Create a Plane project and output ID" }
 
 # Template testing

package/templates/commonproject/template/.agents/hooks/sync.py

@@ -71,17 +71,28 @@ def load_local() -> dict:
     Note: individual disabled HOOKS are enforced at RUNTIME by lib/hook-guard.sh
     (so even Claude's committed hooks honor them); this only needs disabled
     AGENTS, which gate install. CAF_HOOKS_SKIP_CODEX=1 is an env shortcut.
+
+    `defer_to_global` (under either `hooks` or `skills`) means "I already run
+    these hooks from a global agent system" — so the shared per-user injections
+    (codex/kimi/hermes) are suppressed and actively removed. Claude's committed
+    repo settings are harmless and left in place.
     """
     disabled_agents: set[str] = set()
+    defer_to_global = False
     p = REPO_ROOT / ".agents" / "local.json"
     if p.exists():
         try:
             data = json.loads(p.read_text() or "{}")
-            disabled_agents = set((data.get("hooks") or {}).get("disabled_agents") or [])
+            hooks_cfg = data.get("hooks") or {}
+            skills_cfg = data.get("skills") or {}
+            disabled_agents = set(hooks_cfg.get("disabled_agents") or [])
+            defer_to_global = bool(hooks_cfg.get("defer_to_global")) or bool(skills_cfg.get("defer_to_global"))
         except (json.JSONDecodeError, OSError) as exc:
             warn(f"ignoring malformed .agents/local.json: {exc}")
     if os.environ.get("CAF_HOOKS_SKIP_CODEX") == "1":
         disabled_agents.add("codex")
+    if defer_to_global:
+        disabled_agents.update({"codex", "kimi", "hermes"})
     return {"disabled_agents": disabled_agents}
 
 

package/templates/commonproject/template/.agents/local.example.json

@@ -4,7 +4,9 @@
     "$disabled_help": "Hook ids from .agents/hooks/hooks.master.json: skill-check-reminder, hindsight-recall, hindsight-retain, hindsight-session-end. Listed ids are skipped at runtime across ALL agents.",
     "disabled": [],
     "$disabled_agents_help": "Agent keys: claude, codex, kimi, hermes. Listed agents are NOT installed (codex/kimi/hermes injections are skipped/removed). Claude's hooks are committed and can't be fully removed per-dev — disable them individually via `disabled` instead.",
-    "disabled_agents": []
+    "disabled_agents": [],
+    "$defer_to_global_help": "Set true if you already run these hooks from a GLOBAL agent system (~/.agents/hooks). When true, sync.py suppresses AND removes the shared per-user injections (codex/kimi/hermes) so a project never double-injects into ~/.codex / ~/.kimi-code; Claude's committed repo settings are left in place. Implied by skills.defer_to_global. On a machine with a global install, pjangler skips scaffolding this whole layer, so you rarely need to set this by hand.",
+    "defer_to_global": false
   },
   "skills": {
     "$disabled_help": "Skill directory names under .agents/skills/. Listed skills are NOT symlinked into any agent CLI dir for you, and are pruned from your managed mirrors.",

package/templates/commonproject/template/.project.json.jinja

@@ -1,7 +1,14 @@
-{% if ticket_provider == 'plane' and plane_project_id -%}
-{% set board_url = plane_base ~ '/' ~ plane_workspace ~ '/projects/' ~ plane_project_id ~ '/issues/' -%}
+{% set ticket_board_id = board_id | default(plane_project_id) -%}
+{% set ticket_board_url = board_url | default('') -%}
+{% set workspace = ticket_workspace | default(plane_workspace if ticket_provider == 'plane' else '') -%}
+{% if ticket_board_url -%}
+{% set resolved_board_url = ticket_board_url -%}
+{% elif ticket_provider == 'plane' and ticket_board_id -%}
+{% set resolved_board_url = plane_base ~ '/' ~ workspace ~ '/projects/' ~ ticket_board_id ~ '/issues/' -%}
+{% elif ticket_provider == 'trello' and ticket_board_id -%}
+{% set resolved_board_url = 'https://trello.com/b/' ~ ticket_board_id -%}
 {% else -%}
-{% set board_url = '' -%}
+{% set resolved_board_url = '' -%}
 {% endif -%}
 {
   "project_name": {{ project_name | tojson }},
@@ -10,10 +17,10 @@
   "repo_path": "",
   "ticket_provider": {
     "type": {{ ticket_provider | tojson }},
-    "workspace": {{ plane_workspace | tojson }},
+    "workspace": {{ workspace | tojson }},
     "identifier": {{ project_identifier | tojson }},
-    "board_id": {{ plane_project_id | tojson }},
-    "board_url": {{ board_url | tojson }}
+    "board_id": {{ ticket_board_id | tojson }},
+    "board_url": {{ resolved_board_url | tojson }}
   },
   "agents": {}
 }

package/templates/commonproject/template/mise.toml.jinja

@@ -16,27 +16,31 @@ enter = [
   "{% raw %}{{config_root}}{% endraw %}/.mise/scripts/link-agentfiles.sh",
   "op inject -i .env.op > .env",
   "{% raw %}{{config_root}}{% endraw %}/.mise/scripts/codegraph.sh",
+{%- if agent_hooks_layer %}
   "{% raw %}{{config_root}}{% endraw %}/.mise/scripts/link-project-skills-to-clis.sh",
   "{% raw %}{{config_root}}{% endraw %}/.agents/hooks/sync.py --install --quiet",
+{%- endif %}
 ]
+{%- if agent_hooks_layer %}
 leave = [
   "{% raw %}{{config_root}}{% endraw %}/.mise/scripts/unlink-project-skills-from-clis.sh",
   "{% raw %}{{config_root}}{% endraw %}/.agents/hooks/sync.py --uninstall --quiet",
 ]
+{%- endif %}
 
 [[watch_files]]
 patterns = ["AGENTS.md"]
 task = "link-agentfiles"
-
+{% if agent_hooks_layer %}
 # Re-fan-out the agent hooks whenever the single source of truth changes.
 [[watch_files]]
 patterns = [".agents/hooks/hooks.master.json"]
 task = "hooks-sync"
-
+{% endif %}
 [tasks.link-agentfiles]
 description = "Symlink all agent files to AGENTS.md"
 run = "{% raw %}{{config_root}}{% endraw %}/.mise/scripts/link-agentfiles.sh"
-
+{% if agent_hooks_layer %}
 # --- Project-scoped agent hooks + skill fan-out (see .agents/hooks/README.md) ---
 
 [tasks.hooks-sync]
@@ -62,7 +66,7 @@ run = "{% raw %}{{config_root}}{% endraw %}/.mise/scripts/unlink-project-skills-
 [tasks.skills-relink]
 description = "Re-fan the project skill set to all CLIs"
 run = "{% raw %}{{config_root}}{% endraw %}/.mise/scripts/link-project-skills-to-clis.sh"
-
+{% endif %}
 [tasks.hindsight-setup]
 description = "Provision this dev's shared project Hindsight key from 1Password into .env (op inject)"
 run = "{% raw %}{{config_root}}{% endraw %}/.mise/scripts/hindsight-setup.sh"

package/templates/hermes-agent/README.md

@@ -11,7 +11,7 @@ memory/state checkpointing.
 | What it scaffolds | A new top-level project | An agent role inside an existing project |
 | Copier target | `./my-new-project/` | `./agents/hermes/<role>/` |
 | Asks | project name + description | role + purpose + tone |
-| Post-gen artifacts | Plane project, bmad init, mise tasks | Plane project, Telegram bot wiring, agent-hm-* runtime repo, systemd units |
+| Post-gen artifacts | Ticket board binding, bmad init, mise tasks | Ticket board binding, Telegram bot wiring, agent-hm-* runtime repo, systemd units |
 
 CommonProject runs first to create the umbrella project. hermes-agent-template
 runs second (for each agent role you want) to drop agents into it.
@@ -20,8 +20,8 @@ runs second (for each agent role you want) to drop agents into it.
 
 The template provisions a single Hermes role per invocation. The `pm` role
 handles project management and triage, and also runs the continuous ticket
-sentinel out-of-band: a provider-agnostic board-reconciliation pass (Linear,
-Plane, or Trello) with an autonomous adversarial review (act, do not wait). The
+sentinel out-of-band: a provider-agnostic board-reconciliation pass (Plane or
+Trello) with an autonomous adversarial review (act, do not wait). The
 sentinel runs as the PM's **heartbeat** — a fused systemd timer tick that does
 the reconciliation pass and then a gated runtime checkpoint. (There is no
 separate `scrum-master` role; its duties folded into the PM heartbeat.)
@@ -47,7 +47,7 @@ The template will:
 5. Populate it with the runtime scaffold (config.yaml, SOUL.md, memories, consumer.py)
 6. Add it as a git submodule at `agents/hermes/pm/runtime/` (== HERMES_HOME)
 7. Prompt for a BotFather token, store it in `runtime/.env`
-8. Create a Plane project in your configured workspace
+8. Create or bind the configured ticket board
 9. Install systemd `--user` units: gateway, consumer, heartbeat timer (reconcile + checkpoint)
 10. Append the agent to `~/.hermes/agents-registry.yaml`
 
@@ -138,14 +138,14 @@ to force re-run:
 
 ```bash
 cd agents/hermes/pm
-rm .scripts/.done-40-plane
-SKIP_TELEGRAM=1 SKIP_SYSTEMD=1 ./.scripts/40-plane.sh
+rm .scripts/.done-42-ticket-provider
+SKIP_SYSTEMD=1 ./.scripts/42-ticket-provider.sh
 ```
 
 ## Retiring an agent
 
 (TODO: ship `retire.sh` in v1.1)
 
-Manual: stop systemd units, `hermes profile delete`, archive the Plane
-project, `/deletebot` in BotFather, archive the
+Manual: stop systemd units, `hermes profile delete`, archive the ticket board
+if the provider supports archival, `/deletebot` in BotFather, archive the
 `agent-hm-*` runtime repo, remove the registry entry.

package/templates/hermes-agent/copier.yml

@@ -12,13 +12,13 @@
 #   1. Renders agents/hermes/<role>/{role.yaml, SOUL.md, hermes, .scripts/}
 #   2. Creates a per-agent runtime repo gh:delorenj/agent-hm-<repo>-<role>
 #   3. Submodules it at agents/hermes/<role>/runtime/  (this is HERMES_HOME)
-#   4. Creates a Plane project in 33god workspace
+#   4. Creates or binds the configured ticket board
 #   6. Prompts for a BotFather Telegram token, stores in runtime/.env
 #   7. Installs a Bloodbank consumer + heartbeat timer (reconcile + checkpoint)
 #   8. Appends to ~/.hermes/agents-registry.yaml
 #
-# Environment-specific defaults (Hermes binary path, runtime repo owner, Plane
-# workspace/URL, NATS endpoint, skills dir, …) are NOT hardcoded — they live in
+# Environment-specific defaults (Hermes binary path, runtime repo owner, ticket
+# provider defaults, NATS endpoint, skills dir, …) are NOT hardcoded — they live in
 # ~/.config/hermes-agent-template/config.toml, seeded from config.example.toml on
 # first run. Edit that file to retarget the template for a different machine/user.
 
@@ -59,7 +59,6 @@ ticket_provider:
   help: "Ticket system this agent's board lives in"
   default: plane
   choices:
-    "Linear": linear
     "Plane": plane
     "Trello": trello
 

package/templates/hermes-agent/docs/architecture.md

@@ -92,11 +92,11 @@ happen to share a token, the second one's startup fails fast. The N×M cost
 (N BotFather sessions per fleet) is the price we accept for zero custom
 routing code.
 
-## One Plane project per agent
+## One Ticket Board Per Repo
 
-A Plane "project" is the natural unit of work isolation. Mixing agents into a
-shared project would conflate decisions and break filters. 1:1 also makes
-archive-on-retire clean.
+The configured ticket board is the natural unit of work isolation. The PM owns
+one board per repo and routes worker agents through that shared source of truth,
+so decisions, filters, and review state stay coherent.
 
 ## Bloodbank wiring
 

package/templates/hermes-agent/docs/operations.md

@@ -29,7 +29,7 @@ invocations).
 | 10 hermes profile | `hermes profile create <repo>-<role> --clone --no-alias` + mirror skills/plugins/hooks from default + symlink canonical runtime skills (`delonet-conventions`, `delonet-dotenv`, `hermes-pm-template-maintenance`, `hindsight`, `subagent-driven-development`) from `/home/delorenj/.agents/skills`; PM roles also seed `VOX_URL` in profile `.env` | n/a |
 | 20 runtime repo | Create gh:delorenj/agent-hm-<repo>-<role> (private), push scaffold from role-local `.runtime-scaffold/`, submodule-add into ./runtime/, symlink ~/.hermes/profiles/<id> → runtime; PM roles also link the Voxxy plugin and set `tts.provider: voxxy` | `SKIP_RUNTIME_REPO=1` |
 | 30 telegram | Capture BotFather token, write to runtime/.env, enable hermes-telegram toolset | `SKIP_TELEGRAM=1` |
-| 40 plane | Create Plane project in 33god workspace (1:1 with agent), patch identifier into role.yaml | `SKIP_PLANE=1` |
+| 42 ticket provider | Create or bind the configured ticket board, patch identifier into role.yaml | `SKIP_PLANE=1` |
 | 60 bloodbank | Install consumer (renders from scaffold w/ agent values), health-check NATS, install nats-py via uv if missing | `SKIP_BLOODBANK=1` |
 | 70 systemd | Install user units: gateway, consumer, heartbeat timer (board-reconciliation sentinel pass + gated runtime checkpoint, one tick) | `SKIP_SYSTEMD=1` |
 | 80 registry | Append entry to ~/.hermes/agents-registry.yaml | n/a |
@@ -187,7 +187,7 @@ systemctl --user disable --now hermes-${AGENT}-heartbeat.timer
 #    that's what you want!)
 hermes profile delete ${AGENT}
 
-# 3. Archive Plane project (Plane UI or API)
+# 3. Archive the ticket board if the provider supports archival
 PROJECT_ID=$(python3 -c "import yaml,pathlib; print(yaml.safe_load(pathlib.Path.home().joinpath('.hermes/agents-registry.yaml').read_text())['agents']['${AGENT}']['plane']['project_id'])")
 curl -X POST "https://plane.delo.sh/api/v1/workspaces/33god/projects/${PROJECT_ID}/archive/" \
   -H "X-API-Key: ${PLANE_33GOD_API_KEY}"

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

@@ -26,7 +26,7 @@ that does the board-reconciliation pass and then a gated runtime checkpoint
 `.scripts/sentinel/`.
 
 It talks to the ticket board through a pluggable adapter, so the same engine
-runs on Linear, Plane, or Trello. The engine lives once in this template (the
+runs on Plane or Trello. The engine lives once in this template (the
 single source of truth) and propagates to every deployment with
 `copier update`.
 
@@ -37,8 +37,6 @@ The following is true as of June 1, 2026.
 - The engine, the provider abstraction, and the autonomous adversarial-review
   enforcement are built, syntax-clean, and validated offline with a mock
   provider.
-- The **Linear** adapter is verified live against a real board (a real
-  `DEL` team: `resolve`, `list_issues` returning 93 issues, and `get_issue`).
 - The **Plane** adapter is verified live against a real workspace
   (`resolve`, `list_issues`, `get_issue`, `comment`, and a
   `transition` to `completed` on a disposable issue).
@@ -54,7 +52,7 @@ For a local, single-machine install (no GitHub runtime repo, no Telegram, no
 NATS), use the one-command bootstrap. From inside the target project:
 
 ```bash
-export PLANE_API_KEY=<key>   # or LINEAR_API_KEY / TRELLO_KEY + TRELLO_TOKEN
+export PLANE_API_KEY=<key>   # or TRELLO_KEY + TRELLO_TOKEN
 curl -fsSL https://raw.githubusercontent.com/delorenj/hermes-agent-template/main/install-local.sh | sh
 ```
 
@@ -66,7 +64,7 @@ macOS). See [Development guide: local install](development.md#local-install-one-
 <!-- prettier-ignore -->
 > [!IMPORTANT]
 > Full (non-local) provisioning is outward-facing. It can create a GitHub
-> runtime repo, a Telegram bot, and a Plane project, and the Telegram step is
+> runtime repo, a Telegram bot, and a ticket board, and the Telegram step is
 > interactive. Use `install-local.sh` or the `SKIP_*` flags described in
 > [Development guide:
 > provisioning](development.md#provisioning-the-pm-manual) for local or lean
@@ -81,7 +79,7 @@ All paths are relative to the repository root.
 | `copier.yml` | Questions (`role`, `ticket_provider`) and the `_tasks` provisioning chain. |
 | `template/role.yaml.jinja` | The rendered role manifest, including the `ticket_provider` binding and the `reconcile` knobs (`grace_hours`, `auto_review`). |
 | `template/.scripts/lib/ticket-provider.sh` | The adapter dispatcher (`tp`). The engine's only seam to a ticket system. |
-| `template/.scripts/providers/{linear,plane,trello}.sh` | The provider adapters. |
+| `template/.scripts/providers/{plane,trello}.sh` | The provider adapters. |
 | `template/.scripts/42-ticket-provider.sh` | Provisioning step that resolves or creates the board. |
 | `template/.scripts/70-systemd.sh` | Provisioning step that installs the gateway, consumer, and the fused `heartbeat` timer (board-reconciliation sentinel pass + gated runtime checkpoint). |
 | `install-local.sh` | One-command local install (no cloud, macOS + Linux). |
@@ -109,8 +107,8 @@ the agent to read at run time. Keep the two in sync when behavior changes.
 
 The highest-value open work, in order:
 
-1. Live-verify the **Trello** adapter against a real board (Linear and Plane are
-   done). See [Providers: verifying an
+1. Live-verify the **Trello** adapter against a real board (Plane is done).
+   See [Providers: verifying an
    adapter](providers.md#verifying-an-adapter-against-a-live-board).
 2. Confirm `install-local.sh` on a real macOS machine. The Linux path and the
    Plane adapter are verified; the macOS `launchd` agent and `mkdir` lock get

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

@@ -71,7 +71,8 @@ function, `tp`, that dispatches to one provider implementation under
 through the `ticket_provider` question and recorded in `role.yaml` under
 `ticket_provider.name`.
 
-This is what lets one engine serve three back ends: Trello, Plane, and Linear.
+This is what lets one engine serve the supported ticket back ends: Plane and
+Trello.
 For the full contract and the per-provider details, see
 [Providers](providers.md).
 

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

@@ -112,7 +112,7 @@ repository root instead of driving Copier by hand. From inside the target
 project:
 
 ```bash
-export PLANE_API_KEY=<key>   # or LINEAR_API_KEY / TRELLO_KEY + TRELLO_TOKEN
+export PLANE_API_KEY=<key>   # or TRELLO_KEY + TRELLO_TOKEN
 curl -fsSL https://raw.githubusercontent.com/delorenj/hermes-agent-template/main/install-local.sh | sh
 ```
 
@@ -133,8 +133,8 @@ The script:
 7. smoke-tests the board connection through the adapter.
 
 Useful environment overrides (skip the prompts): `HAT_REPO`, `HAT_PROVIDER`,
-`HAT_ROLES`, `HAT_PLANE_WORKSPACE`, `HAT_PLANE_PROJECT`, `HAT_LINEAR_TEAM`,
-`HAT_TRELLO_BOARD`, and `HAT_DRY_RUN=1` to preview without changing anything.
+`HAT_ROLES`, `HAT_PLANE_WORKSPACE`, `HAT_PLANE_PROJECT`, `HAT_TRELLO_BOARD`,
+and `HAT_DRY_RUN=1` to preview without changing anything.
 
 This local path does not wire Telegram or email. Those are convenience layers in
 the `pjangler` provisioner, not requirements for a working agent — talk to the
@@ -151,7 +151,7 @@ cd /path/to/your-project
 copier copy gh:delorenj/hermes-agent-template ./agents/hermes/pm \
   --data role=pm \
   --data target_repo=<repo> \
-  --data ticket_provider=<linear|plane|trello>
+  --data ticket_provider=<plane|trello>
 ```
 
 The `_tasks` chain in `copier.yml` runs the numbered provisioning scripts in
@@ -162,7 +162,7 @@ order. Several of them reach outside the repository.
 > Full provisioning is outward-facing and partly interactive.
 > `20-runtime-repo.sh` creates a private GitHub repo with `gh repo create`,
 > `30-telegram.sh` prompts for a BotFather token and blocks waiting for input,
-> and `42-ticket-provider.sh` can create a Plane project. Don't run full
+> and `42-ticket-provider.sh` can create a ticket board. Don't run full
 > provisioning unattended.
 
 Use the `SKIP_*` environment flags for a local or lean install. Each numbered
@@ -172,7 +172,7 @@ script checks its flag and skips cleanly.
 | --- | --- |
 | `SKIP_TELEGRAM` | The interactive BotFather token step. |
 | `SKIP_RUNTIME_REPO` | Creating the GitHub runtime repo. |
-| `SKIP_PLANE` | Creating a Plane project. |
+| `SKIP_PLANE` | Creating or linking the ticket board. |
 | `SKIP_BLOODBANK` | Installing the BloodBank consumer. |
 | `SKIP_SYSTEMD` | Installing `systemd` units (gateway, consumer, heartbeat timer). |
 
@@ -181,13 +181,14 @@ For example, a local install that creates no cloud resources:
 ```bash
 SKIP_TELEGRAM=1 SKIP_RUNTIME_REPO=1 SKIP_PLANE=1 SKIP_BLOODBANK=1 \
   copier copy gh:delorenj/hermes-agent-template ./agents/hermes/pm \
-  --data role=pm --data target_repo=<repo> --data ticket_provider=linear
+  --data role=pm --data target_repo=<repo> --data ticket_provider=trello
 ```
 
 After provisioning, set the board binding in
-`agents/hermes/pm/role.yaml`. For Linear, set `ticket_provider.team`
-to the team key. Make the provider key available to the heartbeat's environment:
-on Linux through a `systemd` `EnvironmentFile` (for example
+`agents/hermes/pm/role.yaml`. For Trello, set `ticket_provider.board` to the
+board id; for Plane, set `ticket_provider.workspace` and `ticket_provider.project`.
+Make the provider key available to the heartbeat's environment: on Linux through
+a `systemd` `EnvironmentFile` (for example
 `~/.hermes/<agent_id>.env`); on macOS the `launchd` agent sources that same
 per-agent env file, so write the key there.
 
@@ -256,8 +257,8 @@ These cost real debugging time. Watch for them.
 
 The following work is open for the incoming agent, roughly in priority order.
 
-1. **Live-verify the Trello adapter.** Linear and Plane are verified live
-   (Plane includes `transition` and `comment`). Trello is implemented against
+1. **Live-verify the Trello adapter.** Plane is verified live
+   (including `transition` and `comment`). Trello is implemented against
    the contract but unverified. Follow [Providers: verifying an
    adapter](providers.md#verifying-an-adapter-against-a-live-board) with Trello
    credentials, and fix any endpoint or field mismatches.