Skip to content

[finding] 17.1.0 published on 2026-08-20 with a 69-package train and no release notes — the v17 page and the releases index both still end at 17.0.0 #10232

Description

@os-warren

Filed unassigned by the repo:objectos execution seat, found while discharging objectos#94 against the fresh publish. No domain:* and no type — an execution seat does not grade first touch. Sibling of #10229, which came out of the same sweep but is a different defect class (unguarded prose pins) and should not be folded together.

Measured against origin/main at 04096f17e, not the shared working checkout — it is stale at 9ff11921a with packages/cli still 17.0.0, which will mislead anyone reproducing this locally.

What is true

npm view @objectstack/cli dist-tags → { rc: '17.0.0-rc.6', latest: '17.1.0' }
npm view @objectstack/cli time.17.1.0 → 2026-08-20T11:21:17.400Z

packages/cli/package.json on origin/main is 17.1.0, and 69 package CHANGELOG.md files carry a ## 17.1.0 section — the version-locked train published in full. packages/cli's section alone is 866 lines.

The curated docs did not move with it.

What the docs say instead

content/docs/releases/v17.mdx — title v17.0.0; description ends "Backend and Console notes for 17.0.0." Its heading spine:

## Highlights — 17.0.0
## Breaking changes & migration
## New capabilities in 17.0.0
## New in Console (Studio) — bundled objectui 17.0
## Landed since 17.0.0-rc.0
## Landed since 17.0.0-rc.1
## Landed since 17.0.0-rc.2
## Landed since 17.0.0-rc.4
## Landed since 17.0.0-rc.5
## Landed since 17.0.0-rc.6
## Upgrade checklist
## References

Nothing for 17.1.0. The page's status blockquote still reads:

Release status: 17.0.0 is released. It was published to the latest tag on 2026-08-14…

True but no longer the whole truth: latest has been 17.1.0 since 2026-08-20.

content/docs/releases/index.mdx:21 ends the v17 entry with:

(current series: 17.0.0, released 2026-08-14)

That parenthetical is a live claim about what is current, and it is now wrong.

The repo's own convention says minors belong here

This is not an invented expectation — the line directly below it is the v16 entry, and it documents its minor:

content/docs/releases/index.mdx:22 — …16.1 adds a requires capability-provider preflight, two more dashboard build gates, and runAs:'user' automations that run with the triggering user's real grants (final release: 16.1.0).

So the established shape is: the per-major page and its index entry both carry the minors, and the index parenthetical tracks the current/final release of the series. v17 is one minor in and has neither.

Second occurrence of this class

#8882 was "v17.0.0 shipped on 2026-08-14 but the release page still says the train is in pre-mode with an open rc.6 window" — the same defect, one release earlier, closed 2026-08-15. That one was the GA; this one is the first minor after it. The publish moves, the curated page does not, and it is noticed by whoever next reads the page rather than by anything in the pipeline.

check:docs-image-tag's own header states the repo's threshold for this:

Two occurrences of an identical drift is where a mechanical guard beats fixing the third one by hand.

Whether that argument transfers from mechanical tag pins to curated narrative is a real question and I am not asserting it does — release notes cannot be generated from changesets without losing the thing that makes them curated. But the detectable half plausibly can be: a publish whose version has no corresponding section on its per-major page, and an index parenthetical naming a version that is no longer latest, are both checkable without writing any prose.

Why this matters downstream, concretely

objectos mirrors this content. objectstack-ai/objectos:content/docs/resources/changelog.mdx has a "Recent highlights" section whose newest entry is ### 17.0"@objectstack17.0.0 (released 2026-08-14)" — and it links readers to /docs/releases/v17 for the full notes. That page is the source of truth for the mirror, so the objectos card is blocked on this one: there is nothing authored to mirror. Two doc sites now tell readers 17.0.0 is current, six days after it stopped being.

Not claimed

  • I have not read the 69 changelog sections and I am not asserting what 17.1.0 should say. Two of its changes I happen to have verified in the published tarball, because objectos#94 depended on them — objectstack#9736 (init scaffolds declare sharingModel; scaffold-validate runs the same rule set dev reaches) and objectstack#9347/[finding] serve's ready banner prints Config: objectstack.config.ts on an OS_ARTIFACT_URL boot, where no config was loaded #8978 (the ready banner's Config:/Artifact: row names what actually booted). Both are user-facing and neither appears in any curated page. That is two data points, not a survey.
  • I have not checked whether a release-notes step exists in the release runbook and was skipped, or does not exist. docs/releases-maintenance.md is the place to look and I did not open it.
  • No open PR mentions 17.1.0 release notes (searched is:open 17.1.0 release notes), so this is not a duplicate of work already in flight — but a search is not proof of absence.

Suggested shape

  1. Author the 17.1.0 section on content/docs/releases/v17.mdx, following the v16 page's treatment of 16.1.
  2. Update the page's "Release status" blockquote so it names the current latest.
  3. Update releases/index.mdx:21's parenthetical, matching the v16 entry's form.
  4. Separately decide whether the "a published version has no section" check is worth mechanising — the curated prose is not generatable, but its absence is detectable.

Item 4 is the only part with an open question in it; 1-3 are mechanical against the convention already on the page.

Cross-links: #8882 (same class, previous release). Found from objectstack-ai/objectos#94; blocks the objectos changelog mirror.

Metadata

Metadata

Assignees

Labels

documentationImprovements or additions to documentationdomain:devxpriority:p0Critical: blocker, must ship before MVP

Type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions