@open-mercato/cli 0.6.7-develop.6685.1.77c0a5591b → 0.6.7-develop.6687.1.46a258e592

package/dist/agentic/guides/module-system.md

@@ -1,130 +1,15 @@
-# Open Mercato Module System — Conceptual Guide
+# Module System Compatibility Router
 
-This is the **hand-written, conceptual** layer of the module guides. It explains how an Open Mercato module is structured and how to build or extend one — the timeless concepts that rarely change. It is framework-wide; it does **not** describe any single module's data.
+Use the concern guides below. This path remains only so older prompts and links do not load a stale module tutorial.
 
-## How the guides are layered
-
-- **Layer 1 — this file (`.ai/guides/module-system.md`):** conceptual and framework-wide. Module anatomy, auto-discovery, naming, the mandatory mechanisms, data-integrity rules, and the generate/migration workflow.
-- **Layer 2 — generated per-module fact-sheets (`.ai/guides/modules/<module>.md` + `.ai/guides/module-facts.json`):** the concrete **facts** for one module, extracted from its source — entity IDs, events, ACL features, API routes with per-method auth, DI service tokens, searchable entities, host extension tokens, notifications, and CLI commands. These are generated; never hand-write them here.
-- **Package guides (`.ai/guides/core.md`, `ui.md`, `shared.md`, …):** package-specific depth (patterns, helpers, deeper APIs).
-
-When you need a concrete fact about a specific module — which events it emits, its entity IDs, which feature gates a route — open that module's fact-sheet. Do not infer module facts from this conceptual guide.
-
-## Module anatomy
-
-Each module lives in `src/modules/<id>/` and is **auto-discovered**. The only registration is one entry in `src/modules.ts` (`{ id: '<id>', from: '@app' }`). Run `yarn generate` after adding or changing any auto-discovered file.
-
-```
-src/modules/<id>/
-├── index.ts                # Module metadata
-├── data/
-│   ├── entities.ts         # MikroORM entity classes (decorators from @mikro-orm/decorators/legacy)
-│   ├── validators.ts       # Zod validation schemas
-│   ├── extensions.ts       # Cross-module entity links (export `extensions`)
-│   └── enrichers.ts        # Response enrichers (export `enrichers`)
-├── api/
-│   ├── <resource>/route.ts # REST handlers (auto-discovered by method) + `metadata` + `openApi`
-│   └── interceptors.ts     # API route interception hooks (export `interceptors`)
-├── backend/                # Admin UI pages (auto-discovered) + paired `page.meta.ts`
-├── frontend/               # Public pages (auto-discovered); customer portal under `[orgSlug]/portal/`
-├── subscribers/            # Event handlers (export `metadata` + default handler)
-├── workers/                # Background jobs (export `metadata` + default handler)
-├── widgets/
-│   ├── injection/          # UI widgets injected into other modules
-│   ├── injection-table.ts  # Widget-to-slot mappings
-│   └── components.ts        # Component replacement/wrapper definitions (export `componentOverrides`)
-├── di.ts                   # Awilix DI registrations (export `register(container)`)
-├── acl.ts                  # Permission features (export `features`)
-├── setup.ts                # Tenant init, role features, seed data (export `setup`)
-├── events.ts               # Typed event declarations (export `eventsConfig`)
-├── search.ts               # Search indexing configuration (export `searchConfig`)
-├── ce.ts                   # Custom entities / custom field sets (export `entities`)
-├── translations.ts         # Translatable fields per entity
-├── notifications.ts        # Notification type definitions (export `notificationTypes`)
-└── encryption.ts           # Tenant data encryption maps for sensitive / GDPR fields
-```
-
-### Auto-discovery paths
-
-| Path pattern | Becomes |
-|---|---|
-| `frontend/<path>.tsx` | `/<path>` (public page) |
-| `frontend/[orgSlug]/portal/<path>/page.tsx` | `/{orgSlug}/portal/<path>` (customer portal page; `[orgSlug]` MUST be first) |
-| `backend/<path>.tsx` | `/backend/<path>` (admin page) |
-| `backend/page.tsx` | `/backend/<module>` (module root page) |
-| `api/<method>/<path>.ts` | `/api/<path>` dispatched by HTTP method |
-| `subscribers/*.ts` | event subscriber (export `metadata` + default handler) |
-| `workers/*.ts` | background worker (export `metadata` + default handler) |
-
-### Convention-file reference
-
-| File | Export | Purpose |
-|------|--------|---------|
-| `index.ts` | `metadata` | Module metadata |
-| `di.ts` | `register(container)` | DI registrations (Awilix) |
-| `acl.ts` | `features` | Permission features (`['mod.view', 'mod.manage', …]`) |
-| `setup.ts` | `setup` | Tenant init, default role features, seed data |
-| `ce.ts` | `entities` | Custom entities / custom field sets |
-| `events.ts` | `eventsConfig` | Typed event declarations (`createModuleEvents`) |
-| `search.ts` | `searchConfig` | Search indexing config |
-| `translations.ts` | `translatableFields` | Translatable fields per entity |
-| `notifications.ts` | `notificationTypes` | Notification type definitions |
-| `data/entities.ts` | — | MikroORM entity classes |
-| `data/validators.ts` | — | Zod validation schemas |
-| `data/extensions.ts` | `extensions` | Entity extensions (cross-module links) |
-| `data/enrichers.ts` | `enrichers` | Response enrichers |
-| `api/interceptors.ts` | `interceptors` | API route interception hooks |
-| `widgets/components.ts` | `componentOverrides` | Component replacement/wrapper definitions |
-
-## Naming conventions
-
-- **Module IDs:** plural, snake_case (`order_items`). Special cases: `auth`, `example`.
-- **Event IDs:** `module.entity.action` (singular entity, past-tense action, e.g. `sales.order.created`).
-- **Entity IDs:** colon form `module:entity` (e.g. `customers:customer_person_profile`) — the canonical interop token, **not** the raw class name and **not** the dotted friendly alias some enrichers use.
-- **DB tables:** plural, snake_case with a module prefix (`catalog_products`).
-- **DB columns:** snake_case (`created_at`, `organization_id`). Common columns: `id`, `created_at`, `updated_at`, `deleted_at`, `is_active`, `organization_id`, `tenant_id`.
-- **Feature IDs:** `<module>.<action>` (`my_module.view`, `my_module.manage`). FROZEN once shipped — rename by adding the new ID alongside and keeping the old as a deprecated alias.
-- **JS/TS identifiers:** camelCase. UUID primary keys, explicit foreign keys, junction tables for M2M.
-
-## Mandatory module mechanisms
-
-The framework provides **one canonical primitive per concern**. Do not invent your own routing, auth, persistence, forms, caching, or cross-module calls. If a feature is not listed here, ask before rolling your own.
-
-| Concern | Canonical mechanism |
+| When you need | Load |
 |---|---|
