ace-git 0.31.0 → 0.32.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 83d5b624eab98d754e4bb770fdd1a80e00237d063bc07ba2b412e31cf0b4fa87
-  data.tar.gz: 1e8a556aedb3f9ba844ebe46a7b3c64adea58b979842bf6df7835742057c20c1
+  metadata.gz: 93ab21fbc075387d07fecb5c99fa35e9b3fca1134828578fd9d23fff9a8fdc65
+  data.tar.gz: da9b32ec8ac46c10e9c1f7e648c26ba21003f04603b80a41b15cfa3705e52da4
 SHA512:
-  metadata.gz: 8c33109eb792dea197dc9e29a9f63839ed10d53c95aa7e1817d22cbbe2cbecc51123f8fe90ad420a2e908b35a6aa1bbaef35612340bcd667ad21b5736dbdad49
-  data.tar.gz: a2b337d9084ff29b01cd0834e2e9e9a3ef36299d0c0704bdad61480d844cd1a0165f1d4b9c482c5acf0feb29d0dc6aaa715e992dca1e2fa50d6abeb736e234f7
+  metadata.gz: 2f89ac9e97703d6f9fd2b7d65b58a14ee4e444cb7e67981a860927e11de387ce7600fa4bfe4e724978b9a29252f1b2ec67848eb76977e95e18ba3f1e84caa26a
+  data.tar.gz: aefa646c548c7fd820e539367cbbbc79569d71b44b484e7482c0ca3ef89249172bc1fdb89338f6c3e155026236d78d785e64521d478fe8bd354a44f5f780dae6

data/CHANGELOG.md

@@ -5,7 +5,16 @@ All notable changes to ace-git will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [Unreleased]
+## [0.32.0] - 2026-10-30
+
+### Added
+
+- `wfi://git/mirror-sync` (task 8xs.t.pu0.d): the repeatable host
+  mirror-sync operation — explicit source/target/ref, both full SHAs read
+  before acting, identity no-op, fast-forward only (`--force-with-lease`
+  with the read SHA), divergence escalated for reviewed reconciliation
+  (never reset/force/ref deletion), reversed-direction detection in the
+  plan, and a mutation-free dry-run.
 
 ## [0.31.0] - 2026-10-23
 

data/handbook/workflow-instructions/git/mirror-sync.wf.md

@@ -0,0 +1,84 @@
+---
+name: git-mirror-sync
+description: Repeatable host mirror-sync operation — explicit source/target/ref, both full SHAs read before acting, identity no-op, fast-forward only, divergence escalated for reviewed reconciliation
+allowed-tools: Bash, Read
+doc-type: workflow
+title: Host Mirror Sync Workflow
+purpose: Bind the host operator's forge-mirror sync as a repeatable, evidenced operation: never destructive, always checkable, with the actual source and target SHAs in the result.
+ace-docs:
+  last-updated: '2026-10-30'
+  last-checked: '2026-10-30'
+---
+# Host Mirror Sync Workflow
+
+## Goal
+
+Synchronize an explicitly named target ref from an explicitly named source
+ref (task 8xs.t.pu0.d — for this family: source `fg` Forgejo `cs3b/ace`,
+target `origin` GitHub `cs3b/ace`) as a REPEATABLE host operation with a
+checkable result. This is an ordinary Git workflow — no new script, no
+hardcoded lab topology, no tool change; if a capability is missing it
+belongs in ace-git's adapters.
+
+## Instructions
+
+Run the loaded workflow as the source of truth and execute it end-to-end
+instead of only summarizing it.
+
+### 1) Name the operation and read BOTH full SHAs first
+
+Before ANY action, read and record the full SHAs of the exact source and
+target refs. An operation without both SHAs is not runnable:
+
+```bash
+git ls-remote fg refs/heads/main     # source SHA (record it)
+git ls-remote origin refs/heads/main # target SHA (record it)
+```
+
+### 2) Classify
+
+- **Identity** (source SHA == target SHA): the sync is a NO-OP. Report both
+  SHAs and the result `identity`; do not touch anything.
+- **Fast-forward** (target SHA is an ancestor of source): proceed.
+- **Divergence** (neither of the above): STOP. Divergence needs its own
+  reviewed reconciliation decision — NEVER resolve it here with a reset,
+  force push, or ref deletion. Report both SHAs and the divergence; a
+  historical SHA (e.g. a recorded closeout base like `af68f8fc1…`) is INPUT
+  EVIDENCE for the review, never a SHA to impose unconditionally on the
+  live target.
+- **Reversed direction** (the plan shows the target ahead of the source):
+  report it explicitly — a dry-run that names source and target swapped is
+  a caught error, not a sync.
+
+### 3) Execute (fast-forward only)
+
+```bash
+git fetch fg main
+git push origin <source-SHA>:refs/heads/main --force-with-lease=refs/heads/main:<target-SHA>
+```
+
+`--force-with-lease` with the READ target SHA is the guard: if anything
+moved the target between the read and the push, the push is REFUSED — the
+operation restarts from step 1. Plain `--force` is forbidden.
+
+### 4) Verify and report
+
+Re-read the target SHA; the result names the ref, the before/after SHAs of
+BOTH sides, and the verification (`git ls-remote origin` equals the source
+SHA). Repetition after success reports `identity` — the repeatable
+operation is idempotent at the evidence level.
+
+### 5) Dry-run
+
+The same classification with no mutation: report source/target/ref, both
+  SHAs, the planned action (no-op / fast-forward / divergence-blocked /
+  reversed), and NOTHING else changed.
+
+## Boundaries
+
+- Never delete refs, never reset, never `--force` without a lease.
+- Salvage branches, open HITL cases, and active resources on either side
+  are untouched by a mirror sync; an active resource conflicting with the
+  plan is reported as preserved with its reason.
+- Closing a single Herdr pane remains a separate follow-up — never close a
+  whole tab as a substitute.

data/lib/ace/git/version.rb

@@ -2,6 +2,6 @@
 
 module Ace
   module Git
-    VERSION = "0.31.0"
+    VERSION = "0.32.0"
   end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ace-git
 version: !ruby/object:Gem::Version
-  version: 0.31.0
+  version: 0.32.0
 platform: ruby
 authors:
 - Michal Czyz
 bindir: exe
 cert_chain: []
-date: 2026-10-23 00:00:00.000000000 Z
+date: 2026-10-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ace-support-config
@@ -133,6 +133,7 @@ files:
 - handbook/templates/pr/bugfix.template.md
 - handbook/templates/pr/default.template.md
 - handbook/templates/pr/feature.template.md
+- handbook/workflow-instructions/git/mirror-sync.wf.md
 - handbook/workflow-instructions/git/pr/create.wf.md
 - handbook/workflow-instructions/git/pr/update.wf.md
 - handbook/workflow-instructions/git/rebase.wf.md