Skip to content

docs: fix Bare, P2P and guide drift from the 2026-11-16 upstream sweep - #452

Merged
lucas-tortora merged 7 commits into
publishedfrom
docs/ci-sync-2026-11-16
Nov 16, 2026
Merged

lucas-tortora merged 7 commits into
publishedfrom
docs/ci-sync-2026-11-16

Conversation

@lucas-tortora

@lucas-tortora lucas-tortora commented Nov 16, 2026 •

Copy link
Copy Markdown

Summary

The scheduled watcher workflows only exist on published, so GitHub never schedules them (the default branch is main). This PR is the result of running every upstream-sync script by hand on 2026-11-16 and fixing what they found, so the Bare and P2P references and the how-to guides match upstream again.

Bare references (10 pages regenerated with gen:bare-refs)

  • bare-bundle 1.12.0, bare-fetch 3.5.0, bare-pack 3.2.0, bare-ws 3.3.0, bare-buffer 3.7.2, bare-inspect 3.1.11, bare-url 2.5.7, bare-stow 0.3.9.
  • bare-tls and bare-https move to the 4.0.0 majors, with an "Upgrading from 3.x" callout for the renamed handshake events (secureConnect, secureConnection, tlsClientError) and the new handshakeTimeout option.
  • bare-stow documents the engine target option, bare-pack the module type recorded in the bundle, and bare-buffer and bare-inspect their threat-model section (layout sections.json, absolute links).

P2P references (8 pages re-audited against the upstream diffs and repinned)

  • hypercore 11.40.4, hyperdht 6.36.0, autobee 2.13.6, blind-peer 3.18.3, blind-peering 2.14.0, compact-encoding 3.7.0, hrpc 4.3.2, protomux 3.13.1.

Guides, snapshots and reference fixes

  • GitHub Actions reference: create-release was renamed create-github-release and publish is now an alias of publish-npm (this also fixes the broken link). The Pear CLI reference mentions npx pear-install --arch.
  • hello-pear-react-native now inlines its worker and needs npm run link; the template page, the shared worker callout and the Electron integration guide say so.
  • watch-boilerplates.yml pins re-pinned for 7 snapshots, plus refreshed vendored lockfiles for hello-pear-bare, hello-pear-daemon and hello-pear-qvac-tui.

CI

  • examples.yml now installs bare-runtime@1.37.1 (was 1.34.1). The refreshed hello-pear-bare and hello-pear-daemon lockfiles resolve a bare-module that requires Bare >=1.35.0, so both scenarios failed with UNSUPPORTED_ENGINE on the old pin. All twelve scenarios the matrix runs pass on 1.37.1 locally.

Changelogs

  • Bare v1.36.1 and v1.36.2, pear-install v1.6.0, and one curated P2P entry (hypercore, hyperdht, autobee, compact-encoding, corestore, protomux, blind-peering, blind-peer). The watcher's draft entries for Bare 1.37.x and 1.36.0 were dropped because they were already curated.
  • Watcher baselines in scripts/upstream-releases-state.json and scripts/upstream-commits-state.json are advanced. The bare-runtime commit baseline stays at d9288e3 on purpose: bare main has an unreleased "Remove deprecated APIs (Update bare reference #174)" commit after v1.37.1.

Not covered

  • regenerate-references.yml was not run: it is disabled on purpose and would regress the committed models.
  • check:pear-refs fails with ENOENT on generated/pear-refs. That was already broken on published.
  • check:external-links reports the Google Play help link as 404, but it returns 200 with curl, so it looks like a false positive.

Test plan

  • check:upstream-pins: 96 current, 0 drift (10 pages have no pin yet)
  • check:bare-refs, test:bare-refs, check:bare-c-api, refs:curated:check
  • check:internal-links, check:cross-links, check:doctypes, check:includes, check:code-imports, check:examples:lint, check:docs-versions, check:workers-in-sync
  • vale --minAlertLevel=error content, npm run types:check
  • full npm run build plus check:redirects, check:agent-ready, check:seo
  • test:examples for hello-pear-bare, hello-pear-daemon, hello-pear-qvac-tui

