@open-mercato/cli 0.6.7-develop.6685.1.77c0a5591b → 0.6.7-develop.6686.1.bdda5ed397

package/dist/agentic/shared/ai/skills/om-backend-ui-design/references/ui-components.md

@@ -1,260 +0,0 @@
-# UI Components Reference
-
-Complete reference of all available UI components in `@open-mercato/ui`.
-
-## Package Structure
-
-```
-@open-mercato/ui/
-├── primitives/          # Base UI components (shadcn-style)
-├── backend/             # Full-featured admin components
-├── frontend/            # Public-facing components
-└── theme/               # Theme and provider setup
-```
-
-## PRIMITIVES (`@open-mercato/ui/primitives/*`)
-
-| Component | Import Path | Purpose |
-|-----------|-------------|---------|
-| **Button** | `@open-mercato/ui/primitives/button` | Core button with variants (default, outline, ghost, destructive) |
-| **Input** | `@open-mercato/ui/primitives/input` | Text input field |
-| **Label** | `@open-mercato/ui/primitives/label` | Form label component |
-| **Textarea** | `@open-mercato/ui/primitives/textarea` | Multi-line text input |
-| **Dialog** | `@open-mercato/ui/primitives/dialog` | Modal dialog (Dialog, DialogContent, DialogHeader, DialogTitle, DialogDescription, DialogFooter) |
-| **Tooltip** | `@open-mercato/ui/primitives/tooltip` | Hover tooltip + `SimpleTooltip` utility component |
-| **Table** | `@open-mercato/ui/primitives/table` | Table structure (Table, TableHeader, TableBody, TableRow, TableHead, TableCell) |
-| **Alert** | `@open-mercato/ui/primitives/alert` | Alert boxes (Alert, AlertTitle, AlertDescription) with variants |
-| **Badge** | `@open-mercato/ui/primitives/badge` | Small badge/tag labels with variants |
-| **Separator** | `@open-mercato/ui/primitives/separator` | Visual divider line |
-| **Switch** | `@open-mercato/ui/primitives/switch` | Toggle switch control |
-| **Spinner** | `@open-mercato/ui/primitives/spinner` | Loading spinner animation |
-| **Notice** | `@open-mercato/ui/primitives/Notice` | Contextual notice/hint with variants (`error`, `info`, `warning`) and optional `compact` mode |
-| **ErrorNotice** | `@open-mercato/ui/primitives/ErrorNotice` | Convenience wrapper around `<Notice variant="error">` with default title/message |
-| **DataLoader** | `@open-mercato/ui/primitives/DataLoader` | Loading state wrapper with spinner and optional skeleton |
-
-## BACKEND COMPONENTS (`@open-mercato/ui/backend/*`)
-
-### Core Layout & Navigation
-
-| Component | Import Path | Purpose | Key Props |
-|-----------|-------------|---------|-----------|
-| **AppShell** | `@open-mercato/ui/backend/AppShell` | Main application shell with sidebar, header, breadcrumbs | `navigation`, `user`, `children` |
-| **Page, PageHeader, PageBody** | `@open-mercato/ui/backend/Page` | Page layout containers | - |
-| **UserMenu** | `@open-mercato/ui/backend/UserMenu` | User profile dropdown with logout | `user`, `onLogout` |
-| **FlashMessages, flash** | `@open-mercato/ui/backend/FlashMessages` | Toast notifications. Use `flash(message, type)` programmatically | Type: 'success' \| 'error' \| 'warning' \| 'info' |
-
-### Data Display & Tables
-
-| Component | Import Path | Purpose | Key Props |
-|-----------|-------------|---------|-----------|
-| **DataTable** | `@open-mercato/ui/backend/DataTable` | Feature-rich table with sorting, filtering, pagination, export, perspectives | `entityId`, `apiPath`, `extensionTableId`, `columns`, `data`, `page`, `pageSize`, `totalCount`, `onPageChange`, `onRowClick` |
-| **TruncatedCell** | `@open-mercato/ui/backend/TruncatedCell` | Table cell with text truncation and tooltip | `value`, `maxWidth` |
-| **EmptyState** | `@open-mercato/ui/backend/EmptyState` | Empty state placeholder | `title`, `description`, `action`, `icon` |
-| **RowActions** | `@open-mercato/ui/backend/RowActions` | Context menu for row actions | `items: {label, href?, onSelect?, destructive?}[]` |
-| **FilterBar** | `@open-mercato/ui/backend/FilterBar` | Search and filter UI bar | `filters`, `values`, `onApply`, `onClear` |
-| **ValueIcons** | `@open-mercato/ui/backend/ValueIcons` | `BooleanIcon`, `EnumBadge`, `useSeverityPreset()` | - |
-
-### Forms
-
-| Component | Import Path | Purpose | Key Props |
-|-----------|-------------|---------|-----------|
-| **CrudForm** | `@open-mercato/ui/backend/CrudForm` | Complete CRUD form with field registry, groups, custom fields, validation | `fields`, `groups`, `initialValues`, `onSubmit`, `schema`, `embedded`, `extraActions` |
-| **FormHeader** | `@open-mercato/ui/backend/forms` | Unified page header with `edit` mode (compact, for CrudForm) and `detail` mode (large title, entity type label, status badge, Actions dropdown) | `mode`, `backHref`, `title`, `actions`, `menuActions`, `onDelete`, `statusBadge` |
-| **FormFooter** | `@open-mercato/ui/backend/forms` | Form footer wrapping FormActionButtons with embedded/dialog layout awareness | `actions`, `embedded`, `className` |
-| **FormActionButtons** | `@open-mercato/ui/backend/forms` | Atomic button bar: [extraActions] [Delete] [Cancel] [Save]. Shared by header and footer. | `showDelete`, `onDelete`, `cancelHref`, `submit` |
-| **ActionsDropdown** | `@open-mercato/ui/backend/forms` | Dropdown menu for additional context actions (Convert, Send, Print). Only visible when items are provided. Delete is never inside the dropdown. | `items: ActionItem[]`, `label`, `size` |
-| **JsonBuilder** | `@open-mercato/ui/backend/JsonBuilder` | Interactive JSON editor with "Raw JSON" and "Builder" tabs | `value`, `onChange`, `disabled` |
-| **JsonDisplay** | `@open-mercato/ui/backend/JsonDisplay` | Read-only JSON viewer with expand/collapse | `data`, `title`, `maxInitialDepth`, `showCopy` |
-
-### Input Components (`@open-mercato/ui/backend/inputs/*`)
-
-Specialized inputs that ship with the framework. For each, the full props table, MUST rules, and anti-patterns live in `.ai/ui-components.md` under the section linked from the component name.
-
-| Component | Import Path | Purpose | Key Props |
-|-----------|-------------|---------|-----------|
-| **ComboboxInput** | `@open-mercato/ui/backend/inputs/ComboboxInput` | Single-value typeahead with sync/async suggestions; allows free-form custom values by default | `value`, `onChange`, `suggestions`, `loadSuggestions`, `resolveLabel`, `allowCustomValues` |
-| **TagsInput** | `@open-mercato/ui/backend/inputs/TagsInput` | Multi-value (`string[]`) version of `ComboboxInput` with rich `{ value, label, description }` triples | `value`, `onChange`, `suggestions`, `loadSuggestions`, `selectedOptions`, `resolveLabel` |
-| **LookupSelect** | `@open-mercato/ui/backend/inputs/LookupSelect` | Rich card-list search/select with title/subtitle/icon/badge per row; returns selected id | `value`, `onChange`, `fetchItems`, `options`, `minQuery`, `actionSlot` |
-| **PhoneNumberField** | `@open-mercato/ui/backend/inputs/PhoneNumberField` | Compound country-picker + national-number input matching Figma `Text Input [1.1]` Phone variant. Validates + normalizes on blur, optional duplicate lookup | `value`, `onValueChange`, `onDigitsChange`, `countries`, `defaultCountryIso2`, `onDuplicateLookup` |
-| **EventSelect** | `@open-mercato/ui/backend/inputs/EventSelect` | Strict select for declared platform events, grouped by module. **Mandated by `packages/ui/AGENTS.md`** for event selection | `value`, `onChange`, `categories`, `modules`, `excludeTriggerExcluded`, `size` |
-| **EventPatternInput** | `@open-mercato/ui/backend/inputs/EventPatternInput` | `ComboboxInput` preloaded with declared events that allows wildcard patterns (e.g. `sales.orders.*`) | `value`, `onChange`, `categories`, `modules` |
-| **TimeInput** | `@open-mercato/ui/backend/inputs/TimeInput` | Bare `HH:MM` editor (two `<input type="number">` cells, no popover). Low-level atom — most flows want `TimePicker` | `value`, `onChange`, `minuteStep`, `hourLabel`, `minuteLabel` |
-| **DatePicker** *(@deprecated shim — import from `primitives/date-picker`)* | `@open-mercato/ui/backend/inputs/DatePicker` | Backward-compat re-export of the `DatePicker` primitive. New code MUST import from `@open-mercato/ui/primitives/date-picker`. | — |
-| **DateTimePicker** *(@deprecated shim — use `DatePicker withTime`)* | `@open-mercato/ui/backend/inputs/DateTimePicker` | Thin wrapper that always sets `withTime` on the primitive. New code: `<DatePicker withTime />` | — |
-| **TimePicker** *(@deprecated shim — import from `primitives/time-picker`)* | `@open-mercato/ui/backend/inputs/TimePicker` | Legacy popover-anchored time picker wrapping the new `TimePicker` primitive. New code: `@open-mercato/ui/primitives/time-picker`. | — |
-| **SwitchableMarkdownInput** *(@deprecated — use `RichEditor`)* | `@open-mercato/ui/backend/inputs/SwitchableMarkdownInput` | Markdown ⇄ plain textarea toggle. Kept only for backward compatibility with Markdown-backed surfaces. New rich-text fields MUST use `RichEditor` from `@open-mercato/ui/primitives/rich-editor` (sanitized HTML). | `value`, `onChange`, `isMarkdownEnabled` |
-
-### Input Variants (Figma `Text Input [1.1]` — `@open-mercato/ui/primitives/*`)
-
-Foundation-level input variants matching Figma type-specific designs. Use these instead of raw `<Input type="email">`, `<Input type="password">`, etc. — they ship correct visual chrome (leading icons, prefix boxes, trailing buttons, brand badges) and i18n-resolved labels.
-
-| Component | Import Path | Purpose | Key Props |
-|-----------|-------------|---------|-----------|
-| **EmailInput** | `@open-mercato/ui/primitives/email-input` | `Input` wrapper with leading Mail icon, `type="email"`, `autoComplete="email"` | `value`, `onChange`, `showIcon` |
-| **SearchInput** | `@open-mercato/ui/primitives/search-input` | Leading Search icon + trailing × clear button (when value non-empty). Use for DataTable global filter, command palette, list-view live filter | `value`, `onChange`, `onClear`, `clearable` |
-| **PasswordInput** | `@open-mercato/ui/primitives/password-input` | Leading Lock icon + trailing Eye/EyeOff reveal toggle. Controlled or uncontrolled reveal state | `value`, `onChange`, `revealable`, `revealed`, `onRevealedChange`, `showLockIcon` |
-| **WebsiteInput** | `@open-mercato/ui/primitives/website-input` | Left "https://" prefix box + divider + URL input. `type="url"` | `value`, `onChange`, `prefix`, `showPrefix` |
-| **AmountInput** | `@open-mercato/ui/primitives/amount-input` | Leading currency symbol + numeric input + trailing ISO currency picker (10 markets default) | `value: { amount, currency }`, `onChange`, `currencies`, `showCurrency` |
-| **ButtonInput** | `@open-mercato/ui/primitives/button-input` | Input with optional `leftIcon` + divider + required `trailingAction` slot for interactive button (copy URL, send, regenerate) | `leftIcon`, `trailingAction` (required) |
-| **CardInput** | `@open-mercato/ui/primitives/card-input` | Credit-card-number input with regex-based brand auto-detection (Visa/MC/Amex/Discover/Diners/JCB/UnionPay), format masking, brand badge | `value` (digits-only), `onChange`, `onBrandChange`, `brands` |
-
-### Detail Page Components (`@open-mercato/ui/backend/detail/*`)
-
-| Component | Import Path | Purpose | Key Props |
-|-----------|-------------|---------|-----------|
-| **DetailFieldsSection** | `@open-mercato/ui/backend/detail/DetailFieldsSection` | Entity field display with inline editing | `fields`, `entity`, `onUpdate` |
-| **InlineTextEditor** | `@open-mercato/ui/backend/detail/InlineEditors` | Click-to-edit text field | `value`, `onSave`, `label` |
-| **InlineMultilineEditor** | `@open-mercato/ui/backend/detail/InlineEditors` | Click-to-edit textarea | `value`, `onSave`, `label` |
-| **InlineSelectEditor** | `@open-mercato/ui/backend/detail/InlineEditors` | Click-to-edit select | `value`, `onSave`, `options`, `label` |
-| **NotesSection** | `@open-mercato/ui/backend/detail/NotesSection` | Notes/comments section with markdown | `notes`, `onAdd`, `onUpdate`, `onDelete` |
-| **TagsSection** | `@open-mercato/ui/backend/detail/TagsSection` | Tag management section | `tags`, `onAdd`, `onRemove`, `suggestions` |
-| **CustomDataSection** | `@open-mercato/ui/backend/detail/CustomDataSection` | Custom fields display | `data`, `fieldDefinitions` |
-| **LoadingMessage** | `@open-mercato/ui/backend/detail` | Loading state with spinner | `message` |
-| **ErrorMessage** | `@open-mercato/ui/backend/detail` | Error alert with action | `title`, `description`, `action` |
-| **TabEmptyState** | `@open-mercato/ui/backend/detail` | Empty state for tabs | `message`, `action` |
-
-## BACKEND UTILITIES (`@open-mercato/ui/backend/utils/*`)
-
-| Utility | Import Path | Purpose | Key Exports |
-|---------|-------------|---------|-------------|
-| **apiCall** | `@open-mercato/ui/backend/utils/apiCall` | HTTP client with auth | `apiCall`, `apiCallOrThrow`, `readApiResultOrThrow` |
-| **api** | `@open-mercato/ui/backend/utils/api` | Low-level API utils | `apiFetch` |
-| **crud** | `@open-mercato/ui/backend/utils/crud` | CRUD operation helpers | `createCrud`, `updateCrud`, `deleteCrud` |
-| **serverErrors** | `@open-mercato/ui/backend/utils/serverErrors` | Error mapping | `mapCrudServerErrorToFormErrors`, `createCrudFormError`, `raiseCrudError` |
-| **customFieldValues** | `@open-mercato/ui/backend/utils/customFieldValues` | Custom field value helpers | `collectCustomFieldValues`, `normalizeCustomFieldSubmitValue` |
-| **customFieldDefs** | `@open-mercato/ui/backend/utils/customFieldDefs` | Field definition fetching | `useCustomFieldDefinitions` |
-| **customFieldForms** | `@open-mercato/ui/backend/utils/customFieldForms` | Form field generation | `buildCustomFieldFormFields` |
-| **customFieldColumns** | `@open-mercato/ui/backend/utils/customFieldColumns` | Column builders | `buildCustomFieldColumns` |
-| **customFieldFilters** | `@open-mercato/ui/backend/utils/customFieldFilters` | Filter definitions | `useCustomFieldFilters` |
-
-## Common Usage Patterns
-
-### Flash Messages
-```tsx
-import { flash } from '@open-mercato/ui/backend/FlashMessages'
-
-flash('Record saved successfully', 'success')
-flash('Failed to save record', 'error')
-// Types: 'success' | 'error' | 'warning' | 'info'
-```
-
-### DataTable with Filters
-```tsx
-import { DataTable } from '@open-mercato/ui/backend/DataTable'
-import type { FilterDef, FilterValues } from '@open-mercato/ui/backend/FilterBar'
-
-const filters: FilterDef[] = [
-  { id: 'search', type: 'text', label: 'Search', placeholder: 'Search...' },
-  { id: 'status', type: 'select', label: 'Status', options: [...] },
-]
-
-<DataTable
-  entityId="inventory.item"
-  apiPath="inventory/items"
-  extensionTableId="inventory.item"
-  columns={columns}
-  filters={filters}
-  filterValues={filterValues}
-  onFiltersApply={handleFiltersApply}
-  onFiltersClear={handleFiltersClear}
-  page={page}
-  pageSize={pageSize}
-  totalCount={totalCount}
-  onPageChange={setPage}
-  onRowClick={(row) => router.push(`/items/${row.id}`)}
-/>
-```
-
-### CrudForm
-```tsx
-import { CrudForm, type CrudField, type CrudFormGroup } from '@open-mercato/ui/backend/CrudForm'
-
-const fields: CrudField[] = [
-  { id: 'name', label: 'Name', type: 'text', required: true },
-  { id: 'description', label: 'Description', type: 'textarea' },
-  { id: 'status', label: 'Status', type: 'select', options: [...] },
-  { id: 'config', label: 'Config', type: 'custom', component: (props) => <JsonBuilder {...props} /> },
-]
-
-const groups: CrudFormGroup[] = [
-  { id: 'basic', title: 'Basic Info', column: 1, fields: ['name', 'description'] },
-  { id: 'settings', title: 'Settings', column: 1, fields: ['status', 'config'] },
-]
-
-<CrudForm
-  title="Create Item"
-  fields={fields}
-  groups={groups}
-  initialValues={{}}
-  onSubmit={handleSubmit}
-  submitLabel="Save"
-  embedded={true}  // For use inside dialogs
-  extraActions={<Button onClick={handleDelete}>Delete</Button>}
-/>
-```
-
-### Dialog with Form
-```tsx
-import { Dialog, DialogContent, DialogHeader, DialogTitle } from '@open-mercato/ui/primitives/dialog'
-import { CrudForm } from '@open-mercato/ui/backend/CrudForm'
-
-<Dialog open={isOpen} onOpenChange={onClose}>
-  <DialogContent className="sm:max-w-2xl [&_.grid]:!grid-cols-1">
-    <DialogHeader>
-      <DialogTitle>Edit Item</DialogTitle>
-    </DialogHeader>
-    <CrudForm
-      fields={fields}
-      groups={groups}
-      initialValues={initialValues}
-      onSubmit={handleSubmit}
-      embedded={true}
-      submitLabel="Save"
-    />
-  </DialogContent>
-</Dialog>
-```
-
-### Detail Page with Inline Editing
-```tsx
-import { DetailFieldsSection, LoadingMessage, ErrorMessage } from '@open-mercato/ui/backend/detail'
-
-if (isLoading) return <LoadingMessage message="Loading..." />
-if (error) return <ErrorMessage title="Error" description={error.message} />
-
-<DetailFieldsSection
-  fields={[
-    { id: 'name', label: 'Name', type: 'text' },
-    { id: 'status', label: 'Status', type: 'select', options: [...] },
-  ]}
-  entity={entity}
-  onUpdate={handleUpdate}
-/>
-```
-
-### API Calls
-```tsx
-import { apiCall } from '@open-mercato/ui/backend/utils/apiCall'
-import { createCrud, updateCrud, deleteCrud } from '@open-mercato/ui/backend/utils/crud'
-
-// Generic API call
-const result = await apiCall<ResponseType>('/api/endpoint', { method: 'POST', body: JSON.stringify(data) })
-if (result.ok) {
-  // result.result contains the parsed JSON response
-}
-
-// CRUD operations
-const created = await createCrud<ItemType>('module/items', payload)
-const updated = await updateCrud<ItemType>('module/items', id, payload)
-const deleted = await deleteCrud('module/items', id)
-```
-
-## Important Notes
-
-1. **Always use `flash()` for notifications** - Don't use `alert()` or custom toast implementations
-2. **Use `CrudForm` for forms** - Provides consistent validation, field rendering, and keyboard shortcuts
-3. **Use `DataTable` for lists** - Includes filtering, sorting, pagination, export, and perspectives
-4. **Keep `extensionTableId` stable** - Injection spots must remain backward-compatible
-5. **Use `JsonBuilder` for JSON editing** - Provides both raw JSON and visual builder modes
-6. **Dialog forms need `embedded={true}`** - And add `[&_.grid]:!grid-cols-1` to DialogContent for single-column layout
-7. **Support Cmd/Ctrl+Enter and Escape** - All dialogs should support these keyboard shortcuts

