@pplethai/cli 0.2.1 → 0.3.0

package/README.md

@@ -4,7 +4,9 @@ The Builder's terminal tool: three commands between a PPLE ID and a live app.
 
 ```bash
 pple auth login                 # sign in with your PPLE ID (browser, no password in the terminal)
-pple init brave-otter           # set up the app's code in ./brave-otter, linked to the app
+pple init                       # create an app (asks for App Name) and set up its code
+pple init --name "Sign-up"      # same, without a prompt (for agents/scripts)
+pple init brave-otter           # set up an app that already exists on the platform
 pple deploy -m "Add the form"   # send the changes and put them live
 pple upgrade                    # update pple itself from npm
 ```
@@ -38,11 +40,14 @@ Builder approves it. Tokens land in `$XDG_CONFIG_HOME/pple/credentials.json`
 (mode `0600`) — never inside an app folder, which is a repo the platform
 owns. `pple whoami` renews an expiring token silently via the refresh token.
 
-**`pple init <app>`** takes an app the Provisioner already created (ADR-0001
-— the CLI never creates repos), fetches its code, scaffolds the golden-path
-template into it under the app's own name, writes `.pple/app.json`
-linking the folder to the app, and installs the platform Skill overlay the
-Builder's AI coding agent can load (ADR-0006).
+**`pple init`** creates a Builder App (prompt for App Name, or `--name`) via
+the same Provisioner `POST /apps` the Console uses, waits until the app is
+ready, then scaffolds it — or, given an App Slug, scaffolds an app that
+already exists. Either way it fetches the app's code, copies the golden-path
+template under the app's own name, writes `.pple/app.json` linking the folder
+to the app, and installs the platform Skill overlay the Builder's AI coding
+agent can load (ADR-0001, ADR-0006). The App Slug stays platform-generated;
+bare `pple init` in a folder that already has an App Link is refused.
 
 **`pple deploy`** refreshes that same Skill overlay, records everything in
 the folder, sends it to the app's repo — merging in a Collaborator's work if

package/dist/api.js

@@ -15,48 +15,94 @@ export class ProvisionerClient {
     app(slug) {
         return this.request("GET", `/apps/${encodeURIComponent(slug)}`, { slug });
     }
+    /** Create a Builder App; the Provisioner assigns the App Slug (ADR-0001). */
+    createApp(name) {
+        return this.request("POST", "/apps", { body: { name } });
+    }
     repoToken(slug) {
         return this.request("POST", `/apps/${encodeURIComponent(slug)}/repo-token`, { slug });
     }
     deploys(slug) {
         return this.request("GET", `/apps/${encodeURIComponent(slug)}/deploys`, { slug }).then((r) => r.deploys);
     }
+    env(slug) {
+        return this.request("GET", `/apps/${encodeURIComponent(slug)}/env`, { slug }).then((r) => r.env);
+    }
+    metrics(slug) {
+        return this.request("GET", `/apps/${encodeURIComponent(slug)}/metrics`, { slug });
+    }
+    collaborators(slug) {
+        return this.request("GET", `/apps/${encodeURIComponent(slug)}/collaborators`, { slug }).then((r) => r.collaborators);
+    }
+    requests(slug) {
+        return this.request("GET", `/apps/${encodeURIComponent(slug)}/requests`, { slug }).then((r) => r.requests);
+    }
+    invites(slug) {
+        return this.request("GET", `/apps/${encodeURIComponent(slug)}/invites`, { slug }).then((r) => r.invites);
+    }
+    setEnv(slug, key, value, secret) {
+        return this.request("PUT", `/apps/${encodeURIComponent(slug)}/env/${encodeURIComponent(key)}`, { slug, body: { value, secret } });
+    }
+    deleteEnv(slug, key) {
+        return this.request("DELETE", `/apps/${encodeURIComponent(slug)}/env/${encodeURIComponent(key)}`, { slug, envKey: key });
+    }
     async request(method, path, context = {}) {
         const url = `${this.deps.config.apiBase}${path}`;
+        const headers = {
+            authorization: `Bearer ${this.token}`,
+        };
+        let body;
+        if (context.body !== undefined) {
+            headers["content-type"] = "application/json";
+            body = JSON.stringify(context.body);
+        }
         const res = await this.deps
-            .fetch(url, {
-            method,
-            headers: { authorization: `Bearer ${this.token}` },
-        })
+            .fetch(url, { method, headers, body })
             .catch(() => null);
         if (!res) {
-            throw new CliError("Couldn't reach the PPLE Platform.", "Check your internet connection and try again.");
+            throw new CliError("เชื่อมต่อ PPLE Platform ไม่ได้", "ตรวจสอบการเชื่อมต่ออินเทอร์เน็ตแล้วลองใหม่อีกครั้ง");
         }
-        if (res.ok)
+        if (res.ok) {
+            if (res.status === 204)
+                return undefined;
             return (await res.json());
-        const body = (await res.json().catch(() => ({})));
-        throw platformError(res.status, body.error, context.slug);
+        }
+        const errBody = (await res.json().catch(() => ({})));
+        throw platformError(res.status, errBody.error, context);
     }
 }
-function platformError(status, code, slug) {
+function platformError(status, code, context = {}) {
+    const { slug, envKey } = context;
     if (status === 401)
         return SIGN_IN_EXPIRED;
     if (code === "not_org_member") {
-        return new CliError("Your PPLE ID isn't part of the party organization, so it can't build apps.", "Ask your team lead to add you, then try again.");
+        return new CliError("PPLE ID ของคุณยังไม่ได้อยู่ในองค์กรของพรรค จึงสร้างแอปไม่ได้", "กรุณาติดต่อหัวหน้าทีมของคุณเพื่อเพิ่มสิทธิ์ แล้วลองใหม่อีกครั้ง");
     }
     if (code === "agreement_required") {
-        return new CliError("You haven't accepted the Builder agreement yet.", "Accept it at https://console.ppleth.ai and run this command again.");
+        return new CliError("คุณยังไม่ได้ยอมรับข้อตกลงผู้พัฒนา", "ยอมรับได้ที่ https://console.ppleth.ai แล้วรันคำสั่งนี้อีกครั้ง");
     }
     if (code === "app_has_no_repo") {
-        return new CliError(`${slug ? `"${slug}"` : "That app"} isn't finished being set up yet.`, "Wait a moment and try again; if it stays like this, ask the platform team.");
+        return new CliError(`${slug ? `"${slug}"` : "แอปนี้"} ยังตั้งค่าไม่เสร็จ`, "รอสักครู่แล้วลองใหม่อีกครั้ง หากยังเป็นแบบนี้ กรุณาติดต่อทีมแพลตฟอร์ม");
+    }
+    if (code === "invalid_key") {
+        return new CliError("คีย์นี้ใช้เป็นชื่อไม่ได้", "คีย์ต้องขึ้นต้นด้วยตัวอักษรหรือขีดล่าง ตามด้วยตัวอักษร ตัวเลข หรือขีดล่าง");
+    }
+    if (code === "reserved_key") {
+        return new CliError("คีย์นี้ถูกสงวนไว้โดยแพลตฟอร์ม", "เลือกชื่ออื่น — APP_SLUG, DB, FILES, NOTIFY_* และ PPLE_DEPLOY_ID ถูกใช้ไปแล้ว");
+    }
+    if (code === "invalid_value") {
+        return new CliError("บันทึกค่านี้ไม่สำเร็จ", "ส่งค่ามาเป็น argument ผ่าน `--file` หรือทาง stdin");
     }
     if (status === 404) {
+        if (envKey) {
+            return new CliError(`แอปนี้ไม่ได้ตั้งค่า "${envKey}" ไว้`, "รัน `pple env list` เพื่อดูค่าที่ตั้งไว้");
+        }
         return new CliError(slug
-            ? `There's no app called "${slug}" that belongs to you.`
-            : "That doesn't exist on the platform.", "Check the app list at https://console.ppleth.ai.");
+            ? `ไม่มีแอปชื่อ "${slug}" ที่เป็นของคุณ`
+            : "ไม่พบสิ่งนี้บนแพลตฟอร์ม", "ตรวจสอบรายการแอปได้ที่ https://console.ppleth.ai");
     }
     if (status >= 500 || code === "sso_unavailable") {
-        return new CliError("The PPLE Platform is having trouble right now.", "Wait a moment and try again; if it keeps happening, tell the platform team.");
+        return new CliError("PPLE Platform กำลังมีปัญหาในขณะนี้", "รอสักครู่แล้วลองใหม่อีกครั้ง หากยังเกิดขึ้นอีก กรุณาแจ้งทีมแพลตฟอร์ม");
     }
-    return new CliError("The PPLE Platform refused that request.", code ? `It said: ${code}` : undefined);
+    return new CliError("PPLE Platform ปฏิเสธคำขอนี้", code ? `ข้อความจากระบบ: ${code}` : undefined);
 }

