@open-mercato/core 0.6.7-develop.6669.1.40b669666b → 0.6.7-develop.6670.1.4efa7961c6

package/src/modules/wms/api/zones/route.ts

@@ -0,0 +1,158 @@
+import { z } from 'zod'
+import { makeCrudRoute } from '@open-mercato/shared/lib/crud/factory'
+import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
+import { parseScopedCommandInput, resolveCrudRecordId } from '@open-mercato/shared/lib/api/scoped'
+import { escapeLikePattern } from '@open-mercato/shared/lib/db/escapeLikePattern'
+import { E } from '#generated/entities.ids.generated'
+import { WarehouseZone } from '../../data/entities'
+import { warehouseZoneCreateSchema, warehouseZoneUpdateSchema } from '../../data/validators'
+import { createPagedListResponseSchema, createWmsCrudOpenApi, defaultOkResponseSchema } from '../openapi'
+import { attachWarehouseLabelsToListItems } from '../listEnrichers'
+
+const routeMetadata = {
+  GET: { requireAuth: true, requireFeatures: ['wms.view'] },
+  POST: { requireAuth: true, requireFeatures: ['wms.manage_zones'] },
+  PUT: { requireAuth: true, requireFeatures: ['wms.manage_zones'] },
+  DELETE: { requireAuth: true, requireFeatures: ['wms.manage_zones'] },
+}
+
+export const metadata = routeMetadata
+
+const rawBodySchema = z.object({}).passthrough()
+
+const listSchema = z.object({
+  page: z.coerce.number().min(1).default(1),
+  pageSize: z.coerce.number().min(1).max(100).default(25),
+  search: z.string().optional(),
+  warehouseId: z.string().uuid().optional(),
+  ids: z.string().optional(),
+  sortField: z.string().optional(),
+  sortDir: z.enum(['asc', 'desc']).optional(),
+}).passthrough()
+
+const crud = makeCrudRoute({
+  metadata: routeMetadata,
+  orm: {
+    entity: WarehouseZone,
+    idField: 'id',
+    orgField: 'organizationId',
+    tenantField: 'tenantId',
+    softDeleteField: 'deletedAt',
+  },
+  indexer: { entityType: E.wms.warehouse_zone },
+  list: {
+    schema: listSchema,
+    entityId: E.wms.warehouse_zone,
+    fields: [
+      'id',
+      'organization_id',
+      'tenant_id',
+      'warehouse_id',
+      'code',
+      'name',
+      'priority',
+      'created_at',
+      'updated_at',
+    ],
+    sortFieldMap: {
+      name: 'name',
+      code: 'code',
+      priority: 'priority',
+      createdAt: 'created_at',
+      updatedAt: 'updated_at',
+    },
+    buildFilters: async (query) => {
+      const filters: Record<string, unknown> = {}
+      if (query.warehouseId) filters.warehouse_id = { $eq: query.warehouseId }
+      if (typeof query.ids === 'string' && query.ids.trim().length > 0) {
+        filters.id = {
+          $in: query.ids.split(',').map((value) => value.trim()).filter((value) => value.length > 0),
+        }
+      }
+      const term = query.search?.trim()
+      if (term) {
+        const like = `%${escapeLikePattern(term)}%`
+        filters.$or = [
+          { code: { $ilike: like } },
+          { name: { $ilike: like } },
+        ]
+      }
+      return filters
+    },
+  },
+  hooks: {
+    afterList: async (payload, ctx) => {
+      await attachWarehouseLabelsToListItems(payload, ctx)
+    },
+  },
+  actions: {
+    create: {
+      commandId: 'wms.zones.create',
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations()
+        return parseScopedCommandInput(warehouseZoneCreateSchema, raw ?? {}, ctx, translate)
+      },
+      response: ({ result }) => ({ id: result?.zoneId ?? null }),
+      status: 201,
+    },
+    update: {
+      commandId: 'wms.zones.update',
+      schema: rawBodySchema,
+      mapInput: async ({ raw, ctx }) => {
+        const { translate } = await resolveTranslations()
+        return parseScopedCommandInput(warehouseZoneUpdateSchema, raw ?? {}, ctx, translate)
+      },
+      response: () => ({ ok: true }),
+    },
+    delete: {
+      commandId: 'wms.zones.delete',
+      schema: rawBodySchema,
+      mapInput: async ({ parsed, ctx }) => {
+        const { translate } = await resolveTranslations()
+        return { id: resolveCrudRecordId(parsed, ctx, translate) }
+      },
+      response: () => ({ ok: true }),
+    },
+  },
+})
+
+export const GET = crud.GET
+export const POST = crud.POST
+export const PUT = crud.PUT
+export const DELETE = crud.DELETE
+
+const zoneListItemSchema = z.object({
+  id: z.string().uuid().nullable().optional(),
+  organization_id: z.string().uuid().nullable().optional(),
+  tenant_id: z.string().uuid().nullable().optional(),
+  warehouse_id: z.string().uuid().nullable().optional(),
+  warehouse_name: z.string().nullable().optional(),
+  warehouse_code: z.string().nullable().optional(),
+  code: z.string().nullable().optional(),
+  name: z.string().nullable().optional(),
+  priority: z.number().nullable().optional(),
+  created_at: z.string().nullable().optional(),
+  updated_at: z.string().nullable().optional(),
+})
+
+export const openApi = createWmsCrudOpenApi({
+  resourceName: 'Warehouse zone',
+  pluralName: 'Warehouse zones',
+  querySchema: listSchema,
+  listResponseSchema: createPagedListResponseSchema(zoneListItemSchema),
+  create: {
+    schema: warehouseZoneCreateSchema,
+    description: 'Creates a zone within a warehouse.',
+  },
+  update: {
+    schema: warehouseZoneUpdateSchema,
+    responseSchema: defaultOkResponseSchema,
+    description: 'Updates a warehouse zone by id.',
+  },
+  del: {
+    schema: z.object({ id: z.string().uuid() }),
+    responseSchema: defaultOkResponseSchema,
+    description: 'Soft-deletes a warehouse zone by id.',
+  },
+})

