@iaforged/context-code 1.0.76 → 1.0.79
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/README.md +68 -68
- package/cli.js +8515 -8515
- package/context-bootstrap.js +27 -27
- package/dist/src/bootstrap/state.js +3 -0
- package/dist/src/bridge/bridgeMain.js +40 -40
- package/dist/src/cli/print.js +12 -12
- package/dist/src/commands/agent/agent.js +8 -0
- package/dist/src/commands/commit-push-pr.js +55 -55
- package/dist/src/commands/createMovedToPluginCommand.js +9 -9
- package/dist/src/commands/init-verifiers.js +238 -238
- package/dist/src/commands/init.js +216 -216
- package/dist/src/commands/install.js +2 -2
- package/dist/src/commands/login/login.js +24 -10
- package/dist/src/commands/orchestrate/index.js +1 -1
- package/dist/src/commands/orchestrate/orchestrate.js +110 -24
- package/dist/src/commands/profile/profile.js +15 -1
- package/dist/src/commands/provider/index.js +1 -1
- package/dist/src/commands/provider/provider.js +34 -1
- package/dist/src/commands/review.js +22 -22
- package/dist/src/commands/run/index.js +2 -2
- package/dist/src/commands/run/run.js +63 -61
- package/dist/src/commands/team/index.js +1 -1
- package/dist/src/commands/team/team.js +84 -76
- package/dist/src/commands/team-auto/teamAuto.js +89 -29
- package/dist/src/commands/terminalSetup/terminalSetup.js +24 -24
- package/dist/src/commands/usage/index.js +7 -0
- package/dist/src/commands/usage/usage.js +5 -0
- package/dist/src/commands/workspace/workspace.js +39 -31
- package/dist/src/commands.js +0 -2
- package/dist/src/components/ConsoleOAuthFlow.js +92 -14
- package/dist/src/components/ModelPicker.js +2 -0
- package/dist/src/components/agents/generateAgent.js +92 -92
- package/dist/src/components/grove/Grove.js +10 -10
- package/dist/src/components/permissions/AskUserQuestionPermissionRequest/AskUserQuestionPermissionRequest.js +8 -8
- package/dist/src/constants/geminiOAuth.js +13 -0
- package/dist/src/constants/github-app.js +134 -134
- package/dist/src/constants/prompts.js +123 -123
- package/dist/src/coordinator/coordinatorMode.js +252 -252
- package/dist/src/hooks/useTypeahead.js +9 -8
- package/dist/src/ink/reconciler.js +7 -7
- package/dist/src/main.js +8 -5
- package/dist/src/memdir/findRelevantMemories.js +6 -6
- package/dist/src/services/MagicDocs/prompts.js +56 -56
- package/dist/src/services/PromptSuggestion/promptSuggestion.js +29 -29
- package/dist/src/services/SessionMemory/prompts.js +66 -66
- package/dist/src/services/api/openai.js +584 -21
- package/dist/src/services/limits/adapters/ollama.js +3 -3
- package/dist/src/services/oauth/geminiCli.js +107 -0
- package/dist/src/services/orchestration/execution/AgentTaskExecutor.js +5 -3
- package/dist/src/services/orchestration/execution/OrchestrationExecutionRuntime.js +18 -18
- package/dist/src/services/orchestration/global/reporting.js +2 -2
- package/dist/src/services/toolUseSummary/toolUseSummaryGenerator.js +9 -9
- package/dist/src/skills/bundled/batch.js +78 -78
- package/dist/src/skills/bundled/claudeApi.js +34 -34
- package/dist/src/skills/bundled/claudeInChrome.js +4 -4
- package/dist/src/skills/bundled/debug.js +36 -36
- package/dist/src/skills/bundled/scheduleRemoteAgents.js +151 -151
- package/dist/src/skills/bundled/skillify.js +132 -132
- package/dist/src/skills/bundled/stuck.js +53 -53
- package/dist/src/skills/bundled/updateConfig.js +418 -418
- package/dist/src/tasks/RemoteAgentTask/RemoteAgentTask.js +26 -26
- package/dist/src/tools/AgentTool/AgentTool.js +7 -7
- package/dist/src/tools/AgentTool/built-in/claudeCodeGuideAgent.js +67 -67
- package/dist/src/tools/AgentTool/built-in/exploreAgent.js +32 -32
- package/dist/src/tools/AgentTool/built-in/generalPurposeAgent.js +13 -13
- package/dist/src/tools/AgentTool/built-in/planAgent.js +49 -49
- package/dist/src/tools/AgentTool/built-in/statuslineSetup.js +129 -129
- package/dist/src/tools/AgentTool/built-in/verificationAgent.js +119 -119
- package/dist/src/tools/AgentTool/prompt.js +131 -131
- package/dist/src/tools/AgentTool/runAgent.js +9 -9
- package/dist/src/tools/BashTool/BashTool.js +10 -10
- package/dist/src/tools/BashTool/prompt.js +94 -94
- package/dist/src/tools/ConfigTool/prompt.js +29 -29
- package/dist/src/tools/EnterWorktreeTool/prompt.js +27 -27
- package/dist/src/tools/FileReadTool/prompt.js +12 -12
- package/dist/src/tools/PowerShellTool/prompt.js +82 -82
- package/dist/src/tools/RemoteTriggerTool/prompt.js +9 -9
- package/dist/src/tools/ScheduleCronTool/prompt.js +37 -37
- package/dist/src/tools/TeamCreateTool/prompt.js +110 -110
- package/dist/src/tools/TeamDeleteTool/prompt.js +13 -13
- package/dist/src/utils/advisor.js +15 -15
- package/dist/src/utils/api.js +2 -2
- package/dist/src/utils/auth.js +207 -2
- package/dist/src/utils/autoUpdater.js +18 -18
- package/dist/src/utils/bash/ShellSnapshot.js +86 -86
- package/dist/src/utils/bash/commands.js +61 -61
- package/dist/src/utils/claudeInChrome/prompt.js +53 -53
- package/dist/src/utils/claudeInChrome/setup.js +8 -8
- package/dist/src/utils/databaseMcp/server/queries.js +632 -632
- package/dist/src/utils/deepLink/registerProtocol.js +35 -35
- package/dist/src/utils/deepLink/terminalLauncher.js +12 -12
- package/dist/src/utils/hooks/execAgentHook.js +7 -7
- package/dist/src/utils/hooks/execPromptHook.js +4 -4
- package/dist/src/utils/hooks/skillImprovement.js +36 -36
- package/dist/src/utils/logoV2Utils.js +1 -1
- package/dist/src/utils/mcp/dateTimeParser.js +9 -9
- package/dist/src/utils/messages.js +191 -191
- package/dist/src/utils/model/model.js +18 -0
- package/dist/src/utils/model/modelOptions.js +51 -1
- package/dist/src/utils/model/modelStrings.js +5 -1
- package/dist/src/utils/model/modelSupportOverrides.js +3 -0
- package/dist/src/utils/model/providerBaseUrls.js +6 -1
- package/dist/src/utils/model/providerCatalog.js +64 -28
- package/dist/src/utils/model/providerModels.js +88 -17
- package/dist/src/utils/model/providerProfiles.js +8 -0
- package/dist/src/utils/model/providerProfilesDb.js +578 -393
- package/dist/src/utils/model/providerSwitch.js +12 -0
- package/dist/src/utils/model/providerWorkspaces.js +2 -0
- package/dist/src/utils/model/providers.js +65 -2
- package/dist/src/utils/orchestration/store/providerWorkspaceStore.js +3 -1
- package/dist/src/utils/orchestration/store/runStore.js +47 -47
- package/dist/src/utils/orchestration/store/teamStore.js +61 -61
- package/dist/src/utils/powershell/parser.js +253 -253
- package/dist/src/utils/sessionTitle.js +12 -12
- package/dist/src/utils/sideQuestion.js +17 -17
- package/dist/src/utils/status.js +1 -1
- package/dist/src/utils/swarm/backends/registry.js +9 -9
- package/dist/src/utils/telemetry/instrumentation.js +9 -9
- package/dist/src/utils/teleport.js +15 -15
- package/dist/src/utils/undercover.js +28 -28
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -240,24 +240,24 @@ Esta parte permite usar varios proveedores como si fueran un equipo de trabajo.
|
|
|
240
240
|
- `workspace`: representa un proveedor dentro del sistema de equipos, por ejemplo `claude`, `openai`, `minimax` u `ollama`.
|
|
241
241
|
- `agent`: es un perfil operativo dentro de un proveedor. Ejemplo: `claude/frontend-lead` o `openai/backend-lead`.
|
|
242
242
|
- `team`: es el equipo completo para un objetivo. Ejemplo: `core-dev`.
|
|
243
|
-
- `
|
|
244
|
-
- `run
|
|
243
|
+
- `equipo interno`: es un grupo de trabajo dentro del team. Ejemplos: `frontend`, `backend`, `docs`, `planning`, `tests`, `review`, `database`. Cuando creas un team con `/workspace setup`, el sistema arma 4 equipos internos por defecto (`frontend`, `backend`, `docs`, `planning`); los que no asignes a un agente quedaran como warnings al ejecutar.
|
|
244
|
+
- `ejecucion` (`run` internamente): es una ejecucion guardada de un objetivo. Tiene tareas, mensajes, resultados y estado. En los comandos veras `<run-id>` porque es el identificador tecnico.
|
|
245
245
|
|
|
246
246
|
Mini glosario para no confundirse con los roles internos:
|
|
247
247
|
|
|
248
|
-
- `orquestador global`: el agente que coordina todo el team. Lee el objetivo del usuario, lo descompone, asigna trabajo a cada
|
|
249
|
-
- `orquestador local`: por
|
|
250
|
-
- `lead`: el agente principal de un
|
|
251
|
-
- `modo autonomo`: cuando un
|
|
252
|
-
- `global-plan` / `squad-plan` / `
|
|
248
|
+
- `orquestador global`: el agente que coordina todo el team. Lee el objetivo del usuario, lo descompone, asigna trabajo a cada equipo interno y consolida los reportes finales para entregartelos a ti.
|
|
249
|
+
- `orquestador local`: por equipo interno. Recibe la parte del objetivo que le toca, decide como dividirla entre los miembros del equipo (o como hacerla solo en `modo autonomo`) y reporta de vuelta al orquestador global.
|
|
250
|
+
- `lead`: el agente principal de un equipo interno. En la mayoria de los flujos, el `orquestador local` y el `lead` son el mismo agente.
|
|
251
|
+
- `modo autonomo`: cuando un equipo interno no tiene miembros extra, el orquestador local asume internamente los roles que necesite (planner, executor, reviewer, etc.) sin necesitar mas agentes configurados.
|
|
252
|
+
- `global-plan` / `squad-plan` / `task.completed` / `run-report`: tipos de mensajes que se guardan en la ejecucion. El primero lo emite el orquestador global al planear, el segundo cada orquestador local cuando recibe su tarea, y los reportes son lo que devuelven cuando terminan. Los puedes ver con `/run messages <run-id>`.
|
|
253
253
|
|
|
254
254
|
Orden normal de uso:
|
|
255
255
|
|
|
256
256
|
1. Configuras un proveedor y un perfil con `/provider`, `/login` y `/model`.
|
|
257
257
|
2. Ejecutas `/workspace setup` para crear el equipo base sin hacer todo a mano.
|
|
258
258
|
3. Revisas el equipo con `/team show`.
|
|
259
|
-
4. Generas una
|
|
260
|
-
5. Ejecutas o revisas la
|
|
259
|
+
4. Generas una ejecucion con `/orchestrate`.
|
|
260
|
+
5. Ejecutas o revisas la ejecucion con `/run`.
|
|
261
261
|
6. Si quieres seleccion automatica o fallback, usas `/policy`.
|
|
262
262
|
|
|
263
263
|
### `/workspace`
|
|
@@ -350,7 +350,7 @@ Cuando usarlo:
|
|
|
350
350
|
|
|
351
351
|
### `/team-auto` — wizard automatico
|
|
352
352
|
|
|
353
|
-
Si todavia no sabes que
|
|
353
|
+
Si todavia no sabes que equipo asignar a cada proveedor, `/team-auto` lo decide por ti. Detecta los perfiles ya logueados y arma un team con equipos internos estandar (`frontend`, `backend`, `docs`, `planning`):
|
|
354
354
|
|
|
355
355
|
```sh
|
|
356
356
|
/team-auto # crea un team llamado "default-team"
|
|
@@ -360,15 +360,15 @@ Si todavia no sabes que dominio asignar a cada proveedor, `/team-auto` lo decide
|
|
|
360
360
|
Que pasa al ejecutarlo:
|
|
361
361
|
|
|
362
362
|
1. Detecta los `provider profile` activos (los que ya tienen credencial).
|
|
363
|
-
2. Aplica una heuristica de reparto: Claude -> `frontend`, OpenAI -> `backend`, MiniMax/Z.AI -> `docs`, Ollama/OpenRouter -> `planning`. Si solo tienes 1 proveedor, ese hace TODOS los
|
|
364
|
-
3. Te muestra el plan en pantalla (que
|
|
363
|
+
2. Aplica una heuristica de reparto: Claude -> `frontend`, OpenAI -> `backend`, MiniMax/Z.AI -> `docs`, Ollama/OpenRouter -> `planning`. Si solo tienes 1 proveedor, ese hace TODOS los equipos internos en `modo autonomo`.
|
|
364
|
+
3. Te muestra el plan en pantalla (que equipos va a crear, que agentes va a reusar, quien sera el orquestador global).
|
|
365
365
|
4. Pulsas `Enter` y aplica los cambios, o `Esc` y cancela sin tocar nada.
|
|
366
366
|
|
|
367
|
-
Cuando un
|
|
367
|
+
Cuando un equipo interno queda sin agente compatible (por ejemplo no tienes ningun proveedor que mapee a `docs`), se reporta `sin asignar` en el plan y queda como warning. Despues puedes asignarlo manualmente con `/team equipo <team> docs <provider>/<agent>`.
|
|
368
368
|
|
|
369
369
|
Si el team ya existe, `/team-auto` solo lo actualiza: no borra agentes ni miembros que ya tuvieras.
|
|
370
370
|
|
|
371
|
-
Cuando quieras configurarlo todo a mano, sigue habiendo `/workspace setup` (wizard guiado, mas detallado) o el formato corto `/workspace setup <team> orchestrator=... <provider/profile:
|
|
371
|
+
Cuando quieras configurarlo todo a mano, sigue habiendo `/workspace setup` (wizard guiado, mas detallado) o el formato corto `/workspace setup <team> orchestrator=... <provider/profile:equipo>...`.
|
|
372
372
|
|
|
373
373
|
### `/agent`
|
|
374
374
|
|
|
@@ -415,7 +415,7 @@ ollama/local-coder
|
|
|
415
415
|
|
|
416
416
|
`/team` arma un equipo usando agentes. El team tiene un coordinador principal y puede dividir el trabajo por areas.
|
|
417
417
|
|
|
418
|
-
En esta documentacion llamamos `
|
|
418
|
+
En esta documentacion llamamos `equipo interno` a cada grupo de trabajo. Ejemplos: `frontend`, `backend`, `docs`, `review`, `tests`, `database`.
|
|
419
419
|
|
|
420
420
|
Comandos:
|
|
421
421
|
|
|
@@ -425,8 +425,8 @@ Comandos:
|
|
|
425
425
|
/team create core-dev
|
|
426
426
|
/team orchestrator
|
|
427
427
|
/team orchestrator core-dev claude/frontend-lead
|
|
428
|
-
/team
|
|
429
|
-
/team
|
|
428
|
+
/team equipo core-dev frontend claude/frontend-lead
|
|
429
|
+
/team equipo core-dev backend openai/backend-lead
|
|
430
430
|
/team add-member core-dev frontend claude/ui-reviewer reviewer
|
|
431
431
|
/team show core-dev
|
|
432
432
|
```
|
|
@@ -436,14 +436,14 @@ Uso practico:
|
|
|
436
436
|
- `/team create core-dev` crea un equipo llamado `core-dev`.
|
|
437
437
|
- `/team orchestrator` abre un selector para escoger equipo y luego orquestador principal.
|
|
438
438
|
- `/team orchestrator core-dev claude/frontend-lead` define quien coordina todo el equipo.
|
|
439
|
-
- `/team
|
|
440
|
-
- `/team
|
|
439
|
+
- `/team equipo core-dev frontend claude/frontend-lead` dice que el area frontend la lidera `claude/frontend-lead`.
|
|
440
|
+
- `/team equipo core-dev backend openai/backend-lead` dice que backend lo lidera `openai/backend-lead`.
|
|
441
441
|
- `/team add-member core-dev frontend claude/ui-reviewer reviewer` agrega un miembro extra al area frontend.
|
|
442
442
|
- `/team show core-dev` muestra como quedo armado el equipo.
|
|
443
443
|
|
|
444
|
-
Cuando usas `/team
|
|
444
|
+
Cuando usas `/team equipo`, ese agente queda como orquestador local y lead del equipo interno al mismo tiempo. Eso significa que usa el perfil/modelo vinculado a ese agente para coordinar su propia area. Por ejemplo, `openai/backend-lead` puede ser el equipo autonomo de backend aunque no tenga miembros extra.
|
|
445
445
|
|
|
446
|
-
Si un
|
|
446
|
+
Si un equipo interno no tiene miembros extra, no esta roto. En ese caso opera en modo autonomo: el orquestador local divide internamente el trabajo segun su funcion principal. Backend puede asumir roles temporales como API, base de datos, validaciones y pruebas; frontend puede asumir UI, componentes, estado y pruebas; docs puede asumir guia tecnica y README. Los miembros extra son opcionales cuando quieres dividir mas el trabajo.
|
|
447
447
|
|
|
448
448
|
Ejemplo mental simple:
|
|
449
449
|
|
|
@@ -453,9 +453,9 @@ Ejemplo mental simple:
|
|
|
453
453
|
- Ollama puede actuar como ejecutor local.
|
|
454
454
|
- El coordinador principal mira el objetivo completo y recibe reportes de cada area.
|
|
455
455
|
|
|
456
|
-
## Crear y ejecutar una
|
|
456
|
+
## Crear y ejecutar una ejecucion
|
|
457
457
|
|
|
458
|
-
Una
|
|
458
|
+
Una ejecucion es un objetivo guardado con sus tareas, mensajes, resultados y estado. Por ejemplo: "crear login con UI y API". Internamente se guarda como `run` en SQLite, por eso puedes cerrar la app y luego volver a revisarla.
|
|
459
459
|
|
|
460
460
|
### `/orchestrate`
|
|
461
461
|
|
|
@@ -467,16 +467,16 @@ Una `run` es una ejecucion guardada de un objetivo. Por ejemplo: "crear login co
|
|
|
467
467
|
|
|
468
468
|
Que pasa cuando lo ejecutas:
|
|
469
469
|
|
|
470
|
-
1. El sistema valida el team, el orquestador global y los
|
|
471
|
-
2. Crea la
|
|
472
|
-
3. **Te muestra el plan**: tareas por
|
|
470
|
+
1. El sistema valida el team, el orquestador global y los equipos internos.
|
|
471
|
+
2. Crea la ejecucion y todas sus tareas en estado `ready` o `blocked` segun la configuracion del equipo.
|
|
472
|
+
3. **Te muestra el plan**: tareas por equipo, agentes asignados, advertencias de configuracion.
|
|
473
473
|
4. Te ofrece dos teclas:
|
|
474
|
-
- **`Enter`**: ejecuta inmediatamente las tareas `ready`. Veras progreso en vivo (
|
|
475
|
-
- **`Esc`**: deja la
|
|
474
|
+
- **`Enter`**: ejecuta inmediatamente las tareas `ready`. Veras progreso en vivo (equipo que esta trabajando, agente activo, fase) y al final un reporte consolidado.
|
|
475
|
+
- **`Esc`**: deja la ejecucion en `planned`. Puedes revisar con `/run show <run-id>` o ejecutar mas tarde con `/run resume <run-id>`.
|
|
476
476
|
|
|
477
|
-
Cuando confirmas con Enter, el flujo interno es: orquestador global delega a cada orquestador local -> cada orquestador local ejecuta o subdelega en `modo autonomo` -> cada uno devuelve
|
|
477
|
+
Cuando confirmas con Enter, el flujo interno es: orquestador global delega a cada orquestador local -> cada orquestador local ejecuta o subdelega en `modo autonomo` -> cada uno devuelve su reporte de tarea -> el orquestador global consolida y emite el `run-report` final que ves tu.
|
|
478
478
|
|
|
479
|
-
Si pulsas Esc o no hay tareas `ready` (todo quedo bloqueado), la
|
|
479
|
+
Si pulsas Esc o no hay tareas `ready` (todo quedo bloqueado), la ejecucion se queda en estado `planned` y el comando termina mostrando los siguientes pasos sugeridos. En ese caso normalmente sigues con:
|
|
480
480
|
|
|
481
481
|
```sh
|
|
482
482
|
/run show <run-id> # revisar el plan en detalle
|
|
@@ -485,7 +485,7 @@ Si pulsas Esc o no hay tareas `ready` (todo quedo bloqueado), la corrida se qued
|
|
|
485
485
|
|
|
486
486
|
### `/run`
|
|
487
487
|
|
|
488
|
-
`/run` sirve para revisar, ejecutar, reintentar, reasignar o cancelar una
|
|
488
|
+
`/run` sirve para revisar, ejecutar, reintentar, reasignar o cancelar una ejecucion.
|
|
489
489
|
|
|
490
490
|
Comandos principales:
|
|
491
491
|
|
|
@@ -496,7 +496,7 @@ Comandos principales:
|
|
|
496
496
|
/run messages <run-id>
|
|
497
497
|
/run tasks <run-id>
|
|
498
498
|
/run task <task-id>
|
|
499
|
-
/run
|
|
499
|
+
/run equipo <run-id> <equipo>
|
|
500
500
|
/run resume <run-id>
|
|
501
501
|
/run cancel <run-id>
|
|
502
502
|
```
|
|
@@ -511,20 +511,20 @@ Comandos de recuperacion:
|
|
|
511
511
|
|
|
512
512
|
Que hace cada comando:
|
|
513
513
|
|
|
514
|
-
- `/run list` muestra las
|
|
514
|
+
- `/run list` muestra las ejecuciones guardadas.
|
|
515
515
|
- `/run show <run-id>` muestra resumen, estado, tareas y ultimos mensajes.
|
|
516
|
-
- `/run tasks <run-id>` muestra todas las tareas de la
|
|
516
|
+
- `/run tasks <run-id>` muestra todas las tareas de la ejecucion.
|
|
517
517
|
- `/run task <task-id>` muestra una tarea concreta con sus mensajes y resultados.
|
|
518
|
-
- `/run
|
|
518
|
+
- `/run equipo <run-id> frontend` muestra solo el area `frontend`.
|
|
519
519
|
- `/run messages <run-id>` muestra la bitacora completa.
|
|
520
520
|
- `/run resume <run-id>` ejecuta tareas listas.
|
|
521
|
-
- `/run cancel <run-id>` detiene la
|
|
521
|
+
- `/run cancel <run-id>` detiene la ejecucion.
|
|
522
522
|
- `/run retry <run-id>` reintenta tareas fallidas o bloqueadas.
|
|
523
523
|
- `/run retry <run-id> <task-id>` reintenta una tarea concreta.
|
|
524
524
|
- `/run cancel-task <task-id>` bloquea una tarea para que no continue.
|
|
525
525
|
- `/run reassign <task-id> openai/backend-lead` cambia el agente responsable.
|
|
526
526
|
|
|
527
|
-
Estados de una
|
|
527
|
+
Estados de una ejecucion:
|
|
528
528
|
|
|
529
529
|
- `planned`: fue creada pero aun no se ejecuto.
|
|
530
530
|
- `in_progress`: esta en ejecucion.
|
|
@@ -570,8 +570,8 @@ Estados de una tarea:
|
|
|
570
570
|
|
|
571
571
|
Notas importantes:
|
|
572
572
|
|
|
573
|
-
- Si `/workspace setup` solo asigno agente a `frontend` y `backend`, los
|
|
574
|
-
- El reporte final que ves al terminar viene del orquestador global. Si quieres ver lo que cada orquestador local respondio, usa `/run messages <run-id>` o `/run
|
|
573
|
+
- Si `/workspace setup` solo asigno agente a `frontend` y `backend`, los equipos `docs` y `planning` apareceran como `blocked` con warnings al planear. **No es un error**: las tareas ready se ejecutan igual al pulsar Enter, y las bloqueadas las puedes asignar despues con `/team equipo core-dev docs <provider>/<agent>` y reintentar con `/run retry <run-id>`.
|
|
574
|
+
- El reporte final que ves al terminar viene del orquestador global. Si quieres ver lo que cada orquestador local respondio, usa `/run messages <run-id>` o `/run equipo <run-id> <equipo>`.
|
|
575
575
|
|
|
576
576
|
## Seleccion automatica y fallback
|
|
577
577
|
|
|
@@ -656,14 +656,14 @@ Ademas de perfiles y credenciales de providers, ahi se guardan:
|
|
|
656
656
|
- `provider_agents`: agentes por proveedor/perfil
|
|
657
657
|
- `provider_agent_capabilities`: capacidades declaradas de agentes
|
|
658
658
|
- `teams`: equipos
|
|
659
|
-
- `
|
|
660
|
-
- `
|
|
661
|
-
- `orchestration_runs`:
|
|
659
|
+
- `team_units`: equipos internos dentro de un team
|
|
660
|
+
- `team_unit_members`: miembros de cada equipo interno
|
|
661
|
+
- `orchestration_runs`: ejecuciones
|
|
662
662
|
- `orchestration_tasks`: tareas
|
|
663
663
|
- `orchestration_messages`: bitacora de decisiones y eventos
|
|
664
664
|
- `orchestration_task_results`: resultados por tarea
|
|
665
|
-
- `
|
|
666
|
-
- `orchestration_run_reports`: reporte consolidado de una
|
|
665
|
+
- `orchestration_team_reports`: reportes por equipo interno
|
|
666
|
+
- `orchestration_run_reports`: reporte consolidado de una ejecucion
|
|
667
667
|
- `secure_storage`: credenciales cifradas y configuracion sensible de providers, Telegram y WhatsApp en Windows/Linux
|
|
668
668
|
|
|
669
669
|
## Limitaciones actuales
|
|
@@ -671,7 +671,7 @@ Ademas de perfiles y credenciales de providers, ahi se guardan:
|
|
|
671
671
|
- La calidad de la ejecucion depende de que cada agente tenga perfil, modelo y credenciales validas.
|
|
672
672
|
- La seleccion automatica ya existe, pero las politicas personalizadas editables todavia no estan persistidas con `/policy create`.
|
|
673
673
|
- El fallback es auditable y controlado, no un sistema de retries infinitos.
|
|
674
|
-
- Si varios proveedores producen respuestas incompatibles, el usuario debe revisar el consolidado antes de cerrar la
|
|
674
|
+
- Si varios proveedores producen respuestas incompatibles, el usuario debe revisar el consolidado antes de cerrar la ejecucion.
|
|
675
675
|
|
|
676
676
|
## Puentes con mensajería móvil
|
|
677
677
|
|
|
@@ -832,23 +832,23 @@ En este ejemplo:
|
|
|
832
832
|
- `frontend` queda asignado a Claude.
|
|
833
833
|
- `backend` queda asignado a OpenAI.
|
|
834
834
|
|
|
835
|
-
Si quieres hacerlo a mano, todavia puedes usar `/workspace enable`, `/agent create`, `/agent set-role`, `/team create`, `/team orchestrator` y `/team
|
|
835
|
+
Si quieres hacerlo a mano, todavia puedes usar `/workspace enable`, `/agent create`, `/agent set-role`, `/team create`, `/team orchestrator` y `/team equipo`. El wizard solo junta esos pasos para evitar errores.
|
|
836
836
|
|
|
837
|
-
### 4. Crear una
|
|
837
|
+
### 4. Crear una ejecucion y revisar el plan en pantalla
|
|
838
838
|
|
|
839
839
|
```sh
|
|
840
840
|
/orchestrate core-dev crear login con UI y API
|
|
841
841
|
```
|
|
842
842
|
|
|
843
|
-
A diferencia de versiones anteriores, **`/orchestrate` no se queda en silencio**: te muestra una vista resumen con la
|
|
843
|
+
A diferencia de versiones anteriores, **`/orchestrate` no se queda en silencio**: te muestra una vista resumen con la ejecucion creada, las tareas por equipo, advertencias y un prompt:
|
|
844
844
|
|
|
845
845
|
```text
|
|
846
846
|
Plan listo para core-dev
|
|
847
|
-
|
|
847
|
+
Ejecucion: 1b4fb901-...
|
|
848
848
|
Objetivo: crear login con UI y API
|
|
849
849
|
Orquestador global: openai/backend-lead
|
|
850
850
|
|
|
851
|
-
Tareas por
|
|
851
|
+
Tareas por equipo
|
|
852
852
|
- backend -> ready | assigned=openai/backend-lead
|
|
853
853
|
- docs -> blocked | assigned=sin asignar
|
|
854
854
|
- frontend -> ready | assigned=claude/frontend-lead
|
|
@@ -857,22 +857,22 @@ Tareas por dominio
|
|
|
857
857
|
Listas: 2 | Bloqueadas: 2
|
|
858
858
|
|
|
859
859
|
Advertencias
|
|
860
|
-
- docs: warning -> No hay agente asignable para este
|
|
861
|
-
- planning: warning -> No hay agente asignable para este
|
|
860
|
+
- docs: warning -> No hay agente asignable para este equipo.
|
|
861
|
+
- planning: warning -> No hay agente asignable para este equipo.
|
|
862
862
|
|
|
863
863
|
[Enter] Ejecutar ahora (las bloqueadas se omiten) | [Esc] Solo planificar
|
|
864
864
|
```
|
|
865
865
|
|
|
866
866
|
### 5. Decidir: ejecutar ya, o revisar y ejecutar despues
|
|
867
867
|
|
|
868
|
-
- **Pulsa `Enter`** y empezara la ejecucion al instante. Solo se disparan las tareas `ready`. Mientras corren, veras lineas de progreso por
|
|
869
|
-
- **Pulsa `Esc`** si prefieres revisar antes. La
|
|
868
|
+
- **Pulsa `Enter`** y empezara la ejecucion al instante. Solo se disparan las tareas `ready`. Mientras corren, veras lineas de progreso por equipo. Al final llega el reporte consolidado.
|
|
869
|
+
- **Pulsa `Esc`** si prefieres revisar antes. La ejecucion queda en `planned`. Despues puedes inspeccionarla con:
|
|
870
870
|
|
|
871
871
|
```sh
|
|
872
872
|
/run show <run-id>
|
|
873
873
|
/run tasks <run-id>
|
|
874
|
-
/run
|
|
875
|
-
/run
|
|
874
|
+
/run equipo <run-id> frontend
|
|
875
|
+
/run equipo <run-id> backend
|
|
876
876
|
```
|
|
877
877
|
|
|
878
878
|
Si una tarea aparece `blocked`, normalmente falta agente, workspace, perfil, modelo o credencial. Asigna lo que falte y vuelve.
|
|
@@ -954,7 +954,7 @@ Si todo termino bien:
|
|
|
954
954
|
/run show <run-id>
|
|
955
955
|
```
|
|
956
956
|
|
|
957
|
-
Si necesitas detener la
|
|
957
|
+
Si necesitas detener la ejecucion:
|
|
958
958
|
|
|
959
959
|
```sh
|
|
960
960
|
/run cancel <run-id>
|
|
@@ -977,7 +977,7 @@ Si necesitas detener la corrida:
|
|
|
977
977
|
/orchestrate core-dev crear login con UI y API
|
|
978
978
|
# Aqui ves el plan en pantalla.
|
|
979
979
|
# [Enter] ejecuta ya y muestra el reporte final.
|
|
980
|
-
# [Esc] te deja la
|
|
980
|
+
# [Esc] te deja la ejecucion en 'planned'; ejecuta despues con /run resume <run-id>.
|
|
981
981
|
|
|
982
982
|
/run messages <run-id> # bitacora completa cuando quieras revisarla
|
|
983
983
|
```
|
|
@@ -988,21 +988,21 @@ Sintomas comunes despues de `/orchestrate` o `/run resume`, y como salir de cada
|
|
|
988
988
|
|
|
989
989
|
### "El plan se quedo en `planned` y no pasa nada"
|
|
990
990
|
|
|
991
|
-
Pulsaste `Esc` (o cerraste la vista) en lugar de `Enter`. La
|
|
991
|
+
Pulsaste `Esc` (o cerraste la vista) en lugar de `Enter`. La ejecucion existe pero no se ejecuto. Reanuda cuando quieras:
|
|
992
992
|
|
|
993
993
|
```sh
|
|
994
994
|
/run resume <run-id>
|
|
995
995
|
```
|
|
996
996
|
|
|
997
|
-
### "Aparecen
|
|
997
|
+
### "Aparecen equipos `blocked` que yo no pedi"
|
|
998
998
|
|
|
999
|
-
Cuando creas un team con `/workspace setup` y solo das agente a algunos
|
|
999
|
+
Cuando creas un team con `/workspace setup` y solo das agente a algunos equipos (por ejemplo `frontend` y `backend`), los demas (`docs`, `planning`, etc.) se crean igual y quedan sin asignar. Al planear se reportan como `blocked` con el warning `No hay agente asignable para este equipo.`. Tienes dos salidas:
|
|
1000
1000
|
|
|
1001
|
-
- **Ignorarlos**: pulsas Enter, las tareas `ready` se ejecutan y las `blocked` se quedan asi. La
|
|
1001
|
+
- **Ignorarlos**: pulsas Enter, las tareas `ready` se ejecutan y las `blocked` se quedan asi. La ejecucion se reporta como `failed` o `completed` segun lo que avance.
|
|
1002
1002
|
- **Asignar agente y reintentar**:
|
|
1003
1003
|
```sh
|
|
1004
|
-
/team
|
|
1005
|
-
/team
|
|
1004
|
+
/team equipo <team> docs <provider>/<agent>
|
|
1005
|
+
/team equipo <team> planning <provider>/<agent>
|
|
1006
1006
|
/run retry <run-id>
|
|
1007
1007
|
```
|
|
1008
1008
|
|
|
@@ -1032,7 +1032,7 @@ Verifica el estado del perfil:
|
|
|
1032
1032
|
|
|
1033
1033
|
Si falta token, modelo o base URL, vuelve a `/login` y `/model` para ese perfil. La tarea queda `blocked` hasta que el agente tenga todo lo que necesita.
|
|
1034
1034
|
|
|
1035
|
-
### "Quiero detener una
|
|
1035
|
+
### "Quiero detener una ejecucion en marcha"
|
|
1036
1036
|
|
|
1037
1037
|
```sh
|
|
1038
1038
|
/run cancel <run-id>
|
|
@@ -1042,11 +1042,11 @@ Si falta token, modelo o base URL, vuelve a `/login` y `/model` para ese perfil.
|
|
|
1042
1042
|
|
|
1043
1043
|
```sh
|
|
1044
1044
|
/run messages <run-id>
|
|
1045
|
-
/run
|
|
1045
|
+
/run equipo <run-id> <equipo>
|
|
1046
1046
|
/run task <task-id>
|
|
1047
1047
|
```
|
|
1048
1048
|
|
|
1049
|
-
`/run messages` te lista en orden cronologico todos los `global-plan`, `squad-plan`, `
|
|
1049
|
+
`/run messages` te lista en orden cronologico todos los `global-plan`, `squad-plan`, `task.completed`, `run-report` y eventos de policy de la ejecucion.
|
|
1050
1050
|
|
|
1051
1051
|
## Servidores MCP externos
|
|
1052
1052
|
|
|
@@ -1094,7 +1094,7 @@ Pasos a tener en cuenta:
|
|
|
1094
1094
|
- Los servidores MCP corren con tus permisos. Si conectas a una DB de produccion, considera dar al servidor solo credenciales de lectura.
|
|
1095
1095
|
- Variables sensibles: usa `-e VAR=valor` al registrar el server stdio para inyectar tokens sin que queden en el comando visible.
|
|
1096
1096
|
- Las herramientas MCP aparecen en los agentes con prefijo `mcp__<name>__<tool>`. Puedes restringir cuales se autorizan con `--allowedTools` al iniciar la sesion.
|
|
1097
|
-
- Si un
|
|
1097
|
+
- Si un equipo (`database`, por ejemplo) tendria que usar este MCP, asignale un agente con `/team equipo <team> database <provider>/<agent>` y el orquestador local lo invocara cuando el plan lo requiera.
|
|
1098
1098
|
|
|
1099
1099
|
### Diferencia con el storage interno
|
|
1100
1100
|
|