orca-multiagent-kit 1.5.0 → 1.7.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.
- package/AI_INSTALL.md +4 -3
- package/CHANGELOG.md +70 -1
- package/GUIA.html +11 -9
- package/README.md +23 -23
- package/VERSION +1 -1
- package/bin/backup.js +44 -0
- package/bin/fetch.js +243 -0
- package/bin/hooks.js +187 -0
- package/bin/omk.js +134 -51
- package/bin/run/cleanup.js +402 -0
- package/bin/run/git.js +641 -0
- package/bin/run/glob.js +193 -0
- package/bin/run/ledger.js +243 -0
- package/bin/run/plan.js +328 -0
- package/bin/run/units.js +101 -0
- package/bin/run/util.js +116 -0
- package/bin/run.js +224 -0
- package/bin/setup.js +81 -8
- package/bin/sync.js +222 -0
- package/bin/team.js +353 -0
- package/bin/ui.js +8 -4
- package/bin/update.js +169 -0
- package/core/AGENTS.md +7 -7
- package/docs/EJECUTABLE.md +5 -4
- package/docs/MANUAL.md +16 -3
- package/docs/ORQUESTADOR.md +59 -1
- package/docs/PLUGIN-ORCA.md +131 -24
- package/hooks/orca-gate.cjs +402 -0
- package/install.sh +26 -13
- package/orca-plugin/README.md +7 -1
- package/orca-plugin/assets/logos/README.md +10 -0
- package/orca-plugin/assets/logos/agent.png +0 -0
- package/orca-plugin/assets/logos/aider.png +0 -0
- package/orca-plugin/assets/logos/amp.png +0 -0
- package/orca-plugin/assets/logos/antigravity.png +0 -0
- package/orca-plugin/assets/logos/claude.png +0 -0
- package/orca-plugin/assets/logos/cline.png +0 -0
- package/orca-plugin/assets/logos/codex.png +0 -0
- package/orca-plugin/assets/logos/copilot.png +0 -0
- package/orca-plugin/assets/logos/cursor.png +0 -0
- package/orca-plugin/assets/logos/devin.png +0 -0
- package/orca-plugin/assets/logos/droid.png +0 -0
- package/orca-plugin/assets/logos/gemini.png +0 -0
- package/orca-plugin/assets/logos/goose.png +0 -0
- package/orca-plugin/assets/logos/grok.png +0 -0
- package/orca-plugin/assets/logos/kimi.png +0 -0
- package/orca-plugin/assets/logos/kiro.png +0 -0
- package/orca-plugin/assets/logos/opencode.png +0 -0
- package/orca-plugin/assets/logos/qwen-code.png +0 -0
- package/orca-plugin/orca-plugin.json +25 -7
- package/orca-plugin/src/icons.test.ts +14 -0
- package/orca-plugin/src/icons.ts +30 -0
- package/orca-plugin/src/kit.test.ts +491 -22
- package/orca-plugin/src/kit.ts +687 -37
- package/orca-plugin/src/models.test.ts +28 -0
- package/orca-plugin/src/models.ts +29 -0
- package/orca-plugin/src/node.d.ts +40 -0
- package/orca-plugin/src/panel-state.ts +36 -0
- package/orca-plugin/src/panel.check.ts +71 -0
- package/orca-plugin/src/panel.test.tsx +296 -33
- package/orca-plugin/src/panel.tsx +501 -81
- package/orca-plugin/src/plan-card.test.ts +99 -0
- package/orca-plugin/src/plan-card.ts +107 -0
- package/orca-plugin/src/protocol.ts +205 -5
- package/orca-plugin/src/tabs/autonomy.tsx +72 -0
- package/orca-plugin/src/tabs/history.test.tsx +79 -0
- package/orca-plugin/src/tabs/history.tsx +119 -0
- package/orca-plugin/src/tabs/notices.test.tsx +184 -0
- package/orca-plugin/src/tabs/notices.tsx +274 -0
- package/orca-plugin/src/tabs/worktrees.test.tsx +131 -0
- package/orca-plugin/src/tabs/worktrees.tsx +138 -0
- package/orca-plugin/src/ui/action-card.tsx +112 -0
- package/orca-plugin/src/ui/agent-icon.tsx +13 -0
- package/orca-plugin/src/worker/actions.test.ts +288 -0
- package/orca-plugin/src/worker/actions.ts +292 -0
- package/orca-plugin/src/worker/context.test.ts +32 -0
- package/orca-plugin/src/worker/context.ts +95 -0
- package/orca-plugin/src/worker/history.test.ts +149 -0
- package/orca-plugin/src/worker/history.ts +181 -0
- package/orca-plugin/src/worker/notices.test.ts +356 -0
- package/orca-plugin/src/worker/notices.ts +288 -0
- package/orca-plugin/src/worker/system.test.ts +58 -0
- package/orca-plugin/src/worker/system.ts +122 -0
- package/orca-plugin/src/worker/worktrees.test.ts +177 -0
- package/orca-plugin/src/worker/worktrees.ts +188 -0
- package/orca-plugin/src/worker.test.ts +285 -24
- package/orca-plugin/src/worker.ts +344 -64
- package/output-styles/csr-minimal.md +1 -0
- package/package.json +3 -3
- package/rules/50-done-gate.md +1 -1
- package/rules/95-multi-agent.md +13 -3
- package/skills/kit-init/SKILL.md +16 -4
- package/skills/orca/SKILL.md +28 -5
- package/skills/orca/references/adapters/artifact.md +2 -0
- package/skills/orca/references/adapters/chat.md +2 -0
- package/skills/orca/references/adapters/native-plan.md +6 -0
- package/skills/orca/references/adapters/plan-file.md +2 -0
- package/skills/orca/references/engine-manual.md +7 -5
- package/skills/orca/references/engine-orca.md +1 -0
- package/skills/orca/references/engine-subagents.md +4 -4
- package/skills/orca/references/integrate.md +14 -2
- package/skills/orca/references/ledger.md +1 -1
- package/skills/orca/references/olimpo.md +2 -1
- package/skills/orca/references/plan-card.md +45 -0
- package/skills/orca/references/plan.md +2 -1
- package/skills/orca/references/units.md +1 -1
- package/skills/orca/references/worker-contract.md +2 -2
- package/templates/AGENTS.md +2 -2
- package/templates/CLAUDE.md +1 -1
- package/templates/claude-settings.json +25 -0
package/AI_INSTALL.md
CHANGED
|
@@ -16,12 +16,13 @@ Una sola fuente: `~/.agents/` (núcleo `AGENTS.md`, `rules/`, `skills/`, `templa
|
|
|
16
16
|
- Para probar el instalador, aísla siempre el entorno: `unset CLAUDE_CONFIG_DIR CODEX_HOME GEMINI_DIR AGENT_KIT_HOME ORCA_CLAUDE_INJECTED_CONFIG_DIR` además de un `HOME` desechable. Con solo `HOME`, esas variables siguen apuntando a la configuración real.
|
|
17
17
|
|
|
18
18
|
## 2. Instalación global / migración
|
|
19
|
+
Si hay `omk` (npm, npx o el ejecutable), el camino corto es `omk setup --dry-run` y, tras el «sí» del usuario, `omk setup`: hace lo de abajo y además deja `omk` en el PATH e instala el plugin de Orca, que pide su propia aprobación (no la des tú: es del usuario). Después, `omk update` lo actualiza todo. Con el zip o un clon:
|
|
19
20
|
1. `./install.sh --dry-run`. Enseña al usuario la lista de cambios y pide un «sí»: toca su configuración global.
|
|
20
21
|
2. `./install.sh` (o `--agents <lista>` si el usuario lo limita).
|
|
21
|
-
3. `./install.sh --verify
|
|
22
|
+
3. `./install.sh --verify` (u `omk verify`). Tiene que acabar en «Todo correcto»; cualquier `✗` se corrige antes de terminar.
|
|
22
23
|
4. Reporta: agentes configurados, ruta del backup, los avisos que imprimió el instalador y el comando `--restore` para deshacerlo.
|
|
23
24
|
|
|
24
|
-
Sin shell disponible: replica `install.sh` por pasos, en este orden: (a) copia `core/AGENTS.md`, `rules/`, `skills/`, `templates/` y `output-styles/` a `~/.agents/`, y `templates/models.md` a `~/.agents/models.md` si no existe; (b) en `~/.claude/CLAUDE.md` sustituye los bloques CSR/MAW por `@~/.agents/AGENTS.md` dentro de un bloque `AGENTS`; (c) `~/.gemini/GEMINI.md`, `~/.codex/AGENTS.md` y `~/.copilot/copilot-instructions.md` → enlace a `~/.agents/AGENTS.md`; (d) skills enlazadas en `~/.claude/skills/` y `~/.gemini/config/skills/`; (e) saca de `~/.claude/rules/` y `~/.gemini/rules/` los ficheros de CSR/MAW (**Claude Code carga todo `~/.claude/rules/` en cada sesión**).
|
|
25
|
+
Sin shell disponible: replica `install.sh` por pasos, en este orden: (a) copia `core/AGENTS.md`, `rules/`, `skills/`, `templates/` y `output-styles/` a `~/.agents/`, `speckit-extension/orca` a `~/.agents/speckit-ext/orca`, `hooks/` a `~/.agents/hooks/`, `VERSION` a `~/.agents/AGENT_KIT_VERSION`, y `templates/models.md` a `~/.agents/models.md` si no existe; (b) en `~/.claude/CLAUDE.md` sustituye los bloques CSR/MAW por `@~/.agents/AGENTS.md` dentro de un bloque `AGENTS`; (c) `~/.gemini/GEMINI.md`, `~/.codex/AGENTS.md` y `~/.copilot/copilot-instructions.md` → enlace a `~/.agents/AGENTS.md`; (d) skills enlazadas en `~/.claude/skills/` y `~/.gemini/config/skills/`, y `~/.agents/output-styles/csr-minimal.md` enlazado en `~/.claude/output-styles/`; (e) saca de `~/.claude/rules/` y `~/.gemini/rules/` los ficheros de CSR/MAW (**Claude Code carga todo `~/.claude/rules/` en cada sesión**).
|
|
25
26
|
|
|
26
27
|
## 3. Proyecto
|
|
27
28
|
1. `./install.sh --project-only <ruta>`. Migra los overrides del bloque CSR antiguo a `AGENTS.md` y deja `CLAUDE.md` como `@AGENTS.md`.
|
|
@@ -38,7 +39,7 @@ Sin shell disponible: replica `install.sh` por pasos, en este orden: (a) copia `
|
|
|
38
39
|
## 5. Comprobación final (obligatoria)
|
|
39
40
|
```
|
|
40
41
|
prueba | esperado | estado
|
|
41
|
-
--verify |
|
|
42
|
+
--verify | «Todo correcto», sin ✗ |
|
|
42
43
|
ls ~/.claude/rules ~/.gemini/rules | sin ficheros de CSR/MAW |
|
|
43
44
|
grep -c 'CSR:BEGIN' ~/.claude/CLAUDE.md | 0 |
|
|
44
45
|
nueva sesión: «¿dónde están tus reglas de seguridad?» | ~/.agents/rules/30-security.md |
|
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,73 @@ El formato sigue [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y e
|
|
|
5
5
|
|
|
6
6
|
## [Unreleased]
|
|
7
7
|
|
|
8
|
+
## [1.7.0] - 2026-11-13
|
|
9
|
+
|
|
10
|
+
### Añadido
|
|
11
|
+
- **`omk run`, el motor determinista de los runs.** Lo mecánico de un run orquestado ya no depende de que el coordinador siga las referencias de memoria: `new`, `set`, `meta`, `log`, `status` y `list` llevan `run.md` respetando sus transiciones de estado; `plan` valida `units.md` y calcula rondas, solapes y si compensa; `start` hace la base fresca y crea la rama de integración con `--no-track`; `worktree` crea el de cada unidad desde la integración con sus `.env` de desarrollo; `check` comprueba el alcance contra `write`; `merge` ensaya con `merge-tree` y hace `--no-ff` sin push; `cleanup` hace el inventario y, con `--apply`, borra solo lo integrado y limpio. La skill `orca` dice qué orden toca en cada paso, y los pasos a mano siguen para quien no tenga `omk`. Detalle en `docs/ORQUESTADOR.md` §10; pruebas en `tests/test_run*.sh`.
|
|
12
|
+
- **Puerta de reparto obligatoria en Claude Code** (`hooks/orca-gate.cjs`, `omk gate on|off|status`). Recordar la regla no bastaba: el veredicto secuencial solo llegaba al chat en 4 de 16 ensayos y un reparto podía empezar sin esperar el «sí». Ahora, tras cargar la skill `orca`, Claude Code no edita el proyecto, no escribe desde la shell y no lanza workers hasta que el veredicto esté registrado (`echo "ORCA: …"`, porque el transcript le llega tarde al hook) y, si reparte, hasta que la persona responda al plan. Medido: 6 de 6 encargos con el veredicto antes de editar, sin denegaciones de más, y 2 de 2 repartos que esperan al «sí». Nunca bloquea por un fallo suyo. `omk setup`, `install` y `update` lo instalan en `~/.agents/hooks` y lo registran en `~/.claude/settings.json`; con el ejecutable y sin Node, lo ejecuta el propio `omk`. Pruebas en `tests/test_gate.sh`.
|
|
13
|
+
- **La orquestación se dispara también fuera de spec-kit.** Hasta ahora solo `/speckit.implement` tenía un disparador que no dependiera del criterio del agente (su hook `before_implement`); con un prompt normal, un plan nativo o un artefacto, casi siempre lo hacía todo un único agente. Ahora:
|
|
14
|
+
- **Puerta de reparto** en el núcleo (`core/AGENTS.md` §6, «YOU MUST»): antes de la primera edición de un trabajo con 2 o más entregables separables se carga la skill `orca` y su veredicto queda en el chat en una línea `ORCA: …` (con el plan de rondas y antes de editar, si reparte). En los ensayos la skill se cargó siempre y los encargos grandes se repartieron; lo que no es fiable es que la línea `ORCA: secuencial` de los encargos pequeños llegue al chat (cifras en `docs/ORQUESTADOR.md` §9). El agente ya no tiene que estimar de memoria si «compensa» antes de cargarla: lo decide la skill, que ahora esboza las unidades aunque no haya `tasks.md`.
|
|
15
|
+
- **Hooks de Claude Code** (`templates/claude-settings.json`): `UserPromptSubmit` recuerda la puerta en cada mensaje y `PostToolUse` sobre `ExitPlanMode`, al aprobar un plan. `omk setup`, `omk install` y `omk update` los fusionan en `~/.claude/settings.json` (y `omk init` / `omk update` / `kit-init`, en el `.claude/settings.json` del proyecto) sin tocar lo demás y con copia. `--no-hooks` u `OMK_NO_HOOKS=1` para que no los pongan.
|
|
16
|
+
- Todo plan que escribe el agente (modo plan, `implementation_plan.md`, `planes/*.md`, artefacto) termina con una sección `Reparto`, que es lo que se ejecuta con «implementa el plan».
|
|
17
|
+
- La cuenta de «¿compensa?» era demasiado cara para trabajos pequeños: con 10 min por unidad y 10 por ronda, dos unidades medianas nunca compensaban. Ahora son 5 y 5, y ante un empate se reparte (`rules/95-multi-agent.md`).
|
|
18
|
+
- En Antigravity y Codex no hay hook: les aplica la regla del núcleo. Detalle y tabla de disparadores en `docs/ORQUESTADOR.md` §9.
|
|
19
|
+
- **Plugin v0.7.0 — acción en curso**: lo que lanzas desde el panel o la paleta (verificar, actualizar, inicializar, *Repartir* y los `omk team` de *Equipo*) se ve en el panel, encima de las pestañas: en curso, esperando tu respuesta, terminado o fallido, con las últimas líneas de su terminal. Antes solo decía que había abierto un terminal, y la API de plugins no deja traerlo al frente. Si `omk update` pide aprobar el plugin nuevo, se contesta con «Aprobar» o «Rechazar» desde la tarjeta. El seguimiento sobrevive al reinicio del plugin que provoca la propia actualización. Detalle en [`docs/PLUGIN-ORCA.md`](docs/PLUGIN-ORCA.md#acción-en-curso).
|
|
20
|
+
- **Un comando lo instala todo y otro lo actualiza todo, se instale como se instale**:
|
|
21
|
+
- `npx orca-multiagent-kit setup` deja `omk` instalado (`npm install -g`) antes de seguir: el plugin de Orca lo usa desde el PATH y la copia de npx es temporal.
|
|
22
|
+
- `curl … get.sh | bash` baja el ejecutable de tu sistema, comprueba su SHA-256 y hace `omk setup`; donde no hay ejecutable, sigue con el zip e `install.sh` y dice qué falta.
|
|
23
|
+
- `omk update` sabe cómo llegó el kit: con npm instala la versión posterior; **el ejecutable se actualiza a sí mismo** (descarga el de la última release, comprueba su SHA-256 con el `.sha256` publicado y solo entonces se sustituye; solo HTTPS); una copia suelta (clon, zip) no se toca.
|
|
24
|
+
- Después pone al día `~/.agents`, el proyecto de la carpeta actual y el plugin de Orca si está instalado. Ya no hace falta `omk setup` después de actualizar. Opciones: `--offline` (sin descargar nada), `--yes`, `--no-project`, `--no-plugin`, `--dry-run`, `--force`. Pruebas en `tests/test_update.sh`.
|
|
25
|
+
- **Plantillas de proyecto al día**: `omk update` añade a `ORCHESTRATION.md` las secciones y los campos que la plantilla tiene y el fichero no, sin tocar lo escrito y con copia en `~/.agents/backups/`. Al final deja un sello (`<!-- omk:plantilla … -->`) con los apartados ya ofrecidos: lo que borres a propósito no vuelve, y en adelante solo entra lo que la plantilla estrene. `STACK.md` recibe el mismo trato, salvo que la primera vez solo se sella.
|
|
26
|
+
- `omk install` también deja el plugin de Orca en la versión del kit si ya estaba instalado (`--no-plugin` para que no lo mire). Quien actualiza desde un `omk` anterior, que al acabar solo llama a `omk install`, se lleva así el plugin nuevo.
|
|
27
|
+
- `omk <comando> --exit-marker` escribe al salir `[omk:fin] <comando> salida=<código>`: es como el plugin sabe que un comando ha terminado y cómo.
|
|
28
|
+
- Escenarios del panel para `orca plugin check` y `orca plugin shot --scenario` (`orca-plugin/src/panel.check.ts`).
|
|
29
|
+
|
|
30
|
+
### Corregido
|
|
31
|
+
- `omk update` reinstalaba la versión de npm aunque fuera **anterior** a la que tenías (una copia de desarrollo o una versión aún sin publicar): ahora solo actualiza a una posterior, y una copia que no viene de npm no se sustituye por la de npm.
|
|
32
|
+
- `omk update` ya no enseña el aviso `DEP0190` de Node al llamar a npm en Windows, y sigue con el `omk` recién instalado por su ruta en vez de buscarlo en el PATH.
|
|
33
|
+
- `omk` ya no depende de lo que imprimen `npm root -g` y `npm prefix -g` para encontrar la carpeta global: npm tapa con «***» los tramos de una ruta que le parecen un secreto (un UUID, por ejemplo), y con una ruta así fallaban el arranque desde npx y la comprobación de permisos. Ahora usa primero el prefijo que npm pasa por el entorno.
|
|
34
|
+
- Plugin: un fallo al lanzar una acción desde el panel (sin workspace activo, agente de inicializar no válido, error de Orca) salía como «Hecho». Ahora sale como error.
|
|
35
|
+
- La pregunta de aprobación del plugin (`omk setup`, `omk plugin install`, `omk update`) ya no espera para siempre en un terminal que nadie mira: sin respuesta en 10 minutos cuenta como «no».
|
|
36
|
+
- Los mensajes del instalador nombran el comando que tienes: `omk …` con npm, npx o el ejecutable (con npx, `npx orca-multiagent-kit …`) y la ruta de `install.sh` con el zip, un clon o curl. Antes mezclaban `omk install` y `./install.sh --verify` sin mirar cómo se había lanzado.
|
|
37
|
+
- Documentación al día con lo que hace el código: la instalación por IA (`AI_INSTALL.md`) copiaba una instalación incompleta y esperaba un texto que `verify` no imprime; la guía visual solo conocía `./install.sh`; la web enseñaba una salida y unos comandos que ya no existen; al manual le faltaba una regla, y el README prometía en `install.sh` equivalentes de comandos que solo tiene `omk`.
|
|
38
|
+
- Web: cabeceras de tabla y etiquetas por debajo de 11 px, `kbd` sin aire y un salto de nivel de encabezado en la portada.
|
|
39
|
+
|
|
40
|
+
### Cambiado
|
|
41
|
+
- El plugin lanza `omk` con `--exit-marker`: necesita un `omk` de esta versión o posterior. Con uno anterior, la tarjeta lo explica y dice cómo actualizarlo.
|
|
42
|
+
- Viniendo de la 1.6.0: el botón *Actualizar kit* del plugin antiguo instala el `omk` nuevo, que ya actualiza también el plugin. Si Orca pide aprobar la versión nueva, la pregunta sale en el terminal de esa actualización (el plugin antiguo no la enseña): contéstala ahí, o ejecuta `omk update` en un terminal. A partir de ahí, el botón lo hace todo y la aprobación se contesta desde el panel.
|
|
43
|
+
- Los marcadores de los bloques de proyecto (`AGENTS:BEGIN project`, `AGENTS:BEGIN project-claude`) ya no llevan una versión escrita a mano, que se había quedado en v1.0.0.
|
|
44
|
+
- El gate de dependencias se llama `deps-audit` en todas partes (antes, `deps` en el núcleo y en el ejemplo del reporte).
|
|
45
|
+
- `omk init` dice «se conserva» en vez de «no se toca» de los ficheros que ya existían.
|
|
46
|
+
|
|
47
|
+
## [1.6.0] - 2026-11-12
|
|
48
|
+
|
|
49
|
+
### Añadido
|
|
50
|
+
- **`omk team`**: enseña y cambia el equipo de roles del proyecto en `ORCHESTRATION.md` §1 (proveedores activos, revisión cruzada, un proveedor fijo por rol de Olimpo y roles propios del proyecto) sin tocar lo escrito a mano. `--data` recibe el equipo entero en base64url (lo usa el panel). Pruebas en `tests/test_team.sh`.
|
|
51
|
+
- **Plugin v0.5.0**: orquestación sin spec-kit. Todo agente que Orca arranca con una tarea (crear un worktree con tarea, pestaña nueva, issue) pasa primero por la skill `orca`, que decide si compensa repartir (ajuste *Repartir al lanzar un agente con tarea*, activado por defecto).
|
|
52
|
+
- Panel del plugin en pestañas *Agentes*, *Repartir*, *Equipo* y *Kit*.
|
|
53
|
+
- *Agentes*: cada agente con nombre (`U2 · Ariadna — Pagos` en los despachos del kit, el título de Orca o el agente que es), agrupados por run o workspace, los bloqueados primero; cada uno con su ficha (agente, unidad, rol y nivel, run, workspace, rama, carpeta, terminal o chat, último turno, desde cuándo) y un botón para ir a su workspace.
|
|
54
|
+
- *Repartir*: lanza el coordinador con la skill `orca` desde lo que escribes, un plan del repo o spec-kit; las dos primeras no necesitan spec-kit.
|
|
55
|
+
- *Equipo*: equipos predefinidos (Solo Claude, Claude + Codex revisor, Codex + Claude revisor) o personalizado; proveedores con casillas, un proveedor por rol de Olimpo y roles propios (nombre, qué hace, nivel, revisión, guardarraíl, proveedor). «Aplicar al proyecto» ejecuta `omk team set --data`.
|
|
56
|
+
- Los agentes (inicializar, coordinador, proveedores) se eligen de una lista con el catálogo de Orca, no se escriben.
|
|
57
|
+
- Avisos (ajuste *Avisos de agentes*) cuando un agente se bloquea y cuando terminan todas las unidades lanzadas de un run. El tooltip de la barra nombra a los agentes.
|
|
58
|
+
- **Plugin v0.6.0**: pestañas *Avisos*, *Worktrees* e *Historial*, iconos de agente y autonomía.
|
|
59
|
+
- *Avisos*: la tarjeta del plan de rondas del coordinador, en colores, con «Sí, lánzalo» y «Pedir cambio», que se escriben en su terminal; y los agentes bloqueados o esperando, con las últimas líneas de su terminal y una caja para responderles. La skill `orca` escribe el plan en `.work/runs/<run>/plan.json` (`references/plan-card.md`) y el plugin lo lee del hook `agent.tool.after`.
|
|
60
|
+
- Con el coordinador como chat de Orca (sin terminal), la tarjeta también sale y se contesta: el plugin lee `plan.json` del disco cuando el coordinador espera, y manda la respuesta por el buzón del Run de Orca (`orcaRun` en la tarjeta, `orca orchestration send` sin shell). La skill solo acepta esas respuestas para la confirmación 1.
|
|
61
|
+
- *Worktrees*: los worktrees de la orquestación por run, con sus agentes, estado y modelo (de `--model`), y «Cambiar modelo» (`/model`) para un Claude Code que espera.
|
|
62
|
+
- *Historial*: despachos, bloqueos, finales de unidad, runs terminados y lo que haces desde el panel; las 200 últimas entradas, guardadas en el plugin.
|
|
63
|
+
- El logo de cada agente, los mismos que usa Orca y a su tamaño (16 px), delante de cada agente y cada worktree; uno genérico para los que no tienen.
|
|
64
|
+
- Autonomía: en *Equipo*, la del proyecto (`ORCHESTRATION.md` §0); en *Repartir*, otra solo para ese run.
|
|
65
|
+
- **`omk team set --autonomy manual|semi|auto`**: cambia la línea `- Nivel:` de `ORCHESTRATION.md` §0; `omk team` la enseña.
|
|
66
|
+
|
|
67
|
+
### Corregido
|
|
68
|
+
- Plugin: el resultado de cada acción salía como «Consejo» (Orca pinta así un aviso sin título). Ahora dice «Hecho» o «No se pudo» y se puede cerrar.
|
|
69
|
+
- Plugin: los agentes salían «sin título» en el panel y en la barra. Cada cambio de estado sin título borraba el que ya se conocía; no se usaban ni el agente (`agents.list`, hook `agent.launch.before`, panel de los chats de Orca) ni el despacho del kit; y el workspace de los eventos (`<repo>::<ruta>`) no casaba con el de `workspace.list` (`identity:…`).
|
|
70
|
+
|
|
71
|
+
### Cambiado
|
|
72
|
+
- El plugin pide `workspace:write` (abrir el workspace de un agente) y observa el hook `agent.launch.before`; hay que volver a aprobarlo (`omk plugin install`).
|
|
73
|
+
- La v0.6.0 del plugin pide además `storage:own` (historial) y observa `agent.tool.after` (tarjeta del plan): otra aprobación.
|
|
74
|
+
|
|
8
75
|
## [1.5.0] - 2026-11-11
|
|
9
76
|
|
|
10
77
|
Orca listo de una vez: `omk setup`, un ejecutable sin Node y el plugin configurable desde un panel. Detalle en [`docs/EJECUTABLE.md`](docs/EJECUTABLE.md).
|
|
@@ -142,7 +209,9 @@ Primera versión de **Orca Multiagent Kit**. Une CSR (Claude Session Rules, de [
|
|
|
142
209
|
### Eliminado
|
|
143
210
|
- Copias duplicadas de reglas y skills `csr-*` dentro de cada agente, y el plugin `claude-session-rules` de Antigravity.
|
|
144
211
|
|
|
145
|
-
[Unreleased]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.
|
|
212
|
+
[Unreleased]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.7.0...HEAD
|
|
213
|
+
[1.7.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.6.0...v1.7.0
|
|
214
|
+
[1.6.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.5.0...v1.6.0
|
|
146
215
|
[1.5.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.4.1...v1.5.0
|
|
147
216
|
[1.4.1]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.4.0...v1.4.1
|
|
148
217
|
[1.4.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.3.0...v1.4.0
|
package/GUIA.html
CHANGED
|
@@ -206,13 +206,15 @@ footer{margin-top:64px;color:var(--muted);font-size:13px;text-align:center}
|
|
|
206
206
|
<p class="sub">Migra instalaciones anteriores automáticamente, con backup de todo lo que toca.</p>
|
|
207
207
|
<div class="steps">
|
|
208
208
|
<div class="step"><div><h3>Mira qué haría, sin tocar nada</h3>
|
|
209
|
-
<div class="cmd"><pre>
|
|
210
|
-
|
|
211
|
-
./install.sh --dry-run</pre><button class="copy" type="button">Copiar</button></div></div></div>
|
|
209
|
+
<div class="cmd"><pre>npx orca-multiagent-kit setup --dry-run</pre><button class="copy" type="button">Copiar</button></div>
|
|
210
|
+
<p class="muted small">Sin Node: abre el ejecutable de la última release, o <code>curl -fsSL …/scripts/get.sh | bash</code>. Con el zip o un clon del kit: <code>./install.sh --dry-run</code> (solo reglas y skills).</p></div></div>
|
|
212
211
|
<div class="step"><div><h3>Instala y verifica</h3>
|
|
213
|
-
<div class="cmd"><pre
|
|
214
|
-
|
|
215
|
-
<p class="muted small">Al final imprime avisos (por ejemplo, la línea para pegar en las reglas de usuario de Cursor) y el comando <code
|
|
212
|
+
<div class="cmd"><pre>npx orca-multiagent-kit setup
|
|
213
|
+
omk verify</pre><button class="copy" type="button">Copiar</button></div>
|
|
214
|
+
<p class="muted small">Un solo comando deja las reglas y las skills, <code>omk</code> en el PATH y, si usas Orca, su plugin. Al final imprime avisos (por ejemplo, la línea para pegar en las reglas de usuario de Cursor) y el comando <code>omk restore</code> para deshacerlo todo. Con el zip: <code>./install.sh</code> y <code>./install.sh --verify</code>.</p></div></div>
|
|
215
|
+
<div class="step"><div><h3>Para actualizar, otro</h3>
|
|
216
|
+
<div class="cmd"><pre>omk update</pre><button class="copy" type="button">Copiar</button></div>
|
|
217
|
+
<p class="muted small">Pone al día el kit, <code>~/.agents</code>, el proyecto de la carpeta en la que estés y el plugin de Orca.</p></div></div>
|
|
216
218
|
<div class="step"><div><h3>Reinicia los agentes</h3><p class="muted small">Claude Code, Antigravity y los demás que uses. A partir de aquí todos leen <code>~/.agents</code>.</p></div></div>
|
|
217
219
|
<div class="step"><div><h3>Opcional: comparte una skill externa con todos</h3>
|
|
218
220
|
<div class="cmd"><pre>./install.sh --adopt ~/.gemini/config/plugins/user-workflows/skills/impeccable</pre><button class="copy" type="button">Copiar</button></div>
|
|
@@ -369,18 +371,18 @@ chmod +x install.sh
|
|
|
369
371
|
<section id="problemas">
|
|
370
372
|
<h2>Si algo falla</h2>
|
|
371
373
|
<div class="glass pad">
|
|
372
|
-
<details><summary>Un agente no sigue las reglas</summary><p><code>./install.sh --verify</code> y reinicia el agente. En Claude, el bloque de <code>~/.claude/CLAUDE.md</code> tiene que contener <code>@~/.agents/AGENTS.md</code>. En sesiones de Cowork no se cargan imports de fuera de la carpeta de trabajo.</p></details>
|
|
374
|
+
<details><summary>Un agente no sigue las reglas</summary><p><code>omk verify</code> (o <code>./install.sh --verify</code>) y reinicia el agente. En Claude, el bloque de <code>~/.claude/CLAUDE.md</code> tiene que contener <code>@~/.agents/AGENTS.md</code>. En sesiones de Cowork no se cargan imports de fuera de la carpeta de trabajo.</p></details>
|
|
373
375
|
<details><summary>Antigravity no ve las skills</summary><p>Comprueba los enlaces en <code>~/.gemini/config/skills/</code> con <code>--verify</code> y reinicia Antigravity. Si se queja del plugin <code>claude-session-rules</code>, desactívalo: su contenido ya está en el núcleo.</p></details>
|
|
374
376
|
<details><summary>El agente orquesta tareas pequeñas</summary><p>Dile «hazlo inline». Si pasa a menudo, ajusta los umbrales en <code>rules/95-multi-agent.md</code>, en «Cuándo paralelizar».</p></details>
|
|
375
377
|
<details><summary>Conflictos en <code>tasks.md</code> o en el plan</summary><p>Un worker lo editó. Revierte su cambio en ese fichero: solo el coordinador marca tareas.</p></details>
|
|
376
378
|
<details><summary>Un worktree arranca sin dependencias o sin <code>.env</code></summary><p>El worker lo detecta al arrancar y se para con <code>BLOCKED: entorno</code>. Repite «inicializa el proyecto»: rellena el setup de <code>ORCHESTRATION.md</code> y <code>orca.yaml</code>. Lo que va en <code>.worktreeinclude</code> tiene que existir y estar en <code>.gitignore</code>. Solo <code>.env</code> de desarrollo: el instalador desactiva los que parecen de producción.</p></details>
|
|
377
379
|
<details><summary>Ha salido un modelo nuevo</summary><p>No hay que hacer nada. Con Claude, los alias apuntan solos al modelo vigente. Con los demás, la skill lo ve en el siguiente run y, si es de una familia nueva, decide ella su nivel con lo que publica el proveedor y te lo dice en el plan de rondas. Para cambiarlo a mano, edita <code>~/.agents/models.md</code>.</p></details>
|
|
378
380
|
<details><summary>Quedan worktrees o ramas de un run antiguo</summary><p>Di «limpia el run». El agente enseña el inventario y borra solo lo integrado y sin cambios pendientes, tras tu «sí».</p></details>
|
|
379
|
-
<details><summary>Quiero volver atrás</summary><p><code>./install.sh --restore <fecha></code> con la fecha que imprimió la instalación. Los backups están en <code>~/.agents/backups/</code>.</p></details>
|
|
381
|
+
<details><summary>Quiero volver atrás</summary><p><code>omk restore <fecha></code> (o <code>./install.sh --restore <fecha></code>) con la fecha que imprimió la instalación. Los backups están en <code>~/.agents/backups/</code>.</p></details>
|
|
380
382
|
</div>
|
|
381
383
|
</section>
|
|
382
384
|
|
|
383
|
-
<footer>Orca Multiagent Kit
|
|
385
|
+
<footer>Orca Multiagent Kit · Esta guía está en <code>orca-multiagent-kit/GUIA.html</code> · Detalle técnico: <code>docs/MANUAL.md</code> · Para una IA: <code>AI_INSTALL.md</code></footer>
|
|
384
386
|
</main>
|
|
385
387
|
<div class="toast" id="toast" role="status" aria-live="polite"></div>
|
|
386
388
|
|
package/README.md
CHANGED
|
@@ -66,34 +66,31 @@ npx orca-multiagent-kit install
|
|
|
66
66
|
<a id="instalar"></a>
|
|
67
67
|
## <img src="assets/icons/download.svg" width="22" height="22" alt=""> Instalar
|
|
68
68
|
|
|
69
|
-
|
|
69
|
+
**Un comando lo instala todo y otro lo actualiza todo**, llegue el kit como llegue. `omk setup` deja las reglas y las skills en `~/.agents`, cada agente enlazado a ellas, `omk` en el PATH y, si usas Orca, su plugin y su panel (te enseña lo que pide y te pregunta antes de aprobarlo). `omk update` pone al día el kit, `~/.agents`, el proyecto de la carpeta actual y el plugin. Todo se hace con backup y se deshace con `omk restore`.
|
|
70
70
|
|
|
71
|
-
**
|
|
72
|
-
|
|
73
|
-
**1. npx** (Node ≥ 18, sin instalar nada global)
|
|
71
|
+
**1. npx** (Node ≥ 18)
|
|
74
72
|
```bash
|
|
75
|
-
npx orca-multiagent-kit
|
|
76
|
-
npx orca-multiagent-kit
|
|
73
|
+
npx orca-multiagent-kit setup --dry-run # qué haría
|
|
74
|
+
npx orca-multiagent-kit setup
|
|
77
75
|
```
|
|
76
|
+
Deja `omk` instalado (`npm install -g`), porque el plugin de Orca lo usa desde el PATH. Es lo mismo que `npm install -g orca-multiagent-kit && omk setup`.
|
|
78
77
|
|
|
79
|
-
**2.
|
|
80
|
-
```bash
|
|
81
|
-
npm install -g orca-multiagent-kit
|
|
82
|
-
omk install
|
|
83
|
-
```
|
|
78
|
+
**2. Ejecutable** (sin Node): descarga el de tu sistema desde la [última release](https://github.com/FernandoBaqueroo/orca-multiagent-kit/releases/latest) (`omk-windows-x64.exe`, `omk-macos-arm64`, `omk-linux-x64`) y ábrelo: hace `omk setup`. Con `omk update` se descarga a sí mismo la versión nueva, comprobando su SHA-256. Detalle: [`docs/EJECUTABLE.md`](docs/EJECUTABLE.md).
|
|
84
79
|
|
|
85
|
-
**3. curl** (sin Node)
|
|
80
|
+
**3. curl** (sin Node): baja ese mismo ejecutable, comprueba su SHA-256 y hace `omk setup`
|
|
86
81
|
```bash
|
|
87
82
|
curl -fsSL https://raw.githubusercontent.com/FernandoBaqueroo/orca-multiagent-kit/main/scripts/get.sh | bash
|
|
88
83
|
```
|
|
89
84
|
|
|
90
|
-
**4. ZIP**
|
|
85
|
+
**4. ZIP o clon** (sin Node y sin ejecutable para tu sistema): instala las reglas y las skills; no hay `omk` ni plugin de Orca, y se actualiza repitiéndolo
|
|
91
86
|
```bash
|
|
92
87
|
curl -LO https://github.com/FernandoBaqueroo/orca-multiagent-kit/releases/latest/download/orca-multiagent-kit.zip
|
|
93
88
|
unzip orca-multiagent-kit.zip && cd orca-multiagent-kit
|
|
94
89
|
./install.sh --dry-run && ./install.sh
|
|
95
90
|
```
|
|
96
|
-
Cada [release](https://github.com/FernandoBaqueroo/orca-multiagent-kit/releases) publica `orca-multiagent-kit-vX.Y.Z.zip`
|
|
91
|
+
Cada [release](https://github.com/FernandoBaqueroo/orca-multiagent-kit/releases) publica `orca-multiagent-kit-vX.Y.Z.zip` con `SHA256SUMS` y cada ejecutable con su `.sha256`. Para comprobar la integridad: `shasum -a 256 -c SHA256SUMS`.
|
|
92
|
+
|
|
93
|
+
¿Solo las reglas y las skills, sin tocar Orca? `omk install` (o `npx orca-multiagent-kit install`).
|
|
97
94
|
|
|
98
95
|
Después, reinicia tus agentes y escribe en cada proyecto **«inicializa el proyecto»**. La skill `kit-init` detecta el stack leyendo el repo, crea `AGENTS.md`, `STACK.md` y `ORCHESTRATION.md`, y te hace como mucho 4 preguntas.
|
|
99
96
|
|
|
@@ -104,18 +101,21 @@ Requisitos: macOS, Linux, WSL o Git Bash, con bash ≥ 3.2.
|
|
|
104
101
|
|
|
105
102
|
| Comando | Qué hace |
|
|
106
103
|
|:--|:--|
|
|
107
|
-
| `omk setup [--yes] [--dry-run]` |
|
|
108
|
-
| `omk install [--agents a,b] [--dry-run]` |
|
|
104
|
+
| `omk setup [--yes] [--dry-run]` | **Lo instala todo**: reglas y skills en `~/.agents`, `omk` en el PATH, plugins de Orca encendidos, plugin del kit y su panel |
|
|
105
|
+
| `omk install [--agents a,b] [--dry-run]` | Solo la fuente única (`~/.agents`) para los agentes detectados; si el plugin de Orca ya está instalado, lo deja en la versión del kit |
|
|
109
106
|
| `omk plugin install\|status\|uninstall` | El plugin de Orca del kit; `install` pide tu aprobación (o `--yes`) |
|
|
107
|
+
| `omk run <subcomando>` | El motor de los runs de la skill `orca`: `plan` (rondas y si compensa), `start` (base fresca), `worktree`, `check` (alcance), `merge` y `cleanup`, con el estado en `.work/runs/<run>/run.md` (`omk run help`) |
|
|
108
|
+
| `omk gate on\|off\|status` | La puerta de reparto obligatoria de Claude Code: tras cargar la skill `orca`, no se edita hasta que su veredicto esté registrado y, si reparte, hasta que respondas al plan |
|
|
109
|
+
| `omk team` · `omk team set …` | Enseña o cambia el equipo de roles del proyecto (`ORCHESTRATION.md` §1): proveedores, revisión cruzada y proveedor por rol |
|
|
110
110
|
| `omk init [ruta]` | Prepara un proyecto (por defecto, la carpeta actual) |
|
|
111
111
|
| `omk verify` | Comprueba enlaces, imports y que no queden copias divergentes |
|
|
112
112
|
| `omk adopt <carpeta-skill>` | Comparte una skill externa (p. ej. impeccable) con todos los agentes |
|
|
113
113
|
| `omk backups` | Lista las copias de seguridad |
|
|
114
114
|
| `omk restore <fecha>` | Deshace una instalación |
|
|
115
|
-
| `omk update` |
|
|
115
|
+
| `omk update [--yes] [--offline]` | **Lo actualiza todo**: el kit (npm, o el ejecutable, que se descarga a sí mismo), `~/.agents`, el proyecto de la carpeta actual (bloques de `AGENTS.md`/`CLAUDE.md`, ficheros que falten y lo que estrenen las plantillas de `ORCHESTRATION.md` y `STACK.md`, sin tocar lo escrito) y el plugin de Orca. `--offline` reaplica esta versión sin descargar nada |
|
|
116
116
|
| `omk where` · `omk version` · `omk help` | Rutas, versión y ayuda |
|
|
117
117
|
|
|
118
|
-
|
|
118
|
+
Con el zip o un clon, `install`, `init`, `verify`, `adopt` y `restore` tienen su equivalente en `./install.sh` (`--project-only`, `--verify`, `--adopt`, `--restore`, `--dry-run`); `setup`, `update`, `plugin` y `team` necesitan `omk`.
|
|
119
119
|
|
|
120
120
|
<a id="agentes"></a>
|
|
121
121
|
## <img src="assets/icons/agents.svg" width="22" height="22" alt=""> Agentes soportados
|
|
@@ -151,7 +151,7 @@ Solo tienes que conocer dos frases. El resto lo deciden los agentes.
|
|
|
151
151
|
|
|
152
152
|
Convive con skills externas como **impeccable**, **supabase**, **spec-kit** y las de la app **Orca**: cada una manda en su terreno, y la puerta de validez y las prohibiciones se aplican siempre.
|
|
153
153
|
|
|
154
|
-
**Plugin de Orca** (opcional, Orca ≥ 1.4.248): `omk verify`, «inicializa el proyecto» y `omk update` en la paleta de comandos y en un panel lateral, *Multiagent Kit*, que además cambia los ajustes del plugin (los mismos de *Settings → Plugins*); el contrato del worker añadido a cada despacho de orquestación del kit, y los agentes activos en la barra de estado. Se instala con `omk plugin install` (o `omk setup`). Detalle, permisos que pide y cómo desactivarlo: [`docs/PLUGIN-ORCA.md`](docs/PLUGIN-ORCA.md).
|
|
154
|
+
**Plugin de Orca** (opcional, Orca ≥ 1.4.248): `omk verify`, «inicializa el proyecto» y `omk update` en la paleta de comandos y en un panel lateral, *Multiagent Kit*, que enseña el estado y la salida de cada acción mientras corre y además los agentes con nombre y su ficha (unidad, rol, rama, estado…), configura el equipo de roles (también roles propios), reparte una tarea entre agentes (sin necesidad de spec-kit) y cambia los ajustes del plugin (los mismos de *Settings → Plugins*); el contrato del worker añadido a cada despacho de orquestación del kit, avisos de agentes bloqueados y de runs terminados, y los agentes activos en la barra de estado. Se instala con `omk plugin install` (o `omk setup`). Detalle, permisos que pide y cómo desactivarlo: [`docs/PLUGIN-ORCA.md`](docs/PLUGIN-ORCA.md).
|
|
155
155
|
|
|
156
156
|
<a id="flujo"></a>
|
|
157
157
|
## <img src="assets/icons/flow.svg" width="22" height="22" alt=""> Flujo de trabajo
|
|
@@ -188,12 +188,12 @@ flowchart LR
|
|
|
188
188
|
|
|
189
189
|
```text
|
|
190
190
|
orca-multiagent-kit/
|
|
191
|
-
├── bin/ CLI omk (npm / npx / ejecutable), sin dependencias: omk · setup · orca · sea
|
|
191
|
+
├── bin/ CLI omk (npm / npx / ejecutable), sin dependencias: omk · setup · update · fetch · sync · team · orca · ui · sea
|
|
192
192
|
├── core/AGENTS.md núcleo siempre cargado (~80 líneas)
|
|
193
193
|
├── rules/ 00-router … 95-multi-agent + lang/ (17 lenguajes)
|
|
194
194
|
├── skills/ kit-init · orca · speckit-orca-implement · csr-*
|
|
195
195
|
├── speckit-extension/ extensión de spec-kit (hook before_implement)
|
|
196
|
-
├── templates/ AGENTS.md · CLAUDE.md · STACK.md · ORCHESTRATION.md · orca.yaml · .worktreeinclude · models.md
|
|
196
|
+
├── templates/ AGENTS.md · CLAUDE.md · STACK.md · ORCHESTRATION.md · orca.yaml · .worktreeinclude · claude-settings.json · models.md
|
|
197
197
|
├── output-styles/ csr-minimal (Claude Code)
|
|
198
198
|
├── orca-plugin/ plugin de Orca: comandos y panel del kit, contrato del worker, barra de estado
|
|
199
199
|
├── install.sh instala · migra · verifica · restaura · adopta
|
|
@@ -201,7 +201,7 @@ orca-multiagent-kit/
|
|
|
201
201
|
├── site/ web interactiva (GitHub Pages)
|
|
202
202
|
├── docs/MANUAL.md manual completo
|
|
203
203
|
├── AI_INSTALL.md instrucciones para que una IA lo instale
|
|
204
|
-
├── tests/ pruebas del instalador, del CLI, de omk setup (doble de Orca) y del ejecutable
|
|
204
|
+
├── tests/ pruebas del instalador, del CLI, de omk team, de omk setup y plugin (doble de Orca), de omk update, de spec-kit y del ejecutable
|
|
205
205
|
├── scripts/ check.sh · build-release.sh · build-exe.js · get.sh · banner.py
|
|
206
206
|
└── .github/ CI (Linux + macOS; ejecutable también en Windows), releases con zip y ejecutables, web, plantillas
|
|
207
207
|
```
|
|
@@ -226,7 +226,7 @@ orca-multiagent-kit/
|
|
|
226
226
|
Las contribuciones son bienvenidas. Lee [`CONTRIBUTING.md`](CONTRIBUTING.md): principios, cómo añadir skills o reglas, versionado y releases. Antes de abrir un PR:
|
|
227
227
|
|
|
228
228
|
```bash
|
|
229
|
-
npm test # check.sh
|
|
229
|
+
npm test # check.sh y todas las pruebas de tests/ menos la del ejecutable
|
|
230
230
|
```
|
|
231
231
|
|
|
232
232
|
[Código de conducta](CODE_OF_CONDUCT.md) · [Seguridad](SECURITY.md) · [Soporte](SUPPORT.md)
|
package/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.7.0
|
package/bin/backup.js
ADDED
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
// Copias de seguridad de lo que omk cambia fuera de install.sh (ficheros de proyecto, settings.json
|
|
2
|
+
// de Claude Code), en el mismo sitio y con el mismo formato que las de install.sh: «omk restore
|
|
3
|
+
// <fecha>» las deshace igual.
|
|
4
|
+
'use strict';
|
|
5
|
+
|
|
6
|
+
const fs = require('node:fs');
|
|
7
|
+
const os = require('node:os');
|
|
8
|
+
const path = require('node:path');
|
|
9
|
+
|
|
10
|
+
const stampNow = () => {
|
|
11
|
+
const d = new Date();
|
|
12
|
+
const two = (n) => String(n).padStart(2, '0');
|
|
13
|
+
return `${d.getFullYear()}${two(d.getMonth() + 1)}${two(d.getDate())}-${two(d.getHours())}${two(d.getMinutes())}${two(d.getSeconds())}`;
|
|
14
|
+
};
|
|
15
|
+
|
|
16
|
+
/**
|
|
17
|
+
* Ruta de un fichero dentro de una copia de seguridad, como la escribe install.sh (backup_rel):
|
|
18
|
+
* relativa a la carpeta del usuario si cuelga de ella; si no, bajo `_abs/` con su ruta absoluta
|
|
19
|
+
* (en Windows, con la unidad como la ve Git Bash: C:\x -> _abs/c/x).
|
|
20
|
+
*/
|
|
21
|
+
function backupRel(file, home = process.env.HOME || os.homedir(), platform = process.platform) {
|
|
22
|
+
const rel = path.relative(home, file);
|
|
23
|
+
if (rel && !rel.startsWith('..') && !path.isAbsolute(rel)) return rel.split(path.sep).join('/');
|
|
24
|
+
const posix = file.split(path.sep).join('/');
|
|
25
|
+
if (platform !== 'win32') return `_abs${posix}`;
|
|
26
|
+
const drive = /^([A-Za-z]):\/(.*)$/.exec(posix);
|
|
27
|
+
if (!drive) throw new Error(`no sé respaldar una ruta sin unidad: ${file}`);
|
|
28
|
+
return `_abs/${drive[1].toLowerCase()}/${drive[2]}`;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** Una copia de seguridad nueva en `<agentsHome>/backups/<fecha>`: su fecha y la función que copia un fichero a ella. */
|
|
32
|
+
function makeBackup(agentsHome) {
|
|
33
|
+
const stamp = stampNow();
|
|
34
|
+
return {
|
|
35
|
+
stamp,
|
|
36
|
+
backup(file) {
|
|
37
|
+
const target = path.join(agentsHome, 'backups', stamp, backupRel(file));
|
|
38
|
+
fs.mkdirSync(path.dirname(target), { recursive: true });
|
|
39
|
+
fs.copyFileSync(file, target);
|
|
40
|
+
},
|
|
41
|
+
};
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
module.exports = { backupRel, makeBackup };
|
package/bin/fetch.js
ADDED
|
@@ -0,0 +1,243 @@
|
|
|
1
|
+
// De dónde sale la versión nueva del kit en «omk update», según cómo se instaló:
|
|
2
|
+
// - npm: `npm install -g orca-multiagent-kit@latest`.
|
|
3
|
+
// - ejecutable autónomo: descarga el de la última release de GitHub, comprueba su SHA-256 con el
|
|
4
|
+
// `.sha256` publicado al lado y se sustituye a sí mismo.
|
|
5
|
+
// - una copia suelta (un clon de git, el zip): no se toca; se actualiza como se obtuvo.
|
|
6
|
+
// También deja omk instalado de forma permanente cuando se lanza con npx (`omk setup`).
|
|
7
|
+
'use strict';
|
|
8
|
+
|
|
9
|
+
const { spawnSync } = require('node:child_process');
|
|
10
|
+
const crypto = require('node:crypto');
|
|
11
|
+
const fs = require('node:fs');
|
|
12
|
+
const http = require('node:http');
|
|
13
|
+
const https = require('node:https');
|
|
14
|
+
const path = require('node:path');
|
|
15
|
+
const orcaCli = require('./orca');
|
|
16
|
+
|
|
17
|
+
const REPO = 'orca-multiagent-kit';
|
|
18
|
+
const RELEASE_BASE = 'https://github.com/FernandoBaqueroo/orca-multiagent-kit';
|
|
19
|
+
// Los ejecutables que publica la release (.github/workflows/release.yml, job exe).
|
|
20
|
+
const EXE_ASSETS = { 'win32-x64': 'omk-windows-x64.exe', 'darwin-arm64': 'omk-macos-arm64', 'linux-x64': 'omk-linux-x64' };
|
|
21
|
+
const EXE_MAX_BYTES = 400 * 1024 * 1024;
|
|
22
|
+
const TEXT_MAX_BYTES = 4096;
|
|
23
|
+
const IDLE_TIMEOUT_MS = 60 * 1000;
|
|
24
|
+
const MAX_REDIRECTS = 5;
|
|
25
|
+
|
|
26
|
+
/** Si la versión `a` es posterior a `b` (x.y.z). */
|
|
27
|
+
function newer(a, b) {
|
|
28
|
+
const x = orcaCli.parseVersion(a);
|
|
29
|
+
const y = orcaCli.parseVersion(b);
|
|
30
|
+
if (!x || !y) return false;
|
|
31
|
+
for (let i = 0; i < 3; i += 1) if (x[i] !== y[i]) return x[i] > y[i];
|
|
32
|
+
return false;
|
|
33
|
+
}
|
|
34
|
+
|
|
35
|
+
/** Cómo llegó esta copia del kit: 'exe' (ejecutable autónomo), 'npm' (bajo node_modules) o 'copy'. */
|
|
36
|
+
function kitSource(kit, standalone) {
|
|
37
|
+
if (standalone) return 'exe';
|
|
38
|
+
return kit.split(/[\\/]/).includes('node_modules') ? 'npm' : 'copy';
|
|
39
|
+
}
|
|
40
|
+
|
|
41
|
+
/** Si el kit corre desde la caché de npx: una copia que npm puede borrar cuando quiera. */
|
|
42
|
+
const isTransientCopy = (kit) => kit.split(/[\\/]/).includes('_npx');
|
|
43
|
+
|
|
44
|
+
// En Windows npm es un .cmd y Node solo lo lanza a través de una shell. Los argumentos son siempre
|
|
45
|
+
// literales de este fichero (o la versión del kit, ya validada), nunca texto de fuera: van en una sola
|
|
46
|
+
// cadena, que es como Node pide llamar a una shell sin que avise de argumentos sin escapar.
|
|
47
|
+
const SAFE_ARG = /^[\w@.\-]+$/;
|
|
48
|
+
function npm(args, options = {}) {
|
|
49
|
+
if (!args.every((arg) => SAFE_ARG.test(arg))) throw new Error(`argumento de npm no admitido: ${args.join(' ')}`);
|
|
50
|
+
return process.platform === 'win32'
|
|
51
|
+
? spawnSync(`npm.cmd ${args.join(' ')}`, { encoding: 'utf8', shell: true, ...options })
|
|
52
|
+
: spawnSync('npm', args, { encoding: 'utf8', ...options });
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
/**
|
|
56
|
+
* Carpetas donde npm puede haber dejado un paquete global, de la más fiable a la menos. Primero las
|
|
57
|
+
* que npm pasa por el entorno a lo que lanza (npx): lo que imprime `npm root -g` no siempre vale,
|
|
58
|
+
* porque npm tapa con «***» los tramos de una ruta que le parecen un secreto (un UUID, por ejemplo).
|
|
59
|
+
*/
|
|
60
|
+
function globalRoots(env = process.env, platform = process.platform) {
|
|
61
|
+
const roots = [];
|
|
62
|
+
for (const prefix of [env.npm_config_global_prefix, env.npm_config_prefix]) {
|
|
63
|
+
if (prefix) roots.push(platform === 'win32' ? path.join(prefix, 'node_modules') : path.join(prefix, 'lib', 'node_modules'));
|
|
64
|
+
}
|
|
65
|
+
const printed = (npm(['root', '-g']).stdout || '').trim();
|
|
66
|
+
if (printed) roots.push(printed);
|
|
67
|
+
return [...new Set(roots)];
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
/**
|
|
71
|
+
* Trae la última versión del paquete de npm. Devuelve `true` si se instaló una nueva (y hay que
|
|
72
|
+
* seguir con el omk nuevo) o `false` si esta ya es la última.
|
|
73
|
+
*/
|
|
74
|
+
function fetchPackage(version, force, say) {
|
|
75
|
+
const latest = (npm(['view', REPO, 'version']).stdout || '').trim();
|
|
76
|
+
if (!latest) throw new Error('no se pudo consultar npm. ¿Hay conexión? Para reaplicar esta versión sin red: omk update --offline');
|
|
77
|
+
if (!force && !newer(latest, version)) {
|
|
78
|
+
say.current(version, newer(version, latest) ? `npm publica la ${latest}; esta copia va por delante` : '');
|
|
79
|
+
return false;
|
|
80
|
+
}
|
|
81
|
+
say.updating(version, latest);
|
|
82
|
+
// Si no se sabe dónde instala npm (ver globalRoots), no se adivina: npm dirá lo suyo si no puede escribir.
|
|
83
|
+
const libdir = globalRoots().find((root) => fs.existsSync(root));
|
|
84
|
+
let writable = true;
|
|
85
|
+
try {
|
|
86
|
+
if (libdir) fs.accessSync(libdir, fs.constants.W_OK);
|
|
87
|
+
if (libdir && fs.existsSync(path.join(libdir, REPO))) fs.accessSync(path.join(libdir, REPO), fs.constants.W_OK);
|
|
88
|
+
} catch {
|
|
89
|
+
// Sin permiso de escritura: se explica abajo cómo arreglarlo.
|
|
90
|
+
writable = false;
|
|
91
|
+
}
|
|
92
|
+
if (!writable) {
|
|
93
|
+
throw new Error(`no tienes permiso para escribir en ${libdir} (instalaste omk con sudo o Node está en una carpeta del sistema).
|
|
94
|
+
|
|
95
|
+
Rápido: sudo npm i -g ${REPO}@latest && omk update --offline
|
|
96
|
+
Recomendado: que npm instale en tu carpeta de usuario, una sola vez:
|
|
97
|
+
mkdir -p ~/.npm-global && npm config set prefix ~/.npm-global
|
|
98
|
+
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
|
|
99
|
+
sudo npm rm -g ${REPO} && npm i -g ${REPO}`);
|
|
100
|
+
}
|
|
101
|
+
const installed = npm(['install', '-g', `${REPO}@latest`], { stdio: 'inherit' });
|
|
102
|
+
if (installed.status !== 0) throw new Error(`no se pudo actualizar con npm. Prueba: npx ${REPO}@latest setup`);
|
|
103
|
+
return true;
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
/** El `bin/omk.js` del paquete instalado en global, o `undefined` si no se encuentra. */
|
|
107
|
+
function globalEntry(roots = globalRoots()) {
|
|
108
|
+
return roots.map((root) => path.join(root, REPO, 'bin', 'omk.js')).find((file) => fs.existsSync(file));
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/**
|
|
112
|
+
* Instala esta versión de omk de forma permanente (`npm install -g`) y devuelve la ruta de su
|
|
113
|
+
* `bin/omk.js`. Para cuando se lanza con npx: el plugin de Orca necesita `omk` en el PATH y una
|
|
114
|
+
* carpeta del kit que no desaparezca.
|
|
115
|
+
*/
|
|
116
|
+
function installGlobal(version) {
|
|
117
|
+
// `version` sale del fichero VERSION del propio kit: solo dígitos y puntos.
|
|
118
|
+
if (!/^\d+\.\d+\.\d+$/.test(version)) throw new Error(`versión del kit no válida: ${version}`);
|
|
119
|
+
const installed = npm(['install', '-g', `${REPO}@${version}`], { stdio: 'inherit' });
|
|
120
|
+
if (installed.status !== 0) throw new Error(`no se pudo instalar omk con npm. Prueba: npm install -g ${REPO} && omk setup`);
|
|
121
|
+
const roots = globalRoots();
|
|
122
|
+
const entry = globalEntry(roots);
|
|
123
|
+
if (!entry) throw new Error(`npm instaló ${REPO}, pero no lo encuentro en ${roots.join(' ni en ') || 'su carpeta global'}. Sigue con: omk setup`);
|
|
124
|
+
return entry;
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
// Solo HTTPS. HTTP se admite únicamente contra esta misma máquina, para las pruebas: OMK_RELEASE_BASE
|
|
128
|
+
// cambia de dónde se descarga, pero no puede apuntar por HTTP a otra máquina.
|
|
129
|
+
function checkedUrl(text) {
|
|
130
|
+
const url = new URL(text);
|
|
131
|
+
const local = url.hostname === '127.0.0.1' || url.hostname === 'localhost';
|
|
132
|
+
if (url.protocol !== 'https:' && !(url.protocol === 'http:' && local)) throw new Error(`no descargo de ${url.protocol}//${url.hostname}: solo HTTPS`);
|
|
133
|
+
return url;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/** Abre `url` y resuelve con la respuesta, siguiendo hasta `redirects` redirecciones a URLs admitidas. */
|
|
137
|
+
function open(urlText, redirects = MAX_REDIRECTS) {
|
|
138
|
+
return new Promise((resolve, reject) => {
|
|
139
|
+
const url = checkedUrl(urlText);
|
|
140
|
+
const req = (url.protocol === 'https:' ? https : http).get(url, { headers: { 'user-agent': 'omk' } }, (res) => {
|
|
141
|
+
const { statusCode = 0, headers } = res;
|
|
142
|
+
if ([301, 302, 303, 307, 308].includes(statusCode) && headers.location) {
|
|
143
|
+
res.resume();
|
|
144
|
+
if (redirects === 0) { reject(new Error(`demasiadas redirecciones al descargar ${url.href}`)); return; }
|
|
145
|
+
resolve({ redirect: new URL(headers.location, url).href, redirects: redirects - 1 });
|
|
146
|
+
return;
|
|
147
|
+
}
|
|
148
|
+
if (statusCode !== 200) { res.resume(); reject(new Error(`${url.href} respondió ${statusCode}`)); return; }
|
|
149
|
+
resolve({ res });
|
|
150
|
+
});
|
|
151
|
+
req.setTimeout(IDLE_TIMEOUT_MS, () => req.destroy(new Error(`sin respuesta de ${url.hostname}`)));
|
|
152
|
+
req.on('error', reject);
|
|
153
|
+
});
|
|
154
|
+
}
|
|
155
|
+
|
|
156
|
+
async function follow(urlText) {
|
|
157
|
+
let next = { redirect: urlText, redirects: MAX_REDIRECTS };
|
|
158
|
+
while (next.redirect) next = await open(next.redirect, next.redirects);
|
|
159
|
+
return next.res;
|
|
160
|
+
}
|
|
161
|
+
|
|
162
|
+
/** La versión de la última release: a dónde redirige `<base>/releases/latest` (…/releases/tag/vX.Y.Z). */
|
|
163
|
+
async function latestRelease(base) {
|
|
164
|
+
const first = await open(`${base}/releases/latest`, MAX_REDIRECTS);
|
|
165
|
+
const tag = /\/releases\/tag\/v(\d+\.\d+\.\d+)$/.exec(first.redirect || '');
|
|
166
|
+
if (first.res) first.res.resume();
|
|
167
|
+
if (!tag) throw new Error('no pude saber cuál es la última release (GitHub no redirigió a su tag)');
|
|
168
|
+
return tag[1];
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
async function fetchText(urlText, maxBytes) {
|
|
172
|
+
const res = await follow(urlText);
|
|
173
|
+
const chunks = [];
|
|
174
|
+
let size = 0;
|
|
175
|
+
for await (const chunk of res) {
|
|
176
|
+
size += chunk.length;
|
|
177
|
+
if (size > maxBytes) { res.destroy(); throw new Error(`${urlText} es más grande de lo esperado`); }
|
|
178
|
+
chunks.push(chunk);
|
|
179
|
+
}
|
|
180
|
+
return Buffer.concat(chunks).toString('utf8');
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/** Descarga `urlText` en `file` (que no debe existir) y devuelve su SHA-256. */
|
|
184
|
+
async function download(urlText, file, maxBytes) {
|
|
185
|
+
const res = await follow(urlText);
|
|
186
|
+
const hash = crypto.createHash('sha256');
|
|
187
|
+
// «wx»: no escribe a través de algo que ya esté ahí.
|
|
188
|
+
const fd = fs.openSync(file, 'wx', 0o755);
|
|
189
|
+
let size = 0;
|
|
190
|
+
try {
|
|
191
|
+
for await (const chunk of res) {
|
|
192
|
+
size += chunk.length;
|
|
193
|
+
if (size > maxBytes) { res.destroy(); throw new Error(`${urlText} es más grande de lo esperado`); }
|
|
194
|
+
hash.update(chunk);
|
|
195
|
+
fs.writeSync(fd, chunk);
|
|
196
|
+
}
|
|
197
|
+
} finally {
|
|
198
|
+
fs.closeSync(fd);
|
|
199
|
+
}
|
|
200
|
+
return hash.digest('hex');
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/**
|
|
204
|
+
* Sustituye el ejecutable `target` por el de la última release si es posterior a `version` (o con
|
|
205
|
+
* `force`). Lo descarga junto a él, comprueba que su SHA-256 es el del `.sha256` publicado y solo
|
|
206
|
+
* entonces lo cambia; si algo falla, `target` queda como estaba. Devuelve la versión instalada, o
|
|
207
|
+
* `null` si ya era la última.
|
|
208
|
+
*/
|
|
209
|
+
async function fetchExecutable({ version, target, force = false, base = process.env.OMK_RELEASE_BASE || RELEASE_BASE, platform = process.platform, arch = process.arch }) {
|
|
210
|
+
const asset = EXE_ASSETS[`${platform}-${arch}`];
|
|
211
|
+
if (!asset) throw new Error(`no hay ejecutable publicado para ${platform}-${arch}: actualiza con npm (npm install -g ${REPO})`);
|
|
212
|
+
const latest = await latestRelease(base);
|
|
213
|
+
if (!force && !newer(latest, version)) return null;
|
|
214
|
+
const from = `${base}/releases/download/v${latest}/${asset}`;
|
|
215
|
+
const expected = /^([0-9a-f]{64})\b/.exec((await fetchText(`${from}.sha256`, TEXT_MAX_BYTES)).trim());
|
|
216
|
+
if (!expected) throw new Error(`la release v${latest} no publica un SHA-256 válido de ${asset}: no lo instalo`);
|
|
217
|
+
const fresh = `${target}.new`;
|
|
218
|
+
fs.rmSync(fresh, { force: true });
|
|
219
|
+
try {
|
|
220
|
+
const actual = await download(from, fresh, EXE_MAX_BYTES);
|
|
221
|
+
if (actual !== expected[1]) throw new Error(`el ${asset} descargado no coincide con su SHA-256 publicado: no lo instalo`);
|
|
222
|
+
if (platform === 'win32') {
|
|
223
|
+
// Windows no deja sobrescribir un ejecutable en marcha, pero sí renombrarlo.
|
|
224
|
+
const old = `${target}.old`;
|
|
225
|
+
fs.rmSync(old, { force: true });
|
|
226
|
+
fs.renameSync(target, old);
|
|
227
|
+
try {
|
|
228
|
+
fs.renameSync(fresh, target);
|
|
229
|
+
} catch (e) {
|
|
230
|
+
fs.renameSync(old, target);
|
|
231
|
+
throw e;
|
|
232
|
+
}
|
|
233
|
+
} else {
|
|
234
|
+
fs.renameSync(fresh, target);
|
|
235
|
+
}
|
|
236
|
+
} catch (e) {
|
|
237
|
+
fs.rmSync(fresh, { force: true });
|
|
238
|
+
throw e;
|
|
239
|
+
}
|
|
240
|
+
return latest;
|
|
241
|
+
}
|
|
242
|
+
|
|
243
|
+
module.exports = { REPO, RELEASE_BASE, newer, kitSource, isTransientCopy, globalRoots, globalEntry, fetchPackage, installGlobal, fetchExecutable };
|