uniweb 0.31.1 → 0.32.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniweb",
-  "version": "0.31.1",
+  "version": "0.32.0",
   "description": "Create structured Vite + React sites with content/code separation",
   "type": "module",
   "bin": {
@@ -42,14 +42,14 @@
     "prompts": "^2.4.2",
     "tar": "^7.0.0",
     "@uniweb/core": "^0.13.0",
-    "@uniweb/kit": "^0.13.7",
     "@uniweb/runtime": "^0.13.0",
+    "@uniweb/kit": "^0.13.7",
     "@uniweb/semantic-parser": "^1.3.1"
   },
   "peerDependencies": {
-    "@uniweb/build": "^0.27.1",
-    "@uniweb/semantic-parser": "^1.3.1",
-    "@uniweb/content-reader": "^1.2.4"
+    "@uniweb/build": "^0.28.0",
+    "@uniweb/content-reader": "^1.2.4",
+    "@uniweb/semantic-parser": "^1.3.1"
   },
   "peerDependenciesMeta": {
     "@uniweb/build": {

package/src/backend/site-sync.js

@@ -26,6 +26,7 @@ import {
   describeSiteDiff,
   computeUnitHashes,
   collectUnitUuids,
+  collectFolderItemUuids,
   readAssetMap
 } from '@uniweb/build/uwx'
 
@@ -457,6 +458,20 @@ export function mergeBaseVersions(siteDir, versions) {
 export function readItemUuids(siteDir) {
   return readMap(siteDir, 'itemUuids')
 }
+/**
+ * Placement identity for the site's `@uniweb/folder` — path chain → `$uuid`.
+ *
+ * Kept separate from `itemUuids` (which is site-content units) because they key
+ * different trees: `pages/…/page.yml` there, `members/alice` here. One map with
+ * two key languages is a map nobody can validate.
+ */
+export function readFolderItemUuids(siteDir) {
+  return readMap(siteDir, 'folderItemUuids')
+}
+export function writeFolderItemUuids(siteDir, map) {
+  if (!map || !Object.keys(map).length) return
+  updateSyncCache(siteDir, { folderItemUuids: map })
+}
 export function writeItemUuids(siteDir, map) {
   if (!map || !Object.keys(map).length) return
   updateSyncCache(siteDir, { itemUuids: map })
@@ -1297,6 +1312,21 @@ export async function pushSyncPackages({
     for (const d of bf.deferred) note(`↷ ${d.id ?? `#${d.index}`}: ${d.reason}`)
     if (bf.updated.length)
       wrote.push(`wrote ${bf.updated.length} record file(s)`)
+    // ⭐ BANK THE FOLDER'S PLACEMENT IDENTITY. The records back-fill their own
+    // `$uuid` into their source files (above); the folder's ITEMS have nowhere to
+    // be written, so they are banked here from the document the backend just
+    // returned.
+    //
+    // ⛔ Without this a `publish` after a `push` is refused: send-only-changed
+    // skips the unchanged records and re-sends the folder ALONE, its `contents`
+    // items carry no `$uuid`, and a `multi` item without one reads as new — so
+    // the backend refuses rather than replacing every placement. Reproduced on a
+    // live manor 2026-08-27; the identities were on the wire all along.
+    const folderDoc = finalized.find((f) => f?.document?.contents)?.document
+    if (folderDoc) {
+      const placements = collectFolderItemUuids(folderDoc)
+      if (Object.keys(placements).length) writeFolderItemUuids(siteDir, placements)
+    }
     finalizedTotal += finalized.length
   }
 
@@ -1323,6 +1353,26 @@ export async function pushSyncPackages({
     // Replaced wholesale: an item that no longer exists must not keep a uuid that
     // would re-target something else.
     if (theirs) writeItemUuids(siteDir, collectUnitUuids(theirs))
+    else {
+      // ⛔ BANKING IS BEST-EFFORT AND ITS FAILURE USED TO BE SILENT — say it here,
+      // because the cost lands two commands away and names something else.
+      //
+      // Without `finalized[0].document` (carrying `pages`) this push banks NO item
+      // identity. The push still reports success. The next `push`/`publish` then
+      // emits with no `$uuid` per item, and the backend refuses — correctly, since
+      // silently re-identifying every stored row is far worse. But that refusal
+      // reads as a stale-token or a producer bug, with nothing pointing back at the
+      // push that failed to bank.
+      //
+      // ⚠️ We cannot tell WHY it is absent from here — a response shape that
+      // changed, a lane that shipped nothing, a backend that does not echo the
+      // document. Report the observable fact and let the operator carry it.
+      note(
+        'identity not banked: this push returned no post-write document, so no per-item ' +
+          '$uuid was stored. The next push or publish will be identity-blind and the backend ' +
+          'may refuse it. `uniweb pull` re-arms identity if that happens.'
+      )
+    }
   }
   return { exitCode: 0, boundSiteUuid, finalizedTotal, wrote }
 }

package/src/commands/publish.js

@@ -77,6 +77,7 @@ import {
   readBaseVersions,
   readItemBaseVersions,
   ensureItemUuids,
+  readFolderItemUuids,
   ensureSiteExists,
   clearRemoteSyncStateIfUnbound,
   pushSyncPackages,
@@ -440,6 +441,8 @@ export async function publish(args = []) {
   let probe
   try {
     probe = await emitSyncPackages(siteDir, {
+      // Placement identity for the folder — see writeFolderItemUuids.
+      folderItemUuids: readFolderItemUuids(siteDir),
       // Resolves a foundation-relative `@/x` model ref into `@org/x`.
       ...(asOrg ? { org: asOrg } : {}),
       ...(foundationDir ? { foundationDir } : {}),
@@ -641,6 +644,8 @@ export async function publish(args = []) {
   let pkg
   try {
     pkg = await emitSyncPackages(siteDir, {
+      // Placement identity for the folder — see writeFolderItemUuids.
+      folderItemUuids: readFolderItemUuids(siteDir),
       // Resolves a foundation-relative `@/x` model ref into `@org/x`.
       ...(asOrg ? { org: asOrg } : {}),
       ...(foundationDir ? { foundationDir } : {}),

package/src/commands/push.js

@@ -84,6 +84,7 @@ import {
   readBaseVersions,
   readItemBaseVersions,
   readItemUuids,
+  readFolderItemUuids,
   ensureItemUuids,
   ensureSiteExists,
   clearRemoteSyncStateIfUnbound,
@@ -373,6 +374,8 @@ export async function push(args = [], deps = {}) {
     let mediaRefs = []
     try {
       const probe = await emitSyncPackages(siteDir, {
+      // Placement identity for the folder — see writeFolderItemUuids.
+      folderItemUuids: readFolderItemUuids(siteDir),
       // Resolves a foundation-relative `@/x` model ref into `@org/x`.
       ...(asOrg ? { org: asOrg } : {}),
         ...(foundationDir ? { foundationDir } : {}),
@@ -469,6 +472,8 @@ export async function push(args = [], deps = {}) {
   let pkg
   try {
     pkg = await emitSyncPackages(siteDir, {
+      // Placement identity for the folder — see writeFolderItemUuids.
+      folderItemUuids: readFolderItemUuids(siteDir),
       // Resolves a foundation-relative `@/x` model ref into `@org/x`.
       ...(asOrg ? { org: asOrg } : {}),
       ...(foundationDir ? { foundationDir } : {}),

package/src/framework-index.json

@@ -1,9 +1,9 @@
 {
   "schemaVersion": 1,
-  "generatedAt": "2026-08-27T16:19:55.310Z",
+  "generatedAt": "2026-08-27T21:10:42.589Z",
   "packages": {
     "@uniweb/build": {
-      "version": "0.27.1",
+      "version": "0.28.0",
       "path": "framework/build",
       "deps": [
         "@uniweb/content-reader",
@@ -68,7 +68,7 @@
       "deps": []
     },
     "@uniweb/projections": {
-      "version": "0.3.7",
+      "version": "0.4.1",
       "path": "framework/projections",
       "deps": [
         "@uniweb/content-writer",