package/src/modules/wms/backend/config/wms/page.meta.ts

@@ -0,0 +1,14 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'WMS Configuration',
+  pageTitleKey: 'wms.backend.config.nav.title',
+  pageGroup: 'Module Configs',
+  pageGroupKey: 'settings.sections.moduleConfigs',
+  pageOrder: 35,
+  pageContext: 'settings' as const,
+  icon: 'settings',
+  breadcrumb: [
+    { label: 'WMS', labelKey: 'wms.backend.config.nav.title' },
+  ],
+} as const

package/src/modules/wms/backend/config/wms/page.tsx

@@ -0,0 +1,5 @@
+import WmsConfigurationPage from '../../../components/backend/WmsConfigurationPage'
+
+export default function WmsConfigPage() {
+  return <WmsConfigurationPage />
+}

package/src/modules/wms/backend/page.meta.ts

@@ -0,0 +1,12 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'Operational dashboard',
+  pageTitleKey: 'wms.backend.dashboard.title',
+  pageGroup: 'WMS',
+  pageGroupKey: 'wms.nav.group',
+  pagePriority: 45,
+  pageOrder: 95,
+  icon: 'warehouse',
+  breadcrumb: [{ label: 'WMS', labelKey: 'wms.backend.nav.title' }],
+} as const

package/src/modules/wms/backend/page.tsx

@@ -0,0 +1,5 @@
+import WmsOperationalDashboardPage from '../components/backend/WmsOperationalDashboardPage'
+
+export default function WmsBackendPage() {
+  return <WmsOperationalDashboardPage />
+}

package/src/modules/wms/backend/wms/inventory/page.meta.ts

@@ -0,0 +1,14 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'WMS Inventory',
+  pageTitleKey: 'wms.backend.inventory.nav.title',
+  pageGroup: 'WMS',
+  pageGroupKey: 'wms.nav.group',
+  pageOrder: 100,
+  breadcrumb: [
+    { label: 'WMS', labelKey: 'wms.backend.nav.title', href: '/backend/wms' },
+    { label: 'Inventory', labelKey: 'wms.backend.inventory.nav.title' },
+  ],
+  icon: 'boxes',
+} as const

