Skip to content

Maintenance pass (2026-10): upstream bumps, scheduled CI, honest status - #2

Merged
ericmann merged 6 commits into
mainfrom
maint/2026-10
Oct 29, 2026
Merged

ericmann merged 6 commits into
mainfrom
maint/2026-10

Conversation

@ericmann

@ericmann ericmann commented Oct 29, 2026 •

Copy link
Copy Markdown
Contributor

Part of the 2026-10 maintenance pass. Merge order: this PR first, then ext-infer / ext-turbovec / ext-whisper, then rag-over-markdown, then phpai. Please use a merge commit (not squash): the extension PRs' chore: sync scaffold from ext-template@<sha> commits name this branch's SHAs (442aa21, 339f16f, 19295ee, 3978271).

What changed and why

Managed tree (reaches every extension via bin/sync):

  • Weekly scheduled CI + workflow_dispatch: a green badge now means "green this week". The comment in ci.yml records GitHub's 60-days-without-activity auto-disable and that the Dependabot merges keep the schedule alive.
  • ZTS legs (Linux, PHP 8.4 / 8.5, phpts: ts), continue-on-error for now, with a step asserting the runner's PHP_ZTS matches the leg. All three extensions pass them.
  • Managed .github/dependabot.yml: grouped weekly cargo minor/patch. Ignores ext-php-rs / thiserror (owned by versions.conf) and the primary upstream crates (llama-cpp-2, turbovec, whisper-rs + -sys). No github-actions ecosystem in children.
  • EXT_PHP_RS_PIN =0.15.13 → =0.16.3, THISERROR_PIN =2.0.18 → =2.0.21. Read the 0.16 migration guide first; adapted all three extensions; Reflection-dump and generated-stub diffs show no signature change (details in the extension PRs). RUST_CHANNEL stays 1.89.
  • Fix: libclang pin on Linux runners. ubuntu-latest is now ubuntu-26.04, which preinstalls clang 20/21/22. Unpinned, bindgen loads libclang 22 against LLVM 21 builtin headers and ext-php-rs fails with "Unable to generate bindings for PHP". Reproduced in an ubuntu:26.04 container: ext-php-rs 0.15.13 fails identically, so every extension's main would have gone red on its next CI run too. Pinning LIBCLANG_PATH/CLANG_PATH to libclang-dev's LLVM fixes both.
  • Fix: make stubs passed a --stubs flag cargo-php has never had. It now writes to target/ for a diff against the curated stubs (never overwriting them) and takes STUBS_PRELOAD for Linux, where cargo-php's dlopen() needs PHP's embed library.
  • The setup-php unpin and the PHP 8.5 × macos-14 leg from Unpin setup-php (@v2), restore the macos-14/PHP 8.5 leg #1 (July) are now synced into all three extensions.

Template-only:

  • .github/dependabot.yml: github-actions for this repo and template/managed/.github/workflows. Verified: dependabot-core's github_actions/file_fetcher.rb scans a non-root directory's YAML directly (workflows_dir = "."), and the unrendered templates parse under Ruby YAML.safe_load, the parser Dependabot uses.
  • Upstream watcher: bin/upstream-check + template/upstream.conf + weekly upstream-watch.yml keep one upstream-labelled issue per exact pin that's behind crates.io, updated as crates.io moves and closed when the pin catches up. Local dry run today: ext-php-rs and thiserror are current after this PR; llama-cpp-2 and turbovec will be current once the extension PRs merge; whisper-rs is current. It can only be exercised after merge (scheduled and dispatch runs use the default branch). If it runs before the extension PRs merge, it will open llama-cpp-2 / turbovec issues that close themselves once those land.
  • Seeds: README Status section (no pre-release badge), stack table, "Writing about this" slot; PLAN.md as design notes; CHANGELOG.md.
  • README: dependency-ownership table and the Dependabot verification; CHANGELOG.md.
  • Template CI: weekly schedule, shellcheck of the new script, render smoke covers the new seeds and dependabot.yml, and an SC2015 fix.

Verification

  • shellcheck + actionlint clean (rendered and template workflows); render smoke + sync idempotence + pin cascade pass locally and in CI.
  • A freshly rendered skeleton builds on ext-php-rs 0.16.3 and passes its PHPT.
  • All three extension PRs are green on the synced scaffold: 9/9 checks each (lint, NTS 8.3/8.4/8.5 × macOS arm64 + Linux, ZTS 8.4/8.5).

Draft release notes — ext-template v0.2.0

Scheduled weekly CI, ZTS test legs, and dependency upkeep that doesn't fight bin/sync: Dependabot for the managed workflows' actions and each extension's non-upstream crates, plus a weekly upstream watcher that files an issue when an exact pin (ext-php-rs, thiserror, llama-cpp-2, turbovec, whisper-rs) falls behind crates.io. Shared pins move to ext-php-rs 0.16.3 / thiserror 2.0.21. Fixes Linux builds on the ubuntu-26.04 runners (libclang pin) and a make stubs target that never worked. Seeds now render a Status section, a PLAN.md of design notes, and a CHANGELOG. See CHANGELOG.md.

