@delorenj/pjangler 1.2.18 → 1.2.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delorenj/pjangler",
-  "version": "1.2.18",
+  "version": "1.2.21",
   "description": "Project subsystem bootstrapper CLI",
   "type": "module",
   "main": "dist/index.js",
@@ -23,7 +23,10 @@
     "start": "node dist/index.js",
     "mcp": "node dist/mcp-server.js",
     "typecheck": "tsc --noEmit",
-    "test": "node tests/parity-migrate-regressions.mjs && node tests/mcp-catalog-regressions.mjs && node tests/mcp-server-regressions.mjs && node tests/project-registry-regressions.mjs",
+    "test": "node tests/parity-migrate-regressions.mjs && node tests/mcp-catalog-regressions.mjs && node tests/mcp-server-regressions.mjs && node tests/project-registry-regressions.mjs && node tests/pg-registry-regressions.mjs",
+    "migrate:up": "node-pg-migrate --migrations-dir migrations up",
+    "migrate:down": "node-pg-migrate --migrations-dir migrations down",
+    "migrate:create": "node-pg-migrate --migrations-dir migrations create",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -39,12 +42,15 @@
     "@clack/prompts": "^1.4.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^14.0.2",
+    "pg": "^8.16.0",
     "yaml": "^2.9.0",
     "zod": "^4.4.3"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",
+    "@types/pg": "^8.15.0",
     "esbuild": "^0.25.0",
+    "node-pg-migrate": "^8.0.0",
     "typescript": "^5"
   }
 }

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/links ticket provider board + ticket_provider block in .project.json
+│   │   └── setup-plane.py  # Creates Plane project + 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
-- Ticket board created or linked via post-generation task
+- Plane project created via API in 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/links the ticket board, writes the ticket_provider block in .project.json)
+3. Runs setup-plane.py (creates Plane project, 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, ticket-provider enforcement, and multi-agent development tooling.
+Copier template for creating new 33GOD ecosystem components with BMAD methodology, Plane ticket enforcement, and multi-agent development tooling.
 
 ## Features
 
 - **Language Support**: Python, TypeScript, Rust
 - **Event-Driven Architecture**: Optional [Bloodbank](https://github.com/delorenj/Bloodbank) integration
-- **Ticket Provider Integration**: `.project.json` records Plane or Trello board bindings
-- **Ticket Enforcement**: Git hooks enforce configured ticket-provider requirements
+- **Plane Integration**: `.project.json` for ticket management and project config
+- **Ticket Enforcement**: Git hooks enforce Plane ticket 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 a provider key if you want automated board creation/linking
+# Set up Plane API key (for automated project creation)
 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: ticket board creation/linking + Copier template:
+[TODO] One command handles everything: Plane project creation + 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/links the configured ticket board automatically
+# Interactive wizard - creates Plane project 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 or link the configured ticket board
+2. Create the Plane project automatically
 3. Run Copier with all answers pre-filled
 4. Output next steps
 
@@ -83,10 +83,9 @@ The template asks for:
 - **Project Slug**: Directory/package name (auto-generated from name)
 - **Description**: One-sentence project description
 
-### Ticket Provider Integration
+### Plane Integration
 
-- **Provider**: Plane or Trello
-- **Workspace**: Provider workspace slug when applicable (Plane default: 33god)
+- **Workspace**: Plane workspace slug (default: 33god)
 - **Project Name**
 - **Project Identifier**: 2+ character ticket prefix (e.g., HOLO, VERN)
 
@@ -111,10 +110,10 @@ The template asks for:
    git commit -m "Initial commit from template"
    ```
 
-3. **Create or Claim Ticket**
+3. **Create Plane Ticket**
 
    ```bash
-   # Create or claim a ticket in the configured provider
+   # Create ticket in Plane (or it was already created for you!)
    # 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)
-# - Ticket-provider metadata (Plane or Trello)
+# - Plane project (auto-created in 33god workspace)
 # - mise environment management
 # - CLI coder configs (Claude, Codex, Gemini, etc.)
 
@@ -30,15 +30,16 @@ project_description:
   help: One-line description
   default: ""
 
-# 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 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_provider:
   type: str
   help: Ticket board provider this project's board lives in
   default: plane
   choices:
+    Linear: linear
     Plane: plane
     Trello: trello
 
@@ -49,7 +50,8 @@ project_slug:
   default: "{{ project_name | lower | replace(' ', '-') | replace('_', '-') }}"
   when: false
 
-# Back-compat aliases kept for existing pjangler/CommonProject callers.
+# 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).
 plane_workspace:
   type: str
   default: "33god"
@@ -70,27 +72,6 @@ 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 URLs are
-# derived from provider/workspace/board_id and are intentionally not persisted.
-board_id:
-  type: str
-  default: "{{ plane_project_id }}"
-  when: false
-
-# Deprecated no-op accepted so older pjangler/CommonProject callers do not fail
-# when they still pass `--data board_url=...`.
-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:
@@ -109,8 +90,9 @@ agent_hooks_layer:
   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).
+# When agent_hooks_layer is false, omit only the project-scoped hook tree. The
+# skills manifest stays — sync-skills.py writes project-local CLI dirs and is safe
+# even on machines that already run a global ~/.agents/hooks install.
 # The `.copier-noop-never-matches` sentinel keeps every pattern non-empty when the
 # layer is enabled, which copier requires.
 _exclude:
@@ -124,8 +106,6 @@ _exclude:
   - "{% 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 ---
 #

package/templates/commonproject/template/.agents/hooks/README.md

@@ -15,6 +15,7 @@ master writes zero bytes).
 mise run hooks-sync          # fan out the master -> claude + codex + hermes
 mise run hooks-check         # drift gate (read-only; used in CI)
 mise run hooks-uninstall     # remove codex + hermes injections
