dodo-mcp 1.0.0

package/docs/MANUAL_ACCEPTANCE.md

@@ -0,0 +1,283 @@
+# DODO MCP — Manual Acceptance
+
+ผล manual ต้องบันทึกเป็น `MANUAL_PASS` หรือ `MANUAL_NOT_RUN` พร้อมวันเวลาและ environment ห้ามเดาผลจาก automated test
+
+สถานะล่าสุดของ owner-state setup/import gate: `MANUAL_NOT_RUN` (2026-09-14) ชุด automated ใช้ fixture แยกและไม่แตะ config/OAuth/tunnel ของผู้ใช้
+
+สถานะ Cloudflare Tunnel จริง: `MANUAL_NOT_RUN` (2026-09-14) automated tests ใช้ fake executable และ loopback readiness fixture เท่านั้น ไม่มี Tunnel token, Cloudflare connection, DNS หรือ firewall ใดถูกใช้
+
+## Cloudflare Tunnel
+
+1. สร้าง remotely-managed Tunnel และ public hostname ใน Cloudflare ด้วยบัญชีเจ้าของ
+2. route ทุก path ของ hostname ไป `http://127.0.0.1:21730` และยืนยันว่าไม่มี route ไป `21731`/`21732`
+3. รัน `dodo setup --check --components cloudflared`
+4. รัน `dodo start` แล้วกรอก token ที่ hidden prompt; ตรวจว่า config/Keychain ไม่มี token
+5. หยุดแล้วเริ่มใหม่ กด Enter ที่ prompt และยืนยันว่าเปิดเฉพาะ local MCP
+6. เปิด Local Config กรอก token ใน Temporary Tunnel token แล้วกดเปิด; ตรวจช่องถูกล้างและ response/state ไม่มี token
+7. ตรวจ `dodo tunnel status` ว่า `credentialSource=temporary` และ connected หลัง `/ready` ตอบจริง
+8. ตรวจ `dodo tunnel doctor` แยก local/public health และไม่กล่าวว่า AI client connected
+9. ตรวจ process list ว่า argv ไม่มี token และ `dodo tunnel logs` ไม่มี token
+10. ทดสอบ OAuth + MCP ผ่าน public origin แล้ว stop จาก Local Config; ยืนยัน child หยุดแต่ local MCP ยังอยู่
+11. เริ่ม tunnel ใหม่แล้วหยุด DODO; ยืนยัน child หยุดตาม
+12. บันทึก macOS และ Linux Docker แยก environment; Windows คง `MANUAL_NOT_RUN` จนถึง phase สุดท้าย
+
+## Setup foundation
+
+1. ใช้ config directory ชั่วคราวและรัน `dodo setup --check` กับ `dodo setup --plan`
+2. ตรวจว่าไม่มี config, tools, receipt หรือ project file ถูกสร้าง
+3. เลือก dependency ที่ยังขาดแล้วรันโดยไม่มี `--yes`
+4. ตรวจว่า installer ไม่เริ่มและไม่มี state ถูกเขียน
+5. รันใหม่ด้วย `--yes` เฉพาะใน fixture ที่อนุญาต แล้วตรวจ receipt schema/version และ readiness probe
+
+## Existing-state import
+
+1. สร้าง fixture source ที่มี config preferences, OAuth/key fixture และ state DB fixture
+2. รัน plan และตรวจว่ารายการ import มีเฉพาะ safe config fields
+3. รัน `--import-state` และตรวจว่า source ยังอยู่ครบ
+4. ตรวจ target ไม่มี DB, keys, tokens, ACL, trust, approvals หรือ permission-bearing config
+5. เปลี่ยน source หลัง plan แล้วตรวจว่า import ถูกปฏิเสธและ target ไม่ถูกสร้าง
+6. ทดสอบ malformed/unknown config, symlink และ active IPC marker ให้ fail closed
+
+## Local Config
+
+0. UI ใหม่ (2026-09-14): ตรวจบนเครื่องจริงว่า (ก) nav 8 หน้าใช้ได้ทั้ง desktop และมือถือ
+   (ข) tooltip `?` เปิดด้วยการแตะบนอุปกรณ์ touch จริงและ screen reader อ่านได้
+   (ค) กล่องยืนยัน SweetAlert แสดงก่อนการลบ/ยกเลิก/เปลี่ยนโหมดทุกครั้ง
+   (ง) ผลทดสอบ Provider แสดงชื่อ connection, โมเดล, ชนิดการทดสอบ และเวลา
+   — สถานะปัจจุบัน: ผ่านใน Chromium fixture (ดู TEST_REPORT); อุปกรณ์ touch จริงและ
+   screen reader จริงยัง **MANUAL_NOT_RUN**
+1. จาก directory ที่ไม่ใช่โปรเจกต์และ config ใหม่ รัน `dodo` แล้วตรวจว่า anonymous MCP ได้ 401,
+   OAuth login และ authenticated `tools/list` ใช้ได้ แต่ `project_overview` ได้
+   `WORKSPACE_ACCESS_REQUIRED` และไม่เผย private inert root
+2. เปิด Local Config URL จาก terminal
+3. ตรวจว่าไม่มี root จาก CWD ปรากฏ และ Project Registry ยังเพิ่ม/เลือก path ได้
+4. เพิ่ม fixture A โดยเลือก “เปิดโปรเจกต์นี้ทันที” แล้วตรวจ root, MCP/OAuth และ config listener
+5. ปิดแล้วเปิด `dodo` จาก directory อื่น ตรวจว่า A ถูกเลือกจาก registry preference
+6. เปลี่ยนไปยัง fixture project B
+7. ตรวจว่า overview จาก MCP เห็น B จริง
+8. ตรวจ workspace ID/epoch เปลี่ยน และหน้าเว็บแจ้งให้โหลด context ใหม่
+9. กลับไป A แล้วตรวจว่า ACL/trust ไม่ปะปน
+
+## Interactive CLI
+
+1. รัน `dodo --cli` จาก Home/Desktop และตรวจว่าแสดง project ที่เลือกล่าสุด
+2. เลือก project เดิมและเพิ่ม fixture ใหม่ด้วย absolute path
+3. ตรวจว่า server ใช้ root ที่เลือก ไม่ใช่ CWD
+4. เลือก setup check และตรวจว่ารายการมี cloudflared
+5. เลือกเปิด Tunnel แบบ temporary แล้วตรวจ process list/config/log/audit ว่าไม่มี token
+   ไม่มี token จากนั้นลบ credential ผ่าน Local Config
+
+สถานะ owner-browser/terminal สำหรับ launcher และเมนูใหม่: `MANUAL_NOT_RUN`
+
+## Workspace safety
+
+1. เริ่ม job ที่ยังทำงานอยู่
+2. ลองเปลี่ยน workspace
+3. ต้องถูกปฏิเสธพร้อมบอกให้รอหรือ cancel job
+4. ทำให้ target bootstrap ล้มเหลว
+5. ตรวจว่า workspace เดิมยังเรียก tool ได้
+
+## Project Registry
+
+1. ใช้ `dodo project add /absolute/path --name "Fixture A"` และตรวจว่า `list/info` แสดง canonical path, project ID และ `ready`
+2. เพิ่ม path เดิมซ้ำและตรวจว่า project ID ไม่เปลี่ยน
+3. เปิด Local Config แล้วตรวจว่ารายการแสดง active/readiness โดยไม่มี client secret หรือ token
+4. เพิ่ม Fixture B จากหน้าเว็บ แล้วกดเปิดโปรเจกต์ ตรวจว่า MCP ใช้ B จริงและ AI ต้องเรียก `project_overview` ใหม่
+5. ตรวจว่า trust/client ACL ของ A ไม่ปรากฏใน B
+6. rename directory fixture แล้วเพิ่ม path ใหม่ ตรวจว่า project ID คงเดิมแต่ workspace ID เปลี่ยน
+7. แทน path ด้วย directory identity อื่นและตรวจว่า DODO ปฏิเสธการ takeover
+8. นำรายการออกหลังยืนยัน ตรวจว่าไฟล์ ประวัติ trust และ ACL ยังอยู่
+9. เปิด Local Config โดยไม่มี private fragment, จาก origin อื่น และผ่าน proxy headers; ทุกกรณีต้องถูกปฏิเสธ
+
+สถานะการตรวจ Project Registry บน browser/owner environment จริง: `MANUAL_NOT_RUN`
+
+## Multi-project federation
+
+1. สร้าง fixture A/B และลงทะเบียนทั้งคู่ด้วย owner CLI/Local Config
+2. ให้ client 1 มี `dodo:read` ใน A/B และ client 2 มีเฉพาะ A
+3. จาก active A เรียก `project_overview` แล้วตรวจว่าแต่ละ client เห็นเฉพาะรายการที่มี ACL
+4. ให้ client 1 เรียก `project_overview({projectId: B})`, `read_files` ของ A/B พร้อมกัน และ `search_code({projectIds:[A,B]})`
+5. ตรวจผลทุก project มี project/workspace identity, federation epoch และ source hash โดย active root/epoch ไม่เปลี่ยน
+6. ให้ client 2 query B ต้องได้ `FORBIDDEN` และ response ต้องไม่มี path/name/content ของ B
+7. อ่าน `.env`, traversal, symlink/hardlink และ replaced root ใน B ต้อง fail closed
+8. ทำ B unavailable แล้วค้น A/B ต้องได้ผล A พร้อม partial failure ของ B
+9. ส่ง stale active epoch ต้องถูกปฏิเสธก่อนอ่าน target
+10. ใส่ `projectId` ใน write/exec args ต้องถูก schema ปฏิเสธ และไฟล์/job ต้องไม่เกิด
+
+สถานะการตรวจ multi-project federation ผ่าน external AI/owner environment จริง: `MANUAL_NOT_RUN`
+
+## Universal Resource Layer
+
+สถานะ: **MANUAL_NOT_RUN** สำหรับ external AI/web client จริง
+
+1. `resource_inspect` ไฟล์ text/image/audio อย่างละหนึ่งไฟล์ใน fixture
+2. อ่าน text กลับด้วย `resource_read` และอ่านไฟล์ใหญ่ต่อด้วย resume token
+3. ยืนยัน `resource_preview` แสดง MCP image/audio block จริง
+4. ใช้ `dodo_discover(operation="resource_read_range")` แล้วเรียกผ่าน `dodo_media`
+5. ทดลอง `.env`, path traversal และ resource ID จาก client อื่น ต้องถูกปฏิเสธ
+6. revoke workspace access แล้ว resource เดิมต้องอ่านไม่ได้
+7. restart fixture server แล้ว reference เดิมยังอ่านได้ด้วย epoch ใหม่
+
+ห้ามใช้ไฟล์จริงที่เป็นความลับและห้ามเปลี่ยน MANUAL_PASS จาก automated test เท่านั้น
+
+## Project Brain
+
+สถานะ: **MANUAL_NOT_RUN** สำหรับ external AI และ owner project จริง
+
+1. เปิด fixture TypeScript project แล้วรอ `brain_status` เป็น `completed`
+2. ค้น symbol/import/route/test/dependency ด้วย `brain_query`
+3. แก้หนึ่งไฟล์และยืนยัน metrics ว่า `parsedFiles` ไม่เท่ากับทั้ง project
+4. ย้ายไฟล์แบบ exact-content และตรวจว่า `symbol://` URI เดิม resolve ไป path ใหม่
+5. แก้ source หลัง index แล้วตรวจว่า query default ตัด stale result และ
+   `includeStale:true` ระบุ freshness ตามจริง
+6. ลอง `.env`, traversal, symlink/hardlink, token read-only, revoked ACL และ stale epoch
+7. pause/cancel/rebuild ใน inspect mode และยืนยัน approval ผูก target operation
+8. restart ระหว่าง run แล้วตรวจ interrupted recovery และ committed graph เดิม
+
+automated fixtures ผ่านรายการหลักแล้ว แต่ยังไม่ได้วัด performance ระยะยาวกับ repository
+ของผู้ใช้หรือ workflow ผ่าน external AI จึงยังเป็น `MANUAL_NOT_RUN`
+
+## Context Engine และ Evidence
+
+สถานะ: **MANUAL_NOT_RUN** สำหรับ external AI และ owner repository จริง
+
+1. เรียก `context_query` ด้วย goal เดียวกันสองครั้งและตรวจ ranking/evidence ID คงเดิม พร้อม cache hit ครั้งที่สอง
+2. ใช้ budget เล็กและ cursor อ่านหน้าถัดไปโดยไม่มี evidence ซ้ำหรือข้าม
+3. ตรวจทุกผลมี project/source hash, confidence, generated/verified time, freshness และ `untrusted_content`
+4. แก้ source หลัง query แล้วตรวจว่า evidence เดิมเป็น stale และ query ใหม่ใช้ hash ใหม่
+5. ลงทะเบียน fixture A/B ให้ client อ่านได้ทั้งคู่ แล้ว query ด้วย project name/ID โดย active workspace ไม่เปลี่ยน
+6. ถอน ACL ของ B แล้วตรวจ query และ evidence เดิมถูกปฏิเสธโดยไม่เผย absolute path
+7. ค้น marker ใน `.env`, private state, symlink/hardlink และตรวจว่าไม่ปรากฏในผล/cache diagnostics
+8. ตรวจ `context_status` มี L0–L6 metrics แต่ไม่มี goal, path, source content หรือ credential
+9. ตรวจ owner-reviewed CURRENT memory แสดงเป็น `MEMORY`; runtime และ federated graph
+   ที่ยังไม่มี provider แสดง unavailable/partial ตามจริง
+
+Automated HTTP/OAuth fixtures ผ่าน contract หลักแล้ว แต่ยังไม่เปลี่ยนสถานะ manual
+จนกว่าจะทดสอบกับ external AI และ repository ที่เจ้าของเลือกจริง
+
+## Memory และ reviewed learning
+
+สถานะ: **MANUAL_NOT_RUN** สำหรับ external AI และ owner repository จริง
+
+1. ให้ AI เรียก `context_query` แล้วเสนอ `memory_propose` จาก current evidence ID
+2. ตรวจว่า `memory_search` ยังไม่คืน proposal ก่อน owner approval
+3. ใช้ `dodo memory show` ตรวจ claim, provenance, conflicts และ digest แล้ว approve
+4. เริ่ม conversation ใหม่และตรวจว่า `memory_search`/`context_query` พบ memory ที่
+   owner reviewed พร้อม `evidence_only` และ `untrusted_content`
+5. แก้ source แล้วตรวจว่า memory เป็น STALE และไม่ปรากฏใน current-only search
+6. ให้ client อื่นลองใช้ evidence ID เดิมและ memory ของ project ที่ไม่มี ACL ต้องถูกปฏิเสธ
+7. เสนอ learning จาก successful memory สองรายการ ตรวจ owner review และยืนยันว่าไม่มี
+   skill/workflow ถูกติดตั้งหรือ execute
+8. prune stale fixture แล้วตรวจว่า CURRENT memory และ project files ยังอยู่
+
+Automated fixtures ผ่าน contract หลักแล้ว แต่ยังไม่เปลี่ยนสถานะ manual จนกว่าจะใช้
+external AI และ owner-selected fixture จริง
+
+## Runtime Intelligence
+
+สถานะ: **MANUAL_NOT_RUN** สำหรับ external AI และ owner repository จริง
+
+1. เปิด runtime session แล้วเริ่ม test task แบบ `program + args` ผ่าน Compact gateway
+2. ตัด/reconnect MCP ระหว่างงาน ตรวจ session/task เดิมและไม่เกิด process ซ้ำเมื่อ retry key เดิม
+3. observe task แล้วตรวจ evidence มี status/count/hash แต่ไม่มี raw stdout/stderr หรือ secret fixture
+4. ทดสอบ cancel และ wall timeout จาก task แยกกัน
+5. สร้าง snapshot แก้ fixture ภายนอก แล้ว revalidate ต้องได้ `STALE`
+6. เปิด owned workspace browser session, collect evidence และตรวจ MCP image จริง
+7. ตรวจฐานข้อมูล runtime ไม่มี DOM, console, cookie, authorization header หรือ input value
+8. ถอน workspace ACL ระหว่าง session แล้ว handle เดิมต้องใช้ไม่ได้
+9. ใช้ `context_query` ค้น current runtime evidence และตรวจ source เป็น `dodo-runtime://...`
+10. ปิด session ขณะ task running ต้องถูกปฏิเสธ; cancel/wait แล้วจึงปิดได้
+
+Automated HTTP/OAuth/Chromium fixtures ผ่าน contract หลักแล้ว แต่ไม่ถือเป็น manual
+external-client acceptance
+
+## Advanced Agent Runtime
+
+สถานะ: **MANUAL_NOT_RUN** สำหรับ external AI และ owner repository จริง
+
+1. เปิด run พร้อม completion criteria, writable paths, explicit programs และ quota ที่แคบ
+2. สร้าง plan revision และ hypotheses สองตัว; ให้ path intents overlap แล้วต้องปฏิเสธตัวที่สอง
+3. snapshot → managed write/edit → verify → compare → rollback exact changeset
+4. ตัด/restart server ระหว่าง action แล้วตรวจ `RECOVERY_REQUIRED`; อ่าน status ก่อน recover
+5. ใช้ current Runtime evidence judge hypotheses และ complete เฉพาะเมื่อ criteria ครบ
+6. ถอน workspace ACL ระหว่าง run แล้ว handle เดิมต้องถูกปฏิเสธทันที
+7. เสนอ skill ที่มี hostile instruction ตรวจว่าหายจาก search จน owner review exact digest
+8. approve safe skill แล้วตรวจ progressive search/inspect และยืนยันว่าไม่มี code ถูกติดตั้ง/รัน
+9. เริ่ม long job แล้ว pause/cancel coordinator; job ต้องยังอยู่จน owner/caller หยุดโดย explicit handle
+10. ตรวจ audit แยก coordinator operation, target operation และ private owner review
+
+Automated HTTP/OAuth/restart/security fixtures ผ่าน contract หลักแล้ว แต่ไม่ถือเป็น
+manual external-client acceptance
+
+## HTTP Compact
+
+1. เชื่อม MCP ด้วย OAuth
+2. ตรวจ `listTools` มี 19 tools และมี `project_overview`, `dodo_discover`, gateways
+3. เรียก overview
+4. discover `write_file`
+5. สร้างไฟล์ fixture ผ่าน `dodo_write`
+6. อ่านกลับผ่าน `dodo_read`
+7. แก้ด้วย expected hash
+8. ทำ external change แล้วตรวจ conflict
+9. ลบ fixture
+
+## STDIO Full
+
+1. รัน `dodo stdio --root /absolute/fixture`
+2. ตรวจ full catalog ค่าเริ่มต้น 121 tools และไม่มี `subagent_*`
+3. ทดสอบ project overview, read, write และ edit
+
+## Sub-agent MCP exposure
+
+Automated catalog/API/Chromium/fresh-package fixtures: **AUTOMATED_PASS**
+
+1. เปิด Local Config → Settings และตรวจว่าสวิตช์ “เปิดให้ MCP clients เห็น Sub-agent tools” ปิดเป็นค่าเริ่มต้น
+2. ตรวจ Full live catalog มี 121 tools; Compact/Hybrid มี 19/49 ชื่อและ discover หา `subagent_spawn` ไม่พบ
+3. ตรวจ Chat & Tasks ยังสร้างและดูงานได้จากหน้าเว็บ
+4. เปิดสวิตช์ ยืนยันผ่าน dialog แล้วตรวจข้อความว่าต้อง restart/rescan
+5. restart fixture เท่านั้น แล้วตรวจ Full มี 125 และ Compact discover/gateway มี `subagent_spawn/status/result/control`
+6. ปิดสวิตช์อีกครั้ง restart และตรวจว่า run history ยังอยู่ แต่ MCP definitions ถูกซ่อน
+
+การ restart server จริงและ rescan ผ่าน ChatGPT/remote client จริง: **MANUAL_NOT_RUN**
+
+## Security
+
+- anonymous HTTP ต้อง 401
+- read-only token ต้องถูกปฏิเสธเมื่อเรียก write/exec
+- managed mode: client ที่ไม่มี ACL ต้องถูกปฏิเสธ; personal mode: unregistered target ต้องถูกปฏิเสธ
+- inspect mode ต้องมี owner approval
+- secret paths และ traversal ต้องถูกปฏิเสธ
+- ห้ามแสดง client secret, access token หรือ private config token
+
+## External clients
+
+เพิ่ม MCP connection ใน client ที่ต้องการ ใช้ OAuth, scan tools และบันทึกจำนวน tools ที่ client แสดงจริง หาก catalog ถูก cache ให้ recreate connection ตาม client instructions
+
+## DodoBench และ release gate
+
+Automated fixtures: รัน `npm run bench`, `npm run release:gate` บน macOS และ
+`npm run test:linux:docker` สำหรับ Linux แล้วตรวจ `gate-report.json` ใต้ ignored
+`release-evidence/` Self-hosted GitHub Actions รัน Linux Docker และ Windows native
+candidate บน trusted main/manual เท่านั้น Manual external AI, owner repository และ
+Windows 11 ต้องรายงานแยกตาม environment จริง ห้ามเปลี่ยน `MANUAL_NOT_RUN` จากผล
+automated บน macOS, Linux Docker หรือ Windows runner
+
+## AI Providers / Multi-project owner acceptance
+
+ใช้ fixture A/B แยกจาก source ของเจ้าของ ไม่ทดสอบ paid inference โดยไม่มีเจ้าของตั้ง
+credentials ผ่าน private UI ผลต้องแยกตาม provider/model/platform ไม่รวมเป็น PASS เดียว
+
+- เพิ่ม provider/model/profile ผ่านเว็บ เลือก session/Keychain และ grant project/client/egress
+- ทดสอบ synthetic inference และ tool calling ด้วยปุ่มแยก เก็บเวลา/model/ผล ไม่มี key
+- MCP caller A spawn บน A พร้อม web owner run บน B; read-back/diff/test receipts ต้องตรง
+- Read-only เขียนหรือ spawn ไม่ได้; managed mode ที่ไม่มี target ACL ถูกปฏิเสธ และ inspect ขอ approval เฉพาะ operation
+- แก้ไฟล์ภายนอกระหว่าง read/edit ต้อง conflict ไม่ overwrite
+- Pause/cancel, ปิด browser/reconnect, expiry/revoke, restart/Resume ไม่ replay side effects
+- Unknown inference/action outcome ต้องรอ review ไม่ส่งซ้ำเงียบ ๆ
+- ตรวจ Keychain dialog และ local Ollama metadata รวมกรณี cloud model บน loopback
+- ตรวจภาพจาก explicit resource paths และตอบกลับ text/tool results ไม่มี raw reasoning/key
+- ตรวจ desktop/390px/theme/keyboard, history search/delete/retention และ advanced owner controls
+
+Live OpenAI, Gemini, Claude, MiniMax, GLM, Kimi, Ollama: MANUAL_NOT_RUN สำหรับงานนี้
+จนกว่าจะมีหลักฐานจาก account/model จริง Browser automation และ synthetic Keychain
+round-trip เป็น AUTOMATED_PASS ไม่ใช้แทน MANUAL_PASS ของ provider

