dodo-mcp 1.0.6 → 1.2.0

package/docs/ARCHITECTURE.md

@@ -33,6 +33,7 @@ HTTP MCP 127.0.0.1:21730 ──► surface registry ──► policy/invocation
                                       ├─ changes and jobs
                                       ├─ Git/intelligence/LSP
                                       ├─ assistance/multimodal/workflow
+                                      ├─ Android ADB ──► exact-device view/control policy
                                       ├─ Context Engine ──► evidence + L0–L6 cache
                                       ├─ Memory ──► reviewed evidence + stale lifecycle
                                       ├─ Runtime Intelligence ──► durable tasks + bounded evidence
@@ -260,9 +261,9 @@ gateways Report ผูก revision, dataset, dependency lock, config และ h
 
 ## Tool surfaces
 
-- Complete capability catalog 125 individual definitions (Core 104 + Advanced Agent Runtime 17 + Sub-agents 4)
-- Full live catalog ค่าเริ่มต้น 121 definitions; owner เปิด Sub-agent MCP exposure แล้วเป็น 125
-- Compact catalog 19 definitions: overview, discover และ gateways
+- Complete capability catalog 138 individual definitions (Core 104 + Advanced Agent Runtime 17 + Sub-agents 4 + Android ADB 13)
+- Full live catalog ค่าเริ่มต้น 134 definitions; owner เปิด Sub-agent MCP exposure แล้วเป็น 138
+- Compact catalog 20 definitions: overview, discover และ gateways รวม `dodo_mobile`
 - Hybrid catalog 49 definitions: compact core ตามด้วย direct tools
 
 `schemas/tools.json` เป็น complete full schema ส่วน compact และ hybrid เป็น schema แยก
@@ -306,7 +307,14 @@ loopback metrics port และ bounded restart count Token ถูก resolve
 store หรือ owner-controlled env/private-file reference เมื่อเริ่ม process และส่งผ่าน
 child environment โดยไม่เข้า argv
 
-managed supervisor เป็น foreground process มี state machine `starting → connecting → connected/backoff → stopped/failed`, private bounded/redacted log และ authenticated singleton IPC `status/logs/stop` การ stop อ้างอิง live `ChildProcess` ที่ supervisor ถืออยู่เท่านั้น Local mode ไม่ spawn process และ `doctor` ตรวจ local/public health โดยไม่จัดการ Cloudflare account หรือ DNS
+การเชื่อมต่อมีสามโหมด: `local` เป็น loopback-only, `external` ใช้ public origin แต่
+เจ้าของเป็นผู้รัน `cloudflared`, และ `tunnel` ให้ DODO เป็นเจ้าของ child process
+เฉพาะ managed supervisor ของ `tunnel` มี state machine
+`starting → connecting → connected/backoff → stopped/failed`, private
+bounded/redacted log และ authenticated singleton IPC `status/logs/stop` การ stop
+อ้างอิง live `ChildProcess` ที่ supervisor ถืออยู่เท่านั้น `local` และ `external`
+ไม่ spawn process ส่วน `doctor` ตรวจ local/public health โดยไม่จัดการ Cloudflare
+account หรือ DNS
 
 `TunnelRuntime` ผูก supervisor หนึ่งตัวกับ DODO HTTP process และยอมเริ่มเฉพาะเมื่อ
 saved mode เป็น Tunnel พร้อม credential reference Runtime ส่งค่าผ่าน `TUNNEL_TOKEN`
@@ -318,9 +326,10 @@ Remote Config ไม่เปลี่ยน bind ของ Local Config แล
 app `RemoteConfigGateway` ถือ pairing/session digest กับ expiry ใน memory, proxy เฉพาะ
 `/config`, `/config/assets/*`, `/config/api/*` และส่ง request ไป loopback owner server
 ด้วย internal capability เดิม CLI เปิด/ต่ออายุผ่าน authenticated installation IPC
-เฉพาะเมื่อ persistent Tunnel mode ทำงานอยู่ IPC ไม่รับ credential หรือสลับ connection
-mode การหมดอายุล้าง code/session และทำให้ namespace กลับเป็น 404 โดยไม่หยุด
-MCP/OAuth/Tunnel
+เมื่อ process ใช้ public mode (`external` หรือ `tunnel`) ใน `external` เจ้าของต้อง
+ดูแล public route เอง ส่วน `tunnel` ต้องมี DODO-owned supervisor ที่กำลังทำงาน IPC
+ไม่รับ credential หรือสลับ connection mode การหมดอายุล้าง code/session และทำให้
+namespace กลับเป็น 404 โดยไม่หยุด MCP/OAuth/Cloudflare process
 
 ## Optional services
 

package/docs/AUTH.md

@@ -2,6 +2,12 @@
 
 ## MCP OAuth
 
+> **Simple Project Access Policy** — นอกจาก OAuth scopes และ client ACL แล้ว โปรเจกต์
+> ที่ลงทะเบียนแต่ละตัวมีระดับของตัวเอง (`read`/`edit`/`full`) ที่เป็นเพดานเพิ่มอีกชั้น
+> สิทธิ์จริง = token scopes ∩ grant scopes ∩ (personal ? grant : client ACL) ∩ ระดับโปรเจกต์
+> ระดับนี้บีบได้อย่างเดียว ไม่เคยขยาย และไม่แทนที่ OAuth ดู
+> [docs/PROJECTS.md](PROJECTS.md)
+
 MCP HTTP ใช้ OAuth 2.1 authorization code + PKCE S256:
 
 1. client discover protected resource metadata

package/docs/COMPATIBILITY.md

