Embed absolute manifest URLs and detect repo slug

Update project README generation to embed the full manifest URL instead of a placeholder/relative path. generate.js: generateProjectReadme now accepts a manifestUrl and generateProject() builds manifestUrl from siteBaseUrl and projectName before writing the README. projects/example-project/README.md links updated to use the absolute manifest URL. utils.js: enhance getRepoSlugFromEnv to fall back to reading the git remote origin URL (supports HTTPS and SSH formats) when GITHUB_REPOSITORY is not set; adds execSync import and returns an empty string on failure. These changes allow local runs to produce READMEs with correct viewer links and derive repo info outside CI.

Author: cubap

projects/example-project/README.md

@@ -12,10 +12,10 @@ This project is generated by repository scripts.
 - WARNING.md
 
 ## Links
-- Manifest: ./manifest.json
+- Manifest: https://example.org/projects/example-project/manifest.json
 - Images folder: ./images/
-- Mirador (replace MANIFEST_URL): https://projectmirador.org/embed/?iiif-content=MANIFEST_URL
-- Universal Viewer (replace MANIFEST_URL): https://uv-v3.netlify.app/#?manifest=MANIFEST_URL
+- Mirador: https://projectmirador.org/embed/?iiif-content=https://example.org/projects/example-project/manifest.json
+- Universal Viewer: https://uv-v3.netlify.app/#?manifest=https://example.org/projects/example-project/manifest.json
 
 ## TPEN3
 Use the generated manifest URL in TPEN3 when creating a new transcription project.

scripts/generate.js

@@ -668,8 +668,8 @@ function buildManifest({ projectName, siteBaseUrl, info, resources, warnings })
   return manifest
 }
 
-function generateProjectReadme(projectName) {
-  return `# ${projectName}\n\nThis project is generated by repository scripts.\n\n## Inputs\n- Add local images in images/\n- Add external references using .lnk files in images/ (one HTTP(S) URL per file)\n- Optional advanced configuration in info.yml\n\n## Generated Outputs\n- manifest.json\n- WARNING.md\n\n## Links\n- Manifest: ./manifest.json\n- Images folder: ./images/\n- Mirador (replace MANIFEST_URL): https://projectmirador.org/embed/?iiif-content=MANIFEST_URL\n- Universal Viewer (replace MANIFEST_URL): https://uv-v3.netlify.app/#?manifest=MANIFEST_URL\n\n## TPEN3\nUse the generated manifest URL in TPEN3 when creating a new transcription project.\n\n> This file is regenerated when manifest generation runs. Put durable custom metadata in info.yml.\n`
+function generateProjectReadme(projectName, manifestUrl) {
+  return `# ${projectName}\n\nThis project is generated by repository scripts.\n\n## Inputs\n- Add local images in images/\n- Add external references using .lnk files in images/ (one HTTP(S) URL per file)\n- Optional advanced configuration in info.yml\n\n## Generated Outputs\n- manifest.json\n- WARNING.md\n\n## Links\n- Manifest: ${manifestUrl}\n- Images folder: ./images/\n- Mirador: https://projectmirador.org/embed/?iiif-content=${manifestUrl}\n- Universal Viewer: https://uv-v3.netlify.app/#?manifest=${manifestUrl}\n\n## TPEN3\nUse the generated manifest URL in TPEN3 when creating a new transcription project.\n\n> This file is regenerated when manifest generation runs. Put durable custom metadata in info.yml.\n`
 }
 
 function generateWarningsMarkdown(projectName, warnings) {
@@ -725,10 +725,11 @@ async function generateProject(projectName) {
     resources: orderedResources,
     warnings
   })
+  const manifestUrl = `${siteBaseUrl}/projects/${projectName}/manifest.json`
 
   await ensureDir(projectDir)
   await writeJson(manifestPath, manifest)
-  await writeText(readmePath, generateProjectReadme(projectName))
+  await writeText(readmePath, generateProjectReadme(projectName, manifestUrl))
   await writeText(warningPath, generateWarningsMarkdown(projectName, warnings))
 
   return {

scripts/utils.js

@@ -1,5 +1,6 @@
 import fs from "node:fs/promises"
 import path from "node:path"
+import { execSync } from "node:child_process"
 import { fileURLToPath } from "node:url"
 import yaml from "js-yaml"
 
@@ -119,7 +120,31 @@ export async function writeText(filePath, text) {
 }
 
 export function getRepoSlugFromEnv() {
-  return process.env.GITHUB_REPOSITORY ?? ""
+  if (process.env.GITHUB_REPOSITORY) {
+    return process.env.GITHUB_REPOSITORY
+  }
+
+  try {
+    const remoteUrl = execSync("git config --get remote.origin.url", {
+      cwd: repoRoot,
+      encoding: "utf8",
+      stdio: ["ignore", "pipe", "ignore"]
+    }).trim()
+
+    const httpsMatch = remoteUrl.match(/^https:\/\/github\.com\/([^/]+)\/([^/]+?)(?:\.git)?$/i)
+    if (httpsMatch) {
+      return `${httpsMatch[1]}/${httpsMatch[2]}`
+    }
+
+    const sshMatch = remoteUrl.match(/^git@github\.com:([^/]+)\/([^/]+?)(?:\.git)?$/i)
+    if (sshMatch) {
+      return `${sshMatch[1]}/${sshMatch[2]}`
+    }
+  } catch {
+    return ""
+  }
+
+  return ""
 }
 
 export function buildSiteBaseUrl() {