zigmini 0.8.0-beta.7 → 0.9.0-beta.2

package/README.ko.md

@@ -70,7 +70,7 @@ zigmini는 에이전트를 권한 프리셋 `full-access`로 실행합니다.
    ```sh
    zigmini --version
    ```
-   - 결과가 숫자로 시작하는 버전 한 줄(예: `0.8.0-beta.7`)이면 15번으로 갑니다.
+   - 결과가 숫자로 시작하는 버전 한 줄(예: `0.9.0-beta.1`)이면 15번으로 갑니다.
    - 결과가 `zsh: command not found: zigmini`이면 Bun 전역 명령 폴더가 PATH에 없습니다. 10번으로 갑니다.
 10. 지금 터미널 창에서 Bun 전역 명령 폴더를 PATH에 넣습니다. 이 명령은 지금 터미널 창에만 적용되고 파일을 바꾸지 않습니다.
     ```sh
@@ -95,9 +95,9 @@ zigmini는 에이전트를 권한 프리셋 `full-access`로 실행합니다.
 14. 9번 명령을 다시 실행합니다.
     - 결과가 숫자로 시작하는 버전 한 줄이면 15번으로 갑니다.
     - 결과가 여전히 `zsh: command not found: zigmini`이면 설치를 멈춥니다. `ls "$(bun pm bin -g)"`를 실행합니다. 결과에 `zigmini`가 없으면 8번의 `bun add -g zigmini` 출력에서 `error:`로 시작하는 줄을 확인합니다.
-15. 에이전트 엔진 `omo-ai`를 전역 설치합니다. 필수 단계입니다. `omo-ai` 설치와 모델 계정 로그인이 없으면 게이트웨이가 동작하지 않습니다. 15~18번을 건너뛰면 `zigmini setup`이 전역 `omo`를 직접 설치하고 로그인 단계에서 기다리지만, 로그인은 직접 해야 합니다. 그래도 여기의 단계를 먼저 합니다. 버전은 게이트웨이가 고정한 stock 버전에 맞춥니다(`src/engine/compat.json`의 `omo`, 이 문서를 쓸 때 5.1.35).
+15. 에이전트 엔진 `omo-ai`를 전역 설치합니다. 필수 단계입니다. `omo-ai` 설치와 모델 계정 로그인이 없으면 게이트웨이가 동작하지 않습니다. 15~18번을 건너뛰면 `zigmini setup`이 전역 `omo`를 직접 설치하고 로그인 단계에서 기다리지만, 로그인은 직접 해야 합니다. 그래도 여기의 단계를 먼저 합니다. 버전은 게이트웨이가 고정한 stock 버전에 맞춥니다(`src/engine/compat.json`의 `omo`, 0.9.0-beta.2는 5.1.48이며 설치된 릴리스는 자체 고정값을 유지합니다).
     ```sh
-    bun add -g omo-ai@5.1.35
+    bun add -g omo-ai@5.1.48
     ```
 16. 셸이 `omo` 명령을 찾는지 확인합니다. 결과는 버전 한 줄이어야 합니다.
     ```sh
@@ -118,7 +118,7 @@ zigmini는 에이전트를 권한 프리셋 `full-access`로 실행합니다.
 1. 언어를 묻습니다: `Language / 언어 [1] English [2] 한국어`. 그 뒤의 안내는 모두 고른 언어로 나옵니다. 고른 언어는 `~/.zigmini/language`에 저장되고 `zigmini setup --access`, `zigmini pair`, `zigmini start`·`restart`의 준비 대기도 이 언어를 씁니다. `--lang en|ko`로 묻지 않고 정할 수 있습니다. 묻지 않는 설치(`--non-interactive`)는 저장된 언어, 없으면 시스템 언어(`LANG`이 `ko…`이면 한국어), 그것도 없으면 영어를 씁니다.
 2. 권한 안내를 보여 주고 동의를 받습니다.
 3. 홈 폴더 `~/.zigmini`를 만듭니다. 이 설치의 규칙 파일(`~/.zigmini/rules.md`)이 없으면 빈 파일을 만듭니다. 아래 "에이전트 규칙"을 보세요.
-4. 에이전트 엔진(omo-ai)의 고정 버전을 내려받아 해시를 확인하고 패치합니다. 버전은 패키지가 정합니다(`src/engine/compat.json`, 이 문서를 쓸 때 엔진 5.1.35). 엔진 라이선스 요약을 보여 주고 동의(`y`)를 받습니다.
+4. 에이전트 엔진(omo-ai)의 고정 버전을 내려받아 해시를 확인하고 패치합니다. 버전은 패키지가 정합니다(`src/engine/compat.json`, 이 문서를 쓸 때 엔진 5.1.48). 엔진 라이선스 요약을 보여 주고 동의(`y`)를 받습니다.
 5. 전역 `omo` 명령을 `bun add -g omo-ai@<버전>`으로 설치합니다. 버전은 고정 엔진과 같은 stock 버전입니다. 전역 `omo`가 이미 그 버전이면 설치를 건너뜁니다. 다른 버전이면 `<버전>으로 덮어쓸까요? (y/N)`를 묻습니다. 묻지 않는 설치는 있는 버전을 유지합니다. 설치에 실패하면 고정 엔진의 긴 명령을 로그인 명령으로 보여 줍니다.
 6. 에이전트 폴더와 모델 계정 로그인 상태를 확인합니다. 기본 에이전트 폴더는 `~/.omo/agent`이고, 같은 폴더를 쓰는 다른 OMO와 로그인 정보를 같이 씁니다. 로그인하지 않았으면 아래 상자를 보이고 기다립니다.
    ```text
@@ -195,6 +195,28 @@ F0:AB:B3:B2:DC:70:1A:45:19:85:69:7D:58:68:F5:FB:4F:AC:33:4F:D8:6A:68:DD:04:5C:53
 
 사용자 매뉴얼([한국어](docs/manual.ko.md), [English](docs/manual.md))은 웹 설정 창 위쪽의 "매뉴얼" 버튼과, 앱 헤더의 상태 태그를 짧게 눌러 여는 연결 화면의 "매뉴얼" 버튼으로 봅니다.
 
+## 0.9.0-beta.2의 새 기능
+
+0.9.0-beta.2(2026-10-29 KST, Android `versionCode` 28)는 0.8.0-beta.7에서 업데이트하기 위한 핫픽스입니다. 엔진 `5.1.48-zgw`(OMO 5.1.48, 패치 개정 2, senpi 2026.10.25-2, 대화 스키마 10)를 선택합니다. 전체 노트는 [docs/releases/0.9.0-beta.2.ko.md](docs/releases/0.9.0-beta.2.ko.md)에 있습니다.
+
+- **0.8.0-beta.7에서 업데이트 복구:** 0.9.0-beta.1은 이미 스키마 10으로 바뀐 대화 저장소에서 시작하지 못했습니다. 이 릴리스는 스키마 10을 읽고 세션, 등록, 설정, 기록을 유지합니다.
+- **시간 초과 대신 분명한 거부:** 엔진이 공유 대화 저장소를 읽지 못하는 업데이트는 아무것도 설치하기 전에 거부합니다. 강제 업데이트도 거부하며 웹 설정에 오류를 보여 줍니다.
+- **더 안정적인 엔진 연결:** 게이트웨이가 엔진 브리지 연결에 Bun WebSocket 클라이언트를 더 쓰지 않습니다. 이 클라이언트는 긴 세션에서 연결을 끊을 수 있었습니다.
+- **앱:** 동작 변화가 없습니다. `versionCode` 28은 이 릴리스 표시입니다.
+
+## 0.9.0-beta.1의 새 기능
+
+0.9.0-beta.1(2026-10-28 KST, Android `versionCode` 27)은 엔진 `5.1.44-zgw`(OMO 5.1.44, senpi 2026.10.21-3, 대화 스키마 7)를 선택합니다. 전체 노트는 [docs/releases/0.9.0-beta.1.ko.md](docs/releases/0.9.0-beta.1.ko.md)에 있습니다.
+
+- **채팅 도식:** 웹과 Android 앱이 답변의 `zigmini-diagram` 블록을 그립니다.
+- **보안 확인함과 정확값 허용:** 보안검사로 보류한 항목이 웹과 앱의 확인함에 나옵니다. 보내기를 고르면 게이트웨이가 표시한 정확값을 설치별 목록에 기억합니다. 기억한 값은 설정에서 보고 지웁니다.
+- **알림 설정:** 웹 설정이나 앱 설정 화면에서 "확인함 알림만"과 "모든 답장 알림" 중 하나를 고릅니다. "모든 답장 알림" 저장의 HTTP 500 오류를 고쳤습니다.
+- **화면 수정:** 웹 이동 버튼이 메시지를 가리지 않고, Android 헤더에 모델 선택기 자리가 남습니다.
+
+릴리스 발행은 맥과 폰을 바꾸지 않습니다. 맥은 "업데이트" 또는 `zigmini update`를 실행할 때까지 설치된 게이트웨이와 엔진을 유지합니다. 폰은 새 APK를 설치할 때까지 기존 앱을 유지합니다.
+
+남은 문제: 버그 80(Android 참조 밀기, 요구사항만 기록), 버그 184(Android 음성 버튼 잘림, 미확정), 버그 205(Git 객체 검사 범위만 바꿈, 과거 14922건은 기록으로 남고 GitHub 지원 요청은 보류), 버그 212(변이 기록 작성기 미수정). 진단 보고와 수신 서버는 이번 릴리스에 없습니다.
+
 ## 완료 답변 통계
 
 웹 채팅과 새 Android 앱은 완료 답변 아래에 엔진이 측정한 TPS(초당 토큰 수),
@@ -299,7 +321,7 @@ zigmini update <버전>     # 지정한 버전으로 업데이트
   ```sh
   zigmini setup --access lan   # 또는 tailscale, domain --domain https://<도메인>
   ```
-- **설치 뒤 에이전트가 답하지 않습니다.** 모델 계정에 로그인하지 않았습니다(예: 로그인 단계에서 `s`를 입력함). 설치 15~18번(`bun add -g omo-ai@5.1.35`, `omo`, `/login`)을 합니다. 그 뒤 `zigmini setup`을 다시 실행합니다. "모델 계정: 로그인됨"이 나오고, 이미 끝난 단계는 유지됩니다. `--agent-dir`을 쓰면 `OMO_CODING_AGENT_DIR=<경로> omo`로 실행해야 그 폴더에 로그인됩니다.
+- **설치 뒤 에이전트가 답하지 않습니다.** 모델 계정에 로그인하지 않았습니다(예: 로그인 단계에서 `s`를 입력함). 설치 15~18번(`bun add -g omo-ai@5.1.48`, `omo`, `/login`)을 합니다. 그 뒤 `zigmini setup`을 다시 실행합니다. "모델 계정: 로그인됨"이 나오고, 이미 끝난 단계는 유지됩니다. `--agent-dir`을 쓰면 `OMO_CODING_AGENT_DIR=<경로> omo`로 실행해야 그 폴더에 로그인됩니다.
 - 오래된 DB 백업, 쓰지 않는 엔진 버전, 업데이트에서 남은 파일은 웹 화면 설정의 "정리"에서 확인하고, 고른 항목만 지웁니다.
 
 ## 제거

package/README.md

@@ -70,7 +70,7 @@ The gateway runs the agent with the permission preset `full-access`. The agent d
    ```sh
    zigmini --version
    ```
-   - If the result is one version line that starts with a number (for example `0.8.0-beta.7`), go to step 15.
+   - If the result is one version line that starts with a number (for example `0.9.0-beta.1`), go to step 15.
    - If the result is `zsh: command not found: zigmini`, the Bun global command folder is not in PATH. Go to step 10.
 10. Put the Bun global command folder in PATH in the current terminal window. This command applies only to the current terminal window and changes no file.
     ```sh
