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

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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"}

package/dist/light-commands.d.ts

@@ -13,5 +13,13 @@
  *  - If the command uses only standard npm packages or light @memberjunction
  *    packages (like @memberjunction/config), add its oclif command ID here.
  */
+/**
+ * NOTE on spelling: oclif command ids are **colon**-separated (`cache:clear`), whatever
+ * `topicSeparator` is set to — that only affects how a user types it. The space forms below are
+ * kept because they read the way the command is invoked, but each one is paired with its colon id,
+ * which is what `Command.id` actually equals at runtime. Without the colon form the entry never
+ * matches and the command silently pays the full bootstrap: `cache clear` measured 4.4-7.4 s
+ * against 0.19-0.29 s. `light-commands.ids.test.ts` fails on a space-only entry.
+ */
 export declare const LIGHT_COMMANDS: ReadonlySet<string>;
 //# sourceMappingURL=light-commands.d.ts.map

package/dist/light-commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"light-commands.d.ts","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CAkH7C,CAAC"}
+{"version":3,"file":"light-commands.d.ts","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,EAAE,WAAW,CAAC,MAAM,CA4I7C,CAAC"}

package/dist/light-commands.js

@@ -13,6 +13,14 @@
  *  - If the command uses only standard npm packages or light @memberjunction
  *    packages (like @memberjunction/config), add its oclif command ID here.
  */