package/dist/bin.js

@@ -10,7 +10,7 @@ try {
 catch (e) {
     // Not a failure the CLI knows how to explain — say so plainly instead of
     // dumping a stack trace on a Builder who can't act on it.
-    process.stderr.write("Something went wrong inside the pple CLI. Please send this to the platform team:\n");
+    process.stderr.write("เกิดข้อผิดพลาดภายใน pple CLI กรุณาส่งข้อความนี้ให้ทีมแพลตฟอร์ม:\n");
     process.stderr.write(`${e instanceof Error ? (e.stack ?? e.message) : String(e)}\n`);
     process.exitCode = 1;
 }

package/dist/cli.js

@@ -1,24 +1,36 @@
 import * as auth from "./commands/auth.js";
 import { deploy } from "./commands/deploy.js";
+import * as env from "./commands/env.js";
+import { info } from "./commands/info.js";
 import { init } from "./commands/init.js";
 import { upgrade } from "./commands/upgrade.js";
 import { CliError } from "./errors.js";
 import { checkForUpdate, wantsUpdateCheck } from "./update.js";
-const USAGE = `pple — build and ship apps on the PPLE Platform
+const USAGE = `pple — สร้างและส่งแอปขึ้น PPLE Platform
 
-  pple auth login          sign in with your PPLE ID
-  pple auth logout         forget this computer's sign-in
-  pple whoami              show who you're signed in as
+  pple auth login          เข้าสู่ระบบด้วย PPLE ID ของคุณ
+  pple auth logout         ลบการเข้าสู่ระบบออกจากเครื่องนี้
+  pple whoami              ดูว่ากำลังเข้าสู่ระบบด้วยบัญชีใด
 
-  pple init <app>          set up an app's code on this computer
-  pple deploy [-m "note"]  send your changes and put them live
+  pple init                สร้างแอปและตั้งค่าโค้ดบนเครื่องนี้
+  pple init --name "App"   สร้างแอปโดยไม่ต้องถาม (สำหรับ agent/สคริปต์)
+  pple init <app>          ตั้งค่าแอปที่มีอยู่แล้วบนแพลตฟอร์ม
+  pple deploy [-m "note"]  ส่งการเปลี่ยนแปลงของคุณขึ้นใช้งานจริง
+  pple info [<slug>]       ดูสถานะ การใช้งาน การดีพลอย และคีย์ env ของแอปนี้
 
-  pple upgrade             update pple itself to the newest version
+  pple env list            ดูตัวแปรและ secret ของแอปนี้
+  pple env set <KEY> [VAL] ตั้งค่าตัวแปร (หรือ --secret) รับค่าจาก arg, --file หรือ stdin
+  pple env delete <KEY>    ลบตัวแปรหรือ secret
 
-Options
-  -m, --message <note>     what changed, shown in the app's history
-      --dir <folder>       where to put the app's code (pple init)
-  -h, --help               show this help
+  pple upgrade             อัปเดต pple เป็นเวอร์ชันล่าสุด
+
+ตัวเลือก
+  -m, --message <note>     สิ่งที่เปลี่ยนแปลง แสดงในประวัติของแอป
+      --name <App Name>    สร้างแอปใหม่ด้วยชื่อนี้ (pple init)
+      --dir <folder>       ตำแหน่งที่จะวางโค้ดของแอป (pple init)
+      --file <path>        อ่านค่า env จากไฟล์ (pple env set)
+      --secret             เก็บค่าเป็น secret แบบเขียนอย่างเดียว (pple env set)
+  -h, --help               แสดงวิธีใช้นี้
 `;
 /**
  * Parse and run one command line. Returns the process exit code; expected
@@ -68,16 +80,44 @@ async function dispatch(argv, deps) {
             return auth.whoami(deps);
         case "init": {
             const dir = takeOption(args, "--dir");
+            const name = takeOption(args, "--name");
             const slug = args.shift();
-            if (!slug) {
-                throw new CliError("Which app? `pple init` needs the app's name.", "Create the app at https://console.ppleth.ai — it shows you the exact command to run.");
+            if (name !== undefined && slug) {
+                throw new CliError("`pple init` รับได้เฉพาะชื่อแอปใหม่ หรือแอปที่มีอยู่แล้ว อย่างใดอย่างหนึ่งเท่านั้น", 'ใช้ `pple init --name "ชื่อแอปของคุณ"` เพื่อสร้างใหม่ หรือ `pple init <app>` สำหรับแอปที่มีอยู่แล้ว');
             }
-            return init(deps, { slug, dir });
+            return init(deps, { slug, name, dir });
         }
         case "deploy": {
             const message = takeOption(args, "--message", "-m");
             return deploy(deps, { message });
         }
+        case "info": {
+            const slug = args.shift();
+            return info(deps, slug);
+        }
+        case "env": {
+            const sub = args.shift();
+            if (sub === "list")
+                return env.list(deps);
+            if (sub === "set") {
+                const secret = takeFlag(args, "--secret");
+                const file = takeOption(args, "--file");
+                const key = args.shift();
+                const value = args.shift();
+                if (!key) {
+                    throw new CliError("`pple env set` ต้องระบุ KEY", "ตัวอย่าง: `pple env set API_URL https://example.com`");
+                }
+                return env.set(deps, { key, value, secret, file });
+            }
+            if (sub === "delete") {
+                const key = args.shift();
+                if (!key) {
+                    throw new CliError("`pple env delete` ต้องระบุ KEY", "ตัวอย่าง: `pple env delete API_URL`");
+                }
+                return env.remove(deps, key);
+            }
+            throw unknown(`env ${sub ?? ""}`.trim());
+        }
         case "upgrade":
             return upgrade(deps);
         case "help":