@@ -95,9 +95,9 @@ The gateway runs the agent with the permission preset `full-access`. The agent d
 14. Run the command of step 9 again.
     - If the result is one version line that starts with a number, go to step 15.
     - If the result is still `zsh: command not found: zigmini`, stop the installation. Run `ls "$(bun pm bin -g)"`. If the result does not contain `zigmini`, look for lines that start with `error:` in the output of `bun add -g zigmini` in step 8.
-15. Install the agent engine `omo-ai` globally. This step is required: without the `omo-ai` installation and the model account login, the gateway does not work. If you skip steps 15 to 18, `zigmini setup` installs the global `omo` itself and stops at the login step, but you must still log in. Do the steps here anyway. Use the stock version that the gateway pins (`omo` in `src/engine/compat.json`; 5.1.35 at the time of writing).
+15. Install the agent engine `omo-ai` globally. This step is required: without the `omo-ai` installation and the model account login, the gateway does not work. If you skip steps 15 to 18, `zigmini setup` installs the global `omo` itself and stops at the login step, but you must still log in. Do the steps here anyway. Use the stock version that the gateway pins (`omo` in `src/engine/compat.json`; 5.1.48 in 0.9.0-beta.2; installed releases keep their own pin).
     ```sh
-    bun add -g omo-ai@5.1.35
+    bun add -g omo-ai@5.1.48
     ```
 16. Check that the shell finds the `omo` command. The result must be one version line.
     ```sh
@@ -118,7 +118,7 @@ The gateway runs the agent with the permission preset `full-access`. The agent d
 1. It asks for the language: `Language / 언어 [1] English [2] 한국어`. All later messages use this language. The choice is saved in `~/.zigmini/language` and used by `zigmini setup --access`, `zigmini pair` and the ready wait of `zigmini start` and `restart`. `--lang en|ko` picks it without the question. Without a question (`--non-interactive`) the saved language is used, else the system language (`LANG`, `ko…` means Korean), else English.
 2. It shows the permission notice and asks for your consent.
 3. It creates the home folder `~/.zigmini`. If the rules file of this installation (`~/.zigmini/rules.md`) does not exist, it creates an empty one. See "Agent rules" below.
-4. It downloads the pinned version of the agent engine (omo-ai), checks its hash and patches it. The package decides the version (`src/engine/compat.json`; engine 5.1.35 at the time of writing). It shows a summary of the engine license and asks for your consent (`y`).
+4. It downloads the pinned version of the agent engine (omo-ai), checks its hash and patches it. The package decides the version (`src/engine/compat.json`; engine 5.1.48 at the time of writing). It shows a summary of the engine license and asks for your consent (`y`).
 5. It installs the global `omo` command with `bun add -g omo-ai@<version>`, the same stock version as the pinned engine. If the global `omo` already has this version, it skips the installation. If it has another version, it asks `Replace it with <version>? (y/N)`; without a question it keeps the installed one. If the installation fails, it shows the long command of the pinned engine for the login instead.
 6. It checks the agent folder and the login state of the model account. The default agent folder is `~/.omo/agent`. Other OMO installations that use the same folder share the login data. If you are not logged in, it shows this box and waits:
    ```text
@@ -195,6 +195,28 @@ F0:AB:B3:B2:DC:70:1A:45:19:85:69:7D:58:68:F5:FB:4F:AC:33:4F:D8:6A:68:DD:04:5C:53
 
 The user manual ([English](docs/manual.md), [한국어](docs/manual.ko.md)) opens from the "매뉴얼" (Manual) button at the top of the web settings dialog, and in the app from the "매뉴얼" button on the connection screen that a short press on the header status tag opens.
 
+## What's new in 0.9.0-beta.2
+
+Release 0.9.0-beta.2 (2026-10-29 KST, Android `versionCode` 28) is a hotfix for updating from 0.8.0-beta.7. It selects engine `5.1.48-zgw` (OMO 5.1.48, patch revision 2, senpi 2026.10.25-2, thread schema 10). Full notes: [docs/releases/0.9.0-beta.2.md](docs/releases/0.9.0-beta.2.md).
+
+- **Update from 0.8.0-beta.7 works again:** 0.9.0-beta.1 could not start against a thread store that had already moved to schema 10. This release reads schema 10 and keeps sessions, registrations, settings and history.
+- **Clear refusal instead of a timeout:** an update whose engine can't read the shared thread store is refused before anything is installed, with an error in the web settings, even with force.
+- **Steadier engine connection:** the gateway no longer uses Bun's WebSocket client for the engine bridge, which could drop the connection in long sessions.
+- **App:** no behavior change; `versionCode` 28 only marks this release.
+
+## What's new in 0.9.0-beta.1
+
+Release 0.9.0-beta.1 (2026-10-28 KST, Android `versionCode` 27) selects engine `5.1.44-zgw` (OMO 5.1.44, senpi 2026.10.21-3, thread schema 7). Full notes: [docs/releases/0.9.0-beta.1.md](docs/releases/0.9.0-beta.1.md).
+
+- **Diagrams in chat:** the web and the Android app draw `zigmini-diagram` blocks in answers.
+- **Security inbox and exact-value consent:** held security-check items appear in the web and app inbox. When you send one, the gateway remembers the exact displayed values for that installation. You can review and remove them in the settings.
+- **Notification settings:** choose "확인함 알림만" (Inbox notifications only) or "모든 답장 알림" (All reply notifications) in the web settings or the app settings screen. Saving "All reply notifications" no longer fails with HTTP 500.
+- **UI fixes:** the web scroll buttons no longer cover messages, and the Android header keeps room for the model picker.
+
+Publishing a release doesn't change your Mac or phone. The Mac keeps its installed gateway and engine until you run "업데이트" (Update) or `zigmini update`, and the phone keeps its app until you install the new APK.
+
+Still open: bug 80 (Android reference swipe, only requirements recorded), bug 184 (Android voice button clipping, unconfirmed), bug 205 (only the Git-object scope changed; the 14922 historical findings stay recorded and the GitHub support request stays deferred) and bug 212 (the mutation-record writer is not fixed). Diagnostic reports and the receiver server aren't part of this release.
+
 ## Completed-answer statistics
 
 The web chat and updated Android app show available engine measurements below a
