Function commitPaths

src/utils/git.ts:186–212

(
  localPath: string,
  message: string,
  files: string[],
)

 * Does NOT push — the user pushes their business repo on their own cadence.
 */
export async function commitPaths(
  localPath: string,
  message: string,
  files: string[],
): Promise<boolean> {
  const git = createGit(localPath);
  const existing = files.filter((f) => fs.existsSync(path.join(localPath, f)));
  if (existing.length === 0) return false;
  // Add each path individually and tolerate `git add` failing on an
  // explicitly-gitignored path (it errors "Use -f if you really want to add
  // them"). Callers should not pass ignored paths, but a stray one must not
  // abort the whole commit. `--` guards against paths that look like options.
  let added = 0;
  for (const f of existing) {
    try {
      await git.add(['--', f]);
      added++;
    } catch {
      // ignored/unaddable path — skip it
    }
  }
  if (added === 0) return false;
  const status = await git.status();
  if (status.staged.length === 0) return false;
  await git.commit(message);
  return true;
}

/**
 * Pull the latest changes from origin into a local team-repo clone.