orca-multiagent-kit 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (63) hide show
  1. package/AI_INSTALL.md +3 -0
  2. package/CHANGELOG.md +51 -1
  3. package/README.md +10 -4
  4. package/VERSION +1 -1
  5. package/bin/omk.js +54 -20
  6. package/bin/ui.js +165 -0
  7. package/core/AGENTS.md +32 -29
  8. package/docs/CSR.md +95 -0
  9. package/docs/INSTALADOR-ORCA-WINDOWS.md +101 -0
  10. package/docs/MANUAL.md +3 -1
  11. package/docs/ORQUESTADOR.md +123 -0
  12. package/docs/PLUGIN-ORCA.md +102 -0
  13. package/install.sh +282 -92
  14. package/orca-plugin/.gitattributes +1 -0
  15. package/orca-plugin/README.md +12 -0
  16. package/orca-plugin/orca-plugin.json +80 -0
  17. package/orca-plugin/src/kit.test.ts +174 -0
  18. package/orca-plugin/src/kit.ts +141 -0
  19. package/orca-plugin/src/worker.test.ts +155 -0
  20. package/orca-plugin/src/worker.ts +182 -0
  21. package/orca-plugin/tsconfig.json +6 -0
  22. package/package.json +2 -2
  23. package/rules/00-router.md +2 -1
  24. package/rules/10-communication.md +11 -12
  25. package/rules/20-clean-code.md +7 -3
  26. package/rules/30-security.md +1 -1
  27. package/rules/31-security-audit.md +6 -2
  28. package/rules/32-ai-security.md +59 -0
  29. package/rules/40-testing.md +7 -0
  30. package/rules/50-done-gate.md +20 -17
  31. package/rules/60-git-workflow.md +1 -1
  32. package/rules/75-reliability.md +3 -3
  33. package/rules/80-supply-chain.md +18 -11
  34. package/rules/95-multi-agent.md +30 -9
  35. package/rules/lang/cpp.md +1 -1
  36. package/rules/lang/csharp.md +4 -4
  37. package/rules/lang/dart-flutter.md +1 -1
  38. package/rules/lang/infra.md +3 -4
  39. package/rules/lang/kotlin.md +1 -1
  40. package/rules/lang/php.md +1 -1
  41. package/rules/lang/shell.md +17 -1
  42. package/skills/csr-audit/SKILL.md +6 -5
  43. package/skills/csr-gate/SKILL.md +12 -8
  44. package/skills/csr-stack/SKILL.md +6 -3
  45. package/skills/orca/SKILL.md +17 -12
  46. package/skills/orca/references/adapters/artifact.md +1 -1
  47. package/skills/orca/references/adapters/chat.md +1 -1
  48. package/skills/orca/references/adapters/native-plan.md +1 -1
  49. package/skills/orca/references/adapters/plan-file.md +1 -1
  50. package/skills/orca/references/adapters/speckit.md +2 -0
  51. package/skills/orca/references/engine-manual.md +5 -5
  52. package/skills/orca/references/engine-orca.md +64 -23
  53. package/skills/orca/references/engine-subagents.md +13 -4
  54. package/skills/orca/references/integrate.md +27 -15
  55. package/skills/orca/references/ledger.md +56 -0
  56. package/skills/orca/references/race.md +1 -0
  57. package/skills/orca/references/setup.md +3 -2
  58. package/skills/orca/references/units.md +7 -0
  59. package/skills/orca/references/worker-contract.md +24 -11
  60. package/skills/speckit-orca-implement/SKILL.md +2 -0
  61. package/speckit-extension/orca/commands/implement.md +2 -0
  62. package/templates/ORCHESTRATION.md +4 -0
  63. package/templates/STACK.md +2 -2
package/install.sh CHANGED
@@ -12,10 +12,33 @@
12
12
  set -Eeuo pipefail
13
13
 
14
14
  SRC="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
15
- AG="${AGENT_KIT_HOME:-$HOME/.agents}"
16
- CLAUDE_DIR="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
17
- GEMINI_DIR="${GEMINI_DIR:-$HOME/.gemini}"
18
- CODEX_DIR="${CODEX_HOME:-$HOME/.codex}"
15
+
16
+ # Ruta en formato Windows (C:\..., la que inyectan Orca o PowerShell) -> formato POSIX de este bash.
17
+ to_posix() { # $1 ruta -> stdout
18
+ case "$1" in
19
+ [A-Za-z]:[\\/]*|[A-Za-z]:|*\\*) ;;
20
+ *) printf '%s' "$1"; return 0 ;;
21
+ esac
22
+ if command -v cygpath >/dev/null 2>&1; then cygpath -u "$1"; return 0; fi
23
+ if command -v wslpath >/dev/null 2>&1; then wslpath -u "$1"; return 0; fi
24
+ local p d
25
+ p="$(printf '%s' "$1" | tr '\\' '/')"
26
+ case "$p" in [A-Za-z]:*) d="$(printf '%s' "${p%%:*}" | tr '[:upper:]' '[:lower:]')"; p="/$d/${p#?:}"; p="$(printf '%s' "$p" | tr -s '/')" ;; esac
27
+ printf '%s' "${p%/}"
28
+ }
29
+
30
+ # En Git Bash/MSYS/Cygwin, ln -s COPIA por defecto: una copia rompe la fuente única sin avisar.
31
+ # nativestrict crea un enlace nativo de Windows o falla (y entonces lo decimos).
32
+ case "$(uname -s 2>/dev/null)" in
33
+ MINGW*|MSYS*) export MSYS="${MSYS:+$MSYS }winsymlinks:nativestrict"; WINLINKS=1 ;;
34
+ CYGWIN*) export CYGWIN="${CYGWIN:+$CYGWIN }winsymlinks:nativestrict"; WINLINKS=1 ;;
35
+ *) WINLINKS=0 ;;
36
+ esac
37
+
38
+ AG="$(to_posix "${AGENT_KIT_HOME:-$HOME/.agents}")"
39
+ CLAUDE_DIR="$(to_posix "${CLAUDE_CONFIG_DIR:-$HOME/.claude}")"
40
+ GEMINI_DIR="$(to_posix "${GEMINI_DIR:-$HOME/.gemini}")"
41
+ CODEX_DIR="$(to_posix "${CODEX_HOME:-$HOME/.codex}")"
19
42
  COPILOT_DIR="$HOME/.copilot"
20
43
  CURSOR_DIR="$HOME/.cursor"
21
44
  DEVIN_DIR="$HOME/.config/devin"
@@ -29,50 +52,114 @@ OLD_SKILLS="maw-route maw-brief maw-plan maw-dispatch maw-worker maw-integrate m
29
52
  OLD_RULES="00-router.md 10-communication.md 20-clean-code.md 30-security.md 31-security-audit.md 40-testing.md 50-done-gate.md 60-git-workflow.md 70-performance.md 75-reliability.md 80-supply-chain.md 90-docs-comments.md 95-multi-agent.md comunicacion-densa.md idioma-siempre.md"
30
53
  OLD_LANGS="cpp csharp dart-flutter go infra java kotlin php python react ruby rust shell sql swift typescript web"
31
54
 