package/src/modules/wms/backend/wms/inventory/page.tsx

@@ -0,0 +1,5 @@
+import WmsInventoryConsolePage from '../../../components/backend/WmsInventoryConsolePage'
+
+export default function WmsInventoryPage() {
+  return <WmsInventoryConsolePage />
+}

package/src/modules/wms/backend/wms/location/[id]/page.meta.ts

@@ -0,0 +1,14 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'Location detail',
+  pageTitleKey: 'wms.backend.location.detail.pageTitle',
+  pageGroup: 'WMS',
+  pageGroupKey: 'wms.nav.group',
+  navHidden: true,
+  breadcrumb: [
+    { label: 'WMS', labelKey: 'wms.backend.nav.title', href: '/backend/wms' },
+    { label: 'Locations', labelKey: 'wms.backend.locations.nav.title', href: '/backend/wms/locations' },
+    { label: 'Location', labelKey: 'wms.backend.location.detail.breadcrumb' },
+  ],
+} as const

package/src/modules/wms/backend/wms/location/[id]/page.tsx

@@ -0,0 +1,5 @@
+import WmsLocationDetailPage from '../../../../components/backend/WmsLocationDetailPage'
+
+export default function WmsLocationDetailRoutePage({ params }: { params?: { id?: string } }) {
+  return <WmsLocationDetailPage locationId={params?.id ?? ''} />
+}

package/src/modules/wms/backend/wms/locations/page.meta.ts

@@ -0,0 +1,14 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'WMS Locations',
+  pageTitleKey: 'wms.backend.locations.nav.title',
+  pageGroup: 'WMS',
+  pageGroupKey: 'wms.nav.group',
+  pageOrder: 125,
+  breadcrumb: [
+    { label: 'WMS', labelKey: 'wms.backend.nav.title', href: '/backend/wms' },
+    { label: 'Locations', labelKey: 'wms.backend.locations.nav.title' },
+  ],
+  icon: 'map-pinned',
+} as const

package/src/modules/wms/backend/wms/locations/page.tsx

@@ -0,0 +1,12 @@
+import { Page, PageBody } from '@open-mercato/ui/backend/Page'
+import { LocationSection } from '../../../components/backend/WmsConfigurationPage'
+
+export default function WmsLocationsPage() {
+  return (
+    <Page>
+      <PageBody>
+        <LocationSection />
+      </PageBody>
+    </Page>
+  )
+}

package/src/modules/wms/backend/wms/lot/[id]/page.meta.ts

@@ -0,0 +1,14 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'Lot detail',
+  pageTitleKey: 'wms.backend.lot.detail.pageTitle',
+  pageGroup: 'WMS',
+  pageGroupKey: 'wms.nav.group',
+  navHidden: true,
+  breadcrumb: [
+    { label: 'WMS', labelKey: 'wms.backend.nav.title', href: '/backend/wms' },
+    { label: 'Inventory', labelKey: 'wms.backend.inventory.nav.title', href: '/backend/wms/inventory' },
+    { label: 'Lot', labelKey: 'wms.backend.lot.detail.breadcrumb' },
+  ],
+} as const

package/src/modules/wms/backend/wms/lot/[id]/page.tsx

@@ -0,0 +1,5 @@
+import WmsLotDetailPage from '../../../../components/backend/WmsLotDetailPage'
+
+export default function WmsLotDetailRoutePage({ params }: { params?: { id?: string } }) {
+  return <WmsLotDetailPage lotId={params?.id ?? ''} />
+}

package/src/modules/wms/backend/wms/lots/page.meta.ts

@@ -0,0 +1,14 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'WMS Lots',
+  pageTitleKey: 'wms.backend.lots.nav.title',
+  pageGroup: 'WMS',
+  pageGroupKey: 'wms.nav.group',
+  pageOrder: 130,
+  breadcrumb: [
+    { label: 'WMS', labelKey: 'wms.backend.nav.title', href: '/backend/wms' },
+    { label: 'Lots', labelKey: 'wms.backend.lots.nav.title' },
+  ],
+  icon: 'layers',
+} as const

package/src/modules/wms/backend/wms/lots/page.tsx

