@aku11i/phantom 2.0.0 → 2.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aku11i/phantom",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "A powerful CLI tool for managing Git worktrees for parallel development",
   "keywords": [
     "git",

package/phantom.js

@@ -4206,7 +4206,8 @@ var phantomConfigSchema = external_exports.object({
   preDelete: external_exports.object({
     commands: external_exports.array(external_exports.string()).optional()
   }).passthrough().optional(),
-  worktreesDirectory: external_exports.string().optional()
+  worktreesDirectory: external_exports.string().optional(),
+  defaultBranch: external_exports.string().optional()
 }).passthrough();
 function validateConfig(config) {
   const result = phantomConfigSchema.safeParse(config);
@@ -5336,6 +5337,7 @@ complete -c phantom -n "__phantom_using_command" -a "list" -d "List all Git work
 complete -c phantom -n "__phantom_using_command" -a "where" -d "Output the filesystem path of a specific worktree"
 complete -c phantom -n "__phantom_using_command" -a "delete" -d "Delete a Git worktree (phantom)"
 complete -c phantom -n "__phantom_using_command" -a "exec" -d "Execute a command in a worktree directory"
+complete -c phantom -n "__phantom_using_command" -a "review" -d "Review changes in a worktree with a local PR review interface (experimental)"
 complete -c phantom -n "__phantom_using_command" -a "shell" -d "Open an interactive shell in a worktree directory"
 complete -c phantom -n "__phantom_using_command" -a "github" -d "GitHub integration commands"
 complete -c phantom -n "__phantom_using_command" -a "gh" -d "GitHub integration commands (alias)"
@@ -5381,6 +5383,11 @@ complete -c phantom -n "__phantom_using_command exec" -l tmux-vertical -d "Execu
 complete -c phantom -n "__phantom_using_command exec" -l tmux-horizontal -d "Execute command in horizontal split pane"
 complete -c phantom -n "__phantom_using_command exec" -a "(__phantom_list_worktrees)"
 
+# review command options
+complete -c phantom -n "__phantom_using_command review" -l fzf -d "Use fzf for interactive selection"
+complete -c phantom -n "__phantom_using_command review" -l base -d "Base reference for comparison" -x
+complete -c phantom -n "__phantom_using_command review" -a "(__phantom_list_worktrees)"
+
 # shell command options
 complete -c phantom -n "__phantom_using_command shell" -l fzf -d "Use fzf for interactive selection"
 complete -c phantom -n "__phantom_using_command shell" -l tmux -d "Open shell in new tmux window (-t)"
@@ -5415,6 +5422,7 @@ _phantom() {
         'where:Output the filesystem path of a specific worktree'
         'delete:Delete a Git worktree (phantom)'
         'exec:Execute a command in a worktree directory'
+        'review:Review changes in a worktree with a local PR review interface (experimental)'
         'shell:Open an interactive shell in a worktree directory'
         'github:GitHub integration commands'
         'gh:GitHub integration commands (alias)'
@@ -5457,13 +5465,18 @@ _phantom() {
                         '--fzf[Use fzf for interactive selection]' \\
                         '--names[Output only phantom names (for scripts and completion)]'
                     ;;
-                where|delete|shell)
+                where|delete|review|shell)
                     local worktrees
                     worktrees=(\${(f)"$(phantom list --names 2>/dev/null)"})
                     if [[ \${line[1]} == "where" ]]; then
                         _arguments \\
                             '--fzf[Use fzf for interactive selection]' \\
                             '1:worktree:(\${(q)worktrees[@]})'
+                    elif [[ \${line[1]} == "review" ]]; then
+                        _arguments \\
+                            '--fzf[Use fzf for interactive selection]' \\
+                            '--base[Base reference for comparison]:reference:' \\
+                            '1:worktree:(\${(q)worktrees[@]})'
                     elif [[ \${line[1]} == "shell" ]]; then
                         _arguments \\
                             '--fzf[Use fzf for interactive selection]' \\
@@ -5529,7 +5542,7 @@ _phantom_completion() {
     local cur prev words cword
     _init_completion || return
 
-    local commands="create attach list where delete exec shell github gh version completion mcp"
+    local commands="create attach list where delete exec review shell github gh version completion mcp"
     local global_opts="--help --version"
 
     if [[ \${cword} -eq 1 ]]; then
@@ -5631,6 +5644,24 @@ _phantom_completion() {
                     ;;
             esac
             ;;
+        review)
+            case "\${prev}" in
+                --base)
+                    # Don't complete anything specific for base reference
+                    return 0
+                    ;;
+                *)
+                    if [[ "\${cur}" == -* ]]; then
+                        local opts="--fzf --base"
+                        COMPREPLY=( $(compgen -W "\${opts}" -- "\${cur}") )
+                    else
+                        local worktrees=$(_phantom_list_worktrees)
+                        COMPREPLY=( $(compgen -W "\${worktrees}" -- "\${cur}") )
+                    fi
+                    return 0
+                    ;;
+            esac
+            ;;
         shell)
             case "\${prev}" in
                 --tmux|-t|--tmux-vertical|--tmux-horizontal)
