@open-mercato/cli 0.9.1-develop.7476.1.342138d35e → 0.9.1-develop.7496.1.3346415f94

package/dist/agentic/guides/modules/resources/index.md

@@ -1,5 +1,5 @@
 # resources — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/resources
 
 ## Sections

package/dist/agentic/guides/modules/sales/index.md

@@ -1,5 +1,5 @@
 # sales — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/sales
 
 ## Sections

package/dist/agentic/guides/modules/scheduler/index.md

@@ -1,5 +1,5 @@
 # scheduler — module facts (generated, do not edit)
-<!-- generated from @open-mercato/scheduler 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/scheduler 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/scheduler/src/modules/scheduler
 
 ## Sections

package/dist/agentic/guides/modules/search/index.md

@@ -1,5 +1,5 @@
 # search — module facts (generated, do not edit)
-<!-- generated from @open-mercato/search 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/search 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/search/src/modules/search
 
 ## Sections

package/dist/agentic/guides/modules/security/index.md

@@ -1,5 +1,5 @@
 # security — module facts (generated, do not edit)
-<!-- generated from @open-mercato/enterprise 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/enterprise/src/modules/security
 
 ## Sections

package/dist/agentic/guides/modules/seeds/index.md

@@ -1,5 +1,5 @@
 # seeds — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/seeds
 
 ## Sections

package/dist/agentic/guides/modules/shipping_carriers/index.md

@@ -1,5 +1,5 @@
 # shipping_carriers — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/shipping_carriers
 
 ## Sections

package/dist/agentic/guides/modules/sso/index.md

@@ -1,5 +1,5 @@
 # sso — module facts (generated, do not edit)
-<!-- generated from @open-mercato/enterprise 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/enterprise/src/modules/sso
 
 ## Sections

package/dist/agentic/guides/modules/staff/index.md

@@ -1,5 +1,5 @@
 # staff — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/staff
 
 ## Sections

package/dist/agentic/guides/modules/storage_s3/index.md

@@ -1,5 +1,5 @@
 # storage_s3 — module facts (generated, do not edit)
-<!-- generated from @open-mercato/storage-s3 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/storage-s3 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/storage-s3/src/modules/storage_s3
 
 ## Sections

package/dist/agentic/guides/modules/sync_akeneo/index.md

@@ -1,5 +1,5 @@
 # sync_akeneo — module facts (generated, do not edit)
-<!-- generated from @open-mercato/sync-akeneo 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/sync-akeneo 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/sync-akeneo/src/modules/sync_akeneo
 
 ## Sections

package/dist/agentic/guides/modules/sync_excel/index.md

@@ -1,5 +1,5 @@
 # sync_excel — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/sync_excel
 
 ## Sections

package/dist/agentic/guides/modules/system_status_overlays/index.md

@@ -1,5 +1,5 @@
 # system_status_overlays — module facts (generated, do not edit)
-<!-- generated from @open-mercato/enterprise 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/enterprise/src/modules/system_status_overlays
 
 ## Sections

package/dist/agentic/guides/modules/telemetry/index.md

@@ -1,5 +1,5 @@
 # telemetry — module facts (generated, do not edit)
-<!-- generated from @open-mercato/telemetry 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/telemetry 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/telemetry/src/modules/telemetry
 
 ## Sections

package/dist/agentic/guides/modules/tillio/index.md

@@ -1,5 +1,5 @@
 # tillio — module facts (generated, do not edit)
-<!-- generated from @open-mercato/tillio 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/tillio 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/tillio/src/modules/tillio
 
 ## Sections

package/dist/agentic/guides/modules/translations/index.md

@@ -1,5 +1,5 @@
 # translations — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/translations
 
 ## Sections

package/dist/agentic/guides/modules/warranty_claims/index.md

@@ -1,5 +1,5 @@
 # warranty_claims — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/warranty_claims
 
 ## Sections

package/dist/agentic/guides/modules/webhooks/index.md

@@ -1,5 +1,5 @@
 # webhooks — module facts (generated, do not edit)
-<!-- generated from @open-mercato/webhooks 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/webhooks 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/webhooks/src/modules/webhooks
 
 ## Sections

