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

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

package/dist/lib/domain-profiles.js

@@ -0,0 +1,118 @@
+/**
+ * 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 const DEFAULT_DOMAIN_PROFILE = {
+    summary: 'See `mj <domain> usage` for this domain’s commands.',
+    runtime: { class: 'variable', note: 'no runtime profile declared for this domain' },
+};
+/**
+ * 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 const DOMAIN_PROFILES = {
+    codegen: {
+        summary: 'Regenerate entities, SQL, and Angular forms from the database schema.',
+        runtime: { class: 'slow', typicalSeconds: 120, note: 'scales with entity count; a full run ≫ a single-entity change' },
+    },
+    sync: {
+        summary: 'Move metadata between local files and the database — push, pull, validate, watch.',
+        runtime: { class: 'variable', note: 'a status check is instant; a full push scales with record count' },
+    },
+    dev: {
+        summary: 'Local development tooling, including the cross-repo pnpm workspace generator.',
+        runtime: { class: 'variable', note: 'generation is fast; a workspace install is not' },
+    },
+    ai: {
+        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' },
+    },
+    app: {
+        summary: 'Install, upgrade, enable, and remove Open Apps.',
+        runtime: { class: 'slow', typicalSeconds: 180, note: 'installs run migrations and package installs' },
+    },
+    artifacts: {
+        summary: 'Maintenance operations over stored conversation artifacts.',
+        runtime: { class: 'moderate', typicalSeconds: 30, note: 'scales with artifact count' },
+    },
+    baseline: {
+        summary: 'Build and compare database baselines for clean-room verification.',
+        runtime: { class: 'slow', typicalSeconds: 120, note: 'full schema introspection; scales with table count' },
+    },
+    bump: {
+        summary: 'Bump the version across workspace package.json files.',
+        runtime: { class: 'fast' },
+    },
+    bundle: {
+        summary: 'Bundle interactive component source for distribution.',
+        runtime: { class: 'moderate', typicalSeconds: 20 },
+    },
+    clean: {
+        summary: 'Remove build artifacts and generated output.',
+        runtime: { class: 'fast' },
+    },
+    dbdoc: {
+        summary: 'Generate and export AI-authored database documentation.',
+        runtime: { class: 'slow', typicalSeconds: 300, note: 'LLM-driven; scales with table and column count' },
+    },
+    doctor: {
+        summary: 'Diagnose the local MJ environment and report what is misconfigured.',
+        runtime: { class: 'moderate', typicalSeconds: 15 },
+    },
+    install: {
+        summary: 'Install MemberJunction, or seed the Claude Code pack into a repo.',
+        runtime: { class: 'slow', typicalSeconds: 300, note: 'downloads a release, installs packages, runs migrations' },
+    },
+    migrate: {
+        summary: 'Create, run, and convert Flyway migrations.',
+        runtime: { class: 'slow', typicalSeconds: 90, note: 'scales with the number of pending migrations' },
+    },
+    plugin: {
+        summary: 'Register third-party CLI plugins in mj-cli-plugins.json.',
+        runtime: { class: 'fast' },
+    },
+    querygen: {
+        summary: 'Generate, validate, and export stored queries.',
+        runtime: { class: 'slow', typicalSeconds: 120, note: 'LLM-driven generation; validation alone is fast' },
+    },
+    'sql-audit': {
+        summary: 'Audit SQL objects for drift against the metadata.',
+        runtime: { class: 'moderate', typicalSeconds: 45, note: 'scales with object count' },
+    },
+    'sql-convert': {
+        summary: 'Convert T-SQL to PostgreSQL via the SQLConverter toolchain.',
+        runtime: { class: 'moderate', typicalSeconds: 30 },
+    },
+    standards: {
+        summary: 'List, adopt, and check the repo’s adopted MJ standards.',
+        runtime: { class: 'moderate', typicalSeconds: 20, note: 'a check scans changed files; --all scans the repo' },
+    },
+    test: {
+        summary: 'Run, list, compare, and validate MJ test suites.',
+        runtime: { class: 'variable', note: 'a single test is seconds; a full suite can run for many minutes' },
+    },
+    'translate-sql': {
+        summary: 'Translate SQL between dialects.',
+        runtime: { class: 'moderate', typicalSeconds: 15 },
+    },
+    update: {
+        summary: 'Update installed MJ tooling, including the Claude Code pack.',
+        runtime: { class: 'moderate', typicalSeconds: 30, note: 'fetches from GitHub unless --from is given' },
+    },
+    usage: {
+        summary: 'This progressive-disclosure surface: domains, then per-domain detail.',
+        runtime: { class: 'fast' },
+    },
+};
+/** The profile for a domain, falling back to {@link DEFAULT_DOMAIN_PROFILE}. */
+export function getDomainProfile(domain) {
+    return DOMAIN_PROFILES[domain] ?? DEFAULT_DOMAIN_PROFILE;
+}
+//# sourceMappingURL=domain-profiles.js.map

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

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

