@open-mercato/cli 0.6.7 → 0.6.8-develop.6875.1.871a4afc94

package/dist/bin.js

@@ -1,5 +1,8 @@
 #!/usr/bin/env node
-import { run } from "./mercato.js";
+import {
+  getTelemetryRuntime,
+  isTelemetryBackendEnabled
+} from "@open-mercato/shared/lib/telemetry/runtime";
 const BOOTSTRAP_FREE_COMMANDS = [
   "generate",
   "module",
@@ -7,6 +10,7 @@ const BOOTSTRAP_FREE_COMMANDS = [
   "db",
   "init",
   "agentic:init",
+  "telemetry",
   "eject",
   "test",
   "test:integration",
@@ -62,6 +66,12 @@ async function main() {
   assertNode24Runtime();
   const requiresBootstrap = needsBootstrap(process.argv);
   if (requiresBootstrap) {
+    const { loadAppEnv } = await import("./lib/load-env.js");
+    await loadAppEnv();
+    if (isTelemetryBackendEnabled()) {
+      const { initTelemetry } = await import("@open-mercato/telemetry");
+      await initTelemetry();
+    }
     const bootstrapSucceeded = await tryBootstrap();
     if (!bootstrapSucceeded) {
       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");
@@ -76,7 +86,9 @@ async function main() {
       process.exit(1);
     }
   }
+  const { run } = await import("./mercato.js");
   const code = await run(process.argv);
+  await getTelemetryRuntime()?.shutdown();
   process.exit(code ?? 0);
 }
 main().catch((error) => {

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 { run } from './mercato.js'\n\n// Commands that can run without bootstrap (without generated files)\n// - generate: creates the generated files\n// - db: uses resolver directly to find modules and migrations\n// - init: runs yarn commands to set up the app\n// - help: just shows help text\nconst BOOTSTRAP_FREE_COMMANDS = [\n  'generate',\n  'module',\n  'deploy',\n  'db',\n  'init',\n  'agentic:init',\n  'eject',\n  'test',\n  'test:integration',\n  'test:integration:coverage',\n  'test:integration:spec-coverage',\n  'test:ephemeral',\n  'test:integration:interactive',\n  'umes:list',\n  'umes:inspect',\n  'umes:check',\n  'help',\n  '--help',\n  '-h',\n]\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\nfunction needsBootstrap(argv: string[]): boolean {\n  const [, , first] = argv\n  if (!first) return false // help screen\n  return !BOOTSTRAP_FREE_COMMANDS.includes(first)\n}\n\nasync function tryBootstrap(): Promise<boolean> {\n  try {\n    const { bootstrapFromAppRoot } = await import('@open-mercato/shared/lib/bootstrap/dynamicLoader')\n    const { registerCliModules } = await import('./mercato.js')\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    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('Cannot find module') &&\n      (message.includes('/generated/') || message.includes('.generated') || message.includes('.mercato'))\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 requiresBootstrap = needsBootstrap(process.argv)\n\n  if (requiresBootstrap) {\n    const bootstrapSucceeded = await tryBootstrap()\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  const code = await run(process.argv)\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,WAAW;AAOpB,MAAM,0BAA0B;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,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,SAAS,eAAe,MAAyB;AAC/C,QAAM,CAAC,EAAE,EAAE,KAAK,IAAI;AACpB,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,CAAC,wBAAwB,SAAS,KAAK;AAChD;AAEA,eAAe,eAAiC;AAC9C,MAAI;AACF,UAAM,EAAE,qBAAqB,IAAI,MAAM,OAAO,kDAAkD;AAChG,UAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,cAAc;AAE1D,UAAM,EAAE,eAAe,IAAI,MAAM,OAAO,mBAAmB;AAC3D,UAAM,WAAW,eAAe;AAChC,UAAM,SAAS,SAAS,UAAU;AAClC,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,oBAAoB,MACpC,QAAQ,SAAS,aAAa,KAAK,QAAQ,SAAS,YAAY,KAAK,QAAQ,SAAS,UAAU,IACjG;AACA,aAAO;AAAA,IACT;AAEA,UAAM;AAAA,EACR;AACF;AAEA,eAAe,OAAsB;AACnC,sBAAoB;AACpB,QAAM,oBAAoB,eAAe,QAAQ,IAAI;AAErD,MAAI,mBAAmB;AACrB,UAAM,qBAAqB,MAAM,aAAa;AAC9C,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;AAEA,QAAM,OAAO,MAAM,IAAI,QAAQ,IAAI;AACnC,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 {\n  getTelemetryRuntime,\n  isTelemetryBackendEnabled,\n} from '@open-mercato/shared/lib/telemetry/runtime'\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\n// Commands that can run without bootstrap (without generated files)\n// - generate: creates the generated files\n// - db: uses resolver directly to find modules and migrations\n// - init: runs yarn commands to set up the app\n// - help: just shows help text\nconst BOOTSTRAP_FREE_COMMANDS = [\n  'generate',\n  'module',\n  'deploy',\n  'db',\n  'init',\n  'agentic:init',\n  'telemetry',\n  'eject',\n  'test',\n  'test:integration',\n  'test:integration:coverage',\n  'test:integration:spec-coverage',\n  'test:ephemeral',\n  'test:integration:interactive',\n  'umes:list',\n  'umes:inspect',\n  'umes:check',\n  'help',\n  '--help',\n  '-h',\n]\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\nfunction needsBootstrap(argv: string[]): boolean {\n  const [, , first] = argv\n  if (!first) return false // help screen\n  return !BOOTSTRAP_FREE_COMMANDS.includes(first)\n}\n\nasync function tryBootstrap(): Promise<boolean> {\n  try {\n    const { bootstrapFromAppRoot } = await import('@open-mercato/shared/lib/bootstrap/dynamicLoader')\n    const { registerCliModules } = await import('./mercato.js')\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    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('Cannot find module') &&\n      (message.includes('/generated/') || message.includes('.generated') || message.includes('.mercato'))\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 requiresBootstrap = needsBootstrap(process.argv)\n\n  if (requiresBootstrap) {\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()\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 spans/logs for commands that return (workers block forever and flush via\n  // their own shutdown handler instead).\n  await getTelemetryRuntime()?.shutdown()\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;AAAA,EACE;AAAA,EACA;AAAA,OACK;AASP,MAAM,0BAA0B;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,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,SAAS,eAAe,MAAyB;AAC/C,QAAM,CAAC,EAAE,EAAE,KAAK,IAAI;AACpB,MAAI,CAAC,MAAO,QAAO;AACnB,SAAO,CAAC,wBAAwB,SAAS,KAAK;AAChD;AAEA,eAAe,eAAiC;AAC9C,MAAI;AACF,UAAM,EAAE,qBAAqB,IAAI,MAAM,OAAO,kDAAkD;AAChG,UAAM,EAAE,mBAAmB,IAAI,MAAM,OAAO,cAAc;AAE1D,UAAM,EAAE,eAAe,IAAI,MAAM,OAAO,mBAAmB;AAC3D,UAAM,WAAW,eAAe;AAChC,UAAM,SAAS,SAAS,UAAU;AAClC,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,oBAAoB,MACpC,QAAQ,SAAS,aAAa,KAAK,QAAQ,SAAS,YAAY,KAAK,QAAQ,SAAS,UAAU,IACjG;AACA,aAAO;AAAA,IACT;AAEA,UAAM;AAAA,EACR;AACF;AAEA,eAAe,OAAsB;AACnC,sBAAoB;AACpB,QAAM,oBAAoB,eAAe,QAAQ,IAAI;AAErD,MAAI,mBAAmB;AAMrB,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;AAC9C,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,oBAAoB,GAAG,SAAS;AACtC,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/lib/__integration__/TC-INT-008.spec.js

@@ -13,11 +13,13 @@ const cliIntegrationRunnerPath = path.join(cliDir, "src", "lib", "testing", "int
 const standaloneTemplatePackageJsonPath = path.join(repoRoot, "packages", "create-app", "template", "package.json.template");
 const agenticRoot = path.join(repoRoot, "packages", "create-app", "agentic");
 const packagesRoot = path.join(repoRoot, "packages");
+const coreVersion = JSON.parse(fs.readFileSync(path.join(packagesRoot, "core", "package.json"), "utf8")).version;
+const UNROUTED_PACKAGE_GUIDES = /* @__PURE__ */ new Set(["cache", "core", "events", "queue", "search", "shared", "ui"]);
 const FIXTURE_ENABLED_MODULES = ["customers", "sales"];
 function normalizePath(value) {
   return value.split(path.sep).join("/");
 }
-function runCommand(command, args, cwd) {
+function runCommand(command, args, cwd, env = {}) {
   return execFileSync(command, args, {
     cwd,
     encoding: "utf8",
@@ -28,7 +30,8 @@ function runCommand(command, args, cwd) {
       // Keep the test hermetic: agentic:init runs scripts/install-skills.sh,
       // whose external step (`npx skills add`) needs the network. Local tier
       // symlinks are still installed.
-      OM_SKIP_EXTERNAL_SKILLS: "1"
+      OM_SKIP_EXTERNAL_SKILLS: "1",
+      ...env
     }
   });
 }
@@ -49,19 +52,49 @@ function createStandaloneFixture(rootDir) {
     JSON.stringify(
       {
         name: "sample-store",
-        private: true
+        private: true,
+        dependencies: { "@open-mercato/core": coreVersion }
       },
       null,
       2
     )
   );
-  const moduleEntries = FIXTURE_ENABLED_MODULES.map((moduleId) => `  { id: '${moduleId}' },`).join("\n");
+  const moduleEntries = FIXTURE_ENABLED_MODULES.map((moduleId) => `  { id: '${moduleId}', from: '@open-mercato/core' },`).join("\n");
   writeFile(path.join(appDir, "src", "modules.ts"), `export const enabledModules = [
 ${moduleEntries}
 ]
 `);
   return appDir;
 }
+function installFakeFrameworkPackage(appDir) {
+  const packageRoot = path.join(appDir, "node_modules", "@open-mercato", "core");
+  writeFile(path.join(packageRoot, "package.json"), JSON.stringify({
+    name: "@open-mercato/core",
+    version: coreVersion,
+    type: "module",
+    exports: { ".": "./dist/index.js" }
+  }));
+  writeFile(path.join(packageRoot, "dist", "index.js"), "export {}\n");
+  writeFile(path.join(packageRoot, "AGENTS.md"), "# Installed core instructions\n");
+  for (const moduleId of FIXTURE_ENABLED_MODULES) {
+    writeFile(path.join(packageRoot, "src", "modules", moduleId, "AGENTS.md"), `# Installed ${moduleId} instructions
+`);
+    writeFile(
+      path.join(packageRoot, "src", "modules", moduleId, "data", "entities.ts"),
+      `export class ${moduleId === "customers" ? "Person" : "Sale"} {}
+`
+    );
+  }
+  return packageRoot;
+}
+function snapshotTextFiles(rootDir) {
+  return Object.fromEntries(
+    listRelativeFiles(rootDir).map((relativePath) => [
+      relativePath,
+      fs.readFileSync(path.join(rootDir, relativePath), "utf8")
+    ])
+  );
+}
 function listRelativeFiles(rootDir) {
   if (!fs.existsSync(rootDir)) {
     return [];
@@ -161,7 +194,7 @@ function expectedGuideOutputNames() {
   }
   for (const packageName of fs.readdirSync(packagesRoot)) {
     const packageGuide = path.join(packagesRoot, packageName, "agentic", "standalone-guide.md");
-    if (fs.existsSync(packageGuide)) {
+    if (fs.existsSync(packageGuide) && !UNROUTED_PACKAGE_GUIDES.has(packageName)) {
       collected.add(`${packageName}.md`);
     }
     const modulesRoot = path.join(packagesRoot, packageName, "src", "modules");
@@ -176,6 +209,10 @@ function expectedGuideOutputNames() {
     }
   }
   collected.add("module-facts.json");
+  collected.add("framework-extension-points.md");
+  collected.add("upstream/AGENTS.md");
+  collected.add("upstream/BACKWARD_COMPATIBILITY.md");
+  collected.add("upstream/manifest.json");
   for (const moduleId of FIXTURE_ENABLED_MODULES) {
     collected.add(normalizePath(path.join("modules", `${moduleId}.md`)));
   }
@@ -210,11 +247,14 @@ test.describe("TC-INT-008: CLI agentic init mirrors standalone scaffolding asset
       expect(generatedGuideNames).toEqual(expectedGuideOutputNames());
       const agentsSource = fs.readFileSync(path.join(appDir, "AGENTS.md"), "utf8");
       expect(agentsSource).toContain("<!-- CODEX_ENFORCEMENT_RULES_START -->");
-      expect(agentsSource).toContain(".ai/guides/core.md");
+      expect(agentsSource).toContain(".ai/guides/upstream/BACKWARD_COMPATIBILITY.md");
       for (const moduleId of FIXTURE_ENABLED_MODULES) {
-        expect(agentsSource).toContain(`.ai/guides/modules/${moduleId}.md`);
+        expect(agentsSource).toContain(`\`${moduleId}\``);
       }
-      expect(agentsSource).not.toContain(".ai/guides/modules/auth.md");
+      expect(agentsSource).toContain("`.ai/guides/modules/<id>.md`");
+      expect(agentsSource.match(/\.ai\/guides\/modules\//g)).toHaveLength(1);
+      expect(agentsSource).not.toContain("`auth`");
+      expect(agentsSource).not.toContain("Core CRM capabilities");
       const specsReadmeSource = fs.readFileSync(path.join(appDir, ".ai", "specs", "README.md"), "utf8");
       expect(specsReadmeSource).toContain("sample-store");
       const cursorRulesSource = fs.readFileSync(path.join(appDir, ".cursor", "rules", "open-mercato.mdc"), "utf8");
@@ -240,5 +280,45 @@ test.describe("TC-INT-008: CLI agentic init mirrors standalone scaffolding asset
       fs.rmSync(tempRoot, { recursive: true, force: true });
     }
   });
+  test("emits a runnable exact-version framework context escape hatch for an installed package", () => {
+    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "mercato-cli-framework-context-"));
+    try {
+      const appDir = createStandaloneFixture(tempRoot);
+      const packageRoot = installFakeFrameworkPackage(appDir);
+      const resolvedPackageRoot = fs.realpathSync(packageRoot);
+      const packageBefore = snapshotTextFiles(packageRoot);
+      runMercato(["agentic:init", "--tool=codex"], appDir);
+      const generatedScript = path.join(appDir, "scripts", "framework-context.mjs");
+      expect(fs.existsSync(generatedScript)).toBe(true);
+      const output = runCommand(
+        process.execPath,
+        [generatedScript, "--module", "customers", "--query", "Person", "--json"],
+        appDir,
+        // The generated standalone helper must not depend on a globally
+        // installed ripgrep binary; process.execPath is already absolute.
+        { PATH: "", Path: "" }
+      );
+      const context = JSON.parse(output);
+      expect(context.module).toBe("customers");
+      expect(context.package).toEqual({ name: "@open-mercato/core", version: coreVersion, root: resolvedPackageRoot });
+      expect(context.sourceKind).toBe("source");
+      expect(normalizePath(context.sourceRoot)).toBe(normalizePath(path.join(resolvedPackageRoot, "src", "modules", "customers")));
+      expect(context.instructions.filter((entry) => entry.path).map((entry) => entry.kind)).toEqual([
+        "standalone-root",
+        "upstream-bc",
+        "package",
+        "module-1",
+        "upstream-root"
+      ]);
+      expect(context.instructions.filter((entry) => entry.path).every((entry) => entry.materializedPath)).toBe(true);
+      expect(context.boundedSearch).toMatchObject({ status: "matched", matches: 1, maxMatches: 200 });
+      expect(fs.existsSync(path.join(appDir, context.materializedSource))).toBe(true);
+      expect(fs.existsSync(path.join(appDir, context.boundedSearch.result))).toBe(true);
+      expect(context.warnings.some((warning) => warning.includes("Generated facts for customers are stale"))).toBe(false);
+      expect(snapshotTextFiles(packageRoot)).toEqual(packageBefore);
+    } finally {
+      fs.rmSync(tempRoot, { recursive: true, force: true });
+    }
+  });
 });
 //# sourceMappingURL=TC-INT-008.spec.js.map

package/dist/lib/__integration__/TC-INT-008.spec.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/lib/__integration__/TC-INT-008.spec.ts"],
-  "sourcesContent": ["import { expect, test } from '@playwright/test'\nimport { execFileSync } from 'node:child_process'\nimport fs from 'node:fs'\nimport os from 'node:os'\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url))\nconst repoRoot = path.resolve(__dirname, '..', '..', '..', '..', '..')\nconst cliDir = path.join(repoRoot, 'packages', 'cli')\nconst cliBin = path.join(cliDir, 'dist', 'bin.js')\nconst cliBuildScript = path.join(cliDir, 'build.mjs')\nconst cliIntegrationRunnerPath = path.join(cliDir, 'src', 'lib', 'testing', 'integration.ts')\nconst standaloneTemplatePackageJsonPath = path.join(repoRoot, 'packages', 'create-app', 'template', 'package.json.template')\nconst agenticRoot = path.join(repoRoot, 'packages', 'create-app', 'agentic')\nconst packagesRoot = path.join(repoRoot, 'packages')\n\n// Modules the standalone fixture enables in src/modules.ts. Both are on the\n// fact-sheet allowlist, so agentic:init must ship exactly their fact-sheets\n// (enabled \u2229 allowlist \u2014 spec D6) and list them in the AGENTS.md marker block.\nconst FIXTURE_ENABLED_MODULES = ['customers', 'sales']\n\nfunction normalizePath(value: string): string {\n  return value.split(path.sep).join('/')\n}\n\nfunction runCommand(command: string, args: string[], cwd: string): string {\n  return execFileSync(command, args, {\n    cwd,\n    encoding: 'utf8',\n    env: {\n      ...process.env,\n      FORCE_COLOR: '0',\n      NODE_NO_WARNINGS: '1',\n      // Keep the test hermetic: agentic:init runs scripts/install-skills.sh,\n      // whose external step (`npx skills add`) needs the network. Local tier\n      // symlinks are still installed.\n      OM_SKIP_EXTERNAL_SKILLS: '1',\n    },\n  })\n}\n\nfunction runMercato(args: string[], cwd: string): string {\n  return runCommand(process.execPath, [cliBin, ...args], cwd)\n}\n\nfunction writeFile(filePath: string, content: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true })\n  fs.writeFileSync(filePath, content)\n}\n\nfunction ensureCliBuilt(): void {\n  runCommand(process.execPath, [cliBuildScript], cliDir)\n}\n\nfunction createStandaloneFixture(rootDir: string): string {\n  const appDir = path.join(rootDir, 'sample-store')\n  writeFile(\n    path.join(appDir, 'package.json'),\n    JSON.stringify(\n      {\n        name: 'sample-store',\n        private: true,\n      },\n      null,\n      2,\n    ),\n  )\n  const moduleEntries = FIXTURE_ENABLED_MODULES.map((moduleId) => `  { id: '${moduleId}' },`).join('\\n')\n  writeFile(path.join(appDir, 'src', 'modules.ts'), `export const enabledModules = [\\n${moduleEntries}\\n]\\n`)\n  return appDir\n}\n\nfunction listRelativeFiles(rootDir: string): string[] {\n  if (!fs.existsSync(rootDir)) {\n    return []\n  }\n\n  const collected: string[] = []\n  for (const entry of fs.readdirSync(rootDir, { withFileTypes: true })) {\n    const absolutePath = path.join(rootDir, entry.name)\n    if (entry.isDirectory()) {\n      for (const nestedPath of listRelativeFiles(absolutePath)) {\n        collected.push(path.join(entry.name, nestedPath))\n      }\n      continue\n    }\n    if (entry.isFile()) {\n      collected.push(entry.name)\n    }\n  }\n\n  return collected.map(normalizePath).sort()\n}\n\nfunction mapSharedSourceToOutput(relativePath: string): string {\n  if (relativePath === 'AGENTS.md.template') {\n    return 'AGENTS.md'\n  }\n\n  if (relativePath.startsWith('scripts/')) {\n    return relativePath\n  }\n\n  if (!relativePath.startsWith('ai/')) {\n    throw new Error(`Unexpected shared source path: ${relativePath}`)\n  }\n\n  return normalizePath(path.join('.ai', relativePath.slice('ai/'.length)))\n}\n\nfunction mapClaudeSourceToOutput(relativePath: string): string {\n  if (relativePath === 'CLAUDE.md.template') {\n    return 'CLAUDE.md'\n  }\n  if (relativePath === 'settings.json') {\n    return '.claude/settings.json'\n  }\n  if (relativePath === 'mcp.json.example') {\n    return '.mcp.json.example'\n  }\n  if (relativePath.startsWith('hooks/')) {\n    return normalizePath(path.join('.claude', relativePath))\n  }\n\n  throw new Error(`Unexpected Claude source path: ${relativePath}`)\n}\n\nfunction mapCursorSourceToOutput(relativePath: string): string {\n  if (relativePath === 'hooks.json') {\n    return '.cursor/hooks.json'\n  }\n  if (relativePath === 'mcp.json.example') {\n    return '.cursor/mcp.json.example'\n  }\n  if (relativePath.startsWith('hooks/') || relativePath.startsWith('rules/')) {\n    return normalizePath(path.join('.cursor', relativePath))\n  }\n\n  throw new Error(`Unexpected Cursor source path: ${relativePath}`)\n}\n\nfunction mapCodexSourceToOutput(relativePath: string): string | null {\n  if (relativePath === 'mcp.json.example') {\n    return '.codex/mcp.json.example'\n  }\n  if (relativePath === 'enforcement-rules.md') {\n    return null\n  }\n\n  throw new Error(`Unexpected Codex source path: ${relativePath}`)\n}\n\nfunction readPlaywrightConfigPathFromTemplate(): string {\n  const packageTemplate = JSON.parse(fs.readFileSync(standaloneTemplatePackageJsonPath, 'utf8')) as {\n    scripts?: Record<string, string>\n  }\n  const integrationScript = packageTemplate.scripts?.['test:integration']\n  if (!integrationScript) {\n    throw new Error('Standalone template is missing the test:integration script')\n  }\n\n  const configPathMatch = integrationScript.match(/--config\\s+([^\\s]+)/)\n  if (!configPathMatch?.[1]) {\n    throw new Error('Standalone template test:integration script is missing --config')\n  }\n\n  return normalizePath(configPathMatch[1])\n}\n\nfunction readPlaywrightConfigPathFromCliRunner(): string {\n  const integrationRunnerSource = fs.readFileSync(cliIntegrationRunnerPath, 'utf8')\n  const configPathMatch = integrationRunnerSource.match(/const PLAYWRIGHT_INTEGRATION_CONFIG_PATH = '([^']+)'/)\n  if (!configPathMatch?.[1]) {\n    throw new Error('CLI integration runner is missing PLAYWRIGHT_INTEGRATION_CONFIG_PATH')\n  }\n\n  return normalizePath(configPathMatch[1])\n}\n\nfunction expectedGuideOutputNames(): string[] {\n  const collected = new Set<string>()\n\n  // Static conceptual guides checked into create-app (e.g. module-system.md) are\n  // bundled into dist/agentic/guides by the CLI build and copied wholesale.\n  const staticGuidesRoot = path.join(agenticRoot, 'guides')\n  if (fs.existsSync(staticGuidesRoot)) {\n    for (const entry of fs.readdirSync(staticGuidesRoot, { withFileTypes: true })) {\n      if (entry.isFile() && entry.name.endsWith('.md')) {\n        collected.add(entry.name)\n      }\n    }\n  }\n\n  for (const packageName of fs.readdirSync(packagesRoot)) {\n    const packageGuide = path.join(packagesRoot, packageName, 'agentic', 'standalone-guide.md')\n    if (fs.existsSync(packageGuide)) {\n      collected.add(`${packageName}.md`)\n    }\n\n    const modulesRoot = path.join(packagesRoot, packageName, 'src', 'modules')\n    if (!fs.existsSync(modulesRoot)) {\n      continue\n    }\n\n    for (const moduleName of fs.readdirSync(modulesRoot)) {\n      const moduleGuide = path.join(modulesRoot, moduleName, 'agentic', 'standalone-guide.md')\n      if (fs.existsSync(moduleGuide)) {\n        collected.add(`${packageName}.${moduleName}.md`)\n      }\n    }\n  }\n\n  // Generated fact-sheet artifacts (spec 2026-06-27-ts-morph-module-fact-sheets):\n  // the module-facts.json sidecar is copied as-is and fact-sheets are filtered to the\n  // fixture's enabled modules. The legacy core.<module>.md redirect stubs are no longer\n  // emitted (#3754).\n  collected.add('module-facts.json')\n  for (const moduleId of FIXTURE_ENABLED_MODULES) {\n    collected.add(normalizePath(path.join('modules', `${moduleId}.md`)))\n  }\n\n  return Array.from(collected).sort()\n}\n\nfunction assertPathsExist(appDir: string, relativePaths: string[]): void {\n  const missingPaths = relativePaths.filter((relativePath) => !fs.existsSync(path.join(appDir, relativePath)))\n  expect(missingPaths).toEqual([])\n}\n\ntest.describe('TC-INT-008: CLI agentic init mirrors standalone scaffolding assets', () => {\n  test.beforeAll(() => {\n    ensureCliBuilt()\n  })\n\n  test('should run bootstrap-free and generate the shared, guide, and tool-specific agentic files', () => {\n    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mercato-cli-agentic-'))\n\n    try {\n      const appDir = createStandaloneFixture(tempRoot)\n      const standalonePlaywrightConfigPath = readPlaywrightConfigPathFromTemplate()\n      const cliPlaywrightConfigPath = readPlaywrightConfigPathFromCliRunner()\n      const commandOutput = runMercato(['agentic:init', '--tool=claude-code,codex,cursor'], appDir)\n\n      expect(cliPlaywrightConfigPath).toBe(standalonePlaywrightConfigPath)\n      expect(commandOutput).toContain('Agentic setup complete:')\n      expect(fs.existsSync(path.join(appDir, '.mercato', 'generated'))).toBe(false)\n\n      const sharedOutputs = listRelativeFiles(path.join(agenticRoot, 'shared')).map(mapSharedSourceToOutput)\n      const claudeOutputs = listRelativeFiles(path.join(agenticRoot, 'claude-code')).map(mapClaudeSourceToOutput)\n      const cursorOutputs = listRelativeFiles(path.join(agenticRoot, 'cursor')).map(mapCursorSourceToOutput)\n      const codexOutputs = listRelativeFiles(path.join(agenticRoot, 'codex'))\n        .map(mapCodexSourceToOutput)\n        .filter((relativePath): relativePath is string => relativePath !== null)\n\n      expect(sharedOutputs).toContain(standalonePlaywrightConfigPath)\n      assertPathsExist(appDir, [...sharedOutputs, ...claudeOutputs, ...cursorOutputs, ...codexOutputs])\n      expect(fs.existsSync(path.join(appDir, standalonePlaywrightConfigPath))).toBe(true)\n\n      const generatedGuideNames = listRelativeFiles(path.join(appDir, '.ai', 'guides'))\n      expect(generatedGuideNames).toEqual(expectedGuideOutputNames())\n\n      const agentsSource = fs.readFileSync(path.join(appDir, 'AGENTS.md'), 'utf8')\n      expect(agentsSource).toContain('<!-- CODEX_ENFORCEMENT_RULES_START -->')\n      expect(agentsSource).toContain('.ai/guides/core.md')\n\n      // The Module-Specific Guides marker block lists exactly the enabled modules'\n      // fact-sheets (enabled \u2229 allowlist), not the full bundled set.\n      for (const moduleId of FIXTURE_ENABLED_MODULES) {\n        expect(agentsSource).toContain(`.ai/guides/modules/${moduleId}.md`)\n      }\n      expect(agentsSource).not.toContain('.ai/guides/modules/auth.md')\n\n      const specsReadmeSource = fs.readFileSync(path.join(appDir, '.ai', 'specs', 'README.md'), 'utf8')\n      expect(specsReadmeSource).toContain('sample-store')\n\n      const cursorRulesSource = fs.readFileSync(path.join(appDir, '.cursor', 'rules', 'open-mercato.mdc'), 'utf8')\n      expect(cursorRulesSource).toContain('sample-store')\n\n      // om-spec-writing moved to the external open-mercato/skills collection\n      // (installed via `yarn install-skills`), so agentic:init must not ship a copy.\n      expect(fs.existsSync(path.join(appDir, '.ai', 'skills', 'om-spec-writing'))).toBe(false)\n      expect(fs.existsSync(path.join(appDir, 'scripts', 'install-skills.sh'))).toBe(true)\n\n      // install-skills.sh (run by agentic:init) installs every local tier skill once,\n      // into the canonical .agents/skills/. Codex and Cursor read that directory\n      // natively, so they get no skills directory of their own; Claude Code cannot,\n      // so it keeps a link layer pointing back at the canonical copy.\n      const tiersManifest = JSON.parse(\n        fs.readFileSync(path.join(agenticRoot, 'shared', 'ai', 'skills', 'tiers.json'), 'utf8'),\n      ) as { default: string[]; tiers: Record<string, { skills: string[] }> }\n      const defaultTierSkills = tiersManifest.default.flatMap((tierName) => tiersManifest.tiers[tierName].skills)\n      expect(defaultTierSkills.length).toBeGreaterThan(0)\n\n      for (const skillName of defaultTierSkills) {\n        const canonicalLinkPath = path.join(appDir, '.agents', 'skills', skillName)\n        expect(fs.lstatSync(canonicalLinkPath).isSymbolicLink()).toBe(true)\n        expect(normalizePath(fs.readlinkSync(canonicalLinkPath))).toBe(`../../.ai/skills/${skillName}`)\n\n        const claudeLinkPath = path.join(appDir, '.claude', 'skills', skillName)\n        expect(fs.lstatSync(claudeLinkPath).isSymbolicLink()).toBe(true)\n        expect(normalizePath(fs.readlinkSync(claudeLinkPath))).toBe(`../../.agents/skills/${skillName}`)\n      }\n\n      expect(fs.existsSync(path.join(appDir, '.codex', 'skills'))).toBe(false)\n      expect(fs.existsSync(path.join(appDir, '.cursor', 'skills'))).toBe(false)\n    } finally {\n      fs.rmSync(tempRoot, { recursive: true, force: true })\n    }\n  })\n})\n"],
-  "mappings": "AAAA,SAAS,QAAQ,YAAY;AAC7B,SAAS,oBAAoB;AAC7B,OAAO,QAAQ;AACf,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAE9B,MAAM,YAAY,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAC7D,MAAM,WAAW,KAAK,QAAQ,WAAW,MAAM,MAAM,MAAM,MAAM,IAAI;AACrE,MAAM,SAAS,KAAK,KAAK,UAAU,YAAY,KAAK;AACpD,MAAM,SAAS,KAAK,KAAK,QAAQ,QAAQ,QAAQ;AACjD,MAAM,iBAAiB,KAAK,KAAK,QAAQ,WAAW;AACpD,MAAM,2BAA2B,KAAK,KAAK,QAAQ,OAAO,OAAO,WAAW,gBAAgB;AAC5F,MAAM,oCAAoC,KAAK,KAAK,UAAU,YAAY,cAAc,YAAY,uBAAuB;AAC3H,MAAM,cAAc,KAAK,KAAK,UAAU,YAAY,cAAc,SAAS;AAC3E,MAAM,eAAe,KAAK,KAAK,UAAU,UAAU;AAKnD,MAAM,0BAA0B,CAAC,aAAa,OAAO;AAErD,SAAS,cAAc,OAAuB;AAC5C,SAAO,MAAM,MAAM,KAAK,GAAG,EAAE,KAAK,GAAG;AACvC;AAEA,SAAS,WAAW,SAAiB,MAAgB,KAAqB;AACxE,SAAO,aAAa,SAAS,MAAM;AAAA,IACjC;AAAA,IACA,UAAU;AAAA,IACV,KAAK;AAAA,MACH,GAAG,QAAQ;AAAA,MACX,aAAa;AAAA,MACb,kBAAkB;AAAA;AAAA;AAAA;AAAA,MAIlB,yBAAyB;AAAA,IAC3B;AAAA,EACF,CAAC;AACH;AAEA,SAAS,WAAW,MAAgB,KAAqB;AACvD,SAAO,WAAW,QAAQ,UAAU,CAAC,QAAQ,GAAG,IAAI,GAAG,GAAG;AAC5D;AAEA,SAAS,UAAU,UAAkB,SAAuB;AAC1D,KAAG,UAAU,KAAK,QAAQ,QAAQ,GAAG,EAAE,WAAW,KAAK,CAAC;AACxD,KAAG,cAAc,UAAU,OAAO;AACpC;AAEA,SAAS,iBAAuB;AAC9B,aAAW,QAAQ,UAAU,CAAC,cAAc,GAAG,MAAM;AACvD;AAEA,SAAS,wBAAwB,SAAyB;AACxD,QAAM,SAAS,KAAK,KAAK,SAAS,cAAc;AAChD;AAAA,IACE,KAAK,KAAK,QAAQ,cAAc;AAAA,IAChC,KAAK;AAAA,MACH;AAAA,QACE,MAAM;AAAA,QACN,SAAS;AAAA,MACX;AAAA,MACA;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACA,QAAM,gBAAgB,wBAAwB,IAAI,CAAC,aAAa,YAAY,QAAQ,MAAM,EAAE,KAAK,IAAI;AACrG,YAAU,KAAK,KAAK,QAAQ,OAAO,YAAY,GAAG;AAAA,EAAoC,aAAa;AAAA;AAAA,CAAO;AAC1G,SAAO;AACT;AAEA,SAAS,kBAAkB,SAA2B;AACpD,MAAI,CAAC,GAAG,WAAW,OAAO,GAAG;AAC3B,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,YAAsB,CAAC;AAC7B,aAAW,SAAS,GAAG,YAAY,SAAS,EAAE,eAAe,KAAK,CAAC,GAAG;AACpE,UAAM,eAAe,KAAK,KAAK,SAAS,MAAM,IAAI;AAClD,QAAI,MAAM,YAAY,GAAG;AACvB,iBAAW,cAAc,kBAAkB,YAAY,GAAG;AACxD,kBAAU,KAAK,KAAK,KAAK,MAAM,MAAM,UAAU,CAAC;AAAA,MAClD;AACA;AAAA,IACF;AACA,QAAI,MAAM,OAAO,GAAG;AAClB,gBAAU,KAAK,MAAM,IAAI;AAAA,IAC3B;AAAA,EACF;AAEA,SAAO,UAAU,IAAI,aAAa,EAAE,KAAK;AAC3C;AAEA,SAAS,wBAAwB,cAA8B;AAC7D,MAAI,iBAAiB,sBAAsB;AACzC,WAAO;AAAA,EACT;AAEA,MAAI,aAAa,WAAW,UAAU,GAAG;AACvC,WAAO;AAAA,EACT;AAEA,MAAI,CAAC,aAAa,WAAW,KAAK,GAAG;AACnC,UAAM,IAAI,MAAM,kCAAkC,YAAY,EAAE;AAAA,EAClE;AAEA,SAAO,cAAc,KAAK,KAAK,OAAO,aAAa,MAAM,MAAM,MAAM,CAAC,CAAC;AACzE;AAEA,SAAS,wBAAwB,cAA8B;AAC7D,MAAI,iBAAiB,sBAAsB;AACzC,WAAO;AAAA,EACT;AACA,MAAI,iBAAiB,iBAAiB;AACpC,WAAO;AAAA,EACT;AACA,MAAI,iBAAiB,oBAAoB;AACvC,WAAO;AAAA,EACT;AACA,MAAI,aAAa,WAAW,QAAQ,GAAG;AACrC,WAAO,cAAc,KAAK,KAAK,WAAW,YAAY,CAAC;AAAA,EACzD;AAEA,QAAM,IAAI,MAAM,kCAAkC,YAAY,EAAE;AAClE;AAEA,SAAS,wBAAwB,cAA8B;AAC7D,MAAI,iBAAiB,cAAc;AACjC,WAAO;AAAA,EACT;AACA,MAAI,iBAAiB,oBAAoB;AACvC,WAAO;AAAA,EACT;AACA,MAAI,aAAa,WAAW,QAAQ,KAAK,aAAa,WAAW,QAAQ,GAAG;AAC1E,WAAO,cAAc,KAAK,KAAK,WAAW,YAAY,CAAC;AAAA,EACzD;AAEA,QAAM,IAAI,MAAM,kCAAkC,YAAY,EAAE;AAClE;AAEA,SAAS,uBAAuB,cAAqC;AACnE,MAAI,iBAAiB,oBAAoB;AACvC,WAAO;AAAA,EACT;AACA,MAAI,iBAAiB,wBAAwB;AAC3C,WAAO;AAAA,EACT;AAEA,QAAM,IAAI,MAAM,iCAAiC,YAAY,EAAE;AACjE;AAEA,SAAS,uCAA+C;AACtD,QAAM,kBAAkB,KAAK,MAAM,GAAG,aAAa,mCAAmC,MAAM,CAAC;AAG7F,QAAM,oBAAoB,gBAAgB,UAAU,kBAAkB;AACtE,MAAI,CAAC,mBAAmB;AACtB,UAAM,IAAI,MAAM,4DAA4D;AAAA,EAC9E;AAEA,QAAM,kBAAkB,kBAAkB,MAAM,qBAAqB;AACrE,MAAI,CAAC,kBAAkB,CAAC,GAAG;AACzB,UAAM,IAAI,MAAM,iEAAiE;AAAA,EACnF;AAEA,SAAO,cAAc,gBAAgB,CAAC,CAAC;AACzC;AAEA,SAAS,wCAAgD;AACvD,QAAM,0BAA0B,GAAG,aAAa,0BAA0B,MAAM;AAChF,QAAM,kBAAkB,wBAAwB,MAAM,sDAAsD;AAC5G,MAAI,CAAC,kBAAkB,CAAC,GAAG;AACzB,UAAM,IAAI,MAAM,sEAAsE;AAAA,EACxF;AAEA,SAAO,cAAc,gBAAgB,CAAC,CAAC;AACzC;AAEA,SAAS,2BAAqC;AAC5C,QAAM,YAAY,oBAAI,IAAY;AAIlC,QAAM,mBAAmB,KAAK,KAAK,aAAa,QAAQ;AACxD,MAAI,GAAG,WAAW,gBAAgB,GAAG;AACnC,eAAW,SAAS,GAAG,YAAY,kBAAkB,EAAE,eAAe,KAAK,CAAC,GAAG;AAC7E,UAAI,MAAM,OAAO,KAAK,MAAM,KAAK,SAAS,KAAK,GAAG;AAChD,kBAAU,IAAI,MAAM,IAAI;AAAA,MAC1B;AAAA,IACF;AAAA,EACF;AAEA,aAAW,eAAe,GAAG,YAAY,YAAY,GAAG;AACtD,UAAM,eAAe,KAAK,KAAK,cAAc,aAAa,WAAW,qBAAqB;AAC1F,QAAI,GAAG,WAAW,YAAY,GAAG;AAC/B,gBAAU,IAAI,GAAG,WAAW,KAAK;AAAA,IACnC;AAEA,UAAM,cAAc,KAAK,KAAK,cAAc,aAAa,OAAO,SAAS;AACzE,QAAI,CAAC,GAAG,WAAW,WAAW,GAAG;AAC/B;AAAA,IACF;AAEA,eAAW,cAAc,GAAG,YAAY,WAAW,GAAG;AACpD,YAAM,cAAc,KAAK,KAAK,aAAa,YAAY,WAAW,qBAAqB;AACvF,UAAI,GAAG,WAAW,WAAW,GAAG;AAC9B,kBAAU,IAAI,GAAG,WAAW,IAAI,UAAU,KAAK;AAAA,MACjD;AAAA,IACF;AAAA,EACF;AAMA,YAAU,IAAI,mBAAmB;AACjC,aAAW,YAAY,yBAAyB;AAC9C,cAAU,IAAI,cAAc,KAAK,KAAK,WAAW,GAAG,QAAQ,KAAK,CAAC,CAAC;AAAA,EACrE;AAEA,SAAO,MAAM,KAAK,SAAS,EAAE,KAAK;AACpC;AAEA,SAAS,iBAAiB,QAAgB,eAA+B;AACvE,QAAM,eAAe,cAAc,OAAO,CAAC,iBAAiB,CAAC,GAAG,WAAW,KAAK,KAAK,QAAQ,YAAY,CAAC,CAAC;AAC3G,SAAO,YAAY,EAAE,QAAQ,CAAC,CAAC;AACjC;AAEA,KAAK,SAAS,sEAAsE,MAAM;AACxF,OAAK,UAAU,MAAM;AACnB,mBAAe;AAAA,EACjB,CAAC;AAED,OAAK,6FAA6F,MAAM;AACtG,UAAM,WAAW,GAAG,YAAY,KAAK,KAAK,GAAG,OAAO,GAAG,sBAAsB,CAAC;AAE9E,QAAI;AACF,YAAM,SAAS,wBAAwB,QAAQ;AAC/C,YAAM,iCAAiC,qCAAqC;AAC5E,YAAM,0BAA0B,sCAAsC;AACtE,YAAM,gBAAgB,WAAW,CAAC,gBAAgB,iCAAiC,GAAG,MAAM;AAE5F,aAAO,uBAAuB,EAAE,KAAK,8BAA8B;AACnE,aAAO,aAAa,EAAE,UAAU,yBAAyB;AACzD,aAAO,GAAG,WAAW,KAAK,KAAK,QAAQ,YAAY,WAAW,CAAC,CAAC,EAAE,KAAK,KAAK;AAE5E,YAAM,gBAAgB,kBAAkB,KAAK,KAAK,aAAa,QAAQ,CAAC,EAAE,IAAI,uBAAuB;AACrG,YAAM,gBAAgB,kBAAkB,KAAK,KAAK,aAAa,aAAa,CAAC,EAAE,IAAI,uBAAuB;AAC1G,YAAM,gBAAgB,kBAAkB,KAAK,KAAK,aAAa,QAAQ,CAAC,EAAE,IAAI,uBAAuB;AACrG,YAAM,eAAe,kBAAkB,KAAK,KAAK,aAAa,OAAO,CAAC,EACnE,IAAI,sBAAsB,EAC1B,OAAO,CAAC,iBAAyC,iBAAiB,IAAI;AAEzE,aAAO,aAAa,EAAE,UAAU,8BAA8B;AAC9D,uBAAiB,QAAQ,CAAC,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,GAAG,YAAY,CAAC;AAChG,aAAO,GAAG,WAAW,KAAK,KAAK,QAAQ,8BAA8B,CAAC,CAAC,EAAE,KAAK,IAAI;AAElF,YAAM,sBAAsB,kBAAkB,KAAK,KAAK,QAAQ,OAAO,QAAQ,CAAC;AAChF,aAAO,mBAAmB,EAAE,QAAQ,yBAAyB,CAAC;AAE9D,YAAM,eAAe,GAAG,aAAa,KAAK,KAAK,QAAQ,WAAW,GAAG,MAAM;AAC3E,aAAO,YAAY,EAAE,UAAU,wCAAwC;AACvE,aAAO,YAAY,EAAE,UAAU,oBAAoB;AAInD,iBAAW,YAAY,yBAAyB;AAC9C,eAAO,YAAY,EAAE,UAAU,sBAAsB,QAAQ,KAAK;AAAA,MACpE;AACA,aAAO,YAAY,EAAE,IAAI,UAAU,4BAA4B;AAE/D,YAAM,oBAAoB,GAAG,aAAa,KAAK,KAAK,QAAQ,OAAO,SAAS,WAAW,GAAG,MAAM;AAChG,aAAO,iBAAiB,EAAE,UAAU,cAAc;AAElD,YAAM,oBAAoB,GAAG,aAAa,KAAK,KAAK,QAAQ,WAAW,SAAS,kBAAkB,GAAG,MAAM;AAC3G,aAAO,iBAAiB,EAAE,UAAU,cAAc;AAIlD,aAAO,GAAG,WAAW,KAAK,KAAK,QAAQ,OAAO,UAAU,iBAAiB,CAAC,CAAC,EAAE,KAAK,KAAK;AACvF,aAAO,GAAG,WAAW,KAAK,KAAK,QAAQ,WAAW,mBAAmB,CAAC,CAAC,EAAE,KAAK,IAAI;AAMlF,YAAM,gBAAgB,KAAK;AAAA,QACzB,GAAG,aAAa,KAAK,KAAK,aAAa,UAAU,MAAM,UAAU,YAAY,GAAG,MAAM;AAAA,MACxF;AACA,YAAM,oBAAoB,cAAc,QAAQ,QAAQ,CAAC,aAAa,cAAc,MAAM,QAAQ,EAAE,MAAM;AAC1G,aAAO,kBAAkB,MAAM,EAAE,gBAAgB,CAAC;AAElD,iBAAW,aAAa,mBAAmB;AACzC,cAAM,oBAAoB,KAAK,KAAK,QAAQ,WAAW,UAAU,SAAS;AAC1E,eAAO,GAAG,UAAU,iBAAiB,EAAE,eAAe,CAAC,EAAE,KAAK,IAAI;AAClE,eAAO,cAAc,GAAG,aAAa,iBAAiB,CAAC,CAAC,EAAE,KAAK,oBAAoB,SAAS,EAAE;AAE9F,cAAM,iBAAiB,KAAK,KAAK,QAAQ,WAAW,UAAU,SAAS;AACvE,eAAO,GAAG,UAAU,cAAc,EAAE,eAAe,CAAC,EAAE,KAAK,IAAI;AAC/D,eAAO,cAAc,GAAG,aAAa,cAAc,CAAC,CAAC,EAAE,KAAK,wBAAwB,SAAS,EAAE;AAAA,MACjG;AAEA,aAAO,GAAG,WAAW,KAAK,KAAK,QAAQ,UAAU,QAAQ,CAAC,CAAC,EAAE,KAAK,KAAK;AACvE,aAAO,GAAG,WAAW,KAAK,KAAK,QAAQ,WAAW,QAAQ,CAAC,CAAC,EAAE,KAAK,KAAK;AAAA,IAC1E,UAAE;AACA,SAAG,OAAO,UAAU,EAAE,WAAW,MAAM,OAAO,KAAK,CAAC;AAAA,IACtD;AAAA,EACF,CAAC;AACH,CAAC;",
+  "sourcesContent": ["import { expect, test } from '@playwright/test'\nimport { execFileSync } from 'node:child_process'\nimport fs from 'node:fs'\nimport os from 'node:os'\nimport path from 'node:path'\nimport { fileURLToPath } from 'node:url'\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url))\nconst repoRoot = path.resolve(__dirname, '..', '..', '..', '..', '..')\nconst cliDir = path.join(repoRoot, 'packages', 'cli')\nconst cliBin = path.join(cliDir, 'dist', 'bin.js')\nconst cliBuildScript = path.join(cliDir, 'build.mjs')\nconst cliIntegrationRunnerPath = path.join(cliDir, 'src', 'lib', 'testing', 'integration.ts')\nconst standaloneTemplatePackageJsonPath = path.join(repoRoot, 'packages', 'create-app', 'template', 'package.json.template')\nconst agenticRoot = path.join(repoRoot, 'packages', 'create-app', 'agentic')\nconst packagesRoot = path.join(repoRoot, 'packages')\nconst coreVersion = JSON.parse(fs.readFileSync(path.join(packagesRoot, 'core', 'package.json'), 'utf8')).version as string\nconst UNROUTED_PACKAGE_GUIDES = new Set(['cache', 'core', 'events', 'queue', 'search', 'shared', 'ui'])\n\n// Modules the standalone fixture enables in src/modules.ts. Both are on the\n// fact-sheet allowlist, so agentic:init must ship exactly their fact-sheets\n// (enabled \u2229 allowlist \u2014 spec D6) and list them in the AGENTS.md marker block.\nconst FIXTURE_ENABLED_MODULES = ['customers', 'sales']\n\nfunction normalizePath(value: string): string {\n  return value.split(path.sep).join('/')\n}\n\nfunction runCommand(command: string, args: string[], cwd: string, env: NodeJS.ProcessEnv = {}): string {\n  return execFileSync(command, args, {\n    cwd,\n    encoding: 'utf8',\n    env: {\n      ...process.env,\n      FORCE_COLOR: '0',\n      NODE_NO_WARNINGS: '1',\n      // Keep the test hermetic: agentic:init runs scripts/install-skills.sh,\n      // whose external step (`npx skills add`) needs the network. Local tier\n      // symlinks are still installed.\n      OM_SKIP_EXTERNAL_SKILLS: '1',\n      ...env,\n    },\n  })\n}\n\nfunction runMercato(args: string[], cwd: string): string {\n  return runCommand(process.execPath, [cliBin, ...args], cwd)\n}\n\nfunction writeFile(filePath: string, content: string): void {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true })\n  fs.writeFileSync(filePath, content)\n}\n\nfunction ensureCliBuilt(): void {\n  runCommand(process.execPath, [cliBuildScript], cliDir)\n}\n\nfunction createStandaloneFixture(rootDir: string): string {\n  const appDir = path.join(rootDir, 'sample-store')\n  writeFile(\n    path.join(appDir, 'package.json'),\n    JSON.stringify(\n      {\n        name: 'sample-store',\n        private: true,\n        dependencies: { '@open-mercato/core': coreVersion },\n      },\n      null,\n      2,\n    ),\n  )\n  const moduleEntries = FIXTURE_ENABLED_MODULES\n    .map((moduleId) => `  { id: '${moduleId}', from: '@open-mercato/core' },`)\n    .join('\\n')\n  writeFile(path.join(appDir, 'src', 'modules.ts'), `export const enabledModules = [\\n${moduleEntries}\\n]\\n`)\n  return appDir\n}\n\nfunction installFakeFrameworkPackage(appDir: string): string {\n  const packageRoot = path.join(appDir, 'node_modules', '@open-mercato', 'core')\n  writeFile(path.join(packageRoot, 'package.json'), JSON.stringify({\n    name: '@open-mercato/core',\n    version: coreVersion,\n    type: 'module',\n    exports: { '.': './dist/index.js' },\n  }))\n  writeFile(path.join(packageRoot, 'dist', 'index.js'), 'export {}\\n')\n  writeFile(path.join(packageRoot, 'AGENTS.md'), '# Installed core instructions\\n')\n  for (const moduleId of FIXTURE_ENABLED_MODULES) {\n    writeFile(path.join(packageRoot, 'src', 'modules', moduleId, 'AGENTS.md'), `# Installed ${moduleId} instructions\\n`)\n    writeFile(\n      path.join(packageRoot, 'src', 'modules', moduleId, 'data', 'entities.ts'),\n      `export class ${moduleId === 'customers' ? 'Person' : 'Sale'} {}\\n`,\n    )\n  }\n  return packageRoot\n}\n\nfunction snapshotTextFiles(rootDir: string): Record<string, string> {\n  return Object.fromEntries(\n    listRelativeFiles(rootDir).map((relativePath) => [\n      relativePath,\n      fs.readFileSync(path.join(rootDir, relativePath), 'utf8'),\n    ]),\n  )\n}\n\nfunction listRelativeFiles(rootDir: string): string[] {\n  if (!fs.existsSync(rootDir)) {\n    return []\n  }\n\n  const collected: string[] = []\n  for (const entry of fs.readdirSync(rootDir, { withFileTypes: true })) {\n    const absolutePath = path.join(rootDir, entry.name)\n    if (entry.isDirectory()) {\n      for (const nestedPath of listRelativeFiles(absolutePath)) {\n        collected.push(path.join(entry.name, nestedPath))\n      }\n      continue\n    }\n    if (entry.isFile()) {\n      collected.push(entry.name)\n    }\n  }\n\n  return collected.map(normalizePath).sort()\n}\n\nfunction mapSharedSourceToOutput(relativePath: string): string {\n  if (relativePath === 'AGENTS.md.template') {\n    return 'AGENTS.md'\n  }\n\n  if (relativePath.startsWith('scripts/')) {\n    return relativePath\n  }\n\n  if (!relativePath.startsWith('ai/')) {\n    throw new Error(`Unexpected shared source path: ${relativePath}`)\n  }\n\n  return normalizePath(path.join('.ai', relativePath.slice('ai/'.length)))\n}\n\nfunction mapClaudeSourceToOutput(relativePath: string): string {\n  if (relativePath === 'CLAUDE.md.template') {\n    return 'CLAUDE.md'\n  }\n  if (relativePath === 'settings.json') {\n    return '.claude/settings.json'\n  }\n  if (relativePath === 'mcp.json.example') {\n    return '.mcp.json.example'\n  }\n  if (relativePath.startsWith('hooks/')) {\n    return normalizePath(path.join('.claude', relativePath))\n  }\n\n  throw new Error(`Unexpected Claude source path: ${relativePath}`)\n}\n\nfunction mapCursorSourceToOutput(relativePath: string): string {\n  if (relativePath === 'hooks.json') {\n    return '.cursor/hooks.json'\n  }\n  if (relativePath === 'mcp.json.example') {\n    return '.cursor/mcp.json.example'\n  }\n  if (relativePath.startsWith('hooks/') || relativePath.startsWith('rules/')) {\n    return normalizePath(path.join('.cursor', relativePath))\n  }\n\n  throw new Error(`Unexpected Cursor source path: ${relativePath}`)\n}\n\nfunction mapCodexSourceToOutput(relativePath: string): string | null {\n  if (relativePath === 'mcp.json.example') {\n    return '.codex/mcp.json.example'\n  }\n  if (relativePath === 'enforcement-rules.md') {\n    return null\n  }\n\n  throw new Error(`Unexpected Codex source path: ${relativePath}`)\n}\n\nfunction readPlaywrightConfigPathFromTemplate(): string {\n  const packageTemplate = JSON.parse(fs.readFileSync(standaloneTemplatePackageJsonPath, 'utf8')) as {\n    scripts?: Record<string, string>\n  }\n  const integrationScript = packageTemplate.scripts?.['test:integration']\n  if (!integrationScript) {\n    throw new Error('Standalone template is missing the test:integration script')\n  }\n\n  const configPathMatch = integrationScript.match(/--config\\s+([^\\s]+)/)\n  if (!configPathMatch?.[1]) {\n    throw new Error('Standalone template test:integration script is missing --config')\n  }\n\n  return normalizePath(configPathMatch[1])\n}\n\nfunction readPlaywrightConfigPathFromCliRunner(): string {\n  const integrationRunnerSource = fs.readFileSync(cliIntegrationRunnerPath, 'utf8')\n  const configPathMatch = integrationRunnerSource.match(/const PLAYWRIGHT_INTEGRATION_CONFIG_PATH = '([^']+)'/)\n  if (!configPathMatch?.[1]) {\n    throw new Error('CLI integration runner is missing PLAYWRIGHT_INTEGRATION_CONFIG_PATH')\n  }\n\n  return normalizePath(configPathMatch[1])\n}\n\nfunction expectedGuideOutputNames(): string[] {\n  const collected = new Set<string>()\n\n  // Static conceptual guides checked into create-app (e.g. module-system.md) are\n  // bundled into dist/agentic/guides by the CLI build and copied wholesale.\n  const staticGuidesRoot = path.join(agenticRoot, 'guides')\n  if (fs.existsSync(staticGuidesRoot)) {\n    for (const entry of fs.readdirSync(staticGuidesRoot, { withFileTypes: true })) {\n      if (entry.isFile() && entry.name.endsWith('.md')) {\n        collected.add(entry.name)\n      }\n    }\n  }\n\n  for (const packageName of fs.readdirSync(packagesRoot)) {\n    const packageGuide = path.join(packagesRoot, packageName, 'agentic', 'standalone-guide.md')\n    if (fs.existsSync(packageGuide) && !UNROUTED_PACKAGE_GUIDES.has(packageName)) {\n      collected.add(`${packageName}.md`)\n    }\n\n    const modulesRoot = path.join(packagesRoot, packageName, 'src', 'modules')\n    if (!fs.existsSync(modulesRoot)) {\n      continue\n    }\n\n    for (const moduleName of fs.readdirSync(modulesRoot)) {\n      const moduleGuide = path.join(modulesRoot, moduleName, 'agentic', 'standalone-guide.md')\n      if (fs.existsSync(moduleGuide)) {\n        collected.add(`${packageName}.${moduleName}.md`)\n      }\n    }\n  }\n\n  // Generated fact-sheet artifacts (spec 2026-06-27-ts-morph-module-fact-sheets):\n  // the module-facts.json sidecar is copied as-is and fact-sheets are filtered to the\n  // fixture's enabled modules. The legacy core.<module>.md redirect stubs are no longer\n  // emitted (#3754). framework-extension-points.md is likewise generated into\n  // dist/agentic/guides by both build.mjs pipelines (#4810) rather than checked in\n  // alongside the static conceptual guides, so it needs an explicit entry here.\n  collected.add('module-facts.json')\n  collected.add('framework-extension-points.md')\n  collected.add('upstream/AGENTS.md')\n  collected.add('upstream/BACKWARD_COMPATIBILITY.md')\n  collected.add('upstream/manifest.json')\n  for (const moduleId of FIXTURE_ENABLED_MODULES) {\n    collected.add(normalizePath(path.join('modules', `${moduleId}.md`)))\n  }\n\n  return Array.from(collected).sort()\n}\n\nfunction assertPathsExist(appDir: string, relativePaths: string[]): void {\n  const missingPaths = relativePaths.filter((relativePath) => !fs.existsSync(path.join(appDir, relativePath)))\n  expect(missingPaths).toEqual([])\n}\n\ntest.describe('TC-INT-008: CLI agentic init mirrors standalone scaffolding assets', () => {\n  test.beforeAll(() => {\n    ensureCliBuilt()\n  })\n\n  test('should run bootstrap-free and generate the shared, guide, and tool-specific agentic files', () => {\n    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mercato-cli-agentic-'))\n\n    try {\n      const appDir = createStandaloneFixture(tempRoot)\n      const standalonePlaywrightConfigPath = readPlaywrightConfigPathFromTemplate()\n      const cliPlaywrightConfigPath = readPlaywrightConfigPathFromCliRunner()\n      const commandOutput = runMercato(['agentic:init', '--tool=claude-code,codex,cursor'], appDir)\n\n      expect(cliPlaywrightConfigPath).toBe(standalonePlaywrightConfigPath)\n      expect(commandOutput).toContain('Agentic setup complete:')\n      expect(fs.existsSync(path.join(appDir, '.mercato', 'generated'))).toBe(false)\n\n      const sharedOutputs = listRelativeFiles(path.join(agenticRoot, 'shared')).map(mapSharedSourceToOutput)\n      const claudeOutputs = listRelativeFiles(path.join(agenticRoot, 'claude-code')).map(mapClaudeSourceToOutput)\n      const cursorOutputs = listRelativeFiles(path.join(agenticRoot, 'cursor')).map(mapCursorSourceToOutput)\n      const codexOutputs = listRelativeFiles(path.join(agenticRoot, 'codex'))\n        .map(mapCodexSourceToOutput)\n        .filter((relativePath): relativePath is string => relativePath !== null)\n\n      expect(sharedOutputs).toContain(standalonePlaywrightConfigPath)\n      assertPathsExist(appDir, [...sharedOutputs, ...claudeOutputs, ...cursorOutputs, ...codexOutputs])\n      expect(fs.existsSync(path.join(appDir, standalonePlaywrightConfigPath))).toBe(true)\n\n      const generatedGuideNames = listRelativeFiles(path.join(appDir, '.ai', 'guides'))\n      expect(generatedGuideNames).toEqual(expectedGuideOutputNames())\n\n      const agentsSource = fs.readFileSync(path.join(appDir, 'AGENTS.md'), 'utf8')\n      expect(agentsSource).toContain('<!-- CODEX_ENFORCEMENT_RULES_START -->')\n      expect(agentsSource).toContain('.ai/guides/upstream/BACKWARD_COMPATIBILITY.md')\n\n      // The Module-Specific Guides marker block is a compact enabled-module ID\n      // index (enabled \u2229 bundled) plus one progressively loaded path pattern.\n      for (const moduleId of FIXTURE_ENABLED_MODULES) {\n        expect(agentsSource).toContain(`\\`${moduleId}\\``)\n      }\n      expect(agentsSource).toContain('`.ai/guides/modules/<id>.md`')\n      expect(agentsSource.match(/\\.ai\\/guides\\/modules\\//g)).toHaveLength(1)\n      expect(agentsSource).not.toContain('`auth`')\n      expect(agentsSource).not.toContain('Core CRM capabilities')\n\n      const specsReadmeSource = fs.readFileSync(path.join(appDir, '.ai', 'specs', 'README.md'), 'utf8')\n      expect(specsReadmeSource).toContain('sample-store')\n\n      const cursorRulesSource = fs.readFileSync(path.join(appDir, '.cursor', 'rules', 'open-mercato.mdc'), 'utf8')\n      expect(cursorRulesSource).toContain('sample-store')\n\n      // om-spec-writing moved to the external open-mercato/skills collection\n      // (installed via `yarn install-skills`), so agentic:init must not ship a copy.\n      expect(fs.existsSync(path.join(appDir, '.ai', 'skills', 'om-spec-writing'))).toBe(false)\n      expect(fs.existsSync(path.join(appDir, 'scripts', 'install-skills.sh'))).toBe(true)\n\n      // install-skills.sh (run by agentic:init) installs every local tier skill once,\n      // into the canonical .agents/skills/. Codex and Cursor read that directory\n      // natively, so they get no skills directory of their own; Claude Code cannot,\n      // so it keeps a link layer pointing back at the canonical copy.\n      const tiersManifest = JSON.parse(\n        fs.readFileSync(path.join(agenticRoot, 'shared', 'ai', 'skills', 'tiers.json'), 'utf8'),\n      ) as { default: string[]; tiers: Record<string, { skills: string[] }> }\n      const defaultTierSkills = tiersManifest.default.flatMap((tierName) => tiersManifest.tiers[tierName].skills)\n      expect(defaultTierSkills.length).toBeGreaterThan(0)\n\n      for (const skillName of defaultTierSkills) {\n        const canonicalLinkPath = path.join(appDir, '.agents', 'skills', skillName)\n        expect(fs.lstatSync(canonicalLinkPath).isSymbolicLink()).toBe(true)\n        expect(normalizePath(fs.readlinkSync(canonicalLinkPath))).toBe(`../../.ai/skills/${skillName}`)\n\n        const claudeLinkPath = path.join(appDir, '.claude', 'skills', skillName)\n        expect(fs.lstatSync(claudeLinkPath).isSymbolicLink()).toBe(true)\n        expect(normalizePath(fs.readlinkSync(claudeLinkPath))).toBe(`../../.agents/skills/${skillName}`)\n      }\n\n      expect(fs.existsSync(path.join(appDir, '.codex', 'skills'))).toBe(false)\n      expect(fs.existsSync(path.join(appDir, '.cursor', 'skills'))).toBe(false)\n    } finally {\n      fs.rmSync(tempRoot, { recursive: true, force: true })\n    }\n  })\n\n  test('emits a runnable exact-version framework context escape hatch for an installed package', () => {\n    const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), 'mercato-cli-framework-context-'))\n\n    try {\n      const appDir = createStandaloneFixture(tempRoot)\n      const packageRoot = installFakeFrameworkPackage(appDir)\n      const resolvedPackageRoot = fs.realpathSync(packageRoot)\n      const packageBefore = snapshotTextFiles(packageRoot)\n\n      runMercato(['agentic:init', '--tool=codex'], appDir)\n      const generatedScript = path.join(appDir, 'scripts', 'framework-context.mjs')\n      expect(fs.existsSync(generatedScript)).toBe(true)\n\n      const output = runCommand(\n        process.execPath,\n        [generatedScript, '--module', 'customers', '--query', 'Person', '--json'],\n        appDir,\n        // The generated standalone helper must not depend on a globally\n        // installed ripgrep binary; process.execPath is already absolute.\n        { PATH: '', Path: '' },\n      )\n      const context = JSON.parse(output) as {\n        module: string\n        package: { name: string; version: string; root: string }\n        sourceKind: string\n        sourceRoot: string\n        materializedSource: string\n        instructions: Array<{ kind: string; path: string | null; materializedPath?: string }>\n        boundedSearch: { status: string; matches: number; maxMatches: number; result: string }\n        warnings: string[]\n      }\n\n      expect(context.module).toBe('customers')\n      expect(context.package).toEqual({ name: '@open-mercato/core', version: coreVersion, root: resolvedPackageRoot })\n      expect(context.sourceKind).toBe('source')\n      expect(normalizePath(context.sourceRoot)).toBe(normalizePath(path.join(resolvedPackageRoot, 'src', 'modules', 'customers')))\n      expect(context.instructions.filter((entry) => entry.path).map((entry) => entry.kind)).toEqual([\n        'standalone-root',\n        'upstream-bc',\n        'package',\n        'module-1',\n        'upstream-root',\n      ])\n      expect(context.instructions.filter((entry) => entry.path).every((entry) => entry.materializedPath)).toBe(true)\n      expect(context.boundedSearch).toMatchObject({ status: 'matched', matches: 1, maxMatches: 200 })\n      expect(fs.existsSync(path.join(appDir, context.materializedSource))).toBe(true)\n      expect(fs.existsSync(path.join(appDir, context.boundedSearch.result))).toBe(true)\n      expect(context.warnings.some((warning) => warning.includes('Generated facts for customers are stale'))).toBe(false)\n      expect(snapshotTextFiles(packageRoot)).toEqual(packageBefore)\n    } finally {\n      fs.rmSync(tempRoot, { recursive: true, force: true })\n    }\n  })\n})\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/lib/agentic-init.js

@@ -20,6 +20,8 @@ function parseArgs(args) {
     const arg = args[i];
     if (arg === "--force" || arg === "-f") {
       options.force = true;
+    } else if (arg === "--update-harness") {
+      options.updateHarness = true;
     } else if (arg.startsWith("--tool=")) {
       options.tool = arg.slice("--tool=".length);
     } else if (arg === "--tool") {
@@ -46,11 +48,15 @@ function resolveRelevantAgenticFiles(toolOption) {
 async function runAgenticInit(args) {
   const targetDir = resolve(".");
   const options = parseArgs(args);
+  if (options.force && options.updateHarness) {
+    console.error("\u274C  --force and --update-harness are mutually exclusive");
+    return 1;
+  }
   if (!existsSync(join(targetDir, "src", "modules.ts"))) {
     console.error("\u274C  Not an Open Mercato app directory (src/modules.ts not found)");
     return 1;
   }
-  if (!options.force) {
+  if (!options.force && !options.updateHarness) {
     const existingFiles = resolveRelevantAgenticFiles(options.tool).filter((relativePath) => existsSync(join(targetDir, relativePath)));
     if (existingFiles.length > 0) {
       console.log("");
@@ -59,7 +65,7 @@ async function runAgenticInit(args) {
         console.log(`   \u2022 ${f}`);
       }
       console.log("");
-      console.log("Run with --force to regenerate from current templates.");
+      console.log("Run with --update-harness to preserve local edits, or --force to replace generated files.");
       console.log("");
       return 0;
     }
@@ -68,7 +74,11 @@ async function runAgenticInit(args) {
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   const ask = (q) => new Promise((res) => rl.question(q, (a) => res(a.trim())));
   try {
-    await runAgenticSetup(targetDir, ask, { tool: options.tool, force: options.force });
+    await runAgenticSetup(targetDir, ask, {
+      tool: options.tool,
+      force: options.force,
+      updateHarness: options.updateHarness
+    });
   } finally {
     rl.close();
   }

package/dist/lib/agentic-init.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/lib/agentic-init.ts"],
-  "sourcesContent": ["import { existsSync } from 'node:fs'\nimport { join, resolve } from 'node:path'\nimport { createInterface } from 'node:readline'\n\ninterface AgenticInitOptions {\n  tool?: string\n  force?: boolean\n}\n\nconst TOOL_EXISTING_FILES: Record<string, string[]> = {\n  'claude-code': [\n    'CLAUDE.md',\n    '.claude/settings.json',\n    '.mcp.json.example',\n  ],\n  'codex': [\n    '.codex/mcp.json.example',\n  ],\n  'cursor': [\n    '.cursor/hooks.json',\n  ],\n}\n\nfunction parseArgs(args: string[]): AgenticInitOptions {\n  const options: AgenticInitOptions = {}\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i]\n    if (arg === '--force' || arg === '-f') {\n      options.force = true\n    } else if (arg.startsWith('--tool=')) {\n      options.tool = arg.slice('--tool='.length)\n    } else if (arg === '--tool') {\n      options.tool = args[++i]\n    }\n  }\n  return options\n}\n\nexport function resolveRelevantAgenticFiles(toolOption?: string): string[] {\n  if (typeof toolOption !== 'string' || toolOption.trim().length === 0) {\n    return Object.values(TOOL_EXISTING_FILES).flat()\n  }\n\n  const toolIds = toolOption.split(',').map((toolId) => toolId.trim()).filter(Boolean)\n  const relevantFiles = new Set<string>()\n\n  for (const toolId of toolIds) {\n    const toolFiles = TOOL_EXISTING_FILES[toolId]\n    if (!toolFiles) continue\n    for (const relativePath of toolFiles) {\n      relevantFiles.add(relativePath)\n    }\n  }\n\n  return relevantFiles.size > 0 ? Array.from(relevantFiles) : Object.values(TOOL_EXISTING_FILES).flat()\n}\n\nexport async function runAgenticInit(args: string[]): Promise<number> {\n  const targetDir = resolve('.')\n  const options = parseArgs(args)\n\n  // Validate this is an Open Mercato app directory\n  if (!existsSync(join(targetDir, 'src', 'modules.ts'))) {\n    console.error('\u274C  Not an Open Mercato app directory (src/modules.ts not found)')\n    return 1\n  }\n\n  // Check if agentic files already exist and warn unless --force\n  if (!options.force) {\n    const existingFiles = resolveRelevantAgenticFiles(options.tool)\n      .filter((relativePath) => existsSync(join(targetDir, relativePath)))\n\n    if (existingFiles.length > 0) {\n      console.log('')\n      console.log('\u26A0\uFE0F  Agentic files already exist:')\n      for (const f of existingFiles) {\n        console.log(`   \u2022 ${f}`)\n      }\n      console.log('')\n      console.log('Run with --force to regenerate from current templates.')\n      console.log('')\n      return 0\n    }\n  }\n\n  // Dynamic import of the setup wizard from create-app's agentic source\n  // Since we can't import from create-app at runtime in standalone apps,\n  // we inline the generator logic here using the same source files approach.\n  const { runAgenticSetup } = await import('./agentic-setup.js')\n\n  const rl = createInterface({ input: process.stdin, output: process.stdout })\n  const ask = (q: string) => new Promise<string>((res) => rl.question(q, (a) => res(a.trim())))\n\n  try {\n    await runAgenticSetup(targetDir, ask, { tool: options.tool, force: options.force })\n  } finally {\n    rl.close()\n  }\n\n  return 0\n}\n"],
-  "mappings": "AAAA,SAAS,kBAAkB;AAC3B,SAAS,MAAM,eAAe;AAC9B,SAAS,uBAAuB;AAOhC,MAAM,sBAAgD;AAAA,EACpD,eAAe;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,SAAS;AAAA,IACP;AAAA,EACF;AAAA,EACA,UAAU;AAAA,IACR;AAAA,EACF;AACF;AAEA,SAAS,UAAU,MAAoC;AACrD,QAAM,UAA8B,CAAC;AACrC,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAClB,QAAI,QAAQ,aAAa,QAAQ,MAAM;AACrC,cAAQ,QAAQ;AAAA,IAClB,WAAW,IAAI,WAAW,SAAS,GAAG;AACpC,cAAQ,OAAO,IAAI,MAAM,UAAU,MAAM;AAAA,IAC3C,WAAW,QAAQ,UAAU;AAC3B,cAAQ,OAAO,KAAK,EAAE,CAAC;AAAA,IACzB;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,4BAA4B,YAA+B;AACzE,MAAI,OAAO,eAAe,YAAY,WAAW,KAAK,EAAE,WAAW,GAAG;AACpE,WAAO,OAAO,OAAO,mBAAmB,EAAE,KAAK;AAAA,EACjD;AAEA,QAAM,UAAU,WAAW,MAAM,GAAG,EAAE,IAAI,CAAC,WAAW,OAAO,KAAK,CAAC,EAAE,OAAO,OAAO;AACnF,QAAM,gBAAgB,oBAAI,IAAY;AAEtC,aAAW,UAAU,SAAS;AAC5B,UAAM,YAAY,oBAAoB,MAAM;AAC5C,QAAI,CAAC,UAAW;AAChB,eAAW,gBAAgB,WAAW;AACpC,oBAAc,IAAI,YAAY;AAAA,IAChC;AAAA,EACF;AAEA,SAAO,cAAc,OAAO,IAAI,MAAM,KAAK,aAAa,IAAI,OAAO,OAAO,mBAAmB,EAAE,KAAK;AACtG;AAEA,eAAsB,eAAe,MAAiC;AACpE,QAAM,YAAY,QAAQ,GAAG;AAC7B,QAAM,UAAU,UAAU,IAAI;AAG9B,MAAI,CAAC,WAAW,KAAK,WAAW,OAAO,YAAY,CAAC,GAAG;AACrD,YAAQ,MAAM,sEAAiE;AAC/E,WAAO;AAAA,EACT;AAGA,MAAI,CAAC,QAAQ,OAAO;AAClB,UAAM,gBAAgB,4BAA4B,QAAQ,IAAI,EAC3D,OAAO,CAAC,iBAAiB,WAAW,KAAK,WAAW,YAAY,CAAC,CAAC;AAErE,QAAI,cAAc,SAAS,GAAG;AAC5B,cAAQ,IAAI,EAAE;AACd,cAAQ,IAAI,4CAAkC;AAC9C,iBAAW,KAAK,eAAe;AAC7B,gBAAQ,IAAI,aAAQ,CAAC,EAAE;AAAA,MACzB;AACA,cAAQ,IAAI,EAAE;AACd,cAAQ,IAAI,wDAAwD;AACpE,cAAQ,IAAI,EAAE;AACd,aAAO;AAAA,IACT;AAAA,EACF;AAKA,QAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,oBAAoB;AAE7D,QAAM,KAAK,gBAAgB,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAC3E,QAAM,MAAM,CAAC,MAAc,IAAI,QAAgB,CAAC,QAAQ,GAAG,SAAS,GAAG,CAAC,MAAM,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAE5F,MAAI;AACF,UAAM,gBAAgB,WAAW,KAAK,EAAE,MAAM,QAAQ,MAAM,OAAO,QAAQ,MAAM,CAAC;AAAA,EACpF,UAAE;AACA,OAAG,MAAM;AAAA,EACX;AAEA,SAAO;AACT;",
+  "sourcesContent": ["import { existsSync } from 'node:fs'\nimport { join, resolve } from 'node:path'\nimport { createInterface } from 'node:readline'\n\ninterface AgenticInitOptions {\n  tool?: string\n  force?: boolean\n  updateHarness?: boolean\n}\n\nconst TOOL_EXISTING_FILES: Record<string, string[]> = {\n  'claude-code': [\n    'CLAUDE.md',\n    '.claude/settings.json',\n    '.mcp.json.example',\n  ],\n  'codex': [\n    '.codex/mcp.json.example',\n  ],\n  'cursor': [\n    '.cursor/hooks.json',\n  ],\n}\n\nfunction parseArgs(args: string[]): AgenticInitOptions {\n  const options: AgenticInitOptions = {}\n  for (let i = 0; i < args.length; i++) {\n    const arg = args[i]\n    if (arg === '--force' || arg === '-f') {\n      options.force = true\n    } else if (arg === '--update-harness') {\n      options.updateHarness = true\n    } else if (arg.startsWith('--tool=')) {\n      options.tool = arg.slice('--tool='.length)\n    } else if (arg === '--tool') {\n      options.tool = args[++i]\n    }\n  }\n  return options\n}\n\nexport function resolveRelevantAgenticFiles(toolOption?: string): string[] {\n  if (typeof toolOption !== 'string' || toolOption.trim().length === 0) {\n    return Object.values(TOOL_EXISTING_FILES).flat()\n  }\n\n  const toolIds = toolOption.split(',').map((toolId) => toolId.trim()).filter(Boolean)\n  const relevantFiles = new Set<string>()\n\n  for (const toolId of toolIds) {\n    const toolFiles = TOOL_EXISTING_FILES[toolId]\n    if (!toolFiles) continue\n    for (const relativePath of toolFiles) {\n      relevantFiles.add(relativePath)\n    }\n  }\n\n  return relevantFiles.size > 0 ? Array.from(relevantFiles) : Object.values(TOOL_EXISTING_FILES).flat()\n}\n\nexport async function runAgenticInit(args: string[]): Promise<number> {\n  const targetDir = resolve('.')\n  const options = parseArgs(args)\n\n  if (options.force && options.updateHarness) {\n    console.error('\u274C  --force and --update-harness are mutually exclusive')\n    return 1\n  }\n\n  // Validate this is an Open Mercato app directory\n  if (!existsSync(join(targetDir, 'src', 'modules.ts'))) {\n    console.error('\u274C  Not an Open Mercato app directory (src/modules.ts not found)')\n    return 1\n  }\n\n  // Check if agentic files already exist and warn unless --force\n  if (!options.force && !options.updateHarness) {\n    const existingFiles = resolveRelevantAgenticFiles(options.tool)\n      .filter((relativePath) => existsSync(join(targetDir, relativePath)))\n\n    if (existingFiles.length > 0) {\n      console.log('')\n      console.log('\u26A0\uFE0F  Agentic files already exist:')\n      for (const f of existingFiles) {\n        console.log(`   \u2022 ${f}`)\n      }\n      console.log('')\n      console.log('Run with --update-harness to preserve local edits, or --force to replace generated files.')\n      console.log('')\n      return 0\n    }\n  }\n\n  // Dynamic import of the setup wizard from create-app's agentic source\n  // Since we can't import from create-app at runtime in standalone apps,\n  // we inline the generator logic here using the same source files approach.\n  const { runAgenticSetup } = await import('./agentic-setup.js')\n\n  const rl = createInterface({ input: process.stdin, output: process.stdout })\n  const ask = (q: string) => new Promise<string>((res) => rl.question(q, (a) => res(a.trim())))\n\n  try {\n    await runAgenticSetup(targetDir, ask, {\n      tool: options.tool,\n      force: options.force,\n      updateHarness: options.updateHarness,\n    })\n  } finally {\n    rl.close()\n  }\n\n  return 0\n}\n"],
+  "mappings": "AAAA,SAAS,kBAAkB;AAC3B,SAAS,MAAM,eAAe;AAC9B,SAAS,uBAAuB;AAQhC,MAAM,sBAAgD;AAAA,EACpD,eAAe;AAAA,IACb;AAAA,IACA;AAAA,IACA;AAAA,EACF;AAAA,EACA,SAAS;AAAA,IACP;AAAA,EACF;AAAA,EACA,UAAU;AAAA,IACR;AAAA,EACF;AACF;AAEA,SAAS,UAAU,MAAoC;AACrD,QAAM,UAA8B,CAAC;AACrC,WAAS,IAAI,GAAG,IAAI,KAAK,QAAQ,KAAK;AACpC,UAAM,MAAM,KAAK,CAAC;AAClB,QAAI,QAAQ,aAAa,QAAQ,MAAM;AACrC,cAAQ,QAAQ;AAAA,IAClB,WAAW,QAAQ,oBAAoB;AACrC,cAAQ,gBAAgB;AAAA,IAC1B,WAAW,IAAI,WAAW,SAAS,GAAG;AACpC,cAAQ,OAAO,IAAI,MAAM,UAAU,MAAM;AAAA,IAC3C,WAAW,QAAQ,UAAU;AAC3B,cAAQ,OAAO,KAAK,EAAE,CAAC;AAAA,IACzB;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,4BAA4B,YAA+B;AACzE,MAAI,OAAO,eAAe,YAAY,WAAW,KAAK,EAAE,WAAW,GAAG;AACpE,WAAO,OAAO,OAAO,mBAAmB,EAAE,KAAK;AAAA,EACjD;AAEA,QAAM,UAAU,WAAW,MAAM,GAAG,EAAE,IAAI,CAAC,WAAW,OAAO,KAAK,CAAC,EAAE,OAAO,OAAO;AACnF,QAAM,gBAAgB,oBAAI,IAAY;AAEtC,aAAW,UAAU,SAAS;AAC5B,UAAM,YAAY,oBAAoB,MAAM;AAC5C,QAAI,CAAC,UAAW;AAChB,eAAW,gBAAgB,WAAW;AACpC,oBAAc,IAAI,YAAY;AAAA,IAChC;AAAA,EACF;AAEA,SAAO,cAAc,OAAO,IAAI,MAAM,KAAK,aAAa,IAAI,OAAO,OAAO,mBAAmB,EAAE,KAAK;AACtG;AAEA,eAAsB,eAAe,MAAiC;AACpE,QAAM,YAAY,QAAQ,GAAG;AAC7B,QAAM,UAAU,UAAU,IAAI;AAE9B,MAAI,QAAQ,SAAS,QAAQ,eAAe;AAC1C,YAAQ,MAAM,6DAAwD;AACtE,WAAO;AAAA,EACT;AAGA,MAAI,CAAC,WAAW,KAAK,WAAW,OAAO,YAAY,CAAC,GAAG;AACrD,YAAQ,MAAM,sEAAiE;AAC/E,WAAO;AAAA,EACT;AAGA,MAAI,CAAC,QAAQ,SAAS,CAAC,QAAQ,eAAe;AAC5C,UAAM,gBAAgB,4BAA4B,QAAQ,IAAI,EAC3D,OAAO,CAAC,iBAAiB,WAAW,KAAK,WAAW,YAAY,CAAC,CAAC;AAErE,QAAI,cAAc,SAAS,GAAG;AAC5B,cAAQ,IAAI,EAAE;AACd,cAAQ,IAAI,4CAAkC;AAC9C,iBAAW,KAAK,eAAe;AAC7B,gBAAQ,IAAI,aAAQ,CAAC,EAAE;AAAA,MACzB;AACA,cAAQ,IAAI,EAAE;AACd,cAAQ,IAAI,2FAA2F;AACvG,cAAQ,IAAI,EAAE;AACd,aAAO;AAAA,IACT;AAAA,EACF;AAKA,QAAM,EAAE,gBAAgB,IAAI,MAAM,OAAO,oBAAoB;AAE7D,QAAM,KAAK,gBAAgB,EAAE,OAAO,QAAQ,OAAO,QAAQ,QAAQ,OAAO,CAAC;AAC3E,QAAM,MAAM,CAAC,MAAc,IAAI,QAAgB,CAAC,QAAQ,GAAG,SAAS,GAAG,CAAC,MAAM,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;AAE5F,MAAI;AACF,UAAM,gBAAgB,WAAW,KAAK;AAAA,MACpC,MAAM,QAAQ;AAAA,MACd,OAAO,QAAQ;AAAA,MACf,eAAe,QAAQ;AAAA,IACzB,CAAC;AAAA,EACH,UAAE;AACA,OAAG,MAAM;AAAA,EACX;AAEA,SAAO;AACT;",
   "names": []
 }