/**
 * Per-command help text for `squad <cmd> --help` / `-h`.
 *
 * Fixes #1201: previously `--help` after a subcommand was silently dropped
 * by the CLI router and the command would execute for real, sometimes with
 * destructive side effects (`squad init --help` would scaffold files into
 * the cwd, `squad triage --help` / `watch --help` would start a polling
 * loop, etc.).
 *
 * The entry point in `cli-entry.ts` intercepts `--help`/`-h` whenever it
 * appears on a subcommand and calls `printCommandHelp(cmd, version)`. If
 * the command has a dedicated help block, it is printed and `true` is
 * returned. Otherwise `false` is returned so the caller can show a generic
 * fallback that points users at the top-level `squad help`.
 */
/**
 * Normalize a CLI command alias to its canonical name for help-registry
 * lookup. Returns the input unchanged when no alias mapping applies.
 *
 * Exported for testing. The runtime caller (`printCommandHelp`) applies
 * this automatically.
 */
export declare function normalizeCommandAlias(cmd: string): string;
/**
 * Print help for `cmd` if a dedicated help block exists.
 * Returns `true` when help was printed, `false` otherwise so the caller can
 * fall back to a generic "see `squad help`" message.
 *
 * Aliases (see `COMMAND_ALIASES`) are normalized to their canonical command
 * before the registry lookup, so `printCommandHelp('streams', v)` prints
 * the `subsquads` help block.
 */
export declare function printCommandHelp(cmd: string, version: string): boolean;
/**
 * Print a friendly generic fallback for commands that don't have a dedicated
 * help block yet. Always exits without side effects.
 */
export declare function printGenericCommandHelp(cmd: string): void;
/**
 * Test helper: list the commands that have dedicated help blocks. Used by
 * unit tests to guard against regression when new commands are added.
 */
export declare function commandsWithHelp(): readonly string[];
//# sourceMappingURL=command-help.d.ts.map