create-mercato-app 0.5.1-develop.2691.d8a0934b37 → 0.5.1-develop.2699.f8b50c8046

package/dist/index.js

@@ -3,9 +3,9 @@
 
 // src/index.ts
 import { createInterface } from "node:readline";
-import { basename as basename2, dirname as dirname5, join as join6, resolve } from "node:path";
-import { existsSync as existsSync6, mkdirSync as mkdirSync6, readdirSync as readdirSync3, readFileSync as readFileSync5, statSync as statSync2, writeFileSync as writeFileSync6, copyFileSync as copyFileSync5 } from "node:fs";
-import { fileURLToPath as fileURLToPath5 } from "node:url";
+import { basename as basename2, dirname as dirname6, join as join7, resolve } from "node:path";
+import { existsSync as existsSync6, mkdirSync as mkdirSync6, readdirSync as readdirSync3, readFileSync as readFileSync6, statSync as statSync2, writeFileSync as writeFileSync7, copyFileSync as copyFileSync5 } from "node:fs";
+import { fileURLToPath as fileURLToPath6 } from "node:url";
 import pc from "picocolors";
 
 // src/lib/ready-apps.ts
@@ -308,138 +308,262 @@ async function extractTarballSnapshot(archive, targetDir) {
   }
 }
 
+// src/lib/apply-starter-preset.ts
+import { readFileSync, writeFileSync as writeFileSync2, rmSync as rmSync2 } from "node:fs";
+import { join as join2, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+// src/lib/starter-presets.ts
+var CORE = "@open-mercato/core";
+var EMPTY_MODULES = [
+  { id: "auth", from: CORE },
+  { id: "directory", from: CORE },
+  { id: "configs", from: CORE },
+  { id: "entities", from: CORE },
+  { id: "query_index", from: CORE },
+  { id: "api_docs", from: CORE }
+];
+var STARTER_PRESETS = {
+  classic: {
+    id: "classic",
+    label: "Classic",
+    description: "Current full starter behavior",
+    modules: { mode: "replace", enabled: [] },
+    ui: { startPageVariant: "classic", hideDemoLinks: false },
+    constraints: { rejectWithReadyApps: false }
+  },
+  empty: {
+    id: "empty",
+    label: "Empty",
+    description: "Minimal builder-ready baseline",
+    modules: { mode: "replace", enabled: EMPTY_MODULES },
+    ui: { startPageVariant: "minimal", hideDemoLinks: true },
+    files: { remove: ["src/modules/example", "src/modules/example_customers_sync"] },
+    constraints: { rejectWithReadyApps: true }
+  },
+  crm: {
+    id: "crm",
+    label: "CRM",
+    description: "Empty preset plus CRM capabilities",
+    extends: "empty",
+    modules: {
+      mode: "patch",
+      add: [
+        { id: "customers", from: CORE },
+        { id: "dictionaries", from: CORE },
+        { id: "feature_toggles", from: CORE }
+      ]
+    },
+    ui: { startPageVariant: "crm", hideDemoLinks: true },
+    constraints: { rejectWithReadyApps: true }
+  }
+};
+var DEFAULT_PRESET_ID = "classic";
+var VALID_PRESET_IDS = Object.keys(STARTER_PRESETS);
+
+// src/lib/apply-starter-preset.ts
+var __dirname = dirname(fileURLToPath(import.meta.url));
+function resolvePreset(presetId) {
+  const preset = STARTER_PRESETS[presetId];
+  if (!preset) {
+    throw new Error(`Unknown preset "${presetId}". Valid presets: ${VALID_PRESET_IDS.join(", ")}`);
+  }
+  let modules;
+  let parentFilesToRemove = [];
+  if (preset.modules.mode === "replace") {
+    modules = [...preset.modules.enabled];
+  } else {
+    if (!preset.extends) {
+      throw new Error(`Preset "${presetId}" uses mode "patch" but has no "extends" parent`);
+    }
+    const parent = STARTER_PRESETS[preset.extends];
+    if (!parent) {
+      throw new Error(`Preset "${presetId}" extends unknown preset "${preset.extends}"`);
+    }
+    if (parent.modules.mode !== "replace") {
+      throw new Error(`Preset "${presetId}" parent "${preset.extends}" must use mode "replace"`);
+    }
+    parentFilesToRemove = parent.files?.remove ?? [];
+    let base = [...parent.modules.enabled];
+    if (preset.modules.add) {
+      base = [...base, ...preset.modules.add];
+    }
+    if (preset.modules.remove) {
+      const toRemove = new Set(preset.modules.remove);
+      base = base.filter((m) => !toRemove.has(m.id));
+    }
+    modules = base;
+  }
+  const ids = modules.map((m) => m.id);
+  const seen = /* @__PURE__ */ new Set();
+  const duplicates = ids.filter((id) => {
+    if (seen.has(id)) return true;
+    seen.add(id);
+    return false;
+  });
+  if (duplicates.length > 0) {
+    throw new Error(`Preset "${presetId}" has duplicate module IDs: ${duplicates.join(", ")}`);
+  }
+  const ownFilesToRemove = preset.files?.remove ?? [];
+  const filesToRemove = [.../* @__PURE__ */ new Set([...parentFilesToRemove, ...ownFilesToRemove])];
+  return {
+    id: preset.id,
+    modules,
+    filesToRemove,
+    ui: preset.ui,
+    isClassic: presetId === DEFAULT_PRESET_ID
+  };
+}
+function generateModulesTs(modules) {
+  const moduleLines = modules.map((m) => `  { id: '${m.id}', from: '${m.from}' },`).join("\n");
+  const template = readFileSync(join2(__dirname, "templates", "modules-ts.template"), "utf8");
+  return template.replace("{{MODULES}}", moduleLines);
+}
+function applyStarterPreset(presetId, targetDir) {
+  const resolved = resolvePreset(presetId);
+  if (resolved.isClassic) return;
+  writeFileSync2(join2(targetDir, "src", "modules.ts"), generateModulesTs(resolved.modules));
+  for (const relativePath of resolved.filesToRemove) {
+    rmSync2(join2(targetDir, relativePath), { recursive: true, force: true });
+  }
+  writeFileSync2(
+    join2(targetDir, ".mercato", "starter-preset.json"),
+    JSON.stringify({ preset: presetId, generatedAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2) + "\n"
+  );
+}
+
 // src/setup/wizard.ts
 import { basename } from "node:path";
 
 // src/setup/tools/shared.ts
-import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync, writeFileSync as writeFileSync2, copyFileSync, readdirSync as readdirSync2 } from "node:fs";
-import { join as join2, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-var __dirname = dirname(fileURLToPath(import.meta.url));
-var AGENTIC_DIR = join2(__dirname, "agentic", "shared");
-var GUIDES_DIR = join2(__dirname, "agentic", "guides");
+import { existsSync as existsSync2, mkdirSync as mkdirSync2, readFileSync as readFileSync2, writeFileSync as writeFileSync3, copyFileSync, readdirSync as readdirSync2 } from "node:fs";
+import { join as join3, dirname as dirname2 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
+var AGENTIC_DIR = join3(__dirname2, "agentic", "shared");
+var GUIDES_DIR = join3(__dirname2, "agentic", "guides");
 function resolvePlaceholders(content, config) {
   return content.replace(/\{\{PROJECT_NAME\}\}/g, config.projectName);
 }
 function ensureDir(filePath) {
-  const dir = dirname(filePath);
+  const dir = dirname2(filePath);
   if (!existsSync2(dir)) {
     mkdirSync2(dir, { recursive: true });
   }
 }
 function writeTemplate(srcRelative, destPath, config) {
-  const srcPath = join2(AGENTIC_DIR, srcRelative);
-  const content = readFileSync(srcPath, "utf-8");
+  const srcPath = join3(AGENTIC_DIR, srcRelative);
+  const content = readFileSync2(srcPath, "utf-8");
   ensureDir(destPath);
-  writeFileSync2(destPath, resolvePlaceholders(content, config));
+  writeFileSync3(destPath, resolvePlaceholders(content, config));
 }
 function copyFile(srcRelative, destPath) {
-  const srcPath = join2(AGENTIC_DIR, srcRelative);
+  const srcPath = join3(AGENTIC_DIR, srcRelative);
   ensureDir(destPath);
   copyFileSync(srcPath, destPath);
 }
 function generateShared(config) {
   const { targetDir } = config;
-  writeTemplate("AGENTS.md.template", join2(targetDir, "AGENTS.md"), config);
-  writeTemplate("ai/specs/README.md", join2(targetDir, ".ai", "specs", "README.md"), config);
-  copyFile("ai/specs/SPEC-000-template.md", join2(targetDir, ".ai", "specs", "SPEC-000-template.md"));
-  copyFile("ai/lessons.md", join2(targetDir, ".ai", "lessons.md"));
+  writeTemplate("AGENTS.md.template", join3(targetDir, "AGENTS.md"), config);
+  writeTemplate("ai/specs/README.md", join3(targetDir, ".ai", "specs", "README.md"), config);
+  copyFile("ai/specs/SPEC-000-template.md", join3(targetDir, ".ai", "specs", "SPEC-000-template.md"));
+  copyFile("ai/lessons.md", join3(targetDir, ".ai", "lessons.md"));
   writeTemplate(
     "ai/skills/spec-writing/SKILL.md",
-    join2(targetDir, ".ai", "skills", "spec-writing", "SKILL.md"),
+    join3(targetDir, ".ai", "skills", "spec-writing", "SKILL.md"),
     config
   );
   copyFile(
     "ai/skills/spec-writing/references/spec-template.md",
-    join2(targetDir, ".ai", "skills", "spec-writing", "references", "spec-template.md")
+    join3(targetDir, ".ai", "skills", "spec-writing", "references", "spec-template.md")
   );
   copyFile(
     "ai/skills/spec-writing/references/spec-checklist.md",
-    join2(targetDir, ".ai", "skills", "spec-writing", "references", "spec-checklist.md")
+    join3(targetDir, ".ai", "skills", "spec-writing", "references", "spec-checklist.md")
   );
   copyFile(
     "ai/skills/backend-ui-design/SKILL.md",
-    join2(targetDir, ".ai", "skills", "backend-ui-design", "SKILL.md")
+    join3(targetDir, ".ai", "skills", "backend-ui-design", "SKILL.md")
   );
   copyFile(
     "ai/skills/backend-ui-design/references/ui-components.md",
-    join2(targetDir, ".ai", "skills", "backend-ui-design", "references", "ui-components.md")
+    join3(targetDir, ".ai", "skills", "backend-ui-design", "references", "ui-components.md")
   );
   copyFile(
     "ai/skills/code-review/SKILL.md",
-    join2(targetDir, ".ai", "skills", "code-review", "SKILL.md")
+    join3(targetDir, ".ai", "skills", "code-review", "SKILL.md")
   );
   copyFile(
     "ai/skills/code-review/references/review-checklist.md",
-    join2(targetDir, ".ai", "skills", "code-review", "references", "review-checklist.md")
+    join3(targetDir, ".ai", "skills", "code-review", "references", "review-checklist.md")
   );
   copyFile(
     "ai/skills/integration-builder/SKILL.md",
-    join2(targetDir, ".ai", "skills", "integration-builder", "SKILL.md")
+    join3(targetDir, ".ai", "skills", "integration-builder", "SKILL.md")
   );
   copyFile(
     "ai/skills/integration-builder/references/adapter-contracts.md",
-    join2(targetDir, ".ai", "skills", "integration-builder", "references", "adapter-contracts.md")
+    join3(targetDir, ".ai", "skills", "integration-builder", "references", "adapter-contracts.md")
   );
   copyFile(
     "ai/skills/system-extension/SKILL.md",
-    join2(targetDir, ".ai", "skills", "system-extension", "SKILL.md")
+    join3(targetDir, ".ai", "skills", "system-extension", "SKILL.md")
   );
   copyFile(
     "ai/skills/system-extension/references/extension-contracts.md",
-    join2(targetDir, ".ai", "skills", "system-extension", "references", "extension-contracts.md")
+    join3(targetDir, ".ai", "skills", "system-extension", "references", "extension-contracts.md")
   );
   copyFile(
     "ai/skills/module-scaffold/SKILL.md",
-    join2(targetDir, ".ai", "skills", "module-scaffold", "SKILL.md")
+    join3(targetDir, ".ai", "skills", "module-scaffold", "SKILL.md")
   );
   copyFile(
     "ai/skills/module-scaffold/references/naming-conventions.md",
-    join2(targetDir, ".ai", "skills", "module-scaffold", "references", "naming-conventions.md")
+    join3(targetDir, ".ai", "skills", "module-scaffold", "references", "naming-conventions.md")
   );
   copyFile(
     "ai/skills/module-scaffold/references/navigation-patterns.md",
-    join2(targetDir, ".ai", "skills", "module-scaffold", "references", "navigation-patterns.md")
+    join3(targetDir, ".ai", "skills", "module-scaffold", "references", "navigation-patterns.md")
   );
   copyFile(
     "ai/skills/troubleshooter/SKILL.md",
-    join2(targetDir, ".ai", "skills", "troubleshooter", "SKILL.md")
+    join3(targetDir, ".ai", "skills", "troubleshooter", "SKILL.md")
   );
   copyFile(
     "ai/skills/troubleshooter/references/diagnostic-commands.md",
-    join2(targetDir, ".ai", "skills", "troubleshooter", "references", "diagnostic-commands.md")
+    join3(targetDir, ".ai", "skills", "troubleshooter", "references", "diagnostic-commands.md")
   );
   copyFile(
     "ai/skills/eject-and-customize/SKILL.md",
-    join2(targetDir, ".ai", "skills", "eject-and-customize", "SKILL.md")
+    join3(targetDir, ".ai", "skills", "eject-and-customize", "SKILL.md")
   );
   copyFile(
     "ai/skills/data-model-design/SKILL.md",
-    join2(targetDir, ".ai", "skills", "data-model-design", "SKILL.md")
+    join3(targetDir, ".ai", "skills", "data-model-design", "SKILL.md")
   );
   copyFile(
     "ai/skills/data-model-design/references/mikro-orm-cheatsheet.md",
-    join2(targetDir, ".ai", "skills", "data-model-design", "references", "mikro-orm-cheatsheet.md")
+    join3(targetDir, ".ai", "skills", "data-model-design", "references", "mikro-orm-cheatsheet.md")
   );
   copyFile(
     "ai/skills/implement-spec/SKILL.md",
-    join2(targetDir, ".ai", "skills", "implement-spec", "SKILL.md")
+    join3(targetDir, ".ai", "skills", "implement-spec", "SKILL.md")
   );
   copyFile(
     "ai/skills/integration-tests/SKILL.md",
-    join2(targetDir, ".ai", "skills", "integration-tests", "SKILL.md")
+    join3(targetDir, ".ai", "skills", "integration-tests", "SKILL.md")
   );
   copyFile(
     "ai/skills/auto-upgrade-0.4.10-to-0.5.0/SKILL.md",
-    join2(targetDir, ".ai", "skills", "auto-upgrade-0.4.10-to-0.5.0", "SKILL.md")
+    join3(targetDir, ".ai", "skills", "auto-upgrade-0.4.10-to-0.5.0", "SKILL.md")
   );
-  copyFile("ai/qa/tests/playwright.config.ts", join2(targetDir, ".ai", "qa", "tests", "playwright.config.ts"));
+  copyFile("ai/qa/tests/playwright.config.ts", join3(targetDir, ".ai", "qa", "tests", "playwright.config.ts"));
   if (existsSync2(GUIDES_DIR)) {
-    const guidesDestDir = join2(targetDir, ".ai", "guides");
+    const guidesDestDir = join3(targetDir, ".ai", "guides");
     for (const file of readdirSync2(GUIDES_DIR)) {
       if (file.endsWith(".md")) {
-        const srcPath = join2(GUIDES_DIR, file);
-        const destPath = join2(guidesDestDir, file);
+        const srcPath = join3(GUIDES_DIR, file);
+        const destPath = join3(guidesDestDir, file);
         ensureDir(destPath);
         copyFileSync(srcPath, destPath);
       }
@@ -448,38 +572,38 @@ function generateShared(config) {
 }
 
 // src/setup/tools/claude-code.ts
-import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync3, copyFileSync as copyFileSync2, symlinkSync, lstatSync, unlinkSync } from "node:fs";
-import { join as join3, dirname as dirname2 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
-var __dirname2 = dirname2(fileURLToPath2(import.meta.url));
-var AGENTIC_DIR2 = join3(__dirname2, "agentic", "claude-code");
+import { existsSync as existsSync3, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync4, copyFileSync as copyFileSync2, symlinkSync, lstatSync, unlinkSync } from "node:fs";
+import { join as join4, dirname as dirname3 } from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+var __dirname3 = dirname3(fileURLToPath3(import.meta.url));
+var AGENTIC_DIR2 = join4(__dirname3, "agentic", "claude-code");
 function resolvePlaceholders2(content, config) {
   return content.replace(/\{\{PROJECT_NAME\}\}/g, config.projectName);
 }
 function ensureDir2(filePath) {
-  const dir = dirname2(filePath);
+  const dir = dirname3(filePath);
   if (!existsSync3(dir)) {
     mkdirSync3(dir, { recursive: true });
   }
 }
 function writeTemplate2(srcRelative, destPath, config) {
-  const srcPath = join3(AGENTIC_DIR2, srcRelative);
-  const content = readFileSync2(srcPath, "utf-8");
+  const srcPath = join4(AGENTIC_DIR2, srcRelative);
+  const content = readFileSync3(srcPath, "utf-8");
   ensureDir2(destPath);
-  writeFileSync3(destPath, resolvePlaceholders2(content, config));
+  writeFileSync4(destPath, resolvePlaceholders2(content, config));
 }
 function copyFile2(srcRelative, destPath) {
-  const srcPath = join3(AGENTIC_DIR2, srcRelative);
+  const srcPath = join4(AGENTIC_DIR2, srcRelative);
   ensureDir2(destPath);
   copyFileSync2(srcPath, destPath);
 }
 function generateClaudeCode(config) {
   const { targetDir } = config;
-  writeTemplate2("CLAUDE.md.template", join3(targetDir, "CLAUDE.md"), config);
-  copyFile2("settings.json", join3(targetDir, ".claude", "settings.json"));
-  copyFile2("hooks/entity-migration-check.ts", join3(targetDir, ".claude", "hooks", "entity-migration-check.ts"));
-  copyFile2("mcp.json.example", join3(targetDir, ".mcp.json.example"));
-  ensureSkillsLink(join3(targetDir, ".claude", "skills"), join3("..", ".ai", "skills"));
+  writeTemplate2("CLAUDE.md.template", join4(targetDir, "CLAUDE.md"), config);
+  copyFile2("settings.json", join4(targetDir, ".claude", "settings.json"));
+  copyFile2("hooks/entity-migration-check.ts", join4(targetDir, ".claude", "hooks", "entity-migration-check.ts"));
+  copyFile2("mcp.json.example", join4(targetDir, ".mcp.json.example"));
+  ensureSkillsLink(join4(targetDir, ".claude", "skills"), join4("..", ".ai", "skills"));
 }
 function ensureSkillsLink(linkPath, target) {
   ensureDir2(linkPath);
@@ -493,31 +617,31 @@ function ensureSkillsLink(linkPath, target) {
 }
 
 // src/setup/tools/codex.ts
-import { existsSync as existsSync4, mkdirSync as mkdirSync4, readFileSync as readFileSync3, writeFileSync as writeFileSync4, copyFileSync as copyFileSync3, symlinkSync as symlinkSync2, lstatSync as lstatSync2, unlinkSync as unlinkSync2 } from "node:fs";
-import { join as join4, dirname as dirname3 } from "node:path";
-import { fileURLToPath as fileURLToPath3 } from "node:url";
-var __dirname3 = dirname3(fileURLToPath3(import.meta.url));
-var AGENTIC_DIR3 = join4(__dirname3, "agentic", "codex");
+import { existsSync as existsSync4, mkdirSync as mkdirSync4, readFileSync as readFileSync4, writeFileSync as writeFileSync5, copyFileSync as copyFileSync3, symlinkSync as symlinkSync2, lstatSync as lstatSync2, unlinkSync as unlinkSync2 } from "node:fs";
+import { join as join5, dirname as dirname4 } from "node:path";
+import { fileURLToPath as fileURLToPath4 } from "node:url";
+var __dirname4 = dirname4(fileURLToPath4(import.meta.url));
+var AGENTIC_DIR3 = join5(__dirname4, "agentic", "codex");
 var MARKER_START = "<!-- CODEX_ENFORCEMENT_RULES_START -->";
 var MARKER_END = "<!-- CODEX_ENFORCEMENT_RULES_END -->";
 function ensureDir3(filePath) {
-  const dir = dirname3(filePath);
+  const dir = dirname4(filePath);
   if (!existsSync4(dir)) {
     mkdirSync4(dir, { recursive: true });
   }
 }
 function copyFile3(srcRelative, destPath) {
-  const srcPath = join4(AGENTIC_DIR3, srcRelative);
+  const srcPath = join5(AGENTIC_DIR3, srcRelative);
   ensureDir3(destPath);
   copyFileSync3(srcPath, destPath);
 }
 function generateCodex(config) {
   const { targetDir } = config;
-  const agentsPath = join4(targetDir, "AGENTS.md");
-  const rulesPath = join4(AGENTIC_DIR3, "enforcement-rules.md");
+  const agentsPath = join5(targetDir, "AGENTS.md");
+  const rulesPath = join5(AGENTIC_DIR3, "enforcement-rules.md");
   if (existsSync4(agentsPath)) {
-    let agents = readFileSync3(agentsPath, "utf-8");
-    const rules = readFileSync3(rulesPath, "utf-8");
+    let agents = readFileSync4(agentsPath, "utf-8");
+    const rules = readFileSync4(rulesPath, "utf-8");
     if (agents.includes(MARKER_START)) {
       const startIdx = agents.indexOf(MARKER_START);
       const endIdx = agents.indexOf(MARKER_END);
@@ -532,10 +656,10 @@ function generateCodex(config) {
         agents = agents + "\n\n" + rules;
       }
     }
-    writeFileSync4(agentsPath, agents);
+    writeFileSync5(agentsPath, agents);
   }
-  copyFile3("mcp.json.example", join4(targetDir, ".codex", "mcp.json.example"));
-  ensureSkillsLink2(join4(targetDir, ".codex", "skills"), join4("..", ".ai", "skills"));
+  copyFile3("mcp.json.example", join5(targetDir, ".codex", "mcp.json.example"));
+  ensureSkillsLink2(join5(targetDir, ".codex", "skills"), join5("..", ".ai", "skills"));
 }
 function ensureSkillsLink2(linkPath, target) {
   ensureDir3(linkPath);
@@ -549,40 +673,40 @@ function ensureSkillsLink2(linkPath, target) {
 }
 
 // src/setup/tools/cursor.ts
-import { existsSync as existsSync5, mkdirSync as mkdirSync5, readFileSync as readFileSync4, writeFileSync as writeFileSync5, copyFileSync as copyFileSync4, symlinkSync as symlinkSync3, lstatSync as lstatSync3, unlinkSync as unlinkSync3 } from "node:fs";
-import { join as join5, dirname as dirname4 } from "node:path";
-import { fileURLToPath as fileURLToPath4 } from "node:url";
-var __dirname4 = dirname4(fileURLToPath4(import.meta.url));
-var AGENTIC_DIR4 = join5(__dirname4, "agentic", "cursor");
+import { existsSync as existsSync5, mkdirSync as mkdirSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync6, copyFileSync as copyFileSync4, symlinkSync as symlinkSync3, lstatSync as lstatSync3, unlinkSync as unlinkSync3 } from "node:fs";
+import { join as join6, dirname as dirname5 } from "node:path";
+import { fileURLToPath as fileURLToPath5 } from "node:url";
+var __dirname5 = dirname5(fileURLToPath5(import.meta.url));
+var AGENTIC_DIR4 = join6(__dirname5, "agentic", "cursor");
 function resolvePlaceholders3(content, config) {
   return content.replace(/\{\{PROJECT_NAME\}\}/g, config.projectName);
 }
 function ensureDir4(filePath) {
-  const dir = dirname4(filePath);
+  const dir = dirname5(filePath);
   if (!existsSync5(dir)) {
     mkdirSync5(dir, { recursive: true });
   }
 }
 function writeTemplate3(srcRelative, destPath, config) {
-  const srcPath = join5(AGENTIC_DIR4, srcRelative);
-  const content = readFileSync4(srcPath, "utf-8");
+  const srcPath = join6(AGENTIC_DIR4, srcRelative);
+  const content = readFileSync5(srcPath, "utf-8");
   ensureDir4(destPath);
-  writeFileSync5(destPath, resolvePlaceholders3(content, config));
+  writeFileSync6(destPath, resolvePlaceholders3(content, config));
 }
 function copyFile4(srcRelative, destPath) {
-  const srcPath = join5(AGENTIC_DIR4, srcRelative);
+  const srcPath = join6(AGENTIC_DIR4, srcRelative);
   ensureDir4(destPath);
   copyFileSync4(srcPath, destPath);
 }
 function generateCursor(config) {
   const { targetDir } = config;
-  writeTemplate3("rules/open-mercato.mdc", join5(targetDir, ".cursor", "rules", "open-mercato.mdc"), config);
-  copyFile4("rules/entity-guard.mdc", join5(targetDir, ".cursor", "rules", "entity-guard.mdc"));
-  copyFile4("rules/generated-guard.mdc", join5(targetDir, ".cursor", "rules", "generated-guard.mdc"));
-  copyFile4("hooks.json", join5(targetDir, ".cursor", "hooks.json"));
-  copyFile4("hooks/entity-migration-check.mjs", join5(targetDir, ".cursor", "hooks", "entity-migration-check.mjs"));
-  copyFile4("mcp.json.example", join5(targetDir, ".cursor", "mcp.json.example"));
-  ensureSkillsLink3(join5(targetDir, ".cursor", "skills"), join5("..", ".ai", "skills"));
+  writeTemplate3("rules/open-mercato.mdc", join6(targetDir, ".cursor", "rules", "open-mercato.mdc"), config);
+  copyFile4("rules/entity-guard.mdc", join6(targetDir, ".cursor", "rules", "entity-guard.mdc"));
+  copyFile4("rules/generated-guard.mdc", join6(targetDir, ".cursor", "rules", "generated-guard.mdc"));
+  copyFile4("hooks.json", join6(targetDir, ".cursor", "hooks.json"));
+  copyFile4("hooks/entity-migration-check.mjs", join6(targetDir, ".cursor", "hooks", "entity-migration-check.mjs"));
+  copyFile4("mcp.json.example", join6(targetDir, ".cursor", "mcp.json.example"));
+  ensureSkillsLink3(join6(targetDir, ".cursor", "skills"), join6("..", ".ai", "skills"));
 }
 function ensureSkillsLink3(linkPath, target) {
   ensureDir4(linkPath);
@@ -675,10 +799,10 @@ function printSummary(selectedIds) {
 }
 
 // src/index.ts
-var __dirname5 = dirname5(fileURLToPath5(import.meta.url));
-var packageJson = JSON.parse(readFileSync5(join6(__dirname5, "..", "package.json"), "utf-8"));
+var __dirname6 = dirname6(fileURLToPath6(import.meta.url));
+var packageJson = JSON.parse(readFileSync6(join7(__dirname6, "..", "package.json"), "utf-8"));
 var PACKAGE_VERSION = packageJson.version;
-var TEMPLATE_DIR = join6(__dirname5, "..", "template");
+var TEMPLATE_DIR = join7(__dirname6, "..", "template");
 function showHelp() {
   console.log(`
 ${pc.bold("create-mercato-app")} - Create a new Open Mercato application
@@ -692,6 +816,7 @@ ${pc.bold("Arguments:")}
 ${pc.bold("Options:")}
   --app <name>       Bootstrap an official ready app from open-mercato/ready-app-<name>
   --app-url <url>    Bootstrap a ready app from a GitHub repository URL
+  --preset <id>      Starter preset: classic (default), empty, or crm
   --skip-agentic-setup  Skip the interactive agentic setup wizard
   --registry <url>   Custom npm registry URL
   --verdaccio        Use local Verdaccio registry (http://localhost:4873)
@@ -700,6 +825,8 @@ ${pc.bold("Options:")}
 
 ${pc.bold("Examples:")}
   npx create-mercato-app my-store
+  npx create-mercato-app my-store --preset empty
+  npx create-mercato-app my-store --preset crm
   npx create-mercato-app my-prm --app prm
   npx create-mercato-app my-marketplace --app-url https://github.com/some-agency/ready-app-marketplace
   npx create-mercato-app my-store --verdaccio
@@ -720,6 +847,7 @@ function parseArgs(args) {
   const options = {
     app: void 0,
     appUrl: void 0,
+    preset: void 0,
     registry: void 0,
     skipAgenticSetup: false,
     verdaccio: false,
@@ -746,6 +874,9 @@ function parseArgs(args) {
     } else if (arg === "--app-url") {
       options.appUrl = requireOptionValue(args, index, arg);
       index += 1;
+    } else if (arg === "--preset") {
+      options.preset = requireOptionValue(args, index, arg);
+      index += 1;
     } else if (!arg.startsWith("-")) {
       appName = arg;
     }
@@ -785,32 +916,32 @@ function copyDirRecursive(src, dest, placeholders) {
   }
   const entries = readdirSync3(src);
   for (const entry of entries) {
-    const srcPath = join6(src, entry);
+    const srcPath = join7(src, entry);
     const destName = FILE_RENAMES[entry] ?? entry;
-    let destPath = join6(dest, destName);
+    let destPath = join7(dest, destName);
     const stat = statSync2(srcPath);
     if (stat.isDirectory()) {
       if (SKIP_DIRS.has(entry)) continue;
       copyDirRecursive(srcPath, destPath, placeholders);
     } else if (entry.endsWith(".template")) {
       const finalName = entry.replace(".template", "");
-      destPath = join6(dest, finalName);
-      let content = readFileSync5(srcPath, "utf-8");
+      destPath = join7(dest, finalName);
+      let content = readFileSync6(srcPath, "utf-8");
       for (const [key, value] of Object.entries(placeholders)) {
         content = content.replace(new RegExp(`\\{\\{${key}\\}\\}`, "g"), value);
       }
-      writeFileSync6(destPath, content);
+      writeFileSync7(destPath, content);
     } else {
       copyFileSync5(srcPath, destPath);
     }
   }
 }
 function ensureGeneratedCssPlaceholder(targetDir) {
-  const generatedDir = join6(targetDir, ".mercato", "generated");
-  const placeholderPath = join6(generatedDir, "module-package-sources.css");
+  const generatedDir = join7(targetDir, ".mercato", "generated");
+  const placeholderPath = join7(generatedDir, "module-package-sources.css");
   mkdirSync6(generatedDir, { recursive: true });
   if (!existsSync6(placeholderPath)) {
-    writeFileSync6(placeholderPath, "");
+    writeFileSync7(placeholderPath, "");
   }
 }
 async function scaffoldTemplateApp(targetDir, placeholders) {
@@ -910,6 +1041,15 @@ async function main(argv = process.argv.slice(2)) {
     throw new Error(`Directory "${appName}" already exists`);
   }
   const readyAppSource = resolveReadyAppSource(options, PACKAGE_VERSION);
+  const presetId = options.preset ?? DEFAULT_PRESET_ID;
+  if (!VALID_PRESET_IDS.includes(presetId)) {
+    throw new Error(`Unknown preset "${presetId}". Valid presets: ${VALID_PRESET_IDS.join(", ")}`);
+  }
+  if (presetId !== DEFAULT_PRESET_ID && readyAppSource) {
+    throw new Error(
+      `--preset ${presetId} cannot be combined with --app or --app-url. Presets apply only to the built-in template.`
+    );
+  }
   const registryConfig = options.verdaccio ? buildRegistryConfig("http://localhost:4873") : options.registry ? buildRegistryConfig(options.registry) : "";
   console.log("");
   console.log(pc.bold(`Creating a new Open Mercato app in ${pc.cyan(targetDir)}`));
@@ -925,6 +1065,7 @@ async function main(argv = process.argv.slice(2)) {
     await scaffoldImportedReadyApp(targetDir, readyAppSource);
   } else {
     await scaffoldTemplateApp(targetDir, placeholders);
+    applyStarterPreset(presetId, targetDir);
   }
   console.log(pc.green("Success!") + ` Created ${pc.bold(appName)}`);
   console.log("");
@@ -937,7 +1078,7 @@ async function main(argv = process.argv.slice(2)) {
   console.log(pc.dim("For more information, visit https://github.com/open-mercato/open-mercato"));
   console.log("");
 }
-var isEntrypoint = process.argv[1] !== void 0 && resolve(process.argv[1]) === fileURLToPath5(import.meta.url);
+var isEntrypoint = process.argv[1] !== void 0 && resolve(process.argv[1]) === fileURLToPath6(import.meta.url);
 if (isEntrypoint) {
   main().catch((error) => {
     const message = error instanceof Error ? error.message : String(error);

package/dist/lib/templates/modules-ts.template

@@ -0,0 +1,29 @@
+// Central place to enable modules and their source.
+// - id: module id (plural snake_case; special cases: 'auth')
+// - from: '@open-mercato/core' | '@app' | custom alias/path in future
+import { parseBooleanWithDefault } from '@open-mercato/shared/lib/boolean'
+
+export type ModuleEntry = { id: string; from?: '@open-mercato/core' | '@app' | string }
+
+export const enabledModules: ModuleEntry[] = [
+{{MODULES}}
+]
+
+const enterpriseModulesEnabled = parseBooleanWithDefault(process.env.OM_ENABLE_ENTERPRISE_MODULES, false)
+const enterpriseSsoEnabled = parseBooleanWithDefault(process.env.OM_ENABLE_ENTERPRISE_MODULES_SSO, false)
+const enterpriseSecurityEnabled = parseBooleanWithDefault(process.env.OM_ENABLE_ENTERPRISE_MODULES_SECURITY, false)
+
+if (enterpriseModulesEnabled) {
+  enabledModules.push(
+    { id: 'record_locks', from: '@open-mercato/enterprise' },
+    { id: 'system_status_overlays', from: '@open-mercato/enterprise' },
+  )
+}
+
+if (enterpriseModulesEnabled && enterpriseSsoEnabled) {
+  enabledModules.push({ id: 'sso', from: '@open-mercato/enterprise' })
+}
+
+if (enterpriseModulesEnabled && enterpriseSecurityEnabled) {
+  enabledModules.push({ id: 'security', from: '@open-mercato/enterprise' })
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-mercato-app",
-  "version": "0.5.1-develop.2691.d8a0934b37",
+  "version": "0.5.1-develop.2699.f8b50c8046",
   "type": "module",
   "description": "Create a new Open Mercato application",
   "main": "./dist/index.js",

package/template/src/app/page.tsx

@@ -11,6 +11,8 @@ import Link from 'next/link'
 import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import type { EntityManager } from '@mikro-orm/postgresql'
+import { User } from '@open-mercato/core/modules/auth/data/entities'
+import { Tenant, Organization } from '@open-mercato/core/modules/directory/data/entities'
 
 function FeatureBadge({ label }: { label: string }) {
   return (
@@ -60,9 +62,9 @@ export default async function Home() {
   try {
     const container = await createRequestContainer()
     const em = container.resolve<EntityManager>('em')
-    usersCount = await em.count('User', {})
-    tenantsCount = await em.count('Tenant', {})
-    orgsCount = await em.count('Organization', {})
+    usersCount = await em.count(User, {})
+    tenantsCount = await em.count(Tenant, {})
+    orgsCount = await em.count(Organization, {})
     dbStatus = t('app.page.dbStatus.connected', 'Connected')
   } catch (error: unknown) {
     const message = error instanceof Error ? error.message : t('app.page.dbStatus.noConnection', 'no connection')

package/template/src/modules/example/api/todos/route.ts

@@ -191,25 +191,32 @@ export const { metadata, GET, POST, PUT, DELETE } = makeCrudRoute({
           .map((d: any) => d.key)
         // Fallback discovery: keys that have values even if no definition exists
         try {
-          const knex = (em as any).getConnection().getKnex()
-          const rows = await knex('custom_field_values')
-            .distinct('field_key')
-            .where({ entity_id: ENTITY_ID as any })
-            .modify((qb: any) => {
-              if (scopedOrgIds === null) {
-                // no organization restriction
-              } else if (scopedOrgIds.length > 0) {
-                qb.andWhere((b: any) => {
-                  b.whereIn('organization_id', scopedOrgIds as any)
-                  b.orWhereNull('organization_id')
-                })
-              } else {
-                qb.whereNull('organization_id')
-              }
-              if (ctx.auth!.tenantId != null) qb.andWhere((b: any) => b.where({ tenant_id: ctx.auth!.tenantId }).orWhereNull('tenant_id'))
-              else qb.whereNull('tenant_id')
-            })
-            .whereNull('deleted_at')
+          const db = (em as any).getKysely()
+          let cfvQuery = db
+            .selectFrom('custom_field_values')
+            .select('field_key')
+            .distinct()
+            .where('entity_id', '=', ENTITY_ID as any)
+            .where('deleted_at', 'is', null)
+          if (scopedOrgIds === null) {
+            // no organization restriction
+          } else if (scopedOrgIds.length > 0) {
+            cfvQuery = cfvQuery.where((eb: any) => eb.or([
+              eb('organization_id', 'in', scopedOrgIds),
+              eb('organization_id', 'is', null),
+            ]))
+          } else {
+            cfvQuery = cfvQuery.where('organization_id', 'is', null)
+          }
+          if (ctx.auth!.tenantId != null) {
+            cfvQuery = cfvQuery.where((eb: any) => eb.or([
+              eb('tenant_id', '=', ctx.auth!.tenantId),
+              eb('tenant_id', 'is', null),
+            ]))
+          } else {
+            cfvQuery = cfvQuery.where('tenant_id', 'is', null)
+          }
+          const rows = await cfvQuery.execute()
           const keysFromValues = (rows || []).map((r: any) => String(r.field_key))
           // Merge with code-declared keys and de-dupe
           dynamicCfKeys = Array.from(new Set([ ...cfSel.keys, ...keysFromDefs, ...keysFromValues ]))

package/template/src/modules/example/commands/todos.ts

@@ -407,7 +407,7 @@ const deleteTodoCommand: CommandHandler<{ body?: Record<string, unknown>; query?
       restored.isDone = before.is_done
       restored.tenantId = before.tenantId ?? scope.tenantId
       restored.organizationId = before.organizationId ?? scope.organizationId
-      await em.persistAndFlush(restored)
+      await em.persist(restored).flush()
     } else {
       restored = await de.createOrmEntity({
         entity: Todo,

package/template/src/modules/example/data/entities.ts

@@ -1,4 +1,4 @@
-import { Entity, PrimaryKey, Property } from '@mikro-orm/core'
+import { Entity, PrimaryKey, Property } from '@mikro-orm/decorators/legacy'
 
 @Entity({ tableName: 'example_items' })
 export class ExampleItem {

package/template/src/modules/example_customers_sync/api/example-customers-sync/mappings/route.ts

@@ -1,6 +1,7 @@
 import { NextResponse } from 'next/server'
 import { z } from 'zod'
 import type { EntityManager } from '@mikro-orm/postgresql'
+import { type Kysely } from 'kysely'
 import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
 import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
 import { findWithDecryption } from '@open-mercato/shared/lib/encryption/find'
@@ -82,9 +83,10 @@ export async function GET(request: Request) {
         : []
 
     const em = (container.resolve('em') as EntityManager).fork()
-    const knex = em.getKnex()
-    const rowsQuery = knex('example_customer_interaction_mappings')
-      .select<MappingRow[]>([
+    const db = (em as any).getKysely() as Kysely<any>
+    let rowsQuery = db
+      .selectFrom('example_customer_interaction_mappings')
+      .select([
         'id',
         'interaction_id',
         'todo_id',
@@ -97,29 +99,32 @@ export async function GET(request: Request) {
         'organization_id',
         'tenant_id',
       ])
-      .where('tenant_id', auth.tenantId)
+      .where('tenant_id', '=', auth.tenantId)
       .orderBy('updated_at', 'desc')
       .orderBy('id', 'desc')
       .limit(query.limit + 1)
 
     if (organizationIds.length > 0) {
-      rowsQuery.whereIn('organization_id', organizationIds)
+      rowsQuery = rowsQuery.where('organization_id', 'in', organizationIds)
     }
     if (query.interactionId) {
-      rowsQuery.andWhere('interaction_id', query.interactionId)
+      rowsQuery = rowsQuery.where('interaction_id', '=', query.interactionId)
     }
     if (query.todoId) {
-      rowsQuery.andWhere('todo_id', query.todoId)
+      rowsQuery = rowsQuery.where('todo_id', '=', query.todoId)
     }
     if (cursor) {
-      rowsQuery.andWhere(function applyCursor() {
-        this.where('updated_at', '<', new Date(cursor.updatedAt)).orWhere(function applyTieBreaker() {
-          this.where('updated_at', new Date(cursor.updatedAt)).andWhere('id', '<', cursor.id)
-        })
-      })
+      const cursorDate = new Date(cursor.updatedAt)
+      rowsQuery = rowsQuery.where(eb => eb.or([
+        eb('updated_at', '<', cursorDate),
+        eb.and([
+          eb('updated_at', '=', cursorDate),
+          eb('id', '<', cursor.id),
+        ]),
+      ]))
     }
 
-    const rows = await rowsQuery
+    const rows = (await rowsQuery.execute()) as MappingRow[]
     const pageRows = rows.slice(0, query.limit)
     const interactionIds = Array.from(new Set(pageRows.map((row) => row.interaction_id)))
     const interactions = interactionIds.length > 0

package/template/src/modules/example_customers_sync/data/entities.ts

@@ -1,4 +1,4 @@
-import { Entity, Index, PrimaryKey, Property, Unique } from '@mikro-orm/core'
+import { Entity, Index, PrimaryKey, Property, Unique } from '@mikro-orm/decorators/legacy'
 
 @Entity({ tableName: 'example_customer_interaction_mappings' })
 @Unique({

package/template/src/modules/example_customers_sync/lib/mappings.ts

@@ -247,6 +247,6 @@ export async function deleteExampleCustomerInteractionMapping(
   mapping: ExampleCustomerInteractionMapping | null | undefined,
 ): Promise<boolean> {
   if (!mapping) return false
-  await em.removeAndFlush(mapping)
+  await em.remove(mapping).flush()
   return true
 }

package/template/src/modules/example_customers_sync/lib/sync.ts

@@ -1,4 +1,5 @@
 import type { EntityManager } from '@mikro-orm/postgresql'
+import { type Kysely } from 'kysely'
 import type { CommandBus } from '@open-mercato/shared/lib/commands'
 import { loadCustomFieldSnapshot } from '@open-mercato/shared/lib/commands/customFieldSnapshots'
 import { CrudHttpError } from '@open-mercato/shared/lib/crud/errors'
@@ -720,34 +721,36 @@ async function loadLegacyExampleTodoLinks(
   cursor?: string,
 ): Promise<{ rows: LegacyExampleTodoLinkRow[]; nextCursor?: string }> {
   const em = (container.resolve('em') as EntityManager).fork()
-  const knex = em.getKnex()
+  const db = (em as any).getKysely() as Kysely<any>
   const parsedCursor = decodeCursor(cursor)
-  const query = knex('customer_todo_links')
-    .select<LegacyExampleTodoLinkRow[]>([
+  let query = db
+    .selectFrom('customer_todo_links')
+    .select([
       'id',
       'entity_id as entityId',
       'todo_id as todoId',
       'created_by_user_id as createdByUserId',
       'created_at as createdAt',
     ])
-    .where({
-      tenant_id: scope.tenantId,
-      organization_id: scope.organizationId,
-      todo_source: 'example:todo',
-    })
+    .where('tenant_id', '=', scope.tenantId)
+    .where('organization_id', '=', scope.organizationId)
+    .where('todo_source', '=', 'example:todo')
     .orderBy('created_at', 'asc')
     .orderBy('id', 'asc')
     .limit(limit + 1)
 
   if (parsedCursor) {
-    query.andWhere(function applyCursor() {
-      this.where('created_at', '>', new Date(parsedCursor.createdAt)).orWhere(function applyTieBreaker() {
-        this.where('created_at', new Date(parsedCursor.createdAt)).andWhere('id', '>', parsedCursor.id)
-      })
-    })
+    const cursorDate = new Date(parsedCursor.createdAt)
+    query = query.where(eb => eb.or([
+      eb('created_at', '>', cursorDate),
+      eb.and([
+        eb('created_at', '=', cursorDate),
+        eb('id', '>', parsedCursor.id),
+      ]),
+    ]))
   }
 
-  const rows = await query
+  const rows = (await query.execute()) as LegacyExampleTodoLinkRow[]
   const pageRows = rows.slice(0, limit)
   const next = rows.length > limit ? pageRows[pageRows.length - 1] : null
   return {