patch

wicked-patch

Generate and propagate code changes across your entire codebase using the symbol graph.

Quick Start

# 1. Index your codebase (if not already done)
/wicked-garden:search:index /path/to/project

# 2. Add a field to an entity
/wicked-garden:engineering:add-field "Entity.java::User" --name email --type String

# 3. Rename a field everywhere
/wicked-garden:engineering:rename "Entity.java::User" --old status --new state

# 4. See propagation plan
/wicked-garden:engineering:plan "Entity.java::User" --change add_field

Commands

Command	Purpose
/wicked-garden:engineering:plan	Show what would be affected
/wicked-garden:engineering:add-field	Add field with propagation
/wicked-garden:engineering:rename	Rename across all usages
/wicked-garden:engineering:remove	Remove field everywhere
/wicked-garden:engineering:apply	Apply saved patches

Supported Languages

Extension	Features
.java	JPA @Column, getters/setters, validation
.py	SQLAlchemy, Pydantic, dataclass
.ts, .js	TypeORM, interfaces, types
.jsp	Spring form tags, EL expressions
.sql	ALTER TABLE (PostgreSQL, Oracle, MySQL, SQL Server)

How It Works

ChangeSpec (add field "email" to User)
           │
           ▼
   ┌───────────────────┐
   │ Propagation Engine │  ← Uses wicked-garden:search lineage graph
   └───────────────────┘
           │
    ┌──────┼──────┬──────────┐
    ▼      ▼      ▼          ▼
  Java   Python   SQL      JSP
   │       │       │         │
   ▼       ▼       ▼         ▼
Patches  Patches Patches  Patches

Examples

Add Field to JPA Entity

/wicked-garden:engineering:add-field "User.java::User" \
  --name email \
  --type String \
  --column USER_EMAIL \
  --required

Generates:

// User.java
@Column(name = "USER_EMAIL")
@NotNull
private String email;

public String getEmail() { return this.email; }
public void setEmail(String email) { this.email = email; }

-- migration.sql
ALTER TABLE USERS ADD COLUMN USER_EMAIL VARCHAR(255) NOT NULL;

Rename Field Everywhere

/wicked-garden:engineering:rename "Order.java::Order" --old status --new orderStatus

Updates:

• Entity field declaration
• Getters/setters
• JSP form bindings (${order.status} → ${order.orderStatus})
• Service layer references
• Test files (with warning)

Save and Review Patches

# Generate patches without applying
/wicked-garden:engineering:add-field SYMBOL --name foo --type String --output patches.json

# Review the patches file
cat patches.json

# Apply when ready
/wicked-garden:engineering:apply patches.json

Type Mappings

Generic types are automatically mapped per language:

Generic	Java	Python	TypeScript	SQL
string	String	str	string	VARCHAR(255)
integer	Integer	int	number	INTEGER
boolean	boolean	bool	boolean	BOOLEAN
date	LocalDate	date	Date	DATE
datetime	LocalDateTime	datetime	Date	TIMESTAMP
decimal	BigDecimal	Decimal	number	DECIMAL(18,2)

SQL Dialect Support

Auto-detected or specify via --dialect:

-- PostgreSQL (default)
ALTER TABLE users ADD COLUMN email VARCHAR(255);

-- Oracle
ALTER TABLE users ADD (email VARCHAR2(255));

-- MySQL
ALTER TABLE users ADD COLUMN email VARCHAR(255);

-- SQL Server
ALTER TABLE users ADD email NVARCHAR(255);

Integration with wicked-garden:search

wicked-patch reads from the wicked-garden:search symbol database:

# 1. wicked-garden:search creates the graph
/wicked-garden:search:index /project --derive-all

# 2. wicked-patch uses it for propagation
/wicked-garden:engineering:add-field SYMBOL --name foo --type String

Safety Features

• Dry-run by default: Shows patches without applying
• Confirmation prompt: Asks before applying
• Patch files: Save for review before applying
• Warnings: Highlights test files and unsupported types
• Reversible: Use git to undo

CLI Reference

cd "${CLAUDE_PLUGIN_ROOT}/scripts"
sh "${CLAUDE_PLUGIN_ROOT}/scripts/_python.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/patch.py" --help
sh "${CLAUDE_PLUGIN_ROOT}/scripts/_python.sh" "${CLAUDE_PLUGIN_ROOT}/scripts/patch.py" generators  # List supported languages