@memberjunction/cli 6.1.0-edge.3 → 6.1.0-edge.5

package/dist/commands/update/usage.d.ts

@@ -0,0 +1,7 @@
+import { DomainUsageCommand } from '../../lib/domain-usage-command.js';
+/** Tier-2 usage for the `update` domain (`mj update usage`). */
+export default class UpdateUsage extends DomainUsageCommand {
+    static description: string;
+    protected Domain: string;
+}
+//# sourceMappingURL=usage.d.ts.map

package/dist/commands/update/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/commands/update/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,gEAAgE;AAChE,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,kBAAkB;IACzD,MAAM,CAAC,WAAW,SAAmF;IACrG,SAAS,CAAC,MAAM,SAAY;CAC7B"}

package/dist/commands/update/usage.js

@@ -0,0 +1,10 @@
+import { DomainUsageCommand } from '../../lib/domain-usage-command.js';
+/** Tier-2 usage for the `update` domain (`mj update usage`). */
+export default class UpdateUsage extends DomainUsageCommand {
+    constructor() {
+        super(...arguments);
+        this.Domain = 'update';
+    }
+    static { this.description = 'Show usage, flags, examples, and runtime hints for every `mj update` command.'; }
+}
+//# sourceMappingURL=usage.js.map

package/dist/commands/update/usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../../src/commands/update/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE,gEAAgE;AAChE,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,kBAAkB;IAA3D;;QAEY,WAAM,GAAG,QAAQ,CAAC;IAC9B,CAAC;aAFQ,gBAAW,GAAG,+EAA+E,AAAlF,CAAmF"}

package/dist/commands/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/commands/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACxC,MAAM,CAAC,WAAW,SAA+G;IAEjI,MAAM,CAAC,QAAQ,WAGb;IAEF,MAAM,CAAC,KAAK;;MAEV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAO3B"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../src/commands/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAM7C;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;IACxC,MAAM,CAAC,WAAW,SAA+G;IAEjI,MAAM,CAAC,QAAQ,WAGb;IAEF,MAAM,CAAC,KAAK;;MAMV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ3B"}

package/dist/commands/usage.js

@@ -1,5 +1,5 @@
 import { Command, Flags } from '@oclif/core';
