@quonfig/cli 0.0.58 → 0.0.59

package/README.md

@@ -17,7 +17,7 @@ $ npm install -g @quonfig/cli
 $ qfg COMMAND
 running command...
 $ qfg (--version)
-@quonfig/cli/0.0.58 linux-x64 node-v24.4.1
+@quonfig/cli/0.0.59 linux-x64 node-v24.4.1
 $ qfg --help [COMMAND]
 USAGE
   $ qfg COMMAND
@@ -201,7 +201,7 @@ EXAMPLES
   $ qfg activity restore my.flag --yes
 ```
 
-_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/activity.ts)_
+_See code: [src/commands/activity.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/activity.ts)_
 
 ## `qfg activity deleted`
 
@@ -230,7 +230,7 @@ EXAMPLES
   $ qfg activity deleted --json
 ```
 
-_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/activity/deleted.ts)_
+_See code: [src/commands/activity/deleted.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/activity/deleted.ts)_
 
 ## `qfg activity feed`
 
@@ -265,7 +265,7 @@ EXAMPLES
   $ qfg activity feed --json
 ```
 
-_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/activity/feed.ts)_
+_See code: [src/commands/activity/feed.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/activity/feed.ts)_
 
 ## `qfg activity history [NAME]`
 
@@ -299,7 +299,7 @@ EXAMPLES
   $ qfg activity history request.timeout --json
 ```
 
-_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/activity/history.ts)_
+_See code: [src/commands/activity/history.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/activity/history.ts)_
 
 ## `qfg activity restore [NAME]`
 
@@ -338,7 +338,7 @@ EXAMPLES
   $ qfg activity restore request.timeout --type config --yes
 ```
 
-_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/activity/restore.ts)_
+_See code: [src/commands/activity/restore.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/activity/restore.ts)_
 
 ## `qfg audit-log [NAME]`
 
@@ -366,7 +366,7 @@ EXAMPLES
   $ qfg audit-log my.flag
 ```
 
-_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/audit-log.ts)_
+_See code: [src/commands/audit-log.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/audit-log.ts)_
 
 ## `qfg cleanup`
 
@@ -407,7 +407,7 @@ EXAMPLES
   $ qfg cleanup status my.flag.key
 ```
 
-_See code: [src/commands/cleanup.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/cleanup.ts)_
+_See code: [src/commands/cleanup.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/cleanup.ts)_
 
 ## `qfg cleanup list`
 
@@ -453,7 +453,7 @@ EXAMPLES
   $ qfg cleanup list --json
 ```
 
-_See code: [src/commands/cleanup/list.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/cleanup/list.ts)_
+_See code: [src/commands/cleanup/list.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/cleanup/list.ts)_
 
 ## `qfg cleanup remove [NAME]`
 
@@ -498,7 +498,7 @@ EXAMPLES
   $ qfg cleanup remove my.flag.key --json
 ```
 
-_See code: [src/commands/cleanup/remove.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/cleanup/remove.ts)_
+_See code: [src/commands/cleanup/remove.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/cleanup/remove.ts)_
 
 ## `qfg cleanup status [NAME]`
 
@@ -538,7 +538,7 @@ EXAMPLES
   $ qfg cleanup status my.flag.key --json
 ```
 
-_See code: [src/commands/cleanup/status.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/cleanup/status.ts)_
+_See code: [src/commands/cleanup/status.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/cleanup/status.ts)_
 
 ## `qfg cleanup verify [NAME]`
 
@@ -584,7 +584,7 @@ EXAMPLES
   $ qfg cleanup verify my.flag.key && qfg delete my.flag.key
 ```
 
-_See code: [src/commands/cleanup/verify.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/cleanup/verify.ts)_
+_See code: [src/commands/cleanup/verify.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/cleanup/verify.ts)_
 
 ## `qfg config-schema`
 
@@ -613,7 +613,7 @@ EXAMPLES
   $ qfg config-schema --json-schema    # full JSON Schema document (copy into your editor)
 ```
 
-_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/config-schema.ts)_
+_See code: [src/commands/config-schema.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/config-schema.ts)_
 
 ## `qfg create NAME`
 
