uniweb 1.21.5 → 1.21.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "1.21.5",
+  "version": "1.21.6",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -41,13 +41,13 @@
     "js-yaml": "^4.3.2",
     "prompts": "^2.4.2",
     "tar": "^7.5.21",
-    "@uniweb/content-writer": "~1.3.1",
+    "@uniweb/core": "~1.4.8",
     "@uniweb/schemas": "~1.6.5",
     "@uniweb/semantic-parser": "~1.13.0",
-    "@uniweb/core": "~1.4.7"
+    "@uniweb/content-writer": "~1.3.1"
   },
   "peerDependencies": {
-    "@uniweb/build": "~1.10.5",
+    "@uniweb/build": "~1.10.6",
     "@uniweb/semantic-parser": "~1.13.0",
     "@uniweb/content-reader": "~1.5.7"
   },

package/partials/agents.md

@@ -67,7 +67,7 @@ https://uniweb.io/llms.txt
 
 It lists every documentation page with a one-line description and a fetchable link. Go there whenever your question isn't answered in this file — and *especially* when you don't know whether a feature exists at all. That's where guessing does the most damage: **a 404 on a path you invented tells you your guess was wrong, not that the feature is missing.** Concluding "the framework doesn't support X" from a failed fetch is a mistake worth actively guarding against; the index answers the existence question directly.
 
-Then **follow the link the index gives you** rather than constructing one yourself. The index is the source of truth for where pages live, so it stays correct when the site's URL conventions change. Each link it gives is the page as Markdown.
+Then **follow the link the index gives you** rather than constructing one yourself. The index is the source of truth for where pages live, so it stays correct when the site's URL conventions change. Each link it gives is the page as Markdown, and a page's own address returns the same Markdown to a request sent with `Accept: text/markdown`.
 
 **Clone the repo instead** when you expect several lookups, or may lose network access later:
 
@@ -2862,7 +2862,7 @@ uniweb <command> --help           # Per-command flags — no side effects. Prefe
 | Any static host at all | `uniweb export` | full control; no Uniweb account needed |
 | Uniweb Cloud | `uniweb publish` | teams with non-technical content authors, or client work |
 
-`uniweb deploy` never assumes a host: with nothing configured it opens a picker listing only destinations it can act on, and records the choice in `deploy.yml` so later runs go straight there. On Cloudflare Pages / Netlify / Vercel, `add ci` also adds per-PR previews that comment the URL. Adapters: `github-pages`, `cloudflare-pages`, `netlify`, `vercel`, plus `s3-cloudfront` for `deploy`. That record is `deploy.yml`, beside `site.yml` — **the CLI writes it, you don't create it**: the first successful deploy scaffolds the whole file, and later deploys rewrite only its `deploys:` block. Edit `targets:` when you want to change where a site ships. Host credentials come from the environment, never from that committed file.
+`uniweb deploy` never assumes a host: with nothing configured it opens a picker listing only destinations it can act on, and records the choice in `deploy.yml` so later runs go straight there. On Cloudflare Pages / Netlify / Vercel, `add ci` also adds per-PR previews that comment the URL. GitHub runs workflows only from the top of the repository: in a project that is a folder of a larger repository, the project's own `.github/` never runs, and `uniweb status` says so — as it says when a target in `deploy.yml` was never deployed from this copy. Adapters: `github-pages`, `cloudflare-pages`, `netlify`, `vercel`, plus `s3-cloudfront` for `deploy`. That record is `deploy.yml`, beside `site.yml` — **the CLI writes it, you don't create it**: the first successful deploy scaffolds the whole file, and later deploys rewrite only its `deploys:` block. Edit `targets:` when you want to change where a site ships. Host credentials come from the environment, never from that committed file.
 
 Foundations have their own free path too: `uniweb add ci --target foundation` publishes to permanent versioned URLs on GitHub Pages.
 

package/src/commands/doctor.js

