Dashboard › cli › Session 1DKpanpHw0Um
1DKpanpHw0Umc7Ct4Perform an independent, read-only adversarial correctness review of the exact current working-tree patch in /home/byk/Code/getsentry/cli-pr-1558 for getsentry/cli PR #1558. Do not modify files, VCS state, branches, commits, or PR metadata. The committed HEAD is bbaa7b3b722b87f1bccfe84063269cbbcabe2741; the uncommitted patch SHA-256 was last verified as dfcceb584e52de2d477015a74dfe42ac1e26e5f44ede4bf5da2afc9e343179d8. Review every changed file and relevant surrounding implementation/tests. Focus on behavioral correctness and regressions in: Stricli documentation metadata preservation; native help; JSON help compatibility; tuple positional optionality; customUsage behavior; website and skill generation; legacy fragment fallback and fragment validation; wrapper typing; generated artifacts; agent-conversation list/view runtime usage and parsing. Verify claims with read-only commands as needed, including git diff --check and targeted tests if useful. Report findings first, ordered by severity, with exact file:line evidence and concrete fixes. Classify every point as PASS, CONCERN, MUST-FIX, or BLOCKED. If there are no defects, state PASS explicitly and summarize residual risks/testing gaps. Include the exact HEAD and recomputed patch SHA-256 reviewed. End exactly MERGE or DO-NOT-MERGE. Return a substantive report; never return empty.
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/AGENTS.md /home/byk/Code/getsentry/cli-pr-1558/AGENTS.md
No files found
/home/byk/Code/getsentry/cli-pr-1558/package.json /home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/package.json /home/byk/Code/getsentry/cli-pr-1558/codemods/sentry-v3-to-v4/package.json /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/init-eval/templates/sveltekit-app/package.json /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/init-eval/templates/react-vite-app/package.json /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/init-eval/templates/express-app/package.json /home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/init-eval/templates/nextjs-app/package.json /home/byk/Code/getsentry/cli-pr-1558/packages/cli/package.json
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/CONTRIBUTING.md
No files found
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/AGENTS.md</path> <type>file</type> <content> 1: # Jared (Outpost agent) 2: 3: Autonomous GitHub coding agent. Work in `/workspace/repo`. 4: 5: ## Model tiers 6: 7: The primary model is chosen per event (see `src/agents/models.ts`): heavy for 8: code-producing situations, cheaper for lightweight ones. 9: 10: | Role | Subagent | Model | 11: | --- | --- | --- | 12: | Triage / plan / review (heavy) | (primary Jared) | Claude Opus 4.8 | 13: | Triage / plan / review (light) | (primary Jared) | xAI Grok 4.3 | 14: | Explore | `explore` | OpenAI gpt-5-mini | 15: | Implement | `implement` | Moonshot kimi-k2.7-code | 16: | Ship (commit/push/PR) | `ship` | xAI Grok (`grok-build-0.1`) | 17: 18: Pipeline: triage → explore → plan → implement → review → ship. 19: (`worker` is a deprecated alias of `implement`.) 20: 21: Operators also talk to Jared directly from the Outpost dashboard. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/AGENTS.md</path> <type>file</type> <content> 1: # AGENTS.md 2: 3: Guidelines for AI agents working in this codebase. 4: 5: ## Project Overview 6: 7: **Sentry CLI** is a command-line interface for [Sentry](https://sentry.io), built with Node.js, [pnpm](https://pnpm.io), and [Stricli](https://bloomberg.github.io/stricli/). It lives in `packages/cli` of a pnpm workspace; the docs site lives in `apps/cli-docs`. 8: 9: ### Goals 10: 11: - **Zero-config experience** - Auto-detect project context from DSNs in source code and env files 12: - **AI-powered debugging** - Integrate Seer AI for root cause analysis and fix plans 13: - **Developer-friendly** - Follow `gh` CLI conventions for intuitive UX 14: - **Agent-friendly** - JSON output and predictable behavior for AI coding agents 15: - **Fast** - Native binaries via Node SEA (fossilize), SQLite caching for API responses 16: 17: ### Key Features 18: 19: - **DSN Auto-Detection** - ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/CONTRIBUTING.md</path> <type>file</type> <content> 1: # Contributing to Sentry CLI 2: 3: This guide documents the patterns and conventions used in this CLI for consistency. 4: 5: ## Command Patterns 6: 7: We follow [gh CLI](https://cli.github.com/) conventions for best-in-class developer experience. 8: 9: ### List Commands 10: 11: List commands use **optional positional arguments** for context with smart auto-detection. 12: 13: ```bash 14: sentry org list [--limit N] [--json] 15: sentry project list [org] [--limit N] [--json] 16: sentry issue list [<org>/<project>] [--json] 17: ``` 18: 19: **Target syntax**: 20: - `<org>/<project>` - Explicit organization and project (e.g., `my-org/frontend`) 21: - `<org>/` - All projects in the specified organization 22: - `<project>` - Search for project by name across all accessible organizations 23: - *(omit)* - Auto-detect from DSN or config 24: 25: **Rationale**: Positional ...
File not found: /home/byk/Code/getsentry/cli-pr-1558/.cursor/rules/ultracite.mdc
<path>/home/byk/Code/getsentry/cli-pr-1558/package.json</path>
<type>file</type>
<content>
1: {
2: "name": "toolkit-cli-workspace",
3: "version": "0.0.0",
4: "private": true,
5: "type": "module",
6: "packageManager": "pnpm@10.11.0",
7: "engines": {
8: "node": ">=20.0"
9: },
10: "scripts": {
11: "tsx": "pnpm --filter sentry run tsx",
12: "cli": "pnpm --filter sentry run cli",
13: "dev": "pnpm --filter sentry run dev",
14: "build": "pnpm --filter sentry run build",
15: "build:all": "pnpm --filter sentry run build:all",
16: "bundle": "pnpm --filter sentry run bundle",
17: "typecheck": "pnpm --filter sentry run typecheck",
18: "lint": "pnpm --filter sentry run lint",
19: "lint:fix": "pnpm --filter sentry run lint:fix",
20: "test": "pnpm --filter sentry run test",
21: "test:unit": "pnpm --filter sentry run test:unit",
22: "test:changed": "pnpm --filter sentry run test:changed",
23: "test:e2e": "pnpm --filter sentry run ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/package.json</path>
<type>file</type>
<content>
1: {
2: "name": "sentry",
3: "version": "0.45.0-dev.0",
4: "description": "Sentry CLI - A command-line interface for using Sentry built by robots and humans for robots and humans",
5: "repository": {
6: "type": "git",
7: "url": "git+https://github.com/getsentry/cli.git"
8: },
9: "main": "./dist/index.cjs",
10: "type": "module",
11: "types": "./dist/index.d.cts",
12: "exports": {
13: ".": {
14: "import": {
15: "types": "./dist/index.d.mts",
16: "default": "./dist/index.mjs"
17: },
18: "require": {
19: "types": "./dist/index.d.cts",
20: "default": "./dist/index.cjs"
21: }
22: }
23: },
24: "bin": {
25: "sentry": "./dist/bin.cjs"
26: },
27: "files": [
28: "dist/bin.cjs",
29: "dist/index.cjs",
30: "dist/index.mjs",
31: "dist/index.d.cts",
32: "dist/index.d.mts",
33: ...
/home/byk/Code/getsentry/cli-pr-1558/.lore.md
<path>/home/byk/Code/getsentry/cli-pr-1558/.lore.md</path>
<type>file</type>
<content>
1: <!-- Managed by lore (https://github.com/BYK/loreai) — manual edits are imported on next session. -->
2:
3: ## Long-term Knowledge
4:
5: ### Architecture
6:
7: <!-- lore:01a02357-f0a8-7fdb-9e9d-b0710cfe65c9 -->
8: * **API output binary and HTTP contracts**: Always preserve strict output-mode and binary-safety contracts. `sentry api` must preserve `rawApiRequest()` status text; empty textual non-2xx bodies must produce an HTTP status/request fallback, and JSON mode must expose `{status, statusText, body}` so empty success and error responses are distinguishable. Binary `Uint8Array` successes bypass formatters and remain raw; binary errors emit only status/content-type/byte-count summaries, never bytes or JSON coercion. Prompts must never block scripted runs or interleave with stdout JSON.
9:
10: <!-- lore:019ef480-47f1-7708-80cb-514ac37a3fde -->
11: * **@sentry/symbolic 13.4.0 API surface: ...
No files found
I’ll first pin the review to the stated HEAD and patch digest, then trace each changed file through runtime, introspection, generators, artifacts, and tests. All commands will run with optional Git locks disabled.
bbaa7b3b722b87f1bccfe84063269cbbcabe2741 ## fix/agent-conversation-reference-root-cause...origin/pr-1558 [gone] M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M ...
dfcceb584e52de2d477015a74dfe42ac1e26e5f44ede4bf5da2afc9e343179d8 - .../src/fragments/commands/agent-conversation.md | 36 ----------- .../plugins/sentry-cli/skills/sentry-cli/SKILL.md | 42 ++++++------- .../skills/sentry-cli/references/alert.md | 6 +- .../sentry-cli/skills/sentry-cli/references/cli.md | 4 +- .../skills/sentry-cli/references/explore.md | 2 +- .../skills/sentry-cli/references/feedback.md | 2 +- .../skills/sentry-cli/references/init.md | 2 +- .../skills/sentry-cli/references/issue.md | 2 +- .../skills/sentry-cli/references/monitor.md | 2 +- .../sentry-cli/skills/sentry-cli/references/org.md | 2 +- .../skills/sentry-cli/references/project.md | 4 +- .../skills/sentry-cli/references/release.md | 4 +- .../skills/sentry-cli/references/replay.md | 2 +- .../skills/sentry-cli/references/repo.md | 2 +- .../skills/sentry-cli/references/team.md | 2 +- ...
diff --git a/packages/cli/src/lib/command.ts b/packages/cli/src/lib/command.ts
index 16f6e8cc6..248319cc7 100644
--- a/packages/cli/src/lib/command.ts
+++ b/packages/cli/src/lib/command.ts
@@ -94,12 +94,24 @@ type BaseArgs = readonly unknown[];
type StricliBuilderArgs<CONTEXT extends CommandContext> =
import("@stricli/core").CommandBuilderArguments<BaseFlags, BaseArgs, CONTEXT>;
+/** A runnable example stored with a command definition for generated docs. */
+export type CommandExample = {
+ /** Short explanation rendered before the command. */
+ readonly description: string;
+ /** Complete command line, including the `sentry` executable. */
+ readonly command: string;
+};
+
/**
- * Native Stricli documentation. When `customUsage` is present, its first line
- * must be the canonical signature suffix used by introspection and generated
- * docs; later lines may document equivalent forms.
+ * Native Stricli documentation plus metadata for generated docs. ...
diff --git a/apps/cli-docs/src/fragments/commands/agent-conversation.md b/apps/cli-docs/src/fragments/commands/agent-conversation.md index 3fa952c15..e69de29bb 100644 --- a/apps/cli-docs/src/fragments/commands/agent-conversation.md +++ b/apps/cli-docs/src/fragments/commands/agent-conversation.md @@ -1,36 +0,0 @@ - - - -## Examples - -### List conversations - -```bash -# List recent agent conversations -sentry agent-conversation list - -# Explicit organization -sentry agent-conversation list my-org - -# Show more, last 24 hours -sentry agent-conversation list --limit 50 --period 24h - -# Filter conversations -sentry agent-conversation list -q "has:errors" - -# Paginate through results -sentry agent-conversation list my-org -c next -``` - -### View a conversation transcript - -```bash -# View full transcript (organization auto-detected) -sentry agent-conversation view conv-123 - -# Explicit organization -sentry agent-conversation view my-org/conv-123 - -# JSON output -sentry ...
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -263,6 +263,9 @@ for (const [routeName, route] of multiCommandRoutes) {
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? sub;
const isDefault = leaf === defaultCmd;
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. ...
diff --git a/packages/cli/test/lib/command.test.ts b/packages/cli/test/lib/command.test.ts
index a251151e5..9b1506cd6 100644
--- a/packages/cli/test/lib/command.test.ts
+++ b/packages/cli/test/lib/command.test.ts
@@ -201,6 +201,34 @@ describe("buildCommand", () => {
).toBe("<name>:<kind>...");
});
+ test("retains structured examples for introspection", () => {
+ const command = buildCommand({
+ auth: false,
+ docs: {
+ brief: "List things",
+ examples: [
+ {
+ description: "Select an organization explicitly",
+ command: "sentry thing list my-org",
+ },
+ ],
+ },
+ parameters: {},
+ async *func() {
+ // no-op
+ },
+ });
+
+ expect((command as unknown as { __examples?: unknown }).__examples).toEqual(
+ [
+ {
+ description: "Select an organization explicitly",
+ command: "sentry thing list my-org",
+ },
+ ]
+ );
+ });
+
...
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -354,7 +354,7 @@ Authenticate with Sentry Work with Sentry organizations - `sentry org list` — List organizations -- `sentry org view <org>` — View details of an organization +- `sentry org view [<org>]` — View details of an organization → Full flags and examples: `references/org.md` @@ -364,8 +364,8 @@ Work with Sentry projects - `sentry project create [<org>/]<name>:<platform>...` — Create one or more projects - `sentry project delete <org/project>` — Delete a project -- `sentry project list <org/project>` — List projects -- `sentry project view <org/project>` — View details of a project +- `sentry project list [<org/project>]` — List projects +- `sentry project view ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path> <type>file</type> <content> 1: /** 2: * Command builder with telemetry, global flag injection, and output modes. 3: * 4: * Provides `buildCommand` — the standard command builder for all Sentry CLI 5: * commands. It wraps Stricli's `buildCommand` with: 6: * 7: * 1. **Automatic flag/arg telemetry** — captures flag values and positional 8: * arguments as Sentry span context for observability. 9: * 10: * 2. **Hidden global logging flags** — injects `--log-level` and `--verbose` 11: * into every command's parameters. These are intercepted before the original 12: * `func` runs: the logger level is set, and the injected flags are stripped 13: * so the original function never sees them. If a command already defines its 14: * own `--verbose` flag (e.g. `api` uses it for HTTP output), the injected 15: * one is skipped and the command's own value is used for both purposes. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
1: /**
2: * Route Tree Introspection
3: *
4: * Shared module for extracting structured metadata from Stricli's route tree.
5: * Used at runtime by `sentry help --json` and at build time by `generate-skill.ts`.
6: *
7: * While @stricli/core exports RouteMap and Command types, they require complex
8: * generic parameters (CommandContext) and don't export internal types like
9: * RouteMapEntry or FlagParameter. These simplified types are purpose-built
10: * for introspection and documentation generation.
11: */
12:
13: import type { CommandExample } from "./command.js";
14: import {
15: extractSchemaFields,
16: type SchemaFieldInfo,
17: } from "./formatters/output.js";
18: import { fuzzyMatch } from "./fuzzy.js";
19:
20: // ---------------------------------------------------------------------------
21: // Stricli Runtime Types (simplified for introspection)
22: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
1: #!/usr/bin/env tsx
2: /**
3: * Generate Skill Files from Stricli Command Metadata and Docs
4: *
5: * Introspects the CLI's route tree and merges with documentation
6: * to generate structured documentation for AI agents.
7: *
8: * Produces:
9: * - SKILL.md: compact index with agent guidance + command summaries
10: * - references/*.md: full per-route command documentation
11: * - index.json: skill discovery manifest for .well-known
12: *
13: * Usage:
14: * tsx script/generate-skill.ts
15: *
16: * Output:
17: * plugins/sentry-cli/skills/sentry-cli/SKILL.md
18: * plugins/sentry-cli/skills/sentry-cli/references/*.md
19: * docs/public/.well-known/skills/index.json
20: */
21:
22: import { existsSync, mkdirSync, rmSync, writeFileSync } from "node:fs";
23: import { access, readFile, writeFile } from "node:fs/promises";
24: import type { Token ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
1: #!/usr/bin/env tsx
2: /**
3: * Generate Command Reference & Configuration Documentation
4: *
5: * Introspects the CLI's route tree and env var registry to generate
6: * accurate reference pages for the documentation website. Flags, arguments,
7: * aliases, and environment variables are extracted directly from source code,
8: * preventing documentation drift.
9: *
10: * Each generated page combines:
11: * 1. Auto-generated reference and examples from CLI metadata or env registry
12: * 2. Hand-written guides and tips from docs/src/fragments/
13: *
14: * The generated output is gitignored. Fragment files are the committed
15: * source of truth for content that cannot live in command definitions.
16: *
17: * Usage:
18: * tsx script/generate-command-docs.ts
19: *
20: * Output:
21: * docs/src/content/docs/commands/{route}.md (one per ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
368: // ---------------------------------------------------------------------------
369: // Custom Content (Fragment Files)
370: // ---------------------------------------------------------------------------
371:
372: /**
373: * Read hand-written custom content from a command fragment file.
374: * Fragment files live in docs/src/fragments/commands/ and contain only
375: * the custom sections (examples, guides) — no frontmatter or generated content.
376: * Returns empty string if the fragment file doesn't exist.
377: */
378: async function readCustomContent(fragmentName: string): Promise<string> {
379: try {
380: return await readFile(`${FRAGMENTS_DIR}/${fragmentName}.md`, "utf-8");
381: } catch {
382: return "";
383: }
384: }
385:
386: /**
387: * Read hand-written custom content from a top-level fragment file. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts</path>
<type>file</type>
<content>
1: #!/usr/bin/env tsx
2: /**
3: * Validate doc fragment files.
4: *
5: * Ensures fragment files stay consistent with the CLI route tree:
6: * 1. Every route has a corresponding fragment file (+ index.md)
7: * 2. Every fragment file corresponds to an existing route (or is index.md)
8: * 3. Fragment files don't accidentally contain frontmatter or the generated marker
9: * 4. Top-level fragments (e.g., configuration.md) exist
10: * 5. Fragment content covers all subcommands in a route (warnings only)
11: *
12: * Usage:
13: * tsx script/check-fragments.ts # Warnings for missing subcommands
14: * tsx script/check-fragments.ts --strict # Errors for missing subcommands
15: */
16:
17: import { mkdirSync, readdirSync } from "node:fs";
18: import { access, readFile, writeFile } from "node:fs/promises";
19: import type { RouteInfo, RouteMap ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation list
3: *
4: * List recent agent conversations from Sentry projects.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { listConversations } from "../../lib/api-client.js";
9: import { validateLimit } from "../../lib/arg-parsing.js";
10: import {
11: advancePaginationState,
12: buildPaginationContextKey,
13: hasPreviousPage,
14: resolveCursor,
15: } from "../../lib/db/pagination.js";
16: import { ContextError } from "../../lib/errors.js";
17: import { formatConversationTable } from "../../lib/formatters/conversation.js";
18: import { filterFields } from "../../lib/formatters/json.js";
19: import { CommandOutput } from "../../lib/formatters/output.js";
20: import { getPositionalString } from "../../lib/introspect.js";
21: import {
22: buildListCommand,
23: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation view
3: *
4: * View the transcript of a specific agent conversation.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { getConversationSpans } from "../../lib/api-client.js";
9: import { buildCommand } from "../../lib/command.js";
10: import { ContextError } from "../../lib/errors.js";
11: import {
12: buildTranscriptResult,
13: formatTranscriptResult,
14: type TranscriptResult,
15: } from "../../lib/formatters/conversation.js";
16: import { CommandOutput } from "../../lib/formatters/output.js";
17: import {
18: applyFreshFlag,
19: FRESH_ALIASES,
20: FRESH_FLAG,
21: } from "../../lib/list-command.js";
22: import { withProgress } from "../../lib/polling.js";
23: import { resolveOrg } from "../../lib/resolve-target.js";
24:
25: type ViewFlags = {
26: readonly json: ...
Found 10 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/script/generate-skill-markdown.test.ts:
Line 39: "sentry agent-conversation view"
Line 51: "# View full transcript (organization auto-detected)\nsentry agent-conversation view conv-123",
Line 52: "# Explicit organization\nsentry agent-conversation view my-org/conv-123",
Line 53: "# JSON output\nsentry agent-conversation view my-org/conv-123 --json",
Line 61: "sentry agent-conversation view conv-123",
Line 64: "sentry agent-conversation view my-org/conv-123",
Line 67: "sentry agent-conversation view my-org/conv-123 --json",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/agent-conversation/view.test.ts:
Line 4: * Tests for the `sentry agent-conversation view` command func() body, covering:
Line 248: test("no-args error mentions Conversation ID", async () => {
Line 257: expect((error as ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/agent-conversation/view.test.ts</path>
<type>file</type>
<content>
1: /**
2: * Conversation View Command Tests
3: *
4: * Tests for the `sentry agent-conversation view` command func() body, covering:
5: * - Resolving org + conversationId from a single `<org>/<conversation-id>` arg
6: * - Resolving org via resolveOrg when only the conversation-id is given
7: * - Throwing error when no args provided
8: * - Throwing ContextError when org cannot be resolved
9: * - Yielding CommandOutput with transcript result
10: * - Setting truncated flag from API response
11: *
12: * Uses spyOn mocking to avoid real HTTP calls or database access.
13: */
14:
15: import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
16: import { viewCommand } from "../../../src/commands/agent-conversation/view.js";
17:
18: vi.mock("../../../src/lib/api-client.js", async (importOriginal) => {
19: const actual =
20: ...
The patch identity matches exactly. I’m now checking the wrapper against Stricli’s actual runtime types/help renderer, then I’ll validate both generators and the agent-conversation parser at command boundaries.
No files found
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/node_modules</path> <type>directory</type> <entries> .modules.yaml .pnpm-workspace-state.json .pnpm/ (3 entries) </entries>
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm</path> <type>directory</type> <entries> @a2a-js+sdk@0.3.14_express@5.2.1/ @ai-sdk+provider-utils@2.2.8_zod@4.4.3/ @ai-sdk+provider-utils@3.0.30_zod@4.4.3/ @ai-sdk+provider-utils@4.0.40_zod@4.4.3/ @ai-sdk+provider-utils@5.0.13_zod@4.4.3/ @ai-sdk+provider@1.1.3/ @ai-sdk+provider@2.0.3/ @ai-sdk+provider@3.0.14/ @ai-sdk+provider@4.0.4/ @ai-sdk+ui-utils@1.2.11_zod@4.4.3/ @alcalzone+ansi-tokenize@0.3.0/ @anthropic-ai+sdk@0.39.0/ @apm-js-collab+code-transformer-bundler-plugins@0.5.0/ @apm-js-collab+code-transformer-bundler-plugins@0.7.3/ @apm-js-collab+code-transformer@0.15.0/ @apm-js-collab+code-transformer@0.18.1/ @apm-js-collab+tracing-hooks@0.10.1/ @apm-js-collab+tracing-hooks@0.13.0/ @astrojs+compiler-binding-linux-x64-gnu@0.3.2/ @astrojs+compiler-binding-linux-x64-musl@0.3.2/ @astrojs+compiler-binding@0.3.2_@emnapi+core@1.10.0_@emnapi+runtime@1.10.0/ @astrojs+compiler-rs@0.3.2_@emnapi+core@1.10.0_@emnapi+runtime@1.10.0/ @astr...
No files found
node_modules/.pnpm/@stricli+auto-complete@1.3.0 node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc node_modules/.pnpm/@stricli+core@1.3.0
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core</path> <type>directory</type> <entries> dist/ package.json README.md (3 entries) </entries>
<path>/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core/dist</path> <type>directory</type> <entries> index.cjs index.d.cts index.d.ts index.js (4 entries) </entries>
Found 13 matches
/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core/dist/index.d.ts:
Line 1123: readonly fullDescription: string | undefined;
Line 1411: interface CommandDocumentation {
Line 1419: readonly fullDescription?: string;
Line 1423: readonly customUsage?: readonly (string | CustomUsage)[];
Line 1426: type BaseCommandBuilderArguments<FLAGS extends BaseFlags, ARGS extends BaseArgs, CONTEXT extends CommandContext> = {
Line 1436: type LazyCommandBuilderArguments<FLAGS extends BaseFlags, ARGS extends BaseArgs, CONTEXT extends CommandContext> = {
Line 1441: } & NoInfer<BaseCommandBuilderArguments<FLAGS, ARGS, CONTEXT>>;
Line 1442: type LocalCommandBuilderArguments<FLAGS extends BaseFlags, ARGS extends BaseArgs, CONTEXT extends CommandContext> = {
Line 1447: } & NoInfer<BaseCommandBuilderArguments<FLAGS, ARGS, ...
<path>/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core/dist/index.d.ts</path>
<type>file</type>
<content>
1400: declare function buildChoiceParser<T extends string>(choices: readonly T[]): InputParser<T>;
1401:
1402: /**
1403: * Parses input strings as numbers.
1404: */
1405: declare const numberParser: (input: string) => number;
1406:
1407: interface CustomUsage {
1408: readonly input: string;
1409: readonly brief: string;
1410: }
1411: interface CommandDocumentation {
1412: /**
1413: * In-line documentation for this command.
1414: */
1415: readonly brief: string;
1416: /**
1417: * Longer description of this command's behavior, only printed during `--help`.
1418: */
1419: readonly fullDescription?: string;
1420: /**
1421: * Sample usage to replace the generated usage lines. ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core/dist/index.js:
Line 2001: const { brief, fullDescription, customUsage } = docs;
Line 2005: if (customUsage) {
Line 2006: for (const usage of customUsage) {
<path>/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1950: ];
1951: }),
1952: [" ", " ", " "]
1953: );
1954: }
1955: function* generateBuiltInFlagUsageLines(args) {
1956: yield args.config.useAliasInUsageLine ? "-h" : "--help";
1957: if (args.includeHelpAllFlag) {
1958: const helpAllFlagName = formatForDisplay("helpAll", args.config.caseStyle);
1959: yield `--${helpAllFlagName}`;
1960: }
1961: if (args.includeVersionFlag) {
1962: yield args.config.useAliasInUsageLine ? "-v" : "--version";
1963: }
1964: }
1965:
1966: // src/parameter/positional/formatting.ts
1967: function formatDocumentationForPositionalParameters(positional, args) {
1968: if (positional.kind === "array") {
1969: const name = positional.parameter.placeholder ?? ...
Found 6 matches
/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core/dist/index.js:
Line 1687: const brief = entry.target.brief;
Line 1971: const brief = args.ansiColor ? `\x1B[3m${positional.parameter.brief}\x1B[23m` : positional.parameter.brief;
Line 2001: const { brief, fullDescription, customUsage } = docs;
Line 2005: if (customUsage) {
Line 2006: for (const usage of customUsage) {
Line 2093: function buildCommand(builderArgs) {
<path>/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
2040: for (const line of formatDocumentationForPositionalParameters(positional, args)) {
2041: yield ` ${line}`;
2042: }
2043: }
2044: }
2045:
2046: // src/routing/command/builder.ts
2047: function checkForReservedFlags(flags, reserved) {
2048: for (const flag of reserved) {
2049: if (flag in flags) {
2050: throw new InternalError(`Unable to use reserved flag --${flag}`);
2051: }
2052: }
2053: }
2054: function checkForReservedAliases(aliases, reserved) {
2055: for (const alias of reserved) {
2056: if (alias in aliases) {
2057: throw new InternalError(`Unable to use reserved alias -${alias}`);
2058: }
2059: }
2060: }
2061: function* asNegationFlagNames(flagName) {
2062: yield ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules</path> <type>directory</type> <entries> .bin/ .vite-temp/ .vite/ @anthropic-ai/ @biomejs/ @clack/ @hono/ @mastra/ @sentry/ @spotlightjs/ @stricli/ @types/ @vitest/ binpatch/ chalk/ cli-highlight/ consola/ esbuild/ fast-check/ fflate/ fossilize/ hono/ http-cache-semantics/ ignore/ ink-spinner/ ink/ jpeg-js/ marked/ node-sqlite3-wasm/ p-limit/ peggy/ picomatch/ pixelmatch/ pngjs/ pretty-ms/ qrcode-terminal/ react-devtools-core/ react/ semver/ string-width/ tinyglobby/ tsx/ typescript/ ultracite/ uuidv7/ valibot/ vitest/ wrap-ansi/ (48 entries) </entries>
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core</path> <type>directory</type> <entries> dist/ package.json README.md (3 entries) </entries>
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/patches/@stricli%2Fcore@1.2.8.patch</path>
<type>file</type>
<content>
1: diff --git a/dist/index.cjs b/dist/index.cjs
2: index a9afbc1ab78cad7ba97d53882a80236af62854df..141532779be923b8f3b421b0afc031b5ea209e29 100644
3: --- a/dist/index.cjs
4: +++ b/dist/index.cjs
5: @@ -1277,6 +1277,35 @@ var RouteMapSymbol = Symbol("RouteMap");
6: var CommandSymbol = Symbol("Command");
7:
8: // src/routing/scanner.ts
9: +// PATCH(getsentry/cli): pluggable top-level (global) flags allow-list.
10: +// Stricli only parses flags at the leaf command, so a flag placed before the
11: +// subcommand (e.g. `mycli --verbose sub cmd`) is treated as an unknown route
12: +// segment and fails route resolution. When the host application declares a
13: +// `scanner.topLevelFlags` allow-list, `buildRouteScanner` recognizes those
14: +// flags at any route depth and forwards them (and, for value-taking flags,
15: +// their value) to the leaf command via ...
Found 95 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 709: const { introspectCommand, formatHelpHuman } = await import("./help.js");
Line 710: const result = introspectCommand(pathSegments);
Line 719: stdout.write(`${formatHelpHuman(result)}\n`);
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/api/sourcemaps.ts:
Line 205: const manifest = JSON.stringify({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/jvm-bundle.ts:
Line 391: Buffer.from(JSON.stringify(manifest, null, 2), "utf-8")
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 5: * Used at runtime by `sentry help --json` and at build time by `generate-skill.ts`.
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/react-native/wrap-call.ts:
Line 140: writeFileSync(hermesPath, JSON.stringify(hermes));
Line 214: writeFileSync(reportPath, ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
250: // Example
251: lines.push(` ${muted("try:")} ${magenta(example)}`);
252: lines.push("");
253:
254: // Footer
255: lines.push(` ${muted(`Learn more at ${DOCS_URL}`)}`);
256: lines.push("");
257: lines.push("");
258:
259: return lines.join("\n");
260: }
261:
262: // ---------------------------------------------------------------------------
263: // Introspection (for `sentry help --json` and human rendering)
264: // ---------------------------------------------------------------------------
265:
266: /**
267: * Metadata for a top-level environment variable as exposed to JSON callers
268: * of `sentry help --json`.
269: */
270: export type HelpEnvVarInfo = {
271: /** Variable name (e.g. `SENTRY_AUTH_TOKEN`). */
272: name: string;
273: /** Short one-line description suitable for list display. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/help.ts</path>
<type>file</type>
<content>
1: /**
2: * Help Command
3: *
4: * Provides help information for the CLI.
5: * - `sentry help` or `sentry` (no args): Shows branded help with banner
6: * - `sentry help <command>`: Shows detailed help for that command
7: * - `sentry help --json`: Emits full command tree as structured JSON
8: * - `sentry help --json <command>`: Emits specific command/group metadata as JSON
9: */
10:
11: import type { SentryContext } from "../context.js";
12: import { buildCommand } from "../lib/command.js";
13: import { OutputError } from "../lib/errors.js";
14: import { CommandOutput } from "../lib/formatters/output.js";
15: import {
16: formatHelpHuman,
17: introspectAllCommands,
18: introspectCommand,
19: } from "../lib/help.js";
20:
21: export const helpCommand = buildCommand({
22: auth: false,
23: docs: {
24: brief: "Display help for a command",
25: ...
No files found
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-agent-conversation 3: version: 0.45.0-dev.0 4: description: List and view agent conversations 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Agent-conversation Commands 11: 12: List and view agent conversations 13: 14: ### `sentry agent-conversation list [<org>]` 15: 16: List recent agent conversations 17: 18: **Flags:** 19: - `-n, --limit <value> - Number of conversations (1-1000) - (default: "25")` 20: - `-q, --query <value> - Search query` 21: - `-t, --period <value> - Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" - (default: "7d")` 22: - `-f, --fresh - Bypass cache, re-detect projects, and fetch fresh data` 23: - `-c, --cursor <value> - Navigate pages: "next", "prev", "first" (or raw cursor string)` 24: 25: **JSON Fields** (use `--json --fields` to select ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts</path>
<type>file</type>
<content>
500: * are async generators — non-streaming commands yield once and return.
501: */
502: type ListCommandFunction<
503: FLAGS extends BaseFlags,
504: ARGS extends BaseArgs,
505: CONTEXT extends CommandContext,
506: > = (
507: this: CONTEXT,
508: flags: FLAGS,
509: ...args: ARGS
510: // biome-ignore lint/suspicious/noConfusingVoidType: void is required here — generators that don't return a value have implicit void return, which is distinct from undefined in TypeScript's type system
511: ) => AsyncGenerator<unknown, CommandReturn | void, undefined>;
512:
513: /**
514: * Options for controlling which flags {@link buildListCommand} auto-injects.
515: *
516: * By default, `buildListCommand` adds `--fresh`, `--cursor`, and their aliases
517: * (`-f`, `-c`). Use these options to opt out when a command has conflicts. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/mutate-command.ts</path> <type>file</type> <content> 280: /** Skip injecting `--dry-run` flag and `-n` alias. */ 281: noDryRunFlag?: boolean; 282: /** Skip the non-interactive safety guard pre-hook. */ 283: noNonInteractiveGuard?: boolean; 284: }; 285: 286: /** 287: * Build a Stricli command for a destructive operation with automatic safety 288: * flag injection and a non-interactive guard. 289: * 290: * This is a drop-in replacement for `buildCommand` that: 291: * 1. Auto-injects `--yes`, `--force`, and `--dry-run` flags (unless already 292: * defined, controlled by `options`) 293: * 2. Auto-injects `-y`, `-f`, `-n` aliases (skips if key already taken) 294: * 3. ...
Found 4 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts: Line 107: * `customUsage` is present, its first line is the canonical signature suffix; Line 464: const primaryUsage = docs.customUsage?.[0]; /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts: Line 609: customUsage: ["[<org>/]<name>:<platform>..."], /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 63: customUsage: [USAGE],
Found 100 matches (more matches available) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 89: parameters: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 66: parameters: [ Line 71: optional: true, Line 158: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/start.ts: Line 96: parameters: [ Line 106: optional: true as const, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/list.ts: Line 219: parameters: [ Line 224: optional: true as const, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 161: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts: Line 224: parameters: [ Line 229: optional: true, Line 244: optional: ...
32
Found 12 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts:
Line 98: expect(getPositionalString(undefined)).toBe("");
Line 102: const result = getPositionalString({
Line 110: const result = getPositionalString({
Line 121: const result = getPositionalString({
Line 129: const result = getPositionalString({
Line 137: const result = getPositionalString({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.property.test.ts:
Line 150: const result = getPositionalString({
Line 174: const result = getPositionalString({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 195: export function getPositionalString(params?: PositionalParams): string {
Line 301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts:
Line 123: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
80: {
81: long: "--help",
82: description: "Show help for a command",
83: },
84: {
85: long: "--version",
86: description: "Show version",
87: },
88: ];
89:
90: /**
91: * Generate the commands list dynamically from Stricli's route structure.
92: * This ensures help text stays in sync with actual registered commands.
93: */
94: function generateCommands(): HelpCommand[] {
95: // Cast to our introspection types — Stricli's generic types are compatible
96: const routeMap = routes as unknown as RouteMap;
97: const entries = routeMap.getAllEntries();
98:
99: return entries
100: .filter((entry: RouteMapEntry) => !entry.hidden)
101: .map((entry: RouteMapEntry) => {
102: const routeName = entry.name.original;
103: const brief = entry.target.brief;
104:
105: if (isRouteMap(entry.target)) {
106: // Get visible ...
packages/cli/src/commands/api.ts packages/cli/src/commands/explore.ts packages/cli/src/commands/init.ts packages/cli/src/commands/agent-conversation/list.ts packages/cli/src/commands/build/download.ts packages/cli/src/commands/cli/completion.ts packages/cli/src/commands/cli/upgrade.ts packages/cli/src/commands/code-mappings/upload.ts packages/cli/src/commands/dart-symbol-map/upload.ts packages/cli/src/commands/debug-files/bundle-jvm.ts packages/cli/src/commands/debug-files/bundle-sources.ts packages/cli/src/commands/feedback/list.ts packages/cli/src/commands/org/view.ts packages/cli/src/commands/project/view.ts packages/cli/src/commands/release/create.ts packages/cli/src/commands/release/deploy.ts packages/cli/src/commands/release/finalize.ts packages/cli/src/commands/release/set-commits.ts packages/cli/src/commands/replay/list.ts packages/cli/src/commands/snapshots/diff.ts packages/cli/src/commands/snapshots/upload.ts packages/cli/src/commands/sourcemap/inject.ts packages/cli/src/comm...
Found 11 matches
/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core/dist/index.js:
Line 625: if (flag.optional) {
Line 844: if (param.optional) {
Line 1547: // PATCH(getsentry/cli): carry the optional top-level-flags allow-list through
Line 1566: // PATCH(getsentry/cli): carry the optional pluggable help renderer through
Line 1776: return flag.optional ?? hasDefault(flag);
Line 1798: function formatUsageLineForParameters(parameters, args) {
Line 1843: parameters2 = parameters2.filter((param) => !param.optional && typeof param.default === "undefined");
Line 1847: return param.optional || typeof param.default !== "undefined" ? wrapOptionalParameter(argName) : wrapRequiredParameter(argName);
Line 1975: const atLeastOneOptional = positional.parameters.some((def) => def.optional);
Line ...
<path>/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1755: });
1756: }
1757:
1758: // src/parameter/parser/choice.ts
1759: function narrowString(choices, value) {
1760: return choices.includes(value);
1761: }
1762: function buildChoiceParser(choices) {
1763: return (input) => {
1764: if (!narrowString(choices, input)) {
1765: throw new SyntaxError(`${input} is not one of (${choices.join("|")})`);
1766: }
1767: return input;
1768: };
1769: }
1770:
1771: // src/parameter/flag/types.ts
1772: function hasDefault(flag) {
1773: return "default" in flag && typeof flag.default !== "undefined";
1774: }
1775: function isOptionalAtRuntime(flag) {
1776: return flag.optional ?? hasDefault(flag);
1777: }
1778:
1779: // src/parameter/formatting.ts
1780: function wrapRequiredFlag(text) ...
bbaa7b3b7 (HEAD -> fix/agent-conversation-reference-root-cause) fix(docs): correct agent conversation argument syntax 9d0901b10 feat(local): Add agent debugging stream (#1538) 72c307f47 fix(cli): log UID resolution failures in sentry cli fix (#1541) e710ce905 fix(telemetry): log process-tree walk failures in agent detection (#1542) 6e3e7e13a feat(config): follow XDG Base Directory spec for config location (#1503) 17e110300 fix(init): stop recording skipped verification as an error (#1544) c0c9c8274 fix(docs): Explain regional model unavailability (#1537) 2d2fbffb6 fix(init): gate unsupported --features and tag dry-run runs (#1535) 02f6e8d1d fix(lint): force-ignore output.ts from Biome type analysis (200k limit) (#1536) 66a527596 feat(init): track completion-screen actions in run telemetry (#1534) dc5b79c2f fix(telemetry): Silence CliError for process exit code 1 (#1449) 657a19450 fix(dashboards): Remove references to removed datasets (#1515) bbaa7b3b7 (HEAD -> ...
.../src/fragments/commands/agent-conversation.md | 33 ---------- .../plugins/sentry-cli/skills/sentry-cli/SKILL.md | 46 +++++++------- .../sentry-cli/references/agent-conversation.md | 13 ++-- .../skills/sentry-cli/references/alert.md | 6 +- .../sentry-cli/skills/sentry-cli/references/cli.md | 4 +- .../skills/sentry-cli/references/explore.md | 2 +- .../skills/sentry-cli/references/feedback.md | 2 +- .../skills/sentry-cli/references/init.md | 2 +- .../skills/sentry-cli/references/issue.md | 2 +- .../skills/sentry-cli/references/monitor.md | 2 +- .../sentry-cli/skills/sentry-cli/references/org.md | 2 +- .../skills/sentry-cli/references/project.md | 4 +- .../skills/sentry-cli/references/release.md | 4 +- .../skills/sentry-cli/references/replay.md | 2 +- .../skills/sentry-cli/references/repo.md | 2 +- .../skills/sentry-cli/references/team.md | 2 +- ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
Found 5 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/api/conversations.ts:
Line 42: * Internal helper used by {@link listConversations} for both single-page and
Line 101: export async function listConversations(
Line 119: export async function getConversationSpans(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/api-client.ts:
Line 42: getConversationSpans,
Line 43: listConversations,
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/api/conversations.ts</path>
<type>file</type>
<content>
1: /**
2: * Agent conversations API functions
3: *
4: * Functions for listing and retrieving agent conversation data from the Sentry
5: * Explore agent conversations endpoints.
6: *
7: * The `/organizations/{org}/agents/conversations/` endpoints are PRIVATE and not
8: * yet in `@sentry/api` (getsentry/sentry-api-schema). Call them via
9: * `apiRequestToRegion` with local Valibot schemas (same pattern as `logs.ts` /
10: * `traces.ts`). Details response shape is documented on
11: * `AgentConversationDetailsSchema`. Pagination uses `parseLinkHeader`. Revisit
12: * once these endpoints land in `@sentry/api`.
13: */
14:
15: import { array } from "valibot";
16:
17: import {
18: type AgentConversationDetails,
19: AgentConversationDetailsSchema,
20: type AgentConversationSpan,
21: type ConversationListItem,
22: ConversationListItemSchema,
23: } from ...
> sentry@0.45.0-dev.0 typecheck /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:docs && pnpm run generate:sdk && tsc --noEmit > sentry@0.45.0-dev.0 generate:docs /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm run generate:banner && pnpm run generate:parser && pnpm run generate:command-docs && pnpm run generate:skill && pnpm run generate:docs-sections > sentry@0.45.0-dev.0 generate:banner /home/byk/Code/getsentry/cli-pr-1558/packages/cli > pnpm tsx script/generate-banner-sixel.ts > sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/generate-banner-sixel.ts .env.local not found. Continuing without it. .env.local not found. Continuing without it. Wrote /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/generated/banner-sixel.ts (640x155, sixel 4216 bytes) > sentry@0.45.0-dev.0 generate:parser /home/byk/Code/getsentry/cli-pr-1558/packages/cli > ...
M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md M ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: title: agent-conversation 3: description: Agent-conversation commands for the Sentry CLI 4: --- 5: 6: List and view agent conversations 7: 8: ## Commands 9: 10: ### `sentry agent-conversation list [<org>]` 11: 12: List recent agent conversations 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<org>]` | Organization slug | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-n, --limit <limit>` | Number of conversations (1-1000) (default: "25") | 25: | `-q, --query <query>` | Search query | 26: | `-t, --period <period>` | Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" (default: "7d") | 27: | `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data | 28: | `-c, --cursor <cursor>` | Navigate pages: "next", "prev", "first" ...
> sentry@0.45.0-dev.0 cli /home/byk/Code/getsentry/cli-pr-1558/packages/cli > tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs src/bin.ts -- agent-conversation --help .env.local not found. Continuing without it. .env.local not found. Continuing without it. Error: API request failed: 404 Not Found Endpoint: /organizations/--help/agents/conversations/ Not found ELIFECYCLE Command failed with exit code 30.
(no output)
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
USAGE
sentry agent-conversation view [<org>/]<conversation-id>
sentry agent-conversation view --help
View the full transcript of an agent conversation.
The org is optional and auto-detected from your project context when
omitted. Prefix the ID with an org slug to target a specific org.
Examples:
sentry agent-conversation view conv-123 # View full transcript (organization auto-detected)
sentry agent-conversation view my-org/conv-123 # Explicit organization
sentry agent-conversation view my-org/conv-123 --json # JSON output
ALIASES
sentry agent-conversation show
FLAGS
-f [--fresh] Bypass cache, re-detect projects, and fetch fresh data [default = false]
[--json] Output as JSON [default = false]
...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path> <type>file</type> <content> 1: /** 2: * Command builder with telemetry, global flag injection, and output modes. 3: * 4: * Provides `buildCommand` — the standard command builder for all Sentry CLI 5: * commands. It wraps Stricli's `buildCommand` with: 6: * 7: * 1. **Automatic flag/arg telemetry** — captures flag values and positional 8: * arguments as Sentry span context for observability. 9: * 10: * 2. **Hidden global logging flags** — injects `--log-level` and `--verbose` 11: * into every command's parameters. These are intercepted before the original 12: * `func` runs: the logger level is set, and the injected flags are stripped 13: * so the original function never sees them. If a command already defines its 14: * own `--verbose` flag (e.g. `api` uses it for HTTP output), the injected 15: * one is skipped and the command's own value is used for both purposes. ...
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -263,6 +263,9 @@ for (const [routeName, route] of multiCommandRoutes) {
const missing: string[] = [];
for (const cmd of route.commands) {
+ if (cmd.examples.length > 0) {
+ continue;
+ }
const sub = cmd.path.slice(`sentry ${routeName} `.length);
const leaf = sub.split(" ").at(-1) ?? sub;
const isDefault = leaf === defaultCmd;
diff --git a/packages/cli/script/generate-command-docs.ts b/packages/cli/script/generate-command-docs.ts
index cdc8865be..8c9ce6332 100644
--- a/packages/cli/script/generate-command-docs.ts
+++ b/packages/cli/script/generate-command-docs.ts
@@ -8,11 +8,11 @@
* preventing documentation drift.
*
* Each generated page combines:
- * 1. Auto-generated reference — from CLI metadata or env registry
- * 2. ...
Found 26 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/utils.test.ts:
Line 14: describe("JSDoc examples (canonical alignment)", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/arg-parsing.test.ts:
Line 57: // Representative examples for documentation (invariants covered by property tests)
Line 325: // Representative examples for documentation (invariants covered by property tests)
Line 326: describe("representative examples", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/errors.test.ts:
Line 283: test("formats Try examples and Note section", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/dsn.test.ts:
Line 38: // All-zero padded org host used in OTLP docs examples
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/issue-id.test.ts:
Line 58: describe("expandToFullShortId representative examples", () => {
Line 59: // Representative examples for documentation ...
Found 9 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 466: metadata.__primaryUsage =
Line 896: (cmd as unknown as Record<string, unknown>).__jsonSchema =
Line 903: (cmd as unknown as Record<string, unknown>).__rawFunc = originalFunc;
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 57: __jsonSchema?: import("valibot").GenericSchema;
Line 62: __primaryUsage?: string;
Line 291: const jsonFields = cmd.__jsonSchema
Line 292: ? extractSchemaFields(cmd.__jsonSchema)
Line 301: cmd.__primaryUsage ?? getPositionalString(cmd.parameters.positional),
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts:
Line 122: entry.target.__primaryUsage ??
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
1: /**
2: * Route Tree Introspection
3: *
4: * Shared module for extracting structured metadata from Stricli's route tree.
5: * Used at runtime by `sentry help --json` and at build time by `generate-skill.ts`.
6: *
7: * While @stricli/core exports RouteMap and Command types, they require complex
8: * generic parameters (CommandContext) and don't export internal types like
9: * RouteMapEntry or FlagParameter. These simplified types are purpose-built
10: * for introspection and documentation generation.
11: */
12:
13: import type { CommandExample } from "./command.js";
14: import {
15: extractSchemaFields,
16: type SchemaFieldInfo,
17: } from "./formatters/output.js";
18: import { fuzzyMatch } from "./fuzzy.js";
19:
20: // ---------------------------------------------------------------------------
21: // Stricli Runtime Types (simplified for introspection)
22: ...
diff --git a/packages/cli/script/check-fragments.ts b/packages/cli/script/check-fragments.ts
index 36db22e1d..6384a649d 100644
--- a/packages/cli/script/check-fragments.ts
+++ b/packages/cli/script/check-fragments.ts
@@ -186,128 +186,131 @@ function fragmentMentionsSubcommand(
const proseOnly = stripCodeBlocks(content);
const escapedLeaf = leaf.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
const headingRe = new RegExp(`^#{1,4}\\s+.*\\b${escapedLeaf}\\b`, "im");
if (headingRe.test(proseOnly)) {
return true;
}
return false;
}
/**
* Build a map of route name → RouteInfo for routes with multiple subcommands.
* Standalone commands (single command matching `sentry <name>`) are skipped
* since there's nothing to check — the fragment covers the whole command. ...
Found 3 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts: Line 488: const docExamples = await loadCommandExamples( Line 496: commands: extractRouteGroupCommands(target, routeName, docExamples), Line 500: const examples = docExamples.get(path) ?? [];
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts</path>
<type>file</type>
<content>
100: const pkg = JSON.parse(await readFile("package.json", "utf-8"));
101: return pkg.version;
102: }
103:
104: /** Regex to match YAML frontmatter at the start of a file */
105: const FRONTMATTER_REGEX = /^---\n[\s\S]*?\n---\n/;
106:
107: /** Regex to match code blocks with optional language specifier */
108: const CODE_BLOCK_REGEX = /```(\w*)\n([\s\S]*?)```/g;
109:
110: /** Regex to extract npm command from PackageManagerCode Astro component (handles multi-line) */
111: const PACKAGE_MANAGER_REGEX = /<PackageManagerCode[\s\S]*?npm="([^"]+)"/;
112:
113: /**
114: * Skill description used in YAML frontmatter and index.json.
115: * Kept as a constant to ensure consistency across all generated files.
116: */
117: const SKILL_DESCRIPTION =
118: "Guide for using the Sentry CLI to interact with Sentry from the command line. ...
{
"positional": "[<org>]",
"positionals": [
{
"placeholder": "org",
"brief": "Organization slug",
"optional": true
}
],
"examples": [
"# List recent agent conversations\nsentry agent-conversation list",
"# Explicit organization\nsentry agent-conversation list my-org",
"# Show more, last 24 hours\nsentry agent-conversation list --limit 50 --period 24h",
"# Filter conversations\nsentry agent-conversation list -q \"has:errors\"",
"# Paginate through results\nsentry agent-conversation list my-org -c next"
],
"fullDescription": "List recent agent conversations from a Sentry organization.\n\nThe organization is auto-detected when omitted.\n\nExamples:\n sentry agent-conversation list # List recent agent conversations\n sentry agent-conversation list my-org # Explicit organization\n sentry agent-conversation list --limit 50 --period 24h # Show more, last 24 hours\n sentry agent-conversation list -q \"has:errors\" # Filter ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation view
3: *
4: * View the transcript of a specific agent conversation.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { getConversationSpans } from "../../lib/api-client.js";
9: import { buildCommand } from "../../lib/command.js";
10: import { ContextError } from "../../lib/errors.js";
11: import {
12: buildTranscriptResult,
13: formatTranscriptResult,
14: type TranscriptResult,
15: } from "../../lib/formatters/conversation.js";
16: import { CommandOutput } from "../../lib/formatters/output.js";
17: import {
18: applyFreshFlag,
19: FRESH_ALIASES,
20: FRESH_FLAG,
21: } from "../../lib/list-command.js";
22: import { withProgress } from "../../lib/polling.js";
23: import { resolveOrg } from "../../lib/resolve-target.js";
24:
25: type ViewFlags = {
26: readonly json: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/agent-conversation/view.test.ts</path>
<type>file</type>
<content>
1: /**
2: * Conversation View Command Tests
3: *
4: * Tests for the `sentry agent-conversation view` command func() body, covering:
5: * - Resolving org + conversationId from a single `<org>/<conversation-id>` arg
6: * - Resolving org via resolveOrg when only the conversation-id is given
7: * - Throwing error when no args provided
8: * - Throwing ContextError when org cannot be resolved
9: * - Yielding CommandOutput with transcript result
10: * - Setting truncated flag from API response
11: *
12: * Uses spyOn mocking to avoid real HTTP calls or database access.
13: */
14:
15: import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
16: import { viewCommand } from "../../../src/commands/agent-conversation/view.js";
17:
18: vi.mock("../../../src/lib/api-client.js", async (importOriginal) => {
19: const actual =
20: ...
Checked 15 files in 2s. No fixes applied.
19 /tmp/opencode/proguard-fragment-base.md 37 /tmp/opencode/proguard-reference-base.md 56 total
<path>/tmp/opencode/proguard-fragment-base.md</path> <type>file</type> <content> 1: 2: 3: ## Examples 4: 5: ```bash 6: # Compute the UUID for a ProGuard/R8 mapping file 7: sentry proguard uuid ./app/build/outputs/mapping/release/mapping.txt 8: 9: # Output as JSON (includes the file path) 10: sentry proguard uuid mapping.txt --json 11: ``` 12: 13: ## Important Notes 14: 15: - The UUID is **deterministically derived from the mapping file contents** — 16: identical files always produce the same UUID. This is the same value 17: Sentry uses to associate a mapping with obfuscated Android stack traces. 18: - This matches the UUID computed by the legacy `sentry-cli proguard uuid` 19: command byte-for-byte. (End of file - total 19 lines) </content>
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation list
3: *
4: * List recent agent conversations from Sentry projects.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { listConversations } from "../../lib/api-client.js";
9: import { validateLimit } from "../../lib/arg-parsing.js";
10: import {
11: advancePaginationState,
12: buildPaginationContextKey,
13: hasPreviousPage,
14: resolveCursor,
15: } from "../../lib/db/pagination.js";
16: import { ContextError } from "../../lib/errors.js";
17: import { formatConversationTable } from "../../lib/formatters/conversation.js";
18: import { filterFields } from "../../lib/formatters/json.js";
19: import { CommandOutput } from "../../lib/formatters/output.js";
20: import { getPositionalString } from "../../lib/introspect.js";
21: import {
22: buildListCommand,
23: ...
ARG=<conv-123> .env.local not found. Continuing without it. .env.local not found. Continuing without it. .env.local not found. Continuing without it. .env.local not found. Continuing without it. Error: API request failed: 403 Forbidden Endpoint: /organizations/1/agents/conversations/conv-123/ You do not have p code=30 ARG=<my-org/conv-123> .env.local not found. Continuing without it. .env.local not found. Continuing without it. .env.local not found. Continuing without it. .env.local not found. Continuing without it. Error: API request failed: 403 Forbidden Endpoint: /organizations/my-org/agents/conversations/conv-123/ You do not h code=30 ARG=< my-org/conv-123 > .env.local not found. Continuing without it. .env.local not found. Continuing without it. .env.local not found. Continuing without it. .env.local not found. Continuing without it. ...
/**
* sentry agent-conversation view
*
* View the transcript of a specific agent conversation.
*/
import type { SentryContext } from "../../context.js";
import { getConversationSpans } from "../../lib/api-client.js";
import { buildCommand } from "../../lib/command.js";
import { ContextError } from "../../lib/errors.js";
import {
buildTranscriptResult,
formatTranscriptResult,
type TranscriptResult,
} from "../../lib/formatters/conversation.js";
import { CommandOutput } from "../../lib/formatters/output.js";
import {
applyFreshFlag,
FRESH_ALIASES,
FRESH_FLAG,
} from "../../lib/list-command.js";
import { withProgress } from "../../lib/polling.js";
import { resolveOrg } from "../../lib/resolve-target.js";
type ViewFlags = {
readonly json: boolean;
readonly fresh: boolean;
};
const USAGE_HINT = "sentry agent-conversation view [<org>/]<conversation-id>";
/**
* Split a `[<org>/]<conversation-id>` positional into its parts. ...
32 dfcceb584e52de2d477015a74dfe42ac1e26e5f44ede4bf5da2afc9e343179d8 - bbaa7b3b722b87f1bccfe84063269cbbcabe2741
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts:
Line 496: default: false,
Line 501: default: false,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts:
Line 142: default: false,
Line 148: default: DEFAULT_PERIOD,
Line 154: default: "100", // Logs are high-volume; 25 is too stingy for debugging
Line 167: default: "newest",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts:
Line 238: default: String(LIST_DEFAULT_LIMIT),
Line 250: default: "date" as const,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/status/show.ts:
Line 43: default: SENTRY_STATUS_PAGE_URL,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/init.ts:
Line 283: default: {
Line 324: brief: "Project directory (default: current directory)",
Line 362: ...
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/local/server.ts:
Line 733: default: String(DEFAULT_PORT),
Line 739: default: "localhost",
Line 744: default: false,
Line 758: default: "human",
Line 764: default: false,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/local/run.ts:
Line 371: default: String(DEFAULT_PORT),
Line 377: default: "localhost",
Line 390: default: false,
Line 397: default: "0",
Line 403: default: "human",
Line 408: default: false,
Line 719: default: {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/replay/view.ts:
Line 371: default: false,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/replay/list.ts:
Line 293: default: String(LIST_DEFAULT_LIMIT),
Line 313: default: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/init.ts</path>
<type>file</type>
<content>
300: "install the SDK, and configure Sentry.\n\n" +
301: "Supports org/project syntax and a directory positional. Path-like\n" +
302: "arguments (starting with . / ~) are treated as the directory;\n" +
303: "everything else is treated as the target.\n\n" +
304: "Examples:\n" +
305: " sentry init\n" +
306: " sentry init acme/\n" +
307: " sentry init acme/my-app\n" +
308: " sentry init my-app\n" +
309: " sentry init acme/my-app ./my-project\n" +
310: " sentry init ./my-project",
311: },
312: parameters: {
313: positional: {
314: kind: "tuple",
315: parameters: [
316: {
317: placeholder: "target",
318: brief: "<org>/<project>, <org>/, <project>, or a directory path",
319: parse: String,
320: optional: true,
321: },
322: ...
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts:
Line 496: default: false,
Line 501: default: false,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts:
Line 142: default: false,
Line 148: default: DEFAULT_PERIOD,
Line 154: default: "100", // Logs are high-volume; 25 is too stingy for debugging
Line 167: default: "newest",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts:
Line 238: default: String(LIST_DEFAULT_LIMIT),
Line 250: default: "date" as const,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/status/show.ts:
Line 43: default: SENTRY_STATUS_PAGE_URL,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/init.ts:
Line 283: default: {
Line 324: brief: "Project directory (default: current directory)",
Line 362: ...
Found 91 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/start.ts: Line 98: placeholder: "name", Line 103: placeholder: "org", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/list.ts: Line 221: placeholder: "org", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/log/view.ts: Line 514: placeholder: "org/project/log-id", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/log/list.ts: Line 732: placeholder: "org/project-or-trace-id", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts: Line 486: placeholder: "org/project/trace-id", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: Line 132: placeholder: "org/project/trace-id", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts: Line 226: placeholder: ...
0 33 apps/cli-docs/src/fragments/commands/agent-conversation.md 23 23 packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md 8 5 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md 3 3 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md 1 1 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md 2 2 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md 1 1 packages/cli/plugins/sentry-cli/sk...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/script/generate-skill-markdown.test.ts</path>
<type>file</type>
<content>
1: /** Tests for generated command-heading and example association parsing. */
2:
3: import { readFile } from "node:fs/promises";
4: import { describe, expect, test } from "vitest";
5: import {
6: extractCommandPathFromHeading,
7: formatCommandExamples,
8: matchExampleToCommand,
9: } from "../../script/generate-skill-markdown.js";
10: import { listCommand } from "../../src/commands/agent-conversation/list.js";
11: import { viewCommand } from "../../src/commands/agent-conversation/view.js";
12: import { buildCommandInfo } from "../../src/lib/introspect.js";
13:
14: describe("extractCommandPathFromHeading", () => {
15: test.each([
16: ["`sentry issue view <issue-id>`", "sentry issue view"],
17: [
18: "`sentry project create [<org>/]<name>:<platform>...`",
19: "sentry project create",
20: ],
21: ["`sentry auth ...
/** Tests for generated command-heading and example association parsing. */
import { readFile } from "node:fs/promises";
import { describe, expect, test } from "vitest";
import {
extractCommandPathFromHeading,
matchExampleToCommand,
} from "../../script/generate-skill-markdown.js";
describe("extractCommandPathFromHeading", () => {
test.each([
["`sentry issue view <issue-id>`", "sentry issue view"],
[
"`sentry project create [<org>/]<name>:<platform>...`",
"sentry project create",
],
["`sentry auth status`", "sentry auth status"],
])("extracts the command path from %s", (heading, expected) => {
expect(extractCommandPathFromHeading(heading)).toBe(expected);
});
test("ignores descriptive headings", () => {
expect(extractCommandPathFromHeading("Create a project")).toBeUndefined();
});
});
describe("matchExampleToCommand", () => {
test("associates a project create block with its command", () => {
const code = [
"# Create ...
Found 29 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/sdk.generated.ts:
Line 1929: "agent-conversation": {
Line 1932: invoke<AgentConversationListResult>(["agent-conversation","list"], { limit: params?.limit, query: params?.query, period: params?.period, cursor: params?.cursor }, params?.org ? [params.org] : []) as Promise<AgentConversationListResult>,
Line 1935: invoke<unknown>(["agent-conversation","view"], {}, params?.orgConversationId ? [params.orgConversationId] : []) as Promise<unknown>,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/complete.ts:
Line 132: "agent-conversation list",
Line 133: "agent-conversation view",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts:
Line 2: * sentry agent-conversation view
Line 31: const USAGE_HINT = `sentry agent-conversation view ${USAGE}`;
Line 71: command: "sentry agent-conversation view conv-123",
Line 75: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/index.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation
3: *
4: * List and view agent conversations from Sentry Explore.
5: */
6:
7: import { buildRouteMap } from "../../lib/route-map.js";
8: import { listCommand } from "./list.js";
9: import { viewCommand } from "./view.js";
10:
11: export const conversationRoute = buildRouteMap({
12: routes: {
13: list: listCommand,
14: view: viewCommand,
15: },
16: defaultCommand: "list",
17: docs: {
18: brief: "List and view agent conversations",
19: fullDescription:
20: "List and view agent conversations from Sentry Explore.\n\n" +
21: "Commands:\n" +
22: " list List recent agent conversations\n" +
23: " view View a conversation transcript\n",
24: hideRoute: {},
25: },
26: });
(End of file - total 26 lines)
</content>
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
USAGE
sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>]
sentry agent-conversation view [--fresh] [--json] [--fields value] <org/conversation-id>
sentry agent-conversation --help
List and view agent conversations from Sentry Explore.
Commands:
list List recent agent conversations
view View a conversation transcript
FLAGS
-h --help Print help information and exit
-- All subsequent inputs should be interpreted as arguments
COMMANDS
list List recent agent conversations
view View an agent conversation transcript
exit=0
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts</path>
<type>file</type>
<content>
1: #!/usr/bin/env tsx
2: /**
3: * Validate doc fragment files.
4: *
5: * Ensures fragment files stay consistent with the CLI route tree:
6: * 1. Every route has a corresponding fragment file (+ index.md)
7: * 2. Every fragment file corresponds to an existing route (or is index.md)
8: * 3. Fragment files don't accidentally contain frontmatter or the generated marker
9: * 4. Top-level fragments (e.g., configuration.md) exist
10: * 5. Fragment content covers all subcommands in a route (warnings only)
11: *
12: * Usage:
13: * tsx script/check-fragments.ts # Warnings for missing subcommands
14: * tsx script/check-fragments.ts --strict # Errors for missing subcommands
15: */
16:
17: import { mkdirSync, readdirSync } from "node:fs";
18: import { access, readFile, writeFile } from "node:fs/promises";
19: import type { RouteInfo, RouteMap ...
Found 1 matches /home/byk/Code/getsentry/cli-pr-1558/.github/workflows/ci.yml: Line 188: run: pnpm run check:fragments
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
1 subcommand coverage warning(s):
⚠ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
All 37 command fragment files valid (36 routes + index)
All 1 top-level fragment(s) valid
14:### `sentry proguard upload <path...>` 20:- `--no-upload - Compute and print UUIDs without uploading (dry-run)` 27:**Examples:**
<path>/tmp/opencode/proguard-reference-base.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-proguard 3: version: 0.45.0-dev.0 4: description: Work with ProGuard/R8 mapping files 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Proguard Commands 11: 12: Work with ProGuard/R8 mapping files 13: 14: ### `sentry proguard upload <path...>` 15: 16: Upload ProGuard/R8 mapping files to Sentry 17: 18: **Flags:** 19: - `--uuid <value> - Force a specific UUID instead of computing from file content (only valid with a single file)` 20: - `--no-upload - Compute and print UUIDs without uploading (dry-run)` 21: - `--require-one - Require at least one mapping file (error if none provided)` 22: 23: ### `sentry proguard uuid <path>` 24: 25: Compute the UUID for a ProGuard mapping file 26: 27: **Examples:** 28: 29: ```bash 30: # Compute the UUID for a ProGuard/R8 mapping file 31: sentry proguard uuid ./app/build/outputs/mapping/release/mapping.txt 32: 33: # ...
-### `sentry agent-conversation list <org>` +### `sentry agent-conversation list [<org>]` -### `sentry agent-conversation view <org/conversation-id>` +### `sentry agent-conversation view [<org>/]<conversation-id>` -### `sentry alert issues list <org/project>` +### `sentry alert issues list [<org/project>]` -### `sentry alert issues create <target>` +### `sentry alert issues create [<target>]` -### `sentry alert metrics list <target>` +### `sentry alert metrics list [<target>]` -### `sentry cli completion <shell>` +### `sentry cli completion [<shell>]` -### `sentry cli upgrade <version>` +### `sentry cli upgrade [<version>]` -### `sentry explore <target>` +### `sentry explore [<target>]` -### `sentry feedback list <org/project>` +### `sentry feedback list [<org/project>]` -### `sentry init <target> <directory>` +### `sentry init [<target>] [<directory>]` -### `sentry issue list <org/project>` +### `sentry issue list [<org/project>]` -### `sentry monitor list <org/project>` +### `sentry ...
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework
RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli
Test Files 1 passed (1)
Tests 20 passed (20)
Start at 10:07:10
Duration 7.55s (transform 5.24s, setup 96ms, import 6.89s, tests 370ms, environment 0ms)
/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 /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/bench/helpers.test.ts
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework
RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli
Test Files 4 passed (4)
Tests 79 passed (79)
Start at 10:07:46
Duration 10.74s (transform 14.34s, setup 201ms, import 25.94s, tests 1.37s, environment 1ms)
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/help-positional.test.ts</path>
<type>file</type>
<content>
1: /**
2: * Tests for help-as-positional-arg error recovery in buildCommand.
3: *
4: * When a command throws a CliError and a positional arg was `"help"`,
5: * the buildCommand wrapper recovers by showing the command's help
6: * instead of the confusing error.
7: *
8: * This only fires as error recovery — if a command successfully resolves
9: * a legitimate value like a project named "help", the recovery never runs.
10: *
11: * Tests run commands through Stricli's `run()` with `help` as a positional
12: * and verify help output is shown when resolution fails.
13: */
14:
15: import { generateHelpTextForAllCommands, run } from "@stricli/core";
16: import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
17: import { app } from "../../src/app.js";
18: import type { SentryContext } from "../../src/context.js";
19: import { mockFetch, ...
No files found
generated_tracked_diff=0 skill_diff_vs_worktree_before_unknown=1
518a0d014ae69488bbfccb940f2f598eb91dfed2f1aa6c42ef72b3ca4c60d737 - dfcceb584e52de2d477015a74dfe42ac1e26e5f44ede4bf5da2afc9e343179d8 -
(no output)
{
"tupleObjects": 44,
"optionalTupleParams": 11,
"files": 10,
"arrayObjects": 33
}
src/commands/agent-conversation/list.ts:67 src/commands/cli/completion.ts:42 src/commands/cli/upgrade.ts:891 src/commands/feedback/list.ts:158 src/commands/init.ts:316 src/commands/init.ts:322 src/commands/org/view.ts:44 src/commands/project/view.ts:279 src/commands/release/deploy.ts:114 src/commands/replay/list.ts:280 src/commands/trace/list.ts:225
0
<path>/tmp/opencode/all-help-fields.json</path>
<type>file</type>
<content>
1: {}
(End of file - total 1 lines)
</content>
24 sentry alert issues list :: [<org/project>] sentry alert issues create :: [<target>] sentry alert metrics list :: [<target>] sentry cli completion :: [<shell>] sentry cli upgrade :: [<version>] sentry agent-conversation list :: [<org>] sentry agent-conversation view :: [<org>/]<conversation-id> sentry org view :: [<org>] sentry project create :: [<org>/]<name>:<platform>... sentry project list :: [<org/project>] sentry project view :: [<org/project>] sentry replay list :: [<org/project>] sentry release list :: [<org/project>] sentry release deploy :: <org/version> <environment> [<name>] sentry repo list :: [<org/project>] sentry team list :: [<org/project>] sentry issue list :: [<org/project>] sentry explore :: [<target>] sentry feedback list :: [<org/project>] sentry monitor list :: [<org/project>] sentry trace list :: [<org/project>] sentry trial list :: [<org>] sentry trial start :: <name> [<org>] sentry init :: [<target>] [<directory>]
sentry agent-conversation list ["# List recent agent conversations\nsentry agent-conversation list","# Explicit organization\nsentry agent-conversation list my-org","# Show more, last 24 hours\nsentry agent-conversation list --limit 50 --period 24h","# Filter conversations\nsentry agent-conversation list -q \"has:errors\"","# Paginate through results\nsentry agent-conversation list my-org -c next"] "[<org>]" sentry agent-conversation view ["# View full transcript (organization auto-detected)\nsentry agent-conversation view conv-123","# Explicit organization\nsentry agent-conversation view my-org/conv-123","# JSON output\nsentry agent-conversation view my-org/conv-123 --json"] "[<org>/]<conversation-id>"
DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework
RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli
Test Files 8 passed (8)
Tests 51 passed | 3 skipped (54)
Start at 10:11:28
Duration 6.18s (transform 3.24s, setup 347ms, import 4.51s, tests 3.99s, environment 2ms)
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/proguard.md</path> <type>file</type> <content> 1: --- 2: title: proguard 3: description: Proguard commands for the Sentry CLI 4: --- 5: 6: Work with ProGuard/R8 mapping files 7: 8: ## Commands 9: 10: ### `sentry proguard upload <path...>` 11: 12: Upload ProGuard/R8 mapping files to Sentry 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<path...>]` | Paths to ProGuard/R8 mapping files | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `--uuid <uuid>` | Force a specific UUID instead of computing from file content (only valid with a single file) | 25: | `--no-upload` | Compute and print UUIDs without uploading (dry-run) | 26: | `--require-one` | Require at least one mapping file (error if none provided) | 27: 28: ### `sentry proguard uuid <path>` 29: 30: Compute the UUID for a ProGuard mapping file 31: 32: ...
RUN v4.1.10 /home/byk/Code/getsentry/cli-pr-1558/packages/cli DEPRECATED `test.poolOptions` was removed in Vitest 4. All previous `poolOptions` are now top-level options. Please, refer to the migration guide: https://vitest.dev/guide/migration#pool-rework [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=new [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-proj [debug] [compat-flags] --org flag → SENTRY_ORG=my-org [debug] [compat-flags] --project flag → SENTRY_PROJECT=my-project [debug] [compat-flags] --org flag → SENTRY_ORG=new-org [debug] [compat-flags] --org flag → SENTRY_ORG=sentry [debug] [compat-flags] --project flag → SENTRY_PROJECT=cli [debug] [compat-flags] --org flag → ...
bbaa7b3b722b87f1bccfe84063269cbbcabe2741 dfcceb584e52de2d477015a74dfe42ac1e26e5f44ede4bf5da2afc9e343179d8 - 32
!! apps/cli-docs/public/.well-known/skills/index.json !! apps/cli-docs/src/content/docs/commands/ !! packages/cli/src/generated/skill-content.ts
Found 20 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts:
Line 976: interface TypedCommandPositionalParameters_<ARGS extends BaseArgs, CONTEXT extends CommandContext> {
Line 980: readonly positional: TypedPositionalParameters<ARGS, CONTEXT>;
Line 982: type TypedCommandPositionalParameters<ARGS extends BaseArgs, CONTEXT extends CommandContext> = [] extends ARGS ? Partial<TypedCommandPositionalParameters_<ARGS, CONTEXT>> : TypedCommandPositionalParameters_<ARGS, CONTEXT>;
Line 986: type TypedCommandParameters<FLAGS extends BaseFlags, ARGS extends BaseArgs, CONTEXT extends CommandContext> = TypedCommandFlagParameters<FLAGS, CONTEXT> & TypedCommandPositionalParameters<ARGS, CONTEXT>;
Line 995: readonly positional?: PositionalParameters;
Line 998: interface BasePositionalParameter<T, CONTEXT extends CommandContext> extends ParsedParameter<T, CONTEXT> {
Line 1014: interface RequiredPositionalParameter<T, ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.d.ts</path>
<type>file</type>
<content>
990: * internally and should only be used after the types are checked.
991: */
992: interface CommandParameters {
993: readonly flags?: FlagParameters;
994: readonly aliases?: Aliases<string>;
995: readonly positional?: PositionalParameters;
996: }
997:
998: interface BasePositionalParameter<T, CONTEXT extends CommandContext> extends ParsedParameter<T, CONTEXT> {
999: /**
1000: * In-line documentation for this parameter.
1001: */
1002: readonly brief: string;
1003: /**
1004: * String that serves as placeholder for the value in the generated usage line.
1005: * Defaults to "argN" where N is the index of this parameter.
1006: */
1007: readonly placeholder?: string;
1008: /**
1009: * Default input value if one is not provided at runtime.
1010: */
1011: readonly default?: ...
apps/cli-docs/src/fragments/commands/agent-conversation.md packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md packages/cli/plugins/sentry-cli/skills/sentry-cli/references/repo.md packages/cli/plugins/sentry-cli/skil...
No files found
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core</path> <type>directory</type> <entries> dist/ package.json README.md (3 entries) </entries>
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist</path> <type>directory</type> <entries> index.cjs index.d.cts index.d.ts index.js (4 entries) </entries>
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 2001: const { brief, fullDescription, customUsage } = docs;
Line 2005: if (customUsage) {
Line 2006: for (const usage of customUsage) {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1970: const argName = args.ansiColor ? `\x1B[1m${name}...\x1B[22m` : `${name}...`;
1971: const brief = args.ansiColor ? `\x1B[3m${positional.parameter.brief}\x1B[23m` : positional.parameter.brief;
1972: return formatRowsWithColumns([[argName, brief]], [" "]);
1973: }
1974: const { keywords } = args.text;
1975: const atLeastOneOptional = positional.parameters.some((def) => def.optional);
1976: return formatRowsWithColumns(
1977: positional.parameters.map((def, i) => {
1978: let name = def.placeholder ?? `arg${i + 1}`;
1979: let suffix;
1980: if (def.optional) {
1981: name = `[${name}]`;
1982: } else if (atLeastOneOptional) {
1983: name = ` ${name}`;
1984: }
1985: if (def.default) {
1986: const defaultKeyword = args.ansiColor ? `\x1B[2m${keywords.default}\x1B[22m` : ...
Found 1 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 1798: function formatUsageLineForParameters(parameters, args) {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
1785: }
1786: function wrapVariadicFlag(text) {
1787: return `${text}...`;
1788: }
1789: function wrapRequiredParameter(text) {
1790: return `<${text}>`;
1791: }
1792: function wrapOptionalParameter(text) {
1793: return `[<${text}>]`;
1794: }
1795: function wrapVariadicParameter(text) {
1796: return `<${text}>...`;
1797: }
1798: function formatUsageLineForParameters(parameters, args) {
1799: const flagsUsage = Object.entries(parameters.flags ?? {}).filter(([, flag]) => {
1800: if (flag.hidden) {
1801: return false;
1802: }
1803: if (args.config.onlyRequiredInUsageLine && isOptionalAtRuntime(flag)) {
1804: return false;
1805: }
1806: return true;
1807: }).map(([name, flag]) => {
1808: let displayName = args.config.caseStyle === "convert-camel-to-kebab" ? ...
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md index 8422018c2..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -349,36 +349,36 @@ Authenticate with Sentry → Full flags and examples: `references/auth.md` ### Org Work with Sentry organizations - `sentry org list` — List organizations -- `sentry org view <org>` — View details of an organization +- `sentry org view [<org>]` — View details of an organization → Full flags and examples: `references/org.md` ### Project Work with Sentry projects - `sentry project create [<org>/]<name>:<platform>...` — Create one or more projects - `sentry project delete <org/project>` — Delete a project -- `sentry project list <org/project>` — List projects -- `sentry project view <org/project>` — View details of a project +- `sentry project list ...
Found 17 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/api/projects.ts:
Line 588: export function resolveOrgDisplayName(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/init/preflight.ts:
Line 527: async function resolveOrgSlug(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/init/org-prefetch.ts:
Line 50: export function resolveOrgPrefetched(cwd: string): Promise<OrgResult> {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/org-list.ts:
Line 1048: async function resolveOrgSlugMatch(
Line 1082: async function resolveOrgInParsed(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/resolve-target.ts:
Line 264: export async function resolveOrgFromDsn(
Line 1298: export async function resolveOrgAndProject(
Line 1653: export async function resolveOrgProjectOrGuide(
Line 1673: export async function resolveOrg(
Line 1877: export async function resolveOrgsForListing(
Line 1951: export async function ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/resolve-target.ts</path>
<type>file</type>
<content>
1650: *
1651: * @throws {ContextError} When the target cannot be resolved or chosen.
1652: */
1653: export async function resolveOrgProjectOrGuide(
1654: options: ResolveOptions
1655: ): Promise<ResolvedTarget> {
1656: const resolved = await resolveOrgAndProject(options);
1657: return resolved ?? (await guideOrgProjectFailure(options));
1658: }
1659:
1660: /**
1661: * Resolve organization only from multiple sources.
1662: *
1663: * Resolution priority:
1664: * 1. Positional argument
1665: * 2. SENTRY_ORG / SENTRY_PROJECT env vars
1666: * 3. `.sentryclirc` config file
1667: * 4. Config defaults
1668: * 5. ...
> sentry@0.45.0-dev.0 check:fragments /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> pnpm tsx script/check-fragments.ts -- --strict
> sentry@0.45.0-dev.0 tsx /home/byk/Code/getsentry/cli-pr-1558/packages/cli
> tsx --env-file-if-exists=.env.local --import ./script/require-shim.mjs script/check-fragments.ts -- --strict
.env.local not found. Continuing without it.
.env.local not found. Continuing without it.
Found 1 fragment validation error(s):
✗ Fragment missing subcommand coverage: ../../apps/cli-docs/src/fragments/commands/proguard.md
Not documented: upload
Hint: add a heading or code example for each (e.g., "sentry proguard upload")
ELIFECYCLE Command failed with exit code 1.
ELIFECYCLE Command failed with exit code 1.
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/agent-conversation.md</path> <type>file</type> <content> 1: --- 2: title: agent-conversation 3: description: Agent-conversation commands for the Sentry CLI 4: --- 5: 6: List and view agent conversations 7: 8: ## Commands 9: 10: ### `sentry agent-conversation list [<org>]` 11: 12: List recent agent conversations 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<org>]` | Organization slug | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-n, --limit <limit>` | Number of conversations (1-1000) (default: "25") | 25: | `-q, --query <query>` | Search query | 26: | `-t, --period <period>` | Time range: "7d", "2026-08-01..2026-09-01", ">=2026-08-01" (default: "7d") | 27: | `-f, --fresh` | Bypass cache, re-detect projects, and fetch fresh data | 28: | `-c, --cursor <cursor>` | Navigate pages: "next", "prev", "first" ...
Found 12 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js:
Line 1072: commands: "COMMANDS",
Line 1082: helpAll: "Print help information (including hidden commands/flags) and exit",
Line 1631: function generateHelpTextForAllCommands({ root, defaultText, config }, locale) {
Line 1641: const commands = [];
Line 1643: commands.push([[config.name], root, []]);
Line 1645: commands.push(...iterateAllCommands(root, [config.name], config.documentation.caseStyle));
Line 1647: return commands.map(([route, command, aliases]) => {
Line 1798: function formatUsageLineForParameters(parameters, args) {
Line 2016: yield ` ${formatUsageLineForParameters(parameters, args)}`;
Line 2117: return formatUsageLineForParameters(builderArgs.parameters, args);
Line 2166: yield args.ansiColor ? `\x1B[4m${headers.commands}\x1B[24m` : headers.commands;
Line 2326: generateHelpTextForAllCommands,
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/node_modules/@stricli/core/dist/index.js</path>
<type>file</type>
<content>
2080: if (flag.variadic.length < 1) {
2081: throw new InternalError(
2082: `Unable to use "" as variadic separator for --${internalFlagName} as it is empty`
2083: );
2084: }
2085: if (/\s/.test(flag.variadic)) {
2086: throw new InternalError(
2087: `Unable to use "${flag.variadic}" as variadic separator for --${internalFlagName} as it contains whitespace`
2088: );
2089: }
2090: }
2091: }
2092: }
2093: function buildCommand(builderArgs) {
2094: const { flags = {}, aliases = {} } = builderArgs.parameters;
2095: checkForReservedFlags(flags, ["help", "helpAll", "help-all"]);
2096: checkForReservedAliases(aliases, ["h"]);
2097: checkForNegationCollisions(flags);
2098: checkForInvalidVariadicSeparators(flags);
2099: let loader;
2100: if ("func" in builderArgs) ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/proguard/upload.ts</path>
<type>file</type>
<content>
160: "Usage:\n" +
161: " sentry proguard upload mapping.txt\n" +
162: " sentry proguard upload build/mapping1.txt build/mapping2.txt\n" +
163: " sentry proguard upload mapping.txt --uuid 5db7294d-87fc-5726-a5c0-4a90679657a5\n" +
164: " sentry proguard upload mapping.txt --no-upload\n" +
165: " sentry proguard upload mapping.txt --json",
166: },
167: output: {
168: human: formatUploadResult,
169: },
170: parameters: {
171: positional: {
172: kind: "array",
173: parameter: {
174: brief: "Paths to ProGuard/R8 mapping files",
175: parse: String,
176: placeholder: "path",
177: },
178: },
179: flags: {
180: uuid: {
181: kind: "parsed",
182: parse: String,
183: brief:
184: "Force a specific UUID instead of computing from file ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/proguard/upload.ts</path>
<type>file</type>
<content>
140: }
141: seen.set(m.uuid, m.path);
142: unique.push(m);
143: }
144: return unique;
145: }
146:
147: // ── Command ─────────────────────────────────────────────────────────
148:
149: export const uploadCommand = buildCommand({
150: // Auth is not required for --no-upload (dry-run mode).
151: // The upload path calls resolveOrgAndProject which triggers auth.
152: auth: false,
153: docs: {
154: brief: "Upload ProGuard/R8 mapping files to Sentry",
155: fullDescription:
156: "Upload one or more ProGuard/R8 mapping files to Sentry using " +
157: "the chunk-upload protocol. Each mapping is identified by a " +
158: "deterministic UUID derived from its content.\n\n" +
159: "Org/project are auto-detected from DSN, env vars, or config defaults.\n\n" +
160: "Usage:\n" +
161: " sentry proguard upload ...
(no output)
bbaa7b3b722b87f1bccfe84063269cbbcabe2741 dfcceb584e52de2d477015a74dfe42ac1e26e5f44ede4bf5da2afc9e343179d8 - 32
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
860: // Show help as recovery instead of the confusing error.
861: const recovered = await maybeRecoverWithHelp(
862: err,
863: stdout,
864: this as unknown as {
865: commandPrefix?: readonly string[];
866: stderr: Writer;
867: },
868: args
869: );
870: if (recovered) {
871: return;
872: }
873:
874: handleOutputError(err);
875: }
876: };
877:
878: // Build the command with the wrapped function via Stricli.
879: // The cast is necessary because we modify both `parameters` (injecting
880: // hidden flags) and `func` (wrapping with telemetry/output logic),
881: // which breaks the original FLAGS/ARGS type alignment that Stricli's
882: // `CommandBuilderArguments` enforces via `NoInfer`.
883: const cmd = stricliCommand({
884: ...builderArgs,
885: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts</path>
<type>file</type>
<content>
313: /**
314: * Extract all visible subcommands from a route group.
315: *
316: * @param routeMap - The route map to introspect
317: * @param routeName - Parent route name (e.g. "issue")
318: * @param docExamples - Optional examples loaded from documentation
319: */
320: export function extractRouteGroupCommands(
321: routeMap: RouteMap,
322: routeName: string,
323: docExamples: Map<string, string[]> = new Map()
324: ): CommandInfo[] {
325: const commands: CommandInfo[] = [];
326:
327: for (const subEntry of routeMap.getAllEntries()) {
328: if (subEntry.hidden) {
329: continue;
330: }
331:
332: const subTarget = subEntry.target;
333: if (isCommand(subTarget)) {
334: const path = `sentry ${routeName} ${subEntry.name.original}`;
335: const examples = docExamples.get(path) ?? [];
336: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/content/docs/commands/project.md</path> <type>file</type> <content> 1: --- 2: title: project 3: description: Project commands for the Sentry CLI 4: --- 5: 6: Work with Sentry projects 7: 8: ## Commands 9: 10: ### `sentry project create [<org>/]<name>:<platform>...` 11: 12: Create one or more projects 13: 14: **Arguments:** 15: 16: | Argument | Description | 17: |----------|-------------| 18: | `[<name:platform...>]` | One or more project name and platform pairs | 19: 20: **Options:** 21: 22: | Option | Description | 23: |--------|-------------| 24: | `-t, --team <team>` | Team to create the project under | 25: | `-n, --dry-run` | Show what would happen without making changes | 26: 27: ### `sentry project delete <org/project>` 28: 29: Delete a project 30: 31: **Arguments:** 32: 33: | Argument | Description | 34: |----------|-------------| 35: | `<org/project>` | <org>/<project> or <project> ...
diff_quiet=1 dfcceb584e52de2d477015a74dfe42ac1e26e5f44ede4bf5da2afc9e343179d8 - 32
No files found
Found 34 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts:
Line 70: | { kind: "array"; parameter: PositionalParam };
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/feedback.ts:
Line 41: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/defaults.ts:
Line 308: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts:
Line 484: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts:
Line 130: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/build/upload.ts:
Line 178: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/view.ts:
Line 384: kind: "array",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts:
Line 575: kind: ...
Found 2 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts:
Line 133: expect(result).toBe("<command...>");
Line 141: expect(result).toBe("<args...>");
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts</path>
<type>file</type>
<content>
100:
101: test("returns tuple placeholders", () => {
102: const result = getPositionalString({
103: kind: "tuple",
104: parameters: [{ placeholder: "org" }, { placeholder: "project" }],
105: });
106: expect(result).toBe("<org> <project>");
107: });
108:
109: test("wraps optional tuple placeholders in brackets", () => {
110: const result = getPositionalString({
111: kind: "tuple",
112: parameters: [
113: { placeholder: "required" },
114: { placeholder: "optional", optional: true },
115: ],
116: });
117: expect(result).toBe("<required> [<optional>]");
118: });
119:
120: test("uses default arg names for tuple without placeholders", () => {
121: const result = getPositionalString({
122: kind: "tuple",
123: parameters: [{}, {}],
124: });
125: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path> <type>file</type> <content> 1: /** 2: * Command builder with telemetry, global flag injection, and output modes. 3: * 4: * Provides `buildCommand` — the standard command builder for all Sentry CLI 5: * commands. It wraps Stricli's `buildCommand` with: 6: * 7: * 1. **Automatic flag/arg telemetry** — captures flag values and positional 8: * arguments as Sentry span context for observability. 9: * 10: * 2. **Hidden global logging flags** — injects `--log-level` and `--verbose` 11: * into every command's parameters. These are intercepted before the original 12: * `func` runs: the logger level is set, and the injected flags are stripped 13: * so the original function never sees them. If a command already defines its 14: * own `--verbose` flag (e.g. `api` uses it for HTTP output), the injected 15: * one is skipped and the command's own value is used for both purposes. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
285: * Hidden `--project` flag injected into every command by {@link buildCommand}.
286: *
287: * Same backward-compatibility shim as `--org`. Written to `SENTRY_PROJECT`
288: * before the command's `func` runs.
289: */
290: const PROJECT_FLAG = {
291: kind: "parsed" as const,
292: parse: String,
293: brief: "Project slug",
294: optional: true as const,
295: hidden: true as const,
296: } as const;
297:
298: /** The flag key for the injected --log-level flag (always stripped) */
299: const LOG_LEVEL_KEY = "log-level";
300:
301: /**
302: * Apply logging flags parsed by Stricli.
303: *
304: * `--log-level` takes priority over `--verbose`. If neither is specified,
305: * the level is left as-is (env var or default). ...
Found 4 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts: Line 441: function prepareNativeDocs( Line 459: function attachDocumentationMetadata( Line 564: prepareNativeDocs(builderArgs.docs), Line 890: attachDocumentationMetadata(cmd, builderArgs.docs);
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
410: ...FIELDS_FLAG,
411: brief: `${FIELDS_FLAG.brief}. Available: ${fieldNames}`,
412: };
413: }
414:
415: /**
416: * Enrich command docs with a JSON fields section when a schema is registered.
417: * Appends available field names and types to `fullDescription` so they appear
418: * in Stricli's `--help` output.
419: */
420: function enrichDocsWithSchema(
421: docs: CommandDocumentation,
422: // biome-ignore lint/suspicious/noExplicitAny: OutputConfig type is erased at the builder level
423: outputConfig?: OutputConfig<any>
424: ): CommandDocumentation {
425: if (!outputConfig?.schema) {
426: return docs;
427: }
428: const schemaFields = extractSchemaFields(outputConfig.schema);
429: if (schemaFields.length === 0) {
430: return docs;
431: }
432: const jsonFieldsDoc = formatSchemaForHelp(schemaFields);
433: const baseFull = ...
M apps/cli-docs/src/fragments/commands/agent-conversation.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/alert.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/cli.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/explore.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/feedback.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/init.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/issue.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/monitor.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/org.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/project.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/release.md M packages/cli/plugins/sentry-cli/skills/sentry-cli/references/replay.md M ...
Operator nudge: please finish the exact-tree correctness review now. Return the required substantive findings/PASS report with exact HEAD and recomputed patch SHA-256, then end exactly MERGE or DO-NOT-MERGE. Do not modify any files or VCS/PR state.
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
65: const FRAGMENTS_ROOT = DOCS_FRAGMENTS;
66: const INDEX_PATH = `${DOCS_DIR}/index.md`;
67: const CONFIG_PATH = `${DOCS_CONTENT_DIR}/configuration.md`;
68:
69: /**
70: * Marker comment separating auto-generated reference content from
71: * hand-written custom content. Everything above this line is regenerated;
72: * everything below is preserved.
73: */
74: const GENERATED_END_MARKER = "<!-- GENERATED:END -->";
75:
76: /**
77: * Flag names that are auto-injected by the buildCommand wrapper and
78: * documented in the global footer rather than per-command. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
125: let desc = flag.brief;
126: // Only append default if the brief doesn't already mention it
127: if (
128: flag.default !== undefined &&
129: flag.kind !== "boolean" &&
130: !desc.includes("default:")
131: ) {
132: desc += ` (default: ${JSON.stringify(flag.default)})`;
133: }
134:
135: return `| \`${syntax}\` | ${desc} |`;
136: }
137:
138: /**
139: * Escape angle brackets in text so they render as literal `<` / `>`
140: * in HTML output rather than being interpreted as HTML tags.
141: */
142: function escapeAngleBrackets(text: string): string {
143: return text.replace(/</g, "<").replace(/>/g, ">");
144: }
145:
146: /** Format positional arguments as a markdown table */
147: function formatPositionalsTable(positionals: PositionalInfo[]): string {
148: if (positionals.length === 0) {
149: return "";
150: }
151: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry agent-conversation view
3: *
4: * View the transcript of a specific agent conversation.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { getConversationSpans } from "../../lib/api-client.js";
9: import { buildCommand } from "../../lib/command.js";
10: import { ContextError } from "../../lib/errors.js";
11: import {
12: buildTranscriptResult,
13: formatTranscriptResult,
14: type TranscriptResult,
15: } from "../../lib/formatters/conversation.js";
16: import { CommandOutput } from "../../lib/formatters/output.js";
17: import {
18: applyFreshFlag,
19: FRESH_ALIASES,
20: FRESH_FLAG,
21: } from "../../lib/list-command.js";
22: import { withProgress } from "../../lib/polling.js";
23: import { resolveOrg } from "../../lib/resolve-target.js";
24:
25: type ViewFlags = {
26: readonly json: ...
packages/cli/src/commands/agent-conversation/view.ts:47-57 splits only at the first slash and checks that both resulting strings are truthy. It therefore accepts targets such as:
my-org/conv-123/extramy-org//conv-123my-org/conv-123/The resulting slash-containing ID reaches getConversationSpans() through view.ts:110-123. This violates the contract that explicit targets contain exactly one slash and conversation IDs never contain /.
Fix: reject input when the first and last slash positions differ, then validate both segments. Add tests asserting malformed targets throw the canonical ContextError without calling the API.
pnpm run check:fragments -- --strict fails because apps/cli-docs/src/fragments/commands/proguard.md does not cover sentry proguard upload. Its examples remain embedded in packages/cli/src/commands/proguard/upload.ts:153-165 rather than structured docs.examples.
This failure concerns unchanged ProGuard content; the patch’s metadata skip can only remove coverage failures. It does not explain or excuse the parsing defect above.
CommandDocumentation preserves Stricli fields while retaining structured examples (command.ts:97-114, 441-471, 883-903).command.ts:441-455, 561-566).introspect.ts:286-310).introspect.ts:195-212; generate-command-docs.ts:146-162). ...### Current State - **Active task (September 9, 2026, started 09:26):** Independent adversarial correctness review of the exact uncommitted working-tree patch for getsentry/cli PR #1558. - **Repository:** `/home/byk/Code/getsentry/cli-pr-1558` - **Branch:** `fix/agent-conversation-reference-root-cause`, tracking deleted upstream `origin/pr-1558 [gone]`. - **Reviewed committed HEAD:** `bbaa7b3b72…
* 🔴 (12:53) User stated flags in `ALWAYS_STRIP` are always stripped, so the command never sees them. In `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:486-487`, `ALWAYS_STRIP = new Set([LOG_LEVEL_KEY])`. * 🔴 (12:53) User-provided code showed `GLOBAL_FLAG_DEFAULTS` contains `[LOG_LEVEL_KEY]: LOG_LEVEL_FLAG`, `verbose: VERBOSE_FLAG`, `org: ORG_FLAG`, and `project: PROJECT_F…
* 🟡 (12:53) Search found 4 documentation-related references in `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts`: `prepareNativeDocs(` at line 441, `attachDocumentationMetadata(` at line 459, `prepareNativeDocs(builderArgs.docs),` at line 564, and `attachDocumentationMetadata(cmd, builderArgs.docs);` at line 890.
Date: September 9, 2026 * 🟡 (10:24) `packages/cli/src/commands/proguard/upload.ts` configures `uploadCommand` with `auth: false` because `--no-upload` is a dry-run that does not require authentication; the actual upload path calls `resolveOrgAndProject`, which triggers authentication. Its docs state that org/project are auto-detected from DSN, environment variables, or config defaults. * 🟡 (10:…
Date: September 9, 2026 * 🟡 (10:16) Tool output reported identifier `bbaa7b3b722b87f1bccfe84063269cbbcabe2741`, SHA-256-like value `dfcceb584e52de2d477015a74dfe42ac1e26e5f44ede4bf5da2afc9e343179d8 -`, and value `32`. * 🟡 (10:17) Git ignored generated artifacts: `apps/cli-docs/public/.well-known/skills/index.json`, `apps/cli-docs/src/content/docs/commands/`, and `packages/cli/src/generated/skil…
Date: September 9, 2026 * 🟡 (10:12) Vitest `v4.1.10` run in `/home/byk/Code/getsentry/cli-pr-1558/packages/cli` passed exactly 8 test files and 51 tests, with 3 skipped out of 54, in `6.18s` (`transform 3.24s`, `setup 347ms`, `import 4.51s`, `tests 3.99s`, `environment 2ms`). It warned that `test.poolOptions` was removed in Vitest 4 and prior `poolOptions` fields are now top-level options. * 🟡 …
Date: September 9, 2026 * 🟡 (10:05) Running agent-conversation route help exited `0` after four `.env.local not found. Continuing without it.` notices. Usage rendered: `sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>]`; `sentry agent-conversation view [--fresh] [--json] [--fields value] <org/conversation-…
Date: September 9, 2026 * 🟡 (10:03) A checksum/version tool result reported `32`, SHA-256 `dfcceb584e52de2d477015a74dfe42ac1e26e5f44ede4bf5da2afc9e343179d8 -`, and revision `bbaa7b3b722b87f1bccfe84063269cbbcabe2741`. * 🟡 (10:03) `packages/cli/src/commands/init.ts` lines 300–344 document positional parsing: path-like arguments beginning with `.`, `/`, or `~` are directories, while everything el…
Date: September 9, 2026 * 🔴 (10:00) User stated agent conversation IDs are org-scoped and never contain `/`; unlike trace/replay IDs, they are not org/project-scoped. `[<org>/]<conversation-id>` therefore has at most one separator slash. * 🔴 (10:00) User stated the UUID for a ProGuard/R8 mapping file is deterministically derived from the mapping file contents; identical files always produce the…
🔴 (09:58) User provided `packages/cli/script/generate-skill.ts` lines 100–529. `SKILL_DESCRIPTION` is `"Guide for using the Sentry CLI to interact with Sentry from the command line. Use when the user asks about viewing issues, events, projects, organizations, making API calls, or authenticating with Sentry via CLI."`. 🔴 (09:58) `packages/cli/script/generate-skill.ts` defines preferred `ROUTE_O…
🔴 (09:57) User stated command hints live exclusively on the async generator return value (`CommandReturn`) and never on individual yields; non-streaming commands yield one `CommandOutput<T>`, streaming commands render each yield immediately, JSON-capable commands must yield one aggregate value when one parseable JSON document is required, and void commands may return without yielding. 🔴 (09:57…
🔴 (09:56) Subsequent help invocations successfully rendered command help for `sentry agent-conversation view [<org>/]<conversation-id>` and `sentry agent-conversation list [<org>]`, unlike the earlier failed top-level `sentry agent-conversation --help` invocation. 🔴 (09:56) Live help shows `sentry agent-conversation view` has alias `sentry agent-conversation show`; `-f` aliases `--fresh`; `-h, …
🔴 (09:48) Generated command documentation at `apps/cli-docs/src/content/docs/commands/agent-conversation.md` contains 80 lines and documents `sentry agent-conversation list [<org>]` and `sentry agent-conversation view [<org>/]<conversation-id>`. 🔴 (09:48) `sentry agent-conversation list [<org>]` is documented with options: `-n, --limit <limit>` for 1–1000 conversations (default `"25"`); `-q, --…
🔴 (09:46) Strict fragment validation via `pnpm tsx script/check-fragments.ts -- --strict` failed with exit code 1 because `../../apps/cli-docs/src/fragments/commands/proguard.md` lacks coverage for the `upload` subcommand; validator suggested adding a heading or code example such as `sentry proguard upload`. 🔴 (09:46) `packages/cli/src/lib/api/conversations.ts` documents the `/organizations/{or…
🔴 (09:43) Tool search returned 32 command files relevant to positional/default argument inspection: `packages/cli/src/commands/api.ts`, `packages/cli/src/commands/explore.ts`, `packages/cli/src/commands/init.ts`, `packages/cli/src/commands/agent-conversation/list.ts`, `packages/cli/src/commands/build/download.ts`, `packages/cli/src/commands/cli/completion.ts`, `packages/cli/src/commands/cli/upgr…
🔴 (09:41) `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md` has frontmatter `name: sentry-cli-agent-conversation`, `version: 0.45.0-dev.0`, description `"List and view agent conversations"`, requires binary `"sentry"`, and requires authentication. 🔴 (09:41) The agent-conversation reference documents `sentry agent-conversati…
🔴 (09:40) `packages/cli/src/commands/help.ts` documents four invocation modes: `sentry help` or bare `sentry` shows branded help with a banner; `sentry help <command>` shows detailed command help; `sentry help --json` emits the full command tree as structured JSON; `sentry help --json <command>` emits specific command/group metadata as JSON. 🔴 (09:40) `helpCommand` is built with `buildCommand({…
🔴 (09:39) `packages/cli/patches/@stricli%2Fcore@1.2.8.patch` adds `matchTopLevelFlag(input, topLevelFlags)`, supporting allow-listed `booleanFlags`, separate-value `valueFlags`, and inline `--flag=value` forms; it returns `{ takesValue, inlineValue }` or `null`. 🔴 (09:39) The patched Stricli route scanner accepts optional `scanner.topLevelFlags` at any route depth and forwards recognized flags …
🔴 (09:34) `packages/cli/src/commands/agent-conversation/list.ts` defines `listCommand` with `COMMAND_NAME = "agent-conversation list"`, `PAGINATION_KEY = "agent-conversation-list"`, `DEFAULT_PERIOD = "7d"`, and an optional positional `org`; the organization is resolved through `resolveOrg({ org: target, cwd })`, otherwise a `ContextError("Organization", USAGE_HINT)` is thrown. 🔴 (09:34) `packag…
🔴 (09:33) `packages/cli/script/generate-skill.ts` generates 3 artifact groups from Stricli route metadata and docs: `plugins/sentry-cli/skills/sentry-cli/SKILL.md`, per-route `plugins/sentry-cli/skills/sentry-cli/references/*.md`, and `docs/public/.well-known/skills/index.json`. 🔴 (09:33) `packages/cli/script/generate-skill.ts` bootstraps missing `src/generated/skill-content.ts` before dynamica…
🔴 (09:33) In `packages/cli/src/lib/command.ts`, `SentryCommandFunction` requires async generators returning `CommandReturn | void`; non-streaming commands yield one `CommandOutput<T>`, streaming commands render each yield immediately, JSON-capable streaming commands must yield one aggregate value when callers need one parseable JSON document because chunks are pretty-printed rather than JSONL, a…
🔴 (09:31) Review working tree was at HEAD `bbaa7b3b722b87f1bccfe84063269cbbcabe2741` on branch `fix/agent-conversation-reference-root-cause`, tracking deleted upstream `origin/pr-1558 [gone]`; the patch digest was `dfcceb584e52de2d477015a74dfe42ac1e26e5f44ede4bf5da2afc9e343179d8`. 🔴 (09:31) The uncommitted patch modified 32 files with 331 insertions and 170 deletions, spanning `apps/cli-docs/sr…
🔴 (09:29) User directive: Always preserve strict API output-mode and binary-safety contracts. `sentry api` must preserve `rawApiRequest()` status text; empty textual non-2xx bodies must fall back to HTTP status/request context; JSON mode must expose `{status, statusText, body}`; binary `Uint8Array` successes bypass formatters and remain raw; binary errors expose only status/content-type/byte-cou…
🔴 (09:28) Repository file `/home/byk/Code/getsentry/cli-pr-1558/.cursor/rules/ultracite.mdc` was not found. 🔴 (09:28) Repository contains `/home/byk/Code/getsentry/cli-pr-1558/.lore.md`. 🔴 (09:28) Root `/home/byk/Code/getsentry/cli-pr-1558/package.json` defines private ESM workspace package `toolkit-cli-workspace` version `0.0.0`, using `pnpm@10.11.0` and Node.js `>=20.0`. 🔴 (09:28) Root `pac…
🔴 (09:28) User stated `org view` and `project view` mirror `gh repo view`: they work from DSN-derived context or with an explicit argument. 🔴 (09:28) User stated `<project>` searches for a project by name across all accessible organizations. 🔴 (09:28) User requires using the `ContextError` class for missing-context errors. 🔴 (09:28) User stated commands run from `packages/cli`, or from the re…
🔴 (09:27) Repository instruction files found at `/home/byk/Code/getsentry/cli-pr-1558/AGENTS.md`, `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/AGENTS.md`, and `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/CONTRIBUTING.md`. 🔴 (09:27) Enumerated `package.json` files: `/home/byk/Code/getsentry/cli-pr-1558/package.json`, `/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/package.json`, …
🔴 (09:26) User stated the getsentry/cli PR #1558 working tree is at `/home/byk/Code/getsentry/cli-pr-1558`. 🔴 (09:26) User stated the committed HEAD is exactly `bbaa7b3b722b87f1bccfe84063269cbbcabe2741`. 🔴 (09:26) User stated the uncommitted patch SHA-256 was last verified as exactly `dfcceb584e52de2d477015a74dfe42ac1e26e5f44ede4bf5da2afc9e343179d8`. 🔴 (09:26) User requires substantive respon…