@@ -8,11 +8,12 @@
 | macOS | รองรับ coding, HTTP, STDIO, Local Config และ optional native integrations ตาม permission |
 | Linux | รองรับ coding, HTTP, STDIO, Local Config และ optional integrations ตาม desktop/runtime environment |
 | Windows | Deferred — มี candidate code/tests แต่ยังไม่ประกาศ native support จนกว่าจะผ่าน Windows 11 จริง |
-| Android / Termux | Experimental — core CLI และ text/code MCP เริ่มได้โดยไม่บังคับ Sharp; optional integrations ต้องตรวจแยก |
+| Android / ADB | ควบคุม physical device/emulator จาก macOS/Linux/Windows/Termux ได้เมื่อ Platform-Tools พร้อมและเจ้าของอนุญาต exact serial |
+| Android / Termux host | Experimental — core CLI และ text/code MCP เริ่มได้โดยไม่บังคับ Sharp; optional integrations ต้องตรวจแยก |
 | MCP HTTP | OAuth protected MCP endpoint ที่ `/mcp` |
 | MCP STDIO | Full surface เป็นค่าเริ่มต้น |
 | Local Config | loopback owner control ที่ 21731; เปิด bounded Remote Config `/config` ผ่าน 21730 ได้ครั้งละไม่เกิน 1 ชั่วโมง |
-| Cloudflare Tunnel | เลือก persistent `local` หรือ DODO-owned `tunnel`; credential อยู่ใน OS store/reference และ child `cloudflared` หยุดพร้อม DODO |
+| Cloudflare | เลือก persistent `local` (loopback), `external` (Cloudflare Local ที่เจ้าของรันเอง) หรือ `tunnel` (DODO ดูแล process); credential ใช้เฉพาะ `tunnel` และอยู่ใน OS store/reference |
 | Package | `dodo-mcp` |
 | CLI | `dodo` |
 
@@ -27,13 +28,13 @@ Effectful tools และ jobs ยังทำงานใน active workspace
 
 ## Tool surfaces
 
-- HTTP default: Compact 19 tools
-- STDIO default: Full 121 tools; เปิด Sub-agent MCP exposure แล้วเป็น 125
+- HTTP default: Compact 20 tools
+- STDIO default: Full 134 tools; เปิด Sub-agent MCP exposure แล้วเป็น 138
 - explicit Hybrid: 49 tools
 
-Complete capability schema มี 125 operations ค่าเริ่มต้น `exposeSubagentsToMcp=false`
+Complete capability schema มี 138 operations ค่าเริ่มต้น `exposeSubagentsToMcp=false`
 ซ่อน `subagent_spawn/status/result/control` จาก MCP เท่านั้น หน้าเว็บ Chat & Tasks ยัง
-ใช้ได้ Compact/Hybrid คงจำนวน 19/49 tool names แต่กรอง operation enum, instructions
+ใช้ได้ Compact/Hybrid คงจำนวน 20/49 tool names แต่กรอง operation enum, instructions
 และ discover index ให้ตรงกับ live runtime หลังเปลี่ยนค่าต้อง restart และให้ client
 โหลด catalog ใหม่
 - explicit override: `--tools compact|full|hybrid`
@@ -55,6 +56,11 @@ Advanced Agent Runtime ใช้ SQLite และ invocation pipeline เดิ
 exec ต้องใช้ explicit argv และ executable ที่ JobManager รองรับ ส่วน browser/desktop/
 media/workflow ขึ้นกับ optional capability ของ platform เช่นเดิม
 
+Android ADB family มี 13 operations ใน Full และรวมอยู่ใน `dodo_mobile` ของ Compact
+owner ต้องอนุญาต exact serial แบบ view/control ผ่าน Local Config หรือ `dodo android`
+ก่อน Pair/connect/root และ ADB server management ไม่อยู่ใน MCP catalog ส่วน install/push
+ใช้ expected SHA-256 และ private staging ตาม shared workspace guards
+
 ## Optional capabilities
 
 Desktop, browser, media, speech, LSP และ OS sandbox ต้องตรวจ dependency และ OS permission ด้วย `dodo setup --check` หรือ `dodo doctor` ระบบจะรายงาน `NOT_SUPPORTED` เมื่อ environment ยังไม่พร้อม และจะไม่เปิด permission หรือดาวน์โหลด model โดยอัตโนมัติ
@@ -69,7 +75,8 @@ desktop และ browser ยังไม่ถือว่ารองรับ
 
 `dodo setup --components cloudflared` ตรวจ executable ได้ทุก OS การติดตั้งอัตโนมัติ
 รองรับ Homebrew บน macOS ส่วน Linux/Windows ใช้ signed official package ที่เจ้าของติดตั้งเอง
-โหมด Tunnel ต้องมี public origin และ credential reference ที่ผ่านการตรวจแล้ว ค่า
+โหมด Cloudflare Local ต้องมี public origin แต่ไม่รับ credential และไม่ supervise
+`cloudflared` โหมด DODO Tunnel ต้องมี public origin และ credential reference ที่ผ่านการตรวจแล้ว ค่า
 `--os-credential` ใช้ macOS Keychain, Windows Credential Manager หรือ Linux Secret
 Service ส่วน env/file references มีไว้สำหรับ owner-controlled headless environment
 

package/docs/MANUAL_ACCEPTANCE.md

@@ -2,6 +2,10 @@
 
 ผล manual ต้องบันทึกเป็น `MANUAL_PASS` หรือ `MANUAL_NOT_RUN` พร้อมวันเวลาและ environment ห้ามเดาผลจาก automated test
 