@@ -300,7 +322,7 @@ Use these workarounds.
   ```sh
   zigmini setup --access lan   # or tailscale, or domain --domain https://<도메인>
   ```
-- **After the installation the agent does not answer.** The model account is not logged in (for example you typed `s` at the login step). Do install steps 15 to 18 (`bun add -g omo-ai@5.1.35`, `omo`, `/login`). Then run `zigmini setup` again. It shows "Model accounts: logged in" and keeps the steps that are already done. If you use `--agent-dir`, start `omo` with `OMO_CODING_AGENT_DIR=<경로> omo` so that it logs in to that folder.
+- **After the installation the agent does not answer.** The model account is not logged in (for example you typed `s` at the login step). Do install steps 15 to 18 (`bun add -g omo-ai@5.1.48`, `omo`, `/login`). Then run `zigmini setup` again. It shows "Model accounts: logged in" and keeps the steps that are already done. If you use `--agent-dir`, start `omo` with `OMO_CODING_AGENT_DIR=<경로> omo` so that it logs in to that folder.
 - Old DB backups, unused engine versions and files left by updates appear in "정리" (Clean up) in the web screen settings. Only the items you select are deleted.
 
 ## Uninstall

package/assets/agent/gateway-request-rules.md

@@ -1 +1,3 @@
-사용자에게 보여 주는 답변은 ASD-STE100의 명확한 기술문서 작성 원칙을 따른다. 짧은 능동문을 쓰고, 한 문장에는 한 가지 내용만 담는다. 주체·대상·행동을 명확히 밝히고, 같은 대상에는 같은 용어를 쓴다.
+사용자에게 보여 주는 모든 답변과 설명은 ASD-STE100의 명확한 기술문서 작성 원칙을 따른다. 짧은 능동문을 쓰고, 한 문장에는 한 가지 내용만 담는다. 주체·대상·행동을 명확히 밝히고, 같은 대상에는 같은 용어를 쓴다.
+
+흐름이나 구조를 설명할 때 도식이 도움이 되면 `docs/manual.md`의 `zigmini-diagram` 형식으로 함께 표시한다.

package/assets/android/zigmini.apk.json

@@ -1,5 +1,5 @@
 {
-  "versionCode": 26,
-  "versionName": "0.8.0-beta.7",
-  "sha256": "f942411ee27d4f6e909e7f7039df209b92c450653a204afbf341ff96bfa71e73"
+  "versionCode": 28,
+  "versionName": "0.9.0-beta.2",
+  "sha256": "3588a9b0124a4d483d84038edf86f68cf3d96e0d071d5eb93ff556908507e012"
 }

package/assets/build.json

@@ -1 +1 @@
-{"commit":"e452e86a218e619d9e639cd6a4b3d92c22c33e0c"}
+{"commit":"78cb593c5a3f2599a4196e877f2d07d3e90fd506"}

package/docs/manual.ko.md

@@ -92,6 +92,44 @@ README의 '명령' 절에 따르면 채팅에서 `/usage`를 보내면 게이트
 
 ### 2.3 첨부와 참조
 
+#### 흐름도와 구조도
+
+웹과 Android 채팅은 완성된 `zigmini-diagram` 코드 블록을 도식으로 표시합니다.
+좁은 화면에서도 글자를 줄이지 않습니다. 도식 안을 스크롤하면 화면 밖의 노드를 볼 수 있습니다.
+원문 표시를 열면 원래 JSON을 선택하고 복사할 수 있습니다.
+메시지를 참조하면 이미지나 로컬 경로가 아니라 원래 본문을 전달합니다.
+기록 조회와 재연결도 같은 저장 본문을 사용합니다. 업로드나 외부 렌더러는 필요하지 않습니다.
+
+에이전트는 답변 본문에 아래처럼 완성된 블록을 넣습니다.
+
+````markdown
+```zigmini-diagram
+{"version":1,"title":"요청 흐름","nodes":[{"id":"request","label":"요청"},{"id":"gateway","label":"게이트웨이"},{"id":"reply","label":"답변"}],"edges":[{"from":"request","to":"gateway"},{"from":"gateway","to":"reply"}]}
+```
+````
+
+지원 형식은 순환 없는 작은 방향 그래프입니다. Mermaid나 임의 SVG·HTML은 지원하지 않습니다.
+갈라지는 연결로 구조를 표현할 수 있습니다.
+노드는 위에서 아래로 배치합니다. 같은 깊이의 노드는 입력 순서로 배치합니다.
+
+- 최상위 필수 키는 `version: 1`, `nodes`, `edges`입니다. `title`은 선택 항목입니다.
+- 노드에는 `id`와 `label`만 넣습니다. 노드는 1~16개입니다.
+  ID는 서로 달라야 하며 `[A-Za-z][A-Za-z0-9_-]{0,31}` 형식을 사용합니다.
+  이름은 공백만이 아닌 일반 텍스트로 쓰며 유니코드 코드 포인트 48개까지입니다.
+- 연결에는 기존 노드의 ID인 `from`과 `to`만 넣습니다. 연결은 0~24개입니다.
+  중복 연결, 자기 자신으로의 연결, 순환은 지원하지 않습니다.
+- 선택 제목은 공백만이 아닌 일반 텍스트로 쓰며 유니코드 코드 포인트 80개까지입니다.
+  제목과 이름에는 제어 문자 U+0000~U+001F와 U+007F를 넣을 수 없습니다.
+- JSON은 UTF-16 코드 단위 16,384개까지입니다. 다른 키는 지원하지 않습니다.
+  들여쓰기 없는 백틱 세 개와 위 예시의 정확한 언어 이름을 사용합니다.
+
+미완성·잘못된 형식·미지원 블록은 원문으로 표시합니다.
+스트리밍 중 블록이 완성되고 형식이 맞으면 도식으로 표시할 수 있습니다.
+도식 내용은 스크립트 실행, URL 로드, 파일 읽기를 할 수 없습니다.
+이 기능이 없는 이전 클라이언트는 코드 블록으로 표시합니다.
+짧은 매 요청 규칙은 흐름이나 구조 설명에 도움이 될 때만 도식을 사용하도록 안내합니다.
+모든 답변에 도식을 요구하지 않습니다.
+
 #### 이미지
 
 - "이미지" 버튼을 눌러 이미지를 고릅니다.