-| Module structure & auto-discovery | `src/modules/<id>/{api,backend,frontend,data,subscribers,workers,widgets}` + `index.ts` + one line in `src/modules.ts` — discovered by `yarn generate` |
-| API routes | Files under `api/**/route.ts` exporting handlers + per-method `metadata` (`requireAuth` / `requireFeatures`) + `openApi`. NEVER a top-level `export const requireAuth` — the registry ignores it |
-| CRUD APIs | `makeCrudRoute({ orm, list, create, update, del, indexer })` from `@open-mercato/shared/lib/crud/factory`. Always set `indexer` for query-index coverage. Custom (non-factory) write routes MUST run the mutation guard registry (`runMutationGuards`) |
-| CRUD forms | `<CrudForm />` from `@open-mercato/ui/backend/CrudForm` + `createCrud`/`updateCrud`/`deleteCrud`. Never raw `<form>`, never raw `fetch` |
-| Data tables | `<DataTable entityId apiPath … />` from `@open-mercato/ui/backend/DataTable`. Keep `entityId` / `extensionTableId` stable so widget injection keeps working |
-| HTTP from the client | `apiCall` / `apiCallOrThrow` from `@open-mercato/ui/backend/utils/apiCall` — never raw `fetch` |
-| Authorization (RBAC) | Declare features in `acl.ts`, grant in `setup.ts` `defaultRoleFeatures`, gate with `requireFeatures` in `metadata` / `page.meta.ts`. NEVER `requireRoles` (role names mutate). Treat `module.*` / `*` wildcard grants as part of the contract |
-| Multi-tenant scoping | Every tenant-scoped entity has indexed `organization_id` + `tenant_id`; every read/write filters by them. The CRUD factory injects scope — do not bypass it. Ad-hoc queries use `withScopedPayload` |
-| Encryption for sensitive data | Declare `encryption.ts` `defaultEncryptionMaps`; read via `findWithDecryption` / `findOneWithDecryption`. NEVER hand-roll AES/KMS, NEVER `em.find` on encrypted columns |
-| Cache | Resolve from DI (`container.resolve('cache')`) — never `new Redis(...)`. Tag with `tenant:<id>` / `org:<id>` so invalidation stays tenant-scoped |
-| Background workers | `workers/*.ts` exporting `metadata: { queue, id?, concurrency? }` + default handler. Never spin up custom queues |
-| Events between modules | `events.ts` with `createModuleEvents({ moduleId, events } as const)`; subscribe in `subscribers/`. Never call another module's services directly across boundaries |
-| Domain writes | Implement through the Command pattern so audit, undo, cache, events, and indexing stay consistent — do not mutate domain state directly in route handlers |
-| i18n | `useT()` client-side, `resolveTranslations()` server-side; keys in `src/i18n/<locale>.json`. Never hard-code user-facing strings |
-
-> Rule of thumb: if you reach for raw `fetch`, raw `<form>`, ad-hoc `crypto`, ad-hoc `Redis`, or a manual cross-module join, stop and check the row above — there is a canonical helper.
-
-## Entity-update safety & data integrity
-
-- **`withAtomicFlush`.** MikroORM can silently discard pending scalar changes when a query (`em.find`/`em.findOne`/sync helper) runs on the same `EntityManager` between a scalar mutation and `em.flush()`. Multi-phase mutations MUST use `withAtomicFlush(em, phases, { transaction: true })` from `@open-mercato/shared/lib/commands/flush`. Keep `emitCrudSideEffects` and cache invalidation **outside** the block — they fire only after the DB write commits. For entity + custom fields + side effects in one write, prefer `runCrudCommandWrite`.
-- **Optimistic locking (default ON).** Every **new user-editable entity** MUST carry an `updated_at` column and return `updatedAt` in its list/detail responses, so the OSS optimistic lock can detect concurrent edits. `CrudForm` auto-derives the lock header from `initialValues.updatedAt` (covers update and delete). Append-only logs, junction/assignment tables, session/token rows, and parent-guarded sub-resource lines are exempt.
-- **Encryption.** Sensitive / GDPR fields go through the encryption-maps mechanism (`encryption.ts` + `findWithDecryption`), never hand-rolled crypto. Always pass `tenantId` and `organizationId` to the decryption helpers.
-- **Tenant isolation.** Never expose cross-tenant data; always filter by `organization_id` (and `tenant_id`). Never create direct ORM relationships between modules — reference by FK id and fetch separately.
-
-## Generate & migration workflow
-
-- **After editing `src/modules.ts` or any structural module file:** run `yarn generate`. Never hand-edit anything under `.mercato/generated/*`.
-- **After editing `data/entities.ts`:** run `yarn db:generate` as a schema-diff probe. Default to the generated SQL; if it emits unrelated churn from another module's stale snapshot, keep only the SQL for your change and update that module's `migrations/.snapshot-open-mercato.json` in the same commit.
-- **Do not run `yarn db:migrate`** unless the user explicitly asks. A PR should normally include the migration file plus snapshot, not local DB state. Never hand-edit a migration that has already shipped — add a new one.
-- **New ACL features must be visible immediately:** add the feature to `acl.ts` **and** to `setup.ts` `defaultRoleFeatures`, then run `yarn mercato auth sync-role-acls` so existing tenants pick it up.
-
-## Where to go next
-
-- A specific module's surface (entities, events, routes, auth, search, CLI): its **fact-sheet** at `.ai/guides/modules/<module>.md`.
-- Deeper package patterns: the matching **package guide** (`core.md`, `ui.md`, `shared.md`, `events.md`, `queue.md`, `cache.md`, `search.md`).
-- Scaffolding a module end-to-end: the `om-module-scaffold` skill.
+| Module ownership, layout, discovery, registration, or installed source | `.ai/guides/architecture.md` |
+| Entities, CRUD/API, commands, scoping, ACL, setup, events, workers, search, cache, or migrations | `.ai/guides/contracts.md` |
+| Forms, tables, pages, navigation, portal, translations, or design-system behavior | `.ai/guides/backend-ui.md` |
+| Enrichers, interceptors, guards, widgets, extensions, menus, replacements, or overrides | `.ai/guides/extensions.md` |
+| Provider packages, data sync, webhooks, import/export, shipping, payment, or email | `.ai/guides/integrations.md` |
+| AI agents/tools/orchestrators or workflows | `.ai/guides/ai-workflows.md` |
+| Diagnosis and regression verification | `.ai/guides/testing-debugging.md` |
+
+For a complete new module, invoke `om-module-scaffold`; it loads the relevant branches. For a concrete installed-module fact, read its generated `.ai/guides/modules/<id>.md` first. Invoke `om-framework-context` only when generated facts cannot answer the implementation question.

