percher 0.3.0 → 0.4.1

package/dist/src/commands/transfers.d.ts

@@ -0,0 +1,20 @@
+import type { Context } from "@percher/core";
+import type { CAC } from "cac";
+/**
+ * FUTURE15 Fas D — CLI surface for ownership transfer.
+ *
+ *   percher transfer <email> [--app <name>]
+ *   percher transfer --cancel <transferId> [--app <name>]
+ *   percher transfer --list   [--app <name>]
+ *
+ *   percher transfers                (bare = incoming list)
+ *   percher transfers accept <transferId>
+ *   percher transfers decline <transferId>
+ *
+ * The `transfer` (singular) command operates on ONE app; the
+ * `transfers` (plural) command is recipient-managed across apps.
+ * Same parent-action-dispatcher pattern as the share/invites
+ * commands so cac's first-token-only matching works.
+ */
+export declare function registerTransfersCommands(cli: CAC, ctx: Context): void;
+//# sourceMappingURL=transfers.d.ts.map

package/dist/src/commands/transfers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transfers.d.ts","sourceRoot":"","sources":["../../../src/commands/transfers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAI/B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAqItE"}

package/dist/src/commands/transfers.js

@@ -0,0 +1,117 @@
+import * as core from "@percher/core";
+import pc from "picocolors";
+import { writeLine } from "../cli-utils";
+/**
+ * FUTURE15 Fas D — CLI surface for ownership transfer.
+ *
+ *   percher transfer <email> [--app <name>]
+ *   percher transfer --cancel <transferId> [--app <name>]
+ *   percher transfer --list   [--app <name>]
+ *
+ *   percher transfers                (bare = incoming list)
+ *   percher transfers accept <transferId>
+ *   percher transfers decline <transferId>
+ *
+ * The `transfer` (singular) command operates on ONE app; the
+ * `transfers` (plural) command is recipient-managed across apps.
+ * Same parent-action-dispatcher pattern as the share/invites
+ * commands so cac's first-token-only matching works.
+ */
+export function registerTransfersCommands(cli, ctx) {
+    // ── transfer (singular, owner-managed for one app) ─────────────────
+    cli
+        .command("transfer [emailOrTransferId]", "Transfer ownership of an app: `transfer <email>` initiates; `transfer --cancel <id>` cancels; `transfer --list` shows history")
+        .option("--app <name>", "App name (overrides percher.toml)")
+        .option("--cancel", "Cancel a pending transfer by id (positional arg is the transferId)")
+        .option("--list", "List the transfer history for this app")
+        .action(async (emailOrTransferId, options) => {
+        if (options.list) {
+            const rows = await core.transferListForApp(ctx, { app: options.app });
+            if (rows.length === 0) {
+                await writeLine(ctx, pc.dim("No transfers for this app."));
+                return;
+            }
+            for (const r of rows) {
+                const status = r.status === "pending"
+                    ? pc.yellow("pending")
+                    : r.status === "accepted"
+                        ? pc.green("accepted")
+                        : pc.dim(r.status);
+                await writeLine(ctx, `${r.id}  ${status.padEnd(20)}  → ${r.toEmail}  (${r.createdAt})`);
+            }
+            return;
+        }
+        if (options.cancel) {
+            if (!emailOrTransferId) {
+                throw new Error("Usage: percher transfer --cancel <transferId> [--app <name>]");
+            }
+            await core.transferCancel(ctx, {
+                app: options.app,
+                transferId: emailOrTransferId,
+            });
+            await writeLine(ctx, `${pc.green("✓")} Cancelled transfer ${emailOrTransferId}`);
+            return;
+        }
+        // No flag → initiate. Positional arg is the recipient email.
+        if (!emailOrTransferId) {
+            throw new Error("Usage: percher transfer <recipient-email> [--app <name>]  |  percher transfer --cancel <id>  |  percher transfer --list");
+        }
+        const initiated = await core.transferInitiate(ctx, {
+            app: options.app,
+            email: emailOrTransferId,
+        });
+        await writeLine(ctx, `${pc.green("✓")} Transfer initiated to ${initiated.toEmail} (id ${initiated.id})`);
+        await writeLine(ctx, pc.dim(`Expires ${new Date(initiated.expiresAt).toLocaleDateString()}. The recipient must accept via 'percher transfers accept ${initiated.id}'.`));
+        if (initiated.notes) {
+            await writeLine(ctx, pc.yellow(`  ⚠  ${initiated.notes}`));
+        }
+    });
+    // ── transfers (plural, recipient-managed across apps) ──────────────
+    cli
+        .command("transfers [action] [transferId]", "Incoming ownership transfers: list (default) | accept <transferId> | decline <transferId>")
+        .action(async (action, transferId) => {
+        if (action === undefined || action === "list") {
+            const rows = await core.transfersIncoming(ctx, {});
+            if (rows.length === 0) {
+                await writeLine(ctx, pc.dim("No pending incoming transfers."));
+                return;
+            }
+            for (const r of rows) {
+                await writeLine(ctx, `${r.id}  ${r.appName.padEnd(24)}  from ${r.fromEmail}  (expires ${new Date(r.expiresAt).toLocaleDateString()})`);
+            }
+            return;
+        }
+        if (action === "accept") {
+            if (!transferId) {
+                throw new Error("Usage: percher transfers accept <transferId>");
+            }
+            const accepted = await core.transfersAccept(ctx, { transferId });
+            await writeLine(ctx, `${pc.green("✓")} You now own ${pc.cyan(accepted.appName)}. Run 'percher open --app ${accepted.appName}' to see it.`);
+            return;
+        }
+        if (action === "decline") {
+            if (!transferId) {
+                throw new Error("Usage: percher transfers decline <transferId>");
+            }
+            await core.transfersDecline(ctx, { transferId });
+            await writeLine(ctx, `${pc.green("✓")} Declined transfer ${transferId}.`);
+            return;
+        }
+        throw new Error(`Unknown transfers action "${action}". Use list | accept <id> | decline <id>.`);
+    });
+    // Help-only registrations for --help discoverability.
+    cli.command("transfers list", "List pending incoming ownership transfers").action(async () => {
+        /* unreachable */
+    });
+    cli
+        .command("transfers accept [transferId]", "Accept an incoming ownership transfer")
+        .action(async () => {
+        /* unreachable */
+    });
+    cli
+        .command("transfers decline [transferId]", "Decline an incoming ownership transfer")
+        .action(async () => {
+        /* unreachable */
+    });
+}
+//# sourceMappingURL=transfers.js.map

package/dist/src/commands/transfers.js.map

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

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAe7C,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAmChF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAoB7C,wBAAsB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAmEhF"}

package/dist/src/index.js

@@ -1,16 +1,20 @@
-import * as core from "@percher/core";
 import cac from "cac";
-import { SilentExitError } from "./cli-utils";
+import { SilentExitError, writeUnknownCommand } from "./cli-utils";
 import { registerAccountCommands } from "./commands/account";
+import { registerAdminCommands } from "./commands/admin";
 import { registerAppsCommands } from "./commands/apps";
 import { registerAuthCommands } from "./commands/auth";
 import { registerDataCommands } from "./commands/data";
 import { registerDeploysCommands } from "./commands/deploys";
 import { registerEnvCommands } from "./commands/env";
 import { registerGithubCommands } from "./commands/github";
+import { registerMigrateCommands } from "./commands/migrate";
+import { registerSharingCommands } from "./commands/sharing";
+import { registerStatusCommands } from "./commands/status";
+import { registerTransfersCommands } from "./commands/transfers";
 import { createCliContext } from "./context";
 import { renderError } from "./output";
-import { VERSION, showTelemetryNotice, trackEvent } from "./telemetry";
+import { showTelemetryNotice, trackEvent, VERSION } from "./telemetry";
 import { checkForUpdates } from "./version-check";
 export async function run(argv, ctxOverride) {
     const cli = cac("percher");
@@ -22,13 +26,49 @@ export async function run(argv, ctxOverride) {
     registerAuthCommands(cli, ctx);
     registerAccountCommands(cli, ctx);
     registerGithubCommands(cli, ctx);
+    registerMigrateCommands(cli, ctx);
+    registerSharingCommands(cli, ctx);
+    registerStatusCommands(cli, ctx);
+    registerTransfersCommands(cli, ctx);
+    registerAdminCommands(cli, ctx);
     cli.help();
     cli.version(VERSION);
     const command = argv[0] ?? "help";
     try {
         await showTelemetryNotice();
         cli.parse(["percher", "percher", ...argv], { run: false });
-        await cli.runMatchedCommand();
+        // cac silently no-ops when no command matches: runMatchedCommand()
+        // returns early on an undefined matchedCommand, so `percher
+        // bogus-cmd` used to exit 0 with no output. cac also unsets
+        // matchedCommand after printing help/version, so a typo paired
+        // with `--help` (`percher bogus-cmd --help`) looked identical to a
+        // valid `percher open --help`. Resolve the ambiguity by checking
+        // the requested positional against the registered command names
+        // directly, not by inspecting matchedCommand or the help flag.
+        // (dogfood Fas 2 F2-#1; --help variant caught in Codex review.)
+        const requested = argv[0];
+        if (cli.matchedCommand) {
+            await cli.runMatchedCommand();
+        }
+        else if (requested === undefined || requested === "help") {
+            // Bare `percher` / `percher help` — show the command list.
+            cli.outputHelp();
+        }
+        else if (requested.startsWith("-")) {
+            // A bare flag (`--help` / `--version`) — cli.parse() already
+            // printed the relevant output and unset matchedCommand.
+        }
+        else if (cli.commands.some((cmd) => cmd.isMatched(requested))) {
+            // A real command whose action was pre-empted by `--help` /
+            // `--version`: cli.parse() prints that command's help and unsets
+            // matchedCommand. The output already happened — nothing to do.
+        }
+        else {
+            // Genuinely unknown command, with or without a trailing --help.
+            // Usage hint on stderr, exit 1 — a script must see the failure.
+            await writeUnknownCommand(ctx, requested);
+            throw new SilentExitError(1);
+        }
         trackEvent(command, "success");
         await checkForUpdates();
         return 0;

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,eAAe,CAAC;AAEtC,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,WAAqB;IAC7D,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,WAAW,IAAI,CAAC,MAAM,gBAAgB,EAAE,CAAC,CAAC;IAEtD,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/B,uBAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/B,uBAAuB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClC,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAEjC,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAErB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,mBAAmB,EAAE,CAAC;QAC5B,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,MAAM,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC9B,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC/B,MAAM,eAAe,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yDAAyD;QACzD,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;YACnC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACtC,OAAO,GAAG,CAAC,QAAQ,CAAC;QACtB,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,GAAG,MAAM,KAAK,CAAC;AACtB,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAc,EAAE,WAAqB;IAC7D,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC;IAC3B,MAAM,GAAG,GAAG,WAAW,IAAI,CAAC,MAAM,gBAAgB,EAAE,CAAC,CAAC;IAEtD,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/B,uBAAuB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACxC,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9B,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,oBAAoB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/B,uBAAuB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClC,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjC,uBAAuB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClC,uBAAuB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAClC,sBAAsB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACjC,yBAAyB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpC,qBAAqB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAEhC,GAAG,CAAC,IAAI,EAAE,CAAC;IACX,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAErB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAElC,IAAI,CAAC;QACH,MAAM,mBAAmB,EAAE,CAAC;QAC5B,GAAG,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QAC3D,mEAAmE;QACnE,4DAA4D;QAC5D,4DAA4D;QAC5D,+DAA+D;QAC/D,mEAAmE;QACnE,iEAAiE;QACjE,gEAAgE;QAChE,+DAA+D;QAC/D,gEAAgE;QAChE,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,GAAG,CAAC,cAAc,EAAE,CAAC;YACvB,MAAM,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAChC,CAAC;aAAM,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YAC3D,2DAA2D;YAC3D,GAAG,CAAC,UAAU,EAAE,CAAC;QACnB,CAAC;aAAM,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACrC,6DAA6D;YAC7D,wDAAwD;QAC1D,CAAC;aAAM,IAAI,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC;YAChE,2DAA2D;YAC3D,iEAAiE;YACjE,+DAA+D;QACjE,CAAC;aAAM,CAAC;YACN,gEAAgE;YAChE,gEAAgE;YAChE,MAAM,mBAAmB,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC1C,MAAM,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC;QAC/B,CAAC;QACD,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAC/B,MAAM,eAAe,EAAE,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yDAAyD;QACzD,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;YACnC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YACtC,OAAO,GAAG,CAAC,QAAQ,CAAC;QACtB,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACxE,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QACtC,MAAM,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnC,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/templates/astro/Caddyfile

@@ -0,0 +1,6 @@
+:8080 {
+	bind 0.0.0.0
+	root * /srv
+	encode gzip zstd
+	file_server
+}

package/dist/templates/astro/Dockerfile

@@ -0,0 +1,34 @@
+# Multi-stage build: a Bun stage compiles the static bundle, then a
+# minimal Caddy image serves it. This project uses runtime = "docker"
+# (not "static") because Percher's static runtime serves pre-built
+# files only — it does not run a build command. Generated by Percher;
+# safe to edit and own.
+
+# --- Build stage: install deps and build the static bundle -----------
+FROM oven/bun:1-alpine AS build
+WORKDIR /app
+COPY . .
+RUN bun install && bun run build
+
+# --- Serve stage: minimal Caddy image --------------------------------
+# caddy:2-alpine ships /usr/bin/caddy with cap_net_bind_service file
+# caps. Percher runs every container with --security-opt
+# no-new-privileges, which makes execve refuse a cap-bearing binary
+# (an "operation not permitted" crash-loop). Copy Caddy onto a plain
+# alpine base and strip the caps with setcap -r — Caddy never needs
+# the cap here, it listens on :8080 (>= 1024).
+FROM caddy:2-alpine AS caddy-source
+FROM alpine:3.21
+COPY --from=caddy-source /usr/bin/caddy /usr/bin/caddy
+RUN apk add --no-cache libcap \
+ && setcap -r /usr/bin/caddy \
+ && apk del libcap \
+ && rm -rf /var/cache/apk/*
+COPY Caddyfile /etc/caddy/Caddyfile
+COPY --from=build /app/dist /srv
+# HOME points at the writable tmpfs so non-root Caddy can persist its
+# XDG state (storage-clean lock, config autosave) under Percher's
+# read-only root filesystem.
+ENV HOME=/tmp
+EXPOSE 8080
+CMD ["caddy", "run", "--config", "/etc/caddy/Caddyfile", "--adapter", "caddyfile"]

package/dist/templates/astro/astro.config.mjs

@@ -0,0 +1,3 @@
+import { defineConfig } from "astro/config";
+
+export default defineConfig({});

package/dist/templates/astro/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview"
+  },
+  "dependencies": {
+    "astro": "^5.0.0"
+  }
+}

package/dist/templates/astro/percher.toml

@@ -0,0 +1,11 @@
+[app]
+name = "__APP_NAME__"
+runtime = "docker"
+framework = "astro"
+
+[web]
+port = 8080
+health = "/"
+
+[data]
+mode = "none"

package/dist/templates/astro/src/pages/index.astro

@@ -0,0 +1,15 @@
+---
+const _title = "__APP_NAME__";
+---
+
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width" />
+    <title>{title}</title>
+  </head>
+  <body>
+    <h1>Hello from {title}!</h1>
+    <p>Built with Astro on Percher.</p>
+  </body>
+</html>

package/dist/templates/bun/index.ts

@@ -0,0 +1,23 @@
+const port = Number(process.env.PORT ?? 3000);
+
+Bun.serve({
+  port,
+  hostname: "0.0.0.0",
+  fetch(req) {
+    const url = new URL(req.url);
+
+    if (url.pathname === "/health") {
+      return Response.json({ status: "ok" });
+    }
+
+    if (url.pathname === "/") {
+      return new Response("Hello from __APP_NAME__!", {
+        headers: { "Content-Type": "text/plain" },
+      });
+    }
+
+    return new Response("Not found", { status: 404 });
+  },
+});
+
+console.log(`[__APP_NAME__] listening on http://0.0.0.0:${port}`);

package/dist/templates/bun/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "__APP_NAME__",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "start": "bun run index.ts"
+  }
+}

package/dist/templates/bun/percher.toml

@@ -0,0 +1,10 @@
+[app]
+name = "__APP_NAME__"
+runtime = "bun"
+
+[web]
+port = 3000
+health = "/health"
+
+[data]
+mode = "none"

package/dist/templates/django/Procfile

@@ -0,0 +1 @@
+web: gunicorn app.wsgi:application --bind 0.0.0.0:8000

package/dist/templates/django/app/settings.py

@@ -0,0 +1,44 @@
+"""Minimal Django settings for Percher deploys."""
+import os
+from pathlib import Path
+
+BASE_DIR = Path(__file__).resolve().parent.parent
+
+SECRET_KEY = os.environ.get("DJANGO_SECRET_KEY", "change-me-set-via-percher-env")
+DEBUG = os.environ.get("DJANGO_DEBUG", "").lower() == "true"
+ALLOWED_HOSTS = ["*"]
+
+INSTALLED_APPS = [
+    "django.contrib.contenttypes",
+    "django.contrib.auth",
+    "django.contrib.staticfiles",
+]
+
+MIDDLEWARE = [
+    "django.middleware.common.CommonMiddleware",
+]
+
+ROOT_URLCONF = "app.urls"
+
+TEMPLATES = [
+    {
+        "BACKEND": "django.template.backends.django.DjangoTemplates",
+        "DIRS": [],
+        "APP_DIRS": True,
+        "OPTIONS": {},
+    },
+]
+
+WSGI_APPLICATION = "app.wsgi.application"
+
+DATABASES = {
+    "default": {
+        "ENGINE": "django.db.backends.sqlite3",
+        "NAME": BASE_DIR / "/app/data/db.sqlite3",
+    }
+}
+
+STATIC_URL = "static/"
+STATIC_ROOT = BASE_DIR / "staticfiles"
+
+DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"

package/dist/templates/django/app/urls.py

@@ -0,0 +1,21 @@
+from django.http import JsonResponse, HttpResponse
+from django.urls import path
+
+
+def index(_request):
+    return HttpResponse(
+        "<main style='font-family: system-ui; padding: 40px;'>"
+        "<h1>Hello from __APP_NAME__</h1>"
+        "<p>Django on Percher.</p>"
+        "</main>"
+    )
+
+
+def health(_request):
+    return JsonResponse({"status": "ok"})
+
+
+urlpatterns = [
+    path("", index),
+    path("health/", health),
+]

package/dist/templates/django/app/wsgi.py

@@ -0,0 +1,5 @@
+import os
+from django.core.wsgi import get_wsgi_application
+
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "app.settings")
+application = get_wsgi_application()

package/dist/templates/django/manage.py

@@ -0,0 +1,19 @@
+#!/usr/bin/env python
+"""Django's command-line utility for administrative tasks."""
+import os
+import sys
+
+
+def main():
+    os.environ.setdefault("DJANGO_SETTINGS_MODULE", "app.settings")
+    try:
+        from django.core.management import execute_from_command_line
+    except ImportError as exc:
+        raise ImportError(
+            "Couldn't import Django. Is it installed and on PYTHONPATH?"
+        ) from exc
+    execute_from_command_line(sys.argv)
+
+
+if __name__ == "__main__":
+    main()

package/dist/templates/django/percher.toml

@@ -0,0 +1,11 @@
+[app]
+name = "__APP_NAME__"
+runtime = "python"
+framework = "django"
+
+[web]
+port = 8000
+health = "/health/"
+
+[data]
+mode = "none"

package/dist/templates/django/requirements.txt

@@ -0,0 +1,2 @@
+Django>=5.0,<6.0
+gunicorn>=22.0

package/dist/templates/dotnet/Dockerfile

@@ -0,0 +1,18 @@
+FROM mcr.microsoft.com/dotnet/sdk:8.0-alpine AS build
+WORKDIR /src
+COPY app.csproj ./
+RUN dotnet restore
+COPY Program.cs ./
+RUN dotnet publish -c Release -o /out --no-restore
+
+FROM mcr.microsoft.com/dotnet/aspnet:8.0-alpine
+WORKDIR /app
+# aspnet:8.0-alpine ships with a non-root `app` user (uid 1654)
+# pre-baked. We explicitly chown + USER here so the image runs as
+# non-root regardless of any future base-image USER-default change.
+COPY --from=build --chown=app:app /out ./
+USER app
+ENV ASPNETCORE_URLS=http://+:8080
+ENV ASPNETCORE_ENVIRONMENT=Production
+EXPOSE 8080
+ENTRYPOINT ["dotnet", "app.dll"]

package/dist/templates/dotnet/Program.cs

@@ -0,0 +1,23 @@
+var builder = WebApplication.CreateBuilder(args);
+var app = builder.Build();
+
+app.MapGet("/health", () => Results.Json(new { ok = true }));
+
+app.MapGet("/", () => Results.Content(@"<!doctype html>
+<html lang=""en"">
+  <head>
+    <meta charset=""utf-8"" />
+    <title>__APP_NAME__</title>
+    <style>
+      body { font-family: system-ui, sans-serif; max-width: 640px; margin: 48px auto; padding: 0 24px; line-height: 1.6; }
+      h1 { letter-spacing: -0.5px; }
+    </style>
+  </head>
+  <body>
+    <h1>__APP_NAME__</h1>
+    <p>A .NET app deployed on Percher.</p>
+    <p>Add endpoints in <code>Program.cs</code> and push to redeploy.</p>
+  </body>
+</html>", "text/html; charset=utf-8"));
+
+app.Run();

package/dist/templates/dotnet/app.csproj

@@ -0,0 +1,9 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+  <PropertyGroup>
+    <TargetFramework>net8.0</TargetFramework>
+    <Nullable>enable</Nullable>
+    <ImplicitUsings>enable</ImplicitUsings>
+    <AssemblyName>app</AssemblyName>
+    <RootNamespace>PercherApp</RootNamespace>
+  </PropertyGroup>
+</Project>

package/dist/templates/dotnet/percher.toml

@@ -0,0 +1,11 @@
+[app]
+name = "__APP_NAME__"
+runtime = "docker"
+framework = "dotnet"
+
+[web]
+port = 8080
+health = "/health"
+
+[data]
+mode = "none"

package/dist/templates/eleventy/.eleventy.js

@@ -0,0 +1,12 @@
+module.exports = (eleventyConfig) => {
+  eleventyConfig.addPassthroughCopy("src/assets");
+  return {
+    dir: {
+      input: "src",
+      output: "_site",
+      includes: "_includes",
+    },
+    markdownTemplateEngine: "njk",
+    htmlTemplateEngine: "njk",
+  };
+};

package/dist/templates/eleventy/Caddyfile

@@ -0,0 +1,6 @@
+:8080 {
+	bind 0.0.0.0
+	root * /srv
+	encode gzip zstd
+	file_server
+}

package/dist/templates/eleventy/Dockerfile

@@ -0,0 +1,34 @@
+# Multi-stage build: a Bun stage compiles the static bundle, then a
+# minimal Caddy image serves it. This project uses runtime = "docker"
+# (not "static") because Percher's static runtime serves pre-built
+# files only — it does not run a build command. Generated by Percher;
+# safe to edit and own.
+
+# --- Build stage: install deps and build the static bundle -----------
+FROM oven/bun:1-alpine AS build
+WORKDIR /app
+COPY . .
+RUN bun install && bun run build
+
+# --- Serve stage: minimal Caddy image --------------------------------
+# caddy:2-alpine ships /usr/bin/caddy with cap_net_bind_service file
+# caps. Percher runs every container with --security-opt
+# no-new-privileges, which makes execve refuse a cap-bearing binary
+# (an "operation not permitted" crash-loop). Copy Caddy onto a plain
+# alpine base and strip the caps with setcap -r — Caddy never needs
+# the cap here, it listens on :8080 (>= 1024).
+FROM caddy:2-alpine AS caddy-source
+FROM alpine:3.21
+COPY --from=caddy-source /usr/bin/caddy /usr/bin/caddy
+RUN apk add --no-cache libcap \
+ && setcap -r /usr/bin/caddy \
+ && apk del libcap \
+ && rm -rf /var/cache/apk/*
+COPY Caddyfile /etc/caddy/Caddyfile
+COPY --from=build /app/_site /srv
+# HOME points at the writable tmpfs so non-root Caddy can persist its
+# XDG state (storage-clean lock, config autosave) under Percher's
+# read-only root filesystem.
+ENV HOME=/tmp
+EXPOSE 8080
+CMD ["caddy", "run", "--config", "/etc/caddy/Caddyfile", "--adapter", "caddyfile"]

package/dist/templates/eleventy/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "__APP_NAME__",
+  "version": "1.0.0",
+  "private": true,
+  "scripts": {
+    "build": "eleventy",
+    "dev": "eleventy --serve"
+  },
+  "devDependencies": {
+    "@11ty/eleventy": "^3.0.0"
+  }
+}