codeowners-git 2.0.2 → 2.1.0

package/README.md

@@ -12,6 +12,8 @@ Managing large-scale migrations in big monorepos with multiple codeowners can be
 - Creating compact, team-specific branches with only their affected files.
 - Streamlining the review process with smaller, targeted PRs.
 - **Graceful error handling** with automatic recovery from failures.
+- **Dry-run previews** to see exactly what will happen before committing.
+- **JSON output** for piping to other tools, scripts, and agent workflows.
 
 > ❗❗ ❗ **Note:** Starting from v2.0.0, this tool works with **staged files**. Stage your changes with `git add` before running commands.
 
@@ -149,6 +151,7 @@ Options:
 - `--group, -g` Group files by code owner
 - `--exclusive, -e` Only include files with a single owner (no co-owned files)
 - `--co-owned, -c` Only include files with multiple owners (co-owned files)
+- `--json` Output results as JSON (suppresses all other output)
 
 Examples:
 
@@ -180,6 +183,12 @@ cg list --co-owned
 
 # List co-owned files where @myteam is one of the owners
 cg list --include "@myteam" --co-owned
+
+# Output as JSON for piping to other tools
+cg list --json
+
+# JSON output with filters (pipe to jq)
+cg list -i "@myteam" --group --json | jq '.grouped'
 ```
 
 ### `branch`
@@ -214,6 +223,8 @@ Options:
 - `--draft-pr` Create a draft pull request after pushing (requires `--push` and GitHub CLI)
 - `--exclusive, -e` Only include files where the owner is the sole owner (no co-owned files)
 - `--co-owned, -c` Only include files with multiple owners (co-owned files)
+- `--dry-run` Preview the operation without making any changes
+- `--json` Output results as JSON (suppresses all other output)
 
 Example:
 
@@ -253,6 +264,15 @@ cg branch -i @myteam -b "feature/exclusive" -m "Team exclusive changes" -p --exc
 
 # Only include co-owned files where @myteam is one of the owners
 cg branch -i @myteam -b "feature/co-owned" -m "Co-owned changes" -p --co-owned
+
+# Preview what would happen without making any changes
+cg branch -i @myteam -b "feature/new" -m "Add feature" --dry-run
+
+# Dry-run with JSON output (for agents/scripts)
+cg branch -i @myteam -b "feature/new" -m "Add feature" --dry-run --json
+
+# Normal execution with JSON output
+cg branch -i @myteam -b "feature/new" -m "Add feature" -p --json
 ```
 
 ### `multi-branch`
@@ -289,6 +309,8 @@ Options:
 - `--draft-pr` Create draft pull requests after pushing (requires `--push` and GitHub CLI)
 - `--exclusive, -e` Only include files where each owner is the sole owner (no co-owned files)
 - `--co-owned, -c` Only include files with multiple owners (co-owned files)
+- `--dry-run` Preview the operation without making any changes
+- `--json` Output results as JSON (suppresses all other output)
 
 > **Note:** You cannot use both `--ignore` and `--include` options at the same time. You also cannot use both `--exclusive` and `--co-owned` options at the same time.
 
@@ -336,6 +358,18 @@ cg multi-branch -b "feature/exclusive" -m "Exclusive changes" -p --exclusive
 
 # Only include co-owned files
 cg multi-branch -b "feature/co-owned" -m "Co-owned changes" -p --co-owned
+
+# Preview all branches that would be created
+cg multi-branch -b "feature/migration" -m "Migrate" --dry-run
+
+# Dry-run with JSON output
+cg multi-branch -b "feature/migration" -m "Migrate" --dry-run --json
+
+# Pipe dry-run JSON to see owners with matching files
+cg multi-branch -b "mig" -m "Fix" --dry-run --json | jq '.owners[] | select(.files | length > 0)'
+
+# Normal execution with JSON output
+cg multi-branch -b "feature/migration" -m "Migrate" -p --json
 ```
 
 This will:
@@ -371,6 +405,8 @@ Options:
 - `--compare-main` Compare source against main branch instead of detecting merge-base
 - `--exclusive, -e` Only include files where the owner is the sole owner (no co-owned files)
 - `--co-owned, -c` Only include files with multiple owners (co-owned files)
+- `--dry-run` Preview the operation without making any changes
+- `--json` Output results as JSON (suppresses all other output)
 
 Examples:
 
@@ -403,6 +439,21 @@ cg extract -s feature/other-team --co-owned
 
 # Extract co-owned files where @my-team is one of the owners
 cg extract -s feature/other-team -i "@my-team" --co-owned
+
+# Preview what would be extracted without making any changes
+cg extract -s feature/other-team --dry-run
+
+# Dry-run with owner filter
+cg extract -s feature/other-team -i "@my-team" --dry-run
+
+# Dry-run with JSON output (for agents/scripts)
+cg extract -s feature/other-team -i "@my-team" --dry-run --json
+
+# Normal execution with JSON output
+cg extract -s feature/other-team -i "@my-team" --json
+
+# Pipe JSON to jq to get just the file list
+cg extract -s feature/other-team --json | jq '.files'
 ```
 
 > **Note:** Files are extracted to your working directory (unstaged), allowing you to review and modify them. Stage the files with `git add`, then use the `branch` command to create a branch, commit, push, and create PRs.
@@ -477,6 +528,270 @@ The tool automatically handles:
 
 > **Note:** State files are stored in `~/.codeowners-git/state/` outside your project directory, so no `.gitignore` entries are needed.
 
