@wise/wds-codemods 1.0.0-experimental-8d76db0 → 1.0.0-experimental-cdf94ec

package/README.md

@@ -12,9 +12,12 @@
 - [The Repository](#-the-repository)
 - [Getting Started](#-getting-started)
 - [CLI Options](#cli-options)
+- [Transform Engines](#-transform-engines)
+  - [jscodeshift Transforms](#jscodeshift-transforms)
+  - [AI Transforms](#ai-transforms)
 - [Available Transforms](#-available-transforms)
-  - [Button Transform](./readme-button.md)
-  - [ListItem Transform](./readme-list-item.md)
+  - [Button Transform](./src/transforms/button/README.md)
+  - [ListItem Transform](./src/transforms/list-item/README.md)
 - [Key Features](#-key-features)
 - [Working with the Project Locally](#-working-with-the-project-locally)
 - [Writing Codemod Transforms](#-writing-codemod-transforms)
@@ -74,10 +77,10 @@ You'll be prompted to:
 
 1. Select a transform (`button` or `list-item`)
 2. Enter target directory or file path
-3. Choose dry-run mode (preview without writing) (🔘 `button` only)
+3. Choose dry-run mode (preview without writing) (jscodeshift engine only)
 4. Choose whether to print transformed output
 5. Configure monorepo detection (auto-detected in most cases)
-6. Answer transform-specific configuration questions (🔘 `button` only)
+6. Answer transform-specific configuration questions (jscodeshift engine only)
 
 #### Direct CLI Mode
 
@@ -103,7 +106,7 @@ All codemods support these command-line options:
 | `--ignore-pattern=GLOB` | Ignore files matching [glob pattern(s)](https://code.visualstudio.com/docs/editor/glob-patterns) (comma-separated) |
 | `--monorepo`            | Enable monorepo package checking across workspace folders                                                          |
 
-Only button transform supports the following options:
+Only jscodeshift engine supports the following options (.gitignore is always respected with AI Engine):
 
 | Option                | Description                              |
 | --------------------- | ---------------------------------------- |
@@ -133,43 +136,59 @@ wds-codemods button ./packages --monorepo
 wds-codemods button ./src --print --dry
 ```
 
-## 💻 Available Transforms
+## 🔧 Transform Engines
 
-We currently provide two codemods for migrating Wise Design System components:
+This project supports two types of transform engines, each suited for different transformation needs:
 
-### 🔘 [Button Transform (`button`)](./README-BUTTON.md)
+### jscodeshift Engine
 
-Migrates `Button` and `ActionButton` components from `@transferwise/components` to the new v2 API.
+**Best for:** Predictable, rule-based transformations with clear input/output mappings.
 
-- **Engine**: jscodeshift (AST-based transformations)
-- **Prerequisites**: `@transferwise/components >=46.5.0`
+**How it works:**
 
-**What it does:**
+- Parses code into an Abstract Syntax Tree (AST)
+- Applies deterministic transformations based on pattern matching
+- Guarantees consistent results across runs
 
-- Converts `ActionButton` + `Button` → `Button` with v2 prop
-- Migrates legacy props (`priority`, `size`, `type`, `sentiment`)
-- Processes icon children into addon props
-- Handles link buttons and enum conversions
+**Features:**
 
-**[→ Full Button Transform Documentation](./README-BUTTON.md)**
+- Dry-run mode to preview changes without writing files
+- Manual review reports for edge cases
+- Fast execution on large codebases
 
----
+**Prerequisites:**
+
+- Package version requirements (validated automatically)
+
+**Example transforms:** Button migration
 
-### 📋 [ListItem Transform (`list-item`)](./README-LIST-ITEM.md)
+### AI Engine
 
-Migrates legacy `Option` and `Summary` components to `ListItem` component and subcomponents.
+**Best for:** Complex, context-aware transformations that require understanding intent.
 
-- **Engine**: Claude AI (context-aware transformations)
-- **Prerequisites**: `@transferwise/components >=46.104.0` + LLM Gateway access
+**How it works:**
 
-**What it does:**
+- Uses Claude AI to migrate code based on pregenrated instructions
 
-- Converts `ActionOption`, `NavigationOption`, `Summary`, `SwitchOption`, `CheckboxOption`, `RadioOption`, `NavigationOptionList`
-- Maps to `ListItem` + subcomponents (`ListItem.Button`, `ListItem.Checkbox`, etc.)
-- Handles complex state requirements (modals, popovers)
-- Preserves HTML attributes and removes legacy props
+**Features:**
 
-**[→ Full ListItem Transform Documentation](./README-LIST-ITEM.md)**
+- Handles ambiguous cases that would require manual review in jscodeshift
+
+**Prerequisites:**
+
+- Access to Wise LLM Gateway
+- Claude configured locally
+- VPN connection
+- Package version requirements (validated automatically)
+
+**Example transforms:** ListItem migration
+
+---
+
+## 💻 Available Transforms
+
+- **[Button](./src/transforms/button/README.md)** - Migrates `Button` and `ActionButton` to the new v2 API using jscodeshift
+- **[ListItem](./src/transforms/list-item/README.md)** - Migrates legacy `Option` and `Summary` components to `ListItem` using Claude AI
 
 ---
 
@@ -193,17 +212,17 @@ Before running any transform, the codemod automatically:
 
 ### Manual Review Reporting
 
-**🔘 Button transform only:**
+**jscodeshift engine:**
 
 - Generates `codemod-report.txt` for cases needing manual attention
 - Includes file paths, line numbers, and specific issue descriptions
 - Reports spread props, dynamic expressions, and unsupported values
 - Auto-removes old reports and provides fresh summaries
 
-**📋 ListItem transform:**
+**AI engine:**
 
 - No report file generated
-- Claude handles complex cases inline
+- Handles complex cases inline during transformation
 
 ### Smart Processing
 
@@ -370,7 +389,13 @@ For comprehensive development details, including transform architecture, helper
 
 [jscodeshift](https://github.com/facebook/jscodeshift) is a toolkit for running codemods over multiple JavaScript or TypeScript files. It provides an API to parse source code into an Abstract Syntax Tree (AST), manipulate it, and print the transformed code back.
 
-This project uses jscodeshift as the core engine to perform code transformations.
+jscodeshift is one of two engines to perform code transformations.
+
+### @anthropic-ai/claude-agent-sdk
+
+[@anthropic-ai/claude-agent-sdk](https://www.npmjs.com/package/@anthropic-ai/claude-agent-sdk) is Anthropic's SDK for building AI-powered agents with Claude. It provides tools for creating context-aware transformations that can understand code semantics and intent.
+
+Claude Agent SDK is one of two engines to perform code transformations
 
 ### @inquirer/prompts
 
@@ -386,4 +411,4 @@ This project uses @inquirer/prompts to provide a user-friendly interactive exper
 
 ## ✍️ Feedback
 
-Please ask any questions on this project, you can do so by reaching out on Slack. Or contributing to any [active issues](https://transferwise.atlassian.net/jira/software/projects/DS/boards/277/backlog).
+Please ask any questions on this project, you can do so by reaching out on [Slack](https://wise.enterprise.slack.com/archives/CJNBX9CP6) or contributing to any [active issues](https://transferwise.atlassian.net/jira/software/projects/DS/boards/277/backlog).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wise/wds-codemods",
-  "version": "1.0.0-experimental-8d76db0",
+  "version": "1.0.0-experimental-cdf94ec",
   "license": "UNLICENSED",
   "author": "Wise Payments Ltd.",
   "repository": {