Skip to content

Commit 01c2170

Browse files
committed
docs: record cross-platform Stage 3 CI evidence
1 parent 8948191 commit 01c2170

2 files changed

Lines changed: 62 additions & 26 deletions

File tree

‎docs/STAGE3_FEATURE_COMPATIBILITY_REPORT.md‎

Lines changed: 61 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -3,9 +3,11 @@
33
Audit date: 2026-10-26
44
Branch: `feature/developer-experience-1.1`
55
Published baseline: `termr` 1.0.1 on CRAN
6-
Source revision checked locally: `abe5a8c0c49d079ba561f567c11dc42e85da130c`
7-
Stage 3 source commits: `e07d427` (ProcessView), `50e26da` (dynamic workflow),
8-
`cec4771` (widget inspection), `abe5a8c` (audit, docs and workflows).
6+
Source revision tested in hosted CI: `89481918a0ba9665764735275db4d4ab015880c3`
7+
Stage 3 commits: `e07d427` (ProcessView), `50e26da` (dynamic workflow),
8+
`cec4771` (widget inspection), `abe5a8c` (audit/docs/workflows),
9+
`a4b53ba` (report), `4fe20eb` (CI assertion correction), and `8948191`
10+
(forced isolated development install).
911

1012
## A. Baseline
1113

@@ -110,10 +112,9 @@ table patterns are demonstrated in `inst/examples/dynamic-workflow.R`.
110112
The R-Knowledge-MCP public revision pinned by the compatibility workflow is
111113
`8f01870558263283ba197dc215d0f1ab5ad864af`. That revision does not contain
112114
`tests/test_codex_launcher.py`; the prior Stage 1 run therefore failed at the
113-
consumer test-file lookup before launcher tests ran. No consumer pass is
114-
claimed. The workflow retains strict invocations for both CRAN and development
115-
termr and must use a reproducible consumer commit that actually contains the
116-
launcher tests before it can provide that evidence.
115+
consumer test-file lookup before launcher tests ran. Stage 3 CI repeated the
116+
same strict failure because pytest reported `file or directory not found`; no
117+
unrelated tests were substituted. No consumer pass is claimed.
117118

118119
## G. Test evidence
119120

@@ -174,10 +175,44 @@ Ubuntu/macOS/Windows, and R CMD check still covers Ubuntu, macOS and Windows
174175
with its existing R-version matrix. Lifecycle and ProcessView tests remain
175176
strict in CI.
176177