package/dist/agentic/guides/modules/ai_assistant.md

@@ -1,5 +1,5 @@
 # ai_assistant — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/ai-assistant 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/api_docs.md

@@ -1,5 +1,5 @@
 # api_docs — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/api_keys.md

@@ -1,5 +1,5 @@
 # api_keys — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/attachments.md

@@ -1,12 +1,12 @@
 # attachments — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 
 | Entity ID | Class | Table | Editable | CustomFields |
 |---|---|---|---|---|
 | attachments:attachment_partition | AttachmentPartition | attachment_partitions | yes | no |
-| attachments:attachment | Attachment | attachments | no | no |
+| attachments:attachment | Attachment | attachments | no | yes |
 
 ## Events  (3)
 

package/dist/agentic/guides/modules/audit_logs.md

@@ -1,5 +1,5 @@
 # audit_logs — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 
@@ -31,7 +31,7 @@ _none_
 ## Host extension points
 
 - Entity IDs: _none_
-- Table IDs: _none_
+- Table IDs: audit_logs.access.list · audit_logs.actions.list
 
 ## Notifications
 

package/dist/agentic/guides/modules/auth.md

@@ -1,5 +1,5 @@
 # auth — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/business_rules.md

@@ -1,5 +1,5 @@
 # business_rules — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/catalog.md