@@ -13267,7 +13298,7 @@ var StdioServerTransport = class {
 // ../mcp/package.json
 var package_default = {
   name: "@aku11i/phantom-mcp",
-  version: "2.0.0",
+  version: "2.1.1",
   private: true,
   type: "module",
   main: "./src/index.ts",
@@ -13546,10 +13577,97 @@ async function mcpHandler(args2 = []) {
   }
 }
 
-// src/handlers/shell.ts
+// src/handlers/review.ts
 import { parseArgs as parseArgs8 } from "node:util";
-async function shellHandler(args2) {
+async function reviewHandler(args2) {
   const { positionals, values } = parseArgs8({
+    args: args2,
+    options: {
+      fzf: {
+        type: "boolean",
+        default: false
+      },
+      base: {
+        type: "string"
+      }
+    },
+    strict: true,
+    allowPositionals: true
+  });
+  const useFzf = values.fzf ?? false;
+  const base = values.base;
+  if (useFzf) {
+    if (positionals.length > 0) {
+      exitWithError(
+        "Cannot specify worktree name when using --fzf",
+        exitCodes.validationError
+      );
+    }
+  } else {
+    if (positionals.length !== 1) {
+      exitWithError(
+        "Usage: phantom review <worktree-name> [--base <ref>]",
+        exitCodes.validationError
+      );
+    }
+  }
+  try {
+    const gitRoot = await getGitRoot();
+    const context = await createContext(gitRoot);
+    let worktreeName;
+    if (useFzf) {
+      const selectResult = await selectWorktreeWithFzf(
+        context.gitRoot,
+        context.worktreesDirectory
+      );
+      if (isErr(selectResult)) {
+        exitWithError(selectResult.error.message, exitCodes.generalError);
+      }
+      if (!selectResult.value) {
+        exitWithSuccess();
+      }
+      worktreeName = selectResult.value.name;
+    } else {
+      worktreeName = positionals[0];
+    }
+    const validation = await validateWorktreeExists(
+      context.gitRoot,
+      context.worktreesDirectory,
+      worktreeName
+    );
+    if (isErr(validation)) {
+      exitWithError(validation.error.message, exitCodes.generalError);
+    }
+    const baseRef = base ?? `origin/${context.config?.defaultBranch ?? "main"}`;
+    output.log(`Opening review for worktree '${worktreeName}'...`);
+    output.log(
+      "powered by yoshiko-pg/reviewit (https://github.com/yoshiko-pg/reviewit)"
+    );
+    const command2 = ["reviewit", "HEAD", baseRef];
+    const result = await execInWorktree(
+      context.gitRoot,
+      context.worktreesDirectory,
+      worktreeName,
+      command2,
+      { interactive: true }
+    );
+    if (isErr(result)) {
+      const exitCode = result.error instanceof WorktreeNotFoundError ? exitCodes.notFound : result.error.exitCode || exitCodes.generalError;
+      exitWithError(result.error.message, exitCode);
+    }
+    process.exit(result.value.exitCode);
+  } catch (error) {
+    exitWithError(
+      error instanceof Error ? error.message : String(error),
+      exitCodes.generalError
+    );
+  }
+}
+
+// src/handlers/shell.ts
+import { parseArgs as parseArgs9 } from "node:util";
+async function shellHandler(args2) {
+  const { positionals, values } = parseArgs9({
     args: args2,
     options: {
       fzf: {
@@ -13673,12 +13791,12 @@ async function shellHandler(args2) {
 }
 
 // src/handlers/version.ts
-import { parseArgs as parseArgs9 } from "node:util";
+import { parseArgs as parseArgs10 } from "node:util";
 
 // package.json
 var package_default2 = {
   name: "@aku11i/phantom-cli",
-  version: "2.0.0",
+  version: "2.1.1",
   private: true,
   type: "module",
   scripts: {
@@ -13706,7 +13824,7 @@ function getVersion() {
 
 // src/handlers/version.ts
 function versionHandler(args2 = []) {
-  parseArgs9({
+  parseArgs10({
     args: args2,
     options: {},
     strict: true,
@@ -13718,9 +13836,9 @@ function versionHandler(args2 = []) {
 }
 
 // src/handlers/where.ts
-import { parseArgs as parseArgs10 } from "node:util";
+import { parseArgs as parseArgs11 } from "node:util";
 async function whereHandler(args2) {
-  const { positionals, values } = parseArgs10({
+  const { positionals, values } = parseArgs11({
     args: args2,
     options: {
       fzf: {
@@ -14089,6 +14207,55 @@ var listHelp = {
   ]
 };
 
+// src/help/review.ts
+var reviewHelp = {
+  name: "review",
+  description: "Review changes in a worktree with a local PR review interface (experimental)",
+  usage: "phantom review [options] <worktree-name>",
+  options: [
+    {
+      name: "--fzf",
+      type: "boolean",
+      description: "Use fzf for interactive worktree selection"
+    },
+    {
+      name: "--base",
+      type: "string",
+      description: "Base reference for comparison (default: origin/<defaultBranch>)"
+    }
+  ],
+  examples: [
+    {
+      description: "Review changes against default branch",
+      command: "phantom review feature-auth"
+    },
+    {
+      description: "Review changes against specific remote branch",
+      command: "phantom review feature-login --base origin/feature-auth"
+    },
+    {
+      description: "Review changes against local branch",
+      command: "phantom review feature-auth --base main"
+    },
+    {
+      description: "Interactive worktree selection",
+      command: "phantom review --fzf"
+    },
+    {
+      description: "Interactive selection with custom base",
+      command: "phantom review --fzf --base origin/staging"
+    }
+  ],
+  notes: [
+    "\u26A0\uFE0F  This is an experimental feature and may change in future versions",
+    "Uses reviewit to provide a GitHub-like PR review interface locally",
+    "Default base is origin/<defaultBranch> where defaultBranch is from config or 'main'",
+    "The --base value is passed directly to reviewit as the comparison reference",
+    "Requires reviewit to be installed separately (e.g., npm install -g reviewit)",
+    "powered by yoshiko-pg/reviewit (https://github.com/yoshiko-pg/reviewit)"
+  ]
+};
+
 // src/help/shell.ts
 var shellHelp = {
   name: "shell",
@@ -14236,6 +14403,12 @@ var commands = [
     handler: execHandler,
     help: execHelp
   },
+  {
+    name: "review",
+    description: "Review changes in a worktree with a local PR review interface (experimental)",
+    handler: reviewHandler,
+    help: reviewHelp
+  },
   {
     name: "shell",
     description: "Open an interactive shell in a worktree directory",