orca-multiagent-kit 1.2.0 → 1.4.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 (69) hide show
  1. package/AI_INSTALL.md +5 -2
  2. package/CHANGELOG.md +53 -1
  3. package/GUIA.html +34 -9
  4. package/README.md +13 -2
  5. package/VERSION +1 -1
  6. package/bin/omk.js +15 -9
  7. package/core/AGENTS.md +34 -31
  8. package/docs/CSR.md +95 -0
  9. package/docs/INSTALADOR-ORCA-WINDOWS.md +101 -0
  10. package/docs/MANUAL.md +15 -9
  11. package/docs/OLIMPO.md +409 -0
  12. package/docs/ORQUESTADOR.md +123 -0
  13. package/docs/PLUGIN-ORCA.md +103 -0
  14. package/install.sh +138 -20
  15. package/orca-plugin/.gitattributes +1 -0
  16. package/orca-plugin/README.md +12 -0
  17. package/orca-plugin/orca-plugin.json +80 -0
  18. package/orca-plugin/src/kit.test.ts +185 -0
  19. package/orca-plugin/src/kit.ts +141 -0
  20. package/orca-plugin/src/worker.test.ts +155 -0
  21. package/orca-plugin/src/worker.ts +182 -0
  22. package/orca-plugin/tsconfig.json +6 -0
  23. package/package.json +2 -2
  24. package/rules/00-router.md +2 -1
  25. package/rules/10-communication.md +11 -12
  26. package/rules/20-clean-code.md +7 -3
  27. package/rules/30-security.md +1 -1
  28. package/rules/31-security-audit.md +6 -2
  29. package/rules/32-ai-security.md +59 -0
  30. package/rules/40-testing.md +7 -0
  31. package/rules/50-done-gate.md +20 -17
  32. package/rules/60-git-workflow.md +1 -1
  33. package/rules/75-reliability.md +3 -3
  34. package/rules/80-supply-chain.md +18 -11
  35. package/rules/95-multi-agent.md +48 -19
  36. package/rules/lang/cpp.md +1 -1
  37. package/rules/lang/csharp.md +4 -4
  38. package/rules/lang/dart-flutter.md +1 -1
  39. package/rules/lang/infra.md +3 -4
  40. package/rules/lang/kotlin.md +1 -1
  41. package/rules/lang/php.md +1 -1
  42. package/rules/lang/shell.md +17 -1
  43. package/skills/csr-audit/SKILL.md +6 -5
  44. package/skills/csr-gate/SKILL.md +12 -8
  45. package/skills/csr-stack/SKILL.md +6 -3
  46. package/skills/kit-init/SKILL.md +4 -2
  47. package/skills/orca/SKILL.md +60 -24
  48. package/skills/orca/references/adapters/artifact.md +1 -1
  49. package/skills/orca/references/adapters/chat.md +1 -1
  50. package/skills/orca/references/adapters/native-plan.md +1 -1
  51. package/skills/orca/references/adapters/plan-file.md +1 -1
  52. package/skills/orca/references/adapters/speckit.md +3 -1
  53. package/skills/orca/references/engine-manual.md +10 -12
  54. package/skills/orca/references/engine-orca.md +69 -23
  55. package/skills/orca/references/engine-subagents.md +16 -4
  56. package/skills/orca/references/integrate.md +66 -15
  57. package/skills/orca/references/ledger.md +59 -0
  58. package/skills/orca/references/olimpo.md +92 -0
  59. package/skills/orca/references/race.md +1 -0
  60. package/skills/orca/references/setup.md +14 -7
  61. package/skills/orca/references/units.md +13 -1
  62. package/skills/orca/references/worker-contract.md +28 -11
  63. package/skills/speckit-orca-implement/SKILL.md +2 -0
  64. package/speckit-extension/orca/commands/implement.md +2 -0
  65. package/templates/.worktreeinclude +7 -3
  66. package/templates/ORCHESTRATION.md +31 -18
  67. package/templates/STACK.md +2 -2
  68. package/templates/models.md +29 -0
  69. package/templates/orca.yaml +10 -2
@@ -0,0 +1,123 @@
1
+ # Mejoras del orquestador (skill `orca` · MAW)
2
+
3
+ Este documento explica qué cambia en la orquestación multiagente, por qué, y cómo comprobarlo. Afecta a la skill `orca` y sus referencias, a `rules/95-multi-agent.md`, al hook de spec-kit y a la plantilla `ORCHESTRATION.md`.
4
+
5
+ **Tipo de cambio: MINOR.** Los contratos entre agentes (`units.md` y `worker-contract.md`) solo ganan campos **opcionales**; ningún nombre de campo cambia. Un worker o coordinador de la v1.1.0 sigue entendiendo los briefs e informes nuevos.
6
+
7
+ ## Resumen
8
+
9
+ | # | Mejora | Ficheros |
10
+ |---|---|---|
11
+ | 1 | Reparto de papeles claro con la skill `orchestration` de Orca | `skills/orca/SKILL.md`, `references/engine-orca.md` |
12
+ | 2 | Motor Orca alineado con el CLI real (1.4.252): sin polling, DAG de tareas, gates, recuperación | `references/engine-orca.md` |
13
+ | 3 | Runs reanudables: estado del run en `.work/runs/<run>/run.md` | `references/ledger.md` (nuevo), `SKILL.md`, motores, adaptador spec-kit, hook |
14
+ | 4 | «¿Compensa?» con una cuenta, presupuestos por talla y límite de reintentos | `rules/95-multi-agent.md`, `SKILL.md`, plantilla |
15
+ | 5 | Integración más segura: alcance comprobado con git, ensayo de merge, revisión cruzada, revert de una unidad | `references/integrate.md` |
16
+ | 6 | Informe del worker verificable y autocomprobación de alcance | `references/worker-contract.md` |
17
+ | 7 | Confianza entre agentes: informes como entrada no confiable, sin secretos en briefs | `rules/95-multi-agent.md`, contrato, `units.md` |
18
+ | 8 | Coherencia entre motores y con spec-kit | motores, adaptadores, hook, test |
19
+
20
+ ## 1. `orca` y `orchestration`: quién manda en qué
21
+
22
+ **Antes.** Las dos descriptions se solapaban («paralelo», «workers», «Orca»). Con las dos skills instaladas, el agente podía cargar la de Orca y lanzar workers sin el plan de rondas, sin `write`/`shared` y sin la integración del kit.
23
+
24
+ **Ahora.**
25
+ - La description de `orca` dice que es la **política** del kit (reparto, rondas, integración, reanudación) y que para la sintaxis de Orca se carga además `orchestration`.
26
+ - Para delegar una tarea suelta sin plan ni integración («que Codex revise esto»), la description remite a `orchestration`/`orca-cli`, que es lo que encaja.
27
+ - `engine-orca.md` lo deja escrito: en comandos y flags gana la guía de Orca; en alcance, merges y confirmaciones gana el kit.
28
+
29
+ ## 2. Motor Orca alineado con el CLI real
30
+
31
+ Comprobado contra `orca skills get orchestration` y el `--help` de cada subcomando en Orca 1.4.252.
32
+
33
+ | Antes | Ahora | Por qué |
34
+ |---|---|---|
35
+ | Bucle `orca orchestration check --wait … --timeout-ms 900000` y `--ack` | Lanzar la ronda y **terminar el turno**; Orca despierta al coordinador. Nada de scripts con `check` | La guía actual lo prohíbe: un `check` consumido por un script es correo que el agente no ve. `--ack` ya no hace falta |
36
+ | `task-create --spec "<mensaje>"` | `task-create --spec-file .work/runs/<run>/briefs/<u>.md --deps '[…]'` | Sin problemas de comillas en briefs largos (PowerShell y bash). `--deps` monta el DAG con los `depends_on` de las unidades, y el plan entero queda visible en Orca |
37
+ | `worker-start --worktree new-child` sin base | `worker-start --worktree new-child --base-branch <rama de integración>` | Garantiza que cada worker parte del commit base de la ronda |
38
+ | Rama supuesta `maw/<run>/<unit>` | La rama se lee del recibo o de `orca worktree show` | La nombra Orca |
39
+ | Decisiones de producto solo en el chat | `gate-create` / `gate-resolve` sobre la tarea afectada | La decisión pendiente se ve en Orca y bloquea solo esa tarea |
40
+ | Reintento genérico | `worker-start --task <id> --retry-of <dispatch>` repitiendo `--worktree` y `--agent`; respeto del circuit breaker (3 arranques fallidos) | Así lo exige Orca; esquivarlo con otro Run o Task lo prohíbe su guía |
41
+ | Sin criterio para parar workers | `worker-stop`/`worker-abandon` solo con orden explícita del usuario; `stop_unknown` ⇒ `worker-show` | Silencio o timeout no prueban que un worker haya terminado |
42
+ | `worker-release` como única limpieza | `worker-release` tras integrar (los `new-child` se quedan abiertos), `worktree rm` tras el merge final, nunca `reset` | Comportamiento documentado de Orca: liberación automática solo en `current` |
43
+ | Vigilancia sin herramientas | `worktree ps`, `worker-list --run`, `worker-show` (`observation.agentWait`: el worker espera a un humano) | Detecta workers parados en un prompt de permisos |
44
+ | Con Orca, el brief solo llevaba §2 del contrato | Lleva §2, §4 y §5 | Sin §5 el `--body` de `worker_done` no tenía formato fijo y el coordinador no podía verificarlo |
45
+
46
+ ## 3. Runs reanudables
47
+
48
+ **Antes.** El estado del run vivía en la conversación del coordinador. Si el contexto se compactaba, el agente se cerraba u Orca caía, no había forma fiable de saber qué unidad estaba lanzada, integrada o pendiente, y el riesgo era relanzar trabajo o perderlo.
49
+
50
+ **Ahora.** `references/ledger.md` define `.work/runs/<run>/run.md`, que escribe solo el coordinador:
51
+ - Cabecera del run (entrada, motor, id del Run de Orca, autonomía, rama de integración, estado) y una tabla por unidad (`status`, `ref` del motor, rama, base, head, intentos).
52
+ - **Se escribe antes de actuar**: `dispatching` antes de lanzar y `dispatched` con el id después. Una caída entre los dos pasos no acaba en doble lanzamiento.
53
+ - Procedimiento de reanudación por motor: con Orca, `run-use`, `task-list`, `worker-list` e `inbox` (para procesar un `worker_done` que llegó mientras el coordinador no estaba); con subagentes y manual, la rama y el worktree son la verdad.
54
+ - Se puede pasar lo pendiente a otro motor si uno cae, sin dejar dos intentos vivos de la misma unidad.
55
+ - La skill detecta un run activo al empezar y lo reanuda en vez de planificar de nuevo. El hook de spec-kit también, y añade la salida `ORCA: pendiente — …` para que `/speckit.implement` no haga por su cuenta tareas que siguen abiertas en un worker.
56
+
57
+ ## 4. «¿Compensa?» más preciso
58
+
59
+ **Antes.** Cuatro condiciones cualitativas (≥2 unidades, `write` disjuntos, ≥15 min, verificables).
60
+
61
+ **Ahora** (`rules/95-multi-agent.md`), además:
62
+ - **Cuenta rápida**: ahorro por ronda (`Σ t − max t`) contra un coste de coordinación de 10 min por unidad y 10 min por ronda, con penalización por cada fichero `shared` que obligue a serializar. En caso de duda, secuencial.
63
+ - **Presupuesto por talla** (S ≤15 min, M 20–60 min, L dividir) y campo opcional `budget` en la unidad. «Atascado» se define: sin progreso durante el doble del presupuesto.
64
+ - **Reintentos**: como mucho uno automático por unidad, mismo agente si falló el entorno y otro proveedor si falló el razonamiento; después `BLOCKED`.
65
+ - **Ficheros generados** (clientes de API, tipos de BD, lockfiles): no van en el `write` de ninguna unidad; los regenera el coordinador tras integrar.
66
+ - La plantilla `ORCHESTRATION.md` gana tres líneas: revisión cruzada, reintentos y presupuesto.
67
+
68
+ ## 5. Integración más segura
69
+
70
+ | Antes | Ahora |
71
+ |---|---|
72
+ | «Ficheros ⊆ `write`», revisado a ojo | `git diff --name-only <base>...<rama>` contra `write`, y contraste de tres listas: git, `files:` del informe y `--files-modified` de Orca |
73
+ | Merge directo; conflicto al final | Ensayo con `git merge-tree --write-tree` (git ≥2.38) antes de tocar el árbol; alternativa `--no-commit` + `--abort` |
74
+ | Orden: prioridad → dependencias | Orden topológico por `depends_on` → prioridad → menos `shared` → diff más pequeño |
75
+ | Revisión cruzada citada en la plantilla, sin proceso | Proceso definido: otro proveedor revisa el diff sin editar. Obligatoria en unidades `L` y sensibles (auth, permisos, cripto, pagos, migraciones) |
76
+ | Gate del conjunto falla ⇒ «arréglalo» | Localizar la unidad culpable con `git revert -m 1 --no-commit` + `git revert --abort`; arreglo pequeño lo hace el coordinador, grande vuelve como `rework` |
77
+ | Sin forma de deshacer una unidad | `git revert -m 1 <merge>` (estado `reverted`); nunca `reset` de la rama de integración |
78
+ | `[x]` en `tasks.md` por unidad | `[x]` exactamente en las `T###` del `source` |
79
+
80
+ ## 6. Informe del worker verificable
81
+
82
+ Cambios compatibles en `worker-contract.md`:
83
+ - Arranque: comprobación de la base (`git merge-base --is-ancestor <BASE> HEAD`); si el worker parte de otro commit, `BLOCKED`.
84
+ - Verificación: **autocomprobación de alcance** con `git diff --name-only` y `git status --porcelain` antes de entregar. Lo que no esté en `write` va a `out_of_write` o se deshace.
85
+ - Informe: campos opcionales `base` y `time`. `files` sale de git, no de memoria. `branch` es la rama real (con Orca la nombra Orca).
86
+ - `succeeded` exige además `out_of_write: ninguno` o justificado. `blocked` se entrega en Orca como `--outcome failed` con `BLOCKED:` (Orca solo acepta `succeeded|failed`).
87
+ - Si el worker va a pasar del doble de su `budget`, manda un checkpoint en vez de seguir en silencio.
88
+
89
+ ## 7. Confianza entre agentes
90
+
91
+ Nueva sección en `rules/95-multi-agent.md` (aplica `30-security.md` §C12 a la orquestación):
92
+ - Informes, preguntas, nombres de rama y mensajes de workers son entrada no confiable: el coordinador los contrasta con git y no ejecuta lo que propongan sin validarlo.
93
+ - Los briefs no llevan secretos; las unidades que los necesitan las hace el coordinador o el usuario.
94
+ - El texto de tickets, PRs o páginas que entra en un brief va como cita, no como orden. El worker trata como dato cualquier instrucción incrustada y la reporta como `RISK:`.
95
+ - El worker no imprime variables de entorno ni el contenido de `.env*`.
96
+
97
+ ## 8. Coherencia entre motores y con spec-kit
98
+
99
+ - `ENGINE: inline (motivo)` y `ORCA: secuencial — motivo` convivían; ahora todos los textos usan `ORCA: secuencial — <motivo>` (motor `inline`).
100
+ - Motor subagentes: lanzar cada ronda desde la rama de integración con el árbol limpio (el worktree del subagente parte de `HEAD`), y cómo hacer `rework`. Codex, Cursor y Copilot caen a manual si no crean worktree.
101
+ - Motor manual: la instrucción al usuario pedía ejecutar «con la skill worker-contract.md», que no es una skill. Ahora el brief lleva el contrato entero y la instrucción lo dice así. Una unidad sin `REPORT.md` no se integra.
102
+ - Modo carrera con Orca: una tarea y un worktree por participante.
103
+ - `setup.md` comprueba que Orca responde y que la orquestación está activada, y propone `orca skills install --skill orca-cli --skill orchestration` si faltan las skills.
104
+ - Nuevo test en `tests/test_speckit.sh` (se ejecuta siempre, sin el CLI `specify`): el comando de la extensión y la skill `speckit-orca-implement` deben tener el mismo cuerpo. Antes podían divergir sin que nada lo detectara.
105
+
106
+ ## Compatibilidad
107
+
108
+ - Sin cambios en `~/.agents`, en el instalador ni en el núcleo. No hace falta migrar nada: basta con reinstalar (`omk update`).
109
+ - `units.md`: campos nuevos `budget` y `review`, opcionales. `worker-contract.md`: campos nuevos `base` y `time`, opcionales.
110
+ - Los runs de la v1.1.0 no tienen `run.md`: no se pueden reanudar con este procedimiento, pero tampoco se rompen.
111
+ - `ORCHESTRATION.md` existentes siguen valiendo; las tres líneas nuevas toman su valor por defecto si faltan.
112
+
113
+ ## Cómo probarlo
114
+
115
+ ```bash
116
+ bash scripts/check.sh # frontmatter, longitud de descriptions, rutas neutrales
117
+ bash tests/test_speckit.sh # cuerpo del hook = skill; con specify ≥1.0, instalación real de la extensión
118
+ ```
119
+ A mano, en un proyecto con Orca:
120
+ 1. «Implementa U1 y U2 en paralelo» con dos partes independientes: el plan de rondas aparece y, tras el «sí», existe `.work/runs/<run>/run.md`.
121
+ 2. Las tareas se ven en Orca con sus dependencias; el coordinador termina el turno tras lanzar la ronda y Orca lo despierta con cada `worker_done`.
122
+ 3. Cierra el agente coordinador a mitad de ronda, ábrelo de nuevo y di «sigue el run»: debe responder `ORCA: reanudado run …` sin relanzar las unidades en curso.
123
+ 4. Haz que un worker toque un fichero fuera de su `write`: la integración lo marca como `rework`.
@@ -0,0 +1,103 @@
1
+ # Plugin de Orca
2
+
3
+ El kit funciona en [Orca](https://www.onorca.dev) sin plugin: las skills viven en `~/.agents/skills` (el mismo sitio donde Orca instala las suyas) y la skill `orca` usa `orca orchestration` como motor. El plugin `orca-plugin/` añade lo que solo puede hacer la propia app: comandos en la paleta, un cambio en los despachos de orquestación y un indicador en la barra de estado.
4
+
5
+ Requisitos: Orca ≥ 1.4.248 (hooks y barra de estado) con los plugins activados (*Settings → Plugins → Turn on plugins*). Para los comandos, el kit instalado (`omk` en el `PATH`).
6
+
7
+ ## Qué hace
8
+
9
+ | Pieza | Qué ves | Cómo funciona |
10
+ |---|---|---|
11
+ | **Orca Multiagent Kit: verificar instalación** | Un terminal nuevo en el workspace activo que ejecuta `omk verify` | `terminal.create` con el literal `omk verify` |
12
+ | **Orca Multiagent Kit: actualizar kit** | Lo mismo con `omk update` | `terminal.create` con el literal `omk update` |
13
+ | **Orca Multiagent Kit: inicializar proyecto** | Un agente nuevo en el workspace activo con el prompt «inicializa el proyecto» (skill `kit-init`) | `agent.launch`; el agente sale del ajuste *Agente para inicializar* (por defecto `claude`) |
14
+ | **Orca Multiagent Kit: estado de los agentes** | Una línea por agente activo: título y estado | Lo que ha ido contando la barra de estado |
15
+ | **Contrato del worker** | Cada despacho de la skill `orca` lleva al final una línea que remite a `~/.agents/skills/orca/references/worker-contract.md` | Hook `agent.prompt.before` |
16
+ | **Barra de estado** `MAW · 2 trabajando · 1 bloqueado` | Agentes trabajando, bloqueados o esperando en todos los workspaces. Ámbar si hay alguno bloqueado. Al pulsarlo, el estado de los agentes | Evento `agent.status.changed` y `agents.list` al arrancar |
17
+
18
+ Si `omk` no está en el `PATH`, el terminal muestra el error del shell y, en unos 15 s, llega una notificación con cómo instalarlo (`npm install -g orca-multiagent-kit` o `./install.sh`). Si el plugin no identifica el workspace activo (ninguno enfocado, o dos con el mismo nombre y rama), avisa y no ejecuta nada: es preferible no lanzar nada a lanzarlo en otro workspace.
19
+
20
+ ### Por qué el contrato del worker
21
+
22
+ Con el motor Orca, la skill `orca` copia en el despacho solo parte del contrato (entorno §1.4, alcance §2, verificación §4 e informe §5), porque Orca ya le explica al worker cómo preguntar y cómo cerrar con `worker_done`. El hook añade una línea que remite al fichero completo, para que el worker tenga también el arranque y la implementación. Para eso:
23
+
24
+ - Solo actúa sobre prompts que Orca marca como despacho de orquestación (`inputKind: "orchestration"`). Nunca toca lo que escribes tú, los prompts de arranque de un agente ni `orca terminal send`.
25
+ - En el modo por defecto (*Solo despachos del kit*), además, el despacho tiene que llevar la cabecera de la skill `orca` (`UNIT: U<n> …` al principio de una línea y `RUN: …`). Las líneas `ROL:` y `SETUP:` que la skill añade desde la 1.4.0 no cambian esa detección. Los despachos de otros coordinadores pasan intactos. *Todos los despachos* lo añade a cualquiera; *Desactivado* lo apaga.
26
+ - Si el prompt ya cita `worker-contract.md`, no lo repite.
27
+ - **No deniega nunca** y falla en abierto (`"onError": "pass"`): si el worker del plugin falla o tarda más de 2 s, Orca envía el prompt sin cambios. Es una ayuda para el worker, no un control de seguridad.
28
+
29
+ ## Permisos que pide
30
+
31
+ Es un plugin `trusted-worker`: Orca ejecuta `src/worker.ts` en un proceso Node aparte, con el acceso de tu usuario a la máquina. Por eso pide aprobación al instalarlo. Las capacidades, y para qué se usa cada una:
32
+
33
+ | Capacidad | Para qué | Si no la concedes |
34
+ |---|---|---|
35
+ | `workspace:read` | Saber qué workspace está enfocado (`workspace.readContext` + `workspace.list`) y enterarse de los que se eliminan | Los comandos no saben dónde ejecutarse |
36
+ | `terminal:send` | Abrir un terminal con `omk verify` / `omk update` (`terminal.create`) | No hay comandos de verificar ni actualizar |
37
+ | `terminal:read` | Leer la salida de **ese** terminal para detectar que `omk` no existe y avisar | El fallo se ve en el terminal, pero no llega la notificación |
38
+ | `agent:launch` | Lanzar el agente de «inicializar proyecto» (`agent.launch`) | No hay comando de inicializar |
39
+ | `agent:read` | Contar agentes por estado para la barra (`agents.list`, `agent.status.changed`) | La barra se queda en `MAW` |
40
+ | `notifications:show` | Avisos accionables (sin `omk`, sin workspace, fallos de Orca) | Los avisos solo quedan en `orca plugin logs` |
41
+ | `settings:own` | Leer los tres ajustes del plugin | Se usan los valores por defecto |
42
+
43
+ Lo que **no** hace: no envía al terminal texto que venga de un usuario, de un agente o de un fichero (los dos comandos son literales fijos). El id de agente del ajuste se valida (`^[a-z0-9][a-z0-9-]{0,39}$`) antes de pasarlo a `agent.launch`. No usa red, secretos ni almacenamiento, no lee ficheros del proyecto y no importa módulos de Node (`fs`, `child_process`…): todo pasa por la API de Orca y sus capacidades.
44
+
45
+ ## Instalar
46
+
47
+ El manifiesto está en `orca-plugin/`, no en la raíz del repo, así que se instala desde una carpeta (ver *Limitaciones*). Elige la que tengas:
48
+
49
+ ```bash
50
+ # Desde un clon o el zip de la release
51
+ orca plugin install ./orca-plugin --json
52
+
53
+ # Con el kit instalado por npm (npm i -g orca-multiagent-kit)
54
+ orca plugin install "$(npm root -g)/orca-multiagent-kit/orca-plugin" --json
55
+ ```
56
+
57
+ La primera vez termina con `approval_required` (código de salida 3). `error.data` lista lo que concedería (la tabla de arriba) y el comando exacto para repetirlo con `--approve <fingerprint>`. Revísalo y, si estás de acuerdo, ejecuta ese comando tal cual. La huella está ligada a esta versión, sus ficheros y su acceso: si una versión nueva pide algo más, Orca vuelve a preguntar. El plugin queda como `local.multiagent-kit`.
58
+
59
+ Ajustes en *Settings → Plugins → Orca Multiagent Kit*:
60
+
61
+ | Ajuste | Por defecto | Valores |
62
+ |---|---|---|
63
+ | Contrato del worker en los despachos | Solo despachos del kit | Solo del kit · Todos · Desactivado |
64
+ | Agentes en la barra de estado | Activado | sí / no |
65
+ | Agente para inicializar | `claude` | Id de agente de Orca (`claude`, `codex`…) |
66
+
67
+ ## Desactivar o quitar
68
+
69
+ ```bash
70
+ orca plugin disable local.multiagent-kit --json # deja de ejecutarse; se reactiva con enable
71
+ orca plugin uninstall local.multiagent-kit --json # lo quita
72
+ ```
73
+
74
+ Sin plugin, el kit sigue funcionando igual. Solo se pierden la paleta, la barra y la línea del contrato en los despachos.
75
+
76
+ ## Limitaciones
77
+
78
+ - **Barra de estado**: al arrancar solo conoce los agentes del workspace enfocado (`agents.list` no da más); los de los demás aparecen con su siguiente cambio de estado. Un agente cuyo terminal se cierra sin pasar a `done` sigue contando hasta que se elimina su workspace o se reinicia el plugin (`orca plugin restart local.multiagent-kit`).
79
+ - **Detección de `omk` ausente**: es heurística. Busca durante ~15 s el mensaje de "comando no encontrado" de bash, zsh, fish, cmd y PowerShell, en inglés y español. Con otros idiomas o shells, el error se ve en el terminal pero no llega la notificación.
80
+ - En un workspace remoto (SSH), `omk` se ejecuta en ese host, que es donde se usa el kit en ese workspace.
81
+
82
+ DEFERRED:
83
+ - **Progreso del run en la barra** (`ronda 1 · 2/3 unidades`): exige leer `.work/runs/<run>/units.md`, y la API de Orca no da acceso a ficheros a los workers. Hoy el coordinador lo deja en el comentario del worktree (`orca worktree set --comment`).
84
+ - **Instalación desde Git** (`orca plugin install FernandoBaqueroo/orca-multiagent-kit`): la ayuda de `orca plugin install` (1.4.252) no documenta instalar desde una subcarpeta del repositorio. Haría falta un repo propio para el plugin o confirmar que Orca acepta una URL `tree/<ref>/orca-plugin`.
85
+ - **Instalación automática** con `install.sh` / `omk install`: ahora se instala a mano. Para hacerlo automático hay que tocar el instalador, y se deja para otro PR.
86
+ - **Preparar worktrees nuevos** (`workspace.create.after`): ya lo hacen `orca.yaml` (`scripts.setup`, `sharedDirectories`), `.worktreeinclude` y `worker-start --setup run`, que la skill pasa siempre; un hook duplicaría ese trabajo.
87
+ - **Rol y modelo en la barra de estado**: la barra cuenta agentes por estado, pero no sabe qué rol de Olimpo ni qué nivel de modelo tiene cada uno; eso está en `.work/runs/<run>/run.md`, que el plugin no puede leer.
88
+
89
+ ## Probarlo
90
+
91
+ ```bash
92
+ orca plugin validate orca-plugin --json # manifiesto como lo carga Orca
93
+ orca plugin test orca-plugin --json # 38 pruebas: src/kit.test.ts y src/worker.test.ts
94
+ orca plugin check orca-plugin --json
95
+ orca plugin inspect orca-plugin --json # qué aporta y qué acceso pide
96
+ bash scripts/check.sh # comprobación estática del manifiesto, también en CI (sin Orca)
97
+ ```
98
+
99
+ Las pruebas usan `orca/testing`: `mountWorker` sobre un host simulado con las capacidades del manifiesto. Cubren el hook (con y sin cabecera del kit, otros `inputKind`, el modo apagado e idempotencia), los comandos (literal enviado, workspace sin identificar, fallo de Orca notificado, id de agente hostil) y la barra (eventos, siembra inicial, desactivada). La detección de `omk` ausente se prueba con los mensajes reales de cada shell.
100
+
101
+ Para probarlo en Orca sin instalarlo: `orca plugin dev watch orca-plugin --json`. También pide aprobación, y `Ctrl-C` lo descarga.
102
+
103
+ RISK: con Orca 1.4.252, `orca plugin test` falla al importar `orca-runtime.mjs` cuando la ruta del plugin contiene una carpeta que empieza por punto (por ejemplo `.claude/worktrees/…`). Si te pasa, copia `orca-plugin/` a una ruta sin carpetas ocultas y ejecútalo allí.
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"
@@ -32,13 +55,13 @@ OLD_LANGS="cpp csharp dart-flutter go infra java kotlin php python react ruby ru
32
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
@@ -94,11 +117,19 @@ agent_names() { local o="" a; for a in $(printf '%s' "$AGENTS" | tr ',' ' '); do
94
117
  o="${o:+$o · }$a"; done; printf '%s' "$o"; }
95
118
  has_agent() { case ",$AGENTS," in *",$1,"*) return 0 ;; *) return 1 ;; esac; }