@@ -0,0 +1,5 @@
+import WmsLotsListPage from '../../../components/backend/WmsLotsListPage'
+
+export default function WmsLotsPage() {
+  return <WmsLotsListPage />
+}

package/src/modules/wms/backend/wms/movements/page.meta.ts

@@ -0,0 +1,14 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'WMS Movements',
+  pageTitleKey: 'wms.backend.movements.nav.title',
+  pageGroup: 'WMS',
+  pageGroupKey: 'wms.nav.group',
+  pageOrder: 140,
+  breadcrumb: [
+    { label: 'WMS', labelKey: 'wms.backend.nav.title', href: '/backend/wms' },
+    { label: 'Movements', labelKey: 'wms.backend.movements.nav.title' },
+  ],
+  icon: 'truck',
+} as const

package/src/modules/wms/backend/wms/movements/page.tsx

@@ -0,0 +1,23 @@
+"use client"
+
+import { Page, PageBody } from '@open-mercato/ui/backend/Page'
+import {
+  InventoryMovementsSection,
+} from '../../../components/backend/WmsInventoryConsolePage'
+import { useWmsInventoryScopeFromSearchParams } from '../../../components/backend/useWmsInventoryScopeFromSearchParams'
+
+export default function WmsMovementsPage() {
+  const scope = useWmsInventoryScopeFromSearchParams()
+
+  return (
+    <Page>
+      <PageBody>
+        <InventoryMovementsSection
+          warehouseId={scope.warehouseId}
+          variantId={scope.catalogVariantId}
+          lotId={scope.lotId}
+        />
+      </PageBody>
+    </Page>
+  )
+}

package/src/modules/wms/backend/wms/reservations/page.meta.ts

@@ -0,0 +1,14 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'WMS Reservations',
+  pageTitleKey: 'wms.backend.reservations.nav.title',
+  pageGroup: 'WMS',
+  pageGroupKey: 'wms.nav.group',
+  pageOrder: 150,
+  breadcrumb: [
+    { label: 'WMS', labelKey: 'wms.backend.nav.title', href: '/backend/wms' },
+    { label: 'Reservations', labelKey: 'wms.backend.reservations.nav.title' },
+  ],
+  icon: 'clipboard-list',
+} as const

package/src/modules/wms/backend/wms/reservations/page.tsx

@@ -0,0 +1,24 @@
+"use client"
+
+import { Page, PageBody } from '@open-mercato/ui/backend/Page'
+import { InventoryReservationsSection } from '../../../components/backend/WmsInventoryConsolePage'
+import { useWmsInventoryMutationAccess } from '../../../components/backend/useWmsInventoryMutationAccess'
+import { useWmsInventoryScopeFromSearchParams } from '../../../components/backend/useWmsInventoryScopeFromSearchParams'
+
+export default function WmsReservationsPage() {
+  const access = useWmsInventoryMutationAccess()
+  const scope = useWmsInventoryScopeFromSearchParams()
+
+  return (
+    <Page>
+      <PageBody>
+        <InventoryReservationsSection
+          access={access}
+          warehouseId={scope.warehouseId}
+          variantId={scope.catalogVariantId}
+          lotId={scope.lotId}
+        />
+      </PageBody>
+    </Page>
+  )
+}

package/src/modules/wms/backend/wms/sku/[id]/page.meta.ts

@@ -0,0 +1,14 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'SKU detail',
+  pageTitleKey: 'wms.backend.sku.detail.pageTitle',
+  pageGroup: 'WMS',
+  pageGroupKey: 'wms.nav.group',
+  navHidden: true,
+  breadcrumb: [
+    { label: 'WMS', labelKey: 'wms.backend.nav.title', href: '/backend/wms' },
+    { label: 'Inventory', labelKey: 'wms.backend.inventory.nav.title', href: '/backend/wms/inventory' },
+    { label: 'SKU', labelKey: 'wms.backend.sku.detail.breadcrumb' },
+  ],
+} as const

package/src/modules/wms/backend/wms/sku/[id]/page.tsx

