@abelxiaoxing/cadence 2.0.50 → 2.1.1

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.ja.md CHANGED
@@ -2,141 +2,123 @@
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 からレビューします。
7
- 両方とも同じバックグラウンドサービスに接続します。
8
-
9
- ## なぜ Cadence か
10
-
11
- - **作業はウィンドウを超えて残る。**
12
- タスクはバックグラウンドサービスで実行されます。
13
- ターミナルを閉じても、Pi を終了しても、ブラウザのタブを離れても、それらはデタッチするだけで、どちらのクライアントも同じ実行に再接続できます。
14
- - **承認するまで何も編集されない。**
15
- タスクはまず読み取り専用で分析し、読みやすい計画を提案します。
16
- ファイルが変更されるのは、あなたがその正確な計画を確認した後のみです。
17
- - **信頼できる結果。**
18
- サブエージェントの出力、実際のチェック実行、あなた自身のレビューは別々に保たれます。
19
- モデルの文章や「Done」はチェック通過としては数えず、失敗・キャンセル・不明の結果は区別されたままです。
20
- - **完全な履歴。**
21
- 各実行はメッセージ、ツール呼び出し、出力を保持し、正確な検索と完全な Markdown/NDJSON エクスポートをサポートします。
22
- 既知のシークレットはマスクされます。
23
- - **ターミナルと共有される履歴。**
24
- ブラウザーの会話はプロジェクトの Pi セッションそのものです。
25
- ターミナルのセッションをブラウザーで続けることも、ブラウザーのセッションを `/resume` で続けることもでき、Pi のブランチはどちらからでも読めます。
26
- - **すべてに一つのリンク。**
27
- WebUI(デスクトップとスマホ、英語と簡体字中国語)は通常の Pi 会話もホストし、プロジェクト間で切り替えられます。
28
- 各プロジェクトには独自の owner と履歴があります。
29
-
30
- Cadence は信頼できるアシスタントであり、**サンドボックスではありません**。
31
- そのエージェントはホストツールであなたの作業コピーを直接編集するため、レビューと復旧が可能なコードで使うください。
5
+ Cadence は [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) を会話駆動のエンジニアリングワークフローにします。
6
+ `/cadence [目標]` を入力し、成果を一度合意すれば、常駐 owner が実装・復旧・検証を進めます。
7
+ ターミナルでも、任意の WebUI でも使えます。
8
+
9
+ ## 仕組み
10
+
11
+ ```mermaid
12
+ flowchart TD
13
+ A["/cadence 目標"] --> B["読み取り専用で調査"]
14
+ B --> C["合意して一度だけ承認"]
15
+ C --> D["独立したタスクを並列 worktree で実行"]
16
+ D --> E["実際のチェック + 自動 Agent レビュー"]
17
+ E -->|"合格"| F["あなたのブランチへローカル統合"]
18
+ E -->|"不合格"| G["自己修正"]
19
+ G --> D
20
+ F --> H["知識を整理(固定予算)"]
21
+ H -.-> B
22
+ ```
23
+
24
+ ```mermaid
25
+ flowchart LR
26
+ A["チェック不合格"] --> B["修復"] --> C["経路の再計画"] --> D["偏差を記録"] --> E["外部要因でのみ停止"]
27
+ ```
28
+
29
+ ```mermaid
30
+ flowchart LR
31
+ T["Pi ターミナル"] <-->|"接続 / 切断"| O[("常駐 owner")]
32
+ W["WebUI<br/>ボード · ブランチ · 割り込み"] <-->|"接続 / 切断"| O
33
+ O --> X["worktree 内の worker"] --> Y["あなたのブランチ"]
34
+ O -.-> K[".cadence/ 知識"]
35
+ ```
36
+
37
+ ## Cadence を使う理由
38
+
39
+ | | |
40
+ | ---------------------------------- | ------------------------------------------------------------------------------------------- |
41
+ | **ウィンドウを閉じても作業は続く** | クライアントは接続と切断だけ。owner は動き続けます。 |
42
+ | **承認前は何も変更しない** | 読み取り専用の調査の後、読める合意を一つ確認します。 |
43
+ | **信頼できる結果** | 実際のチェックと独立レビュー。モデルの文面は合格になりません。 |
44
+ | **自力で完了** | 承認後は修復・再計画・偏差の記録を自動で行い、リポジトリ外の要因でのみ停止します。 |
45
+ | **設計から高速** | 独立したタスクは各 worktree で並列に動きます。 |
46
+ | **知識が積み上がる** | ルーティング表と固定予算。worker は該当部分だけを読み、新しい知見が古いものを置き換えます。 |
47
+ | **見えて操作できる WebUI** | タスクボード、経路の改訂、偏差、ブランチ、思考。返信中に割り込みや後送りも可能。 |
48
+ | **一つの履歴** | ブラウザの会話はプロジェクトの Pi セッション。どちらでも続けられます。 |
49
+
50
+ > Cadence は信頼されたアシスタントであり、**サンドボックスではありません**。
51
+ > エージェントは承認された checkout / worktree でホストのツールを使います。
52
+ > 確認と復旧ができるコードで使ってください。
32
53
 
