cat-fetch 0.1.1

MusKitty multi-repo source management CLI — one command to clone, build, test, push, and publish 8 independent crate repositories
cat-fetch-0.1.1 is not a library.

cat_fetch — MusKitty Multi-Repo Management Tool

One command to manage all 8 MusKitty repositories: clone, build, test, push, publish, and scaffold new crates.

Quick Start

# 1. Load credentials (one-time per shell session)
cd D:\cat_fetch
. .\env.ps1

# 2. See what's going on
cat status MusKitty

# 3. Clone everything
cat clone MusKitty

# 4. Build everything in topological order
cat build MusKitty

# 5. Run all tests
cat test MusKitty

# 6. Push all repos (with confirmation)
cat push MusKitty

# 7. Publish all crates to crates.io
cat publish MusKitty

# 8. Scaffold a new crate
cat new MusKitty css-values --deps muskitty-css-tokenizer

Or use the convenience launcher (auto-loads tokens):

.\cat.ps1 status MusKitty
.\cat.ps1 build MusKitty --release

Commands

Command Description
cat clone <project> Clone all repos from GitHub
cat pull <project> Fast-forward pull all repos
cat setup <project> Clone + verify deps + pull (one-shot dev setup)
cat build <project> Topological build (cargo check by default, --release for build)
cat test <project> Run lib + integration tests, summary table
cat push <project> Push all repos with confirmation (--all to skip)
cat status <project> Git status overview (branch, dirty, ahead/behind)
cat publish <project> Publish to crates.io in dependency order (--dry-run to preview)
cat wpt <project> WPT semantic comparison info
cat new <project> <name> Scaffold new crate (Cargo.toml, CI, LICENSE, scripts)

Architecture

D:\cat_fetch\
├── repos.toml      ← Single source of truth: all repos + dependency graph
├── env.ps1         ← Reads tokens from Windows Credential Manager
├── cat.ps1          ← Convenience launcher (auto-loads tokens)
└── src/             ← Rust CLI (binary: cat.exe)

Token Management

env.ps1 reads 3 tokens from Windows Credential Manager via C# P/Invoke (advapi32.dll!CredReadW):

Env Var Credential Target Purpose
CRATES_GIT_TOKEN git:https://github.com 7 muskitty-dev/* crate repos
MAIN_GIT_TOKEN gh:github.com:Ink-dark Ink-dark/MusKitty main repo
CARGO_REGISTRY_TOKEN ~/.cargo/credentials.toml crates.io publishing

Tokens are never written to disk — they exist only as environment variables for the current process.

Dependency Topology

Topological levels are computed automatically from repos.toml deps fields (Kahn's algorithm):

Level 0:  muskitty-dom, muskitty-css-tokenizer, muskitty-html5-tokenizer
Level 1:  muskitty-css-parser, muskitty-html5-parser
Level 2:  muskitty-css
Level 3:  muskitty-selectors

Within each level, crates can be built/tested in parallel.

Build from Source

cd D:\cat_fetch
cargo build --release
# Binary: target\release\cat.exe

License

Apache-2.0