@percher/core 0.2.6 → 0.4.0

package/dist/env-scan-source.js

@@ -0,0 +1,332 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import { join, relative, sep } from "node:path";
+/**
+ * Directories never scanned. Mirrors (a superset of) the tarball builder's
+ * exclude list — these dirs should never appear in a legit upload, but a
+ * defensive check is cheap.
+ */
+const DEFAULT_EXCLUDE = new Set([
+    "node_modules",
+    ".git",
+    ".bun",
+    "dist",
+    "build",
+    ".next",
+    ".svelte-kit",
+    "coverage",
+    ".cache",
+    ".turbo",
+]);
+/**
+ * Source extensions scanned. JS/TS family + popular SFCs + Python.
+ * HTML and other markup are not scanned — false positives outweigh the
+ * occasional inline-script env reference.
+ */
+const SOURCE_EXTS = new Set([
+    ".js",
+    ".jsx",
+    ".ts",
+    ".tsx",
+    ".mjs",
+    ".cjs",
+    ".svelte",
+    ".vue",
+    ".astro",
+    ".py",
+]);
+const DEFAULT_MAX_FILE_BYTES = 1024 * 1024;
+/**
+ * Static patterns. Each pattern's first capture group (or first non-empty
+ * group, for the multi-quote alternation patterns) is the literal env key.
+ *
+ * Env-key shape inside the patterns: `[A-Za-z_][A-Za-z0-9_]*` — standard
+ * POSIX-ish identifier. Permissive on case to keep false negatives low; the
+ * Phase 6c gate enforces `UPPER_SNAKE_CASE` against the `[env]` contract.
+ *
+ * Word-boundary discipline:
+ * - `(?<![A-Za-z0-9_$])` (negative lookbehind) prevents `myprocess.env.KEY`
+ *   or `xprocess.env.KEY` from matching.
+ * - The class includes `$` because JS identifiers can contain `$`.
+ * - For dot access, `(?![A-Za-z0-9_])` after the key prevents trailing-name
+ *   confusion (defence in depth — the captured group is greedy on
+ *   identifier chars so this is mostly belt-and-braces).
+ */
+const STATIC_PATTERNS = [
+    // process.env.KEY  |  Bun.env.KEY  |  import.meta.env.KEY
+    /(?<![A-Za-z0-9_$])(?:process\.env|Bun\.env|import\.meta\.env)\.([A-Za-z_][A-Za-z0-9_]*)(?![A-Za-z0-9_])/g,
+    // process.env["KEY"] | process.env['KEY'] | Bun.env["KEY"] | Bun.env['KEY']
+    /(?<![A-Za-z0-9_$])(?:process\.env|Bun\.env)\[\s*(?:"([A-Za-z_][A-Za-z0-9_]*)"|'([A-Za-z_][A-Za-z0-9_]*)')\s*\]/g,
+    // Deno.env.get("KEY") | Deno.env.get('KEY')
+    /(?<![A-Za-z0-9_$])Deno\.env\.get\(\s*(?:"([A-Za-z_][A-Za-z0-9_]*)"|'([A-Za-z_][A-Za-z0-9_]*)')\s*\)/g,
+    // Python: os.environ.get("KEY") | os.environ.get('KEY')
+    //         os.getenv("KEY")      | os.getenv('KEY')
+    /(?<![A-Za-z0-9_])os\.(?:environ\.get|getenv)\(\s*(?:"([A-Za-z_][A-Za-z0-9_]*)"|'([A-Za-z_][A-Za-z0-9_]*)')\s*[,)]/g,
+    // Python: os.environ["KEY"] | os.environ['KEY']
+    /(?<![A-Za-z0-9_])os\.environ\[\s*(?:"([A-Za-z_][A-Za-z0-9_]*)"|'([A-Za-z_][A-Za-z0-9_]*)')\s*\]/g,
+];
+/**
+ * Dynamic patterns — bracketed access where the argument is NOT a string
+ * literal. These are reported as advisory (`shape: "dynamic"`, `key: ""`).
+ *
+ * Heuristic: match the bracket form, then check the inside isn't a
+ * single-quoted or double-quoted string literal. We over-detect rather than
+ * under-detect here — Phase 6c surfaces these to users without blocking.
+ */
+const DYNAMIC_PATTERNS = [
+    // process.env[<expr>]  |  Bun.env[<expr>]
+    { re: /(?<![A-Za-z0-9_$])(?:process\.env|Bun\.env)\[\s*([^\]]+?)\s*\]/g, argGroup: 1 },
+    // Deno.env.get(<expr>)
+    { re: /(?<![A-Za-z0-9_$])Deno\.env\.get\(\s*([^)]+?)\s*\)/g, argGroup: 1 },
+    // Python: os.environ[<expr>]
+    { re: /(?<![A-Za-z0-9_])os\.environ\[\s*([^\]]+?)\s*\]/g, argGroup: 1 },
+    // Python: os.environ.get(<expr>) | os.getenv(<expr>)
+    { re: /(?<![A-Za-z0-9_])os\.(?:environ\.get|getenv)\(\s*([^,)]+?)\s*[,)]/g, argGroup: 1 },
+];
+/**
+ * True iff the bracket/argument expression is a plain quoted string literal
+ * with no interpolation. Backtick template literals containing `${...}` are
+ * NOT string literals here — they're dynamic. Plain backtick strings (no
+ * interpolation) are not flagged as static either, because the static
+ * patterns above only recognize `"..."` and `'...'`; treating them as
+ * "already static" would silently drop them. We restrict this check to
+ * `"..."` and `'...'` to keep static and dynamic detection in lockstep.
+ */
+function isStringLiteralArg(arg) {
+    const trimmed = arg.trim();
+    if (trimmed.length < 2)
+        return false;
+    const first = trimmed.charCodeAt(0);
+    const last = trimmed.charCodeAt(trimmed.length - 1);
+    if (first !== last)
+        return false;
+    // 0x22 = "  0x27 = '
+    if (first !== 0x22 && first !== 0x27)
+        return false;
+    // Must not contain an unescaped same-quote in the middle (would mean two
+    // separate strings concatenated by some operator → that's dynamic).
+    for (let i = 1; i < trimmed.length - 1; i++) {
+        if (trimmed.charCodeAt(i) === first && trimmed.charCodeAt(i - 1) !== 0x5c) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Strips `/* ... *​/` block comments from a source string, preserving line
+ * count by replacing comment characters with spaces (newlines kept). Best-
+ * effort — does not understand strings or template literals, so a `/*`
+ * embedded in a string literal will start a "comment". This produces false
+ * negatives (skipped real refs), which the spec prefers over false positives.
+ */
+function stripBlockComments(src) {
+    let out = "";
+    let i = 0;
+    let inBlock = false;
+    while (i < src.length) {
+        const ch = src[i];
+        if (!inBlock && ch === "/" && src[i + 1] === "*") {
+            inBlock = true;
+            out += "  ";
+            i += 2;
+            continue;
+        }
+        if (inBlock && ch === "*" && src[i + 1] === "/") {
+            inBlock = false;
+            out += "  ";
+            i += 2;
+            continue;
+        }
+        if (inBlock) {
+            out += ch === "\n" ? "\n" : " ";
+            i += 1;
+            continue;
+        }
+        out += ch;
+        i += 1;
+    }
+    return out;
+}
+/**
+ * Returns the line stripped of trailing single-line comments. Honors `//`
+ * (JS/TS family) and `#` (Python). For JS, a negative lookbehind keeps URL
+ * protocols (`https://`) intact.
+ */
+function stripLineComment(line, isPython) {
+    if (isPython) {
+        // Strip from the first `#` not inside a quote. Conservative: cut at the
+        // first `#` that has no `'` or `"` before it on this line, OR has equal
+        // counts. For our purposes (refs only matter before any `#`), this is
+        // enough: if a `#` precedes the env-ref pattern in a string, the line
+        // is exotic and falls under "prefer false negatives".
+        const idx = line.indexOf("#");
+        if (idx === -1)
+            return line;
+        return line.slice(0, idx);
+    }
+    // JS: strip `//comment` unless the `//` is preceded by `:` (URL). Iterate
+    // to handle multiple // candidates.
+    let off = 0;
+    while (true) {
+        const idx = line.indexOf("//", off);
+        if (idx === -1)
+            return line;
+        if (idx > 0 && line[idx - 1] === ":") {
+            off = idx + 2;
+            continue;
+        }
+        return line.slice(0, idx);
+    }
+}
+/** True iff a line is a pure comment (after leading whitespace). */
+function isPureCommentLine(line, isPython) {
+    const trimmed = line.trimStart();
+    if (trimmed.length === 0)
+        return false;
+    if (isPython)
+        return trimmed.startsWith("#");
+    // `//` line comment, `*` JSDoc continuation, or `/*` start (block already
+    // stripped at file level — this catches single-line `/* ... */` survivors
+    // that mid-line stripping left behind, plus the leading-`*` JSDoc style).
+    return trimmed.startsWith("//") || trimmed.startsWith("*") || trimmed.startsWith("/*");
+}
+/**
+ * Extract env references from a single file's source.
+ *
+ * Pure function — exposed for tests but not exported from the package.
+ */
+function extractFromSource(source, relPath, isPython) {
+    const refs = [];
+    const seen = new Set(); // key|line — line-level dedup
+    const stripped = isPython ? source : stripBlockComments(source);
+    const lines = stripped.split(/\r?\n/);
+    for (let i = 0; i < lines.length; i++) {
+        const raw = lines[i];
+        if (raw === undefined)
+            continue;
+        if (isPureCommentLine(raw, isPython))
+            continue;
+        const code = stripLineComment(raw, isPython);
+        if (code.length === 0)
+            continue;
+        const lineNo = i + 1;
+        const context = raw.trim();
+        // Static refs first — they take precedence over dynamic detection on the
+        // same span (a static `process.env["KEY"]` would also match the dynamic
+        // bracket pattern, so we record the static keys and let dynamic skip
+        // arguments that are string literals).
+        for (const re of STATIC_PATTERNS) {
+            re.lastIndex = 0;
+            let m;
+            // biome-ignore lint/suspicious/noAssignInExpressions: standard regex exec loop
+            while ((m = re.exec(code)) !== null) {
+                // The literal key is in whichever capture group fired.
+                let key = "";
+                for (let g = 1; g < m.length; g++) {
+                    if (m[g]) {
+                        key = m[g];
+                        break;
+                    }
+                }
+                if (!key)
+                    continue;
+                const dedup = `s|${key}|${lineNo}`;
+                if (seen.has(dedup))
+                    continue;
+                seen.add(dedup);
+                refs.push({
+                    key,
+                    file: relPath,
+                    line: lineNo,
+                    context,
+                    shape: "static",
+                });
+            }
+        }
+        for (const { re, argGroup } of DYNAMIC_PATTERNS) {
+            re.lastIndex = 0;
+            let m;
+            // biome-ignore lint/suspicious/noAssignInExpressions: standard regex exec loop
+            while ((m = re.exec(code)) !== null) {
+                const arg = m[argGroup];
+                if (arg === undefined)
+                    continue;
+                if (isStringLiteralArg(arg))
+                    continue; // already counted as static
+                const dedup = `d|${lineNo}|${m.index}`;
+                if (seen.has(dedup))
+                    continue;
+                seen.add(dedup);
+                refs.push({
+                    key: "",
+                    file: relPath,
+                    line: lineNo,
+                    context,
+                    shape: "dynamic",
+                });
+            }
+        }
+    }
+    return refs;
+}
+/**
+ * Recursively scans `rootDir` for env references in supported source files.
+ *
+ * Read-only: never modifies the source tree. Tolerant of unreadable files and
+ * directories — they are skipped silently. Files exceeding `maxFileBytes` are
+ * skipped to bound runtime on pathological inputs (minified bundles, etc.).
+ */
+export async function scanSourceForEnvRefs(rootDir, opts) {
+    const maxBytes = opts?.maxFileBytes ?? DEFAULT_MAX_FILE_BYTES;
+    const extraExclude = new Set(opts?.exclude ?? []);
+    const refs = [];
+    async function walk(dir) {
+        let entries;
+        try {
+            entries = await readdir(dir);
+        }
+        catch {
+            return;
+        }
+        for (const name of entries) {
+            if (DEFAULT_EXCLUDE.has(name))
+                continue;
+            const full = join(dir, name);
+            const rel = relative(rootDir, full).split(sep).join("/");
+            if (extraExclude.has(rel) || extraExclude.has(name))
+                continue;
+            let st;
+            try {
+                st = await stat(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory()) {
+                await walk(full);
+                continue;
+            }
+            if (!st.isFile())
+                continue;
+            const dotIdx = name.lastIndexOf(".");
+            const ext = dotIdx === -1 ? "" : name.slice(dotIdx).toLowerCase();
+            if (!SOURCE_EXTS.has(ext))
+                continue;
+            if (st.size > maxBytes)
+                continue;
+            let content;
+            try {
+                content = await readFile(full, "utf8");
+            }
+            catch {
+                continue;
+            }
+            const isPython = ext === ".py";
+            for (const ref of extractFromSource(content, rel, isPython)) {
+                refs.push(ref);
+            }
+        }
+    }
+    await walk(rootDir);
+    return refs;
+}
+//# sourceMappingURL=env-scan-source.js.map

package/dist/env-scan-source.js.map

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

package/dist/error-classifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-classifier.d.ts","sourceRoot":"","sources":["../src/error-classifier.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,sBAAsB,GACtB,eAAe,GACf,aAAa,GACb,YAAY,GACZ,mBAAmB,GACnB,eAAe,GACf,gBAAgB,GAChB,oBAAoB,GACpB,mBAAmB,CAAC;AAExB,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,EAAE,UAAU,CAAC;IACvB,4CAA4C;IAC5C,KAAK,EAAE,WAAW,CAAC;IACnB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AA4OD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA2B7F"}
+{"version":3,"file":"error-classifier.d.ts","sourceRoot":"","sources":["../src/error-classifier.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,cAAc,GACd,sBAAsB,GACtB,eAAe,GACf,aAAa,GACb,YAAY,GACZ,mBAAmB,GACnB,eAAe,GACf,gBAAgB,GAChB,oBAAoB,GACpB,mBAAmB,CAAC;AAExB,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,cAAc,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElF,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,EAAE,UAAU,CAAC;IACvB,4CAA4C;IAC5C,KAAK,EAAE,WAAW,CAAC;IACnB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAiTD;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA2B7F"}

package/dist/error-classifier.js

@@ -14,19 +14,56 @@ function extractModuleFromLog(combined) {
     return match?.[1];
 }
 const patterns = [
+    {
+        // Phase 3 publish-resilience plan: deploys that the platform abandoned
+        // mid-flight. The API's deploy-reconciler stamps rows stuck in
+        // queued/building/deploying past the timeout with the literal token
+        // `DEPLOY_STALLED:` so the CLI can render a concrete "the platform
+        // dropped this deploy; retry once" message instead of leaving the
+        // user staring at the raw reconciler text. The token is the contract
+        // — keep it in lockstep with `DEPLOY_STALLED_PREFIX` in
+        // `packages/api/src/services/deploy-reconciler.ts`.
+        //
+        // This pattern lives FIRST so it wins over the generic infra match
+        // below (a stalled deploy is also "infra-ish", but the action is
+        // different — for infra we say "wait, retry"; for stalled we say
+        // "the platform abandoned this one, retry once and it'll go through").
+        pattern: /DEPLOY_STALLED:/,
+        result: {
+            title: "Deploy abandoned by the platform",
+            explanation: "The platform stopped tracking this deploy mid-flight — usually because the build worker or API process restarted between accepting the deploy and writing its outcome. Your code is fine; this deploy never reached a terminal state on its own and was auto-failed by the watchdog.",
+            suggestion: "Retry once with `bunx percher publish`. A single retry almost always lands a clean deploy — if it stalls again, check status.percher.app or contact support; that's a sign of an ongoing platform incident, not your app.",
+            errorClass: "infra_unavailable",
+            phase: "infra",
+            cause: "deploy_stalled",
+            relevantFiles: [],
+            missingEnvVars: [],
+        },
+    },
     {
         // Pre-build / infra-side failures: the build never actually started, so
         // the build log is empty and the user is left with "deployment failed,
         // see the log below" pointing at nothing. Match the symptoms reported
         // in the field — nixpacks unable to fetch from cache.nixos.org, the
-        // worker daemon being unreachable, raw fetch failures from RemoteDeployer.
+        // worker daemon being unreachable, raw fetch failures from RemoteDeployer,
+        // bun fetch's generic socket-close which surfaces as
+        // "The socket connection was closed unexpectedly" when api->worker
+        // disconnects mid-deploy (observed live 2026-04-29 during platform
+        // self-deploy rollback cycles).
+        //
         // Order matters: this MUST come before the runtime ECONNREFUSED match
         // below, which talks about *the deployed app* failing to dial out.
-        pattern: /Unable to connect.*?(access the url|cache\.nixos)|Could not resolve host|getaddrinfo ENOTFOUND|Worker \/[\w-]+(\/[\w-]+)? failed \(50\d\)|Failed to fetch.*?worker|deployer\/(run|build) failed/i,
+        pattern: /Unable to connect.*?(access the url|cache\.nixos)|Could not resolve host|getaddrinfo ENOTFOUND|Worker \/[\w-]+(\/[\w-]+)? failed \(50\d\)|Failed to fetch.*?worker|deployer\/(run|build) failed|The socket connection was closed unexpectedly|WORKER_UNAVAILABLE(_PERSISTENT)?:/i,
         result: {
             title: "Build infrastructure unavailable",
-            explanation: "The Percher build server couldn't reach an upstream service it needs (Nix cache, worker daemon, or registry). This is a platform-side problem, not your app code.",
-            suggestion: "Wait 30–60 seconds and run percher publish again. If it still fails, check status.percher.app or contact support — your code is fine, the build never started.",
+            explanation: "The Percher build server couldn't reach an upstream service it needs (Nix cache, worker daemon, or registry). This is a platform-side problem, not your app code. These failures are usually transient and clear within 1–2 minutes.",
+            // Agent-DX guidance: a buggy retry policy is what bit us live on
+            // 2026-04-29 — an agent made 7 attempts in 12 minutes, all during
+            // a partial-platform outage, then gave up ~10 minutes before the
+            // platform recovered. Spell out the cadence so the next agent
+            // backs off properly instead of burning retries during the
+            // outage window.
+            suggestion: "Wait 30 seconds and run percher publish again. If retry #2 also fails, pause 5 minutes before the next attempt — back-to-back retries during a partial outage just waste your time. After 3 spaced-out retries, check status.percher.app or contact support. Your code is fine; the build never started.",
             errorClass: "infra_unavailable",
             phase: "infra",
             cause: "upstream_unreachable",
@@ -47,6 +84,32 @@ const patterns = [
             missingEnvVars: [],
         },
     },
+    {
+        pattern: /Build timed out after \d+s|exit code 124/i,
+        result: {
+            title: "Build timed out",
+            explanation: "The build ran for too long and was stopped.",
+            suggestion: "Check the partial build log above for the last step that ran. Heavy dependency installs sometimes time out on first deploy — retrying once usually hits the build layer cache and completes in seconds.",
+            errorClass: "build_failed",
+            phase: "build",
+            cause: "build_timeout",
+            relevantFiles: [],
+            missingEnvVars: [],
+        },
+    },
+    {
+        pattern: /(?:bun|node|npm|yarn|pnpm)(?:\.exe)?: (?:not found|command not found)|no such file or directory.*(?:\/(?:usr\/(?:local\/)?bin\/)?(?:bun|node|npm|yarn|pnpm))|exec .*(?:bun|node|npm|yarn|pnpm).*not found/i,
+        result: {
+            title: "Start command not found",
+            explanation: "The container's start command could not be found. Your start script likely references a runtime that is not installed in the image.",
+            suggestion: 'If your start script uses bun, add \'runtime = "bun"\' to your [app] block in percher.toml. If it uses node, verify the start script in package.json uses "node" (not "bun" or "ts-node"). Then publish again.',
+            errorClass: "runtime_crash",
+            phase: "start",
+            cause: "command_not_found",
+            relevantFiles: ["percher.toml", "package.json"],
+            missingEnvVars: [],
+        },
+    },
     {
         pattern: /healthcheck failed|health check failed/i,
         result: {

package/dist/error-classifier.js.map

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

package/dist/errors.d.ts

@@ -1,12 +1,19 @@
-export type PercherCoreErrorCode = "init.exists" | "push.no-config-generated" | "push.cancelled" | "push.placeholder-env" | "push.too-large" | "push.suspicious" | "push.deploy-failed" | "push.deploy-timeout" | "logs.no-app" | "env.no-app" | "open.no-app" | "login.expired" | "login.rejected" | "doctor.no-app" | "doctor.api-unreachable" | "dev.no-app" | "data.no-app" | "create.invalid-template" | "create.dir-not-empty" | "create.failed" | "delete.confirmation-required" | "diagnose.no-app" | "insights.no-app" | "billing.checkout-failed" | "billing.portal-failed" | "deploys.no-app" | "deploys.no-id" | "deploys.no-failed";
+export type PercherCoreErrorCode = "init.exists" | "push.no-config-generated" | "push.cancelled" | "push.placeholder-env" | "push.too-large" | "push.suspicious" | "push.deploy-failed" | "push.deploy-timeout" | "push.quota-exceeded" | "push.already-in-progress" | "push.retry-limit-reached" | "logs.no-app" | "env.no-app" | "open.no-app" | "login.expired" | "login.rejected" | "doctor.no-app" | "doctor.api-unreachable" | "dev.no-app" | "data.no-app" | "create.invalid-template" | "create.dir-not-empty" | "create.failed" | "delete.confirmation-required" | "delete.acknowledgement-mismatch" | "account.delete.confirmation-required" | "diagnose.no-app" | "insights.no-app" | "billing.checkout-failed" | "billing.portal-failed" | "deploys.no-app" | "deploys.no-id" | "deploys.no-failed" | "restore.source-not-found" | "restore.timeout" | "restore.failed" | "restore.rolled-back" | "data-export.no-app" | "dashboard.no-app" | "dashboard.invalid-tab";
 export interface PercherCoreErrorOptions {
     code: PercherCoreErrorCode;
     hint?: string;
     cause?: unknown;
+    /**
+     * Optional machine-readable next-step for AI agents. Same shape as
+     * `PublishResult.recovery`. Imported lazily as `Record<string, unknown>` to
+     * keep `errors.ts` free of cross-module dependencies.
+     */
+    recovery?: Record<string, unknown>;
 }
 export declare class PercherCoreError extends Error {
     readonly code: PercherCoreErrorCode;
     readonly hint?: string;
+    readonly recovery?: Record<string, unknown>;
     constructor(message: string, options: PercherCoreErrorOptions);
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,aAAa,GACb,0BAA0B,GAC1B,gBAAgB,GAChB,sBAAsB,GACtB,gBAAgB,GAChB,iBAAiB,GACjB,oBAAoB,GACpB,qBAAqB,GACrB,aAAa,GACb,YAAY,GACZ,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,wBAAwB,GACxB,YAAY,GACZ,aAAa,GACb,yBAAyB,GACzB,sBAAsB,GACtB,eAAe,GACf,8BAA8B,GAC9B,iBAAiB,GACjB,iBAAiB,GACjB,yBAAyB,GACzB,uBAAuB,GACvB,gBAAgB,GAChB,eAAe,GACf,mBAAmB,CAAC;AAExB,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB;CAM9D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,aAAa,GACb,0BAA0B,GAC1B,gBAAgB,GAChB,sBAAsB,GACtB,gBAAgB,GAChB,iBAAiB,GACjB,oBAAoB,GACpB,qBAAqB,GACrB,qBAAqB,GACrB,0BAA0B,GAC1B,0BAA0B,GAC1B,aAAa,GACb,YAAY,GACZ,aAAa,GACb,eAAe,GACf,gBAAgB,GAChB,eAAe,GACf,wBAAwB,GACxB,YAAY,GACZ,aAAa,GACb,yBAAyB,GACzB,sBAAsB,GACtB,eAAe,GACf,8BAA8B,GAC9B,iCAAiC,GACjC,sCAAsC,GACtC,iBAAiB,GACjB,iBAAiB,GACjB,yBAAyB,GACzB,uBAAuB,GACvB,gBAAgB,GAChB,eAAe,GACf,mBAAmB,GACnB,0BAA0B,GAC1B,iBAAiB,GACjB,gBAAgB,GAChB,qBAAqB,GACrB,oBAAoB,GACpB,kBAAkB,GAClB,uBAAuB,CAAC;AAE5B,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAEhC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB;CAO9D"}

package/dist/errors.js

@@ -1,11 +1,13 @@
 export class PercherCoreError extends Error {
     code;
     hint;
+    recovery;
     constructor(message, options) {
         super(message, { cause: options.cause });
         this.name = "PercherCoreError";
         this.code = options.code;
         this.hint = options.hint;
+        this.recovery = options.recovery;
     }
 }
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAoCA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAC3B,IAAI,CAAU;IAEvB,YAAY,OAAe,EAAE,OAAgC;QAC3D,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAsDA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAChC,IAAI,CAAuB;IAC3B,IAAI,CAAU;IACd,QAAQ,CAA2B;IAE5C,YAAY,OAAe,EAAE,OAAgC;QAC3D,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QACzC,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnC,CAAC;CACF"}

package/dist/event-renderer.d.ts

@@ -0,0 +1,17 @@
+import type { DeployEvent } from "@percher/client";
+/**
+ * Convert a DeployEvent row into a single line of CLI/MCP progress
+ * output. Returns `null` for rows that are intentionally hidden (e.g.
+ * `done/ok`, where the caller prints the final "live at <url>" line
+ * with full URL context the events table doesn't carry).
+ *
+ * The mapping is deliberately conservative: every line is short,
+ * past-tense for terminal `ok` rows, present-continuous for
+ * `started` rows. Sub-stage durations are appended in parens when
+ * available so the user sees real timings (`Image built (8.1s)`)
+ * instead of guessing whether the build is making progress.
+ *
+ * Phase 6.1 of the publish-resilience plan.
+ */
+export declare function renderDeployEvent(event: DeployEvent): string | null;
+//# sourceMappingURL=event-renderer.d.ts.map

package/dist/event-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-renderer.d.ts","sourceRoot":"","sources":["../src/event-renderer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,IAAI,CA4CnE"}