+mise run skills-sync         # sync .agents/skills.json -> local CLI skill dirs
 mise run hindsight-setup     # one-time: pull the shared CAF Hindsight key into .env
 ```
 
@@ -70,8 +71,7 @@ Copy [`.agents/local.example.json`](../local.example.json) → `.agents/local.js
   "hooks": {
     "disabled": ["hindsight-recall"],   // hook ids — skipped at runtime, ALL agents
     "disabled_agents": ["codex"]        // claude|codex|hermes — codex/hermes injection skipped/removed
-  },
-  "skills": { "disabled": ["bmad-help"] } // skill dir names — not symlinked for you
+  }
 }
 ```
 
@@ -83,32 +83,18 @@ Copy [`.agents/local.example.json`](../local.example.json) → `.agents/local.js
 - **Disabled agents** are enforced at **install** time (codex/hermes injection is
   skipped, and removed if previously installed). `CAF_HOOKS_SKIP_CODEX=1` is an
   env shortcut for `disabled_agents:["codex"]`.
-- **Disabled skills** are honored by the skill fan-out (below).
+## Skill fan-out — `.agents/skills.json` → each CLI
 
-## Skill fan-out — `.agents/skills` → each CLI
+`.agents/skills.json` is the project's skill manifest. `sync-skills.py --scope
+project` resolves that manifest into project-local CLI dirs (for example
+`./.codex/skills`, `./.hermes/skills`, `./.kimi-code/skills`) and honors
+`inherit_global: true` so a dev's global `~/.agents/skills.json` loadout is
+merged in automatically.
 
-`.agents/skills/` is the project's enabled skill set (committed inherited skills +
-`./skills/*` app skills symlinked in on enter). `link-project-skills-to-clis.sh`
-fans it out as per-skill symlinks to every agent CLI that doesn't read `.agents/`
-natively — a small `SKILL_TARGETS` table:
-
-| CLI | target dir | scope |
-|---|---|---|
-| Codex | `~/.codex/skills` | **global** — link ours in, never clobber foreign entries, removed on `leave` |
-| Kimi | `./.kimi-code/skills` | **local** — a project-scoped mirror we fully manage (stale real copies replaced with symlinks) |
-
-Add a CLI = one `dir|scope` line. Per-dev control via `.agents/local.json`
-`skills`:
-
-- `disabled: [...]` — never link these; pruned from managed mirrors.
-- `defer_to_global: true` — **only if you run a global `~/.agents/skills` system.**
-  Skips any project skill whose name also exists there, so your global copy wins
-  and you get **zero duplicates** (it even yields the slot in `~/.codex/skills`).
-  Teammates with no global layer leave it `false` (default) and **inherit the full
-  set**. Override the global dir with `AGENTS_GLOBAL_SKILLS_DIR`.
-
-Tasks: `mise run skills-relink` (re-fan), `mise run link-project-skills-to-clis`,
-`mise run unlink-project-skills-from-clis`.
+- Project-local skills with the same name shadow the global ones.
+- No `defer_to_global` flag or bash cleanup scripts are needed anymore.
+- The manifest is the only hand-edited skill SSOT; run `mise run skills-sync`
+  after changing it, or just re-enter the repo.
 
 ## Hindsight credentials — `mise run hindsight-setup`
 
@@ -137,6 +123,7 @@ Without a key the hooks **no-op gracefully** — recall/retain just do nothing.
 ```
 .agents/
   local.example.json    # per-dev override template (copy -> local.json, gitignored)
+  skills.json           # project skill manifest (SSOT for sync-skills.py)
   hooks/
     hooks.master.json   # SSOT — the only hand-edited config
     sync.py             # fan-out engine (--install / --uninstall / --check)

package/templates/commonproject/template/.agents/hooks/lib/local-config.sh

@@ -4,10 +4,9 @@
 # Source this, then call:
 #   hook_disabled  <hook-id>     # true if .hooks.disabled[] contains the id
 #   agent_disabled <agent>       # true if .hooks.disabled_agents[] contains the agent
-#   skill_disabled <skill-name>  # true if .skills.disabled[] contains the name
 #
 # All FAIL OPEN (return 1 = "not disabled") when `.agents/local.json` or `jq` is
-# absent, so a missing/garbled local config can never silently kill hooks/skills.
+# absent, so a missing/garbled local config can never silently kill hooks.
 #
 # `.agents/local.json` is gitignored — each dev owns their own. See
 # `.agents/local.example.json` for the schema.
@@ -30,22 +29,13 @@ _caf_listed() {
 
 hook_disabled()  { _caf_listed '.hooks.disabled' "$1"; }
 agent_disabled() { _caf_listed '.hooks.disabled_agents' "$1"; }
-skill_disabled() { _caf_listed '.skills.disabled' "$1"; }
 
-# True if the dev opted to let their GLOBAL agent system (~/.agents/skills) provide
-# any overlapping skill, so the project linker should skip it (no duplicates).
-# Teammates with no global layer omit this and inherit the full project set.
+# True if the dev opted to let their GLOBAL agent system (~/.agents/hooks) provide
+# the hook layer, so project-scoped per-user injections should be suppressed.
 skills_defer_to_global() {
   local f
   f="$(_caf_local_json)" || return 1
   [[ -f "$f" ]] || return 1
   command -v jq >/dev/null 2>&1 || return 1
-  jq -e '.skills.defer_to_global == true' "$f" >/dev/null 2>&1
-}
-
-# True if <skill-name> is provided by the global agent SSOT. `-e` follows the
-# ~/.agents/skills symlink (-> skillex/skill-sets/global) and its entries.
-skill_is_global() {
-  local name="$1" gdir="${AGENTS_GLOBAL_SKILLS_DIR:-$HOME/.agents/skills}"
-  [[ -e "${gdir}/${name}" ]]
+  jq -e '.hooks.defer_to_global == true' "$f" >/dev/null 2>&1
 }

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

@@ -72,10 +72,10 @@ def load_local() -> dict:
     (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.
+    `hooks.defer_to_global` 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
@@ -84,9 +84,8 @@ def load_local() -> dict:
         try:
             data = json.loads(p.read_text() 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"))
+            defer_to_global = bool(hooks_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":

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

@@ -1,17 +1,11 @@
 {
-  "$comment": "PER-DEV LOCAL OVERRIDES — copy this file to .agents/local.json (gitignored) and edit. Lets you opt out of individual hooks, whole agents, or specific auto-linked skills, and tune how project skills fan out to your agent CLIs — without touching committed config. Hooks self-skip at RUNTIME via .agents/hooks/lib/hook-guard.sh (so even Claude's committed hooks honor it); codex/hermes injections additionally skip at INSTALL time. Re-run `mise run hooks-sync` / `mise run skills-relink` (or re-cd into the repo) after editing.",
+  "$comment": "PER-DEV LOCAL OVERRIDES — copy this file to .agents/local.json (gitignored) and edit. Lets you opt out of individual hooks or whole injected agents without touching committed config. Hooks self-skip at RUNTIME via .agents/hooks/lib/hook-guard.sh (so even Claude's committed hooks honor it); codex/hermes injections additionally skip at INSTALL time. Re-run `mise run hooks-sync` (or re-cd into the repo) after editing.",
   "hooks": {
     "$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": [],
-    "$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.",
-    "disabled": [],
-    "$defer_to_global_help": "Set true ONLY if you run a global agent system at ~/.agents/skills. When true, the linker skips any project skill whose name also exists in your global SSOT, so your global copy wins and you get ZERO duplicates/conflicts (and yields the slot in shared dirs like ~/.codex/skills). Teammates with no global layer leave this false (the default) and inherit the FULL project skill set. Override the global dir with the AGENTS_GLOBAL_SKILLS_DIR env var.",
+    "$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. 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
   }
 }

package/templates/commonproject/template/.agents/skills.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://raw.githubusercontent.com/skillex/schemas/main/skills.schema.json",
+  "inherit_global": true,
+  "registry": "https://github.com/delorenj/skillex.git",
+  "skills": []
+}

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

@@ -1,5 +1,8 @@
-{% set ticket_board_id = board_id | default(plane_project_id) -%}
-{% set workspace = ticket_workspace | default(plane_workspace if ticket_provider == 'plane' else '') -%}
+{% if ticket_provider == 'plane' and plane_project_id -%}
+{% set board_url = plane_base ~ '/' ~ plane_workspace ~ '/projects/' ~ plane_project_id ~ '/issues/' -%}
+{% else -%}
+{% set board_url = '' -%}
+{% endif -%}
 {
   "project_name": {{ project_name | tojson }},
   "project_description": {{ project_description | tojson }},
@@ -7,17 +10,10 @@
   "repo_path": "",
   "ticket_provider": {
     "type": {{ ticket_provider | tojson }},
-    "workspace": {{ workspace | tojson }},
+    "workspace": {{ plane_workspace | tojson }},
     "identifier": {{ project_identifier | tojson }},
-    "board_id": {{ ticket_board_id | tojson }},
-    "state": {{ ("linked" if ticket_board_id else "planned") | tojson }}
+    "board_id": {{ plane_project_id | tojson }},
+    "board_url": {{ board_url | tojson }}
   },
-  "agents": {},
-  "automation": {
-    "reconcile": {
-      "enabled": false,
-      "grace_hours": 0,
-      "auto_review": true
-    }
-  }
+  "agents": {}
 }

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

@@ -20,23 +20,24 @@ script = "'{% raw %}{{config_root}}{% endraw %}/.mise/scripts/link-agentfiles.sh
 [[hooks.enter]]
 script = "op inject -i .env.op > .env"
 [[hooks.enter]]
+script = "sync-skills.py --scope project"
+[[hooks.enter]]
 script = "[ -f '{% raw %}{{config_root}}{% endraw %}/.mise/scripts/codegraph.sh' ] && '{% raw %}{{config_root}}{% endraw %}/.mise/scripts/codegraph.sh' || true"
 {%- if agent_hooks_layer %}
 [[hooks.enter]]
-script = "'{% raw %}{{config_root}}{% endraw %}/.mise/scripts/link-project-skills-to-clis.sh'"
-[[hooks.enter]]
 script = "'{% raw %}{{config_root}}{% endraw %}/.agents/hooks/sync.py' --install --quiet"
 {%- endif %}
 {%- if agent_hooks_layer %}
 [[hooks.leave]]
-script = "'{% raw %}{{config_root}}{% endraw %}/.mise/scripts/unlink-project-skills-from-clis.sh'"
-[[hooks.leave]]
 script = "'{% raw %}{{config_root}}{% endraw %}/.agents/hooks/sync.py' --uninstall --quiet"
 {%- endif %}
 
 [[watch_files]]
 patterns = ["AGENTS.md"]
 task = "link-agentfiles"
+[[watch_files]]
+patterns = [".agents/skills.json"]
+task = "skills-sync"
 {% if agent_hooks_layer %}
 # Re-fan-out the agent hooks whenever the single source of truth changes.
 [[watch_files]]
@@ -46,6 +47,10 @@ task = "hooks-sync"
 [tasks.link-agentfiles]
 description = "Symlink all agent files to AGENTS.md"
 run = "'{% raw %}{{config_root}}{% endraw %}/.mise/scripts/link-agentfiles.sh'"
+
+[tasks.skills-sync]
+description = "Sync skills from manifest to local CLI dirs"
+run = "sync-skills.py --scope project"
 {% if agent_hooks_layer %}
 # --- Project-scoped agent hooks + skill fan-out (see .agents/hooks/README.md) ---
 
@@ -60,18 +65,6 @@ run = "'{% raw %}{{config_root}}{% endraw %}/.agents/hooks/sync.py' --check"
 [tasks.hooks-uninstall]
 description = "Remove per-user agent-hook injections (codex/kimi/hermes)"
 run = "'{% raw %}{{config_root}}{% endraw %}/.agents/hooks/sync.py' --uninstall"
-
-[tasks.link-project-skills-to-clis]
-description = "Fan .agents/skills out to each agent CLI; honors local.json defer_to_global + disabled"
-run = "'{% raw %}{{config_root}}{% endraw %}/.mise/scripts/link-project-skills-to-clis.sh'"
-
-[tasks.unlink-project-skills-from-clis]
-description = "Remove project skill symlinks from shared per-CLI dirs"
-run = "'{% raw %}{{config_root}}{% endraw %}/.mise/scripts/unlink-project-skills-from-clis.sh'"
-
-[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)"

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 | Ticket board binding, bmad init, mise tasks | Ticket board binding, Telegram bot wiring, agent-hm-* runtime repo, systemd units |
+| Post-gen artifacts | Plane project, bmad init, mise tasks | Plane project, 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 (Plane or
-Trello) with an autonomous adversarial review (act, do not wait). The
+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 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 or bind the configured ticket board
+8. Create a Plane project in your configured workspace
 9. Install systemd `--user` units: gateway, consumer, heartbeat timer (reconcile + checkpoint)
 10. Append the agent to `~/.hermes/agents-registry.yaml`
 
@@ -68,7 +68,7 @@ you to review it. Keys:
 | `fleet` | `fleet_env`, `registry_file` | Fleet source-of-truth + registry locations |
 | `fleet` | `oauth_file`, `codex_home` | Shared Hermes OAuth store + Codex CLI/app-server auth home |
 | `fleet` | `runtime_scaffold_dir` | Fallback scaffold (if agent-local one is missing) |
-| `fleet` | `canonical_skills_dir`, `pm_external_skill_dirs`, `symlinked_runtime_skills` | Shared runtime skills plus PM external skill libraries |
+| `fleet` | `canonical_skills_dir`, `symlinked_runtime_skills` | Skills mirrored into each profile |
 | `github` | `runtime_repo_owner` | Owner of the `agent-hm-*` runtime repos |
 | `plane` | `base`, `workspace` | Plane URL + workspace slug |
 | `bloodbank` | `nats_host`, `nats_port`, `compose_dir` | NATS endpoint + compose dir hint |
@@ -138,14 +138,14 @@ to force re-run:
 
 ```bash
 cd agents/hermes/pm
-rm .scripts/.done-42-ticket-provider
-SKIP_SYSTEMD=1 ./.scripts/42-ticket-provider.sh
+rm .scripts/.done-40-plane
+SKIP_TELEGRAM=1 SKIP_SYSTEMD=1 ./.scripts/40-plane.sh
 ```
 
 ## Retiring an agent
 
 (TODO: ship `retire.sh` in v1.1)
 
-Manual: stop systemd units, `hermes profile delete`, archive the ticket board
-if the provider supports archival, `/deletebot` in BotFather, archive the
+Manual: stop systemd units, `hermes profile delete`, archive the Plane
+project, `/deletebot` in BotFather, archive the
 `agent-hm-*` runtime repo, remove the registry entry.

package/templates/hermes-agent/config.example.toml

@@ -1,66 +1 @@
-# hermes-agent-template — distributable configuration
-#
-# This file holds every environment-specific default the provisioning scripts
-# need. Copy it to ~/.config/hermes-agent-template/config.toml (the first
-# provisioning run does this for you) and edit the values for YOUR machine.
-#
-# Resolution precedence for each value (highest wins):
-#   explicit env var  >  ~/.hermes/fleet.env  >  this file  >  built-in fallback
-#
-# Override the config location with $HERMES_TEMPLATE_CONFIG if you keep it
-# somewhere other than $XDG_CONFIG_HOME/hermes-agent-template/config.toml.
-
-[fleet]
-# Absolute path to the shared Hermes executable every agent launcher execs.
-hermes_bin = "~/.hermes/hermes-agent/.venv/bin/hermes"
-# Checkout of the hermes-agent repo. Its .venv is used to install nats-py, etc.
-hermes_repo = "~/.hermes/hermes-agent"
-# Fallback runtime scaffold dir — used only when an agent's vendored
-# ./.runtime-scaffold is missing.
-runtime_scaffold_dir = "~/code/hermes-agent-template/runtime-scaffold"
-# Shared fleet source-of-truth env file + fleet registry. ~ is expanded.
-fleet_env = "~/.hermes/fleet.env"
-registry_file = "~/.hermes/agents-registry.yaml"
-# Shared auth roots. HERMES_OAUTH_FILE is the Hermes provider OAuth store
-# (including openai-codex); CODEX_HOME is for Codex CLI/app-server auth.
-oauth_file = "~/.hermes/auth.json"
-codex_home = "~/.codex"
-# Canonical external skills dir mirrored into each agent profile.
-canonical_skills_dir = "/home/delorenj/.agents/skills"
-# PM-only external skill libraries surfaced alongside Hermes built-ins.
-pm_external_skill_dirs = [
-  "~/code/skillex/skill-sets/global/.system",
-  "~/code/skillex/packs/bmad/6.10.2",
-]
-# Voxxy plugin + service defaults for Hermes PM agents.
-voxxy_plugin_dir = "~/code/voxxy/plugins/tts/voxxy"
-vox_url = "https://vox.delo.sh"
-# Canonical PM config.yaml the provisioner seeds each runtime's config.yaml from.
-# This is the fleet-wide Hermes inference/skill config (model, toolsets, etc.)
-# every agent runtime starts from. ~ is expanded.
-# canonical_pm_config = "~/.hermes/config.yaml"
-# Skills symlinked into every agent's runtime skills root.
-symlinked_runtime_skills = [
-  "delonet-conventions",
-  "delonet-dotenv",
-  "hermes-pm-template-maintenance",
-  "hindsight",
-  "33god-projects",
-  "subagent-driven-development",
-]
-
-[github]
-# Owner of the per-agent runtime repos (creates <owner>/agent-hm-<repo>-<role>).
-runtime_repo_owner = "delorenj"
-
-[plane]
-# Plane instance base URL and workspace slug (one project per agent).
-base = "https://plane.delo.sh"
-workspace = "33god"
-
-[bloodbank]
-# NATS endpoint the consumer connects to.
-nats_host = "127.0.0.1"
-nats_port = 4222
-# Where the bloodbank docker compose lives (used only for a hint message). ~ ok.
-compose_dir = "~/code/33GOD/bloodbank"
+template/.scripts/config.example.toml

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 or binds the configured ticket board
+#   4. Creates a Plane project in 33god workspace
 #   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, ticket
-# provider defaults, NATS endpoint, skills dir, …) are NOT hardcoded — they live in
+# Environment-specific defaults (Hermes binary path, runtime repo owner, Plane
+# workspace/URL, 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,6 +59,7 @@ ticket_provider:
   help: "Ticket system this agent's board lives in"
   default: plane
   choices:
+    "Linear": linear
     "Plane": plane
     "Trello": trello