@percher/core 0.2.6 → 0.4.0

package/dist/templates/ai-files/claude-md.js

@@ -0,0 +1,78 @@
+export const CLAUDE_MD = {
+    id: "claude-md",
+    path: "CLAUDE.md",
+    version: "1.0.0",
+    content: `# CLAUDE.md — Percher publishing instructions
+
+This project is hosted on **Percher** (https://percher.app). Apps run
+at \`<name>.percher.run\`.
+
+## Publishing
+
+\`\`\`bash
+bunx percher publish
+\`\`\`
+
+This single command:
+- Auto-generates \`percher.toml\` if missing
+- Logs in via device-code if not already authenticated
+- Packages, uploads, builds, deploys
+- Returns the live URL
+
+## Setting secrets
+
+Never put secret values in \`percher.toml\` or anywhere in source.
+
+\`\`\`bash
+# from a file:
+bunx percher env set DATABASE_URL --from-file ./secret.txt
+
+# from stdin (CI / scripts):
+echo "$MY_SECRET" | bunx percher env set DATABASE_URL --from-stdin
+
+# interactive (you type, no echo):
+bunx percher env set DATABASE_URL
+\`\`\`
+
+## Daily commands
+
+| Command                          | What it does                                  |
+| -------------------------------- | --------------------------------------------- |
+| \`bunx percher publish\`         | Build + deploy this project.                  |
+| \`bunx percher dev\`             | Watch files, redeploy on change, stream logs. |
+| \`bunx percher logs\`            | Tail runtime logs.                            |
+| \`bunx percher logs --build\`    | Show last failed build's full log.            |
+| \`bunx percher deploys\`         | List recent deploys with status.              |
+| \`bunx percher rollback <sha>\`  | Roll back to a previous version.              |
+| \`bunx percher doctor\`          | Diagnose config / connectivity.               |
+| \`bunx percher env list\`        | Show env vars (values masked).                |
+
+## MCP
+
+For MCP-aware editors (Claude Code, Cursor, Windsurf), run
+\`bunx percher mcp\` to print a paste-ready config block.
+
+## When the build fails
+
+Don't guess. Run:
+
+\`\`\`bash
+bunx percher logs --build
+\`\`\`
+
+The output ends with the actual compiler/builder error. Show it back,
+fix the root cause, and retry.
+
+## Don'ts
+
+- Don't add \`percher.toml\` fields not in the documented schema.
+- Don't commit secrets — use \`percher env set\`.
+- Don't use \`--no-verify\` or other bypass flags on git operations.
+- Don't \`rm -rf\` the \`.percher/\` directory — it tracks managed
+  AI-files. Use \`bunx percher ai-files remove\` instead.
+
+This file is managed by \`bunx percher ai-files\`. Run
+\`bunx percher ai-files update\` to pull updates.
+`,
+};
+//# sourceMappingURL=claude-md.js.map

package/dist/templates/ai-files/claude-md.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-md.js","sourceRoot":"","sources":["../../../src/templates/ai-files/claude-md.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,EAAE,EAAE,WAAoB;IACxB,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuEV;CACA,CAAC"}

package/dist/templates/ai-files/cursor-percher-mdc.d.ts

@@ -0,0 +1,7 @@
+export declare const CURSOR_PERCHER_MDC: {
+    id: "cursor-percher-mdc";
+    path: string;
+    version: string;
+    content: string;
+};
+//# sourceMappingURL=cursor-percher-mdc.d.ts.map

package/dist/templates/ai-files/cursor-percher-mdc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-percher-mdc.d.ts","sourceRoot":"","sources":["../../../src/templates/ai-files/cursor-percher-mdc.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB;;;;;CA6G9B,CAAC"}

package/dist/templates/ai-files/cursor-percher-mdc.js