+สถานะ release 1.2.0: UI/authority/connection-mode fixtures ผ่านอัตโนมัติ แต่การใช้
+**Cloudflare Local** และ **DODO Tunnel** ผ่าน public hostname จริงยัง
+`MANUAL_NOT_RUN` จนกว่าเจ้าของจะทดสอบด้วย Tunnel/DNS/credential จริง
+
 สถานะล่าสุดของ owner-state setup/import gate: `MANUAL_NOT_RUN` (2026-09-14) ชุด automated ใช้ fixture แยกและไม่แตะ config/OAuth/tunnel ของผู้ใช้
 
 สถานะ live Cloudflare connection smoke ของรุ่น 1.0.2: `MANUAL_PASS` (2026-09-15) บน
@@ -26,18 +30,19 @@ connection smoke เดิมไม่ได้อ้างว่า AI client
 10. ตรวจ `dodo tunnel doctor` แยก local/public health และไม่กล่าวว่า AI client connected
 11. ตรวจ process list ว่า argv ไม่มี token และ `dodo tunnel logs`/audit/config ไม่มี token
 12. ทดสอบ OAuth + MCP ผ่าน public origin แล้วหยุด DODO; ยืนยัน owned child หยุดตาม
-13. เปิด Local Config เลือก Local แล้ว restart; ตรวจว่าไม่เริ่ม cloudflared และ Active MCP URL เป็น loopback
-14. เลือก Tunnel ผ่าน Local Config พร้อม write-only token แล้ว restart; ตรวจว่าช่องไม่ถูกเติมกลับและ endpoint เป็น public
-15. บันทึก macOS และ Linux Docker แยก environment; Windows manual result แยกตามเครื่องจริง
+13. เปิด Local Config เลือก **เฉพาะเครื่อง (Loopback)** แล้ว restart; ตรวจว่าไม่เริ่ม cloudflared และ Active MCP URL เป็น loopback
+14. เลือก **Cloudflare Local (ติดตั้งในเครื่อง)** พร้อม public origin; ตรวจว่าช่อง token ถูกปิด, DODO ไม่เริ่ม/หยุด cloudflared และ endpoint เป็น public หลัง restart
+15. เลือก **DODO Tunnel** พร้อม write-only token แล้ว restart; ตรวจว่าช่องไม่ถูกเติมกลับและ endpoint เป็น public
+16. บันทึก macOS และ Linux Docker แยก environment; Windows manual result แยกตามเครื่องจริง
 
-## Remote Config ผ่าน Tunnel
+## Remote Config ผ่าน Cloudflare
 
 Automated Chromium fixture ผ่านแล้วทั้ง 1440×900 และ 390×844 โดยใช้ isolated
 loopback public-origin fixture: จับคู่, dashboard/assets/API, workspace-bound mutation,
 หมดอายุและปิดเป็น 404 ทำงานจริง การตรวจผ่าน public Cloudflare hostname จริงยัง
 `MANUAL_NOT_RUN`
 
-1. เลือก Tunnel แบบ persistent และรัน DODO จน `dodo tunnel status` รายงาน connected
+1. ทดสอบสองรอบ: (ก) Cloudflare Local โดยเจ้าของรัน tunnel เอง และ (ข) DODO Tunnel จน `dodo tunnel status` รายงาน connected
 2. จาก terminal อื่นรัน `dodo --web`; คำสั่งต้องไม่ถามหรือส่ง Tunnel token ผ่าน IPC
 3. ตรวจว่า process ไม่ restart และ MCP/OAuth/workspace epoch เดิมไม่เปลี่ยน
 4. เปิด URL `/config` จากอีกอุปกรณ์ ตรวจว่า URL ไม่มี query/fragment secret
@@ -47,7 +52,7 @@ loopback public-origin fixture: จับคู่, dashboard/assets/API, worksp
 8. รัน `dodo --web` อีกครั้ง ตรวจ session เดิมถูกยกเลิกและได้ code ใหม่
 9. รัน `dodo web --close` ตรวจ `/config`, assets และ API เป็น 404 แต่ `/healthz`, OAuth และ `/mcp` ยังอยู่
 10. เปิดใหม่แล้วรอ 1 ชั่วโมง ตรวจ namespace ปิดเองโดยไม่หยุด MCP/Tunnel
-11. เปลี่ยน persistent mode เป็น Local แล้ว restart; `dodo --web` ต้องถูกปฏิเสธและไม่เริ่ม Tunnel เอง
+11. เปลี่ยน persistent mode เป็นเฉพาะเครื่อง (Loopback) แล้ว restart; `dodo --web` ต้องถูกปฏิเสธและไม่เริ่ม Tunnel เอง
 12. ตรวจ config, audit, tunnel log, browser local/session storage และ process argv ว่าไม่มี Tunnel token, pairing code หรือ session token
 
 ## Setup foundation
@@ -88,6 +93,17 @@ loopback public-origin fixture: จับคู่, dashboard/assets/API, worksp
 
 ## Local Config
 