+/**
+ * NOTE on spelling: oclif command ids are **colon**-separated (`cache:clear`), whatever
+ * `topicSeparator` is set to — that only affects how a user types it. The space forms below are
+ * kept because they read the way the command is invoked, but each one is paired with its colon id,
+ * which is what `Command.id` actually equals at runtime. Without the colon form the entry never
+ * matches and the command silently pays the full bootstrap: `cache clear` measured 4.4-7.4 s
+ * against 0.19-0.29 s. `light-commands.ids.test.ts` fails on a space-only entry.
+ */
 export const LIGHT_COMMANDS = new Set([
     // Built-in oclif plugins
     'version',
@@ -21,8 +29,11 @@ export const LIGHT_COMMANDS = new Set([
     // metadata only; no bootstrap needed. Plugin entry points are light.
     'usage',
     'sync usage',
+    'sync:usage',
     'codegen usage',
+    'codegen:usage',
     'dev usage',
+    'dev:usage',
     // Every remaining domain's tier-2 page. These compose oclif's own manifest plus the
     // light plugin entry points — the whole point of the surface is that an agent can
     // read it without paying for a runtime boot. Both id spellings are listed because
@@ -70,13 +81,22 @@ export const LIGHT_COMMANDS = new Set([
     'update:usage',
     // Plugin registry editing — just writes mj-cli-plugins.json
     'plugin add',
+    'plugin:add',
     // Bump - uses zod, fast-glob, fs only
     'bump',
+    // Shared cache - uses @memberjunction/redis-provider (ioredis + core) only
+    'cache',
+    'cache clear',
+    'cache:clear',
+    'cache usage',
+    'cache:usage',
     // Database commands - use @memberjunction/skyway-core + config only
     'clean',
     'migrate',
     'migrate convert',
+    'migrate:convert',
     'migrate create',
+    'migrate:create',
     // Install wizard - uses @memberjunction/installer engine (lightweight, no bootstrap)
     'install',
     // Doctor - uses @memberjunction/installer engine (lightweight, no bootstrap)
@@ -87,14 +107,19 @@ export const LIGHT_COMMANDS = new Set([
     'ai',
     'queue',
     'ai audit',
+    'ai:audit',
     'test',
     'dbdoc',
     'dev',
     // Dev workspace generator - node stdlib + chalk only, no bootstrap
     'dev workspace',
+    'dev:workspace',
     'dev workspace status',
+    'dev:workspace:status',
     'dev workspace doctor',
+    'dev:workspace:doctor',
     'dev workspace clean',
+    'dev:workspace:clean',
     // SQL conversion commands - use @memberjunction/sql-converter + sqlglot-ts only
     'sql-convert',
     'sql-audit',
@@ -106,13 +131,21 @@ export const LIGHT_COMMANDS = new Set([
     // Must be light to break the circular dependency: server-bootstrap-lite's prebuild calls
     // `mj codegen manifest`, but bootstrap-lite must be built before MJCLI's prerun can import it.
     'codegen manifest',
+    'codegen:manifest',
     // DBDoc commands - already use dynamic imports internally
     'dbdoc init',
+    'dbdoc:init',
     'dbdoc analyze',
+    'dbdoc:analyze',
     'dbdoc export',
+    'dbdoc:export',
     'dbdoc export-sample-queries',
+    'dbdoc:export-sample-queries',
     'dbdoc generate-queries',
+    'dbdoc:generate-queries',
     'dbdoc reset',
+    'dbdoc:reset',
     'dbdoc status',
+    'dbdoc:status',
 ]);
 //# sourceMappingURL=light-commands.js.map

package/dist/light-commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"light-commands.js","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,yBAAyB;IACzB,SAAS;IACT,MAAM;IAEN,0EAA0E;IAC1E,qEAAqE;IACrE,OAAO;IACP,YAAY;IACZ,eAAe;IACf,WAAW;IACX,oFAAoF;IACpF,kFAAkF;IAClF,kFAAkF;IAClF,oFAAoF;IACpF,2CAA2C;IAC3C,UAAU;IACV,UAAU;IACV,aAAa;IACb,aAAa;IACb,WAAW;IACX,WAAW;IACX,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,cAAc;IACd,aAAa;IACb,aAAa;IACb,aAAa;IACb,aAAa;IACb,cAAc;IACd,cAAc;IACd,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;IACjB,iBAAiB;IACjB,YAAY;IACZ,YAAY;IACZ,qBAAqB;IACrB,qBAAqB;IACrB,cAAc;IACd,cAAc;IAEd,4DAA4D;IAC5D,YAAY;IAEZ,sCAAsC;IACtC,MAAM;IAEN,oEAAoE;IACpE,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,gBAAgB;IAEhB,qFAAqF;IACrF,SAAS;IAET,6EAA6E;IAC7E,QAAQ;IAER,4FAA4F;IAC5F,QAAQ;IAER,kEAAkE;IAClE,IAAI;IACJ,OAAO;IACP,UAAU;IACV,MAAM;IACN,OAAO;IACP,KAAK;IAEL,mEAAmE;IACnE,eAAe;IACf,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;IAErB,gFAAgF;IAChF,aAAa;IACb,WAAW;IAEX,8EAA8E;IAC9E,oCAAoC;IACpC,gBAAgB;IAChB,eAAe;IAEf,kGAAkG;IAClG,yFAAyF;IACzF,+FAA+F;IAC/F,kBAAkB;IAElB,0DAA0D;IAC1D,YAAY;IACZ,eAAe;IACf,cAAc;IACd,6BAA6B;IAC7B,wBAAwB;IACxB,aAAa;IACb,cAAc;CACf,CAAC,CAAC"}
+{"version":3,"file":"light-commands.js","sourceRoot":"","sources":["../src/light-commands.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,cAAc,GAAwB,IAAI,GAAG,CAAC;IACzD,yBAAyB;IACzB,SAAS;IACT,MAAM;IAEN,0EAA0E;IAC1E,qEAAqE;IACrE,OAAO;IACP,YAAY;IACZ,YAAY;IACZ,eAAe;IACf,eAAe;IACf,WAAW;IACX,WAAW;IACX,oFAAoF;IACpF,kFAAkF;IAClF,kFAAkF;IAClF,oFAAoF;IACpF,2CAA2C;IAC3C,UAAU;IACV,UAAU;IACV,aAAa;IACb,aAAa;IACb,WAAW;IACX,WAAW;IACX,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAChB,YAAY;IACZ,YAAY;IACZ,cAAc;IACd,cAAc;IACd,aAAa;IACb,aAAa;IACb,aAAa;IACb,aAAa;IACb,cAAc;IACd,cAAc;IACd,eAAe;IACf,eAAe;IACf,eAAe;IACf,eAAe;IACf,cAAc;IACd,cAAc;IACd,gBAAgB;IAChB,gBAAgB;IAChB,iBAAiB;IACjB,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,iBAAiB;IACjB,iBAAiB;IACjB,YAAY;IACZ,YAAY;IACZ,qBAAqB;IACrB,qBAAqB;IACrB,cAAc;IACd,cAAc;IAEd,4DAA4D;IAC5D,YAAY;IACZ,YAAY;IAEZ,sCAAsC;IACtC,MAAM;IAEN,2EAA2E;IAC3E,OAAO;IACP,aAAa;IACb,aAAa;IACb,aAAa;IACb,aAAa;IAEb,oEAAoE;IACpE,OAAO;IACP,SAAS;IACT,iBAAiB;IACjB,iBAAiB;IACjB,gBAAgB;IAChB,gBAAgB;IAEhB,qFAAqF;IACrF,SAAS;IAET,6EAA6E;IAC7E,QAAQ;IAER,4FAA4F;IAC5F,QAAQ;IAER,kEAAkE;IAClE,IAAI;IACJ,OAAO;IACP,UAAU;IACV,UAAU;IACV,MAAM;IACN,OAAO;IACP,KAAK;IAEL,mEAAmE;IACnE,eAAe;IACf,eAAe;IACf,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,sBAAsB;IACtB,qBAAqB;IACrB,qBAAqB;IAErB,gFAAgF;IAChF,aAAa;IACb,WAAW;IAEX,8EAA8E;IAC9E,oCAAoC;IACpC,gBAAgB;IAChB,eAAe;IAEf,kGAAkG;IAClG,yFAAyF;IACzF,+FAA+F;IAC/F,kBAAkB;IAClB,kBAAkB;IAElB,0DAA0D;IAC1D,YAAY;IACZ,YAAY;IACZ,eAAe;IACf,eAAe;IACf,cAAc;IACd,cAAc;IACd,6BAA6B;IAC7B,6BAA6B;IAC7B,wBAAwB;IACxB,wBAAwB;IACxB,aAAa;IACb,aAAa;IACb,cAAc;IACd,cAAc;CACf,CAAC,CAAC"}