@@ -1,22 +1,22 @@
 # catalog — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 
 | Entity ID | Class | Table | Editable | CustomFields |
 |---|---|---|---|---|
 | catalog:catalog_option_schema_template | CatalogOptionSchemaTemplate | catalog_product_option_schemas | yes | no |
-| catalog:catalog_product | CatalogProduct | catalog_products | yes | no |
+| catalog:catalog_product | CatalogProduct | catalog_products | yes | yes |
 | catalog:catalog_product_unit_conversion | CatalogProductUnitConversion | catalog_product_unit_conversions | yes | no |
 | catalog:catalog_product_category | CatalogProductCategory | catalog_product_categories | yes | no |
 | catalog:catalog_product_category_assignment | CatalogProductCategoryAssignment | catalog_product_category_assignments | yes | no |
 | catalog:catalog_product_tag | CatalogProductTag | catalog_product_tags | yes | no |
 | catalog:catalog_product_tag_assignment | CatalogProductTagAssignment | catalog_product_tag_assignments | yes | no |
 | catalog:catalog_offer | CatalogOffer | catalog_product_offers | yes | no |
-| catalog:catalog_product_variant | CatalogProductVariant | catalog_product_variants | yes | no |
+| catalog:catalog_product_variant | CatalogProductVariant | catalog_product_variants | yes | yes |
 | catalog:catalog_product_variant_relation | CatalogProductVariantRelation | catalog_product_variant_relations | yes | no |
 | catalog:catalog_price_kind | CatalogPriceKind | catalog_price_kinds | yes | no |
-| catalog:catalog_product_price | CatalogProductPrice | catalog_product_variant_prices | yes | no |
+| catalog:catalog_product_price | CatalogProductPrice | catalog_product_variant_prices | yes | yes |
 
 ## Events  (17)
 
@@ -59,7 +59,7 @@ catalog:catalog_product · catalog:catalog_product_variant · catalog:catalog_pr
 ## Host extension points
 
 - Entity IDs: _none_
-- Table IDs: _none_
+- Table IDs: catalog.categories.list · catalog.products.list
 
 ## Notifications
 

package/dist/agentic/guides/modules/channel_gmail.md

@@ -1,5 +1,5 @@
 # channel_gmail — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/channel-gmail 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/channel_imap.md

@@ -1,5 +1,5 @@
 # channel_imap — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/channel-imap 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/checkout.md

@@ -1,5 +1,5 @@
 # checkout — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/checkout 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/communication_channels.md

@@ -1,5 +1,5 @@
 # communication_channels — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/configs.md

@@ -1,5 +1,5 @@
 # configs — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/content.md

@@ -1,5 +1,5 @@
 # content — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/content 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/currencies.md

@@ -1,5 +1,5 @@
 # currencies — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/customer_accounts.md

@@ -1,5 +1,5 @@
 # customer_accounts — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/customers.md

@@ -1,5 +1,5 @@
 # customers — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 
@@ -104,7 +104,7 @@ customers:customer_person_profile · customers:customer_company_profile · custo
 ## Host extension points
 
 - Entity IDs: customers:customer_entity
-- Table IDs: customers.companies.list · customers.deals.list · customers.people.list
+- Table IDs: customers.companies.list · customers.deals.list · customers.people.list · customers.todos.list
 
 ## Notifications
 

package/dist/agentic/guides/modules/dashboards.md

@@ -1,5 +1,5 @@
 # dashboards — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/data_sync.md

@@ -1,5 +1,5 @@
 # data_sync — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/dictionaries.md

@@ -1,5 +1,5 @@
 # dictionaries — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/directory.md

@@ -1,5 +1,5 @@
 # directory — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/entities.md

@@ -1,5 +1,5 @@
 # entities — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 
@@ -35,7 +35,7 @@ _none_
 ## Host extension points
 
 - Entity IDs: entities:custom_entity
-- Table IDs: _none_
+- Table IDs: entities.system.list · entities.user.list
 
 ## Notifications
 

package/dist/agentic/guides/modules/events.md

@@ -1,5 +1,5 @@
 # events — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/events 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/feature_toggles.md

@@ -1,5 +1,5 @@
 # feature_toggles — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/gateway_stripe.md

@@ -1,5 +1,5 @@
 # gateway_stripe — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/gateway-stripe 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/generators.md

@@ -1,5 +1,5 @@
 # generators — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/shared 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/inbox_ops.md

@@ -1,5 +1,5 @@
 # inbox_ops — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/integrations.md

@@ -1,5 +1,5 @@
 # integrations — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/messages.md

@@ -1,5 +1,5 @@
 # messages — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/notifications.md

@@ -1,5 +1,5 @@
 # notifications — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/onboarding.md

@@ -1,5 +1,5 @@
 # onboarding — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/onboarding 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/payment_gateways.md

@@ -1,5 +1,5 @@
 # payment_gateways — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/perspectives.md

@@ -1,5 +1,5 @@
 # perspectives — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/planner.md

@@ -1,5 +1,5 @@
 # planner — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/portal.md

@@ -1,5 +1,5 @@
 # portal — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/progress.md

@@ -1,5 +1,5 @@
 # progress — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

package/dist/agentic/guides/modules/query_index.md

@@ -1,5 +1,5 @@
 # query_index — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 
@@ -35,7 +35,7 @@ _none_
 ## Host extension points
 
 - Entity IDs: _none_
-- Table IDs: _none_
+- Table IDs: query_index.status.list
 
 ## Notifications
 

package/dist/agentic/guides/modules/record_locks.md

@@ -1,5 +1,5 @@
 # record_locks — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/enterprise 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

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

@@ -1,5 +1,5 @@
 # resources — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 

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

@@ -1,5 +1,5 @@
 # sales — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/core 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities
 
@@ -10,25 +10,25 @@
 | sales:sales_delivery_window | SalesDeliveryWindow | sales_delivery_windows | yes | no |
 | sales:sales_payment_method | SalesPaymentMethod | sales_payment_methods | yes | no |
 | sales:sales_tax_rate | SalesTaxRate | sales_tax_rates | yes | no |
