fix(llms): correct URLs for GitHub Pages deployment

Fixed broken links in /llms.txt that resulted in 404 errors when deployed
to GitHub Pages.

Issues:
- Paths missing /documents base path prefix
- Links pointing to .md instead of /index.md for directories
  (e.g., /docs/.md instead of /docs/index.md)

Changes:
- Import and use basePath for GitHub Pages prefix (/documents)
- Change doc links from ${path}.md to ${basePath}${path}index.md
- Change API links from /api/${name}.md to ${basePath}/api/${name}/index.md

This ensures all llms.txt links work correctly on GitHub Pages where:
- Base URL is jsr-probitas.github.io/documents
- Directory pages are served as /path/index.md not /path.md

Author: lambdalisue

.claude/rules/architecture.md

@@ -18,11 +18,11 @@ documents/
 
 ## Routes
 
-| Path                  | Description              |
-| --------------------- | ------------------------ |
-| `/`                   | Landing page             |
-| `/docs/{page}`        | Documentation pages      |
-| `/api/{package}`      | API reference            |
+| Path             | Description         |
+| ---------------- | ------------------- |
+| `/`              | Landing page        |
+| `/docs/{page}`   | Documentation pages |
+| `/api/{package}` | API reference       |
 
 ## API Generation
 

.claude/rules/content.md

@@ -18,8 +18,10 @@ Every concept needs a runnable example:
 import { client, expect, scenario } from "jsr:@probitas/probitas";
 
 export default scenario("Example")
-  .resource("http", () =>
-    client.http.createHttpClient({ url: "http://localhost:8080" }))
+  .resource(
+    "http",
+    () => client.http.createHttpClient({ url: "http://localhost:8080" }),
+  )
   .step("make request", async (ctx) => {
     const res = await ctx.resources.http.get("/api/users");
     expect(res).toBeOk().toHaveStatus(200);

lib/llms.ts

@@ -4,7 +4,7 @@
  * Implements the llms.txt standard: https://llmstxt.org/
  */
 
-import { docPages, siteMetadata } from "../data/docs.ts";
+import { basePath, docPages, siteMetadata } from "../data/docs.ts";
 import { getPackageGroups, loadPackageDoc } from "../data/api-pages.ts";
 
 /**
@@ -47,7 +47,7 @@ export async function generateLlmsTxt(): Promise<string> {
     "## Documentation",
     "",
     ...docPages.map((doc) =>
-      `- [${doc.title}](${doc.path}.md): ${doc.description}`
+      `- [${doc.title}](${basePath}${doc.path}index.md): ${doc.description}`
     ),
     "",
     "## API Reference",
@@ -59,7 +59,9 @@ export async function generateLlmsTxt(): Promise<string> {
     lines.push(`### ${group.name}`, "");
     for (const pkg of group.packages) {
       const desc = await getPackageDescription(pkg.name);
-      lines.push(`- [\`${pkg.specifier}\`](/api/${pkg.name}.md): ${desc}`);
+      lines.push(
+        `- [\`${pkg.specifier}\`](${basePath}/api/${pkg.name}/index.md): ${desc}`,
+      );
     }
     lines.push("");
   }