@@ -700,7 +700,7 @@ EXAMPLES
   $ qfg set-rollout my.new.flag --environment production --true-percent 20
 ```
 
-_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/create.ts)_
+_See code: [src/commands/create.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/create.ts)_
 
 ## `qfg delete NAME`
 
@@ -746,7 +746,7 @@ EXAMPLES
   $ qfg delete my.config --yes
 ```
 
-_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/delete.ts)_
+_See code: [src/commands/delete.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/delete.ts)_
 
 ## `qfg flag info [NAME]`
 
@@ -950,7 +950,7 @@ EXAMPLES
   $ qfg generate --targets node-ts -o ./dist # combine with targets
 ```
 
-_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/generate.ts)_
+_See code: [src/commands/generate.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/generate.ts)_
 
 ## `qfg generate-new-hex-key`
 
@@ -973,7 +973,7 @@ EXAMPLES
   $ qfg generate-new-hex-key
 ```
 
-_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/generate-new-hex-key.ts)_
+_See code: [src/commands/generate-new-hex-key.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/generate-new-hex-key.ts)_
 
 ## `qfg get [NAME]`
 
@@ -1005,7 +1005,7 @@ EXAMPLES
   $ qfg get my.config.name --environment=production
 ```
 
-_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/get.ts)_
+_See code: [src/commands/get.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/get.ts)_
 
 ## `qfg history NAME`
 
@@ -1031,7 +1031,7 @@ EXAMPLES
   $ qfg history my.flag
 ```
 
-_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/history.ts)_
+_See code: [src/commands/history.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/history.ts)_
 
 ## `qfg info [NAME]`
 
@@ -1079,7 +1079,7 @@ EXAMPLES
   $ qfg info my.config.name --exclude-evaluations   # skip 24h stats
 ```
 
-_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/info.ts)_
+_See code: [src/commands/info.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/info.ts)_
 
 ## `qfg init [DIRECTORY]`
 
@@ -1119,7 +1119,7 @@ EXAMPLES
   $ qfg init --dry-run
 ```
 
-_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/init.ts)_
+_See code: [src/commands/init.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/init.ts)_
 
 ## `qfg interactive`
 
@@ -1149,7 +1149,7 @@ EXAMPLES
   $ qfg
 ```
 
-_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/interactive.ts)_
+_See code: [src/commands/interactive.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/interactive.ts)_
 
 ## `qfg list`
 
@@ -1189,7 +1189,7 @@ EXAMPLES
   $ qfg list --feature-flags
 ```
 
-_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/list.ts)_
+_See code: [src/commands/list.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/list.ts)_
 
 ## `qfg log`
 
@@ -1214,7 +1214,7 @@ EXAMPLES
   $ qfg log --limit 5
 ```
 
-_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/log.ts)_
+_See code: [src/commands/log.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/log.ts)_
 
 ## `qfg log-level NAME`
 
@@ -1279,7 +1279,7 @@ EXAMPLES
   $ qfg log-level log-level.my-app --target=Chatty --value=INFO --environment=production
 ```
 
-_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/log-level.ts)_
+_See code: [src/commands/log-level.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/log-level.ts)_
 
 ## `qfg login`
 
@@ -1304,7 +1304,7 @@ EXAMPLES
   $ qfg login --profile myprofile
 ```
 
-_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/login.ts)_
+_See code: [src/commands/login.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/login.ts)_
 
 ## `qfg logout`
 
@@ -1327,7 +1327,7 @@ EXAMPLES
   $ qfg logout
 ```
 
-_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/logout.ts)_
+_See code: [src/commands/logout.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/logout.ts)_
 
 ## `qfg migrate`
 
@@ -1390,7 +1390,7 @@ EXAMPLES
   $ qfg migrate --from launch --source-api-key $LAUNCH_API_KEY --dir ./quonfig-repo --staging
 ```
 
-_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/migrate.ts)_
+_See code: [src/commands/migrate.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/migrate.ts)_
 
 ## `qfg migrate doctor`
 
@@ -1428,7 +1428,7 @@ EXAMPLES
   $ qfg migrate doctor --json
 ```
 
