@abelxiaoxing/cadence 2.0.17 → 2.0.18

package/README.pt-BR.md

@@ -0,0 +1,106 @@
+# Cadence
+
+[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)
+
+O Cadence transforma o [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) em um espaço de trabalho de tarefas persistente.
+Planeje uma tarefa de código, deixe os subagentes trabalharem nela, execute suas verificações e revise o resultado no terminal do Pi (`/cadence`) ou na interface web do navegador; ambos se conectam ao mesmo serviço em segundo plano.
+
+## Por que o Cadence
+
+- **O trabalho sobrevive à janela.**
+  As tarefas rodam em um serviço em segundo plano: fechar o terminal, sair do Pi ou deixar a aba do navegador apenas desconecta, e qualquer cliente pode se reconectar à mesma execução.
+- **Nada é editado antes de você aprovar.**
+  Uma tarefa primeiro analisa em somente leitura e propõe um plano legível; os arquivos mudam apenas depois que você confirma esse plano exato.
+- **Resultados nos quais você pode confiar.**
+  A saída dos subagentes, as execuções reais de verificação e a sua própria revisão permanecem separadas: a prosa do modelo ou um "Done" nunca contam como verificação aprovada, e resultados com falha, cancelados e desconhecidos permanecem distintos.
+- **Histórico completo.**
+  Cada execução mantém suas mensagens, chamadas de ferramentas e saídas, com busca exata e exportação completa em Markdown/NDJSON; segredos conhecidos são redigidos.
+- **Um link para tudo.**
+  A interface web (desktop e celular, inglês e chinês simplificado) também hospeda conversas comuns do Pi e alterna entre projetos, cada um com seu próprio owner e histórico.
+
+O Cadence é um assistente confiável, **não uma caixa de areia**: seus agentes editam sua cópia de trabalho diretamente com as ferramentas do host, então use-o apenas em código que você possa revisar e recuperar.
+
+## Instalação
+
+Você precisa de Node `>=22.19.0` com npm, e do Pi instalado e conectado a um provedor de modelos; o Cadence reutiliza o login e as configurações de modelos do Pi.
+
+```sh
+npm install -g @abelxiaoxing/cadence
+cadence server install
+pi install "$(npm root -g)/@abelxiaoxing/cadence"
+```
+
+`cadence server install` registra e inicia um serviço em segundo plano (systemd no Linux, um LaunchAgent no macOS, uma entrada de login no Windows) e imprime um link privado, `http://127.0.0.1:17423/?token=…`.
+O último comando permite que o Pi carregue a mesma cópia para o `/cadence`, então um único upgrade do npm atualiza ambos.
+A porta e o token ficam em `~/.pi/agent/cadence/.env`; qualquer pessoa com o token pode usar seu espaço de trabalho, então mantenha o link privado.
+
+## Uso
+
+### No navegador
+
+1. Abra o link impresso uma vez; o navegador então se lembra de você.
+   Se você o perder, `cadence token-link --reveal` o imprime de novo.
+2. Escolha uma pasta de projeto com o botão de pasta no canto inferior direito, e escolha um modelo.
+3. Envie uma mensagem para uma conversa comum, ou comece com `cadence <goal>` (ou selecione Tarefa Cadence) para criar uma tarefa.
+4. Quando a análise propuser um plano, abra **Revisar plano de implementação** e escolha **Confirmar plano e executar**.
+5. Acompanhe os subagentes no dock no canto inferior esquerdo; verificações, alterações e revisão ficam sob **Detalhes da tarefa** à direita.
+
+### No terminal
+
+No TUI do Pi, digite `/cadence [goal]` e pressione Enter você mesmo; entrada colada ou via script não o abre.
+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.
+
+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).
+
+### Mais projetos
+
+```sh
+cadence project open /absolute/project
+cadence project open /absolute/new-project --create
+```
+
+Cada projeto recebe seu próprio owner, porta e histórico, e o comando imprime seu link privado; o seletor de pastas da interface web abre projetos da mesma maneira.
+Abrir outro projeto nunca interrompe o trabalho no anterior.
+
+### Verificações
+
+Liste os comandos que verificam seu projeto em `.cadence/assistant/config.json`, e as tarefas podem executá-los como verificações reais antes da revisão:
+
+```json
+{
+  "schema": "cadence-assistant-checks/1",
+  "checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
+}
+```
+
+## Gerenciar o serviço
+
+```sh
+cadence server status
+cadence server restart     # após um upgrade ou uma alteração de .env / models.json
+cadence server stop        # permanece registrado e inicia de novo no próximo boot ou login
+cadence server uninstall   # executar antes de npm uninstall -g
+```
+
+Faça upgrade com `npm install -g @abelxiaoxing/cadence@latest`, depois `cadence server restart`.
+Restart, stop e uninstall param o trabalho em execução em ordem, em vez de deixá-lo desconectado.
+Uninstall remove apenas a definição do serviço; projetos, histórico e configurações do Pi permanecem.
+Serviços root e nomeados do Linux, acesso HTTPS remoto e recuperação estão cobertos em [gerenciamento do serviço](docs/service-management.md) e [acesso remoto](docs/remote-access.md).
+
+## Desenvolvimento
+
+O Pi também pode carregar um checkout local ou um tarball empacotado: adicione seu caminho absoluto ou relativo aos `packages` do Pi, ou experimente `pi -e ./cadence`.
+O Cadence não impõe uma faixa de versões do Pi; fixações de desenvolvimento e tempos de execução testados não são promessas universais de compatibilidade.
+
+```sh
+bun install
+CADENCE_BROWSER_PATH=/absolute/existing/chromium bun run verify
+```
+
+As orientações de engenharia são divididas por área sob [engineering/](engineering/); o índice do projeto em [AGENTS.md](AGENTS.md) diz qual arquivo cobre qual código.
+`verify` também precisa de um build oficial do Node, um diretório temporário privado e um Chromium existente; veja [verificação](engineering/verification.md).
+
+## Licença
+
+O Cadence é MIT.
+Adaptações, fontes e vendors incluídos mantêm suas próprias licenças; veja [reutilização e distribuição](docs/reuse-and-distribution.md) e [avisos de terceiros](THIRD_PARTY_NOTICES.md).

