Distillation

Date: September 8, 2026

• 🔴 (22:32) User stated that command hints belong exclusively on the CommandReturn return value, never on individual yields.
• 🔴 (22:32) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:76-95 defines BaseFlags = Readonly<Partial<Record<string, unknown>>>, BaseArgs = readonly unknown[], and StricliBuilderArgs<CONTEXT extends CommandContext> = import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>; the type erases Stricli generic constraints after hidden flags and the command function are modified, casting through unknown rather than as any.
• 🔴 (22:32) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:97-114 defines exported CommandExample with readonly description: string and command: string, and exported CommandDocumentation as native Stricli docs extended with optional readonly examples?: readonly CommandExample[]; when customUsage exists, its first line is the canonical signature suffix and later lines may describe equivalent forms.
• 🔴 (22:32) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:116-142 defines SentryCommandFunction<FLAGS, ARGS, CONTEXT> as an async generator returning AsyncGenerator<unknown, CommandReturn | void, undefined>. Non-streaming commands yield one CommandOutput<T> and may return { hint }; streaming yields are rendered immediately, but --json commands must yield one aggregate value when callers need a single parseable JSON document because individual JSON chunks are pretty-printed rather than JSONL; void commands may return without yielding for early exits such as --web.