@huhuhang/multipull 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 huhuhang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,101 @@
+# multipull
+
+Pull many Git repositories safely from one CLI.
+
+`multipull` scans a directory tree for real Git repositories, skips noisy generated folders, and runs a conservative pull operation for each repository.
+
+## Features
+
+- Discovers repository roots before running Git commands.
+- Skips common heavy directories such as `node_modules`, `dist`, `build`, `target`, `vendor`, `lab-*`, and `challenge-*`.
+- Uses a safe pull strategy: `git pull --ff-only --prune`.
+- Skips dirty worktrees by default.
+- Skips detached HEAD and branches without an upstream.
+- Shows one clear final table with repository, branch, upstream, and result.
+- Optionally parks dirty work on a `multipull-backup/*` branch before switching to the default branch.
+
+## Installation
+
+```bash
+npm install -g @huhuhang/multipull
+```
+
+Development checkout:
+
+```bash
+git clone https://github.com/huhuhang/multipull.git
+cd multipull
+npm install
+npm run build
+npm link
+```
+
+## Usage
+
+```bash
+multipull [paths...]
+```
+
+Examples:
+
+```bash
+multipull
+multipull ~/GitHub
+multipull ~/GitHub ~/Work
+multipull --dry-run
+multipull --verbose
+multipull --park-to-default-branch
+```
+
+## Options
+
+```text
+--dry-run                 Show planned actions without pulling.
+--verbose                 Show Git output details after the summary table.
+--park-to-default-branch  Preserve dirty changes before switching to the default branch.
+```
+
+The public CLI is intentionally small. Concurrency, scan depth, timeout, and ignore rules are internal defaults so the command stays easy to use.
+
+## Default Behavior
+
+For each discovered repository, `multipull`:
+
+1. Reads the current branch, upstream, and worktree status.
+2. Skips dirty worktrees unless `--park-to-default-branch` is enabled and a default branch switch is needed.
+3. Skips detached HEAD.
+4. Skips branches without an upstream.
+5. Runs `git pull --ff-only --prune`.
+6. Prints a final summary table.
+
+## Parking Local Work
+
+`--park-to-default-branch` is explicit because it creates Git history and switches branches.
+
+When enabled:
+
+- If the repository is already on its default branch, `multipull` pulls normally.
+- If the repository is on another clean branch, `multipull` switches to the default branch and pulls.
+- If the repository is on another dirty branch, `multipull` creates a `multipull-backup/*` branch, commits the current worktree there, switches to the default branch, and pulls.
+
+Ignored files are not force-added or deleted.
+
+## Development
+
+```bash
+npm install
+npm run typecheck
+npm test
+npm run build
+npm run check
+```
+
+Run from source:
+
+```bash
+npm run dev -- ~/GitHub --dry-run
+```
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export declare function main(argv?: string[]): Promise<number>;

package/dist/cli.js

@@ -0,0 +1,84 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { DEFAULT_MAX_DEPTH } from "./defaults.js";
+import { discoverRepos } from "./discover.js";
+import { ok, runGit } from "./git.js";
+import { renderTable } from "./table.js";
+import { runRepos } from "./runner.js";
+function printDetails(results, verbose) {
+    const detailItems = results.filter((item) => {
+        if (verbose) {
+            return Boolean(item.output || item.detail);
+        }
+        return item.category === "fail" && Boolean(item.detail || item.output);
+    });
+    if (detailItems.length === 0) {
+        return;
+    }
+    console.log();
+    console.log("Details");
+    console.log("-------");
+    for (const item of detailItems) {
+        console.log(`${item.repo.label}: ${item.detail || item.result}`);
+        if (verbose && item.output) {
+            for (const line of item.output.split(/\r?\n/)) {
+                console.log(`  ${line}`);
+            }
+        }
+    }
+}
+export async function main(argv = process.argv) {
+    const program = new Command()
+        .name("multipull")
+        .description("Pull many Git repositories safely.")
+        .argument("[paths...]", "root directories to scan", ["."])
+        .option("--dry-run", "show planned actions without pulling")
+        .option("--verbose", "show git output details after the summary table")
+        .option("--park-to-default-branch", "preserve dirty changes on a multipull-backup/* branch before switching to the default branch")
+        .showHelpAfterError();
+    program.parse(argv);
+    const paths = program.args.length > 0 ? program.args : ["."];
+    const options = program.opts();
+    if (!ok(await runGit(process.cwd(), ["--version"], 10_000))) {
+        console.error("multipull: git command not found");
+        return 127;
+    }
+    const { repos, missing } = await discoverRepos(paths, { maxDepth: DEFAULT_MAX_DEPTH });
+    for (const path of missing) {
+        console.error(`multipull: skipped missing directory: ${path}`);
+    }
+    if (repos.length === 0) {
+        console.log("No Git repositories found.");
+        return missing.length > 0 ? 1 : 0;
+    }
+    const results = await runRepos(repos, {
+        dryRun: options.dryRun ?? false,
+        verbose: options.verbose ?? false,
+        parkToDefaultBranch: options.parkToDefaultBranch ?? false
+    });
+    console.log(renderTable(results));
+    const counts = {
+        ok: results.filter((item) => item.category === "ok").length,
+        skipped: results.filter((item) => item.category === "skip").length,
+        failed: results.filter((item) => item.category === "fail").length,
+        ready: results.filter((item) => item.category === "dry").length
+    };
+    console.log();
+    if (options.dryRun) {
+        console.log(`Summary: ready ${counts.ready}, skipped ${counts.skipped}, failed ${counts.failed}.`);
+    }
+    else {
+        console.log(`Summary: ok ${counts.ok}, skipped ${counts.skipped}, failed ${counts.failed}.`);
+    }
+    printDetails(results, options.verbose ?? false);
+    return counts.failed > 0 ? 1 : 0;
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main().then((code) => {
+        process.exitCode = code;
+    }, (error) => {
+        console.error(error instanceof Error ? error.message : String(error));
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/defaults.d.ts

@@ -0,0 +1,5 @@
+export declare const DEFAULT_JOBS = 4;
+export declare const DEFAULT_MAX_DEPTH = 4;
+export declare const DEFAULT_TIMEOUT_MS = 300000;
+export declare const SCAN_IGNORE_NAMES: Set<string>;
+export declare const SCAN_IGNORE_PREFIXES: string[];

package/dist/defaults.js

@@ -0,0 +1,32 @@
+export const DEFAULT_JOBS = 4;
+export const DEFAULT_MAX_DEPTH = 4;
+export const DEFAULT_TIMEOUT_MS = 300_000;
+export const SCAN_IGNORE_NAMES = new Set([
+    ".build",
+    ".cache",
+    ".gradle",
+    ".idea",
+    ".mypy_cache",
+    ".next",
+    ".nuxt",
+    ".parcel-cache",
+    ".pytest_cache",
+    ".ruff_cache",
+    ".tox",
+    ".turbo",
+    ".venv",
+    "__pycache__",
+    "build",
+    "coverage",
+    "DerivedData",
+    "dist",
+    "env",
+    "node_modules",
+    "out",
+    "Pods",
+    "target",
+    "vendor",
+    "venv"
+]);
+export const SCAN_IGNORE_PREFIXES = ["lab-", "challenge-"];
+//# sourceMappingURL=defaults.js.map

package/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAC9B,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC;AAE1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAC;IACvC,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,OAAO;IACP,aAAa;IACb,OAAO;IACP,OAAO;IACP,eAAe;IACf,eAAe;IACf,aAAa;IACb,MAAM;IACN,QAAQ;IACR,OAAO;IACP,aAAa;IACb,OAAO;IACP,UAAU;IACV,aAAa;IACb,MAAM;IACN,KAAK;IACL,cAAc;IACd,KAAK;IACL,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,MAAM;CACP,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC"}

package/dist/discover.d.ts

@@ -0,0 +1,5 @@
+import type { DiscoverOptions, Repo } from "./types.js";
+export declare function discoverRepos(rawRoots: string[], options?: DiscoverOptions): Promise<{
+    repos: Repo[];
+    missing: string[];
+}>;

package/dist/discover.js

@@ -0,0 +1,89 @@
+import { opendir, realpath, stat } from "node:fs/promises";
+import { relative, resolve, sep } from "node:path";
+import { DEFAULT_MAX_DEPTH, SCAN_IGNORE_NAMES, SCAN_IGNORE_PREFIXES } from "./defaults.js";
+import { repoName, verifyRepo } from "./git.js";
+function shouldIgnoreDir(name) {
+    return SCAN_IGNORE_NAMES.has(name) || SCAN_IGNORE_PREFIXES.some((prefix) => name.startsWith(prefix));
+}
+function scanDepth(root, dirPath) {
+    const rel = relative(root, dirPath);
+    return rel === "" ? 0 : rel.split(sep).length;
+}
+function displayLabel(repoPath, roots) {
+    const containingRoots = roots.filter((root) => repoPath === root || repoPath.startsWith(`${root}${sep}`));
+    if (containingRoots.length > 0) {
+        const root = containingRoots.sort((a, b) => b.length - a.length)[0];
+        if (root) {
+            const rel = relative(root, repoPath);
+            if (rel !== "") {
+                return rel;
+            }
+        }
+    }
+    return repoName(repoPath);
+}
+async function isDirectory(path) {
+    try {
+        return (await stat(path)).isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function walkForRepos(root, dirPath, options, seen, repoPaths) {
+    let dir;
+    try {
+        dir = await opendir(dirPath);
+    }
+    catch {
+        return;
+    }
+    const childDirs = [];
+    let hasGitEntry = false;
+    for await (const entry of dir) {
+        if (entry.name === ".git" && (entry.isDirectory() || entry.isFile())) {
+            hasGitEntry = true;
+            continue;
+        }
+        if (!entry.isDirectory() || entry.isSymbolicLink() || shouldIgnoreDir(entry.name)) {
+            continue;
+        }
+        childDirs.push(resolve(dirPath, entry.name));
+    }
+    if (hasGitEntry) {
+        const repoRoot = await verifyRepo(dirPath);
+        if (repoRoot && !seen.has(repoRoot)) {
+            seen.add(repoRoot);
+            repoPaths.push(repoRoot);
+        }
+    }
+    if (options.maxDepth > 0 && scanDepth(root, dirPath) >= options.maxDepth) {
+        return;
+    }
+    await Promise.all(childDirs.map((child) => walkForRepos(root, child, options, seen, repoPaths)));
+}
+export async function discoverRepos(rawRoots, options = { maxDepth: DEFAULT_MAX_DEPTH }) {
+    const roots = [];
+    const missing = [];
+    for (const rawRoot of rawRoots) {
+        const resolved = resolve(rawRoot);
+        if (!(await isDirectory(resolved))) {
+            missing.push(rawRoot);
+            continue;
+        }
+        roots.push(await realpath(resolved));
+    }
+    const seen = new Set();
+    const repoPaths = [];
+    await Promise.all(roots.map((root) => walkForRepos(root, root, options, seen, repoPaths)));
+    return {
+        repos: repoPaths
+            .sort((a, b) => a.localeCompare(b))
+            .map((path) => ({
+            path,
+            label: displayLabel(path, roots)
+        })),
+        missing
+    };
+}
+//# sourceMappingURL=discover.js.map

package/dist/discover.js.map

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

package/dist/git.d.ts

@@ -0,0 +1,23 @@
+import type { GitCommandResult, Repo, WorktreeStatus } from "./types.js";
+export declare function combinedOutput(result: GitCommandResult): string;
+export declare function firstLine(text: string): string;
+export declare function runGit(repoPath: string, args: string[], timeoutMs?: number): Promise<GitCommandResult>;
+export declare function ok(result: GitCommandResult): boolean;
+export declare function verifyRepo(candidatePath: string): Promise<string | undefined>;
+export declare function parseStatusHeader(header: string): Pick<WorktreeStatus, "branch" | "upstream" | "detached">;
+export declare function inspectWorktree(repo: Repo, timeoutMs: number): Promise<WorktreeStatus>;
+export declare function localBranchExists(repo: Repo, branch: string, timeoutMs: number): Promise<boolean>;
+export declare function remoteBranchExists(repo: Repo, remote: string, branch: string, timeoutMs: number): Promise<boolean>;
+export declare function resolveDefaultBranch(repo: Repo, timeoutMs: number): Promise<string | undefined>;
+export declare function checkoutDefaultBranch(repo: Repo, targetBranch: string, timeoutMs: number): Promise<GitCommandResult>;
+export declare function uniqueBackupBranch(repo: Repo, sourceBranch: string, timeoutMs: number): Promise<string>;
+export declare function commitWorktreeToBackupBranch(repo: Repo, status: WorktreeStatus, timeoutMs: number): Promise<{
+    branch: string;
+    result: GitCommandResult;
+}>;
+export declare function parkAndCheckoutDefaultBranch(repo: Repo, status: WorktreeStatus, targetBranch: string, timeoutMs: number): Promise<{
+    backupBranch?: string;
+    result: GitCommandResult;
+}>;
+export declare function classifyPullSuccess(repo: Repo, beforeHead: string, timeoutMs: number): Promise<string>;
+export declare function repoName(repoPath: string): string;

package/dist/git.js

@@ -0,0 +1,236 @@
+import { execFile } from "node:child_process";
+import { basename } from "node:path";
+import { DEFAULT_TIMEOUT_MS } from "./defaults.js";
+export function combinedOutput(result) {
+    return [result.stdout.trim(), result.stderr.trim()].filter(Boolean).join("\n");
+}
+export function firstLine(text) {
+    return text
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .find(Boolean) ?? "";
+}
+export function runGit(repoPath, args, timeoutMs = DEFAULT_TIMEOUT_MS) {
+    return new Promise((resolve) => {
+        execFile("git", ["-C", repoPath, ...args], {
+            encoding: "utf8",
+            env: {
+                ...process.env,
+                GIT_TERMINAL_PROMPT: process.env.GIT_TERMINAL_PROMPT ?? "0"
+            },
+            maxBuffer: 10 * 1024 * 1024,
+            timeout: timeoutMs
+        }, (error, stdout, stderr) => {
+            if (!error) {
+                resolve({ code: 0, stdout, stderr, timedOut: false });
+                return;
+            }
+            const nodeError = error;
+            const code = typeof nodeError.code === "number" ? nodeError.code : nodeError.killed ? 124 : 1;
+            resolve({
+                code,
+                stdout,
+                stderr,
+                timedOut: nodeError.killed === true || nodeError.signal === "SIGTERM"
+            });
+        });
+    });
+}
+export function ok(result) {
+    return result.code === 0 && !result.timedOut;
+}
+export async function verifyRepo(candidatePath) {
+    const result = await runGit(candidatePath, ["rev-parse", "--show-toplevel"], 30_000);
+    if (!ok(result)) {
+        return undefined;
+    }
+    const root = result.stdout.trim();
+    return root.length > 0 ? root : undefined;
+}
+export function parseStatusHeader(header) {
+    const branchText = header.replace(/^##\s*/, "").trim();
+    if (branchText.startsWith("HEAD ")) {
+        return { branch: "detached", detached: true };
+    }
+    if (branchText.startsWith("No commits yet on ")) {
+        const branch = branchText.replace(/^No commits yet on\s*/, "").trim();
+        return { branch: branch || "-", detached: false };
+    }
+    if (branchText.includes("...")) {
+        const [branch = "-", upstreamText = ""] = branchText.split("...", 2);
+        const upstream = upstreamText.split(" [", 1)[0]?.trim();
+        const parsed = {
+            branch: branch.trim() || "-",
+            detached: false
+        };
+        if (upstream) {
+            parsed.upstream = upstream;
+        }
+        return parsed;
+    }
+    return {
+        branch: branchText.split(" [", 1)[0]?.trim() || "-",
+        detached: false
+    };
+}
+export async function inspectWorktree(repo, timeoutMs) {
+    const result = await runGit(repo.path, ["status", "--porcelain=v1", "--branch"], timeoutMs);
+    if (!ok(result)) {
+        return {
+            branch: "-",
+            detached: false,
+            dirty: false,
+            dirtyText: "",
+            error: firstLine(combinedOutput(result)) || "status failed"
+        };
+    }
+    const lines = result.stdout.split(/\r?\n/).filter((line) => line.trim().length > 0);
+    const header = lines[0];
+    if (!header?.startsWith("## ")) {
+        return {
+            branch: "-",
+            detached: false,
+            dirty: false,
+            dirtyText: "",
+            error: "unable to read status"
+        };
+    }
+    const parsed = parseStatusHeader(header);
+    const dirtyCount = lines.length - 1;
+    return {
+        ...parsed,
+        dirty: dirtyCount > 0,
+        dirtyText: dirtyCount > 0 ? `${dirtyCount} change${dirtyCount === 1 ? "" : "s"}` : ""
+    };
+}
+export async function localBranchExists(repo, branch, timeoutMs) {
+    const result = await runGit(repo.path, ["show-ref", "--verify", "--quiet", `refs/heads/${branch}`], timeoutMs);
+    return ok(result);
+}
+export async function remoteBranchExists(repo, remote, branch, timeoutMs) {
+    const result = await runGit(repo.path, ["show-ref", "--verify", "--quiet", `refs/remotes/${remote}/${branch}`], timeoutMs);
+    return ok(result);
+}
+export async function resolveDefaultBranch(repo, timeoutMs) {
+    const originHead = await runGit(repo.path, ["symbolic-ref", "--quiet", "--short", "refs/remotes/origin/HEAD"], timeoutMs);
+    if (ok(originHead)) {
+        const ref = originHead.stdout.trim();
+        if (ref.startsWith("origin/")) {
+            return ref.slice("origin/".length);
+        }
+    }
+    for (const branch of ["main", "master"]) {
+        if (await localBranchExists(repo, branch, timeoutMs)) {
+            return branch;
+        }
+        if (await remoteBranchExists(repo, "origin", branch, timeoutMs)) {
+            return branch;
+        }
+    }
+    return undefined;
+}
+export async function checkoutDefaultBranch(repo, targetBranch, timeoutMs) {
+    if (await localBranchExists(repo, targetBranch, timeoutMs)) {
+        return runGit(repo.path, ["checkout", targetBranch], timeoutMs);
+    }
+    if (await remoteBranchExists(repo, "origin", targetBranch, timeoutMs)) {
+        return runGit(repo.path, ["checkout", "-B", targetBranch, `origin/${targetBranch}`], timeoutMs);
+    }
+    return {
+        code: 1,
+        stdout: "",
+        stderr: `default branch not found: ${targetBranch}`,
+        timedOut: false
+    };
+}
+function branchNameFragment(value) {
+    const fragment = value.replace(/[^a-zA-Z0-9_.-]+/g, "-").replace(/^[-_.]+|[-_.]+$/g, "");
+    return (fragment || "worktree").slice(0, 48);
+}
+export async function uniqueBackupBranch(repo, sourceBranch, timeoutMs) {
+    const timestamp = new Date()
+        .toISOString()
+        .replace(/[-:]/g, "")
+        .replace(/\..+$/, "")
+        .replace("T", "-");
+    const base = `multipull-backup/${timestamp}-${branchNameFragment(sourceBranch)}`;
+    let candidate = base;
+    let suffix = 2;
+    while (await localBranchExists(repo, candidate, timeoutMs)) {
+        candidate = `${base}-${suffix}`;
+        suffix += 1;
+    }
+    return candidate;
+}
+export async function commitWorktreeToBackupBranch(repo, status, timeoutMs) {
+    const source = status.detached ? "detached" : status.branch;
+    const branch = await uniqueBackupBranch(repo, source, timeoutMs);
+    const outputs = [];
+    for (const args of [
+        ["checkout", "-b", branch],
+        ["add", "-A"],
+        ["commit", "--no-verify", "-m", `multipull backup before switching from ${source}`]
+    ]) {
+        const result = await runGit(repo.path, args, timeoutMs);
+        outputs.push(combinedOutput(result));
+        if (!ok(result)) {
+            return {
+                branch,
+                result: {
+                    ...result,
+                    stdout: outputs.filter(Boolean).join("\n")
+                }
+            };
+        }
+    }
+    return {
+        branch,
+        result: {
+            code: 0,
+            stdout: outputs.filter(Boolean).join("\n"),
+            stderr: "",
+            timedOut: false
+        }
+    };
+}
+export async function parkAndCheckoutDefaultBranch(repo, status, targetBranch, timeoutMs) {
+    const outputs = [];
+    let backupBranch;
+    if (status.dirty) {
+        const backup = await commitWorktreeToBackupBranch(repo, status, timeoutMs);
+        backupBranch = backup.branch;
+        outputs.push(combinedOutput(backup.result));
+        if (!ok(backup.result)) {
+            return {
+                backupBranch,
+                result: {
+                    ...backup.result,
+                    stdout: outputs.filter(Boolean).join("\n")
+                }
+            };
+        }
+    }
+    const checkout = await checkoutDefaultBranch(repo, targetBranch, timeoutMs);
+    outputs.push(combinedOutput(checkout));
+    const parkedResult = {
+        result: {
+            ...checkout,
+            stdout: outputs.filter(Boolean).join("\n")
+        }
+    };
+    if (backupBranch) {
+        parkedResult.backupBranch = backupBranch;
+    }
+    return parkedResult;
+}
+export async function classifyPullSuccess(repo, beforeHead, timeoutMs) {
+    const after = await runGit(repo.path, ["rev-parse", "HEAD"], timeoutMs);
+    if (ok(after) && after.stdout.trim() !== beforeHead) {
+        return "OK updated";
+    }
+    return "OK current";
+}
+export function repoName(repoPath) {
+    return basename(repoPath) || repoPath;
+}
+//# sourceMappingURL=git.js.map

package/dist/git.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,3 @@
+import type { Repo, RepoResult, RunOptions } from "./types.js";
+export declare function processRepo(repo: Repo, options: RunOptions): Promise<RepoResult>;
+export declare function runRepos(repos: Repo[], options?: Partial<RunOptions>): Promise<RepoResult[]>;

package/dist/runner.js

@@ -0,0 +1,171 @@
+import { DEFAULT_JOBS, DEFAULT_TIMEOUT_MS } from "./defaults.js";
+import { classifyPullSuccess, combinedOutput, firstLine, inspectWorktree, ok, parkAndCheckoutDefaultBranch, resolveDefaultBranch, runGit } from "./git.js";
+function pendingResult(repo) {
+    return {
+        repo,
+        branch: "-",
+        upstream: "-",
+        result: "PENDING",
+        category: "pending"
+    };
+}
+function failedResult(repo, error) {
+    return {
+        repo,
+        branch: "-",
+        upstream: "-",
+        result: "FAIL internal error",
+        category: "fail",
+        detail: error instanceof Error ? error.message : String(error)
+    };
+}
+export async function processRepo(repo, options) {
+    const result = pendingResult(repo);
+    let switchTarget = "";
+    let switchAction = "";
+    let switchOutput = "";
+    let status = await inspectWorktree(repo, options.timeoutMs);
+    result.branch = status.branch;
+    if (status.error) {
+        return {
+            ...result,
+            result: "FAIL status",
+            category: "fail",
+            detail: status.error
+        };
+    }
+    if (options.parkToDefaultBranch) {
+        const targetBranch = await resolveDefaultBranch(repo, options.timeoutMs);
+        if (!targetBranch) {
+            return {
+                ...result,
+                result: "FAIL default branch",
+                category: "fail",
+                detail: "no default branch found"
+            };
+        }
+        const shouldSwitch = status.detached || status.branch !== targetBranch;
+        if (shouldSwitch) {
+            switchTarget = targetBranch;
+            switchAction = status.dirty ? "parked" : "switched";
+            if (options.dryRun) {
+                return {
+                    ...result,
+                    result: `READY ${switchAction} -> ${switchTarget}`,
+                    category: "dry"
+                };
+            }
+            const switchResult = await parkAndCheckoutDefaultBranch(repo, status, targetBranch, options.timeoutMs);
+            switchOutput = combinedOutput(switchResult.result);
+            if (!ok(switchResult.result)) {
+                return {
+                    ...result,
+                    result: `FAIL ${switchAction} -> ${switchTarget}`,
+                    category: "fail",
+                    detail: firstLine(switchOutput) || "switch failed",
+                    output: switchOutput
+                };
+            }
+            status = await inspectWorktree(repo, options.timeoutMs);
+            result.branch = status.branch;
+            if (switchResult.backupBranch) {
+                result.detail = `backup branch: ${switchResult.backupBranch}`;
+            }
+            if (status.error) {
+                return {
+                    ...result,
+                    result: "FAIL status",
+                    category: "fail",
+                    detail: status.error,
+                    output: switchOutput
+                };
+            }
+        }
+    }
+    if (status.detached) {
+        return {
+            ...result,
+            result: "SKIP detached HEAD",
+            category: "skip"
+        };
+    }
+    if (status.dirty) {
+        return {
+            ...result,
+            result: `SKIP dirty (${status.dirtyText})`,
+            category: "skip"
+        };
+    }
+    if (!status.upstream) {
+        return {
+            ...result,
+            result: "SKIP no upstream",
+            category: "skip"
+        };
+    }
+    result.upstream = status.upstream;
+    if (options.dryRun) {
+        return {
+            ...result,
+            result: "READY pull",
+            category: "dry"
+        };
+    }
+    const before = await runGit(repo.path, ["rev-parse", "HEAD"], options.timeoutMs);
+    if (!ok(before)) {
+        const output = combinedOutput(before);
+        return {
+            ...result,
+            result: "FAIL read HEAD",
+            category: "fail",
+            detail: firstLine(output),
+            output
+        };
+    }
+    const pull = await runGit(repo.path, ["pull", "--ff-only", "--prune"], options.timeoutMs);
+    const pullOutput = [switchOutput, combinedOutput(pull)].filter(Boolean).join("\n");
+    if (!ok(pull)) {
+        return {
+            ...result,
+            result: "FAIL pull",
+            category: "fail",
+            detail: pull.timedOut ? `timed out after ${Math.round(options.timeoutMs / 1000)}s` : firstLine(combinedOutput(pull)),
+            output: pullOutput
+        };
+    }
+    const pullResult = await classifyPullSuccess(repo, before.stdout.trim(), options.timeoutMs);
+    return {
+        ...result,
+        result: switchTarget ? `${pullResult} (${switchAction} -> ${switchTarget})` : pullResult,
+        category: "ok",
+        output: pullOutput
+    };
+}
+export async function runRepos(repos, options = {}) {
+    const runOptions = {
+        dryRun: options.dryRun ?? false,
+        verbose: options.verbose ?? false,
+        parkToDefaultBranch: options.parkToDefaultBranch ?? false,
+        jobs: options.jobs ?? DEFAULT_JOBS,
+        timeoutMs: options.timeoutMs ?? DEFAULT_TIMEOUT_MS
+    };
+    const results = new Map();
+    const queue = [...repos];
+    async function worker() {
+        while (queue.length > 0) {
+            const repo = queue.shift();
+            if (!repo) {
+                continue;
+            }
+            try {
+                results.set(repo.path, await processRepo(repo, runOptions));
+            }
+            catch (error) {
+                results.set(repo.path, failedResult(repo, error));
+            }
+        }
+    }
+    await Promise.all(Array.from({ length: Math.min(runOptions.jobs, repos.length) }, () => worker()));
+    return repos.map((repo) => results.get(repo.path) ?? failedResult(repo, "missing result"));
+}
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

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

package/dist/table.d.ts

@@ -0,0 +1,2 @@
+import type { RepoResult } from "./types.js";
+export declare function renderTable(results: RepoResult[]): string;

package/dist/table.js

@@ -0,0 +1,36 @@
+function fit(text, width) {
+    if (text.length <= width) {
+        return text.padEnd(width, " ");
+    }
+    if (width <= 3) {
+        return text.slice(0, width);
+    }
+    return `${text.slice(0, width - 3)}...`;
+}
+function widths(results) {
+    const rows = [
+        ["Repo", "Branch", "Upstream", "Result"],
+        ...results.map((item) => [item.repo.label, item.branch, item.upstream, item.result])
+    ];
+    const maxes = [0, 1, 2, 3].map((index) => Math.max(...rows.map((row) => row[index]?.length ?? 0)));
+    const branch = Math.min(Math.max(maxes[1] ?? 8, 8), 20);
+    const upstream = Math.min(Math.max(maxes[2] ?? 12, 12), 28);
+    const result = Math.min(Math.max(maxes[3] ?? 16, 16), 40);
+    const terminal = process.stdout.columns ?? 120;
+    const repo = Math.max(16, Math.min(maxes[0] ?? 16, terminal - branch - upstream - result - 6));
+    return [repo, branch, upstream, result];
+}
+export function renderTable(results) {
+    const headers = ["Repo", "Branch", "Upstream", "Result"];
+    const columnWidths = widths(results);
+    const lines = [
+        headers.map((header, index) => fit(header, columnWidths[index] ?? header.length)).join("  "),
+        columnWidths.map((width) => "-".repeat(width)).join("  ")
+    ];
+    for (const item of results) {
+        const row = [item.repo.label, item.branch, item.upstream, item.result];
+        lines.push(row.map((cell, index) => fit(cell, columnWidths[index] ?? cell.length)).join("  "));
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=table.js.map

package/dist/table.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,38 @@
+export type ResultCategory = "ok" | "skip" | "fail" | "dry" | "pending" | "running";
+export interface Repo {
+    path: string;
+    label: string;
+}
+export interface GitCommandResult {
+    code: number;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+}
+export interface WorktreeStatus {
+    branch: string;
+    upstream?: string;
+    detached: boolean;
+    dirty: boolean;
+    dirtyText: string;
+    error?: string;
+}
+export interface RepoResult {
+    repo: Repo;
+    branch: string;
+    upstream: string;
+    result: string;
+    category: ResultCategory;
+    detail?: string;
+    output?: string;
+}
+export interface RunOptions {
+    dryRun: boolean;
+    verbose: boolean;
+    parkToDefaultBranch: boolean;
+    jobs: number;
+    timeoutMs: number;
+}
+export interface DiscoverOptions {
+    maxDepth: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@huhuhang/multipull",
+  "version": "0.1.0",
+  "description": "Pull many Git repositories safely from one CLI.",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/huhuhang/multipull.git"
+  },
+  "bugs": {
+    "url": "https://github.com/huhuhang/multipull/issues"
+  },
+  "homepage": "https://github.com/huhuhang/multipull#readme",
+  "bin": {
+    "multipull": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/cli.ts",
+    "test": "vitest run",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "check": "npm run typecheck && npm run test && npm run build",
+    "prepack": "npm run build"
+  },
+  "keywords": [
+    "git",
+    "pull",
+    "cli",
+    "monorepo",
+    "repositories"
+  ],
+  "author": "huhuhang",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "commander": "^14.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "tsx": "^4.20.0",
+    "typescript": "^5.8.0",
+    "vitest": "^4.1.9"
+  }
+}