-_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/migrate/doctor.ts)_
+_See code: [src/commands/migrate/doctor.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/migrate/doctor.ts)_
 
 ## `qfg migrate my-code`
 
@@ -1460,7 +1460,7 @@ EXAMPLES
   $ qfg migrate my-code --dry-run
 ```
 
-_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/migrate/my-code.ts)_
+_See code: [src/commands/migrate/my-code.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/migrate/my-code.ts)_
 
 ## `qfg migrate status`
 
@@ -1491,7 +1491,7 @@ EXAMPLES
   $ qfg migrate status --json
 ```
 
-_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/migrate/status.ts)_
+_See code: [src/commands/migrate/status.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/migrate/status.ts)_
 
 ## `qfg override [NAME] [VALUE]`
 
@@ -1546,7 +1546,7 @@ EXAMPLES
   $ qfg override my.flag true --env=staging
 ```
 
-_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/override.ts)_
+_See code: [src/commands/override.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/override.ts)_
 
 ## `qfg pull`
 
@@ -1594,7 +1594,7 @@ EXAMPLES
   $ qfg pull  # uses QUONFIG_DIR env var
 ```
 
-_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/pull.ts)_
+_See code: [src/commands/pull.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/pull.ts)_
 
 ## `qfg push`
 
@@ -1643,7 +1643,7 @@ EXAMPLES
   $ qfg push --dir ./our-config --yes
 ```
 
-_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/push.ts)_
+_See code: [src/commands/push.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/push.ts)_
 
 ## `qfg run [COMMAND]`
 
@@ -1694,7 +1694,7 @@ EXAMPLES
   $ qfg run --env DATABASE_URL=db.url --preserve-env --environment=staging -- npm test
 ```
 
-_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/run.ts)_
+_See code: [src/commands/run.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/run.ts)_
 
 ## `qfg schema NAME`
 
@@ -1732,7 +1732,7 @@ EXAMPLES
   $ qfg schema my-schema --set-json-schema=@schemas/my-schema.json --protected
 ```
 
-_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/schema.ts)_
+_See code: [src/commands/schema.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/schema.ts)_
 
 ## `qfg sdk-key`
 
@@ -1759,7 +1759,7 @@ EXAMPLES
   $ qfg sdk-key revoke <key-id>
 ```
 
-_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/sdk-key.ts)_
+_See code: [src/commands/sdk-key.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/sdk-key.ts)_
 
 ## `qfg sdk-key create`
 
@@ -1791,7 +1791,7 @@ EXAMPLES
   $ qfg sdk-key create --environment staging --type browser
 ```
 
-_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/sdk-key/create.ts)_
+_See code: [src/commands/sdk-key/create.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/sdk-key/create.ts)_
 
 ## `qfg sdk-key list`
 
@@ -1820,7 +1820,7 @@ EXAMPLES
   $ qfg sdk-key list --environment production
 ```
 
-_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/sdk-key/list.ts)_
+_See code: [src/commands/sdk-key/list.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/sdk-key/list.ts)_
 
 ## `qfg sdk-key revoke KEYID`
 
@@ -1847,7 +1847,7 @@ EXAMPLES
   $ qfg sdk-key revoke a1b2c3d4-e5f6-7890-abcd-ef1234567890
 ```
 
-_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/sdk-key/revoke.ts)_
+_See code: [src/commands/sdk-key/revoke.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/sdk-key/revoke.ts)_
 
 ## `qfg serve`
 
@@ -1904,7 +1904,7 @@ EXAMPLES
   $ qfg serve --port 6581 --frontend-sdk-key PUBLIC_KEY
 ```
 
-_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/serve.ts)_
+_See code: [src/commands/serve.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/serve.ts)_
 
 ## `qfg set-default [NAME]`
 
@@ -1975,7 +1975,7 @@ EXAMPLES
   $ qfg pull && qfg config-schema
 ```
 
-_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/set-default.ts)_
+_See code: [src/commands/set-default.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/set-default.ts)_
 
 ## `qfg set-rollout [NAME]`
 
@@ -2052,7 +2052,7 @@ EXAMPLES
   $ qfg set-rollout my.variant.flag --environment production --weights "a:33,b:33,c:34" --hash-by user.id
 ```
 