@@ -0,0 +1,111 @@
+export const CURSOR_PERCHER_MDC = {
+    id: "cursor-percher-mdc",
+    path: ".cursor/rules/percher.mdc",
+    version: "1.0.0",
+    content: `---
+description: How to publish this project to Percher
+globs: ["percher.toml", "**/*.{ts,tsx,js,jsx,py}"]
+alwaysApply: false
+---
+
+# Publishing to Percher
+
+Percher hosts AI-built web apps. The user says "publish my app" → it's
+live at \`name.percher.run\`.
+
+## Quick reference
+
+- **CLI:** \`bunx percher\` (or \`npx percher\`)
+- **Config:** \`percher.toml\` in project root
+- **Deploy:** \`bunx percher publish\` — handles auth, config, build, deploy
+- **Dashboard:** https://percher.app
+
+## Before deploying
+
+1. Check \`percher.toml\` exists. If not, run \`bunx percher init\` (or just
+   run \`publish\` — it auto-generates one).
+2. Make sure secrets are set: \`bunx percher env set KEY --from-stdin\`
+   (or \`KEY=VALUE\` for non-secrets).
+3. For secrets, never use \`KEY=VALUE\` — use \`--from-stdin\`,
+   \`--from-file <path>\`, or bare \`KEY\` (interactive prompt).
+
+## Common percher.toml shapes
+
+\`\`\`toml
+# Next.js
+[app]
+name = "my-app"
+runtime = "node"
+framework = "nextjs"
+[build]
+command = "bun run build"
+output = ".next"
+[web]
+port = 3000
+health = "/api/health"
+[data]
+mode = "pocketbase"
+\`\`\`
+
+\`\`\`toml
+# Static (Vite, plain HTML)
+[app]
+name = "my-app"
+runtime = "static"
+[build]
+command = "bun run build"
+output = "dist"
+\`\`\`
+
+## Build-time public env vars
+
+Frameworks like Next/Vite/Astro bake \`*_PUBLIC_*\` values into the bundle
+at build time. Vars matching the public-prefix conventions
+(\`NEXT_PUBLIC_*\`, \`VITE_*\`, \`PUBLIC_*\`, \`REACT_APP_*\`, \`VUE_APP_*\`,
+\`EXPO_PUBLIC_*\`) auto-forward to the build container — just \`bunx percher
+env set NEXT_PUBLIC_API_URL=…\` and it lands in the bundle on the next
+deploy. No TOML changes needed.
+
+Server-secret build tokens that DON'T match a prefix (Sentry source-map
+upload, private npm registries) require explicit opt-in:
+
+\`\`\`toml
+[build]
+pass_env = ["SENTRY_AUTH_TOKEN", "NPM_TOKEN"]
+\`\`\`
+
+Values still come from \`bunx percher env set …\`; the TOML only declares
+which non-prefix keys leak into the build.
+
+## Outbound HTTPS
+
+Apps reach the public internet through a forward proxy. Bun's \`fetch\`
+and Node 24+ \`fetch\` (with \`NODE_USE_ENV_PROXY=1\`, set automatically)
+honor it. Node ≤22 needs:
+
+\`\`\`ts
+import { ProxyAgent, setGlobalDispatcher } from "undici";
+if (process.env.HTTPS_PROXY) {
+  setGlobalDispatcher(new ProxyAgent(process.env.HTTPS_PROXY));
+}
+\`\`\`
+
+## When something fails
+
+- \`bunx percher logs\` — runtime logs
+- \`bunx percher logs --build\` — last failed build's log
+- \`bunx percher doctor\` — connectivity + config check
+- \`bunx percher deploys --limit 5\` — recent deploys + status
+
+## Rules
+
+1. Never put real secrets in \`percher.toml\`. Use \`bunx percher env set\`.
+2. Never invent \`percher.toml\` fields. Stick to documented schema.
+3. Always add a \`/health\` endpoint when the framework has a server.
+4. \`percher.toml\` is the source of truth — read from it, don't guess.
+
+This file is managed by \`bunx percher ai-files\`. Run
+\`bunx percher ai-files update\` to pull updates.
+`,
+};
+//# sourceMappingURL=cursor-percher-mdc.js.map

package/dist/templates/ai-files/cursor-percher-mdc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-percher-mdc.js","sourceRoot":"","sources":["../../../src/templates/ai-files/cursor-percher-mdc.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,EAAE,EAAE,oBAA6B;IACjC,IAAI,EAAE,2BAA2B;IACjC,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwGV;CACA,CAAC"}

package/dist/templates/ai-files/index.d.ts

@@ -0,0 +1,8 @@
+export interface AiFileTemplate {
+    id: string;
+    path: string;
+    version: string;
+    content: string;
+}
+export declare const AI_FILE_TEMPLATES: readonly AiFileTemplate[];
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/ai-files/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/ai-files/index.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,iBAAiB,EAAE,SAAS,cAAc,EAAoC,CAAC"}

package/dist/templates/ai-files/index.js

@@ -0,0 +1,4 @@
+import { CLAUDE_MD } from "./claude-md";
+import { CURSOR_PERCHER_MDC } from "./cursor-percher-mdc";
+export const AI_FILE_TEMPLATES = [CLAUDE_MD, CURSOR_PERCHER_MDC];
+//# sourceMappingURL=index.js.map

package/dist/templates/ai-files/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/ai-files/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAS1D,MAAM,CAAC,MAAM,iBAAiB,GAA8B,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@percher/core",
-  "version": "0.2.6",
+  "version": "0.4.0",
   "description": "Core logic and CLI commands for the Percher hosting platform",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,11 +29,12 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@percher/client": "^0.2.0",
-    "@percher/toml": "^0.1.1",
-    "ignore": "^6.0.2",
+    "@percher/client": "^0.2.7",
+    "@percher/shared": "^0.1.0",
+    "@percher/toml": "^0.1.3",
+    "ignore": "^7.0.5",
     "tar-stream": "^3.1.7",
-    "zod": "^3.23.8"
+    "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/tar-stream": "^3.1.3",