Dashboard › cli › Distillation
80200174-6a3a-4ae5-872e-f54b42ecf83d["lore_tm_v1_d7kPMIcV6hE84OdkboBM2tkp_aZ_aMrqSH3xezOGC4A"]
packages/cli/src/lib/command.ts adds exported type CommandExample with readonly description: string (short explanation rendered before the command) and readonly command: string (complete command line including the sentry executable).packages/cli/src/lib/command.ts changes CommandDocumentation from a private alias of StricliBuilderArgs<CommandContext>["docs"] to an exported intersection type that additionally supports readonly examples?: readonly CommandExample[]; customUsage is documented as using its first line for the canonical signature suffix and later lines for equivalent forms.packages/cli/src/lib/command.ts adds prepareNativeDocs(docs: CommandDocumentation): StricliBuilderArgs<CommandContext>["docs"]. It removes the extended examples property before passing docs to Stricli; with no non-empty examples it returns the remaining native docs unchanged.prepareNativeDocs() renders each as exactly ${command} # ${description}, joins them with \n, and sets fullDescription to exactly ${nativeDocs.fullDescription ?? nativeDocs.brief}\n\nExamples:\n${renderedExamples}.packages/cli/src/lib/command.ts adds attachDocumentationMetadata(command: unknown, docs: CommandDocumentation): void. It stores the first docs.customUsage entry as non-standard __primaryUsage, using the string directly or primaryUsage.input, and stores non-empty docs.examples as non-standard __examples.buildCommand() in packages/cli/src/lib/command.ts now calls prepareNativeDocs(builderArgs.docs) before enrichDocsWithSchema(...), assigning the result to stricliDocs; this ordering keeps JSON fields at the end of native help after command-owned examples.buildCommand() now passes docs: stricliDocs to stricliCommand() and replaces its inline __primaryUsage attachment logic with attachDocumentationMetadata(cmd, builderArgs.docs), thereby preserving both canonical usage and examples from the original extended docs.packages/cli/src/lib/introspect.ts imports CommandExample from ./command.js and extends its Command type with optional __examples?: readonly CommandExample[], described as canonical documentation examples retained by buildCommand.getPositionalString() in packages/cli/src/lib/introspect.ts now renders optional tuple positional parameters as [<placeholder>]; required tuple positionals remain <placeholder>, and missing placeholders still fall back to arg${i}.packages/cli/src/lib/list-command.ts now imports CommandDocumentation from ./command.js; buildListCommand() changes its builderArgs.docs type from a local { readonly brief: string; readonly fullDescription?: string } shape to CommandDocumentation.packages/cli/src/lib/list-command.ts replaces the explicit OrgListCommandDocs object type with export type OrgListCommandDocs = CommandDocumentation, allowing organization-scoped list commands to use extended documentation metadata such as examples.packages/cli/src/lib/mutate-command.ts now imports CommandDocumentation from ./command.js; buildDeleteCommand() changes its builderArgs.docs type from a local { readonly brief: string; readonly fullDescription?: string } shape to CommandDocumentation.