Distillation

🔴 (13:28) Added exported CommandExample metadata type with readonly description and readonly command; command is a complete command line including the sentry executable. 🔴 (13:28) CommandDocumentation now extends StricliBuilderArgs<CommandContext>["docs"] with optional readonly examples?: readonly CommandExample[] for canonical examples consumed by generated documentation. 🔴 (13:28) For customUsage, the first line is the canonical signature suffix and later lines may document equivalent forms. 🔴 (13:28) All command functions use SentryCommandFunction as async generators returning AsyncGenerator<unknown, CommandReturn | void, undefined>. 🔴 (13:28) Non-streaming commands yield one CommandOutput<T> and may return { hint } for a post-output footer. 🔴 (13:28) Streaming command yields are rendered immediately; commands supporting --json must yield one aggregate value when callers need one parseable JSON document because individual JSON chunks are pretty-printed rather than emitted as JSONL. 🔴 (13:28) Void commands may return without yielding for early exits such as --web. 🔴 (13:28) Command wrapper captures CommandReturn and renders it after consuming all yields. 🔴 (13:28) Hints belong exclusively on the command return value, never on individual yields. 🔴 (13:28) The relevant output flag is always injected when output: { human: ... } is configured, regardless of other conditions. 🔴 (13:28) ALWAYS_STRIP contains LOG_LEVEL_KEY; flags in ALWAYS_STRIP are always stripped, so command implementations never receive them. 🔴 (13:28) LIST_TARGET_POSITIONAL is the optional positional org/project parameter shared by all list commands; it accepts <org>/ for all projects, <org>/<project>, or bare <project> for search, and omission falls back to auto-detection. 🔴 (13:28) LIST_TARGET_POSITIONAL uses tuple parameter metadata with placeholder: "org/project", brief: "<org>/ (all projects), <org>/<project>, or <project> (search)", parse: String, and optional: true. 🔴 (13:28) Always inject --fresh using FRESH_FLAG unless the command already defines fresh in mergedFlags. 🔴 (13:28) In list commands, the first positional argument is always the target using the org/project pattern. 🔴 (13:28) The list-command wrapper intercepts the first positional target with interceptSubcommand() to handle plural alias confusion when args[0] is a string or undefined. 🔴 (13:28) All list commands use SentryContext, whose stderr is available at the top level and conforms to { write(s: string): void }.