ace-git 0.30.0 → 0.30.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: ecccf931f808308fde6ab00654e43fdcbe7b90e0f0c929ade43a25a427302756
4
- data.tar.gz: 03af540433b453863a3d399a67565724c68288c0a4a2b283462f613293a4a6a0
3
+ metadata.gz: c03430c6a212d4bb6c51a3cb4bbf8f884051fe37b55581f9ea3d5d14048c83fa
4
+ data.tar.gz: e4da9c0fc2ae249ff7459973be3bfa42679395a68cb184e49446ea049aa5074f
5
5
  SHA512:
6
- metadata.gz: c999f3855347dda4bfac0ce490ec94666f1e9e2cf00b2907d0ad72fa5c083e00495e0f4296036770d106bb1decddca02a37b495e71d87552344899a4321cba08
7
- data.tar.gz: 0decf0ad84220579f16b3606d9c6ee3d6193e0a4dfbee22474cd4ee8008b5a75c6fc4bfc9f77bb8d27ae14fbdf65a3c95c957644ac318e08caffe03f7d0e768c
6
+ metadata.gz: 60ade30b905d89e860b44636d5520f7b5365612cbf4182692c3c06ca73a157b0d5811b4a3a8710a6b382180276ec4c8d488c4a156833af455d4baebcfd8a7797
7
+ data.tar.gz: e3dbbf14e495ac5bc6389079dd62d4c04a19f59ef4bc7d8d4a04507a63af5e52bc4ed734cadea17d6824d1cde353002bd4717bc9b4270282a670d42b72340983
data/CHANGELOG.md CHANGED
@@ -7,6 +7,18 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
7
7
 
8
8
  ## [Unreleased]
9
9
 
10
+ ## [0.30.1] - 2026-10-17
11
+
12
+ ### Changed
13
+
14
+ - Document the ordinary local PR create/update/ready path; remove the protected worker boundary and `ace-lab service request/status` requirements from the git PR workflows and guide.
15
+ - Document explicit remote read/compare reconciliation for an interrupted PR update instead of claiming the command compares and accepts the remote description; an interrupted create adopts one exact-head draft but does not compare or rewrite remote title/body.
16
+ - Drop the `attempt-bound`/`execution-attempt` wording from the `as-git-pr-create` and `as-git-pr-update` skills; they wrap the same forge-neutral PR workflows.
17
+
18
+ ### Removed
19
+
20
+ - Remove the protected merge boundary feature test and its fixture, which exercised the removed protected authority model.
21
+
10
22
  ## [0.30.0] - 2026-10-08
11
23
 
12
24
  ### Added
data/docs/handbook.md CHANGED
@@ -9,6 +9,11 @@ ace-docs:
9
9
 
10
10
  # ace-git Handbook Catalog
11
11
 
12
+ > **Planned (L5.5):** role rules, independent review rounds, and the
13
+ > attempt-bound forge delivery workflow are not available yet. The PR
14
+ > create/update skills below are projections of that planned workflow; the
15
+ > ordinary `ace-git pr` CLI commands remain the supported local path.
16
+
12
17
  Reference for package-owned handbook resources in `ace-git/handbook/`.
13
18
 
14
19
  ## Skills
data/docs/usage.md CHANGED
@@ -86,6 +86,7 @@ ace-git diff --raw
86
86
  ```
87
87
 
88
88
  **Options:**
89
+
89
90
  - `--format, -f` - Output format: `diff` (default), `summary`, `grouped-stats`
90
91
  - `--since, -s` - Changes since date/duration (e.g., "7d", "1 week ago")
91
92
  - `--paths, -p` - Include only these glob patterns
@@ -118,12 +119,14 @@ ace-git status --with-diff
118
119
  ```
119
120
 
120
121
  **Options:**
122
+
121
123
  - `--format, -f` - Output format: `markdown` (default), `json`
122
124
  - `--no-pr, -n` - Skip PR metadata and activity lookups (faster)
123
125
  - `--commits N` - Number of recent commits to show (default: 3 from config)
124
126
  - `--with-diff` - Include PR diff in output
