dodo-mcp 1.0.0

package/docs/ASSISTANCE.md

@@ -0,0 +1,31 @@
+# DODO Task Assistance
+
+DODO มี tools สำหรับช่วยทำความเข้าใจงานก่อนแก้ไข code และตรวจผลหลังแก้ โดยทุก operation ยังอยู่ภายใต้ workspace, scope, trust และ approval policy
+
+## Capabilities
+
+- `context_for_task`: รวบรวมไฟล์และสัญลักษณ์ที่เกี่ยวข้องแบบ bounded
+- `analyze_impact`: วิเคราะห์ references และผลกระทบที่คาดได้
+- `read_symbol`: อ่าน definition และ context ของ symbol
+- `preview_refactor`: สร้างแผน refactor แบบ preview-only
+- `verify_changes`: ตรวจ diff, diagnostics, tests และ recipe ตาม policy
+
+## Compact usage
+
+ใช้ `dodo_discover` ค้น operation แล้วเรียก `dodo_assist_read` หรือ `dodo_assist_change` โดยใส่ args ตาม schema ที่ discover คืนมา
+
+Preview ไม่ apply เอง และ verify ที่รัน command ยังคงใช้ exec scope, trust, sandbox และ approval ของ target operation
+
+## Safe workflow
+
+```text
+project_overview
+→ context_for_task
+→ analyze_impact
+→ read_symbol
+→ preview_refactor
+→ owner reviews changes
+→ verify_changes
+```
+
+ผล assistance เป็นข้อมูลประกอบการตัดสินใจ ไม่ใช่ permission และไม่สามารถขยาย workspace scope ได้

package/docs/AUTH.md

@@ -0,0 +1,59 @@
+# DODO MCP — Authentication
+
+## MCP OAuth
+
+MCP HTTP ใช้ OAuth 2.1 authorization code + PKCE S256:
+
+1. client discover protected resource metadata
+2. client discover authorization server metadata
+3. owner registers static client ใน Local Config/CLI
+4. client เริ่ม authorize พร้อม exact redirect URI และ PKCE
+5. owner ตรวจ interaction และ approve ผ่าน `dodo auth approve` จาก directory ใดก็ได้
+6. client แลก code เป็น access token
+7. login สร้าง installation identity และ scope ceiling
+8. โหมดส่วนตัวใช้ scope นี้กับทุกโปรเจกต์ที่ owner ลงทะเบียน; โหมด managed ให้ owner เพิ่ม client access แยกต่อโปรเจกต์
+9. ทุก MCP request ตรวจ token, scope, resource audience, installation identity, access mode และ target policy ปัจจุบัน
+
+ไม่มี dynamic client registration เป็นค่าเริ่มต้น และไม่มี client-credentials flow สำหรับ owner tools
+
+## Scopes และ access mode
+
+OAuth scope เป็นเพดานความสามารถระดับกว้าง:
+
+- `dodo:read` อ่าน/วิเคราะห์
+- `dodo:write` แก้ resource ที่ policy อนุญาต
+- `dodo:exec` รัน command/job หรือ effectful operation ที่ policy อนุญาต
+
+ค่าเริ่มต้น `personal` เหมาะกับเครื่องเจ้าของคนเดียว: client ที่ owner อนุมัติใช้
+โปรเจกต์ที่ owner ลงทะเบียนได้ตาม scopes โดยไม่ต้องสร้าง workspace ACL ซ้ำ และ
+effective trust เป็น `trusted` ส่วน `managed` ใช้ intersection ของ OAuth scope,
+workspace ACL และ trust ต่อโปรเจกต์ Profile ลด scopes ได้เสมอและเพิ่มสิทธิ์ไม่ได้
+
+ทั้งสองโหมดยังคงตรวจ workspace ID/epoch, path/secret/link guards, expected hash,
+idempotency, live grant/revocation และ command sandbox การ revoke grant ทำให้ request
+ใหม่ถูกปฏิเสธ และ resource handle ที่ sensitive ต้อง re-check ตาม service contract
+
+OAuth client registration, pending consent, approve, deny และ revoke เป็นระดับ installation
+ไม่ขึ้นกับ CWD หรือโปรเจกต์ที่หน้าเว็บกำลังเลือก `tools/list` จึงใช้เชื่อมต่อและ scan
+catalog ได้ก่อนเลือก default project ใน personal mode โปรเจกต์พร้อมใช้ทันทีหลัง owner
+ลงทะเบียน path; managed mode จะได้ `WORKSPACE_ACCESS_REQUIRED` จนกว่า owner ให้ ACL
+
+## Local Config owner auth
+
+Local Config ใช้ capability token ที่ส่งผ่าน fragment/secure local flow ไม่ส่ง token ให้ server ใน query string ระบบตรวจ loopback bind, Host/Origin, forwarded headers, expiration และ rate limit
+
+อย่าใส่ URL ที่มี token ใน chat, issue, log หรือ screenshot
+
+## Workspace switch
+
+OAuth login และ installation identity คงอยู่ได้ แต่ target authority และ workspace
+context ถูกประเมินใหม่เมื่อ active/default workspace เปลี่ยน Client ต้องเรียก
+`project_overview` เพื่อรับ ID/epoch ใหม่
+
+## Troubleshooting
+
+- 401: ตรวจ OAuth discovery และ token
+- workspace access required: เพิ่ม target ลง Project Registry; ถ้าใช้ managed mode ให้ owner เพิ่ม client ACL ด้วย
+- stale workspace: เรียก overview ใหม่หลัง restart/switch
+- approval required: ตรวจ pending approval และอนุมัติ exact digest จาก terminal
+- redirect mismatch: ลงทะเบียน callback แบบ exact string

package/docs/BRAIN.md

@@ -0,0 +1,92 @@
+# DODO Project Brain
+
+Project Brain เป็น index โครงสร้าง project ที่สร้างใหม่ได้จาก source ปัจจุบัน เพื่อให้
+AI ค้น symbols, references, imports/exports, routes, tests และ dependencies ได้โดยไม่
+ต้องอ่านทุกไฟล์ใหม่ทุกครั้ง รุ่น 1 รองรับ TypeScript, TSX, JavaScript, JSX และ
+dependency metadata ใน `package.json`
+
+## การใช้งาน
+
+Full surface เรียก operation รายตัว:
+
+```text
+project_overview()
+brain_status(workspaceId=..., workspaceEpoch=...)
+brain_query(workspaceId=..., workspaceEpoch=..., query="UserService", nodeTypes=["symbol"])
+brain_symbol(workspaceId=..., workspaceEpoch=..., uri="symbol://...")
+```
+
+Compact/Hybrid ใช้ gateway เดิม:
+
+```text
+dodo_discover(operation="brain_query")
+dodo_assist_read(operation="brain_query", args={query:"UserService"})
+dodo_assist_change(operation="brain_rebuild", args={mode:"incremental",waitMs:10000})
+```
+
+Maintenance operations มี `brain_rebuild`, `brain_pause` และ `brain_cancel` ทั้งหมด
+ต้องใช้ `dodo:exec` และยังผ่าน trust/approval policy ของ target operation
+
+## Incremental model
+
+Indexer ทำงานหลัง bootstrap และ refresh เป็นช่วงแบบ bounded:
+
+1. เดินไฟล์ผ่าน shared ignore/path policy
+2. เทียบ size, mtime และ ctime กับ cache
+3. snapshot UTF-8 source พร้อมตรวจ file identity และ SHA-256
+4. parse เฉพาะ content ที่ cache key ไม่ตรง
+5. คำนวณ source ที่ได้รับผลจาก imports และ symbol references
+6. commit cache, nodes, edges, run metrics และ freshness ใน transaction เดียว
+
+cache key ประกอบด้วย content SHA-256, parser version, graph schema version และ config
+hash การย้ายไฟล์แบบ exact-content ใช้ stable file identity เดิม ทำให้ symbol URI คงเดิม
+แม้ path เปลี่ยน แต่ copy ที่ยังมี source เดิมอยู่จะได้ identity ใหม่
+
+ไฟล์ใหญ่เกิน 512 KiB, generated/ignored output และไฟล์เกิน bounded semantic file
+limit จะไม่ถูก parse สถานะและ metrics บอกจำนวน scanned, parsed, reused, moved,
+removed, skipped และ affected files ตาม run ล่าสุด
+
+## Graph contract
+
+Node types:
+
+- `file`
+- `symbol`
+- `route` — syntax heuristic พร้อม evidence label
+- `test` — `describe`/`it`/`test` syntax heuristic
+- `dependency`
+
+Edge types:
+
+- `contains`
+- `imports`, `exports`, `dynamic_import`
+- `references`
+- `depends_on`
+
+ทุก node/edge มี source path, source SHA-256, parser/schema version และ freshness
+route/reference ที่เป็น heuristic จะระบุใน details และไม่ถูกยกระดับเป็นข้อสรุป runtime
+
+## Freshness และ recovery
+
+`brain_query` ตัด stale/missing row ออกโดย default ใช้ `includeStale:true` เมื่อ
+ต้องการวิเคราะห์ drift โดยผลจะระบุ `freshness` ชัดเจน `brain_symbol` รับ URI เฉพาะ
+namespace ของ project ปัจจุบัน
+
+เมื่อพบ interrupted run, parser/schema/config mismatch หรือ row ที่ parse ไม่ได้ ระบบ
+mark state ตามจริงและ queue full rebuild committed index เดิมไม่ถูกลบก่อน graph ใหม่
+พร้อม การ cancel จะยกเลิก worker/run ก่อน transaction commit
+
+## Security contract
+
+- ไม่มี source, plugin, package script หรือ LSP executable จาก repository ถูก execute
+- `.env`, credential/private DODO state, traversal, symlink และ hardlink ถูก shared
+  WorkspaceFS policy ปฏิเสธ
+- index/URI ไม่ให้สิทธิ์ ทุก query ตรวจ live OAuth grant, client, workspace ACL, scope,
+  workspace ID/epoch และ current source hash ซ้ำ
+- cursor ใช้ HMAC และผูก query, workspace กับ principal; หมดอายุใน 10 นาที
+- graph ไม่คัดลอกข้าม workspace และ service ถูกปิดเมื่อ runtime workspace เปลี่ยน
+- repository config และ AGENTS.md ไม่สามารถเพิ่ม permission หรือเปิด parser provider
+
+Project Brain ไม่ใช่ OS sandbox และไม่ได้สรุป architectural decision หรือ execute
+refactor เอง การแก้ source ยังต้องใช้ file/change tools พร้อม expected hash, journal,
+approval และ rollback ตามเดิม

