@abelxiaoxing/cadence 2.0.22 → 2.0.23
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 +4 -10
- package/README.es.md +4 -10
- package/README.fr.md +4 -10
- package/README.ja.md +4 -10
- package/README.ko.md +4 -10
- package/README.md +5 -13
- package/README.pt-BR.md +4 -10
- package/README.ru.md +4 -10
- package/README.zh-CN.md +4 -12
- package/docs/conversation-mode.md +3 -2
- package/docs/history.md +50 -0
- package/docs/service-management.md +1 -1
- package/package.json +8 -7
- package/src/agent-panel-cadence.ts +4 -4
- package/src/cadence-mode.ts +1 -1
- package/src/data-shapes.ts +16 -0
- package/src/history-shell.ts +370 -0
- package/src/index.ts +3 -3
- package/src/native-build.ts +1 -1
- package/src/native-client.ts +1 -1
- package/src/native-workflow-history.ts +132 -0
- package/src/operator-cli.mjs +93 -65
- package/src/service/checkout-lock.ts +142 -0
- package/src/service/contracts/workbench.ts +43 -23
- package/src/service/contracts/workflow.ts +5 -1
- package/src/service/coordination.ts +6 -7
- package/src/service/private-files.ts +2 -1
- package/src/service-cli.mjs +244 -423
- package/src/service-host.mjs +3475 -6031
- package/src/workspace.ts +302 -0
- package/web/dist/assets/cadence.css +1 -1
- package/web/dist/assets/cadence.js +14 -14
- package/web/dist/manifest.json +7 -7
- package/config/workflow-task.example.json +0 -7
- package/src/plan-proposal.ts +0 -87
- package/src/task-shell.ts +0 -1059
- package/src/task-store.ts +0 -593
- package/src/task-types.ts +0 -184
package/README.de.md
CHANGED
|
@@ -49,7 +49,6 @@ Port und Token liegen in `~/.pi/agent/cadence/.env`; wer das Token hat, kann dei
|
|
|
49
49
|
Aktualisieren und Abschluss beenden den Modus nicht.
|
|
50
50
|
**Exit Cadence** beendet nur den Modus; **Cancel workflow — request stop** fordert den Abbruch an.
|
|
51
51
|
|
|
52
|
-
**Legacy task**: previous task/history workflow.
|
|
53
52
|
No live Pi terminal is required for the browser conversation workflow.
|
|
54
53
|
|
|
55
54
|
### Im Terminal
|
|
@@ -64,7 +63,8 @@ Modellpräferenzen werden projektübergreifend in `~/.pi/agent/cadence/settings.
|
|
|
64
63
|
|
|
65
64
|
Der lokale Owner startet bei Bedarf; ein Systemdienst ist nur für die optionale WebUI/Autostart-Nutzung nötig.
|
|
66
65
|
|
|
67
|
-
`/cadence-
|
|
66
|
+
`/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
|
|
67
|
+
See [History and diagnostics](docs/history.md).
|
|
68
68
|
[Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
|
|
69
69
|
Browser authentication is not execution consent.
|
|
70
70
|
|
|
@@ -80,14 +80,8 @@ Das Öffnen eines anderen Projekts stoppt nie die Arbeit im vorherigen.
|
|
|
80
80
|
|
|
81
81
|
### Checks
|
|
82
82
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
```json
|
|
86
|
-
{
|
|
87
|
-
"schema": "cadence-assistant-checks/1",
|
|
88
|
-
"checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
|
|
89
|
-
}
|
|
90
|
-
```
|
|
83
|
+
Prüfbefehle stehen im ausdrücklich genehmigten Plan, einschließlich Baseline- und Abnahmeprüfungen.
|
|
84
|
+
Ihre tatsächlichen Ergebnisse bleiben von der automatischen Agent-Prüfung getrennt.
|
|
91
85
|
|
|
92
86
|
## Dienst verwalten
|
|
93
87
|
|
package/README.es.md
CHANGED
|
@@ -49,7 +49,6 @@ El puerto y el token están en `~/.pi/agent/cadence/.env`; cualquiera con el tok
|
|
|
49
49
|
Recargar o terminar un objetivo no desactiva el modo.
|
|
50
50
|
**Exit Cadence** sale del modo; **Cancel workflow — request stop** solicita cancelar el trabajo.
|
|
51
51
|
|
|
52
|
-
**Legacy task**: previous task/history workflow.
|
|
53
52
|
No live Pi terminal is required for the browser conversation workflow.
|
|
54
53
|
|
|
55
54
|
### En el terminal
|
|
@@ -64,7 +63,8 @@ Las preferencias de modelo se guardan entre proyectos en `~/.pi/agent/cadence/se
|
|
|
64
63
|
|
|
65
64
|
El propietario local se inicia bajo demanda; el servicio del sistema es opcional para WebUI/inicio automático.
|
|
66
65
|
|
|
67
|
-
`/cadence-
|
|
66
|
+
`/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
|
|
67
|
+
See [History and diagnostics](docs/history.md).
|
|
68
68
|
[Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
|
|
69
69
|
Browser authentication is not execution consent.
|
|
70
70
|
|
|
@@ -80,14 +80,8 @@ Abrir otro proyecto nunca detiene el trabajo del anterior.
|
|
|
80
80
|
|
|
81
81
|
### Comprobaciones
|
|
82
82
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
```json
|
|
86
|
-
{
|
|
87
|
-
"schema": "cadence-assistant-checks/1",
|
|
88
|
-
"checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
|
|
89
|
-
}
|
|
90
|
-
```
|
|
83
|
+
Los comandos de verificación se declaran en el plan aprobado, incluidas las comprobaciones iniciales y de aceptación.
|
|
84
|
+
Sus resultados reales se mantienen separados de la revisión automática del agente.
|
|
91
85
|
|
|
92
86
|
## Gestionar el servicio
|
|
93
87
|
|
package/README.fr.md
CHANGED
|
@@ -49,7 +49,6 @@ Le port et le jeton se trouvent dans `~/.pi/agent/cadence/.env` ; quiconque poss
|
|
|
49
49
|
Actualiser ou terminer un objectif ne quitte pas le mode.
|
|
50
50
|
**Exit Cadence** quitte le mode ; **Cancel workflow — request stop** demande l’annulation.
|
|
51
51
|
|
|
52
|
-
**Legacy task**: previous task/history workflow.
|
|
53
52
|
No live Pi terminal is required for the browser conversation workflow.
|
|
54
53
|
|
|
55
54
|
### Dans le terminal
|
|
@@ -64,7 +63,8 @@ Les préférences de modèle sont conservées entre projets dans `~/.pi/agent/ca
|
|
|
64
63
|
|
|
65
64
|
Le propriétaire local démarre à la demande ; le service système est facultatif pour la WebUI et le démarrage automatique.
|
|
66
65
|
|
|
67
|
-
`/cadence-
|
|
66
|
+
`/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
|
|
67
|
+
See [History and diagnostics](docs/history.md).
|
|
68
68
|
[Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
|
|
69
69
|
Browser authentication is not execution consent.
|
|
70
70
|
|
|
@@ -80,14 +80,8 @@ Ouvrir un autre projet n'arrête jamais le travail du précédent.
|
|
|
80
80
|
|
|
81
81
|
### Vérifications
|
|
82
82
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
```json
|
|
86
|
-
{
|
|
87
|
-
"schema": "cadence-assistant-checks/1",
|
|
88
|
-
"checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
|
|
89
|
-
}
|
|
90
|
-
```
|
|
83
|
+
Les commandes de vérification figurent dans le plan explicitement approuvé, avec les vérifications initiales et d’acceptation.
|
|
84
|
+
Leurs résultats restent distincts de la revue automatique par un Agent.
|
|
91
85
|
|
|
92
86
|
## Gérer le service
|
|
93
87
|
|
package/README.ja.md
CHANGED
|
@@ -60,7 +60,6 @@ pi install "$(npm root -g)/@abelxiaoxing/cadence"
|
|
|
60
60
|
再読み込みや目標完了でもモードは維持されます。
|
|
61
61
|
**Exit Cadence** はモード終了のみ、**Cancel workflow — request stop** は作業のキャンセル要求です。
|
|
62
62
|
|
|
63
|
-
**Legacy task**: previous task/history workflow.
|
|
64
63
|
No live Pi terminal is required for the browser conversation workflow.
|
|
65
64
|
|
|
66
65
|
### ターミナルで
|
|
@@ -77,7 +76,8 @@ Cadence がプロジェクトを調査し、必要な判断を確認して計画
|
|
|
77
76
|
ローカル owner は必要時に起動します。
|
|
78
77
|
システムサービスのインストールは WebUI・自動起動を使う場合のみ必要です。
|
|
79
78
|
|
|
80
|
-
`/cadence-
|
|
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
81
|
[Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
|
|
82
82
|
Browser authentication is not execution consent.
|
|
83
83
|
|
|
@@ -94,14 +94,8 @@ WebUI のフォルダピッカーも同じ方法でプロジェクトを開く
|
|
|
94
94
|
|
|
95
95
|
### チェック
|
|
96
96
|
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
```json
|
|
100
|
-
{
|
|
101
|
-
"schema": "cadence-assistant-checks/1",
|
|
102
|
-
"checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
|
|
103
|
-
}
|
|
104
|
-
```
|
|
97
|
+
チェックコマンドは、明示的に承認する計画に記載します。
|
|
98
|
+
開始前のチェックと受け入れチェックの実際の結果は、自動 Agent レビューとは別に記録されます。
|
|
105
99
|
|
|
106
100
|
## サービスの管理
|
|
107
101
|
|
package/README.ko.md
CHANGED
|
@@ -58,7 +58,6 @@ pi install "$(npm root -g)/@abelxiaoxing/cadence"
|
|
|
58
58
|
새로고침이나 목표 완료로 모드가 꺼지지 않습니다.
|
|
59
59
|
**Exit Cadence**는 모드만 종료하고, **Cancel workflow — request stop**은 작업 취소를 요청합니다.
|
|
60
60
|
|
|
61
|
-
**Legacy task**: previous task/history workflow.
|
|
62
61
|
No live Pi terminal is required for the browser conversation workflow.
|
|
63
62
|
|
|
64
63
|
### 터미널에서
|
|
@@ -74,7 +73,8 @@ Cadence가 프로젝트를 조사하고 결정 사항을 확인한 뒤 계획을
|
|
|
74
73
|
로컬 owner는 필요할 때 시작됩니다.
|
|
75
74
|
시스템 서비스는 선택적인 WebUI 및 자동 시작용입니다.
|
|
76
75
|
|
|
77
|
-
`/cadence-
|
|
76
|
+
`/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
|
|
77
|
+
See [History and diagnostics](docs/history.md).
|
|
78
78
|
[Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
|
|
79
79
|
Browser authentication is not execution consent.
|
|
80
80
|
|
|
@@ -91,14 +91,8 @@ WebUI 폴더 선택기도 같은 방법으로 프로젝트를 엽니다.
|
|
|
91
91
|
|
|
92
92
|
### 체크
|
|
93
93
|
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
```json
|
|
97
|
-
{
|
|
98
|
-
"schema": "cadence-assistant-checks/1",
|
|
99
|
-
"checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
|
|
100
|
-
}
|
|
101
|
-
```
|
|
94
|
+
기준 검사와 인수 검사의 명령은 명시적으로 승인하는 계획에 포함됩니다.
|
|
95
|
+
실제 검사 결과는 자동 Agent 검토와 별도로 기록됩니다.
|
|
102
96
|
|
|
103
97
|
## 서비스 관리
|
|
104
98
|
|
package/README.md
CHANGED
|
@@ -4,7 +4,7 @@
|
|
|
4
4
|
|
|
5
5
|
Cadence turns [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) into a conversation-driven engineering workflow.
|
|
6
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
|
|
7
|
+
The optional WebUI supports the same persistent conversation workflow without a live Pi terminal, alongside ordinary chat and readonly retained history.
|
|
8
8
|
|
|
9
9
|
## Why Cadence
|
|
10
10
|
|
|
@@ -49,8 +49,6 @@ The port and token live in `~/.pi/agent/cadence/.env`; anyone with the token can
|
|
|
49
49
|
5. Follow actual progress and local merge results in the conversation; open any subagent's full context from the lower-left **Subagents** dock.
|
|
50
50
|
Refresh and completion keep Cadence on; **Exit Cadence** only exits the mode, while **Cancel workflow — request stop** requests cancellation.
|
|
51
51
|
|
|
52
|
-
**Legacy task** retains the old create/plan/Save/Start/check/human-Review route explicitly.
|
|
53
|
-
|
|
54
52
|
### In the terminal
|
|
55
53
|
|
|
56
54
|
Enter `/cadence <goal>` once in any trusted project's Pi conversation.
|
|
@@ -65,7 +63,8 @@ Native use starts/reuses a local project owner on demand, without installing a s
|
|
|
65
63
|
Model preferences are remembered in `~/.pi/agent/cadence/settings.json`; authentication stays with Pi.
|
|
66
64
|
|
|
67
65
|
See [Conversation mode](docs/conversation-mode.md) for exact approval, worktree prerequisites and cancellation.
|
|
68
|
-
`/cadence-
|
|
66
|
+
`/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
|
|
67
|
+
See [History and diagnostics](docs/history.md).
|
|
69
68
|
Browser approval is separately bound to the displayed plan and conversation; authentication alone never authorizes execution.
|
|
70
69
|
|
|
71
70
|
### More projects
|
|
@@ -80,15 +79,8 @@ Opening another project never stops work in the previous one.
|
|
|
80
79
|
|
|
81
80
|
### Checks
|
|
82
81
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
```json
|
|
87
|
-
{
|
|
88
|
-
"schema": "cadence-assistant-checks/1",
|
|
89
|
-
"checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
|
|
90
|
-
}
|
|
91
|
-
```
|
|
82
|
+
Checks are declared in the exact plan you approve, including baseline and acceptance commands.
|
|
83
|
+
Their actual outcomes remain separate from automatic Agent review.
|
|
92
84
|
|
|
93
85
|
## Manage the service
|
|
94
86
|
|
package/README.pt-BR.md
CHANGED
|
@@ -49,7 +49,6 @@ A porta e o token ficam em `~/.pi/agent/cadence/.env`; qualquer pessoa com o tok
|
|
|
49
49
|
Atualizar a página ou concluir um objetivo não desativa o modo.
|
|
50
50
|
**Exit Cadence** sai do modo; **Cancel workflow — request stop** solicita o cancelamento.
|
|
51
51
|
|
|
52
|
-
**Legacy task**: previous task/history workflow.
|
|
53
52
|
No live Pi terminal is required for the browser conversation workflow.
|
|
54
53
|
|
|
55
54
|
### No terminal
|
|
@@ -64,7 +63,8 @@ As preferências de modelo são mantidas entre projetos em `~/.pi/agent/cadence/
|
|
|
64
63
|
|
|
65
64
|
O proprietário local inicia sob demanda; o serviço do sistema é opcional para WebUI/inicialização automática.
|
|
66
65
|
|
|
67
|
-
`/cadence-
|
|
66
|
+
`/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
|
|
67
|
+
See [History and diagnostics](docs/history.md).
|
|
68
68
|
[Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
|
|
69
69
|
Browser authentication is not execution consent.
|
|
70
70
|
|
|
@@ -80,14 +80,8 @@ Abrir outro projeto nunca interrompe o trabalho no anterior.
|
|
|
80
80
|
|
|
81
81
|
### Verificações
|
|
82
82
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
```json
|
|
86
|
-
{
|
|
87
|
-
"schema": "cadence-assistant-checks/1",
|
|
88
|
-
"checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
|
|
89
|
-
}
|
|
90
|
-
```
|
|
83
|
+
Os comandos de verificação constam do plano aprovado, incluindo verificações iniciais e de aceitação.
|
|
84
|
+
Os resultados reais permanecem separados da revisão automática do agente.
|
|
91
85
|
|
|
92
86
|
## Gerenciar o serviço
|
|
93
87
|
|
package/README.ru.md
CHANGED
|
@@ -49,7 +49,6 @@ pi install "$(npm root -g)/@abelxiaoxing/cadence"
|
|
|
49
49
|
Обновление страницы и завершение цели не выключают режим.
|
|
50
50
|
**Exit Cadence** выходит из режима; **Cancel workflow — request stop** запрашивает отмену работы.
|
|
51
51
|
|
|
52
|
-
**Legacy task**: previous task/history workflow.
|
|
53
52
|
No live Pi terminal is required for the browser conversation workflow.
|
|
54
53
|
|
|
55
54
|
### В терминале
|
|
@@ -64,7 +63,8 @@ Cadence исследует проект, уточняет решения и со
|
|
|
64
63
|
|
|
65
64
|
Локальный владелец запускается по требованию; системная служба нужна только для дополнительного WebUI и автозапуска.
|
|
66
65
|
|
|
67
|
-
`/cadence-
|
|
66
|
+
`/cadence-history [run-id]`: readonly run details and retained history; no service startup or task execution.
|
|
67
|
+
See [History and diagnostics](docs/history.md).
|
|
68
68
|
[Conversation mode](docs/conversation-mode.md): native/browser approval, limits and worktree setup.
|
|
69
69
|
Browser authentication is not execution consent.
|
|
70
70
|
|
|
@@ -80,14 +80,8 @@ cadence project open /absolute/new-project --create
|
|
|
80
80
|
|
|
81
81
|
### Проверки
|
|
82
82
|
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
```json
|
|
86
|
-
{
|
|
87
|
-
"schema": "cadence-assistant-checks/1",
|
|
88
|
-
"checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
|
|
89
|
-
}
|
|
90
|
-
```
|
|
83
|
+
Команды исходных и приёмочных проверок указываются в явно одобренном плане.
|
|
84
|
+
Их фактические результаты отделены от автоматической проверки агентом.
|
|
91
85
|
|
|
92
86
|
## Управление службой
|
|
93
87
|
|
package/README.zh-CN.md
CHANGED
|
@@ -47,8 +47,6 @@ pi install "$(npm root -g)/@abelxiaoxing/cadence"
|
|
|
47
47
|
5. 在同一对话查看真实进度和合并结果;子代理的完整上下文从左下角**子代理**面板打开。
|
|
48
48
|
刷新、完成目标后仍保持 Cadence;**退出 Cadence**不取消后台工作,**取消工作流 — 请求停止**才请求取消。
|
|
49
49
|
|
|
50
|
-
“旧版任务”入口明确保留原有创建任务、Save/Start、独立检查和人工 Review 路径。
|
|
51
|
-
|
|
52
50
|
### 在终端中:一次进入,持续对话
|
|
53
51
|
|
|
54
52
|
在任意已信任项目的 Pi 对话里输入一次 `/cadence <目标>`,之后正常对话即可。
|
|
@@ -66,7 +64,8 @@ Cadence 自动调查仓库、汇总需要你决定的问题,并与你反复对
|
|
|
66
64
|
项目知识维护在 `.cadence/project.md`;隔离 worktree 不会自动复制依赖或凭据,必要的准备命令会列入计划确认。
|
|
67
65
|
|
|
68
66
|
详细边界见 [对话模式](docs/conversation-mode.md)。
|
|
69
|
-
|
|
67
|
+
`/cadence-history [运行 ID]` 提供只读诊断、运行详情和已有任务历史,不创建或执行任务,也不启动服务。
|
|
68
|
+
见[历史与诊断](docs/history.md)。
|
|
70
69
|
浏览器批准与所展示的计划、会话和访问身份绑定;登录本身不是执行授权。
|
|
71
70
|
|
|
72
71
|
### 更多项目
|
|
@@ -81,15 +80,8 @@ cadence project open /absolute/new-project --create
|
|
|
81
80
|
|
|
82
81
|
### 检查
|
|
83
82
|
|
|
84
|
-
|
|
85
|
-
|
|
86
|
-
|
|
87
|
-
```json
|
|
88
|
-
{
|
|
89
|
-
"schema": "cadence-assistant-checks/1",
|
|
90
|
-
"checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
|
|
91
|
-
}
|
|
92
|
-
```
|
|
83
|
+
检查命令在你批准的具体计划中列出,包括基线检查和验收检查。
|
|
84
|
+
真实检查结果与自动 Agent 审查保持独立。
|
|
93
85
|
|
|
94
86
|
## 管理服务
|
|
95
87
|
|
|
@@ -100,12 +100,13 @@ Pi says once which command stops an owner it started; when Pi runs on Bun, Node
|
|
|
100
100
|
An existing owner/configuration is reused, not silently replaced after a connection failure.
|
|
101
101
|
System-service installation and remote access remain separate explicit operations described in [Service management](service-management.md) and [Remote access](remote-access.md).
|
|
102
102
|
|
|
103
|
-
`/cadence-
|
|
103
|
+
`/cadence-history [run-id]` provides readonly diagnostics without model calls or service startup; see [History and diagnostics](history.md).
|
|
104
104
|
The WebUI uses the same execution engine with a separate, context-bound browser confirmation path.
|
|
105
105
|
Its main composer stays in the same conversation; the plan card, workflow progress and actual merge outcomes appear inline.
|
|
106
106
|
Research, implementation and review subagents are listed in the lower-left **Subagents** dock, together with legacy task children; selecting one (or **Open subagent context** on a step) opens its full transcript and retained result in the main area, and **Back to conversation** returns.
|
|
107
107
|
Active workflows are listed under **Running conversations** with **Cancel workflow — request stop**; this includes native-started workflows, and an unavailable observation is not proof of no work.
|
|
108
|
-
|
|
108
|
+
The old task creation/Save/Start/check/human-Review controls are retired on both clients and refused by the service.
|
|
109
|
+
Existing task records remain readonly; they are not converted into workflows.
|
|
109
110
|
Existing browser conversations enter the new mode only on explicit Send/activation; old tasks and Pi transcripts are not converted or imported.
|
|
110
111
|
Approval grants are neither stored in the browser nor restored after restart.
|
|
111
112
|
Losing a response only observes its original command/run identity; it never retries execution.
|
package/docs/history.md
ADDED
|
@@ -0,0 +1,50 @@
|
|
|
1
|
+
# History and diagnostics
|
|
2
|
+
|
|
3
|
+
Cadence has one engineering execution path: enter `/cadence`, discuss a goal and approve the exact plan.
|
|
4
|
+
History is evidence, not a second task manager or renewed execution consent.
|
|
5
|
+
|
|
6
|
+
## Current workflows
|
|
7
|
+
|
|
8
|
+
- In the conversation, open a workflow's steps to see actual checks, Agent review, delivery and failures.
|
|
9
|
+
**Open subagent context** shows the retained transcript; **Read retained step result** reads the retained result rather than its clipped status preview.
|
|
10
|
+
- In the browser sidebar, expand **Workflow history** to find retained runs, including completed native-started work.
|
|
11
|
+
The listing is paged in ID order, not chronological order.
|
|
12
|
+
Larger histories show scan progress before a complete page; use **Continue reading history** in the browser or **Continue scanning** in Pi.
|
|
13
|
+
An expired scan requires a fresh observation; it never deletes history or resumes execution.
|
|
14
|
+
A new run may appear before a page you already read; return to the first page and refresh to observe it.
|
|
15
|
+
An unreadable record stays visibly unavailable rather than disappearing or being repaired.
|
|
16
|
+
- In a trusted Pi terminal, `/cadence-history` lists workflows without asking a model.
|
|
17
|
+
`/cadence-history <run-id>` opens one exact run directly.
|
|
18
|
+
Use **Full result** or **Subagent transcript** for step evidence, and the arrow/page/Home/End keys to read long text.
|
|
19
|
+
|
|
20
|
+
The native history command only attaches to an already-running project owner; it never starts a service, selects a model, approves work, executes tools or cancels a run.
|
|
21
|
+
It remains usable without a selected model.
|
|
22
|
+
If no owner is available, use the explicit service commands in [Service management](service-management.md).
|
|
23
|
+
Known omitted or truncated source content is still omitted or truncated; viewing a full retained result cannot recreate unrecorded data.
|
|
24
|
+
Automatic Agent review is never human review, and a check's actual exit is independent of model prose.
|
|
25
|
+
|
|
26
|
+
## Existing task archives
|
|
27
|
+
|
|
28
|
+
The old `/cadence-inspect` interface and browser **Legacy task** creation route are removed.
|
|
29
|
+
Old create, Save, Generate, Start, check and human-Review requests are refused by the service, including from stale clients.
|
|
30
|
+
There is no feature flag to re-enable them.
|
|
31
|
+
|
|
32
|
+
Existing task summaries, private history and task-to-conversation links are preserved without migration, reset or cleanup.
|
|
33
|
+
Use **Retained task history** in `/cadence-history`, or select a retained task in the browser:
|
|
34
|
+
|
|
35
|
+
- Read recorded plans, runs, children, checks, changes and human Review evidence.
|
|
36
|
+
- Search the selected task/run/child scope with exact, case-sensitive literal search.
|
|
37
|
+
- Export that scope as Markdown or NDJSON.
|
|
38
|
+
Native export requires an explicitly confirmed new destination and verifies the complete stream, digest, trailer and EOF.
|
|
39
|
+
A browser download request alone is not proof that the download completed.
|
|
40
|
+
|
|
41
|
+
These task search/export formats do not apply to the separate workflow store; current workflows provide retained run/step results and transcripts instead.
|
|
42
|
+
A historical record cannot restart work or confer approval.
|
|
43
|
+
|
|
44
|
+
## Cancellation and uncertain outcomes
|
|
45
|
+
|
|
46
|
+
Leaving history, switching conversations/projects or closing a client only detaches.
|
|
47
|
+
For current work, use the conversation's explicit Cancel workflow action or ask Cadence to cancel in Pi.
|
|
48
|
+
Archived task IDs are not current process handles and cannot be canceled through the retired task API.
|
|
49
|
+
Orderly Stop of the exact running owner remains available separately; an older running owner must be stopped before switching implementations.
|
|
50
|
+
No history read clears locks, repairs uncertain state, retries execution or infers that missing observations mean work has stopped.
|
|
@@ -113,7 +113,7 @@ For an explicit single-project definition, the older guards remain: no SDK means
|
|
|
113
113
|
|
|
114
114
|
While no service is registered, Pi's session-start card shows a separate warning naming `cadence server install` for an installed package copy (`node <copy>/src/service-cli.mjs server install` for Pi's managed copy, which puts no bin on `PATH`); a checkout loaded with `pi -e` stays quiet.
|
|
115
115
|
It is a warning rather than part of the info card because Pi's TUI replaces one info status with the next.
|
|
116
|
-
The
|
|
116
|
+
The readonly `/cadence-history` client names the same management command when no owner exists; daily `/cadence` instead uses explicit on-demand project startup, without requiring a boot service.
|
|
117
117
|
A machine without a supported user service manager and `CADENCE_AUTOSTART=0` keep both quiet; with `CADENCE_LINGER=0` they suggest `--no-linger`.
|
|
118
118
|
|
|
119
119
|
### One copy for Pi and the service
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@abelxiaoxing/cadence",
|
|
3
|
-
"version": "2.0.
|
|
3
|
+
"version": "2.0.23",
|
|
4
4
|
"description": "Conversation-driven Pi workspace: persistent native and WebUI workflows, explicit plan approval, checks and local delivery.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -27,7 +27,6 @@
|
|
|
27
27
|
"src/native-export.ts",
|
|
28
28
|
"src/native-history.ts",
|
|
29
29
|
"src/operator-cli.mjs",
|
|
30
|
-
"src/plan-proposal.ts",
|
|
31
30
|
"src/sdk-worker.mjs",
|
|
32
31
|
"src/service-cli.mjs",
|
|
33
32
|
"src/service-client.ts",
|
|
@@ -47,9 +46,8 @@
|
|
|
47
46
|
"src/service/coordination.ts",
|
|
48
47
|
"src/service/private-files.ts",
|
|
49
48
|
"src/startup-card.ts",
|
|
50
|
-
"src/
|
|
51
|
-
"src/
|
|
52
|
-
"src/task-types.ts",
|
|
49
|
+
"src/history-shell.ts",
|
|
50
|
+
"src/native-workflow-history.ts",
|
|
53
51
|
"src/verification-diagnostics.ts",
|
|
54
52
|
"src/worker-capture.mjs",
|
|
55
53
|
"src/worker-public.mjs",
|
|
@@ -76,7 +74,10 @@
|
|
|
76
74
|
"src/cadence-preferences.ts",
|
|
77
75
|
"src/service/contracts/workflow.ts",
|
|
78
76
|
"src/cadence-instructions.ts",
|
|
79
|
-
"src/coordinator-tools.mjs"
|
|
77
|
+
"src/coordinator-tools.mjs",
|
|
78
|
+
"src/workspace.ts",
|
|
79
|
+
"src/data-shapes.ts",
|
|
80
|
+
"src/service/checkout-lock.ts"
|
|
80
81
|
],
|
|
81
82
|
"pi": {
|
|
82
83
|
"extensions": [
|
|
@@ -100,7 +101,7 @@
|
|
|
100
101
|
"build:operator": "bun scripts/build-operator.mjs",
|
|
101
102
|
"build:service": "bun scripts/build-service.mjs",
|
|
102
103
|
"check:web": "tsc -p web/tsconfig.json && tsc -p web/tsconfig.config.json",
|
|
103
|
-
"test:web": "
|
|
104
|
+
"test:web": "vitest run --config web/vitest.config.ts",
|
|
104
105
|
"build:web": "node scripts/build-web.mjs",
|
|
105
106
|
"build:web:check": "node scripts/build-web.mjs --check",
|
|
106
107
|
"test:web:assets-browser": "bun run test:browser",
|
|
@@ -66,7 +66,7 @@ export const FEED_TIMING: FeedTiming = {
|
|
|
66
66
|
idleMs: LIMITS.heartbeatMs,
|
|
67
67
|
retryMs: 15_000,
|
|
68
68
|
};
|
|
69
|
-
/** Retained reads are paged; a child larger than this stays in /cadence-
|
|
69
|
+
/** Retained reads are paged; a child larger than this stays in /cadence-history. */
|
|
70
70
|
const MAX_PAGES = 50;
|
|
71
71
|
const MAX_DETAIL_STEPS = 8;
|
|
72
72
|
/** Characters of one field shown in the panel; the rest stays retained. */
|
|
@@ -655,7 +655,7 @@ class Feed {
|
|
|
655
655
|
}
|
|
656
656
|
/** Stop following these episodes. Their unsettled children end as errors
|
|
657
657
|
* that say the outcome was not observed, instead of spinning as running for
|
|
658
|
-
* the rest of the session; /cadence-
|
|
658
|
+
* the rest of the session; /cadence-history keeps the actual outcome. */
|
|
659
659
|
private abandon(runIds: string[], why: string): void {
|
|
660
660
|
for (const runId of runIds) {
|
|
661
661
|
this.episodes.delete(runId);
|
|
@@ -667,7 +667,7 @@ class Feed {
|
|
|
667
667
|
id: child.id,
|
|
668
668
|
status: "error",
|
|
669
669
|
endedAt: this.now(),
|
|
670
|
-
error: `${child.label} · outcome not observed here (${why}); see /cadence-
|
|
670
|
+
error: `${child.label} · outcome not observed here (${why}); see /cadence-history`,
|
|
671
671
|
});
|
|
672
672
|
}
|
|
673
673
|
}
|
|
@@ -831,7 +831,7 @@ class Feed {
|
|
|
831
831
|
}
|
|
832
832
|
// One detail page can exceed the cap on its own, with no cursor left.
|
|
833
833
|
if (cursor || text.length > TEXT_CAP)
|
|
834
|
-
text = `${text.slice(0, TEXT_CAP)}\n… (truncated; the full text is in /cadence-
|
|
834
|
+
text = `${text.slice(0, TEXT_CAP)}\n… (truncated; the full text is in /cadence-history)`;
|
|
835
835
|
this.state.remember(key, text);
|
|
836
836
|
return text;
|
|
837
837
|
}
|
package/src/cadence-mode.ts
CHANGED
|
@@ -41,8 +41,8 @@ import {
|
|
|
41
41
|
type PublicError,
|
|
42
42
|
type Reply,
|
|
43
43
|
} from "./service-contract.ts";
|
|
44
|
-
import { effectiveWorkspace } from "./task-store.ts";
|
|
45
44
|
import { diagnosticText } from "./verification-diagnostics.ts";
|
|
45
|
+
import { effectiveWorkspace } from "./workspace.ts";
|
|
46
46
|
|
|
47
47
|
export const CADENCE_MODE_ENTRY = "cadence-conversation-mode/1";
|
|
48
48
|
const CONTEXT = "cadence-mode-context";
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
/** Small shape predicates shared by filesystem records; no task model. */
|
|
2
|
+
export function object(value: unknown): value is Record<string, unknown> {
|
|
3
|
+
return value !== null && typeof value === "object" && !Array.isArray(value);
|
|
4
|
+
}
|
|
5
|
+
export function boundedString(value: unknown, max: number): value is string {
|
|
6
|
+
return (
|
|
7
|
+
typeof value === "string" &&
|
|
8
|
+
Buffer.byteLength(value) <= max &&
|
|
9
|
+
!value.includes("\0")
|
|
10
|
+
);
|
|
11
|
+
}
|
|
12
|
+
export function validId(value: string): boolean {
|
|
13
|
+
return /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/.test(
|
|
14
|
+
value,
|
|
15
|
+
);
|
|
16
|
+
}
|