deck-sync

deck-sync

Overview

Brings a deck repo's copies up to the plugin version. Rule copies and deck/vendor/ are overwritten from the plugin; deck/shell.html belongs to the deck and is only diffed. A rule copy edited by hand at the current version is left alone unless the user agrees to --force. .claude/rules/deck-local.md holds deck-specific exceptions and is never read or written.

When to use

• deck-check printed rules: ... stale, missing or unstamped, or vendor: differs.
• The user updated the deck plugin and wants the repo to follow.
• Not for a repo without deck/ (use deck-new).

Procedure

Interaction gate: Claude uses AskUserQuestion; Codex uses request_user_input when exposed, otherwise asks in plain text and waits. Shell state does not persist between tool calls, so keep the resolver in the same call as each command.

1. Inspect first, from the repo root.

   PLUGIN_ROOT="${PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-}}"
   [ -z "$PLUGIN_ROOT" ] && [ -f plugins/deck/scripts/kit.py ] && PLUGIN_ROOT=plugins/deck
   if [ -z "$PLUGIN_ROOT" ]; then
     # find, not a glob: zsh aborts on an unmatched glob and does not split an unquoted list.
     found=$(find "$HOME/.claude/plugins/cache" "${CODEX_PLUGIN_CACHE:-$HOME/.codex/plugins/cache}" \
       -mindepth 3 -maxdepth 3 -type d -path '*/deck/*' 2>/dev/null | awk -F/ '{print $NF "\t" $(0)}')
     if sort -V </dev/null >/dev/null 2>&1; then
       PLUGIN_ROOT=$(printf '%s\n' "$found" | sort -V | tail -1 | cut -f2-)
     else
       PLUGIN_ROOT=$(printf '%s\n' "$found" | sort -t. -k1,1n -k2,2n -k3,3n | tail -1 | cut -f2-)
     fi
   fi
   [ -f "$PLUGIN_ROOT/scripts/kit.py" ] || { echo "deck plugin scripts not found; export PLUGIN_ROOT=<path to plugins/deck>"; exit 1; }
   PY=$(command -v python3 || command -v python)
   "$PY" "$PLUGIN_ROOT/scripts/kit.py" check . --diff
   

   Observable result: one rules: line per copy with its status, unified diffs for stale, edited and unstamped copies, and vendor: / shell.html: / frontend-slides: lines.