Dashboard › cli › Distillation
de8b8bef-3e2c-46f9-9273-93cd69208e0d["lore_tm_v1_7l7RFjDw88YPySR3xiodU5cHpdWwisT9I9z6wjD6MnY","lore_tm_v1_a5wx5jslEK-DepXJnYC3Ubcb2OPr1m4cqkyAvRQHStw","lore_tm_v1_PjW9HlU0xlkNsX6wt7UAWZ1OR86jIaCdazGIpAE1Bh4","lore_tm_v1_wWKmsTHX2kxeaTdaCVYChOQgU9QRMGIat6cuQ10SLBs","lore_tm_v1_Ev46ZtUbojzLRUtxAN-Ez3U27UyhZTnoNazS7Nux1ZI","lore_tm_v1_LTIl4Zc4xMSR98z6he5QSuhy21TI5bj050sBGXEHDhs","lore_tm_v1_hlWfwY6zLRsML8xMI8QYoKw98fzCx4rBllac1kLy9SQ","lore_tm_v1_cN8FUwbf0V4BrKOxPtC0fZXWYFoHTKmodKJiQPydEdA","lore_tm_v1_DYQtI7kLpEbN62b1m-67As_FVTj95F2mTSvpEewE0IY"]
/home/byk/Code/getsentry/cli-pr-1558; its 18 entries are .craft.yml, .git, .github/, .gitignore, .lore.md, .nojekyll, .npmrc, AGENTS.md, apps/, CHANGELOG.md, codemods/, LICENSE.md, node_modules/, package.json, packages/, pnpm-lock.yaml, pnpm-workspace.yaml, and README.md.fix/agent-conversation-reference-root-cause...origin/pr-1558, with the upstream marked [gone]; reported commit/hash was bbaa7b3b722b87f1bccfe84063269cbbcabe2741.apps/cli-docs/src/fragments/commands/agent-conversation.md; packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md; skill references alert.md, cli.md, explore.md, feedback.md, init.md, issue.md, monitor.md, org.md, project.md, release.md, replay.md, repo.md, team.md, trace.md, and trial.md; scripts packages/cli/script/check-fragments.ts, generate-command-docs.ts, generate-skill-markdown.ts, and generate-skill.ts; commands packages/cli/src/commands/agent-conversation/list.ts and view.ts; libraries packages/cli/src/lib/command.ts, introspect.ts, list-command.ts, and mutate-command.ts; tests packages/cli/test/commands/agent-conversation/list.test.ts, packages/cli/test/lib/command.test.ts, introspect.property.test.ts, introspect.test.ts, and packages/cli/test/script/generate-skill-markdown.test.ts./home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/help.test.ts, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help.test.ts, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help-positional.test.ts, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help-json.test.ts, and /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/bench/helpers.test.ts.packages/cli/test/lib/utils.test.ts:14; arg-parsing.test.ts:57,325-326; errors.test.ts:283; issue-id.test.ts:58-59; dsn.test.ts:38; introspect.test.ts:212,234,239,263-264,274,280; command.test.ts:204,209,222; and help.test.ts:5.packages/cli/src/lib/command.ts adds exported CommandExample with readonly description: string and readonly command: string; the command is documented as a complete command line including the sentry executable.CommandDocumentation in packages/cli/src/lib/command.ts changes from a private alias of Stricli docs to an exported intersection type that additionally supports readonly examples?: readonly CommandExample[].prepareNativeDocs() in packages/cli/src/lib/command.ts strips the extended examples property before passing docs to Stricli. If examples exist, it appends to fullDescription using ${nativeDocs.fullDescription ?? nativeDocs.brief}\n\nExamples:\n${renderedExamples}, where each example is rendered as ${command} # ${description}.attachDocumentationMetadata() in packages/cli/src/lib/command.ts stores the first docs.customUsage entry as non-standard __primaryUsage, using the string directly or .input, and stores nonempty docs.examples as non-standard __examples.buildCommand() now calls prepareNativeDocs(builderArgs.docs) before enrichDocsWithSchema(...), explicitly keeping schema-derived JSON fields at the end of native help; the resulting stricliDocs are passed to stricliCommand().buildCommand() now calls attachDocumentationMetadata(cmd, builderArgs.docs) after command construction, replacing the previous inline logic that attached only __primaryUsage from enriched docs.packages/cli/src/lib/introspect.ts imports CommandExample; its Command type gains optional __examples?: readonly CommandExample[].getPositionalString() in packages/cli/src/lib/introspect.ts now renders optional tuple parameters as [<placeholder>]; required tuple parameters remain <placeholder>, and absent placeholders continue to fall back to arg${i}.buildCommandInfo() in packages/cli/src/lib/introspect.ts now prefers nonempty structured cmd.__examples over legacy/document-derived examples. Each structured example becomes # ${description}\n${command}; legacy examples remain the fallback.packages/cli/src/lib/list-command.ts now imports CommandDocumentation; buildListCommand()’s builderArgs.docs and exported OrgListCommandDocs use that shared type, replacing local { brief; fullDescription? } shapes and thereby allowing structured examples and the rest of native Stricli documentation metadata.packages/cli/src/lib/mutate-command.ts now imports CommandDocumentation; buildDeleteCommand()’s builderArgs.docs uses it instead of the local { brief; fullDescription? } shape.packages/cli/script/check-fragments.ts now skips missing-fragment checks for any command whose cmd.examples.length > 0; commands without metadata examples continue through default-command and leaf-fragment checking.packages/cli/script/generate-command-docs.ts now define CLI metadata or the environment registry as the source for auto-generated reference and examples, while committed fragments are for guides, tips, and content that cannot live in command definitions.formatPositionalsTable() in packages/cli/script/generate-command-docs.ts now renders optional positional arguments as `[<placeholder>]` and required arguments as `<placeholder>` before escaping their descriptions.generateCommandSection() in packages/cli/script/generate-command-docs.ts now calls formatCommandExamples(cmd.examples) and appends the returned section when nonempty, after the arguments and visible-options tables.packages/cli/script/generate-skill-markdown.ts adds exported formatCommandExamples(examples: readonly string[]): string. It returns "" for zero examples; otherwise it returns a Markdown section consisting of **Examples:**, a blank line, a fenced bash block, and examples joined by two newlines.packages/cli/script/generate-skill.ts now imports and calls shared formatCommandExamples(cmd.examples) in generateFullCommandDoc(), replacing its local manual construction of the examples heading and fenced bash block.packages/cli/script/generate-command-docs.ts:190-217 confirms generated command-section order is: heading from cmd.path plus optional cmd.positional, cmd.brief, optional arguments table, optional visible-flags table, then optional formatted examples.