125
127
 
126
128
  **Output includes:**
129
+
127
130
  - Current branch name with git status -sb output
128
131
  - Remote tracking status (ahead/behind)
129
132
  - Detected task pattern (from branch name)
@@ -153,6 +156,7 @@ ace-git branch --format json
153
156
  ```
154
157
 
155
158
  **Options:**
159
+
156
160
  - `--format, -f` - Output format: `text` (default), `json`
157
161
 
158
162
  ### `ace-git pr`
@@ -191,16 +195,24 @@ ace-git pr merge 25 --expected-head SHA --method squash
191
195
  ```
192
196
 
193
197
  **Behavior guarantees:**
198
+
194
199
  - Create is idempotent: one exact open base/head match returns the existing
200
+
195
201
  PR (`idempotency: existing`); multiple matches are a conflict.
202
+
196
203
  - `merge` requires the provider to enforce `--expected-head` atomically;
204
+
197
205
  providers without that capability return an unsupported-capability failure
198
206
  instead of racing.
207
+
199
208
  - A create request whose outcome is unknown (transport failure after send)
209
+
200
210
  reports an unknown outcome with the exact identity to reconcile; it never
201
211
  retries automatically.
212
+
202
213
  - With `--format json`, a failed operation prints the classified error as
203
- JSON on stdout (`{"error": {"category": ..., "message": ...}}` — e.g.
214
+
215
+ JSON on stdout (`{"error": {"category": ..., "message": ...}}` -- e.g.
204
216
  `expected_head_conflict`, `unsupported_capability`, `unknown_outcome`)
205
217
  before the nonzero exit; text mode explains the same failure on stderr.
206
218
 
@@ -256,9 +268,10 @@ diff:
256
268
  | `grouped_stats.layers` | Array | `["lib","test","handbook"]` | Preferred layer grouping order |
257
269
  | `grouped_stats.collapse_above` | Integer | `5` | Collapse markdown groups above this file count |
258
270
  | `grouped_stats.show_full_tree` | String | `collapsible` | Tree rendering strategy hint |
259
- | `grouped_stats.dotfile_groups` | Array | `[".ace-task",".ace"]` | Dot-directories to prioritize in grouping |
271
+ | `grouped_stats.dotfile_groups` | Array | `[".ace-tasks",".ace"]` | Dot-directories to prioritize in grouping |
260
272
 
261
273
  **Default exclude_patterns** (from `.ace-defaults/git/config.yml`):
274
+
262
275
  - Lock files: `**/*.lock`, `package-lock.json`, `yarn.lock`, `Gemfile.lock`
263
276
  - Vendored deps: `vendor/**/*`, `node_modules/**/*`
264
277
  - Build artifacts: `coverage/**/*`, `dist/**/*`, `build/**/*`, `.cache/**/*`
@@ -289,30 +302,24 @@ Note: `test/**/*` and `spec/**/*` are NOT excluded by default - test changes are
289
302
 
290
303
  ## Provider Packages
291
304
 
292
- `ace-git service create`, `service update`, `service ready` and `service merge`
293
- are fixed protected receiver handlers. It accepts no
294
- options; the receiver supplies its claimed JSON envelope on stdin and its
295
- private materialized candidate directory as the working directory. The handler
296
- checks the exact input digest, executor, candidate and forge provenance, calls
297
- the selected neutral operation once, and emits the existing bounded evidence
298
- response only after verifying the exact PR outcome (and merge commit for merge). An unverified or lost
299
- outcome emits no success and never retries. This command does not authorize a
300
- operation or replace the protected worker's canonical receipt acceptance.
301
- Create/update use an exact `{target,delivery,title,body}` input and remain draft;
302
- ready uses `{target,delivery}`, merge uses `{target,delivery,method}`. Create targets
303
- the base repository; all other operations target the exact PR URL. The original
304
- title remains part of the accepted input; the provider owns its draft encoding
305
- (Forgejo's WIP prefix). Updating a draft preserves that encoding. Each handler
306
- publishes the fixed `pr-result.txt` evidence only after its observed content,
307
- identity, head and draft/merge outcome agree.
305
+ > **Planned (L5.5):** the forge-neutral worker/integrator role rules and the
306
+ > attempt-bound PR delivery workflow are not available yet. The old protected
307
+ > `service create|update|ready|merge` receiver handlers are not part of the
308
+ > file-based flow and are not a requirement for opening or reviewing a PR.
309
+ >
310
+ > Use the ordinary `ace-git pr` commands documented above for now; they create
311
+ > or reconcile a PR for the pushed branch.
308
312
 
309
313
  `ace-git` is forge-neutral. It defines the server registry (`Ace::Git::ServerRegistry`),
310
314
  the provider contract (`Ace::Git::Providers::Base`), and normalized evidence types;
311
315
  provider packages own all forge CLI behavior:
312
316
 
313
317
  - **ace-git-github** - GitHub behavior via the `gh` CLI (PR lookups, diffs, issue
318
+
314
319
  tracking operations). Registers under the `github` provider type.
320
+
315
321
  - **ace-git-forgejo** - Forgejo behavior via the `fj` CLI. Registers under the
322
+
316
323
  `forgejo` provider type.
317
324
 
318
325
  Both providers implement the same issue-tracking contract (issue lookup, comment
@@ -21,7 +21,7 @@ This project uses a **mono-repo architecture** with all packages at the reposito
21
21
 
22
22
  - **ace-*/**: Ruby gems for specific functionality (ace-git, ace-task, ace-docs, etc.)
23
23
  - **docs/**: Project documentation and architecture decisions
24
- - **.ace-task/**: Task management and release coordination
24
+ - **.ace-tasks/**: Task management and release coordination
25
25
  - **_legacy/**: Archived content from previous multi-repo structure
26
26
 
27
27
  #### Common Git Commands
@@ -183,18 +183,19 @@ git remote prune origin
183
183
  git push -u origin feature/your-feature
184
184
  ```
185
185
 
186
- 2. **Create an attempt-bound draft on the selected forge**:
186
+ 2. **Create a draft on the selected forge**:
187
187
 
188
188
  ```bash
189
189
  ace-bundle wfi://git/pr/create
190
190
  ```
191
191
 
192
- Use the managed assignment and active delivery attempt with explicit
193
- fork/canonical repository and ref provenance. The canonical operation is
194
- `ace-assign delivery --assignment ID --attempt ATTEMPT --operation create --title TITLE --body-file DESCRIPTION`.
192
+ Use the actual assignment and active attempt when the work belongs to an
193
+ assignment, with explicit fork/canonical repository and ref provenance. The
194
+ forge command is
195
+ `ace-git pr create --server NAME --head HEAD-REF --base BASE-REF --expected-head CANDIDATE-SHA --title TITLE --body-file DESCRIPTION --format json`.
195
196
  Preserve the resolved forge and exact candidate SHA. Continue through
196
- `wfi://git/pr/update` only with accepted current test and independent review
197
- receipts; CI status remains advisory. Inside ACE use source `bin/ace-*`.
197
+ `wfi://git/pr/update` only with current exact-head test and independent review
198
+ evidence; CI status remains advisory. Inside ACE use source `bin/ace-*`.
198
199
 
199
200
  3. **Link to relevant issues/tasks**:
200
201
 
@@ -225,8 +226,8 @@ git push --force-with-lease origin feature/your-feature
225
226
 
226
227
  #### Fork-Based Workflow
227
228
 
228
- Provider-specific GitHub clone example for external contributors; canonical
229
- assignment delivery above uses the explicitly selected forge and provenance:
229
+ Provider-specific GitHub clone example for external contributors; the neutral
230
+ draft/update flow above uses the explicitly selected forge and provenance:
230
231
 
231
232
  ```bash
232
233
  # Fork repository on GitHub, then:
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: as-git-pr-create
3
- description: Create an attempt-bound forge-neutral pull request
3
+ description: Create a forge-neutral pull request
4
4
  user-invocable: true
5
5
  source: ace-git
6
6
  allowed-tools:
@@ -13,7 +13,7 @@ assign:
13
13
  - name: create-pr
14
14
  description: Create the exact assignment pull request
15
15
  produces: [pull-request]
16
- consumes: [code-changes, execution-attempt]
16
+ consumes: [code-changes]
17
17
  skill:
18
18
  kind: workflow
19
19
  execution:
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: as-git-pr-update
3
- description: Update an attempt-bound forge-neutral pull request
3
+ description: Update a forge-neutral pull request
4
4
  user-invocable: true
5
5
  source: ace-git
6
6
  allowed-tools:
@@ -13,7 +13,7 @@ assign:
13
13
  - name: update-pr-desc
14
14
  description: Update the exact assignment pull request
15
15
  produces: [pull-request]
16
- consumes: [code-changes, execution-attempt]
16
+ consumes: [code-changes]
17
17
  skill:
18
18
  kind: workflow
19
19
  execution:
@@ -1,18 +1,18 @@
1
1
  ---
2
2
  doc-type: workflow
3
- title: Create an attempt-bound draft pull request
3
+ title: Create a draft pull request
4
4
  purpose: Create or reconcile a forge-neutral draft for the exact candidate
5
5
  ---
6
6
 
7
- # Create an attempt-bound draft pull request
7
+ # Create a draft pull request
8
8
 
9
9
  ## Goal
10
10
 
11
- Create one draft PR on the selected forge and retain its exact source/base identity in the assignment attempt journal.
11
+ Create one draft PR on the selected forge and record its exact source/base identity in the assignment report.
12
12
 
13
13
  ## Prerequisites
14
14
 
15
- A reviewed task, managed assignment, active delivery attempt, committed candidate, and pushed source ref. Credentials permit transport only; they grant no integration authority.
15
+ A reviewed task or explicit implementation scope, a committed candidate, and a pushed source ref. Credentials permit transport only; they grant no integration permission.
16
16
 
17
17
  ## Inputs
18
18
 
@@ -22,49 +22,21 @@ Use `forge_server` or `forge_default: true`, mutually exclusive. Neither means r
22
22
  {"forge_server":"forge-lab","pr_provenance":{"mode":"canonical","head_repository_url":"https://forge.example/team/repo","head_ref":"feature","base_repository_url":"https://forge.example/team/repo","base_ref":"main"}}
23
23
  ```
24
24
 
25
- ## Protected worker boundary
26
-
27
- The steps below are ordinary managed delivery only. An installed protected
28
- participant uses the configured receiver and the original canonical authority,
29
- with no caller-local journal or direct-provider fallback.
30
-
31
- The authenticated worker may create/update a draft before independent review.
32
- Save a nonsecret input object with exactly `target`, `delivery`, `title`, `body`;
33
- `delivery` is the normalized original forge/provenance mapping. `target` has
34
- `resource` and nullable `artifact_digest`: the selected base repository URL for
35
- create, the exact recorded PR URL for update. Title/body are bounded UTF-8 text.
36
- Request the installed receiver with:
37
-
38
- ```sh
39
- ace-lab service request --project PROJECT --assignment ID --attempt ATTEMPT \
40
- --mapping MAPPING --scope SCOPE --service SERVICE --operation OPERATION \
41
- --candidate-head SHA --candidate-generation CANDIDATE-GENERATION \
42
- --expected-generation AUTHORITY-GENERATION --authorization AUTHORIZATION \
43
- --request-id REQUEST --input INPUT.json
44
- ```
45
-
46
- Use `create` or `update` as OPERATION; each requires its own exact scoped grant.
47
- The receiver runs the fixed `ace-git service create` or `service update` handler.
48
- A claim acknowledges admission, not PR success. Retain its complete selection
49
- and observe `ace-lab service status` as described in
50
- `wfi://handbook/perform-delivery`. Lost replies stay uncertain; status does not
51
- repeat an effect. Only canonical completion supplies the created PR URL.
52
-
53
- For ready, use the same request with OPERATION `ready` and input containing only
54
- `target` and `delivery`. Ready and merge require executed checks, accepted
55
- independent review for the current revision and the matching authorization.
56
- Local report/reference files cannot replace those canonical proofs. Draft
57
- creation/update does not grant readiness, merge or publication.
58
-
59
25
  ## Steps
60
26
 
61
27
  1. Read the task and actual committed diff; prepare a concrete title and description explaining behavior and executed validation. Save the description as a local file.
62
- 2. Use the existing managed assignment and active delivery attempt IDs. If needed, start the delivery step with `ace-assign attempt start --assignment ID --step STEP --project PROJECT` (numeric step scope). The execution boundary supplies actor identity; do not impersonate a reviewer or integrator.
63
- 3. Supply the assignment source's `delivery` mapping, or save the explicit input JSON and pass `--parameters FILE`. For task-mode creation, `ace-assign create --task TASK --delivery-parameters FILE` retains these inputs in the generated job.
64
- 4. Execute `ace-assign delivery --assignment ID --attempt ATTEMPT --operation create --title TITLE --body-file DESCRIPTION`. Add `--parameters FILE` only when supplying an explicit file. In this repository invoke the source `bin/ace-assign` entrypoint.
65
- 5. Read the structured result. Verify the retained server/provider/base and head repository/ref, draft PR number/URL, candidate SHA, base_head, evidence_git_ref, and separate journal_commit. The pushed ref must equal the candidate; journal commits never advance it.
66
- 6. On interruption or unknown create outcome, repeat the delivery command to perform exact-selector reconciliation reads. One matching draft at the exact head is adopted without a second create. Zero remains unresolved; multiple matches conflict. Never bypass uncertainty with a direct provider command.
28
+ 2. When this work belongs to an assignment, use its actual ID and record the PR identity in the assignment report. The execution boundary supplies actor identity; do not impersonate a reviewer or integrator.
29
+ 3. Verify the pushed source ref resolves to the candidate SHA. The pushed ref must equal the candidate.
30
+ 4. Create the draft with the configured forge command; drafts are the default:
31
+
32
+ ```sh
33
+ ace-git pr create --server NAME --head HEAD-REF --head-repo HEAD-REPOSITORY-URL --base BASE-REF --expected-head CANDIDATE-SHA --title TITLE --body-file DESCRIPTION --format json
34
+ ```
35
+
36
+ Use the retained default/remote selection instead of `--server NAME` when applicable. In this repository invoke the source `bin/ace-git` entrypoint.
37
+ 5. Read the structured result. Verify the retained server/provider/base and head repository/ref, draft PR number/URL, candidate SHA and base head. Record the PR identity and observed candidate head in the assignment report.
38
+ 6. On interruption or an unknown create outcome, repeat the same command with the same selectors: the implementation re-reads open PRs and adopts one matching draft at the exact head without a second create. Adoption does not compare or rewrite the remote title/body, so verify the remote content explicitly before relying on it, and use `wfi://git/pr/update` if the description differs. Zero matches remain unresolved; multiple matches conflict. Never bypass an uncertain read with a different provider command.
67
39
 
68
40
  ## Success criteria
69
41
 
70
- The journal records exact identity, intent before the write, and proven draft outcome afterward. A report or shell exit alone proves nothing. Continue with actual tests and independent current-head review; keep the PR draft until those receipts are accepted. CI is visible and advisory. Publication is a separate authorized operation and is not required for delivery.
42
+ The assignment report records exact identity and the proven draft outcome. A report or shell exit alone proves nothing. Continue with actual tests and independent current-head review; keep the PR draft until those results are accepted. CI is visible and advisory. Publication is a separate authorized operation and is not required for delivery.
@@ -1,10 +1,10 @@
1
1
  ---
2
2
  doc-type: workflow
3
- title: Update an attempt-bound pull request
4
- purpose: Update the exact forge-neutral PR and consume current delivery evidence
3
+ title: Update a pull request
4
+ purpose: Update the exact forge-neutral PR and record current delivery evidence
5
5
  ---
6
6
 
7
- # Update an attempt-bound pull request
7
+ # Update a pull request
8
8
 
9
9
  ## Goal
10
10
 
@@ -12,51 +12,35 @@ Update the recorded PR description for the current candidate and preserve provid
12
12
 
13
13
  ## Prerequisites
14
14
 
15
- A managed assignment with a recorded PR and active delivery attempt. Reuse the original forge selection and complete fork/canonical provenance; changed configuration or identity is a conflict. A new committed candidate, including task-only changes, requires renewed tests and independent review.
16
-
17
- ## Protected worker boundary
18
-
19
- The steps below are ordinary managed delivery only. An installed protected
20
- participant uses the configured receiver and the original canonical authority,
21
- with no caller-local journal or direct-provider fallback.
22
-
23
- The authenticated worker may create/update a draft before independent review.
24
- Save a nonsecret input object with exactly `target`, `delivery`, `title`, `body`;
25
- `delivery` is the normalized original forge/provenance mapping. `target` has
26
- `resource` and nullable `artifact_digest`: the selected base repository URL for
27
- create, the exact recorded PR URL for update. Title/body are bounded UTF-8 text.
28
- Request the installed receiver with:
29
-
30
- ```sh
31
- ace-lab service request --project PROJECT --assignment ID --attempt ATTEMPT \
32
- --mapping MAPPING --scope SCOPE --service SERVICE --operation OPERATION \
33
- --candidate-head SHA --candidate-generation CANDIDATE-GENERATION \
34
- --expected-generation AUTHORITY-GENERATION --authorization AUTHORIZATION \
35
- --request-id REQUEST --input INPUT.json
36
- ```
37
-
38
- Use `create` or `update` as OPERATION; each requires its own exact scoped grant.
39
- The receiver runs the fixed `ace-git service create` or `service update` handler.
40
- A claim acknowledges admission, not PR success. Retain its complete selection
41
- and observe `ace-lab service status` as described in
42
- `wfi://handbook/perform-delivery`. Lost replies stay uncertain; status does not
43
- repeat an effect. Only canonical completion supplies the created PR URL.
44
-
45
- For ready, use the same request with OPERATION `ready` and input containing only
46
- `target` and `delivery`. Ready and merge require executed checks, accepted
47
- independent review for the current revision and the matching authorization.
48
- Local report/reference files cannot replace those canonical proofs. Draft
49
- creation/update does not grant readiness, merge or publication.
15
+ An assignment with a recorded PR, or an explicit local PR scope. Reuse the original forge selection and complete fork/canonical provenance; changed configuration or identity is a conflict. A new committed candidate, including task-only changes, requires renewed tests and independent review.
50
16
 
51
17
  ## Steps
52
18
 
53
- 1. Inspect the committed changes and accepted test/review evidence. Prepare the final description with the concrete behavior, executed test results, independent verdict, and actual limitations. Save it as a local file; do not put credentials or terminal dumps in the attempt journal.
54
- 2. Execute `ace-assign delivery --assignment ID --attempt ATTEMPT --operation update --body-file DESCRIPTION`. Supply `--parameters FILE` only if the assignment source lacks the original `delivery` mapping. In this repository use `bin/ace-assign`.
55
- 3. On interrupted update, repeat the delivery command. It reads the exact remote title/body and compares the requested field digest before accepting; an unmatched or unreadable outcome remains unresolved. Never blindly resend a mutation.
56
- 4. To mark ready, supply two JSON reference files, each containing only `attempt_id` and `receipt_digest`, from coordinator-accepted current-head test and independent review attempts in this assignment/project. Execute `ace-assign delivery --assignment ID --attempt ATTEMPT --operation ready --tests TEST-REF --review REVIEW-REF`. Missing, fabricated, stale, or self-approved evidence cannot authorize readiness. Red CI alone does not veto valid executed tests and review.
57
- 5. Merge is an integrator/service operation under the existing exact qjx authorization policy. The authorized executor calls `ace-git pr merge IDENTIFIER --server NAME --expected-head CANDIDATE-SHA --method METHOD --format json` with the retained selection (or `--default-server`, otherwise remote resolution). Both expected SHA and the authorized squash/merge/rebase method are required; there is no default method. It does not recursively request its own future receipt. The worker consumes the completed, verified service receipt using `ace-assign delivery --assignment ID --attempt ATTEMPT --operation merge --tests TEST-REF --review REVIEW-REF --service-request REQUEST`. The request must bind this assignment, attempt, project, candidate and PR URL. No completed receipt means a routed blocker; credentials or caller assertions grant no authority.
58
- 6. Unknown merge remains pending service reconciliation and is never automatically retried. Inspect the authoritative selected remote and verified executor evidence. Changed head or scope blocks acceptance. Merge does not authorize publication, deployment or synchronization.
19
+ 1. Inspect the committed changes and accepted test/review evidence. Prepare the final description with the concrete behavior, executed test results, independent verdict, and actual limitations. Save it as a local file; do not put credentials or terminal dumps in the assignment report.
20
+ 2. Update the PR with the configured forge command:
21
+
22
+ ```sh
23
+ ace-git pr update IDENTIFIER --server NAME --expected-head CANDIDATE-SHA --body-file DESCRIPTION --format json
24
+ ```
25
+
26
+ Use the retained default/remote selection instead of `--server NAME` when applicable. In this repository invoke the source `bin/ace-git` entrypoint.
27
+ 3. On an interrupted update, do not assume the command reconciles for you: `ace-git pr update` verifies the head and rewrites the title/body, so a retry is a new write. Explicitly read the exact remote title/body (for example `ace-git pr show IDENTIFIER --format json`), compare it with the prepared description; if identical, treat the update as done, otherwise re-run the command. An unreadable or uncertain read stays unresolved. Never blindly resend a mutation.
28
+ 4. Mark ready only after tests and independent review pass on the exact head. Record the executed tests and independent review evidence for that head, then run:
29
+
30
+ ```sh
31
+ ace-git pr ready IDENTIFIER --server NAME --expected-head CANDIDATE-SHA --format json
32
+ ```
33
+
34
+ Missing, stale, or self-approved evidence cannot authorize readiness. Red CI alone does not veto valid executed tests and review.
35
+ 5. Merge is a separate authorized operation for the exact candidate. The authorized executor runs:
36
+
37
+ ```sh
38
+ ace-git pr merge IDENTIFIER --server NAME --expected-head CANDIDATE-SHA --method METHOD --format json
39
+ ```
40
+
41
+ with the retained selection (or `--default-server`, otherwise remote resolution). Both the expected SHA and the authorized squash/merge/rebase method are required; there is no default method. Credentials or caller assertions grant no permission.
42
+ 6. An unknown merge remains an unresolved effect. Inspect the authoritative selected remote and the actual executor evidence; never retry blindly. Changed head or scope blocks acceptance. Merge does not authorize publication, deployment or synchronization.
59
43
 
60
44
  ## Success criteria
61
45
 
62
- The exact remote outcome and existing qjl evidence agree. Real artifacts, current executed tests, independent verdict and required authorization gate completion. Preserve unresolved history and distinct candidate_head/journal_commit. qkb.1 supplies installed charter/proposal/service adoption; this workflow does not fabricate that acceptance.
46
+ The exact remote outcome and the locally recorded evidence agree. Real artifacts, current executed tests and an independent verdict gate completion. Preserve unresolved history and distinguish the candidate head from evidence commits.
@@ -2,6 +2,6 @@
2
2
 
3
3
  module Ace
4
4
  module Git
5
- VERSION = "0.30.0"
5
+ VERSION = "0.30.1"
6
6
  end
7
7
  end
metadata CHANGED
@@ -1,13 +1,13 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: ace-git
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.30.0
4
+ version: 0.30.1
5
5
  platform: ruby
6
6
  authors:
7
7
  - Michal Czyz
8
8
  bindir: exe
9
9
  cert_chain: []
10
- date: 2026-10-08 00:00:00.000000000 Z
10
+ date: 2026-10-20 00:00:00.000000000 Z
11
11
  dependencies:
12
12
  - !ruby/object:Gem::Dependency
13
13
  name: ace-support-config