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 +4 -4
- data/CHANGELOG.md +12 -0
- data/docs/handbook.md +5 -0
- data/docs/usage.md +25 -18
- data/handbook/guides/version-control-system-git.g.md +10 -9
- data/handbook/skills/as-git-pr-create/SKILL.md +2 -2
- data/handbook/skills/as-git-pr-update/SKILL.md +2 -2
- data/handbook/workflow-instructions/git/pr/create.wf.md +16 -44
- data/handbook/workflow-instructions/git/pr/update.wf.md +29 -45
- data/lib/ace/git/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: c03430c6a212d4bb6c51a3cb4bbf8f884051fe37b55581f9ea3d5d14048c83fa
|
|
4
|
+
data.tar.gz: e4da9c0fc2ae249ff7459973be3bfa42679395a68cb184e49446ea049aa5074f
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
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
|
-
|
|
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-
|
|
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
|
-
|
|
293
|
-
are
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
|
|
297
|
-
the
|
|
298
|
-
|
|
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-
|
|
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
|
|
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
|
|
193
|
-
fork/canonical repository and ref provenance. The
|
|
194
|
-
|
|
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
|
|
197
|
-
|
|
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;
|
|
229
|
-
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
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
|
|
7
|
+
# Create a draft pull request
|
|
8
8
|
|
|
9
9
|
## Goal
|
|
10
10
|
|
|
11
|
-
Create one draft PR on the selected forge and
|
|
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
|
|
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.
|
|
63
|
-
3.
|
|
64
|
-
4.
|
|
65
|
-
|
|
66
|
-
|
|
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
|
|
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
|
|
4
|
-
purpose: Update the exact forge-neutral PR and
|
|
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
|
|
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
|
-
|
|
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
|
|
54
|
-
2.
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
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
|
|
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.
|
data/lib/ace/git/version.rb
CHANGED
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.
|
|
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-
|
|
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
|