32
- PROJECT=""; PROJECT_ONLY=0; VERIFY=0; DRY=0; AGENTS=""; RESTORE=""; ADOPT=""; WARN=""
55
+ PROJECT=""; PROJECT_ONLY=0; VERIFY=0; DRY=0; AGENTS=""; RESTORE=""; ADOPT=""
33
56
  while [ $# -gt 0 ]; do
34
57
  case "$1" in
35
- --project) PROJECT="${2:-}"; shift 2 ;;
36
- --project-only) PROJECT="${2:-}"; PROJECT_ONLY=1; shift 2 ;;
58
+ --project) PROJECT="$(to_posix "${2:-}")"; shift 2 ;;
59
+ --project-only) PROJECT="$(to_posix "${2:-}")"; PROJECT_ONLY=1; shift 2 ;;
37
60
  --agents) AGENTS="${2:-}"; shift 2 ;;
38
61
  --verify) VERIFY=1; shift ;;
39
62
  --dry-run) DRY=1; shift ;;
40
63
  --restore) RESTORE="${2:-}"; shift 2 ;;
41
- --adopt) ADOPT="${2:-}"; shift 2 ;;
64
+ --adopt) ADOPT="$(to_posix "${2:-}")"; shift 2 ;;
42
65
  -h|--help) sed -n '2,12p' "$0"; exit 0 ;;
43
66
  *) echo "Opcion desconocida: $1" >&2; exit 2 ;;
44
67
  esac
45
68
  done
46
69
 
47
- step() { printf '[kit] %s\n' "$1"; }
48
- warn() { WARN="${WARN} - $1
49
- "; }
50
- run() { if [ "$DRY" -eq 1 ]; then printf ' (dry) %s\n' "$*"; else "$@"; fi; }
70
+ # ------------------------------------------------------------------ salida
71
+ # Con OMK_EVENTS=1 (lo pone omk) se emiten eventos «::tipo::…» que omk dibuja con spinner y color.
72
+ # Sin él (./install.sh), el mismo contenido en texto, con color si es una terminal.
73
+ EV="${OMK_EVENTS:-}"
74
+ C_L=''; C_D=''; C_Y=''; C_R=''; C_B=''; C_0=''
75
+ if [ -z "$EV" ] && [ -t 1 ] && [ -z "${NO_COLOR:-}" ]; then
76
+ C_L=$'\033[38;5;154m'; C_D=$'\033[2m'; C_Y=$'\033[38;5;221m'; C_R=$'\033[38;5;203m'; C_B=$'\033[1m'; C_0=$'\033[0m'
77
+ fi
78
+ TODO=""; INFO=""; MOVED=0
79
+ ev() { printf '::%s\n' "$1"; }
80
+ title() { if [ -n "$EV" ]; then ev "title::$1::${2:-}"; else printf '\n%s%s%s %s%s%s\n%s%s%s\n\n' "$C_L$C_B" "■" "$C_0" "$C_B" "$1" "$C_0" "$C_D" "${2:-}" "$C_0"; fi; }
81
+ phase() { if [ -n "$EV" ]; then ev "begin::$1"; else printf ' %s›%s %s%s%s\n' "$C_L" "$C_0" "$C_B" "$1" "$C_0"; fi; }
82
+ done_phase() { if [ -n "$EV" ]; then ev "end::${1:-}"; elif [ -n "${1:-}" ]; then printf ' %s%s%s\n' "$C_D" "$1" "$C_0"; fi; return 0; }
83
+ item() { # $1 add|keep|dry|warn|fail · $2 texto
84
+ if [ -n "$EV" ]; then ev "item::$1::$2"; return 0; fi
85
+ case "$1" in add) m="$C_L+$C_0" ;; keep) m="$C_D=$C_0" ;; dry) m="$C_Y~$C_0" ;; fail) m="${C_R}✗${C_0}" ;; *) m="$C_Y!$C_0" ;; esac
86
+ printf ' %s %s\n' "$m" "$2"; }
87
+ todo() { TODO="${TODO}$1
88
+ "; if [ -n "$EV" ]; then ev "todo::$1"; fi; return 0; }
89
+ info() { INFO="${INFO}$1
90
+ "; if [ -n "$EV" ]; then ev "info::$1"; fi; return 0; }
91
+ short() { local x="$*"; x="${x//"$SRC"/<kit>}"; printf '%s' "${x//"$HOME"/~}"; }
92
+ run() { if [ "$DRY" -eq 1 ]; then item dry "$(short "$*")"; else "$@"; fi; }
93
+ # Resumen final: pendientes, información y siguientes pasos (solo texto; omk lo dibuja él)
94
+ footer() { # $1 global|project|both
95
+ local st=""; [ -d "$BK" ] && [ "$DRY" -eq 0 ] && st="$STAMP"
96
+ if [ -n "$EV" ]; then ev "footer::$1::$st::$DRY"; return 0; fi
97
+ if [ -n "$TODO" ]; then printf '\n%sPendiente%s\n' "$C_Y$C_B" "$C_0"; printf '%s' "$TODO" | while IFS= read -r l; do printf ' %s›%s %s\n' "$C_Y" "$C_0" "$l"; done; fi
98
+ if [ -n "$INFO" ]; then printf '\n%sPara tu información%s\n' "$C_D$C_B" "$C_0"; printf '%s' "$INFO" | while IFS= read -r l; do printf ' %s· %s%s\n' "$C_D" "$l" "$C_0"; done; fi
99
+ if [ "$DRY" -eq 1 ]; then printf '\n%sSimulación: no se ha escrito nada.%s\n\n' "$C_Y" "$C_0"; return 0; fi
100
+ printf '\n%s✓ Hecho%s\n' "$C_L$C_B" "$C_0"
101
+ case "$1" in
102
+ global) printf ' %scomprobar%s ./install.sh --verify\n %sproyecto%s ./install.sh --project-only <ruta>\n' "$C_D" "$C_0" "$C_D" "$C_0" ;;
103
+ *) printf ' %ssiguiente%s en el agente: «inicializa el proyecto»\n' "$C_D" "$C_0" ;;
104
+ esac
105
+ [ -n "$st" ] && printf ' %sdeshacer%s ./install.sh --restore %s\n' "$C_D" "$C_0" "$st"
106
+ printf '\n'; }
107
+ NSK=0; for _s in $KIT_SKILLS; do NSK=$((NSK+1)); done
108
+ # Cursor guarda las reglas de usuario en su base de datos de estado: basta con buscar la ruta del núcleo.
109
+ cursor_rule_set() {
110
+ local f
111
+ for f in "$HOME/Library/Application Support/Cursor/User/globalStorage/state.vscdb" "$HOME/.config/Cursor/User/globalStorage/state.vscdb"; do
112
+ [ -f "$f" ] && grep -aq '.agents/AGENTS.md' "$f" 2>/dev/null && return 0
113
+ done
114
+ return 1; }
115
+ agent_names() { local o="" a; for a in $(printf '%s' "$AGENTS" | tr ',' ' '); do
116
+ case "$a" in claude) a="Claude Code" ;; antigravity) a="Antigravity" ;; codex) a="Codex" ;; copilot) a="Copilot CLI" ;; cursor) a="Cursor" ;; devin) a="Devin" ;; esac
117
+ o="${o:+$o · }$a"; done; printf '%s' "$o"; }
51
118
  has_agent() { case ",$AGENTS," in *",$1,"*) return 0 ;; *) return 1 ;; esac; }
52
119
 
