Distillation

Date: Sep 9, 2026

• 🔴 (14:16) In packages/cli/src/lib/command.ts, user added exported CommandExample metadata with readonly description and complete command fields; the command string includes the sentry executable.
• 🔴 (14:16) In packages/cli/src/lib/command.ts, user changed CommandDocumentation from a private native Stricli docs alias to an exported intersection type supporting optional readonly examples?: readonly CommandExample[].
• 🔴 (14:16) User stated command-generator hints live exclusively on the CommandReturn return value, never on individual yields.
• 🔴 (14:16) User stated --fields is always injected when output: { human: ... }, even when a command defines its own json flag; a command-owned json flag is retained rather than replaced.
• 🔴 (14:16) User stated globally injected flags tracked by stripKeys are always stripped so the command function never sees them; ALWAYS_STRIP specifically contains LOG_LEVEL_KEY.
• 🔴 (14:16) In packages/cli/src/lib/command.ts, user added prepareNativeDocs(), which removes extended examples metadata before passing docs to Stricli and appends examples to fullDescription under Examples: using the format ${command} # ${description}.
• 🔴 (14:16) In packages/cli/src/lib/command.ts, prepareNativeDocs() leaves native docs unchanged when no examples exist and uses nativeDocs.fullDescription ?? nativeDocs.brief as the base when rendering examples.
• 🔴 (14:16) In packages/cli/src/lib/command.ts, user added attachDocumentationMetadata(command, docs), which preserves the first customUsage entry as __primaryUsage and preserves non-empty canonical examples as __examples on the built command.
• 🔴 (14:16) attachDocumentationMetadata() normalizes the primary usage from either a string or primaryUsage.input.
• 🔴 (14:16) User changed command-doc preparation order in buildCommand(): command-owned examples are rendered by prepareNativeDocs(builderArgs.docs) before enrichDocsWithSchema(), ensuring JSON field documentation retains its established position at the end of native help.
• 🔴 (14:16) User changed the stricliCommand() call in packages/cli/src/lib/command.ts to receive docs: stricliDocs, replacing the former enrichedDocs.
• 🔴 (14:16) User replaced inline post-build __primaryUsage attachment logic with attachDocumentationMetadata(cmd, builderArgs.docs), preserving both primary usage and examples from the original extended documentation rather than schema-enriched native docs.