package/dist/agentic/shared/ai/skills/om-data-model-design/references/mikro-orm-cheatsheet.md

@@ -1,146 +0,0 @@
-# MikroORM Entity Cheatsheet
-
-## Property Decorators
-
-```typescript
-// String
-@Property({ type: 'varchar', length: 255 })
-name!: string
-
-// Text (unlimited)
-@Property({ type: 'text' })
-description!: string
-
-// Integer
-@Property({ type: 'int' })
-count!: number
-
-// Decimal (money)
-@Property({ type: 'decimal', precision: 10, scale: 2 })
-amount!: string  // Note: decimals are strings in MikroORM
-
-// Boolean
-@Property({ type: 'boolean', default: false })
-is_published: boolean = false
-
-// UUID
-@Property({ type: 'uuid' })
-reference_id!: string
-
-// Date only
-@Property({ type: 'date' })
-birth_date!: Date
-
-// Date + time with timezone
-@Property({ type: 'timestamptz' })
-created_at: Date = new Date()
-
-// Auto-update timestamp
-@Property({ type: 'timestamptz', onUpdate: () => new Date() })
-updated_at: Date = new Date()
-
-// Nullable
-@Property({ type: 'varchar', length: 255, nullable: true })
-optional_field: string | null = null
-
-// JSONB
-@Property({ type: 'jsonb', nullable: true })
-metadata: Record<string, unknown> | null = null
-
-// JSONB with default
-@Property({ type: 'jsonb', default: '[]' })
-tags: string[] = []
-
-// Enum
-@Enum({ items: () => StatusEnum })
-status: StatusEnum = StatusEnum.DRAFT
-```
-
-## Index Decorators
-
-```typescript
-// Simple index
-@Index()
-@Property({ type: 'uuid' })
-organization_id!: string
-
-// Unique index
-@Index({ unique: true })
-@Property({ type: 'varchar', length: 255 })
-email!: string
-
-// Composite unique (on entity level)
-@Entity({ tableName: 'product_tags' })
-@Unique({ properties: ['product_id', 'tag_id'] })
-export class ProductTag { ... }
-```
-
-## Common Queries
-
-```typescript
-// Find all (with tenant filter)
-const items = await em.find(Entity, {
-  organization_id: orgId,
-  deleted_at: null,
-})
-
-// Find one by ID
-const item = await em.findOne(Entity, {
-  id: itemId,
-  organization_id: orgId,
-})
-
-// Find with conditions
-const items = await em.find(Entity, {
-  organization_id: orgId,
-  status: StatusEnum.ACTIVE,
-  created_at: { $gte: startDate },
-})
-
-// Find with IN clause (batch lookup)
-const items = await em.find(Entity, {
-  id: { $in: idArray },
-  organization_id: orgId,
-})
-
-// Count
-const count = await em.count(Entity, {
-  organization_id: orgId,
-  deleted_at: null,
-})
-
-// Pagination
-const items = await em.find(Entity, {
-  organization_id: orgId,
-}, {
-  limit: pageSize,
-  offset: (page - 1) * pageSize,
-  orderBy: { created_at: 'DESC' },
-})
-```
-
-## Zod Validator Patterns
-
-```typescript
-import { z } from 'zod'
-
-// Create schema
-export const createEntitySchema = z.object({
-  name: z.string().min(1).max(255),
-  description: z.string().optional(),
-  amount: z.number().positive(),
-  status: z.enum(['draft', 'active', 'archived']),
-  tags: z.array(z.string()).default([]),
-  metadata: z.record(z.unknown()).optional(),
-  referenceId: z.string().uuid().optional(),
-})
-
-// Update schema (partial + required id)
-export const updateEntitySchema = createEntitySchema.partial().extend({
-  id: z.string().uuid(),
-})
-
-// Derive types
-export type CreateEntityInput = z.infer<typeof createEntitySchema>
-export type UpdateEntityInput = z.infer<typeof updateEntitySchema>
-```

package/dist/agentic/shared/ai/skills/om-help/references/skills-catalog.md

@@ -1,84 +0,0 @@
-# Skills Catalog — Standalone App
-
-> All skills available in a `create-mercato-app` project, organized by category.  
-> Load this file when answering "what skill should I use?" or "what comes next?".
-
-## Table of Contents
-
-- [Building Your App](#building-your-app)
-- [Extending & Customizing](#extending--customizing)
-- [Troubleshooting & Maintenance](#troubleshooting--maintenance)
-- [PR & Code Quality](#pr--code-quality)
-- [Migration](#migration)
-
----
-
-## Building Your App
-
-Skills for creating new functionality in your standalone Open Mercato application.
-
-| Skill | Trigger / When to use | Preceded by | Followed by |
-|-------|----------------------|-------------|-------------|
-| `om-help` | "what now?", "which skill?", "next steps?", "how do I X?", orientation | — | any |
-| `om-data-model-design` | Designing entities, relationships, migrations, encryption maps for PII | — | `om-spec-writing` or `om-module-scaffold` |
-| `om-spec-writing` | Writing a spec before building a non-trivial feature | `om-data-model-design` | `om-module-scaffold` or `om-implement-spec` |
-| `om-module-scaffold` | Creating a new module with entity, routes, pages, ACL, DI | `om-spec-writing` or `om-data-model-design` | `om-integration-tests` |
-| `om-implement-spec` | Implementing an existing spec phase-by-phase | `om-spec-writing` | `om-integration-tests` |
-| `om-backend-ui-design` | Designing admin pages, CRUD forms, data tables | — | `om-implement-spec` or `om-module-scaffold` |
-| `om-integration-builder` | Building a payment, shipping, or data-sync integration provider | `om-spec-writing` | `om-integration-tests` |
-| `om-integration-tests` | Writing or running Playwright integration tests | `om-module-scaffold` or `om-implement-spec` | `om-code-review` |
-
----
-
-## Extending & Customizing
-
-Skills for modifying or extending behavior without touching core module source.
-
-| Skill | Trigger / When to use | Preceded by | Followed by |
-|-------|----------------------|-------------|-------------|
-| `om-system-extension` | Add columns/fields/filters to existing tables, enrich API responses, intercept routes, inject menu items, replace UI components | — | `om-code-review` |
-| `om-eject-and-customize` | When UMES extensions aren't enough and you need to modify core module source directly | — | `om-code-review` |
-| `om-trim-unused-modules` | Slim down the app by disabling modules you don't use | — | `om-code-review` |
-
----
-
-## Troubleshooting & Maintenance
-
-| Skill | Trigger / When to use | Preceded by | Followed by |
-|-------|----------------------|-------------|-------------|
-| `om-troubleshooter` | Errors, module not loading, widgets not appearing, migration failures, build errors, "it doesn't work" | — | `om-code-review` (after fix) |
-
----
-
-## PR & Code Quality
-
-| Skill | Trigger / When to use | Preceded by | Followed by |
-|-------|----------------------|-------------|-------------|
-| `om-code-review` | Review before merging — architecture, security, DS, conventions | any impl skill | `om-auto-create-pr` |
-| `om-auto-create-pr` | Ship work as a GitHub PR end-to-end | `om-code-review` | `om-auto-review-pr` |
-| `om-auto-continue-pr` | Resume an in-progress PR started by `om-auto-create-pr` | — | `om-auto-review-pr` |
-| `om-auto-create-pr-loop` | Long multi-step implementation with step-level resumability | — | `om-auto-review-pr` |
-| `om-auto-continue-pr-loop` | Resume a PR started by `om-auto-create-pr-loop` | — | `om-auto-review-pr` |
-| `om-auto-review-pr` | Automated PR review + approve/request-changes | `om-auto-create-pr` | — |
-| `om-auto-fix-issue` | Fix a GitHub issue end-to-end (drives `om-verify-in-repo` → `om-root-cause` → `om-fix` → `om-open-pr`) | — | `om-auto-create-pr` |
-| `om-prepare-issue` | Capture a feature to build later — write the spec, ship a docs-only spec PR, open a tracking issue | `om-spec-writing` | `om-implement-spec` |
-| `om-prepare-test-env` | Boot a reusable local test environment (shared descriptor for QA + integration tests) | — | `om-integration-tests` |
-| `om-setup-agent-pipeline` | Tailor `.ai/agentic.config.json` (labels, QA gate, tracker, validation commands) — the scaffold ships working defaults | — | any auto-skill |
-| `om-apply-upgrade-notes` | Sync installed pipeline artifacts after `yarn install-skills` refreshed the external collection | — | — |
-
----
-
-## Migration
-
-| Skill | Trigger / When to use | Preceded by | Followed by |
-|-------|----------------------|-------------|-------------|
-| `om-auto-upgrade-0.4.10-to-0.5.0` | Upgrade app from Open Mercato 0.4.10 → 0.5.0 | — | `om-code-review` |
-
----
-
-## Notes
-
-- **preceded-by / followed-by** are suggestions, not hard constraints.
-- `om-troubleshooter` is always a valid entry point when something is broken.
-- `om-system-extension` should be tried before `om-eject-and-customize` — ejecting makes upgrades harder.
-- `om-help` is always the right starting point when you're unsure.