@open-mercato/cli 0.6.5-develop.5337.1.534b781eac → 0.6.5

package/.turbo/turbo-build.log

@@ -1,4 +1,4 @@
-[build:cli] found 87 entry points
+[build:cli] found 89 entry points
 Copied create-app/agentic/ → dist/agentic/
 Discovered 16 standalone guides → dist/agentic/guides/
 [build:cli] built successfully

package/dist/agentic/shared/ai/skills/om-troubleshooter/SKILL.md

@@ -39,7 +39,7 @@ When the developer reports a problem, follow this order:
 
 ### Step 2: Check Generated Files
 
-Run these commands first — they fix 60%+ of issues:
+These commands fix 60%+ of issues, so they are usually the first fix to propose (they are mutating — propose, then run after confirmation per [Step 4](#step-4-propose-before-fixing)):
 
 ```bash
 yarn generate          # Regenerate module discovery files
@@ -61,6 +61,28 @@ ls .mercato/generated/
 yarn typecheck
 ```
 
+### Step 4: Propose Before Fixing
+
+Once you have diagnosed the root cause, **do not apply the fix immediately**. First present:
+
+1. The **root cause** — what is actually broken and why.
+2. The **proposed fix** — the exact commands and/or code changes you intend to apply.
+
+Then **wait for explicit user confirmation** before applying any **mutating** change. This keeps the developer in control and avoids surprise edits, migrations, or restarts.
+
+**Read-only diagnostics may run without asking** — they only gather information and change nothing:
+
+| Allowed without confirmation (read-only) | Requires confirmation (mutating) |
+|------------------------------------------|----------------------------------|
+| `yarn typecheck` | `yarn generate` |
+| `grep` / file reads / `ls` | `yarn db:generate` |
+| log / browser-console inspection | `yarn db:migrate` |
+| `docker compose ps` | editing files |
+| `curl` against a running endpoint (GET) | restarting the dev server (`yarn dev`) |
+| | `docker compose up` |
+
+When in doubt about whether an action mutates state, treat it as mutating and ask first. Once the user confirms, apply the fix and verify it.
+
 ---
 
 ## 2. Module Issues
@@ -76,24 +98,24 @@ yarn typecheck
    // Must have this entry:
    { id: '<module_id>', from: '@app' }
    ```
-   Fix: Add the entry and run `yarn generate`.
+   Proposed fix: Add the entry and run `yarn generate`.
 
 2. **Did you run `yarn generate`?**
    Check if `.mercato/generated/` contains your module's entries.
-   Fix: Run `yarn generate`.
+   Proposed fix: Run `yarn generate`.
 
 3. **Is the module folder named correctly?**
    Must be plural, snake_case: `src/modules/<module_id>/`
-   Fix: Rename folder to match module ID.
+   Proposed fix: Rename folder to match module ID.
 
 4. **Does `index.ts` export `metadata`?**
    ```typescript
    export const metadata: ModuleInfo = { name: '<module_id>', ... }
    ```
-   Fix: Add the metadata export.
+   Proposed fix: Add the metadata export.
 
 5. **Is the dev server running with latest changes?**
-   Fix: Restart with `yarn dev`.
+   Proposed fix: Restart with `yarn dev`.
 
 ### Module loads but pages 404
 
@@ -104,17 +126,17 @@ yarn typecheck
 1. **Are backend page files in the right location?**
    - List page: `backend/page.tsx` (not `backend/index.tsx`)
    - Detail page: `backend/<entities>/[id].tsx` (bracket notation)
-   Fix: Rename to match auto-discovery convention.
+   Proposed fix: Rename to match auto-discovery convention.
 
 2. **Do pages export `metadata` with `requireAuth`?**
    ```typescript
    export const metadata = { requireAuth: true, features: ['<module_id>.view'] }
    ```
-   Fix: Add metadata export.
+   Proposed fix: Add metadata export.
 
 3. **Does the user have the required ACL features?**
    Check `setup.ts` has `defaultRoleFeatures` for the user's role.
-   Fix: Add features to role defaults, re-run setup.
+   Proposed fix: Add features to role defaults, re-run setup.
 
 ---
 
@@ -130,22 +152,22 @@ yarn typecheck
    ```bash
    yarn db:generate     # Probes/creates migration file
    ```
-   Fix: Run `yarn db:generate` to inspect the required migration, then keep only the scoped SQL for your module and update `src/modules/<module_id>/migrations/.snapshot-open-mercato.json`.
+   Proposed fix: Run `yarn db:generate` to inspect the required migration, then keep only the scoped SQL for your module and update `src/modules/<module_id>/migrations/.snapshot-open-mercato.json`.
 
 2. **Is the entity declared in the right file with the right imports?**
    Entity classes belong in `src/modules/<module_id>/data/entities.ts` and decorators must come from `@mikro-orm/decorators/legacy`.
-   Fix: move stale `entities/<Entity>.ts` patterns into `data/entities.ts` and fix the imports before regenerating the migration.
+   Proposed fix: move stale `entities/<Entity>.ts` patterns into `data/entities.ts` and fix the imports before regenerating the migration.
 
 3. **Did you apply the migration?**
    ```bash
    yarn db:migrate      # Applies pending migrations
    ```
-   Fix: Run `yarn db:migrate`.
+   Proposed fix: Run `yarn db:migrate`.
 
 4. **Is the migration file correct?**
    Check `src/modules/<module_id>/migrations/` for the latest migration.
    Verify it has the expected columns and types.
-   Fix: If wrong, delete the migration file, fix the entity, and regenerate.
+   Proposed fix: If wrong, delete the migration file, fix the entity, and regenerate.
 
 ### Migration generation creates unexpected changes
 
@@ -160,11 +182,11 @@ yarn typecheck
 
 2. **Did you modify a core module entity without ejecting?**
    Never edit `node_modules/@open-mercato/*`.
-   Fix: Revert changes to node_modules. Use UMES extensions instead, or eject the module.
+   Proposed fix: Revert changes to node_modules. Use UMES extensions instead, or eject the module.
 
 3. **Is a module snapshot stale?**
    Check whether the generated SQL recreates a table or column that already has a committed migration.
-   Fix: update that module's `migrations/.snapshot-open-mercato.json` to include the already-migrated schema, then re-run `yarn db:generate` and expect `no changes`.
+   Proposed fix: update that module's `migrations/.snapshot-open-mercato.json` to include the already-migrated schema, then re-run `yarn db:generate` and expect `no changes`.
 
 ### Entity changes not reflected
 
@@ -443,9 +465,10 @@ yarn dev               # 5. Restart dev server
 
 ## Rules
 
-- **ALWAYS** run `yarn generate` as first diagnostic step
+- **ALWAYS** present the diagnosed root cause and the proposed fix (commands/code), then **wait for explicit user confirmation before applying any mutating change** (see [Step 4](#step-4-propose-before-fixing)). Only read-only diagnostics may run without asking.
 - **ALWAYS** check server logs / browser console for actual error messages
 - **NEVER** edit files in `.mercato/generated/` or `node_modules/`
 - **NEVER** assume the issue — verify with actual error output
+- Treat `yarn generate` as the most likely first fix, but propose it before running — it regenerates files and is a mutating action
 - Fix the root cause, not the symptom — temporary workarounds become permanent bugs
-- When suggesting a fix, include the exact command or code change needed
+- When proposing a fix, include the exact command or code change needed

package/dist/lib/generators/extensions/ai-agents.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/lib/generators/extensions/ai-agents.ts"],
-  "sourcesContent": ["import { VariableDeclarationKind, type WriterFunction } from 'ts-morph'\nimport type { GeneratorExtension } from '../extension'\nimport {\n  arrayLiteral,\n  arrowFunction,\n  binaryExpression,\n  identifier,\n  methodCall,\n  objectLiteral,\n  parenthesized,\n  propertyAccess,\n  writeValue,\n} from '../ast'\nimport {\n  emptyArray,\n  emptyObject,\n  moduleEntry,\n  namespaceFallback,\n  namespaceImportSpec,\n  renderGeneratedTsSource,\n} from './shared'\n\n/**\n * Generator extension for `<module>/ai-agents.ts` files.\n *\n * Each module's `ai-agents.ts` may export both base agent contributions\n * (`aiAgents`), additive extensions for existing agents\n * (`aiAgentExtensions`), AND cross-module override declarations\n * (`aiAgentOverrides`). The generator scans the file once, emits the\n * configuration entry with all fields, and produces filtered\n * exports inside `ai-agents.generated.ts`:\n *\n *   - `aiAgentConfigEntries` (entries that declare base agents)\n *   - `aiAgentExtensionEntries` / `allAiAgentExtensions` (entries that append to agents)\n *   - `aiAgentOverrideEntries` (entries that declare overrides)\n *\n * The runtime (`@open-mercato/ai-assistant`) reads\n * `aiAgentConfigEntries` to populate the agent registry,\n * `aiAgentOverrideEntries` to apply cross-module replacements, and\n * `allAiAgentExtensions` to append safe metadata after the base load. See spec\n * `.ai/specs/2026-04-30-ai-overrides-and-module-disable.md`.\n */\nexport function createAiAgentsExtension(): GeneratorExtension {\n  const imports = [] as Array<ReturnType<typeof namespaceImportSpec>>\n  const entries: WriterFunction[] = []\n\n  return {\n    id: 'registry.ai-agents',\n    outputFiles: ['ai-agents.generated.ts'],\n    scanModule(ctx) {\n      ctx.processStandaloneConfig({\n        roots: ctx.roots,\n        imps: ctx.imps,\n        modId: ctx.moduleId,\n        relativePath: 'ai-agents.ts',\n        prefix: 'AI_AGENTS',\n        importIdRef: ctx.importIdRef,\n        standaloneImports: imports,\n        standaloneEntries: entries,\n        writeConfig: ({ importName, moduleId }) =>\n          moduleEntry(moduleId, [\n            {\n              name: 'agents',\n              value: namespaceFallback({\n                importName,\n                members: ['aiAgents', 'default'],\n                fallback: emptyArray(),\n                castType: 'unknown[]',\n              }),\n            },\n            {\n              name: 'overrides',\n              value: namespaceFallback({\n                importName,\n                members: ['aiAgentOverrides'],\n                fallback: emptyObject(),\n                castType: 'Record<string, unknown>',\n              }),\n            },\n            {\n              name: 'extensions',\n              value: namespaceFallback({\n                importName,\n                members: ['aiAgentExtensions'],\n                fallback: emptyArray(),\n                castType: 'unknown[]',\n              }),\n            },\n          ]),\n      })\n    },\n    generateOutput() {\n      const output = renderGeneratedTsSource({\n        fileName: 'ai-agents.generated.ts',\n        imports,\n        build(sourceFile) {\n          sourceFile.addTypeAlias({\n            name: 'AiAgentConfigEntry',\n            type: '{ moduleId: string; agents: unknown[]; overrides: Record<string, unknown>; extensions: unknown[] }',\n          })\n          sourceFile.addTypeAlias({\n            name: 'AiAgentOverrideConfigEntry',\n            type: '{ moduleId: string; overrides: Record<string, unknown> }',\n          })\n          sourceFile.addTypeAlias({\n            name: 'AiAgentExtensionConfigEntry',\n            type: '{ moduleId: string; extensions: unknown[] }',\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            declarations: [\n              {\n                name: 'aiAgentConfigEntriesRaw',\n                type: 'AiAgentConfigEntry[]',\n                initializer: arrayLiteral(entries, writeValue),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'aiAgentConfigEntries',\n                type: 'AiAgentConfigEntry[]',\n                initializer: methodCall(identifier('aiAgentConfigEntriesRaw'), 'filter', [\n                  arrowFunction({\n                    parameters: ['entry'],\n                    body: binaryExpression(propertyAccess(propertyAccess(identifier('entry'), 'agents'), 'length'), '>', 0),\n                  }),\n                ]),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'aiAgentExtensionEntries',\n                type: 'AiAgentExtensionConfigEntry[]',\n                initializer: methodCall(\n                  methodCall(identifier('aiAgentConfigEntriesRaw'), 'filter', [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: binaryExpression(propertyAccess(propertyAccess(identifier('entry'), 'extensions'), 'length'), '>', 0),\n                    }),\n                  ]),\n                  'map',\n                  [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: parenthesized(\n                        objectLiteral([\n                          { name: 'moduleId', value: propertyAccess(identifier('entry'), 'moduleId') },\n                          { name: 'extensions', value: propertyAccess(identifier('entry'), 'extensions') },\n                        ]),\n                      ),\n                    }),\n                  ],\n                ),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'allAiAgentExtensions',\n                initializer: methodCall(identifier('aiAgentExtensionEntries'), 'flatMap', [\n                  arrowFunction({\n                    parameters: ['entry'],\n                    body: propertyAccess(identifier('entry'), 'extensions'),\n                  }),\n                ]),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'allAiAgents',\n                initializer: methodCall(identifier('aiAgentConfigEntries'), 'flatMap', [\n                  arrowFunction({\n                    parameters: ['entry'],\n                    body: propertyAccess(identifier('entry'), 'agents'),\n                  }),\n                ]),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'aiAgentOverrideEntries',\n                type: 'AiAgentOverrideConfigEntry[]',\n                initializer: methodCall(\n                  methodCall(identifier('aiAgentConfigEntriesRaw'), 'filter', [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: binaryExpression(\n                        propertyAccess(\n                          methodCall(identifier('Object'), 'keys', [\n                            propertyAccess(identifier('entry'), 'overrides'),\n                          ]),\n                          'length',\n                        ),\n                        '>',\n                        0,\n                      ),\n                    }),\n                  ]),\n                  'map',\n                  [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: parenthesized(\n                        objectLiteral([\n                          { name: 'moduleId', value: propertyAccess(identifier('entry'), 'moduleId') },\n                          { name: 'overrides', value: propertyAccess(identifier('entry'), 'overrides') },\n                        ]),\n                      ),\n                    }),\n                  ],\n                ),\n              },\n            ],\n          })\n        },\n      })\n\n      return new Map([['ai-agents.generated.ts', output]])\n    },\n  }\n}\n"],
+  "sourcesContent": ["import { VariableDeclarationKind, type WriterFunction } from 'ts-morph'\nimport type { GeneratorExtension } from '../extension'\nimport {\n  arrayLiteral,\n  arrowFunction,\n  binaryExpression,\n  identifier,\n  methodCall,\n  objectLiteral,\n  parenthesized,\n  propertyAccess,\n  writeValue,\n} from '../ast'\nimport {\n  emptyArray,\n  emptyObject,\n  moduleEntry,\n  namespaceFallback,\n  namespaceImportSpec,\n  renderGeneratedTsSource,\n} from './shared'\n\n/**\n * Generator extension for `<module>/ai-agents.ts` files.\n *\n * Each module's `ai-agents.ts` may export both base agent contributions\n * (`aiAgents`), additive extensions for existing agents\n * (`aiAgentExtensions`), AND cross-module override declarations\n * (`aiAgentOverrides`). The generator scans the file once, emits the\n * configuration entry with all fields, and produces filtered\n * exports inside `ai-agents.generated.ts`:\n *\n *   - `aiAgentConfigEntries` (entries that declare base agents)\n *   - `aiAgentExtensionEntries` / `allAiAgentExtensions` (entries that append to agents)\n *   - `aiAgentOverrideEntries` (entries that declare overrides)\n *\n * The runtime (`@open-mercato/ai-assistant`) reads\n * `aiAgentConfigEntries` to populate the agent registry,\n * `aiAgentOverrideEntries` to apply cross-module replacements, and\n * `allAiAgentExtensions` to append safe metadata after the base load. See spec\n * `.ai/specs/implemented/2026-04-30-ai-overrides-and-module-disable.md`.\n */\nexport function createAiAgentsExtension(): GeneratorExtension {\n  const imports = [] as Array<ReturnType<typeof namespaceImportSpec>>\n  const entries: WriterFunction[] = []\n\n  return {\n    id: 'registry.ai-agents',\n    outputFiles: ['ai-agents.generated.ts'],\n    scanModule(ctx) {\n      ctx.processStandaloneConfig({\n        roots: ctx.roots,\n        imps: ctx.imps,\n        modId: ctx.moduleId,\n        relativePath: 'ai-agents.ts',\n        prefix: 'AI_AGENTS',\n        importIdRef: ctx.importIdRef,\n        standaloneImports: imports,\n        standaloneEntries: entries,\n        writeConfig: ({ importName, moduleId }) =>\n          moduleEntry(moduleId, [\n            {\n              name: 'agents',\n              value: namespaceFallback({\n                importName,\n                members: ['aiAgents', 'default'],\n                fallback: emptyArray(),\n                castType: 'unknown[]',\n              }),\n            },\n            {\n              name: 'overrides',\n              value: namespaceFallback({\n                importName,\n                members: ['aiAgentOverrides'],\n                fallback: emptyObject(),\n                castType: 'Record<string, unknown>',\n              }),\n            },\n            {\n              name: 'extensions',\n              value: namespaceFallback({\n                importName,\n                members: ['aiAgentExtensions'],\n                fallback: emptyArray(),\n                castType: 'unknown[]',\n              }),\n            },\n          ]),\n      })\n    },\n    generateOutput() {\n      const output = renderGeneratedTsSource({\n        fileName: 'ai-agents.generated.ts',\n        imports,\n        build(sourceFile) {\n          sourceFile.addTypeAlias({\n            name: 'AiAgentConfigEntry',\n            type: '{ moduleId: string; agents: unknown[]; overrides: Record<string, unknown>; extensions: unknown[] }',\n          })\n          sourceFile.addTypeAlias({\n            name: 'AiAgentOverrideConfigEntry',\n            type: '{ moduleId: string; overrides: Record<string, unknown> }',\n          })\n          sourceFile.addTypeAlias({\n            name: 'AiAgentExtensionConfigEntry',\n            type: '{ moduleId: string; extensions: unknown[] }',\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            declarations: [\n              {\n                name: 'aiAgentConfigEntriesRaw',\n                type: 'AiAgentConfigEntry[]',\n                initializer: arrayLiteral(entries, writeValue),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'aiAgentConfigEntries',\n                type: 'AiAgentConfigEntry[]',\n                initializer: methodCall(identifier('aiAgentConfigEntriesRaw'), 'filter', [\n                  arrowFunction({\n                    parameters: ['entry'],\n                    body: binaryExpression(propertyAccess(propertyAccess(identifier('entry'), 'agents'), 'length'), '>', 0),\n                  }),\n                ]),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'aiAgentExtensionEntries',\n                type: 'AiAgentExtensionConfigEntry[]',\n                initializer: methodCall(\n                  methodCall(identifier('aiAgentConfigEntriesRaw'), 'filter', [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: binaryExpression(propertyAccess(propertyAccess(identifier('entry'), 'extensions'), 'length'), '>', 0),\n                    }),\n                  ]),\n                  'map',\n                  [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: parenthesized(\n                        objectLiteral([\n                          { name: 'moduleId', value: propertyAccess(identifier('entry'), 'moduleId') },\n                          { name: 'extensions', value: propertyAccess(identifier('entry'), 'extensions') },\n                        ]),\n                      ),\n                    }),\n                  ],\n                ),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'allAiAgentExtensions',\n                initializer: methodCall(identifier('aiAgentExtensionEntries'), 'flatMap', [\n                  arrowFunction({\n                    parameters: ['entry'],\n                    body: propertyAccess(identifier('entry'), 'extensions'),\n                  }),\n                ]),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'allAiAgents',\n                initializer: methodCall(identifier('aiAgentConfigEntries'), 'flatMap', [\n                  arrowFunction({\n                    parameters: ['entry'],\n                    body: propertyAccess(identifier('entry'), 'agents'),\n                  }),\n                ]),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'aiAgentOverrideEntries',\n                type: 'AiAgentOverrideConfigEntry[]',\n                initializer: methodCall(\n                  methodCall(identifier('aiAgentConfigEntriesRaw'), 'filter', [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: binaryExpression(\n                        propertyAccess(\n                          methodCall(identifier('Object'), 'keys', [\n                            propertyAccess(identifier('entry'), 'overrides'),\n                          ]),\n                          'length',\n                        ),\n                        '>',\n                        0,\n                      ),\n                    }),\n                  ]),\n                  'map',\n                  [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: parenthesized(\n                        objectLiteral([\n                          { name: 'moduleId', value: propertyAccess(identifier('entry'), 'moduleId') },\n                          { name: 'overrides', value: propertyAccess(identifier('entry'), 'overrides') },\n                        ]),\n                      ),\n                    }),\n                  ],\n                ),\n              },\n            ],\n          })\n        },\n      })\n\n      return new Map([['ai-agents.generated.ts', output]])\n    },\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/lib/generators/extensions/ai-tools.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/lib/generators/extensions/ai-tools.ts"],
-  "sourcesContent": ["import { VariableDeclarationKind, type WriterFunction } from 'ts-morph'\nimport type { GeneratorExtension } from '../extension'\nimport {\n  arrayLiteral,\n  arrowFunction,\n  binaryExpression,\n  identifier,\n  methodCall,\n  objectLiteral,\n  parenthesized,\n  propertyAccess,\n  writeValue,\n} from '../ast'\nimport {\n  emptyArray,\n  emptyObject,\n  moduleEntry,\n  namespaceFallback,\n  namespaceImportSpec,\n  renderGeneratedTsSource,\n} from './shared'\n\n/**\n * Generator extension for `<module>/ai-tools.ts` files.\n *\n * Each module's `ai-tools.ts` may export both base tool contributions\n * (`aiTools`) AND cross-module override declarations (`aiToolOverrides`).\n * The generator scans the file once and emits two filtered exports\n * inside `ai-tools.generated.ts`:\n *\n *   - `aiToolConfigEntries` (entries that declare base tools)\n *   - `aiToolOverrideEntries` (entries that declare overrides)\n *\n * The runtime (`@open-mercato/ai-assistant`) reads `aiToolConfigEntries`\n * to populate the tool registry and `aiToolOverrideEntries` to apply\n * cross-module replacements after the base load. See spec\n * `.ai/specs/2026-04-30-ai-overrides-and-module-disable.md`.\n */\nexport function createAiToolsExtension(): GeneratorExtension {\n  const imports = [] as Array<ReturnType<typeof namespaceImportSpec>>\n  const entries: WriterFunction[] = []\n\n  return {\n    id: 'registry.ai-tools',\n    outputFiles: ['ai-tools.generated.ts'],\n    scanModule(ctx) {\n      ctx.processStandaloneConfig({\n        roots: ctx.roots,\n        imps: ctx.imps,\n        modId: ctx.moduleId,\n        relativePath: 'ai-tools.ts',\n        prefix: 'AI_TOOLS',\n        importIdRef: ctx.importIdRef,\n        standaloneImports: imports,\n        standaloneEntries: entries,\n        writeConfig: ({ importName, moduleId }) =>\n          moduleEntry(moduleId, [\n            {\n              name: 'tools',\n              value: namespaceFallback({\n                importName,\n                members: ['aiTools', 'default'],\n                fallback: emptyArray(),\n                castType: 'unknown[]',\n              }),\n            },\n            {\n              name: 'overrides',\n              value: namespaceFallback({\n                importName,\n                members: ['aiToolOverrides'],\n                fallback: emptyObject(),\n                castType: 'Record<string, unknown>',\n              }),\n            },\n          ]),\n      })\n    },\n    generateOutput() {\n      const output = renderGeneratedTsSource({\n        fileName: 'ai-tools.generated.ts',\n        imports,\n        build(sourceFile) {\n          sourceFile.addTypeAlias({\n            name: 'AiToolConfigEntry',\n            type: '{ moduleId: string; tools: unknown[]; overrides: Record<string, unknown> }',\n          })\n          sourceFile.addTypeAlias({\n            name: 'AiToolOverrideConfigEntry',\n            type: '{ moduleId: string; overrides: Record<string, unknown> }',\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            declarations: [\n              {\n                name: 'aiToolConfigEntriesRaw',\n                type: 'AiToolConfigEntry[]',\n                initializer: arrayLiteral(entries, writeValue),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'aiToolConfigEntries',\n                type: 'AiToolConfigEntry[]',\n                initializer: methodCall(identifier('aiToolConfigEntriesRaw'), 'filter', [\n                  arrowFunction({\n                    parameters: ['entry'],\n                    body: binaryExpression(propertyAccess(propertyAccess(identifier('entry'), 'tools'), 'length'), '>', 0),\n                  }),\n                ]),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'allAiTools',\n                initializer: methodCall(identifier('aiToolConfigEntries'), 'flatMap', [\n                  arrowFunction({\n                    parameters: ['entry'],\n                    body: propertyAccess(identifier('entry'), 'tools'),\n                  }),\n                ]),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'aiToolOverrideEntries',\n                type: 'AiToolOverrideConfigEntry[]',\n                initializer: methodCall(\n                  methodCall(identifier('aiToolConfigEntriesRaw'), 'filter', [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: binaryExpression(\n                        propertyAccess(\n                          methodCall(identifier('Object'), 'keys', [\n                            propertyAccess(identifier('entry'), 'overrides'),\n                          ]),\n                          'length',\n                        ),\n                        '>',\n                        0,\n                      ),\n                    }),\n                  ]),\n                  'map',\n                  [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: parenthesized(\n                        objectLiteral([\n                          { name: 'moduleId', value: propertyAccess(identifier('entry'), 'moduleId') },\n                          { name: 'overrides', value: propertyAccess(identifier('entry'), 'overrides') },\n                        ]),\n                      ),\n                    }),\n                  ],\n                ),\n              },\n            ],\n          })\n        },\n      })\n\n      return new Map([['ai-tools.generated.ts', output]])\n    },\n  }\n}\n"],
+  "sourcesContent": ["import { VariableDeclarationKind, type WriterFunction } from 'ts-morph'\nimport type { GeneratorExtension } from '../extension'\nimport {\n  arrayLiteral,\n  arrowFunction,\n  binaryExpression,\n  identifier,\n  methodCall,\n  objectLiteral,\n  parenthesized,\n  propertyAccess,\n  writeValue,\n} from '../ast'\nimport {\n  emptyArray,\n  emptyObject,\n  moduleEntry,\n  namespaceFallback,\n  namespaceImportSpec,\n  renderGeneratedTsSource,\n} from './shared'\n\n/**\n * Generator extension for `<module>/ai-tools.ts` files.\n *\n * Each module's `ai-tools.ts` may export both base tool contributions\n * (`aiTools`) AND cross-module override declarations (`aiToolOverrides`).\n * The generator scans the file once and emits two filtered exports\n * inside `ai-tools.generated.ts`:\n *\n *   - `aiToolConfigEntries` (entries that declare base tools)\n *   - `aiToolOverrideEntries` (entries that declare overrides)\n *\n * The runtime (`@open-mercato/ai-assistant`) reads `aiToolConfigEntries`\n * to populate the tool registry and `aiToolOverrideEntries` to apply\n * cross-module replacements after the base load. See spec\n * `.ai/specs/implemented/2026-04-30-ai-overrides-and-module-disable.md`.\n */\nexport function createAiToolsExtension(): GeneratorExtension {\n  const imports = [] as Array<ReturnType<typeof namespaceImportSpec>>\n  const entries: WriterFunction[] = []\n\n  return {\n    id: 'registry.ai-tools',\n    outputFiles: ['ai-tools.generated.ts'],\n    scanModule(ctx) {\n      ctx.processStandaloneConfig({\n        roots: ctx.roots,\n        imps: ctx.imps,\n        modId: ctx.moduleId,\n        relativePath: 'ai-tools.ts',\n        prefix: 'AI_TOOLS',\n        importIdRef: ctx.importIdRef,\n        standaloneImports: imports,\n        standaloneEntries: entries,\n        writeConfig: ({ importName, moduleId }) =>\n          moduleEntry(moduleId, [\n            {\n              name: 'tools',\n              value: namespaceFallback({\n                importName,\n                members: ['aiTools', 'default'],\n                fallback: emptyArray(),\n                castType: 'unknown[]',\n              }),\n            },\n            {\n              name: 'overrides',\n              value: namespaceFallback({\n                importName,\n                members: ['aiToolOverrides'],\n                fallback: emptyObject(),\n                castType: 'Record<string, unknown>',\n              }),\n            },\n          ]),\n      })\n    },\n    generateOutput() {\n      const output = renderGeneratedTsSource({\n        fileName: 'ai-tools.generated.ts',\n        imports,\n        build(sourceFile) {\n          sourceFile.addTypeAlias({\n            name: 'AiToolConfigEntry',\n            type: '{ moduleId: string; tools: unknown[]; overrides: Record<string, unknown> }',\n          })\n          sourceFile.addTypeAlias({\n            name: 'AiToolOverrideConfigEntry',\n            type: '{ moduleId: string; overrides: Record<string, unknown> }',\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            declarations: [\n              {\n                name: 'aiToolConfigEntriesRaw',\n                type: 'AiToolConfigEntry[]',\n                initializer: arrayLiteral(entries, writeValue),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'aiToolConfigEntries',\n                type: 'AiToolConfigEntry[]',\n                initializer: methodCall(identifier('aiToolConfigEntriesRaw'), 'filter', [\n                  arrowFunction({\n                    parameters: ['entry'],\n                    body: binaryExpression(propertyAccess(propertyAccess(identifier('entry'), 'tools'), 'length'), '>', 0),\n                  }),\n                ]),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'allAiTools',\n                initializer: methodCall(identifier('aiToolConfigEntries'), 'flatMap', [\n                  arrowFunction({\n                    parameters: ['entry'],\n                    body: propertyAccess(identifier('entry'), 'tools'),\n                  }),\n                ]),\n              },\n            ],\n          })\n          sourceFile.addVariableStatement({\n            declarationKind: VariableDeclarationKind.Const,\n            isExported: true,\n            declarations: [\n              {\n                name: 'aiToolOverrideEntries',\n                type: 'AiToolOverrideConfigEntry[]',\n                initializer: methodCall(\n                  methodCall(identifier('aiToolConfigEntriesRaw'), 'filter', [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: binaryExpression(\n                        propertyAccess(\n                          methodCall(identifier('Object'), 'keys', [\n                            propertyAccess(identifier('entry'), 'overrides'),\n                          ]),\n                          'length',\n                        ),\n                        '>',\n                        0,\n                      ),\n                    }),\n                  ]),\n                  'map',\n                  [\n                    arrowFunction({\n                      parameters: ['entry'],\n                      body: parenthesized(\n                        objectLiteral([\n                          { name: 'moduleId', value: propertyAccess(identifier('entry'), 'moduleId') },\n                          { name: 'overrides', value: propertyAccess(identifier('entry'), 'overrides') },\n                        ]),\n                      ),\n                    }),\n                  ],\n                ),\n              },\n            ],\n          })\n        },\n      })\n\n      return new Map([['ai-tools.generated.ts', output]])\n    },\n  }\n}\n"],
   "mappings": "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",
   "names": []
 }

