@flowscripter/dynamic-cli-framework 7.0.10 → 7.0.11

package/dist/index.d.ts

@@ -120,6 +120,7 @@ export { PLUGIN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 export type { PluginService } from "@flowscripter/dynamic-cli-framework-api";
 export { default as PluginServiceProvider } from "./src/service/plugin/PluginServiceProvider.ts";
 export { default as BaseCLI } from "./src/cli/BaseCLI.ts";
+export { SHUTDOWN_SERVICE_PRIORITY, STARTUP_SERVICE_PRIORITY, CONFIGURATION_SERVICE_PRIORITY, KEY_VALUE_SERVICE_PRIORITY, PRINTER_SERVICE_PRIORITY, PROMPTER_SERVICE_PRIORITY, TABLE_GENERATOR_SERVICE_PRIORITY, ARGUMENT_PROMPTER_SERVICE_PRIORITY, SPAWN_SERVICE_PRIORITY, FETCH_SERVICE_PRIORITY, UPGRADE_SERVICE_PRIORITY, UPGRADE_CHECK_STARTUP_TASK_PRIORITY, IMAGE_PRINTER_SERVICE_PRIORITY, PLUGIN_SERVICE_PRIORITY, AUTO_UPGRADE_STARTUP_TASK_PRIORITY, COMPLETION_SERVICE_PRIORITY, CLEANUP_SHUTDOWN_TASK_PRIORITY, KEY_VALUE_FLUSH_SHUTDOWN_TASK_PRIORITY, } from "./src/runtime/lifecycle/priorities.ts";
 export { default as DefaultRuntimeCLI } from "./src/cli/DefaultRuntimeCLI.ts";
 export type { default as Terminal } from "./src/terminal/Terminal.ts";
 export type { default as Styler } from "./src/terminal/Styler.ts";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -74,6 +74,7 @@ export { PLUGIN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 export { default as PluginServiceProvider } from "./src/service/plugin/PluginServiceProvider.js";
 // Core CLI
 export { default as BaseCLI } from "./src/cli/BaseCLI.js";
+export { SHUTDOWN_SERVICE_PRIORITY, STARTUP_SERVICE_PRIORITY, CONFIGURATION_SERVICE_PRIORITY, KEY_VALUE_SERVICE_PRIORITY, PRINTER_SERVICE_PRIORITY, PROMPTER_SERVICE_PRIORITY, TABLE_GENERATOR_SERVICE_PRIORITY, ARGUMENT_PROMPTER_SERVICE_PRIORITY, SPAWN_SERVICE_PRIORITY, FETCH_SERVICE_PRIORITY, UPGRADE_SERVICE_PRIORITY, UPGRADE_CHECK_STARTUP_TASK_PRIORITY, IMAGE_PRINTER_SERVICE_PRIORITY, PLUGIN_SERVICE_PRIORITY, AUTO_UPGRADE_STARTUP_TASK_PRIORITY, COMPLETION_SERVICE_PRIORITY, CLEANUP_SHUTDOWN_TASK_PRIORITY, KEY_VALUE_FLUSH_SHUTDOWN_TASK_PRIORITY, } from "./src/runtime/lifecycle/priorities.js";
 export { default as DefaultRuntimeCLI } from "./src/cli/DefaultRuntimeCLI.js";
 export { SpecialKey } from "./src/terminal/KeyReader.js";
 export { default as TtyKeyReader } from "./src/terminal/TtyKeyReader.js";

package/dist/src/cli/BaseCLI.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseCLI.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCLI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yCAAyC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAGvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAS3E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAC;AAkBpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,YAAW,GAAG;;IAazC,YACE,SAAS,EAAE,SAAS,EACpB,oBAAoB,EAAE,cAAc,EACpC,oBAAoB,EAAE,cAAc,EACpC,aAAa,EAAE,OAAO,EACtB,aAAa,EAAE,OAAO,EACtB,cAAc,EAAE,QAAQ,EACxB,cAAc,EAAE,QAAQ,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,qBAAqB,EAoEhC;IAED;;;;;;;OAOG;IACI,kBAAkB,CAAC,eAAe,EAAE,eAAe,QAEzD;IAED;;;;;;;;OAQG;IACH;;;;;OAKG;IACI,cAAc,CAAC,IAAI,EAAE,WAAW,QAEtC;IAEM,UAAU,CAAC,OAAO,EAAE,OAAO,QAQjC;IAEK,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAwOzD;CACF"}
+{"version":3,"file":"BaseCLI.d.ts","sourceRoot":"","sources":["../../../src/cli/BaseCLI.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,yCAAyC,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAGvE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAsBzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAS3E,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,yBAAyB,CAAC;AAGpD,OAAO,KAAK,MAAM,MAAM,uBAAuB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,qBAAqB,MAAM,4BAA4B,CAAC;AAqCpE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,MAAM,CAAC,OAAO,OAAO,OAAQ,YAAW,GAAG;;IAazC,YACE,SAAS,EAAE,SAAS,EACpB,oBAAoB,EAAE,cAAc,EACpC,oBAAoB,EAAE,cAAc,EACpC,aAAa,EAAE,OAAO,EACtB,aAAa,EAAE,OAAO,EACtB,cAAc,EAAE,QAAQ,EACxB,cAAc,EAAE,QAAQ,EACxB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,GAAG,SAAS,EAChC,OAAO,CAAC,EAAE,qBAAqB,EAkEhC;IAED;;;;;;;OAOG;IACI,kBAAkB,CAAC,eAAe,EAAE,eAAe,QAEzD;IAED;;;;;;;;OAQG;IACH;;;;;OAKG;IACI,cAAc,CAAC,IAAI,EAAE,WAAW,QAEtC;IAEM,UAAU,CAAC,OAAO,EAAE,OAAO,QAQjC;IAEK,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CA8PzD;CACF"}

package/dist/src/cli/BaseCLI.js

@@ -29,8 +29,9 @@ import CompletionServiceProvider from "../service/completion/CompletionServicePr
 import ImagePrinterServiceProvider from "../service/imagePrinter/ImagePrinterServiceProvider.js";
 import SpawnServiceProvider from "../service/spawn/SpawnServiceProvider.js";
 import FetchServiceProvider from "../service/fetch/FetchServiceProvider.js";
-import UpgradeServiceProvider, { createUpgradeCheckStartupTask, } from "../service/upgrade/UpgradeServiceProvider.js";
+import UpgradeServiceProvider, { createAutoUpgradeStartupTask, createUpgradeCheckStartupTask, } from "../service/upgrade/UpgradeServiceProvider.js";
 import PluginServiceProvider from "../service/plugin/PluginServiceProvider.js";
+import { ARGUMENT_PROMPTER_SERVICE_PRIORITY, AUTO_UPGRADE_STARTUP_TASK_PRIORITY, COMPLETION_SERVICE_PRIORITY, CONFIGURATION_SERVICE_PRIORITY, FETCH_SERVICE_PRIORITY, IMAGE_PRINTER_SERVICE_PRIORITY, KEY_VALUE_SERVICE_PRIORITY, PLUGIN_SERVICE_PRIORITY, PRINTER_SERVICE_PRIORITY, PROMPTER_SERVICE_PRIORITY, SHUTDOWN_SERVICE_PRIORITY, SPAWN_SERVICE_PRIORITY, STARTUP_SERVICE_PRIORITY, TABLE_GENERATOR_SERVICE_PRIORITY, UPGRADE_CHECK_STARTUP_TASK_PRIORITY, UPGRADE_SERVICE_PRIORITY, } from "../runtime/lifecycle/priorities.js";
 const logger = getLogger("BaseCLI");
 /**
  * Base implementation of a {@link CLI}.
@@ -128,9 +129,7 @@ export default class BaseCLI {
         this.#commandRegistry = new DefaultCommandRegistry([], commandValidator);
         // create a context
         this.#context = new DefaultContext(this.#cliConfig);
-        // priority 95 sits between shutdown (100) and configuration (90) - it has no ordering
-        // dependency on anything since its own initService() is a no-op.
-        this.#startupServiceProvider = new StartupServiceProvider(95);
+        this.#startupServiceProvider = new StartupServiceProvider(STARTUP_SERVICE_PRIORITY);
         this.#stdoutTerminal = stdoutTerminal;
         this.#printerService = new DefaultPrinterService(stdoutWritableStream, stderrWritableStream, stdoutIsColor, stderrIsColor, stdoutTerminal, stderrTerminal, styler);
     }
@@ -182,10 +181,10 @@ export default class BaseCLI {
             throw new Error("If only one command is added, it must be a global command, sub-command, or group command!");
         }
         // create and add core services
-        this.addServiceProvider(new ShutdownServiceProvider(100));
+        this.addServiceProvider(new ShutdownServiceProvider(SHUTDOWN_SERVICE_PRIORITY));
         this.addServiceProvider(this.#startupServiceProvider);
-        this.addServiceProvider(new PrinterServiceProvider(80, this.#printerService));
-        this.addServiceProvider(new TableGeneratorServiceProvider(70));
+        this.addServiceProvider(new PrinterServiceProvider(PRINTER_SERVICE_PRIORITY, this.#printerService));
+        this.addServiceProvider(new TableGeneratorServiceProvider(TABLE_GENERATOR_SERVICE_PRIORITY));
         const canPrompt = this.#keyReader !== undefined && this.#stderrTerminal.isTty();
         if (this.#options.promptingEnabled && !canPrompt) {
             throw new Error("promptingEnabled requires a keyReader and a TTY stderr terminal");
@@ -194,7 +193,7 @@ export default class BaseCLI {
         if (canPrompt) {
             prompterService = new DefaultPrompterService(DEFAULT_PROMPTER_CONFIG, this.#stderrTerminal, this.#keyReader, this.#printerService);
             prompterService.promptEnabled = this.#options.promptingEnabled;
-            this.addServiceProvider(new PrompterServiceProvider(75, prompterService));
+            this.addServiceProvider(new PrompterServiceProvider(PROMPTER_SERVICE_PRIORITY, prompterService));
         }
         else {
             logger.debug(() => `Skipping PrompterServiceProvider: keyReader present: ${this.#keyReader !== undefined}, stderr isTty: ${this.#stderrTerminal.isTty()}`);
@@ -202,7 +201,7 @@ export default class BaseCLI {
         if (this.#options.argumentPrompterServiceEnabled) {
             if (prompterService !== undefined) {
                 const argumentPrompterService = new DefaultArgumentPrompterService(prompterService);
-                this.addServiceProvider(new ArgumentPrompterServiceProvider(65, argumentPrompterService));
+                this.addServiceProvider(new ArgumentPrompterServiceProvider(ARGUMENT_PROMPTER_SERVICE_PRIORITY, argumentPrompterService));
             }
             else {
                 logger.debug("Skipping ArgumentPrompterServiceProvider: argumentPrompterServiceEnabled is true but prompting is unavailable");
@@ -210,7 +209,7 @@ export default class BaseCLI {
         }
         if (this.#options.imagePrinterServiceEnabled) {
             if (this.#stdoutTerminal.isTty()) {
-                this.addServiceProvider(new ImagePrinterServiceProvider(55, this.#stdoutTerminal));
+                this.addServiceProvider(new ImagePrinterServiceProvider(IMAGE_PRINTER_SERVICE_PRIORITY, this.#stdoutTerminal));
             }
             else {
                 logger.debug("Skipping ImagePrinterServiceProvider: imagePrinterServiceEnabled is true but stdout is not a TTY");
@@ -219,30 +218,26 @@ export default class BaseCLI {
         // The plugin service routes package manager output through SpawnService so that it is
         // quoted, marked and cleared on success; enabling plugins therefore also enables spawning.
         if (this.#options.spawnServiceEnabled || this.#options.pluginServiceEnabled) {
-            this.addServiceProvider(new SpawnServiceProvider(58));
+            this.addServiceProvider(new SpawnServiceProvider(SPAWN_SERVICE_PRIORITY));
         }
         if (this.#options.fetchServiceEnabled) {
-            this.addServiceProvider(new FetchServiceProvider(57));
+            this.addServiceProvider(new FetchServiceProvider(FETCH_SERVICE_PRIORITY));
         }
         if (this.#options.completionServiceEnabled) {
             const completionService = new DefaultCompletionService();
-            this.addServiceProvider(new CompletionServiceProvider(5, completionService, this.#commandRegistry));
+            this.addServiceProvider(new CompletionServiceProvider(COMPLETION_SERVICE_PRIORITY, completionService, this.#commandRegistry));
         }
         let upgradeServiceProvider;
         if (this.#options.upgradeServiceEnabled) {
-            // 56 runs after Spawn(58)/Fetch(57) - whose dependencies it needs
-            // but before the consumer-configured Banner/Plugin(50) priority band.
-            upgradeServiceProvider = new UpgradeServiceProvider(56, this.#options.upgradeLocationsConfig);
+            upgradeServiceProvider = new UpgradeServiceProvider(UPGRADE_SERVICE_PRIORITY, this.#options.upgradeLocationsConfig);
             this.addServiceProvider(upgradeServiceProvider);
         }
         if (this.#options.pluginServiceEnabled) {
-            this.addServiceProvider(new PluginServiceProvider(50, this.#options.pluginServiceRemoteConfig, this.#options.pluginServiceLocalConfig, this.#commandRegistry, this.#serviceProviderRegistry));
+            this.addServiceProvider(new PluginServiceProvider(PLUGIN_SERVICE_PRIORITY, this.#options.pluginServiceRemoteConfig, this.#options.pluginServiceLocalConfig, this.#commandRegistry, this.#serviceProviderRegistry));
         }
-        const configurationServiceProvider = new ConfigurationServiceProvider(90, this.#options.envVarsSupportEnabled, this.#options.configFileSupportEnabled, this.#options.secretServiceEnabled);
+        const configurationServiceProvider = new ConfigurationServiceProvider(CONFIGURATION_SERVICE_PRIORITY, this.#options.envVarsSupportEnabled, this.#options.configFileSupportEnabled, this.#options.secretServiceEnabled);
         this.addServiceProvider(configurationServiceProvider);
-        // priority 89 sits just below ConfigurationServiceProvider's 90 - its config-file read
-        // happens in its own initService(), before KeyValueServiceProvider's initService() runs.
-        const keyValueServiceProvider = new KeyValueServiceProvider(89, configurationServiceProvider, this.#options.keyValueServiceEnabled, this.#options.secretServiceEnabled);
+        const keyValueServiceProvider = new KeyValueServiceProvider(KEY_VALUE_SERVICE_PRIORITY, configurationServiceProvider, this.#options.keyValueServiceEnabled, this.#options.secretServiceEnabled);
         this.addServiceProvider(keyValueServiceProvider);
         for (const serviceProvider of this.#serviceProviderRegistry.getServiceProviders()) {
             const serviceInfo = await serviceProvider.getServiceInfo(this.#cliConfig);
@@ -254,7 +249,8 @@ export default class BaseCLI {
             });
         }
         if (upgradeServiceProvider?.upgradeService) {
-            this.addStartupTask(createUpgradeCheckStartupTask(upgradeServiceProvider.upgradeService, 56));
+            this.addStartupTask(createUpgradeCheckStartupTask(upgradeServiceProvider.upgradeService, UPGRADE_CHECK_STARTUP_TASK_PRIORITY));
+            this.addStartupTask(createAutoUpgradeStartupTask(upgradeServiceProvider, AUTO_UPGRADE_STARTUP_TASK_PRIORITY));
         }
         // directly-registered StartupTasks (e.g. the banner task) aren't backed by a ServiceProvider,
         // so their modifierCommands need to be added to the command registry here instead, keyed by

package/dist/src/runtime/lifecycle/priorities.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Priorities of the framework's built-in service providers, startup tasks and shutdown tasks.
+ * Higher values run earlier (see {@link sortByPriority}). Service provider priorities also order
+ * their `initService()` calls within the startup sequence: when a provider and a directly
+ * registered startup task share a priority, the provider runs first.
+ *
+ * Consumer service providers and startup tasks (e.g. the banner task) choose their own
+ * priorities relative to these.
+ */
+/** Shutdown service provider: first, so signal handling is in place before anything else. */
+export declare const SHUTDOWN_SERVICE_PRIORITY = 100;
+/** Startup service provider: no ordering dependency, as its `initService()` is a no-op. */
+export declare const STARTUP_SERVICE_PRIORITY = 95;
+/** Configuration service provider: reads the config file in its `initService()`. */
+export declare const CONFIGURATION_SERVICE_PRIORITY = 90;
+/** Key-value service provider: just below configuration, whose config-file read it depends on. */
+export declare const KEY_VALUE_SERVICE_PRIORITY = 89;
+/** Printer service provider. */
+export declare const PRINTER_SERVICE_PRIORITY = 80;
+/** Prompter service provider. */
+export declare const PROMPTER_SERVICE_PRIORITY = 75;
+/** Table generator service provider. */
+export declare const TABLE_GENERATOR_SERVICE_PRIORITY = 70;
+/** Argument prompter service provider: below the prompter it uses. */
+export declare const ARGUMENT_PROMPTER_SERVICE_PRIORITY = 65;
+/** Spawn service provider. */
+export declare const SPAWN_SERVICE_PRIORITY = 58;
+/** Fetch service provider. */
+export declare const FETCH_SERVICE_PRIORITY = 57;
+/** Upgrade service provider: below the spawn and fetch services it uses. */
+export declare const UPGRADE_SERVICE_PRIORITY = 56;
+/** Background startup task which refreshes the cached upgrade check result. */
+export declare const UPGRADE_CHECK_STARTUP_TASK_PRIORITY = 56;
+/** Image printer service provider. */
+export declare const IMAGE_PRINTER_SERVICE_PRIORITY = 55;
+/** Plugin service provider. */
+export declare const PLUGIN_SERVICE_PRIORITY = 50;
+/**
+ * Startup task which prompts to enable automatic upgrades and performs them. It runs below
+ * consumer startup tasks such as the banner (typically 45 or more) and above the completion
+ * prompt.
+ */
+export declare const AUTO_UPGRADE_STARTUP_TASK_PRIORITY = 10;
+/** Completion service provider, whose `initService()` prompts to enable shell completion. */
+export declare const COMPLETION_SERVICE_PRIORITY = 5;
+/** Shutdown tasks which clean up in-flight work (spinners, progress bars, spawns, fetches). */
+export declare const CLEANUP_SHUTDOWN_TASK_PRIORITY = 0;
+/** Shutdown task which flushes key-value data to the config file, after all other cleanup. */
+export declare const KEY_VALUE_FLUSH_SHUTDOWN_TASK_PRIORITY = -100;
+//# sourceMappingURL=priorities.d.ts.map

package/dist/src/runtime/lifecycle/priorities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priorities.d.ts","sourceRoot":"","sources":["../../../../src/runtime/lifecycle/priorities.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,6FAA6F;AAC7F,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,2FAA2F;AAC3F,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,oFAAoF;AACpF,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,kGAAkG;AAClG,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAE7C,gCAAgC;AAChC,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,iCAAiC;AACjC,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAE5C,wCAAwC;AACxC,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAEnD,sEAAsE;AACtE,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAErD,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,8BAA8B;AAC9B,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,4EAA4E;AAC5E,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAE3C,+EAA+E;AAC/E,eAAO,MAAM,mCAAmC,KAAK,CAAC;AAEtD,sCAAsC;AACtC,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAEjD,+BAA+B;AAC/B,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAErD,6FAA6F;AAC7F,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,+FAA+F;AAC/F,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,8FAA8F;AAC9F,eAAO,MAAM,sCAAsC,OAAO,CAAC"}

package/dist/src/runtime/lifecycle/priorities.js

@@ -0,0 +1,49 @@
+/**
+ * Priorities of the framework's built-in service providers, startup tasks and shutdown tasks.
+ * Higher values run earlier (see {@link sortByPriority}). Service provider priorities also order
+ * their `initService()` calls within the startup sequence: when a provider and a directly
+ * registered startup task share a priority, the provider runs first.
+ *
+ * Consumer service providers and startup tasks (e.g. the banner task) choose their own
+ * priorities relative to these.
+ */
+/** Shutdown service provider: first, so signal handling is in place before anything else. */
+export const SHUTDOWN_SERVICE_PRIORITY = 100;
+/** Startup service provider: no ordering dependency, as its `initService()` is a no-op. */
+export const STARTUP_SERVICE_PRIORITY = 95;
+/** Configuration service provider: reads the config file in its `initService()`. */
+export const CONFIGURATION_SERVICE_PRIORITY = 90;
+/** Key-value service provider: just below configuration, whose config-file read it depends on. */
+export const KEY_VALUE_SERVICE_PRIORITY = 89;
+/** Printer service provider. */
+export const PRINTER_SERVICE_PRIORITY = 80;
+/** Prompter service provider. */
+export const PROMPTER_SERVICE_PRIORITY = 75;
+/** Table generator service provider. */
+export const TABLE_GENERATOR_SERVICE_PRIORITY = 70;
+/** Argument prompter service provider: below the prompter it uses. */
+export const ARGUMENT_PROMPTER_SERVICE_PRIORITY = 65;
+/** Spawn service provider. */
+export const SPAWN_SERVICE_PRIORITY = 58;
+/** Fetch service provider. */
+export const FETCH_SERVICE_PRIORITY = 57;
+/** Upgrade service provider: below the spawn and fetch services it uses. */
+export const UPGRADE_SERVICE_PRIORITY = 56;
+/** Background startup task which refreshes the cached upgrade check result. */
+export const UPGRADE_CHECK_STARTUP_TASK_PRIORITY = 56;
+/** Image printer service provider. */
+export const IMAGE_PRINTER_SERVICE_PRIORITY = 55;
+/** Plugin service provider. */
+export const PLUGIN_SERVICE_PRIORITY = 50;
+/**
+ * Startup task which prompts to enable automatic upgrades and performs them. It runs below
+ * consumer startup tasks such as the banner (typically 45 or more) and above the completion
+ * prompt.
+ */
+export const AUTO_UPGRADE_STARTUP_TASK_PRIORITY = 10;
+/** Completion service provider, whose `initService()` prompts to enable shell completion. */
+export const COMPLETION_SERVICE_PRIORITY = 5;
+/** Shutdown tasks which clean up in-flight work (spinners, progress bars, spawns, fetches). */
+export const CLEANUP_SHUTDOWN_TASK_PRIORITY = 0;
+/** Shutdown task which flushes key-value data to the config file, after all other cleanup. */
+export const KEY_VALUE_FLUSH_SHUTDOWN_TASK_PRIORITY = -100;

package/dist/src/service/configuration/KeyValueServiceProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KeyValueServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/configuration/KeyValueServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,yCAAyC,CAAC;AAIjD,OAAO,KAAK,4BAA4B,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AA+BlF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAwB,YAAW,eAAe;;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAwB;IAClD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAIjC,SAAgB,sBAAsB,EAAE,OAAO,CAAC;IAChD,SAAgB,oBAAoB,EAAE,OAAO,CAAC;IAW9C;;;;;;;;OAQG;IACH,YACE,eAAe,EAAE,MAAM,EACvB,4BAA4B,EAAE,4BAA4B,EAC1D,sBAAsB,UAAQ,EAC9B,oBAAoB,UAAQ,EAY7B;IAEM,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAUhE;IAED;;;;;;;;;;OAUG;IACI,wBAAwB,CAC7B,SAAS,EAAE,wBAAwB,EACnC,QAAQ,EAAE,MAAM,GACf,eAAe,CAsBjB;IAED;;;;;;;;;;;;;;OAcG;IACI,kBAAkB,CACvB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,wBAAwB,EACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAaT;IAeY,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxD;CACF"}
+{"version":3,"file":"KeyValueServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/configuration/KeyValueServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,KAAK,EACV,eAAe,EAGhB,MAAM,yCAAyC,CAAC;AAIjD,OAAO,KAAK,4BAA4B,MAAM,mCAAmC,CAAC;AAClF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAgClF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,MAAM,CAAC,OAAO,OAAO,uBAAwB,YAAW,eAAe;;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAwB;IAClD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAIjC,SAAgB,sBAAsB,EAAE,OAAO,CAAC;IAChD,SAAgB,oBAAoB,EAAE,OAAO,CAAC;IAW9C;;;;;;;;OAQG;IACH,YACE,eAAe,EAAE,MAAM,EACvB,4BAA4B,EAAE,4BAA4B,EAC1D,sBAAsB,UAAQ,EAC9B,oBAAoB,UAAQ,EAY7B;IAEM,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAUhE;IAED;;;;;;;;;;OAUG;IACI,wBAAwB,CAC7B,SAAS,EAAE,wBAAwB,EACnC,QAAQ,EAAE,MAAM,GACf,eAAe,CAsBjB;IAED;;;;;;;;;;;;;;OAcG;IACI,kBAAkB,CACvB,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,wBAAwB,EACnC,QAAQ,EAAE,MAAM,GACf,OAAO,CAaT;IAeY,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CASxD;CACF"}

package/dist/src/service/configuration/KeyValueServiceProvider.js

@@ -1,6 +1,7 @@
 import { KEY_VALUE_SERVICE_ID, SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import DefaultKeyValueService from "./DefaultKeyValueService.js";
 import DefaultSecretService from "./DefaultSecretService.js";
+import { KEY_VALUE_FLUSH_SHUTDOWN_TASK_PRIORITY } from "../../runtime/lifecycle/priorities.js";
 /**
  * Registered under {@link KEY_VALUE_SERVICE_ID} in the plain, undecorated {@link Context} purely
  * so {@link Context.doesServiceExist} reports correctly - every real access goes through a
@@ -198,9 +199,7 @@ export default class KeyValueServiceProvider {
             const shutdownService = context.getServiceById(SHUTDOWN_SERVICE_ID);
             shutdownService.registerTask({
                 id: `${KEY_VALUE_SERVICE_ID}-flush`,
-                // low priority - shutdown tasks run in descending priority order, so this runs after
-                // other shutdown cleanup (which defaults to priority 0).
-                priority: -100,
+                priority: KEY_VALUE_FLUSH_SHUTDOWN_TASK_PRIORITY,
                 run: () => this.#flushDirtyScopes(),
             });
         }

package/dist/src/service/fetch/DefaultFetchService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultFetchService.d.ts","sourceRoot":"","sources":["../../../../src/service/fetch/DefaultFetchService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,YAAY,EAEb,MAAM,yCAAyC,CAAC;AAMjD,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,YAAY;;IAGvD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExC;IAEY,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyCrF;CACF"}
+{"version":3,"file":"DefaultFetchService.d.ts","sourceRoot":"","sources":["../../../../src/service/fetch/DefaultFetchService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,YAAY,EACZ,YAAY,EAEb,MAAM,yCAAyC,CAAC;AAOjD,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,YAAY;;IAGvD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExC;IAEY,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyCrF;CACF"}

package/dist/src/service/fetch/DefaultFetchService.js

@@ -1,5 +1,6 @@
 import { SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import getLogger from "../../util/logger.js";
+import { CLEANUP_SHUTDOWN_TASK_PRIORITY } from "../../runtime/lifecycle/priorities.js";
 const logger = getLogger("DefaultFetchService");
 export default class DefaultFetchService {
     #context;
@@ -26,7 +27,7 @@ export default class DefaultFetchService {
             shutdownService.enterLongRunningMode();
             shutdownService.registerTask({
                 id: `fetch:${input.toString()}`,
-                priority: 0,
+                priority: CLEANUP_SHUTDOWN_TASK_PRIORITY,
                 run: async () => {
                     if (settled) {
                         return;

package/dist/src/service/printer/PrinterServiceProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PrinterServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/printer/PrinterServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAK9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAIzE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,eAAe;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAsB;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;;;;OAKG;IACH,YAAmB,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAGzE;IAEM,cAAc,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAUjE;IAED,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3C;CACF"}
+{"version":3,"file":"PrinterServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/printer/PrinterServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAK9E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,eAAe;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAsB;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAExC;;;;;OAKG;IACH,YAAmB,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAGzE;IAEM,cAAc,CAAC,UAAU,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAUjE;IAED,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAY3C;CACF"}

package/dist/src/service/printer/PrinterServiceProvider.js

@@ -4,6 +4,7 @@ import DarkModeCommand from "./command/DarkModeCommand.js";
 import NoColorCommand from "./command/NoColorCommand.js";
 import NoHyperlinksCommand from "./command/NoHyperlinksCommand.js";
 import { SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import { CLEANUP_SHUTDOWN_TASK_PRIORITY } from "../../runtime/lifecycle/priorities.js";
 /**
  * Provides a {@link PrinterService}.
  */
@@ -36,7 +37,7 @@ export default class PrinterServiceProvider {
         const shutdownService = context.getServiceById(SHUTDOWN_SERVICE_ID);
         shutdownService.registerTask({
             id: PRINTER_SERVICE_ID,
-            priority: 0,
+            priority: CLEANUP_SHUTDOWN_TASK_PRIORITY,
             run: async () => {
                 await this.printerService.hideSpinner();
                 await this.printerService.hideAllProgressBars();

package/dist/src/service/spawn/DefaultSpawnService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DefaultSpawnService.d.ts","sourceRoot":"","sources":["../../../../src/service/spawn/DefaultSpawnService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EAGP,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,yCAAyC,CAAC;AAQjD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAa3E;AAED,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,YAAY;;IAGvD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExC;IA+CY,KAAK,CAChB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAC9B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA0FtB;CACF"}
+{"version":3,"file":"DefaultSpawnService.d.ts","sourceRoot":"","sources":["../../../../src/service/spawn/DefaultSpawnService.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,OAAO,EAGP,YAAY,EACZ,WAAW,EACX,YAAY,EACb,MAAM,yCAAyC,CAAC;AASjD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAa3E;AAED,MAAM,CAAC,OAAO,OAAO,mBAAoB,YAAW,YAAY;;IAGvD,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAExC;IA+CY,KAAK,CAChB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAC9B,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,WAAW,CAAC,CA0FtB;CACF"}

package/dist/src/service/spawn/DefaultSpawnService.js

@@ -1,6 +1,7 @@
 import process from "node:process";
 import { PRINTER_SERVICE_ID, SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import getLogger from "../../util/logger.js";
+import { CLEANUP_SHUTDOWN_TASK_PRIORITY } from "../../runtime/lifecycle/priorities.js";
 const logger = getLogger("DefaultSpawnService");
 const SHUTDOWN_GRACE_PERIOD_MS = 5000;
 /**
@@ -94,7 +95,7 @@ export default class DefaultSpawnService {
         }
         shutdownService.registerTask({
             id: `spawn:${command.join(" ")}`,
-            priority: 0,
+            priority: CLEANUP_SHUTDOWN_TASK_PRIORITY,
             run: async () => {
                 if (settled) {
                     return;

package/dist/src/service/upgrade/UpgradeServiceProvider.d.ts

@@ -11,6 +11,13 @@ import type { StartupTask } from "@flowscripter/dynamic-cli-framework-api";
  * regular blocking init task) so it can run in `"background"` mode.
  */
 export declare function createUpgradeCheckStartupTask(upgradeService: DefaultUpgradeService, priority: number): StartupTask;
+/**
+ * Build the blocking {@link StartupTask} which offers to enable automatic upgrades and, when they
+ * are enabled, checks for and installs a newer version (see
+ * {@link UpgradeServiceProvider.runAutoUpgrade}). It is registered separately from the provider's
+ * own init task so it can run at a lower priority, after consumer startup tasks such as the banner.
+ */
+export declare function createAutoUpgradeStartupTask(provider: UpgradeServiceProvider, priority: number): StartupTask;
 export default class UpgradeServiceProvider implements ServiceProvider {
     #private;
     readonly serviceId: string;
@@ -19,5 +26,13 @@ export default class UpgradeServiceProvider implements ServiceProvider {
     get upgradeService(): DefaultUpgradeService | undefined;
     getServiceInfo(cliConfig: CLIConfig): Promise<ServiceInfo>;
     initService(context: Context): Promise<void>;
+    /**
+     * Offer to enable automatic upgrades (storing the answer as `upgrade-status` in the upgrade
+     * service's scope) and, when they are enabled, check for and install a newer version. Must be
+     * called after {@link initService}.
+     *
+     * @param context the startup task's context, used to look up the Prompter and Printer services.
+     */
+    runAutoUpgrade(context: Context): Promise<void>;
 }
 //# sourceMappingURL=UpgradeServiceProvider.d.ts.map

package/dist/src/service/upgrade/UpgradeServiceProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UpgradeServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/upgrade/UpgradeServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,OAAO,qBAAqB,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAI3E;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,qBAAqB,EACrC,QAAQ,EAAE,MAAM,GACf,WAAW,CASb;AAED,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,eAAe;;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAsB;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAKjC,YAAmB,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,EAGzE;IAED,IAAW,cAAc,IAAI,qBAAqB,GAAG,SAAS,CAE7D;IAEM,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAOhE;IAEY,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFxD;CAoCF"}
+{"version":3,"file":"UpgradeServiceProvider.d.ts","sourceRoot":"","sources":["../../../../src/service/upgrade/UpgradeServiceProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC5F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAYzE,OAAO,qBAAqB,MAAM,4BAA4B,CAAC;AAE/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAE1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAI3E;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,cAAc,EAAE,qBAAqB,EACrC,QAAQ,EAAE,MAAM,GACf,WAAW,CASb;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,MAAM,GACf,WAAW,CAOb;AAED,MAAM,CAAC,OAAO,OAAO,sBAAuB,YAAW,eAAe;;IACpE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAsB;IAChD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAMjC,YAAmB,eAAe,EAAE,MAAM,EAAE,MAAM,EAAE,sBAAsB,EAGzE;IAED,IAAW,cAAc,IAAI,qBAAqB,GAAG,SAAS,CAE7D;IAEM,cAAc,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,WAAW,CAAC,CAOhE;IAEM,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBlD;IAED;;;;;;OAMG;IACU,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAqE3D;CAoCF"}

package/dist/src/service/upgrade/UpgradeServiceProvider.js

@@ -24,12 +24,27 @@ export function createUpgradeCheckStartupTask(upgradeService, priority) {
         },
     };
 }
+/**
+ * Build the blocking {@link StartupTask} which offers to enable automatic upgrades and, when they
+ * are enabled, checks for and installs a newer version (see
+ * {@link UpgradeServiceProvider.runAutoUpgrade}). It is registered separately from the provider's
+ * own init task so it can run at a lower priority, after consumer startup tasks such as the banner.
+ */
+export function createAutoUpgradeStartupTask(provider, priority) {
+    return {
+        id: `${UPGRADE_SERVICE_ID}-auto-upgrade`,
+        priority,
+        mode: "blocking",
+        run: (context) => provider.runAutoUpgrade(context),
+    };
+}
 export default class UpgradeServiceProvider {
     serviceId = UPGRADE_SERVICE_ID;
     servicePriority;
     #config;
     #upgradeService;
     #cliConfig;
+    #keyValueService;
     constructor(servicePriority, config) {
         this.servicePriority = servicePriority;
         this.#config = config;
@@ -45,9 +60,8 @@ export default class UpgradeServiceProvider {
             commands: [new UpgradeSubCommand()],
         });
     }
-    async initService(context) {
+    initService(context) {
         const upgradeService = this.#upgradeService;
-        const cliConfig = this.#cliConfig;
         const spawnService = context.doesServiceExist(SPAWN_SERVICE_ID)
             ? context.getServiceById(SPAWN_SERVICE_ID)
             : undefined;
@@ -60,10 +74,25 @@ export default class UpgradeServiceProvider {
         if (fetchService === undefined) {
             logger.debug(() => "FetchService not available, upgrade version checks will be unavailable");
         }
-        const keyValueService = context.doesServiceExist(KEY_VALUE_SERVICE_ID)
+        // the KeyValueService from this context is bound to the upgrade service's own scope, so it is
+        // kept for runAutoUpgrade(), whose task context is scoped to the task ID instead
+        this.#keyValueService = context.doesServiceExist(KEY_VALUE_SERVICE_ID)
             ? context.getServiceById(KEY_VALUE_SERVICE_ID)
             : undefined;
         upgradeService.setContext(context);
+        return Promise.resolve();
+    }
+    /**
+     * Offer to enable automatic upgrades (storing the answer as `upgrade-status` in the upgrade
+     * service's scope) and, when they are enabled, check for and install a newer version. Must be
+     * called after {@link initService}.
+     *
+     * @param context the startup task's context, used to look up the Prompter and Printer services.
+     */
+    async runAutoUpgrade(context) {
+        const upgradeService = this.#upgradeService;
+        const cliConfig = this.#cliConfig;
+        const keyValueService = this.#keyValueService;
         if (!context.doesServiceExist(PROMPTER_SERVICE_ID)) {
             logger.debug(() => "PrompterService not available, skipping auto-upgrade");
             return;

package/dist/src/startup/banner/bannerStartupTask.d.ts

@@ -1,15 +1,15 @@
 import type { StartupTask } from "@flowscripter/dynamic-cli-framework-api";
 export declare const BANNER_STARTUP_TASK_ID = "@flowscripter/dynamic-cli-framework/banner-startup-task";
 /**
- * Build the ascii banner {@link StartupTask}, replacing the old `BannerServiceProvider`.
+ * Build the ascii banner {@link StartupTask}.
  *
  * A consumer opts in by passing the result of this function in the `serviceProviders` array
  * argument of {@link launchMultiCommandCLI}/{@link launchSingleCommandCLI} (or via
- * `BaseCLI.addStartupTask`), the same way `new BannerServiceProvider(priority)` used to be passed
- * in that array - there's no default/automatic banner registration.
+ * `BaseCLI.addStartupTask`) - there's no default/automatic banner registration.
  *
- * @param priority the priority of the task (higher runs earlier - the same semantics
- * `BannerServiceProvider.servicePriority` had).
+ * @param priority the priority of the task (higher runs earlier). It must be above
+ * `AUTO_UPGRADE_STARTUP_TASK_PRIORITY` (10) for the banner to print before the automatic upgrade
+ * prompt and upgrade.
  * @param fontName an optional [FIGlet](http://www.figlet.org) font name to use for the banner,
  * defaults to "standard".
  */

package/dist/src/startup/banner/bannerStartupTask.js

@@ -3,15 +3,15 @@ import DefaultUpgradeService from "../../service/upgrade/DefaultUpgradeService.j
 import NoBannerCommand, {} from "./command/NoBannerCommand.js";
 export const BANNER_STARTUP_TASK_ID = "@flowscripter/dynamic-cli-framework/banner-startup-task";
 /**
- * Build the ascii banner {@link StartupTask}, replacing the old `BannerServiceProvider`.
+ * Build the ascii banner {@link StartupTask}.
  *
  * A consumer opts in by passing the result of this function in the `serviceProviders` array
  * argument of {@link launchMultiCommandCLI}/{@link launchSingleCommandCLI} (or via
- * `BaseCLI.addStartupTask`), the same way `new BannerServiceProvider(priority)` used to be passed
- * in that array - there's no default/automatic banner registration.
+ * `BaseCLI.addStartupTask`) - there's no default/automatic banner registration.
  *
- * @param priority the priority of the task (higher runs earlier - the same semantics
- * `BannerServiceProvider.servicePriority` had).
+ * @param priority the priority of the task (higher runs earlier). It must be above
+ * `AUTO_UPGRADE_STARTUP_TASK_PRIORITY` (10) for the banner to print before the automatic upgrade
+ * prompt and upgrade.
  * @param fontName an optional [FIGlet](http://www.figlet.org) font name to use for the banner,
  * defaults to "standard".
  */

package/index.ts

@@ -207,6 +207,26 @@ export { default as PluginServiceProvider } from "./src/service/plugin/PluginSer
 
 // Core CLI
 export { default as BaseCLI } from "./src/cli/BaseCLI.ts";
+export {
+  SHUTDOWN_SERVICE_PRIORITY,
+  STARTUP_SERVICE_PRIORITY,
+  CONFIGURATION_SERVICE_PRIORITY,
+  KEY_VALUE_SERVICE_PRIORITY,
+  PRINTER_SERVICE_PRIORITY,
+  PROMPTER_SERVICE_PRIORITY,
+  TABLE_GENERATOR_SERVICE_PRIORITY,
+  ARGUMENT_PROMPTER_SERVICE_PRIORITY,
+  SPAWN_SERVICE_PRIORITY,
+  FETCH_SERVICE_PRIORITY,
+  UPGRADE_SERVICE_PRIORITY,
+  UPGRADE_CHECK_STARTUP_TASK_PRIORITY,
+  IMAGE_PRINTER_SERVICE_PRIORITY,
+  PLUGIN_SERVICE_PRIORITY,
+  AUTO_UPGRADE_STARTUP_TASK_PRIORITY,
+  COMPLETION_SERVICE_PRIORITY,
+  CLEANUP_SHUTDOWN_TASK_PRIORITY,
+  KEY_VALUE_FLUSH_SHUTDOWN_TASK_PRIORITY,
+} from "./src/runtime/lifecycle/priorities.ts";
 export { default as DefaultRuntimeCLI } from "./src/cli/DefaultRuntimeCLI.ts";
 
 // Terminal API

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowscripter/dynamic-cli-framework",
-  "version": "7.0.10",
+  "version": "7.0.11",
   "description": "A framework for developing CLI applications which supports dynamic discovery and installation of new commands",
   "keywords": [
     "bun",

package/src/cli/BaseCLI.ts

@@ -57,9 +57,28 @@ import ImagePrinterServiceProvider from "../service/imagePrinter/ImagePrinterSer
 import SpawnServiceProvider from "../service/spawn/SpawnServiceProvider.ts";
 import FetchServiceProvider from "../service/fetch/FetchServiceProvider.ts";
 import UpgradeServiceProvider, {
+  createAutoUpgradeStartupTask,
   createUpgradeCheckStartupTask,
 } from "../service/upgrade/UpgradeServiceProvider.ts";
 import PluginServiceProvider from "../service/plugin/PluginServiceProvider.ts";
+import {
+  ARGUMENT_PROMPTER_SERVICE_PRIORITY,
+  AUTO_UPGRADE_STARTUP_TASK_PRIORITY,
+  COMPLETION_SERVICE_PRIORITY,
+  CONFIGURATION_SERVICE_PRIORITY,
+  FETCH_SERVICE_PRIORITY,
+  IMAGE_PRINTER_SERVICE_PRIORITY,
+  KEY_VALUE_SERVICE_PRIORITY,
+  PLUGIN_SERVICE_PRIORITY,
+  PRINTER_SERVICE_PRIORITY,
+  PROMPTER_SERVICE_PRIORITY,
+  SHUTDOWN_SERVICE_PRIORITY,
+  SPAWN_SERVICE_PRIORITY,
+  STARTUP_SERVICE_PRIORITY,
+  TABLE_GENERATOR_SERVICE_PRIORITY,
+  UPGRADE_CHECK_STARTUP_TASK_PRIORITY,
+  UPGRADE_SERVICE_PRIORITY,
+} from "../runtime/lifecycle/priorities.ts";
 const logger = getLogger("BaseCLI");
 
 /**
@@ -177,9 +196,7 @@ export default class BaseCLI implements CLI {
     // create a context
     this.#context = new DefaultContext(this.#cliConfig);
 
-    // priority 95 sits between shutdown (100) and configuration (90) - it has no ordering
-    // dependency on anything since its own initService() is a no-op.
-    this.#startupServiceProvider = new StartupServiceProvider(95);
+    this.#startupServiceProvider = new StartupServiceProvider(STARTUP_SERVICE_PRIORITY);
 
     this.#stdoutTerminal = stdoutTerminal;
     this.#printerService = new DefaultPrinterService(
@@ -251,10 +268,12 @@ export default class BaseCLI implements CLI {
     }
 
     // create and add core services
-    this.addServiceProvider(new ShutdownServiceProvider(100));
+    this.addServiceProvider(new ShutdownServiceProvider(SHUTDOWN_SERVICE_PRIORITY));
     this.addServiceProvider(this.#startupServiceProvider);
-    this.addServiceProvider(new PrinterServiceProvider(80, this.#printerService));
-    this.addServiceProvider(new TableGeneratorServiceProvider(70));
+    this.addServiceProvider(
+      new PrinterServiceProvider(PRINTER_SERVICE_PRIORITY, this.#printerService),
+    );
+    this.addServiceProvider(new TableGeneratorServiceProvider(TABLE_GENERATOR_SERVICE_PRIORITY));
 
     const canPrompt = this.#keyReader !== undefined && this.#stderrTerminal.isTty();
 
@@ -271,7 +290,9 @@ export default class BaseCLI implements CLI {
         this.#printerService,
       );
       prompterService.promptEnabled = this.#options.promptingEnabled;
-      this.addServiceProvider(new PrompterServiceProvider(75, prompterService));
+      this.addServiceProvider(
+        new PrompterServiceProvider(PROMPTER_SERVICE_PRIORITY, prompterService),
+      );
     } else {
       logger.debug(
         () =>
@@ -284,7 +305,12 @@ export default class BaseCLI implements CLI {
     if (this.#options.argumentPrompterServiceEnabled) {
       if (prompterService !== undefined) {
         const argumentPrompterService = new DefaultArgumentPrompterService(prompterService);
-        this.addServiceProvider(new ArgumentPrompterServiceProvider(65, argumentPrompterService));
+        this.addServiceProvider(
+          new ArgumentPrompterServiceProvider(
+            ARGUMENT_PROMPTER_SERVICE_PRIORITY,
+            argumentPrompterService,
+          ),
+        );
       } else {
         logger.debug(
           "Skipping ArgumentPrompterServiceProvider: argumentPrompterServiceEnabled is true but prompting is unavailable",
@@ -294,7 +320,9 @@ export default class BaseCLI implements CLI {
 
     if (this.#options.imagePrinterServiceEnabled) {
       if (this.#stdoutTerminal.isTty()) {
-        this.addServiceProvider(new ImagePrinterServiceProvider(55, this.#stdoutTerminal));
+        this.addServiceProvider(
+          new ImagePrinterServiceProvider(IMAGE_PRINTER_SERVICE_PRIORITY, this.#stdoutTerminal),
+        );
       } else {
         logger.debug(
           "Skipping ImagePrinterServiceProvider: imagePrinterServiceEnabled is true but stdout is not a TTY",
@@ -305,32 +333,37 @@ export default class BaseCLI implements CLI {
     // The plugin service routes package manager output through SpawnService so that it is
     // quoted, marked and cleared on success; enabling plugins therefore also enables spawning.
     if (this.#options.spawnServiceEnabled || this.#options.pluginServiceEnabled) {
-      this.addServiceProvider(new SpawnServiceProvider(58));
+      this.addServiceProvider(new SpawnServiceProvider(SPAWN_SERVICE_PRIORITY));
     }
 
     if (this.#options.fetchServiceEnabled) {
-      this.addServiceProvider(new FetchServiceProvider(57));
+      this.addServiceProvider(new FetchServiceProvider(FETCH_SERVICE_PRIORITY));
     }
 
     if (this.#options.completionServiceEnabled) {
       const completionService = new DefaultCompletionService();
       this.addServiceProvider(
-        new CompletionServiceProvider(5, completionService, this.#commandRegistry),
+        new CompletionServiceProvider(
+          COMPLETION_SERVICE_PRIORITY,
+          completionService,
+          this.#commandRegistry,
+        ),
       );
     }
 
     let upgradeServiceProvider: UpgradeServiceProvider | undefined;
     if (this.#options.upgradeServiceEnabled) {
-      // 56 runs after Spawn(58)/Fetch(57) - whose dependencies it needs
-      // but before the consumer-configured Banner/Plugin(50) priority band.
-      upgradeServiceProvider = new UpgradeServiceProvider(56, this.#options.upgradeLocationsConfig);
+      upgradeServiceProvider = new UpgradeServiceProvider(
+        UPGRADE_SERVICE_PRIORITY,
+        this.#options.upgradeLocationsConfig,
+      );
       this.addServiceProvider(upgradeServiceProvider);
     }
 
     if (this.#options.pluginServiceEnabled) {
       this.addServiceProvider(
         new PluginServiceProvider(
-          50,
+          PLUGIN_SERVICE_PRIORITY,
           this.#options.pluginServiceRemoteConfig,
           this.#options.pluginServiceLocalConfig,
           this.#commandRegistry,
@@ -340,16 +373,14 @@ export default class BaseCLI implements CLI {
     }
 
     const configurationServiceProvider = new ConfigurationServiceProvider(
-      90,
+      CONFIGURATION_SERVICE_PRIORITY,
       this.#options.envVarsSupportEnabled,
       this.#options.configFileSupportEnabled,
       this.#options.secretServiceEnabled,
     );
     this.addServiceProvider(configurationServiceProvider);
-    // priority 89 sits just below ConfigurationServiceProvider's 90 - its config-file read
-    // happens in its own initService(), before KeyValueServiceProvider's initService() runs.
     const keyValueServiceProvider = new KeyValueServiceProvider(
-      89,
+      KEY_VALUE_SERVICE_PRIORITY,
       configurationServiceProvider,
       this.#options.keyValueServiceEnabled,
       this.#options.secretServiceEnabled,
@@ -369,7 +400,15 @@ export default class BaseCLI implements CLI {
     }
 
     if (upgradeServiceProvider?.upgradeService) {
-      this.addStartupTask(createUpgradeCheckStartupTask(upgradeServiceProvider.upgradeService, 56));
+      this.addStartupTask(
+        createUpgradeCheckStartupTask(
+          upgradeServiceProvider.upgradeService,
+          UPGRADE_CHECK_STARTUP_TASK_PRIORITY,
+        ),
+      );
+      this.addStartupTask(
+        createAutoUpgradeStartupTask(upgradeServiceProvider, AUTO_UPGRADE_STARTUP_TASK_PRIORITY),
+      );
     }
 
     // directly-registered StartupTasks (e.g. the banner task) aren't backed by a ServiceProvider,

package/src/runtime/lifecycle/priorities.ts

@@ -0,0 +1,67 @@
+/**
+ * Priorities of the framework's built-in service providers, startup tasks and shutdown tasks.
+ * Higher values run earlier (see {@link sortByPriority}). Service provider priorities also order
+ * their `initService()` calls within the startup sequence: when a provider and a directly
+ * registered startup task share a priority, the provider runs first.
+ *
+ * Consumer service providers and startup tasks (e.g. the banner task) choose their own
+ * priorities relative to these.
+ */
+
+/** Shutdown service provider: first, so signal handling is in place before anything else. */
+export const SHUTDOWN_SERVICE_PRIORITY = 100;
+
+/** Startup service provider: no ordering dependency, as its `initService()` is a no-op. */
+export const STARTUP_SERVICE_PRIORITY = 95;
+
+/** Configuration service provider: reads the config file in its `initService()`. */
+export const CONFIGURATION_SERVICE_PRIORITY = 90;
+
+/** Key-value service provider: just below configuration, whose config-file read it depends on. */
+export const KEY_VALUE_SERVICE_PRIORITY = 89;
+
+/** Printer service provider. */
+export const PRINTER_SERVICE_PRIORITY = 80;
+
+/** Prompter service provider. */
+export const PROMPTER_SERVICE_PRIORITY = 75;
+
+/** Table generator service provider. */
+export const TABLE_GENERATOR_SERVICE_PRIORITY = 70;
+
+/** Argument prompter service provider: below the prompter it uses. */
+export const ARGUMENT_PROMPTER_SERVICE_PRIORITY = 65;
+
+/** Spawn service provider. */
+export const SPAWN_SERVICE_PRIORITY = 58;
+
+/** Fetch service provider. */
+export const FETCH_SERVICE_PRIORITY = 57;
+
+/** Upgrade service provider: below the spawn and fetch services it uses. */
+export const UPGRADE_SERVICE_PRIORITY = 56;
+
+/** Background startup task which refreshes the cached upgrade check result. */
+export const UPGRADE_CHECK_STARTUP_TASK_PRIORITY = 56;
+
+/** Image printer service provider. */
+export const IMAGE_PRINTER_SERVICE_PRIORITY = 55;
+
+/** Plugin service provider. */
+export const PLUGIN_SERVICE_PRIORITY = 50;
+
+/**
+ * Startup task which prompts to enable automatic upgrades and performs them. It runs below
+ * consumer startup tasks such as the banner (typically 45 or more) and above the completion
+ * prompt.
+ */
+export const AUTO_UPGRADE_STARTUP_TASK_PRIORITY = 10;
+
+/** Completion service provider, whose `initService()` prompts to enable shell completion. */
+export const COMPLETION_SERVICE_PRIORITY = 5;
+
+/** Shutdown tasks which clean up in-flight work (spinners, progress bars, spawns, fetches). */
+export const CLEANUP_SHUTDOWN_TASK_PRIORITY = 0;
+
+/** Shutdown task which flushes key-value data to the config file, after all other cleanup. */
+export const KEY_VALUE_FLUSH_SHUTDOWN_TASK_PRIORITY = -100;

package/src/service/configuration/KeyValueServiceProvider.ts

@@ -12,6 +12,7 @@ import DefaultSecretService from "./DefaultSecretService.ts";
 import type ConfigurationServiceProvider from "./ConfigurationServiceProvider.ts";
 import type { KeyValueServiceScopeType } from "./ConfigurationServiceProvider.ts";
 import type DefaultContext from "../../runtime/DefaultContext.ts";
+import { KEY_VALUE_FLUSH_SHUTDOWN_TASK_PRIORITY } from "../../runtime/lifecycle/priorities.ts";
 
 /**
  * Registered under {@link KEY_VALUE_SERVICE_ID} in the plain, undecorated {@link Context} purely
@@ -245,9 +246,7 @@ export default class KeyValueServiceProvider implements ServiceProvider {
       const shutdownService = context.getServiceById(SHUTDOWN_SERVICE_ID) as ShutdownService;
       shutdownService.registerTask({
         id: `${KEY_VALUE_SERVICE_ID}-flush`,
-        // low priority - shutdown tasks run in descending priority order, so this runs after
-        // other shutdown cleanup (which defaults to priority 0).
-        priority: -100,
+        priority: KEY_VALUE_FLUSH_SHUTDOWN_TASK_PRIORITY,
         run: () => this.#flushDirtyScopes(),
       });
     }

package/src/service/fetch/DefaultFetchService.ts

@@ -6,6 +6,7 @@ import type {
 } from "@flowscripter/dynamic-cli-framework-api";
 import { SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import getLogger from "../../util/logger.ts";
+import { CLEANUP_SHUTDOWN_TASK_PRIORITY } from "../../runtime/lifecycle/priorities.ts";
 
 const logger = getLogger("DefaultFetchService");
 
@@ -38,7 +39,7 @@ export default class DefaultFetchService implements FetchService {
       shutdownService.enterLongRunningMode();
       shutdownService.registerTask({
         id: `fetch:${input.toString()}`,
-        priority: 0,
+        priority: CLEANUP_SHUTDOWN_TASK_PRIORITY,
         run: async () => {
           if (settled) {
             return;

package/src/service/printer/PrinterServiceProvider.ts

@@ -9,6 +9,7 @@ import NoHyperlinksCommand from "./command/NoHyperlinksCommand.ts";
 import type { CLIConfig } from "@flowscripter/dynamic-cli-framework-api";
 import type { ShutdownService } from "@flowscripter/dynamic-cli-framework-api";
 import { SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
+import { CLEANUP_SHUTDOWN_TASK_PRIORITY } from "../../runtime/lifecycle/priorities.ts";
 
 /**
  * Provides a {@link PrinterService}.
@@ -45,7 +46,7 @@ export default class PrinterServiceProvider implements ServiceProvider {
     const shutdownService = context.getServiceById(SHUTDOWN_SERVICE_ID) as ShutdownService;
     shutdownService.registerTask({
       id: PRINTER_SERVICE_ID,
-      priority: 0,
+      priority: CLEANUP_SHUTDOWN_TASK_PRIORITY,
       run: async () => {
         await this.printerService.hideSpinner();
         await this.printerService.hideAllProgressBars();

package/src/service/spawn/DefaultSpawnService.ts

@@ -9,6 +9,7 @@ import type {
 } from "@flowscripter/dynamic-cli-framework-api";
 import { PRINTER_SERVICE_ID, SHUTDOWN_SERVICE_ID } from "@flowscripter/dynamic-cli-framework-api";
 import getLogger from "../../util/logger.ts";
+import { CLEANUP_SHUTDOWN_TASK_PRIORITY } from "../../runtime/lifecycle/priorities.ts";
 
 const logger = getLogger("DefaultSpawnService");
 
@@ -124,7 +125,7 @@ export default class DefaultSpawnService implements SpawnService {
 
     shutdownService.registerTask({
       id: `spawn:${command.join(" ")}`,
-      priority: 0,
+      priority: CLEANUP_SHUTDOWN_TASK_PRIORITY,
       run: async () => {
         if (settled) {
           return;

package/src/service/upgrade/UpgradeServiceProvider.ts

@@ -40,12 +40,31 @@ export function createUpgradeCheckStartupTask(
   };
 }
 
+/**
+ * Build the blocking {@link StartupTask} which offers to enable automatic upgrades and, when they
+ * are enabled, checks for and installs a newer version (see
+ * {@link UpgradeServiceProvider.runAutoUpgrade}). It is registered separately from the provider's
+ * own init task so it can run at a lower priority, after consumer startup tasks such as the banner.
+ */
+export function createAutoUpgradeStartupTask(
+  provider: UpgradeServiceProvider,
+  priority: number,
+): StartupTask {
+  return {
+    id: `${UPGRADE_SERVICE_ID}-auto-upgrade`,
+    priority,
+    mode: "blocking",
+    run: (context: Context) => provider.runAutoUpgrade(context),
+  };
+}
+
 export default class UpgradeServiceProvider implements ServiceProvider {
   readonly serviceId: string = UPGRADE_SERVICE_ID;
   readonly servicePriority: number;
   readonly #config: UpgradeLocationsConfig;
   #upgradeService: DefaultUpgradeService | undefined;
   #cliConfig: CLIConfig | undefined;
+  #keyValueService: KeyValueService | undefined;
 
   public constructor(servicePriority: number, config: UpgradeLocationsConfig) {
     this.servicePriority = servicePriority;
@@ -65,9 +84,8 @@ export default class UpgradeServiceProvider implements ServiceProvider {
     });
   }
 
-  public async initService(context: Context): Promise<void> {
+  public initService(context: Context): Promise<void> {
     const upgradeService = this.#upgradeService!;
-    const cliConfig = this.#cliConfig!;
 
     const spawnService = context.doesServiceExist(SPAWN_SERVICE_ID)
       ? (context.getServiceById(SPAWN_SERVICE_ID) as SpawnService)
@@ -81,10 +99,26 @@ export default class UpgradeServiceProvider implements ServiceProvider {
     if (fetchService === undefined) {
       logger.debug(() => "FetchService not available, upgrade version checks will be unavailable");
     }
-    const keyValueService = context.doesServiceExist(KEY_VALUE_SERVICE_ID)
+    // the KeyValueService from this context is bound to the upgrade service's own scope, so it is
+    // kept for runAutoUpgrade(), whose task context is scoped to the task ID instead
+    this.#keyValueService = context.doesServiceExist(KEY_VALUE_SERVICE_ID)
       ? (context.getServiceById(KEY_VALUE_SERVICE_ID) as KeyValueService)
       : undefined;
     upgradeService.setContext(context);
+    return Promise.resolve();
+  }
+
+  /**
+   * Offer to enable automatic upgrades (storing the answer as `upgrade-status` in the upgrade
+   * service's scope) and, when they are enabled, check for and install a newer version. Must be
+   * called after {@link initService}.
+   *
+   * @param context the startup task's context, used to look up the Prompter and Printer services.
+   */
+  public async runAutoUpgrade(context: Context): Promise<void> {
+    const upgradeService = this.#upgradeService!;
+    const cliConfig = this.#cliConfig!;
+    const keyValueService = this.#keyValueService;
 
     if (!context.doesServiceExist(PROMPTER_SERVICE_ID)) {
       logger.debug(() => "PrompterService not available, skipping auto-upgrade");

package/src/startup/banner/bannerStartupTask.ts

@@ -13,15 +13,15 @@ import NoBannerCommand, { type BannerState } from "./command/NoBannerCommand.ts"
 export const BANNER_STARTUP_TASK_ID = "@flowscripter/dynamic-cli-framework/banner-startup-task";
 
 /**
- * Build the ascii banner {@link StartupTask}, replacing the old `BannerServiceProvider`.
+ * Build the ascii banner {@link StartupTask}.
  *
  * A consumer opts in by passing the result of this function in the `serviceProviders` array
  * argument of {@link launchMultiCommandCLI}/{@link launchSingleCommandCLI} (or via
- * `BaseCLI.addStartupTask`), the same way `new BannerServiceProvider(priority)` used to be passed
- * in that array - there's no default/automatic banner registration.
+ * `BaseCLI.addStartupTask`) - there's no default/automatic banner registration.
  *
- * @param priority the priority of the task (higher runs earlier - the same semantics
- * `BannerServiceProvider.servicePriority` had).
+ * @param priority the priority of the task (higher runs earlier). It must be above
+ * `AUTO_UPGRADE_STARTUP_TASK_PRIORITY` (10) for the banner to print before the automatic upgrade
+ * prompt and upgrade.
  * @param fontName an optional [FIGlet](http://www.figlet.org) font name to use for the banner,
  * defaults to "standard".
  */