-import { CLIPluginRegistry } from '@memberjunction/cli-core';
+import { CLIPluginRegistry, ResolveOutputFormat } from '@memberjunction/cli-core';
 import { loadAllCliPlugins } from '../lib/cli-plugins.js';
 import { emitUsage, renderDomainMap } from '../lib/usage-render.js';
 /**
@@ -16,14 +16,19 @@ export default class Usage extends Command {
         `<%= config.bin %> <%= command.id %> --format=json`,
     ]; }
     static { this.flags = {
-        format: Flags.string({ options: ['text', 'json', 'md'], default: 'text', description: 'Output format' }),
+        // No default: the absence of a value is what lets a piped stdout select json.
+        format: Flags.string({
+            options: ['text', 'json', 'md'],
+            description: 'Output format. Defaults to text on a terminal and json when stdout is piped.',
+        }),
     }; }
     async run() {
         const { flags } = await this.parse(Usage);
-        await loadAllCliPlugins(process.cwd());
+        await loadAllCliPlugins(process.cwd(), this.config.commands);
         const map = CLIPluginRegistry.BuildDomainMap();
         const result = CLIPluginRegistry.AsResult('usage', { guidance: map.guidance, domains: map.domains });
-        emitUsage((m) => this.log(m), flags.format, result, renderDomainMap(map));
+        const { format } = ResolveOutputFormat({ formatFlag: flags.format });
+        emitUsage((m) => this.log(m), format, result, renderDomainMap(map));
     }
 }
 //# sourceMappingURL=usage.js.map

package/dist/commands/usage.js.map

@@ -1 +1 @@
-{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/commands/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEpE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;aACjC,gBAAW,GAAG,2GAA2G,CAAC;aAE1H,aAAQ,GAAG;QAChB,qCAAqC;QACrC,mDAAmD;KACpD,CAAC;aAEK,UAAK,GAAG;QACb,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,eAAe,EAAE,CAAC;KACzG,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,iBAAiB,CAAC,cAAc,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACrG,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,MAAgB,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IACtF,CAAC"}
+{"version":3,"file":"usage.js","sourceRoot":"","sources":["../../src/commands/usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAClF,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGpE;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,KAAM,SAAQ,OAAO;aACjC,gBAAW,GAAG,2GAA2G,CAAC;aAE1H,aAAQ,GAAG;QAChB,qCAAqC;QACrC,mDAAmD;KACpD,CAAC;aAEK,UAAK,GAAG;QACb,8EAA8E;QAC9E,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC;YACnB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC;YAC/B,WAAW,EAAE,8EAA8E;SAC5F,CAAC;KACH,CAAC;IAEF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1C,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,QAA0C,CAAC,CAAC;QAC/F,MAAM,GAAG,GAAG,iBAAiB,CAAC,cAAc,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QACrG,MAAM,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACrE,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IACtE,CAAC"}

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;AAInC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,QAAQ,CAoExB,CAAC;AAcF,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;AAgCnC,QAAA,MAAM,IAAI,EAAE,IAAI,CAAC,QAAQ,CA2ExB,CAAC;AAcF,eAAe,IAAI,CAAC"}

package/dist/hooks/prerun.js

@@ -1,42 +1,75 @@
 import figlet from 'figlet';
+import { INTERACTIVE_ENV, ResolveOutputFormat, ShouldSuppressChrome } from '@memberjunction/cli-core';
 import { LIGHT_COMMANDS } from '../light-commands.js';
+/**
+ * Strips a global boolean flag from argv in place and reports whether it was there.
+ *
+ * Global chrome flags have to work on ANY command, including the ~80 that are still
+ * plain oclif `Command`s and don't declare them — oclif's strict parser would reject
+ * an undeclared flag with "Nonexistent flag". So the hook consumes them here and
+ * signals downstream through the environment instead.
+ */
+function takeGlobalFlag(argv, flag) {
+    let found = false;
+    for (let i = argv.length - 1; i >= 0; i--) {
+        if (argv[i] === flag) {
+            argv.splice(i, 1);
+            found = true;
+        }
+    }
+    return found;
+}
+/** Reads `--format=x` or `--format x` out of raw argv, before any command has parsed it. */
+function readFormatArg(argv) {
+    const eq = argv.find((a) => a.startsWith('--format='));
+    if (eq)
+        return eq.slice('--format='.length);
+    const i = argv.indexOf('--format');
+    return i >= 0 ? argv[i + 1] : undefined;
+}
 const hook = async function (options) {
     const argv = options.argv ?? [];
-    // Machine-readable output must keep stdout clean — suppress the banner AND the
-    // userAgent line entirely for `--format=json|md` and `--no-banner` (plan §1a/D4).
-    const formatArg = (() => {
-        const eq = argv.find((a) => a.startsWith('--format='));
-        if (eq)
-            return eq.slice('--format='.length);
-        const i = argv.indexOf('--format');
-        return i >= 0 ? argv[i + 1] : undefined;
-    })();
-    const machineFormat = formatArg === 'json' || formatArg === 'md';
-    const noBanner = argv.includes('--no-banner');
-    // `--no-banner` is global chrome — every command renders the banner, so suppressing
-    // it must work on ANY command, including those not yet migrated to BaseCLIPlugin
-    // (which don't declare the flag and would otherwise fail oclif's strict parser with
-    // "Nonexistent flag"). Signal suppression to MJCLIRuntimeHost via env (so migrated
-    // commands still gate their runtime advisory) and strip the flag from argv in place
-    // so the per-command parser never sees an undeclared flag.
+    // `--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
+    // via env to both BaseCLIPlugin and the unmigrated commands' interactive guards.
+    // BOTH are stripped unconditionally before either is acted on: short-circuiting the
+    // second strip would leave the losing flag in argv, where oclif's strict parser
+    // rejects it as a nonexistent flag on any command that doesn't declare it.
+    const forceOff = takeGlobalFlag(argv, '--no-interactive');
+    const forceOn = takeGlobalFlag(argv, '--interactive');
+    // Passing both resolves to off — the safe answer when the caller contradicts itself.
+    if (forceOff)
+        process.env[INTERACTIVE_ENV] = '0';
+    else if (forceOn)
+        process.env[INTERACTIVE_ENV] = '1';
+    const noBanner = takeGlobalFlag(argv, '--no-banner');
     if (noBanner) {
         process.env.MJ_CLI_NO_BANNER = '1';
-        for (let i = argv.length - 1; i >= 0; i--) {
-            if (argv[i] === '--no-banner')
-                argv.splice(i, 1);
-        }
     }
-    // Skip banners if --quiet flag is present (or appears to be present)
-    if (machineFormat || noBanner || argv.some((arg) => arg === '--quiet' || (/^-[^-]+/.test(arg) && arg.includes('q')))) {
-        // Still conditionally load bootstrap below — just no decorative output.
+    // Decide chrome with the SAME resolver the commands themselves use, rather than
+    // re-deriving the format from argv here. The two views drifting is not hypothetical:
+    // while this hook only looked for `--format` in argv, `MJ_CLI_FORMAT=json mj codegen`
+    // at a terminal printed a figlet banner and *then* a JSON envelope — the env var the
+    // command honours was invisible to the banner decision, and the pipe check that would
+    // otherwise have saved us does not fire on a TTY. Routing both through
+    // ResolveOutputFormat makes that class of mismatch unrepresentable, and picks up the
+    // format aliases (`markdown`, `console`, …) for free.
+    const { format } = ResolveOutputFormat({
+        formatFlag: readFormatArg(argv),
+        // oclif's own `--json` boolean, declared by install:claude / update:claude.
+        jsonFlag: argv.includes('--json'),
+    });
+    const quiet = argv.some((arg) => arg === '--quiet' || (/^-[^-]+/.test(arg) && arg.includes('q')));
+    // ShouldSuppressChrome covers both machine formats and a redirected stdout: a caller
+    // that piped us has already said it is a machine, and a banner in its capture buffer
+    // is pure noise.
+    if (noBanner || quiet || ShouldSuppressChrome(format)) {
+        // Still conditionally load bootstrap — just no decorative output. (The old `--json`
+        // branch returned *without* loading it, which would have silently skipped class
+        // registration for any heavy command that later grew a `--json` flag.)
         return await maybeLoadBootstrap(options);
     }
-    // Skip banners entirely when --json is requested — the contract for --json
-    // is that stdout is parseable JSON, and any banner above it breaks
-    // `mj … --json | jq`. This early-return also skips the userAgent line below.
-    if (options.argv?.some((arg) => arg === '--json')) {
-        return;
-    }
     // Suppress the large figlet banner for hot-path, frequently-run commands (e.g. `mj sync *`)
     // and the agent-facing usage commands, where it's pure scrollback cost. The
     // compact userAgent line below still prints.

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;AAEtD;;;;;;;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;IAEhC,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,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,IAAI,QAAQ,IAAI,KAAK,IAAI,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QACtD,oFAAoF;QACpF,gFAAgF;QAChF,uEAAuE;QACvE,OAAO,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC3C,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,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;AACpC,CAAC,CAAC;AAEF;;;;GAIG;AACH,KAAK,UAAU,kBAAkB,CAAC,OAAqC;IACrE,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,MAAM,MAAM,CAAC,8DAA8D,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED,eAAe,IAAI,CAAC"}

package/dist/lib/cli-plugins.d.ts

@@ -1,3 +1,4 @@
+import { type OclifCommandShape } from './derived-usage.js';
 /**
  * Loads all CLI plugins so their `@RegisterClass(BaseCLIPlugin, …)` decorators
  * populate the ClassFactory — the basis for the `mj usage` / `mj <domain> usage`
@@ -11,6 +12,12 @@
  * These plugin modules are intentionally light — they static-import only
  * cli-core + oclif + global and dynamic-import their heavy engines at execution
  * time — so loading them here for usage composition is cheap.
+ *
+ * Finally, when the caller passes oclif's own command list, every command that no
+ * plugin declared gets a usage entry derived from oclif's manifest. Registration
+ * order is load-bearing: plugin metadata is read first and `RegisterUsage` is
+ * first-wins, so a migrated command keeps its curated entry and only the rest fall
+ * back to derivation.
  */
-export declare function loadAllCliPlugins(searchFrom?: string): Promise<void>;
+export declare function loadAllCliPlugins(searchFrom?: string, oclifCommands?: readonly OclifCommandShape[]): Promise<void>;
 //# sourceMappingURL=cli-plugins.d.ts.map

package/dist/lib/cli-plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-plugins.d.ts","sourceRoot":"","sources":["../../src/lib/cli-plugins.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAazF"}
+{"version":3,"file":"cli-plugins.d.ts","sourceRoot":"","sources":["../../src/lib/cli-plugins.ts"],"names":[],"mappings":"AAEA,OAAO,EAAwB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGlF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,GAAE,MAAsB,EAClC,aAAa,CAAC,EAAE,SAAS,iBAAiB,EAAE,GAC3C,OAAO,CAAC,IAAI,CAAC,CAsBf"}

package/dist/lib/cli-plugins.js

@@ -1,5 +1,7 @@
 import { CLIPluginRegistry } from '@memberjunction/cli-core';
 import { RegisterDevWorkspaceUsage } from './dev-workspace/usage.js';
+import { registerDerivedUsage } from './derived-usage.js';
+import { DOMAIN_PROFILES } from './domain-profiles.js';
 /**
  * Loads all CLI plugins so their `@RegisterClass(BaseCLIPlugin, …)` decorators
  * populate the ClassFactory — the basis for the `mj usage` / `mj <domain> usage`
@@ -13,8 +15,14 @@ import { RegisterDevWorkspaceUsage } from './dev-workspace/usage.js';
  * These plugin modules are intentionally light — they static-import only
  * cli-core + oclif + global and dynamic-import their heavy engines at execution
  * time — so loading them here for usage composition is cheap.
+ *
+ * Finally, when the caller passes oclif's own command list, every command that no
+ * plugin declared gets a usage entry derived from oclif's manifest. Registration
+ * order is load-bearing: plugin metadata is read first and `RegisterUsage` is
+ * first-wins, so a migrated command keeps its curated entry and only the rest fall
+ * back to derivation.
  */
-export async function loadAllCliPlugins(searchFrom = process.cwd()) {
+export async function loadAllCliPlugins(searchFrom = process.cwd(), oclifCommands) {
     await import('@memberjunction/metadata-sync/plugins');
     await import('@memberjunction/codegen-lib/plugins');
     // The `dev` domain ships inside this CLI as plain oclif commands (they must stay
@@ -27,5 +35,13 @@ export async function loadAllCliPlugins(searchFrom = process.cwd()) {
     for (const f of failed) {
         process.stderr.write(`Warning: could not load CLI plugin "${f.specifier}": ${f.error}\n`);
     }
+    // Tier-1 domain summaries: a hand-written line beats one synthesized from N command
+    // summaries. Registered for every profiled domain, including plugin-backed ones —
+    // first-wins means a plugin that already declared one keeps it.
+    for (const [domain, profile] of Object.entries(DOMAIN_PROFILES)) {
+        CLIPluginRegistry.RegisterDomainSummary(domain, profile.summary);
+    }
+    if (oclifCommands?.length)
+        registerDerivedUsage(oclifCommands);
 }
 //# sourceMappingURL=cli-plugins.js.map

package/dist/lib/cli-plugins.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-plugins.js","sourceRoot":"","sources":["../../src/lib/cli-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAErE;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,aAAqB,OAAO,CAAC,GAAG,EAAE;IACxE,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;IACtD,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;IACpD,iFAAiF;IACjF,oFAAoF;IACpF,2DAA2D;IAC3D,yBAAyB,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC7E,6EAA6E;IAC7E,oDAAoD;IACpD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC"}
+{"version":3,"file":"cli-plugins.js","sourceRoot":"","sources":["../../src/lib/cli-plugins.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,oBAAoB,EAA0B,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,aAAqB,OAAO,CAAC,GAAG,EAAE,EAClC,aAA4C;IAE5C,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;IACtD,MAAM,MAAM,CAAC,qCAAqC,CAAC,CAAC;IACpD,iFAAiF;IACjF,oFAAoF;IACpF,2DAA2D;IAC3D,yBAAyB,EAAE,CAAC;IAC5B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,iBAAiB,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAC7E,6EAA6E;IAC7E,oDAAoD;IACpD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC5F,CAAC;IAED,oFAAoF;IACpF,kFAAkF;IAClF,gEAAgE;IAChE,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAChE,iBAAiB,CAAC,qBAAqB,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,IAAI,aAAa,EAAE,MAAM;QAAE,oBAAoB,CAAC,aAAa,CAAC,CAAC;AACjE,CAAC"}

package/dist/lib/derived-usage.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Derives `mj usage` entries for the commands that are still plain oclif
+ * `Command`s, straight from oclif's own manifest.
+ *
+ * Why derive rather than hand-write: `mj usage` tier 1 tells an agent
+ * *"Run `mj <domain> usage` before invoking. Do NOT guess flags."* — so a domain
+ * absent from that map reads as "this domain does not exist". Before this, only the
+ * handful of `BaseCLIPlugin` domains were registered, and the map confidently
+ * advertised a fraction of the CLI. A map that lies by omission is worse than no map,
+ * because an agent has no way to tell the difference.
+ *
+ * Hand-writing 80-odd `PluginUsage` literals would have fixed it once and rotted
+ * immediately. oclif already holds every command's description, flags, and examples
+ * and cannot fall out of sync with itself, so the only thing left to hand-maintain
+ * is what oclif genuinely doesn't know: the runtime budget (see `domain-profiles.ts`).
+ *
+ * Registration is additive and never overwrites: `CLIPluginRegistry.RegisterUsage`
+ * keeps the first entry per command key, and plugin-declared `static Usage` is read
+ * first, so a migrated command always keeps its richer, curated metadata.
+ */
+import { type PluginUsage } from '@memberjunction/cli-core';
+/**
+ * The slice of oclif's `Command.Loadable` this module reads.
+ *
+ * Declared structurally rather than imported so the derivation can be unit-tested
+ * with plain literals, and so a future oclif shape change surfaces here rather than
+ * in every caller.
+ */
+export interface OclifCommandShape {
+    id: string;
+    description?: string;
+    summary?: string;
+    hidden?: boolean;
+    flags?: Record<string, OclifFlagShape | undefined>;
+    examples?: ReadonlyArray<string | {
+        command?: string;
+        description?: string;
+    }>;
+}
+/** The slice of an oclif flag definition this module reads. */
+export interface OclifFlagShape {
+    type?: string;
+    description?: string;
+    char?: string;
+    options?: readonly string[];
+    required?: boolean;
+}
+/** The domain is the first segment: `sync:push` → `sync`, `codegen` → `codegen`. */
+export declare function domainOf(commandId: string): string;
+/**
+ * Synthesizes a {@link PluginUsage} from one oclif command definition.
+ *
+ * Exported for testing — the registration path below is what production calls.
+ */
+export declare function deriveUsage(command: OclifCommandShape): PluginUsage;
+/**
+ * Registers derived usage for every visible oclif command.
+ *
+ * Hidden commands and oclif's own built-ins (`help`, `version`) are skipped — the
+ * former are hidden from humans, so advertising them to an agent would be a strictly
+ * worse kind of surprise; the latter are not MJ domains. Already-registered commands
+ * (plugins, and the `dev` domain's explicit registrations) are left alone by
+ * `RegisterUsage`'s first-wins rule.
+ *
+ * Returns the keys it registered, so a caller or test can assert coverage.
+ */
+export declare function registerDerivedUsage(commands: readonly OclifCommandShape[]): string[];
+//# sourceMappingURL=derived-usage.d.ts.map

package/dist/lib/derived-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derived-usage.d.ts","sourceRoot":"","sources":["../../src/lib/derived-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAqB,KAAK,WAAW,EAAwB,MAAM,0BAA0B,CAAC;AAGrG;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,CAAC,CAAC;IACnD,QAAQ,CAAC,EAAE,aAAa,CAAC,MAAM,GAAG;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC/E;AAED,+DAA+D;AAC/D,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAcD,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAElD;AAsCD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAenE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,GAAG,MAAM,EAAE,CAUrF"}

package/dist/lib/derived-usage.js

@@ -0,0 +1,121 @@
+/**
+ * Derives `mj usage` entries for the commands that are still plain oclif
+ * `Command`s, straight from oclif's own manifest.
+ *
+ * Why derive rather than hand-write: `mj usage` tier 1 tells an agent
+ * *"Run `mj <domain> usage` before invoking. Do NOT guess flags."* — so a domain
+ * absent from that map reads as "this domain does not exist". Before this, only the
+ * handful of `BaseCLIPlugin` domains were registered, and the map confidently
+ * advertised a fraction of the CLI. A map that lies by omission is worse than no map,
+ * because an agent has no way to tell the difference.
+ *
+ * Hand-writing 80-odd `PluginUsage` literals would have fixed it once and rotted
+ * immediately. oclif already holds every command's description, flags, and examples
+ * and cannot fall out of sync with itself, so the only thing left to hand-maintain
+ * is what oclif genuinely doesn't know: the runtime budget (see `domain-profiles.ts`).
+ *
+ * Registration is additive and never overwrites: `CLIPluginRegistry.RegisterUsage`
+ * keeps the first entry per command key, and plugin-declared `static Usage` is read
+ * first, so a migrated command always keeps its richer, curated metadata.
+ */
+import { CLIPluginRegistry } from '@memberjunction/cli-core';
+import { getDomainProfile } from './domain-profiles.js';
+/**
+ * oclif's own built-in plugin commands. They are real commands, but they are not part
+ * of MJ's surface — advertising `help` and `version` as top-level *domains* in the
+ * tier-1 map would push two non-domains ahead of real ones for no benefit.
+ */
+const BUILT_IN_COMMANDS = new Set(['help', 'version']);
+/** oclif ids are colon-separated internally but render with the configured separator. */
+function normalizeCommandKey(id) {
+    return id.trim().replace(/[\s:]+/g, ':');
+}
+/** The domain is the first segment: `sync:push` → `sync`, `codegen` → `codegen`. */
+export function domainOf(commandId) {
+    return normalizeCommandKey(commandId).split(':')[0] ?? commandId;
+}
+/**
+ * First sentence (or first line) of a description, for the one-line summary.
+ * oclif descriptions are frequently multi-paragraph; the tier-1 map has room for one line.
+ */
+function firstLine(text) {
+    if (!text)
+        return undefined;
+    const line = text.split('\n').map((l) => l.trim()).find((l) => l.length > 0);
+    if (!line)
+        return undefined;
+    const sentence = /^(.*?[.!?])(\s|$)/.exec(line);
+    return (sentence?.[1] ?? line).trim();
+}
+/** oclif accepts examples as strings or `{command, description}` objects. */
+function normalizeExamples(examples) {
+    if (!examples?.length)
+        return undefined;
+    const out = examples
+        .map((e) => (typeof e === 'string' ? e : e.command))
+        .filter((e) => typeof e === 'string' && e.length > 0);
+    return out.length > 0 ? out : undefined;
+}
+/** Converts oclif's flag record to the usage surface's flag list, options included. */
+function normalizeFlags(flags) {
+    if (!flags)
+        return undefined;
+    const out = [];
+    for (const [name, def] of Object.entries(flags)) {
+        if (!def)
+            continue;
+        const type = def.options?.length ? def.options.join('|') : (def.type ?? 'string');
+        const parts = [def.description ?? ''];
+        if (def.char)
+            parts.push(`(-${def.char})`);
+        if (def.required)
+            parts.push('(required)');
+        out.push({ name: `--${name}`, type, description: parts.filter(Boolean).join(' ').trim() });
+    }
+    return out.length > 0 ? out : undefined;
+}
+/**
+ * Synthesizes a {@link PluginUsage} from one oclif command definition.
+ *
+ * Exported for testing — the registration path below is what production calls.
+ */
+export function deriveUsage(command) {
+    const key = normalizeCommandKey(command.id);
+    const domain = domainOf(key);
+    const profile = getDomainProfile(domain);
+    const description = command.description ?? command.summary;
+    return {
+        domain,
+        command: key,
+        summary: command.summary ?? firstLine(description) ?? `mj ${key.replace(/:/g, ' ')}`,
+        description,
+        flags: normalizeFlags(command.flags),
+        examples: normalizeExamples(command.examples),
+        runtime: profile.runtime,
+    };
+}
+/**
+ * Registers derived usage for every visible oclif command.
+ *
+ * Hidden commands and oclif's own built-ins (`help`, `version`) are skipped — the
+ * former are hidden from humans, so advertising them to an agent would be a strictly
+ * worse kind of surprise; the latter are not MJ domains. Already-registered commands
+ * (plugins, and the `dev` domain's explicit registrations) are left alone by
+ * `RegisterUsage`'s first-wins rule.
+ *
+ * Returns the keys it registered, so a caller or test can assert coverage.
+ */
+export function registerDerivedUsage(commands) {
+    const registered = [];
+    for (const command of commands) {
+        if (!command?.id || command.hidden)
+            continue;
+        if (BUILT_IN_COMMANDS.has(normalizeCommandKey(command.id)))
+            continue;
+        const usage = deriveUsage(command);
+        CLIPluginRegistry.RegisterUsage(usage);
+        registered.push(usage.command);
+    }
+    return registered;
+}
+//# sourceMappingURL=derived-usage.js.map

package/dist/lib/derived-usage.js.map

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

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

@@ -0,0 +1,42 @@
+import type { RuntimeHint } from '@memberjunction/cli-core';
+/**
+ * Per-domain runtime + summary for the commands that are still plain oclif
+ * `Command`s rather than `BaseCLIPlugin` subclasses.
+ *
+ * This table is deliberately the ONLY hand-maintained part of the usage surface.
+ * Everything else about an unmigrated command — its description, flags, and
+ * examples — is derived from oclif's own manifest at runtime (see
+ * `derived-usage.ts`), so it cannot drift from the actual command.
+ *
+ * What lives here is exactly what oclif does not know: how long a command tends to
+ * run (so an agent can budget a timeout) and a one-line domain summary for the
+ * tier-1 map. A domain missing from this table still appears — it just falls back
+ * to {@link DEFAULT_DOMAIN_PROFILE}, so adding a command can never make `mj usage`
+ * lie by omission.
+ */
+export interface DomainProfile {
+    /** One line for the tier-1 `mj usage` map. */
+    summary: string;
+    /** Timeout budget for the slowest command in the domain. */
+    runtime: RuntimeHint;
+}
+/**
+ * Applied to any domain not listed below. `variable` is the honest answer for an
+ * undocumented command — it tells an agent "I don't know, don't set a tight timeout"
+ * rather than implying a fast run.
+ */
+export declare const DEFAULT_DOMAIN_PROFILE: DomainProfile;
+/**
+ * Per-domain profiles.
+ *
+ * Domains whose commands ship as `BaseCLIPlugin` plugins (`sync`, `codegen`) still
+ * appear here: a plugin declares usage per COMMAND, and the tier-1 map needs a line
+ * for the DOMAIN. Without one, a multi-command domain renders as one command's
+ * summary plus "(+7 more commands)", which tells an agent nothing about what the
+ * domain is for. The per-command metadata those plugins declare is untouched —
+ * `RegisterUsage` is first-wins and reads plugin metadata first.
+ */
+export declare const DOMAIN_PROFILES: Readonly<Record<string, DomainProfile>>;
+/** The profile for a domain, falling back to {@link DEFAULT_DOMAIN_PROFILE}. */
+export declare function getDomainProfile(domain: string): DomainProfile;
+//# sourceMappingURL=domain-profiles.d.ts.map

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

@@ -0,0 +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"}