SBPro
b28662d3b4
Breaking change. The monorepo's gitea host was previously inferred from the first target's subrepo_url, silently coupling the two and breaking on any multi-host setup (monorepo on host A, target on host B). v2.0.0 replaces the inference with a required josh.monorepo_url field that mirrors subrepo_url — same parsing, same SSH/HTTPS auth options, same shape. - schema_version: 2 is now required; v1 configs are rejected with a clear migration error - josh.monorepo_url is required; josh.monorepo_auth is optional (default https) - mono_auth_url() in lib/auth.sh mirrors subrepo_auth_url() - MONOREPO_API derives from monorepo_url's host instead of .[0].gitea_host; env-var override preserved as escape hatch - initial_import() and force-push call mono_auth_url() instead of building URLs inline - ADR-012 documents the rationale; CHANGELOG includes migration snippet Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Architecture Decision Records
This directory contains Architecture Decision Records (ADRs) for josh-sync. Each ADR documents a significant design decision, its context, the alternatives considered, and the rationale for the chosen approach.
Index
| ADR | Title | Status |
|---|---|---|
| 001 | Josh-proxy for bidirectional sync | Accepted |
| 002 | State storage on orphan git branch | Accepted |
| 003 | Force-with-lease for forward sync | Accepted |
| 004 | Always-PR policy for reverse sync | Accepted |
| 005 | Git trailer for loop prevention | Accepted |
| 006 | Inline exclude in josh-proxy URL | Accepted |
| 007 | Reconciliation merge for filter changes | Accepted |
| 008 | First-parent ordering in reconciliation merges | Accepted |
| 009 | Tree comparison as sync skip guard | Accepted |
| 010 | Onboard workflow with checkpoint/resume | Accepted |
| 011 | Linearize fallback for reverse sync | Accepted |
| 012 | Explicit monorepo_url (drop first-target-host inference) |
Accepted |