package/dist/lib/domain-usage-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domain-usage-command.d.ts","sourceRoot":"","sources":["../../src/lib/domain-usage-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAK7C;;;;;GAKG;AACH,8BAAsB,kBAAmB,SAAQ,OAAO;IACtD,MAAM,CAAC,KAAK;;MAEV;IAEF,kEAAkE;IAClE,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAE5B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAO3B"}
+{"version":3,"file":"domain-usage-command.d.ts","sourceRoot":"","sources":["../../src/lib/domain-usage-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAM7C;;;;;GAKG;AACH,8BAAsB,kBAAmB,SAAQ,OAAO;IACtD,MAAM,CAAC,KAAK;;MAMV;IAEF,kEAAkE;IAClE,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAE5B,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAQ3B"}

package/dist/lib/domain-usage-command.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 './cli-plugins.js';
 import { emitUsage, renderDomainDetail } from './usage-render.js';
 /**
@@ -10,14 +10,19 @@ import { emitUsage, renderDomainDetail } from './usage-render.js';
  */
 export class DomainUsageCommand extends Command {
     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(this.constructor);
-        await loadAllCliPlugins(process.cwd());
+        await loadAllCliPlugins(process.cwd(), this.config.commands);
         const detail = CLIPluginRegistry.BuildDomainDetail(this.Domain);
         const result = CLIPluginRegistry.AsResult(`${this.Domain}:usage`, { domain: detail.domain, commands: detail.commands });
-        emitUsage((m) => this.log(m), flags.format, result, renderDomainDetail(detail));
+        const { format } = ResolveOutputFormat({ formatFlag: flags.format });
+        emitUsage((m) => this.log(m), format, result, renderDomainDetail(detail));
     }
 }
 //# sourceMappingURL=domain-usage-command.js.map

package/dist/lib/domain-usage-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"domain-usage-command.js","sourceRoot":"","sources":["../../src/lib/domain-usage-command.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,kBAAkB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAElE;;;;;GAKG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,OAAO;aAC/C,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;IAKF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAwC,CAAC,CAAC;QAClF,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxH,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,MAAgB,EAAE,MAAM,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5F,CAAC"}
+{"version":3,"file":"domain-usage-command.js","sourceRoot":"","sources":["../../src/lib/domain-usage-command.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,kBAAkB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGlE;;;;;GAKG;AACH,MAAM,OAAgB,kBAAmB,SAAQ,OAAO;aAC/C,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;IAKF,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAwC,CAAC,CAAC;QAClF,MAAM,iBAAiB,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,QAA0C,CAAC,CAAC;QAC/F,MAAM,MAAM,GAAG,iBAAiB,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAChE,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxH,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,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5E,CAAC"}

package/dist/lib/format-compat.d.ts

@@ -0,0 +1,68 @@
+import { type OutputFormat } from '@memberjunction/cli-core';
+export declare const CANONICAL_FORMAT_FLAG: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+/**
+ * The same flag for `mj test *`, which has always spelled its format flag
+ * `--format` **with a `-f` shorthand**.
+ *
+ * Widening the accepted *values* must not narrow the accepted *spellings*: dropping
+ * `char` would silently break every script that runs `mj test run -f json` — exactly
+ * the class of unannounced breakage this compatibility layer exists to prevent. `-f`
+ * is unclaimed across all six `mj test` commands, so restoring it collides with nothing.
+ *
+ * The `mj ai` family deliberately does NOT get this: `--format` is brand new there
+ * (its historical flag is `--output`/`-o`), so there is no `-f` to preserve, and
+ * `mj ai audit agent-run` already binds `-f` to `--file` — an output FILE path, so
+ * pointing it at a format would repeat the exact `-o` ambiguity described above.
+ */
+export declare const TEST_FORMAT_FLAG: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+/** Inputs to {@link resolveLegacyFormat}. */
+export interface LegacyFormatInput<TLegacy extends string> {
+    /** The canonical `--format` value, if the caller passed one. */
+    format?: string;
+    /** The family's own flag value as oclif parsed it (its default included). */
+    legacy: TLegacy;
+    /** What that flag falls back to when nothing was specified. */
+    legacyDefault: TLegacy;
+    /**
+     * Whether the caller actually typed the family's flag. Pass
+     * `metadata.flags.<name>?.setFromDefault === false` from the command's `parse()`.
+     *
+     * When omitted this falls back to comparing the value against the default, which
+     * cannot distinguish `-o compact` (the caller asking for compact) from no flag at
+     * all — so a piped `mj ai agents list -o compact` would silently return json,
+     * overriding an explicit request. Always pass it from a real command.
+     */
+    legacyWasExplicit?: boolean;
+    /** How each canonical format maps onto this family's vocabulary. */
+    map: Record<OutputFormat, TLegacy>;
+    /** Defaults to `process.stdout.isTTY`. Injectable for tests. */
+    stdoutIsTTY?: boolean;
+    /** Defaults to `process.env`. Injectable for tests. */
+    env?: NodeJS.ProcessEnv;
+}
+/**
+ * Resolves which value of a family's own output flag to use, honoring — in order:
+ *
+ * 1. an explicit canonical `--format`,
+ * 2. an explicit legacy value (anything other than the family default),
+ * 3. `MJ_CLI_FORMAT`,
+ * 4. a piped stdout → the family's json value,
+ * 5. the family default.
+ *
+ * Rule 2 is what makes this backwards compatible: an existing script passing
+ * `--format=markdown` or `-o table` keeps getting exactly what it always got.
+ * Rule 4 only fires when the caller expressed no preference at all, so it can
+ * never override an intentional choice — which is precisely why rule 2 needs
+ * {@link LegacyFormatInput.legacyWasExplicit} rather than a value comparison.
+ */
+export declare function resolveLegacyFormat<TLegacy extends string>(input: LegacyFormatInput<TLegacy>): TLegacy;
+/** Canonical → `mj test *` vocabulary. */
+export declare const TEST_FORMAT_MAP: Record<OutputFormat, 'console' | 'json' | 'markdown'>;
+/**
+ * Canonical → `mj ai *` vocabulary.
+ *
+ * `md` maps to `json` because most `mj ai` commands have no Markdown renderer;
+ * the ones that do (`mj ai audit agent-run`) pass their own map with `markdown`.
+ */
+export declare const AI_FORMAT_MAP: Record<OutputFormat, 'compact' | 'json' | 'table'>;
+//# sourceMappingURL=format-compat.d.ts.map

package/dist/lib/format-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-compat.d.ts","sourceRoot":"","sources":["../../src/lib/format-compat.ts"],"names":[],"mappings":"AAsBA,OAAO,EAA6C,KAAK,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAoBxG,eAAO,MAAM,qBAAqB,6GAGhC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,gBAAgB,6GAI3B,CAAC;AAEH,6CAA6C;AAC7C,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,MAAM;IACvD,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,MAAM,EAAE,OAAO,CAAC;IAChB,+DAA+D;IAC/D,aAAa,EAAE,OAAO,CAAC;IACvB;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,oEAAoE;IACpE,GAAG,EAAE,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IACnC,gEAAgE;IAChE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,uDAAuD;IACvD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,SAAS,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,GAAG,OAAO,CAiBtG;AAED,0CAA0C;AAC1C,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,YAAY,EAAE,SAAS,GAAG,MAAM,GAAG,UAAU,CAIjF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,YAAY,EAAE,SAAS,GAAG,MAAM,GAAG,OAAO,CAI5E,CAAC"}

package/dist/lib/format-compat.js

@@ -0,0 +1,111 @@
+/**
+ * Bridges the per-family output flags to the one canonical `--format` contract.
+ *
+ * Three command families grew their own spelling of the same idea:
+ *
+ * | family           | flag                | values                      |
+ * |------------------|---------------------|-----------------------------|
+ * | plugin commands  | `--format`          | `text` \| `json` \| `md`     |
+ * | `mj test *`      | `--format`          | `console` \| `json` \| `markdown` |
+ * | `mj ai *`        | `--output` / `-o`   | `compact` \| `json` \| `table`    |
+ *
+ * An agent that learned one spelling got a parse error — or worse, in the `mj ai`
+ * case, silence — from the next. Worse still, `-o` means *output format* under
+ * `mj ai` but *output file path* under `mj test`, `querygen export`, and
+ * `sql-audit`, so `-o json` writes a file called `json` in half the CLI.
+ *
+ * {@link resolveLegacyFormat} keeps every existing value working while making all
+ * three families accept the canonical spellings and honor the same TTY-detection
+ * default. {@link CANONICAL_FORMAT_FLAG} is the shared flag definition to add
+ * alongside a family's own.
+ */
+import { Flags } from '@oclif/core';
+import { NormalizeFormatAlias, ResolveOutputFormat } from '@memberjunction/cli-core';
+/**
+ * The canonical `--format` flag for commands that are not yet `BaseCLIPlugin`
+ * subclasses (which inherit it from `baseFlags`).
+ *
+ * Deliberately has **no `default`**: the absence of a value is the signal that
+ * lets {@link resolveLegacyFormat} fall through to the family default or to
+ * TTY detection. A default here would make every run look explicit.
+ *
+ * Note `char` is omitted — `-f` and `-o` already mean other things in these
+ * families, and quietly rebinding a short flag is how the `-o` collision started.
+ */
+const FORMAT_VALUES = ['text', 'json', 'md', 'human', 'console', 'markdown', 'compact', 'table'];
+const FORMAT_DESCRIPTION = 'Output format: text (human), json (machine-readable), md (Markdown). ' +
+    'Defaults to human output on a terminal and json when stdout is piped. ' +
+    'Legacy spellings (console/markdown/compact/table) are accepted.';
+export const CANONICAL_FORMAT_FLAG = Flags.string({
+    options: FORMAT_VALUES,
+    description: FORMAT_DESCRIPTION,
+});
+/**
+ * The same flag for `mj test *`, which has always spelled its format flag
+ * `--format` **with a `-f` shorthand**.
+ *
+ * Widening the accepted *values* must not narrow the accepted *spellings*: dropping
+ * `char` would silently break every script that runs `mj test run -f json` — exactly
+ * the class of unannounced breakage this compatibility layer exists to prevent. `-f`
+ * is unclaimed across all six `mj test` commands, so restoring it collides with nothing.
+ *
+ * The `mj ai` family deliberately does NOT get this: `--format` is brand new there
+ * (its historical flag is `--output`/`-o`), so there is no `-f` to preserve, and
+ * `mj ai audit agent-run` already binds `-f` to `--file` — an output FILE path, so
+ * pointing it at a format would repeat the exact `-o` ambiguity described above.
+ */
+export const TEST_FORMAT_FLAG = Flags.string({
+    char: 'f',
+    options: FORMAT_VALUES,
+    description: FORMAT_DESCRIPTION,
+});
+/**
+ * Resolves which value of a family's own output flag to use, honoring — in order:
+ *
+ * 1. an explicit canonical `--format`,
+ * 2. an explicit legacy value (anything other than the family default),
+ * 3. `MJ_CLI_FORMAT`,
+ * 4. a piped stdout → the family's json value,
+ * 5. the family default.
+ *
+ * Rule 2 is what makes this backwards compatible: an existing script passing
+ * `--format=markdown` or `-o table` keeps getting exactly what it always got.
+ * Rule 4 only fires when the caller expressed no preference at all, so it can
+ * never override an intentional choice — which is precisely why rule 2 needs
+ * {@link LegacyFormatInput.legacyWasExplicit} rather than a value comparison.
+ */
+export function resolveLegacyFormat(input) {
+    const explicitCanonical = NormalizeFormatAlias(input.format);
+    if (explicitCanonical)
+        return input.map[explicitCanonical];
+    // The caller typed the family's own flag — an explicit choice that outranks any
+    // inference we could make, even when the value they typed IS the default.
+    const legacyWasExplicit = input.legacyWasExplicit ?? input.legacy !== input.legacyDefault;
+    if (legacyWasExplicit)
+        return input.legacy;
+    const { format, reason } = ResolveOutputFormat({
+        stdoutIsTTY: input.stdoutIsTTY,
+        env: input.env,
+    });
+    // 'tty-default' means nothing at all asked for a format — keep the family's own
+    // default rather than flattening every human rendering to a generic 'text'.
+    return reason === 'tty-default' ? input.legacyDefault : input.map[format];
+}
+/** Canonical → `mj test *` vocabulary. */
+export const TEST_FORMAT_MAP = {
+    text: 'console',
+    json: 'json',
+    md: 'markdown',
+};
+/**
+ * Canonical → `mj ai *` vocabulary.
+ *
+ * `md` maps to `json` because most `mj ai` commands have no Markdown renderer;
+ * the ones that do (`mj ai audit agent-run`) pass their own map with `markdown`.
+ */
+export const AI_FORMAT_MAP = {
+    text: 'compact',
+    json: 'json',
+    md: 'json',
+};
+//# sourceMappingURL=format-compat.js.map

package/dist/lib/format-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-compat.js","sourceRoot":"","sources":["../../src/lib/format-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAqB,MAAM,0BAA0B,CAAC;AAExG;;;;;;;;;;GAUG;AACH,MAAM,aAAa,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;AAEjG,MAAM,kBAAkB,GACtB,uEAAuE;IACvE,wEAAwE;IACxE,iEAAiE,CAAC;AAEpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC,MAAM,CAAC;IAChD,OAAO,EAAE,aAAa;IACtB,WAAW,EAAE,kBAAkB;CAChC,CAAC,CAAC;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,CAAC,MAAM,CAAC;IAC3C,IAAI,EAAE,GAAG;IACT,OAAO,EAAE,aAAa;IACtB,WAAW,EAAE,kBAAkB;CAChC,CAAC,CAAC;AA4BH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,mBAAmB,CAAyB,KAAiC;IAC3F,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7D,IAAI,iBAAiB;QAAE,OAAO,KAAK,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAE3D,gFAAgF;IAChF,0EAA0E;IAC1E,MAAM,iBAAiB,GAAG,KAAK,CAAC,iBAAiB,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,aAAa,CAAC;IAC1F,IAAI,iBAAiB;QAAE,OAAO,KAAK,CAAC,MAAM,CAAC;IAE3C,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,mBAAmB,CAAC;QAC7C,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,GAAG,EAAE,KAAK,CAAC,GAAG;KACf,CAAC,CAAC;IAEH,gFAAgF;IAChF,4EAA4E;IAC5E,OAAO,MAAM,KAAK,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;AAC5E,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,MAAM,eAAe,GAA0D;IACpF,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,UAAU;CACf,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAuD;IAC/E,IAAI,EAAE,SAAS;IACf,IAAI,EAAE,MAAM;IACZ,EAAE,EAAE,MAAM;CACX,CAAC"}

package/dist/lib/interactive-guard.d.ts

@@ -0,0 +1,56 @@
+/**
+ * MJCLI-side helpers for the agent-first interactivity contract (see
+ * `@memberjunction/cli-core`'s `interaction.ts` for the model).
+ *
+ * These exist because most `mj` commands are still plain oclif `Command`s rather
+ * than `BaseCLIPlugin` subclasses, so they don't inherit `--interactive` or the
+ * structured `NonInteractiveError` handling. They read the same env signal the prerun
+ * hook sets from that flag, which keeps a migrated plugin and an unmigrated command
+ * behaving identically at the prompt — and both of them detecting a terminal the same
+ * way when no flag is given.
+ */
+import { NonInteractiveError, RequireInteractive, ResolveOrPrompt, type InteractivityInput } from '@memberjunction/cli-core';
+export { NonInteractiveError };
+/**
+ * Whether this run may prompt: true at a real terminal, false when piped, spawned, or
+ * running in CI. Reads the env var the prerun hook sets from the global `--interactive`
+ * / `--no-interactive` flags, then falls back to detecting the terminal.
+ */
+export declare function isInteractiveRun(overrides?: InteractivityInput): boolean;
+/**
+ * Asks for one value, or fails fast naming the flag that supplies it.
+ *
+ * Thin re-export of cli-core's `ResolveOrPrompt` so unmigrated commands import from
+ * one place and pick up the env-based interactivity default automatically.
+ */
+export declare const resolveOrPrompt: typeof ResolveOrPrompt;
+/** Guards a command that is interactive by nature and has no flag equivalent. */
+export declare const requireInteractive: typeof RequireInteractive;
+/**
+ * Renders a {@link NonInteractiveError} through oclif's error path for commands that
+ * aren't `BaseCLIPlugin` subclasses (which get the structured envelope instead).
+ *
+ * Sets exit code 1 and prints the suggestion, so an agent reading stderr still gets
+ * the flag to pass — the important half of the contract — even before the command is
+ * migrated.
+ *
+ * Re-throws anything that isn't a `NonInteractiveError` untouched.
+ */
+export declare function failOnNonInteractive(command: {
+    error: (message: string | Error, options?: {
+        exit?: number;
+        suggestions?: string[];
+    }) => never;
+}, error: unknown): never;
+/**
+ * Wraps a command body so any {@link NonInteractiveError} raised anywhere inside it
+ * — including deep in a service callback — surfaces as a clean, actionable failure
+ * instead of an unhandled rejection.
+ */
+export declare function withNonInteractiveHandling<T>(command: {
+    error: (message: string | Error, options?: {
+        exit?: number;
+        suggestions?: string[];
+    }) => never;
+}, body: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=interactive-guard.d.ts.map

package/dist/lib/interactive-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive-guard.d.ts","sourceRoot":"","sources":["../../src/lib/interactive-guard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAElB,eAAe,EACf,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,GAAE,kBAAuB,GAAG,OAAO,CAE5E;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,wBAAkB,CAAC;AAE/C,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,2BAAqB,CAAC;AAErD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE;IAAE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,KAAK,CAAA;CAAE,EAC3G,KAAK,EAAE,OAAO,GACb,KAAK,CAKP;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,CAAC,CAAC,EAChD,OAAO,EAAE;IAAE,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,KAAK,KAAK,CAAA;CAAE,EAC3G,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,CAAC,CAMZ"}