Skip to content

fleet-git.md

Latest commit

 

History

History
144 lines (103 loc) · 4.23 KB

fleet-git.md

File metadata and controls

144 lines (103 loc) · 4.23 KB
Raw

Fleet git commands

Run everyday git operations across every OpenLyceum repo checked out locally — the sibling clones that live beside Baton in the workspace (pull all, push all, status all, …).

The short version

scripts/fleet runs any git command across every local catalog checkout:

fleet push
fleet pull --ff-only
fleet status -s
fleet --simulation log -1 --oneline

Put it on your PATH once (symlink is enough if ~/.local/bin is already there):

ln -sfn ~/OpenLyceum/Baton/scripts/fleet ~/.local/bin/fleet

Or call it as Baton/scripts/fleet … / scripts/fleet … from the Baton directory.

These operate on your local working trees. Two related tools cover different jobs:

You want to… Use
Update / clone every catalog repo into the workspace scripts/clone-fleet.sh --update
Make the same change everywhere and open one PR per repo scripts/fleet-exec.sh (see fleet-auth.md)
Run an ad-hoc git command across your local checkouts scripts/fleet (below)

Filters

Same catalog filters as the rest of the tooling:

fleet --simulation status -s          # simulations only
fleet --lineage naap status -s        # NAAP ports only
fleet --type tool branch -vv          # tools only
fleet --no-simulation fetch --all     # everything that isn't a sim

Without a filter the list includes Baton and .github too. Add --simulation if you want to skip them.

Common operations

Status of all repos:

fleet status -s

Branch + dirty-count overview — quick "where is everything" snapshot (custom format, so use the building-block loop):

scripts/parse-repos.sh paths --require-local | while read -r p; do
  printf '%-24s %-28s %s dirty\n' "$(basename "$p")" \
    "$(git -C "$p" rev-parse --abbrev-ref HEAD)" \
    "$(git -C "$p" status --porcelain | wc -l)"
done

Pull all — prefer clone-fleet.sh --update: it fast-forwards every existing repo and clones any catalog repo you're missing, in one pass:

scripts/clone-fleet.sh --update

Or, to pull only what's already on disk (no new clones):

fleet pull --ff-only

Fetch all (update remotes without touching working trees):

fleet fetch --all --prune

Push all — pushes the current branch of each repo. Pushing writes to remotes, so review with fleet status -s first. git push is a no-op for repos with nothing to push:

fleet push

For a brand-new local branch, set the upstream the first time:

fleet push -u origin HEAD

Create the same branch everywhere:

fleet checkout -b chore/my-change

Last commit per repo:

fleet log -1 --oneline

The building block

parse-repos.sh paths --require-local prints the on-disk path of every catalog repo that actually exists in your workspace. scripts/fleet is a thin wrapper around that; use the loop directly when you need something that isn't a plain git invocation:

scripts/parse-repos.sh paths --require-local | while read -r p; do
  printf '%-24s %-28s %s dirty\n' "$(basename "$p")" \
    "$(git -C "$p" rev-parse --abbrev-ref HEAD)" \
    "$(git -C "$p" status --porcelain | wc -l)"
done

Notes

  • Read-only first. status, fetch, and log change nothing — run them freely. pull, push, and checkout change state; eyeball a status overview before a bulk push.
  • pull --ff-only refuses to create merge commits, so a repo with diverged local work fails loudly instead of silently merging. Resolve those repos by hand.
  • Non-zero exit if any repo fails. fleet keeps going after a failure, then exits 1 if any repo's git command failed — scan the output for which ones.
  • Workspace location. Scripts assume Baton sits beside the member repos. If your checkout differs, set FLEET_WORKSPACE or pass --catalog /path/to/repos.json.
  • For non-git fan-out (lint, build, dependency bumps) that should land as PRs, use fleet-exec.sh instead — it works on fresh clones, not your local trees.