dodo-mcp 1.1.0 → 1.2.0

package/README.md

@@ -169,6 +169,35 @@ Chat & Tasks · Runs & Jobs · Approvals · Knowledge · Settings) หน้า
 สร้าง MCP app ใหม่ตามพฤติกรรมของ client การตั้งค่านี้เปลี่ยนเฉพาะการมองเห็น tools
 และไม่เพิ่ม OAuth scope, trust, approval หรือสิทธิ์ของ profile
 
+### เพิ่มโปรเจกต์ครั้งเดียว แล้วสั่งงานด้วยชื่อ
+
+เพิ่มโปรเจกต์จากหน้า Projects (หรือ CLI) โดยกรอกแค่ **ชื่อ**, **absolute path** และ
+**ระดับการเข้าถึง** หนึ่งค่า:
+
+| ระดับ | AI ทำอะไรได้ |
+|---|---|
+| อ่านอย่างเดียว | อ่าน ค้นหา วิเคราะห์ |
+| แก้ไข | อ่านและแก้ไฟล์ |
+| ทำงานเต็มรูปแบบ | อ่าน แก้ไฟล์ และรันคำสั่ง/ทดสอบ |
+
+```bash
+dodo project add "C:\Users\User\Desktop\auto-upload" --name "auto-upload" --access full
+dodo project access "auto-upload" --mode edit
+dodo project list
+```
+
+ในโหมดส่วนตัว (ค่าเริ่มต้น) เท่านี้ก็พร้อมใช้ — ไม่ต้องตั้ง Client ACL, Trust หรือ
+profile allowlist ซ้ำอีกหลายหน้า ระดับที่เลือกเป็น **เพดาน** สิทธิ์จริงคือส่วนที่ทับกับ
+OAuth scope ของ client นั้น (token ที่อ่านได้อย่างเดียวจะยังอ่านได้อย่างเดียวเสมอ)
+
+จากนั้นสั่ง AI ด้วยชื่อโปรเจกต์ได้ตรง ๆ:
+
+> "ใช้ DODO แก้โปรเจกต์ auto-upload"
+
+AI จะ resolve ชื่อเอง (`project_overview` ด้วย `targetProject: "auto-upload"`) รับ
+`workspaceId`/`workspaceEpoch` ของโปรเจกต์นั้น แล้วส่ง `targetProject` ไปกับทุกคำสั่งถัดไป
+เจ้าของไม่ต้องรู้หรือพิมพ์ project ID เลย ดู [docs/PROJECTS.md](docs/PROJECTS.md)
+
 ลงทะเบียนโปรเจกต์ที่ต้องการใช้งานบ่อยได้โดยไม่เริ่ม server:
 
 ```bash
@@ -341,14 +370,22 @@ command sandbox, idempotency และ audit เดิม `agent_exec` ใช้
 
 ### เชื่อม Remote MCP ผ่าน Cloudflare Tunnel
 
-DODO เลือกวิธีเชื่อมต่อระดับ installation ได้หนึ่งแบบ: `local` หรือ `tunnel` ค่าที่เลือก
-มีผลกับทุก `dodo start` และไม่มี fallback อัตโนมัติ หากเลือก Tunnel แล้ว credential หรือ
-readiness ไม่พร้อม DODO จะหยุด startup แทนการเปิด local โดยไม่แจ้ง
+DODO เลือกวิธีเชื่อมต่อระดับ installation ได้หนึ่งแบบ: `local` (loopback เท่านั้น),
+`external` (Cloudflare ที่เจ้าของติดตั้ง/รันเอง) หรือ `tunnel` (DODO ดูแล cloudflared)
+ค่าที่เลือกมีผลกับทุก `dodo start` และไม่มี fallback อัตโนมัติ
+
+เฉพาะเครื่อง:
+
+```bash
+dodo tunnel configure --loopback
+dodo start
+```
 
-Local mode:
+Cloudflare Local (ติดตั้งในเครื่อง) — ผู้ใช้ดูแล process/token เอง:
 
 ```bash
-dodo tunnel configure --local
+dodo tunnel configure --cloudflare-local --public-url https://mcp.example.com
+# เริ่ม cloudflared ที่ติดตั้งในเครื่องด้วยวิธีของผู้ใช้
 dodo start
 ```
 
@@ -365,7 +402,8 @@ dodo start
 
 เจ้าของสร้าง remotely-managed Tunnel, public hostname และ DNS ใน Cloudflare และ route
 **ทุก path** มาที่ `http://127.0.0.1:21730` DODO ไม่จัดการ Cloudflare account/DNS
