@open-mercato/cli 0.9.1-develop.7477.1.64ba865101 → 0.9.1-develop.7497.1.543ea44c40

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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/scheduler 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/search 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/storage-s3 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/sync-akeneo 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/telemetry 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/tillio 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/webhooks 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101; core 0.9.1-develop.7477.1.64ba865101 — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.9.1-develop.7497.1.543ea44c40; core 0.9.1-develop.7497.1.543ea44c40 — 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.7477.1.64ba865101",
+      "coreVersion": "0.9.1-develop.7497.1.543ea44c40",
       "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.7477.1.64ba865101",
+  "generator": "@open-mercato/cli@0.9.1-develop.7497.1.543ea44c40",
   "files": {
     "AGENTS.md": "9fdaca247f55c64f5966cc103265cfb03233e0532f58f14aff538ae18aa3555d",
-    "BACKWARD_COMPATIBILITY.md": "4ed6dfe6a79217d169748d52b92856516ed7fadff0f785c6d4b1913555e2e933"
+    "BACKWARD_COMPATIBILITY.md": "02d20617e0a3dfd578bd1f7514eb4a15034c60423f4e24056dbe51f9330f756e"
   }
 }

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
 };