@pplethai/cli 0.3.1 → 0.4.1

package/dist/commands/auth.js

@@ -1,32 +0,0 @@
-import { ProvisionerClient } from "../api.js";
-import { clearCredentials, saveCredentials } from "../credentials.js";
-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("เข้าสู่ระบบโดยเปิดหน้านี้แล้วกรอกรหัส:");
-    deps.out.say();
-    deps.out.say(`  ${device.verificationUri}`);
-    deps.out.say(`  รหัส: ${device.userCode}`);
-    deps.out.say();
-    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(`เข้าสู่ระบบในชื่อ ${me.name ?? me.sub} แล้ว`);
-    if (!me.isBuilder) {
-        deps.out.say("อีกหนึ่งขั้นตอนก่อนสร้างแอปได้: ยอมรับข้อตกลงผู้พัฒนาที่ https://console.ppleth.ai");
-    }
-}
-export async function logout(deps) {
-    const had = await clearCredentials(deps);
-    deps.out.say(had ? "ออกจากระบบแล้ว" : "คุณยังไม่ได้เข้าสู่ระบบ");
-}
-export async function whoami(deps) {
-    const me = await (await client(deps)).me();
-    deps.out.say(`เข้าสู่ระบบในชื่อ ${me.name ?? me.sub} แล้ว`);
-    if (!me.isBuilder) {
-        deps.out.say("คุณยังไม่ได้ยอมรับข้อตกลงผู้พัฒนา — ยอมรับได้ที่ https://console.ppleth.ai");
-    }
-}

package/dist/commands/deploy.js

