CLI
New cello commands and flags — deploy, invoke, d1, r2, versions, dev state — over upstream denoland/celld.
New commands, flags, and output shapes in the cello CLI. Each entry
names its fork patch number. Run cello --help and cello <cmd> --help
for the complete surface.
Deploy and release
0012—cello deploy --sourcemap PATHwrites the bundled Worker’s external source map to a local file: the esbuild run adds--sourcemap=external, so the deployed module bytes are byte-identical with or without the flag, and the map’ssourcesare rebased to project-root-relative paths. Only the bundled JS entry is mapped; asset-only and Python projects warn and write nothing.0047—--sourcemapcollects theno_bundleentry’s sibling<entry>.map: the entry deploys as written, and the sibling (which must be a regular non-symlink file under 64 MiB of v3 JSON inside the project tree) never fails the deploy — anything else warns and writes nothing, withsourcesrebased lexically so the map cannot probe which host files exist.0046—cello --versionreports the full build version (0.2.0,<version>-ryuzcorp.<n>on the old line):build.rsbakesCELLO_VERSIONinto the binary from the Docker build stage, and a plaincargo buildwithout it reports the crate version.0049—cello invoke --header-env NAME=VARsends header NAME with the value of environment variable VAR, so a secret header never sits on argv where every local user reads/proc/<pid>/cmdline. An unset variable is refused without echoing anything.0120— Container image tars upload multipart — 8 MiB parts, each on its own request — instead of one PUT under the 30 s single-try timeout, so GB-scale images stop failing deterministically (upstream #307).0123—cello versions [SCRIPT]lists deployed versions from one LIST ofdeploy/<script>/<version>/manifest.json, marking the serving generation current from the fleet-wide pointer — the top-level version, staged components, and, under a pointer without a components map, every named-pointer service version — with an optionalSCRIPTnarrowing the rows (upstream #181).
D1, KV, and R2
0017—cello r2 listtakes--delimiterand, with--page, prints one page — decoded keys withhttpMetadataandcustomMetadata, plusdelimitedPrefixes,truncated, andcursor— through the same listing the R2 binding calls. A truncated listing continues with--cursor(--aftercan omit keys on non-UTF-8-safe orderings).--jsonkeeps the one-record-per-line output.0022—cello d1 exportwrites a consistent SQL dump: the owner node reads schema beside data under one transaction, streams schema and rows against a 32 MiB budget, skips generated columns, carries NUL and invalid-UTF-8 TEXT byte-exact, and rebuilds fts5/virtual tables without their shadows.--table(repeatable),--no-schema, and--no-datanarrow it. Export is operator-only: stub fetch to a D1 scope answers only the query/batch/exec branches behind a host-set operator-ingress marker.0023—cello d1 execute --batch --jsonreads a JSON array of statements from stdin and runs it as one transactional batch — the same implementation the Worker’sbatch()uses — printing one JSON array shaped as the Worker’sbatch()shapes it.0024—cello d1 exportscopes eachsqlite_sequencereset to its own counter, so a filtered or data-only dump replayed into an existing database no longer clears the AUTOINCREMENT counters of tables the dump does not name.0044—cello r2 headandcello r2 getwith--jsonprint{"error":"not_found","bucket":…,"key":…}on stdout for an absent key, so callers match theerrorfield instead of substring-matching the English message. Human message on stderr and exit code unchanged.0121—cello d1 execute,export, and migrations take--localto run against the runningcello devinstead of the fleet: the dev node’s local store carries its leases and secret like a fleet bucket.--localresolves the project through the canonical config and opensPROJECT/.cello/dev(following the--state/CELLO_DEV_STATEoverride). Combining it with--bucket/--endpoint(orCELLO_BUCKET) is refused, so migrations can never run against the wrong database by a silent bucket choice.d1also takes--state DIR;--statewithout--localis refused (upstream #272).
Local development
0020—cello dev --port 0assigns an ephemeral port: the node binds it and the supervisor learns the address from the node’s own announce line, so parallel boots never race on a probed-free port.0124—cello dev --state DIR(orCELLO_DEV_STATE, defaultPROJECT/.cello/dev) keeps local state outside the project, where backups and search tools pick it up.--cleanover an explicit directory deletes only when the marker proves Cello created it, and--staterefuses to adopt a non-empty foreign dir (upstream #302).