ace-retro 0.16.6 → 0.18.4
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 +55 -0
- data/README.md +8 -1
- data/docs/usage.md +11 -0
- data/handbook/workflow-instructions/retro/selfimprove.wf.md +2 -1
- data/handbook/workflow-instructions/retro/synthesize.wf.md +1 -1
- data/lib/ace/retro/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: 0e8ceb55f21c1a8fb58a6e60a5c3b8b0bea1978a688bb66525e660fc73600641
|
|
4
|
+
data.tar.gz: 621d1781df746dc0350fab95f6aba5f210d26338571eab929fa274cad4a1f7f2
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 86f10cf0938b95e49a066a87db1ebcc608300b5726d19980a4b175835765637c97e3eb34edda7ff57536512fde4e24509867886ab549550497b2767a7ec766ab
|
|
7
|
+
data.tar.gz: b13f3d80af7ae3ed528115e0b5b4c54f75cd169f26288d24312479da8ebe1bfca5fb8de70b4e670a3de8cd4a8ba3a7c14613186d9ddc92c37cab6103f66e0612
|
data/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,61 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
## [Unreleased]
|
|
9
9
|
|
|
10
|
+
## [0.18.4] - 2026-04-23
|
|
11
|
+
|
|
12
|
+
|
|
13
|
+
### Changed
|
|
14
|
+
- Added self-improvement and layer-ownership workflow refinements for retro-driven cycle analysis and root-cause tracing workflows.
|
|
15
|
+
- Extended retro contract checks so workflow-layer attribution is stable across contract verification paths.
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
### Changed
|
|
19
|
+
- Added a self-improvement root-cause category for wrong-layer fixes where the symptom package is patched before the shared primitive owner is identified.
|
|
20
|
+
|
|
21
|
+
### Technical
|
|
22
|
+
- Added workflow contract coverage for the new wrong-layer self-improvement category.
|
|
23
|
+
|
|
24
|
+
## [0.18.3] - 2026-04-20
|
|
25
|
+
|
|
26
|
+
### Fixed
|
|
27
|
+
- Updated retro synthesis and self-improvement workflows to archive consumed retros with `ace-retro update REF --move-to archive`, matching the current CLI after the standalone `move` command removal.
|
|
28
|
+
|
|
29
|
+
## [0.18.2] - 2026-04-16
|
|
30
|
+
|
|
31
|
+
### Technical
|
|
32
|
+
- Tightened `TS-RETRO-001` doctor corruption instructions to require a deterministic YAML syntax break, keeping the negative-path smoke check aligned with real error-level doctor failures.
|
|
33
|
+
|
|
34
|
+
## [0.18.1] - 2026-04-16
|
|
35
|
+
|
|
36
|
+
### Technical
|
|
37
|
+
- Updated `TS-RETRO-001` sandbox setup to source `mise.toml` from `${ACE_E2E_SOURCE_ROOT:-$PROJECT_ROOT_PATH}` so retro smoke runs remain compatible with read-only source mounts.
|
|
38
|
+
|
|
39
|
+
## [0.18.0] - 2026-04-15
|
|
40
|
+
|
|
41
|
+
### Changed
|
|
42
|
+
- Refined `TS-RETRO-001` public-surface smoke guidance by making help/usage parity checks explicit and tightening the doctor healthy-to-failure transition around impact-first evidence.
|
|
43
|
+
|
|
44
|
+
### Technical
|
|
45
|
+
- Reduced brittle corruption-capture coupling in `TC-004` runner/verifier docs and clarified doctor negative-path expectations in `docs/usage.md`.
|
|
46
|
+
|
|
47
|
+
## [0.17.1] - 2026-04-13
|
|
48
|
+
|
|
49
|
+
### Changed
|
|
50
|
+
- Completed the batch i05 migration follow-through for this package and aligned it with the restarted `fast` / `feat` / `e2e` verification model.
|
|
51
|
+
|
|
52
|
+
### Technical
|
|
53
|
+
- Included in the coordinated assignment-driven patch release for batch i05 package updates.
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
## [0.17.0] - 2026-04-12
|
|
57
|
+
|
|
58
|
+
### Changed
|
|
59
|
+
- Migrated package tests to the `fast` / `feat` / `e2e` model by moving deterministic suites into `test/fast` and keeping `test/e2e` focused on workflow-value scenarios.
|
|
60
|
+
- Updated E2E migration decision metadata for `TS-RETRO-001` to track retained (`KEEP`) scenario coverage and deterministic coverage references in `test/fast`.
|
|
61
|
+
|
|
62
|
+
### Technical
|
|
63
|
+
- Added explicit restarted test-contract guidance to package docs (`README.md`, `docs/usage.md`) covering `ace-test`, `ace-test all`, optional `ace-test feat`, and `ace-test-e2e`.
|
|
64
|
+
|
|
10
65
|
## [0.16.6] - 2026-03-31
|
|
11
66
|
|
|
12
67
|
### Changed
|
data/README.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
<h1> ACE - Retro </h1>
|
|
3
3
|
|
|
4
|
-
Lightweight retrospective management
|
|
4
|
+
Lightweight retrospective management -- create, tag, and archive retros from the command line.
|
|
5
5
|
|
|
6
6
|
<img src="../docs/brand/AgenticCodingEnvironment.Logo.XS.jpg" alt="ACE Logo" width="480">
|
|
7
7
|
<br><br>
|
|
@@ -26,6 +26,13 @@
|
|
|
26
26
|
2. Enrich metadata with tags and status updates.
|
|
27
27
|
3. Archive completed retros to preserve history while keeping the active workspace clean.
|
|
28
28
|
|
|
29
|
+
## Testing
|
|
30
|
+
|
|
31
|
+
- `ace-test ace-retro` runs deterministic fast tests (default package loop).
|
|
32
|
+
- `ace-test ace-retro all` runs the full deterministic suite.
|
|
33
|
+
- `ace-test-e2e ace-retro` runs retained scenario workflows under `test/e2e/`.
|
|
34
|
+
- `ace-test ace-retro feat` is used only when explicit `test/feat/` contracts exist.
|
|
35
|
+
|
|
29
36
|
## Use Cases
|
|
30
37
|
|
|
31
38
|
**Capture retros quickly after delivery** - use `/as-retro-create` or [`ace-retro create`](docs/usage.md) to initialize a retro from templates while the work is still fresh.
|
data/docs/usage.md
CHANGED
|
@@ -15,6 +15,15 @@ Complete command reference for `ace-retro`.
|
|
|
15
15
|
gem install ace-retro
|
|
16
16
|
```
|
|
17
17
|
|
|
18
|
+
## Testing Model
|
|
19
|
+
|
|
20
|
+
Use the restarted package test contract:
|
|
21
|
+
|
|
22
|
+
- `ace-test ace-retro` for default deterministic fast coverage.
|
|
23
|
+
- `ace-test ace-retro all` for full deterministic coverage.
|
|
24
|
+
- `ace-test-e2e ace-retro` for workflow-value scenario coverage in `test/e2e/`.
|
|
25
|
+
- `ace-test ace-retro feat` only when the package has explicit `test/feat/` contracts.
|
|
26
|
+
|
|
18
27
|
## Global Options
|
|
19
28
|
|
|
20
29
|
All commands support:
|
|
@@ -122,6 +131,8 @@ ace-retro doctor --check frontmatter
|
|
|
122
131
|
ace-retro doctor --json
|
|
123
132
|
```
|
|
124
133
|
|
|
134
|
+
For negative-path validation in a test sandbox, run `ace-retro doctor` once on healthy files, then re-run after introducing invalid frontmatter in a sandbox-local retro file; the second run should exit non-zero with issue output.
|
|
135
|
+
|
|
125
136
|
## Common Commands
|
|
126
137
|
|
|
127
138
|
| Command | What it does |
|
|
@@ -73,6 +73,7 @@ Ask: "Why did this happen?" Categorize the root cause:
|
|
|
73
73
|
| **Scope creep** | Agent over-scoped the task | Made changes beyond what was requested |
|
|
74
74
|
| **Missing example** | No example of correct behavior | Workflow lacks example showing full scope discovery |
|
|
75
75
|
| **Redundant computation** | Multiple agents derive same value independently, causing divergence | Orchestrator computes path one way, agent re-derives differently |
|
|
76
|
+
| **Wrong layer / owner not identified** | Agent fixed the symptom package before identifying the package that owns the shared primitive | `ace-assign` exposed a tmux window-name failure, but `ace-tmux` owned window creation, naming, and navigation |
|
|
76
77
|
|
|
77
78
|
### Step 3: Find the Source
|
|
78
79
|
|
|
@@ -184,7 +185,7 @@ Populate the retro with the root cause analysis, the fix applied, and the expect
|
|
|
184
185
|
If the input source was an existing retro, archive it after the improvement has been applied — the retro has been "consumed":
|
|
185
186
|
|
|
186
187
|
```bash
|
|
187
|
-
ace-retro
|
|
188
|
+
ace-retro update REF --move-to archive
|
|
188
189
|
```
|
|
189
190
|
|
|
190
191
|
## Success Criteria
|
|
@@ -80,7 +80,7 @@ When populating, reference source retros to provide traceability (e.g., "Identif
|
|
|
80
80
|
After the synthesis retro is populated and complete, archive each source retro — they have been "consumed" by the synthesis:
|
|
81
81
|
|
|
82
82
|
```bash
|
|
83
|
-
ace-retro
|
|
83
|
+
ace-retro update REF --move-to archive
|
|
84
84
|
```
|
|
85
85
|
|
|
86
86
|
Repeat for each source retro.
|
data/lib/ace/retro/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: ace-retro
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 0.
|
|
4
|
+
version: 0.18.4
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Michal Czyz
|
|
8
8
|
bindir: exe
|
|
9
9
|
cert_chain: []
|
|
10
|
-
date: 2026-04-
|
|
10
|
+
date: 2026-04-26 00:00:00.000000000 Z
|
|
11
11
|
dependencies:
|
|
12
12
|
- !ruby/object:Gem::Dependency
|
|
13
13
|
name: ace-support-core
|