+## Dry Run & JSON Output
+
+### Dry Run (`--dry-run`)
+
+Available on: `branch`, `multi-branch`, `extract`
+
+The `--dry-run` flag shows a complete preview of what would happen without performing any git operations. No branches are created, no files are committed, and nothing is pushed.
+
+```bash
+# Preview branch creation
+cg branch -i @myteam -b "feature/new" -m "Add feature" --dry-run
+
+# Preview all branches in a multi-branch run
+cg multi-branch -b "feature/migration" -m "Migrate" --dry-run
+
+# Preview file extraction
+cg extract -s feature/other-team -i "@myteam" --dry-run
+```
+
+The dry-run output includes:
+
+- **branch**: Owner, branch name, branch existence, commit message, matched files, excluded files, push/PR/flag settings
+- **multi-branch**: Per-owner breakdown (branch, message, files), uncovered files, unowned files, summary totals
+- **extract**: Source, compare target, files to extract, excluded files, filter settings
+
+### JSON Output (`--json`)
+
+Available on: `list`, `branch`, `multi-branch`, `extract`
+
+The `--json` flag outputs machine-readable JSON to stdout and suppresses all human-readable log messages. This is useful for piping to other tools, scripts, and agent workflows.
+
+```bash
+# JSON output for any command
+cg list --json
+cg branch -i @myteam -b "feature/new" -m "Add feature" --json
+cg multi-branch -b "feature/migration" -m "Migrate" --json
+cg extract -s feature/other-team --json
+```
+
+### Combining `--dry-run` and `--json`
+
+The two flags work together — `--dry-run --json` outputs the dry-run preview as structured JSON:
+
+```bash
+cg branch -i @myteam -b "feature/new" -m "Add feature" --dry-run --json
+cg multi-branch -b "feature/migration" -m "Migrate" --dry-run --json
+cg extract -s feature/other-team --dry-run --json
+```
+
+### JSON Schema Examples
+
+Every JSON response includes a `command` field identifying the source command.
+
+**`list --json`**
+
+```json
+{
+  "command": "list",
+  "files": [
+    { "file": "src/index.ts", "owners": ["@org/team-a"] },
+    { "file": "src/shared.ts", "owners": ["@org/team-a", "@org/team-b"] }
+  ],
+  "filters": {
+    "include": null,
+    "pathPattern": null,
+    "exclusive": false,
+    "coOwned": false
+  }
+}
+```
+
+**`list --group --json`**
+
+```json
+{
+  "command": "list",
+  "grouped": {
+    "@org/team-a": ["src/index.ts", "src/shared.ts"],
+    "@org/team-b": ["src/shared.ts"]
+  },
+  "filters": {
+    "include": null,
+    "pathPattern": null,
+    "exclusive": false,
+    "coOwned": false
+  }
+}
+```
+
+**`branch --dry-run --json`**
+
+```json
+{
+  "command": "branch",
+  "dryRun": true,
+  "owner": "@org/team-a",
+  "branch": "feature/new/team-a",
+  "branchExists": false,
+  "message": "Add feature - @org/team-a",
+  "files": ["src/index.ts"],
+  "excludedFiles": ["src/other.ts"],
+  "options": {
+    "push": true,
+    "remote": "origin",
+    "force": false,
+    "pr": false,
+    "draftPr": false,
+    "noVerify": false,
+    "append": false,
+    "exclusive": false,
+    "coOwned": false,
+    "pathPattern": null
+  }
+}
+```
+
+**`branch --json`** (normal execution)
+
+```json
+{
+  "command": "branch",
+  "dryRun": false,
+  "success": true,
+  "branchName": "feature/new/team-a",
+  "owner": "@org/team-a",
+  "files": ["src/index.ts"],
+  "pushed": true,
+  "prUrl": "https://github.com/org/repo/pull/42",
+  "prNumber": 42,
+  "error": null
+}
+```
+
+**`multi-branch --dry-run --json`**
+
+```json
+{
+  "command": "multi-branch",
+  "dryRun": true,
+  "owners": [
+    {
+      "owner": "@org/team-a",
+      "branch": "feature/migration/team-a",
+      "message": "Migrate - @org/team-a",
+      "files": ["src/index.ts"]
+    },
+    {
+      "owner": "@org/team-b",
+      "branch": "feature/migration/team-b",
+      "message": "Migrate - @org/team-b",
+      "files": ["src/shared.ts"]
+    }
+  ],
+  "uncoveredFiles": [],
+  "filesWithoutOwners": [],
+  "totalFiles": 2,
+  "coveredFiles": 2,
+  "options": {
+    "baseBranch": "feature/migration",
+    "baseMessage": "Migrate",
+    "push": false,
+    "remote": "origin",
+    "force": false,
+    "pr": false,
+    "draftPr": false,
+    "noVerify": false,
+    "append": false,
+    "exclusive": false,
+    "coOwned": false,
+    "pathPattern": null,
+    "defaultOwner": null
+  }
+}
+```
+
+**`multi-branch --json`** (normal execution)
+
+```json
+{
+  "command": "multi-branch",
+  "dryRun": false,
+  "success": true,
+  "totalOwners": 2,
+  "successCount": 2,
+  "failureCount": 0,
+  "results": [
+    {
+      "owner": "@org/team-a",
+      "branch": "feature/migration/team-a",
+      "success": true,
+      "files": ["src/index.ts"],
+      "pushed": true,
+      "prUrl": null,
+      "prNumber": null,
+      "error": null
+    }
+  ]
+}
+```
+
+**`extract --dry-run --json`**
+
+```json
+{
+  "command": "extract",
+  "dryRun": true,
+  "source": "feature/other-team",
+  "compareTarget": "main",
+  "files": ["src/component.tsx"],
+  "excludedFiles": ["src/unrelated.ts"],
+  "totalChanged": 2,
+  "options": {
+    "include": "@org/team-a",
+    "pathPattern": null,
+    "exclusive": false,
+    "coOwned": false,
+    "compareMain": false
+  }
+}
+```
+
+**`extract --json`** (normal execution)
+
+```json
+{
+  "command": "extract",
+  "dryRun": false,
+  "source": "feature/other-team",
+  "compareTarget": "main",
+  "files": ["src/component.tsx"],
+  "totalChanged": 2
+}
+```
+
+**Error responses** (any command)
+
+```json
+{
+  "command": "branch",
+  "error": "Error: No staged files found"
+}
+```
+
+### Piping Examples
+
+```bash
+# Count files per owner
+cg list --group --json | jq '.grouped | to_entries[] | {owner: .key, count: (.value | length)}'
+
+# Get list of branches that would be created
+cg multi-branch -b "mig" -m "Fix" --dry-run --json | jq '.owners[].branch'
+
+# Find owners with more than 5 files
+cg multi-branch -b "mig" -m "Fix" --dry-run --json | jq '.owners[] | select(.files | length > 5) | .owner'
+
+# Check if a branch operation succeeded
+cg branch -i @myteam -b "feat" -m "Update" -p --json | jq '.success'
+
+# List only extracted file paths
+cg extract -s feature/other --json | jq -r '.files[]'
+```
+
+> **Note:** The `recover` command does not support `--dry-run` or `--json` because it is an interactive command with user prompts.
+
 ## Contributing
 
 1. Clone the repository

package/dist/cli.js

@@ -5,15 +5,29 @@ var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
   target = mod != null ? __create(__getProtoOf(mod)) : {};
   const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
   for (let key of __getOwnPropNames(mod))
     if (!__hasOwnProp.call(to, key))
       __defProp(to, key, {
-        get: () => mod[key],
+        get: __accessProp.bind(mod, key),
         enumerable: true
       });
