[megamen32]

Goal

Make the tool understandable without reading documentation first.

Changes

• reduces each main README from ~260 lines to 72
• quick start is only pip install git-private2public + git-private2public
• presents three beginner actions: check, publish, diagnose
• moves regex, allowlists, CI JSON, hooks, tags, YAML and implementation details to Advanced docs
• simplifies top-level CLI help and labels hook/guard as advanced
• makes interactive init detect the private origin and ask only for the public target
• keeps deterministic template behavior in non-interactive/CI sessions
• corrects stale Advanced documentation about built-in scans and hook chaining

Validation

• 61 tests pass
• warnings treated as errors
• python -m py_compile passes
• git diff --check passes
• interactive and non-interactive init flows tested
• real pseudo-terminal init verified against a Git repo with an origin remote