@@ -0,0 +1,5 @@
+import WmsSkuDetailPage from '../../../../components/backend/WmsSkuDetailPage'
+
+export default function WmsSkuDetailRoutePage({ params }: { params?: { id?: string } }) {
+  return <WmsSkuDetailPage variantId={params?.id ?? ''} />
+}

package/src/modules/wms/backend/wms/warehouses/page.meta.ts

@@ -0,0 +1,14 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'WMS Warehouses',
+  pageTitleKey: 'wms.backend.warehouses.nav.title',
+  pageGroup: 'WMS',
+  pageGroupKey: 'wms.nav.group',
+  pageOrder: 110,
+  breadcrumb: [
+    { label: 'WMS', labelKey: 'wms.backend.nav.title', href: '/backend/wms' },
+    { label: 'Warehouses', labelKey: 'wms.backend.warehouses.nav.title' },
+  ],
+  icon: 'warehouse',
+} as const

package/src/modules/wms/backend/wms/warehouses/page.tsx

@@ -0,0 +1,12 @@
+import { Page, PageBody } from '@open-mercato/ui/backend/Page'
+import { WarehouseSection } from '../../../components/backend/WmsConfigurationPage'
+
+export default function WmsWarehousesPage() {
+  return (
+    <Page>
+      <PageBody>
+        <WarehouseSection />
+      </PageBody>
+    </Page>
+  )
+}

package/src/modules/wms/backend/wms/zones/page.meta.ts

@@ -0,0 +1,14 @@
+export const metadata = {
+  requireAuth: true,
+  requireFeatures: ['wms.view'],
+  pageTitle: 'WMS Zones',
+  pageTitleKey: 'wms.backend.zones.nav.title',
+  pageGroup: 'WMS',
+  pageGroupKey: 'wms.nav.group',
+  pageOrder: 120,
+  breadcrumb: [
+    { label: 'WMS', labelKey: 'wms.backend.nav.title', href: '/backend/wms' },
+    { label: 'Zones', labelKey: 'wms.backend.zones.nav.title' },
+  ],
+  icon: 'layers',
+} as const

package/src/modules/wms/backend/wms/zones/page.tsx

@@ -0,0 +1,12 @@
+import { Page, PageBody } from '@open-mercato/ui/backend/Page'
+import { ZoneSection } from '../../../components/backend/WmsConfigurationPage'
+
+export default function WmsZonesPage() {
+  return (
+    <Page>
+      <PageBody>
+        <ZoneSection />
+      </PageBody>
+    </Page>
+  )
+}

package/src/modules/wms/ce.ts

@@ -0,0 +1,76 @@
+export const entities = [
+  {
+    id: 'wms:warehouse',
+    label: 'Warehouse',
+    description: 'Physical warehouse definition used by the WMS module.',
+    labelField: 'name',
+    showInSidebar: false,
+    defaultEditor: false,
+    fields: [],
+  },
+  {
+    id: 'wms:warehouse_zone',
+    label: 'Warehouse Zone',
+    description: 'Logical zone inside a warehouse.',
+    labelField: 'name',
+    showInSidebar: false,
+    defaultEditor: false,
+    fields: [],
+  },
+  {
+    id: 'wms:warehouse_location',
+    label: 'Warehouse Location',
+    description: 'Physical location or bin inside a warehouse.',
+    labelField: 'code',
+    showInSidebar: false,
+    defaultEditor: false,
+    fields: [],
+  },
+  {
+    id: 'wms:product_inventory_profile',
+    label: 'Product Inventory Profile',
+    description: 'Variant-level inventory behavior configuration.',
+    labelField: 'catalogVariantId',
+    showInSidebar: false,
+    defaultEditor: false,
+    fields: [],
+  },
+  {
+    id: 'wms:inventory_lot',
+    label: 'Inventory Lot',
+    description: 'Tracked lot or batch for traceable stock.',
+    labelField: 'lotNumber',
+    showInSidebar: false,
+    defaultEditor: false,
+    fields: [],
+  },
+  {
+    id: 'wms:inventory_balance',
+    label: 'Inventory Balance',
+    description: 'Current stock bucket balance at location level.',
+    labelField: 'catalogVariantId',
+    showInSidebar: false,
+    defaultEditor: false,
+    fields: [],
+  },
+  {
+    id: 'wms:inventory_reservation',
+    label: 'Inventory Reservation',
+    description: 'Reserved stock allocation for a downstream demand source.',
+    labelField: 'sourceId',
+    showInSidebar: false,
+    defaultEditor: false,
+    fields: [],
+  },
+  {
+    id: 'wms:inventory_movement',
+    label: 'Inventory Movement',
+    description: 'Append-only audit ledger entry for inventory state changes.',
+    labelField: 'referenceId',
+    showInSidebar: false,
+    defaultEditor: false,
+    fields: [],
+  },
+]
+
+export default entities

