Distillation

Date: Sep 10, 2026

• 🔴 (15:26) packages/cli/src/commands/help.ts defines unauthenticated helpCommand: sentry help/no args yields new CommandOutput(introspectAllCommands()); sentry help <command> uses introspectCommand(commandPath); invalid paths throw new OutputError(result).
• 🔴 (15:26) User stated --json mode in packages/cli/src/commands/help.ts always gets structured output.
• 🔴 (15:26) User stated sentry help --json never triggers the sixel probe or terminal I/O for a branded banner it would discard; banner rendering is confined to formatHelpHuman.
• 🔴 (15:26) packages/cli/src/commands/debug-files/find.ts defines local-only, unauthenticated sentry debug-files find <id>..., which searches debug-information files through findDebugFiles({ ids, types, paths }) without API calls and mirrors legacy sentry-cli difutil find by exiting non-zero when any requested ID is missing.
• 🔴 (15:26) debug-files find supports repeatable --type/-t, --no-well-known, --no-cwd, and repeatable --path/-p; default types are all values in FIND_DIF_TYPES, and each specified type is trimmed, lowercased, and validated or rejected with ValidationError.
• 🔴 (15:26) resolveSearchPaths() in packages/cli/src/commands/debug-files/find.ts builds an ordered search list: Xcode ~/Library/Developer/Xcode/DerivedData when dsym is requested and --no-well-known is absent, then the current directory unless --no-cwd, then user-supplied --path entries.
• 🔴 (15:26) With zero IDs, debug-files find yields { matches: [], missing: [] } and hint Provide one or more debug identifiers to search for.; when IDs are missing it sets this.process.exitCode = 1 and reports the exact missing count, otherwise it returns All requested debug files were located.
• 🔴 (15:26) packages/cli/src/commands/trace/logs.ts defines sentry trace logs [<org>/[<project>/]]<trace-id> with a required 32-character hexadecimal trace ID, optional organization/project resolution through parseTraceTarget() and resolveTraceOrg(), and project filtering through buildProjectQuery().
• 🔴 (15:26) trace logs defaults are period="14d", limit="100", and sort="newest"; limit validation is 1..LIST_MAX_LIMIT. Supported flags/aliases include --web/-w, --period/-t, --limit/-n, --query/-q, --sort/-s, and --fresh aliases from FRESH_ALIASES.
• 🔴 (15:26) trace logs --web opens buildTraceUrl(org, traceId) via openInBrowser() and returns without fetching logs; normal operation calls listTraceLogs(org, traceId, { ...timeRangeToApiParams(timeRange), limit, query, sort }) inside withProgress(), translating malformed user queries through toSearchQueryError(error, flags.query).
• 🔴 (15:26) trace logs marks hasMore when logs.length >= flags.limit; JSON output is { data: items, hasMore }, optionally applying filterFields() to each log; human output uses formatLogTable() and reports the count and trace ID, with Use --limit to show more. when applicable.
• 🔴 (15:26) Empty trace logs output says no logs were found for the trace in the selected period and suggests sentry trace logs --period 30d <traceId>; an explicit project produces a hint for viewing full trace logs, while no project produces a hint showing how to filter by project.
• 🔴 (15:27) packages/cli/src/commands/event/send.ts defines sentry event send, authenticated by DSN rather than Bearer token; DSN resolution order is --dsn first, then SENTRY_DSN, so sentry auth login is not required.
• 🔴 (15:27) event send accepts inline event construction or one or more positional JSON event files. When files are supplied, inline flags such as -m/--message are ignored and each file is independently converted and sent with sendEnvelopeRequest().
• 🔴 (15:27) Normal file mode reads bytes with readFileBytes(), parses a Sentry Event, wraps it using createEventEnvelope(event, dsnComponents), and serializes it with serializeEnvelope(); JSON parse and envelope-creation failures become ValidationError instances associated with "path".
• 🔴 (15:27) event send --raw <file> transmits file bytes unchanged and best-effort extracts event_id from the first line’s envelope-header JSON; extraction failures are only debug-logged. --raw without a file throws ValidationError("--raw requires a file argument (raw bytes cannot be built from inline flags)", "raw").
• 🔴 (15:27) event send validates DSNs using makeDsn() and throws ValidationError(\Invalid DSN: ${dsn}`, "dsn")when invalid. Inline mode requires at least one message or throwsConfigErrorwith usagesentry event send -m 'My message'`.
• 🔴 (15:27) event send flags include: --dsn; repeatable --message/-m; repeatable --message-arg/-a; --level/-l with values debug, info, warning, error, fatal and default error; --release/-r; --dist/-d; --env/-E; --platform/-p; repeatable --tag/-t, --extra/-e, --user/-u, and --fingerprint/-f; --timestamp; --no-environ; --logfile; --with-categories; and --raw.
• 🔴 (15:27) event send --timestamp accepts Unix epoch, ISO 8601, or RFC 2822; --logfile attaches the last 100 lines as breadcrumbs; --with-categories parses CATEGORY: message prefixes; --user accepts id, email, username, ip_address, or custom keys.
• 🔴 (15:27) Human event send output is Event from <file> dispatched: <eventId> for file sends and Event dispatched.\nEvent ID: <eventId> for inline sends.
• 🔴 (15:27) packages/cli/src/commands/docs/query.ts defines queryCommand, which requires a non-empty natural-language documentation question, detects safe local project context through detectDocsContext(this.cwd), calls queryDocs(query, detectedContext), and yields { ...result, detectedContext } with answer, sources, and detected context.
• 🔴 (15:27) docs query progress is interactive-only and JSON-aware, starts with Searching Sentry docs…, rotates every 4000 ms, and uses the ordered messages: 1. Finding the relevant bits…, 2. Cross-checking the details…, 3. It’s getting there…, 4. Collecting trusted sources….
• 🔴 (15:27) packages/cli/src/commands/docs/list.ts defines keyword-based documentation search without answer synthesis; it requires non-empty keywords, calls listDocs(query, flags.limit), and formats ranked TITLE, DESCRIPTION, and URL columns or No documentation pages match that search.
• 🔴 (15:27) docs list --limit/-n is validated from 1 through 20 and defaults to 8.
• 🔴 (15:27) packages/cli/src/commands/send-envelope.ts retains hidden backward-compatibility command sentry send-envelope, but the command has been removed and is replaced by sentry event send --raw <file>.
• 🔴 (15:27) Invoking sentry send-envelope always throws CliError with EXIT.GENERAL; its replacement message preserves supplied file arguments as Use: sentry event send --raw <files>, or uses the placeholder Use: sentry event send --raw <file> when none are supplied. The shim sets auth: false and skipRcUrlCheck: true.