orca-multiagent-kit 1.4.0 → 1.5.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 CHANGED
@@ -5,6 +5,25 @@ 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.5.0] - 2026-11-11
9
+
10
+ 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).
11
+
12
+ ### Añadido
13
+ - **`omk setup`**: instala el kit, abre Orca si hace falta, enciende los plugins, instala (o actualiza, o aprueba) el plugin del kit y abre su panel. Enseña lo que pide el plugin y pregunta antes de aprobarlo; `--yes` lo aprueba de antemano, `--dry-run` simula, `--no-plugin` solo instala el kit.
14
+ - **`omk plugin install|status|uninstall`**: el plugin de Orca sin copiar comandos de `orca plugin`. No toca una versión instalada desde otra carpeta ni reactiva un plugin que desactivaste.
15
+ - **Ejecutable autónomo** (`omk-windows-x64.exe`, `omk-macos-arm64`, `omk-linux-x64`, Node SEA): con doble clic hace `omk setup`, se copia al `PATH` del usuario (en Windows, en el registro, conservando las variables sin expandir) y extrae el kit a una carpeta estable. `scripts/build-exe.js` lo construye; la release lo adjunta con su `.sha256`.
16
+ - **Panel *Multiagent Kit*** en el plugin (v0.2.0): verificar, inicializar y actualizar con un botón, los tres ajustes del plugin (los mismos de *Settings → Plugins*) y los agentes activos.
17
+ - Pruebas: `tests/test_orca.sh` (contra un doble del CLI de Orca), `tests/test_exe.sh` y las del panel; la CI construye y prueba el ejecutable en Linux, macOS y Windows.
18
+
19
+ ### Cambiado
20
+ - La notificación «omk no está instalado» del plugin menciona el ejecutable y que hay que reiniciar Orca.
21
+
22
+ ## [1.4.1] - 2026-11-11
23
+
24
+ ### Corregido
25
+ - Proyectos inicializados con una versión anterior: ya no hace falta reinicializarlos para que la 1.4.0 funcione. La skill `orca` deduce en cada run lo que falte en la ficha (proveedores activos, dominios sensibles, setup de worktree, `.env` de desarrollo que no estén en `.worktreeinclude`, rama padre), lo usa, lo anota en el plan de rondas y ofrece guardarlo al cerrar. Con Orca, el despacho lleva el bloque `SETUP` si `orca.yaml` o `.worktreeinclude` no están al día.
26
+
8
27
  ## [1.4.0] - 2026-11-11
9
28
 
10
29
  Olimpo: reparto por roles y niveles de modelo, y worktrees que nacen de una base fresca, listos para probar y sin residuos. Detalle en [`docs/OLIMPO.md`](docs/OLIMPO.md).
