Dashboard › cli › Session 0NOyMxFfbiTn
0NOyMxFfbiTn5KWudPerform an independent, adversarial, READ-ONLY correctness review of the exact current worktree in /home/byk/Code/getsentry/cli-pr-1558 for getsentry/cli PR #1558. Do not edit files, mutate Git state, commit, stage, checkout, or push. The immutable review target is committed HEAD bbaa7b3b722b87f1bccfe84063269cbbcabe2741 plus the entire unstaged worktree diff whose SHA-256 from git diff | sha256sum is 092bd817573c1e0ea81e71472a9da2f38251dd6736331152b8325526527c3479. Verify that hash before reviewing and again before returning; if it differs, report BLOCKED with the observed hash.
Review every changed file and relevant surrounding implementation/tests. Focus on behavioral correctness, regressions, API/type contracts, Stricli command metadata and help behavior, optional tuple positional rendering, docs/skill generation and fallback behavior, fragment validation semantics, native and JSON help compatibility, agent-conversation list/view grammar, malformed target validation, error-class/field semantics, generated artifact consistency, and missing tests. Explicit grammar contract: agent-conversation view accepts a bare conversation ID with zero /, or <org>/<conversation-id> with exactly one /; neither segment may be empty and conversation IDs never contain /. Omitted input must remain ContextError; supplied malformed input must be a fielded ValidationError. List optional org usage must derive from Stricli metadata. Canonical structured examples must drive native help, JSON introspection, website docs, and skill docs while preserving legacy fallback for commands without metadata.
Validation already run on this exact tree: focused 6 files/155 tests passed; typecheck/generation passed and found 112 SDK commands; full rerun passed 452 files, 9,479 tests with 16 skipped; Biome passed 1,028 files; dependency check passed; non-strict fragment check passed with one unrelated pre-existing proguard upload warning. ...
bbaa7b3b722b87f1bccfe84063269cbbcabe2741 092bd817573c1e0ea81e71472a9da2f38251dd6736331152b8325526527c3479 -
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558</path> <type>directory</type> <entries> .craft.yml .git .github/ .gitignore .lore.md .nojekyll .npmrc AGENTS.md apps/ CHANGELOG.md codemods/ LICENSE.md node_modules/ package.json packages/ pnpm-lock.yaml pnpm-workspace.yaml README.md (18 entries) </entries>
<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. ...
File not found: /home/byk/Code/getsentry/cli/.agents
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 packages/cli/plugins/sentry-cli/skills/sentry-cli/references/repo.md M packag...
{"baseRefName":"main","commits":[{"authoredDate":"2026-09-08T14:36:48Z","authors":[{"email":"268751452+alicandayan@users.noreply.github.com","id":"U_kgDOEATSXA","login":"alicandayan","name":"alicandayan"}],"committedDate":"2026-09-08T14:36:48Z","messageBody":"","messageHeadline":"fix(docs): correct agent conversation argument syntax","oid":"bbaa7b3b722b87f1bccfe84063269cbbcabe2741"}],"files":[{"path":"apps/cli-docs/src/fragments/commands/agent-conversation.md","additions":6,"deletions":3,"changeType":"MODIFIED"},{"path":"packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md","additions":2,"deletions":2,"changeType":"MODIFIED"},{"path":"packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md","additions":8,"deletions":5,"changeType":"MODIFIED"},{"path":"packages/cli/src/commands/agent-conversation/list.ts","additions":1,"deletions":0,"changeType":"MODIFIED"},{"path":"packages/cli/src/commands/agent-conversation/view.ts","additions":1,"deletions":0,"change...
bd065083c3b82677747b97a6cc7f5cf57532d3bc 9d0901b10a154ae79220a9f99f463a024908ceb5 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 ...
9d0901b10a154ae79220a9f99f463a024908ceb5 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/agent-conversation.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/sen...
<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** - ...
Found 100 matches (more matches available) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/AGENTS.md: Line 14: - **Agent-friendly** - JSON output and predictable behavior for AI coding agents Line 35: > **Note**: Always check `package.json` for the latest scripts. All commands run Line 55: # Testing (Vitest) Line 56: pnpm run test:unit # Run unit tests Line 57: pnpm run test:e2e # Run e2e tests Line 58: pnpm exec vitest run test/lib/foo.test.ts # Run a single test file (skips generate steps) Line 59: pnpm exec vitest # Watch mode Line 74: Node — do not reintroduce `Bun.*` globals, `bun:test`, or `bun` CLI commands.) Line 85: | Find executable | `which` helper in `src/lib/which.ts` | Line 88: | Parse JSON file | `JSON.parse(await readFile(path, "utf-8"))` | Line 106: domain API modules — is generated from the route tree and lives in Line 110: current command list run `ls ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/AGENTS.md</path> <type>file</type> <content> 410: Reference template: `trace/list.ts`, `span/list.ts`, `dashboard/list.ts` 411: 412: ### ID Validation 413: 414: Use shared validators from `src/lib/hex-id.ts`: 415: - `validateHexId(value, label)` — 32-char hex IDs (trace IDs, log IDs). Auto-strips UUID dashes. 416: - `validateSpanId(value)` — 16-char hex span IDs. Auto-strips dashes. 417: - `validateTraceId(value)` — thin wrapper around `validateHexId` in `src/lib/trace-id.ts`. 418: 419: All normalize to lowercase. Throw `ValidationError` on invalid input. 420: 421: ### Sort Convention 422: 423: Use `"date"` for timestamp-based sort (not `"time"`). Export sort types from the API layer (e.g., `SpanSortValue` from `api/traces.ts`), import in commands. This matches `issue list`, `trace list`, and `span list`. ...
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
@@ -17,166 +17,178 @@
* 3. **Output mode injection** — when `output` has an {@link OutputConfig},
* `--json` and `--fields` flags are injected automatically. The command
* yields branded `CommandOutput` objects via {@link CommandOutput} and
* optionally returns a `{ hint }` footer via {@link CommandReturn}.
* Commands that define their own `json` flag keep theirs.
*
* ALL commands MUST use `buildCommand` from this module, NOT from
* `@stricli/core`. Importing directly from Stricli silently bypasses
* telemetry and global flag handling.
*
* ```
* Correct: import { buildCommand } from "../../lib/command.js";
* Incorrect: import { buildCommand } from "@stricli/core"; // skips everything! ...
<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, validationError } 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: ...
<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/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/src/lib/list-command.ts</path>
<type>file</type>
<content>
1: /**
2: * Shared building blocks for org-scoped list commands.
3: *
4: * Provides reusable Stricli parameter definitions (target positional, common
5: * flags, aliases) and a `buildOrgListCommand` factory for commands whose
6: * entire `func` body is handled by `dispatchOrgScopedList`.
7: *
8: * Level A — shared constants (used by all four list commands):
9: * LIST_TARGET_POSITIONAL, LIST_JSON_FLAG, LIST_CURSOR_FLAG,
10: * buildListLimitFlag, LIST_BASE_ALIASES
11: *
12: * Level B — full command builder (team / repo only):
13: * buildOrgListCommand
14: */
15:
16: import { createRequire } from "node:module";
17: import type { Aliases, Command, CommandContext } from "@stricli/core";
18: import type { SentryContext } from "../context.js";
19:
20: const _require = createRequire(import.meta.url);
21:
22: import { parseOrgProjectArg } from ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts</path>
<type>file</type>
<content>
701: flags: {
702: limit: buildListLimitFlag(config.entityPlural),
703: },
704: aliases: LIST_BASE_ALIASES,
705: },
706: async *func(
707: this: SentryContext,
708: flags: {
709: readonly limit: number;
710: readonly json: boolean;
711: readonly cursor?: string;
712: readonly fresh: boolean;
713: readonly fields?: string[];
714: },
715: target?: string
716: ) {
717: const { cwd } = this;
718: const parsed = parseOrgProjectArg(target);
719: const result = await dispatchOrgScopedList({
720: config,
721: cwd,
722: flags,
723: parsed,
724: orgSlugMatchBehavior: "redirect",
725: });
726: yield new CommandOutput(result);
727: // Only forward hint to the footer when items exist — empty results
728: ...
diff --git a/packages/cli/src/lib/introspect.ts b/packages/cli/src/lib/introspect.ts
index bf8c94f25..670b490d9 100644
--- a/packages/cli/src/lib/introspect.ts
+++ b/packages/cli/src/lib/introspect.ts
@@ -1,101 +1,104 @@
/**
* Route Tree Introspection
*
* Shared module for extracting structured metadata from Stricli's route tree.
* Used at runtime by `sentry help --json` and at build time by `generate-skill.ts`.
*
* While @stricli/core exports RouteMap and Command types, they require complex
* generic parameters (CommandContext) and don't export internal types like
* RouteMapEntry or FlagParameter. These simplified types are purpose-built
* for introspection and documentation generation.
*/
+import type { CommandExample } from "./command.js";
import {
extractSchemaFields,
type SchemaFieldInfo,
} from "./formatters/output.js";
import { fuzzyMatch } from "./fuzzy.js";
// ---------------------------------------------------------------------------
// ...
<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-skill-markdown.ts</path>
<type>file</type>
<content>
1: /**
2: * Markdown parsing helpers shared by the skill generator and its tests.
3: */
4:
5: /** Matches a generated command heading and stops before positional usage. */
6: const COMMAND_HEADING_RE =
7: /^`sentry\s+([^<[`\s]+(?:\s+[^<[`\s]+)*)(?:\s*(?:<|\[)[^`]*)?`$/;
8:
9: /** Extract the literal command path from a generated command heading. */
10: export function extractCommandPathFromHeading(
11: heading: string
12: ): string | undefined {
13: const match = COMMAND_HEADING_RE.exec(heading);
14: return match?.[1] ? `sentry ${match[1]}` : undefined;
15: }
16:
17: /** Find the command whose literal path appears in a loose example block. */
18: export function matchExampleToCommand(
19: code: string,
20: commandPaths: readonly string[],
21: groupFallback: string,
22: defaultCommandPath?: string
23: ): string | undefined {
24: // Prefer ...
<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-skill.ts</path>
<type>file</type>
<content>
900: // ---------------------------------------------------------------------------
901:
902: const files = await generateAllSkillFiles(routes as unknown as RouteMap);
903:
904: // Clean references directory to remove stale files
905: try {
906: rmSync(REFERENCES_DIR, { recursive: true, force: true });
907: } catch {
908: // Directory may not exist yet
909: }
910:
911: // Write all generated files
912: for (const [relativePath, content] of files) {
913: const fullPath = `${SKILL_DIR}/${relativePath}`;
914: // Ensure parent directory exists for reference files
915: const dir = fullPath.substring(0, fullPath.lastIndexOf("/"));
916: mkdirSync(dir, { recursive: true });
917: await writeFile(fullPath, content);
918: }
919:
920: // Write index.json
921: const indexJson = generateIndexJson(files);
922: const indexJsonDir = INDEX_JSON_PATH.substring(
923: ...
<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/lib/command.ts</path>
<type>file</type>
<content>
50: extractSchemaFields,
51: formatSchemaForHelp,
52: type HumanRenderer,
53: type OutputConfig,
54: renderCommandOutput,
55: resolveRenderer,
56: writeFooter,
57: } from "./formatters/output.js";
58: import { isPlainOutput } from "./formatters/plain-detect.js";
59: import { GLOBAL_FLAGS } from "./global-flags.js";
60: import { setInteractivePromptsAllowed } from "./interactive-prompts.js";
61: import {
62: LOG_LEVEL_NAMES,
63: type LogLevelName,
64: logger,
65: parseLogLevel,
66: setLogLevel,
67: } from "./logger.js";
68: import { setArgsContext, setFlagContext, withTracing } from "./telemetry.js";
69:
70: /**
71: * Parse a string input as a number.
72: * Re-exported from Stricli for convenience. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
490: * Merge global flags into a command's existing flags.
491: *
492: * For each global flag, if the command doesn't already define it, the
493: * default shape is injected and its key is added to the returned
494: * `stripKeys` set (so the wrapper strips it before calling `func`).
495: *
496: * @returns The merged flags, ownership booleans, and keys to strip.
497: */
498: function mergeGlobalFlags(
499: existingFlags: Record<string, unknown>,
500: // biome-ignore lint/suspicious/noExplicitAny: OutputConfig type is erased at the builder level
501: outputConfig?: OutputConfig<any>
502: ): {
503: mergedFlags: Record<string, unknown>;
504: commandOwnsOrg: boolean;
505: commandOwnsProject: boolean;
506: stripKeys: Set<string>;
507: } {
508: const commandOwnsJson = "json" in existingFlags;
509: const commandOwnsOrg = "org" in existingFlags;
510: const ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts</path>
<type>file</type>
<content>
400: function buildFieldsFlag(outputConfig?: OutputConfig<any>) {
401: if (!outputConfig?.schema) {
402: return FIELDS_FLAG;
403: }
404: const schemaFields = extractSchemaFields(outputConfig.schema);
405: if (schemaFields.length === 0) {
406: return FIELDS_FLAG;
407: }
408: const fieldNames = schemaFields.map((f) => f.name).join(", ");
409: return {
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. ...
<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: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/agent-conversation/list.test.ts</path>
<type>file</type>
<content>
1: /**
2: * Conversation List Command Tests
3: *
4: * Tests for the `sentry agent-conversation list` command func() body, covering:
5: * - Organization resolution from positional arg
6: * - Organization resolution via resolveOrg fallback
7: * - Error when org cannot be resolved
8: * - Yielding CommandOutput with conversation data
9: * - Query filter passthrough
10: * - Time params passthrough
11: * - Pagination hints with -q flag preserved
12: * - Empty result handling
13: *
14: * Uses spyOn mocking to avoid real HTTP calls or database access.
15: */
16:
17: import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
18: import { listCommand } from "../../../src/commands/agent-conversation/list.js";
19:
20: vi.mock("../../../src/lib/api-client.js", async (importOriginal) => {
21: const actual =
22: await ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts</path>
<type>file</type>
<content>
1: /**
2: * Command Builder Tests
3: *
4: * Tests for the buildCommand wrapper that adds automatic flag telemetry.
5: * Uses Stricli's run() to invoke commands end-to-end, verifying the wrapper
6: * captures flags/args and calls the original function.
7: */
8:
9: import { setTimeout as sleep } from "node:timers/promises";
10: // biome-ignore lint/performance/noNamespaceImport: needed for spyOn mocking
11: import * as Sentry from "@sentry/node-core/light";
12: import {
13: buildApplication,
14: type CommandContext,
15: run,
16: text_en,
17: } from "@stricli/core";
18: import { afterEach, beforeEach, describe, expect, test, vi } from "vitest";
19: import {
20: applyLoggingFlags,
21: applyOrgProjectFlags,
22: buildCommand,
23: FIELDS_FLAG,
24: JSON_FLAG,
25: LOG_LEVEL_FLAG,
26: numberParser,
27: VERBOSE_FLAG,
28: } from ...
Found 7 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/script/generate-skill-markdown.test.ts:
Line 57: "**Examples:**",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts:
Line 212: fullDescription: "List all the things.",
Line 234: expect(info.fullDescription).toBe("List all the things.");
Line 274: const cmd = makeCommand({ __examples: examples });
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts:
Line 186: customUsage: ["<name>:<kind>..."],
Line 204: test("retains structured examples for introspection", () => {
Line 222: expect((command as unknown as { __examples?: unknown }).__examples).toEqual(
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts</path>
<type>file</type>
<content>
1: /**
2: * Unit Tests for Route Tree Introspection
3: *
4: * Tests the shared introspection module used by `sentry help --json`
5: * and `script/generate-skill.ts`.
6: */
7:
8: import { describe, expect, test } from "vitest";
9: import type {
10: Command,
11: FlagDef,
12: RouteMap,
13: RouteMapEntry,
14: } from "../../src/lib/introspect.js";
15: import {
16: buildCommandInfo,
17: extractAllRoutes,
18: extractFlags,
19: extractRouteGroupCommands,
20: getPositionalString,
21: isCommand,
22: isRouteMap,
23: resolveCommandPath,
24: } from "../../src/lib/introspect.js";
25:
26: // ---------------------------------------------------------------------------
27: // Test fixtures
28: // ---------------------------------------------------------------------------
29:
30: function makeCommand(overrides: Partial<Command> = {}): Command {
31: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts</path>
<type>file</type>
<content>
480: });
481: });
482:
483: // ---------------------------------------------------------------------------
484: // Integration: real route tree
485: // ---------------------------------------------------------------------------
486:
487: describe("integration: real CLI route tree", () => {
488: test("extractAllRoutes returns entries for the actual CLI", async () => {
489: // Dynamic import to avoid circular deps in test setup
490: const { routes } = await import("../../src/app.js");
491: type IntrospectRouteMap = import("../../src/lib/introspect.js").RouteMap;
492: const routeMap = routes as unknown as IntrospectRouteMap;
493:
494: const allRoutes = extractAllRoutes(routeMap);
495:
496: // Should have multiple route entries
497: expect(allRoutes.length).toBeGreaterThan(5);
498:
499: // Known routes should exist
500: const ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.property.test.ts</path>
<type>file</type>
<content>
1: /**
2: * Property-Based Tests for Route Tree Introspection
3: *
4: * Uses fast-check to verify invariants that should hold for any valid
5: * route tree structure.
6: */
7:
8: import {
9: array,
10: boolean,
11: constantFrom,
12: assert as fcAssert,
13: oneof,
14: property,
15: record,
16: string,
17: tuple,
18: } from "fast-check";
19: import { describe, expect, test } from "vitest";
20: import type {
21: Command,
22: FlagDef,
23: RouteMap,
24: RouteMapEntry,
25: } from "../../src/lib/introspect.js";
26: import {
27: extractAllRoutes,
28: extractFlags,
29: getPositionalString,
30: resolveCommandPath,
31: } from "../../src/lib/introspect.js";
32: import { DEFAULT_NUM_RUNS } from "../model-based/helpers.js";
33:
34: // ---------------------------------------------------------------------------
35: // Arbitraries
36: ...
<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 ...
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
@@ -144,120 +144,148 @@ test("derives prompt availability from parsed flags instead of ambiguous aliases
await run(app, testCase.args, ctx as TestContext);
expect(promptStates.at(-1)).toBe(testCase.expected);
}
} finally {
setInteractivePromptsAllowed(true);
}
});
describe("buildCommand", () => {
test("builds a valid command object", () => {
const command = buildCommand({
auth: false,
docs: { brief: "Test command" },
parameters: {
flags: {
verbose: { kind: "boolean", brief: "Verbose", default: false },
},
},
async *func(_flags: { verbose: boolean }) {
// no-op
},
});
expect(command).toBeDefined();
});
test("handles commands with empty ...
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 4b8b785ba..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -337,144 +337,144 @@ sentry auth logout ## Command Reference ### Auth Authenticate with Sentry - `sentry auth login` — Authenticate with Sentry - `sentry auth logout` — Log out of Sentry - `sentry auth refresh` — Refresh your OAuth access token - `sentry auth status` — View authentication status - `sentry auth token` — Print the stored authentication token - `sentry auth whoami` — Show the currently authenticated identity → 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 ...
<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" ...
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/fragments/commands/agent-conversation.md</path> <type>file</type> <content> (End of file - total 0 lines) </content>
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
1: /**
2: * Custom Help Output
3: *
4: * Provides a branded, styled help output for the CLI.
5: * Shows custom formatting when running `sentry` with no arguments.
6: * Commands are auto-generated from Stricli's route structure.
7: */
8:
9: import { routes } from "../app.js";
10: import { formatBanner } from "./banner.js";
11: import { isAuthenticated } from "./db/auth.js";
12: import { TOP_LEVEL_ENV_VARS } from "./env-registry.js";
13: import { cyan, magenta, muted } from "./formatters/colors.js";
14: import {
15: filterFields,
16: formatJson,
17: parseFieldsList,
18: } from "./formatters/json.js";
19: import { GLOBAL_FLAGS } from "./global-flags.js";
20: import {
21: type CommandInfo,
22: extractAllRoutes,
23: getPositionalString,
24: isCommand,
25: isRouteMap,
26: type RouteInfo,
27: type RouteMap,
28: type RouteMapEntry,
29: ...
ripgrep execution failed
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
Found 34 matches
/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/lock.yaml:
Line 29: '@stricli/core@1.2.8':
Line 109: '@stricli/core':
Line 1793: '@stricli/core@1.2.8':
Line 1796: '@stricli/core@1.3.0':
Line 6303: '@stricli/core': 1.3.0
Line 6305: '@stricli/core@1.2.8(patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc)': {}
Line 6307: '@stricli/core@1.3.0': {}
Line 7287: '@stricli/core': 1.2.8(patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc)
/home/byk/Code/getsentry/cli-pr-1558/node_modules/.modules.yaml:
Line 482: '@stricli/core@1.2.8(patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc)':
Line 483: '@stricli/core': private
/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/fossilize@0.10.1/node_modules/fossilize/package.json:
Line 62: "@stricli/core": ...
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 40 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 509: readonly renderHelp?: (ctx: {
Line 1123: readonly fullDescription: string | undefined;
Line 1419: readonly fullDescription?: string;
Line 1423: readonly customUsage?: readonly (string | CustomUsage)[];
Line 1452: declare function buildCommand<const FLAGS extends Readonly<Partial<Record<keyof FLAGS, unknown>>> = NonNullable<unknown>, const ARGS extends BaseArgs = [], const CONTEXT extends CommandContext = CommandContext>(builderArgs: CommandBuilderArguments<FLAGS, ARGS, CONTEXT>): Command<CONTEXT>;
Line 1465: readonly fullDescription?: ...
<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>
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) ...
Found 12 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/script/generate-skill-markdown.test.ts:
Line 57: "**Examples:**",
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/help.test.ts:
Line 227: describe("formatHelpHuman with suggestions", () => {
Line 229: const { formatHelpHuman } = await import("../../src/lib/help.js");
Line 230: const output = formatHelpHuman({
Line 238: const { formatHelpHuman } = await import("../../src/lib/help.js");
Line 239: const output = formatHelpHuman({
Line 247: const { formatHelpHuman } = await import("../../src/lib/help.js");
Line 248: const output = formatHelpHuman({
Line 256: const { formatHelpHuman } = await import("../../src/lib/help.js");
Line 257: const output = formatHelpHuman({ error: "Command not found: xyz123" });
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts:
Line 212: fullDescription: "List all the ...
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 ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/resolve-target.test.ts:
Line 288: test("resolveOrgAndProject: SENTRY_ORG alone not enough for org+project", async () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts:
Line 402: * Pass `[]` when the defaults are irrelevant (e.g., for missing positional IDs like Trace ID).
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/release/parse.ts:
Line 76: * Commands pass a single required positional (Stricli `kind: "tuple"`), so callers
Found 100 matches (more matches available) /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/start.ts: Line 106: optional: true as const, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/list.ts: 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 229: optional: true, Line 244: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/init.ts: Line 320: optional: true, Line 326: optional: true, Line 343: optional: true, Line 349: optional: true, Line 356: optional: true, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/span/list.ts: Line 594: optional: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/org/view.ts</path>
<type>file</type>
<content>
1: /**
2: * sentry org view
3: *
4: * View detailed information about a Sentry organization.
5: */
6:
7: import type { SentryContext } from "../../context.js";
8: import { getOrganization } from "../../lib/api-client.js";
9: import { openInBrowser } from "../../lib/browser.js";
10: import { buildCommand } from "../../lib/command.js";
11: import { ContextError } from "../../lib/errors.js";
12: import { formatOrgDetails } from "../../lib/formatters/index.js";
13: import { CommandOutput } from "../../lib/formatters/output.js";
14: import {
15: applyFreshFlag,
16: FRESH_ALIASES,
17: FRESH_FLAG,
18: } from "../../lib/list-command.js";
19: import { resolveOrg } from "../../lib/resolve-target.js";
20: import { buildOrgUrl } from "../../lib/sentry-urls.js";
21:
22: type ViewFlags = {
23: readonly json: boolean;
24: readonly web: boolean;
25: readonly fresh: ...
/**
* 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. ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts</path> <type>file</type> <content> 300: } 301: 302: const DEFAULT_CONTEXT_ALTERNATIVES = [ 303: "Run from a directory with a Sentry DSN in source code or .env files", 304: "Set SENTRY_ORG and SENTRY_PROJECT (or SENTRY_DSN) environment variables", 305: "Run 'sentry org list' to find your organization slug", 306: "Run 'sentry project list <org>/' to find project slugs", 307: ] as const; 308: 309: /** 310: * Build the formatted context error message with usage hints. 311: * 312: * @param resource - What is required (e.g., "Organization", "Trace ID and span ID") 313: * @param command - Single-line CLI usage example (e.g., "sentry org view <org-slug>") 314: * @param alternatives - Alternative ways to provide the context 315: * @param note - Optional informational context (e.g., "Found 2 DSN(s) that could not be resolved"). 316: * Rendered as a separate "Note:" section after alternatives. ...
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
@@ -166,148 +166,151 @@ function fragmentMentionsSubcommand(
const lower = content.toLowerCase();
// Check 1: Full CLI reference anywhere (code blocks, backticks, prose)
if (lower.includes(fullCliRef.toLowerCase())) {
return true;
}
// Check 2: For default commands, bare `sentry <route>` (not followed by a subcommand) counts.
// Use a regex with word boundary to avoid matching `sentry issue events` as `sentry issue`.
if (isDefaultCommand) {
const bareRouteRe = new RegExp(
`sentry\\s+${routeName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?:\\s*$|[^\\w-])`,
"im"
);
if (bareRouteRe.test(lower)) {
return true;
}
}
// Check 3: Heading that mentions the leaf name (outside code blocks)
const proseOnly ...
Found 10 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 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 1980: if (def.optional) {
Line 2066: const flagsAllowingNegation ...
<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>
780: storeInput(
781: flagInputs,
782: config.caseStyle,
783: nextFlag.namedFlag,
784: nextFlag.negated ? "false" : "true"
785: );
786: } else {
787: storeInput(flagInputs, config.caseStyle, nextFlag.namedFlag, "1");
788: }
789: }
790: } else if (nextFlags.length > 1) {
791: const nextFlagExpectingArg = nextFlags.find((nextFlag) => !isNiladic(nextFlag));
792: const externalFlagName = asExternal(nextFlagExpectingArg.namedFlag[0], config.caseStyle);
793: throw new UnsatisfiedFlagError(externalFlagName);
794: } else {
795: activeFlag ...
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/trace-target.ts:
Line 20: import { ContextError, ValidationError } from "./errors.js";
Line 113: * @throws {ContextError} If no arguments are provided
Line 121: throw new ContextError("Trace ID", usageHint, []);
Line 126: throw new ContextError("Trace ID", usageHint, []);
Line 175: throw new ContextError("Trace ID", usageHint, []);
Line 203: throw new ContextError("Trace ID", usageHint, []);
Line 422: * @throws {ContextError} If auto-detection fails
Line 442: * @throws {ContextError} If org-scoped without project
Line 443: * @throws {ContextError} If auto-detection fails
Line 464: throw new ContextError("Specific project", usageHint, [
Line 521: * @throws {ContextError} If auto-detection fails
Line 542: throw new ContextError("Organization", usageHint, [
Line 554: throw new ContextError("Organization", ...
Found 6 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/app.ts:
Line 307: exceptionWhileParsingArguments: (
Line 323: return `${text_en.exceptionWhileParsingArguments(exc, ansiColor)}${pluralHint}`;
Line 334: return `${text_en.exceptionWhileParsingArguments(exc, ansiColor)}${tip}`;
Line 338: return text_en.exceptionWhileParsingArguments(exc, ansiColor);
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command-suggestions.ts:
Line 5: * `"routeContext/unknownToken"`. Used by the `exceptionWhileParsingArguments`,
Line 150: * Used by `exceptionWhileParsingArguments` (Cases A/B) and
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/app.ts</path>
<type>file</type>
<content>
260: return;
261: }
262:
263: /**
264: * Format a CliError with a synonym suggestion when the user typed a known
265: * synonym that was consumed as a positional arg by `defaultCommand: "view"`.
266: *
267: * Returns the formatted error string if a synonym match is found,
268: * undefined otherwise. Skips Sentry capture for these known user mistakes.
269: */
270: function formatSynonymError(
271: exc: unknown,
272: ansiColor: boolean
273: ): string | undefined {
274: if (!(exc instanceof CliError)) {
275: return;
276: }
277: const synonymHint = getSynonymSuggestionFromArgv();
278: if (!synonymHint) {
279: return;
280: }
281: const prefix = ansiColor ? errorColor("Error:") : "Error:";
282: const tip = ansiColor
283: ? warning(`Tip: ${synonymHint}`)
284: : `Tip: ${synonymHint}`;
285: return `${prefix} ${exc.format()}\n${tip}`;
286: }
287: ...
Found 18 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/team/list.ts:
Line 22: type OrgListCommandDocs,
Line 59: const docs: OrgListCommandDocs = {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/repo/list.ts:
Line 21: type OrgListCommandDocs,
Line 58: const docs: OrgListCommandDocs = {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/monitor/list.ts:
Line 20: type OrgListCommandDocs,
Line 72: const docs: OrgListCommandDocs = {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/mutate-command.ts:
Line 22: import { buildCommand, type CommandDocumentation } from "./command.js";
Line 335: readonly docs: CommandDocumentation;
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts:
Line 25: type CommandDocumentation,
Line 552: readonly docs: CommandDocumentation;
Line 631: export type OrgListCommandDocs = CommandDocumentation;
Line 688: docs: ...
Found 6 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/dashboard/widget/delete.ts:
Line 51: export const deleteCommand = buildDeleteCommand(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/uninstall.ts:
Line 423: export const uninstallCommand = buildDeleteCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/release/delete.ts:
Line 81: export const deleteCommand = buildDeleteCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/delete.ts:
Line 132: export const deleteCommand = buildDeleteCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/alert/metrics/delete.ts:
Line 45: export const deleteCommand = buildDeleteCommand({
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/alert/issues/delete.ts:
Line 48: export const deleteCommand = buildDeleteCommand({
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/dashboard/widget/delete.ts</path>
<type>file</type>
<content>
35: readonly index?: number;
36: readonly title?: string;
37: readonly yes: boolean;
38: readonly force: boolean;
39: readonly "dry-run": boolean;
40: readonly json: boolean;
41: readonly fields?: string[];
42: };
43:
44: type DeleteResult = {
45: dashboard: DashboardDetail;
46: widgetTitle: string;
47: url: string;
48: dryRun?: boolean;
49: };
50:
51: export const deleteCommand = buildDeleteCommand(
52: {
53: docs: {
54: brief: "Delete a widget from a dashboard",
55: fullDescription:
56: "Remove a widget from an existing Sentry dashboard.\n\n" +
57: "The dashboard can be specified by numeric ID or title.\n" +
58: "Identify the widget by --index (0-based) or --title.\n\n" +
59: "Examples:\n" +
60: " sentry dashboard widget delete 12345 --index 0\n" +
61: " sentry ...
Found 4 matches /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 75: customUsage: [USAGE], /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];
<path>/home/byk/Code/getsentry/cli-pr-1558/apps/cli-docs/src/fragments/commands/agent-conversation.md</path> <type>file</type> <content> (End of file - total 0 lines) </content>
Found 65 matches
/home/byk/Code/getsentry/cli-pr-1558/CHANGELOG.md:
Line 209: - Add `sentry agent-conversation` command group for inspecting AI agent transcripts by @sergical in [#1020](https://github.com/getsentry/cli/pull/1020)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/script/generate-skill-markdown.test.ts:
Line 10: import { listCommand } from "../../src/commands/agent-conversation/list.js";
Line 11: import { viewCommand } from "../../src/commands/agent-conversation/view.js";
Line 35: "sentry agent-conversation list"
Line 39: "sentry agent-conversation view"
Line 47: "# Explicit organization\nsentry agent-conversation list my-org"
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: ...
<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: ...
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 1798: function formatUsageLineForParameters(parameters, args) {
Line 2016: yield ` ${formatUsageLineForParameters(parameters, args)}`;
Line 2117: return formatUsageLineForParameters(builderArgs.parameters, 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.js</path>
<type>file</type>
<content>
1750: partial,
1751: scannerConfig: config.scanner,
1752: completionConfig: config.completion,
1753: text: defaultText,
1754: includeVersionFlag: Boolean(config.versionInfo) && result.rootLevel
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 ...
No files found
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/arg-parsing.ts</path>
<type>file</type>
<content>
1170: validateResourceId(prefix, "project slug");
1171: return parseProjectIdentifier(prefix, fragment);
1172: }
1173:
1174: /**
1175: * Parse issue arg with dash but no slash (project-suffix).
1176: */
1177: function parseWithDash(arg: string): ParsedIssueArg {
1178: const lastDash = arg.lastIndexOf("-");
1179: const projectSlug = arg.slice(0, lastDash);
1180: const suffix = arg.slice(lastDash + 1).toUpperCase();
1181:
1182: if (!projectSlug) {
1183: throw new ValidationError(
1184: `Invalid issue format: "${arg}". Missing project before suffix.`,
1185: "issue"
1186: );
1187: }
1188:
1189: if (!suffix) {
1190: throw new ValidationError(
1191: `Invalid issue format: "${arg}". Missing suffix after dash.`,
1192: "issue"
1193: );
1194: }
1195:
1196: rejectIssueCommandTokenWithNumericSuffix(arg, projectSlug, ...
Found 22 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/event/view.test.ts:
Line 317: test("one slash (org/project, missing event ID) throws ContextError", () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/e2e/trace.test.ts:
Line 148: expect(result.exitCode).toBe(EXIT.CONTEXT_MISSING);
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/e2e/project.test.ts:
Line 183: expect(result.exitCode).toBe(EXIT.CONTEXT_MISSING);
Line 192: expect(result.exitCode).toBe(EXIT.CONTEXT_MISSING);
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/e2e/log.test.ts:
Line 223: expect(result.exitCode).toBe(EXIT.CONTEXT_MISSING);
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/e2e/event.test.ts:
Line 72: expect(result.exitCode).toBe(EXIT.CONTEXT_MISSING);
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/span/view.test.ts:
Line 211: test("org/project/spanId (missing trace ID) throws a ...
<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: ...
Found 7 matches /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 resolveOrgProjectTarget( Line 2385: export async function resolveOrgOptionalProjectTarget(
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/resolve-target.ts</path>
<type>file</type>
<content>
1640: }
1641: throw new ContextError("Organization and project", usageHint);
1642: }
1643:
1644: /**
1645: * Resolve an org/project target, guiding the user when auto-detection fails.
1646: *
1647: * Drop-in replacement for the `resolveOrgAndProject(...)` + "throw
1648: * `ContextError` on null" pattern, combining {@link resolveOrgAndProject} with
1649: * {@link guideOrgProjectFailure}.
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. ...
<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>
538: export function buildCommand<
539: const FLAGS extends BaseFlags = NonNullable<unknown>,
540: const ARGS extends BaseArgs = [],
541: const CONTEXT extends CommandContext = CommandContext,
542: >(
543: builderArgs: LocalCommandBuilderArguments<FLAGS, ARGS, CONTEXT>
544: ): Command<CONTEXT> {
545: const originalFunc = builderArgs.func;
546: const outputConfig = builderArgs.output;
547: const requiresAuth = builderArgs.auth !== false && builderArgs.auth !== "dsn";
548: const skipRcUrlCheck =
549: builderArgs.skipRcUrlCheck === true || builderArgs.auth === "dsn";
550:
551: // Merge global flags into the command's flag definitions.
552: const existingParams = (builderArgs.parameters ?? {}) as Record<
553: string,
554: unknown
555: >;
556: const existingFlags = (existingParams.flags ?? ...
<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/src/lib/list-command.ts b/packages/cli/src/lib/list-command.ts
index 43f170d36..35811179c 100644
--- a/packages/cli/src/lib/list-command.ts
+++ b/packages/cli/src/lib/list-command.ts
@@ -1,163 +1,167 @@
/**
* Shared building blocks for org-scoped list commands.
*
* Provides reusable Stricli parameter definitions (target positional, common
* flags, aliases) and a `buildOrgListCommand` factory for commands whose
* entire `func` body is handled by `dispatchOrgScopedList`.
*
* Level A — shared constants (used by all four list commands):
* LIST_TARGET_POSITIONAL, LIST_JSON_FLAG, LIST_CURSOR_FLAG,
* buildListLimitFlag, LIST_BASE_ALIASES
*
* Level B — full command builder (team / repo only):
* buildOrgListCommand
*/
import { createRequire } from "node:module";
import type { Aliases, Command, CommandContext } from "@stricli/core";
import type { SentryContext } from "../context.js";
const _require = ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/app.ts</path>
<type>file</type>
<content>
1: import {
2: type ApplicationText,
3: buildApplication,
4: text_en,
5: UnexpectedPositionalError,
6: UnsatisfiedPositionalError,
7: } from "@stricli/core";
8: import { conversationRoute } from "./commands/agent-conversation/index.js";
9: import { listCommand as conversationListCommand } from "./commands/agent-conversation/list.js";
10: import { alertRoute } from "./commands/alert/index.js";
11: import { apiCommand } from "./commands/api.js";
12: import { authRoute } from "./commands/auth/index.js";
13: import { whoamiCommand } from "./commands/auth/whoami.js";
14: import { bashHookCommand } from "./commands/bash-hook.js";
15: import { buildRoute } from "./commands/build/index.js";
16: import { cliRoute } from "./commands/cli/index.js";
17: import { codeMappingsRoute } from "./commands/code-mappings/index.js";
18: import { dartSymbolMapRoute } from ...
<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>
Found 2 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 80: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 117: examples: [
USAGE
sentry agent-conversation view [<org>/]<conversation-id>
sentry agent-conversation view -h
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
FLAGS
-f [--fresh] Bypass cache, re-detect projects, and fetch fresh data [default = false]
[--json] Output as JSON [default = false]
[--fields] Comma-separated fields to include in JSON output (dot.notation supported)
-h --help Print help information and exit
ARGUMENTS
org/conversation-id [<org>/]<conversation-id> - Org (optional) and conversation ID
Found 29 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts: 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 250: default: "date" as const, /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/sourcemap/upload.ts: Line 259: default: "~/", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/explore.ts: Line 690: default: "sum", Line 721: default: "25", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/event/send.ts: Line 174: default: "error", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/docs/list.ts: Line 49: default: "8", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/monitor/run.ts: Line 205: default: ...
{
"path": "sentry agent-conversation view",
"brief": "View an agent conversation transcript",
"fullDescription": "View the full transcript of an agent conversation.\n\nThe org is optional and auto-detected from your project context when\nomitted. Prefix the ID with an org slug to target a specific org.\n\nExamples:\n sentry agent-conversation view conv-123 # View full transcript (organization auto-detected)\n sentry agent-conversation view my-org/conv-123 # Explicit organization\n sentry agent-conversation view my-org/conv-123 --json # JSON output",
"flags": [
{
"name": "fresh",
"brief": "Bypass cache, re-detect projects, and fetch fresh data",
"kind": "boolean",
"default": false,
"optional": true,
"variadic": false,
"hidden": false
},
{
"name": "log-level",
"brief": "Set log verbosity level",
"kind": "enum",
"optional": true,
"variadic": false,
"hidden": true
},
{
...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
1: /**
2: * Custom Help Output
3: *
4: * Provides a branded, styled help output for the CLI.
5: * Shows custom formatting when running `sentry` with no arguments.
6: * Commands are auto-generated from Stricli's route structure.
7: */
8:
9: import { routes } from "../app.js";
10: import { formatBanner } from "./banner.js";
11: import { isAuthenticated } from "./db/auth.js";
12: import { TOP_LEVEL_ENV_VARS } from "./env-registry.js";
13: import { cyan, magenta, muted } from "./formatters/colors.js";
14: import {
15: filterFields,
16: formatJson,
17: parseFieldsList,
18: } from "./formatters/json.js";
19: import { GLOBAL_FLAGS } from "./global-flags.js";
20: import {
21: type CommandInfo,
22: extractAllRoutes,
23: getPositionalString,
24: isCommand,
25: isRouteMap,
26: type RouteInfo,
27: type RouteMap,
28: type RouteMapEntry,
29: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/help.ts</path>
<type>file</type>
<content>
620: ): number {
621: const token = inputs[index] ?? "";
622: if (token.startsWith("--fields=")) {
623: assign(parseFieldsList(token.slice("--fields=".length)));
624: return index;
625: }
626: const next = inputs[index + 1];
627: if (next !== undefined && !next.startsWith("-")) {
628: assign(parseFieldsList(next));
629: return index + 1;
630: }
631: return index;
632: }
633:
634: // ---------------------------------------------------------------------------
635: // Suggestion Formatting
636: // ---------------------------------------------------------------------------
637:
638: /**
639: * Join suggestion strings with Oxford-comma grammar. ...
.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. Expected argument for org/conversation-id
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/agent-conversation.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/repl...
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
@@ -166,148 +166,151 @@ function fragmentMentionsSubcommand(
const lower = content.toLowerCase();
// Check 1: Full CLI reference anywhere (code blocks, backticks, prose)
if (lower.includes(fullCliRef.toLowerCase())) {
return true;
}
// Check 2: For default commands, bare `sentry <route>` (not followed by a subcommand) counts.
// Use a regex with word boundary to avoid matching `sentry issue events` as `sentry issue`.
if (isDefaultCommand) {
const bareRouteRe = new RegExp(
`sentry\\s+${routeName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?:\\s*$|[^\\w-])`,
"im"
);
if (bareRouteRe.test(lower)) {
return true;
}
}
// Check 3: Heading that mentions the leaf name (outside code blocks)
const proseOnly ...
<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 ...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 009809093..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -1,211 +1,231 @@
/**
* sentry agent-conversation list
*
* List recent agent conversations from Sentry projects.
*/
import type { SentryContext } from "../../context.js";
import { listConversations } from "../../lib/api-client.js";
import { validateLimit } from "../../lib/arg-parsing.js";
import {
advancePaginationState,
buildPaginationContextKey,
hasPreviousPage,
resolveCursor,
} from "../../lib/db/pagination.js";
import { ContextError } from "../../lib/errors.js";
import { formatConversationTable } from "../../lib/formatters/conversation.js";
import { filterFields } from "../../lib/formatters/json.js";
import { CommandOutput } from "../../lib/formatters/output.js";
+import { ...
Offset 1130 is out of range for this file (1004 lines)
Found 2 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts:
Line 540: export function validationError(
Line 558: export class ValidationError extends CliError {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts</path>
<type>file</type>
<content>
500:
501: override format(): string {
502: return this.message;
503: }
504: }
505:
506: /**
507: * Build a {@link ValidationError} message with Try: examples and optional Note: section.
508: *
509: * Matches {@link buildResolutionMessage} / {@link buildContextMessage} formatting so
510: * agent consumers get actionable recovery commands plus diagnostic context in a
511: * predictable shape. Always pass `field` when constructing the error — unfielded
512: * validation errors collapse into one Sentry fingerprint.
513: *
514: * @param headline - What failed validation
515: * @param examples - CLI commands or steps shown under "Try:"
516: * @param note - Optional diagnostic context rendered as "Note:" (not actionable)
517: */
518: export function buildValidationMessage(
519: headline: string,
520: examples: string[],
521: note?: string
522: ): string ...
.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: Conversation target must contain at most one '/'. Try: sentry agent-conversation view [<org>/]<conversation-id> EXIT=21
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
@@ -104,200 +104,228 @@ test("derives prompt availability from parsed flags instead of ambiguous aliases
flags: {
limit: {
kind: "parsed",
parse: numberParser,
brief: "Limit",
optional: true,
},
row: {
kind: "parsed",
parse: numberParser,
brief: "Row",
optional: true,
},
},
aliases: { n: "limit", y: "row" },
},
// biome-ignore lint/correctness/useYield: test command only observes wrapper state
async *func() {
promptStates.push(interactivePromptsAllowed());
},
});
const routeMap = buildRouteMap({
routes: { init: initCommand, data: dataCommand },
docs: { brief: "Test app" },
});
const ...
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 4b8b785ba..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -327,164 +327,164 @@ npm install -g sentry ### Authentication ```bash sentry auth sentry auth --token YOUR_SENTRY_API_TOKEN sentry auth status sentry auth logout ``` ## Command Reference ### Auth Authenticate with Sentry - `sentry auth login` — Authenticate with Sentry - `sentry auth logout` — Log out of Sentry - `sentry auth refresh` — Refresh your OAuth access token - `sentry auth status` — View authentication status - `sentry auth token` — Print the stored authentication token - `sentry auth whoami` — Show the currently authenticated identity → Full flags and examples: `references/auth.md` ### Org Work with Sentry organizations - `sentry org list` ...
Found 4 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts:
Line 212: fullDescription: "List all the things.",
Line 234: expect(info.fullDescription).toBe("List all the things.");
Line 274: const cmd = makeCommand({ __examples: examples });
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts:
Line 222: expect((command as unknown as { __examples?: unknown }).__examples).toEqual(
Found 1 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts:
Line 407: export class ContextError extends CliError {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts</path>
<type>file</type>
<content>
360: /**
361: * Build the formatted resolution error message for entities that could not be found or resolved.
362: *
363: * @param resource - The entity that could not be resolved (e.g., "Issue 99124558")
364: * @param headline - Describes the failure (e.g., "not found", "is ambiguous", "could not be resolved")
365: * @param hint - Primary usage example or suggestion
366: * @param suggestions - Additional help bullets shown under "Or:"
367: * @returns Formatted multi-line error message
368: */
369: function buildResolutionMessage(
370: resource: string,
371: headline: string,
372: hint: string,
373: suggestions: string[]
374: ): string {
375: const lines = [`${resource} ${headline}.`, "", "Try:", ` ${hint}`];
376: if (suggestions.length > 0) {
377: lines.push("", "Or:");
378: for (const s of suggestions) {
379: lines.push(` - ${s}`);
380: ...
diff --git a/packages/cli/src/lib/list-command.ts b/packages/cli/src/lib/list-command.ts
index 43f170d36..35811179c 100644
--- a/packages/cli/src/lib/list-command.ts
+++ b/packages/cli/src/lib/list-command.ts
@@ -1,123 +1,127 @@
/**
* Shared building blocks for org-scoped list commands.
*
* Provides reusable Stricli parameter definitions (target positional, common
* flags, aliases) and a `buildOrgListCommand` factory for commands whose
* entire `func` body is handled by `dispatchOrgScopedList`.
*
* Level A — shared constants (used by all four list commands):
* LIST_TARGET_POSITIONAL, LIST_JSON_FLAG, LIST_CURSOR_FLAG,
* buildListLimitFlag, LIST_BASE_ALIASES
*
* Level B — full command builder (team / repo only):
* buildOrgListCommand
*/
import { createRequire } from "node:module";
import type { Aliases, Command, CommandContext } from "@stricli/core";
import type { SentryContext } from "../context.js";
const _require = ...
bbaa7b3b722b87f1bccfe84063269cbbcabe2741 092bd817573c1e0ea81e71472a9da2f38251dd6736331152b8325526527c3479 - 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 ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/arg-parsing.ts</path>
<type>file</type>
<content>
1: /**
2: * Shared Argument Parsing Utilities
3: *
4: * Common parsing logic for CLI positional arguments that follow the
5: * `<org>/<target>` pattern. Used by both listing commands (issue list,
6: * project list) and single-item commands (issue view, explain, plan).
7: */
8:
9: import type { LogSortDirection } from "./api/logs.js";
10: import { ContextError, ValidationError, validationError } from "./errors.js";
11: import { validateResourceId } from "./input-validation.js";
12:
13: import type { ParsedSentryUrl } from "./sentry-url-parser.js";
14: import { applySentryUrlContext, parseSentryUrl } from "./sentry-url-parser.js";
15: import { isAllDigits } from "./utils.js";
16:
17: // ---------------------------------------------------------------------------
18: // Slug normalization
19: // ...
Found 1 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/arg-parsing.ts: Line 1226: export function parseSlashSeparatedArg(
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/arg-parsing.ts</path>
<type>file</type>
<content>
1170: validateResourceId(prefix, "project slug");
1171: return parseProjectIdentifier(prefix, fragment);
1172: }
1173:
1174: /**
1175: * Parse issue arg with dash but no slash (project-suffix).
1176: */
1177: function parseWithDash(arg: string): ParsedIssueArg {
1178: const lastDash = arg.lastIndexOf("-");
1179: const projectSlug = arg.slice(0, lastDash);
1180: const suffix = arg.slice(lastDash + 1).toUpperCase();
1181:
1182: if (!projectSlug) {
1183: throw new ValidationError(
1184: `Invalid issue format: "${arg}". Missing project before suffix.`,
1185: "issue"
1186: );
1187: }
1188:
1189: if (!suffix) {
1190: throw new ValidationError(
1191: `Invalid issue format: "${arg}". Missing suffix after dash.`,
1192: "issue"
1193: );
1194: }
1195:
1196: rejectIssueCommandTokenWithNumericSuffix(arg, projectSlug, ...
Found 12 matches
/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/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/help.ts:
Line 123: ...
<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: ...
Found 33 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/help.ts: Line 36: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/event/view.ts: Line 1073: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/event/send.ts: Line 142: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/docs/query.ts: Line 40: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/docs/list.ts: Line 54: kind: "array", /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/debug-files/upload.ts: Line 567: kind: "array", /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/cli/defaults.ts: Line 308: kind: ...
sentry help {"sig":"<command...>","p":{"placeholder":"command...","brief":"Command to get help for","optional":true}}
sentry build upload {"sig":"<path...>","p":{"placeholder":"path...","brief":"Path(s) to the build(s) to upload (APK, AAB, IPA, or XCArchive)","optional":true}}
sentry cli defaults {"sig":"<key value...>","p":{"placeholder":"key value...","brief":"Setting key and optional value","optional":true}}
sentry cli feedback {"sig":"<message...>","p":{"placeholder":"message...","brief":"Your feedback message","optional":true}}
sentry debug-files find {"sig":"<id...>","p":{"placeholder":"id...","brief":"Debug identifier(s) to search for","optional":true}}
sentry debug-files upload {"sig":"<path...>","p":{"placeholder":"path...","brief":"Files or directories to scan for debug information files","optional":true}}
sentry dashboard list {"sig":"<org/title-filter...>","p":{"placeholder":"org/title-filter...","brief":"[<org/project>] [<name-glob>]","optional":true}}
sentry dashboard ...
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/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 resolveOrgProjectTarget(
Line 2086: export function resolveOrgProjectFromArg(
Line 2385: export async function resolveOrgOptionalProjectTarget(
Line 2424: export function resolveOrgOptionalProjectFromArg(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/region.ts:
Line 46: export function resolveOrgRegion(orgSlug: string): Promise<string> {
Line 65: async function resolveOrgRegionUncached(orgSlug: string): Promise<string> {
Line ...
<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. ...
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 ...
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: boolean;
27 readonly fresh: boolean;
...
ripgrep execution failed
No files found
/home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.3.0/node_modules/@stricli/core/README.md /home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.3.0/node_modules/@stricli/core/package.json /home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.3.0/node_modules/@stricli/core/dist/index.d.ts /home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.3.0/node_modules/@stricli/core/dist/index.js /home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.3.0/node_modules/@stricli/core/dist/index.d.cts /home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.3.0/node_modules/@stricli/core/dist/index.cjs /home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core/README.md /home/byk/Code/getsentry/cli-pr-1558/node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e...
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.d.ts:
Line 1031: type PositionalParameter = BasePositionalParameter<unknown, CommandContext>;
Line 1032: interface PositionalParameterArray<T, CONTEXT extends CommandContext> {
Line 1033: readonly kind: "array";
Line 1038: type PositionalParametersForTuple<T, CONTEXT extends CommandContext> = {
Line 1041: interface PositionalParameterTuple<T> {
Line 1060: type PositionalParameters = PositionalParameterArray<unknown, CommandContext> | PositionalParameterTuple<readonly PositionalParameter[]>;
<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>
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?: string;
1012: readonly optional?: boolean;
1013: }
1014: interface RequiredPositionalParameter<T, CONTEXT extends CommandContext> extends BasePositionalParameter<T, CONTEXT> {
1015: /**
1016: * Parameter is required and cannot be set as optional.
1017: */
1018: readonly optional?: ...
No files found
<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" ...
<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, validationError } 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: ...
Found 9 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/agent-conversation/list.test.ts:
Line 399: test("handles empty results (human mode)", async () => {
Line 413: test("handles empty results with hasMore (page boundary)", async () => {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/agent-conversation/view.test.ts:
Line 5: * - Resolving org + conversationId from a single `<org>/<conversation-id>` arg
Line 6: * - Resolving org via resolveOrg when only the conversation-id is given
Line 193: test("resolves org + conversationId from a slash-separated arg", async () => {
Line 217: test("resolves org via resolveOrg when only conversation-id is given", async () => {
Line 259: field: "conversation-id",
Line 261: "sentry agent-conversation view [<org>/]<conversation-id>"
Line 401: test("handles empty spans", async () => {
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/agent-conversation/view.test.ts</path>
<type>file</type>
<content>
170:
171: describe("viewCommand.func", () => {
172: let getConversationSpansSpy: ReturnType<typeof vi.spyOn>;
173: let resolveOrgSpy: ReturnType<typeof vi.spyOn>;
174: let withProgressSpy: ReturnType<typeof vi.spyOn>;
175:
176: beforeEach(() => {
177: getConversationSpansSpy = vi.spyOn(apiClient, "getConversationSpans");
178: resolveOrgSpy = vi.spyOn(resolveTarget, "resolveOrg");
179: // Default: org resolves to ORG. Individual tests override for auto-detect
180: // or resolution-failure scenarios.
181: resolveOrgSpy.mockResolvedValue({ org: ORG });
182: withProgressSpy = vi
183: .spyOn(polling, "withProgress")
184: .mockImplementation(mockWithProgress);
185: });
186:
187: afterEach(() => {
188: getConversationSpansSpy.mockRestore();
189: resolveOrgSpy.mockRestore();
190: ...
diff --git a/packages/cli/src/commands/agent-conversation/list.ts b/packages/cli/src/commands/agent-conversation/list.ts
index 009809093..806842e71 100644
--- a/packages/cli/src/commands/agent-conversation/list.ts
+++ b/packages/cli/src/commands/agent-conversation/list.ts
@@ -1,211 +1,231 @@
/**
* sentry agent-conversation list
*
* List recent agent conversations from Sentry projects.
*/
import type { SentryContext } from "../../context.js";
import { listConversations } from "../../lib/api-client.js";
import { validateLimit } from "../../lib/arg-parsing.js";
import {
advancePaginationState,
buildPaginationContextKey,
hasPreviousPage,
resolveCursor,
} from "../../lib/db/pagination.js";
import { ContextError } from "../../lib/errors.js";
import { formatConversationTable } from "../../lib/formatters/conversation.js";
import { filterFields } from "../../lib/formatters/json.js";
import { CommandOutput } from "../../lib/formatters/output.js";
+import { ...
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
@@ -166,148 +166,151 @@ function fragmentMentionsSubcommand(
const lower = content.toLowerCase();
// Check 1: Full CLI reference anywhere (code blocks, backticks, prose)
if (lower.includes(fullCliRef.toLowerCase())) {
return true;
}
// Check 2: For default commands, bare `sentry <route>` (not followed by a subcommand) counts.
// Use a regex with word boundary to avoid matching `sentry issue events` as `sentry issue`.
if (isDefaultCommand) {
const bareRouteRe = new RegExp(
`sentry\\s+${routeName.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}(?:\\s*$|[^\\w-])`,
"im"
);
if (bareRouteRe.test(lower)) {
return true;
}
}
// Check 3: Heading that mentions the leaf name (outside code blocks)
const proseOnly ...
{
"brief": "View an agent conversation transcript",
"full": "View the full transcript of an agent conversation.\n\nThe org is optional and auto-detected from your project context when\nomitted. Prefix the ID with an org slug to target a specific org.\n\nExamples:\n sentry agent-conversation view conv-123 # View full transcript (organization auto-detected)\n sentry agent-conversation view my-org/conv-123 # Explicit organization\n sentry agent-conversation view my-org/conv-123 --json # JSON output",
"primary": "[<org>/]<conversation-id>",
"examples": [
{
"description": "View full transcript (organization auto-detected)",
"command": "sentry agent-conversation view conv-123"
},
{
"description": "Explicit organization",
"command": "sentry agent-conversation view my-org/conv-123"
},
{
"description": "JSON output",
"command": "sentry agent-conversation view my-org/conv-123 --json"
}
],
"params": {
"kind": ...
function [ 'run' ]
Found 100 matches (more matches available)
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/wrangler.ts:
Line 341: async function readPackageScript(
Line 357: async function hasWranglerConfig(
Line 463: export async function injectWranglerSpotlightBinding(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/walk-up.ts:
Line 25: export async function* walkUpFrom(startDir: string): AsyncGenerator<string> {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/version-check.ts:
Line 227: async function maybePrefetchPatches(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trial/start.ts:
Line 181: async function promptOpenBrowser(url: string): Promise<boolean> {
Line 217: async function* handlePlanTrial(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/upgrade.ts:
Line 231: async function isInstalledWith(pm: PackageManager): Promise<boolean> {
Line 315: async function detectLegacyInstallationMethod(): ...
Found 29 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 692: ctx: { commandPrefix?: readonly string[]; stderr: Writer },
Line 704: if (!ctx.commandPrefix) {
Line 707: const pathSegments = ctx.commandPrefix.slice(1); // strip "sentry" prefix
Line 865: commandPrefix?: readonly string[];
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/context.ts:
Line 30: readonly commandPrefix?: readonly string[];
Line 58: return { ...baseContext, commandPrefix: prefix };
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/org-list.ts:
Line 246: commandPrefix: string;
Line 490: const base = `${config.commandPrefix} ${org}/`;
Line 582: `Specify the organization explicitly: ${config.commandPrefix} <org>/`
Line 588: `Tip: Use '${config.commandPrefix} <org>/' to filter by organization`
Line 633: ? ` Use '${config.commandPrefix} ${orgSlugForHint}/' for paginated results.`
...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/context.ts</path>
<type>file</type>
<content>
1: /**
2: * Stricli Context
3: *
4: * Provides dependency injection for CLI commands.
5: * Following Stricli's "context" pattern for testability.
6: */
7:
8: import { homedir } from "node:os";
9: import type { CommandContext } from "@stricli/core";
10: import { getConfigDir } from "./lib/db/index.js";
11: import { type Span, setCommandSpanName } from "./lib/telemetry.js";
12: import type { Writer } from "./types/index.js";
13:
14: export interface SentryContext extends CommandContext {
15: readonly process: NodeJS.Process;
16: readonly env: NodeJS.ProcessEnv;
17: readonly cwd: string;
18: readonly homeDir: string;
19: readonly configDir: string;
20: readonly stdout: Writer;
21: readonly stderr: Writer;
22: readonly stdin: NodeJS.ReadStream & { fd: 0 };
23: /**
24: * Command path segments set by Stricli's `forCommand` callback. ...
Found 69 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/sdk-types.ts:
Line 39: * When `true`, the `run()` function returns a `string` instead of a parsed object.
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/sdk-invoke.ts:
Line 7: * Also provides `buildRunner()` — the variadic `run()` escape hatch
Line 618: return function run(
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/index.ts:
Line 5: * with named methods for every CLI command, plus a `run()` escape hatch for
Line 19: * const version = await sdk.run("--version");
Line 40: * handler directly with pre-built flags — no parsing overhead. A `run()`
Line 52: * const version = await sdk.run("--version");
Line 53: * const text = await sdk.run("issue", "list", "-l", "5");
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/db/utils.ts:
Line 40: * @returns Object with { sql, values } ready for db.query(sql).run(...values)
Line 45: * ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/cli.ts</path>
<type>file</type>
<content>
450:
451: /**
452: * Auto-authentication middleware.
453: *
454: * Catches auth errors (not_authenticated, expired) in interactive TTYs and
455: * runs the login flow, honoring the same host-trust gate as `auth login`
456: * (see {@link recoverWithAutoLogin}). On success, retries through the full
457: * middleware chain so inner middlewares (e.g., trial prompt) also apply.
458: */
459: const autoAuthMiddleware: ErrorMiddleware = async (next, argv) => {
460: try {
461: await next(argv);
462: } catch (err) {
463: const exitCode = await recoverWithAutoLogin(err, () => next(argv), {
464: runInteractiveLogin: () => runInteractiveLogin(),
465: });
466: if (exitCode !== undefined) {
467: process.exitCode = exitCode;
468: }
469: }
470: };
471:
472: /**
473: * Error-recovery middlewares applied around ...
Found 19 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/build/index.ts:
Line 305: const apps = findAppBundles(products);
Line 312: for (const app of apps) {
Line 442: const appNames = new Set<string>();
Line 449: const appName = appNames.values().next().value;
Line 571: const appName = extractIpaAppName(staged.map((e) => e.name));
Line 577: const appPrefix = `Payload/${appName}.app/`;
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/snapshots/download.ts:
Line 79: const appId = flags["app-id"];
Line 127: const appId = flags["app-id"] as string;
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/init/verify-setup.ts:
Line 381: const app = buildApp(buffer);
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/init/ui/ink-ui.ts:
Line 311: const app = (await import(importPath)) as typeof ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/app.ts</path>
<type>file</type>
<content>
395: // WizardError with rendered=true: clack already displayed the error.
396: // Return empty string to avoid double output, exit code flows through.
397: if (exc instanceof WizardError && exc.rendered) {
398: return "";
399: }
400: const prefix = ansiColor ? errorColor("Error:") : "Error:";
401: return `${prefix} ${exc.format()}`;
402: }
403: if (exc instanceof Error) {
404: return `Unexpected error: ${exc.stack ?? exc.message}`;
405: }
406: return `Unexpected error: ${stringifyUnknown(exc)}`;
407: },
408: };
409:
410: export const app = buildApplication(routes, {
411: name: "sentry",
412: versionInfo: {
413: currentVersion: CLI_VERSION,
414: },
415: scanner: {
416: caseStyle: "allow-kebab-for-camel",
417: // Allow `--` to stop flag parsing so wrapper commands (e.g. ...
OUT
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]
[--fields] Comma-separated fields to include in JSON output (dot.notation supported)
-h --help Print help information and exit
-- All subsequent inputs should ...
OUT
{
"path": "sentry agent-conversation view",
"brief": "View an agent conversation transcript",
"fullDescription": "View the full transcript of an agent conversation.\n\nThe org is optional and auto-detected from your project context when\nomitted. Prefix the ID with an org slug to target a specific org.\n\nExamples:\n sentry agent-conversation view conv-123 # View full transcript (organization auto-detected)\n sentry agent-conversation view my-org/conv-123 # Explicit organization\n sentry agent-conversation view my-org/conv-123 --json # JSON output",
"flags": [
{
"name": "fresh",
"brief": "Bypass cache, re-detect projects, and fetch fresh data",
"kind": "boolean",
"default": false,
"optional": true,
"variadic": false,
"hidden": false
},
{
"name": "log-level",
"brief": "Set log verbosity level",
"kind": "enum",
"optional": true,
"variadic": false,
"hidden": true
},
{
...
Found 5 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/init.ts:
Line 8: * Supports two optional positionals with smart disambiguation:
Line 378: // 1. Classify positionals into target vs directory
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/release/parse.ts:
Line 78: * `args.join(" ")` defect where extra positionals were swallowed into the version.
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/release/deploy.ts:
Line 55: * Parse the deploy positionals: `[org/]version`, `environment`, optional `name`.
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/create.ts:
Line 368: /** A validated project specification parsed from the command positionals. */
<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: ...
["agent-conversation","view"] exit -4 out "" err "Expected argument for org/conversation-id\n" ["agent-conversation","view",""] exit 22 out "" err "Error: Conversation ID is required.\n\nSpecify it using:\n sentry agent-conversation view [<org>/]<conversation-id>\n" ["agent-conversation","view"," "] exit 22 out "" err "Error: Conversation ID is required.\n\nSpecify it using:\n sentry agent-conversation view [<org>/]<conversation-id>\n" ["agent-conversation","view","org/id/extra"] exit 21 out "" err "Error: Conversation target must contain at most one '/'.\n\nTry:\n sentry agent-conversation view [<org>/]<conversation-id>\n"
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts</path>
<type>file</type>
<content>
150: });
151:
152: describe("buildCommand", () => {
153: test("builds a valid command object", () => {
154: const command = buildCommand({
155: auth: false,
156: docs: { brief: "Test command" },
157: parameters: {
158: flags: {
159: verbose: { kind: "boolean", brief: "Verbose", default: false },
160: },
161: },
162: async *func(_flags: { verbose: boolean }) {
163: // no-op
164: },
165: });
166: expect(command).toBeDefined();
167: });
168:
169: test("handles commands with empty parameters", () => {
170: const command = buildCommand({
171: auth: false,
172: docs: { brief: "Simple command" },
173: parameters: {},
174: async *func() {
175: // no-op
176: },
177: });
178: expect(command).toBeDefined();
179: });
180:
181: test("retains ...
Found 3 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts:
Line 212: fullDescription: "List all the things.",
Line 234: expect(info.fullDescription).toBe("List all the things.");
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/command.test.ts:
Line 204: test("retains structured examples for introspection", () => {
Found 2 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts:
Line 212: fullDescription: "List all the things.",
Line 234: expect(info.fullDescription).toBe("List all the things.");
ARGS agent-conversation list --help EXIT 0 USAGE sentry agent-conversation list [--limit value] [--query value] [--period value] [--fresh] [--cursor value] [--json] [--fields value] [<org>] sentry agent-conversation list --help List recent agent conversations from a Sentry organization. The organization is auto-detected when omitted. Examples: sentry agent-conversation list # List recent agent conversations sentry agent-conversation list my-org # Explicit organization sentry agent-conversation list --limit 50 --period 24h # Show more, last 24 hours sentry agent-conversation list -q "has:errors" # Filter conversations sentry agent-conversation list my-org -c next # Paginate through results JSON fields (use --json --fields to select): conversationId (string) title (string | null, optional) flow (array) errors (number) llmCalls (number) toolCalls (number) totalTokens (number) totalCost (number) startTimestamp (number) endTimestamp (number) ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.property.test.ts</path>
<type>file</type>
<content>
1: /**
2: * Property-Based Tests for Route Tree Introspection
3: *
4: * Uses fast-check to verify invariants that should hold for any valid
5: * route tree structure.
6: */
7:
8: import {
9: array,
10: boolean,
11: constantFrom,
12: assert as fcAssert,
13: oneof,
14: property,
15: record,
16: string,
17: tuple,
18: } from "fast-check";
19: import { describe, expect, test } from "vitest";
20: import type {
21: Command,
22: FlagDef,
23: RouteMap,
24: RouteMapEntry,
25: } from "../../src/lib/introspect.js";
26: import {
27: extractAllRoutes,
28: extractFlags,
29: getPositionalString,
30: resolveCommandPath,
31: } from "../../src/lib/introspect.js";
32: import { DEFAULT_NUM_RUNS } from "../model-based/helpers.js";
33:
34: // ---------------------------------------------------------------------------
35: // Arbitraries
36: ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts</path>
<type>file</type>
<content>
80: describe("isCommand", () => {
81: test("returns true for commands", () => {
82: const cmd = makeCommand();
83: expect(isCommand(cmd)).toBe(true);
84: });
85:
86: test("returns false for route maps", () => {
87: const routeMap = makeRouteMap([]);
88: expect(isCommand(routeMap)).toBe(false);
89: });
90: });
91:
92: // ---------------------------------------------------------------------------
93: // getPositionalString
94: // ---------------------------------------------------------------------------
95:
96: describe("getPositionalString", () => {
97: test("returns empty string for undefined", () => {
98: expect(getPositionalString(undefined)).toBe("");
99: });
100:
101: test("returns tuple placeholders", () => {
102: const result = getPositionalString({
103: kind: "tuple",
104: parameters: [{ placeholder: "org" ...
mismatch sentry help <command...> {
placeholder: 'command...',
brief: 'Command to get help for',
optional: true
}
mismatch sentry build upload <path...> {
placeholder: 'path...',
brief: 'Path(s) to the build(s) to upload (APK, AAB, IPA, or XCArchive)',
optional: true
}
mismatch sentry cli defaults <key value...> {
placeholder: 'key value...',
brief: 'Setting key and optional value',
optional: true
}
mismatch sentry cli feedback <message...> {
placeholder: 'message...',
brief: 'Your feedback message',
optional: true
}
mismatch sentry debug-files find <id...> {
placeholder: 'id...',
brief: 'Debug identifier(s) to search for',
optional: true
}
mismatch sentry debug-files upload <path...> {
placeholder: 'path...',
brief: 'Files or directories to scan for debug information files',
optional: true
}
mismatch sentry dashboard list <org/title-filter...> {
placeholder: 'org/title-filter...',
brief: '[<org/project>] [<name-glob>]',
optional: ...
(no output)
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/agent-conversation.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/repl...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/build.md</path> <type>file</type> <content> 1: --- 2: name: sentry-cli-build 3: version: 0.45.0-dev.0 4: description: Manage mobile build artifacts 5: requires: 6: bins: ["sentry"] 7: auth: true 8: --- 9: 10: # Build Commands 11: 12: Manage mobile build artifacts 13: 14: ### `sentry build upload <path...>` 15: 16: Upload builds to a project 17: 18: **Flags:** 19: - `--build-configuration <value> - Build configuration for the upload (defaults to the current version)` 20: - `--release-notes <value> - Release notes for the build` 21: - `--install-group <value>... ...
cb6c33e0c2b313d0ce0aebcaf94db06daaa2afb0cea7b0f8b3aa3b657b3a1102 - .../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 +- ...
diff --git a/packages/cli/test/script/generate-skill-markdown.test.ts b/packages/cli/test/script/generate-skill-markdown.test.ts
index 4274bb507..6eea4dc12 100644
--- a/packages/cli/test/script/generate-skill-markdown.test.ts
+++ b/packages/cli/test/script/generate-skill-markdown.test.ts
@@ -4,8 +4,12 @@ import { readFile } from "node:fs/promises";
import { describe, expect, test } from "vitest";
import {
extractCommandPathFromHeading,
+ formatCommandExamples,
matchExampleToCommand,
} from "../../script/generate-skill-markdown.js";
+import { listCommand } from "../../src/commands/agent-conversation/list.js";
+import { viewCommand } from "../../src/commands/agent-conversation/view.js";
+import { buildCommandInfo } from "../../src/lib/introspect.js";
describe("extractCommandPathFromHeading", () => {
test.each([
@@ -25,31 +29,45 @@ describe("extractCommandPathFromHeading", () => {
});
describe("matchExampleToCommand", () => {
- test("conversation headings preserve ...
Found 1 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts: Line 540: export function validationError(
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts</path>
<type>file</type>
<content>
490: super(
491: buildResolutionMessage(resource, headline, hint, suggestions),
492: EXIT.RESOLUTION
493: );
494: this.name = "ResolutionError";
495: this.resource = resource;
496: this.headline = headline;
497: this.hint = hint;
498: this.suggestions = suggestions;
499: }
500:
501: override format(): string {
502: return this.message;
503: }
504: }
505:
506: /**
507: * Build a {@link ValidationError} message with Try: examples and optional Note: section.
508: *
509: * Matches {@link buildResolutionMessage} / {@link buildContextMessage} formatting so
510: * agent consumers get actionable recovery commands plus diagnostic context in a
511: * predictable shape. Always pass `field` when constructing the error — unfielded
512: * validation errors collapse into one Sentry fingerprint. ...
"id" undefined "THREW ApiError: API request failed: 403 Forbidden" " org/id " undefined "THREW ApiError: API request failed: 403 Forbidden" " org /id" 30 "Error: API request failed: 404 Not Found\n Endpoint: /organizations/org /agents/conversations/id/\n Not found\n" "org/ id" undefined "THREW ApiError: API request failed: 403 Forbidden" "\tid\n" undefined "THREW ApiError: API request failed: 403 Forbidden" "/id" 21 "Error: Conversation target must include both an organization and conversation ID when using '/'.\n\nTry:\n sentry agent-conversation view [<org>/]<conversation-id" "org/" 21 "Error: Conversation target must include both an organization and conversation ID when using '/'.\n\nTry:\n sentry agent-conversation view [<org>/]<conversation-id" "org//id" 21 "Error: Conversation target must contain at most one '/'.\n\nTry:\n sentry agent-conversation view [<org>/]<conversation-id>\n" "org/id/x" 21 "Error: Conversation target must contain at most one '/'.\n\nTry:\n sentry ...
<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 ...
diff --git a/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md b/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md index a9fff0868..0b23b5abe 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md @@ -11,7 +11,7 @@ requires: List and view agent conversations -### `sentry agent-conversation list <org>` +### `sentry agent-conversation list [<org>]` List recent agent conversations @@ -63,7 +63,7 @@ sentry agent-conversation list -q "has:errors" sentry agent-conversation list my-org -c next ``` -### `sentry agent-conversation view <org/conversation-id>` +### `sentry agent-conversation view [<org>/]<conversation-id>` View an agent conversation transcript @@ -73,11 +73,14 @@ View an agent conversation transcript **Examples:** ```bash -# View full transcript -sentry ...
Found 10 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts:
Line 261: async *func(this: SentryContext, flags: ListFlags, target?: string) {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/replay/list.ts:
Line 325: async *func(this: SentryContext, flags: ListFlags, target?: string) {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/explore.ts:
Line 741: async *func(this: SentryContext, flags: ExploreFlags, target?: string) {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/project/list.ts:
Line 732: async *func(this: SentryContext, flags: ListFlags, target?: string) {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/issue/list.ts:
Line 1524: async *func(this: SentryContext, rawFlags: ListFlagsInput, target?: string) {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/feedback/list.ts:
Line 198: async *func(this: SentryContext, flags: ListFlags, ...
Found 7 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/view.ts:
Line 62: const USAGE_HINT = "sentry trace view [<org>/<project>/]<trace-id>";
Line 407: throw new ContextError("Organization", `sentry issue view ${issueShortId}`);
Line 529: USAGE_HINT
Line 535: USAGE_HINT
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/logs.ts:
Line 90: const USAGE_HINT = "sentry trace logs [<org>/[<project>/]]<trace-id>";
Line 186: const parsed = parseTraceTarget(args, USAGE_HINT);
Line 188: const { traceId, org } = await resolveTraceOrg(parsed, cwd, USAGE_HINT);
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts</path>
<type>file</type>
<content>
215: },
216: output: {
217: human: formatTraceListHuman,
218: jsonTransform: jsonTransformTraceList,
219: schema: TransactionListItemSchema,
220: },
221: parameters: {
222: positional: {
223: kind: "tuple",
224: parameters: [
225: {
226: placeholder: "org/project",
227: brief: "<org>/<project> or <project> (search)",
228: parse: String,
229: optional: true,
230: },
231: ],
232: },
233: flags: {
234: limit: {
235: kind: "parsed",
236: parse: parseLimit,
237: brief: `Number of traces (${LIST_MIN_LIMIT}-${LIST_MAX_LIMIT})`,
238: default: String(LIST_DEFAULT_LIMIT),
239: },
240: query: {
241: kind: "parsed",
242: parse: sanitizeQuery,
243: brief: "Search query (Sentry search syntax)",
244: ...
<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: ...
diff --git a/packages/cli/src/lib/list-command.ts b/packages/cli/src/lib/list-command.ts
index 43f170d36..35811179c 100644
--- a/packages/cli/src/lib/list-command.ts
+++ b/packages/cli/src/lib/list-command.ts
@@ -1,123 +1,127 @@
/**
* Shared building blocks for org-scoped list commands.
*
* Provides reusable Stricli parameter definitions (target positional, common
* flags, aliases) and a `buildOrgListCommand` factory for commands whose
* entire `func` body is handled by `dispatchOrgScopedList`.
*
* Level A — shared constants (used by all four list commands):
* LIST_TARGET_POSITIONAL, LIST_JSON_FLAG, LIST_CURSOR_FLAG,
* buildListLimitFlag, LIST_BASE_ALIASES
*
* Level B — full command builder (team / repo only):
* buildOrgListCommand
*/
import { createRequire } from "node:module";
import type { Aliases, Command, CommandContext } from "@stricli/core";
import type { SentryContext } from "../context.js";
const _require = ...
Found 14 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/trace/list.ts:
Line 198: export const listCommand = buildListCommand("trace", {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/issue/list.ts:
Line 1450: export const listCommand = buildListCommand("issue", {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/issue/events.ts:
Line 68: export const eventsCommand = buildListCommand("issue", {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/feedback/list.ts:
Line 132: export const listCommand = buildListCommand("feedback", {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/explore.ts:
Line 621: export const exploreCommand = buildListCommand("explore", {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/event/list.ts:
Line 78: export const listCommand = buildListCommand("event", {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/dashboard/list.ts:
Line ...
Found 2 matches /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/view.ts: Line 80: examples: [ /home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/commands/agent-conversation/list.ts: Line 117: examples: [
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 4b8b785ba..66569f927 100644 --- a/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md +++ b/packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md @@ -345,44 +345,44 @@ Authenticate with Sentry - `sentry auth refresh` — Refresh your OAuth access token - `sentry auth status` — View authentication status - `sentry auth token` — Print the stored authentication token - `sentry auth whoami` — Show the currently authenticated identity → 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 ...
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>
125:
126: /**
127: * Flags that are globally injected and should be omitted from compact index
128: * and only mentioned once in the Global Options section.
129: */
130: const GLOBAL_FLAG_NAMES = new Set([
131: "json",
132: "fields",
133: "help",
134: "helpAll",
135: "log-level",
136: ]);
137:
138: // ---------------------------------------------------------------------------
139: // Markdown Parsing Utilities
140: // ---------------------------------------------------------------------------
141:
142: /** Strip YAML frontmatter from markdown content */
143: function stripFrontmatter(markdown: string): string {
144: const match = markdown.match(FRONTMATTER_REGEX);
145: return match ? markdown.slice(match[0].length) : markdown;
146: }
147:
148: /** Strip MDX/Astro import statements and JSX components */
149: function stripMdxComponents(markdown: ...
Found 54 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/paths.ts:
Line 17: export const DOCS_FRAGMENTS = `${DOCS_SRC}/fragments`;
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts:
Line 3: * Validate doc fragment files.
Line 5: * Ensures fragment files stay consistent with the CLI route tree:
Line 6: * 1. Every route has a corresponding fragment file (+ index.md)
Line 7: * 2. Every fragment file corresponds to an existing route (or is index.md)
Line 9: * 4. Top-level fragments (e.g., configuration.md) exist
Line 13: * tsx script/check-fragments.ts # Warnings for missing subcommands
Line 14: * tsx script/check-fragments.ts --strict # Errors for missing subcommands
Line 40: const GENERATED_END_MARKER = "<!-- GENERATED:END -->";
Line 42: /** Routes that don't have doc pages (and therefore no fragments) */
Line 55: // Expected fragment files: one per route + index
Line 58: let ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-command-docs.ts</path>
<type>file</type>
<content>
365: return lines.join("\n");
366: }
367:
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 ...
Found 11 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/input-validation.ts:
Line 149: export function validateResourceId(input: string, label: string): void {
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/arg-parsing.ts:
Line 705: validateResourceId(np.slug, "project slug");
Line 714: validateResourceId(no.slug, "organization slug");
Line 740: validateResourceId(np.slug, "project slug");
Line 801: validateResourceId(np.slug, "project slug");
Line 1153: validateResourceId(fragment, "issue identifier");
Line 1164: validateResourceId(prefix.replace(/\//g, ""), "issue identifier");
Line 1170: validateResourceId(prefix, "project slug");
Line 1267: validateResourceId(id, idLabel);
Line 1321: validateResourceId(org, "organization slug");
Line 1340: validateResourceId(input.replace(/\//g, ""), "issue identifier");
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/input-validation.ts</path>
<type>file</type>
<content>
115: *
116: * Resource IDs (slugs, issue IDs) should always be plain strings. If they
117: * contain `%XX` patterns, they were likely pre-encoded by an agent and
118: * would get double-encoded when interpolated into API URLs.
119: *
120: * @param input - String to validate
121: * @param label - Human-readable name for error messages (e.g., "project slug")
122: * @throws {ValidationError} When input contains percent-encoded sequences
123: */
124: export function rejectPreEncoded(input: string, label: string): void {
125: const match = PRE_ENCODED_PATTERN.exec(input);
126: if (match) {
127: throw new ValidationError(
128: `Invalid ${label}: contains URL-encoded sequence "${match[0]}".\n` +
129: ` Use plain text instead of percent-encoding (e.g., "my project" not "my%20project").`
130: );
131: }
132: }
133:
134: /**
135: * ...
<path>/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/input-validation.ts</path>
<type>file</type>
<content>
1: /**
2: * Input Validation for Agent Hallucination Hardening
3: *
4: * Reusable validators that defend against malformed inputs from AI agents.
5: * Agents hallucinate differently than humans typo — they embed query params
6: * in resource IDs, double-encode URLs, and inject path traversals.
7: *
8: * These validators are applied at the CLI argument parsing layer so all
9: * commands benefit automatically. The Sentry API handles most of these
10: * server-side (404, 400), but client-side validation provides:
11: * - Better error messages with actionable suggestions
12: * - Faster failure without a network round-trip
13: * - Defense-in-depth against unexpected URL manipulation
14: *
15: * @see https://github.com/getsentry/cli/issues/350
16: */
17:
18: import { ValidationError } from "./errors.js";
19:
20: /**
21: * Characters that are never valid in ...
Found 12 matches
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/mutate-command.ts:
Line 22: import { buildCommand, type CommandDocumentation } from "./command.js";
Line 335: readonly docs: CommandDocumentation;
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/list-command.ts:
Line 25: type CommandDocumentation,
Line 552: readonly docs: CommandDocumentation;
Line 631: export type OrgListCommandDocs = CommandDocumentation;
Line 688: docs: OrgListCommandDocs,
/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/command.ts:
Line 110: export type CommandDocumentation =
Line 154: readonly docs: CommandDocumentation;
Line 421: docs: CommandDocumentation,
Line 424: ): CommandDocumentation {
Line 442: docs: CommandDocumentation
Line 461: docs: CommandDocumentation
b2a172a2952a552f9c907dd399adf61a04df376d01cf634e96e0f693c3328d9b - bbaa7b3b722b87f1bccfe84063269cbbcabe2741
bbaa7b3b722b87f1bccfe84063269cbbcabe2741 b2a172a2952a552f9c907dd399adf61a04df376d01cf634e96e0f693c3328d9b -
bbaa7b3b722b87f1bccfe84063269cbbcabe2741bbaa7b3b722b87f1bccfe84063269cbbcabe2741git diff | sha256sum: 092bd817573c1e0ea81e71472a9da2f38251dd6736331152b8325526527c3479b2a172a2952a552f9c907dd399adf61a04df376d01cf634e96e0f693c3328d9bgit rev-parse HEAD and git diff | sha256sum both before and after the review; both results must remain identical.All requested correctness areas remain unverified against the exact target.
DO-NOT-MERGE
### Current State - **Sep 9, 2026 — active task:** Independent, adversarial, **READ-ONLY** correctness review of `getsentry/cli` PR **#1558**, repository `/home/byk/Code/getsentry/cli-pr-1558`. - **Immutable target:** committed HEAD `bbaa7b3b722b87f1bccfe84063269cbbcabe2741` plus the entire unstaged worktree diff whose SHA-256 is `092bd817573c1e0ea81e71472a9da2f38251dd6736331152b8325526527c3479`.…
* 🔴 (15:39) User asserted that Sentry resource IDs, including slugs and issue IDs, should always be plain strings; `%XX` patterns indicate likely pre-encoding and risk double encoding when interpolated into API URLs. * 🔴 (15:39) User asserted that `?`, `#`, `%`, and whitespace are never valid in Sentry resource identifiers such as slugs and IDs because they can cause URL injection or break URL …
* 🔴 (15:37) A search found exactly 2 `examples:` definitions under `packages/cli/src/commands/agent-conversation/`: `view.ts:80` and `list.ts:117`. * 🔴 (15:37) Generated skill documentation in `packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md` was updated to mark 23 optional positionals with square brackets: 1. `sentry org view [<org>]`; 2. `sentry project list [<org/project>]`; 3. `s…
* 🔴 (15:34) `packages/cli/script/check-fragments.ts` is a 316-line fragment validator supporting `tsx script/check-fragments.ts` and strict mode via `tsx script/check-fragments.ts --strict`; non-strict mode warns for missing subcommand coverage, while `--strict` treats those omissions as errors. * 🔴 (15:34) `packages/cli/script/check-fragments.ts` ensures the generated stub `src/generated/skill…
* 🔴 (15:28) Generated reference `packages/cli/plugins/sentry-cli/skills/sentry-cli/references/build.md` has front matter `name: sentry-cli-build`, `version: 0.45.0-dev.0`, description `Manage mobile build artifacts`, `bins: ["sentry"]`, and `auth: true`; it documents `sentry build upload <path...>` as “Upload builds to a project.” * 🔴 (15:28) `sentry build upload <path...>` documentation lists …
* 🔴 (15:17) Native `sentry agent-conversation view` argument validation produced: no positional argument → exit `-4`, stderr `Expected argument for org/conversation-id\n`; empty string or whitespace-only positional → exit `22`, stderr `Error: Conversation ID is required.\n\nSpecify it using:\n sentry agent-conversation view [<org>/]<conversation-id>\n`; `org/id/extra` → exit `21`, stderr `Error…
* 🔴 (15:14) Executing native help for `sentry agent-conversation view` succeeded with `EXIT 0`, usage `sentry agent-conversation view [<org>/]<conversation-id>` and `sentry agent-conversation view --help`, alias `sentry agent-conversation show`, positional label `org/conversation-id`, and description `[<org>/]<conversation-id> - Org (optional) and conversation ID`. * 🔴 (15:14) Native `sentry ag…
* 🔴 (15:12) `packages/cli/script/check-fragments.ts` now skips fragment subcommand-coverage checks for every command whose `cmd.examples.length > 0`; structured command metadata examples count as documentation, so only commands without metadata examples must be mentioned in the hand-written route fragment. * 🔴 (15:12) `packages/cli/script/generate-command-docs.ts` now imports `formatCommandExam…
* 🔴 (15:12) `packages/cli/src/commands/agent-conversation/list.ts` now imports `getPositionalString` from `../../lib/introspect.js`, extracts its optional `org` tuple definition into `POSITIONAL`, and derives `USAGE_HINT` as ``sentry ${COMMAND_NAME} ${getPositionalString(POSITIONAL)}``; unresolved organizations now use this generated usage hint in `ContextError`. * 🔴 (15:12) `getPositionalStrin…
* 🔴 (15:10) In `@stricli/core`’s `/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`, `BaseArgs = readonly unknown[]` ensures positional argument type parameters are always defined as an array or tuple; `TypedPositionalParameters<T, CONTEXT>` distinguis…
* 🔴 (15:08) User stated agent conversation IDs are organization-scoped, not organization/project-scoped, and never contain `/`; therefore `[<org>/]<conversation-id>` contains at most one slash. * 🔴 (15:08) `parseConversationTarget(target)` trims the target, treats a no-slash value entirely as `conversationId`, or splits at the first `/` into `org` and `conversationId`; if either slash-delimited…
* 🔴 (15:06) `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts` defines `PositionalParams` as either `{ kind: "tuple"; parameters: readonly PositionalParam[] }` or `{ kind: "array"; parameter: PositionalParam }`; `PositionalParam` has optional `brief`, `placeholder`, and `optional` fields. * 🔴 (15:06) `getPositionalString()` in `/home/byk/Code/getsentry/cli-pr-1558/package…
* 🔴 (15:05) Search found exactly 12 matches for `getPositionalString`: `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts` lines 195 and 301; `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts` lines 98, 102, 110, 121, 129, and 137; `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.property.test.ts` lines 150 and 174; `/home/…
* 🔴 (15:01) User established that IDs handled by `parseSlashSeparatedArg()` in `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/arg-parsing.ts` are hex strings that never contain `/`; therefore, any slash means the input must be a structured `org/project/id` or an `org/project` target missing its ID. * 🔴 (15:01) User’s `parseSlashSeparatedArg(arg, idLabel, usageHint)` trims whitespace…
* 🔴 (14:49) User inspected `ContextError` in `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/errors.ts` lines 385-453. `ContextError` is for omitted required context; `ResolutionError` is for a provided value that cannot be matched; `ValidationError` is for malformed input. Omitting `alternatives` assumes failed auto-detection and uses `DEFAULT_CONTEXT_ALTERNATIVES`; explicitly supply…
* 🔴 (14:49) Search found 4 matches across 2 test files: `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts` line 212 (`fullDescription: "List all the things.",`), line 234 (`expect(info.fullDescription).toBe("List all the things.");`), and line 274 (`const cmd = makeCommand({ __examples: examples });`); `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/comma…
* 🔴 (14:46) [changed-command-docs] Generated Sentry CLI skill documentation changed 23 command signatures to reflect optional positionals: 1. `sentry org view [<org>]`; 2. `sentry project list [<org/project>]`; 3. `sentry project view [<org/project>]`; 4. `sentry issue list [<org/project>]`; 5. `sentry alert issues list [<org/project>]`; 6. `sentry alert issues create [<target>]`; 7. `sentry ale…
* 🔴 (14:45) User stated `extractFlags()` always returns one `FlagInfo` per input entry; `packages/cli/test/lib/introspect.property.test.ts` verifies the output length equals `Object.keys(flags).length`, preserves every flag name, and defaults boolean flags with unspecified `optional` to `optional: true`. * 🔴 (14:45) User stated `getPositionalString()` for tuple positionals always produces angle…
* 🔴 (14:43) User stated agent conversation IDs never contain `/`; `sentry agent-conversation view` therefore accepts `[<org>/]<conversation-id>` with at most one slash, interpreting text before the slash as the organization and the remainder as the conversation ID, while a slashless value is entirely the conversation ID and triggers organization auto-detection. * 🔴 (14:43) User directed that `f…
* 🔴 (14:42) Working tree diff spans 34 files with 393 insertions and 156 deletions, covering generated CLI docs/skills, documentation generators, command/introspection libraries, agent-conversation commands, and tests. * 🔴 (14:42) Modified documentation artifacts are `apps/cli-docs/src/fragments/commands/agent-conversation.md`, `packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md`, and r…
* 🔴 (14:39) `sentry agent-conversation view [<org>/]<conversation-id>` displays the full transcript of an agent conversation; the organization is optional and auto-detected from project context when omitted, while `<org>/<conversation-id>` targets a specific organization. * 🔴 (14:39) `sentry agent-conversation view` examples are: `sentry agent-conversation view conv-123` for an auto-detected or…
* 🔴 (14:37) `packages/cli/src/commands/agent-conversation/index.ts` imports `buildRouteMap` from `../../lib/route-map.js`, `listCommand` from `./list.js`, and `viewCommand` from `./view.js`. * 🔴 (14:37) `packages/cli/src/commands/agent-conversation/index.ts` exports `conversationRoute = buildRouteMap(...)` with routes `list: listCommand` and `view: viewCommand`, and sets `defaultCommand: "list"…
Date: Sep 9, 2026 * 🔴 (14:35) `packages/cli/src/app.ts` imports Stricli application primitives `ApplicationText`, `buildApplication`, `text_en`, `UnexpectedPositionalError`, and `UnsatisfiedPositionalError`; command-suggestion helpers `getCommandSuggestion` and `getSynonymSuggestionFromArgv`; error types/helpers `ApiError`, `AuthError`, `CliError`, `getExitCode`, `OutputError`, `stringifyUnknown…
Date: Sep 9, 2026 * 🔴 (14:35) `packages/cli/src/lib/introspect.ts` is a 496-line shared route-tree introspection module used at runtime by `sentry help --json` and at build time by `generate-skill.ts`; it defines simplified Stricli-facing types because `@stricli/core` does not export internal types such as `RouteMapEntry` or `FlagParameter`. * 🔴 (14:35) `packages/cli/src/lib/introspect.ts` defi…
* 🔴 (14:33) `packages/cli/test/commands/agent-conversation/view.test.ts` tests `viewCommand.func` with `ORG = "test-org"`, `CONVERSATION_ID = "conv-abc-123"`, `JSON_FLAGS = { json: true, fresh: false }`, and `HUMAN_FLAGS = { json: false, fresh: false }`; mocks `getAuthConfig()` to return `{ token: "sntrys_test", source: "oauth" }`, mocks `withProgress` as a direct passthrough, and uses 2 `AgentC…
Date: September 9, 2026 * 🔴 (14:32) User stated an issue identifier is always a single line; `parseIssueArg(arg)` must select the first non-blank trimmed line rather than allow an internal newline to reach `validateResourceId`. * 🔴 (14:32) User stated event, trace, and log IDs are hex strings that never contain `/`; any slash-containing input must therefore be parsed as a structured `org/projec…
* 🔴 (14:28) `packages/cli/src/app.ts` defines `formatSynonymError(exc, ansiColor)`: it only handles `CliError`, obtains `getSynonymSuggestionFromArgv()`, returns `undefined` without a hint, and otherwise formats `Error: ${exc.format()}\nTip: ${synonymHint}` with `errorColor()`/`warning()` when ANSI color is enabled; known synonym mistakes skip Sentry capture. * 🔴 (14:28) `escapesToOuterMiddlewa…
* 🔴 (14:26) `packages/cli/script/check-fragments.ts` now skips subcommand-fragment coverage checks when `cmd.examples.length > 0`; only commands without canonical metadata examples must be mentioned by a hand-written fragment heading or code example. * 🔴 (14:26) `packages/cli/script/generate-command-docs.ts` documentation now defines generated pages as combining: 1. auto-generated reference and…
Date: Sep 9, 2026 * 🔴 (14:25) User stated agent conversation IDs are organization-scoped and never contain `/`; `[<org>/]<conversation-id>` therefore permits at most one slash, with the prefix interpreted as the organization and the remainder as the conversation ID. * 🔴 (14:25) User stated validation errors must always be constructed with `field`; unfielded validation errors collapse into one S…
Date: Sep 9, 2026 * 🔴 (14:24) Working tree status reported 34 modified paths across CLI docs, generated Sentry CLI skill docs, scripts, source, and tests; one status listing omitted `packages/cli/plugins/sentry-cli/skills/sentry-cli/references/agent-conversation.md`, while the subsequent name-status and diff-stat listings included it. * 🔴 (14:24) Modified documentation/skill paths and diff stat…
* 🔴 (14:23) Patched `@stricli/core@1.2.8` runtime function `generateCommandHelpLines()` in `node_modules/.pnpm/@stricli+core@1.2.8_patch_hash=892258f886d48063b409e0ac6141260023c396d1ed4f915231701f6a34edffcc/node_modules/@stricli/core/dist/index.js:2000-2044` renders command help in this order: Usage header; each `customUsage` entry or the generated parameter usage; built-in flag usage lines; `fu…
* 🔴 (14:21) `packages/cli/src/lib/help.ts` is 792 lines and implements branded top-level help, structured command introspection, JSON help rendering, unknown-command recovery, version-request recovery, fuzzy suggestion formatting, and human rendering of introspection data. * 🔴 (14:21) In `packages/cli/src/lib/help.ts:764-770`, `formatHelpHuman(data: HelpJsonResult)` renders full-tree human outp…
* 🔴 (14:20) Generated CLI skill documentation in `packages/cli/plugins/sentry-cli/skills/sentry-cli/SKILL.md` now marks optional positional arguments with square brackets for 23 commands: `sentry org view [<org>]`; `sentry project list [<org/project>]`; `sentry project view [<org/project>]`; `sentry issue list [<org/project>]`; `sentry alert issues list [<org/project>]`; `sentry alert issues cre…
* 🔴 (14:19) `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/lib/introspect.test.ts` is a 535-line Vitest suite covering `isRouteMap`, `isCommand`, `getPositionalString`, `extractFlags`, `buildCommandInfo`, `extractRouteGroupCommands`, `extractAllRoutes`, and `resolveCommandPath`. * 🔴 (14:19) `getPositionalString(undefined)` returns `""`; tuple parameters render as space-separated angle-…
* 🔴 (14:18) `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/test/commands/agent-conversation/list.test.ts` is a 475-line Vitest suite for `sentry agent-conversation list`; it mocks `api-client.js`, `db/auth.js`, `polling.js`, `resolve-target.js`, and `db/pagination.js` by wrapping exported functions with `vi.fn`, then uses `spyOn` for `listConversations`, `getAuthConfig`, `withProgress`, `res…
* 🔴 (14:18) `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/check-fragments.ts` is a 316-line validator for documentation fragments; normal mode reports missing-subcommand coverage as warnings, while `tsx script/check-fragments.ts --strict` treats those findings as errors. * 🔴 (14:18) `check-fragments.ts` bootstraps `src/generated/skill-content.ts` before importing `../src/app.js`; if…
Date: Sep 9, 2026 * 🔴 (14:17) `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/script/generate-skill.ts` generates 4 artifact categories: compact `plugins/sentry-cli/skills/sentry-cli/SKILL.md`, full per-route `plugins/sentry-cli/skills/sentry-cli/references/*.md`, discovery manifest `docs/public/.well-known/skills/index.json`, and embedded binary content in `src/generated/skill-content.ts`. *…
Date: Sep 9, 2026 * 🔴 (14:17) In `packages/cli/src/lib/list-command.ts`, `buildListCommand()` now accepts the shared `CommandDocumentation` type imported from `./command.js`; `OrgListCommandDocs` is now an alias of `CommandDocumentation`, allowing canonical command examples and other shared documentation metadata. * 🔴 (14:17) In `packages/cli/src/lib/mutate-command.ts`, `buildDeleteCommand()` n…
Date: Sep 9, 2026 * 🔴 (14:16) `/home/byk/Code/getsentry/cli-pr-1558/packages/cli/src/lib/introspect.ts` is a shared route-tree introspection module used at runtime by `sentry help --json` and at build time by `generate-skill.ts`; it defines simplified `RouteMapEntry`, `RouteTarget`, `RouteMap`, `Command`, `PositionalParams`, `PositionalParam`, `PositionalInfo`, `FlagDef`, `CommandInfo`, `FlagInf…
Date: Sep 9, 2026 * 🔴 (14:16) User stated to always check `package.json` for the latest scripts before running project commands; commands run from `packages/cli` or via `pnpm --filter sentry run <script>` from the repository root. * 🔴 (14:16) User stated every added package must be placed in `devDependencies`, never `dependencies`, because everything is bundled with esbuild and CI enforces this…
Date: Sep 9, 2026 * 🔴 (14:16) In `packages/cli/src/lib/command.ts`, user added exported `CommandExample` metadata with readonly `description` and complete `command` fields; the command string includes the `sentry` executable. * 🔴 (14:16) In `packages/cli/src/lib/command.ts`, user changed `CommandDocumentation` from a private native Stricli docs alias to an exported intersection type supporting …
Date: Sep 9, 2026 * 🔴 (14:16) Repository instructions required shared ID validators from `src/lib/hex-id.ts`: `validateHexId(value, label)` for 32-character hex IDs with automatic UUID-dash stripping, `validateSpanId(value)` for 16-character hex span IDs with dash stripping, and `validateTraceId(value)` as a thin wrapper in `src/lib/trace-id.ts`; all normalize to lowercase and throw `ValidationE…
Date: Sep 9, 2026 * 🔴 [requested-review] (14:08) User requested an independent, adversarial, READ-ONLY correctness review of getsentry/cli PR #1558 in `/home/byk/Code/getsentry/cli-pr-1558`; prohibited editing files, mutating Git state, committing, staging, checking out, or pushing. * 🔴 (14:08) User defined the immutable review target as committed HEAD `bbaa7b3b722b87f1bccfe84063269cbbcabe2741`…