package/docs/MEMORY.md

@@ -0,0 +1,128 @@
+# DODO Memory and Reviewed Learning
+
+DODO Memory เก็บประสบการณ์และการตัดสินใจที่ตรวจย้อนกลับได้ เพื่อให้ AI ใช้
+บริบทเดิมต่อใน conversation ใหม่โดยไม่ยก memory ให้เป็น source of truth, permission
+หรือ policy
+
+## หลักการ
+
+- AI อ่านได้เฉพาะ memory ที่เจ้าของอนุมัติและมองเห็นใน workspace ที่ client มี
+  `dodo:read` ACL อยู่ในขณะเรียก
+- AI สร้างได้เพียง proposal จาก `context_evidence` ที่ยัง current และเป็นของ
+  principal เดียวกัน
+- การบันทึกถาวรต้องผ่าน private owner IPC ด้วย proposal ID และ digest ที่ตรงกัน
+- source hash, retention และ project readiness ถูกตรวจซ้ำเมื่อค้น ตรวจ หรือใช้เป็น
+  Context Engine evidence
+- memory ทุกชิ้นมี `authority: evidence_only` และ `trust: untrusted_content`
+- learning proposal ไม่ติดตั้ง ไม่ execute และไม่เปลี่ยน permission แม้เจ้าของกด
+  approve การ approve บันทึกผล review เท่านั้น
+
+ประเภทที่รองรับ:
+
+```text
+fact · decision · failure · successful-fix · workaround · convention · preference
+```
+
+## สร้างและอนุมัติ memory
+
+Full surface:
+
+```text
+context_query(goal="Find the session boundary", terms=["SessionStore"])
+memory_propose(
+  kind="decision",
+  claim="Keep session state scoped to one workspace.",
+  rationale="Current source evidence defines this boundary.",
+  affectedEntities=["SessionStore"],
+  evidenceIds=["evidence_..."]
+)
+```
+
+Compact/Hybrid ใช้ `dodo_assist_read → context_query` และ
+`dodo_assist_change → memory_propose` ตาม schema จาก `dodo_discover`
+
+Proposal ยังไม่เป็น memory จนกว่าเจ้าของจะตรวจผ่าน terminal:
+
+```bash
+dodo memory pending
+dodo memory show memprop_xxxxxxxxxxxx
+dodo memory approve memprop_xxxxxxxxxxxx --digest sha256:...
+```
+
+หากต้องการให้ project ที่ลงทะเบียนไว้อ่าน memory เดียวกัน เจ้าของต้องระบุ project ID
+อย่างชัดเจน:
+
+```bash
+dodo memory approve memprop_xxxxxxxxxxxx \
+  --digest sha256:... \
+  --share-with prj_2bcdefghjkmn
+```
+
+การแชร์ส่งต่อ claim และ provenance ของ memory ไปยัง project เป้าหมาย แต่ไม่ให้ ACL
+แก่ client เจ้าของยังต้องให้ `dodo:read` ใน project นั้นแยกต่างหาก
+
+## อ่าน ตรวจ และหมดอายุ
+
+```text
+memory_search(query="session workspace")
+memory_inspect(memoryId="memory_...")
+memory_status()
+```
+
+ผลค้นหาจำกัดจำนวนและ byte budget ใช้ signed cursor ที่ผูก query, active workspace
+และ principal หาก scan ถูกตัดด้วยเพดานภายในจะได้ `partial: true`
+
+เมื่อ source hash เปลี่ยน, source ใช้งานไม่ได้ หรือ retention หมด ระบบเปลี่ยนสถานะ
+เป็น `STALE` และไม่คืนรายการนั้นโดย default เจ้าของดูรายการ stale, ตรวจซ้ำ หรือล้าง
+เฉพาะข้อมูลเก่าได้:
+
+```bash
+dodo memory list --include-stale
+dodo memory reverify memory_xxxxxxxxxxxx --digest sha256:...
+dodo memory prune --older-than 30 --yes
+```
+
+`prune` ลบได้เฉพาะ proposal ที่ rejected/expired/stale และ memory ที่สร้างจาก active
+workspace ซึ่ง stale เกินอายุที่กำหนด ไม่ลบ CURRENT memory, ไม่ลบ memory ต้นทางของ
+project อื่นที่แชร์มาให้อ่าน และไม่แตะไฟล์ project
+
+## Reviewed workflow/skill learning
+
+AI เสนอ workflow หรือ skill ได้เมื่อมี memory แบบ `successful-fix`, `workaround`
+หรือ `convention` ที่ current อย่างน้อยสองรายการ:
+
+```text
+memory_learning_propose(
+  kind="workflow",
+  title="Verify repeated repair",
+  summary="Check both prerequisites before proposing the repair.",
+  steps=["Read current sources", "Run the relevant verification"],
+  memoryIds=["memory_...", "memory_..."]
+)
+```
+
+เจ้าของตรวจและบันทึกผล review ผ่าน:
+
+```bash
+dodo memory learning pending
+dodo memory learning show learning_xxxxxxxxxxxx
+dodo memory learning approve learning_xxxxxxxxxxxx --digest sha256:...
+```
+
+DODO จะไม่ติดตั้งหรือเรียก workflow/skill จากขั้นตอนนี้ การนำ proposal ไปสร้าง
+automation หรือ executable skill ต้องเป็นงานแยกที่เจ้าของสั่งภายหลัง
+
+## Security boundaries
+
+- ไม่มี MCP operation สำหรับ approve/reject/prune หรือ learning review
+- proposal text ที่ดูเหมือน credential ถูกปฏิเสธ และไม่มี raw source content ถูกเก็บ
+  เป็น claim อัตโนมัติ
+- evidence ID ใช้ข้าม client/principal ไม่ได้ และ source เปลี่ยนก่อน approval จะทำให้
+  proposal เป็น `STALE`
+- duplicate และ conflict ถูกตรวจซ้ำตอน approval; conflict ต้องใช้
+  `--allow-conflict` โดยเจ้าของอย่างชัดเจน
+- memory ID, digest, cursor, project registration และ learning proposal ไม่ใช่
+  capability และไม่ข้าม OAuth, live grant, ACL, workspace ID/epoch, trust, approval,
+  sandbox หรือ path/secret guards
+- README, repository instruction, web/tool output และ memory เองเป็น untrusted data
+  เสมอ จึงไม่สามารถสร้าง permanent instruction โดยไม่มี owner review

