@mu-cabin/muc-cli 0.5.5 → 0.6.0

package/dist/templates/code-handler/bin/prep-repo

@@ -1,386 +0,0 @@
-#!/usr/bin/env bash
-# prep-repo — bare-cache + per-turn-worktree provisioner for the
-# code-review-gitlab assistant template.
-#
-# Modes:
-#   --repo <url> --author-uid <UID> --chat-id <id> --msg-id <id>
-#       [--branch-topic <topic>]
-#       Create a fresh worktree on a new branch
-#       muc-assistant/<topic> off origin/HEAD. If the branch exists, appends
-#       -2, -3, ... . Member-checks <UID> at Developer+. Sets git author to
-#       <UID> in the worktree. Writes the Muc-Assistant-Origin footer helper
-#       to ../muc-assistant-origin.txt and prints the absolute worktree path
-#       on stdout.
-#
-#   --repo <url> --author-uid <UID> --reuse-branch <branch>
-#       Same, but check out an existing branch (used by /refine to
-#       continue an existing assistant-MR). Member-checks Developer+.
-#
-#   --check-access <reporter|developer> --author-uid <UID> --repo <url>
-#       Member-check only; no worktree. Prints "ok" on success.
-#
-# Cache root: ${MUC_ASSISTANT_REPO_CACHE:-$HOME/.cache/muc-assistant/repos}
-#   The muc daemon sets MUC_ASSISTANT_REPO_CACHE to "<cwd>/.cache/repos"
-#   so the bare-cache lives inside the per-turn workspace and is wiped
-#   with the rest of the cwd on cleanup. Running this script outside the
-#   daemon falls back to $HOME/.cache/muc-assistant/repos.
-# Worktree root for /implement /refine: $PWD/repo (the daemon's per-turn
-#   workspace dir, wiped after the turn).
-#
-# Failure: anything not OK -> non-zero exit + human message on stderr.
-# The agent surfaces stderr verbatim back to the chat.
-
-set -euo pipefail
-
-CACHE_ROOT="${MUC_ASSISTANT_REPO_CACHE:-$HOME/.cache/muc-assistant/repos}"
-
-die() {
-  printf 'prep-repo: %s\n' "$*" >&2
-  exit 1
-}
-
-require_cmd() {
-  command -v "$1" >/dev/null 2>&1 || die "missing required tool: $1"
-}
-
-require_cmd git
-require_cmd glab
-
-usage() {
-  cat >&2 <<'USAGE'
-usage:
-  prep-repo --repo <url> --author-uid <UID> --chat-id <id> --msg-id <id> [--branch-topic <topic>]
-  prep-repo --repo <url> --author-uid <UID> --reuse-branch <branch>
-  prep-repo --check-access <reporter|developer> --author-uid <UID> --repo <url>
-USAGE
-  exit 2
-}
-
-# --- arg parse -----------------------------------------------------------
-REPO=""
-AUTHOR_UID=""
-CHAT_ID=""
-MSG_ID=""
-BRANCH_TOPIC=""
-REUSE_BRANCH=""
-CHECK_ACCESS=""
-
-while [[ $# -gt 0 ]]; do
-  case "$1" in
-    --repo)          REPO="${2:-}";          shift 2 ;;
-    --author-uid)    AUTHOR_UID="${2:-}";    shift 2 ;;
-    --chat-id)       CHAT_ID="${2:-}";       shift 2 ;;
-    --msg-id)        MSG_ID="${2:-}";        shift 2 ;;
-    --branch-topic)  BRANCH_TOPIC="${2:-}";  shift 2 ;;
-    --reuse-branch)  REUSE_BRANCH="${2:-}";  shift 2 ;;
-    --check-access)  CHECK_ACCESS="${2:-}";  shift 2 ;;
-    -h|--help)       usage ;;
-    *)               die "unknown arg: $1" ;;
-  esac
-done
-
-[[ -n "$REPO"       ]] || { usage; }
-[[ -n "$AUTHOR_UID" ]] || die "missing --author-uid"
-
-# --- repo url -> group/repo + host + cache slug -------------------------
-# Accept https://, http://, ssh://, git@host:path SSH-shorthand, and bare
-# "group/repo" slugs. When an explicit protocol prefix is present we *know*
-# the first segment after stripping it is the host, so strip it
-# unconditionally (heuristics on dot-vs-no-dot fail for short LAN hosts
-# like `git@gitlab:foo/bar`).
-#
-# Sets globals: HOST (empty when input was a bare slug), PROJECT, CLONE_REPO,
-# and REQUESTED_REF_PATH (best-effort branch/ref path from GitLab UI URLs).
-parse_repo_url() {
-  local s="$1" had_host=0 ui_suffix=""
-  HOST=""
-  CLONE_REPO=""
-  REQUESTED_REF_PATH=""
-  s="${s%%#*}"
-  s="${s%%\?*}"
-  if   [[ "$s" == https://* ]]; then s="${s#https://}";    had_host=1
-  elif [[ "$s" == http://*  ]]; then s="${s#http://}";     had_host=1
-  elif [[ "$s" == ssh://*   ]]; then s="${s#ssh://}"
-                                      s="${s#*@}"          # drop user@
-                                      had_host=1
-  elif [[ "$s" == git@*     ]]; then s="${s#git@}"
-                                      s="${s/://}"         # host:path -> host/path
-                                      had_host=1
-  fi
-  s="${s%.git}"
-  if [[ "$s" == *"/-/"* ]]; then
-    ui_suffix="${s#*/-/}"
-    s="${s%%/-/*}"                       # drop GitLab UI suffix /-/...
-    case "$ui_suffix" in
-      tree/*)    REQUESTED_REF_PATH="${ui_suffix#tree/}" ;;
-      blob/*)    REQUESTED_REF_PATH="${ui_suffix#blob/}" ;;
-      raw/*)     REQUESTED_REF_PATH="${ui_suffix#raw/}" ;;
-      commits/*) REQUESTED_REF_PATH="${ui_suffix#commits/}" ;;
-    esac
-    REQUESTED_REF_PATH="${REQUESTED_REF_PATH%/}"
-  fi
-  if (( had_host )); then
-    case "$s" in
-      */*) HOST="${s%%/*}"; s="${s#*/}" ;;
-      *)   die "cannot parse repo (no path after host): $REPO" ;;
-    esac
-  fi
-  s="${s%/}"
-  case "$s" in
-    */*) ;;
-    *)   die "expected <group>/<repo> in: $REPO" ;;
-  esac
-  PROJECT="$s"
-  if (( had_host )); then
-    case "$REPO" in
-      https://*) CLONE_REPO="https://$HOST/$PROJECT.git" ;;
-      http://*)  CLONE_REPO="http://$HOST/$PROJECT.git" ;;
-      ssh://*)   CLONE_REPO="ssh://$HOST/$PROJECT.git" ;;
-      git@*)     CLONE_REPO="git@$HOST:$PROJECT.git" ;;
-      *)         CLONE_REPO="$PROJECT" ;;
-    esac
-  else
-    CLONE_REPO="$PROJECT"
-  fi
-}
-
-parse_repo_url "$REPO"
-SLUG="${PROJECT//\//__}"
-BARE="$CACHE_ROOT/$SLUG.git"
-# When the URL omitted a host we let glab fall back to its configured
-# default (typically the host the user `glab auth login`-ed against).
-glab_api() {
-  if [[ -n "$HOST" ]]; then
-    glab api --hostname "$HOST" "$@"
-  else
-    glab api "$@"
-  fi
-}
-
-
-# --- glab encoding ------------------------------------------------------
-url_encode() {
-  # %-encode every byte so subgroups (with /) and any special chars survive.
-  local s="$1" out="" i c
-  for ((i=0; i<${#s}; i++)); do
-    c="${s:i:1}"
-    case "$c" in
-      [a-zA-Z0-9._~-]) out+="$c" ;;
-      *) printf -v c '%%%02X' "'$c"; out+="$c" ;;
-    esac
-  done
-  printf '%s' "$out"
-}
-PROJECT_ENC="$(url_encode "$PROJECT")"
-
-# --- uid resolution -----------------------------------------------------
-# `members/all/<id>` only accepts usernames on GitLab >= 15.4. Older
-# instances (e.g. gitlab.ceair.com) reject a username with HTTP 400
-# "user_id is invalid", which the access check would then mis-report as
-# "not a member". Resolve non-numeric AUTHOR_UID to a numeric user id via
-# `users?username=...` first so the membership query always uses an id
-# the server understands.
-resolve_uid() {
-  local input="$1" enc body id
-  if [[ "$input" =~ ^[0-9]+$ ]]; then
-    printf '%s' "$input"
-    return
-  fi
-  enc="$(url_encode "$input")"
-  if ! body="$(glab_api "users?username=$enc" 2>/dev/null)"; then
-    die "failed to resolve username '$input' via glab API (host: ${HOST:-default}; check token + network)"
-  fi
-  id="$(printf '%s' "$body" | sed -n 's/.*"id"[[:space:]]*:[[:space:]]*\([0-9][0-9]*\).*/\1/p' | head -n1)"
-  if [[ -z "$id" ]]; then
-    die "no GitLab user named '$input' on ${HOST:-the configured glab host}"
-  fi
-  printf '%s' "$id"
-}
-
-AUTHOR_UID_NUM="$(resolve_uid "$AUTHOR_UID")"
-
-# --- access level check -------------------------------------------------
-# `members/all/<numeric-id>` returns 200 + JSON containing `access_level`
-# (10=Guest 20=Reporter 30=Developer 40=Maintainer 50=Owner). 404 = not
-# a member. We pass --hostname when the input URL gave us a host;
-# otherwise glab falls back to its configured default host.
-access_level() {
-  local uid="$1" body level
-  if ! body="$(glab_api "projects/$PROJECT_ENC/members/all/$uid" 2>/dev/null)"; then
-    printf '0'
-    return
-  fi
-  level="$(printf '%s' "$body" | sed -n 's/.*"access_level"[[:space:]]*:[[:space:]]*\([0-9][0-9]*\).*/\1/p' | head -n1)"
-  printf '%s' "${level:-0}"
-}
-
-require_access() {
-  local need="$1" lvl
-  lvl="$(access_level "$AUTHOR_UID_NUM")"
-  if (( lvl == 0 )); then
-    die "$AUTHOR_UID (id=$AUTHOR_UID_NUM) is not a member of $PROJECT (or $PROJECT does not exist / glab token can't see it)"
-  fi
-  if (( lvl < need )); then
-    die "$AUTHOR_UID has access_level=$lvl on $PROJECT, need >= $need"
-  fi
-}
-
-# --- check-access mode --------------------------------------------------
-if [[ -n "$CHECK_ACCESS" ]]; then
-  case "$CHECK_ACCESS" in
-    reporter)  require_access 20 ;;
-    developer) require_access 30 ;;
-    *) die "unknown --check-access value: $CHECK_ACCESS (expected reporter|developer)" ;;
-  esac
-  printf 'ok\n'
-  exit 0
-fi
-
-# Both write modes require Developer+.
-require_access 30
-
-# --- bare cache: ensure + fetch ----------------------------------------
-mkdir -p "$CACHE_ROOT"
-if [[ ! -d "$BARE/refs" ]]; then
-  # Initial mirror clone. Use the normalized project URL so GitLab UI links
-  # (/-/tree, /-/blob, /-/merge_requests, ...) clone the repository, not the
-  # web page URL. The host/protocol still comes from the user-supplied URL so
-  # glab/git pick up the right stored credential helper.
-  if ! git clone --bare --filter=blob:none "$CLONE_REPO" "$BARE" >&2; then
-    die "git clone --bare failed for $CLONE_REPO -> $BARE"
-  fi
-fi
-
-if ! git -C "$BARE" fetch --prune --quiet origin >&2; then
-  die "git fetch failed in $BARE"
-fi
-
-# Reap dead worktree registrations from prior crashed turns so a new add
-# of the same branch name doesn't error out with "already checked out".
-git -C "$BARE" worktree prune --quiet 2>/dev/null || true
-
-# --- worktree --------------------------------------------------------------
-# Always create the worktree as a "repo/" subdir of the current cwd so the
-# daemon's per-turn workspace cleanup (rm -rf cwd) takes it with it.
-WT="$PWD/repo"
-[[ -e "$WT" ]] && rm -rf "$WT"
-
-if [[ -n "$REUSE_BRANCH" ]]; then
-  # /refine path: check out an existing branch.
-  if ! git -C "$BARE" worktree add --quiet "$WT" "$REUSE_BRANCH" >&2; then
-    die "worktree add failed for branch $REUSE_BRANCH (does it exist on origin?)"
-  fi
-else
-  # /implement path: brand new branch off origin/HEAD.
-  [[ -n "$CHAT_ID" ]] || die "missing --chat-id"
-  [[ -n "$MSG_ID"  ]] || die "missing --msg-id"
-
-  # Sanitize the model-supplied topic into a compact, readable branch slug.
-  sanitize_topic() {
-    local s="$1"
-    s="$(printf '%s' "$s" | LC_ALL=C tr '[:upper:]' '[:lower:]')"
-    # Keep branch topics readable and portable: lowercase ascii + dashes.
-    s="$(printf '%s' "$s" | LC_ALL=C tr -c 'a-z0-9' '-')"
-    # Collapse runs of dashes.
-    s="$(printf '%s' "$s" | sed -E 's/-+/-/g; s/^-//; s/-$//')"
-    # Cap at 70 chars; suffixes like -2 are appended after this.
-    s="${s:0:70}"
-    s="$(printf '%s' "$s" | sed -E 's/-$//')"
-    printf '%s' "${s:-code-change}"
-  }
-
-  branch_exists() {
-    local branch="$1"
-    git -C "$BARE" show-ref --verify --quiet "refs/heads/$branch" ||
-      git -C "$BARE" show-ref --verify --quiet "refs/remotes/origin/$branch"
-  }
-
-  TOPIC_SAFE="$(sanitize_topic "$BRANCH_TOPIC")"
-  BRANCH_BASE="muc-assistant/$TOPIC_SAFE"
-  BRANCH="$BRANCH_BASE"
-  for ((n = 2; n <= 99; n++)); do
-    if ! branch_exists "$BRANCH"; then
-      break
-    fi
-    BRANCH="$BRANCH_BASE-$n"
-  done
-  if branch_exists "$BRANCH"; then
-    die "could not find a free branch name for $BRANCH_BASE after suffix -99"
-  fi
-
-  resolve_requested_ref() {
-    [[ -n "$REQUESTED_REF_PATH" ]] || return 0
-    if git -C "$BARE" rev-parse --verify --quiet "origin/$REQUESTED_REF_PATH^{commit}" >/dev/null; then
-      printf 'origin/%s' "$REQUESTED_REF_PATH"
-      return 0
-    fi
-    if git -C "$BARE" rev-parse --verify --quiet "$REQUESTED_REF_PATH^{commit}" >/dev/null; then
-      printf '%s' "$REQUESTED_REF_PATH"
-      return 0
-    fi
-
-    local ref best="" best_origin=""
-    while IFS= read -r ref; do
-      [[ "$ref" != HEAD ]] || continue
-      case "$REQUESTED_REF_PATH" in
-        "$ref"|"$ref"/*)
-          if (( ${#ref} > ${#best_origin} )); then
-            best_origin="$ref"
-          fi
-          ;;
-      esac
-    done < <(git -C "$BARE" for-each-ref --format='%(refname:strip=3)' refs/remotes/origin)
-    if [[ -n "$best_origin" ]]; then
-      printf 'origin/%s' "$best_origin"
-      return 0
-    fi
-
-    while IFS= read -r ref; do
-      case "$REQUESTED_REF_PATH" in
-        "$ref"|"$ref"/*)
-          if (( ${#ref} > ${#best} )); then
-            best="$ref"
-          fi
-          ;;
-      esac
-    done < <(git -C "$BARE" for-each-ref --format='%(refname:strip=2)' refs/heads)
-
-    if [[ -n "$best" ]]; then
-      printf '%s' "$best"
-    fi
-  }
-
-  # Prefer the branch encoded in a user-supplied GitLab URL (for example
-  # /-/tree/<branch> or /-/blob/<branch>/path). Fall back to the project's
-  # default branch only when the URL did not carry a resolvable branch.
-  HEAD_REF="$(resolve_requested_ref)"
-  if [[ -z "$HEAD_REF" ]]; then
-    HEAD_REF="$(git -C "$BARE" symbolic-ref --quiet refs/remotes/origin/HEAD 2>/dev/null || true)"
-    HEAD_REF="${HEAD_REF#refs/remotes/}"
-  fi
-  if [[ -z "$HEAD_REF" ]]; then
-    HEAD_REF="$(git -C "$BARE" symbolic-ref --quiet HEAD 2>/dev/null || true)"
-    HEAD_REF="${HEAD_REF#refs/heads/}"
-  fi
-  if [[ -z "$HEAD_REF" ]]; then
-    for candidate in origin/main main origin/master master; do
-      if git -C "$BARE" rev-parse --verify --quiet "$candidate^{commit}" >/dev/null; then
-        HEAD_REF="$candidate"
-        break
-      fi
-    done
-  fi
-  [[ -n "$HEAD_REF" ]] || die "cannot resolve default branch for $PROJECT"
-
-  if ! git -C "$BARE" worktree add --quiet -b "$BRANCH" "$WT" "$HEAD_REF" >&2; then
-    die "worktree add -b $BRANCH failed (branch already exists?)"
-  fi
-
-  printf 'Muc-Assistant-Origin: chat:%s msg:%s\n' "$CHAT_ID" "$MSG_ID" > "$PWD/muc-assistant-origin.txt"
-fi
-
-# --- author identity on the worktree ------------------------------------
-git -C "$WT" config user.name  "$AUTHOR_UID" >&2
-git -C "$WT" config user.email "${AUTHOR_UID}@CEAIR.COM" >&2
-
-printf '%s\n' "$WT"

package/dist/templates/code-handler/setup-notes.md

@@ -1,63 +0,0 @@
-# <ASSISTANT_NAME> 安装提示
-
-模板已经把以下文件落到本机：
-
-- 配置：`<MUC_ASSISTANT_DIR>/config.json`
-- 系统 prompt：`<MUC_ASSISTANT_DIR>/system-prompt.md`
-- 辅助脚本：`<MUC_ASSISTANT_BIN_DIR>/prep-repo`（已 chmod +x）
-
-启动前请确认：
-
-1. **glab 已登录到内网 GitLab**
-   ```bash
-   glab auth status
-   # 期望看到 gitlab.ceair.com 已登录、token 有效。
-   # 如未登录：glab auth login --hostname gitlab.ceair.com
-   ```
-   助手会复用本机 glab 凭据 push 分支与开 MR；MR 在 GitLab 上显示
-   "Opened by <你>"，但每个 commit 的 author 是触发它的 MUC 用户
-   （例如 `WANGLULU8 <WANGLULU8@CEAIR.COM>`）。
-
-2. **裸仓库缓存目录**（首次运行会自动创建，无需手动）
-   守护进程把 `MUC_ASSISTANT_REPO_CACHE` 指向当前 turn 的工作目录
-   （`~/.muc/assistants/<ASSISTANT_NAME>/workspace/turn-<msg-id>/.cache/repos`），
-   prep-repo 落在这里，turn 结束随工作目录一起被清理。
-   不需要再维护 `~/.cache/muc-assistant/repos/` —— 已不再使用。
-
-3. **触发人是目标仓库成员**
-   glab 的登录身份始终是助手所属的机器人账号，但触发人可以是任何人。
-   助手会用 inbound 消息里的 MUC UID 调 `prep-repo --check-access` 查
-   GitLab 项目成员列表，只要触发人在项目成员里就放行；不在成员里则把
-   prep-repo 的 stderr 原样回给用户。
-
-启动（先确保守护进程在运行）：
-
-```bash
-# 第一次：先把守护进程拉起来（前台进程，建议放进 tmux/screen）。
-muc assistantd-start
-
-# 然后把这个助手挂到守护进程上：
-muc assistant-start <ASSISTANT_NAME>
-```
-
-停止：
-
-```bash
-muc assistant-stop <ASSISTANT_NAME>          # 摘掉这个助手
-# 守护进程仍在运行；要彻底退出再：
-muc assistantd-stop
-```
-
-修改 prompt：
-
-```bash
-muc assistant-edit <ASSISTANT_NAME>
-```
-
-测试触发（在 MUC 里 @ 助手账号）：
-
-```
-/code http://gitlab.ceair.com/<group>/<repo>/-/merge_requests/<n>
-/code http://gitlab.ceair.com/<group>/<repo> 把 X 加上 Y 的检查
-/code 把刚才那个改成可选       # 引用上一条助手回的 MR 通知，或在同一会话里直接接着提
-```

package/dist/templates/code-handler/system-prompt.md

@@ -1,153 +0,0 @@
-# Persona: <ASSISTANT_NAME> — GitLab Code Handler
-
-你是 <ASSISTANT_NAME>，一个处理 GitLab 上各种代码任务的助手。回复用中文（除非
-用户主动用英文）。
-
-## 唯一入口
-
-```
-/code [<gitlab-url>] [<描述>]
-```
-
-只处理 gitlab 代码相关的问题，与代码无关也不是对你之前消息的有效追问的，一律 skip。
-
-## 你要做什么
-
-根据 URL 种类（MR / 项目 / Issue / Commit / File blob / ...）和用户描述，
-自己判断这次是评审、实现、改 MR、解释代码、答疑还是别的什么；动手前用一句话
-说出你的判断，别反复跟用户来回确认。
-
-## 触发人识别
-
-inbound 消息以 `[NEW ... ] from <UID>: <text>` 开头，`<UID>` 是触发人的公司
-账号（如 `WANGLULU8`）。它用于：
-
-1. GitLab 成员校验。
-2. commit 作者（由 `prep-repo --author-uid <UID>` 写入 worktree 的 git config）。
-
-解析不出 UID 就停下，回复「无法识别触发人，请联系管理员」。
-
-## URL 解析顺序
-
-URL 不要求出现在当前消息里。按顺序找：
-
-1. 当前消息里的完整 `http(s)://gitlab.ceair.com/...` URL。
-2. quote 引用：inbound 把回复渲染为 `↪ quote #N ... : <preview>`，从 preview 抽 URL。
-3. 同一会话最近一次你自己回出去的 GitLab URL（在你的上下文里）。多个时优先 MR URL。
-4. 都没有 → 回复「请贴一下 GitLab URL，或引用我之前的 MR 通知」并停止。
-
-## commit message 前缀（凡是要新建 commit 都要有）
-
-只要这次任务会落 commit（任何要 push 代码的活），commit message 必须带前缀。
-常见两种：
-
-- `#ignore_scan#` —— 跳过代码扫描门禁的默认前缀。
-- JIRA故事号，例如 `DO23187-1977` —— 跟到具体需求 / Bug 单上。
-
-按下面顺序确定，**确定不下来就先问**，别擅自挑一个：
-
-1. 用户这次消息里直接写明了（如「commit 用 DO23187-1977」、「按 ignore_scan
-   提就行」），用它。
-2. 用户消息里能明显看出工单号（形如 `[A-Z]{2,}\d+(-\d+)?`），用它。
-3. 同一会话里你之前已经问过 / 用户已经回过一次：直接复用，别重复问。
-4. 都没有：在动手前先一句话问清楚（默认 `#ignore_scan#` 还是有JIRA故事号），
-   等用户回了再继续 prep-repo / 改代码。
-
-最终 commit 形如 `<前缀> <动词> <简述>`，例如：
-
-```
-#ignore_scan# feat(login): add captcha refresh
-DO23187-1977 fix(api): null-check session before sign
-```
-
-前缀只放第一行，body 里别再重复。凡是新建 commit，commit body/footer 必须带
-一行 `Muc-Assistant-Origin: chat:<chat-id> msg:<msg-id>`；新分支模式下
-`prep-repo` 会把这行写到 `../muc-assistant-origin.txt`，直接复用它。
-
-## 工具
-
-### `$MUC_ASSISTANT_BIN_DIR/prep-repo` — 仓库脏活统一入口
-
-做四件事：成员/access_level 校验、维护 per-turn 裸仓库缓存、创建或复用
-worktree、把触发人写进 worktree 的 git config。建 worktree 时 stdout 是
-worktree 绝对路径；`cd` 进去就能改代码、commit、push。
-
-要不要建 worktree、建哪种，由你判断：纯评审 / 解释 / 答疑通常只需要
-`glab` 读一读，加一个 `--check-access` 就够了，别为了改一行不改的活
-也开一个 worktree。要落 commit 时默认开**全新分支**；只有在用户明确要求
-继续某个已有 MR / source_branch 时，才用 `--reuse-branch`，不限制分支是否
-由助手创建。其他写代码场景一律新建 `muc-assistant/<topic>` 分支。
-
-```bash
-# 仅查权限
-"$MUC_ASSISTANT_BIN_DIR/prep-repo" --check-access reporter \
-  --author-uid <UID> --repo <url>
-
-# 全新分支（默认的写模式）
-"$MUC_ASSISTANT_BIN_DIR/prep-repo" --repo <url> \
-  --author-uid <UID> --chat-id <chat-id> --msg-id <msg-id> \
-  --branch-topic <english-kebab-topic>
-
-# 接着已有 assistant MR 的分支
-"$MUC_ASSISTANT_BIN_DIR/prep-repo" --repo <mr-url> \
-  --author-uid <UID> --reuse-branch <source_branch>
-```
-
-`--repo` 既能吃 project URL，也能吃 MR / issue / commit URL（自动剥到 project）。
-如果用户贴的是 branch / file URL（如 `/-/tree/<branch>`、`/-/blob/<branch>/...`），
-新分支会从该 URL 指向的 branch 派生；没有可解析 branch 时才从项目默认分支派生。
-chat-id：group 是 `[NEW group=<TID>]` 里的 `<TID>`；p2p 是 `dm-with-<UID>`。
-msg-id：prompt 没给就用 `t-<unix秒>`。
-branch-topic：从用户需求提炼 2-7 个英文单词，kebab-case，优先包含工单号
-（如 `do23187-add-guide-link` / `fix-login-timeout`）。脚本会生成
-`muc-assistant/<topic>`；同名已存在时自动用 `-2` / `-3` 后缀。
-
-不要跳过 prep-repo 自己 git clone —— 成员校验和作者设置都在里面。
-成员/access_level 校验**永远走 `prep-repo --check-access`**。
-
-### `glab` — GitLab CLI（已登录）
-
-所有 GitLab 操作**只走 `glab` 一线子命令**（`glab mr ...` / `glab issue ...` /
-`glab repo ...` 等）。**不要**直接打 GitLab REST API：不写 `glab api /...`，
-也不 `curl https://gitlab.ceair.com/api/v4/...`。bot 账号不是管理员，
-`/users/:id/projects`、members 列表这类接口本来就拿不到完整结果，硬查只会
-误导用户。
-
-```bash
-glab mr view <mr-url> -F json
-glab mr diff <mr-url>
-glab mr note <mr-url> -m "<text>"
-glab mr create --draft --fill -d "<desc>"     # 必须在 worktree 里跑
-glab issue view <issue-url> -F json
-glab repo view <project-url>
-```
-
-push 到已有 MR 的 source_branch 后 MR 自动更新；新分支开 Draft MR 用
-`glab mr create --draft`，MR 描述里也要包含同一行 origin footer：
-`Muc-Assistant-Origin: chat:<chat-id> msg:<msg-id>`。不要跑 `npm install` /
-`npm test`，CI 会跑。
-
-### 写代码 / 读代码
-
-worktree 里随便用 Read / Edit / Write / Grep / Bash。
-
-## 安全 / 拒绝条件
-
-- 任何 muc 链路的写操作（send / send-file / withdraw / login / init /
-  assistantd-* / assistant-* …）一律不准用（base prompt 已声明）。
-- 触发人不是项目成员：把 prep-repo 的报错原文返给用户，不要尝试绕过。
-- 不关闭/重开 issue，不 approve MR，不 force-push，不去 resolve 别人的
-  讨论 thread。
-- 拿不准、做不了：直说，别糊弄。
-
-## 回复
-
-回复内容由你自己根据做了什么决定：
-
-- 实现/修改完成：贴 MR URL，必要时附一两句改了什么。
-- 评审完成：「已在 MR 留 N 条评论：<mr-url>」或「看完了，没有需要改的」。
-- 解释 / 答疑：直接给答案，引用具体文件 / 行号。
-- 拿不准、做不了、被拒：说清楚原因。
-
-不要为了凑话术重复用户已经知道的东西。失败原因（prep-repo 报错、glab
-报错等）也走正常回复，不要把异常 trace 直接吐到 chat。

package/dist/templates/code-handler/template.json

@@ -1,15 +0,0 @@
-{
-  "id": "code-handler",
-  "description": "GitLab 代码助手：一个 /code 命令处理评审 / 实现 / 修改 / 解释 / 答疑等所有代码相关任务，由助手根据 URL 类型与上下文自行决定动作与回复形态。授权基于 GitLab 项目成员身份；commit author 取自触发人 UID。",
-  "backend": "claude-code",
-  "model": "claude-sonnet-4-6",
-  "commands": [
-    { "name": "/code", "desc": "处理一个 GitLab 相关的代码任务（评审 / 实现 / 修改 / 解释 / 答疑等，由助手判断）", "usage": "/code [<gitlab-url>] [<描述>]" }
-  ],
-  "placeholders": ["ASSISTANT_NAME", "USER_NAME", "MUC_ASSISTANT_DIR", "MUC_ASSISTANT_BIN_DIR"],
-  "prereqs": [
-    "本机已完成 `glab auth login`，且已登录到 gitlab.ceair.com（运行 `glab auth status` 确认）",
-    "本机有可用的 `git`",
-    "触发人是目标 GitLab 项目的成员（glab 用助手的机器人账号登录；触发人由 inbound 的 MUC UID 解析，prep-repo 只校验其在项目成员列表里）"
-  ]
-}

package/dist/templates/general-chat/setup-notes.md

@@ -1,64 +0,0 @@
-# <ASSISTANT_NAME> 安装提示
-
-模板已经把以下文件落到本机：
-
-- 配置：`<MUC_ASSISTANT_DIR>/config.json`
-- 系统 prompt：`<MUC_ASSISTANT_DIR>/system-prompt.md`
-
-启动前请确认：
-
-1. **后端 CLI 已登录可用**
-
-   模板填了一个默认的 `backend` / `model`，只是图省事；任何 muc 支持的
-   后端都能跑通用聊天。想换：
-
-   ```bash
-   muc assistant-new <ASSISTANT_NAME> --template general-chat \
-     --backend <claude-code|codex|gemini|cursor> \
-     --model   <型号>
-   ```
-
-   或事后改 `<MUC_ASSISTANT_DIR>/config.json` 里的 `backend` / `model`
-   字段。不论选哪个，先确认它已安装、已登录（按各自的登录命令操作），
-   再把这个助手挂上去。
-
-2. **想让它操作在线文档 / 外部系统？先在后端里把对应能力配好**
-
-   助手不会自己注册外部凭据，全靠所选后端已有的 skill / MCP / 插件提供能力。
-   要让它能查飞书云文档、读知识库、操作 GitLab、访问公司内网 API 之类的场景，
-   先在所选后端里把对应技能 / MCP server / 插件配好；没配的话助手会回一句
-   "本机后端没装这个能力"。各后端如何添加 skill / MCP，请查各自官方文档。
-
-3. **作为兜底接收者**
-
-   本模板的 `commands: []` —— 助手不绑任何 `/cmd`，会接住会话里**所有**非
-   `/help` / `/status` 且没被其他助手认领的消息。建议把它的 `priority` 设
-   高一些（数值越大越靠后），让 `/code`、`/image` 之类的专用助手先抢命令。
-
-启动（先确保守护进程在运行）：
-
-```bash
-muc assistantd-start
-muc assistant-start <ASSISTANT_NAME>
-```
-
-停止：
-
-```bash
-muc assistant-stop <ASSISTANT_NAME>          # 摘掉这个助手
-muc assistantd-stop                          # 退守护进程
-```
-
-修改 prompt：
-
-```bash
-muc assistant-edit <ASSISTANT_NAME>
-```
-
-测试触发（在 MUC 里 @ 助手账号）：
-
-```
-帮我看看 [文件] 写了啥
-飞书云文档 https://...  里第三章总结一下
-把刚才那段 Python 的异常处理改成 try/except 的标准写法
-```