@@ -88,7 +128,7 @@ async function dispatch(argv, deps) {
     }
 }
 function unknown(command) {
-    return new CliError(`There's no \`pple ${command}\` command.`, "Run `pple --help` to see what you can do.");
+    return new CliError(`ไม่มีคำสั่ง \`pple ${command}\``, "รัน `pple --help` เพื่อดูคำสั่งทั้งหมด");
 }
 /** Pull `--name value` out of the argument list, wherever it appears. */
 function takeOption(args, long, short) {
@@ -97,7 +137,15 @@ function takeOption(args, long, short) {
         return undefined;
     const [, value] = args.splice(index, 2);
     if (value === undefined || value.startsWith("-")) {
-        throw new CliError(`\`${long}\` needs a value after it.`);
+        throw new CliError(`\`${long}\` ต้องระบุค่าตามหลัง`);
     }
     return value;
 }
+/** Pull a bare `--flag` out of the argument list, wherever it appears. */
+function takeFlag(args, flag) {
+    const index = args.indexOf(flag);
+    if (index === -1)
+        return false;
+    args.splice(index, 1);
+    return true;
+}

package/dist/commands/auth.js

@@ -4,29 +4,29 @@ import { awaitToken, requestDeviceCode } from "../device-flow.js";
 import { client } from "../session.js";
 export async function login(deps) {
     const device = await requestDeviceCode(deps);
-    deps.out.say("To sign in, open this page and enter the code:");
+    deps.out.say("เข้าสู่ระบบโดยเปิดหน้านี้แล้วกรอกรหัส:");
     deps.out.say();
     deps.out.say(`  ${device.verificationUri}`);
-    deps.out.say(`  code: ${device.userCode}`);
+    deps.out.say(`  รหัส: ${device.userCode}`);
     deps.out.say();
-    deps.out.say("Waiting for you to approve the sign-in…");
+    deps.out.say("กำลังรอให้คุณอนุมัติการเข้าสู่ระบบ…");
     await deps.openBrowser(device.verificationUriComplete ?? device.verificationUri);
     const tokens = await awaitToken(deps, device);
     await saveCredentials(deps, { ...tokens, ssoBase: deps.config.ssoBase });
     const me = await new ProvisionerClient(deps, tokens.accessToken).me();
-    deps.out.say(`Signed in as ${me.name ?? me.sub}.`);
+    deps.out.say(`เข้าสู่ระบบในชื่อ ${me.name ?? me.sub} แล้ว`);
     if (!me.isBuilder) {
-        deps.out.say("One more step before you can create apps: accept the Builder agreement at https://console.ppleth.ai");
+        deps.out.say("อีกหนึ่งขั้นตอนก่อนสร้างแอปได้: ยอมรับข้อตกลงผู้พัฒนาที่ https://console.ppleth.ai");
     }
 }
 export async function logout(deps) {
     const had = await clearCredentials(deps);
-    deps.out.say(had ? "Signed out." : "You weren't signed in.");
+    deps.out.say(had ? "ออกจากระบบแล้ว" : "คุณยังไม่ได้เข้าสู่ระบบ");
 }
 export async function whoami(deps) {
     const me = await (await client(deps)).me();
-    deps.out.say(`Signed in as ${me.name ?? me.sub}.`);
+    deps.out.say(`เข้าสู่ระบบในชื่อ ${me.name ?? me.sub} แล้ว`);
     if (!me.isBuilder) {
-        deps.out.say("You haven't accepted the Builder agreement yet — do that at https://console.ppleth.ai");
+        deps.out.say("คุณยังไม่ได้ยอมรับข้อตกลงผู้พัฒนา — ยอมรับได้ที่ https://console.ppleth.ai");
     }
 }

package/dist/commands/deploy.js

@@ -18,17 +18,17 @@ const LOG_TAIL_LINES = 20;
 export async function deploy(deps, options) {
     const link = await findLink(deps);
     if (link.apiBase !== "" && link.apiBase !== deps.config.apiBase) {
-        throw new CliError("This app belongs to a different PPLE Platform than the one you're signed in to.", `It was set up against ${link.apiBase}.`);
+        throw new CliError("แอปนี้อยู่บน PPLE Platform คนละตัวกับที่คุณเข้าสู่ระบบอยู่", `แอปนี้ถูกตั้งค่าไว้กับ ${link.apiBase}`);
     }
     const api = await client(deps);
     const app = await api.app(link.slug);
     if (app.status === "retired") {
-        throw new CliError(`"${app.name}" has been retired.`, "A retired app can't be deployed to. Create a new app in the Console if you want to pick this work back up.");
+        throw new CliError(`"${app.name}" ถูกปลดระวางแล้ว`, "แอปที่ปลดระวางแล้วดีพลอยไม่ได้ หากต้องการสานงานนี้ต่อ ให้สร้างแอปใหม่ในคอนโซล");
     }
     if (app.status !== "ready") {
-        throw new CliError(`"${app.name}" isn't ready to receive changes yet.`, app.error
-            ? `Setting it up ran into a problem: ${app.error}`
-            : "Check on it at https://console.ppleth.ai and try again in a moment.");
+        throw new CliError(`"${app.name}" ยังไม่พร้อมรับการเปลี่ยนแปลง`, app.error
+            ? `การตั้งค่าพบปัญหา: ${app.error}`
+            : "ตรวจสอบได้ที่ https://console.ppleth.ai แล้วลองใหม่ในอีกสักครู่");
     }
     // One token for the whole command, kept in memory: it says both what this
     // machine may push and whose name the work goes out under (ADR-0005).
@@ -37,17 +37,17 @@ export async function deploy(deps, options) {
     // send — including first seed for folders set up before Skills shipped.
     await refreshSkills(deps, link.dir);
     if (await hasLocalChanges(deps, link.dir)) {
-        deps.out.say("Saving your changes…");
-        await recordChanges(deps, link.dir, options.message ?? `Update ${app.name}`, access);
+        deps.out.say("กำลังบันทึกการเปลี่ยนแปลงของคุณ…");
+        await recordChanges(deps, link.dir, options.message ?? `อัปเดต ${app.name}`, access);
     }
     else if (await isUpToDateWithRemote(deps, link.dir, access)) {
-        deps.out.say(`Nothing new to send — ${app.name} is already live at ${app.url}`);
+        deps.out.say(`ไม่มีการเปลี่ยนแปลงใหม่ — ${app.name} ใช้งานอยู่แล้วที่ ${app.url}`);
         return;
     }
-    deps.out.say("Sending your changes…");
+    deps.out.say("กำลังส่งการเปลี่ยนแปลงของคุณ…");
     await sendChanges(deps, link.dir, access);
     const commit = await headCommit(deps, link.dir);
-    deps.out.say("Building your app… (this usually takes a minute)");
+    deps.out.say("กำลังบิลด์แอปของคุณ… (ปกติใช้เวลาราวหนึ่งนาที)");
     const result = await watchDeploy(deps, api, link.slug, commit);
     report(deps, app, result);
 }
@@ -68,8 +68,8 @@ async function watchDeploy(deps, api, slug, commit) {
         const limit = build ? BUILD_TIMEOUT_MS : BUILD_START_TIMEOUT_MS;
         if (waited >= limit) {
             throw new CliError(build
-                ? "Your changes were sent, but the build is taking longer than expected."
-                : "Your changes were sent, but the platform hasn't started building them.", `Watch it finish at https://console.ppleth.ai/apps/${slug}.`);
+                ? "ส่งการเปลี่ยนแปลงของคุณแล้ว แต่การบิลด์ใช้เวลานานกว่าที่คาดไว้"
+                : "ส่งการเปลี่ยนแปลงของคุณแล้ว แต่แพลตฟอร์มยังไม่เริ่มบิลด์", `ติดตามจนเสร็จได้ที่ https://console.ppleth.ai/apps/${slug}`);
         }
         await deps.sleep(POLL_INTERVAL_MS);
     }
@@ -79,7 +79,7 @@ const SUPERSEDED = "superseded by a newer deploy";
 function report(deps, app, build) {
     if (build.status === "failed") {
         if (build.error === SUPERSEDED) {
-            throw new CliError("A newer deploy of this app replaced the one you were waiting for.", `Watch that one finish at https://console.ppleth.ai/apps/${app.slug}.`);
+            throw new CliError("มีการดีพลอยครั้งใหม่มาแทนที่ครั้งที่คุณกำลังรออยู่", `ติดตามการดีพลอยครั้งนั้นได้ที่ https://console.ppleth.ai/apps/${app.slug}`);
         }
         // A build that compiled badly explains itself in its log; a deploy that
         // failed after the build — a bad bundle, a rejected upload — only has the
@@ -90,16 +90,23 @@ function report(deps, app, build) {
             deps.out.say(detail);
             deps.out.say();
         }
-        throw new CliError(`${app.name} couldn't be built, so what's live hasn't changed.`, detail
-            ? "Show the message above to your AI coding agent — it says what to fix."
-            : `See what happened at https://console.ppleth.ai/apps/${app.slug}.`);
+        throw new CliError(`บิลด์ ${app.name} ไม่สำเร็จ สิ่งที่ใช้งานอยู่จึงยังไม่เปลี่ยนแปลง`, detail
+            ? "ส่งข้อความด้านบนให้ AI coding agent ของคุณ — ในนั้นบอกว่าต้องแก้อะไร"
+            : `ดูรายละเอียดได้ที่ https://console.ppleth.ai/apps/${app.slug}`);
+    }
+    // Migrations are the part of a deploy a Builder can't see for themselves —
+    // no Cloudflare account (ADR-0001/0002) — so say when some landed. Silence
+    // means the database is unchanged (#75).
+    const applied = build.migrations.applied ?? [];
+    if (applied.length > 0) {
+        deps.out.say(`ใช้ migration ${applied.length} รายการกับฐานข้อมูลของคุณแล้ว`);
     }
     if (build.status === "unverified") {
-        deps.out.say(`${app.name} was updated, but it hasn't answered yet.`);
-        deps.out.say(`Give it a minute, then open ${app.url}`);
+        deps.out.say(`อัปเดต ${app.name} แล้ว แต่แอปยังไม่ตอบสนอง`);
+        deps.out.say(`รอสักครู่ แล้วเปิด ${app.url}`);
         return;
     }
-    deps.out.say(`${app.name} is live at ${app.url}`);
+    deps.out.say(`${app.name} ใช้งานได้แล้วที่ ${app.url}`);
 }
 function tail(log, lines) {
     return log.split("\n").slice(-lines).join("\n").trim();

package/dist/commands/env.js

@@ -0,0 +1,70 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { CliError } from "../errors.js";
+import { findLink } from "../link.js";
+import { client } from "../session.js";
+/**
+ * Show the app's environment variables and secrets. Secrets report that a
+ * key is set, never the value — same contract as the Console.
+ */
+export async function list(deps) {
+    const link = await findLink(deps);
+    const api = await client(deps);
+    const entries = await api.env(link.slug);
+    if (entries.length === 0) {
+        deps.out.say("ยังไม่ได้ตั้งค่าใด ๆ");
+        deps.out.say("ตัวแปรที่คุณตั้งจะมีผลในการดีพลอยครั้งถัดไป");
+        return;
+    }
+    for (const entry of entries) {
+        if (entry.secret) {
+            deps.out.say(`${entry.key}=(secret)`);
+        }
+        else {
+            deps.out.say(`${entry.key}=${entry.value ?? ""}`);
+        }
+    }
+    deps.out.say("");
+    deps.out.say("จะมีผลในการดีพลอยครั้งถัดไป");
+}
+/**
+ * Create or replace one env entry. The value comes from an argument, a file
+ * (`--file`), or stdin — so multiline and secret values need not land in
+ * shell history.
+ */
+export async function set(deps, options) {
+    const link = await findLink(deps);
+    const value = await resolveValue(deps, options);
+    const api = await client(deps);
+    const result = await api.setEnv(link.slug, options.key, value, options.secret);
+    deps.out.say(`บันทึก ${result.key}${result.secret ? " (secret)" : ""} แล้ว`);
+    deps.out.say("จะมีผลในการดีพลอยครั้งถัดไป");
+}
+export async function remove(deps, key) {
+    const link = await findLink(deps);
+    const api = await client(deps);
+    await api.deleteEnv(link.slug, key);
+    deps.out.say(`ลบ ${key} แล้ว`);
+    deps.out.say("จะมีผลในการดีพลอยครั้งถัดไป");
+}
+async function resolveValue(deps, options) {
+    if (options.file !== undefined && options.value !== undefined) {
+        throw new CliError("ส่งค่ามาเป็น argument หรือผ่าน `--file` อย่างใดอย่างหนึ่ง ไม่ใช่ทั้งสองอย่าง");
+    }
+    if (options.file !== undefined) {
+        const filePath = path.resolve(deps.cwd, options.file);
+        const raw = await fs.readFile(filePath, "utf8").catch(() => null);
+        if (raw === null) {
+            throw new CliError(`อ่านไฟล์ ${options.file} ไม่ได้`, "ตรวจสอบพาธแล้วลองใหม่อีกครั้ง");
+        }
+        return raw;
+    }
+    if (options.value !== undefined)
+        return options.value;
+    // A TTY with no value would hang waiting for EOF — tell the Builder how
+    // to pass one instead.
+    if (deps.interactive) {
+        throw new CliError("`pple env set` ต้องระบุค่า", "ส่งค่ามาเป็น argument ผ่าน `--file` หรือ pipe ทาง stdin");
+    }
+    return deps.readStdin();
+}