96
119
 
97
- # 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.
98
129
  stash() {
99
130
  local p="$1" rel
100
131
  [ -e "$p" ] || [ -L "$p" ] || return 0
101
- rel="${p#$HOME/}"
132
+ rel="$(backup_rel "$p")"
102
133
  run mkdir -p "$BK/$(dirname "$rel")"
103
134
  run mv "$p" "$BK/$rel"
104
135
  MOVED=$((MOVED+1))
@@ -107,17 +138,28 @@ stash() {
107
138
  snapshot() {
108
139
  local p="$1" rel
109
140
  [ -e "$p" ] || return 0
110
- rel="${p#$HOME/}"
141
+ rel="$(backup_rel "$p")"
111
142
  run mkdir -p "$BK/$(dirname "$rel")"
112
143
  run cp -a "$p" "$BK/$rel"
113
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"
114
146
  # Deja $2 como enlace simbolico a $1. Si habia otra cosa, va al backup.
115
147
  link() {
116
148
  local target="$1" l="$2"
117
149
  if [ -L "$l" ] && [ "$(readlink "$l")" = "$target" ]; then return 0; fi
118
150
  stash "$l"
119
151
  run mkdir -p "$(dirname "$l")"
120
- 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
121
163
  }
122
164
  # Quita los bloques gestionados (CSR, MAW, AGENTS) de un fichero, conservando el resto.
123
165
  strip_blocks() { # $1 fichero -> stdout
@@ -134,12 +176,58 @@ extract_overrides() { # $1 fichero -> stdout
134
176
  inb && /^## Overrides de este proyecto/ {ov=1; next}
135
177
  inb && ov && !/^<!--/ && !/^-[[:space:]]*$/ && NF>0 {print}' "$1"
136
178
  }
179
+ # Un .env con señales de produccion no se copia a los worktrees: ahi los agentes trabajan sin confirmacion.
180
+ # Solo se mira si hay coincidencia (grep -q): el contenido no se lee ni se muestra.
181
+ PROD_MARK='^[[:space:]]*(export[[:space:]]+)?(NODE_ENV|APP_ENV|RAILS_ENV|DJANGO_ENV|FLASK_ENV|ENVIRONMENT|ASPNETCORE_ENVIRONMENT)[[:space:]]*=[[:space:]]*["'"'"']?prod|[sprk]k_live_'
182
+ guard_worktreeinclude() { # $1 proyecto · $2 = 1 si .worktreeinclude ya existia (es del usuario: se avisa, no se edita)
183
+ local wi="$1/.worktreeinclude" f tmp hit="" cr
184
+ [ -f "$wi" ] || return 0
185
+ cr="$(printf '\r')"; tmp="$(mktemp)"
186
+ while IFS= read -r f || [ -n "$f" ]; do
187
+ f="${f%"$cr"}"
188
+ case "$f" in
189
+ ''|'#'*) printf '%s\n' "$f" ;;
190
+ *) if [ -f "$1/$f" ] && grep -Eiq "$PROD_MARK" "$1/$f" 2>/dev/null; then
191
+ hit="$hit $f"; printf '# %s <- desactivado: parece de produccion\n' "$f"
192
+ else printf '%s\n' "$f"; fi ;;
193
+ esac
194
+ done < "$wi" > "$tmp"
195
+ if [ -z "$hit" ]; then rm -f "$tmp"; return 0; fi
196
+ if [ "$2" -eq 1 ]; then
197
+ rm -f "$tmp"
198
+ item warn ".worktreeinclude copia ficheros que parecen de producción:$hit"
199
+ todo "$(basename "$1"): .worktreeinclude lista$hit, que parece(n) de producción. Quítalo(s) de la lista o usa un .env de desarrollo: cada worktree recibe una copia."
200
+ else
201
+ cat "$tmp" > "$wi"; rm -f "$tmp"
202
+ item warn ".worktreeinclude: desactivado$hit (parece de producción)"
203
+ todo "$(basename "$1"):$hit parece(n) de producción y no se copiará a los worktrees. Crea un .env de desarrollo (por ejemplo .env.development.local) o reactívalo en .worktreeinclude si de verdad es de desarrollo."
204
+ fi
205
+ }
137
206
  write_file() { # $1 destino, stdin contenido
138
207
  if [ "$DRY" -eq 1 ]; then cat >/dev/null; item dry "escribir $(short "$1")"; else mkdir -p "$(dirname "$1")"; cat > "$1"; fi
139
208
  }
140
209
 
141
210
  [ -f "$SRC/core/AGENTS.md" ] || { echo "No encuentro core/AGENTS.md en $SRC" >&2; exit 1; }
142
211
 
212
+ # ------------------------------------------------------------------ perfil de Claude de Orca
213
+ # Orca lanza Claude con CLAUDE_CONFIG_DIR apuntando a un perfil propio (orca/claude-profiles/<id>/home) que
214
+ # importa @~/.claude/CLAUDE.md y enlaza skills/, rules/... a ~/.claude. Ese perfil es de Orca: el kit instala en
215
+ # ~/.claude y el perfil lo hereda. Si el perfil no importa ~/.claude, no se toca Claude (escribir ahi no duraria).
216
+ ORCA_PROFILE=""; CLAUDE_SKIP=0
217
+ is_orca_profile() { # $1 ruta POSIX
218
+ case "$1" in */[Oo]rca/claude-profiles/*) return 0 ;; esac
219
+ [ -n "${ORCA_CLAUDE_INJECTED_CONFIG_DIR:-}" ] && [ "$(to_posix "$ORCA_CLAUDE_INJECTED_CONFIG_DIR")" = "$1" ]
220
+ }
221
+ if [ "$CLAUDE_DIR" != "$HOME/.claude" ] && is_orca_profile "$CLAUDE_DIR"; then
222
+ ORCA_PROFILE="$CLAUDE_DIR"
223
+ if grep -q '^@~/\.claude/CLAUDE\.md' "$ORCA_PROFILE/CLAUDE.md" 2>/dev/null; then
224
+ CLAUDE_DIR="$HOME/.claude"
225
+ else
226
+ CLAUDE_SKIP=1
227
+ 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."
228
+ fi
229
+ fi
230
+
143
231
  # ------------------------------------------------------------------ restore
144
232
  if [ -n "$RESTORE" ]; then
145
233
  R="$AG/backups/$RESTORE"; [ -d "$R" ] || { echo "No existe la copia $R (consulta: omk backups)" >&2; exit 1; }
@@ -148,10 +236,14 @@ if [ -n "$RESTORE" ]; then
148
236
  N=0
149
237
  while IFS= read -r rel; do
150
238
  [ -n "$rel" ] || continue
151
- dest="$HOME/$rel"
152
- # si algun directorio padre es ahora un enlace (p. ej. una skill enlazada), quita el enlace: no escribir a traves de el
239
+ case "$rel" in _abs/*) dest="/${rel#_abs/}" ;; *) dest="$HOME/$rel" ;; esac
240
+ # si algun directorio padre es ahora un enlace del kit (p. ej. una skill enlazada a ~/.agents), quitalo:
241
+ # no escribir a traves de el. Los enlaces ajenos (dotfiles, perfiles de Orca) se respetan.
153
242
  p="$(dirname "$dest")"
154
- while [ "$p" != "$HOME" ] && [ "$p" != "/" ]; do [ -L "$p" ] && run rm -f "$p"; p="$(dirname "$p")"; done
243
+ while [ "$p" != "$HOME" ] && [ "$p" != "/" ] && [ "$p" != "." ]; do
244
+ if [ -L "$p" ]; then case "$(readlink "$p")" in "$AG"/*) run rm -f "$p" ;; esac; fi
245
+ p="$(dirname "$p")"
246
+ done
155
247
  if [ -L "$dest" ] || [ -f "$dest" ]; then run rm -f "$dest"; fi
156
248
  run mkdir -p "$(dirname "$dest")"; run cp -a "$R/$rel" "$dest"
157
249
  N=$((N+1))
@@ -173,6 +265,11 @@ if [ -z "$AGENTS" ]; then
173
265
  [ -d "$CURSOR_DIR" ] && AGENTS="$AGENTS,cursor"
174
266
  AGENTS="${AGENTS#,}" # devin solo con --agents (opt-in)
175
267
  fi
268
+ if [ "$CLAUDE_SKIP" -eq 1 ]; then
269
+ AGENTS="$(printf ',%s,' "$AGENTS" | sed 's/,claude,/,/; s/^,//; s/,$//')"
270
+ fi
271
+ [ -n "$ORCA_PROFILE" ] && [ "$CLAUDE_SKIP" -eq 0 ] && has_agent claude && \
272
+ info "Claude Code: perfil de Orca detectado ($(short "$ORCA_PROFILE")); se instala en ~/.claude, que el perfil importa. El perfil no se toca."
176
273
 
177
274
  # ------------------------------------------------------------------ adopt
178
275
  if [ -n "$ADOPT" ]; then
@@ -183,10 +280,11 @@ if [ -n "$ADOPT" ]; then
183
280
  [ -e "$DEST" ] && { echo "Ya existe $DEST. Si es la misma skill, borra una de las dos copias antes." >&2; exit 1; }
184
281
  title "Adoptar skill" "$NAME"
185
282
  phase "Compartiendo $NAME con todos los agentes"
283
+ check_links
186
284
  run mkdir -p "$BK" "$AG/skills"
187
285
  run cp -a "$SKD" "$BK/$NAME.orig"
188
286
  run mv "$SKD" "$DEST"
189
- run ln -s "$DEST" "$SKD"
287
+ run ln -s "$DEST" "$SKD" || { echo "No se pudo crear el enlace $SKD -> $DEST. $LINK_HELP" >&2; exit 1; }
190
288
  item add "copia única en $(short "$DEST")"
191
289
  item add "en su sitio original queda un enlace"
192
290
  case "$SKD" in "$CLAUDE_DIR"/skills/*) ;; *) has_agent claude && { link "$DEST" "$CLAUDE_DIR/skills/$NAME"; item add "enlazada en Claude Code"; } ;; esac
@@ -203,27 +301,41 @@ if [ "$VERIFY" -eq 1 ]; then
203
301
  vok() { nok=$((nok+1)); if [ -n "$EV" ]; then ev "check::ok::$1"; else printf ' %s✓%s %s\n' "$C_L" "$C_0" "$1"; fi; }
204
302
  vfail() { bad=$((bad+1)); if [ -n "$EV" ]; then ev "check::fail::$1"; else printf ' %s✗ %s%s\n' "$C_R" "$1" "$C_0"; fi; }
205
303
  vinfo() { if [ -n "$EV" ]; then ev "check::info::$1"; else printf ' %s· %s%s\n' "$C_D" "$1" "$C_0"; fi; }
206
- chk_link() { if [ -L "$3" ] && [ "$(readlink "$3")" = "$2" ]; then vok "$1"; else vfail "$1: $(short "$3") no enlaza a $(short "$2")"; fi; }
304
+ chk_link() {
305
+ if [ -L "$3" ] && [ "$(readlink "$3")" = "$2" ]; then vok "$1"
306
+ elif [ -e "$3" ] && [ ! -L "$3" ]; then vfail "$1: $(short "$3") es una copia, no un enlace (acabará divergiendo; ejecuta omk install)"
307
+ else vfail "$1: $(short "$3") no enlaza a $(short "$2")"; fi; }
308
+ # Skills de un agente: separa las copias (divergen en silencio) de las que faltan o apuntan a otro sitio.
309
+ chk_skills() { # $1 agente · $2 carpeta de skills
310
+ local s ms="" cs=""
311
+ for s in $KIT_SKILLS; do
312
+ if [ -L "$2/$s" ] && [ "$(readlink "$2/$s")" = "$AG/skills/$s" ]; then continue; fi
313
+ if [ -e "$2/$s" ] && [ ! -L "$2/$s" ]; then cs="$cs $s"; else ms="$ms $s"; fi
314
+ done
315
+ [ -n "$cs" ] && vfail "$1: skills copiadas en vez de enlazadas (acabarán divergiendo; ejecuta omk install):$cs"
316
+ [ -n "$ms" ] && vfail "$1: skills sin enlazar:$ms"
317
+ [ -z "$cs$ms" ] && vok "$1: skills enlazadas"; return 0; }
207
318
  title "Verificación" "$(agent_names)"
319
+ [ "$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"
208
320
  [ -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"
209
321
  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"
210
322
  ms=""; for s in $KIT_SKILLS; do [ -f "$AG/skills/$s/SKILL.md" ] || ms="$ms $s"; done
211
323
  [ -z "$ms" ] && vok "$NSK skills del kit" || vfail "faltan skills:$ms"
324
+ [ -f "$AG/skills/orca/references/olimpo.md" ] && vok "roles de Olimpo" || vfail "falta skills/orca/references/olimpo.md: ejecuta omk install"
325
+ [ -f "$AG/models.md" ] && vok "modelos por nivel en ~/.agents/models.md" || vfail "falta ~/.agents/models.md (qué modelo usa cada nivel): ejecuta omk install"
212
326
  [ -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)"
213
327
  for s in $OLD_SKILLS; do [ -e "$AG/skills/$s" ] && vfail "skill retirada sigue instalada: $s"; done
214
328
  if has_agent claude; then
215
329
  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"
216
330
  grep -Eq '<!-- (CSR|MAW):BEGIN' "$CLAUDE_DIR/CLAUDE.md" 2>/dev/null && vfail "Claude Code: CLAUDE.md conserva bloques CSR/MAW antiguos" || true
217
331
  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
218
- ms=""; for s in $KIT_SKILLS; do [ -L "$CLAUDE_DIR/skills/$s" ] && [ "$(readlink "$CLAUDE_DIR/skills/$s")" = "$AG/skills/$s" ] || ms="$ms $s"; done
219
- [ -z "$ms" ] && vok "Claude Code: skills enlazadas" || vfail "Claude Code: skills sin enlazar:$ms"
332
+ chk_skills "Claude Code" "$CLAUDE_DIR/skills"
220
333
  fi
221
334
  if has_agent antigravity; then
222
335
  chk_link "Antigravity: GEMINI.md es el núcleo" "$AG/AGENTS.md" "$GEMINI_DIR/GEMINI.md"
223
336
  for r in $OLD_RULES; do [ -e "$GEMINI_DIR/rules/$r" ] && vfail "Antigravity: copia antigua $(short "$GEMINI_DIR/rules/$r")"; done
224
337
  [ -e "$GEMINI_DIR/config/plugins/claude-session-rules" ] && vfail "Antigravity: el plugin claude-session-rules sigue instalado (duplica csr-*)"
225
- ms=""; for s in $KIT_SKILLS; do [ -L "$GEMINI_DIR/config/skills/$s" ] && [ "$(readlink "$GEMINI_DIR/config/skills/$s")" = "$AG/skills/$s" ] || ms="$ms $s"; done
226
- [ -z "$ms" ] && vok "Antigravity: skills enlazadas" || vfail "Antigravity: skills sin enlazar:$ms"
338
+ chk_skills "Antigravity" "$GEMINI_DIR/config/skills"
227
339
  fi
228
340
  has_agent codex && chk_link "Codex: AGENTS.md es el núcleo" "$AG/AGENTS.md" "$CODEX_DIR/AGENTS.md"
229
341
  has_agent copilot && chk_link "Copilot CLI: copilot-instructions.md es el núcleo" "$AG/AGENTS.md" "$COPILOT_DIR/copilot-instructions.md"
@@ -241,6 +353,7 @@ if [ "$PROJECT_ONLY" -eq 0 ]; then
241
353
  [ -n "$AGENTS" ] || { echo "No detecto ningún agente (Claude Code, Antigravity, Codex, Copilot o Cursor). Indica cuáles con --agents." >&2; exit 1; }
242
354
  SUB="$(agent_names)"; [ "$DRY" -eq 1 ] && SUB="$SUB · simulación, no se escribe nada"
243
355
  title "Orca Multiagent Kit v${VERSION}" "$SUB"
356
+ check_links
244
357
  run mkdir -p "$BK"
245
358
 
246
359
  # 1. Fuente canonica
@@ -262,6 +375,9 @@ if [ "$PROJECT_ONLY" -eq 0 ]; then
262
375
  [ -e "$AG/speckit-ext/orca" ] && run rm -rf "$AG/speckit-ext/orca"
263
376
  run cp -R "$SRC/speckit-extension/orca" "$AG/speckit-ext/orca"
264
377
  NR=$(find "$SRC/rules" -name '*.md' | wc -l | tr -d ' '); NS=$NSK
378
+ # models.md es del usuario (que modelo usa cada nivel en cada proveedor): se crea una vez y no se pisa nunca.
379
+ if [ -e "$AG/models.md" ]; then item keep "models.md es tuyo: no se toca"
380
+ else run cp "$SRC/templates/models.md" "$AG/models.md"; item add "models.md creado (qué modelo usa cada nivel; edítalo cuando quieras)"; fi
265
381
  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
266
382
  done_phase "núcleo · $NR reglas · $NS skills · extensión de spec-kit"
267
383
 
@@ -369,9 +485,11 @@ if [ -n "$PROJECT" ]; then
369
485
  item add "CLAUDE.md importa AGENTS.md"
370
486
  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."
371
487
  rm -f "$TMP" "$REST"
488
+ [ -e "$PROJECT/.worktreeinclude" ] && HADWI=1 || HADWI=0
372
489
  for f in STACK.md ORCHESTRATION.md orca.yaml .worktreeinclude; do
373
490
  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
374
491
  done
492
+ guard_worktreeinclude "$PROJECT" "$HADWI"
375
493
  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
376
494
  if [ -d "$PROJECT/.specify" ]; then
377
495
  EXT="$PROJECT/.specify/extensions.yml"
@@ -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.
@@ -0,0 +1,80 @@
1
+ {
2
+ "manifestVersion": 2,
3
+ "id": "multiagent-kit",
4
+ "name": "Orca Multiagent Kit",
5
+ "version": "0.1.0",
6
+ "description": "Comandos del kit en la paleta, el contrato del worker en cada despacho de orquestación del kit y los agentes activos en la barra de estado.",
7
+ "author": {
8
+ "name": "Fernando Baquero y Necro-Coder",
9
+ "url": "https://github.com/FernandoBaqueroo/orca-multiagent-kit"
10
+ },
11
+ "repository": "https://github.com/FernandoBaqueroo/orca-multiagent-kit",
12
+ "homepage": "https://github.com/FernandoBaqueroo/orca-multiagent-kit/blob/main/docs/PLUGIN-ORCA.md",
13
+ "license": "MIT",
14
+ "engines": {
15
+ "orca": ">=1.4.248"
16
+ },
17
+ "execution": "trusted-worker",
18
+ "pluginApi": 1,
19
+ "main": "src/worker.ts",
20
+ "capabilities": [
21
+ { "kind": "workspace:read" },
22
+ { "kind": "terminal:send" },
23
+ { "kind": "terminal:read" },
24
+ { "kind": "agent:launch" },
25
+ { "kind": "agent:read" },
26
+ { "kind": "notifications:show" },
27
+ { "kind": "settings:own" }
28
+ ],
29
+ "contributes": {
30
+ "commands": [
31
+ { "id": "kit.verify", "title": "Orca Multiagent Kit: verificar instalación", "when": "workspace" },
32
+ { "id": "kit.init", "title": "Orca Multiagent Kit: inicializar proyecto", "when": "workspace" },
33
+ { "id": "kit.update", "title": "Orca Multiagent Kit: actualizar kit", "when": "workspace" },
34
+ { "id": "agents.status", "title": "Orca Multiagent Kit: estado de los agentes" }
35
+ ],
36
+ "hooks": [
37
+ { "event": "agent.prompt.before", "onError": "pass" }
38
+ ],
39
+ "events": [
40
+ { "on": "agent.status.changed" },
41
+ { "on": "workspace.removed" }
42
+ ],
43
+ "statusBarItems": [
44
+ {
45
+ "id": "agents",
46
+ "text": "MAW",
47
+ "icon": "bot",
48
+ "tooltip": "Orca Multiagent Kit: agentes activos",
49
+ "command": "agents.status"
50
+ }
51
+ ],
52
+ "settings": [
53
+ {
54
+ "key": "contractHint",
55
+ "title": "Contrato del worker en los despachos",
56
+ "description": "Añade a cada despacho de orquestación una línea que remite a ~/.agents/skills/orca/references/worker-contract.md. «Solo del kit» actúa en los despachos de la skill orca (cabecera UNIT/RUN).",
57
+ "type": "string",
58
+ "default": "kit",
59
+ "enum": ["kit", "all", "off"],
60
+ "enumLabels": ["Solo despachos del kit", "Todos los despachos", "Desactivado"]
61
+ },
62
+ {
63
+ "key": "statusBar",
64
+ "title": "Agentes en la barra de estado",
65
+ "description": "Muestra cuántos agentes trabajan, están bloqueados o esperan, en todos los workspaces.",
66
+ "type": "boolean",
67
+ "default": true
68
+ },
69
+ {
70
+ "key": "initAgent",
71
+ "title": "Agente para inicializar",
72
+ "description": "Id del agente que lanza «inicializar proyecto» con el prompt «inicializa el proyecto» (skill kit-init), por ejemplo claude o codex.",
73
+ "type": "string",
74
+ "default": "claude",
75
+ "maxLength": 40,
76
+ "placeholder": "claude"
77
+ }
78
+ ]
79
+ }
80
+ }