33
54
  ## インストール
34
55
 
35
- npm を備えた Node `>=22.19.0`、モデルプロバイダーにログイン済みでインストールされた Pi が必要です。
36
- Cadence は Pi のログインとモデル設定を再利用します。
56
+ Node `>=22.19.0` と、モデルプロバイダーにログイン済みの Pi が必要です。
57
+ Cadence は Pi のログインを再利用します。
37
58
 
38
59
  ```sh
39
60
  npm install -g @abelxiaoxing/cadence
40
61
  pi install "$(npm root -g)/@abelxiaoxing/cadence"
62
+ cadence server install # 任意の WebUI と起動時サービス
41
63
  ```
42
64
 
43
- `cadence server install` はバックグラウンドサービスを登録して起動し(Linux では systemd、macOS では LaunchAgent、Windows ではログイン項目)、プライベートリンク `http://127.0.0.1:17423/?token=…` を表示します。
44
- 最後のコマンドは Pi に同じコピーを `/cadence` で読み込ませるため、npm でのアップグレード 1 回で両方が更新されます。
45
- ポートとトークンは `~/.pi/agent/cadence/.env` にあります。
46
- トークンを所持する者はあなたのワークスペースを使えるため、リンクは秘密にしてください。
65
+ `cadence server install` はプライベートリンク(`http://127.0.0.1:17423/?token=…`)を表示します。
66
+ トークンはワークスペースへのアクセスを許すため、リンクは公開しないでください。
47
67
 
48
68
  ## 使い方
49
69
 
50
- ### ブラウザで
70
+ ### ブラウザ
51
71
 
