@abelxiaoxing/cadence 2.1.0 → 2.1.2

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.de.md CHANGED
@@ -2,119 +2,115 @@
2
2
 
3
3
  [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Deutsch](README.de.md) · [Français](README.fr.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [Русский](README.ru.md)
4
4
 
5
- Cadence macht [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) zu einem dauerhaften Aufgaben-Workspace.
6
- Plane eine Code-Aufgabe, lass Subagents daran arbeiten, führe deine Checks aus und prüfe das Ergebnis im Pi-Terminal (`/cadence`) oder im Browser-WebUI; beide verbinden sich mit demselben Hintergrunddienst.
5
+ Cadence macht [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) zu einem gesprächsgesteuerten Engineering-Workflow: `/cadence [Ziel]` eingeben, das Ergebnis einmal abstimmen, und ein dauerhafter Owner setzt um, repariert und prüft.
6
+ Im Terminal oder in der optionalen WebUI.
7
+
8
+ ## So funktioniert es
9
+
10
+ ```mermaid
11
+ flowchart TD
12
+ A["/cadence Ziel"] --> B["Nur lesend untersuchen"]
13
+ B --> C["Abstimmen, einmal freigeben"]
14
+ C --> D["Unabhängige Aufgaben parallel in Worktrees"]
15
+ D --> E["Echte Prüfungen + automatisches Agent-Review"]
16
+ E -->|"bestanden"| F["Lokal in deinen Branch mergen"]
17
+ E -->|"fehlgeschlagen"| G["Selbst korrigieren"]
18
+ G --> D
19
+ F --> H["Wissen pflegen (festes Budget)"]
20
+ H -.-> B
21
+ ```
22
+
23
+ ```mermaid
24
+ flowchart LR
25
+ A["Prüfung schlägt fehl"] --> B["Reparieren"] --> C["Route neu planen"] --> D["Abweichung erfassen"] --> E["Stopp nur bei äußeren Bedingungen"]
26
+ ```
27
+
28
+ ```mermaid
29
+ flowchart LR
30
+ T["Pi-Terminal"] <-->|"verbinden / trennen"| O[("Dauerhafter Owner")]
31
+ W["WebUI<br/>Board · Branches · Eingreifen"] <-->|"verbinden / trennen"| O
32
+ O --> X["Worker in Worktrees"] --> Y["Dein Branch"]
33
+ O -.-> K[".cadence/ Wissen"]
34
+ ```
7
35
 
8
36
  ## Warum Cadence
9
37
 
10
- - **Die Arbeit überlebt das Fenster.**
11
- Aufgaben laufen in einem Hintergrunddienst: Das Schließen des Terminals, das Beenden von Pi oder das Verlassen des Browser-Tabs trennt nur die Verbindung, und jeder Client kann sich erneut mit demselben Lauf verbinden.
12
- - **Nichts wird bearbeitet, bevor du zustimmst.**
13
- Eine Aufgabe analysiert zuerst schreibgeschützt und schlägt einen lesbaren Plan vor; Dateien ändern sich erst, nachdem du genau diesen Plan bestätigt hast.
14
- - **Ergebnisse, denen du vertrauen kannst.**
15
- Subagent-Ausgabe, echte Check-Läufe und deine eigene Prüfung bleiben getrennt: Modelltext oder ein „Done“ zählt nie als bestanden, und fehlgeschlagene, abgebrochene und unbekannte Ergebnisse bleiben unterscheidbar.
16
- - **Vollständige Historie.**
17
- Jeder Lauf behält seine Nachrichten, Tool-Aufrufe und Ausgaben, mit exakter Suche und vollständigem Markdown/NDJSON-Export; bekannte Geheimnisse werden maskiert.
18
- - **Ein Verlauf mit dem Terminal.**
19
- Browser-Unterhaltungen sind die Pi-Sitzungen des Projekts: Setzen Sie eine Terminal-Sitzung im Browser fort oder eine Browser-Sitzung mit `/resume`, und lesen Sie Pis Verzweigungen an beiden Orten.
20
- - **Ein Link für alles.**
21
- Das WebUI (Desktop und Telefon, Englisch und Vereinfachtes Chinesisch) beherbergt außerdem gewöhnliche Pi-Gespräche und wechselt zwischen Projekten, jedes mit eigenem Owner und eigener Historie.
22
-
23
- Cadence ist ein vertrauenswürdiger Assistent, **keine Sandbox**: Seine Agenten bearbeiten deine Arbeitskopie direkt mit Host-Tools, daher nutze es nur für Code, den du prüfen und wiederherstellen kannst.
38
+ | | |
39
+ | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
40
+ | **Arbeit überlebt das Fenster** | Clients verbinden und trennen sich nur; der Owner läuft weiter. |
41
+ | **Vor der Freigabe ändert sich nichts** | Erst lesende Untersuchung, dann eine lesbare Vereinbarung, die du bestätigst. |
42
+ | **Verlässliche Ergebnisse** | Echte Prüfungen und unabhängiges Review; Modelltext zählt nie als bestanden. |
43
+ | **Schließt selbst ab** | Nach der Freigabe repariert, plant neu oder erfasst Abweichungen; Stopp nur bei Bedingungen außerhalb des Repositorys. |
44
+ | **Schneller durch Aufbau** | Unabhängige Aufgaben laufen nebeneinander in eigenen Worktrees. |
45
+ | **Wissen wächst mit** | Routentabelle und festes Budget: Worker lesen nur Passendes, neue Erkenntnisse ersetzen veraltete. |
46
+ | **WebUI zum Sehen und Steuern** | Aufgaben-Board, Revisionen, Abweichungen, Branches, Denken; mitten in der Antwort eingreifen oder einreihen. |
47
+ | **Ein Verlauf** | Browser-Gespräche sind die Pi-Sitzungen des Projekts; an beiden Orten fortsetzbar. |
48
+
49
+ > Cadence ist ein vertrauenswürdiger Assistent, **keine Sandbox**: Die Agenten nutzen Host-Werkzeuge im freigegebenen Checkout oder Worktree.
50
+ > Nur für Code verwenden, den du prüfen und wiederherstellen kannst.
24
51
 
25
52
  ## Installation
26
53
 
27
- Du brauchst Node `>=22.19.0` mit npm und Pi, installiert und bei einem Modell-Anbieter angemeldet; Cadence wiederverwendet Pís Anmeldung und Modell-Einstellungen.
54
+ Benötigt Node `>=22.19.0` und Pi mit Login bei einem Modellanbieter; Cadence nutzt den Pi-Login.
28
55
 
29
56
  ```sh
30
57
  npm install -g @abelxiaoxing/cadence
31
58
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
59
+ cadence server install # optionale WebUI und Boot-Dienst
32
60
  ```
33
61
 
34
- `cadence server install` registriert und startet einen Hintergrunddienst (auf Linux systemd, auf macOS ein LaunchAgent, auf Windows einen Eintrag in der Anmeldung) und gibt einen privaten Link aus, `http://127.0.0.1:17423/?token=…`.
35
- Der letzte Befehl lässt Pi dieselbe Kopie für `/cadence` laden, sodass ein npm-Upgrade beide aktualisiert.
36
- Port und Token liegen in `~/.pi/agent/cadence/.env`; wer das Token hat, kann deinen Workspace verwenden, daher den Link geheim halten.
62
+ `cadence server install` gibt einen privaten Link aus (`http://127.0.0.1:17423/?token=…`).
63
+ Das Token gewährt Zugriff auf deinen Arbeitsbereich: Link nicht weitergeben.
37
64
 
38
65
  ## Verwendung
39
66
 
40
- ### Im Browser
41
-
42
- 1. Öffne den ausgegebenen Link einmal; der Browser erinnert sich dann an dich.
43
- Wenn du ihn verlierst, gibt `cadence token-link --reveal` ihn erneut aus.
44
- 2. Wähle einen Projektordner.
45
- Die gespeicherte Modellpräferenz wird beim Senden wiederverwendet; fehlt sie, wähle einmal ein Modell.
46
- 3. Sende einmal `/cadence [Ziel]`.
47
- Dieses Gespräch bleibt im Cadence-Modus; kläre Anforderungen mit normalen Nachrichten.
48
- 4. Prüfe den vollständigen Plan und klicke **Implement this plan**.
49
- Implementierung, Checks, automatische Fehlerbehebung und die vereinbarte lokale Lieferung laufen automatisch.
50
- 5. Verfolge den Fortschritt im Gespräch; die Protokolle der Subagenten öffnest du über das Dock **Subagents** unten links.
51
- Aktualisieren und Abschluss beenden den Modus nicht.
52
- **Exit Cadence** beendet nur den Modus; **Cancel workflow — request stop** fordert den Abbruch an.
67
+ ### Browser
53
68
 
54
- No live Pi terminal is required for the browser conversation workflow.
69
+ 1. Den ausgegebenen Link einmal öffnen (`cadence token-link --reveal` zeigt ihn erneut).
70
+ 2. Mit der Schaltfläche unten rechts einen Arbeitsordner wählen.
71
+ 3. `/cadence [Ziel]` senden und die Rückfragen beantworten.
72
+ 4. **Implement this plan** klicken; Board und **Subagents**-Dock zeigen den Fortschritt.
73
+ Bilder per Einfügen oder Ziehen ([Details](docs/conversation-mode.md#images-in-the-webui)).
55
74
 
56
- ### Im Terminal
75
+ ### Terminal
57
76
 
58
- Gib einmal `/cadence <Ziel>` ein und führe danach ein normales Gespräch.
59
- Cadence untersucht das Projekt, klärt Entscheidungen und erstellt einen Plan.
60
- Nach ausdrücklicher Planfreigabe folgen Implementierung, Prüfungen, automatische Fehlerbehebung und die vereinbarte lokale Integration automatisch.
61
-
62
- Der Modus bleibt für dieses Gespräch aktiv, auch nach Abschluss eines Ziels.
63
- Zum Verlassen `exit cadence` eingeben; dadurch wird laufende Arbeit nicht abgebrochen.
64
- Modellpräferenzen werden projektübergreifend in `~/.pi/agent/cadence/settings.json` gespeichert.
65
-
66
- Der lokale Owner startet bei Bedarf; ein Systemdienst ist nur für die optionale WebUI/Autostart-Nutzung nötig.
67
-
68
- `/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
69
- See [History and diagnostics](docs/history.md).
70
- [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
71
- Browser authentication is not execution consent.
72
-
73
- ### Weitere Projekte
77
+ `/cadence <Ziel>` einmal im Pi-Gespräch eines vertrauten Projekts eingeben; der Modus bleibt nach Abschluss aktiv.
78
+ `exit cadence` oder `退出 Cadence` beendet ihn, ohne angenommene Arbeit abzubrechen.
79
+ `/cadence-history [run-id]` ist nur lesend.
80
+ `CADENCE_PARALLEL` (Standard 4) legt die gleichzeitigen Worker fest.
81
+ Details: [Konversationsmodus](docs/conversation-mode.md), [Verlauf](docs/history.md).
74
82
 
75
83
  ```sh
76
- cadence project open /absolute/project
77
- cadence project open /absolute/new-project --create
84
+ cadence project open /absolute/project # ein Owner, Port und Verlauf pro Projekt
78
85
  ```
79
86
 
80
- Jedes Projekt erhält seinen eigenen Owner, Port und seine eigene Historie, und der Befehl gibt seinen privaten Link aus; der WebUI-Ordnerwähler öffnet Projekte auf dieselbe Weise.
81
- Das Öffnen eines anderen Projekts stoppt nie die Arbeit im vorherigen.
82
-
83
- ### Checks
84
-
85
- Prüfbefehle stehen im ausdrücklich genehmigten Plan, einschließlich Baseline- und Abnahmeprüfungen.
86
- Ihre tatsächlichen Ergebnisse bleiben von der automatischen Agent-Prüfung getrennt.
87
-
88
87
  ## Dienst verwalten
89
88
 
90
89
  ```sh
91
90
  cadence server status
92
- cadence server restart # nach einem Upgrade oder einer .env / models.json-Änderung
93
- cadence server upgrade
94
- cadence server stop # bleibt registriert und startet beim nächsten Boot oder Login erneut
95
- cadence server uninstall # vor npm uninstall -g ausführen
91
+ cadence server restart # nach Upgrade oder Änderung an .env / models.json
92
+ cadence server upgrade # laden, installieren, neu starten; Rückfall, falls die neue Version nicht startet
93
+ cadence server stop
94
+ cadence server uninstall # vor npm uninstall -g
95
+ cadence doctor # Reste und jüngste Wiederherstellungen; --fix für den Rest
96
96
  ```
97
97
 
98
- Upgrade mit `cadence server upgrade` oder im Cadence-Dienstdialog der WebUI: Die Version wird geladen, während Cadence weiterläuft, und die vorherige Version kommt zurück, wenn die neue nicht startet.
99
- Restart, Stop und Uninstall stoppen laufende Arbeit geordnet, statt sie getrennt zurückzulassen.
100
- Uninstall entfernt nur die Dienstdefinition; Projekte, Historie und Pi-Einstellungen bleiben.
101
- Linux-Root- und benannte Dienste, entfernter HTTPS-Zugang und Wiederherstellung sind in [Dienstverwaltung](docs/service-management.md) und [Fernzugriff](docs/remote-access.md) beschrieben.
98
+ Nach Absturz oder Stromausfall ist keine Bereinigung nötig: Der nächste Start stellt wieder her und sagt, was er getan hat.
99
+ Siehe [Dienstverwaltung](docs/service-management.md) und [Fernzugriff](docs/remote-access.md).
102
100
 
103
101
  ## Entwicklung
104
102
 
105
- Pi kann auch ein lokales Checkout oder ein gepacktes Tarball laden: Füge seinen absoluten oder relativen Pfad zu Pís `packages` hinzu, oder versuche `pi -e ./cadence`.
106
- Cadence benötigt Pi 1.5.0 oder einen kompatiblen 1.x-Host; Entwicklungs-Pins und getestete Laufzeiten sind keine universellen Kompatibilitätsversprechen.
103
+ Pi kann auch einen lokalen Checkout oder ein gepacktes Tarball laden: absoluten oder relativen Pfad zu `packages` in Pi hinzufügen oder `pi -e ./cadence` probieren.
104
+ Cadence benötigt Pi 1.5.0 oder einen kompatiblen 1.x-Host; Entwicklungs-Pins und getestete Laufzeiten sind keine allgemeinen Kompatibilitätszusagen.
107
105
 
108
106
  ```sh
109
107
  bun install
110
108
  bun run verify
111
109
  ```
112
110
 
113
- Engineering-Anleitungen sind unter [engineering/](engineering/) nach Bereich aufgeteilt; der Projektindex in [AGENTS.md](AGENTS.md) sagt, welche Datei welchen Code abdeckt.
114
- `verify` ist die einzige Prüfung für Entwicklung und Releases: nur schnelle Checks, ohne Browser.
115
- Erforderlich sind ein offizieller Node-Build und ein privates temporäres Verzeichnis; siehe [Verifikation](engineering/verification.md).
111
+ Hinweise nach Bereich: [engineering/](engineering/) und [AGENTS.md](AGENTS.md). `verify` ist das einzige schnelle Gate; es braucht einen offiziellen Node-Build und ein privates temporäres Verzeichnis ([Verifikation](engineering/verification.md)).
116
112
 
117
113
  ## Lizenz
118
114
 
119
- Cadence ist MIT.
120
- Eingebundene Anpassungen, Schriftarten und Anbieter behalten ihre eigenen Lizenzen; siehe [Wiederverwendung und Verbreitung](docs/reuse-and-distribution.md) und [Drittanbieter-Hinweise](THIRD_PARTY_NOTICES.md).
115
+ MIT.
116
+ Gebündelte Anpassungen, Schriften und Fremdkomponenten behalten ihre Lizenzen: [Wiederverwendung und Verteilung](docs/reuse-and-distribution.md), [Drittanbieterhinweise](THIRD_PARTY_NOTICES.md).
package/README.es.md CHANGED
@@ -2,119 +2,115 @@
2
2
 
3
3
  [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Deutsch](README.de.md) · [Français](README.fr.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [Русский](README.ru.md)
4
4
 
5
- Cadence convierte a [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) en un espacio de trabajo de tareas persistente.
6
- Planifica una tarea de código, deja que los subagentes trabajen en ella, ejecuta tus comprobaciones y revisa el resultado desde el terminal de Pi (`/cadence`) o desde la interfaz web del navegador; ambos se conectan al mismo servicio en segundo plano.
5
+ Cadence convierte [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) en un flujo de ingeniería guiado por conversación: escribe `/cadence [objetivo]`, acuerda el resultado una vez y un owner persistente implementa, se recupera y verifica.
6
+ Desde el terminal o la WebUI opcional.
7
+
8
+ ## Cómo funciona
9
+
10
+ ```mermaid
11
+ flowchart TD
12
+ A["/cadence objetivo"] --> B["Investigar solo lectura"]
13
+ B --> C["Alinear y aprobar una vez"]
14
+ C --> D["Tareas independientes en worktrees paralelos"]
15
+ D --> E["Comprobaciones reales + revisión automática de Agent"]
16
+ E -->|"pasa"| F["Fusión local en tu rama"]
17
+ E -->|"falla"| G["Autocorrección"]
18
+ G --> D
19
+ F --> H["Cuidar el conocimiento (presupuesto fijo)"]
20
+ H -.-> B
21
+ ```
22
+
23
+ ```mermaid
24
+ flowchart LR
25
+ A["Falla una comprobación"] --> B["Reparar"] --> C["Replanificar la ruta"] --> D["Desviación registrada"] --> E["Parar solo por condiciones externas"]
26
+ ```
27
+
28
+ ```mermaid
29
+ flowchart LR
30
+ T["Terminal de Pi"] <-->|"conectar / desconectar"| O[("Owner persistente")]
31
+ W["WebUI<br/>tablero · ramas · intervenir"] <-->|"conectar / desconectar"| O
32
+ O --> X["Workers en worktrees"] --> Y["Tu rama"]
33
+ O -.-> K["Conocimiento .cadence/"]
34
+ ```
7
35
 
8
36
  ## Por qué Cadence
9
37
 
10
- - **El trabajo sobrevive a la ventana.**
11
- Las tareas se ejecutan en un servicio en segundo plano: cerrar el terminal, salir de Pi o dejar la pestaña del navegador solo desconecta, y cualquier cliente puede volver a conectarse a la misma ejecución.
12
- - **Nada se edita antes de que apruebes.**
13
- Una tarea primero analiza en solo lectura y propone un plan legible; los archivos solo cambian después de que confirmes ese plan exacto.
14
- - **Resultados en los que puedes confiar.**
15
- La salida de los subagentes, las ejecuciones reales de comprobaciones y tu propia revisión permanecen separadas: la prosa del modelo o un "Done" nunca cuentan como comprobación superada, y los resultados fallidos, cancelados y desconocidos permanecen distinguidos.
16
- - **Historial completo.**
17
- Cada ejecución conserva sus mensajes, llamadas a herramientas y salidas, con búsqueda exacta y exportación completa en Markdown/NDJSON; los secretos conocidos se enmascaran.
18
- - **Un historial compartido con la terminal.**
19
- Las conversaciones del navegador son las sesiones de Pi del proyecto: continúa una sesión de la terminal en el navegador o una del navegador con `/resume`, y consulta las ramas de Pi en ambos lugares.
20
- - **Un enlace para todo.**
21
- La interfaz web (escritorio y teléfono, inglés y chino simplificado) también aloja conversaciones ordinarias de Pi y cambia entre proyectos, cada uno con su propio owner e historial.
22
-
23
- Cadence es un asistente de confianza, **no una caja de arena**: sus agentes editan tu copia de trabajo directamente con herramientas del host, así que úsalo en código que puedas revisar y recuperar.
38
+ | | |
39
+ | ------------------------------------- | ------------------------------------------------------------------------------------------------------------------------- |
40
+ | **El trabajo sobrevive a la ventana** | Los clientes solo se conectan y desconectan; el owner sigue. |
41
+ | **Nada cambia antes de aprobar** | Investigación de solo lectura y un acuerdo legible que confirmas. |
42
+ | **Resultados fiables** | Comprobaciones reales y revisión independiente; el texto del modelo nunca cuenta como aprobado. |
43
+ | **Termina solo** | Tras aprobar, repara, replanifica o registra una desviación, y solo para por condiciones fuera del repositorio. |
44
+ | **Más rápido por diseño** | Las tareas independientes corren en paralelo en sus propios worktrees. |
45
+ | **El conocimiento se acumula** | Tabla de rutas y presupuesto fijo: los workers leen lo que corresponde y las lecciones nuevas sustituyen a las obsoletas. |
46
+ | **WebUI que muestra y dirige** | Tablero de tareas, revisiones, desviaciones, ramas, razonamiento; intervenir o encolar un mensaje en plena respuesta. |
47
+ | **Un solo historial** | Las conversaciones del navegador son las sesiones de Pi del proyecto; continúa en cualquiera. |
48
+
49
+ > Cadence es un asistente de confianza, **no un sandbox**: sus agentes usan herramientas del host en el checkout o worktree aprobado.
50
+ > Úsalo con código que puedas revisar y recuperar.
24
51
 
25
52
  ## Instalación
26
53
 
27
- Necesitas Node `>=22.19.0` con npm, y Pi instalado y conectado a un proveedor de modelos; Cadence reutiliza el inicio de sesión y la configuración de modelos de Pi.
54
+ Requiere Node `>=22.19.0` y Pi con sesión iniciada en un proveedor de modelos; Cadence reutiliza el inicio de sesión de Pi.
28
55
 
29
56
  ```sh
30
57
  npm install -g @abelxiaoxing/cadence
31
58
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
59
+ cadence server install # WebUI y servicio de arranque opcionales
32
60
  ```
33
61
 
34
- `cadence server install` registra e inicia un servicio en segundo plano (systemd en Linux, un LaunchAgent en macOS, una entrada de inicio de sesión en Windows) e imprime un enlace privado, `http://127.0.0.1:17423/?token=…`.
35
- El último comando permite que Pi cargue la misma copia para `/cadence`, de modo que una actualización de npm actualiza ambos.
36
- El puerto y el token están en `~/.pi/agent/cadence/.env`; cualquiera con el token puede usar tu espacio de trabajo, así que mantén el enlace privado.
62
+ `cadence server install` muestra un enlace privado (`http://127.0.0.1:17423/?token=…`).
63
+ El token da acceso a tu espacio de trabajo: mantén el enlace privado.
37
64
 
38
65
  ## Uso
39
66
 
40
- ### En el navegador
41
-
42
- 1. Abre el enlace impreso una vez; el navegador entonces te recuerda.
43
- Si lo pierdes, `cadence token-link --reveal` lo imprime de nuevo.
44
- 2. Elige una carpeta de proyecto.
45
- Al enviar se reutiliza la preferencia de modelo guardada; elige una vez si no existe.
46
- 3. Envía `/cadence [objetivo]` una vez.
47
- Esta conversación permanece en modo Cadence; aclara los requisitos con mensajes normales.
48
- 4. Revisa el plan completo y pulsa **Implement this plan**.
49
- La implementación, comprobaciones, recuperación automática y entrega local acordada son automáticas.
50
- 5. Sigue el progreso en la conversación; abre los registros de los subagentes desde el panel **Subagents** abajo a la izquierda.
51
- Recargar o terminar un objetivo no desactiva el modo.
52
- **Exit Cadence** sale del modo; **Cancel workflow — request stop** solicita cancelar el trabajo.
67
+ ### Navegador
53
68
 
54
- No live Pi terminal is required for the browser conversation workflow.
69
+ 1. Abre una vez el enlace mostrado (`cadence token-link --reveal` lo vuelve a mostrar).
70
+ 2. Elige una carpeta de trabajo con el botón inferior derecho.
71
+ 3. Envía `/cadence [objetivo]` y responde a las preguntas.
72
+ 4. Pulsa **Implement this plan** y sigue el tablero y el dock **Subagents**.
73
+ Imágenes pegadas o arrastradas ([detalles](docs/conversation-mode.md#images-in-the-webui)).
55
74
 
56
- ### En el terminal
75
+ ### Terminal
57
76
 
58
- Escribe `/cadence <objetivo>` una sola vez y continúa conversando normalmente.
59
- Cadence investiga el proyecto, aclara decisiones y prepara un plan.
60
- Tras aprobarlo explícitamente, implementa, verifica, realiza recuperación automática y entrega la integración local acordada.
61
-
62
- El modo permanece activo durante toda la conversación, incluso al terminar un objetivo.
63
- Usa `exit cadence` para salir; salir no cancela el trabajo aceptado.
64
- Las preferencias de modelo se guardan entre proyectos en `~/.pi/agent/cadence/settings.json`.
65
-
66
- El propietario local se inicia bajo demanda; el servicio del sistema es opcional para WebUI/inicio automático.
67
-
68
- `/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
69
- See [History and diagnostics](docs/history.md).
70
- [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
71
- Browser authentication is not execution consent.
72
-
73
- ### Más proyectos
77
+ Escribe `/cadence <objetivo>` una vez en la conversación de Pi de un proyecto de confianza; el modo sigue activo al terminar.
78
+ `exit cadence` o `退出 Cadence` lo cierra sin cancelar el trabajo aceptado.
79
+ `/cadence-history [run-id]` es de solo lectura.
80
+ `CADENCE_PARALLEL` (4 por defecto) fija los workers simultáneos.
81
+ Detalles: [modo conversación](docs/conversation-mode.md), [historial](docs/history.md).
74
82
 
75
83
  ```sh
76
- cadence project open /absolute/project
77
- cadence project open /absolute/new-project --create
84
+ cadence project open /absolute/project # un owner, puerto e historial por proyecto
78
85
  ```
79
86
 
80
- Cada proyecto obtiene su propio owner, puerto e historial, y el comando imprime su enlace privado; el selector de carpetas de la interfaz web abre proyectos de la misma manera.
81
- Abrir otro proyecto nunca detiene el trabajo del anterior.
82
-
83
- ### Comprobaciones
84
-
85
- Los comandos de verificación se declaran en el plan aprobado, incluidas las comprobaciones iniciales y de aceptación.
86
- Sus resultados reales se mantienen separados de la revisión automática del agente.
87
-
88
87
  ## Gestionar el servicio
89
88
 
90
89
  ```sh
91
90
  cadence server status
92
- cadence server restart # después de una actualización o un cambio de .env / models.json
93
- cadence server upgrade
94
- cadence server stop # permanece registrado y vuelve a iniciar en el próximo arranque o inicio de sesión
95
- cadence server uninstall # ejecutar antes de npm uninstall -g
91
+ cadence server restart # tras actualizar o cambiar .env / models.json
92
+ cadence server upgrade # descargar, instalar, reiniciar; vuelve atrás si la nueva versión falla
93
+ cadence server stop
94
+ cadence server uninstall # antes de npm uninstall -g
95
+ cadence doctor # restos y recuperaciones recientes; --fix para el resto
96
96
  ```
97
97
 
98
- Actualiza con `cadence server upgrade` o desde el diálogo del servicio Cadence de la WebUI: descarga la versión mientras Cadence sigue en marcha y restaura la anterior si la nueva no arranca.
99
- Restart, stop y uninstall detienen el trabajo en ejecución en orden en lugar de dejarlo desconectado.
100
- Uninstall solo elimina la definición del servicio; los proyectos, el historial y la configuración de Pi permanecen.
101
- Los servicios raíz de Linux y con nombre, el acceso HTTPS remoto y la recuperación se cubren en [gestión del servicio](docs/service-management.md) y [acceso remoto](docs/remote-access.md).
98
+ Un fallo o apagón no exige limpieza: el siguiente arranque se recupera y dice qué hizo.
99
+ Consulta [gestión del servicio](docs/service-management.md) y [acceso remoto](docs/remote-access.md).
102
100
 
103
101
  ## Desarrollo
104
102
 
105
103
  Pi también puede cargar un checkout local o un tarball empaquetado: añade su ruta absoluta o relativa a `packages` de Pi, o prueba `pi -e ./cadence`.
106
- Cadence requiere Pi 1.5.0 o un host 1.x compatible; los pines de desarrollo y los tiempos de ejecución probados no son promesas de compatibilidad universales.
104
+ Cadence requiere Pi 1.5.0 o un host 1.x compatible; los pines de desarrollo y los runtimes probados no son promesas de compatibilidad universal.
107
105
 
108
106
  ```sh
109
107
  bun install
110
108
  bun run verify
111
109
  ```
112
110
 
113
- La guía de ingeniería se divide por área bajo [engineering/](engineering/); el índice del proyecto en [AGENTS.md](AGENTS.md) indica qué archivo cubre qué código.
114
- `verify` es la única verificación para desarrollo y publicación: solo comprobaciones rápidas, sin navegador.
115
- Requiere un build oficial de Node y un directorio temporal privado; ver [verificación](engineering/verification.md).
111
+ Guías por área en [engineering/](engineering/) y [AGENTS.md](AGENTS.md). `verify` es la única puerta rápida; requiere un build oficial de Node y un directorio temporal privado ([verificación](engineering/verification.md)).
116
112
 
117
113
  ## Licencia
118
114
 
119
- Cadence es MIT.
120
- Las adaptaciones, fuentes y proveedores incluidos conservan sus propias licencias; ver [reutilización y distribución](docs/reuse-and-distribution.md) y [avisos de terceros](THIRD_PARTY_NOTICES.md).
115
+ MIT.
116
+ Las adaptaciones, fuentes y componentes de terceros incluidos conservan sus licencias: [reutilización y distribución](docs/reuse-and-distribution.md), [avisos de terceros](THIRD_PARTY_NOTICES.md).
package/README.fr.md CHANGED
@@ -2,119 +2,115 @@
2
2
 
3
3
  [English](README.md) · [简体中文](README.zh-CN.md) · [日本語](README.ja.md) · [한국어](README.ko.md) · [Deutsch](README.de.md) · [Français](README.fr.md) · [Español](README.es.md) · [Português (Brasil)](README.pt-BR.md) · [Русский](README.ru.md)
4
4
 
5
- Cadence transforme [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) en espace de travail de tâches persistant.
6
- Planifiez une tâche de code, laissez les sous-agents y travailler, exécutez vos vérifications et examinez le résultat depuis le terminal Pi (`/cadence`) ou l'interface Web du navigateur ; les deux se connectent au même service en arrière-plan.
5
+ Cadence transforme [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) en workflow d'ingénierie piloté par la conversation : saisissez `/cadence [objectif]`, validez le résultat une fois, et un owner persistant implémente, reprend et vérifie.
6
+ Dans le terminal ou via la WebUI optionnelle.
7
+
8
+ ## Fonctionnement
9
+
10
+ ```mermaid
11
+ flowchart TD
12
+ A["/cadence objectif"] --> B["Enquête en lecture seule"]
13
+ B --> C["Aligner, puis approuver une fois"]
14
+ C --> D["Tâches indépendantes en parallèle dans des worktrees"]
15
+ D --> E["Vérifications réelles + revue Agent automatique"]
16
+ E -->|"réussi"| F["Fusion locale dans votre branche"]
17
+ E -->|"échec"| G["Auto-correction"]
18
+ G --> D
19
+ F --> H["Entretenir les connaissances (budget fixe)"]
20
+ H -.-> B
21
+ ```
22
+
23
+ ```mermaid
24
+ flowchart LR
25
+ A["Échec d'une vérification"] --> B["Réparer"] --> C["Replanifier la route"] --> D["Écart enregistré"] --> E["Arrêt seulement pour des conditions externes"]
26
+ ```
27
+
28
+ ```mermaid
29
+ flowchart LR
30
+ T["Terminal Pi"] <-->|"connexion / déconnexion"| O[("Owner persistant")]
31
+ W["WebUI<br/>tableau · branches · intervention"] <-->|"connexion / déconnexion"| O
32
+ O --> X["Workers dans des worktrees"] --> Y["Votre branche"]
33
+ O -.-> K["Connaissances .cadence/"]
34
+ ```
7
35
 
8
36
  ## Pourquoi Cadence
9
37
 
10
- - **Le travail survit à la fenêtre.**
11
- Les tâches s'exécutent dans un service en arrière-plan : fermer le terminal, quitter Pi ou quitter l'onglet du navigateur ne fait que déconnecter, et chaque client peut se reconnecter à la même exécution.
12
- - **Rien n'est modifié avant votre approbation.**
13
- Une tâche analyse d'abord en lecture seule et propose un plan lisible ; les fichiers ne changent qu'après que vous ayez confirmé ce plan exact.
14
- - **Des résultats fiables.**
15
- La sortie des sous-agents, les exécutions réelles de vérifications et votre propre examen restent distincts : le texte du modèle ou un « Done » ne compte jamais comme une vérification passée, et les résultats échoués, annulés et inconnus restent distincts.
16
- - **Historique complet.**
17
- Chaque exécution conserve ses messages, appels d'outils et sorties, avec recherche exacte et export Markdown/NDJSON complets ; les secrets connus sont masqués.
18
- - **Un historique partagé avec le terminal.**
19
- Les conversations du navigateur sont les sessions Pi du projet : reprenez une session du terminal dans le navigateur, ou une session du navigateur avec `/resume`, et consultez les branches de Pi des deux côtés.
20
- - **Un lien pour tout.**
21
- L'interface Web (bureau et téléphone, anglais et chinois simplifié) accueille également les conversations Pi ordinaires et bascule entre les projets, chacun avec son propre owner et son historique.
22
-
23
- Cadence est un assistant de confiance, **pas un bac à sable** : ses agents modifient directement votre copie de travail avec les outils de l'hôte, utilisez-le donc sur du code que vous pouvez examiner et récupérer.
38
+ | | |
39
+ | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
40
+ | **Le travail survit à la fenêtre** | Les clients se connectent et se déconnectent seulement ; l'owner continue. |
41
+ | **Rien ne change avant l'approbation** | Enquête en lecture seule, puis un accord lisible que vous confirmez. |
42
+ | **Résultats fiables** | Vérifications réelles et revue indépendante ; un texte du modèle ne vaut jamais réussite. |
43
+ | **Termine seul** | Après approbation, il répare, replanifie ou enregistre un écart, et ne s'arrête que pour des conditions hors dépôt. |
44
+ | **Plus rapide par conception** | Les tâches indépendantes s'exécutent côte à côte dans leurs worktrees. |
45
+ | **Les connaissances s'accumulent** | Table de routes et budget fixe : les workers lisent ce qui correspond, les nouvelles leçons remplacent les périmées. |
46
+ | **Une WebUI qui montre et pilote** | Tableau des tâches, révisions, écarts, branches, réflexion ; intervenir ou mettre en file en pleine réponse. |
47
+ | **Un seul historique** | Les conversations du navigateur sont les sessions Pi du projet ; reprise des deux côtés. |
48
+
49
+ > Cadence est un assistant de confiance, **pas un bac à sable** : ses agents utilisent les outils de l'hôte dans le checkout ou worktree approuvé.
50
+ > À utiliser sur du code que vous pouvez relire et restaurer.
24
51
 
25
52
  ## Installation
26
53
 
27
- Il vous faut Node `>=22.19.0` avec npm, et Pi installé et connecté à un fournisseur de modèles ; Cadence réutilise la connexion et les réglages de modèles de Pi.
54
+ Nécessite Node `>=22.19.0` et Pi connecté à un fournisseur de modèles ; Cadence réutilise la connexion de Pi.
28
55
 
29
56
  ```sh
30
57
  npm install -g @abelxiaoxing/cadence
31
58
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
59
+ cadence server install # WebUI et service de démarrage optionnels
32
60
  ```
33
61
 
34
- `cadence server install` enregistre et démarre un service en arrière-plan (systemd sur Linux, un LaunchAgent sur macOS, une entrée de connexion sur Windows) et affiche un lien privé, `http://127.0.0.1:17423/?token=…`.
35
- La dernière commande permet à Pi de charger la même copie pour `/cadence`, donc une mise à niveau npm met à jour les deux.
36
- Le port et le jeton se trouvent dans `~/.pi/agent/cadence/.env` ; quiconque possède le jeton peut utiliser votre espace de travail, gardez donc le lien privé.
62
+ `cadence server install` affiche un lien privé (`http://127.0.0.1:17423/?token=…`).
63
+ Le jeton donne accès à votre espace de travail : gardez le lien privé.
37
64
 
38
65
  ## Utilisation
39
66
 
40
- ### Dans le navigateur
41
-
42
- 1. Ouvrez le lien affiché une fois ; le navigateur vous mémorise ensuite.
43
- Si vous le perdez, `cadence token-link --reveal` l'affiche à nouveau.
44
- 2. Choisissez un dossier de projet.
45
- La préférence de modèle est réutilisée à l’envoi ; choisissez une fois si elle est absente.
46
- 3. Envoyez une fois `/cadence [objectif]`.
47
- Cette conversation reste en mode Cadence ; précisez les besoins par des messages ordinaires.
48
- 4. Lisez le plan complet et cliquez sur **Implement this plan**.
49
- L’implémentation, les vérifications, la reprise automatique et la livraison locale convenue sont automatiques.
50
- 5. Suivez la progression dans la conversation ; ouvrez les traces des sous-agents depuis le panneau **Subagents** en bas à gauche.
51
- Actualiser ou terminer un objectif ne quitte pas le mode.
52
- **Exit Cadence** quitte le mode ; **Cancel workflow — request stop** demande l’annulation.
67
+ ### Navigateur
53
68
 
54
- No live Pi terminal is required for the browser conversation workflow.
69
+ 1. Ouvrez une fois le lien affiché (`cadence token-link --reveal` le réaffiche).
70
+ 2. Choisissez un dossier de travail avec le bouton en bas à droite.
71
+ 3. Envoyez `/cadence [objectif]`, puis répondez aux questions.
72
+ 4. Cliquez sur **Implement this plan** et suivez le tableau et le dock **Subagents**.
73
+ Images par collage ou glisser-déposer ([détails](docs/conversation-mode.md#images-in-the-webui)).
55
74
 
56
- ### Dans le terminal
75
+ ### Terminal
57
76
 
58
- Saisissez `/cadence <objectif>` une seule fois, puis poursuivez la conversation normalement.
59
- Cadence étudie le projet, clarifie les décisions et prépare un plan.
60
- Après votre approbation explicite, il réalise les modifications, vérifications, reprise automatique et intégration locale convenues.
61
-
62
- Le mode reste actif pendant toute la conversation, même après la fin d’un objectif.
63
- Saisissez `exit cadence` pour quitter ; cela n’annule pas le travail accepté.
64
- Les préférences de modèle sont conservées entre projets dans `~/.pi/agent/cadence/settings.json`.
65
-
66
- Le propriétaire local démarre à la demande ; le service système est facultatif pour la WebUI et le démarrage automatique.
67
-
68
- `/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
69
- See [History and diagnostics](docs/history.md).
70
- [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
71
- Browser authentication is not execution consent.
72
-
73
- ### Plus de projets
77
+ Saisissez `/cadence <objectif>` une fois dans la conversation Pi d'un projet de confiance ; le mode reste actif après l'objectif.
78
+ `exit cadence` ou `退出 Cadence` le quitte sans annuler le travail accepté.
79
+ `/cadence-history [run-id]` est en lecture seule.
80
+ `CADENCE_PARALLEL` (4 par défaut) fixe le nombre de workers simultanés.
81
+ Détails : [mode conversation](docs/conversation-mode.md), [historique](docs/history.md).
74
82
 
75
83
  ```sh
76
- cadence project open /absolute/project
77
- cadence project open /absolute/new-project --create
84
+ cadence project open /absolute/project # un owner, un port et un historique par projet
78
85
  ```
79
86
 
80
- Chaque projet reçoit son propre owner, son port et son historique, et la commande affiche son lien privé ; le sélecteur de dossiers du WebUI ouvre les projets de la même manière.
81
- Ouvrir un autre projet n'arrête jamais le travail du précédent.
82
-
83
- ### Vérifications
84
-
85
- Les commandes de vérification figurent dans le plan explicitement approuvé, avec les vérifications initiales et d’acceptation.
86
- Leurs résultats restent distincts de la revue automatique par un Agent.
87
-
88
87
  ## Gérer le service
89
88
 
90
89
  ```sh
91
90
  cadence server status
92
- cadence server restart # après une mise à niveau ou un changement de .env / models.json
93
- cadence server upgrade
94
- cadence server stop # reste enregistré et redémarre au prochain boot ou connexion
95
- cadence server uninstall # à exécuter avant npm uninstall -g
91
+ cadence server restart # après une mise à jour ou un changement de .env / models.json
92
+ cadence server upgrade # télécharger, installer, redémarrer ; retour arrière si la nouvelle version échoue
93
+ cadence server stop
94
+ cadence server uninstall # avant npm uninstall -g
95
+ cadence doctor # restes et reprises récentes ; --fix pour le reste
96
96
  ```
97
97
 
98
- Mettez à niveau avec `cadence server upgrade` ou depuis la boîte de dialogue du service Cadence de la WebUI : la version est téléchargée pendant que Cadence continue de tourner, et la précédente est réinstallée si la nouvelle ne démarre pas.
99
- Restart, stop et uninstall arrêtent le travail en cours dans l'ordre au lieu de le laisser déconnecté.
100
- Uninstall supprime uniquement la définition du service ; les projets, l'historique et les réglages de Pi restent.
101
- Les services racine Linux et nommés, l'accès HTTPS distant et la récupération sont couverts par [gestion du service](docs/service-management.md) et [accès distant](docs/remote-access.md).
98
+ Un plantage ou une coupure n'exige aucun nettoyage : le démarrage suivant reprend et indique ce qu'il a fait.
99
+ Voir [gestion du service](docs/service-management.md) et [accès distant](docs/remote-access.md).
102
100
 
103
101
  ## Développement
104
102
 
105
- Pi peut aussi charger un checkout local ou une archive tarball packagée : ajoutez son chemin absolu ou relatif aux `packages` de Pi, ou essayez `pi -e ./cadence`.
106
- Cadence nécessite Pi 1.5.0 ou un hôte 1.x compatible ; les versions figées de développement et les temps d'exécution testés ne sont pas des promesses de compatibilité universelles.
103
+ Pi peut aussi charger un checkout local ou un tarball empaqueté : ajoutez son chemin absolu ou relatif aux `packages` de Pi, ou essayez `pi -e ./cadence`.
104
+ Cadence nécessite Pi 1.5.0 ou un hôte 1.x compatible ; les versions épinglées et runtimes testés ne sont pas des promesses de compatibilité universelle.
107
105
 
108
106
  ```sh
109
107
  bun install
110
108
  bun run verify
111
109
  ```
112
110
 
113
- Les conseils d'ingénierie sont répartis par domaine sous [engineering/](engineering/) ; l'index du projet dans [AGENTS.md](AGENTS.md) indique quel fichier couvre quel code.
114
- `verify` est la seule validation pour le développement et les publications : uniquement des vérifications rapides, sans navigateur.
115
- Elle nécessite un build Node officiel et un répertoire temporaire privé ; voir [vérification](engineering/verification.md).
111
+ Guides par domaine : [engineering/](engineering/) et [AGENTS.md](AGENTS.md). `verify` est l'unique barrière rapide ; il faut un build Node officiel et un répertoire temporaire privé ([vérification](engineering/verification.md)).
116
112
 
117
113
  ## Licence
118
114
 
119
- Cadence est sous licence MIT.
120
- Les adaptations, polices et vendeurs inclus conservent leurs propres licences ; voir [réutilisation et distribution](docs/reuse-and-distribution.md) et [avis tiers](THIRD_PARTY_NOTICES.md).
115
+ MIT.
116
+ Adaptations, polices et composants tiers inclus conservent leurs licences : [réutilisation et distribution](docs/reuse-and-distribution.md), [mentions tierces](THIRD_PARTY_NOTICES.md).