package/dist/lib/single-instance-strategy-guard.js

@@ -0,0 +1,89 @@
+import { parseBooleanWithDefault } from "@open-mercato/shared/lib/boolean";
+import { resolveQueueStrategy } from "@open-mercato/queue";
+const MULTI_INSTANCE_SAFE_STRATEGIES = {
+  cache: ["redis"],
+  queue: ["async"],
+  rateLimit: ["redis"]
+};
+const COMPONENT_ENV_VARS = {
+  cache: "CACHE_STRATEGY",
+  queue: "QUEUE_STRATEGY",
+  rateLimit: "RATE_LIMIT_STRATEGY"
+};
+class SingleInstanceStrategyError extends Error {
+  constructor(result) {
+    super(
+      `Refusing to start: single-instance infrastructure strategies (${result.offenders.map((offender) => `${offender.envVar}=${offender.configured}`).join(", ")}) are configured under a declared multi-instance topology. Switch to a multi-instance-safe strategy or set OM_ALLOW_SINGLE_INSTANCE_STRATEGIES=1 to override.`
+    );
+    this.name = "SingleInstanceStrategyError";
+    this.offenders = result.offenders;
+  }
+}
+function readInfraStrategySnapshot(env = process.env) {
+  return {
+    cacheStrategy: env.CACHE_STRATEGY?.trim() || "memory",
+    queueStrategy: resolveQueueStrategy(),
+    rateLimitStrategy: env.RATE_LIMIT_STRATEGY?.trim() || "memory"
+  };
+}
+function resolveMultiInstanceHint(env) {
+  if (parseBooleanWithDefault(env.OM_MULTI_INSTANCE, false)) return true;
+  const instanceCount = Number.parseInt(env.OM_INSTANCE_COUNT ?? "", 10);
+  return Number.isFinite(instanceCount) && instanceCount > 1;
+}
+function evaluateSingleInstanceGuard(snapshot, env = process.env) {
+  const configured = {
+    cache: snapshot.cacheStrategy,
+    queue: snapshot.queueStrategy,
+    rateLimit: snapshot.rateLimitStrategy
+  };
+  const offenders = [];
+  for (const component of Object.keys(configured)) {
+    const safeValues = MULTI_INSTANCE_SAFE_STRATEGIES[component];
+    if (!safeValues.includes(configured[component])) {
+      offenders.push({
+        component,
+        envVar: COMPONENT_ENV_VARS[component],
+        configured: configured[component],
+        safeValues
+      });
+    }
+  }
+  const production = (env.NODE_ENV ?? "").trim() === "production";
+  const multiInstance = resolveMultiInstanceHint(env);
+  const overridden = parseBooleanWithDefault(env.OM_ALLOW_SINGLE_INSTANCE_STRATEGIES, false);
+  let action = "ok";
+  if (offenders.length > 0 && production) {
+    action = multiInstance && !overridden ? "fail" : "warn";
+  }
+  return { action, offenders, production, multiInstance, overridden };
+}
+function formatSingleInstanceGuardMessage(result) {
+  const offenderLines = result.offenders.map(
+    (offender) => `  - ${offender.envVar}=${offender.configured} (multi-instance-safe: ${offender.safeValues.join(", ")})`
+  );
+  const header = result.action === "fail" ? "[server] Refusing to start: single-instance infrastructure strategies under a multi-instance topology." : "[server] WARNING: single-instance infrastructure strategies detected in production.";
+  const guidance = result.action === "fail" ? "[server] Switch each strategy above to a multi-instance-safe value, or set OM_ALLOW_SINGLE_INSTANCE_STRATEGIES=1 to override (accepting duplicate jobs, stale ACLs, and weakened rate limits)." : result.multiInstance ? "[server] OM_ALLOW_SINGLE_INSTANCE_STRATEGIES=1 is set \u2014 proceeding despite the risks above (duplicate jobs, stale ACLs, weakened rate limits)." : "[server] Running multiple instances against these strategies will cause duplicate jobs, stale ACLs, and weakened rate limits. Set OM_MULTI_INSTANCE=1 to make this a hard failure once you scale out.";
+  return [header, ...offenderLines, guidance];
+}
+function assertSingleInstanceStrategies(env = process.env, options) {
+  const snapshot = options?.snapshot ?? readInfraStrategySnapshot(env);
+  const result = evaluateSingleInstanceGuard(snapshot, env);
+  const logger = options?.logger ?? console;
+  if (result.action === "fail") {
+    for (const line of formatSingleInstanceGuardMessage(result)) logger.error(line);
+    throw new SingleInstanceStrategyError(result);
+  }
+  if (result.action === "warn") {
+    for (const line of formatSingleInstanceGuardMessage(result)) logger.warn(line);
+  }
+  return result;
+}
+export {
+  SingleInstanceStrategyError,
+  assertSingleInstanceStrategies,
+  evaluateSingleInstanceGuard,
+  formatSingleInstanceGuardMessage,
+  readInfraStrategySnapshot
+};
+//# sourceMappingURL=single-instance-strategy-guard.js.map