@@ -176,9 +214,16 @@ README의 '명령' 절에 따르면 채팅에서 `/usage`를 보내면 게이트
 #### 보안검사
 
 - "보안검사 켜짐/꺼짐"은 보내는 메시지의 검사를 켜고 끕니다. 기본은 켜짐이고 게이트웨이가 설정을 기억합니다.
-- 메시지에 비밀키, 토큰, 비밀번호, 쿠키, 홈 폴더 경로, 내부 주소 같은 값이 있으면 보내지 않습니다. 채팅에 "보안검사 결과" 카드가 뜨고 값마다 종류, 실제 값, 줄과 칸을 보여 줍니다.
-- "보내기"를 누르면 원래 메시지를 에이전트에 보냅니다. "보내지 않기"를 누르면 버리고 글을 입력창에 되돌립니다.
-- 확인함에서 입력한 답도 같은 검사를 거치고, 카드는 채팅에 뜹니다.
+- 메시지나 확인함 답에 허용하지 않은 값이 탐지되면 게이트웨이가 에이전트에 보내기 전에 보류합니다. 확인함과 채팅에는 같은 보안 항목이 보입니다. 항목은 기억할 전체 값과 종류를 보여 줍니다.
+- 보내기를 선택하면 원래 메시지를 전송하고 표시한 정확한 값을 이 게이트웨이에 기억합니다. 다음부터 같은 값은 다시 묻지 않습니다. 다른 값은 계속 확인합니다. 이미 보류한 메시지를 자동으로 보내지는 않습니다.
+- 취소는 이번 전송만 중단합니다. 기존 작업은 중단하지 않습니다. 보류한 내용이 확인함 답이면 원래 질문은 답하지 않은 상태로 남고 답변 입력란도 유지합니다.
+- 웹은 같은 대화의 입력창이 비어 있을 때만 취소한 메시지의 글을 되돌립니다. 새로 작성한 초안은 바꾸지 않습니다. Android는 취소한 메시지를 입력창에 되돌리지 않습니다. 전송 결과가 미확인이면 자동 복구하거나 다시 보내지 않습니다.
+- 요청을 처리하는 동안 선택 버튼을 잠급니다. HTTP 응답, 실시간 이벤트, 재연결 결과로 같은 항목을 갱신합니다. 미확인은 전달을 확인하지 못했다는 뜻입니다. 다시 보내지 말고 상태 확인을 사용합니다.
+- 값을 기억한 뒤 전송합니다. 저장에 실패하면 보내지 않습니다. 저장한 뒤 전송에 실패하거나 결과를 확인하지 못하면 값은 기억된 상태로 남습니다. 결과는 기억 여부와 전송 상태를 따로 알립니다.
+- 허용 목록은 이 설치에만 비공개로 저장하며 게이트웨이를 다시 시작해도 유지합니다. 웹 설정의 보안검사 구역에서 목록을 봅니다. Android는 매뉴얼 버튼이 있는 게이트웨이 설정 화면에서 허용 값 목록을 엽니다.
+- 항목마다 전체 값, 종류, 승인 시각, 승인한 클라이언트를 보여 줍니다. 개별 삭제나 전체 삭제를 하면 다음 전송부터 해당 값을 다시 검사합니다. 삭제는 이미 승인한 전송을 취소하거나 보낸 메시지를 지우지 않습니다.
+- 구형 앱의 보내기는 한 번만 전송하며 값을 기억하지 않습니다. 값을 기억하려면 새 화면의 전송·기억 선택이 필요합니다. 미승인 원문은 일반 질문 기록이나 대화 이력에 저장하지 않습니다. 게이트웨이를 다시 시작하면 보류 원문은 사라집니다.
+- 이 목록은 메시지와 답변의 전송 검사에만 적용합니다. 저장소와 릴리스 보안검사는 바꾸지 않습니다.
 
 #### 업데이트
 
@@ -194,10 +239,17 @@ README의 '명령' 절에 따르면 채팅에서 `/usage`를 보내면 게이트
 | 확인함에 답을 기다리는 질문이 있음 | 버튼이 꺼집니다. "답을 기다리는 질문이 N개 있습니다" 안내와 "확인함 열기" 버튼이 보입니다. 질문에 답한 뒤 업데이트할 수 있습니다. |
 | 권한 안내가 바뀜 | 새 안내문이 보입니다. 입력란에 동의를 입력해야 진행합니다. |
 | 공유 데이터 형식 변경 | 변경 내용을 보여 주고 확인을 받습니다. |
+| 저장된 데이터 형식이 대상 엔진의 지원 범위보다 새로움 | 설치 전에 업데이트를 멈춥니다. 오류에 저장 형식과 지원 형식이 나옵니다. 확인하거나 강제로 실행해도 이 거부를 우회할 수 없습니다. |
 | 진행 중인 작업이 있음 | 게이트웨이가 바쁘다는 안내가 보입니다. |
 
 업데이트하면 게이트웨이와 브리지가 다시 시작됩니다. 그동안 연결과 진행 중인 대화가 잠시 끊길 수 있습니다. 진행 상황이 영역 아래에 보입니다. 끝나면 페이지를 새로 고칩니다.
 
+공유 데이터 형식이 더 새로우면 그 형식을 지원하는 엔진 릴리스가 필요합니다.
+저장 형식 번호를 낮추거나 에이전트 폴더를 초기화하지 마세요.
+새 세대가 시작을 거부하면 업데이트가 그 이유를 표시합니다.
+기존 실행을 아직 바꾸지 않았다면 기존 세대를 유지합니다.
+에이전트가 연결됐다는 사실만으로 공유 thread 저장소의 정상 동작을 판단할 수는 없습니다.
+
 #### 기기 등록
 
 - 폰 등록 QR이 보입니다. QR 하나는 10분 동안 한 번만 쓸 수 있습니다.
