docs(fast-deploy): operator-owned CI (webhook → Decofile CR → Job)#301
Merged
Conversation
![cubic-dev-ai[bot]](https://avatars.githubusercontent.com/in/1082092?s=60&v=4){kind=small}
…→ Job) Rewrite the cross-repo contracts section: content sync to KV is driven by a git webhook handled entirely by the deco operator (DeploymentTarget → Decofile CR → tanstack-kv FastDeployment → self-cleaning Job), not studio/GitHub Actions/admin. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
hugo-ccabral
force-pushed
the
feat/fast-deploy-docs-operator-flow
branch
from
4f80248 to
b6d59a3
Compare
nicacioliveira
approved these changes
Jul 2, 2026
|
🎉 This PR is included in version 6.26.0 🎉 The release is available on:
Your semantic-release bot 📦🚀 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Updates the
docs/fast-deploy.mdcross-repo contracts section to reflect the finalized fast-deploy CI design: content sync to KV is git-webhook driven and handled entirely by the deco operator — no studio, no GitHub Actions, no admin.New flow documented:
git push (.deco/blocks/** only)→ operatorPOST /webhooks/github→DeploymentTarget(cloudflare-workers) creates aDecofileCR (target: tanstack-kv) →FastDeployment(tanstack-kv) creates a self-cleaning Job runningdeco-sync-blocks-to-kv→ Cloudflare KV.Also notes why the sync must run the TS script (byte-identical
djb2(JSON.stringify(blocks))revision) rather than a re-implementation, and updates the rollout step to theDecoCRfastDeploygate + GitHub webhook.Scope
Docs only. The runtime (
kvHydration.ts,kvBlockSource.ts), thedeco-sync-blocks-to-kvscript, and the Studio write-through path are unchanged.Base is
feat/fast-deploy-5-docs(this doc describes that branch's KV work).🤖 Generated with Claude Code
Summary by cubic
Update fast-deploy docs to the operator-owned CI: a push touching
.deco/blocks/**hits the operator webhook →DeploymentTargetcreates aDecofileCR →FastDeploymentspawns a short‑lived Job that runsdeco-sync-blocks-to-kvto write Cloudflare KV (no Studio/GitHub Actions/admin; Studio live‑edit unchanged). Clarifies the TS script is required to produce a byte‑identicaldjb2Hex(JSON.stringify(blocks))revision, and updates rollout to use theDecoCRfastDeploygate plus a GitHub webhook.Written for commit b6d59a3. Summary will update on new commits.