@@ -1,113 +0,0 @@
-import { CliError } from "../errors.js";
-import { hasLocalChanges, headCommit, isUpToDateWithRemote, recordChanges, sendChanges, } from "../git.js";
-import { findLink } from "../link.js";
-import { client } from "../session.js";
-import { refreshSkills } from "../skills.js";
-/** How often to ask the platform how the build is going. */
-const POLL_INTERVAL_MS = 3000;
-/** How long to wait for CI to pick the push up before saying so. */
-const BUILD_START_TIMEOUT_MS = 3 * 60_000;
-/** How long a build itself may take before the CLI stops watching. */
-const BUILD_TIMEOUT_MS = 10 * 60_000;
-/** How much of a failed build's log to show; the rest is in the console. */
-const LOG_TAIL_LINES = 20;
-/**
- * Put the Builder's current work live: record it, send it, and watch the
- * platform build it — reporting the live URL, or a failure they can read.
- */
-export async function deploy(deps, options) {
-    const link = await findLink(deps);
-    if (link.apiBase !== "" && link.apiBase !== deps.config.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}" ถูกปลดระวางแล้ว`, "แอปที่ปลดระวางแล้วดีพลอยไม่ได้ หากต้องการสานงานนี้ต่อ ให้สร้างแอปใหม่ในคอนโซล");
-    }
-    if (app.status !== "ready") {
-        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).
-    const access = await api.repoToken(link.slug);
-    // Keep the local Skill overlay current even when there is nothing new to
-    // 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("กำลังบันทึกการเปลี่ยนแปลงของคุณ…");
-        await recordChanges(deps, link.dir, options.message ?? `อัปเดต ${app.name}`, access);
-    }
-    else if (await isUpToDateWithRemote(deps, link.dir, access)) {
-        deps.out.say(`ไม่มีการเปลี่ยนแปลงใหม่ — ${app.name} ใช้งานอยู่แล้วที่ ${app.url}`);
-        return;
-    }
-    deps.out.say("กำลังส่งการเปลี่ยนแปลงของคุณ…");
-    await sendChanges(deps, link.dir, access);
-    const commit = await headCommit(deps, link.dir);
-    deps.out.say("กำลังบิลด์แอปของคุณ… (ปกติใช้เวลาราวหนึ่งนาที)");
-    const result = await watchDeploy(deps, api, link.slug, commit);
-    report(deps, app, result);
-}
-async function watchDeploy(deps, api, slug, commit) {
-    const started = deps.now();
-    let build;
-    for (;;) {
-        const deploys = await api.deploys(slug);
-        const found = deploys.find((d) => d.commit === commit);
-        if (found) {
-            build = found;
-            if (found.status !== "building")
-                return found;
-        }
-        const waited = deps.now() - started;
-        // Before CI has opened a deploy there is nothing to watch; after it has,
-        // the clock that matters is the build's.
-        const limit = build ? BUILD_TIMEOUT_MS : BUILD_START_TIMEOUT_MS;
-        if (waited >= limit) {
-            throw new CliError(build
-                ? "ส่งการเปลี่ยนแปลงของคุณแล้ว แต่การบิลด์ใช้เวลานานกว่าที่คาดไว้"
-                : "ส่งการเปลี่ยนแปลงของคุณแล้ว แต่แพลตฟอร์มยังไม่เริ่มบิลด์", `ติดตามจนเสร็จได้ที่ https://console.ppleth.ai/apps/${slug}`);
-        }
-        await deps.sleep(POLL_INTERVAL_MS);
-    }
-}
-/** How the Provisioner marks a deploy that a newer one overtook. */
-const SUPERSEDED = "superseded by a newer deploy";
-function report(deps, app, build) {
-    if (build.status === "failed") {
-        if (build.error === SUPERSEDED) {
-            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
-        // platform's own reason, and the Builder must still be told something.
-        const detail = build.log ? tail(build.log, LOG_TAIL_LINES) : build.error;
-        if (detail) {
-            deps.out.say();
-            deps.out.say(detail);
-            deps.out.say();
-        }
-        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} แล้ว แต่แอปยังไม่ตอบสนอง`);
-        deps.out.say(`รอสักครู่ แล้วเปิด ${app.url}`);
-        return;
-    }
-    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

@@ -1,70 +0,0 @@
-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();
-}

package/dist/commands/info.js

@@ -1,238 +0,0 @@
-import { CliError } from "../errors.js";
-import { findLink } from "../link.js";
-import { client } from "../session.js";
-/** Same cap the Console / Provisioner enforce for Beta testers. */
-const BETA_INVITE_CAP = 20;
-/**
- * Thai combining vowels and tone marks render with zero width, so `padEnd`
- * over-pads any label containing them. Measure without them to keep the
- * two-column layout below actually aligned in a terminal.
- */
-const THAI_COMBINING = /[\u0E31\u0E34-\u0E3A\u0E47-\u0E4E]/g;
-export function pad(text, width) {
-    const visible = text.replace(THAI_COMBINING, "").length;
-    return text + " ".repeat(Math.max(0, width - visible));
-}
-/** API values are English; these are what a Builder reads. Mirrors the Console. */
-const STATUS_LABEL = {
-    ready: "พร้อมใช้งาน",
-    provisioning: "กำลังจัดเตรียม",
-    failed: "ล้มเหลว",
-    retired: "ปลดระวางแล้ว",
-};
-const TIER_LABEL = {
-    draft: "ฉบับร่าง",
-    beta: "ทดลองใช้",
-    live: "เผยแพร่จริง",
-};
-const ROLE_LABEL = {
-    owner: "เจ้าของ",
-    collaborator: "ผู้ร่วมพัฒนา",
-};
-const DEPLOY_STATUS_LABEL = {
-    live: "ใช้งานอยู่",
-    building: "กำลังบิลด์",
-    unverified: "ยังไม่ยืนยัน",
-    failed: "ล้มเหลว",
-};
-const REQUEST_STATUS_LABEL = {
-    pending: "รอดำเนินการ",
-    approved: "อนุมัติแล้ว",
-    denied: "ปฏิเสธแล้ว",
-};
-/** An unknown value from the platform is shown as-is rather than hidden. */
-function label(map, value) {
-    return map[value] ?? value;
-}
-/**
- * Read-only mirror of the Console dashboard for one app: overview, usage vs
- * Resource Limits, recent deploys, env keys, and — for Owners — publication,
- * collaborators, and request history. No mutations; point Builders at Console
- * for those.
- */
-export async function info(deps, slugArg) {
-    const slug = await resolveSlug(deps, slugArg);
-    const api = await client(deps);
-    const app = await api.app(slug);
-    const isOwner = app.role !== "collaborator";
-    const [metrics, deploys, envEntries, ownerSurfaces] = await Promise.all([
-        api.metrics(slug),
-        api.deploys(slug),
-        api.env(slug),
-        isOwner ? loadOwnerSurfaces(api, slug) : Promise.resolve(null),
-    ]);
-    printOverview(deps, app);
-    printUsage(deps, metrics);
-    printDeploys(deps, deploys);
-    printEnv(deps, envEntries);
-    if (ownerSurfaces) {
-        printPublication(deps, app, ownerSurfaces.requests, ownerSurfaces.invites);
-        printCollaborators(deps, ownerSurfaces.collaborators);
-        printRequests(deps, ownerSurfaces.requests);
-    }
-    deps.out.say("");
-    deps.out.say("หากต้องการเปลี่ยนโควตา ค่า env ผู้ร่วมพัฒนา หรือการเผยแพร่ ใช้ https://console.ppleth.ai");
-}
-async function resolveSlug(deps, slugArg) {
-    if (slugArg)
-        return slugArg;
-    try {
-        return (await findLink(deps)).slug;
-    }
-    catch (e) {
-        // Only rewrite the "no App Link" case; damaged links keep findLink's hint.
-        if (e instanceof CliError &&
-            e.message === "โฟลเดอร์นี้ไม่ใช่แอป PPLE") {
-            throw new CliError("แอปไหน? `pple info` ต้องมี App Link หรือ slug", "เข้าไปในโฟลเดอร์ของแอป ใส่ slug (`pple info <slug>`) หรือเปิด https://console.ppleth.ai");
-        }
-        throw e;
-    }
-}
-async function loadOwnerSurfaces(api, slug) {
-    const [collaborators, requests, invites] = await Promise.all([
-        api.collaborators(slug),
-        api.requests(slug),
-        api.invites(slug),
-    ]);
-    return { collaborators, requests, invites };
-}
-function printOverview(deps, app) {
-    deps.out.say(app.name);
-    deps.out.say(`  ${pad("slug", 18)}${app.slug}`);
-    deps.out.say(`  ${pad("URL", 18)}${app.url}`);
-    if (app.customAddress) {
-        deps.out.say(`  ${pad("ที่อยู่ที่กำหนดเอง", 18)}${app.customAddress}`);
-    }
-    deps.out.say(`  ${pad("สถานะ", 18)}${label(STATUS_LABEL, app.status)}`);
-    deps.out.say(`  ${pad("การเผยแพร่", 18)}${label(TIER_LABEL, app.tier ?? "draft")}`);
-    if (app.role) {
-        deps.out.say(`  ${pad("บทบาทของคุณ", 18)}${label(ROLE_LABEL, app.role)}`);
-    }
-    if (app.deploy) {
-        deps.out.say(`  ${pad("การดีพลอยปัจจุบัน", 18)}${label(DEPLOY_STATUS_LABEL, app.deploy.status)}` +
-            (app.deploy.message ? ` — ${app.deploy.message}` : ""));
-    }
-    if (app.error) {
-        deps.out.say(`  ${pad("ข้อผิดพลาด", 18)}${app.error}`);
-    }
-}
-function printUsage(deps, metrics) {
-    deps.out.say("");
-    deps.out.say("การใช้งานและโควตาทรัพยากร");
-    deps.out.say(`  ${pad("CPU ต่อ request", 20)}${metrics.limits.cpuMs} ms`);
-    deps.out.say(`  ${pad("การแจ้งเตือน", 20)}${formatCount(metrics.usage.notificationsSent)}` +
-        (metrics.usage.notificationsSent === null
-            ? "  (ดูข้อมูลไม่ได้ในขณะนี้)"
-            : ` จากโควตา ${formatCount(metrics.limits.notificationsPerDay)} ครั้งวันนี้`));
-    deps.out.say(`  ${pad("ข้อผิดพลาด (24 ชม.)", 20)}${formatCount(metrics.usage.errors)}` +
-        (metrics.usage.errors === null
-            ? "  (ดูข้อมูลไม่ได้ในขณะนี้)"
-            : metrics.usage.errors === 0
-                ? "  (ไม่มีใน 24 ชั่วโมงที่ผ่านมา)"
-                : metrics.usage.requests === null
-                    ? "  (คำขอที่ล้มเหลวใน 24 ชั่วโมงที่ผ่านมา)"
-                    : ` จากทั้งหมด ${formatCount(metrics.usage.requests)} คำขอ`));
-    deps.out.say(`  ${pad("ผู้ใช้แอป", 20)}${formatCount(metrics.usage.appUsers)}` +
-        (metrics.usage.appUsers === null ? "  (ดูข้อมูลไม่ได้ในขณะนี้)" : ""));
-}
-function formatCount(value) {
-    // Same contract as Console: null means unavailable, never render as "0".
-    return value === null ? "—" : String(value);
-}
-function printDeploys(deps, deploys) {
-    deps.out.say("");
-    deps.out.say("การดีพลอยล่าสุด");
-    if (deploys.length === 0) {
-        deps.out.say("  ยังไม่มี");
-        return;
-    }
-    for (const deploy of deploys.slice(0, 10)) {
-        const short = deploy.commit.slice(0, 7);
-        const note = deploy.message ? ` — ${deploy.message}` : "";
-        const status = label(DEPLOY_STATUS_LABEL, deploy.status);
-        deps.out.say(`  ${pad(status, 13)} ${short}${note}`);
-    }
-}
-function printEnv(deps, entries) {
-    deps.out.say("");
-    deps.out.say("ค่า env");
-    if (entries.length === 0) {
-        deps.out.say("  ยังไม่ได้ตั้งค่าใด ๆ");
-        return;
-    }
-    for (const entry of entries) {
-        // Secrets: key present only, never values — same contract as Console.
-        if (entry.secret) {
-            deps.out.say(`  ${entry.key}=(secret)`);
-        }
-        else {
-            deps.out.say(`  ${entry.key}=${entry.value ?? ""}`);
-        }
-    }
-}
-function printPublication(deps, app, requests, invites) {
-    deps.out.say("");
-    deps.out.say("การเผยแพร่");
-    deps.out.say(`  ${pad("ระดับ", 18)}${label(TIER_LABEL, app.tier ?? "draft")}`);
-    if (app.customAddress) {
-        deps.out.say(`  ${pad("ที่อยู่ที่กำหนดเอง", 18)}${app.customAddress}`);
-    }
-    const pendingPublish = requests.find((r) => r.type === "publish" && r.status === "pending");
-    if (pendingPublish) {
-        deps.out.say(`  ${pad("คำขอที่รออยู่", 18)}${requestSummary(pendingPublish)}`);
-    }
-    if (app.tier === "beta") {
-        // Held = any invite that isn't declined — same slot count as Console.
-        const held = invites.filter((i) => i.status !== "DECLINED").length;
-        deps.out.say(`  ${pad("คำเชิญทดลองใช้", 18)}ใช้ไป ${held} จาก ${BETA_INVITE_CAP} ที่นั่ง`);
-    }
-}
-function printCollaborators(deps, collaborators) {
-    deps.out.say("");
-    deps.out.say("ผู้ร่วมพัฒนา");
-    if (collaborators.length === 0) {
-        deps.out.say("  ยังไม่มี");
-        return;
-    }
-    for (const c of collaborators) {
-        const who = c.maskedName ?? "ผู้ร่วมพัฒนา";
-        const phone = c.phoneNumber ? ` (${c.phoneNumber})` : "";
-        deps.out.say(`  ${who}${phone}`);
-    }
-}
-function printRequests(deps, requests) {
-    deps.out.say("");
-    deps.out.say("ประวัติคำขอ");
-    if (requests.length === 0) {
-        deps.out.say("  ยังไม่มี");
-        return;
-    }
-    for (const r of requests.slice(0, 10)) {
-        const reason = r.reason ? ` — ${r.reason}` : "";
-        const status = label(REQUEST_STATUS_LABEL, r.status);
-        deps.out.say(`  ${pad(status, 13)} ${requestSummary(r)}${reason}`);
-    }
-}
-/** One-line summary of what a typed Request asked for — mirrors Console. */
-function requestSummary(r) {
-    if (r.type === "publish") {
-        const roles = Array.isArray(r.payload.roles)
-            ? r.payload.roles
-            : [];
-        const address = typeof r.payload.customAddress === "string"
-            ? ` · ที่ ${r.payload.customAddress}`
-            : "";
-        const who = roles.length === 0 ? "ทุกคน" : roles.join(", ");
-        return `คำขอเผยแพร่ · ขึ้นเผยแพร่จริง · ${who}${address}`;
-    }
-    if (r.type === "retire")
-        return "คำขอปลดระวาง · ปลดระวางแอป";
-    const parts = [];
-    if (typeof r.payload.cpuMs === "number") {
-        parts.push(`CPU ${r.payload.cpuMs} ms/request`);
-    }
-    if (typeof r.payload.notificationsPerDay === "number") {
-        parts.push(`การแจ้งเตือน ${r.payload.notificationsPerDay} ครั้ง/วัน`);
-    }
-    return `คำขอเพิ่มโควตา · ขอเพิ่ม ${parts.length > 0 ? parts.join(" และ ") : "โควตา"}`;
-}

package/dist/commands/init.js

@@ -1,130 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { CliError } from "../errors.js";
-import { cloneApp, hasLocalChanges, recordChanges } from "../git.js";
-import { peekLink, writeLink } from "../link.js";
-import { scaffold } from "../scaffold.js";
-import { client } from "../session.js";
-import { refreshSkills } from "../skills.js";
-/** How often to ask whether a newly created app is ready to scaffold. */
-const PROVISION_POLL_MS = 3000;
-/** How long create may wait before telling the Builder to retry by slug. */
-const PROVISION_TIMEOUT_MS = 5 * 60_000;
-/**
- * Bring a Builder App onto this computer: either create one (App Name via
- * prompt or `--name`) or scaffold an app that already exists (`<slug>`), with
- * the golden-path template in place and linked, ready for the Builder's AI
- * agent to work in. The Provisioner still creates the infra (ADR-0001).
- */
-export async function init(deps, options) {
-    const api = await client(deps);
-    const app = options.slug
-        ? await api.app(options.slug)
-        : await createAndWait(deps, api, await resolveName(deps, options.name));
-    if (!app.repo) {
-        throw new CliError(`"${app.name}" ยังตั้งค่าไม่เสร็จ`, `รอสักครู่แล้วรัน \`pple init ${app.slug}\` หากยังเป็นแบบนี้ กรุณาติดต่อทีมแพลตฟอร์ม`);
-    }
-    if (app.status === "provisioning") {
-        deps.out.say("แอปของคุณยังอยู่ระหว่างการตั้งค่าบนแพลตฟอร์ม…");
-    }
-    const targetDir = path.resolve(deps.cwd, options.dir ?? app.slug);
-    await ensureAvailable(targetDir);
-    // The Builder's machine holds no credential of its own; the platform hands
-    // out one that opens this app's code and nothing else (ADR-0005).
-    const access = await api.repoToken(app.slug);
-    deps.out.say(`กำลังตั้งค่า "${app.name}" ใน ${path.basename(targetDir)}/…`);
-    await cloneApp(deps, repoUrl(deps, app.repo), targetDir, access);
-    if (await isAlreadyBuilt(targetDir)) {
-        throw new CliError(`"${app.name}" มีโค้ดอยู่แล้ว จึงไม่มีอะไรต้องตั้งค่า`, `ทำงานในโฟลเดอร์นั้นแล้วรัน \`pple deploy\` เพื่อนำการเปลี่ยนแปลงขึ้นใช้งานจริง`);
-    }
-    await scaffold(deps.templateDir, targetDir, app.slug);
-    await writeLink(targetDir, {
-        slug: app.slug,
-        apiBase: deps.config.apiBase,
-        url: app.url,
-    });
-    // Skills are a local overlay (ADR-0006), not app source — refresh before the
-    // first commit so the ignore rule is in place and Skill files stay untracked.
-    await refreshSkills(deps, targetDir);
-    if (await hasLocalChanges(deps, targetDir)) {
-        await recordChanges(deps, targetDir, "เริ่มจากเทมเพลตมาตรฐานของ PPLE", access);
-    }
-    report(deps, app, targetDir);
-}
-async function resolveName(deps, name) {
-    if (await peekLink(deps)) {
-        throw new CliError("โฟลเดอร์นี้เชื่อมกับแอป PPLE อยู่แล้ว", "รัน `pple info` หรือ `pple deploy` ที่นี่ หรือย้ายไปโฟลเดอร์อื่นเพื่อสร้างแอปใหม่");
-    }
-    if (name !== undefined) {
-        const trimmed = name.trim();
-        if (!trimmed) {
-            throw new CliError("`--name` ต้องระบุชื่อแอป", 'ตัวอย่าง: `pple init --name "ลงทะเบียนอาสาสมัคร"`');
-        }
-        return trimmed;
-    }
-    if (!deps.interactive) {
-        throw new CliError("`pple init` ต้องระบุชื่อแอป", 'ใส่ `--name "ชื่อแอปของคุณ"` หรือรันในเทอร์มินัลเพื่อให้ระบบถาม');
-    }
-    const answered = (await deps.ask("ชื่อแอป:")).trim();
-    if (!answered) {
-        throw new CliError("ต้องระบุชื่อแอปเพื่อสร้างแอป", 'ลองใหม่อีกครั้ง หรือใส่ `--name "ชื่อแอปของคุณ"`');
-    }
-    return answered;
-}
-async function createAndWait(deps, api, name) {
-    deps.out.say(`กำลังสร้าง "${name}" บนแพลตฟอร์ม…`);
-    let app = await api.createApp(name);
-    if (readyToScaffold(app))
-        return app;
-    deps.out.say("กำลังรอแพลตฟอร์มตั้งค่าให้เสร็จ…");
-    const started = deps.now();
-    for (;;) {
-        if (app.status === "failed") {
-            throw new CliError(`ตั้งค่า "${app.name}" บนแพลตฟอร์มไม่สำเร็จ`, app.error
-                ? `${app.error} slug ของแอปคือ ${app.slug} — กรุณาติดต่อทีมแพลตฟอร์ม หรือลอง \`pple init ${app.slug}\` ภายหลัง`
-                : `slug ของแอปคือ ${app.slug} — กรุณาติดต่อทีมแพลตฟอร์ม หรือลอง \`pple init ${app.slug}\` ภายหลัง`);
-        }
-        if (deps.now() - started >= PROVISION_TIMEOUT_MS) {
-            throw new CliError(`"${app.name}" ยังอยู่ระหว่างการตั้งค่าบนแพลตฟอร์ม`, `ลองใหม่ด้วย \`pple init ${app.slug}\` ในอีกสักครู่`);
-        }
-        await deps.sleep(PROVISION_POLL_MS);
-        app = await api.app(app.slug);
-        if (readyToScaffold(app))
-            return app;
-    }
-}
-/** Ready with a repo — safe to clone and scaffold. */
-function readyToScaffold(app) {
-    return app.status === "ready" && app.repo !== null;
-}
-/** A repo the Builder may not have cloned before; https works with any helper. */
-function repoUrl(deps, repoFullName) {
-    return `${deps.config.repoBase}/${repoFullName}.git`;
-}
-async function ensureAvailable(targetDir) {
-    const entries = await fs.readdir(targetDir).catch(() => null);
-    if (entries === null)
-        return;
-    if (entries.length > 0) {
-        throw new CliError(`โฟลเดอร์ ${path.basename(targetDir)}/ มีไฟล์อยู่แล้ว`, "รัน `pple init` ที่อื่น หรือใส่ `--dir <folder>` เพื่อเลือกโฟลเดอร์อื่น");
-    }
-}
-/** A repo that already carries an app is one somebody has already set up. */
-async function isAlreadyBuilt(targetDir) {
-    return fs
-        .access(path.join(targetDir, "package.json"))
-        .then(() => true)
-        .catch(() => false);
-}
-function report(deps, app, targetDir) {
-    const folder = path.basename(targetDir);
-    deps.out.say();
-    deps.out.say(`"${app.name}" พร้อมให้ทำงานแล้วใน ${folder}/`);
-    deps.out.say(`แอปจะใช้งานได้ที่ ${app.url}`);
-    deps.out.say();
-    deps.out.say("ขั้นต่อไป:");
-    deps.out.say(`  cd ${folder}`);
-    deps.out.say("  npm install");
-    deps.out.say("  npm run dev        # ดูผลบนเครื่องนี้");
-    deps.out.say("  pple deploy        # นำขึ้นใช้งานจริง");
-}

