fix: update baseUrl to GitHub Pages and add mtime-based updatedAt

- Change default baseUrl from Deno Deploy to GitHub Pages
- Add updatedAt option to generateApiMarkdown for file mtime display
- Update .claude/CLAUDE.md deployment info for GitHub Pages

Author: lambdalisue

.claude/CLAUDE.md

@@ -8,7 +8,7 @@ Repository: `probitas/documents`
 
 - **Runtime**: Deno 2.x
 - **Framework**: Hono (web server)
-- **Deploy**: New Deno Deploy (`documents.probitas.deno.net`)
+- **Deploy**: GitHub Pages (`https://jsr-probitas.github.io/documents`)
 
 ## Commands
 
@@ -17,39 +17,22 @@ deno task dev      # Start dev server with watch mode
 deno task start    # Start production server
 deno task check    # Type check all .ts files
 deno task verify   # Run fmt, lint, and check
+deno task build    # Build static site for deployment
 ```
 
 ## Deployment
 
-This project uses the **new Deno Deploy** (not Deploy Classic).
+This project is deployed to **GitHub Pages** as a static site.
 
-### Key Differences from Deploy Classic
+### Build Process
 
-| Feature    | New Deno Deploy              | Deploy Classic              |
-| ---------- | ---------------------------- | --------------------------- |
-| URL format | `{app}.{org}.deno.net`       | `{project}.deno.dev`        |
-| Console    | `console.deno.com`           | `dash.deno.com`             |
-| Build      | Integrated CI/CD or external | External only (`deployctl`) |
-| CLI        | `deno` CLI built-in          | Separate `deployctl`        |
+1. Run `deno task build` to generate static files in `dist/`
+2. GitHub Actions automatically deploys on push to main branch
 
-### New Deno Deploy Features
+### Local Development
 
-- **Integrated CI/CD**: Connect GitHub repo for automatic branch deploys and
-  previews
-- **`--tunnel` flag**: `deno run --tunnel` exposes local dev to public URL with
-  environment variables from dashboard
-- **OpenTelemetry**: Built-in logging, tracing, and metrics
-- **Framework detection**: Auto-detects Hono and optimizes configuration
-
-### Deployment Methods
-
-1. **GitHub Integration** (recommended): Connect repo, auto-deploy on push
-2. **Manual trigger**: Select branch and trigger build from console
-3. **Local tunnel**: `deno run --tunnel main.ts` for testing with production env
-
-### Console Access
-
-- Dashboard: https://console.deno.com
+- `deno task dev` - Start dev server with hot reload
+- `deno task start` - Start production server locally
 
 ## Related Documentation
 

lib/api-markdown.ts

@@ -61,7 +61,7 @@ class TypeReferenceCollector {
     localTypes: Set<string>,
     typeToPackage: Map<string, string>,
     currentPackage: string,
-    baseUrl = "https://documents.probitas.deno.net",
+    baseUrl = "https://jsr-probitas.github.io/documents",
   ) {
     this.localTypes = localTypes;
     this.typeToPackage = typeToPackage;
@@ -532,6 +532,8 @@ export interface ApiMarkdownOptions {
   allPackages?: PackageDoc[];
   /** Base URL for links */
   baseUrl?: string;
+  /** Last updated timestamp (from file mtime) */
+  updatedAt?: Date;
 }
 
 /**
@@ -542,8 +544,11 @@ export function generateApiMarkdown(
   options: ApiMarkdownOptions = {},
 ): string {
   const lines: string[] = [];
-  const { allPackages = [], baseUrl = "https://documents.probitas.deno.net" } =
-    options;
+  const {
+    allPackages = [],
+    baseUrl = "https://jsr-probitas.github.io/documents",
+    updatedAt,
+  } = options;
 
   // Build local types set
   const localTypes = new Set<string>();
@@ -738,5 +743,12 @@ export function generateApiMarkdown(
     }
   }
 
+  // Footer with last updated timestamp
+  if (updatedAt) {
+    lines.push("---");
+    lines.push("");
+    lines.push(`*Last updated: ${updatedAt.toISOString().split("T")[0]}*`);
+  }
+
   return lines.join("\n");
 }

main.ts

@@ -134,8 +134,12 @@ app.get(
         `./data/api/${packageName}.json`,
         import.meta.url,
       );
-      const content = await Deno.readTextFile(jsonPath);
+      const [content, stat] = await Promise.all([
+        Deno.readTextFile(jsonPath),
+        Deno.stat(jsonPath),
+      ]);
       const pkg: PackageDoc = JSON.parse(content);
+      const updatedAt = stat.mtime ?? undefined;
 
       // Load all packages for cross-package linking
       const indexPath = new URL("./data/api/index.json", import.meta.url);
@@ -156,7 +160,7 @@ app.get(
         }
       }
 
-      const markdown = generateApiMarkdown(pkg, { allPackages });
+      const markdown = generateApiMarkdown(pkg, { allPackages, updatedAt });
       return c.text(markdown, 200, {
         "Content-Type": "text/markdown; charset=utf-8",
       });