package/docs/MULTIMODAL.md

@@ -0,0 +1,32 @@
+# DODO Multimodal
+
+DODO รองรับภาพ เสียง วิดีโอ เบราว์เซอร์ เกม และ speech เมื่อ dependency, model และ owner permission พร้อม ระบบไม่ดาวน์โหลด model หรือเปิด device permission เองตอนติดตั้ง
+
+## Capabilities
+
+- image view และ screen observation
+- media open, extract, subtitles, search, read, jobs และ close
+- speech synthesis และ transcription ผ่าน engine ที่ owner ติดตั้ง
+- isolated browser session, observe และ action
+- game session และ step
+
+Compact surface ใช้ `dodo_media`, `dodo_browser` และ `dodo_game` ส่วน Full surface มี tool รายตัวครบ
+
+## Permission and files
+
+media path ต้องผ่าน workspace/path policy, secret guards และ regular-file checks model ต้องเป็นไฟล์ปกติที่ตรวจขนาดและ link safety แล้ว owner ต้องเลือก model path เอง
+
+browser ทำงานใน session ที่ DODO สร้างและจำกัดตาม operation policy action ใช้ observation freshness และ idempotency ไม่ retry side effect ที่ผลลัพธ์ไม่แน่นอน
+
+## Content blocks
+
+gateway ต้องส่ง MCP image/audio content blocks จาก target ต่อไปโดยไม่แปลงเป็น JSON text อย่างเดียว structured output และ `isError` ต้องคง semantics เดิม
+
+## Setup
+
+```bash
+dodo setup --check
+dodo-media-setup --check
+```
+
+เมื่อ capability ไม่พร้อม ให้ใช้ผล `NOT_SUPPORTED` และติดตั้ง dependency/model ด้วย owner action ที่ตรวจสอบแหล่งที่มาเอง