-| sales:sales_order | SalesOrder | sales_orders | yes | no |
-| sales:sales_order_line | SalesOrderLine | sales_order_lines | yes | no |
-| sales:sales_order_adjustment | SalesOrderAdjustment | sales_order_adjustments | yes | no |
+| sales:sales_order | SalesOrder | sales_orders | yes | yes |
+| sales:sales_order_line | SalesOrderLine | sales_order_lines | yes | yes |
+| sales:sales_order_adjustment | SalesOrderAdjustment | sales_order_adjustments | yes | yes |
 | sales:sales_settings | SalesSettings | sales_settings | yes | no |
 | sales:sales_document_sequence | SalesDocumentSequence | sales_document_sequences | yes | no |
-| sales:sales_quote | SalesQuote | sales_quotes | yes | no |
-| sales:sales_quote_line | SalesQuoteLine | sales_quote_lines | yes | no |
-| sales:sales_quote_adjustment | SalesQuoteAdjustment | sales_quote_adjustments | yes | no |
-| sales:sales_shipment | SalesShipment | sales_shipments | yes | no |
-| sales:sales_shipment_item | SalesShipmentItem | sales_shipment_items | no | no |
+| sales:sales_quote | SalesQuote | sales_quotes | yes | yes |
+| sales:sales_quote_line | SalesQuoteLine | sales_quote_lines | yes | yes |
+| sales:sales_quote_adjustment | SalesQuoteAdjustment | sales_quote_adjustments | yes | yes |
+| sales:sales_shipment | SalesShipment | sales_shipments | yes | yes |
+| sales:sales_shipment_item | SalesShipmentItem | sales_shipment_items | no | yes |
 | sales:sales_return | SalesReturn | sales_returns | yes | no |
 | sales:sales_return_line | SalesReturnLine | sales_return_lines | yes | no |
-| sales:sales_invoice | SalesInvoice | sales_invoices | yes | no |
-| sales:sales_invoice_line | SalesInvoiceLine | sales_invoice_lines | no | no |
-| sales:sales_credit_memo | SalesCreditMemo | sales_credit_memos | yes | no |
-| sales:sales_credit_memo_line | SalesCreditMemoLine | sales_credit_memo_lines | no | no |
-| sales:sales_payment | SalesPayment | sales_payments | yes | no |
-| sales:sales_payment_allocation | SalesPaymentAllocation | sales_payment_allocations | no | no |
-| sales:sales_note | SalesNote | sales_notes | yes | no |
+| sales:sales_invoice | SalesInvoice | sales_invoices | yes | yes |
+| sales:sales_invoice_line | SalesInvoiceLine | sales_invoice_lines | no | yes |
+| sales:sales_credit_memo | SalesCreditMemo | sales_credit_memos | yes | yes |
+| sales:sales_credit_memo_line | SalesCreditMemoLine | sales_credit_memo_lines | no | yes |
+| sales:sales_payment | SalesPayment | sales_payments | yes | yes |
+| sales:sales_payment_allocation | SalesPaymentAllocation | sales_payment_allocations | no | yes |
+| sales:sales_note | SalesNote | sales_notes | yes | yes |
 | sales:sales_document_address | SalesDocumentAddress | sales_document_addresses | yes | no |
 | sales:sales_document_tag | SalesDocumentTag | sales_document_tags | yes | no |
 | sales:sales_document_tag_assignment | SalesDocumentTagAssignment | sales_document_tag_assignments | yes | no |
@@ -100,7 +100,7 @@ sales:sales_channel · sales:sales_order · sales:sales_quote · sales:sales_ord
 ## Host extension points
 
 - Entity IDs: _none_
-- Table IDs: _none_
+- Table IDs: sales.orders · sales.quotes
 
 ## Notifications
 

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

@@ -1,5 +1,5 @@
 # scheduler — module facts (generated, do not edit)
-<!-- generated from @open-mercato/core 0.6.7-develop.6685.1.77c0a5591b — R1 staleness stamp -->
+<!-- generated from @open-mercato/scheduler 0.6.7-develop.6687.1.46a258e592; core 0.6.7-develop.6687.1.46a258e592 — R1 staleness stamp -->
 
 ## Entities