/**
 * `packages/cli/src/commands.manifest.ts`
 *
 * Single source of truth for slowcook's user-facing command surface.
 * Drives BOTH `slowcook help` output AND the auto-generated command
 * catalog in `packages/cli/README.md`.
 *
 * Adding a command: append an entry below. Update both `slowcook help`
 * AND README sync at the same time via the CI gate in
 * `.github/workflows/readme-help-sync.yml`.
 *
 * Removing a command: don't. Mark `status: "deprecated"` + keep the
 * entry for one release with a deprecation warning, then remove.
 * Backward compat is a public commitment.
 */
export type CommandStatus = "stable" | "alpha" | "experimental" | "deprecated";
export type CommandGroup = "pipeline" | "plumbing" | "checks" | "knowledge" | "ops" | "experimental";
export interface CommandEntry {
    /** Top-level subcommand name (e.g. "refine", "brew", "stories"). */
    name: string;
    /** One-line usage signature shown in `slowcook help`. */
    usage: string;
    /** One-sentence description. Avoid version stamps + sc# refs (those rot). */
    description: string;
    /** Grouping for README catalog rendering. */
    group: CommandGroup;
    /** Stability marker. Defaults to "stable" if omitted. */
    status?: CommandStatus;
    /** Aliases honored by the cli's switch (e.g. "testgen" → "recipe"). */
    aliases?: string[];
    /** Hide from `slowcook help` + README (still callable). Used for `version`, `help`. */
    hidden?: boolean;
}
export declare const COMMANDS: ReadonlyArray<CommandEntry>;
export declare function findCommand(nameOrAlias: string): CommandEntry | undefined;
export declare function visibleCommands(): CommandEntry[];
//# sourceMappingURL=commands.manifest.d.ts.map