@open-mercato/cli 0.6.6-develop.6383.1.27fcc83455 → 0.6.6-develop.6385.1.9a81faa5f0

package/.turbo/turbo-build.log

@@ -1,4 +1,15 @@
 [build:cli] found 93 entry points
 Copied create-app/agentic/ → dist/agentic/
 Discovered 7 standalone guides → dist/agentic/guides/
+[module-facts] module registry unavailable (registryPath not provided); API route auth omitted for auth
+[module-facts] module registry unavailable (registryPath not provided); API route auth omitted for catalog
+[module-facts] module registry unavailable (registryPath not provided); API route auth omitted for currencies
+[module-facts] module registry unavailable (registryPath not provided); API route auth omitted for customer_accounts
+[module-facts] module registry unavailable (registryPath not provided); API route auth omitted for customers
+[module-facts] module registry unavailable (registryPath not provided); API route auth omitted for data_sync
+[module-facts] module registry unavailable (registryPath not provided); API route auth omitted for integrations
+Generated 9 module fact-sheets → dist/agentic/guides/modules/
+[module-facts] module registry unavailable (registryPath not provided); API route auth omitted for sales
+Wrote 9 legacy core.<module>.md redirect stubs → dist/agentic/guides/
 [build:cli] built successfully
+[module-facts] module registry unavailable (registryPath not provided); API route auth omitted for workflows

package/build.mjs

