Skip to content

changelog.mdx "Recent highlights" still ends at 17.0 six days after 17.1.0 published — blocked on upstream notes existing #142

Description

@os-warren

Blocked-by: objectstack-ai/objectstack#10232

Filed by the repo:objectos seat while discharging #94 against the @objectstack/cli@17.1.0 publish. Deliberately not dispatched — the upstream it mirrors has not been authored yet.

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

69 @objectstack/* packages carry a ## 17.1.0 changelog section — a full version-locked train publish.

content/docs/resources/changelog.mdx on origin/main:

57: ### 17.0
59: `@objectstack` **17.0.0** (released 2026-08-14) is a truth-telling

That is the newest entry under a heading that reads "Recent highlights", and the section links readers to /docs/releases/v17 for the full notes.

Why this is blocked rather than queued

The page is a mirror with a named source: it points at docs.objectstack.ai/docs/releases/v17 for the authoritative notes. Upstream, that page has no 17.1.0 section at all — its heading spine ends at ## Landed since 17.0.0-rc.6, and releases/index.mdx still calls 17.0.0 the current series. objectstack#10232 records this with the measurements.

So there is nothing authored to mirror. A dev could read the 69 generated changelogs and compose an ObjectOS-side highlight independently, and that is exactly what this card must not ask for: it would make objectos the de-facto author of the platform's release narrative, drifting from the page it tells readers is the source of truth, and it would mean writing a summary nobody upstream has ratified. The mirror follows; it does not lead.

Unblocks the moment objectstack#10232 lands a 17.1.0 section.

Scope when it unblocks

Only the live claims move. The sweep below distinguishes them from the historical ones, because this page and the corpus around it carry both and the difference decides which lines may be touched:

Live — moves:

  • changelog.mdx:57-59 — the ### 17.0 entry under "Recent highlights". Needs a ### 17.1 entry; "recent" is a claim about now.

Historical — must NOT be touched. A sweep of content/docs (excluding quickstart.mdx, in flight on #94) for version-shaped claims returns eleven more hits and every one of them is a fact about when a behaviour changed, which stays true forever:

build/automation/approvals.mdx:140,142     Dynamic routing … (17.0)
configure/data-sources.mdx:114             Since ObjectStack 17.0 an unreachable datasource …
configure/permissions/permission-sets.mdx:60   Since ObjectStack 17.0 it means …
configure/permissions/record-access.mdx:73     since ObjectStack 17.0:
deploy/docker.mdx:122                      since ObjectStack 17.0 …
deploy/kubernetes.mdx:42                   Since ObjectStack 17.0 readiness …
operate/backup.mdx:136                     Since ObjectStack 17.0 this …
reference/runtime-capabilities.mdx:78      ObjectStack 17.0 — the endpoint had never …
resources/faq.mdx:40                       ObjectStack 17.0 — it had never been …
resources/changelog.mdx:26                 engines.node … since 17.0

Upstream ran into the same distinction from the other side: check:docs-image-tag's surfaces are enumerated rather than globbed precisely because content/docs/** is full of "removed in 17.0.0" sentences that must never track the CLI version. The same reasoning governs this page — a bulk version bump here would corrupt ten true sentences to update one.

Not swept: *.<locale>.mdx derived translations are excluded, per docs/TRANSLATION.md — English is the only authored language and translations are written by the translation account. The sweep's pathspec was verified with a control probe (files directly in content/docs are reached, not only nested ones — a pathspec of the form content/docs/**/*.mdx silently skips the top level).

Back-links: #94, #141.

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions