uniweb 0.87.3 → 0.88.0

package/src/index.js

@@ -41,7 +41,8 @@ import { template } from './commands/template.js'
 import {
   resolveTemplate,
   parseTemplateId,
-  buildTemplateChoices
+  buildTemplateChoices,
+  templatePickerPageSize
 } from './templates/index.js'
 import { validateTemplate } from './templates/validator.js'
 import {
@@ -72,6 +73,7 @@ import {
   formatOptions
 } from './utils/interactive.js'
 import { findWorkspaceRoot } from './utils/workspace.js'
+import { exitWhenDrained } from './utils/exit.js'
 
 // Colors for terminal output
 const colors = {
@@ -85,9 +87,8 @@ const colors = {
 }
 
 // Template choices for the interactive prompt — built-ins first, then every
-// official template from the shared manifest (so the list never drifts from
-// framework/templates/manifest.json), with "Blank" last. Composed by
-// buildTemplateChoices() in templates/resolver.js.
+// official template in this CLI's snapshot (the list `create` can download),
+// with "Blank" last. Composed by buildTemplateChoices() in templates/resolver.js.
 const TEMPLATE_CHOICES = buildTemplateChoices()
 
 // Files that may pre-exist in the target dir during `uniweb create .` and
@@ -223,7 +224,7 @@ function delegateToLocal(localCliPath) {
       [localCliPath, ...process.argv.slice(2)],
       { stdio: 'inherit' }
     )
-    child.on('close', (code) => process.exit(code ?? 0))
+    child.on('close', (code) => exitWhenDrained(code ?? 0))
     child.on('error', reject)
   })
 }
@@ -320,7 +321,7 @@ async function importProjectCommand(modulePath) {
       log(`  ${colors.cyan}npm install uniweb ${missing}${colors.reset}`)
     }
 
-    process.exit(1)
+    await exitWhenDrained(1)
   }
 }
 
@@ -554,11 +555,7 @@ async function createFromContentTemplate(
         contentDir.dir,
         fullPath,
         { projectName },
-        {
-          onProgress,
-          onWarning,
-          renames: contentDir.renames
-        }
+        { onProgress, onWarning }
       )
       ensureFoundationName(fullPath, registryName)
     }
