@memberjunction/cli 6.2.0-edge.2 → 6.2.0-edge.4

package/dist/commands/user/clone.js

@@ -0,0 +1,106 @@
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { CompositeKey, RunView } from '@memberjunction/core';
+import { RecordCloneEngine } from '@memberjunction/record-cloning';
+import { BuildContextUser, EnsureProviderInitialized } from '../../utils/open-app-context.js';
+/**
+ * CLI command: `mj user clone`.
+ *
+ * Creates a new user as a copy of an existing one through the `MJ: Users` clone configuration. From a
+ * template user (IsTemplate) the default `template` preset copies everything the template was set up
+ * with, dashboards and conversations included; from an ordinary user, choose one of the other presets.
+ * Runs as the system user, so it needs no sign-in; it is meant for administrators and install scripts
+ * (an app's post-install hook pre-provisions the person who will sign in).
+ */
+export default class UserClone extends Command {
+    static { this.description = 'Create a user as a copy of another (a template user by default)'; }
+    static { this.examples = [
+        '<%= config.bin %> user clone --from demo.user@example.org --email jane@example.com --first Jane --last Doe',
+        '<%= config.bin %> user clone --from alice@example.com --email bob@example.com --first Bob --last Lee --preset with-settings',
+        '<%= config.bin %> user clone --from demo.user@example.org --email jane@example.com --first Jane --last Doe --dry-run',
+    ]; }
+    static { this.flags = {
+        from: Flags.string({ description: 'Email of the user to copy', required: true }),
+        email: Flags.string({ description: 'Email of the new user (the identity they sign in with)', required: true }),
+        first: Flags.string({ description: 'First name of the new user', required: true }),
+        last: Flags.string({ description: 'Last name of the new user', required: true }),
+        preset: Flags.string({
+            description: "MJ: Users clone preset: 'template' (template users only), 'with-views', 'with-settings', or none for the base copy",
+            default: 'template',
+        }),
+        inactive: Flags.boolean({ description: 'Leave the new user inactive for review instead of activating it', default: false }),
+        'dry-run': Flags.boolean({ description: 'Show what would be copied without creating anything', default: false }),
+    }; }
+    async run() {
+        const { flags } = await this.parse(UserClone);
+        try {
+            const provider = await EnsureProviderInitialized();
+            const contextUser = await BuildContextUser();
+            const source = await this.findUser(flags.from, contextUser);
+            if (!source)
+                this.error(`No user has the email ${flags.from}.`);
+            if (await this.findUser(flags.email, contextUser)) {
+                this.error(`A user with the email ${flags.email} already exists. Cloning creates a new user; choose another email.`);
+            }
+            const preset = flags.preset === 'none' ? undefined : flags.preset;
+            if (preset === 'template' && !source.IsTemplate) {
+                this.error(`${flags.from} is not a template user. Mark it IsTemplate, or pass --preset with-views, with-settings or none.`);
+            }
+            const result = await new RecordCloneEngine(provider).Clone({
+                EntityName: 'MJ: Users',
+                SourceRecordKey: CompositeKey.FromID(source.ID),
+                Preset: preset,
+                PromptedValues: { Email: flags.email, FirstName: flags.first, LastName: flags.last },
+                Options: { DryRun: flags['dry-run'], Reason: `mj user clone from ${flags.from}` },
+            }, contextUser);
+            for (const w of result.Warnings.filter((w) => w.Severity !== 'Info')) {
+                this.log(chalk[w.Severity === 'Error' ? 'red' : 'yellow'](`  ${w.Severity}: ${w.Message}`));
+            }
+            if (!result.Success) {
+                this.error(`Clone ${result.ResultCode === 'BLOCKED' ? 'was blocked' : 'failed'}${result.ErrorMessage ? `: ${result.ErrorMessage}` : ''}.`);
+            }
+            // A dry run reports the plan's counts; a real run, the rows it actually created.
+            const byEntity = new Map();
+            if (flags['dry-run']) {
+                for (const [entity, counts] of Object.entries(result.Counts?.ByEntity ?? {}))
+                    byEntity.set(entity, counts.Create);
+            }
+            else {
+                for (const row of result.Created ?? [])
+                    byEntity.set(row.EntityName, (byEntity.get(row.EntityName) ?? 0) + 1);
+            }
+            this.log(chalk.bold(flags['dry-run'] ? '\nWould copy:' : '\nCopied:'));
+            for (const [entity, count] of byEntity) {
+                if (count > 0)
+                    this.log(`  ${String(count).padStart(5)}  ${entity}`);
+            }
+            if (flags['dry-run'])
+                return;
+            const newID = result.Roots?.[0]?.TargetKey.KeyValuePairs.find((kvp) => kvp.FieldName === 'ID')?.Value;
+            if (!flags.inactive && newID) {
+                const user = await provider.GetEntityObject('MJ: Users', contextUser);
+                if (!(await user.Load(String(newID))))
+                    this.error(`The new user ${flags.email} was created but could not be loaded to activate it.`);
+                user.IsActive = true;
+                if (!(await user.Save()))
+                    this.error(`The new user ${flags.email} was created but not activated: ${user.LatestResult?.CompleteMessage ?? 'unknown error'}`);
+            }
+            this.log(chalk.green(`\n✓ Created ${flags.email} from ${flags.from}${flags.inactive ? ' (inactive: activate it after review)' : ''}.`));
+        }
+        catch (error) {
+            this.error(error instanceof Error ? error.message : String(error));
+        }
+    }
+    /** The user with this email, if any. */
+    async findUser(email, contextUser) {
+        const result = await new RunView().RunView({
+            EntityName: 'MJ: Users',
+            ExtraFilter: `Email = '${email.replace(/'/g, "''")}'`,
+            Fields: ['ID', 'Email', 'IsTemplate'],
+            ResultType: 'simple',
+            MaxRows: 1,
+        }, contextUser);
+        return result.Success ? result.Results[0] : undefined;
+    }
+}
+//# sourceMappingURL=clone.js.map