package/docs/COMPATIBILITY.md

@@ -0,0 +1,92 @@
+# DODO MCP — Compatibility
+
+## Supported baseline
+
+| Area | Contract |
+|---|---|
+| Node.js | ใช้เวอร์ชันที่ package ระบุใน `engines` |
+| 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 จริง |
+| MCP HTTP | OAuth protected MCP endpoint ที่ `/mcp` |
+| MCP STDIO | Full surface เป็นค่าเริ่มต้น |
+| Local Config | loopback owner control เท่านั้น |
+| Cloudflare Tunnel | `dodo start`/Local Config ใช้ run-scoped token และ child `cloudflared`; Tunnel จริงยังเป็น manual gate |
+| Package | `dodo-mcp` |
+| CLI | `dodo` |
+
+Project Registry ใช้ได้ผ่าน `dodo project add/list/info/remove` และ private Local
+Config โดยไม่เปลี่ยนพฤติกรรม `dodo start --root PATH` หรือ single-workspace STDIO
+
+Read-only multi-project federation ใช้ tools เดิมโดยเพิ่ม optional `projectId` ใน
+overview/list/read/search และ `projectIds` สูงสุด 8 รายการใน search จึงไม่เปลี่ยน
+จำนวนหรือชื่อ tool ของ Full/Compact/Hybrid HTTP remote client ต้องมี installation
+identity และ `dodo:read` ACL ในทุก target; STDIO local owner ใช้ registry เดียวกัน
+Effectful tools และ jobs ยังทำงานใน active workspace เดียว
+
+## Tool surfaces
+
+- HTTP default: Compact 19 tools
+- STDIO default: Full 121 tools; เปิด Sub-agent MCP exposure แล้วเป็น 125
+- explicit Hybrid: 49 tools
+
+Complete capability schema มี 125 operations ค่าเริ่มต้น `exposeSubagentsToMcp=false`
+ซ่อน `subagent_spawn/status/result/control` จาก MCP เท่านั้น หน้าเว็บ Chat & Tasks ยัง
+ใช้ได้ Compact/Hybrid คงจำนวน 19/49 tool names แต่กรอง operation enum, instructions
+และ discover index ให้ตรงกับ live runtime หลังเปลี่ยนค่าต้อง restart และให้ client
+โหลด catalog ใหม่
+- explicit override: `--tools compact|full|hybrid`
+
+Surface เปลี่ยนจำนวน tools ที่ expose เท่านั้น ไม่เปลี่ยน permission หรือ security policy
+
+Project Brain รุ่นแรกใช้ bundled TypeScript 5.9 AST provider สำหรับ TypeScript,
+TSX, JavaScript และ JSX พร้อมอ่าน dependency metadata จาก `package.json` ภาษาอื่น
+ยังใช้ semantic/LSP tools เดิม และ Project Brain จะไม่อ้างว่ามี parser graph หากยัง
+ไม่มี provider ที่ประกาศรองรับ
+
+Context Engine ใช้ lexical/Project Brain/Git สำหรับ active workspace, guarded lexical
+federation สำหรับ project อื่น, owner-reviewed current Memory และ caller-scoped current
+Runtime Intelligence evidence ตาม live ACL Runtime process ใช้ executable/sandbox
+support ของ JobManager ปัจจุบัน ส่วน browser evidence ต้องมี Playwright Chromium และ
+owned browser session เดิม Compact/Hybrid ยังคง 19/49 tools
+
+Advanced Agent Runtime ใช้ SQLite และ invocation pipeline เดิมทุก platform Managed
+exec ต้องใช้ explicit argv และ executable ที่ JobManager รองรับ ส่วน browser/desktop/
+media/workflow ขึ้นกับ optional capability ของ platform เช่นเดิม
+
+## Optional capabilities
+
+Desktop, browser, media, speech, LSP และ OS sandbox ต้องตรวจ dependency และ OS permission ด้วย `dodo setup --check` หรือ `dodo doctor` ระบบจะรายงาน `NOT_SUPPORTED` เมื่อ environment ยังไม่พร้อม และจะไม่เปิด permission หรือดาวน์โหลด model โดยอัตโนมัติ
+
+`dodo setup --plan` ใช้ตรวจขั้นตอนติดตั้งแบบ read-only ส่วน installer ต้องมี `--yes` การใช้ `--import-state` รองรับเฉพาะ config ตำแหน่งมาตรฐานและนำเข้า non-authority preferences เท่านั้น custom `DODO_CONFIG_DIR` ไม่ถูกค้นหรือ merge อัตโนมัติ
+
+`dodo setup --components cloudflared` ตรวจ executable ได้ทุก OS การติดตั้งอัตโนมัติในรุ่นนี้รองรับ Homebrew บน macOS ส่วน Linux/Windows ใช้ signed official package ที่เจ้าของติดตั้งเอง เส้นทางหลักรับ run-scoped token จาก hidden terminal prompt หรือ owner-only Local Config และไม่ใช้ credential store; env/file/OS references คงอยู่เฉพาะ advanced compatibility commands
+
+## Client behavior
+
+Remote clients อาจ cache tool catalog ต้องใช้ refresh หรือ recreate connection ตามพฤติกรรมของ client หลังเปลี่ยน surface หรือ schema
+
+## Security boundary
+
+Directory guard ไม่ใช่ OS sandbox, repository instructions ไม่มีอำนาจเพิ่มสิทธิ์ และ trusted commands ใช้สิทธิ์ OS ของผู้ใช้จริง
+
+## Evaluation evidence
+
+DodoBench local fixture ใช้ยืนยัน contract บน platform/revision ที่ report ระบุเท่านั้น
+ผลของ macOS ไม่แทน Linux และ Linux Docker ไม่แทน Windows native Release gate ต้องมี
+หลักฐาน macOS local และ Linux Docker ที่ revision/lock digest ตรงกัน Docker image
+ติดตั้ง Playwright Chromium เพื่อรัน browser case จริง Dedicated self-hosted GitHub
+Actions รัน Linux Docker และ Windows native candidate เฉพาะ trusted main/manual
+Windows manual acceptance ยังคง `MANUAL_NOT_RUN` จนกว่าจะทดสอบบน Windows 11 จริง
+
+## AI Providers / Multi-project
+
+Full เพิ่ม `subagent_spawn/status/result/control` เป็น 125 tools Compact ยังคง 19 และ
+Hybrid 49 โดยใช้ assist gateways เดิม Full/Compact รองรับ optional `targetProjectId`
+STDIO default ยัง Full; HTTP default ยัง Compact Refresh/recreate MCP app ตาม client
+เพื่อรับ schema ใหม่ รัน `project_overview` ใหม่ก่อนใช้ epoch หลัง restart
+
+Protocol fixtures ครอบคลุม Responses, Gemini Interactions, Anthropic, Chat Completions
+และ Ollama Native ทั้งเจ็ด presets ซึ่งไม่เท่ากับ live API/model compatibility ของแต่ละ
+account Session credentials ใช้ได้โดยไม่ต้อง Keychain; persistent Keychain ตรวจบน macOS
+Linux Docker และ live providers ต้องดูผลแยกใน TEST_REPORT ไม่ใช้ผล macOS แทน

package/docs/CONFIRMATION.md

@@ -0,0 +1,13 @@
+# DODO Confirmation and Approvals
+
+DODO ใช้ permission จาก OAuth connection, workspace ACL, trust mode และ local approval ของ owner เป็นหลัก ไม่มี approval แบบรวมที่ทำให้ทุก operation ผ่านได้
+
+Effectful operations ใน `inspect` ต้องสร้าง pending approval ที่ผูกกับ target tool, action, workspace, epoch, policy version, digest และ expiration เจ้าของต้องตรวจรายการและ approve exact request ผ่าน Local Config หรือ CLI
+
+```bash
+dodo pending
+dodo approve REQUEST_ID
+dodo deny REQUEST_ID
+```
+
+Gateway ใช้ approval ของ target operation ไม่ใช่ approval เดียวของ gateway และการเปลี่ยน workspace/revoke access ทำให้ approval เก่าถูกปฏิเสธ

package/docs/CONTEXT.md

@@ -0,0 +1,87 @@
+# DODO Context Engine
+
+Context Engine ช่วยให้ AI ขอข้อมูลตามเป้าหมายและ byte budget โดยไม่ต้องเลือก
+เครื่องมือค้นหาระดับล่างทุกตัวเอง ระบบรวม lexical search, Project Brain, Git,
+owner-reviewed Memory และ read-only project federation แล้วคืนหลักฐานที่ตรวจย้อนกลับได้
+
+## เริ่มใช้งาน
+
+Full surface:
+
+```text
+context_query(
+  goal="Fix login callback",
+  terms=["loginCallback", "OAuth"],
+  projects=["Frontend", "Backend"],
+  budget=24000,
+  maxItems=24
+)
+```
+
+Compact/Hybrid surface:
+
+```text
+dodo_discover(operation="context_query")
+dodo_assist_read(operation="context_query", args={...})
+```
+
+`projects` รับ project ID, workspace ID, exact display name หรือ `active` ได้สูงสุด
+8 รายการ รายการว่างหมายถึง active workspace เท่านั้น Project Registry ไม่ได้ให้
+สิทธิ์เอง ทุก target ต้องมี live `dodo:read` ACL ของ client ก่อน
+
+## Evidence contract
+
+ผลลัพธ์แยกข้อมูลเป็นห้ากลุ่มเสมอ:
+
+- `FACT` — โครงสร้างที่ parser ระบุและตรวจ source hash แล้ว
+- `OBSERVATION` — ข้อความ source/test/docs/config หรือ Git metadata ที่อ่านโดยตรง
+- `MEMORY` — owner-reviewed memory ที่ยัง current และ source evidence ยังตรวจได้
+- `INFERENCE` — ความสัมพันธ์หรือ syntax heuristic ที่ยังต้องยืนยัน
+- `HYPOTHESIS` — ว่างจนกว่าจะมีระบบสร้างสมมติฐานโดยมีหลักฐานรองรับ
+
+แต่ละ record มี project/workspace identity, source kind, opaque resource URI,
+relative path, SHA-256, line, commit (ถ้ามี), confidence, ranking reasons,
+`generatedAt`, `lastVerifiedAt`, freshness และข้อจำกัด Source text ทุกชนิดมี
+`trust: untrusted_content`; README, repository instruction, tool output หรือผลค้นหา
+ไม่สามารถเพิ่ม permission หรือเปลี่ยน policy ได้
+
+ใช้ `context_evidence(evidenceId=...)` เพื่อตรวจหลักฐานชิ้นเดิมอีกครั้ง ระบบตรวจ
+OAuth/grant/client ACL และ source hash ปัจจุบันใหม่ทุกครั้ง หาก source เปลี่ยนจะคืน
+`freshness: stale` โดยไม่อ้างว่าเนื้อหาเดิมยังเป็นปัจจุบัน Evidence ID, source URI,
+hash และ cursor ไม่ใช่ bearer capability
+
+## Ranking, budget และ cursor
+
+Ranking เป็น deterministic ภายใต้ query, ACL และ source/index version เดียวกัน
+โดยให้เหตุผลต่อ record เช่น parsed graph entity, source/test/docs category และ
+literal term match ระบบส่งเฉพาะ evidence ที่พอดีกับ budget, จำกัด candidate/result,
+ตัด excerpt แบบ UTF-8 safe และคืน signed cursor เมื่อยังมีผลต่อ Cursor ผูก query,
+index version, active workspace และ principal และหมดอายุภายใน 10 นาที
+
+ระบบไม่ dump repository ทั้งก้อน Runtime provider อ่านเฉพาะ current bounded evidence
+ของ caller ใน active workspace ส่วน graph/runtime ของ federated project ที่ยังไม่เปิด
+จะแสดง `unavailable`/`partial` และ limitation ตามจริง
+
+## Cache L0–L6
+
+Context cache แยกขั้นตั้งแต่ normalized plan (`L0`) ถึง ranked final context (`L6`)
+และผูก active workspace, principal และ query hash ทุกชั้นที่อาศัย source เก็บ
+dependency path/hash ก่อนใช้ `L6` ซ้ำ ระบบ re-authorize target และตรวจ hash ทุก
+dependency หากเปลี่ยนจะลบ derived cache `L1–L6`, mark evidence เดิมเป็น stale และ
+สร้างผลใหม่ `L0` ไม่เก็บ source content ที่เป็น authority
+
+Cache มีอายุ 10 นาทีและจำกัด 140 rows ต่อ principal/workspace Evidence มีอายุ
+24 ชั่วโมงและจำกัด 1,000 rows `context_status` แสดงจำนวน cache/evidence, hit rate,
+latency และ source availability แบบไม่มี query text, path, content, token หรือ owner
+state ผล query แสดง term coverage และจำนวน source kinds เพื่อให้วัด retrieval quality
+ของ fixture เดิมซ้ำได้
+
+## ขอบเขตปัจจุบัน
+
+- semantic graph ใช้ Project Brain ของ active workspace; project อื่นใช้ guarded
+  lexical federation และระบุ graph ว่า partial
+- Git history ใช้ active workspace เท่านั้น
+- memory retrieval รับเฉพาะ owner-reviewed CURRENT records และตรวจ source/retention;
+  runtime evidence ไม่มี current row หรือ source recheck ไม่ผ่าน และไม่ถูกสร้างขึ้นแทน
+- context เป็นข้อมูลช่วยตัดสินใจ ไม่ใช่สิทธิ์เขียน/รันคำสั่ง การแก้ไขยังต้องผ่าน
+  target tool, workspace ID/epoch, scope, trust, approval, hash และ path/secret guard

package/docs/DESKTOP.md

@@ -0,0 +1,35 @@
+# DODO Desktop Access
+
+Desktop tools ทำงานกับ application ที่เจ้าของอนุญาตแบบ explicit เท่านั้น ระบบไม่เปิด Screen Recording, Accessibility, microphone หรือ system audio permission เอง
+
+## Operations
+
+- `desktop_status`
+- `desktop_windows`
+- `desktop_capture`
+- `desktop_accessibility`
+- `desktop_action`
+
+ใน Compact surface ใช้ `dodo_desktop_view` และ `dodo_desktop_control`
+
+## Permission flow
+
+1. ตรวจด้วย `dodo setup --check`
+2. ให้ OS permission เองตาม platform
+3. เพิ่ม app identifier แบบ exact ผ่าน Local Config หรือ CLI หากใช้ `--persist` จะจำครั้งเดียวระดับ DODO installation และใช้ต่อได้ทุกโปรเจกต์
+4. เรียก status/view ก่อน action
+5. ทุก action ต้องใช้ target scope, owner permission, trust และ approval ตาม policy
+
+Desktop action เป็น effectful operation ใช้ idempotency และ observation freshness เพื่อป้องกัน action กับหน้าต่างที่เปลี่ยนไปแล้ว หากผลลัพธ์ไม่แน่นอน ระบบไม่ retry เอง
+
+```bash
+dodo desktop allow --app com.google.Chrome --mode control --persist --yes
+```
+
+คำสั่งนี้รันจาก path ใดก็ได้ สิทธิ์ Screen Recording/Accessibility ของ macOS ยังเป็น
+สิทธิ์ระดับ OS ที่เจ้าของต้องอนุญาตเอง Persistent consent ไม่ข้าม OAuth `dodo:exec`,
+workspace ID/epoch, current snapshot, idempotency หรือ app allowlist
+
+## Limitations
+
+ถ้า backend หรือ permission ไม่พร้อม ระบบตอบ `NOT_SUPPORTED`/permission error ตามจริง ไม่รายงานว่าควบคุม desktop ได้เพียงเพราะมี executable ติดตั้งอยู่