package/README.ru.md

@@ -0,0 +1,107 @@
+# Cadence
+
+[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)
+
+Cadence превращает [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) в постоянное рабочее пространство задач.
+Спланируйте задачу по коду, позвольте субагентам работать над ней, запустите свои проверки и просмотрите результат в терминале Pi (`/cadence`) или в веб-интерфейсе браузера; оба подключаются к одной фоновой службе.
+
+## Почему Cadence
+
+- **Работа живёт дольше окна.**
+  Задачи выполняются в фоновой службе: закрытие терминала, выход из Pi или уход со вкладки браузера лишь отключают подключение, и любой клиент может повторно подключиться к тому же запуску.
+- **Ничего не редактируется до вашего одобрения.**
+  Задача сначала анализирует в режиме только для чтения и предлагает читаемый план; файлы меняются только после того, как вы подтвердите именно этот план.
+- **Результатам можно доверять.**
+  Вывод субагентов, фактические запуски проверок и ваш собственный обзор остаются разделёнными: текст модели или «Done» никогда не считаются пройденной проверкой, а неудачные, отменённые и неизвестные исходы остаются различимыми.
+- **Полная история.**
+  Каждый запуск сохраняет свои сообщения, вызовы инструментов и выводы, с точным поиском и полным экспортом в Markdown/NDJSON; известные секреты скрываются.
+- **Одна ссылка на всё.**
+  Веб-интерфейс (десктоп и телефон, английский и упрощённый китайский) также принимает обычные разговоры Pi и переключается между проектами, у каждого из которых свой owner и своя история.
+
+Cadence — это доверенный ассистент, **а не песочница**: его агенты редактируют вашу рабочую копию напрямую инструментами хоста, поэтому используйте его только для кода, который вы можете просмотреть и восстановить.
+
+## Установка
+
+Нужен Node `>=22.19.0` с npm, и установленный Pi, вошедший в учётную запись провайдера моделей; Cadence переиспользует вход и настройки моделей Pi.
+
+```sh
+npm install -g @abelxiaoxing/cadence
+cadence server install
+pi install "$(npm root -g)/@abelxiaoxing/cadence"
+```
+
+`cadence server install` регистрирует и запускает фоновую службу (systemd на Linux, LaunchAgent на macOS, элемент автозагрузки на Windows) и печатает приватную ссылку, `http://127.0.0.1:17423/?token=…`.
+Последняя команда позволяет Pi загрузить ту же копию для `/cadence`, так что одно обновление npm обновляет обе.
+Порт и токен хранятся в `~/.pi/agent/cadence/.env`; любой, у кого есть токен, может использовать ваше рабочее пространство, поэтому держите ссылку в секрете.
+
+## Использование
+
+### В браузере
+
+1. Откройте напечатанную ссылку один раз; затем браузер запомнит вас.
+   Если вы её потеряете, `cadence token-link --reveal` печатает её снова.
+2. Выберите папку проекта кнопкой папки в правом нижнем углу и выберите модель.
+3. Отправьте сообщение для обычного разговора, или начните его с `cadence <goal>` (или выберите «Задача Cadence»), чтобы создать задачу.
+4. Когда анализ предложит план, откройте **Просмотр плана реализации** и выберите **Подтвердить план и выполнить**.
+5. Следите за субагентами в доке слева внизу; проверки, изменения и обзор находятся под **Детали задачи** справа.
+
+### В терминале
+
+В TUI Pi введите `/cadence [goal]` сами и нажмите Enter; вставленный или скриптовый ввод не откроет его.
+Выберите модель, создайте или откройте задачу, отредактируйте её план и подтвердите Start; в меню также показываются субагенты, проверки, изменения, обзор и история.
+
+Каждый сеанс Pi также показывает работающие фоновые агенты над вводом: нажмите ↓ на пустом вводе, чтобы выбрать один, и Enter, чтобы прочитать его транскрипт (`CADENCE_AGENT_PANEL=off` скрывает панель).
+
+### Другие проекты
+
+```sh
+cadence project open /absolute/project
+cadence project open /absolute/new-project --create
+```
+
+Каждый проект получает своего owner, порт и историю, и команда печатает его приватную ссылку; выборщик папок веб-интерфейса открывает проекты тем же способом.
+Открытие другого проекта никогда не останавливает работу в предыдущем.
+
+### Проверки
+
+Перечислите команды, которые проверяют ваш проект, в `.cadence/assistant/config.json`, и задачи могут выполнять их как реальные проверки перед обзором:
+
+```json
+{
+  "schema": "cadence-assistant-checks/1",
+  "checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
+}
+```
+
+## Управление службой
+
+```sh
+cadence server status
+cadence server restart     # после обновления или изменения .env / models.json
+cadence server stop        # остаётся зарегистрированной и снова запускается при следующей загрузке или входе
+cadence server uninstall   # выполнить перед npm uninstall -g
+```
+
+Обновляйте с помощью `npm install -g @abelxiaoxing/cadence@latest`, затем `cadence server restart`.
+Restart, stop и uninstall останавливают выполняемую работу по порядку, а не оставляют её отключённой.
+Uninstall удаляет только определение службы; проекты, история и настройки Pi остаются.
+Корневые и именованные службы Linux, удалённый HTTPS-доступ и восстановление описаны в [управлении службой](docs/service-management.md) и [удалённом доступе](docs/remote-access.md).
+
+## Разработка
+
+Pi также может загрузить локальный checkout или упакованный tarball: добавьте его абсолютный или относительный путь в `packages` Pi, или попробуйте `pi -e ./cadence`.
+Cadence не налагает диапазон версий Pi; фиксированные версии разработки и протестированные среды выполнения не являются универсальными обещаниями совместимости.
+
+```sh
+bun install
+CADENCE_BROWSER_PATH=/absolute/existing/chromium bun run verify
+```
+
+Инженерные указания разделены по областям в [engineering/](engineering/).
+Индекс проекта в [AGENTS.md](AGENTS.md) указывает, какой файл покрывает какой код.
+`verify` также требует официального сборки Node, приватного временного каталога и существующего Chromium, подробности — в [верификация](engineering/verification.md).
+
+## Лицензия
+
+Cadence распространяется по MIT.
+Включённые адаптации, шрифты и поставщики сохраняют свои собственные лицензии, обратитесь к [повторное использование и распространение](docs/reuse-and-distribution.md) и [уведомления о сторонних компонентах](THIRD_PARTY_NOTICES.md).

