@rudderjs/cli 4.15.0 → 4.17.0

package/dist/commands/completion.d.ts

@@ -0,0 +1,64 @@
+import type { Command } from 'commander';
+export declare const SUPPORTED_SHELLS: readonly ["bash", "zsh", "fish"];
+export type Shell = (typeof SUPPORTED_SHELLS)[number];
+/**
+ * The static set of command names completed in v1. Built-in CLI commands plus
+ * the commands every framework package contributes. Keep roughly in sync with
+ * the ownership table in packages/cli/CLAUDE.md; drift here only costs a missing
+ * suggestion, never a broken command. Every name has at most one ':' — the bash
+ * script's colon handling relies on that.
+ */
+export declare const COMMAND_NAMES: readonly string[];
+/**
+ * Commands whose first argument is conventionally an existing model name. When
+ * completing their argument, the shell calls back into `rudder completion args`
+ * to list the project's models. Routes/migrations have no arg-taking command to
+ * complete against yet, so models are the whole v1 surface.
+ */
+export declare const MODEL_ARG_COMMANDS: readonly string[];
+/**
+ * Resolve dynamic argument candidates for `command`, rooted at `cwd`. v1 returns
+ * model names (the `app/Models` basenames) for the model-oriented make commands.
+ * Filesystem-only, no app boot. Returns [] when there is nothing to suggest
+ * (unknown command, not inside a project, empty dir).
+ */
+export declare function resolveArgCandidates(command: string, cwd?: string): string[];
+/**
+ * Resolve flag candidates from a command's live commander definition: its long
+ * options plus `--help` (every command has it). For an unknown command (or the
+ * top-level `rudder`) we return the global flags. Reading the real definitions
+ * means the list never drifts from the actual options.
+ */
+export declare function resolveFlagCandidates(cmd: Command | undefined): string[];
+/** Emit a self-contained completion script for the given shell. */
+export declare function completionScript(shell: Shell): string;
+interface InstallPlan {
+    /** Where the sourced completion script is written. */
+    scriptPath: string;
+    /** The rc file to add a source line to, or null when the shell autoloads (fish). */
+    rcFile: string | null;
+    /** The exact line that sources the script (bash/zsh). */
+    sourceLine: string;
+}
+/** Resolve the file locations for a shell, rooted at `home`. Pure — no I/O. */
+export declare function installPlan(shell: Shell, home: string): InstallPlan;
+/** Detect the user's shell from $SHELL. Returns null if it isn't one we support. */
+export declare function detectShell(env?: NodeJS.ProcessEnv): Shell | null;
+/** Idempotently add the source block to an rc file. Returns true if it changed. */
+declare function addSourceBlock(rcFile: string, sourceLine: string): boolean;
+/** Remove the source block from an rc file. Returns true if it changed. */
+declare function removeSourceBlock(rcFile: string): boolean;
+declare function runInstall(shell: Shell, home: string): void;
+declare function runUninstall(shell: Shell, home: string): void;
+/** Test surface — not part of the public API. */
+export declare const _internal: {
+    addSourceBlock: typeof addSourceBlock;
+    removeSourceBlock: typeof removeSourceBlock;
+    runInstall: typeof runInstall;
+    runUninstall: typeof runUninstall;
+    BLOCK_START: string;
+    BLOCK_END: string;
+};
+export declare function completionCommand(program: Command): void;
+export {};
+//# sourceMappingURL=completion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/commands/completion.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAmCxC,eAAO,MAAM,gBAAgB,kCAAmC,CAAA;AAChE,MAAM,MAAM,KAAK,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EA4B1C,CAAA;AAID;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAE/C,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,EAAE,CAG3F;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,EAAE,CAMxE;AAqBD,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAQrD;AA+HD,UAAU,WAAW;IACnB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAA;IAClB,oFAAoF;IACpF,MAAM,EAAM,MAAM,GAAG,IAAI,CAAA;IACzB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAA;CACnB;AAKD,+EAA+E;AAC/E,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAgBnE;AAED,oFAAoF;AACpF,wBAAgB,WAAW,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,KAAK,GAAG,IAAI,CAG9E;AA2BD,mFAAmF;AACnF,iBAAS,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAOnE;AAED,2EAA2E;AAC3E,iBAAS,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAOlD;AAMD,iBAAS,UAAU,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAmBpD;AAED,iBAAS,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAStD;AAID,iDAAiD;AACjD,eAAO,MAAM,SAAS;;;;;;;CAA0F,CAAA;AAEhH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwDxD"}

package/dist/commands/completion.js

@@ -0,0 +1,412 @@
+import { mkdirSync, readFileSync, writeFileSync, rmSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { CliError } from '../errors.js';
+// Shell tab-completion for the `rudder` CLI. `rudder completion <shell>` prints a
+// self-contained completion script to stdout; `rudder completion install` writes
+// it to a stable location and wires it into the user's shell; `uninstall` undoes
+// that cleanly.
+//
+// Command-name completion is STATIC: the script embeds the known framework
+// command names below, so completing a command is instant (no CLI boot per
+// <TAB>) and works even outside a project directory.
+//
+// Argument completion is DYNAMIC where it pays off: for the model-oriented make
+// commands, the script calls back into `rudder completion args <command>`, which
+// lists the project's models from app/Models (filesystem only, no app boot).
+//
+// Flag completion is also DYNAMIC: when the current word starts with '-', the
+// script calls `rudder completion flags <command>`, which reads the command's
+// live commander option definitions (so the flag list never drifts). Commands
+// that parse flags by hand (allowUnknownOption) expose only --help; the make:*
+// family registers real options, which is where flag completion matters most.
+// Both resolvers live in TS (testable) and are structured so more sources can be
+// added later. Unknown/top-level falls back to the global flags.
+//
+// No third-party dependency: hand-rolled scripts for bash / zsh / fish. tabtab
+// was considered but its model is dynamic (a CLI round-trip per keystroke), which
+// is the opposite of what static completion wants.
+const C = {
+    green: (s) => `\x1b[32m${s}\x1b[0m`,
+    yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+    dim: (s) => `\x1b[2m${s}\x1b[0m`,
+    bold: (s) => `\x1b[1m${s}\x1b[0m`,
+};
+export const SUPPORTED_SHELLS = ['bash', 'zsh', 'fish'];
+/**
+ * The static set of command names completed in v1. Built-in CLI commands plus
+ * the commands every framework package contributes. Keep roughly in sync with
+ * the ownership table in packages/cli/CLAUDE.md; drift here only costs a missing
+ * suggestion, never a broken command. Every name has at most one ':' — the bash
+ * script's colon handling relies on that.
+ */
+export const COMMAND_NAMES = [
+    // CLI built-ins
+    'about', 'add', 'completion', 'doctor', 'down', 'fresh', 'optimize:clear',
+    'remove', 'test', 'tinker', 'up', 'upgrade', 'key:generate',
+    'command:list', 'module:make', 'module:publish', 'vendor:publish',
+    'providers:discover',
+    // make:* generators (CLI + packages)
+    'make:agent', 'make:cast', 'make:command', 'make:controller', 'make:event',
+    'make:exception', 'make:factory', 'make:job', 'make:listener', 'make:mail',
+    'make:mcp-prompt', 'make:mcp-resource', 'make:mcp-server', 'make:mcp-tool',
+    'make:middleware', 'make:migration', 'make:model', 'make:notification',
+    'make:observer', 'make:passport-client', 'make:policy', 'make:provider',
+    'make:request', 'make:resource', 'make:seeder', 'make:terminal', 'make:test',
+    // @rudderjs/orm
+    'migrate', 'migrate:fresh', 'migrate:refresh', 'migrate:rollback',
+    'migrate:status', 'schema:types', 'db:generate', 'db:push', 'db:seed',
+    'db:show', 'db:table', 'db:query', 'model:prune',
+    // @rudderjs/router + openapi + core
+    'route:list', 'openapi:generate', 'event:list', 'config:show',
+    // @rudderjs/queue + cache + schedule
+    'queue:work', 'queue:status', 'queue:clear', 'queue:failed', 'queue:retry',
+    'cache:clear', 'schedule:run', 'schedule:work', 'schedule:list',
+    // @rudderjs/storage + sync + broadcast + boost + passport + ai + mcp
+    'storage:link', 'sync:docs', 'sync:clear', 'sync:inspect',
+    'broadcast:connections', 'boost:install', 'boost:update', 'boost:mcp',
+    'passport:keys', 'passport:client', 'ai:eval', 'mcp:start', 'mcp:list',
+    // @rudderjs/vite sync commands
+    'view:sync', 'routes:sync', 'env:sync', 'config:sync',
+];
+// ─── Dynamic argument resolution ─────────────────────────────
+/**
+ * Commands whose first argument is conventionally an existing model name. When
+ * completing their argument, the shell calls back into `rudder completion args`
+ * to list the project's models. Routes/migrations have no arg-taking command to
+ * complete against yet, so models are the whole v1 surface.
+ */
+export const MODEL_ARG_COMMANDS = [
+    'make:factory', 'make:seeder', 'make:policy', 'make:observer',
+];
+/**
+ * Resolve dynamic argument candidates for `command`, rooted at `cwd`. v1 returns
+ * model names (the `app/Models` basenames) for the model-oriented make commands.
+ * Filesystem-only, no app boot. Returns [] when there is nothing to suggest
+ * (unknown command, not inside a project, empty dir).
+ */
+export function resolveArgCandidates(command, cwd = process.cwd()) {
+    if (MODEL_ARG_COMMANDS.includes(command))
+        return listModels(cwd);
+    return [];
+}
+/**
+ * Resolve flag candidates from a command's live commander definition: its long
+ * options plus `--help` (every command has it). For an unknown command (or the
+ * top-level `rudder`) we return the global flags. Reading the real definitions
+ * means the list never drifts from the actual options.
+ */
+export function resolveFlagCandidates(cmd) {
+    if (!cmd)
+        return ['--help', '--version'];
+    const longs = cmd.options
+        .map(o => o.long)
+        .filter((l) => Boolean(l));
+    return [...new Set([...longs, '--help'])].sort();
+}
+/** List model names from `app/Models` by filename, mirroring tinker's discovery. */
+function listModels(cwd) {
+    const dir = path.join(cwd, 'app', 'Models');
+    let entries;
+    try {
+        entries = readdirSync(dir);
+    }
+    catch {
+        return []; // not a rudder project, or no models yet
+    }
+    const exts = new Set(['.ts', '.js', '.mts', '.mjs']);
+    const names = entries
+        .filter(f => exts.has(path.extname(f)))
+        .map(f => path.basename(f, path.extname(f)))
+        .filter(n => n !== 'index');
+    return [...new Set(names)].sort();
+}
+// ─── Script generation ───────────────────────────────────────
+/** Emit a self-contained completion script for the given shell. */
+export function completionScript(shell) {
+    const words = [...COMMAND_NAMES].sort().join(' ');
+    const argCmds = [...MODEL_ARG_COMMANDS].join(' ');
+    switch (shell) {
+        case 'bash': return bashScript(words, argCmds);
+        case 'zsh': return zshScript(words, argCmds);
+        case 'fish': return fishScript(words, argCmds);
+    }
+}
+function bashScript(words, argCmds) {
+    // Commands contain a ':' which is in bash's default COMP_WORDBREAKS, so the
+    // word under the cursor is split. We reconstruct the colon-joined word and
+    // strip the already-typed "ns:" prefix from each match so bash appends only
+    // the suffix. Self-contained — no dependency on the bash-completion package.
+    return `# rudder bash completion. Source this file or use \`rudder completion install\`.
+_rudder_complete() {
+  local cur cword cmd k
+  cword="\${COMP_CWORD}"
+  cur="\${COMP_WORDS[cword]}"
+
+  # Flag completion: the word starts with '-'. Extract the command as the
+  # colon-joined word beginning at index 1 (robust to intervening arguments), then list
+  # its flags. Unknown/top-level falls back to the global flags.
+  if [[ "\${cur}" == -* ]]; then
+    local fcmd="\${COMP_WORDS[1]}" j=2
+    while [ "\${COMP_WORDS[j]}" = ":" ] && [ -n "\${COMP_WORDS[j+1]}" ]; do
+      fcmd="\${fcmd}:\${COMP_WORDS[j+1]}"; j=$((j+2))
+    done
+    local fl="--help --version"
+    if [[ " ${words} " == *" \${fcmd} "* ]]; then
+      fl=$(rudder completion flags "\${fcmd}" 2>/dev/null)
+    fi
+    COMPREPLY=( $(compgen -W "\${fl}" -- "\${cur}") )
+    return 0
+  fi
+
+  # Reconstruct the command from the words between "rudder" and the current one.
+  # Colon-split elements ("make" ":" "factory") concatenate back to "make:factory".
+  # This equals a complete command name only once the command is fully typed and
+  # the cursor sits on its argument (a partial like "make:" never matches).
+  cmd=""
+  for ((k=1; k<cword; k++)); do cmd="\${cmd}\${COMP_WORDS[k]}"; done
+  if [[ " ${words} " == *" \${cmd} "* ]]; then
+    # The cursor is on the command's argument, not the command itself. Only the
+    # model-arg commands have dynamic candidates; others complete to nothing.
+    local cand=""
+    if [[ " ${argCmds} " == *" \${cmd} "* ]]; then
+      cand=$(rudder completion args "\${cmd}" 2>/dev/null)
+    fi
+    COMPREPLY=( $(compgen -W "\${cand}" -- "\${cur}") )
+    return 0
+  fi
+
+  # Glue a single-colon-split word back together under bash's default
+  # COMP_WORDBREAKS (which contains ':'). Two shapes occur:
+  #   "make" ":"        (cursor right after the colon)  -> cur = "make:"
+  #   "make" ":" "mo"   (a suffix typed)                -> cur = "make:mo"
+  if [ "\${cur}" = ":" ] && [ "\${cword}" -ge 1 ]; then
+    cur="\${COMP_WORDS[cword-1]}:"
+  elif [ "\${cword}" -ge 2 ] && [ "\${COMP_WORDS[cword-1]}" = ":" ]; then
+    cur="\${COMP_WORDS[cword-2]}:\${cur}"
+  fi
+  local matches
+  matches=$(compgen -W "${words}" -- "\${cur}")
+  COMPREPLY=()
+  if [[ "\${cur}" == *:* ]]; then
+    local prefix="\${cur%:*}:" m
+    for m in \${matches}; do COMPREPLY+=( "\${m#\${prefix}}" ); done
+  else
+    local m
+    for m in \${matches}; do COMPREPLY+=( "\${m}" ); done
+  fi
+}
+complete -F _rudder_complete rudder
+`;
+}
+function zshScript(words, argCmds) {
+    // zsh treats ':' as an ordinary word character, so no colon gymnastics needed.
+    // Sourcing this file (rather than autoloading via fpath) means the #compdef tag
+    // is inert, so we register explicitly via compdef once compinit has defined it.
+    return `#compdef rudder
+# rudder zsh completion. Source this file or use \`rudder completion install\`.
+_rudder() {
+  # Flag completion: the word being completed starts with '-'. zsh arrays are
+  # 1-indexed, so $words[2] is the command token after 'rudder' (zsh does not
+  # split on ':'); unknown/top-level uses the global flags.
+  if [[ "\${words[CURRENT]}" == -* ]]; then
+    local cmd="\${words[2]}"
+    local -a fl
+    if [[ " ${words} " == *" \${cmd} "* ]]; then
+      fl=(\${(f)"$(rudder completion flags \${cmd} 2>/dev/null)"})
+    else
+      fl=(--help --version)
+    fi
+    compadd -a fl
+    return
+  fi
+  # Past the command word: complete its argument dynamically for the model-arg
+  # commands ($words[2] is the command).
+  if (( CURRENT >= 3 )); then
+    local cmd="\${words[2]}"
+    if [[ " ${argCmds} " == *" \${cmd} "* ]]; then
+      local -a cand
+      cand=(\${(f)"$(rudder completion args \${cmd} 2>/dev/null)"})
+      compadd -a cand
+    fi
+    return
+  fi
+  local -a cmds
+  cmds=(${words})
+  compadd -a cmds
+}
+if (( $+functions[compdef] )); then
+  compdef _rudder rudder
+fi
+`;
+}
+function fishScript(words, argCmds) {
+    // fish autoloads files in its completions dir, so install drops this there and
+    // no rc edit is needed. __fish_use_subcommand limits the command list to the
+    // first position; the model-arg rule fires once such a subcommand is present.
+    return `# rudder fish completion. Autoloaded from the fish completions dir, or use \`rudder completion install\`.
+complete -c rudder -f -n '__fish_use_subcommand' -a '${words}'
+complete -c rudder -f -n '__fish_seen_subcommand_from ${argCmds}' -a '(rudder completion args (commandline -opc)[2] 2>/dev/null)'
+# Flag completion once a known subcommand is present; this condition matches the
+# full known-command list (${words}). fish offers these when the token starts with '-'.
+complete -c rudder -f -n '__fish_seen_subcommand_from ${words}' -a '(rudder completion flags (commandline -opc)[2] 2>/dev/null)'
+`;
+}
+const BLOCK_START = '# >>> rudder completions >>>';
+const BLOCK_END = '# <<< rudder completions <<<';
+/** Resolve the file locations for a shell, rooted at `home`. Pure — no I/O. */
+export function installPlan(shell, home) {
+    switch (shell) {
+        case 'bash': {
+            const scriptPath = path.join(home, '.rudder', 'completion.bash');
+            return { scriptPath, rcFile: path.join(home, '.bashrc'), sourceLine: `[ -f "${scriptPath}" ] && source "${scriptPath}"` };
+        }
+        case 'zsh': {
+            const scriptPath = path.join(home, '.rudder', 'completion.zsh');
+            return { scriptPath, rcFile: path.join(home, '.zshrc'), sourceLine: `[ -f "${scriptPath}" ] && source "${scriptPath}"` };
+        }
+        case 'fish': {
+            // fish autoloads any rudder.fish in its completions dir — no rc edit.
+            const scriptPath = path.join(home, '.config', 'fish', 'completions', 'rudder.fish');
+            return { scriptPath, rcFile: null, sourceLine: '' };
+        }
+    }
+}
+/** Detect the user's shell from $SHELL. Returns null if it isn't one we support. */
+export function detectShell(env = process.env) {
+    const sh = path.basename(env['SHELL'] ?? '');
+    return SUPPORTED_SHELLS.includes(sh) ? sh : null;
+}
+function ensureDir(file) {
+    mkdirSync(path.dirname(file), { recursive: true });
+}
+/** Read a file, treating a missing one as empty. Avoids a check-then-read race. */
+function readOrEmpty(file) {
+    try {
+        return readFileSync(file, 'utf8');
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return '';
+        throw err;
+    }
+}
+/** Remove a file if present, returning whether it existed. No check-then-use race. */
+function rmIfExists(file) {
+    try {
+        rmSync(file);
+        return true;
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return false;
+        throw err;
+    }
+}
+/** Idempotently add the source block to an rc file. Returns true if it changed. */
+function addSourceBlock(rcFile, sourceLine) {
+    const existing = readOrEmpty(rcFile);
+    if (existing.includes(BLOCK_START))
+        return false;
+    const block = `${BLOCK_START}\n${sourceLine}\n${BLOCK_END}\n`;
+    const sep = existing.length > 0 && !existing.endsWith('\n') ? '\n' : '';
+    writeFileSync(rcFile, existing + sep + block);
+    return true;
+}
+/** Remove the source block from an rc file. Returns true if it changed. */
+function removeSourceBlock(rcFile) {
+    const existing = readOrEmpty(rcFile);
+    if (!existing.includes(BLOCK_START))
+        return false;
+    // Strip the marked block (and a single trailing newline left behind).
+    const pattern = new RegExp(`\\n?${escapeRe(BLOCK_START)}[\\s\\S]*?${escapeRe(BLOCK_END)}\\n?`, 'g');
+    writeFileSync(rcFile, existing.replace(pattern, '\n').replace(/\n{3,}/g, '\n\n'));
+    return true;
+}
+function escapeRe(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function runInstall(shell, home) {
+    const plan = installPlan(shell, home);
+    ensureDir(plan.scriptPath);
+    writeFileSync(plan.scriptPath, completionScript(shell));
+    if (plan.rcFile) {
+        const changed = addSourceBlock(plan.rcFile, plan.sourceLine);
+        console.log(C.green('✓') + ` Installed ${shell} completions`);
+        console.log(`  script: ${C.dim(plan.scriptPath)}`);
+        console.log(changed
+            ? `  added a source line to ${C.dim(plan.rcFile)}`
+            : `  ${C.dim(plan.rcFile)} already sources it ${C.dim('(no change)')}`);
+        console.log(`\nOpen a new shell or run ${C.bold(`source ${plan.rcFile}`)} to start completing.`);
+    }
+    else {
+        // fish autoloads — nothing to source.
+        console.log(C.green('✓') + ` Installed fish completions`);
+        console.log(`  script: ${C.dim(plan.scriptPath)}`);
+        console.log(`\nOpen a new shell to start completing.`);
+    }
+}
+function runUninstall(shell, home) {
+    const plan = installPlan(shell, home);
+    // rmIfExists attempts the remove and reports existence from the result, so
+    // there is no check-then-remove race.
+    let removed = rmIfExists(plan.scriptPath);
+    if (plan.rcFile && removeSourceBlock(plan.rcFile))
+        removed = true;
+    console.log(removed
+        ? C.green('✓') + ` Removed ${shell} completions`
+        : C.yellow('•') + ` No ${shell} completions were installed`);
+}
+// ─── Command registration ────────────────────────────────────
+/** Test surface — not part of the public API. */
+export const _internal = { addSourceBlock, removeSourceBlock, runInstall, runUninstall, BLOCK_START, BLOCK_END };
+export function completionCommand(program) {
+    program
+        .command('completion')
+        .description('Shell tab-completion: print a script, or install/uninstall it')
+        .argument('[action]', 'bash | zsh | fish | install | uninstall')
+        .argument('[target]', 'internal: command name when action is "args"')
+        .action((action, target) => {
+        const home = os.homedir();
+        // Internal: the installed scripts call `rudder completion args <command>`
+        // to resolve dynamic argument candidates (e.g. model names). One per line.
+        if (action === 'args') {
+            if (target)
+                process.stdout.write(resolveArgCandidates(target).join('\n') + '\n');
+            return;
+        }
+        // Internal: `rudder completion flags <command>` lists a command's option
+        // flags, read from its live commander definition. One per line.
+        if (action === 'flags') {
+            const cmd = target ? program.commands.find(c => c.name() === target) : undefined;
+            process.stdout.write(resolveFlagCandidates(cmd).join('\n') + '\n');
+            return;
+        }
+        // No arg, or an explicit shell name → print the script to stdout.
+        if (action === undefined || SUPPORTED_SHELLS.includes(action)) {
+            const shell = (action ?? detectShell());
+            if (!shell) {
+                throw new CliError('Could not detect your shell. Pass one explicitly:\n' +
+                    '  rudder completion bash | zsh | fish');
+            }
+            process.stdout.write(completionScript(shell));
+            return;
+        }
+        if (action === 'install' || action === 'uninstall') {
+            const shell = detectShell();
+            if (!shell) {
+                throw new CliError(`Could not detect a supported shell from $SHELL.\n` +
+                    `Generate the script manually instead, e.g.:\n` +
+                    `  rudder completion zsh > ~/.zsh/completions/_rudder`);
+            }
+            if (action === 'install')
+                runInstall(shell, home);
+            else
+                runUninstall(shell, home);
+            return;
+        }
+        throw new CliError(`Unknown completion action "${action}".\n` +
+            `Usage: rudder completion [bash|zsh|fish|install|uninstall]`);
+    });
+}
+//# sourceMappingURL=completion.js.map

package/dist/commands/completion.js.map

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

package/dist/commands/upgrade.d.ts

@@ -58,6 +58,7 @@ type FetchManifestFn = (pkg: string, version: string) => Promise<NpmManifest | n
  * manifests.
  */
 export declare function collectPeerMismatches(rows: PlanRow[], consumer: Map<string, ConsumerPeer>, fetcher: FetchManifestFn): Promise<PeerMismatch[]>;
+type UpgradeMode = 'latest' | 'minor' | 'patch';
 interface DepEntry {
     name: string;
     range: string;
@@ -71,6 +72,53 @@ interface PlanRow {
     target: ParsedVersion;
     newRange: string;
 }
+type OverrideSource = 'pnpm-workspace.yaml' | 'pnpm.overrides' | 'resolutions';
+interface OverridePin {
+    name: string;
+    value: string;
+    source: OverrideSource;
+}
+interface OverridePlanRow {
+    name: string;
+    source: OverrideSource;
+    current: ParsedVersion;
+    target: ParsedVersion;
+    oldValue: string;
+    newValue: string;
+}
+/**
+ * Parse the `@rudderjs/*` entries out of a `pnpm-workspace.yaml`'s top-level
+ * `overrides:` block. Deliberately text-scoped (not a full YAML parse) so the
+ * companion {@link replaceYamlOverride} can rewrite in place and preserve
+ * comments / formatting. Only simple `name: version` pins are read — pnpm's
+ * selector keys (`a>b`, `foo@1>bar`) never match a bare `@rudderjs/<name>`.
+ */
+export declare function parseYamlOverrides(yaml: string): Array<[string, string]>;
+/**
+ * Rewrite one `@rudderjs/<name>` pin in a `pnpm-workspace.yaml` overrides block
+ * to `version`, preserving the original quoting, operator prefix, and any inline
+ * comment. Returns the new text and whether a line was replaced.
+ */
+export declare function replaceYamlOverride(yaml: string, name: string, version: string): {
+    text: string;
+    replaced: boolean;
+};
+/**
+ * Collect every `@rudderjs/*` override pin governing the run, from the root
+ * package.json (`pnpm.overrides`, `resolutions`) and `pnpm-workspace.yaml`.
+ */
+export declare function collectOverridePins(rootPkg: Record<string, unknown>, workspaceYaml: string | null): OverridePin[];
+type FetchLatestFn = (pkg: string) => Promise<string | null>;
+/**
+ * Build the override-bump plan: for each pinned `@rudderjs/*` package fetch the
+ * latest version, cap it by `mode`, and (when it's an upgrade) produce a row
+ * with the rewritten pin value (original operator prefix preserved). Latest is
+ * fetched once per distinct package name even when pinned in several sources.
+ */
+export declare function buildOverridePlan(pins: OverridePin[], mode: UpgradeMode, fetch: FetchLatestFn): Promise<{
+    rows: OverridePlanRow[];
+    skipped: string[];
+}>;
 type FetchChangelogFn = (pkg: string) => Promise<string | null>;
 /**
  * Walk the plan, fetch + parse each package's CHANGELOG in parallel, return a

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

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AA6BxC,UAAU,aAAa;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE;AAyGvE,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAC1C;AA8CD;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAG,MAAM,CAAA;IAChB,MAAM,EAAI,aAAa,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAyBD;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAI,MAAM,EACZ,IAAI,EAAE,aAAa,EACnB,EAAE,EAAI,aAAa,GAClB,cAAc,EAAE,CAuBlB;AA2BD,UAAU,YAAY;IACpB,KAAK,EAAI,MAAM,CAAA;IACf,OAAO,EAAE,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CAAA;CACjE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAUzF;AAED,UAAU,YAAY;IACpB,IAAI,EAAa,MAAM,CAAA;IACvB,QAAQ,EAAS,MAAM,CAAA;IACvB,aAAa,EAAI,MAAM,CAAA;IACvB,eAAe,EAAE,YAAY,CAAC,SAAS,CAAC,GAAG,IAAI,CAAA;IAC/C,aAAa,EAAI,MAAM,CAAA;IACvB,MAAM,EAAW,MAAM,CAAA;CACxB;AAED,KAAK,eAAe,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;AAEpF;;;;;;;;;GASG;AACH,wBAAsB,qBAAqB,CACzC,IAAI,EAAM,OAAO,EAAE,EACnB,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,EACnC,OAAO,EAAG,eAAe,GACxB,OAAO,CAAC,YAAY,EAAE,CAAC,CA+BzB;AAMD,UAAU,QAAQ;IAChB,IAAI,EAAK,MAAM,CAAA;IACf,KAAK,EAAI,MAAM,CAAA;IACf,OAAO,EAAE,cAAc,GAAG,iBAAiB,GAAG,kBAAkB,CAAA;CACjE;AAED,UAAU,OAAO;IACf,IAAI,EAAM,MAAM,CAAA;IAChB,OAAO,EAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;IAC7B,OAAO,EAAG,aAAa,CAAA;IACvB,MAAM,EAAI,aAAa,CAAA;IACvB,MAAM,EAAI,aAAa,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;CACjB;AAoED,KAAK,gBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;AAE/D;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAK,OAAO,EAAE,EAClB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC,CASxC;AAiCD,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAuLrD"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../../src/commands/upgrade.ts"],"names":[],"mappings":"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"}