package/docs/EVALUATION.md

@@ -0,0 +1,86 @@
+# DodoBench และ Release Gate
+
+DodoBench เป็นชุดประเมินแบบ deterministic สำหรับ source checkout ของ DODO MCP
+ใช้ fixture แยกและเรียก HTTP + OAuth + Compact gateways จริง โดยไม่จำลองชั้น
+authorization หรือ policy ผลจึงบอกได้ว่า contract หลักยังทำงานร่วมกัน แต่ไม่ใช่
+คะแนนความสามารถของโมเดล AI และไม่ใช่ production latency SLA
+
+## สิ่งที่วัด
+
+Baseline `benchmarks/dodobench-core-v1.json` ครอบคลุม:
+
+- retrieval ข้ามโปรเจกต์ที่ client มี ACL และ context cache hit
+- diagnosis/edit ที่แก้เฉพาะไฟล์เป้าหมายด้วย expected hash
+- runtime task, test-report evidence และ diagnosis
+- binary resource และ MCP image content block
+- durable Agent Runtime หลัง server restart
+- anonymous OAuth, read-only scope, secret path, stale epoch และ inspect approval
+- browser screenshot แบบ optional เมื่อมี Playwright Chromium
+
+รายงานมี success rate, wrong-file edit rate, context precision/recall, cache hit,
+จำนวน tool calls, serialized request/response bytes, latency, human intervention และ
+security violations ค่า `modelTokens` เป็น `null` เสมอ เพราะ suite นี้ไม่เรียกโมเดล
+และไม่เดาจำนวน token
+
+```bash
+npm run bench
+node scripts/dodo-bench.mjs --output release-evidence/1.0.0/dodobench.json
+```
+
+ทุก report ผูกกับ Git revision, dirty state, dataset version/digest, Node/OS/arch,
+`package-lock.json` digest และ configuration digest ผลจาก revision หรือ lock คนละชุด
+จึงไม่ควรนำมาเทียบเป็น baseline เดียวกันโดยไม่ตรวจ metadata
+
+## Candidate release gate
+
+```bash
+npm run release:gate
+```
+
+คำสั่งนี้รัน build, typecheck, lint, test suite, DodoBench, production dependency
+audit, immutable `npm pack` manifest/checksum และ fresh exact-tarball smoke ซึ่งตรวจ
+`dodo --version`, STDIO Full 125 tools, Streamable HTTP + OAuth Compact 19 tools และ
+write → read → edit → read-back ผ่าน Compact gateway
+
+หลักฐาน non-secret ถูกเขียนใต้ `release-evidence/<version>/` ซึ่งถูก ignore ทั้ง Git
+และ npm package สคริปต์ไม่ publish npm, ไม่แก้ tunnel/DNS และไม่แตะ owner state จริง
+
+## Platform gates
+
+macOS รันจาก owner checkout ส่วน Linux gate เดียวกันรันได้ทั้ง local Docker และ
+dedicated self-hosted GitHub Actions runner:
+
+```bash
+# macOS บน checkout ปัจจุบัน
+npm run release:gate
+
+# Linux จริงใน Docker image แยก พร้อม Playwright Chromium
+npm run test:linux:docker
+```
+
+Docker build ไม่รับ `.git`, `.npmrc`, `.env`, model, release evidence หรือเอกสารพัฒนา
+private เข้า build context ตัว runner ส่งเฉพาะ revision/dirty state ที่อ่านจาก host Git
+เข้า release gate และ DodoBench ผ่าน environment attestation ที่รับได้เฉพาะใน Linux
+container จากนั้นตรวจ report กลับว่าตรงกับ revision และ lock digest เดิม
+
+`.github/workflows/platform-gates.yml` ใช้ self-hosted labels `linux-ci` และ
+`windows-ci 02` ทดสอบ Node 22/24 เฉพาะ push ที่ `main` กับ manual dispatch ไม่มี
+`pull_request` trigger เพราะ repository เป็น public และ untrusted PR ต้องไม่ execute
+บนเครื่อง runner ของเจ้าของ Actions dependencies ถูก pin ด้วย commit SHA และ token
+มีเพียง `contents: read`
+
+`npm run release:gate:strict` ต้องใช้ source ที่ clean และมี macOS/Linux evidence จาก
+revision กับ `package-lock.json` เดียวกัน Windows ถูกระบุเป็น
+`DEFERRED_MANUAL_NOT_RUN` และไม่ถูกนับเป็น supported release platform ในช่วงนี้
+Manual external-AI, owner workspace และ Windows 11 อยู่แยกเป็น `MANUAL_NOT_RUN`
+Strict gate รับ Linux evidence เฉพาะ `docker-host-git` จาก clean checkout พร้อม
+fresh-install PASS จึงไม่รับ candidate ที่มี uncommitted source หรือ report จาก runner
+ชนิดอื่น Report บันทึก origin ว่ามาจาก local หรือ GitHub Actions ตามจริง ไม่มีคำสั่ง
+เหล่านี้ publish npm
+
+## Security invariants
+
+Benchmark และ release gate ไม่มีสิทธิ์พิเศษ ไม่มีทาง approve action, เพิ่ม ACL/trust,
+ปิด sandbox, เปิด network/desktop หรืออ่าน secret paths ทุก operation ผ่าน target tool
+definition และ security pipeline เดิม ผล benchmark ที่ผ่านไม่สามารถลด policy หรือ
+แทน manual/platform evidence ได้

