#!/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 /.agents/skills and are # mirrored to /.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 watch="${REPO_ROOT}/skills/kvb-org-organize/scripts/watch.py" if [[ -f "${watch}" ]] && ! python3 -I "${watch}" preflight; then warn "skills: add the keys above to the agents council config first; the new hooks and queue.py refuse to run without them" exit 2 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 config="${AGENTS_COUNCIL_CONFIG:-${HOME}/.claude/agents-council/config.json}" shipped="${REPO_ROOT}/skills/kvb-org-organize/config.default.json" if [[ -f "${shipped}" && ! -e "${config}" && ! -L "${config}" ]]; then [[ -d "$(dirname -- "${config}")" ]] || install -d -m 0700 "$(dirname -- "${config}")" if (umask 077 && set -o noclobber && cat -- "${shipped}" >"${config}") 2>/dev/null; then log "skills: wrote the shipped agents council config to ${config}" else warn "skills: kept ${config}, which appeared while the install wrote the shipped default" 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 false); then log "skills: daemon auto_index off; the kvb-agent-optimize graph.py hook indexes every git root a session touches, the session root included, through its size and memory gates" else warn "skills: codebase-memory-mcp is not runnable from PATH; the code graph stays off (see kvb-agent-optimize)." fi graph_config="${XDG_CONFIG_HOME:-${HOME}/.config}/kvb-code-graph/config.json" graph_settings="" if [[ -f "${graph_config}" ]]; then graph_settings="$(<"${graph_config}")" fi if [[ "${graph_settings}" != *'"queue_file_threshold"'* || "${graph_settings}" != *'"queue_task"'* ]]; then warn "skills: kvb-code-graph: no config at ${graph_config} with queue_file_threshold and queue_task; the graph.py hook indexes nothing until the operator sets both (see kvb-agent-optimize)." fi if command -v systemctl &>/dev/null && systemctl --user show-environment &>/dev/null && [[ -x "${HOME}/.local/bin/codebase-memory-mcp" ]]; then log "skills: enabling kvb-code-graph.service, which keeps a permanent codebase-memory-mcp daemon so every graph stays watched" mkdir -p "${HOME}/.config/systemd/user" cp -f "${REPO_ROOT}/skills/kvb-agent-optimize/systemd/kvb-code-graph.service" "${HOME}/.config/systemd/user/" systemctl --user daemon-reload systemctl --user try-restart kvb-code-graph.service || true if ! systemctl --user enable --now kvb-code-graph.service; then systemctl --user enable kvb-code-graph.service || true log "skills: kvb-code-graph.service enabled; it did not start now and takes effect at next login." fi else warn "skills: no systemd user session or no ~/.local/bin/codebase-memory-mcp; graphs keep their watch only while a session runs." 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}"