package/dist/commands/upgrade.js

@@ -1,29 +0,0 @@
-// `pple upgrade` — update the CLI itself, which is also how Skills and the
-// golden-path template move forward (ADR-0006). It replaces only an install
-// npm put there, never with sudo: a global folder the Builder can't write to
-// is theirs to fix, not the CLI's to force.
-import { CliError } from "../errors.js";
-import { installGlobally, isNewer, isNpmGlobalInstall, latestVersion, MANUAL_INSTALL, } from "../npm.js";
-import { announceUpdate, manualHint, sayOtherChannel } from "../update.js";
-export async function upgrade(deps) {
-    const latest = await latestVersion(deps);
-    if (latest === null) {
-        throw new CliError("เชื่อมต่อ npm เพื่อตรวจหาเวอร์ชันใหม่ของ pple ไม่ได้", `ตรวจสอบการเชื่อมต่ออินเทอร์เน็ต หรืออัปเกรดโดยตรง:\n\n  ${MANUAL_INSTALL}`);
-    }
-    if (!isNewer(latest, deps.version)) {
-        deps.out.say(`คุณใช้ pple เวอร์ชันล่าสุดอยู่แล้ว (${deps.version})`);
-        return;
-    }
-    if (!(await isNpmGlobalInstall(deps))) {
-        announceUpdate(deps, latest);
-        deps.out.say();
-        sayOtherChannel(deps);
-        return;
-    }
-    deps.out.say(`กำลังอัปเดต pple ${deps.version} → ${latest}…`);
-    const result = await installGlobally(deps, latest);
-    if (result.code !== 0) {
-        throw new CliError(`อัปเดต pple เป็น ${latest} ไม่สำเร็จ`, manualHint(result));
-    }
-    deps.out.say(`pple เป็นเวอร์ชัน ${latest} แล้ว`);
-}