difit 4.0.1 → 4.0.3

package/README.ja.md

@@ -140,13 +140,14 @@ git diff --cached | difit -
 | --------------------- | --------------- | ------------------------------------------------------------------------------------------ |
 | `<target>`            | HEAD            | コミットハッシュ、タグ、HEAD~n、ブランチ、または特別な引数                                 |
 | `[compare-with]`      | -               | 比較対象の2番目のコミット（2つの間のdiffを表示）                                           |
+| `--merge-base`        | false           | diff 計算前に `git merge-base` で基準側を解決する（Git revision モード専用）               |
 | `--pr <url>`          | -               | レビューするGitHub PRのURL（例：https://github.com/owner/repo/pull/123）                   |
 | `--comment <json>`    | -               | 起動時に初期コメントを注入（複数指定可。JSON object または array を受け付ける）            |
 | `--port`              | 4966            | 優先ポート。使用中の場合は+1にフォールバック                                               |
 | `--host`              | 127.0.0.1       | サーバーをバインドするホストアドレス（外部からアクセスしたい場合は0.0.0.0を指定）          |
 | `--no-open`           | false           | ブラウザを自動的に開かない                                                                 |
 | `--mode`              | split           | 表示モード。`unified`または`split`                                                         |
-| `--tui`               | false           | WebUIの代わりにターミナルUIを使用                                                          |
+| `--tui` (deprecated)  | false           | WebUIの代わりにターミナルUIを使用                                                          |
 | `--clean`             | false           | 起動時に既存コメントと閲覧済みファイルをすべてクリア                                       |
 | `--include-untracked` | false           | diffにuntrackedファイルを自動的に含める（`.`または`working`のみ有効）                      |
 | `--keep-alive`        | false           | ブラウザ切断後もサーバーを終了せず起動したままにする（Ctrl+Cで手動停止）                   |

package/README.ko.md

@@ -140,13 +140,14 @@ git diff --cached | difit -
 | --------------------- | -------------- | --------------------------------------------------------------------------------------------- |
 | `<target>`            | HEAD           | 커밋 해시, 태그, HEAD~n, 브랜치 또는 특수 인수                                                |
 | `[compare-with]`      | -              | 비교할 선택적 두 번째 커밋 (둘 사이의 diff 표시)                                              |