package/src/modules/wms/cli.ts

@@ -0,0 +1,96 @@
+import type { ModuleCli } from '@open-mercato/shared/modules/registry'
+import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
+import type { EntityManager } from '@mikro-orm/postgresql'
+import { repairBalanceDrift, verifyBalances } from './lib/inventoryReconciliation'
+
+function parseArgs(rest: string[]) {
+  const args: Record<string, string | boolean> = {}
+  for (let index = 0; index < rest.length; index += 1) {
+    const part = rest[index]
+    if (!part) continue
+    if (part.startsWith('--')) {
+      const [rawKey, rawValue] = part.slice(2).split('=')
+      if (rawValue !== undefined) {
+        args[rawKey] = rawValue
+      } else if (rest[index + 1] && !rest[index + 1]!.startsWith('--')) {
+        args[rawKey] = rest[index + 1]!
+        index += 1
+      } else {
+        args[rawKey] = true
+      }
+    }
+  }
+  return args
+}
+
+const verifyBalancesCommand: ModuleCli = {
+  command: 'verify-balances',
+  async run(rest) {
+    const args = parseArgs(rest)
+    const tenantId = String(args.tenantId ?? args.tenant ?? '')
+    const organizationId = String(args.organizationId ?? args.org ?? args.orgId ?? '')
+    const warehouseId = typeof args.warehouse === 'string' ? args.warehouse : typeof args.warehouseId === 'string' ? args.warehouseId : undefined
+    const catalogVariantId =
+      typeof args.catalogVariantId === 'string'
+        ? args.catalogVariantId
+        : typeof args.variantId === 'string'
+          ? args.variantId
+          : undefined
+    const repair = args.repair === true || args.repair === 'true'
+
+    if (!tenantId || !organizationId) {
+      console.error(
+        'Usage: mercato wms verify-balances --tenant <tenantId> --org <organizationId> [--warehouse <warehouseId>] [--catalogVariantId <variantId>] [--repair]',
+      )
+      return
+    }
+
+    const container = await createRequestContainer()
+    try {
+      const em = container.resolve<EntityManager>('em')
+      const scope = { tenantId, organizationId }
+      const driftRows = await verifyBalances(em, scope, {
+        warehouseId,
+        catalogVariantId,
+      })
+
+      if (driftRows.length === 0) {
+        console.log('✅ No balance drift detected.')
+        return
+      }
+
+      console.log(`⚠️  Detected ${driftRows.length} balance drift row(s):`)
+      for (const row of driftRows) {
+        console.log(
+          JSON.stringify({
+            balanceId: row.balanceId,
+            bucket: row.bucket,
+            storedOnHand: row.storedOnHand,
+            expectedOnHand: row.expectedOnHand,
+            storedReserved: row.storedReserved,
+            expectedReserved: row.expectedReserved,
+            storedAllocated: row.storedAllocated,
+            expectedAllocated: row.expectedAllocated,
+          }),
+        )
+      }
+
+      if (!repair) {
+        console.log('Run again with --repair to apply expected values to stored balances.')
+        return
+      }
+
+      const repaired = await em.transactional(async (trx) => repairBalanceDrift(trx, scope, driftRows))
+      console.log(`🔧 Repaired ${repaired} balance row(s).`)
+    } finally {
+      const disposable = container as unknown as { dispose?: () => Promise<void> }
+      if (typeof disposable.dispose === 'function') {
+        await disposable.dispose()
+      }
+    }
+  },
+}
+
+const cliCommands: ModuleCli[] = [verifyBalancesCommand]
+
+export default cliCommands