@pushto/cli 0.2.0 → 0.4.6

package/dist/commands/domain.js

@@ -2,6 +2,7 @@ import chalk from 'chalk';
 import { getToken } from '../lib/config.js';
 import { resolveSlug } from '../lib/resolve-slug.js';
 import { api } from '../lib/api.js';
+import { safeJson } from '../lib/safe-json.js';
 export const domain = async (action, domainName) => {
     const token = getToken();
     if (!token) {
@@ -19,32 +20,83 @@ export const domain = async (action, domainName) => {
             process.exit(1);
         }
         console.log(chalk.green(`> registering ${domainName} for ${slug}...`));
-        const res = await api(`/cli/projects/${slug}/domain`, {
-            method: 'POST',
-            body: JSON.stringify({ domain: domainName }),
-        });
-        const data = await res.json();
+        let res;
+        try {
+            res = await api(`/cli/projects/${slug}/domain`, {
+                method: 'POST',
+                body: JSON.stringify({ domain: domainName }),
+            });
+        }
+        catch (err) {
+            // Same shape as i61 (init), i71 (status), i72 (use) — classify
+            // network errors so users don't get the unhandledRejection
+            // handler's generic "something went wrong" for what is really
+            // a connectivity issue (or a real local problem they should
+            // see directly).
+            const msg = err instanceof Error ? err.message : '';
+            const isNetwork = /fetch|enotfound|econnrefused|timeout|abort|network/i.test(msg);
+            if (isNetwork) {
+                console.log(chalk.red('> could not reach pushto.host. check your internet.'));
+            }
+            else {
+                console.log(chalk.red(`> domain setup failed: ${msg || 'unknown error'}`));
+            }
+            process.exit(1);
+        }
+        const data = await safeJson(res);
         if (!res.ok) {
             console.log(chalk.red(`> ${data.error ?? 'something went wrong.'}`));
             process.exit(1);
         }
-        console.log(chalk.green(`> ${domainName} registered.\n`));
-        console.log(chalk.dim('  now add one of these DNS records at your domain provider:\n'));
-        console.log(`  ${chalk.cyan('Type')}   ${chalk.cyan('Name')}   ${chalk.cyan('Value')}`);
-        console.log(`  CNAME  @      ${slug}.pushto.host`);
-        console.log();
-        console.log(chalk.dim('  or if your provider doesn\'t support CNAME on root:\n'));
-        console.log(`  A      @      76.76.21.21`);
+        const nameservers = data.nameservers;
+        const warnings = data.warnings ?? [];
+        console.log(chalk.green(`> ${domainName} configured.\n`));
+        if (nameservers?.length) {
+            console.log('  go to where you bought your domain and change the');
+            console.log('  ' + chalk.cyan('nameservers') + ' to:\n');
+            for (const ns of nameservers) {
+                console.log(`    ${chalk.green(ns)}`);
+            }
+            console.log();
+            console.log(chalk.dim('  that\'s it. we handle the rest — DNS records, SSL, everything.'));
+            console.log(chalk.dim('  propagation usually takes a few minutes, sometimes up to 24h.'));
+        }
+        else {
+            console.log(chalk.dim('  DNS is already configured. check status with: pushto status'));
+        }
+        // Surface partial-failure warnings from the server (i4 fix added these
+        // for www CNAME failures and SSL-mode-config failures). Pre-fix the
+        // server logged them but the CLI dropped the response field on the
+        // floor so the user never knew their www subdomain wouldn't work.
+        if (warnings.length > 0) {
+            console.log();
+            console.log(chalk.yellow('  heads up:'));
+            for (const w of warnings) {
+                console.log(chalk.yellow(`    ${w}`));
+            }
+        }
         console.log();
-        console.log(chalk.dim('  DNS can take a few minutes to propagate.'));
-        console.log(chalk.dim('  check status with: pushto status'));
     }
     else if (action === 'remove' || action === 'rm') {
         console.log(chalk.green(`> removing custom domain from ${slug}...`));
-        const res = await api(`/cli/projects/${slug}/domain`, {
-            method: 'DELETE',
-        });
-        const data = await res.json();
+        let res;
+        try {
+            res = await api(`/cli/projects/${slug}/domain`, {
+                method: 'DELETE',
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : '';
+            const isNetwork = /fetch|enotfound|econnrefused|timeout|abort|network/i.test(msg);
+            if (isNetwork) {
+                console.log(chalk.red('> could not reach pushto.host. check your internet.'));
+            }
+            else {
+                console.log(chalk.red(`> domain remove failed: ${msg || 'unknown error'}`));
+            }
+            process.exit(1);
+        }
+        const data = await safeJson(res);
         if (!res.ok) {
             console.log(chalk.red(`> ${data.error ?? 'something went wrong.'}`));
             process.exit(1);

package/dist/commands/domain.js.map

@@ -1 +1 @@
-{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../src/commands/domain.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"domain.js","sourceRoot":"","sources":["../../src/commands/domain.ts"],"names":[],"mappings":"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"}

package/dist/commands/echo.d.ts

@@ -0,0 +1,2 @@
+export declare const echo: (action: string, args: string[]) => Promise<void>;
+//# sourceMappingURL=echo.d.ts.map

package/dist/commands/echo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo.d.ts","sourceRoot":"","sources":["../../src/commands/echo.ts"],"names":[],"mappings":"AA0QA,eAAO,MAAM,IAAI,GAAU,QAAQ,MAAM,EAAE,MAAM,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAcvE,CAAC"}

package/dist/commands/echo.js

@@ -0,0 +1,227 @@
+import chalk from 'chalk';
+import { getToken } from '../lib/config.js';
+import { resolveSlug } from '../lib/resolve-slug.js';
+import { api } from '../lib/api.js';
+import { safeJson } from '../lib/safe-json.js';
+const ensureAuthed = () => {
+    const token = getToken();
+    if (!token) {
+        console.log(chalk.red('> not logged in.'));
+        console.log(chalk.dim('  run ') + chalk.cyan('pushto login') + chalk.dim(' first.'));
+        process.exit(1);
+    }
+    const slug = resolveSlug();
+    if (!slug) {
+        console.log(chalk.red('> no project here. run pushto init first.'));
+        process.exit(1);
+    }
+    return slug;
+};
+const usage = () => {
+    console.log(chalk.dim('  usage:'));
+    console.log(chalk.cyan('  pushto echo on') + chalk.dim('              start recording'));
+    console.log(chalk.cyan('  pushto echo off') + chalk.dim('             stop recording'));
+    console.log(chalk.cyan('  pushto echo status') + chalk.dim('          show settings + 24h routes'));
+    console.log(chalk.cyan('  pushto echo replay') + chalk.dim('          replay recent recordings'));
+    console.log();
+    console.log(chalk.dim('  replay flags:'));
+    console.log(chalk.dim('    --target=<url>    https url under your project (preview/prod/custom)'));
+    console.log(chalk.dim('    --label=<text>    optional human label'));
+    console.log(chalk.dim('    --since=<iso>     only recordings since that timestamp'));
+    console.log(chalk.dim('    --route=<sig>     filter by route signature, e.g. "GET /api/x"'));
+    console.log(chalk.dim('    --status=<n>      filter by recorded status code'));
+    console.log(chalk.dim('    --limit=<n>       max recordings (default 100, max 500)'));
+};
+const parseFlags = (args) => {
+    const out = {};
+    for (const a of args) {
+        const m = /^--([\w-]+)(?:=(.*))?$/.exec(a);
+        if (!m)
+            continue;
+        out[m[1]] = m[2] ?? 'true';
+    }
+    return out;
+};
+const showStatus = async (slug) => {
+    const res = await api(`/cli/projects/${slug}/echo`);
+    if (!res.ok) {
+        const data = await safeJson(res);
+        console.log(chalk.red(`> ${data.error ?? 'failed to load echo status.'}`));
+        process.exit(1);
+    }
+    const data = (await res.json());
+    const dot = data.enabled ? chalk.green('●') : chalk.dim('○');
+    console.log(`${dot} echo ${data.enabled ? chalk.green('on') : chalk.dim('off')}`);
+    console.log(chalk.dim('  retention   ') +
+        `${data.retentionDays}d ${data.retentionDays === 30 ? chalk.dim('(max)') : ''}`);
+    console.log(chalk.dim('  recordings  ') +
+        `${data.usage.recordings.current.toLocaleString()} / ${data.usage.recordings.limit.toLocaleString()} this month`);
+    console.log(chalk.dim('  replays     ') +
+        `${data.usage.replays.current.toLocaleString()} / ${data.usage.replays.limit.toLocaleString()} this month`);
+    if (data.routes.length === 0) {
+        console.log();
+        console.log(chalk.dim('  no routes recorded in the last 24h.'));
+        return;
+    }
+    console.log();
+    console.log(chalk.dim('  routes (last 24h):'));
+    for (const r of data.routes) {
+        const ok = chalk.green(`${r.okCount} ok`);
+        const err = r.errCount > 0 ? chalk.red(`  ${r.errCount} err`) : '';
+        console.log(`    ${r.routeSignature.padEnd(40)} ${ok}${err}`);
+    }
+};
+const setEnabled = async (slug, enabled) => {
+    const res = await api(`/cli/projects/${slug}/echo`, {
+        method: 'POST',
+        body: JSON.stringify({ enabled }),
+    });
+    if (!res.ok) {
+        const data = await safeJson(res);
+        console.log(chalk.red(`> ${data.error ?? 'failed.'}`));
+        process.exit(1);
+    }
+    if (enabled) {
+        console.log(chalk.green('> recording on.'));
+        console.log(chalk.dim('  capturing up to 10k requests/month, retained 7 days.'));
+    }
+    else {
+        console.log(chalk.dim('> recording off. existing recordings stay until expiry.'));
+    }
+};
+const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const formatProgressLine = (p) => {
+    const total = p.counts.identical + p.counts.tolerated + p.counts.breaking + p.counts.inconclusive;
+    const pct = p.recordingCount > 0 ? Math.round((total / p.recordingCount) * 100) : 0;
+    return `  ${total}/${p.recordingCount} (${pct}%)  ${chalk.green(p.counts.identical + ' ok')}  ${chalk.cyan(p.counts.tolerated + ' tol')}  ${chalk.red(p.counts.breaking + ' break')}  ${chalk.yellow(p.counts.inconclusive + ' incl')}`;
+};
+const runReplayCmd = async (slug, flags) => {
+    const target = flags.target;
+    if (!target) {
+        console.log(chalk.red('> --target=<url> is required.'));
+        console.log(chalk.dim('  e.g. --target=https://') + chalk.cyan(`fix-checkout-${slug}.preview.pushto.host`));
+        process.exit(1);
+    }
+    const isProd = (() => {
+        try {
+            return new URL(target).hostname.toLowerCase() === `${slug}.pushto.host`;
+        }
+        catch {
+            return false;
+        }
+    })();
+    if (isProd) {
+        console.log(chalk.yellow('> heads up — that target is your production deploy.'));
+        console.log(chalk.dim('  any mutating request will mutate prod data. add an ') +
+            chalk.cyan('x-pushto-replay') +
+            chalk.dim(' check on your server to no-op writes.'));
+        console.log(chalk.dim(`  type "${slug}" and press enter to confirm:`));
+        const typed = await readLine();
+        if (typed.trim() !== slug) {
+            console.log(chalk.red('> aborted.'));
+            process.exit(1);
+        }
+    }
+    const startBody = { target };
+    if (flags.label)
+        startBody.label = flags.label;
+    if (flags.since)
+        startBody.since = flags.since;
+    if (flags.route)
+        startBody.route = flags.route;
+    if (flags.status)
+        startBody.status = Number(flags.status);
+    if (flags.limit)
+        startBody.limit = Number(flags.limit);
+    const startRes = await api(`/cli/projects/${slug}/echo/replay`, {
+        method: 'POST',
+        body: JSON.stringify(startBody),
+    });
+    if (!startRes.ok) {
+        const data = await safeJson(startRes);
+        console.log(chalk.red(`> ${data.error ?? 'replay start failed.'}`));
+        process.exit(1);
+    }
+    const start = (await startRes.json());
+    console.log(chalk.dim(`> replaying ${start.recordingCount} recordings against ${target}`));
+    const startedAt = Date.now();
+    const TIMEOUT_MS = 5 * 60 * 1000;
+    let done = false;
+    let last = null;
+    while (!done) {
+        if (Date.now() - startedAt > TIMEOUT_MS) {
+            console.log(chalk.red('> giving up — replay still running after 5 minutes.'));
+            console.log(chalk.dim(`  check the dashboard or rerun: pushto echo replay --target=${target}`));
+            process.exit(1);
+        }
+        await sleep(2_000);
+        const r = await api(`/cli/projects/${slug}/echo/replay/${start.replayId}`);
+        if (!r.ok)
+            continue;
+        last = (await r.json());
+        process.stdout.write('\r' + formatProgressLine(last) + '   ');
+        if (last.replayStatus === 'COMPLETED' || last.replayStatus === 'FAILED') {
+            done = true;
+        }
+    }
+    process.stdout.write('\n');
+    if (!last)
+        return;
+    if (last.replayStatus === 'FAILED') {
+        console.log(chalk.red(`> replay failed: ${last.failureReason ?? 'unknown error'}`));
+        process.exit(1);
+    }
+    console.log();
+    console.log(`  ${chalk.green('✓')} ${last.counts.identical} identical`);
+    if (last.counts.tolerated > 0) {
+        console.log(`  ${chalk.cyan('~')} ${last.counts.tolerated} tolerated diffs`);
+    }
+    console.log(`  ${chalk.red('✗')} ${last.counts.breaking} breaking`);
+    console.log(`  ${chalk.yellow('!')} ${last.counts.inconclusive} inconclusive`);
+    if (last.breakingExamples.length > 0) {
+        console.log();
+        console.log(chalk.dim('  breaking examples:'));
+        for (const ex of last.breakingExamples) {
+            const reasons = (ex.reasons ?? []).slice(0, 1).join('; ');
+            const arrow = ex.replayStatus !== null ? `${ex.recordedStatus} → ${ex.replayStatus}` : `${ex.recordedStatus}`;
+            console.log(`    ${chalk.red(arrow)}  ${chalk.dim(reasons)}`);
+        }
+    }
+    console.log();
+    console.log(chalk.dim(`  full report: https://pushto.host/dashboard/projects/${slug}/echo`));
+    if (last.counts.breaking > 0)
+        process.exit(1);
+};
+const readLine = () => new Promise((resolve) => {
+    let buf = '';
+    process.stdin.setEncoding('utf8');
+    const onData = (chunk) => {
+        buf += chunk;
+        const nl = buf.indexOf('\n');
+        if (nl >= 0) {
+            process.stdin.off('data', onData);
+            process.stdin.pause();
+            resolve(buf.slice(0, nl).replace(/\r$/, ''));
+        }
+    };
+    process.stdin.resume();
+    process.stdin.on('data', onData);
+});
+export const echo = async (action, args) => {
+    if (!action || action === 'help')
+        return usage();
+    const slug = ensureAuthed();
+    const flags = parseFlags(args);
+    if (action === 'status')
+        return showStatus(slug);
+    if (action === 'on')
+        return setEnabled(slug, true);
+    if (action === 'off')
+        return setEnabled(slug, false);
+    if (action === 'replay')
+        return runReplayCmd(slug, flags);
+    console.log(chalk.red(`> unknown action: ${action}`));
+    usage();
+    process.exit(1);
+};
+//# sourceMappingURL=echo.js.map

package/dist/commands/echo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo.js","sourceRoot":"","sources":["../../src/commands/echo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAsC/C,MAAM,YAAY,GAAG,GAAW,EAAE;IAChC,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;QACrF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,GAAS,EAAE;IACvB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC;IACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACzF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC,CAAC;IACxF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC,CAAC;IACpG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC,CAAC;IAClG,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0EAA0E,CAAC,CAAC,CAAC;IACnG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,4DAA4D,CAAC,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,oEAAoE,CAAC,CAAC,CAAC;IAC7F,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAAC,CAAC;IAC/E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,6DAA6D,CAAC,CAAC,CAAC;AACxF,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,IAAc,EAA0B,EAAE;IAC5D,MAAM,GAAG,GAA2B,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3C,IAAI,CAAC,CAAC;YAAE,SAAS;QACjB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAC9B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAiB,EAAE;IACvD,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,iBAAiB,IAAI,OAAO,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAqB,GAAG,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,6BAA6B,EAAE,CAAC,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAe,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAClF,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACzB,GAAG,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC,aAAa,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAClF,CAAC;IACF,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACzB,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,cAAc,EAAE,aAAa,CACnH,CAAC;IACF,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CAAC,gBAAgB,CAAC;QACzB,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,aAAa,CAC7G,CAAC;IAEF,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC,CAAC;QAChE,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC;IAC/C,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC;QAC1C,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACnE,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,GAAG,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,KAAK,EAAE,IAAY,EAAE,OAAgB,EAAiB,EAAE;IACzE,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,iBAAiB,IAAI,OAAO,EAAE;QAClD,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC;KAClC,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAqB,GAAG,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAC5C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,wDAAwD,CAAC,CAAC,CAAC;IACnF,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yDAAyD,CAAC,CAAC,CAAC;IACpF,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,IAAI,OAAO,CAAO,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;AAE1E,MAAM,kBAAkB,GAAG,CAAC,CAAe,EAAU,EAAE;IACrD,MAAM,KAAK,GACT,CAAC,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;IACtF,MAAM,GAAG,GAAG,CAAC,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,cAAc,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,OAAO,KAAK,KAAK,IAAI,CAAC,CAAC,cAAc,KAAK,GAAG,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,GAAG,MAAM,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,GAAG,OAAO,CAAC,EAAE,CAAC;AAC1O,CAAC,CAAC;AAEF,MAAM,YAAY,GAAG,KAAK,EAAE,IAAY,EAAE,KAA6B,EAAiB,EAAE;IACxF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC5B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,sBAAsB,CAAC,CAAC,CAAC;QAC5G,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,GAAG,EAAE;QACnB,IAAI,CAAC;YACH,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,cAAc,CAAC;QAC1E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IACL,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,qDAAqD,CAAC,CAAC,CAAC;QACjF,OAAO,CAAC,GAAG,CACT,KAAK,CAAC,GAAG,CAAC,uDAAuD,CAAC;YAChE,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC;YAC7B,KAAK,CAAC,GAAG,CAAC,wCAAwC,CAAC,CACtD,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,WAAW,IAAI,+BAA+B,CAAC,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC/B,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAA4B,EAAE,MAAM,EAAE,CAAC;IACtD,IAAI,KAAK,CAAC,KAAK;QAAE,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC/C,IAAI,KAAK,CAAC,KAAK;QAAE,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC/C,IAAI,KAAK,CAAC,KAAK;QAAE,SAAS,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC;IAC/C,IAAI,KAAK,CAAC,MAAM;QAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,KAAK,CAAC,KAAK;QAAE,SAAS,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,iBAAiB,IAAI,cAAc,EAAE;QAC9D,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;KAChC,CAAC,CAAC;IACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAqB,QAAQ,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,sBAAsB,EAAE,CAAC,CAAC,CAAC;QACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAc,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,cAAc,uBAAuB,MAAM,EAAE,CAAC,CAAC,CAAC;IAE3F,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAC7B,MAAM,UAAU,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;IACjC,IAAI,IAAI,GAAG,KAAK,CAAC;IACjB,IAAI,IAAI,GAAwB,IAAI,CAAC;IAErC,OAAO,CAAC,IAAI,EAAE,CAAC;QACb,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,GAAG,UAAU,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC,CAAC;YAC9E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,+DAA+D,MAAM,EAAE,CAAC,CAAC,CAAC;YAChG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;QACnB,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,iBAAiB,IAAI,gBAAgB,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,CAAC,CAAC,EAAE;YAAE,SAAS;QACpB,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAiB,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,GAAG,kBAAkB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,YAAY,KAAK,WAAW,IAAI,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YACxE,IAAI,GAAG,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAE3B,IAAI,CAAC,IAAI;QAAE,OAAO;IAElB,IAAI,IAAI,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,oBAAoB,IAAI,CAAC,aAAa,IAAI,eAAe,EAAE,CAAC,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,YAAY,CAAC,CAAC;IACxE,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;QAC9B,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,kBAAkB,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,WAAW,CAAC,CAAC;IACpE,OAAO,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,YAAY,eAAe,CAAC,CAAC;IAE/E,IAAI,IAAI,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,EAAE,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAC/C,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACvC,MAAM,OAAO,GAAG,CAAC,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1D,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,cAAc,MAAM,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,cAAc,EAAE,CAAC;YAC9G,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,CAAC;IACd,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,yDAAyD,IAAI,OAAO,CAAC,CAAC,CAAC;IAE7F,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,GAAoB,EAAE,CACrC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,CAAC,KAAa,EAAE,EAAE;QAC/B,GAAG,IAAI,KAAK,CAAC;QACb,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC;YACZ,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAClC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC;IACF,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;IACvB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AACnC,CAAC,CAAC,CAAC;AAEL,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EAAE,MAAc,EAAE,IAAc,EAAiB,EAAE;IAC1E,IAAI,CAAC,MAAM,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,KAAK,EAAE,CAAC;IAEjD,MAAM,IAAI,GAAG,YAAY,EAAE,CAAC;IAC5B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;IACjD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnD,IAAI,MAAM,KAAK,KAAK;QAAE,OAAO,UAAU,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACrD,IAAI,MAAM,KAAK,QAAQ;QAAE,OAAO,YAAY,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAE1D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,MAAM,EAAE,CAAC,CAAC,CAAC;IACtD,KAAK,EAAE,CAAC;IACR,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC"}

package/dist/commands/env.d.ts

@@ -1,2 +1,4 @@
-export declare const env: (action: string, args: string[]) => Promise<void>;
+export declare const env: (action: string, args: string[], opts?: {
+    json?: boolean;
+}) => Promise<void>;
 //# sourceMappingURL=env.d.ts.map

package/dist/commands/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,GAAG,GAAU,QAAQ,MAAM,EAAE,MAAM,MAAM,EAAE,KAAG,OAAO,CAAC,IAAI,CAwKtE,CAAC"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/commands/env.ts"],"names":[],"mappings":"AAWA,eAAO,MAAM,GAAG,GACd,QAAQ,MAAM,EACd,MAAM,MAAM,EAAE,EACd,OAAM;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,KAC5B,OAAO,CAAC,IAAI,CAwMd,CAAC"}

package/dist/commands/env.js

@@ -5,31 +5,36 @@ import { getToken } from '../lib/config.js';
 import { resolveSlug } from '../lib/resolve-slug.js';
 import { api } from '../lib/api.js';
 import { safeJson } from '../lib/safe-json.js';
-export const env = async (action, args) => {
+import { parseEnvContent } from '../lib/env-parse.js';
+import { fail, emitOk, emitErr } from '../lib/output.js';
+import { buildError, exitCodeFor } from '../lib/errors.js';
+export const env = async (action, args, opts = {}) => {
     const token = getToken();
     if (!token) {
-        console.log(chalk.red('> not logged in.'));
-        console.log(chalk.dim('  run ') + chalk.cyan('pushto login') + chalk.dim(' first.'));
-        process.exit(1);
+        fail('NOT_AUTHENTICATED', 'not logged in.', opts, {
+            stage: 'auth',
+            fix: { label: 'sign in', cmd: 'pushto login', prose: 'run {cmd} first.' },
+        });
     }
     const slug = resolveSlug();
     if (!slug) {
-        console.log(chalk.red('> no project here. run pushto init first.'));
-        process.exit(1);
+        // This command's copy puts the fix INSIDE the sentence, unlike status.ts
+        // which uses a second line. `human` carries it whole and no `fix` is
+        // attached, so the rendered line stays byte-identical. Agents still get
+        // the actionable part from `code: NO_PROJECT`.
+        fail('NO_PROJECT', 'no project here. run pushto init first.', opts);
     }
     if (action === 'set') {
         // pushto env set KEY=value
         const pair = args[0];
         if (!pair || !pair.includes('=')) {
-            console.log(chalk.red('> usage: pushto env set KEY=value'));
-            process.exit(1);
+            fail('BAD_USAGE', 'usage: pushto env set KEY=value', opts);
         }
         const eqIdx = pair.indexOf('=');
         const key = pair.slice(0, eqIdx);
         const value = pair.slice(eqIdx + 1);
         if (!key) {
-            console.log(chalk.red('> key is empty.'));
-            process.exit(1);
+            fail('INVALID_ENV_KEY', 'key is empty.', opts);
         }
         // Call the tRPC mutation via REST-like endpoint
         // We'll use a simple CLI API endpoint for this
@@ -39,20 +44,30 @@ export const env = async (action, args) => {
         });
         if (!res.ok) {
             const data = (await safeJson(res));
-            console.log(chalk.red(`> ${data.error ?? 'failed to set env var.'}`));
-            process.exit(1);
+            fail('SERVER_ERROR', data.error ?? 'failed to set env var.', opts);
         }
+        const setData = await safeJson(res);
         console.log(chalk.green(`> ${key} set.`));
+        if (setData.warning) {
+            console.log(chalk.yellow(`  ${setData.warning}`));
+        }
     }
     else if (action === 'list' || action === 'ls') {
         // pushto env list
         const res = await api(`/cli/projects/${slug}/env`);
         if (!res.ok) {
             const data = (await safeJson(res));
-            console.log(chalk.red(`> ${data.error ?? 'failed to list env vars.'}`));
-            process.exit(1);
+            fail('SERVER_ERROR', data.error ?? 'failed to list env vars.', opts);
         }
         const vars = await safeJson(res);
+        // Values are masked in the human table; the machine payload carries keys
+        // only for the same reason, so `--json` is not a secrets exfiltration
+        // path that the visible output would never permit. `pushto env pull`
+        // stays the deliberate way to get values onto disk.
+        if (opts.json) {
+            emitOk({ project: slug, vars: vars.map((v) => ({ key: v.key })) }, opts);
+            return;
+        }
         if (vars.length === 0) {
             console.log(chalk.dim('> no env vars set.'));
             return;
@@ -68,8 +83,7 @@ export const env = async (action, args) => {
         const res = await api(`/cli/projects/${slug}/env`);
         if (!res.ok) {
             const data = (await safeJson(res));
-            console.log(chalk.red(`> ${data.error ?? 'failed to pull env vars.'}`));
-            process.exit(1);
+            fail('SERVER_ERROR', data.error ?? 'failed to pull env vars.', opts);
         }
         const vars = await safeJson(res);
         if (vars.length === 0) {
@@ -83,50 +97,59 @@ export const env = async (action, args) => {
         console.log(chalk.dim('  make sure .env is in your .gitignore.'));
     }
     else if (action === 'push') {
-        // pushto env push — upload local .env to project
+        // pushto env push — upload local .env to project in ONE bulk request.
+        // Pre-fix this looped a POST per var, and every POST restarts the
+        // container — a 50-var .env restarted the user's app 50 times in a row.
         const envFile = args[0] || '.env';
         const envPath = path.join(process.cwd(), envFile);
         if (!fs.existsSync(envPath)) {
-            console.log(chalk.red(`> ${envFile} not found in this directory.`));
-            process.exit(1);
+            fail('NO_FILES', `${envFile} not found in this directory.`, opts, {
+                details: { file: envFile },
+            });
         }
         const content = fs.readFileSync(envPath, 'utf-8');
-        const lines = content.split('\n');
-        let count = 0;
-        for (const line of lines) {
-            const trimmed = line.trim();
-            if (!trimmed || trimmed.startsWith('#'))
-                continue;
-            const eqIdx = trimmed.indexOf('=');
-            if (eqIdx === -1)
-                continue;
-            const key = trimmed.slice(0, eqIdx).trim();
-            let value = trimmed.slice(eqIdx + 1).trim();
-            // Strip surrounding quotes
-            if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
-                value = value.slice(1, -1);
-            }
-            if (!key)
-                continue;
-            const res = await api(`/cli/projects/${slug}/env`, {
-                method: 'POST',
-                body: JSON.stringify({ key, value }),
-            });
-            if (res.ok) {
-                count++;
-                console.log(chalk.dim(`  ${key} ✓`));
+        const { vars, skipped: localSkipped } = parseEnvContent(content);
+        if (Object.keys(vars).length === 0) {
+            // Not fail(), because that exits immediately and the original prints
+            // the headline BEFORE the per-key reasons. emitErr keeps that order;
+            // the exit code is still derived, never hand-picked. The reasons are
+            // the actionable part, so machines get them as `details`.
+            emitErr(buildError('INVALID_ENV_KEY', `no usable KEY=value pairs in ${envFile}.`, {
+                details: { file: envFile, skipped: localSkipped },
+            }), opts);
+            if (!opts.json) {
+                for (const s of localSkipped) {
+                    console.log(chalk.dim(`  ${s.key}: ${s.reason}`));
+                }
             }
-            else {
-                console.log(chalk.red(`  ${key} ✗`));
+            process.exit(exitCodeFor('INVALID_ENV_KEY'));
+        }
+        const res = await api(`/cli/projects/${slug}/env`, {
+            method: 'PUT',
+            body: JSON.stringify({ vars }),
+        });
+        if (!res.ok) {
+            const data = await safeJson(res);
+            fail('SERVER_ERROR', data.error ?? 'failed to push env vars.', opts);
+        }
+        const pushData = await safeJson(res);
+        const imported = pushData.imported ?? 0;
+        const skipped = [...localSkipped, ...(pushData.skipped ?? [])];
+        console.log(chalk.green(`> pushed ${imported} var${imported !== 1 ? 's' : ''} from ${envFile}`));
+        if (skipped.length > 0) {
+            console.log(chalk.yellow(`  ${skipped.length} skipped:`));
+            for (const s of skipped) {
+                console.log(chalk.dim(`    ${s.key}: ${s.reason}`));
             }
         }
-        console.log(chalk.green(`\n> pushed ${count} var${count !== 1 ? 's' : ''} from ${envFile}`));
+        if (pushData.warning) {
+            console.log(chalk.yellow(`  ${pushData.warning}`));
+        }
     }
     else if (action === 'rm' || action === 'remove' || action === 'delete') {
         const key = args[0];
         if (!key) {
-            console.log(chalk.red('> usage: pushto env rm KEY'));
-            process.exit(1);
+            fail('BAD_USAGE', 'usage: pushto env rm KEY', opts);
         }
         const res = await api(`/cli/projects/${slug}/env`, {
             method: 'DELETE',
@@ -134,10 +157,13 @@ export const env = async (action, args) => {
         });
         if (!res.ok) {
             const data = (await safeJson(res));
-            console.log(chalk.red(`> ${data.error ?? 'failed to delete env var.'}`));
-            process.exit(1);
+            fail('SERVER_ERROR', data.error ?? 'failed to delete env var.', opts);
         }
+        const rmData = await safeJson(res);
         console.log(chalk.green(`> ${key} removed.`));
+        if (rmData.warning) {
+            console.log(chalk.yellow(`  ${rmData.warning}`));
+        }
     }
     else {
         console.log(chalk.dim('  usage:'));