package/docs/PROJECTS.md

@@ -0,0 +1,146 @@
+# DODO Project Registry
+
+Project Registry เป็นทะเบียนโปรเจกต์ระดับ installation สำหรับเจ้าของเครื่อง ใช้
+project ID แบบ opaque และคงที่เพื่ออ้างอิงโปรเจกต์โดยไม่ใช้ path เป็น identity
+เพียงอย่างเดียว Registry ไม่ใช่ MCP tool และไม่ให้สิทธิ์แก่ AI
+
+## คำสั่ง
+
+```bash
+dodo project add /absolute/path/to/project
+dodo project add /absolute/path/to/project --name "Web application"
+dodo project list
+dodo project info prj_xxxxxxxxxxxx
+dodo project remove prj_xxxxxxxxxxxx --yes
+```
+
+ทุกคำสั่งรองรับข้อมูล local owner เท่านั้น `list`, `info` และ `add` รองรับ
+`--json`; `remove` ต้องมี `--yes` หลังตรวจ project ID และ path แล้ว
+
+## Identity
+
+- `projectId` เป็น opaque random ID และไม่เผย path
+- `workspaceId` ยังคงสร้างจาก installation identity + canonical root ตาม contract
+  เดิม และเป็น authority key สำหรับ trust/client ACL
+- Registry เก็บ canonical realpath, directory identity แบบ
+  `device + inode + birthtimeNs`, display name, metadata version และเวลา
+  created/updated การผูก birth time ป้องกัน Linux นำเลข inode เดิมกลับมาใช้กับ
+  directory ที่สร้างใหม่แล้วถูกเข้าใจผิดว่าเป็นโปรเจกต์เดิม
+- หาก directory ถูก rename ภายใน filesystem เดิม แล้วเจ้าของเรียก `project add`
+  ที่ path ใหม่ DODO จะรักษา projectId เมื่อพิสูจน์ directory generation เดิมได้
+  ครบ แต่จะใช้ workspaceId ของ path ใหม่ จึงไม่คัดลอก trust หรือ client ACL ตามไป
+
+Project Registry ปฏิเสธ filesystem ที่ไม่เปิดเผย birth time ที่เสถียร โดยไม่เดา
+identity จาก path หรือ inode เพียงอย่างเดียว Active workspace ปกติยังใช้ root policy
+เดิม; ข้อกำหนดนี้ใช้กับการเพิ่มโปรเจกต์ลง durable registry
+
+## Readiness
+
+รายการแต่ละตัวรายงานสถานะตาม filesystem ปัจจุบัน:
+
+- `ready`: canonical path และ directory identity ตรงกับที่บันทึก
+- `missing`: path เดิมหายไป
+- `symlinked`: path เดิมถูกแทนด้วย symbolic link
+- `replaced`: path เดิมชี้ไป directory identity อื่น
+- `inaccessible`: ตรวจ path/identity ไม่ได้
+- `invalid`: metadata version หรือข้อมูล registry ไม่ผ่าน validation
+- `removed`: เจ้าของนำรายการออกแล้ว แต่ history/authority ยังอยู่
+
+DODO ไม่ถือว่า `missing`, `symlinked`, `replaced`, `inaccessible` หรือ `invalid`
+พร้อมใช้งาน และไม่ย้าย authority อัตโนมัติ
+
+## Local Config
+
+หน้า Local Config แสดงรายการและ readiness เพิ่มโปรเจกต์ เปิดโปรเจกต์ที่พร้อม
+ผ่าน workspace switch lifecycle เดิม และนำรายการออกหลังยืนยันได้ API เหล่านี้
+อยู่บน listener loopback ของ Local Config เท่านั้น ใช้ private capability,
+Host/Origin checks, rate limit และ workspace/epoch headers เดิม ไม่มี route นี้บน
+MCP/public listener
+
+`dodo --cli` ใช้ registry เดียวกันสำหรับเลือกหรือเพิ่มโปรเจกต์ และบันทึก
+`startupProjectId` เป็น preference ระดับ installation ค่านี้ไม่ข้าม OAuth scope หรือ
+filesystem guards และต้อง resolve registry + ตรวจ readiness ใหม่ทุกครั้งที่เปิด server
+
+`dodo` และ `dodo start` ไม่ยึด process CWD เป็น workspace โดยอัตโนมัติอีกต่อไป:
+
+- ถ้าโปรเจกต์ที่เลือกล่าสุดยัง `ready` จะเปิด root นั้น
+- ถ้ายังไม่เลือกหรือรายการไม่พร้อม จะเปิด launcher mode โดยไม่มี active AI workspace
+- เจ้าของเลือก path แรกจาก Local Config, `dodo --cli` หรือ `dodo start --root PATH`
+- `dodo stdio --root PATH` ยังคง explicit เพราะ STDIO lifecycle ถูก client เป็นผู้สร้าง
+
+launcher mode ใช้ directory ภายใน private config เป็น resource ชั่วคราวเท่านั้น
+directory นี้ไม่ถูกส่งเป็น project root และ MCP/OAuth data plane ตอบ
+OAuth login และ authenticated catalog ใช้ได้ระหว่างยังไม่มี default workspace แต่
+ทุก operation ต้องรอ real workspace พร้อม โหมดส่วนตัวพร้อมใช้หลัง owner ลงทะเบียน
+path; โหมด managed ต้องมี owner-granted ACL เพิ่มด้วย
+
+## Read-only federation
+
+MCP อ่านโปรเจกต์ที่ลงทะเบียนไว้ได้โดยไม่เปลี่ยน active workspace ผ่าน tools เดิม:
+
+- `project_overview({projectId})`
+- `list_files({projectId, ...})`
+- `read_files({projectId, ...})`
+- `search_code({projectId, ...})`
+- `search_code({projectIds: [...]})` สำหรับค้นพร้อมกันสูงสุด 8 โปรเจกต์
+
+ใน Compact/Hybrid surface ให้ใส่ fields เหล่านี้ใน `args` ของ `dodo_read`
+ตาม schema ที่ `dodo_discover` คืนมา จำนวน tools ปัจจุบันเป็น Full 125, Compact 19
+และ Hybrid 49
+
+`project_overview()` ของ active workspace แสดง `federation.projects` เฉพาะรายการ
+ที่ client อ่านได้ โหมดส่วนตัวใช้ live `dodo:read` จาก owner-approved installation
+grant กับ registry; โหมด managed ต้องมี live target ACL เพิ่ม สำหรับ HTTP ต้องเป็น
+OAuth installation identity รุ่นปัจจุบันด้วย Legacy workspace-bound grant ใช้ข้าม
+โปรเจกต์ไม่ได้ ส่วน local STDIO เป็น owner process
+
+ทุก target ถูกตรวจซ้ำก่อนอ่าน:
+
+1. project ID ต้องมาจาก owner registry
+2. canonical path และ directory identity ต้องมีสถานะ `ready`
+3. grant ต้องไม่ถูก revoke และต้องมี `dodo:read`; managed mode ตรวจ target ACL เพิ่ม
+4. shared ignore/path/secret policy ของ target ถูกสร้างใหม่จาก global policy
+5. request ยังต้องใช้ active workspace ID/epoch ที่ถูกต้อง
+
+ผล federated มี target project ID, workspace ID, federation epoch และ source hash
+แยกจาก envelope ของ active workspace การค้นหลายโปรเจกต์ใช้ quota รวมแบบ bounded;
+target ที่ owner อนุญาตแต่ unavailable ถูกระบุเป็น partial failure ส่วน target ที่
+ไม่มี authority ตาม access mode ปัจจุบันทำให้ทั้ง request ถูกปฏิเสธและไม่เผย path/metadata
+
+Federation นี้ไม่เปลี่ยน `process.cwd()` หรือ default workspace สำหรับ write/exec
+ข้ามโปรเจกต์ใช้ `targetProjectId` แยกจาก read federation ตามหัวข้อถัดไป
+
+## การนำรายการออก
+
+`dodo project remove` เป็น soft removal ของ registry metadata เท่านั้น ระบบไม่ลบ:
+
+- ไฟล์หรือ directory ของโปรเจกต์
+- workspace history, changesets หรือ audit เดิม
+- trust mode หรือ client ACL
+- OAuth installation identity, clients หรือ grants
+
+การเพิ่ม canonical root เดิมภายหลังจะได้ project ID ใหม่ แต่ workspace authority
+ยังเป็นไปตาม workspace identity contract เดิม
+
+## ขอบเขต
+
+หนึ่ง process มี default workspace หนึ่งตัว และ runtime เป้าหมายแยกกันได้สูงสุด
+16 secondary projects Owner เพิ่ม path เท่านั้น ไม่มีการค้นทั้งเครื่องอัตโนมัติ
+
+## Explicit target routing
+
+Full/Compact รับ `targetProjectId` ระดับบนร่วมกัน เรียก overview ของ target เพื่อรับ
+workspace ID/epoch ก่อนอ่าน/เขียน/รัน การเลือก runtime เกิดก่อน target scope/context
+และ managed ACL checks; client ที่ไม่มีสิทธิ์ default ยังได้รับรายชื่อเฉพาะ projects ที่ได้รับอนุญาต
+เพื่อเลือก target ได้ การไม่ส่ง target คง default behavior เดิม ห้ามผสม target กับ
+`projectId/projectIds` และห้าม nested target/context ใน gateway args
+
+Runtime แต่ละตัวมี epoch, services, workers, jobs, trust และ resource ownership ของตัวเอง
+ถือ private project lease ก่อน bootstrap/recovery และตรวจ readiness ใหม่ก่อน acquire
+Job/agent/request ที่ยังใช้อยู่ทำให้การปิด/ถอด project ถูกปฏิเสธ งาน mutation ทั้งจาก
+MCP/agent/schedule ใช้ queue เดียวต่อ project; command ถือ queue จน job จบ อ่านขนานได้
+และแต่ละ project รันพร้อมกันได้ Hash ยังตรวจตอนถึง queue เพื่อป้องกัน external edits
+
+Projects ในเว็บเลือกหน้าจอแยกจากการตั้ง default Personal mode ใช้ trusted policy กับ
+registered projects โดยตั้งใจ ส่วน managed mode ไม่คัดลอก trust/ACL/approval/run
+override ระหว่าง projects คู่มือ AI/profile permission อยู่ที่ [AI Providers](AI_PROVIDERS.md)