vagejs 0.3.3 → 0.3.5

package/dist/cli/index.js

@@ -197,6 +197,12 @@ cli
         throw new VageError(`Unknown --target "${target}". Use github-pages, cloudflare-workers or cloudflare-pages.`);
     const { publish } = await import("../deploy/publish.js");
     const pages = await import("../deploy/github-pages.js");
+    // Stop before pushing a site GitHub Pages would serve from a subfolder (its links would break).
+    const { gitRaw } = await import("../deploy/git.js");
+    const origin = opts.remote ?? (await gitRaw(path.resolve(opts.root), ["remote", "get-url", "origin"]).catch(() => undefined))?.stdout?.trim();
+    const subfolder = pages.pagesSubfolderProblem(config.site, origin);
+    if (subfolder)
+        throw new VageError(subfolder);
     const result = await publish(opts.root, {
         ...opts,
         extraFiles: (branch) => ({ [pages.PAGES_WORKFLOW]: pages.pagesWorkflow(branch) }),

package/dist/deploy/cloudflare-workers.js

@@ -178,7 +178,8 @@ export async function deployCloudflareWorkers(root, options) {
         output = out(upload);
         if (upload.code !== 0) {
             // Only a Worker that doesn't exist yet gets a full deploy (which also attaches routes).
-            if (!/\b10007\b|worker[^\n]*(?:does not exist|not found)/i.test(output))
+            // wrangler 4.152 says "...a new version of a Worker that does not yet exist" (no code).
+            if (!/\b10007\b|worker[^\n]*(?:does not (?:yet )?exist|not found)/i.test(output))
                 return { status: "failure", worker, reason: failReason(upload.code, output) };
             mode = "first-deploy";
             const first = await wrangler("deploy");
@@ -211,7 +212,9 @@ export async function deployCloudflareWorkers(root, options) {
                 return { status: "success", worker, mode, versionId, pageUrl };
             await sleep(3000);
         }
-        return { status: "unconfirmed", worker, mode, versionId, pageUrl, reason: `Deployed, but ${pageUrl} did not respond with 200 yet. Check it in a minute.` };
+        // `site` may not point at this Worker yet (a new domain, or a typo): say where the Worker itself answers.
+        const own = workersDev && workersDev !== pageUrl ? ` The Worker itself is at ${workersDev}. If ${pageUrl} is your own domain, attach it to the Worker (routes or a custom domain in your wrangler config).` : "";
+        return { status: "unconfirmed", worker, mode, versionId, pageUrl, reason: `Deployed, but ${pageUrl} did not respond with 200 yet. Check it in a minute.${own}` };
     }
     finally {
         if (tempDir)

package/dist/deploy/github-pages.d.ts

@@ -31,3 +31,10 @@ export declare function confirmPagesDeployment(cwd: string, sha: string, options
     sleep?: (ms: number) => Promise<void>;
     findRunAttempts?: number;
 }): Promise<DeployStatus>;
+/**
+ * GitHub Pages serves a repository named anything but <owner>.github.io from a subfolder
+ * (https://owner.github.io/repo/). vagejs sites need the root of a domain (links like
+ * /about/ would point outside the site), so that only works with a custom domain.
+ * Returns the problem to show before anything is pushed, or undefined when it's fine.
+ */
+export declare function pagesSubfolderProblem(site: string | undefined, remote: string | undefined): string | undefined;

package/dist/deploy/github-pages.js

@@ -99,3 +99,23 @@ export async function confirmPagesDeployment(cwd, sha, options = {}) {
     const pages = await run("gh", ["api", "repos/{owner}/{repo}/pages", "--jq", ".html_url"], cwd);
     return { status: "success", runUrl, pageUrl: pages.code === 0 ? pages.stdout.trim() || undefined : undefined };
 }
+/**
+ * GitHub Pages serves a repository named anything but <owner>.github.io from a subfolder
+ * (https://owner.github.io/repo/). vagejs sites need the root of a domain (links like
+ * /about/ would point outside the site), so that only works with a custom domain.
+ * Returns the problem to show before anything is pushed, or undefined when it's fine.
+ */
+export function pagesSubfolderProblem(site, remote) {
+    const m = remote && /(?:^|[@/])github\.com[/:]([^/\s]+)\/([^/\s]+?)(?:\.git)?\/?$/i.exec(remote.trim());
+    if (!m || !site)
+        return undefined;
+    const [, owner, repo] = m;
+    if (repo.toLowerCase() === `${owner}.github.io`.toLowerCase())
+        return undefined;
+    if (!/\.github\.io$/i.test(new URL(site).hostname))
+        return undefined; // a custom domain serves the root
+    return (`GitHub Pages would serve this repository at https://${owner.toLowerCase()}.github.io/${repo}/, a subfolder, ` +
+        `but a vagejs site must be served from the root of a domain: links like /about/ would point outside the site. Either:\n` +
+        `  - use your own domain: set site to it in vage.config.ts and add it in the repository under Settings → Pages → Custom domain, or\n` +
+        `  - publish from a repository named ${owner}.github.io (set site to https://${owner.toLowerCase()}.github.io).`);
+}

package/dist/dev/server.js

@@ -20,10 +20,11 @@ import { redirect } from "./preview.js";
  */
 export async function startDevServer(root, options = {}) {
     // Vite reports watcher paths with symlinks resolved, so compare against the real path.
+    // .native also expands Windows 8.3 short names (RUNNER~1 -> runneradmin).
     root = path.resolve(root);
     if (!fs.existsSync(root))
         throw new VageError(`Project directory not found: ${root}`);
-    root = fs.realpathSync(root);
+    root = fs.realpathSync.native(root);
     const pagesDir = path.join(root, "src", "pages");
     const srcDir = path.join(root, "src") + path.sep;
     const server = await createServer({
@@ -32,8 +33,12 @@ export async function startDevServer(root, options = {}) {
         server: { port: options.port, strictPort: options.port !== undefined, host: options.host },
     });
     const load = viteLoader(server);
+    // Vite reports "C:/..." on Windows; compare normalized paths, ignoring case there.
+    const key = (file) => (process.platform === "win32" ? path.resolve(file).toLowerCase() : path.resolve(file));
+    const srcKey = key(srcDir.slice(0, -1)) + path.sep;
     server.watcher.on("all", (_event, file) => {
-        if (file.startsWith(srcDir) || file === findConfigFile(root)) {
+        const config = findConfigFile(root);
+        if (key(file).startsWith(srcKey) || (config && key(file) === key(config))) {
             server.ws.send({ type: "full-reload", path: "*" });
         }
     });

package/dist/discovery/git-dates.js

@@ -1,5 +1,4 @@
 import { execFileSync } from "node:child_process";
-import fs from "node:fs";
 import path from "node:path";
 /**
  * Last commit date (ISO) of every file under src/pages, from one `git log` call.
@@ -27,11 +26,11 @@ export function gitPageDates(root) {
         if (git(["rev-parse", "--is-shallow-repository"]).trim() === "true") {
             return { problem: "this is a shallow git clone, so every page would get the latest commit's date (in GitHub Actions, use actions/checkout with fetch-depth: 0)" };
         }
-        const top = git(["rev-parse", "--show-toplevel"]).trim();
-        // git prints real paths; compare against the project's real path (e.g. /var -> /private/var on macOS).
-        const real = fs.realpathSync(root);
+        // --relative: names relative to the project folder, with "/" on every system. Comparing
+        // absolute paths breaks on Windows (8.3 short names, drive-letter case) and needs
+        // realpath on macOS (/var -> /private/var).
         // -z: NUL-separated, so file names with quotes, spaces or newlines come through exactly.
-        const out = git(["log", "-z", "--format=@@%cI", "--name-only", "--no-renames", "--", path.join(root, "src", "pages")]);
+        const out = git(["log", "-z", "--format=@@%cI", "--name-only", "--no-renames", "--relative", "--", "src/pages"]);
         const dates = new Map();
         let current = "";
         for (const raw of out.split("\0")) {
@@ -43,7 +42,7 @@ export function gitPageDates(root) {
             if (header)
                 current = header[1];
             if (name && current) {
-                const rel = path.relative(real, path.join(top, name));
+                const rel = path.join(...name.split("/"));
                 if (!dates.has(rel))
                     dates.set(rel, current); // newest first: keep the first date seen
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vagejs",
-  "version": "0.3.3",
+  "version": "0.3.5",
   "description": "A free static site generator for AI website development: Markdown pages with built-in SEO, llms.txt, checks, spam protection and safe deploys.",
   "keywords": [
     "static-site-generator",

package/templates/starter/AGENTS.md

@@ -144,7 +144,9 @@ Always ask the site owner before publishing or deploying. Show them the plan fir
 
 After deploying, `npx vage indexnow --changed-since HEAD~1` (needs `integrations.indexNow.key`) tells IndexNow search engines about changed pages. It's a hint, not a guarantee of indexing; ask the owner first.
 
-GitHub Pages needs a custom domain or a `<user>.github.io` repository, because vagejs does not support base paths yet.
+GitHub Pages needs a custom domain or a `<user>.github.io` repository, because vagejs does not support base paths yet; `vage deploy` stops before pushing when the site would land in a subfolder.
+
+Other static hosts (Vercel, Netlify and the like) work without a vagejs deploy command: build command `npm run build`, output folder `dist`, no framework preset. Config redirects become small forwarding pages there, and the `_headers` security headers apply only on Cloudflare.
 `.github/workflows/ci.yml` runs check, build and audit on every push and PR, and uploads `dist/` as a downloadable preview artifact.
 
 ## Analytics and search reports

package/templates/starter/package.json

@@ -12,6 +12,6 @@
     "preview": "vage preview"
   },
   "devDependencies": {
-    "vagejs": "^0.3.3"
+    "vagejs": "^0.3.5"
   }
 }

package/templates/starter/vage.config.ts

@@ -10,8 +10,8 @@ export default defineConfig({
   seo: {
     robots: {
       // AI crawler policy is your decision; unset means the "*" rules apply.
-      // aiTraining: "disallow", // GPTBot, ClaudeBot, Google-Extended
-      // aiSearch: "allow",      // OAI-SearchBot, Claude-SearchBot
+      // aiTraining: "disallow", // GPTBot, ClaudeBot, Google-Extended, Applebot-Extended
+      // aiSearch: "allow",      // OAI-SearchBot, Claude-SearchBot, PerplexityBot
     },
     sitemap: true,
     llmsTxt: { full: false },