orca-multiagent-kit 1.5.0 → 1.6.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/CHANGELOG.md +30 -1
- package/README.md +2 -1
- package/VERSION +1 -1
- package/bin/omk.js +7 -0
- package/bin/team.js +353 -0
- package/core/AGENTS.md +1 -1
- package/docs/PLUGIN-ORCA.md +107 -18
- package/orca-plugin/README.md +5 -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 +456 -9
- package/orca-plugin/src/kit.ts +626 -21
- 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 +28 -0
- package/orca-plugin/src/panel.test.tsx +228 -30
- package/orca-plugin/src/panel.tsx +482 -78
- 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 +166 -5
- package/orca-plugin/src/tabs/autonomy.tsx +70 -0
- package/orca-plugin/src/tabs/history.test.tsx +78 -0
- package/orca-plugin/src/tabs/history.tsx +118 -0
- package/orca-plugin/src/tabs/notices.test.tsx +183 -0
- package/orca-plugin/src/tabs/notices.tsx +274 -0
- package/orca-plugin/src/tabs/worktrees.test.tsx +130 -0
- package/orca-plugin/src/tabs/worktrees.tsx +138 -0
- package/orca-plugin/src/ui/agent-icon.tsx +13 -0
- package/orca-plugin/src/worker/context.test.ts +32 -0
- package/orca-plugin/src/worker/context.ts +92 -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 +291 -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 +265 -22
- package/orca-plugin/src/worker.ts +318 -34
- package/package.json +2 -2
- package/skills/orca/SKILL.md +1 -0
- package/skills/orca/references/engine-orca.md +1 -0
- package/skills/orca/references/olimpo.md +1 -0
- package/skills/orca/references/plan-card.md +45 -0
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +5,34 @@ 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.6.0] - 2026-11-12
|
|
9
|
+
|
|
10
|
+
### Añadido
|
|
11
|
+
- **`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`.
|
|
12
|
+
- **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).
|
|
13
|
+
- Panel del plugin en pestañas *Agentes*, *Repartir*, *Equipo* y *Kit*.
|
|
14
|
+
- *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.
|
|
15
|
+
- *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.
|
|
16
|
+
- *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`.
|
|
17
|
+
- Los agentes (inicializar, coordinador, proveedores) se eligen de una lista con el catálogo de Orca, no se escriben.
|
|
18
|
+
- 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.
|
|
19
|
+
- **Plugin v0.6.0**: pestañas *Avisos*, *Worktrees* e *Historial*, iconos de agente y autonomía.
|
|
20
|
+
- *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`.
|
|
21
|
+
- 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.
|
|
22
|
+
- *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.
|
|
23
|
+
- *Historial*: despachos, bloqueos, finales de unidad, runs terminados y lo que haces desde el panel; las 200 últimas entradas, guardadas en el plugin.
|
|
24
|
+
- 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.
|
|
25
|
+
- Autonomía: en *Equipo*, la del proyecto (`ORCHESTRATION.md` §0); en *Repartir*, otra solo para ese run.
|
|
26
|
+
- **`omk team set --autonomy manual|semi|auto`**: cambia la línea `- Nivel:` de `ORCHESTRATION.md` §0; `omk team` la enseña.
|
|
27
|
+
|
|
28
|
+
### Corregido
|
|
29
|
+
- 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.
|
|
30
|
+
- 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:…`).
|
|
31
|
+
|
|
32
|
+
### Cambiado
|
|
33
|
+
- 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`).
|
|
34
|
+
- La v0.6.0 del plugin pide además `storage:own` (historial) y observa `agent.tool.after` (tarjeta del plan): otra aprobación.
|
|
35
|
+
|
|
8
36
|
## [1.5.0] - 2026-11-11
|
|
9
37
|
|
|
10
38
|
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 +170,8 @@ Primera versión de **Orca Multiagent Kit**. Une CSR (Claude Session Rules, de [
|
|
|
142
170
|
### Eliminado
|
|
143
171
|
- Copias duplicadas de reglas y skills `csr-*` dentro de cada agente, y el plugin `claude-session-rules` de Antigravity.
|
|
144
172
|
|
|
145
|
-
[Unreleased]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.
|
|
173
|
+
[Unreleased]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.6.0...HEAD
|
|
174
|
+
[1.6.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.5.0...v1.6.0
|
|
146
175
|
[1.5.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.4.1...v1.5.0
|
|
147
176
|
[1.4.1]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.4.0...v1.4.1
|
|
148
177
|
[1.4.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.3.0...v1.4.0
|
package/README.md
CHANGED
|
@@ -107,6 +107,7 @@ Requisitos: macOS, Linux, WSL o Git Bash, con bash ≥ 3.2.
|
|
|
107
107
|
| `omk setup [--yes] [--dry-run]` | Prepara Orca entero: kit, plugins encendidos, plugin del kit y su panel |
|
|
108
108
|
| `omk install [--agents a,b] [--dry-run]` | Instala o migra la fuente única para los agentes detectados |
|
|
109
109
|
| `omk plugin install\|status\|uninstall` | El plugin de Orca del kit; `install` pide tu aprobación (o `--yes`) |
|
|
110
|
+
| `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
111
|
| `omk init [ruta]` | Prepara un proyecto (por defecto, la carpeta actual) |
|
|
111
112
|
| `omk verify` | Comprueba enlaces, imports y que no queden copias divergentes |
|
|
112
113
|
| `omk adopt <carpeta-skill>` | Comparte una skill externa (p. ej. impeccable) con todos los agentes |
|
|
@@ -151,7 +152,7 @@ Solo tienes que conocer dos frases. El resto lo deciden los agentes.
|
|
|
151
152
|
|
|
152
153
|
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
154
|
|
|
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).
|
|
155
|
+
**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 enseña 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
156
|
|
|
156
157
|
<a id="flujo"></a>
|
|
157
158
|
## <img src="assets/icons/flow.svg" width="22" height="22" alt=""> Flujo de trabajo
|
package/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.6.0
|
package/bin/omk.js
CHANGED
|
@@ -32,6 +32,7 @@ ${bold('Comandos')}
|
|
|
32
32
|
${lime('init')} [ruta] Prepara un proyecto (por defecto, la carpeta actual)
|
|
33
33
|
${lime('verify')} Comprueba enlaces, imports y copias divergentes
|
|
34
34
|
${lime('plugin')} install|status|uninstall El plugin de Orca del kit (install pide tu aprobación)
|
|
35
|
+
${lime('team')} [set …] Enseña o cambia el equipo de roles y la autonomía de ORCHESTRATION.md
|
|
35
36
|
${lime('adopt')} <carpeta-skill> Comparte una skill externa con todos los agentes
|
|
36
37
|
${lime('backups')} Lista las copias de seguridad
|
|
37
38
|
${lime('restore')} <fecha> Deshace una instalación (fecha de "omk backups")
|
|
@@ -47,6 +48,7 @@ ${bold('Ejemplos')}
|
|
|
47
48
|
npx orca-multiagent-kit install --dry-run
|
|
48
49
|
omk install
|
|
49
50
|
omk init ~/Dev/mi-app
|
|
51
|
+
omk team set --provider claude --provider codex --role casandra=codex
|
|
50
52
|
omk adopt ~/.gemini/config/plugins/user-workflows/skills/impeccable
|
|
51
53
|
`;
|
|
52
54
|
|
|
@@ -117,6 +119,11 @@ switch (cmd) {
|
|
|
117
119
|
finish(require('./setup').plugin({ kit: KIT, args: rest }));
|
|
118
120
|
break;
|
|
119
121
|
|
|
122
|
+
case 'team':
|
|
123
|
+
// exitCode y no exit(): deja terminar de escribir la salida cuando va a una tubería.
|
|
124
|
+
process.exitCode = require('./team').main(rest);
|
|
125
|
+
break;
|
|
126
|
+
|
|
120
127
|
case 'install':
|
|
121
128
|
case 'i':
|
|
122
129
|
runInstaller(rest);
|
package/bin/team.js
ADDED
|
@@ -0,0 +1,353 @@
|
|
|
1
|
+
// omk team: el equipo de roles del proyecto en ORCHESTRATION.md §1 (proveedores activos, revisión
|
|
2
|
+
// cruzada, las filas «Rol <nombre>» de la tabla de excepciones y los roles propios del proyecto) y
|
|
3
|
+
// el nivel de autonomía de §0. El panel Equipo del plugin lo usa con --data y --autonomy.
|
|
4
|
+
'use strict';
|
|
5
|
+
|
|
6
|
+
const fs = require('node:fs');
|
|
7
|
+
const path = require('node:path');
|
|
8
|
+
|
|
9
|
+
/** Roles de Olimpo que se fijan a un proveedor (skills/orca/references/olimpo.md); Hefesto coordina. */
|
|
10
|
+
const ROLES = [
|
|
11
|
+
['dedalo', 'Dédalo'], ['casandra', 'Casandra'], ['temis', 'Temis'], ['ariadna', 'Ariadna'],
|
|
12
|
+
['persefone', 'Perséfone'], ['proteo', 'Proteo'], ['narciso', 'Narciso'], ['icaro', 'Ícaro'],
|
|
13
|
+
['argos', 'Argos'], ['atlas', 'Atlas'], ['clio', 'Clío'],
|
|
14
|
+
];
|
|
15
|
+
const ROLE_NAME = new Map(ROLES);
|
|
16
|
+
const RESERVED = new Set(['Hefesto', ...ROLE_NAME.values()].map((name) => name.toLocaleLowerCase('es')));
|
|
17
|
+
const CROSS = { sensibles: 'unidades L y sensibles', todas: 'todas', nunca: 'nunca' };
|
|
18
|
+
const LEVELS = ['alto', 'medio', 'bajo'];
|
|
19
|
+
const AUTONOMY = ['manual', 'semi', 'auto'];
|
|
20
|
+
// Columna «Revisión» de los roles propios, como la escribe olimpo.md.
|
|
21
|
+
const REVIEW = { propia: 'propia', cross: '`cross`', argos: 'Argos', casandra: 'Casandra' };
|
|
22
|
+
const AGENT_ID = /^[a-z0-9][a-z0-9-]{0,39}$/;
|
|
23
|
+
const CUSTOM_NAME = /^\p{L}[\p{L}\p{M}\p{N} -]{0,29}$/u;
|
|
24
|
+
const MAX_PROVIDERS = 8;
|
|
25
|
+
const MAX_CUSTOM = 10;
|
|
26
|
+
const WORK_MAX = 80;
|
|
27
|
+
const GUARD_MAX = 120;
|
|
28
|
+
// Las filas que escribe omk team: las demás son del usuario y no se tocan.
|
|
29
|
+
const MARK = 'equipo (omk team)';
|
|
30
|
+
const CUSTOM_MARK = '<!-- omk team -->';
|
|
31
|
+
|
|
32
|
+
const PROVIDERS_LINE = /^(\s*- Proveedores activos:)[ \t]*(.*?)([ \t]*<!--.*-->)?[ \t]*$/;
|
|
33
|
+
const CROSS_LINE = /^(\s*- Revisión cruzada[^:]*:)[ \t]*(.*?)[ \t]*$/;
|
|
34
|
+
const EXCEPTIONS_LINE = /^\s*- Excepciones al reparto/;
|
|
35
|
+
const CUSTOM_LINE = /^\s*- Roles propios del proyecto/;
|
|
36
|
+
const TABLE_LINE = /^\s*\|/;
|
|
37
|
+
const AUTONOMY_HEADING = /^##\s*0\.\s*Autonom/;
|
|
38
|
+
const AUTONOMY_LINE = /^(\s*- Nivel:)[ \t]*(.*?)([ \t]*<!--.*-->)?[ \t]*$/;
|
|
39
|
+
|
|
40
|
+
const HELP = `Uso:
|
|
41
|
+
omk team [show] [--file ruta] Enseña el equipo de ORCHESTRATION.md
|
|
42
|
+
omk team set [opciones] Lo cambia
|
|
43
|
+
--provider <id> Proveedor activo (repetible; sustituye la lista)
|
|
44
|
+
--cross sensibles|todas|nunca Qué unidades revisa otro proveedor
|
|
45
|
+
--role <rol>=<id>|auto Fija el proveedor de un rol (repetible); auto lo quita
|
|
46
|
+
--reset-roles Quita antes los roles fijados por omk team
|
|
47
|
+
--autonomy manual|semi|auto Cuántas confirmaciones pide la skill orca (§0)
|
|
48
|
+
--data <base64url> El equipo entero en JSON (lo usa el panel del plugin);
|
|
49
|
+
sustituye proveedores, revisión, roles fijados y roles propios
|
|
50
|
+
--file <ruta> Otro ORCHESTRATION.md (por defecto, el de la carpeta actual)
|
|
51
|
+
Roles: ${ROLES.map(([id]) => id).join(', ')}`;
|
|
52
|
+
|
|
53
|
+
class TeamError extends Error {}
|
|
54
|
+
|
|
55
|
+
/** Texto de una celda de tabla: una línea, sin `|`, `<`, `>` ni caracteres de control o formato. */
|
|
56
|
+
function cellText(value, max, field) {
|
|
57
|
+
if (typeof value !== 'string') throw new TeamError(`--data: ${field} no es texto`);
|
|
58
|
+
const clean = value.replace(/[|<>\p{Cc}\p{Cf}]+/gu, ' ').replace(/\s+/g, ' ').trim();
|
|
59
|
+
if (clean.length > max) throw new TeamError(`--data: ${field} pasa de ${max} caracteres`);
|
|
60
|
+
return clean;
|
|
61
|
+
}
|
|
62
|
+
|
|
63
|
+
/** El equipo que manda el panel, validado entero; nada que no encaje llega al fichero. */
|
|
64
|
+
function parseData(encoded) {
|
|
65
|
+
if (!/^[A-Za-z0-9_-]{1,8000}$/.test(encoded)) throw new TeamError('--data no es base64url');
|
|
66
|
+
let data;
|
|
67
|
+
try {
|
|
68
|
+
data = JSON.parse(Buffer.from(encoded, 'base64url').toString('utf8'));
|
|
69
|
+
} catch (e) {
|
|
70
|
+
throw new TeamError(`--data no es un equipo en JSON: ${e.message}`);
|
|
71
|
+
}
|
|
72
|
+
if (!data || typeof data !== 'object' || data.v !== 1) throw new TeamError('--data: versión de equipo desconocida');
|
|
73
|
+
const { providers, cross, roles, custom } = data;
|
|
74
|
+
if (!Array.isArray(providers) || !providers.length || providers.length > MAX_PROVIDERS
|
|
75
|
+
|| !providers.every((id) => typeof id === 'string' && AGENT_ID.test(id)) || new Set(providers).size !== providers.length) {
|
|
76
|
+
throw new TeamError('--data: proveedores no válidos');
|
|
77
|
+
}
|
|
78
|
+
if (!Object.hasOwn(CROSS, cross)) throw new TeamError('--data: revisión cruzada no válida');
|
|
79
|
+
if (!roles || typeof roles !== 'object' || Array.isArray(roles)) throw new TeamError('--data: roles no válidos');
|
|
80
|
+
const fixed = new Map();
|
|
81
|
+
for (const [role, provider] of Object.entries(roles)) {
|
|
82
|
+
if (!ROLE_NAME.has(role) || !providers.includes(provider)) throw new TeamError(`--data: rol no válido: ${role}`);
|
|
83
|
+
fixed.set(role, provider);
|
|
84
|
+
}
|
|
85
|
+
if (!Array.isArray(custom) || custom.length > MAX_CUSTOM) throw new TeamError('--data: roles propios no válidos');
|
|
86
|
+
const names = new Set();
|
|
87
|
+
const own = custom.map((role, i) => {
|
|
88
|
+
const field = (name) => `rol propio ${i + 1}: ${name}`;
|
|
89
|
+
if (!role || typeof role !== 'object') throw new TeamError(`--data: ${field('no es un objeto')}`);
|
|
90
|
+
const name = typeof role.name === 'string' ? role.name.trim() : '';
|
|
91
|
+
const key = name.toLocaleLowerCase('es');
|
|
92
|
+
if (!CUSTOM_NAME.test(name) || RESERVED.has(key) || names.has(key)) throw new TeamError(`--data: ${field('nombre no válido o repetido')}`);
|
|
93
|
+
names.add(key);
|
|
94
|
+
const work = cellText(role.work, WORK_MAX, field('qué hace'));
|
|
95
|
+
if (!work) throw new TeamError(`--data: ${field('falta qué hace')}`);
|
|
96
|
+
if (!LEVELS.includes(role.level)) throw new TeamError(`--data: ${field('nivel no válido')}`);
|
|
97
|
+
if (!Object.hasOwn(REVIEW, role.review)) throw new TeamError(`--data: ${field('revisión no válida')}`);
|
|
98
|
+
if (role.provider !== null && !providers.includes(role.provider)) throw new TeamError(`--data: ${field('proveedor no activo')}`);
|
|
99
|
+
return { name, work, level: role.level, review: role.review, guard: cellText(role.guard, GUARD_MAX, field('guardarraíl')), provider: role.provider };
|
|
100
|
+
});
|
|
101
|
+
return { providers, cross, roles: fixed, custom: own };
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
function parseArgs(args) {
|
|
105
|
+
const [first, ...rest] = args;
|
|
106
|
+
const action = first === 'set' ? 'set' : 'show';
|
|
107
|
+
const opts = { action, file: null, providers: [], cross: null, roles: new Map(), resetRoles: false, custom: null, autonomy: null };
|
|
108
|
+
const list = first === 'set' || first === 'show' ? rest : args;
|
|
109
|
+
for (let i = 0; i < list.length; i += 1) {
|
|
110
|
+
const arg = list[i];
|
|
111
|
+
const value = () => {
|
|
112
|
+
const next = list[i + 1];
|
|
113
|
+
if (next === undefined || next.startsWith('--')) throw new TeamError(`falta el valor de ${arg}`);
|
|
114
|
+
i += 1;
|
|
115
|
+
return next;
|
|
116
|
+
};
|
|
117
|
+
if (arg === '--file') opts.file = value();
|
|
118
|
+
else if (action === 'show') throw new TeamError(`opción desconocida para omk team: ${arg}\n${HELP}`);
|
|
119
|
+
else if (arg === '--reset-roles') opts.resetRoles = true;
|
|
120
|
+
else if (arg === '--data') {
|
|
121
|
+
const data = parseData(value());
|
|
122
|
+
opts.providers = data.providers;
|
|
123
|
+
opts.cross = data.cross;
|
|
124
|
+
opts.roles = data.roles;
|
|
125
|
+
opts.resetRoles = true;
|
|
126
|
+
opts.custom = data.custom;
|
|
127
|
+
} else if (arg === '--provider') {
|
|
128
|
+
const id = value();
|
|
129
|
+
if (!AGENT_ID.test(id)) throw new TeamError(`«${id}» no es un id de agente (minúsculas, números y guiones)`);
|
|
130
|
+
if (!opts.providers.includes(id)) opts.providers.push(id);
|
|
131
|
+
} else if (arg === '--cross') {
|
|
132
|
+
const mode = value();
|
|
133
|
+
if (!Object.hasOwn(CROSS, mode)) throw new TeamError(`--cross admite sensibles, todas o nunca, no «${mode}»`);
|
|
134
|
+
opts.cross = mode;
|
|
135
|
+
} else if (arg === '--autonomy') {
|
|
136
|
+
const level = value();
|
|
137
|
+
if (!AUTONOMY.includes(level)) throw new TeamError(`--autonomy admite manual, semi o auto, no «${level}»`);
|
|
138
|
+
opts.autonomy = level;
|
|
139
|
+
} else if (arg === '--role') {
|
|
140
|
+
const [role, provider, extra] = value().split('=');
|
|
141
|
+
if (!ROLE_NAME.has(role)) throw new TeamError(`rol desconocido: «${role}». Roles: ${ROLES.map(([id]) => id).join(', ')}`);
|
|
142
|
+
if (extra !== undefined || provider === undefined || (provider !== 'auto' && !AGENT_ID.test(provider))) {
|
|
143
|
+
throw new TeamError('--role espera <rol>=<id de agente> o <rol>=auto');
|
|
144
|
+
}
|
|
145
|
+
opts.roles.set(role, provider);
|
|
146
|
+
} else throw new TeamError(`opción desconocida: ${arg}\n${HELP}`);
|
|
147
|
+
}
|
|
148
|
+
if (action === 'set' && !opts.providers.length && !opts.cross && !opts.roles.size && !opts.resetRoles && !opts.autonomy) {
|
|
149
|
+
throw new TeamError(`omk team set sin cambios\n${HELP}`);
|
|
150
|
+
}
|
|
151
|
+
return opts;
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
const cells = (line) => line.replace(CUSTOM_MARK, '').trim().replace(/^\||\|$/g, '').split('|').map((cell) => cell.trim());
|
|
155
|
+
const isEmptyRow = (line) => cells(line).every((cell) => cell === '');
|
|
156
|
+
|
|
157
|
+
/** La tabla que sigue a la línea `heading` de §1: índices de su primera fila de datos y de su final. */
|
|
158
|
+
function tableAfter(lines, heading) {
|
|
159
|
+
const start = lines.findIndex((line) => heading.test(line));
|
|
160
|
+
if (start === -1) return null;
|
|
161
|
+
let end = start + 1;
|
|
162
|
+
while (end < lines.length && TABLE_LINE.test(lines[end])) end += 1;
|
|
163
|
+
// Cabecera y separador: las filas empiezan detrás.
|
|
164
|
+
if (end - start - 1 < 2) return null;
|
|
165
|
+
return { rows: start + 3, end, indent: lines[start + 1].match(/^\s*/)[0], columns: cells(lines[start + 1]).length };
|
|
166
|
+
}
|
|
167
|
+
|
|
168
|
+
/** Una fila de excepción escrita por omk team: «Rol X | X / proveedor | equipo (omk team)». */
|
|
169
|
+
function managedRow(line) {
|
|
170
|
+
const [rol, fixed, reason] = cells(line);
|
|
171
|
+
if (reason !== MARK || !rol || !fixed) return null;
|
|
172
|
+
const [name, provider] = fixed.split('/').map((part) => part.trim());
|
|
173
|
+
return name && provider ? { name, provider } : null;
|
|
174
|
+
}
|
|
175
|
+
|
|
176
|
+
const isCustomRow = (line) => line.includes(CUSTOM_MARK);
|
|
177
|
+
|
|
178
|
+
function customRow(line) {
|
|
179
|
+
const [name, work, level, review, guard = ''] = cells(line);
|
|
180
|
+
return { name: name.replace(/^\*\*|\*\*$/g, ''), work, level, review, guard };
|
|
181
|
+
}
|
|
182
|
+
|
|
183
|
+
/** Índice de la línea «- Nivel:» de §0 Autonomía, o -1: solo cuenta la de esa sección. */
|
|
184
|
+
function autonomyLine(lines) {
|
|
185
|
+
const heading = lines.findIndex((line) => AUTONOMY_HEADING.test(line));
|
|
186
|
+
if (heading === -1) return -1;
|
|
187
|
+
for (let i = heading + 1; i < lines.length && !/^##\s/.test(lines[i]); i += 1) {
|
|
188
|
+
if (AUTONOMY_LINE.test(lines[i])) return i;
|
|
189
|
+
}
|
|
190
|
+
return -1;
|
|
191
|
+
}
|
|
192
|
+
|
|
193
|
+
/** Lo que dice ORCHESTRATION.md del equipo; `null` en lo que no encuentra. */
|
|
194
|
+
function readTeam(text) {
|
|
195
|
+
const lines = text.split(/\r?\n/);
|
|
196
|
+
const autonomyAt = autonomyLine(lines);
|
|
197
|
+
const providersLine = lines.find((line) => PROVIDERS_LINE.test(line));
|
|
198
|
+
const crossLine = lines.find((line) => CROSS_LINE.test(line));
|
|
199
|
+
const exceptions = tableAfter(lines, EXCEPTIONS_LINE);
|
|
200
|
+
const rows = exceptions ? lines.slice(exceptions.rows, exceptions.end) : [];
|
|
201
|
+
const fixed = rows.map(managedRow).filter(Boolean);
|
|
202
|
+
const customTable = tableAfter(lines, CUSTOM_LINE);
|
|
203
|
+
const custom = customTable ? lines.slice(customTable.rows, customTable.end).filter(isCustomRow).map(customRow) : [];
|
|
204
|
+
return {
|
|
205
|
+
autonomy: autonomyAt === -1 ? null : lines[autonomyAt].match(AUTONOMY_LINE)[2],
|
|
206
|
+
providers: providersLine
|
|
207
|
+
? providersLine.match(PROVIDERS_LINE)[2].split(/[\s,]+/).filter((id) => id !== '')
|
|
208
|
+
: null,
|
|
209
|
+
cross: crossLine ? crossLine.match(CROSS_LINE)[2] : null,
|
|
210
|
+
roles: fixed
|
|
211
|
+
.map(({ name, provider }) => ({ id: ROLES.find(([, roleName]) => roleName === name)?.[0], provider }))
|
|
212
|
+
.filter(({ id }) => id),
|
|
213
|
+
custom: custom.map((role) => ({ ...role, provider: fixed.find(({ name }) => name === role.name)?.provider ?? null })),
|
|
214
|
+
others: rows.filter((line) => !managedRow(line) && !isEmptyRow(line)).length,
|
|
215
|
+
hasTable: exceptions !== null,
|
|
216
|
+
hasCustomTable: customTable !== null,
|
|
217
|
+
};
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
/** Sustituye las filas de una tabla por `rows`, o deja la fila vacía de la plantilla si no hay ninguna. */
|
|
221
|
+
function replaceRows(lines, table, rows) {
|
|
222
|
+
const empty = `${table.indent}|${' |'.repeat(table.columns)}`;
|
|
223
|
+
lines.splice(table.rows, table.end - table.rows, ...(rows.length ? rows : [empty]));
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
/** El texto con los cambios de `opts` aplicados; mismo final de línea que el original. */
|
|
227
|
+
function applyTeam(text, opts) {
|
|
228
|
+
const eol = text.includes('\r\n') ? '\r\n' : '\n';
|
|
229
|
+
const lines = text.split(/\r?\n/);
|
|
230
|
+
const current = readTeam(text);
|
|
231
|
+
|
|
232
|
+
if (opts.autonomy) {
|
|
233
|
+
const at = autonomyLine(lines);
|
|
234
|
+
if (at === -1) throw new TeamError('ORCHESTRATION.md no tiene la línea «- Nivel:» de §0 Autonomía (regenérala con kit-init)');
|
|
235
|
+
const [, label, , comment = ''] = lines[at].match(AUTONOMY_LINE);
|
|
236
|
+
lines[at] = `${label} ${opts.autonomy}${comment}`;
|
|
237
|
+
}
|
|
238
|
+
if (opts.providers.length) {
|
|
239
|
+
const at = lines.findIndex((line) => PROVIDERS_LINE.test(line));
|
|
240
|
+
if (at === -1) throw new TeamError('ORCHESTRATION.md no tiene la línea «- Proveedores activos:» de §1 (regenérala con kit-init)');
|
|
241
|
+
const [, label, , comment = ''] = lines[at].match(PROVIDERS_LINE);
|
|
242
|
+
lines[at] = `${label} ${opts.providers.join(', ')}${comment}`;
|
|
243
|
+
}
|
|
244
|
+
if (opts.cross) {
|
|
245
|
+
const at = lines.findIndex((line) => CROSS_LINE.test(line));
|
|
246
|
+
if (at === -1) throw new TeamError('ORCHESTRATION.md no tiene la línea «- Revisión cruzada …:» de §1 (regenérala con kit-init)');
|
|
247
|
+
lines[at] = `${lines[at].match(CROSS_LINE)[1]} ${CROSS[opts.cross]}`;
|
|
248
|
+
}
|
|
249
|
+
|
|
250
|
+
const active = opts.providers.length ? opts.providers : current.providers;
|
|
251
|
+
for (const [role, provider] of opts.roles) {
|
|
252
|
+
if (provider !== 'auto' && active && !active.includes(provider)) {
|
|
253
|
+
throw new TeamError(`${ROLE_NAME.get(role)}: «${provider}» no está entre los proveedores activos (${active.join(', ')})`);
|
|
254
|
+
}
|
|
255
|
+
}
|
|
256
|
+
|
|
257
|
+
// Roles propios: la tabla de §1 y, para los que llevan proveedor, su fila de excepción.
|
|
258
|
+
let custom = current.custom.map(({ name, provider }) => ({ name, provider }));
|
|
259
|
+
if (opts.custom) {
|
|
260
|
+
const table = tableAfter(lines, CUSTOM_LINE);
|
|
261
|
+
if (!table) throw new TeamError('ORCHESTRATION.md no tiene la tabla «Roles propios del proyecto» de §1 (regenérala con kit-init)');
|
|
262
|
+
const own = lines.slice(table.rows, table.end).filter((line) => !isCustomRow(line) && !isEmptyRow(line));
|
|
263
|
+
const rows = opts.custom.map(({ name, work, level, review, guard }) =>
|
|
264
|
+
`${table.indent}| **${name}** | ${work} | ${level} | ${REVIEW[review]} | ${guard} | ${CUSTOM_MARK}`);
|
|
265
|
+
replaceRows(lines, table, [...own, ...rows]);
|
|
266
|
+
custom = opts.custom;
|
|
267
|
+
}
|
|
268
|
+
|
|
269
|
+
if (opts.roles.size || opts.resetRoles || opts.custom) {
|
|
270
|
+
const table = tableAfter(lines, EXCEPTIONS_LINE);
|
|
271
|
+
if (!table) throw new TeamError('ORCHESTRATION.md no tiene la tabla «Excepciones al reparto por roles» de §1 (regenérala con kit-init)');
|
|
272
|
+
const fixed = new Map(opts.resetRoles ? [] : current.roles.map(({ id, provider }) => [id, provider]));
|
|
273
|
+
for (const [role, provider] of opts.roles) {
|
|
274
|
+
if (provider === 'auto') fixed.delete(role);
|
|
275
|
+
else fixed.set(role, provider);
|
|
276
|
+
}
|
|
277
|
+
// Las excepciones del usuario se quedan; las de omk team se reescriben: Olimpo y luego los propios.
|
|
278
|
+
const own = lines.slice(table.rows, table.end).filter((line) => !managedRow(line) && !isEmptyRow(line));
|
|
279
|
+
const row = (name, provider) => `${table.indent}| Rol ${name} | ${name} / ${provider} | ${MARK} |`;
|
|
280
|
+
const team = [
|
|
281
|
+
...ROLES.filter(([id]) => fixed.has(id)).map(([id, name]) => row(name, fixed.get(id))),
|
|
282
|
+
...custom.filter(({ provider }) => provider).map(({ name, provider }) => row(name, provider)),
|
|
283
|
+
];
|
|
284
|
+
replaceRows(lines, table, [...own, ...team]);
|
|
285
|
+
}
|
|
286
|
+
return lines.join(eol);
|
|
287
|
+
}
|
|
288
|
+
|
|
289
|
+
function describe(file, team) {
|
|
290
|
+
const pad = (label) => ` ${label.padEnd(21)}`;
|
|
291
|
+
const out = [`Equipo de ${file}`];
|
|
292
|
+
const autonomy = team.autonomy === null ? 'sin línea en §0'
|
|
293
|
+
: AUTONOMY.includes(team.autonomy) ? team.autonomy : `no válida (${team.autonomy})`;
|
|
294
|
+
out.push(`${pad('Autonomía')}${autonomy}`);
|
|
295
|
+
out.push(`${pad('Proveedores activos')}${team.providers?.length ? team.providers.join(', ') : 'sin línea en §1'}`);
|
|
296
|
+
const cross = team.cross === null ? 'sin línea en §1' : team.cross.includes('|') ? `sin elegir (${team.cross})` : team.cross;
|
|
297
|
+
out.push(`${pad('Revisión cruzada')}${cross}`);
|
|
298
|
+
if (!team.hasTable) out.push(`${pad('Roles fijados')}sin tabla de excepciones en §1`);
|
|
299
|
+
else if (!team.roles.length) out.push(`${pad('Roles fijados')}ninguno: todos los elige el coordinador (olimpo.md)`);
|
|
300
|
+
else {
|
|
301
|
+
const names = team.roles.map(({ id, provider }) => `${ROLE_NAME.get(id)} → ${provider}`).join(', ');
|
|
302
|
+
out.push(`${pad('Roles fijados')}${names}`);
|
|
303
|
+
out.push(`${pad('')}los demás los elige el coordinador (olimpo.md)`);
|
|
304
|
+
}
|
|
305
|
+
if (team.custom.length) {
|
|
306
|
+
team.custom.forEach(({ name, work, level, provider }, i) => {
|
|
307
|
+
out.push(`${pad(i === 0 ? 'Roles propios' : '')}${name} (${level}): ${work}${provider ? ` → ${provider}` : ''}`);
|
|
308
|
+
});
|
|
309
|
+
} else if (team.hasCustomTable) out.push(`${pad('Roles propios')}ninguno de omk team`);
|
|
310
|
+
if (team.others) out.push(`${pad('Otras excepciones')}${team.others} (tuyas; omk team no las toca)`);
|
|
311
|
+
return out.join('\n');
|
|
312
|
+
}
|
|
313
|
+
|
|
314
|
+
/** omk team: devuelve el código de salida. */
|
|
315
|
+
function main(args, { cwd = process.cwd(), out = console.log, err = console.error } = {}) {
|
|
316
|
+
try {
|
|
317
|
+
if (args[0] === 'help' || args.includes('--help') || args.includes('-h')) {
|
|
318
|
+
out(HELP);
|
|
319
|
+
return 0;
|
|
320
|
+
}
|
|
321
|
+
const opts = parseArgs(args);
|
|
322
|
+
const file = path.resolve(cwd, opts.file || 'ORCHESTRATION.md');
|
|
323
|
+
if (!fs.existsSync(file)) {
|
|
324
|
+
throw new TeamError(`no hay ${path.basename(file)} en ${path.dirname(file)}: prepara el proyecto con «inicializa el proyecto» (kit-init) u «omk init»`);
|
|
325
|
+
}
|
|
326
|
+
const text = fs.readFileSync(file, 'utf8');
|
|
327
|
+
if (opts.action === 'set') {
|
|
328
|
+
const next = applyTeam(text, opts);
|
|
329
|
+
if (next !== text) {
|
|
330
|
+
// Escritura atómica: un corte a medias no deja ORCHESTRATION.md truncado.
|
|
331
|
+
const tmp = `${file}.omk-${process.pid}.tmp`;
|
|
332
|
+
fs.writeFileSync(tmp, next);
|
|
333
|
+
try {
|
|
334
|
+
fs.renameSync(tmp, file);
|
|
335
|
+
} catch (e) {
|
|
336
|
+
fs.rmSync(tmp, { force: true });
|
|
337
|
+
throw e;
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
out(next === text ? 'Sin cambios: el equipo ya era ese.' : 'Equipo guardado.');
|
|
341
|
+
out(describe(file, readTeam(next)));
|
|
342
|
+
return 0;
|
|
343
|
+
}
|
|
344
|
+
out(describe(file, readTeam(text)));
|
|
345
|
+
return 0;
|
|
346
|
+
} catch (e) {
|
|
347
|
+
// 2: lo pedido no vale; 1: no se pudo leer o escribir el fichero.
|
|
348
|
+
err(`omk team: ${e.message}`);
|
|
349
|
+
return e instanceof TeamError ? 2 : 1;
|
|
350
|
+
}
|
|
351
|
+
}
|
|
352
|
+
|
|
353
|
+
module.exports = { main, parseArgs, readTeam, applyTeam, ROLES, MARK };
|
package/core/AGENTS.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# Reglas operativas globales (Orca Multiagent Kit v1.
|
|
1
|
+
# Reglas operativas globales (Orca Multiagent Kit v1.6.0 · CSR + MAW)
|
|
2
2
|
<!-- Fuente única para todos los agentes (import o enlace). Edita el kit y reinstala; no edites copias. -->
|
|
3
3
|
|
|
4
4
|
## 0. Precedencia
|