@@ -329,10 +381,11 @@ Ctrl 단축키는 Cmd, Alt, Shift와 함께 누르면 동작하지 않습니다.
 ### 4.6 알림
 
 - 등록한 게이트웨이마다 알림 연결이 하나씩 있습니다.
-- 웹 설정을 열거나 앱 헤더의 지그를 눌러 작업 상태 화면을 연 뒤 앱 알림 수준을 고릅니다.
+- 웹 설정에서 앱 알림 수준을 고릅니다. 앱에서는 헤더의 상태 태그를 짧게 눌러 기존 설정창을 엽니다. 두 선택기는 매뉴얼 위에 있으며 작업 상태 화면에는 없습니다.
 - "확인함 알림만"이 기본값입니다. 기존 확인 요청 알림을 유지합니다.
 - "모든 답장 알림"은 확인 요청 알림과 main·작업 에이전트의 개별 완성 답장을 알립니다. 사용자 메시지와 스트리밍 조각은 알리지 않습니다.
 - 두 화면은 같은 게이트웨이 저장값을 바꿉니다. 앱은 현재 게이트웨이만 바꿉니다. 설정을 바꿔도 과거 답장을 다시 알리지 않습니다.
+- 저장에 실패하면 마지막으로 확인된 선택을 유지합니다. "다시 시도"는 저장값을 다시 읽습니다. 읽기가 끝나면 원하는 항목을 다시 고릅니다.
 - 일정과 명시적 알림은 이 선택과 별개입니다. 확인 요청 알림의 기존 웹 화면 표시 여부 규칙도 유지합니다.
 - 답장 알림을 누르면 보낸 게이트웨이의 채팅을 엽니다. 같은 답장을 재전송해도 다시 알리지 않습니다.
 - 알림은 소리 없이 진동만 합니다.

package/docs/manual.md

@@ -92,6 +92,42 @@ The README's Commands section says that sending `/usage` in chat makes the gatew
 
 ### 2.3 Attachments and references
 
+#### Flow and structure diagrams
+
+Web and Android chat render complete `zigmini-diagram` fenced blocks as diagrams.
+Labels remain readable on narrow screens: scroll inside the diagram to reach
+off-screen nodes. Open its source control to select and copy the original JSON.
+Referencing the message sends its original text, not an image or a local path.
+History and reconnect use the same stored text. No upload or external renderer is needed.
+
+For agents, use this complete block in the assistant's message body:
+
+````markdown
+```zigmini-diagram
+{"version":1,"title":"Request flow","nodes":[{"id":"request","label":"Request"},{"id":"gateway","label":"Gateway"},{"id":"reply","label":"Reply"}],"edges":[{"from":"request","to":"gateway"},{"from":"gateway","to":"reply"}]}
+```
+````
+
+The supported format is a small directed acyclic graph, not Mermaid or arbitrary
+SVG/HTML. Branching edges express a structure. Nodes appear top-to-bottom; nodes
+at the same depth follow their input order.
+
+- Root keys: required `version: 1`, `nodes`, `edges`; optional `title`.
+- Each node has only `id` and `label`. Use 1–16 nodes with unique IDs matching
+  `[A-Za-z][A-Za-z0-9_-]{0,31}`. Labels are nonblank plain text, at most 48 Unicode code points.
+- Each edge has only `from` and `to`, naming existing nodes. Use 0–24 edges.
+  Duplicate edges, self-links and cycles are not supported.
+- The optional title is nonblank plain text, at most 80 Unicode code points.
+  Titles and labels cannot contain control characters U+0000–U+001F or U+007F.
+- JSON is at most 16,384 UTF-16 code units. Extra keys are not supported.
+  Use unindented triple backticks and the exact language name shown above.
+
+Unfinished, invalid or unsupported blocks remain visible as source. When a streamed
+block becomes complete and valid, chat can render it. Diagram text cannot run
+scripts, load URLs or read files. An older client displays the code block instead.
+The concise per-request instruction asks for a diagram only when it helps explain
+a flow or structure; it does not require diagrams in every reply.
+
 #### Images
 
 - Click 이미지 (image) to pick images.
@@ -176,9 +212,16 @@ In a name field, Enter saves and Esc cancels. Leaving the field also saves. Name
 #### Security check (보안검사)
 
 - "보안검사 켜짐/꺼짐" (security check on/off) turns the check of your messages on or off. It is on by default and the gateway keeps the choice.