53
- # Mueve una ruta al backup conservando su ruta relativa a $HOME.
120
+ # Ruta dentro del backup: relativa a $HOME si cuelga de el; si no, bajo _abs/ con su ruta absoluta (--restore la deshace).
121
+ backup_rel() { # $1 ruta absoluta -> stdout
122
+ case "$1" in
123
+ "$HOME"/*) printf '%s' "${1#"$HOME"/}" ;;
124
+ /*) printf '_abs%s' "$1" ;;
125
+ *) echo "Ruta no absoluta, no se puede respaldar: $1" >&2; return 1 ;;
126
+ esac
127
+ }
128
+ # Mueve una ruta al backup.
54
129
  stash() {
55
130
  local p="$1" rel
56
131
  [ -e "$p" ] || [ -L "$p" ] || return 0
57
- rel="${p#$HOME/}"
132
+ rel="$(backup_rel "$p")"
58
133
  run mkdir -p "$BK/$(dirname "$rel")"
59
134
  run mv "$p" "$BK/$rel"
135
+ MOVED=$((MOVED+1))
60
136
  }
61
137
  # Copia (sin mover) una ruta al backup.
62
138
  snapshot() {
63
139
  local p="$1" rel
64
140
  [ -e "$p" ] || return 0
65
- rel="${p#$HOME/}"
141
+ rel="$(backup_rel "$p")"
66
142
  run mkdir -p "$BK/$(dirname "$rel")"
67
143
  run cp -a "$p" "$BK/$rel"
68
144
  }
145
+ LINK_HELP="En Windows, activa el Modo de desarrollador (Configuracion > Sistema > Para programadores) o abre Git Bash como administrador, y repite. Lo ya movido esta en el backup: ./install.sh --restore $STAMP"
69
146
  # Deja $2 como enlace simbolico a $1. Si habia otra cosa, va al backup.
70
147
  link() {
71
148
  local target="$1" l="$2"
72
149
  if [ -L "$l" ] && [ "$(readlink "$l")" = "$target" ]; then return 0; fi
73
150
  stash "$l"
74
151
  run mkdir -p "$(dirname "$l")"
75
- run ln -s "$target" "$l"
152
+ run ln -s "$target" "$l" || { echo "No se pudo crear el enlace $l -> $target. $LINK_HELP" >&2; exit 1; }
153
+ }
154
+ # Antes de tocar nada: en Windows, comprueba que se pueden crear enlaces nativos.
155
+ check_links() {
156
+ [ "$WINLINKS" -eq 1 ] || return 0
157
+ local t; t="$(mktemp -d)"
158
+ mkdir "$t/destino"
159
+ if ln -s "$t/destino" "$t/enlace" 2>/dev/null && [ -L "$t/enlace" ]; then rm -rf "$t"; return 0; fi
160
+ rm -rf "$t"
161
+ echo "Este Windows no deja crear enlaces simbolicos, y el kit no instala copias (acabarian divergiendo). ${LINK_HELP%% Lo ya movido*}" >&2
162
+ exit 1
76
163
  }
77
164
  # Quita los bloques gestionados (CSR, MAW, AGENTS) de un fichero, conservando el resto.
78
165
  strip_blocks() { # $1 fichero -> stdout
@@ -90,24 +177,55 @@ extract_overrides() { # $1 fichero -> stdout
90
177
  inb && ov && !/^<!--/ && !/^-[[:space:]]*$/ && NF>0 {print}' "$1"
91
178
  }
92
179
  write_file() { # $1 destino, stdin contenido
93
- if [ "$DRY" -eq 1 ]; then cat >/dev/null; printf ' (dry) escribir %s\n' "$1"; else mkdir -p "$(dirname "$1")"; cat > "$1"; fi
180
+ if [ "$DRY" -eq 1 ]; then cat >/dev/null; item dry "escribir $(short "$1")"; else mkdir -p "$(dirname "$1")"; cat > "$1"; fi
94
181
  }
95
182
 
96
183
  [ -f "$SRC/core/AGENTS.md" ] || { echo "No encuentro core/AGENTS.md en $SRC" >&2; exit 1; }
97
184
 
185
+ # ------------------------------------------------------------------ perfil de Claude de Orca
186
+ # Orca lanza Claude con CLAUDE_CONFIG_DIR apuntando a un perfil propio (orca/claude-profiles/<id>/home) que
187
+ # importa @~/.claude/CLAUDE.md y enlaza skills/, rules/... a ~/.claude. Ese perfil es de Orca: el kit instala en
188
+ # ~/.claude y el perfil lo hereda. Si el perfil no importa ~/.claude, no se toca Claude (escribir ahi no duraria).
189
+ ORCA_PROFILE=""; CLAUDE_SKIP=0
190
+ is_orca_profile() { # $1 ruta POSIX
191
+ case "$1" in */[Oo]rca/claude-profiles/*) return 0 ;; esac
192
+ [ -n "${ORCA_CLAUDE_INJECTED_CONFIG_DIR:-}" ] && [ "$(to_posix "$ORCA_CLAUDE_INJECTED_CONFIG_DIR")" = "$1" ]
193
+ }
194
+ if [ "$CLAUDE_DIR" != "$HOME/.claude" ] && is_orca_profile "$CLAUDE_DIR"; then
195
+ ORCA_PROFILE="$CLAUDE_DIR"
196
+ if grep -q '^@~/\.claude/CLAUDE\.md' "$ORCA_PROFILE/CLAUDE.md" 2>/dev/null; then
197
+ CLAUDE_DIR="$HOME/.claude"
198
+ else
199
+ CLAUDE_SKIP=1
200
+ todo "Claude Code: el perfil de Orca $(short "$ORCA_PROFILE") no importa @~/.claude/CLAUDE.md y no lo toco (es de Orca). Claude dentro de Orca no verá el kit hasta que ese perfil importe ~/.claude/CLAUDE.md."
201
+ fi
202
+ fi
203
+
98
204
  # ------------------------------------------------------------------ restore
99
205
  if [ -n "$RESTORE" ]; then
100
- R="$AG/backups/$RESTORE"; [ -d "$R" ] || { echo "No existe $R" >&2; exit 1; }
101
- step "Restaurando desde $R"
102
- (cd "$R" && find . \( -type f -o -type l \) | sed 's#^\./##') | while IFS= read -r rel; do
103
- dest="$HOME/$rel"
104
- # si algun directorio padre es ahora un enlace (p. ej. una skill enlazada), quita el enlace: no escribir a traves de el
206
+ R="$AG/backups/$RESTORE"; [ -d "$R" ] || { echo "No existe la copia $R (consulta: omk backups)" >&2; exit 1; }
207
+ title "Restaurar" "copia $RESTORE"
208
+ phase "Devolviendo ficheros a su sitio"
209
+ N=0
210
+ while IFS= read -r rel; do
211
+ [ -n "$rel" ] || continue
212
+ case "$rel" in _abs/*) dest="/${rel#_abs/}" ;; *) dest="$HOME/$rel" ;; esac
213
+ # si algun directorio padre es ahora un enlace del kit (p. ej. una skill enlazada a ~/.agents), quitalo:
214
+ # no escribir a traves de el. Los enlaces ajenos (dotfiles, perfiles de Orca) se respetan.
105
215
  p="$(dirname "$dest")"
106
- while [ "$p" != "$HOME" ] && [ "$p" != "/" ]; do [ -L "$p" ] && run rm -f "$p"; p="$(dirname "$p")"; done
216
+ while [ "$p" != "$HOME" ] && [ "$p" != "/" ] && [ "$p" != "." ]; do
217
+ if [ -L "$p" ]; then case "$(readlink "$p")" in "$AG"/*) run rm -f "$p" ;; esac; fi
218
+ p="$(dirname "$p")"
219
+ done
107
220
  if [ -L "$dest" ] || [ -f "$dest" ]; then run rm -f "$dest"; fi
108
221
  run mkdir -p "$(dirname "$dest")"; run cp -a "$R/$rel" "$dest"
109
- done
110
- step "Hecho. Los enlaces creados donde antes no habia nada se mantienen; borralos a mano si quieres."
222
+ N=$((N+1))
223
+ done <<EOF
224
+ $(cd "$R" && find . \( -type f -o -type l \) | sed 's#^\./##')
225
+ EOF
226
+ done_phase "$N ficheros restaurados"
227
+ info "Los enlaces que el kit creó donde antes no había nada siguen ahí; bórralos a mano si quieres."
228
+ if [ -n "$EV" ]; then ev "footer::restore::$RESTORE::$DRY"; else printf '\n%s✓ Restaurado%s\n\n' "$C_L$C_B" "$C_0"; fi
111
229
  exit 0
112
230
  fi
113
231
 
@@ -120,6 +238,11 @@ if [ -z "$AGENTS" ]; then
120
238
  [ -d "$CURSOR_DIR" ] && AGENTS="$AGENTS,cursor"
121
239
  AGENTS="${AGENTS#,}" # devin solo con --agents (opt-in)
122
240
  fi
241
+ if [ "$CLAUDE_SKIP" -eq 1 ]; then
242
+ AGENTS="$(printf ',%s,' "$AGENTS" | sed 's/,claude,/,/; s/^,//; s/,$//')"
243
+ fi
244
+ [ -n "$ORCA_PROFILE" ] && [ "$CLAUDE_SKIP" -eq 0 ] && has_agent claude && \
245
+ info "Claude Code: perfil de Orca detectado ($(short "$ORCA_PROFILE")); se instala en ~/.claude, que el perfil importa. El perfil no se toca."
123
246
 
124
247
  # ------------------------------------------------------------------ adopt
125
248
  if [ -n "$ADOPT" ]; then
@@ -128,56 +251,85 @@ if [ -n "$ADOPT" ]; then
128
251
  [ -L "$SKD" ] && { echo "Ya es un enlace: $SKD -> $(readlink "$SKD")" >&2; exit 1; }
129
252
  NAME="$(basename "$SKD")"; DEST="$AG/skills/$NAME"
130
253
  [ -e "$DEST" ] && { echo "Ya existe $DEST. Si es la misma skill, borra una de las dos copias antes." >&2; exit 1; }
131
- step "Adoptando $NAME: $SKD -> $DEST (en su sitio original queda un enlace)"
254
+ title "Adoptar skill" "$NAME"
255
+ phase "Compartiendo $NAME con todos los agentes"
256
+ check_links
132
257
  run mkdir -p "$BK" "$AG/skills"
133
258
  run cp -a "$SKD" "$BK/$NAME.orig"
134
259
  run mv "$SKD" "$DEST"
135
- run ln -s "$DEST" "$SKD"
136
- case "$SKD" in "$CLAUDE_DIR"/skills/*) ;; *) has_agent claude && link "$DEST" "$CLAUDE_DIR/skills/$NAME" ;; esac
137
- case "$SKD" in "$GEMINI_DIR"/*) ;; *) has_agent antigravity && link "$DEST" "$GEMINI_DIR/config/skills/$NAME" ;; esac
138
- step "Hecho. Codex, Copilot y Cursor la leen desde $AG/skills. Si la skill se actualiza con su propio instalador, vuelve a adoptarla."
260
+ run ln -s "$DEST" "$SKD" || { echo "No se pudo crear el enlace $SKD -> $DEST. $LINK_HELP" >&2; exit 1; }
261
+ item add "copia única en $(short "$DEST")"
262
+ item add "en su sitio original queda un enlace"
263
+ case "$SKD" in "$CLAUDE_DIR"/skills/*) ;; *) has_agent claude && { link "$DEST" "$CLAUDE_DIR/skills/$NAME"; item add "enlazada en Claude Code"; } ;; esac
264
+ case "$SKD" in "$GEMINI_DIR"/*) ;; *) has_agent antigravity && { link "$DEST" "$GEMINI_DIR/config/skills/$NAME"; item add "enlazada en Antigravity"; } ;; esac
265
+ done_phase "Codex, Copilot y Cursor la leen desde ~/.agents/skills"
266
+ info "Si la skill se actualiza con su propio instalador, vuelve a adoptarla."
267
+ footer global
139
268
  exit 0
140
269
  fi
141
270
 
142
271
  # ------------------------------------------------------------------ verify
143
272
  if [ "$VERIFY" -eq 1 ]; then
144
- bad=0
145
- ok() { echo " OK $1"; }
146
- fail() { echo " MAL $1"; bad=1; }
147
- chk_link() { if [ -L "$2" ] && [ "$(readlink "$2")" = "$1" ]; then ok "$2 -> $1"; else fail "$2 no enlaza a $1"; fi; }
148
- [ -f "$AG/AGENTS.md" ] && ok "$AG/AGENTS.md" || fail "$AG/AGENTS.md"
149
- n=$(ls -1 "$AG/rules/lang"/*.md 2>/dev/null | wc -l | tr -d ' '); [ "$n" -ge 17 ] && ok "rules/lang: $n" || fail "rules/lang: $n (esperado 17)"
150
- for s in $KIT_SKILLS; do [ -f "$AG/skills/$s/SKILL.md" ] || fail "skill $s"; done
151
- [ -f "$AG/speckit-ext/orca/extension.yml" ] && ok "extension spec-kit orca" || fail "$AG/speckit-ext/orca"
152
- for s in $OLD_SKILLS; do [ -e "$AG/skills/$s" ] && fail "skill retirada sigue instalada: $s"; done
273
+ bad=0; nok=0
274
+ vok() { nok=$((nok+1)); if [ -n "$EV" ]; then ev "check::ok::$1"; else printf ' %s✓%s %s\n' "$C_L" "$C_0" "$1"; fi; }
275
+ vfail() { bad=$((bad+1)); if [ -n "$EV" ]; then ev "check::fail::$1"; else printf ' %s✗ %s%s\n' "$C_R" "$1" "$C_0"; fi; }
276
+ vinfo() { if [ -n "$EV" ]; then ev "check::info::$1"; else printf ' %s· %s%s\n' "$C_D" "$1" "$C_0"; fi; }
277
+ chk_link() {
278
+ if [ -L "$3" ] && [ "$(readlink "$3")" = "$2" ]; then vok "$1"
279
+ elif [ -e "$3" ] && [ ! -L "$3" ]; then vfail "$1: $(short "$3") es una copia, no un enlace (acabará divergiendo; ejecuta omk install)"
280
+ else vfail "$1: $(short "$3") no enlaza a $(short "$2")"; fi; }
281
+ # Skills de un agente: separa las copias (divergen en silencio) de las que faltan o apuntan a otro sitio.
282
+ chk_skills() { # $1 agente · $2 carpeta de skills
283
+ local s ms="" cs=""
284
+ for s in $KIT_SKILLS; do
285
+ if [ -L "$2/$s" ] && [ "$(readlink "$2/$s")" = "$AG/skills/$s" ]; then continue; fi
286
+ if [ -e "$2/$s" ] && [ ! -L "$2/$s" ]; then cs="$cs $s"; else ms="$ms $s"; fi
287
+ done
288
+ [ -n "$cs" ] && vfail "$1: skills copiadas en vez de enlazadas (acabarán divergiendo; ejecuta omk install):$cs"
289
+ [ -n "$ms" ] && vfail "$1: skills sin enlazar:$ms"
290
+ [ -z "$cs$ms" ] && vok "$1: skills enlazadas"; return 0; }
291
+ title "Verificación" "$(agent_names)"
292
+ [ "$CLAUDE_SKIP" -eq 1 ] && vfail "Claude Code: el perfil de Orca $(short "$ORCA_PROFILE") no importa ~/.claude/CLAUDE.md, así que Claude en Orca no ve el kit"
293
+ [ -f "$AG/AGENTS.md" ] && vok "núcleo en ~/.agents/AGENTS.md (v$(cat "$AG/AGENT_KIT_VERSION" 2>/dev/null || echo '?'))" || vfail "falta ~/.agents/AGENTS.md: ejecuta omk install"
294
+ n=$(ls -1 "$AG/rules/lang"/*.md 2>/dev/null | wc -l | tr -d ' '); [ "$n" -ge 17 ] && vok "$n guías de lenguaje" || vfail "guías de lenguaje: $n de 17"
295
+ ms=""; for s in $KIT_SKILLS; do [ -f "$AG/skills/$s/SKILL.md" ] || ms="$ms $s"; done
296
+ [ -z "$ms" ] && vok "$NSK skills del kit" || vfail "faltan skills:$ms"
297
+ [ -f "$AG/speckit-ext/orca/extension.yml" ] && vok "extensión de spec-kit" || vfail "falta la extensión de spec-kit (~/.agents/speckit-ext/orca)"
298
+ for s in $OLD_SKILLS; do [ -e "$AG/skills/$s" ] && vfail "skill retirada sigue instalada: $s"; done
153
299
  if has_agent claude; then
154
- grep -q '@~/.agents/AGENTS.md' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null && ok "CLAUDE.md importa AGENTS.md" || fail "CLAUDE.md sin import"
155
- grep -Eq '<!-- (CSR|MAW):BEGIN' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null && fail "CLAUDE.md conserva bloques CSR/MAW antiguos" || true
156
- for r in $OLD_RULES; do [ -e "$CLAUDE_DIR/rules/$r" ] && fail "copia divergente: $CLAUDE_DIR/rules/$r (Claude la carga SIEMPRE)"; done
157
- for s in $KIT_SKILLS; do chk_link "$AG/skills/$s" "$CLAUDE_DIR/skills/$s"; done
300
+ grep -q '@~/.agents/AGENTS.md' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null && vok "Claude Code: CLAUDE.md importa el núcleo" || vfail "Claude Code: CLAUDE.md no importa el núcleo"
301
+ grep -Eq '<!-- (CSR|MAW):BEGIN' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null && vfail "Claude Code: CLAUDE.md conserva bloques CSR/MAW antiguos" || true
302
+ for r in $OLD_RULES; do [ -e "$CLAUDE_DIR/rules/$r" ] && vfail "Claude Code: copia antigua $(short "$CLAUDE_DIR/rules/$r") (Claude la carga siempre)"; done
303
+ chk_skills "Claude Code" "$CLAUDE_DIR/skills"
158
304
  fi
159
305
  if has_agent antigravity; then
160
- chk_link "$AG/AGENTS.md" "$GEMINI_DIR/GEMINI.md"
161
- for r in $OLD_RULES; do [ -e "$GEMINI_DIR/rules/$r" ] && fail "copia divergente: $GEMINI_DIR/rules/$r"; done
162
- [ -e "$GEMINI_DIR/config/plugins/claude-session-rules" ] && fail "plugin claude-session-rules sigue instalado (duplica csr-*)"
163
- for s in $KIT_SKILLS; do chk_link "$AG/skills/$s" "$GEMINI_DIR/config/skills/$s"; done
306
+ chk_link "Antigravity: GEMINI.md es el núcleo" "$AG/AGENTS.md" "$GEMINI_DIR/GEMINI.md"
307
+ for r in $OLD_RULES; do [ -e "$GEMINI_DIR/rules/$r" ] && vfail "Antigravity: copia antigua $(short "$GEMINI_DIR/rules/$r")"; done
308
+ [ -e "$GEMINI_DIR/config/plugins/claude-session-rules" ] && vfail "Antigravity: el plugin claude-session-rules sigue instalado (duplica csr-*)"
309
+ chk_skills "Antigravity" "$GEMINI_DIR/config/skills"
164
310
  fi
165
- has_agent codex && chk_link "$AG/AGENTS.md" "$CODEX_DIR/AGENTS.md"
166
- has_agent copilot && chk_link "$AG/AGENTS.md" "$COPILOT_DIR/copilot-instructions.md"
167
- has_agent devin && chk_link "$AG/AGENTS.md" "$DEVIN_DIR/AGENTS.md"
168
- has_agent cursor && echo " INFO cursor: lee ~/.agents/skills solo; reglas globales en Settings -> Rules (no hay fichero)"
169
- [ "$bad" -eq 0 ] && { step "Verificacion: OK ($AGENTS)"; exit 0; }
170
- step "Verificacion: con fallos"; exit 1
311
+ has_agent codex && chk_link "Codex: AGENTS.md es el núcleo" "$AG/AGENTS.md" "$CODEX_DIR/AGENTS.md"
312
+ has_agent copilot && chk_link "Copilot CLI: copilot-instructions.md es el núcleo" "$AG/AGENTS.md" "$COPILOT_DIR/copilot-instructions.md"
313
+ has_agent devin && chk_link "Devin: AGENTS.md es el núcleo" "$AG/AGENTS.md" "$DEVIN_DIR/AGENTS.md"
314
+ if has_agent cursor; then
315
+ if cursor_rule_set; then vok "Cursor: regla de usuario configurada"; else vinfo "Cursor: no veo la regla de usuario que apunta a ~/.agents/AGENTS.md (Settings → Rules)"; fi
316
+ fi
317
+ if [ -n "$EV" ]; then ev "result::$bad::$nok"; exit $((bad > 0)); fi
318
+ if [ "$bad" -eq 0 ]; then printf '\n%s✓ Todo correcto%s %s%s comprobaciones%s\n\n' "$C_L$C_B" "$C_0" "$C_D" "$nok" "$C_0"; exit 0; fi
319
+ printf '\n%s✗ %s fallos%s %sejecuta «omk install» para repararlos%s\n\n' "$C_R$C_B" "$bad" "$C_0" "$C_D" "$C_0"; exit 1
171
320
  fi
172
321
 
173
322
  # ------------------------------------------------------------------ global
174
323
  if [ "$PROJECT_ONLY" -eq 0 ]; then
175
- [ -n "$AGENTS" ] || { echo "No detecto ningun agente. Usa --agents." >&2; exit 1; }
176
- step "Orca Multiagent Kit v$VERSION · agentes: $AGENTS"
177
- step "Fuente unica: $AG · backup: $BK"
324
+ [ -n "$AGENTS" ] || { echo "No detecto ningún agente (Claude Code, Antigravity, Codex, Copilot o Cursor). Indica cuáles con --agents." >&2; exit 1; }
325
+ SUB="$(agent_names)"; [ "$DRY" -eq 1 ] && SUB="$SUB · simulación, no se escribe nada"
326
+ title "Orca Multiagent Kit v${VERSION}" "$SUB"
327
+ check_links
178
328
  run mkdir -p "$BK"
179
329
 
180
330
  # 1. Fuente canonica
331
+ phase "Fuente única en ~/.agents"
332
+ PREV="$(cat "$AG/AGENT_KIT_VERSION" 2>/dev/null || true)"
181
333
  [ -f "$AG/AGENTS.md" ] && snapshot "$AG/AGENTS.md"
182
334
  run mkdir -p "$AG/rules" "$AG/skills" "$AG/templates" "$AG/output-styles"
183
335
  run cp "$SRC/core/AGENTS.md" "$AG/AGENTS.md"
@@ -190,21 +342,31 @@ if [ "$PROJECT_ONLY" -eq 0 ]; then
190
342
  run cp -R "$SRC/templates/." "$AG/templates/"
191
343
  run cp -R "$SRC/output-styles/." "$AG/output-styles/"
192
344
  run cp "$SRC/VERSION" "$AG/AGENT_KIT_VERSION"
345
+ run mkdir -p "$AG/speckit-ext"
346
+ [ -e "$AG/speckit-ext/orca" ] && run rm -rf "$AG/speckit-ext/orca"
347
+ run cp -R "$SRC/speckit-extension/orca" "$AG/speckit-ext/orca"
348
+ NR=$(find "$SRC/rules" -name '*.md' | wc -l | tr -d ' '); NS=$NSK
349
+ if [ -z "$PREV" ]; then item add "instalada v${VERSION}"; elif [ "$PREV" = "$VERSION" ]; then item keep "v${VERSION} reinstalada"; else item add "actualizada de v${PREV} a v${VERSION}"; fi
350
+ done_phase "núcleo · $NR reglas · $NS skills · extensión de spec-kit"
351
+
352
+ # 2. Restos de versiones anteriores
353
+ phase "Versiones anteriores"
354
+ M0=$MOVED
193
355
  [ -d "$AG/maw" ] && stash "$AG/maw" # restos de MAW v1
194
356
  for s in $OLD_SKILLS; do
195
357
  stash "$AG/skills/$s"; stash "$CLAUDE_DIR/skills/$s"; stash "$GEMINI_DIR/config/skills/$s"
196
358
  done
197
- run mkdir -p "$AG/speckit-ext"
198
- [ -e "$AG/speckit-ext/orca" ] && run rm -rf "$AG/speckit-ext/orca"
199
- run cp -R "$SRC/speckit-extension/orca" "$AG/speckit-ext/orca"
359
+ if [ $((MOVED-M0)) -gt 0 ]; then done_phase "$((MOVED-M0)) elementos retirados a la copia de seguridad"; else done_phase "nada que retirar"; fi
200
360
 
201
- # 2. Claude Code: import en CLAUDE.md; reglas fuera de ~/.claude/rules (Claude carga TODO lo que hay ahi)
361
+ # 3. Claude Code: import en CLAUDE.md; reglas fuera de ~/.claude/rules (Claude carga TODO lo que hay ahi)
202
362
  if has_agent claude; then
203
- step "Claude Code"
363
+ phase "Claude Code"
364
+ M0=$MOVED
204
365
  if [ -L "$CLAUDE_DIR/CLAUDE.md" ]; then stash "$CLAUDE_DIR/CLAUDE.md"; fi
205
366
  [ -f "$CLAUDE_DIR/CLAUDE.md" ] && snapshot "$CLAUDE_DIR/CLAUDE.md"
206
367
  TMP="$(mktemp)"; [ -f "$CLAUDE_DIR/CLAUDE.md" ] && strip_blocks "$CLAUDE_DIR/CLAUDE.md" > "$TMP"
207
368
  { printf '<!-- AGENTS:BEGIN v%s Orca Multiagent Kit -- reglas globales: edita ~/.agents/AGENTS.md, no este bloque -->\n@~/.agents/AGENTS.md\n<!-- AGENTS:END -->\n' "$VERSION"; [ -s "$TMP" ] && { printf '\n'; cat "$TMP"; }; true; } | write_file "$CLAUDE_DIR/CLAUDE.md"
369
+ [ -s "$TMP" ] && KEPT=1 || KEPT=0
208
370
  rm -f "$TMP"
209
371
  for r in $OLD_RULES; do stash "$CLAUDE_DIR/rules/$r"; done
210
372
  for l in $OLD_LANGS; do stash "$CLAUDE_DIR/rules/lang/$l.md"; done
@@ -212,17 +374,21 @@ if [ "$PROJECT_ONLY" -eq 0 ]; then
212
374
  for s in $KIT_SKILLS; do link "$AG/skills/$s" "$CLAUDE_DIR/skills/$s"; done
213
375
  link "$AG/output-styles/csr-minimal.md" "$CLAUDE_DIR/output-styles/csr-minimal.md"
214
376
  stash "$CLAUDE_DIR/templates/STACK.md"; stash "$CLAUDE_DIR/templates/project-CLAUDE.md"
215
- warn "Claude Code: en sesiones de Cowork (app de escritorio) no se cargan imports de fuera de la carpeta de trabajo; en la CLI y el IDE, si."
377
+ item add "CLAUDE.md importa el núcleo"
378
+ [ "$KEPT" -eq 1 ] && item keep "tu contenido propio de CLAUDE.md se conserva debajo"
379
+ item add "$NS skills enlazadas · estilo csr-minimal"
380
+ [ $((MOVED-M0)) -gt 0 ] && item add "$((MOVED-M0)) copias antiguas de reglas retiradas"
381
+ done_phase
382
+ info "Claude Code: en la app de escritorio (Cowork) no se cargan imports de fuera de la carpeta de trabajo; en la terminal y el IDE sí."
216
383
  fi
217
384
 
218
- # 3. Antigravity: GEMINI.md pasa a ser un enlace a la fuente unica
385
+ # 4. Antigravity: GEMINI.md pasa a ser un enlace a la fuente unica
219
386
  if has_agent antigravity; then
220
- step "Antigravity"
387
+ phase "Antigravity"
388
+ M0=$MOVED
221
389
  if [ -f "$GEMINI_DIR/GEMINI.md" ] && [ ! -L "$GEMINI_DIR/GEMINI.md" ]; then
222
390
  EXTRA="$(strip_blocks "$GEMINI_DIR/GEMINI.md" | grep -v '^[[:space:]]*$' || true)"
223
- if [ -n "$EXTRA" ]; then
224
- warn "Antigravity: GEMINI.md tenia contenido fuera de los bloques (va al backup). Idioma y comunicacion ya estan en AGENTS.md; si habia algo mas tuyo, pasalo a ~/.agents/rules/personal.md"
225
- fi
391
+ [ -n "$EXTRA" ] && info "Antigravity: lo que tenías en GEMINI.md fuera de los bloques está en la copia de seguridad. Si era tuyo, pásalo a ~/.agents/rules/personal.md."
226
392
  fi
227
393
  link "$AG/AGENTS.md" "$GEMINI_DIR/GEMINI.md"
228
394
  for r in $OLD_RULES; do stash "$GEMINI_DIR/rules/$r"; done
@@ -232,66 +398,90 @@ if [ "$PROJECT_ONLY" -eq 0 ]; then
232
398
  stash "$GEMINI_DIR/output-styles/csr-minimal.md"
233
399
  if [ -e "$GEMINI_DIR/config/plugins/claude-session-rules" ]; then
234
400
  stash "$GEMINI_DIR/config/plugins/claude-session-rules"
235
- warn "Antigravity: plugin claude-session-rules retirado (sus csr-* y su estilo ya estan en la fuente unica). Si Antigravity se queja de un plugin ausente, desactivalo en su configuracion."
401
+ item add "plugin claude-session-rules retirado (ya está en la fuente única)"
402
+ info "Antigravity: si se queja de un plugin ausente (claude-session-rules), desactívalo en su configuración."
236
403
  fi
237
404
  for s in $KIT_SKILLS; do link "$AG/skills/$s" "$GEMINI_DIR/config/skills/$s"; done
238
- [ -d "$GEMINI_DIR/config/plugins/user-workflows/skills/planificar" ] && warn "Antigravity: 'planificar' sigue activo; 'orca' (plan por sprints) lo sustituye. Desactivalo cuando lo hayas probado."
405
+ item add "GEMINI.md es un enlace al núcleo"
406
+ item add "$NS skills enlazadas"
407
+ [ $((MOVED-M0)) -gt 0 ] && item add "$((MOVED-M0)) copias antiguas retiradas"
408
+ done_phase
409
+ [ -d "$GEMINI_DIR/config/plugins/user-workflows/skills/planificar" ] && todo "Antigravity: desactiva la skill «planificar» cuando hayas probado «orca», que la sustituye."
239
410
  fi
240
411
 
241
- # 4. Agentes que leen ~/.agents/skills de forma nativa: solo hay que enlazar las reglas globales
242
- if has_agent codex; then step "Codex"; link "$AG/AGENTS.md" "$CODEX_DIR/AGENTS.md"; fi
243
- if has_agent copilot; then step "Copilot CLI"; link "$AG/AGENTS.md" "$COPILOT_DIR/copilot-instructions.md"; fi
244
- if has_agent devin; then step "Devin CLI"; link "$AG/AGENTS.md" "$DEVIN_DIR/AGENTS.md"
245
- warn "Devin: tambien lee ~/.claude/CLAUDE.md; si ves reglas duplicadas, quita uno de los dos."; fi
246
- if has_agent cursor; then step "Cursor (skills: nativo en ~/.agents/skills)"
247
- warn "Cursor: sus reglas de usuario no estan en ficheros. Pega en Settings -> Rules -> User Rules: «Al empezar, lee y aplica ~/.agents/AGENTS.md y, bajo demanda, ~/.agents/rules/»."
248
- has_agent claude && warn "Cursor: tambien lee ~/.claude/skills por compatibilidad; puede listar las skills dos veces (mismo contenido)."; fi
412
+ # 5. Agentes que leen ~/.agents/skills de forma nativa: solo hay que enlazar las reglas globales
413
+ if has_agent codex; then phase "Codex"; link "$AG/AGENTS.md" "$CODEX_DIR/AGENTS.md"; item add "AGENTS.md es un enlace al núcleo"; item add "skills: las lee de ~/.agents/skills"; done_phase; fi
414
+ if has_agent copilot; then phase "Copilot CLI"; link "$AG/AGENTS.md" "$COPILOT_DIR/copilot-instructions.md"; item add "copilot-instructions.md es un enlace al núcleo"; item add "skills: las lee de ~/.agents/skills"; done_phase; fi
415
+ if has_agent devin; then phase "Devin"; link "$AG/AGENTS.md" "$DEVIN_DIR/AGENTS.md"; item add "AGENTS.md es un enlace al núcleo"; done_phase
416
+ info "Devin: también lee ~/.claude/CLAUDE.md; si ves reglas duplicadas, quita uno de los dos."; fi
417
+ if has_agent cursor; then phase "Cursor"
418
+ item add "skills: las lee de ~/.agents/skills"
419
+ if cursor_rule_set; then item keep "regla de usuario ya configurada"; else
420
+ item warn "falta la regla de usuario (Cursor no la guarda en un fichero)"
421
+ todo "Cursor: añade en Settings → Rules → User Rules una regla con este texto: «Al empezar, lee y aplica ~/.agents/AGENTS.md y, bajo demanda, ~/.agents/rules/»"
422
+ fi
423
+ done_phase
424
+ has_agent claude && info "Cursor: también lee ~/.claude/skills, así que puede listar las skills dos veces (con el mismo contenido)."
425
+ fi
249
426
  fi
250
427
 
251
428
  # ------------------------------------------------------------------ proyecto
252
429
  if [ -n "$PROJECT" ]; then
253
430
  [ -d "$PROJECT" ] || { echo "No existe la ruta de proyecto: $PROJECT" >&2; exit 1; }
254
- step "Proyecto: $PROJECT"
431
+ PNAME="$(basename "$PROJECT")"
432
+ [ "$PROJECT_ONLY" -eq 1 ] && title "Orca Multiagent Kit v${VERSION}" "proyecto $(short "$PROJECT")$([ "$DRY" -eq 1 ] && echo ' · simulación')"
433
+ phase "Proyecto $PNAME"
434
+ INSTALLED="$(cat "$AG/AGENT_KIT_VERSION" 2>/dev/null || true)"
435
+ if [ "$PROJECT_ONLY" -eq 1 ] && [ "$INSTALLED" != "$VERSION" ]; then
436
+ if [ -n "${OMK_CLI:-}" ]; then FIX="omk install"; else FIX="./install.sh"; fi
437
+ todo "Instalación global: en ~/.agents hay ${INSTALLED:-una versión sin instalar} y este kit es v${VERSION}. Ejecuta «${FIX}» para tener las skills orca y kit-init."
438
+ fi
255
439
  OV=""
256
440
  for f in "$PROJECT/CLAUDE.md" "$PROJECT/AGENTS.md"; do [ -f "$f" ] && OV="$OV$(extract_overrides "$f")
257
441
  "; done
258
442
  OV="$(printf '%s' "$OV" | awk 'NF && !seen[$0]++')"
259
443
  for f in AGENTS.md CLAUDE.md; do [ -f "$PROJECT/$f" ] && snapshot "$PROJECT/$f"; done
444
+ [ -f "$PROJECT/AGENTS.md" ] && HADAG=1 || HADAG=0
260
445
 
261
446
  TMP="$(mktemp)"; [ -f "$PROJECT/AGENTS.md" ] && strip_blocks "$PROJECT/AGENTS.md" > "$TMP"
262
447
  { if [ -n "$OV" ]; then OV="$OV" awk '/^-$/ && !d {print ENVIRON["OV"]; d=1; next} {print}' "$SRC/templates/AGENTS.md"; else cat "$SRC/templates/AGENTS.md"; fi
263
448
  [ -s "$TMP" ] && { printf '\n'; cat "$TMP"; }; true; } | write_file "$PROJECT/AGENTS.md"
264
449
  REST="$(mktemp)"; [ -f "$PROJECT/CLAUDE.md" ] && strip_blocks "$PROJECT/CLAUDE.md" > "$REST"
265
450
  { cat "$SRC/templates/CLAUDE.md"; [ -s "$REST" ] && { printf '\n'; cat "$REST"; }; true; } | write_file "$PROJECT/CLAUDE.md"
266
- grep -q '[^[:space:]]' "$REST" && warn "Proyecto: CLAUDE.md tiene reglas propias fuera del bloque; solo las ve Claude. Muevelas a AGENTS.md para que las vean todos."
451
+ if [ "$HADAG" -eq 1 ]; then item add "AGENTS.md actualizado (tu contenido se conserva)"; else item add "AGENTS.md creado"; fi
452
+ [ -n "$OV" ] && item add "overrides del proyecto movidos a AGENTS.md"
453
+ item add "CLAUDE.md importa AGENTS.md"
454
+ grep -q '[^[:space:]]' "$REST" && todo "$PNAME: CLAUDE.md tiene reglas propias que solo ve Claude. Pide al agente «inicializa el proyecto» para pasarlas a AGENTS.md y que las vean todos."
267
455
  rm -f "$TMP" "$REST"
268
- [ -n "$OV" ] && step " overrides migrados a AGENTS.md"
269
456
  for f in STACK.md ORCHESTRATION.md orca.yaml .worktreeinclude; do
270
- if [ -e "$PROJECT/$f" ]; then step " $f ya existe: no se toca"; else run cp "$SRC/templates/$f" "$PROJECT/$f"; step " $f creado"; fi
457
+ if [ -e "$PROJECT/$f" ]; then item keep "$f ya existía: no se toca"; else run cp "$SRC/templates/$f" "$PROJECT/$f"; item add "$f creado"; fi
271
458
  done
272
- if [ ! -e "$PROJECT/.claude/settings.json" ] && has_agent claude; then run mkdir -p "$PROJECT/.claude"; run cp "$SRC/templates/claude-settings.json" "$PROJECT/.claude/settings.json"; step " .claude/settings.json creado"; fi
459
+ if [ ! -e "$PROJECT/.claude/settings.json" ] && has_agent claude; then run mkdir -p "$PROJECT/.claude"; run cp "$SRC/templates/claude-settings.json" "$PROJECT/.claude/settings.json"; item add ".claude/settings.json creado"; fi
273
460
  if [ -d "$PROJECT/.specify" ]; then
274
461
  EXT="$PROJECT/.specify/extensions.yml"
275
- if grep -q 'speckit.orca.implement' "$EXT" 2>/dev/null; then step " spec-kit: hook orca ya activo"
462
+ if grep -q 'speckit.orca.implement' "$EXT" 2>/dev/null; then item keep "spec-kit: el hook de orquestación ya estaba activo"
276
463
  elif command -v specify >/dev/null 2>&1; then
277
- (cd "$PROJECT" && run specify extension add --dev "$AG/speckit-ext/orca") && step " spec-kit: extension orca instalada (hook before_implement)" \
278
- || warn "Proyecto: 'specify extension add' fallo; en el agente, «inicializa el proyecto» añadira el hook."
464
+ SKX="$AG/speckit-ext/orca"; [ -f "$SKX/extension.yml" ] || SKX="$SRC/speckit-extension/orca"
465
+ if (cd "$PROJECT" && run specify extension add --dev "$SKX") >/dev/null 2>&1; then item add "spec-kit: extensión orca instalada (hook before_implement)"
466
+ else item warn "spec-kit: «specify extension add» ha fallado"; todo "$PNAME: no se pudo activar el hook de spec-kit. Pide al agente «inicializa el proyecto» y lo añadirá."; fi
279
467
  elif [ ! -e "$EXT" ]; then
280
468
  # mismo formato que escribe 'specify extension add'
281
469
  printf '%s\n' 'installed:' '- orca' 'settings:' ' auto_execute_hooks: true' 'hooks:' ' before_implement:' ' - extension: orca' \
282
470
  ' command: speckit.orca.implement' ' enabled: true' ' optional: false' ' priority: 10' \
283
471
  ' description: "Orquestacion multiagente: reparte las user stories si compensa"' | write_file "$EXT"
284
- step " spec-kit: hook before_implement creado en .specify/extensions.yml"
472
+ item add "spec-kit: hook before_implement creado en .specify/extensions.yml"
285
473
  else
286
- warn "Proyecto: .specify/extensions.yml ya existe y no hay CLI 'specify'. En el agente, «inicializa el proyecto» añadira el hook sin romper lo que hay."
474
+ item warn "spec-kit: hay extensions.yml y no está el comando specify"
475
+ todo "$PNAME: pide al agente «inicializa el proyecto» para añadir el hook de spec-kit sin romper tu extensions.yml."
287
476
  fi
477
+ else
478
+ item keep "sin spec-kit (.specify/): no hace falta hook"
288
479
  fi
289
480
  if ! grep -qxF '.work/' "$PROJECT/.gitignore" 2>/dev/null; then
290
- if [ "$DRY" -eq 1 ]; then echo " (dry) añadir .work/ a .gitignore"; else printf '\n# Orca Multiagent Kit: briefs e informes de runs multiagente\n.work/\n' >> "$PROJECT/.gitignore"; fi
291
- step " .work/ añadido a .gitignore"
481
+ if [ "$DRY" -eq 1 ]; then item dry "añadir .work/ a .gitignore"; else printf '\n# Orca Multiagent Kit: briefs e informes de runs multiagente\n.work/\n' >> "$PROJECT/.gitignore"; fi
482
+ item add ".work/ añadido a .gitignore"
292
483
  fi
293
- step " Siguiente: en el agente, «inicializa el proyecto» (kit-init: detecta el stack y prepara la orquestacion)."
484
+ done_phase
294
485
  fi
295
486
 
296
- [ -n "$WARN" ] && { step "Avisos:"; printf '%s' "$WARN"; }
297
- step "Hecho. Comprueba con: ./install.sh --verify · deshacer: ./install.sh --restore $STAMP"
487
+ if [ -n "$PROJECT" ] && [ "$PROJECT_ONLY" -eq 0 ]; then footer both; elif [ -n "$PROJECT" ]; then footer project; else footer global; fi
@@ -0,0 +1 @@
1
+ * -text
@@ -0,0 +1,12 @@
1
+ # Plugin de Orca — Orca Multiagent Kit
2
+
3
+ Integra el kit en la app [Orca](https://www.onorca.dev) (≥ 1.4.248). Qué hace, qué permisos pide y cómo instalarlo: [`docs/PLUGIN-ORCA.md`](../docs/PLUGIN-ORCA.md).
4
+
5
+ ```sh
6
+ orca plugin validate . --json # manifiesto
7
+ orca plugin test . --json # src/*.test.ts con orca/testing
8
+ orca plugin inspect . --json # qué aporta y qué acceso pide
9
+ ```
10
+
11
+ - `src/kit.ts`: lógica pura (detección de despachos, mensajes de "comando no encontrado", resumen de agentes).
12
+ - `src/worker.ts`: el worker que Orca carga; solo habla con Orca por su API.