dodo-mcp 1.1.0 → 1.2.1

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.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_1.2.1.md

@@ -0,0 +1,47 @@
+# DODO MCP 1.2.1
+
+รุ่น 1.2.1 แก้ปัญหาหน้า Providers & Profiles ตอบเพียง `invalid request` เมื่อข้อมูล
+Agent Profile ไม่ครบ ลดขั้นตอนสร้าง Agent สำหรับการใช้งานส่วนตัว และเพิ่มการเลือก
+operation ที่ AI มองเห็นจากหน้าเว็บ
+
+## สร้าง Agent แบบง่าย
+
+1. บันทึก Provider connection และ API key
+2. กด **โหลดรายชื่อโมเดล** หรือกรอก Model ID เอง
+3. เลือกประเภท Agent: Coding, Review หรือ Research
+4. กด **สร้าง Agent**
+
+รายการโมเดลที่โหลดสำเร็จจะเข้า Agent form ทันที ถ้ามีโมเดลเดียว DODO เลือกให้
+อัตโนมัติ ค่าที่ใช้ไม่บ่อย เช่น tool calling, ภาพ, token limits, จำนวนรอบ และราคา
+อยู่ในส่วน **ตั้งค่าขั้นสูง**
+
+Preset เป็นเพียงค่าตั้งต้นของ profile และทำได้เฉพาะลดขอบเขตจากสิทธิ์จริง ไม่เพิ่ม
+OAuth scope, project access, trust หรือ approval และไม่ข้าม sandbox, path/secret
+guards, expected hash หรือ audit
+
+## Validation
+
+- Browser ปฏิเสธ Agent ที่ไม่มีชื่อ, connection หรือ Model ID ก่อนส่ง request
+- ตัวเลขทุกช่องตรวจช่วงเดียวกับ backend
+- Backend ตอบชื่อ field ที่ผิด เช่น `model` โดยไม่สะท้อนค่าที่กรอกหรือ credential
+- ปุ่มถูกปิดระหว่างบันทึกเพื่อป้องกันการสร้างซ้ำ
+
+## Tool visibility
+
+หน้า **Settings → Tools ที่ AI มองเห็น** มีสวิตช์ราย operation, ค้นหา, เปิด/ปิดทั้งหมวด
+และตัวนับสถานะจริง เมื่อบันทึกแล้ว Compact/Hybrid จะตัด operation ออกจาก discover,
+gateway schema และ direct duplicate ใน Hybrid หลัง restart/rescan หากปิดทั้งหมวด gateway
+นั้นจะหายด้วย Full/STDIO ยังคงครบและ security checks เดิมไม่เปลี่ยน
+
+## สถานะตรวจรับ
+
+- Typecheck/lint: `AUTOMATED_PASS`
+- Chromium end-to-end แบบ desktop และ 390px: `AUTOMATED_PASS`
+- Provider/profile/project/agent/tool-call/write-file flow: `AUTOMATED_PASS`
+- Tool visibility catalog/HTTP/security/Chromium (desktop และ 320px): `AUTOMATED_PASS`
+- Full suite: 731 passed, 35 skipped; packaging 16/16: `AUTOMATED_PASS`
+- Security regression ที่เกี่ยวข้อง: `AUTOMATED_PASS`
+- Exact tarball install + config schema/UI asset manifest: `AUTOMATED_PASS`
+- Production dependency audit: 0 vulnerabilities: `AUTOMATED_PASS`
+- Live provider ของเจ้าของ: `MANUAL_NOT_RUN`
+- npm publish: `MANUAL_NOT_RUN`

package/docs/RELEASE_NOTES.md

@@ -1,5 +1,38 @@
 # DODO MCP — Release Notes
 
