@abelxiaoxing/cadence 2.0.19 → 2.0.21

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
@@ -26,7 +26,6 @@ Du brauchst Node `>=22.19.0` mit npm und Pi, installiert und bei einem Modell-An
26
26
 
27
27
  ```sh
28
28
  npm install -g @abelxiaoxing/cadence
29
- cadence server install
30
29
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
31
30
  ```
32
31
 
@@ -40,17 +39,34 @@ Port und Token liegen in `~/.pi/agent/cadence/.env`; wer das Token hat, kann dei
40
39
 
41
40
  1. Öffne den ausgegebenen Link einmal; der Browser erinnert sich dann an dich.
42
41
  Wenn du ihn verlierst, gibt `cadence token-link --reveal` ihn erneut aus.
43
- 2. Wähle mit dem Ordner-Button unten rechts einen Projektordner und wähle ein Modell.
44
- 3. Sende eine Nachricht für ein gewöhnliches Gespräch oder beginne mit `cadence <goal>` (oder wähle Cadence-Aufgabe), um eine Aufgabe zu erstellen.
45
- 4. Wenn die Analyse einen Plan vorschlägt, öffne **Implementierungsplan prüfen** und wähle **Plan bestätigen und ausführen**.
46
- 5. Verfolge die Subagents im Dock links unten; Checks, Änderungen und Prüfung finden sich unter **Aufgabendetails** rechts.
42
+ 2. Wähle einen Projektordner.
43
+ Die gespeicherte Modellpräferenz wird beim Senden wiederverwendet; fehlt sie, wähle einmal ein Modell.
44
+ 3. Sende einmal `/cadence [Ziel]`.
45
+ Dieses Gespräch bleibt im Cadence-Modus; kläre Anforderungen mit normalen Nachrichten.
46
+ 4. Prüfe den vollständigen Plan und klicke **Implement this plan**.
47
+ Implementierung, Checks, begrenzte Reparaturen und die vereinbarte lokale Lieferung laufen automatisch.
48
+ 5. Verfolge Fortschritt und Subagent-Protokolle im Gespräch.
49
+ Aktualisieren und Abschluss beenden den Modus nicht.
50
+ **Exit Cadence** beendet nur den Modus; **Cancel workflow — request stop** fordert den Abbruch an.
51
+
52
+ **Legacy task**: previous task/history workflow.
53
+ No live Pi terminal is required for the browser conversation workflow.
47
54
 
48
55
  ### Im Terminal
49
56
 
50
- Gib im Pi-TUI selbst `/cadence [goal]` ein und drücke Enter; eingefügte oder skriptgesteuerte Eingaben öffnen es nicht.
51
- Wähle ein Modell, erstelle oder öffne eine Aufgabe, bearbeite ihren Plan und bestätige Start; die Menüs zeigen außerdem Subagents, Checks, Änderungen, Prüfung und Historie.
57
+ Gib einmal `/cadence <Ziel>` ein und führe danach ein normales Gespräch.
58
+ Cadence untersucht das Projekt, klärt Entscheidungen und erstellt einen Plan.
59
+ Nach ausdrücklicher Planfreigabe folgen Implementierung, Prüfungen, begrenzte Reparaturen und die vereinbarte lokale Integration automatisch.
52
60
 
