@flowscripter/dynamic-cli-framework-api 3.0.1 → 4.0.1

package/README.md

@@ -27,7 +27,8 @@ Key exports:
 - `CommandFactory`, `ServiceProviderFactory` - extension interfaces implemented by a plugin.
 - `Command`, `SubCommand`, `GlobalCommand`, `GroupCommand` - command types.
 - `Context`, `CLIConfig` - runtime context passed to commands.
-- Core service interfaces and their `*_SERVICE_ID` identifiers (`PrinterService`, `TableGeneratorService`, `SyntaxHighlighterService`, etc.) used to look up services via `Context`.
+- Core service interfaces and their `*_SERVICE_ID` identifiers (`PrinterService`, `TableGeneratorService`, `SyntaxHighlighterService`, `ConfigurationService`, etc.) used to look up services via `Context`.
+- `StartupService`/`StartupTask`, `ShutdownService`/`ShutdownTask` - priority-ordered registration of work to run once during CLI startup/shutdown, via `registerTask({id, priority, run})` on either.
 
 See [dynamic-cli-framework](https://github.com/flowscripter/dynamic-cli-framework)
 for the runnable framework and its concrete service implementations.

package/dist/index.d.ts

@@ -20,6 +20,8 @@ export type { default as ServiceProviderRegistry } from "./src/registry/ServiceP
 export { ASCII_BANNER_GENERATOR_SERVICE_ID } from "./src/service/core/AsciiBannerGeneratorService.ts";
 export type { default as AsciiBannerGeneratorService } from "./src/service/core/AsciiBannerGeneratorService.ts";
 export type { BannerColorEffects, BannerGenerateOptions, ColorEffect, ColorEffectDirection, FixedColorEffect, GradientColorEffect, RainbowColorEffect, } from "./src/service/core/AsciiBannerGeneratorService.ts";
+export { CONFIGURATION_SERVICE_ID } from "./src/service/core/ConfigurationService.ts";
+export type { default as ConfigurationService } from "./src/service/core/ConfigurationService.ts";
 export { KEY_VALUE_SERVICE_ID } from "./src/service/core/KeyValueService.ts";
 export { SECRET_SENTINEL_PREFIX } from "./src/service/core/KeyValueService.ts";
 export { Secret } from "./src/service/core/KeyValueService.ts";
@@ -33,7 +35,9 @@ export type { default as PrinterService } from "./src/service/core/PrinterServic
 export { Icon, Level, ProgressStyle, SpinnerStyle } from "./src/service/core/PrinterService.ts";
 export type { ProgressBarOptions } from "./src/service/core/PrinterService.ts";
 export { SHUTDOWN_SERVICE_ID } from "./src/service/core/ShutdownService.ts";
-export type { default as ShutdownService } from "./src/service/core/ShutdownService.ts";
+export type { default as ShutdownService, ShutdownTask, } from "./src/service/core/ShutdownService.ts";
+export { STARTUP_SERVICE_ID } from "./src/service/core/StartupService.ts";
+export type { default as StartupService, StartupTask, StartupTaskContext, StartupTaskMode, } from "./src/service/core/StartupService.ts";
 export { SPAWN_SERVICE_ID } from "./src/service/core/SpawnService.ts";
 export type { default as SpawnService } from "./src/service/core/SpawnService.ts";
 export type { SpawnOptions, SpawnResult } from "./src/service/core/SpawnService.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

@@ -3,6 +3,7 @@ export { MAXIMUM_COMPLEX_OPTION_NESTING_DEPTH } from "./src/argument/ComplexOpti
 export { MAXIMUM_ARGUMENT_ARRAY_SIZE } from "./src/argument/SubCommandArgument.js";
 // Core Service IDs and types
 export { ASCII_BANNER_GENERATOR_SERVICE_ID } from "./src/service/core/AsciiBannerGeneratorService.js";
+export { CONFIGURATION_SERVICE_ID } from "./src/service/core/ConfigurationService.js";
 export { KEY_VALUE_SERVICE_ID } from "./src/service/core/KeyValueService.js";
 export { SECRET_SENTINEL_PREFIX } from "./src/service/core/KeyValueService.js";
 export { Secret } from "./src/service/core/KeyValueService.js";
@@ -10,6 +11,7 @@ export { FETCH_SERVICE_ID } from "./src/service/core/FetchService.js";
 export { PRINTER_SERVICE_ID } from "./src/service/core/PrinterService.js";
 export { Icon, Level, ProgressStyle, SpinnerStyle } from "./src/service/core/PrinterService.js";
 export { SHUTDOWN_SERVICE_ID } from "./src/service/core/ShutdownService.js";
+export { STARTUP_SERVICE_ID } from "./src/service/core/StartupService.js";
 export { SPAWN_SERVICE_ID } from "./src/service/core/SpawnService.js";
 export { SYNTAX_HIGHLIGHTER_SERVICE_ID } from "./src/service/core/SyntaxHighlighterService.js";
 export { PRETTY_PRINTER_SERVICE_ID } from "./src/service/core/PrettyPrinterService.js";

package/dist/src/service/core/ConfigurationService.d.ts

@@ -0,0 +1,10 @@
+export declare const CONFIGURATION_SERVICE_ID = "@flowscripter/dynamic-cli-framework/configuration-service";
+/**
+ * Minimal, read/write view of a configuration provider's config file *location*, registered under
+ * {@link CONFIGURATION_SERVICE_ID}.
+ */
+export default interface ConfigurationService {
+    readonly configLocation: string | undefined;
+    setConfigLocation(location: string): void;
+}
+//# sourceMappingURL=ConfigurationService.d.ts.map

package/dist/src/service/core/ConfigurationService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConfigurationService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/ConfigurationService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,8DAA8D,CAAC;AAEpG;;;GAGG;AACH,MAAM,CAAC,OAAO,WAAW,oBAAoB;IAC3C,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAE5C,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C"}

package/dist/src/service/core/ConfigurationService.js

@@ -0,0 +1 @@
+export const CONFIGURATION_SERVICE_ID = "@flowscripter/dynamic-cli-framework/configuration-service";

package/dist/src/service/core/ShutdownService.d.ts

@@ -1,12 +1,31 @@
 export declare const SHUTDOWN_SERVICE_ID = "@flowscripter/dynamic-cli-framework/shutdown-service";
 /**
- * Service allowing registration of callbacks for CLI shutdown.
+ * A unit of work to run once during CLI shutdown, in {@link ShutdownTask.priority} order.
+ */
+export interface ShutdownTask {
+    /**
+     * Identifies this task, e.g. for debug logging when a shutdown task is slow or hangs.
+     */
+    readonly id: string;
+    /**
+     * Used to determine the order in which tasks run during shutdown. Higher values run
+     * earlier. Defaults to `0` if not specified; tasks with the same
+     * priority run in registration order.
+     */
+    readonly priority?: number;
+    /**
+     * Perform this task's shutdown work.
+     */
+    run(): Promise<void>;
+}
+/**
+ * Service allowing registration of prioritised tasks to run during CLI shutdown.
  */
 export default interface ShutdownService {
     /**
-     * Register a callback to be invoked during graceful shutdown.
+     * Register a {@link ShutdownTask} to run during graceful shutdown.
      */
-    addShutdownListener(callback: () => Promise<void>): void;
+    registerTask(task: ShutdownTask): void;
     /**
      * Enter long-running mode where the first Ctrl-C sets a cooperative flag
      * instead of exiting, and a third Ctrl-C forces exit.

package/dist/src/service/core/ShutdownService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShutdownService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/ShutdownService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,yDAAyD,CAAC;AAE1F;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,eAAe;IACtC;;OAEG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAEzD;;;OAGG;IACH,oBAAoB,IAAI,IAAI,CAAC;IAE7B;;OAEG;IACH,oBAAoB,IAAI,IAAI,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC"}
+{"version":3,"file":"ShutdownService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/ShutdownService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,yDAAyD,CAAC;AAE1F;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,eAAe;IACtC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAEvC;;;OAGG;IACH,oBAAoB,IAAI,IAAI,CAAC;IAE7B;;OAEG;IACH,oBAAoB,IAAI,IAAI,CAAC;IAE7B;;OAEG;IACH,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC"}

package/dist/src/service/core/StartupService.d.ts

@@ -0,0 +1,55 @@
+import type GlobalModifierCommand from "../../command/GlobalModifierCommand.ts";
+import type CLIConfig from "../../CLIConfig.ts";
+export declare const STARTUP_SERVICE_ID = "@flowscripter/dynamic-cli-framework/startup-service";
+/**
+ * Minimal, read-only view of the CLI's {@link Context} passed to a {@link StartupTask}.
+ */
+export interface StartupTaskContext {
+    readonly cliConfig: CLIConfig;
+    getServiceById(id: string): unknown;
+    doesServiceExist(id: string): boolean;
+}
+/**
+ * A `"blocking"` task is awaited before the next lower-priority task runs.
+ * A `"background"` task is started but not awaited before startup proceeds.
+ */
+export type StartupTaskMode = "blocking" | "background";
+/**
+ * A unit of work to run once during CLI startup, in {@link StartupTask.priority} order.
+ */
+export interface StartupTask {
+    /**
+     * Identifies this task, e.g. for debug logging.
+     */
+    readonly id: string;
+    /**
+     * Used to determine the order in which tasks run. Higher values run earlier.
+     */
+    readonly priority: number;
+    /**
+     * Defaults to `"blocking"` if not specified.
+     */
+    readonly mode?: StartupTaskMode;
+    /**
+     * Zero or more {@link GlobalModifierCommand} instances which should be scanned for and
+     * executed (if specified as CLI arguments or CLI configuration) before this task's
+     * {@link run} is invoked.
+     */
+    readonly modifierCommands?: ReadonlyArray<GlobalModifierCommand>;
+    /**
+     * Perform this task's startup work.
+     *
+     * @param context a {@link StartupTaskContext} view of the CLI's {@link Context}.
+     */
+    run(context: StartupTaskContext): Promise<void>;
+}
+/**
+ * Service allowing registration of prioritised tasks to run once during CLI startup.
+ */
+export default interface StartupService {
+    /**
+     * Register a {@link StartupTask} to run during CLI startup.
+     */
+    registerTask(task: StartupTask): void;
+}
+//# sourceMappingURL=StartupService.d.ts.map

package/dist/src/service/core/StartupService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StartupService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/StartupService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,qBAAqB,MAAM,wCAAwC,CAAC;AAChF,OAAO,KAAK,SAAS,MAAM,oBAAoB,CAAC;AAEhD,eAAO,MAAM,kBAAkB,wDAAwD,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAE9B,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAEpC,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;CACvC;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,YAAY,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAEhC;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAEjE;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,cAAc;IACrC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;CACvC"}

package/dist/src/service/core/StartupService.js

@@ -0,0 +1 @@
+export const STARTUP_SERVICE_ID = "@flowscripter/dynamic-cli-framework/startup-service";

package/dist/src/service/core/UpgradeService.d.ts

@@ -24,10 +24,7 @@ export declare enum InstallMethod {
     GITHUB_RELEASE = "github-release"
 }
 /**
- * Outcome of an {@link UpgradeService.checkForUpgrade} or {@link UpgradeService.getUpgradeCheckResult}
- * call. The `"pending"` status can only be produced by {@link UpgradeService.getUpgradeCheckResult}'s
- * non-blocking bounded wait - `checkForUpgrade()` and a `getUpgradeCheckResult(true)` call always
- * run to completion and so never resolve to it.
+ * Outcome of an {@link UpgradeService.checkForUpgrade} or {@link UpgradeService.getUpgradeCheckResult} call.
  */
 export type UpgradeCheckResult = {
     readonly status: "checked";
@@ -44,9 +41,6 @@ export type UpgradeCheckResult = {
     /** A supported/configured combination was found, but determining the latest version failed. */
     readonly status: "failed";
     readonly error: Error;
-} | {
-    /** The non-blocking bounded wait elapsed before the check completed. */
-    readonly status: "pending";
 };
 /**
  * Outcome of an {@link UpgradeService.upgrade} call.
@@ -88,8 +82,7 @@ export default interface UpgradeService {
      * @param arch optional {@link SupportedArch} override, defaults to the detected value.
      * @param installMethod optional {@link InstallMethod} override, defaults to the detected value.
      *
-     * @return the {@link UpgradeCheckResult}. Runs to completion, so never resolves to the
-     * `"pending"` status. Never rejects.
+     * @return the {@link UpgradeCheckResult}. Runs to completion. Never rejects.
      */
     checkForUpgrade(os?: SupportedOs, arch?: SupportedArch, installMethod?: InstallMethod): Promise<UpgradeCheckResult>;
     /**
@@ -105,15 +98,10 @@ export default interface UpgradeService {
     /**
      * Returns the result of the version check that was started eagerly once this service's
      * dependencies were set (or starts one now, with default/no-override detection, if none has
-     * started yet). Every call is backed by the same cached promise.
-     *
-     * @param waitForResult if `true`, waits for the check to fully resolve, so the result never has
-     * status `"pending"`. If `false` (default), gives up and resolves to a `"pending"` result after
-     * an internal bounded delay, so callers on a startup/opportunistic path are never blocked by a
-     * slow network/spawn call.
+     * started yet).
      *
      * @return the {@link UpgradeCheckResult}. Never rejects.
      */
-    getUpgradeCheckResult(waitForResult?: boolean): Promise<UpgradeCheckResult>;
+    getUpgradeCheckResult(): Promise<UpgradeCheckResult>;
 }
 //# sourceMappingURL=UpgradeService.d.ts.map

package/dist/src/service/core/UpgradeService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UpgradeService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/UpgradeService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,wDAAwD,CAAC;AAExF;;GAEG;AACH,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,cAAc,mBAAmB;CAClC;AAED;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC,GACD;IACE,yGAAyG;IACzG,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC,GACD;IACE,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB,GACD;IACE,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;CAC5B,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,cAAc;IACrC;;;;OAIG;IACH,QAAQ,IAAI,WAAW,GAAG,SAAS,CAAC;IAEpC;;;;OAIG;IACH,UAAU,IAAI,aAAa,GAAG,SAAS,CAAC;IAExC;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAEzE;;;;;;;;;OASG;IACH,eAAe,CACb,EAAE,CAAC,EAAE,WAAW,EAChB,IAAI,CAAC,EAAE,aAAa,EACpB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;;;;OAQG;IACH,OAAO,CACL,EAAE,CAAC,EAAE,WAAW,EAChB,IAAI,CAAC,EAAE,aAAa,EACpB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;;;;;;OAWG;IACH,qBAAqB,CAAC,aAAa,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;CAC7E"}
+{"version":3,"file":"UpgradeService.d.ts","sourceRoot":"","sources":["../../../../src/service/core/UpgradeService.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,kBAAkB,wDAAwD,CAAC;AAExF;;GAEG;AACH,oBAAY,WAAW;IACrB,KAAK,UAAU;IACf,KAAK,UAAU;IACf,OAAO,YAAY;CACpB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,GAAG,QAAQ;IACX,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,oBAAY,aAAa;IACvB,YAAY,iBAAiB;IAC7B,QAAQ,aAAa;IACrB,MAAM,WAAW;IACjB,cAAc,mBAAmB;CAClC;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B;IACE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,EAAE,EAAE,WAAW,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;CACvC,GACD;IACE,yGAAyG;IACzG,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC,GACD;IACE,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACvB,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,CAAC,OAAO,WAAW,cAAc;IACrC;;;;OAIG;IACH,QAAQ,IAAI,WAAW,GAAG,SAAS,CAAC;IAEpC;;;;OAIG;IACH,UAAU,IAAI,aAAa,GAAG,SAAS,CAAC;IAExC;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAEzE;;;;;;;;OAQG;IACH,eAAe,CACb,EAAE,CAAC,EAAE,WAAW,EAChB,IAAI,CAAC,EAAE,aAAa,EACpB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE/B;;;;;;;;OAQG;IACH,OAAO,CACL,EAAE,CAAC,EAAE,WAAW,EAChB,IAAI,CAAC,EAAE,aAAa,EACpB,aAAa,CAAC,EAAE,aAAa,GAC5B,OAAO,CAAC,aAAa,CAAC,CAAC;IAE1B;;;;;;OAMG;IACH,qBAAqB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;CACtD"}

package/index.ts

@@ -46,6 +46,9 @@ export type {
   RainbowColorEffect,
 } from "./src/service/core/AsciiBannerGeneratorService.ts";
 
+export { CONFIGURATION_SERVICE_ID } from "./src/service/core/ConfigurationService.ts";
+export type { default as ConfigurationService } from "./src/service/core/ConfigurationService.ts";
+
 export { KEY_VALUE_SERVICE_ID } from "./src/service/core/KeyValueService.ts";
 export { SECRET_SENTINEL_PREFIX } from "./src/service/core/KeyValueService.ts";
 export { Secret } from "./src/service/core/KeyValueService.ts";
@@ -65,7 +68,18 @@ export { Icon, Level, ProgressStyle, SpinnerStyle } from "./src/service/core/Pri
 export type { ProgressBarOptions } from "./src/service/core/PrinterService.ts";
 
 export { SHUTDOWN_SERVICE_ID } from "./src/service/core/ShutdownService.ts";
-export type { default as ShutdownService } from "./src/service/core/ShutdownService.ts";
+export type {
+  default as ShutdownService,
+  ShutdownTask,
+} from "./src/service/core/ShutdownService.ts";
+
+export { STARTUP_SERVICE_ID } from "./src/service/core/StartupService.ts";
+export type {
+  default as StartupService,
+  StartupTask,
+  StartupTaskContext,
+  StartupTaskMode,
+} from "./src/service/core/StartupService.ts";
 
 export { SPAWN_SERVICE_ID } from "./src/service/core/SpawnService.ts";
 export type { default as SpawnService } from "./src/service/core/SpawnService.ts";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flowscripter/dynamic-cli-framework-api",
-  "version": "3.0.1",
+  "version": "4.0.1",
   "description": "API for https://github.com/flowscripter/dynamic-cli-framework",
   "keywords": [
     "bun",

package/src/service/core/ConfigurationService.ts

@@ -0,0 +1,11 @@
+export const CONFIGURATION_SERVICE_ID = "@flowscripter/dynamic-cli-framework/configuration-service";
+
+/**
+ * Minimal, read/write view of a configuration provider's config file *location*, registered under
+ * {@link CONFIGURATION_SERVICE_ID}.
+ */
+export default interface ConfigurationService {
+  readonly configLocation: string | undefined;
+
+  setConfigLocation(location: string): void;
+}

package/src/service/core/ShutdownService.ts

@@ -1,13 +1,35 @@
 export const SHUTDOWN_SERVICE_ID = "@flowscripter/dynamic-cli-framework/shutdown-service";
 
 /**
- * Service allowing registration of callbacks for CLI shutdown.
+ * A unit of work to run once during CLI shutdown, in {@link ShutdownTask.priority} order.
+ */
+export interface ShutdownTask {
+  /**
+   * Identifies this task, e.g. for debug logging when a shutdown task is slow or hangs.
+   */
+  readonly id: string;
+
+  /**
+   * Used to determine the order in which tasks run during shutdown. Higher values run
+   * earlier. Defaults to `0` if not specified; tasks with the same
+   * priority run in registration order.
+   */
+  readonly priority?: number;
+
+  /**
+   * Perform this task's shutdown work.
+   */
+  run(): Promise<void>;
+}
+
+/**
+ * Service allowing registration of prioritised tasks to run during CLI shutdown.
  */
 export default interface ShutdownService {
   /**
-   * Register a callback to be invoked during graceful shutdown.
+   * Register a {@link ShutdownTask} to run during graceful shutdown.
    */
-  addShutdownListener(callback: () => Promise<void>): void;
+  registerTask(task: ShutdownTask): void;
 
   /**
    * Enter long-running mode where the first Ctrl-C sets a cooperative flag

package/src/service/core/StartupService.ts

@@ -0,0 +1,65 @@
+import type GlobalModifierCommand from "../../command/GlobalModifierCommand.ts";
+import type CLIConfig from "../../CLIConfig.ts";
+
+export const STARTUP_SERVICE_ID = "@flowscripter/dynamic-cli-framework/startup-service";
+
+/**
+ * Minimal, read-only view of the CLI's {@link Context} passed to a {@link StartupTask}.
+ */
+export interface StartupTaskContext {
+  readonly cliConfig: CLIConfig;
+
+  getServiceById(id: string): unknown;
+
+  doesServiceExist(id: string): boolean;
+}
+
+/**
+ * A `"blocking"` task is awaited before the next lower-priority task runs.
+ * A `"background"` task is started but not awaited before startup proceeds.
+ */
+export type StartupTaskMode = "blocking" | "background";
+
+/**
+ * A unit of work to run once during CLI startup, in {@link StartupTask.priority} order.
+ */
+export interface StartupTask {
+  /**
+   * Identifies this task, e.g. for debug logging.
+   */
+  readonly id: string;
+
+  /**
+   * Used to determine the order in which tasks run. Higher values run earlier.
+   */
+  readonly priority: number;
+
+  /**
+   * Defaults to `"blocking"` if not specified.
+   */
+  readonly mode?: StartupTaskMode;
+
+  /**
+   * Zero or more {@link GlobalModifierCommand} instances which should be scanned for and
+   * executed (if specified as CLI arguments or CLI configuration) before this task's
+   * {@link run} is invoked.
+   */
+  readonly modifierCommands?: ReadonlyArray<GlobalModifierCommand>;
+
+  /**
+   * Perform this task's startup work.
+   *
+   * @param context a {@link StartupTaskContext} view of the CLI's {@link Context}.
+   */
+  run(context: StartupTaskContext): Promise<void>;
+}
+
+/**
+ * Service allowing registration of prioritised tasks to run once during CLI startup.
+ */
+export default interface StartupService {
+  /**
+   * Register a {@link StartupTask} to run during CLI startup.
+   */
+  registerTask(task: StartupTask): void;
+}

package/src/service/core/UpgradeService.ts

@@ -28,10 +28,7 @@ export enum InstallMethod {
 }
 
 /**
- * Outcome of an {@link UpgradeService.checkForUpgrade} or {@link UpgradeService.getUpgradeCheckResult}
- * call. The `"pending"` status can only be produced by {@link UpgradeService.getUpgradeCheckResult}'s
- * non-blocking bounded wait - `checkForUpgrade()` and a `getUpgradeCheckResult(true)` call always
- * run to completion and so never resolve to it.
+ * Outcome of an {@link UpgradeService.checkForUpgrade} or {@link UpgradeService.getUpgradeCheckResult} call.
  */
 export type UpgradeCheckResult =
   | {
@@ -51,10 +48,6 @@ export type UpgradeCheckResult =
       /** A supported/configured combination was found, but determining the latest version failed. */
       readonly status: "failed";
       readonly error: Error;
-    }
-  | {
-      /** The non-blocking bounded wait elapsed before the check completed. */
-      readonly status: "pending";
     };
 
 /**
@@ -101,8 +94,7 @@ export default interface UpgradeService {
    * @param arch optional {@link SupportedArch} override, defaults to the detected value.
    * @param installMethod optional {@link InstallMethod} override, defaults to the detected value.
    *
-   * @return the {@link UpgradeCheckResult}. Runs to completion, so never resolves to the
-   * `"pending"` status. Never rejects.
+   * @return the {@link UpgradeCheckResult}. Runs to completion. Never rejects.
    */
   checkForUpgrade(
     os?: SupportedOs,
@@ -128,14 +120,9 @@ export default interface UpgradeService {
   /**
    * Returns the result of the version check that was started eagerly once this service's
    * dependencies were set (or starts one now, with default/no-override detection, if none has
-   * started yet). Every call is backed by the same cached promise.
-   *
-   * @param waitForResult if `true`, waits for the check to fully resolve, so the result never has
-   * status `"pending"`. If `false` (default), gives up and resolves to a `"pending"` result after
-   * an internal bounded delay, so callers on a startup/opportunistic path are never blocked by a
-   * slow network/spawn call.
+   * started yet).
    *
    * @return the {@link UpgradeCheckResult}. Never rejects.
    */
-  getUpgradeCheckResult(waitForResult?: boolean): Promise<UpgradeCheckResult>;
+  getUpgradeCheckResult(): Promise<UpgradeCheckResult>;
 }