+## 1.2.1 — สร้าง Agent แบบง่ายและ error ที่แก้ได้ตรงจุด
+
+- ลดขั้นตอนสร้าง Agent เหลือเลือกประเภท, Provider connection และ Model ID แล้วสร้างได้เลย
+- รายชื่อโมเดลที่โหลดจาก Provider ถูกนำมาให้เลือกใน Agent form ทันที; endpoint ที่ไม่มี
+  model-list ยังพิมพ์ Model ID เองได้
+- เพิ่ม Coding, Review และ Research presets โดยค่าละเอียดอยู่ในส่วนพับได้
+- ตรวจ Model ID, connection และขีดจำกัดตัวเลขใน browser ก่อนส่ง จึงไม่เหลือข้อความ
+  `invalid request` แบบไม่บอกสาเหตุสำหรับกรณีข้อมูลฟอร์มไม่ครบ
+- Owner API คืนเฉพาะชื่อ field ที่ไม่ถูกต้อง ไม่สะท้อน API key หรือค่าที่ผู้ใช้กรอก
+- เพิ่มหน้า Settings สำหรับเปิด/ปิด operation รายตัวใน Compact/Hybrid พร้อมค้นหา,
+  สวิตช์รายรายการ, เปิด/ปิดทั้งหมวด และตัวนับที่มีผลจริง
+- operation ที่ปิดหายจาก `dodo_discover`, gateway enum และ Hybrid direct duplicate;
+  gateway ที่ว่างจะไม่ถูกส่งให้ client ส่วน Full/STDIO ไม่เปลี่ยน
+- การตั้งค่านี้เปลี่ยนเฉพาะ visibility ไม่ grant OAuth scope, project access, trust,
+  approval, sandbox หรือข้าม guards และต้อง restart/rescan หลังบันทึก
+
+รุ่นนี้เตรียมเป็น patch `1.2.1`; การ publish และ live-provider manual test เป็น gate แยก
+
+## 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 สำหรับ

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,6 +234,16 @@ Full จะไม่ register สี่ Sub-agent definitions และ Compact/
 ไม่เปลี่ยน trust/profile policy และไม่ข้าม approvals, sandbox, path/secret guards หรือ
 workspace context ทุก call ที่เปิดให้เห็นยังผ่าน invocation pipeline เดิมทั้งหมด
 
+### Per-operation Compact/Hybrid visibility
+
+`disabledDiscoverOperations` เป็นการตั้งค่าของเจ้าของใน private Local Config และมีผล
+เฉพาะ Compact/Hybrid catalog operation ที่ปิดจะไม่อยู่ใน `dodo_discover`, gateway enum
+หรือ direct duplicate ของ Hybrid และ gateway ที่ไม่เหลือ operation จะไม่ถูก register
+Full/STDIO direct definitions ไม่ถูกลบด้วยค่านี้ รายชื่อที่บันทึกต้องตรงกับ operation
+จริงและ owner API ปฏิเสธชื่ออื่น การซ่อนหรือเปิดกลับไม่ grant OAuth scope, project ACL,
+trust, approval, sandbox หรือสิทธิ์อื่น และ target ที่ยังเปิดอยู่ผ่าน invocation pipeline
+เดิมทุกชั้น
+
 ## Android / ADB access
 
 ADB ปิดโดยค่าเริ่มต้น การมี `adb` หรืออุปกรณ์ที่เชื่อมอยู่ไม่ใช่ permission เจ้าของต้อง
@@ -241,10 +265,16 @@ device-side shell สามารถเปลี่ยนข้อมูลด
 ## 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
@@ -253,11 +283,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` ที่

package/docs/TEST_REPORT.md

@@ -1,5 +1,56 @@
 # DODO MCP — Test Report
 
+## 1.2.1 Agent Profile creation and Compact/Hybrid visibility controls
+
+วันที่ตรวจ: 2026-09-16
+
+- Root cause reproduction: Agent form ส่ง `model: ""` หรือค่าตัวเลขที่ไม่ผ่าน schema
+  แล้ว owner API ตอบเพียง `invalid request fields`
+- Chromium real UI: ตรวจ Model ID ว่างก่อนส่ง, backend ระบุ field `model`, โหลด model
+  fixture แล้วเลือกให้อัตโนมัติ, สร้าง Coding Agent, ทดสอบ tool calling, สร้างไฟล์จริง
+  และอ่านผลกลับ — `AUTOMATED_PASS`
+- Responsive: desktop 1440px และ mobile 390px ไม่มี horizontal overflow —
+  `AUTOMATED_PASS`
+- Per-operation visibility: ปิด `write_file` แล้วหายจาก discover, gateway enum และ
+  Hybrid direct duplicate; ปิด `git_commit` แล้ว gateway ที่ว่างหาย; Full ยังครบ —
+  `AUTOMATED_PASS`
+- Owner-only API ปฏิเสธ unauthenticated/stale/unknown operation และบันทึกรายการแบบ
+  canonical; public MCP ไม่มี admin route — `AUTOMATED_PASS`
+- Chromium real UI: สวิตช์ราย operation, search, เปิด/ปิดทั้งหมวด, restart notice,
+  desktop 1280px และ 320px ไม่มี horizontal overflow — `AUTOMATED_PASS`
+- Focused catalog/HTTP/security/UI suites: 40/40 — `AUTOMATED_PASS`
+- `npm run test:all`: 107 files passed, 3 skipped; 731 tests passed, 35 skipped;
+  packaging 16/16 — `AUTOMATED_PASS`
+- `npm audit --omit=dev`: 0 vulnerabilities — `AUTOMATED_PASS`
+- Fresh immutable tarball smoke: CLI 1.2.1, generated config schema และ Local Config
+  UI assets ครบ — `AUTOMATED_PASS`
+- Live owner provider credentials: `MANUAL_NOT_RUN`
+- npm publish: `MANUAL_NOT_RUN`
+
+## Release 1.2.0 — Cloudflare Local และ Simple Project Access
+
+ผล candidate บน macOS arm64 วันที่ 2026-09-16:
+
+- build: **AUTOMATED_PASS** — Complete Full 138, live Full default 134, Compact 20,
+  Hybrid 49 และ config schemas 2 ชุด
+- typecheck/lint: **AUTOMATED_PASS**
+- core/integration/security/compatibility: **AUTOMATED_PASS** — 726 passed /
+  35 skipped / 0 failed ใน 107 ไฟล์ที่ผ่านและ 3 ไฟล์ที่ skip
+- packaging: **AUTOMATED_PASS** — 16/16 รวม release document, ADR, generated UI
+  assets และ fresh tarball checks ตาม manifest
+- focused connection/project/OAuth/security/Chromium: **AUTOMATED_PASS** — 92 passed,
+  1 skipped, 0 failed; ทดสอบสาม connection modes, write-only credential boundary,
+  Remote Config ผ่าน owner-managed public mode, per-project `read/edit/full`,
+  project-name routing และ real browser UI
+- production dependency audit: **AUTOMATED_PASS** — 0 vulnerabilities
+- Cloudflare Local ผ่าน public hostname/process จริงของเจ้าของ: **MANUAL_NOT_RUN**
+- DODO Tunnel credential store/readiness ผ่าน public hostname จริงของ 1.2.0:
+  **MANUAL_NOT_RUN**
+
+Regression รอบแรกพบ security fixture คาด marker `Project Registry` ที่หายจากหัวข้อไทย
+จึงคืน marker ใน UI แล้วรัน focused และ full suite ใหม่จนผ่าน ไม่ได้ลด assertion
+หรือ security requirement
+
 ## Release 1.1.0 — Android ADB tool family
 
 ผล candidate บน macOS วันที่ 2026-09-16:
@@ -96,6 +147,56 @@ Hybrid 49 tools; `npm run test:all` ผ่าน core/security/compatibility 99
 Live Cloudflare hostname และ OS credential store ด้วย credential ของเจ้าของสำหรับ source
 นี้: **MANUAL_NOT_RUN** — ไม่ถือว่า fixture cloudflared เป็นหลักฐานของ public network จริง
 
+## Pre-release project access, project names and tunnel readiness — 2026-09-16
+
+หลักฐานชุดนี้สร้างก่อนรวมเข้า 1.2.0 งานรอบนี้: Simple Project Access Policy (read/edit/full),
+เรียกโปรเจกต์ด้วยชื่อ (`targetProject`), แก้ข้อความที่บังคับ ACL ในโหมดส่วนตัว และแก้
+Cloudflare readiness ที่สถานะกระพริบ
+
+**รันจริงบน macOS arm64, Node v22.23.2:**
+
+- `npm run typecheck` / `npm run lint` / `npm run build` — **AUTOMATED_PASS** (exit 0)
+- `npm run test:all` — **AUTOMATED_PASS**: 705 passed / 34 skipped / 0 failed (106 ไฟล์)
+  + packaging 16/16
+- `npx vitest run tests/security/projectAccessLevel.test.ts` (ใหม่, 11 ข้อ) —
+  **AUTOMATED_PASS**: mapping ระดับ→scope, `full` token ถูกบีบตามระดับ, token `read`
+  เขียน/exec ไม่ได้แม้โปรเจกต์ `full`, managed mode ยังต้องมี ACL แล้วระดับบีบซ้ำ,
+  workspace ที่ไม่ได้ลงทะเบียนไม่ถูกบีบ, ค่าที่อ่านไม่ออก → `read` (fail closed),
+  row เก่า migrate เป็น `full` (ไม่ถอนสิทธิ์), ระดับผิด → ไม่มีโปรเจกต์ค้าง,
+  ชื่อซ้ำถูกปฏิเสธแบบไม่สนตัวพิมพ์, resolve ชื่อ/ชื่อกำกวม/ชื่อไม่รู้จัก
+- `npx vitest run tests/integration/projectByName.test.ts` (ใหม่) — **AUTOMATED_PASS**
+  ผ่าน HTTP + OAuth จริง: route ด้วยชื่อ, เขียนลงโปรเจกต์ถูกตัว, ตัวพิมพ์/ช่องว่างไม่สำคัญ,
+  ระดับ `edit` บล็อก exec แล้วยกเป็น `full` ทำได้, ชื่อไม่รู้จัก → NOT_FOUND,
+  id+ชื่อขัดกัน → INVALID_INPUT, ชื่อกำกวม → CONFLICT พร้อม candidate,
+  `targetProject` ใน nested args ถูกปฏิเสธและไม่มีไฟล์ถูกเขียน
+- `npx vitest run tests/unit/tunnelReadiness.test.ts` (ใหม่, 8 ข้อ) — **AUTOMATED_PASS**:
+  probe 200/503/ปิด/ค้าง, ไม่ใช้ socket ซ้ำ (นับ connection = 2), schema รองรับทุก phase,
+  state.json รุ่นเก่า parse ได้, ปฏิเสธ field แปลกปลอม
+- `npx vitest run tests/integration/tunnelSupervisor.test.ts` (เพิ่ม 3 ข้อ) —
+  **AUTOMATED_PASS** ด้วย fake cloudflared จริง: readiness ตกชั่วคราว → `degraded`
+  และ `connected` ยังเป็น true, ไม่มีบรรทัด "is not connected"; ล้มติดกันครบเกณฑ์ →
+  `disconnected` แล้ว recover กลับ `connected`; ไม่เคยรายงาน connected โดยไม่มีหลักฐาน
+- `npx vitest run tests/integration/projectAccessUi.test.ts` (ใหม่, 2 ข้อ) —
+  **AUTOMATED_PASS** ใน Chromium จริง: เพิ่มโปรเจกต์ครบในหน้าเดียว (path/ชื่อ/ระดับ),
+  การ์ดแสดงระดับที่ backend เก็บจริง, เปลี่ยนระดับแล้วยืนยันหลัง backend ตอบ,
+  reload ยังเห็นค่าเดิม, ชื่อซ้ำขึ้น error (ไม่ขึ้น success), personal ซ่อนฟอร์ม ACL /
+  managed แสดงครบ, 390px ไม่มี horizontal scroll, `pageerror` = 0
+- `npm run test:linux:docker` — **AUTOMATED_PASS** (node v22.23.2, arm64, Chromium)
+- `npm pack` + fresh install จาก tarball — **AUTOMATED_PASS**: 461 ไฟล์, ไม่มี
+  state.db/.env/jwks/.sock, `dist/projects/ownerAdmin.js` และ
+  `dist/security/projectAccess.js` อยู่ในแพ็กเกจ, และรัน
+  `dodo project add --access read` → `dodo project access "auto-upload" --mode full`
+  → `dodo project list` ได้จริงจาก tarball ที่ติดตั้งสด
+- `npm run test:windows` บน macOS — 56 passed / 30 skipped: **ไม่ใช่หลักฐาน Windows**
+  (ข้อที่เป็น Windows-only ถูก skip)
+
+**MANUAL_NOT_RUN** (ยังไม่มีหลักฐาน):
+- Windows native (windows-ci-02) — ยังไม่ได้รัน รอบนี้แก้สาเหตุที่เป็น Windows-specific
+  ไว้แล้ว (event-loop starvation จากการเขียน log, keep-alive socket) แต่ยังไม่มีหลักฐานจริง
+- การยืนยันบน tunnel จริง `https://mcp.baanseriesnow.com/mcp` กับ cloudflared จริง
+  (เทสต์ใช้ fake cloudflared ที่ควบคุม `/ready` ได้)
+- การอัปเกรดจาก state ของ 1.0.2/1.0.3 จริง (migration ตรวจด้วย fixture เท่านั้น)
+
 ## Scope
 
 รายงานนี้ใช้กับ DODO MCP 1.0.3 source และแยกผล automated กับ manual อย่างชัดเจน