-_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/set-rollout.ts)_
+_See code: [src/commands/set-rollout.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/set-rollout.ts)_
 
 ## `qfg sync`
 
@@ -2084,7 +2084,7 @@ EXAMPLES
   $ qfg sync --watch --dir ./our-config --interval 30
 ```
 
-_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/sync.ts)_
+_See code: [src/commands/sync.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/sync.ts)_
 
 ## `qfg toggle [NAME]`
 
@@ -2186,7 +2186,7 @@ EXAMPLES
   $ qfg verify --json
 ```
 
-_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/verify.ts)_
+_See code: [src/commands/verify.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/verify.ts)_
 
 ## `qfg whoami`
 
@@ -2209,7 +2209,7 @@ EXAMPLES
   $ qfg whoami
 ```
 
-_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/whoami.ts)_
+_See code: [src/commands/whoami.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/whoami.ts)_
 
 ## `qfg workspace`
 
@@ -2232,7 +2232,7 @@ EXAMPLES
   $ qfg workspace
 ```
 
-_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/workspace.ts)_
+_See code: [src/commands/workspace.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/workspace.ts)_
 
 ## `qfg workspace bootstrap`
 
@@ -2265,7 +2265,7 @@ EXAMPLES
   $ qfg workspace bootstrap --dir ./our-config --skip-validate
 ```
 
-_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/workspace/bootstrap.ts)_
+_See code: [src/commands/workspace/bootstrap.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/workspace/bootstrap.ts)_
 
 ## `qfg workspace create SLUG`
 
@@ -2299,7 +2299,7 @@ EXAMPLES
   $ qfg workspace create my-team --org 11111111-1111-1111-1111-111111111111
 ```
 
-_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/workspace/create.ts)_
+_See code: [src/commands/workspace/create.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/workspace/create.ts)_
 
 ## `qfg workspace switch [SLUG]`
 
