verbalcoding 0.2.12 → 0.2.13

package/docs/i18n/HARNESS_OPENCODE.fr.md

@@ -0,0 +1,41 @@
+# OpenCode — Notes Harness
+
+<p align="center">
+  <a href="../../README.fr.md">README</a> ·
+  <a href="HARNESSES.fr.md">Harnesses</a> ·
+  <a href="USAGE.fr.md">Utilisation</a> ·
+  <a href="CONFIGURATION.fr.md">Configuration</a>
+</p>
+
+OpenCode est un agent terminal open source. VerbalCoding l'invoque via `opencode run`.
+
+## Installation
+
+```bash
+opencode run "hello"
+```
+
+## Configuration
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+OPENCODE_COMMAND="opencode run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Phrases vocales pour basculer vers OpenCode
+
+- en: `"switch to OpenCode"`, `"switch to open code"`
+- fr: `"passe à OpenCode"`
+
+Alias : `opencode`, `open code`.
+
+## Pièges
+
+- **Pas de reprise par défaut.** Si votre build supporte resume, ajoutez le flag dans `OPENCODE_COMMAND`.
+- **Choix de modèle.** Ajoutez `--model` ou autres flags dans `OPENCODE_COMMAND`.
+- **Progression verbeuse.** Matching par mots-clés sur stdout/stderr ; sans `SMART_PROGRESS_API_KEY`, fallback sur les labels bruts.

package/docs/i18n/HARNESS_OPENCODE.ja.md

@@ -0,0 +1,44 @@
+# OpenCode — ハーネスノート
+
+<p align="center">
+  <a href="../../README.ja.md">README</a> ·
+  <a href="HARNESSES.ja.md">ハーネス</a> ·
+  <a href="USAGE.ja.md">使い方</a> ·
+  <a href="CONFIGURATION.ja.md">設定</a>
+</p>
+
+OpenCode はオープンソースのターミナルコーディングエージェント。VerbalCoding は `opencode run` で呼び出します。
+
+## インストール
+
+上流 OpenCode インストールガイドに従い、確認:
+
+```bash
+opencode run "hello"
+```
+
+## VerbalCoding 設定
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+# 任意
+OPENCODE_COMMAND="opencode run"             # 既定
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## OpenCode へ切り替える音声表現
+
+- en: `"switch to OpenCode"`, `"ask OpenCode ..."`, `"switch to open code"`
+- ja: `"OpenCode に切り替えて"`
+
+エイリアス: `opencode`, `open code`。
+
+## 罠
+
+- **既定コマンドはセッション再開なし。** OpenCode ビルドが resume フラグをサポートしていれば `OPENCODE_COMMAND="opencode run --resume"` のように付与 (アダプタは prompt を最後の positional 引数として渡す)。
+- **モデル選択。** OpenCode ビルドが `--model` フラグを要求するなら `OPENCODE_COMMAND` に追加。
+- **詳細進捗。** stdout/stderr のイベントをキーワードでマッチ (ファイル読み込み、Web 検索、ターミナル等)。`SMART_PROGRESS_API_KEY` なしでは raw ラベルにフォールバック。

package/docs/i18n/HARNESS_OPENCODE.ko.md

@@ -0,0 +1,44 @@
+# OpenCode — 하니스 노트
+
+<p align="center">
+  <a href="../../README.ko.md">README</a> ·
+  <a href="HARNESSES.ko.md">하니스</a> ·
+  <a href="USAGE.ko.md">사용법</a> ·
+  <a href="CONFIGURATION.ko.md">설정</a>
+</p>
+
+OpenCode는 오픈소스 터미널 코딩 에이전트. VerbalCoding은 `opencode run`으로 호출해.
+
+## 설치
+
+상위 OpenCode 설치 가이드를 따르고 확인:
+
+```bash
+opencode run "hello"
+```
+
+## VerbalCoding 설정
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+# 선택
+OPENCODE_COMMAND="opencode run"             # 기본값
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## OpenCode로 전환하는 음성 표현
+
+- en: `"switch to OpenCode"`, `"ask OpenCode ..."`, `"switch to open code"`
+- ko: `"opencode로 전환"`, `"오픈코드로 전환"`
+
+매처가 받는 별칭: `opencode`, `open code`.
+
+## 함정
+
+- **기본 명령에는 세션 재개 없음.** 사용 중인 OpenCode 빌드가 resume 플래그를 지원하면 `OPENCODE_COMMAND="opencode run --resume"`처럼 붙여줘 (어댑터는 prompt를 마지막 positional 인자로 넘김).
+- **모델 선택.** OpenCode 빌드가 `--model` 플래그를 요구하면 `OPENCODE_COMMAND`에 그대로 추가.
+- **상세 진행.** stdout/stderr에 나오는 이벤트가 키워드 매칭으로 잡혀 (파일 읽기, 웹 검색, 터미널). `SMART_PROGRESS_API_KEY`가 없으면 bridge가 raw 라벨로 fallback.

