@open-mercato/cli 0.6.8-develop.7000.1.0ae682bad1 → 0.6.8-develop.7003.1.24fef49d48

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 [build:cli] found 104 entry points
-Copied create-app/agentic/ → dist/agentic/
+Copied create-app/agentic/ → dist/agentic.staging/
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for ai_assistant
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for channel_apns
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for channel_expo
@@ -65,7 +65,7 @@ Copied create-app/agentic/ → dist/agentic/
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for storage_s3
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for sync_akeneo
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for webhooks
-Generated 62 module fact-sheets → dist/agentic/guides/modules/
+Generated 62 module fact-sheets → dist/agentic.staging/guides/modules/
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for ai_assistant
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for channel_apns
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for channel_expo
@@ -132,5 +132,6 @@ Generated 62 module fact-sheets → dist/agentic/guides/modules/
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for sync_akeneo
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for webhooks
 [module-facts] module registry unavailable (registryPath not provided); API route auth omitted for example
-Generated 1 local reference projection(s) → dist/agentic/guides/reference-modules/
+Generated 1 local reference projection(s) → dist/agentic.staging/guides/reference-modules/
+Published dist/agentic.staging/ → dist/agentic/
 [build:cli] built successfully

package/build.mjs

@@ -1,4 +1,14 @@
-import { chmodSync, cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
+import {
+  chmodSync,
+  cpSync,
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  renameSync,
+  rmSync,
+  writeFileSync,
+} from 'node:fs'
 import { createHash } from 'node:crypto'
 import { dirname, join } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
@@ -25,15 +35,28 @@ await buildPackage(packageDir, {
     chmodSync(binPath, 0o755)
 
     // Copy agentic source files from create-app so generators can read them at runtime.
+    // The tree is assembled in a staging directory and swapped in at the end of the build: refreshing
+    // dist/agentic in place deletes the whole harness plus ~55 fact-sheets and copies them back, which
+    // leaves the published tree incomplete for seconds and makes any concurrent reader fail with ENOENT
+    // on files that exist (#5059, #5104). Staging also makes stale per-module artifacts structurally
+    // impossible, so no purge of previous output is needed — the swapped-in tree only contains what this
+    // build wrote. Mirrors packages/create-app/build.mjs, including its single-builder assumption: the
+    // staging and previous directory names are fixed, so two concurrent runs would clear each other's
+    // staging tree below and the loser would fail loudly on the rename at the end, which beats the silent
+    // partial tree the in-place refresh produced.
+    const agenticDist = join(outdir, 'agentic')
+    const agenticStaging = join(outdir, 'agentic.staging')
+    const agenticPrevious = join(outdir, 'agentic.previous')
+    for (const leftover of [agenticStaging, agenticPrevious]) rmSync(leftover, { recursive: true, force: true })
+    mkdirSync(agenticStaging, { recursive: true })
     const agenticSrc = join(packageDir, '..', 'create-app', 'agentic')
     if (existsSync(agenticSrc)) {
-      rmSync(join(outdir, 'agentic'), { recursive: true, force: true })
-      cpSync(agenticSrc, join(outdir, 'agentic'), { recursive: true })
-      console.log('Copied create-app/agentic/ → dist/agentic/')
+      cpSync(agenticSrc, agenticStaging, { recursive: true })
+      console.log('Copied create-app/agentic/ → dist/agentic.staging/')
     }
 
     const repositoryRoot = join(packageDir, '..', '..')
-    const upstreamDir = join(outdir, 'agentic', 'guides', 'upstream')
+    const upstreamDir = join(agenticStaging, 'guides', 'upstream')
     mkdirSync(upstreamDir, { recursive: true })
     const cliVersion = JSON.parse(readFileSync(join(packageDir, 'package.json'), 'utf8')).version ?? null
     const upstreamManifest = { version: 1, generator: `@open-mercato/cli@${cliVersion ?? 'unknown'}`, files: {} }
@@ -48,33 +71,15 @@ await buildPackage(packageDir, {
     // Discover module-specific standalone guides across sibling packages. Package-level
     // guides are intentionally not shipped because they duplicate routed conceptual guides.
     const packagesDir = join(packageDir, '..')
-    const guidesDestDir = join(outdir, 'agentic', 'guides')
+    const guidesDestDir = join(agenticStaging, 'guides')
     mkdirSync(guidesDestDir, { recursive: true })
 
-    // Clean stale per-module artifacts before regenerating so an incremental dist never
-    // retains a removed module's full guide or fact-sheet. The legacy `core.<module>.md`
-    // redirect stubs are no longer emitted (#3754); this purge also deletes any that linger
-    // in an incremental `dist/` from an older build. Mirrors packages/create-app/build.mjs;
-    // conceptual guides remain while stale single-dot package guides are removed below.
-    rmSync(join(guidesDestDir, 'modules'), { recursive: true, force: true })
-    rmSync(join(guidesDestDir, 'reference-modules'), { recursive: true, force: true })
-    rmSync(join(guidesDestDir, 'reference-module-facts.json'), { force: true })
-    rmSync(join(guidesDestDir, 'module-facts.v2.json'), { force: true })
-    for (const entry of readdirSync(guidesDestDir)) {
-      if (/^core\..+\.md$/.test(entry)) {
-        rmSync(join(guidesDestDir, entry))
-      }
-    }
+    // Nothing stale can survive here: the staged tree is built from create-app/agentic alone, so the
+    // legacy `core.<module>.md` redirect stubs (#3754) and the unreachable package-level `<pkg>.md`
+    // guides are absent unless this build writes them — which it does not. The conceptual guides remain.
 
     let guidesFound = 0
     for (const pkg of readdirSync(packagesDir)) {
-      // Package-level source guides remain for monorepo context, but standalone apps route
-      // through conceptual and module-level guides, so remove their stale emitted copies.
-      const guideSource = join(packagesDir, pkg, 'agentic', 'standalone-guide.md')
-      if (existsSync(guideSource)) {
-        rmSync(join(guidesDestDir, `${pkg}.md`), { force: true })
-      }
-
       const modulesDir = join(packagesDir, pkg, 'src', 'modules')
       if (!existsSync(modulesDir)) continue
 
@@ -88,7 +93,7 @@ await buildPackage(packageDir, {
     }
 
     if (guidesFound > 0) {
-      console.log(`Discovered ${guidesFound} standalone guides → dist/agentic/guides/`)
+      console.log(`Discovered ${guidesFound} standalone guides → dist/agentic.staging/guides/`)
     }
 
     // Generate per-module fact-sheets plus legacy-v1 and corrected-v2 JSON sidecars
@@ -154,7 +159,9 @@ await buildPackage(packageDir, {
       writeFileSync(join(guidesDestDir, 'framework-extension-points.md'), frameworkMarkdown)
 
       for (const warning of warnings) console.warn(warning)
-      console.log(`Generated ${Object.keys(directoryByModule).length} module fact-sheets → dist/agentic/guides/modules/`)
+      console.log(
+        `Generated ${Object.keys(directoryByModule).length} module fact-sheets → dist/agentic.staging/guides/modules/`,
+      )
 
       const referenceBundle = {}
       const referenceGuidesDir = join(guidesDestDir, 'reference-modules')
@@ -184,10 +191,18 @@ await buildPackage(packageDir, {
       }
       writeFileSync(join(guidesDestDir, 'reference-module-facts.json'), renderReferenceModuleFactsJson(referenceBundle))
       console.log(
-        `Generated ${REFERENCE_MODULE_IDS.length} local reference projection(s) → dist/agentic/guides/reference-modules/`,
+        `Generated ${REFERENCE_MODULE_IDS.length} local reference projection(s) → dist/agentic.staging/guides/reference-modules/`,
       )
     } else {
       console.warn('[module-facts] no package modules discovered; skipping fact-sheet generation')
     }
+
+    // Publish the staged tree. A reader either sees the complete previous build or the complete new
+    // one; the only gap is between the two renames, instead of the multi-second incomplete window an
+    // in-place refresh leaves behind (#5059, #5104).
+    if (existsSync(agenticDist)) renameSync(agenticDist, agenticPrevious)
+    renameSync(agenticStaging, agenticDist)
+    rmSync(agenticPrevious, { recursive: true, force: true })
+    console.log('Published dist/agentic.staging/ → dist/agentic/')
   },
 })