package/docs/TUNNEL.md

@@ -1,8 +1,11 @@
-# DODO MCP — Local และ Cloudflare Tunnel
+# DODO MCP — Loopback, Cloudflare Local และ DODO Tunnel
 
 DODO มีโหมดเชื่อมต่อระดับ installation เพียงหนึ่งโหมดในแต่ละเวลา:
 
-- `local` — ใช้ MCP ที่ `http://127.0.0.1:21730/mcp` และไม่เริ่ม `cloudflared`
+- `local` — **เฉพาะเครื่อง (Loopback)** ใช้ MCP ที่
+  `http://127.0.0.1:21730/mcp` และไม่ใช้ Cloudflare
+- `external` — **Cloudflare Local (ติดตั้งในเครื่อง)** เจ้าของติดตั้งและรัน `cloudflared` เอง
+  DODO advertise public HTTPS origin แต่ไม่รับ token และไม่เริ่ม/หยุด process
 - `tunnel` — ใช้ public HTTPS origin เป็น MCP URL หลัก และ DODO เริ่ม/หยุด
   `cloudflared` ของตัวเองพร้อมทุก `dodo start`
 
@@ -14,7 +17,7 @@ DODO มีโหมดเชื่อมต่อระดับ installation
 
 | บริการ | ค่าเริ่มต้น | การเปิดเผย |
 |---|---:|---|