53
- Jede Pi-Session zeigt außerdem laufende Hintergrund-Agenten über der Eingabe: Drücke ↓ bei leerer Eingabe, um einen auszuwählen, und Enter, um sein Transkript zu lesen (`CADENCE_AGENT_PANEL=off` blendet das Panel aus).
61
+ Der Modus bleibt für dieses Gespräch aktiv, auch nach Abschluss eines Ziels.
62
+ Zum Verlassen `exit cadence` eingeben; dadurch wird laufende Arbeit nicht abgebrochen.
63
+ Modellpräferenzen werden projektübergreifend in `~/.pi/agent/cadence/settings.json` gespeichert.
64
+
65
+ Der lokale Owner startet bei Bedarf; ein Systemdienst ist nur für die optionale WebUI/Autostart-Nutzung nötig.
66
+
67
+ `/cadence-inspect`: legacy task/history UI.
68
+ [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
69
+ Browser authentication is not execution consent.
54
70
 
55
71
  ### Weitere Projekte
56
72
 
package/README.es.md CHANGED
@@ -26,7 +26,6 @@ Necesitas Node `>=22.19.0` con npm, y Pi instalado y conectado a un proveedor de
26
26
 
27
27
  ```sh
28
28
  npm install -g @abelxiaoxing/cadence
29
- cadence server install
30
29
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
31
30
  ```
32
31
 
@@ -40,17 +39,34 @@ El puerto y el token están en `~/.pi/agent/cadence/.env`; cualquiera con el tok
40
39
 
41
40
  1. Abre el enlace impreso una vez; el navegador entonces te recuerda.
42
41
  Si lo pierdes, `cadence token-link --reveal` lo imprime de nuevo.
43
- 2. Elige una carpeta de proyecto con el botón de carpeta en la parte inferior derecha, y elige un modelo.
44
- 3. Envía un mensaje para una conversación ordinaria, o comienza con `cadence <goal>` (o selecciona Tarea Cadence) para crear una tarea.
45
- 4. Cuando el análisis propone un plan, abre **Revisar plan de implementación** y elige **Confirmar plan y ejecutar**.
46
- 5. Sigue a los subagentes en el dock de la parte inferior izquierda; las comprobaciones, los cambios y la revisión están bajo **Detalles de la tarea** a la derecha.
42
+ 2. Elige una carpeta de proyecto.
43
+ Al enviar se reutiliza la preferencia de modelo guardada; elige una vez si no existe.
44
+ 3. Envía `/cadence [objetivo]` una vez.
45
+ Esta conversación permanece en modo Cadence; aclara los requisitos con mensajes normales.
46
+ 4. Revisa el plan completo y pulsa **Implement this plan**.
47
+ La implementación, comprobaciones, reparaciones limitadas y entrega local acordada son automáticas.
48
+ 5. Sigue el progreso y los registros de subagentes en la conversación.
49
+ Recargar o terminar un objetivo no desactiva el modo.
50
+ **Exit Cadence** sale del modo; **Cancel workflow — request stop** solicita cancelar el trabajo.
51
+
52
+ **Legacy task**: previous task/history workflow.
53
+ No live Pi terminal is required for the browser conversation workflow.
47
54
 
48
55
  ### En el terminal
49
56
 
50
- En el TUI de Pi, escribe `/cadence [goal]` y presiona Enter tú mismo; la entrada pegada o por guion no lo abre.
51
- Elige un modelo, crea o abre una tarea, edita su plan y confirma Start; los menús también muestran subagentes, comprobaciones, cambios, revisión e historial.
57
+ Escribe `/cadence <objetivo>` una sola vez y continúa conversando normalmente.
58
+ Cadence investiga el proyecto, aclara decisiones y prepara un plan.
59
+ Tras aprobarlo explícitamente, implementa, verifica, realiza reparaciones limitadas y entrega la integración local acordada.
52
60
 
53
- Cada sesión de Pi también muestra agentes en segundo plano en ejecución sobre la entrada: presiona ↓ en una entrada vacía para seleccionar uno y Enter para leer su transcripción (`CADENCE_AGENT_PANEL=off` oculta el panel).
61
+ El modo permanece activo durante toda la conversación, incluso al terminar un objetivo.
62
+ Usa `exit cadence` para salir; salir no cancela el trabajo aceptado.
63
+ Las preferencias de modelo se guardan entre proyectos en `~/.pi/agent/cadence/settings.json`.
64
+
65
+ El propietario local se inicia bajo demanda; el servicio del sistema es opcional para WebUI/inicio automático.
66
+
67
+ `/cadence-inspect`: legacy task/history UI.
68
+ [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
69
+ Browser authentication is not execution consent.
54
70
 
55
71
  ### Más proyectos
56
72
 
package/README.fr.md CHANGED
@@ -26,7 +26,6 @@ Il vous faut Node `>=22.19.0` avec npm, et Pi installé et connecté à un fourn
26
26
 
27
27
  ```sh
28
28
  npm install -g @abelxiaoxing/cadence
29
- cadence server install
30
29
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
31
30
  ```
32
31
 
@@ -40,17 +39,34 @@ Le port et le jeton se trouvent dans `~/.pi/agent/cadence/.env` ; quiconque poss
40
39
 
41
40
  1. Ouvrez le lien affiché une fois ; le navigateur vous mémorise ensuite.
42
41
  Si vous le perdez, `cadence token-link --reveal` l'affiche à nouveau.
43
- 2. Choisissez un dossier de projet avec le bouton dossier en bas à droite, et choisissez un modèle.
44
- 3. Envoyez un message pour une conversation ordinaire, ou commencez par `cadence <goal>` (ou sélectionnez Tâche Cadence) pour créer une tâche.
45
- 4. Quand l'analyse propose un plan, ouvrez **Examiner le plan d'implémentation** et choisissez **Confirmer le plan et exécuter**.
46
- 5. Suivez les sous-agents dans le dock en bas à gauche ; les vérifications, les modifications et l'examen sont sous **Détails de la tâche** à droite.
42
+ 2. Choisissez un dossier de projet.
43
+ La préférence de modèle est réutilisée à l’envoi ; choisissez une fois si elle est absente.
44
+ 3. Envoyez une fois `/cadence [objectif]`.
45
+ Cette conversation reste en mode Cadence ; précisez les besoins par des messages ordinaires.
46
+ 4. Lisez le plan complet et cliquez sur **Implement this plan**.
47
+ L’implémentation, les vérifications, les réparations bornées et la livraison locale convenue sont automatiques.
48
+ 5. Suivez la progression et les traces des sous-agents dans la conversation.
49
+ Actualiser ou terminer un objectif ne quitte pas le mode.
50
+ **Exit Cadence** quitte le mode ; **Cancel workflow — request stop** demande l’annulation.
51
+
52
+ **Legacy task**: previous task/history workflow.
53
+ No live Pi terminal is required for the browser conversation workflow.
47
54
 
48
55
  ### Dans le terminal
49
56
 
50
- Dans le TUI de Pi, tapez `/cadence [goal]` vous-même et appuyez sur Entrée ; une saisie collée ou scriptée ne l'ouvre pas.
51
- Choisissez un modèle, créez ou ouvrez une tâche, éditez son plan et confirmez Start ; les menus affichent aussi les sous-agents, les vérifications, les modifications, l'examen et l'historique.
57
+ Saisissez `/cadence <objectif>` une seule fois, puis poursuivez la conversation normalement.
58
+ Cadence étudie le projet, clarifie les décisions et prépare un plan.
59
+ Après votre approbation explicite, il réalise les modifications, vérifications, réparations limitées et intégration locale convenues.
52
60
 
53
- Chaque session Pi affiche aussi les agents en arrière-plan en cours au-dessus de la saisie : appuyez sur ↓ sur une saisie vide pour en sélectionner un, puis sur Entrée pour lire sa transcription (`CADENCE_AGENT_PANEL=off` masque le panneau).
61
+ Le mode reste actif pendant toute la conversation, même après la fin d’un objectif.
62
+ Saisissez `exit cadence` pour quitter ; cela n’annule pas le travail accepté.
63
+ Les préférences de modèle sont conservées entre projets dans `~/.pi/agent/cadence/settings.json`.
64
+
65
+ Le propriétaire local démarre à la demande ; le service système est facultatif pour la WebUI et le démarrage automatique.
66
+
67
+ `/cadence-inspect`: legacy task/history UI.
68
+ [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
69
+ Browser authentication is not execution consent.
54
70
 
55
71
  ### Plus de projets
56
72
 
package/README.ja.md CHANGED
@@ -34,7 +34,6 @@ Cadence は Pi のログインとモデル設定を再利用します。
34
34
 
35
35
  ```sh
36
36
  npm install -g @abelxiaoxing/cadence
37
- cadence server install
38
37
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
39
38
  ```
40
39
 
@@ -50,21 +49,37 @@ pi install "$(npm root -g)/@abelxiaoxing/cadence"
50
49
  1. 表示されたリンクを一度開く。
51
50
  その後ブラウザはあなたを覚えておく。
52
51
  リンクを紛失した場合は `cadence token-link --reveal` で再度表示できます。
53
- 2. 右下のフォルダボタンでプロジェクトフォルダを選び、モデルを選ぶ。
54
- 3. 通常の会話にはメッセージを送信するか、`cadence <goal>` で始める(または Cadence タスクを選ぶ)とタスクが作成される。
55
- 4. 分析が計画を提案したら、**実装計画をレビュー**を開き、**計画を確認して実行**を選ぶ。
56
- 5. サブエージェントは左下の dock で追える。
57
- チェック、変更、レビューは右の**タスク詳細**の下にある。
52
+ 2. プロジェクトフォルダを選びます。
53
+ 送信時に保存済みのモデル設定を再利用します。
54
+ 設定がない場合だけモデルを選んでください。
55
+ 3. 一度だけ `/cadence [目標]` を送信します。
56
+ この会話は Cadence モードを維持し、その後は通常のメッセージで要件を明確にできます。
57
+ 4. 完全な計画を確認し、**Implement this plan** を押します。
58
+ 実装、検証、回数制限付きの修正、合意したローカル納品が自動で進みます。
59
+ 5. 同じ会話で進捗とサブエージェントの記録を確認できます。
60
+ 再読み込みや目標完了でもモードは維持されます。
61
+ **Exit Cadence** はモード終了のみ、**Cancel workflow — request stop** は作業のキャンセル要求です。
62
+
63
+ **Legacy task**: previous task/history workflow.
64
+ No live Pi terminal is required for the browser conversation workflow.
58
65
 
59
66
  ### ターミナルで
60
67
 
61
- Pi の TUI で、自分で `/cadence [goal]` と入力して Enter を押す。
62
- 貼り付けやスクリプトの入力では開かない。
63
- モデルを選び、タスクを作成または開き、その計画を編集して Start を確認する。
64
- メニューにはサブエージェント、チェック、変更、レビュー、履歴も表示される。
68
+ `/cadence <目標>` を一度入力した後は、通常の会話を続けます。
69
+ Cadence がプロジェクトを調査し、必要な判断を確認して計画を作ります。
70
+ 計画への明示的な承認後は、実装・検証・回数制限付き修正・合意したローカル統合を自動で進めます。
65
71
 
66
- すべての Pi セッションは、入力の上部に実行中のバックグラウンドエージェントを表示する。
67
- 空の入力状態で ↓ を押して選択し、Enter でその記録を読む(`CADENCE_AGENT_PANEL=off` でパネルを非表示にできる)。
72
+ 目標が完了しても、この会話では Cadence モードを維持します。
73
+ 終了するには `exit cadence` と入力します。
74
+ 終了は実行中の作業をキャンセルしません。
75
+ モデル設定は `~/.pi/agent/cadence/settings.json` に保存され、プロジェクト間で再利用されます。
76
+
77
+ ローカル owner は必要時に起動します。
78
+ システムサービスのインストールは WebUI・自動起動を使う場合のみ必要です。
79
+
80
+ `/cadence-inspect`: legacy task/history UI.
81
+ [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
82
+ Browser authentication is not execution consent.
68
83
 
69
84
  ### その他のプロジェクト
70
85
 
package/README.ko.md CHANGED
@@ -33,7 +33,6 @@ Cadence는 Pi의 로그인과 모델 설정을 재사용합니다.
33
33
 
34
34
  ```sh
35
35
  npm install -g @abelxiaoxing/cadence
36
- cadence server install
37
36
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
38
37
  ```
39
38
 
@@ -49,21 +48,35 @@ pi install "$(npm root -g)/@abelxiaoxing/cadence"
49
48
  1. 출력된 링크를 한 번 엽니다.
50
49
  그 후 브라우저가 당신을 기억합니다.
51
50
  링크를 잃어버리면 `cadence token-link --reveal`이 다시 출력합니다.
52
- 2. 오른쪽 아래 폴더 버튼으로 프로젝트 폴더를 선택하고 모델을 선택합니다.
53
- 3. 일반 대화에는 메시지를 보내고, 또는 `cadence <goal>`로 시작(또는 Cadence 작업 선택)하면 작업이 생성됩니다.
54
- 4. 분석이 계획을 제안하면 **구현 계획 검토**를 열고 **계획 확인 및 실행**을 선택합니다.
55
- 5. 서브에이전트는 왼쪽 아래 dock에서 따라 보세요.
56
- 체크, 변경, 검토는 오른쪽의 **작업 세부사항** 아래에 있습니다.
51
+ 2. 프로젝트 폴더를 선택하세요.
52
+ 전송 시 저장된 모델 설정을 재사용하며, 설정이 없을 때만 한 번 선택합니다.
53
+ 3. `/cadence [목표]`를 한 번 전송하세요.
54
+ 이 대화는 Cadence 모드를 유지하며 이후에는 일반 메시지로 요구사항을 구체화합니다.
55
+ 4. 전체 계획을 확인하고 **Implement this plan**을 누르세요.
56
+ 구현, 검사, 제한된 수정 및 합의한 로컬 전달을 자동으로 진행합니다.
57
+ 5. 같은 대화에서 진행 상황과 서브에이전트 기록을 확인하세요.
58
+ 새로고침이나 목표 완료로 모드가 꺼지지 않습니다.
59
+ **Exit Cadence**는 모드만 종료하고, **Cancel workflow — request stop**은 작업 취소를 요청합니다.
60
+
61
+ **Legacy task**: previous task/history workflow.
62
+ No live Pi terminal is required for the browser conversation workflow.
57
63
 
58
64
  ### 터미널에서
59
65
 
60
- Pi TUI에서 직접 `/cadence [goal]`을 입력하고 Enter를 누르세요.
61
- 붙여넣기나 스크립트 입력으로는 열리지 않습니다.
62
- 모델을 선택하고, 작업을 만들거나 열고, 그 계획을 편집하고 Start를 확인하세요.
63
- 메뉴에는 서브에이전트, 체크, 변경, 검토, 역사도 표시됩니다.
66
+ `/cadence <목표>`를 한 번 입력한 다음 평소처럼 대화하세요.
67
+ Cadence가 프로젝트를 조사하고 결정 사항을 확인한 뒤 계획을 만듭니다.
68
+ 명시적으로 계획을 승인하면 구현, 검증, 제한된 수정 및 합의한 로컬 통합을 자동으로 진행합니다.
64
69
 
65
- 모든 Pi 세션은 입력 상단에 실행 중인 백그라운드 에이전트를 표시합니다.
66
- 빈 입력에서 ↓를 눌러 하나를 선택하고 Enter로 그 전사를 읽으세요(`CADENCE_AGENT_PANEL=off`로 패널을 숨길 수 있습니다).
70
+ 목표가 완료되어도 이 대화는 Cadence 모드를 유지합니다.
71
+ `exit cadence`로 종료할 수 있으며, 종료는 이미 승인된 작업을 취소하지 않습니다.
72
+ 모델 설정은 `~/.pi/agent/cadence/settings.json`에 저장되어 프로젝트 간 재사용됩니다.
73
+
74
+ 로컬 owner는 필요할 때 시작됩니다.
75
+ 시스템 서비스는 선택적인 WebUI 및 자동 시작용입니다.
76
+
77
+ `/cadence-inspect`: legacy task/history UI.
78
+ [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
79
+ Browser authentication is not execution consent.
67
80
 
68
81
  ### 더 많은 프로젝트
69
82
 
package/README.md CHANGED
@@ -2,8 +2,9 @@
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 turns [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) into a persistent task workspace.
6
- Plan a code task, let subagents work on it, run your checks and review the result from the Pi terminal (`/cadence`) or a browser WebUI; both attach to the same background service.
5
+ Cadence turns [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) into a conversation-driven engineering workflow.
6
+ Enter `/cadence [goal]`, align the plan through conversation, then let the persistent owner implement and verify it.
7
+ The optional WebUI supports the same persistent conversation workflow without a live Pi terminal, alongside ordinary chat and explicitly labelled legacy tasks.
7
8
 
8
9
  ## Why Cadence
9
10
 
@@ -14,7 +15,7 @@ Plan a code task, let subagents work on it, run your checks and review the resul
14
15
  - **Results you can trust.**
15
16
  Subagent output, real check runs and your own review stay separate: model prose or a "Done" never counts as a passed check, and failed, canceled and unknown outcomes stay distinct.
16
17
  - **Complete history.**
17
- Every run keeps its messages, tool calls and outputs, with exact search and complete Markdown/NDJSON export; known secrets are redacted.
18
+ Conversation workflows retain sanitized transcripts and actual process results; legacy task history also provides exact search and Markdown/NDJSON export.
18
19
  - **One link for everything.**
19
20
  The WebUI (desktop and phone, English and 简体中文) also hosts ordinary Pi conversations and switches between projects, each with its own owner and history.
20
21
 
@@ -26,11 +27,11 @@ You need Node `>=22.19.0` with npm, and Pi installed and logged in to a model pr
26
27
 
27
28
  ```sh
28
29
  npm install -g @abelxiaoxing/cadence
29
- cadence server install
30
30
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
31
31
  ```
32
32
 
33
- `cadence server install` registers and starts a background service (systemd on Linux, a LaunchAgent on macOS, a login entry on Windows) and prints a private link, `http://127.0.0.1:17423/?token=…`.
33
+ For the optional WebUI/boot service, explicitly run `cadence server install`.
34
+ It registers and starts a background service (systemd on Linux, a LaunchAgent on macOS, a login entry on Windows) and prints a private link, `http://127.0.0.1:17423/?token=…`.
34
35
  The last command lets Pi load the same copy for `/cadence`, so one npm upgrade updates both.
35
36
  The port and token live in `~/.pi/agent/cadence/.env`; anyone with the token can use your workspace, so keep the link private.
36
37
 
@@ -40,17 +41,32 @@ The port and token live in `~/.pi/agent/cadence/.env`; anyone with the token can
40
41
 
41
42
  1. Open the printed link once; the browser then remembers you.
42
43
  If you lose it, `cadence token-link --reveal` prints it again.
43
- 2. Choose a project folder with the folder button in the lower right, and choose a model.
44
- 3. Send a message for an ordinary conversation, or begin it with `cadence <goal>` (or select Cadence task) to create a task.
45
- 4. When the analysis proposes a plan, open **Review implementation plan** and choose **Confirm plan and execute**.
46
- 5. Follow subagents in the lower-left dock; checks, changes and review are under **Task details** on the right.
44
+ 2. Choose a project folder with the lower-right folder button.
45
+ Saved model preferences are reused on Send; choose once if none is available.
46
+ 3. Send `/cadence [goal]` once to enter Cadence in this conversation; continue with normal messages to investigate and clarify requirements.
47
+ 4. Review the complete inline plan and click **Implement this plan** (or send `按计划实施`).
48
+ The owner implements, verifies, repairs within budget and delivers as approved.
49
+ 5. Follow actual progress, subagent transcripts and local merge results in the conversation.
50
+ Refresh and completion keep Cadence on; **Exit Cadence** only exits the mode, while **Cancel workflow — request stop** requests cancellation.
51
+
52
+ **Legacy task** retains the old create/plan/Save/Start/check/human-Review route explicitly.
47
53
 
48
54
  ### In the terminal
49
55
 
50
- In Pi's TUI, type `/cadence [goal]` and press Enter yourself; pasted or scripted input does not open it.
51
- Choose a model, create or open a task, edit its plan and confirm Start; the menus also show subagents, checks, changes, review and history.
56
+ Enter `/cadence <goal>` once in any trusted project's Pi conversation.
57
+ Continue with normal messages: Cadence investigates, consolidates questions and develops a readable plan with you.
58
+ After explicit plan approval it automatically implements, reviews, verifies, performs bounded repairs and delivers as agreed.
59
+ Independent Git tasks use separate worktrees and may run in parallel; approved local commits/merge never imply a remote push.
60
+
61
+ **Completing a goal leaves the conversation in Cadence mode.**
62
+ No repeated command is needed.
63
+ Type `exit cadence` or `退出 Cadence` to leave; departure does not cancel accepted work.
64
+ Native use starts/reuses a local project owner on demand, without installing a system service.
65
+ Model preferences are remembered in `~/.pi/agent/cadence/settings.json`; authentication stays with Pi.
52
66
 
53
- Every Pi session also shows running background agents above the input: press ↓ on an empty input to select one and Enter to read its transcript (`CADENCE_AGENT_PANEL=off` hides the panel).
67
+ See [Conversation mode](docs/conversation-mode.md) for exact approval, worktree prerequisites and cancellation.
68
+ `/cadence-inspect` retains the advanced legacy task/history UI, including separate checks and human review; it is not the daily entrypoint.
69
+ Browser approval is separately bound to the displayed plan and conversation; authentication alone never authorizes execution.
54
70
 
55
71
  ### More projects
56
72
 
@@ -64,7 +80,8 @@ Opening another project never stops work in the previous one.
64
80
 
65
81
  ### Checks
66
82
 
67
- List the commands that verify your project in `.cadence/assistant/config.json`, and tasks can run them as real checks before review:
83
+ New workflows declare their checks in the approved plan.
84
+ For legacy tasks, list configured checks in `.cadence/assistant/config.json`:
68
85
 
69
86
  ```json
70
87
  {
package/README.pt-BR.md CHANGED
@@ -26,7 +26,6 @@ Você precisa de Node `>=22.19.0` com npm, e do Pi instalado e conectado a um pr
26
26
 
27
27
  ```sh
28
28
  npm install -g @abelxiaoxing/cadence
29
- cadence server install
30
29
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
31
30
  ```
32
31
 
@@ -40,17 +39,34 @@ A porta e o token ficam em `~/.pi/agent/cadence/.env`; qualquer pessoa com o tok
40
39
 
41
40
  1. Abra o link impresso uma vez; o navegador então se lembra de você.
42
41
  Se você o perder, `cadence token-link --reveal` o imprime de novo.
43
- 2. Escolha uma pasta de projeto com o botão de pasta no canto inferior direito, e escolha um modelo.
44
- 3. Envie uma mensagem para uma conversa comum, ou comece com `cadence <goal>` (ou selecione Tarefa Cadence) para criar uma tarefa.
45
- 4. Quando a análise propuser um plano, abra **Revisar plano de implementação** e escolha **Confirmar plano e executar**.
46
- 5. Acompanhe os subagentes no dock no canto inferior esquerdo; verificações, alterações e revisão ficam sob **Detalhes da tarefa** à direita.
42
+ 2. Escolha uma pasta de projeto.
43
+ A preferência de modelo salva é reutilizada ao enviar; escolha uma vez se ela não existir.
44
+ 3. Envie `/cadence [objetivo]` uma vez.
45
+ Esta conversa permanece no modo Cadence; esclareça os requisitos com mensagens normais.
46
+ 4. Revise o plano completo e clique em **Implement this plan**.
47
+ Implementação, verificações, reparos limitados e entrega local acordada são automáticos.
48
+ 5. Acompanhe o progresso e os registros dos subagentes na conversa.
49
+ Atualizar a página ou concluir um objetivo não desativa o modo.
50
+ **Exit Cadence** sai do modo; **Cancel workflow — request stop** solicita o cancelamento.
51
+
52
+ **Legacy task**: previous task/history workflow.
53
+ No live Pi terminal is required for the browser conversation workflow.
47
54
 
48
55
  ### No terminal
49
56
 
50
- No TUI do Pi, digite `/cadence [goal]` e pressione Enter você mesmo; entrada colada ou via script não o abre.
51
- Escolha um modelo, crie ou abra uma tarefa, edite seu plano e confirme Start; os menus também mostram subagentes, verificações, alterações, revisão e histórico.
57
+ Digite `/cadence <objetivo>` uma vez e continue conversando normalmente.
58
+ O Cadence investiga o projeto, esclarece decisões e prepara um plano.
59
+ Após aprovação explícita, executa a implementação, verificações, reparos limitados e integração local acordada.
52
60
 
53
- Cada sessão do Pi também mostra agentes em segundo plano em execução acima da entrada: pressione ↓ em uma entrada vazia para selecionar um e Enter para ler sua transcrição (`CADENCE_AGENT_PANEL=off` oculta o painel).
61
+ O modo permanece ativo durante toda a conversa, mesmo após concluir um objetivo.
62
+ Digite `exit cadence` para sair; sair não cancela trabalho aceito.
63
+ As preferências de modelo são mantidas entre projetos em `~/.pi/agent/cadence/settings.json`.
64
+
65
+ O proprietário local inicia sob demanda; o serviço do sistema é opcional para WebUI/inicialização automática.
66
+
67
+ `/cadence-inspect`: legacy task/history UI.
68
+ [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
69
+ Browser authentication is not execution consent.
54
70
 
55
71
  ### Mais projetos
56
72
 
package/README.ru.md CHANGED
@@ -26,7 +26,6 @@ Cadence — это доверенный ассистент, **а не песоч
26
26
 
27
27
  ```sh
28
28
  npm install -g @abelxiaoxing/cadence
29
- cadence server install
30
29
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
31
30
  ```
32
31
 
@@ -40,17 +39,34 @@ pi install "$(npm root -g)/@abelxiaoxing/cadence"
40
39
 
41
40
  1. Откройте напечатанную ссылку один раз; затем браузер запомнит вас.
42
41
  Если вы её потеряете, `cadence token-link --reveal` печатает её снова.
43
- 2. Выберите папку проекта кнопкой папки в правом нижнем углу и выберите модель.
44
- 3. Отправьте сообщение для обычного разговора, или начните его с `cadence <goal>` (или выберите «Задача Cadence»), чтобы создать задачу.
45
- 4. Когда анализ предложит план, откройте **Просмотр плана реализации** и выберите **Подтвердить план и выполнить**.
46
- 5. Следите за субагентами в доке слева внизу; проверки, изменения и обзор находятся под **Детали задачи** справа.
42
+ 2. Выберите папку проекта.
43
+ При отправке используется сохранённая модель; если её нет, выберите модель один раз.
44
+ 3. Один раз отправьте `/cadence [цель]`.
45
+ Разговор остаётся в режиме Cadence; уточняйте требования обычными сообщениями.
46
+ 4. Проверьте полный план и нажмите **Implement this plan**.
47
+ Реализация, проверки, ограниченные исправления и согласованная локальная интеграция выполняются автоматически.
48
+ 5. Следите за ходом работы и записями субагентов в разговоре.
49
+ Обновление страницы и завершение цели не выключают режим.
50
+ **Exit Cadence** выходит из режима; **Cancel workflow — request stop** запрашивает отмену работы.
51
+
52
+ **Legacy task**: previous task/history workflow.
53
+ No live Pi terminal is required for the browser conversation workflow.
47
54
 
48
55
  ### В терминале
49
56
 
50
- В TUI Pi введите `/cadence [goal]` сами и нажмите Enter; вставленный или скриптовый ввод не откроет его.
51
- Выберите модель, создайте или откройте задачу, отредактируйте её план и подтвердите Start; в меню также показываются субагенты, проверки, изменения, обзор и история.
57
+ Введите `/cadence <цель>` один раз и продолжайте обычный диалог.
58
+ Cadence исследует проект, уточняет решения и составляет план.
59
+ После явного одобрения он автоматически выполняет реализацию, проверки, ограниченные исправления и согласованную локальную интеграцию.
52
60
 
53
- Каждый сеанс Pi также показывает работающие фоновые агенты над вводом: нажмите ↓ на пустом вводе, чтобы выбрать один, и Enter, чтобы прочитать его транскрипт (`CADENCE_AGENT_PANEL=off` скрывает панель).
61
+ Режим сохраняется на весь диалог, даже после завершения цели.
62
+ Команда `exit cadence` выходит из режима, но не отменяет принятую работу.
63
+ Настройки модели сохраняются между проектами в `~/.pi/agent/cadence/settings.json`.
64
+
65
+ Локальный владелец запускается по требованию; системная служба нужна только для дополнительного WebUI и автозапуска.
66
+
67
+ `/cadence-inspect`: legacy task/history UI.
68
+ [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
69
+ Browser authentication is not execution consent.
54
70
 
55
71
  ### Другие проекты
56
72
 
package/README.zh-CN.md CHANGED
@@ -2,19 +2,19 @@
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 把 [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) 变成一个持久的任务工作区。
6
- 规划一个代码任务,让子代理去执行,运行你自己的检查,再从 Pi 终端(`/cadence`)或浏览器 WebUI 审阅结果;两者连接到同一个后台服务。
5
+ Cadence 把 [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) 变成一种持续对话驱动的工程工作方式。
6
+ 输入一次 `/cadence [目标]`,通过对话对齐计划,再由后台 owner 自动实施、验证和交付;WebUI 支持同样的持续对话流程,不需要 Pi 终端在线。
7
7
 
8
8
  ## 为什么选择 Cadence
9
9
 
10
10
  - **工作不随窗口结束。**
11
- 任务运行在后台服务中:关闭终端、退出 Pi 或离开浏览器标签页只是断开连接,任一客户端都能重新连接同一次运行。
11
+ 任务运行在后台服务中:关闭终端、退出 Pi 或离开浏览器标签页只是断开连接,重新打开原生或浏览器对话即可继续观察工作。
12
12
  - **批准之前不会修改任何文件。**
13
13
  任务先只读分析并提出一个可读的计划;只有在你确认那个确切计划之后,文件才会被修改。
14
14
  - **结果可信。**
15
15
  子代理输出、真实的检查运行和你自己的审阅彼此独立:模型的文字或一句“Done”都不算检查通过,失败、取消和未知结果保持相互区分。
16
16
  - **完整历史。**
17
- 每次运行都保留其消息、工具调用和输出,支持精确搜索与完整的 Markdown/NDJSON 导出;已知的秘密会被脱敏。
17
+ 新工作流保留脱敏后的子代理记录与实际进程结果;旧任务历史另支持精确搜索及 Markdown/NDJSON 导出。
18
18
  - **一个链接涵盖一切。**
19
19
  WebUI(桌面和手机,英文与简体中文)还承载普通的 Pi 对话,并可在项目间切换,每个项目都有自己的 owner 和历史。
20
20
 
@@ -26,11 +26,10 @@ Cadence 是一个受信任的助手,**不是沙箱**:它的代理用宿主
26
26
 
27
27
  ```sh
28
28
  npm install -g @abelxiaoxing/cadence
29
- cadence server install
30
29
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
31
30
  ```
32
31
 
33
- `cadence server install` 注册并启动一个后台服务(Linux 上是 systemd,macOS 上是 LaunchAgent,Windows 上是登录项),并打印一个私有链接 `http://127.0.0.1:17423/?token=…`。
32
+ 可选 WebUI/开机服务使用显式命令 `cadence server install` 注册并启动一个后台服务(Linux 上是 systemd,macOS 上是 LaunchAgent,Windows 上是登录项),并打印一个私有链接 `http://127.0.0.1:17423/?token=…`。
34
33
  最后一条命令让 Pi 加载同一份副本用于 `/cadence`,因此一次 npm 升级就同时更新两者。
35
34
  端口和 token 保存在 `~/.pi/agent/cadence/.env`;任何持有 token 的人都可以使用你的工作区,所以请保持链接私密。
36
35
 
@@ -40,17 +39,35 @@ pi install "$(npm root -g)/@abelxiaoxing/cadence"
40
39
 
41
40
  1. 打开一次打印出的链接;浏览器之后会记住你。
42
41
  如果丢失了链接,`cadence token-link --reveal` 会再次打印它。
43
- 2. 用右下角的文件夹按钮选择项目文件夹,并选择模型。
44
- 3. 发送一条消息进行普通对话,或以 `cadence <goal>` 开头(或选择“Cadence 任务”)创建任务。
45
- 4. 当分析提出计划时,打开**查看实施计划**,选择**确认计划并执行**。
46
- 5. 在左下角的 dock 中查看子代理;检查、变更和审阅在右侧的**任务详情**下。
42
+ 2. 用右下角的文件夹按钮明确选择项目。
43
+ 发送时复用已保存的模型偏好;没有可用偏好时只需选择一次。
44
+ 3. 输入一次 `/cadence [目标]`,当前对话进入持续 Cadence 模式;之后正常对话,调查项目并反复澄清需求。
45
+ 4. 查看完整计划,点击**按此计划实施**或发送 `按计划实施`。
46
+ 后台自动实施、检查、有限修复,并按计划完成本地交付。
47
+ 5. 在同一对话查看真实进度、子代理记录和合并结果。
48
+ 刷新、完成目标后仍保持 Cadence;**退出 Cadence**不取消后台工作,**取消工作流 — 请求停止**才请求取消。
47
49
 
48
- ### 在终端中
50
+ “旧版任务”入口明确保留原有创建任务、Save/Start、独立检查和人工 Review 路径。
49
51
 
50
- 在 Pi 的 TUI 里,自己输入 `/cadence [goal]` 并按回车;粘贴或脚本输入不会打开它。
51
- 选择模型,创建或打开任务,编辑其计划并确认 Start;菜单还会显示子代理、检查、变更、审阅和历史。
52
+ ### 在终端中:一次进入,持续对话
52
53
 
53
- 每个 Pi 会话还在输入框上方显示运行中的后台代理:在空输入框上按 ↓ 选择一个,再按 Enter 阅读其记录(`CADENCE_AGENT_PANEL=off` 可隐藏该面板)。
54
+ 在任意已信任项目的 Pi 对话里输入一次 `/cadence <目标>`,之后正常对话即可。
55
+ Cadence 自动调查仓库、汇总需要你决定的问题,并与你反复对齐需求,生成包含范围、依赖、并行安排、环境准备、检查及交付策略的计划。
56
+ 完整计划确认后,输入 `按计划实施`,系统自动实施、审查、验证、进行有界修复,并按约定完成本地交付。
57
+ 独立 Git 任务在不同 worktree 中并行,验证后本地合并;不会默认推送、发布或部署。
58
+ 非 Git 项目可选择直接工作副本交付,不执行提交或合并。
59
+
60
+ **完成任务后,这个对话仍然保持 Cadence 模式,不需要再次输入 `/cadence`。**
61
+ 明确输入 `退出 Cadence` 或 `exit cadence` 才退出。
62
+ 退出、关闭 Pi 或切换对话只脱离观察,不取消已接受的工作;需要取消时直接告诉 Cadence。
63
+
64
+ 日常原生使用可按需启动或复用本地项目 owner,**无需安装系统服务或先进入项目管理器**。
65
+ 模型偏好记在 `~/.pi/agent/cadence/settings.json`,跨项目复用,不复制 Pi 凭据。
66
+ 项目知识维护在 `.cadence/project.md`;隔离 worktree 不会自动复制依赖或凭据,必要的准备命令会列入计划确认。
67
+
68
+ 详细边界见 [对话模式](docs/conversation-mode.md)。
69
+ 旧高级检查入口保留为 `/cadence-inspect`,不再作为日常流程。
70
+ 浏览器批准与所展示的计划、会话和访问身份绑定;登录本身不是执行授权。
54
71
 
55
72
  ### 更多项目
56
73
 
@@ -64,7 +81,8 @@ cadence project open /absolute/new-project --create
64
81
 
65
82
  ### 检查
66
83
 
67
- 在 `.cadence/assistant/config.json` 中列出验证你项目的命令,任务就可以在审阅前作为真实检查运行它们:
84
+ 新工作流的检查命令在批准的计划中明确列出。
85
+ 旧版任务可以在 `.cadence/assistant/config.json` 中配置检查:
68
86
 
69
87
  ```json
70
88
  {