gitpic AGENTS.md

Repository Guidelines

Project Structure & Module Organization

gitpic is a Rust CLI. Source lives in src/:

• main.rs — entry point, subcommand dispatch, exit codes.
• cli.rs — clap argument/subcommand definitions.
• config.rs — config model + XDG path resolution (~/.config/gitpic/config.toml).
• auth.rs — the credential: reads/writes the 0600 auth.toml that gitpic auth login produces, and is the only source there is. No secret is held in Config.
• oauth.rs — GitHub device flow: the wire protocol behind gitpic auth login.
• github.rs — GitHub Contents API client (upload, dedup, health checks).
• naming.rs, link.rs, imageproc.rs, output.rs, error.rs — path/hash, URL/markdown, compression, human/JSON output, error types.
• history.rs — the upload log the app's 历史 pane reads.
• release.rs — the update check behind gitpic update check, and the tap lookup behind gitpic update cask: version parsing and comparison, the releases/latest fetch, the release's assets (name, size, download URL, GitHub's digest) that the app installs an update from, and a Contents-API read of the tap's Casks/gitpic.rb answering what brew upgrade --cask gitpic would install. Both origins are compile-time constants on purpose, pinned by a test — their text is rendered inside GitPic's own window, so nothing configurable may choose them, and download URLs come from the API rather than a template for the same reason.
• install_source.rs — which of the five ways this binary was installed (cask app, hand-installed app, gitpic_cli formula, cargo install, or unknown), so gitpic update prints the one upgrade command that install actually wants instead of two to choose between. Canonicalises current_exe() first: the cask links bin/gitpic into the app bundle, and on Apple platforms the un-canonicalised path is the symlink, which classifies the commonest install of all as neither an app nor a formula. Distinct from GitPicCore's CaskOwnership, which asks whether the bundle is cask-managed rather than where this binary came from.
• testutil.rs — #[cfg(test)] only: the loopback stub server, a canned response, and the request reader shared by github's and release's tests. One sock.read is not a whole request; the module says what that cost twice.
• commands/ — one module per action (upload, auth_cmd, repos, branches, doctor, list, config_cmd, completion, skill, update).