-| MCP + OAuth upstream | `127.0.0.1:21730` | Local เท่านั้น; Tunnel route มาที่พอร์ตนี้ |
+| MCP + OAuth upstream | `127.0.0.1:21730` | bind loopback เสมอ; Cloudflare ทั้งสองโหมด route มาที่พอร์ตนี้ |
 | Local Config | `127.0.0.1:21731` | Loopback เท่านั้นเสมอ |
 | Tunnel readiness/metrics | `127.0.0.1:21732` | Loopback เท่านั้นเสมอ |
 
@@ -22,14 +25,14 @@ Cloudflare public hostname ต้อง route **ทุก path** มาที่
 `http://127.0.0.1:21730` เพื่อให้ health, OAuth discovery, authorization และ `/mcp`
 ทำงานครบ ห้าม route พอร์ต 21731, 21732, private IPC หรือ debug endpoint ออก public
 
-แม้โหมด Tunnel ยังต้องมี listener 21730 เป็น private upstream ให้ `cloudflared`
-แต่ DODO จะ advertise public HTTPS URL เป็น endpoint ที่มีผล ส่วน Local Config ยังคง
+โหมด Cloudflare ทั้งสองแบบยังต้องมี listener 21730 เป็น private upstream ให้
+`cloudflared` แต่ DODO จะ advertise public HTTPS URL เป็น endpoint ที่มีผล ส่วน Local Config ยังคง
 เข้าผ่าน loopback ยกเว้น bounded `/config` lease ที่เจ้าของเปิดชั่วคราวเอง
 
-## เลือก Local
+## เลือกเฉพาะเครื่อง (Loopback)
 
 ```bash
-dodo tunnel configure --local
+dodo tunnel configure --loopback
 dodo start
 ```
 