@@ -1,6 +1,6 @@
-import { chmodSync, cpSync, existsSync, mkdirSync, readdirSync, readFileSync } from 'node:fs'
+import { chmodSync, cpSync, existsSync, mkdirSync, readdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
-import { fileURLToPath } from 'node:url'
+import { fileURLToPath, pathToFileURL } from 'node:url'
 import { atomicWriteFileSync } from '../../scripts/lib/add-js-extension.mjs'
 import { buildPackage } from '../../scripts/build-package.mjs'
 
@@ -35,6 +35,18 @@ await buildPackage(packageDir, {
     const guidesDestDir = join(outdir, 'agentic', '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 — a removed `core.<module>.md`
+    // (two-dot, per-module) must come back as a redirect stub, not linger as a full guide.
+    // Mirrors packages/create-app/build.mjs; the conceptual `module-system.md` and the
+    // single-dot package guides are re-copied/re-discovered below.
+    rmSync(join(guidesDestDir, 'modules'), { recursive: true, force: true })
+    for (const entry of readdirSync(guidesDestDir)) {
+      if (/^core\..+\.md$/.test(entry)) {
+        rmSync(join(guidesDestDir, entry))
+      }
+    }
+
     let guidesFound = 0
     for (const pkg of readdirSync(packagesDir)) {
       const guideSource = join(packagesDir, pkg, 'agentic', 'standalone-guide.md')
@@ -58,5 +70,61 @@ await buildPackage(packageDir, {
     if (guidesFound > 0) {
       console.log(`Discovered ${guidesFound} standalone guides → dist/agentic/guides/`)
     }
+
+    // Generate per-module fact-sheets (Layer 2) from core module sources via the
+    // freshly built ts-morph extractor, so `mercato agentic:init` bundles the same
+    // guides as a create-mercato-app scaffold (packages/create-app/build.mjs).
+    const coreSrcRoot = join(packagesDir, 'core', 'src', 'modules')
+    if (existsSync(coreSrcRoot)) {
+      const { extractAllModuleFacts, renderModuleFactsJson } = await import(
+        pathToFileURL(join(outdir, 'lib', 'generators', 'module-facts.js')).href
+      )
+      const registryPath = join(packagesDir, '..', 'apps', 'mercato', '.mercato', 'generated', 'modules.runtime.generated.ts')
+      let coreVersion = null
+      try {
+        coreVersion = JSON.parse(readFileSync(join(packagesDir, 'core', 'package.json'), 'utf8')).version ?? null
+      } catch {
+        coreVersion = null
+      }
+
+      const { factsByModule, markdownByModule, warnings } = extractAllModuleFacts({
+        coreSrcRoot,
+        registryPath: existsSync(registryPath) ? registryPath : null,
+        coreVersion,
+      })
+
+      const modulesGuidesDir = join(guidesDestDir, 'modules')
+      mkdirSync(modulesGuidesDir, { recursive: true })
+      for (const [moduleId, markdown] of Object.entries(markdownByModule)) {
+        writeFileSync(join(modulesGuidesDir, `${moduleId}.md`), markdown)
+      }
+      writeFileSync(join(guidesDestDir, 'module-facts.json'), renderModuleFactsJson(factsByModule))
+
+      for (const warning of warnings) console.warn(warning)
+      console.log(`Generated ${Object.keys(markdownByModule).length} module fact-sheets → dist/agentic/guides/modules/`)
+
+      // BC bridge (spec §7 generated-file contract): for any allowlisted module whose
+      // legacy full guide `core.<module>.md` is no longer bundled (its standalone-guide.md
+      // source was removed), emit a thin redirect stub pointing at the generated fact-sheet.
+      // Fresh scaffolds never link these names; they exist only for apps upgrading in place.
+      let stubsWritten = 0
+      for (const moduleId of Object.keys(markdownByModule)) {
+        const legacyGuidePath = join(guidesDestDir, `core.${moduleId}.md`)
+        if (!existsSync(legacyGuidePath)) {
+          writeFileSync(
+            legacyGuidePath,
+            `# core.${moduleId} — moved\n\n` +
+              `> This guide has moved. See [\`modules/${moduleId}.md\`](modules/${moduleId}.md) for the generated ` +
+              `\`${moduleId}\` fact-sheet, and [\`module-system.md\`](module-system.md) for conceptual module guidance.\n`,
+          )
+          stubsWritten++
+        }
+      }
+      if (stubsWritten > 0) {
+        console.log(`Wrote ${stubsWritten} legacy core.<module>.md redirect stubs → dist/agentic/guides/`)
+      }
+    } else {
+      console.warn(`[module-facts] core module sources not found at ${coreSrcRoot}; skipping fact-sheet generation`)
+    }
   },
 })

package/dist/agentic/guides/core.auth.md

@@ -0,0 +1,3 @@
+# core.auth — moved
+
+> This guide has moved. See [`modules/auth.md`](modules/auth.md) for the generated `auth` fact-sheet, and [`module-system.md`](module-system.md) for conceptual module guidance.

package/dist/agentic/guides/core.catalog.md

@@ -0,0 +1,3 @@
+# core.catalog — moved
+
+> This guide has moved. See [`modules/catalog.md`](modules/catalog.md) for the generated `catalog` fact-sheet, and [`module-system.md`](module-system.md) for conceptual module guidance.

package/dist/agentic/guides/core.currencies.md

@@ -0,0 +1,3 @@
+# core.currencies — moved
+
+> This guide has moved. See [`modules/currencies.md`](modules/currencies.md) for the generated `currencies` fact-sheet, and [`module-system.md`](module-system.md) for conceptual module guidance.

package/dist/agentic/guides/core.customer_accounts.md

@@ -0,0 +1,3 @@
+# core.customer_accounts — moved
+
+> This guide has moved. See [`modules/customer_accounts.md`](modules/customer_accounts.md) for the generated `customer_accounts` fact-sheet, and [`module-system.md`](module-system.md) for conceptual module guidance.

package/dist/agentic/guides/core.customers.md

@@ -0,0 +1,3 @@
+# core.customers — moved
+
+> This guide has moved. See [`modules/customers.md`](modules/customers.md) for the generated `customers` fact-sheet, and [`module-system.md`](module-system.md) for conceptual module guidance.

package/dist/agentic/guides/core.data_sync.md

@@ -0,0 +1,3 @@
+# core.data_sync — moved
+
+> This guide has moved. See [`modules/data_sync.md`](modules/data_sync.md) for the generated `data_sync` fact-sheet, and [`module-system.md`](module-system.md) for conceptual module guidance.

package/dist/agentic/guides/core.integrations.md

@@ -0,0 +1,3 @@
+# core.integrations — moved
+
+> This guide has moved. See [`modules/integrations.md`](modules/integrations.md) for the generated `integrations` fact-sheet, and [`module-system.md`](module-system.md) for conceptual module guidance.

package/dist/agentic/guides/core.sales.md

@@ -0,0 +1,3 @@
+# core.sales — moved
+
+> This guide has moved. See [`modules/sales.md`](modules/sales.md) for the generated `sales` fact-sheet, and [`module-system.md`](module-system.md) for conceptual module guidance.

package/dist/agentic/guides/core.workflows.md

@@ -0,0 +1,3 @@
+# core.workflows — moved
+
+> This guide has moved. See [`modules/workflows.md`](modules/workflows.md) for the generated `workflows` fact-sheet, and [`module-system.md`](module-system.md) for conceptual module guidance.