@mootup/moot-templates 0.1.0-rc.0 → 0.2.0

package/package.json

@@ -1,8 +1,13 @@
 {
   "name": "@mootup/moot-templates",
-  "version": "0.1.0-rc.0",
+  "version": "0.2.0",
   "description": "Canonical project templates (skills, teams, devcontainer, Claude hooks) for @mootup/moot-cli, synced from the mootup Python CLI source.",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mootup-io/moot-cli-js.git",
+    "directory": "packages/moot-templates"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -18,7 +23,7 @@
     "README.md"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=18.0.0"
   },
   "scripts": {
     "sync:templates": "node scripts/sync-templates.mjs",

package/templates/cursor-agent-devcontainer/devcontainer.json

@@ -0,0 +1,25 @@
+{
+  "name": "moot-agent-team-cursor",
+  "image": "mcr.microsoft.com/devcontainers/javascript-node:22",
+  "features": {
+    "ghcr.io/devcontainers/features/docker-in-docker:2": {
+      "moby": false
+    },
+    "ghcr.io/devcontainers/features/python:1": {
+      "version": "3.11"
+    }
+  },
+  "postCreateCommand": "bash .devcontainer/post-create.sh",
+  "runArgs": [
+    "--name", "moot-${localWorkspaceFolderBasename}"
+  ],
+  "customizations": {
+    "cursor": {
+      "extensions": [
+        "ms-python.python",
+        "ms-pyright.pyright"
+      ]
+    }
+  },
+  "remoteUser": "node"
+}

package/templates/cursor-agent-devcontainer/post-create.sh

@@ -0,0 +1,68 @@
+#!/bin/bash
+set -euo pipefail
+
+# System packages
+sudo apt-get update && sudo apt-get install -y tmux
+
+# Claude Code CLI — install from npm first (puts `claude` on PATH
+# via /usr/local/share/npm-global/bin), use it to register MCP servers,
+# then call `claude install` to migrate to the native build at
+# ~/.local/bin. The native build is the officially-supported path
+# going forward; the TUI nags on first run when it's still npm-based.
+npm install -g @anthropic-ai/claude-code
+
+# Python tooling
+pip install uv
+
+# Install moot package
+pip install mootup
+
+# Register MCP servers for Claude Code at user scope so claude finds
+# them regardless of cwd (agents launch in worktrees under .worktrees/,
+# not the project root). Use absolute paths to the wrapper scripts so
+# they resolve from any cwd. The wrappers read CONVO_ROLE at runtime
+# to look up the per-role API key from .moot/actors.json.
+DEVCONTAINER_DIR="$(realpath .devcontainer)"
+claude mcp add convo "$DEVCONTAINER_DIR/run-moot-mcp.sh" -s user
+claude mcp add convo-channel "$DEVCONTAINER_DIR/run-moot-channel.sh" -s user
+
+# Migrate from the npm-installed claude to the native build. This runs
+# LAST (after `claude mcp add`) because `claude install` deletes the
+# npm symlink — anything calling `claude` after this point must rely on
+# ~/.local/bin/claude, which `bash -lc` picks up via ~/.profile's
+# standard "$HOME/.local/bin" snippet. Agent tmux sessions launch with
+# `bash -lc`, so they find the native binary automatically.
+claude install
+
+# Rebind tmux prefix to Ctrl-Space. Claude Code intercepts Ctrl-B (the
+# default prefix), so the usual `Ctrl-B d` detach never reaches tmux.
+# Ctrl-Space is rarely claimed by TUIs and leaves readline-style editing
+# bindings (Ctrl-A/E/etc.) untouched inside claude's input line.
+cat > /home/node/.tmux.conf <<'TMUX_CONF'
+unbind C-b
+set -g prefix C-Space
+bind C-Space send-prefix
+
+# Mouse on: scroll-wheel scrolls the pane, click selects a pane/window,
+# drag copies. Without this, scrollback is only reachable via the
+# copy-mode keybind (<prefix> [) which is a tmux-literacy tax users
+# shouldn't have to pay just to read recent output.
+set -g mouse on
+TMUX_CONF
+
+# Register a /detach slash command for claude so the user can leave a
+# tmux session without having to fight for the prefix key. The command
+# calls `tmux detach-client`, which disconnects the terminal but leaves
+# claude running in the session so `moot attach` picks up where it left
+# off. User-scope so every worktree sees it.
+mkdir -p /home/node/.claude/commands
+cat > /home/node/.claude/commands/detach.md <<'DETACH_MD'
+---
+description: Detach from the tmux session (leaves claude running in the background)
+allowed-tools: Bash(bash:*)
+---
+
+!bash -c 'SOCK=$(find /tmp /run -maxdepth 3 -name default -type s 2>/dev/null | head -1); if [ -n "$SOCK" ]; then tmux -S "$SOCK" detach-client; else echo "tmux socket not found"; fi'
+DETACH_MD
+
+echo "Container ready."

package/templates/cursor-agent-devcontainer/run-moot-channel.sh

@@ -0,0 +1,70 @@
+#!/bin/bash
+# Channel adapter wrapper — reads CONVO_ROLE and looks up API key
+# from .moot/actors.json. Same logic as run-moot-mcp.sh.
+
+ROLE="${CONVO_ROLE:-implementation}"
+ACTORS_FILE=".moot/actors.json"
+
+# Find project root (walk up to moot.toml)
+PROJECT_ROOT="$(pwd)"
+while [ "$PROJECT_ROOT" != "/" ]; do
+    [ -f "$PROJECT_ROOT/moot.toml" ] && break
+    PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
+done
+
+# Read per-role actor identity from .moot/actors.json. See run-moot-mcp.sh
+# for the full rationale — same rule applies to the channel adapter.
+if [ -f "$PROJECT_ROOT/$ACTORS_FILE" ]; then
+    eval $(python3 -c "
+import json, shlex
+with open('$PROJECT_ROOT/$ACTORS_FILE') as f:
+    data = json.load(f)
+entry = data.get('actors', {}).get('$ROLE', {})
+print('KEY=' + shlex.quote(entry.get('api_key', '')))
+print('AID=' + shlex.quote(entry.get('actor_id', '')))
+print('ANAME=' + shlex.quote(entry.get('display_name', '$ROLE')))
+" 2>/dev/null)
+    if [ -n "$KEY" ]; then
+        export CONVO_API_KEY="$KEY"
+    else
+        echo "WARNING: No API key for role '$ROLE' in $ACTORS_FILE" >&2
+    fi
+    [ -n "$AID" ] && export CONVO_AGENT_ID="$AID"
+    [ -n "$ANAME" ] && export CONVO_AGENT_NAME="$ANAME"
+fi
+
+# Read API URL from moot.toml
+if [ -z "$CONVO_API_URL" ] && [ -f "$PROJECT_ROOT/moot.toml" ]; then
+    URL=$(python3 -c "
+import tomllib
+with open('$PROJECT_ROOT/moot.toml', 'rb') as f:
+    data = tomllib.load(f)
+print(data.get('convo', {}).get('api_url', ''))
+" 2>/dev/null)
+    if [ -n "$URL" ]; then
+        export CONVO_API_URL="$URL"
+    fi
+fi
+
+# Read space ID from moot.toml
+if [ -z "$CONVO_SPACE_ID" ] && [ -f "$PROJECT_ROOT/moot.toml" ]; then
+    SID=$(python3 -c "
+import tomllib
+with open('$PROJECT_ROOT/moot.toml', 'rb') as f:
+    data = tomllib.load(f)
+print(data.get('convo', {}).get('space_id', ''))
+" 2>/dev/null)
+    if [ -n "$SID" ]; then
+        export CONVO_SPACE_ID="$SID"
+    fi
+fi
+
+# Alpha-grade diagnostics: DEBUG-level logs to a per-role file under
+# .moot/logs/ in the project root. Bind-mounted to the host so users
+# and support can grep and share the logs without docker exec.
+# Override with MOOT_LOG_LEVEL=INFO (or higher) once alpha stabilizes.
+LOG_DIR="$PROJECT_ROOT/.moot/logs"
+mkdir -p "$LOG_DIR"
+LOG_FILE="$LOG_DIR/channel-${ROLE}.log"
+export MOOT_LOG_LEVEL="${MOOT_LOG_LEVEL:-DEBUG}"
+exec python -u -m moot.adapters.channel_runner "$@" 2>> "$LOG_FILE"

package/templates/cursor-agent-devcontainer/run-moot-mcp.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+# MCP adapter wrapper — reads CONVO_ROLE and looks up API key
+# from .moot/actors.json. Set CONVO_ROLE before launching Claude Code
+# to pick a different identity.
+
+ROLE="${CONVO_ROLE:-implementation}"
+ACTORS_FILE=".moot/actors.json"
+
+# Find project root (walk up to moot.toml)
+PROJECT_ROOT="$(pwd)"
+while [ "$PROJECT_ROOT" != "/" ]; do
+    [ -f "$PROJECT_ROOT/moot.toml" ] && break
+    PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
+done
+
+# Read per-role actor identity from .moot/actors.json. We MUST export
+# CONVO_AGENT_ID and CONVO_AGENT_NAME — the mcp_runner defaults them to
+# "unknown-agent", and the backend rejects any post whose agent_id in the
+# body doesn't match the authenticated actor (HTTP 400, which the adapter
+# surfaces as an empty event_id).
+if [ -f "$PROJECT_ROOT/$ACTORS_FILE" ]; then
+    eval $(python3 -c "
+import json, shlex
+with open('$PROJECT_ROOT/$ACTORS_FILE') as f:
+    data = json.load(f)
+entry = data.get('actors', {}).get('$ROLE', {})
+print('KEY=' + shlex.quote(entry.get('api_key', '')))
+print('AID=' + shlex.quote(entry.get('actor_id', '')))
+print('ANAME=' + shlex.quote(entry.get('display_name', '$ROLE')))
+" 2>/dev/null)
+    if [ -n "$KEY" ]; then
+        export CONVO_API_KEY="$KEY"
+    else
+        echo "WARNING: No API key for role '$ROLE' in $ACTORS_FILE" >&2
+    fi
+    [ -n "$AID" ] && export CONVO_AGENT_ID="$AID"
+    [ -n "$ANAME" ] && export CONVO_AGENT_NAME="$ANAME"
+fi
+
+# Read API URL from moot.toml
+if [ -z "$CONVO_API_URL" ] && [ -f "$PROJECT_ROOT/moot.toml" ]; then
+    URL=$(python3 -c "
+import tomllib
+with open('$PROJECT_ROOT/moot.toml', 'rb') as f:
+    data = tomllib.load(f)
+print(data.get('convo', {}).get('api_url', ''))
+" 2>/dev/null)
+    if [ -n "$URL" ]; then
+        export CONVO_API_URL="$URL"
+    fi
+fi
+
+# Read space ID from moot.toml
+if [ -z "$CONVO_SPACE_ID" ] && [ -f "$PROJECT_ROOT/moot.toml" ]; then
+    SID=$(python3 -c "
+import tomllib
+with open('$PROJECT_ROOT/moot.toml', 'rb') as f:
+    data = tomllib.load(f)
+print(data.get('convo', {}).get('space_id', ''))
+" 2>/dev/null)
+    if [ -n "$SID" ]; then
+        export CONVO_SPACE_ID="$SID"
+    fi
+fi
+
+# Alpha-grade diagnostics: DEBUG-level logs to a per-role file under
+# .moot/logs/ in the project root. Bind-mounted to the host so users
+# and support can grep and share the logs without docker exec.
+# Override with MOOT_LOG_LEVEL=INFO (or higher) once alpha stabilizes.
+LOG_DIR="$PROJECT_ROOT/.moot/logs"
+mkdir -p "$LOG_DIR"
+LOG_FILE="$LOG_DIR/mcp-${ROLE}.log"
+export MOOT_LOG_LEVEL="${MOOT_LOG_LEVEL:-DEBUG}"
+exec python -u -m moot.adapters.mcp_runner "$@" 2>> "$LOG_FILE"

package/templates/cursor-agent-devcontainer/run-moot-notify.sh

@@ -0,0 +1,59 @@
+#!/bin/bash
+# Tmux notification daemon wrapper -- reads CONVO_ROLE and looks up
+# API key from .moot/actors.json. Same pattern as run-moot-channel.sh.
+
+ROLE="${CONVO_ROLE:-implementation}"
+ACTORS_FILE=".moot/actors.json"
+
+# Find project root (walk up to moot.toml)
+PROJECT_ROOT="$(pwd)"
+while [ "$PROJECT_ROOT" != "/" ]; do
+    [ -f "$PROJECT_ROOT/moot.toml" ] && break
+    PROJECT_ROOT="$(dirname "$PROJECT_ROOT")"
+done
+
+# Read API key from .moot/actors.json (nested schema)
+if [ -f "$PROJECT_ROOT/$ACTORS_FILE" ]; then
+    KEY=$(python3 -c "
+import json
+with open('$PROJECT_ROOT/$ACTORS_FILE') as f:
+    data = json.load(f)
+entry = data.get('actors', {}).get('$ROLE', {})
+print(entry.get('api_key', ''))
+" 2>/dev/null)
+    if [ -n "$KEY" ]; then
+        export CONVO_API_KEY="$KEY"
+    else
+        echo "WARNING: No API key for role '$ROLE' in $ACTORS_FILE" >&2
+    fi
+fi
+
+# Read API URL from moot.toml
+if [ -z "$CONVO_API_URL" ] && [ -f "$PROJECT_ROOT/moot.toml" ]; then
+    URL=$(python3 -c "
+import tomllib
+with open('$PROJECT_ROOT/moot.toml', 'rb') as f:
+    data = tomllib.load(f)
+print(data.get('convo', {}).get('api_url', ''))
+" 2>/dev/null)
+    if [ -n "$URL" ]; then
+        export CONVO_API_URL="$URL"
+    fi
+fi
+
+# Read space ID from moot.toml
+if [ -z "$CONVO_SPACE_ID" ] && [ -f "$PROJECT_ROOT/moot.toml" ]; then
+    SID=$(python3 -c "
+import tomllib
+with open('$PROJECT_ROOT/moot.toml', 'rb') as f:
+    data = tomllib.load(f)
+print(data.get('convo', {}).get('space_id', ''))
+" 2>/dev/null)
+    if [ -n "$SID" ]; then
+        export CONVO_SPACE_ID="$SID"
+    fi
+fi
+
+# Log daemon output for diagnostics
+LOG_FILE="/tmp/moot-notify-${ROLE}.log"
+exec python -m moot.adapters.notify_runner "$@" 2>"$LOG_FILE"