Distillation

Date: Sep 9, 2026

• 🟡 (16:29) Working diff updates generated skill documentation in packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md so 23 command signatures accurately mark optional positionals: 1. sentry org view [<org>], 2. sentry project list [<org/project>], 3. sentry project view [<org/project>], 4. sentry issue list [<org/project>], 5. sentry alert issues list [<org/project>], 6. sentry alert issues create [<target>], 7. sentry alert metrics list [<target>], 8. sentry cli completion [<shell>], 9. sentry cli upgrade [<version>], 10. sentry agent-conversation list [<org>], 11. sentry agent-conversation view [<org>/]<conversation-id>, 12. sentry replay list [<org/project>], 13. sentry release list [<org/project>], 14. sentry release deploy <org/version> <environment> [<name>], 15. sentry repo list [<org/project>], 16. sentry team list [<org/project>], 17. sentry explore [<target>], 18. sentry feedback list [<org/project>], 19. sentry monitor list [<org/project>], 20. sentry trace list [<org/project>], 21. sentry trial list [<org>], 22. sentry trial start <name> [<org>], 23. sentry init [<target>] [<directory>].
• 🟡 (16:29) Corresponding command headings were updated in generated reference files: packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md, 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.
• 🟡 (16:29) packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md examples now document organization auto-detection with sentry agent-conversation view conv-123; explicit organization uses the single slash-form positional sentry agent-conversation view my-org/conv-123, including JSON usage sentry agent-conversation view my-org/conv-123 --json, replacing the former two-positional form my-org conv-123.
• 🟡 (16:30) Search for optional: true returned at least 100 matches and was truncated. Relevant command positional declarations include packages/cli/src/commands/trial/start.ts:106 (optional: true as const), trial/list.ts:224 (optional: true as const), project/view.ts:283, project/list.ts:727, replay/list.ts:284,299,306, trace/list.ts:229,244, org/view.ts:48, release/list.ts:683 (optional: true as const), and release/deploy.ts:119,128,134,140,147.
• 🟡 (16:30) Additional inspected optional declarations included packages/cli/src/commands/schema.ts:319, log/list.ts:750,756,763, trace/logs.ts:161, proguard/upload.ts:186,191,197, platform/list.ts:56, local/server.ts:824, local/run.ts:392, release/set-commits.ts:409,416,423, span/list.ts:594, monitor/run.ts:199,212,219,226,233,240,247, release/create.ts:93,104,110, issue/resolve.ts:127, release/finalize.ts:72,78, react-native/xcode.ts:441,446,452,458,465,470,476,481,486, sourcemap/upload.ts:245,252,258,266,272,278,284,290,296,304, react-native/gradle.ts:153,160,165,171, sourcemap/resolve.ts:141,147,153, snapshots/upload.ts:374,380,387,394,400,407,413,420,426,432,439,446,452,457, debug-files/upload.ts:581,588,594,600,606,612,618,625,631,637,643,649,656, issue/merge.ts:289, and snapshots/download.ts:173.
• 🟡 (16:30) Source inspection covered command implementations under packages/cli/src/commands/ for trial, trace, team, repo, replay, alert, cli, org, monitor, issue, project, release, and feedback, including each group’s index.ts and associated list/view/create/edit/delete or domain-specific command files.
• 🟡 (16:32) packages/cli/script/paths.ts centralizes paths for scripts whose CWD is packages/cli/: DOCS_ROOT = "../../apps/cli-docs", DOCS_SRC = \${DOCS_ROOT}/src`, DOCS_CONTENT = `${DOCS_SRC}/content/docs`, DOCS_FRAGMENTS = `${DOCS_SRC}/fragments`, and DOCS_PUBLIC = `${DOCS_ROOT}/public``.
• 🟡 (16:33) packages/cli/script/generate-skill.ts uses preferred route order ["help", "auth", "org", "project", "issue", "event", "api"]; routes absent from this list sort afterward alphabetically using order value 999.
• 🟡 (16:33) packages/cli/script/generate-skill.ts omits globally injected flags from compact command documentation via GLOBAL_FLAG_NAMES = new Set(["json", "fields", "help", "helpAll", "log-level"]); getVisibleFlags() excludes hidden flags and members of this set.
• 🟡 (16:33) packages/cli/script/generate-skill.ts documentation parsing strips YAML frontmatter and MDX/Astro imports, exports, and capitalized JSX components; extractSection() locates headings at levels 1–6 and reads until the next heading of equal or higher rank, while extractCodeBlocks() returns trimmed code and language values.
• 🟡 (16:33) packages/cli/script/generate-skill.ts loads command docs from ${DOCS_PATH}/commands/<commandGroup>.md, tokenizes them with marked.lexer(), collects level-3 headings matching command paths, and associates bash code blocks either with the current command heading or through matchExampleToCommand() using groupFallback = "sentry <commandGroup>" and an optional default command path.
• 🟡 (16:33) extractRoutes() in packages/cli/script/generate-skill.ts skips hidden routes, determines route-map default commands with findDefaultCommandName(), loads examples asynchronously, emits route-group commands through extractRouteGroupCommands(), and represents standalone commands as sentry <routeName> via buildCommandInfo().
• 🟡 (16:33) Skill prerequisites are generated from ${DOCS_PATH}/getting-started.mdx: installation comes from the Install Script section plus a PackageManagerCode command, and authentication comes from the Authentication section. If the file is unavailable, fallback content uses curl https://cli.sentry.dev/install -fsS | bash, npm install -g sentry, sentry auth, sentry auth --token YOUR_SENTRY_API_TOKEN, and sentry auth status.
• 🟡 (16:33) formatFlag() in packages/cli/script/generate-skill.ts renders aliases as -<alias>, --<name>, adds <value> for non-variadic parsed/enum flags, adds <value>... for variadic flags, includes brief text, and includes non-boolean defaults via JSON.stringify().