apply

OpenAPI Apply

Apply OpenAPI spec changes throughout your entire codebase. This command handles the complete ripple effect - updating not just generated API code, but also all components, pages, and utilities that use the changed APIs.

This is the killer feature: When an API field is renamed or a type changes, this command finds and updates EVERY usage automatically.

---

EXECUTION INSTRUCTIONS

When /oas:apply is invoked, Claude MUST perform these steps in order:

Step 0: MCP Dependency Check

Invoke skill: mcp-dependency

• Verify OpenAPI Sync MCP server is installed
• If not available, offer to install via npm install -g @jhlee0409/openapi-sync-mcp
• Only proceed after MCP is confirmed available

1. Use skill: cache-manager - Detect spec changes (diff)
2. Load mapping - Read usage mapping from /oas:map
3. Analyze changes - Classify each change type
4. Calculate impact - Find all affected files
5. Generate change plan - Create detailed modification plan
6. User confirmation - Show plan and get approval
7. Apply changes - Execute modifications with Edit tool
8. Verify - Run TypeScript check if available
9. Report - Show summary of all changes

---

Usage

# Apply all pending changes
/oas:apply

# Preview only (recommended first)
/oas:apply --dry-run

# Apply specific change only
/oas:apply --change=User.status

# Skip confirmation
/oas:apply --yes

# Apply with automatic TypeScript fix
/oas:apply --fix

---

Change Types & Handling

Type 1: Field Renamed

Spec Change:

# Before
User:
  properties:
    userName: { type: string }

# After
User:
  properties:
    name: { type: string }  # Renamed from userName

Impact Analysis:

Field renamed: User.userName → User.name

Affected locations:
  1. src/entities/users/model/types.ts:5
     - interface User { userName: string }
     + interface User { name: string }

  2. src/pages/users/[id].tsx:25
     - <h1>{user.userName}</h1>
     + <h1>{user.name}</h1>

  3. src/features/user-profile/UserCard.tsx:18
     - const displayName = user.userName
     + const displayName = user.name

  4. src/utils/formatters.ts:12
     - return `${user.userName} (${user.email})`
     + return `${user.name} (${user.email})`

Total: 4 files, 4 changes