-Token ถูกบันทึกใน macOS Keychain, Windows Credential Manager หรือ Linux Secret Service;
+เฉพาะ DODO Tunnel เท่านั้นที่ใช้ token ซึ่งถูกบันทึกใน macOS Keychain, Windows
+Credential Manager หรือ Linux Secret Service;
 global config เก็บเพียง opaque reference ทุกครั้งที่เปิด DODO ระบบจะเริ่ม
 `cloudflared` เป็น child และหยุด child พร้อม DODO Token ไม่อยู่ใน argv, config, log,
 audit, browser storage, MCP response หรือ environment ของ MCP jobs
@@ -382,14 +420,17 @@ dodo web --close    # ปิดหน้า Remote Config แต่ MCP/Tunnel
 terminal หลังจับคู่ browser จะใช้ cookie ที่เป็น `Secure`, `HttpOnly`,
 `SameSite=Strict` และจำกัด path ที่ `/config` หน้า Remote Config ปิดอัตโนมัติภายใน
 1 ชั่วโมง การเปิดใหม่ออก code/session ใหม่และไม่ต้อง restart MCP ไม่มี token หรือ
-credential อยู่ใน URL คำสั่งนี้ใช้ได้เฉพาะเมื่อ persistent mode เป็น `tunnel` และ
-DODO-owned Tunnel กำลังทำงาน; มันไม่รับ token ใหม่ผ่าน IPC และไม่เปลี่ยนจาก Local เอง
-
-หน้า Local Config ที่ `127.0.0.1:21731` เลือก Local/Tunnel, ตั้ง public origin และบันทึก
-token แบบ write-only เข้า OS credential store ได้ ค่าใหม่มีผลหลัง restart หน้าเว็บแสดง
-Active MCP URL จาก runtime จริงและไม่กล่าวว่า Tunnel หรือ AI client เชื่อมแล้วหากไม่มี
-หลักฐาน ดูสถานะด้วย `dodo tunnel status`, ตรวจ connectivity ด้วย `dodo tunnel doctor`
-และดู log ที่ redacted ด้วย `dodo tunnel logs`
+credential อยู่ใน URL ใช้ได้ทั้งโหมด **Cloudflare Local** ที่เจ้าของรัน
+`cloudflared` เอง และ **DODO Tunnel** ที่ DODO ดูแล process; โหมดเฉพาะเครื่องไม่มี
+public route จึงเปิด Remote Config ไม่ได้
+
+หน้า Local Config ที่ `127.0.0.1:21731` แยกตัวเลือกชัดเจนเป็น
+**เฉพาะเครื่อง (Loopback)**, **Cloudflare Local (ติดตั้งในเครื่อง)** และ
+**DODO Tunnel** ตั้ง public origin ได้ และรับ token แบบ write-only เฉพาะ DODO Tunnel
+ค่าใหม่มีผลหลัง restart หน้าเว็บแสดง Active MCP URL จาก runtime จริงและไม่กล่าวว่า
+Tunnel หรือ AI client เชื่อมแล้วหากไม่มีหลักฐาน ดูสถานะด้วย `dodo tunnel status`,
+ตรวจ connectivity ด้วย `dodo tunnel doctor` และดู log ที่ redacted ด้วย
+`dodo tunnel logs` (log/supervisor ใช้กับ DODO Tunnel เท่านั้น)
 
 บน macOS `dodo setup --yes` เลือก component `cloudflared` อยู่ในชุด `all` แล้ว
 Tunnel route ต้องชี้เฉพาะ MCP/OAuth listener `21730` ห้ามชี้ Local Config `21731`

package/dist/cli/main.js

@@ -25,6 +25,8 @@ import { DesktopPolicyInputSchema, saveDesktopPolicy } from '../services/desktop
 import { AndroidPolicyInputSchema, saveAndroidPolicy } from '../services/android/androidPolicy.js';
 import { INPUT_LIMIT_PROFILES } from '../config/limits.js';
 import { ProjectRegistry } from '../projects/registry.js';
+import { ProjectAdmin } from '../projects/ownerAdmin.js';
+import { LEVEL_SUMMARY, parseProjectAccessLevel } from '../security/projectAccess.js';
 import { runCliMenu } from './menu.js';
 import { TunnelRuntime } from '../tunnel/runtime.js';
 import { INSTALLATION_AUTHORITY_ID } from '../auth/constants.js';
@@ -85,11 +87,16 @@ function withProjectRegistry(fn) {
         db.close();
     }
 }
+/** The CLI and Local Config share ONE owner-administration service. */
+function withProjectAdmin(fn) {
+    return withProjectRegistry((_registry, store) => fn(new ProjectAdmin(store), store));
+}
 function projectLines(project) {
     return [
         `${project.displayName}  ${project.projectId}`,
         `  Path: ${project.root}`,
         `  Workspace: ${project.workspaceId}`,
+        `  Access: ${project.accessLevel} — ${LEVEL_SUMMARY[project.accessLevel]}`,
         `  Status: ${project.availability} — ${project.statusText}`,
         `  Updated: ${new Date(project.updatedAt).toISOString()}`,
         ...(project.removedAt === null ? [] : [`  Removed: ${new Date(project.removedAt).toISOString()}`]),
@@ -146,20 +153,22 @@ async function launchHttp(opts) {
     const connectionMode = config.tunnel.connectionMode;
     const publicUrl = config.publicUrl;
     const selectedPort = opts.port ?? config.port;
-    if (connectionMode === 'tunnel') {
+    if (connectionMode !== 'local') {
         if (!publicUrl)
-            fail('Tunnel mode requires a public HTTPS origin; run dodo tunnel configure --tunnel --os-credential --public-url https://your-host');
+            fail('Cloudflare mode requires a public HTTPS origin; configure Cloudflare Local or DODO Tunnel with --public-url https://your-host');
         validatePublicUrl(publicUrl, false);
+    }
+    if (connectionMode === 'tunnel') {
         if (!config.tunnel.credentialRef)
             fail('Tunnel mode requires a saved credential; run dodo tunnel configure --tunnel --os-credential --public-url https://your-host');
     }
-    else {
+    else if (connectionMode === 'local') {
         if (opts.web)
-            fail('Remote Config requires Tunnel mode; configure Tunnel, restart DODO, then run dodo --web');
+            fail('Remote Config requires a public Cloudflare connection; select Cloudflare Local or DODO Tunnel, restart DODO, then run dodo --web');
         if (selectedPort === 0)
             fail('local connection mode requires a concrete MCP port');
     }
-    const endpointOrigin = connectionMode === 'tunnel' ? publicUrl : `http://127.0.0.1:${selectedPort}`;
+    const endpointOrigin = connectionMode === 'local' ? `http://127.0.0.1:${selectedPort}` : publicUrl;
     const startOpts = {
         configPort: config.configPort,
         ...(opts.bypass ? { runMode: 'bypass' } : opts.allow ? { runMode: 'allow-all' } : {}),
@@ -204,8 +213,13 @@ async function launchHttp(opts) {
             throw error;
         }
     }
-    else if (!opts.quiet) {
-        console.log(`[dodo] Local connection selected: ${endpointOrigin}/mcp`);
+    else {
+        if (connectionMode === 'external' && opts.web)
+            printRemoteConfig(await ipcForInstallation('remoteConfig.open'));
+        if (!opts.quiet)
+            console.log(connectionMode === 'external'
+                ? `[dodo] Cloudflare Local selected: ${endpointOrigin}/mcp (cloudflared is owner-managed)`
+                : `[dodo] Loopback-only connection selected: ${endpointOrigin}/mcp`);
     }
     async function stop(signal) {
         if (shutdownPromise)
@@ -288,16 +302,40 @@ program.command('setup')
 // trust/client access; those remain keyed by the referenced workspace ID.
 const project = program.command('project').description('manage the local owner-only project registry');
 project.command('add <path>')
-    .description('register an absolute project directory without changing trust or client access')
+    .description('register an absolute project directory and choose what AI clients may do in it')
     .option('--name <display-name>', 'local display name (defaults to the directory name)')
+    .option('--access <level>', 'read | edit | full (read = read/search only, edit = also change files, full = also run commands)')
     .option('--json', 'machine-readable result', false)
     .action((projectPath, opts) => {
     try {
-        const result = withProjectRegistry((registry) => registry.add(projectPath, opts.name));
+        const access = opts.access === undefined ? undefined : parseProjectAccessLevel(opts.access);
+        const result = withProjectAdmin((admin) => admin.add({ path: projectPath, ...(opts.name ? { name: opts.name } : {}), ...(access ? { access } : {}) }));
         printJsonOrLines(opts.json, result, () => [
             result.relocated ? 'Updated the location of an existing project identity.' : result.changed ? 'Project registered.' : 'Project was already registered; nothing changed.',
             ...projectLines(result.project),
-            'Trust, OAuth grants and workspace client access were not changed.',
+            result.project.requiresClientAcl
+                ? 'Managed mode: also allow a client for this project in Local Config before it can be used.'
+                : 'Ready to use. A client may do at most what this level allows, still bounded by its own OAuth scopes.',
+        ]);
+    }
+    catch (error) {
+        if (error instanceof DodoError)
+            fail(`${error.code}: ${error.message}${error.recovery ? `\n  → ${error.recovery}` : ''}`);
+        throw error;
+    }
+});
+project.command('access <project>')
+    .description('set what AI clients may do in a registered project (by name or ID)')
+    .requiredOption('--mode <level>', 'read | edit | full')
+    .option('--json', 'machine-readable result', false)
+    .action((reference, opts) => {
+    try {
+        const level = parseProjectAccessLevel(opts.mode);
+        const updated = withProjectAdmin((admin) => admin.setAccess(admin.resolve(reference).projectId, level));
+        printJsonOrLines(opts.json, updated, () => [
+            `Access level for ${updated.displayName} is now ${updated.accessLevel}.`,
+            ...projectLines(updated),
+            'OAuth scopes, trust, approvals, path/secret guards and the command sandbox are unchanged.',
         ]);
     }
     catch (error) {
@@ -307,7 +345,7 @@ project.command('add <path>')
     }
 });
 project.command('list')
-    .description('list registered projects and current path readiness')
+    .description('list registered projects, their access level and current path readiness')
     .option('--all', 'include reviewed removals', false)
     .option('--json', 'machine-readable output', false)
     .action((opts) => {
@@ -366,12 +404,14 @@ project.command('remove <projectId>')
 // --------------------------------------------------------------- tunnel ----
 const tunnel = program.command('tunnel').description('manage or inspect a Cloudflare remotely-managed Tunnel without managing DNS or the Cloudflare account');
 tunnel.command('configure')
-    .description('select persistent local or DODO-owned Tunnel mode; tokens are never written to config')
+    .description('select loopback, owner-managed Cloudflare Local, or DODO-owned Tunnel mode; tokens are never written to config')
     .option('--tunnel', 'select the DODO-owned Tunnel for every dodo start', false)
-    .option('--local', 'select local-only MCP for every dodo start', false)
+    .option('--cloudflare-local', 'use cloudflared installed and run by the owner; DODO advertises only the saved public origin', false)
+    .option('--loopback', 'select loopback-only MCP for every dodo start', false)
+    .option('--local', 'deprecated alias for --loopback', false)
     .option('--managed', 'deprecated alias for --tunnel', false)
-    .option('--external', 'deprecated alias for --local', false)
-    .option('--public-url <url>', 'public HTTPS origin used by the selected DODO Tunnel')
+    .option('--external', 'alias for --cloudflare-local', false)
+    .option('--public-url <url>', 'public HTTPS origin used by Cloudflare Local or DODO Tunnel')
     .option('--os-credential', 'prompt through the reviewed OS credential provider', false)
     .option('--token-env <name>', 'reference an uppercase environment variable that already contains the token')
     .option('--token-file <absolute-path>', 'reference an owner-private absolute token file')
@@ -384,9 +424,10 @@ tunnel.command('configure')
     .action(async (opts) => {
     try {
         const chooseTunnel = opts.tunnel || opts.managed;
-        const chooseLocal = opts.local || opts.external;
-        if (chooseTunnel && chooseLocal)
-            fail('choose --tunnel or --local');
+        const chooseExternal = opts.cloudflareLocal || opts.external;
+        const chooseLoopback = opts.loopback || opts.local;
+        if ([chooseTunnel, chooseExternal, chooseLoopback].filter(Boolean).length > 1)
+            fail('choose only one of --loopback, --cloudflare-local or --tunnel');
         const methods = [opts.osCredential, opts.tokenEnv !== undefined, opts.tokenFile !== undefined].filter(Boolean).length;
         if (methods > 1)
             fail('choose only one of --os-credential, --token-env or --token-file');
@@ -397,16 +438,18 @@ tunnel.command('configure')
         const { dir } = resolveConfigDir(process.env);
         ensureConfigDir(dir);
         const paths = statePaths(dir), current = loadGlobalConfig(paths.configFile);
-        const connectionMode = chooseTunnel ? 'tunnel' : chooseLocal ? 'local' : methods > 0 ? 'tunnel' : current.tunnel.connectionMode;
+        if (chooseExternal && methods > 0)
+            fail('Cloudflare Local is owner-managed and does not accept a Tunnel credential in DODO');
+        const connectionMode = chooseTunnel ? 'tunnel' : chooseExternal ? 'external' : chooseLoopback ? 'local' : methods > 0 ? 'tunnel' : current.tunnel.connectionMode;
         const publicUrl = opts.publicUrl !== undefined
             ? validatePublicUrl(opts.publicUrl, false).origin
             : current.publicUrl;
-        if (connectionMode === 'tunnel' && !publicUrl)
-            fail('Tunnel mode requires --public-url https://your-host (or a previously saved public origin)');
-        if (connectionMode === 'tunnel' && publicUrl)
+        if (connectionMode !== 'local' && !publicUrl)
+            fail('Cloudflare mode requires --public-url https://your-host (or a previously saved public origin)');
+        if (connectionMode !== 'local' && publicUrl)
             validatePublicUrl(publicUrl, false);
         if (connectionMode === 'local' && opts.publicUrl !== undefined)
-            fail('--public-url is used only with --tunnel');
+            fail('--public-url is used only with --cloudflare-local or --tunnel');
         const credentials = await import('../tunnel/credentials.js');
         const { resolveCloudflared } = await import('../tunnel/supervisor.js');
         const previousCredentialRef = current.tunnel.credentialRef;
@@ -446,14 +489,33 @@ tunnel.command('configure')
         saveGlobalConfig(paths.configFile, next);
         if (opts.removeCredential && previousCredentialRef)
             credentials.deleteOsTunnelCredential(previousCredentialRef);
-        const result = { connectionMode: next.tunnel.connectionMode, publicOrigin: next.tunnel.connectionMode === 'tunnel' ? next.publicUrl : null, credential: next.tunnel.credentialRef ? 'configured' : 'not-configured', metricsPort: next.tunnel.metricsPort, maxRestarts: next.tunnel.maxRestarts, cloudflared: next.tunnel.executable ? 'owner-selected' : 'trusted-PATH', started: false };
+        const result = {
+            connectionMode: next.tunnel.connectionMode,
+            publicOrigin: next.tunnel.connectionMode === 'local' ? null : next.publicUrl,
+            credential: next.tunnel.connectionMode === 'tunnel'
+                ? next.tunnel.credentialRef ? 'configured' : 'not-configured'
+                : 'not-used',
+            metricsPort: next.tunnel.metricsPort,
+            maxRestarts: next.tunnel.maxRestarts,
+            cloudflared: next.tunnel.connectionMode === 'local'
+                ? 'not-used'
+                : next.tunnel.connectionMode === 'external'
+                    ? 'owner-managed'
+                    : next.tunnel.executable ? 'owner-selected' : 'trusted-PATH',
+            started: false,
+        };
         if (opts.json)
             console.log(JSON.stringify(result, null, 2));
         else {
             console.log(`Connection mode: ${result.connectionMode}`);
-            console.log(`Credential: ${result.credential} (value is not stored in config or displayed)`);
-            console.log(`Readiness: 127.0.0.1:${result.metricsPort}   Restarts: ${result.maxRestarts}`);
-            console.log(result.connectionMode === 'tunnel' ? 'Saved. Every dodo start now owns this Tunnel and fails closed if it cannot start.' : 'Saved. Every dodo start now uses only the local MCP endpoint.');
+            console.log(`Credential: ${result.credential}${result.connectionMode === 'tunnel' ? ' (value is not stored in config or displayed)' : ''}`);
+            if (result.connectionMode === 'tunnel')
+                console.log(`Readiness: 127.0.0.1:${result.metricsPort}   Restarts: ${result.maxRestarts}`);
+            console.log(result.connectionMode === 'tunnel'
+                ? 'Saved. Every dodo start now owns this Tunnel and fails closed if it cannot start.'
+                : result.connectionMode === 'external'
+                    ? 'Saved. DODO advertises the public origin; you must start and maintain cloudflared on this machine.'
+                    : 'Saved. Every dodo start now uses only the loopback MCP endpoint.');
         }
     }
     catch (error) {
@@ -1498,9 +1560,11 @@ Android (ADB host authorization and exact-device permission):
   dodo android disable               revoke DODO Android access
 Remote setup:
   dodo init --public-url https://...   configure public origin once
+  dodo tunnel configure --cloudflare-local --public-url https://...
+                                       use cloudflared you install/run yourself
   dodo tunnel configure --tunnel --os-credential --public-url https://...
                                        select the persistent DODO Tunnel
-  dodo tunnel configure --local        select local-only MCP
+  dodo tunnel configure --loopback     select loopback-only MCP
   dodo start                            use exactly the saved connection mode
   dodo --web                           start/renew Remote Config through that tunnel for 1 hour
   dodo web --close                     close Remote Config; keep MCP/Tunnel running`);