feat(source): add git status source for listing modified files

Implements a new source that lists files from git status, showing their
modification status (staged/unstaged/untracked). Useful for quickly
navigating to modified files in a git repository.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <[email protected]>

Author: lambdalisue

builtin/source/git_status.ts

@@ -0,0 +1,207 @@
+import * as fn from "@denops/std/function";
+import { join } from "@std/path/join";
+import { relative } from "@std/path/relative";
+
+import { defineSource, type Source } from "../../source.ts";
+
+type Detail = {
+  /**
+   * File path relative to git root
+   */
+  path: string;
+
+  /**
+   * Absolute file path
+   */
+  absolutePath: string;
+
+  /**
+   * Git status code (e.g., "M", "A", "D", "??")
+   */
+  status: string;
+
+  /**
+   * Human-readable status description
+   */
+  statusDescription: string;
+
+  /**
+   * Whether the file is staged
+   */
+  staged: boolean;
+
+  /**
+   * Whether the file is unstaged
+   */
+  unstaged: boolean;
+};
+
+export type GitStatusOptions = {
+  /**
+   * Whether to include untracked files.
+   * @default true
+   */
+  includeUntracked?: boolean;
+
+  /**
+   * Whether to include ignored files.
+   * @default false
+   */
+  includeIgnored?: boolean;
+
+  /**
+   * Whether to show status in submodules.
+   * @default false
+   */
+  includeSubmodules?: boolean;
+};
+
+/**
+ * Creates a Source that generates items from git status.
+ *
+ * This Source runs `git status` and generates items for each modified,
+ * staged, or untracked file in the repository.
+ *
+ * @param options - Options to customize git status listing.
+ * @returns A Source that generates items representing git status files.
+ */
+export function gitStatus(
+  options: Readonly<GitStatusOptions> = {},
+): Source<Detail> {
+  const includeUntracked = options.includeUntracked ?? true;
+  const includeIgnored = options.includeIgnored ?? false;
+  const includeSubmodules = options.includeSubmodules ?? false;
+
+  return defineSource(async function* (denops, _params, { signal }) {
+    // Get current working directory
+    const cwd = await fn.getcwd(denops);
+    signal?.throwIfAborted();
+
+    // Build git status command
+    const args = ["status", "--porcelain=v1"];
+    if (includeUntracked) {
+      args.push("-u");
+    } else {
+      args.push("-uno");
+    }
+    if (includeIgnored) {
+      args.push("--ignored");
+    }
+    if (!includeSubmodules) {
+      args.push("--ignore-submodules");
+    }
+
+    try {
+      // Run git status
+      const cmd = new Deno.Command("git", {
+        args,
+        cwd,
+        stdout: "piped",
+        stderr: "piped",
+        signal,
+      });
+
+      const { stdout, stderr, success } = await cmd.output();
+
+      if (!success) {
+        // Not a git repository or git command failed
+        const errorText = new TextDecoder().decode(stderr);
+        if (errorText.includes("not a git repository")) {
+          // Silently return empty - not an error condition
+          return;
+        }
+        throw new Error(`git status failed: ${errorText}`);
+      }
+
+      // Parse git status output
+      const output = new TextDecoder().decode(stdout);
+      const lines = output.trim().split("\n").filter((line) => line);
+
+      const items = lines.map((line, index) => {
+        // Git status format: XY filename
+        // X = staged status, Y = unstaged status
+        const staged = line[0];
+        const unstaged = line[1];
+        const filename = line.substring(3);
+
+        // Determine status code and description
+        let status = `${staged}${unstaged}`;
+        let statusDescription = "";
+        let isStaged = false;
+        let isUnstaged = false;
+
+        // Parse status codes
+        if (staged === "?" && unstaged === "?") {
+          statusDescription = "untracked";
+          isUnstaged = true;
+        } else if (staged === "!" && unstaged === "!") {
+          statusDescription = "ignored";
+        } else {
+          // Handle staged status
+          if (staged === "M") {
+            statusDescription = "modified";
+            isStaged = true;
+          } else if (staged === "A") {
+            statusDescription = "added";
+            isStaged = true;
+          } else if (staged === "D") {
+            statusDescription = "deleted";
+            isStaged = true;
+          } else if (staged === "R") {
+            statusDescription = "renamed";
+            isStaged = true;
+          } else if (staged === "C") {
+            statusDescription = "copied";
+            isStaged = true;
+          }
+
+          // Handle unstaged status
+          if (unstaged === "M") {
+            statusDescription += isStaged ? ", modified" : "modified";
+            isUnstaged = true;
+          } else if (unstaged === "D") {
+            statusDescription += isStaged ? ", deleted" : "deleted";
+            isUnstaged = true;
+          }
+        }
+
+        // Create status indicator
+        let indicator = "";
+        if (status === "??") {
+          indicator = "[?]";
+        } else if (status === "!!") {
+          indicator = "[!]";
+        } else {
+          indicator = `[${status}]`;
+        }
+
+        // Format display value
+        const absolutePath = join(cwd, filename);
+        const displayPath = filename;
+        const value = `${indicator.padEnd(5)} ${displayPath}`;
+
+        return {
+          id: index,
+          value,
+          detail: {
+            path: filename,
+            absolutePath,
+            status,
+            statusDescription,
+            staged: isStaged,
+            unstaged: isUnstaged,
+          },
+        };
+      });
+
+      yield* items;
+    } catch (err) {
+      // Handle errors gracefully
+      if (err.name === "NotFound") {
+        // Git not installed - silently return empty
+        return;
+      }
+      throw err;
+    }
+  });
+}

builtin/source/mod.ts

@@ -3,6 +3,7 @@ export * from "./buffer.ts";
 export * from "./colorscheme.ts";
 export * from "./command.ts";
 export * from "./file.ts";
+export * from "./git_status.ts";
 export * from "./helptag.ts";
 export * from "./highlight.ts";
 export * from "./history.ts";