@@ -1928,6 +1928,38 @@ async function runDoctor(args = []) {
     try {
       deployYml = await loadDeployYml(sitePath)
     } catch (err) {
+      // `saveDeploys:` holding a value of the retired `autoSave:` — the key renamed by hand, its
+      // value kept (measured 2026-10-26 on a copied project) — is the retired key's to repair.
+      let kept = null
+      try {
+        const v = yaml.load(readFileSync(deployYmlPath, 'utf8'))?.saveDeploys
+        kept = v === 'lastDeploy' || v === 'off' ? v : null
+      } catch {
+        kept = null
+      }
+      if (kept) {
+        const id = 'deploy-yml-retired-key'
+        const issue = { id, type: 'error', site: siteName, message: `deploy.yml has \`saveDeploys: ${kept}\`, a value of the retired \`autoSave:\`` }
+        issues.push(issue)
+        error(`[${id}] ${siteName}: deploy.yml has \`saveDeploys: ${kept}\` — a value of the retired \`autoSave:\`, where \`saveDeploys\` is true or false.`)
+        log(
+          `    ${colors.dim}${kept === 'off' ? '`autoSave: off` is `saveDeploys: false`.' : '`autoSave: lastDeploy` is what happens anyway — deploys are recorded — so the line goes.'}${colors.reset}`
+        )
+        if (shouldFix(id)) {
+          try {
+            const { retireDeployYmlKeys } = await import('@uniweb/build/site')
+            if (await retireDeployYmlKeys(sitePath)) {
+              issue.fixed = true
+              fixed(`${relative(workspaceDir, deployYmlPath)}: ${kept === 'off' ? 'wrote `saveDeploys: false`' : 'removed `saveDeploys: lastDeploy`'}`)
+            }
+          } catch (fixErr) {
+            warn(`[${id}] could not rewrite ${relative(workspaceDir, deployYmlPath)}: ${fixErr.message}`)
+          }
+        } else {
+          log(`    ${colors.dim}Run \`uniweb doctor --fix ${id}\` to write what it meant, keeping your comments.${colors.reset}`)
+        }
+        continue
+      }
       issues.push({
         id: 'deploy-yml-malformed',
         type: 'error',
@@ -2013,10 +2045,13 @@ async function runDoctor(args = []) {
         if (names.length) lost.push(`the last deploy of ${names.map((n) => `\`${n}\``).join(', ')} is recorded only there, where nothing sees it`)
       }
       if (String(deployYml.autoSave) === 'off') lost.push('`autoSave: off` is ignored, so deploys are recorded')
-      const renamed = { lastDeploy: 'deploys', autoSave: 'saveDeploys' }
-      log(
-        `    ${colors.dim}${retired.map((k) => `\`${k}:\` is \`${renamed[k]}:\``).join(' and ')} now${lost.length ? ` — ${lost.join('; ')}` : ''}.${colors.reset}`
-      )
+      // What each one means now — said by value, not as a rename: "`autoSave:` is `saveDeploys:`"
+      // read as one, and a copy came back holding `saveDeploys: lastDeploy` (2026-10-26).
+      const means = {
+        lastDeploy: '`lastDeploy:` is `deploys:` now',
+        autoSave: '`autoSave:` goes — `autoSave: off` is `saveDeploys: false`, and `autoSave: lastDeploy` is what happens anyway'
+      }
+      log(`    ${colors.dim}${retired.map((k) => means[k]).join('; ')}${lost.length ? ` — ${lost.join('; ')}` : ''}.${colors.reset}`)
       if (shouldFix(id)) {
         try {
           const { retireDeployYmlKeys } = await import('@uniweb/build/site')

package/src/commands/status.js

@@ -43,7 +43,7 @@
  */
 
 import { execFileSync } from 'node:child_process'
-import { existsSync, readFileSync, statSync } from 'node:fs'
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs'
 import { basename, dirname, join, relative, resolve, sep } from 'node:path'
 import yaml from 'js-yaml'
 
@@ -712,7 +712,7 @@ function changeChecks(siteDir, changes, unpushedFiles, proposals) {
   if (!moved) {
     return [
       unknown.length
-        ? { id: 'app.changes', state: 'unknown', summary: `Could not tell what changed on the backend: ${unknown.map((l) => l.detail).join('; ')}.` }
+        ? { id: 'app.changes', state: 'unknown', summary: `Could not tell what changed on the backend: ${[...new Set(unknown.map((l) => l.detail))].join('; ')}.` }
         : { id: 'app.changes', state: 'ok', summary: 'Nothing changed on the backend since this copy last synced.', detail: { source: 'units' } }
     ]
   }
@@ -1215,18 +1215,34 @@ async function deployChecks(siteDir) {
       host: t.host,
       title,
       default: name === defaultName,
+      deployed: Boolean(ci || receipt || retired),
       ci: ci ? { file: ci.file, branches: ci.branches } : null,
       last: receipt ? { at: receipt.at ?? null, sha: receipt.git?.sha ?? null, url: receipt.url ?? null } : null,
       behind,
       ...(retired ? { retired: true } : {})
     })
   }
+  // ⭐ A TARGET IS A DESTINATION, NOT A DEPLOY. Only CI or a receipt says the site went there;
+  // a target with neither is named as what it is. ⛔ Until 2026-10-26 every target was "Also
+  // deployed to", and the status opened with it — on a project copied from a repository whose
+  // CI deployed it, after the site had moved to Uniweb Cloud.
+  const deployed = targets.filter((t) => t.deployed)
+  const never = targets.filter((t) => !t.deployed)
+  const parts = []
+  if (deployed.length) parts.push(`Also deployed to ${deployed.map((t) => t.title).join(' and ')}.`)
+  if (never.length) {
+    parts.push(`deploy.yml names ${never.map((t) => t.title).join(' and ')}, never deployed from this copy.`)
+    attention = true
+    lines.push(
+      'A target never deployed from here is a host the site has not gone to yet, or one it left — when it left, remove the target from deploy.yml, and `default:` when it names it.'
+    )
+  }
   return {
     checks: [
       {
         id: 'hosting.deploys',
         state: attention ? 'attention' : 'ok',
-        summary: `Also deployed to ${targets.map((t) => t.title).join(' and ')}.`,
+        summary: parts.join(' '),
         lines,
         detail: { targets }
       }
@@ -1236,6 +1252,40 @@ async function deployChecks(siteDir) {
   }
 }
 
+/**
+ * `hosting.workflows`: GitHub Actions workflows between this site and the top of its
+ * repository — a project's own `.github/workflows` — which GitHub never runs: it runs the
+ * repository's top-level workflows alone, so these are files, not CI.
+ *
+ * ⭐ A project copied into another repository brings its `.github/` along (`uniweb add ci`
+ * writes one). Measured 2026-10-26 on a repository of client projects: a site that had moved to
+ * Uniweb Cloud still carried the GitHub Pages workflow that used to deploy it.
+ */
+function workflowsCheck(siteDir) {
+  const repo = repoOf(siteDir)
+  if (!repo) return null
+  const found = []
+  for (let d = siteDir; d !== repo.top && d.startsWith(repo.top + sep); d = dirname(d)) {
+    const dir = join(d, '.github', 'workflows')
+    let names
+    try {
+      names = readdirSync(dir).filter((n) => /\.ya?ml$/.test(n))
+    } catch {
+      continue
+    }
+    for (const n of names.sort()) found.push(relative(siteDir, join(dir, n)))
+  }
+  if (!found.length) return { id: 'hosting.workflows', state: 'ok', summary: 'No workflow here that GitHub would not run.', quiet: true }
+  const n = found.length
+  return {
+    id: 'hosting.workflows',
+    state: 'attention',
+    summary: `${count(n, 'workflow')} here never ${n === 1 ? 'runs' : 'run'}: GitHub runs workflows only from the top of the repository, ${relative(siteDir, join(repo.top, '.github', 'workflows'))}.`,
+    files: found,
+    lines: ['Most likely left from the repository this project came from. When the site no longer deploys that way, the folder can go — ask the person first.']
+  }
+}
+
 const list = (names) => names.map((n) => `\`${n}\``).join(', ')
 
 /**
@@ -1305,7 +1355,8 @@ function summaryLine({ name, synced, live, targets, origin }) {
   const parts = [synced.length ? `synced with ${synced.join(' and ')}` : 'not synced with a backend']
   if (live?.published) parts.push(`live on ${cloudName(origin)}${live.url ? ` at ${live.url}` : ''}`)
   else if (live) parts.push(`not live on ${cloudName(origin)} yet`)
-  if (targets.length) parts.push(`${live?.published ? 'also deployed' : 'deployed'} to ${targets.map((t) => t.title).join(' and ')}`)
+  const deployed = targets.filter((t) => t.deployed)
+  if (deployed.length) parts.push(`${live?.published ? 'also deployed' : 'deployed'} to ${deployed.map((t) => t.title).join(' and ')}`)
   else if (!synced.length) parts.push('not hosted anywhere yet')
   return `${name} — ${parts.join(' · ')}`
 }
@@ -1399,7 +1450,8 @@ async function workspaceOverview(root, { json }) {
     })
     const languages = normalizeLanguageList(yml.languages)
     const parts = [synced.length ? `synced with ${synced.join(' and ')}` : 'not synced']
-    if (targets.length) parts.push(`deployed to ${targets.map((t) => t.title).join(' and ')}`)
+    const deployed = targets.filter((t) => t.deployed)
+    if (deployed.length) parts.push(`deployed to ${deployed.map((t) => t.title).join(' and ')}`)
     parts.push(
       fnd.kind === 'local'
         ? `foundation ${fnd.name}`
@@ -1414,7 +1466,7 @@ async function workspaceOverview(root, { json }) {
       name: s.name,
       summary: `${s.path} — ${parts.join(' · ')}`,
       synced,
-      deploys: targets.map(({ name, host, title, default: isDefault, ci }) => ({ name, host, title, default: isDefault, ci })),
+      deploys: targets.map(({ name, host, title, default: isDefault, deployed: was, ci }) => ({ name, host, title, default: isDefault, deployed: was, ci })),
       foundation: { kind: fnd.kind, name: fnd.name ?? null, path: fnd.path ?? null },
       mounts,
       languages
@@ -1508,7 +1560,18 @@ export async function status(args = []) {
   } finally {
     Object.assign(console, saved)
   }
-  const checks = [...project.checks, ...git.checks, ...app.checks, ...deploys.checks, ...services.checks, ...version.checks, ...health.checks, dev]
+  const workflows = workflowsCheck(siteDir)
+  const checks = [
+    ...project.checks,
+    ...git.checks,
+    ...app.checks,
+    ...deploys.checks,
+    ...(workflows ? [workflows] : []),
+    ...services.checks,
+    ...version.checks,
+    ...health.checks,
+    dev
+  ]
   const next = planNext([...git.proposals, ...app.proposals, ...deploys.proposals, ...services.proposals, ...version.proposals, ...health.proposals])
 
   const root = findWorkspaceRoot(siteDir) || siteDir

package/src/framework-index.json

@@ -1,12 +1,12 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-10-26T19:45:51.544Z",
+  "generatedAt": "2026-10-26T21:28:38.450Z",
   "packages": {
     "@uniweb/api": {
       "version": "1.6.4"
     },
     "@uniweb/build": {
-      "version": "1.10.5"
+      "version": "1.10.6"
     },
     "@uniweb/content-reader": {
       "version": "1.5.7"
@@ -15,7 +15,7 @@
       "version": "1.3.1"
     },
     "@uniweb/core": {
-      "version": "1.4.7"
+      "version": "1.4.8"
     },
     "@uniweb/frame-bridge": {
       "version": "1.0.2"
@@ -33,10 +33,10 @@
       "version": "1.1.4"
     },
     "@uniweb/projections": {
-      "version": "1.2.1"
+      "version": "1.2.2"
     },
     "@uniweb/runtime": {
-      "version": "1.2.3"
+      "version": "1.2.4"
     },
     "@uniweb/scene": {
       "version": "1.0.1"

package/src/index.js

@@ -1789,8 +1789,9 @@ where, live where, deployed where — and checks:
   app      the session, what changed on the backend since this copy last synced —
            the files a pull would change — what is not pushed, who has the site
            open in the app, the foundation
-  hosting  where the site is live, the other hosts deploy.yml lists (by CI or by
-           hand, and how far behind), and the services the live site has
+  hosting  where the site is live, the other hosts deploy.yml lists (by CI, by hand
+           and how far behind, or never from this copy), workflows GitHub never runs
+           (a project's own .github/), and the services the live site has
   uniweb   whether a newer release is out
   health   doctor's findings
   dev      the dev server