+| `--merge-base`        | false          | diff 전에 `git merge-base` 로 기준 쪽을 해석 (Git revision 모드 전용)                         |
 | `--pr <url>`          | -              | 검토할 GitHub PR URL (예: https://github.com/owner/repo/pull/123)                             |
 | `--comment <json>`    | -              | 초기 코멘트 주입 (반복 가능; JSON object 또는 array 허용)                                     |
 | `--port`              | 4966           | 선호 포트; 사용 중인 경우 +1로 대체                                                           |
 | `--host`              | 127.0.0.1      | 서버를 바인딩할 호스트 주소 (외부 액세스는 0.0.0.0 사용)                                      |
 | `--no-open`           | false          | 브라우저를 자동으로 열지 않음                                                                 |
 | `--mode`              | split          | 표시 모드: `unified` 또는 `split`                                                             |
-| `--tui`               | false          | WebUI 대신 터미널 UI 모드 사용                                                                |
+| `--tui` (deprecated)  | false          | WebUI 대신 터미널 UI 모드 사용                                                                |
 | `--clean`             | false          | 시작 시 모든 기존 코멘트와 열람된 파일 표시 초기화                                            |
 | `--include-untracked` | false          | diff에 untracked 파일 자동 포함 (`.` 또는 `working`에서만 유효)                               |
 | `--keep-alive`        | false          | 브라우저 연결이 끊겨도 서버 유지 (Ctrl+C로 수동 종료)                                         |

package/README.md

@@ -140,13 +140,14 @@ Stdin mode is selected with intent-first rules:
 | --------------------- | --------------- | ------------------------------------------------------------------------------------------------------- |
 | `<target>`            | HEAD            | Commit hash, tag, HEAD~n, branch, or special arguments                                                  |
 | `[compare-with]`      | -               | Optional second commit to compare with (shows diff between the two)                                     |
+| `--merge-base`        | false           | Resolve the base revision with `git merge-base` before diffing (Git revision mode only)                 |
 | `--pr <url>`          | -               | GitHub PR URL to review (e.g., https://github.com/owner/repo/pull/123)                                  |
 | `--comment <json>`    | -               | Inject initial comments (repeatable; accepts a JSON object or array)                                    |
 | `--port`              | 4966            | Preferred port; falls back to +1 if occupied                                                            |
 | `--host`              | 127.0.0.1       | Host address to bind server to (use 0.0.0.0 for external access)                                        |
 | `--no-open`           | false           | Don't automatically open browser                                                                        |
 | `--mode`              | split           | Display mode: `unified` or `split`                                                                      |
-| `--tui`               | false           | Use terminal UI mode instead of WebUI                                                                   |
+| `--tui` (deprecated)  | false           | Use terminal UI mode instead of WebUI                                                                   |
 | `--clean`             | false           | Clear all existing comments and viewed files on startup                                                 |
 | `--include-untracked` | false           | Automatically include untracked files in diff (only with `.` or `working`)                              |
 | `--keep-alive`        | false           | Keep server running after browser disconnects (stop manually with Ctrl+C)                               |

package/README.zh.md

@@ -140,13 +140,14 @@ git diff --cached | difit -
 | --------------------- | -------------- | --------------------------------------------------------------------------------- |
 | `<target>`            | HEAD           | 提交哈希、标签、HEAD~n、分支或特殊参数                                            |
 | `[compare-with]`      | -              | 要比较的可选第二个提交（显示两者之间的差异）                                      |
+| `--merge-base`        | false          | 在 diff 前先用 `git merge-base` 解析基准 revision（仅限 Git revision 模式）       |
 | `--pr <url>`          | -              | 要审查的 GitHub PR URL（例如：https://github.com/owner/repo/pull/123）            |
 | `--comment <json>`    | -              | 注入初始评论（可重复指定；接受 JSON object 或 array）                             |
 | `--port`              | 4966           | 首选端口；如果被占用则回退到 +1                                                   |
 | `--host`              | 127.0.0.1      | 绑定服务器的主机地址（使用 0.0.0.0 进行外部访问）                                 |
 | `--no-open`           | false          | 不自动打开浏览器                                                                  |
 | `--mode`              | split          | 显示模式：`unified` 或 `split`                                                    |
-| `--tui`               | false          | 使用终端 UI 模式而不是 WebUI                                                      |
+| `--tui` (deprecated)  | false          | 使用终端 UI 模式而不是 WebUI                                                      |
 | `--clean`             | false          | 启动时清除所有现有评论和已查看的文件                                              |
 | `--include-untracked` | false          | 自动将 untracked 文件包含在 diff 中（仅在 `.` 或 `working` 时有效）               |
 | `--keep-alive`        | false          | 浏览器断开后保持服务器运行（使用 Ctrl+C 手动停止）                                |

package/dist/cli/index.js

@@ -4,14 +4,33 @@ import React from 'react';
 import { simpleGit } from 'simple-git';
 import pkg from '../../package.json' with { type: 'json' };
 import { startServer } from '../server/server.js';
+import { createDiffSelection } from '../utils/diffSelection.js';
 import { DiffMode } from '../types/watch.js';
 import { DEFAULT_DIFF_VIEW_MODE, normalizeDiffViewMode } from '../utils/diffMode.js';
 import { shouldReadStdin, findUntrackedFiles, markFilesIntentToAdd, promptUser, parseCommentOptions, validateDiffArguments, getGitRoot, } from './utils.js';
 import { getPrPatch, getPrCommentImports } from './github.js';
+import { warnAboutTuiDeprecation } from './tuiDeprecation.js';
 function isSpecialArg(arg) {
     return arg === 'working' || arg === 'staged' || arg === '.';
 }
-function determineDiffMode(targetCommitish, compareWith) {
+function resolveDiffSelection(commitish, compareWith, mergeBase) {
+    let baseCommitish;
+    if (compareWith) {
+        baseCommitish = compareWith;
+    }
+    else if (commitish === 'working') {
+        baseCommitish = 'staged';
+    }
+    else if (isSpecialArg(commitish)) {
+        baseCommitish = 'HEAD';
+    }
+    else {
+        baseCommitish = commitish + '^';
+    }
+    return createDiffSelection(baseCommitish, commitish, mergeBase ? 'merge-base' : undefined);
+}
+function determineDiffMode(selection, compareWith) {
+    const { targetCommitish } = selection;
     // If comparing specific commits/branches (not involving HEAD), no watching needed
     // Exception: allow watching when targetCommitish is '.' even with compareWith
     if (compareWith && targetCommitish !== 'HEAD' && targetCommitish !== '.') {
@@ -47,6 +66,7 @@ program
     .option('--include-untracked', 'automatically include untracked files in diff')
     .option('--keep-alive', 'keep server running even after browser disconnects')
     .option('--context <lines>', 'number of context lines shown around each change', parseInt)
+    .option('--merge-base', 'resolve the base revision with git merge-base before diffing (Git revision mode only)')
     .action(async (commitish, compareWith, options) => {
     try {
         let stdinDiff;
@@ -71,6 +91,10 @@ program
                 console.error('Error: --pr option cannot be used with positional arguments');
                 process.exit(1);
             }
+            if (options.mergeBase) {
+                console.error('Error: --merge-base option cannot be used with --pr');
+                process.exit(1);
+            }
             if (options.tui) {
                 console.error('Error: --pr option cannot be used with --tui');
                 process.exit(1);
@@ -108,6 +132,10 @@ program
                     console.error('Error: --context option cannot be used with stdin diff');
                     process.exit(1);
                 }
+                if (options.mergeBase) {
+                    console.error('Error: --merge-base option cannot be used with stdin diff');
+                    process.exit(1);
+                }
                 // Read unified diff from stdin
                 stdinDiff = await readStdin();
                 if (!stdinDiff.trim()) {
@@ -145,27 +173,12 @@ program
             // If not in a git repository, fall back to process.cwd()
             repoPath = undefined;
         }
-        // Determine target and base commitish
-        let targetCommitish = commitish;
-        let baseCommitish;
-        if (compareWith) {
-            // If compareWith is provided, use it as base
-            baseCommitish = compareWith;
-        }
-        else {
-            // Handle special arguments
-            if (commitish === 'working') {
-                // working compares working directory with staging area
-                baseCommitish = 'staged';
-            }
-            else if (isSpecialArg(commitish)) {
-                baseCommitish = 'HEAD';
-            }
-            else {
-                baseCommitish = commitish + '^';
-            }
+        const selection = resolveDiffSelection(commitish, compareWith, options.mergeBase);
+        if (options.mergeBase && isSpecialArg(selection.baseCommitish)) {
+            console.error(`Error: --merge-base requires a commit-ish base, but resolved base was "${selection.baseCommitish}"`);
+            process.exit(1);
         }
-        if (commitish === 'working' || commitish === '.') {
+        if (selection.targetCommitish === 'working' || selection.targetCommitish === '.') {
             const git = simpleGit(repoPath);
             await handleUntrackedFiles(git, options.includeUntracked);
         }
@@ -180,26 +193,25 @@ program
                 console.error('Try running the command directly in your terminal without piping.');
                 process.exit(1);
             }
+            await warnAboutTuiDeprecation();
             // Dynamic import for TUI mode
             const { render } = await import('ink');
             const { default: TuiApp } = await import('../tui/App.js');
             render(React.createElement(TuiApp, {
-                targetCommitish,
-                baseCommitish,
+                selection,
                 mode: options.mode,
                 repoPath,
                 contextLines: options.context,
             }));
             return;
         }
-        const validation = validateDiffArguments(targetCommitish, compareWith);
+        const validation = validateDiffArguments(selection.targetCommitish, compareWith);
         if (!validation.valid) {
             console.error(`Error: ${validation.error}`);
             process.exit(1);
         }
         const { url, port, isEmpty } = await startServer({
-            targetCommitish,
-            baseCommitish,
+            selection,
             preferredPort: options.port,
             host: options.host,
             openBrowser: options.open,
@@ -207,12 +219,12 @@ program
             clearComments: options.clean,
             keepAlive: options.keepAlive,
             contextLines: options.context,
-            diffMode: determineDiffMode(targetCommitish, compareWith),
+            diffMode: determineDiffMode(selection, compareWith),
             repoPath,
             ...(commentImports.length > 0 ? { commentImports } : {}),
         });
         console.log(`\n🚀 difit server started on ${url}`);
-        console.log(`📋 Reviewing: ${targetCommitish}`);
+        console.log(`📋 Reviewing: ${selection.targetCommitish}`);
         if (options.keepAlive) {
             console.log('🔒 Keep-alive mode: server will stay running after browser disconnects');
         }