package/dist/commands/user/clone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone.js","sourceRoot":"","sources":["../../../src/commands/user/clone.ts"],"names":[],"mappings":"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"}

package/dist/hooks/postrun.d.ts

@@ -2,7 +2,7 @@
  * Cleanup hook that runs after any command completes.
  *
  * Only `mj app *` commands open an mssql connection pool (through
- * `ensureProviderInitialized` in utils/open-app-context.ts). The pool keeps
+ * `EnsureProviderInitialized` in utils/open-app-context.ts). The pool keeps
  * sockets alive, which pins the Node event loop open and makes the CLI appear
  * to hang after the command finishes printing its output — so for those
  * commands we close it here.

package/dist/hooks/prerun.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prerun.d.ts","sourceRoot":"","sources":["../../src/hooks/prerun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAKnC;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AA6BnE,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,QAAQ,CAqFxB,CAAC;AA0BF,eAAe,IAAI,CAAC"}
+{"version":3,"file":"prerun.d.ts","sourceRoot":"","sources":["../../src/hooks/prerun.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAOnC;;;;GAIG;AACH,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AA6BnE,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,QAAQ,CA6FxB,CAAC;AA0BF,eAAe,IAAI,CAAC"}

package/dist/hooks/prerun.js

@@ -1,6 +1,8 @@
 import figlet from 'figlet';
 import { INTERACTIVE_ENV, ResolveOutputFormat, ShouldSuppressChrome } from '@memberjunction/cli-core';
 import { LIGHT_COMMANDS } from '../light-commands.js';
+import chalk from 'chalk';
+import { KeepAwakeForCommand, SleepNoticeForCommand } from '../lib/keep-awake.js';
 /**
  * Mirror of `DYNAMIC_PACKAGES_MODE_ENV_VAR` from @memberjunction/dynamic-packages, inlined so
  * LIGHT commands (version, help, migrate, …) do not pay for that package — and its cosmiconfig
@@ -35,6 +37,8 @@ function readFormatArg(argv) {
 }
 const hook = async function (options) {
     const argv = options.argv ?? [];
+    // Long database commands must not be interrupted by the machine sleeping — see keep-awake.ts.
+    const keptAwake = KeepAwakeForCommand(options.Command.id ?? '');
     // `--interactive` / `--no-interactive` override the terminal detection that decides
     // whether a command may prompt. Like `--no-banner` they must work on every command,
     // including the ~80 that don't declare them, so they are consumed here and forwarded
@@ -106,6 +110,11 @@ const hook = async function (options) {
     if (options.Command.id !== 'version' && !isUsageCommand) {
         options.context.log(options.config.userAgent + '\n');
     }
+    // Said once, up front, while the user is still watching. stderr, so it never mixes into output.
+    const sleepNotice = SleepNoticeForCommand(options.Command.id ?? '', keptAwake);
+    if (sleepNotice) {
+        process.stderr.write(chalk.yellow(`\u26a0 ${sleepNotice}\n\n`));
+    }
     await maybeLoadBootstrap(options, verbose);
 };
 /**

package/dist/hooks/prerun.js.map

@@ -1 +1 @@
-{"version":3,"file":"prerun.js","sourceRoot":"","sources":["../../src/hooks/prerun.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"prerun.js","sourceRoot":"","sources":["../../src/hooks/prerun.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AACtG,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElF;;;;GAIG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AAEnE;;;;;;;GAOG;AACH,SAAS,cAAc,CAAC,IAAc,EAAE,IAAY;IAClD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClB,KAAK,GAAG,IAAI,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,4FAA4F;AAC5F,SAAS,aAAa,CAAC,IAAc;IACnC,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;IACvD,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAC1C,CAAC;AAED,MAAM,IAAI,GAAmB,KAAK,WAAW,OAAO;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC;IAChC,8FAA8F;IAC9F,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhE,oFAAoF;IACpF,oFAAoF;IACpF,qFAAqF;IACrF,iFAAiF;IACjF,oFAAoF;IACpF,gFAAgF;IAChF,2EAA2E;IAC3E,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;IACtD,qFAAqF;IACrF,IAAI,QAAQ;QAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,GAAG,CAAC;SAC5C,IAAI,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,GAAG,CAAC;IAErD,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IACrD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC;IACrC,CAAC;IAED,6FAA6F;IAC7F,8FAA8F;IAC9F,yFAAyF;IACzF,qFAAqF;IACrF,IAAI,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,EAAE,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,GAAG,MAAM,CAAC;IACtD,CAAC;IAED,gFAAgF;IAChF,qFAAqF;IACrF,sFAAsF;IACtF,qFAAqF;IACrF,sFAAsF;IACtF,uEAAuE;IACvE,qFAAqF;IACrF,sDAAsD;IACtD,MAAM,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC;QACrC,UAAU,EAAE,aAAa,CAAC,IAAI,CAAC;QAC/B,4EAA4E;QAC5E,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;KAClC,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IAElG,qFAAqF;IACrF,qFAAqF;IACrF,iBAAiB;IACjB,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAElE,IAAI,QAAQ,IAAI,KAAK,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,oFAAoF;QACpF,gFAAgF;QAChF,uEAAuE;QACvE,OAAO,MAAM,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,4FAA4F;IAC5F,4EAA4E;IAC5E,6CAA6C;IAC7C,MAAM,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;IACpD,MAAM,cAAc,GAAG,kBAAkB,KAAK,OAAO,IAAI,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9F,MAAM,UAAU,GAAG,CAAC,kBAAkB,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC;IAE7E,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,OAAO,CAAC,GAAG,CACjB,OAAO,CAAC,MAAM,CAAC,OAAO,IAAI,EAAE;YAC1B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,EAAE;gBAChC,IAAI,EAAE,UAAU;gBAChB,gBAAgB,EAAE,SAAS;gBAC3B,cAAc,EAAE,SAAS;gBACzB,KAAK,EAAE,GAAG;gBACV,eAAe,EAAE,IAAI;aACtB,CAAC;YACJ,CAAC,CAAC,iCAAiC,CACtC,CAAC;IACJ,CAAC;IAED,iFAAiF;IACjF,mFAAmF;IACnF,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC;QACxD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACvD,CAAC;IAED,gGAAgG;IAChG,MAAM,WAAW,GAAG,qBAAqB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS,CAAC,CAAC;IAC/E,IAAI,WAAW,EAAE,CAAC;QAChB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,WAAW,MAAM,CAAC,CAAC,CAAC;IAClE,CAAC;IAED,MAAM,kBAAkB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAC7C,CAAC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,KAAK,UAAU,kBAAkB,CAAC,OAAqC,EAAE,OAAO,GAAG,KAAK;IACtF,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,sFAAsF;QACtF,2DAA2D;QAC3D,MAAM,MAAM,CAAC,8DAA8D,CAAC,CAAC;QAC7E,MAAM,EAAE,6BAA6B,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAC;QACrF,MAAM,6BAA6B,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;IACvE,CAAC;AACH,CAAC;AAED,eAAe,IAAI,CAAC"}

package/dist/lib/domain-profiles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domain-profiles.d.ts","sourceRoot":"","sources":["../../src/lib/domain-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAGpC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CA6FnE,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAE9D;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAE9D"}
+{"version":3,"file":"domain-profiles.d.ts","sourceRoot":"","sources":["../../src/lib/domain-profiles.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,4DAA4D;IAC5D,OAAO,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAGpC,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAqGnE,CAAC;AAEF,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAE9D;AAED,gDAAgD;AAChD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAE9D"}

package/dist/lib/domain-profiles.js

@@ -34,6 +34,10 @@ export const DOMAIN_PROFILES = {
         Summary: 'Run and inspect AI agents, prompts, and actions from the terminal.',
         Runtime: { class: 'variable', note: 'a listing is instant; an agent run is bounded only by the agent itself' },
     },
+    queue: {
+        Summary: 'Operate the durable work queue — stats, backlog, dead letters, replay and discard, container-job workers, cloud bindings.',
+        Runtime: { class: 'moderate', typicalSeconds: 15, note: 'dominated by MJ bootstrap; each operation is a few queries or cloud API calls' },
+    },
     app: {
         Summary: 'Install, upgrade, enable, and remove Open Apps.',
         Runtime: { class: 'slow', typicalSeconds: 180, note: 'installs run migrations and package installs' },
@@ -54,6 +58,10 @@ export const DOMAIN_PROFILES = {
         Summary: 'Bundle interactive component source for distribution.',
         Runtime: { class: 'moderate', typicalSeconds: 20 },
     },
+    cache: {
+        Summary: 'Inspect and clear the shared (Redis) server cache.',
+        Runtime: { class: 'fast', note: 'one SCAN per category; scales with the Redis keyspace' },
+    },
     clean: {
         Summary: 'Remove build artifacts and generated output.',
         Runtime: { class: 'fast' },

package/dist/lib/domain-profiles.js.map

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

package/dist/lib/keep-awake.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Keeps the machine awake while a long-running database command runs.
+ *
+ * `mj install` and `mj app install` run for many minutes, and a laptop left alone in that time
+ * idles into sleep. Sleep pauses everything at once — the CLI, the local database (often a Docker
+ * VM), and every socket between them — and on wake each in-flight request's timer fires together:
+ * a migration batch that was doing nothing wrong reports `Timeout: Request failed to complete in
+ * 300000ms`, a GitHub download reports `read ECONNRESET`, and the app being installed is rolled
+ * back. Clean end-user installs of MJ + a multi-app Open App chain failed this way repeatedly.
+ *
+ * On macOS this holds a `caffeinate` assertion tied to the CLI's own pid, so it ends the moment
+ * the command does — no cleanup, nothing left behind. Elsewhere it is a no-op. Set
+ * {@link KEEP_AWAKE_OPT_OUT_ENV_VAR} to opt out.
+ *
+ * Either way, {@link SleepNoticeForCommand} tells the user at the start: no assertion survives
+ * a closed lid, and on Windows and Linux nothing holds the machine awake at all.
+ */
+import { spawn } from 'node:child_process';
+/** Set to `1` (or `true`) to let the machine sleep during long commands. */
+export declare const KEEP_AWAKE_OPT_OUT_ENV_VAR = "MJ_ALLOW_SLEEP";
+/** Commands long and database-bound enough that sleeping mid-run breaks them. */
+export declare const KEEP_AWAKE_COMMANDS: ReadonlySet<string>;
+/** The pieces of the environment this depends on, injectable for tests. */
+export interface KeepAwakeEnvironment {
+    Platform: NodeJS.Platform;
+    Env: NodeJS.ProcessEnv;
+    Pid: number;
+    Spawn: typeof spawn;
+}
+/**
+ * Starts the keep-awake assertion for `commandId` when it applies.
+ *
+ * @returns true when an assertion was started. Never throws: failing to keep the machine awake
+ *          must not fail the command it was meant to protect.
+ */
+export declare function KeepAwakeForCommand(commandId: string, environment?: KeepAwakeEnvironment): boolean;
+/**
+ * The one-line warning to show when a long database command starts, or `undefined` for commands
+ * that are not long enough to need it.
+ *
+ * @param commandId - The oclif command id.
+ * @param keptAwake - Whether {@link KeepAwakeForCommand} started an assertion for this run.
+ */
+export declare function SleepNoticeForCommand(commandId: string, keptAwake: boolean): string | undefined;
+//# sourceMappingURL=keep-awake.d.ts.map

package/dist/lib/keep-awake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-awake.d.ts","sourceRoot":"","sources":["../../src/lib/keep-awake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,4EAA4E;AAC5E,eAAO,MAAM,0BAA0B,mBAAmB,CAAC;AAE3D,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAKlD,CAAC;AAEH,2EAA2E;AAC3E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,OAAO,KAAK,CAAC;CACrB;AASD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,GAAE,oBAA0C,GAAG,OAAO,CAavH;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAK/F"}

package/dist/lib/keep-awake.js

@@ -0,0 +1,71 @@
+/**
+ * Keeps the machine awake while a long-running database command runs.
+ *
+ * `mj install` and `mj app install` run for many minutes, and a laptop left alone in that time
+ * idles into sleep. Sleep pauses everything at once — the CLI, the local database (often a Docker
+ * VM), and every socket between them — and on wake each in-flight request's timer fires together:
+ * a migration batch that was doing nothing wrong reports `Timeout: Request failed to complete in
+ * 300000ms`, a GitHub download reports `read ECONNRESET`, and the app being installed is rolled
+ * back. Clean end-user installs of MJ + a multi-app Open App chain failed this way repeatedly.
+ *
+ * On macOS this holds a `caffeinate` assertion tied to the CLI's own pid, so it ends the moment
+ * the command does — no cleanup, nothing left behind. Elsewhere it is a no-op. Set
+ * {@link KEEP_AWAKE_OPT_OUT_ENV_VAR} to opt out.
+ *
+ * Either way, {@link SleepNoticeForCommand} tells the user at the start: no assertion survives
+ * a closed lid, and on Windows and Linux nothing holds the machine awake at all.
+ */
+import { spawn } from 'node:child_process';
+/** Set to `1` (or `true`) to let the machine sleep during long commands. */
+export const KEEP_AWAKE_OPT_OUT_ENV_VAR = 'MJ_ALLOW_SLEEP';
+/** Commands long and database-bound enough that sleeping mid-run breaks them. */
+export const KEEP_AWAKE_COMMANDS = new Set([
+    'install',
+    'app:install',
+    'app:upgrade',
+    'migrate',
+]);
+const DEFAULT_ENVIRONMENT = {
+    Platform: process.platform,
+    Env: process.env,
+    Pid: process.pid,
+    Spawn: spawn,
+};
+/**
+ * Starts the keep-awake assertion for `commandId` when it applies.
+ *
+ * @returns true when an assertion was started. Never throws: failing to keep the machine awake
+ *          must not fail the command it was meant to protect.
+ */
+export function KeepAwakeForCommand(commandId, environment = DEFAULT_ENVIRONMENT) {
+    if (!KEEP_AWAKE_COMMANDS.has(commandId) || environment.Platform !== 'darwin')
+        return false;
+    const optOut = (environment.Env[KEEP_AWAKE_OPT_OUT_ENV_VAR] ?? '').trim().toLowerCase();
+    if (optOut === '1' || optOut === 'true')
+        return false;
+    try {
+        // -i: no idle sleep. -s: no system sleep while on AC power. -w: exit when the CLI exits.
+        const child = environment.Spawn('caffeinate', ['-i', '-s', '-w', String(environment.Pid)], { stdio: 'ignore' });
+        child.on('error', () => undefined); // caffeinate missing or refused — carry on without it
+        child.unref(); // never keep the CLI alive for its sake
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The one-line warning to show when a long database command starts, or `undefined` for commands
+ * that are not long enough to need it.
+ *
+ * @param commandId - The oclif command id.
+ * @param keptAwake - Whether {@link KeepAwakeForCommand} started an assertion for this run.
+ */
+export function SleepNoticeForCommand(commandId, keptAwake) {
+    if (!KEEP_AWAKE_COMMANDS.has(commandId))
+        return undefined;
+    return keptAwake
+        ? 'This can take 15 minutes or more. MJ is keeping this Mac awake until it finishes, but closing the lid will still put it to sleep and can make the command fail partway.'
+        : "This can take 15 minutes or more. Don't let this machine sleep until it finishes: sleep pauses the database connection and can make the command fail partway.";
+}
+//# sourceMappingURL=keep-awake.js.map

package/dist/lib/keep-awake.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keep-awake.js","sourceRoot":"","sources":["../../src/lib/keep-awake.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,4EAA4E;AAC5E,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAC;AAE3D,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAwB,IAAI,GAAG,CAAC;IAC9D,SAAS;IACT,aAAa;IACb,aAAa;IACb,SAAS;CACV,CAAC,CAAC;AAUH,MAAM,mBAAmB,GAAyB;IAChD,QAAQ,EAAE,OAAO,CAAC,QAAQ;IAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,KAAK,EAAE,KAAK;CACb,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB,EAAE,cAAoC,mBAAmB;IAC5G,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC3F,MAAM,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,0BAA0B,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACxF,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACtD,IAAI,CAAC;QACH,yFAAyF;QACzF,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,sDAAsD;QAC1F,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,wCAAwC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,SAAiB,EAAE,SAAkB;IACzE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC;QAAE,OAAO,SAAS,CAAC;IAC1D,OAAO,SAAS;QACd,CAAC,CAAC,yKAAyK;QAC3K,CAAC,CAAC,+JAA+J,CAAC;AACtK,CAAC"}

package/dist/lib/shared-cache.d.ts

@@ -0,0 +1,84 @@
+import type { RedisProviderConfig, SharedCacheCategoryClear } from '@memberjunction/redis-provider';
+/** Setting this to `1`/`true` disables the automatic clear (the explicit command still works). */
+export declare const SKIP_CACHE_CLEAR_ENV = "MJ_SKIP_SHARED_CACHE_CLEAR";
+/** What the user asked to clear, mapped onto the names the cache actually uses. */
+export type ResolvedCacheCategories = {
+    /** Canonical category names, safe to hand to the store. */
+    Categories: string[];
+    /** Anything that matched no known category, in the spelling the user gave. */
+    Unknown: string[];
+};
+/**
+ * Maps requested category names onto their canonical spelling.
+ *
+ * Names are accepted case-insensitively because nobody should have to remember that it is
+ * `RunViewCache` and not `runviewcache`. But Redis keys ARE case-sensitive, so accepting a
+ * spelling and then using it verbatim scanned `{prefix}:runviewcache:*`, matched nothing, and
+ * reported a successful clear of 0 keys — the operator is told the fleet will reload and it never
+ * does. Accept the spelling, then hand the store the canonical name.
+ */
+export declare function ResolveCacheCategories(requested: readonly string[] | undefined): ResolvedCacheCategories;
+/** What a `mj migrate` run did, as far as the command can tell. */
+export type MigrationOutcome = {
+    /** The migration engine threw instead of returning a result. */
+    Threw: boolean;
+    /** The run reported success. */
+    Succeeded: boolean;
+    /** Migrations the run reports as applied. Meaningful only on success. */
+    MigrationsApplied: number;
+    /** At least one migration began executing — the only reliable "the database may have changed". */
+    StartedApplying: boolean;
+};
+/**
+ * Whether a migration run may have changed the database, and so whether the fleet's cache is stale.
+ *
+ * On success the count is authoritative: a run that found nothing pending must NOT make every server
+ * drop its cache and reload every engine for nothing.
+ *
+ * On a failure — including one that threw rather than returning — the count is not trustworthy and
+ * neither is the detail list, which can be empty precisely because the run died before assembling
+ * it. What IS known is whether a migration started executing. DDL is not transactional across
+ * batches on SQL Server, so a migration that began and failed can still have committed statements;
+ * a run that never started one cannot have. That makes "did anything start" the honest gate: a bad
+ * connection string or a config error leaves the fleet alone, and anything that touched the database
+ * clears.
+ */
+export declare function MigrationChangedDatabase(outcome: MigrationOutcome): boolean;
+/** The category names a clear can be asked for, for error messages and help text. */
+export declare function KnownCacheCategories(): string[];
+/** The shared cache the environment points at, or null when none is configured. */
+export interface SharedCacheTarget {
+    Connection: RedisProviderConfig;
+    /** Host, port and key prefix — never credentials. For messages. */
+    Description: string;
+}
+/** What an automatic clear did, for the command's log and result. */
+export interface SharedCacheClearReport {
+    Ok: boolean;
+    Message: string;
+    Categories: SharedCacheCategoryClear[];
+}
+/** Resolves the shared cache from `REDIS_URL` / `REDIS_KEY_PREFIX`, the variables MJAPI reads. */
+export declare function ResolveSharedCacheTarget(env?: NodeJS.ProcessEnv): SharedCacheTarget | null;
+/** `host:port/db` of a Redis URL, without user or password. */
+export declare function DescribeRedisUrl(url: string): string;
+/** True when the automatic clear has been switched off by flag or environment. */
+export declare function IsAutomaticClearDisabled(skipFlag: boolean | undefined, env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Clears the shared cache after `commandName` changed the database. Returns null when there is
+ * nothing to do (no `REDIS_URL`, or disabled).
+ */
+export declare function ClearSharedCacheAfterWrite(commandName: string, skipFlag?: boolean): Promise<SharedCacheClearReport | null>;
+/** The subset of the CLI runtime host a clear report is logged through. */
+export interface SharedCacheReportSink {
+    Log(message: string, level?: 'info' | 'warn' | 'error'): void;
+}
+/**
+ * Logs a clear report and folds it into a plugin command's result: `data.sharedCacheClear`
+ * always, and a warning when the clear failed. Returns the result unchanged when there is no report.
+ */
+export declare function AppendSharedCacheClear<R extends {
+    data?: Record<string, unknown>;
+    warnings?: string[];
+}>(result: R, report: SharedCacheClearReport | null, sink: SharedCacheReportSink): R;
+//# sourceMappingURL=shared-cache.d.ts.map

package/dist/lib/shared-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-cache.d.ts","sourceRoot":"","sources":["../../src/lib/shared-cache.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAEpG,kGAAkG;AAClG,eAAO,MAAM,oBAAoB,+BAA+B,CAAC;AAKjE,mFAAmF;AACnF,MAAM,MAAM,uBAAuB,GAAG;IAClC,2DAA2D;IAC3D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,8EAA8E;IAC9E,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,uBAAuB,CAiBxG;AAED,mEAAmE;AACnE,MAAM,MAAM,gBAAgB,GAAG;IAC3B,gEAAgE;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,gCAAgC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,yEAAyE;IACzE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kGAAkG;IAClG,eAAe,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAK3E;AAED,qFAAqF;AACrF,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C;AAED,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAC9B,UAAU,EAAE,mBAAmB,CAAC;IAChC,mEAAmE;IACnE,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,qEAAqE;AACrE,MAAM,WAAW,sBAAsB;IACnC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,wBAAwB,EAAE,CAAC;CAC1C;AAED,kGAAkG;AAClG,wBAAgB,wBAAwB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,GAAG,IAAI,CAOvG;AAED,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,SAAS,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAMrH;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAuChI;AAED,2EAA2E;AAC3E,MAAM,WAAW,qBAAqB;IAClC,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;CACjE;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,EACpG,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,sBAAsB,GAAG,IAAI,EACrC,IAAI,EAAE,qBAAqB,GAC5B,CAAC,CAWH"}

package/dist/lib/shared-cache.js

@@ -0,0 +1,160 @@
+/**
+ * Clearing the shared (Redis) cache after the CLI changes the database.
+ *
+ * `mj sync push`, `mj codegen` and `mj migrate` write to the database from a process that is not
+ * part of the server fleet's cache, so no server hears about the change and each keeps serving what
+ * it cached before — indefinitely, because server-side cache hits are never re-validated (#4083).
+ * When `REDIS_URL` is configured (in the environment or the dotenv file the CLI loads), these
+ * commands clear the cache categories and the metadata snapshot afterwards; every server reloads its
+ * engines and re-checks its metadata. `mj cache clear` does the same on demand.
+ *
+ * A failed clear never fails the command — the database change already succeeded — but it is
+ * reported loudly, with the command to run by hand.
+ */
+import { ClearSharedCacheCategories, SHARED_CACHE_WRITE_CATEGORIES } from '@memberjunction/redis-provider';
+/** Setting this to `1`/`true` disables the automatic clear (the explicit command still works). */
+export const SKIP_CACHE_CLEAR_ENV = 'MJ_SKIP_SHARED_CACHE_CLEAR';
+/** The categories a clear may target: everything a CLI write invalidates, plus the proxy-key store. */
+const CLEARABLE_CATEGORIES = [...SHARED_CACHE_WRITE_CATEGORIES, 'default'];
+/**
+ * Maps requested category names onto their canonical spelling.
+ *
+ * Names are accepted case-insensitively because nobody should have to remember that it is
+ * `RunViewCache` and not `runviewcache`. But Redis keys ARE case-sensitive, so accepting a
+ * spelling and then using it verbatim scanned `{prefix}:runviewcache:*`, matched nothing, and
+ * reported a successful clear of 0 keys — the operator is told the fleet will reload and it never
+ * does. Accept the spelling, then hand the store the canonical name.
+ */
+export function ResolveCacheCategories(requested) {
+    if (!requested?.length) {
+        return { Categories: [...SHARED_CACHE_WRITE_CATEGORIES], Unknown: [] };
+    }
+    const resolved = [];
+    const unknown = [];
+    for (const raw of requested) {
+        const canonical = CLEARABLE_CATEGORIES.find(known => known.toLowerCase() === raw.trim().toLowerCase());
+        if (canonical) {
+            if (!resolved.includes(canonical)) {
+                resolved.push(canonical);
+            }
+        }
+        else {
+            unknown.push(raw);
+        }
+    }
+    return { Categories: resolved, Unknown: unknown };
+}
+/**
+ * Whether a migration run may have changed the database, and so whether the fleet's cache is stale.
+ *
+ * On success the count is authoritative: a run that found nothing pending must NOT make every server
+ * drop its cache and reload every engine for nothing.
+ *
+ * On a failure — including one that threw rather than returning — the count is not trustworthy and
+ * neither is the detail list, which can be empty precisely because the run died before assembling
+ * it. What IS known is whether a migration started executing. DDL is not transactional across
+ * batches on SQL Server, so a migration that began and failed can still have committed statements;
+ * a run that never started one cannot have. That makes "did anything start" the honest gate: a bad
+ * connection string or a config error leaves the fleet alone, and anything that touched the database
+ * clears.
+ */
+export function MigrationChangedDatabase(outcome) {
+    if (outcome.Threw || !outcome.Succeeded) {
+        return outcome.StartedApplying;
+    }
+    return outcome.MigrationsApplied > 0;
+}
+/** The category names a clear can be asked for, for error messages and help text. */
+export function KnownCacheCategories() {
+    return [...CLEARABLE_CATEGORIES];
+}
+/** Resolves the shared cache from `REDIS_URL` / `REDIS_KEY_PREFIX`, the variables MJAPI reads. */
+export function ResolveSharedCacheTarget(env = process.env) {
+    const url = env.REDIS_URL?.trim();
+    if (!url) {
+        return null;
+    }
+    const keyPrefix = env.REDIS_KEY_PREFIX || 'mj';
+    return { Connection: { url, keyPrefix }, Description: `${DescribeRedisUrl(url)} (prefix "${keyPrefix}")` };
+}
+/** `host:port/db` of a Redis URL, without user or password. */
+export function DescribeRedisUrl(url) {
+    try {
+        const parsed = new URL(url);
+        const db = parsed.pathname && parsed.pathname !== '/' ? parsed.pathname : '';
+        return `${parsed.protocol}//${parsed.hostname}${parsed.port ? `:${parsed.port}` : ''}${db}`;
+    }
+    catch {
+        return '(unparseable REDIS_URL)';
+    }
+}
+/** True when the automatic clear has been switched off by flag or environment. */
+export function IsAutomaticClearDisabled(skipFlag, env = process.env) {
+    if (skipFlag) {
+        return true;
+    }
+    const value = env[SKIP_CACHE_CLEAR_ENV]?.trim().toLowerCase();
+    return value === '1' || value === 'true';
+}
+/**
+ * Clears the shared cache after `commandName` changed the database. Returns null when there is
+ * nothing to do (no `REDIS_URL`, or disabled).
+ */
+export async function ClearSharedCacheAfterWrite(commandName, skipFlag) {
+    const target = ResolveSharedCacheTarget();
+    if (!target || IsAutomaticClearDisabled(skipFlag)) {
+        return null;
+    }
+    try {
+        const categories = await ClearSharedCacheCategories({
+            Connection: target.Connection, Categories: SHARED_CACHE_WRITE_CATEGORIES, IncludeMetadataSnapshot: true,
+        });
+        const total = categories.reduce((n, c) => n + c.KeyCount, 0);
+        // A category can fail on its own: ClearSharedCacheCategories reports per-category Ok/Error
+        // and returns normally on a partial failure. Reporting the whole clear as a success then
+        // told the operator "servers will reload" about categories that were never cleared, which
+        // is the same false-success the per-category outcomes were added to expose.
+        const failed = categories.filter(c => c.Ok === false);
+        if (failed.length > 0) {
+            const detail = failed.map(c => `${c.Category} (${c.Error ?? 'unknown error'})`).join('; ');
+            return {
+                Ok: false,
+                Message: `${commandName} changed the database and the shared cache on ${target.Description} was only partly cleared — ` +
+                    `${failed.length} of ${categories.length} categories failed: ${detail}. ` +
+                    `Servers may serve stale data for those categories until you run: mj cache clear`,
+                Categories: categories,
+            };
+        }
+        return {
+            Ok: true,
+            Message: `Cleared ${total} shared cache entr${total === 1 ? 'y' : 'ies'} on ${target.Description} after ${commandName}; running servers will reload.`,
+            Categories: categories,
+        };
+    }
+    catch (e) {
+        const reason = e instanceof Error ? e.message : String(e);
+        return {
+            Ok: false,
+            Message: `${commandName} changed the database but the shared cache on ${target.Description} could not be cleared (${reason}). ` +
+                `Running servers may serve stale data until you run: mj cache clear`,
+            Categories: [],
+        };
+    }
+}
+/**
+ * Logs a clear report and folds it into a plugin command's result: `data.sharedCacheClear`
+ * always, and a warning when the clear failed. Returns the result unchanged when there is no report.
+ */
+export function AppendSharedCacheClear(result, report, sink) {
+    if (!report) {
+        return result;
+    }
+    sink.Log(report.Message, report.Ok ? 'info' : 'warn');
+    const warnings = report.Ok ? result.warnings : [...(result.warnings ?? []), report.Message];
+    return {
+        ...result,
+        data: { ...(result.data ?? {}), sharedCacheClear: { ok: report.Ok, categories: report.Categories } },
+        warnings,
+    };
+}
+//# sourceMappingURL=shared-cache.js.map

package/dist/lib/shared-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-cache.js","sourceRoot":"","sources":["../../src/lib/shared-cache.ts"],"names":[],"mappings":"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"}