@xortex/xcode 3.0.0

package/utils/getWorktreePathsPortable.ts

@@ -0,0 +1,27 @@
+import { execFile as execFileCb } from 'child_process'
+import { promisify } from 'util'
+
+const execFileAsync = promisify(execFileCb)
+
+/**
+ * Portable worktree detection using only child_process — no analytics,
+ * no bootstrap deps, no execa. Used by listSessionsImpl.ts (SDK) and
+ * anywhere that needs worktree paths without pulling in the CLI
+ * dependency chain (execa → cross-spawn → which).
+ */
+export async function getWorktreePathsPortable(cwd: string): Promise<string[]> {
+  try {
+    const { stdout } = await execFileAsync(
+      'git',
+      ['worktree', 'list', '--porcelain'],
+      { cwd, timeout: 5000 },
+    )
+    if (!stdout) return []
+    return stdout
+      .split('\n')
+      .filter(line => line.startsWith('worktree '))
+      .map(line => line.slice('worktree '.length).normalize('NFC'))
+  } catch {
+    return []
+  }
+}

package/utils/ghPrStatus.ts

@@ -0,0 +1,106 @@
+import { execFileNoThrow } from './execFileNoThrow.js'
+import { getBranch, getDefaultBranch, getIsGit } from './git.js'
+import { jsonParse } from './slowOperations.js'
+
+export type PrReviewState =
+  | 'approved'
+  | 'pending'
+  | 'changes_requested'
+  | 'draft'
+  | 'merged'
+  | 'closed'
+
+export type PrStatus = {
+  number: number
+  url: string
+  reviewState: PrReviewState
+}
+
+const GH_TIMEOUT_MS = 5000
+
+/**
+ * Derive review state from GitHub API values.
+ * Draft PRs always show as 'draft' regardless of reviewDecision.
+ * reviewDecision can be: APPROVED, CHANGES_REQUESTED, REVIEW_REQUIRED, or empty string.
+ */
+export function deriveReviewState(
+  isDraft: boolean,
+  reviewDecision: string,
+): PrReviewState {
+  if (isDraft) return 'draft'
+  switch (reviewDecision) {
+    case 'APPROVED':
+      return 'approved'
+    case 'CHANGES_REQUESTED':
+      return 'changes_requested'
+    default:
+      return 'pending'
+  }
+}
+
+/**
+ * Fetch PR status for the current branch using `gh pr view`.
+ * Returns null on any failure (gh not installed, no PR, not in git repo, etc).
+ * Also returns null if the PR's head branch is the default branch (e.g., main/master).
+ */
+export async function fetchPrStatus(): Promise<PrStatus | null> {
+  const isGit = await getIsGit()
+  if (!isGit) return null
+
+  // Skip on the default branch — `gh pr view` returns the most recently
+  // merged PR there, which is misleading.
+  const [branch, defaultBranch] = await Promise.all([
+    getBranch(),
+    getDefaultBranch(),
+  ])
+  if (branch === defaultBranch) return null
+
+  const { stdout, code } = await execFileNoThrow(
+    'gh',
+    [
+      'pr',
+      'view',
+      '--json',
+      'number,url,reviewDecision,isDraft,headRefName,state',
+    ],
+    { timeout: GH_TIMEOUT_MS, preserveOutputOnError: false },
+  )
+
+  if (code !== 0 || !stdout.trim()) return null
+
+  try {
+    const data = jsonParse(stdout) as {
+      number: number
+      url: string
+      reviewDecision: string
+      isDraft: boolean
+      headRefName: string
+      state: string
+    }
+
+    // Don't show PR status for PRs from the default branch (e.g., main, master)
+    // This can happen when someone opens a PR from main to another branch
+    if (
+      data.headRefName === defaultBranch ||
+      data.headRefName === 'main' ||
+      data.headRefName === 'master'
+    ) {
+      return null
+    }
+
+    // Don't show PR status for merged or closed PRs — `gh pr view` returns
+    // the most recently associated PR for a branch, which may be merged/closed.
+    // The status line should only display open PRs.
+    if (data.state === 'MERGED' || data.state === 'CLOSED') {
+      return null
+    }
+
+    return {
+      number: data.number,
+      url: data.url,
+      reviewState: deriveReviewState(data.isDraft, data.reviewDecision),
+    }
+  } catch {
+    return null
+  }
+}