@@ -651,7 +648,7 @@ async function main() {
   // beside the new one it is ignored, so a script can carry both while CLIs of both ages run it.
   if (process.env.UNIWEB_REGISTER_URL && !process.env.UNIWEB_SERVER) {
     error('UNIWEB_REGISTER_URL is now UNIWEB_SERVER — rename it, and the command goes to the same backend.')
-    process.exit(2)
+    await exitWhenDrained(2)
   }
 
   // Handle --version / -v
@@ -676,9 +673,9 @@ async function main() {
         const { fetchAndNotifyIfNewer, maybeNotifyFromCache } =
           await import('./utils/update-check.js')
         if (process.stdout.isTTY) {
-          await fetchAndNotifyIfNewer(getCliVersion(), { tone: 'soft' })
+          await fetchAndNotifyIfNewer(getCliVersion())
         } else {
-          maybeNotifyFromCache(getCliVersion(), 'soft')
+          maybeNotifyFromCache(getCliVersion())
         }
       } catch {
         /* ignore */
@@ -699,30 +696,36 @@ async function main() {
     // Commands that need @uniweb/build will get a helpful error via importProjectCommand().
   }
 
-  // Start non-blocking update check for global installs.
+  // Update check for global installs.
   //
-  // Two surfaces:
-  //   - showUpdateNotification (soft, trailing): printed at command end for
-  //     any verb. Doesn't interrupt the user's workflow.
-  //   - eager (loud, leading): printed BEFORE staleness-sensitive verbs do
-  //     their work. Today: only `create` (templates ship with the CLI, so
-  //     a stale CLI scaffolds stale starter content; the user needs to know
-  //     before files hit disk). Other verbs are insensitive — `deploy` etc.
-  //     are project-bound (delegated to local node_modules), and the
-  //     local-vs-global mismatch warning in delegateToLocal already covers
-  //     that case.
+  //   - `create` / `clone` STOP when a newer release exists, before anything is
+  //     written: a project starts on the packages and templates of the CLI that
+  //     creates it, and a global install runs these two itself — there is no
+  //     project CLI to delegate to yet (refuseOutdatedProjectStart). Their
+  //     `--help` still prints.
+  //   - every other verb gets a trailing notice (showUpdateNotification): they
+  //     are project-bound (delegated to local node_modules) or do not depend on
+  //     the version, and the local-vs-global mismatch warning in
+  //     delegateToLocal covers the first case.
   let showUpdateNotification = () => {}
   if (global) {
+    let updateCheck = null
     try {
-      const { startUpdateCheck, maybeEagerNotification } =
-        await import('./utils/update-check.js')
-      showUpdateNotification = startUpdateCheck(getCliVersion())
-      if (command === 'create') {
-        maybeEagerNotification(getCliVersion())
-      }
+      updateCheck = await import('./utils/update-check.js')
     } catch {
       // Update check is optional — don't fail if the module is missing
     }
+    const startsProject = command === 'create' || command === 'clone'
+    const asksForHelp = args.slice(1).some((a) => a === '--help' || a === '-h')
+    if (
+      updateCheck &&
+      startsProject &&
+      !asksForHelp &&
+      (await updateCheck.refuseOutdatedProjectStart(getCliVersion(), args))
+    ) {
+      await exitWhenDrained(1)
+    }
+    if (updateCheck) showUpdateNotification = updateCheck.startUpdateCheck(getCliVersion())
   }
 
   // Show help
@@ -794,14 +797,14 @@ async function main() {
   if (command === 'doctor') {
     const { doctor } = await importProjectCommand('./commands/doctor.js')
     const result = await doctor(args.slice(1))
-    process.exit(result?.errors > 0 ? 1 : 0)
+    await exitWhenDrained(result?.errors > 0 ? 1 : 0)
   }
 
   // Handle validate command (dynamic import — depends on @uniweb/build)
   if (command === 'validate') {
     const { validate } = await importProjectCommand('./commands/validate.js')
     const result = await validate(args.slice(1))
-    process.exit(result?.exitCode ?? 0)
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle register command (dynamic import — depends on @uniweb/build).
@@ -810,35 +813,35 @@ async function main() {
   if (command === 'register' || command === 'release') {
     const { register } = await importProjectCommand('./commands/register.js')
     const result = await register(args.slice(1))
-    process.exit(result?.exitCode ?? 0)
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle push command (dynamic import — depends on @uniweb/build)
   if (command === 'push') {
     const { push } = await importProjectCommand('./commands/push.js')
     const result = await push(args.slice(1))
-    process.exit(result?.exitCode ?? 0)
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle pull command (dynamic import — depends on @uniweb/build)
   if (command === 'pull') {
     const { pull } = await importProjectCommand('./commands/pull.js')
     const result = await pull(args.slice(1))
-    process.exit(result?.exitCode ?? 0)
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle sync command (refresh + push; both halves imported, never reimplemented)
   if (command === 'sync') {
     const { sync } = await importProjectCommand('./commands/sync.js')
     const result = await sync(args.slice(1))
-    process.exit(result?.exitCode ?? 0)
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle refresh command (dynamic import — depends on @uniweb/build via pull)
   if (command === 'refresh') {
     const { refresh } = await importProjectCommand('./commands/refresh.js')
     const result = await refresh(args.slice(1))
-    process.exit(result?.exitCode ?? 0)
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle forget — remove one backend's local records (sync.json, cache, deploy
@@ -847,14 +850,14 @@ async function main() {
   if (command === 'forget') {
     const { forget } = await importProjectCommand('./commands/forget.js')
     const result = await forget(args.slice(1))
-    process.exit(result?.exitCode ?? 0)
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle status command (dynamic import — offline emit via @uniweb/build)
   if (command === 'status') {
     const { status } = await importProjectCommand('./commands/status.js')
     const result = await status(args.slice(1))
-    process.exit(result?.exitCode ?? 0)
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle clone command (global — bootstraps a new project from a backend site;
@@ -864,7 +867,7 @@ async function main() {
   // `uniweb pull` after install.)
   if (command === 'clone') {
     const result = await clone(args.slice(1))
-    process.exit(result?.exitCode ?? 0)
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle update command
@@ -899,7 +902,7 @@ async function main() {
   if (command === 'publish') {
     const { publish } = await importProjectCommand('./commands/publish.js')
     const result = await publish(args.slice(1))
-    process.exit(result?.exitCode ?? 0)
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle deploy command — third-party hosts only (dynamic import — @uniweb/build)
@@ -946,7 +949,7 @@ async function main() {
     // dropped, the login would go to the default backend.
     if (loginArgs.some((a) => a === '--backend' || a.startsWith('--backend='))) {
       console.error('\x1b[31m✗\x1b[0m `--backend` is now `--server`: uniweb login --server <url>')
-      process.exit(2)
+      await exitWhenDrained(2)
     }
     let apiBase
     try {
@@ -955,7 +958,7 @@ async function main() {
       console.error(
         `\x1b[31m✗\x1b[0m ${err.message} — e.g. uniweb login --server http://localhost:8080`
       )
-      process.exit(2)
+      await exitWhenDrained(2)
     }
     await runRegistryLogin({ apiBase, args: loginArgs })
     return
@@ -971,7 +974,7 @@ async function main() {
       console.error(
         `\x1b[31m✗\x1b[0m \`uniweb logout\` takes no options (got ${stray}) — it logs you out of the backend you are logged in to.`
       )
-      process.exit(2)
+      await exitWhenDrained(2)
     }
     const { clearRegistryAuth } = await import('./utils/registry-auth.js')
     const { loggedInOrigin } = await import('./utils/config.js')
@@ -994,12 +997,9 @@ async function main() {
   if (command === 'site') {
     const { site } = await import('./commands/site.js')
     const result = await site(args.slice(1))
-    // ⛔ EXIT ONLY ONCE STDOUT HAS DRAINED. To a pipe Node writes asynchronously, so an exit
-    // straight after a long list cut it at 8192 bytes — measured 2026-10-07: `site list --json`
-    // of 79 sites reached a reading process as half a JSON document, while the same command
-    // into a file (synchronous) was whole. Pinned by test/site-list-pipe.test.js.
-    await new Promise((resolve) => process.stdout.write('', resolve))
-    process.exit(result?.exitCode ?? 0)
+    // Its long list is where a bare exit was first caught cutting a pipe short — pinned by
+    // test/site-list-pipe.test.js; why every exit waits: utils/exit.js.
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle org command (new-backend orgs/units — publish-scope management)
@@ -1030,15 +1030,15 @@ async function main() {
 
   // Handle template command
   if (command === 'template') {
-    await template(args.slice(1))
-    return
+    const result = await template(args.slice(1))
+    await exitWhenDrained(result?.exitCode ?? 0)
   }
 
   // Handle create command
   if (command !== 'create') {
     error(`Unknown command: ${command}`)
     showHelp()
-    process.exit(1)
+    await exitWhenDrained(1)
   }
 
   title('Uniweb Project Generator')
@@ -1053,7 +1053,7 @@ async function main() {
     log(
       `  ${colors.cyan}uniweb add foundation --from <template>${colors.reset}\n`
     )
-    process.exit(1)
+    await exitWhenDrained(1)
   }
 
   // Parse arguments
@@ -1081,7 +1081,7 @@ async function main() {
       parseTemplateId(templateType)
     } catch (err) {
       error(`Invalid template: ${err.message}`)
-      process.exit(1)
+      await exitWhenDrained(1)
     }
   }
 
@@ -1127,7 +1127,7 @@ async function main() {
           `Could not derive a valid project name from the current directory ("${dirName}").`
         )
         log(`Re-run with ${colors.cyan}--name=<your-name>${colors.reset}.`)
-        process.exit(1)
+        await exitWhenDrained(1)
       }
       projectName = slug
       if (slug !== dirName) {
@@ -1144,7 +1144,7 @@ async function main() {
   if (nonInteractive && !projectName) {
     error(`Missing project name.\n`)
     log(`Usage: ${prefix} create <project-name> [--template <name>] [--blank]`)
-    process.exit(1)
+    await exitWhenDrained(1)
   }
 
   // Non-interactive: default to starter when no template specified
@@ -1172,7 +1172,7 @@ async function main() {
     {
       onCancel: () => {
         log('\nScaffolding cancelled.')
-        process.exit(0)
+        process.exit(0) // a prompt: a terminal, so nothing to drain — and it must stop here, now
       }
     }
   )
@@ -1181,7 +1181,7 @@ async function main() {
 
   if (!projectName) {
     error('Missing project name')
-    process.exit(1)
+    await exitWhenDrained(1)
   }
 
   // Prompt for template if not specified via --template or --blank
@@ -1192,12 +1192,13 @@ async function main() {
         name: 'template',
         message: 'Template:',
         choices: TEMPLATE_CHOICES,
-        initial: 1
+        initial: 1,
+        optionsPerPage: templatePickerPageSize(TEMPLATE_CHOICES.length)
       },
       {
         onCancel: () => {
           log('\nScaffolding cancelled.')
-          process.exit(0)
+          process.exit(0) // a prompt: a terminal, so nothing to drain — and it must stop here, now
         }
       }
     )
@@ -1219,7 +1220,7 @@ async function main() {
 
   if (!inPlace && existsSync(projectDir)) {
     error(`Directory already exists: ${projectName}`)
-    process.exit(1)
+    await exitWhenDrained(1)
   }
 
   if (inPlace) {
@@ -1245,7 +1246,7 @@ async function main() {
       log(
         `Move or remove them, then re-run ${colors.cyan}uniweb create .${colors.reset}.`
       )
-      process.exit(1)
+      await exitWhenDrained(1)
     }
   }
 
@@ -1292,7 +1293,7 @@ async function main() {
       )
 
       // Validate and apply as format 2 content template
-      const metadata = await validateTemplate(resolved.path, {})
+      const metadata = await validateTemplate(resolved.path)
 
       try {
         await createFromContentTemplate(
@@ -1320,7 +1321,7 @@ async function main() {
       log(
         `  • Try the starter template instead: ${colors.cyan}uniweb create ${projectName} --template starter${colors.reset}`
       )
-      process.exit(1)
+      await exitWhenDrained(1)
     }
   }
 
@@ -1506,7 +1507,8 @@ ${colors.bright}Usage:${colors.reset}
 
 ${colors.bright}Options:${colors.reset}
   --template <type>  Project template (default: starter)
-                     Built-in: starter, none, marketing
+                     Built-in: starter, none, blank
+                     Official: marketing, docs, … (\`uniweb template list\`)
                      Local:    ./path/to/template
                      npm:      @scope/template-name
                      GitHub:   github:user/repo or https://github.com/user/repo
@@ -1666,12 +1668,13 @@ ${colors.dim}Hosts that support PR previews: cloudflare-pages, netlify, vercel.
 GitHub Pages has no preview environment, so it scaffolds a deploy workflow only.${colors.reset}
 
 ${colors.bright}Examples:${colors.reset}
-  uniweb add project docs                              # Create docs/foundation/ + docs/site/
+  uniweb add project docs                              # Create docs/src/ + docs/site/
   uniweb add project docs --from academic              # Co-located pair + academic content
-  uniweb add foundation                                # Create ./foundation/ at root
-  uniweb add foundation ui                             # Create ./foundations/ui/
+  uniweb add foundation                                # Create ./src/ at root
+  uniweb add foundation ui                             # Create ./ui/ — the folder you name
+  uniweb add foundation foundations/ui                 # Create ./foundations/ui/
   uniweb add site                                      # Create ./site/ at root
-  uniweb add site blog --foundation marketing          # Create ./sites/blog/ wired to marketing
+  uniweb add site blog --foundation marketing          # Create ./blog/ wired to marketing
   uniweb add extension effects --site site             # Create ./extensions/effects/
   uniweb add section Hero                              # Create Hero section type
   uniweb add section Hero --foundation ui              # Target specific foundation
@@ -1679,7 +1682,7 @@ ${colors.bright}Examples:${colors.reset}
   uniweb add section Pricing --starter                 # Scaffold Pricing + content that fills it
   uniweb add section Hero --starter --preset split     # Frontmatter it with the 'split' preset
   uniweb add section Hero --starter --json             # The structure + ProseMirror, for a script
-  uniweb add foundation --project docs                 # Create ./docs/foundation/ (co-located)
+  uniweb add foundation --project docs                 # Create ./docs/src/ (co-located)
   uniweb add site --project docs                       # Create ./docs/site/ (co-located)
   uniweb add ci                                        # Pick a host, add a deploy workflow
   uniweb add ci --host github-pages --site marketing   # Pick host + site explicitly
@@ -1971,18 +1974,12 @@ ${colors.bright}Usage:${colors.reset}
 
 ${colors.bright}What \`list\` reports:${colors.reset}
   The roster ${colors.bright}this CLI ships with${colors.reset} — a snapshot baked in at publish time,
-  not a live fetch. That is the right question when the next step is resolving
-  one of those names with the same CLI, which is why \`--json\` stamps
-  \`cliVersion\`. A template newer than your CLI will not be listed.
+  not a live fetch. \`create\` downloads these templates from the release the same
+  snapshot names, which is why \`--json\` stamps \`cliVersion\`. A template newer than
+  your CLI is not listed: \`npx uniweb@latest template list\` shows the current roster.
 
   It is the ${colors.bright}official${colors.reset} roster, not the set of resolvable names: an unknown
   name is not fatal, since \`create\` falls through to npm \`@uniweb/template-<name>\`.
-
-${colors.bright}Reserved:${colors.reset}
-  \`uniweb template register\` is not available on the new backend yet. Submitting
-  a site as a cloud template was retired with the legacy backend; when rebuilt, a
-  template is REGISTERED (like a foundation) — \`publish\` is for sites only.
-  Scaffolding FROM a template is unaffected: \`uniweb create --template <name>\`.
 `,
     docs: `
 ${colors.cyan}${colors.bright}uniweb docs${colors.reset} ${colors.dim}— Generate component documentation${colors.reset}
@@ -2095,6 +2092,7 @@ ${colors.bright}Commands:${colors.reset}
   inspect <path>     Inspect parsed content shape of a markdown file or folder
   docs               Generate component documentation
   families           List the standard section families (for meta.js family:)
+  template list      List the official templates (for create --template)
   doctor             Diagnose project configuration issues
   validate           Check your content against your foundation's data schemas
   update             Align workspace deps + AGENTS.md to the running CLI
@@ -2216,9 +2214,9 @@ ${colors.bright}Examples:${colors.reset}
   cd my-project
   uniweb add project docs                            # Add docs/src/ + docs/site/
   uniweb add project docs --from academic            # Co-located pair + academic content
-  uniweb add marketing                               # Add marketing/ at root
-  uniweb add site blog --foundation marketing        # Add site/ wired to marketing
-  uniweb add extension effects --site site           # Add effects/ at root
+  uniweb add foundation marketing                    # Add marketing/ at root
+  uniweb add site blog --foundation marketing        # Add blog/ wired to marketing
+  uniweb add extension effects --site site           # Add extensions/effects/
 
   uniweb build
   uniweb build --target src                          # Build src/ package
@@ -2231,7 +2229,7 @@ ${colors.bright}Install:${colors.reset}
 }
 
 // Run CLI
-main().catch((err) => {
+main().catch(async (err) => {
   error(err.message)
-  process.exit(1)
+  await exitWhenDrained(1)
 })

package/src/templates/fetchers/release.js

@@ -14,43 +14,32 @@ import { fetchWithRetry as sharedFetchWithRetry } from '../../utils/fetch-retry.
 const TEMPLATES_REPO = 'uniweb/templates'
 const GITHUB_API = 'https://api.github.com'
 
-// Cache for manifest (avoid re-fetching in same session)
-let manifestCache = null
-
 /**
- * Fetch the manifest.json from the latest release
+ * Fetch manifest.json from one release of the official templates.
+ *
+ * ⛔ Always a named release — the one the CLI was published with — and never
+ * `latest`: the latest templates can be newer than the packages this CLI pins
+ * (templates/resolver.js, OFFICIAL_TEMPLATES_RELEASE).
  *
  * @param {Object} options - Fetch options
- * @param {string} options.version - Specific version tag (default: latest)
+ * @param {string} options.version - The release tag, e.g. `v0.18.4`
  * @param {Function} options.onProgress - Progress callback
- * @returns {Promise<Object>} { version, templates, downloadUrl }
+ * @returns {Promise<Object>} { version, templates, downloadUrlBase }
  */
 export async function fetchManifest(options = {}) {
   const { version, onProgress } = options
-
-  // Return cached manifest if available and no specific version requested
-  if (manifestCache && !version) {
-    return manifestCache
-  }
+  if (!version) throw new Error('fetchManifest needs the release tag to read')
 
   onProgress?.('Fetching template manifest...')
 
-  // Get release info
-  const releaseUrl = version
-    ? `${GITHUB_API}/repos/${TEMPLATES_REPO}/releases/tags/${version}`
-    : `${GITHUB_API}/repos/${TEMPLATES_REPO}/releases/latest`
-
-  const releaseResponse = await fetchWithRetry(releaseUrl, {
-    headers: getGitHubHeaders()
-  })
+  const releaseResponse = await fetchWithRetry(
+    `${GITHUB_API}/repos/${TEMPLATES_REPO}/releases/tags/${version}`,
+    { headers: getGitHubHeaders() }
+  )
 
   if (!releaseResponse.ok) {
     if (releaseResponse.status === 404) {
-      throw new Error(
-        version
-          ? `Release ${version} not found for ${TEMPLATES_REPO}`
-          : `No releases found for ${TEMPLATES_REPO}`
-      )
+      throw new Error(`Release ${version} not found for ${TEMPLATES_REPO}`)
     }
     await handleGitHubError(releaseResponse)
   }
@@ -80,28 +69,20 @@ export async function fetchManifest(options = {}) {
 
   const manifest = await manifestResponse.json()
 
-  // Build result with download URL base
-  const result = {
+  return {
     version: release.tag_name,
     templates: manifest.templates || {},
     // Base URL for downloading template tarballs
     downloadUrlBase: `https://github.com/${TEMPLATES_REPO}/releases/download/${release.tag_name}`
   }
-
-  // Cache if this was a "latest" fetch
-  if (!version) {
-    manifestCache = result
-  }
-
-  return result
 }
 
 /**
- * Fetch a specific template from GitHub releases
+ * Fetch a template from one release of the official templates
  *
  * @param {string} name - Template name (e.g., 'marketing')
  * @param {Object} options - Fetch options
- * @param {string} options.version - Specific version tag (default: latest)
+ * @param {string} options.version - The release tag, e.g. `v0.18.4`
  * @param {Function} options.onProgress - Progress callback
  * @returns {Promise<Object>} { tempDir, version, metadata }
  */
@@ -166,33 +147,6 @@ export async function fetchOfficialTemplate(name, options = {}) {
   }
 }
 
-/**
- * List available templates from the latest release
- *
- * @param {Object} options - Fetch options
- * @param {Function} options.onProgress - Progress callback
- * @returns {Promise<Array>} List of template metadata
- */
-export async function listOfficialTemplates(options = {}) {
-  try {
-    const manifest = await fetchManifest(options)
-    return Object.entries(manifest.templates).map(([id, info]) => ({
-      id,
-      ...info
-    }))
-  } catch {
-    // Return empty list if can't fetch
-    return []
-  }
-}
-
-/**
- * Clear the manifest cache
- */
-export function clearManifestCache() {
-  manifestCache = null
-}
-
 /**
  * Get GitHub API headers
  */

package/src/templates/index.js

@@ -12,15 +12,13 @@ import {
   getTemplateDisplayName,
   BUILTIN_TEMPLATES,
   OFFICIAL_TEMPLATES,
-  buildTemplateChoices
+  OFFICIAL_TEMPLATES_RELEASE,
+  buildTemplateChoices,
+  templatePickerPageSize
 } from './resolver.js'
 import { fetchNpmTemplate } from './fetchers/npm.js'
 import { fetchGitHubTemplate } from './fetchers/github.js'
-import {
-  fetchOfficialTemplate,
-  listOfficialTemplates
-} from './fetchers/release.js'
-import { validateTemplate } from './validator.js'
+import { fetchOfficialTemplate } from './fetchers/release.js'
 
 /**
  * Resolve a template identifier and return the template path
@@ -61,12 +59,20 @@ export async function resolveTemplate(identifier, options = {}) {
 }
 
 /**
- * Resolve an official template from GitHub releases
+ * Resolve an official template from the release this CLI was published with —
+ * never `latest`, so its content matches the package versions the scaffold pins
+ * (resolver.js, OFFICIAL_TEMPLATES_RELEASE).
  */
 async function resolveOfficialTemplate(name, options = {}) {
   const { onProgress } = options
 
+  if (!OFFICIAL_TEMPLATES_RELEASE) {
+    throw new Error(
+      "This CLI's framework index names no @uniweb/templates release to download from."
+    )
+  }
   const { tempDir, baseTempDir, version } = await fetchOfficialTemplate(name, {
+    version: OFFICIAL_TEMPLATES_RELEASE,
     onProgress
   })
 
@@ -173,35 +179,12 @@ async function resolveLocalTemplate(templatePath, options = {}) {
   }
 }
 
-/**
- * List all available templates
- */
-export async function listAvailableTemplates() {
-  const templates = []
-
-  // Official templates from GitHub releases
-  try {
-    const official = await listOfficialTemplates()
-    for (const t of official) {
-      templates.push({
-        type: 'official',
-        id: t.id,
-        name: t.name || t.id,
-        description: t.description || ''
-      })
-    }
-  } catch {
-    // Ignore errors - templates just won't be listed
-  }
-
-  return templates
-}
-
 // Re-export for convenience
 export {
   parseTemplateId,
   getTemplateDisplayName,
   BUILTIN_TEMPLATES,
   OFFICIAL_TEMPLATES,
-  buildTemplateChoices
+  buildTemplateChoices,
+  templatePickerPageSize
 }