🤖 Generated with Claude Code

lucas-tortora and others added 5 commits November 16, 2026 13:06
Regenerates bare-bundle 1.12.0, bare-fetch 3.5.0, bare-pack 3.2.0, bare-ws 3.3.0,
bare-buffer 3.7.2, bare-inspect 3.1.11, bare-url 2.5.7, bare-stow 0.3.9 and the
3.x to 4.0.0 majors bare-tls and bare-https.

The bare-tls and bare-https pages carry an "Upgrading from 3.x" callout for the
renamed handshake events (`secureConnect`, `secureConnection`, `tlsClientError`)
and the new `handshakeTimeout` option. bare-stow documents the `engine` target
option, bare-pack the module type recorded in the bundle, and bare-buffer and
bare-inspect their new threat-model section.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Re-pins the seven watched boilerplates and refreshes the vendored lockfiles of
hello-pear-bare, hello-pear-daemon and hello-pear-qvac-tui. hello-pear-react-native
now inlines its worker and needs `npm run link`, so the template page, the shared
worker callout and the Electron integration guide say so.

The GitHub Actions reference follows upstream: `create-release` became
`create-github-release` and `publish` is an alias of `publish-npm`. The Pear CLI
reference mentions `npx pear-install --arch`.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…tries

The P2P releases are left for their own change, so their watcher baselines stay behind.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
…ith upstream

Re-audits hypercore 11.40.4, hyperdht 6.36.0, autobee 2.13.6, blind-peer 3.18.3,
blind-peering 2.14.0, compact-encoding 3.7.0, hrpc 4.3.2 and protomux 3.13.1
against the upstream diffs and repins them. Adds one curated "P2P module updates"
changelog entry covering hypercore, hyperdht, autobee, compact-encoding, corestore,
protomux, blind-peering and blind-peer, and advances the watcher baselines.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
# Conflicts:
#	scripts/upstream-releases-state.json
@kinsta

kinsta Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

Preview deployments for pear-docs preview ⚡️

Status Branch preview Commit preview
🔁 Deploying... N/A N/A

Commit: ef9a68c890b73087e77f4e3972b37297bfd02eb8

Deployment ID: 0baf66b3-4a1c-452d-85e7-27c792c58a71

Static site name: pear-docs-preview-iimt7

@kinsta

kinsta Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

Preview deployments for pear-docs published ⚡️

Status Branch preview Commit preview
🔁 Deploying... N/A N/A

Commit: ef9a68c890b73087e77f4e3972b37297bfd02eb8

Deployment ID: 84d7c763-b503-4b4f-828d-40ed8949eee5

Static site name: pear-docs-published-i1yp5

…ints

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
The refreshed hello-pear-bare and hello-pear-daemon lockfiles resolve bare-worker
with a nested bare-module that requires Bare >=1.35.0, so both scenarios failed on
the pinned 1.34.1 with UNSUPPORTED_ENGINE. That is the condition the old comment
named for lifting the pin: hello-pear-bare resolving bare-worker 4.5.3 or later.

All twelve scenarios the matrix runs pass on bare-runtime 1.37.1 (hello-pear-qvac-tui
stays out of CI). The history that lived in the comment is in this message:
1.33.0 moved the resolver to bare-module v7, which bare-worker 4.4.0 can't use, so
the pin stayed on 1.32.0 until bare-worker 4.5.0, and on 1.34.1 until the lockfile
resolved bare-worker 4.5.3, which fails on 1.34.1 and passes on 1.35 and later.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@lucas-tortora
lucas-tortora merged commit 04ab8a1 into published Nov 16, 2026
32 checks passed
@lucas-tortora
lucas-tortora deleted the docs/ci-sync-2026-11-16 branch November 16, 2026 17:09
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