prodex 2.0.1 → 2.1.0

package/dist/cli/flag-specs.d.ts

@@ -1,12 +1,16 @@
 import type { ProdexFlags } from "../types";
-export type FlagName = keyof ProdexFlags | "help" | "version" | "profile" | "write" | "check";
+export type FlagName = keyof ProdexFlags | "help" | "version" | "write" | "check" | "profile" | "allProfiles" | "maxDepth";
 export type FlagSpec = {
     long: FlagName;
     short?: string;
-    type: "boolean" | "string" | "number" | "list";
+    type: "boolean" | "string" | "number" | "list" | "raw-list";
 };
-export declare const COMMANDS: readonly ["run", "init", "profiles", "migrate"];
+export declare const COMMANDS: readonly ["pack", "trace", "scope", "git", "grep", "init", "migrate", "run", "profiles"];
 export declare const FLAGS: FlagSpec[];
+export declare const GREP_FLAGS: FlagSpec[];
 export declare const FLAG_ALIASES: Record<string, FlagName>;
+export declare const GREP_FLAG_ALIASES: Record<string, FlagName>;
 export declare const FLAGS_BY_LONG: Map<FlagName, FlagSpec>;
 export declare const FLAGS_BY_SHORT: Map<string, FlagSpec>;
+export declare const GREP_FLAGS_BY_LONG: Map<FlagName, FlagSpec>;
+export declare const GREP_FLAGS_BY_SHORT: Map<string, FlagSpec>;

package/dist/cli/flag-specs.js

@@ -1,28 +1,78 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.FLAGS_BY_SHORT = exports.FLAGS_BY_LONG = exports.FLAG_ALIASES = exports.FLAGS = exports.COMMANDS = void 0;
-exports.COMMANDS = ["run", "init", "profiles", "migrate"];
+exports.GREP_FLAGS_BY_SHORT = exports.GREP_FLAGS_BY_LONG = exports.FLAGS_BY_SHORT = exports.FLAGS_BY_LONG = exports.GREP_FLAG_ALIASES = exports.FLAG_ALIASES = exports.GREP_FLAGS = exports.FLAGS = exports.COMMANDS = void 0;
+exports.COMMANDS = ["pack", "trace", "scope", "git", "grep", "init", "migrate", "run", "profiles"];
 exports.FLAGS = [
     { long: "entry", short: "e", type: "list" },
+    { long: "target", short: "t", type: "list" },
     { long: "include", short: "i", type: "list" },
     { long: "exclude", short: "x", type: "list" },
-    { long: "profile", short: "p", type: "list" },
-    { long: "allProfiles", short: "a", type: "boolean" },
     { long: "name", short: "n", type: "string" },
     { long: "format", short: "F", type: "string" },
-    { long: "maxDepth", type: "number" },
+    { long: "depth", short: "d", type: "number" },
     { long: "maxFiles", type: "number" },
-    { long: "debug", short: "d", type: "boolean" },
+    { long: "debug", type: "boolean" },
+    { long: "scope", short: "s", type: "list" },
+    { long: "key", short: "k", type: "list" },
+    { long: "all", short: "a", type: "boolean" },
+    { long: "list", type: "boolean" },
+    { long: "dryRun", type: "boolean" },
+    { long: "cmd", type: "raw-list" },
+    { long: "cmdTimeout", type: "number" },
+    { long: "failOnCmdError", type: "boolean" },
     { long: "write", type: "boolean" },
     { long: "check", type: "boolean" },
     { long: "help", short: "h", type: "boolean" },
     { long: "version", short: "v", type: "boolean" },
+    // Git specific flags
+    { long: "changed", type: "boolean" },
+    { long: "staged", type: "boolean" },
+    { long: "unstaged", type: "boolean" },
+    { long: "untracked", type: "boolean" },
+    { long: "includeDiff", type: "boolean" },
+    { long: "commit", type: "string" },
+    { long: "range", type: "string" },
+    { long: "against", type: "string" },
+    // Deprecated / legacy flags (parsed to return guided errors)
+    { long: "profile", short: "p", type: "list" },
+    { long: "allProfiles", type: "boolean" },
+    { long: "maxDepth", type: "number" },
+];
+exports.GREP_FLAGS = [
+    { long: "query", short: "q", type: "string" },
+    { long: "any", type: "list" },
+    { long: "grepAll", type: "list" },
+    { long: "regex", short: "r", type: "string" },
+    { long: "not", type: "list" },
+    { long: "within", type: "list" },
+    { long: "skip", type: "list" },
+    { long: "name", short: "n", type: "string" },
+    { long: "format", short: "F", type: "string" },
+    { long: "dryRun", type: "boolean" },
+    { long: "include", short: "i", type: "list" },
+    { long: "exclude", short: "x", type: "list" },
+    { long: "cmd", type: "raw-list" },
+    { long: "cmdTimeout", type: "number" },
+    { long: "failOnCmdError", type: "boolean" },
+    { long: "maxFiles", type: "number" },
+    { long: "help", short: "h", type: "boolean" },
+    { long: "version", short: "v", type: "boolean" },
+    { long: "debug", type: "boolean" },
 ];
 exports.FLAG_ALIASES = {
-    all: "allProfiles",
+    "max-files": "maxFiles",
+    "dry-run": "dryRun",
     "all-profiles": "allProfiles",
     "max-depth": "maxDepth",
-    "max-files": "maxFiles",
+    "cmd-timeout": "cmdTimeout",
+    "fail-on-cmd-error": "failOnCmdError",
+    "include-diff": "includeDiff",
+};
+exports.GREP_FLAG_ALIASES = {
+    ...exports.FLAG_ALIASES,
+    "all": "grepAll",
 };
 exports.FLAGS_BY_LONG = new Map(exports.FLAGS.map((flag) => [flag.long, flag]));
 exports.FLAGS_BY_SHORT = new Map(exports.FLAGS.filter((flag) => flag.short).map((flag) => [flag.short, flag]));
+exports.GREP_FLAGS_BY_LONG = new Map(exports.GREP_FLAGS.map((flag) => [flag.long, flag]));
+exports.GREP_FLAGS_BY_SHORT = new Map(exports.GREP_FLAGS.filter((flag) => flag.short).map((flag) => [flag.short, flag]));

package/dist/cli/help-specs.d.ts

@@ -0,0 +1,205 @@
+import type { FlagName } from "./flag-specs";
+export interface HelpFlagSpec {
+    long: FlagName;
+    description: string;
+    hint?: string;
+}
+export declare const PUBLIC_FLAGS: {
+    readonly entry: {
+        readonly long: "entry";
+        readonly description: "Entry file/glob. Repeatable and comma-aware.";
+        readonly hint: "<glob>";
+    };
+    readonly target: {
+        readonly long: "target";
+        readonly description: "Target file/module to resolve and trace from. Repeatable and comma-aware.";
+        readonly hint: "<target>";
+    };
+    readonly include: {
+        readonly long: "include";
+        readonly description: "Extra file/glob to append. Repeatable and comma-aware.";
+        readonly hint: "<glob>";
+    };
+    readonly exclude: {
+        readonly long: "exclude";
+        readonly description: "File/glob to skip. Repeatable and comma-aware.";
+        readonly hint: "<glob>";
+    };
+    readonly scope: {
+        readonly long: "scope";
+        readonly description: "Merge a configured scope's files.";
+        readonly hint: "<key>";
+    };
+    readonly name: {
+        readonly long: "name";
+        readonly description: "Output basename for this pack.";
+        readonly hint: "<name>";
+    };
+    readonly format: {
+        readonly long: "format";
+        readonly description: "Output format.";
+        readonly hint: "<md|txt>";
+    };
+    readonly depth: {
+        readonly long: "depth";
+        readonly description: "Maximum dependency traversal depth.";
+        readonly hint: "<number>";
+    };
+    readonly maxFiles: {
+        readonly long: "maxFiles";
+        readonly description: "Maximum traced file count.";
+        readonly hint: "<number>";
+    };
+    readonly dryRun: {
+        readonly long: "dryRun";
+        readonly description: "Perform a dry-run without writing output files.";
+        readonly hint: "";
+    };
+    readonly cmd: {
+        readonly long: "cmd";
+        readonly description: "Run command sequentially for evidence capture. Repeatable.";
+        readonly hint: "<command>";
+    };
+    readonly cmdTimeout: {
+        readonly long: "cmdTimeout";
+        readonly description: "Command execution timeout (default: 180).";
+        readonly hint: "<seconds>";
+    };
+    readonly failOnCmdError: {
+        readonly long: "failOnCmdError";
+        readonly description: "Enforce nonzero exit if commands fail.";
+        readonly hint: "";
+    };
+    readonly key: {
+        readonly long: "key";
+        readonly description: "Scope key to execute. Repeatable and comma-aware.";
+        readonly hint: "<key>";
+    };
+    readonly all: {
+        readonly long: "all";
+        readonly description: "Run all configured scopes.";
+        readonly hint: "";
+    };
+    readonly list: {
+        readonly long: "list";
+        readonly description: "List configured scope keys.";
+        readonly hint: "";
+    };
+    readonly write: {
+        readonly long: "write";
+        readonly description: "Back up and update prodex.json.";
+        readonly hint: "";
+    };
+    readonly check: {
+        readonly long: "check";
+        readonly description: "Exit nonzero if migration is required.";
+        readonly hint: "";
+    };
+    readonly help: {
+        readonly long: "help";
+        readonly description: "Show help.";
+        readonly hint: "";
+    };
+    readonly version: {
+        readonly long: "version";
+        readonly description: "Show version.";
+        readonly hint: "";
+    };
+    readonly changed: {
+        readonly long: "changed";
+        readonly description: "Include staged, unstaged, and untracked changes (default).";
+        readonly hint: "";
+    };
+    readonly staged: {
+        readonly long: "staged";
+        readonly description: "Include staged changes.";
+        readonly hint: "";
+    };
+    readonly unstaged: {
+        readonly long: "unstaged";
+        readonly description: "Include unstaged changes.";
+        readonly hint: "";
+    };
+    readonly untracked: {
+        readonly long: "untracked";
+        readonly description: "Include untracked files.";
+        readonly hint: "";
+    };
+    readonly includeDiff: {
+        readonly long: "includeDiff";
+        readonly description: "Include full git diff output in generic sections.";
+        readonly hint: "";
+    };
+    readonly commit: {
+        readonly long: "commit";
+        readonly description: "Snapshot files changed by a single commit.";
+        readonly hint: "<rev>";
+    };
+    readonly range: {
+        readonly long: "range";
+        readonly description: "Snapshot files changed between two commits (base..head or base...head).";
+        readonly hint: "<spec>";
+    };
+    readonly against: {
+        readonly long: "against";
+        readonly description: "Compare merge-base of <base> and HEAD against HEAD.";
+        readonly hint: "<base>";
+    };
+    readonly query: {
+        readonly long: "query";
+        readonly description: "fixed-string search";
+        readonly hint: "<text>";
+    };
+    readonly any: {
+        readonly long: "any";
+        readonly description: "OR fixed-string search";
+        readonly hint: "<list>";
+    };
+    readonly grepAll: {
+        readonly long: "grepAll";
+        readonly description: "AND fixed-string search";
+        readonly hint: "<list>";
+    };
+    readonly regex: {
+        readonly long: "regex";
+        readonly description: "regex search";
+        readonly hint: "<pattern>";
+    };
+    readonly not: {
+        readonly long: "not";
+        readonly description: "fixed-string negative file filter";
+        readonly hint: "<list>";
+    };
+    readonly within: {
+        readonly long: "within";
+        readonly description: "search only inside these paths/globs";
+        readonly hint: "<list>";
+    };
+    readonly skip: {
+        readonly long: "skip";
+        readonly description: "do not search inside these paths/globs";
+        readonly hint: "<list>";
+    };
+};
+export type PublicHelpFlagName = keyof typeof PUBLIC_FLAGS;
+export type CommandHelpTopic = "pack" | "trace" | "scope" | "git" | "grep" | "migrate";
+export declare const COMMAND_HELP_FLAGS: {
+    readonly pack: readonly ["entry", "include", "exclude", "scope", "name", "format", "depth", "dryRun", "cmd", "cmdTimeout", "failOnCmdError", "help"];
+    readonly trace: readonly ["target", "depth", "include", "exclude", "name", "format", "dryRun", "cmd", "cmdTimeout", "failOnCmdError", "help"];
+    readonly scope: readonly ["key", "all", "list", "exclude", "format", "dryRun", "cmd", "cmdTimeout", "failOnCmdError", "help"];
+    readonly git: readonly ["changed", "staged", "unstaged", "untracked", "commit", "range", "against", "includeDiff", "include", "exclude", "name", "format", "dryRun", "cmd", "cmdTimeout", "failOnCmdError", "help"];
+    readonly grep: readonly ["query", "any", "grepAll", "regex", "not", "within", "skip", "include", "exclude", "name", "format", "dryRun", "cmd", "cmdTimeout", "failOnCmdError", "help"];
+    readonly migrate: readonly ["write", "check"];
+};
+export declare const FLAG_DESCRIPTION_OVERRIDES: {
+    readonly trace: {
+        readonly name: "Output basename for this trace.";
+        readonly depth: "Dependency traversal depth. Defaults to configured depth.";
+    };
+    readonly git: {
+        readonly name: "Output basename for this run.";
+    };
+    readonly grep: {
+        readonly name: "Output basename for this run.";
+    };
+};

package/dist/cli/help-specs.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FLAG_DESCRIPTION_OVERRIDES = exports.COMMAND_HELP_FLAGS = exports.PUBLIC_FLAGS = void 0;
+exports.PUBLIC_FLAGS = {
+    entry: { long: "entry", description: "Entry file/glob. Repeatable and comma-aware.", hint: "<glob>" },
+    target: { long: "target", description: "Target file/module to resolve and trace from. Repeatable and comma-aware.", hint: "<target>" },
+    include: { long: "include", description: "Extra file/glob to append. Repeatable and comma-aware.", hint: "<glob>" },
+    exclude: { long: "exclude", description: "File/glob to skip. Repeatable and comma-aware.", hint: "<glob>" },
+    scope: { long: "scope", description: "Merge a configured scope's files.", hint: "<key>" },
+    name: { long: "name", description: "Output basename for this pack.", hint: "<name>" },
+    format: { long: "format", description: "Output format.", hint: "<md|txt>" },
+    depth: { long: "depth", description: "Maximum dependency traversal depth.", hint: "<number>" },
+    maxFiles: { long: "maxFiles", description: "Maximum traced file count.", hint: "<number>" },
+    dryRun: { long: "dryRun", description: "Perform a dry-run without writing output files.", hint: "" },
+    cmd: { long: "cmd", description: "Run command sequentially for evidence capture. Repeatable.", hint: "<command>" },
+    cmdTimeout: { long: "cmdTimeout", description: "Command execution timeout (default: 180).", hint: "<seconds>" },
+    failOnCmdError: { long: "failOnCmdError", description: "Enforce nonzero exit if commands fail.", hint: "" },
+    key: { long: "key", description: "Scope key to execute. Repeatable and comma-aware.", hint: "<key>" },
+    all: { long: "all", description: "Run all configured scopes.", hint: "" },
+    list: { long: "list", description: "List configured scope keys.", hint: "" },
+    write: { long: "write", description: "Back up and update prodex.json.", hint: "" },
+    check: { long: "check", description: "Exit nonzero if migration is required.", hint: "" },
+    help: { long: "help", description: "Show help.", hint: "" },
+    version: { long: "version", description: "Show version.", hint: "" },
+    // Git specific flags
+    changed: { long: "changed", description: "Include staged, unstaged, and untracked changes (default).", hint: "" },
+    staged: { long: "staged", description: "Include staged changes.", hint: "" },
+    unstaged: { long: "unstaged", description: "Include unstaged changes.", hint: "" },
+    untracked: { long: "untracked", description: "Include untracked files.", hint: "" },
+    includeDiff: { long: "includeDiff", description: "Include full git diff output in generic sections.", hint: "" },
+    commit: { long: "commit", description: "Snapshot files changed by a single commit.", hint: "<rev>" },
+    range: { long: "range", description: "Snapshot files changed between two commits (base..head or base...head).", hint: "<spec>" },
+    against: { long: "against", description: "Compare merge-base of <base> and HEAD against HEAD.", hint: "<base>" },
+    // Grep specific flags
+    query: { long: "query", description: "fixed-string search", hint: "<text>" },
+    any: { long: "any", description: "OR fixed-string search", hint: "<list>" },
+    grepAll: { long: "grepAll", description: "AND fixed-string search", hint: "<list>" },
+    regex: { long: "regex", description: "regex search", hint: "<pattern>" },
+    not: { long: "not", description: "fixed-string negative file filter", hint: "<list>" },
+    within: { long: "within", description: "search only inside these paths/globs", hint: "<list>" },
+    skip: { long: "skip", description: "do not search inside these paths/globs", hint: "<list>" },
+};
+exports.COMMAND_HELP_FLAGS = {
+    pack: [
+        "entry",
+        "include",
+        "exclude",
+        "scope",
+        "name",
+        "format",
+        "depth",
+        "dryRun",
+        "cmd",
+        "cmdTimeout",
+        "failOnCmdError",
+        "help",
+    ],
+    trace: [
+        "target",
+        "depth",
+        "include",
+        "exclude",
+        "name",
+        "format",
+        "dryRun",
+        "cmd",
+        "cmdTimeout",
+        "failOnCmdError",
+        "help",
+    ],
+    scope: [
+        "key",
+        "all",
+        "list",
+        "exclude",
+        "format",
+        "dryRun",
+        "cmd",
+        "cmdTimeout",
+        "failOnCmdError",
+        "help",
+    ],
+    git: [
+        "changed",
+        "staged",
+        "unstaged",
+        "untracked",
+        "commit",
+        "range",
+        "against",
+        "includeDiff",
+        "include",
+        "exclude",
+        "name",
+        "format",
+        "dryRun",
+        "cmd",
+        "cmdTimeout",
+        "failOnCmdError",
+        "help",
+    ],
+    grep: [
+        "query",
+        "any",
+        "grepAll",
+        "regex",
+        "not",
+        "within",
+        "skip",
+        "include",
+        "exclude",
+        "name",
+        "format",
+        "dryRun",
+        "cmd",
+        "cmdTimeout",
+        "failOnCmdError",
+        "help",
+    ],
+    migrate: [
+        "write",
+        "check",
+    ],
+};
+exports.FLAG_DESCRIPTION_OVERRIDES = {
+    trace: {
+        name: "Output basename for this trace.",
+        depth: "Dependency traversal depth. Defaults to configured depth.",
+    },
+    git: {
+        name: "Output basename for this run.",
+    },
+    grep: {
+        name: "Output basename for this run.",
+    },
+};

package/dist/cli/help.js

@@ -6,20 +6,31 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.renderHelp = renderHelp;
 exports.renderVersion = renderVersion;
 const package_json_1 = __importDefault(require("../../package.json"));
+const flag_specs_1 = require("./flag-specs");
+const help_specs_1 = require("./help-specs");
 function renderHelp(topic) {
-    if (topic === "run")
-        return renderRunHelp();
+    if (topic === "pack")
+        return renderPackHelp();
+    if (topic === "trace")
+        return renderTraceHelp();
+    if (topic === "scope")
+        return renderScopeHelp();
+    if (topic === "git")
+        return renderGitHelp();
+    if (topic === "grep")
+        return renderGrepHelp();
     if (topic === "init")
         return renderInitHelp();
-    if (topic === "profiles")
-        return renderProfilesHelp();
     if (topic === "migrate")
         return renderMigrateHelp();
     return [
         "Usage:",
-        "  prodex run [root] [options]",
+        "  prodex pack [root] [options]",
+        "  prodex trace [root] --target <target> [--depth <number>] [options]",
+        "  prodex scope [root] [options]",
+        "  prodex git [root] [options]",
+        "  prodex grep [root] --query \"text\" [options]",
         "  prodex init [root]",
-        "  prodex profiles [root]",
         "  prodex migrate [root] [--write|--check]",
         "",
         "Global options:",
@@ -32,39 +43,90 @@ function renderHelp(topic) {
 function renderVersion() {
     return `prodex v${package_json_1.default.version}`;
 }
-function renderRunHelp() {
+function getLongFlagCliName(longFlag, isGrep = false) {
+    if (isGrep && longFlag === "grepAll")
+        return "all";
+    for (const [kebab, camel] of Object.entries(flag_specs_1.FLAG_ALIASES)) {
+        if (camel === longFlag)
+            return kebab;
+    }
+    return longFlag.replace(/[A-Z]/g, (m) => `-${m.toLowerCase()}`);
+}
+function renderCommandHelpOptions(commandName) {
+    const allowed = help_specs_1.COMMAND_HELP_FLAGS[commandName];
+    if (!allowed)
+        return [];
+    const isGrep = commandName === "grep";
+    const specs = isGrep ? flag_specs_1.GREP_FLAGS : flag_specs_1.FLAGS;
+    return allowed.map((flagKey) => {
+        const doc = help_specs_1.PUBLIC_FLAGS[flagKey];
+        if (!doc) {
+            throw new Error(`Missing help documentation for flag "${flagKey}"`);
+        }
+        const spec = specs.find((s) => s.long === doc.long);
+        if (!spec) {
+            throw new Error(`Missing parsing spec for flag "${doc.long}"`);
+        }
+        const cliName = getLongFlagCliName(spec.long, isGrep);
+        let leftSide = "";
+        if (spec.short) {
+            leftSide = `  -${spec.short}, --${cliName}`;
+        }
+        else {
+            leftSide = `      --${cliName}`;
+        }
+        if (doc.hint) {
+            leftSide += ` ${doc.hint}`;
+        }
+        let description = doc.description;
+        if (doc.long === "help") {
+            description = `Show ${commandName} help.`;
+        }
+        else {
+            const commandOverrides = help_specs_1.FLAG_DESCRIPTION_OVERRIDES[commandName];
+            if (commandOverrides) {
+                const override = commandOverrides[doc.long];
+                if (override) {
+                    description = override;
+                }
+            }
+        }
+        return `${leftSide.padEnd(28)}${description}`;
+    });
+}
+function renderPackHelp() {
     return [
         "Usage:",
-        "  prodex run [root] [options]",
+        "  prodex pack [root] [options]",
         "",
         "Options:",
-        "  -e, --entry <glob>        Entry file/glob. Repeatable and comma-aware.",
-        "  -i, --include <glob>      Extra file/glob to append. Repeatable and comma-aware.",
-        "  -x, --exclude <glob>      File/glob to skip. Repeatable and comma-aware.",
-        "  -p, --profile <name>      Run a named profile. Repeatable.",
-        "  -a, --all                 Run every configured profile.",
-        "  --all-profiles            Alias for --all.",
-        "  -n, --name <name>         Output basename for this run.",
-        "  -F, --format <md|txt>     Output format.",
-        "  --max-depth <number>      Maximum dependency traversal depth.",
-        "  --max-files <number>      Maximum traced file count.",
-        "  -h, --help                Show run help.",
+        ...renderCommandHelpOptions("pack"),
     ].join("\n");
 }
-function renderInitHelp() {
+function renderTraceHelp() {
     return [
         "Usage:",
-        "  prodex init [root]",
+        "  prodex trace [root] --target <target> [--depth <number>] [options]",
         "",
-        "Create a prodex.json file in the target root.",
+        "Options:",
+        ...renderCommandHelpOptions("trace"),
     ].join("\n");
 }
-function renderProfilesHelp() {
+function renderScopeHelp() {
     return [
         "Usage:",
-        "  prodex profiles [root]",
+        "  prodex scope [root] [options]",
         "",
-        "List configured profile keys without running Prodex.",
+        "Options:",
+        ...renderCommandHelpOptions("scope"),
+    ].join("\n");
+}
+function renderInitHelp() {
+    return [
+        "Usage:",
+        "  prodex init [root]",
+        "",
+        "Create a prodex.json file in the target root.",
     ].join("\n");
 }
 function renderMigrateHelp() {
@@ -74,10 +136,27 @@ function renderMigrateHelp() {
         "  prodex migrate [root] --write",
         "  prodex migrate [root] --check",
         "",
-        "Preview, check, or write a prodex.json migration to config version 4.",
+        "Preview, check, or write a prodex.json migration to config version 5.",
+        "",
+        "Options:",
+        ...renderCommandHelpOptions("migrate"),
+    ].join("\n");
+}
+function renderGitHelp() {
+    return [
+        "Usage:",
+        "  prodex git [root] [options]",
+        "",
+        "Options:",
+        ...renderCommandHelpOptions("git"),
+    ].join("\n");
+}
+function renderGrepHelp() {
+    return [
+        "Usage:",
+        "  prodex grep [root] [options]",
         "",
         "Options:",
-        "  --write                  Back up and update prodex.json.",
-        "  --check                  Exit nonzero if migration is required.",
+        ...renderCommandHelpOptions("grep"),
     ].join("\n");
 }