-- When a message holds a private key, token, password, cookie, home folder path, internal address or similar value, it is not sent. A "보안검사 결과" card in the chat lists each value, its kind and its line and column.
-- "보내기" (send) sends the original message to the agent. "보내지 않기" (don't send) drops it and puts the text back in the input box.
-- An answer typed in the inbox is checked the same way; its card shows in the chat.
+- When a message or inbox answer contains a detected value that is not allowed, the gateway holds it before sending it to the agent. The same security item appears in the inbox and chat. It shows the complete values to be remembered and their types.
+- Approving sends the original message and remembers the displayed exact values on this gateway. The same values do not prompt again. A different value still needs approval. Existing held messages do not send automatically.
+- Cancel stops only this transmission. It does not stop the existing work. If the held transmission is an inbox answer, the original question remains unanswered and its answer form stays available.
+- On web, a cancelled message can restore its text only in an empty input box of the same conversation. A newer draft is never replaced. Android does not restore a cancelled message to its input box. A transmission with an unconfirmed result is not automatically restored or sent again.
+- Controls lock while the request is processing. HTTP replies, live events and reconnects update the same item. An unconfirmed result means the client has no proof of delivery; use the status check instead of sending again.
+- Remembering happens before dispatch. If saving fails, the message is not sent. If saving succeeds but dispatch fails or cannot be confirmed, the values remain remembered and the result reports both facts.
+- The allowed-value list is private to this installation and survives gateway restarts. Web settings show the list under Security check. On Android, open the gateway settings screen that contains Manual, then open the allowed values.
+- Each entry shows its full value, type, approval time and approving client. Remove one entry or clear the list to check those values again on future transmissions. Removal does not cancel a transmission already approved or erase a sent message.
+- An older app's send-only approval still sends once without remembering values. Remembering requires the new send-and-remember choice. Unapproved original messages are not saved in ordinary question records or history; pending originals are lost on gateway restart.
+- This list affects runtime message and answer checking only. It does not change repository or release security checks.
 
 #### Update (업데이트)
 
@@ -194,10 +237,17 @@ The update button is held, or asks for more, in these cases.
 | Inbox questions are waiting for you | The button is disabled. A line says N questions are waiting, with a 확인함 열기 (open inbox) button. Answer them, then update. |
 | The permission notice changed | The new notice shows. Type the consent word (동의) in the field to go on. |
 | Shared data format change | The changes are shown and you confirm them. |
+| Stored data is newer than the target engine supports | The update stops before installation. The error names the stored and supported formats. Confirmation or forcing the update cannot bypass this refusal. |
 | Work is running | A notice says the gateway is busy. |
 
 An update restarts the gateway and the bridge. Connections and running chats may drop for a moment. Progress shows below. When it's done, reload the page.
 
+A newer shared data format needs a compatible engine release. Do not lower the
+stored format number or reset the agent folder. If a new generation refuses to
+start, the update reports that reason and keeps the old running generation when
+it has not been changed. A connected agent alone does not prove that its shared
+thread storage works.
+
 #### Device registration (기기 등록)
 
 - A phone registration QR shows. Each QR works once, for 10 minutes.
@@ -329,10 +379,11 @@ Tap the Zig face to open it. Slot states include running, waiting for input, wai
 ### 4.6 Notifications
 
 - Each registered gateway has its own notification connection.
-- Open web settings or tap Zig in the app header to open work status, then choose the app notification level.
+- Open web settings to choose the app notification level. In the app, short press the header status tag to open the existing settings screen. Both choices are above Manual, not in work status.
 - "확인함 알림만" (Inbox notifications only) is the default. It keeps the existing confirmation notifications.
 - "모든 답장 알림" (All reply notifications) includes confirmation notifications and each completed main/work agent reply. User messages and streaming fragments do not alert.
 - Both screens edit the same saved gateway value. The app edits only its active gateway. Changing the value does not replay old replies.
+- If saving fails, the last confirmed choice stays selected. Retry reloads the saved value. Select the desired choice after reloading.
 - Schedule reminders and explicit notifications are independent of this choice. The existing visible-web rule for confirmation notifications still applies.
 - Reply notification taps open chat on the sending gateway. Replayed delivery of the same reply does not alert again.
 - Notifications vibrate with no sound.

package/host/omo-bridge/ascii-json.ts

@@ -0,0 +1,5 @@
+// Bug 220: Bun 1.4.2 rejects large multibyte JSON frames in the RPC regression.
+// JSON escapes preserve every UTF-16 code unit while keeping wire text ASCII.
+export function asciiJson(line: string): string {
+	return line.replace(/[^\x00-\x7f]/g, (character) => `\\u${character.charCodeAt(0).toString(16).padStart(4, "0")}`);
+}

package/host/omo-bridge/bridge.ts

@@ -1,15 +1,18 @@
 import { existsSync, mkdirSync, readFileSync, realpathSync, rmSync, writeFileSync } from "node:fs";
 import { randomBytes, randomUUID } from "node:crypto";
 import { basename, dirname, join } from "node:path";
-import type { ServerWebSocket, Socket, Subprocess } from "bun";
+import type { ServerWebSocket, Subprocess } from "bun";
+import type { Socket } from "node:net";
 import { bounded, maintenanceAuth, MaintenanceError } from "../../src/maintenance.ts";
 import { runtimePaths } from "../../src/runtime/paths.ts";
 import { installKind } from "../../src/runtime/install-kind.ts";
 import { loadNotice, startRefusal } from "../../src/consent/consent.ts";
 import { engine, engineSearchPath } from "../../src/engine/index.ts";
+import { connectEngineSocket } from "../../src/engine/rpc-socket.ts";
 import { bunInstallDir, guardMode, guardStart } from "../../src/engine/schema-guard.ts";
 import { bridgeMayRun, readRegistry } from "../../src/runtime/slots.ts";
 import { BridgeMaintenance } from "./maintenance.ts";
+import { asciiJson } from "./ascii-json.ts";
 
 const paths = runtimePaths();
 const home = paths.home;
@@ -39,6 +42,7 @@ if (slotMode) {
 const agentDir = process.env.ZGW_OMO_AGENT_DIR ?? join(process.env.HOME ?? ".", ".omo", "agent");
 // Bug 73: a shared store newer than the pinned engine keeps the bridge down (exit 0: launchd does not restart it).
 const schemaGuard = guardStart({ agentDir, run: paths.run, mode: guardMode(process.env),
+	origin: { slot: slotMode ? paths.slot : null, engine: engineRoot ? basename(engineRoot) : null },
 	supported: () => engine.supportedThreadSchema(home, engineRoot), bunInstall: bunInstallDir(process.env), now: () => new Date() });
 if (schemaGuard.log !== null) console.error(`${new Date().toISOString()} ${schemaGuard.log}`);
 if (schemaGuard.refuse) process.exit(0);
@@ -124,7 +128,8 @@ type Link = {
 	readonly identity: string | null;
 	readonly epoch: string;
 	readonly previousFailure: string | null;
-	upstream: Socket<undefined> | null;
+	upstream: Socket | null;
+	upstreamBlocked: boolean;
 	frontend: ServerWebSocket<Link> | null;
 	connecting: boolean;
 	ready: boolean;
@@ -150,7 +155,7 @@ const links = new Set<Link>();
 maintenance = new BridgeMaintenance(paths.maintenanceFile,
 	() => ({ generation: nativeGeneration, binary: nativeBinary }),
 	() => omo.exitCode === null && [...links].filter((link) => link.nativeGeneration === nativeGeneration).every((link) =>
-		!link.connecting && !link.activeOut && link.out.length === 0 && link.pending.size === 0 &&
+		!link.connecting && !link.upstreamBlocked && !link.activeOut && link.out.length === 0 && link.pending.size === 0 &&
 		!link.frontendBlocked && !link.frontendPending && link.frontendOut.length === 0 &&
 		link.pendingUiWrites.size === 0 && !link.untrackedWrite && link.ui.size === 0),
 	async () => {
@@ -191,8 +196,9 @@ function fail(link: Link, reason: string): void {
 	link.failure = reason;
 	logBridgeError(`omo bridge: requester ${link.epoch} lost: ${reason}`);
 	link.frontend?.close(1011, reason);
-	link.upstream?.end();
+	link.upstream?.destroy();
 	link.upstream = null;
+	link.upstreamBlocked = false;
 	link.activeOut = null;
 	link.out = [];
 	link.outBytes = 0;
@@ -234,6 +240,7 @@ function flushFrontend(link: Link): void {
 }
 
 function deliver(link: Link, line: string): void {
+	line = asciiJson(line);
 	const ws = link.frontend;
 	if (!ws || ws.readyState !== WebSocket.OPEN) return;
 	if (link.frontendBlocked || link.frontendPending || link.frontendOut.length > 0) {
@@ -314,17 +321,20 @@ function receive(link: Link, line: string): void {
 
 const encoder = new TextEncoder();
 
-// Bun's Socket.write writes only what fits in the socket buffer (8 KB for macOS unix sockets) and returns that count.
-// The rest must be queued and written on drain; otherwise a long line (a pasted text, a session handoff) is cut, omo
-// cannot parse it, and the next command glued to the cut-off tail is lost too.
+// net.Socket accepts the complete chunk; false means wait for drain before writing the next one.
+// Keep later commands in the bounded bridge queue instead of the socket's unbounded writable queue.
 function flush(link: Link): void {
 	const upstream = link.upstream;
-	if (!upstream) return;
+	if (!upstream || link.upstreamBlocked) return;
+	if (!link.activeOut) {
+		link.activeOut = link.out.shift() ?? null;
+		if (link.activeOut) link.outBytes -= link.activeOut.length;
+	}
 	while (link.activeOut) {
-		const chunk = link.activeOut;
-		const written = Math.max(upstream.write(chunk), 0);
-		if (written < chunk.length) {
-			link.activeOut = chunk.subarray(written);
+		const writable = upstream.write(link.activeOut);
+		link.activeOut = null;
+		if (!writable) {
+			link.upstreamBlocked = true;
 			return;
 		}
 		link.activeOut = link.out.shift() ?? null;
@@ -334,7 +344,7 @@ function flush(link: Link): void {
 
 function forward(link: Link, line: string): void {
 	const chunk = encoder.encode(`${line}\n`);
-	if (!link.activeOut) {
+	if (!link.activeOut && !link.upstreamBlocked) {
 		link.activeOut = chunk;
 		flush(link);
 		return;
@@ -401,6 +411,7 @@ const server = Bun.serve<Link>({
 			epoch: randomUUID(),
 			previousFailure: existing?.failure ?? null,
 			upstream: null,
+			upstreamBlocked: false,
 			frontend: null,
 			connecting: false,
 			ready: false,
@@ -440,42 +451,37 @@ const server = Bun.serve<Link>({
 			if (link.upstream || link.connecting) return;
 			link.connecting = true;
 			try {
-				const upstream = await Bun.connect({
-					unix: socketPath,
-					socket: {
-						data(_s, chunk) {
-							if (link.failure) return;
-							const text = link.decoder.decode(chunk, { stream: true });
-							let start = 0;
-							let at = text.indexOf("\n");
-							while (at >= 0) {
-								const line = `${link.buffer.join("")}${text.slice(start, at)}`.replace(/\r$/, "");
-								link.buffer = [];
-								if (line) receive(link, line);
-								start = at + 1;
-								at = text.indexOf("\n", start);
-							}
-							if (start < text.length) link.buffer.push(text.slice(start));
-						},
-						drain() {
-							flush(link);
-						},
-						close() {
-							fail(link, "omo_requester_disconnected");
-						},
-						error() {
-							fail(link, "omo_requester_error");
-						},
-					},
-				});
+				const upstream = await connectEngineSocket({ socketPath, binary: nativeBinary, agentDir });
 				if (link.failure || shuttingDown) {
-					upstream.end();
+					upstream.destroy();
 					return;
 				}
+				upstream.on("data", (chunk: Buffer) => {
+					if (link.failure) return;
+					const text = link.decoder.decode(chunk, { stream: true });
+					let start = 0;
+					let at = text.indexOf("\n");
+					while (at >= 0) {
+						const line = `${link.buffer.join("")}${text.slice(start, at)}`.replace(/\r$/, "");
+						link.buffer = [];
+						if (line) receive(link, line);
+						start = at + 1;
+						at = text.indexOf("\n", start);
+					}
+					if (start < text.length) link.buffer.push(text.slice(start));
+				});
+				upstream.on("drain", () => {
+					link.upstreamBlocked = false;
+					flush(link);
+				});
+				upstream.on("close", () => fail(link, "omo_requester_disconnected"));
+				upstream.on("error", () => fail(link, "omo_requester_error"));
 				link.upstream = upstream;
 				flush(link);
-			} catch {
-				fail(link, "omo_requester_unavailable");
+			} catch (error) {
+				const code = error instanceof Error && "code" in error && typeof error.code === "string" ? error.code : null;
+				fail(link, code === "auth_failed" || code === "auth_required" || code === "unsafe_key_record" ||
+					code === "host_identity_unproven" ? code : "omo_requester_unavailable");
 			} finally {
 				link.connecting = false;
 			}