52
- 1. 表示されたリンクを一度開く。
53
- その後ブラウザはあなたを覚えておく。
54
- リンクを紛失した場合は `cadence token-link --reveal` で再度表示できます。
55
- 2. プロジェクトフォルダを選びます。
56
- 送信時に保存済みのモデル設定を再利用します。
57
- 設定がない場合だけモデルを選んでください。
58
- 3. 一度だけ `/cadence [目標]` を送信します。
59
- この会話は Cadence モードを維持し、その後は通常のメッセージで要件を明確にできます。
60
- 4. 完全な計画を確認し、**Implement this plan** を押します。
61
- 実装、検証、障害からの自動復旧、合意したローカル納品が自動で進みます。
62
- 5. 同じ会話で進捗を確認し、サブエージェントの記録は左下の **Subagents** パネルから開きます。
63
- 再読み込みや目標完了でもモードは維持されます。
64
- **Exit Cadence** はモード終了のみ、**Cancel workflow — request stop** は作業のキャンセル要求です。
72
+ 1. 表示されたリンクを一度開きます(`cadence token-link --reveal` で再表示)。
73
+ 2. 右下のボタンで作業フォルダを選びます。
74
+ 3. `/cadence [目標]` を送り、確認の質問に答えます。
75
+ 4. **Implement this plan** を押し、ボードと **Subagents** ドックで進捗を追います。
76
+ 画像は貼り付けやドロップで追加できます([詳細](docs/conversation-mode.md#images-in-the-webui))。
65
77
 
66
- No live Pi terminal is required for the browser conversation workflow.
78
+ ### ターミナル
67
79
 
68
- ### ターミナルで
69
-
70
- `/cadence <目標>` を一度入力した後は、通常の会話を続けます。
71
- Cadence がプロジェクトを調査し、必要な判断を確認して計画を作ります。
72
- 計画への明示的な承認後は、実装・検証・自動復旧・合意したローカル統合を自動で進めます。
73
-
74
- 目標が完了しても、この会話では Cadence モードを維持します。
75
- 終了するには `exit cadence` と入力します。
76
- 終了は実行中の作業をキャンセルしません。
77
- モデル設定は `~/.pi/agent/cadence/settings.json` に保存され、プロジェクト間で再利用されます。
78
-
79
- ローカル owner は必要時に起動します。
80
- システムサービスのインストールは WebUI・自動起動を使う場合のみ必要です。
81
-
82
- `/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
83
- See [History and diagnostics](docs/history.md).
84
- [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
85
- Browser authentication is not execution consent.
86
-
87
- ### その他のプロジェクト
80
+ 信頼するプロジェクトの Pi 会話で `/cadence <目標>` を一度入力します。
81
+ 目標が完了してもモードは維持されます。
82
+ `exit cadence` または `退出 Cadence` で終了しますが、承認済みの作業は取り消されません。
83
+ `/cadence-history [run-id]` は読み取り専用です。
84
+ `CADENCE_PARALLEL`(既定 4)で同時 worker 数を設定します。
85
+ 詳細:[会話モード](docs/conversation-mode.md)、[履歴](docs/history.md)。
88
86
 
89
87
  ```sh
90
- cadence project open /absolute/project
91
- cadence project open /absolute/new-project --create
88
+ cadence project open /absolute/project # プロジェクトごとに独立した owner・ポート・履歴
92
89
  ```
93
90
 
94
- 各プロジェクトには独自の owner、ポート、履歴があり、コマンドはそのプライベートリンクを表示する。
95
- WebUI のフォルダピッカーも同じ方法でプロジェクトを開く。
96
- 別のプロジェクトを開いても、前のプロジェクトでの作業は止まらない。
97
-
98
- ### チェック
99
-
100
- チェックコマンドは、明示的に承認する計画に記載します。
101
- 開始前のチェックと受け入れチェックの実際の結果は、自動 Agent レビューとは別に記録されます。
102
-
103
- ## サービスの管理
91
+ ## サービス管理
104
92
 
105
93
  ```sh
106
94
  cadence server status
107
95
  cadence server restart # アップグレードや .env / models.json の変更後
108
- cadence server upgrade
109
- cadence server stop # 登録は保持され、次の起動またはログイン時に再び起動する
110
- cadence server uninstall # npm uninstall -g の前に実行
96
+ cadence server upgrade # 取得・インストール・再起動。新版が起動しなければ戻す
97
+ cadence server stop
98
+ cadence server uninstall # npm uninstall -g の前に
99
+ cadence doctor # 残骸と最近の復旧。--fix で残りを処理
111
100
  ```
112
101
 
113
- `cadence server upgrade` または WebUI の Cadence サービスダイアログでアップグレードします。
114
- Cadence の実行中に新しいバージョンを取得し、新しいバージョンが起動しない場合は以前のバージョンに戻します。
115
- restart、stop、uninstall はデタッチしたままにせずに、実行中の作業を順番に停止する。
116
- uninstall はサービス定義のみを削除する。
117
- プロジェクト、履歴、Pi の設定は残る。
118
- Linux ルートおよび名前付きサービス、リモート HTTPS アクセス、回復は[サービス管理](docs/service-management.md)と[リモートアクセス](docs/remote-access.md)を参照。
102
+ クラッシュや停電の後始末は不要です。
103
+ 次回起動時に自動復旧し、何をしたか表示します。
104
+ [サービス管理](docs/service-management.md)、[リモートアクセス](docs/remote-access.md)を参照。
119
105
 
120
106
  ## 開発
121
107
 
122
- Pi はローカル checkout やパックされた tarball も読み込める。
123
- その絶対または相対パスを Pi の `packages` に追加するか、`pi -e ./cadence` を試す。
124
- Cadence には Pi 1.5.0 または互換性のある 1.x ホストが必要。
125
- 開発用のピンとテスト済みのランタイムは、普遍的な互換性の約束ではない。
108
+ Pi はローカル checkout やパック済み tarball も読み込めます。
109
+ 絶対パスまたは相対パスを Pi の `packages` に追加するか、`pi -e ./cadence` を試してください。
110
+ Cadence は Pi 1.5.0 または互換の 1.x ホストを必要とします。
111
+ 開発用のピンとテスト済みランタイムは、普遍的な互換性の約束ではありません。
126
112
 
127
113
  ```sh
128
114
  bun install
129
115
  bun run verify
130
116
  ```
131
117
 
132
- エンジニアリングのガイダンスは [engineering/](engineering/) 下に領域ごとに分割されている。
133
- [AGENTS.md](AGENTS.md) のプロジェクト索引がどのファイルがどのコードをカバーするかを示す。
134
- `verify` には公式 Node ビルドとプライベートな一時ディレクトリが必要。
135
- `verify` は開発とリリース共通の唯一の検証コマンドで、高速なチェックのみを実行し、ブラウザは不要。
136
- [検証](engineering/verification.md)を参照。
118
+ 領域別のガイドは [engineering/](engineering/) と [AGENTS.md](AGENTS.md)。
119
+ `verify` が唯一の高速ゲートで、公式 Node ビルドと専用の一時ディレクトリが必要です([検証](engineering/verification.md))。
137
120
 
138
121
  ## ライセンス
139
122
 
140
- Cadence は MIT です。
141
- バンドルされた適応コード、フォント、ベンダーはそれぞれのライセンスを保持。
142
- [再利用と配布](docs/reuse-and-distribution.md)と[サードパーティ通知](THIRD_PARTY_NOTICES.md)を参照。
123
+ MIT。
124
+ 同梱の改変、フォント、ベンダー部品は各ライセンスを保持します:[再利用と配布](docs/reuse-and-distribution.md)、[サードパーティ通知](THIRD_PARTY_NOTICES.md)。
package/README.ko.md CHANGED
@@ -2,138 +2,122 @@
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에서 검토하세요.
7
- 둘 다 같은 백그라운드 서비스에 연결됩니다.
8
-
9
- ## 왜 Cadence인가
10
-
11
- - **작업은 창보다 오래 지속됩니다.**
12
- 작업은 백그라운드 서비스에서 실행됩니다.
13
- 터미널을 닫거나, Pi를 종료하거나, 브라우저 탭을 떠나도 단지 연결이 끊어지며, 어느 클라이언트든 같은 실행에 다시 연결할 수 있습니다.
14
- - **승인하기 전에는 아무것도 수정되지 않습니다.**
15
- 작업은 먼저 읽기 전용으로 분석하고 읽을 수 있는 계획을 제안합니다.
16
- 파일은 정확히 그 계획을 확인한 후에만 수정됩니다.
17
- - **신뢰할 수 있는 결과.**
18
- 서브에이전트 출력, 실제 체크 실행, 그리고 본인의 검토는 서로 분리됩니다.
19
- 모델의 글이나 "Done"은 체크 통과로 간주되지 않으며, 실패·취소·unknown 결과는 서로 구분됩니다.
20
- - **완전한 역사.**
21
- 모든 실행은 메시지, 도구 호출, 출력을 보관하며, 정확한 검색과 완전한 Markdown/NDJSON 내보내기를 지원합니다.
22
- 알려진 비밀은 마스킹됩니다.
23
- - **터미널과 공유하는 기록.**
24
- 브라우저 대화는 프로젝트의 Pi 세션 그 자체입니다.
25
- 터미널 세션을 브라우저에서 이어 가거나 브라우저 세션을 `/resume`으로 이어 갈 수 있고, Pi의 분기는 양쪽에서 모두 볼 수 있습니다.
26
- - **모든 것을 위한 하나의 링크.**
27
- WebUI(데스크톱과 전화, 영어와 간체 중국어)는 일반 Pi 대화도 호스트하며 프로젝트 간 전환이 가능하고, 각 프로젝트는 자체 owner와 역사를 가집니다.
28
-
29
- Cadence는 신뢰할 수 있는 어시스턴트이며 **샌드박스가 아닙니다**.
30
- 그 에이전트는 호스트 도구로 작업 사본을 직접 편집하므로, 검토하고 복구할 수 있는 코드에서만 사용하세요.
31
-
32
- ## 설치
5
+ Cadence는 [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent)를 대화 중심의 엔지니어링 워크플로로 바꿉니다.
6
+ `/cadence [목표]`를 입력해 결과를 한 번 합의하면 상주 owner가 구현, 복구, 검증을 진행합니다.
7
+ 터미널이나 선택적 WebUI에서 쓸 수 있습니다.
8
+
9
+ ## 작동 방식
10
+
11
+ ```mermaid
12
+ flowchart TD
13
+ A["/cadence 목표"] --> B["읽기 전용 조사"]
14
+ B --> C["정렬 후 한 번만 승인"]
15
+ C --> D["독립 작업을 병렬 worktree에서 실행"]
16
+ D --> E["실제 검사 + 자동 Agent 리뷰"]
17
+ E -->|"통과"| F["내 브랜치로 로컬 병합"]
18
+ E -->|"실패"| G["자체 수정"]
19
+ G --> D
20
+ F --> H["지식 정리 (고정 예산)"]
21
+ H -.-> B
22
+ ```
33
23
 
34
- npm이 있는 Node `>=22.19.0`과 모델 제공자에 로그인되어 설치된 Pi가 필요합니다.
35
- Cadence는 Pi의 로그인과 모델 설정을 재사용합니다.
24
+ ```mermaid
25
+ flowchart LR
26
+ A["검사 실패"] --> B["수리"] --> C["경로 재계획"] --> D["편차 기록"] --> E["외부 조건일 때만 중단"]
27
+ ```
36
28
 
37
- ```sh
38
- npm install -g @abelxiaoxing/cadence
39
- pi install "$(npm root -g)/@abelxiaoxing/cadence"
29
+ ```mermaid
30
+ flowchart LR
31
+ T["Pi 터미널"] <-->|"연결 / 해제"| O[("상주 owner")]
32
+ W["WebUI<br/>보드 · 브랜치 · 끼어들기"] <-->|"연결 / 해제"| O
33
+ O --> X["worktree의 worker"] --> Y["내 브랜치"]
34
+ O -.-> K[".cadence/ 지식"]
40
35
  ```
41
36
 
42
- `cadence server install`은 백그라운드 서비스를 등록하고 시작합니다(Linux에서는 systemd, macOS에서는 LaunchAgent, Windows에서는 로그인 항목)하며, 개인 링크 `http://127.0.0.1:17423/?token=…`를 출력합니다.
43
- 마지막 명령은 Pi가 `/cadence`용으로 같은 사본을 로드하므로, npm 업그레이드 한 번으로 둘 다 업데이트됩니다.
44
- 포트와 토큰은 `~/.pi/agent/cadence/.env`에 있습니다.
45
- 토큰을 가진 사람은 누구나 워크스페이스를 사용할 수 있으므로 링크를 비공개로 유지하세요.
37
+ ## Cadence를 쓰는 이유
38
+
39
+ | | |
40
+ | ------------------------------------ | ------------------------------------------------------------------------------------- |
41
+ | **창을 닫아도 작업은 계속** | 클라이언트는 연결과 해제만 합니다. owner는 계속 실행됩니다. |
42
+ | **승인 전에는 아무것도 바꾸지 않음** | 읽기 전용 조사 후 읽을 수 있는 합의 하나를 확인합니다. |
43
+ | **믿을 수 있는 결과** | 실제 검사와 독립 리뷰. 모델의 문장은 통과로 인정되지 않습니다. |
44
+ | **스스로 완료** | 승인 후 수리, 재계획, 편차 기록을 알아서 하고 저장소 밖의 조건에서만 멈춥니다. |
45
+ | **구조적으로 빠름** | 독립 작업은 각자의 worktree에서 나란히 실행됩니다. |
46
+ | **지식이 쌓임** | 라우트 표와 고정 예산. worker는 해당 부분만 읽고 새 교훈이 낡은 것을 대체합니다. |
47
+ | **보고 조종하는 WebUI** | 작업 보드, 경로 수정, 편차, 브랜치, 사고 과정. 응답 중 끼어들기나 대기열 전송도 가능. |
48
+ | **하나의 기록** | 브라우저 대화는 프로젝트의 Pi 세션이며 어느 쪽에서든 이어갈 수 있습니다. |
46
49
 
47
- ## 사용
50
+ > Cadence는 신뢰하는 어시스턴트이며 **샌드박스가 아닙니다**.
51
+ > 에이전트는 승인된 checkout 또는 worktree에서 호스트 도구를 사용합니다.
52
+ > 검토하고 복구할 수 있는 코드에만 사용하세요.
48
53
 
49
- ### 브라우저에서
54
+ ## 설치
50
55
 
51
- 1. 출력된 링크를 한 번 엽니다.
52
- 그 후 브라우저가 당신을 기억합니다.
53
- 링크를 잃어버리면 `cadence token-link --reveal`이 다시 출력합니다.
54
- 2. 프로젝트 폴더를 선택하세요.
55
- 전송 시 저장된 모델 설정을 재사용하며, 설정이 없을 때만 한 번 선택합니다.
56
- 3. `/cadence [목표]`를 한 번 전송하세요.
57
- 이 대화는 Cadence 모드를 유지하며 이후에는 일반 메시지로 요구사항을 구체화합니다.
58
- 4. 전체 계획을 확인하고 **Implement this plan**을 누르세요.
59
- 구현, 검사, 자동 복구 및 합의한 로컬 전달을 자동으로 진행합니다.
60
- 5. 같은 대화에서 진행 상황을 확인하고, 서브에이전트 기록은 왼쪽 아래 **Subagents** 패널에서 여세요.
61
- 새로고침이나 목표 완료로 모드가 꺼지지 않습니다.
62
- **Exit Cadence**는 모드만 종료하고, **Cancel workflow — request stop**은 작업 취소를 요청합니다.
56
+ Node `>=22.19.0`과 모델 제공자에 로그인한 Pi가 필요합니다.
57
+ Cadence는 Pi의 로그인을 재사용합니다.
63
58
 
64
- No live Pi terminal is required for the browser conversation workflow.
59
+ ```sh
60
+ npm install -g @abelxiaoxing/cadence
61
+ pi install "$(npm root -g)/@abelxiaoxing/cadence"
62
+ cadence server install # 선택 사항: WebUI와 부팅 서비스
63
+ ```
65
64
 
66
- ### 터미널에서
65
+ `cadence server install`은 비공개 링크(`http://127.0.0.1:17423/?token=…`)를 출력합니다.
66
+ 토큰으로 작업 공간에 접근할 수 있으니 링크를 공개하지 마세요.
67
67
 
68
- `/cadence <목표>`를 한 번 입력한 다음 평소처럼 대화하세요.
69
- Cadence가 프로젝트를 조사하고 결정 사항을 확인한 뒤 계획을 만듭니다.
70
- 명시적으로 계획을 승인하면 구현, 검증, 자동 복구 및 합의한 로컬 통합을 자동으로 진행합니다.
68
+ ## 사용법
71
69
 
72
- 목표가 완료되어도 이 대화는 Cadence 모드를 유지합니다.
73
- `exit cadence`로 종료할 수 있으며, 종료는 이미 승인된 작업을 취소하지 않습니다.
74
- 모델 설정은 `~/.pi/agent/cadence/settings.json`에 저장되어 프로젝트 간 재사용됩니다.
70
+ ### 브라우저
75
71
 
76
- 로컬 owner는 필요할 때 시작됩니다.
77
- 시스템 서비스는 선택적인 WebUI 및 자동 시작용입니다.
72
+ 1. 출력된 링크를 한 번 엽니다(`cadence token-link --reveal`로 다시 출력).
73
+ 2. 오른쪽 아래 버튼으로 작업 폴더를 고릅니다.
74
+ 3. `/cadence [목표]`를 보내고 확인 질문에 답합니다.
75
+ 4. **Implement this plan**을 누르고 보드와 **Subagents** 도크에서 진행을 확인합니다.
76
+ 이미지는 붙여넣기나 드롭으로 추가합니다([자세히](docs/conversation-mode.md#images-in-the-webui)).
78
77
 
79
- `/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
80
- See [History and diagnostics](docs/history.md).
81
- [Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
82
- Browser authentication is not execution consent.
78
+ ### 터미널
83
79
 
84
- ### 더 많은 프로젝트
80
+ 신뢰하는 프로젝트의 Pi 대화에서 `/cadence <목표>`를 한 번 입력합니다.
81
+ 목표가 끝나도 모드는 유지됩니다.
82
+ `exit cadence` 또는 `退出 Cadence`로 종료하며, 승인된 작업은 취소되지 않습니다.
83
+ `/cadence-history [run-id]`는 읽기 전용입니다.
84
+ `CADENCE_PARALLEL`(기본 4)이 동시 worker 수를 정합니다.
85
+ 자세히: [대화 모드](docs/conversation-mode.md), [기록](docs/history.md).
85
86
 
86
87
  ```sh
87
- cadence project open /absolute/project
88
- cadence project open /absolute/new-project --create
88
+ cadence project open /absolute/project # 프로젝트마다 독립된 owner, 포트, 기록
89
89
  ```
90
90
 
91
- 각 프로젝트는 자체 owner, 포트, 역사를 가지며, 명령은 그 개인 링크를 출력합니다.
92
- WebUI 폴더 선택기도 같은 방법으로 프로젝트를 엽니다.
93
- 다른 프로젝트를 열어도 이전 프로젝트의 작업은 멈추지 않습니다.
94
-
95
- ### 체크
96
-
97
- 기준 검사와 인수 검사의 명령은 명시적으로 승인하는 계획에 포함됩니다.
98
- 실제 검사 결과는 자동 Agent 검토와 별도로 기록됩니다.
99
-
100
91
  ## 서비스 관리
101
92
 
102
93
  ```sh
103
94
  cadence server status
104
95
  cadence server restart # 업그레이드나 .env / models.json 변경 후
105
- cadence server upgrade
106
- cadence server stop # 등록은 유지되고 다음 부팅 또는 로그인 시 다시 시작
107
- cadence server uninstall # npm uninstall -g 전에 실행
96
+ cadence server upgrade # 가져오기, 설치, 재시작. 새 버전이 시작되지 않으면 되돌림
97
+ cadence server stop
98
+ cadence server uninstall # npm uninstall -g 전에
99
+ cadence doctor # 잔여물과 최근 복구. 나머지는 --fix
108
100
  ```
109
101
 
110
- `cadence server upgrade` 또는 WebUI의 Cadence 서비스 대화 상자로 업그레이드합니다.
111
- Cadence가 실행 중일 때 새 버전을 받아 두고, 새 버전이 시작되지 않으면 이전 버전으로 되돌립니다.
112
- Restart, stop, uninstall는 작업이 연결 끊긴 채로 남지 않도록 실행 중인 작업을 순서대로 멈춥니다.
113
- Uninstall은 서비스 정의만 제거합니다.
114
- 프로젝트, 역사, Pi 설정은 유지됩니다.
115
- Linux 루트 및 이름 지정 서비스, 원격 HTTPS 액세스, 복구에는 [서비스 관리](docs/service-management.md)와 [원격 액세스](docs/remote-access.md)를 참조하세요.
102
+ 충돌이나 정전 후에도 정리가 필요 없습니다.
103
+ 다음 시작 때 자동 복구하고 무엇을 했는지 알려 줍니다.
104
+ [서비스 관리](docs/service-management.md), [원격 접속](docs/remote-access.md) 참고.
116
105
 
117
106
  ## 개발
118
107
 
119
- Pi는 로컬 체크아웃이나 패킹된 tarball도 로드할 수 있습니다.
120
- 그 절대 또는 상대 경로를 Pi의 `packages`에 추가하거나, `pi -e ./cadence`를 시도하세요.
108
+ Pi는 로컬 checkout이나 패킹된 tarball도 불러올 수 있습니다.
109
+ 절대 또는 상대 경로를 Pi의 `packages`에 추가하거나 `pi -e ./cadence`를 써 보세요.
121
110
  Cadence는 Pi 1.5.0 또는 호환되는 1.x 호스트가 필요합니다.
122
- 개발 고정 버전과 테스트된 런타임은 보편적인 호환성 약속이 아닙니다.
111
+ 개발용 고정 버전과 테스트된 런타임은 범용 호환성 약속이 아닙니다.
123
112
 
124
113
  ```sh
125
114
  bun install
126
115
  bun run verify
127
116
  ```
128
117
 
129
- 엔지니어링 지침은 [engineering/](engineering/) 아래 영역별로 나뉘어 있습니다.
130
- [AGENTS.md](AGENTS.md)의 프로젝트 인덱스가 어느 파일이 어느 코드를 다루는지 설명합니다.
131
- `verify`는 개발과 릴리스에 사용하는 유일한 검증 명령으로, 빠른 검사만 실행하며 브라우저가 필요하지 않습니다.
132
- 공식 Node 빌드와 개인 임시 디렉터리가 필요합니다.
133
- [검증](engineering/verification.md)을 참조하세요.
118
+ 영역별 안내는 [engineering/](engineering/)와 [AGENTS.md](AGENTS.md). `verify`는 유일한 빠른 게이트이며 공식 Node 빌드와 비공개 임시 디렉터리가 필요합니다([검증](engineering/verification.md)).
134
119
 
135
120
  ## 라이선스
136
121
 
137
- Cadence는 MIT입니다.
138
- 번들된 적응 코드, 폰트, 벤더는 각각의 라이선스를 유지합니다.
139
- [재사용 및 배포](docs/reuse-and-distribution.md)와 [서드파티 공지](THIRD_PARTY_NOTICES.md)를 참조하세요.
122
+ MIT.
123
+ 포함된 변형, 글꼴, 외부 구성 요소는 각자의 라이선스를 유지합니다: [재사용과 배포](docs/reuse-and-distribution.md), [서드파티 고지](THIRD_PARTY_NOTICES.md).