cf-orbs 0.2.2 → 0.2.3

package/README.md

@@ -70,7 +70,7 @@ What `init` does:
 amp -ox "hello from cf-orbs" --orb-provider <name>
 ```
 
-The name after `--orb-provider` must match the provider name in Amp Settings. In the Amp app, pick the provider under **Self-Hosted** when you start a thread.
+The name after `--orb-provider` must match the provider name in Amp Settings. The default name is `cloudflare`. A saved name from an earlier `init` wins. In the Amp app, pick the provider under **Self-Hosted** when you start a thread.
 
 `init` is safe to run again. It keeps the control token, and it keeps the Amp token secret unless you give a new one.
 
@@ -225,6 +225,10 @@ After `cf-orbs deploy`, an orb that is awake keeps the old Worker code until it
 
 `cf-orbs deploy` then starts `prewarm` throwaway instances in the background (`prewarm: started 2 instances in the background`); `cf-orbs status` shows how fast they were ready.
 
+### Back up
+
+Running orbs need nothing on your machine: the Worker, the orbs and the snapshots are in Cloudflare. Back up `cf-orbs.config.jsonc` and `image/` (a private git repo is enough; the `.gitignore` that `init` writes keeps the control token out). Keep the Amp provider token in a password manager if you want to restore without making a new one. The control token can be made again. See [Back up and restore](https://cf-orbs-site.mdick85.workers.dev/docs/guides/back-up-and-restore/).
+
 ## Troubleshooting
 
 Run `cf-orbs doctor` first.
@@ -275,7 +279,7 @@ To report a vulnerability, see [SECURITY.md](https://github.com/meirdick/cf-orbs
 
 ## Status and known gaps
 
-v0.2.2. The control plane, dispatch program, provider host and CLI are built and unit tested. On 2026-10-30 a real Amp thread ran end to end on a fresh install: spawn from the image, setup, pause with a project snapshot, wake from the snapshot in 2.3 s, first answer 41 s after the message.
+v0.2.3. The control plane, dispatch program, provider host and CLI are built and unit tested. On 2026-10-30 a real Amp thread ran end to end on a fresh install: spawn from the image, setup, pause with a project snapshot, wake from the snapshot in 2.3 s, first answer 41 s after the message.
 
 Known gaps:
 

package/dist/commands/init.js

@@ -22,6 +22,8 @@ export const SELFTEST_WAIT_MS = 180_000;
 /** Provider must stay up this long with no reject, no second-provider line and no restart. */
 export const PROVIDER_STABLE_MS = 15_000;
 const CRON_PERIOD_MS = 5 * 60_000;
+/** One line at the end of a successful init, before the amp command. */
+export const BACKUP_LINE = "back up: cf-orbs.config.jsonc and image/. Guide: https://cf-orbs-site.mdick85.workers.dev/docs/guides/back-up-and-restore/";
 export function helloCommand(providerName) {
     return `amp -ox "hello from cf-orbs" --orb-provider ${providerName}`;
 }
@@ -340,8 +342,7 @@ export async function runInit(ctx, o, steps) {
                 break;
             case "amp-token":
                 // No interactive name question here: say so if the name is a fallback, not given
-                if (s.source !== "prompt" &&
-                    (o.providerNameSource === "config" || o.providerNameSource === "default"))
+                if (s.source !== "prompt" && o.providerNameSource === "default")
                     ui.warn(`provider name ${providerName} was not given explicitly; it must match the name in Amp Settings → Orbs (pass --provider-name <name> if it differs)`);
                 if (s.source === "env")
                     ampToken = checkAmpToken(ctx, (ctx.env.AMP_ORB_PROVIDER_TOKEN ?? "").trim());
@@ -580,6 +581,7 @@ export async function runInit(ctx, o, steps) {
             case "done":
                 command = s.command === helloCommand(o.providerName) ? helloCommand(providerName) : s.command;
                 ui.step(`provider name ${providerName} must match the name in Amp Settings → Orbs`);
+                ui.out(BACKUP_LINE);
                 break;
         }
     }
@@ -745,6 +747,8 @@ export function parseVcpuFlag(v) {
         throw new CliError(`--vcpu must be 1, 2, 3 or 4, got ${JSON.stringify(v)}`, "pass --vcpu 4 (default, 12 GiB) or --vcpu 2 (6 GiB, about half the cost)");
     return Number(v);
 }
+/** Default Amp provider name when none is given. The Worker name default is separate: cf-orbs. */
+export const DEFAULT_PROVIDER_NAME = "cloudflare";
 const WORKER_NAME_RE = /^[a-z0-9][a-z0-9-]{0,62}$/;
 export function initOptions(ctx, existing) {
     const modeFlag = flagString(ctx.args, "provider");
@@ -768,17 +772,14 @@ export function initOptions(ctx, existing) {
         providerName: flagString(ctx.args, "provider-name") ??
             ctx.env.AMP_ORB_PROVIDER_NAME ??
             existing?.providerName ??
-            existing?.name ??
-            "cf-orbs",
+            DEFAULT_PROVIDER_NAME,
         providerNameSource: flagString(ctx.args, "provider-name") !== undefined
             ? "flag"
             : ctx.env.AMP_ORB_PROVIDER_NAME !== undefined
                 ? "env"
                 : existing?.providerName !== undefined
                     ? "saved"
-                    : existing?.name !== undefined
-                        ? "config"
-                        : "default",
+                    : "default",
     };
 }
 export async function initCommand(ctx) {

package/dist/index.js

@@ -30,7 +30,7 @@ export const COMMANDS = {
             "--provider cloudflare|external   where amp orb provider runs (default cloudflare)",
             "--token-file <file>              Amp provider token file (else AMP_ORB_PROVIDER_TOKEN, else prompt)",
             "--account-id <id>                Cloudflare account (else CLOUDFLARE_ACCOUNT_ID, else ask)",
-            "--provider-name <name>           Amp provider name, as in Amp Settings → Orbs (else AMP_ORB_PROVIDER_NAME, saved name, config name, then cf-orbs)",
+            "--provider-name <name>           Amp provider name, as in Amp Settings → Orbs (default cloudflare; AMP_ORB_PROVIDER_NAME or a saved name wins)",
             "--subdomain <name>               workers.dev subdomain to register if the account has none",
             "--vcpu <1|2|3|4>                 orb size: N vCPU, N x 3 GiB, 20 GB disk (default 4; 2 is cheaper)",
             "--name <name>                    Worker name (default cf-orbs; a second install needs another)",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cf-orbs",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Run Amp orbs on Cloudflare Containers: self-hosted orb provider, one command to install.",
   "license": "Apache-2.0",
   "type": "module",

package/templates/worker/src/api.ts

@@ -18,7 +18,7 @@ import { type Env, orbDoName, PROVIDER_DO_NAME, REGISTRY_DO_NAME } from "./env";
 import { BENCH_ORB_RE, type BenchStartRequest, parseBenchStart } from "./orb/bench";
 import { restartProvider } from "./provider-restart";
 
-export const API_VERSION = "0.2.2";
+export const API_VERSION = "0.2.3";
 
 /** D2. Amp sends `amp-<thread id>`. Never starts with `_` or `.`, so it cannot look like an internal name. */
 export const ORB_ID_RE = /^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$/;