package/docs/i18n/HARNESS_OPENCODE.ru.md

@@ -0,0 +1,41 @@
+# OpenCode — Заметки по harness
+
+<p align="center">
+  <a href="../../README.ru.md">README</a> ·
+  <a href="HARNESSES.ru.md">Harness-ы</a> ·
+  <a href="USAGE.ru.md">Использование</a> ·
+  <a href="CONFIGURATION.ru.md">Настройка</a>
+</p>
+
+OpenCode — open-source терминальный кодинг-агент. VerbalCoding вызывает его через `opencode run`.
+
+## Установка
+
+```bash
+opencode run "hello"
+```
+
+## Настройка
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+OPENCODE_COMMAND="opencode run"
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## Голосовые фразы для переключения на OpenCode
+
+- en: `"switch to OpenCode"`, `"switch to open code"`
+- ru: `"переключись на OpenCode"`
+
+Алиасы: `opencode`, `open code`.
+
+## Подводные камни
+
+- **По умолчанию нет возобновления.** Если ваша сборка поддерживает resume — добавьте флаг в `OPENCODE_COMMAND`.
+- **Выбор модели.** Добавляйте `--model` и прочие флаги прямо в `OPENCODE_COMMAND`.
+- **Подробный прогресс.** Матчинг по ключевым словам по stdout/stderr; без `SMART_PROGRESS_API_KEY` fallback на сырые лейблы.

package/docs/i18n/HARNESS_OPENCODE.zh.md

@@ -0,0 +1,44 @@
+# OpenCode — Harness 说明
+
+<p align="center">
+  <a href="../../README.zh.md">README</a> ·
+  <a href="HARNESSES.zh.md">Harness</a> ·
+  <a href="USAGE.zh.md">使用</a> ·
+  <a href="CONFIGURATION.zh.md">配置</a>
+</p>
+
+OpenCode 是开源终端编码代理。VerbalCoding 通过 `opencode run` 驱动。
+
+## 安装
+
+参考上游 OpenCode 指引,确认:
+
+```bash
+opencode run "hello"
+```
+
+## VerbalCoding 配置
+
+```bash
+# .env
+AGENT_BACKEND=opencode
+# 可选
+OPENCODE_COMMAND="opencode run"             # 默认
+AGENT_PROJECT_CONTEXT="..."
+AGENT_WORKDIR=/Users/you/code/your-project
+AGENT_CHAT_TIMEOUT_MS=45000
+AGENT_TASK_TIMEOUT_MS=0
+```
+
+## 切到 OpenCode 的语音表述
+
+- en: `"switch to OpenCode"`、`"ask OpenCode ..."`、`"switch to open code"`
+- zh: `"切到 OpenCode"`
+
+别名: `opencode`、`open code`。
+
+## 坑
+
+- **默认命令无会话续接。** 若 OpenCode 构建支持 resume,可改为 `OPENCODE_COMMAND="opencode run --resume"` (适配器会把 prompt 作为末尾 positional 参数)。
+- **模型选择。** 若需 `--model` 等标志,直接加入 `OPENCODE_COMMAND`。
+- **详细进度。** stdout/stderr 中按关键字匹配 (文件读取、网页搜索、终端)。无 `SMART_PROGRESS_API_KEY` 时 bridge 回退到原始标签。