package/README.zh-CN.md

@@ -0,0 +1,106 @@
+# Cadence
+
+[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)
+
+Cadence 把 [Pi](https://www.npmjs.com/package/@earendil-works/pi-coding-agent) 变成一个持久的任务工作区。
+规划一个代码任务，让子代理去执行，运行你自己的检查，再从 Pi 终端（`/cadence`）或浏览器 WebUI 审阅结果；两者连接到同一个后台服务。
+
+## 为什么选择 Cadence
+
+- **工作不随窗口结束。**
+  任务运行在后台服务中：关闭终端、退出 Pi 或离开浏览器标签页只是断开连接，任一客户端都能重新连接同一次运行。
+- **批准之前不会修改任何文件。**
+  任务先只读分析并提出一个可读的计划；只有在你确认那个确切计划之后，文件才会被修改。
+- **结果可信。**
+  子代理输出、真实的检查运行和你自己的审阅彼此独立：模型的文字或一句“Done”都不算检查通过，失败、取消和未知结果保持相互区分。
+- **完整历史。**
+  每次运行都保留其消息、工具调用和输出，支持精确搜索与完整的 Markdown/NDJSON 导出；已知的秘密会被脱敏。
+- **一个链接涵盖一切。**
+  WebUI（桌面和手机，英文与简体中文）还承载普通的 Pi 对话，并可在项目间切换，每个项目都有自己的 owner 和历史。
+
+Cadence 是一个受信任的助手，**不是沙箱**：它的代理用宿主工具直接编辑你的工作副本，所以请只在你能够审阅和恢复的代码上使用它。
+
+## 安装
+
+你需要带 npm 的 Node `>=22.19.0`，以及已安装并登录到模型提供方的 Pi；Cadence 复用 Pi 的登录和模型设置。
+
+```sh
+npm install -g @abelxiaoxing/cadence
+cadence server install
+pi install "$(npm root -g)/@abelxiaoxing/cadence"
+```
+
+`cadence server install` 注册并启动一个后台服务（Linux 上是 systemd，macOS 上是 LaunchAgent，Windows 上是登录项），并打印一个私有链接 `http://127.0.0.1:17423/?token=…`。
+最后一条命令让 Pi 加载同一份副本用于 `/cadence`，因此一次 npm 升级就同时更新两者。
+端口和 token 保存在 `~/.pi/agent/cadence/.env`；任何持有 token 的人都可以使用你的工作区，所以请保持链接私密。
+
+## 使用
+
+### 在浏览器中
+
+1. 打开一次打印出的链接；浏览器之后会记住你。
+   如果丢失了链接，`cadence token-link --reveal` 会再次打印它。
+2. 用右下角的文件夹按钮选择项目文件夹，并选择模型。
+3. 发送一条消息进行普通对话，或以 `cadence <goal>` 开头（或选择“Cadence 任务”）创建任务。
+4. 当分析提出计划时，打开**查看实施计划**，选择**确认计划并执行**。
+5. 在左下角的 dock 中查看子代理；检查、变更和审阅在右侧的**任务详情**下。
+
+### 在终端中
+
+在 Pi 的 TUI 里，自己输入 `/cadence [goal]` 并按回车；粘贴或脚本输入不会打开它。
+选择模型，创建或打开任务，编辑其计划并确认 Start；菜单还会显示子代理、检查、变更、审阅和历史。
+
+每个 Pi 会话还在输入框上方显示运行中的后台代理：在空输入框上按 ↓ 选择一个，再按 Enter 阅读其记录（`CADENCE_AGENT_PANEL=off` 可隐藏该面板）。
+
+### 更多项目
+
+```sh
+cadence project open /absolute/project
+cadence project open /absolute/new-project --create
+```
+
+每个项目都有自己的 owner、端口和历史，命令会打印其私有链接；WebUI 的文件夹选择器以相同方式打开项目。
+打开另一个项目永远不会停止之前项目中的工作。
+
+### 检查
+
+在 `.cadence/assistant/config.json` 中列出验证你项目的命令，任务就可以在审阅前作为真实检查运行它们：
+
+```json
+{
+  "schema": "cadence-assistant-checks/1",
+  "checks": [{ "name": "Tests", "command": "bun run test", "timeoutMs": 120000 }]
+}
+```
+
+## 管理服务
+
+```sh
+cadence server status
+cadence server restart     # 升级或修改 .env / models.json 之后
+cadence server stop        # 保持注册状态，并在下次启动或登录时再次启动
+cadence server uninstall   # 在 npm uninstall -g 之前运行
+```
+
+用 `npm install -g @abelxiaoxing/cadence@latest` 升级，然后 `cadence server restart`。
+restart、stop 和 uninstall 按顺序停止运行中的工作，而不是留下断开连接的工作。
+uninstall 只删除服务定义；项目、历史和 Pi 设置保留。
+Linux root 与命名服务、远程 HTTPS 访问和恢复见[服务管理](docs/service-management.md)和[远程访问](docs/remote-access.md)。
+
+## 开发
+
+Pi 也可以加载本地 checkout 或打包的 tarball：把其绝对或相对路径加到 Pi 的 `packages`，或试试 `pi -e ./cadence`。
+Cadence 不指定 Pi 版本范围；开发用的固定版本和已测试运行时不是通用的兼容性承诺。
+
+```sh
+bun install
+CADENCE_BROWSER_PATH=/absolute/existing/chromium bun run verify
+```
+
+工程指导按领域拆分在 [engineering/](engineering/) 下；[AGENTS.md](AGENTS.md) 中的项目索引说明了哪个文件覆盖哪部分代码。
+`verify` 还需要官方 Node 构建、私有临时目录和已有的 Chromium；见[验证](engineering/verification.md)。
+
+## 许可证
+
+Cadence 采用 MIT。
+捆绑的适配代码、字体和厂商保留各自许可证；见[复用与分发](docs/reuse-and-distribution.md)和[第三方声明](THIRD_PARTY_NOTICES.md)。

package/THIRD_PARTY_NOTICES.md

@@ -11,14 +11,6 @@ The complete MIT license text of the referenced package is bundled at `licenses/
 | FIFO settlement of queued work                  | gotgenes/pi-packages @ a1ee2255 | packages/pi-subagents (state/queue semantics) |
 | Cancellation cleanup and born-complete disposal | gotgenes/pi-packages @ a1ee2255 | packages/pi-subagents (session lifecycle)     |
 
-## pi-web-ui workspace and authentication adaptation
-
-Cadence directly adapts token digest comparison, cookie encoding/decoding, bootstrap and pre-upgrade authorization patterns from `xing-shuyin/pi-web-ui`, commit `e8bab487af208bc9a1ab60a821652323f598127f`, copyright 2026 xing-shuyin (MIT).
-The source/destination inventory and deliberate security changes are recorded in `provenance/auth-reuse.json`.
-The complete upstream notice is preserved at `licenses/pi-web-ui-MIT.txt`.
-The substantial workspace/navigation/transcript/tool/Markdown/review/search/timeline/responsive/reconciliation adaptations are inventoried in `provenance/webui-reuse.json` and summarized in shipped `docs/reuse-and-distribution.md`.
-The ordinary-chat composer, directory picker, readonly file browser and agent-dock presentation additionally reference pi-web-ui revision `944f556463d6693a3f0cfe375c22680090e85bbe`, under the same retained MIT notice; its subagent/goal/delegate engines and prompt composer are not included.
-
 ## Bundled browser dependencies, icons and fonts
 
 `licenses/bundled-web.txt` preserves the full actual emitted dependency notices, including React/DOM/scheduler, react-icons and Feather, unified/Markdown/HTML utilities, highlight.js, KaTeX and vis-timeline's embedded vendor versions.

package/docs/reuse-and-distribution.md

@@ -1,28 +1,5 @@
 # Reuse and Distribution
 
-## Source families
-
-Cadence adapts `xing-shuyin/pi-web-ui@e8bab487af208bc9a1ab60a821652323f598127f`, MIT copyright 2026 xing-shuyin.
-The ordinary-chat composer, folder picker and file/dock presentation additionally reference sibling revision `944f556463d6693a3f0cfe375c22680090e85bbe`; the separate reference hashes are retained alongside the original pins.
-The full original license is `licenses/pi-web-ui-MIT.txt`.
-Repository `provenance/webui-reuse.json` records source/destination hashes and explicit incompatible branches removed; `provenance/auth-reuse.json` records token/cookie adaptation.
-
-| Source family                        | Package adaptation                                                       |
-| ------------------------------------ | ------------------------------------------------------------------------ |
-| App, TopBar, panels, layout, drawers | Conversation-first workspace, project/session sidebar and phone drawers  |
-| conv-groups, PlanBoard               | Active/history task and subagent tree, finite graph and explicit consent |
-| MessageList, Message, ToolCallBlock  | Default Markdown transcript, folded metadata and bounded retained detail |
-| Markdown, StreamMarkdown, copy       | Sanitized Markdown/math/code, no script/external-image execution         |
-| FilePreview, SCM presentation        | Readonly observed changes, no Git/file mutation API                      |
-| GlobalSearchModal, search, deep link | Literal durable search, exact versioned hits and scoped export           |
-| Standalone run-trace client          | Local vis timeline/filter/replay of observations, never execution        |
-| use-chat, message-delta              | Shared typed reconciliation, gaps/resync and no mutation replay          |
-| Token/cookie and upgrade guards      | Cookie-first authenticated HTTP/WS, explicit Host/Origin/CSRF boundaries |
-
-No upstream chat/subagent runtime, goal/delegate loop, PTY, plugin loader, browser shell, credentials editor, prompt composer, reconnect replay or task repair ships.
-Cadence owns ordinary conversations separately, using its existing native launcher, exact model/auth resolution and checkout gate; its finite task admission/history contracts remain unchanged.
-Readonly file browsing and explicit independent project opening are new Cadence service operations, not upstream filesystem mutation or global `set_cwd` routes.
-
 ## Emitted licenses
 
 `licenses/bundled-web.txt` contains full original notices with stable labeled boundaries: React/DOM/scheduler; react-icons and the selected Feather family; unified/Markdown/HTML utilities; highlight.js; KaTeX code; vis-timeline and the versions actually embedded by its standalone build.
@@ -48,7 +25,7 @@ No version bump, dependency install or publication is implied by this redesign.
 
 ## Unified entry without a default workspace
 
-`web/src/Workbench.tsx` composes the project selector and existing project UI without importing pi-web-ui's session/execution service.
+`web/src/Workbench.tsx` composes the project selector and existing project UI without importing the upstream session/execution service.
 The Cadence-owned gateway uses the existing authentication, public codecs, private-files discipline and independently coordinated project owners.
 The no-project entry never initializes an SDK session, manufactures a checkout, creates `~/cadence`, or repairs a missing project directory.
 A technical service-process cwd is not a model/tool workspace.

package/docs/service-management.md

@@ -114,6 +114,14 @@ It is a warning rather than part of the info card because Pi's TUI replaces one
 `/cadence` names the same command when it finds no owner.
 A machine without a supported user service manager and `CADENCE_AUTOSTART=0` keep both quiet; with `CADENCE_LINGER=0` they suggest `--no-linger`.
 
+### One copy for Pi and the service
+
+After `npm install -g`, `pi install "$(npm root -g)/@abelxiaoxing/cadence"` records that path and loads it in place, so an npm upgrade updates the service and native `/cadence` together.
+Pi's own package install (`pi install npm:@abelxiaoxing/cadence`) also loads the native client, but its copy puts no `cadence` on `PATH`; register its service with `node ~/.pi/agent/npm/node_modules/@abelxiaoxing/cadence/src/service-cli.mjs server install`.
+Keep one copy: two copies drift apart on upgrade, and a native client refuses an owner whose service contract differs from its own.
+A unit registered by an earlier version's Pi install hook keeps running; `cadence server restart` from the copy you keep rewrites it, and `pi update` no longer restarts it.
+Opening the private link once leaves an HttpOnly cookie in that browser; the address without the token only explains how to get the link.
+
 ### Port and token
 
 The background service reads two lines of the research configuration `~/.pi/agent/cadence/.env`:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@abelxiaoxing/cadence",
-  "version": "2.0.17",
+  "version": "2.0.18",
   "description": "Shared Pi task workspace: native terminal and WebUI, persistent service, checks and human review.",
   "license": "MIT",
   "type": "module",
@@ -58,6 +58,14 @@
     "web/dist",
     "docs",
     "README.md",
+    "README.de.md",
+    "README.es.md",
+    "README.fr.md",
+    "README.ja.md",
+    "README.ko.md",
+    "README.pt-BR.md",
+    "README.ru.md",
+    "README.zh-CN.md",
     "LICENSE",
     "THIRD_PARTY_NOTICES.md",
     "licenses",

package/src/service-host.mjs

@@ -21038,7 +21038,8 @@ import { createHash as createHash21 } from "node:crypto";
 import { lstatSync as lstatSync12, readdirSync as readdirSync3, readlinkSync } from "node:fs";
 import { join as join19, relative as relative7 } from "node:path";
 var admin = (path) => path === ".cadence/assistant/tasks" || path.startsWith(".cadence/assistant/tasks/");
-function captureChanges(root) {
+var GIT_OUTPUT_BYTES = 16 * 1024 * 1024;
+function captureChanges(root, outputBytes = GIT_OUTPUT_BYTES) {
   const deadline = Date.now() + 3000;
   const hash3 = createHash21("sha256");
   const parts = [];
@@ -21050,24 +21051,25 @@ function captureChanges(root) {
     hash3.update(label).update("\x00").update(data2).update("\x00");
   };
   const git = (args) => {
-    if (Date.now() >= deadline) {
-      complete = false;
-      limits.push("Git observation time budget exhausted");
-      return { stdout: Buffer.alloc(0) };
-    }
-    const result = spawnSync2("git", gitArguments(["-c", "core.quotepath=true", ...args]), {
-      cwd: root,
-      encoding: "buffer",
-      timeout: Math.max(1, deadline - Date.now()),
-      maxBuffer: 512 * 1024,
-      windowsHide: true,
-      env: gitEnvironment()
-    });
-    if (result.error || result.status !== 0) {
-      complete = false;
-      limits.push(`Unavailable/limited Git observation: ${args[0]}`);
+    let outcome;
+    if (Date.now() >= deadline)
+      outcome = "time budget exhausted";
+    else {
+      const result = spawnSync2("git", gitArguments(["-c", "core.quotepath=true", ...args]), {
+        cwd: root,
+        encoding: "buffer",
+        timeout: Math.max(1, deadline - Date.now()),
+        maxBuffer: outputBytes,
+        windowsHide: true,
+        env: gitEnvironment()
+      });
+      if (!result.error && result.status === 0)
+        return { stdout: result.stdout, limited: false };
+      outcome = result.error ? result.error.code ?? "error" : result.signal ? `signal ${result.signal}` : `exit ${result.status}`;
     }
-    return result;
+    complete = false;
+    limits.push(`Unavailable/limited Git observation: ${args[0]} (${outcome})`);
+    return { stdout: Buffer.from(`[limited: ${outcome}]`), limited: true };
   };
   const inventory = (name) => {
     if (admin(name))
@@ -21120,7 +21122,7 @@ function captureChanges(root) {
       ":(exclude).cadence/assistant/tasks/**"
     ];
     const head = git(["rev-parse", "--verify", "HEAD"]);
-    add("HEAD", head.stdout ?? "");
+    add("HEAD", head.stdout);
     for (const [label, args] of [
       [
         "Status (includes pre-existing dirt)",
@@ -21156,15 +21158,14 @@ function captureChanges(root) {
         ]
       ]
     ]) {
-      const result = git([...args]);
-      const data2 = result.stdout ?? Buffer.alloc(0);
+      const data2 = git([...args]).stdout;
       add(label, data2);
       parts.push(`## ${label}
 ${data2.toString("utf8")}`);
     }
     const index = git(["ls-files", "--stage", "-z", ...pathspec]);
-    add("Index entries", index.stdout ?? "");
-    for (const entry of (index.stdout ?? Buffer.alloc(0)).toString("utf8").split("\x00")) {
+    add("Index entries", index.stdout);
+    for (const entry of index.stdout.toString("utf8").split("\x00")) {
       if (!entry.startsWith("160000 "))
         continue;
       complete = false;
@@ -21178,19 +21179,25 @@ ${data2.toString("utf8")}`);
       ...pathspec
     ]);
     parts.push("## Untracked identities (content not automatically sent to model)");
-    for (const name of (untracked.stdout ?? Buffer.alloc(0)).toString("utf8").split("\x00").filter(Boolean))
-      inventory(name);
+    if (untracked.limited)
+      add("Untracked", untracked.stdout);
+    else
+      for (const name of untracked.stdout.toString("utf8").split("\x00").filter(Boolean))
+        inventory(name);
     const ignored = git([
       "ls-files",
       "--others",
       "--ignored",
       "--exclude-standard",
+      "--directory",
+      "--no-empty-directory",
       "-z",
       ...pathspec
     ]);
-    if (ignored.stdout?.length) {
+    if (ignored.stdout.length) {
       complete = false;
-      limits.push("Ignored files exist and are not inspected; review coverage is incomplete.");
+      if (!ignored.limited)
+        limits.push("Ignored files exist and are not inspected; review coverage is incomplete.");
       add("ignored paths", ignored.stdout);
     }
     parts.push("Administrative .cadence/assistant/tasks records are excluded from business freshness; configuration is not excluded.");