Skip to content

feat(docs): ship the package schema in the doc package - #1130

Merged
BryanFRD merged 1 commit into
mainfrom
feat/doc-package-schema
Sep 22, 2026
Merged

BryanFRD merged 1 commit into
mainfrom
feat/doc-package-schema

Conversation

@BryanFRD

Copy link
Copy Markdown
Contributor

Closes #1129

scripts/embed-release-data.js now copies schema/ferrflow-package.json to docs/site/data/package-schema.json next to schema.json, so @ferrflow/doc carries it and ferrflow.com can serve it at /schema/ferrflow-package.json. The file is committed now, generated by running the script, so the package already has it before the next release rewrites it.

Site side: FerrLabs/FerrFlow-Cloud#992, once a release carrying this is published.

@BryanFRD
BryanFRD enabled auto-merge (squash) September 22, 2026 08:11

@ferrfleet ferrfleet Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Correct as far as I can check. The committed docs/site/data/package-schema.json is byte-identical to schema/ferrflow-package.json (same blob 2508834d), docs/site/package.json has no files field and there is no .npmignore, so data/ ships with @ferrflow/doc the same way schema.json already does. https://ferrflow.com/schema/ferrflow-package.json is a 404 today while /schema/ferrflow.json is a 200, which is the gap this closes.

Nit: schema/manifest.json has $id: https://ferrflow.com/schema/manifest.json and that URL is also a 404, so a $schema pointing at it in a manifest file resolves to nothing. Same one-line fix, but it needs a matching route in FerrFlow-Cloud, so it is a separate change rather than something to bolt onto this one. Longer term I would iterate schema/*.json in embed-release-data.js and copy each under its own name instead of listing files with renamed targets: today every new schema needs an edit here plus a filename mapping on the site side, and that is the step that was missed.

Nit: nothing verifies the committed copies still match schema/ between releases. The published package is always right (the postBump hook re-copies before publish), so this is in-repo diff noise only, but a cmp of the two pairs in CI would catch a schema edit that forgets to rerun the script.

@BryanFRD
BryanFRD merged commit 2e20b2a into main Sep 22, 2026
31 checks passed
@BryanFRD
BryanFRD deleted the feat/doc-package-schema branch September 22, 2026 08:13
ferrflow Bot added a commit that referenced this pull request Sep 22, 2026
## [7.23.0] - 2026-09-22

### Features

- feat(docs): ship the package schema in the doc package (#1130)
- feat(schema): add a standalone schema for included package files (#1127)

### Bug Fixes

- fix(forge): detect SaaS forges from the remote host only, and ignore empty push tokens (#1132)
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.

Ship the package schema in @ferrflow/doc

1 participant