@percher/core 0.2.1 → 0.2.3

package/dist/commands/billing.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import type { Context } from "../context";
+export declare const billingUpgradeInputSchema: z.ZodObject<{
+    plan: z.ZodEnum<["starter", "maker", "pro"]>;
+}, "strip", z.ZodTypeAny, {
+    plan: "starter" | "maker" | "pro";
+}, {
+    plan: "starter" | "maker" | "pro";
+}>;
+export type BillingUpgradeInput = z.infer<typeof billingUpgradeInputSchema>;
+export declare const billingPortalInputSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type BillingPortalInput = z.infer<typeof billingPortalInputSchema>;
+export interface BillingUpgradeResult {
+    url: string;
+    summary: string;
+}
+export interface BillingPortalResult {
+    url: string | null;
+    summary: string;
+}
+/**
+ * AI-driven billing (MCP).
+ *
+ * Returns a Polar checkout URL for the requested plan. The AI assistant
+ * is expected to surface this URL back to the user so they can confirm
+ * payment in their browser — Percher never changes subscriptions server-
+ * side without an explicit user click.
+ *
+ * Designed as the "action" companion to `percher_app_insights`: when the
+ * insights tool suggests a plan change, the assistant can immediately
+ * hand the user a one-click URL.
+ */
+export declare function billingUpgrade(ctx: Context, input: BillingUpgradeInput): Promise<BillingUpgradeResult>;
+/**
+ * AI-driven subscription management (MCP).
+ *
+ * Returns the user's Polar customer portal URL. Users on the free plan
+ * who have never subscribed get `url: null` — there's nothing for Polar
+ * to show them, and the AI should tell them to use `percher_billing_upgrade`
+ * instead.
+ */
+export declare function billingPortal(ctx: Context, _input?: BillingPortalInput): Promise<BillingPortalResult>;
+//# sourceMappingURL=billing.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"billing.d.ts","sourceRoot":"","sources":["../../src/commands/billing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,eAAO,MAAM,yBAAyB;;;;;;EAEpC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,eAAO,MAAM,wBAAwB,gDAAe,CAAC;AACrD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAE1E,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAc/B;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,OAAO,EACZ,MAAM,GAAE,kBAAuB,GAC9B,OAAO,CAAC,mBAAmB,CAAC,CAqB9B"}

package/dist/commands/billing.js

@@ -0,0 +1,65 @@
+import { z } from "zod";
+import { PercherCoreError } from "../errors";
+export const billingUpgradeInputSchema = z.object({
+    plan: z.enum(["starter", "maker", "pro"]),
+});
+export const billingPortalInputSchema = z.object({});
+/**
+ * AI-driven billing (MCP).
+ *
+ * Returns a Polar checkout URL for the requested plan. The AI assistant
+ * is expected to surface this URL back to the user so they can confirm
+ * payment in their browser — Percher never changes subscriptions server-
+ * side without an explicit user click.
+ *
+ * Designed as the "action" companion to `percher_app_insights`: when the
+ * insights tool suggests a plan change, the assistant can immediately
+ * hand the user a one-click URL.
+ */
+export async function billingUpgrade(ctx, input) {
+    try {
+        const res = await ctx.client.billing.upgrade(input.plan);
+        return {
+            url: res.url,
+            summary: `Open this URL to upgrade to ${input.plan}: ${res.url}`,
+        };
+    }
+    catch (err) {
+        throw new PercherCoreError(`Could not create a checkout session: ${err.message}`, {
+            code: "billing.checkout-failed",
+            hint: "Billing may be disabled on this Percher instance, or the Polar service is temporarily unavailable.",
+            cause: err,
+        });
+    }
+}
+/**
+ * AI-driven subscription management (MCP).
+ *
+ * Returns the user's Polar customer portal URL. Users on the free plan
+ * who have never subscribed get `url: null` — there's nothing for Polar
+ * to show them, and the AI should tell them to use `percher_billing_upgrade`
+ * instead.
+ */
+export async function billingPortal(ctx, _input = {}) {
+    try {
+        const res = await ctx.client.billing.portal();
+        if (!res.url) {
+            return {
+                url: null,
+                summary: "No billing portal yet — you're on the free plan. Use percher_billing_upgrade to subscribe.",
+            };
+        }
+        return {
+            url: res.url,
+            summary: `Open this URL to manage your subscription: ${res.url}`,
+        };
+    }
+    catch (err) {
+        throw new PercherCoreError(`Could not load the billing portal: ${err.message}`, {
+            code: "billing.portal-failed",
+            hint: "Billing may be disabled on this Percher instance, or the Polar service is temporarily unavailable.",
+            cause: err,
+        });
+    }
+}
+//# sourceMappingURL=billing.js.map

package/dist/commands/billing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing.js","sourceRoot":"","sources":["../../src/commands/billing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;CAC1C,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAarD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAY,EACZ,KAA0B;IAE1B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzD,OAAO;YACL,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,OAAO,EAAE,+BAA+B,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,GAAG,EAAE;SACjE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,gBAAgB,CAAC,wCAAyC,GAAa,CAAC,OAAO,EAAE,EAAE;YAC3F,IAAI,EAAE,yBAAyB;YAC/B,IAAI,EAAE,oGAAoG;YAC1G,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAY,EACZ,SAA6B,EAAE;IAE/B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC9C,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,GAAG,EAAE,IAAI;gBACT,OAAO,EACL,4FAA4F;aAC/F,CAAC;QACJ,CAAC;QACD,OAAO;YACL,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,OAAO,EAAE,8CAA8C,GAAG,CAAC,GAAG,EAAE;SACjE,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,gBAAgB,CAAC,sCAAuC,GAAa,CAAC,OAAO,EAAE,EAAE;YACzF,IAAI,EAAE,uBAAuB;YAC7B,IAAI,EAAE,oGAAoG;YAC1G,KAAK,EAAE,GAAG;SACX,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/commands/data.d.ts

@@ -14,6 +14,8 @@ export type DataInput = z.infer<typeof dataInputSchema>;
 export interface DataResult {
     mode: string;
     status: string;
+    /** PocketBase image tag (e.g. "0.25.0"). null for non-pocketbase modes. */
+    version: string | null;
     collections: Array<{
         name: string;
         type: string;

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

@@ -1 +1 @@
-{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/commands/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,eAAO,MAAM,eAAe;;;;;;;;;EAG1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wBAAsB,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,SAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAqBnF"}
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/commands/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,eAAO,MAAM,eAAe;;;;;;;;;EAG1B,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnD,KAAK,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,wBAAsB,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,SAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAsBnF"}

package/dist/commands/data.js

@@ -20,6 +20,7 @@ export async function data(ctx, input = {}) {
     return {
         mode: status.mode,
         status: status.status,
+        version: status.version ?? null,
         collections: collections.map((c) => ({ name: c.name, type: c.type })),
         stats,
         adminUrl: adminLink.adminUrl ?? null,

package/dist/commands/data.js.map

@@ -1 +1 @@
-{"version":3,"file":"data.js","sourceRoot":"","sources":["../../src/commands/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAWH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,GAAY,EAAE,QAAmB,EAAE;IAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,IAAI,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,gBAAgB,CAAC,4CAA4C,EAAE;YACvE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,6DAA6D;SACpE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAE3D,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrE,KAAK;QACL,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,IAAI;KACrC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"data.js","sourceRoot":"","sources":["../../src/commands/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC7B,CAAC,CAAC;AAaH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,GAAY,EAAE,QAAmB,EAAE;IAC5D,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,IAAI,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,gBAAgB,CAAC,4CAA4C,EAAE;YACvE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,6DAA6D;SACpE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,WAAW,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAE3D,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,IAAI;QAC/B,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACrE,KAAK;QACL,QAAQ,EAAE,SAAS,CAAC,QAAQ,IAAI,IAAI;KACrC,CAAC;AACJ,CAAC"}

package/dist/commands/delete.d.ts

@@ -0,0 +1,15 @@
+import { z } from "zod";
+import type { Context } from "../context";
+export declare const deleteInputSchema: z.ZodObject<{
+    app: z.ZodOptional<z.ZodString>;
+    confirm: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    confirm: boolean;
+    app?: string | undefined;
+}, {
+    confirm: boolean;
+    app?: string | undefined;
+}>;
+export type DeleteInput = z.infer<typeof deleteInputSchema>;
+export declare function deleteApp(ctx: Context, input: DeleteInput): Promise<void>;
+//# sourceMappingURL=delete.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/commands/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,eAAO,MAAM,iBAAiB;;;;;;;;;EAO5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,wBAAsB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB/E"}

package/dist/commands/delete.js

@@ -0,0 +1,26 @@
+import { z } from "zod";
+import { readPercherTomlAppName } from "../app-name";
+import { PercherCoreError } from "../errors";
+export const deleteInputSchema = z.object({
+    app: z.string().optional().describe("App name to delete (defaults to percher.toml app name)"),
+    confirm: z
+        .boolean()
+        .describe("Must be true to confirm deletion. This is a destructive operation that permanently removes the app, its container, database, domains, env vars, and deploy history."),
+});
+export async function deleteApp(ctx, input) {
+    const name = input.app ?? readPercherTomlAppName(ctx.cwd);
+    if (!name) {
+        throw new PercherCoreError("No app specified and no percher.toml found", {
+            code: "env.no-app",
+            hint: "Pass an app name or run from a directory with percher.toml.",
+        });
+    }
+    if (!input.confirm) {
+        throw new PercherCoreError(`Deletion requires explicit confirmation. Set confirm: true to delete "${name}" permanently.`, {
+            code: "delete.confirmation-required",
+            hint: `This will permanently delete the app "${name}" and all its data. Pass confirm: true to proceed.`,
+        });
+    }
+    await ctx.client.apps.delete(name);
+}
+//# sourceMappingURL=delete.js.map

package/dist/commands/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/commands/delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;IAC7F,OAAO,EAAE,CAAC;SACP,OAAO,EAAE;SACT,QAAQ,CACP,qKAAqK,CACtK;CACJ,CAAC,CAAC;AAGH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,GAAY,EAAE,KAAkB;IAC9D,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,IAAI,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,gBAAgB,CAAC,4CAA4C,EAAE;YACvE,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,6DAA6D;SACpE,CAAC,CAAC;IACL,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;QACnB,MAAM,IAAI,gBAAgB,CACxB,yEAAyE,IAAI,gBAAgB,EAC7F;YACE,IAAI,EAAE,8BAA8B;YACpC,IAAI,EAAE,yCAAyC,IAAI,oDAAoD;SACxG,CACF,CAAC;IACJ,CAAC;IACD,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC"}

package/dist/commands/deploys.d.ts

@@ -0,0 +1,45 @@
+import type { Deployment } from "@percher/client";
+import { z } from "zod";
+import type { Context } from "../context";
+export declare const deploysListInputSchema: z.ZodObject<{
+    app: z.ZodOptional<z.ZodString>;
+    limit: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    app?: string | undefined;
+    limit?: number | undefined;
+}, {
+    app?: string | undefined;
+    limit?: number | undefined;
+}>;
+export type DeploysListInput = z.infer<typeof deploysListInputSchema>;
+export declare const deploysInspectInputSchema: z.ZodEffects<z.ZodObject<{
+    app: z.ZodOptional<z.ZodString>;
+    /** Specific deploy ID. If omitted, requires `latestFailed: true`. */
+    id: z.ZodOptional<z.ZodString>;
+    /** Resolve to the most recent failed deploy on this app. */
+    latestFailed: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    app?: string | undefined;
+    id?: string | undefined;
+    latestFailed?: boolean | undefined;
+}, {
+    app?: string | undefined;
+    id?: string | undefined;
+    latestFailed?: boolean | undefined;
+}>, {
+    app?: string | undefined;
+    id?: string | undefined;
+    latestFailed?: boolean | undefined;
+}, {
+    app?: string | undefined;
+    id?: string | undefined;
+    latestFailed?: boolean | undefined;
+}>;
+export type DeploysInspectInput = z.infer<typeof deploysInspectInputSchema>;
+export interface DeploysInspectResult {
+    deploy: Deployment;
+    buildLog: string | null;
+}
+export declare function deploysList(ctx: Context, input?: DeploysListInput): Promise<Deployment[]>;
+export declare function deploysInspect(ctx: Context, input: DeploysInspectInput): Promise<DeploysInspectResult>;
+//# sourceMappingURL=deploys.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deploys.d.ts","sourceRoot":"","sources":["../../src/commands/deploys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,eAAO,MAAM,sBAAsB;;;;;;;;;EAGjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEtE,eAAO,MAAM,yBAAyB;;IAGlC,qEAAqE;;IAErE,4DAA4D;;;;;;;;;;;;;;;;;;EAU5D,CAAC;AACL,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE5E,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAMzB;AAaD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,OAAO,EACZ,KAAK,GAAE,gBAAqB,GAC3B,OAAO,CAAC,UAAU,EAAE,CAAC,CAGvB;AAED,wBAAsB,cAAc,CAClC,GAAG,EAAE,OAAO,EACZ,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,oBAAoB,CAAC,CAsC/B"}

package/dist/commands/deploys.js

@@ -0,0 +1,73 @@
+import { z } from "zod";
+import { readPercherTomlAppName } from "../app-name";
+import { PercherCoreError } from "../errors";
+export const deploysListInputSchema = z.object({
+    app: z.string().optional(),
+    limit: z.number().int().positive().max(100).optional(),
+});
+export const deploysInspectInputSchema = z
+    .object({
+    app: z.string().optional(),
+    /** Specific deploy ID. If omitted, requires `latestFailed: true`. */
+    id: z.string().optional(),
+    /** Resolve to the most recent failed deploy on this app. */
+    latestFailed: z.boolean().optional(),
+})
+    .superRefine((val, ctx) => {
+    if (!val.id && !val.latestFailed) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: "either `id` or `latestFailed: true` must be provided",
+        });
+    }
+});
+function resolveAppName(ctx, app) {
+    const name = app ?? readPercherTomlAppName(ctx.cwd);
+    if (!name) {
+        throw new PercherCoreError("No app specified and no percher.toml found", {
+            code: "deploys.no-app",
+            hint: "Pass --app <name> or run from a directory with percher.toml.",
+        });
+    }
+    return name;
+}
+export async function deploysList(ctx, input = {}) {
+    const name = resolveAppName(ctx, input.app);
+    return ctx.client.apps.listDeploys(name, { limit: input.limit ?? 10 });
+}
+export async function deploysInspect(ctx, input) {
+    const name = resolveAppName(ctx, input.app);
+    let deployId = input.id;
+    if (!deployId && input.latestFailed) {
+        // Pull a recent slice and pick the newest failed entry. listDeploys
+        // returns newest-first per the API.
+        const recent = await ctx.client.apps.listDeploys(name, { limit: 25 });
+        const failed = recent.find((d) => d.status === "failed");
+        if (!failed) {
+            throw new PercherCoreError(`No failed deploys found for "${name}"`, {
+                code: "deploys.no-failed",
+                hint: "Try `percher deploys` to list recent deploys, or omit --latest-failed.",
+            });
+        }
+        deployId = failed.id;
+    }
+    if (!deployId) {
+        throw new PercherCoreError("Deploy ID is required", {
+            code: "deploys.no-id",
+        });
+    }
+    const deploy = await ctx.client.apps.getDeployment(name, deployId);
+    // getBuildLog 404s for deploys that haven't reached the build stage —
+    // treat that as "no log yet" rather than an error so the caller can render
+    // the deploy state gracefully.
+    let buildLog = null;
+    try {
+        const log = await ctx.client.apps.getBuildLog(name, deployId);
+        buildLog = log.length > 0 ? log : null;
+    }
+    catch {
+        buildLog = null;
+    }
+    return { deploy, buildLog };
+}
+//# sourceMappingURL=deploys.js.map

package/dist/commands/deploys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploys.js","sourceRoot":"","sources":["../../src/commands/deploys.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;CACvD,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,qEAAqE;IACrE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzB,4DAA4D;IAC5D,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC;KACD,WAAW,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;IACxB,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC;QACjC,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;YAC3B,OAAO,EAAE,sDAAsD;SAChE,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAaL,SAAS,cAAc,CAAC,GAAY,EAAE,GAAY;IAChD,MAAM,IAAI,GAAG,GAAG,IAAI,sBAAsB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACpD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,gBAAgB,CAAC,4CAA4C,EAAE;YACvE,IAAI,EAAE,gBAAgB;YACtB,IAAI,EAAE,8DAA8D;SACrE,CAAC,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAY,EACZ,QAA0B,EAAE;IAE5B,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5C,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAY,EACZ,KAA0B;IAE1B,MAAM,IAAI,GAAG,cAAc,CAAC,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IAE5C,IAAI,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC;IACxB,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACpC,oEAAoE;QACpE,oCAAoC;QACpC,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;QACtE,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC;QACzD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,gBAAgB,CAAC,gCAAgC,IAAI,GAAG,EAAE;gBAClE,IAAI,EAAE,mBAAmB;gBACzB,IAAI,EAAE,wEAAwE;aAC/E,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,gBAAgB,CAAC,uBAAuB,EAAE;YAClD,IAAI,EAAE,eAAe;SACtB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAEnE,sEAAsE;IACtE,2EAA2E;IAC3E,+BAA+B;IAC/B,IAAI,QAAQ,GAAkB,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9D,QAAQ,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,GAAG,IAAI,CAAC;IAClB,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAC9B,CAAC"}

package/dist/commands/diagnose.d.ts

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import type { Context } from "../context";
+export declare const diagnoseInputSchema: z.ZodObject<{
+    app: z.ZodOptional<z.ZodString>;
+    /**
+     * How much of the crash log tail to include in the response. Defaults to
+     * 30 lines — enough for most AI explanations, small enough to keep the
+     * MCP tool response under a sensible token budget. 0 returns no log lines.
+     */
+    logLines: z.ZodOptional<z.ZodNumber>;
+    /**
+     * Staleness threshold for "recent-crash" state. If the most recent crash
+     * report is older than this and the app is not currently in status=crashed,
+     * we treat the app as healthy — the stored analysis is almost certainly
+     * unrelated to whatever the user is currently troubleshooting. Defaults to
+     * 24 hours.
+     */
+    recencyHours: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    app?: string | undefined;
+    logLines?: number | undefined;
+    recencyHours?: number | undefined;
+}, {
+    app?: string | undefined;
+    logLines?: number | undefined;
+    recencyHours?: number | undefined;
+}>;
+export type DiagnoseInput = z.infer<typeof diagnoseInputSchema>;
+export interface DiagnoseResult {
+    /**
+     * Overall state: "crashed" if the app is currently in status=crashed and
+     * a matching crash report exists; "recent-crash" if the app recovered or
+     * is multi-instance but we still have a recent crash report; "healthy" if
+     * no recent crash report was found.
+     */
+    state: "crashed" | "recent-crash" | "healthy";
+    app: {
+        name: string;
+        status: string;
+        url: string;
+    };
+    crash: {
+        id: string;
+        exitCode: number;
+        oomKilled: boolean;
+        severity: "critical" | "warning" | "info" | null;
+        createdAt: string;
+        /** Human-readable analysis from the crash analyzer, if one ran. */
+        explanation: string | null;
+        /** Suggested fix from the crash analyzer, if one ran. */
+        suggestion: string | null;
+        analysisStatus: "completed" | "skipped" | "failed" | "pending";
+        logTail: string[];
+    } | null;
+    /**
+     * Short human-readable summary the AI assistant can echo back to the
+     * user without having to synthesize explanation + suggestion itself.
+     */
+    summary: string;
+}
+/**
+ * AI-native crash diagnosis tool (MCP).
+ *
+ * Reads the most recent crash report for an app and returns the stored AI
+ * analysis (explanation + suggestion) alongside exit code, OOM flag, and a
+ * tail of the crash log. Designed to be called from Claude Code / Cursor /
+ * other MCP clients when a user says "my app isn't working" — the assistant
+ * can surface the diagnosis + proposed fix without the user leaving chat.
+ *
+ * The crash analyzer already runs inside the API and stores results on the
+ * `crash_reports` row; this command is a thin formatter on top of the
+ * existing `/apps/:appRef/crash-report` endpoint.
+ */
+export declare function diagnose(ctx: Context, input?: DiagnoseInput): Promise<DiagnoseResult>;
+//# sourceMappingURL=diagnose.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/commands/diagnose.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAG1C,eAAO,MAAM,mBAAmB;;IAE9B;;;;OAIG;;IAEH;;;;;;OAMG;;;;;;;;;;EAMH,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAIhE,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,KAAK,EAAE,SAAS,GAAG,cAAc,GAAG,SAAS,CAAC;IAC9C,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;IACF,KAAK,EAAE;QACL,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC;QACjD,SAAS,EAAE,MAAM,CAAC;QAClB,mEAAmE;QACnE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,yDAAyD;QACzD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,cAAc,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;QAC/D,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,GAAG,IAAI,CAAC;IACT;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,aAAkB,GAAG,OAAO,CAAC,cAAc,CAAC,CAsE/F"}

package/dist/commands/diagnose.js

@@ -0,0 +1,102 @@
+import { z } from "zod";
+import { readPercherTomlAppName } from "../app-name";
+import { PercherCoreError } from "../errors";
+export const diagnoseInputSchema = z.object({
+    app: z.string().optional(),
+    /**
+     * How much of the crash log tail to include in the response. Defaults to
+     * 30 lines — enough for most AI explanations, small enough to keep the
+     * MCP tool response under a sensible token budget. 0 returns no log lines.
+     */
+    logLines: z.number().int().min(0).max(200).optional(),
+    /**
+     * Staleness threshold for "recent-crash" state. If the most recent crash
+     * report is older than this and the app is not currently in status=crashed,
+     * we treat the app as healthy — the stored analysis is almost certainly
+     * unrelated to whatever the user is currently troubleshooting. Defaults to
+     * 24 hours.
+     */
+    recencyHours: z
+        .number()
+        .positive()
+        .max(24 * 30)
+        .optional(),
+});
+const DEFAULT_RECENCY_HOURS = 24;
+/**
+ * AI-native crash diagnosis tool (MCP).
+ *
+ * Reads the most recent crash report for an app and returns the stored AI
+ * analysis (explanation + suggestion) alongside exit code, OOM flag, and a
+ * tail of the crash log. Designed to be called from Claude Code / Cursor /
+ * other MCP clients when a user says "my app isn't working" — the assistant
+ * can surface the diagnosis + proposed fix without the user leaving chat.
+ *
+ * The crash analyzer already runs inside the API and stores results on the
+ * `crash_reports` row; this command is a thin formatter on top of the
+ * existing `/apps/:appRef/crash-report` endpoint.
+ */
+export async function diagnose(ctx, input = {}) {
+    const name = input.app ?? readPercherTomlAppName(ctx.cwd);
+    if (!name) {
+        throw new PercherCoreError("No app specified and no percher.toml found", {
+            code: "diagnose.no-app",
+            hint: "Pass an app name or run from a directory with percher.toml.",
+        });
+    }
+    const app = await ctx.client.apps.get(name);
+    const report = await ctx.client.apps.getCrashReport(name);
+    const logLimit = input.logLines ?? 30;
+    const recencyMs = (input.recencyHours ?? DEFAULT_RECENCY_HOURS) * 60 * 60 * 1000;
+    // Stale report on a non-crashed app is treated as no report: a weeks-old
+    // crash explanation is almost certainly not why the user is asking about
+    // "my app isn't working" today. If the app IS currently crashed we always
+    // surface the latest report regardless of age — it's the active outage.
+    const reportIsStale = !!report &&
+        app.status !== "crashed" &&
+        Date.now() - new Date(report.createdAt).getTime() > recencyMs;
+    if (!report || reportIsStale) {
+        const staleNote = reportIsStale
+            ? ` Latest crash report is older than ${input.recencyHours ?? DEFAULT_RECENCY_HOURS}h and was ignored.`
+            : "";
+        return {
+            state: "healthy",
+            app: { name: app.name, status: app.status, url: app.url },
+            crash: null,
+            summary: app.status === "live"
+                ? `${app.name} is live. No recent crash reports.${staleNote}`
+                : `${app.name} is in status "${app.status}" but no recent crash reports were found.${staleNote}`,
+        };
+    }
+    const state = app.status === "crashed" ? "crashed" : "recent-crash";
+    // Use explicit start index so logLines=0 returns []. `slice(-0)` is
+    // equivalent to `slice(0)` in JS (returns everything), which would blow
+    // past the caller's token budget.
+    const logs = report.logs ?? [];
+    const logTail = logLimit === 0 ? [] : logs.slice(Math.max(logs.length - logLimit, 0));
+    const parts = [];
+    parts.push(state === "crashed"
+        ? `${app.name} is currently crashed (exit ${report.exitCode}${report.oomKilled ? ", OOM killed" : ""}).`
+        : `${app.name} has a recent crash (exit ${report.exitCode}${report.oomKilled ? ", OOM killed" : ""}).`);
+    if (report.explanation)
+        parts.push(report.explanation);
+    if (report.suggestion)
+        parts.push(`Suggestion: ${report.suggestion}`);
+    return {
+        state,
+        app: { name: app.name, status: app.status, url: app.url },
+        crash: {
+            id: report.id,
+            exitCode: report.exitCode,
+            oomKilled: report.oomKilled,
+            severity: report.severity,
+            createdAt: report.createdAt,
+            explanation: report.explanation,
+            suggestion: report.suggestion,
+            analysisStatus: report.analysisStatus,
+            logTail,
+        },
+        summary: parts.join(" "),
+    };
+}
+//# sourceMappingURL=diagnose.js.map

package/dist/commands/diagnose.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CA2JzF"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,iBAAiB;;;;;;;;;EAG5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D,KAAK,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,GAAE,WAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAoMzF"}

package/dist/commands/doctor.js

@@ -1,3 +1,6 @@
+import { existsSync } from "node:fs";
+import { join } from "node:path";
+import { PercherTomlError, parseFile } from "@percher/toml";
 import { z } from "zod";
 import { readPercherTomlAppName } from "../app-name";
 export const doctorInputSchema = z.object({
@@ -41,14 +44,62 @@ export async function doctor(ctx, input = {}) {
         });
         return summarize(checks);
     }
-    // 4. App resolution
-    const appName = input.app ?? readPercherTomlAppName(ctx.cwd);
-    if (!appName) {
+    // 4. percher.toml — validated *before* app resolution. readPercherTomlAppName
+    // returns null on parse errors AND when the file is missing, so if we waited
+    // until after app resolution to validate, an invalid TOML would skip out as
+    // "no app" and never get a real failure check. Run validation independently
+    // so the user sees the actual issue list either way.
+    const tomlPath = join(ctx.cwd, "percher.toml");
+    const tomlExists = existsSync(tomlPath);
+    let tomlValid = false;
+    if (!tomlExists) {
         checks.push({
-            name: "App",
-            status: "skip",
-            message: "No app specified and no percher.toml found",
+            name: "percher.toml",
+            status: "warn",
+            message: "Not found in current directory",
         });
+    }
+    else {
+        try {
+            await parseFile(tomlPath);
+            tomlValid = true;
+            checks.push({ name: "percher.toml", status: "pass", message: "Valid" });
+        }
+        catch (err) {
+            if (err instanceof PercherTomlError && err.issues && err.issues.length > 0) {
+                const summary = err.issues
+                    .slice(0, 3)
+                    .map((i) => {
+                    const where = i.path.length > 0 ? `[${i.path.join(".")}]` : "(root)";
+                    return `${where} ${i.message}`;
+                })
+                    .join("; ");
+                const more = err.issues.length > 3 ? ` (+${err.issues.length - 3} more)` : "";
+                checks.push({
+                    name: "percher.toml",
+                    status: "fail",
+                    message: `${summary}${more}`,
+                });
+            }
+            else {
+                checks.push({
+                    name: "percher.toml",
+                    status: "fail",
+                    message: err.message,
+                });
+            }
+        }
+    }
+    // 5. App resolution
+    // If --app is given, we don't depend on percher.toml. Otherwise we can only
+    // pull the app name when the TOML actually parsed — readPercherTomlAppName
+    // would re-attempt the parse and return null silently otherwise.
+    const appName = input.app ?? (tomlValid ? readPercherTomlAppName(ctx.cwd) : null);
+    if (!appName) {
+        const reason = tomlExists && !tomlValid
+            ? "percher.toml is invalid — fix the issues above and re-run"
+            : "No app specified and no percher.toml found";
+        checks.push({ name: "App", status: "skip", message: reason });
         return summarize(checks);
     }
     // 5. Fetch diagnostics from the API
@@ -113,13 +164,7 @@ export async function doctor(ctx, input = {}) {
             status: "pass",
             message: diag.env.count > 0 ? `${diag.env.count} set (${diag.env.keys.join(", ")})` : "None set",
         });
-        // percher.toml
-        const hasToml = readPercherTomlAppName(ctx.cwd) !== null;
-        checks.push({
-            name: "percher.toml",
-            status: hasToml ? "pass" : "warn",
-            message: hasToml ? "Valid" : "Not found in current directory",
-        });
+        // (percher.toml validation now happens up-front — see step 4)
         // Last deploy
         if (diag.lastDeploy) {
             const deployOk = diag.lastDeploy.status === "live";