Managed (reaches every extension on bin/sync):
- ci.yml: weekly schedule + workflow_dispatch, so a green badge means
  "green this week". Comment records GitHub's 60-days-without-activity
  auto-disable and that Dependabot merges are what keep it alive.
- ci.yml: ZTS legs (Linux, PHP 8.4 + 8.5) via setup-php `phpts: ts`,
  continue-on-error until they have a track record; a step asserts the
  runner's PHP_ZTS actually matches the leg; rust-cache key scoped by
  thread-safety mode (ext-php-rs bindings differ between NTS and ZTS).
- dependabot.yml: weekly grouped minor/patch cargo updates. Ignores
  ext-php-rs/thiserror (versions.conf owns them; a child-side PR would
  be reverted by the next sync) and the primary upstream crates
  (llama-cpp-2, turbovec, whisper-rs and their -sys crates — deliberate,
  tested bumps). No github-actions ecosystem: the workflows are managed.
- release.yml: replace the stale "setup-php has no TS option" note.

Template-only:
- .github/dependabot.yml: github-actions for this repo's workflows AND
  template/managed/.github/workflows. dependabot-core scans the YAML
  directly inside a non-root `directory`, and the unrendered templates
  parse (Psych safe_load verified), so action bumps land here once and
  cascade through bin/sync.
- bin/upstream-check + template/upstream.conf + upstream-watch.yml:
  weekly comparison of every exactly-pinned crate Dependabot ignores
  against crates.io; one `upstream`-labelled issue per lagging crate,
  updated as crates.io moves, closed when the pin catches up.
- ci.yml: weekly schedule; shellcheck the new script; render smoke now
  asserts dependabot.yml renders and parses; fix an SC2015 A&&B||C.
ext-php-rs 0.16 is a soundness/consistency release with a long list of
breaking changes (migration guide: guide/src/migration-guides/v0.16.md).
Verified against all three extensions before bumping the cascade:

- ext-turbovec, ext-whisper: compile unchanged.
- ext-infer: `#[php(defaults(...))]` values are now converted into the
  parameter type, so u32/f32 defaults need typed literals (128_u32,
  0.0_f32). PHP-visible defaults are unchanged.
- PHP surface (ReflectionExtension dump of every class/method/param,
  before vs after): identical except that trailing `?array $options` /
  `?array $allowlist` parameters now report their `null` default
  (`isDefaultValueAvailable()` true) — the documented 0.16 fix that makes
  runtime arginfo match what the stubs already declared.
- cargo-php 0.2.1 stub generation: identical modulo fully-qualified
  `extends \Ns\Parent` (upstream #799).
- PHPTs: 11/11 turbovec, 7/7 whisper (real model), 15/15 infer (real
  chat + rerank models); clippy -D warnings clean.

thiserror 2.0.18 -> 2.0.21 is patch-level. RUST_CHANNEL stays 1.89:
nothing in the new graph raises the floor.
…docs

Managed:
- Makefile `stubs`: cargo-php has no `--stubs` flag (neither 0.1.21 nor
  0.2.1), so the target never worked. It now writes to target/ for a diff
  against the curated stubs/ file instead of overwriting it, and takes
  STUBS_PRELOAD for Linux, where cargo-php's dlopen() of the cdylib
  needs PHP's embed library to resolve Zend data symbols.

Seed (new renders only; sync never touches seeds):
- README.md: a Status section (feature-complete / maintained / last
  verified, link to `future` issues, co-maintainer invitation) instead
  of a pre-release badge; the stack table; a "Writing about this" slot.
- PLAN.md: design notes + decision history, remaining work in `future`
  issues — not a "what's left" list.
- CHANGELOG.md (Keep a Changelog); RELEASE.md uses the new stubs diff.

README: the Dependabot / versions.conf / upstream-watcher ownership
table and what was verified about Dependabot's directory scanning;
scheduled CI and its 60-day dormancy; ZTS legs; stubs. CI render smoke
now also asserts the README/PLAN/CHANGELOG/RELEASE seeds render.
ubuntu-latest moved to ubuntu-26.04, which preinstalls clang 20, 21 and
22 while libclang-dev pulls 21. Unpinned, clang-sys loads libclang 22
but the builtin headers come from LLVM 21, and clang 22 dropped x86
builtins those headers still call: ext-php-rs's build script fails with
"Unable to generate bindings for PHP" (xmmintrin.h __m128 errors).

Reproduced in an ubuntu:26.04 container with libclang 21 + 22
installed: ext-php-rs 0.15.13 and 0.16.3 fail identically, so this is
the runner image, not the 0.16 bump — every extension's main branch
would fail its next CI run too. Setting LIBCLANG_PATH/CLANG_PATH to
libclang-dev's LLVM fixes both. Applied after every Linux apt step in
ci.yml (lint, test) and release.yml (build); a no-op on 24.04-arm.
Keep a Changelog, backfilled from v0.1.0. Not tagged; the maintainer
tags after merge.
@ericmann
ericmann marked this pull request as ready for review October 29, 2026 17:01
@ericmann
ericmann merged commit df9f8d5 into main Oct 29, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant