om-auto-upgrade-0.4.10-to-0.5.0

Applies codemods migrating Open Mercato apps from framework 0.4.10 to 0.5.0.

1.7k|382|Updated Sep 10, 2025
One-click install
npx skills add https://github.com/open-mercato/open-mercato --skill om-auto-upgrade-0-4-10-to-0-5-0
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: om-auto-upgrade-0.4.10-to-0.5.0
Source: https://github.com/open-mercato/open-mercato/tree/main/packages/create-app/agentic/shared/ai/skills/om-auto-upgrade-0.4.10-to-0.5.0
Command: npx skills add https://github.com/open-mercato/open-mercato --skill om-auto-upgrade-0-4-10-to-0-5-0

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Upgrading an Open Mercato app from 0.4.10 to 0.5.0 requires many small breaking-change fixes across dependencies like Meilisearch, Stripe, lucide-react, cron-parser, and react-email. Doing these edits by hand is error-prone and easy to miss.

Core Features & Use Cases

  • Automated codemods: Detects and rewrites ten documented breaking-change patterns, including the Meilisearch class rename, Stripe API-version typing, lucide-react brand-icon removal, react-markdown className wrapping, and cron-parser API rename.
  • Detection-first workflow: Scans the project, prints a plan of matched files, and asks for confirmation before editing, with --dry-run, --skip, and --only options.
  • Verification and reporting: Runs TypeScript checks and Jest tests after edits, rolls back failing codemods, and reports applied, skipped, and manual-review items.
  • Use Case: After bumping @open-mercato/* dependencies to 0.5.0 and running yarn install, run this skill to mechanically fix all affected source files and get a list of changes needing human review.

Quick Start

Ask the assistant to upgrade your Open Mercato project from 0.4.10 to 0.5.0 and apply the 0.5.0 upgrade codemods to the current app.

Frequently Asked Questions about om-auto-upgrade-0.4.10-to-0.5.0

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I upgrade Open Mercato from 0.4.10 to 0.5.0?

First bump your @open-mercato/* dependencies to 0.5.0 and run yarn install, then run this skill. It detects which breaking-change patterns exist in your code, applies the codemods, and verifies the result with tsc and Jest.

What breaking changes does the Open Mercato 0.5.0 upgrade include?

The codemods cover the Meilisearch class rename, Stripe API-version typing and retrieveCurrent, lucide-react brand-icon removal, react-markdown className wrapping, cron-parser CronExpressionParser rename, @simplewebauthn Uint8Array narrowing, react-email CLI rename, and a Jest ESM allow-list.

Does the skill update the @open-mercato dependencies itself?

No. It does not bump dependency versions or regenerate yarn.lock. You must change your @open-mercato/* pins to 0.5.0 and run yarn install before running the codemods.

Can I run the upgrade codemods without modifying files?

Yes. Use the --dry-run flag to print planned edits without writing, or use --skip and --only to control which codemods execute. The skill also prints a detection plan and asks for confirmation before editing.

When should I not use the 0.4.10 to 0.5.0 upgrade skill?

Do not use it if your app is on a version other than 0.4.10, or for deferred major upgrades like MikroORM 7, TypeScript 6, Awilix 13, recharts 3, or eslint 10. Those require manual migration or a matching auto-upgrade skill.