@@ -2327,7 +2327,7 @@ EXAMPLES
   $ qfg workspace switch acme/production
 ```
 
-_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.58/src/commands/workspace/switch.ts)_
+_See code: [src/commands/workspace/switch.ts](https://github.com/quonfig/cli/blob/v0.0.59/src/commands/workspace/switch.ts)_
 <!-- commandsstop -->
 
 ## Local Development

package/dist/migrate/sources/launch/api.d.ts

@@ -2,6 +2,8 @@ import type { LaunchChangeEntry, LaunchChangeHistoryResponse } from './types.js'
 export declare function setLaunchBaseUrl(url: string): void;
 export declare function selectLaunchBaseUrl(staging: boolean): string;
 export declare function applyLaunchBaseUrl(staging: boolean): void;
+export declare function __setSleepForTests(fn: (ms: number) => Promise<void>): void;
+export declare function __resetSleepForTests(): void;
 export declare function fetchEnvironments(apiKey: string): Promise<Record<string, string>>;
 export declare function fetchChangeHistoryPage(apiKey: string, cursor?: string): Promise<LaunchChangeHistoryResponse>;
 export declare function fetchAllChangeHistory(apiKey: string, sinceEpochMs?: number, onProgress?: (fetched: number) => void): Promise<LaunchChangeEntry[]>;

package/dist/migrate/sources/launch/api.js

@@ -1,6 +1,20 @@
 const PROD_BASE_URL = 'https://api.reforge.com';
 const STAGING_BASE_URL = 'https://api.goatsofreforge.com';
 const PAGE_LIMIT = 50;
+/**
+ * Hard cap on retries for a single request before we give up. Mirrors the
+ * launchdarkly/flagsmith adapters.
+ */
+const MAX_RETRIES = 6;
+/** Fallback wait when a response carries no usable backoff header. */
+const DEFAULT_BACKOFF_MS = 2000;
+/**
+ * Politeness pause between history pages. On a large account this endpoint is
+ * walked for hundreds of sequential pages; a small fixed delay keeps us from
+ * tripping a rate limit. (Reforge sends no rate-budget headers to pre-throttle
+ * against, unlike LaunchDarkly/Flagsmith.)
+ */
+const INTER_PAGE_THROTTLE_MS = 300;
 let baseUrl = PROD_BASE_URL;
 export function setLaunchBaseUrl(url) {
     baseUrl = url;
@@ -14,20 +28,87 @@ export function applyLaunchBaseUrl(staging) {
 function makeToken(apiKey) {
     return Buffer.from(`authuser:${apiKey}`).toString('base64');
 }
+/** Real timer-backed sleep — swapped out in tests so MSW runs don't actually wait. */
+function timerSleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+/** Test seam: a no-op sleep is swapped in so MSW tests don't actually wait. */
+let sleepImpl = timerSleep;
+export function __setSleepForTests(fn) {
+    sleepImpl = fn;
+}
+export function __resetSleepForTests() {
+    sleepImpl = timerSleep;
+}
+/**
+ * Only transient errors are retried: 429 (throttling) and 5xx (availability).
+ *
+ * A 403 is NOT retried. It is either a genuine authorization failure (a bad or
+ * under-scoped key) or a hard edge/WAF block — neither clears by waiting, so
+ * retrying just burns the whole backoff budget (~2 min) before surfacing the
+ * same error. Fail fast with a clear message instead. (Observed: Reforge's
+ * edge WAF blocked change-history cursors whose flag key contained certain
+ * substrings; that is a server-side rule, fixed upstream, not something the
+ * client can retry past.)
+ */
+function isRetryable(status) {
+    return status === 429 || status === 502 || status === 503 || status === 504;
+}
+/**
+ * Exponential backoff with jitter: ~2s, 4s, 8s … clamped to 60s, ±20% jitter
+ * so concurrent/retried requests don't resynchronize into the next block. A
+ * standard `Retry-After` header, if present, raises (never lowers) the wait.
+ */
+function backoffMs(headers, attempt) {
+    let wait = Math.min(60_000, DEFAULT_BACKOFF_MS * 2 ** attempt);
+    const retryAfter = headers.get('Retry-After');
+    if (retryAfter !== null) {
+        const sec = Number(retryAfter);
+        if (Number.isFinite(sec))
+            wait = Math.max(wait, sec * 1000);
+    }
+    // ±20% jitter. Math.random is fine here (not a deterministic-replay context).
+    const jitter = wait * 0.2 * (Math.random() * 2 - 1);
+    return Math.min(60_000, Math.max(0, Math.round(wait + jitter)));
+}
+/** Trim a (potentially large HTML) error body so the thrown message stays readable. */
+function truncateBody(body) {
+    const flat = body.replaceAll(/\s+/g, ' ').trim();
+    return flat.length > 300 ? `${flat.slice(0, 300)}…` : flat;
+}
+/**
+ * Single GET with HTTP Basic auth, retrying transient errors (429, 5xx) with
+ * exponential backoff. 403 and other non-ok statuses throw immediately — only
+ * throttling/availability errors are retried.
+ */
 async function apiFetch(path, apiKey) {
     const url = `${baseUrl}${path}`;
     const token = makeToken(apiKey);
-    const res = await fetch(url, {
-        headers: {
-            Accept: 'application/json',
-            Authorization: `Basic ${token}`,
-        },
-    });
-    if (!res.ok) {
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        // eslint-disable-next-line no-await-in-loop
+        const res = await fetch(url, {
+            headers: {
+                Accept: 'application/json',
+                Authorization: `Basic ${token}`,
+            },
+        });
+        if (res.ok)
+            return res.json();
+        const retryable = isRetryable(res.status);
+        if (retryable && attempt < MAX_RETRIES) {
+            // eslint-disable-next-line no-await-in-loop
+            await sleepImpl(backoffMs(res.headers, attempt));
+            continue;
+        }
+        // eslint-disable-next-line no-await-in-loop
         const body = await res.text().catch(() => '(no body)');
-        throw new Error(`Launch API request failed: ${res.status} ${res.statusText} — ${url}\n${body}`);
+        const hint = retryable ? ` (gave up after ${MAX_RETRIES + 1} attempts)` : '';
+        throw new Error(`Launch API request failed: ${res.status} ${res.statusText}${hint} — ${url}\n${truncateBody(body)}`);
     }
-    return res.json();
+    // Unreachable — the loop either returns or throws.
+    throw new Error(`Launch API request failed: retries exhausted — ${url}`);
 }
 export async function fetchEnvironments(apiKey) {
     const data = (await apiFetch('/api/v1/project-environments', apiKey));
@@ -73,6 +154,10 @@ export async function fetchAllChangeHistory(apiKey, sinceEpochMs, onProgress) {
             break;
         seenCursors.add(page.cursor);
         cursor = page.cursor;
+        // Smooth the request burst so we don't trip Reforge's edge rate-limit in
+        // the first place (it has no rate-budget headers to pre-throttle against).
+        // eslint-disable-next-line no-await-in-loop
+        await sleepImpl(INTER_PAGE_THROTTLE_MS);
     }
     return collected.reverse();
 }

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-declare const _default: "0.0.58";
+declare const _default: "0.0.59";
 export default _default;

package/dist/version.js

@@ -1,2 +1,2 @@
 // AUTO-GENERATED from package.json by scripts/generate-version.mjs — do not edit.
-export default '0.0.58';
+export default '0.0.59';

package/oclif.manifest.json

@@ -3646,13 +3646,14 @@
         "status.js"
       ]
     },
-    "sdk-key:create": {
+    "workspace:bootstrap": {
       "aliases": [],
       "args": {},
-      "description": "Create a new SDK key",
+      "description": "Push a local git repo to Gitea as this workspace's config repository",
       "examples": [
-        "<%= config.bin %> <%= command.id %> --environment production --type server",
-        "<%= config.bin %> <%= command.id %> --environment staging --type browser"
+        "<%= config.bin %> workspace bootstrap --dir ./our-config",
+        "<%= config.bin %> workspace bootstrap --dir ./launch-migrator/output",
+        "<%= config.bin %> workspace bootstrap --dir ./our-config --skip-validate"
       ],
       "flags": {
         "json": {
@@ -3684,53 +3685,30 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "workspace": {
-          "char": "w",
-          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
-          "helpGroup": "GLOBAL",
-          "name": "workspace",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "profile": {
-          "char": "p",
-          "description": "Deprecated: use --workspace instead",
-          "helpGroup": "GLOBAL",
-          "hidden": true,
-          "name": "profile",
+        "dir": {
+          "description": "Local directory to push (defaults to current directory)",
+          "name": "dir",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment": {
-          "char": "e",
-          "description": "Environment name (e.g. production, staging)",
-          "name": "environment",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
+        "force": {
+          "description": "Force push even if remote already has commits",
+          "name": "force",
+          "allowNo": false,
+          "type": "boolean"
         },
-        "type": {
-          "char": "t",
-          "description": "Key type: server (backend) or browser (frontend)",
-          "name": "type",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "options": [
-            "server",
-            "browser"
-          ],
-          "type": "option"
+        "skip-validate": {
+          "description": "Skip config validation before pushing",
+          "name": "skip-validate",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sdk-key:create",
+      "id": "workspace:bootstrap",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -3740,17 +3718,24 @@
       "relativePath": [
         "dist",
         "commands",
-        "sdk-key",
-        "create.js"
+        "workspace",
+        "bootstrap.js"
       ]
     },
-    "sdk-key:list": {
+    "workspace:create": {
       "aliases": [],
-      "args": {},
-      "description": "List SDK keys for your workspace",
+      "args": {
+        "slug": {
+          "description": "Workspace slug (lowercase letters, numbers, hyphens)",
+          "name": "slug",
+          "required": true
+        }
+      },
+      "description": "Create a new workspace. Provisions the Gitea repo and default environments, identical to the app's New Workspace UI.",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --environment production"
+        "<%= config.bin %> <%= command.id %> my-team",
+        "<%= config.bin %> <%= command.id %> lt-21-smoke --name \"Load Test 21\"",
+        "<%= config.bin %> <%= command.id %> my-team --org 11111111-1111-1111-1111-111111111111"
       ],
       "flags": {
         "json": {
@@ -3782,31 +3767,17 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "workspace": {
-          "char": "w",
-          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
-          "helpGroup": "GLOBAL",
-          "name": "workspace",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "profile": {
-          "char": "p",
-          "description": "Deprecated: use --workspace instead",
-          "helpGroup": "GLOBAL",
-          "hidden": true,
-          "name": "profile",
+        "name": {
+          "description": "Human-readable display name (defaults to the slug)",
+          "name": "name",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "environment": {
-          "char": "e",
-          "description": "Filter by environment name",
-          "name": "environment",
+        "org": {
+          "description": "Organization UUID or slug. Required when you belong to more than one organization; inferred otherwise.",
+          "name": "org",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -3815,7 +3786,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sdk-key:list",
+      "id": "workspace:create",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -3825,22 +3796,23 @@
       "relativePath": [
         "dist",
         "commands",
-        "sdk-key",
-        "list.js"
+        "workspace",
+        "create.js"
       ]
     },
-    "sdk-key:revoke": {
+    "workspace:switch": {
       "aliases": [],
       "args": {
-        "keyId": {
-          "description": "ID of the SDK key to revoke",
-          "name": "keyId",
-          "required": true
+        "slug": {
+          "description": "Workspace pin in `<org-slug>/<workspace-slug>` form. Omit for an interactive picker.",
+          "name": "slug",
+          "required": false
         }
       },
-      "description": "Revoke an SDK key by its ID",
+      "description": "Switch the saved default profile to a different (org, workspace) pair",
       "examples": [
-        "<%= config.bin %> <%= command.id %> a1b2c3d4-e5f6-7890-abcd-ef1234567890"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> acme/production"
       ],
       "flags": {
         "json": {
@@ -3871,32 +3843,11 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
-        },
-        "workspace": {
-          "char": "w",
-          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
-          "helpGroup": "GLOBAL",
-          "name": "workspace",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "profile": {
-          "char": "p",
-          "description": "Deprecated: use --workspace instead",
-          "helpGroup": "GLOBAL",
-          "hidden": true,
-          "name": "profile",
-          "required": false,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sdk-key:revoke",
+      "id": "workspace:switch",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -3906,18 +3857,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "sdk-key",
-        "revoke.js"
+        "workspace",
+        "switch.js"
       ]
     },
-    "workspace:bootstrap": {
+    "sdk-key:create": {
       "aliases": [],
       "args": {},
-      "description": "Push a local git repo to Gitea as this workspace's config repository",
+      "description": "Create a new SDK key",
       "examples": [
-        "<%= config.bin %> workspace bootstrap --dir ./our-config",
-        "<%= config.bin %> workspace bootstrap --dir ./launch-migrator/output",
-        "<%= config.bin %> workspace bootstrap --dir ./our-config --skip-validate"
+        "<%= config.bin %> <%= command.id %> --environment production --type server",
+        "<%= config.bin %> <%= command.id %> --environment staging --type browser"
       ],
       "flags": {
         "json": {
@@ -3949,30 +3899,53 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "dir": {
-          "description": "Local directory to push (defaults to current directory)",
-          "name": "dir",
+        "workspace": {
+          "char": "w",
+          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
+          "helpGroup": "GLOBAL",
+          "name": "workspace",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "force": {
-          "description": "Force push even if remote already has commits",
-          "name": "force",
-          "allowNo": false,
-          "type": "boolean"
+        "profile": {
+          "char": "p",
+          "description": "Deprecated: use --workspace instead",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "skip-validate": {
-          "description": "Skip config validation before pushing",
-          "name": "skip-validate",
-          "allowNo": false,
-          "type": "boolean"
+        "environment": {
+          "char": "e",
+          "description": "Environment name (e.g. production, staging)",
+          "name": "environment",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "type": {
+          "char": "t",
+          "description": "Key type: server (backend) or browser (frontend)",
+          "name": "type",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "server",
+            "browser"
+          ],
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:bootstrap",
+      "id": "sdk-key:create",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -3982,24 +3955,17 @@
       "relativePath": [
         "dist",
         "commands",
-        "workspace",
-        "bootstrap.js"
+        "sdk-key",
+        "create.js"
       ]
     },
-    "workspace:create": {
+    "sdk-key:list": {
       "aliases": [],
-      "args": {
-        "slug": {
-          "description": "Workspace slug (lowercase letters, numbers, hyphens)",
-          "name": "slug",
-          "required": true
-        }
-      },
-      "description": "Create a new workspace. Provisions the Gitea repo and default environments, identical to the app's New Workspace UI.",
+      "args": {},
+      "description": "List SDK keys for your workspace",
       "examples": [
-        "<%= config.bin %> <%= command.id %> my-team",
-        "<%= config.bin %> <%= command.id %> lt-21-smoke --name \"Load Test 21\"",
-        "<%= config.bin %> <%= command.id %> my-team --org 11111111-1111-1111-1111-111111111111"
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --environment production"
       ],
       "flags": {
         "json": {
@@ -4031,17 +3997,31 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "name": {
-          "description": "Human-readable display name (defaults to the slug)",
-          "name": "name",
+        "workspace": {
+          "char": "w",
+          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
+          "helpGroup": "GLOBAL",
+          "name": "workspace",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
         },
-        "org": {
-          "description": "Organization UUID or slug. Required when you belong to more than one organization; inferred otherwise.",
-          "name": "org",
+        "profile": {
+          "char": "p",
+          "description": "Deprecated: use --workspace instead",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "environment": {
+          "char": "e",
+          "description": "Filter by environment name",
+          "name": "environment",
           "required": false,
           "hasDynamicHelp": false,
           "multiple": false,
@@ -4050,7 +4030,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:create",
+      "id": "sdk-key:list",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -4060,23 +4040,22 @@
       "relativePath": [
         "dist",
         "commands",
-        "workspace",
-        "create.js"
+        "sdk-key",
+        "list.js"
       ]
     },
-    "workspace:switch": {
+    "sdk-key:revoke": {
       "aliases": [],
       "args": {
-        "slug": {
-          "description": "Workspace pin in `<org-slug>/<workspace-slug>` form. Omit for an interactive picker.",
-          "name": "slug",
-          "required": false
+        "keyId": {
+          "description": "ID of the SDK key to revoke",
+          "name": "keyId",
+          "required": true
         }
       },
-      "description": "Switch the saved default profile to a different (org, workspace) pair",
+      "description": "Revoke an SDK key by its ID",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> acme/production"
+        "<%= config.bin %> <%= command.id %> a1b2c3d4-e5f6-7890-abcd-ef1234567890"
       ],
       "flags": {
         "json": {
@@ -4107,11 +4086,32 @@
           "name": "verbose",
           "allowNo": false,
           "type": "boolean"
+        },
+        "workspace": {
+          "char": "w",
+          "description": "Workspace slug to use (overrides QUONFIG_WORKSPACE env var and saved default)",
+          "helpGroup": "GLOBAL",
+          "name": "workspace",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "profile": {
+          "char": "p",
+          "description": "Deprecated: use --workspace instead",
+          "helpGroup": "GLOBAL",
+          "hidden": true,
+          "name": "profile",
+          "required": false,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "workspace:switch",
+      "id": "sdk-key:revoke",
       "pluginAlias": "@quonfig/cli",
       "pluginName": "@quonfig/cli",
       "pluginType": "core",
@@ -4121,10 +4121,10 @@
       "relativePath": [
         "dist",
         "commands",
-        "workspace",
-        "switch.js"
+        "sdk-key",
+        "revoke.js"
       ]
     }
   },
-  "version": "0.0.58"
+  "version": "0.0.59"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "packageManager": "yarn@4.11.0+sha512.4e54aeace9141df2f0177c266b05ec50dc044638157dae128c471ba65994ac802122d7ab35bcd9e81641228b7dcf24867d28e750e0bcae8a05277d600008ad54",
   "name": "@quonfig/cli",
-  "version": "0.0.58",
+  "version": "0.0.59",
   "bugs": {
     "url": "https://github.com/quonfig/cli/issues"
   },