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/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/bin/ui.js
CHANGED
|
@@ -3,6 +3,10 @@
|
|
|
3
3
|
'use strict';
|
|
4
4
|
|
|
5
5
|
const readline = require('node:readline');
|
|
6
|
+
const { isTransientCopy } = require('./fetch');
|
|
7
|
+
|
|
8
|
+
// Cómo se llama a omk desde donde corre: con npx no hay un «omk» en el PATH.
|
|
9
|
+
const CLI = isTransientCopy(__dirname) ? 'npx orca-multiagent-kit' : 'omk';
|
|
6
10
|
|
|
7
11
|
const tty = Boolean(process.stdout.isTTY) && !process.env.NO_COLOR && process.env.TERM !== 'dumb';
|
|
8
12
|
const truecolor = /truecolor|24bit/i.test(process.env.COLORTERM || '');
|
|
@@ -70,12 +74,12 @@ function footer(kind, stamp, dry, todos, infos, started) {
|
|
|
70
74
|
if (kind === 'restore') { out(` ${sym.ok} ${c.bold('Restaurado')} ${c.grey('en ' + secs + ' s')}`); out(); return; }
|
|
71
75
|
out(` ${sym.ok} ${c.bold(todos.length ? 'Hecho, con ' + todos.length + ' pendiente' + (todos.length > 1 ? 's' : '') : 'Hecho')} ${c.grey('en ' + secs + ' s')}`);
|
|
72
76
|
if (kind === 'global') {
|
|
73
|
-
rows.push(['comprobar',
|
|
74
|
-
rows.push(['proyectos',
|
|
77
|
+
rows.push(['comprobar', `${CLI} verify`]);
|
|
78
|
+
rows.push(['proyectos', `${CLI} init ` + c.grey('(dentro de cada proyecto)')]);
|
|
75
79
|
} else {
|
|
76
80
|
rows.push(['siguiente', 'en el agente: «inicializa el proyecto»']);
|
|
77
81
|
}
|
|
78
|
-
if (stamp) rows.push(['deshacer',
|
|
82
|
+
if (stamp) rows.push(['deshacer', `${CLI} restore ${stamp}`]);
|
|
79
83
|
for (const [k, v] of rows) out(` ${c.grey(k.padEnd(10))} ${c.lime(v)}`);
|
|
80
84
|
out();
|
|
81
85
|
}
|
|
@@ -150,7 +154,7 @@ function render(child) {
|
|
|
150
154
|
case 'result':
|
|
151
155
|
out();
|
|
152
156
|
if (checks.fail === 0) out(` ${sym.ok} ${c.bold('Todo correcto')} ${c.grey(checks.ok + ' comprobaciones')}`);
|
|
153
|
-
else out(` ${sym.fail} ${c.bold(c.red(checks.fail + (checks.fail > 1 ? ' fallos' : ' fallo')))} ${c.grey('repáralos con')} ${c.lime(
|
|
157
|
+
else out(` ${sym.fail} ${c.bold(c.red(checks.fail + (checks.fail > 1 ? ' fallos' : ' fallo')))} ${c.grey('repáralos con')} ${c.lime(`${CLI} install`)}`);
|
|
154
158
|
out();
|
|
155
159
|
break;
|
|
156
160
|
case 'footer': await endPhase(); footer(f[0], f[1], f[2], todos, infos, started); break;
|
package/bin/update.js
ADDED
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
// omk update: pone al día todo lo que el kit instala, con un solo comando y sea cual sea la forma en
|
|
2
|
+
// que se instaló. El propio kit (npm o el ejecutable autónomo: bin/fetch.js), la fuente única de
|
|
3
|
+
// ~/.agents, el proyecto de la carpeta actual (bloques de AGENTS.md y CLAUDE.md, ficheros que falten
|
|
4
|
+
// y los apartados nuevos de ORCHESTRATION.md y STACK.md: bin/sync.js), los hooks de reparto de Claude
|
|
5
|
+
// Code (bin/hooks.js) y el plugin de Orca.
|
|
6
|
+
'use strict';
|
|
7
|
+
|
|
8
|
+
const { spawnSync } = require('node:child_process');
|
|
9
|
+
const fs = require('node:fs');
|
|
10
|
+
const path = require('node:path');
|
|
11
|
+
const { backupRel, makeBackup } = require('./backup');
|
|
12
|
+
const { fetchExecutable, fetchPackage, globalEntry, kitSource, newer } = require('./fetch');
|
|
13
|
+
const { applyHooks } = require('./hooks');
|
|
14
|
+
const { refreshPlugin } = require('./setup');
|
|
15
|
+
const { syncFile } = require('./sync');
|
|
16
|
+
const { c, sym } = require('./ui');
|
|
17
|
+
|
|
18
|
+
// Ficheros de proyecto que se ponen al día con su plantilla, y qué hacer la primera vez (sin sello).
|
|
19
|
+
// ORCHESTRATION.md recibe todo lo que le falte: omk team y la skill orca cuentan con esos campos.
|
|
20
|
+
// STACK.md pide borrar lo que no aplique, así que la primera vez solo se sella: a partir de ahí
|
|
21
|
+
// recibe lo que la plantilla estrene.
|
|
22
|
+
const SYNCED = [
|
|
23
|
+
{ name: 'ORCHESTRATION.md', firstRun: 'add' },
|
|
24
|
+
{ name: 'STACK.md', firstRun: 'stamp' },
|
|
25
|
+
];
|
|
26
|
+
const PROJECT_BLOCK = /<!-- AGENTS:BEGIN project/;
|
|
27
|
+
|
|
28
|
+
const out = (s = '') => process.stdout.write(s + '\n');
|
|
29
|
+
const ok = (s) => out(` ${sym.ok} ${s}`);
|
|
30
|
+
const warn = (s) => out(` ${sym.warn} ${s}`);
|
|
31
|
+
const fail = (s) => out(` ${sym.fail} ${c.red(s)}`);
|
|
32
|
+
const todo = (s) => out(` ${sym.todo} ${s}`);
|
|
33
|
+
const detail = (s) => out(` ${sym.info} ${c.grey(s)}`);
|
|
34
|
+
const heading = (s) => { out(); out(` ${c.lime('◆')} ${c.bold(s)}`); };
|
|
35
|
+
|
|
36
|
+
/** Separa las opciones de omk update de las que van a install.sh (--agents, --dry-run…). */
|
|
37
|
+
function parseOptions(args) {
|
|
38
|
+
const own = { offline: false, force: false, yes: false, noProject: false, noPlugin: false, noHooks: false, dryRun: false };
|
|
39
|
+
const rest = [];
|
|
40
|
+
for (const a of args) {
|
|
41
|
+
if (a === '--offline') own.offline = true;
|
|
42
|
+
else if (a === '--force') own.force = true;
|
|
43
|
+
else if (a === '--yes' || a === '-y') own.yes = true;
|
|
44
|
+
else if (a === '--no-project') own.noProject = true;
|
|
45
|
+
else if (a === '--no-plugin') own.noPlugin = true;
|
|
46
|
+
else if (a === '--no-hooks') own.noHooks = true;
|
|
47
|
+
else { if (a === '--dry-run') own.dryRun = true; rest.push(a); }
|
|
48
|
+
}
|
|
49
|
+
return { ...own, rest };
|
|
50
|
+
}
|
|
51
|
+
|
|
52
|
+
/** La carpeta, si es un proyecto preparado con el kit: tiene ORCHESTRATION.md o el bloque del kit en AGENTS.md. */
|
|
53
|
+
function kitProject(dir) {
|
|
54
|
+
if (fs.existsSync(path.join(dir, 'ORCHESTRATION.md'))) return dir;
|
|
55
|
+
try {
|
|
56
|
+
return PROJECT_BLOCK.test(fs.readFileSync(path.join(dir, 'AGENTS.md'), 'utf8')) ? dir : null;
|
|
57
|
+
} catch (e) {
|
|
58
|
+
// Sin AGENTS.md no es un proyecto del kit; cualquier otro fallo de lectura sí se cuenta.
|
|
59
|
+
if (e.code === 'ENOENT') return null;
|
|
60
|
+
throw e;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/** Deja al día con su plantilla los ficheros de `SYNCED` que existan. Devuelve si todo fue bien. */
|
|
65
|
+
function syncProject({ kit, project, agentsHome, dryRun }) {
|
|
66
|
+
heading(`Plantillas del proyecto ${c.grey(path.basename(project))}`);
|
|
67
|
+
const { stamp, backup } = makeBackup(agentsHome);
|
|
68
|
+
let good = true;
|
|
69
|
+
for (const { name, firstRun } of SYNCED) {
|
|
70
|
+
const file = path.join(project, name);
|
|
71
|
+
if (!fs.existsSync(file)) continue;
|
|
72
|
+
let added;
|
|
73
|
+
let changed;
|
|
74
|
+
try {
|
|
75
|
+
({ added, changed } = syncFile(path.join(kit, 'templates', name), file, { dryRun, backup, firstRun }));
|
|
76
|
+
} catch (e) {
|
|
77
|
+
fail(`${name}: no se pudo poner al día (${e.message})`);
|
|
78
|
+
good = false;
|
|
79
|
+
continue;
|
|
80
|
+
}
|
|
81
|
+
if (added.length === 0) {
|
|
82
|
+
ok(`${name} ya tiene todos los apartados de la plantilla`);
|
|
83
|
+
// Solo cambió el sello: la primera vez, o la plantilla estrena algo que este fichero ya tenía.
|
|
84
|
+
if (changed) detail(`${dryRun ? 'Se anotaría' : 'Anotado'} al final qué apartados de la plantilla conoce: lo que borres no volverá.`);
|
|
85
|
+
continue;
|
|
86
|
+
}
|
|
87
|
+
const count = `${added.length} ${added.length === 1 ? 'apartado nuevo' : 'apartados nuevos'}`;
|
|
88
|
+
if (dryRun) warn(`${name}: se añadirían ${count}`);
|
|
89
|
+
else ok(`${name}: ${count} ${c.grey('(lo que ya tenías no se toca)')}`);
|
|
90
|
+
for (const item of added) out(` ${sym.add} ${item}`);
|
|
91
|
+
if (dryRun) continue;
|
|
92
|
+
todo('Llevan el valor de la plantilla: revísalos, o pide al agente «inicializa el proyecto» para que los rellene.');
|
|
93
|
+
detail(`Copia anterior: omk restore ${stamp}`);
|
|
94
|
+
}
|
|
95
|
+
return good;
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
// Lo que dice «omk update» mientras trae la versión nueva.
|
|
99
|
+
const say = {
|
|
100
|
+
current: (version, note) => out(` ${sym.ok} Ya tienes la última versión (${version})${note ? ` (${note})` : ''}. Reaplicando la instalación…`),
|
|
101
|
+
updating: (version, latest) => out(` ${c.lime('›')} Actualizando ${c.grey(version)} → ${c.lime(latest)}`),
|
|
102
|
+
};
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* Trae la versión nueva del kit según cómo se instaló. Devuelve la orden con la que sigue el omk
|
|
106
|
+
* nuevo (`[programa, ...argumentos]`), o `null` si esta copia ya es la última y sigue ella.
|
|
107
|
+
*/
|
|
108
|
+
async function fetchKit({ kit, version, standalone, force }) {
|
|
109
|
+
const source = kitSource(kit, standalone);
|
|
110
|
+
if (source === 'exe') {
|
|
111
|
+
out(` ${c.lime('›')} Buscando la última versión del ejecutable…`);
|
|
112
|
+
const latest = await fetchExecutable({ version, target: process.execPath, force });
|
|
113
|
+
if (latest === null) { say.current(version, ''); return null; }
|
|
114
|
+
say.updating(version, latest);
|
|
115
|
+
detail('Descargado y comprobado con su SHA-256. Sigue el ejecutable nuevo.');
|
|
116
|
+
return [process.execPath];
|
|
117
|
+
}
|
|
118
|
+
if (source === 'npm') {
|
|
119
|
+
if (!fetchPackage(version, force, say)) return null;
|
|
120
|
+
// El omk recién instalado, por su ruta y con este mismo Node; si no se encuentra, el del PATH.
|
|
121
|
+
const entry = globalEntry();
|
|
122
|
+
return entry ? [process.execPath, entry] : ['omk'];
|
|
123
|
+
}
|
|
124
|
+
out(` ${sym.info} Esta copia del kit (${kit}) no viene de npm ni es el ejecutable: se actualiza como la obtuviste`);
|
|
125
|
+
detail('(git pull, o el zip de la última release). Reaplicando ahora esta versión…');
|
|
126
|
+
return null;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
/** omk update. Devuelve el código de salida. */
|
|
130
|
+
async function update({ kit, version, args, installer, standalone, agentsHome, cwd = process.cwd() }) {
|
|
131
|
+
const opts = parseOptions(args);
|
|
132
|
+
if (!opts.offline) {
|
|
133
|
+
const next = await fetchKit({ kit, version, standalone, force: opts.force });
|
|
134
|
+
if (next) {
|
|
135
|
+
// El resto lo hace el omk recién instalado: es el que trae las plantillas y el plugin nuevos.
|
|
136
|
+
const [program, ...prefix] = next;
|
|
137
|
+
const forwarded = args.filter((a) => a !== '--force');
|
|
138
|
+
const run = spawnSync(program, [...prefix, 'update', '--offline', ...forwarded], {
|
|
139
|
+
stdio: 'inherit', shell: program === 'omk' && process.platform === 'win32',
|
|
140
|
+
});
|
|
141
|
+
if (run.error) throw new Error(`no pude seguir con el omk nuevo (${run.error.message}). Repite: omk update --offline`);
|
|
142
|
+
return run.status === null ? 1 : run.status;
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
const project = opts.noProject ? null : kitProject(cwd);
|
|
147
|
+
const code = await installer(project ? [...opts.rest, '--project', project] : opts.rest);
|
|
148
|
+
if (code !== 0) return code;
|
|
149
|
+
|
|
150
|
+
let good = true;
|
|
151
|
+
if (project) good = syncProject({ kit, project, agentsHome, dryRun: opts.dryRun }) && good;
|
|
152
|
+
else if (!opts.noProject) {
|
|
153
|
+
heading('Proyecto');
|
|
154
|
+
detail(`${cwd} no es un proyecto preparado con el kit: no hay nada que poner al día aquí.`);
|
|
155
|
+
detail('Para prepararlo: omk init, o «inicializa el proyecto» en el agente.');
|
|
156
|
+
}
|
|
157
|
+
const omkBinary = standalone ? require('./setup').installedOmk() : null;
|
|
158
|
+
good = applyHooks({ kit, agentsHome, project, dryRun: opts.dryRun, skip: opts.noHooks, omkBinary }) && good;
|
|
159
|
+
if (!opts.noPlugin) good = (await refreshPlugin({ kit, yes: opts.yes, dryRun: opts.dryRun })) && good;
|
|
160
|
+
|
|
161
|
+
out();
|
|
162
|
+
if (opts.dryRun) out(` ${c.amber('Simulación:')} no se ha escrito nada.`);
|
|
163
|
+
else if (good) out(` ${sym.ok} ${c.bold(`Kit al día (v${version})`)}`);
|
|
164
|
+
else out(` ${sym.fail} ${c.bold(c.red('La actualización ha terminado con fallos'))} ${c.grey('(arriba, con ✗)')}`);
|
|
165
|
+
out();
|
|
166
|
+
return good ? 0 : 1;
|
|
167
|
+
}
|
|
168
|
+
|
|
169
|
+
module.exports = { update, parseOptions, newer, kitProject, backupRel };
|
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.7.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
|
|
@@ -39,7 +39,7 @@ Ningún código es válido hasta pasar, en orden y sin saltos (módulos en `~/.a
|
|
|
39
39
|
4. **Autorrevisión adversarial**: `50-done-gate.md` §4.
|
|
40
40
|
5. **Seguridad**: `30-security.md` siempre; `31-security-audit.md` si toca entrada de usuario, auth, autorización, cripto, ficheros, red, SQL, deserialización, procesos, secretos o dependencias; `32-ai-security.md` si llama a un LLM o define agentes, herramientas o servidores MCP.
|
|
41
41
|
6. **Tests**: `40-testing.md`. Código nuevo sin test ⇒ no está hecho, salvo veto explícito del usuario.
|
|
42
|
-
7. **Gates**: format → lint → typecheck → build → test → coverage → sec-scan → deps (comandos de `STACK.md`).
|
|
42
|
+
7. **Gates**: format → lint → typecheck → build → test → coverage → sec-scan → deps-audit (comandos de `STACK.md`).
|
|
43
43
|
8. **Reporte** (formato de `50-done-gate.md` §8): tabla `gate | cmd | PASS/FAIL/SKIPPED/N/A`. Nunca `PASS` de algo no ejecutado: `SKIPPED (motivo)`. Si un gate falla, arregla la causa y repite desde ese gate.
|
|
44
44
|
|
|
45
45
|
## 5. Prohibiciones duras — YOU MUST NOT
|
|
@@ -53,12 +53,12 @@ Ningún código es válido hasta pasar, en orden y sin saltos (módulos en `~/.a
|
|
|
53
53
|
- Comandos destructivos (`rm -rf`, `push --force`, `DROP`, `reset --hard`, borrar ramas/tablas/buckets) sin confirmación explícita previa.
|
|
54
54
|
- Concatenar entrada de usuario en SQL, shell, HTML, rutas o plantillas. Criptografía propia o parámetros no recomendados.
|
|
55
55
|
|
|
56
|
-
## 6. Trabajo multiagente (Orca) —
|
|
57
|
-
- **
|
|
58
|
-
-
|
|
59
|
-
-
|
|
56
|
+
## 6. Trabajo multiagente (Orca) — YOU MUST
|
|
57
|
+
- **Puerta de reparto**: antes de la primera edición de todo trabajo de implementación —prompt de chat, plan aprobado (modo plan de Claude Code, `implementation_plan.md` de Antigravity), plan en fichero (`planes/*.md`), artefacto o ticket— cuenta sus entregables separables (user stories, sprints, módulos, pantallas, endpoints, secciones del plan). Con **≥2**, carga la skill `orca` (sin herramienta de skills: lee `~/.agents/skills/orca/SKILL.md`) y, **antes de la primera edición**, deja su veredicto escrito en el chat (texto visible: decidirlo solo en el razonamiento no cuenta) en una línea: `ORCA: secuencial — <motivo>`, u `ORCA: <N> unidades · …` seguida del plan de rondas, y entonces no se edita nada hasta la respuesta del usuario (salvo autonomía `auto`). En Claude Code lo impone un hook (`omk gate`): regístrala además con `echo "ORCA: …"` (la misma línea), o la edición se deniega. Si compensa (tiempos, solapes) lo decide la skill con sus datos, no tú antes de cargarla. También la cargas si el usuario menciona paralelo, Orca, worktrees o varios agentes.
|
|
58
|
+
- **Todo plan que escribas** (modo plan, `implementation_plan.md`, `planes/*.md`, artefacto) termina con una sección `Reparto` con ese veredicto y, si reparte, la tabla `unidad | ficheros | depende`: lo ve quien lo aprueba y no se pierde al cambiar de contexto. «Implementa el plan» ⇒ se ejecuta según esa sección; si falta, pasa la puerta antes de editar.
|
|
59
|
+
- No pasan por la puerta (y no llevan línea `ORCA:`): preguntas, un solo entregable (hazlo y pasa `csr-gate`), un worker con su unidad (`UNIT:`) y `/speckit.implement`, que llama a `orca` con su hook `before_implement`.
|
|
60
60
|
- Respeta la autonomía de `./ORCHESTRATION.md` (por defecto `semi`: el usuario confirma el plan de rondas, el merge final y la limpieza de worktrees y ramas; nada más, salvo decisiones de producto).
|
|
61
|
-
- **Invariantes — YOU MUST**: (1) una unidad = un worktree = una rama; (2) los ficheros `shared` de `ORCHESTRATION.md` los toca una sola unidad por ronda o el coordinador; (3) un worker no edita `tasks.md`, `planes/*.md`, `ORCHESTRATION.md`, `STACK.md`, lockfiles ni migraciones ajenas; (4) un worker no mergea, ni hace push, ni borra ramas; (5) todo worker entrega su informe; (6) salir del alcance ⇒ `BLOCKED:` y preguntar; (7) nunca merge a la rama por defecto ni push sin confirmación; (8) ningún worktree nace de una rama local sin contrastar con `origin`, y todo worktree integrado se ofrece para borrar al cerrar el run.
|
|
61
|
+
- **Invariantes — YOU MUST**: (1) una unidad = un worktree = una rama; (2) los ficheros `shared` de `ORCHESTRATION.md` los toca una sola unidad por ronda o el coordinador; (3) un worker no edita `tasks.md`, `planes/*.md`, `ORCHESTRATION.md`, `STACK.md`, lockfiles, ficheros generados ni migraciones ajenas; (4) un worker no mergea, ni hace push, ni borra ramas; (5) todo worker entrega su informe; (6) salir del alcance ⇒ `BLOCKED:` y preguntar; (7) nunca merge a la rama por defecto ni push sin confirmación; (8) ningún worktree nace de una rama local sin contrastar con `origin`, y todo worktree integrado se ofrece para borrar al cerrar el run.
|
|
62
62
|
Detalle: `~/.agents/rules/95-multi-agent.md`.
|
|
63
63
|
|
|
64
64
|
## 7. Router (leer bajo demanda, no todo a la vez)
|
package/docs/EJECUTABLE.md
CHANGED
|
@@ -6,7 +6,9 @@
|
|
|
6
6
|
|
|
7
7
|
| Paso | Qué pasa | Si falla |
|
|
8
8
|
|---|---|---|
|
|
9
|
-
|
|
|
9
|
+
| 0. Solo con npx | El kit corre desde una caché que npm borra cuando quiere: instala `omk` de forma permanente (`npm install -g orca-multiagent-kit@<versión>`) y sigue desde ahí | Dice cómo hacerlo a mano y sale con error |
|
|
10
|
+
| 1. Kit | Reglas y skills en `~/.agents` (con backup, como siempre; acepta `--agents` y `--dry-run`) | Se para con el código de `install.sh` |
|
|
11
|
+
| 1b. Reparto en Claude Code | Si usas Claude Code, fusiona en `~/.claude/settings.json` los hooks que recuerdan la puerta de reparto y la puerta obligatoria (`--no-hooks` para omitirlo). Sin Node en el PATH, la puerta se ejecuta con el propio `omk` (`omk gate hook`) | Un `settings.json` que no es JSON no se toca, y lo dice |
|
|
10
12
|
| 2. `omk` en el `PATH` (solo el ejecutable) | Se copia a sí mismo a `%LOCALAPPDATA%\Programs\orca-multiagent-kit\omk.exe` (Windows) o `~/.local/bin/omk`, y en Windows añade esa carpeta al `Path` de tu usuario | No pisa un `omk` que no sea el del kit; lo dice y sale con error |
|
|
11
13
|
| 3. Orca | Busca su CLI (`PATH`, o donde lo deja el instalador de Orca; `OMK_ORCA` para indicar otro) y comprueba que su versión cumple `engines.orca` del plugin | Dice qué falta (instalar o actualizar Orca) y sale con error |
|
|
12
14
|
| 4. App | Si Orca no está abierto, `orca open` y espera a que arranque | Sale con error |
|
|
@@ -39,7 +41,7 @@ Es un [Node SEA](https://nodejs.org/api/single-executable-applications.html): el
|
|
|
39
41
|
|
|
40
42
|
- Solo extrae cuando cambia la build (sello `.omk-build` con el SHA-256 del kit embebido). Extrae en `<carpeta>.new` y la cambia por la anterior al final: una extracción a medias no deja un kit roto.
|
|
41
43
|
- No pisa una carpeta que no sea una copia del kit (sin `VERSION` e `install.sh`). En macOS y Linux es la misma carpeta que usa `scripts/get.sh`: la versión que quede es la del último que se ejecutó.
|
|
42
|
-
- `omk update` en el ejecutable
|
|
44
|
+
- `omk update` en el ejecutable se actualiza a sí mismo: mira cuál es la última release, descarga el ejecutable de tu sistema junto al que está en marcha (`omk.new`), comprueba que su SHA-256 es el del `.sha256` publicado y solo entonces lo cambia (en Windows renombra el que está en marcha a `omk.exe.old`, que se borra en la siguiente actualización). Después el ejecutable nuevo extrae su kit y pone al día `~/.agents`, el proyecto de la carpeta actual y el plugin de Orca. Si la descarga o la comprobación fallan, el ejecutable queda como estaba. Solo descarga por HTTPS de GitHub. `omk update --offline` no descarga nada.
|
|
43
45
|
- Sigue necesitando bash para `install.sh`: en Windows, Git for Windows (Orca usa Git para los worktrees, así que suele estar ya).
|
|
44
46
|
- Pesa ~90 MiB, porque lleva Node entero.
|
|
45
47
|
|
|
@@ -61,10 +63,9 @@ Pasos: empaqueta en `kit.json.gz` lo mismo que el zip de la release; genera el b
|
|
|
61
63
|
## Pruebas
|
|
62
64
|
|
|
63
65
|
- `tests/test_orca.sh`: `omk setup` y `omk plugin` contra `tests/fixtures/fake-orca.js`, un doble del CLI de Orca (`OMK_ORCA` apunta siempre a él: las pruebas nunca hablan con tu Orca). Cubre la aprobación (sin `--yes` ni terminal no aprueba; con `--yes` usa la huella de Orca; una huella con formato inesperado se rechaza), cada estado del plugin, Orca ausente o antigua, y `setup` completo, en simulación y sin aprobación.
|
|
64
|
-
- `tests/test_exe.sh`: el ejecutable (extracción, sello, carpeta ajena, `install --dry-run`, `update`, `setup` copiándose a `OMK_BIN_DIR` sin tocar el `PATH`, un `omk` ajeno que no se pisa).
|
|
66
|
+
- `tests/test_exe.sh`: el ejecutable (extracción, sello, carpeta ajena, `install --dry-run`, `update --offline`, `setup` copiándose a `OMK_BIN_DIR` sin tocar el `PATH`, un `omk` ajeno que no se pisa, y la autoactualización de extremo a extremo: una «release» servida en la propia máquina (`OMK_RELEASE_BASE`, que solo admite HTTPS o HTTP contra `127.0.0.1`) de la que el ejecutable en marcha se descarga, se comprueba, se sustituye y sigue).
|
|
65
67
|
- La CI ejecuta las dos en Linux, macOS y Windows (job `exe`).
|
|
66
68
|
|
|
67
69
|
DEFERRED:
|
|
68
|
-
- **Autoactualización del ejecutable**: `omk update` en el ejecutable da el enlace a la release, no descarga. Descargar y sustituir un binario en ejecución exige verificar su integridad (firma o checksum publicado) y en Windows renombrarlo en caliente; queda para otro PR.
|
|
69
70
|
- **Firma de código** (Authenticode, notarización de Apple): necesita certificados del proyecto.
|
|
70
71
|
- **Linux arm64 y macOS x64**: la release construye los runners por defecto de GitHub (`ubuntu-latest` x64, `macos-latest` arm64, `windows-latest` x64).
|