package/dist/agentic/guides/modules/wms/index.md

@@ -1,5 +1,5 @@
 # wms — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/wms
 
 ## Sections

package/dist/agentic/guides/modules/workflows/index.md

@@ -1,5 +1,5 @@
 # workflows — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.9.1-develop.7476.1.342138d35e; core 0.9.1-develop.7476.1.342138d35e — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7496.1.3346415f94; core 0.9.1-develop.7496.1.3346415f94 — R1 staleness stamp -->
 Source root: node_modules/@open-mercato/core/src/modules/workflows
 
 ## Sections

package/dist/agentic/guides/reference-module-facts.json

@@ -1185,7 +1185,7 @@
     "facts": {
       "title": "Example Module",
       "description": "Demonstrates pages, APIs, entities and DI.",
-      "coreVersion": "0.9.1-develop.7476.1.342138d35e",
+      "coreVersion": "0.9.1-develop.7496.1.3346415f94",
       "sourcePackage": null,
       "sourceVersion": null,
       "sourceRoot": "src/modules/example",

package/dist/agentic/guides/upstream/BACKWARD_COMPATIBILITY.md

@@ -557,3 +557,7 @@ Spec: [`.ai/specs/2026-09-08-error-reporting-policy.md`](.ai/specs/2026-09-08-er
 | Database schema, event IDs, ACL features, DI names, CLI commands | No change | ✓ n/a |
 
 **Migration path for existing modules**: send `parentId: null` / `childIds: []` where clearing is intended. Trees flattened before the upgrade are not repaired (see UPGRADE_NOTES.md).
+
+## Discord AI Proposals (2026-10-13)
+
+[Waiver](UPGRADE_NOTES.md#discord-proposals)

package/dist/agentic/guides/upstream/manifest.json

@@ -1,8 +1,8 @@
 {
   "version": 1,
-  "generator": "@open-mercato/cli@0.9.1-develop.7476.1.342138d35e",
+  "generator": "@open-mercato/cli@0.9.1-develop.7496.1.3346415f94",
   "files": {
     "AGENTS.md": "9fdaca247f55c64f5966cc103265cfb03233e0532f58f14aff538ae18aa3555d",
-    "BACKWARD_COMPATIBILITY.md": "4ed6dfe6a79217d169748d52b92856516ed7fadff0f785c6d4b1913555e2e933"
+    "BACKWARD_COMPATIBILITY.md": "02d20617e0a3dfd578bd1f7514eb4a15034c60423f4e24056dbe51f9330f756e"
   }
 }

package/dist/bin.js

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
 import { isTelemetryBackendEnabled } from "@open-mercato/shared/lib/telemetry/runtime";
+import { installNextSubpathResolveHook } from "@open-mercato/shared/lib/bootstrap/next-subpath-resolve-hook";
 import { resolveCliBootstrapMode } from "./lib/cli-bootstrap-mode.js";
 import { flushBeforeExit } from "./lib/flush-before-exit.js";
 function assertNode24Runtime() {
@@ -48,6 +49,7 @@ async function tryBootstrap(mode) {
 }
 async function main() {
   assertNode24Runtime();
+  installNextSubpathResolveHook();
   const bootstrapMode = resolveCliBootstrapMode(process.argv);
   if (bootstrapMode !== "none") {
     const { loadAppEnv } = await import("./lib/load-env.js");

package/dist/bin.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/bin.ts"],
-  "sourcesContent": ["/**\n * CLI binary entry point for @open-mercato/cli package.\n *\n * Called from within a Next.js app directory as: yarn mercato <command>\n * Uses dynamic app resolution to find generated files at .mercato/generated/\n */\nimport { isTelemetryBackendEnabled } from '@open-mercato/shared/lib/telemetry/runtime'\nimport { resolveCliBootstrapMode, type CliBootstrapMode } from './lib/cli-bootstrap-mode.js'\nimport { flushBeforeExit } from './lib/flush-before-exit.js'\n// `run` is imported dynamically inside `main()` so telemetry can initialize\n// before the mercato entry (and its Postgres driver) loads \u2014 see main().\n\nfunction assertNode24Runtime(): void {\n  const detectedNodeVersion = process.versions.node\n  const majorVersion = Number.parseInt(detectedNodeVersion.split('.')[0] ?? '0', 10)\n  if (majorVersion >= 24) {\n    return\n  }\n  throw new Error(\n    [\n      'Unsupported Node.js runtime.',\n      `Cause: Detected Node ${detectedNodeVersion}, but Open Mercato requires Node 24.x.`,\n      'What to do: switch your shell to Node 24 (for example `nvm use 24`), run `yarn install`, then retry.',\n    ].join(' '),\n  )\n}\n\nasync function tryBootstrap(mode: Exclude<CliBootstrapMode, 'none'>): Promise<boolean> {\n  try {\n    // Use the CLI resolver to find the app directory (handles monorepo detection)\n    const { createResolver } = await import('./lib/resolver.js')\n    const resolver = createResolver()\n    const appDir = resolver.getAppDir()\n\n    if (mode === 'dev-supervisor') {\n      const {\n        canUseLightweightDevSupervisor,\n        loadDevSupervisorManifest,\n        registerDevSupervisorManifest,\n      } = await import(\n        './lib/dev-supervisor-manifest.js'\n      )\n      const manifest = loadDevSupervisorManifest(appDir)\n      if (canUseLightweightDevSupervisor(manifest)) {\n        registerDevSupervisorManifest(manifest)\n        return true\n      }\n    }\n\n    const { bootstrapFromAppRoot } = await import('@open-mercato/shared/lib/bootstrap/dynamicLoader')\n    const { registerCliModules } = await import('./mercato.js')\n    const data = await bootstrapFromAppRoot(appDir)\n    // Register CLI modules directly to avoid module resolution issues\n    registerCliModules(data.modules)\n    return true\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err)\n    // Check if the error is about missing generated files\n    if (\n      message.includes('dev-supervisor.generated.json') ||\n      (\n        message.includes('Cannot find module') &&\n        (message.includes('/generated/') || message.includes('.generated') || message.includes('.mercato'))\n      )\n    ) {\n      return false\n    }\n    // Re-throw other errors\n    throw err\n  }\n}\n\nasync function main(): Promise<void> {\n  assertNode24Runtime()\n  const bootstrapMode = resolveCliBootstrapMode(process.argv)\n\n  if (bootstrapMode !== 'none') {\n    // Load the app's `.env` BEFORE initTelemetry(): `run()` only dotenv-loads it\n    // later (ensureEnvLoaded), which is too late \u2014 TELEMETRY_BACKEND set only in\n    // `.env` would silently resolve to `noop` for worker/scheduler processes.\n    // The loader touches only the resolver + dotenv (no `pg`), preserving the\n    // instrumentation load-order guarantee below.\n    const { loadAppEnv } = await import('./lib/load-env.js')\n    await loadAppEnv()\n\n    // Initialize telemetry BEFORE bootstrapping the app graph. Bootstrap and the\n    // per-command handlers load MikroORM's Postgres driver \u2192 `pg`, and the\n    // OpenTelemetry pg/undici auto-instrumentation only records spans for a\n    // driver required AFTER the SDK has started. Registering here \u2014 ahead of any\n    // app module \u2014 is what lets long-running worker/scheduler processes emit DB\n    // spans (not just the bullmq-otel add/process envelope). The package itself\n    // is not imported unless an explicit supported backend is selected.\n    if (isTelemetryBackendEnabled()) {\n      const { initTelemetry } = await import('@open-mercato/telemetry')\n      await initTelemetry()\n    }\n\n    const bootstrapSucceeded = await tryBootstrap(bootstrapMode)\n    if (!bootstrapSucceeded) {\n      console.error('\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557')\n      console.error('\u2551  Generated files not found!                                       \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u2551  The CLI requires generated files to discover modules.           \u2551')\n      console.error('\u2551  Please run the following command first:                         \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u2551    yarn mercato generate                                         \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D')\n      process.exit(1)\n    }\n  }\n\n  // Dynamic import (not a top-level static import) so the mercato entry \u2014 and the\n  // Postgres driver it pulls in \u2014 loads only after initTelemetry() above.\n  const { run } = await import('./mercato.js')\n  const code = await run(process.argv)\n  // Flush the coalesced browser broadcasts, then spans/logs, for commands that\n  // return (workers block forever and flush via their own shutdown handler instead).\n  await flushBeforeExit()\n  process.exit(code ?? 0)\n}\n\nmain().catch((error: unknown) => {\n  if (error instanceof Error) {\n    console.error(error.message)\n  } else {\n    console.error(error)\n  }\n  process.exit(1)\n})\n"],
-  "mappings": "AAMA,SAAS,iCAAiC;AAC1C,SAAS,+BAAsD;AAC/D,SAAS,uBAAuB;AAIhC,SAAS,sBAA4B;AACnC,QAAM,sBAAsB,QAAQ,SAAS;AAC7C,QAAM,eAAe,OAAO,SAAS,oBAAoB,MAAM,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE;AACjF,MAAI,gBAAgB,IAAI;AACtB;AAAA,EACF;AACA,QAAM,IAAI;AAAA,IACR;AAAA,MACE;AAAA,MACA,wBAAwB,mBAAmB;AAAA,MAC3C;AAAA,IACF,EAAE,KAAK,GAAG;AAAA,EACZ;AACF;AAEA,eAAe,aAAa,MAA2D;AACrF,MAAI;AAEF,UAAM,EAAE,eAAe,IAAI,MAAM,OAAO,mBAAmB;AAC3D,UAAM,WAAW,eAAe;AAChC,UAAM,SAAS,SAAS,UAAU;AAElC,QAAI,SAAS,kBAAkB;AAC7B,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,MACF,IAAI,MAAM,OACR,kCACF;AACA,YAAM,WAAW,0BAA0B,MAAM;AACjD,UAAI,+BAA+B,QAAQ,GAAG;AAC5C,sCAA8B,QAAQ;AACtC,eAAO;AAAA,MACT;AAAA,IACF;AAEA,UAAM,EAAE,qBAAqB,IAAI,MAAM,OAAO,kDAAkD;AAChG,UAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,cAAc;AAC1D,UAAM,OAAO,MAAM,qBAAqB,MAAM;AAE9C,uBAAmB,KAAK,OAAO;AAC/B,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,UAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAE/D,QACE,QAAQ,SAAS,+BAA+B,KAE9C,QAAQ,SAAS,oBAAoB,MACpC,QAAQ,SAAS,aAAa,KAAK,QAAQ,SAAS,YAAY,KAAK,QAAQ,SAAS,UAAU,IAEnG;AACA,aAAO;AAAA,IACT;AAEA,UAAM;AAAA,EACR;AACF;AAEA,eAAe,OAAsB;AACnC,sBAAoB;AACpB,QAAM,gBAAgB,wBAAwB,QAAQ,IAAI;AAE1D,MAAI,kBAAkB,QAAQ;AAM5B,UAAM,EAAE,WAAW,IAAI,MAAM,OAAO,mBAAmB;AACvD,UAAM,WAAW;AASjB,QAAI,0BAA0B,GAAG;AAC/B,YAAM,EAAE,cAAc,IAAI,MAAM,OAAO,yBAAyB;AAChE,YAAM,cAAc;AAAA,IACtB;AAEA,UAAM,qBAAqB,MAAM,aAAa,aAAa;AAC3D,QAAI,CAAC,oBAAoB;AACvB,cAAQ,MAAM,gaAAuE;AACrF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gaAAuE;AACrF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AAIA,QAAM,EAAE,IAAI,IAAI,MAAM,OAAO,cAAc;AAC3C,QAAM,OAAO,MAAM,IAAI,QAAQ,IAAI;AAGnC,QAAM,gBAAgB;AACtB,UAAQ,KAAK,QAAQ,CAAC;AACxB;AAEA,KAAK,EAAE,MAAM,CAAC,UAAmB;AAC/B,MAAI,iBAAiB,OAAO;AAC1B,YAAQ,MAAM,MAAM,OAAO;AAAA,EAC7B,OAAO;AACL,YAAQ,MAAM,KAAK;AAAA,EACrB;AACA,UAAQ,KAAK,CAAC;AAChB,CAAC;",
+  "sourcesContent": ["/**\n * CLI binary entry point for @open-mercato/cli package.\n *\n * Called from within a Next.js app directory as: yarn mercato <command>\n * Uses dynamic app resolution to find generated files at .mercato/generated/\n */\nimport { isTelemetryBackendEnabled } from '@open-mercato/shared/lib/telemetry/runtime'\nimport { installNextSubpathResolveHook } from '@open-mercato/shared/lib/bootstrap/next-subpath-resolve-hook'\nimport { resolveCliBootstrapMode, type CliBootstrapMode } from './lib/cli-bootstrap-mode.js'\nimport { flushBeforeExit } from './lib/flush-before-exit.js'\n// `run` is imported dynamically inside `main()` so telemetry can initialize\n// before the mercato entry (and its Postgres driver) loads \u2014 see main().\n\nfunction assertNode24Runtime(): void {\n  const detectedNodeVersion = process.versions.node\n  const majorVersion = Number.parseInt(detectedNodeVersion.split('.')[0] ?? '0', 10)\n  if (majorVersion >= 24) {\n    return\n  }\n  throw new Error(\n    [\n      'Unsupported Node.js runtime.',\n      `Cause: Detected Node ${detectedNodeVersion}, but Open Mercato requires Node 24.x.`,\n      'What to do: switch your shell to Node 24 (for example `nvm use 24`), run `yarn install`, then retry.',\n    ].join(' '),\n  )\n}\n\nasync function tryBootstrap(mode: Exclude<CliBootstrapMode, 'none'>): Promise<boolean> {\n  try {\n    // Use the CLI resolver to find the app directory (handles monorepo detection)\n    const { createResolver } = await import('./lib/resolver.js')\n    const resolver = createResolver()\n    const appDir = resolver.getAppDir()\n\n    if (mode === 'dev-supervisor') {\n      const {\n        canUseLightweightDevSupervisor,\n        loadDevSupervisorManifest,\n        registerDevSupervisorManifest,\n      } = await import(\n        './lib/dev-supervisor-manifest.js'\n      )\n      const manifest = loadDevSupervisorManifest(appDir)\n      if (canUseLightweightDevSupervisor(manifest)) {\n        registerDevSupervisorManifest(manifest)\n        return true\n      }\n    }\n\n    const { bootstrapFromAppRoot } = await import('@open-mercato/shared/lib/bootstrap/dynamicLoader')\n    const { registerCliModules } = await import('./mercato.js')\n    const data = await bootstrapFromAppRoot(appDir)\n    // Register CLI modules directly to avoid module resolution issues\n    registerCliModules(data.modules)\n    return true\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err)\n    // Check if the error is about missing generated files\n    if (\n      message.includes('dev-supervisor.generated.json') ||\n      (\n        message.includes('Cannot find module') &&\n        (message.includes('/generated/') || message.includes('.generated') || message.includes('.mercato'))\n      )\n    ) {\n      return false\n    }\n    // Re-throw other errors\n    throw err\n  }\n}\n\nasync function main(): Promise<void> {\n  assertNode24Runtime()\n  // Commands and workers run in plain Node, where a bare `next/<subpath>` such\n  // as `next/dynamic` or `next/link` does not resolve (#7102). Install the\n  // retry-with-`.js` hook before any package dist can be imported.\n  installNextSubpathResolveHook()\n  const bootstrapMode = resolveCliBootstrapMode(process.argv)\n\n  if (bootstrapMode !== 'none') {\n    // Load the app's `.env` BEFORE initTelemetry(): `run()` only dotenv-loads it\n    // later (ensureEnvLoaded), which is too late \u2014 TELEMETRY_BACKEND set only in\n    // `.env` would silently resolve to `noop` for worker/scheduler processes.\n    // The loader touches only the resolver + dotenv (no `pg`), preserving the\n    // instrumentation load-order guarantee below.\n    const { loadAppEnv } = await import('./lib/load-env.js')\n    await loadAppEnv()\n\n    // Initialize telemetry BEFORE bootstrapping the app graph. Bootstrap and the\n    // per-command handlers load MikroORM's Postgres driver \u2192 `pg`, and the\n    // OpenTelemetry pg/undici auto-instrumentation only records spans for a\n    // driver required AFTER the SDK has started. Registering here \u2014 ahead of any\n    // app module \u2014 is what lets long-running worker/scheduler processes emit DB\n    // spans (not just the bullmq-otel add/process envelope). The package itself\n    // is not imported unless an explicit supported backend is selected.\n    if (isTelemetryBackendEnabled()) {\n      const { initTelemetry } = await import('@open-mercato/telemetry')\n      await initTelemetry()\n    }\n\n    const bootstrapSucceeded = await tryBootstrap(bootstrapMode)\n    if (!bootstrapSucceeded) {\n      console.error('\u2554\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2557')\n      console.error('\u2551  Generated files not found!                                       \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u2551  The CLI requires generated files to discover modules.           \u2551')\n      console.error('\u2551  Please run the following command first:                         \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u2551    yarn mercato generate                                         \u2551')\n      console.error('\u2551                                                                   \u2551')\n      console.error('\u255A\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u255D')\n      process.exit(1)\n    }\n  }\n\n  // Dynamic import (not a top-level static import) so the mercato entry \u2014 and the\n  // Postgres driver it pulls in \u2014 loads only after initTelemetry() above.\n  const { run } = await import('./mercato.js')\n  const code = await run(process.argv)\n  // Flush the coalesced browser broadcasts, then spans/logs, for commands that\n  // return (workers block forever and flush via their own shutdown handler instead).\n  await flushBeforeExit()\n  process.exit(code ?? 0)\n}\n\nmain().catch((error: unknown) => {\n  if (error instanceof Error) {\n    console.error(error.message)\n  } else {\n    console.error(error)\n  }\n  process.exit(1)\n})\n"],
+  "mappings": "AAMA,SAAS,iCAAiC;AAC1C,SAAS,qCAAqC;AAC9C,SAAS,+BAAsD;AAC/D,SAAS,uBAAuB;AAIhC,SAAS,sBAA4B;AACnC,QAAM,sBAAsB,QAAQ,SAAS;AAC7C,QAAM,eAAe,OAAO,SAAS,oBAAoB,MAAM,GAAG,EAAE,CAAC,KAAK,KAAK,EAAE;AACjF,MAAI,gBAAgB,IAAI;AACtB;AAAA,EACF;AACA,QAAM,IAAI;AAAA,IACR;AAAA,MACE;AAAA,MACA,wBAAwB,mBAAmB;AAAA,MAC3C;AAAA,IACF,EAAE,KAAK,GAAG;AAAA,EACZ;AACF;AAEA,eAAe,aAAa,MAA2D;AACrF,MAAI;AAEF,UAAM,EAAE,eAAe,IAAI,MAAM,OAAO,mBAAmB;AAC3D,UAAM,WAAW,eAAe;AAChC,UAAM,SAAS,SAAS,UAAU;AAElC,QAAI,SAAS,kBAAkB;AAC7B,YAAM;AAAA,QACJ;AAAA,QACA;AAAA,QACA;AAAA,MACF,IAAI,MAAM,OACR,kCACF;AACA,YAAM,WAAW,0BAA0B,MAAM;AACjD,UAAI,+BAA+B,QAAQ,GAAG;AAC5C,sCAA8B,QAAQ;AACtC,eAAO;AAAA,MACT;AAAA,IACF;AAEA,UAAM,EAAE,qBAAqB,IAAI,MAAM,OAAO,kDAAkD;AAChG,UAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,cAAc;AAC1D,UAAM,OAAO,MAAM,qBAAqB,MAAM;AAE9C,uBAAmB,KAAK,OAAO;AAC/B,WAAO;AAAA,EACT,SAAS,KAAK;AACZ,UAAM,UAAU,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAE/D,QACE,QAAQ,SAAS,+BAA+B,KAE9C,QAAQ,SAAS,oBAAoB,MACpC,QAAQ,SAAS,aAAa,KAAK,QAAQ,SAAS,YAAY,KAAK,QAAQ,SAAS,UAAU,IAEnG;AACA,aAAO;AAAA,IACT;AAEA,UAAM;AAAA,EACR;AACF;AAEA,eAAe,OAAsB;AACnC,sBAAoB;AAIpB,gCAA8B;AAC9B,QAAM,gBAAgB,wBAAwB,QAAQ,IAAI;AAE1D,MAAI,kBAAkB,QAAQ;AAM5B,UAAM,EAAE,WAAW,IAAI,MAAM,OAAO,mBAAmB;AACvD,UAAM,WAAW;AASjB,QAAI,0BAA0B,GAAG;AAC/B,YAAM,EAAE,cAAc,IAAI,MAAM,OAAO,yBAAyB;AAChE,YAAM,cAAc;AAAA,IACtB;AAEA,UAAM,qBAAqB,MAAM,aAAa,aAAa;AAC3D,QAAI,CAAC,oBAAoB;AACvB,cAAQ,MAAM,gaAAuE;AACrF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gFAAsE;AACpF,cAAQ,MAAM,iFAAuE;AACrF,cAAQ,MAAM,gaAAuE;AACrF,cAAQ,KAAK,CAAC;AAAA,IAChB;AAAA,EACF;AAIA,QAAM,EAAE,IAAI,IAAI,MAAM,OAAO,cAAc;AAC3C,QAAM,OAAO,MAAM,IAAI,QAAQ,IAAI;AAGnC,QAAM,gBAAgB;AACtB,UAAQ,KAAK,QAAQ,CAAC;AACxB;AAEA,KAAK,EAAE,MAAM,CAAC,UAAmB;AAC/B,MAAI,iBAAiB,OAAO;AAC1B,YAAQ,MAAM,MAAM,OAAO;AAAA,EAC7B,OAAO;AACL,YAAQ,MAAM,KAAK;AAAA,EACrB;AACA,UAAQ,KAAK,CAAC;AAChB,CAAC;",
   "names": []
 }

package/dist/mercato.js

@@ -233,7 +233,11 @@ async function ensureEnvLoaded(options = {}) {
       const examplePath = path.join(appDir, ".env.example");
       if (fs.existsSync(examplePath)) {
         fs.copyFileSync(examplePath, envPath);
-        console.log(`\u{1F4CB} Copied .env.example \u2192 .env (edit ${envPath} to customize)`);
+        console.log("");
+        console.log("\u26A0\uFE0F  No .env was found, so one was created from .env.example.");
+        console.log(`   ${envPath}`);
+        console.log("   It carries the example placeholders \u2014 review DATABASE_URL and secrets before continuing.");
+        console.log("");
       }
     }
     if (fs.existsSync(envPath)) {
@@ -656,13 +660,53 @@ async function buildAllModules() {
   if (appCli.length) all.push({ id: "app", cli: appCli });
   return all;
 }
+function isHelpRequest(args) {
+  return args.some((arg) => arg === "--help" || arg === "-h");
+}
+const TOP_LEVEL_COMMAND_HELP = {
+  init: [
+    "Usage: mercato init [--reinstall|-r] [--no-examples] [--stresstest [--lite] [--count=<n>]]",
+    "Initializes this app: installs dependencies, runs generators, applies migrations and seeds data."
+  ],
+  "agentic:init": [
+    "Usage: mercato agentic:init [--force]",
+    "Scaffolds the agentic harness (AGENTS.md, .ai/ config and skills) into this app."
+  ],
+  "seed:defaults": [
+    "Usage: mercato seed:defaults [--module <moduleId>]",
+    "Runs every enabled module's seedDefaults hook, or only the named module's."
+  ],
+  "umes:list": [
+    "Usage: mercato umes:list",
+    "Lists the extension points every enabled module declares."
+  ],
+  "umes:inspect": [
+    "Usage: mercato umes:inspect --module <moduleId>",
+    "Prints the extension surface a single module declares."
+  ],
+  "umes:check": [
+    "Usage: mercato umes:check",
+    "Validates declared extension points against the modules that implement them."
+  ]
+};
+function resolveEnvBootstrapOptions(parts) {
+  const first = parts[0];
+  const opaqueEnvCommand = first === "deploy" || first === "telemetry";
+  const helpRequested = isHelpRequest(parts);
+  return {
+    createIfMissing: !helpRequested && !opaqueEnvCommand,
+    quiet: helpRequested || opaqueEnvCommand
+  };
+}
 async function run(argv = process.argv) {
   const [, , ...parts] = argv;
   const [first, second, ...remaining] = parts;
-  await ensureEnvLoaded({
-    createIfMissing: first !== "deploy" && first !== "telemetry",
-    quiet: first === "deploy" || first === "telemetry"
-  });
+  const helpRequested = isHelpRequest(parts);
+  await ensureEnvLoaded(resolveEnvBootstrapOptions(parts));
+  if (helpRequested && first && Object.hasOwn(TOP_LEVEL_COMMAND_HELP, first)) {
+    for (const line of TOP_LEVEL_COMMAND_HELP[first]) console.log(`  ${line}`);
+    return 0;
+  }
   if (first === "init") {
     const { execSync } = await import("child_process");
     console.log("\u{1F680} Initializing Open Mercato app...\n");
@@ -1297,6 +1341,8 @@ async function run(argv = process.argv) {
     cli: [
       {
         command: "railway",
+        // Parses --help/-h itself and prints railwayDeployHelp() without deploying.
+        handlesHelp: true,
         run: async (args) => {
           const { runRailwayDeploy } = await import("./lib/deploy/railway/index.js");
           await runRailwayDeploy(args);
@@ -1600,6 +1646,7 @@ async function run(argv = process.argv) {
     cli: [
       {
         command: "generate",
+        help: "Generates a migration per module from the current ORM entities and refreshes each\nmodule's .snapshot-open-mercato.json. Writes files only \u2014 nothing is applied.",
         run: async () => {
           const { createResolver } = await import("./lib/resolver.js");
           const { dbGenerate } = await import("./lib/db/index.js");
@@ -1609,6 +1656,7 @@ async function run(argv = process.argv) {
       },
       {
         command: "migrate",
+        help: "Applies every pending migration to the database DATABASE_URL points at.\nThis mutates the database \u2014 check .env before running it.",
         run: async () => {
           const { createResolver } = await import("./lib/resolver.js");
           const { dbMigrate } = await import("./lib/db/index.js");
@@ -1618,6 +1666,7 @@ async function run(argv = process.argv) {
       },
       {
         command: "greenfield",
+        help: "Drops and recreates the schema from scratch, then re-applies every migration.\nDestroys all data. Pass --yes (-y) to skip the confirmation prompt.",
         run: async (args) => {
           const { createResolver } = await import("./lib/resolver.js");
           const { dbGreenfield } = await import("./lib/db/index.js");
@@ -2170,11 +2219,26 @@ async function run(argv = process.argv) {
     console.log(pad(`Commands for "${modName}": ${mod.cli.map((c) => c.command).join(", ")}`));
     return 1;
   }
+  if (isHelpRequest([cmdName])) {
+    console.log(pad(`Usage: \u2728 mercato ${modName} <command> [args]`));
+    console.log(pad(`Commands for "${modName}": ${mod.cli.map((c) => c.command).join(", ")}`));
+    return 0;
+  }
   const cmd = mod.cli.find((c) => c.command === cmdName);
   if (!cmd) {
     console.error(`\u{1F914} Unknown command "${cmdName}". Available: ${mod.cli.map((c) => c.command).join(", ")}`);
     return 1;
   }
+  if (isHelpRequest(rest) && !cmd.handlesHelp) {
+    console.log(pad(`Usage: \u2728 mercato ${modName} ${cmdName} [args]`));
+    if (cmd.help) {
+      console.log("");
+      for (const line of cmd.help.split("\n")) console.log(pad(line));
+    }
+    console.log("");
+    console.log(pad(`Commands for "${modName}": ${mod.cli.map((c) => c.command).join(", ")}`));
+    return 0;
+  }
   console.log("");
   const started = Date.now();
   const loggedArgs = modName === "deploy" && cmdName === "railway" ? (await import("./lib/deploy/railway/options.js")).redactRailwayCliArgs(rest) : rest;
@@ -2194,8 +2258,10 @@ async function run(argv = process.argv) {
 export {
   getCliModules,
   hasCliModules,
+  isHelpRequest,
   padByCodePointWidth,
   registerCliModules,
+  resolveEnvBootstrapOptions,
   resolveQueueAbandonHook,
   run
 };