@g-abhishek/gitx 0.1.1 → 0.1.4

package/dist/utils/git.js

@@ -11,24 +11,67 @@ export async function getGitRemoteOriginUrl(cwd = process.cwd()) {
         return undefined;
     }
 }
+export async function isInsideGitRepo(cwd = process.cwd()) {
+    try {
+        const { stdout } = await execFileAsync("git", ["rev-parse", "--is-inside-work-tree"], { cwd });
+        return String(stdout ?? "").trim() === "true";
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Infer a "owner/repo" slug from a git remote URL.
+ *
+ * Handles:
+ *   GitHub / GitLab:
+ *     git@github.com:owner/repo.git
+ *     https://github.com/owner/repo(.git)
+ *     ssh://git@github.com/owner/repo(.git)
+ *
+ *   Azure DevOps:
+ *     https://dev.azure.com/org/project/_git/repo
+ *     https://org.visualstudio.com/project/_git/repo
+ *     git@ssh.dev.azure.com:v3/org/project/repo        (new SSH format)
+ *     org@vs-ssh.visualstudio.com:v3/org/project/repo  (legacy SSH format)
+ *
+ * Returns:
+ *   GitHub/GitLab: "owner/repo"
+ *   Azure:         "org/project/repo"
+ */
 export function inferRepoSlugFromRemote(url) {
-    // Supports common GitHub/GitLab URL formats:
-    // - git@github.com:owner/repo.git
-    // - https://github.com/owner/repo(.git)
-    // - ssh://git@github.com/owner/repo(.git)
     const cleaned = url.trim();
-    const patterns = [
+    // ── GitHub / GitLab ──────────────────────────────────────────────────────
+    const ghGlPatterns = [
         /^(?:git@)(?:github\.com|gitlab\.com):(?<owner>[^/]+)\/(?<repo>[^/]+?)(?:\.git)?$/i,
         /^(?:https?:\/\/)(?:github\.com|gitlab\.com)\/(?<owner>[^/]+)\/(?<repo>[^/]+?)(?:\.git)?(?:\/)?$/i,
-        /^(?:ssh:\/\/)(?:git@)(?:github\.com|gitlab\.com)\/(?<owner>[^/]+)\/(?<repo>[^/]+?)(?:\.git)?$/i
+        /^(?:ssh:\/\/)(?:git@)?(?:github\.com|gitlab\.com)\/(?<owner>[^/]+)\/(?<repo>[^/]+?)(?:\.git)?$/i,
     ];
-    for (const re of patterns) {
+    for (const re of ghGlPatterns) {
         const match = re.exec(cleaned);
         const owner = match?.groups?.["owner"];
         const repo = match?.groups?.["repo"];
         if (owner && repo)
             return `${owner}/${repo}`;
     }
+    // ── Azure DevOps HTTPS ────────────────────────────────────────────────────
+    // https://dev.azure.com/{org}/{project}/_git/{repo}
+    const azHttps = /https?:\/\/dev\.azure\.com\/([^/]+)\/([^/]+)\/_git\/([^/]+?)(?:\.git)?(?:\/)?$/i.exec(cleaned);
+    if (azHttps)
+        return `${azHttps[1]}/${azHttps[2]}/${azHttps[3]}`;
+    // https://{org}.visualstudio.com/{project}/_git/{repo}
+    const azVs = /https?:\/\/([^.]+)\.visualstudio\.com\/([^/]+)\/_git\/([^/]+?)(?:\.git)?(?:\/)?$/i.exec(cleaned);
+    if (azVs)
+        return `${azVs[1]}/${azVs[2]}/${azVs[3]}`;
+    // ── Azure DevOps SSH ──────────────────────────────────────────────────────
+    // New format: git@ssh.dev.azure.com:v3/{org}/{project}/{repo}
+    const azSshNew = /^[^@]+@ssh\.dev\.azure\.com:v3\/([^/]+)\/([^/]+)\/([^/]+?)(?:\.git)?$/i.exec(cleaned);
+    if (azSshNew)
+        return `${azSshNew[1]}/${azSshNew[2]}/${azSshNew[3]}`;
+    // Legacy format: {org}@vs-ssh.visualstudio.com:v3/{org}/{project}/{repo}
+    const azSshLegacy = /^[^@]+@vs-ssh\.visualstudio\.com:v3\/([^/]+)\/([^/]+)\/([^/]+?)(?:\.git)?$/i.exec(cleaned);
+    if (azSshLegacy)
+        return `${azSshLegacy[1]}/${azSshLegacy[2]}/${azSshLegacy[3]}`;
     return undefined;
 }
 export async function resolveRepoSlugFromCwd(cwd = process.cwd()) {
@@ -37,4 +80,17 @@ export async function resolveRepoSlugFromCwd(cwd = process.cwd()) {
         return undefined;
     return inferRepoSlugFromRemote(originUrl);
 }
+export function detectProviderFromRemote(url) {
+    const cleaned = url.trim();
+    if (cleaned.includes("github.com"))
+        return "github";
+    if (cleaned.includes("gitlab.com"))
+        return "gitlab";
+    if (cleaned.includes("dev.azure.com") || // HTTPS + new SSH (ssh.dev.azure.com)
+        cleaned.includes("visualstudio.com") // legacy HTTPS + legacy SSH (vs-ssh.visualstudio.com)
+    ) {
+        return "azure";
+    }
+    return undefined;
+}
 //# sourceMappingURL=git.js.map

package/dist/utils/git.js.map

@@ -1 +1 @@
-{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAE1C,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC7D,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,aAAa,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,mBAAmB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACjG,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,GAAW;IACjD,6CAA6C;IAC7C,kCAAkC;IAClC,wCAAwC;IACxC,0CAA0C;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAE3B,MAAM,QAAQ,GAAa;QACzB,mFAAmF;QACnF,kGAAkG;QAClG,gGAAgG;KACjG,CAAC;IAEF,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,MAAM,KAAK,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC;QACrC,IAAI,KAAK,IAAI,IAAI;YAAE,OAAO,GAAG,KAAK,IAAI,IAAI,EAAE,CAAC;IAC/C,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE;IAC9D,MAAM,SAAS,GAAG,MAAM,qBAAqB,CAAC,GAAG,CAAC,CAAC;IACnD,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,OAAO,uBAAuB,CAAC,SAAS,CAAC,CAAC;AAC5C,CAAC","sourcesContent":["import { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\n\nconst execFileAsync = promisify(execFile);\n\nexport async function getGitRemoteOriginUrl(cwd = process.cwd()): Promise<string | undefined> {\n  try {\n    const { stdout } = await execFileAsync(\"git\", [\"config\", \"--get\", \"remote.origin.url\"], { cwd });\n    const url = String(stdout ?? \"\").trim();\n    return url.length > 0 ? url : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport function inferRepoSlugFromRemote(url: string): string | undefined {\n  // Supports common GitHub/GitLab URL formats:\n  // - git@github.com:owner/repo.git\n  // - https://github.com/owner/repo(.git)\n  // - ssh://git@github.com/owner/repo(.git)\n  const cleaned = url.trim();\n\n  const patterns: RegExp[] = [\n    /^(?:git@)(?:github\\.com|gitlab\\.com):(?<owner>[^/]+)\\/(?<repo>[^/]+?)(?:\\.git)?$/i,\n    /^(?:https?:\\/\\/)(?:github\\.com|gitlab\\.com)\\/(?<owner>[^/]+)\\/(?<repo>[^/]+?)(?:\\.git)?(?:\\/)?$/i,\n    /^(?:ssh:\\/\\/)(?:git@)(?:github\\.com|gitlab\\.com)\\/(?<owner>[^/]+)\\/(?<repo>[^/]+?)(?:\\.git)?$/i\n  ];\n\n  for (const re of patterns) {\n    const match = re.exec(cleaned);\n    const owner = match?.groups?.[\"owner\"];\n    const repo = match?.groups?.[\"repo\"];\n    if (owner && repo) return `${owner}/${repo}`;\n  }\n\n  return undefined;\n}\n\nexport async function resolveRepoSlugFromCwd(cwd = process.cwd()): Promise<string | undefined> {\n  const originUrl = await getGitRemoteOriginUrl(cwd);\n  if (!originUrl) return undefined;\n  return inferRepoSlugFromRemote(originUrl);\n}\n"]}
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/utils/git.ts"],"names":[],"mappings":"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","sourcesContent":["import { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\nimport type { ProviderKind } from \"../types/provider.js\";\n\nconst execFileAsync = promisify(execFile);\n\nexport async function getGitRemoteOriginUrl(cwd = process.cwd()): Promise<string | undefined> {\n  try {\n    const { stdout } = await execFileAsync(\"git\", [\"config\", \"--get\", \"remote.origin.url\"], { cwd });\n    const url = String(stdout ?? \"\").trim();\n    return url.length > 0 ? url : undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport async function isInsideGitRepo(cwd = process.cwd()): Promise<boolean> {\n  try {\n    const { stdout } = await execFileAsync(\"git\", [\"rev-parse\", \"--is-inside-work-tree\"], { cwd });\n    return String(stdout ?? \"\").trim() === \"true\";\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Infer a \"owner/repo\" slug from a git remote URL.\n *\n * Handles:\n *   GitHub / GitLab:\n *     git@github.com:owner/repo.git\n *     https://github.com/owner/repo(.git)\n *     ssh://git@github.com/owner/repo(.git)\n *\n *   Azure DevOps:\n *     https://dev.azure.com/org/project/_git/repo\n *     https://org.visualstudio.com/project/_git/repo\n *     git@ssh.dev.azure.com:v3/org/project/repo        (new SSH format)\n *     org@vs-ssh.visualstudio.com:v3/org/project/repo  (legacy SSH format)\n *\n * Returns:\n *   GitHub/GitLab: \"owner/repo\"\n *   Azure:         \"org/project/repo\"\n */\nexport function inferRepoSlugFromRemote(url: string): string | undefined {\n  const cleaned = url.trim();\n\n  // ── GitHub / GitLab ──────────────────────────────────────────────────────\n  const ghGlPatterns: RegExp[] = [\n    /^(?:git@)(?:github\\.com|gitlab\\.com):(?<owner>[^/]+)\\/(?<repo>[^/]+?)(?:\\.git)?$/i,\n    /^(?:https?:\\/\\/)(?:github\\.com|gitlab\\.com)\\/(?<owner>[^/]+)\\/(?<repo>[^/]+?)(?:\\.git)?(?:\\/)?$/i,\n    /^(?:ssh:\\/\\/)(?:git@)?(?:github\\.com|gitlab\\.com)\\/(?<owner>[^/]+)\\/(?<repo>[^/]+?)(?:\\.git)?$/i,\n  ];\n\n  for (const re of ghGlPatterns) {\n    const match = re.exec(cleaned);\n    const owner = match?.groups?.[\"owner\"];\n    const repo = match?.groups?.[\"repo\"];\n    if (owner && repo) return `${owner}/${repo}`;\n  }\n\n  // ── Azure DevOps HTTPS ────────────────────────────────────────────────────\n  // https://dev.azure.com/{org}/{project}/_git/{repo}\n  const azHttps = /https?:\\/\\/dev\\.azure\\.com\\/([^/]+)\\/([^/]+)\\/_git\\/([^/]+?)(?:\\.git)?(?:\\/)?$/i.exec(cleaned);\n  if (azHttps) return `${azHttps[1]}/${azHttps[2]}/${azHttps[3]}`;\n\n  // https://{org}.visualstudio.com/{project}/_git/{repo}\n  const azVs = /https?:\\/\\/([^.]+)\\.visualstudio\\.com\\/([^/]+)\\/_git\\/([^/]+?)(?:\\.git)?(?:\\/)?$/i.exec(cleaned);\n  if (azVs) return `${azVs[1]}/${azVs[2]}/${azVs[3]}`;\n\n  // ── Azure DevOps SSH ──────────────────────────────────────────────────────\n  // New format: git@ssh.dev.azure.com:v3/{org}/{project}/{repo}\n  const azSshNew = /^[^@]+@ssh\\.dev\\.azure\\.com:v3\\/([^/]+)\\/([^/]+)\\/([^/]+?)(?:\\.git)?$/i.exec(cleaned);\n  if (azSshNew) return `${azSshNew[1]}/${azSshNew[2]}/${azSshNew[3]}`;\n\n  // Legacy format: {org}@vs-ssh.visualstudio.com:v3/{org}/{project}/{repo}\n  const azSshLegacy = /^[^@]+@vs-ssh\\.visualstudio\\.com:v3\\/([^/]+)\\/([^/]+)\\/([^/]+?)(?:\\.git)?$/i.exec(cleaned);\n  if (azSshLegacy) return `${azSshLegacy[1]}/${azSshLegacy[2]}/${azSshLegacy[3]}`;\n\n  return undefined;\n}\n\nexport async function resolveRepoSlugFromCwd(cwd = process.cwd()): Promise<string | undefined> {\n  const originUrl = await getGitRemoteOriginUrl(cwd);\n  if (!originUrl) return undefined;\n  return inferRepoSlugFromRemote(originUrl);\n}\n\nexport function detectProviderFromRemote(url: string): ProviderKind | undefined {\n  const cleaned = url.trim();\n  if (cleaned.includes(\"github.com\")) return \"github\";\n  if (cleaned.includes(\"gitlab.com\")) return \"gitlab\";\n  if (\n    cleaned.includes(\"dev.azure.com\") ||   // HTTPS + new SSH (ssh.dev.azure.com)\n    cleaned.includes(\"visualstudio.com\")    // legacy HTTPS + legacy SSH (vs-ssh.visualstudio.com)\n  ) {\n    return \"azure\";\n  }\n  return undefined;\n}\n"]}

package/dist/utils/gitOps.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Extended git operations for the implement workflow.
+ * All functions execute native git commands via child_process.
+ */
+export declare function getCurrentBranch(cwd?: string): Promise<string>;
+/**
+ * Resolve the default branch (main/master/develop) by inspecting the remote.
+ * Falls back to "main" if nothing can be determined.
+ */
+export declare function getDefaultBranchFromGit(cwd?: string, configuredDefault?: string): Promise<string>;
+/**
+ * Create and checkout a new branch.
+ * If the branch already exists, just check it out.
+ */
+export declare function createAndCheckoutBranch(branchName: string, cwd?: string): Promise<void>;
+/** Sanitise a free-form task string into a valid branch name */
+export declare function slugifyBranchName(task: string, prefix?: string): string;
+/**
+ * Write content to a file inside the repo, creating parent directories as needed.
+ * Paths should be relative to `cwd`.
+ */
+export declare function writeRepoFile(relativePath: string, content: string, cwd?: string): Promise<void>;
+/**
+ * Apply a unified diff string using `git apply`.
+ * Returns `true` if applied cleanly, `false` if it failed (caller decides how
+ * to handle partial failures).
+ */
+export declare function applyUnifiedDiff(unifiedDiff: string, cwd?: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+export declare function stageAll(cwd?: string): Promise<void>;
+export declare function hasStagedChanges(cwd?: string): Promise<boolean>;
+export declare function commitChanges(message: string, cwd?: string): Promise<string>;
+export declare function pushBranch(branchName: string, cwd?: string): Promise<void>;
+/**
+ * List all tracked files in the repo (respects .gitignore).
+ * Returns paths relative to `cwd`.
+ */
+export declare function listTrackedFiles(cwd?: string): Promise<string[]>;
+/**
+ * Get the unified diff of only staged changes (`git diff --cached`).
+ * Use this when the caller wants to commit only what's already in the index.
+ */
+export declare function getStagedDiff(cwd?: string): Promise<string>;
+/**
+ * Get a compact stat summary of only staged changes (`git diff --cached --stat`).
+ */
+export declare function getStagedDiffStat(cwd?: string): Promise<string>;
+/**
+ * Get the unified diff of all uncommitted changes (staged + unstaged).
+ */
+export declare function getWorkingDiff(cwd?: string): Promise<string>;
+/**
+ * Get a compact summary of staged changes (--stat format):
+ * lists every changed file with insertion/deletion counts.
+ * Always small regardless of diff size — used to give the AI the
+ * complete picture of what changed even when the full diff is truncated.
+ */
+export declare function getWorkingDiffStat(cwd?: string): Promise<string>;
+/**
+ * Auto-detect the most likely base branch for the current feature branch.
+ *
+ * Strategy:
+ *   1. Check if the current branch has a configured upstream tracking branch.
+ *   2. Otherwise, try common default branch names (main, master, develop, dev).
+ *   3. For each candidate, count commits on HEAD that are NOT in that branch.
+ *      The candidate with the fewest such commits is the likely origin.
+ *
+ * Falls back to "main" if nothing can be determined.
+ */
+export declare function detectBaseBranch(cwd?: string): Promise<string>;
+/**
+ * Get the one-line commit log for commits on HEAD that are not in baseBranch.
+ * Used to give AI context about what this branch adds.
+ */
+export declare function getBranchCommits(cwd?: string, baseBranch?: string): Promise<string[]>;
+/**
+ * Get the unified diff of all changes between baseBranch and HEAD.
+ * This is what the PR reviewer would see — all additions across all commits.
+ */
+export declare function getBranchDiff(cwd?: string, baseBranch?: string): Promise<string>;
+/**
+ * Get the --stat summary of all changes between baseBranch and HEAD.
+ * Lists every file changed with insertion/deletion counts.
+ * Used alongside a truncated diff so the AI sees the full file list even
+ * when the detailed patch is cut off.
+ */
+export declare function getBranchStat(cwd?: string, baseBranch?: string): Promise<string>;
+/**
+ * Read file content as a string. Returns empty string if file doesn't exist.
+ */
+export declare function readRepoFile(relativePath: string, cwd?: string): Promise<string | undefined>;
+/**
+ * Check whether a branch exists on the remote (origin).
+ * Uses git ls-remote which does not require a full fetch.
+ */
+export declare function branchExistsOnRemote(branchName: string, cwd?: string): Promise<boolean>;
+/**
+ * Returns true if the working tree has uncommitted changes (staged or unstaged).
+ */
+export declare function isWorkingTreeDirty(cwd?: string): Promise<boolean>;
+/**
+ * Returns `git status --short` output for use in AI context.
+ * Returns an empty string when the working tree is clean or git fails.
+ */
+export declare function getGitStatus(cwd?: string): Promise<string>;
+/**
+ * Returns the last `count` commits as one-line summaries (hash + subject).
+ * Defaults to the last 10 commits.
+ */
+export declare function getRecentCommits(cwd?: string, count?: number): Promise<string[]>;
+/**
+ * Returns the list of git stashes as `stash@{0}: ...` strings.
+ * Returns an empty array when there are no stashes or git fails.
+ */
+export declare function getStashList(cwd?: string): Promise<string[]>;
+//# sourceMappingURL=gitOps.d.ts.map

package/dist/utils/gitOps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitOps.d.ts","sourceRoot":"","sources":["../../src/utils/gitOps.ts"],"names":[],"mappings":"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"}

package/dist/utils/gitOps.js

@@ -0,0 +1,380 @@
+/**
+ * Extended git operations for the implement workflow.
+ * All functions execute native git commands via child_process.
+ */
+import { execFile, exec } from "node:child_process";
+import { promisify } from "node:util";
+import { writeFile, mkdir } from "node:fs/promises";
+import { dirname, resolve, join } from "node:path";
+import { GitxError } from "./errors.js";
+const execFileAsync = promisify(execFile);
+const execAsync = promisify(exec);
+// ─── Internal helper ──────────────────────────────────────────────────────────
+async function git(args, cwd) {
+    try {
+        const { stdout } = await execFileAsync("git", args, { cwd });
+        return String(stdout ?? "").trim();
+    }
+    catch (err) {
+        const stderr = err.stderr ??
+            err.message ??
+            String(err);
+        throw new GitxError(`git ${args[0]} failed: ${stderr.trim()}`, {
+            exitCode: 1,
+            cause: err,
+        });
+    }
+}
+// ─── Branch operations ────────────────────────────────────────────────────────
+export async function getCurrentBranch(cwd = process.cwd()) {
+    return git(["rev-parse", "--abbrev-ref", "HEAD"], cwd);
+}
+/**
+ * Resolve the default branch (main/master/develop) by inspecting the remote.
+ * Falls back to "main" if nothing can be determined.
+ */
+export async function getDefaultBranchFromGit(cwd = process.cwd(), configuredDefault) {
+    if (configuredDefault)
+        return configuredDefault;
+    try {
+        // Try to read from remote HEAD reference
+        const out = await git(["rev-parse", "--abbrev-ref", "origin/HEAD"], cwd);
+        // "origin/main" → "main"
+        return out.replace(/^origin\//, "") || "main";
+    }
+    catch {
+        // Fall back to checking common branch names
+        try {
+            const branches = await git(["branch", "-r", "--format=%(refname:short)"], cwd);
+            const candidates = ["origin/main", "origin/master", "origin/develop"];
+            for (const candidate of candidates) {
+                if (branches.split("\n").some((b) => b.trim() === candidate)) {
+                    return candidate.replace("origin/", "");
+                }
+            }
+        }
+        catch {
+            /* ignore */
+        }
+        return "main";
+    }
+}
+/**
+ * Create and checkout a new branch.
+ * If the branch already exists, just check it out.
+ */
+export async function createAndCheckoutBranch(branchName, cwd = process.cwd()) {
+    try {
+        await git(["checkout", "-b", branchName], cwd);
+    }
+    catch {
+        // Branch might already exist – try checking it out
+        await git(["checkout", branchName], cwd);
+    }
+}
+/** Sanitise a free-form task string into a valid branch name */
+export function slugifyBranchName(task, prefix = "gitx") {
+    const slug = task
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 50);
+    const ts = Date.now().toString(36);
+    return `${prefix}/${slug}-${ts}`;
+}
+// ─── File operations ──────────────────────────────────────────────────────────
+/**
+ * Write content to a file inside the repo, creating parent directories as needed.
+ * Paths should be relative to `cwd`.
+ */
+export async function writeRepoFile(relativePath, content, cwd = process.cwd()) {
+    const abs = resolve(join(cwd, relativePath));
+    await mkdir(dirname(abs), { recursive: true });
+    await writeFile(abs, content, "utf-8");
+}
+// ─── Diff application ─────────────────────────────────────────────────────────
+/**
+ * Apply a unified diff string using `git apply`.
+ * Returns `true` if applied cleanly, `false` if it failed (caller decides how
+ * to handle partial failures).
+ */
+export async function applyUnifiedDiff(unifiedDiff, cwd = process.cwd()) {
+    try {
+        // Use --3way to handle minor conflicts gracefully
+        const { stdout, stderr } = await execAsync(`echo ${JSON.stringify(unifiedDiff)} | git apply --3way --whitespace=fix -`, { cwd });
+        return { ok: true, error: stderr || stdout || undefined };
+    }
+    catch (err) {
+        const stderr = err.stderr ??
+            err.message ??
+            String(err);
+        return { ok: false, error: stderr.trim() };
+    }
+}
+// ─── Staging & committing ─────────────────────────────────────────────────────
+export async function stageAll(cwd = process.cwd()) {
+    await git(["add", "-A"], cwd);
+}
+export async function hasStagedChanges(cwd = process.cwd()) {
+    try {
+        const out = await git(["diff", "--cached", "--name-only"], cwd);
+        return out.trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+export async function commitChanges(message, cwd = process.cwd()) {
+    await git(["commit", "-m", message], cwd);
+    return git(["rev-parse", "HEAD"], cwd);
+}
+// ─── Push ─────────────────────────────────────────────────────────────────────
+export async function pushBranch(branchName, cwd = process.cwd()) {
+    await git(["push", "--set-upstream", "origin", branchName], cwd);
+}
+// ─── Repo inspection ──────────────────────────────────────────────────────────
+/**
+ * List all tracked files in the repo (respects .gitignore).
+ * Returns paths relative to `cwd`.
+ */
+export async function listTrackedFiles(cwd = process.cwd()) {
+    try {
+        const out = await git(["ls-files"], cwd);
+        return out
+            .split("\n")
+            .map((l) => l.trim())
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get the unified diff of only staged changes (`git diff --cached`).
+ * Use this when the caller wants to commit only what's already in the index.
+ */
+export async function getStagedDiff(cwd = process.cwd()) {
+    try {
+        return await git(["diff", "--cached"], cwd);
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Get a compact stat summary of only staged changes (`git diff --cached --stat`).
+ */
+export async function getStagedDiffStat(cwd = process.cwd()) {
+    try {
+        return await git(["diff", "--cached", "--stat"], cwd);
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Get the unified diff of all uncommitted changes (staged + unstaged).
+ */
+export async function getWorkingDiff(cwd = process.cwd()) {
+    try {
+        const staged = await git(["diff", "--cached"], cwd);
+        const unstaged = await git(["diff"], cwd);
+        return [staged, unstaged].filter(Boolean).join("\n");
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Get a compact summary of staged changes (--stat format):
+ * lists every changed file with insertion/deletion counts.
+ * Always small regardless of diff size — used to give the AI the
+ * complete picture of what changed even when the full diff is truncated.
+ */
+export async function getWorkingDiffStat(cwd = process.cwd()) {
+    try {
+        const staged = await git(["diff", "--cached", "--stat"], cwd);
+        const unstaged = await git(["diff", "--stat"], cwd);
+        return [staged, unstaged].filter(Boolean).join("\n");
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Auto-detect the most likely base branch for the current feature branch.
+ *
+ * Strategy:
+ *   1. Check if the current branch has a configured upstream tracking branch.
+ *   2. Otherwise, try common default branch names (main, master, develop, dev).
+ *   3. For each candidate, count commits on HEAD that are NOT in that branch.
+ *      The candidate with the fewest such commits is the likely origin.
+ *
+ * Falls back to "main" if nothing can be determined.
+ */
+export async function detectBaseBranch(cwd = process.cwd()) {
+    // Get current branch name upfront — used for all checks below
+    const current = await git(["rev-parse", "--abbrev-ref", "HEAD"], cwd).catch(() => "");
+    // 1. Try upstream tracking branch — only useful if it points to a DIFFERENT
+    //    branch (e.g. origin/main), not the branch's own remote tracking ref.
+    //    e.g. "origin/gitx/test" → "gitx/test" == current → skip
+    //         "origin/main"      → "main"       != current → use it
+    try {
+        const upstream = await git(["rev-parse", "--abbrev-ref", "@{upstream}"], cwd);
+        const branch = upstream.replace(/^[^/]+\//, "").trim();
+        if (branch && branch !== current)
+            return branch;
+    }
+    catch {
+        // No upstream configured — fall through
+    }
+    // 2. Check remote HEAD (origin's default branch)
+    try {
+        const remoteHead = await git(["rev-parse", "--abbrev-ref", "origin/HEAD"], cwd);
+        const branch = remoteHead.replace(/^origin\//, "").trim();
+        if (branch && branch !== current)
+            return branch;
+    }
+    catch {
+        // Not available — fall through
+    }
+    // 3. Count commits ahead of each common default branch name
+    const candidates = ["main", "master", "develop", "dev", "staging"];
+    const counts = [];
+    for (const candidate of candidates) {
+        if (candidate === current)
+            continue;
+        try {
+            // Count commits on HEAD not in candidate
+            const out = await git(["rev-list", "--count", `${candidate}..HEAD`], cwd);
+            counts.push({ branch: candidate, ahead: parseInt(out.trim(), 10) || 0 });
+        }
+        catch {
+            // Branch doesn't exist locally — skip
+        }
+    }
+    if (counts.length > 0) {
+        // Pick the branch with the fewest commits ahead (closest ancestor)
+        counts.sort((a, b) => a.ahead - b.ahead);
+        return counts[0].branch;
+    }
+    return "main";
+}
+/**
+ * Get the one-line commit log for commits on HEAD that are not in baseBranch.
+ * Used to give AI context about what this branch adds.
+ */
+export async function getBranchCommits(cwd = process.cwd(), baseBranch = "main") {
+    try {
+        const out = await git(["log", "--oneline", "--no-decorate", `${baseBranch}..HEAD`], cwd);
+        return out.split("\n").map((l) => l.trim()).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get the unified diff of all changes between baseBranch and HEAD.
+ * This is what the PR reviewer would see — all additions across all commits.
+ */
+export async function getBranchDiff(cwd = process.cwd(), baseBranch = "main") {
+    try {
+        // Three-dot diff: all changes introduced by this branch vs. the merge base
+        return await git(["diff", `${baseBranch}...HEAD`], cwd);
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Get the --stat summary of all changes between baseBranch and HEAD.
+ * Lists every file changed with insertion/deletion counts.
+ * Used alongside a truncated diff so the AI sees the full file list even
+ * when the detailed patch is cut off.
+ */
+export async function getBranchStat(cwd = process.cwd(), baseBranch = "main") {
+    try {
+        return await git(["diff", "--stat", `${baseBranch}...HEAD`], cwd);
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Read file content as a string. Returns empty string if file doesn't exist.
+ */
+export async function readRepoFile(relativePath, cwd = process.cwd()) {
+    try {
+        const abs = resolve(join(cwd, relativePath));
+        const { readFile } = await import("node:fs/promises");
+        return await readFile(abs, "utf-8");
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Check whether a branch exists on the remote (origin).
+ * Uses git ls-remote which does not require a full fetch.
+ */
+export async function branchExistsOnRemote(branchName, cwd = process.cwd()) {
+    try {
+        const out = await git(["ls-remote", "--heads", "origin", `refs/heads/${branchName}`], cwd);
+        return out.trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Returns true if the working tree has uncommitted changes (staged or unstaged).
+ */
+export async function isWorkingTreeDirty(cwd = process.cwd()) {
+    try {
+        const out = await git(["status", "--porcelain"], cwd);
+        return out.trim().length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+// ─── Context helpers for `gitx ask` ──────────────────────────────────────────
+/**
+ * Returns `git status --short` output for use in AI context.
+ * Returns an empty string when the working tree is clean or git fails.
+ */
+export async function getGitStatus(cwd = process.cwd()) {
+    try {
+        return await git(["status", "--short"], cwd);
+    }
+    catch {
+        return "";
+    }
+}
+/**
+ * Returns the last `count` commits as one-line summaries (hash + subject).
+ * Defaults to the last 10 commits.
+ */
+export async function getRecentCommits(cwd = process.cwd(), count = 10) {
+    try {
+        const out = await git(["log", "--oneline", "--no-decorate", `-${count}`], cwd);
+        return out.split("\n").map((l) => l.trim()).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Returns the list of git stashes as `stash@{0}: ...` strings.
+ * Returns an empty array when there are no stashes or git fails.
+ */
+export async function getStashList(cwd = process.cwd()) {
+    try {
+        const out = await git(["stash", "list"], cwd);
+        return out.split("\n").map((l) => l.trim()).filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=gitOps.js.map