Nextify Review

Nextify Review는 nextify-cli로 생성된 마이그레이션 변경 내용을 VS Code 안에서 트리와 diff로 확인하는 리뷰용 확장입니다.

migrate-next 실행 후 만들어지는 .ai-migration/stepN/session.json을 읽고, 변경된 파일을 프로젝트 폴더 구조처럼 보여줍니다. 파일을 선택하면 변경 전/후 diff를 열 수 있고, 필요한 경우 BEFORE/AFTER 파일 경로를 복사해 추가 검토에 사용할 수 있습니다.

이 확장은 review-only 도구입니다. 마이그레이션을 실행하거나, 파일을 수정하거나, 변경 사항을 적용/되돌리지 않습니다.

설치

VS Code Marketplace에서 Nextify Review를 검색해 설치하세요.

확장 ID:

capstone0123.nextify-review

사용 흐름

VS Code 또는 Cursor에서 마이그레이션할 React(Vite) 프로젝트 폴더를 엽니다.
프로젝트 루트 터미널에서 Nextify CLI를 실행합니다.

npx nextify-cli@latest

또는 전역 설치 후 실행할 수 있습니다.

npm install -g nextify-cli
migrate-next

CLI가 .ai-migration/stepN/session.json 리뷰 세션을 생성하면, Explorer의 Nextify Review 패널을 엽니다.
폴더를 펼쳐 변경 파일을 확인합니다.
파일 이름 또는 created, modified, deleted 배지를 클릭해 diff를 엽니다.
필요한 경우 Copy BEFORE Path 또는 Copy AFTER Path로 선택한 파일 경로를 복사합니다.

변경 타입

타입	의미
`created`	새로 생성된 파일입니다. 빈 placeholder와 생성 파일을 비교합니다.
`modified`	기존 파일이 수정되었습니다. 원본 파일과 마이그레이션 결과를 비교합니다.
`deleted`	기존 파일이 삭제되었습니다. 원본 파일과 빈 placeholder를 비교합니다.

주요 기능

.ai-migration/**/session.json 자동 감지
프로젝트 폴더 구조와 유사한 변경 파일 트리
변경 파일별 VS Code diff 열기
선택 파일의 BEFORE/AFTER 경로 복사
활성 세션 자동 새로고침
여러 세션이 있을 경우 가장 큰 stepN 세션 우선 표시

명령어

Command Palette에서 사용할 수 있는 명령어입니다.

명령어	설명
`Nextify Review: Focus Panel`	Explorer의 Nextify Review 패널로 이동합니다.
`Nextify Review: Refresh Session`	최신 활성 세션을 다시 읽습니다.
`Nextify Review: Open Selected Diff`	선택된 변경 파일의 diff를 엽니다.
`Nextify Review: Copy session.json Path`	현재 세션 파일 경로를 복사합니다.
`Nextify Review: Copy BEFORE Path`	선택 파일의 BEFORE 경로를 복사합니다.
`Nextify Review: Copy AFTER Path`	선택 파일의 AFTER 경로를 복사합니다.

알아두기

Nextify Review는 nextify-cli가 만든 리뷰 세션을 읽는 확장입니다.
마이그레이션 실행은 CLI에서 진행합니다.
이 확장은 Accept/Reject 버튼을 제공하지 않습니다.
이 확장은 파일을 직접 수정하지 않습니다.
AI 리뷰가 필요하면 CLI의 migrate-next review 또는 별도 리뷰 도구에서 복사한 경로를 활용하세요.

문제가 있을 때

패널에 세션이 없다고 표시됩니다

프로젝트 루트에서 migrate-next를 먼저 실행했는지 확인하세요.

.ai-migration/stepN/session.json

위와 같은 파일이 있어야 패널에 변경 목록이 표시됩니다.

원하는 세션이 보이지 않습니다

같은 워크스페이스에 여러 session.json이 있으면 가장 큰 stepN 번호의 활성 세션을 표시합니다.

diff가 열리지 않습니다

세션 파일의 BEFORE/AFTER 경로가 실제 파일을 가리키는지 확인하세요. 현재 확장은 diffBeforePath / diffAfterPath를 우선 사용하고, 없으면 beforePath / afterPath를 사용합니다.

Nextify Review

Nextify Review is a review-only extension for inspecting migration changes created by nextify-cli inside VS Code.

After you run migrate-next, the CLI writes a review session to .ai-migration/stepN/session.json. This extension reads that session, displays changed files in a project-like tree, and opens before/after diffs for selected files.

This extension is review-only. It does not run migrations, edit files, apply changes, or revert changes.

Install

Install Nextify Review from the VS Code Marketplace.

Extension ID:

capstone0123.nextify-review

Workflow

Open your React(Vite) project folder in VS Code or Cursor.
Run Nextify CLI from the project root.

npx nextify-cli@latest

Or install it globally and run the binary:

npm install -g nextify-cli
migrate-next

When the CLI creates .ai-migration/stepN/session.json, open the Nextify Review panel in Explorer.
Expand folders to inspect changed files.
Click a file name or its created, modified, or deleted badge to open a diff.
Use Copy BEFORE Path or Copy AFTER Path when you need the selected file path for additional review.

Change Types

Type	Meaning
`created`	A new file was created. The diff compares an empty placeholder with the created file.
`modified`	An existing file was changed. The diff compares the original file with the migrated result.
`deleted`	An existing file was removed. The diff compares the original file with an empty placeholder.

Features

Automatically detects .ai-migration/**/session.json
Displays changed files as a project-like tree
Opens VS Code diffs for changed files
Copies BEFORE/AFTER paths for the selected file
Refreshes when the active session changes
Uses the largest stepN active session when multiple sessions exist

Commands

Available from the Command Palette:

Command	Description
`Nextify Review: Focus Panel`	Opens Explorer and focuses the Nextify Review panel.
`Nextify Review: Refresh Session`	Re-reads the latest active session.
`Nextify Review: Open Selected Diff`	Opens the selected change in a diff tab.
`Nextify Review: Copy session.json Path`	Copies the current session file path.
`Nextify Review: Copy BEFORE Path`	Copies the selected file's BEFORE path.
`Nextify Review: Copy AFTER Path`	Copies the selected file's AFTER path.

Notes

Nextify Review reads review sessions created by nextify-cli.
Migration is handled by the CLI.
This extension does not provide Accept/Reject buttons.
This extension does not modify files.
For AI-assisted review, use migrate-next review or paste copied paths into your review tool.

Troubleshooting

The panel says there is no session

Run migrate-next from the project root first.

.ai-migration/stepN/session.json

The panel needs a session file like this to show changes.

The expected session is not shown

If multiple session.json files exist in the workspace, the extension shows the active session with the largest stepN number.

A diff does not open

Check that the BEFORE/AFTER paths in the session file point to existing files. The extension uses diffBeforePath / diffAfterPath first, then falls back to beforePath / afterPath.