From 3b46c696016c1fb2ad3c9b2498c71ad3fb744a63 Mon Sep 17 00:00:00 2001
From: Ajay Ghanwat <ghanwat.ajay@workroot.in>
Date: Mon, 13 Jul 2026 14:18:44 +0530
Subject: [PATCH] fix: verify docs after release generation

---
 docs/PUBLISHING.md |  8 +++++---
 scripts/release.ts | 10 +++++++++-
 2 files changed, 14 insertions(+), 4 deletions(-)

diff --git a/docs/PUBLISHING.md b/docs/PUBLISHING.md
index ae4b5fe9..578e2ed3 100644
--- a/docs/PUBLISHING.md
+++ b/docs/PUBLISHING.md
@@ -58,11 +58,13 @@ The command performs the remaining release as one guarded workflow:
 2. Publish every missing `@wrnexus/*` package in dependency order. Already-published
    packages are verified and skipped, so an interrupted release can be resumed safely.
 3. Confirm every package is private and run the newly published CLI updater, including its
-   migrations, against `D:\Company\wrnexusjs`.
+   migrations, against `D:\Company\wrnexusjs`. The updater's immediate project check is
+   deferred because its generated docs inputs are rebuilt in the next step.
 4. Align every docs-site dependency, regenerate package pages twice, update
    `public/llms.txt`, `public/llms-full.txt`, the sitemap, and the documentation index.
-5. Run the docs-site check and production build, verify that `public/llms.txt` contains the
-   current version and every framework package, then commit and push the docs repository.
+5. Run the authoritative docs-site check and production build, verify that
+   `public/llms.txt` contains the current version and every framework package, then commit
+   and push the docs repository.
 
 If the documentation checkout lives elsewhere, set `WRNEXUS_DOCS_ROOT` before running the
 publish command. Both repositories must start clean and synchronized with their active
diff --git a/scripts/release.ts b/scripts/release.ts
index a2addd1f..afb7cfa4 100644
--- a/scripts/release.ts
+++ b/scripts/release.ts
@@ -216,7 +216,15 @@ function publish(all: PackageInfo[], version: string) {
   console.log(`\nUpdating docs repository at ${docsRoot}…\n`);
   run(
     process.execPath,
-    ["x", "--package", `@wrnexus/cli@${version}`, "wrnexus", "update", `--version=${version}`],
+    [
+      "x",
+      "--package",
+      `@wrnexus/cli@${version}`,
+      "wrnexus",
+      "update",
+      `--version=${version}`,
+      "--no-verify",
+    ],
     docsRoot,
   );
   syncDocsManifest(all, version);