+0b. โปรเจกต์และระดับการเข้าถึง (2026-09-16) — **MANUAL_NOT_RUN**:
+   บนเครื่อง Windows จริงที่ใช้ tunnel จริง ให้ตรวจว่า
+   (ก) เพิ่มโปรเจกต์จากหน้า Projects ด้วย path + ชื่อ + ระดับเดียว แล้วใช้งานได้ทันที
+       โดยไม่ต้องตั้ง client ACL/trust เพิ่ม
+   (ข) สั่ง AI ว่า "ใช้ DODO แก้โปรเจกต์ auto-upload" แล้ว AI resolve ชื่อได้เอง
+       และแก้ไฟล์ในโปรเจกต์ที่ถูกต้อง
+   (ค) ตั้งระดับเป็น `read` แล้วคำสั่งเขียน/รันถูกปฏิเสธจริง
+   (ง) แถบสถานะ Tunnel ไม่กระพริบระหว่างใช้งานต่อเนื่อง และ `dodo tunnel status`
+       แสดง phase/`lastReadyAt` ที่สอดคล้องกับความเป็นจริง
+   (จ) banner ตอน start ไม่พูดถึง ACL เมื่ออยู่ในโหมดส่วนตัว
+
 0. UI ใหม่ (2026-09-14): ตรวจบนเครื่องจริงว่า (ก) nav 8 หน้าใช้ได้ทั้ง desktop และมือถือ
    (ข) tooltip `?` เปิดด้วยการแตะบนอุปกรณ์ touch จริงและ screen reader อ่านได้
    (ค) กล่องยืนยัน SweetAlert แสดงก่อนการลบ/ยกเลิก/เปลี่ยนโหมดทุกครั้ง
@@ -301,6 +317,24 @@ Automated catalog/API/Chromium/fresh-package fixtures: **AUTOMATED_PASS**
 
 เพิ่ม MCP connection ใน client ที่ต้องการ ใช้ OAuth, scan tools และบันทึกจำนวน tools ที่ client แสดงจริง หาก catalog ถูก cache ให้ recreate connection ตาม client instructions
 
+## Android / ADB
+
+ใช้ fixture device/emulator ที่ไม่มีข้อมูลเจ้าของ แล้วบันทึก serial แบบ redact เมื่อเผยแพร่:
+
+1. ตรวจ `dodo setup --check --components adb` และ `dodo android devices`
+2. เปิด view ชั่วคราวให้ exact serial แล้วทดสอบ info, capture, UI, logcat, packages และ bounded file read
+3. ยืนยันว่า serial อื่นและ read-only OAuth token เข้าไม่ได้
+4. เปิด control แล้วทดสอบ tap/key/app launch บน fixture app โดย capture ใหม่หลังทุก action
+5. สร้าง APK/file fixture ใน workspace อ่าน SHA-256 แล้วทดสอบ install/push
+6. เปลี่ยน source หลังอ่าน hash และตรวจว่า `FILE_CHANGED` เกิดก่อน ADB effect
+7. ทดสอบ advanced device-side shell กับ harmless `echo` และยืนยันว่า pair/connect/root ถูกปฏิเสธ
+8. ถอนสิทธิ์ระหว่าง session แล้วตรวจ action ถัดไปถูกปฏิเสธ
+9. ตรวจ Local Config ที่ desktop และ 390px รวม keyboard/focus/error state
+10. ลบ fixture app/file และรัน `dodo android disable`
+
+Physical Android device/emulator: **MANUAL_NOT_RUN** จนกว่าจะทำรายการนี้บน hardware
+หรือ emulator จริง Automated FakeAdb ไม่เปลี่ยนสถานะ manual gate
+
 ## DodoBench และ release gate
 
 Automated fixtures: รัน `npm run bench`, `npm run release:gate` บน macOS และ

package/docs/PROJECTS.md

@@ -7,13 +7,84 @@ project ID แบบ opaque และคงที่เพื่ออ้าง
 ## คำสั่ง
 
 ```bash
-dodo project add /absolute/path/to/project
-dodo project add /absolute/path/to/project --name "Web application"
+dodo project add /absolute/path/to/project --name "auto-upload" --access full
+dodo project add "C:\\Users\\User\\Desktop\\auto-upload" --name "auto-upload" --access edit
+dodo project access "auto-upload" --mode edit
 dodo project list
 dodo project info prj_xxxxxxxxxxxx
 dodo project remove prj_xxxxxxxxxxxx --yes
 ```
 