package/dist/lib/single-instance-strategy-guard.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/lib/single-instance-strategy-guard.ts"],
+  "sourcesContent": ["import { parseBooleanWithDefault } from '@open-mercato/shared/lib/boolean'\nimport { resolveQueueStrategy } from '@open-mercato/queue'\n\n/**\n * Boot-time guard that refuses to start (or warns) when an infrastructure\n * strategy that is only safe for a single process/instance is configured under\n * a declared multi-instance topology.\n *\n * Background: `CACHE_STRATEGY`, `RATE_LIMIT_STRATEGY` and `QUEUE_STRATEGY` all\n * default to single-instance modes (`memory`/`memory`/`local`). Running more\n * than one app instance against those defaults silently breaks three\n * correctness invariants at once \u2014 stale RBAC caches after a privilege\n * revocation, rate limits multiplied by the instance count, and duplicate job\n * processing from the leaderless local file queue. None of them warn.\n *\n * Only strategies that coordinate across processes via shared external state\n * are considered multi-instance safe. Everything else (the in-process memory\n * strategies, the local file queue, and disk-backed caches that are not shared\n * across hosts) is treated as single-instance.\n */\nconst MULTI_INSTANCE_SAFE_STRATEGIES = {\n  cache: ['redis'],\n  queue: ['async'],\n  rateLimit: ['redis'],\n} as const\n\nexport type SingleInstanceGuardComponent = 'cache' | 'queue' | 'rateLimit'\n\nexport type SingleInstanceGuardOffender = {\n  component: SingleInstanceGuardComponent\n  envVar: string\n  configured: string\n  safeValues: readonly string[]\n}\n\nexport type SingleInstanceGuardAction = 'ok' | 'warn' | 'fail'\n\nexport type SingleInstanceGuardResult = {\n  action: SingleInstanceGuardAction\n  offenders: SingleInstanceGuardOffender[]\n  production: boolean\n  multiInstance: boolean\n  overridden: boolean\n}\n\nexport type InfraStrategySnapshot = {\n  cacheStrategy: string\n  queueStrategy: string\n  rateLimitStrategy: string\n}\n\nconst COMPONENT_ENV_VARS: Record<SingleInstanceGuardComponent, string> = {\n  cache: 'CACHE_STRATEGY',\n  queue: 'QUEUE_STRATEGY',\n  rateLimit: 'RATE_LIMIT_STRATEGY',\n}\n\nexport class SingleInstanceStrategyError extends Error {\n  readonly offenders: SingleInstanceGuardOffender[]\n\n  constructor(result: SingleInstanceGuardResult) {\n    super(\n      `Refusing to start: single-instance infrastructure strategies (${result.offenders\n        .map((offender) => `${offender.envVar}=${offender.configured}`)\n        .join(', ')}) are configured under a declared multi-instance topology. ` +\n        'Switch to a multi-instance-safe strategy or set OM_ALLOW_SINGLE_INSTANCE_STRATEGIES=1 to override.',\n    )\n    this.name = 'SingleInstanceStrategyError'\n    this.offenders = result.offenders\n  }\n}\n\n/**\n * Read the configured infrastructure strategies. Queue resolution reuses the\n * canonical `resolveQueueStrategy()` so the default stays single-sourced; cache\n * and rate-limit values are read directly with their documented defaults\n * (`packages/cache/src/service.ts`, `packages/shared/src/lib/ratelimit/config.ts`)\n * because the guard's safe-set policy \u2014 not the resolver default \u2014 decides what\n * counts as single-instance.\n */\nexport function readInfraStrategySnapshot(env: NodeJS.ProcessEnv = process.env): InfraStrategySnapshot {\n  return {\n    cacheStrategy: env.CACHE_STRATEGY?.trim() || 'memory',\n    queueStrategy: resolveQueueStrategy(),\n    rateLimitStrategy: env.RATE_LIMIT_STRATEGY?.trim() || 'memory',\n  }\n}\n\nfunction resolveMultiInstanceHint(env: NodeJS.ProcessEnv): boolean {\n  if (parseBooleanWithDefault(env.OM_MULTI_INSTANCE, false)) return true\n  const instanceCount = Number.parseInt(env.OM_INSTANCE_COUNT ?? '', 10)\n  return Number.isFinite(instanceCount) && instanceCount > 1\n}\n\nexport function evaluateSingleInstanceGuard(\n  snapshot: InfraStrategySnapshot,\n  env: NodeJS.ProcessEnv = process.env,\n): SingleInstanceGuardResult {\n  const configured: Record<SingleInstanceGuardComponent, string> = {\n    cache: snapshot.cacheStrategy,\n    queue: snapshot.queueStrategy,\n    rateLimit: snapshot.rateLimitStrategy,\n  }\n\n  const offenders: SingleInstanceGuardOffender[] = []\n  for (const component of Object.keys(configured) as SingleInstanceGuardComponent[]) {\n    const safeValues: readonly string[] = MULTI_INSTANCE_SAFE_STRATEGIES[component]\n    if (!safeValues.includes(configured[component])) {\n      offenders.push({\n        component,\n        envVar: COMPONENT_ENV_VARS[component],\n        configured: configured[component],\n        safeValues,\n      })\n    }\n  }\n\n  const production = (env.NODE_ENV ?? '').trim() === 'production'\n  const multiInstance = resolveMultiInstanceHint(env)\n  const overridden = parseBooleanWithDefault(env.OM_ALLOW_SINGLE_INSTANCE_STRATEGIES, false)\n\n  let action: SingleInstanceGuardAction = 'ok'\n  if (offenders.length > 0 && production) {\n    action = multiInstance && !overridden ? 'fail' : 'warn'\n  }\n\n  return { action, offenders, production, multiInstance, overridden }\n}\n\nexport function formatSingleInstanceGuardMessage(result: SingleInstanceGuardResult): string[] {\n  const offenderLines = result.offenders.map(\n    (offender) =>\n      `  - ${offender.envVar}=${offender.configured} (multi-instance-safe: ${offender.safeValues.join(', ')})`,\n  )\n  const header =\n    result.action === 'fail'\n      ? '[server] Refusing to start: single-instance infrastructure strategies under a multi-instance topology.'\n      : '[server] WARNING: single-instance infrastructure strategies detected in production.'\n  const guidance =\n    result.action === 'fail'\n      ? '[server] Switch each strategy above to a multi-instance-safe value, or set OM_ALLOW_SINGLE_INSTANCE_STRATEGIES=1 to override (accepting duplicate jobs, stale ACLs, and weakened rate limits).'\n      : result.multiInstance\n        ? '[server] OM_ALLOW_SINGLE_INSTANCE_STRATEGIES=1 is set \u2014 proceeding despite the risks above (duplicate jobs, stale ACLs, weakened rate limits).'\n        : '[server] Running multiple instances against these strategies will cause duplicate jobs, stale ACLs, and weakened rate limits. Set OM_MULTI_INSTANCE=1 to make this a hard failure once you scale out.'\n  return [header, ...offenderLines, guidance]\n}\n\nexport type SingleInstanceGuardLogger = Pick<Console, 'warn' | 'error'>\n\n/**\n * Evaluate the guard and enforce it: throw on `fail`, log prominently on\n * `warn`, and stay silent on `ok`. Safe to call on every `start`; it never\n * fires for dev boots or single-instance production deployments.\n */\nexport function assertSingleInstanceStrategies(\n  env: NodeJS.ProcessEnv = process.env,\n  options?: { snapshot?: InfraStrategySnapshot; logger?: SingleInstanceGuardLogger },\n): SingleInstanceGuardResult {\n  const snapshot = options?.snapshot ?? readInfraStrategySnapshot(env)\n  const result = evaluateSingleInstanceGuard(snapshot, env)\n  const logger = options?.logger ?? console\n\n  if (result.action === 'fail') {\n    for (const line of formatSingleInstanceGuardMessage(result)) logger.error(line)\n    throw new SingleInstanceStrategyError(result)\n  }\n  if (result.action === 'warn') {\n    for (const line of formatSingleInstanceGuardMessage(result)) logger.warn(line)\n  }\n\n  return result\n}\n"],
+  "mappings": "AAAA,SAAS,+BAA+B;AACxC,SAAS,4BAA4B;AAmBrC,MAAM,iCAAiC;AAAA,EACrC,OAAO,CAAC,OAAO;AAAA,EACf,OAAO,CAAC,OAAO;AAAA,EACf,WAAW,CAAC,OAAO;AACrB;AA2BA,MAAM,qBAAmE;AAAA,EACvE,OAAO;AAAA,EACP,OAAO;AAAA,EACP,WAAW;AACb;AAEO,MAAM,oCAAoC,MAAM;AAAA,EAGrD,YAAY,QAAmC;AAC7C;AAAA,MACE,iEAAiE,OAAO,UACrE,IAAI,CAAC,aAAa,GAAG,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE,EAC7D,KAAK,IAAI,CAAC;AAAA,IAEf;AACA,SAAK,OAAO;AACZ,SAAK,YAAY,OAAO;AAAA,EAC1B;AACF;AAUO,SAAS,0BAA0B,MAAyB,QAAQ,KAA4B;AACrG,SAAO;AAAA,IACL,eAAe,IAAI,gBAAgB,KAAK,KAAK;AAAA,IAC7C,eAAe,qBAAqB;AAAA,IACpC,mBAAmB,IAAI,qBAAqB,KAAK,KAAK;AAAA,EACxD;AACF;AAEA,SAAS,yBAAyB,KAAiC;AACjE,MAAI,wBAAwB,IAAI,mBAAmB,KAAK,EAAG,QAAO;AAClE,QAAM,gBAAgB,OAAO,SAAS,IAAI,qBAAqB,IAAI,EAAE;AACrE,SAAO,OAAO,SAAS,aAAa,KAAK,gBAAgB;AAC3D;AAEO,SAAS,4BACd,UACA,MAAyB,QAAQ,KACN;AAC3B,QAAM,aAA2D;AAAA,IAC/D,OAAO,SAAS;AAAA,IAChB,OAAO,SAAS;AAAA,IAChB,WAAW,SAAS;AAAA,EACtB;AAEA,QAAM,YAA2C,CAAC;AAClD,aAAW,aAAa,OAAO,KAAK,UAAU,GAAqC;AACjF,UAAM,aAAgC,+BAA+B,SAAS;AAC9E,QAAI,CAAC,WAAW,SAAS,WAAW,SAAS,CAAC,GAAG;AAC/C,gBAAU,KAAK;AAAA,QACb;AAAA,QACA,QAAQ,mBAAmB,SAAS;AAAA,QACpC,YAAY,WAAW,SAAS;AAAA,QAChC;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AAEA,QAAM,cAAc,IAAI,YAAY,IAAI,KAAK,MAAM;AACnD,QAAM,gBAAgB,yBAAyB,GAAG;AAClD,QAAM,aAAa,wBAAwB,IAAI,qCAAqC,KAAK;AAEzF,MAAI,SAAoC;AACxC,MAAI,UAAU,SAAS,KAAK,YAAY;AACtC,aAAS,iBAAiB,CAAC,aAAa,SAAS;AAAA,EACnD;AAEA,SAAO,EAAE,QAAQ,WAAW,YAAY,eAAe,WAAW;AACpE;AAEO,SAAS,iCAAiC,QAA6C;AAC5F,QAAM,gBAAgB,OAAO,UAAU;AAAA,IACrC,CAAC,aACC,OAAO,SAAS,MAAM,IAAI,SAAS,UAAU,0BAA0B,SAAS,WAAW,KAAK,IAAI,CAAC;AAAA,EACzG;AACA,QAAM,SACJ,OAAO,WAAW,SACd,2GACA;AACN,QAAM,WACJ,OAAO,WAAW,SACd,mMACA,OAAO,gBACL,wJACA;AACR,SAAO,CAAC,QAAQ,GAAG,eAAe,QAAQ;AAC5C;AASO,SAAS,+BACd,MAAyB,QAAQ,KACjC,SAC2B;AAC3B,QAAM,WAAW,SAAS,YAAY,0BAA0B,GAAG;AACnE,QAAM,SAAS,4BAA4B,UAAU,GAAG;AACxD,QAAM,SAAS,SAAS,UAAU;AAElC,MAAI,OAAO,WAAW,QAAQ;AAC5B,eAAW,QAAQ,iCAAiC,MAAM,EAAG,QAAO,MAAM,IAAI;AAC9E,UAAM,IAAI,4BAA4B,MAAM;AAAA,EAC9C;AACA,MAAI,OAAO,WAAW,QAAQ;AAC5B,eAAW,QAAQ,iCAAiC,MAAM,EAAG,QAAO,KAAK,IAAI;AAAA,EAC/E;AAEA,SAAO;AACT;",
+  "names": []
+}

package/dist/lib/testing/integration.js

@@ -1,4 +1,3 @@
-import { GenericContainer } from "testcontainers";
 import { createServer } from "node:net";
 import { existsSync, readFileSync } from "node:fs";
 import { mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
@@ -2322,6 +2321,7 @@ async function startEphemeralEnvironment(options) {
     const databaseName = "mercato_test";
     const databaseUser = "mercato";
     const databasePassword = "secret";
+    const { GenericContainer } = await import("testcontainers");
     const databaseContainer = await new GenericContainer("postgres:16").withEnvironment({
       POSTGRES_DB: databaseName,
       POSTGRES_USER: databaseUser,