package/docs/LARGE_INPUTS.md

@@ -0,0 +1,21 @@
+# DODO Large Coding Inputs
+
+DODO รองรับคำสั่ง, patch และไฟล์ที่มีขนาดใหญ่ขึ้นด้วย bounded budgets และ temporary files ที่อยู่ภายใต้ workspace policy
+
+## Configuration
+
+```bash
+dodo limits --profile large
+```
+
+การเปลี่ยน limits มีผลหลัง restart process และไม่เปลี่ยน OAuth, ACL, trust, sandbox หรือ secret policy
+
+## Safety
+
+- input และ output มี byte budget แยกกัน
+- command ใช้ argv ที่ผ่าน length checks
+- file write ใช้ expected hash และ journal
+- temporary content ไม่ถูกแสดงใน audit โดยอัตโนมัติ
+- repository config และ AGENTS.md ตั้ง limit หรือ grant สิทธิ์เพิ่มไม่ได้
+
+ใช้ limits สูงเมื่อจำเป็นและตรวจ diff ก่อน apply ทุกครั้ง

package/docs/LSP.md

@@ -0,0 +1,21 @@
+# DODO Language Server Integration
+
+DODO มี TypeScript/JavaScript intelligence ในตัวและรองรับ language server เพิ่มเติมที่เจ้าของติดตั้งเอง
+
+## Register a server
+
+```bash
+dodo lsp add python --command pyright-langserver --args --stdio --ext .py --ext .pyi
+dodo lsp list
+dodo lsp remove python
+```
+
+DODO start process ของ language server ด้วย argv ที่ระบุ, environment ที่ scrubbed และ workspace root ที่ตรวจแล้ว ไม่มี shell expansion จาก input ของ AI
+
+## Lifecycle
+
+LSP เปิดเมื่อ operation ต้องใช้และปิดเมื่อ workspace shutdown/switch ระบบมี initialization/progress gate และทำลาย child process/resource อย่างถูกต้อง
+
+## Unsupported languages
+
+ถ้าไม่มี registry entry ระบบคืน `UNSUPPORTED_LANGUAGE` พร้อมคำแนะนำให้ owner เพิ่ม server เอง ไม่ดาวน์โหลดหรือรัน server ที่ไม่ได้ลงทะเบียนโดยอัตโนมัติ