+`dodo project access` รับได้ทั้ง **ชื่อโปรเจกต์** และ project ID เว็บ Local Config
+และ CLI เรียก owner-administration service ตัวเดียวกัน (`src/projects/ownerAdmin.ts`)
+จึงใช้ validation, การยืนยันและ audit ชุดเดียวกัน ไม่มี permission logic แยกสองชุด
+
+## Simple Project Access Policy
+
+ตอนเพิ่มโปรเจกต์ให้เลือก **ระดับการเข้าถึง** เพียงค่าเดียว:
+
+| ระดับ | ความหมาย | OAuth scopes ที่เป็นเพดาน |
+|---|---|---|
+| `read` | อ่านอย่างเดียว — อ่าน ค้นหา วิเคราะห์ | `dodo:read` |
+| `edit` | แก้ไข — อ่านและแก้ไฟล์ | `dodo:read` + `dodo:write` |
+| `full` | ทำงานเต็มรูปแบบ — อ่าน แก้ไฟล์ และรันคำสั่ง/ทดสอบ | `dodo:read` + `dodo:write` + `dodo:exec` |
+
+ระดับนี้เป็น **เพดาน ไม่ใช่การให้สิทธิ์** สิทธิ์จริงคือส่วนที่ทับกันของ
+
+```text
+OAuth token scopes ∩ grant scopes ∩ (personal ? grant : client ACL ของ workspace) ∩ ระดับของโปรเจกต์
+```
+
+ดังนั้น token ที่มีแค่ `dodo:read` จะยังอ่านได้อย่างเดียวแม้โปรเจกต์เป็น `full`
+และโปรเจกต์ `read` ก็เขียนไม่ได้แม้ token จะมี `dodo:write` การเปลี่ยนระดับไม่แตะ
+OAuth, trust, approval, path/secret guards, expected hash, sandbox หรือ audit
+
+ใน **โหมดส่วนตัว** (ค่าเริ่มต้น) เพิ่มโปรเจกต์แล้วใช้ได้ทันที ไม่ต้องตั้ง client ACL
+หรือ trust ซ้ำต่อโปรเจกต์ ใน **โหมดแยกสิทธิ์** ยังต้องอนุญาต client ต่อโปรเจกต์ตามเดิม
+และระดับของโปรเจกต์จะบีบให้แคบลงอีกชั้น (ไม่เคยขยาย)
+
+### การอัปเกรดจากรุ่นก่อนหน้า
+
+โปรเจกต์ที่ลงทะเบียนไว้ก่อนมีนโยบายนี้จะได้ระดับ `full` — เพราะ `full` **ไม่บีบอะไรเพิ่ม**
+สิทธิ์จริงจึงเท่าเดิมทุกประการ (ยังถูกจำกัดด้วย OAuth scopes, client ACL ในโหมดแยกสิทธิ์,
+trust และ guards ทั้งหมด) การบีบให้แคบลงเงียบ ๆ จะเป็นการถอนสิทธิ์ที่เจ้าของไม่ได้สั่ง
+ระดับจะแสดงในหน้า Projects และ `dodo project list` เพื่อให้ลดลงได้เอง
+
+## เรียกโปรเจกต์ด้วยชื่อ
+
+ชื่อโปรเจกต์ต้องไม่ซ้ำกัน (เทียบแบบไม่สนตัวพิมพ์) เพราะใช้อ้างอิงโปรเจกต์ในการสั่งงาน AI
+
+พูดกับ AI ได้ตรง ๆ ว่า **"ใช้ DODO แก้โปรเจกต์ auto-upload"** แล้ว AI จะ:
+
+1. เรียก `project_overview` พร้อม `targetProject: "auto-upload"` — DODO resolve ชื่อ
+   เป็นโปรเจกต์เดียวที่ client นั้นมีสิทธิ์เห็น
+2. รับ `workspaceId` / `workspaceEpoch` ของโปรเจกต์นั้นกลับมา
+3. ส่ง `targetProject` พร้อม context นั้นไปกับทุก operation ถัดไป
+
+```jsonc
+project_overview({ targetProject: "auto-upload" })
+
+dodo_write({
+  targetProject: "auto-upload",
+  workspaceId: "ws_…", workspaceEpoch: "boot_…",
+  operation: "edit_file",
+  args: { /* … */ }
+})
+```
+
+กฎของการ resolve:
+
+- เทียบชื่อแบบตัดช่องว่างหัวท้ายและไม่สนตัวพิมพ์
+- ค้นเฉพาะโปรเจกต์ที่ principal นั้นอ่านได้อยู่แล้ว จึงไม่เปิดเผยชื่อหรือ path
+  ของโปรเจกต์ที่ไม่มีสิทธิ์
+- ชื่อกำกวม (เช่นข้อมูลเก่าที่ชื่อซ้ำ) → error พร้อมรายชื่อ candidate ที่เห็นได้ ไม่เดา
+- ส่งทั้ง `targetProjectId` และ `targetProject` ที่ชี้คนละโปรเจกต์ → ปฏิเสธ
+- `targetProject` อยู่ระดับบนสุดเท่านั้น ใส่ใน `args` ที่ซ้อนอยู่จะถูกปฏิเสธ
+- หลัง resolve แล้วผ่าน invocation/security pipeline เดิมครบทุกด่าน
+
+เจ้าของไม่ต้องรู้หรือพิมพ์ project ID เอง (`targetProjectId` ยังใช้ได้ตามเดิมเพื่อ
+ความเข้ากันได้ย้อนหลัง)
+
 ทุกคำสั่งรองรับข้อมูล local owner เท่านั้น `list`, `info` และ `add` รองรับ
 `--json`; `remove` ต้องมี `--yes` หลังตรวจ project ID และ path แล้ว
 

package/docs/RELEASE_1.1.0.md

