Skip to content

docs: regenerate references from current spec#1908

Merged
os-zhuang merged 1 commit into
mainfrom
docs/regenerate-references
Jun 15, 2026
Merged

docs: regenerate references from current spec#1908
os-zhuang merged 1 commit into
mainfrom
docs/regenerate-references

Conversation

@os-zhuang

Copy link
Copy Markdown
Contributor

Closes the references-drift follow-up flagged in #1904. The committed content/docs/references/** (auto-generated from packages/spec, DO-NOT-EDIT) had fallen out of sync with the schemas — running gen:docs produced diffs across 18 generated files plus 3 that were missing entirely.

What regenerated

  • 18 updated generated docs/meta — including spec additions like UserFilters / UserFilterField view config and the chart visualization enum value.
  • 3 newcontracts/ reference group, and system/book.mdx + system/doc.mdx (the ADR-0046 package-doc doc/book protocols).

Scope & safety

  • Generated output only. No hand-written docs, no package code touched — diff is entirely under content/docs/references/.
  • Reproducible: pnpm --filter @objectstack/spec gen:schema && pnpm --filter @objectstack/spec gen:docs (idempotent — re-running produces no further diff).
  • next build compiles all 1113 pages clean (exit 0).

This only realigns the generated docs with the spec. Where the spec itself diverges from runtime behavior, that's the separate metadata-liveness remediation track, not this PR.

🤖 Generated with Claude Code

The committed content/docs/references/** had drifted from packages/spec —
running `gen:docs` produced diffs across 18 generated files and 3 missing ones
(contracts/, system/book.mdx, system/doc.mdx for newly-added spec types). This
regenerates them so the generated reference docs match the schemas again.

Spec additions now reflected: UserFilters/UserFilterField view config, the
`chart` visualization enum value, the ADR-0046 doc/book package-doc protocols,
and the contracts reference group.

Generated output only (DO-NOT-EDIT files) — no hand-written docs or package code
touched. `next build` compiles all 1113 pages clean.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 15, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Ready Ready Preview, Comment Jun 15, 2026 11:38am

Request Review

@github-actions github-actions Bot added documentation Improvements or additions to documentation tooling size/l and removed documentation Improvements or additions to documentation tooling labels Jun 15, 2026
@os-zhuang
os-zhuang merged commit 3642509 into main Jun 15, 2026
13 checks passed
@os-zhuang
os-zhuang deleted the docs/regenerate-references branch June 15, 2026 11:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant