dodo-mcp 1.3.0 → 1.3.2

package/docs/MCP_CONNECTIONS.md

@@ -0,0 +1,238 @@
+# เชื่อม DODO MCP กับ AI platforms
+
+คู่มือสำหรับเจ้าของ DODO ตรวจเอกสารของ client เมื่อ 25 กันยายน 2026
+ชื่อเมนูอาจต่างตามรุ่นและแผนบัญชี คู่มือนี้ไม่ใช่หลักฐานว่าทดสอบกับบัญชีจริงครบทุกค่าย
+
+## เลือกวิธีเชื่อม
+
+| Client | วิธีในคู่มือนี้ | สิ่งที่ต้องเตรียม |
+|---|---|---|
+| ChatGPT web | Public HTTPS + OAuth | DODO/Tunnel ที่เปิดอยู่ และ OAuth client ของ ChatGPT |
+| Claude web / Desktop Custom Connector | Public HTTPS + OAuth | OAuth client ของ Claude แยกต่างหาก |
+| Claude Code | Local STDIO | DODO CLI และ absolute project path |
+| Codex CLI | Local STDIO | DODO CLI และ absolute project path |
+| Gemini CLI | Local STDIO | DODO CLI และ absolute project path |
+| Cursor | Local STDIO | MCP JSON และ absolute project path |
+| VS Code / GitHub Copilot | Local STDIO | MCP JSON และ absolute project path |
+
+Gemini CLI ไม่ใช่ Gemini web; Claude Code ไม่ใช่ Claude Desktop Custom Connector
+และการเพิ่ม API provider ในหน้า DODO ก็เป็นคนละเรื่องกับการให้ AI ภายนอกเรียก MCP
+
+## URL แต่ละตัวใช้ทำอะไร
+
+| ค่า | ตัวอย่าง | ใช้ทำอะไร |
+|---|---|---|
+| Public origin | `https://dodo.example.com` | ตั้งโดเมนใน DODO/Tunnel |
+| Public MCP URL | `https://dodo.example.com/mcp` | ใส่ช่อง MCP Server URL ใน AI |
+| Remote Config | `https://dodo.example.com/config` | เจ้าของตั้งค่า หลังสั่ง `dodo --web` และจับคู่ |
+| Local Config | `http://127.0.0.1:21731/` | เจ้าของตั้งค่าบนเครื่อง ผ่าน private link ใน Terminal |
+| OAuth callback | URL ของ AI client | ลงทะเบียนด้วย `dodo auth add-client` เท่านั้น |
+
+แทนโดเมนตัวอย่างด้วยโดเมนจริง ห้ามนำ `/config`, private link หรือ OAuth callback
+ไปกรอกเป็น MCP Server URL ห้ามวาง Markdown `[ชื่อ](URL)` ในช่อง URI
+
+## เตรียม DODO สำหรับ web clients ครั้งเดียว
+
+1. ติดตั้ง `npm install -g dodo-mcp@latest` แล้วตรวจ `dodo --version`
+2. ตั้ง **Cloudflare Local** หากดูแล cloudflared เอง หรือ **DODO Tunnel** หากให้ DODO
+   ดูแล โดยใช้ public origin จริง ดู [คู่มือ Tunnel](TUNNEL.md)
+3. Tunnel ต้อง route **ทุก path** ของโดเมนไป `http://127.0.0.1:21730`
+   เพื่อให้ OAuth discovery/authorize/token เข้าถึงได้ด้วย ไม่เปิด 21731 หรือ 21732
+4. รัน `dodo start` และเปิดค้างไว้ ถ้ารันอยู่แล้วไม่ต้องเปิดซ้ำ
+5. เพิ่มโปรเจกต์ใน Config พร้อมระดับอ่าน/แก้/รันที่ต้องการ Managed mode ต้องกำหนด
+   client ACL ด้วย ส่วน personal mode ใช้ OAuth scopes ร่วมกับ project access level
+
+รันคำสั่ง auth บนเครื่องและ OS user เดียวกับ server ใช้ `DODO_CONFIG_DIR` เดียวกัน
+ทำจากโฟลเดอร์ใดก็ได้ อย่าสลับ Admin/User บน Windows แล้วคาดว่าจะเป็น installation เดียวกัน
+
+## ChatGPT web
+
+1. เปิด Developer mode ในบัญชี/องค์กรที่มีสิทธิ์ แล้วเปิดหน้าจัดการ MCP app/plugin
+   (ปัจจุบันที่ `https://chatgpt.com/plugins`; บางบัญชียังใช้ Settings → Apps)
+2. ตั้งชื่อ `DODO`, URL เป็น Public MCP URL, Authentication เป็น **OAuth**
+3. สร้าง client บนเครื่อง DODO ด้วยคำสั่งบรรทัดเดียว:
+
+```text
+dodo auth add-client --name "ChatGPT" --redirect-uri "https://chatgpt.com/connector_platform_oauth_redirect"
+```
+
+4. กรอก `client_id` และ `client_secret` ที่ได้ในช่อง OAuth Client ID/Secret
+   ค่านี้แสดงครั้งเดียว ไม่ใช่ API key ของ OpenAI และไม่ต้องส่งเข้าแชต
+5. กด Connect/Scan Tools แล้วทำ [ขั้นตอนอนุมัติ](#อนุมัติการเชื่อมต่อจาก-terminal)
+6. เปิดแชตใหม่ เลือก DODO แล้วทดสอบ overview ก่อนแก้ไฟล์
+
+หากหน้า MCP management แสดง callback เฉพาะ connection ให้ลงทะเบียน **ค่าที่แสดงจริง**
+แทนคำสั่งตัวอย่าง ห้ามใช้ wildcard หรือเดา callback ID
+ดู [OAuth callback และ static client](https://developers.openai.com/plugins/build/auth)
+กับ [ขั้นตอนเชื่อม ChatGPT](https://developers.openai.com/plugins/deploy/connect-chatgpt)
+
+## Claude web / Claude Desktop Custom Connector
+
+สร้าง client แยกจาก ChatGPT:
+
+```text
+dodo auth add-client --name "Claude" --redirect-uri "https://claude.ai/api/mcp/auth_callback"
+```
+
+ใน Claude ไปที่ **Customize → Connectors → + → Add custom connector**
+(Team/Enterprise อาจต้องให้ Owner เพิ่ม connector ขององค์กรก่อน)
+
+| ช่อง | ค่า |
+|---|---|
+| Name | `DODO` |
+| Remote MCP server URL | `https://dodo.example.com/mcp` โดยแทนโดเมนจริง |
+| Authentication | **Sign in now** |
+| OAuth client | **Use your own OAuth client** |
+| OAuth Client ID | `client_id` จากคำสั่ง Claude ด้านบน |
+| OAuth Client Secret | `client_secret` คู่กัน |
+| Request headers | เว้นว่าง |
+
+DODO ใช้ static registration จึงไม่เลือก Register automatically (DCR) หรือ
+Use Claude's published identity (CIMD) กด Add → Connect แล้วอนุมัติใน Terminal
+เปิดแชตและเลือก **+ → Connectors → DODO**
+
+ถ้า Desktop เปิด `claude.ai/login?returnTo=...` แล้วหน้าว่าง ให้ลองเข้า
+`https://claude.ai/` ในเบราว์เซอร์ปกติ ล็อกอินบัญชี/องค์กรเดียวกัน และกด Connect
+จากหน้าเว็บ ไม่ต้องสร้าง credentials ใหม่ ตรวจ browser extensions/cookies ถ้าแม้หน้าแรกก็ว่าง
+ยังไม่ควรสรุปว่า Tunnel เสียจาก URL หน้า login เพียงอย่างเดียว
+
+แหล่งอ้างอิง: [Claude connector setup](https://support.claude.com/en/articles/11175166-get-started-with-custom-connectors-using-remote-mcp),
+[callback และ static credentials](https://claude.com/docs/connectors/building)
+
+## อนุมัติการเชื่อมต่อจาก Terminal
+
+เมื่อ browser เปิดหน้ารออนุมัติของ DODO ให้เปิด Terminal อีกหน้าต่างบนเครื่อง DODO:
+
+```text
+dodo auth pending
+```
+
+ตรวจชื่อ client, callback, scopes และรหัสยืนยันว่าตรงกับการเชื่อมต่อที่เพิ่งเริ่ม แล้วรัน:
+
+```text
+dodo auth approve REQUEST_ID
+```
+
+แทน `REQUEST_ID` ด้วย ID จริง ไม่ใส่ `< >` หรือ `--` นำหน้า
+Browser จะกลับไป AI client เมื่อสำเร็จ ไม่มี pending หมายถึงยังไม่มีคำขอรออนุมัติ
+หากขึ้น no running server ให้ตรวจเครื่อง, OS user, state directory และ server ที่เปิดอยู่
+เก็บ Client Secret ในช่องตั้งค่า client เท่านั้น ไม่ใส่ URL/headers/log/แชต
+
+## Claude Code และ Codex CLI ในเครื่อง
+
+แทน `/absolute/path/to/project` ด้วยโฟลเดอร์จริง และติดตั้ง DODO ให้เรียกจาก PATH ได้
+ให้ AI client เป็นผู้เปิด STDIO subprocess; ไม่ต้องเปิด `dodo start` สำหรับ subprocess นี้
+อย่าเปิดหลาย DODO processes ครอบ root เดียวกัน หาก root ถูกใช้อยู่ให้เลือก HTTP connection
+หรือปิด process เดิมด้วยเจ้าของก่อน
+
+Claude Code:
+
+```text
+claude mcp add --transport stdio --scope user dodo -- dodo stdio --root "/absolute/path/to/project"
+```
+
+ตรวจด้วย `claude mcp list` และ `/mcp` ใน Claude Code
+อ้างอิง [Claude Code MCP](https://code.claude.com/docs/en/mcp)
+
+Codex CLI:
+
+```text
+codex mcp add dodo -- dodo stdio --root "/absolute/path/to/project"
+codex mcp list
+```
+
+อ้างอิง [Codex MCP](https://developers.openai.com/codex/mcp/)
+
+## Gemini CLI และ Cursor
+
+Gemini CLI: เพิ่ม entry นี้ใน **user** `~/.gemini/settings.json` โดยรวมกับค่าเดิม
+อย่าเขียนทับทั้งไฟล์ ส่วน Cursor ใช้ **user** `~/.cursor/mcp.json` รูปแบบเดียวกัน:
+
+```json
+{
+  "mcpServers": {
+    "dodo": {
+      "command": "dodo",
+      "args": ["stdio", "--root", "/absolute/path/to/project"]
+    }
+  }
+}
+```
+
+เปิด client ใหม่ ตรวจ Gemini ด้วย `gemini mcp list` หรือ `/mcp`
+และตรวจ Cursor ที่หน้าจัดการ MCP ของ Settings
+อ้างอิง [Gemini CLI MCP](https://geminicli.com/docs/tools/mcp-server/)
+และ [Cursor MCP](https://cursor.com/docs/mcp)
+
+## VS Code / GitHub Copilot
+
+เปิด Command Palette → **MCP: Open User Configuration** แล้วรวม entry นี้กับ config เดิม:
+
+```json
+{
+  "servers": {
+    "dodo": {
+      "type": "stdio",
+      "command": "dodo",
+      "args": ["stdio", "--root", "/absolute/path/to/project"]
+    }
+  }
+}
+```
+
+ใช้ **MCP: List Servers** เริ่ม server แล้วเลือก tools ใน chat
+อ้างอิง [VS Code MCP](https://code.visualstudio.com/docs/agent-customization/mcp-servers)
+
+### Windows และ GUI ที่หา dodo ไม่พบ
+
+ใช้ path รูปแบบ `C:/Users/YourName/Projects/demo` ใน JSON เพื่อลดปัญหา backslash
+ถ้า client เปิด npm command shim ไม่ได้ ให้ใช้ Node กับ entry point จริง:
+
+1. รัน `where.exe node` และ `npm root -g`
+2. ตั้ง `command` เป็น absolute path ของ `node.exe`
+3. ตั้ง `args` เป็น `["GLOBAL_NPM_ROOT/dodo-mcp/dist/cli/main.js", "stdio", "--root", "C:/path/to/project"]`
+   โดยแทน `GLOBAL_NPM_ROOT` ด้วยผลจริง
+
+macOS/Linux GUI ที่ PATH ต่างจาก Terminal ใช้รูปแบบ Node + absolute entry point ได้เช่นกัน
+Local STDIO ใช้ OS-owner principal; trust/approval, sandbox และ file guards ยังมีผล
+ไม่ได้เปิด anonymous HTTP หรือข้าม OAuth ของ public MCP
+
+## AI platform อื่น
+
+ใช้ remote MCP ได้เมื่อ client รองรับ Streamable HTTP, OAuth code + PKCE S256
+และให้กรอก static Client ID/Secret ได้ คัดลอก callback **จาก client นั้นจริง** แล้วลงทะเบียน:
+
+```text
+dodo auth add-client --name "My AI client" --redirect-uri "EXACT_CALLBACK_FROM_CLIENT"
+```
+
+ตัวอย่าง callback placeholder ไม่ใช่ URL ใช้งานจริง หาก client บังคับ DCR/CIMD
+โดยไม่มี static credentials ให้ตรวจ compatibility ก่อน อย่าแก้ด้วย No sign-in
+หรือใช้ token ของหน้า Config เป็น MCP credential
+
+## ทดสอบและแก้ปัญหา
+
+เริ่มด้วย prompt:
+
+> ใช้ DODO เรียก project_overview แล้วบอกโปรเจกต์ที่ฉันเข้าถึงได้ ยังไม่ต้องแก้ไฟล์
+
+จากนั้นเลือกโปรเจกต์ fixture และทดสอบ create → read → edit → read-back → delete
+ใช้ `dodo_discover` ใน Compact เมื่อหาความสามารถไม่เจอ
+
+| อาการ | ตรวจอะไร |
+|---|---|
+| invalid_client | ใช้ ID/Secret คู่เดียวกัน และ client ยังไม่ถูกลบ |
+| redirect_uri ไม่ตรง | คัดลอก exact callback ของ client ไม่ใช้ callback ข้ามค่าย |
+| ไม่เห็น tools ใหม่ | Refresh/rescan; ถ้ายัง cache เดิมให้สร้าง connection ใหม่ตาม client |
+| WORKSPACE_ACCESS_REQUIRED | เพิ่มโปรเจกต์และตรวจ access level/scopes; managed mode ตรวจ ACL |
+| STALE_WORKSPACE | เรียก project_overview ใหม่หลัง server restart/เปลี่ยน workspace |
+| Remote Config แจ้ง 8 ชั่วโมง | อัปเป็น 1.3.1+, restart เพื่อโหลดแพตช์หนึ่งครั้ง แล้วใช้ dodo --web |
+| `/config` เป็น 404 | lease ปิด/หมดอายุ ให้เจ้าของรัน dodo --web และจับคู่ใหม่ |
+
+ตั้งแต่ 1.3.1 `dodo --web` สร้าง session ของโดเมนแยกจาก Local Config 8 ชั่วโมง
+เปิดใหม่ได้แม้ process ทำงานหลายวัน แต่ละครั้งอยู่ได้ 1 ชั่วโมงและยังต้อง pairing
+การเปิด/ปิด Config ไม่ทำให้ MCP/OAuth/Tunnel หยุด ไม่ต้องต่ออายุหน้าเว็บเพื่อให้ AI ทำงานต่อ
+
+**สถานะตรวจรับ:** server HTTP/OAuth, STDIO และ Config มี automated fixture tests
+ส่วนการล็อกอินและเรียก tools จากบัญชีจริงในแต่ละ AI platform เป็น `MANUAL_NOT_RUN`
+สำหรับแพตช์นี้ ไม่ถือว่ามีคู่มือแล้วเท่ากับผ่าน live integration

package/docs/RECOVERY.md

@@ -1,7 +1,8 @@
 # Recovery: source, deployments and private configuration
 
-This documents the 1.3.0 source candidate. Publication and supported-platform
-results are recorded separately in [release notes](RELEASE_1.3.0.md) and
+This documents Recovery including the 1.3.2 storage-maintenance additions.
+Publication and platform results are recorded separately in
+[release notes](RELEASE_NOTES.md) and
 [the test report](TEST_REPORT.md). Source backup is default-on for registered
 projects; deployment/database/config adapters require separate owner opt-in.
 
@@ -111,7 +112,7 @@ MCP full operations: `checkpoint_list`, `checkpoint_inspect`, `checkpoint_create
 `recovery_session_list`, `recovery_session_inspect`, `recovery_session_begin`,
 `recovery_session_end`, `restore_preview`, `restore_apply`, `restore_status`.
 Use the existing `dodo_read` and `dodo_write` compact gateways and discover schemas.
-Full catalog: 158 capabilities (154 with sub-agents hidden); Compact remains 20.
+Full catalog: 162 capabilities (158 with sub-agents hidden); Compact remains 20.
 Gateway arguments cannot override top-level workspace/project/recovery context.
 
 For several edits belonging to one task, call `recovery_session_begin`, then pass
@@ -200,10 +201,74 @@ refused rather than overwritten. Pins and active names both protect retention.
 Unpinning a named point alone will not delete it. Old/new name changes appear in
 owner history. Naming never rewrites source or the snapshot manifest.
 
-Advanced settings include **ดู preview การล้างตาม retention**. It shows eligible
-points and why others are retained without deleting anything. Shared objects,
-Git copies and orphan grace periods mean the logical byte total is not immediate
-free disk space. This version does not expose a manual destructive purge.
+The **จัดการพื้นที่ Recovery** panel provides reviewed manual cleanup, retention
+cleanup and retry of pending physical cleanup. It reports unique source object
+bytes separately from Git copies and the logical checkpoint total. Checkpoints
+with unchanged content share objects; adding their logical sizes does not measure
+actual disk use. Unchanged objects are freshly verified and reused without writing
+another staging copy. Git copies are separate and can consume additional space.
+
+To manage a project such as `my-project`:
+
+1. Open the private Config link, select the registered project, then Recovery.
+2. Inspect actual source/Git usage and project/installation quotas. A quota refusal
+   can also mean the installation limit or minimum free disk space was reached.
+3. Select old checkpoints, click **ตรวจแผนลบสำเนาที่เลือก**, review the exact IDs
+   and closed sessions, then confirm. This permanently removes those backups and
+   their closed session history, never the current project files.
+4. For future backups, expand **โควตา ระยะเก็บ และโฟลเดอร์ที่ไม่สำรอง**. Increase
+   the project quota or put `models/` on its own exclusion line, review and confirm.
+   Exclusions are literal relative file/directory prefixes, not glob patterns.
+5. Create a checkpoint and inspect its coverage. Old backups still contain the
+   previously included files until separately deleted. Changing settings alone
+   does not certify readiness, acknowledge drift or repair a corrupt backup.
+
+Excluded files are not restorable from future checkpoints. When an operation
+requires a before-image of an excluded file, DODO refuses it rather than silently
+editing without protection. Shell commands can still change excluded data; a
+source checkpoint is not a full machine/data backup or an OS sandbox.
+
+Current/latest source checkpoints, drift baselines, pins, names, active captures,
+open sessions, unfinished work, live restore plans, deployment provenance and
+DB compatibility bindings remain protected. Deleting a closed session requires
+selecting all its checkpoints. Retention cleanup remains subject to the same
+protections. Lowering retention can remove older eligible history at a later
+capture; it is not a guarantee to keep exactly N points.
+
+Cleanup previews expire after 15 minutes and are bound to project, epoch, caller,
+policy and the reviewed selection. Changes to protection/history require a fresh
+preview. File deletion failures retain durable cleanup tasks. **เก็บกวาดไฟล์ค้าง**
+retries those tasks explicitly; shared objects are never removed while referenced
+or while an installation capture is active. Results separate logical deletion,
+source bytes freed, Git bytes freed and pending files. Accounting excludes filesystem
+overhead and temporary staging; it is not a claim about total disk free space.
+
+### AI-assisted storage maintenance
+
+Four Full operations are also available through existing Compact gateways:
+
+| Operation | Gateway | Scope / authority |
+| --- | --- | --- |
+| `recovery_storage_status` | `dodo_read` | Read; caller-owned checkpoint metadata, quota/storage totals, or a plan receipt |
+| `recovery_cleanup_preview` | `dodo_write` | Write; selected IDs, retention, or pending-file cleanup; no deletion |
+| `recovery_settings_preview` | `dodo_write` | Write; project quota, retention and exclusions only; no policy change |
+| `recovery_maintenance_apply` | `dodo_write` | Write plus exact owner approval, including in trusted mode |
+
+Use `project_overview` and `dodo_discover` to obtain current context and schemas.
+For example, `dodo_write` with `operation: "recovery_settings_preview"` and
+`args: {"changes":{"excludePaths":["models/"],"projectBytes":8589934592}}` proposes
+an 8 GiB quota and exclusion. It grants no permission. Review the returned plan,
+then apply with its exact `planId`, `planHash` and an `idempotencyKey` after owner
+approval. Keep project/workspace context at the gateway top level.
+
+An MCP caller can delete only its own checkpoint history; the authenticated owner
+web UI can manage all checkpoints in the selected project. AI cannot unpin points,
+remove names, disable Recovery, change storage destinations, approve its own action,
+relax secret/path guards or accept corruption as a new baseline. Approved plan
+retries return a durable receipt. Query `recovery_storage_status` with `planId`
+after an uncertain response; never silently repeat destructive operations.
+A crash after logical deletion may leave physical cleanup pending; review pending
+cleanup explicitly. Recovery maintenance never reruns a failed source command.
 
 Owner CLI, in the registered project's directory:
 
@@ -218,7 +283,7 @@ dodo recovery mark stable SNAPSHOT_ID --revision REVIEWED_REVISION --workspace W
 
 After browser reconnect, refresh evidence and query the existing restore receipt.
 Do not repeat uncertain effects. These are private owner controls; MCP/public
-HTTP has no mark/pin/purge endpoint. Without an owner-registered deployment target its state is **NOT_CONFIGURED**;
+HTTP has no public owner mark/pin/admin endpoint; reviewed MCP maintenance remains caller-bound and owner-approved. Without an owner-registered deployment target its state is **NOT_CONFIGURED**;
 database row rollback remains **NOT_SUPPORTED**. Optional adapters are described below. Windows/Android and live
 production recovery require their own acceptance; results from macOS/Linux
 fixtures are not substitutes.

package/docs/RELEASE_1.3.1.md

@@ -0,0 +1,49 @@
+# DODO MCP 1.3.1
+
+## Remote Config opens independently of the local link
+
+Previously, a DODO process running for over eight hours could accept a new
+`dodo --web` pairing but return the Local Config expiry error when loading data.
+The domain dashboard now uses its own revocable owner session, valid for one hour
+from the CLI opening. Reopen it at any process age without restarting MCP.
+
+- Local Config's eight-hour link stays separate and is not renewed by remote use.
+- New pairing revokes the previous remote session. Close/expiry also revokes its
+  internal loopback capability, including owner requests still waiting for execution.
+- AI/Projects owner principals and event streams use the request's actual session.
+- One-time pairing, Secure/HttpOnly/SameSite cookies, Host/Origin checks, rate limits,
+  workspace/epoch validation, MCP OAuth and all tool permissions remain enforced.
+- The CLI and pairing page explain how to reopen without a server restart.
+
+## Connection guides
+
+[MCP connections](MCP_CONNECTIONS.md) covers ChatGPT, Claude Custom Connectors,
+Claude Code, Codex CLI, Gemini CLI, Cursor and VS Code. It distinguishes `/mcp`,
+`/config`, OAuth callbacks, static credentials, local STDIO and AI provider keys.
+Claude's form has explicit Sign in now / Use your own OAuth client instructions.
+The guide ships in the npm package and is linked near the top of the README.
+
+## Upgrade
+
+```text
+npm install -g dodo-mcp@1.3.1
+dodo --version
+```
+
+Stop/start the existing foreground DODO process once to load the updated code.
+After that, opening Remote Config needs only `dodo --web`, even after eight hours.
+Enter the new terminal pairing code at the printed domain `/config` URL.
+This patch does not require deleting OAuth clients or copying private state.
+
+## Verification scope
+
+Regression tests cover a nine-hour-old process, local expiry, remote renewal,
+settings writes, AI project access, cookie/code replay rejection, in-flight owner
+revocation and real Chromium desktop/mobile dashboards. Full automated gates and
+fresh-package results are recorded in the release evidence; native platforms must
+pass on this source revision before publication.
+
+External AI account logins, real Cloudflare routes and a physical eight-hour wait
+are `MANUAL_NOT_RUN` for this patch. The automated clock/HTTP/browser fixtures do
+not claim to prove those live integrations. This patch does not change Windows
+dependency installers or repair private state created by another OS account.

package/docs/RELEASE_1.3.2.md

@@ -0,0 +1,50 @@
+# DODO MCP 1.3.2
+
+## Recovery storage management
+
+The project Recovery dashboard can now preview and confirm deletion of old
+checkpoints, retry pending file cleanup, change project quotas/retention, and exclude
+relative paths such as `models/` from future backups. It distinguishes logical
+checkpoint totals from unique source objects and separate Git copies. Verified
+unchanged objects are reused without another staging copy.
+
+Protected/current baselines, pinned/named points and referenced recovery history
+remain protected. Cleanup never edits project source. Unlink failures remain pending,
+and live capture reservations prevent deletion of objects another project is using.
+Changing exclusions does not delete older backups or acknowledge source drift.
+
+Four operations are available through existing Compact read/write gateways:
+`recovery_storage_status`, `recovery_cleanup_preview`, `recovery_settings_preview`
+and `recovery_maintenance_apply`. AI apply requires exact owner approval even in
+trusted mode. OAuth, ACL, caller ownership, workspace/epoch, path guards and
+idempotency remain authoritative. Full has 162 definitions (158 by default);
+Compact stays at 20.
+
+## Upgrade
+
+```sh
+npm install -g dodo-mcp@1.3.2
+dodo --version
+```
+
+Restart your foreground DODO process once to load the update, reopen Config, and
+select the project → Recovery → จัดการพื้นที่ Recovery. Refresh/rescan the MCP
+connection so its gateway operation schemas include the new capabilities.
+
+Private state gains maintenance review and cleanup-task tables on first open;
+existing backup data and access scopes are preserved. Keep CLI/server versions
+aligned: older DODO versions refuse a state database with newer migrations.
+See the [Recovery guide](RECOVERY.md) for the review/confirmation flow and
+limits on excluded files, retention and shared storage.
+
+## Verification
+
+AUTOMATED_PASS on macOS: build, typecheck, lint, core 926 passed / 40 skipped /
+0 failed; packaging 17 passed, including an installed CLI approval and Compact
+maintenance flow. Real Chromium exercised desktop and 390px screens. Production
+dependency audit reported zero vulnerabilities.
+
+Native Linux/Windows CI, live AI clients and production checkpoint cleanup are
+MANUAL_NOT_RUN for this patch. The owner explicitly chose publication with the
+completed macOS checks and deferred the remaining platform tests to the next release.
+No production process, tunnel or backup history was changed by release validation.

package/docs/RELEASE_NOTES.md

@@ -1,5 +1,23 @@
 # DODO MCP — Release Notes
 
+## 1.3.2 — Recovery storage management
+
+Adds owner-reviewed checkpoint cleanup, pending-file retry, project quotas and
+explicit exclusions in the web dashboard. Four caller-bound MCP maintenance
+operations use existing Compact gateways; destructive/settings apply still needs
+owner approval. Shows unique source objects separately from Git copies and logical
+checkpoint sizes. Reuses verified unchanged CAS objects without restaging them.
+See [Recovery usage](RECOVERY.md), [upgrade details](RELEASE_1.3.2.md) and [validation results](TEST_REPORT.md).
+This patch uses the completed macOS gate; native Linux/Windows CI is explicitly deferred to the next release.
+
+## 1.3.1 — Independent Remote Config sessions
+
+`dodo --web` now creates an independent one-hour owner session even after the local
+eight-hour link expires. No MCP restart is needed to reopen the domain dashboard.
+AI owner requests and queued actions use the same remote session deadline and
+revocation. Adds [AI platform connection instructions](MCP_CONNECTIONS.md) and
+[upgrade details](RELEASE_1.3.1.md).
+
 ## 1.3.0 — Recovery & Local Git Safety
 
 - Default-on independent source backups for registered projects, with caller-owned

package/docs/SECURITY.md

@@ -453,3 +453,31 @@ UNKNOWN receipt. A crash may leave partial bytes; it never silently retries or
 restarts services. Owner/context/content checks and same-user filesystem race
 limits apply. Key rotation retains old references; retention protects referenced
 backups and does not promise physical secure erasure. See [ADR 056](adr/056-owner-data-recovery.md).
+
+## Config session isolation (1.3.1)
+
+Local Config retains its eight-hour process capability. Each owner CLI opening of
+Remote Config creates a distinct, random internal capability bounded by that
+one-hour lease. It never renews or reuses the local browser token. Closing, expiry
+or reopening revokes the old remote capability and cookie. No credential is sent
+in a remote URL or returned by state APIs. AI owner principals, streaming requests
+and queued owner revalidation use the authenticated request session, not the
+server start time. Loopback, Host/Origin, proxy-header rejection, rate limits,
+workspace/epoch checks and public MCP OAuth remain enforced.
+
+### Reviewed Recovery maintenance
+
+Storage status and previews are bounded and reveal no credentials or private backup
+paths. MCP checkpoint access remains caller-owned and workspace-bound. Cleanup/settings
+apply requires `dodo:write`, live ACL/context and a separate exact owner approval even
+in trusted mode. A review or discover result does not authorize apply. Settings are
+limited to project quota, retention and canonical relative exclusions; they cannot
+turn off Recovery, acknowledge drift or change private storage/installation authority.
+
+The private owner dashboard requires its authenticated, expiring session and current
+workspace context for confirmed apply. Public MCP has no administration endpoints.
+Cleanup protects current baselines, pins, names and active references, and never edits
+source files. Pending cleanup only processes stored private references, not paths
+supplied by callers. Shared objects and active installation captures block reclamation;
+I/O failure is reported as pending rather than successful deletion. No integrity
+failure is silently repaired by accepting the current source.

package/docs/TEST_REPORT.md

@@ -1,5 +1,45 @@
 # DODO MCP — Test Report
 
+## 1.3.2 Recovery maintenance — macOS release gate, 2026-09-25
+
+`AUTOMATED_PASS` on macOS: build, typecheck and lint; full core suite **926 passed,
+40 skipped, 0 failed** across 145 files (140 passed, 5 skipped). Packaging **17
+passed**, including fresh tarball install and real Compact MCP calls that request
+owner approval, approve via the installed CLI, clean a checkpoint, set an exclusion
+and read the resulting policy. `npm run test:all` exited 0; the extended packaging
+smoke, typecheck and lint were rerun successfully afterward.
+
+The 13 new security/integration cases cover CAS reuse with integrity checking,
+logical versus unique storage, actual reclamation including independent Git copies,
+protected/current checkpoints, caller ownership, partial closed sessions, read-only
+OAuth refusal, stale context, nested override, live ACL revocation, exact approvals,
+receipt replay, explicit exclusions, pending unlink retry, cross-project sharing,
+active reservations, unsafe hardlinks and queued authority changes. Existing migration
+fixtures retain assertions for scope/revocation preservation across old schemas.
+
+Real Chromium exercised the owner UI on desktop and 390px screens with private
+fixtures, confirming checkpoint deletion and `models/` policy persistence. CSP was
+kept unchanged. Tarball checks include the new UI/service and exclude private state,
+credentials, development documents and release evidence. Complete Full capability
+count is **162**, default Full **158**, Compact **20**, Hybrid **49**.
+
+`MANUAL_NOT_RUN`: production checkpoint cleanup, actual AI-client interaction, and
+native Linux/Windows CI for this change. The owner explicitly accepted the completed
+macOS gate and deferred the remaining platform tests to the next release. No production
+server was restarted. Automated fixture approval is not approval for production.
+
+## 1.3.1 Config regression coverage
+
+`tests/security/remoteConfig.test.ts` reproduces the previous HTTP 401 after advancing
+the server clock nine hours, then verifies an independent CLI-created session,
+AI owner expiry, settings writes, renewal and queued-request revocation.
+`tests/security/localConfig.test.ts` checks distinct capabilities, local expiry,
+remote revocation and Host/Origin/proxy-header enforcement.
+`tests/integration/remoteConfigUi.test.ts` exercises desktop/mobile Chromium after
+local expiry and re-pairs after closing without restarting the fixture process.
+External AI clients and real Cloudflare remain MANUAL_NOT_RUN; the connection guide
+is based on client documentation and is not a live platform certification.
+
 ## 1.3.0 Recovery — หลักฐานก่อน final platform gate
 
 Windows full [run35510440500](https://github.com/arthittakun/dodo-mcp/actions/runs/35510440500)

package/docs/TUNNEL.md

@@ -143,6 +143,12 @@ query/fragment secret Pairing code มีอายุสั้นและใช
 cookie แบบ `Secure`, `HttpOnly`, `SameSite=Strict`, `Path=/config` Lease ปิดเองภายใน
 หนึ่งชั่วโมง การเปิดใหม่ยกเลิก code/session เดิม
 
+ตั้งแต่ 1.3.1 session ของ Remote Config แยกจาก Local Config 8 ชั่วโมงโดยสมบูรณ์
+รัน `dodo --web` หลัง DODO เปิดเกิน 8 ชั่วโมงได้ทันที ไม่ต้อง restart หรือเปิด Local link
+ก่อน การเปิดรอบใหม่ไม่ต่ออายุ Local link เดิม และไม่เปลี่ยน workspace epoch
+AI/Projects, streaming และ owner action ที่รอคิวใช้ session ของคำขอนั้นจริง
+ดู [วิธีเชื่อม AI clients](MCP_CONNECTIONS.md) สำหรับ MCP URL กับ OAuth callback
+
 Remote Config proxy ไปยัง Local Config loopback โดยคง Host/Origin/proxy-header checks,
 private capability, rate limit, workspace ID/epoch และ owner policy เดิม การปิด lease
 ไม่หยุด MCP หรือ Tunnel และไม่มี MCP tool สำหรับเปิดหน้า owner นี้

package/docs/WEB_CLIENTS.md

@@ -1,5 +1,8 @@
 # DODO MCP — เชื่อม ChatGPT และ Web Clients
 
+ดู [คู่มือทุก AI platform](MCP_CONNECTIONS.md) สำหรับ Claude พร้อมตัวเลือก
+Sign in now / Use your own OAuth client และตัวอย่าง Claude Code, Codex, Gemini CLI, Cursor, VS Code
+
 ## สิ่งที่ต้องแยกให้ออกก่อน
 
 | ค่า | ใช้ตรงไหน | ตัวอย่าง |

package/docs/adr/047-temporary-remote-config.md

@@ -45,3 +45,14 @@ expiry still affects only Remote Config; MCP, OAuth and Tunnel continue running.
 - `tests/security/remoteConfig.test.ts`
 - `tests/integration/remoteConfigUi.test.ts`
 - `tests/integration/cli.test.ts`
+
+## 1.3.1 — independent owner sessions
+
+The original bridge reused the eight-hour Local Config capability. After eight
+hours a fresh one-hour CLI lease could pair but all upstream API calls failed.
+The bridge now obtains a separate capability with exactly its own lease deadline
+through the in-process Local Config handle. Reopening revokes the old capability;
+local browser expiry is unchanged. Request-bound session validation also governs
+AI owner principals, event streams and queued owner actions. The one-hour public
+lease and one-time pairing remain mandatory. Both owner-managed Cloudflare Local
+and DODO-managed Tunnel modes can open this lease. No server restart is needed.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dodo-mcp",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "author": "Arthittakun",
   "description": "DODO — local-first MCP server with multi-project coding, AI providers, sub-agents, context, memory, media and workflow tools; embedded OAuth and workspace permissions.",
   "type": "module",
@@ -52,11 +52,14 @@
     "docs/RELEASE_1.2.0.md",
     "docs/RELEASE_1.2.1.md",
     "docs/RELEASE_1.3.0.md",
+    "docs/RELEASE_1.3.1.md",
+    "docs/RELEASE_1.3.2.md",
     "docs/RELEASE_NOTES.md",
     "docs/SCHEDULES.md",
     "docs/SECURITY.md",
     "docs/TEST_REPORT.md",
     "docs/TUNNEL.md",
+    "docs/MCP_CONNECTIONS.md",
     "docs/WEB_CLIENTS.md",
     "docs/WINDOWS.md",
     "docs/WINDOWS_SETUP.md",