@@ -0,0 +1,69 @@
+# DODO MCP 1.1.0
+
+รุ่น 1.1.0 เพิ่ม Android ADB tool family ให้ AI ตรวจและควบคุม physical device หรือ
+emulator ที่เจ้าของอนุญาต พร้อม Local Config และ CLI สำหรับ exact-device permission
+
+## ความสามารถใหม่
+
+- Full surface เพิ่ม 13 operations: status, device list/info, screenshot, UI hierarchy,
+  logcat, packages, bounded file read, input action, app action, APK install, file push
+  และ advanced device-side ADB
+- HTTP Compact เพิ่ม `dodo_mobile` gateway ทำให้ Compact มี 20 tools และยังเข้าถึง
+  capability definitions ครบ 138 รายการ; Hybrid คง 49 tools
+- `android_capture` คืน MCP PNG image block จริง และสร้าง snapshot อายุ 30 วินาทีที่
+  ผูก client/device/policy สำหรับ tap/swipe/text/key
+- หน้า Local Config ค้นหาอุปกรณ์ เลือก exact serial และตั้ง `view`/`control` ได้
+- CLI เพิ่ม `dodo android devices|status|allow|disable`
+- setup เพิ่ม component `adb` และ deep capability probe ที่เรียกเฉพาะ `adb version`
+
+## Security
+
+- ADB ปิดโดยค่าเริ่มต้น และ trusted/bypass ไม่เปิดสิทธิ์นี้
+- view/control grant ทำได้เฉพาะ local owner; persistent grant จำระดับ installation
+  ส่วน temporary grant ผูก workspace/epoch
+- ทุก MCP call ยังผ่าน OAuth, `dodo:exec`, project/workspace context, trust/approval,
+  idempotency, audit และ exact serial allowlist
+- input action ใช้ fresh client-bound screenshot; password UI values ถูก redact
+- APK/push source ผ่าน workspace path/secret/symlink/hardlink guards, expected SHA-256
+  และ private staging copy ที่ลบหลังจบ
+- ไม่ expose pair/connect/root, ADB server management หรือ port forwarding ให้ MCP
+- device-side shell มีผลด้วยสิทธิ์ Android shell user และไม่ใช่ sandbox
+
+## Tool surfaces
+
+| Surface | จำนวน |
+|---|---:|
+| Complete Full schema | 138 |
+| Full live default (ซ่อน Sub-agent 4 operations) | 134 |
+| Compact HTTP | 20 |
+| Hybrid | 49 |
+
+Generated tools/list-equivalent schema sizes:
+
+- Full: 475,008 bytes
+- Compact: 55,373 bytes
+- Hybrid: 125,901 bytes
+
+## อัปเดตและเริ่มใช้
+
+```bash
+npm install -g dodo-mcp@1.1.0
+dodo setup --check --components adb
+dodo android devices
+dodo android allow --device SERIAL --mode control --persist --yes
+dodo start
+```
+
+หลัง restart ให้ remote MCP client refresh/recreate connection ตามพฤติกรรมของ client
+เพื่อรับ `dodo_mobile` และ schema ใหม่ ดูขั้นตอนทั้งหมดใน [ANDROID.md](ANDROID.md)
+
+## ผลตรวจรับ
+
+- build/typecheck/lint: `AUTOMATED_PASS`
+- core/integration/security/compatibility: `AUTOMATED_PASS` — 698 passed,
+  35 skipped, 0 failed
+- packaging: `AUTOMATED_PASS` — 16/16
+- Android focused unit/security/HTTP+OAuth/UI: `AUTOMATED_PASS`
+- production dependency audit: `AUTOMATED_PASS` — 0 vulnerabilities
+- physical Android device/emulator with owner hardware: `MANUAL_NOT_RUN`
+- Android/Termux host platform acceptance: `MANUAL_NOT_RUN`

package/docs/RELEASE_1.2.0.md

@@ -0,0 +1,75 @@
+# DODO MCP 1.2.0
+
+รุ่น 1.2.0 แก้ความกำกวมระหว่าง MCP เฉพาะเครื่องกับ `cloudflared` ที่ติดตั้งในเครื่อง
+และนำสิทธิ์ `อ่าน / แก้ไข / เต็ม` กลับมาแสดงในการ์ดของทุกโปรเจกต์
+
+## การเชื่อมต่อสามโหมด
+
+| หน้าเว็บ | ค่า config | ผู้ดูแล `cloudflared` | ใช้ Tunnel token ใน DODO |
+|---|---|---|---|
+| เฉพาะเครื่อง (Loopback) | `local` | ไม่มี | ไม่ใช้ |
+| Cloudflare Local (ติดตั้งในเครื่อง) | `external` | ผู้ใช้ | ไม่รับและไม่อ่าน |
+| DODO Tunnel | `tunnel` | DODO | write-only ผ่าน OS credential store |
+
+```bash
+# AI ในเครื่องเท่านั้น
+dodo tunnel configure --loopback
+
+# เจ้าของติดตั้งและรัน cloudflared เอง
+dodo tunnel configure --cloudflare-local --public-url https://mcp.example.com
+
+# DODO เริ่มและหยุด cloudflared พร้อมตัวเอง
+dodo tunnel configure --tunnel --public-url https://mcp.example.com --os-credential
+```
+
+ทั้ง Cloudflare Local และ DODO Tunnel ใช้ public origin เป็น OAuth issuer/MCP URL
+แต่มีเพียง DODO Tunnel ที่แตะ credential หรือ supervisor Cloudflare Local ไม่อ้างว่า
+connected เพียงเพราะบันทึก URL และ `dodo tunnel doctor` รายงาน process ownership แยก
+จาก public health
+
+## สิทธิ์แต่ละโปรเจกต์
+
+หน้า **โปรเจกต์** แสดงระดับของแต่ละรายการเสมอ:
+
+- `read` — อ่าน ค้นหา วิเคราะห์
+- `edit` — เพิ่มสิทธิ์แก้ไฟล์
+- `full` — เพิ่มสิทธิ์รันคำสั่งและทดสอบ
+
+ระดับเป็นเพดานเท่านั้น สิทธิ์จริงยังเป็น intersection ของ OAuth token, live grant,
+managed ACL (เมื่อเปิดโหมด managed) และระดับโปรเจกต์ จึงไม่ทำให้ read-only token เขียน
+ได้ และไม่ข้าม workspace ID/epoch, approval, sandbox, path/secret guards, expected hash,
+idempotency หรือ audit
+
+โปรเจกต์เดิม migrate เป็น `full` เพื่อไม่ถอนสิทธิ์เงียบ ๆ เจ้าของลดระดับได้จากการ์ด
+โปรเจกต์หรือ CLI:
+
+```bash
+dodo project access "ชื่อโปรเจกต์" --mode read
+dodo project access "ชื่อโปรเจกต์" --mode edit
+dodo project access "ชื่อโปรเจกต์" --mode full
+```
+
+## อัปเดต
+
+```bash
+npm install -g dodo-mcp@1.2.0
+dodo --version
+dodo start
+```
+
+หลังอัปเดตให้ restart DODO ค่า connection mode หรือ public origin ที่เปลี่ยนจากหน้าเว็บ
+ไม่มีผลกับ process เดิมจนกว่าจะ restart
+
+## ผลตรวจรับ
+
+- typecheck/lint: `AUTOMATED_PASS`
+- focused connection/project/OAuth/security/Chromium tests: `AUTOMATED_PASS` —
+  92 passed, 1 skipped, 0 failed
+- core/integration/security/compatibility: `AUTOMATED_PASS` — 726 passed,
+  35 skipped, 0 failed
+- packaging: `AUTOMATED_PASS` — 16/16
+- production dependency audit: `AUTOMATED_PASS` — 0 vulnerabilities
+- immutable release gate และ fresh registry install: ดูผลล่าสุดใน
+  [TEST_REPORT.md](TEST_REPORT.md) (ยังไม่อ้างว่าผ่านจนกว่าจะ publish/verify จริง)
+- Cloudflare Local ผ่าน public hostname จริง: `MANUAL_NOT_RUN`
+- DODO Tunnel credential/public hostname จริงของ 1.2.0: `MANUAL_NOT_RUN`