+  if (canCache)
+    cache.set(mod, to);
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
@@ -2287,7 +2301,7 @@ var require_ignore = __commonJS((exports, module) => {
       }
     }, {
       key: "filter",
-      value: function filter(paths) {
+      value: function filter2(paths) {
         var _this = this;
         return make_array(paths).filter(function(path) {
           return _this._filter(path);
@@ -2438,7 +2452,7 @@ var require_ignore = __commonJS((exports, module) => {
   }
   if (typeof process !== "undefined" && (process.env && process.env.IGNORE_TEST_WIN32 || process.platform === "win32")) {
     filter = IgnoreBase.prototype._filter;
-    make_posix = function make_posix(str) {
+    make_posix = function make_posix2(str) {
       return /^\\\\\?\\/.test(str) || /[^\x00-\x80]+/.test(str) ? str : str.replace(/\\/g, "/");
     };
     IgnoreBase.prototype._filter = function(path, slices) {
@@ -3039,25 +3053,25 @@ var require_minimatch = __commonJS((exports, module) => {
       return minimatch;
     }
     var orig = minimatch;
-    var m = function minimatch(p, pattern, options) {
+    var m = function minimatch2(p, pattern, options) {
       return orig(p, pattern, ext(def, options));
     };
-    m.Minimatch = function Minimatch(pattern, options) {
+    m.Minimatch = function Minimatch2(pattern, options) {
       return new orig.Minimatch(pattern, ext(def, options));
     };
     m.Minimatch.defaults = function defaults(options) {
       return orig.defaults(ext(def, options)).Minimatch;
     };
-    m.filter = function filter(pattern, options) {
+    m.filter = function filter2(pattern, options) {
       return orig.filter(pattern, ext(def, options));
     };
     m.defaults = function defaults(options) {
       return orig.defaults(ext(def, options));
     };
-    m.makeRe = function makeRe(pattern, options) {
+    m.makeRe = function makeRe2(pattern, options) {
       return orig.makeRe(pattern, ext(def, options));
     };
-    m.braceExpand = function braceExpand(pattern, options) {
+    m.braceExpand = function braceExpand2(pattern, options) {
       return orig.braceExpand(pattern, ext(def, options));
     };
     m.match = function(list, pattern, options) {
@@ -6584,7 +6598,7 @@ var require_colors = __commonJS((exports, module) => {
   colors.stripColors = colors.strip = function(str) {
     return ("" + str).replace(/\x1B\[\d+m/g, "");
   };
-  var stylize = colors.stylize = function stylize(str, style) {
+  var stylize = colors.stylize = function stylize2(str, style) {
     if (!colors.enabled) {
       return str + "";
     }
@@ -6602,8 +6616,8 @@ var require_colors = __commonJS((exports, module) => {
     return str.replace(matchOperatorsRe, "\\$&");
   };
   function build(_styles) {
-    var builder = function builder() {
-      return applyStyle2.apply(builder, arguments);
+    var builder = function builder2() {
+      return applyStyle2.apply(builder2, arguments);
     };
     builder._styles = _styles;
     builder.__proto__ = proto2;
@@ -6622,7 +6636,7 @@ var require_colors = __commonJS((exports, module) => {
     });
     return ret;
   }();
-  var proto2 = defineProps(function colors() {}, styles3);
+  var proto2 = defineProps(function colors2() {}, styles3);
   function applyStyle2() {
     var args = Array.prototype.slice.call(arguments);
     var str = args.map(function(arg) {
@@ -6681,7 +6695,7 @@ var require_colors = __commonJS((exports, module) => {
     });
     return ret;
   }
-  var sequencer = function sequencer(map2, str) {
+  var sequencer = function sequencer2(map2, str) {
     var exploded = str.split("");
     exploded = exploded.map(map2);
     return exploded.join("");
@@ -11612,7 +11626,7 @@ var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames2(fn)[0]])(fn = 0)), res;
 };
-var __commonJS2 = (cb, mod) => function __require() {
+var __commonJS2 = (cb, mod) => function __require2() {
   return mod || (0, cb[__getOwnPropNames2(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
 };
 var __export = (target, all) => {
@@ -16080,6 +16094,26 @@ var import_cli_table3 = __toESM(require_table(), 1);
 var DEFAULT_COLUMN_WIDTH = 50;
 var MAX_LINE_LENGTH = 80;
 var MAX_PATH_LENGTH = 60;
+var _silent = false;
+var _origConsoleLog = console.log;
+var _origConsoleWarn = console.warn;
+var _origConsoleError = console.error;
+var noop = () => {};
+var setSilent = (silent) => {
+  _silent = silent;
+  if (silent) {
+    console.log = noop;
+    console.warn = noop;
+    console.error = noop;
+  } else {
+    console.log = _origConsoleLog;
+    console.warn = _origConsoleWarn;
+    console.error = _origConsoleError;
+  }
+};
+var outputJson = (data) => {
+  _origConsoleLog(JSON.stringify(data, null, 2));
+};
 var log = {
   success: (message) => console.log(source_default.green(`✓ ${message}`)),
   error: (message) => console.error(source_default.red(`✗ ${message}`)),
@@ -16154,6 +16188,14 @@ var hasUnstagedChanges = async () => {
   const unstagedFiles = await getUnstagedFiles();
   return unstagedFiles.length > 0;
 };
+var getStagedFiles = async () => {
+  const status = await git.status();
+  return status.files.filter((file) => file.index !== " " && file.index !== "?").map((file) => file.path);
+};
+var hasStagedChanges = async () => {
+  const stagedFiles = await getStagedFiles();
+  return stagedFiles.length > 0;
+};
 var branchExists = async (branchName) => {
   try {
     const branches = await git.branch();
@@ -16240,7 +16282,8 @@ var pushBranch = async (branchName, {
   remote = "origin",
   upstream,
   force = false,
-  noVerify = false
+  noVerify = false,
+  silent = false
 } = {}) => {
   const targetUpstream = upstream || branchName;
   log.info(`Pushing branch "${branchName}" to ${remote}/${targetUpstream}...`);
@@ -16253,8 +16296,9 @@ var pushBranch = async (branchName, {
     if (noVerify) {
       pushArgs.push("--no-verify");
     }
+    const stdioOption = silent ? ["pipe", "pipe", "pipe"] : ["inherit", "inherit", "inherit"];
     const gitProcess = spawn2("git", ["push", ...pushArgs], {
-      stdio: ["inherit", "inherit", "inherit"]
+      stdio: stdioOption
     });
     return new Promise((resolve, reject) => {
       gitProcess.on("close", (code) => {
@@ -16430,6 +16474,9 @@ var getOwnerFiles = async (ownerPattern, includeUnowned = false, pathPattern, ex
 // src/commands/list.ts
 var listCodeowners = async (options) => {
   try {
+    if (options.json) {
+      setSilent(true);
+    }
     if (await hasUnstagedChanges()) {
       const unstagedFiles = await getUnstagedFiles();
       log.warn("Warning: Unstaged changes detected (these will be ignored):");
@@ -16462,6 +16509,34 @@ Only staged files will be processed.`);
         return matchFn(owners, patterns);
       });
     }
+    if (options.json) {
+      let grouped;
+      if (options.group) {
+        grouped = {};
+        for (const { file, owners } of filteredFiles) {
+          if (owners.length === 0) {
+            grouped["(unowned)"] = grouped["(unowned)"] || [];
+            grouped["(unowned)"].push(file);
+          } else {
+            for (const owner of owners) {
+              grouped[owner] = grouped[owner] || [];
+              grouped[owner].push(file);
+            }
+          }
+        }
+      }
+      outputJson({
+        command: "list",
+        ...grouped ? { grouped } : { files: filteredFiles.map(({ file, owners }) => ({ file, owners })) },
+        filters: {
+          include: options.include || null,
+          pathPattern: options.pathPattern || null,
+          exclusive: options.exclusive || false,
+          coOwned: options.coOwned || false
+        }
+      });
+      return;
+    }
     if (options.group) {
       const ownerGroups = new Map;
       for (const { file, owners } of filteredFiles) {
@@ -16528,6 +16603,10 @@ Only staged files will be processed.`);
       ]);
     }
   } catch (err) {
+    if (options.json) {
+      outputJson({ command: "list", error: String(err) });
+      process.exit(1);
+    }
     log.error(err);
     process.exit(1);
   }
@@ -16780,6 +16859,9 @@ var branch = async (options) => {
   let operationState = options.operationState || null;
   const isSubOperation = !!options.operationState;
   let autoRecoverySucceeded = false;
+  if (options.json && !isSubOperation) {
+    setSilent(true);
+  }
   try {
     if (!options.branch || !options.message || !options.include) {
       throw new Error("Missing required options for branch creation");
@@ -16829,6 +16911,93 @@ Only staged files will be processed.`);
     log.file(`Files to be committed:
   ${filesToCommit.join(`
   `)}`);
+    if (options.dryRun) {
+      const allStagedFiles = await getChangedFiles();
+      const excludedFiles = allStagedFiles.filter((f) => !filesToCommit.includes(f));
+      const branchAlreadyExistsDry = await branchExists(options.branch);
+      if (options.json && !isSubOperation) {
+        outputJson({
+          command: "branch",
+          dryRun: true,
+          owner: options.include,
+          branch: options.branch,
+          branchExists: branchAlreadyExistsDry,
+          message: options.message,
+          files: filesToCommit,
+          excludedFiles,
+          options: {
+            push: options.push || false,
+            remote: options.remote || "origin",
+            force: options.force || false,
+            pr: options.pr || false,
+            draftPr: options.draftPr || false,
+            noVerify: !options.verify,
+            append: options.append || false,
+            exclusive: options.exclusive || false,
+            coOwned: options.coOwned || false,
+            pathPattern: options.pathPattern || null
+          }
+        });
+        return {
+          success: true,
+          branchName: options.branch,
+          owner: options.include,
+          files: filesToCommit,
+          pushed: false
+        };
+      }
+      if (!isSubOperation) {
+        log.header("Dry Run Preview — branch");
+        console.log("");
+      }
+      const detailsTable = new import_cli_table32.default({
+        style: { head: ["cyan"] },
+        wordWrap: true
+      });
+      detailsTable.push({ [source_default.bold("Owner pattern")]: options.include }, { [source_default.bold("Branch name")]: options.branch }, {
+        [source_default.bold("Branch exists")]: branchAlreadyExistsDry ? options.append ? "Yes (--append: will add commit)" : "Yes (will fail without --append)" : "No (will be created)"
+      }, { [source_default.bold("Commit message")]: options.message }, {
+        [source_default.bold("Files matched")]: `${filesToCommit.length} file${filesToCommit.length !== 1 ? "s" : ""}`
+      }, {
+        [source_default.bold("Files excluded")]: `${excludedFiles.length} staged file${excludedFiles.length !== 1 ? "s" : ""} not matching`
+      }, { [source_default.bold("No-verify")]: !options.verify ? "Yes" : "No" }, {
+        [source_default.bold("Push")]: options.push ? `Yes → ${options.remote || "origin"}${options.force ? " (force)" : ""}` : "No"
+      }, {
+        [source_default.bold("Pull request")]: options.pr ? "Yes" : options.draftPr ? "Yes (draft)" : "No"
+      });
+      if (options.pathPattern) {
+        detailsTable.push({
+          [source_default.bold("Path filter")]: options.pathPattern
+        });
+      }
+      if (options.exclusive) {
+        detailsTable.push({
+          [source_default.bold("Exclusive mode")]: "Yes (only files solely owned by this owner)"
+        });
+      }
+      if (options.coOwned) {
+        detailsTable.push({
+          [source_default.bold("Co-owned mode")]: "Yes (only files with multiple owners)"
+        });
+      }
+      console.log(detailsTable.toString());
+      console.log(source_default.bold.green(`
+Files to be committed (${filesToCommit.length}):`));
+      filesToCommit.forEach((file) => console.log(`  ${source_default.green("+")} ${file}`));
+      if (excludedFiles.length > 0) {
+        console.log(source_default.bold.dim(`
+Excluded staged files (${excludedFiles.length}):`));
+        excludedFiles.forEach((file) => console.log(`  ${source_default.dim("-")} ${source_default.dim(file)}`));
+      }
+      console.log("");
+      return {
+        success: true,
+        branchName: options.branch,
+        owner: options.include,
+        files: filesToCommit,
+        pushed: false
+      };
+    }
     const branchAlreadyExists = await branchExists(options.branch);
     if (branchAlreadyExists && !options.append) {
       throw new Error(`Branch "${options.branch}" already exists. Use --append to add commits to it, or use a different name.`);
@@ -16883,7 +17052,8 @@ Only staged files will be processed.`);
           remote: options.remote,
           upstream: options.upstream,
           force: options.force,
-          noVerify: !options.verify
+          noVerify: !options.verify,
+          silent: !!options.json
         });
         pushed = true;
         if (operationState) {
@@ -16949,7 +17119,7 @@ Only staged files will be processed.`);
 Files committed:`);
         filesToCommit.forEach((file) => console.log(`  - ${file}`));
       }
-      return {
+      const result = {
         success: true,
         branchName: options.branch,
         owner: options.include,
@@ -16958,6 +17128,15 @@ Files committed:`);
         prUrl,
         prNumber
       };
+      if (options.json && !isSubOperation) {
+        outputJson({
+          command: "branch",
+          dryRun: false,
+          ...result,
+          error: null
+        });
+      }
+      return result;
     } catch (operationError) {
       log.error(`Operation failed: ${operationError}`);
       if (operationState && !isSubOperation) {
@@ -17027,6 +17206,21 @@ Files committed:`);
         error: String(err)
       };
     }
+    if (options.json && !isSubOperation) {
+      outputJson({
+        command: "branch",
+        dryRun: false,
+        success: false,
+        branchName: options.branch ?? "",
+        owner: options.include ?? "",
+        files: filesToCommit,
+        pushed,
+        prUrl: prUrl || null,
+        prNumber: prNumber || null,
+        error: String(err)
+      });
+      process.exit(1);
+    }
     if (operationState && !autoRecoverySucceeded) {
       log.info(`
 Auto-recovery failed. Manual recovery options:`);
@@ -17049,7 +17243,6 @@ Auto-recovery failed. Manual recovery options:`);
     }
   }
 };
-
 // node_modules/@inquirer/core/dist/esm/lib/key.js
 var isUpKey = (key) => key.name === "up" || key.name === "k" || key.ctrl && key.name === "p";
 var isDownKey = (key) => key.name === "down" || key.name === "j" || key.ctrl && key.name === "n";
@@ -18337,9 +18530,21 @@ Operation ID: ${op.id}`);
     log.info(formatBranchState(op));
   }
 };
-var performRecovery = async (state, keepBranches) => {
+var performRecovery = async (state, keepBranches, options) => {
   log.header(`Recovering from operation ${state.id}`);
   let hadWarnings = false;
+  if (!options?.skipDirtyCheck) {
+    const hasUnstaged = await hasUnstagedChanges();
+    const hasStaged = await hasStagedChanges();
+    if (hasUnstaged || hasStaged) {
+      log.warn("Working directory has uncommitted changes.");
+      log.warn("Recovery may overwrite files in your working directory.");
+      log.info("Consider committing or stashing your changes first:");
+      log.info("  git stash push -m 'before recovery'");
+      throw new Error("Working directory is not clean. Commit or stash changes before recovering.");
+    }
+  }
+  const branchesWithRestoreFailure = new Set;
   const currentBranch = await getCurrentBranch();
   if (currentBranch !== state.originalBranch) {
     try {
@@ -18370,7 +18575,8 @@ Restoring files from branches...`);
           }
         } catch (error) {
           log.error(`Failed to restore files from ${branch2.name}: ${error}`);
-          log.info(`Files may still be accessible from the branch if it exists`);
+          log.warn(`Branch ${branch2.name} will be kept to prevent data loss`);
+          branchesWithRestoreFailure.add(branch2.name);
           hadWarnings = true;
         }
       }
@@ -18381,6 +18587,12 @@ Restoring files from branches...`);
 Cleaning up created branches...`);
     for (const branch2 of state.branches) {
       if (branch2.created) {
+        if (branchesWithRestoreFailure.has(branch2.name)) {
+          log.warn(`Skipping deletion of ${branch2.name} — file restoration failed, branch preserved to prevent data loss`);
+          log.info(`  To recover files manually: git checkout ${branch2.name} -- <file>`);
+          log.info(`  To delete manually when done: git branch -D ${branch2.name}`);
+          continue;
+        }
         try {
           const exists2 = await branchExists(branch2.name);
           if (exists2) {
@@ -18478,6 +18690,9 @@ Operation details:`);
 var import_cli_table33 = __toESM(require_table(), 1);
 var multiBranch = async (options) => {
   let operationState = null;
+  if (options.json) {
+    setSilent(true);
+  }
   try {
     if (!options.branch || !options.message) {
       throw new Error("Missing required options for multi-branch creation");
@@ -18556,6 +18771,137 @@ Only staged files will be processed.`);
       }
       log.info(`Processing ${codeowners2.length} codeowners after filtering: ${codeowners2.join(", ")}`);
     }
+    if (options.dryRun) {
+      const previews = [];
+      const allCoveredFiles = new Set;
+      for (const owner of codeowners2) {
+        const sanitizedOwner = owner.replace(/[^a-zA-Z0-9-_@]/g, "-").replace(/^@/, "");
+        const branchName = `${options.branch}/${sanitizedOwner}`;
+        const commitMessage = `${options.message} - ${owner}`;
+        const ownerFiles = await getOwnerFiles(owner, owner === options.defaultOwner, options.pathPattern, options.exclusive || false, options.coOwned || false);
+        for (const f of ownerFiles)
+          allCoveredFiles.add(f);
+        previews.push({
+          owner,
+          branchName,
+          commitMessage,
+          files: ownerFiles
+        });
+      }
+      const uncoveredFiles = changedFiles.filter((f) => !allCoveredFiles.has(f));
+      if (options.json) {
+        outputJson({
+          command: "multi-branch",
+          dryRun: true,
+          owners: previews.map((p) => ({
+            owner: p.owner,
+            branch: p.branchName,
+            message: p.commitMessage,
+            files: p.files
+          })),
+          uncoveredFiles,
+          filesWithoutOwners: options.defaultOwner ? [] : filesWithoutOwners,
+          totalFiles: changedFiles.length,
+          coveredFiles: allCoveredFiles.size,
+          options: {
+            baseBranch: options.branch,
+            baseMessage: options.message,
+            push: options.push || false,
+            remote: options.remote || "origin",
+            force: options.force || false,
+            pr: options.pr || false,
+            draftPr: options.draftPr || false,
+            noVerify: !options.verify,
+            append: options.append || false,
+            exclusive: options.exclusive || false,
+            coOwned: options.coOwned || false,
+            pathPattern: options.pathPattern || null,
+            defaultOwner: options.defaultOwner || null
+          }
+        });
+        return;
+      }
+      log.header("Dry Run Preview — multi-branch");
+      console.log("");
+      const settingsTable = new import_cli_table33.default({
+        style: { head: ["cyan"] },
+        wordWrap: true
+      });
+      settingsTable.push({ [source_default.bold("Base branch name")]: options.branch }, { [source_default.bold("Base commit message")]: options.message }, { [source_default.bold("Total codeowners")]: `${codeowners2.length}` }, { [source_default.bold("No-verify")]: !options.verify ? "Yes" : "No" }, {
+        [source_default.bold("Push")]: options.push ? `Yes → ${options.remote || "origin"}${options.force ? " (force)" : ""}` : "No"
+      }, {
+        [source_default.bold("Pull request")]: options.pr ? "Yes" : options.draftPr ? "Yes (draft)" : "No"
+      }, { [source_default.bold("Append mode")]: options.append ? "Yes" : "No" });
+      if (options.pathPattern) {
+        settingsTable.push({
+          [source_default.bold("Path filter")]: options.pathPattern
+        });
+      }
+      if (options.exclusive) {
+        settingsTable.push({
+          [source_default.bold("Exclusive mode")]: "Yes (only files solely owned by each owner)"
+        });
+      }
+      if (options.coOwned) {
+        settingsTable.push({
+          [source_default.bold("Co-owned mode")]: "Yes (only files with multiple owners)"
+        });
+      }
+      if (options.defaultOwner) {
+        settingsTable.push({
+          [source_default.bold("Default owner")]: options.defaultOwner
+        });
+      }
+      console.log(settingsTable.toString());
+      console.log("");
+      const summaryTable = new import_cli_table33.default({
+        head: ["Owner", "Branch", "Files", "Commit Message"],
+        colWidths: [22, 35, 8, 45],
+        wordWrap: true,
+        style: { head: ["cyan"] }
+      });
+      for (const p of previews) {
+        summaryTable.push([
+          p.owner,
+          p.branchName,
+          `${p.files.length}`,
+          p.commitMessage
+        ]);
+      }
+      console.log(summaryTable.toString());
+      console.log(source_default.bold.cyan(`
+Files by branch:`));
+      for (const p of previews) {
+        if (p.files.length > 0) {
+          console.log(`
+${source_default.bold(p.branchName)} ${source_default.dim(`(${p.owner})`)} — ${p.files.length} file${p.files.length !== 1 ? "s" : ""}:`);
+          p.files.forEach((file) => console.log(`  ${source_default.green("+")} ${file}`));
+        } else {
+          console.log(`
+${source_default.bold(p.branchName)} ${source_default.dim(`(${p.owner})`)} — ${source_default.yellow("0 files (branch will be skipped)")}`);
+        }
+      }
+      if (uncoveredFiles.length > 0) {
+        console.log(source_default.bold.yellow(`
+Uncovered staged files (${uncoveredFiles.length}) — not included in any branch:`));
+        uncoveredFiles.forEach((file) => console.log(`  ${source_default.yellow("!")} ${file}`));
+      }
+      if (filesWithoutOwners.length > 0 && !options.defaultOwner) {
+        console.log(source_default.bold.yellow(`
+Files without CODEOWNERS (${filesWithoutOwners.length}):`));
+        filesWithoutOwners.forEach((file) => console.log(`  ${source_default.yellow("?")} ${file}`));
+        console.log(source_default.dim("  Tip: Use --default-owner <owner> to assign these files"));
+      }
+      console.log(source_default.bold.cyan(`
+Summary:`));
+      console.log(`  Branches to create: ${source_default.bold(`${previews.length}`)}`);
+      console.log(`  Total files covered: ${source_default.bold(`${allCoveredFiles.size}`)} of ${changedFiles.length} staged`);
+      if (uncoveredFiles.length > 0) {
+        console.log(`  Uncovered files:     ${source_default.yellow(`${uncoveredFiles.length}`)}`);
+      }
+      console.log("");
+      return;
+    }
     const results = [];
     for (const owner of codeowners2) {
       const sanitizedOwner = owner.replace(/[^a-zA-Z0-9-_@]/g, "-").replace(/^@/, "");
@@ -18579,7 +18925,8 @@ Only staged files will be processed.`);
         operationState: operationState || undefined,
         pathPattern: options.pathPattern,
         exclusive: options.exclusive,
-        coOwned: options.coOwned
+        coOwned: options.coOwned,
+        json: options.json
       });
       results.push(result);
     }
@@ -18642,7 +18989,36 @@ Note: ${failureCount} branch(es) failed. Files were auto-restored to working dir
         log.info(`State preserved for reference. Run 'codeowners-git recover --id ${operationState.id}' if needed.`);
       }
     }
+    if (options.json) {
+      outputJson({
+        command: "multi-branch",
+        dryRun: false,
+        success: failureCount === 0,
+        totalOwners: codeowners2.length,
+        successCount,
+        failureCount,
+        results: results.map((r) => ({
+          owner: r.owner,
+          branch: r.branchName,
+          success: r.success,
+          files: r.files,
+          pushed: r.pushed,
+          prUrl: r.prUrl || null,
+          prNumber: r.prNumber || null,
+          error: r.error || null
+        }))
+      });
+    }
   } catch (err) {
+    if (options.json) {
+      outputJson({
+        command: "multi-branch",
+        dryRun: false,
+        success: false,
+        error: String(err)
+      });
+      process.exit(1);
+    }
     log.error(`Multi-branch operation failed: ${err}`);
     if (operationState) {
       log.info(`
@@ -18650,7 +19026,7 @@ Attempting auto-recovery...`);
       const currentState = loadOperationState(operationState.id);
       if (currentState) {
         try {
-          const recovered = await performRecovery(currentState, false);
+          const recovered = await performRecovery(currentState, false, { skipDirtyCheck: true });
           if (recovered) {
             log.success("Auto-recovery completed successfully");
           } else {
@@ -18670,7 +19046,11 @@ Manual recovery options:`);
 };
 
 // src/commands/extract.ts
+var import_cli_table34 = __toESM(require_table(), 1);
 var extract = async (options) => {
+  if (options.json) {
+    setSilent(true);
+  }
   try {
     if (!options.source) {
       log.error("Missing required option: --source");
@@ -18758,8 +19138,82 @@ Only staged files will be processed.`);
       }
       log.info(`Filtered to ${filesToExtract.length} file${filesToExtract.length !== 1 ? "s" : ""}`);
     }
+    if (options.dryRun) {
+      const excludedFiles = changedFiles.filter((f) => !filesToExtract.includes(f));
+      if (options.json) {
+        outputJson({
+          command: "extract",
+          dryRun: true,
+          source: options.source,
+          compareTarget: compareTarget || null,
+          files: filesToExtract,
+          excludedFiles,
+          totalChanged: changedFiles.length,
+          options: {
+            include: options.include || null,
+            pathPattern: options.pathPattern || null,
+            exclusive: options.exclusive || false,
+            coOwned: options.coOwned || false,
+            compareMain: options.compareMain || false
+          }
+        });
+        return;
+      }
+      log.header("Dry Run Preview — extract");
+      console.log("");
+      const detailsTable = new import_cli_table34.default({
+        style: { head: ["cyan"] },
+        wordWrap: true
+      });
+      detailsTable.push({ [source_default.bold("Source")]: options.source }, {
+        [source_default.bold("Compare target")]: compareTarget || "auto-detected"
+      }, {
+        [source_default.bold("Files in source")]: `${changedFiles.length} changed file${changedFiles.length !== 1 ? "s" : ""}`
+      }, {
+        [source_default.bold("Files to extract")]: `${filesToExtract.length} file${filesToExtract.length !== 1 ? "s" : ""}`
+      }, {
+        [source_default.bold("Files excluded")]: `${excludedFiles.length} file${excludedFiles.length !== 1 ? "s" : ""} (filtered out)`
+      });
+      if (options.include) {
+        detailsTable.push({
+          [source_default.bold("Owner filter")]: `${options.include}${options.exclusive ? " (exclusive)" : ""}`
+        });
+      }
+      if (options.pathPattern) {
+        detailsTable.push({
+          [source_default.bold("Path filter")]: options.pathPattern
+        });
+      }
+      if (options.coOwned) {
+        detailsTable.push({
+          [source_default.bold("Co-owned mode")]: "Yes (only files with multiple owners)"
+        });
+      }
+      console.log(detailsTable.toString());
+      console.log(source_default.bold.green(`
+Files to be extracted (${filesToExtract.length}):`));
+      filesToExtract.forEach((file) => console.log(`  ${source_default.green("+")} ${file}`));
+      if (excludedFiles.length > 0) {
+        console.log(source_default.bold.dim(`
+Excluded files (${excludedFiles.length}):`));
+        excludedFiles.forEach((file) => console.log(`  ${source_default.dim("-")} ${source_default.dim(file)}`));
+      }
+      console.log("");
+      return;
+    }
     log.info("Extracting files to working directory...");
     await extractFilesFromRef(options.source, filesToExtract);
+    if (options.json) {
+      outputJson({
+        command: "extract",
+        dryRun: false,
+        source: options.source,
+        compareTarget: compareTarget || null,
+        files: filesToExtract,
+        totalChanged: changedFiles.length
+      });
+      return;
+    }
     log.success(`
 ✓ Extracted ${filesToExtract.length} file${filesToExtract.length !== 1 ? "s" : ""} to working directory (unstaged)`);
     log.info(`
@@ -18771,13 +19225,17 @@ Next steps:`);
     log.info("  - Use 'cg branch' command to create a branch and commit");
     log.info("  - Example: cg branch -i @my-team -b my-branch -m 'Commit message' -p");
   } catch (err) {
+    if (options.json) {
+      outputJson({ command: "extract", error: String(err) });
+      process.exit(1);
+    }
     log.error(`
 ✗ Extraction failed: ${err}`);
     process.exit(1);
   }
 };
 // package.json
-var version = "2.0.2";
+var version = "2.1.0";
 
 // src/commands/version.ts
 function getVersion() {
@@ -18798,15 +19256,28 @@ Force exiting...`);
 
 Received ${signal}. Gracefully shutting down...`);
     const incompleteOps = getIncompleteOperations();
-    if (incompleteOps.length > 0) {
-      log.warn(`Found ${incompleteOps.length} incomplete operation(s).`);
+    if (incompleteOps.length === 0) {
+      process.exit(130);
+      return;
+    }
+    const mostRecent = incompleteOps[0];
+    log.warn(`Found ${incompleteOps.length} incomplete operation(s).`);
+    getCurrentBranch().then((currentBranch) => {
+      if (currentBranch !== mostRecent.originalBranch) {
+        log.info(`Returning to original branch: ${mostRecent.originalBranch}...`);
+        return checkout(mostRecent.originalBranch).then(() => {
+          log.success(`Returned to ${mostRecent.originalBranch}`);
+        });
+      }
+    }).catch(() => {
+      log.warn("Could not return to original branch automatically.");
+    }).finally(() => {
       log.info(`
-To recover from incomplete operations, run:`);
-      log.info("  codeowners-git recover --list    # List all incomplete operations");
+To fully recover from incomplete operations, run:`);
       log.info("  codeowners-git recover --auto    # Auto-recover most recent operation");
-      log.info("  codeowners-git recover --id <id> # Recover specific operation");
-    }
-    process.exit(130);
+      log.info("  codeowners-git recover --list    # List all incomplete operations");
+      process.exit(130);
+    });
   };
   process.on("SIGINT", () => handleShutdown("SIGINT"));
   process.on("SIGTERM", () => handleShutdown("SIGTERM"));
@@ -18816,7 +19287,7 @@ To recover from incomplete operations, run:`);
 setupSignalHandlers();
 var program2 = new Command;
 program2.name("codeowners-git (cg)").description("CLI tool for grouping and managing staged files by CODEOWNERS").version(getVersion());
-program2.command("list").description("Lists all git changed files by CODEOWNER").argument("[pattern]", "Path pattern to filter files (micromatch syntax, comma-separated)").option("-i, --include <patterns>", "Filter by owner patterns").option("-g, --group", "Group files by code owner").option("-e, --exclusive", "Only include files where the owner is the sole owner (no co-owners)").option("-c, --co-owned", "Only include files with multiple owners (co-owned files)").action((pattern, options) => {
+program2.command("list").description("Lists all git changed files by CODEOWNER").argument("[pattern]", "Path pattern to filter files (micromatch syntax, comma-separated)").option("-i, --include <patterns>", "Filter by owner patterns").option("-g, --group", "Group files by code owner").option("-e, --exclusive", "Only include files where the owner is the sole owner (no co-owners)").option("-c, --co-owned", "Only include files with multiple owners (co-owned files)").option("--json", "Output results as JSON (suppresses all other output)").action((pattern, options) => {
   if (options.exclusive && options.coOwned) {
     console.error("Error: Cannot use both --exclusive and --co-owned options");
     process.exit(1);
@@ -18826,7 +19297,7 @@ program2.command("list").description("Lists all git changed files by CODEOWNER")
     pathPattern: pattern
   });
 });
-program2.command("branch").description("Create new branch with codeowner changes").argument("[pattern]", "Path pattern to filter files (micromatch syntax, comma-separated)").requiredOption("-i, --include <patterns>", "Code owner pattern to filter files").requiredOption("-b, --branch <branch>", "Branch name").requiredOption("-m, --message <message>", "Commit message").option("-n, --no-verify", "Skip lint-staged or any other ci checks").option("-p, --push", "Push branch to remote after commit").option("-r, --remote <remote>", "Remote name to push to", "origin").option("-u, --upstream <upstream>", "Upstream branch name (defaults to local branch name)").option("-f, --force", "Force push to remote").option("-k, --keep-branch-on-failure", "Keep the created branch even if operation fails").option("--append", "Add commits to existing branch instead of creating a new one").option("--pr", "Create a pull request after pushing (requires --push)").option("--draft-pr", "Create a draft pull request after pushing (requires --push)").option("-e, --exclusive", "Only include files where the owner is the sole owner (no co-owners)").option("-c, --co-owned", "Only include files with multiple owners (co-owned files)").action((pattern, options) => {
+program2.command("branch").description("Create new branch with codeowner changes").argument("[pattern]", "Path pattern to filter files (micromatch syntax, comma-separated)").requiredOption("-i, --include <patterns>", "Code owner pattern to filter files").requiredOption("-b, --branch <branch>", "Branch name").requiredOption("-m, --message <message>", "Commit message").option("-n, --no-verify", "Skip lint-staged or any other ci checks").option("-p, --push", "Push branch to remote after commit").option("-r, --remote <remote>", "Remote name to push to", "origin").option("-u, --upstream <upstream>", "Upstream branch name (defaults to local branch name)").option("-f, --force", "Force push to remote").option("-k, --keep-branch-on-failure", "Keep the created branch even if operation fails").option("--append", "Add commits to existing branch instead of creating a new one").option("--pr", "Create a pull request after pushing (requires --push)").option("--draft-pr", "Create a draft pull request after pushing (requires --push)").option("-e, --exclusive", "Only include files where the owner is the sole owner (no co-owners)").option("-c, --co-owned", "Only include files with multiple owners (co-owned files)").option("--dry-run", "Preview the operation without making any changes").option("--json", "Output results as JSON (suppresses all other output)").action((pattern, options) => {
   if (options.exclusive && options.coOwned) {
     console.error("Error: Cannot use both --exclusive and --co-owned options");
     process.exit(1);
@@ -18836,7 +19307,7 @@ program2.command("branch").description("Create new branch with codeowner changes
     pathPattern: pattern
   });
 });
-program2.command("multi-branch").description("Create branches for all codeowners").argument("[pattern]", "Path pattern to filter files (micromatch syntax, comma-separated)").requiredOption("-b, --branch <branch>", "Base branch name (will be suffixed with codeowner name)").requiredOption("-m, --message <message>", "Base commit message (will be suffixed with codeowner name)").option("-n, --no-verify", "Skip lint-staged or any other ci checks").option("-p, --push", "Push branches to remote after commit").option("-r, --remote <remote>", "Remote name to push to", "origin").option("-u, --upstream <upstream>", "Upstream branch name pattern (defaults to local branch name)").option("-f, --force", "Force push to remote").option("-k, --keep-branch-on-failure", "Keep created branches even if operation fails").option("-d, --default-owner <defaultOwner>", "Default owner to use when no codeowners are found for changed files").option("--ignore <patterns>", "Comma-separated patterns to exclude codeowners (e.g., 'team-a,team-b')").option("--include <patterns>", "Comma-separated patterns to include codeowners (e.g., 'team-*,@org/*')").option("--append", "Add commits to existing branches instead of creating new ones").option("--pr", "Create pull requests after pushing (requires --push)").option("--draft-pr", "Create draft pull requests after pushing (requires --push)").option("-e, --exclusive", "Only include files where each owner is the sole owner (no co-owners)").option("-c, --co-owned", "Only include files with multiple owners (co-owned files)").action((pattern, options) => {
+program2.command("multi-branch").description("Create branches for all codeowners").argument("[pattern]", "Path pattern to filter files (micromatch syntax, comma-separated)").requiredOption("-b, --branch <branch>", "Base branch name (will be suffixed with codeowner name)").requiredOption("-m, --message <message>", "Base commit message (will be suffixed with codeowner name)").option("-n, --no-verify", "Skip lint-staged or any other ci checks").option("-p, --push", "Push branches to remote after commit").option("-r, --remote <remote>", "Remote name to push to", "origin").option("-u, --upstream <upstream>", "Upstream branch name pattern (defaults to local branch name)").option("-f, --force", "Force push to remote").option("-k, --keep-branch-on-failure", "Keep created branches even if operation fails").option("-d, --default-owner <defaultOwner>", "Default owner to use when no codeowners are found for changed files").option("--ignore <patterns>", "Comma-separated patterns to exclude codeowners (e.g., 'team-a,team-b')").option("--include <patterns>", "Comma-separated patterns to include codeowners (e.g., 'team-*,@org/*')").option("--append", "Add commits to existing branches instead of creating new ones").option("--pr", "Create pull requests after pushing (requires --push)").option("--draft-pr", "Create draft pull requests after pushing (requires --push)").option("-e, --exclusive", "Only include files where each owner is the sole owner (no co-owners)").option("-c, --co-owned", "Only include files with multiple owners (co-owned files)").option("--dry-run", "Preview the operation without making any changes").option("--json", "Output results as JSON (suppresses all other output)").action((pattern, options) => {
   if (options.exclusive && options.coOwned) {
     console.error("Error: Cannot use both --exclusive and --co-owned options");
     process.exit(1);
@@ -18846,7 +19317,7 @@ program2.command("multi-branch").description("Create branches for all codeowners
     pathPattern: pattern
   });
 });
-program2.command("extract").description("Extract file changes from a branch or commit to working directory").argument("[pattern]", "Path pattern to filter files (micromatch syntax, comma-separated)").requiredOption("-s, --source <source>", "Source branch or commit to extract from").option("-i, --include <patterns>", "Filter extracted files by code owner pattern").option("--compare-main", "Compare source against main branch instead of detecting merge-base").option("-e, --exclusive", "Only include files where the owner is the sole owner (no co-owners)").option("-c, --co-owned", "Only include files with multiple owners (co-owned files)").action((pattern, options) => {
+program2.command("extract").description("Extract file changes from a branch or commit to working directory").argument("[pattern]", "Path pattern to filter files (micromatch syntax, comma-separated)").requiredOption("-s, --source <source>", "Source branch or commit to extract from").option("-i, --include <patterns>", "Filter extracted files by code owner pattern").option("--compare-main", "Compare source against main branch instead of detecting merge-base").option("-e, --exclusive", "Only include files where the owner is the sole owner (no co-owners)").option("-c, --co-owned", "Only include files with multiple owners (co-owned files)").option("--dry-run", "Preview the operation without making any changes").option("--json", "Output results as JSON (suppresses all other output)").action((pattern, options) => {
   if (options.exclusive && options.coOwned) {
     console.error("Error: Cannot use both --exclusive and --co-owned options");
     process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "codeowners-git",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "module": "src/cli.ts",
   "type": "module",
   "private": false,