uniweb 1.20.2 → 1.20.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "1.20.2",
+  "version": "1.20.3",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {

package/src/backend/workspace.js

@@ -139,6 +139,44 @@ export const SOURCE_LABEL = {
   offline: 'not resolved in a preview'
 }
 
+/**
+ * What a preview (`--dry-run`) says about the workspace: the one the command would work in,
+ * and a warning when the project's record says its site was created in another.
+ *
+ * ⭐ A preview resolves the workspace offline (`resolveWorkspace`): a flag, `UNIWEB_WORKSPACE`
+ * or the login's choice. With none of those, which one the command settles on takes the
+ * backend, so the preview says what the command does instead of guessing.
+ *
+ * ⚠️ The record says where the site was CREATED (`readSiteWorkspace`), not where the backend
+ * keeps it now. The backend decides, and a site kept outside the workspace stops the command
+ * (`409 wrong_workspace`), so a difference is worded as a warning about the record.
+ *
+ * @param {{ workspace: string|null, source: string }} ws - `resolveWorkspace`'s answer
+ * @param {string|null} createdIn - `readSiteWorkspace` for the project's site on this backend;
+ *   null when it has none, or no workspace is recorded for it
+ * @param {string} verb - `publish`, `push`
+ * @returns {{ workspace: string, warning: string|null }}
+ */
+export function previewWorkspace(ws, createdIn, verb) {
+  if (ws.source === 'offline') {
+    return {
+      workspace:
+        `none chosen at login — the ${verb} works in your personal workspace if you belong to no ` +
+        'organization or project, and otherwise stops and says how to choose one',
+      warning: null
+    }
+  }
+  const differs =
+    typeof createdIn === 'string' && createdIn.toLowerCase() !== String(ws.workspace ?? '').toLowerCase()
+  return {
+    workspace: `${describeWorkspace(ws.workspace)} (${SOURCE_LABEL[ws.source]})`,
+    warning: differs
+      ? `sync.json records this site as created in ${describeWorkspace(createdIn)}. If the backend ` +
+        `still keeps it there, it stops this ${verb}: add --org ${createdIn} to work in it.`
+      : null
+  }
+}
+
 /** How to choose, for a command on `origin` — its login names the backend when it must (`loginCommand`). */
 const choose = (origin) =>
   [

package/src/commands/publish.js

@@ -111,11 +111,12 @@ import {
   commitWriteBacks,
   reportWriteBacks,
   dropSiteBoundValues,
-  pushSyncPackages
+  pushSyncPackages,
+  readSiteWorkspace
 } from '../backend/site-sync.js'
 import { repoOf } from '../utils/sync-point.js'
 import { commitBeforeSending } from '../backend/commit-before-sending.js'
-import { resolveWorkspace, describeWorkspace, SOURCE_LABEL } from '../backend/workspace.js'
+import { resolveWorkspace, describeWorkspace, previewWorkspace, SOURCE_LABEL } from '../backend/workspace.js'
 import { uploadSiteMedia, describeAssetRefusal } from '../backend/site-media.js'
 import {
   updateBackendMap,
@@ -479,13 +480,15 @@ export async function publish(args = []) {
   }
 
   if (dryRun) {
+    const siteUuid = readBackendState(siteDir, client.origin).site?.uuid
+    const preview = previewWorkspace(ws, siteUuid ? readSiteWorkspace(siteDir, client.origin) : null, 'publish')
     say.info('Dry run — would bring the foundation along, sync, and go live:')
     say.dim(`Backend     : ${client.origin}`)
-    say.dim(
-      `site_uuid   : ${readBackendState(siteDir, client.origin).site?.uuid || '(none — the site is created before anything uploads)'}`
-    )
+    say.dim(`Workspace   : ${preview.workspace}`)
+    say.dim(`site_uuid   : ${siteUuid || '(none — the site is created before anything uploads)'}`)
     const langs = languagesFromSiteYml(siteYml)
     if (langs) say.dim(`Languages   : ${langs.join(', ')}`)
+    if (preview.warning) say.warn(preview.warning)
     await bringFoundationAlong({
       client,
       siteDir,

package/src/commands/push.js

@@ -103,10 +103,11 @@ import {
   commitWriteBacks,
   reportWriteBacks,
   holdUnchangedPush,
-  pushSyncPackages
+  pushSyncPackages,
+  readSiteWorkspace
 } from '../backend/site-sync.js'
 import { commitBeforeSending } from '../backend/commit-before-sending.js'
-import { resolveWorkspace, describeWorkspace, SOURCE_LABEL } from '../backend/workspace.js'
+import { resolveWorkspace, describeWorkspace, previewWorkspace, SOURCE_LABEL } from '../backend/workspace.js'
 
 // Re-exported for downstream importers (pull.js, push.test.js) that read these
 // helpers from this module — their canonical home is now ../backend/site-sync.js.
@@ -685,6 +686,10 @@ export async function push(args = [], deps = {}) {
         `Dry run — would push the folder at ${colors.dim}${client.origin}${colors.reset}`
       )
     }
+    const siteUuid = readBackendState(siteDir, client.origin).site?.uuid
+    const preview = previewWorkspace(ws, siteUuid ? readSiteWorkspace(siteDir, client.origin) : null, 'push')
+    note(`Workspace: ${preview.workspace}`)
+    if (preview.warning) warn(preview.warning)
     return { exitCode: 0 }
   }
 

package/src/framework-index.json

@@ -1,6 +1,6 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-10-26T00:04:57.896Z",
+  "generatedAt": "2026-10-26T02:00:48.151Z",
   "packages": {
     "@uniweb/api": {
       "version": "1.6.4"
@@ -24,7 +24,7 @@
       "version": "1.0.6"
     },
     "@uniweb/kit": {
-      "version": "1.6.4"
+      "version": "1.6.5"
     },
     "@uniweb/loom": {
       "version": "1.1.2"