package/docs/RELEASE_NOTES.md

@@ -1,5 +1,35 @@
 # DODO MCP — Release Notes
 
+## 1.2.0 — Cloudflare Local และสิทธิ์ต่อโปรเจกต์ที่มองเห็นได้
+
+- แยกการเชื่อมต่อเป็นสามโหมด: เฉพาะเครื่อง (Loopback), Cloudflare Local ที่ผู้ใช้
+  รัน `cloudflared` เอง และ DODO Tunnel ที่ DODO ดูแล process
+- Cloudflare Local ใช้ public MCP/OAuth URL โดยไม่รับ/อ่าน Tunnel token และไม่รายงาน
+  supervisor connected จาก config อย่างเดียว
+- หน้า Projects แสดงและบันทึกระดับ `read` / `edit` / `full` ของทุกโปรเจกต์จริง
+  ในโหมดส่วนตัว ไม่ต้องตามหา Trust/Client ACL หลายส่วน
+- ระดับโปรเจกต์เป็นเพดานที่ intersect กับ OAuth/grant/managed ACL เท่านั้น ไม่เพิ่ม
+  สิทธิ์ ไม่ข้าม approval, sandbox, workspace context หรือ file guards
+- Remote Config เปิดผ่าน public Cloudflare ได้ทั้ง owner-managed และ DODO-owned mode;
+  loopback-only ยังคงปฏิเสธ
+
+ติดตั้งด้วย `npm install -g dodo-mcp@1.2.0` แล้ว restart DODO
+
+## 1.1.0 — Android device tools through owner-approved ADB
+
+- เพิ่ม Full 13 `android_*` operations และ Compact `dodo_mobile` gateway สำหรับ
+  device info, screenshot/UI, logcat/packages/files, input/app actions, APK install,
+  file push และ bounded device-side ADB
+- เพิ่ม exact-serial `off|view|control` policy ผ่าน CLI และ Local Config โดย persistent
+  permission เป็นระดับ installation และ temporary permission ผูก workspace/epoch
+- screenshot คืน MCP image block พร้อม caller-bound snapshot; UI password ถูก redact
+- APK/push บังคับ expected SHA-256 และ private staging copy ภายใต้ shared file guards
+- เพิ่ม `adb` setup component, docs, unit/security/HTTP+OAuth/Chromium/packaging tests
+- Complete Full 138, live Full default 134, Compact 20 และ Hybrid คง 49 tools
+
+ติดตั้งด้วย `npm install -g dodo-mcp@1.1.0` แล้ว restart DODO และ refresh/recreate MCP
+connection เพื่อโหลด catalog ใหม่ การ pair/connect และยืนยัน RSA ยังเป็น owner action
+
 ## 1.0.6 — Android-safe CLI startup
 
 - เปลี่ยน raster image backend เป็น lazy load เพื่อให้ core CLI, transport และ

package/docs/SECURITY.md

@@ -67,6 +67,20 @@ Launcher mode ไม่มี active AI workspace และไม่ใช้ CW
 private inert root ไม่ถูกแสดงต่อ client; OAuth และ authenticated catalog เปิดให้ตั้ง
 connection ได้ โหมดส่วนตัวซึ่งเป็นค่าเริ่มต้นอนุญาต owner-approved OAuth installation
 ให้ใช้ target ที่ owner ลงทะเบียนตาม token/profile scopes โดยไม่ต้องสร้าง ACL ซ้ำ
+Simple Project Access Policy เพิ่มเพดานอีกหนึ่งชั้นต่อโปรเจกต์ (`read`/`edit`/`full` →
+`dodo:read` / `+dodo:write` / `+dodo:exec`) บังคับที่จุดเดียวใน
+`src/security/projectAuthority.ts` โดย intersect กับ token scopes, grant scopes และ
+client ACL สิทธิ์จริงจึงเป็นส่วนที่ทับกันทั้งหมด ระดับนี้ **บีบได้อย่างเดียว ไม่เคยขยาย**:
+token ที่มีแค่ `dodo:read` ยังเขียนหรือ exec ไม่ได้แม้โปรเจกต์เป็น `full` workspace ที่
+ไม่ได้อยู่ใน registry (launcher root, stdio cwd) ไม่ถูกบีบเพิ่ม และค่าที่อ่านไม่ออกจะถูก
+ตีเป็น `read` (fail closed) การเพิ่มโปรเจกต์กับการตั้งระดับ commit ใน transaction เดียว
+จึงไม่มีโปรเจกต์ที่ลงทะเบียนครึ่งเดียว
+
+`targetProject` (ชื่อโปรเจกต์) route เหมือน `targetProjectId` ทุกประการ: resolve ก่อน
+เข้า pipeline, ค้นเฉพาะโปรเจกต์ที่ principal อ่านได้อยู่แล้ว (ไม่เปิดเผยโปรเจกต์ที่ไม่มีสิทธิ์),
+ชื่อกำกวมหรือ id/ชื่อขัดกันถูกปฏิเสธ, รับเฉพาะ top level และถูกปฏิเสธใน nested args
+ผ่านรายการ routing key ชุดเดียวกัน (`ROUTING_CONTEXT_KEYS`) ทุก dispatcher
+
 โหมด managed ต้องมี target ACL แยกตามเดิม Mutation จาก Local Config ยังผูกกับ current control context
 workspace/epoch การเลือก startup project เป็น preference เท่านั้นและไม่คัดลอก trust,
 OAuth grant, client ACL, approval, jobs หรือ workspace epoch
@@ -220,13 +234,37 @@ Full จะไม่ register สี่ Sub-agent definitions และ Compact/
 ไม่เปลี่ยน trust/profile policy และไม่ข้าม approvals, sandbox, path/secret guards หรือ
 workspace context ทุก call ที่เปิดให้เห็นยังผ่าน invocation pipeline เดิมทั้งหมด
 
+## Android / ADB access
+
+ADB ปิดโดยค่าเริ่มต้น การมี `adb` หรืออุปกรณ์ที่เชื่อมอยู่ไม่ใช่ permission เจ้าของต้อง
+เลือก `view` หรือ `control` พร้อม exact serial ผ่าน private Local Config/CLI ก่อน
+temporary policy ผูก workspace/epoch ส่วน persistent policy ผูก installation และถอนได้
+ด้วย `dodo android disable` ทุก MCP operation ยังตรวจ live OAuth grant, `dodo:exec`,
+target project/workspace context, trust/approval, idempotency และ audit ตามปกติ
+
+การจับภาพสร้าง snapshot อายุสั้นที่ผูก caller, serial และ policy; input action ใช้และ
+invalidate snapshot ก่อน dispatch UI hierarchy ปิดบัง password field แต่ข้อมูลจาก
+อุปกรณ์ทั้งหมดถือเป็น private untrusted content และไม่ถูกเขียนลง audit log
+
+`android_install`/`android_push` ตรวจ source ผ่าน shared workspace/secret/link policy,
+บังคับ expected SHA-256 และส่ง private staging copy ให้ ADB Pair/connect/root, server
+management และ port forwarding เป็น owner action นอก MCP `android_adb` รับเฉพาะ
+device-side command families แบบ bounded และใช้ `shell:false` ที่ฝั่ง host อย่างไรก็ตาม
+device-side shell สามารถเปลี่ยนข้อมูลด้วยสิทธิ์ Android shell user ได้และไม่ใช่ sandbox
+
 ## Cloudflare Tunnel
 
 เจ้าของเป็นผู้สร้าง remotely-managed Tunnel, hostname และ DNS DODO ไม่ใช้ Cloudflare
-API DODO บันทึกการเลือกแบบ exclusive เป็น `local` หรือ `tunnel` ใน private global
-config หากเลือก Tunnel ทุก `dodo start` จะเริ่มเฉพาะ live `cloudflared` child ของ
-process นั้นและหยุด child พร้อม DODO หาก credential/readiness ไม่พร้อม startup จะ
-fail closed และไม่ fallback ไป Local
+API DODO บันทึกการเลือกแบบ exclusive หนึ่งค่าใน private global config: `local` คือ
+loopback-only, `external` คือ Cloudflare Local ที่เจ้าของรัน `cloudflared` เอง และ
+`tunnel` คือ DODO-owned process เฉพาะ `tunnel` เท่านั้นที่ DODO อ่าน credential,
+เริ่ม child, ตรวจ readiness และหยุด child พร้อม DODO หาก credential/readiness ไม่พร้อม
+startup จะ fail closed และไม่ fallback ไปโหมดอื่น
+
+ใน `external` DODO ใช้ public HTTPS origin เป็น OAuth issuer/MCP URL แต่ไม่รับ token,
+ไม่ค้น process และไม่อ้างว่า Tunnel connected จากค่า config เพียงอย่างเดียว เจ้าของ
+ต้องดูแล process และ route เอง `dodo tunnel doctor` แยก public health ออกจาก process
+ownership และ public health ไม่ใช่หลักฐานว่า AI client เชื่อมอยู่
 
 Token ถูกเก็บใน macOS Keychain, Windows Credential Manager หรือ Linux Secret Service
 เมื่อใช้ `--os-credential`; config เก็บ opaque locator เท่านั้น Owner-controlled
@@ -235,11 +273,12 @@ headless deployment อาจเลือก env/private-file reference โด
 browser storage หรือ setup receipt ค่า `TUNNEL_TOKEN` และ `TUNNEL_TOKEN_FILE` ถูก
 ปฏิเสธจาก environment ของ MCP jobs เสมอ
 
-Local Config รับ token แบบ write-only เฉพาะ POST ที่ผ่าน private capability,
+Local Config รับ token แบบ write-only เฉพาะเมื่อเลือก DODO Tunnel และ POST ผ่าน private capability,
 Host/Origin/proxy checks, rate limit และ control-context headers จากนั้นส่งตรงไปยัง
 reviewed OS credential provider และล้าง request field Response/config/audit ส่งกลับ
 เฉพาะ credential presence/provider ไม่มี MCP tool สำหรับส่ง token, เปลี่ยน connection
-mode หรือควบคุม owner Tunnel
+mode หรือควบคุม owner Tunnel การเลือก Cloudflare Local จะปิดช่อง token และ backend
+ไม่รับหรืออ่าน credential สำหรับโหมดนั้น
 
 Tunnel route ต้องชี้ทุก public path ไป MCP/OAuth listener `127.0.0.1:21730` เท่านั้น
 Local Config `21731`, metrics `21732` และ private IPC ไม่ถูก expose `/config` ที่