@@ -123,7 +142,9 @@ Primera versión de **Orca Multiagent Kit**. Une CSR (Claude Session Rules, de [
123
142
  ### Eliminado
124
143
  - Copias duplicadas de reglas y skills `csr-*` dentro de cada agente, y el plugin `claude-session-rules` de Antigravity.
125
144
 
126
- [Unreleased]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.4.0...HEAD
145
+ [Unreleased]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.5.0...HEAD
146
+ [1.5.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.4.1...v1.5.0
147
+ [1.4.1]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.4.0...v1.4.1
127
148
  [1.4.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.3.0...v1.4.0
128
149
  [1.3.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.2.0...v1.3.0
129
150
  [1.2.0]: https://github.com/FernandoBaqueroo/orca-multiagent-kit/compare/v1.1.0...v1.2.0
package/README.md CHANGED
@@ -66,7 +66,9 @@ 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
- Cuatro formas. Todas instalan lo mismo, hacen backup de lo que tocan y se deshacen con `omk restore`.
69
+ Cinco formas. Todas instalan lo mismo, hacen backup de lo que tocan y se deshacen con `omk restore`.
70
+
71
+ **0. Ejecutable, para Orca** (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. Prepara Orca entero: instala el kit, enciende los plugins, instala el plugin del kit (te enseña lo que pide y te pregunta antes de aprobarlo), abre su panel y deja `omk` en el PATH. Con el kit ya instalado por npm, lo mismo es `omk setup`. Detalle: [`docs/EJECUTABLE.md`](docs/EJECUTABLE.md).
70
72
 
71
73
  **1. npx** (Node ≥ 18, sin instalar nada global)
72
74
  ```bash
@@ -102,7 +104,9 @@ Requisitos: macOS, Linux, WSL o Git Bash, con bash ≥ 3.2.
102
104
 
103
105
  | Comando | Qué hace |
104
106
  |:--|:--|
107
+ | `omk setup [--yes] [--dry-run]` | Prepara Orca entero: kit, plugins encendidos, plugin del kit y su panel |
105
108
  | `omk install [--agents a,b] [--dry-run]` | Instala o migra la fuente única para los agentes detectados |
109
+ | `omk plugin install\|status\|uninstall` | El plugin de Orca del kit; `install` pide tu aprobación (o `--yes`) |
106
110
  | `omk init [ruta]` | Prepara un proyecto (por defecto, la carpeta actual) |
107
111
  | `omk verify` | Comprueba enlaces, imports y que no queden copias divergentes |
108
112
  | `omk adopt <carpeta-skill>` | Comparte una skill externa (p. ej. impeccable) con todos los agentes |
@@ -147,7 +151,7 @@ Solo tienes que conocer dos frases. El resto lo deciden los agentes.
147
151
 
148
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.
149
153
 
150
- **Plugin de Orca** (opcional, Orca ≥ 1.4.248): `omk verify`, «inicializa el proyecto» y `omk update` en la paleta de comandos, el contrato del worker añadido a cada despacho de orquestación del kit y los agentes activos en la barra de estado. Desde un clon o el zip: `orca plugin install ./orca-plugin`. 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 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).
151
155
 
152
156
  <a id="flujo"></a>
153
157
  ## <img src="assets/icons/flow.svg" width="22" height="22" alt=""> Flujo de trabajo
@@ -184,22 +188,22 @@ flowchart LR
184
188
 
185
189
  ```text
186
190
  orca-multiagent-kit/
187
- ├── bin/omk.js CLI omk (npm / npx), sin dependencias
191
+ ├── bin/ CLI omk (npm / npx / ejecutable), sin dependencias: omk · setup · orca · sea
188
192
  ├── core/AGENTS.md núcleo siempre cargado (~80 líneas)
189
193
  ├── rules/ 00-router … 95-multi-agent + lang/ (17 lenguajes)
190
194
  ├── skills/ kit-init · orca · speckit-orca-implement · csr-*
191
195
  ├── speckit-extension/ extensión de spec-kit (hook before_implement)
192
196
  ├── templates/ AGENTS.md · CLAUDE.md · STACK.md · ORCHESTRATION.md · orca.yaml · .worktreeinclude · models.md
193
197
  ├── output-styles/ csr-minimal (Claude Code)
194
- ├── orca-plugin/ plugin de Orca: comandos del kit, contrato del worker, barra de estado
198
+ ├── orca-plugin/ plugin de Orca: comandos y panel del kit, contrato del worker, barra de estado
195
199
  ├── install.sh instala · migra · verifica · restaura · adopta
196
200
  ├── GUIA.html guía visual del flujo
197
201
  ├── site/ web interactiva (GitHub Pages)
198
202
  ├── docs/MANUAL.md manual completo
199
203
  ├── AI_INSTALL.md instrucciones para que una IA lo instale
200
- ├── tests/ pruebas del instalador y del CLI en un $HOME desechable
201
- ├── scripts/ check.sh · build-release.sh · get.sh · banner.py
202
- └── .github/ CI (Linux + macOS), releases con zip, web, plantillas de issues y PR
204
+ ├── tests/ pruebas del instalador, del CLI, de omk setup (doble de Orca) y del ejecutable
205
+ ├── scripts/ check.sh · build-release.sh · build-exe.js · get.sh · banner.py
206
+ └── .github/ CI (Linux + macOS; ejecutable también en Windows), releases con zip y ejecutables, web, plantillas
203
207
  ```
204
208
 
205
209
  <a id="documentacion"></a>
@@ -213,6 +217,7 @@ orca-multiagent-kit/
213
217
  | [`AI_INSTALL.md`](AI_INSTALL.md) | Una IA que tiene que instalar o integrar el kit |
214
218
  | [`docs/OLIMPO.md`](docs/OLIMPO.md) | Roles, niveles de modelo, recurso por unidad y ciclo de vida de los worktrees |
215
219
  | [`docs/PLUGIN-ORCA.md`](docs/PLUGIN-ORCA.md) | Quien usa Orca y quiere el kit integrado en la app |
220
+ | [`docs/EJECUTABLE.md`](docs/EJECUTABLE.md) | Quien quiere preparar Orca de una vez (`omk setup` o el ejecutable), o construir el ejecutable |
216
221
  | [`CHANGELOG.md`](CHANGELOG.md) | Historial de versiones ([SemVer](https://semver.org/lang/es/)) |
217
222
 
218
223
  <a id="contribuir"></a>
package/VERSION CHANGED
@@ -1 +1 @@
1
- 1.4.0
1
+ 1.5.0
package/bin/omk.js CHANGED
@@ -1,5 +1,5 @@
1
1
  #!/usr/bin/env node
2
- // omk — CLI de Orca Multiagent Kit. Sin dependencias: envuelve install.sh con comandos cortos.
2
+ // omk — CLI de Orca Multiagent Kit. Sin dependencias: envuelve install.sh con comandos cortos y prepara Orca.
3
3
  'use strict';
4
4
 
5
5
  const { spawn, spawnSync } = require('node:child_process');
@@ -11,6 +11,9 @@ const KIT = path.resolve(__dirname, '..');
11
11
  const VERSION = fs.readFileSync(path.join(KIT, 'VERSION'), 'utf8').trim();
12
12
  const REPO = 'orca-multiagent-kit';
13
13
  const AGENTS_HOME = process.env.AGENT_KIT_HOME || path.join(os.homedir(), '.agents');
14
+ const RELEASES = 'https://github.com/FernandoBaqueroo/orca-multiagent-kit/releases/latest';
15
+ // Ejecutable autónomo (Node SEA, bin/sea.js)
16
+ const STANDALONE = require('./orca').isSea;
14
17
 
15
18
  const color = process.stdout.isTTY && !process.env.NO_COLOR;
16
19
  const lime = (s) => (color ? `\x1b[38;5;154m${s}\x1b[0m` : s);
@@ -24,9 +27,11 @@ ${bold('Uso')}
24
27
  omk <comando> [opciones]
25
28
 
26
29
  ${bold('Comandos')}
30
+ ${lime('setup')} [--yes] [--dry-run] Prepara Orca entero: kit, plugins, plugin del kit y su panel
27
31
  ${lime('install')} [--agents a,b] [--dry-run] Instala o migra la fuente única en ~/.agents
28
32
  ${lime('init')} [ruta] Prepara un proyecto (por defecto, la carpeta actual)
29
33
  ${lime('verify')} Comprueba enlaces, imports y copias divergentes
34
+ ${lime('plugin')} install|status|uninstall El plugin de Orca del kit (install pide tu aprobación)
30
35
  ${lime('adopt')} <carpeta-skill> Comparte una skill externa con todos los agentes
31
36
  ${lime('backups')} Lista las copias de seguridad
32
37
  ${lime('restore')} <fecha> Deshace una instalación (fecha de "omk backups")
@@ -38,6 +43,7 @@ ${bold('Comandos')}
38
43
  ${bold('Agentes')} claude · antigravity · codex · copilot · cursor · devin (opcional)
39
44
 
40
45
  ${bold('Ejemplos')}
46
+ omk setup ${dim('todo de una vez; pregunta antes de aprobar el plugin')}
41
47
  npx orca-multiagent-kit install --dry-run
42
48
  omk install
43
49
  omk init ~/Dev/mi-app
@@ -68,15 +74,30 @@ function findBash() {
68
74
  die('Windows necesita Git Bash. Instala Git for Windows, define OMK_BASH con la ruta de su bash.exe, o ejecuta omk dentro de WSL (instala en el $HOME de WSL).');
69
75
  }
70
76
 
71
- function runInstaller(args) {
77
+ /** Ejecuta install.sh dibujando su salida; resuelve con su código de salida. */
78
+ function installer(args) {
72
79
  const child = spawn(findBash(), [path.join(KIT, 'install.sh'), ...args], {
73
80
  stdio: ['inherit', 'pipe', 'pipe'],
74
81
  env: { ...process.env, OMK_CLI: '1', OMK_EVENTS: '1' },
75
82
  });
76
83
  child.on('error', (e) => die(e.message));
77
84
  // Ctrl+C: deja la terminal limpia (sin el spinner a medias)
78
- process.on('SIGINT', () => { process.stdout.write('\r\x1b[2K'); child.kill('SIGINT'); process.exit(130); });
79
- require('./ui').render(child).then((code) => process.exit(code));
85
+ const onInterrupt = () => { process.stdout.write('\r\x1b[2K'); child.kill('SIGINT'); process.exit(130); };
86
+ process.on('SIGINT', onInterrupt);
87
+ return require('./ui').render(child).finally(() => process.off('SIGINT', onInterrupt));
88
+ }
89
+
90
+ function runInstaller(args) {
91
+ installer(args).then((code) => process.exit(code));
92
+ }
93
+
94
+ // Un fallo inesperado de setup/plugin se cuenta y sale con error; nunca se queda a medias en silencio.
95
+ function finish(promise) {
96
+ const { pauseIfAsked } = require('./setup');
97
+ promise
98
+ .catch((e) => { process.stderr.write(`omk: ${e.message}\n`); return 1; })
99
+ .then(pauseIfAsked)
100
+ .then((code) => process.exit(code));
80
101
  }
81
102
 
82
103
  function listBackups() {
@@ -88,6 +109,14 @@ function listBackups() {
88
109
  const [cmd = 'help', ...rest] = process.argv.slice(2);
89
110
 
90
111
  switch (cmd) {
112
+ case 'setup':
113
+ finish(require('./setup').setup({ kit: KIT, args: rest, installer, standalone: STANDALONE }));
114
+ break;
115
+
116
+ case 'plugin':
117
+ finish(require('./setup').plugin({ kit: KIT, args: rest }));
118
+ break;
119
+
91
120
  case 'install':
92
121
  case 'i':
93
122
  runInstaller(rest);
@@ -124,6 +153,13 @@ switch (cmd) {
124
153
  break;
125
154
 
126
155
  case 'update': {
156
+ if (STANDALONE) {
157
+ // El ejecutable no se actualiza solo: la versión nueva es otro binario que se descarga.
158
+ console.log(`${lime('›')} Este omk es el ejecutable autónomo v${VERSION}. La última versión está en ${RELEASES}`);
159
+ console.log(dim(' Descárgala y ejecútala (o «omk setup» con ella). Reaplicando ahora la instalación de esta versión…'));
160
+ runInstaller(rest.filter((a) => a !== '--force'));
161
+ break;
162
+ }
127
163
  const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
128
164
  const sh = { encoding: 'utf8', shell: process.platform === 'win32' };
129
165
  const latest = (spawnSync(npm, ['view', REPO, 'version'], sh).stdout || '').trim();
package/bin/orca.js ADDED
@@ -0,0 +1,170 @@
1
+ // Integración de omk con la app Orca: localizar su CLI, encender los plugins e instalar el del kit.
2
+ // Solo habla con Orca por su CLI (`orca … --json`): nunca escribe en sus ficheros.
3
+ 'use strict';
4
+
5
+ const { spawnSync } = require('node:child_process');
6
+ const fs = require('node:fs');
7
+ const os = require('node:os');
8
+ const path = require('node:path');
9
+
10
+ const PLUGIN_ID = 'multiagent-kit';
11
+ const PANEL_ID = 'kit';
12
+ // `orca plugin install|update|enable` salen con 3 cuando falta la aprobación del usuario.
13
+ const APPROVAL_EXIT = 3;
14
+ const FINGERPRINT = /^ap1-[0-9a-f]{8,128}$/;
15
+ const TIMEOUT_MS = 120000;
16
+ // `orca open` espera a que arranque la app.
17
+ const OPEN_TIMEOUT_MS = 180000;
18
+
19
+ /** [mayor, menor, parche] de la primera versión x.y.z del texto, o null. */
20
+ function parseVersion(text) {
21
+ const m = /(\d+)\.(\d+)\.(\d+)/.exec(String(text || ''));
22
+ return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
23
+ }
24
+
25
+ /** Si `version` cumple un requisito `>=x.y.z` (el único formato de engines.orca). */
26
+ function satisfies(version, range) {
27
+ const have = parseVersion(version);
28
+ const need = parseVersion(range);
29
+ if (!have || !need) return false;
30
+ for (let i = 0; i < 3; i += 1) if (have[i] !== need[i]) return have[i] > need[i];
31
+ return true;
32
+ }
33
+
34
+ /** Rutas donde suele estar el CLI de Orca cuando no está en el PATH. */
35
+ function knownOrcaPaths(platform = process.platform, env = process.env, home = os.homedir()) {
36
+ if (platform === 'win32') {
37
+ return env.LOCALAPPDATA ? [path.join(env.LOCALAPPDATA, 'Programs', 'orca', 'resources', 'bin', 'orca.exe')] : [];
38
+ }
39
+ if (platform === 'darwin') {
40
+ return ['/Applications/Orca.app', path.join(home, 'Applications', 'Orca.app')].map((app) =>
41
+ path.join(app, 'Contents', 'Resources', 'bin', 'orca'));
42
+ }
43
+ return [];
44
+ }
45
+
46
+ // Si corre como ejecutable autónomo (Node SEA): ahí process.execPath es omk, no Node.
47
+ // node:sea no existe en Node 18, que sigue soportado.
48
+ const isSea = (() => { try { return require('node:sea').isSea(); } catch { return false; } })();
49
+
50
+ // Un .js se ejecuta con Node: así OMK_ORCA puede apuntar a un CLI envuelto o a un doble de pruebas.
51
+ function commandFor(file) {
52
+ if (!/\.m?js$/i.test(file)) return { file, prefix: [] };
53
+ return { file: isSea ? 'node' : process.execPath, prefix: [file] };
54
+ }
55
+
56
+ function probe(cmd) {
57
+ const r = spawnSync(cmd.file, [...cmd.prefix, '--version'], { encoding: 'utf8', timeout: 15000, windowsHide: true });
58
+ if (r.error || r.status !== 0) return null;
59
+ const version = parseVersion(r.stdout);
60
+ return version ? version.join('.') : null;
61
+ }
62
+
63
+ /**
64
+ * El CLI de Orca y su versión, o null. OMK_ORCA manda: si apunta a algo que no funciona no se busca
65
+ * otro, para no acabar hablando con una instalación de Orca que no es la que se pidió.
66
+ */
67
+ function findOrca(env = process.env) {
68
+ const candidates = env.OMK_ORCA ? [env.OMK_ORCA] : ['orca', ...knownOrcaPaths(process.platform, env)];
69
+ for (const file of candidates) {
70
+ if (file !== 'orca' && !fs.existsSync(file)) continue;
71
+ const cmd = commandFor(file);
72
+ const version = probe(cmd);
73
+ if (version) return { ...cmd, path: file, version };
74
+ }
75
+ return null;
76
+ }
77
+
78
+ // Lo que llega de Orca (nombres, descripciones, errores) se imprime en el terminal del usuario:
79
+ // sin caracteres de control, para que no pueda mover el cursor ni cambiar colores.
80
+ const clean = (text) => String(text == null ? '' : text).replace(/[\u0000-\u001f\u007f-\u009f]/g, '');
81
+
82
+ /** Ejecuta `orca <args> --json`. Nunca pasa por una shell: los argumentos van tal cual. */
83
+ function runOrca(orca, args, timeout = TIMEOUT_MS) {
84
+ const r = spawnSync(orca.file, [...orca.prefix, ...args, '--json'], {
85
+ encoding: 'utf8', timeout, windowsHide: true, maxBuffer: 16 * 1024 * 1024,
86
+ });
87
+ if (r.error) return { code: 1, json: null, problem: r.error.message };
88
+ let json = null;
89
+ try { json = JSON.parse(r.stdout); } catch { json = null; }
90
+ // Una línea: los mensajes de Orca pueden ocupar varias y se enseñan junto a un ✗.
91
+ const problem = json && json.ok === false && json.error
92
+ ? clean(`${json.error.code}: ${String(json.error.message).split('\n')[0]}`)
93
+ : json ? null : clean((r.stderr || r.stdout || '').trim().split('\n')[0]) || `orca salió con ${r.status}`;
94
+ return { code: r.status === null ? 1 : r.status, json, problem };
95
+ }
96
+
97
+ const samePath = (a, b) => {
98
+ if (!a || !b) return false;
99
+ const norm = (p) => path.resolve(p).replace(/[\\/]+$/, '');
100
+ return process.platform === 'win32' ? norm(a).toLowerCase() === norm(b).toLowerCase() : norm(a) === norm(b);
101
+ };
102
+
103
+ /** El plugin del kit tal como lo lista `orca plugin list --json`, o null. */
104
+ function findInstalled(listJson) {
105
+ const plugins = (listJson && listJson.result && listJson.result.plugins) || [];
106
+ const found = plugins.find((p) => typeof p.pluginKey === 'string' && p.pluginKey.endsWith(`.${PLUGIN_ID}`));
107
+ return found ? { ...found, pluginKey: clean(found.pluginKey), version: clean(found.version), status: clean(found.status) } : null;
108
+ }
109
+
110
+ /**
111
+ * Qué hacer con el plugin:
112
+ * - `install`: no está.
113
+ * - `update`: hay otra versión instalada desde esta misma carpeta (`orca plugin update` la vuelve a copiar).
114
+ * - `foreign`: hay otra versión instalada desde otro sitio; no se toca sin que lo pida el usuario.
115
+ * - `enable`: está esta versión, pero espera aprobación.
116
+ * - `disabled`: está esta versión y el usuario la desactivó; se respeta.
117
+ * - `current`: está esta versión y activa.
118
+ */
119
+ function planPlugin(installed, dir, version) {
120
+ if (!installed) return 'install';
121
+ if (installed.version !== version) {
122
+ const source = installed.source || {};
123
+ return source.kind === 'local-path' && samePath(source.path || source.reference, dir) ? 'update' : 'foreign';
124
+ }
125
+ if (installed.status === 'pending' || installed.needsReconsent) return 'enable';
126
+ if (installed.status === 'disabled') return 'disabled';
127
+ return 'current';
128
+ }
129
+
130
+ /** Lo que Orca concedería, en líneas legibles, a partir de `error.data` de approval_required. */
131
+ function describeGrants(data) {
132
+ const grants = (data && data.grants) || {};
133
+ const lines = [];
134
+ if (grants.executionDescription) lines.push(grants.executionDescription);
135
+ for (const c of grants.capabilities || []) lines.push(`${c.kind}: ${c.description}`);
136
+ const adds = (grants.contributions || []).map((c) => c.name).filter(Boolean);
137
+ if (adds.length) lines.push(`Añade: ${adds.join(', ')}`);
138
+ return lines.map(clean);
139
+ }
140
+
141
+ /** La huella que hay que pasar a --approve, o null si Orca no la dio o no tiene el formato esperado. */
142
+ function approvalFingerprint(result) {
143
+ const data = result.json && result.json.error && result.json.error.data;
144
+ const fp = data && data.approvalFingerprint;
145
+ return typeof fp === 'string' && FINGERPRINT.test(fp) ? fp : null;
146
+ }
147
+
148
+ /**
149
+ * Ejecuta un comando de Orca que puede pedir aprobación. Si la pide, enseña lo que concede y
150
+ * repite con --approve solo si `confirm(grants)` responde que sí.
151
+ */
152
+ async function withApproval(orca, args, confirm) {
153
+ const first = runOrca(orca, args);
154
+ if (first.code !== APPROVAL_EXIT) return { ...first, approved: false };
155
+ const fp = approvalFingerprint(first);
156
+ if (!fp) return { ...first, code: 1, problem: 'Orca pidió aprobación sin una huella válida; no apruebo nada' };
157
+ const data = first.json.error.data;
158
+ if (!(await confirm(describeGrants(data), data))) return { code: APPROVAL_EXIT, json: first.json, problem: 'aprobación rechazada', declined: true };
159
+ return { ...runOrca(orca, [...args, '--approve', fp]), approved: true };
160
+ }
161
+
162
+ function readManifest(dir) {
163
+ return JSON.parse(fs.readFileSync(path.join(dir, 'orca-plugin.json'), 'utf8'));
164
+ }
165
+
166
+ module.exports = {
167
+ PLUGIN_ID, PANEL_ID, APPROVAL_EXIT, OPEN_TIMEOUT_MS, isSea,
168
+ clean, samePath, parseVersion, satisfies, knownOrcaPaths, findOrca, runOrca, findInstalled, planPlugin,
169
+ describeGrants, approvalFingerprint, withApproval, readManifest,
170
+ };
package/bin/sea.js ADDED
@@ -0,0 +1,95 @@
1
+ // Punto de entrada del ejecutable autónomo (Node SEA, scripts/build-exe.js): extrae el kit que lleva
2
+ // dentro a una carpeta estable y ejecuta omk desde ahí. Sin argumentos (doble clic) hace `omk setup`.
3
+ 'use strict';
4
+
5
+ const crypto = require('node:crypto');
6
+ const fs = require('node:fs');
7
+ const os = require('node:os');
8
+ const path = require('node:path');
9
+ const zlib = require('node:zlib');
10
+ const { createRequire } = require('node:module');
11
+ const sea = require('node:sea');
12
+
13
+ const ASSET = 'kit.json.gz';
14
+ const STAMP = '.omk-build';
15
+ // Marca de una extracción a medias: solo se borra una carpeta .new que la tenga.
16
+ const PARTIAL = '.omk-partial';
17
+
18
+ /** Carpeta del kit extraído: OMK_HOME, o la de usuario de cada sistema. */
19
+ function kitHome(env = process.env, platform = process.platform, home = os.homedir()) {
20
+ if (env.OMK_HOME) return path.resolve(env.OMK_HOME);
21
+ if (platform === 'win32') return path.join(env.LOCALAPPDATA || path.join(home, 'AppData', 'Local'), 'Programs', 'orca-multiagent-kit', 'kit');
22
+ return path.join(home, '.local', 'share', 'orca-multiagent-kit');
23
+ }
24
+
25
+ const isKitCopy = (dir) => fs.existsSync(path.join(dir, 'VERSION')) && fs.existsSync(path.join(dir, 'install.sh'));
26
+
27
+ // Las rutas vienen del propio ejecutable, pero se comprueban igual: ninguna sale de la carpeta destino.
28
+ function safeJoin(base, rel) {
29
+ const target = path.resolve(base, rel);
30
+ if (path.isAbsolute(rel) || !target.startsWith(base + path.sep)) throw new Error(`ruta no válida en el kit embebido: ${rel}`);
31
+ return target;
32
+ }
33
+
34
+ function removeOwned(dir, marker) {
35
+ if (!fs.existsSync(dir)) return;
36
+ if (!fs.existsSync(path.join(dir, marker)) && !isKitCopy(dir)) throw new Error(`${dir} existe y no es una copia del kit: no la toco`);
37
+ fs.rmSync(dir, { recursive: true, force: true });
38
+ }
39
+
40
+ /** Extrae el kit embebido en `dest` si no está ya esta misma build. Devuelve `dest`. */
41
+ function extractKit(dest) {
42
+ const archive = Buffer.from(sea.getAsset(ASSET));
43
+ const build = crypto.createHash('sha256').update(archive).digest('hex');
44
+ try {
45
+ if (fs.readFileSync(path.join(dest, STAMP), 'utf8').trim() === build) return dest;
46
+ } catch {
47
+ // Sin sello: primera vez, o una copia que no salió de este ejecutable. Se extrae.
48
+ }
49
+ if (fs.existsSync(dest) && !isKitCopy(dest)) {
50
+ throw new Error(`${dest} existe y no es una copia del kit: no la toco. Define OMK_HOME con otra carpeta.`);
51
+ }
52
+ const { files } = JSON.parse(zlib.gunzipSync(archive).toString('utf8'));
53
+ const fresh = `${dest}.new`;
54
+ removeOwned(fresh, PARTIAL);
55
+ fs.mkdirSync(fresh, { recursive: true });
56
+ fs.writeFileSync(path.join(fresh, PARTIAL), '');
57
+ for (const [rel, mode, data] of files) {
58
+ const target = safeJoin(fresh, rel);
59
+ fs.mkdirSync(path.dirname(target), { recursive: true });
60
+ fs.writeFileSync(target, Buffer.from(data, 'base64'), { mode });
61
+ }
62
+ fs.writeFileSync(path.join(fresh, STAMP), build + '\n');
63
+ fs.rmSync(path.join(fresh, PARTIAL));
64
+ // Cambio casi atómico: la copia anterior solo se borra cuando la nueva ya está en su sitio.
65
+ const old = `${dest}.old`;
66
+ removeOwned(old, STAMP);
67
+ if (fs.existsSync(dest)) fs.renameSync(dest, old);
68
+ fs.renameSync(fresh, dest);
69
+ fs.rmSync(old, { recursive: true, force: true });
70
+ return dest;
71
+ }
72
+
73
+ function main() {
74
+ // El ejecutable recibe [ejecutable, ejecutable, ...args]: omk.js lee desde el tercero.
75
+ if (process.argv.length <= 2) {
76
+ process.argv.push('setup');
77
+ process.env.OMK_PAUSE = '1';
78
+ }
79
+ let kit;
80
+ try {
81
+ kit = extractKit(kitHome());
82
+ } catch (error) {
83
+ process.stderr.write(`omk: no pude preparar el kit: ${error.message}\n`);
84
+ process.exitCode = 1;
85
+ // Abierto con doble clic, la ventana se cerraría antes de poder leer el error.
86
+ if (process.env.OMK_PAUSE === '1' && process.stdin.isTTY) {
87
+ process.stdout.write('\nPulsa Enter para cerrar ');
88
+ process.stdin.once('data', () => process.exit(1));
89
+ }
90
+ return;
91
+ }
92
+ createRequire(path.join(kit, 'bin', 'omk.js'))('./omk.js');
93
+ }
94
+
95
+ main();