Skip to content

feat(docs): put cloudhal.dev live with schemas, /fetch and docs redirects - #33

Merged
Madraka merged 1 commit into
mainfrom
feat/cloudhal-dev-stopgap
Oct 20, 2026
Merged

Madraka merged 1 commit into
mainfrom
feat/cloudhal-dev-stopgap

Conversation

@Madraka

@Madraka Madraka commented Oct 20, 2026

Copy link
Copy Markdown
Contributor

cloudhal.dev had no DNS, while the 13 npm packages' homepage, cloudhal.com, the schemas' $ids and the fetcher's User-Agent all link to it. This adds apps/docs, the Worker behind cloudhal.dev (already deployed from this branch):

  • /schemas/v1/*.schema.json at their permanent $id URLs (application/schema+json, CORS, 1 h cache) and /schemas/v1/index.json; the build fails if an $id does not match.
  • /fetch: what Cloudhal-Fetch/1 requests and how to block or report it (RFC-0004 §5.7).
  • /llms.txt for agents.
  • /docs, /docs/deploy and /docs/guides/<name>: temporary 302s to the docs on GitHub, until the Starlight docs site (next RFC) replaces them in the same Worker.

ADR-0037: the "serve the schemas" consequence is ticked.

🤖 Generated with Claude Code

…ects

apps/docs is the cloudhal.dev Worker (static assets, ADR-0037). Until
the Starlight docs site lands it serves:
- the 21 JSON Schemas at their permanent $id URLs (/schemas/v1/*,
  application/schema+json, CORS) plus an index.json;
- /fetch, the page the Cloudhal-Fetch/1 user agent links to;
- /llms.txt;
- 302s from /docs, /docs/deploy and /docs/guides/<name> to GitHub.

The build fails when a schema's $id is not its URL there.

Co-Authored-By: Claude Opus 5.5 <[email protected]>
Signed-off-by: Madraka <[email protected]>
@Madraka
Madraka merged commit 483e8db into main Oct 20, 2026
5 checks passed
@Madraka
Madraka deleted the feat/cloudhal-dev-stopgap branch October 21, 2026 11:33
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