@@ -39,9 +42,30 @@ dodo start
 dodo tunnel status
 ```
 
-Local mode ไม่ใช้ public origin และไม่เริ่ม Tunnel หากต้องการกลับไป Tunnel ต้องเลือก
+Loopback mode ไม่ใช้ public origin และไม่เริ่ม Tunnel หากต้องการกลับไป Cloudflare ต้องเลือก
 ใหม่อย่างชัดเจนด้วยคำสั่งหรือหน้า Local Config แล้ว restart DODO
 
+`--local` ยังเป็น alias เดิมของ `--loopback` เพื่อไม่ทำให้สคริปต์เก่าตีความต่างไป
+
+## เลือก Cloudflare Local (ติดตั้งในเครื่อง)
+
+โหมดนี้ใช้เมื่อผู้ใช้ติดตั้งและรัน `cloudflared` เอง เช่นผ่าน terminal, launchd,
+systemd หรือ Windows Service DODO ไม่ขอ Tunnel token และไม่อ้างว่า process เชื่อมต่อแล้ว
+เพียงเพราะบันทึก public URL
+
+```bash
+dodo tunnel configure \
+  --cloudflare-local \
+  --public-url https://mcp.example.com
+
+# รัน cloudflared ด้วยวิธีที่ผู้ใช้จัดการเอง แล้วจึงเปิด DODO
+dodo start
+```
+
+Cloudflare ต้อง route ทุก path ไป `http://127.0.0.1:21730` เช่นเดียวกับ DODO Tunnel
+ตรวจปลายทางจริงด้วย `dodo tunnel doctor` ค่า public health ที่ผ่านยืนยันเพียงว่า origin
+ตอบ DODO health ไม่ได้ยืนยันว่ามี AI client เชื่อมอยู่
+
 ## เลือก DODO Tunnel
 
 เจ้าของต้องสร้าง remotely-managed Tunnel, public hostname และ DNS ใน Cloudflare ก่อน
@@ -89,16 +113,17 @@ CLI argument, config JSON, log, audit, MCP response, browser storage หรื
 **การเชื่อมต่อ MCP**:
 
 1. ตั้ง Public origin เป็น HTTPS origin ของ Tunnel
-2. เลือก `DODO Tunnel`
-3. ใส่ Cloudflare Tunnel token หากยังไม่มี credential ที่บันทึกไว้
+2. เลือก `Cloudflare Local (ติดตั้งในเครื่อง)` หากจะรัน cloudflared เอง หรือ `DODO Tunnel` หากให้
+   DODO ดูแล process
+3. ใส่ Cloudflare Tunnel token เฉพาะ `DODO Tunnel`
 4. กดบันทึกและ restart DODO
 
-หรือเลือก `Local` แล้วบันทึกและ restart ค่าในหน้าเว็บไม่เปลี่ยน endpoint ของ process
+หรือเลือก `เฉพาะเครื่อง (Loopback)` แล้วบันทึกและ restart ค่าในหน้าเว็บไม่เปลี่ยน endpoint ของ process
 ที่กำลังรันอยู่ทันที หน้าเว็บจะแสดงสถานะ restart ที่ตรงกับ runtime จริง
 
 ## Remote Config ไม่เกินหนึ่งชั่วโมง
 
-Remote Config ใช้ได้เฉพาะเมื่อเลือก Tunnel และ DODO-owned Tunnel กำลังรันอยู่:
+Remote Config ใช้ได้เมื่อเลือก Cloudflare Local (ติดตั้งในเครื่อง) หรือ DODO Tunnel:
 
 ```bash
 dodo --web
@@ -109,6 +134,9 @@ dodo web --status
 dodo web --close
 ```
 
+ในโหมด Cloudflare Local (ติดตั้งในเครื่อง) เจ้าของต้องรัน tunnel และ route ครบเอง ส่วน DODO Tunnel
+จะตรวจว่า supervisor ที่ DODO เป็นเจ้าของกำลังรันก่อนเปิด lease
+
 `/config` ตอบ 404 ตามค่าเริ่มต้น คำสั่ง `dodo --web` เปิดหรือเปลี่ยน lease ผ่าน
 authenticated private IPC โดยไม่ restart MCP และไม่รับ Tunnel token ผ่าน IPC URL ไม่มี
 query/fragment secret Pairing code มีอายุสั้นและใช้ได้ครั้งเดียว หลังจับคู่ browser ได้
@@ -128,10 +156,45 @@ dodo tunnel logs --lines 100
 dodo tunnel stop
 ```
 
-`status` ไม่อ่าน credential ส่วน `doctor` ตรวจ executable, credential, local health,
-Tunnel readiness และ public health แยกกัน Public health ที่ผ่านพิสูจน์เพียงว่า origin
-ตอบ DODO health ไม่ได้พิสูจน์ว่า AI client เชื่อมต่อแล้ว `stop` ส่งสัญญาณเฉพาะ live
-child handle ที่ supervisor ปัจจุบันสร้าง ไม่ค้นหรือ kill process ตามชื่อ/PID เก่า
+### สถานะของ Tunnel (state machine)
+
+`phase` ของ supervisor มีค่าเหล่านี้ และเปลี่ยนตามหลักฐานจริงเท่านั้น:
+
+| phase | ความหมาย |
+|---|---|
+| `starting` | supervisor เริ่มทำงาน ยังไม่ spawn cloudflared |
+| `connecting` | cloudflared รันแล้ว แต่ยัง **ไม่เคย** มีหลักฐาน readiness |
+| `connected` | `/ready` ตอบ 200 — ต้องมีหลักฐานจริงเท่านั้นจึงแสดงสถานะนี้ |
+| `degraded` | เคย connected แล้ว probe เริ่มล้ม แต่ยังไม่ถึงเกณฑ์ (กำลัง reconnect) |
+| `disconnected` | probe ล้มติดกันครบเกณฑ์ หรือ cloudflared exit |
+| `backoff` | รอ restart แบบมีขอบเขต |
+| `stopping` / `stopped` / `failed` | เจ้าของสั่งหยุด / หยุดแล้ว / restart หมดโควตา |
+
+สถานะยังมี `lastReadyAt`, `lastFailureAt` และ `consecutiveReadyFailures` เพื่อให้ดูได้ว่า
+readiness สำเร็จครั้งสุดท้ายเมื่อไร
+
+**ทำไมเมื่อก่อนสถานะกระพริบ** — เดิม probe ทุก 1 วินาทีโดย timeout 1.5 วินาที
+จึงซ้อนกันได้ ผลเก่าเขียนทับผลใหม่ และ probe ที่ล้ม **ครั้งเดียว** ก็พลิกสถานะและพิมพ์
+`readiness endpoint is not connected` ทันที ตอนนี้:
+
+- probe ทำทีละครั้ง ไม่ซ้อนกัน และมี generation fence ผลจาก child เก่าถูกทิ้ง
+- ต้องล้มติดกันครบเกณฑ์จึงจะเป็น `disconnected` — ล้มครั้งเดียวเป็นแค่ `degraded`
+  และ `connected` ยังเป็น true เพื่อไม่ให้ UI กระพริบ
+- ใช้ socket ใหม่ทุกครั้ง (`agent: false`) กัน keep-alive socket ที่ถูกปิดแล้ว
+  กลายเป็น error ปลอม
+- เขียน log ของ cloudflared แบบรวมกลุ่ม ไม่เขียนทับไฟล์ 512 KiB ทุกบรรทัด
+  (บน Windows การ retry rename ใช้ `Atomics.wait` ซึ่งบล็อก event loop จน probe timeout)
+- cloudflared exit → `disconnected` ทันที, restart มีขอบเขตตาม `maxRestarts` เสมอ
+- ไม่มี fallback เงียบ ๆ จาก tunnel ไป local และ token ไม่ปรากฏใน log หรือ error
+
+Tunnel เป็นระดับ installation รองรับทุกโปรเจกต์ การเพิ่มหรือเลือกโปรเจกต์ไม่ restart tunnel
+
+`status` ไม่อ่าน credential ส่วน `doctor` ตรวจ executable, local health และ public
+health ทุกโหมด แต่ตรวจ credential/supervisor readiness เฉพาะ DODO Tunnel ใน
+Cloudflare Local รายงาน process ownership เป็น `owner` และไม่ควบคุม process Public
+health ที่ผ่านพิสูจน์เพียงว่า origin ตอบ DODO health ไม่ได้พิสูจน์ว่า AI client
+เชื่อมต่อแล้ว `stop` ส่งสัญญาณเฉพาะ live child handle ที่ DODO supervisor ปัจจุบัน
+สร้าง ไม่ค้นหรือ kill process ตามชื่อ/PID เก่า
 
 ## ตั้งค่า MCP client