abruption · Oct 19, 2026 · Oct 19, 2026 · Oct 19, 2026 · Oct 19, 2026
diff --git a/docs/cli-reference.md b/docs/cli-reference.md
@@ -453,6 +453,35 @@ from the desired release checkout to refresh both standalone program and skill.
 Local `session-peer update --check` and `session-peer update` also populate the
 same cache used by automatic notices.
 
+### Claude profiles managed by Orca
+
+On macOS, when neither `CLAUDE_CONFIG_DIR` nor `ANTHROPIC_CONFIG_DIR` selects a
+directory, discovery includes `~/.claude/sessions` and known same-user Orca
+`~/Library/Application Support/orca/claude-profiles/*/home/sessions` directories.
+An explicit environment directory retains its original scope and precedence;
+it never expands into other profiles. For example, use
+`CLAUDE_CONFIG_DIR="/path/to/profile/home" session-peer list --agent claude --json`
+to inspect one profile only. Installation paths are unchanged.
+
+On all platforms, default and explicit registry scans share a total limit of
+4,096 directory entries and bounded 1 MiB registration files. Only the additional
+Orca profile inventory is macOS-specific, limited to 128 immediate entries.
+Automatic profile directories reject symlinks, reparse points and foreign-user
+ownership. Discovery and doctor never read credentials, inbox keys or transcripts.
+Canonical aliases of one registry are scanned once. Distinct records claiming
+the same live PID or inbox conflict even when their public metadata is identical.
+
+Partial errors preserve healthy listing rows, but **any inventory error, including
+a live conflict, refuses every target selection**, even an unrelated healthy PID,
+for dry-run, send and handoff. An explicit directory can isolate errors in other
+profiles; it cannot repair conflicts or limits within the selected directory.
+Legacy single-directory handling of malformed records is unchanged.
+Selected record and endpoint evidence is rechecked without rescanning other
+profiles. Ordinary Unix socket aliases remain supported; their existing optional
+generation limitation remains. A generation token is not send permission or ACK.
+These checks do not authenticate a model, remove all filesystem races or prove
+receipt. Other Orca layouts and arbitrary configuration roots are not scanned.
+
 ### Environment variables
 
 | Variable | Effect |

diff --git a/docs/i18n-manifest.json b/docs/i18n-manifest.json
@@ -15,7 +15,7 @@
     "docs/ai-assistant-guide.md": "9624ec96b92fb688fae3be3c94cb3564c77985091be451fbf1f056a1af9b9d9c",
     "docs/antigravity.md": "f2b5122a0ce6e6fb5bd4d8ed50ce2c8bd2dc9c98ec8ce328405cf7c2cd24229d",
     "docs/architecture/agent-transports.md": "01a4e3942e87acb476595859f2e37f9653ea1e3bc19ebc68dced1adf20a6966f",
-    "docs/cli-reference.md": "a1aae5b881f4aa939c995d7bc06819d04f808da3b31fd0d5da66c817e1b47e82",
+    "docs/cli-reference.md": "43e9e3232d8975d3e6b17065f40f43ff590184cac503d2c8fdae05142668334b",
     "docs/compatibility-v1.md": "7e551aad37a369faff7e370728376763efb54c2c9e9cfd8556a0c19aabc3d103",
     "docs/contracts/handoff-v1.md": "46a953010c49214bd8f969412f26713384fbe09a0ba78ebf0fef75da40d0d889",
     "docs/diagnostics.md": "0949e53612eeab2cd7c7bbda498e14d71e9cb1b1189aa7722030cb8702cd8481",

diff --git a/docs/ja/cli-reference.md b/docs/ja/cli-reference.md
@@ -442,6 +442,32 @@ pip/pipx/uv のインストールは検査しません。リモート更新は
 ローカルの `session-peer update --check` および `session-peer update` は、自動通知で
 使用されるのと同じキャッシュも設定します。
 
+### Orca が管理する Claude プロファイル
+
+macOS で `CLAUDE_CONFIG_DIR` と `ANTHROPIC_CONFIG_DIR` を指定しない場合、
+`~/.claude/sessions` と同じユーザーが所有する既知の Orca ディレクトリ
+`~/Library/Application Support/orca/claude-profiles/*/home/sessions` を検索します。
+環境変数による明示指定は従来の優先順位と範囲を維持し、他のプロファイルへ広げません。
+1 つだけ確認するには
+`CLAUDE_CONFIG_DIR="/path/to/profile/home" session-peer list --agent claude --json`
+を使います。インストール先は変わりません。
+
+すべてのプラットフォームで、既定・明示指定の登録先検索は全体で 4,096 項目、
+登録ファイルごとに 1 MiB に制限されます。追加の Orca プロファイル検索だけが macOS 専用で、
+直下 128 項目が上限です。自動検索するプロファイルのシンボリックリンク、再解析ポイント、
+他のユーザーの所有権は拒否します。検索と doctor は認証情報、受信箱の鍵、会話履歴を読みません。
+同じ実体の登録ディレクトリの別名は 1 回だけ検索します。別の記録が同じ生存 PID または
+受信箱を主張すれば、公開メタデータが同一でも矛盾です。
+
+正常な一覧は残しますが、**生存セッションの矛盾を含む検索エラーが 1 件でもあれば、
+無関係な正常 PID も含めてすべての送信先選択を拒否**します。dry-run・送信・handoff が対象です。
+明示指定で他のプロファイルのエラーを分離できますが、指定先内部の矛盾や検索上限は解消しません。
+従来の単一ディレクトリでの不正な記録の扱いは変更しません。
+選択した記録・受信箱を、他のプロファイルへ再検索せず確認します。通常の Unix ソケット別名は
+維持しますが、既存の任意世代検査の制限も維持します。世代トークンは送信権限や ACK ではありません。
+モデル認証、すべてのファイルシステム競合の排除、受信証明は提供しません。
+他の Orca 構成や任意の設定ディレクトリは自動検索しません。
+
 ### 環境変数
 
 | 変数 | 効果 |

