e703bdd608
- ko added to SUPPORTED_LOCALES and every enumeration site (config, settings enum, help text, tests); Korean catalogs authored for all current keys; CLI bundles regenerated for 6 locales; 한국어 endonym - README translated into zh-CN, zh-TW, fr, es, ko; every README carries a language-switcher line and the localized ones note that English is canonical Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
470 lines
27 KiB
Markdown
470 lines
27 KiB
Markdown
<div align="center">
|
|
|
|
<img src="./demo/assets/fusion-logo.png" alt="Fusion" width="120" />
|
|
|
|
# Fusion
|
|
|
|
### De idea inicial a código en producción — automáticamente.
|
|
|
|
**Orquestador de agentes multinodo** — tareas, agentes, misiones, git, archivos y worktrees, con cualquier modelo, local o en la nube.
|
|
|
|
[**runfusion.ai →**](https://runfusion.ai) · [Docs](./docs/README.md) · [GitHub](https://github.com/Runfusion/Fusion) · [npm](https://www.npmjs.com/package/@runfusion/fusion) · [Discord](https://discord.gg/ksrfuy7WYR)
|
|
|
|
[English](./README.md) · [简体中文](./README.zh-CN.md) · [繁體中文](./README.zh-TW.md) · [Français](./README.fr.md) · **Español** · [한국어](./README.ko.md)
|
|
|
|
*Esta es una traducción automática; el README en inglés es el documento canónico.*
|
|
|
|
[](./LICENSE)
|
|
[](https://www.npmjs.com/package/@runfusion/fusion)
|
|
[](https://discord.gg/ksrfuy7WYR)
|
|
|
|
|
|
|
|
<br />
|
|
|
|
<img src="./demo/assets/fusion-reel.gif" alt="Demo de Fusion: de idea inicial a código en producción" width="900" />
|
|
|
|
<br />
|
|
<br />
|
|
|
|
<a href="https://runfusion.ai">
|
|
<img src="https://runfusion.ai/fusion-dashboard.png" alt="Panel de Fusion: columnas kanban de Planificación, Pendiente, En progreso, En revisión y Listo con tarjetas de tarea activas" width="900" />
|
|
</a>
|
|
|
|
</div>
|
|
|
|
---
|
|
|
|
## Todo tu entorno de desarrollo. En una sola pantalla.
|
|
|
|
Describe una tarea en lenguaje natural. Un agente de planificación lee tu proyecto, comprende el contexto y escribe un plan completo en `PROMPT.md` — pasos, alcance de archivos, criterios de aceptación. Luego Fusion planifica, revisa, ejecuta y vuelve a revisar, en un worktree de git aislado, con una aprobación humana donde tú la necesites.
|
|
|
|
Un tablero. Controlado desde cualquier lugar. Laptop, Mac mini, servidor Linux, VM en la nube, teléfono — todo conectado.
|
|
|
|
> Como Trello, pero tus tareas son especificadas, ejecutadas y entregadas por IA. Construido sobre el gran trabajo de [dustinbyrne/kb](https://github.com/dustinbyrne/kb).
|
|
|
|
---
|
|
|
|
## El flujo
|
|
|
|
```
|
|
① Describir ② Planificación ③ El tablero ④ Worktree aislado
|
|
───────────── ───────────── ───────────── ─────────────────────
|
|
"Agregar modo → El agente escribe → Plan → Revisión → → rama fusion/FN-123
|
|
oscuro al PROMPT.md Ejecución → concurrente, cero
|
|
panel de (pasos, alcance, Revisión (por conflictos de
|
|
configuración" aceptación) paso, hasta archivos
|
|
terminar)
|
|
```
|
|
|
|
### Ve cada paso antes del merge
|
|
|
|
<div align="center">
|
|
<img src="https://runfusion.ai/screenshot-task-detail.png" alt="Detalle de tarea en Fusion: pasos del flujo visibles en una tarea en progreso con diffs y cambios de archivos" width="820" />
|
|
</div>
|
|
|
|
Cada tarea muestra su plan, sus revisiones, sus diffs y sus cambios de archivos en tiempo real. Entra a una tarea activa y ajusta la dirección, refina las restricciones, pausa o reescribe el prompt.
|
|
|
|
---
|
|
|
|
## Qué lo hace diferente
|
|
|
|
| | |
|
|
|---|---|
|
|
| 🧠 **Planificación con IA** | Describe una tarea en lenguaje natural. Los agentes de planificación la convierten en un plan `PROMPT.md` con pasos, alcance de archivos y criterios de aceptación. |
|
|
| 🔁 **Puertas de flujo** | Plan → Revisión → Ejecución → Revisión en cada paso. Las puertas previas al merge bloquean código deficiente; las posteriores ejecutan verificaciones informativas. |
|
|
| 🌳 **Aislamiento con worktrees** | Cada tarea corre en su propia rama y worktree (`fusion/{task-id}`). Tareas en paralelo. Cero conflictos. Delegación opcional a [worktrunk](https://github.com/max-sixty/worktrunk) mediante [`worktrunk.enabled`](./docs/settings-reference.md#worktree-backend-settings) (ver [abstracción WorktreeBackend](./docs/architecture.md#worktreebackend-abstraction)). |
|
|
| ⚡ **Merge inteligente** | ¿Pasa todas las puertas? Fusion hace squash-merge y avanza. Habilita aprobación manual en cualquier punto. |
|
|
| 🛰️ **Malla multinodo** | Laptop, Mac mini, servidor Linux, VM en la nube, teléfono — todos sincronizados. Escritorio, móvil, web. |
|
|
| 🧩 **Cualquier modelo** | Anthropic, OpenAI, Ollama y más. Local y en la nube coexisten. |
|
|
| 🏢 **Empresas de agentes** | Importa equipos predefinidos — más de 440 agentes en 16 empresas — y ejecútalos de forma autónoma durante semanas. |
|
|
| 📬 **Mensajería entre agentes** | Buzón incorporado entre agentes. Delega, aclara, coordina. |
|
|
| 🗨️ **Salas de chat multiagente** | Conversaciones grupales con alcance de proyecto donde varios miembros de la sala pueden responder: los miembros mencionados son respondedores directos, y miembros ambientales adicionales pueden responder hasta un límite. Actualmente **experimental** — habilita `chatRooms` en **Configuración → Funciones experimentales → Salas de chat**. ([Documentación de salas de chat](./docs/dashboard-guide.md#chat-rooms)) |
|
|
| 🗺️ **Misiones** | Planificación jerárquica (Misión → Hito → Slice → Característica → Tarea) con piloto automático y contratos de validación. |
|
|
| 🔬 **Investigación** | Ejecuciones de investigación delimitadas con búsqueda web, GitHub, documentación local y síntesis con LLM (además de soporte integrado en tiempo de ejecución para WebSearch/WebFetch en flujos de planificación y síntesis cuando está disponible). Convierte los hallazgos en tareas. ([Documentación](./docs/research.md)) |
|
|
| 🧪 **Automejora** | Los agentes reflexionan sobre su propio resultado y actualizan sus prompts a medida que aprenden tu base de código. |
|
|
| 🔓 **Código abierto. MIT.** | Sin dependencia de proveedor. Ejecútalo en tu propio hardware. Se actualiza semanalmente. |
|
|
|
|
---
|
|
|
|
## Cómo funciona
|
|
|
|
```mermaid
|
|
graph TD
|
|
H((Tú)) -->|idea inicial| T["Planificación<br/><i>planificación automática</i>"]
|
|
T --> TD["Pendiente<br/><i>programado para ejecución</i>"]
|
|
TD --> IP["En progreso<br/><i>para cada paso:<br/>planificar, revisar, ejecutar, revisar</i>"]
|
|
|
|
subgraph IP["En progreso"]
|
|
direction TD
|
|
NS([Iniciar paso]) --> P[Planificar]
|
|
P --> R1{Revisar}
|
|
R1 -->|revisar| P
|
|
R1 -->|aprobar| E[Ejecutar]
|
|
E --> R2{Revisar}
|
|
R2 -->|revisar| E
|
|
R2 -->|siguiente paso| NS
|
|
R2 -->|repensar| P
|
|
end
|
|
|
|
R2 -->|listo| IR["En revisión<br/><i>listo para merge,<br/>o completado automáticamente</i>"]
|
|
IR -->|squash merge directo<br/>o PR mergeado| D["Listo"]
|
|
|
|
style H fill:#161b22,stroke:#8b949e,color:#e6edf3
|
|
style T fill:#2d2006,stroke:#d29922,color:#d29922
|
|
style TD fill:#0d2044,stroke:#58a6ff,color:#58a6ff
|
|
style IP fill:#1a0d2e,stroke:#bc8cff,color:#bc8cff
|
|
style P fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3
|
|
style R1 fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3
|
|
style E fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3
|
|
style R2 fill:#1a0d2e,stroke:#bc8cff,color:#e6edf3
|
|
style NS fill:#1a0d2e,stroke:#bc8cff,color:#bc8cff
|
|
style IR fill:#0d2d16,stroke:#3fb950,color:#3fb950
|
|
style D fill:#1a1a1a,stroke:#8b949e,color:#8b949e
|
|
```
|
|
|
|
Las tareas con dependencias se procesan secuencialmente. Las tareas independientes se ejecutan en paralelo. Opcionalmente puedes requerir aprobación manual antes de que las tareas pasen de Planificación a Pendiente (configuración `requirePlanApproval`).
|
|
|
|
---
|
|
|
|
## Multinodo. Un tablero. Todas las plataformas.
|
|
|
|
<div align="center">
|
|
|
|
<img src="./demo/assets/fusion-mesh.gif" alt="Malla de Fusion: laptop, Mac mini, servidor Linux, VM en la nube, teléfono — todos sincronizados" width="820" />
|
|
|
|
<br />
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
</div>
|
|
|
|
Laptop, Mac mini, servidor Linux, VM en la nube, teléfono — cada nodo es un par. El estado de tus tareas, agentes, registros y diffs permanecen sincronizados en toda la malla. El mismo Fusion se distribuye como:
|
|
|
|
- 🖥️ **Aplicación de escritorio** — Electron para **macOS** (Intel + Apple Silicon), **Windows** 10/11 y **Linux**
|
|
- 📱 **Aplicación móvil** — Capacitor para **iOS/iPadOS** y **Android** ([MOBILE.md](./MOBILE.md))
|
|
- 🌐 **Panel web** — cualquier navegador moderno, servido desde el daemon `fn dashboard`
|
|
- 🔌 **CLI** — binario `fn` + extensión para flujos de trabajo centrados en la terminal
|
|
|
|
Inicia el daemon en cualquier nodo, conecta tus otros dispositivos y el tablero te sigue a todas partes.
|
|
|
|
---
|
|
|
|
## Ejecuta una empresa de agentes
|
|
|
|
<div align="center">
|
|
|
|
<img src="./demo/assets/fusion-company-reel.gif" alt="Empresa de agentes Fusion: importa un equipo y ejecútalo de forma autónoma durante semanas" width="820" />
|
|
|
|
</div>
|
|
|
|
Importa un equipo. Ejecútalo de forma autónoma durante semanas. **Más de 440 agentes en 16 empresas**, preparados para misiones, buzones y delegación entre agentes.
|
|
|
|
```bash
|
|
npx companies.sh add paperclipai/companies/gstack
|
|
```
|
|
|
|
---
|
|
|
|
## Compatible con las herramientas que ya usas.
|
|
|
|
Fusion se integra con las herramientas que ya conoces. **Hermes**, **Paperclip** y **OpenClaw** vienen como plugins de primera clase — enruta cualquier espacio de trabajo al entorno de ejecución que mejor se adapte a la tarea. Y cualquier empresa de agentes de Paperclip se importa con un solo comando.
|
|
|
|
<div align="center">
|
|
<img src="./demo/assets/hermes-logo.svg" alt="Hermes" height="56" />
|
|
</div>
|
|
|
|
### [Hermes](https://hermes-agent.nousresearch.com) <sub>`experimental`</sub>
|
|
|
|
<sub>Nous Research</sub>
|
|
|
|
El agente autónomo de código abierto de **Nous Research**. Instala el plugin de Hermes y ejecuta agentes a través de Hermes para trabajos de larga duración con contexto creciente — enruta cualquier espacio de trabajo de Fusion hacia él.
|
|
|
|
### OpenClaw <sub>`experimental`</sub>
|
|
|
|
El soporte del entorno de ejecución de OpenClaw está disponible como plugin experimental (`fusion-plugin-openclaw-runtime`) para paridad en el descubrimiento y la configuración del entorno. Configura los agentes con `runtimeConfig.runtimeHint: "openclaw"` después de instalar el plugin.
|
|
|
|
<br />
|
|
|
|
<div align="center">
|
|
<img src="./demo/assets/paperclip-logo.svg" alt="Paperclip" height="56" />
|
|
</div>
|
|
|
|
### [Paperclip](https://paperclip.ing) <sub>`experimental`</sub>
|
|
|
|
<sub>paperclip.ing</sub>
|
|
|
|
El plano de control humano para la mano de obra de IA. Instala el plugin de Paperclip para ejecutar agentes a través de Paperclip dentro de Fusion.
|
|
|
|
Fusion también soporta nativamente el estándar de empresa de agentes **[`companies.sh`](https://github.com/paperclipai/companies)**: importa un equipo predefinido — **más de 440 agentes en 16 empresas** — y déjalos coordinarse a través del buzón, las misiones y las puertas de flujo de Fusion durante semanas de trabajo autónomo. El mismo formato de empresa, los mismos agentes, las mismas habilidades que Paperclip.
|
|
|
|
```bash
|
|
npx companies.sh add paperclipai/companies/gstack
|
|
```
|
|
|
|
<br />
|
|
|
|
> **Hermes**, **Paperclip** y **OpenClaw** son plugins de entorno de ejecución **experimentales** — las APIs y los formatos de comunicación pueden cambiar entre versiones menores.
|
|
|
|
---
|
|
|
|
## Inicio rápido
|
|
|
|
**Sin instalación, directo desde npm:**
|
|
|
|
```bash
|
|
npx runfusion.ai
|
|
```
|
|
|
|
Esto lanza el panel. Los subcomandos se pasan directamente: `npx runfusion.ai task create "fix X"`, `npx runfusion.ai --help`, etc. (O de forma explícita: `npx @runfusion/fusion dashboard`.)
|
|
|
|
**Instalador en una línea** (macOS y Linux — usa Homebrew automáticamente, recurre a npm como alternativa):
|
|
|
|
```bash
|
|
curl -fsSL https://runfusion.ai/install.sh | sh
|
|
fusion dashboard
|
|
```
|
|
|
|
**Homebrew** (macOS y Linux):
|
|
|
|
```bash
|
|
brew tap runfusion/fusion
|
|
brew install fusion
|
|
fusion dashboard # o: fn dashboard
|
|
```
|
|
|
|
O en una sola línea (añade el tap automáticamente): `brew install runfusion/fusion/fusion`.
|
|
|
|
**npm global**:
|
|
|
|
```bash
|
|
npm install -g @runfusion/fusion
|
|
fn dashboard # o: fusion dashboard
|
|
```
|
|
|
|
**Desde un clon** (para desarrollo):
|
|
|
|
```bash
|
|
pnpm dev dashboard
|
|
```
|
|
|
|
Luego haz clic en la URL `Open:` que aparece en la terminal. Incorpora un token de portador
|
|
(`http://localhost:4040/?token=fn_...`) que el navegador guarda en
|
|
`localStorage` en la primera visita y reutiliza automáticamente. En el lado del
|
|
servidor, Fusion ahora persiste el token del panel/daemon en
|
|
`~/.fusion/settings.json` en la primera ejecución autenticada y lo reutiliza en
|
|
inicios posteriores a menos que lo sobreescribas (`--token`, `FUSION_DASHBOARD_TOKEN`,
|
|
`FUSION_DAEMON_TOKEN`) o deshabilites la autenticación con `--no-auth`. Consulta
|
|
[Referencia CLI → fn dashboard → Autenticación](./docs/cli-reference.md#fn-dashboard)
|
|
para conocer la precedencia completa y las opciones de restablecimiento/revocación.
|
|
|
|
### Configuración inicial
|
|
|
|
En el primer lanzamiento, Fusion abre el **asistente de incorporación** con tres pasos guiados:
|
|
|
|
1. **Configuración de IA** — Usa una lista de proveedores simplificada para el inicio rápido (proveedores recomendados más los ya conectados), luego expande la **Configuración avanzada de proveedores** solo si necesitas proveedores adicionales o detalles de configuración. Solo necesitas un proveedor para comenzar. Las entradas de proveedor obsoletas de Google Gemini CLI / Antigravity están intencionalmente ocultas; las rutas de clave API de Google/Gemini, Google Generative AI, Vertex y Cloud Code permanecen disponibles.
|
|
2. **GitHub (Opcional)** — Conecta GitHub para importar issues y gestionar PRs
|
|
3. **Primera tarea** — Crea tu primera tarea o impórtala desde GitHub (si no hay ningún proyecto activo, la incorporación primero te pedirá que registres/selecciones un directorio de proyecto)
|
|
|
|
El asistente se puede **descartar y no bloquea** — haz clic en **Omitir por ahora** para usar el panel de inmediato. Vuélvelo a activar más tarde desde **Configuración → Autenticación → Reabrir guía de incorporación**.
|
|
|
|
### Móvil
|
|
|
|
Para el flujo de trabajo con Capacitor + PWA, consulta [MOBILE.md](./MOBILE.md).
|
|
|
|
---
|
|
|
|
## Documentación
|
|
|
|
| Guía | Qué cubre |
|
|
|---|---|
|
|
| [Primeros pasos](./docs/getting-started.md) | Instalación e incorporación |
|
|
| [Guía del panel](./docs/dashboard-guide.md) | Vistas de tablero/lista, terminal, gestor de git |
|
|
| [Gestión de tareas](./docs/task-management.md) | Ciclo de vida de la tarea y comandos CLI |
|
|
| [Referencia CLI](./docs/cli-reference.md) | Referencia completa de comandos y daemon |
|
|
| [Referencia de configuración](./docs/settings-reference.md) | Opciones de configuración |
|
|
| [Arquitectura](./docs/architecture.md) | Funcionamiento interno del sistema |
|
|
| [Agentes](./docs/agents.md) | Gestión de agentes, creación, latido |
|
|
| [Pasos del flujo](./docs/workflow-steps.md) | Puertas de calidad, plantillas, fases |
|
|
| [Misiones](./docs/missions.md) | Jerarquía de misiones, planificación, piloto automático |
|
|
| [Multiproyecto](./docs/multi-project.md) | Registro central, modos de aislamiento |
|
|
| [Docker](./docs/docker.md) | Despliegue en contenedores |
|
|
|
|
---
|
|
|
|
## Características principales
|
|
|
|
- **Planificación con IA** — El agente de planificación genera un `PROMPT.md` detallado con pasos, alcance de archivos y criterios de aceptación
|
|
- **Ejecución paso a paso** — Ciclo Plan → Revisión → Ejecución → Revisión para cada paso de la tarea
|
|
- **Aislamiento con worktrees de git** — Cada tarea corre en su propio worktree (rama `fusion/{task-id}`)
|
|
- **Pasos del flujo** — Puertas de calidad configurables (previas al merge: bloquean el merge; posteriores al merge: informativas)
|
|
- **Integración con GitHub** — Importar issues, crear PRs, insignias en tiempo real de PR/issue
|
|
- **Panel** — Tablero kanban en tiempo real, gestión de agentes, terminal, gestor de git, planificador de misiones
|
|
- **Misiones** — Planificación jerárquica (Misión → Hito → Slice → Característica → Tarea) con piloto automático, contratos de validación, reintentos de corrección de características y semántica de entrega bloqueada
|
|
- **Multiproyecto** — Gestiona múltiples proyectos desde una sola instalación con aislamiento de proyectos
|
|
- **Mensajería entre agentes** — Sistema de mensajería integrado para la coordinación entre agentes y usuarios
|
|
- **Salas de chat (experimental)** — Chat grupal con alcance de proyecto donde los miembros mencionados se enrutan como respondedores directos y miembros ambientales adicionales pueden responder hasta un límite (habilitar en **Configuración → Funciones experimentales → Salas de chat**; detalles en [Guía del panel → Salas de chat](./docs/dashboard-guide.md#chat-rooms))
|
|
|
|
### Autenticación de proveedores
|
|
|
|
Fusion soporta autenticación basada en OAuth para proveedores de IA configurados en **Configuración → Autenticación**. Para la mayoría de los proveedores OAuth, cuando se accede al panel desde un host que no es localhost (nodo remoto, host/IP de LAN o proxy inverso), las URLs de inicio de sesión del proveedor se reescriben para enrutar los callbacks de OAuth a través de un endpoint puente (`/api/auth/oauth-callback`) de modo que las redirecciones lleguen a la sesión de navegador activa.
|
|
|
|
- **Anthropic (Claude)** — Usa un flujo de código de autorización pegado en Configuración/incorporación: inicia sesión y pega la URL de redirección final (o el código) de vuelta en Fusion para completar el inicio de sesión
|
|
- **OpenAI Codex** — Usa el mismo flujo de código de autorización pegado con validación segura de estado
|
|
- **Factory AI — mediante Droid CLI** *(opcional)* — requiere instalación local de Droid CLI + `droid auth login`; la detección sigue la ruta efectiva del binario en tiempo de ejecución (predeterminado `droid`, o `droidBinaryPath` del plugin cuando está configurado), luego habilita en **Configuración → Autenticación** y reinicia Fusion
|
|
- **llama.cpp — mediante servidor HTTP** *(opcional)* — configura la URL de tu servidor llama.cpp (predeterminado `http://127.0.0.1:8080`) y la clave API opcional, luego habilita en **Configuración → Autenticación**
|
|
- **Otros proveedores** — Autentícate mediante entrada de clave API en Configuración (incluidas la clave API de Google/Gemini, Google Generative AI, Vertex y los alias de Cloud Code)
|
|
|
|
### Sistema de modelos
|
|
|
|
Fusion usa una jerarquía de modelos de doble alcance con cinco canales independientes. La configuración global define los valores predeterminados de referencia; la configuración de proyecto proporciona sobreescrituras por proyecto.
|
|
|
|
| Canal | Propósito | Claves de referencia global | Claves de sobreescritura por proyecto |
|
|
|------|---------|---------------------|----------------------|
|
|
| Executor | Agente de ejecución de tareas | `executionGlobalProvider` + `executionGlobalModelId` | `executionProvider` + `executionModelId` |
|
|
| Planning | Agente de planificación de tareas | `planningGlobalProvider` + `planningGlobalModelId` | `planningProvider` + `planningModelId` |
|
|
| Validator | Revisor de plan/código | `validatorGlobalProvider` + `validatorGlobalModelId` | `validatorProvider` + `validatorModelId` |
|
|
| Title Summarization | Generación automática de títulos | `titleSummarizerGlobalProvider` + `titleSummarizerGlobalModelId` | `titleSummarizerProvider` + `titleSummarizerModelId` |
|
|
| Workflow Step Refinement | Refinamiento de prompts con IA | (usa `defaultProvider`/`defaultModelId`) | (usa `modelProvider`/`modelId` en WorkflowStep) |
|
|
|
|
**Sobreescrituras por tarea:** Las tareas pueden sobreescribir los canales de executor, validator y planning con campos de modelo por tarea (`modelProvider`/`modelId`, `validatorModelProvider`/`validatorModelId`, `planningModelProvider`/`planningModelId`).
|
|
|
|
**Precedencia:** Por tarea → Sobreescritura de proyecto → Canal global → `defaultProvider`/`defaultModelId` → Resolución automática.
|
|
|
|
Para la documentación completa de configuración, consulta la [Referencia de configuración](./docs/settings-reference.md).
|
|
|
|
### Tareas programadas / automatizaciones
|
|
|
|
Fusion soporta automatización de tareas programadas a través de los endpoints `/api/automations`. Las automatizaciones pueden ejecutar comandos de shell o flujos de trabajo de múltiples pasos en un horario configurable.
|
|
|
|
#### Alcance de la programación
|
|
|
|
Las automatizaciones y rutinas pueden ejecutarse en dos alcances:
|
|
|
|
- **Global** — Se ejecuta en todos los proyectos. Úsalo para mantenimiento entre proyectos, copias de seguridad o reportes unificados.
|
|
- **Proyecto** — Se ejecuta solo dentro de un proyecto específico. Úsalo para CI, pruebas o tareas de despliegue específicas del proyecto.
|
|
|
|
Cuando creas una programación sin elegir un alcance, Fusion usa por defecto el **alcance de proyecto** con el ID de proyecto `default` por compatibilidad con versiones anteriores.
|
|
|
|
Para especificar un alcance de forma explícita:
|
|
- En el modal de **Tareas programadas** del panel, usa el selector **Global / Proyecto**.
|
|
- Mediante la API, pasa `?scope=global` o `?scope=project&projectId=<id>` en los endpoints de automatización/rutina.
|
|
|
|
**Reglas de resolución de alcance:**
|
|
- `scope=global` siempre se resuelve en el canal de automatización/rutina global, independientemente del proyecto activo.
|
|
- `scope=project` requiere un `projectId`. Si se omite, vuelve a `"default"`.
|
|
- Las operaciones de CRUD, ejecución, activación/desactivación y webhook están estrictamente aisladas por alcance: una programación global no puede ser modificada desde una solicitud de alcance de proyecto, y viceversa.
|
|
|
|
**Orientación operativa para configuraciones multiproyecto:**
|
|
- Prefiere programaciones **globales** para infraestructura compartida (p. ej., copias de seguridad nocturnas, extracción de información de memoria).
|
|
- Prefiere programaciones de **proyecto** para automatización por repositorio (p. ej., ejecutores de pruebas por proyecto, hooks de despliegue).
|
|
- Los canales global y de proyecto son sondeados de forma independiente por el motor, por lo que las ejecuciones pendientes en un canal no bloquean al otro.
|
|
|
|
#### Automatizaciones
|
|
|
|
| Endpoint | Método | Descripción |
|
|
|---------|--------|-------------|
|
|
| `/api/automations` | GET | Listar todas las automatizaciones (filtradas por alcance si se especifica) |
|
|
| `/api/automations` | POST | Crear automatización (el alcance predeterminado es `project`) |
|
|
| `/api/automations/:id` | GET | Obtener automatización por ID |
|
|
| `/api/automations/:id` | PATCH | Actualizar automatización |
|
|
| `/api/automations/:id` | DELETE | Eliminar automatización |
|
|
| `/api/automations/:id/run` | POST | Activar ejecución manual |
|
|
| `/api/automations/:id/toggle` | POST | Activar/desactivar |
|
|
| `/api/automations/:id/steps/reorder` | POST | Reordenar pasos de la automatización |
|
|
|
|
#### Rutinas
|
|
|
|
Las rutinas son tareas de agente de IA activadas por programaciones cron, webhooks o ejecución manual. Las rutinas comparten el mismo modelo de alcance global/proyecto que las automatizaciones.
|
|
|
|
| Endpoint | Método | Descripción |
|
|
|---------|--------|-------------|
|
|
| `/api/routines` | GET | Listar todas las rutinas (filtradas por alcance si se especifica) |
|
|
| `/api/routines` | POST | Crear rutina (el alcance predeterminado es `project`) |
|
|
| `/api/routines/:id` | GET | Obtener rutina por ID |
|
|
| `/api/routines/:id` | PATCH | Actualizar rutina |
|
|
| `/api/routines/:id` | DELETE | Eliminar rutina |
|
|
| `/api/routines/:id/run` | POST | Activar manualmente |
|
|
| `/api/routines/:id/trigger` | POST | Activación manual canónica |
|
|
| `/api/routines/:id/runs` | GET | Obtener historial de ejecuciones |
|
|
| `/api/routines/:id/webhook` | POST | Activación por webhook (verificación de firma compatible) |
|
|
|
|
---
|
|
|
|
## Ejemplos rápidos de CLI
|
|
|
|
```bash
|
|
fn task create "Fix the login bug" # Entrada rápida → planificación
|
|
fn task plan "Build auth system" # Planificación guiada por IA
|
|
fn task import owner/repo --labels bug # Importar issues de GitHub
|
|
fn task show FN-001 # Ver detalles de la tarea
|
|
fn task logs FN-001 --follow # Transmitir registros de ejecución
|
|
fn task steer FN-001 "Use TypeScript" # Guiar al agente durante la ejecución
|
|
|
|
fn project add my-app /path/to/app # Registrar un proyecto
|
|
fn project list # Listar todos los proyectos
|
|
|
|
fn settings set maxConcurrent 4 # Configurar ajustes
|
|
fn settings export # Exportar configuración
|
|
|
|
fn mission create "Auth System" "Build auth" # Crear misión
|
|
fn mission activate-slice <slice-id> # Activar un slice
|
|
|
|
fn skills search react # Buscar en skills.sh
|
|
fn skills install firebase/agent-skills # Instalar habilidades de agente
|
|
```
|
|
|
|
---
|
|
|
|
## Paquetes
|
|
|
|
| Paquete | Descripción |
|
|
|---------|-------------|
|
|
| `@fusion/core` | Modelo de dominio — tareas, columnas del tablero, almacén SQLite |
|
|
| `@fusion/dashboard` | Interfaz web — servidor Express + tablero kanban con SSE |
|
|
| `@fusion/engine` | Motor de IA — planificación, ejecución, programación, pasos del flujo |
|
|
| `@runfusion/fusion` | CLI + extensión — publicado en npm |
|
|
|
|
---
|
|
|
|
## Desarrollo
|
|
|
|
```bash
|
|
pnpm install # Instalar dependencias
|
|
pnpm local # Iniciar panel/API local en un puerto distinto al 4040
|
|
pnpm local -- --engine # Iniciar panel local con el motor de IA
|
|
pnpm build # Compilar paquetes del espacio de trabajo predeterminado (excluye escritorio/móvil)
|
|
pnpm build:all # Compilar todos los paquetes (incluyendo escritorio/móvil)
|
|
pnpm dev dashboard # Ejecutar panel + motor de IA
|
|
pnpm dev:ui # Solo el panel (sin motor de IA)
|
|
pnpm lint # Verificar estilo de código en todos los paquetes
|
|
pnpm typecheck # Verificar tipos en todos los paquetes
|
|
pnpm test # Ejecutar todas las pruebas
|
|
```
|
|
|
|
### Compilar un ejecutable independiente
|
|
|
|
Compila un binario `fn` autocontenido usando [Bun](https://bun.sh/):
|
|
|
|
```bash
|
|
pnpm build:exe # Compilar para la plataforma actual
|
|
pnpm build:exe:all # Compilación cruzada para todas las plataformas
|
|
```
|
|
|
|
---
|
|
|
|
## Licencia
|
|
|
|
MIT — código abierto, sin dependencia de proveedor. Ver [LICENSE](./LICENSE).
|
|
|
|
<div align="center">
|
|
|
|
**[runfusion.ai →](https://runfusion.ai)**
|
|
|
|
</div>
|