Refactor repository automation into project_setup

[v-Kaefer]

Linked Issue

• Closes TASK | Refactor repository automation into project_setup #2

Milestone

• M0

Summary

• Rename the reusable package, CLI, configuration, workflows, tests, and canonical documentation to project_setup.
• Provide a cross-platform Makefile and Python CLI for repository installation, discovery, diagnostics, dry-run planning, and explicit live application.
• Detect Windows through OS=Windows_NT, select python by default, and remove the dependency on the Unix test command.
• Make dry-run the default for every mutating CLI path; require --live, the compatibility alias --no-dry-run, or LIVE=1 before writes.
• Report the GitHub CLI installation and gh auth state separately from environment-token authentication, without exposing credentials.
• Require PROJECT_SETUP_PAT specifically for live GitHub Projects v2 operations while keeping github.token for repository-scoped Actions operations.
• Harden GitHub requests with a finite timeout, an API-host allowlist, and automatic retries limited to idempotent reads.
• Remove the framework-specific Godot profile from the generic tool surface.
• Address the CodeRabbit review findings for installer side effects, conflicting labels, malformed manifests, milestone pre-validation, PR placeholders, script discovery, documentation alignment, and workflow templates.

How to test

• Run make check.
• Run make doctor and verify OS, Python, token source, and gh auth diagnostics.
• Run make discover TARGET=/path/to/project REPO=owner/repository and confirm the recommended command remains a dry-run.
• Run make init-dry TARGET=/tmp/example-project and confirm the target directory is not created.
• Run each module without LIVE=1 and confirm it only previews changes.
• Run project sync without PROJECT_SETUP_PAT and confirm it produces an offline preview rather than querying Project v2.

Evidence

• The real happy-path test created Project v2 Refactor repository automation into project_setup #6, issue US-00 | Configure repository automation #7, and tasks T-00.1 | Customize labels and milestones #8–T-00.2 | Review workflows and branch policy #9; the report is recorded in TESTE_REAL_RELATORIO.md.
• A disposable checkout reconstructed from the current branch files completed the full make check flow successfully: repository quality, Python compilation, and 26 unit tests.
• The tests cover Windows-safe execution defaults, dry-run behavior, invalid gh auth, PAT guidance, installer dry-run side effects, Project v2 offline preview, conflicting PR labels, malformed milestones, inline URLs in PR sections, request timeout, URL restriction, and non-retry of mutation transport failures.
• All 14 inline CodeRabbit review threads are currently marked resolved.

Known risks and intentional limits

• Issue generation is intentionally opt-in and is not idempotent; existing issues must be reviewed before repeating it.
• Project v2 views remain a manual configuration step.
• Milestone synchronization intentionally inspects at most the first 100 existing milestones.
• The current distribution model embeds the package in each target repository rather than consuming a published PyPI release.
• The local sandbox network restriction recorded in the real-test report was an environment limitation, not a Makefile defect.
• GitHub Actions has not started a workflow run for the latest branch commit, so hosted CI evidence is still pending.

DoD checklist

• Scope implemented as defined
• Legacy namespace removed
• Cross-platform Makefile and installer added
• Dry-run standardized and live execution made explicit
• GitHub and gh auth diagnostics improved
• GitHub request safety hardened
• Framework-specific Godot profile removed
• CodeRabbit inline findings addressed or intentionally bounded
• Reconstructed branch completed make check with 26 tests
• GitHub Actions execution enabled and hosted make check passed
• Final user review completed