diff --git a/docs/ko/cli-reference.md b/docs/ko/cli-reference.md
@@ -440,6 +440,33 @@ pip/pipx/uv 설치가 아니라 `~/.local/share/session-peer/session_peer.py`만
 로컬 `session-peer update --check` 및 `session-peer update`는 자동 알림에 사용되는
 동일한 캐시도 채웁니다.
 
+### Orca에서 관리하는 Claude 프로필
+
+macOS에서 `CLAUDE_CONFIG_DIR`과 `ANTHROPIC_CONFIG_DIR`을 지정하지 않으면
+`~/.claude/sessions`와 같은 사용자 소유의 알려진 Orca 경로
+`~/Library/Application Support/orca/claude-profiles/*/home/sessions`를 검색합니다.
+환경변수로 지정하면 기존 우선순위와 범위를 유지하며 다른 프로필로 검색을 넓히지 않습니다.
+한 프로필만 확인하려면
+`CLAUDE_CONFIG_DIR="/path/to/profile/home" session-peer list --agent claude --json`을
+사용하세요. 설치 경로는 바뀌지 않습니다.
+
+모든 플랫폼의 기본·명시적 등록 디렉터리 검색에는 전체 항목 4,096개, 등록 파일당
+1 MiB 제한이 적용됩니다. 추가 Orca 프로필 검색만 macOS 전용이며 바로 아래 항목 128개로
+제한합니다. 자동 검색하는 프로필 디렉터리의 심볼릭 링크·재분석 지점·다른 사용자 소유권은
+거부합니다. 검색과 doctor는 인증정보·수신함 키·대화 기록을 읽지 않습니다.
+같은 실제 등록 디렉터리의 별칭은 한 번만 검색합니다. 별도 기록이 같은 살아 있는 PID나
+수신함을 주장하면 공개 메타데이터가 같아도 충돌입니다.
+
+일부 오류가 있어도 정상 목록은 보존하지만, **살아 있는 세션 충돌을 포함한 검색 오류가
+하나라도 있으면 관련 없는 정상 PID도 포함하여 모든 대상 선택을 거부**합니다.
+이는 dry-run·전송·handoff에 모두 적용됩니다. 명시적 디렉터리는 다른 프로필의 오류를
+분리할 수 있지만 선택한 디렉터리 내부 충돌이나 검색 한도를 해결하지는 못합니다.
+기존 단일 디렉터리의 잘못된 기록 처리 방식은 유지합니다.
+선택한 기록·수신함을 다른 프로필로 재검색하지 않고 확인합니다. 일반 Unix 소켓 별칭은
+유지하지만 기존의 선택적 세대 확인 제한도 유지합니다. 세대 토큰은 전송 권한이나 ACK가 아닙니다.
+모델 인증·모든 파일시스템 경쟁 제거·수신 증명을 제공하지 않으며, 다른 Orca 구조나 임의 설정
+경로를 자동 검색하지 않습니다.
+
 ### 환경 변수
 
 | Variable | Effect |

diff --git a/docs/zh-CN/cli-reference.md b/docs/zh-CN/cli-reference.md
@@ -314,6 +314,29 @@ session-peer update --host web-01                 # push this program if version
 
 无论是本地还是远程的 `update` 都不会刷新 Claude 技能。从所需发布版本的检出目录重新运行 `install.sh` 可同时刷新独立程序和技能。本地的 `session-peer update --check` 和 `session-peer update` 也会填充自动通知所使用的相同缓存。
 
+### Orca 管理的 Claude 配置档案
+
+在 macOS 上，未指定 `CLAUDE_CONFIG_DIR` 和 `ANTHROPIC_CONFIG_DIR` 时，搜索包含
+`~/.claude/sessions` 和同一用户拥有的已知 Orca 目录
+`~/Library/Application Support/orca/claude-profiles/*/home/sessions`。
+显式指定目录时保留原有优先级和范围，不扩展到其他档案。只检查一个档案可用
+`CLAUDE_CONFIG_DIR="/path/to/profile/home" session-peer list --agent claude --json`。
+安装路径不变。
+
+所有平台的默认及显式注册目录搜索合计最多 4,096 项，每个注册文件最多 1 MiB。
+只有额外的 Orca 档案枚举为 macOS 专用，最多 128 个直接子项。自动搜索的档案目录
+拒绝符号链接、重解析点及其他用户所有权。搜索和 doctor 不读取凭据、收件箱密钥或对话记录。
+同一实际注册目录的别名只搜索一次。不同记录声称同一存活 PID 或收件箱时，
+即使公开元数据相同也视为冲突。
+
+部分错误时保留正常列表，但**任何搜索错误（包括存活会话冲突）都会拒绝所有目标选择，
+即使目标是无关的正常 PID**。此规则适用于 dry-run、发送和 handoff。
+显式目录可隔离其他档案的错误，但不能修复所选目录内部的冲突或搜索限制。
+保留原有单目录对无效记录的处理方式。核对所选记录和端点时不会重新搜索其他档案。
+保留普通 Unix 套接字别名支持及其既有可选代际检查限制；代际令牌不是发送权限或 ACK。
+这些检查不验证模型身份，不消除所有文件系统竞争，也不证明收件。
+不会自动搜索其他 Orca 布局或任意配置目录。
+
 ### 环境变量
 
 | 变量 | 作用 |