package/utils/git/gitConfigParser.ts

@@ -0,0 +1,277 @@
+/**
+ * Lightweight parser for .git/config files.
+ *
+ * Verified against git's config.c:
+ *   - Section names: case-insensitive, alphanumeric + hyphen
+ *   - Subsection names (quoted): case-sensitive, backslash escapes (\\ and \")
+ *   - Key names: case-insensitive, alphanumeric + hyphen
+ *   - Values: optional quoting, inline comments (# or ;), backslash escapes
+ */
+
+import { readFile } from 'fs/promises'
+import { join } from 'path'
+
+/**
+ * Parse a single value from .git/config.
+ * Finds the first matching key under the given section/subsection.
+ */
+export async function parseGitConfigValue(
+  gitDir: string,
+  section: string,
+  subsection: string | null,
+  key: string,
+): Promise<string | null> {
+  try {
+    const config = await readFile(join(gitDir, 'config'), 'utf-8')
+    return parseConfigString(config, section, subsection, key)
+  } catch {
+    return null
+  }
+}
+
+/**
+ * Parse a config value from an in-memory config string.
+ * Exported for testing.
+ */
+export function parseConfigString(
+  config: string,
+  section: string,
+  subsection: string | null,
+  key: string,
+): string | null {
+  const lines = config.split('\n')
+  const sectionLower = section.toLowerCase()
+  const keyLower = key.toLowerCase()
+
+  let inSection = false
+  for (const line of lines) {
+    const trimmed = line.trim()
+
+    // Skip empty lines and comment-only lines
+    if (trimmed.length === 0 || trimmed[0] === '#' || trimmed[0] === ';') {
+      continue
+    }
+
+    // Section header
+    if (trimmed[0] === '[') {
+      inSection = matchesSectionHeader(trimmed, sectionLower, subsection)
+      continue
+    }
+
+    if (!inSection) {
+      continue
+    }
+
+    // Key-value line: find the key name
+    const parsed = parseKeyValue(trimmed)
+    if (parsed && parsed.key.toLowerCase() === keyLower) {
+      return parsed.value
+    }
+  }
+
+  return null
+}
+
+/**
+ * Parse a key = value line. Returns null if the line doesn't contain a valid key.
+ */
+function parseKeyValue(line: string): { key: string; value: string } | null {
+  // Read key: alphanumeric + hyphen, starting with alpha
+  let i = 0
+  while (i < line.length && isKeyChar(line[i]!)) {
+    i++
+  }
+  if (i === 0) {
+    return null
+  }
+  const key = line.slice(0, i)
+
+  // Skip whitespace
+  while (i < line.length && (line[i] === ' ' || line[i] === '\t')) {
+    i++
+  }
+
+  // Must have '='
+  if (i >= line.length || line[i] !== '=') {
+    // Boolean key with no value — not relevant for our use cases
+    return null
+  }
+  i++ // skip '='
+
+  // Skip whitespace after '='
+  while (i < line.length && (line[i] === ' ' || line[i] === '\t')) {
+    i++
+  }
+
+  const value = parseValue(line, i)
+  return { key, value }
+}
+
+/**
+ * Parse a config value starting at position i.
+ * Handles quoted strings, escape sequences, and inline comments.
+ */
+function parseValue(line: string, start: number): string {
+  let result = ''
+  let inQuote = false
+  let i = start
+
+  while (i < line.length) {
+    const ch = line[i]!
+
+    // Inline comments outside quotes end the value
+    if (!inQuote && (ch === '#' || ch === ';')) {
+      break
+    }
+
+    if (ch === '"') {
+      inQuote = !inQuote
+      i++
+      continue
+    }
+
+    if (ch === '\\' && i + 1 < line.length) {
+      const next = line[i + 1]!
+      if (inQuote) {
+        // Inside quotes: recognize escape sequences
+        switch (next) {
+          case 'n':
+            result += '\n'
+            break
+          case 't':
+            result += '\t'
+            break
+          case 'b':
+            result += '\b'
+            break
+          case '"':
+            result += '"'
+            break
+          case '\\':
+            result += '\\'
+            break
+          default:
+            // Git silently drops the backslash for unknown escapes
+            result += next
+            break
+        }
+        i += 2
+        continue
+      }
+      // Outside quotes: backslash at end of line = continuation (we don't
+      // handle multi-line since we split on \n, but handle \\ and others)
+      if (next === '\\') {
+        result += '\\'
+        i += 2
+        continue
+      }
+      // Fallthrough — treat backslash literally outside quotes
+    }
+
+    result += ch
+    i++
+  }
+
+  // Trim trailing whitespace from unquoted portions.
+  // Git trims trailing whitespace that isn't inside quotes, but since we
+  // process char-by-char and quotes toggle, the simplest correct approach
+  // for single-line values is to trim the result when not ending in a quote.
+  if (!inQuote) {
+    result = trimTrailingWhitespace(result)
+  }
+
+  return result
+}
+
+function trimTrailingWhitespace(s: string): string {
+  let end = s.length
+  while (end > 0 && (s[end - 1] === ' ' || s[end - 1] === '\t')) {
+    end--
+  }
+  return s.slice(0, end)
+}
+
+/**
+ * Check if a config line like `[remote "origin"]` matches the given section/subsection.
+ * Section matching is case-insensitive; subsection matching is case-sensitive.
+ */
+function matchesSectionHeader(
+  line: string,
+  sectionLower: string,
+  subsection: string | null,
+): boolean {
+  // line starts with '['
+  let i = 1
+
+  // Read section name
+  while (
+    i < line.length &&
+    line[i] !== ']' &&
+    line[i] !== ' ' &&
+    line[i] !== '\t' &&
+    line[i] !== '"'
+  ) {
+    i++
+  }
+  const foundSection = line.slice(1, i).toLowerCase()
+
+  if (foundSection !== sectionLower) {
+    return false
+  }
+
+  if (subsection === null) {
+    // Simple section: must end with ']'
+    return i < line.length && line[i] === ']'
+  }
+
+  // Skip whitespace before subsection quote
+  while (i < line.length && (line[i] === ' ' || line[i] === '\t')) {
+    i++
+  }
+
+  // Must have opening quote
+  if (i >= line.length || line[i] !== '"') {
+    return false
+  }
+  i++ // skip opening quote
+
+  // Read subsection — case-sensitive, handle \\ and \" escapes
+  let foundSubsection = ''
+  while (i < line.length && line[i] !== '"') {
+    if (line[i] === '\\' && i + 1 < line.length) {
+      const next = line[i + 1]!
+      if (next === '\\' || next === '"') {
+        foundSubsection += next
+        i += 2
+        continue
+      }
+      // Git drops the backslash for other escapes in subsections
+      foundSubsection += next
+      i += 2
+      continue
+    }
+    foundSubsection += line[i]
+    i++
+  }
+
+  // Must have closing quote followed by ']'
+  if (i >= line.length || line[i] !== '"') {
+    return false
+  }
+  i++ // skip closing quote
+
+  if (i >= line.length || line[i] !== ']') {
+    return false
+  }
+
+  return foundSubsection === subsection
+}
+
+function isKeyChar(ch: string): boolean {
+  return (
+    (ch >= 'a' && ch <= 'z') ||
+    (ch >= 'A' && ch <= 'Z') ||
+    (ch >= '0' && ch <= '9') ||
+    ch === '-'
+  )
+}