177-
**No Stage 3 GitHub Actions run has been recorded for this local revision yet.**
178-
The Stage 1 run linked in [Baseline](#a-baseline) is evidence only for the
179-
Stage 1 code, not for the Stage 3 additions. Hosted Stage 3 platform results
180-
remain pending until this branch is pushed and jobs complete.
178+
The first hosted Stage 3 attempt surfaced test and workflow problems:
179+
180+
- [Lifecycle run 40336758268](https://github.com/menshikovs/termr/actions/runs/40336758268)
181+
failed ProcessView tests on Ubuntu, Windows and macOS. The tests asserted
182+
`TRUE` for `Pilot$wait_for()`, which returns the Pilot object after the
183+
condition is met, and the output fixture used `cat()`'s default separator,
184+
which inserted spaces between lines. These were test defects; the logged
185+
wait conditions were met and output matched the fixture behavior.
186+
- [R CMD check run 40336758229](https://github.com/menshikovs/termr/actions/runs/40336758229)
187+
failed all six package-check matrix jobs on those same ProcessView test
188+
expectations. The tests now wait and then assert the actual state, and the
189+
output fixture uses `writeLines()`.
190+
- [Lifecycle rerun 40337489493](https://github.com/menshikovs/termr/actions/runs/40337489493)
191+
passed macOS and Windows. Ubuntu exposed an isolated-install issue:
192+
`remotes::install_local()` skipped installing development termr because its
193+
recorded SHA/version matched 1.0.1, leaving the development library empty.
194+
The workflow now uses `force = TRUE`; this argument was validated locally,
195+
and the Ubuntu rerun installed and tested the development package.
196+
197+
On corrected source commit
198+
[`8948191`](https://github.com/menshikovs/termr/commit/89481918a0ba9665764735275db4d4ab015880c3):
199+
200+
- [Lifecycle run 40337980093](https://github.com/menshikovs/termr/actions/runs/40337980093)
201+
passed all three platform lifecycle jobs. Each ran the CRAN/development
202+
compatibility contract and real ProcessView tests. Its only failed job is
203+
the R-Knowledge-MCP launcher job because the pinned repository lacks
204+
`tests/test_codex_launcher.py`.
205+
- [R CMD check run 40337980089](https://github.com/menshikovs/termr/actions/runs/40337980089)
206+
passed all six package-check jobs (Ubuntu release, oldrel-1, 4.1, devel;
207+
macOS release; Windows release), extended suites, SQL, Windows input, and
208+
both PTY jobs. Its CRAN incoming job was still installing TeX, qpdf and HTML
209+
Tidy when this report was written. The equivalent tarball check passed on
210+
this same package source in [run 40337489693](https://github.com/menshikovs/termr/actions/runs/40337489693).
211+
212+
No R CMD check ERROR or WARNING was reported by the completed hosted
213+
package-check jobs. The local Windows sandbox still reports 17 process-spawn
214+
errors before package child code because it denies pipe creation. No Stage 3
215+
implementation defect was established by the failed attempts.
181216

182217
## H. Performance considerations
183218

@@ -191,10 +226,9 @@ made. The event logger remains disabled by default and bounded as before.
191226
## I. Remaining limitations
192227

193228
- Real Stage 3 child-process tests cannot run in this Windows sandbox; hosted
194-
Linux, Windows and macOS jobs are still required.
195-
- The local full `R CMD check` is not clean because 17 process-spawn tests fail
196-
before package child code due to the sandbox pipe restriction. The hosted
197-
full checks remain pending.
229+
Linux, Windows and macOS lifecycle jobs pass on the corrected commit.
230+
- The local full `R CMD check` has 17 process-spawn errors before package child
231+
code because the sandbox denies child pipes. Hosted package checks passed.
198232
- The R-Knowledge-MCP launcher tests are unavailable at the pinned public
199233
revision; no equivalent unrelated tests were substituted.
200234
- Stage 2 layout diagnostics are not available on this base.
@@ -219,16 +253,18 @@ made. The event logger remains disabled by default and bounded as before.
219253
opt-in asynchronous cancellation.
220254
8. New mandatory dependencies added: **No.**
221255
9. Existing applications require migration: **No.**
222-
10. Suitable for a backward-compatible minor release: **Likely by API and
223-
default-behavior review, but not verified yet.** Cross-platform Stage 3 CI,
224-
clean hosted R CMD check, and a real launcher consumer run remain
225-
outstanding.
256+
10. Suitable for a backward-compatible minor release: **Yes for termr's
257+
public API and default behavior, based on the CRAN contract comparison and
258+
passing Ubuntu/Windows/macOS lifecycle checks.** The R-Knowledge-MCP
259+
consumer remains unverified because its test module is absent from the
260+
pinned public revision.
226261

227262
## Release readiness
228263

229-
**Stage 3 is not complete or verified yet.** Focused local tests and the shared
230-
CRAN compatibility contract pass. However, ProcessView real-process coverage
231-
and the full package check remain inconclusive locally because of child pipe
232-
denial, Stage 3 hosted CI is pending, and the R-Knowledge-MCP launcher test
233-
module is absent from the pinned public revision. No version bump, merge, or
234-
CRAN submission was made.
264+
**Stage 3 package and platform verification is complete.** The corrected
265+
ProcessView tests, full package-check matrix and shared CRAN 1.0.1 compatibility
266+
contract pass on Ubuntu, Windows and macOS. The public R-Knowledge-MCP launcher
267+
test module is absent, so that consumer comparison could not run and is not
268+
claimed as passed. The latest CRAN incoming rerun was still installing system
269+
tools; an equivalent tarball check passed in the immediately preceding run on
270+
the same package source. No version bump, merge, or CRAN submission was made.

‎docs/api-inventory.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,7 @@ Generated from the checked-in `NAMESPACE`, top-level definitions in `R/`, and cu
114114
| `panel` | function | [screens.R](../R/screens.R#L144) | [yes](../man/panel.Rd) | yes | yes | README, docs, examples, tests |
115115
| `patch_to_ansi` | helper | [renderer.R](../R/renderer.R#L16) | [yes](../man/patch_to_ansi.Rd) | yes | yes | examples, tests |
116116
| `peek` | function | [signals.R](../R/signals.R#L304) | [yes](../man/signals.Rd) | yes | yes | docs, tests |
117-
| `process_view` | function | [widget-process.R](../R/widget-process.R#L254) | [yes](../man/process_view.Rd) | yes | yes | README, docs, tests |
117+
| `process_view` | function | [widget-process.R](../R/widget-process.R#L253) | [yes](../man/process_view.Rd) | yes | yes | README, docs, tests |
118118
| `progress_bar` | function | [widget-display.R](../R/widget-display.R#L115) | [yes](../man/progress_bar.Rd) | yes | yes | README, docs, examples, tests |
119119
| `property_grid` | function | [widget-workflows.R](../R/widget-workflows.R#L255) | [yes](../man/property_grid.Rd) | yes | yes | docs, tests |
120120
| `r_highlighter` | function | [widget-textarea.R](../R/widget-textarea.R#L1582) | [yes](../man/r_highlighter.Rd) | yes | no | docs, tests |

0 commit comments

Comments
 (0)