@pplethai/cli 0.4.0 → 0.4.2

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,159 +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);
-    }
-    // Install dependencies and bring the local database up before handing over,
-    // so the Builder (or their agent) can `npm run dev` straight away. Done after
-    // the scaffold commit so node_modules/.wrangler stay out of it.
-    const setupOk = await setupWorkspace(deps, targetDir);
-    report(deps, app, targetDir, setupOk);
-}
-/**
- * Install packages and apply local migrations. Non-fatal by design: the app
- * already exists and is committed, so a flaky network or wrong Node version
- * must not strand the Builder — we warn, and `report` prints the two commands
- * to run by hand.
- */
-async function setupWorkspace(deps, targetDir) {
-    deps.out.say("กำลังติดตั้งแพ็กเกจและเตรียมฐานข้อมูลบนเครื่อง…");
-    const steps = [
-        ["npm", ["install"]],
-        ["npm", ["run", "db:migrate:local"]],
-    ];
-    for (const [command, args] of steps) {
-        const result = await deps
-            .run(command, args, { cwd: targetDir })
-            .catch(() => null);
-        if (!result || result.code !== 0)
-            return false;
-    }
-    return true;
-}
-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, setupOk) {
-    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}`);
-    if (!setupOk) {
-        // Auto-setup didn't finish — the Builder runs these once by hand.
-        deps.out.say("  npm install");
-        deps.out.say("  npm run db:migrate:local");
-    }
-    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} แล้ว`);
-}

package/dist/credentials.js

@@ -1,53 +0,0 @@
-// Where the Builder's PPLE ID tokens live between commands.
-//
-// One file, owner-readable only, outside any app repo — a token that lands in
-// a working copy is a token that gets pushed to a party-owned repo.
-import fs from "node:fs/promises";
-import path from "node:path";
-const FILE = "credentials.json";
-const OWNER_ONLY_FILE = 0o600;
-const OWNER_ONLY_DIR = 0o700;
-function credentialsPath(deps) {
-    return path.join(deps.configDir, FILE);
-}
-export async function loadCredentials(deps) {
-    const raw = await fs.readFile(credentialsPath(deps), "utf8").catch(() => null);
-    if (raw === null)
-        return null;
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-    if (typeof parsed.accessToken !== "string")
-        return null;
-    // A file written against another PPLE ID is as good as no file: it would
-    // only produce confusing 401s against the current one.
-    if (parsed.ssoBase !== deps.config.ssoBase)
-        return null;
-    return {
-        accessToken: parsed.accessToken,
-        refreshToken: typeof parsed.refreshToken === "string" ? parsed.refreshToken : null,
-        expiresAt: typeof parsed.expiresAt === "number" ? parsed.expiresAt : null,
-        ssoBase: parsed.ssoBase,
-    };
-}
-export async function saveCredentials(deps, credentials) {
-    await fs.mkdir(deps.configDir, { recursive: true, mode: OWNER_ONLY_DIR });
-    await fs.writeFile(credentialsPath(deps), `${JSON.stringify(credentials, null, 2)}\n`, { mode: OWNER_ONLY_FILE });
-    // mkdir/writeFile only apply the mode when they create; an existing file
-    // keeps whatever it had, so tighten it explicitly.
-    await fs.chmod(credentialsPath(deps), OWNER_ONLY_FILE);
-}
-/** Returns whether there was anything to forget. */
-export async function clearCredentials(deps) {
-    try {
-        await fs.unlink(credentialsPath(deps));
-        return true;
-    }
-    catch {
-        return false;
-    }
-}

package/dist/deps.js

@@ -1,87 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-export const DEFAULT_CONFIG = {
-    apiBase: "https://api.ppleth.ai",
-    ssoBase: "https://id.peoplesparty.or.th",
-    clientId: "382216793067947795",
-    repoBase: "https://github.com",
-    registryBase: "https://registry.npmjs.org",
-};
-export function platformConfig(env) {
-    return {
-        apiBase: env.PPLE_API_BASE ?? DEFAULT_CONFIG.apiBase,
-        ssoBase: env.PPLE_SSO_BASE ?? DEFAULT_CONFIG.ssoBase,
-        clientId: env.PPLE_CLIENT_ID ?? DEFAULT_CONFIG.clientId,
-        repoBase: env.PPLE_REPO_BASE ?? DEFAULT_CONFIG.repoBase,
-        registryBase: env.PPLE_REGISTRY_BASE ?? DEFAULT_CONFIG.registryBase,
-    };
-}
-/** XDG-style config home, so credentials never land in the app's repo. */
-export function configDir(env, homeDir) {
-    const base = env.XDG_CONFIG_HOME?.trim();
-    return path.join(base && base !== "" ? base : path.join(homeDir, ".config"), "pple");
-}
-/**
- * Whether the CLI may check npm for a newer version. `PPLE_NO_UPDATE_CHECK`
- * is the scripted-environment escape hatch; a local config file is the other
- * half of the opt-out, and lives with the check itself.
- */
-export function updateChecksAllowed(env) {
-    const raw = env.PPLE_NO_UPDATE_CHECK?.trim().toLowerCase();
-    return !raw || raw === "0" || raw === "false";
-}
-/** The CLI's own package directory — one above `src/` in a checkout, `dist/` once built. */
-export function packageRoot() {
-    return path.dirname(path.dirname(fileURLToPath(import.meta.url)));
-}
-/**
- * The version this CLI was published as, read from its own `package.json`.
- * A checkout mid-build can be missing or unreadable — an unknown version
- * simply means upgrade treats anything on npm as newer.
- */
-export function packageVersion() {
-    try {
-        const manifest = readFileSync(path.join(packageRoot(), "package.json"), "utf8");
-        return String(JSON.parse(manifest).version ?? "0.0.0");
-    }
-    catch {
-        return "0.0.0";
-    }
-}
-/**
- * The template ships inside the published package (`npm run build:template`
- * copies it there); running from a checkout, it is the repo's own directory.
- */
-export function resolveTemplateDir(env) {
-    const override = env.PPLE_TEMPLATE_DIR?.trim();
-    if (override)
-        return override;
-    const bundled = path.join(packageRoot(), "templates", "golden-path");
-    if (existsSync(bundled))
-        return bundled;
-    // Running from a checkout of the platform repo, before `build:template`.
-    return path.join(path.dirname(packageRoot()), "template");
-}
-/**
- * Platform Skills ship inside the published package (`npm run build:skills`
- * copies them there); running from a checkout, they are the repo's own
- * `skills/pple-platform/`.
- */
-export function resolveSkillsDir(env) {
-    const override = env.PPLE_SKILLS_DIR?.trim();
-    if (override)
-        return override;
-    const bundled = path.join(packageRoot(), "skills", "pple-platform");
-    if (existsSync(bundled))
-        return bundled;
-    return path.join(path.dirname(packageRoot()), "skills", "pple-platform");
-}
-/**
- * The helper GIT_ASKPASS points at, which feeds git the app's repo token.
- * git execs it directly rather than through a shell, so it ships with its
- * executable bit set and finds node from its own shebang.
- */
-export function askpassHelper() {
-    return path.join(packageRoot(), "askpass", "pple-askpass.mjs");
-}