councilroot.py resolves one durable council root for every script and migrates the old /tmp root under the held locks: a preflight conflict moves nothing, each legacy file is renamed to a staging name before it is copied so a late writer is merged by the catch-up, id-less journals merge by line multiset, a differing whole file is kept beside its namesake, and a crash marker makes install copy the skills and report. One settings-file list, managed drop-ins included, serves councilroot.py and queue.py. Tests run once on unify/skills-20261114 after the merge (operator order 2026-11-14). 🎯 Fix: 88 % 💥 Break: 7 % 💸 Tokens: 100 % ⏱️ Velocity: 100 % 🛡️ Security: 100 % 🏆 Score: 82 🚦 Gate: ⛔ fix 88 % < 90, break 7 % > 5 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
197 lines
8.2 KiB
Bash
197 lines
8.2 KiB
Bash
#!/usr/bin/env bash
|
|
# Render the skills from skills-lock.json and copy them into TARGET.
|
|
# TARGET defaults to $HOME (global install); pass a project root to
|
|
# equip that project. Skills land in <TARGET>/.agents/skills and are
|
|
# mirrored to <TARGET>/.claude/skills. A project install links every skill
|
|
# the global install in $HOME already holds to that copy instead.
|
|
set -euo pipefail
|
|
|
|
SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
|
|
REPO_ROOT="$(cd -- "${SCRIPT_DIR}/.." && pwd)"
|
|
TARGET="${TARGET:-${HOME}}"
|
|
|
|
log() { printf '%s\n' "$*"; }
|
|
warn() { printf '%s\n' "$*" >&2; }
|
|
|
|
if ! command -v npx &>/dev/null; then
|
|
warn "skills: npx not found — install Node.js first: https://nodejs.org"
|
|
exit 1
|
|
fi
|
|
|
|
if [[ ! -d "${TARGET}" ]]; then
|
|
warn "skills: TARGET does not exist: ${TARGET}"
|
|
exit 2
|
|
fi
|
|
|
|
council_root="${REPO_ROOT}/skills/kvb-org-organize/scripts/councilroot.py"
|
|
has_user_systemd() { command -v systemctl &>/dev/null && systemctl --user show-environment &>/dev/null; }
|
|
resume_units() {
|
|
bash "${REPO_ROOT}/scripts/orchestrator.sh" start || true
|
|
if has_user_systemd; then systemctl --user start kvb-org-queue-cleanup.timer kvb-org-queue-cleanup.path || true; fi
|
|
}
|
|
# Args: extra councilroot.py migrate arguments. Returns its exit code; on 3
|
|
# or 5 every file it left behind or kept beside its namesake is named on stderr.
|
|
migrate_council() {
|
|
local report code=0
|
|
report="$(python3 "${council_root}" migrate "$@")" || code=$?
|
|
log "${report}"
|
|
if ((code == 3 || code == 5)); then
|
|
warn "skills: the council root migration left these files in the earlier root or beside their namesakes; merge them by hand, the install exits 1 at the end:"
|
|
grep -E '^(unmoved|conflict|kept) ' <<<"${report}" | sed 's/^/skills: /' >&2 || true
|
|
fi
|
|
return "${code}"
|
|
}
|
|
status=0
|
|
if [[ "${TARGET}" == "${HOME}" ]]; then
|
|
if ! python3 "${council_root}" preflight; then
|
|
warn "skills: install refused before copying anything; the installed skills keep the earlier council root until the reasons above are gone."
|
|
exit 1
|
|
fi
|
|
fi
|
|
|
|
cd "${REPO_ROOT}"
|
|
src="${REPO_ROOT}/.agents/skills"
|
|
rm -rf "${src}"
|
|
log "skills: restoring from skills-lock.json..."
|
|
npx --yes skills experimental_install
|
|
|
|
if [[ ! -d "${src}" ]]; then
|
|
warn "skills: ${src} not found after install."
|
|
exit 1
|
|
fi
|
|
|
|
if [[ -d "${REPO_ROOT}/skills" ]]; then
|
|
log "skills: adding first-party skills from skills/..."
|
|
cp -a "${REPO_ROOT}/skills/." "${src}/"
|
|
fi
|
|
|
|
if [[ "${TARGET}" == "${HOME}" ]]; then
|
|
install -d -m 0700 "$(python3 "${council_root}" durable)"
|
|
if has_user_systemd; then
|
|
systemctl --user stop kvb-org-queue-cleanup.path kvb-org-queue-cleanup.timer kvb-org-queue-cleanup.service &>/dev/null || true
|
|
fi
|
|
if ! bash "${REPO_ROOT}/scripts/orchestrator.sh" stop; then
|
|
resume_units
|
|
warn "skills: install refused before copying anything: the Agent Orchestrator did not stop."
|
|
exit 1
|
|
fi
|
|
moved=0
|
|
migrate_council || moved=$?
|
|
marker="$(python3 "${council_root}" durable)/migrate.started"
|
|
if [[ -e "${marker}" ]]; then
|
|
warn "skills: the council root migration stopped halfway (exit ${moved}): ${marker} exists; the install copies the new skills so they read the new root and exits 1 at the end; 'python3 ${council_root} migrate --catch-up' finishes the move and removes ${marker}."
|
|
status=1
|
|
elif ((moved == 3 || moved == 5)); then
|
|
status=1
|
|
elif ((moved != 0)); then
|
|
resume_units
|
|
warn "skills: install refused before copying anything: the council root migration failed (exit ${moved}); run the install again once the reasons above are gone."
|
|
exit 1
|
|
fi
|
|
fi
|
|
|
|
for root in .agents/skills .claude/skills; do
|
|
dst="${TARGET}/${root}"
|
|
log "skills: copying -> ${dst}"
|
|
mkdir -p "${dst}"
|
|
find -H "${dst}" -mindepth 1 -delete
|
|
cp -a "${src}/." "${dst}/"
|
|
find -H "${dst}" \( -name __pycache__ -o -name '*.py[co]' \) -prune -exec rm -rf {} +
|
|
if [[ ! "${TARGET}" -ef "${HOME}" ]]; then
|
|
log "skills: linking in ${dst} what ${HOME}/${root} already holds"
|
|
for skill in "${dst}"/*; do
|
|
global="${HOME}/${root}/${skill##*/}"
|
|
if [[ -e "${global}" ]]; then
|
|
rm -rf "${skill}"
|
|
ln -s "${global}" "${skill}"
|
|
fi
|
|
done
|
|
fi
|
|
done
|
|
|
|
if [[ "${TARGET}" == "${HOME}" ]]; then
|
|
caught=0
|
|
migrate_council --catch-up || caught=$?
|
|
if ((caught != 0)); then
|
|
status=1
|
|
fi
|
|
if ((caught != 0 && caught != 3 && caught != 5)); then
|
|
warn "skills: the catch-up council root migration failed (exit ${caught}); what the old skills wrote during the install stays in the earlier root until 'python3 ${council_root} migrate --catch-up' succeeds."
|
|
fi
|
|
fi
|
|
|
|
settings="${TARGET}/.claude/settings.local.json"
|
|
if command -v node &>/dev/null; then
|
|
log "skills: auto-enabling caveman + ponytail plugins in ${settings}"
|
|
node "${REPO_ROOT}/scripts/enable-plugins.js" "${settings}"
|
|
if [[ "${TARGET}" -ef "${HOME}" ]]; then
|
|
node "${REPO_ROOT}/scripts/council-deny.js" "${HOME}/.claude/settings.json"
|
|
fi
|
|
else
|
|
warn "skills: node not found; skipped auto-enabling caveman/ponytail plugins."
|
|
fi
|
|
|
|
if [[ "${TARGET}" == "${HOME}" ]]; then
|
|
if has_user_systemd; then
|
|
log "skills: enabling the daily kvb-dream notification timer and the kvb-org-queue-cleanup rounds at 00:00, 12:00 and on request"
|
|
units="${HOME}/.config/systemd/user"
|
|
mkdir -p "${units}"
|
|
cp -f "${REPO_ROOT}/skills/kvb-dream/systemd/kvb-dream-notify.service" "${REPO_ROOT}/skills/kvb-dream/systemd/kvb-dream-notify.timer" "${units}/"
|
|
cp -f "${REPO_ROOT}/skills/kvb-org-queue-cleanup/systemd/kvb-org-queue-cleanup."{service,timer,path} "${units}/"
|
|
systemctl --user daemon-reload
|
|
systemctl --user enable --now kvb-dream-notify.timer kvb-org-queue-cleanup.timer kvb-org-queue-cleanup.path
|
|
else
|
|
warn "skills: no systemd user session; skipped the kvb-dream notification timer and the kvb-org-queue-cleanup rounds."
|
|
fi
|
|
if command -v docker &>/dev/null; then
|
|
if ! bash "${REPO_ROOT}/scripts/orchestrator.sh" install; then
|
|
warn "skills: the Agent Orchestrator is down or partly installed; run 'bash scripts/orchestrator.sh install' once the reasons above are gone."
|
|
status=1
|
|
fi
|
|
bash "${REPO_ROOT}/scripts/orchestrator.sh" runner || true
|
|
else
|
|
warn "skills: docker not found; skipped the Agent Orchestrator."
|
|
fi
|
|
log "skills: installing or updating the codebase-memory-mcp code graph for every detected agent"
|
|
if ! curl -fsSL --proto '=https' https://raw.githubusercontent.com/DeusData/codebase-memory-mcp/main/install.sh | bash; then
|
|
warn "skills: the codebase-memory-mcp installer failed; the code graph keeps its previous setup."
|
|
fi
|
|
if (ulimit -c 0; codebase-memory-mcp config set auto_index true); then
|
|
log "skills: auto-indexing every repository a session opens into the code graph"
|
|
else
|
|
warn "skills: codebase-memory-mcp is not runnable from PATH; the code graph stays off (see kvb-agent-optimize)."
|
|
fi
|
|
if command -v medusa &>/dev/null; then
|
|
log "skills: the MEDUSA security scanner is installed"
|
|
elif ! command -v pipx &>/dev/null; then
|
|
warn "skills: pipx not found; install the MEDUSA scanner with 'pip install --user medusa-security'. Until then kvb-check-security reviews by hand."
|
|
elif pipx install medusa-security; then
|
|
log "skills: installed the MEDUSA security scanner for kvb-check-security"
|
|
else
|
|
warn "skills: the MEDUSA install failed; kvb-check-security reviews by hand."
|
|
fi
|
|
lizard_pin="lizard==1.24.1"
|
|
if command -v lizard &>/dev/null; then
|
|
log "skills: lizard is installed"
|
|
elif ! command -v pipx &>/dev/null; then
|
|
warn "skills: pipx not found; install lizard with 'pipx install ${lizard_pin}'. Until then principles.py skips its complexity hits."
|
|
elif pipx install "${lizard_pin}"; then
|
|
log "skills: installed ${lizard_pin} for the principles.py complexity hits"
|
|
else
|
|
warn "skills: the lizard install failed; principles.py skips its complexity hits."
|
|
fi
|
|
jscpd_pin="jscpd@5.4.2"
|
|
if command -v jscpd &>/dev/null; then
|
|
log "skills: jscpd is installed"
|
|
elif ! command -v npm &>/dev/null; then
|
|
warn "skills: npm not found; install jscpd with 'npm install --global --prefix ~/.local ${jscpd_pin}'. Until then principles.py skips its clone hits."
|
|
elif npm install --global --prefix "${HOME}/.local" "${jscpd_pin}"; then
|
|
log "skills: installed ${jscpd_pin} into ~/.local/bin for the principles.py clone hits"
|
|
else
|
|
warn "skills: the jscpd install failed; principles.py skips its clone hits."
|
|
fi
|
|
fi
|
|
|
|
log "skills: done. Restart your agent to load the skills."
|
|
exit "${status}"
|